claude-mem-lite 2.31.0 → 2.31.2

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
   "plugins": [
     {
       "name": "claude-mem-lite",
-      "version": "2.31.0",
+      "version": "2.31.2",
       "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.31.0",
+  "version": "2.31.2",
   "description": "Lightweight persistent memory system for Claude Code — FTS5 search, episode batching, error-triggered recall",
   "author": {
     "name": "sdsrss"

package/hook-update.mjs

@@ -196,6 +196,7 @@ const SOURCE_FILES = [
   'cli.mjs', 'server.mjs', 'server-internals.mjs', 'tool-schemas.mjs',
   'hook.mjs', 'hook-shared.mjs', 'hook-llm.mjs', 'hook-memory.mjs', 'skip-tools.mjs',
   'hook-semaphore.mjs', 'hook-episode.mjs', 'hook-context.mjs', 'hook-handoff.mjs', 'hook-update.mjs',
+  'hook-optimize.mjs', 'plugin-cache-guard.mjs',
   'haiku-client.mjs', 'utils.mjs', 'schema.mjs', 'package.json', 'package-lock.json', 'skill.md',
   'registry.mjs', 'registry-scanner.mjs', 'registry-indexer.mjs',
   'registry-retriever.mjs', 'resource-discovery.mjs',
@@ -289,6 +290,13 @@ export function installExtractedRelease(sourceDir, targetDir = INSTALL_DIR) {
     // Post-update: prune old plugin cache versions (keep latest 3)
     try { prunePluginCache(); } catch (e) { debugCatch(e, 'prunePluginCache'); }
 
+    // Post-update: clear cache hooks.json in every remaining version. Claude Code
+    // runtime reads plugin hooks from cache, not marketplace source — leaving populated
+    // cache hooks.json alongside install.mjs-written settings.json causes double firing.
+    // Inline impl (no import of plugin-cache-guard.mjs — this module must run even when
+    // the guard module is absent on disk, e.g. auto-upgrading from pre-2.31.2).
+    try { clearCacheHookResidue(); } catch (e) { debugCatch(e, 'clearCacheHookResidue'); }
+
     debugLog('DEBUG', 'hook-update', `Auto-update: switched ${installed.length} paths`);
     return true;
   } catch (err) {
@@ -348,6 +356,33 @@ function copyReleaseIntoStaging(sourceDir, stagingDir) {
   debugLog('DEBUG', 'hook-update', `Auto-update staged ${copied} source files`);
 }
 
+// ── Cache hook residue clearing ────────────────────────────
+// Inline (does not import plugin-cache-guard.mjs) so hook-update.mjs keeps working
+// even if plugin-cache-guard.mjs is missing on disk in degraded installs.
+export function clearCacheHookResidue() {
+  const cacheBase = join(homedir(), '.claude', 'plugins', 'cache', 'sdsrss', 'claude-mem-lite');
+  if (!existsSync(cacheBase)) return 0;
+  let cleared = 0;
+  for (const ver of readdirSync(cacheBase)) {
+    const p = join(cacheBase, ver, 'hooks', 'hooks.json');
+    if (!existsSync(p)) continue;
+    try {
+      const h = JSON.parse(readFileSync(p, 'utf8'));
+      if (!h.hooks || Object.keys(h.hooks).length === 0) continue;
+      writeFileSync(p, JSON.stringify({
+        description: h.description || 'claude-mem-lite hooks',
+        _note: `Auto-cleared by hook-update.mjs post-install — prevents double hook registration (cache ver: ${ver})`,
+        hooks: {},
+      }, null, 2) + '\n');
+      cleared++;
+    } catch { /* ignore single bad entry */ }
+  }
+  if (cleared > 0) {
+    debugLog('DEBUG', 'hook-update', `Cache hooks residue cleared in ${cleared} version(s)`);
+  }
+  return cleared;
+}
+
 // ── Plugin Cache Pruning ──────────────────────────────────
 const PLUGIN_CACHE_KEEP = 3;
 

package/hook.mjs

@@ -32,6 +32,16 @@ import { searchRelevantMemories } from './hook-memory.mjs';
 import { buildAndSaveHandoff, detectContinuationIntent, renderHandoffInjection, extractUnfinishedSummary } from './hook-handoff.mjs';
 import { checkForUpdate } from './hook-update.mjs';
 import { handleLLMOptimize } from './hook-optimize.mjs';
+// plugin-cache-guard.mjs loaded dynamically — pre-2.31.2 installs that auto-upgraded
+// from an older hook-update.mjs SOURCE_FILES (which did not list this module) would
+// crash on static import. Degrade gracefully to no-op when the module is absent.
+let _cacheGuardCache = null;
+async function loadCacheGuard() {
+  if (_cacheGuardCache !== null) return _cacheGuardCache;
+  try { _cacheGuardCache = await import('./plugin-cache-guard.mjs'); }
+  catch { _cacheGuardCache = {}; }
+  return _cacheGuardCache;
+}
 import { SKIP_TOOLS, SKIP_PREFIXES } from './skip-tools.mjs';
 import { getVocabulary } from './tfidf.mjs';
 
@@ -397,6 +407,24 @@ async function handleStop() {
 // ─── SessionStart Handler + CLAUDE.md Persistence (Tier 1 A, E) ─────────────
 
 async function handleSessionStart() {
+  // Plugin cache self-heal: Claude Code auto-updates the marketplace plugin can
+  // re-populate cache/<ver>/hooks/hooks.json, reintroducing duplicate hook
+  // registration alongside install.mjs-managed settings.json entries. Silently
+  // clear — gated by hasInstallManagedHooks to avoid breaking plugin-only users.
+  // Dynamic-import fallback: if plugin-cache-guard.mjs is missing (pre-2.31.2
+  // auto-upgrade install), skip self-heal instead of crashing the entire hook.
+  try {
+    const guard = await loadCacheGuard();
+    if (guard.hasInstallManagedHooks && guard.hasInstallManagedHooks()) {
+      const cleared = guard.clearPluginCacheHooks({
+        reason: 'Auto-healed by hook.mjs session-start — install.mjs-managed hooks active in settings.json',
+      });
+      if (cleared.length > 0) {
+        debugLog('DEBUG', 'session-start', `auto-healed stale plugin cache hooks.json in version(s): ${cleared.join(', ')}`);
+      }
+    }
+  } catch (e) { debugCatch(e, 'session-start-cache-heal'); }
+
   // Read CC real session_id from hook stdin — used to scope handoff rows so parallel
   // sessions for the same project don't clobber each other (see docs/bug.txt).
   let ccSessionId = null;

package/install.mjs

@@ -26,6 +26,7 @@ const PLUGIN_KEY = `claude-mem-lite@${MARKETPLACE_KEY}`;
 const NPM_INSTALL_CMD = 'npm install --omit=dev --no-audit --no-fund';
 
 import { RESOURCE_METADATA } from './install-metadata.mjs';
+import { scanPluginCacheHookPollution } from './plugin-cache-guard.mjs';
 
 /**
  * Derive invocation_name from resource name when metadata doesn't provide one.
@@ -205,6 +206,7 @@ async function install() {
     'cli.mjs', 'server.mjs', 'server-internals.mjs', 'tool-schemas.mjs',
     'hook.mjs', 'hook-shared.mjs', 'hook-llm.mjs', 'hook-memory.mjs', 'skip-tools.mjs',
     'hook-semaphore.mjs', 'hook-episode.mjs', 'hook-context.mjs', 'hook-handoff.mjs', 'hook-update.mjs', 'hook-optimize.mjs',
+    'plugin-cache-guard.mjs',
     'haiku-client.mjs', 'utils.mjs', 'schema.mjs', 'package.json', 'package-lock.json', 'skill.md',
     'registry.mjs', 'registry-scanner.mjs', 'registry-indexer.mjs',
     'registry-retriever.mjs', 'resource-discovery.mjs',
@@ -401,18 +403,43 @@ async function install() {
       }
     } catch (e) { warn(`Marketplace hooks dedup: ${e.message}`); }
 
-    // Sync launch.mjs to plugin cache — ensures MCP server loads dev code via symlink detection
+    // Sync launch.mjs to plugin cache — ensures MCP server loads dev code via symlink detection.
+    // ALSO clear cached hooks.json in every version dir — Claude Code runtime reads hooks from
+    // ~/.claude/plugins/cache/<mp>/<plugin>/<ver>/hooks/hooks.json, NOT from the marketplace source.
+    // Clearing only the marketplace source (above) leaves stale cache copies that double-register
+    // hooks alongside install.mjs-written settings.json entries.
     try {
       const cacheBase = join(homedir(), '.claude', 'plugins', 'cache', MARKETPLACE_KEY, 'claude-mem-lite');
       if (existsSync(cacheBase)) {
         const srcLaunch = join(PROJECT_DIR, 'scripts', 'launch.mjs');
+        let clearedHooks = 0;
         for (const ver of readdirSync(cacheBase)) {
-          const dest = join(cacheBase, ver, 'scripts', 'launch.mjs');
-          if (existsSync(join(cacheBase, ver, 'scripts'))) {
-            copyFileSync(srcLaunch, dest);
+          const verDir = join(cacheBase, ver);
+
+          // Sync launch.mjs
+          if (existsSync(join(verDir, 'scripts'))) {
+            try { copyFileSync(srcLaunch, join(verDir, 'scripts', 'launch.mjs')); } catch {}
+          }
+
+          // Clear cached hooks.json (runtime reads here, not marketplace source)
+          const cachedHooksPath = join(verDir, 'hooks', 'hooks.json');
+          if (existsSync(cachedHooksPath)) {
+            try {
+              const h = JSON.parse(readFileSync(cachedHooksPath, 'utf8'));
+              if (h.hooks && Object.keys(h.hooks).length > 0) {
+                writeFileSync(cachedHooksPath, JSON.stringify({
+                  description: h.description || 'claude-mem-lite hooks',
+                  _note: `Hooks managed by install.mjs in settings.json — cache hooks.json cleared to prevent duplicate registration (cache ver: ${ver})`,
+                  hooks: {}
+                }, null, 2) + '\n');
+                clearedHooks++;
+              }
+            } catch { /* silent — never block install on one bad cache entry */ }
           }
         }
-        ok('Plugin cache: launch.mjs synced (dev mode MCP routing)');
+        const parts = ['launch.mjs synced (dev mode MCP routing)'];
+        if (clearedHooks > 0) parts.push(`${clearedHooks} stale hooks.json cleared`);
+        ok(`Plugin cache: ${parts.join('; ')}`);
       }
     } catch (e) { warn(`Plugin cache sync: ${e.message}`); }
   }
@@ -962,6 +989,18 @@ async function status() {
     fail('Hooks: not configured');
   }
 
+  // Plugin cache pollution: populated hooks.json in cache AND install.mjs-managed
+  // settings.json hooks → runtime registers both → duplicate firing.
+  const polluted = scanPluginCacheHookPollution();
+  if (polluted.length > 0 && hasHooks) {
+    fail(`Plugin cache: stale hooks.json in version(s) ${polluted.join(', ')} — duplicate firing alongside settings.json (run 'install' to auto-clear)`);
+  } else if (polluted.length > 0) {
+    // plugin-only mode (no settings.json hooks) — cache hooks.json is the sole source, expected
+    ok(`Plugin cache: ${polluted.length} version(s) with hooks.json (plugin-only mode)`);
+  } else if (pluginEnabled || hasHooks) {
+    ok('Plugin cache: no stale hooks.json (no duplicate firing)');
+  }
+
   // Database
   if (existsSync(DB_PATH)) {
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem-lite",
-  "version": "2.31.0",
+  "version": "2.31.2",
   "description": "Lightweight persistent memory system for Claude Code",
   "type": "module",
   "engines": {