claude-mem-lite 3.16.0 → 3.16.2

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
   "plugins": [
     {
       "name": "claude-mem-lite",
-      "version": "3.16.0",
+      "version": "3.16.2",
       "source": "./",
       "description": "Persistent long-term memory for Claude Code via MCP — captures coding decisions, bugfixes, and context across sessions. Hybrid FTS5 + TF-IDF search with episode batching. Single SQLite DB, no external services. A lighter, lower-cost alternative to claude-mem (episode batching + a smaller model; cost savings are an internal estimate, not a measured benchmark)."
     }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem-lite",
-  "version": "3.16.0",
+  "version": "3.16.2",
   "description": "Persistent long-term memory for Claude Code via MCP — captures coding decisions, bugfixes, and context across sessions. Hybrid FTS5 + TF-IDF search with episode batching. Single SQLite DB, no external services. A lighter, lower-cost alternative to claude-mem (episode batching + a smaller model; cost savings are an internal estimate, not a measured benchmark).",
   "author": {
     "name": "sdsrss"

package/README.md

@@ -269,7 +269,7 @@ surface — reach them through the CLI column in the second table.
 | `mem_maintain` | `claude-mem-lite maintain scan --ops dedup,decay` | dedup / decay / cleanup / rebuild_vectors (`scan` previews, `execute` applies). |
 | `mem_optimize` | `claude-mem-lite optimize` | LLM-powered re-enrich / normalize / cluster-merge (preview default; `--run` to apply). |
 | `mem_export` | `claude-mem-lite export` | JSON / JSONL dump, filters by project, type, date. |
-| `mem_fts_check` | `claude-mem-lite fts-check [--rebuild]` | FTS5 integrity + rebuild. |
+| `mem_fts_check` | `claude-mem-lite fts-check <check\|rebuild>` | FTS5 integrity + rebuild. |
 | `mem_browse` | `claude-mem-lite browse` | Tier-grouped dashboard (working / active / archive). |
 | `mem_registry` | `claude-mem-lite registry <action>` | List / search / import / remove skills + agents. |
 | `mem_use` | _MCP only_ | Load a skill / agent from the registry by name. |

package/README.zh-CN.md

@@ -229,7 +229,7 @@ v2.34.0 起服务端注册 17 个工具，但 `tools/list` 只暴露 6 个 **核
 | `mem_maintain` | `claude-mem-lite maintain scan --ops dedup,decay` | 去重 / decay / 清理 / 向量重建（`scan` 预览，`execute` 执行）。 |
 | `mem_optimize` | `claude-mem-lite optimize` | LLM 深度优化：re-enrich / normalize / cluster-merge（默认 preview；`--run` 执行）。 |
 | `mem_export` | `claude-mem-lite export` | JSON / JSONL 导出，支持项目/类型/日期过滤。 |
-| `mem_fts_check` | `claude-mem-lite fts-check [--rebuild]` | FTS5 完整性检查与重建。 |
+| `mem_fts_check` | `claude-mem-lite fts-check <check\|rebuild>` | FTS5 完整性检查与重建。 |
 | `mem_browse` | `claude-mem-lite browse` | 分层仪表盘（working / active / archive）。 |
 | `mem_registry` | `claude-mem-lite registry <action>` | 列 / 搜索 / 导入 / 移除 skill / agent。 |
 | `mem_use` | _MCP only_ | 从 registry 按名载入 skill / agent。 |

package/adopt-content.mjs

@@ -115,7 +115,7 @@ PreToolUse hook 在你 Read / Edit / Write 文件前已自动 \`mem_recall\` 该
 | 清理过期记忆 | \`${CLI_INVOKE} maintain scan --ops purge_stale\` → \`maintain execute --ops purge_stale --confirm\`（删行必须 \`--confirm\`） |
 | 深度优化（Haiku） | \`${CLI_INVOKE} optimize\`（默认 preview；\`--run\` 执行，\`--task re-enrich,normalize,cluster-merge,smart-compress\`） |
 | 压缩旧条目 | \`${CLI_INVOKE} compress\`（默认 preview；\`--execute\` 执行，\`--age-days N\`） |
-| FTS5 索引检查 / 重建 | \`${CLI_INVOKE} fts-check [--rebuild]\` |
+| FTS5 索引检查 / 重建 | \`${CLI_INVOKE} fts-check <check\\|rebuild>\` |
 | tier 分组浏览 | \`${CLI_INVOKE} browse [--tier active]\` |
 | 导出 JSON/JSONL | \`${CLI_INVOKE} export [--format jsonl]\` |
 | 统计总量 / 健康 | \`${CLI_INVOKE} stats [--days 30]\` |

package/hook-optimize.mjs

@@ -203,10 +203,22 @@ search_aliases: 2-6 alternative search terms (include CJK if applicable).`;
 const NORMALIZE_GATE_FILE = join(RUNTIME_DIR, 'last-normalize.json');
 const NORMALIZE_INTERVAL_MS = 7 * 86400000; // 7 days
 
+// Pure gate decision (no IO) — exported for testing. Fail-OPEN on a
+// malformed-but-valid-JSON gate: a missing/non-numeric `epoch` makes
+// `now - epoch` NaN, and `NaN >= INTERVAL` is false — which would PERMANENTLY
+// block normalize with no recovery, contradicting the catch-branch's fail-open
+// intent (a corrupt file that fails JSON.parse already returns true). A future
+// epoch (clock skew / NTP correction) is equally suspect → run.
+export function _normalizeGateOpen(last, now) {
+  const epoch = last?.epoch;
+  if (typeof epoch !== 'number' || !Number.isFinite(epoch) || epoch > now) return true;
+  return now - epoch >= NORMALIZE_INTERVAL_MS;
+}
+
 export function shouldRunNormalize() {
   try {
     const last = JSON.parse(readFileSync(NORMALIZE_GATE_FILE, 'utf8'));
-    return Date.now() - last.epoch >= NORMALIZE_INTERVAL_MS;
+    return _normalizeGateOpen(last, Date.now());
   } catch {
     return true;
   }

package/mem-cli.mjs

@@ -1636,12 +1636,26 @@ function cmdRestore(db, argv) {
   const trimmed = raw.trim();
   if (!trimmed) { out('[mem] Empty file — nothing to restore.'); return; }
   let rows;
-  try {
-    rows = trimmed[0] === '['
-      ? JSON.parse(trimmed)
-      : trimmed.split('\n').filter(l => l.trim()).map(l => JSON.parse(l));
-  } catch (e) { fail(`[mem] "${file}" is not valid export JSON/JSONL: ${e.message}`); return; }
-  if (!Array.isArray(rows) || rows.length === 0) { out('[mem] No observations in file.'); return; }
+  let parseFailures = 0;
+  if (trimmed[0] === '[') {
+    // Whole-array JSON is a single document — partial parse is impossible, so
+    // a syntax error rejects the file (unchanged behavior).
+    try { rows = JSON.parse(trimmed); }
+    catch (e) { fail(`[mem] "${file}" is not valid export JSON/JSONL: ${e.message}`); return; }
+  } else {
+    // JSONL: tolerate per-line syntax errors so one corrupt line in a large
+    // backup doesn't discard every valid row. Parse failures fold into the
+    // malformed tally below (the loop already skips valid-JSON-but-wrong-shape
+    // rows the same way) — a backup tool must recover what it can.
+    rows = [];
+    for (const line of trimmed.split('\n')) {
+      if (!line.trim()) continue;
+      try { rows.push(JSON.parse(line)); }
+      catch { parseFailures++; }
+    }
+  }
+  if (!Array.isArray(rows) || (rows.length === 0 && parseFailures === 0)) { out('[mem] No observations in file.'); return; }
+  if (rows.length === 0) { fail(`[mem] "${file}": all ${parseFailures} line(s) failed to parse as JSONL.`); return; }
 
   const projOverride = flags.project ? resolveProject(db, flags.project) : null;
   const dryRun = flags['dry-run'] === true || flags['dry-run'] === 'true';
@@ -1693,7 +1707,12 @@ function cmdRestore(db, argv) {
       if (process.env.CLAUDE_MEM_DEBUG) process.stderr.write(`[mem] restore row failed: ${e.message}\n`);
     }
   }
-  out(`[mem] Restore${dryRun ? ' (dry-run)' : ''}: ${restored} restored, ${skipped} duplicate(s) skipped, ${malformed} malformed/failed from ${rows.length} row(s).`);
+  // Fold JSONL per-line syntax failures into the malformed tally and the
+  // denominator so the report reflects every non-blank input line, not just the
+  // ones that parsed.
+  const totalMalformed = malformed + parseFailures;
+  const totalLines = rows.length + parseFailures;
+  out(`[mem] Restore${dryRun ? ' (dry-run)' : ''}: ${restored} restored, ${skipped} duplicate(s) skipped, ${totalMalformed} malformed/failed from ${totalLines} row(s).`);
 }
 
 // ─── Compress ────────────────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem-lite",
-  "version": "3.16.0",
+  "version": "3.16.2",
   "description": "Persistent long-term memory for Claude Code via MCP — captures coding decisions, bugfixes, and context across sessions. Hybrid FTS5 + TF-IDF search with episode batching. Single SQLite DB, no external services. A lighter, lower-cost alternative to claude-mem (episode batching + a smaller model; cost savings are an internal estimate, not a measured benchmark).",
   "type": "module",
   "packageManager": "npm@10.9.2",

package/registry-github.mjs

@@ -9,7 +9,12 @@
  */
 export function parseGitHubUrl(url) {
   if (!url || typeof url !== 'string') return null;
-  const match = url.match(/^https?:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?\/?(?:\/tree\/([^/]+)(\/.*)?)?$/);
+  // Drop any query string / fragment (a copy-pasted "?tab=readme" or "#section"
+  // browser anchor) before matching. Otherwise it leaks into the captured branch
+  // ("main?x#y") and corrupts the GitHub API URL built from it, so the import
+  // fails with a confusing 404 on a URL that opens fine in the browser.
+  const clean = url.split(/[?#]/)[0];
+  const match = clean.match(/^https?:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?\/?(?:\/tree\/([^/]+)(\/.*)?)?$/);
   if (!match) return null;
   const [, owner, repo, branch, pathRaw] = match;
   return {

package/tool-schemas.mjs

@@ -636,7 +636,7 @@ export const tools = [
       '  - After a crash, power loss, or manual DB edit\n' +
       '  - doctor / stats flags FTS integrity problems\n' +
       '\n' +
-      'Equivalent CLI: ' + CLI_INVOKE + ' fts-check [--rebuild]',
+      'Equivalent CLI: ' + CLI_INVOKE + ' fts-check <check|rebuild>',
     inputSchema: memFtsCheckSchema,
     hidden: true,
   },