red64-cli 0.1.0

package/README.md

@@ -0,0 +1,454 @@
+# Red64 CLI
+
+**Deterministic spec-driven development orchestrator for AI-assisted coding.**
+
+Red64 automates the entire feature development lifecycle—from requirements to implementation—using a structured, phase-gated workflow that ensures quality and traceability.
+
+![Red64 Flow Demo](docs/assets/demo.gif)
+<!-- TODO: Add screencast -->
+
+---
+
+## Quick Start
+
+### 1. Install
+
+```bash
+# Clone and install
+git clone https://github.com/your-org/red64-cli.git
+cd red64-cli
+npm install
+npm link
+```
+
+### 2. Initialize your project
+
+```bash
+cd /path/to/your/project
+red64 init
+```
+
+### 3. Start a feature
+
+```bash
+red64 start "user-authentication" "Add login and registration with JWT tokens"
+```
+
+Red64 will:
+1. Create an isolated git worktree
+2. Generate requirements (EARS format)
+3. Create technical design
+4. Break down into implementation tasks
+5. Execute each task with commits
+6. Complete with a ready-to-review branch
+
+---
+
+## What is Red64?
+
+Red64 is a **spec-driven development orchestrator** that brings structure and determinism to AI-assisted coding. Instead of ad-hoc prompting, Red64 enforces a rigorous workflow:
+
+```
+Requirements → Design → Tasks → Implementation
+     ↓            ↓        ↓          ↓
+  (review)    (review)  (review)   (commits)
+```
+
+### Key Features
+
+| Feature | Description |
+|---------|-------------|
+| **Spec-Driven** | Every feature starts with formal requirements and design |
+| **Phase Gates** | Human review required between phases (or auto-approve with `-y`) |
+| **Git Isolation** | Each feature runs in its own worktree and branch (sibling directory) |
+| **Atomic Commits** | One commit per task for clean history |
+| **Sandboxed Execution** | Optional Docker isolation for safe agent execution |
+| **Resumable Flows** | `start` auto-detects in-progress flows and offers resume |
+| **API Health Checks** | Validates Claude API before starting (credits, auth, network) |
+
+### Goals
+
+1. **Predictability**: Same inputs produce consistent outputs through structured phases
+2. **Traceability**: Every code change links back to requirements and design decisions
+3. **Quality**: Mandatory review gates prevent AI hallucinations from reaching production
+4. **Isolation**: Git worktrees prevent work-in-progress from polluting main branch
+5. **Efficiency**: Automate the tedious parts while keeping humans in control
+
+---
+
+## Installation
+
+### Requirements
+
+- Node.js >= 20.0.0
+- Git
+- Claude CLI (`npm install -g @anthropic-ai/claude-cli`)
+- Docker (optional, for sandboxed execution)
+
+### From Source
+
+```bash
+git clone https://github.com/your-org/red64-cli.git
+cd red64-cli
+npm install
+npm run build
+npm link
+```
+
+### Verify Installation
+
+```bash
+red64 --version
+red64 help
+```
+
+---
+
+## Commands
+
+### `red64 init`
+
+Initialize Red64 in your project. Creates `.red64/` directory with steering documents.
+
+```bash
+red64 init
+red64 init --repo owner/repo --stack nextjs
+red64 init --agent gemini  # Use Gemini as coding agent
+```
+
+**Flags:**
+- `-a, --agent <name>` — Coding agent: `claude`, `gemini`, `codex` (default: `claude`)
+
+![red64 init](docs/assets/init.png)
+<!-- TODO: Add screenshot -->
+
+### `red64 start <feature> <description>`
+
+Start a new feature development flow, or resume an existing one.
+
+```bash
+red64 start "shopping-cart" "Add shopping cart with add/remove items and checkout"
+```
+
+**Smart Resume Detection:**
+
+When you run `start` for a feature that's already in progress (at any phase: requirements, design, tasks, or implementation), Red64 will:
+
+1. **Detect uncommitted changes** — If the worktree has uncommitted changes, prompts:
+   - Commit changes (WIP commit)
+   - Discard changes
+   - Cancel
+
+2. **Offer resume or restart** — If an in-progress flow is found, prompts:
+   - Resume from current phase
+   - Start fresh (discard previous progress)
+   - Cancel
+
+This means you can always use `red64 start <feature>` to continue working—no separate resume command needed.
+
+**Flags:**
+- `-m, --model <name>` — Model to use (e.g., `claude-3-5-haiku-latest` for dev, `claude-sonnet-4-20250514` for prod)
+- `-y, --yes` — Auto-approve all phases (skip review gates)
+- `-b, --brownfield` — Enable gap analysis for existing codebases
+- `-g, --greenfield` — New feature mode (default)
+- `-s, --skip-permissions` — Pass to Claude CLI
+- `-t, --tier <name>` — Use specific Claude config tier
+- `--sandbox` — Run in Docker isolation
+- `--verbose` — Show detailed execution logs
+
+![red64 start](docs/assets/start.png)
+<!-- TODO: Add screenshot -->
+
+### `red64 status [feature]`
+
+Show the status of a flow.
+
+```bash
+red64 status shopping-cart
+red64 status  # Show all flows
+```
+
+![red64 status](docs/assets/status.png)
+<!-- TODO: Add screenshot -->
+
+### `red64 list`
+
+List all active flows in the repository.
+
+```bash
+red64 list
+```
+
+### `red64 abort <feature>`
+
+Abort a flow and clean up resources (worktree, branch).
+
+```bash
+red64 abort shopping-cart
+```
+
+---
+
+## Workflow Phases
+
+### 1. Initialization
+
+Creates spec directory at `.red64/specs/<feature>/` with `spec.json`.
+
+### 2. Requirements Generation
+
+Generates `requirements.md` using EARS (Easy Approach to Requirements Syntax) format:
+- Ubiquitous requirements
+- Event-driven requirements
+- State-driven requirements
+- Optional features
+- Unwanted behaviors
+
+### 3. Gap Analysis (Brownfield only)
+
+For existing codebases, analyzes what already exists and what needs to be built.
+
+### 4. Design Generation
+
+Creates `design.md` with:
+- Architecture decisions
+- Component design
+- Data models
+- API contracts
+- File structure
+
+### 5. Task Generation
+
+Breaks down the design into atomic `tasks.md`:
+- Each task is independently implementable
+- Tasks are ordered by dependency
+- Each task produces a commit
+
+### 6. Implementation
+
+Executes tasks sequentially:
+- Runs `/red64:spec-impl <feature> <task-id>`
+- Commits after each task
+- Checkpoints every 3 tasks (optional pause)
+
+### 7. Completion
+
+Flow completes with:
+- All tasks implemented
+- Clean commit history
+- Feature branch ready for PR
+
+---
+
+## Comparison with Other Tools
+
+| Feature | Red64 | Cursor/Copilot | Aider | Claude Code |
+|---------|-------|----------------|-------|-------------|
+| **Spec-driven workflow** | Yes | No | No | No |
+| **Phase gates** | Yes | No | No | No |
+| **Git worktree isolation** | Yes | No | No | No |
+| **Atomic commits per task** | Yes | No | Yes | No |
+| **Requirements generation** | Yes | No | No | No |
+| **Design documents** | Yes | No | No | No |
+| **Resumable flows** | Yes | No | Partial | No |
+| **Docker sandboxing** | Yes | No | No | Yes |
+| **IDE integration** | No | Yes | Partial | Yes |
+| **Real-time editing** | No | Yes | Yes | Yes |
+
+### When to use Red64
+
+**Use Red64 when:**
+- Building complete features (not quick fixes)
+- You need traceable requirements and design
+- Working on complex, multi-file changes
+- You want clean git history with atomic commits
+- You need to pause and resume work across sessions
+
+**Use other tools when:**
+- Making quick, single-file edits
+- Exploring or prototyping ideas
+- You need real-time IDE integration
+- Working on bug fixes without spec requirements
+
+---
+
+## Limitations
+
+### Current Limitations
+
+1. **No IDE integration** — Red64 is CLI-only; no VS Code or JetBrains plugins yet
+2. **Sequential execution** — Tasks run one at a time, no parallelization
+3. **No incremental changes** — Regenerating a phase replaces previous output entirely
+4. **English-centric** — Prompts and templates are English-only (configurable per spec)
+
+### Known Issues
+
+- Large codebases may hit context limits during design phase
+- Docker sandbox requires pre-built image (`docker build -f Dockerfile.sandbox -t red64-sandbox:latest .`)
+- Some UI frameworks may not render correctly in all terminals
+
+### Roadmap
+
+- [ ] VS Code extension
+- [ ] Parallel task execution
+- [ ] Incremental phase editing
+- [ ] Web dashboard for flow monitoring
+
+---
+
+## Project Structure
+
+```
+.red64/
+├── specs/                    # Feature specifications
+│   └── <feature>/
+│       ├── spec.json         # Spec metadata
+│       ├── requirements.md   # EARS requirements
+│       ├── design.md         # Technical design
+│       └── tasks.md          # Implementation tasks
+├── flows/                    # Flow state and logs
+│   └── <feature>/
+│       ├── state.json        # Current flow state
+│       └── flow.log          # Execution log
+└── steering/                 # Project-wide guidance
+    ├── product.md            # Product context
+    ├── tech.md               # Technical standards
+    └── structure.md          # Codebase structure
+```
+
+### Git Worktree Layout
+
+Red64 creates git worktrees in a **sibling directory** following the [GitLens/VSCode convention](https://gist.github.com/ChristopherA/4643b2f5e024578606b9cd5d2e6815cc). This keeps the main repository clean and avoids nested git structures.
+
+```
+~/projects/
+├── my-project/                    # Main repository (unchanged)
+│   ├── .git/
+│   ├── .red64/
+│   ├── src/
+│   └── package.json
+└── my-project.worktrees/          # Worktrees directory (sibling)
+    ├── user-authentication/       # feature/user-authentication branch
+    │   ├── .red64/
+    │   ├── src/
+    │   └── package.json
+    └── shopping-cart/             # feature/shopping-cart branch
+        ├── .red64/
+        ├── src/
+        └── package.json
+```
+
+**Benefits of sibling worktrees:**
+- Main repository stays clean (no `.gitignore` needed for worktrees)
+- No nested `.git` references inside the working tree
+- Better IDE and tool compatibility
+- Clear separation between main work and feature isolation
+- Easy to see all active features at a glance
+
+---
+
+## Configuration
+
+### Steering Documents
+
+Customize AI behavior by editing `.red64/steering/`:
+
+- **product.md** — Product vision, user personas, business rules
+- **tech.md** — Tech stack, coding standards, patterns to use/avoid
+- **structure.md** — Codebase organization, file naming conventions
+
+### Coding Agents
+
+Red64 supports multiple coding agents. Set the agent at init time:
+
+```bash
+red64 init --agent claude   # Default - Anthropic Claude
+red64 init --agent gemini   # Google Gemini
+red64 init --agent codex    # OpenAI Codex
+```
+
+The agent is stored in `.red64/config.json` and used for all subsequent commands.
+
+### Model Selection
+
+Override the model per command for cost optimization:
+
+```bash
+# Development (cheap, fast models)
+red64 start "feature" "desc" --model claude-3-5-haiku-latest
+red64 start "feature" "desc" --model gemini-2.0-flash
+red64 start "feature" "desc" --model gpt-4o-mini
+
+# Production (best quality models)
+red64 start "feature" "desc" --model claude-sonnet-4-20250514
+red64 start "feature" "desc" --model gemini-2.5-pro
+red64 start "feature" "desc" --model o1
+```
+
+| Agent | Cheap (Dev) | Best (Prod) |
+|-------|-------------|-------------|
+| Claude | `claude-3-5-haiku-latest` | `claude-sonnet-4-20250514` |
+| Gemini | `gemini-2.0-flash` | `gemini-2.5-pro` |
+| Codex | `gpt-4o-mini` | `o1` |
+
+### Claude Tiers
+
+Use different Claude configurations with `--tier`:
+
+```bash
+red64 start "feature" "desc" --tier pro
+# Uses ~/.claude-pro/ for configuration
+```
+
+---
+
+## Development
+
+### Run in development mode
+
+```bash
+npm run dev -- start my-feature "Feature description"
+```
+
+### Run tests
+
+```bash
+npm test
+npm run test:ui
+```
+
+### Build
+
+```bash
+npm run build
+```
+
+### Type checking
+
+```bash
+npm run type-check
+```
+
+---
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Run tests: `npm test`
+5. Submit a pull request
+
+---
+
+## License
+
+MIT
+
+---
+
+## Acknowledgments
+
+- Built by Yacin Bahi, yacin@Red64.io
+- Inspired by spec-driven development and EARS requirements methodology
+- Uses [Ink](https://github.com/vadimdemedes/ink) for terminal UI

package/dist/cli/parseArgs.d.ts

@@ -0,0 +1,16 @@
+/**
+ * CLI argument parsing for red64
+ * Requirements: 3.2, 3.4, 4.7, 5.1-5.5, 8.1, 8.4, 8.5
+ */
+import type { CLIConfig } from '../types/index.js';
+/**
+ * Parse CLI arguments into CLIConfig
+ * This function wraps argument parsing logic for testability
+ */
+export declare function parseArgs(argv: readonly string[]): CLIConfig;
+/**
+ * Help text for red64 CLI
+ * Requirements: 4.7, 8.1, 8.4, 8.5
+ */
+export declare const HELP_TEXT: string;
+//# sourceMappingURL=parseArgs.d.ts.map

package/dist/cli/parseArgs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseArgs.d.ts","sourceRoot":"","sources":["../../src/cli/parseArgs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAqC,MAAM,mBAAmB,CAAC;AAatF;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CA8G5D;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,QAuBd,CAAC"}

package/dist/cli/parseArgs.js

@@ -0,0 +1,172 @@
+/**
+ * CLI argument parsing for red64
+ * Requirements: 3.2, 3.4, 4.7, 5.1-5.5, 8.1, 8.4, 8.5
+ */
+const VALID_AGENTS = ['claude', 'gemini', 'codex'];
+const VALID_COMMANDS = [
+    'init',
+    'start',
+    'status',
+    'list',
+    'abort',
+    'help'
+];
+/**
+ * Parse CLI arguments into CLIConfig
+ * This function wraps argument parsing logic for testability
+ */
+export function parseArgs(argv) {
+    const flags = {
+        skipPermissions: false,
+        brownfield: false,
+        greenfield: true, // Default to greenfield mode
+        tier: undefined,
+        help: false,
+        version: false,
+        verbose: false,
+        yes: false,
+        sandbox: false,
+        model: undefined,
+        // Init-specific flags
+        repo: undefined,
+        stack: undefined,
+        'skip-guided': undefined,
+        'no-steering': undefined,
+        'no-cache': undefined,
+        agent: undefined
+    };
+    const positionalArgs = [];
+    let command = undefined;
+    // Parse arguments
+    for (let i = 0; i < argv.length; i++) {
+        let arg = argv[i];
+        let argValue;
+        // Handle --flag=value syntax
+        if (arg.startsWith('--') && arg.includes('=')) {
+            const eqIndex = arg.indexOf('=');
+            argValue = arg.slice(eqIndex + 1);
+            arg = arg.slice(0, eqIndex);
+        }
+        if (arg === '--skip-permissions' || arg === '-s') {
+            flags.skipPermissions = true;
+        }
+        else if (arg === '--brownfield' || arg === '-b') {
+            flags.brownfield = true;
+            flags.greenfield = false;
+        }
+        else if (arg === '--greenfield' || arg === '-g') {
+            flags.greenfield = true;
+            flags.brownfield = false;
+        }
+        else if (arg === '--tier' || arg === '-t') {
+            // Use argValue if --tier=value, otherwise next arg
+            const value = argValue ?? argv[i + 1];
+            if (value && !value.startsWith('-')) {
+                flags.tier = value;
+                if (!argValue)
+                    i++; // Only skip if we used next arg
+            }
+        }
+        else if (arg === '--help' || arg === '-h') {
+            flags.help = true;
+        }
+        else if (arg === '--version' || arg === '-v') {
+            flags.version = true;
+        }
+        else if (arg === '--verbose') {
+            flags.verbose = true;
+        }
+        else if (arg === '--yes' || arg === '-y') {
+            flags.yes = true;
+        }
+        else if (arg === '--sandbox') {
+            flags.sandbox = true;
+        }
+        else if (arg === '--model' || arg === '-m') {
+            const value = argValue ?? argv[i + 1];
+            if (value && !value.startsWith('-')) {
+                flags.model = value;
+                if (!argValue)
+                    i++;
+            }
+        }
+        else if (arg === '--repo') {
+            const value = argValue ?? argv[i + 1];
+            if (value && !value.startsWith('-')) {
+                flags.repo = value;
+                if (!argValue)
+                    i++;
+            }
+        }
+        else if (arg === '--stack') {
+            const value = argValue ?? argv[i + 1];
+            if (value && !value.startsWith('-')) {
+                flags.stack = value;
+                if (!argValue)
+                    i++;
+            }
+        }
+        else if (arg === '--skip-guided') {
+            flags['skip-guided'] = true;
+        }
+        else if (arg === '--no-steering') {
+            flags['no-steering'] = true;
+        }
+        else if (arg === '--no-cache') {
+            flags['no-cache'] = true;
+        }
+        else if (arg === '--agent' || arg === '-a') {
+            const value = argValue ?? argv[i + 1];
+            if (value && !value.startsWith('-') && VALID_AGENTS.includes(value)) {
+                flags.agent = value;
+                if (!argValue)
+                    i++;
+            }
+        }
+        else if (!arg.startsWith('-')) {
+            positionalArgs.push(arg);
+        }
+    }
+    // First positional argument is the command
+    if (positionalArgs.length > 0) {
+        const potentialCommand = positionalArgs[0];
+        if (VALID_COMMANDS.includes(potentialCommand)) {
+            command = potentialCommand;
+            positionalArgs.shift(); // Remove command from args
+        }
+    }
+    return {
+        command,
+        args: positionalArgs,
+        flags
+    };
+}
+/**
+ * Help text for red64 CLI
+ * Requirements: 4.7, 8.1, 8.4, 8.5
+ */
+export const HELP_TEXT = `
+Red64 Flow Orchestrator
+
+Usage:
+  red64 init                           Bootstrap project for red64 flows
+  red64 start <feature> "<desc>"       Start new feature flow (auto-resumes if exists)
+  red64 status [feature]               Show flow status
+  red64 list                           List all active flows
+  red64 abort <feature>                Abort and cleanup flow
+  red64 help                           Show this help
+
+Init Options:
+  -a, --agent <name>        Coding agent: claude, gemini, codex (default: claude)
+
+Global Options:
+  -m, --model <name>        Model to use (must match agent, e.g. claude-3-5-haiku-latest)
+  -s, --skip-permissions    Pass skip-permissions to Claude CLI
+  -b, --brownfield          Enable brownfield mode (gap analysis)
+  -g, --greenfield          Greenfield mode (default)
+  -t, --tier <name>         Use specified Claude config directory
+  --sandbox                 Run Claude in Docker container for isolation
+  -h, --help                Show help
+  -v, --version             Show version
+`.trim();
+//# sourceMappingURL=parseArgs.js.map

package/dist/cli/parseArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseArgs.js","sourceRoot":"","sources":["../../src/cli/parseArgs.ts"],"names":[],"mappings":"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"}

package/dist/cli/validateFlags.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Flag validation for red64 CLI
+ * Requirements: 5.1-5.5
+ */
+import type { GlobalFlags } from '../types/index.js';
+/**
+ * Validation error type
+ */
+export type FlagValidationError = string;
+/**
+ * Validation result
+ */
+export interface FlagValidationResult {
+    readonly valid: boolean;
+    readonly errors: readonly FlagValidationError[];
+}
+/**
+ * Validate CLI flags and return validation result
+ * Requirements: 5.4, 5.5
+ */
+export declare function validateFlags(flags: GlobalFlags): FlagValidationResult;
+//# sourceMappingURL=validateFlags.d.ts.map

package/dist/cli/validateFlags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateFlags.d.ts","sourceRoot":"","sources":["../../src/cli/validateFlags.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACjD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,oBAAoB,CAiBtE"}

package/dist/cli/validateFlags.js

@@ -0,0 +1,24 @@
+/**
+ * Flag validation for red64 CLI
+ * Requirements: 5.1-5.5
+ */
+/**
+ * Validate CLI flags and return validation result
+ * Requirements: 5.4, 5.5
+ */
+export function validateFlags(flags) {
+    const errors = [];
+    // Validate tier has a value when provided (not empty string)
+    if (flags.tier === '') {
+        errors.push('Error: --tier requires a value');
+    }
+    // Validate brownfield and greenfield are mutually exclusive
+    if (flags.brownfield && flags.greenfield) {
+        errors.push('Error: --brownfield and --greenfield are mutually exclusive');
+    }
+    return {
+        valid: errors.length === 0,
+        errors
+    };
+}
+//# sourceMappingURL=validateFlags.js.map