@bli-cockpit/cli 0.2.112 → 0.2.114

package/dist/agent-rules.js

@@ -1,6 +1,7 @@
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
+import { findStaleUnmanagedTicketBindingBlock, hasEquivalentUnmanagedTicketBinding, replaceLineSpan, } from "./agent-rules-unmanaged-block.js";
 import { describeError, isMissingFileFailure } from "./health-detail.js";
 const MANAGED_BLOCK_START = "<!-- BLI_COCKPIT_AGENT_RULES:START -->";
 const MANAGED_BLOCK_END = "<!-- BLI_COCKPIT_AGENT_RULES:END -->";
@@ -260,88 +261,6 @@ function managedBlockPattern() {
 function extractManagedBlock(contents) {
     return contents.match(managedBlockPattern())?.[0] ?? null;
 }
-function hasEquivalentUnmanagedTicketBinding(contents, scopePaths = []) {
-    const text = normalizeRuleText(contents);
-    if (!hasTicketBindingCues(text))
-        return false;
-    if (!hasRepoScopeGuard(text))
-        return false;
-    if (scopePaths.some((scopePath) => !hasScopePath(text, scopePath)))
-        return false;
-    if (!hasTicketLookupOrCreationCue(text))
-        return false;
-    // Contents without the QA-receipts rule are the older vocabulary and must
-    // read as stale — otherwise machines with a hand-written ticket-binding
-    // section never receive the definition-of-done rule.
-    if (!hasQaReceiptsCue(text))
-        return false;
-    const signals = [
-        /cockpit\s+start\s+--ticket\b/u,
-        /before\s+(?:the\s+)?first\s+code\s+edit|before\s+ticketed\s+implementation/u,
-        /general\s+ambient/u,
-        /cockpit\s+sync\s+--repo|cockpit\s+sync\s+--workspace|fresh\s+ticket\/session\s+binding\s+metadata/u,
-        /use\s+--ticket|the\s+flag\s+is\s+--ticket|do\s+not\s+invent\s+--ticketid/u,
-    ];
-    const score = signals.filter((signal) => signal.test(text)).length;
-    return score >= 4;
-}
-function hasQaReceiptsCue(text) {
-    return /computer-use\s+qa\s+pass/u.test(text)
-        && /receipts/u.test(text);
-}
-function hasTicketLookupOrCreationCue(text) {
-    return /search\s+linear|create\s+(?:a\s+)?(?:narrow\s+)?linear\s+ticket|new\s+linear\s+ticket/u.test(text);
-}
-function hasScopePath(text, scopePath) {
-    return text.includes(normalizeRuleText(path.resolve(scopePath)));
-}
-function hasRepoScopeGuard(text) {
-    return (/only\s+applies\s+when\s+the\s+current\s+working\s+directory\s+is\s+inside/u.test(text) ||
-        /outside\s+that\s+(?:folder|workspace|repo).*(?:do\s+not|dont)\s+run\s+cockpit/u.test(text) ||
-        /private\s+chats\s+or\s+unrelated\s+repos/u.test(text));
-}
-function findStaleUnmanagedTicketBindingBlock(contents, scopePaths = []) {
-    const lines = contents.split("\n");
-    for (let index = 0; index < lines.length; index += 1) {
-        if (!/^#{1,6}\s+.*(?:cockpit\s+)?ticket\s+binding\b/iu.test(lines[index] ?? "")) {
-            continue;
-        }
-        let endLine = lines.length;
-        for (let cursor = index + 1; cursor < lines.length; cursor += 1) {
-            if (/^#{1,6}\s+\S/u.test(lines[cursor] ?? "")) {
-                endLine = cursor;
-                break;
-            }
-        }
-        const candidate = lines.slice(index, endLine).join("\n");
-        const normalized = normalizeRuleText(candidate);
-        if (hasTicketBindingCues(normalized) &&
-            !hasEquivalentUnmanagedTicketBinding(candidate, scopePaths)) {
-            return { startLine: index, endLine };
-        }
-    }
-    return null;
-}
-function replaceLineSpan(contents, startLine, endLine, replacement) {
-    const lines = contents.split("\n");
-    const before = lines.slice(0, startLine).join("\n").trimEnd();
-    const after = lines.slice(endLine).join("\n").trimStart();
-    return [before, replacement, after]
-        .filter((part) => part.trim().length > 0)
-        .join("\n\n")
-        .replace(/\n{3,}/gu, "\n\n")
-        .trimEnd() + "\n";
-}
-function hasTicketBindingCues(text) {
-    return /\bcockpit\b/u.test(text) && /\bticket\b/u.test(text) && /binding|agent|linear/u.test(text);
-}
-function normalizeRuleText(contents) {
-    return contents
-        .toLowerCase()
-        .replace(/[`"'<>]/gu, "")
-        .replace(/\s+/gu, " ")
-        .trim();
-}
 function escapeRegExp(value) {
     return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
 }

package/dist/commands/agent-session-report.js

@@ -43,6 +43,7 @@ function normalizeCodexResult(result) {
         worktree: result.worktree,
         cwd_basename: result.cwd_basename,
         cwd_hash: result.cwd_hash,
+        session_facts: result.session_facts,
     };
 }
 function normalizeClaudeResult(result) {
@@ -61,6 +62,7 @@ function normalizeClaudeResult(result) {
         worktree: result.worktree,
         cwd_basename: result.cwd_basename,
         cwd_hash: result.cwd_hash,
+        session_facts: result.session_facts,
     };
 }
 /**
@@ -154,6 +156,10 @@ function sessionReportEntry(result, context) {
             : {}),
         session_file_byte_size: result.byte_size,
         session_file_mtime: result.session_file_mtime,
+        // Every session arrives counted (BLI-4341). Absent only when the file
+        // could not be read at all, which is the one case the server's extraction
+        // pass still has to cover.
+        ...(result.session_facts ? { session_facts: result.session_facts } : {}),
         ...(result.worktree
             ? {
                 repo_fingerprint: result.worktree.repo_fingerprint,

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

@@ -2,7 +2,8 @@
  * The commands that manage this machine's account or watch the pipeline
  * rather than carry on a conversation: `cockpit scout`, `cockpit ops`,
  * `cockpit slack`, `cockpit settings`, `cockpit team`, and `cockpit model`.
- * Split out of local-args-tower.ts (BLI-3636).
+ * Split out of local-args-tower.ts (BLI-3636); the `settings` sections moved
+ * once more, into `./local-args-tower-settings.js`, and are re-exported below.
  *
  * Every parser moved verbatim: same flags, same defaults, same refusal
  * sentences. The two constants this family publishes
@@ -11,6 +12,12 @@
  */
 import { optionalEmail, optionalNonEmpty, optionalPositiveInteger, optionalUrl, parseNamedArgs, } from "./local-arg-values.js";
 import { isTeamDeviceRevokeReasonLabel, TEAM_DEVICE_REVOKE_REASON_LABELS, } from "./team-device-reasons.js";
+/**
+ * `cockpit settings` has its own file: five sections, one set of rules each.
+ * It is re-exported here because this is the address every caller imports it
+ * from.
+ */
+export { parseSettingsArgs } from "./local-args-tower-settings.js";
 /** The shortest prefix `cockpit scout start` will resolve. Below this, ids collide. */
 export const SCOUT_MIN_PREFIX_LENGTH = 6;
 /**
@@ -220,156 +227,6 @@ export function parseSlackArgs(args) {
         ...base,
     };
 }
-const SETTINGS_SECTIONS = ["personal", "switches", "models", "env", "cli-floor"];
-/**
- * `cockpit settings [section] [verb] [args]` (BLI-3461).
- *
- * The flag set is the UNION across sections and the combinations are checked
- * afterwards, per section — the same shape `parseDoctorArgs` uses. A flag that
- * belongs to another section is refused by name rather than silently ignored,
- * because a dropped `--project` on an env write is a change a person believes
- * they made.
- */
-export function parseSettingsArgs(args) {
-    const values = parseNamedArgs(args, {
-        allowedFlags: [
-            "--home",
-            "--dashboard-url",
-            "--json",
-            "--chat-model",
-            "--brief-model",
-            "--chat",
-            "--memory",
-            "--project",
-            "--file",
-            "--id",
-            "--content-stdin",
-            "--yes",
-        ],
-        valueFlags: [
-            "--home",
-            "--dashboard-url",
-            "--chat-model",
-            "--brief-model",
-            "--chat",
-            "--memory",
-            "--project",
-            "--file",
-            "--id",
-        ],
-    });
-    const [rawSection, ...rest] = values.positionals;
-    const common = {
-        homeDir: optionalNonEmpty(values.flags.get("--home")),
-        dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
-        yes: values.booleans.has("--yes"),
-        json: values.booleans.has("--json"),
-    };
-    if (!rawSection) {
-        if (rest.length > 0)
-            throw new Error("settings does not accept that argument.");
-        return { kind: "settings", section: "overview", action: "show", ...common };
-    }
-    if (!SETTINGS_SECTIONS.includes(rawSection)) {
-        throw new Error(`settings section must be one of ${SETTINGS_SECTIONS.join(", ")} — or nothing, for all of them.`);
-    }
-    const section = rawSection;
-    if (section === "personal") {
-        if (rest.length > 0)
-            throw new Error("settings personal does not accept positional arguments.");
-        const chatModel = optionalNonEmpty(values.flags.get("--chat-model"));
-        const briefModel = optionalNonEmpty(values.flags.get("--brief-model"));
-        return {
-            kind: "settings",
-            section,
-            action: chatModel || briefModel ? "set" : "show",
-            chatModel,
-            briefModel,
-            ...common,
-        };
-    }
-    if (section === "switches") {
-        if (rest.length === 0) {
-            return { kind: "settings", section, action: "show", ...common };
-        }
-        if (rest[0] !== "set") {
-            throw new Error("settings switches takes no verb, or `set <key> <value>`.");
-        }
-        const [, key, value, ...extra] = rest;
-        if (!key || !value || extra.length > 0) {
-            throw new Error("settings switches set needs exactly a key and a value.");
-        }
-        return { kind: "settings", section, action: "set", switchKey: key, switchValue: value, ...common };
-    }
-    /**
-     * BLI-3557: `settings cli-floor` shows the fleet forced-update floor,
-     * `settings cli-floor <version>` raises it. There is no `set` verb because
-     * there is nothing else to do to a floor, and no flag for the version because
-     * a bare positional is how a release says it: `cockpit settings cli-floor
-     * 0.2.48`. The server refuses a LOWER version; the terminal does not
-     * second-guess that decision locally.
-     */
-    if (section === "cli-floor") {
-        if (rest.length === 0) {
-            return { kind: "settings", section, action: "show", ...common };
-        }
-        const [version, ...extra] = rest;
-        if (!version || extra.length > 0) {
-            throw new Error("settings cli-floor takes no argument, or one version: `cli-floor 0.2.48`.");
-        }
-        return { kind: "settings", section, action: "set", floorVersion: version, ...common };
-    }
-    if (section === "models") {
-        if (rest.length === 0) {
-            return { kind: "settings", section, action: "show", ...common };
-        }
-        if (rest[0] !== "set" || rest.length > 1) {
-            throw new Error("settings models takes no verb, or `set --chat <key>` / `set --memory <id>`.");
-        }
-        const orgChatModel = optionalNonEmpty(values.flags.get("--chat"));
-        const orgMemoryModel = optionalNonEmpty(values.flags.get("--memory"));
-        if (!orgChatModel && !orgMemoryModel) {
-            throw new Error("settings models set needs --chat <key>, --memory <id>, or both.");
-        }
-        return { kind: "settings", section, action: "set", orgChatModel, orgMemoryModel, ...common };
-    }
-    // env
-    const verb = rest[0] ?? "list";
-    if (rest.length > 1)
-        throw new Error("settings env takes one verb: list, set, or delete.");
-    if (verb === "list") {
-        return { kind: "settings", section, action: "list", ...common };
-    }
-    if (verb === "set") {
-        const envProject = optionalNonEmpty(values.flags.get("--project"));
-        const envFile = optionalNonEmpty(values.flags.get("--file"));
-        if (!envProject || !envFile) {
-            throw new Error("settings env set needs --project <project> and --file <file name>.");
-        }
-        if (!values.booleans.has("--content-stdin")) {
-            // Deliberate: there is no `--content <value>` flag and never will be. A
-            // secret on a command line lands in shell history and in every process
-            // listing on the machine.
-            throw new Error("settings env set reads the file contents from stdin: add --content-stdin and pipe the file in.");
-        }
-        return {
-            kind: "settings",
-            section,
-            action: "set",
-            envProject,
-            envFile,
-            contentStdin: true,
-            ...common,
-        };
-    }
-    if (verb === "delete") {
-        const envId = optionalNonEmpty(values.flags.get("--id"));
-        if (!envId)
-            throw new Error("settings env delete needs --id <uuid>.");
-        return { kind: "settings", section, action: "delete", envId, ...common };
-    }
-    throw new Error("settings env takes one verb: list, set, or delete.");
-}
 /**
  * `cockpit team [members|invite <email>|role <userId>|device list|device
  * revoke <id|name>]` (BLI-3461; `device` added BLI-3559).

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

@@ -0,0 +1,186 @@
+/**
+ * What a person may type at `cockpit settings` (BLI-3461), split out of
+ * local-args-tower-admin.ts by section so each section's rules fit on one
+ * screen. Every flag, default and refusal sentence moved verbatim;
+ * `parseSettingsArgs` is still exported from `./local-args-tower-admin.js`,
+ * the address it has always had.
+ *
+ * The flag set is the UNION across sections and the combinations are checked
+ * afterwards, per section — the same shape `parseDoctorArgs` uses. A flag that
+ * belongs to another section is refused by name rather than silently ignored,
+ * because a dropped `--project` on an env write is a change a person believes
+ * they made.
+ */
+import { optionalNonEmpty, optionalUrl, parseNamedArgs } from "./local-arg-values.js";
+const SETTINGS_SECTIONS = ["personal", "switches", "models", "env", "cli-floor"];
+/** `cockpit settings [section] [verb] [args]`: the section picker. */
+export function parseSettingsArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: [
+            "--home",
+            "--dashboard-url",
+            "--json",
+            "--chat-model",
+            "--brief-model",
+            "--chat",
+            "--memory",
+            "--project",
+            "--file",
+            "--id",
+            "--content-stdin",
+            "--yes",
+        ],
+        valueFlags: [
+            "--home",
+            "--dashboard-url",
+            "--chat-model",
+            "--brief-model",
+            "--chat",
+            "--memory",
+            "--project",
+            "--file",
+            "--id",
+        ],
+    });
+    const [rawSection, ...rest] = values.positionals;
+    const common = {
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
+        yes: values.booleans.has("--yes"),
+        json: values.booleans.has("--json"),
+    };
+    if (!rawSection) {
+        if (rest.length > 0)
+            throw new Error("settings does not accept that argument.");
+        return { kind: "settings", section: "overview", action: "show", ...common };
+    }
+    if (!SETTINGS_SECTIONS.includes(rawSection)) {
+        throw new Error(`settings section must be one of ${SETTINGS_SECTIONS.join(", ")} — or nothing, for all of them.`);
+    }
+    switch (rawSection) {
+        case "personal":
+            return parsePersonalSection(rest, values.flags, common);
+        case "switches":
+            return parseSwitchesSection(rest, common);
+        case "cli-floor":
+            return parseCliFloorSection(rest, common);
+        case "models":
+            return parseModelsSection(rest, values.flags, common);
+        case "env":
+            return parseEnvSection(rest, values.flags, values.booleans, common);
+    }
+}
+/** `settings personal [--chat-model <key>] [--brief-model <key>]`. */
+function parsePersonalSection(rest, flags, common) {
+    if (rest.length > 0)
+        throw new Error("settings personal does not accept positional arguments.");
+    const chatModel = optionalNonEmpty(flags.get("--chat-model"));
+    const briefModel = optionalNonEmpty(flags.get("--brief-model"));
+    return {
+        kind: "settings",
+        section: "personal",
+        action: chatModel || briefModel ? "set" : "show",
+        chatModel,
+        briefModel,
+        ...common,
+    };
+}
+/** `settings switches` or `settings switches set <key> <value>`. */
+function parseSwitchesSection(rest, common) {
+    if (rest.length === 0) {
+        return { kind: "settings", section: "switches", action: "show", ...common };
+    }
+    if (rest[0] !== "set") {
+        throw new Error("settings switches takes no verb, or `set <key> <value>`.");
+    }
+    const [, key, value, ...extra] = rest;
+    if (!key || !value || extra.length > 0) {
+        throw new Error("settings switches set needs exactly a key and a value.");
+    }
+    return {
+        kind: "settings",
+        section: "switches",
+        action: "set",
+        switchKey: key,
+        switchValue: value,
+        ...common,
+    };
+}
+/**
+ * BLI-3557: `settings cli-floor` shows the fleet forced-update floor,
+ * `settings cli-floor <version>` raises it. There is no `set` verb because
+ * there is nothing else to do to a floor, and no flag for the version because
+ * a bare positional is how a release says it: `cockpit settings cli-floor
+ * 0.2.48`. The server refuses a LOWER version; the terminal does not
+ * second-guess that decision locally.
+ */
+function parseCliFloorSection(rest, common) {
+    if (rest.length === 0) {
+        return { kind: "settings", section: "cli-floor", action: "show", ...common };
+    }
+    const [version, ...extra] = rest;
+    if (!version || extra.length > 0) {
+        throw new Error("settings cli-floor takes no argument, or one version: `cli-floor 0.2.48`.");
+    }
+    return { kind: "settings", section: "cli-floor", action: "set", floorVersion: version, ...common };
+}
+/** `settings models` or `settings models set --chat <key> / --memory <id>`. */
+function parseModelsSection(rest, flags, common) {
+    if (rest.length === 0) {
+        return { kind: "settings", section: "models", action: "show", ...common };
+    }
+    if (rest[0] !== "set" || rest.length > 1) {
+        throw new Error("settings models takes no verb, or `set --chat <key>` / `set --memory <id>`.");
+    }
+    const orgChatModel = optionalNonEmpty(flags.get("--chat"));
+    const orgMemoryModel = optionalNonEmpty(flags.get("--memory"));
+    if (!orgChatModel && !orgMemoryModel) {
+        throw new Error("settings models set needs --chat <key>, --memory <id>, or both.");
+    }
+    return {
+        kind: "settings",
+        section: "models",
+        action: "set",
+        orgChatModel,
+        orgMemoryModel,
+        ...common,
+    };
+}
+/** `settings env [list|set --project <p> --file <f> --content-stdin|delete --id <uuid>]`. */
+function parseEnvSection(rest, flags, booleans, common) {
+    const verb = rest[0] ?? "list";
+    if (rest.length > 1)
+        throw new Error("settings env takes one verb: list, set, or delete.");
+    if (verb === "list") {
+        return { kind: "settings", section: "env", action: "list", ...common };
+    }
+    if (verb === "set") {
+        const envProject = optionalNonEmpty(flags.get("--project"));
+        const envFile = optionalNonEmpty(flags.get("--file"));
+        if (!envProject || !envFile) {
+            throw new Error("settings env set needs --project <project> and --file <file name>.");
+        }
+        if (!booleans.has("--content-stdin")) {
+            // Deliberate: there is no `--content <value>` flag and never will be. A
+            // secret on a command line lands in shell history and in every process
+            // listing on the machine.
+            throw new Error("settings env set reads the file contents from stdin: add --content-stdin and pipe the file in.");
+        }
+        return {
+            kind: "settings",
+            section: "env",
+            action: "set",
+            envProject,
+            envFile,
+            contentStdin: true,
+            ...common,
+        };
+    }
+    if (verb === "delete") {
+        const envId = optionalNonEmpty(flags.get("--id"));
+        if (!envId)
+            throw new Error("settings env delete needs --id <uuid>.");
+        return { kind: "settings", section: "env", action: "delete", envId, ...common };
+    }
+    throw new Error("settings env takes one verb: list, set, or delete.");
+}

package/dist/commands/onboard-report-blockers.js

@@ -0,0 +1,58 @@
+import { writeLine } from "./cli-io.js";
+import { COLLECTION_ROOT_REQUIRED, missingCollectionRootMessage, } from "../onboarding-roots.js";
+export function writeOnboardAutostartBlocker(io, result) {
+    writeLine(io.stderr, "BLOCKED: initial collection succeeded, but recurring background collection is not running.");
+    if (result?.message)
+        writeLine(io.stderr, `Failure: ${result.message}`);
+    writeLine(io.stderr, "Next: run `cockpit autostart install`, then require `cockpit autostart status --json` to exit 0.");
+}
+/**
+ * The blocked-backfill result, identical in both onboarding arms. `extra`
+ * carries the arm-specific keys and is spread where those keys appeared before,
+ * so the `--json` key order is unchanged.
+ */
+export function writeOnboardBackfillBlockedResult(io, options) {
+    if (!options.json) {
+        writeOnboardBackfillBlocker(io, options.backfill);
+        return;
+    }
+    writeLine(io.stdout, JSON.stringify({
+        ...options.base,
+        ...options.extra,
+        backfill: onboardBackfillPayload(options.backfill),
+        blocker: "backfill_incomplete",
+        backfill_failure_reason: options.backfill.failureReason,
+        next_step: options.backfill.retryCommand,
+    }, null, 2));
+}
+function writeOnboardBackfillBlocker(io, outcome) {
+    writeLine(io.stderr, "BLOCKED: all-history Codex and Claude backfill is incomplete for the approved collection roots.");
+    writeLine(io.stderr, `Failure: ${outcome.failureReason ?? `backfill_${outcome.status}`}`);
+    writeLine(io.stderr, `Retry: ${outcome.retryCommand}`);
+}
+function onboardBackfillPayload(outcome) {
+    return (outcome.result ?? {
+        status: "blocked",
+        failure_reason: outcome.failureReason,
+        retry_command: outcome.retryCommand,
+    });
+}
+export function nextStepForOnboardBlocker(blocker, options = {}) {
+    switch (blocker) {
+        case COLLECTION_ROOT_REQUIRED:
+            return missingCollectionRootMessage(options);
+        case "ticket":
+        case "ticket_binding":
+            return "Run `cockpit start --ticket <id>` when actual ticket work begins, then run `cockpit sync`.";
+        case "device_pairing":
+            return "Ask Edward to approve this machine in the dashboard under Ambient -> Collector approvals, then run `cockpit doctor` again.";
+        case "network_or_ingest":
+            return "Check dashboard URL/network, then run `cockpit doctor`.";
+        case "install":
+            return "Rerun `cockpit doctor` from the repo root; it will reinstall local config.";
+        case "work_context":
+            return "Run `cockpit start --ticket <id> --workspace \"$PWD\"`, then retry `cockpit sync`.";
+        default:
+            return "Run `cockpit status --json` and report the blocker label plus last failure reason.";
+    }
+}

package/dist/commands/onboard-report.js

@@ -1,6 +1,7 @@
 import { writeLine } from "./cli-io.js";
 import { attributedSyncRunStatus, displayTicketId, rawEvidenceSyncLine, writeAgentSessionSummary, } from "./collection-report.js";
-import { COLLECTION_ROOT_REQUIRED, missingCollectionRootMessage, } from "../onboarding-roots.js";
+import { writeOnboardAutostartBlocker } from "./onboard-report-blockers.js";
+export { nextStepForOnboardBlocker, writeOnboardAutostartBlocker, writeOnboardBackfillBlockedResult, } from "./onboard-report-blockers.js";
 export function writeOnboardBanner(command, io) {
     writeLine(io.stdout, "Setting up Tower");
     writeLine(io.stdout, `Dashboard: ${command.dashboardUrl}`);
@@ -54,43 +55,6 @@ export function onboardAgentRulesInstallLine(result) {
             return "not installed.";
     }
 }
-export function writeOnboardAutostartBlocker(io, result) {
-    writeLine(io.stderr, "BLOCKED: initial collection succeeded, but recurring background collection is not running.");
-    if (result?.message)
-        writeLine(io.stderr, `Failure: ${result.message}`);
-    writeLine(io.stderr, "Next: run `cockpit autostart install`, then require `cockpit autostart status --json` to exit 0.");
-}
-/**
- * The blocked-backfill result, identical in both onboarding arms. `extra`
- * carries the arm-specific keys and is spread where those keys appeared before,
- * so the `--json` key order is unchanged.
- */
-export function writeOnboardBackfillBlockedResult(io, options) {
-    if (!options.json) {
-        writeOnboardBackfillBlocker(io, options.backfill);
-        return;
-    }
-    writeLine(io.stdout, JSON.stringify({
-        ...options.base,
-        ...options.extra,
-        backfill: onboardBackfillPayload(options.backfill),
-        blocker: "backfill_incomplete",
-        backfill_failure_reason: options.backfill.failureReason,
-        next_step: options.backfill.retryCommand,
-    }, null, 2));
-}
-function writeOnboardBackfillBlocker(io, outcome) {
-    writeLine(io.stderr, "BLOCKED: all-history Codex and Claude backfill is incomplete for the approved collection roots.");
-    writeLine(io.stderr, `Failure: ${outcome.failureReason ?? `backfill_${outcome.status}`}`);
-    writeLine(io.stderr, `Retry: ${outcome.retryCommand}`);
-}
-function onboardBackfillPayload(outcome) {
-    return (outcome.result ?? {
-        status: "blocked",
-        failure_reason: outcome.failureReason,
-        retry_command: outcome.retryCommand,
-    });
-}
 /**
  * Every onboard `--json` payload is `onboardResult` plus the roots this pass
  * resolved plus whatever extra keys that arm of onboarding adds. Assembling it
@@ -129,25 +93,6 @@ function onboardResult(resultStatus, command, install, pair, sync, status) {
         next_dashboard_path: `${command.dashboardUrl}/my-work`,
     };
 }
-export function nextStepForOnboardBlocker(blocker, options = {}) {
-    switch (blocker) {
-        case COLLECTION_ROOT_REQUIRED:
-            return missingCollectionRootMessage(options);
-        case "ticket":
-        case "ticket_binding":
-            return "Run `cockpit start --ticket <id>` when actual ticket work begins, then run `cockpit sync`.";
-        case "device_pairing":
-            return "Ask Edward to approve this machine in the dashboard under Ambient -> Collector approvals, then run `cockpit doctor` again.";
-        case "network_or_ingest":
-            return "Check dashboard URL/network, then run `cockpit doctor`.";
-        case "install":
-            return "Rerun `cockpit doctor` from the repo root; it will reinstall local config.";
-        case "work_context":
-            return "Run `cockpit start --ticket <id> --workspace \"$PWD\"`, then retry `cockpit sync`.";
-        default:
-            return "Run `cockpit status --json` and report the blocker label plus last failure reason.";
-    }
-}
 /** Step 3 of a single-repo onboard: the work context this machine just bound. */
 export function writeOnboardWorkContextStarted(io, context) {
     writeLine(io.stdout, "3/5 Work context active.");

package/dist/commands/ops-render-ladder.js

@@ -0,0 +1,25 @@
+/**
+ * The LADDER block: the queue every session joins at ingest, and what the
+ * Railway drainer has done with it. Failures are grouped by the reason the
+ * rung named itself with, because "12 failed" sends nobody anywhere.
+ */
+export function renderLadder(ladder, dim) {
+    const lines = ["", `LADDER  ${ladder.summary ?? "(no summary)"}`];
+    if (ladder.readError) {
+        lines.push(`  queue not read (${ladder.readError})`);
+        return lines;
+    }
+    const reasons = Object.entries(ladder.failed_by_reason ?? {}).sort((left, right) => right[1] - left[1]);
+    for (const [reason, count] of reasons.slice(0, 8)) {
+        lines.push(dim(`  ${String(count).padStart(5)}  ${reason}`));
+    }
+    if (reasons.length > 8)
+        lines.push(dim(`  ${reasons.length - 8} more reasons not shown`));
+    if ((ladder.stale_leases ?? 0) > 0) {
+        lines.push(dim(`  ${ladder.stale_leases} stale lease(s) waiting to be taken over`));
+    }
+    if (ladder.oldest_pending_session_id) {
+        lines.push(dim(`  oldest pending session ${ladder.oldest_pending_session_id}`));
+    }
+    return lines;
+}

package/dist/commands/ops-render.js

@@ -16,7 +16,12 @@ import { renderCoverageBuckets, } from "./ops-render-coverage.js";
 // BLI-3909: today's spend by model, its own renderer for the same reason the
 // coverage table has one — this file is at the repo's readability floor.
 import { renderSpend } from "./ops-render-spend.js";
+// BLI-4341: the ladder queue block, its own renderer for the same reason the
+// coverage table and the spend section have one: this file is at the repo's
+// readability floor.
+import { renderLadder } from "./ops-render-ladder.js";
 export { renderSpend } from "./ops-render-spend.js";
+export { renderLadder } from "./ops-render-ladder.js";
 export { renderMemoryHooks, renderMemoryUsage } from "./ops-render-memory.js";
 export { renderCoverageBuckets };
 /** The word a person reads. Short, fixed width, and never a bare colour. */
@@ -134,6 +139,8 @@ options = {}) {
     }
     if (payload.spend)
         lines.push(...renderSpend(payload.spend, dim));
+    if (payload.ladder)
+        lines.push(...renderLadder(payload.ladder, dim));
     const slack = payload.skips?.slack;
     const external = payload.skips?.external;
     if (slack || external) {