@azure-id/orc 1.8.2 → 1.9.1

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,86 @@ 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.9.1 W3 — the brief answer, and the lines the CLI now computes ──
+  {
+    // Every `--json` read a lane makes carries it, and the CLI is the only
+    // thing that can answer it. A rename that reached one side and not the
+    // other would leave every lane asking for a flag nothing knows.
+    name: "graph brief answer (v1.9.1 — --brief on every --json read a lane makes)",
+    token: "--brief",
+    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",
+      "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/phases/planning.md",
+      "skills/_shared/phases/preflight.md",
+      // review.md names it to say where it is deliberately NOT used.
+      "skills/_shared/phases/review.md",
+      "skills/_shared/phases/ship.md",
+      // trace.md names the call each trace verb is copied from.
+      "skills/_shared/phases/trace.md",
+      "skills/_shared/read-ladder.md",
+      "skills/orc/SKILL.md",
+      "skills/orc-fast/SKILL.md",
       "skills/orc-mini/SKILL.md",
+      "skills/orc-mini/references/complexity.md",
+      "skills/orc-quick/SKILL.md",
+      "skills/orc-quick/references/gh-mode.md",
+      "skills/orc-quick/references/look.md",
     ],
+    binFiles: ["bin/cli.js"],
+  },
+  {
+    // The blast radius is the CLI's line now. A lane that assembled it by hand
+    // would drift from the CLI's grammar the first time either side moved.
+    name: "graph blast line (v1.9.1 — changes computes the blast radius, the lane prints it)",
+    token: "blast_line",
+    files: ["skills/orc-mini/SKILL.md", "skills/orc-quick/SKILL.md"],
+    binFiles: ["bin/graph-signals.js"],
+  },
+  {
+    // Mini's one call. The flag, the prose that explains it and the engine that
+    // answers it move together or not at all.
+    name: "graph complexity read (v1.9.1 — impact --complexity, one call, one line)",
+    token: "--complexity",
+    files: [
+      "skills/_shared/code-graph.md",
+      "skills/_shared/phases/trace.md",
+      "skills/orc-mini/SKILL.md",
+      "skills/orc-mini/references/complexity.md",
+    ],
+    binFiles: ["bin/cli.js"],
+  },
+  {
+    // The four thresholds live in ONE place. The prose quotes them by NAME, so
+    // a rename that reaches only the engine fails here.
+    name: "graph complexity thresholds (v1.9.1 — the constants the prose quotes)",
+    token: "COMPLEXITY_CALLER_FILES",
+    files: ["skills/orc-mini/references/complexity.md"],
+    binFiles: ["bin/graph-signals.js"],
   },
   // ── v1.8.2 W3 — the delivery flags (D1 · D2 · D3 · D5) ────────────────
   {
@@ -2729,7 +2817,15 @@ const CONTRACTS = [
     // 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"],
+    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"],
   },
   {
@@ -2737,7 +2833,88 @@ const CONTRACTS = [
     // 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: ["skills/_shared/code-graph.md", "skills/_shared/read-ladder.md"],
+    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.1 W5 — delivery where the paid reads are (R1 · R4) ─────────────
+  {
+    // The call sites WITH the card. The recon agents ask for it, the ladder
+    // and the contract say what it may never print, and the CLI answers it.
+    name: "graph callers source (v1.9.1 — ctx --callers-source, six lines per confident call site)",
+    token: "--callers-source",
+    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",
+    ],
+    binFiles: ["bin/cli.js", "bin/graph-query.js"],
+  },
+  {
+    // Where a language server is asked. Every reader that is told to use it
+    // names the field, and the engine is the only thing that computes it.
+    name: "graph LSP anchor (v1.9.1 — lsp_at on a symbol card: file, line, 1-based character)",
+    token: "lsp_at",
+    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",
+      "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",
+    ],
+    binFiles: ["bin/graph-query.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"],
   },
   {
@@ -2745,7 +2922,12 @@ const CONTRACTS = [
     // 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"],
+    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"],
   },
   {
@@ -2818,8 +3000,11 @@ const CONTRACTS = [
       "skills/_shared/code-graph.md",
       "skills/_shared/phases/planning.md",
       "skills/_shared/phases/trace.md",
-      "skills/orc/SKILL.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"],
   },
@@ -2829,8 +3014,9 @@ const CONTRACTS = [
     name: "graph map trace (v1.8.2 — GRAPH-MAP, one line at the start of planning)",
     token: "GRAPH-MAP",
     files: [
-      "skills/_shared/phases/trace.md",
       "skills/_shared/phases/planning.md",
+      "skills/_shared/phases/trace.md",
+      "skills/orc-mini/examples/mini-run-mock.md",
     ],
     binFiles: ["bin/cli.js"],
   },
@@ -2880,12 +3066,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",
@@ -2896,29 +3076,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",
@@ -2931,8 +3122,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) ───────────────────────────────────
@@ -3772,7 +3963,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
@@ -3835,6 +4034,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) {
@@ -4461,6 +4668,15 @@ for (const b of BUDGETS) {
   //    one. design-05 §6.3: a call one lane makes belongs to that lane.
   for (const [id, c] of Object.entries(CALLS)) {
     const want = [...(measured[prefixOf(c.cmd)] || new Set())].sort();
+    // v1.9.1: a row with `lanes: []` is a USER command — catalogued so
+    // `orc lane calls --all` documents it, and asserted the OTHER way round:
+    // no lane may name it. `orc graph audit` is the first one. The assertion is
+    // stronger than the >= 2 rule, not an exception to it.
+    if (Array.isArray(c.lanes) && c.lanes.length === 0) {
+      if (want.length)
+        errs.push(`${id}: a user command, and ${want.join(", ")} name it — remove the call, or give the row its lanes`);
+      continue;
+    }
     if (want.length < 2)
       errs.push(
         `${id}: only ${want.length} lane names it — a call one lane makes belongs to that lane and is not catalogued`

package/bin/verify-package.js

@@ -198,6 +198,10 @@ const required = [
   // 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",
+  // v1.9.1 W4 — the audit (A2). Dropping it breaks `orc graph audit`, which is
+  // the only answer that says WHY a THIN map is thin. Without it the status
+  // line still says THIN and names a command that is not there.
+  "bin/graph-audit.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
@@ -434,6 +438,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",
@@ -590,8 +598,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