@bli-cockpit/cli 0.2.179 → 0.2.180

package/dist/commands/brain.js

@@ -0,0 +1,35 @@
+import { askAgentDoor, emitAgentDoor, failAgentDoor, openAgentDoor } from "./agent-door.js";
+import { writeLine } from "./cli-io.js";
+const TAG = "[brain cli]";
+const READ_DEADLINE_MS = 55_000;
+export async function runBrain(command, io) {
+    let door;
+    try {
+        door = await openAgentDoor("brain", command, io);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : "this machine is not paired with Tower";
+        writeLine(io.stderr, `${TAG} refused ${JSON.stringify({ reason: "not_paired" })}`);
+        if (command.json)
+            writeLine(io.stdout, JSON.stringify({ ok: false, error: "not_paired", detail }));
+        else
+            writeLine(io.stderr, detail);
+        return 1;
+    }
+    const query = new URLSearchParams();
+    if (command.project)
+        query.set("project", command.project);
+    if (command.show)
+        query.set("status", command.show);
+    const asked = query.toString();
+    const path = asked ? `/api/brain/incidents?${asked}` : "/api/brain/incidents";
+    const answer = await askAgentDoor(door, { path, method: "GET", label: "brain status", timeoutMs: READ_DEADLINE_MS });
+    if (!answer.ok)
+        return failAgentDoor(door, TAG, answer.reason, answer.detail);
+    const body = answer.body;
+    writeLine(io.stderr, `${TAG} status read ${JSON.stringify({ projects: body.projects.length, rows: body.coverage.rows, pages: body.coverage.pages, end: body.coverage.end })}`);
+    if (command.json)
+        return emitAgentDoor(door, body);
+    writeLine(io.stdout, body.text);
+    return 0;
+}

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

@@ -0,0 +1,38 @@
+/**
+ * `cockpit brain` argument parsing (BLI-12859).
+ *
+ *   cockpit brain status [--project <id>] [--show open|running|needs_human|fixed|not_actionable|cleared] [--json]
+ *
+ * Tower's incident queue: per project, how many incidents are open, being worked, waiting on a
+ * person, fixed, not actionable or cleared, the newest ones with their Tower issue, and the last
+ * 7 days of verdicts. It reads `GET /api/brain/incidents` with this machine's device token.
+ */
+import { LOG_PROJECT_PATTERN } from "@bli-cockpit/telemetry-core/log-digest";
+import { optionalNonEmpty, optionalUrl, parseNamedArgs } from "./local-arg-values.js";
+/** The statuses the queue's door accepts for `--show`; the migration's CHECK constraint is the other copy. */
+export const BRAIN_SHOW_STATUSES = ["open", "running", "needs_human", "fixed", "not_actionable", "cleared"];
+export function parseBrainArgs(args) {
+    const values = parseNamedArgs(args, {
+        allowedFlags: ["--project", "--show", "--home", "--dashboard-url", "--json"],
+        valueFlags: ["--project", "--show", "--home", "--dashboard-url"],
+    });
+    const action = values.positionals[0];
+    if (action !== "status" || values.positionals.length > 1) {
+        throw new Error("brain takes one verb: `status`. Example: `cockpit brain status` or `cockpit brain status --project pearl-portal`.");
+    }
+    const project = optionalNonEmpty(values.flags.get("--project"));
+    if (project && !LOG_PROJECT_PATTERN.test(project))
+        throw new Error("--project wants a registry project id like pearl-portal (`cockpit logs --list` names them).");
+    const show = optionalNonEmpty(values.flags.get("--show"));
+    if (show && !BRAIN_SHOW_STATUSES.includes(show))
+        throw new Error(`--show wants one of ${BRAIN_SHOW_STATUSES.join(", ")}.`);
+    return {
+        kind: "brain",
+        action: "status",
+        ...(project ? { project } : {}),
+        ...(show ? { show } : {}),
+        dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        json: values.booleans.has("--json"),
+    };
+}

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

@@ -39,5 +39,6 @@ export { parseMailArgs } from "./local-args-tower-mail.js";
 export { parseCalArgs } from "./local-args-tower-cal.js";
 export { parseUsageArgs } from "./local-args-tower-usage.js";
 export { parseLogsArgs } from "./local-args-tower-logs.js";
+export { parseBrainArgs } from "./local-args-tower-brain.js";
 export { parseCareersArgs } from './local-args-tower-careers.js';
 export { parseRenameArgs } from './local-args-tower-rename.js';

package/dist/commands/local-args.js

@@ -18,7 +18,7 @@
 import { parseRootsArgs } from "./roots.js";
 import { SURFACE_ALIASES } from "./local-help.js";
 import { parseAgentRulesArgs, parseAnalyzeArgs, parseAutostartArgs, parseBackfillArgs, parseCleanArgs, parseDoctorArgs, parseInstallArgs, parseLoginArgs, parseMemoryArgs, parseLogoutArgs, parseOnboardArgs, parseReleaseArgs, parseServeArgs, parseSessionsArgs, parseSourcesArgs, parseStartArgs, parseStatusArgs, parseSyncArgs, parseUpdateArgs, } from "./local-args-collector.js";
-import { parseBriefArgs, parseCorrectArgs, parseDocsArgs, parseIssueArgs, parseJarvisArgs, parseMailArgs, parseCalArgs, parseModelArgs, parseMsgArgs, parseNotesArgs, parseOpsArgs, parseProjectArgs, parseModelsArgs, parseScoutArgs, parseGithubArgs, parseSearchArgs, parseSettingsArgs, parseSlackArgs, parseTeamArgs, parseWorkbookArgs, parseUsageArgs, parseLogsArgs, parseCareersArgs, parseRenameArgs, } from "./local-args-tower.js";
+import { parseBriefArgs, parseCorrectArgs, parseDocsArgs, parseIssueArgs, parseJarvisArgs, parseMailArgs, parseCalArgs, parseModelArgs, parseMsgArgs, parseNotesArgs, parseOpsArgs, parseProjectArgs, parseModelsArgs, parseScoutArgs, parseGithubArgs, parseSearchArgs, parseSettingsArgs, parseSlackArgs, parseTeamArgs, parseWorkbookArgs, parseUsageArgs, parseLogsArgs, parseBrainArgs, parseCareersArgs, parseRenameArgs, } from "./local-args-tower.js";
 // `normalizeUrl` has always been part of this module's surface — `local.ts` and
 // `local-auth.ts` import it from here — so it stays exported from this address
 // even though it now lives next door. The same goes for the four names the
@@ -135,6 +135,8 @@ export function parseLocalArgs(argv) {
             return parseUsageArgs(argv.slice(1));
         case "logs":
             return parseLogsArgs(argv.slice(1));
+        case "brain":
+            return parseBrainArgs(argv.slice(1));
         default:
             throw new Error(`Unknown local command: ${command ?? ""}`);
     }

package/dist/commands/local-command-shapes-brain.js

@@ -0,0 +1,5 @@
+/**
+ * `cockpit brain` command shape (BLI-12859), beside `local-command-shapes-logs.ts` for the same
+ * reason: `local-command-shapes.ts` sits at the readability ceiling.
+ */
+export {};

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

@@ -44,6 +44,23 @@ export const TOWER_OPS_COMMAND_HELP = [
             "The bli-tower MCP server has the twin: logs_digest.",
         ],
     ],
+    [
+        "brain",
+        [
+            "Usage: cockpit brain status [--project <id>] [--show open|running|needs_human|fixed|not_actionable|cleared] [--dashboard-url <url>] [--json]",
+            "",
+            "Tower's incident queue. Every 15 minutes the log-digest cron turns each recurring problem in a project's logs (classes",
+            "our_bug, config_drift, capacity, unknown) into ONE incident with ONE Tower issue; a repeat adds to its count, never a twin.",
+            "A template quiet for 24 hours is marked cleared. This prints, per project, how many incidents are open, being worked,",
+            "waiting on a person, fixed, not actionable or cleared, the newest ones in the --show status (default open) with their Tower",
+            "issue, how often each was seen and what it said, and the last 7 days of verdicts. Needs only this machine's Tower login.",
+            "--project <id>   one project (`cockpit logs --list` names them).",
+            "--show <status>  list the newest incidents in that status instead of open.",
+            "--json writes one object to stdout: { ok, generated_at, projects[{ project, counts, incidents[], verdicts_7d }], totals, coverage, text };",
+            "a refusal is { ok: false, error, detail } and exits 1 (unknown_project, invalid_status, stored_read_failed, not_paired, ...).",
+            "Teaching: docs/architecture/tower-brain.md. The bli-tower MCP server has the twin: brain_status.",
+        ],
+    ],
     [
         "github",
         [

package/dist/commands/local-help.js

@@ -79,6 +79,7 @@ export const rootCommandNames = new Set([
     "rename",
     "usage",
     "logs",
+    "brain",
     ...SURFACE_ALIASES.keys(),
 ]);
 /** Public names omit compatibility spellings while the router keeps accepting them. */
@@ -134,6 +135,7 @@ export function localCommandHelp(command) {
         "  cockpit careers [list|show <id>|rescreen <id>|send-takehome <id>|decide <id> --decision <passed_on|archived|reopen>|followup <id> [--record-sent-at <iso>]|interview <id> <--at <iso>|--clear>|grade <id> [--now]|resume <id> [--out <path>]|takehome show <role>|takehome set <role> --body-file <path>|settings show|settings set --enabled <true|false> --followup-enabled <true|false> --followup-after-days <n> --takehome-window-hours <n>] [--role <slug>] [--min-score <n>] [--since <date>] [--stage <s>] [--force] [--json]",
         "  cockpit rename [list|resolve <id> --scope <page|everywhere|undo>] [--dashboard-url <url>] [--json]",
         "  cockpit logs <collector|dashboard|railway|railway:<service>|-> [--since 15m|1h|2d|<iso>] [--raw <template-id> [--limit <n>]] [--all-levels] [--table <file>] [--json]",
+        "  cockpit brain status [--project <id>] [--show open|running|needs_human|fixed|not_actionable|cleared] [--dashboard-url <url>] [--json]",
         "  cockpit usage sessions [--task <BLI-NNNN> | --subject <name>] [--repo <label>] [--since <window>] [--json]",
         "  cockpit usage sessions --session <id> [--from-window <n>] [--json]",
         "  --by-topic groups work types; --by-subject groups open subjects from session summaries.",

package/dist/commands/local.js

@@ -50,6 +50,7 @@ import { runCareers } from "./careers.js";
 import { runRename } from "./rename-scope.js";
 import { runUsage } from "./usage.js";
 import { runLogs } from "./logs.js";
+import { runBrain } from "./brain.js";
 import { parseLocalArgs } from "./local-args.js";
 // `./local.js` is the published entry point for this command surface: the
 // public CLI's generated root, commands/root.ts, doctor.ts and the test suite
@@ -245,6 +246,8 @@ export async function runLocalCockpitCli(argv, io = defaultIo()) {
                 return await runUsage(command, io);
             case "logs":
                 return await runLogs(command, io);
+            case "brain":
+                return await runBrain(command, io);
         }
     }
     catch (error) {

package/dist/commands/public-root.js

@@ -21,7 +21,7 @@ export async function runCockpitCli(argv, io) {
   }
 
   if (command === "--version" || command === "-V" || command === "version") {
-    writeLine(io?.stdout ?? process.stdout, "0.2.179");
+    writeLine(io?.stdout ?? process.stdout, "0.2.180");
     return 0;
   }
 

package/dist/commands/status.js

@@ -80,7 +80,7 @@ async function writeMultiRepoStatus(command, io, backfillCursor, setupReceipt, w
     writeLine(io.stdout, `Old sessions: ${backfillCursorLine(backfillCursor)}`);
     writeLine(io.stdout, await statusDiskLine(command.homeDir));
     for (const status of statuses) {
-        writeLine(io.stdout, `- ${status.repo_label ?? status.repo}/${status.worktree_label ?? "worktree"} · ${status.branch} · head:${shortSha(status.head_sha)} · ${status.upload_state}`);
+        writeLine(io.stdout, `- ${status.repo_label ?? status.repo}/${status.worktree_label ?? "worktree"} · ${status.branch} · head:${shortSha(status.head_sha)} · ${uploadsLine(status.upload_state)}`);
     }
     writeConnectedBlock(io, setupReceipt);
     return 0;

package/dist/local-state-status.js

@@ -53,6 +53,7 @@ export async function inspectLocalCollectorStatus(options = {}) {
         oldest_pending_health_receipt_at: healthOutbox.oldest_created_at,
         last_health_receipt_failure_reason: healthOutbox.last_failure_reason,
         stuck_evidence_object_count: stuckEvidence.stuck_object_count,
+        stuck_evidence_ghost_record_count: stuckEvidence.ghost_record_count,
         stuck_evidence_held_count: stuckEvidence.held_object_count,
         stuck_evidence_max_attempts: stuckEvidence.max_attempts,
         stuck_evidence_oldest_failure_at: stuckEvidence.oldest_first_failed_at,
@@ -148,7 +149,7 @@ function describeCollectorStatus(reading) {
         details.push(`Last upload failure: ${uploadSpool.last_upload_failure_reason}.`);
     }
     if (uploadSpool.pending_upload_count > 0) {
-        details.push(`Upload retry pending: ${uploadSpool.pending_upload_count} safe metadata record(s) spooled. Run \`${uploadSpool.retry_command ?? "cockpit sync"}\` to retry.`);
+        details.push(`Upload retry pending: ${uploadSpool.pending_upload_count} safe metadata record(s) are saved on this machine and go out on the next background sync.`);
     }
     if (healthOutbox.pending_count > 0) {
         details.push(`Collector health retry pending: ${healthOutbox.pending_count} sanitized receipt(s) queued since ${healthOutbox.oldest_created_at ?? "unknown"}.`);
@@ -168,6 +169,9 @@ function describeCollectorStatus(reading) {
     if (stuckEvidence.stuck_object_count > 0) {
         details.push(`Raw evidence stuck: ${stuckEvidence.stuck_object_count} object(s) have never been accepted (${stuckEvidence.held_object_count} waiting on backoff, worst ${stuckEvidence.max_attempts} attempt(s) since ${stuckEvidence.oldest_first_failed_at ?? "unknown"}) — reasons: ${stuckEvidence.reasons.join(", ") || "unknown"}.`);
     }
+    if (stuckEvidence.ghost_record_count > 0) {
+        details.push(`${stuckEvidence.ghost_record_count} old delivery record(s) have nothing left to send; no action needed.`);
+    }
     return details;
 }
 /**

package/dist/raw-evidence-stuck-summary.js

@@ -20,7 +20,26 @@ import { deliveryRetryAtMs, terminalDeliveryReason } from "./raw-evidence-stagin
  * read green while an object has been failing for nine days.
  */
 export function summarizeStuckEvidence(state, now) {
-    const entries = Object.values(state.delivery_attempts).filter(entry => !terminalDeliveryReason(entry.last_reason));
+    const entries = [];
+    let ghostCount = 0;
+    for (const [hash, entry] of Object.entries(state.delivery_attempts)) {
+        if (terminalDeliveryReason(entry.last_reason))
+            continue;
+        // A row whose object left staging (pruned after commit, or reconciled by a
+        // committed 409) has nothing to offer; counting it as stuck was BLI-12910.
+        if (!state.staged[hash]) {
+            ghostCount += 1;
+            continue;
+        }
+        entries.push(entry);
+    }
+    if (ghostCount > 0) {
+        console.error("[raw-evidence-stuck] delivery records with no staged object left out of the stuck count", JSON.stringify({
+            ghost_record_count: ghostCount,
+            stuck_object_count: entries.length,
+            reason: "object_no_longer_staged",
+        }));
+    }
     const reasons = new Set();
     let heldCount = 0;
     let maxAttempts = 0;
@@ -52,6 +71,7 @@ export function summarizeStuckEvidence(state, now) {
     return {
         stuck_object_count: entries.length,
         held_object_count: heldCount,
+        ghost_record_count: ghostCount,
         max_attempts: maxAttempts,
         oldest_first_failed_at: oldest,
         reasons: [...reasons].sort(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/cli",
-  "version": "0.2.179",
+  "version": "0.2.180",
   "private": false,
   "type": "module",
   "bin": {
@@ -27,9 +27,9 @@
     "test": "node dist/cli.js --help && node ../../scripts/assert-public-cli-routing.mjs && node ../../scripts/assert-public-cli-verb-help.mjs && node ../../scripts/assert-public-cli-surface-doors.mjs && node ../../scripts/assert-public-cli-runtime-files.mjs && node ../../scripts/assert-public-cli-exit-contract.mjs && node ../../scripts/assert-public-cli-no-fleet-posts.mjs && node ../../scripts/assert-public-cli-doctor-json.mjs && node ../../scripts/assert-public-package-pack.mjs --workspace=@bli-cockpit/cli"
   },
   "dependencies": {
-    "@bli-cockpit/memory-mcp": "0.1.52",
-    "@bli-cockpit/mcp": "0.1.94",
-    "@bli-cockpit/telemetry-core": "0.1.64"
+    "@bli-cockpit/memory-mcp": "0.1.53",
+    "@bli-cockpit/mcp": "0.1.95",
+    "@bli-cockpit/telemetry-core": "0.1.65"
   },
   "repository": {
     "type": "git",