@yawlabs/ctxlint 0.24.0 → 0.25.0

package/dist/index.js

@@ -27551,6 +27551,20 @@ import { readdir as readdir3 } from "node:fs/promises";
 import { homedir as homedir6 } from "node:os";
 import { join as join9 } from "node:path";
 import { createInterface as createInterface2 } from "node:readline";
+function emptyRead() {
+  return {
+    events: [],
+    filesRead: 0,
+    truncated: false,
+    sessionTurns: /* @__PURE__ */ new Map(),
+    sessionCompactions: /* @__PURE__ */ new Map()
+  };
+}
+function turnsCarried(read, ev) {
+  const total = read.sessionTurns.get(ev.sessionId) ?? ev.turn;
+  const boundary = read.sessionCompactions.get(ev.sessionId)?.find((b2) => b2 >= ev.turn);
+  return Math.max(0, (boundary ?? total) - ev.turn);
+}
 function asString(v2) {
   return typeof v2 === "string" ? v2 : "";
 }
@@ -27571,14 +27585,17 @@ function readProjectTranscript(project, home2 = resolveHome()) {
   }
   return hit;
 }
+function clearTranscriptCache() {
+  cache.clear();
+}
 function candidateDirs(project, home2) {
   const root = join9(home2, ".claude", "projects");
   return projectDirCandidates(project).map((n7) => join9(root, n7)).filter((d) => existsSync5(d));
 }
 async function readUncached(project, home2) {
-  if (!home2 || !project) return EMPTY;
+  if (!home2 || !project) return emptyRead();
   const dirs = candidateDirs(project, home2);
-  if (dirs.length === 0) return EMPTY;
+  if (dirs.length === 0) return emptyRead();
   const names = [];
   for (const dir of dirs) {
     for (const name of await readdir3(dir).catch(() => [])) {
@@ -27595,8 +27612,7 @@ async function readUncached(project, home2) {
   }).filter((f) => f !== null).sort((a, b2) => b2.mtime - a.mtime);
   let truncated = files.length > MAX_TRANSCRIPTS;
   const selected = files.slice(0, MAX_TRANSCRIPTS);
-  const events = [];
-  const pending = /* @__PURE__ */ new Map();
+  const st2 = { events: [], pending: /* @__PURE__ */ new Map(), sessions: /* @__PURE__ */ new Map(), anonymous: 0 };
   let lines = 0;
   for (const { p: p2 } of selected) {
     if (lines >= MAX_LINES2) {
@@ -27621,21 +27637,75 @@ async function readUncached(project, home2) {
         } catch {
           continue;
         }
-        collect(rec, events, pending);
+        collect(rec, st2);
       }
     } catch {
     } finally {
       rl.close();
     }
   }
-  return { events, filesRead: selected.length, truncated };
+  const sessionTurns = /* @__PURE__ */ new Map();
+  const sessionCompactions = /* @__PURE__ */ new Map();
+  for (const [id, s] of st2.sessions) {
+    sessionTurns.set(id, s.ordinals.size);
+    if (s.compactions.length > 0) {
+      sessionCompactions.set(
+        id,
+        [...s.compactions].sort((a, b2) => a - b2)
+      );
+    }
+  }
+  return {
+    events: st2.events,
+    filesRead: selected.length,
+    truncated,
+    sessionTurns,
+    sessionCompactions
+  };
+}
+function sessionState(st2, sessionId) {
+  let s = st2.sessions.get(sessionId);
+  if (!s) {
+    s = { ordinals: /* @__PURE__ */ new Map(), compactions: [] };
+    st2.sessions.set(sessionId, s);
+  }
+  return s;
 }
-function collect(rec, events, pending) {
+function turnOf(rec, message, st2, sessionId) {
+  const s = sessionState(st2, sessionId);
+  if (message?.model === "<synthetic>" || rec.isSidechain === true) return s.ordinals.size;
+  const key = asString(message?.id) || asString(rec.requestId) || `#anonymous:${++st2.anonymous}`;
+  let ordinal = s.ordinals.get(key);
+  if (ordinal === void 0) {
+    ordinal = s.ordinals.size + 1;
+    s.ordinals.set(key, ordinal);
+  }
+  return ordinal;
+}
+function isSet(v2) {
+  return v2 !== void 0 && v2 !== null && v2 !== "";
+}
+function readResultLines(rec, path21) {
+  const result = rec.toolUseResult;
+  if (!result || typeof result !== "object") return void 0;
+  const file2 = result.file;
+  if (!file2 || typeof file2 !== "object") return void 0;
+  const { filePath, numLines } = file2;
+  if (filePath !== path21) return void 0;
+  return typeof numLines === "number" ? numLines : void 0;
+}
+function collect(rec, st2) {
+  const sessionId = asString(rec.sessionId) || asString(rec.session_id);
+  if (rec.type === "system" && rec.subtype === "compact_boundary") {
+    const s = sessionState(st2, sessionId);
+    s.compactions.push(s.ordinals.size);
+    return;
+  }
   const message = rec.message;
+  const turn = rec.type === "assistant" ? turnOf(rec, message, st2, sessionId) : st2.sessions.get(sessionId)?.ordinals.size ?? 0;
   const content = message?.content;
   if (!Array.isArray(content)) return;
   const timestamp = Date.parse(asString(rec.timestamp)) || 0;
-  const sessionId = asString(rec.sessionId) || asString(rec.session_id);
   const gitBranch = asString(rec.gitBranch) || void 0;
   for (const raw of content) {
     if (!raw || typeof raw !== "object") continue;
@@ -27644,7 +27714,15 @@ function collect(rec, events, pending) {
     if (type === "text" && rec.type === "assistant") {
       const text = asString(block.text);
       if (text) {
-        events.push({ kind: "assistant-text", text, tool: "", gitBranch, timestamp, sessionId });
+        st2.events.push({
+          kind: "assistant-text",
+          text,
+          tool: "",
+          gitBranch,
+          turn,
+          timestamp,
+          sessionId
+        });
       }
       continue;
     }
@@ -27653,49 +27731,76 @@ function collect(rec, events, pending) {
       const input = block.input ?? {};
       const cmdField = COMMAND_TOOLS[tool];
       const writeField = WRITE_TOOLS[tool];
+      const readField = READ_TOOLS[tool];
       let ev = null;
       if (cmdField) {
         const text = asString(input[cmdField]);
-        if (text) ev = { kind: "command", text, tool, gitBranch, timestamp, sessionId };
+        if (text) ev = { kind: "command", text, tool, gitBranch, turn, timestamp, sessionId };
       } else if (writeField) {
         const text = asString(input[writeField]);
-        if (text) ev = { kind: "file-write", text, tool, gitBranch, timestamp, sessionId };
+        if (text) ev = { kind: "file-write", text, tool, gitBranch, turn, timestamp, sessionId };
+      } else if (readField) {
+        const text = asString(input[readField]);
+        if (text) {
+          ev = {
+            kind: "file-read",
+            text,
+            tool,
+            partial: PARTIAL_READ_FIELDS.some((f) => isSet(input[f])),
+            gitBranch,
+            turn,
+            timestamp,
+            sessionId
+          };
+        }
       }
       if (ev) {
-        events.push(ev);
         const id = asString(block.id);
-        if (id) pending.set(id, ev);
+        if (id) ev.toolUseId = id;
+        st2.events.push(ev);
+        if (id) st2.pending.set(id, ev);
       }
       continue;
     }
     if (type === "tool_result") {
       const id = asString(block.tool_use_id);
-      const ev = id ? pending.get(id) : void 0;
+      const ev = id ? st2.pending.get(id) : void 0;
       if (!ev) continue;
-      pending.delete(id);
+      st2.pending.delete(id);
+      const out = resultText(block.content);
       ev.isError = block.is_error === true;
-      ev.emptyOutput = resultText(block.content).trim().length === 0;
+      ev.emptyOutput = out.trim().length === 0;
+      ev.outputChars = out.length;
+      if (ev.kind === "file-read") {
+        ev.outputTokens = countTokens(out);
+        const lineCount = readResultLines(rec, ev.text);
+        if (lineCount !== void 0) ev.outputLines = lineCount;
+      }
     }
   }
 }
-var WRITE_TOOLS, COMMAND_TOOLS, MAX_TRANSCRIPTS, MAX_LINES2, EMPTY, cache;
+var WRITE_TOOLS, READ_TOOLS, PARTIAL_READ_FIELDS, COMMAND_TOOLS, MAX_TRANSCRIPTS, MAX_LINES2, cache;
 var init_transcript = __esm({
   "src/core/transcript.ts"() {
     "use strict";
     init_define_WEB_FIRST_SEGMENTS();
+    init_tokens();
     init_session_parser();
     WRITE_TOOLS = {
       Write: "file_path",
       Edit: "file_path",
       NotebookEdit: "notebook_path"
     };
+    READ_TOOLS = {
+      Read: "file_path"
+    };
+    PARTIAL_READ_FIELDS = ["offset", "limit", "pages"];
     COMMAND_TOOLS = {
       Bash: "command",
       PowerShell: "command"
     };
     MAX_TRANSCRIPTS = 5;
     MAX_LINES2 = 2e5;
-    EMPTY = { events: [], filesRead: 0, truncated: false };
     cache = /* @__PURE__ */ new Map();
   }
 });
@@ -27833,7 +27938,7 @@ function isUnverified(ev) {
 async function checkUnverifiedGateClaimedClean(ctx) {
   const { events } = await readProjectTranscript(ctx.currentProject);
   if (events.length === 0) return [];
-  const ordered = [...events].sort((a, b2) => a.timestamp - b2.timestamp);
+  const ordered = events.filter((e) => e.kind !== "file-read").sort((a, b2) => a.timestamp - b2.timestamp);
   const issues = [];
   const reported = /* @__PURE__ */ new Set();
   for (let i2 = 0; i2 < ordered.length; i2++) {
@@ -27914,7 +28019,7 @@ function isBranchAway(cmd) {
 async function checkDefaultBranchAccumulation(ctx) {
   const { events } = await readProjectTranscript(ctx.currentProject);
   if (events.length === 0) return [];
-  const ordered = [...events].sort((a, b2) => a.timestamp - b2.timestamp);
+  const ordered = events.filter((e) => e.kind !== "file-read").sort((a, b2) => a.timestamp - b2.timestamp);
   const pending = /* @__PURE__ */ new Set();
   let branch = "";
   let firstWrite = "";
@@ -28058,6 +28163,93 @@ var init_unresolvable_sha = __esm({
   }
 });
 
+// src/core/checks/session/large-read.ts
+import { isAbsolute as isAbsolute6, relative as relative6 } from "node:path";
+function qualifies(ev) {
+  if (ev.kind !== "file-read" || ev.partial || ev.isError) return false;
+  return (ev.outputTokens ?? 0) >= LARGE_READ_TOKENS;
+}
+function fmt(n7) {
+  return n7.toLocaleString("en-US");
+}
+function displayPath(path21, project) {
+  const rel = relative6(project, path21);
+  if (rel && !rel.startsWith("..") && !isAbsolute6(rel)) return rel.replace(/\\/g, "/");
+  return path21;
+}
+function fileKey(path21) {
+  const slashed = path21.replace(/\\/g, "/");
+  return process.platform === "win32" ? slashed.toLowerCase() : slashed;
+}
+async function checkLargeRead(ctx) {
+  const read = await readProjectTranscript(ctx.currentProject);
+  const byCall = /* @__PURE__ */ new Map();
+  const unkeyed = [];
+  for (const ev of read.events) {
+    if (!qualifies(ev)) continue;
+    const hit = { ev, tokens: ev.outputTokens ?? 0, carried: turnsCarried(read, ev) };
+    if (!ev.toolUseId) {
+      unkeyed.push(hit);
+      continue;
+    }
+    const prev = byCall.get(ev.toolUseId);
+    if (!prev || hit.carried < prev.carried) byCall.set(ev.toolUseId, hit);
+  }
+  const hits = [...byCall.values(), ...unkeyed];
+  if (hits.length === 0) return [];
+  let totalTokens = 0;
+  let carry = 0;
+  const files = /* @__PURE__ */ new Map();
+  for (const { ev, tokens, carried } of hits) {
+    totalTokens += tokens;
+    carry += tokens * carried;
+    const key = fileKey(ev.text);
+    const file2 = files.get(key) ?? { path: ev.text, reads: 0, tokens: 0 };
+    file2.reads += 1;
+    file2.tokens += tokens;
+    if (ev.outputLines !== void 0) file2.lines = Math.max(file2.lines ?? 0, ev.outputLines);
+    files.set(key, file2);
+  }
+  const top = [...files.values()].sort((a, b2) => b2.tokens - a.tokens || a.path.localeCompare(b2.path)).slice(0, TOP_FILES);
+  const topLines = top.map((f) => {
+    const reads = `${f.reads} read${f.reads === 1 ? "" : "s"}`;
+    const lines = f.lines !== void 0 ? `, ${fmt(f.lines)} line${f.lines === 1 ? "" : "s"}` : "";
+    return `  ${displayPath(f.path, ctx.currentProject)} -- ${reads}, ${fmt(f.tokens)} tokens${lines}`;
+  });
+  const count = hits.length;
+  const detail = [
+    `Largest files by tokens read whole:`,
+    ...topLines,
+    `Carry = each Read's result tokens x the later turns of its session that re-sent it (to the session's end or its next /compact). An estimate: tokens are counted with a proxy tokenizer, and a result's first re-send is a cache write rather than a read.`
+  ];
+  if (read.truncated) {
+    detail.push(
+      `Transcript read was capped (${read.filesRead} most recent transcripts, bounded line count): these figures cover only what was read, so the real totals are higher.`
+    );
+  }
+  return [
+    {
+      severity: "info",
+      check: "session-large-read",
+      ruleId: "session-large-read/large-read",
+      line: 0,
+      message: `${count} whole-file Read${count === 1 ? "" : "s"} of ${fmt(LARGE_READ_TOKENS)}+ tokens (${fmt(totalTokens)} tokens); est. ${fmt(carry)} tokens of cache-read carry on later turns`,
+      detail: detail.join("\n"),
+      suggestion: "Before reading a large file whole, find the part you need with `grep -n` (or the Grep tool) and Read just that range with `offset`/`limit`. For a question that needs the whole file, delegate it to a subagent: its reads stay in its own context and only the answer comes back."
+    }
+  ];
+}
+var LARGE_READ_TOKENS, TOP_FILES;
+var init_large_read = __esm({
+  "src/core/checks/session/large-read.ts"() {
+    "use strict";
+    init_define_WEB_FIRST_SEGMENTS();
+    init_transcript();
+    LARGE_READ_TOKENS = 4e3;
+    TOP_FILES = 3;
+  }
+});
+
 // src/core/checks/ci-coverage.ts
 import { readdir as readdir4, readFile as readFile4 } from "node:fs/promises";
 import { join as join10 } from "node:path";
@@ -29108,7 +29300,7 @@ import { readFileSync as readFileSync8 } from "node:fs";
 import { resolve as resolve15, dirname as dirname7 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 function loadVersion() {
-  if (true) return "0.24.0";
+  if (true) return "0.25.0";
   try {
     const __dir = dirname7(fileURLToPath2(import.meta.url));
     const pkgPath = resolve15(__dir, "../package.json");
@@ -29357,6 +29549,8 @@ async function runAudit(projectRoot, activeChecks, options = {}) {
         sessionPromises.push(checkDefaultBranchAccumulation(sessionCtx));
       if (sessionChecksToRun.includes("session-unresolvable-sha"))
         sessionPromises.push(checkUnresolvableSha(sessionCtx));
+      if (sessionChecksToRun.includes("session-large-read"))
+        sessionPromises.push(checkLargeRead(sessionCtx));
       const sessionResults = await Promise.all(sessionPromises);
       const sessionIssues = sessionResults.flat();
       fileResults.push({
@@ -29562,6 +29756,7 @@ var init_audit = __esm({
     init_unverified_gate_claimed_clean();
     init_default_branch_accumulation();
     init_unresolvable_sha();
+    init_large_read();
     init_ci_coverage();
     init_ci_secrets();
     init_content_secrets();
@@ -29607,7 +29802,8 @@ var init_audit = __esm({
       "session-shared-temp-path",
       "session-unverified-gate-claimed-clean",
       "session-default-branch-accumulation",
-      "session-unresolvable-sha"
+      "session-unresolvable-sha",
+      "session-large-read"
     ];
     ALL_SKILL_CHECKS = [
       "skill-frontmatter",
@@ -56870,49 +57066,49 @@ var require_fast_uri = __commonJS({
       schemelessOptions.skipEscape = true;
       return serialize(resolved, schemelessOptions);
     }
-    function resolveComponent(base, relative8, options, skipNormalization) {
+    function resolveComponent(base, relative9, options, skipNormalization) {
       const target = {};
       if (!skipNormalization) {
         base = parse5(serialize(base, options), options);
-        relative8 = parse5(serialize(relative8, options), options);
+        relative9 = parse5(serialize(relative9, options), options);
       }
       options = options || {};
-      if (!options.tolerant && relative8.scheme) {
-        target.scheme = relative8.scheme;
-        target.userinfo = relative8.userinfo;
-        target.host = relative8.host;
-        target.port = relative8.port;
-        target.path = removeDotSegments(relative8.path || "");
-        target.query = relative8.query;
+      if (!options.tolerant && relative9.scheme) {
+        target.scheme = relative9.scheme;
+        target.userinfo = relative9.userinfo;
+        target.host = relative9.host;
+        target.port = relative9.port;
+        target.path = removeDotSegments(relative9.path || "");
+        target.query = relative9.query;
       } else {
-        if (relative8.userinfo !== void 0 || relative8.host !== void 0 || relative8.port !== void 0) {
-          target.userinfo = relative8.userinfo;
-          target.host = relative8.host;
-          target.port = relative8.port;
-          target.path = removeDotSegments(relative8.path || "");
-          target.query = relative8.query;
+        if (relative9.userinfo !== void 0 || relative9.host !== void 0 || relative9.port !== void 0) {
+          target.userinfo = relative9.userinfo;
+          target.host = relative9.host;
+          target.port = relative9.port;
+          target.path = removeDotSegments(relative9.path || "");
+          target.query = relative9.query;
         } else {
-          if (!relative8.path) {
+          if (!relative9.path) {
             target.path = base.path;
-            if (relative8.query !== void 0) {
-              target.query = relative8.query;
+            if (relative9.query !== void 0) {
+              target.query = relative9.query;
             } else {
               target.query = base.query;
             }
           } else {
-            if (relative8.path[0] === "/") {
-              target.path = removeDotSegments(relative8.path);
+            if (relative9.path[0] === "/") {
+              target.path = removeDotSegments(relative9.path);
             } else {
               if ((base.userinfo !== void 0 || base.host !== void 0 || base.port !== void 0) && !base.path) {
-                target.path = "/" + relative8.path;
+                target.path = "/" + relative9.path;
               } else if (!base.path) {
-                target.path = relative8.path;
+                target.path = relative9.path;
               } else {
-                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative8.path;
+                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative9.path;
               }
               target.path = removeDotSegments(target.path);
             }
-            target.query = relative8.query;
+            target.query = relative9.query;
           }
           target.userinfo = base.userinfo;
           target.host = base.host;
@@ -56920,7 +57116,7 @@ var require_fast_uri = __commonJS({
         }
         target.scheme = base.scheme;
       }
-      target.fragment = relative8.fragment;
+      target.fragment = relative9.fragment;
       return target;
     }
     function equal(uriA, uriB, options) {
@@ -59407,11 +59603,11 @@ var require_format = __commonJS({
           }
           function getFormat(fmtDef) {
             const code = fmtDef instanceof RegExp ? (0, codegen_1.regexpCode)(fmtDef) : opts.code.formats ? (0, codegen_1._)`${opts.code.formats}${(0, codegen_1.getProperty)(schema)}` : void 0;
-            const fmt = gen.scopeValue("formats", { key: schema, ref: fmtDef, code });
+            const fmt2 = gen.scopeValue("formats", { key: schema, ref: fmtDef, code });
             if (typeof fmtDef == "object" && !(fmtDef instanceof RegExp)) {
-              return [fmtDef.type || "string", fmtDef.validate, (0, codegen_1._)`${fmt}.validate`];
+              return [fmtDef.type || "string", fmtDef.validate, (0, codegen_1._)`${fmt2}.validate`];
             }
-            return ["string", fmtDef, fmt];
+            return ["string", fmtDef, fmt2];
           }
           function validCondition() {
             if (typeof formatDef == "object" && !(formatDef instanceof RegExp) && formatDef.async) {
@@ -60081,8 +60277,8 @@ var require_limit = __commonJS({
             ref: self2.formats,
             code: opts.code.formats
           });
-          const fmt = gen.const("fmt", (0, codegen_1._)`${fmts}[${fCxt.schemaCode}]`);
-          cxt.fail$data((0, codegen_1.or)((0, codegen_1._)`typeof ${fmt} != "object"`, (0, codegen_1._)`${fmt} instanceof RegExp`, (0, codegen_1._)`typeof ${fmt}.compare != "function"`, compareCode(fmt)));
+          const fmt2 = gen.const("fmt", (0, codegen_1._)`${fmts}[${fCxt.schemaCode}]`);
+          cxt.fail$data((0, codegen_1.or)((0, codegen_1._)`typeof ${fmt2} != "object"`, (0, codegen_1._)`${fmt2} instanceof RegExp`, (0, codegen_1._)`typeof ${fmt2}.compare != "function"`, compareCode(fmt2)));
         }
         function validateFormat() {
           const format3 = fCxt.schema;
@@ -60092,15 +60288,15 @@ var require_limit = __commonJS({
           if (typeof fmtDef != "object" || fmtDef instanceof RegExp || typeof fmtDef.compare != "function") {
             throw new Error(`"${keyword}": format "${format3}" does not define "compare" function`);
           }
-          const fmt = gen.scopeValue("formats", {
+          const fmt2 = gen.scopeValue("formats", {
             key: format3,
             ref: fmtDef,
             code: opts.code.formats ? (0, codegen_1._)`${opts.code.formats}${(0, codegen_1.getProperty)(format3)}` : void 0
           });
-          cxt.fail$data(compareCode(fmt));
+          cxt.fail$data(compareCode(fmt2));
         }
-        function compareCode(fmt) {
-          return (0, codegen_1._)`${fmt}.compare(${data}, ${schemaCode}) ${KWDs[keyword].fail} 0`;
+        function compareCode(fmt2) {
+          return (0, codegen_1._)`${fmt2}.compare(${data}, ${schemaCode}) ${KWDs[keyword].fail} 0`;
         }
       },
       dependencies: ["format"]
@@ -62825,6 +63021,7 @@ var init_server4 = __esm({
     init_tokens();
     init_git();
     init_paths();
+    init_transcript();
     init_version2();
     contextCheckEnum = external_exports.enum(ALL_CHECKS);
     mcpCheckEnum = external_exports.enum(ALL_MCP_CHECKS);
@@ -63077,7 +63274,7 @@ var init_server4 = __esm({
     );
     server.tool(
       "ctxlint_session_audit",
-      "Audit AI agent session data for cross-project consistency. Checks for missing GitHub secrets, diverged config files, missing workflows, stale memory entries, and duplicate memories across sibling repositories.",
+      "Audit AI agent session data for cross-project consistency and session hazards. Checks for missing GitHub secrets, diverged config files and missing workflows across sibling repositories; stale, duplicate or overflowing memory entries; command loops; and, from Claude Code transcripts, shared temp paths, gates claimed clean after failing, edits piling up on the default branch, unresolvable commit SHAs in memory, and large whole-file Reads re-sent as context on later turns.",
       {
         projectPath: external_exports.string().optional().describe("Path to the project root. Defaults to current working directory."),
         checks: external_exports.array(sessionCheckEnum).optional().describe("Specific session checks to run (default: all session-* checks).")
@@ -63110,6 +63307,7 @@ var init_server4 = __esm({
           resetGit();
           resetPathsCache();
           resetPackageJsonCache();
+          clearTranscriptCache();
         }
       }
     );
@@ -70128,6 +70326,13 @@ function buildRuleDescriptors() {
       },
       helpUri: "https://github.com/yawlabs/ctxlint#what-it-checks"
     },
+    {
+      id: "ctxlint/session-large-read",
+      shortDescription: {
+        text: "Whole-file Reads of large files re-sent as context on every later turn"
+      },
+      helpUri: "https://github.com/yawlabs/ctxlint#what-it-checks"
+    },
     {
       id: "ctxlint/skill-frontmatter",
       shortDescription: { text: "Skill/agent definition missing required frontmatter" },
@@ -70362,6 +70567,7 @@ Fixed ${applied.totalFixes} issue${applied.totalFixes !== 1 ? "s" : ""} in ${app
       resetGit();
       resetPathsCache();
       resetPackageJsonCache();
+      clearTranscriptCache();
     }
     if (opts.watch) {
       const chalk2 = (await Promise.resolve().then(() => (init_source(), source_exports))).default;
@@ -70458,6 +70664,7 @@ Fixed ${applied.totalFixes} issue${applied.totalFixes !== 1 ? "s" : ""} in ${app
             resetPathsCache();
             resetPackageJsonCache();
             clearFileCache();
+            clearTranscriptCache();
           }
           console.log(chalk2.dim("\nWatching for changes... (Ctrl+C to stop)\n"));
         }, 300);
@@ -70651,6 +70858,7 @@ var init_cli = __esm({
     init_ora();
     init_paths();
     init_cache();
+    init_transcript();
     init_reporter();
     init_fixer();
     init_tokens();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yawlabs/ctxlint",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "mcpName": "io.github.YawLabs/ctxlint",
   "description": "Lint your AI agent context files, MCP server configs, and session data against your actual codebase",
   "bin": {