docs(04-03): complete ClaudeAgentManager adapter plan

Tasks completed: 2/2
- Implement ClaudeAgentManager adapter
- Write tests for AgentManager

SUMMARY: .planning/phases/04-agent-lifecycle/04-03-SUMMARY.md

.planning/STATE.md

@@ -10,18 +10,18 @@ See: .planning/PROJECT.md (updated 2026-01-30)
 ## Current Position
 
 Phase: 4 of 8 (Agent Lifecycle)
-Plan: 2 of 4 in current phase
+Plan: 3 of 4 in current phase
 Status: In progress
-Last activity: 2026-01-30 — Completed 04-01-PLAN.md
+Last activity: 2026-01-30 — Completed 04-03-PLAN.md
 
-Progress: ████████░ 61%
+Progress: █████████░ 68%
 
 ## Performance Metrics
 
 **Velocity:**
-- Total plans completed: 17
+- Total plans completed: 18
 - Average duration: 3 min
-- Total execution time: 50 min
+- Total execution time: 54 min
 
 **By Phase:**
 
@@ -31,10 +31,10 @@ Progress: ████████░ 61%
 | 1.1 | 6/6 | 15 min | 3 min |
 | 2 | 2/2 | 8 min | 4 min |
 | 3 | 2/2 | 7 min | 4 min |
-| 4 | 2/4 | 5 min | 3 min |
+| 4 | 3/4 | 9 min | 3 min |
 
 **Recent Trend:**
-- Last 5 plans: 03-01 (2 min), 03-02 (5 min), 04-02 (2 min), 04-01 (3 min)
+- Last 5 plans: 03-02 (5 min), 04-02 (2 min), 04-01 (3 min), 04-03 (4 min)
 - Trend: Steady
 
 ## Accumulated Context
@@ -72,6 +72,9 @@ Recent decisions affecting current work:
 - 04-01: taskId nullable with SET NULL (agent may outlive task)
 - 04-01: sessionId nullable - populated from CLI JSON after first run
 - 04-01: CreateAgentData interface for explicit optional fields
+- 04-03: Use Claude CLI with --output-format json (not SDK streaming)
+- 04-03: Extract session_id from JSON result for --resume capability
+- 04-03: Use agent.id from repository for activeAgents tracking
 
 ### Pending Todos
 
@@ -90,5 +93,5 @@ None yet.
 ## Session Continuity
 
 Last session: 2026-01-30
-Stopped at: Completed 04-01-PLAN.md — Agent schema and repository
+Stopped at: Completed 04-03-PLAN.md — ClaudeAgentManager adapter
 Resume file: None

.planning/phases/04-agent-lifecycle/04-03-SUMMARY.md

@@ -0,0 +1,123 @@
+---
+phase: 04-agent-lifecycle
+plan: 03
+subsystem: agent
+tags: [claude-cli, execa, agent-manager, adapter, subprocess]
+
+# Dependency graph
+requires:
+  - phase: 04-01
+    provides: Agent schema and DrizzleAgentRepository
+  - phase: 04-02
+    provides: AgentManager port interface and lifecycle events
+provides:
+  - ClaudeAgentManager adapter implementation
+  - CLI-based agent spawning with JSON output
+  - Session ID extraction for resume capability
+affects: [04-agent-lifecycle, 05-task-dispatch, tRPC-integration]
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns:
+    - "Adapter implementation for AgentManager port using Claude CLI"
+    - "JSON output mode for structured CLI results"
+    - "Subprocess tracking via in-memory Map for active agents"
+
+key-files:
+  created:
+    - src/agent/manager.ts
+    - src/agent/manager.test.ts
+  modified:
+    - src/agent/index.ts
+
+key-decisions:
+  - "Use Claude CLI with --output-format json (not SDK streaming)"
+  - "Extract session_id from JSON result for resume capability"
+  - "Use agent.id from repository for activeAgents tracking (not local UUID)"
+  - "Handle waiting_for_input status for AskUserQuestion pauses"
+
+# Metrics
+duration: 4 min
+completed: 2026-01-30
+---
+
+# Phase 04 Plan 03: ClaudeAgentManager Adapter Summary
+
+**ClaudeAgentManager adapter using Claude CLI with JSON output for agent spawning and lifecycle management**
+
+## Performance
+
+- **Duration:** 4 min
+- **Started:** 2026-01-30T20:03:52Z
+- **Completed:** 2026-01-30T20:07:57Z
+- **Tasks:** 2
+- **Files modified:** 3
+
+## Accomplishments
+
+- Implemented ClaudeAgentManager adapter with Claude CLI in JSON mode
+- Session ID extraction from CLI JSON output for resume capability
+- Full lifecycle event emission: spawned, stopped, crashed, resumed, waiting
+- Comprehensive test suite with 19 tests mocking execa
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Implement ClaudeAgentManager adapter** - `8193423` (feat)
+2. **Task 2: Write tests for AgentManager** - `b718d59` (test)
+
+## Files Created/Modified
+
+- `src/agent/manager.ts` - ClaudeAgentManager implementation
+- `src/agent/manager.test.ts` - 19 unit tests with execa mocking
+- `src/agent/index.ts` - Export ClaudeAgentManager
+
+## Decisions Made
+
+1. **Use Claude CLI with --output-format json** - Not SDK streaming, simpler subprocess model
+2. **Extract session_id from JSON result** - Enables `--resume` for continuing agent sessions
+3. **Use agent.id from repository** - Consistent tracking after repository.create() returns
+4. **Handle waiting_for_input status** - Distinct status for AskUserQuestion pauses
+
+## Deviations from Plan
+
+### Auto-fixed Issues
+
+**1. [Rule 3 - Blocking] Fixed agent ID tracking consistency**
+- **Found during:** Task 2 (test for stop killing subprocess)
+- **Issue:** Manager generated local UUID for activeAgents but returned agent.id from repository
+- **Fix:** Changed to use agent.id from repository.create() for all tracking
+- **Files modified:** src/agent/manager.ts
+- **Verification:** All 19 tests pass
+- **Committed in:** b718d59 (combined with Task 2)
+
+---
+
+**Total deviations:** 1 auto-fixed (blocking)
+**Impact on plan:** Design consistency fix required for correct subprocess tracking. No scope creep.
+
+## Issues Encountered
+
+None
+
+## User Setup Required
+
+None - no external service configuration required.
+
+## Next Phase Readiness
+
+- AgentManager adapter ready for tRPC integration (04-04)
+- All verification checks pass:
+  - npm run build succeeds
+  - npm test passes 240 tests (19 new for agent manager)
+  - ClaudeAgentManager uses CLI with --output-format json
+  - Session ID extracted from CLI JSON output
+  - Agent names enforced (unique, used for branches)
+  - waiting_for_input status handled for AskUserQuestion scenarios
+  - Events include agent name
+
+---
+*Phase: 04-agent-lifecycle*
+*Completed: 2026-01-30*