engrm 0.4.19 → 0.4.22

package/dist/cli.js

@@ -598,6 +598,16 @@ var MIGRATIONS = [
         ON tool_events(created_at_epoch DESC, id DESC);
     `
   },
+  {
+    version: 12,
+    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",
@@ -664,6 +674,9 @@ function inferLegacySchemaVersion(db) {
     version = Math.max(version, 10);
   if (columnExists(db, "observations", "source_tool"))
     version = Math.max(version, 11);
+  if (columnExists(db, "session_summaries", "capture_state") && columnExists(db, "session_summaries", "recent_tool_names") && columnExists(db, "session_summaries", "hot_files") && columnExists(db, "session_summaries", "recent_outcomes")) {
+    version = Math.max(version, 12);
+  }
   return version;
 }
 function runMigrations(db) {
@@ -742,6 +755,23 @@ function ensureObservationTypes(db) {
     }
   }
 }
+function ensureSessionSummaryColumns(db) {
+  const required = [
+    "capture_state",
+    "recent_tool_names",
+    "hot_files",
+    "recent_outcomes"
+  ];
+  for (const column of required) {
+    if (columnExists(db, "session_summaries", column))
+      continue;
+    db.exec(`ALTER TABLE session_summaries ADD COLUMN ${column} TEXT`);
+  }
+  const current = getSchemaVersion(db);
+  if (current < 12) {
+    db.exec("PRAGMA user_version = 12");
+  }
+}
 function getSchemaVersion(db) {
   const result = db.query("PRAGMA user_version").get();
   return result.user_version;
@@ -900,6 +930,7 @@ class MemDatabase {
     this.vecAvailable = this.loadVecExtension();
     runMigrations(this.db);
     ensureObservationTypes(this.db);
+    ensureSessionSummaryColumns(this.db);
   }
   loadVecExtension() {
     try {
@@ -1125,6 +1156,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 +1174,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 +1350,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 +1369,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 +1383,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 +1893,16 @@ var MIGRATIONS2 = [
         ON tool_events(created_at_epoch DESC, id DESC);
     `
   },
+  {
+    version: 12,
+    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: 12,
+    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",
@@ -1497,6 +1507,9 @@ function inferLegacySchemaVersion(db) {
     version = Math.max(version, 10);
   if (columnExists(db, "observations", "source_tool"))
     version = Math.max(version, 11);
+  if (columnExists(db, "session_summaries", "capture_state") && columnExists(db, "session_summaries", "recent_tool_names") && columnExists(db, "session_summaries", "hot_files") && columnExists(db, "session_summaries", "recent_outcomes")) {
+    version = Math.max(version, 12);
+  }
   return version;
 }
 function runMigrations(db) {
@@ -1575,6 +1588,27 @@ function ensureObservationTypes(db) {
     }
   }
 }
+function ensureSessionSummaryColumns(db) {
+  const required = [
+    "capture_state",
+    "recent_tool_names",
+    "hot_files",
+    "recent_outcomes"
+  ];
+  for (const column of required) {
+    if (columnExists(db, "session_summaries", column))
+      continue;
+    db.exec(`ALTER TABLE session_summaries ADD COLUMN ${column} TEXT`);
+  }
+  const current = getSchemaVersion(db);
+  if (current < 12) {
+    db.exec("PRAGMA user_version = 12");
+  }
+}
+function getSchemaVersion(db) {
+  const result = db.query("PRAGMA user_version").get();
+  return result.user_version;
+}
 var LATEST_SCHEMA_VERSION = MIGRATIONS.filter((m) => !m.condition).reduce((max, m) => Math.max(max, m.version), 0);
 
 // src/storage/sqlite.ts
@@ -1729,6 +1763,7 @@ class MemDatabase {
     this.vecAvailable = this.loadVecExtension();
     runMigrations(this.db);
     ensureObservationTypes(this.db);
+    ensureSessionSummaryColumns(this.db);
   }
   loadVecExtension() {
     try {
@@ -1954,6 +1989,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 +2007,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 +2183,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 +2202,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 +2216,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: 12,
+    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",
@@ -842,6 +852,9 @@ function inferLegacySchemaVersion(db) {
     version = Math.max(version, 10);
   if (columnExists(db, "observations", "source_tool"))
     version = Math.max(version, 11);
+  if (columnExists(db, "session_summaries", "capture_state") && columnExists(db, "session_summaries", "recent_tool_names") && columnExists(db, "session_summaries", "hot_files") && columnExists(db, "session_summaries", "recent_outcomes")) {
+    version = Math.max(version, 12);
+  }
   return version;
 }
 function runMigrations(db) {
@@ -920,6 +933,27 @@ function ensureObservationTypes(db) {
     }
   }
 }
+function ensureSessionSummaryColumns(db) {
+  const required = [
+    "capture_state",
+    "recent_tool_names",
+    "hot_files",
+    "recent_outcomes"
+  ];
+  for (const column of required) {
+    if (columnExists(db, "session_summaries", column))
+      continue;
+    db.exec(`ALTER TABLE session_summaries ADD COLUMN ${column} TEXT`);
+  }
+  const current = getSchemaVersion(db);
+  if (current < 12) {
+    db.exec("PRAGMA user_version = 12");
+  }
+}
+function getSchemaVersion(db) {
+  const result = db.query("PRAGMA user_version").get();
+  return result.user_version;
+}
 var LATEST_SCHEMA_VERSION = MIGRATIONS.filter((m) => !m.condition).reduce((max, m) => Math.max(max, m.version), 0);
 
 // src/storage/sqlite.ts
@@ -1074,6 +1108,7 @@ class MemDatabase {
     this.vecAvailable = this.loadVecExtension();
     runMigrations(this.db);
     ensureObservationTypes(this.db);
+    ensureSessionSummaryColumns(this.db);
   }
   loadVecExtension() {
     try {
@@ -1299,6 +1334,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 +1352,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 +1528,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 +1547,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 +1561,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 +3220,107 @@ 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}`;
+}
+
+// src/capture/session-handoff.ts
+function buildSessionHandoffMetadata(prompts, toolEvents, observations) {
+  const latestRequest = prompts.length > 0 ? prompts[prompts.length - 1]?.prompt ?? null : null;
+  const recentRequestPrompts = prompts.slice(-3).map((prompt) => prompt.prompt.trim()).filter(Boolean);
+  const recentToolNames = [...new Set(toolEvents.slice(-8).map((tool) => tool.tool_name).filter(Boolean))];
+  const recentToolCommands = [...new Set(toolEvents.slice(-5).map((tool) => (tool.command ?? tool.file_path ?? "").trim()).filter(Boolean))];
+  const hotFiles = [...new Set(observations.flatMap((obs) => [
+    ...parseJsonArray(obs.files_modified),
+    ...parseJsonArray(obs.files_read)
+  ]).filter(Boolean))].slice(0, 6);
+  const recentOutcomes = observations.filter((obs) => ["bugfix", "feature", "refactor", "change", "decision"].includes(obs.type)).map((obs) => obs.title.trim()).filter((title) => title.length > 0).slice(0, 6);
+  const captureState = prompts.length > 0 && toolEvents.length > 0 ? "rich" : prompts.length > 0 || toolEvents.length > 0 ? "partial" : "summary-only";
+  const observationSourceTools = Array.from(observations.reduce((acc, obs) => {
+    if (!obs.source_tool)
+      return acc;
+    acc.set(obs.source_tool, (acc.get(obs.source_tool) ?? 0) + 1);
+    return acc;
+  }, new Map).entries()).map(([tool, count]) => ({ tool, count })).sort((a, b) => b.count - a.count || a.tool.localeCompare(b.tool)).slice(0, 6);
+  const latestObservationPromptNumber = observations.map((obs) => obs.source_prompt_number).filter((value) => typeof value === "number").sort((a, b) => b - a)[0] ?? null;
+  return {
+    prompt_count: prompts.length,
+    tool_event_count: toolEvents.length,
+    recent_request_prompts: recentRequestPrompts,
+    latest_request: latestRequest,
+    recent_tool_names: recentToolNames,
+    recent_tool_commands: recentToolCommands,
+    capture_state: captureState,
+    hot_files: hotFiles,
+    recent_outcomes: recentOutcomes,
+    observation_source_tools: observationSourceTools,
+    latest_observation_prompt_number: latestObservationPromptNumber
+  };
+}
+function parseJsonArray(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 [];
+  }
+}
+
 // hooks/post-tool-use.ts
 async function main() {
   const raw = await readStdin();
@@ -3269,7 +3424,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 +3434,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 +3444,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 +3509,38 @@ 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 sessionPrompts = db.getSessionUserPrompts(event.session_id, 20);
+  const sessionToolEvents = db.getSessionToolEvents(event.session_id, 20);
+  const sessionObservations = db.getObservationsBySession(event.session_id);
+  const merged = mergeLiveSummarySections(existing, update);
+  const handoff = buildSessionHandoffMetadata(sessionPrompts, sessionToolEvents, sessionObservations);
+  const currentRequest = existing?.request ?? handoff.latest_request ?? 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,
+    capture_state: handoff.capture_state,
+    recent_tool_names: JSON.stringify(handoff.recent_tool_names),
+    hot_files: JSON.stringify(handoff.hot_files),
+    recent_outcomes: JSON.stringify(handoff.recent_outcomes)
+  });
+  db.addToOutbox("summary", summary.id);
+}
 function extractTouchedPaths(event) {
   const paths = [];
   const filePath = event.tool_input["file_path"];