infra/.planning/ROADMAP.md

# Roadmap: NixOS Infrastructure with AI Assistant

## Overview

This roadmap outlines the implementation of a reproducible NixOS infrastructure with Docker service management, integrated with an AI assistant for automated operations. The system will automatically detect and integrate new Docker services while maintaining consistency across deployments.

## Domain Expertise

None

## Phases

- ✅ **Phase 1: Foundation Setup** - Establish core NixOS configuration with flakes
- ✅ **Phase 2: Docker Service Integration** - Integrate Docker Compose services
- ✅ **Phase 3: AI Assistant Integration** - Enable AI-assisted infrastructure management
- [ ] **Phase 4: Internet Access & MCP** - MCP server for web access
- [ ] **Phase 5: TAK Server Integration** - Add TAK server to infrastructure

## Phase Details

### Phase 1: Foundation Setup
**Goal**: Establish the core NixOS configuration with flakes and basic infrastructure
**Depends on**: Nothing (first phase)
**Research**: Unlikely (established Nix patterns)
**Plans**: 3 plans
**Status**: Complete

Plans:
- [x] 01-01: Set up NixOS flake structure with hardware configuration
- [x] 01-02: Configure basic services and networking
- [x] 01-03: Implement secrets management with agenix

### Phase 2: Docker Service Integration
**Goal**: Integrate Docker service management with Traefik reverse proxy
**Depends on**: Phase 1
**Research**: Unlikely (existing Docker Compose patterns)
**Plans**: 3 plans
**Status**: Complete

Plans:
- [x] 02-01: Implement docker_manager.nix for service integration
- [x] 02-02: Configure Traefik reverse proxy with automatic TLS
- [x] 02-03: Set up persistent storage for Docker services

### Phase 3: AI Assistant Integration
**Goal**: Enable AI assistant to manage infrastructure operations
**Depends on**: Phase 2
**Research**: Likely (AI integration patterns)
**Research topics**: OpenCode AI API, infrastructure management patterns, natural language parsing for service operations
**Plans**: 2 plans
**Status**: Complete

Plans:
- [x] 03-01: Integrate OpenCode AI assistant with NixOS configuration
- [x] 03-02: Implement natural language command parsing

### Phase 4: Internet Access & MCP
**Goal**: Set up MCP server for web access and enhanced functionality
**Depends on**: Phase 3
**Research**: Likely (MCP server configuration)
**Research topics**: MCP server setup, web access integration, security considerations
**Plans**: 2 plans

Plans:
- [ ] 04-01: Configure MCP server for external access
- [ ] 04-02: Test web search capabilities and integration

### Phase 4.1: Organize Accumulated Commits (INSERTED)

**Goal**: Organize uncommitted changes into logical, meaningful commits
**Depends on**: Phase 4
**Plans**: 0 plans

Plans:
- [ ] TBD (run /gsd/plan-phase 4.1 to break down)

**Details**:
[To be added during planning]

### Phase 5: TAK Server Integration
**Goal**: Add TAK server to the infrastructure
**Depends on**: Phase 2
**Research**: Likely (TAK server Docker image selection)
**Research topics**: TAK server Docker image options, configuration requirements, integration patterns
**Plans**: 3 plans

Plans:
- [ ] 05-01: Research and select TAK server Docker image
- [ ] 05-02: Create Docker Compose file for TAK server
- [ ] 05-03: Integrate TAK server with existing infrastructure

## Progress

**Execution Order:**
Phases execute in numeric order: 1 → 2 → 3 → 4 → 5

| Phase | Plans Complete | Status | Completed |
|-------|----------------|--------|-----------|
| 1. Foundation Setup | 3/3 | Complete | - |
| 2. Docker Service Integration | 3/3 | Complete | - |
| 3. AI Assistant Integration | 2/2 | Complete | - |
| 4. Internet Access & MCP | 0/2 | Not started | - |
| 5. TAK Server Integration | 0/3 | Not started | - |