@orkestrel/scaffold 0.0.3 → 0.0.4

package/dist/host/AGENTS.md

@@ -65,7 +65,7 @@ configs/  thin target wrappers around root Vite/TypeScript configuration
 - **Named discriminants.** Name the axis that varies (`relationship`, `command`, `category`), never `kind` or `type`.
 - **Centralize by kind.** Types, constants, helpers, validators, parsers, factories, errors, and similar declarations live in their designated centralized files. Implementation files contain one class plus imports.
 - **Export and test reusable logic.** No hidden module helpers or declarations; fold trivial one-use logic into its caller or export it from the correct centralized module and test it.
-- **No nested functions.** Extract function declarations/assignments from bodies. Anonymous callbacks passed directly as arguments are the sole exception.
+- **No nested functions.** Extract function declarations/assignments from bodies. Anonymous callbacks passed directly as arguments and anonymous functions returned directly as results are the sole exceptions.
 - **Functional core, imperative shell.** Export pure leaves; retain stateful or defining orchestration as class methods. Classes must compose behavior, not forward 1:1 to helpers.
 - **No superfluous wrappers.** A wrapper must add a boundary, invariant, composition, translation, lifecycle, or materially narrower contract. Otherwise use or rename the real symbol and update every consumer.
 - **Minimal public API.** Add capability with its real consumer; do not speculate. Prefer one minimal interface and one shared engine, allowing native backend overrides only for genuine faster paths.

package/dist/host/CLAUDE.md

@@ -14,12 +14,12 @@ dispatch-named skill and its required references, and the governing guide/spec b
 
 One workflow runs across both providers. Each engine has one job, and no engine takes another's.
 
-| Engine          | Job                                                             | Posture                                           |
-| --------------- | --------------------------------------------------------------- | ------------------------------------------------- |
-| **Fable**       | Top-level orchestration and final acceptance in Claude Code     | Owns the goal, plan, reconciliation, and decision |
-| **Cursor Grok** | Research, scouting, context-heavy reading, distillation         | Read-only; returns evidence, never decisions      |
-| **Opus 5**      | Subjective and creative design, and design-fit review           | Read-only; proposes and audits, never accepts     |
-| **GPT-5.6 Sol** | Objective and realistic analysis, and nontrivial implementation | Writes only in isolation; proposes, never accepts |
+| Engine          | Job                                                                     | Posture                                           |
+| --------------- | ----------------------------------------------------------------------- | ------------------------------------------------- |
+| **Fable**       | Top-level orchestration and final acceptance in Claude Code             | Owns the goal, plan, reconciliation, and decision |
+| **Cursor Grok** | Research, scouting, context-heavy reading, distillation                 | Read-only; returns evidence, never decisions      |
+| **Opus 5**      | Subjective and creative design, design-fit review, and implementation   | Proposes, audits, and implements; never accepts   |
+| **GPT-5.6 Sol** | Objective and realistic analysis, correctness audit, and implementation | Proposes, audits, and implements; never accepts   |
 
 - **Fable orchestrates and accepts, and does nothing else.** It is never a subagent, never a
   Codex route, and Codex must never invoke it.
@@ -30,8 +30,10 @@ One workflow runs across both providers. Each engine has one job, and no engine
   (shape, taste, naming, ergonomics, what the API should feel like); Sol argues the objective
   case (what the code, contracts, and constraints actually permit). They run independently on
   the same brief and disagree on the record.
-- **Sol owns nontrivial implementation.** Terra and Cursor Composer are not implementation
-  routes and no `composer` role exists.
+- **Opus 5 and Sol are mirrored implementers.** Nontrivial implementation routes to either:
+  the Orchestrator picks per unit — objective, constraint-heavy, mechanical-precision work
+  favours Sol; subjective, API-shape, naming, and documentation-voice work favours Opus.
+  Terra and Cursor Composer are not implementation routes and no `composer` role exists.
 - **After implementation Opus 5 and Sol audit independently** — Opus on design fit, Sol on
   correctness and constraint satisfaction — and the orchestrator reconciles their evidence
   into one verdict.
@@ -63,7 +65,8 @@ dispatch, even when the role file pins it.
 | Creative design and alternatives         | `planner`                       | `planner`                     | Opus 5 (native / bridge)      |
 | Design-fit review and audit              | `reviewer`                      | `reviewer`                    | Opus 5 (native / bridge)      |
 | Objective analysis and correctness audit | `codex` route `analyst`         | `analyst`                     | GPT-5.6 Sol (bridge / native) |
-| Nontrivial implementation                | `codex` route `implementer`     | `implementer`                 | GPT-5.6 Sol (bridge / native) |
+| Nontrivial implementation (objective)    | `codex` route `implementer`     | `implementer`                 | GPT-5.6 Sol (bridge / native) |
+| Nontrivial implementation (subjective)   | `implementer`                   | `implementer` route `opus`    | Opus 5 (native / bridge)      |
 | Fully specified mechanical unit          | `builder`                       | `builder`                     | Sonnet / Terra                |
 | Fully specified app-layer unit           | `application`                   | `application`                 | Sonnet / Terra                |
 | Mechanical conformance evidence          | `checker`                       | `checker`                     | Sonnet / Terra                |
@@ -87,18 +90,15 @@ dispatch, even when the role file pins it.
 
 Every role honours this floor and no dispatch may widen it.
 
-- **Read-only roles carry no `Edit` and no `Write`.** The tool allowlist is the guarantee;
-  permission mode only decides whether the role can run at all.
-  - Pure readers (`planner`) use `plan`.
-  - `reviewer`, `checker`, and `orkestrel` use `dontAsk` without Bash. The Orchestrator
-    includes the actual diff and status evidence in every review dispatch.
-  - The `grok` and `codex` bridge drivers use `default` so their one external CLI invocation
-    can request explicit approval. They receive no standing Bash allow rule.
-  - `verifier` uses `default` because dispatched build and test gates may create declared
-    artifacts; it still has no edit/write tools and never fixes a failure.
-- **Writing roles run under `isolation: worktree`.** Where a worktree is impossible they own
-  disjoint files and treat every shared file as report-only.
-- Every role carries a bounded `maxTurns`.
+- **Agents are autonomous.** Constrain only what is a genuine security or destruction risk;
+  do not gate routine work behind approval prompts or turn budgets. Roles run to completion
+  and finish their assignment patiently.
+- **Read-only roles carry no `Edit` and no `Write`.** The tool allowlist is the guarantee.
+  The Orchestrator includes the actual diff and status evidence in every review dispatch.
+  `verifier` has no edit/write tools and never fixes a failure.
+- **Writing roles run in the main checkout, strictly serialized.** One writer at a time,
+  dispatched from a clean committed baseline; each owns disjoint files and treats every
+  shared file as report-only.
 - No role commits, pushes, tags, publishes, installs dependencies, or runs a destructive
   command.
 - No role reads, prints, copies, uploads, or packages a secret: `CURSOR_API_KEY`, Codex auth
@@ -124,8 +124,9 @@ Every role honours this floor and no dispatch may widen it.
 Concurrent executors share a filesystem unless isolated. Prevent clobbered edits, tree-wide
 formatter and build races, cache phantoms, and validation cross-talk:
 
-1. Prefer `isolation: worktree` for writing executors.
-2. Otherwise assign disjoint owned files plus explicit shared and off-limits files.
+1. Serialize writing executors in the main checkout; commit a checkpoint before each
+   writing dispatch so git is the rollback mechanism.
+2. Assign disjoint owned files plus explicit shared and off-limits files.
 3. Shared files are report-only; executors return exact patches for serial integration.
 4. Concurrent executors run only read-only, scoped validation. A tree-wide result may contain
    siblings' in-flight failures; an executor reports only its owned scope.
@@ -134,14 +135,23 @@ formatter and build races, cache phantoms, and validation cross-talk:
 
 ## Execution loop
 
+At session start, before planning, the Orchestrator records bench liveness with the two cheap
+probes (`codex --version`; `agent`/`agent.cmd` `--version`) and plans routing against that
+record. Probes are read-only; a dark bench is noted with its fallback, never silently
+absorbed.
+
 1. **Absorb.** Dispatch `grok` for terrain, prior art, and the reading the decision needs. In
    an Orkestrel repo dispatch `orkestrel` alongside it for live package state. Skip only when
    the ground is already known.
 2. **Design adversarially.** Dispatch `planner` (Opus 5) and `analyst` (Sol) on the SAME brief,
    in parallel, without showing either the other's answer. Reconcile them yourself into one
    plan: units, dependencies, ownership, parallel/serial order, acceptance criteria, risks.
-   Surface the plan before dispatch.
-3. **Implement.** Route each nontrivial unit to `implementer` (Sol, worktree). Route a fully
+   Surface the plan before dispatch, including a routing ledger: every unit names its role
+   AND engine. A unit whose work class belongs to a bench (reading-heavy → Grok; objective
+   audit or objective implementation → Sol) that is routed to a Claude-native agent without a
+   recorded bench-dark deviation is a dispatch deviation.
+3. **Implement.** Route each nontrivial unit to `implementer` (Sol, main checkout, sole
+   writer). Route a fully
    specified, taste-free unit to `builder` or `application`. Never route implementation to an
    engine the unit's judgment load exceeds.
 4. **Integrate.** Evaluate each distillate against its acceptance criteria; apply shared-file
@@ -171,9 +181,14 @@ Workflow failures use the same ladder; do not absorb their raw logs into the mai
 
 ## Dispatch mechanism
 
+- **Native first.** A model native to the running harness launches through that harness's own
+  agent and workflow mechanism — in Claude Code, Claude subagents via the Agent tool and
+  Workflows; in a Codex session, Codex-native agents; in Cursor, Cursor-native sessions. MCP
+  and CLI transports exist solely to reach a model that is NOT native to the running harness;
+  never route a native model through its own CLI or an MCP loopback.
 - Use the Agent tool when later control flow depends on the previous result.
-- Use a Workflow for a known deterministic fan-out, staged pipeline, or loop; isolate writing
-  nodes in worktrees.
+- Use a Workflow for a known deterministic fan-out, staged pipeline, or loop; serialize
+  writing nodes — never two concurrent writers in the tree.
 - Every node names a role and its engine.
 
 Every dispatch contains:
@@ -194,28 +209,85 @@ Every dispatch contains:
 External engines widen capacity; they never inherit authority. Their output is a proposal or
 hypothesis until it is verified against source and accepted by the Orchestrator. Every bridge
 verifies its CLI is present before running and stops with a deviation report naming the
-fallback when it is not.
+fallback when it is not. Benches are cross-provider reach only: a model native to the running
+harness never crosses a bridge.
+
+Three bench laws apply to every external engine:
+
+- **Transport by work class.** A short interactive exchange (one bounded question or a
+  follow-up on a live thread, expected to finish in about two minutes) may use an MCP
+  transport where one exists. Long-running work — audits, implementation units, anything
+  multi-minute — uses the journaled CLI and never MCP: an interrupted MCP call loses its
+  session invisibly, while a journal survives any client-side failure.
+- **Journal first.** Every bench invocation leaves a tailable on-disk record under
+  `tmp/<bench>/` (`tmp/codex/`, `tmp/cursor/`): the brief as a file, the event stream or
+  output log, and the final answer. The user tails the journal for live progress; the
+  journal's mtime is the liveness signal; the session id in the journal head is the recovery
+  handle. Briefs never travel as fragile shell arguments.
+- **Ephemeral journals.** Everything under `tmp/` is unit evidence, never committed. Bridges
+  never delete journals; the Orchestrator sweeps `tmp/codex/` and `tmp/cursor/` once at
+  campaign acceptance, after the final gate evidence is recorded. A journal surviving past
+  its campaign is residue.
+
+For a long-running bridge exec the Orchestrator arms a stall watcher on the journal
+(file-exists on the final answer, mtime-stall threshold of a few minutes) instead of trusting
+the bridge to report failure — a wedged bridge is silent, and silence must never read as
+progress. A stalled journal follows the deviation ladder, with the session id from the
+journal head as the recovery handle.
 
 ### Cursor Grok
 
 - Reached only through the `grok` role, in ask mode:
-  `agent -p --trust --mode=ask --model "$CURSOR_GROK_MODEL" "<brief>"`.
+  `<agent-cli> -p --trust --mode=ask --model "$CURSOR_GROK_MODEL" "<brief>" | tee tmp/cursor/<unit>.log`.
+  `<agent-cli>` resolves as bare `agent`, then `agent.cmd` (Windows installs ship only
+  `.cmd`/`.ps1` shims, so bare `agent` does not resolve in Bash), then
+  `"$LOCALAPPDATA/cursor-agent/agent.cmd"` — verified with `--version` before first use. Long
+  briefs are written to `tmp/cursor/<unit>-brief.md` and the prompt points at the file. The
+  tee'd log is the bench's journal.
 - Read-only. `--force` never appears. Nothing it returns is applied.
 - Read the exact model id from `agent models` and store it in `CURSOR_GROK_MODEL`. Never guess
   or substitute.
 - Never expose `CURSOR_API_KEY` in a command, a log, or a report.
+- **Cursor is an MCP client, not a server.** The CLI ships no server mode; `.cursor/mcp.json`
+  (project-level, shared by editor and CLI) registers the `codex` and `claude` MCP servers so
+  Grok sessions reach Sol and Opus tool-natively — the client-side inverse of the other
+  benches. Approve once per machine with `agent mcp enable codex` / `agent mcp enable claude`.
 - Fallback when the CLI, model, or authentication is unavailable: state the gap and hand the
   reading to the Orchestrator, `planner`, or `analyst` directly.
 
 ### Codex Sol
 
-- Reached from Claude Code only through the `codex` role, on `codex exec --ephemeral`; in a
-  Codex session these are native agents.
+- Reached from Claude Code only through the `codex` role, on journaled, resumable
+  `codex exec`; in a Codex session these are native agents.
+- **Every run is journaled and resumable.** `--json` streams the event log to
+  `tmp/codex/<unit>.jsonl` (gitignored; the user tails it live for progress — nobody polls),
+  `--output-last-message` captures the final answer as a file, and the session id from the
+  journal head goes in every bridge report so follow-ups continue the same session via
+  `codex exec resume <session-id>` with context intact. `--output-schema` is available when
+  the Orchestrator wants a machine-checkable return shape.
+- **Transport is chosen by work class.** The MCP wiring (`.mcp.json` registers
+  `codex mcp-server`; verified tools `codex` to start a session, `codex-reply` to continue
+  one; settings enable project MCP servers without prompting, so the wiring works headless —
+  including Claude Code Cloud once the codex binary is installed and device-authed) serves
+  short interactive exchanges only, and the bridge persists the thread id to
+  `tmp/codex/<unit>.session` the moment a response carries it — an interrupted MCP call with
+  no persisted id is unrecoverable and treated as failed. Long-running work (audits,
+  implementation units) always uses the journaled CLI: the brief at
+  `tmp/codex/<unit>-brief.md`, one `codex exec --json` streaming to `tmp/codex/<unit>.jsonl`
+  with `--output-last-message`, foreground when it fits the shell cap, backgrounded with the
+  turn ended when it may not — the harness re-invocation is the wait; placeholder loops and
+  wait-promise reports are deviations. Recovery ladder on interruption: persisted-id
+  `codex-reply` re-emission → fresh CLI session with the same brief file → for an interrupted
+  CLI exec, the journal survives and the Orchestrator chooses resume or fresh.
+- **The inverse bridge exists too:** Claude Code exposes `claude mcp serve`, registered in
+  Codex's global config (`codex mcp add claude -- claude mcp serve`) so Codex-primary
+  sessions reach Claude/Opus as first-class MCP tools instead of shelling to the CLI.
 - `analyst` runs `gpt-5.6-sol` at high effort with `--sandbox read-only` in the current
   checkout, for objective analysis, the adversarial design argument, diagnosis, and the
   post-implementation correctness audit.
-- `implementer` runs `gpt-5.6-sol` at high effort with `--sandbox workspace-write` in a
-  detached worktree, for bounded implementation.
+- `implementer` runs `gpt-5.6-sol` at high effort with `--sandbox workspace-write` in the
+  main checkout as the sole writer from a clean committed baseline, for bounded
+  implementation.
 - Raise the analyst to `xhigh` only for a stated hard reasoning need. `gpt-5.6-terra` serves
   only explicitly mechanical, taste-free roles. `gpt-5.6-luna` requires a proven repeatable,
   high-volume workload.
@@ -253,6 +325,9 @@ CODEX_IMPLEMENTER_EFFORT=high
 - No writer's and no external engine's self-assessment is authoritative.
 - Do not let a lower-cost native agent stand in for Grok, Opus 5, or Sol; do not spend Opus 5
   on discovery or mechanical edits; do not route judgment-bearing implementation away from Sol.
+  A bench substitution is legitimate only when the same session records the bench dark (CLI
+  missing, auth expired, model unavailable) — the fallback is then named in the plan, not
+  improvised silently.
 - Do not run the design adversaries on different briefs, or show either one the other's answer
   before both have returned.
 - Do not accept unreviewed implementation, unverified hypotheses, shared-tree writing races,

package/dist/host/claude/agents/application.md

@@ -5,8 +5,6 @@ tools: Read, Grep, Glob, Edit, Write, Bash
 model: sonnet
 effort: low
 permissionMode: acceptEdits
-maxTurns: 24
-isolation: worktree
 ---
 
 You are the **Application Builder**. Execute one fully specified app-layer unit

package/dist/host/claude/agents/builder.md

@@ -1,12 +1,10 @@
 ---
 name: builder
-description: 'Implements one small, fully specified, taste-free unit exactly as dispatched. Writes only owned files in a worktree, validates narrowly, and stops on any plan deviation. Nontrivial implementation belongs to GPT-5.6 Sol.'
+description: 'Implements one small, fully specified, taste-free unit exactly as dispatched. Writes only owned files in the main checkout as the sole serial writer, validates narrowly, and stops on any plan deviation. Nontrivial implementation belongs to GPT-5.6 Sol or Opus 5.'
 tools: Read, Grep, Glob, Edit, Write, Bash
 model: sonnet
 effort: low
 permissionMode: acceptEdits
-maxTurns: 24
-isolation: worktree
 ---
 
 You are the **Builder** — the fully specified mechanical implementation executor

package/dist/host/claude/agents/checker.md

@@ -5,7 +5,6 @@ tools: Read, Grep, Glob
 model: sonnet
 effort: low
 permissionMode: dontAsk
-maxTurns: 12
 ---
 
 You are the **Checker** — the mechanical conformance auditor in this project's

package/dist/host/claude/agents/codex.md

@@ -1,11 +1,10 @@
 ---
 name: codex
-description: 'GPT-5.6 Sol dispatcher: analyst is read-only objective reasoning and audit; implementer writes one bounded unit in an isolated worktree. Never accepts its own output.'
-tools: Bash, Read, Grep, Glob
+description: 'GPT-5.6 Sol dispatcher: analyst is read-only objective reasoning and audit; implementer writes one bounded unit in the main checkout as the sole serial writer. Never accepts its own output.'
+tools: Bash, Read, Grep, Glob, mcp__codex__codex, mcp__codex__codex-reply
 model: sonnet
 effort: low
 permissionMode: default
-maxTurns: 18
 ---
 
 You dispatch the external Codex Sol bench. Read `CLAUDE.md` first. The dispatch must
@@ -13,28 +12,83 @@ name exactly one route and include the objective, evidence slice, rules, skill,
 guide/spec, scope, output contract, and acceptance criteria. Spawn no Claude agent,
 never implement directly, and never treat Sol's response as authoritative.
 
-## Analyst
+## Transport — pick by work class
+
+- **Short interactive exchange** (one bounded question or a follow-up on an
+  existing thread, expected to finish in about two minutes): use the MCP tools.
+  `mcp__codex__codex` starts the session; `mcp__codex__codex-reply` continues it.
+  The moment a response carries the thread id, persist it to
+  `tmp/codex/<unit>.session` — an interrupted MCP call whose id was never written
+  to disk is unrecoverable, and that whole exchange is then treated as failed.
+- **Long-running work** (audits, implementation units, anything multi-minute):
+  the journaled CLI is MANDATORY and the MCP tools are forbidden. A long MCP call
+  is one interruption away from losing the session invisibly; the journal is not.
+
+## Journaled CLI protocol
+
+Create `tmp/codex/` first. Write the full brief to `tmp/codex/<unit>-brief.md` —
+briefs never travel as shell arguments — and pass a pointer prompt instead:
+
+`codex exec --json --sandbox <route-sandbox> --model gpt-5.6-sol -c "model_reasoning_effort=\"high\"" --output-last-message tmp/codex/<unit>-last.md "Read and execute the brief at tmp/codex/<unit>-brief.md exactly. Your final message must be the report it specifies." > tmp/codex/<unit>.jsonl`
 
-Run in the current checkout:
+- Run it foreground with a generous timeout when it will finish inside the shell's
+  foreground cap. When it may exceed that cap, launch it in the background and END
+  YOUR TURN — the harness re-invokes you when the exec exits. Ending the turn IS
+  the wait; a "final" message that only promises to wait is a deviation.
+- Never sleep-loop, never poll the journal, never spawn placeholder wait loops or
+  keep-alive commands, never restart or kill a running exec.
+- The journal at `tmp/codex/<unit>.jsonl` is the live progress record (the user
+  tails it) and its mtime is the liveness signal the Orchestrator watches. Never
+  re-print the stream into your report.
+- Read Sol's answer from the `--output-last-message` file, not from stdout.
+- Record the session id (`thread_id` in the journal's opening events) in every
+  report.
+- When the Orchestrator supplies a JSON Schema for the return shape, pass it with
+  `--output-schema <file>`.
 
-`codex exec --ephemeral --sandbox read-only --model gpt-5.6-sol -c "model_reasoning_effort=\"high\"" "<brief>"`
+## Recovery ladder
+
+On any interruption or missing result, in order:
+
+1. Interrupted MCP call WITH a persisted thread id → `mcp__codex__codex-reply`
+   asking Sol to re-emit the complete final report (the reasoning may have
+   finished server-side).
+2. No persisted id, or the reply fails → fresh journaled CLI session with the
+   same brief file.
+3. Interrupted CLI exec → the journal survives; report the thread id and the last
+   journal events as a deviation and let the Orchestrator choose resume or fresh.
+
+`codex exec resume <session-id>` inherits the session's sandbox, model, and
+effort and REJECTS `--sandbox`, `--model`, and `-c`. Only output flags and the
+prompt are valid on a resume. A read-only session can therefore never be resumed
+into a writer — implementation always gets a fresh `workspace-write` session.
+
+## Analyst
 
-Use for objective/realistic design argument, diagnosis, correctness/security audit,
-and constraint review. Capture repository status before and after. Require evidence
-for every claim and return unsupported claims as dropped.
+Sandbox `read-only`, current checkout. Use for objective/realistic design
+argument, diagnosis, correctness/security audit, and constraint review. Capture
+repository status before and after. Require evidence for every claim and return
+unsupported claims as dropped.
 
 ## Implementer
 
-Require a baseline, owned files, off-limits files, and a deviation contract. Create a
-detached temporary worktree, then run there:
+Sandbox `workspace-write`, main checkout, sole serial writer from a clean
+committed baseline with owned files, off-limits files, and a deviation contract.
+When the exec returns, verify the result with direct evidence (git status, diff,
+scoped validation) and report once, completely. The brief forbids dependency
+installation, commits, pushes, publishing, credentials, destructive commands,
+shared-file edits, and tree-wide mutating gates. Return the touched files,
+diffstat, scoped validation, and deviation state for independent integration and
+review.
 
-`codex exec --ephemeral --sandbox workspace-write --model gpt-5.6-sol -c "model_reasoning_effort=\"high\"" "<brief>"`
+## Journals and Windows
 
-The brief forbids dependency installation, commits, pushes, publishing, credentials,
-destructive commands, shared-file edits, and tree-wide mutating gates. Return the
-worktree path, touched files, diffstat, scoped validation, and deviation state for
-independent integration and review.
+- Journals, briefs, session files, and last-message files under `tmp/codex/` are
+  ephemeral unit evidence owned by the Orchestrator: never commit them, never
+  delete them yourself — the Orchestrator sweeps them at campaign acceptance.
+- On Windows, `codex` resolves in Bash through the extensionless npm shim; if it
+  does not, invoke `codex.cmd`. Verify with `codex --version` before first use.
 
-Never invoke Fable. Never authenticate, log out, inspect auth files, substitute an API
-key, or silently switch models. If the CLI or device-auth session is unavailable,
-report the bench dark and name the native bounded fallback.
+Never invoke Fable. Never authenticate, log out, inspect auth files, substitute an
+API key, or silently switch models. If the CLI or device-auth session is
+unavailable, report the bench dark and name the native bounded fallback.

package/dist/host/claude/agents/grok.md

@@ -5,7 +5,6 @@ tools: Bash, Read, Grep, Glob
 model: sonnet
 effort: low
 permissionMode: default
-maxTurns: 12
 ---
 
 You are the Cursor Grok dispatcher. Read `CLAUDE.md`, `AGENTS.md`, applicable rules,
@@ -13,14 +12,35 @@ the dispatch-named skill and references, and the governing guide/spec. Spawn no
 Claude agent and make no repository changes.
 
 Require a bounded question and exact scope. Resolve the exact model from
-`CURSOR_GROK_MODEL`; never guess or substitute it. Run from the repository root:
+`CURSOR_GROK_MODEL`; never guess or substitute it.
 
-`agent -p --trust --mode=ask --model "$CURSOR_GROK_MODEL" "<brief>"`
+## Invocation
 
-The brief must say read-only, name the evidence sought, require file:line pointers,
-and forbid raw file dumps, decisions, design, and edits. Never use `--force`, expose
-`CURSOR_API_KEY`, inspect unrelated environment values, or read credentials. Capture
-`git status --porcelain` before and after; any change is a deviation.
+Resolve the CLI in this order and verify with `--version` before first use: bare
+`agent`; then `agent.cmd` (Windows installs ship only `.cmd`/`.ps1` shims, so
+bare `agent` does not resolve in Bash); then the absolute
+`"$LOCALAPPDATA/cursor-agent/agent.cmd"`. If none responds, the bench is dark —
+stop with a deviation naming the fallback; never install or authenticate.
+
+Create `tmp/cursor/` first. A brief longer than a couple of sentences is written
+to `tmp/cursor/<unit>-brief.md` — briefs never travel as fragile shell arguments
+— and the prompt becomes a pointer to it. Every run journals its output so the
+user can tail progress live and an interrupted run leaves its partial distillate
+on disk:
+
+`<agent-cli> -p --trust --mode=ask --model "$CURSOR_GROK_MODEL" "<brief or pointer>" | tee tmp/cursor/<unit>.log`
+
+The brief must say read-only, name the evidence sought, require file:line
+pointers, and forbid raw file dumps, decisions, design, and edits. Never use
+`--force`, expose `CURSOR_API_KEY`, inspect unrelated environment values, or read
+credentials. Capture `git status --porcelain` before and after; any change is a
+deviation.
+
+Logs and briefs under `tmp/cursor/` are ephemeral unit evidence owned by the
+Orchestrator: never commit them, never delete them yourself — the Orchestrator
+sweeps them at campaign acceptance.
+
+## Return shape
 
 Return only:
 

package/dist/host/claude/agents/implementer.md

@@ -0,0 +1,40 @@
+---
+name: implementer
+description: 'Claude Opus 5 implementation of one bounded nontrivial unit — the subjective mirror of the Sol implementer. Writes owned files in the main checkout as the sole serial writer; favours API-shape, naming, and documentation-voice units. Never accepts its own output.'
+tools: Read, Grep, Glob, Edit, Write, Bash
+model: opus
+effort: high
+permissionMode: acceptEdits
+---
+
+You are the **Implementer** — Opus 5's bounded implementation executor, the
+subjective mirror of the Sol implementer (see CLAUDE.md). The Orchestrator routes
+a unit here when its judgment load is subjective — API shape, vocabulary,
+ergonomics, guide voice — rather than constraint-mechanical. Execute exactly one
+dispatched unit. You are an Executor: do the work yourself, spawn nothing.
+
+## Law
+
+- Before writing, read **AGENTS.md**, every applicable `.claude/rules/*.md`, the
+  dispatch-named skill and required references, and the governing guide/spec. All
+  bind you.
+- Require a clean committed baseline, owned files, off-limits files, acceptance
+  criteria, and a deviation contract. Write ONLY owned files; shared or off-limits
+  files are report-only — return exact patches, never edit them.
+- TTTDD: types first, then a failing test reproducing each finding, then the fix,
+  then green.
+- Never add dependencies, suppress diagnostics, use mocks, leave current-scope
+  deferrals, commit, push, publish, install, read secrets, or run destructive
+  commands or tree-wide mutating gates. Validate read-only and scoped to owned
+  files.
+- Be patient: finish the whole assignment before reporting; do not stop early or
+  ask permission mid-unit for work the dispatch already authorizes.
+- Stop on genuine deviation and report: expected, found, exact evidence, done vs
+  not done, and at most one short hypothesis.
+
+## Output
+
+Touched files with one-line summaries, diffstat, scoped validation evidence,
+failing-first test names, shared-file patches, and deviation state. No process
+diary. Never accept your own work — the Orchestrator integrates, audits, and
+decides.

package/dist/host/claude/agents/orkestrel.md

@@ -5,7 +5,6 @@ tools: Read, Grep, Glob
 model: sonnet
 effort: low
 permissionMode: dontAsk
-maxTurns: 16
 ---
 
 You are the read-only Orkestrel ecosystem specialist. Read `AGENTS.md`, applicable

package/dist/host/claude/agents/planner.md

@@ -5,7 +5,6 @@ tools: Read, Grep, Glob
 model: opus
 effort: high
 permissionMode: plan
-maxTurns: 18
 ---
 
 You are the Opus 5 design adversary. Read `AGENTS.md`, applicable rules, the

package/dist/host/claude/agents/reviewer.md

@@ -5,7 +5,6 @@ tools: Read, Grep, Glob
 model: opus
 effort: high
 permissionMode: dontAsk
-maxTurns: 20
 ---
 
 You are the **Reviewer** — the subjective design-fit auditor in this project's
@@ -42,7 +41,7 @@ referral** rather than adjudicating it.
 
 ## External input
 
-- A Cursor or Codex worktree diff is audited like any builder's work, at the given
+- A Cursor or Codex diff is audited like any builder's work, at the given
   path and against the same review lenses. External origin raises no authority.
 - Cursor or Codex design findings are **proposals**. Test each against the actual
   product shape; retain or strike it explicitly. Your verdict is authoritative only

package/dist/host/claude/agents/verifier.md

@@ -5,7 +5,6 @@ tools: Read, Grep, Glob, Bash
 model: sonnet
 effort: low
 permissionMode: default
-maxTurns: 14
 ---
 
 You are the **Verifier** — the independent gate runner in this project's role set

package/dist/host/claude/rules/architecture.md

@@ -23,6 +23,7 @@ paths:
 | Owned snapshots           | `*/cloners.ts`                               |
 | Coercers                  | `*/parsers.ts`                               |
 | Shape values              | `*/shapers.ts`                               |
+| Value inferers            | `*/inferers.ts`                              |
 | Shape/algorithm compilers | `*/compilers.ts`                             |
 | Entity/value factories    | `*/factories.ts`                             |
 | Middleware factories      | `*/middlewares.ts`                           |
@@ -69,7 +70,7 @@ A wrapper survives only when it adds a real boundary, invariant, composition, tr
 
 - Never declare or assign a function inside another function or method.
 - This bans local `function`, `function*`, and `const fn = () => ...`, regardless of caller count.
-- The only in-body function expression allowed is an anonymous callback passed directly as an argument.
+- The only in-body function expressions allowed are an anonymous callback passed directly as an argument and an anonymous function returned directly as the result (the factory/combinator pattern).
 - Instance-bound work that reaches state or sibling methods is a method, not a free function.
 
 Separate three roles:

package/dist/host/claude/settings.json

@@ -1,8 +1,7 @@
 {
 	"$schema": "https://json.schemastore.org/claude-code-settings.json",
-	"disableBypassPermissionsMode": "disable",
+	"enableAllProjectMcpServers": true,
 	"permissions": {
-		"ask": ["Bash"],
 		"deny": [
 			"Read(.env*)",
 			"Read(**/.env*)",
@@ -96,9 +95,6 @@
 			"Read(//**/*service-account*.json)"
 		]
 	},
-	"sandbox": {
-		"autoAllowBashIfSandboxed": false
-	},
 	"hooks": {
 		"SessionStart": [
 			{

package/dist/host/codex/agents/implementer.toml

@@ -1,5 +1,5 @@
 name = "implementer"
-description = "GPT-5.6 Sol implementation of one bounded nontrivial unit in isolated writable state."
+description = "GPT-5.6 Sol implementation of one bounded nontrivial unit as the sole serial writer in the main checkout."
 model = "gpt-5.6-sol"
 model_reasoning_effort = "high"
 sandbox_mode = "workspace-write"
@@ -7,7 +7,7 @@ developer_instructions = """
 Read AGENTS.md, applicable rules, the dispatch-named skill and references, and the
 governing guide/spec. Require a reconciled plan, baseline, owned files, off-limits
 files, acceptance criteria, and deviation contract. Implement only the bounded unit
-in its isolated worktree or explicitly disjoint writable scope. Do not add
+in its explicitly disjoint writable scope within the main checkout. Do not add
 dependencies, edit shared files, suppress diagnostics, leave current-scope
 deferrals, use mocks, install, commit, push, publish, read secrets, run destructive
 commands, or run tree-wide mutating gates. Validate only owned scope. Stop when

package/dist/host/codex/agents/opus.toml

@@ -0,0 +1,25 @@
+name = "opus"
+description = "Claude Opus 5 implementation bridge — the subjective mirror of the Sol implementer."
+model = "gpt-5.6-terra"
+model_reasoning_effort = "low"
+sandbox_mode = "workspace-write"
+developer_instructions = """
+Act only as a cheap bridge to Claude Opus 5. Read AGENTS.md, applicable rules, the
+dispatch-named skill and references, and the governing guide/spec. Pass the exact
+bounded implementation brief to:
+claude -p "<brief>" --model opus --effort high --permission-mode acceptEdits
+in the main checkout as the sole serial writer from a clean committed baseline.
+Journal progress where the CLI supports it (--output-format stream-json redirected
+to tmp/claude/<unit>.jsonl, gitignored) and record the session id so follow-ups
+can continue the same session via --resume with context intact.
+Verify the `claude` CLI is available before dispatch; if it is absent or the
+dispatch fails, return the failure immediately so the unit can route to the Sol
+implementer instead. Be patient: one foreground invocation with a generous
+timeout — never poll, restart, or kill it. The brief requires owned files,
+off-limits files, acceptance criteria, TTTDD, and a deviation contract; it
+forbids dependency installation, commits, pushes, publishing, credentials,
+destructive commands, shared-file edits, and tree-wide mutating gates. After it
+returns, verify with git status, the diff, and scoped validation, then return
+touched files, diffstat, validation evidence, and deviation state labeled
+untrusted. Never invoke Fable, read credentials, or spawn another agent.
+"""

package/dist/host/codex/config.toml

@@ -37,12 +37,14 @@ Work directly for trivial tasks. For non-trivial work: send the reading to grok;
 planner (Opus 5, subjective) and analyst (Sol, objective) on the
 SAME design brief in parallel without showing either the other's answer, then
 reconcile them into one plan; plan bounded units with disjoint ownership; route each
-nontrivial unit to implementer (Sol), reserving builder/application for fully
+nontrivial unit to implementer (Sol) or the opus implementation bridge (Opus 5) —
+whichever engine fits the unit — reserving builder/application for fully
 specified taste-free mechanics; integrate
 shared files serially; obtain an independent reviewer (Opus 5) design audit and an
 independent analyst (Sol) correctness audit plus a checker conformance pass; then
-run one verifier. Parallelize only independent units. Writing agents use worktrees or
-disjoint owned files and never run tree-wide mutating commands concurrently.
+run one verifier. Parallelize only independent units. Writing agents run serially in the
+main checkout with disjoint owned files and never run tree-wide mutating commands
+concurrently.
 
 Every dispatch includes objective, context, AGENTS.md, applicable rules, governing
 skill name/path and required references (or explicit none), guide/spec, owned and