# Lifecycle Round 3 Plan
## Summary
Round 3 should expose the now-stable local lifecycle workflow through an MCP surface rather than adding more one-off local UI.
The work is sequenced in this order:
1. add a minimal MCP server entrypoint for lifecycle operations
2. expose lifecycle reads on top of `LifecycleService`
3. expose lifecycle writes on top of `LifecycleService`
4. verify tool responses and update handoff status
## Key Changes
### MCP server
- add a minimal MCP server binary or module in the repo
- keep tool handlers thin and delegate to `LifecycleService`
- return structured JSON only; do not invent a parallel schema
### Lifecycle tools
- add read tools:
- `memory_review_queue`
- `memory_wakeup_ready`
- `memory_get`
- `memory_history`
- add write tools:
- `memory_record_manual`
- `memory_propose`
- `memory_accept`
- `memory_promote`
- `memory_archive`
## Test Plan
- handler tests for each read tool
- handler tests for each write tool
- error-path tests for missing `record_id` and invalid lifecycle transition
- end-to-end MCP smoke test if the chosen server scaffold allows it
## Assumptions
- Round 3 still keeps lifecycle writes narrow
- Round 3 still does not add actor/reason/evidence metadata
- Round 3 still does not add persistent projection caching
## Completion Status
Last checked: `2026-04-11`
Completed in this round:
- added `spool-mcp` as a minimal stdio MCP server binary
- added lifecycle MCP read tools:
- `memory_review_queue`
- `memory_wakeup_ready`
- `memory_get`
- `memory_history`
- added lifecycle MCP write tools:
- `memory_record_manual`
- `memory_propose`
- `memory_accept`
- `memory_promote`
- `memory_archive`
- added handler-level MCP tests plus an end-to-end process smoke test
Checked for omissions against this plan:
- no missed items inside the scoped implementation baseline
- lifecycle writes remain narrow
- actor/reason/evidence metadata remains intentionally deferred
- persistent projection caching remains intentionally deferred