Expand description
vNext tracking controller boundary.
Design references:
docs/source/plan-issue-redesign/plan-tracking-issue-run-state-controller-v1.md(run-state schema, event journal, FSM, reconciliation, command surface)docs/source/plan-issue-redesign/plan-tracking-issue-workflow-v1.md(workflow states and timing rules)
Module map:
run_state— typedplan-issue.execution-run.v1schema and on-disk helpers (run-state.json).events— append-onlyplan-issue.execution-event.v1journal (events.jsonl).fsm— deterministic state machine over the lifecycle evidence.reconcile— combines provider evidence, plan bundle, run state, and events into a reconciled view that the FSM evaluates.checkpoint— dry-run and live checkpoint behavior built on top of the lifecycle renderer + visible-lint surfaces.close_ready— non-mutating close-readiness probe that mirrors therecord closestrict gate.
The boundary is intentionally narrow: low-level provider IO and
Markdown rendering are reused from crate::lifecycle_record and
crate::lifecycle_vnext; this module owns local execution state,
reconciliation, and the high-level commands.
Modules§
- checkpoint
- Tracking checkpoint behavior (dry-run and live).
- close_
ready - Non-mutating close-readiness probe.
- events
- Append-only event journal for tracking runs.
- fsm
- Deterministic finite state machine for the plan-tracking record.
- reconcile
- Provider-evidence reconciliation for tracking runs.
- run_
state - Typed local run-state for
plan-issue tracking.