@bli-cockpit/cli 0.2.137 → 0.2.141

package/dist/commands/local-args-tower-admin.js

@@ -157,6 +157,7 @@ export const SLACK_WORKSPACE_KEYS = ["bli", "blue_pearl"];
  * `cockpit slack read [--person|--channel|--query|--since|--until|--limit]`
  * (BLI-3462).
  */
+const SLACK_READ_FORMATS = ["compact", "full"];
 export function parseSlackArgs(args) {
     const values = parseNamedArgs(args, {
         allowedFlags: [
@@ -164,12 +165,15 @@ export function parseSlackArgs(args) {
             "--dashboard-url",
             "--workspace",
             "--stale-only",
+            "--list",
             "--person",
             "--channel",
             "--query",
+            "--word",
             "--since",
             "--until",
             "--limit",
+            "--format",
             "--json",
         ],
         valueFlags: [
@@ -182,6 +186,7 @@ export function parseSlackArgs(args) {
             "--since",
             "--until",
             "--limit",
+            "--format",
         ],
     });
     if (values.positionals.length > 1) {
@@ -196,6 +201,12 @@ export function parseSlackArgs(args) {
         dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
         json: values.booleans.has("--json"),
     };
+    if (values.flags.has("--format") && rawAction !== "read") {
+        throw new Error("--format belongs to `cockpit slack read`.");
+    }
+    if (values.booleans.has("--list") && rawAction !== "coverage") {
+        throw new Error("--list belongs to `cockpit slack coverage`.");
+    }
     if (rawAction === "coverage") {
         // `--workspace` here is a Slack workspace key, NOT the collection-root
         // `--workspace <path>` every setup command takes. Named at the point of use
@@ -209,6 +220,8 @@ export function parseSlackArgs(args) {
             action: "coverage",
             workspace,
             staleOnly: values.booleans.has("--stale-only"),
+            // BLI-10450: counts alone could not answer "is there a Kaiben channel?".
+            list: values.booleans.has("--list"),
             ...base,
         };
     }
@@ -219,15 +232,27 @@ export function parseSlackArgs(args) {
         throw new Error("slack read needs at least one of --person, --channel or --query. An unfiltered dump of every " +
             "message is not something this command offers.");
     }
+    const word = values.booleans.has("--word");
+    if (word && !query) {
+        throw new Error("--word needs --query: it says how the query text is matched.");
+    }
+    const format = optionalNonEmpty(values.flags.get("--format"));
+    if (format && !SLACK_READ_FORMATS.includes(format)) {
+        throw new Error(`slack read --format must be one of ${SLACK_READ_FORMATS.join(", ")}; got ${format}.`);
+    }
     return {
         kind: "slack",
         action: "read",
         person,
         channel,
         query,
+        ...(word ? { word } : {}),
         since: optionalNonEmpty(values.flags.get("--since")),
         until: optionalNonEmpty(values.flags.get("--until")),
         limit: optionalPositiveInteger(values.flags.get("--limit"), "--limit"),
+        // BLI-10450: every result printed twice (a summary, then blocks) — one
+        // rendering now, never both. `full` (default) keeps the detailed blocks.
+        format: format ?? "full",
         ...base,
     };
 }

package/dist/commands/local-args-tower-docs-msg.js

@@ -8,7 +8,10 @@
  */
 import { optionalNonEmpty, optionalPositiveInteger, optionalUrl, parseNamedArgs, } from "./local-arg-values.js";
 const DOCS_ACTIONS = new Set(["list", "tree", "read", "create", "update", "link", "sync-status"]);
-const DOCS_ACTIONS_NEEDING_A_DOC = new Set(["read", "update", "link"]);
+// BLI-10450: `read` moved to its own branch in `parseDocsDocumentReference` —
+// it takes SEVERAL references now, so it no longer shares the "exactly one"
+// rule `update`/`link` still enforce.
+const DOCS_ACTIONS_NEEDING_A_DOC = new Set(["update", "link"]);
 export function parseDocsArgs(args) {
     const values = parseNamedArgs(args, {
         allowedFlags: [
@@ -22,17 +25,56 @@ export function parseDocsArgs(args) {
             "--file",
             "--body-stdin",
             "--query",
+            "--word",
             "--limit",
             "--clear",
+            "--bodies",
+            "--section",
+            "--offset",
             "--json",
         ],
-        valueFlags: ["--home", "--dashboard-url", "--title", "--parent", "--visibility", "--file", "--query", "--limit"],
+        valueFlags: [
+            "--home",
+            "--dashboard-url",
+            "--title",
+            "--parent",
+            "--visibility",
+            "--file",
+            "--query",
+            "--limit",
+            "--section",
+            "--offset",
+        ],
     });
     const { action, rest } = parseDocsAction(values.positionals);
     const link = parseDocsLink(action, rest, values.booleans.has("--clear"));
-    const docRef = parseDocsDocumentReference(action, link.rest);
-    const { visibility, clearParent, parentId, allowEmpty, title, query, limit } = parseDocsFlags(action, values);
-    return buildDocsCommand(values, action, docRef, visibility, clearParent, parentId, allowEmpty, title, query, limit, link);
+    const { docRef, docRefs } = parseDocsDocumentReference(action, link.rest);
+    const { visibility, clearParent, parentId, allowEmpty, title, query, wholeWord, limit, bodies, section, offset } = parseDocsFlags(action, values);
+    if (action === "read")
+        validateDocsReadTargets(docRefs, parentId, bodies);
+    return buildDocsCommand(values, action, docRef, docRefs, visibility, clearParent, parentId, allowEmpty, title, query, wholeWord, limit, bodies, section, offset, link);
+}
+/**
+ * BLI-10450: `read` takes either several document references OR
+ * `--parent <id> --bodies` (every document filed directly under that
+ * parent, with bodies) — never both, and never neither. Checked once flags
+ * are known, not in `parseDocsDocumentReference`, because "was --bodies
+ * given" decides which of the two empty-input refusals is the right one.
+ */
+function validateDocsReadTargets(docRefs, parentId, bodies) {
+    const hasRefs = Boolean(docRefs && docRefs.length > 0);
+    if (hasRefs && parentId) {
+        throw new Error("docs read takes either document references or --parent --bodies, not both.");
+    }
+    if (bodies && !parentId) {
+        throw new Error("--bodies needs --parent, e.g. `cockpit docs read --parent <id> --bodies`.");
+    }
+    if (parentId && !bodies) {
+        throw new Error("docs read --parent needs --bodies too (or use `cockpit docs list --parent <id>` for metadata only).");
+    }
+    if (!hasRefs && !(parentId && bodies)) {
+        throw new Error("docs read needs one or more document ids/slugs, or --parent <id> --bodies.");
+    }
 }
 /**
  * BLI-10430: `docs link <id|slug> <notion-url|page-id>` ties a document to a
@@ -67,23 +109,31 @@ function parseDocsAction(positionals) {
     return { action, rest: positionals.slice(first === undefined ? 0 : 1) };
 }
 function parseDocsDocumentReference(action, rest) {
+    // BLI-10450: `read` alone takes several references in one call — an agent
+    // reading a folder's worth of documents used to pay a resolve-then-read
+    // pair PER document. Emptiness is validated later, once `--parent`/
+    // `--bodies` are known (`validateDocsReadTargets`).
+    if (action === "read") {
+        const refs = rest.map((token) => optionalNonEmpty(token)).filter((token) => Boolean(token));
+        return { docRef: refs[0], docRefs: refs.length > 0 ? refs : undefined };
+    }
     if (DOCS_ACTIONS_NEEDING_A_DOC.has(action)) {
         const docRef = optionalNonEmpty(rest[0]);
         if (!docRef)
             throw new Error(`docs ${action} needs a document id or slug.`);
         if (rest.length > 1)
             throw new Error(`docs ${action} takes one document reference, not ${rest.length}.`);
-        return docRef;
+        return { docRef, docRefs: undefined };
     }
     // BLI-10430: `sync-status` reports the whole linked library, or one document.
     if (action === "sync-status") {
         if (rest.length > 1)
             throw new Error(`docs sync-status takes at most one document reference, not ${rest.length}.`);
-        return optionalNonEmpty(rest[0]);
+        return { docRef: optionalNonEmpty(rest[0]), docRefs: undefined };
     }
     if (rest.length > 0)
         throw new Error(`docs ${action} does not take "${rest[0]}".`);
-    return undefined;
+    return { docRef: undefined, docRefs: undefined };
 }
 function parseDocsFlags(action, values) {
     const visibility = optionalNonEmpty(values.flags.get("--visibility"));
@@ -118,19 +168,48 @@ function parseDocsFlags(action, values) {
     if (query && action !== "list") {
         throw new Error("--query belongs to `cockpit docs list`.");
     }
+    const wholeWord = values.booleans.has("--word");
+    if (wholeWord && !query) {
+        throw new Error("--word needs --query: it says how the query text is matched.");
+    }
+    // BLI-10450: `--limit` now also belongs to `read`, where it means two
+    // different things depending on the mode it is used in — a row cap in
+    // `--parent --bodies` mode (matching `list`'s own meaning), or a character
+    // cap when slicing an explicit reference's body. The two modes are mutually
+    // exclusive (`validateDocsReadTargets`), so the flag is never ambiguous in
+    // any one call, only overloaded across the command's two shapes.
     const limit = optionalPositiveInteger(values.flags.get("--limit"), "--limit");
-    if (limit !== undefined && action !== "list") {
-        throw new Error("--limit belongs to `cockpit docs list`.");
+    if (limit !== undefined && action !== "list" && action !== "read") {
+        throw new Error("--limit belongs to `cockpit docs list` or `cockpit docs read`.");
+    }
+    // BLI-10450: `--bodies` pairs with `--parent` to bulk-read a folder;
+    // `--section`/`--offset` slice an explicit reference's body, mirroring
+    // `cockpit workbook --section`.
+    const bodies = values.booleans.has("--bodies");
+    if (bodies && action !== "read")
+        throw new Error("--bodies belongs to `cockpit docs read`.");
+    const section = optionalNonEmpty(values.flags.get("--section"));
+    if (section && action !== "read")
+        throw new Error("--section belongs to `cockpit docs read`.");
+    const offsetRaw = optionalNonEmpty(values.flags.get("--offset"));
+    let offset;
+    if (offsetRaw !== undefined) {
+        offset = Number(offsetRaw);
+        if (!Number.isInteger(offset) || offset < 0)
+            throw new Error("--offset must be a whole number 0 or greater.");
     }
-    return { visibility, clearParent, parentId, allowEmpty, title, query, limit };
+    if (offset !== undefined && action !== "read")
+        throw new Error("--offset belongs to `cockpit docs read`.");
+    return { visibility, clearParent, parentId, allowEmpty, title, query, wholeWord, limit, bodies, section, offset };
 }
-function buildDocsCommand(values, action, docRef, visibility, clearParent, parentId, allowEmpty, title, query, limit, link) {
+function buildDocsCommand(values, action, docRef, docRefs, visibility, clearParent, parentId, allowEmpty, title, query, wholeWord, limit, bodies, section, offset, link) {
     return {
         kind: "docs",
         action,
         homeDir: optionalNonEmpty(values.flags.get("--home")),
         dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
         ...(docRef ? { docRef } : {}),
+        ...(docRefs ? { docRefs } : {}),
         title,
         ...(parentId ? { parentId } : {}),
         clearParent,
@@ -139,7 +218,11 @@ function buildDocsCommand(values, action, docRef, visibility, clearParent, paren
         filePath: optionalNonEmpty(values.flags.get("--file")),
         bodyStdin: values.booleans.has("--body-stdin"),
         ...(query ? { query } : {}),
+        ...(wholeWord ? { wholeWord } : {}),
         ...(limit === undefined ? {} : { limit }),
+        ...(bodies ? { bodies } : {}),
+        ...(section ? { section } : {}),
+        ...(offset === undefined ? {} : { offset }),
         ...(link.notionPage ? { notionPage: link.notionPage } : {}),
         ...(link.clearLink ? { clearLink: true } : {}),
         json: values.booleans.has("--json"),

package/dist/commands/local-args-tower-work.js

@@ -73,14 +73,14 @@ export function parseIssueArgs(args) {
         ],
     });
     const { action, rest } = readIssueAction(values);
-    const { issueRef, moveState } = readIssueReference(action, rest);
+    const { issueRef, issueRefs, moveState } = readIssueReference(action, rest);
     validateIssueState(moveState, "issue move state must be one of: ");
     const stateFilter = readIssueStateFilter(action, values);
     const title = readIssueTitle(action, values);
     const priority = readIssuePriority(values);
     const assignee = readIssueAssignee(action, values);
     const limit = readIssueLimit(action, values);
-    return buildIssueCommand(values, action, issueRef, moveState, stateFilter, title, priority, assignee, limit);
+    return buildIssueCommand(values, action, issueRef, issueRefs, moveState, stateFilter, title, priority, assignee, limit);
 }
 function readIssueAction(values) {
     const first = values.positionals[0];
@@ -92,8 +92,19 @@ function readIssueAction(values) {
 }
 function readIssueReference(action, rest) {
     let issueRef;
+    let issueRefs;
     let moveState;
-    if (ISSUE_ACTIONS_NEEDING_AN_ISSUE.has(action)) {
+    // BLI-10450: `show` alone takes several references in one call — an agent
+    // reading a sprint's worth of tickets used to pay one process per issue.
+    // Every other verb here still names exactly one issue.
+    if (action === "show") {
+        const refs = rest.map((token) => optionalNonEmpty(token)).filter((token) => Boolean(token));
+        if (refs.length === 0)
+            throw new Error("issue show needs one or more issue ids or identifiers, e.g. BLI-3654.");
+        issueRefs = refs;
+        issueRef = refs[0];
+    }
+    else if (ISSUE_ACTIONS_NEEDING_AN_ISSUE.has(action)) {
         issueRef = optionalNonEmpty(rest[0]);
         if (!issueRef)
             throw new Error(`issue ${action} needs an issue id or identifier, e.g. BLI-3654.`);
@@ -112,7 +123,7 @@ function readIssueReference(action, rest) {
     else if (rest.length > 0) {
         throw new Error(`issue ${action} does not take "${rest[0]}".`);
     }
-    return { issueRef, moveState };
+    return { issueRef, issueRefs, moveState };
 }
 function validateIssueState(state, errorPrefix) {
     if (state && !ISSUE_STATES.includes(state)) {
@@ -166,13 +177,14 @@ function readIssueLimit(action, values) {
     }
     return limit;
 }
-function buildIssueCommand(values, action, issueRef, moveState, stateFilter, title, priority, assignee, limit) {
+function buildIssueCommand(values, action, issueRef, issueRefs, moveState, stateFilter, title, priority, assignee, limit) {
     return {
         kind: "issue",
         action,
         homeDir: optionalNonEmpty(values.flags.get("--home")),
         dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
         ...(issueRef ? { issueRef } : {}),
+        ...(issueRefs ? { issueRefs } : {}),
         ...(moveState ? { moveState } : {}),
         ...(stateFilter ? { stateFilter } : {}),
         ...(assignee ? { assignee } : {}),

package/dist/commands/local-help-commands-tower-ops.js

@@ -0,0 +1,134 @@
+/**
+ * The long-form `cockpit <command> --help` text for JARVIS, the model cards,
+ * Scout and the ops doors.
+ *
+ * Split out of `local-help-commands.ts` (BLI-10445) when that file crossed the
+ * 500-line readability ratchet, along the same seam BLI-3709 drew: these are
+ * Tower surfaces, not the collector's own commands.
+ *
+ * Every string moved verbatim. Help output is what an intern pastes back when
+ * something breaks, so it is a user-visible contract like any other.
+ */
+export const TOWER_OPS_COMMAND_HELP = [
+    [
+        "jarvis",
+        [
+            "Usage: cockpit jarvis [question] [--prompt <question>] [--as <person>] [--date <YYYY-MM-DD>] [--thread <name>] [--model <key>] [--image <path>|--file <path>] [--no-stream] [--threads|--history [--limit <n>]] [--trace <id|last>] [--dashboard-url <url>] [--json [--show-approval-code]]",
+            "",
+            "Chats with the same JARVIS used by Tower web chat and the BLI Slack DM.",
+            "--as selects the existing website person space; it changes who the chat is about, never who is authenticated.",
+            "--date <YYYY-MM-DD> binds the page that was live on one of that person's days (`today` and `yesterday` work too), so the turn is about that day's page instead of the newest one. A day with nothing compiled binds no page and JARVIS says so rather than answering from a different day.",
+            "--model <key> requests one provider:model pair (e.g. openai:gpt-5.6-terra); an unrecognised key is refused by the dashboard, not this command.",
+            "--image <path> (alias --file) attaches one local PNG, JPEG, or WEBP under 10 MB with the question, the same one-image gate the JARVIS panel uses. A bad path, an unsupported type, or an oversized file is refused with its own plain sentence — never a stack trace.",
+            "Run with no question for an interactive terminal conversation.",
+            "Agents can pass --prompt, positional text, or pipe one question on stdin.",
+            "Each answer prints a per-tool trace line and, only on a fallback or model mismatch, one model receipt line.",
+            "Trace lines arrive live while JARVIS works; pass --no-stream to wait for the whole answer in one piece instead.",
+            "--json writes one machine-readable response (including trace and model) to stdout; operational metadata stays on stderr. A --json run never streams fragments, whichever mode it is in.",
+            "A --json turn is treated as an AGENT surface: if it proposes a coding task, JARVIS answers with proposal_id and NOT the eight-character approval code, because a code a program can read is a code it could approve with. The person fetches the code themself — a Tower browser tab, their Slack DM, or an interactive `cockpit jarvis` — and hands it back. Pass --show-approval-code when a script really is driving a dispatch for a person; the run says on stderr that it did.",
+            "That object carries answer, sources (the Source: lines inside it), turn_id (pass it to --trace), thread_id (pass it to --thread), proposal_id, next_action, degraded and degraded_reasons — the SAME shape the bli-tower MCP server's jarvis_ask tool returns, so a script and an agent read one contract. reply/thread/traceId/model/trace/latency are still there beside it and still mean what they always meant.",
+            "proposal_id carries the coding-arm proposal a turn made, and is null when it made none — including when the arm refused. next_action is the sentence that says which of those it was and what a PERSON has to do about it: fetch the approval code for that proposal (a Tower tab, their Slack DM, or their own interactive `cockpit jarvis`), or approve a refused one where a person reads. A null proposal_id is never on its own. Do not send a proposal_id back on a --json turn: this is the surface the code was withheld from, and reading it back is refused here.",
+            "A turn that outlives the dashboard's own ceiling is reported as turn_timed_out — an incomplete answer is never printed as a finished one.",
+            "The command uses the existing paired device identity. It cannot override the caller, team, role, or person scope.",
+            "A thread is SINGLE-WRITER: two turns in the same conversation at the same time can read each other, and one can answer the other's question. Your own terminal is one conversation, named main, and stays that way. A --json turn is a program's, so it gets a FRESH conversation per call unless --thread names one, and the answer's thread_id is the name it used — pass that back with --thread to continue it deliberately. On a --json turn, --thread main asks for the shared default nobody chose, so it is treated as naming nothing and a fresh conversation is minted anyway.",
+            "--threads lists the terminal conversations on this account; --thread <name> --history replays one (the newest --limit <n> messages). The per-call conversations a --json turn minted are counted rather than listed, and any one of them still replays by name. Neither takes a question, and neither can reach anybody else's conversations.",
+            "--trace <id|last> prints the step tree of one turn — every model step, tool call and server-side memory step, with how long each took, which model ran it, the tokens it spent and what failed. `last` opens the turn this machine asked most recently. Like --threads it takes no question and reaches no model.",
+            "Run `cockpit login` first if this machine is not paired.",
+        ],
+    ],
+    [
+        "models",
+        [
+            "Usage: cockpit models [list|show <provider:model>|compare <id> <id> [...]] [--highlight] [--dashboard-url <url>] [--json]",
+            "",
+            "The model-card shelf: one card per model, with what the PROVIDER documents (context",
+            "window, max output, price per million, reasoning modes, tool calling, structured output,",
+            "quirks) beside what OUR machine measured (latency p50/p95, observed tokens/s, the last",
+            "belt and conformance probe verdicts).",
+            "Every value carries the page it was read from; a field the provider does not state reads",
+            "unknown with the reason, never a guess.",
+            "STALE:<field> means a measurement contradicted the documentation — reasoning-off refused",
+            "where the card says it can be turned off, the belt refused where the card says tool",
+            "calling. The line under it is the command that re-reads the provider.",
+            "compare puts two to four cards side by side: the same rows the page at /settings/models/",
+            "compare renders, including `$ per 100 JARVIS turns` (our own measured tokens a turn times",
+            "the provider's price, with the window it was measured over beside it — `not measured`",
+            "where no profile exists, never a per-million price relabelled) and the bench row, which",
+            "appears only when every model was judged in the SAME run against the SAME baseline;",
+            "otherwise it says `benched separately — not a head-to-head` rather than subtracting two",
+            "win rates. --highlight marks the winner in each scored row (lowest wins on price and",
+            "latency, highest on tokens/s, most wins on the bench); a row where any column is `—` or",
+            "`not measured` is not scored at all, and says why.",
+            "`cockpit models` is the SHELF; `cockpit model` is the org setting saying which model a",
+            "slot runs on. Different nouns, one letter apart, on purpose.",
+            "--json writes one object to stdout; operational lines stay on stderr.",
+            "Run `cockpit login` first if this machine is not paired.",
+        ],
+    ],
+    [
+        "scout",
+        [
+            "Usage: cockpit scout [board|start|dismiss|undo <experiment-id>] [--days <n>] [--dashboard-url <url>] [--json]",
+            "",
+            "Prints the same Scout board the Tower page shows, in the same words: the standing",
+            "watch line, the cards waiting on a decision, and the raw signal watch underneath.",
+            "This is the board itself. To ask a QUESTION about it — what it means, whether it is",
+            "worth doing here — use `cockpit jarvis`, whose readScout tool reads the same rows.",
+            "`cockpit scout board` and a bare `cockpit scout` are the same command; the MCP twin",
+            "is `scout_board` on the bli-tower server, over the same GET /api/cockpit/scout door.",
+            "--days <n> widens or narrows the window (1 to 90; the board defaults to 14).",
+            "Reading follows the Scout page audience setting, so whoever can open /scout can run this.",
+            "start, dismiss, and undo move one card and are super_admin actions on every surface;",
+            "a refusal is printed as Tower worded it and the board stays readable underneath.",
+            "The id can be the first 6 or more characters printed beside each card; an ambiguous",
+            "prefix is refused with the candidates rather than acting on the first match.",
+            "--json writes one object to stdout; operational lines stay on stderr.",
+            "Run `cockpit login` first if this machine is not paired.",
+        ],
+    ],
+    [
+        "ops",
+        [
+            "Usage: cockpit ops [status [--job <id>] [--coverage] [--skips] [--memory [--memory-days N]] [--models] [--turns] [--tool-router] | recompile --person <email|name|id> [--dry-run]] [--json]",
+            "",
+            "  cockpit ops status",
+            "      One line per scheduled job: when it last produced something, and whether that",
+            "      is late FOR THAT JOB. A once-daily job quiet for 18 hours reads ok; a",
+            "      quarter-hourly one does not. Every line names the schedule it is judged against.",
+            "      --turns adds 30-day JARVIS turn aggregates; --tool-router adds the shadow-router agreement board.",
+            "      A job that is not ok also prints what its artifact does and does not prove —",
+            "      several only write a row when there is something new, so quiet can mean a quiet",
+            "      week rather than a broken cron.",
+            "      --job <id> asks about one; --skips adds the open Slack and external-sync skips,",
+            "      grouped by reason. Exits 1 if anything is stale, empty or unreadable.",
+            "      --coverage is the collection-coverage row on its own, with the BUCKET table:",
+            "      which bucket the missing sessions are in (staged-not-committed with the upload",
+            "      ledger's own reason, still pending upload, deliberately withheld, or no row at",
+            "      all), whose machines they are on, which of their own days, and what to run for",
+            "      each. That table also prints on the ordinary board whenever anything is missing.",
+            "      Every machine's line also carries its BLI Memory column — whether the MCP",
+            "      servers and the recall/save hooks are registered for Claude Code and Codex,",
+            "      and whether Codex has been told to TRUST its hooks. That column never colours",
+            "      a machine: a laptop with no memory hooks is still collecting sessions.",
+            "      --memory adds the adoption gauge: memories saved per person per day for the",
+            "      last 7 days, split by source (an agent calling save_memory, the Stop hook, or",
+            "      the vendor import, which is a backfill and never counted as use).",
+            "      --memory-days N changes the window (1-30) and implies --memory. Searches are",
+            "      NOT counted — nothing in Tower records one, and the gauge says so rather than",
+            "      printing a zero you would read as nobody searching.",
+            "      It also shows ordinary prompt-hook observations: outcome counts, 100 ms",
+            "      duration bounds, actual vector-cache reuse and named coverage gaps. These",
+            "      are hook-body timings, not full host wait or retrieval-quality scores.",
+            "  cockpit ops recompile --person <email|name|id> [--dry-run]",
+            "      Writes that person's page again, now. Your own page is always yours to",
+            "      recompile; somebody else's is for the people who read across the team.",
+            "      --dry-run resolves the person and says which page is being served, compiling",
+            "      nothing. A compile only ever ADDS a version — nothing is overwritten.",
+            "      It can take minutes, and if Tower's 800-second budget runs out first you are",
+            "      told exactly that: the compile may still have finished. Check with",
+            "      `cockpit brief --for <person>`.",
+            "      There is no --cadence: the compile path behind this writes a daily, and a flag",
+            "      that was accepted and dropped would be worse than no flag.",
+        ],
+    ],
+];