Skip to content

roadmap.md

Latest commit

 

History

History
135 lines (89 loc) · 3.73 KB

roadmap.md

File metadata and controls

135 lines (89 loc) · 3.73 KB
Raw

Development Roadmap

This roadmap shows how A.R.C. CLI was built, spec by spec. Each spec represents a focused feature set following the SpecKit workflow.

Completed Specs

001: Initial Setup & Styling

Branch: 001-initial-setup | Status: Complete

Foundation of the CLI with professional branding and styling.

  • Cobra CLI framework setup
  • Branded ASCII banner with version info
  • Custom help screen with A.R.C. theme
  • Centralized styling system (colors + emoji)
  • Zero-dependency static binary

002: State Management

Branch: 002-state-management | Status: Complete

Persistent state tracking for CLI operations.

  • State storage in ~/.arc/state.json
  • Operation history tracking
  • Theme persistence across sessions
  • File locking for concurrent access
  • State validation and recovery

003: Test Infrastructure

Branch: 003-test-infrastructure | Status: Complete

Testing foundation and coverage targets.

  • Testify framework integration
  • Test helpers and utilities
  • Coverage targets: Critical 75%, Core 60%, UI 40%
  • CI/CD integration for automated testing

004: Interactive UI Enhancements

Branch: 004-interactive-ui-enhancements | Status: Complete

Rich terminal user interface components.

  • arc info command with system details
  • Progress indicators and spinners
  • Theme preview system
  • Bubble Tea TUI framework
  • Lip Gloss styling components

005: Animations & Rich UI

Branch: 005-animations-rich-ui | Status: Complete

Advanced visual feedback and animations.

  • Harmonica spring physics for smooth animations
  • Rich banner animations
  • Theme transition effects
  • Structured logging with Charm log

006: Stabilize Base Architecture

Branch: 006-stabilize-base | Status: Complete

Architecture refactoring for maintainability.

  • Factory Pattern (dependency injection)
  • XDG Base Directory compliance
  • Repository Pattern for storage
  • UI Service (centralized rendering)
  • Removed global state and singletons
  • Test parallelization enabled

007: Init Wizard

Branch: 007-init-wizard | Status: Complete

Interactive workspace initialization.

  • Bubble Tea wizard interface
  • Dragon Ball tiering (Super Saiyan/Blue/Instinct)
  • Stack selection (AI, Security, Observability)
  • Progressive disclosure of complexity

008: Workspace Configuration

Branch: 008-workspace-config | Status: Complete

Operator Pattern for platform configuration.

  • arc.yaml manifest as source of truth
  • Docker Compose generation
  • Environment file management
  • Feature flag system
  • Workspace state tracking

009: Service Catalog

Branch: 009-service-catalog | Status: Complete

Service registry and dependency management.

  • 29 services across 4 categories
  • Dependency resolution with topological sort
  • Port conflict detection
  • Embedded Docker Compose templates
  • Fuzzy matching for service discovery

Architectural Patterns

Starting from spec 006, all code must follow these patterns:

Pattern Purpose
Factory Dependency injection, no globals
XDG Base Directory Config/data/state separation
Repository Domain-driven storage interfaces
UI Service Centralized rendering

Future Roadmap

Planned features (not yet implemented):

  • 010: Doctor Command - Deep health diagnostics (Dr. House principle)
  • 011: Chaos Engineering - Controlled failure injection (Terminator principle)
  • 012: Reconciliation - Configuration drift detection (Gardener pattern)

Contributing

See Contributing Guide for how to add new features following the SpecKit workflow.