@askexenow/exe-os 0.9.12 → 0.9.13

package/dist/hooks/session-start.js

@@ -2827,12 +2827,26 @@ async function ensureSchema() {
       session_name TEXT,
       task_id TEXT,
       project_name TEXT,
-      started_at TEXT NOT NULL
+      started_at TEXT NOT NULL,
+      cache_cold_count INTEGER NOT NULL DEFAULT 0
     );
 
     CREATE INDEX IF NOT EXISTS idx_session_agent_map_agent
       ON session_agent_map(agent_id);
   `);
+  await client.executeMultiple(`
+    CREATE TABLE IF NOT EXISTS agent_file_reads (
+      session_uuid TEXT NOT NULL,
+      agent_id TEXT NOT NULL,
+      file_path TEXT NOT NULL,
+      read_at TEXT NOT NULL,
+      commit_hash TEXT,
+      PRIMARY KEY (session_uuid, file_path)
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_agent_file_reads_agent_read_at
+      ON agent_file_reads(agent_id, read_at);
+  `);
   try {
     const mapCount = await client.execute({ sql: `SELECT COUNT(*) as cnt FROM session_agent_map`, args: [] });
     if (Number(mapCount.rows[0]?.cnt ?? 0) === 0) {
@@ -2847,6 +2861,13 @@ async function ensureSchema() {
     }
   } catch {
   }
+  try {
+    await client.execute({
+      sql: `ALTER TABLE session_agent_map ADD COLUMN cache_cold_count INTEGER NOT NULL DEFAULT 0`,
+      args: []
+    });
+  } catch {
+  }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN budget_tokens INTEGER`,
@@ -4493,8 +4514,8 @@ async function embedDirect(text) {
   const llamaCpp = await import("node-llama-cpp");
   const { MODELS_DIR: MODELS_DIR2 } = await Promise.resolve().then(() => (init_config(), config_exports));
   const { existsSync: existsSync16 } = await import("fs");
-  const path19 = await import("path");
-  const modelPath = path19.join(MODELS_DIR2, "jina-embeddings-v5-small-q4_k_m.gguf");
+  const path20 = await import("path");
+  const modelPath = path20.join(MODELS_DIR2, "jina-embeddings-v5-small-q4_k_m.gguf");
   if (!existsSync16(modelPath)) {
     throw new Error(`Embedding model not found at ${modelPath}. Run '/exe-setup' to download it.`);
   }
@@ -6471,9 +6492,240 @@ var init_task_scope = __esm({
   }
 });
 
+// src/lib/catchup-brief.ts
+var catchup_brief_exports = {};
+__export(catchup_brief_exports, {
+  buildCatchupBrief: () => buildCatchupBrief
+});
+import { execSync as execSync7 } from "child_process";
+function clipText(text, maxChars) {
+  if (text.length <= maxChars) return text;
+  if (maxChars <= 1) return "\u2026";
+  return `${text.slice(0, maxChars - 1).trimEnd()}\u2026`;
+}
+function clampSections(header, sections, maxChars) {
+  const bounded = [];
+  let remaining = Math.max(0, maxChars - header.length);
+  for (const section of sections) {
+    const separatorChars = 2;
+    if (remaining <= separatorChars) break;
+    remaining -= separatorChars;
+    if (section.length <= remaining) {
+      bounded.push(section);
+      remaining -= section.length;
+      continue;
+    }
+    const clipped = clipText(section, remaining);
+    if (clipped.trim().length > 0) bounded.push(clipped);
+    break;
+  }
+  return bounded;
+}
+async function buildCatchupBrief(agentId, projectName, cwd, sessionScope) {
+  const sections = [];
+  let lastTimestamp = new Date(Date.now() - DEFAULT_LOOKBACK_MS).toISOString();
+  try {
+    const checkpointMemories = await lightweightSearch(
+      "CONTEXT CHECKPOINT",
+      agentId,
+      { projectName, limit: 1 }
+    );
+    const checkpoint = checkpointMemories[0];
+    if (checkpoint?.timestamp) {
+      lastTimestamp = checkpoint.timestamp;
+    }
+    if (checkpoint?.raw_text) {
+      sections.push(
+        `### Last Checkpoint
+${clipText(checkpoint.raw_text, MAX_CHECKPOINT_CHARS)}`
+      );
+    }
+  } catch {
+  }
+  try {
+    const gitLog = execSync7(
+      `git log --oneline --since=${JSON.stringify(lastTimestamp)} --format="%h %an: %s" | head -10`,
+      { cwd, timeout: 3e3, encoding: "utf-8" }
+    ).trim();
+    if (gitLog) {
+      sections.push(`### Git Activity Since You Left
+\`\`\`
+${gitLog}
+\`\`\``);
+    }
+  } catch {
+  }
+  try {
+    const client = getClient();
+    const taskScope = sessionScopeFilter(sessionScope);
+    const taskChanges = await client.execute({
+      sql: `SELECT title, status, priority FROM tasks
+            WHERE assigned_to = ? AND project_name = ?
+              AND updated_at > ? AND status IN ('open', 'in_progress')${taskScope.sql}
+            ORDER BY priority ASC, updated_at DESC LIMIT 5`,
+      args: [agentId, projectName, lastTimestamp, ...taskScope.args]
+    });
+    if (taskChanges.rows.length > 0) {
+      const taskLines = taskChanges.rows.map((row) => {
+        const record = row;
+        return `- [${String(record.priority).toUpperCase()}] ${String(record.title)} (${String(record.status)})`;
+      }).join("\n");
+      sections.push(`### Your Task Queue
+${taskLines}`);
+    }
+  } catch {
+  }
+  try {
+    const client = getClient();
+    const messageScope = strictSessionScopeFilter(sessionScope);
+    const messages = await client.execute({
+      sql: `SELECT from_agent, content, created_at FROM messages
+            WHERE target_agent = ? AND status = 'pending'${messageScope.sql}
+            ORDER BY created_at DESC LIMIT 3`,
+      args: [agentId, ...messageScope.args]
+    });
+    if (messages.rows.length > 0) {
+      const msgLines = messages.rows.map((row) => {
+        const record = row;
+        return `- From ${String(record.from_agent)}: ${clipText(String(record.content ?? ""), MAX_MESSAGE_CHARS)}`;
+      }).join("\n");
+      sections.push(`### Unread Messages
+${msgLines}`);
+    }
+  } catch {
+  }
+  return {
+    header: HEADER,
+    sections: clampSections(HEADER, sections, MAX_BRIEF_CHARS)
+  };
+}
+var HEADER, DEFAULT_LOOKBACK_MS, MAX_BRIEF_CHARS, MAX_CHECKPOINT_CHARS, MAX_MESSAGE_CHARS;
+var init_catchup_brief = __esm({
+  "src/lib/catchup-brief.ts"() {
+    "use strict";
+    init_database();
+    init_hybrid_search();
+    init_task_scope();
+    HEADER = "## Catchup Brief\nHere's what happened while you were offline:";
+    DEFAULT_LOOKBACK_MS = 60 * 60 * 1e3;
+    MAX_BRIEF_CHARS = 2e3;
+    MAX_CHECKPOINT_CHARS = 500;
+    MAX_MESSAGE_CHARS = 100;
+  }
+});
+
+// src/lib/git-staleness.ts
+var git_staleness_exports = {};
+__export(git_staleness_exports, {
+  clearSessionFileReads: () => clearSessionFileReads,
+  detectStaleFiles: () => detectStaleFiles,
+  recordFileRead: () => recordFileRead
+});
+import { execSync as execSync8 } from "child_process";
+import path18 from "path";
+function getHeadCommit(cwd) {
+  try {
+    return execSync8("git rev-parse --short HEAD", {
+      cwd,
+      timeout: GIT_TIMEOUT_MS,
+      encoding: "utf-8"
+    }).trim() || null;
+  } catch {
+    return null;
+  }
+}
+function normalizeTrackedPath(cwd, filePath) {
+  const resolved = path18.resolve(cwd, filePath);
+  const relative = path18.relative(cwd, resolved);
+  if (!relative || relative.startsWith("..") || path18.isAbsolute(relative)) {
+    return null;
+  }
+  return relative;
+}
+function formatGitSummary(filePath, summary) {
+  const match = summary.trim().match(/^([a-f0-9]+)\s+([^:]+):\s+(.+)$/i);
+  if (!match) return `${filePath} (${summary.trim()})`;
+  const [, hash, author, subject] = match;
+  return `${filePath} (modified by ${author} in commit ${hash}: "${subject}")`;
+}
+async function recordFileRead(sessionUuid, agentId, cwd, filePath) {
+  if (!sessionUuid || !filePath) return;
+  const trackedPath = normalizeTrackedPath(cwd, filePath);
+  if (!trackedPath) return;
+  const client = getClient();
+  await client.execute({
+    sql: `INSERT INTO agent_file_reads (session_uuid, agent_id, file_path, read_at, commit_hash)
+          VALUES (?, ?, ?, ?, ?)
+          ON CONFLICT(session_uuid, file_path) DO UPDATE SET
+            read_at = excluded.read_at,
+            commit_hash = excluded.commit_hash`,
+    args: [
+      sessionUuid,
+      agentId,
+      trackedPath,
+      (/* @__PURE__ */ new Date()).toISOString(),
+      getHeadCommit(cwd)
+    ]
+  });
+}
+async function detectStaleFiles(agentId, cwd) {
+  const client = getClient();
+  const recentCutoff = new Date(Date.now() - RECENT_READ_LOOKBACK_MS).toISOString();
+  const result = await client.execute({
+    sql: `SELECT file_path, MAX(read_at) AS read_at
+          FROM agent_file_reads
+          WHERE agent_id = ? AND read_at >= ?
+          GROUP BY file_path
+          ORDER BY MAX(read_at) DESC
+          LIMIT 10`,
+    args: [agentId, recentCutoff]
+  });
+  const stale = [];
+  for (const row of result.rows) {
+    if (stale.length >= MAX_STALE_FILES) break;
+    const record = row;
+    const filePath = String(record.file_path ?? "");
+    const readAt = String(record.read_at ?? "");
+    if (!filePath || !readAt) continue;
+    try {
+      const gitSummary = execSync8(
+        `git log -1 --oneline --after=${JSON.stringify(readAt)} --format="%h %an: %s" -- ${JSON.stringify(filePath)}`,
+        {
+          cwd,
+          timeout: GIT_TIMEOUT_MS,
+          encoding: "utf-8"
+        }
+      ).trim();
+      if (gitSummary) {
+        stale.push(formatGitSummary(filePath, gitSummary));
+      }
+    } catch {
+    }
+  }
+  return stale.slice(0, MAX_STALE_FILES);
+}
+async function clearSessionFileReads(sessionUuid) {
+  if (!sessionUuid) return;
+  const client = getClient();
+  await client.execute({
+    sql: "DELETE FROM agent_file_reads WHERE session_uuid = ?",
+    args: [sessionUuid]
+  });
+}
+var RECENT_READ_LOOKBACK_MS, MAX_STALE_FILES, GIT_TIMEOUT_MS;
+var init_git_staleness = __esm({
+  "src/lib/git-staleness.ts"() {
+    "use strict";
+    init_database();
+    RECENT_READ_LOOKBACK_MS = 24 * 60 * 60 * 1e3;
+    MAX_STALE_FILES = 10;
+    GIT_TIMEOUT_MS = 400;
+  }
+});
+
 // src/adapters/claude/hooks/session-start.ts
 init_config();
-import path18 from "path";
+import path19 from "path";
 import { unlinkSync as unlinkSync4, existsSync as existsSync15, readFileSync as readFileSync12 } from "fs";
 if (!process.env.AGENT_ID) {
   process.env.AGENT_ID = "default";
@@ -6500,15 +6752,16 @@ process.stdin.on("end", async () => {
     const { lightweightSearch: lightweightSearch2 } = await Promise.resolve().then(() => (init_hybrid_search(), hybrid_search_exports));
     const { getActiveAgent: getActiveAgent2 } = await Promise.resolve().then(() => (init_active_agent2(), active_agent_exports));
     const { getProjectName: getProjectName2 } = await Promise.resolve().then(() => (init_project_name(), project_name_exports));
-    const { sessionScopeFilter: sessionScopeFilter2 } = await Promise.resolve().then(() => (init_task_scope(), task_scope_exports));
+    const { sessionScopeFilter: sessionScopeFilter2, getCurrentSessionScope: getCurrentSessionScope2 } = await Promise.resolve().then(() => (init_task_scope(), task_scope_exports));
     const { canCoordinate: canCoordinate2 } = await Promise.resolve().then(() => (init_employees(), employees_exports));
     const data = JSON.parse(input);
     const projectName = getProjectName2(data.cwd || void 0);
     const source = data.source ?? "startup";
+    const sessionScope = getCurrentSessionScope2();
     if (source === "startup") {
       try {
-        const undefinedPath = path18.join(
-          process.env.EXE_OS_DIR ?? path18.join(process.env.HOME ?? "", ".exe-os"),
+        const undefinedPath = path19.join(
+          process.env.EXE_OS_DIR ?? path19.join(process.env.HOME ?? "", ".exe-os"),
           "session-cache",
           "active-agent-undefined.json"
         );
@@ -6521,18 +6774,19 @@ process.stdin.on("end", async () => {
     const agentId = agent.agentId;
     if (agentId !== "default") {
       try {
-        const cacheDir = path18.join(
-          process.env.EXE_OS_DIR ?? path18.join(process.env.HOME ?? "", ".exe-os"),
+        const cacheDir = path19.join(
+          process.env.EXE_OS_DIR ?? path19.join(process.env.HOME ?? "", ".exe-os"),
           "session-cache"
         );
-        const markerPath = path18.join(cacheDir, `current-task-${agentId}.json`);
+        const markerPath = path19.join(cacheDir, `current-task-${agentId}.json`);
         if (existsSync15(markerPath)) {
           const marker = JSON.parse(readFileSync12(markerPath, "utf-8"));
           if (marker.taskId) {
             const client = getClient2();
+            const markerScope = sessionScopeFilter2(sessionScope);
             const result = await client.execute({
-              sql: "SELECT status FROM tasks WHERE id = ? LIMIT 1",
-              args: [marker.taskId]
+              sql: `SELECT status FROM tasks WHERE id = ?${markerScope.sql} LIMIT 1`,
+              args: [marker.taskId, ...markerScope.args]
             });
             const status = result.rows[0]?.status;
             if (!status || status !== "in_progress") {
@@ -6549,8 +6803,14 @@ process.stdin.on("end", async () => {
         const client = getClient2();
         const sessionName = process.env.EXE_SESSION_NAME ?? "";
         await client.execute({
-          sql: `INSERT OR REPLACE INTO session_agent_map (session_uuid, agent_id, session_name, project_name, started_at)
-                VALUES (?, ?, ?, ?, ?)`,
+          sql: `INSERT INTO session_agent_map (session_uuid, agent_id, session_name, project_name, started_at, cache_cold_count)
+                VALUES (?, ?, ?, ?, ?, 0)
+                ON CONFLICT(session_uuid) DO UPDATE SET
+                  agent_id = excluded.agent_id,
+                  session_name = excluded.session_name,
+                  project_name = excluded.project_name,
+                  started_at = excluded.started_at,
+                  cache_cold_count = COALESCE(session_agent_map.cache_cold_count, 0)`,
           args: [sessionId, agentId, sessionName, projectName, (/* @__PURE__ */ new Date()).toISOString()]
         });
       }
@@ -6558,9 +6818,32 @@ process.stdin.on("end", async () => {
     }
     let query;
     let header;
+    let extraContext = "";
     if (source === "resume") {
       query = `last actions on ${projectName}`;
       header = "## Resuming Session\nHere's where you left off:";
+      try {
+        const { buildCatchupBrief: buildCatchupBrief2 } = await Promise.resolve().then(() => (init_catchup_brief(), catchup_brief_exports));
+        const brief = await buildCatchupBrief2(
+          agentId,
+          projectName,
+          data.cwd || process.cwd(),
+          sessionScope
+        );
+        header = brief.header;
+        extraContext = brief.sections.join("\n\n");
+      } catch {
+      }
+      try {
+        const { detectStaleFiles: detectStaleFiles2 } = await Promise.resolve().then(() => (init_git_staleness(), git_staleness_exports));
+        const staleFiles = await detectStaleFiles2(agentId, data.cwd || process.cwd());
+        if (staleFiles.length > 0) {
+          extraContext += `${extraContext.length > 0 ? "\n\n" : ""}## \u26A0\uFE0F Stale File Warning
+The following files have been modified since you last read them:
+` + staleFiles.slice(0, 10).map((line) => `- ${line}`).join("\n") + "\n\nRe-read these files before making changes to avoid conflicts.";
+        }
+      } catch {
+      }
     } else {
       query = `recent work on ${projectName}`;
       header = "## Memory Brief\nRecent memories from this project:";
@@ -6573,7 +6856,7 @@ process.stdin.on("end", async () => {
     let taskBrief = "";
     try {
       const client = getClient2();
-      const ssScope = sessionScopeFilter2();
+      const ssScope = sessionScopeFilter2(sessionScope);
       const taskResult = await client.execute({
         sql: `SELECT id, title, priority, project_name, status FROM tasks WHERE assigned_to = ? AND status IN ('open', 'in_progress')${ssScope.sql} ORDER BY priority ASC`,
         args: [agentId, ...ssScope.args]
@@ -6612,6 +6895,12 @@ flow, so bug fixes are fast.`;
       additionalContext += `${header}
 ${brief}`;
     }
+    if (extraContext.length > 0) {
+      if (additionalContext.length === 0) {
+        additionalContext += header;
+      }
+      additionalContext += `${additionalContext.length > 0 ? "\n\n" : ""}${extraContext}`;
+    }
     additionalContext += taskBrief;
     if (additionalContext.length > 0) {
       const output = JSON.stringify({

package/dist/hooks/stop.js

@@ -2591,12 +2591,26 @@ async function ensureSchema() {
       session_name TEXT,
       task_id TEXT,
       project_name TEXT,
-      started_at TEXT NOT NULL
+      started_at TEXT NOT NULL,
+      cache_cold_count INTEGER NOT NULL DEFAULT 0
     );
 
     CREATE INDEX IF NOT EXISTS idx_session_agent_map_agent
       ON session_agent_map(agent_id);
   `);
+  await client.executeMultiple(`
+    CREATE TABLE IF NOT EXISTS agent_file_reads (
+      session_uuid TEXT NOT NULL,
+      agent_id TEXT NOT NULL,
+      file_path TEXT NOT NULL,
+      read_at TEXT NOT NULL,
+      commit_hash TEXT,
+      PRIMARY KEY (session_uuid, file_path)
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_agent_file_reads_agent_read_at
+      ON agent_file_reads(agent_id, read_at);
+  `);
   try {
     const mapCount = await client.execute({ sql: `SELECT COUNT(*) as cnt FROM session_agent_map`, args: [] });
     if (Number(mapCount.rows[0]?.cnt ?? 0) === 0) {
@@ -2611,6 +2625,13 @@ async function ensureSchema() {
     }
   } catch {
   }
+  try {
+    await client.execute({
+      sql: `ALTER TABLE session_agent_map ADD COLUMN cache_cold_count INTEGER NOT NULL DEFAULT 0`,
+      args: []
+    });
+  } catch {
+  }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN budget_tokens INTEGER`,

package/dist/hooks/subagent-stop.js

@@ -2566,12 +2566,26 @@ async function ensureSchema() {
       session_name TEXT,
       task_id TEXT,
       project_name TEXT,
-      started_at TEXT NOT NULL
+      started_at TEXT NOT NULL,
+      cache_cold_count INTEGER NOT NULL DEFAULT 0
     );
 
     CREATE INDEX IF NOT EXISTS idx_session_agent_map_agent
       ON session_agent_map(agent_id);
   `);
+  await client.executeMultiple(`
+    CREATE TABLE IF NOT EXISTS agent_file_reads (
+      session_uuid TEXT NOT NULL,
+      agent_id TEXT NOT NULL,
+      file_path TEXT NOT NULL,
+      read_at TEXT NOT NULL,
+      commit_hash TEXT,
+      PRIMARY KEY (session_uuid, file_path)
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_agent_file_reads_agent_read_at
+      ON agent_file_reads(agent_id, read_at);
+  `);
   try {
     const mapCount = await client.execute({ sql: `SELECT COUNT(*) as cnt FROM session_agent_map`, args: [] });
     if (Number(mapCount.rows[0]?.cnt ?? 0) === 0) {
@@ -2586,6 +2600,13 @@ async function ensureSchema() {
     }
   } catch {
   }
+  try {
+    await client.execute({
+      sql: `ALTER TABLE session_agent_map ADD COLUMN cache_cold_count INTEGER NOT NULL DEFAULT 0`,
+      args: []
+    });
+  } catch {
+  }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN budget_tokens INTEGER`,

package/dist/hooks/summary-worker.js

@@ -2563,12 +2563,26 @@ async function ensureSchema() {
       session_name TEXT,
       task_id TEXT,
       project_name TEXT,
-      started_at TEXT NOT NULL
+      started_at TEXT NOT NULL,
+      cache_cold_count INTEGER NOT NULL DEFAULT 0
     );
 
     CREATE INDEX IF NOT EXISTS idx_session_agent_map_agent
       ON session_agent_map(agent_id);
   `);
+  await client.executeMultiple(`
+    CREATE TABLE IF NOT EXISTS agent_file_reads (
+      session_uuid TEXT NOT NULL,
+      agent_id TEXT NOT NULL,
+      file_path TEXT NOT NULL,
+      read_at TEXT NOT NULL,
+      commit_hash TEXT,
+      PRIMARY KEY (session_uuid, file_path)
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_agent_file_reads_agent_read_at
+      ON agent_file_reads(agent_id, read_at);
+  `);
   try {
     const mapCount = await client.execute({ sql: `SELECT COUNT(*) as cnt FROM session_agent_map`, args: [] });
     if (Number(mapCount.rows[0]?.cnt ?? 0) === 0) {
@@ -2583,6 +2597,13 @@ async function ensureSchema() {
     }
   } catch {
   }
+  try {
+    await client.execute({
+      sql: `ALTER TABLE session_agent_map ADD COLUMN cache_cold_count INTEGER NOT NULL DEFAULT 0`,
+      args: []
+    });
+  } catch {
+  }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN budget_tokens INTEGER`,

package/dist/index.js

@@ -3268,12 +3268,26 @@ async function ensureSchema() {
       session_name TEXT,
       task_id TEXT,
       project_name TEXT,
-      started_at TEXT NOT NULL
+      started_at TEXT NOT NULL,
+      cache_cold_count INTEGER NOT NULL DEFAULT 0
     );
 
     CREATE INDEX IF NOT EXISTS idx_session_agent_map_agent
       ON session_agent_map(agent_id);
   `);
+  await client.executeMultiple(`
+    CREATE TABLE IF NOT EXISTS agent_file_reads (
+      session_uuid TEXT NOT NULL,
+      agent_id TEXT NOT NULL,
+      file_path TEXT NOT NULL,
+      read_at TEXT NOT NULL,
+      commit_hash TEXT,
+      PRIMARY KEY (session_uuid, file_path)
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_agent_file_reads_agent_read_at
+      ON agent_file_reads(agent_id, read_at);
+  `);
   try {
     const mapCount = await client.execute({ sql: `SELECT COUNT(*) as cnt FROM session_agent_map`, args: [] });
     if (Number(mapCount.rows[0]?.cnt ?? 0) === 0) {
@@ -3288,6 +3302,13 @@ async function ensureSchema() {
     }
   } catch {
   }
+  try {
+    await client.execute({
+      sql: `ALTER TABLE session_agent_map ADD COLUMN cache_cold_count INTEGER NOT NULL DEFAULT 0`,
+      args: []
+    });
+  } catch {
+  }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN budget_tokens INTEGER`,

package/dist/lib/cloud-sync.js

@@ -2220,12 +2220,26 @@ async function ensureSchema() {
       session_name TEXT,
       task_id TEXT,
       project_name TEXT,
-      started_at TEXT NOT NULL
+      started_at TEXT NOT NULL,
+      cache_cold_count INTEGER NOT NULL DEFAULT 0
     );
 
     CREATE INDEX IF NOT EXISTS idx_session_agent_map_agent
       ON session_agent_map(agent_id);
   `);
+  await client.executeMultiple(`
+    CREATE TABLE IF NOT EXISTS agent_file_reads (
+      session_uuid TEXT NOT NULL,
+      agent_id TEXT NOT NULL,
+      file_path TEXT NOT NULL,
+      read_at TEXT NOT NULL,
+      commit_hash TEXT,
+      PRIMARY KEY (session_uuid, file_path)
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_agent_file_reads_agent_read_at
+      ON agent_file_reads(agent_id, read_at);
+  `);
   try {
     const mapCount = await client.execute({ sql: `SELECT COUNT(*) as cnt FROM session_agent_map`, args: [] });
     if (Number(mapCount.rows[0]?.cnt ?? 0) === 0) {
@@ -2240,6 +2254,13 @@ async function ensureSchema() {
     }
   } catch {
   }
+  try {
+    await client.execute({
+      sql: `ALTER TABLE session_agent_map ADD COLUMN cache_cold_count INTEGER NOT NULL DEFAULT 0`,
+      args: []
+    });
+  } catch {
+  }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN budget_tokens INTEGER`,

package/dist/lib/database.js

@@ -2143,12 +2143,26 @@ async function ensureSchema() {
       session_name TEXT,
       task_id TEXT,
       project_name TEXT,
-      started_at TEXT NOT NULL
+      started_at TEXT NOT NULL,
+      cache_cold_count INTEGER NOT NULL DEFAULT 0
     );
 
     CREATE INDEX IF NOT EXISTS idx_session_agent_map_agent
       ON session_agent_map(agent_id);
   `);
+  await client.executeMultiple(`
+    CREATE TABLE IF NOT EXISTS agent_file_reads (
+      session_uuid TEXT NOT NULL,
+      agent_id TEXT NOT NULL,
+      file_path TEXT NOT NULL,
+      read_at TEXT NOT NULL,
+      commit_hash TEXT,
+      PRIMARY KEY (session_uuid, file_path)
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_agent_file_reads_agent_read_at
+      ON agent_file_reads(agent_id, read_at);
+  `);
   try {
     const mapCount = await client.execute({ sql: `SELECT COUNT(*) as cnt FROM session_agent_map`, args: [] });
     if (Number(mapCount.rows[0]?.cnt ?? 0) === 0) {
@@ -2163,6 +2177,13 @@ async function ensureSchema() {
     }
   } catch {
   }
+  try {
+    await client.execute({
+      sql: `ALTER TABLE session_agent_map ADD COLUMN cache_cold_count INTEGER NOT NULL DEFAULT 0`,
+      args: []
+    });
+  } catch {
+  }
   try {
     await client.execute({
       sql: `ALTER TABLE tasks ADD COLUMN budget_tokens INTEGER`,