Skip to content

Commit eb6e902

Browse files
committed
FE-864: Correct CLI surface β€” commands are plan/cook/serve, brigade names are phases
The kitchen-brigade naming (prep/recipe/taste/plate/serve) was an aspirational command surface, but implementation revealed 4 of the 6 are internal pipeline stages, not CLI verbs: detect runs inside `plan`; probe+oracle and promotion run inside `cook`/`serve`. Only `serve` (FE-878) and the pre-existing `cook` adopted brigade names; `plan` never became `recipe`. Reword the surface to: real commands = plan/cook/serve; prep/recipe/taste/plate are phase labels. πŸ€– Generated with [Claude Code](https://claude.com/claude-code)
1 parent 09fd730 commit eb6e902

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

β€Žmemory/PLAN.mdβ€Ž

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ The next product arc is the **Conversational Workspace Runtime** umbrella (`docs
1919

2020
The **orchestrator / Petri-net execution substrate** is committed (2026-05-21) to Petri as the forward execution model, justified by parallelism, simulation, and resume value claims. Phases 0–2 are done: the dual-engine PoC (Phase 0, FE-730) validated the substrate and extracted the compiler/interpreter; Phase 1 (FE-738) added two-lane mechanical+semantic subnets, the compiler topology/wiring split, and Β§7 event vocabulary; Phase 2 (FE-743) added parallel firing policy with greedy token claiming, shared resource pool tokens bounding global concurrency, and worktree-per-slice isolation β€” the decision gate passed (parallel measurably beats serial on wall clock). Phase-3-prep `petri-declarative-routing` (FE-747) is done: typed Guard predicates on `HandlerDescriptor` plus `enumerateCandidateOutputs` make topology-only enumeration of reachable output places possible (I125-K). Phase 3 (graph compilation) remains blocked on `intent-graph-semantics` (FE-700) for relation-policy gates; Phase 4 (simulation oracle) now has its routing-side structural prerequisite satisfied but still needs Phase 3 for graph-derived gates. The north-star design is `docs/next/architecture/plan-graph-petri-orchestration.md`.
2121

22-
The orchestrator's forward direction is framed as two arcs toward a **full (autonomous) cook orchestrator** β€” "completed spec β†’ feature built and glued into a real brownfield repo, no manual steps." **Arc 1 (feature delivery)** stacks on FE-843 and ships standalone without the semantic stack. `agent-extension-host` (the dual-mode pi-harness contract) **bases the Arc-1 linear stack** (2026-06-15 decision) β€” every Arc-1 frontier sits on it β€” followed by `brunch-detect` (resolve a registry profile id from repo manifest/lockfile evidence at plan time) β†’ `harness-dep-install` (capture the dependency-delta for promotion + classify install/infra failures distinctly from test failures; the install action itself is agent-native) β†’ `app-runtime-probe` (build + boot + exercise the host app β€” the concrete reachability mechanism) β†’ `integration-oracle` (wire into host + product reachability, via the probe) β†’ `brownfield-promotion` (glue back into the checkout) β†’ `brunch-ship` (one-shot wrapper). A `dogfood-spike` (ln-spike) β€” run the full chain on one real brunch feature β€” should precede committing `integration-oracle`, to surface the reachability mechanism, dep-install, orientation depth, and brownfield plan-shape risks cheaply. CLI command surface (kitchen brigade; frontier ids stay descriptive): detect β†’ `brunch prep`, plan β†’ `brunch recipe`, orchestrate β†’ `brunch cook`, verify β†’ `brunch taste`, promote β†’ `brunch plate`, ship β†’ `brunch serve`. The settled grounding decision is **cook-time** (planning stays host-blind per D160-K; the cook agent resolves real paths/wiring by reading the worktree), which softens FE-829's `writes` ownership to *advisory in brownfield only* β€” greenfield keeps it authoritative. Protecting invariant: **brownfield generalization must not change greenfield-mode behavior; shared contracts fork on `plan.mode`** (the 3 reference fixtures + a greenfield smoke must score identically before/after each frontier). **Arc 2 (full orchestrator)** is an autonomy ladder gated behind the parked semantic/Petri-Phase-3/4 substrate: `interactive-recovery` (halt β†’ coherent question answered in a secondary chat, resumes the run) β†’ `intent-conformance-oracle` (independent behavioral-kernel verification, requisite variety) β†’ `adaptive-replan` (architect amends the plan from execution feedback, recompile + resume). Each rung raises the autonomy ceiling and is independently shippable. Non-additive work (refactors/migrations/debugging) is explicitly a separate `transformation-orchestrator` product line, not folded into either arc. The cook-time grounding decision, the D160-K `writes`-advisory amendment, and the greenfield-protecting invariant need recording in SPEC via ln-sync when the first Arc-1 frontier is scoped. **Agent-host coordination:** the pi harness is a dual-mode (`elicit`/`execute`) agent-extension host (`agent-extension-host`) β€” cook capabilities are `execute`-mode plugins on a shared, mode-neutral core; this contract is the serialization point with the unpublished pi-harness thread (which owns the core), validated against the existing interview as the `elicit` witness. It logically gates only the dispatch-seam frontiers (`integration-oracle`, Arc-2 `interactive-recovery`/`adaptive-replan`), but is sequenced at the **base of the Arc-1 linear stack** (2026-06-15 decision) β€” so the whole arc lands on it, deliberately serializing the cook stack behind the pi-harness-thread coordination rather than running the seam-independent infra (`brunch-detect`, `harness-dep-install`, `app-runtime-probe`, `brownfield-promotion`) in parallel ahead of it.
22+
The orchestrator's forward direction is framed as two arcs toward a **full (autonomous) cook orchestrator** β€” "completed spec β†’ feature built and glued into a real brownfield repo, no manual steps." **Arc 1 (feature delivery)** stacks on FE-843 and ships standalone without the semantic stack. `agent-extension-host` (the dual-mode pi-harness contract) **bases the Arc-1 linear stack** (2026-06-15 decision) β€” every Arc-1 frontier sits on it β€” followed by `brunch-detect` (resolve a registry profile id from repo manifest/lockfile evidence at plan time) β†’ `harness-dep-install` (capture the dependency-delta for promotion + classify install/infra failures distinctly from test failures; the install action itself is agent-native) β†’ `app-runtime-probe` (build + boot + exercise the host app β€” the concrete reachability mechanism) β†’ `integration-oracle` (wire into host + product reachability, via the probe) β†’ `brownfield-promotion` (glue back into the checkout) β†’ `brunch-ship` (one-shot wrapper). A `dogfood-spike` (ln-spike) β€” run the full chain on one real brunch feature β€” should precede committing `integration-oracle`, to surface the reachability mechanism, dep-install, orientation depth, and brownfield plan-shape risks cheaply. CLI surface: the real commands are `brunch plan`, `brunch cook`, and `brunch serve` (the one-shot capstone, FE-878). The kitchen-brigade names (prep/recipe/taste/plate) are **phase labels, not commands** β€” detect runs inside `plan`; probe + oracle (verify) and promotion (plate) run inside `cook`/`serve`. Frontier ids stay descriptive; `serve` chains the phases end-to-end. The settled grounding decision is **cook-time** (planning stays host-blind per D160-K; the cook agent resolves real paths/wiring by reading the worktree), which softens FE-829's `writes` ownership to *advisory in brownfield only* β€” greenfield keeps it authoritative. Protecting invariant: **brownfield generalization must not change greenfield-mode behavior; shared contracts fork on `plan.mode`** (the 3 reference fixtures + a greenfield smoke must score identically before/after each frontier). **Arc 2 (full orchestrator)** is an autonomy ladder gated behind the parked semantic/Petri-Phase-3/4 substrate: `interactive-recovery` (halt β†’ coherent question answered in a secondary chat, resumes the run) β†’ `intent-conformance-oracle` (independent behavioral-kernel verification, requisite variety) β†’ `adaptive-replan` (architect amends the plan from execution feedback, recompile + resume). Each rung raises the autonomy ceiling and is independently shippable. Non-additive work (refactors/migrations/debugging) is explicitly a separate `transformation-orchestrator` product line, not folded into either arc. The cook-time grounding decision, the D160-K `writes`-advisory amendment, and the greenfield-protecting invariant need recording in SPEC via ln-sync when the first Arc-1 frontier is scoped. **Agent-host coordination:** the pi harness is a dual-mode (`elicit`/`execute`) agent-extension host (`agent-extension-host`) β€” cook capabilities are `execute`-mode plugins on a shared, mode-neutral core; this contract is the serialization point with the unpublished pi-harness thread (which owns the core), validated against the existing interview as the `elicit` witness. It logically gates only the dispatch-seam frontiers (`integration-oracle`, Arc-2 `interactive-recovery`/`adaptive-replan`), but is sequenced at the **base of the Arc-1 linear stack** (2026-06-15 decision) β€” so the whole arc lands on it, deliberately serializing the cook stack behind the pi-harness-thread coordination rather than running the seam-independent infra (`brunch-detect`, `harness-dep-install`, `app-runtime-probe`, `brownfield-promotion`) in parallel ahead of it.
2323

2424
The May 2026 intent-spec, multi-chat, changeset-ledger, prompt/context, and agent-mutation design notes are reconciled into one direction. `docs/design/MULTI_CHAT.md` is the substrate document. `docs/design/SIDE_CHAT.md` describes side-chat V1 / V2 / V3.0 / V3.1 / V4 phasing on top of that substrate. `docs/design/PATCH_LEDGER.md` remains historical deeper design pressure for semantic mutation history, but canonical future-facing vocabulary is `changeset` / `change`. The product-layer ontology trajectory is split out as `docs/design/INTENT_GRAPH_SEMANTICS.md` and `docs/design/BEHAVIORAL_KERNELS.md`; broader synthesis lives in `docs/archive/design/INTENT_SPEC_EVOLUTION.md`. FE-705's branch-local strategy/proposal notes add scenario options, graph-review oracle, chat-local strategies, and concern/dependency mapping; those notes should become a canonical design doc when the branch is integrated. Coordination uses a substrate-strangler posture: keep existing frontend REST/SSE contracts stable while route adapters and capability adapters converge on shared server-owned handlers, then cut over UI flows only after parity and changeset-backed authority exist. The dev-layer self-tooling trajectory lives in `docs/design/ln-skills/EVOLUTION.md`.
2525

0 commit comments

Comments
Β (0)