engrm 0.4.8 → 0.4.10

package/dist/hooks/post-tool-use.js

@@ -863,6 +863,11 @@ import { createHash as createHash2 } from "node:crypto";
 var IS_BUN = typeof globalThis.Bun !== "undefined";
 function openDatabase(dbPath) {
   if (IS_BUN) {
+    if (process.platform === "darwin") {
+      try {
+        return openNodeDatabase(dbPath);
+      } catch {}
+    }
     return openBunDatabase(dbPath);
   }
   return openNodeDatabase(dbPath);
@@ -979,6 +984,15 @@ class MemDatabase {
     }
     return row;
   }
+  reassignObservationProject(observationId, projectId) {
+    const existing = this.getObservationById(observationId);
+    if (!existing)
+      return false;
+    if (existing.project_id === projectId)
+      return true;
+    this.db.query("UPDATE observations SET project_id = ? WHERE id = ?").run(projectId, observationId);
+    return true;
+  }
   getObservationById(id) {
     return this.db.query("SELECT * FROM observations WHERE id = ?").get(id) ?? null;
   }
@@ -1112,8 +1126,13 @@ class MemDatabase {
   }
   upsertSession(sessionId, projectId, userId, deviceId, agent = "claude-code") {
     const existing = this.db.query("SELECT * FROM sessions WHERE session_id = ?").get(sessionId);
-    if (existing)
+    if (existing) {
+      if (existing.project_id === null && projectId !== null) {
+        this.db.query("UPDATE sessions SET project_id = ? WHERE session_id = ?").run(projectId, sessionId);
+        return this.db.query("SELECT * FROM sessions WHERE session_id = ?").get(sessionId);
+      }
       return existing;
+    }
     const now = Math.floor(Date.now() / 1000);
     this.db.query(`INSERT INTO sessions (session_id, project_id, user_id, device_id, agent, started_at_epoch)
         VALUES (?, ?, ?, ?, ?, ?)`).run(sessionId, projectId, userId, deviceId, agent, now);
@@ -1780,7 +1799,7 @@ function looksMeaningful(value) {
 // src/storage/projects.ts
 import { execSync } from "node:child_process";
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
-import { basename, join as join2 } from "node:path";
+import { basename, dirname, join as join2, resolve } from "node:path";
 function normaliseGitRemoteUrl(remoteUrl) {
   let url = remoteUrl.trim();
   url = url.replace(/^(?:https?|ssh|git):\/\//, "");
@@ -1834,6 +1853,19 @@ function getGitRemoteUrl(directory) {
     }
   }
 }
+function getGitTopLevel(directory) {
+  try {
+    const root = execSync("git rev-parse --show-toplevel", {
+      cwd: directory,
+      encoding: "utf-8",
+      timeout: 5000,
+      stdio: ["pipe", "pipe", "pipe"]
+    }).trim();
+    return root || null;
+  } catch {
+    return null;
+  }
+}
 function readProjectConfigFile(directory) {
   const configPath = join2(directory, ".engrm.json");
   if (!existsSync2(configPath))
@@ -1856,11 +1888,12 @@ function detectProject(directory) {
   const remoteUrl = getGitRemoteUrl(directory);
   if (remoteUrl) {
     const canonicalId = normaliseGitRemoteUrl(remoteUrl);
+    const repoRoot = getGitTopLevel(directory) ?? directory;
     return {
       canonical_id: canonicalId,
       name: projectNameFromCanonicalId(canonicalId),
       remote_url: remoteUrl,
-      local_path: directory
+      local_path: repoRoot
     };
   }
   const configFile = readProjectConfigFile(directory);
@@ -1880,6 +1913,32 @@ function detectProject(directory) {
     local_path: directory
   };
 }
+function detectProjectForPath(filePath, fallbackCwd) {
+  const absolutePath = resolve(fallbackCwd ?? process.cwd(), filePath);
+  const candidateDir = existsSync2(absolutePath) && !absolutePath.endsWith("/") ? dirname(absolutePath) : dirname(absolutePath);
+  const detected = detectProject(candidateDir);
+  if (detected.canonical_id.startsWith("local/"))
+    return null;
+  return detected;
+}
+function detectProjectFromTouchedPaths(paths, fallbackCwd) {
+  const counts = new Map;
+  for (const rawPath of paths) {
+    if (!rawPath || !rawPath.trim())
+      continue;
+    const detected = detectProjectForPath(rawPath, fallbackCwd);
+    if (!detected)
+      continue;
+    const existing = counts.get(detected.canonical_id);
+    if (existing) {
+      existing.count += 1;
+    } else {
+      counts.set(detected.canonical_id, { project: detected, count: 1 });
+    }
+  }
+  const ranked = [...counts.values()].sort((a, b) => b.count - a.count || a.project.name.localeCompare(b.project.name));
+  return ranked[0]?.project ?? detectProject(fallbackCwd);
+}
 
 // src/embeddings/embedder.ts
 var _available = null;
@@ -2147,7 +2206,8 @@ async function saveObservation(db, config, input) {
     return { success: false, reason: "Title is required" };
   }
   const cwd = input.cwd ?? process.cwd();
-  const detected = detectProject(cwd);
+  const touchedPaths = [...input.files_read ?? [], ...input.files_modified ?? []];
+  const detected = touchedPaths.length > 0 ? detectProjectFromTouchedPaths(touchedPaths, cwd) : detectProject(cwd);
   const project = db.upsertProject({
     canonical_id: detected.canonical_id,
     name: detected.name,
@@ -2599,6 +2659,7 @@ ${eventXml}`;
     const queryOptions = {
       model: options?.model ?? "haiku",
       maxTurns: 1,
+      timeout: options?.timeoutMs ?? 800,
       disallowedTools: [
         "Bash",
         "Read",
@@ -2919,43 +2980,37 @@ function checkSessionFatigue(db, sessionId) {
 
 // hooks/post-tool-use.ts
 async function main() {
-  const event = await parseStdinJson();
-  if (!event)
+  const raw = await readStdin();
+  if (!raw.trim())
     process.exit(0);
   const boot = bootstrapHook("post-tool-use");
   if (!boot)
     process.exit(0);
   const { config, db } = boot;
+  const now = Math.floor(Date.now() / 1000);
+  let event = null;
+  try {
+    event = JSON.parse(raw);
+  } catch {
+    db.setSyncState("hook_post_tool_last_seen_epoch", String(now));
+    db.setSyncState("hook_post_tool_last_parse_status", "invalid-json");
+    db.setSyncState("hook_post_tool_last_payload_preview", truncatePreview(raw, 400) ?? "invalid");
+    db.close();
+    process.exit(0);
+  }
+  db.setSyncState("hook_post_tool_last_seen_epoch", String(now));
+  db.setSyncState("hook_post_tool_last_parse_status", "parsed");
+  db.setSyncState("hook_post_tool_last_tool_name", event.tool_name ?? "(unknown)");
+  db.setSyncState("hook_post_tool_last_payload_preview", truncatePreview(raw, 400) ?? "parsed");
   try {
     if (event.session_id) {
-      const detected = detectProject(event.cwd);
-      const project = db.getProjectByCanonicalId(detected.canonical_id);
-      db.upsertSession(event.session_id, project?.id ?? null, config.user_id, config.device_id);
-      const metricsIncrement = {
-        toolCalls: 1
-      };
-      if ((event.tool_name === "Edit" || event.tool_name === "Write") && event.tool_input["file_path"]) {
-        metricsIncrement.files = 1;
-      }
-      db.incrementSessionMetrics(event.session_id, metricsIncrement);
-      db.insertToolEvent({
-        session_id: event.session_id,
-        project_id: project?.id ?? null,
-        tool_name: event.tool_name,
-        tool_input_json: safeSerializeToolInput(event.tool_input),
-        tool_response_preview: truncatePreview(event.tool_response, 1200),
-        file_path: extractFilePath(event.tool_input),
-        command: extractCommand(event.tool_input),
-        user_id: config.user_id,
-        device_id: config.device_id,
-        agent: "claude-code"
-      });
+      persistRawToolChronology(event, config.user_id, config.device_id);
     }
     const textToScan = extractScanText(event);
     if (textToScan) {
       const findings = scanForSecrets(textToScan, config.scrubbing.custom_patterns);
       if (findings.length > 0) {
-        const detected = detectProject(event.cwd);
+        const detected = detectProjectForEvent(event);
         const project = db.getProjectByCanonicalId(detected.canonical_id);
         if (project) {
           for (const finding of findings) {
@@ -3019,11 +3074,12 @@ async function main() {
       }
     }
     let saved = false;
-    if (config.observer?.enabled !== false) {
+    if (shouldRunInlineObserver(event, config.observer?.enabled !== false)) {
       try {
-        const observed = await observeToolEvent(event, {
-          model: config.observer.model
-        });
+        const observed = await withTimeout(observeToolEvent(event, {
+          model: config.observer.model,
+          timeoutMs: 800
+        }), 1000);
         if (observed) {
           await saveObservation(db, config, observed);
           incrementObserverSaveCount(event.session_id);
@@ -3050,6 +3106,76 @@ async function main() {
     db.close();
   }
 }
+function persistRawToolChronology(event, userId, deviceId) {
+  const rawDb = new MemDatabase(getDbPath());
+  try {
+    const detected = detectProjectForEvent(event);
+    const project = rawDb.upsertProject({
+      canonical_id: detected.canonical_id,
+      name: detected.name,
+      local_path: detected.local_path,
+      remote_url: detected.remote_url ?? null
+    });
+    rawDb.upsertSession(event.session_id, project.id, userId, deviceId, "claude-code");
+    const metricsIncrement = {
+      toolCalls: 1
+    };
+    if ((event.tool_name === "Edit" || event.tool_name === "Write") && event.tool_input["file_path"]) {
+      metricsIncrement.files = 1;
+    }
+    rawDb.incrementSessionMetrics(event.session_id, metricsIncrement);
+    rawDb.insertToolEvent({
+      session_id: event.session_id,
+      project_id: project.id,
+      tool_name: event.tool_name,
+      tool_input_json: safeSerializeToolInput(event.tool_input),
+      tool_response_preview: truncatePreview(event.tool_response, 1200),
+      file_path: extractFilePath(event.tool_input),
+      command: extractCommand(event.tool_input),
+      user_id: userId,
+      device_id: deviceId,
+      agent: "claude-code"
+    });
+  } finally {
+    rawDb.close();
+  }
+}
+async function withTimeout(promise, timeoutMs) {
+  let timeoutId = null;
+  try {
+    return await Promise.race([
+      promise,
+      new Promise((resolve2) => {
+        timeoutId = setTimeout(() => resolve2(null), timeoutMs);
+      })
+    ]);
+  } finally {
+    if (timeoutId)
+      clearTimeout(timeoutId);
+  }
+}
+function shouldRunInlineObserver(event, observerEnabled) {
+  if (!observerEnabled)
+    return false;
+  return event.tool_name === "Bash" || event.tool_name.startsWith("mcp__");
+}
+function detectProjectForEvent(event) {
+  const touchedPaths = extractTouchedPaths(event);
+  return touchedPaths.length > 0 ? detectProjectFromTouchedPaths(touchedPaths, event.cwd) : detectProject(event.cwd);
+}
+function extractTouchedPaths(event) {
+  const paths = [];
+  const filePath = event.tool_input["file_path"];
+  if (typeof filePath === "string" && filePath.trim().length > 0) {
+    paths.push(filePath);
+  }
+  const extracted = extractObservation(event);
+  if (extracted?.files_read)
+    paths.push(...extracted.files_read);
+  if (extracted?.files_modified)
+    paths.push(...extracted.files_modified);
+  return paths;
+}
 function safeSerializeToolInput(toolInput) {
   try {
     const raw = JSON.stringify(toolInput);

package/dist/hooks/pre-compact.js

@@ -657,6 +657,11 @@ import { createHash as createHash2 } from "node:crypto";
 var IS_BUN = typeof globalThis.Bun !== "undefined";
 function openDatabase(dbPath) {
   if (IS_BUN) {
+    if (process.platform === "darwin") {
+      try {
+        return openNodeDatabase(dbPath);
+      } catch {}
+    }
     return openBunDatabase(dbPath);
   }
   return openNodeDatabase(dbPath);
@@ -773,6 +778,15 @@ class MemDatabase {
     }
     return row;
   }
+  reassignObservationProject(observationId, projectId) {
+    const existing = this.getObservationById(observationId);
+    if (!existing)
+      return false;
+    if (existing.project_id === projectId)
+      return true;
+    this.db.query("UPDATE observations SET project_id = ? WHERE id = ?").run(projectId, observationId);
+    return true;
+  }
   getObservationById(id) {
     return this.db.query("SELECT * FROM observations WHERE id = ?").get(id) ?? null;
   }
@@ -906,8 +920,13 @@ class MemDatabase {
   }
   upsertSession(sessionId, projectId, userId, deviceId, agent = "claude-code") {
     const existing = this.db.query("SELECT * FROM sessions WHERE session_id = ?").get(sessionId);
-    if (existing)
+    if (existing) {
+      if (existing.project_id === null && projectId !== null) {
+        this.db.query("UPDATE sessions SET project_id = ? WHERE session_id = ?").run(projectId, sessionId);
+        return this.db.query("SELECT * FROM sessions WHERE session_id = ?").get(sessionId);
+      }
       return existing;
+    }
     const now = Math.floor(Date.now() / 1000);
     this.db.query(`INSERT INTO sessions (session_id, project_id, user_id, device_id, agent, started_at_epoch)
         VALUES (?, ?, ?, ?, ?, ?)`).run(sessionId, projectId, userId, deviceId, agent, now);
@@ -1198,7 +1217,7 @@ function hashPrompt(prompt) {
 // src/storage/projects.ts
 import { execSync } from "node:child_process";
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
-import { basename, join as join2 } from "node:path";
+import { basename, dirname, join as join2, resolve } from "node:path";
 function normaliseGitRemoteUrl(remoteUrl) {
   let url = remoteUrl.trim();
   url = url.replace(/^(?:https?|ssh|git):\/\//, "");
@@ -1252,6 +1271,19 @@ function getGitRemoteUrl(directory) {
     }
   }
 }
+function getGitTopLevel(directory) {
+  try {
+    const root = execSync("git rev-parse --show-toplevel", {
+      cwd: directory,
+      encoding: "utf-8",
+      timeout: 5000,
+      stdio: ["pipe", "pipe", "pipe"]
+    }).trim();
+    return root || null;
+  } catch {
+    return null;
+  }
+}
 function readProjectConfigFile(directory) {
   const configPath = join2(directory, ".engrm.json");
   if (!existsSync2(configPath))
@@ -1274,11 +1306,12 @@ function detectProject(directory) {
   const remoteUrl = getGitRemoteUrl(directory);
   if (remoteUrl) {
     const canonicalId = normaliseGitRemoteUrl(remoteUrl);
+    const repoRoot = getGitTopLevel(directory) ?? directory;
     return {
       canonical_id: canonicalId,
       name: projectNameFromCanonicalId(canonicalId),
       remote_url: remoteUrl,
-      local_path: directory
+      local_path: repoRoot
     };
   }
   const configFile = readProjectConfigFile(directory);
@@ -1298,6 +1331,32 @@ function detectProject(directory) {
     local_path: directory
   };
 }
+function detectProjectForPath(filePath, fallbackCwd) {
+  const absolutePath = resolve(fallbackCwd ?? process.cwd(), filePath);
+  const candidateDir = existsSync2(absolutePath) && !absolutePath.endsWith("/") ? dirname(absolutePath) : dirname(absolutePath);
+  const detected = detectProject(candidateDir);
+  if (detected.canonical_id.startsWith("local/"))
+    return null;
+  return detected;
+}
+function detectProjectFromTouchedPaths(paths, fallbackCwd) {
+  const counts = new Map;
+  for (const rawPath of paths) {
+    if (!rawPath || !rawPath.trim())
+      continue;
+    const detected = detectProjectForPath(rawPath, fallbackCwd);
+    if (!detected)
+      continue;
+    const existing = counts.get(detected.canonical_id);
+    if (existing) {
+      existing.count += 1;
+    } else {
+      counts.set(detected.canonical_id, { project: detected, count: 1 });
+    }
+  }
+  const ranked = [...counts.values()].sort((a, b) => b.count - a.count || a.project.name.localeCompare(b.project.name));
+  return ranked[0]?.project ?? detectProject(fallbackCwd);
+}
 
 // src/capture/dedup.ts
 function tokenise(text) {
@@ -1543,6 +1602,32 @@ function computeObservationPriority(obs, nowEpoch) {
 }
 
 // src/context/inject.ts
+function tokenizeProjectHint(text) {
+  return Array.from(new Set((text.toLowerCase().match(/[a-z0-9_+-]{4,}/g) ?? []).filter(Boolean)));
+}
+function isObservationRelatedToProject(obs, detected) {
+  const hints = new Set([
+    ...tokenizeProjectHint(detected.name),
+    ...tokenizeProjectHint(detected.canonical_id)
+  ]);
+  if (hints.size === 0)
+    return false;
+  const haystack = [
+    obs.title,
+    obs.narrative ?? "",
+    obs.facts ?? "",
+    obs.concepts ?? "",
+    obs.files_read ?? "",
+    obs.files_modified ?? "",
+    obs._source_project ?? ""
+  ].join(` 
+ `).toLowerCase();
+  for (const hint of hints) {
+    if (haystack.includes(hint))
+      return true;
+  }
+  return false;
+}
 function estimateTokens(text) {
   if (!text)
     return 0;
@@ -1618,6 +1703,9 @@ function buildSessionContext(db, cwd, options = {}) {
       }
       return { ...obs, _source_project: projectNameCache.get(obs.project_id) };
     });
+    if (isNewProject) {
+      crossProjectCandidates = crossProjectCandidates.filter((obs) => isObservationRelatedToProject(obs, detected));
+    }
   }
   const seenIds = new Set(pinned.map((o) => o.id));
   const dedupedRecent = recent.filter((o) => {
@@ -1648,6 +1736,7 @@ function buildSessionContext(db, cwd, options = {}) {
     const recentToolEvents2 = db.getRecentToolEvents(isNewProject ? null : projectId, isNewProject ? 8 : 6, opts.userId);
     const recentSessions2 = isNewProject ? [] : db.getRecentSessions(projectId, 5, opts.userId);
     const projectTypeCounts2 = isNewProject ? undefined : getProjectTypeCounts(db, projectId, opts.userId);
+    const recentOutcomes2 = isNewProject ? undefined : getRecentOutcomes(db, projectId, opts.userId);
     return {
       project_name: projectName,
       canonical_id: canonicalId,
@@ -1657,7 +1746,8 @@ function buildSessionContext(db, cwd, options = {}) {
       recentPrompts: recentPrompts2.length > 0 ? recentPrompts2 : undefined,
       recentToolEvents: recentToolEvents2.length > 0 ? recentToolEvents2 : undefined,
       recentSessions: recentSessions2.length > 0 ? recentSessions2 : undefined,
-      projectTypeCounts: projectTypeCounts2
+      projectTypeCounts: projectTypeCounts2,
+      recentOutcomes: recentOutcomes2
     };
   }
   let remainingBudget = tokenBudget - 30;
@@ -1684,6 +1774,7 @@ function buildSessionContext(db, cwd, options = {}) {
   const recentToolEvents = db.getRecentToolEvents(isNewProject ? null : projectId, isNewProject ? 8 : 6, opts.userId);
   const recentSessions = isNewProject ? [] : db.getRecentSessions(projectId, 5, opts.userId);
   const projectTypeCounts = isNewProject ? undefined : getProjectTypeCounts(db, projectId, opts.userId);
+  const recentOutcomes = isNewProject ? undefined : getRecentOutcomes(db, projectId, opts.userId);
   let securityFindings = [];
   if (!isNewProject) {
     try {
@@ -1741,7 +1832,8 @@ function buildSessionContext(db, cwd, options = {}) {
     recentPrompts: recentPrompts.length > 0 ? recentPrompts : undefined,
     recentToolEvents: recentToolEvents.length > 0 ? recentToolEvents : undefined,
     recentSessions: recentSessions.length > 0 ? recentSessions : undefined,
-    projectTypeCounts
+    projectTypeCounts,
+    recentOutcomes
   };
 }
 function estimateObservationTokens(obs, index) {
@@ -1778,12 +1870,15 @@ function formatContextForInjection(context) {
     lines.push("");
   }
   if (context.recentPrompts && context.recentPrompts.length > 0) {
-    lines.push("## Recent Requests");
-    for (const prompt of context.recentPrompts.slice(0, 5)) {
-      const label = prompt.prompt_number > 0 ? `#${prompt.prompt_number}` : new Date(prompt.created_at_epoch * 1000).toISOString().split("T")[0];
-      lines.push(`- ${label}: ${truncateText(prompt.prompt.replace(/\s+/g, " "), 160)}`);
+    const promptLines = context.recentPrompts.filter((prompt) => isMeaningfulPrompt(prompt.prompt)).slice(0, 5);
+    if (promptLines.length > 0) {
+      lines.push("## Recent Requests");
+      for (const prompt of promptLines) {
+        const label = prompt.prompt_number > 0 ? `#${prompt.prompt_number}` : new Date(prompt.created_at_epoch * 1000).toISOString().split("T")[0];
+        lines.push(`- ${label}: ${truncateText(prompt.prompt.replace(/\s+/g, " "), 160)}`);
+      }
+      lines.push("");
     }
-    lines.push("");
   }
   if (context.recentToolEvents && context.recentToolEvents.length > 0) {
     lines.push("## Recent Tools");
@@ -1793,10 +1888,22 @@ function formatContextForInjection(context) {
     lines.push("");
   }
   if (context.recentSessions && context.recentSessions.length > 0) {
-    lines.push("## Recent Sessions");
-    for (const session of context.recentSessions.slice(0, 4)) {
-      const summary = session.request ?? session.completed ?? "(no summary)";
-      lines.push(`- ${session.session_id}: ${truncateText(summary.replace(/\s+/g, " "), 140)} ` + `(prompts ${session.prompt_count}, tools ${session.tool_event_count}, obs ${session.observation_count})`);
+    const recentSessionLines = context.recentSessions.slice(0, 4).map((session) => {
+      const summary = chooseMeaningfulSessionHeadline(session.request, session.completed);
+      if (summary === "(no summary)")
+        return null;
+      return `- ${session.session_id}: ${truncateText(summary.replace(/\s+/g, " "), 140)} ` + `(prompts ${session.prompt_count}, tools ${session.tool_event_count}, obs ${session.observation_count})`;
+    }).filter((line) => Boolean(line));
+    if (recentSessionLines.length > 0) {
+      lines.push("## Recent Sessions");
+      lines.push(...recentSessionLines);
+      lines.push("");
+    }
+  }
+  if (context.recentOutcomes && context.recentOutcomes.length > 0) {
+    lines.push("## Recent Outcomes");
+    for (const outcome of context.recentOutcomes.slice(0, 5)) {
+      lines.push(`- ${truncateText(outcome, 160)}`);
     }
     lines.push("");
   }
@@ -1876,6 +1983,14 @@ function formatSessionBrief(summary) {
   }
   return lines;
 }
+function chooseMeaningfulSessionHeadline(request, completed) {
+  if (request && !looksLikeFileOperationTitle(request))
+    return request;
+  const completedItems = extractMeaningfulLines(completed, 1);
+  if (completedItems.length > 0)
+    return completedItems[0];
+  return request ?? completed ?? "(no summary)";
+}
 function formatSummarySection(value, maxLen) {
   if (!value)
     return null;
@@ -1900,6 +2015,26 @@ function truncateText(text, maxLen) {
     return text;
   return text.slice(0, maxLen - 3) + "...";
 }
+function isMeaningfulPrompt(value) {
+  if (!value)
+    return false;
+  const compact = value.replace(/\s+/g, " ").trim();
+  if (compact.length < 8)
+    return false;
+  return /[a-z]{3,}/i.test(compact);
+}
+function looksLikeFileOperationTitle(value) {
+  return /^(modified|updated|edited|touched|changed|extended|refactored|redesigned)\s+[A-Za-z0-9_.\-\/]+(?:\s*\([^)]*\))?$/i.test(value.trim());
+}
+function stripInlineSectionLabel(value) {
+  return value.replace(/^(request|investigated|learned|completed|next steps|digest|summary):\s*/i, "").trim();
+}
+function extractMeaningfulLines(value, limit) {
+  if (!value)
+    return [];
+  return value.split(`
+`).map((line) => line.trim()).filter(Boolean).map((line) => line.replace(/^[-*]\s*/, "")).map((line) => stripInlineSectionLabel(line)).filter((line) => line.length > 0 && !looksLikeFileOperationTitle(line)).slice(0, limit);
+}
 function formatObservationDetailFromContext(obs) {
   if (obs.facts) {
     const bullets = parseFacts(obs.facts);
@@ -1999,6 +2134,50 @@ function getProjectTypeCounts(db, projectId, userId) {
   }
   return counts;
 }
+function getRecentOutcomes(db, projectId, userId) {
+  const visibilityClause = userId ? " AND (sensitivity != 'personal' OR user_id = ?)" : "";
+  const visibilityParams = userId ? [userId] : [];
+  const summaries = db.db.query(`SELECT * FROM session_summaries
+       WHERE project_id = ?
+       ORDER BY created_at_epoch DESC
+       LIMIT 6`).all(projectId);
+  const picked = [];
+  const seen = new Set;
+  for (const summary of summaries) {
+    for (const line of [
+      ...extractMeaningfulLines(summary.completed, 2),
+      ...extractMeaningfulLines(summary.learned, 1)
+    ]) {
+      const normalized = line.toLowerCase().replace(/\s+/g, " ").trim();
+      if (!normalized || seen.has(normalized))
+        continue;
+      seen.add(normalized);
+      picked.push(line);
+      if (picked.length >= 5)
+        return picked;
+    }
+  }
+  const rows = db.db.query(`SELECT * FROM observations
+       WHERE project_id = ?
+         AND lifecycle IN ('active', 'aging', 'pinned')
+         AND superseded_by IS NULL
+         ${visibilityClause}
+       ORDER BY created_at_epoch DESC
+       LIMIT 20`).all(projectId, ...visibilityParams);
+  for (const obs of rows) {
+    if (!["bugfix", "feature", "refactor", "change", "decision"].includes(obs.type))
+      continue;
+    const title = stripInlineSectionLabel(obs.title);
+    const normalized = title.toLowerCase().replace(/\s+/g, " ").trim();
+    if (!normalized || seen.has(normalized) || looksLikeFileOperationTitle(title))
+      continue;
+    seen.add(normalized);
+    picked.push(title);
+    if (picked.length >= 5)
+      break;
+  }
+  return picked;
+}
 
 // hooks/pre-compact.ts
 function formatCurrentSessionContext(observations) {