@llmnesia/mcp 0.2.11 → 0.2.12

package/README.md

@@ -160,6 +160,15 @@ the canonical conversation and active index have accepted it. Malformed input
 is kept under `inbox/quarantine/` for inspection. Older releases archived every
 successful payload and may also have left versioned indexes behind.
 
+Valid blank-text turns are retained with their message metadata. If an older
+importer quarantined a backup containing those turns, close connected MCP
+clients and run `llmnesia-mcp retry-quarantine`. The command validates each
+entire file before retrying, updates the active index, and moves successfully
+recovered originals into `inbox/recovered/` without deleting their contents.
+Files with unresolved malformed records remain quarantined. The warning clears
+on the next MCP read once no pending or quarantined files remain. This does not
+require rebuilding local history.
+
 No maintenance command is required. After an upgrade, the MCP service waits
 through a three-day compatibility window, then reclaims the historical files
 automatically while the service is ready and idle. Work is single-process,
@@ -187,6 +196,7 @@ Once registered, your MCP client gains eight tools over the corpus:
 | Tool | Purpose |
 | --- | --- |
 | `search_conversations` | Full-text search across every past conversation. Returns ranked matches with highlighted snippets. Supports `platform`, `title`, `date_from`/`date_to` filters and a `match_mode` (`any` / `all` / `phrase`) for when a wrong hit matters. |
+| `get_conversation_image` | Read a retained local raster image using the message and image index returned by `get_conversation`. No private provider URL fetching or OCR. |
 | `get_conversation` | Fetch the full transcript of one conversation by its id (the `id` field from search results). The response carries `contentFingerprint`, the current fingerprint of the returned transcript (see below). |
 | `list_conversations` | List conversations by chronology, including oldest-first for questions about the user's earliest chat. |
 | `list_recent` | List the most recently updated conversations with title, summary, and platform. |
@@ -214,7 +224,7 @@ items (`limit` can go lower):
   "items": [
     { "id": "claude:rust-borrow", "platform": "claude",
       "title": "Debugging a Rust borrow checker error",
-      "fingerprint": "fp1:9af3c0d7…" }
+      "fingerprint": "fp2:9af3c0d7…" }
   ],
   "nextCursor": "inv1.eyJzIjoi…"
 }
@@ -229,12 +239,15 @@ Cursors are opaque, they do not survive an MCP server restart, and an expired
 or unknown cursor returns a clear error telling the caller to begin a new
 scan.
 
-The fingerprint is `fp1:` followed by a SHA-256 hex digest. It covers exactly:
+Images are now included in the fingerprint. Clients comparing an older `fp1` inventory should refresh it once. Local raster copies are bounded to 2 MiB per image and 8 MiB per captured conversation. Vault sync retains URL metadata only. Protected or expired images without a retained copy need recapture or a supported bundled export.
+
+The fingerprint is `fp2:` followed by a SHA-256 hex digest. It covers exactly:
 
 - the conversation title, and the user's local alias (`localTitle`) when set;
 - every message in `msgIndex` order: its index, role, stored `text`, and
-  `formattedText` when present (because `get_conversation` prefers it, a
-  backfill that adds it changes what a caller would receive).
+  `formattedText` when present;
+- image references, metadata and retained local bytes. Image-only changes are
+  visible to an inventory client even when transcript text is unchanged.
 
 It deliberately excludes every timestamp, including the provider's
 `updatedAt`: historical imports can retain old source dates, and a genuinely
@@ -322,6 +335,7 @@ llmnesia-mcp uninstall     # remove manifests, config, client entries
 llmnesia-mcp init          # create an empty corpus
 llmnesia-mcp ingest <…>    # ingest an NDJSON backup file
 llmnesia-mcp drain         # ingest everything in <corpus>/inbox
+llmnesia-mcp retry-quarantine # repair eligible files; retain original backups
 llmnesia-mcp watch         # ingest new inbox deltas live (Ctrl+C to stop)
 llmnesia-mcp stats         # corpus summary
 llmnesia-mcp compact --dry-run # exact read-only storage/savings report

package/dist/{chunk-7ISC4REX.js → chunk-3QDA3XWA.js}

@@ -3,7 +3,45 @@ import { createRequire as __llmnesiaCreateRequire } from "node:module";
 const require = __llmnesiaCreateRequire(import.meta.url);
 import {
   VERSION
-} from "./chunk-ZYE6VY6A.js";
+} from "./chunk-SEBISBN5.js";
+
+// src/images.ts
+var MAX_BYTES = 2 * 1024 * 1024;
+function decodeImage(value) {
+  if (typeof value !== "string" || value.length > Math.ceil(MAX_BYTES * 4 / 3) + 80) return null;
+  const match = /^data:(image\/(?:png|jpeg|webp|gif));base64,([A-Za-z0-9+/]+={0,2})$/.exec(value);
+  if (!match || match[2].length % 4 !== 0) return null;
+  const bytes = Buffer.from(match[2], "base64");
+  if (!bytes.length || bytes.length > MAX_BYTES || bytes.toString("base64") !== match[2]) return null;
+  const head = bytes.toString("latin1", 0, 12);
+  const valid = match[1] === "image/png" ? head.startsWith("\x89PNG\r\n\n") : match[1] === "image/jpeg" ? head.startsWith("\xFF\xD8\xFF") : match[1] === "image/gif" ? /^GIF8[79]a/.test(head) : head.startsWith("RIFF") && head.slice(8, 12) === "WEBP";
+  if (!valid) return null;
+  return { mimeType: match[1], data: match[2] };
+}
+function normalizeImages(value) {
+  if (!Array.isArray(value)) return [];
+  return value.slice(0, 12).flatMap((raw) => {
+    if (!raw || typeof raw !== "object") return [];
+    const row = raw;
+    const dataUrl = decodeImage(row.dataUrl) ? row.dataUrl : void 0;
+    let url = "";
+    try {
+      if (typeof row.url === "string" && row.url.length <= 8e3) {
+        const parsed = new URL(row.url);
+        if (["http:", "https:"].includes(parsed.protocol)) url = parsed.href;
+      }
+    } catch {
+    }
+    if (!url && !dataUrl) return [];
+    return [{
+      url,
+      ...dataUrl ? { dataUrl } : {},
+      ...typeof row.alt === "string" ? { alt: row.alt.slice(0, 500) } : {},
+      ...typeof row.width === "number" && row.width > 0 && row.width <= 2e4 ? { width: row.width } : {},
+      ...typeof row.height === "number" && row.height > 0 && row.height <= 2e4 ? { height: row.height } : {}
+    }];
+  });
+}
 
 // src/config.ts
 import { readFileSync } from "fs";
@@ -147,6 +185,31 @@ import { dirname, join as join3 } from "path";
 import { promisify } from "util";
 import { gzip as gzipCallback, gunzip as gunzipCallback, gunzipSync } from "zlib";
 
+// src/sourceHealth.ts
+function parseSourceHealth(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const row = value;
+  if (!["claude_code", "codex", "zcode"].includes(String(row.source))) return null;
+  if (row.connection !== "connected" && row.connection !== "disconnected") return null;
+  if (!["ok", "partial", "missing", "error", "unknown"].includes(String(row.state))) return null;
+  const time = (v) => typeof v === "number" && Number.isSafeInteger(v) && v >= 0;
+  if (!time(row.observedAt) || !time(row.lastAttemptAt)) return null;
+  if (row.observedAt > Date.now() + 3e5 || row.lastAttemptAt > row.observedAt) return null;
+  if (row.lastSuccessfulSyncAt !== null && (!time(row.lastSuccessfulSyncAt) || row.lastSuccessfulSyncAt > row.observedAt)) return null;
+  if (row.lastCaptureAt !== null && (!time(row.lastCaptureAt) || row.lastCaptureAt > row.observedAt)) return null;
+  if (!time(row.failedSessions)) return null;
+  return {
+    source: row.source,
+    observedAt: row.observedAt,
+    connection: row.connection,
+    state: row.state,
+    lastAttemptAt: row.lastAttemptAt,
+    lastSuccessfulSyncAt: row.lastSuccessfulSyncAt,
+    lastCaptureAt: row.lastCaptureAt,
+    failedSessions: row.failedSessions
+  };
+}
+
 // src/serialize.ts
 function canonicalizeConversation(record) {
   return {
@@ -244,6 +307,8 @@ function canonicalMessageDoc(m) {
     role: m.role,
     text: m.text
   };
+  const images = normalizeImages(m.images);
+  if (images.length) out.images = images;
   assignIfDefined(out, "formattedText", m.formattedText);
   assignIfDefined(out, "model", m.model);
   out.createdAt = m.createdAt;
@@ -586,14 +651,46 @@ var Corpus = class {
     return { conversationCount, messageCount, byPlatform };
   }
   /** Refresh meta.json's conversationCount / lastIngestAt after an ingest run. */
-  async touchIngestMeta(receipt) {
+  async touchIngestMeta(receipt, sources = {}) {
     const { conversationCount } = await this.stats();
+    const previous = (await this.readMeta())?.sourceLastIngestAt ?? {};
+    const sourceLastIngestAt = { ...previous };
+    for (const [source, at] of Object.entries(sources)) {
+      sourceLastIngestAt[source] = Math.max(previous[source] ?? 0, at);
+    }
     await this.writeMeta({
       lastIngestAt: Date.now(),
       conversationCount,
+      sourceLastIngestAt,
       ...receipt ? { lastIngestReceipt: receipt } : {}
     });
   }
+  async readSourceHealth() {
+    try {
+      const rows = JSON.parse(await fs.readFile(join3(this.paths.root, "source-health-v1.json"), "utf8"));
+      return Array.isArray(rows) ? rows.flatMap((value) => {
+        const parsed = parseSourceHealth(value);
+        return parsed ? [parsed] : [];
+      }) : [];
+    } catch {
+      return [];
+    }
+  }
+  async recordSourceHealth(value) {
+    const row = parseSourceHealth(value);
+    if (!row) return false;
+    await this.enqueueWrite(async () => {
+      const current = new Map((await this.readSourceHealth()).map((entry) => [entry.source, entry]));
+      if ((current.get(row.source)?.observedAt ?? -1) >= row.observedAt) return;
+      current.set(row.source, row);
+      await writeFileAtomic(
+        join3(this.paths.root, "source-health-v1.json"),
+        `${JSON.stringify([...current.values()])}
+`
+      );
+    });
+    return true;
+  }
   enqueueWrite(fn) {
     const run = this.writeChain.then(fn, fn);
     this.writeChain = run.then(
@@ -787,7 +884,7 @@ async function upsertIndexedConversation(corpus, record, index) {
   }
   return result;
 }
-async function ingestFile(corpus, file, index) {
+async function ingestFile(corpus, file, index, options = {}) {
   const report = { ...EMPTY_REPORT };
   let current = null;
   let buffered = [];
@@ -796,7 +893,11 @@ async function ingestFile(corpus, file, index) {
       return;
     }
     const record = { conversation: current, messages: buffered };
-    const result = await upsertIndexedConversation(corpus, record, index);
+    const result = options.validateOnly ? { docId: current.docId, outcome: "skipped" } : await upsertIndexedConversation(corpus, record, index);
+    if (result.outcome !== "skipped") {
+      report.sourceLastIngestAt ??= {};
+      report.sourceLastIngestAt[record.conversation.platform] = Date.now();
+    }
     tally(report, result);
     report.conversations += 1;
     report.messages += buffered.length;
@@ -825,6 +926,12 @@ async function ingestFile(corpus, file, index) {
     if (type === "meta") {
       continue;
     }
+    if (type === "source_health") {
+      await flush();
+      const valid = options.validateOnly ? Boolean(parseSourceHealth(record.health)) : await corpus.recordSourceHealth(record.health);
+      if (!valid) report.malformedLines += 1;
+      continue;
+    }
     if (type === "conversation") {
       await flush();
       current = coerceConversation(record.conversation);
@@ -846,7 +953,9 @@ async function ingestFile(corpus, file, index) {
       } else {
         report.malformedLines += 1;
       }
+      continue;
     }
+    report.malformedLines += 1;
   }
   await flush();
   return report;
@@ -859,6 +968,30 @@ async function pendingInboxFiles(corpus) {
     throw error;
   }
 }
+async function retryQuarantine(corpus, index) {
+  await corpus.init();
+  const entries = (await fs2.readdir(corpus.paths.quarantineDir, { withFileTypes: true })).filter((entry) => entry.isFile() && isNdjson(entry.name)).map((entry) => entry.name).sort();
+  const result = { files: entries.length, recovered: 0, remaining: 0, failed: 0, archiveDir: null };
+  for (const name of entries) {
+    const src = join4(corpus.paths.quarantineDir, name);
+    try {
+      if ((await ingestFile(corpus, src, void 0, { validateOnly: true })).malformedLines > 0) continue;
+      const report = await ingestFile(corpus, src, index);
+      if (report.malformedLines > 0) continue;
+      if (!result.archiveDir) {
+        const recoveredDir = join4(corpus.paths.inboxDir, "recovered");
+        await fs2.mkdir(recoveredDir, { recursive: true, mode: 448 });
+        result.archiveDir = await fs2.mkdtemp(join4(recoveredDir, "quarantine-"));
+      }
+      await fs2.rename(src, join4(result.archiveDir, name));
+      result.recovered += 1;
+    } catch {
+      result.failed += 1;
+    }
+  }
+  result.remaining = (await fs2.readdir(corpus.paths.quarantineDir, { withFileTypes: true })).filter((entry) => entry.isFile()).length;
+  return result;
+}
 async function drainInbox(corpus, index, options = {}) {
   await corpus.init();
   const inbox = corpus.paths.inboxDir;
@@ -894,7 +1027,7 @@ async function drainInbox(corpus, index, options = {}) {
       }
     }
   }
-  if (total.files > 0) {
+  if (total.conversations > 0) {
     await corpus.touchIngestMeta({
       files: total.files,
       conversations: total.conversations,
@@ -902,7 +1035,7 @@ async function drainInbox(corpus, index, options = {}) {
       malformedLines: total.malformedLines,
       discarded: total.discarded,
       quarantined: total.quarantined
-    });
+    }, total.sourceLastIngestAt);
   }
   return total;
 }
@@ -947,12 +1080,12 @@ function coerceConversation(value) {
     return null;
   }
   const c = value;
-  if (typeof c.docId !== "string" || !c.docId) {
+  if (typeof c.docId !== "string" || !c.docId || typeof c.platform !== "string" || !c.platform || typeof c.title !== "string" || typeof c.url !== "string" || typeof c.createdAt !== "number" || !Number.isFinite(c.createdAt)) {
     return null;
   }
   const conversation = { ...c };
-  if (typeof conversation.updatedAt !== "number") {
-    conversation.updatedAt = typeof conversation.contentUpdatedAt === "number" ? conversation.contentUpdatedAt : 0;
+  if (typeof conversation.updatedAt !== "number" || !Number.isFinite(conversation.updatedAt)) {
+    conversation.updatedAt = typeof conversation.contentUpdatedAt === "number" && Number.isFinite(conversation.contentUpdatedAt) ? conversation.contentUpdatedAt : 0;
   }
   return conversation;
 }
@@ -961,11 +1094,12 @@ function coerceMessage(docId, value) {
     return null;
   }
   const m = value;
-  const text = typeof m.text === "string" ? m.text : "";
-  if (!text.trim()) {
-    return null;
-  }
-  const msgIndex = typeof m.msgIndex === "number" ? m.msgIndex : 0;
+  if (!Number.isSafeInteger(m.msgIndex) || m.msgIndex < 0) return null;
+  const formattedText = typeof m.formattedText === "string" ? m.formattedText : "";
+  const text = typeof m.text === "string" && m.text.trim() ? m.text : formattedText.trim() ? formattedText : typeof m.text === "string" ? m.text : "";
+  const images = normalizeImages(m.images);
+  if (typeof m.text !== "string" && !formattedText.trim() && !images.length) return null;
+  const msgIndex = m.msgIndex;
   const message = {
     // The backup line omits msgKey; reconstruct the extension's convention.
     msgKey: `${docId}:${msgIndex}`,
@@ -973,6 +1107,7 @@ function coerceMessage(docId, value) {
     msgIndex,
     role: coerceRole(m.role),
     text,
+    ...images.length ? { images } : {},
     createdAt: typeof m.createdAt === "number" ? m.createdAt : 0,
     updatedAt: typeof m.updatedAt === "number" ? m.updatedAt : 0,
     contentHash: typeof m.contentHash === "string" ? m.contentHash : ""
@@ -1003,6 +1138,10 @@ function tally(report, result) {
   }
 }
 function accumulate(total, report) {
+  for (const [source, at] of Object.entries(report.sourceLastIngestAt ?? {})) {
+    total.sourceLastIngestAt ??= {};
+    total.sourceLastIngestAt[source] = Math.max(total.sourceLastIngestAt[source] ?? 0, at);
+  }
   total.conversations += report.conversations;
   total.created += report.created;
   total.updated += report.updated;
@@ -1013,18 +1152,19 @@ function accumulate(total, report) {
 
 // src/fingerprint.ts
 import { createHash as createHash2 } from "crypto";
-var FINGERPRINT_SCHEME = "fp1";
+var FINGERPRINT_SCHEME = "fp2";
 function fingerprintConversation(record) {
   const conversation = record.conversation;
   const payload = {
-    v: 1,
+    v: 2,
     title: conversation.title,
     localTitle: conversation.localTitle ?? null,
     messages: [...record.messages].sort((a, b) => a.msgIndex - b.msgIndex).map((message) => ({
       i: message.msgIndex,
       r: message.role,
       t: message.text,
-      f: message.formattedText ?? null
+      f: message.formattedText ?? null,
+      images: message.images ?? []
     }))
   };
   const digest = createHash2("sha256").update(JSON.stringify(payload), "utf8").digest("hex");
@@ -1218,6 +1358,10 @@ var SearchIndex = class {
     const row = this.db.prepare("SELECT COUNT(*) AS n FROM conversations").get();
     return row.n;
   }
+  sourceSummary() {
+    return this.db.prepare(`SELECT platform AS source, COUNT(*) AS conversationCount,
+      MAX(updatedAt) AS newestConversationAt FROM conversations GROUP BY platform`).all();
+  }
   /** Number of indexed memories. */
   countMemories() {
     const row = this.db.prepare("SELECT COUNT(*) AS n FROM memories").get();
@@ -2254,6 +2398,7 @@ function describeOutcome(outcome) {
 }
 
 export {
+  decodeImage,
   readNativeHostViewerExtensionId,
   resolveCorpusDir,
   staleIndexFiles,
@@ -2261,6 +2406,7 @@ export {
   upsertIndexedConversation,
   ingestFile,
   pendingInboxFiles,
+  retryQuarantine,
   drainInbox,
   fingerprintConversation,
   SearchIndex,

package/dist/{chunk-ZYE6VY6A.js → chunk-SEBISBN5.js}

@@ -38,7 +38,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/version.ts
-var VERSION = true ? "0.2.11" : "0.0.0-dev";
+var VERSION = true ? "0.2.12" : "0.0.0-dev";
 
 export {
   __require,

package/dist/{cli-RQMFEW5J.js → cli-IF63HSCG.js}

@@ -14,20 +14,21 @@ import {
   openSearchIndex,
   readAutomaticMaintenanceState,
   resolveCorpusDir,
+  retryQuarantine,
   runtimeBinDir,
   staleIndexFiles,
   uninstallRuntime
-} from "./chunk-7ISC4REX.js";
+} from "./chunk-3QDA3XWA.js";
 import {
   VERSION,
   __commonJS,
   __require,
   __toESM
-} from "./chunk-ZYE6VY6A.js";
+} from "./chunk-SEBISBN5.js";
 
-// ../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/isexe/windows.js
+// ../node_modules/isexe/windows.js
 var require_windows = __commonJS({
-  "../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/isexe/windows.js"(exports, module) {
+  "../node_modules/isexe/windows.js"(exports, module) {
     "use strict";
     module.exports = isexe;
     isexe.sync = sync;
@@ -66,9 +67,9 @@ var require_windows = __commonJS({
   }
 });
 
-// ../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/isexe/mode.js
+// ../node_modules/isexe/mode.js
 var require_mode = __commonJS({
-  "../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/isexe/mode.js"(exports, module) {
+  "../node_modules/isexe/mode.js"(exports, module) {
     "use strict";
     module.exports = isexe;
     isexe.sync = sync;
@@ -100,9 +101,9 @@ var require_mode = __commonJS({
   }
 });
 
-// ../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/isexe/index.js
+// ../node_modules/isexe/index.js
 var require_isexe = __commonJS({
-  "../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/isexe/index.js"(exports, module) {
+  "../node_modules/isexe/index.js"(exports, module) {
     "use strict";
     var fs = __require("fs");
     var core;
@@ -156,9 +157,9 @@ var require_isexe = __commonJS({
   }
 });
 
-// ../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/which/which.js
+// ../node_modules/which/which.js
 var require_which = __commonJS({
-  "../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/which/which.js"(exports, module) {
+  "../node_modules/which/which.js"(exports, module) {
     "use strict";
     var isWindows2 = process.platform === "win32" || process.env.OSTYPE === "cygwin" || process.env.OSTYPE === "msys";
     var path = __require("path");
@@ -253,9 +254,9 @@ var require_which = __commonJS({
   }
 });
 
-// ../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/path-key/index.js
+// ../node_modules/path-key/index.js
 var require_path_key = __commonJS({
-  "../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/path-key/index.js"(exports, module) {
+  "../node_modules/path-key/index.js"(exports, module) {
     "use strict";
     var pathKey = (options = {}) => {
       const environment = options.env || process.env;
@@ -270,9 +271,9 @@ var require_path_key = __commonJS({
   }
 });
 
-// ../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/cross-spawn/lib/util/resolveCommand.js
+// ../node_modules/cross-spawn/lib/util/resolveCommand.js
 var require_resolveCommand = __commonJS({
-  "../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/cross-spawn/lib/util/resolveCommand.js"(exports, module) {
+  "../node_modules/cross-spawn/lib/util/resolveCommand.js"(exports, module) {
     "use strict";
     var path = __require("path");
     var which = require_which();
@@ -312,9 +313,9 @@ var require_resolveCommand = __commonJS({
   }
 });
 
-// ../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/cross-spawn/lib/util/escape.js
+// ../node_modules/cross-spawn/lib/util/escape.js
 var require_escape = __commonJS({
-  "../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/cross-spawn/lib/util/escape.js"(exports, module) {
+  "../node_modules/cross-spawn/lib/util/escape.js"(exports, module) {
     "use strict";
     var metaCharsRegExp = /([()\][%!^"`<>&|;, *?])/g;
     function escapeCommand(arg) {
@@ -337,17 +338,17 @@ var require_escape = __commonJS({
   }
 });
 
-// ../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/shebang-regex/index.js
+// ../node_modules/shebang-regex/index.js
 var require_shebang_regex = __commonJS({
-  "../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/shebang-regex/index.js"(exports, module) {
+  "../node_modules/shebang-regex/index.js"(exports, module) {
     "use strict";
     module.exports = /^#!(.*)/;
   }
 });
 
-// ../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/shebang-command/index.js
+// ../node_modules/shebang-command/index.js
 var require_shebang_command = __commonJS({
-  "../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/shebang-command/index.js"(exports, module) {
+  "../node_modules/shebang-command/index.js"(exports, module) {
     "use strict";
     var shebangRegex = require_shebang_regex();
     module.exports = (string = "") => {
@@ -365,9 +366,9 @@ var require_shebang_command = __commonJS({
   }
 });
 
-// ../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/cross-spawn/lib/util/readShebang.js
+// ../node_modules/cross-spawn/lib/util/readShebang.js
 var require_readShebang = __commonJS({
-  "../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/cross-spawn/lib/util/readShebang.js"(exports, module) {
+  "../node_modules/cross-spawn/lib/util/readShebang.js"(exports, module) {
     "use strict";
     var fs = __require("fs");
     var shebangCommand = require_shebang_command();
@@ -387,9 +388,9 @@ var require_readShebang = __commonJS({
   }
 });
 
-// ../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/cross-spawn/lib/parse.js
+// ../node_modules/cross-spawn/lib/parse.js
 var require_parse = __commonJS({
-  "../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/cross-spawn/lib/parse.js"(exports, module) {
+  "../node_modules/cross-spawn/lib/parse.js"(exports, module) {
     "use strict";
     var path = __require("path");
     var resolveCommand = require_resolveCommand();
@@ -449,9 +450,9 @@ var require_parse = __commonJS({
   }
 });
 
-// ../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/cross-spawn/lib/enoent.js
+// ../node_modules/cross-spawn/lib/enoent.js
 var require_enoent = __commonJS({
-  "../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/cross-spawn/lib/enoent.js"(exports, module) {
+  "../node_modules/cross-spawn/lib/enoent.js"(exports, module) {
     "use strict";
     var isWin = process.platform === "win32";
     function notFoundError(original, syscall) {
@@ -499,9 +500,9 @@ var require_enoent = __commonJS({
   }
 });
 
-// ../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/cross-spawn/index.js
+// ../node_modules/cross-spawn/index.js
 var require_cross_spawn = __commonJS({
-  "../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/cross-spawn/index.js"(exports, module) {
+  "../node_modules/cross-spawn/index.js"(exports, module) {
     "use strict";
     var cp = __require("child_process");
     var parse = require_parse();
@@ -888,13 +889,13 @@ function parseArgs(argv) {
   return { command: positionals[0], positionals: positionals.slice(1), options, flags };
 }
 
-// ../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/chokidar/esm/index.js
+// ../node_modules/chokidar/esm/index.js
 import { stat as statcb } from "fs";
 import { stat as stat4, readdir as readdir2 } from "fs/promises";
 import { EventEmitter } from "events";
 import * as sysPath2 from "path";
 
-// ../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/readdirp/esm/index.js
+// ../node_modules/readdirp/esm/index.js
 import { stat as stat2, lstat, readdir, realpath } from "fs/promises";
 import { Readable } from "stream";
 import { resolve as presolve, relative as prelative, join as pjoin, sep as psep } from "path";
@@ -1113,7 +1114,7 @@ function readdirp(root, options = {}) {
   return new ReaddirpStream(options);
 }
 
-// ../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/chokidar/esm/handler.js
+// ../node_modules/chokidar/esm/handler.js
 import { watchFile, unwatchFile, watch as fs_watch } from "fs";
 import { open, stat as stat3, lstat as lstat2, realpath as fsrealpath } from "fs/promises";
 import * as sysPath from "path";
@@ -1869,7 +1870,7 @@ var NodeFsHandler = class {
   }
 };
 
-// ../../../../Users/Kdog/Code-Projects/LLMnesia/node_modules/chokidar/esm/index.js
+// ../node_modules/chokidar/esm/index.js
 var SLASH = "/";
 var SLASH_SLASH = "//";
 var ONE_DOT = ".";
@@ -3829,6 +3830,8 @@ Power-user / debugging:
   ingest <file...>     Ingest one or more NDJSON backup files into the corpus
   drain                Ingest every file in <corpus>/inbox; discard clean
                        payloads and quarantine malformed ones
+  retry-quarantine     Retry quarantined files; retain repaired originals in
+                       <corpus>/inbox/recovered (close MCP clients first)
   watch                Watch <corpus>/inbox and ingest new deltas live
   stats                Print corpus counts (conversations, messages, platforms)
   compact              Losslessly compress conversations and remove redundant
@@ -4058,6 +4061,20 @@ async function main() {
       }
       return 0;
     }
+    case "retry-quarantine": {
+      const index = await openSearchIndex(corpus);
+      try {
+        const report = await retryQuarantine(corpus, index);
+        process.stdout.write(
+          `Quarantine recovery: ${report.recovered} recovered, ${report.remaining} remaining, ${report.failed} failed.
+` + (report.archiveDir ? `Original files retained at ${report.archiveDir}
+` : "")
+        );
+        return report.remaining > 0 || report.failed > 0 ? 1 : 0;
+      } finally {
+        index.close();
+      }
+    }
     case "watch": {
       process.stdout.write(`Watching ${corpus.paths.inboxDir} for new deltas (Ctrl+C to stop)\u2026
 `);

package/dist/cli.js

@@ -3,7 +3,7 @@ import { createRequire as __llmnesiaCreateRequire } from "node:module";
 const require = __llmnesiaCreateRequire(import.meta.url);
 import {
   VERSION
-} from "./chunk-ZYE6VY6A.js";
+} from "./chunk-SEBISBN5.js";
 
 // src/nodeDownload.ts
 var NODE_DOWNLOAD_URLS = {
@@ -141,7 +141,7 @@ async function bootstrap() {
     await guideUnsupportedNodeVersion(process.versions.node);
     return 1;
   }
-  const { main } = await import("./cli-RQMFEW5J.js");
+  const { main } = await import("./cli-IF63HSCG.js");
   return main();
 }
 bootstrap().then((code) => {