feat: TypeScript runner infrastructure with XState (V2)

[iamladi]

Summary

Implements the TypeScript workflow runner that orchestrates the full SDLC pipeline from research to merge-ready PR.

Key Changes

• TypeScript Runner Infrastructure (src/runner/)

  • WorkflowRunner - Main orchestration loop with XState actor
  • ClaudeCLIAdapter - Spawn fresh Claude subprocesses per phase
  • SignalParser - Parse XML signals from CLI output
  • ProgressWriter - State persistence to progress file
  • PhaseMapper - Map XState phases to slash commands

• XState State Machine (src/workflows/main.workflow.ts)

  • Complete lifecycle: idle → setup → planning → implementing → submitting → ci_resolution → comment_resolution → completed
  • CI resolution loop with retry limits (max 5 attempts)
  • Comment resolution loop with retry limits (max 10 attempts)

• Phase Commands (commands/phase-*.md)

  • Each phase runs as separate Claude CLI subprocess (fresh context)
  • Emits XML signals for state transitions

Architecture

┌─────────────────────────────────────────────────────────────────┐
│  /workflows:build research/my-feature.md                        │
└──────────────────────────┬──────────────────────────────────────┘
                           │ bun run src/cli.ts run research/...
                           ▼
┌─────────────────────────────────────────────────────────────────┐
│  TypeScript Runner (WorkflowRunner)                              │
│  • XState actor (state machine)                                  │
│  • While loop until terminal state                               │
└──────────────────────────┬──────────────────────────────────────┘
                           │
         ┌─────────────────┼─────────────────┐
         ▼                 ▼                 ▼
┌────────────────┐ ┌────────────────┐ ┌────────────────┐
│ claude -p      │ │ claude -p      │ │ claude -p      │
│ /phase-setup   │ │ /phase-plan    │ │ /phase-impl    │
│ Fresh context  │ │ Fresh context  │ │ Fresh context  │
└────────────────┘ └────────────────┘ └────────────────┘

Test Plan

• 51 unit tests pass for signal parser, progress writer, and phase mapper
• TypeScript type checking passes
• Plugin validation passes
• README documents all 9 commands