# 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
