claude-mem-lite 3.64.0 → 3.65.0

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
   "plugins": [
     {
       "name": "claude-mem-lite",
-      "version": "3.64.0",
+      "version": "3.65.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.64.0",
+  "version": "3.65.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/deep-search.mjs

@@ -36,6 +36,7 @@ import { sanitizeFtsQuery } from './utils.mjs';
 import { RRF_K } from './tfidf.mjs';
 import { rrfAccumulate } from './lib/rrf.mjs';
 import { llmRerankOrder, defaultRerankLLM } from './rerank.mjs';
+import { liveObsFilterSql } from './lib/inject-search-core.mjs';
 
 // original + up to 3 rewrites (keyword / concept-expansion / HyDE).
 export const MAX_VARIANTS = 4;
@@ -68,7 +69,7 @@ export const AUTO_DEEP_MIN_CORPUS = 10;
  */
 export function hasEscalatableCorpus(db, project, min = AUTO_DEEP_MIN_CORPUS) {
   try {
-    const where = ['superseded_at IS NULL', 'COALESCE(compressed_into, 0) = 0'];
+    const where = [liveObsFilterSql('')];
     const params = [];
     if (project) { where.push('project = ?'); params.push(project); }
     const row = db.prepare(`SELECT COUNT(*) AS c FROM observations WHERE ${where.join(' AND ')}`).get(...params);

package/hook-context.mjs

@@ -12,9 +12,10 @@ import {
   debugLog, debugCatch, neutralizeContextDelimiters,
   DECAY_HALF_LIFE_BY_TYPE, DEFAULT_DECAY_HALF_LIFE_MS, notLowSignalTitleClause,
 } from './utils.mjs';
-import { STALE_SESSION_MS, FALLBACK_OBS_WINDOW_MS, RUNTIME_DIR, effectiveQuiet, isQuietHooks } from './hook-shared.mjs';
+import { STALE_SESSION_MS, FALLBACK_OBS_WINDOW_MS, RUNTIME_DIR, effectiveQuiet, isQuietHooks, KEY_CONTEXT_LIMIT } from './hook-shared.mjs';
 import { extractUnfinishedSummary } from './hook-handoff.mjs';
 import { recentInjectableEvents, renderInjectableEvent } from './lib/events-injection.mjs';
+import { liveObsFilterSql } from './lib/inject-search-core.mjs';
 
 /**
  * Infer the project directory from environment variables or cwd.
@@ -83,12 +84,7 @@ export function selectWithTokenBudget(db, project, budget = 2000) {
   const obsPool = db.prepare(`
     SELECT id, type, title, narrative, importance, created_at_epoch, files_modified, lesson_learned
     FROM observations
-    WHERE project = ? AND COALESCE(compressed_into, 0) = 0
-      -- superseded invisibility: auto-dedup (hook.mjs) sets superseded_at but leaves
-      -- compressed_into=0, so the compressed filter alone lets the hidden near-duplicate
-      -- resurface in the most-visible surface (injected every SessionStart). Sibling
-      -- keyObs already filters this; obsPool + fallbackObs must match.
-      AND superseded_at IS NULL
+    WHERE project = ? AND ${liveObsFilterSql('')}
       AND ${notLowSignalTitleClause('')}
       AND (
         (created_at_epoch > ? AND importance >= 1)
@@ -293,9 +289,15 @@ export function cleanupClaudeMdLegacyBlock() {
  * @param {string|null} [currentCcSessionId=null] Claude Code session id — when provided,
  *   the "Working State (from /clear)" block is filtered to handoffs owned by this
  *   session, preventing parallel-session bleed (see docs/bug.txt).
+ * @param {object|null} [collector=null] Optional out-param: when given, its
+ *   `keyContextIds` property is set to the obs ids ACTUALLY rendered into the
+ *   File Lessons / Key Context sections ([] under quiet/adopted or when the
+ *   sections are empty). handleUserPrompt persists this as its exclude-set
+ *   (D#123: the exclude-set must mirror real injections, not the keyObs query).
  * @returns {string} Joined markdown lines (without <claude-mem-context> wrappers)
  */
-export function buildSessionContextLines(db, project, now = new Date(), currentCcSessionId = null) {
+export function buildSessionContextLines(db, project, now = new Date(), currentCcSessionId = null, collector = null) {
+  if (collector) collector.keyContextIds = [];
   // 1. Token-budgeted observation selection
   const selected = selectWithTokenBudget(db, project, 2000);
   const observations = selected.observations;
@@ -308,8 +310,7 @@ export function buildSessionContextLines(db, project, now = new Date(), currentC
     fallbackObs = db.prepare(`
       SELECT id, type, title, project, created_at
       FROM observations
-      WHERE COALESCE(compressed_into, 0) = 0
-        AND superseded_at IS NULL
+      WHERE ${liveObsFilterSql('')}
         AND ${notLowSignalTitleClause('')}
         AND (
           (created_at_epoch > ? AND importance >= 1)
@@ -335,10 +336,9 @@ export function buildSessionContextLines(db, project, now = new Date(), currentC
   //    and Key Context (informational). Pushed into summaryLines.
   const keyObs = db.prepare(`
     SELECT o.id, o.type, o.title, o.lesson_learned, o.files_modified FROM observations o
-    WHERE o.project = ? AND COALESCE(o.compressed_into, 0) = 0
-      AND o.superseded_at IS NULL
+    WHERE o.project = ? AND ${liveObsFilterSql('o')}
       AND COALESCE(o.importance, 1) >= 2
-    ORDER BY o.created_at_epoch DESC LIMIT 10
+    ORDER BY o.created_at_epoch DESC LIMIT ${KEY_CONTEXT_LIMIT}
   `).all(project);
 
   if (keyObs.length > 0) {
@@ -357,30 +357,35 @@ export function buildSessionContextLines(db, project, now = new Date(), currentC
           const files = JSON.parse(o.files_modified);
           const fname = basename(Array.isArray(files) && files.length > 0 ? files[0] : '');
           if (fname) {
-            fileLessons.push(`- ${fname}: ${truncate(o.lesson_learned, 100)} (#${o.id})`);
+            fileLessons.push({ id: o.id, line: `- ${fname}: ${truncate(o.lesson_learned, 100)} (#${o.id})` });
             continue;
           }
         } catch { /* fall through to keyContext */ }
       }
       const lesson = hasLesson ? ` — ${truncate(o.lesson_learned, 60)}` : '';
-      keyContext.push(`- [${o.type || 'discovery'}] ${truncate(clean, 80)} (#${o.id})${lesson}`);
+      keyContext.push({ id: o.id, line: `- [${o.type || 'discovery'}] ${truncate(clean, 80)} (#${o.id})${lesson}` });
     }
 
     // Phase A (QUIET_HOOKS) + Phase D (adopted sentinel): drop descriptive
     // File Lessons / Key Context sections when the user has opted into low-noise
     // hooks OR adopted invited-memory (MEMORY.md sentinel carries the triggers
     // at higher system-prompt authority). The Recent table still fires so #IDs
-    // remain reachable via mem_get.
+    // remain reachable via mem_get. The collector sees only rows that survive
+    // BOTH the quiet gate and the per-section slice — rendered rows, nothing else.
     const quiet = effectiveQuiet();
     if (fileLessons.length > 0 && !quiet) {
+      const shown = fileLessons.slice(0, 5);
       summaryLines.push('### File Lessons');
-      summaryLines.push(...fileLessons.slice(0, 5));
+      summaryLines.push(...shown.map((e) => e.line));
       summaryLines.push('');
+      if (collector) collector.keyContextIds.push(...shown.map((e) => e.id));
     }
     if (keyContext.length > 0 && !quiet) {
+      const shown = keyContext.slice(0, 5);
       summaryLines.push('### Key Context');
-      summaryLines.push(...keyContext.slice(0, 5));
+      summaryLines.push(...shown.map((e) => e.line));
       summaryLines.push('');
+      if (collector) collector.keyContextIds.push(...shown.map((e) => e.id));
     }
   } else if (!latestSummary && !effectiveQuiet()) {
     // Fallback: no summary AND no key observations — show recent activity.

package/hook-handoff.mjs

@@ -13,6 +13,7 @@ import {
 // immutable in ESM and cannot be mocked after the fact.
 import * as gitStateModule from './lib/git-state.mjs';
 import * as taskReaderModule from './lib/task-reader.mjs';
+import { liveObsFilterSql } from './lib/inject-search-core.mjs';
 
 /**
  * Build and save a handoff snapshot to session_handoffs table.
@@ -76,8 +77,7 @@ export function buildAndSaveHandoff(db, sessionId, project, type, episodeSnapsho
   if (subjectPrompts.length === 0) {
     const fallback = db.prepare(`
       SELECT title FROM observations
-      WHERE project = ? AND COALESCE(compressed_into, 0) = 0
-        AND superseded_at IS NULL
+      WHERE project = ? AND ${liveObsFilterSql('')}
         AND COALESCE(importance, 1) >= 3
         AND ${notLowSignalTitleClause('')}
       ORDER BY created_at_epoch DESC LIMIT 1
@@ -185,8 +185,7 @@ export function buildAndSaveHandoff(db, sessionId, project, type, episodeSnapsho
   const decisions = db.prepare(`
     SELECT title FROM observations
     WHERE memory_session_id = ? AND COALESCE(importance, 1) >= 2
-      AND COALESCE(compressed_into, 0) = 0
-      AND superseded_at IS NULL ${obsWindowClause}
+      AND ${liveObsFilterSql('')} ${obsWindowClause}
     ORDER BY created_at_epoch DESC LIMIT 10
   `).all(sessionId, ...obsWindowParams).filter(d => d.title && !LOW_SIGNAL_TITLE.test(d.title)).slice(0, 5);
 

package/hook-optimize.mjs

@@ -20,6 +20,7 @@ import { getVocabulary, computeVector, cosineSimilarity, vecTextForRow } from '.
 import { MERGE_JACCARD_LOW, AUTO_MERGE_THRESHOLD } from './lib/dedup-constants.mjs';
 import { DB_DIR } from './schema.mjs';
 import { OBS_TYPE_SET } from './lib/obs-types.mjs';
+import { liveObsFilterSql } from './lib/inject-search-core.mjs';
 
 const RUNTIME_DIR = join(DB_DIR, 'runtime');
 
@@ -104,8 +105,7 @@ export function findReenrichCandidates(db, limit = 10, { scope = 'narrow', proje
     const stmt = db.prepare(`
       SELECT id, title, narrative, type, subtitle, concepts, facts, text, search_aliases, importance, project
       FROM observations
-      WHERE COALESCE(compressed_into, 0) = 0
-        AND superseded_at IS NULL
+      WHERE ${liveObsFilterSql('')}
         AND (search_aliases IS NULL OR search_aliases = '')
         AND LENGTH(COALESCE(narrative, '')) > 100
         AND ${notLowSignalTitleClause('')}
@@ -119,8 +119,7 @@ export function findReenrichCandidates(db, limit = 10, { scope = 'narrow', proje
     const stmt = db.prepare(`
       SELECT id, title, narrative, type, subtitle, concepts, facts, search_aliases, importance, project
       FROM observations
-      WHERE COALESCE(compressed_into, 0) = 0
-        AND superseded_at IS NULL
+      WHERE ${liveObsFilterSql('')}
         AND optimized_at IS NULL
         AND type IN ('bugfix','refactor','feature','decision')
         AND (lesson_learned IS NULL OR lesson_learned = '')
@@ -459,8 +458,7 @@ export function findMergeCandidates(db, maxClusters = 5, { project } = {}) {
   const stmt = db.prepare(`
     SELECT id, title, narrative, project, type, access_count, importance, created_at_epoch, minhash_sig, lesson_learned, concepts, facts
     FROM observations
-    WHERE COALESCE(compressed_into, 0) = 0
-      AND superseded_at IS NULL
+    WHERE ${liveObsFilterSql('')}
       AND optimized_at IS NULL
       AND title IS NOT NULL AND title != ''
       AND created_at_epoch > ?

package/hook-precompact.mjs

@@ -5,11 +5,17 @@
 // Differs from SessionStart-on-compact (which fires AFTER compaction):
 // PreCompact ensures memory survives the compaction step itself.
 
+import { writeFileSync } from 'fs';
+import { join } from 'path';
 import { buildSessionContextLines } from './hook-context.mjs';
 import { inferProject, debugCatch, debugLog } from './utils.mjs';
+import { RUNTIME_DIR } from './hook-shared.mjs';
+import { keyContextIdsFileName } from './lib/injected-ids.mjs';
 
 /**
- * Build + emit the memory context block on stdout. Pure read; no DB writes.
+ * Build + emit the memory context block on stdout. Pure read; no DB writes
+ * (one runtime marker file: the Key Context ids the re-emitted block renders,
+ * refreshing handleUserPrompt's exclude-set — see D#123 in hook.mjs).
  *
  * @param {object} ctx
  * @param {import('better-sqlite3').Database} ctx.db
@@ -19,9 +25,16 @@ import { inferProject, debugCatch, debugLog } from './utils.mjs';
  */
 export function handlePreCompact({ db, project, sessionId }) {
   try {
-    const body = buildSessionContextLines(db, project, new Date(), sessionId || null);
+    const collector = {};
+    const body = buildSessionContextLines(db, project, new Date(), sessionId || null, collector);
     if (!body || String(body).trim() === '') return;
     process.stdout.write(`<claude-mem-context>\n${body}\n</claude-mem-context>\n`);
+    try {
+      writeFileSync(
+        join(RUNTIME_DIR, keyContextIdsFileName(project, sessionId || null)),
+        JSON.stringify({ ids: collector.keyContextIds || [], ts: Date.now(), session: sessionId || null }),
+      );
+    } catch (e) { debugCatch(e, 'pre-compact-keyctx-marker'); }
   } catch (e) {
     debugCatch(e, 'handlePreCompact');
   }

package/hook-shared.mjs

@@ -32,6 +32,12 @@ export const STALE_LOCK_MS = 30000;                       // 30s
 export const DEDUP_WINDOW_MS = 5 * 60 * 1000;            // 5 min (title dedup)
 export const RELATED_OBS_WINDOW_MS = 7 * 86400000;       // 7 days
 export const FALLBACK_OBS_WINDOW_MS = RELATED_OBS_WINDOW_MS; // same window
+// Candidate rows the SessionStart Key Context surface considers (hook-context.mjs
+// keyObs; each of the two sections then renders at most 5). The user-prompt
+// exclude-set does NOT mirror this query — it reads the ids actually rendered
+// from the keyctx marker (D#123 review C-1: query-mirroring suppressed
+// <memory-context> injection on quiet/adopted projects where nothing renders).
+export const KEY_CONTEXT_LIMIT = 10;
 
 // Phase A (v2.31.3+): MEM_QUIET_HOOKS=1 drops descriptive hook/MCP-instruction
 // bodies (File Lessons / Key Context headers, MCP WHEN-TO-USE & decision rules,

package/hook.mjs

@@ -68,7 +68,7 @@ import { formatTaskImperative } from './lib/task-imperative.mjs';
 import { recordSkillAdoption, gcOldShadowShards } from './registry-recommend.mjs';
 import { gcOldMetricShards, recordMetric } from './lib/metrics.mjs';
 import { detectMemOverride } from './lib/mem-override.mjs';
-import { injectedIdsFileName } from './lib/injected-ids.mjs';
+import { injectedIdsFileName, keyContextIdsFileName } from './lib/injected-ids.mjs';
 import { liveObsFilterSql, recencyDecaySql } from './lib/inject-search-core.mjs';
 import { buildAndSaveHandoff, detectContinuationIntent, renderHandoffInjection, pickHandoffToInject, extractUnfinishedSummary } from './hook-handoff.mjs';
 import { checkForUpdate, getCachedUpdateBanner, isUpdateCheckDue } from './hook-update.mjs';
@@ -869,7 +869,8 @@ function gcStalePreRecallCooldowns() {
       // D#120: the injected-ids marker is also per-session now — same growth
       // shape as the cooldown files, same 24h GC (dedup window is 5 min).
       const isCooldown = name.startsWith('pre-recall-cooldown-') && name.endsWith('.json');
-      const isInjectedMarker = name.startsWith('.claude-mem-injected-');
+      const isInjectedMarker = name.startsWith('.claude-mem-injected-')
+        || name.startsWith('.claude-mem-keyctx-'); // D#123 Key Context marker — same per-session growth, same 24h GC
       if (!isCooldown && !isInjectedMarker) continue;
       try {
         const p = join(RUNTIME_DIR, name);
@@ -1471,13 +1472,28 @@ async function handleSessionStart() {
     // token-budgeted observation pool directly from the DB.
     // Pass CC session id so the Working State block is scoped to this session,
     // preventing parallel sessions from seeing each other's /clear handoff.
-    const fullContext = buildSessionContextLines(db, project, now, ccSessionId);
+    const contextCollector = {};
+    const fullContext = buildSessionContextLines(db, project, now, ccSessionId, contextCollector);
 
     // Stdout is the sole context-delivery channel. The SessionStart hook output
     // is injected as a <system-reminder> at session start, giving Claude the
     // full summary + handoff state + observations table fresh from the DB.
     process.stdout.write(`<claude-mem-context>\n${fullContext}\n</claude-mem-context>\n`);
 
+    // D#123 (review C-1): persist the Key Context ids ACTUALLY rendered above so
+    // handleUserPrompt can exclude exactly those from <memory-context> — and
+    // nothing else. Under quiet/adopted the sections don't render, the id list is
+    // empty, and prompt-time injection is NOT suppressed (the old query-mirroring
+    // exclude-set blanked the same-project leg on adopted projects). Written
+    // unconditionally (even when empty) so a resumed session can't act on a
+    // previous session's stale marker semantics; 24h GC below.
+    try {
+      writeFileSync(
+        join(RUNTIME_DIR, keyContextIdsFileName(project, ccSessionId)),
+        JSON.stringify({ ids: contextCollector.keyContextIds || [], ts: Date.now(), session: ccSessionId || null }),
+      );
+    } catch (e) { debugCatch(e, 'session-start-keyctx-marker'); }
+
     // One-time migration: remove any stale <claude-mem-context> block left in
     // CLAUDE.md by pre-v2.30 installs. Idempotent no-op afterwards.
     cleanupClaudeMdLegacyBlock();
@@ -1651,13 +1667,21 @@ async function handleUserPrompt() {
     // (mirrors CC built-in memoryTypes.ts:215). Skip both Key Context lookup
     // and the <memory-context> emission for this turn.
     if (!detectMemOverride(promptText)) try {
-      const keyObs = db.prepare(`
-        SELECT id FROM observations
-        WHERE project = ? AND COALESCE(compressed_into, 0) = 0
-          AND COALESCE(importance, 1) >= 2
-        ORDER BY created_at_epoch DESC LIMIT 5
-      `).all(project);
-      const keyContextIds = keyObs.map(o => o.id);
+      // D#123 (review C-1): the exclude-set is the Key Context ids ACTUALLY
+      // rendered at SessionStart — read from the marker handleSessionStart wrote,
+      // not re-derived from a query. The old query-mirroring set excluded rows
+      // that were never shown (quiet/adopted projects render no Key Context at
+      // all), blanking the same-project <memory-context> leg outright. Missing
+      // or other-session marker → empty set: unknown injections must fail open
+      // (inject, maybe duplicate) rather than fail closed (suppress).
+      const keyContextIds = [];
+      try {
+        const raw = readFileSync(join(RUNTIME_DIR, keyContextIdsFileName(project, ccSessionId)), 'utf8');
+        const { ids, session } = JSON.parse(raw);
+        if (Array.isArray(ids) && !(session && ccSessionId && session !== ccSessionId)) {
+          keyContextIds.push(...ids);
+        }
+      } catch { /* no marker — nothing was injected, exclude nothing */ }
       const pathAInjectedIds = [];
 
       // Read IDs already injected by user-prompt-search.js to avoid duplicate injection
@@ -1686,8 +1710,9 @@ async function handleUserPrompt() {
       const taskImperativeOn = process.env.CLAUDE_MEM_TASK_IMPERATIVE === 'on'
         || process.env.CLAUDE_MEM_TASK_IMPERATIVE === '1';
       // Exclude only ids path-A (user-prompt-search.js) already injected — NOT the
-      // key-context top-5, which overlaps the high-value lesson pool and would suppress
-      // the pick. The chosen id is excluded from the <memory-context> block below instead.
+      // SessionStart Key Context set, which overlaps the high-value lesson pool and
+      // would suppress the pick. The chosen id is excluded from the <memory-context>
+      // block below instead.
       const imperativePick = taskImperativeOn
         ? selectImperativeLesson(db, promptText, project, pathAInjectedIds)
         : null;

package/lib/inject-search-core.mjs

@@ -1,10 +1,13 @@
-// lib/inject-search-core.mjs — the injection-side shared core (P2-11, audit
-// 2026-08-14). Shared home for the three SQL atoms that kept drifting across
-// hand-copied twins on the INJECTION-side retrieval surfaces (the five consumer
-// files the ledger test enforces — NOT yet the whole read surface: recall-core /
-// recent-core / timeline-core / hook-context / hook-handoff / hook-optimize /
-// deep-search / stats and the sessions/events decay arms in lib/search-core
-// still inline their own copies; extending them is the deferred second cut):
+// lib/inject-search-core.mjs — the retrieval-side shared core (P2-11, audit
+// 2026-08-14; second cut D#123, 2026-08-16). Shared home for the three SQL
+// atoms that kept drifting across hand-copied twins — first on the five
+// injection-side surfaces, then extended across the remaining read surfaces
+// (hook-context / hook-handoff / hook-optimize / mem-cli / search-scoring /
+// tfidf / deep-search / recall-core / recent-core / timeline-core / stats-core /
+// search-core incl. its sessions+events decay arms / maintain-core; the ledger
+// test enforces the full list). Deliberate compressed-only singles (maintain
+// UPDATE guards, stats noise-gauge counts, export tombstone toggles, session-own
+// history) stay inline — see the ledger test's non-member notes:
 //
 //   * live-row filter        — the compressed+superseded pair whose omission was
 //                              the superseded-invariant's recurring reopening
@@ -17,12 +20,12 @@
 //                              behavior factors (audit M-3: wired on every auto
 //                              surface, missing from the explicit-surface score)
 //
-// Consumers: scripts/user-prompt-search.js, scripts/pre-tool-recall.js,
-// hook-memory.mjs, hook.mjs (error-recall), search-engine.mjs. Each surface keeps
-// its own deliberate pipeline composition (BM25-sort + JS scoring vs SQL full
-// chain vs file-keyed sort — see #8786: per-surface asymmetries stay explicit);
-// only the ATOMS are shared. tests/inject-search-core.test.mjs holds the ledger:
-// the five consumer files must compose these builders, never re-inline copies.
+// Each surface keeps its own deliberate pipeline composition (BM25-sort + JS
+// scoring vs SQL full chain vs file-keyed sort — see #8786: per-surface
+// asymmetries stay explicit); only the ATOMS are shared.
+// tests/inject-search-core.test.mjs holds the ledger: consumer files must
+// compose these builders, never re-inline copies (and the decay shape may not
+// be hand-rolled anywhere, benchmark included).
 //
 // Lives under lib/ (not scripts/) so hook.mjs can statically import it without
 // colliding with the installExtractedRelease scripts-dir rename (same constraint

package/lib/injected-ids.mjs

@@ -27,3 +27,23 @@ export function injectedIdsFileName(project, sessionId) {
   const safe = String(sessionId).replace(/[^a-zA-Z0-9_.-]/g, '-').slice(0, 64);
   return `${base}-${safe}`;
 }
+
+/**
+ * Runtime-dir FILE NAME for the SessionStart Key Context marker: the obs ids
+ * ACTUALLY rendered into the <claude-mem-context> File Lessons / Key Context
+ * sections (empty under quiet/adopted). handleUserPrompt reads it as its
+ * exclude-set — D#123 review C-1: excluding the injector's QUERY result instead
+ * of what was really shown suppressed <memory-context> injection outright on
+ * quiet/adopted projects, where Key Context never renders at all.
+ * Session-lifetime validity (no time window): the SessionStart block stays in
+ * context for the whole session. Swept with the same 24h GC as the marker above.
+ * @param {string} project - inferProject() value (already filename-safe)
+ * @param {string} [sessionId] - CC session id
+ * @returns {string}
+ */
+export function keyContextIdsFileName(project, sessionId) {
+  const base = `.claude-mem-keyctx-${project}`;
+  if (!sessionId) return base;
+  const safe = String(sessionId).replace(/[^a-zA-Z0-9_.-]/g, '-').slice(0, 64);
+  return `${base}-${safe}`;
+}

package/lib/maintain-core.mjs

@@ -15,6 +15,7 @@
 import { COMPRESSED_PENDING_PURGE, computeMinHash, estimateJaccardFromMinHash, jaccardSimilarity } from '../utils.mjs';
 import { rebuildVocabulary, computeVector, _resetVocabCache, vectorsEnabled, vecTextForRow } from '../tfidf.mjs';
 import { DEDUP_JACCARD_THRESHOLD, MINHASH_PRE_THRESHOLD as MINHASH_PRE_THRESHOLD_SRC, FUZZY_DEDUP_THRESHOLD, FUZZY_BODY_THRESHOLD, MINHASH_PREFILTER } from './dedup-constants.mjs';
+import { liveObsFilterSql } from './inject-search-core.mjs';
 
 export const STALE_AGE_MS = 30 * 86400000;
 export const OP_CAP = 1000;
@@ -132,9 +133,8 @@ export function recoverOrphanedChildren(db, { projectFilter = '', baseParams = [
 export function recoverBuriedLessons(db, { projectFilter = '', baseParams = [] } = {}) {
   return db.prepare(`
     UPDATE observations SET importance = 1
-    WHERE COALESCE(compressed_into, 0) = 0
+    WHERE ${liveObsFilterSql('')}
       AND COALESCE(importance, 1) = 0
-      AND superseded_at IS NULL
       AND lesson_learned IS NOT NULL AND lesson_learned <> '' AND lower(lesson_learned) <> 'none'
       ${projectFilter}
   `).run(...baseParams).changes;
@@ -453,7 +453,7 @@ export function rebuildVectors(db) {
   if (!vocab) return { ok: false, reason: 'no observations to build vocabulary from' };
   const allObs = db.prepare(`
     SELECT id, title, narrative, concepts, lesson_learned, search_aliases FROM observations
-    WHERE COALESCE(compressed_into, 0) = 0 AND superseded_at IS NULL
+    WHERE ${liveObsFilterSql('')}
   `).all();
   let updated = 0;
   const insertStmt = db.prepare('INSERT OR REPLACE INTO observation_vectors (observation_id, vector, vocab_version, created_at_epoch) VALUES (?, ?, ?, ?)');

package/lib/recall-core.mjs

@@ -7,6 +7,7 @@
 
 import { basename } from 'path';
 import { notLowSignalTitleClause } from '../utils.mjs';
+import { liveObsFilterSql } from './inject-search-core.mjs';
 
 /**
  * Recall observations linked to a file (basename or full path). Returns
@@ -31,8 +32,7 @@ export function recallByFile(db, file, { limit = 10, includeNoise = false } = {}
                     o.created_at, o.created_at_epoch, o.project
     FROM observations o
     JOIN observation_files of2 ON of2.obs_id = o.id
-    WHERE COALESCE(o.compressed_into, 0) = 0
-      AND o.superseded_at IS NULL
+    WHERE ${liveObsFilterSql('o')}
       AND (of2.filename = ? OR of2.filename LIKE ? ESCAPE '\\')
       ${noiseClause}
     ORDER BY o.created_at_epoch DESC

package/lib/recent-core.mjs

@@ -14,6 +14,8 @@
 // MCP wants `project`) — same convention as recall-core, so neither surface needs
 // its own SELECT list.
 
+import { liveObsFilterSql } from './inject-search-core.mjs';
+
 const RECENT_COLS = 'id, type, title, subtitle, importance, project, created_at, created_at_epoch';
 
 // Upper bound on rows a single `recent` call may pull, shared so the cap can't
@@ -38,7 +40,7 @@ export const RECENT_MAX = 1000;
  */
 export function fetchRecent(db, { project = null, type = null, since = null, limit = 10 } = {}) {
   const params = [];
-  const wheres = ['COALESCE(compressed_into, 0) = 0', 'superseded_at IS NULL'];
+  const wheres = [liveObsFilterSql('')];
   if (project) { wheres.push('project = ?'); params.push(project); }
   if (type) { wheres.push('type = ?'); params.push(type); }
   if (Number.isFinite(since)) { wheres.push('created_at_epoch >= ?'); params.push(since); }

package/lib/search-core.mjs

@@ -29,6 +29,7 @@ import { cjkPrecisionOk, extractCjkLikePatterns } from '../nlp.mjs';
 import { computeTier } from '../tier.mjs';
 import { countSearchTotal, attachBodyTokens } from '../search-engine.mjs';
 import { notLowSignalTitleClause } from '../scoring-sql.mjs';
+import { liveObsFilterSql, recencyDecaySql } from './inject-search-core.mjs';
 
 /** Sanitize a user query to FTS5 syntax; optionally force OR semantics. */
 export function buildSearchFtsQuery(query, { or = false } = {}) {
@@ -146,7 +147,7 @@ export function searchSessionsFts(db, { ftsQuery, project = null, projectBoost =
   return db.prepare(`
     SELECT s.id, s.request, s.completed, s.project, s.created_at, s.created_at_epoch,
            ${SESS_BM25}
-             * (1.0 + EXP(-0.693 * MAX(0, ? - s.created_at_epoch) / ${DEFAULT_DECAY_HALF_LIFE_MS}.0))
+             * ${recencyDecaySql({ tsExpr: 's.created_at_epoch', halfLifeSql: `${DEFAULT_DECAY_HALF_LIFE_MS}.0` })}
              * (CASE WHEN ? IS NOT NULL AND s.project = ? THEN 2.0 ELSE 1.0 END) as score
     FROM session_summaries_fts
     JOIN session_summaries s ON session_summaries_fts.rowid = s.id
@@ -235,7 +236,7 @@ export function searchEventsFts(db, { ftsQuery, project = null, projectBoost = n
   return db.prepare(`
     SELECT e.id, e.event_type, e.title, e.body, e.project, e.importance, e.file_paths, e.created_at_epoch,
            ${EVT_BM25}
-             * (1.0 + EXP(-0.693 * MAX(0, ? - e.created_at_epoch) / ${DEFAULT_DECAY_HALF_LIFE_MS}.0))
+             * ${recencyDecaySql({ tsExpr: 'e.created_at_epoch', halfLifeSql: `${DEFAULT_DECAY_HALF_LIFE_MS}.0` })}
              * (CASE WHEN ? IS NOT NULL AND e.project = ? THEN 2.0 ELSE 1.0 END) as score
     FROM events_fts
     JOIN events e ON events_fts.rowid = e.id
@@ -607,7 +608,7 @@ export async function coreRunSearchPipeline(ctx, opts) {
 
   // ── Type-list fallback (MCP): obs_type set + 0 matches → list recent of that type ──
   if (obsTypeFallback && results.length === 0 && obsType) {
-    const typeWheres = ['COALESCE(compressed_into, 0) = 0', 'superseded_at IS NULL', 'type = ?'];
+    const typeWheres = [liveObsFilterSql(''), 'type = ?'];
     // Mirror the FTS path's low-signal filter (buildObsFtsQuery): this fallback is still a
     // SEARCH surface, so degraded titles ("Modified X", "Error: …") must not lead it —
     // acute for obs_type='change', the noise band. (The no-query recent-listing in

package/lib/stats-core.mjs

@@ -10,6 +10,7 @@ import { inferProject } from '../utils.mjs';
 import { buildNotLowSignalSql } from './low-signal-patterns.mjs';
 import { TIER_CASE_SQL, tierSqlParams } from '../tier.mjs';
 import { computeNoiseGauge } from './stats-quality.mjs';
+import { liveObsFilterSql } from './inject-search-core.mjs';
 
 /**
  * Compute the primary stats feed. Row shapes are returned exactly as the twin
@@ -98,7 +99,7 @@ export function computeStatsFeed(db, { project = null, days = 30, now = Date.now
   const tierDist = db.prepare(`
     SELECT tier, COUNT(*) as c FROM (
       SELECT ${TIER_CASE_SQL} as tier FROM observations
-      WHERE COALESCE(compressed_into, 0) = 0 AND superseded_at IS NULL ${projectFilter}
+      WHERE ${liveObsFilterSql('')} ${projectFilter}
     ) GROUP BY tier ORDER BY tier
   `).all(...tdParams, ...baseParams);
   const tierMap = Object.fromEntries(tierDist.map((r) => [r.tier, r.c]));

package/lib/timeline-core.mjs

@@ -14,6 +14,7 @@
 import { parseIdToken } from './id-routing.mjs';
 import { findFtsAnchor } from '../search-engine.mjs';
 import { sanitizeFtsQuery } from '../utils.mjs';
+import { liveObsFilterSql } from './inject-search-core.mjs';
 
 const TIMELINE_COLS = 'id, type, title, subtitle, project, created_at, created_at_epoch';
 
@@ -21,7 +22,7 @@ const TIMELINE_COLS = 'id, type, title, subtitle, project, created_at, created_a
 function nearestObservation(db, epoch, project) {
   return db.prepare(`
     SELECT id FROM observations
-    WHERE COALESCE(compressed_into, 0) = 0 AND superseded_at IS NULL ${project ? 'AND project = ?' : ''}
+    WHERE ${liveObsFilterSql('')} ${project ? 'AND project = ?' : ''}
     ORDER BY ABS(created_at_epoch - ?) ASC LIMIT 1
   `).get(...(project ? [project, epoch] : [epoch]));
 }
@@ -162,9 +163,9 @@ export function resolveQueryAnchor(db, queryStr, { project = null } = {}) {
 
 /** No-anchor fallback: most recent live (non-compressed, non-superseded) obs, newest first. */
 export function fetchRecentTimeline(db, { project = null, limit }) {
-  // superseded_at IS NULL mirrors the before/after window legs (fetchTimelineWindow) and
-  // every other read path — a superseded row must not lead the "most recent" timeline.
-  const liveFilter = 'COALESCE(compressed_into, 0) = 0 AND superseded_at IS NULL';
+  // A superseded row must not lead the "most recent" timeline — same live-row
+  // invariant as the before/after window legs (fetchTimelineWindow).
+  const liveFilter = liveObsFilterSql('');
   const where = project ? `WHERE ${liveFilter} AND project = ?` : `WHERE ${liveFilter}`;
   const params = project ? [project, limit] : [limit];
   return db.prepare(`
@@ -200,7 +201,7 @@ export function fetchTimelineWindow(db, anchorId, { before, after, project = nul
   const beforeRows = db.prepare(`
     SELECT ${TIMELINE_COLS}
     FROM observations
-    WHERE created_at_epoch < ? AND COALESCE(compressed_into, 0) = 0 AND superseded_at IS NULL ${projectFilter}
+    WHERE created_at_epoch < ? AND ${liveObsFilterSql('')} ${projectFilter}
     ORDER BY created_at_epoch DESC
     LIMIT ?
   `).all(anchorRow.created_at_epoch, ...baseParams, before).reverse();
@@ -208,7 +209,7 @@ export function fetchTimelineWindow(db, anchorId, { before, after, project = nul
   const afterRows = db.prepare(`
     SELECT ${TIMELINE_COLS}
     FROM observations
-    WHERE created_at_epoch > ? AND COALESCE(compressed_into, 0) = 0 AND superseded_at IS NULL ${projectFilter}
+    WHERE created_at_epoch > ? AND ${liveObsFilterSql('')} ${projectFilter}
     ORDER BY created_at_epoch ASC
     LIMIT ?
   `).all(anchorRow.created_at_epoch, ...baseParams, after);

package/mem-cli.mjs

@@ -32,6 +32,7 @@ import { optimizePreview, optimizeRun } from './hook-optimize.mjs';
 import { buildSessionContextLines } from './hook-context.mjs';
 import { cmdAdopt, cmdUnadopt } from './adopt-cli.mjs';
 import { parseIntFlag, isNumericToken } from './lib/cli-flags.mjs';
+import { liveObsFilterSql } from './lib/inject-search-core.mjs';
 import { auditMemdir, memdirPath } from './memdir.mjs';
 import { aggregateProjectCiteRecall } from './lib/citation-tracker.mjs';
 import { probeOtherSources as probeIdSources, bucketIdTokens, splitDeferredTokens } from './lib/id-routing.mjs';
@@ -1604,11 +1605,14 @@ function cmdExport(db, args) {
   if (rejectBareStringFlags(flags, ['project', 'type', 'from', 'to'])) return;
   const wheres = [];
   const params = [];
-  // --include-compressed: include compressed observations (aligned with MCP mem_export)
-  if (!(flags['include-compressed'] === true || flags['include-compressed'] === 'true')) {
-    wheres.push('COALESCE(compressed_into, 0) = 0');
+  // --include-compressed: include compressed observations (aligned with MCP mem_export).
+  // Superseded rows are excluded either way; the flag only toggles the compressed half
+  // of the live-row pair (backup/export of tombstones is opt-in, retractions are not).
+  if (flags['include-compressed'] === true || flags['include-compressed'] === 'true') {
+    wheres.push('superseded_at IS NULL');
+  } else {
+    wheres.push(liveObsFilterSql(''));
   }
-  wheres.push('superseded_at IS NULL');
 
   const project = flags.project ? resolveProject(db, flags.project) : null;
   if (project) { wheres.push('project = ?'); params.push(project); }
@@ -2468,8 +2472,7 @@ function cmdCitationStats(db, args) {
            SUM(CASE WHEN uncited_streak >= 2 THEN 1 ELSE 0 END) AS at_risk
       FROM observations
      WHERE created_at_epoch >= ?
-       AND COALESCE(compressed_into, 0) = 0
-       AND superseded_at IS NULL
+       AND ${liveObsFilterSql('')}
   GROUP BY project
   ORDER BY resolved DESC
   `).all(cutoff);
@@ -2478,8 +2481,7 @@ function cmdCitationStats(db, args) {
     SELECT id, project, type, title, importance, uncited_streak, cited_count
       FROM observations
      WHERE uncited_streak >= 2
-       AND COALESCE(compressed_into, 0) = 0
-       AND superseded_at IS NULL
+       AND ${liveObsFilterSql('')}
   ORDER BY uncited_streak DESC, importance ASC
      LIMIT 20
   `).all();
@@ -2488,8 +2490,7 @@ function cmdCitationStats(db, args) {
     SELECT id, project, type, title, importance, cited_count
       FROM observations
      WHERE importance >= 3 AND cited_count >= 1
-       AND COALESCE(compressed_into, 0) = 0
-       AND superseded_at IS NULL
+       AND ${liveObsFilterSql('')}
   ORDER BY cited_count DESC
      LIMIT 10
   `).all();
@@ -2499,8 +2500,7 @@ function cmdCitationStats(db, args) {
       FROM observations
      WHERE demoted_at IS NOT NULL
        AND demoted_at >= ?
-       AND COALESCE(compressed_into, 0) = 0
-       AND superseded_at IS NULL
+       AND ${liveObsFilterSql('')}
   ORDER BY demoted_at DESC
      LIMIT 10
   `).all(cutoff);
@@ -2515,8 +2515,7 @@ function cmdCitationStats(db, args) {
   const pollutedRows = db.prepare(`
     SELECT COUNT(*) AS n FROM observations
      WHERE cited_count > decay_seen_count
-       AND COALESCE(compressed_into, 0) = 0
-       AND superseded_at IS NULL
+       AND ${liveObsFilterSql('')}
   `).get();
   const dataPollutionNote = pollutedRows.n > 0
     ? `${pollutedRows.n} obs have cited_count > decay_seen_count (pre-v34 backfill — invariant holds for new data).`

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "claude-mem-lite",
-  "version": "3.64.0",
+  "version": "3.65.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "claude-mem-lite",
-      "version": "3.64.0",
+      "version": "3.65.0",
       "dependencies": {
         "@modelcontextprotocol/sdk": "^1.26.0",
         "better-sqlite3": "^12.6.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem-lite",
-  "version": "3.64.0",
+  "version": "3.65.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/search-scoring.mjs

@@ -9,6 +9,7 @@ import { debugCatch, COMPRESSED_AUTO, COMPRESSED_PENDING_PURGE, OBS_BM25 } from
 import { BASE_STOP_WORDS } from './stop-words.mjs';
 import { porterStem } from './tfidf.mjs';
 import { CLI_INVOKE } from './cli-path.mjs';
+import { liveObsFilterSql } from './lib/inject-search-core.mjs';
 
 // ─── MCP Server Instructions Builder ───────────────────────────────────────
 // Phase A (v2.31.3+): when quiet=true, drops WHEN-TO-USE proactive-trigger and
@@ -225,8 +226,7 @@ export function expandQueryByConcepts(db, ftsQuery, project) {
     rows = db.prepare(`
       SELECT o.concepts FROM observations_fts
       JOIN observations o ON observations_fts.rowid = o.id
-      WHERE observations_fts MATCH ? AND COALESCE(o.compressed_into, 0) = 0
-        AND o.superseded_at IS NULL
+      WHERE observations_fts MATCH ? AND ${liveObsFilterSql('o')}
         AND (? IS NULL OR o.project = ?)
       ORDER BY ${OBS_BM25}
       LIMIT 20

package/tfidf.mjs

@@ -7,6 +7,7 @@ import { cjkBigrams } from './utils.mjs';
 import { BASE_STOP_WORDS } from './stop-words.mjs';
 import { createHash } from 'crypto';
 import { rrfAccumulate } from './lib/rrf.mjs';
+import { liveObsFilterSql } from './lib/inject-search-core.mjs';
 
 export const VOCAB_DIM = 512;
 // Fraction of the vocab dimension reserved for the highest-IDF (rarest) terms when the
@@ -240,7 +241,7 @@ export function vecTextForRow(row) {
 export function buildVocabulary(db, { dim = VOCAB_DIM } = {}) {
   const rows = db.prepare(`
     SELECT title, narrative, concepts, lesson_learned, search_aliases FROM observations
-    WHERE COALESCE(compressed_into, 0) = 0 AND superseded_at IS NULL
+    WHERE ${liveObsFilterSql('')}
   `).all();
 
   const N = rows.length;
@@ -444,8 +445,7 @@ export function vectorSearch(db, queryVec, { project, type, vocabVersion, limit
   const now = Date.now();
 
   const wheres = [
-    'COALESCE(o.compressed_into, 0) = 0',
-    'o.superseded_at IS NULL',
+    liveObsFilterSql('o'),
     'ov.vocab_version = ?',
   ];
   const params = [vocabVersion];