claude-mem-lite 2.32.7 → 2.33.0

package/.claude-plugin/marketplace.json

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

package/adopt-cli.mjs

@@ -9,7 +9,7 @@
 // --dry-run = print intent without writing
 // --status = list all adopted projects + versions
 
-import { existsSync, readdirSync, statSync } from 'fs';
+import { existsSync, readdirSync, statSync, mkdirSync, writeFileSync } from 'fs';
 import { homedir } from 'os';
 import { join } from 'path';
 import {
@@ -121,6 +121,58 @@ function adoptOne(memdir, { force, dryRun, all }) {
   }
 }
 
+/**
+ * silentAutoAdopt — plugin-mode first-run auto-adopt helper (v2.33.0).
+ *
+ * Preconditions (caller must gate): CLAUDE_PLUGIN_ROOT set, MEM_NO_AUTO_ADOPT!=1,
+ * MEM_QUIET_HOOKS!=1, first-attempt marker absent. This helper does NOT re-check
+ * those — it only does the write + marker persistence.
+ *
+ * Behavior:
+ *   - Writes plugin sentinel + detail doc to the memdir for `cwd`.
+ *   - Writes a per-project first-attempt marker under `markerDir` so a later
+ *     `/unadopt` is respected (no re-adopt loop).
+ *   - Silent: never logs, never throws. Returns structured result.
+ *
+ * Returns { ok, action, reason } — caller uses for telemetry / debugLog only.
+ */
+export function silentAutoAdopt({ cwd, markerDir, markerKey }) {
+  const memdir = memdirPath(cwd);
+  try {
+    if (isAdopted(memdir, PLUGIN_SLUG)) {
+      writeMarker(markerDir, markerKey);
+      return { ok: true, action: 'already-adopted' };
+    }
+    writePluginSection(memdir, {
+      slug: PLUGIN_SLUG,
+      version: CURRENT_SENTINEL_VERSION,
+      contentLine: getIndexLine(),
+      force: false,
+    });
+    writePluginDoc(memdir, PLUGIN_SLUG, getDetailDoc());
+    writeMarker(markerDir, markerKey);
+    return { ok: true, action: 'adopted' };
+  } catch (e) {
+    // Budget exceeded, user-edited conflict, or FS error — write marker so we
+    // don't retry on every SessionStart. User can run /adopt --force manually.
+    try { writeMarker(markerDir, markerKey); } catch { /* marker best-effort */ }
+    const reason = e instanceof UserEditedError ? 'user-edited'
+      : e instanceof BudgetExceededError ? 'budget-exceeded'
+      : 'error';
+    return { ok: false, action: 'skipped', reason, err: e };
+  }
+}
+
+function writeMarker(markerDir, markerKey) {
+  if (!existsSync(markerDir)) mkdirSync(markerDir, { recursive: true });
+  const path = join(markerDir, `.auto-adopt-${markerKey}`);
+  writeFileSync(path, JSON.stringify({ firstAttemptAt: new Date().toISOString() }));
+}
+
+export function hasAutoAdoptMarker(markerDir, markerKey) {
+  return existsSync(join(markerDir, `.auto-adopt-${markerKey}`));
+}
+
 function statusAll() {
   const dirs = listAllMemdirs();
   log('[adopt --status] scanning ~/.claude/projects/*/memory/');

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 { silentAutoAdopt, hasAutoAdoptMarker } from './adopt-cli.mjs';
 // plugin-cache-guard.mjs loaded dynamically — pre-2.31.2 installs that auto-upgraded
 // from an older hook-update.mjs SOURCE_FILES (which did not list this module) would
 // crash on static import. Degrade gracefully to no-op when the module is absent.
@@ -425,6 +426,35 @@ async function handleSessionStart() {
     }
   } catch (e) { debugCatch(e, 'session-start-cache-heal'); }
 
+  // v2.33.0: plugin-mode first-run auto-adopt. /plugin install IS consent to
+  // integration — writing the MEMORY.md sentinel once per project on first
+  // SessionStart avoids the opt-in friction. Scope is narrow:
+  //   - gated by CLAUDE_PLUGIN_ROOT (npm/npx installs stay opt-in)
+  //   - gated by !MEM_NO_AUTO_ADOPT (explicit escape hatch)
+  //   - gated by !MEM_QUIET_HOOKS (quiet = no side-effects semantics)
+  //   - first-attempt marker persists in RUNTIME_DIR so a subsequent /unadopt
+  //     is respected (no re-adopt loop).
+  // Failures (user-edited sentinel, budget exceeded, FS errors) are swallowed;
+  // the marker is still written so we don't retry on every SessionStart.
+  try {
+    if (
+      process.env.CLAUDE_PLUGIN_ROOT
+      && process.env.MEM_NO_AUTO_ADOPT !== '1'
+      && process.env.MEM_QUIET_HOOKS !== '1'
+    ) {
+      const project = inferProject();
+      if (!hasAutoAdoptMarker(RUNTIME_DIR, project)) {
+        const cwd = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+        const r = silentAutoAdopt({ cwd, markerDir: RUNTIME_DIR, markerKey: project });
+        if (r.ok) {
+          debugLog('DEBUG', 'session-start-auto-adopt', `action=${r.action} project=${project}`);
+        } else {
+          debugLog('DEBUG', 'session-start-auto-adopt', `skipped project=${project} reason=${r.reason}`);
+        }
+      }
+    }
+  } catch (e) { debugCatch(e, 'session-start-auto-adopt'); }
+
   // 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem-lite",
-  "version": "2.32.7",
+  "version": "2.33.0",
   "description": "Lightweight persistent memory system for Claude Code",
   "type": "module",
   "engines": {

package/scripts/prompt-search-utils.mjs

@@ -49,8 +49,8 @@ export const INTENTS = [
   // CJK: 开发/编写/创建/构建/做一个/写一个 from real prompts
   { pattern: /implement|feature\b|add\s+(?:a\s+)?new|实现|添加|新功能|新增|开发|编写|创建|构建|做一个|加一个|写一个/i, type: null, limit: 3 },
   // Recall/history intent (catch-all temporal, lowest priority)
-  // CJK: 刚才/历史/回顾 from real prompts
-  { pattern: /before|previously|last time|remember|之前|上次|以前|记得|刚才|历史|回顾/i, type: null, limit: 5, useRecent: true },
+  // CJK: 刚才/历史/回顾 from real prompts; 碰到过|遇到过|见过|同样的问题 from spoken CN
+  { pattern: /before|previously|last time|remember|seen this|same\s+issue|之前|上次|以前|记得|刚才|历史|回顾|碰到过|遇到过|见过|同样的问题|类似的问题/i, type: null, limit: 5, useRecent: true },
 ];
 
 export function detectIntent(text) {
@@ -75,6 +75,44 @@ export function detectIntent(text) {
   return first;
 }
 
+// ─── Error Signature Extraction ─────────────────────────────────────────────
+
+/**
+ * Extract a canonical error signature from prompt text.
+ *
+ * Matches named exception/error classes like:
+ *   - "TypeError: Cannot read properties of undefined (reading 'foo')"
+ *   - "Error [ERR_MODULE_NOT_FOUND]: module X not found"
+ *   - "AssertionError: expected 'a' to equal 'b'"
+ *   - "ValueError: invalid literal for int()"
+ *   - "thread 'main' panicked at ..." (Rust) → captured via Panic class
+ *
+ * Intentionally skips bare "Error: ..." without a typed class, and skips
+ * lowercase matches — those carry too little signal vs. the intent-based
+ * FTS path which already catches them.
+ *
+ * Returns { className, errorCode, message, signature } or null.
+ * `signature` is suitable for direct FTS5 search (sanitizeFtsQuery applies).
+ */
+export function extractErrorSignature(text) {
+  if (!text || typeof text !== 'string') return null;
+  // Pass 1: typed class — "<CapCase>(Error|Exception|Panic)" with optional [ERR_CODE]
+  const TYPED_RE = /\b([A-Z][A-Za-z0-9]+(?:Error|Exception|Panic))(?:\s*\[([A-Z_][A-Z0-9_]*)\])?\s*:\s*([^\n]{3,200})/;
+  // Pass 2: bare "Error|Exception|Panic" followed by required [ERR_CODE] (Node idiom).
+  // Bare class without a code is skipped — too noisy; intent-based path catches those.
+  const BARE_CODED_RE = /\b(Error|Exception|Panic)\s*\[([A-Z_][A-Z0-9_]*)\]\s*:\s*([^\n]{3,200})/;
+  const m = text.match(TYPED_RE) || text.match(BARE_CODED_RE);
+  if (!m) return null;
+  const className = m[1];
+  const errorCode = m[2] || null;
+  const message = m[3].trim().replace(/\s+/g, ' ').replace(/[`'"]+$/, '');
+  const sigMsg = message.slice(0, 80);
+  const signature = errorCode
+    ? `${className} ${errorCode} ${sigMsg}`
+    : `${className} ${sigMsg}`;
+  return { className, errorCode, message, signature };
+}
+
 // ─── Result Dedup ───────────────────────────────────────────────────────────
 
 export const MAX_SESSION_INJECTIONS = 15;

package/scripts/user-prompt-search.js

@@ -8,7 +8,7 @@ import { sanitizeFtsQuery, relaxFtsQueryToOr, truncate, typeIcon, inferProject,
 import { writeFileSync, readFileSync, existsSync, renameSync } from 'fs';
 import { join } from 'path';
 import Database from 'better-sqlite3';
-import { shouldSkip, detectIntent, shouldSkipByDedup, extractFiles, DEDUP_STALE_MS, matchRegistrySkillName } from './prompt-search-utils.mjs';
+import { shouldSkip, detectIntent, shouldSkipByDedup, extractFiles, extractErrorSignature, DEDUP_STALE_MS, matchRegistrySkillName } from './prompt-search-utils.mjs';
 
 // ─── Constants ──────────────────────────────────────────────────────────────
 
@@ -267,6 +267,18 @@ async function main() {
     const intent = detectIntent(promptText);
     let rows = [];
 
+    // A (v2.32.8): precision pass for named errors. When the prompt contains
+    // a typed exception signature (TypeError/ValueError/ReferenceError/...),
+    // seed results with exact-match bugfix observations before the intent-
+    // based FTS flow runs. These hits are the most directly relevant and
+    // take priority slots in the merged output.
+    const errSig = extractErrorSignature(promptText);
+    const sigRows = errSig
+      ? searchByFts(db, errSig.signature, project, 2, 'bugfix').filter(r =>
+          typeof r.relevance === 'number' && Math.abs(r.relevance) >= BM25_MIN_SCORE
+        )
+      : [];
+
     if (intent?.useRecent) {
       // Recall intent: show recent observations
       rows = searchRecent(db, project, intent.limit);
@@ -302,6 +314,12 @@ async function main() {
       rows = rows.slice(0, MAX_RESULTS);
     }
 
+    // A (v2.32.8): prepend error-signature hits (higher precision), dedup, cap.
+    if (sigRows.length > 0) {
+      const sigIds = new Set(sigRows.map(r => r.id));
+      rows = [...sigRows, ...rows.filter(r => !sigIds.has(r.id))].slice(0, MAX_RESULTS);
+    }
+
     const candidateIds = rows.map(r => r.id);
     const dedupSkip = shouldSkipByDedup(candidateIds, INJECTED_IDS_FILE);