@llmnesia/mcp 0.2.11 → 0.2.13

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

@@ -14,20 +14,21 @@ import {
   openSearchIndex,
   readAutomaticMaintenanceState,
   resolveCorpusDir,
+  retryQuarantine,
   runtimeBinDir,
   staleIndexFiles,
   uninstallRuntime
-} from "./chunk-7ISC4REX.js";
+} from "./chunk-QIRYUQIU.js";
 import {
   VERSION,
   __commonJS,
   __require,
   __toESM
-} from "./chunk-ZYE6VY6A.js";
+} from "./chunk-GHKXNM7R.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-GHKXNM7R.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-CMCIFSWH.js");
   return main();
 }
 bootstrap().then((code) => {

package/dist/llmnesia-claude-host.mjs

@@ -19,11 +19,13 @@
 // without ~/.llmnesia/config.json this host is exactly as read-only as it
 // has always been for plain session indexing.
 //
-// Protocol v4 (extension → host). v1 was Claude-Code-only: `list` carried no
+// Protocol v5 (extension → host). v1 was Claude-Code-only: `list` carried no
 // `source` and `get` took a bare sessionId. Both remain accepted, so an
 // extension older than this host keeps working; an extension NEWER than the
 // host detects v1 from the pong and syncs Claude Code only.
 //
+// v5 adds per-source listing health and putSourceHealth metadata updates,
+// keeping diagnostics separate from the conversation inbox.
 // v4 adds ZCode to `list`/`get` (the first source backed by a SQLite database
 // rather than per-session files; `get` materializes the transcript as JSONL).
 // The version is informational in both directions, as below: a v3 host never
@@ -34,7 +36,7 @@
 // treats that as "nothing to fetch", so the version is informational: hosts are
 // installed out of band and an extension upgraded ahead of its host is the
 // ordinary case, not a fault.
-//   { cmd: "ping" }                    → { type: "pong", version: 4 }
+//   { cmd: "ping" }                    → { type: "pong", version: 5 }
 //   { cmd: "list" }                    → { type: "list", sessions:
 //                                          [{source, sessionId, mtime, project?, title?}] }
 //   { cmd: "get", source, sessionId }  → one or more { type: "chunk", sessionId, seq, total, data }
@@ -59,10 +61,10 @@ import { chmod, mkdir, readdir, readFile, rename, stat, writeFile } from "node:f
 import { homedir } from "node:os";
 import { join } from "node:path";
 
-// 4 adds ZCode (see the protocol comment above). Do not make it a gate: hosts
+// 5 adds per-source listing health (see the protocol comment above). Do not make it a gate: hosts
 // are installed out of band and a version check would strand every user who
 // upgraded the extension first.
-const PROTOCOL_VERSION = 4;
+const PROTOCOL_VERSION = 5;
 const PROJECTS_DIR = join(homedir(), ".claude", "projects");
 // ZCode keeps every session in one SQLite database (WAL mode) — the first
 // source with no per-session file. The host opens it READ-ONLY and materializes
@@ -134,12 +136,13 @@ function send(message) {
 // One entry per session: { source, sessionId, mtime, project?, title?, path }.
 // `path` is stripped before anything goes on the wire.
 
-async function listClaudeCodeSessions() {
+async function listClaudeCodeSessions(issues) {
   const sessions = [];
   let projectDirs;
   try {
     projectDirs = await readdir(PROJECTS_DIR, { withFileTypes: true });
   } catch {
+    if (issues) issues.failed += 1;
     return sessions; // no ~/.claude/projects yet
   }
   for (const entry of projectDirs) {
@@ -151,6 +154,7 @@ async function listClaudeCodeSessions() {
     try {
       files = await readdir(dir);
     } catch {
+      if (issues) issues.failed += 1;
       continue;
     }
     for (const file of files) {
@@ -168,6 +172,7 @@ async function listClaudeCodeSessions() {
           path
         });
       } catch {
+        if (issues) issues.failed += 1;
         // Skip unreadable files.
       }
     }
@@ -186,18 +191,19 @@ function codexSessionId(filename) {
   return match ? match[1].toLowerCase() : base;
 }
 
-async function walkCodexDir(dir, depth, out) {
+async function walkCodexDir(dir, depth, out, issues) {
   let entries;
   try {
     entries = await readdir(dir, { withFileTypes: true });
   } catch {
+    if (issues) issues.failed += 1;
     return out; // missing or unreadable — nothing to add
   }
   for (const entry of entries) {
     const path = join(dir, entry.name);
     if (entry.isDirectory()) {
       if (depth > 0) {
-        await walkCodexDir(path, depth - 1, out);
+        await walkCodexDir(path, depth - 1, out, issues);
       }
       continue;
     }
@@ -213,6 +219,7 @@ async function walkCodexDir(dir, depth, out) {
         path
       });
     } catch {
+      if (issues) issues.failed += 1;
       // Skip unreadable files.
     }
   }
@@ -249,8 +256,8 @@ async function readCodexThreadNames(codexHome) {
   return titles;
 }
 
-async function listCodexSessions(codexHome) {
-  const sessions = await walkCodexDir(join(codexHome, "sessions"), CODEX_MAX_DEPTH, []);
+async function listCodexSessions(codexHome, issues) {
+  const sessions = await walkCodexDir(join(codexHome, "sessions"), CODEX_MAX_DEPTH, [], issues);
   if (sessions.length === 0) {
     return sessions;
   }
@@ -299,9 +306,10 @@ async function openZcodeDb() {
  * title ("New Session"); only real titles are attached, so the extension's
  * derived "<project> · <first prompt>" still wins when ZCode has no name.
  */
-async function listZcodeSessions() {
+async function listZcodeSessions(issues) {
   const db = await openZcodeDb();
   if (!db) {
+    if (issues) issues.failed += 1;
     return [];
   }
   try {
@@ -331,6 +339,7 @@ async function listZcodeSessions() {
     }
     return sessions;
   } catch {
+    if (issues) issues.failed += 1;
     return []; // unreadable or mid-migration database — ZCode contributes nothing
   } finally {
     db.close();
@@ -467,6 +476,36 @@ async function listSessions() {
   return [...claude, ...codex, ...zcode];
 }
 
+// A missing root and an unreadable source must not both appear as a healthy,
+// empty scan. Paths and transcript data never enter these diagnostics.
+async function listSessionsWithHealth() {
+  const config = await loadConfig();
+  const codexHome = config?.codexHome || DEFAULT_CODEX_HOME;
+  const sources = [
+    ["claude_code", PROJECTS_DIR, (issues) => listClaudeCodeSessions(issues)],
+    ["codex", join(codexHome, "sessions"), (issues) => listCodexSessions(codexHome, issues)],
+    ["zcode", ZCODE_DB, (issues) => listZcodeSessions(issues)]
+  ];
+  const sessions = [];
+  const sourceStatus = {};
+  for (const [source, path, list] of sources) {
+    try {
+      await stat(path);
+    } catch (error) {
+      sourceStatus[source] = { state: error?.code === "ENOENT" ? "missing" : "error" };
+      continue;
+    }
+    const issues = { failed: 0 };
+    try {
+      sessions.push(...await list(issues));
+      sourceStatus[source] = { state: issues.failed > 0 ? "partial" : "ok" };
+    } catch {
+      sourceStatus[source] = { state: "error" };
+    }
+  }
+  return { sessions, sourceStatus };
+}
+
 async function loadConfig() {
   try {
     const raw = await readFile(CONFIG_FILE, "utf8");
@@ -648,6 +687,43 @@ async function readCorpusMemories(corpusRoot) {
   return { memories, skipped };
 }
 
+// A separate metadata channel keeps health heartbeats out of the conversation
+// inbox. Older MCP readers ignore this file and keep their true data age.
+function sourceHealthRow(value) {
+  if (!value || typeof value !== "object") return null;
+  const { source, observedAt, connection, state, lastAttemptAt, lastSuccessfulSyncAt, lastCaptureAt, failedSessions } = value;
+  const time = (v) => Number.isSafeInteger(v) && v >= 0;
+  if (!["claude_code", "codex", "zcode"].includes(source) || !["connected", "disconnected"].includes(connection) ||
+      !["ok", "partial", "missing", "error", "unknown"].includes(state) || !time(observedAt) ||
+      observedAt > Date.now() + 300000 || !time(lastAttemptAt) || lastAttemptAt > observedAt ||
+      (lastSuccessfulSyncAt !== null && (!time(lastSuccessfulSyncAt) || lastSuccessfulSyncAt > observedAt)) ||
+      (lastCaptureAt !== null && (!time(lastCaptureAt) || lastCaptureAt > observedAt)) || !time(failedSessions)) return null;
+  return { source, observedAt, connection, state, lastAttemptAt, lastSuccessfulSyncAt, lastCaptureAt, failedSessions };
+}
+
+async function handleSourceHealth(message) {
+  const config = await loadConfig();
+  if (!config?.corpusRoot || !Array.isArray(message.rows) || message.rows.length > 3) {
+    send({ type: "error", error: "source health: invalid rows or no corpus configured" }); return;
+  }
+  const rows = message.rows.map(sourceHealthRow);
+  if (rows.some((row) => !row)) {
+    send({ type: "error", error: "source health: invalid report" }); return;
+  }
+  const path = join(config.corpusRoot, "source-health-v1.json");
+  let previous = [];
+  try { previous = JSON.parse(await readFile(path, "utf8")); } catch { /* First report. */ }
+  const current = new Map((Array.isArray(previous) ? previous : []).map(sourceHealthRow).filter(Boolean).map((row) => [row.source, row]));
+  for (const row of rows) {
+    if ((current.get(row.source)?.observedAt ?? -1) < row.observedAt) current.set(row.source, row);
+  }
+  await mkdir(config.corpusRoot, { recursive: true, mode: 0o700 });
+  const temp = `${path}.${process.pid}.tmp`;
+  await writeFile(temp, JSON.stringify([...current.values()]) + "\n", { mode: FILE_MODE });
+  await rename(temp, path);
+  send({ type: "sourceHealthAck" });
+}
+
 async function handle(message) {
   if (!message || typeof message !== "object") {
     return;
@@ -662,7 +738,11 @@ async function handle(message) {
       send({ type: "corpusInfo", present: false });
       return;
     }
-    send({ type: "corpusInfo", present: true, root: config.corpusRoot });
+    send({ type: "corpusInfo", present: true, root: config.corpusRoot, sourceHealthSupported: true });
+    return;
+  }
+  if (message.cmd === "putSourceHealth") {
+    await handleSourceHealth(message);
     return;
   }
   if (message.cmd === "putChunk") {
@@ -680,8 +760,8 @@ async function handle(message) {
     return;
   }
   if (message.cmd === "list") {
-    const sessions = await listSessions();
-    send({ type: "list", sessions: sessions.map(({ path, ...rest }) => rest) });
+    const { sessions, sourceStatus } = await listSessionsWithHealth();
+    send({ type: "list", sessions: sessions.map(({ path, ...rest }) => rest), sourceStatus });
     return;
   }
   if (message.cmd === "get") {