claude-mem-lite 2.32.3 → 2.32.5

package/.claude-plugin/marketplace.json

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

package/README.md

@@ -455,6 +455,12 @@ npx claude-mem-lite doctor            # Diagnose issues
 
 Notes:
 - Plugin mode only reports available updates; it does not self-update plugin files.
+  To upgrade an installed plugin to the latest published version, run **inside Claude Code**:
+  ```
+  /plugin marketplace update sdsrss
+  /plugin install claude-mem-lite@sdsrss
+  ```
+  (The first command refreshes the local marketplace clone; the second reinstalls from it. Without the first command, `/plugin install` reuses the stale local clone and you stay on whichever version you originally pulled.)
 - Direct install / npx mode keeps auto-update enabled and uses staged replacement with rollback on install failure.
 - If you disabled the plugin but still have old mem hooks in `~/.claude/settings.json`, run `node install.mjs cleanup-hooks`.
 

package/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const CLI_COMMANDS = new Set(['search', 'recent', 'recall', 'get', 'timeline', 'save', 'stats', 'context', 'browse', 'delete', 'update', 'export', 'compress', 'maintain', 'optimize', 'fts-check', 'registry', 'import', 'enrich', 'activity', 'help']);
+const CLI_COMMANDS = new Set(['search', 'recent', 'recall', 'get', 'timeline', 'save', 'stats', 'context', 'browse', 'delete', 'update', 'export', 'compress', 'maintain', 'optimize', 'fts-check', 'registry', 'import', 'enrich', 'activity', 'adopt', 'unadopt', 'help']);
 const INSTALL_COMMANDS = new Set(['install', 'uninstall', 'status', 'doctor', 'cleanup', 'cleanup-hooks', 'self-update', 'release']);
 
 const cmd = process.argv[2];

package/hook-update.mjs

@@ -8,6 +8,7 @@ import { join, dirname } from 'node:path';
 import { tmpdir, homedir } from 'node:os';
 import { DB_DIR } from './schema.mjs';
 import { debugCatch, debugLog } from './utils.mjs';
+import { SOURCE_FILES } from './source-files.mjs';
 
 // ── Configuration ──────────────────────────────────────────
 const GITHUB_REPO = 'sdsrss/claude-mem-lite';
@@ -191,19 +192,10 @@ export function getCurrentVersion() {
   } catch { return '0.0.0'; }
 }
 
-// ── Source files to copy (must match install.mjs SOURCE_FILES) ──
-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',
-  'install.mjs', 'install-metadata.mjs', 'mem-cli.mjs', 'tier.mjs', 'tfidf.mjs',
-  'nlp.mjs', 'synonyms.mjs', 'scoring-sql.mjs', 'stop-words.mjs', 'project-utils.mjs',
-  'secret-scrub.mjs', 'format-utils.mjs', 'hash-utils.mjs', 'bash-utils.mjs',
-];
+// Source files imported from shared ./source-files.mjs so install.mjs and
+// hook-update.mjs can never drift (see tests/source-files-sync.test.mjs).
+// SWITCHABLE_PATHS = everything in SOURCE_FILES plus the recursive dirs that
+// install.mjs copies as whole subtrees (scripts, registry, node_modules).
 const SWITCHABLE_PATHS = [...SOURCE_FILES, 'scripts', 'registry', 'node_modules'];
 
 // ── Download & Install ─────────────────────────────────────

package/install.mjs

@@ -2,7 +2,7 @@
 // claude-mem-lite Installer — Smart install/uninstall/status/doctor
 
 import { execSync, execFileSync } from 'child_process';
-import { readFileSync, writeFileSync, existsSync, rmSync, mkdirSync, copyFileSync, cpSync, renameSync, symlinkSync, unlinkSync, readdirSync, statSync } from 'fs';
+import { readFileSync, writeFileSync, existsSync, rmSync, mkdirSync, copyFileSync, cpSync, renameSync, symlinkSync, unlinkSync, readdirSync, statSync, lstatSync } from 'fs';
 import { join, resolve, dirname, isAbsolute } from 'path';
 import { homedir } from 'os';
 import { fileURLToPath } from 'url';
@@ -27,6 +27,7 @@ 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';
+import { SOURCE_FILES } from './source-files.mjs';
 
 /**
  * Derive invocation_name from resource name when metadata doesn't provide one.
@@ -184,6 +185,18 @@ function ok(msg) { console.log(`  ✓ ${msg}`); }
 function warn(msg) { console.log(`  ⚠ ${msg}`); }
 function fail(msg) { console.log(`  ✗ ${msg}`); }
 
+// Dev installs symlink server.mjs → the project's source file. Used to suppress
+// misleading "first run" messages since hook-update.mjs skips state-writes in
+// this mode (see hook-update.mjs isDevMode).
+function isDevInstall() {
+  try {
+    const serverPath = join(INSTALL_DIR, 'server.mjs');
+    return existsSync(serverPath) && lstatSync(serverPath).isSymbolicLink();
+  } catch {
+    return false;
+  }
+}
+
 // ─── Install ────────────────────────────────────────────────────────────────
 
 async function install() {
@@ -202,34 +215,6 @@ async function install() {
 
   if (!existsSync(DATA_DIR)) mkdirSync(DATA_DIR, { recursive: true });
 
-  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',
-    'install-metadata.mjs', 'mem-cli.mjs', 'tier.mjs', 'tfidf.mjs',
-    'nlp.mjs', 'synonyms.mjs', 'scoring-sql.mjs', 'stop-words.mjs', 'project-utils.mjs',
-    'secret-scrub.mjs', 'format-utils.mjs', 'hash-utils.mjs', 'bash-utils.mjs',
-    // v2.31 T9: hook-llm now statically imports lib/activity.mjs (events routing).
-    // SOURCE_FILES entries with a subdir prefix require install.mjs to mkdir the
-    // parent before symlink/copy — handled in the IS_DEV and else-branch loops.
-    'lib/activity.mjs',
-    // v2.31 T10: startup dashboard aggregator + handoff task/git anchoring.
-    // task-reader + plan-reader + git-state are read by lib/startup-dashboard.mjs
-    // on SessionStart (hook.mjs) and by hook-handoff.mjs on /exit + /clear.
-    'lib/task-reader.mjs',
-    'lib/plan-reader.mjs',
-    'lib/git-state.mjs',
-    'lib/startup-dashboard.mjs',
-    // v2.32 (invited-memory): memdir primitives + adopt/unadopt CLI.
-    'memdir.mjs',
-    'adopt-content.mjs',
-    'adopt-cli.mjs',
-  ];
-
   if (IS_DEV) {
     log('Dev mode — creating symlinks in ~/.claude-mem-lite/...');
     // Symlink individual source files
@@ -1194,6 +1179,10 @@ async function doctor() {
       if (state.rateLimited) parts.push('rate-limited');
       if (state.lastError) parts.push(`last error: ${state.lastError}`);
       ok(`Update state: ${parts.join(', ') || 'empty'}`);
+    } else if (isDevInstall()) {
+      // Dev installs symlink server.mjs → project source; hook-update.mjs
+      // short-circuits before writing state (see hook-update.mjs isDevMode).
+      ok('Update state: skipped (dev mode — symlinked install)');
     } else {
       warn('Update state: no state file (first run?)');
     }
@@ -1387,7 +1376,10 @@ async function manualUpdate() {
   if (result?.updated) {
     ok(`Updated: v${result.from} → v${result.to}`);
   } else if (result?.updateAvailable && result?.installDeferred) {
-    warn(`v${result.to} available — plugin mode only checks for updates, reinstall/update the plugin to apply it`);
+    warn(`v${result.to} available — plugin mode only checks for updates.`);
+    log('  To upgrade, inside Claude Code run:');
+    log('    /plugin marketplace update sdsrss');
+    log('    /plugin install claude-mem-lite@sdsrss');
   } else if (result?.updateAvailable) {
     warn(`v${result.to} available but install failed — try: node install.mjs install`);
   } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem-lite",
-  "version": "2.32.3",
+  "version": "2.32.5",
   "description": "Lightweight persistent memory system for Claude Code",
   "type": "module",
   "engines": {
@@ -55,6 +55,7 @@
     "registry-importer.mjs",
     "registry-enricher.mjs",
     "resource-discovery.mjs",
+    "source-files.mjs",
     "install.mjs",
     "install-metadata.mjs",
     "skip-tools.mjs",

package/source-files.mjs

@@ -0,0 +1,41 @@
+// Shared runtime source-file manifest — imported by install.mjs and hook-update.mjs
+// so the two code paths never drift. Adding a new .mjs that any entry point
+// (cli.mjs / hook.mjs / server.mjs / mem-cli.mjs / install.mjs) imports requires
+// adding the path here AND to package.json's files array;
+// tests/source-files-sync.test.mjs enforces both.
+
+export const SOURCE_FILES = [
+  // Entry points and top-level modules
+  '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',
+  // registry-enricher/-github/-importer are dynamically imported by server.mjs
+  // (mem_registry tool) and mem-cli.mjs (registry CLI subcommands). Missing
+  // them from SOURCE_FILES silently broke those code paths prior to this fix.
+  'registry-enricher.mjs', 'registry-github.mjs', 'registry-importer.mjs',
+  // Shared SOURCE_FILES manifest — self-reference so `~/.claude-mem-lite/` can
+  // re-run install.mjs (which imports this module) after an auto-update.
+  'source-files.mjs',
+  'install.mjs', 'install-metadata.mjs', 'mem-cli.mjs',
+  'tier.mjs', 'tfidf.mjs',
+  'nlp.mjs', 'synonyms.mjs', 'scoring-sql.mjs', 'stop-words.mjs', 'project-utils.mjs',
+  'secret-scrub.mjs', 'format-utils.mjs', 'hash-utils.mjs', 'bash-utils.mjs',
+  // lib/ — statically imported by hook-llm.mjs (activity) + hook-handoff.mjs (git-state, task-reader);
+  // dynamically imported by hook.mjs (startup-dashboard) + mem-cli.mjs (doctor-benchmark, plan-reader).
+  'lib/activity.mjs',
+  'lib/task-reader.mjs',
+  'lib/plan-reader.mjs',
+  'lib/git-state.mjs',
+  'lib/startup-dashboard.mjs',
+  'lib/doctor-benchmark.mjs',
+  // v2.32 invited-memory: memdir primitives + adopt/unadopt CLI
+  'memdir.mjs',
+  'adopt-content.mjs',
+  'adopt-cli.mjs',
+];