token-goat 2.9.19 → 2.9.21

package/README.md

@@ -21,6 +21,8 @@ permalink: /
 
 Token-Goat sits silently between your AI and your tools. Re-read a file? It gets a one-line hint and a narrow-slice suggestion instead of the full file again. Grab a screenshot? A 100 KB copy reaches the model instead of 10 MB. Run `pytest`, `npm install`, `docker build`, or `cargo`? The thousands of progress bars and passing-test names are stripped to the failures before the output even reaches the context window. Open a PDF, a large Markdown doc, or a CSV? The hook intercepts it — heading tree, page count, or column preview — so the model never pays for the full file. Run `gh run watch` or `next dev` a second time? Prior output is recalled rather than re-run. Compact a long session? It gets a clean structured manifest of edited files and key symbols so nothing important is forgotten. Sessions drop 40–90%+ in cost. You change nothing about how you work.
 
+The symbol index also understands native Nginx, Caddyfile, and Apache HTTP Server configuration blocks, so `token-goat read "file::symbol"` can jump directly to them.
+
 Works with **Claude Code**, **Gemini CLI**, **Qwen Code**, **Codex CLI**, **Aider**, **Cursor**, **Cline**, **Windsurf**, **Copilot CLI**, **VS Code** (Copilot agent), **Visual Studio** (Copilot agent, MCP tools and instructions only), **Zed** (MCP tools only), **Kimi Code**, **Grok CLI** (xAI Grok Build), and OpenCode, plus **pi** ([pi-coding-agent](https://github.com/earendil-works/pi-mono)).
 
 **Ask your AI to install it fully (give it this GitHub link), or install in one command:**
@@ -213,7 +215,7 @@ Numbers below come from synthetic-fixture benchmarks in the test suite, except t
 | Symbol start_line | TypeScript decorators captured in symbol span | One `token-goat read` returns the decorator + signature + body; no re-read | `src/parser.ts` (TypeScript adapter) |
 | Section extraction | Setext headings, h5/h6, anchor IDs, shell comment banners (`##`, `# ---`, `# ===`, `# [...]`, `# REGION:`), and `__frontmatter__` | `token-goat section` resolves more headings and procedural shell checks without falling back to a full file read | `src/parser.ts` (Markdown & Shell adapters) |
 | Image cache | Repeat Read of an unchanged image serves the stored re-encode, keyed on path + size + mtime, instead of re-encoding it again | Skips the re-encode entirely on a hit; the same bytes reach the model, so the reported saving is identical either way | `src/image_shrink.ts` (`findCachedShrink`) |
-| Monorepo defaults | Reindex batch 500 → 2000; compact `min_events` 5 → 3 | Fewer worker wakeups; compact manifests fire on shorter sessions | `src/config.ts` defaults |
+| Monorepo defaults | Reindex batch 500 → 2000 | Fewer worker wakeups on a large tree | `src/config.ts` defaults |
 | Miss suggestions | `read` / `section` print "Did you mean…?" on a miss; `section` also auto-redirects on an unambiguous heading-prefix match | Keeps agents on the surgical-read path instead of falling back to full-file `Read` | `src/read_commands.ts` |
 | Atlassian MCP compression | Strips UI chrome, avatars, operations, and schema links from Jira and Confluence tool responses | 60–80% smaller before generic table compression | `src/mcp_atlassian_compress.ts` |
 | MCP tool spill slicing | Narrow-slice queries on cached MCP tool outputs or dumped JSON files with `mcp-output --json-query` | 90–98% smaller than whole-file JSON re-reads | `src/mcp_json_query.ts` |

package/dist/{token-goat-chunk-JNIFSVWM.mjs → token-goat-chunk-2ZHD3XCD.mjs}

@@ -15,7 +15,7 @@ import {
   foldCase,
   foldPath,
   sleepSync
-} from "./token-goat-chunk-ZGQXRYKE.mjs";
+} from "./token-goat-chunk-TGBSMHPM.mjs";
 import {
   safeJoin
 } from "./token-goat-chunk-NMTKNYGF.mjs";
@@ -1666,6 +1666,10 @@ var LANGUAGE_SPECS = [
   // Oracle PL/SQL sources: package spec and body, standalone procedure/function, trigger, and object type spec and body.
   { id: "sql", extraction: "regex", extensions: [".sql", ".pks", ".pkb", ".pls", ".plsql", ".pck", ".prc", ".fnc", ".trg", ".tps", ".tpb"], label: "SQL", ...DATA, symbolBearing: true, diffable: true, fence: "sql" },
   { id: "ini", extraction: "regex", extensions: [".ini", ".cfg", ".conf"], label: "INI", ...DATA, fence: "ini" },
+  { id: "nginx", extraction: "regex", extensions: [".nginx"], basenames: ["nginx.conf"], label: "Nginx", ...DATA, symbolBearing: true, diffable: true, fence: "nginx" },
+  // `basenames` is matched against a lower-cased basename, so `Caddyfile` is spelled in lower case here; the display spelling is the label's job.
+  { id: "caddy", extraction: "regex", extensions: [".caddy"], basenames: ["caddyfile", "caddy.conf"], label: "Caddyfile", ...DATA, symbolBearing: true, diffable: true, fence: "caddy" },
+  { id: "apache", extraction: "regex", extensions: [".apache", ".apache2"], basenames: ["httpd.conf", "apache2.conf", ".htaccess"], label: "Apache Config", ...DATA, symbolBearing: true, diffable: true, fence: "apache" },
   // `.mk` fragments (config.mk, rules.mk) share a bare Makefile's syntax.
   { id: "makefile", extraction: "regex", extensions: [".mk"], basenames: ["makefile", "gnumakefile", "bsdmakefile"], ...DATA, fence: "makefile", basenameImportsExtension: ".mk" },
   { id: "proto", extraction: "regex", extensions: [".proto"], label: "Protocol Buffers", ...DATA, symbolBearing: true, fence: "protobuf" },

package/dist/{token-goat-chunk-P46RTOAQ.mjs → token-goat-chunk-4IIU3GNS.mjs}

@@ -4,17 +4,19 @@ import {
   DEFAULT_HEARTBEAT_INTERVAL_MS,
   DEFAULT_TIMEOUT_SECONDS,
   MAX_CAPTURE_BYTES,
+  resolveFilter,
   run,
   runRaw
-} from "./token-goat-chunk-MU6I4IDI.mjs";
-import "./token-goat-chunk-7DGTVBWP.mjs";
-import "./token-goat-chunk-S7RFIX4Y.mjs";
-import "./token-goat-chunk-IBTFGZBX.mjs";
-import "./token-goat-chunk-JNIFSVWM.mjs";
-import "./token-goat-chunk-SOKAPOOC.mjs";
+} from "./token-goat-chunk-CMAJGP3E.mjs";
+import "./token-goat-chunk-DDP64XR7.mjs";
+import "./token-goat-chunk-M43UJVYQ.mjs";
+import "./token-goat-chunk-PHDNWISV.mjs";
+import "./token-goat-chunk-XQSSPX3X.mjs";
+import "./token-goat-chunk-2ZHD3XCD.mjs";
+import "./token-goat-chunk-M6CDVASA.mjs";
 import "./token-goat-chunk-EEIDFMEM.mjs";
 import "./token-goat-chunk-OSUFN2FV.mjs";
-import "./token-goat-chunk-ZGQXRYKE.mjs";
+import "./token-goat-chunk-TGBSMHPM.mjs";
 import "./token-goat-chunk-NMTKNYGF.mjs";
 import "./token-goat-chunk-GMOUBOX4.mjs";
 import "./token-goat-chunk-A37V4PBF.mjs";
@@ -22,6 +24,7 @@ export {
   DEFAULT_HEARTBEAT_INTERVAL_MS,
   DEFAULT_TIMEOUT_SECONDS,
   MAX_CAPTURE_BYTES,
+  resolveFilter,
   run,
   runRaw
 };

package/dist/{token-goat-chunk-2GTB5RBZ.mjs → token-goat-chunk-4V4OZHHV.mjs}

@@ -1,47 +1,39 @@
 import { createRequire as __cjsRequire } from 'node:module';
 const require = __cjsRequire(import.meta.url);
 import {
-  accumulateResidentLine,
-  claudeConfigDir,
-  createResidentContextStats,
   enqueueDirtyPathsSafe,
-  estimateTokens,
   fenceUntrusted,
   getToolName,
   getTrackedFiles,
-  scanAndRecord,
-  summarizeResidentContext
-} from "./token-goat-chunk-FQYMZASI.mjs";
+  scanAndRecord
+} from "./token-goat-chunk-SMUYPBF5.mjs";
 import {
   RECALL_DEFAULT_LIMIT,
-  commandHash,
-  getBashOutput,
   indexRecallEntry,
   listRecentRecall,
-  normalizeCommandForCacheKey,
   searchRecall
-} from "./token-goat-chunk-7DGTVBWP.mjs";
+} from "./token-goat-chunk-M43UJVYQ.mjs";
 import {
   isBlobStale,
   loadBlob,
   redactSecrets,
   storeBlob
-} from "./token-goat-chunk-S7RFIX4Y.mjs";
+} from "./token-goat-chunk-PHDNWISV.mjs";
 import {
   parserFingerprintForLanguage
-} from "./token-goat-chunk-EP7TCWHM.mjs";
+} from "./token-goat-chunk-IAMIQLCV.mjs";
 import {
   getProjectFileEntries,
   projectScopeClause
-} from "./token-goat-chunk-IBTFGZBX.mjs";
+} from "./token-goat-chunk-XQSSPX3X.mjs";
 import {
   getDb
-} from "./token-goat-chunk-JNIFSVWM.mjs";
+} from "./token-goat-chunk-2ZHD3XCD.mjs";
 import {
   fingerprintFile,
   getDisplayRoot,
   shortFingerprint
-} from "./token-goat-chunk-SOKAPOOC.mjs";
+} from "./token-goat-chunk-M6CDVASA.mjs";
 import {
   registerReset
 } from "./token-goat-chunk-EEIDFMEM.mjs";
@@ -52,7 +44,7 @@ import {
   foldPath,
   globalDbPath,
   pad
-} from "./token-goat-chunk-ZGQXRYKE.mjs";
+} from "./token-goat-chunk-TGBSMHPM.mjs";
 import {
   UNTRUSTED_TOOL_TAG,
   UNTRUSTED_WEB_TAG,
@@ -132,7 +124,7 @@ var DEFAULT_STDIN_TIMEOUT_MS = 5e3;
 var MAX_STDIN_WALL_MS = 6e4;
 var MAX_STDIN_BYTES = 64 * 1024 * 1024;
 function readStdinJson(timeoutMs = DEFAULT_STDIN_TIMEOUT_MS, maxBytes = MAX_STDIN_BYTES) {
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve2, reject) => {
     const chunks = [];
     let totalBytes = 0;
     let settled = false;
@@ -178,7 +170,7 @@ function readStdinJson(timeoutMs = DEFAULT_STDIN_TIMEOUT_MS, maxBytes = MAX_STDI
           return;
         }
         try {
-          resolve3(JSON.parse(text));
+          resolve2(JSON.parse(text));
         } catch (err) {
           reject(err instanceof Error ? err : new Error(String(err)));
         }
@@ -972,253 +964,6 @@ function reconcileProject(opts = {}) {
   };
 }
 
-// src/waste.ts
-init_define_import_meta_env();
-import * as fs3 from "node:fs";
-import * as path from "node:path";
-function projectTranscriptsDir(projectRoot) {
-  const rootStr = path.resolve(projectRoot);
-  const slug = rootStr.replace(/[^A-Za-z0-9]/g, "-");
-  return path.join(claudeConfigDir(), "projects", slug);
-}
-function findLatestTranscript(projectRoot) {
-  const dir = projectTranscriptsDir(projectRoot);
-  let entries;
-  try {
-    entries = fs3.readdirSync(dir).filter((f) => f.endsWith(".jsonl"));
-  } catch {
-    return null;
-  }
-  let best = null;
-  for (const name of entries) {
-    const full = path.join(dir, name);
-    let stat;
-    try {
-      stat = fs3.statSync(full);
-    } catch {
-      continue;
-    }
-    if (best === null || stat.mtimeMs > best.mtimeMs) best = { file: full, mtimeMs: stat.mtimeMs };
-  }
-  return best?.file ?? null;
-}
-function safeStringify(value) {
-  try {
-    return JSON.stringify(value) ?? "";
-  } catch {
-    return "";
-  }
-}
-var FILE_PATH_TOOLS = /* @__PURE__ */ new Set(["Read", "Edit", "Write", "NotebookEdit", "MultiEdit"]);
-function extractFilePath(name, input) {
-  if (!FILE_PATH_TOOLS.has(name)) return null;
-  if (input === null || typeof input !== "object") return null;
-  const o = input;
-  const fp = o["file_path"];
-  if (typeof fp === "string") return fp;
-  const notebookPath = o["notebook_path"];
-  return typeof notebookPath === "string" ? notebookPath : null;
-}
-function extractCommand(name, input) {
-  if (name !== "Bash") return null;
-  if (input === null || typeof input !== "object") return null;
-  const cmd = input["command"];
-  return typeof cmd === "string" ? cmd : null;
-}
-function summarizeInput(name, input, filePath, command) {
-  if (filePath !== null) return filePath;
-  if (command !== null) return command.length > 100 ? `${command.slice(0, 100)}\u2026` : command;
-  if (input === null || typeof input !== "object") return "";
-  const o = input;
-  for (const key of ["pattern", "query", "path", "description", "prompt"]) {
-    const v = o[key];
-    if (typeof v === "string") return v.length > 100 ? `${v.slice(0, 100)}\u2026` : v;
-  }
-  const s = safeStringify(input);
-  return s.length > 100 ? `${s.slice(0, 100)}\u2026` : s;
-}
-function extractResultText(content) {
-  if (typeof content === "string") return content;
-  if (Array.isArray(content)) {
-    return content.map((b) => {
-      if (b !== null && typeof b === "object" && b["type"] === "text") {
-        const t = b["text"];
-        return typeof t === "string" ? t : "";
-      }
-      return "";
-    }).join("\n");
-  }
-  return "";
-}
-function parseTranscript(transcriptPath) {
-  const raw = fs3.readFileSync(transcriptPath, "utf-8");
-  const calls = [];
-  const resultTextById = /* @__PURE__ */ new Map();
-  const assistantTurns = [];
-  const resident = createResidentContextStats();
-  let seq = 0;
-  for (const line of raw.split("\n")) {
-    const trimmed = line.trim();
-    if (trimmed === "") continue;
-    let obj;
-    try {
-      obj = JSON.parse(trimmed);
-    } catch {
-      continue;
-    }
-    if (obj === null || typeof obj !== "object") continue;
-    const o = obj;
-    accumulateResidentLine(resident, o, trimmed.length);
-    const message = o["message"];
-    if (message === null || typeof message !== "object") continue;
-    const messageObj = message;
-    const content = messageObj["content"];
-    if (!Array.isArray(content)) continue;
-    const role = typeof messageObj["role"] === "string" ? messageObj["role"] : null;
-    const cwd = typeof o["cwd"] === "string" ? o["cwd"] : null;
-    let turnTextTokens = 0;
-    let sawTextBlock = false;
-    for (const block of content) {
-      if (block === null || typeof block !== "object") continue;
-      const b = block;
-      if (b["type"] === "tool_use" && typeof b["id"] === "string" && typeof b["name"] === "string") {
-        const name = b["name"];
-        const input = b["input"];
-        const filePath = extractFilePath(name, input);
-        const command = extractCommand(name, input);
-        calls.push({
-          seq: seq++,
-          id: b["id"],
-          name,
-          input,
-          filePath,
-          command,
-          summary: summarizeInput(name, input, filePath, command),
-          cwd
-        });
-      } else if (b["type"] === "tool_result" && typeof b["tool_use_id"] === "string") {
-        const id = b["tool_use_id"];
-        if (!resultTextById.has(id)) {
-          resultTextById.set(id, extractResultText(b["content"]));
-        }
-      } else if (role === "assistant" && b["type"] === "text" && typeof b["text"] === "string") {
-        sawTextBlock = true;
-        turnTextTokens += estimateTokens(b["text"]);
-      }
-    }
-    if (role === "assistant" && sawTextBlock) assistantTurns.push(turnTextTokens);
-  }
-  return { calls, resultTextById, assistantTurns, resident };
-}
-function costPerCall(parsed) {
-  return parsed.calls.map((c) => ({
-    ...c,
-    tokens: estimateTokens(parsed.resultTextById.get(c.id) ?? "")
-  }));
-}
-function aggregateSortedDesc(pairs) {
-  return [...pairs].map(([key, tokens]) => ({ key, tokens })).sort((a, b) => b.tokens - a.tokens);
-}
-function tokensByTool(costs) {
-  const m = /* @__PURE__ */ new Map();
-  for (const c of costs) m.set(c.name, (m.get(c.name) ?? 0) + c.tokens);
-  return aggregateSortedDesc(m);
-}
-function tokensByFile(costs) {
-  const m = /* @__PURE__ */ new Map();
-  for (const c of costs) {
-    if (c.filePath === null) continue;
-    m.set(c.filePath, (m.get(c.filePath) ?? 0) + c.tokens);
-  }
-  return aggregateSortedDesc(m);
-}
-function topExpensiveCalls(costs, n) {
-  return [...costs].sort((a, b) => b.tokens - a.tokens).slice(0, n);
-}
-function neverTouchedAgain(costs) {
-  const readsByFile = /* @__PURE__ */ new Map();
-  for (const c of costs) {
-    if (c.name !== "Read" || c.filePath === null) continue;
-    const arr = readsByFile.get(c.filePath) ?? [];
-    arr.push(c);
-    readsByFile.set(c.filePath, arr);
-  }
-  const out = [];
-  for (const [filePath, reads] of readsByFile) {
-    const firstSeq = Math.min(...reads.map((r) => r.seq));
-    const touchedLater = costs.some((c) => {
-      if (c.seq <= firstSeq) return false;
-      if (c.filePath === filePath) return true;
-      return safeStringify(c.input).includes(filePath);
-    });
-    if (!touchedLater) {
-      out.push({ filePath, tokens: reads.reduce((n, r) => n + r.tokens, 0) });
-    }
-  }
-  return out.sort((a, b) => b.tokens - a.tokens);
-}
-async function repeatedUncompressedBashCommands(costs) {
-  const groups = /* @__PURE__ */ new Map();
-  for (const c of costs) {
-    if (c.name !== "Bash" || c.command === null) continue;
-    const norm = normalizeCommandForCacheKey(c.command);
-    const arr = groups.get(norm) ?? [];
-    arr.push(c);
-    groups.set(norm, arr);
-  }
-  const out = [];
-  for (const [norm, calls] of groups) {
-    if (calls.length < 2) continue;
-    let cached = false;
-    for (const c of calls) {
-      try {
-        const hash = await commandHash(c.command, c.cwd);
-        if (getBashOutput(hash) !== null) {
-          cached = true;
-          break;
-        }
-      } catch {
-      }
-    }
-    if (cached) continue;
-    const totalTokens = calls.reduce((n, c) => n + c.tokens, 0);
-    out.push({
-      normalized: norm,
-      count: calls.length,
-      totalTokens,
-      avgTokens: Math.round(totalTokens / calls.length)
-    });
-  }
-  return out.sort((a, b) => b.totalTokens - a.totalTokens);
-}
-function assistantOutputCost(assistantTurns) {
-  const turnCount = assistantTurns.length;
-  let generatedTokens = 0;
-  let resendCeilingTokens = 0;
-  for (let i = 0; i < turnCount; i++) {
-    const tokens = assistantTurns[i] ?? 0;
-    generatedTokens += tokens;
-    resendCeilingTokens += tokens * (turnCount - 1 - i);
-  }
-  return { turnCount, generatedTokens, resendCeilingTokens };
-}
-async function buildWasteReport(transcriptPath, opts = {}) {
-  const parsed = parseTranscript(transcriptPath);
-  const costs = costPerCall(parsed);
-  const topN = opts.topN ?? 10;
-  return {
-    transcriptPath,
-    totalTokens: costs.reduce((n, c) => n + c.tokens, 0),
-    tokensByTool: tokensByTool(costs),
-    tokensByFile: tokensByFile(costs),
-    topCalls: topExpensiveCalls(costs, topN).map((c) => ({ seq: c.seq, name: c.name, summary: c.summary, tokens: c.tokens })),
-    neverTouchedAgain: neverTouchedAgain(costs),
-    repeatedUncompressedBash: await repeatedUncompressedBashCommands(costs),
-    assistantOutput: assistantOutputCost(parsed.assistantTurns),
-    residentContext: summarizeResidentContext(parsed.resident)
-  };
-}
-
 // src/cli_recall.ts
 init_define_import_meta_env();
 var RECALL_COMMAND = {
@@ -1294,11 +1039,6 @@ export {
   runReconcile,
   isReconcileClean,
   reconcileProject,
-  projectTranscriptsDir,
-  findLatestTranscript,
-  safeStringify,
-  extractResultText,
-  buildWasteReport,
   RECALL_COMMAND,
   runRecallCommand,
   MAX_STDIN_BYTES,

package/dist/token-goat-chunk-64OEF3UN.mjs

@@ -0,0 +1,128 @@
+import { createRequire as __cjsRequire } from 'node:module';
+const require = __cjsRequire(import.meta.url);
+import {
+  renderWebFetchRow
+} from "./token-goat-chunk-PDYQA3AP.mjs";
+import {
+  SESSIONS_SUBDIR,
+  extractChecklistSection,
+  getSkillFilePath,
+  listSkills
+} from "./token-goat-chunk-MECDAPXB.mjs";
+import {
+  getBashOutput
+} from "./token-goat-chunk-M43UJVYQ.mjs";
+import {
+  loadBlob
+} from "./token-goat-chunk-PHDNWISV.mjs";
+import {
+  resolveProjectRoot
+} from "./token-goat-chunk-M6CDVASA.mjs";
+import {
+  runGit,
+  safeSlice
+} from "./token-goat-chunk-TGBSMHPM.mjs";
+import {
+  displaySafePath,
+  displaySafeText,
+  neutralizeSpokenMarkers
+} from "./token-goat-chunk-NMTKNYGF.mjs";
+import {
+  init_define_import_meta_env
+} from "./token-goat-chunk-A37V4PBF.mjs";
+
+// src/resume.ts
+init_define_import_meta_env();
+import { readFile } from "node:fs/promises";
+var MAX_RESUME_TOKENS = 2e3;
+var MAX_RESUME_CHARS = MAX_RESUME_TOKENS * 4;
+var MAX_RESUME_WEB_FETCHES = 8;
+var SKILL_MAX_COUNT = 3;
+var SKILL_MAX_CHARS_EACH = 400;
+async function buildSkillsSection(sessionId) {
+  const skills = await listSkills(sessionId);
+  if (skills.length === 0) return [];
+  const skillLines = ["## Skills"];
+  for (const skill of skills.slice(0, SKILL_MAX_COUNT)) {
+    let checklist = null;
+    try {
+      const filePath = await getSkillFilePath(skill.name);
+      if (filePath !== null) {
+        const body = await readFile(filePath, "utf-8");
+        checklist = extractChecklistSection(body);
+      }
+    } catch {
+      checklist = null;
+    }
+    if (checklist !== null) {
+      const trimmed = checklist.length > SKILL_MAX_CHARS_EACH ? checklist.slice(0, SKILL_MAX_CHARS_EACH).trimEnd() + "\u2026" : checklist;
+      skillLines.push(`**${displaySafeText(skill.name)}**:`);
+      skillLines.push(neutralizeSpokenMarkers(trimmed));
+    } else {
+      skillLines.push(`**${displaySafeText(skill.name)}** \u2014 \`token-goat skill-body ${displaySafeText(skill.name)} --section DoD\``);
+    }
+  }
+  skillLines.push("");
+  return skillLines;
+}
+async function buildResumePacket(sessionId) {
+  const blob = loadBlob(SESSIONS_SUBDIR, sessionId);
+  if (blob === null || typeof blob !== "object") return null;
+  const raw = blob;
+  const filesArr = Array.isArray(raw["files"]) ? raw["files"] : [];
+  const lines = [`# Resume packet \u2014 session ${displaySafeText(sessionId)}`, ""];
+  try {
+    lines.push(...await buildSkillsSection(sessionId));
+  } catch {
+  }
+  const editedPaths = filesArr.filter((f) => f["wasEdited"] === true).map((f) => typeof f["path"] === "string" ? f["path"] : "").filter(Boolean).slice(0, 10);
+  if (editedPaths.length > 0) {
+    lines.push("## Edited files");
+    for (const p of editedPaths) lines.push(`- ${displaySafePath(p)}`);
+    lines.push("");
+  }
+  const topRead = [...filesArr].filter((f) => f["wasEdited"] !== true).sort((a, b) => (typeof b["readCount"] === "number" ? b["readCount"] : 0) - (typeof a["readCount"] === "number" ? a["readCount"] : 0)).slice(0, 8).map((f) => typeof f["path"] === "string" ? f["path"] : "").filter(Boolean);
+  if (topRead.length > 0) {
+    lines.push("## Top files read");
+    for (const p of topRead) lines.push(`- ${displaySafePath(p)}`);
+    lines.push("");
+  }
+  const bashOutputs = Array.isArray(raw["bashOutputs"]) ? raw["bashOutputs"] : [];
+  const recentBash = bashOutputs.slice(-2);
+  if (recentBash.length > 0) {
+    lines.push("## Recent bash commands");
+    for (const entry of recentBash) {
+      if (Array.isArray(entry) && typeof entry[1] === "string") {
+        const bashEntry = getBashOutput(entry[1]);
+        if (bashEntry !== null) lines.push(`- ${displaySafeText(bashEntry.command)}`);
+      }
+    }
+    lines.push("");
+  }
+  const webFetches = Array.isArray(raw["webFetches"]) ? raw["webFetches"] : [];
+  const webRows = webFetches.slice(-MAX_RESUME_WEB_FETCHES).filter((e) => Array.isArray(e) && typeof e[0] === "string" && typeof e[1] === "string").map(([key, cacheId]) => renderWebFetchRow(key, cacheId));
+  if (webRows.length > 0) {
+    lines.push("## Web pages fetched");
+    lines.push(...webRows);
+    lines.push("");
+  }
+  try {
+    const projectRoot = resolveProjectRoot();
+    const result = runGit(["diff", "--stat"], { cwd: projectRoot });
+    if (result.exitCode === 0 && result.stdout.trim().length > 0) {
+      lines.push("## Uncommitted changes (git diff --stat)");
+      lines.push(result.stdout.trim().split("\n").map(displaySafeText).join("\n"));
+      lines.push("");
+    }
+  } catch {
+  }
+  const text = lines.join("\n");
+  if (text.length <= MAX_RESUME_CHARS) return text;
+  return safeSlice(text, MAX_RESUME_CHARS) + "\n... (truncated to cap)\n";
+}
+
+export {
+  MAX_RESUME_TOKENS,
+  MAX_RESUME_CHARS,
+  buildResumePacket
+};