claude-mem-lite 2.84.0 → 2.84.2

package/.claude-plugin/marketplace.json

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

package/README.md

@@ -498,6 +498,24 @@ Checks Node.js version, dependencies, server/hook files, database integrity, FTS
 
 Shows MCP registration, hook configuration, plugin disabled state, and database stats (observation/session counts).
 
+### Recovery (stuck install / hook errors)
+
+If you see `ERR_MODULE_NOT_FOUND` on PreToolUse:Read/Edit/Skill hooks, or `claude-mem-lite` commands crash with import errors, you're likely hit by a partial auto-update — the updater copied new scripts but missed a sibling `lib/*` file, breaking the hook chain (and the next auto-update that would have healed it).
+
+**v2.84.0+** ships a `repair` subcommand that re-syncs from the latest GitHub release:
+
+```bash
+claude-mem-lite repair
+```
+
+**If `repair` itself fails** (the bin is older than v2.84.0, or the bin is also broken), run this one-liner — it pulls a fresh tarball into a temp dir and runs *that* tarball's `install.mjs`, bypassing every file on your disk:
+
+```bash
+T=$(mktemp -d) && curl -sL https://api.github.com/repos/sdsrss/claude-mem-lite/tarball | tar xz -C "$T" --strip-components=1 && node "$T/install.mjs" install
+```
+
+After it finishes, `~/.claude-mem-lite/` is back in sync with the latest release and `claude-mem-lite repair` is available for next time.
+
 ## Uninstall
 
 ```bash

package/README.zh-CN.md

@@ -460,6 +460,24 @@ npx claude-mem-lite doctor            # 诊断问题
 
 显示 MCP 注册状态、钩子配置、插件禁用状态和数据库统计（观察/会话数量）。
 
+### 故障恢复（安装卡死 / hook 报错）
+
+如果你看到 PreToolUse:Read/Edit/Skill hook 报 `ERR_MODULE_NOT_FOUND`，或者 `claude-mem-lite` 命令本身因为 import 错误崩溃，多半是被部分自动更新坑了——更新器复制了新脚本但漏了配套的 `lib/*` 文件，hook 链就此断掉（连下一次本可自愈的自动更新也跑不了）。
+
+**v2.84.0+** 提供 `repair` 子命令，从 GitHub 最新 release 重新同步：
+
+```bash
+claude-mem-lite repair
+```
+
+**如果 `repair` 自己也跑不起来**（bin 比 v2.84.0 旧，或 bin 也坏了），用这条单行命令——它把最新 tarball 拉到临时目录、跑 *那份* tarball 里的 `install.mjs`，完全不依赖你磁盘上的任何文件：
+
+```bash
+T=$(mktemp -d) && curl -sL https://api.github.com/repos/sdsrss/claude-mem-lite/tarball | tar xz -C "$T" --strip-components=1 && node "$T/install.mjs" install
+```
+
+跑完之后，`~/.claude-mem-lite/` 就和最新 release 对齐，`claude-mem-lite repair` 下次再遇到类似问题也能直接用了。
+
 ## 卸载
 
 ```bash

package/install.mjs

@@ -5,7 +5,8 @@ import { execSync, execFileSync } from 'child_process';
 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, tmpdir } from 'os';
-import { fileURLToPath } from 'url';
+import { fileURLToPath, pathToFileURL } from 'url';
+import { createRequire } from 'node:module';
 
 const PROJECT_DIR = resolve(import.meta.dirname ?? dirname(fileURLToPath(import.meta.url)));
 const SETTINGS_PATH = join(homedir(), '.claude', 'settings.json');
@@ -186,9 +187,19 @@ function registerVirtualResources(rdb) {
       );
       count += changes;
 
-      // Backfill FTS5 fields for existing resources
+      // Backfill FTS5 fields for existing resources.
+      // ?N numbered placeholders REQUIRE object-form binding in better-sqlite3 —
+      // positional .run(v1, v2, …) always throws "Too many parameter values"
+      // regardless of arg count. Pre-fix this swallow-warned on every install
+      // (masked by install.mjs:785 import failure before the v2.84.2 path fix).
       if (changes === 0) {
-        updateFts.run(meta.keywords || '', meta.tech_stack || '', meta.use_cases || '', type, name);
+        updateFts.run({
+          1: meta.keywords || '',
+          2: meta.tech_stack || '',
+          3: meta.use_cases || '',
+          4: type,
+          5: name,
+        });
       }
     }
 
@@ -285,6 +296,16 @@ function isDevInstall() {
 async function install() {
   console.log('\nclaude-mem-lite installer\n');
 
+  // Resolve dynamic imports against the installed copy at INSTALL_DIR rather
+  // than install.mjs's own directory. Lets install.mjs run correctly from a
+  // /tmp staging dir (repair flow, `curl … | tar xz | node install.mjs install`)
+  // where PROJECT_DIR has no node_modules but INSTALL_DIR does — step 2 below
+  // ran `npm install --cwd INSTALL_DIR`. Pre-fix, steps 6/7 fired
+  // "Cannot find package 'better-sqlite3' imported from /tmp/…/registry.mjs"
+  // and silently skipped registry-DB seeding + DB health check on every repair.
+  const importFromInstall = (rel) => import(pathToFileURL(join(INSTALL_DIR, rel)).href);
+  const requireFromInstall = createRequire(pathToFileURL(join(INSTALL_DIR, 'package.json')).href);
+
   // 1. Install source files to ~/.claude-mem-lite/
   const IS_DEV = flags.has('--dev');
 
@@ -782,7 +803,7 @@ async function install() {
            (deadRepos.size > 0 ? `, ${deadRepos.size} dead removed` : ''));
 
         // 6b. Init registry DB and record preinstalled entries
-        const { ensureRegistryDb } = await import('./registry.mjs');
+        const { ensureRegistryDb } = await importFromInstall('registry.mjs');
         const regDbPath = join(DATA_DIR, 'resource-registry.db');
         const rdb = ensureRegistryDb(regDbPath);
 
@@ -830,7 +851,7 @@ async function install() {
 
         // 6d. Scan and index resources (fallback-only, Haiku indexing deferred to first run)
         log('  Scanning resources...');
-        const { scanAllResources, diffResources } = await import('./registry-scanner.mjs');
+        const { scanAllResources, diffResources } = await importFromInstall('registry-scanner.mjs');
         const scanned = scanAllResources({ dataDir: DATA_DIR });
 
         // Attach star counts and repo URLs
@@ -846,7 +867,7 @@ async function install() {
         if (toIndex.length > 0) {
           // Use fallback indexing at install time (no Haiku calls)
           // Full Haiku indexing happens on first SessionStart
-          const { upsertResource } = await import('./registry.mjs');
+          const { upsertResource } = await importFromInstall('registry.mjs');
           for (const res of toIndex) {
             try {
               const metaKey = `${res.type}:${res.name}`;
@@ -892,7 +913,7 @@ async function install() {
   // 7. Verify database
   if (existsSync(DB_PATH)) {
     try {
-      const Database = (await import('better-sqlite3')).default;
+      const Database = requireFromInstall('better-sqlite3');
       const db = new Database(DB_PATH, { readonly: true });
       const count = db.prepare('SELECT COUNT(*) as c FROM observations').get();
       db.close();
@@ -914,7 +935,7 @@ async function install() {
       const remote = execFileSync('git', ['-C', PROJECT_DIR, 'config', '--get', 'remote.origin.url'], { encoding: 'utf8', stdio: 'pipe' }).trim();
       const isDogfood = /github\.com[:/]sdsrss\/claude-mem-lite(\.git)?$/i.test(remote);
       if (isDogfood) {
-        const { cmdAdopt } = await import('./adopt-cli.mjs');
+        const { cmdAdopt } = await importFromInstall('adopt-cli.mjs');
         cmdAdopt([]);
         ok('Invited-memory: auto-adopt for claude-mem-lite dogfood repo');
       }
@@ -1795,6 +1816,11 @@ async function repair() {
     ok('Repair complete — broken install resynced from latest release');
   } catch (e) {
     fail(`Repair failed: ${e.message}`);
+    console.log('');
+    console.log('  Manual fallback — run this in any shell:');
+    console.log('');
+    console.log('  T=$(mktemp -d) && curl -sL https://api.github.com/repos/sdsrss/claude-mem-lite/tarball | tar xz -C "$T" --strip-components=1 && node "$T/install.mjs" install');
+    console.log('');
     process.exit(1);
   } finally {
     try { rmSync(stagingDir, { recursive: true, force: true }); } catch {}

package/package.json

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

package/scripts/hook-launcher.mjs

@@ -32,6 +32,13 @@ const RUNTIME_DIR = process.env.CLAUDE_MEM_DIR
 const HEAL_MARKER = join(RUNTIME_DIR, 'hook-launcher-lastheal');
 const HEAL_COOLDOWN_MS = 6 * 60 * 60 * 1000;
 
+// Last-resort recovery string for users whose `claude-mem-lite repair` path
+// itself failed (install.mjs missing / repair errored / retry still drifting).
+// Duplicated in install.mjs::repair() catch; both are reachable when local
+// scripts are broken, so neither can import a shared constant.
+const TARBALL_FALLBACK =
+  'T=$(mktemp -d) && curl -sL https://api.github.com/repos/sdsrss/claude-mem-lite/tarball | tar xz -C "$T" --strip-components=1 && node "$T/install.mjs" install';
+
 const [, , entryArg, ...rest] = process.argv;
 if (!entryArg) {
   process.stderr.write('[claude-mem-lite] hook-launcher: missing entry argument\n');
@@ -74,7 +81,9 @@ function recordHealAttempt() {
 async function attemptHeal(reason) {
   if (recentHealAttempt()) {
     process.stderr.write(
-      `[claude-mem-lite] Self-heal skipped (last attempt < 6h ago). Manual recovery: claude-mem-lite repair\n`,
+      `[claude-mem-lite] Self-heal skipped (last attempt < 6h ago).\n` +
+      `[claude-mem-lite] Manual recovery: claude-mem-lite repair\n` +
+      `[claude-mem-lite] If that fails, run: ${TARBALL_FALLBACK}\n`,
     );
     return false;
   }
@@ -82,7 +91,10 @@ async function attemptHeal(reason) {
   process.stderr.write(`[claude-mem-lite] Detected broken install (${reason}) — running self-heal\n`);
   const installer = join(INSTALL_DIR, 'install.mjs');
   if (!existsSync(installer)) {
-    process.stderr.write(`[claude-mem-lite] install.mjs missing at ${installer} — cannot self-heal\n`);
+    process.stderr.write(
+      `[claude-mem-lite] install.mjs missing at ${installer} — cannot self-heal\n` +
+      `[claude-mem-lite] Manual recovery: ${TARBALL_FALLBACK}\n`,
+    );
     return false;
   }
   const result = spawnSync(process.execPath, [installer, 'repair'], {
@@ -102,7 +114,10 @@ try {
   try {
     await runEntry({ bustCache: true });
   } catch (retryErr) {
-    process.stderr.write(`[claude-mem-lite] Hook still failing after self-heal: ${retryErr.message}\n`);
+    process.stderr.write(
+      `[claude-mem-lite] Hook still failing after self-heal: ${retryErr.message}\n` +
+      `[claude-mem-lite] Manual recovery: ${TARBALL_FALLBACK}\n`,
+    );
     process.exit(1);
   }
 }