engrm 0.4.46 → 0.4.48

package/dist/cli.js

@@ -1005,6 +1005,20 @@ function ensureChatMessageColumns(db) {
     db.exec("PRAGMA user_version = 17");
   }
 }
+function ensureObservationVectorTable(db) {
+  if (!isVecExtensionLoaded(db))
+    return;
+  db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS vec_observations USING vec0(
+      observation_id INTEGER PRIMARY KEY,
+      embedding FLOAT[384]
+    );
+  `);
+  const current = getSchemaVersion(db);
+  if (current < 4) {
+    db.exec("PRAGMA user_version = 4");
+  }
+}
 function ensureChatVectorTable(db) {
   if (!isVecExtensionLoaded(db))
     return;
@@ -1233,6 +1247,7 @@ class MemDatabase {
     ensureObservationTypes(this.db);
     ensureSessionSummaryColumns(this.db);
     ensureChatMessageColumns(this.db);
+    ensureObservationVectorTable(this.db);
     ensureChatVectorTable(this.db);
     ensureSyncOutboxSupportsChatMessages(this.db);
   }

package/dist/hooks/elicitation-result.js

@@ -1879,6 +1879,20 @@ function ensureChatMessageColumns(db) {
     db.exec("PRAGMA user_version = 17");
   }
 }
+function ensureObservationVectorTable(db) {
+  if (!isVecExtensionLoaded(db))
+    return;
+  db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS vec_observations USING vec0(
+      observation_id INTEGER PRIMARY KEY,
+      embedding FLOAT[384]
+    );
+  `);
+  const current = getSchemaVersion(db);
+  if (current < 4) {
+    db.exec("PRAGMA user_version = 4");
+  }
+}
 function ensureChatVectorTable(db) {
   if (!isVecExtensionLoaded(db))
     return;
@@ -2107,6 +2121,7 @@ class MemDatabase {
     ensureObservationTypes(this.db);
     ensureSessionSummaryColumns(this.db);
     ensureChatMessageColumns(this.db);
+    ensureObservationVectorTable(this.db);
     ensureChatVectorTable(this.db);
     ensureSyncOutboxSupportsChatMessages(this.db);
   }

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

@@ -1183,6 +1183,20 @@ function ensureChatMessageColumns(db) {
     db.exec("PRAGMA user_version = 17");
   }
 }
+function ensureObservationVectorTable(db) {
+  if (!isVecExtensionLoaded(db))
+    return;
+  db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS vec_observations USING vec0(
+      observation_id INTEGER PRIMARY KEY,
+      embedding FLOAT[384]
+    );
+  `);
+  const current = getSchemaVersion(db);
+  if (current < 4) {
+    db.exec("PRAGMA user_version = 4");
+  }
+}
 function ensureChatVectorTable(db) {
   if (!isVecExtensionLoaded(db))
     return;
@@ -1411,6 +1425,7 @@ class MemDatabase {
     ensureObservationTypes(this.db);
     ensureSessionSummaryColumns(this.db);
     ensureChatMessageColumns(this.db);
+    ensureObservationVectorTable(this.db);
     ensureChatVectorTable(this.db);
     ensureSyncOutboxSupportsChatMessages(this.db);
   }
@@ -4260,80 +4275,6 @@ function findTranscriptPathBySessionId(sessionId) {
   }
   return null;
 }
-function truncateTranscript(messages, maxBytes = 50000) {
-  const lines = [];
-  for (const msg of messages) {
-    lines.push(`[${msg.role}]: ${msg.text}`);
-  }
-  const full = lines.join(`
-`);
-  if (Buffer.byteLength(full, "utf-8") <= maxBytes)
-    return full;
-  let result = "";
-  for (let i = lines.length - 1;i >= 0; i--) {
-    const candidate = lines[i] + `
-` + result;
-    if (Buffer.byteLength(candidate, "utf-8") > maxBytes)
-      break;
-    result = candidate;
-  }
-  return result.trim();
-}
-async function analyzeTranscript(config, transcript, sessionId) {
-  if (!config.candengo_url || !config.candengo_api_key)
-    return null;
-  const url = `${config.candengo_url}/v1/mem/transcript-analysis`;
-  const controller = new AbortController;
-  const timeout = setTimeout(() => controller.abort(), 30000);
-  try {
-    const response = await fetch(url, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Authorization: `Bearer ${config.candengo_api_key}`
-      },
-      body: JSON.stringify({
-        transcript,
-        session_id: sessionId
-      }),
-      signal: controller.signal
-    });
-    if (!response.ok)
-      return null;
-    const data = await response.json();
-    if (!Array.isArray(data.plans) || !Array.isArray(data.decisions) || !Array.isArray(data.insights)) {
-      return null;
-    }
-    return data;
-  } catch {
-    return null;
-  } finally {
-    clearTimeout(timeout);
-  }
-}
-async function saveTranscriptResults(db, config, results, sessionId, cwd) {
-  let saved = 0;
-  const items = [
-    ...results.plans.map((item) => ({ item, type: "decision" })),
-    ...results.decisions.map((item) => ({ item, type: "decision" })),
-    ...results.insights.map((item) => ({ item, type: "discovery" }))
-  ];
-  for (const { item, type } of items) {
-    if (!item.title || item.title.trim().length === 0)
-      continue;
-    const result = await saveObservation(db, config, {
-      type,
-      title: item.title.slice(0, 80),
-      narrative: item.narrative,
-      concepts: item.concepts,
-      session_id: sessionId,
-      cwd
-    });
-    if (result.success)
-      saved++;
-  }
-  return saved;
-}
 
 // src/tools/recent-chat.ts
 function summarizeChatSources(messages) {

package/dist/hooks/pre-compact.js

@@ -977,6 +977,20 @@ function ensureChatMessageColumns(db) {
     db.exec("PRAGMA user_version = 17");
   }
 }
+function ensureObservationVectorTable(db) {
+  if (!isVecExtensionLoaded(db))
+    return;
+  db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS vec_observations USING vec0(
+      observation_id INTEGER PRIMARY KEY,
+      embedding FLOAT[384]
+    );
+  `);
+  const current = getSchemaVersion(db);
+  if (current < 4) {
+    db.exec("PRAGMA user_version = 4");
+  }
+}
 function ensureChatVectorTable(db) {
   if (!isVecExtensionLoaded(db))
     return;
@@ -1205,6 +1219,7 @@ class MemDatabase {
     ensureObservationTypes(this.db);
     ensureSessionSummaryColumns(this.db);
     ensureChatMessageColumns(this.db);
+    ensureObservationVectorTable(this.db);
     ensureChatVectorTable(this.db);
     ensureSyncOutboxSupportsChatMessages(this.db);
   }
@@ -4548,80 +4563,6 @@ function findTranscriptPathBySessionId(sessionId) {
   }
   return null;
 }
-function truncateTranscript(messages, maxBytes = 50000) {
-  const lines = [];
-  for (const msg of messages) {
-    lines.push(`[${msg.role}]: ${msg.text}`);
-  }
-  const full = lines.join(`
-`);
-  if (Buffer.byteLength(full, "utf-8") <= maxBytes)
-    return full;
-  let result = "";
-  for (let i = lines.length - 1;i >= 0; i--) {
-    const candidate = lines[i] + `
-` + result;
-    if (Buffer.byteLength(candidate, "utf-8") > maxBytes)
-      break;
-    result = candidate;
-  }
-  return result.trim();
-}
-async function analyzeTranscript(config, transcript, sessionId) {
-  if (!config.candengo_url || !config.candengo_api_key)
-    return null;
-  const url = `${config.candengo_url}/v1/mem/transcript-analysis`;
-  const controller = new AbortController;
-  const timeout = setTimeout(() => controller.abort(), 30000);
-  try {
-    const response = await fetch(url, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Authorization: `Bearer ${config.candengo_api_key}`
-      },
-      body: JSON.stringify({
-        transcript,
-        session_id: sessionId
-      }),
-      signal: controller.signal
-    });
-    if (!response.ok)
-      return null;
-    const data = await response.json();
-    if (!Array.isArray(data.plans) || !Array.isArray(data.decisions) || !Array.isArray(data.insights)) {
-      return null;
-    }
-    return data;
-  } catch {
-    return null;
-  } finally {
-    clearTimeout(timeout);
-  }
-}
-async function saveTranscriptResults(db, config, results, sessionId, cwd) {
-  let saved = 0;
-  const items = [
-    ...results.plans.map((item) => ({ item, type: "decision" })),
-    ...results.decisions.map((item) => ({ item, type: "decision" })),
-    ...results.insights.map((item) => ({ item, type: "discovery" }))
-  ];
-  for (const { item, type } of items) {
-    if (!item.title || item.title.trim().length === 0)
-      continue;
-    const result = await saveObservation(db, config, {
-      type,
-      title: item.title.slice(0, 80),
-      narrative: item.narrative,
-      concepts: item.concepts,
-      session_id: sessionId,
-      cwd
-    });
-    if (result.success)
-      saved++;
-  }
-  return saved;
-}
 
 // hooks/pre-compact.ts
 function formatCurrentSessionContext(observations) {

package/dist/hooks/sentinel.js

@@ -1053,6 +1053,20 @@ function ensureChatMessageColumns(db) {
     db.exec("PRAGMA user_version = 17");
   }
 }
+function ensureObservationVectorTable(db) {
+  if (!isVecExtensionLoaded(db))
+    return;
+  db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS vec_observations USING vec0(
+      observation_id INTEGER PRIMARY KEY,
+      embedding FLOAT[384]
+    );
+  `);
+  const current = getSchemaVersion(db);
+  if (current < 4) {
+    db.exec("PRAGMA user_version = 4");
+  }
+}
 function ensureChatVectorTable(db) {
   if (!isVecExtensionLoaded(db))
     return;
@@ -1281,6 +1295,7 @@ class MemDatabase {
     ensureObservationTypes(this.db);
     ensureSessionSummaryColumns(this.db);
     ensureChatMessageColumns(this.db);
+    ensureObservationVectorTable(this.db);
     ensureChatVectorTable(this.db);
     ensureSyncOutboxSupportsChatMessages(this.db);
   }

package/dist/hooks/session-start.js

@@ -3280,7 +3280,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.46";
+var CLIENT_VERSION = "0.4.48";
 function hashFile(filePath) {
   try {
     if (!existsSync3(filePath))
@@ -4920,6 +4920,20 @@ function ensureChatMessageColumns(db) {
     db.exec("PRAGMA user_version = 17");
   }
 }
+function ensureObservationVectorTable(db) {
+  if (!isVecExtensionLoaded(db))
+    return;
+  db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS vec_observations USING vec0(
+      observation_id INTEGER PRIMARY KEY,
+      embedding FLOAT[384]
+    );
+  `);
+  const current = getSchemaVersion(db);
+  if (current < 4) {
+    db.exec("PRAGMA user_version = 4");
+  }
+}
 function ensureChatVectorTable(db) {
   if (!isVecExtensionLoaded(db))
     return;
@@ -5068,6 +5082,7 @@ class MemDatabase {
     ensureObservationTypes(this.db);
     ensureSessionSummaryColumns(this.db);
     ensureChatMessageColumns(this.db);
+    ensureObservationVectorTable(this.db);
     ensureChatVectorTable(this.db);
     ensureSyncOutboxSupportsChatMessages(this.db);
   }

package/dist/hooks/stop.js

@@ -2,6 +2,13 @@
 import { createRequire } from "node:module";
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
+// hooks/stop.ts
+import { spawn } from "node:child_process";
+import { mkdtempSync, readFileSync as readFileSync5, rmSync, writeFileSync as writeFileSync2 } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname as dirname2, join as join6 } from "node:path";
+import { fileURLToPath } from "node:url";
+
 // src/intelligence/observation-priority.ts
 var RECENCY_WINDOW_SECONDS = 30 * 86400;
 function computeBlendedScore(quality, createdAtEpoch, nowEpoch) {
@@ -1290,6 +1297,20 @@ function ensureChatMessageColumns(db) {
     db.exec("PRAGMA user_version = 17");
   }
 }
+function ensureObservationVectorTable(db) {
+  if (!isVecExtensionLoaded(db))
+    return;
+  db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS vec_observations USING vec0(
+      observation_id INTEGER PRIMARY KEY,
+      embedding FLOAT[384]
+    );
+  `);
+  const current = getSchemaVersion(db);
+  if (current < 4) {
+    db.exec("PRAGMA user_version = 4");
+  }
+}
 function ensureChatVectorTable(db) {
   if (!isVecExtensionLoaded(db))
     return;
@@ -1438,6 +1459,7 @@ class MemDatabase {
     ensureObservationTypes(this.db);
     ensureSessionSummaryColumns(this.db);
     ensureChatMessageColumns(this.db);
+    ensureObservationVectorTable(this.db);
     ensureChatVectorTable(this.db);
     ensureSyncOutboxSupportsChatMessages(this.db);
   }
@@ -3492,7 +3514,7 @@ function buildBeacon(db, config, sessionId, metrics) {
     sentinel_used: valueSignals.security_findings_count > 0,
     risk_score: riskScore,
     stacks_detected: stacks,
-    client_version: "0.4.46",
+    client_version: "0.4.48",
     context_observations_injected: metrics?.contextObsInjected ?? 0,
     context_total_available: metrics?.contextTotalAvailable ?? 0,
     recall_attempts: metrics?.recallAttempts ?? 0,
@@ -4641,533 +4663,11 @@ function findTranscriptPathBySessionId(sessionId) {
   }
   return null;
 }
-function truncateTranscript(messages, maxBytes = 50000) {
-  const lines = [];
-  for (const msg of messages) {
-    lines.push(`[${msg.role}]: ${msg.text}`);
-  }
-  const full = lines.join(`
-`);
-  if (Buffer.byteLength(full, "utf-8") <= maxBytes)
-    return full;
-  let result = "";
-  for (let i = lines.length - 1;i >= 0; i--) {
-    const candidate = lines[i] + `
-` + result;
-    if (Buffer.byteLength(candidate, "utf-8") > maxBytes)
-      break;
-    result = candidate;
-  }
-  return result.trim();
-}
-async function analyzeTranscript(config, transcript, sessionId) {
-  if (!config.candengo_url || !config.candengo_api_key)
-    return null;
-  const url = `${config.candengo_url}/v1/mem/transcript-analysis`;
-  const controller = new AbortController;
-  const timeout = setTimeout(() => controller.abort(), 30000);
-  try {
-    const response = await fetch(url, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Authorization: `Bearer ${config.candengo_api_key}`
-      },
-      body: JSON.stringify({
-        transcript,
-        session_id: sessionId
-      }),
-      signal: controller.signal
-    });
-    if (!response.ok)
-      return null;
-    const data = await response.json();
-    if (!Array.isArray(data.plans) || !Array.isArray(data.decisions) || !Array.isArray(data.insights)) {
-      return null;
-    }
-    return data;
-  } catch {
-    return null;
-  } finally {
-    clearTimeout(timeout);
-  }
-}
-async function saveTranscriptResults(db, config, results, sessionId, cwd) {
-  let saved = 0;
-  const items = [
-    ...results.plans.map((item) => ({ item, type: "decision" })),
-    ...results.decisions.map((item) => ({ item, type: "decision" })),
-    ...results.insights.map((item) => ({ item, type: "discovery" }))
-  ];
-  for (const { item, type } of items) {
-    if (!item.title || item.title.trim().length === 0)
-      continue;
-    const result = await saveObservation(db, config, {
-      type,
-      title: item.title.slice(0, 80),
-      narrative: item.narrative,
-      concepts: item.concepts,
-      session_id: sessionId,
-      cwd
-    });
-    if (result.success)
-      saved++;
-  }
-  return saved;
-}
-
-// src/tools/recent-chat.ts
-function summarizeChatSources(messages) {
-  return messages.reduce((summary, message) => {
-    summary[getChatCaptureOrigin(message)] += 1;
-    return summary;
-  }, { transcript: 0, history: 0, hook: 0 });
-}
-function getChatCoverageState(messagesOrSummary) {
-  const summary = Array.isArray(messagesOrSummary) ? summarizeChatSources(messagesOrSummary) : messagesOrSummary;
-  if (summary.transcript > 0)
-    return "transcript-backed";
-  if (summary.history > 0)
-    return "history-backed";
-  if (summary.hook > 0)
-    return "hook-only";
-  return "none";
-}
-function getChatCaptureOrigin(message) {
-  if (message.source_kind === "transcript")
-    return "transcript";
-  if (typeof message.remote_source_id === "string" && message.remote_source_id.startsWith("history:")) {
-    return "history";
-  }
-  return "hook";
-}
-
-// src/tools/session-story.ts
-function getSessionStory(db, input) {
-  const session = db.getSessionById(input.session_id);
-  const summary = db.getSessionSummary(input.session_id);
-  const prompts = db.getSessionUserPrompts(input.session_id, 50);
-  const chatMessages = db.getSessionChatMessages(input.session_id, 50);
-  const toolEvents = db.getSessionToolEvents(input.session_id, 100);
-  const allObservations = db.getObservationsBySession(input.session_id);
-  const handoffs = allObservations.filter((obs) => looksLikeHandoff(obs));
-  const rollingHandoffDrafts = handoffs.filter((obs) => isDraftHandoff(obs));
-  const savedHandoffs = handoffs.filter((obs) => !isDraftHandoff(obs));
-  const observations = allObservations.filter((obs) => !looksLikeHandoff(obs));
-  const metrics = db.getSessionMetrics(input.session_id);
-  const projectName = session?.project_id !== null && session?.project_id !== undefined ? db.getProjectById(session.project_id)?.name ?? null : null;
-  const latestRequest = prompts[prompts.length - 1]?.prompt?.trim() || summary?.request?.trim() || null;
-  return {
-    session,
-    project_name: projectName,
-    summary,
-    prompts,
-    chat_messages: chatMessages,
-    chat_source_summary: summarizeChatSources(chatMessages),
-    chat_coverage_state: getChatCoverageState(chatMessages),
-    tool_events: toolEvents,
-    observations,
-    handoffs,
-    saved_handoffs: savedHandoffs,
-    rolling_handoff_drafts: rollingHandoffDrafts,
-    metrics,
-    capture_state: classifyCaptureState({
-      hasSummary: Boolean(summary?.request || summary?.completed),
-      promptCount: prompts.length,
-      toolEventCount: toolEvents.length
-    }),
-    capture_gaps: buildCaptureGaps({
-      promptCount: prompts.length,
-      toolEventCount: toolEvents.length,
-      toolCallsCount: metrics?.tool_calls_count ?? 0,
-      observationCount: observations.length,
-      hasSummary: Boolean(summary?.request || summary?.completed)
-    }),
-    latest_request: latestRequest,
-    recent_outcomes: collectRecentOutcomes(observations),
-    hot_files: collectHotFiles(observations),
-    provenance_summary: collectProvenanceSummary(observations)
-  };
-}
-function classifyCaptureState(input) {
-  if (input.promptCount > 0 && input.toolEventCount > 0)
-    return "rich";
-  if (input.promptCount > 0 || input.toolEventCount > 0)
-    return "partial";
-  if (input.hasSummary)
-    return "summary-only";
-  return "legacy";
-}
-function buildCaptureGaps(input) {
-  const gaps = [];
-  if (input.promptCount === 0)
-    gaps.push("missing prompts");
-  if (input.toolCallsCount > 0 && input.toolEventCount === 0) {
-    gaps.push("missing raw tool chronology");
-  } else if (input.toolEventCount === 0) {
-    gaps.push("no tool events");
-  }
-  if (input.observationCount === 0 && input.hasSummary) {
-    gaps.push("summary without reusable observations");
-  }
-  return gaps;
-}
-function collectRecentOutcomes(observations) {
-  const seen = new Set;
-  const outcomes = [];
-  for (const obs of observations) {
-    if (!["bugfix", "feature", "refactor", "change", "decision"].includes(obs.type))
-      continue;
-    const title = obs.title.trim();
-    if (!title || looksLikeFileOperationTitle(title))
-      continue;
-    const normalized = title.toLowerCase().replace(/\s+/g, " ").trim();
-    if (seen.has(normalized))
-      continue;
-    seen.add(normalized);
-    outcomes.push(title);
-    if (outcomes.length >= 6)
-      break;
-  }
-  return outcomes;
-}
-function collectHotFiles(observations) {
-  const counts = new Map;
-  for (const obs of observations) {
-    for (const path of [...parseJsonArray3(obs.files_modified), ...parseJsonArray3(obs.files_read)]) {
-      counts.set(path, (counts.get(path) ?? 0) + 1);
-    }
-  }
-  return Array.from(counts.entries()).map(([path, count]) => ({ path, count })).sort((a, b) => b.count - a.count || a.path.localeCompare(b.path)).slice(0, 8);
-}
-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 [];
-  }
-}
-function looksLikeFileOperationTitle(value) {
-  return /^(modified|updated|edited|touched|changed|extended|refactored|redesigned)\s+[A-Za-z0-9_.\-\/]+(?:\s*\([^)]*\))?$/i.test(value.trim());
-}
-function collectProvenanceSummary(observations) {
-  const counts = new Map;
-  for (const obs of observations) {
-    if (!obs.source_tool)
-      continue;
-    counts.set(obs.source_tool, (counts.get(obs.source_tool) ?? 0) + 1);
-  }
-  return Array.from(counts.entries()).map(([tool, count]) => ({ tool, count })).sort((a, b) => b.count - a.count || a.tool.localeCompare(b.tool)).slice(0, 6);
-}
-
-// src/tools/handoffs.ts
-async function upsertRollingHandoff(db, config, input) {
-  const resolved = resolveTargetSession(db, input.cwd, config.user_id, input.session_id);
-  if (!resolved.session) {
-    return {
-      success: false,
-      reason: "No recent session found to draft a handoff yet"
-    };
-  }
-  const story = getSessionStory(db, { session_id: resolved.session.session_id });
-  if (!story.session) {
-    return {
-      success: false,
-      reason: `Session ${resolved.session.session_id} not found`
-    };
-  }
-  const includeChat = input.include_chat === true || input.include_chat !== false && shouldAutoIncludeChat(story);
-  const chatLimit = Math.max(1, Math.min(input.chat_limit ?? 3, 6));
-  const title = `Handoff Draft: ${buildHandoffTitle(story.summary, story.latest_request)}`;
-  const narrative = buildHandoffNarrative(story.summary, story, {
-    includeChat,
-    chatLimit
-  });
-  const facts = buildHandoffFacts(story.summary, story);
-  const concepts = buildDraftHandoffConcepts(story.project_name, story.capture_state);
-  const existing = getSessionRollingHandoff(db, story.session.session_id);
-  const now = Math.floor(Date.now() / 1000);
-  if (existing) {
-    const nextFacts = JSON.stringify(facts);
-    const nextConcepts = JSON.stringify(concepts);
-    const shouldRefresh = existing.title !== title || (existing.narrative ?? null) !== narrative || (existing.facts ?? null) !== nextFacts || (existing.concepts ?? null) !== nextConcepts || now - existing.created_at_epoch >= 120;
-    if (!shouldRefresh) {
-      return {
-        success: true,
-        observation_id: existing.id,
-        session_id: story.session.session_id,
-        title: existing.title
-      };
-    }
-    const updated = db.updateObservationContent(existing.id, {
-      title,
-      narrative,
-      facts: nextFacts,
-      concepts: nextConcepts,
-      created_at_epoch: now
-    });
-    if (!updated) {
-      return {
-        success: false,
-        reason: "Failed to update rolling handoff draft"
-      };
-    }
-    db.addToOutbox("observation", updated.id);
-    return {
-      success: true,
-      observation_id: updated.id,
-      session_id: story.session.session_id,
-      title: updated.title
-    };
-  }
-  const result = await saveObservation(db, config, {
-    type: "message",
-    title,
-    narrative,
-    facts,
-    concepts,
-    session_id: story.session.session_id,
-    cwd: input.cwd,
-    agent: "engrm-handoff",
-    source_tool: "rolling_handoff"
-  });
-  return {
-    success: result.success,
-    observation_id: result.observation_id,
-    session_id: story.session.session_id,
-    title,
-    reason: result.reason
-  };
-}
-function getRecentHandoffs(db, input) {
-  const limit = Math.max(1, Math.min(input.limit ?? 10, 25));
-  const queryLimit = input.current_device_id ? Math.max(limit, Math.min(limit * 5, 50)) : limit;
-  const projectScoped = input.project_scoped !== false;
-  let projectId = null;
-  let projectName;
-  if (projectScoped) {
-    const cwd = input.cwd ?? process.cwd();
-    const detected = detectProject(cwd);
-    const project = db.getProjectByCanonicalId(detected.canonical_id);
-    if (project) {
-      projectId = project.id;
-      projectName = project.name;
-    }
-  }
-  const conditions = [
-    "o.type = 'message'",
-    "o.lifecycle IN ('active', 'aging', 'pinned')",
-    "o.superseded_by IS NULL",
-    `(o.title LIKE 'Handoff:%' OR o.concepts LIKE '%"handoff"%')`
-  ];
-  const params = [];
-  if (input.user_id) {
-    conditions.push("(o.sensitivity != 'personal' OR o.user_id = ?)");
-    params.push(input.user_id);
-  }
-  if (projectId !== null) {
-    conditions.push("o.project_id = ?");
-    params.push(projectId);
-  }
-  params.push(queryLimit);
-  const handoffs = db.db.query(`SELECT o.*, p.name AS project_name
-       FROM observations o
-       LEFT JOIN projects p ON p.id = o.project_id
-       WHERE ${conditions.join(" AND ")}
-      ORDER BY o.created_at_epoch DESC, o.id DESC
-      LIMIT ?`).all(...params);
-  handoffs.sort((a, b) => compareHandoffs(a, b, input.current_device_id));
-  return {
-    handoffs: handoffs.slice(0, limit),
-    project: projectName
-  };
-}
-function formatHandoffSource(handoff) {
-  const ageSeconds = Math.max(0, Math.floor(Date.now() / 1000) - handoff.created_at_epoch);
-  const ageLabel = ageSeconds < 3600 ? `${Math.max(1, Math.floor(ageSeconds / 60) || 1)}m ago` : ageSeconds < 86400 ? `${Math.floor(ageSeconds / 3600)}h ago` : `${Math.floor(ageSeconds / 86400)}d ago`;
-  return `from ${handoff.device_id} · ${ageLabel}`;
-}
-function isDraftHandoff(obs) {
-  if (obs.title.startsWith("Handoff Draft:"))
-    return true;
-  const concepts = parseJsonArray4(obs.concepts);
-  return concepts.includes("draft-handoff") || concepts.includes("auto-handoff");
-}
-function getSessionRollingHandoff(db, sessionId) {
-  return db.db.query(`SELECT o.*, p.name AS project_name
-       FROM observations o
-       LEFT JOIN projects p ON p.id = o.project_id
-       WHERE o.session_id = ?
-         AND o.type = 'message'
-         AND o.lifecycle IN ('active', 'aging', 'pinned')
-         AND o.superseded_by IS NULL
-         AND (o.title LIKE 'Handoff Draft:%' OR o.concepts LIKE '%"draft-handoff"%')
-       ORDER BY o.created_at_epoch DESC, o.id DESC
-       LIMIT 1`).get(sessionId) ?? null;
-}
-function compareHandoffs(a, b, currentDeviceId) {
-  const aDraft = isDraftHandoff(a) ? 1 : 0;
-  const bDraft = isDraftHandoff(b) ? 1 : 0;
-  if (aDraft !== bDraft)
-    return aDraft - bDraft;
-  if (currentDeviceId) {
-    const aOther = a.device_id !== currentDeviceId ? 1 : 0;
-    const bOther = b.device_id !== currentDeviceId ? 1 : 0;
-    if (aOther !== bOther)
-      return bOther - aOther;
-  }
-  if (b.created_at_epoch !== a.created_at_epoch) {
-    return b.created_at_epoch - a.created_at_epoch;
-  }
-  return b.id - a.id;
-}
-function resolveTargetSession(db, cwd, userId, sessionId) {
-  if (sessionId) {
-    const session = db.getSessionById(sessionId);
-    if (!session)
-      return { session: null };
-    const projectName = session.project_id ? db.getProjectById(session.project_id)?.name : undefined;
-    return {
-      session: {
-        ...session,
-        project_name: projectName ?? null,
-        request: db.getSessionSummary(sessionId)?.request ?? null,
-        completed: db.getSessionSummary(sessionId)?.completed ?? null,
-        current_thread: db.getSessionSummary(sessionId)?.current_thread ?? null,
-        capture_state: db.getSessionSummary(sessionId)?.capture_state ?? null,
-        recent_tool_names: db.getSessionSummary(sessionId)?.recent_tool_names ?? null,
-        hot_files: db.getSessionSummary(sessionId)?.hot_files ?? null,
-        recent_outcomes: db.getSessionSummary(sessionId)?.recent_outcomes ?? null,
-        prompt_count: db.getSessionUserPrompts(sessionId, 200).length,
-        tool_event_count: db.getSessionToolEvents(sessionId, 200).length
-      },
-      projectName: projectName ?? undefined
-    };
-  }
-  const detected = detectProject(cwd ?? process.cwd());
-  const project = db.getProjectByCanonicalId(detected.canonical_id);
-  const sessions = db.getRecentSessions(project?.id ?? null, 10, userId);
-  return {
-    session: sessions[0] ?? null,
-    projectName: project?.name
-  };
-}
-function buildHandoffTitle(summary, latestRequest, explicit) {
-  const chosen = explicit?.trim() || summary?.current_thread?.trim() || summary?.completed?.trim() || latestRequest?.trim() || "Current work";
-  return compactLine2(chosen) ?? "Current work";
-}
-function buildHandoffNarrative(summary, story, options) {
-  const sections = [];
-  if (summary?.request || story.latest_request) {
-    sections.push(`Request: ${summary?.request ?? story.latest_request}`);
-  }
-  if (summary?.current_thread) {
-    sections.push(`Current thread: ${summary.current_thread}`);
-  }
-  if (summary?.investigated) {
-    sections.push(`Investigated: ${summary.investigated}`);
-  }
-  if (summary?.learned) {
-    sections.push(`Learned: ${summary.learned}`);
-  }
-  if (summary?.completed) {
-    sections.push(`Completed: ${summary.completed}`);
-  }
-  if (summary?.next_steps) {
-    sections.push(`Next Steps: ${summary.next_steps}`);
-  }
-  if (story.recent_outcomes.length > 0) {
-    sections.push(`Recent outcomes:
-${story.recent_outcomes.slice(0, 5).map((item) => `- ${item}`).join(`
-`)}`);
-  }
-  if (story.hot_files.length > 0) {
-    sections.push(`Hot files:
-${story.hot_files.slice(0, 5).map((file) => `- ${file.path}`).join(`
-`)}`);
-  }
-  if (story.provenance_summary.length > 0) {
-    sections.push(`Tool trail:
-${story.provenance_summary.slice(0, 5).map((item) => `- ${item.tool}: ${item.count}`).join(`
-`)}`);
-  }
-  if (options.includeChat && story.chat_messages.length > 0) {
-    const chatLines = story.chat_messages.slice(-options.chatLimit).map((msg) => `- [${msg.role}] ${compactLine2(msg.content) ?? msg.content.slice(0, 120)}`);
-    sections.push(`Chat snippets:
-${chatLines.join(`
-`)}`);
-  }
-  return sections.filter(Boolean).join(`
-
-`);
-}
-function shouldAutoIncludeChat(story) {
-  if (story.chat_messages.length === 0)
-    return false;
-  const summary = story.summary;
-  const thinSummary = !summary?.completed && !summary?.current_thread && story.recent_outcomes.length < 2;
-  const thinChronology = story.capture_state !== "rich" || story.tool_events.length === 0;
-  return thinSummary || thinChronology;
-}
-function buildHandoffFacts(summary, story) {
-  const facts = [
-    `session_id=${story.session?.session_id ?? "unknown"}`,
-    `capture_state=${story.capture_state}`,
-    story.project_name ? `project=${story.project_name}` : null,
-    summary?.current_thread ? `current_thread=${summary.current_thread}` : null,
-    story.hot_files[0] ? `hot_file=${story.hot_files[0].path}` : null,
-    story.provenance_summary[0] ? `primary_tool=${story.provenance_summary[0].tool}` : null
-  ];
-  return facts.filter((item) => Boolean(item));
-}
-function buildDraftHandoffConcepts(projectName, captureState) {
-  return [
-    "handoff",
-    "draft-handoff",
-    "auto-handoff",
-    `capture:${captureState}`,
-    ...projectName ? [projectName] : []
-  ];
-}
-function looksLikeHandoff(obs) {
-  if (obs.title.startsWith("Handoff:") || obs.title.startsWith("Handoff Draft:"))
-    return true;
-  const concepts = parseJsonArray4(obs.concepts);
-  return concepts.includes("handoff") || concepts.includes("session-handoff") || concepts.includes("draft-handoff");
-}
-function parseJsonArray4(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 compactLine2(value) {
-  if (value === null || value === undefined)
-    return null;
-  let text;
-  if (typeof value === "string") {
-    text = value;
-  } else {
-    try {
-      text = JSON.stringify(value);
-    } catch {
-      text = String(value);
-    }
-  }
-  const trimmed = text.replace(/\s+/g, " ").trim();
-  if (!trimmed)
-    return null;
-  return trimmed.length > 120 ? `${trimmed.slice(0, 117)}...` : trimmed;
-}
 
 // hooks/stop.ts
+var thisFile = fileURLToPath(import.meta.url);
+var thisDir = dirname2(thisFile);
+var isWorker = process.env.ENGRM_STOP_WORKER === "1";
 function printRetrospective(summary) {
   const lines = [];
   lines.push("");
@@ -5202,9 +4702,53 @@ function printRetrospective(summary) {
 `));
 }
 async function main() {
-  const event = await parseStdinJson();
-  if (!event)
+  if (isWorker) {
+    await runWorkerFromFile(process.argv[2]);
     process.exit(0);
+  }
+  const raw = await readStdin();
+  if (!raw.trim())
+    process.exit(0);
+  spawnDetachedWorker(raw);
+  process.exit(0);
+}
+function spawnDetachedWorker(raw) {
+  const tempDir = mkdtempSync(join6(tmpdir(), "engrm-stop-"));
+  const payloadPath = join6(tempDir, "event.json");
+  writeFileSync2(payloadPath, raw, "utf-8");
+  const isBun = process.execPath.endsWith("bun");
+  const childArgs = isBun ? ["run", thisFile, payloadPath] : [thisFile, payloadPath];
+  const child = spawn(process.execPath, childArgs, {
+    detached: true,
+    stdio: "ignore",
+    env: {
+      ...process.env,
+      ENGRM_STOP_WORKER: "1"
+    }
+  });
+  child.unref();
+}
+async function runWorkerFromFile(payloadPath) {
+  if (!payloadPath)
+    return;
+  let raw = "";
+  try {
+    raw = readFileSync5(payloadPath, "utf-8");
+  } catch {
+    return;
+  } finally {
+    try {
+      rmSync(dirname2(payloadPath), { recursive: true, force: true });
+    } catch {}
+  }
+  let event = null;
+  try {
+    event = JSON.parse(raw);
+  } catch {
+    return;
+  }
+  if (!event)
+    return;
   if (event.stop_hook_active)
     process.exit(0);
   const boot = bootstrapHook("stop");
@@ -5238,12 +4782,6 @@ async function main() {
               source_kind: "hook"
             });
             db.addToOutbox("chat_message", chatMessage.id);
-            if (db.vecAvailable) {
-              const chatEmbedding = await embedText(composeChatEmbeddingText(event.last_assistant_message));
-              if (chatEmbedding) {
-                db.vecChatInsert(chatMessage.id, chatEmbedding);
-              }
-            }
           }
           createAssistantCheckpoint(db, event.session_id, event.cwd, event.last_assistant_message);
         } catch {}
@@ -5258,10 +4796,6 @@ async function main() {
         if (summary) {
           const row = db.upsertSessionSummary(summary);
           db.addToOutbox("summary", row.id);
-          await upsertRollingHandoff(db, config, {
-            session_id: event.session_id,
-            cwd: event.cwd
-          });
           let securityFindings = [];
           try {
             if (session?.project_id) {
@@ -5298,36 +4832,19 @@ async function main() {
         createSessionDigest(db, event.session_id, event.cwd);
       } catch {}
     }
-    if (config.transcript_analysis?.enabled && event.session_id) {
-      try {
-        const messages = readTranscript(event.session_id, event.cwd, event.transcript_path);
-        if (messages.length > 10) {
-          const transcript = truncateTranscript(messages);
-          const results = await analyzeTranscript(config, transcript, event.session_id);
-          if (results) {
-            const saved = await saveTranscriptResults(db, config, results, event.session_id, event.cwd);
-            if (saved > 0) {
-              console.error(`
-\uD83D\uDCA1 Engrm: Extracted ${saved} insight(s) from session transcript.`);
-            }
-          }
-        }
-      } catch {}
-    }
-    await pushOnce(db, config, { timeoutMs: 1500 });
+    await withTimeout(pushOnce(db, config, { timeoutMs: 250 }), 350);
     try {
       if (event.session_id) {
         const metrics = readSessionMetrics(event.session_id);
         const beacon = buildBeacon(db, config, event.session_id, metrics);
         if (beacon) {
-          await sendBeacon(config, beacon);
+          await withTimeout(sendBeacon(config, beacon), 150);
         }
       }
     } catch {}
   } finally {
     db.close();
   }
-  process.exit(0);
 }
 function buildFallbackSessionSummary(db, sessionId, projectId, userId, lastAssistantMessage) {
   const prompts = db.getSessionUserPrompts(sessionId, 10).filter((prompt) => isMeaningfulSummaryPrompt(prompt));
@@ -5539,6 +5056,12 @@ ${sections.join(`
   });
   db.addToOutbox("observation", digestObs.id);
 }
+async function withTimeout(promise, timeoutMs) {
+  return await Promise.race([
+    promise,
+    new Promise((resolve2) => setTimeout(() => resolve2(null), timeoutMs))
+  ]);
+}
 function createAssistantCheckpoint(db, sessionId, cwd, message) {
   const checkpoint = extractAssistantCheckpoint(message);
   if (!checkpoint)
@@ -5629,14 +5152,14 @@ function detectUnsavedPlans(message) {
   return hints;
 }
 function readSessionMetrics(sessionId) {
-  const { existsSync: existsSync5, readFileSync: readFileSync5, unlinkSync } = __require("node:fs");
-  const { join: join6 } = __require("node:path");
+  const { existsSync: existsSync5, readFileSync: readFileSync6, unlinkSync } = __require("node:fs");
+  const { join: join7 } = __require("node:path");
   const { homedir: homedir4 } = __require("node:os");
   const result = {};
   try {
-    const obsPath = join6(homedir4(), ".engrm", "observer-sessions", `${sessionId}.json`);
+    const obsPath = join7(homedir4(), ".engrm", "observer-sessions", `${sessionId}.json`);
     if (existsSync5(obsPath)) {
-      const state = JSON.parse(readFileSync5(obsPath, "utf-8"));
+      const state = JSON.parse(readFileSync6(obsPath, "utf-8"));
       if (typeof state.recallAttempts === "number")
         result.recallAttempts = state.recallAttempts;
       if (typeof state.recallHits === "number")
@@ -5644,9 +5167,9 @@ function readSessionMetrics(sessionId) {
     }
   } catch {}
   try {
-    const hookPath = join6(homedir4(), ".engrm", "hook-session-metrics.json");
+    const hookPath = join7(homedir4(), ".engrm", "hook-session-metrics.json");
     if (existsSync5(hookPath)) {
-      const hookMetrics = JSON.parse(readFileSync5(hookPath, "utf-8"));
+      const hookMetrics = JSON.parse(readFileSync6(hookPath, "utf-8"));
       if (typeof hookMetrics.contextObsInjected === "number")
         result.contextObsInjected = hookMetrics.contextObsInjected;
       if (typeof hookMetrics.contextTotalAvailable === "number")
@@ -5657,9 +5180,9 @@ function readSessionMetrics(sessionId) {
     }
   } catch {}
   try {
-    const mcpPath = join6(homedir4(), ".engrm", "mcp-session-metrics.json");
+    const mcpPath = join7(homedir4(), ".engrm", "mcp-session-metrics.json");
     if (existsSync5(mcpPath)) {
-      const metrics = JSON.parse(readFileSync5(mcpPath, "utf-8"));
+      const metrics = JSON.parse(readFileSync6(mcpPath, "utf-8"));
       if (typeof metrics.contextObsInjected === "number" && metrics.contextObsInjected > 0) {
         result.contextObsInjected = metrics.contextObsInjected;
       }

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

@@ -1123,6 +1123,20 @@ function ensureChatMessageColumns(db) {
     db.exec("PRAGMA user_version = 17");
   }
 }
+function ensureObservationVectorTable(db) {
+  if (!isVecExtensionLoaded(db))
+    return;
+  db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS vec_observations USING vec0(
+      observation_id INTEGER PRIMARY KEY,
+      embedding FLOAT[384]
+    );
+  `);
+  const current = getSchemaVersion(db);
+  if (current < 4) {
+    db.exec("PRAGMA user_version = 4");
+  }
+}
 function ensureChatVectorTable(db) {
   if (!isVecExtensionLoaded(db))
     return;
@@ -1351,6 +1365,7 @@ class MemDatabase {
     ensureObservationTypes(this.db);
     ensureSessionSummaryColumns(this.db);
     ensureChatMessageColumns(this.db);
+    ensureObservationVectorTable(this.db);
     ensureChatVectorTable(this.db);
     ensureSyncOutboxSupportsChatMessages(this.db);
   }

package/dist/server.js

@@ -14534,6 +14534,20 @@ function ensureChatMessageColumns(db) {
     db.exec("PRAGMA user_version = 17");
   }
 }
+function ensureObservationVectorTable(db) {
+  if (!isVecExtensionLoaded(db))
+    return;
+  db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS vec_observations USING vec0(
+      observation_id INTEGER PRIMARY KEY,
+      embedding FLOAT[384]
+    );
+  `);
+  const current = getSchemaVersion(db);
+  if (current < 4) {
+    db.exec("PRAGMA user_version = 4");
+  }
+}
 function ensureChatVectorTable(db) {
   if (!isVecExtensionLoaded(db))
     return;
@@ -14762,6 +14776,7 @@ class MemDatabase {
     ensureObservationTypes(this.db);
     ensureSessionSummaryColumns(this.db);
     ensureChatMessageColumns(this.db);
+    ensureObservationVectorTable(this.db);
     ensureChatVectorTable(this.db);
     ensureSyncOutboxSupportsChatMessages(this.db);
   }
@@ -23449,7 +23464,7 @@ function installStdioLivenessGuards() {
 function buildServer() {
   const server = new McpServer({
     name: "engrm",
-    version: "0.4.46"
+    version: "0.4.48"
   });
   const enabledToolNames = getEnabledToolNames(config2.tool_profile);
   const originalTool = server.tool.bind(server);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "engrm",
-  "version": "0.4.46",
+  "version": "0.4.48",
   "description": "Shared memory across devices, sessions, and agents, with thin MCP tools for durable capture, live continuity, and Hermes-ready remote MCP support",
   "mcpName": "io.github.dr12hes/engrm",
   "type": "module",