claude-mem-lite 2.31.0 → 2.31.1

package/.claude-plugin/marketplace.json

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

package/hook.mjs

@@ -32,6 +32,7 @@ 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';
+import { clearPluginCacheHooks, hasInstallManagedHooks } from './plugin-cache-guard.mjs';
 import { SKIP_TOOLS, SKIP_PREFIXES } from './skip-tools.mjs';
 import { getVocabulary } from './tfidf.mjs';
 
@@ -397,6 +398,21 @@ 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.
+  try {
+    if (hasInstallManagedHooks()) {
+      const cleared = 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.1",
   "description": "Lightweight persistent memory system for Claude Code",
   "type": "module",
   "engines": {