@workscribe/cli 2.0.1 → 2.1.0

package/dist/index.js

@@ -1402,6 +1402,42 @@ var init_session_lookup = __esm({
   }
 });
 
+// src/db/transaction.ts
+function isDatabaseLocked(error) {
+  return error?.errcode === SQLITE_BUSY;
+}
+function rollbackQuietly(db) {
+  try {
+    db.exec("ROLLBACK");
+  } catch {
+  }
+}
+function withImmediateTransaction(db, work, options = {}) {
+  const { busyTimeoutMs } = options;
+  if (busyTimeoutMs !== void 0) db.exec(`PRAGMA busy_timeout = ${Math.max(0, Math.floor(busyTimeoutMs))}`);
+  try {
+    db.exec("BEGIN IMMEDIATE");
+    try {
+      const result = work();
+      db.exec("COMMIT");
+      return result;
+    } catch (error) {
+      rollbackQuietly(db);
+      throw error;
+    }
+  } finally {
+    if (busyTimeoutMs !== void 0) db.exec(`PRAGMA busy_timeout = ${BUSY_TIMEOUT_MS}`);
+  }
+}
+var BUSY_TIMEOUT_MS, SQLITE_BUSY;
+var init_transaction = __esm({
+  "src/db/transaction.ts"() {
+    "use strict";
+    BUSY_TIMEOUT_MS = 5e3;
+    SQLITE_BUSY = 5;
+  }
+});
+
 // src/db/index.ts
 function getDb() {
   if (_db) return _db;
@@ -1419,7 +1455,7 @@ function getDb() {
   }
   db.exec("PRAGMA journal_mode = WAL");
   db.exec("PRAGMA foreign_keys = ON");
-  db.exec("PRAGMA busy_timeout = 5000");
+  db.exec(`PRAGMA busy_timeout = ${BUSY_TIMEOUT_MS}`);
   applyMigrations(db, MIGRATIONS);
   _db = db;
   return _db;
@@ -1475,10 +1511,30 @@ function getEventsForDate(date) {
   const stmt = db.prepare(`
     SELECT * FROM events
     WHERE date(captured_at, 'localtime') = $date
-    ORDER BY captured_at ASC
+    ORDER BY captured_at ASC, id ASC
   `);
   return stmt.all({ date });
 }
+function countEventsBetween(start, end) {
+  const row = getDb().prepare("SELECT COUNT(*) AS count FROM events WHERE captured_at >= $start AND captured_at < $end").get({ start, end });
+  return row.count;
+}
+function sumSessionEventCounts(date) {
+  const row = getDb().prepare("SELECT COALESCE(SUM(event_count), 0) AS total FROM sessions WHERE date = $date").get({ date });
+  return row.total;
+}
+function getLatestFileSaveAt(filePath) {
+  const row = getDb().prepare(
+    `SELECT captured_at FROM events
+       WHERE file_path = $file_path AND category = 'code_edit'
+       ORDER BY captured_at DESC
+       LIMIT 1`
+  ).get({ file_path: filePath });
+  return row?.captured_at ?? null;
+}
+function runInImmediateTransaction(work, options) {
+  return withImmediateTransaction(getDb(), work, options);
+}
 function getEventCount() {
   const db = getDb();
   const stmt = db.prepare("SELECT COUNT(*) as count FROM events");
@@ -1507,7 +1563,7 @@ function getEventsBySessionId(sessionId) {
     SELECT e.* FROM events e
     INNER JOIN session_events se ON se.event_id = e.id
     WHERE se.session_id = $session_id
-    ORDER BY e.captured_at ASC
+    ORDER BY e.captured_at ASC, e.id ASC
   `);
   return stmt.all({ session_id: sessionId });
 }
@@ -1600,6 +1656,7 @@ var init_db = __esm({
     init_migrations();
     init_migrate();
     init_session_lookup();
+    init_transaction();
     _db = null;
   }
 });
@@ -3006,10 +3063,10 @@ function installIntoFolder(options) {
     const outcome = installSkill({
       sourceDir: options.sourceDir,
       skillsFolder: target.skillsFolder,
-      version: "2.0.1",
+      version: "2.1.0",
       force: options.force
     });
-    return describeInstallOutcome({ ...target, outcome, version: "2.0.1" });
+    return describeInstallOutcome({ ...target, outcome, version: "2.1.0" });
   } catch (error) {
     return describeInstallFailure({ ...target, error });
   }
@@ -3028,8 +3085,8 @@ function removeSkills(agents, options) {
 }
 function formatAgentSkillLine(agent, homeDir = import_os6.default.homedir()) {
   const location = displayPath(import_path14.default.join(homeDir, agent.skillsFolder, SKILL_NAME), homeDir);
-  const installState = readInstallState(import_path14.default.join(homeDir, agent.skillsFolder), "2.0.1");
-  const status = describeSkillStatus(installState, "2.0.1");
+  const installState = readInstallState(import_path14.default.join(homeDir, agent.skillsFolder), "2.1.0");
+  const status = describeSkillStatus(installState, "2.1.0");
   return `${agent.name.padEnd(AGENT_NAME_COLUMN_WIDTH)} ${STATUS_COLOURS[status.level](status.text)}  ${import_chalk2.default.dim(location)}`;
 }
 function formatUndetectedAgentLine(agent) {
@@ -3315,10 +3372,10 @@ async function runAIToolsStep() {
 }
 async function offerSkillInstall(group, sourceDir) {
   const target = describeTarget(group);
-  const state = readInstallState(target.skillsFolder, "2.0.1");
+  const state = readInstallState(target.skillsFolder, "2.1.0");
   const knownOutcome = outcomeWithoutPrompt(state);
   if (knownOutcome) {
-    printMessage(describeInstallOutcome({ ...target, outcome: knownOutcome, version: "2.0.1" }));
+    printMessage(describeInstallOutcome({ ...target, outcome: knownOutcome, version: "2.1.0" }));
     return;
   }
   const { installSkill: shouldInstall } = await (0, import_prompts2.default)({
@@ -3478,6 +3535,12 @@ function localDateStr(d) {
 function localDateOf(isoString) {
   return localDateStr(new Date(isoString));
 }
+function localDayBounds(date) {
+  const start = /* @__PURE__ */ new Date(`${date}T00:00:00`);
+  const end = new Date(start);
+  end.setDate(end.getDate() + 1);
+  return { start: start.toISOString(), end: end.toISOString() };
+}
 function startOfWeek(dateStr) {
   const d = /* @__PURE__ */ new Date(dateStr + "T00:00:00");
   const day = d.getDay();
@@ -3998,35 +4061,48 @@ var init_grouper = __esm({
 });
 
 // src/sessions/detector.ts
-function getOrBuildSessions(date) {
-  const existing = getSessionsForDate(date);
-  const events = getEventsForDate(date);
-  if (events.length === 0) return [];
-  const cachedEventCount = existing.reduce((sum, sessionRow) => sum + sessionRow.event_count, 0);
-  if (existing.length > 0 && cachedEventCount === events.length) {
-    return existing.map((sessionRow) => ({
-      id: sessionRow.id,
-      date: sessionRow.date,
-      startedAt: sessionRow.started_at,
-      endedAt: sessionRow.ended_at,
-      repoName: sessionRow.repo_name,
-      durationMinutes: minutesBetween(sessionRow.started_at, sessionRow.ended_at),
-      eventCount: sessionRow.event_count,
-      summary: sessionRow.summary,
-      events: getEventsBySessionId(sessionRow.id)
-    }));
-  }
+function isDayGrouped(date) {
+  const { start, end } = localDayBounds(date);
+  return countEventsBetween(start, end) === sumSessionEventCounts(date);
+}
+function regroupDay(date) {
   const savedSummaries = /* @__PURE__ */ new Map();
-  for (const s of existing) {
-    if (s.summary) savedSummaries.set(`${s.repo_name}|${s.started_at}`, s.summary);
+  for (const sessionRow of getSessionsForDate(date)) {
+    if (sessionRow.summary) savedSummaries.set(`${sessionRow.repo_name}|${sessionRow.started_at}`, sessionRow.summary);
   }
   clearSessionsForDate(date);
-  return buildSessions(date, events, savedSummaries);
+  buildSessions(date, getEventsForDate(date), savedSummaries);
+}
+function ensureDayGrouped(date, options = {}) {
+  if (isDayGrouped(date)) return;
+  runInImmediateTransaction(
+    () => {
+      if (isDayGrouped(date)) return;
+      regroupDay(date);
+    },
+    { busyTimeoutMs: options.lockWaitMs }
+  );
 }
-function buildSessions(date, events, savedSummaries = /* @__PURE__ */ new Map()) {
+function toSession(sessionRow) {
+  return {
+    id: sessionRow.id,
+    date: sessionRow.date,
+    startedAt: sessionRow.started_at,
+    endedAt: sessionRow.ended_at,
+    repoName: sessionRow.repo_name,
+    durationMinutes: minutesBetween(sessionRow.started_at, sessionRow.ended_at),
+    eventCount: sessionRow.event_count,
+    summary: sessionRow.summary,
+    events: getEventsBySessionId(sessionRow.id)
+  };
+}
+function getOrBuildSessions(date) {
+  ensureDayGrouped(date);
+  return getSessionsForDate(date).map(toSession);
+}
+function buildSessions(date, events, savedSummaries) {
   const config = readConfig();
   const idleMs = config.session.idleTimeout * 60 * 1e3;
-  const sessions = [];
   const timeGroups = splitByIdleGap(events, idleMs);
   for (const group of timeGroups) {
     if (group.length === 0) continue;
@@ -4048,26 +4124,15 @@ function buildSessions(date, events, savedSummaries = /* @__PURE__ */ new Map())
       for (const event of repoGroup) {
         insertSessionEvent(sessionId, event.id);
       }
-      sessions.push({
-        id: sessionId,
-        date,
-        startedAt: first.captured_at,
-        endedAt: last.captured_at,
-        repoName,
-        durationMinutes: minutesBetween(first.captured_at, last.captured_at),
-        eventCount: repoGroup.length,
-        summary,
-        events: repoGroup
-      });
     }
   }
-  return sessions;
 }
 var init_detector = __esm({
   "src/sessions/detector.ts"() {
     "use strict";
     init_db();
     init_config();
+    init_format();
     init_grouper();
   }
 });
@@ -4182,18 +4247,18 @@ var init_session_summary = __esm({
 });
 
 // src/summary/git-commits.ts
-function runGit(cwd, args) {
+function runGit(cwd, args, timeoutMs = GIT_TIMEOUT_MS) {
   try {
-    return (0, import_child_process6.execFileSync)("git", args, { cwd, timeout: GIT_TIMEOUT_MS, stdio: ["ignore", "pipe", "ignore"] }).toString().trim();
+    return (0, import_child_process6.execFileSync)("git", args, { cwd, timeout: timeoutMs, stdio: ["ignore", "pipe", "ignore"] }).toString().trim();
   } catch {
     return null;
   }
 }
-function getRepoRoot(cwd) {
-  return runGit(cwd, ["rev-parse", "--show-toplevel"]) || null;
+function getRepoRoot(cwd, timeoutMs) {
+  return runGit(cwd, ["rev-parse", "--show-toplevel"], timeoutMs) || null;
 }
-function getUserEmail(repoRoot) {
-  return runGit(repoRoot, ["config", "user.email"]) || null;
+function getUserEmail(repoRoot, timeoutMs) {
+  return runGit(repoRoot, ["config", "user.email"], timeoutMs) || null;
 }
 function getOthersSubjects(repoRoot, author) {
   if (!author) return [];
@@ -4211,15 +4276,20 @@ function getOthersSubjects(repoRoot, author) {
   }
   return [...theirs].filter((subject) => !mine.has(subject));
 }
-function getCommitsInWindow({ repoRoot, since, until, author }) {
+function getCommitsInWindow({ repoRoot, since, until, author, filePath, timeoutMs }) {
   const shiftedBy = (iso, milliseconds) => new Date(new Date(iso).getTime() + milliseconds).toISOString();
-  const output = runGit(repoRoot, [
-    "log",
-    `--since=${shiftedBy(since, -WINDOW_LEAD_MS)}`,
-    `--until=${shiftedBy(until, WINDOW_TRAIL_MS)}`,
-    "--format=%h%x09%ce%x09%s",
-    "--reverse"
-  ]);
+  const output = runGit(
+    repoRoot,
+    [
+      "log",
+      `--since=${shiftedBy(since, -WINDOW_LEAD_MS)}`,
+      `--until=${shiftedBy(until, WINDOW_TRAIL_MS)}`,
+      "--format=%h%x09%ce%x09%s",
+      "--reverse",
+      ...filePath ? ["--", filePath] : []
+    ],
+    timeoutMs
+  );
   if (!output) return [];
   const wantedAuthor = author?.toLowerCase() ?? null;
   return output.split("\n").flatMap((line) => {
@@ -4230,11 +4300,38 @@ function getCommitsInWindow({ repoRoot, since, until, author }) {
     return [{ hash, subject }];
   });
 }
-var import_child_process6, GIT_TIMEOUT_MS, WINDOW_LEAD_MS, WINDOW_TRAIL_MS, AUTHORSHIP_HISTORY_DEPTH;
+function getFileCommits(options) {
+  const now = options.now ?? Date.now;
+  const deadline = now() + options.budgetMs;
+  const timeLeft = () => {
+    const milliseconds = deadline - now();
+    return milliseconds >= 1 ? milliseconds : null;
+  };
+  const rootTimeout = timeLeft();
+  if (rootTimeout === null) return { repoRoot: null, commits: [] };
+  const repoRoot = getRepoRoot(import_path17.default.dirname(options.filePath), rootTimeout);
+  if (!repoRoot) return { repoRoot: null, commits: [] };
+  const emailTimeout = timeLeft();
+  if (emailTimeout === null) return { repoRoot, commits: [] };
+  const author = getUserEmail(repoRoot, emailTimeout);
+  const logTimeout = timeLeft();
+  if (logTimeout === null) return { repoRoot, commits: [] };
+  const commits = getCommitsInWindow({
+    repoRoot,
+    since: options.since,
+    until: options.until,
+    author,
+    filePath: options.filePath,
+    timeoutMs: logTimeout
+  });
+  return { repoRoot, commits };
+}
+var import_child_process6, import_path17, GIT_TIMEOUT_MS, WINDOW_LEAD_MS, WINDOW_TRAIL_MS, AUTHORSHIP_HISTORY_DEPTH;
 var init_git_commits = __esm({
   "src/summary/git-commits.ts"() {
     "use strict";
     import_child_process6 = require("child_process");
+    import_path17 = __toESM(require("path"));
     GIT_TIMEOUT_MS = 3e3;
     WINDOW_LEAD_MS = 12e4;
     WINDOW_TRAIL_MS = 6e4;
@@ -4853,7 +4950,7 @@ function registerExport(program) {
     }
     const payload = buildDayPayload(date, sessions, locationContextFrom(config));
     const summary = await createSummaryWriter(config).summarize(payload);
-    const outputPath = options.output ?? import_path17.default.join(EXPORTS_DIR, `workscribe-${date}.md`);
+    const outputPath = options.output ?? import_path18.default.join(EXPORTS_DIR, `workscribe-${date}.md`);
     if (!import_fs21.default.existsSync(EXPORTS_DIR)) import_fs21.default.mkdirSync(EXPORTS_DIR, { recursive: true, mode: 448 });
     import_fs21.default.writeFileSync(outputPath, `# Work Summary \u2014 ${date}
 
@@ -4862,12 +4959,12 @@ ${summary}
     log.success(`Saved: ${outputPath}`);
   });
 }
-var import_fs21, import_path17;
+var import_fs21, import_path18;
 var init_export = __esm({
   "src/cli/export.ts"() {
     "use strict";
     import_fs21 = __toESM(require("fs"));
-    import_path17 = __toESM(require("path"));
+    import_path18 = __toESM(require("path"));
     init_detector();
     init_config();
     init_logger();
@@ -5081,7 +5178,7 @@ var init_clear = __esm({
 
 // src/cli/uninstall.ts
 function completionRcFiles() {
-  return [".zshrc", ".bashrc", ".bash_profile"].map((file) => import_path18.default.join(import_os11.default.homedir(), file));
+  return [".zshrc", ".bashrc", ".bash_profile"].map((file) => import_path19.default.join(import_os11.default.homedir(), file));
 }
 function removeCompletionsAndToolHooks() {
   for (const rcFile of completionRcFiles()) {
@@ -5098,10 +5195,10 @@ function removeCompletionsAndToolHooks() {
 }
 function detectShellRcFiles() {
   const candidates = [
-    { name: "zsh", rcFile: import_path18.default.join(import_os11.default.homedir(), ".zshrc") },
-    { name: "bash", rcFile: import_path18.default.join(import_os11.default.homedir(), ".bashrc") },
-    { name: "bash", rcFile: import_path18.default.join(import_os11.default.homedir(), ".bash_profile") },
-    { name: "fish", rcFile: import_path18.default.join(import_os11.default.homedir(), ".config", "fish", "conf.d", "workscribe.fish") }
+    { name: "zsh", rcFile: import_path19.default.join(import_os11.default.homedir(), ".zshrc") },
+    { name: "bash", rcFile: import_path19.default.join(import_os11.default.homedir(), ".bashrc") },
+    { name: "bash", rcFile: import_path19.default.join(import_os11.default.homedir(), ".bash_profile") },
+    { name: "fish", rcFile: import_path19.default.join(import_os11.default.homedir(), ".config", "fish", "conf.d", "workscribe.fish") }
   ];
   return candidates.filter((candidate) => import_fs23.default.existsSync(candidate.rcFile) && isHookInstalled(candidate.rcFile));
 }
@@ -5158,12 +5255,12 @@ function registerUninstall(program) {
     log.plain("");
   });
 }
-var import_fs23, import_path18, import_os11, import_prompts4, import_chalk10;
+var import_fs23, import_path19, import_os11, import_prompts4, import_chalk10;
 var init_uninstall = __esm({
   "src/cli/uninstall.ts"() {
     "use strict";
     import_fs23 = __toESM(require("fs"));
-    import_path18 = __toESM(require("path"));
+    import_path19 = __toESM(require("path"));
     import_os11 = __toESM(require("os"));
     import_prompts4 = __toESM(require("prompts"));
     import_chalk10 = __toESM(require("chalk"));
@@ -5220,7 +5317,7 @@ function registerProfile(program) {
       log.plain(import_chalk11.default.dim("  " + "\u2500".repeat(60)));
       for (const entry of entries) {
         const badge = activeNames.has(entry.name) ? import_chalk11.default.green(" [active]") : "";
-        const installed = import_fs24.default.existsSync(import_path19.default.join(PROFILES_DIR, `${entry.name}.json`)) ? import_chalk11.default.dim(" installed") : "";
+        const installed = import_fs24.default.existsSync(import_path20.default.join(PROFILES_DIR, `${entry.name}.json`)) ? import_chalk11.default.dim(" installed") : "";
         log.plain(`  ${import_chalk11.default.cyan(entry.name.padEnd(18))} ${entry.displayName.padEnd(28)}${badge}${installed}`);
         if (entry.description) log.plain(`  ${import_chalk11.default.dim(" ".repeat(18) + entry.description)}`);
       }
@@ -5256,7 +5353,7 @@ function registerProfile(program) {
         continue;
       }
       activeNames.delete(name);
-      const cachePath = import_path19.default.join(PROFILES_DIR, `${name}.json`);
+      const cachePath = import_path20.default.join(PROFILES_DIR, `${name}.json`);
       if (import_fs24.default.existsSync(cachePath)) import_fs24.default.unlinkSync(cachePath);
       log.success(`Profile "${name}" removed`);
     }
@@ -5384,12 +5481,12 @@ function registerProfile(program) {
     }
   });
 }
-var import_fs24, import_path19, import_chalk11, MIN_SUGGEST_COUNT;
+var import_fs24, import_path20, import_chalk11, MIN_SUGGEST_COUNT;
 var init_profile = __esm({
   "src/cli/profile.ts"() {
     "use strict";
     import_fs24 = __toESM(require("fs"));
-    import_path19 = __toESM(require("path"));
+    import_path20 = __toESM(require("path"));
     import_chalk11 = __toESM(require("chalk"));
     init_config();
     init_paths();
@@ -5409,6 +5506,9 @@ function realPath(target) {
     return null;
   }
 }
+function resolvedPath(target) {
+  return realPath(target) ?? target;
+}
 function currentDirectory(where = { pwd: process.env.PWD, cwd: process.cwd() }) {
   if (where.pwd && realPath(where.pwd) === realPath(where.cwd)) return where.pwd;
   return where.cwd;
@@ -5416,15 +5516,15 @@ function currentDirectory(where = { pwd: process.env.PWD, cwd: process.cwd() })
 function rootForms(cwd, root) {
   const resolvedCwd = realPath(cwd);
   if (!resolvedCwd) return [root];
-  const reached = import_path20.default.resolve(cwd, import_path20.default.relative(resolvedCwd, root));
+  const reached = import_path21.default.resolve(cwd, import_path21.default.relative(resolvedCwd, root));
   return [.../* @__PURE__ */ new Set([root, reached])];
 }
-var import_fs25, import_path20;
+var import_fs25, import_path21;
 var init_working_directory = __esm({
   "src/utils/working-directory.ts"() {
     "use strict";
     import_fs25 = __toESM(require("fs"));
-    import_path20 = __toESM(require("path"));
+    import_path21 = __toESM(require("path"));
   }
 });
 
@@ -5505,9 +5605,9 @@ function redactConfig() {
 function registerBugReport(program) {
   program.command("bug-report").description("Generate a diagnostic report for filing a bug").action(() => {
     const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-    const reportPath = import_path21.default.join(WORKSCRIBE_DIR, `bug-report-${timestamp}.txt`);
+    const reportPath = import_path22.default.join(WORKSCRIBE_DIR, `bug-report-${timestamp}.txt`);
     const systemInfo = [
-      `Workscribe version : ${"2.0.1"}`,
+      `Workscribe version : ${"2.1.0"}`,
       `Node.js version    : ${process.version}`,
       `Platform           : ${process.platform}`,
       `Architecture       : ${process.arch}`,
@@ -5538,8 +5638,8 @@ function registerBugReport(program) {
       process.exit(1);
     }
     const params = new URLSearchParams({
-      title: `Bug report \u2014 workscribe ${"2.0.1"}`,
-      body: `<!-- Attach ${import_path21.default.basename(reportPath)} or paste the relevant sections below -->
+      title: `Bug report \u2014 workscribe ${"2.1.0"}`,
+      body: `<!-- Attach ${import_path22.default.basename(reportPath)} or paste the relevant sections below -->
 
 **Describe the issue:**
 
@@ -5556,13 +5656,13 @@ function registerBugReport(program) {
     log.plain("");
   });
 }
-var import_fs26, import_os12, import_path21, import_chalk12, GITHUB_ISSUES_URL, DEBUG_LOG_TAIL_LINES;
+var import_fs26, import_os12, import_path22, import_chalk12, GITHUB_ISSUES_URL, DEBUG_LOG_TAIL_LINES;
 var init_bug_report = __esm({
   "src/cli/bug-report.ts"() {
     "use strict";
     import_fs26 = __toESM(require("fs"));
     import_os12 = __toESM(require("os"));
-    import_path21 = __toESM(require("path"));
+    import_path22 = __toESM(require("path"));
     import_chalk12 = __toESM(require("chalk"));
     init_paths();
     init_config();
@@ -5629,11 +5729,108 @@ var init_alerts3 = __esm({
   }
 });
 
+// src/summary/file-details.ts
+function displayPath2(absoluteFilePath, repoRoot) {
+  if (repoRoot) {
+    const relative = import_path23.default.relative(repoRoot, absoluteFilePath);
+    if (relative && !relative.startsWith("..") && !import_path23.default.isAbsolute(relative)) return relative;
+  }
+  return import_path23.default.basename(absoluteFilePath);
+}
+function otherFilesBySaves(sessionEvents, filePath) {
+  const saves = /* @__PURE__ */ new Map();
+  for (const event of sessionEvents) {
+    if (event.category !== CODE_EDIT || !event.file_path || event.file_path === filePath) continue;
+    const seen = saves.get(event.file_path);
+    saves.set(event.file_path, {
+      count: (seen?.count ?? 0) + 1,
+      lastSavedAt: seen && seen.lastSavedAt > event.captured_at ? seen.lastSavedAt : event.captured_at
+    });
+  }
+  return [...saves.entries()].sort(([, first], [, second]) => second.count - first.count || second.lastSavedAt.localeCompare(first.lastSavedAt)).map(([otherPath]) => otherPath);
+}
+function savesOf(sessionEvents, filePath) {
+  return sessionEvents.filter((event) => event.category === CODE_EDIT && event.file_path === filePath);
+}
+function buildFileDetails(options) {
+  const { filePath, sessionEvents, displayPathOf } = options;
+  const saves = savesOf(sessionEvents, filePath);
+  if (saves.length === 0) return null;
+  const savedTimes = saves.map((save) => save.captured_at).sort();
+  const latestBranch = [...saves].reverse().find((save) => save.branch)?.branch ?? null;
+  const otherFiles = otherFilesBySaves(sessionEvents, filePath);
+  return {
+    path: filePath,
+    relativePath: displayPathOf(filePath),
+    firstSavedAt: savedTimes[0],
+    lastSavedAt: savedTimes.at(-1) ?? savedTimes[0],
+    saveCount: saves.length,
+    branch: latestBranch ?? options.sessionBranch,
+    commits: options.commits,
+    editedAlongside: {
+      files: otherFiles.slice(0, EDITED_ALONGSIDE_LIMIT).map(displayPathOf),
+      total: otherFiles.length
+    }
+  };
+}
+var import_path23, EDITED_ALONGSIDE_LIMIT, CODE_EDIT;
+var init_file_details = __esm({
+  "src/summary/file-details.ts"() {
+    "use strict";
+    import_path23 = __toESM(require("path"));
+    EDITED_ALONGSIDE_LIMIT = 5;
+    CODE_EDIT = "code_edit";
+  }
+});
+
+// src/cli/context-file.ts
+function groupDayOfLatestSave(filePath) {
+  const latestSave = getLatestFileSaveAt(filePath);
+  if (!latestSave) return;
+  try {
+    ensureDayGrouped(localDateOf(latestSave), { lockWaitMs: LOCK_WAIT_MS });
+  } catch (error) {
+    if (!isDatabaseLocked(error)) throw error;
+  }
+}
+function getFileDetails(filePath, session) {
+  const sessionEvents = getEventsBySessionId(session.id);
+  if (savesOf(sessionEvents, filePath).length === 0) return null;
+  const { repoRoot, commits } = getFileCommits({
+    filePath: resolvedPath(filePath),
+    since: session.started_at,
+    until: session.ended_at,
+    budgetMs: GIT_BUDGET_MS
+  });
+  return buildFileDetails({
+    filePath,
+    sessionEvents,
+    sessionBranch: getSessionBranch(session.id),
+    commits,
+    displayPathOf: (storedPath) => displayPath2(resolvedPath(storedPath), repoRoot)
+  });
+}
+var LOCK_WAIT_MS, GIT_BUDGET_MS;
+var init_context_file = __esm({
+  "src/cli/context-file.ts"() {
+    "use strict";
+    init_db();
+    init_transaction();
+    init_detector();
+    init_file_details();
+    init_git_commits();
+    init_format();
+    init_working_directory();
+    LOCK_WAIT_MS = 1e3;
+    GIT_BUDGET_MS = 2e3;
+  }
+});
+
 // src/cli/context.ts
 function sessionMinutes(session) {
   return (new Date(session.ended_at).getTime() - new Date(session.started_at).getTime()) / 6e4;
 }
-function toSession(row) {
+function toSession2(row) {
   return {
     id: row.id,
     date: row.date,
@@ -5648,7 +5845,7 @@ function toSession(row) {
 }
 function renderTemplateSummary(row) {
   const config = readConfig();
-  const payload = sessionToPayload(toSession(row), row.date, locationContextFrom(config));
+  const payload = sessionToPayload(toSession2(row), row.date, locationContextFrom(config));
   const bullets = describeSession(payload, config.summary?.includeCategories ?? []);
   return `${formatSessionHeading(payload)}
 ${toBulletList(bullets)}`;
@@ -5658,6 +5855,7 @@ function resolveContextSummary(row) {
 }
 function toContextJson(session) {
   return {
+    repoName: session.repo_name,
     date: session.date,
     startedAt: session.started_at,
     endedAt: session.ended_at,
@@ -5668,6 +5866,9 @@ function toContextJson(session) {
     summary: resolveContextSummary(session)
   };
 }
+function toFileContextJson(session, filePath) {
+  return { ...toContextJson(session), file: getFileDetails(filePath, session) };
+}
 function printSessionContext(session, heading) {
   const ago = timeAgo(session.started_at);
   const branch = getSessionBranch(session.id);
@@ -5688,7 +5889,8 @@ function printSessionContext(session, heading) {
 function registerContext(program) {
   program.command("context").description("Show the last session for the current repo").option("--file <path>", "narrow to last session that touched this file").option("--json", "output as JSON instead of formatted text \u2014 null when no session is found").action((opts) => {
     if (opts.file) {
-      const normalizedFile = import_path22.default.normalize(opts.file);
+      const normalizedFile = import_path24.default.normalize(opts.file);
+      groupDayOfLatestSave(normalizedFile);
       const session = getLastSessionTouchingFile(normalizedFile);
       if (!session) {
         if (opts.json) log.plain(JSON.stringify(null));
@@ -5696,10 +5898,10 @@ function registerContext(program) {
         return;
       }
       if (opts.json) {
-        log.plain(JSON.stringify(toContextJson(session)));
+        log.plain(JSON.stringify(toFileContextJson(session, normalizedFile)));
         return;
       }
-      printSessionContext(session, `Last session touching ${import_path22.default.basename(normalizedFile)}`);
+      printSessionContext(session, `Last session touching ${import_path24.default.basename(normalizedFile)}`);
       return;
     }
     const config = readConfig();
@@ -5725,11 +5927,11 @@ function registerContext(program) {
     printSessionContext(sessions[0], `Last session on ${repoName}`);
   });
 }
-var import_path22, import_chalk14;
+var import_path24, import_chalk14;
 var init_context = __esm({
   "src/cli/context.ts"() {
     "use strict";
-    import_path22 = __toESM(require("path"));
+    import_path24 = __toESM(require("path"));
     import_chalk14 = __toESM(require("chalk"));
     init_db();
     init_git();
@@ -5738,6 +5940,7 @@ var init_context = __esm({
     init_config();
     init_format();
     init_logger();
+    init_context_file();
     init_describe();
     init_utils3();
     init_payload();
@@ -5843,7 +6046,7 @@ function isNewer(latest, current) {
   return latestPatch > currentPatch;
 }
 function checkForUpdate() {
-  const current = "2.0.1";
+  const current = "2.1.0";
   const cache = readCache();
   if (cache && isNewer(cache.latestVersion, current)) {
     process.stderr.write(
@@ -5866,7 +6069,7 @@ function checkForUpdate() {
 function buildTelemetryPayload(config) {
   return {
     installId: config.telemetry.installId,
-    cliVersion: "2.0.1",
+    cliVersion: "2.1.0",
     platform: import_os13.default.platform(),
     nodeVersion: process.version
   };
@@ -5942,7 +6145,7 @@ var require_main = __commonJS({
       pingTelemetry();
     }
     var program = new import_commander.Command();
-    program.name("workscribe").description("Automatic developer work journal").version("2.0.1");
+    program.name("workscribe").description("Automatic developer work journal").version("2.1.0");
     registerCapture(program);
     registerHook(program);
     registerInit(program);