engrm 0.4.19 → 0.4.21

package/dist/cli.js

@@ -598,6 +598,16 @@ var MIGRATIONS = [
         ON tool_events(created_at_epoch DESC, id DESC);
     `
   },
+  {
+    version: 11,
+    description: "Add synced handoff metadata to session summaries",
+    sql: `
+      ALTER TABLE session_summaries ADD COLUMN capture_state TEXT;
+      ALTER TABLE session_summaries ADD COLUMN recent_tool_names TEXT;
+      ALTER TABLE session_summaries ADD COLUMN hot_files TEXT;
+      ALTER TABLE session_summaries ADD COLUMN recent_outcomes TEXT;
+    `
+  },
   {
     version: 11,
     description: "Add observation provenance from tool and prompt chronology",
@@ -1125,6 +1135,10 @@ class MemDatabase {
              p.name AS project_name,
              ss.request AS request,
              ss.completed AS completed,
+             ss.capture_state AS capture_state,
+             ss.recent_tool_names AS recent_tool_names,
+             ss.hot_files AS hot_files,
+             ss.recent_outcomes AS recent_outcomes,
              (SELECT COUNT(*) FROM user_prompts up WHERE up.session_id = s.session_id) AS prompt_count,
              (SELECT COUNT(*) FROM tool_events te WHERE te.session_id = s.session_id) AS tool_event_count
            FROM sessions s
@@ -1139,6 +1153,10 @@ class MemDatabase {
            p.name AS project_name,
            ss.request AS request,
            ss.completed AS completed,
+           ss.capture_state AS capture_state,
+           ss.recent_tool_names AS recent_tool_names,
+           ss.hot_files AS hot_files,
+           ss.recent_outcomes AS recent_outcomes,
            (SELECT COUNT(*) FROM user_prompts up WHERE up.session_id = s.session_id) AS prompt_count,
            (SELECT COUNT(*) FROM tool_events te WHERE te.session_id = s.session_id) AS tool_event_count
          FROM sessions s
@@ -1311,8 +1329,11 @@ class MemDatabase {
       completed: normalizeSummarySection(summary.completed),
       next_steps: normalizeSummarySection(summary.next_steps)
     };
-    const result = this.db.query(`INSERT INTO session_summaries (session_id, project_id, user_id, request, investigated, learned, completed, next_steps, created_at_epoch)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, now);
+    const result = this.db.query(`INSERT INTO session_summaries (
+          session_id, project_id, user_id, request, investigated, learned, completed, next_steps,
+          capture_state, recent_tool_names, hot_files, recent_outcomes, created_at_epoch
+        )
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, summary.capture_state ?? null, summary.recent_tool_names ?? null, summary.hot_files ?? null, summary.recent_outcomes ?? null, now);
     const id = Number(result.lastInsertRowid);
     return this.db.query("SELECT * FROM session_summaries WHERE id = ?").get(id);
   }
@@ -1327,7 +1348,11 @@ class MemDatabase {
       investigated: normalizeSummarySection(summary.investigated ?? existing.investigated),
       learned: normalizeSummarySection(summary.learned ?? existing.learned),
       completed: normalizeSummarySection(summary.completed ?? existing.completed),
-      next_steps: normalizeSummarySection(summary.next_steps ?? existing.next_steps)
+      next_steps: normalizeSummarySection(summary.next_steps ?? existing.next_steps),
+      capture_state: summary.capture_state ?? existing.capture_state,
+      recent_tool_names: summary.recent_tool_names ?? existing.recent_tool_names,
+      hot_files: summary.hot_files ?? existing.hot_files,
+      recent_outcomes: summary.recent_outcomes ?? existing.recent_outcomes
     };
     this.db.query(`UPDATE session_summaries
          SET project_id = ?,
@@ -1337,8 +1362,12 @@ class MemDatabase {
              learned = ?,
              completed = ?,
              next_steps = ?,
+             capture_state = ?,
+             recent_tool_names = ?,
+             hot_files = ?,
+             recent_outcomes = ?,
              created_at_epoch = ?
-         WHERE session_id = ?`).run(summary.project_id ?? existing.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, now, summary.session_id);
+         WHERE session_id = ?`).run(summary.project_id ?? existing.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, normalized.capture_state, normalized.recent_tool_names, normalized.hot_files, normalized.recent_outcomes, now, summary.session_id);
     return this.getSessionSummary(summary.session_id);
   }
   getSessionSummary(sessionId) {
@@ -1843,6 +1872,16 @@ var MIGRATIONS2 = [
         ON tool_events(created_at_epoch DESC, id DESC);
     `
   },
+  {
+    version: 11,
+    description: "Add synced handoff metadata to session summaries",
+    sql: `
+      ALTER TABLE session_summaries ADD COLUMN capture_state TEXT;
+      ALTER TABLE session_summaries ADD COLUMN recent_tool_names TEXT;
+      ALTER TABLE session_summaries ADD COLUMN hot_files TEXT;
+      ALTER TABLE session_summaries ADD COLUMN recent_outcomes TEXT;
+    `
+  },
   {
     version: 11,
     description: "Add observation provenance from tool and prompt chronology",

package/dist/hooks/elicitation-result.js

@@ -1431,6 +1431,16 @@ var MIGRATIONS = [
         ON tool_events(created_at_epoch DESC, id DESC);
     `
   },
+  {
+    version: 11,
+    description: "Add synced handoff metadata to session summaries",
+    sql: `
+      ALTER TABLE session_summaries ADD COLUMN capture_state TEXT;
+      ALTER TABLE session_summaries ADD COLUMN recent_tool_names TEXT;
+      ALTER TABLE session_summaries ADD COLUMN hot_files TEXT;
+      ALTER TABLE session_summaries ADD COLUMN recent_outcomes TEXT;
+    `
+  },
   {
     version: 11,
     description: "Add observation provenance from tool and prompt chronology",
@@ -1954,6 +1964,10 @@ class MemDatabase {
              p.name AS project_name,
              ss.request AS request,
              ss.completed AS completed,
+             ss.capture_state AS capture_state,
+             ss.recent_tool_names AS recent_tool_names,
+             ss.hot_files AS hot_files,
+             ss.recent_outcomes AS recent_outcomes,
              (SELECT COUNT(*) FROM user_prompts up WHERE up.session_id = s.session_id) AS prompt_count,
              (SELECT COUNT(*) FROM tool_events te WHERE te.session_id = s.session_id) AS tool_event_count
            FROM sessions s
@@ -1968,6 +1982,10 @@ class MemDatabase {
            p.name AS project_name,
            ss.request AS request,
            ss.completed AS completed,
+           ss.capture_state AS capture_state,
+           ss.recent_tool_names AS recent_tool_names,
+           ss.hot_files AS hot_files,
+           ss.recent_outcomes AS recent_outcomes,
            (SELECT COUNT(*) FROM user_prompts up WHERE up.session_id = s.session_id) AS prompt_count,
            (SELECT COUNT(*) FROM tool_events te WHERE te.session_id = s.session_id) AS tool_event_count
          FROM sessions s
@@ -2140,8 +2158,11 @@ class MemDatabase {
       completed: normalizeSummarySection(summary.completed),
       next_steps: normalizeSummarySection(summary.next_steps)
     };
-    const result = this.db.query(`INSERT INTO session_summaries (session_id, project_id, user_id, request, investigated, learned, completed, next_steps, created_at_epoch)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, now);
+    const result = this.db.query(`INSERT INTO session_summaries (
+          session_id, project_id, user_id, request, investigated, learned, completed, next_steps,
+          capture_state, recent_tool_names, hot_files, recent_outcomes, created_at_epoch
+        )
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, summary.capture_state ?? null, summary.recent_tool_names ?? null, summary.hot_files ?? null, summary.recent_outcomes ?? null, now);
     const id = Number(result.lastInsertRowid);
     return this.db.query("SELECT * FROM session_summaries WHERE id = ?").get(id);
   }
@@ -2156,7 +2177,11 @@ class MemDatabase {
       investigated: normalizeSummarySection(summary.investigated ?? existing.investigated),
       learned: normalizeSummarySection(summary.learned ?? existing.learned),
       completed: normalizeSummarySection(summary.completed ?? existing.completed),
-      next_steps: normalizeSummarySection(summary.next_steps ?? existing.next_steps)
+      next_steps: normalizeSummarySection(summary.next_steps ?? existing.next_steps),
+      capture_state: summary.capture_state ?? existing.capture_state,
+      recent_tool_names: summary.recent_tool_names ?? existing.recent_tool_names,
+      hot_files: summary.hot_files ?? existing.hot_files,
+      recent_outcomes: summary.recent_outcomes ?? existing.recent_outcomes
     };
     this.db.query(`UPDATE session_summaries
          SET project_id = ?,
@@ -2166,8 +2191,12 @@ class MemDatabase {
              learned = ?,
              completed = ?,
              next_steps = ?,
+             capture_state = ?,
+             recent_tool_names = ?,
+             hot_files = ?,
+             recent_outcomes = ?,
              created_at_epoch = ?
-         WHERE session_id = ?`).run(summary.project_id ?? existing.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, now, summary.session_id);
+         WHERE session_id = ?`).run(summary.project_id ?? existing.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, normalized.capture_state, normalized.recent_tool_names, normalized.hot_files, normalized.recent_outcomes, now, summary.session_id);
     return this.getSessionSummary(summary.session_id);
   }
   getSessionSummary(sessionId) {

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

@@ -776,6 +776,16 @@ var MIGRATIONS = [
         ON tool_events(created_at_epoch DESC, id DESC);
     `
   },
+  {
+    version: 11,
+    description: "Add synced handoff metadata to session summaries",
+    sql: `
+      ALTER TABLE session_summaries ADD COLUMN capture_state TEXT;
+      ALTER TABLE session_summaries ADD COLUMN recent_tool_names TEXT;
+      ALTER TABLE session_summaries ADD COLUMN hot_files TEXT;
+      ALTER TABLE session_summaries ADD COLUMN recent_outcomes TEXT;
+    `
+  },
   {
     version: 11,
     description: "Add observation provenance from tool and prompt chronology",
@@ -1299,6 +1309,10 @@ class MemDatabase {
              p.name AS project_name,
              ss.request AS request,
              ss.completed AS completed,
+             ss.capture_state AS capture_state,
+             ss.recent_tool_names AS recent_tool_names,
+             ss.hot_files AS hot_files,
+             ss.recent_outcomes AS recent_outcomes,
              (SELECT COUNT(*) FROM user_prompts up WHERE up.session_id = s.session_id) AS prompt_count,
              (SELECT COUNT(*) FROM tool_events te WHERE te.session_id = s.session_id) AS tool_event_count
            FROM sessions s
@@ -1313,6 +1327,10 @@ class MemDatabase {
            p.name AS project_name,
            ss.request AS request,
            ss.completed AS completed,
+           ss.capture_state AS capture_state,
+           ss.recent_tool_names AS recent_tool_names,
+           ss.hot_files AS hot_files,
+           ss.recent_outcomes AS recent_outcomes,
            (SELECT COUNT(*) FROM user_prompts up WHERE up.session_id = s.session_id) AS prompt_count,
            (SELECT COUNT(*) FROM tool_events te WHERE te.session_id = s.session_id) AS tool_event_count
          FROM sessions s
@@ -1485,8 +1503,11 @@ class MemDatabase {
       completed: normalizeSummarySection(summary.completed),
       next_steps: normalizeSummarySection(summary.next_steps)
     };
-    const result = this.db.query(`INSERT INTO session_summaries (session_id, project_id, user_id, request, investigated, learned, completed, next_steps, created_at_epoch)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, now);
+    const result = this.db.query(`INSERT INTO session_summaries (
+          session_id, project_id, user_id, request, investigated, learned, completed, next_steps,
+          capture_state, recent_tool_names, hot_files, recent_outcomes, created_at_epoch
+        )
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, summary.capture_state ?? null, summary.recent_tool_names ?? null, summary.hot_files ?? null, summary.recent_outcomes ?? null, now);
     const id = Number(result.lastInsertRowid);
     return this.db.query("SELECT * FROM session_summaries WHERE id = ?").get(id);
   }
@@ -1501,7 +1522,11 @@ class MemDatabase {
       investigated: normalizeSummarySection(summary.investigated ?? existing.investigated),
       learned: normalizeSummarySection(summary.learned ?? existing.learned),
       completed: normalizeSummarySection(summary.completed ?? existing.completed),
-      next_steps: normalizeSummarySection(summary.next_steps ?? existing.next_steps)
+      next_steps: normalizeSummarySection(summary.next_steps ?? existing.next_steps),
+      capture_state: summary.capture_state ?? existing.capture_state,
+      recent_tool_names: summary.recent_tool_names ?? existing.recent_tool_names,
+      hot_files: summary.hot_files ?? existing.hot_files,
+      recent_outcomes: summary.recent_outcomes ?? existing.recent_outcomes
     };
     this.db.query(`UPDATE session_summaries
          SET project_id = ?,
@@ -1511,8 +1536,12 @@ class MemDatabase {
              learned = ?,
              completed = ?,
              next_steps = ?,
+             capture_state = ?,
+             recent_tool_names = ?,
+             hot_files = ?,
+             recent_outcomes = ?,
              created_at_epoch = ?
-         WHERE session_id = ?`).run(summary.project_id ?? existing.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, now, summary.session_id);
+         WHERE session_id = ?`).run(summary.project_id ?? existing.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, normalized.capture_state, normalized.recent_tool_names, normalized.hot_files, normalized.recent_outcomes, now, summary.session_id);
     return this.getSessionSummary(summary.session_id);
   }
   getSessionSummary(sessionId) {
@@ -3166,6 +3195,63 @@ function checkSessionFatigue(db, sessionId) {
   };
 }
 
+// src/capture/live-summary.ts
+var LOW_SIGNAL_TITLE_PATTERNS = [
+  /^(Modified|Extended|Reduced|Created)\s+\S+/i,
+  /^Dependency change:/i,
+  /^[a-z0-9._-]+\s*\(error\)$/i,
+  /^(engrm|unknown):\s+/i
+];
+function buildLiveSummaryUpdate(observation) {
+  const title = compactSummaryTitle(observation.title);
+  if (!title)
+    return null;
+  switch (observation.type) {
+    case "discovery":
+    case "pattern":
+      return { investigated: title };
+    case "decision":
+      return { learned: title };
+    case "bugfix":
+    case "feature":
+    case "change":
+    case "refactor":
+      return { completed: title };
+    default:
+      return null;
+  }
+}
+function compactSummaryTitle(title) {
+  const trimmed = title?.trim();
+  if (!trimmed)
+    return null;
+  if (LOW_SIGNAL_TITLE_PATTERNS.some((pattern) => pattern.test(trimmed))) {
+    return null;
+  }
+  return trimmed.length > 180 ? `${trimmed.slice(0, 177)}...` : trimmed;
+}
+function mergeLiveSummarySections(existing, update) {
+  return {
+    investigated: mergeSectionItem(existing?.investigated ?? null, update.investigated ?? null),
+    learned: mergeSectionItem(existing?.learned ?? null, update.learned ?? null),
+    completed: mergeSectionItem(existing?.completed ?? null, update.completed ?? null)
+  };
+}
+function mergeSectionItem(existing, item) {
+  if (!item)
+    return existing;
+  if (!existing)
+    return item;
+  const lines = existing.split(`
+`).map((line) => line.replace(/^\s*-\s*/, "").trim()).filter(Boolean);
+  const normalizedItem = item.trim();
+  if (lines.some((line) => line.toLowerCase() === normalizedItem.toLowerCase())) {
+    return existing;
+  }
+  return `${existing}
+- ${normalizedItem}`;
+}
+
 // hooks/post-tool-use.ts
 async function main() {
   const raw = await readStdin();
@@ -3269,7 +3355,8 @@ async function main() {
           timeoutMs: 800
         }), 1000);
         if (observed) {
-          await saveObservation(db, config, observed);
+          const result = await saveObservation(db, config, observed);
+          updateRollingSummaryFromObservation(db, result.observation_id, event, config.user_id);
           incrementObserverSaveCount(event.session_id);
           saved = true;
         }
@@ -3278,7 +3365,7 @@ async function main() {
     if (!saved) {
       const extracted = extractObservation(event);
       if (extracted) {
-        await saveObservation(db, config, {
+        const result = await saveObservation(db, config, {
           type: extracted.type,
           title: extracted.title,
           narrative: extracted.narrative,
@@ -3288,6 +3375,7 @@ async function main() {
           cwd: event.cwd,
           source_tool: event.tool_name
         });
+        updateRollingSummaryFromObservation(db, result.observation_id, event, config.user_id);
         incrementObserverSaveCount(event.session_id);
       }
     }
@@ -3352,6 +3440,30 @@ function detectProjectForEvent(event) {
   const touchedPaths = extractTouchedPaths(event);
   return touchedPaths.length > 0 ? detectProjectFromTouchedPaths(touchedPaths, event.cwd) : detectProject(event.cwd);
 }
+function updateRollingSummaryFromObservation(db, observationId, event, userId) {
+  if (!observationId || !event.session_id)
+    return;
+  const observation = db.getObservationById(observationId);
+  if (!observation)
+    return;
+  const update = buildLiveSummaryUpdate(observation);
+  if (!update)
+    return;
+  const existing = db.getSessionSummary(event.session_id);
+  const merged = mergeLiveSummarySections(existing, update);
+  const currentRequest = existing?.request ?? db.getSessionUserPrompts(event.session_id, 1).at(-1)?.prompt ?? null;
+  const summary = db.upsertSessionSummary({
+    session_id: event.session_id,
+    project_id: observation.project_id,
+    user_id: userId,
+    request: currentRequest,
+    investigated: merged.investigated,
+    learned: merged.learned,
+    completed: merged.completed,
+    next_steps: existing?.next_steps ?? null
+  });
+  db.addToOutbox("summary", summary.id);
+}
 function extractTouchedPaths(event) {
   const paths = [];
   const filePath = event.tool_input["file_path"];

package/dist/hooks/pre-compact.js

@@ -570,6 +570,16 @@ var MIGRATIONS = [
         ON tool_events(created_at_epoch DESC, id DESC);
     `
   },
+  {
+    version: 11,
+    description: "Add synced handoff metadata to session summaries",
+    sql: `
+      ALTER TABLE session_summaries ADD COLUMN capture_state TEXT;
+      ALTER TABLE session_summaries ADD COLUMN recent_tool_names TEXT;
+      ALTER TABLE session_summaries ADD COLUMN hot_files TEXT;
+      ALTER TABLE session_summaries ADD COLUMN recent_outcomes TEXT;
+    `
+  },
   {
     version: 11,
     description: "Add observation provenance from tool and prompt chronology",
@@ -1093,6 +1103,10 @@ class MemDatabase {
              p.name AS project_name,
              ss.request AS request,
              ss.completed AS completed,
+             ss.capture_state AS capture_state,
+             ss.recent_tool_names AS recent_tool_names,
+             ss.hot_files AS hot_files,
+             ss.recent_outcomes AS recent_outcomes,
              (SELECT COUNT(*) FROM user_prompts up WHERE up.session_id = s.session_id) AS prompt_count,
              (SELECT COUNT(*) FROM tool_events te WHERE te.session_id = s.session_id) AS tool_event_count
            FROM sessions s
@@ -1107,6 +1121,10 @@ class MemDatabase {
            p.name AS project_name,
            ss.request AS request,
            ss.completed AS completed,
+           ss.capture_state AS capture_state,
+           ss.recent_tool_names AS recent_tool_names,
+           ss.hot_files AS hot_files,
+           ss.recent_outcomes AS recent_outcomes,
            (SELECT COUNT(*) FROM user_prompts up WHERE up.session_id = s.session_id) AS prompt_count,
            (SELECT COUNT(*) FROM tool_events te WHERE te.session_id = s.session_id) AS tool_event_count
          FROM sessions s
@@ -1279,8 +1297,11 @@ class MemDatabase {
       completed: normalizeSummarySection(summary.completed),
       next_steps: normalizeSummarySection(summary.next_steps)
     };
-    const result = this.db.query(`INSERT INTO session_summaries (session_id, project_id, user_id, request, investigated, learned, completed, next_steps, created_at_epoch)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, now);
+    const result = this.db.query(`INSERT INTO session_summaries (
+          session_id, project_id, user_id, request, investigated, learned, completed, next_steps,
+          capture_state, recent_tool_names, hot_files, recent_outcomes, created_at_epoch
+        )
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, summary.capture_state ?? null, summary.recent_tool_names ?? null, summary.hot_files ?? null, summary.recent_outcomes ?? null, now);
     const id = Number(result.lastInsertRowid);
     return this.db.query("SELECT * FROM session_summaries WHERE id = ?").get(id);
   }
@@ -1295,7 +1316,11 @@ class MemDatabase {
       investigated: normalizeSummarySection(summary.investigated ?? existing.investigated),
       learned: normalizeSummarySection(summary.learned ?? existing.learned),
       completed: normalizeSummarySection(summary.completed ?? existing.completed),
-      next_steps: normalizeSummarySection(summary.next_steps ?? existing.next_steps)
+      next_steps: normalizeSummarySection(summary.next_steps ?? existing.next_steps),
+      capture_state: summary.capture_state ?? existing.capture_state,
+      recent_tool_names: summary.recent_tool_names ?? existing.recent_tool_names,
+      hot_files: summary.hot_files ?? existing.hot_files,
+      recent_outcomes: summary.recent_outcomes ?? existing.recent_outcomes
     };
     this.db.query(`UPDATE session_summaries
          SET project_id = ?,
@@ -1305,8 +1330,12 @@ class MemDatabase {
              learned = ?,
              completed = ?,
              next_steps = ?,
+             capture_state = ?,
+             recent_tool_names = ?,
+             hot_files = ?,
+             recent_outcomes = ?,
              created_at_epoch = ?
-         WHERE session_id = ?`).run(summary.project_id ?? existing.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, now, summary.session_id);
+         WHERE session_id = ?`).run(summary.project_id ?? existing.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, normalized.capture_state, normalized.recent_tool_names, normalized.hot_files, normalized.recent_outcomes, now, summary.session_id);
     return this.getSessionSummary(summary.session_id);
   }
   getSessionSummary(sessionId) {
@@ -1790,6 +1819,16 @@ function computeObservationPriority(obs, nowEpoch) {
 function tokenizeProjectHint(text) {
   return Array.from(new Set((text.toLowerCase().match(/[a-z0-9_+-]{4,}/g) ?? []).filter(Boolean)));
 }
+function parseSummaryJsonList(value) {
+  if (!value)
+    return [];
+  try {
+    const parsed = JSON.parse(value);
+    return Array.isArray(parsed) ? parsed.filter((item) => typeof item === "string" && item.trim().length > 0) : [];
+  } catch {
+    return [];
+  }
+}
 function isObservationRelatedToProject(obs, detected) {
   const hints = new Set([
     ...tokenizeProjectHint(detected.name),
@@ -1921,7 +1960,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);
+    const recentOutcomes2 = isNewProject ? undefined : getRecentOutcomes(db, projectId, opts.userId, recentSessions2);
     return {
       project_name: projectName,
       canonical_id: canonicalId,
@@ -1959,7 +1998,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);
+  const recentOutcomes = isNewProject ? undefined : getRecentOutcomes(db, projectId, opts.userId, recentSessions);
   let securityFindings = [];
   if (!isNewProject) {
     try {
@@ -2302,7 +2341,7 @@ function getProjectTypeCounts(db, projectId, userId) {
   }
   return counts;
 }
-function getRecentOutcomes(db, projectId, userId) {
+function getRecentOutcomes(db, projectId, userId, recentSessions) {
   const visibilityClause = userId ? " AND (sensitivity != 'personal' OR user_id = ?)" : "";
   const visibilityParams = userId ? [userId] : [];
   const summaries = db.db.query(`SELECT * FROM session_summaries
@@ -2312,6 +2351,15 @@ function getRecentOutcomes(db, projectId, userId) {
   const picked = [];
   const seen = new Set;
   for (const summary of summaries) {
+    for (const item of parseSummaryJsonList(summary.recent_outcomes)) {
+      const normalized = item.toLowerCase().replace(/\s+/g, " ").trim();
+      if (!normalized || seen.has(normalized))
+        continue;
+      seen.add(normalized);
+      picked.push(item);
+      if (picked.length >= 5)
+        return picked;
+    }
     for (const line of [
       ...extractMeaningfulLines(summary.completed, 2),
       ...extractMeaningfulLines(summary.learned, 1)
@@ -2325,6 +2373,17 @@ function getRecentOutcomes(db, projectId, userId) {
         return picked;
     }
   }
+  for (const session of recentSessions ?? []) {
+    for (const item of parseSummaryJsonList(session.recent_outcomes)) {
+      const normalized = item.toLowerCase().replace(/\s+/g, " ").trim();
+      if (!normalized || seen.has(normalized))
+        continue;
+      seen.add(normalized);
+      picked.push(item);
+      if (picked.length >= 5)
+        return picked;
+    }
+  }
   const rows = db.db.query(`SELECT * FROM observations
        WHERE project_id = ?
          AND lifecycle IN ('active', 'aging', 'pinned')

package/dist/hooks/sentinel.js

@@ -646,6 +646,16 @@ var MIGRATIONS = [
         ON tool_events(created_at_epoch DESC, id DESC);
     `
   },
+  {
+    version: 11,
+    description: "Add synced handoff metadata to session summaries",
+    sql: `
+      ALTER TABLE session_summaries ADD COLUMN capture_state TEXT;
+      ALTER TABLE session_summaries ADD COLUMN recent_tool_names TEXT;
+      ALTER TABLE session_summaries ADD COLUMN hot_files TEXT;
+      ALTER TABLE session_summaries ADD COLUMN recent_outcomes TEXT;
+    `
+  },
   {
     version: 11,
     description: "Add observation provenance from tool and prompt chronology",
@@ -1169,6 +1179,10 @@ class MemDatabase {
              p.name AS project_name,
              ss.request AS request,
              ss.completed AS completed,
+             ss.capture_state AS capture_state,
+             ss.recent_tool_names AS recent_tool_names,
+             ss.hot_files AS hot_files,
+             ss.recent_outcomes AS recent_outcomes,
              (SELECT COUNT(*) FROM user_prompts up WHERE up.session_id = s.session_id) AS prompt_count,
              (SELECT COUNT(*) FROM tool_events te WHERE te.session_id = s.session_id) AS tool_event_count
            FROM sessions s
@@ -1183,6 +1197,10 @@ class MemDatabase {
            p.name AS project_name,
            ss.request AS request,
            ss.completed AS completed,
+           ss.capture_state AS capture_state,
+           ss.recent_tool_names AS recent_tool_names,
+           ss.hot_files AS hot_files,
+           ss.recent_outcomes AS recent_outcomes,
            (SELECT COUNT(*) FROM user_prompts up WHERE up.session_id = s.session_id) AS prompt_count,
            (SELECT COUNT(*) FROM tool_events te WHERE te.session_id = s.session_id) AS tool_event_count
          FROM sessions s
@@ -1355,8 +1373,11 @@ class MemDatabase {
       completed: normalizeSummarySection(summary.completed),
       next_steps: normalizeSummarySection(summary.next_steps)
     };
-    const result = this.db.query(`INSERT INTO session_summaries (session_id, project_id, user_id, request, investigated, learned, completed, next_steps, created_at_epoch)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, now);
+    const result = this.db.query(`INSERT INTO session_summaries (
+          session_id, project_id, user_id, request, investigated, learned, completed, next_steps,
+          capture_state, recent_tool_names, hot_files, recent_outcomes, created_at_epoch
+        )
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, summary.capture_state ?? null, summary.recent_tool_names ?? null, summary.hot_files ?? null, summary.recent_outcomes ?? null, now);
     const id = Number(result.lastInsertRowid);
     return this.db.query("SELECT * FROM session_summaries WHERE id = ?").get(id);
   }
@@ -1371,7 +1392,11 @@ class MemDatabase {
       investigated: normalizeSummarySection(summary.investigated ?? existing.investigated),
       learned: normalizeSummarySection(summary.learned ?? existing.learned),
       completed: normalizeSummarySection(summary.completed ?? existing.completed),
-      next_steps: normalizeSummarySection(summary.next_steps ?? existing.next_steps)
+      next_steps: normalizeSummarySection(summary.next_steps ?? existing.next_steps),
+      capture_state: summary.capture_state ?? existing.capture_state,
+      recent_tool_names: summary.recent_tool_names ?? existing.recent_tool_names,
+      hot_files: summary.hot_files ?? existing.hot_files,
+      recent_outcomes: summary.recent_outcomes ?? existing.recent_outcomes
     };
     this.db.query(`UPDATE session_summaries
          SET project_id = ?,
@@ -1381,8 +1406,12 @@ class MemDatabase {
              learned = ?,
              completed = ?,
              next_steps = ?,
+             capture_state = ?,
+             recent_tool_names = ?,
+             hot_files = ?,
+             recent_outcomes = ?,
              created_at_epoch = ?
-         WHERE session_id = ?`).run(summary.project_id ?? existing.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, now, summary.session_id);
+         WHERE session_id = ?`).run(summary.project_id ?? existing.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, normalized.capture_state, normalized.recent_tool_names, normalized.hot_files, normalized.recent_outcomes, now, summary.session_id);
     return this.getSessionSummary(summary.session_id);
   }
   getSessionSummary(sessionId) {

package/dist/hooks/session-start.js

@@ -477,6 +477,16 @@ function normalizeItem(value) {
 function tokenizeProjectHint(text) {
   return Array.from(new Set((text.toLowerCase().match(/[a-z0-9_+-]{4,}/g) ?? []).filter(Boolean)));
 }
+function parseSummaryJsonList(value) {
+  if (!value)
+    return [];
+  try {
+    const parsed = JSON.parse(value);
+    return Array.isArray(parsed) ? parsed.filter((item) => typeof item === "string" && item.trim().length > 0) : [];
+  } catch {
+    return [];
+  }
+}
 function isObservationRelatedToProject(obs, detected) {
   const hints = new Set([
     ...tokenizeProjectHint(detected.name),
@@ -608,7 +618,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);
+    const recentOutcomes2 = isNewProject ? undefined : getRecentOutcomes(db, projectId, opts.userId, recentSessions2);
     return {
       project_name: projectName,
       canonical_id: canonicalId,
@@ -646,7 +656,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);
+  const recentOutcomes = isNewProject ? undefined : getRecentOutcomes(db, projectId, opts.userId, recentSessions);
   let securityFindings = [];
   if (!isNewProject) {
     try {
@@ -989,7 +999,7 @@ function getProjectTypeCounts(db, projectId, userId) {
   }
   return counts;
 }
-function getRecentOutcomes(db, projectId, userId) {
+function getRecentOutcomes(db, projectId, userId, recentSessions) {
   const visibilityClause = userId ? " AND (sensitivity != 'personal' OR user_id = ?)" : "";
   const visibilityParams = userId ? [userId] : [];
   const summaries = db.db.query(`SELECT * FROM session_summaries
@@ -999,6 +1009,15 @@ function getRecentOutcomes(db, projectId, userId) {
   const picked = [];
   const seen = new Set;
   for (const summary of summaries) {
+    for (const item of parseSummaryJsonList(summary.recent_outcomes)) {
+      const normalized = item.toLowerCase().replace(/\s+/g, " ").trim();
+      if (!normalized || seen.has(normalized))
+        continue;
+      seen.add(normalized);
+      picked.push(item);
+      if (picked.length >= 5)
+        return picked;
+    }
     for (const line of [
       ...extractMeaningfulLines(summary.completed, 2),
       ...extractMeaningfulLines(summary.learned, 1)
@@ -1012,6 +1031,17 @@ function getRecentOutcomes(db, projectId, userId) {
         return picked;
     }
   }
+  for (const session of recentSessions ?? []) {
+    for (const item of parseSummaryJsonList(session.recent_outcomes)) {
+      const normalized = item.toLowerCase().replace(/\s+/g, " ").trim();
+      if (!normalized || seen.has(normalized))
+        continue;
+      seen.add(normalized);
+      picked.push(item);
+      if (picked.length >= 5)
+        return picked;
+    }
+  }
   const rows = db.db.query(`SELECT * FROM observations
        WHERE project_id = ?
          AND lifecycle IN ('active', 'aging', 'pinned')
@@ -1154,7 +1184,7 @@ import { existsSync as existsSync3, readFileSync as readFileSync2, writeFileSync
 import { join as join3 } from "node:path";
 import { homedir } from "node:os";
 var STATE_PATH = join3(homedir(), ".engrm", "config-fingerprint.json");
-var CLIENT_VERSION = "0.4.19";
+var CLIENT_VERSION = "0.4.21";
 function hashFile(filePath) {
   try {
     if (!existsSync3(filePath))
@@ -1696,10 +1726,20 @@ function mergeRemoteSummary(db, config, change, projectId) {
     investigated: typeof change.metadata?.investigated === "string" ? change.metadata.investigated : null,
     learned: typeof change.metadata?.learned === "string" ? change.metadata.learned : null,
     completed: typeof change.metadata?.completed === "string" ? change.metadata.completed : null,
-    next_steps: typeof change.metadata?.next_steps === "string" ? change.metadata.next_steps : null
+    next_steps: typeof change.metadata?.next_steps === "string" ? change.metadata.next_steps : null,
+    capture_state: typeof change.metadata?.capture_state === "string" ? change.metadata.capture_state : null,
+    recent_tool_names: encodeStringArray(change.metadata?.recent_tool_names),
+    hot_files: encodeStringArray(change.metadata?.hot_files),
+    recent_outcomes: encodeStringArray(change.metadata?.recent_outcomes)
   });
   return Boolean(summary);
 }
+function encodeStringArray(value) {
+  if (!Array.isArray(value))
+    return null;
+  const normalized = value.filter((item) => typeof item === "string").map((item) => item.trim()).filter(Boolean);
+  return normalized.length > 0 ? JSON.stringify(normalized) : null;
+}
 function normalizeRemoteObservationType(rawType, sourceId) {
   const type = typeof rawType === "string" ? rawType.trim().toLowerCase() : "";
   if (type === "bugfix" || type === "discovery" || type === "decision" || type === "pattern" || type === "change" || type === "feature" || type === "refactor" || type === "digest" || type === "standard" || type === "message") {
@@ -2246,6 +2286,16 @@ var MIGRATIONS = [
         ON tool_events(created_at_epoch DESC, id DESC);
     `
   },
+  {
+    version: 11,
+    description: "Add synced handoff metadata to session summaries",
+    sql: `
+      ALTER TABLE session_summaries ADD COLUMN capture_state TEXT;
+      ALTER TABLE session_summaries ADD COLUMN recent_tool_names TEXT;
+      ALTER TABLE session_summaries ADD COLUMN hot_files TEXT;
+      ALTER TABLE session_summaries ADD COLUMN recent_outcomes TEXT;
+    `
+  },
   {
     version: 11,
     description: "Add observation provenance from tool and prompt chronology",
@@ -2689,6 +2739,10 @@ class MemDatabase {
              p.name AS project_name,
              ss.request AS request,
              ss.completed AS completed,
+             ss.capture_state AS capture_state,
+             ss.recent_tool_names AS recent_tool_names,
+             ss.hot_files AS hot_files,
+             ss.recent_outcomes AS recent_outcomes,
              (SELECT COUNT(*) FROM user_prompts up WHERE up.session_id = s.session_id) AS prompt_count,
              (SELECT COUNT(*) FROM tool_events te WHERE te.session_id = s.session_id) AS tool_event_count
            FROM sessions s
@@ -2703,6 +2757,10 @@ class MemDatabase {
            p.name AS project_name,
            ss.request AS request,
            ss.completed AS completed,
+           ss.capture_state AS capture_state,
+           ss.recent_tool_names AS recent_tool_names,
+           ss.hot_files AS hot_files,
+           ss.recent_outcomes AS recent_outcomes,
            (SELECT COUNT(*) FROM user_prompts up WHERE up.session_id = s.session_id) AS prompt_count,
            (SELECT COUNT(*) FROM tool_events te WHERE te.session_id = s.session_id) AS tool_event_count
          FROM sessions s
@@ -2875,8 +2933,11 @@ class MemDatabase {
       completed: normalizeSummarySection(summary.completed),
       next_steps: normalizeSummarySection(summary.next_steps)
     };
-    const result = this.db.query(`INSERT INTO session_summaries (session_id, project_id, user_id, request, investigated, learned, completed, next_steps, created_at_epoch)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, now);
+    const result = this.db.query(`INSERT INTO session_summaries (
+          session_id, project_id, user_id, request, investigated, learned, completed, next_steps,
+          capture_state, recent_tool_names, hot_files, recent_outcomes, created_at_epoch
+        )
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, summary.capture_state ?? null, summary.recent_tool_names ?? null, summary.hot_files ?? null, summary.recent_outcomes ?? null, now);
     const id = Number(result.lastInsertRowid);
     return this.db.query("SELECT * FROM session_summaries WHERE id = ?").get(id);
   }
@@ -2891,7 +2952,11 @@ class MemDatabase {
       investigated: normalizeSummarySection(summary.investigated ?? existing.investigated),
       learned: normalizeSummarySection(summary.learned ?? existing.learned),
       completed: normalizeSummarySection(summary.completed ?? existing.completed),
-      next_steps: normalizeSummarySection(summary.next_steps ?? existing.next_steps)
+      next_steps: normalizeSummarySection(summary.next_steps ?? existing.next_steps),
+      capture_state: summary.capture_state ?? existing.capture_state,
+      recent_tool_names: summary.recent_tool_names ?? existing.recent_tool_names,
+      hot_files: summary.hot_files ?? existing.hot_files,
+      recent_outcomes: summary.recent_outcomes ?? existing.recent_outcomes
     };
     this.db.query(`UPDATE session_summaries
          SET project_id = ?,
@@ -2901,8 +2966,12 @@ class MemDatabase {
              learned = ?,
              completed = ?,
              next_steps = ?,
+             capture_state = ?,
+             recent_tool_names = ?,
+             hot_files = ?,
+             recent_outcomes = ?,
              created_at_epoch = ?
-         WHERE session_id = ?`).run(summary.project_id ?? existing.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, now, summary.session_id);
+         WHERE session_id = ?`).run(summary.project_id ?? existing.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, normalized.capture_state, normalized.recent_tool_names, normalized.hot_files, normalized.recent_outcomes, now, summary.session_id);
     return this.getSessionSummary(summary.session_id);
   }
   getSessionSummary(sessionId) {
@@ -3450,10 +3519,13 @@ function duplicatesPromptLine(request, promptLine) {
   return normalizeStartupItem(request) === normalizeStartupItem(promptBody);
 }
 function buildToolFallbacks(context) {
-  return (context.recentToolEvents ?? []).slice(0, 3).map((tool) => {
+  const fromEvents = (context.recentToolEvents ?? []).slice(0, 3).map((tool) => {
     const detail = tool.file_path ?? tool.command ?? tool.tool_response_preview ?? "";
     return `${tool.tool_name}${detail ? `: ${detail}` : ""}`.trim();
   }).filter((item) => item.length > 0);
+  if (fromEvents.length > 0)
+    return fromEvents;
+  return (context.recentSessions ?? []).flatMap((session) => parseSessionJsonList(session.recent_tool_names)).slice(0, 3).filter((item) => item.length > 0);
 }
 function sessionFallbacksFromContext(context) {
   return (context.recentSessions ?? []).slice(0, 2).map((session) => {
@@ -3479,6 +3551,19 @@ function buildRecentOutcomeLines(context, summary) {
   };
   push(summary?.completed);
   push(summary?.learned);
+  if (picked.length < 2) {
+    for (const session of context.recentSessions ?? []) {
+      for (const item of parseSessionJsonList(session.recent_outcomes)) {
+        const normalized = normalizeStartupItem(item);
+        if (!normalized || seen.has(normalized))
+          continue;
+        seen.add(normalized);
+        picked.push(item);
+        if (picked.length >= 2)
+          return picked;
+      }
+    }
+  }
   if (picked.length < 2) {
     for (const obs of context.observations) {
       if (!["bugfix", "feature", "refactor", "change", "decision"].includes(obs.type))
@@ -3508,6 +3593,16 @@ function chooseMeaningfulSessionSummary(request, completed) {
   }
   return request ?? completed ?? null;
 }
+function parseSessionJsonList(value) {
+  if (!value)
+    return [];
+  try {
+    const parsed = JSON.parse(value);
+    return Array.isArray(parsed) ? parsed.filter((item) => typeof item === "string" && item.trim().length > 0) : [];
+  } catch {
+    return [];
+  }
+}
 function buildProjectSignalLine(context) {
   if (!context.projectTypeCounts)
     return null;

package/dist/hooks/stop.js

@@ -883,6 +883,16 @@ var MIGRATIONS = [
         ON tool_events(created_at_epoch DESC, id DESC);
     `
   },
+  {
+    version: 11,
+    description: "Add synced handoff metadata to session summaries",
+    sql: `
+      ALTER TABLE session_summaries ADD COLUMN capture_state TEXT;
+      ALTER TABLE session_summaries ADD COLUMN recent_tool_names TEXT;
+      ALTER TABLE session_summaries ADD COLUMN hot_files TEXT;
+      ALTER TABLE session_summaries ADD COLUMN recent_outcomes TEXT;
+    `
+  },
   {
     version: 11,
     description: "Add observation provenance from tool and prompt chronology",
@@ -1326,6 +1336,10 @@ class MemDatabase {
              p.name AS project_name,
              ss.request AS request,
              ss.completed AS completed,
+             ss.capture_state AS capture_state,
+             ss.recent_tool_names AS recent_tool_names,
+             ss.hot_files AS hot_files,
+             ss.recent_outcomes AS recent_outcomes,
              (SELECT COUNT(*) FROM user_prompts up WHERE up.session_id = s.session_id) AS prompt_count,
              (SELECT COUNT(*) FROM tool_events te WHERE te.session_id = s.session_id) AS tool_event_count
            FROM sessions s
@@ -1340,6 +1354,10 @@ class MemDatabase {
            p.name AS project_name,
            ss.request AS request,
            ss.completed AS completed,
+           ss.capture_state AS capture_state,
+           ss.recent_tool_names AS recent_tool_names,
+           ss.hot_files AS hot_files,
+           ss.recent_outcomes AS recent_outcomes,
            (SELECT COUNT(*) FROM user_prompts up WHERE up.session_id = s.session_id) AS prompt_count,
            (SELECT COUNT(*) FROM tool_events te WHERE te.session_id = s.session_id) AS tool_event_count
          FROM sessions s
@@ -1512,8 +1530,11 @@ class MemDatabase {
       completed: normalizeSummarySection(summary.completed),
       next_steps: normalizeSummarySection(summary.next_steps)
     };
-    const result = this.db.query(`INSERT INTO session_summaries (session_id, project_id, user_id, request, investigated, learned, completed, next_steps, created_at_epoch)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, now);
+    const result = this.db.query(`INSERT INTO session_summaries (
+          session_id, project_id, user_id, request, investigated, learned, completed, next_steps,
+          capture_state, recent_tool_names, hot_files, recent_outcomes, created_at_epoch
+        )
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, summary.capture_state ?? null, summary.recent_tool_names ?? null, summary.hot_files ?? null, summary.recent_outcomes ?? null, now);
     const id = Number(result.lastInsertRowid);
     return this.db.query("SELECT * FROM session_summaries WHERE id = ?").get(id);
   }
@@ -1528,7 +1549,11 @@ class MemDatabase {
       investigated: normalizeSummarySection(summary.investigated ?? existing.investigated),
       learned: normalizeSummarySection(summary.learned ?? existing.learned),
       completed: normalizeSummarySection(summary.completed ?? existing.completed),
-      next_steps: normalizeSummarySection(summary.next_steps ?? existing.next_steps)
+      next_steps: normalizeSummarySection(summary.next_steps ?? existing.next_steps),
+      capture_state: summary.capture_state ?? existing.capture_state,
+      recent_tool_names: summary.recent_tool_names ?? existing.recent_tool_names,
+      hot_files: summary.hot_files ?? existing.hot_files,
+      recent_outcomes: summary.recent_outcomes ?? existing.recent_outcomes
     };
     this.db.query(`UPDATE session_summaries
          SET project_id = ?,
@@ -1538,8 +1563,12 @@ class MemDatabase {
              learned = ?,
              completed = ?,
              next_steps = ?,
+             capture_state = ?,
+             recent_tool_names = ?,
+             hot_files = ?,
+             recent_outcomes = ?,
              created_at_epoch = ?
-         WHERE session_id = ?`).run(summary.project_id ?? existing.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, now, summary.session_id);
+         WHERE session_id = ?`).run(summary.project_id ?? existing.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, normalized.capture_state, normalized.recent_tool_names, normalized.hot_files, normalized.recent_outcomes, now, summary.session_id);
     return this.getSessionSummary(summary.session_id);
   }
   getSessionSummary(sessionId) {
@@ -2558,7 +2587,7 @@ function buildBeacon(db, config, sessionId, metrics) {
     sentinel_used: valueSignals.security_findings_count > 0,
     risk_score: riskScore,
     stacks_detected: stacks,
-    client_version: "0.4.19",
+    client_version: "0.4.21",
     context_observations_injected: metrics?.contextObsInjected ?? 0,
     context_total_available: metrics?.contextTotalAvailable ?? 0,
     recall_attempts: metrics?.recallAttempts ?? 0,

package/dist/hooks/user-prompt-submit.js

@@ -714,6 +714,16 @@ var MIGRATIONS = [
         ON tool_events(created_at_epoch DESC, id DESC);
     `
   },
+  {
+    version: 11,
+    description: "Add synced handoff metadata to session summaries",
+    sql: `
+      ALTER TABLE session_summaries ADD COLUMN capture_state TEXT;
+      ALTER TABLE session_summaries ADD COLUMN recent_tool_names TEXT;
+      ALTER TABLE session_summaries ADD COLUMN hot_files TEXT;
+      ALTER TABLE session_summaries ADD COLUMN recent_outcomes TEXT;
+    `
+  },
   {
     version: 11,
     description: "Add observation provenance from tool and prompt chronology",
@@ -1237,6 +1247,10 @@ class MemDatabase {
              p.name AS project_name,
              ss.request AS request,
              ss.completed AS completed,
+             ss.capture_state AS capture_state,
+             ss.recent_tool_names AS recent_tool_names,
+             ss.hot_files AS hot_files,
+             ss.recent_outcomes AS recent_outcomes,
              (SELECT COUNT(*) FROM user_prompts up WHERE up.session_id = s.session_id) AS prompt_count,
              (SELECT COUNT(*) FROM tool_events te WHERE te.session_id = s.session_id) AS tool_event_count
            FROM sessions s
@@ -1251,6 +1265,10 @@ class MemDatabase {
            p.name AS project_name,
            ss.request AS request,
            ss.completed AS completed,
+           ss.capture_state AS capture_state,
+           ss.recent_tool_names AS recent_tool_names,
+           ss.hot_files AS hot_files,
+           ss.recent_outcomes AS recent_outcomes,
            (SELECT COUNT(*) FROM user_prompts up WHERE up.session_id = s.session_id) AS prompt_count,
            (SELECT COUNT(*) FROM tool_events te WHERE te.session_id = s.session_id) AS tool_event_count
          FROM sessions s
@@ -1423,8 +1441,11 @@ class MemDatabase {
       completed: normalizeSummarySection(summary.completed),
       next_steps: normalizeSummarySection(summary.next_steps)
     };
-    const result = this.db.query(`INSERT INTO session_summaries (session_id, project_id, user_id, request, investigated, learned, completed, next_steps, created_at_epoch)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, now);
+    const result = this.db.query(`INSERT INTO session_summaries (
+          session_id, project_id, user_id, request, investigated, learned, completed, next_steps,
+          capture_state, recent_tool_names, hot_files, recent_outcomes, created_at_epoch
+        )
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, summary.capture_state ?? null, summary.recent_tool_names ?? null, summary.hot_files ?? null, summary.recent_outcomes ?? null, now);
     const id = Number(result.lastInsertRowid);
     return this.db.query("SELECT * FROM session_summaries WHERE id = ?").get(id);
   }
@@ -1439,7 +1460,11 @@ class MemDatabase {
       investigated: normalizeSummarySection(summary.investigated ?? existing.investigated),
       learned: normalizeSummarySection(summary.learned ?? existing.learned),
       completed: normalizeSummarySection(summary.completed ?? existing.completed),
-      next_steps: normalizeSummarySection(summary.next_steps ?? existing.next_steps)
+      next_steps: normalizeSummarySection(summary.next_steps ?? existing.next_steps),
+      capture_state: summary.capture_state ?? existing.capture_state,
+      recent_tool_names: summary.recent_tool_names ?? existing.recent_tool_names,
+      hot_files: summary.hot_files ?? existing.hot_files,
+      recent_outcomes: summary.recent_outcomes ?? existing.recent_outcomes
     };
     this.db.query(`UPDATE session_summaries
          SET project_id = ?,
@@ -1449,8 +1474,12 @@ class MemDatabase {
              learned = ?,
              completed = ?,
              next_steps = ?,
+             capture_state = ?,
+             recent_tool_names = ?,
+             hot_files = ?,
+             recent_outcomes = ?,
              created_at_epoch = ?
-         WHERE session_id = ?`).run(summary.project_id ?? existing.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, now, summary.session_id);
+         WHERE session_id = ?`).run(summary.project_id ?? existing.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, normalized.capture_state, normalized.recent_tool_names, normalized.hot_files, normalized.recent_outcomes, now, summary.session_id);
     return this.getSessionSummary(summary.session_id);
   }
   getSessionSummary(sessionId) {

package/dist/server.js

@@ -14120,6 +14120,16 @@ var MIGRATIONS = [
         ON tool_events(created_at_epoch DESC, id DESC);
     `
   },
+  {
+    version: 11,
+    description: "Add synced handoff metadata to session summaries",
+    sql: `
+      ALTER TABLE session_summaries ADD COLUMN capture_state TEXT;
+      ALTER TABLE session_summaries ADD COLUMN recent_tool_names TEXT;
+      ALTER TABLE session_summaries ADD COLUMN hot_files TEXT;
+      ALTER TABLE session_summaries ADD COLUMN recent_outcomes TEXT;
+    `
+  },
   {
     version: 11,
     description: "Add observation provenance from tool and prompt chronology",
@@ -14647,6 +14657,10 @@ class MemDatabase {
              p.name AS project_name,
              ss.request AS request,
              ss.completed AS completed,
+             ss.capture_state AS capture_state,
+             ss.recent_tool_names AS recent_tool_names,
+             ss.hot_files AS hot_files,
+             ss.recent_outcomes AS recent_outcomes,
              (SELECT COUNT(*) FROM user_prompts up WHERE up.session_id = s.session_id) AS prompt_count,
              (SELECT COUNT(*) FROM tool_events te WHERE te.session_id = s.session_id) AS tool_event_count
            FROM sessions s
@@ -14661,6 +14675,10 @@ class MemDatabase {
            p.name AS project_name,
            ss.request AS request,
            ss.completed AS completed,
+           ss.capture_state AS capture_state,
+           ss.recent_tool_names AS recent_tool_names,
+           ss.hot_files AS hot_files,
+           ss.recent_outcomes AS recent_outcomes,
            (SELECT COUNT(*) FROM user_prompts up WHERE up.session_id = s.session_id) AS prompt_count,
            (SELECT COUNT(*) FROM tool_events te WHERE te.session_id = s.session_id) AS tool_event_count
          FROM sessions s
@@ -14833,8 +14851,11 @@ class MemDatabase {
       completed: normalizeSummarySection(summary.completed),
       next_steps: normalizeSummarySection(summary.next_steps)
     };
-    const result = this.db.query(`INSERT INTO session_summaries (session_id, project_id, user_id, request, investigated, learned, completed, next_steps, created_at_epoch)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, now);
+    const result = this.db.query(`INSERT INTO session_summaries (
+          session_id, project_id, user_id, request, investigated, learned, completed, next_steps,
+          capture_state, recent_tool_names, hot_files, recent_outcomes, created_at_epoch
+        )
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, summary.capture_state ?? null, summary.recent_tool_names ?? null, summary.hot_files ?? null, summary.recent_outcomes ?? null, now);
     const id = Number(result.lastInsertRowid);
     return this.db.query("SELECT * FROM session_summaries WHERE id = ?").get(id);
   }
@@ -14849,7 +14870,11 @@ class MemDatabase {
       investigated: normalizeSummarySection(summary.investigated ?? existing.investigated),
       learned: normalizeSummarySection(summary.learned ?? existing.learned),
       completed: normalizeSummarySection(summary.completed ?? existing.completed),
-      next_steps: normalizeSummarySection(summary.next_steps ?? existing.next_steps)
+      next_steps: normalizeSummarySection(summary.next_steps ?? existing.next_steps),
+      capture_state: summary.capture_state ?? existing.capture_state,
+      recent_tool_names: summary.recent_tool_names ?? existing.recent_tool_names,
+      hot_files: summary.hot_files ?? existing.hot_files,
+      recent_outcomes: summary.recent_outcomes ?? existing.recent_outcomes
     };
     this.db.query(`UPDATE session_summaries
          SET project_id = ?,
@@ -14859,8 +14884,12 @@ class MemDatabase {
              learned = ?,
              completed = ?,
              next_steps = ?,
+             capture_state = ?,
+             recent_tool_names = ?,
+             hot_files = ?,
+             recent_outcomes = ?,
              created_at_epoch = ?
-         WHERE session_id = ?`).run(summary.project_id ?? existing.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, now, summary.session_id);
+         WHERE session_id = ?`).run(summary.project_id ?? existing.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, normalized.capture_state, normalized.recent_tool_names, normalized.hot_files, normalized.recent_outcomes, now, summary.session_id);
     return this.getSessionSummary(summary.session_id);
   }
   getSessionSummary(sessionId) {
@@ -16460,6 +16489,16 @@ function findStaleDecisionsGlobal(db, options) {
 function tokenizeProjectHint(text) {
   return Array.from(new Set((text.toLowerCase().match(/[a-z0-9_+-]{4,}/g) ?? []).filter(Boolean)));
 }
+function parseSummaryJsonList(value) {
+  if (!value)
+    return [];
+  try {
+    const parsed = JSON.parse(value);
+    return Array.isArray(parsed) ? parsed.filter((item) => typeof item === "string" && item.trim().length > 0) : [];
+  } catch {
+    return [];
+  }
+}
 function isObservationRelatedToProject(obs, detected) {
   const hints = new Set([
     ...tokenizeProjectHint(detected.name),
@@ -16591,7 +16630,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);
+    const recentOutcomes2 = isNewProject ? undefined : getRecentOutcomes(db, projectId, opts.userId, recentSessions2);
     return {
       project_name: projectName,
       canonical_id: canonicalId,
@@ -16629,7 +16668,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);
+  const recentOutcomes = isNewProject ? undefined : getRecentOutcomes(db, projectId, opts.userId, recentSessions);
   let securityFindings = [];
   if (!isNewProject) {
     try {
@@ -16972,7 +17011,7 @@ function getProjectTypeCounts(db, projectId, userId) {
   }
   return counts;
 }
-function getRecentOutcomes(db, projectId, userId) {
+function getRecentOutcomes(db, projectId, userId, recentSessions) {
   const visibilityClause = userId ? " AND (sensitivity != 'personal' OR user_id = ?)" : "";
   const visibilityParams = userId ? [userId] : [];
   const summaries = db.db.query(`SELECT * FROM session_summaries
@@ -16982,6 +17021,15 @@ function getRecentOutcomes(db, projectId, userId) {
   const picked = [];
   const seen = new Set;
   for (const summary of summaries) {
+    for (const item of parseSummaryJsonList(summary.recent_outcomes)) {
+      const normalized = item.toLowerCase().replace(/\s+/g, " ").trim();
+      if (!normalized || seen.has(normalized))
+        continue;
+      seen.add(normalized);
+      picked.push(item);
+      if (picked.length >= 5)
+        return picked;
+    }
     for (const line of [
       ...extractMeaningfulLines(summary.completed, 2),
       ...extractMeaningfulLines(summary.learned, 1)
@@ -16995,6 +17043,17 @@ function getRecentOutcomes(db, projectId, userId) {
         return picked;
     }
   }
+  for (const session of recentSessions ?? []) {
+    for (const item of parseSummaryJsonList(session.recent_outcomes)) {
+      const normalized = item.toLowerCase().replace(/\s+/g, " ").trim();
+      if (!normalized || seen.has(normalized))
+        continue;
+      seen.add(normalized);
+      picked.push(item);
+      if (picked.length >= 5)
+        return picked;
+    }
+  }
   const rows = db.db.query(`SELECT * FROM observations
        WHERE project_id = ?
          AND lifecycle IN ('active', 'aging', 'pinned')
@@ -19011,10 +19070,20 @@ function mergeRemoteSummary(db, config2, change, projectId) {
     investigated: typeof change.metadata?.investigated === "string" ? change.metadata.investigated : null,
     learned: typeof change.metadata?.learned === "string" ? change.metadata.learned : null,
     completed: typeof change.metadata?.completed === "string" ? change.metadata.completed : null,
-    next_steps: typeof change.metadata?.next_steps === "string" ? change.metadata.next_steps : null
+    next_steps: typeof change.metadata?.next_steps === "string" ? change.metadata.next_steps : null,
+    capture_state: typeof change.metadata?.capture_state === "string" ? change.metadata.capture_state : null,
+    recent_tool_names: encodeStringArray(change.metadata?.recent_tool_names),
+    hot_files: encodeStringArray(change.metadata?.hot_files),
+    recent_outcomes: encodeStringArray(change.metadata?.recent_outcomes)
   });
   return Boolean(summary);
 }
+function encodeStringArray(value) {
+  if (!Array.isArray(value))
+    return null;
+  const normalized = value.filter((item) => typeof item === "string").map((item) => item.trim()).filter(Boolean);
+  return normalized.length > 0 ? JSON.stringify(normalized) : null;
+}
 function normalizeRemoteObservationType(rawType, sourceId) {
   const type = typeof rawType === "string" ? rawType.trim().toLowerCase() : "";
   if (type === "bugfix" || type === "discovery" || type === "decision" || type === "pattern" || type === "change" || type === "feature" || type === "refactor" || type === "digest" || type === "standard" || type === "message") {
@@ -19817,7 +19886,7 @@ process.on("SIGTERM", () => {
 });
 var server = new McpServer({
   name: "engrm",
-  version: "0.4.19"
+  version: "0.4.21"
 });
 server.tool("save_observation", "Save an observation to memory", {
   type: exports_external.enum([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "engrm",
-  "version": "0.4.19",
+  "version": "0.4.21",
   "description": "Shared memory across devices, sessions, and coding agents",
   "mcpName": "io.github.dr12hes/engrm",
   "type": "module",