@almightygpt/core 0.3.0 → 0.5.1

package/dist/review/write.js.map

@@ -1 +1 @@
-{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/review/write.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/review/write.ts"],"names":[],"mappings":"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"}

package/dist/runs/types.d.ts

@@ -17,6 +17,12 @@ export interface AgentMetrics {
     provider: string;
     model: string;
     tokensIn: number;
+    /**
+     * Portion of tokensIn served from the provider's prompt cache (Anthropic
+     * cache_read, OpenAI prompt_tokens_details.cached_tokens). Always less
+     * than or equal to tokensIn. Zero when caching didn't trigger.
+     */
+    cachedTokensIn?: number;
     tokensOut: number;
     costUsd: number;
     latencyMs: number;

package/dist/runs/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runs/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,OAAO,GACf,aAAa,GACb,aAAa,GACb,oBAAoB,GACpB,wBAAwB,CAAC;AAE7B,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,gBAAgB,CAAC;AAE9E,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,GAAG,CAAC,EAAE;QACJ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,+BAA+B;IAC/B,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,kBAAkB,GAAG,KAAK,CAAC;QACpE,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,sDAAsD;IACtD,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAC7E,gCAAgC;IAChC,eAAe,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxD,oBAAoB;IACpB,MAAM,EAAE,SAAS,CAAC;IAClB,yBAAyB;IACzB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,wBAAwB;IACxB,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,+CAA+C;IAC/C,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,uCAAuC;IACvC,MAAM,EAAE;QACN,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,wDAAwD;IACxD,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,eAAe,GACf,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runs/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almightygpt/core",
-  "version": "0.3.0",
+  "version": "0.5.1",
   "description": "Core orchestrator, adapters, config, runs, and review logic for AlmightyGPT",
   "license": "MIT",
   "type": "module",
@@ -26,6 +26,7 @@
     "@anthropic-ai/sdk": "^0.30.0",
     "@google/generative-ai": "^0.21.0",
     "execa": "^9.3.0",
+    "ignore": "^6.0.2",
     "openai": "^4.52.0",
     "p-limit": "^5.0.0",
     "yaml": "^2.4.0",

package/src/adapters/claude.ts

@@ -39,7 +39,7 @@ export class ClaudeAdapter implements Adapter {
   readonly provider = "anthropic";
 
   private readonly client: Anthropic | null;
-  private readonly defaultModel: string;
+  readonly defaultModel: string;
   private readonly defaultMaxOutputTokens: number;
   private readonly defaultTimeoutMs: number;
 
@@ -76,7 +76,23 @@ export class ClaudeAdapter implements Adapter {
         {
           model,
           max_tokens: maxOutputTokens,
-          system: input.systemPrompt,
+          // Pass system as a content-block array with cache_control:
+          // ephemeral on the (only) block. Anthropic caches the marked
+          // block for ~5 minutes; subsequent calls with the same prefix
+          // get charged at 10% of normal input rate for the cached span.
+          // The CLI's review flow re-sends the same memory (AGENTS.md +
+          // CODEX_AGENT.md + rules.md) on every run, so this is a near-
+          // perfect fit.
+          // cache_control isn't in the SDK 0.30.x .d.ts yet but the
+          // v1/messages API accepts it. Cast at the call site.
+          system: [
+            {
+              type: "text",
+              text: input.systemPrompt,
+              cache_control: { type: "ephemeral" },
+              // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            } as any,
+          ],
           messages: [{ role: "user", content: input.userMessage }],
         },
         { timeout: timeoutMs },
@@ -102,13 +118,36 @@ export class ClaudeAdapter implements Adapter {
       );
     }
 
-    const tokensIn = response.usage.input_tokens;
-    const tokensOut = response.usage.output_tokens;
-    const costUsd = estimateCostUsd(model, tokensIn, tokensOut);
+    // Anthropic usage fields with caching enabled:
+    //   input_tokens                — fresh-hit input tokens (full price)
+    //   cache_creation_input_tokens — tokens that just got written to the
+    //                                 cache (1.25× of normal rate, one-time)
+    //   cache_read_input_tokens     — tokens served from existing cache
+    //                                 (0.1× of normal rate)
+    // We surface cache_read as `cachedTokensIn`. Cache-creation tokens are
+    // folded into `tokensIn` total for visibility and cost-modeled at the
+    // normal rate (close enough — the 25% surcharge is small relative to
+    // the savings on subsequent reads).
+    const usage = response.usage as Anthropic.Usage & {
+      cache_creation_input_tokens?: number;
+      cache_read_input_tokens?: number;
+    };
+    const freshIn = usage.input_tokens;
+    const cacheCreationIn = usage.cache_creation_input_tokens ?? 0;
+    const cacheReadIn = usage.cache_read_input_tokens ?? 0;
+    const tokensIn = freshIn + cacheCreationIn + cacheReadIn;
+    const tokensOut = usage.output_tokens;
+    const costUsd = estimateCostUsdWithCache(
+      model,
+      freshIn + cacheCreationIn, // both billed at ~normal input rate
+      cacheReadIn,
+      tokensOut,
+    );
 
     return {
       content,
       tokensIn,
+      cachedTokensIn: cacheReadIn,
       tokensOut,
       costUsd,
       latencyMs: Date.now() - start,
@@ -118,9 +157,17 @@ export class ClaudeAdapter implements Adapter {
   }
 }
 
-function estimateCostUsd(
+/**
+ * Anthropic cache read discount: cache_read_input_tokens are charged at
+ * roughly 10% of normal input rate. (See
+ * https://docs.anthropic.com/en/docs/build-with-claude/prompt-caching.)
+ */
+const CACHE_READ_DISCOUNT = 0.1;
+
+function estimateCostUsdWithCache(
   model: string,
-  tokensIn: number,
+  freshOrCreationIn: number,
+  cacheReadIn: number,
   tokensOut: number,
 ): number {
   const key = Object.keys(PRICING_USD_PER_1M).find((k) =>
@@ -129,5 +176,9 @@ function estimateCostUsd(
   if (!key) return 0;
   const rates = PRICING_USD_PER_1M[key];
   if (!rates) return 0;
-  return (tokensIn / 1_000_000) * rates.input + (tokensOut / 1_000_000) * rates.output;
+  return (
+    (freshOrCreationIn / 1_000_000) * rates.input +
+    (cacheReadIn / 1_000_000) * rates.input * CACHE_READ_DISCOUNT +
+    (tokensOut / 1_000_000) * rates.output
+  );
 }

package/src/adapters/gemini.ts

@@ -59,7 +59,7 @@ export class GeminiAdapter implements Adapter {
   readonly provider = "google";
 
   private readonly client: GoogleGenerativeAI | null;
-  private readonly defaultModel: string;
+  readonly defaultModel: string;
   private readonly defaultMaxOutputTokens: number;
   private readonly defaultTimeoutMs: number;
 

package/src/adapters/mock.ts

@@ -12,6 +12,7 @@ import type { Adapter, AdapterInput, AdapterOutput } from "./types.js";
 export class MockAdapter implements Adapter {
   readonly name = "mock";
   readonly provider = "mock";
+  readonly defaultModel = "mock-1";
 
   constructor(
     private readonly opts: {

package/src/adapters/openai.ts

@@ -43,7 +43,7 @@ export class OpenAIAdapter implements Adapter {
   readonly provider = "openai";
 
   private readonly client: OpenAI | null;
-  private readonly defaultModel: string;
+  readonly defaultModel: string;
   private readonly defaultMaxOutputTokens: number;
   private readonly defaultTimeoutMs: number;
 
@@ -118,13 +118,30 @@ export class OpenAIAdapter implements Adapter {
     }
 
     const content = choice.message.content;
-    const tokensIn = response.usage?.prompt_tokens ?? 0;
-    const tokensOut = response.usage?.completion_tokens ?? 0;
-    const costUsd = estimateCostUsd(model, tokensIn, tokensOut);
+    // OpenAI prompt caching is automatic for prompts > 1024 tokens; the
+    // cached span is the longest common prefix across recent calls with
+    // the same model. The fraction cached comes back in
+    // prompt_tokens_details.cached_tokens. Cache reads are billed at ~50%
+    // of normal input rate.
+    const usage = response.usage as
+      | (typeof response.usage & {
+          prompt_tokens_details?: { cached_tokens?: number };
+        })
+      | undefined;
+    const tokensIn = usage?.prompt_tokens ?? 0;
+    const cacheReadIn = usage?.prompt_tokens_details?.cached_tokens ?? 0;
+    const tokensOut = usage?.completion_tokens ?? 0;
+    const costUsd = estimateCostUsdWithCache(
+      model,
+      tokensIn - cacheReadIn,
+      cacheReadIn,
+      tokensOut,
+    );
 
     return {
       content,
       tokensIn,
+      cachedTokensIn: cacheReadIn,
       tokensOut,
       costUsd,
       latencyMs: Date.now() - start,
@@ -134,9 +151,16 @@ export class OpenAIAdapter implements Adapter {
   }
 }
 
-function estimateCostUsd(
+/**
+ * OpenAI cache-read discount: cached input tokens are billed at 50% of
+ * normal input rate. (See https://platform.openai.com/docs/guides/prompt-caching.)
+ */
+const CACHE_READ_DISCOUNT = 0.5;
+
+function estimateCostUsdWithCache(
   model: string,
-  tokensIn: number,
+  freshTokensIn: number,
+  cacheReadIn: number,
   tokensOut: number,
 ): number {
   // Match by prefix so versioned model names (gpt-4o-2024-08-06) still resolve.
@@ -146,5 +170,9 @@ function estimateCostUsd(
   if (!key) return 0;
   const rates = PRICING_USD_PER_1M[key];
   if (!rates) return 0;
-  return (tokensIn / 1_000_000) * rates.input + (tokensOut / 1_000_000) * rates.output;
+  return (
+    (freshTokensIn / 1_000_000) * rates.input +
+    (cacheReadIn / 1_000_000) * rates.input * CACHE_READ_DISCOUNT +
+    (tokensOut / 1_000_000) * rates.output
+  );
 }

package/src/adapters/types.ts

@@ -32,11 +32,21 @@ export interface AdapterInput {
 export interface AdapterOutput {
   /** The model's text response. */
   content: string;
-  /** Input token count (prompt). */
+  /** Input token count (prompt). Total — includes any cached portion. */
   tokensIn: number;
+  /**
+   * Subset of `tokensIn` that was served from the provider's prompt cache
+   * (cheaper). Anthropic returns `cache_read_input_tokens`. OpenAI returns
+   * `prompt_tokens_details.cached_tokens`. Adapters that don't support
+   * caching yet (or for which caching didn't trigger this run) leave this
+   * at 0 — meaning every input token was a fresh hit at full price.
+   */
+  cachedTokensIn?: number;
   /** Output token count (completion). */
   tokensOut: number;
-  /** Estimated USD cost based on the model's published rates. */
+  /** Estimated USD cost based on the model's published rates, with cache
+   * discount applied to `cachedTokensIn` per provider's published rate
+   * (Anthropic: 90% off on cache reads; OpenAI: 50% off; Gemini: varies). */
   costUsd: number;
   /** Wall-clock latency in milliseconds. */
   latencyMs: number;
@@ -51,6 +61,14 @@ export interface Adapter {
   readonly name: string;
   /** Underlying provider family (e.g. "openai", "anthropic", "mock"). */
   readonly provider: string;
+  /**
+   * The model this adapter will call by default, exposed so the
+   * orchestrator can pass it to `BudgetTracker.preflightCheck` instead of
+   * the previous hardcoded "gpt-4o". (Codex review v0.5 P2 #5.) Adapters
+   * with no meaningful default — like Mock — return an opaque string and
+   * the budget tracker falls back to its conservative pricing.
+   */
+  readonly defaultModel: string;
   /** True if credentials are available and the adapter can be invoked. */
   isAvailable(): Promise<boolean>;
   /** Execute one model call. */

package/src/git/status.ts

@@ -40,7 +40,7 @@ export async function checkGitStatus(
   const normalized = relativePath.replace(/\\/g, "/");
 
   try {
-    const { stdout } = await execa(
+    const { stdout, stderr, exitCode } = await execa(
       "git",
       ["status", "--short", "--", normalized],
       {
@@ -50,20 +50,36 @@ export async function checkGitStatus(
       },
     );
 
+    // Codex review v0.5 P2 #4: previously we ignored exitCode and treated
+    // every empty-stdout result as "clean", which silently includes the
+    // case where we're not in a git repo at all. Now we look at exitCode
+    // and stderr to distinguish "no changes" (exit 0, stdout empty) from
+    // "not a git repo" (exit 128, stderr matches).
+    if (exitCode !== 0) {
+      const stderrText = (stderr ?? "").toString();
+      if (
+        stderrText.includes("not a git repository") ||
+        stderrText.includes("fatal: not a git repository")
+      ) {
+        return { dirty: false, notInGitRepo: true };
+      }
+      // Some other git failure (corrupt index, etc.) — treat conservatively
+      // as no-protection so the caller can decide. Most callers should
+      // refuse writes in this case.
+      return { dirty: false, notInGitRepo: true };
+    }
+
     if (stdout.trim().length === 0) {
       return { dirty: false };
     }
 
     return { dirty: true, porcelain: stdout };
   } catch (err) {
-    // execa throws if git is missing. Surface as not-in-repo so callers can
-    // proceed cautiously rather than crash.
+    // execa throws if git is missing entirely. Surface as not-in-repo.
     const msg = err instanceof Error ? err.message : String(err);
     if (msg.includes("ENOENT")) {
       return { dirty: false, notInGitRepo: true };
     }
-    // "not a git repository" returns non-zero but we used reject:false above,
-    // so this branch is rare. Still, treat unknown errors as no-protection.
     return { dirty: false, notInGitRepo: true };
   }
 }

package/src/index.ts

@@ -13,7 +13,7 @@
  *   - budget/     ✅ task #14 BudgetTracker + BudgetExceededError
  */
 
-export const VERSION = "0.3.0";
+export const VERSION = "0.5.1";
 
 // Git safety primitives
 export {
@@ -113,6 +113,8 @@ export { collectGitDiff, type DiffOptions, type DiffResult } from "./review/diff
 export {
   writeHumanReviewFile,
   ReviewFileExistsError,
+  reviewFilePathFor,
+  preflightReviewFileCollision,
   type WriteReviewFileOptions,
 } from "./review/write.js";
 export {

package/src/review/diff-filter.ts

@@ -0,0 +1,190 @@
+/**
+ * Filter a unified git diff so files matching `.gitignore`,
+ * `.almightyignore`, or `config.context.exclude` never reach a provider.
+ *
+ * This is a stronger promise than redaction. Redaction is defense-in-depth
+ * on file *contents*; filtering removes whole files from the payload before
+ * the provider ever sees them.
+ *
+ * Codex review v0.5 flagged that the public docs and templates already
+ * promise this behavior — this module makes the implementation match.
+ */
+
+import { readFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+// `ignore` is a CJS package; under NodeNext module resolution TypeScript
+// won't synth a default export even with esModuleInterop. The package
+// exports `function ignore(...)` as the module itself, plus
+// `module.exports.default = ignore`. Use a runtime require to access the
+// callable form without fighting the type system.
+import { createRequire } from "node:module";
+import type { Ignore } from "ignore";
+const require = createRequire(import.meta.url);
+// eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-explicit-any
+const ignore = require("ignore") as (options?: Record<string, unknown>) => Ignore;
+
+export interface DiffFilterOptions {
+  /** Repo root containing .gitignore and .almightyignore. */
+  repoRoot: string;
+  /** Raw unified diff text from `git diff`. */
+  diffText: string;
+  /** List of files touched by the diff (typically from collectGitDiff). */
+  files: string[];
+  /**
+   * Additional exclude globs from `config.context.exclude`. Gitignore
+   * syntax — see `ignore` package docs. Optional.
+   */
+  configExclude?: string[];
+}
+
+export interface DiffFilterResult {
+  /** Diff text with ignored files' sections removed. */
+  filteredDiff: string;
+  /** Files that survived filtering. */
+  filesIncluded: string[];
+  /** Files that were dropped, with a human-readable reason per file. */
+  filesSkipped: { path: string; reason: string }[];
+}
+
+/**
+ * Build an Ignore matcher loaded from `.gitignore`, `.almightyignore`, and
+ * any config-level exclude globs. Missing files are silently skipped.
+ *
+ * Important nuance: `.gitignore` rules normally only apply to UNTRACKED
+ * files (tracked files in a diff exist because git is tracking them). For
+ * AlmightyGPT's purposes we want the conservative behavior — "if it
+ * matches gitignore, don't send it" — because secret-bearing tracked
+ * files (someone committed `.env` once) are exactly the case we're
+ * protecting against. So we apply both sets equally.
+ */
+async function buildIgnoreMatcher(
+  repoRoot: string,
+  configExclude: string[],
+): Promise<{
+  matcher: Ignore;
+  sources: { name: string; loaded: boolean; rules: number }[];
+}> {
+  const ig = ignore();
+  const sources: { name: string; loaded: boolean; rules: number }[] = [];
+
+  for (const file of [".gitignore", ".almightyignore"]) {
+    const path = join(repoRoot, file);
+    if (existsSync(path)) {
+      const text = await readFile(path, "utf8");
+      const lines = text.split("\n").filter((l) => l.trim() && !l.trim().startsWith("#"));
+      ig.add(text);
+      sources.push({ name: file, loaded: true, rules: lines.length });
+    } else {
+      sources.push({ name: file, loaded: false, rules: 0 });
+    }
+  }
+
+  if (configExclude.length > 0) {
+    ig.add(configExclude.join("\n"));
+    sources.push({
+      name: "config.context.exclude",
+      loaded: true,
+      rules: configExclude.length,
+    });
+  }
+
+  return { matcher: ig, sources };
+}
+
+/**
+ * Parse a unified git diff into per-file sections. Each section starts
+ * with `diff --git a/<path> b/<path>` and runs until the next such header
+ * (or end of input).
+ *
+ * Returns an array of `{ path, section }` so each file's diff hunks can
+ * be filtered independently and then reassembled.
+ */
+function splitDiffByFile(
+  diffText: string,
+): { path: string; section: string }[] {
+  if (!diffText.trim()) return [];
+
+  const out: { path: string; section: string }[] = [];
+  const lines = diffText.split("\n");
+  let current: { path: string; lines: string[] } | null = null;
+
+  const headerRe = /^diff --git a\/(.+?) b\/(.+?)$/;
+
+  for (const line of lines) {
+    const match = line.match(headerRe);
+    if (match) {
+      if (current) {
+        out.push({ path: current.path, section: current.lines.join("\n") });
+      }
+      // Prefer the "b/" path (post-image) since renames change it.
+      // For most diffs both paths match.
+      current = { path: match[2]!, lines: [line] };
+    } else if (current) {
+      current.lines.push(line);
+    }
+    // Lines before any header (rare; usually empty diff) are dropped.
+  }
+  if (current) {
+    out.push({ path: current.path, section: current.lines.join("\n") });
+  }
+  return out;
+}
+
+export async function filterDiffByIgnoreLists(
+  opts: DiffFilterOptions,
+): Promise<DiffFilterResult> {
+  const configExclude = opts.configExclude ?? [];
+  const { matcher } = await buildIgnoreMatcher(opts.repoRoot, configExclude);
+
+  // Parse the diff into per-file sections. If the diff is empty or has no
+  // file headers, nothing to filter — return as-is.
+  const sections = splitDiffByFile(opts.diffText);
+
+  if (sections.length === 0) {
+    return {
+      filteredDiff: opts.diffText,
+      filesIncluded: opts.files,
+      filesSkipped: [],
+    };
+  }
+
+  const includedSections: string[] = [];
+  const filesIncluded: string[] = [];
+  const filesSkipped: { path: string; reason: string }[] = [];
+
+  for (const { path, section } of sections) {
+    if (matcher.ignores(path)) {
+      filesSkipped.push({
+        path,
+        reason: "ignored by .almightyignore / .gitignore / config.context.exclude",
+      });
+      continue;
+    }
+    includedSections.push(section);
+    filesIncluded.push(path);
+  }
+
+  // Also reconcile the original `files` list: any path from collectGitDiff
+  // that isn't in the surviving sections is also skipped. Usually they
+  // match (collectGitDiff and splitDiffByFile use the same source) but
+  // they can diverge if collectGitDiff includes paths that have no diff
+  // hunks (e.g. permission-only changes).
+  const includedSet = new Set(filesIncluded);
+  for (const original of opts.files) {
+    if (!includedSet.has(original) && matcher.ignores(original)) {
+      if (!filesSkipped.some((s) => s.path === original)) {
+        filesSkipped.push({
+          path: original,
+          reason: "ignored by .almightyignore / .gitignore / config.context.exclude",
+        });
+      }
+    }
+  }
+
+  return {
+    filteredDiff: includedSections.join("\n"),
+    filesIncluded,
+    filesSkipped,
+  };
+}

package/src/review/events.ts

@@ -45,6 +45,8 @@ export interface AgentCompletedEvent {
   model: string;
   outputPath: string;
   tokensIn: number;
+  /** Cache-hit portion of tokensIn (Anthropic cache_read / OpenAI cached). */
+  cachedTokensIn?: number;
   tokensOut: number;
   costUsd: number;
   latencyMs: number;