Skip to main content

plan_issue/tracking/
mod.rs

1//! vNext tracking controller boundary.
2//!
3//! Design references:
4//!
5//! - `docs/source/plan-issue-redesign/plan-tracking-issue-run-state-controller-v1.md`
6//!   (run-state schema, event journal, FSM, reconciliation, command surface)
7//! - `docs/source/plan-issue-redesign/plan-tracking-issue-workflow-v1.md`
8//!   (workflow states and timing rules)
9//!
10//! Module map:
11//!
12//! - [`run_state`] — typed `plan-issue.execution-run.v1` schema and on-disk
13//!   helpers (`run-state.json`).
14//! - [`events`] — append-only `plan-issue.execution-event.v1` journal
15//!   (`events.jsonl`).
16//! - [`fsm`] — deterministic state machine over the lifecycle evidence.
17//! - [`reconcile`] — combines provider evidence, plan bundle, run state, and
18//!   events into a reconciled view that the FSM evaluates.
19//! - [`checkpoint`] — dry-run and live checkpoint behavior built on top of
20//!   the lifecycle renderer + visible-lint surfaces.
21//! - [`close_ready`] — non-mutating close-readiness probe that mirrors the
22//!   `record close` strict gate.
23//!
24//! The boundary is intentionally narrow: low-level provider IO and
25//! Markdown rendering are reused from [`crate::lifecycle_record`] and
26//! [`crate::lifecycle_vnext`]; this module owns local execution state,
27//! reconciliation, and the high-level commands.
28
29pub mod checkpoint;
30pub mod close_ready;
31pub mod events;
32pub mod fsm;
33pub mod reconcile;
34pub mod run_state;