claude-mem-lite 2.5.4 → 2.9.2

package/hook-context.mjs

@@ -58,7 +58,7 @@ export function selectWithTokenBudget(db, project, budget = 2000) {
 
   // Candidate pool: tiered time windows by importance (adaptive)
   const obsPool = db.prepare(`
-    SELECT id, type, title, narrative, importance, created_at_epoch, files_modified
+    SELECT id, type, title, narrative, importance, created_at_epoch, files_modified, lesson_learned
     FROM observations
     WHERE project = ? AND COALESCE(compressed_into, 0) = 0
       AND (
@@ -87,7 +87,8 @@ export function selectWithTokenBudget(db, project, budget = 2000) {
     const ageDays = (now_ms - o.created_at_epoch) / 86400000;
     const recency = 1 / (1 + ageDays);
     const impBoost = 0.5 + 0.5 * (o.importance || 1);
-    const value = recency * impBoost;
+    const lessonBoost = o.lesson_learned ? 1.3 : 1.0;
+    const value = recency * impBoost * lessonBoost;
     const cost = estimateTokens((o.title || '') + (o.narrative || ''));
     return { ...o, value, cost, valueDensity: cost > 0 ? value / Math.sqrt(cost) : 0 };
   });
@@ -107,10 +108,17 @@ export function selectWithTokenBudget(db, project, budget = 2000) {
   ].sort((a, b) => b.valueDensity - a.valueDensity);
 
   const selectedFiles = new Set();
+  const selectedTypes = new Map(); // type → count for diversity constraint
 
   for (const c of allCandidates) {
     if (totalTokens + c.cost > budget) continue;
 
+    // Type diversity: max 3 observations of same type (checked first to avoid file set pollution)
+    if (c._kind === 'obs' && c.type) {
+      const typeCount = selectedTypes.get(c.type) || 0;
+      if (typeCount >= 3) continue;
+    }
+
     // Diversity penalty: reduce value for file overlap with already-selected
     if (c._kind === 'obs' && c.files_modified) {
       let cFiles;
@@ -119,11 +127,16 @@ export function selectWithTokenBudget(db, project, budget = 2000) {
         const overlap = cFiles.filter(f => selectedFiles.has(f)).length;
         const overlapRatio = overlap / cFiles.length;
         const penalizedValue = c.valueDensity * (1 - 0.3 * overlapRatio);
-        if (penalizedValue < 0.001) continue; // Skip if too redundant
+        if (penalizedValue < 0.001) continue;
       }
       for (const f of cFiles) selectedFiles.add(f);
     }
 
+    // Commit type diversity counter after both gates pass
+    if (c._kind === 'obs' && c.type) {
+      selectedTypes.set(c.type, (selectedTypes.get(c.type) || 0) + 1);
+    }
+
     totalTokens += c.cost;
     if (c._kind === 'obs') {
       selectedObs.push({ id: c.id, type: c.type, title: c.title, created_at: new Date(c.created_at_epoch).toISOString() });
@@ -151,11 +164,16 @@ export function updateClaudeMd(contextBlock) {
   const hintComment = '<!-- claude-mem-lite: auto-updated context. To avoid git noise, add CLAUDE.md to .gitignore -->';
   const newSection = `${startTag}\n${contextBlock}\n${endTag}`;
 
-  const startIdx = content.indexOf(startTag);
-  const endIdx = content.indexOf(endTag);
+  // Use lastIndexOf for both tags — prevents matching documentation references
+  // to <claude-mem-context> that appear in code/markdown before the actual context block
+  const startIdx = content.lastIndexOf(startTag);
+  const endIdx = content.lastIndexOf(endTag);
 
   if (startIdx !== -1 && endIdx !== -1 && startIdx < endIdx) {
-    // Replace existing section in-place — preserves surrounding content (including hint if present)
+    // Skip write if content is unchanged — reduces git noise
+    const existingSection = content.slice(startIdx, endIdx + endTag.length);
+    if (existingSection === newSection) return;
+    // Replace from first start to last end — collapses any duplicate sections into one
     content = content.slice(0, startIdx) + newSection + content.slice(endIdx + endTag.length);
   } else if (content.length > 0) {
     // Append to end — never disturb existing CLAUDE.md structure

package/hook-episode.mjs

@@ -211,7 +211,7 @@ export function mergePendingEntries(episode) {
 /**
  * Check if an episode has significant content worth processing with LLM.
  * Significant = contains file edits, Bash errors, or a review/research pattern
- * (5+ Read/Grep entries indicate investigation worth recording).
+ * (8+ Read/Grep entries indicate investigation worth recording).
  * @param {object} episode The episode to check
  * @returns {boolean} true if the episode has significant content
  */
@@ -236,5 +236,5 @@ export function episodeHasSignificantContent(episode) {
   const readCount = episode.entries.filter(e =>
     e.tool === 'Read' || e.tool === 'Grep'
   ).length;
-  return readCount >= 5;
+  return readCount >= 8;
 }

package/hook-handoff.mjs

@@ -25,7 +25,14 @@ export function buildAndSaveHandoff(db, sessionId, project, type, episodeSnapsho
   `).all(sessionId);
   if (prompts.length === 0) return;  // Empty session — nothing to hand off
 
-  const workingOn = prompts.map(p => truncate(p.prompt_text, 200)).join(' → ');
+  const seen = new Set();
+  const uniquePrompts = prompts.filter(p => {
+    const t = truncate(p.prompt_text, 200);
+    if (seen.has(t)) return false;
+    seen.add(t);
+    return true;
+  });
+  const workingOn = uniquePrompts.map(p => truncate(p.prompt_text, 200)).join(' → ');
 
   // 2. Completed — from observations (include narrative for richer handoff)
   const completed = db.prepare(`
@@ -37,45 +44,47 @@ export function buildAndSaveHandoff(db, sessionId, project, type, episodeSnapsho
   // 3. Unfinished — episode snapshot + full session edit history from narratives
   let unfinished = '';
   if (episodeSnapshot?.entries) {
+    const seenDescs = new Set();
     const pendingDescs = episodeSnapshot.entries
       .filter(e => e.isSignificant || e.isError)
-      .map(e => e.desc);
+      .map(e => e.desc)
+      .filter(d => { if (seenDescs.has(d)) return false; seenDescs.add(d); return true; });
     if (pendingDescs.length > 0) unfinished = pendingDescs.join('; ');
   }
-  // Only the most recent bugfix is an "unfinished" signal (earlier ones are likely resolved)
-  if (!unfinished) {
-    const lastBugfix = completed.find(o => o.type === 'bugfix');
-    if (lastBugfix) unfinished = lastBugfix.title;
-  }
   // Enrich unfinished with full session edit history from observation narratives.
   // Since handoff is UPSERT (max 2 rows per project), storing more data is free.
+  // Always use \n---\n separator so extractUnfinishedSummary can distinguish
+  // pending work (before separator) from narrative history (after separator).
   const narratives = completed
     .filter(c => c.narrative)
     .map(c => c.narrative);
   if (narratives.length > 0) {
     const editHistory = narratives.join('\n');
-    unfinished = [unfinished, editHistory].filter(Boolean).join('\n---\n');
+    unfinished += '\n---\n' + editHistory;
   }
 
   // 4. Key files — from episode snapshot + observations
   const fileSet = new Set();
-  if (episodeSnapshot?.files) episodeSnapshot.files.forEach(f => fileSet.add(f));
+  const isValidFile = f => f && f.length > 2 && f.includes('/') && f.indexOf('/', 1) !== -1
+    && !f.startsWith('/dev/') && !f.startsWith('/proc/') && !f.startsWith('/tmp/');
+  if (episodeSnapshot?.files) episodeSnapshot.files.filter(isValidFile).forEach(f => fileSet.add(f));
   const obsFiles = db.prepare(`
     SELECT files_modified FROM observations
     WHERE memory_session_id = ? AND files_modified IS NOT NULL
     ORDER BY created_at_epoch DESC LIMIT 10
   `).all(sessionId);
   for (const row of obsFiles) {
-    try { JSON.parse(row.files_modified).forEach(f => fileSet.add(f)); } catch {}
+    try { JSON.parse(row.files_modified).filter(isValidFile).forEach(f => fileSet.add(f)); } catch {}
   }
 
-  // 5. Key decisions — high importance observations
+  // 5. Key decisions — high importance observations (skip low-signal degraded titles)
+  const LOW_SIGNAL_TITLE = /^(Error (while working|in)|Modified |Worked on |Reviewed \d+ files:)/;
   const decisions = db.prepare(`
     SELECT title FROM observations
     WHERE memory_session_id = ? AND COALESCE(importance, 1) >= 2
       AND COALESCE(compressed_into, 0) = 0
-    ORDER BY created_at_epoch DESC LIMIT 5
-  `).all(sessionId);
+    ORDER BY created_at_epoch DESC LIMIT 10
+  `).all(sessionId).filter(d => d.title && !LOW_SIGNAL_TITLE.test(d.title)).slice(0, 5);
 
   // 6. Match keywords
   const allText = [workingOn, ...completed.map(c => c.title).filter(Boolean), unfinished].join(' ');
@@ -98,7 +107,7 @@ export function buildAndSaveHandoff(db, sessionId, project, type, episodeSnapsho
     project, type, sessionId,
     truncate(workingOn, 1000),
     completed.map(c => `[${c.type}] ${c.title}`).join('\n'),
-    truncate(unfinished, 3000),
+    unfinished.length > 3000 ? unfinished.slice(0, 2999) + '…' : unfinished,
     JSON.stringify([...fileSet].slice(0, 20)),
     decisions.map(d => d.title).join('\n'),
     keywords,
@@ -116,12 +125,19 @@ export function buildAndSaveHandoff(db, sessionId, project, type, episodeSnapsho
  * @returns {boolean}
  */
 export function detectContinuationIntent(db, promptText, project) {
-  // Stage 0: Non-expired 'clear' handoff = always continue (/clear means user is resuming)
+  // Stage 0: Non-expired 'clear' handoff — assume continuation unless long unrelated prompt
   const clearHandoff = db.prepare(`
-    SELECT created_at_epoch FROM session_handoffs WHERE project = ? AND type = 'clear'
+    SELECT created_at_epoch, match_keywords FROM session_handoffs WHERE project = ? AND type = 'clear'
   `).get(project);
   if (clearHandoff && (Date.now() - clearHandoff.created_at_epoch <= HANDOFF_EXPIRY_CLEAR)) {
-    return true;
+    // Short/ambiguous prompts: assume continuation (user may say "ok", "start", etc.)
+    if (promptText.length < 40) return true;
+    // Long prompts: check keyword overlap to confirm same-task intent
+    if (!clearHandoff.match_keywords) return true; // no keywords stored, can't verify
+    const clearPromptTokens = tokenizeHandoff(promptText);
+    const clearHandoffTokens = new Set(tokenizeHandoff(clearHandoff.match_keywords));
+    if (clearPromptTokens.some(t => clearHandoffTokens.has(t))) return true;
+    // Long prompt with zero keyword overlap → likely new task, fall through
   }
 
   // Stage 1: Explicit keyword match — always works, even without handoff
@@ -195,7 +211,11 @@ export function renderHandoffInjection(db, project) {
     lines.push('## Completed', ...handoff.completed.split('\n').map(l => `- ${l}`), '');
   }
   if (handoff.unfinished) {
-    lines.push('## Unfinished', ...handoff.unfinished.split('; ').map(l => `- ${l}`), '');
+    // Extract only the pending-work portion (before narrative history separator)
+    const pending = extractUnfinishedSummary(handoff.unfinished);
+    if (pending) {
+      lines.push('## Unfinished', ...pending.split('; ').map(l => `- ${l}`), '');
+    }
   }
   if (handoff.key_files) {
     try {

package/hook-llm.mjs

@@ -39,7 +39,7 @@ export function saveObservation(obs, projectOverride, sessionIdOverride, externa
       VALUES (?, ?, ?, ?, ?, 'active')
     `).run(sessionId, sessionId, project, now.toISOString(), now.getTime());
 
-    // Two-tier dedup
+    // Three-tier dedup
     // Tier 1 (fast): 5-min Jaccard on titles
     const fiveMinAgo = now.getTime() - DEDUP_WINDOW_MS;
     const recent = db.prepare(`
@@ -52,6 +52,21 @@ export function saveObservation(obs, projectOverride, sessionIdOverride, externa
       return null;
     }
 
+    // Tier 1.5: Extended title dedup for low-signal degraded titles (1-day window)
+    // "Error in X", "Modified X" titles are low-specificity → use longer dedup window
+    const LOW_SIGNAL = /^(Error (while working|in)|Modified |Worked on |Reviewed \d+ files:)/;
+    if (obs.title && LOW_SIGNAL.test(obs.title)) {
+      const oneDayAgo = now.getTime() - 86400000;
+      const extRecent = db.prepare(`
+        SELECT title FROM observations
+        WHERE project = ? AND created_at_epoch > ? AND created_at_epoch <= ?
+        ORDER BY created_at_epoch DESC LIMIT 30
+      `).all(project, oneDayAgo, fiveMinAgo);
+      if (extRecent.some(r => jaccardSimilarity(r.title, obs.title) > 0.85)) {
+        return null;
+      }
+    }
+
     // Tier 2 (slow): MinHash cross-session dedup (7-day window)
     const minhashSig = computeMinHash((obs.title || '') + ' ' + (obs.narrative || ''));
     if (minhashSig) {
@@ -174,10 +189,31 @@ export function buildDegradedTitle(episode) {
   const hasError = episode.entries.some(e => e.isError);
   const hasEdit = episode.entries.some(e => EDIT_TOOLS.has(e.tool));
 
+  // Extract a short error hint from the first error entry's desc
+  let errorHint = '';
+  if (hasError) {
+    const errEntry = episode.entries.find(e => e.isError);
+    if (errEntry?.desc) {
+      // Extract meaningful error text from "cmd → ERROR: ..." format
+      const errMatch = errEntry.desc.match(/→ ERROR: (.{3,80})/);
+      if (errMatch) {
+        // Clean JSON/noise from the error snippet
+        const cleaned = errMatch[1].replace(/[{"[\]]/g, '').replace(/\\n/g, ' ').trim();
+        if (cleaned.length >= 4) errorHint = `: ${truncate(cleaned, 50)}`;
+      }
+    }
+  }
+
   if (files.length > 0) {
     const names = files.map(f => basename(f)).slice(0, 3).join(', ');
     const suffix = files.length > 3 ? ` +${files.length - 3} more` : '';
-    if (hasError) return `Error while working on ${names}${suffix}`;
+    if (hasError) {
+      // Include the triggering command for richer context: "Error: dispatch.mjs — npm test failed"
+      const errEntry = episode.entries.find(e => e.isError);
+      const cmd = errEntry?.desc?.match(/^(.{3,30}?) →/)?.[1]?.trim();
+      const cmdHint = cmd ? ` — ${cmd}` : '';
+      return `Error: ${names}${suffix}${errorHint || cmdHint}`;
+    }
     if (hasEdit) return `Modified ${names}${suffix}`;
     return `Worked on ${names}${suffix}`;
   }
@@ -214,6 +250,20 @@ export function buildImmediateObservation(episode) {
     title = truncate(buildDegradedTitle(episode), 120);
   }
 
+  const ruleImportance = computeRuleImportance(episode);
+  // Low-signal degraded titles ("Error in...", "Modified...") should not inflate importance.
+  // Cap at 1 unless rule-based signals indicate genuine importance (error-in-test → 3, config → 2).
+  const LOW_SIGNAL = /^(Error (while working|in)|Modified |Worked on |Reviewed \d+ files:)/;
+  const isLowSignal = LOW_SIGNAL.test(title);
+  let importance;
+  if (isReviewPattern) {
+    importance = Math.max(2, ruleImportance);
+  } else if (isLowSignal && ruleImportance <= 2) {
+    importance = 1; // Degraded titles stay low unless rule signals critical (imp=3)
+  } else {
+    importance = ruleImportance;
+  }
+
   return {
     type: inferredType,
     title,
@@ -223,7 +273,7 @@ export function buildImmediateObservation(episode) {
     facts: [],
     files: episode.files,
     filesRead: episode.filesRead || [],
-    importance: isReviewPattern ? Math.max(2, computeRuleImportance(episode)) : computeRuleImportance(episode),
+    importance,
   };
 }
 
@@ -268,10 +318,10 @@ File: ${episode.files.join(', ') || 'unknown'}
 Action: ${e.desc}
 Error: ${e.isError ? 'yes' : 'no'}
 
-JSON: {"type":"decision|bugfix|feature|refactor|discovery|change","title":"concise ≤80 char description","narrative":"what changed, why, and outcome (2-3 sentences)","concepts":["kw1","kw2"],"facts":["fact1","fact2"],"importance":1,"lesson_learned":"non-obvious insight or null if routine","search_aliases":["alt query 1","alt query 2"]}
+JSON: {"type":"decision|bugfix|feature|refactor|discovery|change","title":"concise ≤80 char description","narrative":"what changed, why, and outcome (2-3 sentences)","concepts":["kw1","kw2"],"facts":["fact1","fact2"],"importance":1,"lesson_learned":"non-obvious insight or 'none' if routine","search_aliases":["alt query 1","alt query 2"]}
 Facts: each MUST be (1) atomic—one claim, (2) self-contained—no pronouns, include file/function name, (3) specific—"refreshToken() in auth.ts:45 uses 1h TTL" not "handles tokens"
-importance: 0=not worth saving (pure browsing, trivial query, no learning value), 1=routine, 2=notable (error fix, arch decision, config change), 3=critical (breaking change, security fix, data migration)
-lesson_learned: If this episode revealed something NON-OBVIOUS (a debugging insight, a gotcha, a design reason), capture it as a reusable lesson. null if routine.
+importance: Be strict — default to 1. 0=pure browsing with zero learning value. 1=routine file edits, standard changes, normal workflow (MOST episodes). 2=notable ONLY if it reveals something non-obvious: error fix with discovered root cause, architectural decision with explicit tradeoff, config change with unexpected side effects. 3=critical: breaking change affecting users, security vulnerability fix, data migration. Ask yourself: "would a future session benefit from knowing this?" — if not, it's importance=1.
+lesson_learned: REQUIRED field. State what was learned that isn't obvious from reading the code. Examples: "FTS5 porter stemmer doesn't tokenize CJK — need bigram workaround", "vitest --reporter=verbose hangs on large test suites, use default reporter". If purely routine with nothing learned, write "none" (not null).
 search_aliases: 2-6 alternative search terms someone might use to find this memory later (include CJK if project uses Chinese)`;
   } else {
     const actionList = episode.entries.map((e, i) =>
@@ -285,10 +335,10 @@ Files: ${fileList}
 Actions (${episode.entries.length} total):
 ${actionList}
 
-JSON: {"type":"decision|bugfix|feature|refactor|discovery|change","title":"coherent ≤80 char summary","narrative":"what was done, why, and outcome (3-5 sentences)","concepts":["keyword1","keyword2"],"facts":["specific fact 1","specific fact 2"],"importance":1,"lesson_learned":"non-obvious insight or null if routine","search_aliases":["alt query 1","alt query 2"]}
+JSON: {"type":"decision|bugfix|feature|refactor|discovery|change","title":"coherent ≤80 char summary","narrative":"what was done, why, and outcome (3-5 sentences)","concepts":["keyword1","keyword2"],"facts":["specific fact 1","specific fact 2"],"importance":1,"lesson_learned":"non-obvious insight or 'none' if routine","search_aliases":["alt query 1","alt query 2"]}
 Facts: each MUST be (1) atomic—one claim, (2) self-contained—no pronouns, include file/function name, (3) specific—"refreshToken() in auth.ts:45 uses 1h TTL" not "handles tokens"
-importance: 0=not worth saving (pure browsing, trivial query, no learning value), 1=routine, 2=notable (error fix, arch decision, config change), 3=critical (breaking change, security fix, data migration)
-lesson_learned: If this episode revealed something NON-OBVIOUS (a debugging insight, a gotcha, a design reason), capture it as a reusable lesson. null if routine.
+importance: Be strict — default to 1. 0=pure browsing with zero learning value. 1=routine file edits, standard changes, normal workflow (MOST episodes). 2=notable ONLY if it reveals something non-obvious: error fix with discovered root cause, architectural decision with explicit tradeoff, config change with unexpected side effects. 3=critical: breaking change affecting users, security vulnerability fix, data migration. Ask yourself: "would a future session benefit from knowing this?" — if not, it's importance=1.
+lesson_learned: REQUIRED field. State what was learned that isn't obvious from reading the code. Examples: "FTS5 porter stemmer doesn't tokenize CJK — need bigram workaround", "vitest --reporter=verbose hangs on large test suites, use default reporter". If purely routine with nothing learned, write "none" (not null).
 search_aliases: 2-6 alternative search terms someone might use to find this memory later (include CJK if project uses Chinese)`;
   }
 
@@ -323,7 +373,10 @@ search_aliases: 2-6 alternative search terms someone might use to find this memo
         return;
       }
 
-      const lessonLearned = typeof parsed.lesson_learned === 'string' ? parsed.lesson_learned.slice(0, 500) : null;
+      const lessonLearned = typeof parsed.lesson_learned === 'string'
+        && parsed.lesson_learned.toLowerCase() !== 'none'
+        && parsed.lesson_learned.trim().length > 0
+        ? parsed.lesson_learned.slice(0, 500) : null;
       const searchAliases = Array.isArray(parsed.search_aliases)
         ? parsed.search_aliases.slice(0, 6).join(' ')
         : null;
@@ -471,17 +524,41 @@ key_decisions: Only decisions with lasting impact (library choices, architecture
         ? JSON.stringify(llmParsed.lessons) : null;
       const decisionsJson = Array.isArray(llmParsed.key_decisions) && llmParsed.key_decisions.length > 0
         ? JSON.stringify(llmParsed.key_decisions) : null;
-      db.prepare(`
-        INSERT INTO session_summaries (memory_session_id, project, request, investigated, learned, completed, next_steps, remaining_items, files_read, files_edited, notes, lessons, key_decisions, created_at, created_at_epoch)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, '[]', '[]', '', ?, ?, ?, ?)
-      `).run(
-        sessionId, project,
-        llmParsed.request || '', llmParsed.investigated || '', llmParsed.learned || '',
-        llmParsed.completed || '', llmParsed.next_steps || '',
-        llmParsed.remaining_items || '',
-        lessonsJson, decisionsJson,
-        now.toISOString(), now.getTime()
-      );
+
+      // Upgrade existing fast summary instead of creating a duplicate
+      const existingFast = db.prepare(`
+        SELECT id FROM session_summaries
+        WHERE memory_session_id = ? AND notes = 'fast'
+        LIMIT 1
+      `).get(sessionId);
+
+      if (existingFast) {
+        db.prepare(`
+          UPDATE session_summaries
+          SET request=?, investigated=?, learned=?, completed=?, next_steps=?, remaining_items=?,
+              lessons=?, key_decisions=?, notes='llm', created_at=?, created_at_epoch=?
+          WHERE id = ?
+        `).run(
+          llmParsed.request || '', llmParsed.investigated || '', llmParsed.learned || '',
+          llmParsed.completed || '', llmParsed.next_steps || '',
+          llmParsed.remaining_items || '',
+          lessonsJson, decisionsJson,
+          now.toISOString(), now.getTime(),
+          existingFast.id
+        );
+      } else {
+        db.prepare(`
+          INSERT INTO session_summaries (memory_session_id, project, request, investigated, learned, completed, next_steps, remaining_items, files_read, files_edited, notes, lessons, key_decisions, created_at, created_at_epoch)
+          VALUES (?, ?, ?, ?, ?, ?, ?, ?, '[]', '[]', '', ?, ?, ?, ?)
+        `).run(
+          sessionId, project,
+          llmParsed.request || '', llmParsed.investigated || '', llmParsed.learned || '',
+          llmParsed.completed || '', llmParsed.next_steps || '',
+          llmParsed.remaining_items || '',
+          lessonsJson, decisionsJson,
+          now.toISOString(), now.getTime()
+        );
+      }
     }
   } finally {
     db.close();

package/hook-memory.mjs

@@ -4,7 +4,7 @@
 import { sanitizeFtsQuery, debugCatch } from './utils.mjs';
 
 const MAX_MEMORY_INJECTIONS = 3;
-const MEMORY_LOOKBACK_MS = 30 * 86400000; // 30 days
+const MEMORY_LOOKBACK_MS = 60 * 86400000; // 60 days
 const MEMORY_TYPE_BOOST = { bugfix: 1.5, decision: 1.3, discovery: 1.0, feature: 0.8, change: 0.5, refactor: 0.5 };
 
 const FILE_RECALL_LOOKBACK_MS = 60 * 86400000; // 60 days
@@ -12,7 +12,7 @@ const MAX_FILE_RECALL = 2;
 
 /**
  * Search for relevant past observations to inject as memory context.
- * Strict quality gates: importance>=2, type-boosted, lesson-boosted, BM25-thresholded.
+ * Quality gates: importance>=1 (with 0.6x penalty), type-boosted, lesson-boosted, BM25-thresholded (>=1.5).
  * @param {import('better-sqlite3').Database} db Memory database
  * @param {string} userPrompt User's prompt text
  * @param {string} project Current project
@@ -29,14 +29,15 @@ export function searchRelevantMemories(db, userPrompt, project, excludeIds = [])
     const cutoff = Date.now() - MEMORY_LOOKBACK_MS;
     const excludeSet = new Set(excludeIds);
 
+    // Phase 1: Same-project search (highest priority)
     const selectStmt = db.prepare(`
-      SELECT o.id, o.type, o.title, o.importance, o.lesson_learned,
+      SELECT o.id, o.type, o.title, o.importance, o.lesson_learned, o.project,
              bm25(observations_fts, 10, 5, 5, 3, 3, 2) as relevance
       FROM observations_fts
       JOIN observations o ON o.id = observations_fts.rowid
       WHERE observations_fts MATCH ?
         AND o.project = ?
-        AND o.importance >= 2
+        AND o.importance >= 1
         AND o.created_at_epoch > ?
         AND COALESCE(o.compressed_into, 0) = 0
       ORDER BY bm25(observations_fts, 10, 5, 5, 3, 3, 2)
@@ -44,17 +45,45 @@ export function searchRelevantMemories(db, userPrompt, project, excludeIds = [])
     `);
     const rows = selectStmt.all(ftsQuery, project, cutoff);
 
-    // Score: BM25 × type boost × lesson boost, filter by threshold, exclude Key Context IDs
-    const scored = rows
+    // Phase 2: Cross-project search for high-value decisions/discoveries
+    // These are transferable insights (debugging patterns, architectural reasons, gotchas)
+    let crossRows = [];
+    try {
+      crossRows = db.prepare(`
+        SELECT o.id, o.type, o.title, o.importance, o.lesson_learned, o.project,
+               bm25(observations_fts, 10, 5, 5, 3, 3, 2) as relevance
+        FROM observations_fts
+        JOIN observations o ON o.id = observations_fts.rowid
+        WHERE observations_fts MATCH ?
+          AND o.project != ?
+          AND o.type IN ('decision', 'discovery')
+          AND o.importance >= 2
+          AND o.created_at_epoch > ?
+          AND COALESCE(o.compressed_into, 0) = 0
+        ORDER BY bm25(observations_fts, 10, 5, 5, 3, 3, 2)
+        LIMIT 5
+      `).all(ftsQuery, project, cutoff);
+    } catch (e) { debugCatch(e, 'crossProjectSearch'); }
+
+    // Merge and score: same-project full weight, cross-project 0.7x
+    const allRows = [...rows, ...crossRows];
+    const scored = allRows
       .filter(r => !excludeSet.has(r.id))
-      .map(r => ({
-        ...r,
-        score: Math.abs(r.relevance) * (MEMORY_TYPE_BOOST[r.type] || 1.0) * (r.lesson_learned ? 1.5 : 1.0),
-      }))
+      .map(r => {
+        const crossProjectPenalty = r.project === project ? 1.0 : 0.7;
+        return {
+          ...r,
+          score: Math.abs(r.relevance)
+            * (MEMORY_TYPE_BOOST[r.type] || 1.0)
+            * (r.lesson_learned ? 1.5 : 1.0)
+            * (r.importance >= 2 ? 1.0 : 0.6)
+            * crossProjectPenalty,
+        };
+      })
       .sort((a, b) => b.score - a.score);
 
-    // Strict threshold: only inject if best match has meaningful score
-    if (scored.length === 0 || scored[0].score < 1.0) return [];
+    // Strict threshold: raised from 1.0 to 1.5 to compensate for wider pool
+    if (scored.length === 0 || scored[0].score < 1.5) return [];
 
     // Update access_count for injected memories
     const result = scored.slice(0, MAX_MEMORY_INJECTIONS);
@@ -83,7 +112,10 @@ export function recallForFile(db, filePath, project) {
   try {
     const basename = filePath.split('/').pop();
     const cutoff = Date.now() - FILE_RECALL_LOOKBACK_MS;
-    const likePattern = `%"${basename}"%`;
+    // Match both full paths (/path/to/file.mjs) and basename-only entries ("file.mjs")
+    // Two patterns avoid false positives: %/file.mjs"% won't match /webapp.mjs
+    const pathPattern = `%/${basename}"%`;
+    const namePattern = `%"${basename}"%`;
     const rows = db.prepare(`
       SELECT id, type, title, importance, lesson_learned
       FROM observations
@@ -91,10 +123,10 @@ export function recallForFile(db, filePath, project) {
         AND importance >= 2
         AND COALESCE(compressed_into, 0) = 0
         AND created_at_epoch > ?
-        AND files_modified LIKE ?
+        AND (files_modified LIKE ? OR files_modified LIKE ?)
       ORDER BY created_at_epoch DESC
       LIMIT ?
-    `).all(project, cutoff, likePattern, MAX_FILE_RECALL);
+    `).all(project, cutoff, pathPattern, namePattern, MAX_FILE_RECALL);
     const updateStmt = db.prepare('UPDATE observations SET access_count = COALESCE(access_count, 0) + 1 WHERE id = ?');
     for (const r of rows) updateStmt.run(r.id);
     return rows;

package/hook-shared.mjs

@@ -140,6 +140,27 @@ export function incrementInjection() { _injectionCount++; }
 export function resetInjectionBudget() { _injectionCount = 0; }
 export function hasInjectionBudget() { return _injectionCount < MAX_INJECTIONS_PER_SESSION; }
 
+// ─── Previous Session Context (for user-prompt dispatch enrichment) ──────────
+// Session-start caches next_steps; first user-prompt reads+clears for richer dispatch.
+
+export function prevContextFile() {
+  return join(RUNTIME_DIR, `prev-context-${inferProject()}`);
+}
+
+export function cachePrevContext(nextSteps) {
+  try { writeFileSync(prevContextFile(), JSON.stringify({ nextSteps, ts: Date.now() })); } catch {}
+}
+
+export function readAndClearPrevContext() {
+  const file = prevContextFile();
+  try {
+    const data = JSON.parse(readFileSync(file, 'utf8'));
+    try { unlinkSync(file); } catch {}
+    if (Date.now() - data.ts > 12 * 3600000) return null; // 12h expiry
+    return data.nextSteps || null;
+  } catch { return null; }
+}
+
 // ─── Tool Event Tracking (for dispatch feedback) ────────────────────────────
 // PostToolUse appends feedback-relevant tool events (Skill, Task, Edit, Write, Bash errors).
 // Stop handler reads them and passes to collectFeedback for adoption/outcome detection.