ROADMAP.md

Git Phantom Scope - Development Roadmap

Phase 1: Foundation (Weeks 1-2) - COMPLETE

• Project specification & architecture docs
• Repository setup, README, copilot instructions
• 10 Copilot Skills (prompts)
• MCP server configuration
• Backend skeleton (FastAPI, config, logging, metrics)
• Database models (anonymous analytics only)
• Services layer (GitHub, scoring, prompt orchestrator, model connector, packager)
• API v1 routes (analyze, generate, keys, insights)
• Skills system (base class, registry)
• Gateway (session management, health monitoring)
• Docker Compose environment
• Frontend skeleton (Next.js 14, Tailwind, TypeScript)
• Alembic migrations setup
• Basic test suite (scoring, GitHub service, API endpoints)
• CI/CD pipeline (GitHub Actions)

Phase 2: GitHub Integration (Weeks 3-4) - COMPLETE

• GitHub GraphQL integration (richer data)
• Commit message analysis for AI detection
• Co-author tag parsing
• Contribution graph data
• Redis caching optimization
• Rate limit handling with retry logic
• Integration tests with real GitHub data

Phase 3: Scoring & AI Detection (Weeks 5-6) - COMPLETE

• Refined scoring algorithms (V2: log scaling, time decay, Shannon entropy)
• AI code detection heuristics v2 (burst detection, Windsurf/Aider patterns)
• Archetype classification tuning (10 archetypes, weighted normalization, confidence)
• Scoring unit tests (>90% coverage - achieved 99%)
• Anonymous analytics pipeline to PostgreSQL

Phase 4: Image Generation (Weeks 7-8) - COMPLETE

• Celery worker for async generation jobs
• Image generator pipeline (orchestrator → connector → renderer → packager → storage)
• PIL-based watermark & text overlay (tier-based opacity)
• Asset storage service with auto-cleanup (4h TTL)
• Generate API with Celery dispatch + download endpoint
• Prompt orchestrator testing (15 tests)
• Packager/renderer testing (18 tests)
• Model connector testing (8 tests)
• Image generator + asset storage + API tests (27 tests)
• 188 total tests passing (72 new Phase 4 tests)

Phase 5: BYOK & Pro (Weeks 9-16) - COMPLETE

• Client-side AES-256-GCM key encryption (byok_crypto.py)
• Stable Diffusion connector — self-hosted Automatic1111 API
• FLUX.1 connector — Replicate + fal.ai (schnell/dev variants)
• Pro tier templates (13 image + 5 README with tier gating)
• Custom styles & colors support in prompts
• MLflow prompt versioning (prompt_tracker.py)
• Stripe payment integration (stripe_service.py)
• Tier features system (free/pro/enterprise)
• BYOK crypto, connector, template, tracker & Stripe tests
• 301 total tests passing (113 new Phase 5 tests)

Phase 6: Enterprise (Weeks 17-24) - COMPLETE

• White-label configuration service (whitelabel.py)
• Team/org analytics dashboard (team_analytics.py)
• Enterprise API routes (12 endpoints, auth dependency)
• Premium PDF report generator (pdf_report.py — native PDF 1.4)
• SSO/SAML authentication service (SAML, OIDC, GitHub OAuth)
• Kubernetes deployment configs (namespace, deployments, StatefulSets, Ingress, HPA, PDB, NetworkPolicy)
• Frontend /explore page (5 visualization components)
• Frontend /insights page (Recharts dashboard)
• API documentation site (docs/api/API_REFERENCE.md)
• Phase 6 tests (126 new tests)
• 427 total tests passing

Backlog

• Gemini Imagen live integration testing
• OpenAI DALL-E 3 connector live testing
• E2E tests with Playwright
• Performance optimization & load testing
• Production Kubernetes deployment

---

Last updated: 2026-02-20