greenbump 0.5.0 → 0.7.0

package/dist/engine/run.test.js

@@ -0,0 +1,47 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { computeNeedsReview } from "./run.js";
+test("computeNeedsReview: unverifiable always needs review, regardless of anything else", () => {
+    assert.equal(computeNeedsReview({ unverifiable: true, neededFix: false, fixed: true, testFilesTouched: [] }), true);
+});
+test("computeNeedsReview: clean upgrade (no fix needed) never needs review", () => {
+    assert.equal(computeNeedsReview({ unverifiable: false, neededFix: false, fixed: true, testFilesTouched: [] }), false);
+});
+test("computeNeedsReview: fixed with a test file touched needs review", () => {
+    assert.equal(computeNeedsReview({
+        unverifiable: false,
+        neededFix: true,
+        fixed: true,
+        testFilesTouched: ["src/foo.test.ts"],
+    }), true);
+});
+test("computeNeedsReview: fixed with no test file touched does not need review", () => {
+    assert.equal(computeNeedsReview({ unverifiable: false, neededFix: true, fixed: true, testFilesTouched: [] }), false);
+});
+test("computeNeedsReview: fix loop failed (unfixed) never needs review — that's exit code 2's job, not 3's", () => {
+    assert.equal(computeNeedsReview({
+        unverifiable: false,
+        neededFix: true,
+        fixed: false,
+        testFilesTouched: ["src/foo.test.ts"],
+    }), false);
+});
+test("computeNeedsReview: budgetExceeded always needs review, even on a clean/no-fix-needed run", () => {
+    assert.equal(computeNeedsReview({
+        unverifiable: false,
+        neededFix: false,
+        fixed: true,
+        testFilesTouched: [],
+        budgetExceeded: true,
+    }), true);
+});
+test("computeNeedsReview: budgetExceeded still needs review even when fixed with no test file touched", () => {
+    assert.equal(computeNeedsReview({
+        unverifiable: false,
+        neededFix: true,
+        fixed: true,
+        testFilesTouched: [],
+        budgetExceeded: true,
+    }), true);
+});
+//# sourceMappingURL=run.test.js.map

package/dist/engine/run.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.test.js","sourceRoot":"","sources":["../../src/engine/run.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C,IAAI,CAAC,mFAAmF,EAAE,GAAG,EAAE;IAC7F,MAAM,CAAC,KAAK,CACV,kBAAkB,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC,EAC/F,IAAI,CACL,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,sEAAsE,EAAE,GAAG,EAAE;IAChF,MAAM,CAAC,KAAK,CACV,kBAAkB,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC,EAChG,KAAK,CACN,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,iEAAiE,EAAE,GAAG,EAAE;IAC3E,MAAM,CAAC,KAAK,CACV,kBAAkB,CAAC;QACjB,YAAY,EAAE,KAAK;QACnB,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,IAAI;QACX,gBAAgB,EAAE,CAAC,iBAAiB,CAAC;KACtC,CAAC,EACF,IAAI,CACL,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0EAA0E,EAAE,GAAG,EAAE;IACpF,MAAM,CAAC,KAAK,CACV,kBAAkB,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC,EAC/F,KAAK,CACN,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,sGAAsG,EAAE,GAAG,EAAE;IAChH,MAAM,CAAC,KAAK,CACV,kBAAkB,CAAC;QACjB,YAAY,EAAE,KAAK;QACnB,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,KAAK;QACZ,gBAAgB,EAAE,CAAC,iBAAiB,CAAC;KACtC,CAAC,EACF,KAAK,CACN,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,2FAA2F,EAAE,GAAG,EAAE;IACrG,MAAM,CAAC,KAAK,CACV,kBAAkB,CAAC;QACjB,YAAY,EAAE,KAAK;QACnB,SAAS,EAAE,KAAK;QAChB,KAAK,EAAE,IAAI;QACX,gBAAgB,EAAE,EAAE;QACpB,cAAc,EAAE,IAAI;KACrB,CAAC,EACF,IAAI,CACL,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,iGAAiG,EAAE,GAAG,EAAE;IAC3G,MAAM,CAAC,KAAK,CACV,kBAAkB,CAAC;QACjB,YAAY,EAAE,KAAK;QACnB,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,IAAI;QACX,gBAAgB,EAAE,EAAE;QACpB,cAAc,EAAE,IAAI;KACrB,CAAC,EACF,IAAI,CACL,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/engine/stats/recorder.js

@@ -0,0 +1,48 @@
+import { mkdir, appendFile, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { homedir } from "node:os";
+function statsDir() {
+    return process.env.GREENBUMP_STATS_DIR ?? join(homedir(), ".greenbump");
+}
+function runsPath() {
+    return join(statsDir(), "runs.jsonl");
+}
+/**
+ * Append one run record. Best-effort: a write failure (disk full,
+ * permissions) is logged once and swallowed — stats must never fail a run.
+ */
+export async function recordRun(rec, onLog) {
+    try {
+        await mkdir(statsDir(), { recursive: true });
+        await appendFile(runsPath(), JSON.stringify(rec) + "\n", "utf8");
+    }
+    catch (err) {
+        onLog?.(`stats: failed to record run (${err.message})`);
+    }
+}
+/** Read all recorded runs, skipping any corrupt/partial lines. */
+export async function loadRuns() {
+    let raw;
+    try {
+        raw = await readFile(runsPath(), "utf8");
+    }
+    catch {
+        return [];
+    }
+    const runs = [];
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            runs.push(JSON.parse(trimmed));
+        }
+        catch {
+            // corrupt line (e.g. truncated by a crash mid-write) — skip it
+        }
+    }
+    return runs;
+}
+/** Test helper: nothing to reset (statsDir() re-reads the env every call), kept for symmetry with the cache module. */
+export function resetStatsForTests() { }
+//# sourceMappingURL=recorder.js.map

package/dist/engine/stats/recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.js","sourceRoot":"","sources":["../../../src/engine/stats/recorder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AA6BlC,SAAS,QAAQ;IACf,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,QAAQ;IACf,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,YAAY,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAc,EAAE,KAA2B;IACzE,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,MAAM,UAAU,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,KAAK,EAAE,CAAC,gCAAiC,GAAa,CAAC,OAAO,GAAG,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,IAAI,GAAgB,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,+DAA+D;QACjE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uHAAuH;AACvH,MAAM,UAAU,kBAAkB,KAAU,CAAC"}

package/dist/engine/stats/recorder.test.js

@@ -0,0 +1,71 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { recordRun, loadRuns } from "./recorder.js";
+async function withStatsDir(fn) {
+    const dir = await mkdtemp(join(tmpdir(), "greenbump-stats-test-"));
+    const prev = process.env.GREENBUMP_STATS_DIR;
+    process.env.GREENBUMP_STATS_DIR = dir;
+    try {
+        await fn();
+    }
+    finally {
+        if (prev === undefined)
+            delete process.env.GREENBUMP_STATS_DIR;
+        else
+            process.env.GREENBUMP_STATS_DIR = prev;
+        await rm(dir, { recursive: true, force: true });
+    }
+}
+const sampleRecord = {
+    ts: Date.now(),
+    dep: "react-dom",
+    from: "18.3.1",
+    to: "19.2.0",
+    tier: 1,
+    inputTokens: 0,
+    outputTokens: 0,
+    avoidedLlmCall: true,
+    durationMs: 5000,
+    fixed: true,
+    needsReview: false,
+};
+test("recordRun + loadRuns: round-trips a record", async () => {
+    await withStatsDir(async () => {
+        assert.deepEqual(await loadRuns(), []);
+        await recordRun(sampleRecord);
+        const runs = await loadRuns();
+        assert.equal(runs.length, 1);
+        assert.deepEqual(runs[0], sampleRecord);
+    });
+});
+test("recordRun: appends rather than overwrites", async () => {
+    await withStatsDir(async () => {
+        await recordRun(sampleRecord);
+        await recordRun({ ...sampleRecord, dep: "vue" });
+        const runs = await loadRuns();
+        assert.equal(runs.length, 2);
+        assert.equal(runs[0].dep, "react-dom");
+        assert.equal(runs[1].dep, "vue");
+    });
+});
+test("loadRuns: skips corrupt lines instead of throwing", async () => {
+    await withStatsDir(async () => {
+        await recordRun(sampleRecord);
+        const { appendFile } = await import("node:fs/promises");
+        const dir = process.env.GREENBUMP_STATS_DIR;
+        await appendFile(join(dir, "runs.jsonl"), "{not valid json\n", "utf8");
+        await recordRun({ ...sampleRecord, dep: "axios" });
+        const runs = await loadRuns();
+        assert.equal(runs.length, 2);
+        assert.deepEqual(runs.map((r) => r.dep), ["react-dom", "axios"]);
+    });
+});
+test("loadRuns: missing file returns empty array, not an error", async () => {
+    await withStatsDir(async () => {
+        assert.deepEqual(await loadRuns(), []);
+    });
+});
+//# sourceMappingURL=recorder.test.js.map

package/dist/engine/stats/recorder.test.js.map

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

package/dist/engine/stats/report.js

@@ -0,0 +1,157 @@
+import pc from "picocolors";
+import { loadRuns } from "./recorder.js";
+/**
+ * Rough $/M-token pricing for common models, used only to turn "tokens
+ * avoided" into a ballpark dollar figure for `greenbump --stats`. Prices
+ * change and vary by provider tier — this is explicitly an estimate, never
+ * shown without that label.
+ */
+const PRICING = {
+    "claude-opus": { inputPerM: 15, outputPerM: 75 },
+    "claude-sonnet": { inputPerM: 3, outputPerM: 15 },
+    "claude-haiku": { inputPerM: 0.8, outputPerM: 4 },
+    "gpt-4o-mini": { inputPerM: 0.15, outputPerM: 0.6 },
+    "gpt-4o": { inputPerM: 2.5, outputPerM: 10 },
+    deepseek: { inputPerM: 0.27, outputPerM: 1.1 },
+};
+/** Median across the built-in pricing table — the fallback estimate when we don't know (or have never spent on) a specific model. */
+function medianPricing() {
+    const entries = Object.values(PRICING);
+    const mid = (nums) => {
+        const sorted = [...nums].sort((a, b) => a - b);
+        const m = Math.floor(sorted.length / 2);
+        return sorted.length % 2 ? sorted[m] : (sorted[m - 1] + sorted[m]) / 2;
+    };
+    return {
+        inputPerM: mid(entries.map((e) => e.inputPerM)),
+        outputPerM: mid(entries.map((e) => e.outputPerM)),
+    };
+}
+function pricingFor(model) {
+    if (!model)
+        return medianPricing();
+    const key = Object.keys(PRICING).find((k) => model.toLowerCase().includes(k));
+    return key ? PRICING[key] : medianPricing();
+}
+function estimateCostUsd(inputTokens, outputTokens, model) {
+    const p = pricingFor(model);
+    return (inputTokens / 1_000_000) * p.inputPerM + (outputTokens / 1_000_000) * p.outputPerM;
+}
+const EMPTY_SUMMARY = {
+    windowDays: 0,
+    totalRuns: 0,
+    fixedRuns: 0,
+    fixRate: 0,
+    tierBreakdown: { 1: 0, 2: 0, 3: 0, 4: 0 },
+    llmCallsAvoided: 0,
+    cacheHits: 0,
+    actualTokens: { input: 0, output: 0 },
+    actualCostUsd: 0,
+    avoidedTokensEstimate: { input: 0, output: 0 },
+    estimatedSavedUsd: 0,
+};
+/** Aggregate recorded runs from the last `days` days into a stats summary. */
+export function summarize(runs, days = 30) {
+    const cutoff = Date.now() - days * 24 * 60 * 60 * 1000;
+    const inWindow = runs.filter((r) => r.ts >= cutoff);
+    if (inWindow.length === 0)
+        return { ...EMPTY_SUMMARY, windowDays: days };
+    const tierBreakdown = { 1: 0, 2: 0, 3: 0, 4: 0 };
+    let fixedRuns = 0;
+    let llmCallsAvoided = 0;
+    let cacheHits = 0;
+    let actualInput = 0;
+    let actualOutput = 0;
+    let actualCostUsd = 0;
+    const tier4RunsForAverage = [];
+    for (const r of inWindow) {
+        if (r.fixed)
+            fixedRuns++;
+        if (r.tier)
+            tierBreakdown[r.tier]++;
+        if (r.cacheHit)
+            cacheHits++;
+        if (r.avoidedLlmCall) {
+            llmCallsAvoided++;
+        }
+        else if (r.tier === 4) {
+            actualInput += r.inputTokens;
+            actualOutput += r.outputTokens;
+            actualCostUsd += estimateCostUsd(r.inputTokens, r.outputTokens, r.model);
+            tier4RunsForAverage.push(r);
+        }
+    }
+    // Estimate what the avoided runs *would* have cost, using this window's
+    // own average tier-4 spend when available (most accurate), or a
+    // conservative default typical-fix estimate otherwise.
+    const avgInput = tier4RunsForAverage.length > 0
+        ? actualInput / tier4RunsForAverage.length
+        : 20_000;
+    const avgOutput = tier4RunsForAverage.length > 0
+        ? actualOutput / tier4RunsForAverage.length
+        : 5_000;
+    const avgModel = tier4RunsForAverage[0]?.model;
+    const avoidedTokensEstimate = {
+        input: Math.round(avgInput * llmCallsAvoided),
+        output: Math.round(avgOutput * llmCallsAvoided),
+    };
+    const estimatedSavedUsd = estimateCostUsd(avoidedTokensEstimate.input, avoidedTokensEstimate.output, avgModel);
+    return {
+        windowDays: days,
+        totalRuns: inWindow.length,
+        fixedRuns,
+        fixRate: fixedRuns / inWindow.length,
+        tierBreakdown,
+        llmCallsAvoided,
+        cacheHits,
+        actualTokens: { input: actualInput, output: actualOutput },
+        actualCostUsd,
+        avoidedTokensEstimate,
+        estimatedSavedUsd,
+    };
+}
+export async function loadAndSummarize(days = 30) {
+    return summarize(await loadRuns(), days);
+}
+const TIER_NAMES = {
+    1: "codemod",
+    2: "learned pattern",
+    3: "cached fix",
+    4: "LLM",
+};
+/** Render the stats summary for terminal output (used by `greenbump --stats`). */
+export function formatStatsReport(s) {
+    const lines = [];
+    if (s.totalRuns === 0) {
+        lines.push(pc.dim(`No runs recorded in the last ${s.windowDays} days.`));
+        return lines.join("\n");
+    }
+    lines.push(pc.bold(`greenbump usage — last ${s.windowDays} days`));
+    lines.push("");
+    lines.push(`${pc.dim("runs")}              ${s.totalRuns}`);
+    lines.push(`${pc.dim("fixed")}            ${s.fixedRuns}/${s.totalRuns} (${(s.fixRate * 100).toFixed(0)}%)`);
+    lines.push("");
+    lines.push(pc.bold("fix tiers:"));
+    for (const tier of [1, 2, 3, 4]) {
+        const count = s.tierBreakdown[tier];
+        if (count === 0)
+            continue;
+        const label = tier < 4 ? pc.green(TIER_NAMES[tier]) : TIER_NAMES[tier];
+        lines.push(`  ${label.padEnd(24)} ${count}`);
+    }
+    lines.push("");
+    lines.push(`${pc.dim("LLM calls avoided")}  ${pc.green(String(s.llmCallsAvoided))} (tiers 1-3 — $0 spent)`);
+    if (s.cacheHits > 0) {
+        lines.push(`${pc.dim("cache hits")}         ${s.cacheHits}`);
+    }
+    lines.push("");
+    lines.push(pc.bold("tokens & cost:"));
+    lines.push(`  ${pc.dim("actually spent")}     ${s.actualTokens.input.toLocaleString()} in / ${s.actualTokens.output.toLocaleString()} out (~$${s.actualCostUsd.toFixed(2)})`);
+    if (s.llmCallsAvoided > 0) {
+        lines.push(`  ${pc.dim("avoided (estimate)")} ${s.avoidedTokensEstimate.input.toLocaleString()} in / ${s.avoidedTokensEstimate.output.toLocaleString()} out (~$${s.estimatedSavedUsd.toFixed(2)})`);
+        lines.push("");
+        lines.push(pc.green(`  ~$${s.estimatedSavedUsd.toFixed(2)} saved by free fix tiers (estimate, not a bill)`));
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=report.js.map

package/dist/engine/stats/report.js.map

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

package/dist/engine/stats/report.test.js

@@ -0,0 +1,83 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { summarize, formatStatsReport } from "./report.js";
+const now = Date.now();
+const daysAgo = (n) => now - n * 24 * 60 * 60 * 1000;
+function rec(overrides) {
+    return {
+        ts: now,
+        dep: "react-dom",
+        from: "18.3.1",
+        to: "19.2.0",
+        inputTokens: 0,
+        outputTokens: 0,
+        avoidedLlmCall: false,
+        durationMs: 1000,
+        fixed: true,
+        needsReview: false,
+        ...overrides,
+    };
+}
+test("summarize: empty input returns a zeroed summary, not a crash", () => {
+    const s = summarize([], 30);
+    assert.equal(s.totalRuns, 0);
+    assert.equal(s.fixRate, 0);
+    assert.equal(s.estimatedSavedUsd, 0);
+});
+test("summarize: counts tiers and fix rate correctly", () => {
+    const runs = [
+        rec({ tier: 1, avoidedLlmCall: true }),
+        rec({ tier: 1, avoidedLlmCall: true }),
+        rec({ tier: 4, inputTokens: 20000, outputTokens: 5000, model: "claude-sonnet" }),
+        rec({ fixed: false, tier: 4, inputTokens: 20000, outputTokens: 5000, model: "claude-sonnet" }),
+    ];
+    const s = summarize(runs, 30);
+    assert.equal(s.totalRuns, 4);
+    assert.equal(s.fixedRuns, 3);
+    assert.equal(s.fixRate, 0.75);
+    assert.equal(s.tierBreakdown[1], 2);
+    assert.equal(s.tierBreakdown[4], 2);
+    assert.equal(s.llmCallsAvoided, 2);
+});
+test("summarize: excludes runs outside the requested window", () => {
+    const runs = [rec({ ts: daysAgo(1) }), rec({ ts: daysAgo(45) })];
+    const s = summarize(runs, 30);
+    assert.equal(s.totalRuns, 1);
+});
+test("summarize: estimates saved cost using this window's own tier-4 average when available", () => {
+    const runs = [
+        rec({ tier: 4, inputTokens: 10000, outputTokens: 2000, model: "claude-sonnet" }),
+        rec({ tier: 1, avoidedLlmCall: true }),
+    ];
+    const s = summarize(runs, 30);
+    assert.equal(s.avoidedTokensEstimate.input, 10000);
+    assert.equal(s.avoidedTokensEstimate.output, 2000);
+    assert.ok(s.estimatedSavedUsd > 0);
+});
+test("summarize: falls back to a conservative default estimate with no tier-4 history", () => {
+    const runs = [rec({ tier: 1, avoidedLlmCall: true })];
+    const s = summarize(runs, 30);
+    assert.equal(s.avoidedTokensEstimate.input, 20000);
+    assert.ok(s.estimatedSavedUsd > 0);
+});
+test("summarize: cache hits are counted independently of tier", () => {
+    const runs = [rec({ tier: 3, avoidedLlmCall: true, cacheHit: true })];
+    const s = summarize(runs, 30);
+    assert.equal(s.cacheHits, 1);
+});
+test("formatStatsReport: empty summary renders a friendly message, no crash", () => {
+    const s = summarize([], 30);
+    const out = formatStatsReport(s);
+    assert.match(out, /No runs recorded/);
+});
+test("formatStatsReport: non-empty summary mentions avoided calls and estimate label", () => {
+    const runs = [
+        rec({ tier: 1, avoidedLlmCall: true }),
+        rec({ tier: 4, inputTokens: 20000, outputTokens: 5000, model: "claude-sonnet" }),
+    ];
+    const s = summarize(runs, 30);
+    const out = formatStatsReport(s);
+    assert.match(out, /LLM calls avoided/);
+    assert.match(out, /estimate/);
+});
+//# sourceMappingURL=report.test.js.map

package/dist/engine/stats/report.test.js.map

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

package/dist/engine/verifiers/ast-analyzer.js

@@ -0,0 +1,212 @@
+import { readFile, readdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+import ts from "typescript";
+const ANALYZABLE_EXT = new Set([".ts", ".tsx", ".mts", ".cts"]);
+const MAX_FILE_SIZE = 500_000;
+/** Extract the exported symbol table from a TS/TSX file. */
+function extractExports(code, filename) {
+    const symbols = new Map();
+    let sourceFile;
+    try {
+        sourceFile = ts.createSourceFile(filename, code, ts.ScriptTarget.Latest, true);
+    }
+    catch {
+        return symbols;
+    }
+    const hasExportModifier = (node) => {
+        const mods = ts.canHaveModifiers(node) ? ts.getModifiers(node) : undefined;
+        return mods?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword) ?? false;
+    };
+    const isDefault = (node) => {
+        const mods = ts.canHaveModifiers(node) ? ts.getModifiers(node) : undefined;
+        return mods?.some((m) => m.kind === ts.SyntaxKind.DefaultKeyword) ?? false;
+    };
+    const visit = (node) => {
+        // export function foo(...) / export class Foo / export const foo
+        if ((ts.isFunctionDeclaration(node) ||
+            ts.isClassDeclaration(node) ||
+            ts.isInterfaceDeclaration(node) ||
+            ts.isTypeAliasDeclaration(node) ||
+            ts.isEnumDeclaration(node)) &&
+            hasExportModifier(node)) {
+            const name = isDefault(node) ? "default" : node.name?.getText(sourceFile);
+            if (name) {
+                symbols.set(name, {
+                    name,
+                    kind: ts.isFunctionDeclaration(node)
+                        ? "function"
+                        : ts.isClassDeclaration(node)
+                            ? "class"
+                            : ts.isInterfaceDeclaration(node)
+                                ? "interface"
+                                : ts.isTypeAliasDeclaration(node)
+                                    ? "type"
+                                    : "enum",
+                    signature: ts.isFunctionDeclaration(node) ? signatureOf(node, sourceFile) : undefined,
+                });
+            }
+        }
+        // export const foo = ...
+        if (ts.isVariableStatement(node) && hasExportModifier(node)) {
+            for (const decl of node.declarationList.declarations) {
+                const name = decl.name.getText(sourceFile);
+                symbols.set(name, {
+                    name,
+                    kind: "const",
+                    signature: decl.type?.getText(sourceFile),
+                });
+            }
+        }
+        // export { a, b } / export { a as b }
+        if (ts.isExportDeclaration(node) && node.exportClause && ts.isNamedExports(node.exportClause)) {
+            for (const el of node.exportClause.elements) {
+                const name = el.name.getText(sourceFile);
+                symbols.set(name, { name, kind: "unknown" });
+            }
+        }
+        // export default <expr>
+        if (ts.isExportAssignment(node) && !node.isExportEquals) {
+            symbols.set("default", { name: "default", kind: "unknown" });
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+    return symbols;
+}
+function signatureOf(fn, sf) {
+    const params = fn.parameters.map((p) => {
+        const type = p.type ? p.type.getText(sf) : "any";
+        return `${p.name.getText(sf)}: ${type}`;
+    });
+    const ret = fn.type ? fn.type.getText(sf) : "void";
+    return `(${params.join(", ")}) => ${ret}`;
+}
+/**
+ * Compare the exported API surface before vs after the fix.
+ * `changedFiles` are the files the fix agent touched (project-relative).
+ * For each, we compare git HEAD content (pre-upgrade... actually pre-fix)
+ * against current working-tree content.
+ */
+export async function analyzeApiChanges(cwd, changedFiles, readBefore) {
+    const changes = [];
+    for (const file of changedFiles) {
+        const ext = file.slice(file.lastIndexOf("."));
+        if (!ANALYZABLE_EXT.has(ext))
+            continue;
+        const abs = join(cwd, file);
+        let after;
+        try {
+            const s = await stat(abs);
+            if (s.size > MAX_FILE_SIZE)
+                continue;
+            after = await readFile(abs, "utf8");
+        }
+        catch {
+            continue; // file deleted or unreadable — covered by change-detector
+        }
+        const before = await readBefore(file);
+        if (before === null)
+            continue; // new file — nothing to compare
+        const beforeExports = extractExports(before, file);
+        const afterExports = extractExports(after, file);
+        // Removed exports
+        for (const [name, sym] of beforeExports) {
+            if (!afterExports.has(name)) {
+                changes.push({
+                    kind: sym.kind === "type" || sym.kind === "interface" ? "export-type-removed" : "export-removed",
+                    file,
+                    symbol: name,
+                    detail: `${sym.kind} \`${name}\` was exported before the fix but is no longer exported`,
+                    severity: name === "default" ? "critical" : "warning",
+                });
+                continue;
+            }
+            // Signature changes on functions
+            const afterSym = afterExports.get(name);
+            if (sym.kind === "function" &&
+                afterSym.kind === "function" &&
+                sym.signature &&
+                afterSym.signature &&
+                sym.signature !== afterSym.signature) {
+                changes.push({
+                    kind: "signature-changed",
+                    file,
+                    symbol: name,
+                    detail: `\`${name}\` signature changed: ${sym.signature} → ${afterSym.signature}`,
+                    severity: "warning",
+                });
+            }
+        }
+        // Newly-loosened types: any introduced where a concrete type existed
+        const loosened = detectTypeLoosening(before, after, file);
+        changes.push(...loosened);
+    }
+    const hasCritical = changes.some((c) => c.severity === "critical");
+    const criticalCount = changes.filter((c) => c.severity === "critical").length;
+    const warningCount = changes.filter((c) => c.severity === "warning").length;
+    const summary = changes.length === 0
+        ? "no API surface changes detected"
+        : `${criticalCount} critical, ${warningCount} warning(s) — exported API changed`;
+    return { changes, hasCritical, summary };
+}
+/** Detect `any` annotations introduced by the fix (silencing the compiler). */
+function detectTypeLoosening(before, after, file) {
+    const out = [];
+    const countAny = (code) => {
+        const m = code.match(/:\s*any\b|<any>|as any\b/g);
+        return m ? m.length : 0;
+    };
+    const beforeCount = countAny(before);
+    const afterCount = countAny(after);
+    if (afterCount > beforeCount) {
+        out.push({
+            kind: "type-loosened-to-any",
+            file,
+            symbol: "(multiple)",
+            detail: `fix introduced ${afterCount - beforeCount} new \`any\` annotation(s) — may be masking a real type error`,
+            severity: "warning",
+        });
+    }
+    return out;
+}
+/** Read a file's content from git HEAD (used as the "before" state). */
+export async function readFromGitHead(cwd, path) {
+    const { execFile } = await import("node:child_process");
+    return new Promise((resolve) => {
+        execFile("git", ["show", `HEAD:${path}`], { cwd, maxBuffer: 10 * 1024 * 1024 }, (err, stdout) => {
+            if (err)
+                resolve(null);
+            else
+                resolve(stdout);
+        });
+    });
+}
+/** List TS/TSX files in the project (for full-project scans, if needed). */
+export async function listAnalyzableFiles(cwd, root = ".") {
+    const IGNORE = new Set(["node_modules", ".git", "dist", "build", ".next", "coverage"]);
+    const out = [];
+    async function walk(dir) {
+        let entries;
+        try {
+            entries = await readdir(join(cwd, dir), { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (IGNORE.has(e.name))
+                continue;
+            const rel = dir === "." ? e.name : `${dir}/${e.name}`;
+            if (e.isDirectory())
+                await walk(rel);
+            else {
+                const ext = e.name.slice(e.name.lastIndexOf("."));
+                if (ANALYZABLE_EXT.has(ext))
+                    out.push(rel);
+            }
+        }
+    }
+    await walk(root);
+    return out;
+}
+//# sourceMappingURL=ast-analyzer.js.map