claude-mem-lite 3.25.0 → 3.27.0

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
   "plugins": [
     {
       "name": "claude-mem-lite",
-      "version": "3.25.0",
+      "version": "3.27.0",
       "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.25.0",
+  "version": "3.27.0",
   "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/lib/search-core.mjs

@@ -290,7 +290,7 @@ export async function coreRunSearchPipeline(ctx, opts) {
   const {
     db, currentProject = null, env = process.env,
     searchObservationsHybrid, deepSearch, shouldEscalateToDeep,
-    autoDeepLlmReady, reRankWithContext, markSuperseded,
+    autoDeepLlmReady, reRankWithContext,
     llm = null, rerankLlm = undefined,
   } = ctx;
   const {
@@ -437,14 +437,13 @@ export async function coreRunSearchPipeline(ctx, opts) {
     else if (crossSourceEpochSortNoFts) results.sort((a, b) => (b.created_at_epoch ?? 0) - (a.created_at_epoch ?? 0));
   }
 
-  // ── Context re-rank + superseded marking (markSuperseded is pure stale-tagging) ──
+  // ── Context re-rank ──
   const hasObs = results.some((r) => r.source === 'obs');
   const rerankGate = rerankPolicy === 'mcp' ? ((ftsQuery || isDeep) && hasObs) : hasObs;
   if (rerankGate) {
     const obsResults = results.filter((r) => r.source === 'obs');
     const doReRank = rerankPolicy === 'mcp' ? (ftsQuery && !deepReranked) : !deepReranked;
     if (doReRank) reRankWithContext(db, obsResults, rerankProject);
-    markSuperseded(obsResults);
     // CLI single-source path must also re-sort when a context re-rank actually ran,
     // else reRankWithContext's score boost mutates scores but never reorders output
     // (audit #9). MCP branch unchanged. doReRank already implies a rerank happened.

package/mem-cli.mjs

@@ -8,7 +8,7 @@ import { truncate, typeIcon, inferProject, scrubSecrets } from './utils.mjs';
 import { resolveProject } from './project-utils.mjs';
 import { TIER_CASE_SQL, tierSqlParams } from './tier.mjs';
 import { _resetVocabCache } from './tfidf.mjs';
-import { autoBoostIfNeeded, reRankWithContext, markSuperseded } from './search-scoring.mjs';
+import { autoBoostIfNeeded, reRankWithContext } from './search-scoring.mjs';
 import { searchObservationsHybrid } from './search-engine.mjs';
 import { deepSearch, resolveDeepMode, shouldEscalateToDeep, autoDeepLlmReady } from './deep-search.mjs';
 import { ensureRegistryDb, upsertResource } from './registry.mjs';
@@ -178,7 +178,7 @@ async function cmdSearch(db, args, { llm } = {}) {
     {
       db, currentProject: project ? null : inferProject(), env: process.env,
       searchObservationsHybrid, deepSearch, shouldEscalateToDeep, autoDeepLlmReady,
-      reRankWithContext, markSuperseded, llm,
+      reRankWithContext, llm,
     },
     {
       query, ftsQuery, effectiveSource, deepMode, rerank,
@@ -262,7 +262,6 @@ async function cmdSearch(db, args, { llm } = {}) {
         title: r.title || r.subtitle || null,
         lesson_learned: r.lesson_learned || null,
         importance: r.importance ?? null,
-        superseded: Boolean(r.superseded),
         files_modified: r.files_modified || null,
         body_tokens: r.bodyTokens ?? null,
       };
@@ -300,8 +299,7 @@ async function cmdSearch(db, args, { llm } = {}) {
     } else {
       const date = fmtDateShort(r.created_at);
       const title = truncate(r.title || r.subtitle || '(untitled)', 80);
-      const supersededTag = r.superseded ? ' [SUPERSEDED]' : '';
-      out(`#${r.id} ${typeIcon(r.type)} ${date}${timeStr} ${title}${supersededTag}${tok(r)}`);
+      out(`#${r.id} ${typeIcon(r.type)} ${date}${timeStr} ${title}${tok(r)}`);
       if (r.lesson_learned) {
         out(`  -> ${truncate(r.lesson_learned, 80)}`);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem-lite",
-  "version": "3.25.0",
+  "version": "3.27.0",
   "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/scripts/user-prompt-search.js

@@ -211,23 +211,25 @@ export function hasExplicitSignal(text, { errSig, files, intent } = {}) {
   return false;
 }
 
-// ─── Identifier-exact-match precision bypass (default OFF) ───────────────────
+// ─── Identifier-exact-match precision bypass (default ON since v3.26.0) ──────
 //
-// CLAUDE_MEM_UPS_IDENTIFIER_BYPASS=1 enables it. Rationale: the score-floors below
+// Set CLAUDE_MEM_UPS_IDENTIFIER_BYPASS=0 to disable. Rationale: the score-floors below
 // (OR_TOP_BM25_FLOOR / TOP_REL_FLOOR) drop the WHOLE FTS set when the top row's
 // magnitude is weak. But a rare code identifier (camelCase / snake_case / CONST_CASE
 // / kebab≥3) match has high *semantic* precision even at modest BM25 — a df=1 term
 // like `sanitizeFtsQuery` scores only ~23 raw yet is an unambiguous hit. So an obs
 // whose title/lesson EXACT-matches an identifier the prompt names is a precision pass
 // — the same independent-signal rationale that already exempts sigRows (error
-// signatures) and fileRows (file names) from these floors. When enabled, such rows are
-// restored after the floors run.
+// signatures) and fileRows (file names) from these floors. Such rows are restored
+// after the floors run.
 //
-// Default OFF — opt-in. benchmark/ups-ab.mjs measured it TRADEOFF on the real corpus
-// (+3 recall recoveries / +4 injections over 12 positives / 8 hard-negatives); the
-// "cost" was eager surfacing of on-identifier obs on non-recall-framed prompts, not
-// off-topic noise. Kept opt-in (below the NET-POSITIVE/NEUTRAL ship bar). See #8858.
-export const IDENTIFIER_BYPASS = process.env.CLAUDE_MEM_UPS_IDENTIFIER_BYPASS === '1';
+// Default ON — flipped in v3.26.0 after a corrected benchmark/ups-ab.mjs re-measurement
+// (#8858 two-bucket: TRUE off-topic FP isolated from on-topic eagerness). Over 12
+// positives / 7 true-precision hard-negatives: recall up, TRUE off-topic FP = 0 (stable
+// ×3 runs) → VERDICT NET-POSITIVE. The only behavior delta is on-topic eagerness (naming
+// an identifier surfaces its obs) — the highest-precision injection trigger there is. The
+// prose stop-list (IDENTIFIER_STOPWORDS) keeps the extractor off ordinary English.
+export const IDENTIFIER_BYPASS = process.env.CLAUDE_MEM_UPS_IDENTIFIER_BYPASS !== '0';
 const TECH_IDENTIFIER_RE_G = new RegExp(TECH_IDENTIFIER_RE.source, 'g');
 
 // All tech-identifier tokens in `text`, lowercased + de-duped (for case-insensitive
@@ -615,8 +617,8 @@ async function main() {
     const signalPresent = hasExplicitSignal(promptText, {
       errSig, files: filesForGate, intent,
     });
-    // Identifier tokens the prompt names (for the precision bypass below). Empty
-    // unless CLAUDE_MEM_UPS_IDENTIFIER_BYPASS=1, so this is a no-op when disabled.
+    // Identifier tokens the prompt names (for the precision bypass below). Empty only
+    // when CLAUDE_MEM_UPS_IDENTIFIER_BYPASS=0 (bypass is default-on), then it is a no-op.
     const promptIdentifiers = IDENTIFIER_BYPASS ? extractTechIdentifiers(promptText) : [];
 
     if (intent?.useRecent) {
@@ -649,7 +651,7 @@ async function main() {
         typeof r.relevance === 'number' && Math.abs(r.relevance) >= bm25Floor
       );
 
-      // Identifier-exact-match precision bypass (default off — see IDENTIFIER_BYPASS).
+      // Identifier-exact-match precision bypass (default on — see IDENTIFIER_BYPASS).
       // Capture rows that exact-match a prompt identifier BEFORE the set-floors below;
       // they carry independent precision signal (sigRows/fileRows rationale) and are
       // restored after the floors so a low top-score can't drop a named-identifier hit.

package/search-scoring.mjs

@@ -127,53 +127,6 @@ export function reRankWithContext(db, results, project) {
   // Note: caller re-sorts the main results array after this — no sort needed here
 }
 
-/**
- * Mark older, lower-importance observations as superseded when multiple touch the same file.
- * Mutates result objects in-place by adding superseded=true flag.
- * @param {object[]} results Array of search result objects with source, files_modified,
- *   created_at_epoch (or created_at / legacy date), importance
- */
-export function markSuperseded(results) {
-  if (!results || results.length === 0) return;
-  // Build map: file → [result objects], only for obs with files
-  const fileMap = new Map();
-  for (const r of results) {
-    if (r.source !== 'obs' || !r.files_modified) continue;
-    let files;
-    try { files = JSON.parse(r.files_modified || '[]'); } catch (e) { debugCatch(e, 'markSuperseded-parse'); continue; }
-    for (const f of files) {
-      if (!fileMap.has(f)) fileMap.set(f, []);
-      fileMap.get(f).push(r);
-    }
-  }
-  // For each file with 2+ observations: mark older lower-importance as superseded (in-memory only)
-  // Note: DB persistence removed — search is a read operation and should not write.
-  // Persistent superseding belongs in mem_maintain/mem_compress write paths.
-  for (const [, obsForFile] of fileMap) {
-    if (obsForFile.length < 2) continue;
-    // Sort newest-first by recency. Every production obs row carries `date`
-    // (= created_at ISO, set by ftsRowToResult); the FTS/type paths also carry
-    // created_at_epoch, the vector/type-list paths carry date-only. So the prior
-    // `b.date` sort already ordered correctly in production — this is defensive
-    // hardening, not a prod no-op fix (a post-release review corrected the original
-    // #8821 "missing-`date`" diagnosis). Prefer the numeric epoch, fall back to the
-    // ISO created_at (lexically chronological), then legacy `date`, so the key holds
-    // for any caller regardless of which recency fields it supplies.
-    obsForFile.sort((a, b) => {
-      const ka = a.created_at_epoch ?? a.created_at ?? a.date ?? '';
-      const kb = b.created_at_epoch ?? b.created_at ?? b.date ?? '';
-      if (typeof ka === 'number' && typeof kb === 'number') return kb - ka;
-      return String(kb).localeCompare(String(ka));
-    });
-    const newest = obsForFile[0];
-    for (let i = 1; i < obsForFile.length; i++) {
-      if ((obsForFile[i].importance ?? 1) <= (newest.importance ?? 1)) {
-        obsForFile[i].superseded = true;
-      }
-    }
-  }
-}
-
 // ─── Pseudo-Relevance Feedback (PRF) ────────────────────────────────────────
 // Two-phase document-level expansion: extract discriminative terms from top
 // results' full text (title + narrative), filter out query terms + stop words,

package/server.mjs

@@ -8,7 +8,7 @@ import { ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { truncate, typeIcon, inferProject, scrubSecrets, fmtDate, debugLog, debugCatch, isPathConfined } from './utils.mjs';
 import { resolveProject as _resolveProjectShared } from './project-utils.mjs';
 import { ensureDb, DB_PATH, DB_DIR, REGISTRY_DB_PATH } from './schema.mjs';
-import { reRankWithContext, markSuperseded, autoBoostIfNeeded, runIdleCleanup, buildServerInstructions } from './search-scoring.mjs';
+import { reRankWithContext, autoBoostIfNeeded, runIdleCleanup, buildServerInstructions } from './search-scoring.mjs';
 import { searchObservationsHybrid } from './search-engine.mjs';
 import { deepSearch, resolveDeepMode, shouldEscalateToDeep, autoDeepLlmReady } from './deep-search.mjs';
 import { selectCompressionCandidates, groupByProjectWeek, compressGroup } from './lib/compress-core.mjs';
@@ -231,8 +231,7 @@ function formatSearchOutput(paginatedResults, args, ftsQuery, totalCount, orFall
   const tok = r => (r.bodyTokens ? ` ~${r.bodyTokens}t` : '');
   for (const r of paginatedResults) {
     if (r.source === 'obs') {
-      const supersededTag = r.superseded ? ' [SUPERSEDED]' : '';
-      lines.push(`#${r.id} ${typeIcon(r.type)} [${r.type}] ${truncate(r.title || r.subtitle || '(untitled)')} | ${r.project} | ${fmtDate(r.date)}${supersededTag}${tok(r)}`);
+      lines.push(`#${r.id} ${typeIcon(r.type)} [${r.type}] ${truncate(r.title || r.subtitle || '(untitled)')} | ${r.project} | ${fmtDate(r.date)}${tok(r)}`);
       if (r.snippet && r.snippet.length > 10 && r.snippet !== r.title) {
         lines.push(`     ${truncate(r.snippet, 100)}`);
       }
@@ -292,7 +291,7 @@ async function runSearchPipeline(db, args, { llm, rerankLlm } = {}) {
     {
       db, currentProject, env: process.env,
       searchObservationsHybrid, deepSearch, shouldEscalateToDeep, autoDeepLlmReady,
-      reRankWithContext, markSuperseded, llm, rerankLlm,
+      reRankWithContext, llm, rerankLlm,
     },
     {
       query: args.query, ftsQuery, effectiveSource: effectiveType, deepMode, rerank,