@ouro.bot/cli 0.1.0-alpha.690 → 0.1.0-alpha.691

package/changelog.json

@@ -1,6 +1,12 @@
 {
   "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
   "versions": [
+    {
+      "version": "0.1.0-alpha.691",
+      "changes": [
+        "Bound context-loss Sentinel per-receipt detail files while preserving append-only history, so long-lived agents cannot accumulate unbounded duplicate recovery JSON in their bundles."
+      ]
+    },
     {
       "version": "0.1.0-alpha.690",
       "changes": [

package/dist/heart/context-loss-sentinel.js

@@ -47,6 +47,7 @@ const flight_recorder_1 = require("../arc/flight-recorder");
 const runtime_1 = require("../nerves/runtime");
 const context_loss_gauntlet_1 = require("./context-loss-gauntlet");
 const provider_visibility_1 = require("./provider-visibility");
+const CONTEXT_LOSS_SENTINEL_RECEIPT_FILE_LIMIT = 512;
 const REQUIRED_LANES = ["outward", "inner"];
 function logicalLocator(...parts) {
     return path.posix.join(...parts);
@@ -324,6 +325,43 @@ function readReceiptFile(filePath, label, issues) {
     }
     return parsed.value;
 }
+function receiptIdFromFileName(fileName) {
+    return fileName.endsWith(".json") ? fileName.slice(0, -".json".length) : null;
+}
+function receiptOrderFromDetailFile(filePath, fileName) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+        if (isReceipt(parsed))
+            return orderFromReceipt(parsed);
+    }
+    catch {
+        // Malformed legacy detail files should not block retention cleanup.
+    }
+    const stat = fs.statSync(filePath);
+    return {
+        generatedAt: new Date(stat.mtimeMs).toISOString(),
+        id: receiptIdFromFileName(fileName),
+    };
+}
+function pruneReceiptDetailFiles(paths, protectedReceiptIds) {
+    const fileNames = fs.readdirSync(paths.receiptsDir)
+        .filter((entry) => receiptIdFromFileName(entry) !== null);
+    if (fileNames.length <= CONTEXT_LOSS_SENTINEL_RECEIPT_FILE_LIMIT)
+        return;
+    const candidates = fileNames
+        .map((fileName) => ({
+        fileName,
+        filePath: path.join(paths.receiptsDir, fileName),
+        receiptId: receiptIdFromFileName(fileName),
+        order: receiptOrderFromDetailFile(path.join(paths.receiptsDir, fileName), fileName),
+    }))
+        .filter((entry) => !protectedReceiptIds.has(entry.receiptId))
+        .sort((left, right) => compareOrder(left.order, right.order));
+    const removalCount = fileNames.length - CONTEXT_LOSS_SENTINEL_RECEIPT_FILE_LIMIT;
+    for (const entry of candidates.slice(0, removalCount)) {
+        fs.rmSync(entry.filePath, { force: true });
+    }
+}
 function isNonEmptyText(value) {
     return typeof value === "string" && value.trim().length > 0;
 }
@@ -806,19 +844,24 @@ async function persistReceipt(agentRoot, receipt, lockTimeoutMs) {
         const coalesced = coalescedDaemonHealthReceipt(agentRoot, existingLatest, existingReady, receipt, watermark);
         if (coalesced)
             return coalesced;
-        atomicWriteJson(path.join(paths.receiptsDir, `${receipt.id}.json`), receipt);
+        const receiptPath = path.join(paths.receiptsDir, `${receipt.id}.json`);
+        atomicWriteJson(receiptPath, receipt);
+        setReceiptFileMtime(receiptPath, receipt);
         appendHistory(paths, receipt);
+        let latestAfterWrite = existingLatest ?? receipt;
         if (shouldReplaceLatestReceipt(existingLatest, receipt, latestOrder)) {
             atomicWriteJson(paths.latest, receipt);
             updateWatermarkOrder(watermark, "latest", receipt);
             writeWatermark(agentRoot, watermark);
             setReceiptFileMtime(paths.latest, receipt);
+            latestAfterWrite = receipt;
             recordBlockedReceiptEvent(agentRoot, receipt);
             recordRecoveredReceiptEvent(agentRoot, receipt);
         }
         else if (existingLatest && nextReady === receipt) {
             const updatedLatest = syncLatestReadyState(existingLatest, nextReady);
             atomicWriteJson(paths.latest, updatedLatest);
+            latestAfterWrite = updatedLatest;
         }
         if (receipt.verdict === "ready" && nextReady === receipt) {
             atomicWriteJson(paths.latestReady, receipt);
@@ -826,6 +869,10 @@ async function persistReceipt(agentRoot, receipt, lockTimeoutMs) {
             writeWatermark(agentRoot, watermark);
             setReceiptFileMtime(paths.latestReady, receipt);
         }
+        const protectedReceiptIds = new Set([receipt.id, latestAfterWrite.id]);
+        if (nextReady)
+            protectedReceiptIds.add(nextReady.id);
+        pruneReceiptDetailFiles(paths, protectedReceiptIds);
         return receipt;
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.690",
+  "version": "0.1.0-alpha.691",
   "main": "dist/heart/daemon/ouro-entry.js",
   "bin": {
     "cli": "dist/heart/daemon/ouro-bot-entry.js",