engrm 0.4.19 → 0.4.22

package/dist/server.js

@@ -14120,6 +14120,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",
@@ -14186,6 +14196,9 @@ function inferLegacySchemaVersion(db) {
     version2 = Math.max(version2, 10);
   if (columnExists(db, "observations", "source_tool"))
     version2 = Math.max(version2, 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")) {
+    version2 = Math.max(version2, 12);
+  }
   return version2;
 }
 function runMigrations(db) {
@@ -14264,6 +14277,23 @@ function ensureObservationTypes(db) {
     }
   }
 }
+function ensureSessionSummaryColumns(db) {
+  const required2 = [
+    "capture_state",
+    "recent_tool_names",
+    "hot_files",
+    "recent_outcomes"
+  ];
+  for (const column of required2) {
+    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;
@@ -14422,6 +14452,7 @@ class MemDatabase {
     this.vecAvailable = this.loadVecExtension();
     runMigrations(this.db);
     ensureObservationTypes(this.db);
+    ensureSessionSummaryColumns(this.db);
   }
   loadVecExtension() {
     try {
@@ -14647,6 +14678,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 +14696,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 +14872,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 +14891,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 +14905,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 +16510,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 +16651,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 +16689,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 +17032,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 +17042,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 +17064,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')
@@ -18653,6 +18733,50 @@ class VectorApiError extends Error {
   }
 }
 
+// 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) => [
+    ...parseJsonArray3(obs.files_modified),
+    ...parseJsonArray3(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 parseJsonArray3(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 [];
+  }
+}
+
 // src/sync/push.ts
 function buildVectorDocument(obs, config2, project) {
   const parts = [obs.title];
@@ -18793,7 +18917,7 @@ async function pushOutbox(db, client, config2, batchSize = 50) {
       const doc3 = buildSummaryVectorDocument(summary, config2, {
         canonical_id: project2.canonical_id,
         name: project2.name
-      }, summaryObservations, buildSummaryCaptureContext(sessionPrompts, sessionToolEvents, summaryObservations));
+      }, summaryObservations, buildSessionHandoffMetadata(sessionPrompts, sessionToolEvents, summaryObservations));
       batch.push({ entryId: entry.id, doc: doc3 });
       continue;
     }
@@ -18864,48 +18988,6 @@ function countPresentSections2(summary) {
 function extractSectionItems2(section) {
   return extractSummaryItems(section, 4);
 }
-function buildSummaryCaptureContext(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) => [
-    ...parseJsonArray3(obs.files_modified),
-    ...parseJsonArray3(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 parseJsonArray3(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 [];
-  }
-}
 
 // src/sync/pull.ts
 var PULL_CURSOR_KEY = "pull_cursor";
@@ -19011,10 +19093,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 +19909,7 @@ process.on("SIGTERM", () => {
 });
 var server = new McpServer({
   name: "engrm",
-  version: "0.4.19"
+  version: "0.4.22"
 });
 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.22",
   "description": "Shared memory across devices, sessions, and coding agents",
   "mcpName": "io.github.dr12hes/engrm",
   "type": "module",