engrm 0.4.22 → 0.4.25

package/dist/hooks/pre-compact.js

@@ -277,7 +277,7 @@ var MIGRATIONS = [
       -- Sync outbox (offline-first queue)
       CREATE TABLE sync_outbox (
           id              INTEGER PRIMARY KEY AUTOINCREMENT,
-          record_type     TEXT NOT NULL CHECK (record_type IN ('observation', 'summary')),
+          record_type     TEXT NOT NULL CHECK (record_type IN ('observation', 'summary', 'chat_message')),
           record_id       INTEGER NOT NULL,
           status          TEXT DEFAULT 'pending' CHECK (status IN (
               'pending', 'syncing', 'synced', 'failed'
@@ -570,6 +570,18 @@ var MIGRATIONS = [
         ON tool_events(created_at_epoch DESC, id DESC);
     `
   },
+  {
+    version: 11,
+    description: "Add observation provenance from tool and prompt chronology",
+    sql: `
+      ALTER TABLE observations ADD COLUMN source_tool TEXT;
+      ALTER TABLE observations ADD COLUMN source_prompt_number INTEGER;
+      CREATE INDEX IF NOT EXISTS idx_observations_source_tool
+        ON observations(source_tool, created_at_epoch DESC);
+      CREATE INDEX IF NOT EXISTS idx_observations_source_prompt
+        ON observations(session_id, source_prompt_number DESC);
+    `
+  },
   {
     version: 12,
     description: "Add synced handoff metadata to session summaries",
@@ -581,15 +593,92 @@ var MIGRATIONS = [
     `
   },
   {
-    version: 11,
-    description: "Add observation provenance from tool and prompt chronology",
+    version: 13,
+    description: "Add current_thread to session summaries",
     sql: `
-      ALTER TABLE observations ADD COLUMN source_tool TEXT;
-      ALTER TABLE observations ADD COLUMN source_prompt_number INTEGER;
-      CREATE INDEX IF NOT EXISTS idx_observations_source_tool
-        ON observations(source_tool, created_at_epoch DESC);
-      CREATE INDEX IF NOT EXISTS idx_observations_source_prompt
-        ON observations(session_id, source_prompt_number DESC);
+      ALTER TABLE session_summaries ADD COLUMN current_thread TEXT;
+    `
+  },
+  {
+    version: 14,
+    description: "Add chat_messages lane for raw conversation recall",
+    sql: `
+      CREATE TABLE IF NOT EXISTS chat_messages (
+          id                INTEGER PRIMARY KEY AUTOINCREMENT,
+          session_id        TEXT NOT NULL,
+          project_id        INTEGER REFERENCES projects(id),
+          role              TEXT NOT NULL CHECK (role IN ('user', 'assistant')),
+          content           TEXT NOT NULL,
+          user_id           TEXT NOT NULL,
+          device_id         TEXT NOT NULL,
+          agent             TEXT DEFAULT 'claude-code',
+          created_at_epoch  INTEGER NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_chat_messages_session
+        ON chat_messages(session_id, created_at_epoch DESC, id DESC);
+      CREATE INDEX IF NOT EXISTS idx_chat_messages_project
+        ON chat_messages(project_id, created_at_epoch DESC, id DESC);
+      CREATE INDEX IF NOT EXISTS idx_chat_messages_created
+        ON chat_messages(created_at_epoch DESC, id DESC);
+    `
+  },
+  {
+    version: 15,
+    description: "Add remote_source_id for chat message sync deduplication",
+    sql: `
+      ALTER TABLE chat_messages ADD COLUMN remote_source_id TEXT;
+      CREATE UNIQUE INDEX IF NOT EXISTS idx_chat_messages_remote_source
+        ON chat_messages(remote_source_id)
+        WHERE remote_source_id IS NOT NULL;
+    `
+  },
+  {
+    version: 16,
+    description: "Allow chat_message records in sync_outbox",
+    sql: `
+      CREATE TABLE sync_outbox_new (
+          id              INTEGER PRIMARY KEY AUTOINCREMENT,
+          record_type     TEXT NOT NULL CHECK (record_type IN ('observation', 'summary', 'chat_message')),
+          record_id       INTEGER NOT NULL,
+          status          TEXT DEFAULT 'pending' CHECK (status IN (
+              'pending', 'syncing', 'synced', 'failed'
+          )),
+          retry_count     INTEGER DEFAULT 0,
+          max_retries     INTEGER DEFAULT 10,
+          last_error      TEXT,
+          created_at_epoch INTEGER NOT NULL,
+          synced_at_epoch  INTEGER,
+          next_retry_epoch INTEGER
+      );
+
+      INSERT INTO sync_outbox_new (
+        id, record_type, record_id, status, retry_count, max_retries,
+        last_error, created_at_epoch, synced_at_epoch, next_retry_epoch
+      )
+      SELECT
+        id, record_type, record_id, status, retry_count, max_retries,
+        last_error, created_at_epoch, synced_at_epoch, next_retry_epoch
+      FROM sync_outbox;
+
+      DROP TABLE sync_outbox;
+      ALTER TABLE sync_outbox_new RENAME TO sync_outbox;
+
+      CREATE INDEX idx_outbox_status ON sync_outbox(status, next_retry_epoch);
+      CREATE INDEX idx_outbox_record ON sync_outbox(record_type, record_id);
+    `
+  },
+  {
+    version: 17,
+    description: "Track transcript-backed chat messages separately from hook chat",
+    sql: `
+      ALTER TABLE chat_messages ADD COLUMN source_kind TEXT DEFAULT 'hook';
+      ALTER TABLE chat_messages ADD COLUMN transcript_index INTEGER;
+      CREATE INDEX IF NOT EXISTS idx_chat_messages_source_kind
+        ON chat_messages(session_id, source_kind, transcript_index, created_at_epoch DESC, id DESC);
+      CREATE UNIQUE INDEX IF NOT EXISTS idx_chat_messages_session_transcript
+        ON chat_messages(session_id, transcript_index)
+        WHERE transcript_index IS NOT NULL;
     `
   }
 ];
@@ -649,6 +738,21 @@ function inferLegacySchemaVersion(db) {
   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);
   }
+  if (columnExists(db, "session_summaries", "current_thread")) {
+    version = Math.max(version, 13);
+  }
+  if (tableExists(db, "chat_messages")) {
+    version = Math.max(version, 14);
+  }
+  if (columnExists(db, "chat_messages", "remote_source_id")) {
+    version = Math.max(version, 15);
+  }
+  if (syncOutboxSupportsChatMessages(db)) {
+    version = Math.max(version, 16);
+  }
+  if (columnExists(db, "chat_messages", "source_kind") && columnExists(db, "chat_messages", "transcript_index")) {
+    version = Math.max(version, 17);
+  }
   return version;
 }
 function runMigrations(db) {
@@ -732,7 +836,8 @@ function ensureSessionSummaryColumns(db) {
     "capture_state",
     "recent_tool_names",
     "hot_files",
-    "recent_outcomes"
+    "recent_outcomes",
+    "current_thread"
   ];
   for (const column of required) {
     if (columnExists(db, "session_summaries", column))
@@ -740,10 +845,83 @@ function ensureSessionSummaryColumns(db) {
     db.exec(`ALTER TABLE session_summaries ADD COLUMN ${column} TEXT`);
   }
   const current = getSchemaVersion(db);
-  if (current < 12) {
-    db.exec("PRAGMA user_version = 12");
+  if (current < 13) {
+    db.exec("PRAGMA user_version = 13");
+  }
+}
+function ensureChatMessageColumns(db) {
+  if (!tableExists(db, "chat_messages"))
+    return;
+  if (!columnExists(db, "chat_messages", "remote_source_id")) {
+    db.exec("ALTER TABLE chat_messages ADD COLUMN remote_source_id TEXT");
+  }
+  db.exec("CREATE UNIQUE INDEX IF NOT EXISTS idx_chat_messages_remote_source ON chat_messages(remote_source_id) WHERE remote_source_id IS NOT NULL");
+  if (!columnExists(db, "chat_messages", "source_kind")) {
+    db.exec("ALTER TABLE chat_messages ADD COLUMN source_kind TEXT DEFAULT 'hook'");
+  }
+  if (!columnExists(db, "chat_messages", "transcript_index")) {
+    db.exec("ALTER TABLE chat_messages ADD COLUMN transcript_index INTEGER");
+  }
+  db.exec("CREATE INDEX IF NOT EXISTS idx_chat_messages_source_kind ON chat_messages(session_id, source_kind, transcript_index, created_at_epoch DESC, id DESC)");
+  db.exec("CREATE UNIQUE INDEX IF NOT EXISTS idx_chat_messages_session_transcript ON chat_messages(session_id, transcript_index) WHERE transcript_index IS NOT NULL");
+  const current = getSchemaVersion(db);
+  if (current < 17) {
+    db.exec("PRAGMA user_version = 17");
+  }
+}
+function ensureSyncOutboxSupportsChatMessages(db) {
+  if (syncOutboxSupportsChatMessages(db)) {
+    const current = getSchemaVersion(db);
+    if (current < 16) {
+      db.exec("PRAGMA user_version = 16");
+    }
+    return;
+  }
+  db.exec("BEGIN TRANSACTION");
+  try {
+    db.exec(`
+      CREATE TABLE sync_outbox_new (
+          id              INTEGER PRIMARY KEY AUTOINCREMENT,
+          record_type     TEXT NOT NULL CHECK (record_type IN ('observation', 'summary', 'chat_message')),
+          record_id       INTEGER NOT NULL,
+          status          TEXT DEFAULT 'pending' CHECK (status IN (
+              'pending', 'syncing', 'synced', 'failed'
+          )),
+          retry_count     INTEGER DEFAULT 0,
+          max_retries     INTEGER DEFAULT 10,
+          last_error      TEXT,
+          created_at_epoch INTEGER NOT NULL,
+          synced_at_epoch  INTEGER,
+          next_retry_epoch INTEGER
+      );
+
+      INSERT INTO sync_outbox_new (
+        id, record_type, record_id, status, retry_count, max_retries,
+        last_error, created_at_epoch, synced_at_epoch, next_retry_epoch
+      )
+      SELECT
+        id, record_type, record_id, status, retry_count, max_retries,
+        last_error, created_at_epoch, synced_at_epoch, next_retry_epoch
+      FROM sync_outbox;
+
+      DROP TABLE sync_outbox;
+      ALTER TABLE sync_outbox_new RENAME TO sync_outbox;
+
+      CREATE INDEX idx_outbox_status ON sync_outbox(status, next_retry_epoch);
+      CREATE INDEX idx_outbox_record ON sync_outbox(record_type, record_id);
+    `);
+    db.exec("PRAGMA user_version = 16");
+    db.exec("COMMIT");
+  } catch (error) {
+    db.exec("ROLLBACK");
+    throw new Error(`sync_outbox repair failed: ${error instanceof Error ? error.message : String(error)}`);
   }
 }
+function syncOutboxSupportsChatMessages(db) {
+  const row = db.query("SELECT sql FROM sqlite_master WHERE type = 'table' AND name = ?").get("sync_outbox");
+  const sql = row?.sql ?? "";
+  return sql.includes("'chat_message'");
+}
 function getSchemaVersion(db) {
   const result = db.query("PRAGMA user_version").get();
   return result.user_version;
@@ -903,6 +1081,8 @@ class MemDatabase {
     runMigrations(this.db);
     ensureObservationTypes(this.db);
     ensureSessionSummaryColumns(this.db);
+    ensureChatMessageColumns(this.db);
+    ensureSyncOutboxSupportsChatMessages(this.db);
   }
   loadVecExtension() {
     try {
@@ -971,6 +1151,22 @@ class MemDatabase {
   getObservationById(id) {
     return this.db.query("SELECT * FROM observations WHERE id = ?").get(id) ?? null;
   }
+  updateObservationContent(id, update) {
+    const existing = this.getObservationById(id);
+    if (!existing)
+      return null;
+    const createdAtEpoch = update.created_at_epoch ?? existing.created_at_epoch;
+    const createdAt = new Date(createdAtEpoch * 1000).toISOString();
+    this.db.query(`UPDATE observations
+         SET title = ?, narrative = ?, facts = ?, concepts = ?, created_at = ?, created_at_epoch = ?
+         WHERE id = ?`).run(update.title, update.narrative ?? null, update.facts ?? null, update.concepts ?? null, createdAt, createdAtEpoch, id);
+    this.ftsDelete(existing);
+    const refreshed = this.getObservationById(id);
+    if (!refreshed)
+      return null;
+    this.ftsInsert(refreshed);
+    return refreshed;
+  }
   getObservationsByIds(ids, userId) {
     if (ids.length === 0)
       return [];
@@ -1128,6 +1324,7 @@ class MemDatabase {
              p.name AS project_name,
              ss.request AS request,
              ss.completed AS completed,
+             ss.current_thread AS current_thread,
              ss.capture_state AS capture_state,
              ss.recent_tool_names AS recent_tool_names,
              ss.hot_files AS hot_files,
@@ -1146,6 +1343,7 @@ class MemDatabase {
            p.name AS project_name,
            ss.request AS request,
            ss.completed AS completed,
+           ss.current_thread AS current_thread,
            ss.capture_state AS capture_state,
            ss.recent_tool_names AS recent_tool_names,
            ss.hot_files AS hot_files,
@@ -1236,6 +1434,99 @@ class MemDatabase {
          ORDER BY created_at_epoch DESC, id DESC
          LIMIT ?`).all(...userId ? [userId] : [], limit);
   }
+  insertChatMessage(input) {
+    const createdAt = input.created_at_epoch ?? Math.floor(Date.now() / 1000);
+    const content = input.content.trim();
+    const result = this.db.query(`INSERT INTO chat_messages (
+          session_id, project_id, role, content, user_id, device_id, agent, created_at_epoch, remote_source_id, source_kind, transcript_index
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(input.session_id, input.project_id, input.role, content, input.user_id, input.device_id, input.agent ?? "claude-code", createdAt, input.remote_source_id ?? null, input.source_kind ?? "hook", input.transcript_index ?? null);
+    return this.getChatMessageById(Number(result.lastInsertRowid));
+  }
+  getChatMessageById(id) {
+    return this.db.query("SELECT * FROM chat_messages WHERE id = ?").get(id) ?? null;
+  }
+  getChatMessageByRemoteSourceId(remoteSourceId) {
+    return this.db.query("SELECT * FROM chat_messages WHERE remote_source_id = ?").get(remoteSourceId) ?? null;
+  }
+  getSessionChatMessages(sessionId, limit = 50) {
+    return this.db.query(`SELECT * FROM chat_messages
+         WHERE session_id = ?
+           AND (
+             source_kind = 'transcript'
+             OR NOT EXISTS (
+               SELECT 1 FROM chat_messages t2
+               WHERE t2.session_id = chat_messages.session_id
+                 AND t2.source_kind = 'transcript'
+             )
+           )
+         ORDER BY
+           CASE WHEN transcript_index IS NULL THEN created_at_epoch ELSE transcript_index END ASC,
+           id ASC
+         LIMIT ?`).all(sessionId, limit);
+  }
+  getRecentChatMessages(projectId, limit = 20, userId) {
+    const visibilityClause = userId ? " AND user_id = ?" : "";
+    if (projectId !== null) {
+      return this.db.query(`SELECT * FROM chat_messages
+           WHERE project_id = ?${visibilityClause}
+             AND (
+               source_kind = 'transcript'
+               OR NOT EXISTS (
+                 SELECT 1 FROM chat_messages t2
+                 WHERE t2.session_id = chat_messages.session_id
+                   AND t2.source_kind = 'transcript'
+               )
+             )
+           ORDER BY created_at_epoch DESC, id DESC
+           LIMIT ?`).all(projectId, ...userId ? [userId] : [], limit);
+    }
+    return this.db.query(`SELECT * FROM chat_messages
+         WHERE 1 = 1${visibilityClause}
+           AND (
+             source_kind = 'transcript'
+             OR NOT EXISTS (
+               SELECT 1 FROM chat_messages t2
+               WHERE t2.session_id = chat_messages.session_id
+                 AND t2.source_kind = 'transcript'
+             )
+           )
+         ORDER BY created_at_epoch DESC, id DESC
+         LIMIT ?`).all(...userId ? [userId] : [], limit);
+  }
+  searchChatMessages(query, projectId, limit = 20, userId) {
+    const needle = `%${query.toLowerCase()}%`;
+    const visibilityClause = userId ? " AND user_id = ?" : "";
+    if (projectId !== null) {
+      return this.db.query(`SELECT * FROM chat_messages
+           WHERE project_id = ?
+             AND lower(content) LIKE ?${visibilityClause}
+             AND (
+               source_kind = 'transcript'
+               OR NOT EXISTS (
+                 SELECT 1 FROM chat_messages t2
+                 WHERE t2.session_id = chat_messages.session_id
+                   AND t2.source_kind = 'transcript'
+               )
+             )
+           ORDER BY created_at_epoch DESC, id DESC
+           LIMIT ?`).all(projectId, needle, ...userId ? [userId] : [], limit);
+    }
+    return this.db.query(`SELECT * FROM chat_messages
+         WHERE lower(content) LIKE ?${visibilityClause}
+           AND (
+             source_kind = 'transcript'
+             OR NOT EXISTS (
+               SELECT 1 FROM chat_messages t2
+               WHERE t2.session_id = chat_messages.session_id
+                 AND t2.source_kind = 'transcript'
+             )
+           )
+         ORDER BY created_at_epoch DESC, id DESC
+         LIMIT ?`).all(needle, ...userId ? [userId] : [], limit);
+  }
+  getTranscriptChatMessage(sessionId, transcriptIndex) {
+    return this.db.query("SELECT * FROM chat_messages WHERE session_id = ? AND transcript_index = ?").get(sessionId, transcriptIndex) ?? null;
+  }
   addToOutbox(recordType, recordId) {
     const now = Math.floor(Date.now() / 1000);
     this.db.query(`INSERT INTO sync_outbox (record_type, record_id, created_at_epoch)
@@ -1324,9 +1615,9 @@ class MemDatabase {
     };
     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
+          current_thread, 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);
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, summary.current_thread ?? null, 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);
   }
@@ -1342,6 +1633,7 @@ class MemDatabase {
       learned: normalizeSummarySection(summary.learned ?? existing.learned),
       completed: normalizeSummarySection(summary.completed ?? existing.completed),
       next_steps: normalizeSummarySection(summary.next_steps ?? existing.next_steps),
+      current_thread: summary.current_thread ?? existing.current_thread,
       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,
@@ -1355,12 +1647,13 @@ class MemDatabase {
              learned = ?,
              completed = ?,
              next_steps = ?,
+             current_thread = ?,
              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, normalized.capture_state, normalized.recent_tool_names, normalized.hot_files, normalized.recent_outcomes, 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.current_thread, 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) {
@@ -1840,11 +2133,103 @@ function computeObservationPriority(obs, nowEpoch) {
   return computeBlendedScore(obs.quality, obs.created_at_epoch, nowEpoch) + observationTypeBoost(obs.type);
 }
 
-// src/context/inject.ts
-function tokenizeProjectHint(text) {
-  return Array.from(new Set((text.toLowerCase().match(/[a-z0-9_+-]{4,}/g) ?? []).filter(Boolean)));
+// 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,
+    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 parseSummaryJsonList(value) {
+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 [...parseJsonArray(obs.files_modified), ...parseJsonArray(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 parseJsonArray(value) {
   if (!value)
     return [];
   try {
@@ -1854,44 +2239,1043 @@ function parseSummaryJsonList(value) {
     return [];
   }
 }
-function isObservationRelatedToProject(obs, detected) {
-  const hints = new Set([
-    ...tokenizeProjectHint(detected.name),
-    ...tokenizeProjectHint(detected.canonical_id)
-  ]);
-  if (hints.size === 0)
-    return false;
-  const haystack = [
-    obs.title,
-    obs.narrative ?? "",
-    obs.facts ?? "",
-    obs.concepts ?? "",
-    obs.files_read ?? "",
-    obs.files_modified ?? "",
-    obs._source_project ?? ""
-  ].join(` 
- `).toLowerCase();
-  for (const hint of hints) {
-    if (haystack.includes(hint))
+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/save.ts
+import { relative, isAbsolute } from "node:path";
+
+// src/capture/scrubber.ts
+var DEFAULT_PATTERNS = [
+  {
+    source: "sk-[a-zA-Z0-9]{20,}",
+    flags: "g",
+    replacement: "[REDACTED_API_KEY]",
+    description: "OpenAI API keys",
+    category: "api_key",
+    severity: "critical"
+  },
+  {
+    source: "Bearer [a-zA-Z0-9\\-._~+/]+=*",
+    flags: "g",
+    replacement: "[REDACTED_BEARER]",
+    description: "Bearer auth tokens",
+    category: "token",
+    severity: "medium"
+  },
+  {
+    source: "password[=:]\\s*\\S+",
+    flags: "gi",
+    replacement: "password=[REDACTED]",
+    description: "Passwords in config",
+    category: "password",
+    severity: "high"
+  },
+  {
+    source: "postgresql://[^\\s]+",
+    flags: "g",
+    replacement: "[REDACTED_DB_URL]",
+    description: "PostgreSQL connection strings",
+    category: "db_url",
+    severity: "high"
+  },
+  {
+    source: "mongodb://[^\\s]+",
+    flags: "g",
+    replacement: "[REDACTED_DB_URL]",
+    description: "MongoDB connection strings",
+    category: "db_url",
+    severity: "high"
+  },
+  {
+    source: "mysql://[^\\s]+",
+    flags: "g",
+    replacement: "[REDACTED_DB_URL]",
+    description: "MySQL connection strings",
+    category: "db_url",
+    severity: "high"
+  },
+  {
+    source: "AKIA[A-Z0-9]{16}",
+    flags: "g",
+    replacement: "[REDACTED_AWS_KEY]",
+    description: "AWS access keys",
+    category: "api_key",
+    severity: "critical"
+  },
+  {
+    source: "ghp_[a-zA-Z0-9]{36}",
+    flags: "g",
+    replacement: "[REDACTED_GH_TOKEN]",
+    description: "GitHub personal access tokens",
+    category: "token",
+    severity: "high"
+  },
+  {
+    source: "gho_[a-zA-Z0-9]{36}",
+    flags: "g",
+    replacement: "[REDACTED_GH_TOKEN]",
+    description: "GitHub OAuth tokens",
+    category: "token",
+    severity: "high"
+  },
+  {
+    source: "github_pat_[a-zA-Z0-9_]{22,}",
+    flags: "g",
+    replacement: "[REDACTED_GH_TOKEN]",
+    description: "GitHub fine-grained PATs",
+    category: "token",
+    severity: "high"
+  },
+  {
+    source: "cvk_[a-f0-9]{64}",
+    flags: "g",
+    replacement: "[REDACTED_CANDENGO_KEY]",
+    description: "Candengo API keys",
+    category: "api_key",
+    severity: "critical"
+  },
+  {
+    source: "xox[bpras]-[a-zA-Z0-9\\-]+",
+    flags: "g",
+    replacement: "[REDACTED_SLACK_TOKEN]",
+    description: "Slack tokens",
+    category: "token",
+    severity: "high"
+  }
+];
+function compileCustomPatterns(patterns) {
+  const compiled = [];
+  for (const pattern of patterns) {
+    try {
+      new RegExp(pattern);
+      compiled.push({
+        source: pattern,
+        flags: "g",
+        replacement: "[REDACTED_CUSTOM]",
+        description: `Custom pattern: ${pattern}`,
+        category: "custom",
+        severity: "medium"
+      });
+    } catch {}
+  }
+  return compiled;
+}
+function scrubSecrets(text, customPatterns = []) {
+  let result = text;
+  const allPatterns = [...DEFAULT_PATTERNS, ...compileCustomPatterns(customPatterns)];
+  for (const pattern of allPatterns) {
+    result = result.replace(new RegExp(pattern.source, pattern.flags), pattern.replacement);
+  }
+  return result;
+}
+function containsSecrets(text, customPatterns = []) {
+  const allPatterns = [...DEFAULT_PATTERNS, ...compileCustomPatterns(customPatterns)];
+  for (const pattern of allPatterns) {
+    if (new RegExp(pattern.source, pattern.flags).test(text))
       return true;
   }
   return false;
 }
-function estimateTokens(text) {
-  if (!text)
-    return 0;
-  return Math.ceil(text.length / 4);
+
+// src/capture/quality.ts
+var QUALITY_THRESHOLD = 0.1;
+function scoreQuality(input) {
+  let score = 0;
+  switch (input.type) {
+    case "bugfix":
+      score += 0.3;
+      break;
+    case "decision":
+      score += 0.3;
+      break;
+    case "discovery":
+      score += 0.2;
+      break;
+    case "pattern":
+      score += 0.2;
+      break;
+    case "feature":
+      score += 0.15;
+      break;
+    case "refactor":
+      score += 0.15;
+      break;
+    case "change":
+      score += 0.05;
+      break;
+    case "digest":
+      score += 0.3;
+      break;
+    case "standard":
+      score += 0.25;
+      break;
+    case "message":
+      score += 0.1;
+      break;
+  }
+  if (input.narrative && input.narrative.length > 50) {
+    score += 0.15;
+  }
+  if (input.facts) {
+    try {
+      const factsArray = JSON.parse(input.facts);
+      if (factsArray.length >= 2)
+        score += 0.15;
+      else if (factsArray.length === 1)
+        score += 0.05;
+    } catch {
+      if (input.facts.length > 20)
+        score += 0.05;
+    }
+  }
+  if (input.concepts) {
+    try {
+      const conceptsArray = JSON.parse(input.concepts);
+      if (conceptsArray.length >= 1)
+        score += 0.1;
+    } catch {
+      if (input.concepts.length > 10)
+        score += 0.05;
+    }
+  }
+  const modifiedCount = input.filesModified?.length ?? 0;
+  if (modifiedCount >= 3)
+    score += 0.2;
+  else if (modifiedCount >= 1)
+    score += 0.1;
+  if (input.isDuplicate) {
+    score -= 0.3;
+  }
+  return Math.max(0, Math.min(1, score));
 }
-function buildSessionContext(db, cwd, options = {}) {
-  const opts = typeof options === "number" ? { maxCount: options } : options;
-  const tokenBudget = opts.tokenBudget ?? 3000;
-  const maxCount = opts.maxCount;
-  const visibilityClause = opts.userId ? " AND (sensitivity != 'personal' OR user_id = ?)" : "";
-  const visibilityParams = opts.userId ? [opts.userId] : [];
-  const detected = detectProject(cwd);
-  const project = db.getProjectByCanonicalId(detected.canonical_id);
-  const projectId = project?.id ?? -1;
-  const isNewProject = !project;
+function meetsQualityThreshold(input) {
+  return scoreQuality(input) >= QUALITY_THRESHOLD;
+}
+
+// src/capture/facts.ts
+var FACT_ELIGIBLE_TYPES = new Set([
+  "bugfix",
+  "decision",
+  "discovery",
+  "pattern",
+  "feature",
+  "refactor",
+  "change"
+]);
+function buildStructuredFacts(input) {
+  const seedFacts = dedupeFacts(input.facts ?? []);
+  if (!FACT_ELIGIBLE_TYPES.has(input.type)) {
+    return seedFacts;
+  }
+  const derived = [...seedFacts];
+  if (seedFacts.length === 0 && looksMeaningful(input.title)) {
+    derived.push(input.title.trim());
+  }
+  for (const sentence of extractNarrativeFacts(input.narrative)) {
+    derived.push(sentence);
+  }
+  const fileFact = buildFilesFact(input.filesModified);
+  if (fileFact) {
+    derived.push(fileFact);
+  }
+  return dedupeFacts(derived).slice(0, 4);
+}
+function extractNarrativeFacts(narrative) {
+  if (!narrative)
+    return [];
+  const cleaned = narrative.replace(/\s+/g, " ").trim();
+  if (cleaned.length < 24)
+    return [];
+  const parts = cleaned.split(/(?<=[.!?;])\s+/).map((part) => part.trim().replace(/[.!?;]+$/, "")).filter(Boolean).filter(looksMeaningful);
+  return parts.slice(0, 2);
+}
+function buildFilesFact(filesModified) {
+  if (!filesModified || filesModified.length === 0)
+    return null;
+  const cleaned = filesModified.map((file) => file.trim()).filter(Boolean).slice(0, 3);
+  if (cleaned.length === 0)
+    return null;
+  if (cleaned.length === 1) {
+    return `Touched ${cleaned[0]}`;
+  }
+  return `Touched ${cleaned.join(", ")}`;
+}
+function dedupeFacts(facts) {
+  const seen = new Set;
+  const result = [];
+  for (const fact of facts) {
+    const cleaned = fact.trim().replace(/\s+/g, " ");
+    if (!looksMeaningful(cleaned))
+      continue;
+    const key = cleaned.toLowerCase().replace(/\([^)]*\)/g, "").replace(/\s+/g, " ").trim();
+    if (!key || seen.has(key))
+      continue;
+    seen.add(key);
+    result.push(cleaned);
+  }
+  return result;
+}
+function looksMeaningful(value) {
+  const cleaned = value.trim();
+  if (cleaned.length < 12)
+    return false;
+  if (/^[A-Za-z0-9_.\-\/]+\.[A-Za-z0-9]+$/.test(cleaned))
+    return false;
+  if (/^(updated|modified|edited|changed|touched)\s+[A-Za-z0-9_.\-\/]+$/i.test(cleaned))
+    return false;
+  return true;
+}
+
+// src/embeddings/embedder.ts
+var _available = null;
+var _pipeline = null;
+var MODEL_NAME = "Xenova/all-MiniLM-L6-v2";
+async function embedText(text) {
+  const pipe = await getPipeline();
+  if (!pipe)
+    return null;
+  try {
+    const output = await pipe(text, { pooling: "mean", normalize: true });
+    return new Float32Array(output.data);
+  } catch {
+    return null;
+  }
+}
+function composeEmbeddingText(obs) {
+  const parts = [obs.title];
+  if (obs.narrative)
+    parts.push(obs.narrative);
+  if (obs.facts) {
+    try {
+      const facts = JSON.parse(obs.facts);
+      if (Array.isArray(facts) && facts.length > 0) {
+        parts.push(facts.map((f) => `- ${f}`).join(`
+`));
+      }
+    } catch {
+      parts.push(obs.facts);
+    }
+  }
+  if (obs.concepts) {
+    try {
+      const concepts = JSON.parse(obs.concepts);
+      if (Array.isArray(concepts) && concepts.length > 0) {
+        parts.push(concepts.join(", "));
+      }
+    } catch {}
+  }
+  return parts.join(`
+
+`);
+}
+async function getPipeline() {
+  if (_pipeline)
+    return _pipeline;
+  if (_available === false)
+    return null;
+  try {
+    const { pipeline } = await import("@xenova/transformers");
+    _pipeline = await pipeline("feature-extraction", MODEL_NAME);
+    _available = true;
+    return _pipeline;
+  } catch (err) {
+    _available = false;
+    console.error(`[engrm] Local embedding model unavailable: ${err instanceof Error ? err.message : String(err)}`);
+    return null;
+  }
+}
+
+// src/capture/recurrence.ts
+var DISTANCE_THRESHOLD = 0.15;
+async function detectRecurrence(db, config, observation) {
+  if (observation.type !== "bugfix") {
+    return { patternCreated: false };
+  }
+  if (!db.vecAvailable) {
+    return { patternCreated: false };
+  }
+  const text = composeEmbeddingText(observation);
+  const embedding = await embedText(text);
+  if (!embedding) {
+    return { patternCreated: false };
+  }
+  const vecResults = db.searchVec(embedding, null, ["active", "aging", "pinned"], 10);
+  for (const match of vecResults) {
+    if (match.observation_id === observation.id)
+      continue;
+    if (match.distance > DISTANCE_THRESHOLD)
+      continue;
+    const matched = db.getObservationById(match.observation_id);
+    if (!matched)
+      continue;
+    if (matched.type !== "bugfix")
+      continue;
+    if (matched.session_id === observation.session_id)
+      continue;
+    if (await patternAlreadyExists(db, observation, matched))
+      continue;
+    let matchedProjectName;
+    if (matched.project_id !== observation.project_id) {
+      const proj = db.getProjectById(matched.project_id);
+      if (proj)
+        matchedProjectName = proj.name;
+    }
+    const similarity = 1 - match.distance;
+    const result = await saveObservation(db, config, {
+      type: "pattern",
+      title: `Recurring bugfix: ${observation.title}`,
+      narrative: `This bug pattern has appeared in multiple sessions. Original: "${matched.title}" (session ${matched.session_id?.slice(0, 8) ?? "unknown"}). Latest: "${observation.title}". Similarity: ${(similarity * 100).toFixed(0)}%. Consider addressing the root cause.`,
+      facts: [
+        `First seen: ${matched.created_at.split("T")[0]}`,
+        `Recurred: ${observation.created_at.split("T")[0]}`,
+        `Similarity: ${(similarity * 100).toFixed(0)}%`
+      ],
+      concepts: mergeConceptsFromBoth(observation, matched),
+      cwd: process.cwd(),
+      session_id: observation.session_id ?? undefined
+    });
+    if (result.success && result.observation_id) {
+      return {
+        patternCreated: true,
+        patternId: result.observation_id,
+        matchedObservationId: matched.id,
+        matchedProjectName,
+        matchedTitle: matched.title,
+        similarity
+      };
+    }
+  }
+  return { patternCreated: false };
+}
+async function patternAlreadyExists(db, obs1, obs2) {
+  const recentPatterns = db.db.query(`SELECT * FROM observations
+       WHERE type = 'pattern' AND lifecycle IN ('active', 'aging', 'pinned')
+       AND title LIKE ?
+       ORDER BY created_at_epoch DESC LIMIT 5`).all(`%${obs1.title.slice(0, 30)}%`);
+  for (const p of recentPatterns) {
+    if (p.narrative?.includes(obs2.title.slice(0, 30)))
+      return true;
+  }
+  return false;
+}
+function mergeConceptsFromBoth(obs1, obs2) {
+  const concepts = new Set;
+  for (const obs of [obs1, obs2]) {
+    if (obs.concepts) {
+      try {
+        const parsed = JSON.parse(obs.concepts);
+        if (Array.isArray(parsed)) {
+          for (const c of parsed) {
+            if (typeof c === "string")
+              concepts.add(c);
+          }
+        }
+      } catch {}
+    }
+  }
+  return [...concepts];
+}
+
+// src/capture/conflict.ts
+var SIMILARITY_THRESHOLD = 0.25;
+async function detectDecisionConflict(db, observation) {
+  if (observation.type !== "decision") {
+    return { hasConflict: false };
+  }
+  if (!observation.narrative || observation.narrative.trim().length < 20) {
+    return { hasConflict: false };
+  }
+  if (db.vecAvailable) {
+    return detectViaVec(db, observation);
+  }
+  return detectViaFts(db, observation);
+}
+async function detectViaVec(db, observation) {
+  const text = composeEmbeddingText(observation);
+  const embedding = await embedText(text);
+  if (!embedding)
+    return { hasConflict: false };
+  const results = db.searchVec(embedding, observation.project_id, ["active", "aging", "pinned"], 10);
+  for (const match of results) {
+    if (match.observation_id === observation.id)
+      continue;
+    if (match.distance > SIMILARITY_THRESHOLD)
+      continue;
+    const existing = db.getObservationById(match.observation_id);
+    if (!existing)
+      continue;
+    if (existing.type !== "decision")
+      continue;
+    if (!existing.narrative)
+      continue;
+    const conflict = narrativesConflict(observation.narrative, existing.narrative);
+    if (conflict) {
+      return {
+        hasConflict: true,
+        conflictingId: existing.id,
+        conflictingTitle: existing.title,
+        reason: conflict
+      };
+    }
+  }
+  return { hasConflict: false };
+}
+async function detectViaFts(db, observation) {
+  const keywords = observation.title.split(/\s+/).filter((w) => w.length > 3).slice(0, 5).join(" ");
+  if (!keywords)
+    return { hasConflict: false };
+  const ftsResults = db.searchFts(keywords, observation.project_id, ["active", "aging", "pinned"], 10);
+  for (const match of ftsResults) {
+    if (match.id === observation.id)
+      continue;
+    const existing = db.getObservationById(match.id);
+    if (!existing)
+      continue;
+    if (existing.type !== "decision")
+      continue;
+    if (!existing.narrative)
+      continue;
+    const conflict = narrativesConflict(observation.narrative, existing.narrative);
+    if (conflict) {
+      return {
+        hasConflict: true,
+        conflictingId: existing.id,
+        conflictingTitle: existing.title,
+        reason: conflict
+      };
+    }
+  }
+  return { hasConflict: false };
+}
+function narrativesConflict(narrative1, narrative2) {
+  const n1 = narrative1.toLowerCase();
+  const n2 = narrative2.toLowerCase();
+  const opposingPairs = [
+    [["should use", "decided to use", "chose", "prefer", "went with"], ["should not", "decided against", "avoid", "rejected", "don't use"]],
+    [["enable", "turn on", "activate", "add"], ["disable", "turn off", "deactivate", "remove"]],
+    [["increase", "more", "higher", "scale up"], ["decrease", "less", "lower", "scale down"]],
+    [["keep", "maintain", "preserve"], ["replace", "migrate", "switch from", "deprecate"]]
+  ];
+  for (const [positive, negative] of opposingPairs) {
+    const n1HasPositive = positive.some((w) => n1.includes(w));
+    const n1HasNegative = negative.some((w) => n1.includes(w));
+    const n2HasPositive = positive.some((w) => n2.includes(w));
+    const n2HasNegative = negative.some((w) => n2.includes(w));
+    if (n1HasPositive && n2HasNegative || n1HasNegative && n2HasPositive) {
+      return "Narratives suggest opposing conclusions on a similar topic";
+    }
+  }
+  return null;
+}
+
+// src/tools/save.ts
+var VALID_TYPES = [
+  "bugfix",
+  "discovery",
+  "decision",
+  "pattern",
+  "change",
+  "feature",
+  "refactor",
+  "digest",
+  "standard",
+  "message"
+];
+async function saveObservation(db, config, input) {
+  if (!VALID_TYPES.includes(input.type)) {
+    return {
+      success: false,
+      reason: `Invalid type '${input.type}'. Must be one of: ${VALID_TYPES.join(", ")}`
+    };
+  }
+  if (!input.title || input.title.trim().length === 0) {
+    return { success: false, reason: "Title is required" };
+  }
+  const cwd = input.cwd ?? process.cwd();
+  const touchedPaths = [...input.files_read ?? [], ...input.files_modified ?? []];
+  const detected = touchedPaths.length > 0 ? detectProjectFromTouchedPaths(touchedPaths, cwd) : detectProject(cwd);
+  const project = db.upsertProject({
+    canonical_id: detected.canonical_id,
+    name: detected.name,
+    local_path: detected.local_path,
+    remote_url: detected.remote_url
+  });
+  const customPatterns = config.scrubbing.enabled ? config.scrubbing.custom_patterns : [];
+  const title = config.scrubbing.enabled ? scrubSecrets(input.title, customPatterns) : input.title;
+  const narrative = input.narrative ? config.scrubbing.enabled ? scrubSecrets(input.narrative, customPatterns) : input.narrative : null;
+  const conceptsJson = input.concepts ? JSON.stringify(input.concepts) : null;
+  const filesRead = input.files_read ? input.files_read.map((f) => toRelativePath(f, cwd)) : null;
+  const filesModified = input.files_modified ? input.files_modified.map((f) => toRelativePath(f, cwd)) : null;
+  const structuredFacts = buildStructuredFacts({
+    type: input.type,
+    title: input.title,
+    narrative: input.narrative,
+    facts: input.facts,
+    filesModified
+  });
+  const factsJson = structuredFacts.length > 0 ? config.scrubbing.enabled ? scrubSecrets(JSON.stringify(structuredFacts), customPatterns) : JSON.stringify(structuredFacts) : null;
+  const filesReadJson = filesRead ? JSON.stringify(filesRead) : null;
+  const filesModifiedJson = filesModified ? JSON.stringify(filesModified) : null;
+  let sensitivity = input.sensitivity ?? config.scrubbing.default_sensitivity;
+  if (config.scrubbing.enabled && containsSecrets([input.title, input.narrative, JSON.stringify(input.facts)].filter(Boolean).join(" "), customPatterns)) {
+    if (sensitivity === "shared") {
+      sensitivity = "personal";
+    }
+  }
+  const oneDayAgo = Math.floor(Date.now() / 1000) - 86400;
+  const recentObs = db.getRecentObservations(project.id, oneDayAgo);
+  const candidates = recentObs.map((o) => ({
+    id: o.id,
+    title: o.title
+  }));
+  const duplicate = findDuplicate(title, candidates);
+  const qualityInput = {
+    type: input.type,
+    title,
+    narrative,
+    facts: factsJson,
+    concepts: conceptsJson,
+    filesRead,
+    filesModified,
+    isDuplicate: duplicate !== null
+  };
+  const qualityScore = scoreQuality(qualityInput);
+  if (!meetsQualityThreshold(qualityInput)) {
+    return {
+      success: false,
+      quality_score: qualityScore,
+      reason: `Quality score ${qualityScore.toFixed(2)} below threshold`
+    };
+  }
+  if (duplicate) {
+    return {
+      success: true,
+      merged_into: duplicate.id,
+      quality_score: qualityScore,
+      reason: `Merged into existing observation #${duplicate.id}`
+    };
+  }
+  const sourcePromptNumber = input.source_prompt_number ?? (input.session_id ? db.getLatestSessionPromptNumber(input.session_id) : null);
+  const obs = db.insertObservation({
+    session_id: input.session_id ?? null,
+    project_id: project.id,
+    type: input.type,
+    title,
+    narrative,
+    facts: factsJson,
+    concepts: conceptsJson,
+    files_read: filesReadJson,
+    files_modified: filesModifiedJson,
+    quality: qualityScore,
+    lifecycle: "active",
+    sensitivity,
+    user_id: config.user_id,
+    device_id: config.device_id,
+    agent: input.agent ?? "claude-code",
+    source_tool: input.source_tool ?? null,
+    source_prompt_number: sourcePromptNumber
+  });
+  db.addToOutbox("observation", obs.id);
+  if (db.vecAvailable) {
+    try {
+      const text = composeEmbeddingText(obs);
+      const embedding = await embedText(text);
+      if (embedding) {
+        db.vecInsert(obs.id, embedding);
+      }
+    } catch {}
+  }
+  let recallHint;
+  if (input.type === "bugfix") {
+    try {
+      const recurrence = await detectRecurrence(db, config, obs);
+      if (recurrence.patternCreated && recurrence.matchedTitle) {
+        const projectLabel = recurrence.matchedProjectName ? ` in ${recurrence.matchedProjectName}` : "";
+        recallHint = `You solved a similar issue${projectLabel}: "${recurrence.matchedTitle}"`;
+      }
+    } catch {}
+  }
+  let conflictWarning;
+  if (input.type === "decision") {
+    try {
+      const conflict = await detectDecisionConflict(db, obs);
+      if (conflict.hasConflict && conflict.conflictingTitle) {
+        conflictWarning = `Potential conflict with existing decision: "${conflict.conflictingTitle}" — ${conflict.reason}`;
+      }
+    } catch {}
+  }
+  return {
+    success: true,
+    observation_id: obs.id,
+    quality_score: qualityScore,
+    recall_hint: recallHint,
+    conflict_warning: conflictWarning
+  };
+}
+function toRelativePath(filePath, projectRoot) {
+  if (!isAbsolute(filePath))
+    return filePath;
+  const rel = relative(projectRoot, filePath);
+  if (rel.startsWith(".."))
+    return filePath;
+  return rel;
+}
+
+// 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 = parseJsonArray2(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 compactLine(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}] ${compactLine(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 = parseJsonArray2(obs.concepts);
+  return concepts.includes("handoff") || concepts.includes("session-handoff") || concepts.includes("draft-handoff");
+}
+function parseJsonArray2(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 compactLine(value) {
+  const trimmed = value?.replace(/\s+/g, " ").trim();
+  if (!trimmed)
+    return null;
+  return trimmed.length > 120 ? `${trimmed.slice(0, 117)}...` : trimmed;
+}
+
+// src/context/inject.ts
+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),
+    ...tokenizeProjectHint(detected.canonical_id)
+  ]);
+  if (hints.size === 0)
+    return false;
+  const haystack = [
+    obs.title,
+    obs.narrative ?? "",
+    obs.facts ?? "",
+    obs.concepts ?? "",
+    obs.files_read ?? "",
+    obs.files_modified ?? "",
+    obs._source_project ?? ""
+  ].join(` 
+ `).toLowerCase();
+  for (const hint of hints) {
+    if (haystack.includes(hint))
+      return true;
+  }
+  return false;
+}
+function estimateTokens(text) {
+  if (!text)
+    return 0;
+  return Math.ceil(text.length / 4);
+}
+function buildSessionContext(db, cwd, options = {}) {
+  const opts = typeof options === "number" ? { maxCount: options } : options;
+  const tokenBudget = opts.tokenBudget ?? 3000;
+  const maxCount = opts.maxCount;
+  const visibilityClause = opts.userId ? " AND (sensitivity != 'personal' OR user_id = ?)" : "";
+  const visibilityParams = opts.userId ? [opts.userId] : [];
+  const detected = detectProject(cwd);
+  const project = db.getProjectByCanonicalId(detected.canonical_id);
+  const projectId = project?.id ?? -1;
+  const isNewProject = !project;
   const totalActive = isNewProject ? (db.db.query(`SELECT COUNT(*) as c FROM observations
              WHERE lifecycle IN ('active', 'aging', 'pinned')
              ${visibilityClause}
@@ -1986,6 +3370,14 @@ function buildSessionContext(db, cwd, options = {}) {
     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, recentSessions2);
+    const recentHandoffs2 = getRecentHandoffs(db, {
+      cwd,
+      project_scoped: !isNewProject,
+      user_id: opts.userId,
+      current_device_id: opts.currentDeviceId,
+      limit: 3
+    }).handoffs;
+    const recentChatMessages2 = !isNewProject && project ? db.getRecentChatMessages(project.id, 4, opts.userId) : [];
     return {
       project_name: projectName,
       canonical_id: canonicalId,
@@ -1996,7 +3388,9 @@ function buildSessionContext(db, cwd, options = {}) {
       recentToolEvents: recentToolEvents2.length > 0 ? recentToolEvents2 : undefined,
       recentSessions: recentSessions2.length > 0 ? recentSessions2 : undefined,
       projectTypeCounts: projectTypeCounts2,
-      recentOutcomes: recentOutcomes2
+      recentOutcomes: recentOutcomes2,
+      recentHandoffs: recentHandoffs2.length > 0 ? recentHandoffs2 : undefined,
+      recentChatMessages: recentChatMessages2.length > 0 ? recentChatMessages2 : undefined
     };
   }
   let remainingBudget = tokenBudget - 30;
@@ -2024,6 +3418,14 @@ function buildSessionContext(db, cwd, options = {}) {
   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, recentSessions);
+  const recentHandoffs = getRecentHandoffs(db, {
+    cwd,
+    project_scoped: !isNewProject,
+    user_id: opts.userId,
+    current_device_id: opts.currentDeviceId,
+    limit: 3
+  }).handoffs;
+  const recentChatMessages = !isNewProject ? db.getRecentChatMessages(projectId, 4, opts.userId) : [];
   let securityFindings = [];
   if (!isNewProject) {
     try {
@@ -2082,7 +3484,9 @@ function buildSessionContext(db, cwd, options = {}) {
     recentToolEvents: recentToolEvents.length > 0 ? recentToolEvents : undefined,
     recentSessions: recentSessions.length > 0 ? recentSessions : undefined,
     projectTypeCounts,
-    recentOutcomes
+    recentOutcomes,
+    recentHandoffs: recentHandoffs.length > 0 ? recentHandoffs : undefined,
+    recentChatMessages: recentChatMessages.length > 0 ? recentChatMessages : undefined
   };
 }
 function estimateObservationTokens(obs, index) {
@@ -2118,6 +3522,27 @@ function formatContextForInjection(context) {
     lines.push(`${context.session_count} relevant observation(s) from prior sessions:`);
     lines.push("");
   }
+  if (context.recentHandoffs && context.recentHandoffs.length > 0) {
+    lines.push("## Recent Handoffs");
+    for (const handoff of context.recentHandoffs.slice(0, 3)) {
+      const title = handoff.title.replace(/^Handoff(?: Draft)?:\s*/i, "").replace(/\s+·\s+\d{4}-\d{2}-\d{2}\s+\d{2}:\d{2}Z$/, "").trim();
+      if (title) {
+        lines.push(`- ${truncateText(`${title} (${formatHandoffSource(handoff)})`, 160)}`);
+      }
+      const narrative = handoff.narrative?.split(/\n{2,}/).map((part) => part.replace(/\s+/g, " ").trim()).find((part) => /^(Current thread:|Completed:|Next Steps:)/i.test(part));
+      if (narrative) {
+        lines.push(`  ${truncateText(narrative, 180)}`);
+      }
+    }
+    lines.push("");
+  }
+  if (context.recentChatMessages && context.recentChatMessages.length > 0) {
+    lines.push("## Recent Chat");
+    for (const message of context.recentChatMessages.slice(0, 4).reverse()) {
+      lines.push(`- [${message.role}] ${truncateText(message.content.replace(/\s+/g, " ").trim(), 160)}`);
+    }
+    lines.push("");
+  }
   if (context.recentPrompts && context.recentPrompts.length > 0) {
     const promptLines = context.recentPrompts.filter((prompt) => isMeaningfulPrompt(prompt.prompt)).slice(0, 5);
     if (promptLines.length > 0) {
@@ -2233,7 +3658,7 @@ function formatSessionBrief(summary) {
   return lines;
 }
 function chooseMeaningfulSessionHeadline(request, completed) {
-  if (request && !looksLikeFileOperationTitle(request))
+  if (request && !looksLikeFileOperationTitle2(request))
     return request;
   const completedItems = extractMeaningfulLines(completed, 1);
   if (completedItems.length > 0)
@@ -2256,7 +3681,7 @@ function isMeaningfulPrompt(value) {
     return false;
   return /[a-z]{3,}/i.test(compact);
 }
-function looksLikeFileOperationTitle(value) {
+function looksLikeFileOperationTitle2(value) {
   return /^(modified|updated|edited|touched|changed|extended|refactored|redesigned)\s+[A-Za-z0-9_.\-\/]+(?:\s*\([^)]*\))?$/i.test(value.trim());
 }
 function stripInlineSectionLabel(value) {
@@ -2265,7 +3690,7 @@ function stripInlineSectionLabel(value) {
 function extractMeaningfulLines(value, limit) {
   if (!value)
     return [];
-  return extractSummaryItems(value).map((line) => stripInlineSectionLabel(line)).filter((line) => line.length > 0 && !looksLikeFileOperationTitle(line)).slice(0, limit);
+  return extractSummaryItems(value).map((line) => stripInlineSectionLabel(line)).filter((line) => line.length > 0 && !looksLikeFileOperationTitle2(line)).slice(0, limit);
 }
 function formatObservationDetailFromContext(obs) {
   if (obs.facts) {
@@ -2421,7 +3846,7 @@ function getRecentOutcomes(db, projectId, userId, recentSessions) {
       continue;
     const title = stripInlineSectionLabel(obs.title);
     const normalized = title.toLowerCase().replace(/\s+/g, " ").trim();
-    if (!normalized || seen.has(normalized) || looksLikeFileOperationTitle(title))
+    if (!normalized || seen.has(normalized) || looksLikeFileOperationTitle2(title))
       continue;
     seen.add(normalized);
     picked.push(title);
@@ -2431,6 +3856,169 @@ function getRecentOutcomes(db, projectId, userId, recentSessions) {
   return picked;
 }
 
+// src/capture/transcript.ts
+import { readFileSync as readFileSync3, existsSync as existsSync3 } from "node:fs";
+import { join as join3 } from "node:path";
+import { homedir as homedir2 } from "node:os";
+function resolveTranscriptPath(sessionId, cwd, transcriptPath) {
+  if (transcriptPath)
+    return transcriptPath;
+  const encodedCwd = cwd.replace(/\//g, "-");
+  return join3(homedir2(), ".claude", "projects", encodedCwd, `${sessionId}.jsonl`);
+}
+function readTranscript(sessionId, cwd, transcriptPath) {
+  const path = resolveTranscriptPath(sessionId, cwd, transcriptPath);
+  if (!existsSync3(path))
+    return [];
+  let raw;
+  try {
+    raw = readFileSync3(path, "utf-8");
+  } catch {
+    return [];
+  }
+  const messages = [];
+  for (const line of raw.split(`
+`)) {
+    if (!line.trim())
+      continue;
+    let entry;
+    try {
+      entry = JSON.parse(line);
+    } catch {
+      continue;
+    }
+    const role = entry.role;
+    if (role !== "user" && role !== "assistant")
+      continue;
+    const content = entry.content;
+    if (typeof content === "string") {
+      messages.push({ role, text: content });
+      continue;
+    }
+    if (Array.isArray(content)) {
+      const textParts = [];
+      for (const block of content) {
+        if (block.type === "text" && typeof block.text === "string") {
+          textParts.push(block.text);
+        }
+      }
+      if (textParts.length > 0) {
+        messages.push({ role, text: textParts.join(`
+`) });
+      }
+    }
+  }
+  return messages;
+}
+function syncTranscriptChat(db, config, sessionId, cwd, transcriptPath) {
+  const messages = readTranscript(sessionId, cwd, transcriptPath).map((message) => ({
+    ...message,
+    text: message.text.trim()
+  })).filter((message) => message.text.length > 0);
+  if (messages.length === 0)
+    return { imported: 0, total: 0 };
+  const session = db.getSessionById(sessionId);
+  const projectId = session?.project_id ?? null;
+  const now = Math.floor(Date.now() / 1000);
+  let imported = 0;
+  for (let index = 0;index < messages.length; index++) {
+    const transcriptIndex = index + 1;
+    if (db.getTranscriptChatMessage(sessionId, transcriptIndex))
+      continue;
+    const message = messages[index];
+    const createdAtEpoch = Math.max(0, now - (messages.length - transcriptIndex));
+    const row = db.insertChatMessage({
+      session_id: sessionId,
+      project_id: projectId,
+      role: message.role,
+      content: message.text,
+      user_id: config.user_id,
+      device_id: config.device_id,
+      agent: "claude-code",
+      created_at_epoch: createdAtEpoch,
+      source_kind: "transcript",
+      transcript_index: transcriptIndex
+    });
+    db.addToOutbox("chat_message", row.id);
+    imported++;
+  }
+  return { imported, total: messages.length };
+}
+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) {
   if (observations.length === 0)
@@ -2483,9 +4071,19 @@ async function main() {
     process.exit(0);
   }
   try {
+    let importedChat = 0;
+    if (event.session_id) {
+      const chatSync = syncTranscriptChat(db, config, event.session_id, event.cwd);
+      importedChat = chatSync.imported;
+      await upsertRollingHandoff(db, config, {
+        session_id: event.session_id,
+        cwd: event.cwd
+      });
+    }
     const context = buildSessionContext(db, event.cwd, {
       tokenBudget: 800,
-      scope: config.search.scope
+      scope: config.search.scope,
+      currentDeviceId: config.device_id
     });
     if (context && context.observations.length > 0) {
       console.log(formatContextForInjection(context));
@@ -2511,6 +4109,9 @@ async function main() {
     if (sessionCount > 0) {
       console.error(`Engrm: ${sessionCount} session observation(s) carried forward`);
     }
+    if (importedChat > 0) {
+      console.error(`Engrm: ${importedChat} transcript chat message(s) preserved before compaction`);
+    }
   } finally {
     db.close();
   }