@llmnesia/mcp 0.2.12 → 0.2.13

package/README.md

@@ -239,7 +239,24 @@ 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.
 
-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.
+Images are included in the `fp2` fingerprint. MCP 0.2.13 automatically rebuilds
+the derived index as format v8 on first use, recomputing every inventory
+fingerprint from the same canonical records used by retrieval. This repairs
+mixed `fp1`/`fp2` inventories left by earlier versions. The canonical transcripts
+are unchanged, and later opens reuse the rebuilt index. Stop all MCP clients
+before updating and restart them afterward; the first read can take longer
+while rebuilding. Clients starting together wait for the index to become ready.
+An interrupted initial rebuild is retried on the next open. No extension
+history rebuild or backup reimport is needed.
+
+Consumer migration: begin a new complete inventory scan without an old cursor.
+Replace the saved `fp1` baseline with the new `fp2` values and reverify those
+records. Different scheme prefixes are not comparable content revisions.
+Existing `fp2` digests retain their definition and values for unchanged content.
+Future incompatible fingerprint changes require a new scheme prefix, an index
+migration and a documented consumer migration before release.
+
+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:
 
@@ -256,8 +273,8 @@ state, account and model identifiers, summaries, and other derived fields are
 excluded too. An identical re-ingest therefore never changes the fingerprint,
 while an edited message or a rename always does, even when nothing else about
 the record moved. The fingerprint is stored in the derived search index
-(index format v5; opening an older index triggers a rebuild that computes
-fingerprints for the existing corpus), so a scan never decompresses a single
+(index format v8; opening an older index triggers a rebuild that computes
+`fp2` fingerprints for the existing corpus), so a scan never decompresses a single
 transcript.
 
 A periodic-processing loop:
@@ -269,9 +286,9 @@ A periodic-processing loop:
    be skipped.
 3. Call `get_conversation` only for the new or changed ids. Its response
    carries `contentFingerprint`, the fingerprint of the transcript it returns.
-   If that differs from the inventory entry, the conversation changed after
-   your snapshot was taken and the transcript you just fetched is the current
-   content.
+   Within the same scheme, a different digest means the conversation changed
+   after your snapshot was taken and the fetched transcript is current. A
+   different scheme prefix requires the baseline migration described above.
 
 ### Read-only mode (`LLMNESIA_READ_ONLY`)
 

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

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

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

@@ -3,7 +3,7 @@ import { createRequire as __llmnesiaCreateRequire } from "node:module";
 const require = __llmnesiaCreateRequire(import.meta.url);
 import {
   VERSION
-} from "./chunk-SEBISBN5.js";
+} from "./chunk-GHKXNM7R.js";
 
 // src/images.ts
 var MAX_BYTES = 2 * 1024 * 1024;
@@ -85,7 +85,7 @@ function expandHome(p) {
 import { join as join2 } from "path";
 import { readdir } from "fs/promises";
 import { createHash } from "crypto";
-var INDEX_FORMAT_VERSION = 7;
+var INDEX_FORMAT_VERSION = 8;
 function indexDbFilename(version) {
   return version === 1 ? "llmnesia.db" : `llmnesia-v${version}.db`;
 }
@@ -1217,6 +1217,8 @@ var TITLE_ROW_INDEX = -1;
 var TITLE_ROLE = "title";
 var DEFAULT_LIMIT = 10;
 var SNIPPET_TOKENS = 12;
+var INDEX_OPEN_BUSY_TIMEOUT_MS = 5 * 6e4;
+var INDEX_OPEN_BUSY_RETRY_MS = 50;
 var META_SQL = `
 CREATE TABLE IF NOT EXISTS index_meta (
   key TEXT PRIMARY KEY,
@@ -1301,52 +1303,64 @@ var SearchIndex = class {
     this.corpus = corpus;
     hardenDbFile(dbPath);
     this.db = new (loadSqlite()).DatabaseSync(dbPath);
-    this.db.exec("PRAGMA journal_mode = WAL");
-    this.db.exec("PRAGMA foreign_keys = OFF");
-    this.db.exec(META_SQL);
-    this.staleOnOpen = this.getMeta("format_version") !== String(INDEX_FORMAT_VERSION);
-    if (this.staleOnOpen) {
-      this.db.exec(DROP_DERIVED_SQL);
-    }
-    this.db.exec(SCHEMA_SQL);
-    this.db.exec("PRAGMA temp_store = MEMORY");
-    this.db.exec(`CREATE VIRTUAL TABLE IF NOT EXISTS temp.snippet_fts USING fts5(
-      text, tokenize = 'porter unicode61'
-    )`);
-    this.setMeta("format_version", String(INDEX_FORMAT_VERSION));
-    this.stmts = {
-      selectFtsRows: this.db.prepare("SELECT rowid FROM message_rows WHERE docId = ?"),
-      deleteFts: this.db.prepare("DELETE FROM messages_fts WHERE rowid = ?"),
-      deleteMessageRows: this.db.prepare("DELETE FROM message_rows WHERE docId = ?"),
-      insertMessageRow: this.db.prepare(
-        "INSERT INTO message_rows (docId, msgIndex, role) VALUES (?, ?, ?) RETURNING rowid"
-      ),
-      insertFts: this.db.prepare("INSERT INTO messages_fts (rowid, text) VALUES (?, ?)"),
-      deleteConversation: this.db.prepare("DELETE FROM conversations WHERE docId = ?"),
-      insertConversation: this.db.prepare(
-        `INSERT INTO conversations
-           (docId, platform, title, url, createdAt, updatedAt, messageCount, preview, pinned, accountId, accountLabel, providerProject, providerWorkspace, models, fingerprint)
-         VALUES (@docId, @platform, @title, @url, @createdAt, @updatedAt, @messageCount, @preview, @pinned, @accountId, @accountLabel, @providerProject, @providerWorkspace, @models, @fingerprint)`
-      ),
-      deleteMemoryFts: this.db.prepare("DELETE FROM memories_fts WHERE memoryId = ?"),
-      insertMemoryFts: this.db.prepare(
-        "INSERT INTO memories_fts (memoryId, label, text) VALUES (?, ?, ?)"
-      ),
-      deleteMemory: this.db.prepare("DELETE FROM memories WHERE memoryId = ?"),
-      insertMemory: this.db.prepare(
-        `INSERT INTO memories
-           (memoryId, kind, label, text, source, pinned, enabled, createdAt, updatedAt)
-         VALUES (@memoryId, @kind, @label, @text, @source, @pinned, @enabled, @createdAt, @updatedAt)`
-      ),
-      clearSnippetFts: this.db.prepare("DELETE FROM temp.snippet_fts"),
-      insertSnippetFts: this.db.prepare("INSERT INTO temp.snippet_fts (text) VALUES (?)"),
-      renderSnippet: this.db.prepare(
-        `SELECT snippet(snippet_fts, 0, '[', ']', '\u2026', ${SNIPPET_TOKENS}) AS snippet
-         FROM temp.snippet_fts WHERE snippet_fts MATCH ?`
-      )
-    };
-    for (const statement of Object.values(this.stmts)) {
-      statement.setReadBigInts(true);
+    try {
+      this.db.exec("PRAGMA journal_mode = WAL");
+      this.db.exec("PRAGMA foreign_keys = OFF");
+      this.db.exec("BEGIN IMMEDIATE");
+      try {
+        this.db.exec(META_SQL);
+        this.staleOnOpen = this.getMeta("format_version") !== String(INDEX_FORMAT_VERSION);
+        if (this.staleOnOpen) {
+          this.db.exec(DROP_DERIVED_SQL);
+        }
+        this.db.exec(SCHEMA_SQL);
+        this.setMeta("format_version", String(INDEX_FORMAT_VERSION));
+        this.db.exec("COMMIT");
+      } catch (error) {
+        this.db.exec("ROLLBACK");
+        throw error;
+      }
+      this.db.exec("PRAGMA temp_store = MEMORY");
+      this.db.exec(`CREATE VIRTUAL TABLE IF NOT EXISTS temp.snippet_fts USING fts5(
+        text, tokenize = 'porter unicode61'
+      )`);
+      this.stmts = {
+        selectFtsRows: this.db.prepare("SELECT rowid FROM message_rows WHERE docId = ?"),
+        deleteFts: this.db.prepare("DELETE FROM messages_fts WHERE rowid = ?"),
+        deleteMessageRows: this.db.prepare("DELETE FROM message_rows WHERE docId = ?"),
+        insertMessageRow: this.db.prepare(
+          "INSERT INTO message_rows (docId, msgIndex, role) VALUES (?, ?, ?) RETURNING rowid"
+        ),
+        insertFts: this.db.prepare("INSERT INTO messages_fts (rowid, text) VALUES (?, ?)"),
+        deleteConversation: this.db.prepare("DELETE FROM conversations WHERE docId = ?"),
+        insertConversation: this.db.prepare(
+          `INSERT INTO conversations
+             (docId, platform, title, url, createdAt, updatedAt, messageCount, preview, pinned, accountId, accountLabel, providerProject, providerWorkspace, models, fingerprint)
+           VALUES (@docId, @platform, @title, @url, @createdAt, @updatedAt, @messageCount, @preview, @pinned, @accountId, @accountLabel, @providerProject, @providerWorkspace, @models, @fingerprint)`
+        ),
+        deleteMemoryFts: this.db.prepare("DELETE FROM memories_fts WHERE memoryId = ?"),
+        insertMemoryFts: this.db.prepare(
+          "INSERT INTO memories_fts (memoryId, label, text) VALUES (?, ?, ?)"
+        ),
+        deleteMemory: this.db.prepare("DELETE FROM memories WHERE memoryId = ?"),
+        insertMemory: this.db.prepare(
+          `INSERT INTO memories
+             (memoryId, kind, label, text, source, pinned, enabled, createdAt, updatedAt)
+           VALUES (@memoryId, @kind, @label, @text, @source, @pinned, @enabled, @createdAt, @updatedAt)`
+        ),
+        clearSnippetFts: this.db.prepare("DELETE FROM temp.snippet_fts"),
+        insertSnippetFts: this.db.prepare("INSERT INTO temp.snippet_fts (text) VALUES (?)"),
+        renderSnippet: this.db.prepare(
+          `SELECT snippet(snippet_fts, 0, '[', ']', '\u2026', ${SNIPPET_TOKENS}) AS snippet
+           FROM temp.snippet_fts WHERE snippet_fts MATCH ?`
+        )
+      };
+      for (const statement of Object.values(this.stmts)) {
+        statement.setReadBigInts(true);
+      }
+    } catch (error) {
+      this.db.close();
+      throw error;
     }
   }
   /** True when the stored format version was missing or stale — caller rebuilds. */
@@ -1661,15 +1675,24 @@ var SearchIndex = class {
 };
 async function openSearchIndex(corpus, options = {}) {
   await corpus.init();
-  const index = new SearchIndex(corpus.paths.indexDbFile, corpus);
-  try {
-    if (options.autoBuild !== false && (index.needsRebuild() || index.count() === 0 && index.countMemories() === 0)) {
-      await index.rebuildFrom(corpus);
+  const deadline = Date.now() + (options.busyTimeoutMs ?? INDEX_OPEN_BUSY_TIMEOUT_MS);
+  for (; ; ) {
+    let index;
+    try {
+      index = new SearchIndex(corpus.paths.indexDbFile, corpus);
+      if (options.autoBuild !== false && (index.needsRebuild() || index.count() === 0 && index.countMemories() === 0)) {
+        await index.rebuildFrom(corpus);
+      }
+      return index;
+    } catch (error) {
+      index?.close();
+      const code = error?.errcode;
+      if (typeof code !== "number" || ![5, 6].includes(code & 255)) throw error;
+      if (Date.now() >= deadline) {
+        throw new Error("The local conversation index is busy. Wait for other MCP clients to finish updating it, then restart this client.", { cause: error });
+      }
+      await new Promise((resolve2) => setTimeout(resolve2, INDEX_OPEN_BUSY_RETRY_MS));
     }
-    return index;
-  } catch (error) {
-    index.close();
-    throw error;
   }
 }
 async function deleteIndexDb(dbFile) {

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

@@ -18,13 +18,13 @@ import {
   runtimeBinDir,
   staleIndexFiles,
   uninstallRuntime
-} from "./chunk-3QDA3XWA.js";
+} from "./chunk-QIRYUQIU.js";
 import {
   VERSION,
   __commonJS,
   __require,
   __toESM
-} from "./chunk-SEBISBN5.js";
+} from "./chunk-GHKXNM7R.js";
 
 // ../node_modules/isexe/windows.js
 var require_windows = __commonJS({

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-SEBISBN5.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-IF63HSCG.js");
+  const { main } = await import("./cli-CMCIFSWH.js");
   return main();
 }
 bootstrap().then((code) => {

package/dist/mcp.js

@@ -15,13 +15,13 @@ import {
   runAutomaticMaintenance,
   scheduleSelfUpdate,
   upsertIndexedConversation
-} from "./chunk-3QDA3XWA.js";
+} from "./chunk-QIRYUQIU.js";
 import {
   VERSION,
   __commonJS,
   __export,
   __toESM
-} from "./chunk-SEBISBN5.js";
+} from "./chunk-GHKXNM7R.js";
 
 // ../node_modules/ajv/dist/compile/codegen/code.js
 var require_code = __commonJS({
@@ -22190,7 +22190,7 @@ async function runServe() {
     "conversation_inventory",
     {
       title: "Conversation inventory",
-      description: "Read-only, paginated inventory of every conversation in the corpus as compact metadata: stable id, platform, title, and a versioned content fingerprint. Never returns transcripts. Built for services that periodically process the corpus: call it with no arguments to start a scan, then pass each page's nextCursor back as cursor until a page comes back without one. All pages of a scan reflect the same consistent snapshot taken when the scan started, so conversations that arrive or change mid-scan never shuffle the results; start a new scan (omit cursor) to see them. Compare ids and fingerprints against the previous scan and call get_conversation only for new or changed ids. Cursors expire and do not survive a server restart; on a cursor error, simply begin a new scan.",
+      description: "Read-only, paginated inventory of every conversation in the corpus as compact metadata: stable id, platform, title, and a versioned content fingerprint. Never returns transcripts. Built for services that periodically process the corpus: call it with no arguments to start a scan, then pass each page's nextCursor back as cursor until a page comes back without one. All pages of a scan reflect the same consistent snapshot taken when the scan started, so conversations that arrive or change mid-scan never shuffle the results; start a new scan (omit cursor) to see them. Compare ids and fingerprints against the previous scan and call get_conversation only for new or changed ids. Cursors expire and do not survive a server restart; on a cursor error, simply begin a new scan. Fingerprints use fp2, including images, matching get_conversation's contentFingerprint for unchanged content. When upgrading from fp1, take a new complete inventory as your baseline; different scheme prefixes cannot be compared as content revisions.",
       inputSchema: {
         cursor: external_exports.string().optional().describe("Opaque nextCursor from the previous page. Omit to start a new scan."),
         limit: external_exports.number().int().min(1).max(100).optional().describe("Items per page (default 100).")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmnesia/mcp",
-  "version": "0.2.12",
+  "version": "0.2.13",
   "private": false,
   "type": "module",
   "comment:mcpName": "The MCP Registry's ownership marker: it must equal server.json's `name`, and the namespace must match how you authenticate with mcp-publisher. `com.llmnesia/...` requires DNS auth (a TXT record on llmnesia.com) — see docs/MCP_INSTALLER_BOARD.md.",

package/server.json

@@ -3,13 +3,13 @@
   "name": "com.llmnesia/mcp",
   "title": "LLMnesia",
   "description": "Search your AI chat history from Claude, Cursor, Codex, and other MCP clients.",
-  "version": "0.2.12",
+  "version": "0.2.13",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@llmnesia/mcp",
-      "version": "0.2.12",
+      "version": "0.2.13",
       "transport": {
         "type": "stdio"
       }