@azure-id/orc 1.2.0 → 1.4.0

package/bin/verify-contracts.js

@@ -411,6 +411,7 @@ const CONTRACTS = [
     token: "orc run inflight",
     binFiles: ["bin/cli.js"],
     files: [
+      "hooks/README.md",
       "skills/_shared/return-validation.md",
       "skills/_shared/phases/execution.md",
       "skills/orc/SKILL.md",
@@ -836,12 +837,36 @@ const CONTRACTS = [
       "skills/_shared/phases/preflight.md",
     ],
   },
+  {
+    // v1.3.0 W1 — the CLI Hook Interface. The compiled program is the ONE thing
+    // that crosses the wall between the CLI and the hook, so both halves have
+    // to name the same file. The AUTHORED layout is deliberately NOT registered
+    // here: the hook must never name it, because it must never read it.
+    name: "the compiled status-line program (the CLI compiles, the hook renders)",
+    token: "statusline-compiled.json",
+    binFiles: ["bin/cli.js"],
+    files: ["hooks/orc-statusline.js", "hooks/orc-statusline-render.js", "hooks/README.md"],
+  },
+  {
+    // The board rule, stated ONCE so the CLI, the hook and the panel all cite
+    // the same sentence. It is the thing a user most needs to understand about
+    // the board and the thing most likely to be paraphrased into three
+    // different half-truths.
+    name: "the dense-prefix invariant (the status-line board)",
+    token: "A line may hold a component only if every line above it holds at least one.",
+    binFiles: ["bin/cli.js"],
+    files: ["hooks/README.md", "hooks/orc-statusline.js"],
+  },
   {
     name: "behavior-trace run pointer (every ORC entry point writes .current)",
     token: ".current",
     files: [
       "agents/orc-trace-writer-haiku-4-5.md",
       "hooks/orc-trace.js",
+      // v1.2.1: the statusline READS the pointer to decide which run `status:`
+      // is about. "The newest file" would be a different, wrong answer during
+      // a lane suspend, when two traces are live and only one is the run.
+      "hooks/orc-statusline.js",
       "skills/_shared/lane-suspend.md",
       "skills/context-combiner/SKILL.md",
       "skills/orc-aftermath/SKILL.md",
@@ -905,6 +930,18 @@ const CONTRACTS = [
       "skills/_shared/phases/trace.md",
     ],
   },
+  {
+    // v1.2.1 — the statusline's phase rail. The CLI COMPUTES the phase list
+    // (labels, order, motif kind) and stamps it at install; the hook RENDERS it
+    // and derives nothing, the same way `orc ui` renders the Flow stepper. The
+    // two halves live in two files, so a rename of the manifest silently blanks
+    // `status:` unless it fails here.
+    name: "statusline phase rail (v1.2.1 — orc-lane-rails.json)",
+    token: "orc-lane-rails.json",
+    binFiles: ["bin/cli.js"],
+    files: [
+      "hooks/README.md","hooks/orc-statusline.js"],
+  },
   {
     // v0.32.0: the hook's zero-model-dependence phase segmentation. Producer
     // (the hook) and both consumers (retro skill + its miner) must agree on the
@@ -922,6 +959,11 @@ const CONTRACTS = [
       // v0.42.0: the combiner is segmented as its own PHASE-EDGE family INSIDE the
       // analyze trace — the reason it needs no lane of its own.
       "skills/context-combiner/SKILL.md",
+      // v1.2.1: the statusline READS these edges to render `status:`. It is the
+      // deterministic floor under that segment — the model-narrated verb can
+      // only refine it — so a rename of this verb would silently blank the one
+      // segment on line 2 that changes minute to minute.
+      "hooks/orc-statusline.js",
     ],
   },
   {
@@ -946,6 +988,7 @@ const CONTRACTS = [
     token: "orc wiki sync",
     binFiles: ["bin/cli.js"],
     files: [
+      "hooks/README.md",
       "agents/orc-wiki-scanner-opus-4-8-high.md",
       "agents/orc-wiki-scanner-opus-5-med.md",
       "agents/orc-wiki-scanner-sonnet-5-high.md",
@@ -985,6 +1028,7 @@ const CONTRACTS = [
     name: "wiki UNREGISTERED state (v0.18.0 — docs without a manifest ≠ no wiki; sync, never re-scan)",
     token: "UNREGISTERED",
     files: [
+      "hooks/README.md",
       "hooks/orc-statusline.js",
       "skills/orc-wiki/README.md",
       "skills/orc-wiki/references/phases/phase-0.md",
@@ -1347,7 +1391,11 @@ const CONTRACTS = [
     // wiki-meta.json lives under.
     name: "the challenge ledger (v0.47.0 — CLI-only writer)",
     token: "challenge.json",
-    files: ["skills/orc-challenge/references/cycle-state.md"],
+    files: [
+      "skills/orc-challenge/references/cycle-state.md",
+      // the `challenge` component reads it (v1.3.0)
+      "hooks/orc-statusline.js",
+    ],
     binFiles: ["bin/cli.js"],
   },
   {
@@ -1450,6 +1498,8 @@ const CONTRACTS = [
     token: "RESUME.md",
     binFiles: ["bin/cli.js"],
     files: [
+      // the `resume` / `open-runs` components read its one byte-stable line (v1.3.0)
+      "hooks/orc-statusline.js",
       // v1.0.0 W5 — the demotion's run-scoped record lives BESIDE it, in
       // {run_dir}/{slug}/, and is deleted with the run. A move of one is a move
       // of the other.
@@ -1489,6 +1539,7 @@ const CONTRACTS = [
     name: "wiki freshness tier enum (v0.11.0 — FRESH/AGING/STALE, computed on read)",
     token: "AGING",
     files: [
+      "hooks/README.md",
       "hooks/orc-statusline.js",
       "skills/_shared/gotchas.md",
       "skills/_shared/interview.md",
@@ -1941,6 +1992,8 @@ const CONTRACTS = [
     token: "orc-crosslink.config.yaml",
     binFiles: ["bin/cli.js"],
     files: [
+      // the `crosslink` component counts its peers (v1.3.0)
+      "hooks/orc-statusline.js",
       "skills/orc-poly/SKILL.md",
       "skills/orc-wiki/README.md",
       "skills/orc-wiki/SKILL.md",
@@ -3617,6 +3670,12 @@ for (const b of BUDGETS) {
     // spine reads `extra_timeout_s`. An empty lanes[] here is an ANSWER.
     "wait_hop_minutes",
     "wait_max_hops",
+    // v1.3.0 — an operating key of the STATUSLINE HOOK. A hook has no lane and
+    // cannot resolve config, so no spine reads this; the hook reads the raw key
+    // off the file, exactly as it already does for `log_dir` and
+    // `extra_enabled`. An empty lanes[] here is an ANSWER.
+    "statusline_custom",
+    "subagent_line_custom",
   ]);
   for (const e of metaEntries) {
     if (!e.lanes) {