engrm 0.4.26 → 0.4.28

package/README.md

@@ -227,7 +227,8 @@ The MCP server exposes tools that supported agents can call directly:
 | `load_handoff` | Open a saved handoff as a resume point for a new session |
 | `refresh_chat_recall` | Rehydrate the separate chat lane from a Claude transcript when a long session feels under-captured |
 | `recent_chat` | Inspect the separate synced chat lane without mixing it into durable memory |
-| `search_chat` | Search recent chat recall separately from reusable memory observations |
+| `search_chat` | Search recent chat recall with hybrid lexical + semantic matching, separately from reusable memory observations |
+| `search_recall` | Search durable memory and chat recall together when you do not want to guess the right lane |
 | `plugin_catalog` | Inspect Engrm plugin manifests for memory-aware integrations |
 | `save_plugin_memory` | Save reduced plugin output with stable Engrm provenance |
 | `capture_git_diff` | Reduce a git diff into a durable memory object and save it |
@@ -359,6 +360,10 @@ What each tool is good for:
 - `capture_status` tells you whether prompt/tool hooks are live on this machine
 - `capture_quality` shows whether chat recall is transcript-backed or still hook-only across the workspace
 - `memory_console` gives the quickest project snapshot, including whether continuity is `fresh`, `thin`, or `cold`
+- `memory_console`, `project_memory_index`, and `session_context` now also show whether project chat recall is transcript-backed or only hook-captured
+- when chat continuity is only hook-captured, the workbench and startup hints now prefer `refresh_chat_recall`
+- the workbench and startup hints now also prefer `search_recall` as the first “what were we just talking about?” path when recent prompts/chat/observations exist
+- `search_chat` now uses hybrid lexical + semantic ranking when sqlite-vec and local embeddings are available, so recent conversation recall is less dependent on exact wording
 - `activity_feed` shows the merged chronology across prompts, tools, chat, handoffs, observations, and summaries
 - `recent_sessions` helps you pick a session worth opening
 - `session_story` reconstructs one session in detail, including handoffs and chat recall
@@ -366,7 +371,7 @@ What each tool is good for:
 - `session_tool_memory` shows which tool calls in one session turned into reusable memory and which did not
 - `project_memory_index` shows typed memory by repo, including continuity state and hot files
 - `workspace_memory_index` shows coverage across all repos on the machine
-- `recent_chat` / `search_chat` now report transcript-vs-hook coverage too, so weak OpenClaw recall is easier to diagnose and refresh
+- `recent_chat` / `search_chat` now report transcript-vs-hook coverage too, and `search_chat` will also mark when semantic ranking was available, so weak OpenClaw recall is easier to diagnose and refresh
 
 ### Thin Tool Workflow
 

package/dist/cli.js

@@ -708,6 +708,17 @@ var MIGRATIONS = [
         ON chat_messages(session_id, transcript_index)
         WHERE transcript_index IS NOT NULL;
     `
+  },
+  {
+    version: 18,
+    description: "Add sqlite-vec semantic search for chat recall",
+    condition: (db) => isVecExtensionLoaded(db),
+    sql: `
+      CREATE VIRTUAL TABLE IF NOT EXISTS vec_chat_messages USING vec0(
+        chat_message_id INTEGER PRIMARY KEY,
+        embedding FLOAT[384]
+      );
+    `
   }
 ];
 function isVecExtensionLoaded(db) {
@@ -781,6 +792,9 @@ function inferLegacySchemaVersion(db) {
   if (columnExists(db, "chat_messages", "source_kind") && columnExists(db, "chat_messages", "transcript_index")) {
     version = Math.max(version, 17);
   }
+  if (tableExists(db, "vec_chat_messages")) {
+    version = Math.max(version, 18);
+  }
   return version;
 }
 function runMigrations(db) {
@@ -897,6 +911,20 @@ function ensureChatMessageColumns(db) {
     db.exec("PRAGMA user_version = 17");
   }
 }
+function ensureChatVectorTable(db) {
+  if (!isVecExtensionLoaded(db))
+    return;
+  db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS vec_chat_messages USING vec0(
+      chat_message_id INTEGER PRIMARY KEY,
+      embedding FLOAT[384]
+    );
+  `);
+  const current = getSchemaVersion(db);
+  if (current < 18) {
+    db.exec("PRAGMA user_version = 18");
+  }
+}
 function ensureSyncOutboxSupportsChatMessages(db) {
   if (syncOutboxSupportsChatMessages(db)) {
     const current = getSchemaVersion(db);
@@ -1110,6 +1138,7 @@ class MemDatabase {
     ensureObservationTypes(this.db);
     ensureSessionSummaryColumns(this.db);
     ensureChatMessageColumns(this.db);
+    ensureChatVectorTable(this.db);
     ensureSyncOutboxSupportsChatMessages(this.db);
   }
   loadVecExtension() {
@@ -1476,6 +1505,14 @@ class MemDatabase {
   getChatMessageByRemoteSourceId(remoteSourceId) {
     return this.db.query("SELECT * FROM chat_messages WHERE remote_source_id = ?").get(remoteSourceId) ?? null;
   }
+  getChatMessagesByIds(ids) {
+    if (ids.length === 0)
+      return [];
+    const placeholders = ids.map(() => "?").join(",");
+    const rows = this.db.query(`SELECT * FROM chat_messages WHERE id IN (${placeholders})`).all(...ids);
+    const order = new Map(ids.map((id, index) => [id, index]));
+    return rows.sort((a, b) => (order.get(a.id) ?? 0) - (order.get(b.id) ?? 0));
+  }
   getSessionChatMessages(sessionId, limit = 50) {
     return this.db.query(`SELECT * FROM chat_messages
          WHERE session_id = ?
@@ -1552,6 +1589,39 @@ class MemDatabase {
          ORDER BY created_at_epoch DESC, id DESC
          LIMIT ?`).all(needle, ...userId ? [userId] : [], limit);
   }
+  vecChatInsert(chatMessageId, embedding) {
+    if (!this.vecAvailable)
+      return;
+    this.db.query("INSERT OR REPLACE INTO vec_chat_messages (chat_message_id, embedding) VALUES (?, ?)").run(chatMessageId, new Uint8Array(embedding.buffer));
+  }
+  searchChatVec(queryEmbedding, projectId, limit = 20, userId) {
+    if (!this.vecAvailable)
+      return [];
+    const embeddingBlob = new Uint8Array(queryEmbedding.buffer);
+    const visibilityClause = userId ? " AND c.user_id = ?" : "";
+    const transcriptPreference = `
+      AND (
+        c.source_kind = 'transcript'
+        OR NOT EXISTS (
+          SELECT 1 FROM chat_messages t2
+          WHERE t2.session_id = c.session_id
+            AND t2.source_kind = 'transcript'
+        )
+      )`;
+    if (projectId !== null) {
+      return this.db.query(`SELECT v.chat_message_id, v.distance
+           FROM vec_chat_messages v
+           JOIN chat_messages c ON c.id = v.chat_message_id
+           WHERE v.embedding MATCH ?
+             AND k = ?
+             AND c.project_id = ?` + visibilityClause + transcriptPreference).all(embeddingBlob, limit, projectId, ...userId ? [userId] : []);
+    }
+    return this.db.query(`SELECT v.chat_message_id, v.distance
+         FROM vec_chat_messages v
+         JOIN chat_messages c ON c.id = v.chat_message_id
+         WHERE v.embedding MATCH ?
+           AND k = ?` + visibilityClause + transcriptPreference).all(embeddingBlob, limit, ...userId ? [userId] : []);
+  }
   getTranscriptChatMessage(sessionId, transcriptIndex) {
     return this.db.query("SELECT * FROM chat_messages WHERE session_id = ? AND transcript_index = ?").get(sessionId, transcriptIndex) ?? null;
   }
@@ -2296,6 +2366,17 @@ var MIGRATIONS2 = [
         ON chat_messages(session_id, transcript_index)
         WHERE transcript_index IS NOT NULL;
     `
+  },
+  {
+    version: 18,
+    description: "Add sqlite-vec semantic search for chat recall",
+    condition: (db) => isVecExtensionLoaded2(db),
+    sql: `
+      CREATE VIRTUAL TABLE IF NOT EXISTS vec_chat_messages USING vec0(
+        chat_message_id INTEGER PRIMARY KEY,
+        embedding FLOAT[384]
+      );
+    `
   }
 ];
 function isVecExtensionLoaded2(db) {
@@ -3288,6 +3369,9 @@ function composeEmbeddingText(obs) {
 
 `);
 }
+function composeChatEmbeddingText(text) {
+  return text.replace(/\s+/g, " ").trim().slice(0, 2000);
+}
 async function getPipeline() {
   if (_pipeline)
     return _pipeline;

package/dist/hooks/elicitation-result.js

@@ -510,6 +510,9 @@ function composeEmbeddingText(obs) {
 
 `);
 }
+function composeChatEmbeddingText(text) {
+  return text.replace(/\s+/g, " ").trim().slice(0, 2000);
+}
 async function getPipeline() {
   if (_pipeline)
     return _pipeline;
@@ -1541,6 +1544,17 @@ var MIGRATIONS = [
         ON chat_messages(session_id, transcript_index)
         WHERE transcript_index IS NOT NULL;
     `
+  },
+  {
+    version: 18,
+    description: "Add sqlite-vec semantic search for chat recall",
+    condition: (db) => isVecExtensionLoaded(db),
+    sql: `
+      CREATE VIRTUAL TABLE IF NOT EXISTS vec_chat_messages USING vec0(
+        chat_message_id INTEGER PRIMARY KEY,
+        embedding FLOAT[384]
+      );
+    `
   }
 ];
 function isVecExtensionLoaded(db) {
@@ -1614,6 +1628,9 @@ function inferLegacySchemaVersion(db) {
   if (columnExists(db, "chat_messages", "source_kind") && columnExists(db, "chat_messages", "transcript_index")) {
     version = Math.max(version, 17);
   }
+  if (tableExists(db, "vec_chat_messages")) {
+    version = Math.max(version, 18);
+  }
   return version;
 }
 function runMigrations(db) {
@@ -1730,6 +1747,20 @@ function ensureChatMessageColumns(db) {
     db.exec("PRAGMA user_version = 17");
   }
 }
+function ensureChatVectorTable(db) {
+  if (!isVecExtensionLoaded(db))
+    return;
+  db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS vec_chat_messages USING vec0(
+      chat_message_id INTEGER PRIMARY KEY,
+      embedding FLOAT[384]
+    );
+  `);
+  const current = getSchemaVersion(db);
+  if (current < 18) {
+    db.exec("PRAGMA user_version = 18");
+  }
+}
 function ensureSyncOutboxSupportsChatMessages(db) {
   if (syncOutboxSupportsChatMessages(db)) {
     const current = getSchemaVersion(db);
@@ -1943,6 +1974,7 @@ class MemDatabase {
     ensureObservationTypes(this.db);
     ensureSessionSummaryColumns(this.db);
     ensureChatMessageColumns(this.db);
+    ensureChatVectorTable(this.db);
     ensureSyncOutboxSupportsChatMessages(this.db);
   }
   loadVecExtension() {
@@ -2309,6 +2341,14 @@ class MemDatabase {
   getChatMessageByRemoteSourceId(remoteSourceId) {
     return this.db.query("SELECT * FROM chat_messages WHERE remote_source_id = ?").get(remoteSourceId) ?? null;
   }
+  getChatMessagesByIds(ids) {
+    if (ids.length === 0)
+      return [];
+    const placeholders = ids.map(() => "?").join(",");
+    const rows = this.db.query(`SELECT * FROM chat_messages WHERE id IN (${placeholders})`).all(...ids);
+    const order = new Map(ids.map((id, index) => [id, index]));
+    return rows.sort((a, b) => (order.get(a.id) ?? 0) - (order.get(b.id) ?? 0));
+  }
   getSessionChatMessages(sessionId, limit = 50) {
     return this.db.query(`SELECT * FROM chat_messages
          WHERE session_id = ?
@@ -2385,6 +2425,39 @@ class MemDatabase {
          ORDER BY created_at_epoch DESC, id DESC
          LIMIT ?`).all(needle, ...userId ? [userId] : [], limit);
   }
+  vecChatInsert(chatMessageId, embedding) {
+    if (!this.vecAvailable)
+      return;
+    this.db.query("INSERT OR REPLACE INTO vec_chat_messages (chat_message_id, embedding) VALUES (?, ?)").run(chatMessageId, new Uint8Array(embedding.buffer));
+  }
+  searchChatVec(queryEmbedding, projectId, limit = 20, userId) {
+    if (!this.vecAvailable)
+      return [];
+    const embeddingBlob = new Uint8Array(queryEmbedding.buffer);
+    const visibilityClause = userId ? " AND c.user_id = ?" : "";
+    const transcriptPreference = `
+      AND (
+        c.source_kind = 'transcript'
+        OR NOT EXISTS (
+          SELECT 1 FROM chat_messages t2
+          WHERE t2.session_id = c.session_id
+            AND t2.source_kind = 'transcript'
+        )
+      )`;
+    if (projectId !== null) {
+      return this.db.query(`SELECT v.chat_message_id, v.distance
+           FROM vec_chat_messages v
+           JOIN chat_messages c ON c.id = v.chat_message_id
+           WHERE v.embedding MATCH ?
+             AND k = ?
+             AND c.project_id = ?` + visibilityClause + transcriptPreference).all(embeddingBlob, limit, projectId, ...userId ? [userId] : []);
+    }
+    return this.db.query(`SELECT v.chat_message_id, v.distance
+         FROM vec_chat_messages v
+         JOIN chat_messages c ON c.id = v.chat_message_id
+         WHERE v.embedding MATCH ?
+           AND k = ?` + visibilityClause + transcriptPreference).all(embeddingBlob, limit, ...userId ? [userId] : []);
+  }
   getTranscriptChatMessage(sessionId, transcriptIndex) {
     return this.db.query("SELECT * FROM chat_messages WHERE session_id = ? AND transcript_index = ?").get(sessionId, transcriptIndex) ?? null;
   }

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

@@ -886,6 +886,17 @@ var MIGRATIONS = [
         ON chat_messages(session_id, transcript_index)
         WHERE transcript_index IS NOT NULL;
     `
+  },
+  {
+    version: 18,
+    description: "Add sqlite-vec semantic search for chat recall",
+    condition: (db) => isVecExtensionLoaded(db),
+    sql: `
+      CREATE VIRTUAL TABLE IF NOT EXISTS vec_chat_messages USING vec0(
+        chat_message_id INTEGER PRIMARY KEY,
+        embedding FLOAT[384]
+      );
+    `
   }
 ];
 function isVecExtensionLoaded(db) {
@@ -959,6 +970,9 @@ function inferLegacySchemaVersion(db) {
   if (columnExists(db, "chat_messages", "source_kind") && columnExists(db, "chat_messages", "transcript_index")) {
     version = Math.max(version, 17);
   }
+  if (tableExists(db, "vec_chat_messages")) {
+    version = Math.max(version, 18);
+  }
   return version;
 }
 function runMigrations(db) {
@@ -1075,6 +1089,20 @@ function ensureChatMessageColumns(db) {
     db.exec("PRAGMA user_version = 17");
   }
 }
+function ensureChatVectorTable(db) {
+  if (!isVecExtensionLoaded(db))
+    return;
+  db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS vec_chat_messages USING vec0(
+      chat_message_id INTEGER PRIMARY KEY,
+      embedding FLOAT[384]
+    );
+  `);
+  const current = getSchemaVersion(db);
+  if (current < 18) {
+    db.exec("PRAGMA user_version = 18");
+  }
+}
 function ensureSyncOutboxSupportsChatMessages(db) {
   if (syncOutboxSupportsChatMessages(db)) {
     const current = getSchemaVersion(db);
@@ -1288,6 +1316,7 @@ class MemDatabase {
     ensureObservationTypes(this.db);
     ensureSessionSummaryColumns(this.db);
     ensureChatMessageColumns(this.db);
+    ensureChatVectorTable(this.db);
     ensureSyncOutboxSupportsChatMessages(this.db);
   }
   loadVecExtension() {
@@ -1654,6 +1683,14 @@ class MemDatabase {
   getChatMessageByRemoteSourceId(remoteSourceId) {
     return this.db.query("SELECT * FROM chat_messages WHERE remote_source_id = ?").get(remoteSourceId) ?? null;
   }
+  getChatMessagesByIds(ids) {
+    if (ids.length === 0)
+      return [];
+    const placeholders = ids.map(() => "?").join(",");
+    const rows = this.db.query(`SELECT * FROM chat_messages WHERE id IN (${placeholders})`).all(...ids);
+    const order = new Map(ids.map((id, index) => [id, index]));
+    return rows.sort((a, b) => (order.get(a.id) ?? 0) - (order.get(b.id) ?? 0));
+  }
   getSessionChatMessages(sessionId, limit = 50) {
     return this.db.query(`SELECT * FROM chat_messages
          WHERE session_id = ?
@@ -1730,6 +1767,39 @@ class MemDatabase {
          ORDER BY created_at_epoch DESC, id DESC
          LIMIT ?`).all(needle, ...userId ? [userId] : [], limit);
   }
+  vecChatInsert(chatMessageId, embedding) {
+    if (!this.vecAvailable)
+      return;
+    this.db.query("INSERT OR REPLACE INTO vec_chat_messages (chat_message_id, embedding) VALUES (?, ?)").run(chatMessageId, new Uint8Array(embedding.buffer));
+  }
+  searchChatVec(queryEmbedding, projectId, limit = 20, userId) {
+    if (!this.vecAvailable)
+      return [];
+    const embeddingBlob = new Uint8Array(queryEmbedding.buffer);
+    const visibilityClause = userId ? " AND c.user_id = ?" : "";
+    const transcriptPreference = `
+      AND (
+        c.source_kind = 'transcript'
+        OR NOT EXISTS (
+          SELECT 1 FROM chat_messages t2
+          WHERE t2.session_id = c.session_id
+            AND t2.source_kind = 'transcript'
+        )
+      )`;
+    if (projectId !== null) {
+      return this.db.query(`SELECT v.chat_message_id, v.distance
+           FROM vec_chat_messages v
+           JOIN chat_messages c ON c.id = v.chat_message_id
+           WHERE v.embedding MATCH ?
+             AND k = ?
+             AND c.project_id = ?` + visibilityClause + transcriptPreference).all(embeddingBlob, limit, projectId, ...userId ? [userId] : []);
+    }
+    return this.db.query(`SELECT v.chat_message_id, v.distance
+         FROM vec_chat_messages v
+         JOIN chat_messages c ON c.id = v.chat_message_id
+         WHERE v.embedding MATCH ?
+           AND k = ?` + visibilityClause + transcriptPreference).all(embeddingBlob, limit, ...userId ? [userId] : []);
+  }
   getTranscriptChatMessage(sessionId, transcriptIndex) {
     return this.db.query("SELECT * FROM chat_messages WHERE session_id = ? AND transcript_index = ?").get(sessionId, transcriptIndex) ?? null;
   }
@@ -2514,6 +2584,9 @@ function composeEmbeddingText(obs) {
 
 `);
 }
+function composeChatEmbeddingText(text) {
+  return text.replace(/\s+/g, " ").trim().slice(0, 2000);
+}
 async function getPipeline() {
   if (_pipeline)
     return _pipeline;
@@ -3701,7 +3774,7 @@ function readTranscript(sessionId, cwd, transcriptPath) {
   }
   return messages;
 }
-function syncTranscriptChat(db, config, sessionId, cwd, transcriptPath) {
+async function syncTranscriptChat(db, config, sessionId, cwd, transcriptPath) {
   const messages = readTranscript(sessionId, cwd, transcriptPath).map((message) => ({
     ...message,
     text: message.text.trim()
@@ -3731,6 +3804,12 @@ function syncTranscriptChat(db, config, sessionId, cwd, transcriptPath) {
       transcript_index: transcriptIndex
     });
     db.addToOutbox("chat_message", row.id);
+    if (db.vecAvailable) {
+      const embedding = await embedText(composeChatEmbeddingText(message.text));
+      if (embedding) {
+        db.vecChatInsert(row.id, embedding);
+      }
+    }
     imported++;
   }
   return { imported, total: messages.length };
@@ -3831,6 +3910,8 @@ function getSessionStory(db, input) {
     summary,
     prompts,
     chat_messages: chatMessages,
+    chat_source_summary: summarizeChatSources(chatMessages),
+    chat_coverage_state: chatMessages.some((message) => message.source_kind === "transcript") ? "transcript-backed" : chatMessages.length > 0 ? "hook-only" : "none",
     tool_events: toolEvents,
     observations,
     handoffs,
@@ -3928,6 +4009,12 @@ function collectProvenanceSummary(observations) {
   }
   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);
 }
+function summarizeChatSources(messages) {
+  return messages.reduce((summary, message) => {
+    summary[message.source_kind] += 1;
+    return summary;
+  }, { transcript: 0, hook: 0 });
+}
 
 // src/tools/handoffs.ts
 async function upsertRollingHandoff(db, config, input) {
@@ -4248,7 +4335,7 @@ async function main() {
   try {
     if (event.session_id) {
       persistRawToolChronology(event, config.user_id, config.device_id);
-      syncTranscriptChat(db, config, event.session_id, event.cwd);
+      await syncTranscriptChat(db, config, event.session_id, event.cwd);
     }
     const textToScan = extractScanText(event);
     if (textToScan) {

package/dist/hooks/pre-compact.js

@@ -680,6 +680,17 @@ var MIGRATIONS = [
         ON chat_messages(session_id, transcript_index)
         WHERE transcript_index IS NOT NULL;
     `
+  },
+  {
+    version: 18,
+    description: "Add sqlite-vec semantic search for chat recall",
+    condition: (db) => isVecExtensionLoaded(db),
+    sql: `
+      CREATE VIRTUAL TABLE IF NOT EXISTS vec_chat_messages USING vec0(
+        chat_message_id INTEGER PRIMARY KEY,
+        embedding FLOAT[384]
+      );
+    `
   }
 ];
 function isVecExtensionLoaded(db) {
@@ -753,6 +764,9 @@ function inferLegacySchemaVersion(db) {
   if (columnExists(db, "chat_messages", "source_kind") && columnExists(db, "chat_messages", "transcript_index")) {
     version = Math.max(version, 17);
   }
+  if (tableExists(db, "vec_chat_messages")) {
+    version = Math.max(version, 18);
+  }
   return version;
 }
 function runMigrations(db) {
@@ -869,6 +883,20 @@ function ensureChatMessageColumns(db) {
     db.exec("PRAGMA user_version = 17");
   }
 }
+function ensureChatVectorTable(db) {
+  if (!isVecExtensionLoaded(db))
+    return;
+  db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS vec_chat_messages USING vec0(
+      chat_message_id INTEGER PRIMARY KEY,
+      embedding FLOAT[384]
+    );
+  `);
+  const current = getSchemaVersion(db);
+  if (current < 18) {
+    db.exec("PRAGMA user_version = 18");
+  }
+}
 function ensureSyncOutboxSupportsChatMessages(db) {
   if (syncOutboxSupportsChatMessages(db)) {
     const current = getSchemaVersion(db);
@@ -1082,6 +1110,7 @@ class MemDatabase {
     ensureObservationTypes(this.db);
     ensureSessionSummaryColumns(this.db);
     ensureChatMessageColumns(this.db);
+    ensureChatVectorTable(this.db);
     ensureSyncOutboxSupportsChatMessages(this.db);
   }
   loadVecExtension() {
@@ -1448,6 +1477,14 @@ class MemDatabase {
   getChatMessageByRemoteSourceId(remoteSourceId) {
     return this.db.query("SELECT * FROM chat_messages WHERE remote_source_id = ?").get(remoteSourceId) ?? null;
   }
+  getChatMessagesByIds(ids) {
+    if (ids.length === 0)
+      return [];
+    const placeholders = ids.map(() => "?").join(",");
+    const rows = this.db.query(`SELECT * FROM chat_messages WHERE id IN (${placeholders})`).all(...ids);
+    const order = new Map(ids.map((id, index) => [id, index]));
+    return rows.sort((a, b) => (order.get(a.id) ?? 0) - (order.get(b.id) ?? 0));
+  }
   getSessionChatMessages(sessionId, limit = 50) {
     return this.db.query(`SELECT * FROM chat_messages
          WHERE session_id = ?
@@ -1524,6 +1561,39 @@ class MemDatabase {
          ORDER BY created_at_epoch DESC, id DESC
          LIMIT ?`).all(needle, ...userId ? [userId] : [], limit);
   }
+  vecChatInsert(chatMessageId, embedding) {
+    if (!this.vecAvailable)
+      return;
+    this.db.query("INSERT OR REPLACE INTO vec_chat_messages (chat_message_id, embedding) VALUES (?, ?)").run(chatMessageId, new Uint8Array(embedding.buffer));
+  }
+  searchChatVec(queryEmbedding, projectId, limit = 20, userId) {
+    if (!this.vecAvailable)
+      return [];
+    const embeddingBlob = new Uint8Array(queryEmbedding.buffer);
+    const visibilityClause = userId ? " AND c.user_id = ?" : "";
+    const transcriptPreference = `
+      AND (
+        c.source_kind = 'transcript'
+        OR NOT EXISTS (
+          SELECT 1 FROM chat_messages t2
+          WHERE t2.session_id = c.session_id
+            AND t2.source_kind = 'transcript'
+        )
+      )`;
+    if (projectId !== null) {
+      return this.db.query(`SELECT v.chat_message_id, v.distance
+           FROM vec_chat_messages v
+           JOIN chat_messages c ON c.id = v.chat_message_id
+           WHERE v.embedding MATCH ?
+             AND k = ?
+             AND c.project_id = ?` + visibilityClause + transcriptPreference).all(embeddingBlob, limit, projectId, ...userId ? [userId] : []);
+    }
+    return this.db.query(`SELECT v.chat_message_id, v.distance
+         FROM vec_chat_messages v
+         JOIN chat_messages c ON c.id = v.chat_message_id
+         WHERE v.embedding MATCH ?
+           AND k = ?` + visibilityClause + transcriptPreference).all(embeddingBlob, limit, ...userId ? [userId] : []);
+  }
   getTranscriptChatMessage(sessionId, transcriptIndex) {
     return this.db.query("SELECT * FROM chat_messages WHERE session_id = ? AND transcript_index = ?").get(sessionId, transcriptIndex) ?? null;
   }
@@ -2154,6 +2224,8 @@ function getSessionStory(db, input) {
     summary,
     prompts,
     chat_messages: chatMessages,
+    chat_source_summary: summarizeChatSources(chatMessages),
+    chat_coverage_state: chatMessages.some((message) => message.source_kind === "transcript") ? "transcript-backed" : chatMessages.length > 0 ? "hook-only" : "none",
     tool_events: toolEvents,
     observations,
     handoffs,
@@ -2251,6 +2323,12 @@ function collectProvenanceSummary(observations) {
   }
   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);
 }
+function summarizeChatSources(messages) {
+  return messages.reduce((summary, message) => {
+    summary[message.source_kind] += 1;
+    return summary;
+  }, { transcript: 0, hook: 0 });
+}
 
 // src/tools/save.ts
 import { relative, isAbsolute } from "node:path";
@@ -2579,6 +2657,9 @@ function composeEmbeddingText(obs) {
 
 `);
 }
+function composeChatEmbeddingText(text) {
+  return text.replace(/\s+/g, " ").trim().slice(0, 2000);
+}
 async function getPipeline() {
   if (_pipeline)
     return _pipeline;
@@ -3946,7 +4027,7 @@ function readTranscript(sessionId, cwd, transcriptPath) {
   }
   return messages;
 }
-function syncTranscriptChat(db, config, sessionId, cwd, transcriptPath) {
+async function syncTranscriptChat(db, config, sessionId, cwd, transcriptPath) {
   const messages = readTranscript(sessionId, cwd, transcriptPath).map((message) => ({
     ...message,
     text: message.text.trim()
@@ -3976,6 +4057,12 @@ function syncTranscriptChat(db, config, sessionId, cwd, transcriptPath) {
       transcript_index: transcriptIndex
     });
     db.addToOutbox("chat_message", row.id);
+    if (db.vecAvailable) {
+      const embedding = await embedText(composeChatEmbeddingText(message.text));
+      if (embedding) {
+        db.vecChatInsert(row.id, embedding);
+      }
+    }
     imported++;
   }
   return { imported, total: messages.length };
@@ -4109,7 +4196,7 @@ async function main() {
   try {
     let importedChat = 0;
     if (event.session_id) {
-      const chatSync = syncTranscriptChat(db, config, event.session_id, event.cwd);
+      const chatSync = await syncTranscriptChat(db, config, event.session_id, event.cwd);
       importedChat = chatSync.imported;
       await upsertRollingHandoff(db, config, {
         session_id: event.session_id,