Add /graph G0: serial graph engineering mode over the goal engine
A deterministic DAG scheduler layered on the existing goal engine: /graph <objective> decomposes the objective via a graph-planner subagent, gates the result through Agentproof-style static validation (cycles, unknown deps, duplicate slugs, caps), appends a structural final-verification node, then executes each node as one ordinary goal — planner, worker loop, adversarial verifier, budget and pause machinery all reused verbatim. The in-turn loop advances nodes within the same turn (multi-loop closed loop); goal-side auto-pauses cascade to the graph at a single chokepoint; node goals are armed with the remaining graph budget so mid-node overruns trip graph-wide. Gated by KIGI_GRAPH=1 (default off) + the goal harness. State persists to <session_dir>/graph/state.json with a clear-tombstone; per-version immutable baselines and per-node artifact archives live under graph/<graph_id>/. Restore demotes Active->UserPaused and Running->Ready (verifier-gated re-run). Review hardening (adversarial multi-agent pass, 24 confirmed findings fixed): the goal-inactive loop break now consults the graph seam (mid-turn classifier-disabled completions can no longer strand an Active graph), the pause cascade fires even when no node goal is in flight (cancel during planning), node bookkeeping precedes the long setup await, /graph clear only resets the engine it owns, budget trips terminally fail the in-flight node, and the pause transitions in /goal pause + /graph pause no longer hide inside debug_assert! (a release-build no-op inherited from upstream). Tests: 4908 kigi-shell lib tests green, including a serial 4-node closed-loop e2e, restore/resume, cascade, mutual-exclusion, planning-retry, persistence round-trip + tombstone, and status rendering.
This commit is contained in:
@@ -56,6 +56,37 @@ Cross-crate test hooks are behind the `test-support` cargo feature
|
||||
dependents' `[dev-dependencies]`. Don't expose new test seams as plain
|
||||
`#[cfg(test)]` items across crate boundaries.
|
||||
|
||||
## Graph mode (`/graph`, post-0.1.x — plan.md in the parent dir)
|
||||
|
||||
A deterministic DAG scheduler layered over the goal engine: `/graph
|
||||
<objective>` decomposes the objective into nodes (graph planner subagent
|
||||
→ Agentproof-style static gate in `graph_plan.rs`), then executes each
|
||||
node as one ordinary goal — the agentic loop lives INSIDE the node; the
|
||||
edges stay deterministic Rust. The harness appends a terminal
|
||||
`gn-final` verification node depending on every planner node.
|
||||
|
||||
- Feature flag `KIGI_GRAPH=1` (default off); availability additionally
|
||||
requires the goal harness (`BuiltinGate::Graph`).
|
||||
- Key modules (kigi-shell): `session/graph_tracker.rs` (pure state
|
||||
machine; reuses `GoalStatus`/`GoalPhase`/`GoalPauseReason`),
|
||||
`session/graph_plan.rs` (planner-JSON contract + validation + fnv id
|
||||
canonicalization), `session/graph_planner.rs` (planner runner, reuses
|
||||
the goal planner spawn plumbing),
|
||||
`session/acp_session_impl/graph.rs` (orchestration seam).
|
||||
- Seam points: `handle_prompt` intercepts GraphSet/GraphResume; the
|
||||
in-turn loop's `EndTurn` arm calls `run_graph_round_end()` to advance
|
||||
nodes within the same turn; goal auto-pauses cascade to the graph in
|
||||
`auto_pause_goal_if_active_inner`; node goals are armed with the
|
||||
REMAINING graph budget so `enforce_goal_token_budget` cascades trips.
|
||||
- Persistence: `PersistenceMsg::GraphModeState(Option<..>)` →
|
||||
`<session_dir>/graph/state.json` (`None` tombstones after clear);
|
||||
immutable per-version baselines `graph/graph.baseline.v{N}.json`;
|
||||
per-node goal artifacts archived to `graph/<node_id>/`. Restore
|
||||
demotes `Active`→`UserPaused` and `Running`→`Ready` (re-run is safe:
|
||||
the verifier gates completion).
|
||||
- `/goal` and `/graph` are mutually exclusive while the graph owns the
|
||||
engine; e2e suite: `acp_session_tests/graph/graph_e2e_tests.rs`.
|
||||
|
||||
## Milestones (PRD §8.3)
|
||||
|
||||
- M0 (done): rename, deletions (voice/telemetry/announcements/marketplace/
|
||||
|
||||
Reference in New Issue
Block a user