@bli-cockpit/cli 0.2.290 → 0.2.291

package/dist/adapters/raw-evidence-transcript-file.js

@@ -67,6 +67,13 @@ export async function collectOneEvidenceFile(collection, options) {
         markCapApplied(collection, options.kind, "max_file_bytes");
         return skip("file_too_large");
     }
+    // A zero-byte transcript (a subagent sidecar opened and never written) has nothing to preserve. Staging it made a
+    // 0-byte object the uploader refuses with `empty_file` on every tick, forever, and the fleet board read that
+    // permanent refusal as a stuck object (RED). Like an empty git diff it is not a gap; the line says it was seen.
+    if (read.byteLength === 0) {
+        console.error("[raw-evidence] empty transcript not staged, there is nothing in it to preserve", JSON.stringify({ reason: "empty_file", kind: options.kind, byte_size: 0 }));
+        return true;
+    }
     let prepared;
     try {
         prepared = await prepareTranscriptForUpload(collection, options, names, read.source);

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

package/dist/raw-evidence-staging.js

@@ -4,6 +4,7 @@ import fs from "node:fs/promises";
 import path from "node:path";
 import { bookkeepingRead, bookkeepingWrite } from "./bookkeeping-session.js";
 import { describeError, isMissingFileFailure } from "./health-detail.js";
+import { dropEmptyObjectRecords } from "./raw-evidence-stuck-summary.js";
 /**
  * Durable local state for raw-evidence STAGING and DELIVERY ATTEMPTS.
  *
@@ -29,7 +30,7 @@ import { describeError, isMissingFileFailure } from "./health-detail.js";
 // BLI-4022. The stuck/held summary moved to its own sibling so this file
 // stays under the readability band; it is still importable from here,
 // which is the address every caller already knows.
-export { summarizeStuckEvidence, } from "./raw-evidence-stuck-summary.js";
+export { summarizeStuckEvidence } from "./raw-evidence-stuck-summary.js";
 export const RAW_EVIDENCE_STAGING_FILENAME = "raw-evidence-staging.json";
 /**
  * Backoff schedule for an object whose delivery keeps failing.
@@ -75,6 +76,7 @@ async function readStagingFromDisk(stateDir) {
         const raw = JSON.parse(await fs.readFile(rawEvidenceStagingStatePath(stateDir), "utf8"));
         const state = parseStagingState(raw);
         resetStorage403ForEncoding(state);
+        dropEmptyObjectRecords(state);
         return state;
     }
     catch (error) {

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

@@ -72,4 +72,29 @@ function summarizeLiveDeliveryAttempts(entries, ghostCount, now) {
         held_next_attempt_at: heldNextAttemptAt,
         held_last_reason: heldOldest?.last_reason ?? null,
     };
+}
+/**
+ * Forget the zero-byte objects an older collector staged. It offered them on every tick and the uploader refused each
+ * one with `empty_file`, which no retry can fix, so the fleet board read one as a stuck object for days (RED). The
+ * collector no longer stages an empty transcript (`adapters/raw-evidence-transcript-file.ts`); this clears what already
+ * sits in the history so the machine stops reporting it. The empty file itself is left for the ordinary staging prune.
+ */
+export function dropEmptyObjectRecords(state) {
+    let dropped = 0;
+    for (const [hash, entry] of Object.entries(state.staged)) {
+        if (entry.byte_size !== 0)
+            continue;
+        delete state.staged[hash];
+        dropped += 1;
+    }
+    for (const [hash, entry] of Object.entries(state.delivery_attempts)) {
+        if (entry.last_reason !== "empty_file")
+            continue;
+        delete state.delivery_attempts[hash];
+        dropped += 1;
+    }
+    if (dropped > 0) {
+        console.error("[raw-evidence-staging] empty objects forgotten, nothing in them can be delivered", JSON.stringify({ reason: "empty_file_records_dropped", records_dropped: dropped }));
+    }
+    return dropped;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/cli",
-  "version": "0.2.290",
+  "version": "0.2.291",
   "private": false,
   "type": "module",
   "bin": {