claude-mem-lite 2.84.0 → 2.84.1

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
   "plugins": [
     {
       "name": "claude-mem-lite",
-      "version": "2.84.0",
+      "version": "2.84.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.84.0",
+  "version": "2.84.1",
   "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

@@ -1795,6 +1795,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.1",
   "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);
   }
 }