ai-stack-deployer/ROADMAP.md

Roadmap

Done

• Multi-language UI (NL, AR, EN)
• RTL support
• Real-time name validation
• SSE deployment progress
• Dokploy orchestration
• SSL certificate provisioning wait
• Stack cleanup API
• Auto-rollback on failure
• Persistent storage volumes
• Logging infrastructure (log-ingest → Loki → Grafana)
• AI Stack monitoring dashboard at logs.intra.flexinit.nl
• Repository consolidation (3 repos → flexinit/agent-stack)
• Unified CI/CD pipeline (stack + portal images)

Next (Priority)

Automated Cleanup System (HIGH)

Issue: Disk space exhaustion on Dokploy server causes CI failures

Components:

• CI workflow cleanup step - prune build cache after each build
• Server-side cron job - daily Docker system prune
• Disk monitoring - alert at 80% usage via Grafana
• Post-deployment cleanup - remove unused resources after stack deploy

Implementation:

# CI workflows (.gitea/workflows/*.yaml)
- name: Cleanup build artifacts
  if: always()
  run: |
    docker builder prune -f --keep-storage=2GB
    docker image prune -f --filter "until=24h"

# Server cron (/etc/cron.d/docker-cleanup on 10.100.0.20)
0 4 * * * root docker system prune -f --volumes --filter "until=72h"
0 4 * * * root docker exec flexinit-runner docker builder prune -f --keep-storage=5GB

Web-based TUI Support (HIGH) - IN PROGRESS

Feature: Full TUI (Terminal User Interface) support inside the web browser

Goal: Enable rich terminal UI applications (like htop, lazygit, OpenCode TUI mode) to render correctly in the browser-based terminal.

Completed:

• TERM=xterm-256color environment variable
• COLORTERM=truecolor for 24-bit color support
• ncurses-base and ncurses-term packages for terminfo database
• Locale configuration (en_US.UTF-8) for Unicode support
• Environment variables passed to deployed stacks

Remaining:

• Test TUI applications in browser (htop, lazygit, vim)
• Verify mouse event passthrough works
• Test box-drawing character rendering
• Document TUI capabilities for users

Technical Notes:

• OpenCode uses built-in xterm.js web terminal
• Terminal environment configured in Docker image + deployer
• 256 colors verified working (tput colors = 256)
• 104 xterm terminfo entries installed

Use Cases:

• OpenCode TUI mode in browser
• lazygit, lazydocker
• htop, btop system monitoring
• vim/neovim with full features
• Any ncurses-based application

Other Next Items

• User authentication (protect deployments)
• Rate limiting (prevent abuse)
• Stack management UI (list/delete stacks)

Later

• Unit tests for validation
• Integration tests
• Resource limits configuration
• Custom domain support
• Image versioning (semantic versions + rollback)
• Auto-cleanup of abandoned stacks (inactive > 30 days)

Technical Notes

Disk Space Management

Server: 10.100.0.20 (97GB total)

• Docker images: ~10GB
• Containers: ~1.5GB
• Volumes: ~30GB
• Build cache: Up to 6GB between cleanups
• Safe threshold: Keep 15GB+ free (85% max usage)

Key Infrastructure

• Gitea: git.app.flexinit.nl (repo: flexinit/agent-stack)
• Runner: flexinit-runner container on 10.100.0.20
• Registry: git.app.flexinit.nl/flexinit/agent-stack:latest
• Monitoring: logs.intra.flexinit.nl (dashboard: /d/ai-stack-overview)