kingwl
edc065666f
Plan mode's stage 2 (RFC 2026-07-07-plan-mode). The exit tool: one required plan argument (the durable log artifact), execute re-checks the folded mode, then conducts the review over the user-interaction seam — one single-select question (Approve / Keep planning) with free text open — so an approval appends mode/set back to default in-turn and every other outcome (keep-planning feedback verbatim, aborted, no provider) returns the corrective isError with the mode unchanged. presentCall is a generic card titled by the plan's first heading carrying the plan markdown; over ACP the review rides the ask_user elicitation flow, in the terminal the stdio prompt queue — no approval-seam dependency. The ACP bridge maps the picker 1:1 onto ctx.modes (opportunistic, a type-only peer edge): session/new + session/load advertise availableModes/currentModeId, session/set_mode validates through set() and echoes an optimistic current_mode_update (the pending mode IS the selection; the logged mode/set lands at the boundary and, matching, is not re-sent), and a session/event listener re-notifies on each logged flip that differs from the last sent — the tool-driven exit updates the picker. The feature matrix rows move from 'not modeled' to the picker-to-modes / knobs-to-config-options division, with the ACP v2 removal direction recorded as a mechanical-migration risk. The snapshot harness gains the setMode/setModeExpectError ops and a scripted elicitationAnswers FIFO (cancel on exhaustion; a stray choice string reaches the agent verbatim as a non-consenting custom answer, so a scenario bug fails safe). The suite factory's header-pin requirement now applies only to model-turn scenarios — a protocol-only suite has no header content to anchor. examples/plan-acp-agent is the live composition; its keyless modes-advertise scenario pins the wire surface (advertisement, both set_mode round-trips, unknown-id rejection). The recorded plan-mode approve/reject arc awaits a with-key recording session; its texts are pinned at the unit tier meanwhile. examples/AGENTS.md ceiling 653 → 680: the new example's required smoke row does not fit the old budget.
1.9 KiB
1.9 KiB
Documentation Graph Index
These diagrams are the relationship layer above the generated catalogs. Use them to navigate package topology, capability seams, event flow, model-facing tools, app composition, and runtime lifecycle paths. Exact signatures and type shapes still live in the generated events / services catalogs, tool-catalog.md, and core-data-structures/.
The process decision behind this index is recorded in the documentation graph RFC.
| Graph | Mode |
|---|---|
| module dependency graph | generated |
| tool schema catalog and package map | generated |
| capability seams and core services | hybrid generated |
| echo-agent app composition | hybrid generated |
| coding-agent app composition | hybrid generated |
| cordis-agent app composition | hybrid generated |
| acp-agent app composition | hybrid generated |
| ../examples/plan-acp-agent/composition.md | generated |
| event producer/consumer matrix | hybrid generated |
| agent turn and step lifecycle | curated |
| tool execution pipeline | curated |
| ACP snapshot replay | curated |
Regenerate with pnpm run gen-doc-graphs; verify freshness with pnpm run verify-doc-graphs.
Maintenance mode: mixed: each linked page declares generated, hybrid, or curated mode.