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 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:
- [x] 04-01: Configure MCP server for external access
- [x] 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
**Status**: Complete
**Plans**: 5 plans

Plans:
- [x] 04-01: Stage Docker stack integration files
- [x] 04-02: Commit system configuration improvements
- [x] 04-03: Update service modules and remove deprecated systemd services
- [x] 04-04: Add n8n-worker user and update authentication
- [x] 04-05: Update flake imports and infrastructure secrets

**Details**:
Successfully organized accumulated changes into 5 logical commits:
1. Docker stack integration with improved service management
2. System configuration enhancements (hardware sensors, GPU support, security)
3. Service module updates and cleanup of deprecated systemd services
4. User and authentication configuration updates
5. Flake and infrastructure updates



## 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 | 2/2 | Complete | - |