@azure-id/orc 1.2.1 → 1.4.1

package/bin/webui/fixtures/hookui.js

@@ -0,0 +1,431 @@
+"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, structural: 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, structural: 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, structural: 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, structural: 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, structural: 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, structural: 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"],
+  separators: [
+    { value: " · ", name: "middle dot" },
+    { value: " ", name: "one space" },
+    { value: "  ", name: "two spaces" },
+    { value: " │ ", name: "upright line" },
+    { value: " — ", name: "long dash" },
+    { value: " - ", name: "hyphen" },
+    { value: " / ", name: "slash" },
+    { value: " • ", name: "bullet" },
+    { value: " ▸ ", name: "small arrow" },
+    { value: " » ", name: "double arrow" },
+    { value: ", ", name: "comma" },
+    { value: " | ", name: "pipe" },
+  ],
+  themes_about: {
+    terminal: "the default: your terminal's own colours, one accent",
+    dim: "everything quiet — labels and values both greyed",
+    "high-contrast": "the brightest slot of every colour, for a pale terminal",
+    mono: "no colour at all; weight and shape carry every state",
+  },
+  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, structural: 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, structural: 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, structural: 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, structural: 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,
+  separators: components.separators,
+  themes_about: components.themes_about,
+  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,180 @@
+{
+  "hookui.title": "CLI Hook Interface",
+  "hookui.sub": "Build the ORC status line. Three lines. Each line holds up to five 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.previewAbout": "This is the bar, drawn exactly as your terminal will draw it. The buttons on the right set how wide the terminal is, in character cells: 80 is a narrow window, 120 is a normal one, 160 is a wide one. Parts you told to hide on a narrow terminal disappear at 80.",
+  "hookui.previewStale": "You have changes that are not saved yet. This picture shows the saved layout. Press Apply at the bottom of the page to put your changes in it.",
+  "hookui.previewUnavailable": "The preview cannot be drawn until the layout is valid.",
+  "hookui.fixturesAbout": "Pick a moment to draw. The bar looks different when a run is going, when the quota is nearly gone, and when nothing is happening — so you can check all of them here.",
+  "hookui.cols": "{n} cell wide",
+  "hookui.colsPlural": "{n} cells wide",
+  "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.boardAbout": "This is your bar. Drag a part to move it, or use the buttons on it. Add, change, move and remove all happen here — the list further down is only there to tell you what each part shows.",
+  "hookui.dragHint": "Drag a part by its handle to move it inside a line or on to another line. Or press Tab to reach a part and use the arrow keys.",
+  "hookui.lineN": "Line {n}",
+  "hookui.lineNPlural": "Line {n}",
+  "hookui.slotsUsed": "{n} of {max} slots used",
+  "hookui.slotsUsedPlural": "{n} of {max} slots used",
+  "hookui.add": "+ add a part",
+  "hookui.fillFirst": "Put something on line {n} first.",
+  "hookui.lineFull": "Line {n} is full. It already holds {max} parts. Take one off first.",
+  "hookui.noSuchLine": "There is no such line on this board.",
+  "hookui.applyFirst": "Apply or discard your changes first.",
+
+  "hookui.separator": "Between parts",
+  "hookui.sepCustom": "your own: {s}",
+  "hookui.opSep": "line {n}: parts separated by {s}",
+
+  "hookui.edit": "Change",
+  "hookui.move": "Move",
+  "hookui.remove": "Remove",
+  "hookui.swap": "Use a different part in this slot",
+
+  "hookui.opAdd": "add {id} to line {n}",
+  "hookui.opRemove": "remove {id}",
+  "hookui.opMove": "move {id} to line {n}",
+  "hookui.opClone": "copy {id}",
+  "hookui.opSwap": "use {id} in this slot",
+
+  "hookui.pickerTitle": "Add a part to line {n}",
+  "hookui.pickerTitlePlural": "Add a part to line {n}",
+  "hookui.pickerAbout": "Pick one. It goes on the end of line {n}. Nothing is saved until you press Apply.",
+  "hookui.pickerAboutPlural": "Pick one. It goes on the end of line {n}. Nothing is saved until you press Apply.",
+  "hookui.pickerReplaceTitle": "Use a different part",
+  "hookui.pickerReplaceAbout": "Pick the part that should sit in this slot instead. The slot keeps its place on the line.",
+  "hookui.searchPlaceholder": "search",
+  "hookui.matches": "{n} match",
+  "hookui.matchesPlural": "{n} matches",
+  "hookui.noMatch": "Nothing matches that.",
+
+  "hookui.moveTitle": "Move this part",
+  "hookui.moveAbout": "Pick where {id} should go. Slot 1 is the far left of a line.",
+  "hookui.slotN": "slot {n}",
+  "hookui.slotNPlural": "slot {n}",
+  "hookui.alreadyHere": "It is already here.",
+
+  "hookui.removeTitle": "Remove this part?",
+  "hookui.removeAbout": "{id} comes off the bar. Nothing is saved until you press Apply, so you can still discard this.",
+
+  "hookui.unknownComponent": "This ORC version does not have this part.",
+  "hookui.shape": "Shape",
+  "hookui.shapeAbout": "How this part is drawn. Every option below is drawn with this part's real value, so you can see it before you choose. Picking one closes this window.",
+  "hookui.shapeChange": "{id} shape = {r}",
+  "hookui.glyphs": "Symbols",
+  "hookui.glyphsAbout": "Which set of symbols the bars and marks are drawn from. Some terminals and fonts cannot draw all of them.",
+  "hookui.glyphChange": "{id} symbols = {v}",
+  "hookui.words": "Words",
+  "hookui.wordsAbout": "The text around the value.",
+  "hookui.label": "Name",
+  "hookui.labelAbout": "The short word printed in front of the value. Leave it empty to print no name at all.",
+  "hookui.labelPlaceholder": "type any name",
+  "hookui.labelChange": "{id} name = \"{v}\"",
+  "hookui.case": "Letters",
+  "hookui.caseAbout": "Whether the name is printed in capitals, in small letters, or exactly as you typed it.",
+  "hookui.caseChange": "{id} letters = {v}",
+  "hookui.before": "Before",
+  "hookui.beforeAbout": "Text printed immediately before this part. Use it for a bracket or a space.",
+  "hookui.beforeChange": "{id} before = \"{v}\"",
+  "hookui.after": "After",
+  "hookui.afterAbout": "Text printed immediately after this part.",
+  "hookui.afterChange": "{id} after = \"{v}\"",
+
+  "hookui.colour": "Colour",
+  "hookui.colourAbout": "Which colour slot your terminal should paint this part with. ORC never sends a fixed colour, so the bar always follows your own terminal colours.",
+  "hookui.labelColour": "Name colour",
+  "hookui.labelColourAbout": "The colour of the short word in front of the value.",
+  "hookui.valueColour": "Value colour",
+  "hookui.valueColourAbout": "The colour of the value itself.",
+  "hookui.colourChange": "{id} colour = {v}",
+  "hookui.ramp": "Colour by value",
+  "hookui.rampAbout": "Let the colour change with the number, so a bar turns as it fills. Each option says which direction is the bad one.",
+  "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.emphasisAbout": "Bold, faint, or one of the other things a terminal can do to text.",
+  "hookui.emphasisChange": "{id} weight = {v}",
+  "hookui.fontWhy": "Your terminal owns the font size. ORC cannot change it. Bold looks bigger and faint looks smaller. To make a part take more room, give it more cells.",
+
+  "hookui.numbers": "Numbers",
+  "hookui.numbersAbout": "How the number itself is printed.",
+  "hookui.format": "Form",
+  "hookui.formatAbout": "Print the number as a share of the whole, as one number out of another, or on its own.",
+  "hookui.formatChange": "{id} form = {v}",
+  "hookui.compact": "Short form",
+  "hookui.compactAbout": "Shorten a big number, so 412000 is printed in three characters instead of six.",
+  "hookui.compactChange": "{id} short form = {v}",
+  "hookui.minWidth": "Least width",
+  "hookui.minWidthWarn": "A number that changes width pushes everything to its right. Set a least width — in cells — and the number is padded so nothing moves.",
+  "hookui.minWidthChange": "{id} least width = {v}",
+  "hookui.precision": "Decimals",
+  "hookui.precisionAbout": "How many digits after the point. 0 prints a whole number.",
+  "hookui.precisionChange": "{id} decimals = {v}",
+  "hookui.width": "Cells",
+  "hookui.widthWhy": "How many character cells the bar is drawn in. More cells is the only kind of bigger a terminal has.",
+  "hookui.widthChange": "{id} cells = {v}",
+
+  "hookui.whenToShow": "When to hide",
+  "hookui.whenToShowAbout": "Tick every case in which this part should disappear. Tick nothing and it is always drawn, even when it has nothing to say.",
+  "hookui.hideChange": "{id} hide when = {v}",
+
+  "hookui.narrow": "On a narrow terminal",
+  "hookui.narrowAbout": "What happens to this part when the window is too small for the whole line.",
+  "hookui.minCols": "Show above",
+  "hookui.minColsAbout": "Hide this part when the terminal is narrower than this many cells. 0 means never hide it.",
+  "hookui.minColsChange": "{id} show above {v} columns",
+  "hookui.priority": "Drop order",
+  "hookui.priorityWhy": "When the line does not fit, 1 goes first and 5 goes last. You choose what survives, not the right edge.",
+  "hookui.priorityChange": "{id} drop order = {v}",
+  "hookui.explain": "Where these came from",
+  "hookui.explainFailed": "That cannot be read right now.",
+
+  "hookui.reference": "What each part shows",
+  "hookui.referenceAbout": "A list of every part ORC can draw, and what it means. This list adds nothing — to put a part on the bar, use \"+ add a part\" on the board above.",
+
+  "hookui.presets": "Ready-made layouts",
+  "hookui.presetsAbout": "A whole bar somebody already designed. Using one replaces everything you have.",
+  "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.themeAbout": "One choice that colours the whole bar at once. It picks colour slots, never fixed colours, so the bar still follows your terminal.",
+  "hookui.themeOverride": "A part with its own colour keeps it. Open that part and set its colour back to the shared one if you want the set to reach it.",
+  "hookui.themeChange": "colour set = {v}",
+  "hookui.glyphsDocAbout": "The symbol set every part starts from. A part can still be given its own.",
+  "hookui.glyphsDocChange": "symbols = {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.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."
+}