@bli-cockpit/cli 0.2.197 → 0.2.198

package/dist/commands/brain.js

@@ -16,6 +16,18 @@ export async function runBrain(command, io) {
             writeLine(io.stderr, detail);
         return 1;
     }
+    if (command.action === "retry") {
+        const answer = await askAgentDoor(door, { path: "/api/brain/incidents/retry", method: "POST", label: "brain retry", timeoutMs: READ_DEADLINE_MS,
+            body: { ids: command.ids, all_needs_human: command.allNeedsHuman, project: command.project, reason: command.reason } });
+        if (!answer.ok)
+            return failAgentDoor(door, TAG, answer.reason, answer.detail);
+        const body = answer.body;
+        writeLine(io.stderr, `${TAG} retry answered ${JSON.stringify({ reason: body.reason, retried: body.retried.length, skipped: body.skipped.length, missing: body.missing.length, failures: body.failures.length })}`);
+        if (command.json)
+            return emitAgentDoor(door, body, body.ok ? 0 : 1);
+        writeLine(io.stdout, body.text);
+        return body.ok ? 0 : 1;
+    }
     const query = new URLSearchParams();
     if (command.project)
         query.set("project", command.project);

package/dist/commands/cal.js

@@ -25,7 +25,7 @@ import { runCalAddIcal, runCalDetach, runCalShare, runCalSync } from "./cal-cale
 import { runCalDelete } from "./cal-delete.js";
 import { runCalSyncStatus } from "./cal-sync-status.js";
 import { writeLine } from "./cli-io.js";
-import { cacheAgeLabel, readThroughCache } from "./read-cache.js";
+import { cacheAgeLabel, cacheCoverage, readThroughCache } from "./read-cache.js";
 const TAG = "[cal cli]";
 const READ_DEADLINE_MS = 30_000;
 const WRITE_DEADLINE_MS = 60_000;
@@ -118,7 +118,7 @@ async function window(command, door) {
         return failAgentDoor(door, TAG, answer.reason, answer.detail);
     const body = answer.body;
     if (door.json)
-        return emitAgentDoor(door, { ok: true, ...body });
+        return emitAgentDoor(door, { ok: true, ...body, ...cacheCoverage(answer) });
     if (answer.fromCache) {
         writeLine(door.io.stderr, `(${cacheAgeLabel(answer.ageMs ?? 0)}, refreshing in the background)`);
     }

package/dist/commands/docs-notion.js

@@ -47,8 +47,8 @@ export async function syncStatusDocs(command, door) {
     const body = answer.body;
     if (door.json) {
         return emitAgentDoor(door, {
+            ...answer.body,
             ok: true,
-            counts: body.counts,
             documents: body.documents ?? [],
             last_run: body.last_run ?? { push: null, pull: null },
         });
@@ -57,6 +57,8 @@ export async function syncStatusDocs(command, door) {
     for (const doc of documents) {
         writeLine(door.io.stdout, `${doc.id}  ${doc.state.padEnd(13)}  ${(doc.notion_synced_at ?? "never").padEnd(25)}  ${doc.slug ?? "(no slug)"}  ${doc.title}`);
     }
+    if (body.coverage)
+        writeLine(door.io.stdout, body.coverage);
     const byState = body.counts?.by_state ?? {};
     writeLine(door.io.stdout, "");
     writeLine(door.io.stdout, `${body.counts?.linked ?? documents.length} linked: ${Object.entries(byState)

package/dist/commands/docs.js

@@ -32,7 +32,7 @@ import { isInteractiveStdin, readPipedText, writeLine } from "./cli-io.js";
 import { readDoc } from "./docs-read.js";
 import { linkDoc, syncStatusDocs } from "./docs-notion.js";
 import { readNoteFile } from "./notes-file.js";
-import { cacheAgeLabel, readThroughCache } from "./read-cache.js";
+import { cacheAgeLabel, cacheCoverage, readThroughCache } from "./read-cache.js";
 const TAG = "[docs cli]";
 const READ_DEADLINE_MS = 30_000;
 const WRITE_DEADLINE_MS = 60_000;
@@ -97,10 +97,13 @@ async function listDocs(command, door) {
         return failAgentDoor(door, TAG, answer.reason, answer.detail);
     const documents = (answer.body.documents ?? []);
     if (door.json)
-        return emitAgentDoor(door, { ok: true, documents });
+        return emitAgentDoor(door, { ok: true, ...answer.body, documents, ...cacheCoverage(answer) });
     if (answer.fromCache) {
         writeLine(door.io.stderr, `(${cacheAgeLabel(answer.ageMs ?? 0)}, refreshing in the background)`);
     }
+    const counts = answer.body.counts;
+    if (counts)
+        writeLine(door.io.stdout, `${counts.total} documents match in all. ${counts.coverage}`);
     if (documents.length === 0) {
         writeLine(door.io.stdout, command.query ? `No document matches "${command.query}".` : "No documents.");
         return 0;

package/dist/commands/doctor-report.js

@@ -53,6 +53,7 @@ setupReceipt, repairs = []) {
             repairs,
             needs_person: needsPerson,
             setup_receipt: setupReceipt?.receipt ?? null,
+            setup_receipt_coverage: setupReceipt ? setupReceiptBlock(setupReceipt).join("; ") : "no data yet: no cached receipt",
             memory_install: setupReceipt?.memory ?? null,
         }, null, 2));
         return;

package/dist/commands/heartbeat.js

@@ -270,7 +270,7 @@ export async function sendCollectorHeartbeatBestEffort(options) {
     const heartbeat = buildCollectorHeartbeat({
         roots: options.roots,
         facts: options.facts,
-        setupReceipt: { ...(setupReceipt ?? { schema_version: "setup-receipt.v1", checked_at: new Date().toISOString(), browser: { status: "unknown" }, device: { status: "unknown" }, collector: { autostart: { status: "unknown" } } }), agent_setup: await collectAgentSetup(options.homeDir ?? os.homedir()) },
+        setupReceipt: setupReceipt ? { ...setupReceipt, agent_setup: await collectAgentSetup(options.homeDir ?? os.homedir()) } : null,
         ...(options.now ? { now: options.now } : {}),
         memoryInstall: memory.receipt,
     });

package/dist/commands/issue.js

@@ -28,7 +28,7 @@
 import { askAgentDoor, emitAgentDoor, failAgentDoor, openAgentDoor, } from "./agent-door.js";
 import { writeLine } from "./cli-io.js";
 import { assigneeLabel, beginAssigneeDirectoryFetch, finishAssigneeDirectory, withAssigneeIdentity } from "./issue-directory.js";
-import { cacheAgeLabel, readThroughCache } from "./read-cache.js";
+import { cacheAgeLabel, cacheCoverage, readThroughCache } from "./read-cache.js";
 import { showIssue } from "./issue-show.js";
 import { READ_DEADLINE_MS, TAG, resolveProjectId, sizeForEstimate, withSizeLabel, } from "./issue-contracts.js";
 import { commentIssue, createIssue, moveIssue, updateIssue } from "./issue-write.js";
@@ -154,11 +154,15 @@ async function listIssues(command, door) {
     if (door.json) {
         return emitAgentDoor(door, {
             ok: true,
+            ...(body.counts ? { counts: body.counts } : {}),
+            ...cacheCoverage(answer),
             issues: issues.map((issue) => withSizeLabel(withAssigneeIdentity(issue, directory))),
             ...(body.completeness ? { completeness: body.completeness } : {}),
             ...(body.outside_project ? { outside_project: body.outside_project } : {}),
         });
     }
+    if (body.counts)
+        writeLine(door.io.stdout, `${body.counts.total} match in all. ${body.counts.coverage}`);
     if (issues.length === 0) {
         writeLine(door.io.stdout, "No issues match that.");
         return 0;

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

@@ -13,12 +13,12 @@ import { optionalNonEmpty, optionalUrl, parseNamedArgs } from "./local-arg-value
 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"],
+        allowedFlags: ["--project", "--show", "--home", "--dashboard-url", "--json", "--all-needs-human", "--reason"],
+        valueFlags: ["--project", "--show", "--home", "--dashboard-url", "--reason"],
     });
     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`.");
+    if ((action !== "status" && action !== "retry") || (action === "status" && values.positionals.length > 1)) {
+        throw new Error("brain takes one verb: `status` or `retry`. 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))
@@ -26,9 +26,25 @@ export function parseBrainArgs(args) {
     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(", ")}.`);
+    const ids = values.positionals.slice(1);
+    const reason = optionalNonEmpty(values.flags.get("--reason"))?.trim();
+    const allNeedsHuman = values.booleans.has("--all-needs-human");
+    if (action === "retry") {
+        if (!reason || reason.length > 4000)
+            throw new Error("--reason requires text (at most 4000 characters).");
+        if (!ids.length && !allNeedsHuman)
+            throw new Error("retry requires incident ids or --all-needs-human.");
+        if (ids.length > 100 || ids.some(id => !/^(?:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|BLI-[0-9]+)$/i.test(id)))
+            throw new Error("retry wants incident UUIDs or BLI issue identifiers (at most 100).");
+        if (show)
+            throw new Error("--show belongs to brain status.");
+    }
+    else if (reason || allNeedsHuman)
+        throw new Error("--reason and --all-needs-human belong to brain retry.");
     return {
         kind: "brain",
-        action: "status",
+        action,
+        ...(action === "retry" ? { ids, reason, allNeedsHuman } : {}),
         ...(project ? { project } : {}),
         ...(show ? { show } : {}),
         dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),

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

@@ -49,6 +49,10 @@ export const TOWER_OPS_COMMAND_HELP = [
         [
             "Usage: cockpit brain status [--project <id>] [--show open|running|needs_human|fixed|not_actionable|cleared] [--dashboard-url <url>] [--json]",
             "",
+            "Retry: cockpit brain retry <id...> [--all-needs-human] [--project <p>] --reason <text> [--json]",
+            "Ids are incident UUIDs or BLI issue identifiers. Retry reopens needs_human or not_actionable rows, resets attempts and claims,",
+            "and records who, why and when. --all-needs-human selects only needs_human; --project narrows every selection. Other states are skipped.",
+            "Only members and super admins can retry. One comment is posted per incident issue. MCP twin: brain_retry.",
             "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,",

package/dist/commands/mail.js

@@ -26,7 +26,7 @@ import { writeFile } from "node:fs/promises";
 import { askAgentDoor, emitAgentDoor, failAgentDoor, openAgentDoor, } from "./agent-door.js";
 import { isInteractiveStdin, readPipedText, writeLine } from "./cli-io.js";
 import { composeMessage, failAttachmentsUnconfirmed, readMailBody, runMailDraft, unconfirmedAttachments, } from "./mail-compose.js";
-import { cacheAgeLabel, readThroughCache } from "./read-cache.js";
+import { cacheAgeLabel, cacheCoverage, readThroughCache } from "./read-cache.js";
 import { towerRequest } from "../tower-client.js";
 const TAG = "[mail cli]";
 const READ_DEADLINE_MS = 30_000;
@@ -177,7 +177,7 @@ async function inbox(command, door) {
         return failAgentDoor(door, TAG, answer.reason, answer.detail);
     const body = answer.body;
     if (door.json)
-        return emitAgentDoor(door, { ok: true, ...body });
+        return emitAgentDoor(door, { ok: true, ...body, ...cacheCoverage(answer) });
     if (answer.fromCache) {
         writeLine(door.io.stderr, `(${cacheAgeLabel(answer.ageMs ?? 0)}, refreshing in the background)`);
     }

package/dist/commands/memory-install-receipt.js

@@ -208,11 +208,9 @@ export async function readMemoryReceiptFile(options) {
     if (!receipt)
         return { receipt: null, reason: "receipt_unparseable" };
     const age = (options.now ?? new Date()).getTime() - Date.parse(receipt.checked_at);
-    // A reading a week old is not a reading. Better to send nothing and let the
-    // board say "not reported" than to publish a claim about a machine that has
-    // not been looked at since.
+    // Keep last-known host facts, with the original checked_at and reason.
     if (Number.isFinite(age) && age > MEMORY_RECEIPT_MAX_AGE_MS) {
-        return { receipt: null, reason: "receipt_expired" };
+        return { receipt, reason: "receipt_expired" };
     }
     return { receipt, reason: "receipt_read" };
 }

package/dist/commands/memory-store.js

@@ -49,7 +49,7 @@ import { resolveContainerTag } from "@bli-cockpit/memory-mcp/dist/container-tag.
 import { askAgentDoor, emitAgentDoor, failAgentDoor, openAgentDoor, } from "./agent-door.js";
 import { isInteractiveStdin, readPipedText, writeLine } from "./cli-io.js";
 import { runMemoryConsolidation } from "./memory-consolidation.js";
-import { cacheAgeLabel, readThroughCache } from "./read-cache.js";
+import { cacheAgeLabel, cacheCoverage, readThroughCache } from "./read-cache.js";
 import { runMemoryRequeue } from "./memory-requeue.js";
 import { runMemoryVisibility } from "./memory-visibility.js";
 import { readNoteFile } from "./notes-file.js";
@@ -194,7 +194,7 @@ async function searchMemory(command, door) {
         degraded: body.degraded ?? null,
     })}`);
     if (door.json)
-        return emitAgentDoor(door, answer.body);
+        return emitAgentDoor(door, { ...answer.body, ...cacheCoverage(answer) });
     if (answer.fromCache) {
         writeLine(door.io.stderr, `(${cacheAgeLabel(answer.ageMs ?? 0)}, refreshing in the background)`);
     }

package/dist/commands/msg.js

@@ -17,7 +17,7 @@
  */
 import { askAgentDoor, emitAgentDoor, failAgentDoor, openAgentDoor, } from "./agent-door.js";
 import { isInteractiveStdin, readPipedText, writeLine } from "./cli-io.js";
-import { cacheAgeLabel, readThroughCache } from "./read-cache.js";
+import { cacheAgeLabel, cacheCoverage, readThroughCache } from "./read-cache.js";
 const TAG = "[msg cli]";
 const READ_DEADLINE_MS = 30_000;
 const WRITE_DEADLINE_MS = 30_000;
@@ -64,6 +64,7 @@ async function fetchChannels(door) {
         channels: answer.body.channels ?? [],
         fromCache: answer.fromCache,
         ageMs: answer.ageMs,
+        coverage: answer.coverage,
     };
 }
 async function listChannels(door) {
@@ -71,7 +72,7 @@ async function listChannels(door) {
     if (!fetched.ok)
         return failAgentDoor(door, TAG, fetched.reason, fetched.detail);
     if (door.json)
-        return emitAgentDoor(door, { ok: true, channels: fetched.channels });
+        return emitAgentDoor(door, { ok: true, channels: fetched.channels, ...cacheCoverage(fetched) });
     if (fetched.fromCache) {
         writeLine(door.io.stderr, `(${cacheAgeLabel(fetched.ageMs ?? 0)}, refreshing in the background)`);
     }

package/dist/commands/notes-folders.js

@@ -31,5 +31,7 @@ export async function runFolderCommand(command, door) {
             const label = command.tree ? `${"  ".repeat(folder.path.split("/").length - 1)}${folder.name}` : folder.path;
             writeLine(door.io.stdout, `${label} (${folder.note_count})`);
         }
+    if (body.coverage)
+        writeLine(door.io.stdout, body.coverage);
     return 0;
 }

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.197");
+    writeLine(io?.stdout ?? process.stdout, "0.2.198");
     return 0;
   }
 

package/dist/commands/read-cache.js

@@ -6,7 +6,7 @@
  * Text mode: a cache hit prints INSTANTLY (its age travels with it), then a
  * background refresh is spawned so the next call is live — never blocking
  * this process on a network round trip it already has a recent answer for.
- * `--json` (an agent, not a person) trusts cache only under
+ * `--json` attempts live first when the cache is older than
  * `JSON_FRESH_BOUND_MS`, unless `--allow-stale` says otherwise; older than
  * that runs the live request inline, same as a miss. `--fresh` skips the
  * read entirely — both flags are process-wide (BLI-10450's `--quiet`
@@ -73,7 +73,7 @@ export async function readThroughCache(options) {
                 else {
                     log(`[read-cache] refresh skipped ${JSON.stringify({ reason: "too_recent", age_ms: ageMs })}`);
                 }
-                return { ok: true, httpStatus: cached.status, body: cached.body, fromCache: true, ageMs };
+                return { ok: true, httpStatus: cached.status, body: cached.body, fromCache: true, ageMs, coverage: cacheAgeLabel(ageMs) };
             }
             log(`[read-cache] too stale for --json ${JSON.stringify({ surface: options.surface, label: options.label, age_ms: ageMs })}`);
         }
@@ -86,6 +86,18 @@ export async function readThroughCache(options) {
         writeReadCacheEntryAtomic(entryPath, { status: live.httpStatus, body: live.body });
         log(`[read-cache] refreshed ${JSON.stringify({ surface: options.surface, label: options.label })}`);
     }
+    else if (!fresh && live.httpStatus !== 401 && live.httpStatus !== 403) {
+        const cached = readReadCacheEntry(entryPath);
+        if (cached) {
+            const ageMs = Date.now() - cached.storedAt;
+            const coverage = `served stale: ${cacheAgeLabel(ageMs)}, live failed: ${live.reason}`;
+            log(`[read-cache] ${coverage} ${JSON.stringify({ reason: live.reason, age_ms: ageMs })}`);
+            const body = cached.body && typeof cached.body === "object" && !Array.isArray(cached.body)
+                ? { ...cached.body, cache_coverage: coverage, cache_age_ms: ageMs, live_failure_reason: live.reason }
+                : cached.body;
+            return { ok: true, httpStatus: cached.status, body, fromCache: true, ageMs, coverage };
+        }
+    }
     return { ...live, fromCache: false, ageMs: null };
 }
 /**
@@ -112,4 +124,8 @@ export function spawnBackgroundRefresh(io, log, spawnImpl = spawn) {
     catch (error) {
         log(`[read-cache] background refresh failed to spawn ${JSON.stringify({ reason: error instanceof Error ? error.name : "unknown" })}`);
     }
+}
+/** JSON readers carry the same age sentence as the terminal. */
+export function cacheCoverage(answer) {
+    return answer.fromCache ? { fromCache: true, ageMs: answer.ageMs, cache_coverage: answer.coverage ?? cacheAgeLabel(answer.ageMs ?? 0) } : {};
 }

package/dist/commands/settings.js

@@ -20,7 +20,7 @@
  * being written to stdout, stderr, or an argument vector.
  */
 import { isInteractiveStdin, readLine, settleYesNo, writeLine } from "./cli-io.js";
-import { cacheAgeLabel, readThroughCache } from "./read-cache.js";
+import { cacheAgeLabel, cacheCoverage, readThroughCache } from "./read-cache.js";
 import { asList, asRecord, callTower, isForbidden, openTower, parseModelKey, readAllStdin, writeCommandFailure, } from "./tower-command.js";
 import { showOverview } from "./settings-overview.js";
 import { renderCliFloor, renderEnvBlobs, renderModelRouting, renderPersonal, renderSwitches, } from "./settings-render.js";
@@ -75,7 +75,7 @@ async function showPersonal(command, tower, io) {
     if (result.fromCache && !command.json) {
         writeLine(io.stderr, `(${cacheAgeLabel(result.ageMs ?? 0)}, refreshing in the background)`);
     }
-    return writeBody(io, command.json, result.body, () => renderPersonal(asRecord(result.body)));
+    return writeBody(io, command.json, { ...asRecord(result.body), ...cacheCoverage(result) }, () => renderPersonal(asRecord(result.body)));
 }
 async function setPersonal(command, tower, io) {
     const result = await callTower(tower, {

package/dist/commands/setup-receipt-lines.js

@@ -10,6 +10,8 @@
  * gets ONE command or ONE click, never a paragraph and never "see the docs".
  */
 import { setupPieceMark, setupReceiptLine, setupReceiptPieces, } from "@bli-cockpit/telemetry-core";
+/** Cached host facts are old after the same seven-day window as their readers. */
+const OLD_READING_MS = 7 * 24 * 60 * 60 * 1000;
 /** The one fix for each piece, by key. Present for every key the block prints. */
 const FIXES = {
     browser: "Run `cockpit login` and open the link it prints.",
@@ -57,8 +59,18 @@ export function setupReceiptBlock(reading, options = {}) {
             continue;
         lines.push(`${indent}  ${label} ${setupPieceMark(piece.status)}${reasonSuffix(piece)} — ${fixFor(key, piece)}`);
     }
-    if (options.showCheckedAt) {
-        lines.push(`${indent}Last read: ${receipt.checked_at}`);
+    const now = reading.readAt ? Date.parse(reading.readAt) : Date.now();
+    const ageMs = now - Date.parse(receipt.checked_at);
+    if (options.showCheckedAt || reading.refreshFailure || !Number.isFinite(ageMs) || ageMs > OLD_READING_MS) {
+        const age = Number.isFinite(ageMs) ? `${Math.max(0, Math.floor(ageMs / 3_600_000))}h ago` : "age unavailable";
+        lines.push(`${indent}As of ${receipt.checked_at} (${age})${reading.refreshFailure ? `; this run could not re-read the machine: ${reading.refreshFailure}` : ""}`);
+    }
+    if (memory) {
+        const memoryAgeMs = now - Date.parse(memory.checked_at);
+        if (!Number.isFinite(memoryAgeMs) || memoryAgeMs > OLD_READING_MS) {
+            const age = Number.isFinite(memoryAgeMs) ? `${Math.max(0, Math.floor(memoryAgeMs / 3_600_000))}h ago` : "age unavailable";
+            lines.push(`${indent}Agent hosts as of ${memory.checked_at} (${age})`);
+        }
     }
     return lines;
 }

package/dist/commands/setup-receipt.js

@@ -39,7 +39,7 @@
  * owns the target vocabulary this translates from.
  */
 import os from "node:os";
-import { SETUP_RECEIPT_SCHEMA_VERSION, setupReceiptGaps, setupReceiptLine, } from "@bli-cockpit/telemetry-core";
+import { SETUP_RECEIPT_SCHEMA_VERSION, SetupReceiptSchema, setupReceiptGaps, setupReceiptLine, } from "@bli-cockpit/telemetry-core";
 import { readHeartbeatMemoryReceipt } from "./heartbeat.js";
 import { autostartSetupPiece, readAutostartRegistration, } from "./autostart-reading.js";
 import { readLocalSessionReference } from "../local-state.js";
@@ -89,7 +89,7 @@ export async function buildSetupReceipt(io, options = {}) {
         gaps,
         memory_receipt: memory ? "read" : "absent",
     }));
-    return { receipt, memory };
+    return { receipt, memory, readAt: checkedAt };
 }
 function withDefaultProbes(io, homeDir, options) {
     return {
@@ -167,8 +167,8 @@ export async function cacheSetupReceipt(receipt, homeDir) {
 }
 /**
  * The cached receipt, or null with a named reason. A receipt older than
- * `SETUP_RECEIPT_MAX_AGE_MS` is refused rather than sent: a stale word is
- * worse than an absent one, because absence asks and staleness answers.
+ * `SETUP_RECEIPT_MAX_AGE_MS` is logged as stale and sent with its original
+ * checked_at; readers show its age rather than discarding the last reading.
  */
 export async function readCachedSetupReceipt(homeDir, now = new Date()) {
     let raw;
@@ -187,8 +187,7 @@ export async function readCachedSetupReceipt(homeDir, now = new Date()) {
     }
     const age = now.getTime() - Date.parse(parsed.checked_at);
     if (!Number.isFinite(age) || age > SETUP_RECEIPT_MAX_AGE_MS) {
-        console.error(`${TAG} cache too old to send`, JSON.stringify({ reason: "cache_stale", age_days: Math.round(age / 86_400_000) }));
-        return null;
+        console.error(`${TAG} serving old cache`, JSON.stringify({ reason: "cache_stale", age_days: Math.round(age / 86_400_000) }));
     }
     return parsed;
 }
@@ -196,7 +195,8 @@ function safeParseReceipt(raw) {
     const record = raw;
     if (!record || record.schema_version !== SETUP_RECEIPT_SCHEMA_VERSION)
         return null;
-    return raw;
+    const parsed = SetupReceiptSchema.safeParse(raw);
+    return parsed.success ? parsed.data : null;
 }
 /** The one line, plus the one fix per gap. Rendering lives in `setup-receipt-lines.ts`. */
 export { setupReceiptLine };
@@ -212,11 +212,23 @@ export { setupReceiptLine };
 export async function refreshSetupReceipt(io, options = {}) {
     try {
         const reading = await buildSetupReceipt(io, options);
+        const probeFailed = [reading.receipt.browser, reading.receipt.device, reading.receipt.collector.autostart].some(piece => piece.reason?.endsWith("probe_failed"));
+        if (probeFailed) {
+            const cached = await readCachedSetupReceipt(options.homeDir, options.now);
+            if (cached) {
+                console.error(`${TAG} could not be computed`, JSON.stringify({ reason: "receipt_build_failed" }));
+                return { receipt: cached, memory: reading.memory, readAt: reading.readAt, refreshFailure: "receipt_build_failed" };
+            }
+        }
         await cacheSetupReceipt(reading.receipt, options.homeDir);
         return reading;
     }
     catch (error) {
         console.error(`${TAG} could not be computed`, JSON.stringify({ reason: "receipt_build_failed", error_name: errorName(error) }));
-        return null;
+        const receipt = await readCachedSetupReceipt(options.homeDir, options.now);
+        if (!receipt)
+            return null;
+        const memory = await readHeartbeatMemoryReceipt({ homeDir: options.homeDir, now: options.now });
+        return { receipt, memory: memory.receipt, readAt: (options.now ?? new Date()).toISOString(), refreshFailure: "receipt_build_failed" };
     }
 }

package/dist/commands/setup.js

@@ -48,6 +48,8 @@ export async function runSetup(command, io) {
             if (pair.use?.[side])
                 writeLine(io.stdout, `  ${side === "first" ? pair.first : pair.second}: tokens by model: ${pair.use[side].models ?? "not available right now."} Skills used: ${pair.use[side].skills ?? "not available right now."}`);
     }
+    for (const line of body.read_coverage ?? [])
+        writeLine(io.stdout, line);
     if (body.note)
         writeLine(io.stdout, body.note);
     return 0;

package/dist/commands/status.js

@@ -1,11 +1,5 @@
 /**
- * `cockpit status` — what this machine believes about itself: install, pairing,
- * active work, upload state, retry backlog, and how far historical backfill
- * has got.
  *
- * Read-only. Split out of commands/local.ts (BLI-3104). BLI-3194 rewrote the
- * human block into plain English, because these lines are what an intern
- * pastes into Slack when something looks wrong. The `--json` payload is the
  * machine contract and is byte-for-byte unchanged — `status-json-shape.test.ts`
  * holds it to that.
  *
@@ -131,7 +125,7 @@ function writeSingleRepoLines(io, status, backfillCursor, setupReceipt, disk) {
     if (status.linear_ticket_id)
         writeLine(io.stdout, `Linear: ${status.linear_ticket_id}`);
     writeLine(io.stdout, `Work: ${displayWorkLabel(status)}`);
-    writeLine(io.stdout, `Last collected: ${lastCollectedLine(status.collector_freshness)}`);
+    writeLine(io.stdout, `Last collected: ${lastCollectedLine(status.collector_freshness, status.last_collected_at)}`);
     writeLine(io.stdout, `Version: ${status.collector_version}`);
     writeLine(io.stdout, `Uploads: ${uploadsLine(status.upload_state)}`);
     writeLine(io.stdout, `Last upload tried: ${status.last_upload_attempt_at ?? "never"}`);
@@ -239,7 +233,14 @@ function signedInLine(sessionState) {
             return "cannot tell";
     }
 }
-function lastCollectedLine(freshness) {
+export function lastCollectedLine(freshness, timestamp) {
+    if (timestamp) {
+        const ageMs = Date.now() - Date.parse(timestamp);
+        const minutes = Math.max(0, Math.floor(ageMs / 60_000));
+        const age = minutes < 60 ? `${minutes}m` : minutes < 1440 ? `${Math.floor(minutes / 60)}h` : `${Math.floor(minutes / 1440)}d`;
+        const label = lastCollectedLine(freshness);
+        return `${label} (${timestamp}; ${age} ago)`;
+    }
     switch (freshness) {
         case "fresh":
             return "recently";

package/dist/commands/usage-format.js

@@ -41,6 +41,7 @@ export function githubWords(github, people) {
         `GitHub: ${noun(sum("pull_requests_opened"), "pull request")} opened, ${sum("pull_requests_merged")} merged, ${noun(sum("commits"), "commit")}, ` +
             `from ${noun((github.repositories ?? []).length, "mirrored repository", "mirrored repositories")}${range}.`,
     ];
+    lines.push(...(github.read_coverage ?? []));
     const unmatched = github.unattributed;
     if (unmatched && unmatched.pull_requests_opened + unmatched.pull_requests_merged + unmatched.commits > 0) {
         lines.push(`Not matched to a person: ${noun(unmatched.pull_requests_opened, "pull request")} opened, ${unmatched.pull_requests_merged} merged, ${noun(unmatched.commits, "commit")}.`);

package/dist/commands/usage.js

@@ -116,6 +116,8 @@ export async function runUsage(command, io) {
     // date it cannot know.
     writeLine(io.stdout, "");
     writeLine(io.stdout, body.api_list_price_equivalent_label ?? "API list-price equivalent, not actual spend (this dashboard sent no price-sheet version)");
+    for (const line of body.read_coverage ?? [])
+        writeLine(io.stdout, line);
     writeLine(io.stdout, `${body.coverage?.sessions_extracted ?? 0} of ${body.coverage?.sessions_observed ?? 0} sessions extracted`);
     // BLI-4356: the gap says why. A session observed with no tokens is either
     // waiting on a count that has not run yet, or an automated one this view

package/dist/local-state-status.js

@@ -43,6 +43,10 @@ export async function inspectLocalCollectorStatus(options = {}) {
         worktree_fingerprint: context?.worktree_fingerprint ?? identity.worktree_fingerprint,
         worktree_is_primary: context?.worktree_is_primary ?? identity.worktree_is_primary,
         collector_freshness: freshness,
+        last_collected_at: (() => {
+            const timestamp = context ? latestTimestamp([context.updated_at ?? context.started_at, uploadSpool.last_upload_success_at]) : null;
+            return timestamp === null ? null : new Date(timestamp).toISOString();
+        })(),
         upload_state: uploadState,
         last_upload_attempt_at: uploadSpool.last_upload_attempt_at,
         last_upload_success_at: uploadSpool.last_upload_success_at,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/cli",
-  "version": "0.2.197",
+  "version": "0.2.198",
   "private": false,
   "type": "module",
   "bin": {
@@ -28,7 +28,7 @@
   },
   "dependencies": {
     "@bli-cockpit/memory-mcp": "0.1.60",
-    "@bli-cockpit/mcp": "0.1.109",
+    "@bli-cockpit/mcp": "0.1.110",
     "@bli-cockpit/telemetry-core": "0.1.69"
   },
   "repository": {