@azure-id/orc 1.8.1 → 1.9.0

package/bin/verify-contracts.js

@@ -27,8 +27,6 @@ const CONTRACTS = [
     token: "actual_model",
     files: [
       "agents/MODEL-MAPPING.md",
-      // v1.8.0 — the graph noter reports its model like every other role.
-      "agents/orc-graph-noter-sonnet-4-6-med.md",
       "agents/orc-advisor-opus-5-xhigh.md",
       "agents/orc-analyze-mini-opus-5-med.md",
       "agents/orc-analyze-mini-sonnet-5-high.md",
@@ -62,6 +60,8 @@ const CONTRACTS = [
       "agents/orc-planner-mini-opus-5-med.md",
       "agents/orc-planner-mini-sonnet-5-high.md",
       "agents/orc-planner-opus-5-med.md",
+      "agents/orc-recon-opus-5-low.md",
+      "agents/orc-recon-sonnet-4-6-med.md",
       "agents/orc-retro-opus-5-med.md",
       "agents/orc-retro-sonnet-5-high.md",
       "agents/orc-reviewer-opus-5-med.md",
@@ -76,6 +76,9 @@ const CONTRACTS = [
       "agents/orc-wiki-scanner-sonnet-5-high.md",
       "hooks/orc-trace.js",
       "skills/_shared/extra-dispatch.md",
+      "skills/_shared/phases/execution.md",
+      "skills/_shared/phases/trace.md",
+      "skills/_shared/phases/trace.md",
       "skills/_shared/return-validation.md",
       "skills/orc-advisor/SKILL.md",
       "skills/orc-analyze-mini/SKILL.md",
@@ -88,7 +91,6 @@ const CONTRACTS = [
       "skills/orc-challenge/references/council.md",
       "skills/orc-claude/SKILL.md",
       "skills/orc-claude/examples/claude-run-mock.md",
-      "skills/_shared/phases/trace.md",
       "skills/orc-doc/SKILL.md",
       "skills/orc-doc/examples/orc-doc-prd-run.md",
       "skills/orc-fast/SKILL.md",
@@ -104,7 +106,6 @@ const CONTRACTS = [
       "skills/orc-wiki/references/extra.md",
       "skills/orc/README.md",
       "skills/orc/SKILL.md",
-      "skills/_shared/phases/trace.md",
       "skills/orc/schemas/checkpoint.md",
       "skills/orc/subskills/orc-execution/SKILL.md",
       "skills/orc/subskills/orc-execution/core.md",
@@ -112,7 +113,8 @@ const CONTRACTS = [
       "skills/orc/subskills/orc-review-verify/SKILL.md",
       "skills/orc/subskills/orc-review-verify/core.md",
       "skills/orc/subskills/orc-testgen/core.md",
-      "skills/_shared/phases/execution.md",
+      // v1.8.0 — the graph noter reports its model like every other role.
+      "agents/orc-graph-noter-sonnet-4-6-med.md",
     ],
   },
   {
@@ -440,16 +442,18 @@ const CONTRACTS = [
     token: "orc run inflight",
     binFiles: ["bin/cli.js"],
     files: [
-      "skills/orc-test/SKILL.md",
+      "agents/MODEL-MAPPING.md",
       "hooks/README.md",
-      "skills/_shared/return-validation.md",
       "skills/_shared/phases/execution.md",
-      "skills/orc/SKILL.md",
+      "skills/_shared/return-validation.md",
       "skills/orc-doc/SKILL.md",
-      "skills/orc-wiki/SKILL.md",
-      "skills/orc-quick/SKILL.md",
-      "skills/orc-mini/SKILL.md",
       "skills/orc-fast/SKILL.md",
+      "skills/orc-mini/SKILL.md",
+      "skills/orc-quick/SKILL.md",
+      "skills/orc-quick/references/dispatch-gate.md",
+      "skills/orc-test/SKILL.md",
+      "skills/orc-wiki/SKILL.md",
+      "skills/orc/SKILL.md",
     ],
   },
   {
@@ -624,10 +628,9 @@ const CONTRACTS = [
     files: [
       "agents/orc-analyze-mini-opus-5-med.md",
       "agents/orc-analyze-mini-sonnet-5-high.md",
+      "agents/orc-recon-opus-5-low.md",
+      "agents/orc-recon-sonnet-4-6-med.md",
       "agents/orc-system-analyst-opus-5-high.md",
-      // v0.39.0: the read ladder's anti-chain rule ends in a `searched:` return,
-      // so a rename of the attestation field has to reach it too.
-      "skills/_shared/read-ladder.md",
       "skills/orc-analyze-mini/SKILL.md",
       "skills/orc-analyze/SKILL.md",
       "skills/orc-analyze/references/deep-mode.md",
@@ -635,6 +638,9 @@ const CONTRACTS = [
       "skills/orc-analyze/schemas/report-prose.md",
       "skills/orc-analyze/schemas/report-requirement.md",
       "skills/orc-analyze/schemas/requirement-spec.md",
+      // so a rename of the attestation field has to reach it too.
+      "skills/_shared/read-ladder.md",
+      // v0.39.0: the read ladder's anti-chain rule ends in a `searched:` return,
     ],
   },
   {
@@ -722,29 +728,31 @@ const CONTRACTS = [
     files: [
       "agents/orc-retro-opus-5-med.md",
       "agents/orc-retro-sonnet-5-high.md",
-      "skills/orc-analyze/SKILL.md",
+      "skills/_shared/phases/analyst-gates.md",
+      "skills/_shared/phases/execution.md",
+      "skills/_shared/phases/plan-handoff.md",
+      "skills/_shared/phases/planning.md",
+      "skills/_shared/phases/preflight.md",
+      "skills/_shared/phases/ship.md",
+      "skills/_shared/phases/stop-resume.md",
+      "skills/_shared/phases/trace.md",
       "skills/_shared/phases/trace.md",
+      "skills/orc-analyze/SKILL.md",
       "skills/orc-fast/SKILL.md",
       "skills/orc-mini/SKILL.md",
+      "skills/orc-mini/references/complexity.md",
       "skills/orc-poly/SKILL.md",
       "skills/orc-poly/examples/poly-run-mock.md",
+      "skills/orc-pr-driver/SKILL.md",
       "skills/orc-quick/SKILL.md",
+      "skills/orc-quick/references/look.md",
       "skills/orc-retro/SKILL.md",
       "skills/orc/SKILL.md",
-      "skills/_shared/phases/analyst-gates.md",
+      "skills/orc/config.md",
       "skills/orc/references/effort-and-mode.md",
-      "skills/_shared/phases/plan-handoff.md",
-      "skills/_shared/phases/stop-resume.md",
-      "skills/_shared/phases/trace.md",
+      "skills/orc/references/preflight-report.md",
       "skills/orc/references/ultra-mode.md",
-      "skills/orc-pr-driver/SKILL.md",
       "skills/orc/subskills/orc-pr/stack-gate.md",
-      "skills/orc/config.md",
-      "skills/orc/references/preflight-report.md",
-      "skills/_shared/phases/preflight.md",
-      "skills/_shared/phases/execution.md",
-      "skills/_shared/phases/planning.md",
-      "skills/_shared/phases/ship.md",
     ],
   },
   {
@@ -1161,6 +1169,7 @@ const CONTRACTS = [
       "skills/_shared/README.md",
       "skills/_shared/interview.md",
       "skills/_shared/lane-suspend.md",
+      "skills/_shared/phases/intake.md",
       "skills/orc-boundary/SKILL.md",
       "skills/orc-brainstorm/SKILL.md",
       "skills/orc-challenge/SKILL.md",
@@ -1170,7 +1179,8 @@ const CONTRACTS = [
       "skills/orc-doc/references/gates.md",
       "skills/orc-grill/SKILL.md",
       "skills/orc-pact/SKILL.md",
-      "skills/_shared/phases/intake.md",
+      "skills/orc-quick/SKILL.md",
+      "skills/orc-quick/references/dispatch-gate.md",
     ],
   },
   {
@@ -1893,25 +1903,26 @@ const CONTRACTS = [
       "agents/orc-planner-opus-5-med.md",
       "agents/orc-retro-opus-5-med.md",
       "agents/orc-retro-sonnet-5-high.md",
+      "commands/orc-route.md",
+      "skills/_shared/phases/analyst-gates.md",
+      "skills/_shared/phases/plan-handoff.md",
+      "skills/_shared/phases/planning.md",
+      "skills/_shared/phases/scoring.md",
+      "skills/_shared/phases/trace.md",
+      "skills/_shared/phases/wave-grouping.md",
       "skills/orc-mini/SKILL.md",
+      "skills/orc-mini/references/complexity.md",
       "skills/orc-retro/SKILL.md",
+      "skills/orc-route/SKILL.md",
       "skills/orc/README.md",
       "skills/orc/SKILL.md",
       "skills/orc/config.md",
       "skills/orc/examples/full-run-mock.md",
-      "skills/_shared/phases/analyst-gates.md",
       "skills/orc/references/effort-and-mode.md",
-      "skills/_shared/phases/plan-handoff.md",
-      "skills/_shared/phases/trace.md",
-      "skills/_shared/phases/wave-grouping.md",
+      "skills/orc/references/preflight-report.md",
       "skills/orc/schemas/planning-output.md",
       "skills/orc/subskills/orc-planner-mini/SKILL.md",
       "skills/orc/subskills/orc-planner/SKILL.md",
-      "commands/orc-route.md",
-      "skills/orc-route/SKILL.md",
-      "skills/orc/references/preflight-report.md",
-      "skills/_shared/phases/planning.md",
-      "skills/_shared/phases/scoring.md",
     ],
   },
   {
@@ -2521,23 +2532,24 @@ const CONTRACTS = [
     binFiles: ["bin/cli.js"],
     files: [
       "skills/_shared/fallback-handoff.md",
+      "skills/_shared/phases/intake.md",
+      "skills/_shared/phases/stop-resume.md",
       "skills/_shared/stack-plan.md",
       "skills/orc-diy/references/blocks/header.md",
       "skills/orc-diy/references/locked-blocks.md",
+      "skills/orc-doc/README.md",
+      "skills/orc-doc/references/chunking.md",
+      "skills/orc-doc/references/gates.md",
+      "skills/orc-doc/references/resume-protocol.md",
       "skills/orc-export/SKILL.md",
       "skills/orc-fast/SKILL.md",
       "skills/orc-mini/SKILL.md",
+      "skills/orc-quick/SKILL.md",
       "skills/orc-quick/references/context-doc.md",
       "skills/orc-wiki/SKILL.md",
       "skills/orc/README.md",
       "skills/orc/SKILL.md",
       "skills/orc/config.md",
-      "skills/_shared/phases/intake.md",
-      "skills/_shared/phases/stop-resume.md",
-      "skills/orc-doc/README.md",
-      "skills/orc-doc/references/chunking.md",
-      "skills/orc-doc/references/gates.md",
-      "skills/orc-doc/references/resume-protocol.md",
     ],
   },
   // ── Stacked pull requests (v0.37.0) ──────────────────────────────────────
@@ -2673,15 +2685,16 @@ const CONTRACTS = [
       "skills/_shared/phases/wiki-consult.md",
       "skills/_shared/read-ladder.md",
       "skills/_shared/return-validation.md",
-      // W6 — the six code lanes open it (S5: a declared capability no lane
-      // points at is a gate that is always off).
-      "skills/orc-diy/references/flow-schema.md",
       "skills/orc-fast/SKILL.md",
       "skills/orc-mini/SKILL.md",
       "skills/orc-quick/SKILL.md",
       "skills/orc-quick/references/dispatch-gate.md",
+      "skills/orc-quick/references/look.md",
       "skills/orc-wiki/references/staleness.md",
       "skills/orc/SKILL.md",
+      // W6 — the six code lanes open it (S5: a declared capability no lane
+      // points at is a gate that is always off).
+      "skills/orc-diy/references/flow-schema.md",
     ],
   },
   {
@@ -2691,9 +2704,12 @@ const CONTRACTS = [
     name: "graph precedence (v1.8.0 — code > graph structure > fresh wiki > stale wiki > graph notes > priors)",
     token: "code > graph structure",
     files: [
+      "agents/orc-recon-opus-5-low.md",
+      "agents/orc-recon-sonnet-4-6-med.md",
       "skills/_shared/code-graph.md",
       "skills/_shared/phases/wiki-consult.md",
       "skills/_shared/read-ladder.md",
+      "skills/orc-quick/references/look.md",
       "skills/orc-wiki/references/staleness.md",
     ],
   },
@@ -2713,14 +2729,216 @@ const CONTRACTS = [
       "agents/orc-executor-sonnet-4-6-high.md",
       "agents/orc-executor-sonnet-4-6-med.md",
       "agents/orc-executor-sonnet-5-high.md",
+      "agents/orc-recon-opus-5-low.md",
+      "agents/orc-recon-sonnet-4-6-med.md",
       "skills/_shared/code-graph.md",
       "skills/_shared/phases/execution.md",
       "skills/_shared/read-ladder.md",
       "skills/_shared/return-validation.md",
+      "skills/orc-mini/SKILL.md",
+      "skills/orc-quick/SKILL.md",
       // W9: the two single-executor spines name it in their code-graph step.
       "skills/orc-fast/SKILL.md",
+    ],
+  },
+  // ── v1.8.2 W3 — the delivery flags (D1 · D2 · D3 · D5) ────────────────
+  {
+    // The slice call. A rename must reach the contract, the phase file that
+    // makes the call, the hook that dedupes against what it delivered, and the
+    // CLI that answers it.
+    name: "graph slice view (v1.8.2 — ctx --for-slice, the OUTSIDE view of a declared file)",
+    token: "--for-slice",
+    files: [
+      "hooks/orc-graph-hook.js",
+      "skills/_shared/code-graph.md",
+      "skills/_shared/phases/execution.md",
+      "skills/orc-mini/SKILL.md",
+      "skills/orc-mini/examples/mini-run-mock.md",
+      "skills/orc-quick/SKILL.md",
+      "skills/orc-quick/references/look.md",
+    ],
+    binFiles: ["bin/cli.js", "bin/graph-query.js"],
+  },
+  {
+    // The card and the range in one call. Pinned WITH its argument, because a
+    // bare `--source` is also `orc doc`'s own flag.
+    name: "graph source block (v1.8.2 — ctx --source [N], charged to the same budget)",
+    token: "--source [N]",
+    files: [
+      "agents/orc-recon-opus-5-low.md",
+      "agents/orc-recon-sonnet-4-6-med.md",
+      "skills/_shared/code-graph.md",
+      "skills/_shared/read-ladder.md",
+      "skills/orc-quick/references/look.md",
+    ],
+    binFiles: ["bin/cli.js"],
+  },
+  // ── v1.9.0 — the lean lanes reproduce before they fix ───────────────────
+  {
+    // The slice field that makes a defect entry show the bug RED first. It is
+    // a CONDITIONAL, and the conditional is the contract: `repro` alone also
+    // matches "reproducible" and "reproduce" in files that owe nothing here.
+    // Every executor carries the step, the shared return contract validates it
+    // (§5d), and the full lane's execution core states it once.
+    name: "reproduce-first slice field (v1.9.0 — repro.required)",
+    token: "repro.required: true",
+    files: [
+      "agents/orc-executor-haiku-4-5.md",
+      "agents/orc-executor-opus-4-7-high.md",
+      "agents/orc-executor-opus-4-7-med.md",
+      "agents/orc-executor-opus-4-8-high.md",
+      "agents/orc-executor-opus-5-high.md",
+      "agents/orc-executor-opus-5-low.md",
+      "agents/orc-executor-opus-5-med.md",
+      "agents/orc-executor-sonnet-4-6-high.md",
+      "agents/orc-executor-sonnet-4-6-med.md",
+      "agents/orc-executor-sonnet-5-high.md",
+      "skills/_shared/return-validation.md",
+      "skills/orc/subskills/orc-execution/core.md",
+    ],
+  },
+  {
+    // The trace verb. `/orc-retro` counts a reproduction apart from a TDD
+    // cycle, so the verb is defined in the protocol, emitted by the lane that
+    // asks for it, explained in that lane's reference, and declared in the
+    // CLI's own phase manifest — one place each, pinned together.
+    name: "reproduce-first trace verb (v1.9.0 — REPRO red|green)",
+    token: "REPRO",
+    files: [
+      "skills/_shared/phases/trace.md",
+      "skills/orc-quick/SKILL.md",
+      "skills/orc-quick/references/defect.md",
+    ],
+    binFiles: ["bin/cli.js"],
+  },
+  {
+    // One call at a wave close. The two-call form still works; the lane text
+    // uses this one, so the flag has to exist wherever the text says it does.
+    name: "graph one-call update (v1.8.2 — update --notes-pending)",
+    token: "--notes-pending",
+    files: [
+      "skills/_shared/code-graph.md",
+      "skills/_shared/phases/execution.md",
       "skills/orc-mini/SKILL.md",
+      "skills/orc-quick/SKILL.md",
+    ],
+    binFiles: ["bin/cli.js"],
+  },
+  {
+    // The fourth value of `code_graph_hooks`. It arms the whole-file READ hint
+    // and nothing else, and it is off until somebody types it.
+    name: "graph read hint (v1.8.2 — code_graph_hooks: on,read)",
+    token: "on,read",
+    files: ["hooks/orc-graph-hook.js", "hooks/README.md", "skills/_shared/code-graph.md"],
+    binFiles: ["bin/cli.js"],
+  },
+  // ── v1.8.2 W4 — the paid layer, paid less (N1 · N2) ──────────────────
+  {
+    // The noter's ONE call. The flag lives in the agent that makes it and in
+    // the contract that describes it; the CLI has to answer it.
+    name: "graph noter source (v1.8.2 — notes pending --with-source, so the noter reads nothing)",
+    token: "--with-source",
+    files: ["agents/orc-graph-noter-sonnet-4-6-med.md", "skills/_shared/code-graph.md"],
+    binFiles: ["bin/cli.js", "bin/graph-notes.js"],
+  },
+  {
+    // The doc note, at 0 model tokens. It is a note, not a fact, so it sits
+    // beside graph notes in the precedence line everywhere that line appears.
+    name: "doc notes precedence (v1.8.2 — graph notes AND doc notes, below a stale wiki)",
+    token: "graph notes and doc notes",
+    files: [
+      "skills/_shared/code-graph.md",
+      "skills/_shared/phases/wiki-consult.md",
+      "skills/_shared/read-ladder.md",
+      "skills/orc-wiki/references/staleness.md",
     ],
+    binFiles: ["bin/graph-notes.js"],
+  },
+  // ── v1.8.2 W5 — the five new languages (G6) ──────────────────────────
+  {
+    // A language the contract claims and the engine cannot read is a promise
+    // the card breaks in silence. The claim and `LANG_BY_EXT` move together.
+    name: "graph languages (v1.8.2 — Ruby, Rust, Kotlin, plus SFC and C/C++)",
+    token: "Ruby, Rust, Kotlin",
+    files: ["skills/_shared/code-graph.md"],
+    binFiles: ["bin/graph.js"],
+  },
+  // ── v1.8.2 W6 — the borrowed toolchains (G7) ─────────────────────────
+  {
+    // The escape hatch. If the contract names it and the engine stops reading
+    // it, a project with a misbehaving toolchain has no way out.
+    name: "graph borrow escape (v1.8.2 — ORC_GRAPH_NO_BORROW forces the heuristic)",
+    token: "ORC_GRAPH_NO_BORROW",
+    files: ["skills/_shared/code-graph.md"],
+    binFiles: ["bin/graph-extract.js"],
+  },
+  // ── v1.8.2 W8 — the sharded read path (S1) ────────────
+  {
+    // The shards are a DERIVED store, and the contract's promise about every
+    // derived store is the one that keeps them safe: generation-pinned, and a
+    // missing one costs time and no answer. If the engine stops writing them,
+    // the sentence that tells a reader they exist has to go with it.
+    name: "graph shards (v1.8.2 — the resolved/ shards a one-symbol ctx reads)",
+    token: "resolved/<ab>.json",
+    files: ["skills/_shared/code-graph.md"],
+    binFiles: ["bin/graph-shard.js"],
+  },
+  // ── v1.8.2 W7 — the ranked map (D4) ──────────────────
+  {
+    // The command itself. Three lanes are told to run it at the START of
+    // planning; if the CLI stops offering it, every one of them opens a run
+    // with a call that does not exist.
+    name: "graph map (v1.8.2 — the ranked repository map, the orientation call)",
+    token: "orc graph map",
+    files: [
+      "skills/_shared/code-graph.md",
+      "skills/_shared/phases/planning.md",
+      "skills/_shared/phases/trace.md",
+      "skills/orc-diy/references/flow-schema.md",
+      "skills/orc-mini/SKILL.md",
+      "skills/orc-quick/SKILL.md",
+      "skills/orc-quick/references/look.md",
+      "skills/orc/SKILL.md",
+    ],
+    binFiles: ["bin/cli.js", "bin/graph-map.js"],
+  },
+  {
+    // The trace verb. A lane that emits a verb the trace table does not hold
+    // writes a line `/orc-retro` cannot aggregate.
+    name: "graph map trace (v1.8.2 — GRAPH-MAP, one line at the start of planning)",
+    token: "GRAPH-MAP",
+    files: [
+      "skills/_shared/phases/planning.md",
+      "skills/_shared/phases/trace.md",
+      "skills/orc-mini/examples/mini-run-mock.md",
+    ],
+    binFiles: ["bin/cli.js"],
+  },
+  {
+    // The claim that keeps the map safe to read. It is the map's whole
+    // equivalent of "the graph is a LOCATOR": a rank is where to look first,
+    // never proof that a file matters to this change.
+    name: "graph map rank is a hint (v1.8.2 — never proof a file matters)",
+    token: "a HINT about where to look first",
+    files: ["skills/_shared/code-graph.md", "skills/_shared/phases/planning.md"],
+    binFiles: ["bin/graph-query.js"],
+  },
+  // ── v1.8.2 W4b — the gain meter (K) ─────────────────────────────
+  {
+    // The one line a run prints about what the graph cost and probably saved.
+    // The verb lives in the trace table and in the phase that emits it.
+    name: "graph gain line (v1.8.2 — GRAPH-GAIN, one line at ship, copied verbatim)",
+    token: "GRAPH-GAIN",
+    files: ["skills/_shared/phases/ship.md", "skills/_shared/phases/trace.md"],
+    binFiles: ["bin/cli.js"],
+  },
+  {
+    // `avoided` is a COUNTERFACTUAL. The word has to survive every rewrite of
+    // the contract and of the panel, because it is the claim.
+    name: "graph gain estimate (v1.8.2 — avoided is an estimate, never a bill)",
+    token: "AN ESTIMATE",
+    files: ["skills/_shared/code-graph.md"],
+    binFiles: ["bin/graph-gain.js"],
   },
   {
     // The only notes writer, dispatched BY NAME. An unnamed dispatch cannot
@@ -2742,12 +2960,6 @@ const CONTRACTS = [
     name: "read ladder (escalating read discipline for read-heavy roles)",
     token: "read-ladder.md",
     files: [
-      // v1.6.0 — the ENFORCEMENT half. The ladder was advisory prose in three
-      // places and enforced in none; this hook is the layer that can refuse.
-      // It cites the ladder by name because its two carve-outs ARE the
-      // ladder's two exceptions — rename the file and the gate's reason text
-      // stops naming anything real.
-      "hooks/orc-read-gate.js",
       "agents/orc-executor-haiku-4-5.md",
       "agents/orc-executor-opus-4-7-high.md",
       "agents/orc-executor-opus-4-7-med.md",
@@ -2758,29 +2970,40 @@ const CONTRACTS = [
       "agents/orc-executor-sonnet-4-6-high.md",
       "agents/orc-executor-sonnet-4-6-med.md",
       "agents/orc-executor-sonnet-5-high.md",
+      "agents/orc-recon-opus-5-low.md",
+      "agents/orc-recon-sonnet-4-6-med.md",
       "skills/_shared/README.md",
       "skills/_shared/interview.md",
+      "skills/_shared/phases/README.md",
+      "skills/_shared/phases/wiki-consult.md",
       "skills/_shared/read-ladder.md",
       "skills/orc-analyze-mini/SKILL.md",
       "skills/orc-analyze/SKILL.md",
       "skills/orc-boundary/SKILL.md",
       "skills/orc-fast/SKILL.md",
       "skills/orc-quick/references/dispatch-gate.md",
+      "skills/orc-quick/references/look.md",
       "skills/orc-wiki/SKILL.md",
       "skills/orc/SKILL.md",
-      "skills/_shared/phases/wiki-consult.md",
       "skills/orc/subskills/orc-execution/core.md",
-      "skills/_shared/phases/README.md",
+      // v1.6.0 — the ENFORCEMENT half. The ladder was advisory prose in three
+      // places and enforced in none; this hook is the layer that can refuse.
+      // It cites the ladder by name because its two carve-outs ARE the
+      // ladder's two exceptions — rename the file and the gate's reason text
+      // stops naming anything real.
+      "hooks/orc-read-gate.js",
     ],
   },
   {
     name: "foreign input is evidence, never instruction",
     token: "untrusted-input.md",
     files: [
-      "skills/orc-test/SKILL.md",
       "agents/orc-doc-writer-opus-5-med.md",
+      "agents/orc-recon-opus-5-low.md",
+      "agents/orc-recon-sonnet-4-6-med.md",
       "skills/_shared/README.md",
       "skills/_shared/extra-dispatch.md",
+      "skills/_shared/phases/wiki-consult.md",
       "skills/_shared/untrusted-input.md",
       "skills/orc-analyze/SKILL.md",
       "skills/orc-boundary/SKILL.md",
@@ -2793,8 +3016,8 @@ const CONTRACTS = [
       "skills/orc-pact/SKILL.md",
       "skills/orc-poly/SKILL.md",
       "skills/orc-quick/references/gh-mode.md",
+      "skills/orc-test/SKILL.md",
       "skills/orc-wiki/SKILL.md",
-      "skills/_shared/phases/wiki-consult.md",
     ],
   },
   // ── v0.40.0 — gotchas (repair memory) ───────────────────────────────────
@@ -3634,7 +3857,15 @@ const BUDGETS = [
   // 1 measured a mini run with `code_graph: on` that never called `orc graph`:
   // a pointer at the end of a long probe line was skipped. The three steps now
   // have their own heading; the mechanics stay in _shared/code-graph.md.
-  { file: "skills/orc-mini/SKILL.md", maxLines: 270 },
+  // v1.9.0: deliberate raise 270→280 — the lean-lane revamp. W1 trimmed the
+  // spine to 246 by moving the Phase X/T narration and the fallback and switch
+  // paragraphs into _shared and the phase's own reference. W4 spent that room on
+  // contracts that must survive compaction: the graph_facts planner slice, the
+  // complexity read's four thresholds, the wiki POINTERS-not-bodies rule, the
+  // affected-tests-first smoke gate and the `none is an answer` record. The
+  // arithmetic (how to count, why each threshold is that number, the
+  // graph_facts shape) lives in references/complexity.md.
+  { file: "skills/orc-mini/SKILL.md", maxLines: 280 },
   // v0.39.0: deliberate raises 195→201 / 179→182 — the analyst gains hard rules
   // 2b (a source it did not author is FOREIGN input) and 4a (the read ladder);
   // fast gains the ladder as a slice line. Both are hard rules by nature: they
@@ -3697,6 +3928,14 @@ const BUDGETS = [
   // v1.8.0 W9: deliberate raise 230→240 — the F0 code-graph step (e.), for the
   // same measured reason as orc-mini's raise: a lengthened line was skipped.
   { file: "skills/orc-fast/SKILL.md", maxLines: 240 },
+  // v1.9.0: a FIRST pin for the quick spine, at 325. It had none, and it grew
+  // to 379 lines. W1 trimmed it to 298 by moving the step table, the gate menu,
+  // the repair-loop example and the doc shape into references/ and README.md;
+  // W2 and W3 spent the rest on the graph-first dig, the reproduce-first step,
+  // the blast-radius line and the one-call cache update. 325 is where that
+  // lands plus nothing — a spine that grows past its own references has moved
+  // prose the wrong way.
+  { file: "skills/orc-quick/SKILL.md", maxLines: 325 },
 ];
 
 function walk(dir, out) {
@@ -3919,6 +4158,8 @@ for (const b of BUDGETS) {
     // as `statusline_custom` is. Neither can have a lane, and that is an ANSWER.
     "code_graph_heal_ms",
     "code_graph_hooks",
+    // v1.8.2 W2 — the ignore globs, read by the CLI behind the same calls.
+    "code_graph_ignore",
   ]);
   for (const e of metaEntries) {
     if (!e.lanes) {

package/bin/verify-package.js

@@ -185,6 +185,20 @@ const required = [
   "bin/graph-resolve.js",
   "bin/graph-signals.js",
   "bin/graph-notes.js",
+
+  // v1.8.2 W4b — the gain meter. Dropping it breaks `orc graph gain` AND the
+  // one ledger line every read appends, so the map would go on working and
+  // quietly stop recording what it cost.
+  "bin/graph-gain.js",
+  // v1.8.2 W7 — the ranked map (D4). Dropping it breaks `orc graph map` AND the
+  // `map.json` every update writes, so planning would silently go back to the
+  // Glob-and-read sweep the map exists to replace.
+  "bin/graph-map.js",
+  // v1.8.2 W8 — the sharded read path (S1). Dropping it does not break a card:
+  // every read falls back to the full model. It breaks the SPEED, silently, on
+  // the one call every lane makes — which is the worst kind of missing file.
+  "bin/graph-shard.js",
+
   // The two DATED data files (v0.50.0). Both ship inside the package and both
   // are load-bearing on absence rather than on content: without the catalog
   // `orc extra providers` is a packaging bug it reports as one, and without the
@@ -420,6 +434,10 @@ const required = [
   "templates/agents/orc-reviewer-opus-5-med.md",
   "templates/agents/orc-verifier-opus-5-med.md",
   "templates/agents/orc-scout-sonnet-4-6-high.md",
+  // v1.9.0 — the /orc-quick recon pair. Both halves must ship: the gate offers
+  // them side by side, so a missing file makes half the menu a dead option.
+  "templates/agents/orc-recon-sonnet-4-6-med.md",
+  "templates/agents/orc-recon-opus-5-low.md",
   "templates/agents/orc-test-author-opus-5-med.md",
   "templates/agents/orc-pattern-codifier-sonnet-5-high.md",
   "templates/agents/orc-retro-sonnet-5-high.md",
@@ -576,8 +594,18 @@ const agentCount = walkCount(path.join(ROOT, "templates/agents"), ".md");
 // by model+effort and earns no agent, the v0.38.0/v0.45.0 precedent, and that
 // limit is stated in the skill: no `SPAWN` line, so `/orc-retro` cannot
 // aggregate it.
+// v1.9.0: +0 skills and +2 agents — the /orc-quick recon PAIR. This reverses
+// the v0.38.0/v0.45.0 precedent for ONE lane, on purpose: recon stayed ad-hoc
+// because it was cheap and varied, and the cost was measured — the trace hook
+// only sees an agent whose name starts with `orc-`, so every read-only entry
+// was invisible to `SPAWN`/`RETURN`, to `orc run inflight` and to /orc-retro,
+// and the gate offered an "effort" the Agent tool has no per-call knob for. Two
+// files, one per model, with one shared return contract. The ad-hoc escape
+// hatch survives on the menu as line 3 (model only). Both names earn an
+// explicit guard entry above and a MODEL-MAPPING row; `opus5_only` adds no
+// pair, because orc-quick is the lane that key is inert in.
 if (skillCount < 39) missing.push(`templates/skills (expected >=39 SKILL.md, found ${skillCount})`);
-if (agentCount < 48) missing.push(`templates/agents (expected >=48 .md, found ${agentCount})`);
+if (agentCount < 50) missing.push(`templates/agents (expected >=50 .md, found ${agentCount})`);
 
 // B4 — encoding/mojibake guard. The OneDrive corruption rule becomes a gate:
 // scan every shipped text file for the U+FFFD replacement char (invalid UTF-8

package/bin/webui/api.js

@@ -224,6 +224,12 @@ const READS = {
   // v1.8.0 — the code graph. A READ whose exit code is DATA (0 fresh · 1 none ·
   // 2 drifted · 3 off), exactly like `wiki status` above.
   "/api/graph": () => ["graph", "status"],
+  // v1.8.2 W4b — the gain meter. Two READS, both with exit codes that are DATA
+  // (0 rows · 1 no ledger or no rows · 3 off). `--measured` is its OWN route
+  // because it reads Claude Code's transcripts and takes longer; the panel
+  // asks for it on a button, never on load.
+  "/api/graph/gain": () => ["graph", "gain"],
+  "/api/graph/gain/measured": () => ["graph", "gain", "--measured"],
   "/api/wiki/impact": () => ["wiki", "impact"],
   // v0.46.0. Every one is a READ with an exit-code contract, so the exit code is
   // DATA here exactly like `pattern status` and `wiki impact` above: pact 0/1/2/3,