claude-mem-lite 2.39.1 → 2.40.0

package/.claude-plugin/marketplace.json

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

package/mem-cli.mjs

@@ -172,6 +172,9 @@ function cmdSearch(db, args) {
   const effectiveSource = source || ((type || tier || minImportance) ? 'observations' : null);
 
   const results = [];
+  // Tracks whether AND returned 0 and OR recovered non-empty. Mirrors server.mjs
+  // ctx.orFallbackFired so the header can surface a "(relaxed AND→OR)" hint.
+  let orFallbackFired = false;
 
   // Search observations
   if (!effectiveSource || effectiveSource === 'observations') {
@@ -179,7 +182,10 @@ function cmdSearch(db, args) {
     if (obsRows.length === 0) {
       const orQuery = relaxFtsQueryToOr(ftsQuery);
       if (orQuery) {
-        try { obsRows = searchFts(db, orQuery, { type, project, limit, dateFrom, dateTo, minImportance, branch, includeNoise, offset: effectiveSource ? offset : 0 }); } catch {}
+        try {
+          obsRows = searchFts(db, orQuery, { type, project, limit, dateFrom, dateTo, minImportance, branch, includeNoise, offset: effectiveSource ? offset : 0 });
+          if (obsRows.length > 0) orFallbackFired = true;
+        } catch {}
       }
     }
     // Type-list fallback
@@ -388,7 +394,9 @@ function cmdSearch(db, args) {
 
   const showTime = sort === 'time';
   const hasMixed = paged.some(r => r._source === 'session' || r._source === 'prompt');
-  out(`[mem] ${paged.length} result${paged.length !== 1 ? 's' : ''} for "${query}":${hasMixed ? ' (# observation, S# session, P# prompt)' : ''}`);
+  // Suppressed when --or was explicit — user already asked for OR, no "fallback" there.
+  const fallbackHint = orFallbackFired && !useOr ? ' (relaxed AND→OR)' : '';
+  out(`[mem] ${paged.length} result${paged.length !== 1 ? 's' : ''} for "${query}"${fallbackHint}:${hasMixed ? ' (# observation, S# session, P# prompt)' : ''}`);
   for (const r of paged) {
     const timeStr = showTime && r.created_at_epoch ? ` (${relativeTime(r.created_at_epoch)})` : '';
     if (r._source === 'session') {

package/package.json

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

package/scripts/pre-tool-recall.js

@@ -228,6 +228,10 @@ try {
     // but the total payload is bounded by the 3-row limit and the cooldown.
     const LESSON_MAX = isRead ? 120 : 240;
     if (allRows.length > 0) {
+      // Framing line mirrors #7758 handoff-injection fix: without an explicit
+      // "system-injected, continue" disclaimer, observed turn-end after Edit+reminder
+      // when the model misreads passive lesson context as a closing note.
+      lines.push(`[mem] PreToolUse recall — system-injected context, continue your planned action:`);
       lines.push(`[mem] Lessons for ${fname}:`);
       for (const r of allRows) {
         if (r.lesson_learned) {
@@ -250,6 +254,7 @@ try {
       // v2.34.6: Read does NOT emit this nudge. Read is passive — the agent
       // isn't necessarily about to solve anything, so /lesson prompts are noise.
       // Empty Reads exit silently, saving ~60 tokens × (every empty-file Read).
+      lines.push(`[mem] PreToolUse recall — system-injected context, continue your planned action:`);
       lines.push(`[mem] No prior lessons for ${fname} — if you solve a non-obvious bug here, run: /lesson --file ${fname} "<root cause + fix>"`);
     }
 

package/server.mjs

@@ -235,13 +235,17 @@ function searchObservations(ctx) {
       .all(...buildObsFtsParams({ now, projectBoost, ftsQuery, args, epochFrom, epochTo, limit: perSourceLimit, offset: perSourceOffset }));
     for (const r of rows) results.push(ftsRowToResult(r, { snippet: true }));
 
-    // OR fallback: when AND query returns 0 results, retry with OR semantics
+    // OR fallback: when AND query returns 0 results, retry with OR semantics.
+    // Sets ctx.orFallbackFired so the top-level formatter can surface a "relaxed
+    // AND→OR" hint — without it, callers can't distinguish a strict multi-term
+    // match from a partial single-term recovery.
     if (rows.length === 0) {
       const orQuery = relaxFtsQueryToOr(ftsQuery);
       if (orQuery) {
         try {
           const orRows = db.prepare(buildObsFtsQuery('full', { multiplier: 0.5, withSnippet: true, withOffset: true, includeNoise }))
             .all(...buildObsFtsParams({ now, projectBoost, ftsQuery: orQuery, args, epochFrom, epochTo, limit: perSourceLimit, offset: perSourceOffset }));
+          if (orRows.length > 0) ctx.orFallbackFired = true;
           for (const r of orRows) results.push(ftsRowToResult(r, { snippet: true }));
         } catch (e) { debugCatch(e, 'searchObservations-or-fallback'); }
       }
@@ -515,7 +519,7 @@ function searchPrompts(ctx) {
   return results;
 }
 
-function formatSearchOutput(paginatedResults, args, ftsQuery, totalCount, isCrossSource) {
+function formatSearchOutput(paginatedResults, args, ftsQuery, totalCount, isCrossSource, orFallbackFired = false) {
   if (paginatedResults.length === 0) {
     const hint = [];
     if (args.query && !ftsQuery) {
@@ -540,7 +544,11 @@ function formatSearchOutput(paginatedResults, args, ftsQuery, totalCount, isCros
   // P2-6: empty/omitted query falls through to a "listing recent" path — label it explicitly
   // so callers don't mistake BM25-less results for relevance-ranked ones.
   const qLabel = args.query ? ` for "${args.query}"` : ' (no query — listing recent)';
-  lines.push(`Found ${countLabel} result(s)${qLabel}:${hasMixed ? ' (# observation, S# session, P# prompt)' : ''}\n`);
+  // Surface AND→OR fallback so callers (incl. Claude) know a strict multi-term
+  // query actually matched only a subset of the terms. Suppressed when the caller
+  // explicitly requested OR semantics — there's no "fallback" in that path.
+  const fallbackHint = orFallbackFired && !args.or ? ' (relaxed AND→OR)' : '';
+  lines.push(`Found ${countLabel} result(s)${qLabel}${fallbackHint}:${hasMixed ? ' (# observation, S# session, P# prompt)' : ''}\n`);
 
   for (const r of paginatedResults) {
     if (r.source === 'obs') {
@@ -698,7 +706,7 @@ server.registerTool(
     // Always apply pagination — single-source results can exceed SQL LIMIT due to expansion (concept co-occurrence, PRF, vector search)
     const paginatedResults = (offset > 0 || results.length > limit) ? results.slice(offset, offset + limit) : results;
 
-    return formatSearchOutput(paginatedResults, args, ftsQuery, totalBeforePagination, isCrossSource);
+    return formatSearchOutput(paginatedResults, args, ftsQuery, totalBeforePagination, isCrossSource, ctx.orFallbackFired === true);
   })
 );