engrm 0.4.23 → 0.4.26

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

@@ -873,6 +873,19 @@ var MIGRATIONS = [
       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;
+    `
   }
 ];
 function isVecExtensionLoaded(db) {
@@ -943,6 +956,9 @@ function inferLegacySchemaVersion(db) {
   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) {
@@ -1046,9 +1062,17 @@ function ensureChatMessageColumns(db) {
     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 < 15) {
-    db.exec("PRAGMA user_version = 15");
+  if (current < 17) {
+    db.exec("PRAGMA user_version = 17");
   }
 }
 function ensureSyncOutboxSupportsChatMessages(db) {
@@ -1333,6 +1357,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 [];
@@ -1604,8 +1644,8 @@ class MemDatabase {
     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
-        ) 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);
+          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) {
@@ -1617,7 +1657,17 @@ class MemDatabase {
   getSessionChatMessages(sessionId, limit = 50) {
     return this.db.query(`SELECT * FROM chat_messages
          WHERE session_id = ?
-         ORDER BY created_at_epoch ASC, id ASC
+           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) {
@@ -1625,11 +1675,27 @@ class MemDatabase {
     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);
   }
@@ -1640,14 +1706,33 @@ class MemDatabase {
       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)
@@ -3562,6 +3647,580 @@ function parseJsonArray(value) {
   }
 }
 
+// src/capture/transcript.ts
+import { readFileSync as readFileSync4, existsSync as existsSync4 } from "node:fs";
+import { join as join4 } from "node:path";
+import { homedir as homedir3 } from "node:os";
+function resolveTranscriptPath(sessionId, cwd, transcriptPath) {
+  if (transcriptPath)
+    return transcriptPath;
+  const encodedCwd = cwd.replace(/\//g, "-");
+  return join4(homedir3(), ".claude", "projects", encodedCwd, `${sessionId}.jsonl`);
+}
+function readTranscript(sessionId, cwd, transcriptPath) {
+  const path = resolveTranscriptPath(sessionId, cwd, transcriptPath);
+  if (!existsSync4(path))
+    return [];
+  let raw;
+  try {
+    raw = readFileSync4(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;
+}
+
+// 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 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 [...parseJsonArray2(obs.files_modified), ...parseJsonArray2(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 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 looksLikeFileOperationTitle(value) {
+  return /^(modified|updated|edited|touched|changed|extended|refactored|redesigned)\s+[A-Za-z0-9_.\-\/]+(?:\s*\([^)]*\))?$/i.test(value.trim());
+}
+function collectProvenanceSummary(observations) {
+  const counts = new Map;
+  for (const obs of observations) {
+    if (!obs.source_tool)
+      continue;
+    counts.set(obs.source_tool, (counts.get(obs.source_tool) ?? 0) + 1);
+  }
+  return Array.from(counts.entries()).map(([tool, count]) => ({ tool, count })).sort((a, b) => b.count - a.count || a.tool.localeCompare(b.tool)).slice(0, 6);
+}
+
+// src/tools/handoffs.ts
+async function upsertRollingHandoff(db, config, input) {
+  const resolved = resolveTargetSession(db, input.cwd, config.user_id, input.session_id);
+  if (!resolved.session) {
+    return {
+      success: false,
+      reason: "No recent session found to draft a handoff yet"
+    };
+  }
+  const story = getSessionStory(db, { session_id: resolved.session.session_id });
+  if (!story.session) {
+    return {
+      success: false,
+      reason: `Session ${resolved.session.session_id} not found`
+    };
+  }
+  const includeChat = input.include_chat === true || input.include_chat !== false && shouldAutoIncludeChat(story);
+  const chatLimit = Math.max(1, Math.min(input.chat_limit ?? 3, 6));
+  const title = `Handoff Draft: ${buildHandoffTitle(story.summary, story.latest_request)}`;
+  const narrative = buildHandoffNarrative(story.summary, story, {
+    includeChat,
+    chatLimit
+  });
+  const facts = buildHandoffFacts(story.summary, story);
+  const concepts = buildDraftHandoffConcepts(story.project_name, story.capture_state);
+  const existing = getSessionRollingHandoff(db, story.session.session_id);
+  const now = Math.floor(Date.now() / 1000);
+  if (existing) {
+    const nextFacts = JSON.stringify(facts);
+    const nextConcepts = JSON.stringify(concepts);
+    const shouldRefresh = existing.title !== title || (existing.narrative ?? null) !== narrative || (existing.facts ?? null) !== nextFacts || (existing.concepts ?? null) !== nextConcepts || now - existing.created_at_epoch >= 120;
+    if (!shouldRefresh) {
+      return {
+        success: true,
+        observation_id: existing.id,
+        session_id: story.session.session_id,
+        title: existing.title
+      };
+    }
+    const updated = db.updateObservationContent(existing.id, {
+      title,
+      narrative,
+      facts: nextFacts,
+      concepts: nextConcepts,
+      created_at_epoch: now
+    });
+    if (!updated) {
+      return {
+        success: false,
+        reason: "Failed to update rolling handoff draft"
+      };
+    }
+    db.addToOutbox("observation", updated.id);
+    return {
+      success: true,
+      observation_id: updated.id,
+      session_id: story.session.session_id,
+      title: updated.title
+    };
+  }
+  const result = await saveObservation(db, config, {
+    type: "message",
+    title,
+    narrative,
+    facts,
+    concepts,
+    session_id: story.session.session_id,
+    cwd: input.cwd,
+    agent: "engrm-handoff",
+    source_tool: "rolling_handoff"
+  });
+  return {
+    success: result.success,
+    observation_id: result.observation_id,
+    session_id: story.session.session_id,
+    title,
+    reason: result.reason
+  };
+}
+function getRecentHandoffs(db, input) {
+  const limit = Math.max(1, Math.min(input.limit ?? 10, 25));
+  const queryLimit = input.current_device_id ? Math.max(limit, Math.min(limit * 5, 50)) : limit;
+  const projectScoped = input.project_scoped !== false;
+  let projectId = null;
+  let projectName;
+  if (projectScoped) {
+    const cwd = input.cwd ?? process.cwd();
+    const detected = detectProject(cwd);
+    const project = db.getProjectByCanonicalId(detected.canonical_id);
+    if (project) {
+      projectId = project.id;
+      projectName = project.name;
+    }
+  }
+  const conditions = [
+    "o.type = 'message'",
+    "o.lifecycle IN ('active', 'aging', 'pinned')",
+    "o.superseded_by IS NULL",
+    `(o.title LIKE 'Handoff:%' OR o.concepts LIKE '%"handoff"%')`
+  ];
+  const params = [];
+  if (input.user_id) {
+    conditions.push("(o.sensitivity != 'personal' OR o.user_id = ?)");
+    params.push(input.user_id);
+  }
+  if (projectId !== null) {
+    conditions.push("o.project_id = ?");
+    params.push(projectId);
+  }
+  params.push(queryLimit);
+  const handoffs = db.db.query(`SELECT o.*, p.name AS project_name
+       FROM observations o
+       LEFT JOIN projects p ON p.id = o.project_id
+       WHERE ${conditions.join(" AND ")}
+      ORDER BY o.created_at_epoch DESC, o.id DESC
+      LIMIT ?`).all(...params);
+  handoffs.sort((a, b) => compareHandoffs(a, b, input.current_device_id));
+  return {
+    handoffs: handoffs.slice(0, limit),
+    project: projectName
+  };
+}
+function formatHandoffSource(handoff) {
+  const ageSeconds = Math.max(0, Math.floor(Date.now() / 1000) - handoff.created_at_epoch);
+  const ageLabel = ageSeconds < 3600 ? `${Math.max(1, Math.floor(ageSeconds / 60) || 1)}m ago` : ageSeconds < 86400 ? `${Math.floor(ageSeconds / 3600)}h ago` : `${Math.floor(ageSeconds / 86400)}d ago`;
+  return `from ${handoff.device_id} · ${ageLabel}`;
+}
+function isDraftHandoff(obs) {
+  if (obs.title.startsWith("Handoff Draft:"))
+    return true;
+  const concepts = parseJsonArray3(obs.concepts);
+  return concepts.includes("draft-handoff") || concepts.includes("auto-handoff");
+}
+function getSessionRollingHandoff(db, sessionId) {
+  return db.db.query(`SELECT o.*, p.name AS project_name
+       FROM observations o
+       LEFT JOIN projects p ON p.id = o.project_id
+       WHERE o.session_id = ?
+         AND o.type = 'message'
+         AND o.lifecycle IN ('active', 'aging', 'pinned')
+         AND o.superseded_by IS NULL
+         AND (o.title LIKE 'Handoff Draft:%' OR o.concepts LIKE '%"draft-handoff"%')
+       ORDER BY o.created_at_epoch DESC, o.id DESC
+       LIMIT 1`).get(sessionId) ?? null;
+}
+function compareHandoffs(a, b, currentDeviceId) {
+  const aDraft = isDraftHandoff(a) ? 1 : 0;
+  const bDraft = isDraftHandoff(b) ? 1 : 0;
+  if (aDraft !== bDraft)
+    return aDraft - bDraft;
+  if (currentDeviceId) {
+    const aOther = a.device_id !== currentDeviceId ? 1 : 0;
+    const bOther = b.device_id !== currentDeviceId ? 1 : 0;
+    if (aOther !== bOther)
+      return bOther - aOther;
+  }
+  if (b.created_at_epoch !== a.created_at_epoch) {
+    return b.created_at_epoch - a.created_at_epoch;
+  }
+  return b.id - a.id;
+}
+function resolveTargetSession(db, cwd, userId, sessionId) {
+  if (sessionId) {
+    const session = db.getSessionById(sessionId);
+    if (!session)
+      return { session: null };
+    const projectName = session.project_id ? db.getProjectById(session.project_id)?.name : undefined;
+    return {
+      session: {
+        ...session,
+        project_name: projectName ?? null,
+        request: db.getSessionSummary(sessionId)?.request ?? null,
+        completed: db.getSessionSummary(sessionId)?.completed ?? null,
+        current_thread: db.getSessionSummary(sessionId)?.current_thread ?? null,
+        capture_state: db.getSessionSummary(sessionId)?.capture_state ?? null,
+        recent_tool_names: db.getSessionSummary(sessionId)?.recent_tool_names ?? null,
+        hot_files: db.getSessionSummary(sessionId)?.hot_files ?? null,
+        recent_outcomes: db.getSessionSummary(sessionId)?.recent_outcomes ?? null,
+        prompt_count: db.getSessionUserPrompts(sessionId, 200).length,
+        tool_event_count: db.getSessionToolEvents(sessionId, 200).length
+      },
+      projectName: projectName ?? undefined
+    };
+  }
+  const detected = detectProject(cwd ?? process.cwd());
+  const project = db.getProjectByCanonicalId(detected.canonical_id);
+  const sessions = db.getRecentSessions(project?.id ?? null, 10, userId);
+  return {
+    session: sessions[0] ?? null,
+    projectName: project?.name
+  };
+}
+function buildHandoffTitle(summary, latestRequest, explicit) {
+  const chosen = explicit?.trim() || summary?.current_thread?.trim() || summary?.completed?.trim() || latestRequest?.trim() || "Current work";
+  return compactLine2(chosen) ?? "Current work";
+}
+function buildHandoffNarrative(summary, story, options) {
+  const sections = [];
+  if (summary?.request || story.latest_request) {
+    sections.push(`Request: ${summary?.request ?? story.latest_request}`);
+  }
+  if (summary?.current_thread) {
+    sections.push(`Current thread: ${summary.current_thread}`);
+  }
+  if (summary?.investigated) {
+    sections.push(`Investigated: ${summary.investigated}`);
+  }
+  if (summary?.learned) {
+    sections.push(`Learned: ${summary.learned}`);
+  }
+  if (summary?.completed) {
+    sections.push(`Completed: ${summary.completed}`);
+  }
+  if (summary?.next_steps) {
+    sections.push(`Next Steps: ${summary.next_steps}`);
+  }
+  if (story.recent_outcomes.length > 0) {
+    sections.push(`Recent outcomes:
+${story.recent_outcomes.slice(0, 5).map((item) => `- ${item}`).join(`
+`)}`);
+  }
+  if (story.hot_files.length > 0) {
+    sections.push(`Hot files:
+${story.hot_files.slice(0, 5).map((file) => `- ${file.path}`).join(`
+`)}`);
+  }
+  if (story.provenance_summary.length > 0) {
+    sections.push(`Tool trail:
+${story.provenance_summary.slice(0, 5).map((item) => `- ${item.tool}: ${item.count}`).join(`
+`)}`);
+  }
+  if (options.includeChat && story.chat_messages.length > 0) {
+    const chatLines = story.chat_messages.slice(-options.chatLimit).map((msg) => `- [${msg.role}] ${compactLine2(msg.content) ?? msg.content.slice(0, 120)}`);
+    sections.push(`Chat snippets:
+${chatLines.join(`
+`)}`);
+  }
+  return sections.filter(Boolean).join(`
+
+`);
+}
+function shouldAutoIncludeChat(story) {
+  if (story.chat_messages.length === 0)
+    return false;
+  const summary = story.summary;
+  const thinSummary = !summary?.completed && !summary?.current_thread && story.recent_outcomes.length < 2;
+  const thinChronology = story.capture_state !== "rich" || story.tool_events.length === 0;
+  return thinSummary || thinChronology;
+}
+function buildHandoffFacts(summary, story) {
+  const facts = [
+    `session_id=${story.session?.session_id ?? "unknown"}`,
+    `capture_state=${story.capture_state}`,
+    story.project_name ? `project=${story.project_name}` : null,
+    summary?.current_thread ? `current_thread=${summary.current_thread}` : null,
+    story.hot_files[0] ? `hot_file=${story.hot_files[0].path}` : null,
+    story.provenance_summary[0] ? `primary_tool=${story.provenance_summary[0].tool}` : null
+  ];
+  return facts.filter((item) => Boolean(item));
+}
+function buildDraftHandoffConcepts(projectName, captureState) {
+  return [
+    "handoff",
+    "draft-handoff",
+    "auto-handoff",
+    `capture:${captureState}`,
+    ...projectName ? [projectName] : []
+  ];
+}
+function looksLikeHandoff(obs) {
+  if (obs.title.startsWith("Handoff:") || obs.title.startsWith("Handoff Draft:"))
+    return true;
+  const concepts = parseJsonArray3(obs.concepts);
+  return concepts.includes("handoff") || concepts.includes("session-handoff") || concepts.includes("draft-handoff");
+}
+function parseJsonArray3(value) {
+  if (!value)
+    return [];
+  try {
+    const parsed = JSON.parse(value);
+    return Array.isArray(parsed) ? parsed.filter((item) => typeof item === "string" && item.trim().length > 0) : [];
+  } catch {
+    return [];
+  }
+}
+function compactLine2(value) {
+  const trimmed = value?.replace(/\s+/g, " ").trim();
+  if (!trimmed)
+    return null;
+  return trimmed.length > 120 ? `${trimmed.slice(0, 117)}...` : trimmed;
+}
+
 // hooks/post-tool-use.ts
 async function main() {
   const raw = await readStdin();
@@ -3589,6 +4248,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);
     }
     const textToScan = extractScanText(event);
     if (textToScan) {
@@ -3666,7 +4326,7 @@ async function main() {
         }), 1000);
         if (observed) {
           const result = await saveObservation(db, config, observed);
-          updateRollingSummaryFromObservation(db, result.observation_id, event, config.user_id);
+          await updateRollingSummaryFromObservation(db, result.observation_id, event, config.user_id, config);
           incrementObserverSaveCount(event.session_id);
           saved = true;
         }
@@ -3685,7 +4345,7 @@ async function main() {
           cwd: event.cwd,
           source_tool: event.tool_name
         });
-        updateRollingSummaryFromObservation(db, result.observation_id, event, config.user_id);
+        await updateRollingSummaryFromObservation(db, result.observation_id, event, config.user_id, config);
         incrementObserverSaveCount(event.session_id);
       }
     }
@@ -3750,7 +4410,7 @@ function detectProjectForEvent(event) {
   const touchedPaths = extractTouchedPaths(event);
   return touchedPaths.length > 0 ? detectProjectFromTouchedPaths(touchedPaths, event.cwd) : detectProject(event.cwd);
 }
-function updateRollingSummaryFromObservation(db, observationId, event, userId) {
+async function updateRollingSummaryFromObservation(db, observationId, event, userId, config) {
   if (!observationId || !event.session_id)
     return;
   const observation = db.getObservationById(observationId);
@@ -3782,6 +4442,10 @@ function updateRollingSummaryFromObservation(db, observationId, event, userId) {
     recent_outcomes: JSON.stringify(handoff.recent_outcomes)
   });
   db.addToOutbox("summary", summary.id);
+  await upsertRollingHandoff(db, config, {
+    session_id: event.session_id,
+    cwd: event.cwd
+  });
 }
 function extractTouchedPaths(event) {
   const paths = [];
@@ -3853,16 +4517,16 @@ function extractScanText(event) {
 }
 function incrementRecallMetrics(sessionId, hit) {
   try {
-    const { existsSync: existsSync4, readFileSync: readFileSync4, writeFileSync: writeFileSync3, mkdirSync: mkdirSync3 } = __require("node:fs");
-    const { join: join4 } = __require("node:path");
-    const { homedir: homedir3 } = __require("node:os");
-    const dir = join4(homedir3(), ".engrm", "observer-sessions");
-    const path = join4(dir, `${sessionId}.json`);
+    const { existsSync: existsSync5, readFileSync: readFileSync5, writeFileSync: writeFileSync3, mkdirSync: mkdirSync3 } = __require("node:fs");
+    const { join: join5 } = __require("node:path");
+    const { homedir: homedir4 } = __require("node:os");
+    const dir = join5(homedir4(), ".engrm", "observer-sessions");
+    const path = join5(dir, `${sessionId}.json`);
     let state = {};
-    if (existsSync4(path)) {
-      state = JSON.parse(readFileSync4(path, "utf-8"));
+    if (existsSync5(path)) {
+      state = JSON.parse(readFileSync5(path, "utf-8"));
     } else {
-      if (!existsSync4(dir))
+      if (!existsSync5(dir))
         mkdirSync3(dir, { recursive: true });
     }
     state.recallAttempts = (state.recallAttempts || 0) + 1;