claude-mem-lite 2.77.0 → 2.78.0

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
   "plugins": [
     {
       "name": "claude-mem-lite",
-      "version": "2.77.0",
+      "version": "2.78.0",
       "source": "./",
       "description": "Lightweight persistent memory system for Claude Code — FTS5 search, episode batching, error-triggered recall"
     }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem-lite",
-  "version": "2.77.0",
+  "version": "2.78.0",
   "description": "Lightweight persistent memory system for Claude Code — FTS5 search, episode batching, error-triggered recall",
   "author": {
     "name": "sdsrss"

package/.mcp.json

@@ -1,6 +1,6 @@
 {
   "mcpServers": {
-    "mem": {
+    "mem-lite": {
       "command": "node",
       "args": [
         "${CLAUDE_PLUGIN_ROOT}/scripts/launch.mjs"

package/README.md

@@ -159,7 +159,7 @@ Source files stay in the cloned repo. Update via `git pull && node install.mjs i
 ### What happens during installation
 
 1. **Install dependencies** -- `npm install --omit=dev` (compiles native `better-sqlite3`)
-2. **Register MCP server** -- `mem` server with 16 tools (search, recent, recall, timeline, get, save, update, stats, delete, compress, maintain, export, fts_check, browse, registry, use)
+2. **Register MCP server** -- `mem-lite` server with 16 tools (search, recent, recall, timeline, get, save, update, stats, delete, compress, maintain, export, fts_check, browse, registry, use). The pre-v2.78 generic server name `mem` is renamed to `mem-lite` for namespace hygiene; the tool names themselves (`mem_search`, `mem_recall`, ...) are unchanged.
 3. **Configure hooks** -- `PostToolUse`, `SessionStart`, `Stop`, `UserPromptSubmit` lifecycle hooks
 4. **Create data directory** -- `~/.claude-mem-lite/` (hidden) for database, runtime, and managed resource files
 5. **Auto-migrate** -- If `~/.claude-mem/` (original claude-mem) or `~/claude-mem-lite/` (pre-v0.5 unhidden) exists, migrates database and runtime files to `~/.claude-mem-lite/`, preserving the original untouched
@@ -303,7 +303,7 @@ Slash commands `/adopt` and `/unadopt` wrap the same CLI.
   in the adopted project).
 - The MCP server instructions are built once at server boot and MCP has no
   "push" protocol — the `WHEN TO USE` / `Decision rules` trim only applies
-  after Claude Code restarts and re-spawns the mem MCP server. A single
+  after Claude Code restarts and re-spawns the mem-lite MCP server. A single
   `/exit` + fresh session is enough. Same caveat applies to `unadopt`.
 
 **Safety:**

package/README.zh-CN.md

@@ -146,7 +146,7 @@ node install.mjs install
 ### 安装过程
 
 1. **安装依赖** -- `npm install --omit=dev`（编译原生 `better-sqlite3`）
-2. **注册 MCP 服务器** -- `mem` 服务器，包含 15 个工具（search、recent、recall、timeline、get、save、update、stats、delete、compress、maintain、export、fts_check、browse、registry）
+2. **注册 MCP 服务器** -- `mem-lite` 服务器，包含 15 个工具（search、recent、recall、timeline、get、save、update、stats、delete、compress、maintain、export、fts_check、browse、registry）。v2.78 前服务器名为通用的 `mem`，现已改名为 `mem-lite` 避免与用户其它 `.mcp.json` 冲突；工具名（`mem_search`/`mem_recall` 等）保持不变。
 3. **配置钩子** -- `PostToolUse`、`PreToolUse`、`SessionStart`、`Stop`、`UserPromptSubmit` 生命周期钩子
 4. **创建数据目录** -- `~/.claude-mem-lite/`（隐藏目录），存放数据库、运行时和托管资源文件
 5. **自动迁移** -- 自动检测 `~/.claude-mem/`（原版 claude-mem）或 `~/claude-mem-lite/`（v0.5 前的非隐藏目录），将数据库和运行时文件迁移到 `~/.claude-mem-lite/`，原目录保持不变
@@ -282,7 +282,7 @@ Slash 命令 `/adopt` 和 `/unadopt` 是上述 CLI 的包装。
   后缀）**下一次 SessionStart** 生效（adopt 的项目下任一新会话）。
 - MCP server instructions 是**服务启动时构建一次**，MCP 协议无 "push" 机制，
   所以 `WHEN TO USE` / `Decision rules` 两段的瘦身**只在 Claude Code 重启后**
-  才生效（mem MCP 服务被重新 spawn）。`/exit` 一次再开新会话即可。`unadopt`
+  才生效（mem-lite MCP 服务被重新 spawn）。`/exit` 一次再开新会话即可。`unadopt`
   同理。
 
 **安全性：**

package/commands/adopt.md

@@ -52,7 +52,7 @@ session. After running `adopt`:
   on the next SessionStart.
 - MCP-instructions trim (`WHEN TO USE` / `Decision rules` sections) only
   takes effect after Claude Code itself restarts (or at least re-attaches
-  the mem MCP server). If you still see the verbose MCP instructions after
+  the mem-lite MCP server). If you still see the verbose MCP instructions after
   adopt, a `/exit` + fresh session is enough.
 
 Same caveat applies in reverse for `/unadopt`.

package/hook-update.mjs

@@ -311,16 +311,23 @@ export function installExtractedRelease(sourceDir, targetDir = INSTALL_DIR) {
     rmSync(stagingDir, { recursive: true, force: true });
     rmSync(backupDir, { recursive: true, force: true });
 
-    // Post-update migration: clean stale global MCP if plugin handles it
+    // Post-update migration: clean stale global MCPs if plugin handles it.
+    // Both "mem" (legacy, pre-v2.78) and "mem-lite" (current) are purged so a
+    // user who manually ran `claude mcp add` in either era doesn't end up with
+    // duplicate global + plugin registrations after the rename.
     try {
       if (isPluginMode()) {
         const claudeJsonPath = join(homedir(), '.claude.json');
         const cfg = JSON.parse(readFileSync(claudeJsonPath, 'utf8'));
-        if (cfg.mcpServers?.mem) {
-          delete cfg.mcpServers.mem;
-          writeFileSync(claudeJsonPath, JSON.stringify(cfg, null, 2) + '\n');
-          debugLog('DEBUG', 'hook-update', 'Post-update: removed stale global MCP "mem"');
+        let changed = false;
+        for (const k of ['mem', 'mem-lite']) {
+          if (cfg.mcpServers?.[k]) {
+            delete cfg.mcpServers[k];
+            changed = true;
+            debugLog('DEBUG', 'hook-update', `Post-update: removed stale global MCP "${k}"`);
+          }
         }
+        if (changed) writeFileSync(claudeJsonPath, JSON.stringify(cfg, null, 2) + '\n');
       }
     } catch (e) { debugCatch(e, 'post-update-mcp-dedup'); }
 

package/hook.mjs

@@ -51,6 +51,7 @@ import {
   bumpCitationAccess,
   computeCiteRecall,
   applyCitationDecay,
+  hasMainThreadAssistantText,
 } from './lib/citation-tracker.mjs';
 import { extractTailAssistantText, extractStructuredSummary } from './lib/summary-extractor.mjs';
 import { searchRelevantMemories, formatMemoryLine } from './hook-memory.mjs';
@@ -537,9 +538,20 @@ async function handleStop() {
           try {
             const injected = extractAllInjected(transcriptPath);
             if (injected.size > 0) {
-              const citedMain = extractCitationsFromTranscript(transcriptPath, { mainOnly: true });
-              const r = applyCitationDecay(db, project, injected, citedMain, sessionId);
-              debugLog('DEBUG', 'handleStop', `citation-decay: touched=${r.touched} promoted=${r.promoted} demoted=${r.demoted}`);
+              // Text-floor gate: skip decay on tool-only Stops. Without this,
+              // a turn that ends on tool_use locks every injected obs as
+              // uncited (last_decided_session_id set), so a later turn that
+              // cites correctly can't undo the verdict. Per CLAUDE.md the
+              // contract is "NEXT time you produce user-facing text," so a
+              // session with zero main-thread text gets a free pass — the
+              // next Stop in the same session will re-evaluate.
+              if (!hasMainThreadAssistantText(transcriptPath)) {
+                debugLog('DEBUG', 'handleStop', `citation-decay: skipped (no main-thread assistant text yet, injected=${injected.size})`);
+              } else {
+                const citedMain = extractCitationsFromTranscript(transcriptPath, { mainOnly: true });
+                const r = applyCitationDecay(db, project, injected, citedMain, sessionId);
+                debugLog('DEBUG', 'handleStop', `citation-decay: touched=${r.touched} promoted=${r.promoted} demoted=${r.demoted}`);
+              }
             }
           } catch (e) { debugCatch(e, 'handleStop-citation-decay'); }
 

package/install.mjs

@@ -428,10 +428,12 @@ async function install() {
   }
 
   // 3. Register MCP server (skip if plugin system already handles it)
-  // Plugin MCP must stay at root .mcp.json so Claude Code registers plugin:*:mem.
-  // Duplicate mem registrations in practice come from old global install.mjs state
+  // Plugin MCP must stay at root .mcp.json so Claude Code registers plugin:*:mem-lite.
+  // Duplicate registrations in practice come from old global install.mjs state
   // (claude mcp add) or stale marketplace copies, not from the cache root itself.
-  // Global registration via `claude mcp add` creates a DUPLICATE mcp__mem__* server.
+  // Global registration via `claude mcp add` creates a DUPLICATE mcp__mem-lite__* server.
+  // The legacy generic name "mem" (pre-v2.78) is also purged so a user who installed in
+  // either era ends up with a single canonical "mem-lite" registration.
   // Detect plugin mode: installed_plugins.json has our entry → plugin handles MCP.
   const installedPluginsPath = join(homedir(), '.claude', 'plugins', 'installed_plugins.json');
   let pluginHandlesMcp = false;
@@ -442,18 +444,26 @@ async function install() {
 
   if (pluginHandlesMcp) {
     log('MCP server: plugin system handles registration (skipping global)');
-    // Clean up stale global registration if it exists (from older install.mjs versions)
-    try { execFileSync('claude', ['mcp', 'remove', '-s', 'user', 'mem'], { stdio: 'pipe' }); ok('Removed stale global MCP registration'); } catch {}
+    // Clean up stale global registrations (both legacy "mem" and current "mem-lite")
+    for (const name of ['mem', 'mem-lite']) {
+      try {
+        execFileSync('claude', ['mcp', 'remove', '-s', 'user', name], { stdio: 'pipe' });
+        ok(`Removed stale global MCP "${name}"`);
+      } catch {}
+    }
   } else {
     log('Registering MCP server...');
     try {
-      try { execFileSync('claude', ['mcp', 'remove', '-s', 'user', 'mem'], { stdio: 'pipe' }); } catch {}
-      execFileSync('claude', ['mcp', 'add', '-s', 'user', '-t', 'stdio', 'mem', '--', 'node', SERVER_PATH], { stdio: 'pipe' });
-      try { execFileSync('claude', ['mcp', 'remove', '-s', 'project', 'mem'], { stdio: 'pipe' }); } catch {}
-      ok('MCP server registered: mem');
+      // Purge legacy "mem" and any pre-existing "mem-lite" before re-registering
+      for (const name of ['mem', 'mem-lite']) {
+        try { execFileSync('claude', ['mcp', 'remove', '-s', 'user', name], { stdio: 'pipe' }); } catch {}
+        try { execFileSync('claude', ['mcp', 'remove', '-s', 'project', name], { stdio: 'pipe' }); } catch {}
+      }
+      execFileSync('claude', ['mcp', 'add', '-s', 'user', '-t', 'stdio', 'mem-lite', '--', 'node', SERVER_PATH], { stdio: 'pipe' });
+      ok('MCP server registered: mem-lite');
     } catch (e) {
       fail('MCP registration failed: ' + e.message);
-      warn('Try manually: claude mcp add -s user -t stdio mem -- node ' + SERVER_PATH);
+      warn('Try manually: claude mcp add -s user -t stdio mem-lite -- node ' + SERVER_PATH);
     }
   }
 
@@ -933,13 +943,18 @@ async function install() {
 async function uninstall() {
   console.log('\nclaude-mem-lite uninstaller\n');
 
-  // 1. Remove MCP (legacy hook-based install)
-  try {
-    execFileSync('claude', ['mcp', 'remove', '-s', 'user', 'mem'], { stdio: 'pipe' });
-    ok('MCP server removed');
-  } catch {
-    warn('MCP server not found or already removed');
+  // 1. Remove MCP (legacy hook-based install).
+  // Try both the legacy "mem" (pre-v2.78) and current "mem-lite" names so a user
+  // who installed in either era ends up clean.
+  let removedAny = false;
+  for (const name of ['mem', 'mem-lite']) {
+    try {
+      execFileSync('claude', ['mcp', 'remove', '-s', 'user', name], { stdio: 'pipe' });
+      ok(`MCP server removed: ${name}`);
+      removedAny = true;
+    } catch {}
   }
+  if (!removedAny) warn('MCP server not found or already removed');
 
   // 1b. Remove CLI symlink
   for (const binDir of [join(homedir(), '.local', 'bin'), '/usr/local/bin']) {
@@ -1068,7 +1083,11 @@ async function status() {
   // MCP
   try {
     const list = execFileSync('claude', ['mcp', 'list'], { encoding: 'utf8' });
-    const registered = list.includes('mem:') || list.includes('mem ');
+    // Accept either the current "mem-lite" registration or the legacy "mem"
+    // name (pre-v2.78) so a user mid-upgrade still sees a green status until
+    // setup.sh / install.mjs purges the legacy entry on next run.
+    const registered = list.includes('mem-lite:') || list.includes('mem-lite ')
+      || list.includes('mem:') || /\bmem\b\s/.test(list);
     push(registered ? 'ok' : 'fail', 'mcp', registered ? 'MCP server: registered' : 'MCP server: not registered', { registered });
   } catch {
     push('warn', 'mcp', 'Could not check MCP status', { registered: null });

package/lib/citation-tracker.mjs

@@ -266,6 +266,39 @@ export function extractAllInjected(transcriptPath) {
   ]);
 }
 
+/**
+ * True iff the transcript contains at least one non-whitespace text block from
+ * a main-thread assistant turn. Gates the citation-decay loop so a tool-only
+ * Stop doesn't lock an injection as "uncited" before the model has had a
+ * chance to produce user-facing text. Per CLAUDE.md the cite contract is
+ * "NEXT time you produce user-facing text" — not "same turn." Without this
+ * gate, a turn that ends on tool_use sees applyCitationDecay run, set
+ * last_decided_session_id, and freeze the verdict at uncited even though a
+ * later turn in the same session would have cited correctly.
+ *
+ * @param {string|null|undefined} transcriptPath
+ * @returns {boolean}
+ */
+export function hasMainThreadAssistantText(transcriptPath) {
+  if (!transcriptPath || !existsSync(transcriptPath)) return false;
+  let raw;
+  try { raw = readFileSync(transcriptPath, 'utf8'); } catch { return false; }
+  for (const line of raw.split('\n')) {
+    if (!line.trim()) continue;
+    let entry;
+    try { entry = JSON.parse(line); } catch { continue; }
+    if (entry.type !== 'assistant' || !entry.message) continue;
+    if (entry.isSidechain === true) continue;
+    const content = entry.message.content;
+    if (!Array.isArray(content)) continue;
+    for (const block of content) {
+      if (block.type !== 'text' || typeof block.text !== 'string') continue;
+      if (block.text.trim().length > 0) return true;
+    }
+  }
+  return false;
+}
+
 const IMPORTANCE_CAP = 3;
 const IMPORTANCE_FLOOR = 0;
 const UNCITED_STREAK_THRESHOLD = 3;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem-lite",
-  "version": "2.77.0",
+  "version": "2.78.0",
   "description": "Lightweight persistent memory system for Claude Code",
   "type": "module",
   "packageManager": "npm@10.9.2",

package/scripts/post-tool-use.sh

@@ -51,7 +51,7 @@ case "$tool" in
     exit 0
     ;;
   # Prefix filters
-  mem_*|mcp__mem__*|mcp__plugin_claude-mem-lite*|mcp__sequential*|mcp__plugin_context7*)
+  mem_*|mcp__mem__*|mcp__mem-lite__*|mcp__plugin_claude-mem-lite*|mcp__sequential*|mcp__plugin_context7*)
     exit 0
     ;;
 esac

package/scripts/setup.sh

@@ -87,29 +87,36 @@ if [[ ! -d "$ROOT/node_modules/better-sqlite3" ]]; then
   fi
 fi
 
-# 7. MCP cleanup: idempotently clean stale registrations from pre-2.10 direct installs.
-#    This runs on every plugin SessionStart because old global mem entries may still
+# 7. MCP cleanup: idempotently clean stale registrations from older installs.
+#    This runs on every plugin SessionStart because old global entries may still
 #    exist even after an earlier migration marker was written.
-#    Before 2.10: old direct installs left a global mem MCP alongside plugin MCP.
-#    - Global mcpServers.mem in ~/.claude.json (from old install.mjs)
-#    - Possibly stale marketplace root .mcp.json (from old git clone)
+#    - Pre-2.10: direct installs left a global "mem" MCP alongside plugin MCP.
+#    - Pre-2.78: plugin and global registrations used the generic name "mem";
+#      v2.78 renamed to "mem-lite" — any stale global "mem" must be purged so
+#      Claude Code doesn't surface duplicate (old "mem" + new "mem-lite") tool
+#      prefixes side-by-side.
 #    Root .mcp.json in the installed plugin cache is required for Claude Code to
 #    register plugin MCP; only stale global/marketplace copies should be removed.
-MCP_MIGRATION="$DATA_DIR/runtime/.mcp-dedup-v2.10.4"
+MCP_MIGRATION="$DATA_DIR/runtime/.mcp-dedup-v2.78"
 if [[ -n "${CLAUDE_PLUGIN_ROOT:-}" ]]; then
   CLAUDE_JSON="$HOME/.claude.json" node -e '
     const fs = require("fs");
     let changed = false;
-    // Remove stale global MCP registration (plugin .mcp.json handles it)
+    // Remove stale global MCP registrations (plugin .mcp.json handles it).
+    // Both "mem" (legacy, pre-v2.78) and "mem-lite" (current) are purged from
+    // user-global scope when running inside the plugin — the plugin manifest
+    // is the single source of truth.
     try {
       const p = process.env.CLAUDE_JSON;
       const d = JSON.parse(fs.readFileSync(p, "utf8"));
-      if (d.mcpServers?.mem) {
-        delete d.mcpServers.mem;
-        fs.writeFileSync(p, JSON.stringify(d, null, 2) + "\n");
-        process.stderr.write("✓ Removed stale global MCP \"mem\" (plugin handles it)\n");
-        changed = true;
+      for (const k of ["mem", "mem-lite"]) {
+        if (d.mcpServers?.[k]) {
+          delete d.mcpServers[k];
+          process.stderr.write(`✓ Removed stale global MCP "${k}" (plugin handles it)\n`);
+          changed = true;
+        }
       }
+      if (changed) fs.writeFileSync(p, JSON.stringify(d, null, 2) + "\n");
     } catch {}
     // NOTE: Do NOT touch marketplace .mcp.json — Claude Code copies it from
     // marketplace → plugin cache on updates. Clearing it causes the cache

package/server.mjs

@@ -12,7 +12,7 @@ import { ensureDb, DB_PATH, REGISTRY_DB_PATH } from './schema.mjs';
 import { reRankWithContext, markSuperseded, autoBoostIfNeeded, runIdleCleanup, buildServerInstructions } from './server-internals.mjs';
 import { searchObservationsHybrid, findFtsAnchor } from './search-engine.mjs';
 import { scrubRecord } from './lib/scrub-record.mjs';
-import { effectiveQuiet } from './hook-shared.mjs';
+import { effectiveQuiet, RUNTIME_DIR } from './hook-shared.mjs';
 import { computeTier, TIER_CASE_SQL, tierSqlParams } from './tier.mjs';
 import { memSearchSchema, memRecentSchema, memTimelineSchema, memGetSchema, memDeleteSchema, memSaveSchema, memStatsSchema, memCompressSchema, memMaintainSchema, memOptimizeSchema, memUpdateSchema, memExportSchema, memRecallSchema, memFtsCheckSchema, memRegistrySchema, memBrowseSchema, memUseSchema, memDeferSchema, memDeferListSchema, memDeferDropSchema, tools as TOOL_DEFS } from './tool-schemas.mjs';
 
@@ -43,7 +43,7 @@ const { version: PKG_VERSION } = require('./package.json');
 
 // ─── Database ───────────────────────────────────────────────────────────────
 
-import { rmSync, existsSync, readFileSync } from 'fs';
+import { rmSync, existsSync, readFileSync, appendFileSync, mkdirSync } from 'fs';
 
 let db;
 try {
@@ -127,7 +127,7 @@ if (process.env.CLAUDE_MEM_QUIET_TRACE !== '0') {
 }
 
 const server = new McpServer(
-  { name: 'claude-mem-lite', version: PKG_VERSION },
+  { name: 'mem-lite', version: PKG_VERSION },
   { instructions: buildServerInstructions(_quiet) },
 );
 
@@ -2267,5 +2267,24 @@ process.on('unhandledRejection', (err) => { debugCatch(err, 'unhandledRejection'
 
 // ─── Start Server ───────────────────────────────────────────────────────────
 
+// Spawn telemetry — appends one JSON line per process start so we can diagnose
+// dual-registration (plugin namespace + local .mcp.json could both spawn the
+// server in one Claude Code session). Two records with close timestamps and
+// the same ppid is the smoking gun. Never throws — telemetry must not block
+// startup. Disable with MEM_DISABLE_SPAWN_LOG=1.
+if (process.env.MEM_DISABLE_SPAWN_LOG !== '1') {
+  try {
+    if (!existsSync(RUNTIME_DIR)) mkdirSync(RUNTIME_DIR, { recursive: true });
+    const line = JSON.stringify({
+      ts: new Date().toISOString(),
+      pid: process.pid,
+      ppid: process.ppid,
+      argv1: process.argv[1] || '',
+      version: PKG_VERSION,
+    }) + '\n';
+    appendFileSync(join(RUNTIME_DIR, 'mcp-spawns.log'), line, { mode: 0o600 });
+  } catch { /* never block startup on telemetry failure */ }
+}
+
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/skip-tools.mjs

@@ -14,7 +14,8 @@ export const SKIP_TOOLS = new Set([
 /** Prefix patterns — tools starting with these are also skipped */
 export const SKIP_PREFIXES = [
   'mem_',
-  'mcp__mem__',
+  'mcp__mem__',         // legacy global MCP name (pre-rename)
+  'mcp__mem-lite__',    // current global MCP name (post-rename v2.78+)
   'mcp__plugin_claude-mem-lite',
   'mcp__sequential',
   'mcp__plugin_context7',