@azure-id/orc 1.2.1 → 1.4.1

package/bin/verify-contracts.js

@@ -837,6 +837,26 @@ 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",
@@ -1371,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"],
   },
   {
@@ -1474,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.
@@ -1966,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",
@@ -3642,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) {

package/bin/verify-package.js

@@ -47,6 +47,7 @@ const required = [
   "bin/webui/css/panels/pact.css",
   "bin/webui/css/panels/boundary.css",
   "bin/webui/css/panels/wait.css",
+  "bin/webui/css/panels/hookui.css",
   "bin/webui/css/panels/handoff.css",
   "bin/webui/css/panels/challenge.css",
   "bin/webui/css/panels/docs.css",
@@ -76,6 +77,7 @@ const required = [
   "bin/webui/js/panels/pact.js",
   "bin/webui/js/panels/boundary.js",
   "bin/webui/js/panels/wait.js",
+  "bin/webui/js/panels/hookui.js",
   "bin/webui/js/panels/handoff.js",
   "bin/webui/js/panels/challenge.js",
   "bin/webui/js/panels/docs.js",
@@ -95,6 +97,7 @@ const required = [
   "bin/webui/fixtures/pact.js",
   "bin/webui/fixtures/boundary.js",
   "bin/webui/fixtures/wait.js",
+  "bin/webui/fixtures/hookui.js",
   "bin/webui/fixtures/handoff.js",
   "bin/webui/fixtures/maintenance.js",
   "bin/webui/fixtures/challenge.js",
@@ -127,6 +130,7 @@ const required = [
   "bin/webui/i18n/en/pact.json",
   "bin/webui/i18n/en/boundary.json",
   "bin/webui/i18n/en/wait.json",
+  "bin/webui/i18n/en/hookui.json",
   "bin/webui/i18n/en/handoff.json",
   "bin/webui/i18n/en/challenge.json",
   "bin/webui/i18n/en/docs.json",
@@ -150,6 +154,7 @@ const required = [
   "bin/webui/i18n/id/pact.json",
   "bin/webui/i18n/id/boundary.json",
   "bin/webui/i18n/id/wait.json",
+  "bin/webui/i18n/id/hookui.json",
   "bin/webui/i18n/id/handoff.json",
   "bin/webui/i18n/id/challenge.json",
   "bin/webui/i18n/id/docs.json",
@@ -451,6 +456,16 @@ const required = [
   "templates/hooks/README.md",
   "templates/hooks/orc-effort-guard.js",
   "templates/hooks/orc-statusline.js",
+  // v1.3.0 — THE RENDER ENGINE, and it is required by BOTH halves: the hook
+  // requires it as a sibling out of .claude/hooks/, and bin/cli.js requires it
+  // out of templates/hooks/ for `orc statusline preview`. That is what makes
+  // the panel's preview and the bar's real output byte-identical BY
+  // CONSTRUCTION. A missing file here breaks the status line AND the panel.
+  "templates/hooks/orc-statusline-render.js",
+  // v1.4.0 — the SECOND board, and the per-agent token record that rides with
+  // it. Wired even with the board off, because the measurement is handed over
+  // either way.
+  "templates/hooks/orc-subagent-line.js",
   "templates/hooks/orc-trace.js",
 ];