@azure-id/orc 1.2.0 → 1.4.0

package/bin/webui/fixtures/hookui.js

@@ -0,0 +1,409 @@
+"use strict";
+/**
+ * fixtures/hookui.js — canned `orc statusline …` responses.
+ *
+ * ONE OF EVERY STATE, INCLUDING THE UGLY ONES. You cannot design a caution
+ * strip on a layout that validates, a `5/5` chip on a line with two things on
+ * it, or a refused palette row on a project where nothing is refused.
+ *
+ * So this set carries: the feature OFF with a saved layout, a line at 5/5, a
+ * line 3 blocked by the dense-prefix rule, one hard error and two warnings, a
+ * refused component, a component rendering an em dash, and a preview in all
+ * three degraded forms.
+ *
+ * The ANSI here is REAL — the panel's job is to turn escape sequences into DOM,
+ * and a fixture of plain text would exercise none of that.
+ */
+
+const E = String.fromCharCode(27);
+const R = E + "[0m";
+const dim = (s) => E + "[90m" + s + R;
+const green = (s) => E + "[32m" + s + R;
+const amber = (s) => E + "[33m" + s + R;
+const red = (s) => E + "[31m" + s + R;
+
+// The rendered bar, in its four forms. Line 3 is deliberately the shortest —
+// the board's third line usually is.
+const previewText =
+  amber("🚀") + " " + dim("ORC ") + "1.3.0 · Opus 5/high · " + dim("context ") + green("38%") + " · " + amber("██████░░░░") + "\n" +
+  "   ▰ " + dim("status ") + "quick · Q3 DO · " + dim("agents ") + " 7 · " + dim("Dur ") + " 48m · main\n" +
+  "   " + dim("cache ") + "●" + " " + green("███████▊░░") + " · " + dim("MTok ") + "412K · " + red("—");
+
+const previewNoColor =
+  "🚀 ORC 1.3.0 · Opus 5/high · context 38% · ██████░░░░\n" +
+  "   ▰ status quick · Q3 DO · agents  7 · Dur  48m · main\n" +
+  "   cache ● ███████▊░░ · MTok 412K · —";
+
+const previewAscii =
+  "++ ORC 1.3.0 - Opus 5/high - context 38% - ######....\n" +
+  "   = status quick - Q3 DO - agents  7 - Dur  48m - main\n" +
+  "   cache o #######|.. - MTok 412K - -";
+
+const preview = {
+  ok: true,
+  width: 120,
+  state: "healthy",
+  fixture: "a healthy session mid-run",
+  fixtures: {
+    healthy: "a healthy session mid-run",
+    degraded: "the wrong tier, a full window, and nothing running",
+    empty: "a payload with nothing in it — every component on its unknown form",
+  },
+  text: previewText,
+  strippings: { no_color: previewNoColor, ascii: previewAscii, no_motion: previewNoColor },
+  static_width: [58, 62, 44],
+  errors: [],
+};
+
+// A rendered sample per renderer, which is what makes the shape gallery a
+// gallery rather than a dropdown of words.
+const P = (id) => ({
+  bare: "38%",
+  plain: dim(id + " ") + "38%",
+  "label-value": dim(id.toUpperCase() + ": ") + "38%",
+  bracket: "[" + dim(id.toUpperCase() + " ") + "38%]",
+  paren: "(38%)",
+  badge: "▏" + dim(id.toUpperCase() + " ") + "38%▕",
+  pill: E + "[7m" + id.slice(0, 3).toUpperCase() + R + "38%",
+  bar: "38% " + amber("███░░░░░░░"),
+  blocks: amber("███░░░░░░░"),
+  fine: amber("███▊      "),
+  dots: "●●●○○",
+  gauge: "◔",
+  ring: "◔",
+  shape: green("●"),
+  word: green("ok"),
+  icon: "✅",
+  spark: "▁▂▃▅▆▇",
+  trend: "▲",
+});
+
+const components = {
+  ok: true,
+  schema: 1,
+  catalog_hash: "b7c1d2e3f4a5968708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f",
+  count: 6,
+  groups: { A: "Session and tier", B: "Quota and spend", D: "Knowledge", H: "Project and VCS" },
+  components: [
+    {
+      id: "verdict", group: "A", label: null,
+      summary: "The ORC-ready verdict icon.",
+      renderers: ["icon", "shape", "word", "badge"],
+      defaults: { render: "icon" },
+      states: ["ready", "boosted", "degrade"],
+      shapes: { ready: "✅", boosted: "🚀", degrade: "⛔" },
+      bounded: false, series: null, unknown: "dash", cost: "free",
+      refused_reason: null, params: null, binding: "verdict.state",
+      composite: null, time_based: false,
+      previews: { icon: "🚀", shape: "🚀", word: green("boosted"), badge: "▏🚀▕" },
+    },
+    {
+      id: "context", group: "A", label: "context",
+      summary: "How full the context window is.",
+      renderers: ["plain", "label-value", "bar", "blocks", "fine", "dots", "gauge", "ring", "bare"],
+      defaults: { render: "plain", format: "percent", min_width: 3, align: "right", ramp: "heat" },
+      states: ["ok", "warn", "full"],
+      shapes: { ok: "●", warn: "◐", full: "○" },
+      bounded: true, series: null, unknown: "dash", cost: "free",
+      refused_reason: null, params: null, binding: "ctx.used_pct",
+      composite: null, time_based: false,
+      previews: P("context"),
+    },
+    {
+      id: "quota-5h", group: "B", label: "5h",
+      summary: "The 5-hour usage window.",
+      renderers: ["plain", "bar", "blocks", "spark", "bare"],
+      defaults: { render: "plain", format: "percent", min_width: 3, align: "right", ramp: "heat" },
+      states: ["ok", "warn", "critical"],
+      shapes: { ok: "●", warn: "◐", critical: "○" },
+      bounded: true, series: "quota5h", unknown: "dash", cost: "free",
+      refused_reason: null, params: null, binding: "quota.5h.pct",
+      composite: null, time_based: false,
+      previews: P("5h"),
+    },
+    // A COMPONENT RENDERING AN EM DASH. Its file does not exist in this
+    // project, so it says so — and it is still placeable, because `—` and "this
+    // build has no such segment" are different facts.
+    {
+      id: "wiki", group: "D", label: "wiki",
+      summary: "How old the project wiki is, from the wiki's own oldest anchor.",
+      renderers: ["word", "shape", "badge"],
+      defaults: { render: "word" },
+      states: ["fresh", "aging", "stale", "unregistered", "none"],
+      shapes: { fresh: "●", aging: "◐", stale: "○", unregistered: "?", none: "·" },
+      bounded: false, series: null, unknown: "dash", cost: "new-read",
+      refused_reason: null, params: null, binding: "wiki.tier",
+      composite: null, time_based: false,
+      previews: { word: "—", shape: "—", badge: "▏—▕" },
+    },
+    {
+      id: "branch", group: "H", label: null,
+      summary: "The current git branch, read from .git/HEAD with NO subprocess.",
+      renderers: ["bare", "plain", "badge"],
+      defaults: { render: "bare", truncate: "middle", max_len: 24 },
+      states: null, shapes: null, bounded: false, series: null,
+      unknown: "hide", cost: "scan", refused_reason: null, params: null,
+      binding: "git.branch", composite: null, time_based: false,
+      previews: { bare: "main", plain: dim("branch ") + "main", badge: "▏main▕" },
+    },
+    // A REFUSED ROW. It keeps its slot, carries the measurement, and gets NO
+    // BUTTON AT ALL — never a disabled one. "We decided against this" and "we
+    // forgot" must not look the same.
+    {
+      id: "git-dirty", group: "H", label: "±",
+      summary: "Uncommitted changes.",
+      renderers: ["plain", "label-value", "bare"],
+      defaults: { render: "plain" },
+      states: null, shapes: null, bounded: false, series: null,
+      unknown: "dash", cost: "refused",
+      refused_reason:
+        "it needs a `git status` subprocess, and W0 measured one at 53ms against roughly 15ms of headroom on a surface that re-renders on every keystroke.",
+      params: null, binding: null, composite: null, time_based: false,
+      previews: {},
+    },
+  ],
+  renderers: {
+    bare: { kind: "text", form: "value", needs: null, width: null, decoration: false },
+    plain: { kind: "text", form: "label value", needs: null, width: null, decoration: false },
+    "label-value": { kind: "text", form: "LABEL: value", needs: null, width: null, decoration: false },
+    bracket: { kind: "text", form: "[LABEL: value]", needs: null, width: null, decoration: false },
+    paren: { kind: "text", form: "(value)", needs: null, width: null, decoration: false },
+    badge: { kind: "text", form: "▏LABEL value▕", needs: null, width: null, decoration: false },
+    pill: { kind: "text", form: "⟪LABEL⟫value", needs: null, width: null, decoration: false },
+    word: { kind: "text", form: "STATE", needs: "states", width: null, decoration: false },
+    bar: { kind: "bar", form: null, needs: "bounded", width: [4, 16], decoration: false },
+    blocks: { kind: "bar", form: null, needs: "bounded", width: [2, 16], decoration: false },
+    fine: { kind: "bar", form: null, needs: "bounded", width: [2, 16], decoration: false },
+    dots: { kind: "bar", form: null, needs: "ordinal", width: [2, 10], decoration: false },
+    gauge: { kind: "bar", form: null, needs: "bounded", width: [1, 1], decoration: false },
+    ring: { kind: "bar", form: null, needs: "bounded", width: [1, 1], decoration: false },
+    shape: { kind: "state", form: null, needs: "states", width: null, decoration: false },
+    icon: { kind: "state", form: null, needs: "states", width: null, decoration: false },
+    spark: { kind: "series", form: null, needs: "series", width: [4, 16], decoration: false },
+    trend: { kind: "series", form: null, needs: "series", width: null, decoration: false },
+  },
+  glyph_sets: ["blocks", "bars", "pipes", "braille", "shade", "minimal", "ascii"],
+  ramps: {
+    heat: { stops: [0, 60, 85], colors: ["green", "yellow", "red"], why: "high is bad" },
+    cool: { stops: [0, 60, 85], colors: ["red", "yellow", "green"], why: "high is good" },
+    mono: { stops: [0, 60, 85], colors: [null, null, null], why: "NO_COLOR-safe: emphasis, not hue" },
+    state: { stops: null, colors: null, why: "the component's own state colours" },
+  },
+  themes: {
+    terminal: { ok: "green", warn: "yellow", critical: "red", muted: "bright-black", accent: "cyan", label: "bright-black", value: "default" },
+    dim: { ok: "green", warn: "yellow", critical: "red", muted: "bright-black", accent: "bright-black", label: "bright-black", value: "bright-black" },
+    "high-contrast": { ok: "bright-green", warn: "bright-yellow", critical: "bright-red", muted: "white", accent: "bright-cyan", label: "bright-white", value: "bright-white" },
+    mono: { ok: null, warn: null, critical: null, muted: null, accent: null, label: null, value: null },
+  },
+  hide_when: [
+    { id: "never", says: "always render. A state keeps its slot." },
+    { id: "empty", says: "hide when the value is absent" },
+    { id: "zero", says: "hide when the value is exactly 0" },
+    { id: "unknown", says: "hide when the value could not be computed" },
+    { id: "ok", says: "hide while healthy — show me only problems" },
+    { id: "idle", says: "hide when no run is active" },
+    { id: "no-run", says: "hide when no ORC run was opened this session" },
+    { id: "narrow", says: "hide below this component's min_cols" },
+    { id: "wide", says: "hide above this component's max_cols" },
+  ],
+  formats: ["percent", "ratio", "fraction", "decimal", "plain"],
+  compact: ["off", "si", "bytes"],
+  cases: ["none", "upper", "lower", "title"],
+  truncate: ["end", "middle", "none"],
+  emphasis: ["normal", "bold", "dim", "italic", "underline", "reverse", "strike"],
+  refused_emphasis: ["blink"],
+  colors: ["red", "green", "yellow", "blue", "magenta", "cyan", "bright-black", "bright-cyan", "default"],
+  max_per_line: 5,
+  lines: 3,
+  dense_prefix: "A line may hold a component only if every line above it holds at least one.",
+};
+
+// THE FEATURE IS OFF WITH A LAYOUT SAVED — the state a user is in for most of
+// the time they are composing, and the one the gate card exists for. Line 1 is
+// at 5/5; line 3 is empty, so the board can show a full line and an ordinary
+// one at once.
+const show = {
+  ok: false,
+  enabled: false,
+  saved: true,
+  preset: null,
+  theme: "terminal",
+  glyphs: "blocks",
+  ansi: "auto",
+  align_columns: false,
+  lines: [
+    {
+      line: 1, separator: " · ", theme: null, max_width: 0, count: 5, counted: 5, full: true,
+      items: [
+        { pos: 1, id: "i1", type: "verdict", render: "icon", label: null, label_color: "bright-black", value_color: "default", ramp: null, emphasis: [], hide_when: [], unknown: "dash", known: true },
+        { pos: 2, id: "i2", type: "context", render: "bar", label: "CTX", label_color: "bright-black", value_color: null, ramp: "heat", emphasis: ["bold"], hide_when: [], unknown: "dash", known: true },
+        { pos: 3, id: "i3", type: "quota-5h", render: "plain", label: "5h", label_color: "bright-black", value_color: "default", ramp: "heat", emphasis: [], hide_when: [], unknown: "dash", known: true },
+        { pos: 4, id: "i4", type: "branch", render: "bare", label: null, label_color: "bright-black", value_color: "default", ramp: null, emphasis: [], hide_when: [], unknown: "hide", known: true },
+        { pos: 5, id: "i5", type: "wiki", render: "word", label: "wiki", label_color: "bright-black", value_color: "default", ramp: null, emphasis: [], hide_when: [], unknown: "dash", known: true },
+      ],
+    },
+    {
+      line: 2, separator: " · ", theme: null, max_width: 0, count: 2, counted: 2, full: false,
+      items: [
+        { pos: 1, id: "i6", type: "context", render: "fine", label: null, label_color: "bright-black", value_color: "default", ramp: null, emphasis: [], hide_when: ["ok"], unknown: "dash", known: true },
+        // AN UNKNOWN COMPONENT ID — what an upgrade that retired a component
+        // leaves behind. Reported, never auto-repaired.
+        { pos: 2, id: "i7", type: "retired-thing", render: "bare", label: null, label_color: null, value_color: null, ramp: null, emphasis: [], hide_when: [], unknown: null, known: false },
+      ],
+    },
+    { line: 3, separator: " · ", theme: null, max_width: 0, count: 0, counted: 0, full: false, items: [] },
+  ],
+  // ONE HARD ERROR and TWO WARNINGS, so the caution strip can show that an error
+  // is a refusal and a warning is a fact the user then owns.
+  errors: ['unknown component "retired-thing" on line 2 position 2 — did you mean "resume"?'],
+  warnings: [
+    "line 1 shows the same value twice (context, context)",
+    '"verdict" carries meaning in its colour (ready/boosted/degrade) and you set a flat colour — a green ⛔ is a status line that lies',
+  ],
+  preview: previewText,
+  dense_prefix: components.dense_prefix,
+};
+
+const presets = {
+  ok: true,
+  presets: [
+    { name: "orc-default", summary: "Today's two lines, exactly. The byte-identical baseline.", active: false, preview: previewNoColor.split("\n").slice(0, 2).join("\n") },
+    { name: "minimal", summary: "One line, four slots, the dim theme. The support answer for a busy terminal.", active: false, preview: dim("🚀 ORC 1.3.0 · Opus 5/high · ") + amber("███▊      ") + dim(" · main") },
+    { name: "cost-watch", summary: "What this session is spending, in every unit the payload gives for free.", active: true, preview: previewText.split("\n").slice(0, 2).join("\n") },
+    { name: "mono", summary: "No colour anywhere — shapes and emphasis only. The right preset for a README screenshot.", active: false, preview: previewNoColor },
+  ],
+};
+
+const explain = {
+  ok: true,
+  id: "i2",
+  type: "context",
+  line: 1,
+  pos: 2,
+  resolved: [
+    { field: "render", value: "bar", source: "item" },
+    { field: "label", value: "CTX", source: "item" },
+    { field: "label_color", value: "bright-black", source: "theme:terminal" },
+    { field: "glyphs", value: "blocks", source: "file" },
+    { field: "min_width", value: 3, source: "catalogue" },
+    { field: "ramp", value: "heat", source: "catalogue" },
+  ],
+  order: ["catalogue", "theme", "file", "line", "item"],
+};
+
+
+// ── the SECOND board (v1.4.0) ──────────────────────────────────────────────
+// A designer cannot lay out a per-agent row against the status line's
+// components, so the fixture set carries both boards. Same rule as everywhere
+// else here: one of every state, including the ugly ones — a failed agent, an
+// agent whose window size is unknown, and one whose token count has not been
+// seen yet.
+const subComponents = {
+  ok: true,
+  schema: 1,
+  catalog_hash: components.catalog_hash,
+  count: 4,
+  board: "subagent",
+  boards: ["status", "subagent"],
+  config_key: "subagent_line_custom",
+  setting: "subagentStatusLine",
+  groups: { T: "One subagent (the agent-panel row)" },
+  components: [
+    {
+      id: "task-name", group: "T", board: "subagent", label: null,
+      summary: "The agent's name.",
+      renderers: ["bare", "plain", "badge", "pill"],
+      defaults: { render: "bare", truncate: "middle", max_len: 28 },
+      states: null, shapes: null, bounded: false, series: null,
+      unknown: "dash", cost: "free", refused_reason: null, params: null,
+      binding: "task.name", composite: null, time_based: false,
+      previews: { bare: "orc-executor-opus-5-low", plain: dim("task-name ") + "orc-executor-opus-5-low", badge: "▏orc-executor-opus-5-low▕", pill: E + "[7mTASK" + R + "orc-executor-opus-5-low" },
+    },
+    {
+      id: "task-tier", group: "T", board: "subagent", label: null,
+      summary: "The model and effort this agent is ACTUALLY running at — observed, not derived from its name and not self-reported.",
+      renderers: ["bare", "plain", "label-value", "badge"],
+      defaults: { render: "bare" },
+      states: null, shapes: null, bounded: false, series: null,
+      unknown: "dash", cost: "free", refused_reason: null, params: null,
+      binding: "task.tier", composite: null, time_based: false,
+      previews: { bare: "O5/low", plain: dim("tier ") + "O5/low", "label-value": dim("TIER: ") + "O5/low", badge: "▏O5/low▕" },
+    },
+    {
+      id: "task-tokens", group: "T", board: "subagent", label: null,
+      summary: "How many tokens this agent has used. THE NUMBER v1.2.0 SAID COULD NOT BE MEASURED.",
+      renderers: ["plain", "label-value", "bare"],
+      defaults: { render: "plain", compact: "si" },
+      states: null, shapes: null, bounded: false, series: null,
+      unknown: "dash", cost: "free", refused_reason: null, params: null,
+      binding: "task.tokens", composite: null, time_based: false,
+      previews: { plain: "84K", "label-value": dim("TOKENS: ") + "84K", bare: "84K" },
+    },
+    {
+      id: "task-status", group: "T", board: "subagent", label: null,
+      summary: "What this agent is doing.",
+      renderers: ["word", "shape", "badge", "bare"],
+      defaults: { render: "word" },
+      states: ["pending", "running", "completed", "failed"],
+      shapes: { pending: "○", running: "●", completed: "✓", failed: "▲" },
+      bounded: false, series: null, unknown: "dash", cost: "free",
+      refused_reason: null, params: null, binding: "task.status",
+      composite: null, time_based: false,
+      previews: { word: amber("running"), shape: amber("●"), badge: "▏" + amber("running") + "▕", bare: "running" },
+    },
+  ],
+  renderers: components.renderers,
+  glyph_sets: components.glyph_sets,
+  ramps: components.ramps,
+  themes: components.themes,
+  hide_when: components.hide_when,
+  formats: components.formats,
+  compact: components.compact,
+  cases: components.cases,
+  truncate: components.truncate,
+  emphasis: components.emphasis,
+  refused_emphasis: components.refused_emphasis,
+  colors: components.colors,
+  max_per_line: 5,
+  // ONE LINE by construction: Claude Code renders one row per task.
+  lines: 1,
+  dense_prefix: components.dense_prefix,
+};
+
+const subShow = {
+  ok: true,
+  enabled: true,
+  saved: true,
+  preset: "agent-default",
+  theme: "terminal",
+  glyphs: "blocks",
+  ansi: "auto",
+  align_columns: false,
+  lines: [
+    {
+      line: 1, separator: " · ", theme: null, max_width: 0, count: 4, counted: 4, full: false,
+      items: [
+        { pos: 1, id: "s1", type: "task-status", render: "shape", label: null, label_color: "bright-black", value_color: "default", ramp: null, emphasis: [], hide_when: [], unknown: "dash", known: true },
+        { pos: 2, id: "s2", type: "task-name", render: "bare", label: null, label_color: "bright-black", value_color: "default", ramp: null, emphasis: [], hide_when: [], unknown: "dash", known: true },
+        { pos: 3, id: "s3", type: "task-tier", render: "bare", label: null, label_color: "bright-black", value_color: "default", ramp: null, emphasis: ["dim"], hide_when: [], unknown: "dash", known: true },
+        { pos: 4, id: "s4", type: "task-tokens", render: "plain", label: null, label_color: "bright-black", value_color: "default", ramp: null, emphasis: [], hide_when: [], unknown: "dash", known: true },
+      ],
+    },
+  ],
+  errors: [],
+  // A layout can be perfectly valid and still worth a caution.
+  warnings: ["task-tokens is a FLOOR: an agent that finishes between two redraws is never counted"],
+  preview: amber("●") + " orc-executor-opus-5-low · " + dim("O5/low") + " · 84K",
+  dense_prefix: components.dense_prefix,
+};
+
+const subPresets = {
+  ok: true,
+  presets: [
+    { name: "agent-default", board: "subagent", summary: "What the agent is, what it is running at, and what it has cost so far.", active: true, preview: "orc-executor-opus-5-low · " + dim("O5/low") + " · 84K · " + dim("for ") + " 17m" },
+    { name: "agent-watch", board: "subagent", summary: "For a run you are watching: status, its own context window, and the clock.", active: false, preview: amber("●") + " orc-executor-opus-5-low · " + green("███▎░░░░") + " · " + dim("for ") + " 17m" },
+    { name: "agent-tier", board: "subagent", summary: "The downgrade check, made visible: the model and effort ORC actually got, per agent.", active: false, preview: "orc-executor-opus-5-low · claude-opus-5 · low · " + amber("running") },
+  ],
+};
+
+module.exports = { show, components, presets, preview, explain, subShow, subComponents, subPresets };

package/bin/webui/fixtures/index.js

@@ -27,6 +27,7 @@ const { stats, budgetForecast, budgetRates } = require("./stats.js");
 const { pact } = require("./pact.js");
 const { boundary } = require("./boundary.js");
 const { usage, waitLanes, waitStatus } = require("./wait.js");
+const hookui = require("./hookui.js");
 const { handoff } = require("./handoff.js");
 const { exportState, mocks } = require("./maintenance.js");
 const { chGoals, chDims, challengeRoles, challengeCouncil, challengeCycles, challengeList, challengeShow, challengeDiff, challengeDiffMissing, challengeLint } = require("./challenge.js");
@@ -202,6 +203,22 @@ module.exports.get = function get(route, q) {
       return pact;
     case "/api/usage":
       return usage;
+    // v1.3.0 — the CLI Hook Interface. ONE OF EVERY STATE, including the ugly
+    // ones: the feature off with a layout saved, a line at 5/5, a line 3 the
+    // dense-prefix rule blocks, one hard error and two warnings, a refused
+    // palette row, and a component rendering an em dash.
+    // v1.4.0 — TWO BOARDS. The fixture set carries both, because a designer
+    // cannot lay out a per-agent row against the status line's components.
+    case "/api/statusline/show":
+      return q && q.board === "subagent" ? hookui.subShow : hookui.show;
+    case "/api/statusline/components":
+      return q && q.board === "subagent" ? hookui.subComponents : hookui.components;
+    case "/api/statusline/presets":
+      return q && q.board === "subagent" ? hookui.subPresets : hookui.presets;
+    case "/api/statusline/preview":
+      return hookui.preview;
+    case "/api/statusline/explain":
+      return hookui.explain;
     case "/api/wait/lanes":
       return waitLanes;
     case "/api/wait/status":

package/bin/webui/i18n/en/hookui.json

@@ -0,0 +1,119 @@
+{
+  "hookui.title": "CLI Hook Interface",
+  "hookui.sub": "Build the ORC status line. Three lines. Each line holds 1 to 5 parts.",
+  "hookui.noData": "The status line cannot be read.",
+  "hookui.gate": "Status",
+  "hookui.on": "on",
+  "hookui.off": "off",
+  "hookui.saved": "layout saved",
+  "hookui.gateOnNote": "Your lines are showing. ORC's built-in two lines are disabled.",
+  "hookui.gateOffNote": "ORC shows its built-in two lines. Build a layout below, then enable this. Nothing here changes the bar until you do.",
+  "hookui.turnOn": "Enable",
+  "hookui.turnOff": "Disable",
+  "hookui.switchFailed": "The switch could not be changed.",
+  "hookui.cautions": "Cautions",
+  "hookui.preview": "Preview",
+  "hookui.previewUnavailable": "The preview cannot be drawn until the layout is valid.",
+  "hookui.degrades": "The same layout, in the three forms a terminal can force.",
+  "hookui.degNoColor": "no colour",
+  "hookui.degAscii": "plain text",
+  "hookui.degNoMotion": "no motion",
+  "hookui.cells": "{n} cell wide",
+  "hookui.cellsPlural": "{n} cells wide",
+  "hookui.board": "The board",
+  "hookui.lineN": "Line {n}",
+  "hookui.lineNPlural": "Line {n}",
+  "hookui.add": "+ add a part",
+  "hookui.addTo": "+ line {n}",
+  "hookui.addToPlural": "+ line {n}",
+  "hookui.toLine": "line {n}",
+  "hookui.toLinePlural": "line {n}",
+  "hookui.fillFirst": "Put something on line {n} first.",
+  "hookui.lineFull": "Line {n} is full.",
+  "hookui.separator": "Between parts",
+  "hookui.sepChange": "line {n} separator = \"{s}\"",
+  "hookui.moveLeft": "Move left",
+  "hookui.moveRight": "Move right",
+  "hookui.edit": "Change this part",
+  "hookui.remove": "Take this part off",
+  "hookui.removed": "{id} removed",
+  "hookui.moved": "{id} moved to line {n}",
+  "hookui.added": "{id} added to line {n}",
+  "hookui.unknownComponent": "This ORC version does not have this part.",
+  "hookui.shape": "Shape",
+  "hookui.shapeChange": "{id} shape = {r}",
+  "hookui.glyphs": "Symbols",
+  "hookui.glyphChange": "{id} symbols = {v}",
+  "hookui.words": "Words",
+  "hookui.label": "Name",
+  "hookui.labelPlaceholder": "type any name",
+  "hookui.labelChange": "{id} name = \"{v}\"",
+  "hookui.case": "Letters",
+  "hookui.caseChange": "{id} letters = {v}",
+  "hookui.colour": "Colour",
+  "hookui.labelColour": "Name colour",
+  "hookui.valueColour": "Value colour",
+  "hookui.colourChange": "{id} colour = {v}",
+  "hookui.ramp": "Colour by value",
+  "hookui.rampChange": "{id} colour by value = {v}",
+  "hookui.stateColourWarn": "This part says something with its colour ({s}). A fixed colour hides that.",
+  "hookui.emphasis": "Weight",
+  "hookui.emphasisChange": "{id} weight = {v}",
+  "hookui.fontWhy": "Your terminal owns the font size. ORC cannot change it. Bold looks bigger and dim looks smaller. To make a part take more room, give it more cells.",
+  "hookui.numbers": "Numbers",
+  "hookui.format": "Form",
+  "hookui.formatChange": "{id} form = {v}",
+  "hookui.compact": "Short form",
+  "hookui.compactChange": "{id} short form = {v}",
+  "hookui.minWidthWarn": "A number that changes width pushes everything to its right. Set a minimum width to stop that.",
+  "hookui.whenToShow": "When to show",
+  "hookui.hideChange": "{id} hide when = {v}",
+  "hookui.explain": "Where these came from",
+  "hookui.explainFailed": "That cannot be read right now.",
+  "hookui.palette": "Parts you can add",
+  "hookui.searchPlaceholder": "search",
+  "hookui.matches": "{n} match",
+  "hookui.matchesPlural": "{n} matches",
+  "hookui.noMatch": "Nothing matches that.",
+  "hookui.presets": "Ready-made layouts",
+  "hookui.active": "in use",
+  "hookui.apply": "Use this",
+  "hookui.applyTitle": "Use \"{name}\"?",
+  "hookui.applyWarn": "This REPLACES your whole layout. Every part you placed is removed and the ready-made one takes its place. This cannot be undone.",
+  "hookui.applyFailed": "That layout could not be used.",
+  "hookui.resetLayout": "Start again",
+  "hookui.resetTitle": "Start again?",
+  "hookui.resetWarn": "This REPLACES your layout with ORC's built-in one. Every part you placed is removed. This cannot be undone.",
+  "hookui.advanced": "More",
+  "hookui.theme": "Colour set",
+  "hookui.themeChange": "colour set = {v}",
+  "hookui.recompile": "Rebuild",
+  "hookui.recompiled": "Rebuilt.",
+  "hookui.recompileFailed": "The rebuild failed.",
+  "hookui.compileNote": "ORC rebuilds the layout after every change, so you never have to. This button is for after you upgrade ORC.",
+  "hookui.clone": "Copy",
+  "hookui.cloned": "{id} copied",
+  "hookui.expand": "Split",
+  "hookui.expanded": "{id} split into its parts",
+  "hookui.minWidth": "Least width",
+  "hookui.minWidthChange": "{id} least width = {v}",
+  "hookui.precision": "Decimals",
+  "hookui.precisionChange": "{id} decimals = {v}",
+  "hookui.width": "Cells",
+  "hookui.widthChange": "{id} cells = {v}",
+  "hookui.widthWhy": "More cells is the only kind of bigger a terminal has.",
+  "hookui.before": "Before",
+  "hookui.beforeChange": "{id} before = \"{v}\"",
+  "hookui.after": "After",
+  "hookui.afterChange": "{id} after = \"{v}\"",
+  "hookui.narrow": "On a narrow terminal",
+  "hookui.minCols": "Show above",
+  "hookui.minColsChange": "{id} show above {v} columns",
+  "hookui.priority": "Drop order",
+  "hookui.priorityChange": "{id} drop order = {v}",
+  "hookui.priorityWhy": "When the line does not fit, 1 goes first and 5 goes last. You choose what survives, not the right edge.",
+  "hookui.boardStatus": "The status line",
+  "hookui.boardSubagent": "One row per agent",
+  "hookui.boardStatusSub": "The two lines at the bottom of your terminal.",
+  "hookui.boardSubagentSub": "The row Claude Code draws for each subagent in the agent panel. One line, and it shows what that agent is running at and what it has cost so far."
+}

package/bin/webui/i18n/en/nav.json

@@ -1,21 +1,22 @@
-{
-  "nav.overview": "Overview",
-  "nav.settings": "Settings",
-  "nav.lanes": "Lanes",
-  "nav.runs": "Runs",
-  "nav.knowledge": "Knowledge",
-  "nav.stats": "Stats",
-  "nav.flow": "Flow",
-  "nav.crosslink": "Crosslink",
-  "nav.learn": "Learn",
-  "nav.mockrun": "Mocked Skill Use",
-  "nav.experiment": "Experiment",
-  "nav.maintenance": "Maintenance",
-  "nav.pact": "Promises",
-  "nav.boundary": "Boundary",
-  "nav.handoff": "Self-serve",
-  "nav.challenge": "Challenge",
-  "nav.extra": "Extra",
-  "nav.wait": "Wait",
-  "nav.docs": "Docs"
-}
+{
+  "nav.overview": "Overview",
+  "nav.settings": "Settings",
+  "nav.lanes": "Lanes",
+  "nav.runs": "Runs",
+  "nav.knowledge": "Knowledge",
+  "nav.stats": "Stats",
+  "nav.flow": "Flow",
+  "nav.crosslink": "Crosslink",
+  "nav.learn": "Learn",
+  "nav.mockrun": "Mocked Skill Use",
+  "nav.experiment": "Experiment",
+  "nav.maintenance": "Maintenance",
+  "nav.pact": "Promises",
+  "nav.boundary": "Boundary",
+  "nav.handoff": "Self-serve",
+  "nav.challenge": "Challenge",
+  "nav.extra": "Extra",
+  "nav.wait": "Wait",
+  "nav.docs": "Docs",
+  "nav.hookui": "CLI Hook Interface"
+}

package/bin/webui/i18n/en/overview.json

@@ -88,5 +88,8 @@
   "overview.extraOrphan.chip": "{n} dispatch",
   "overview.extraOrphan.chipPlural": "{n} dispatches",
   "overview.extraOrphan.slug": "never reported back",
-  "overview.extraOrphan.where": "Extra · Recovery"
+  "overview.extraOrphan.where": "Extra · Recovery",
+  "overview.item.statuslineOrphaned.cta": "Open the CLI Hook Interface",
+  "overview.item.statuslineInvalid.cta": "Open the CLI Hook Interface",
+  "overview.item.statuslineUnreadable.cta": "Open the CLI Hook Interface"
 }

package/bin/webui/i18n/en/tour.json

@@ -29,5 +29,7 @@
   "tour.13.title": "A long document, in one picture",
   "tour.13.text": "Each block is a section, sized by how long it is and coloured by its state. Nothing here loads the document itself - ORC works from this map instead, which is why a long document does not end the session.",
   "tour.14.title": "Work that runs somewhere else",
-  "tour.14.text": "One line from nothing to a hundred: how hard a task scored. Every part of it shows where that work actually runs — Claude in blue, a provider you connected in green. A range you have not connected keeps its slot, so \"I left the hard work on Claude on purpose\" never looks like \"there is no hard work\". Nothing leaves this machine until you connect something, test it, and press Apply."
+  "tour.14.text": "One line from nothing to a hundred: how hard a task scored. Every part of it shows where that work actually runs — Claude in blue, a provider you connected in green. A range you have not connected keeps its slot, so \"I left the hard work on Claude on purpose\" never looks like \"there is no hard work\". Nothing leaves this machine until you connect something, test it, and press Apply.",
+  "tour.15.title": "Build your own status line",
+  "tour.15.text": "Three lines, each holding up to five parts. Line 1 must have something before line 2 can. The preview at the top is exactly what your terminal will show — it is drawn by the same code the bar runs."
 }