token-optimizer-opencode 1.0.6 → 1.0.13

package/dist/savings.js

@@ -1,31 +1,51 @@
 /**
- * Realized savings engine for OpenCode (the "$11/session -> $3/session" delta).
+ * Realized savings engine for OpenCode — the CURRENT-VOLUME COUNTERFACTUAL.
  *
- * Parity with the Claude Code / Codex / OpenClaw before/after methodology:
- * freeze an early-usage baseline, compare it to current usage, report the
- * per-session cost delta. OpenCode already persists every session to trends.db
- * (session_log), so this reads that durable store directly -- no extra
- * persistence, and the baseline is recomputed deterministically from the fixed
- * historical window (no freeze needed; the early window never changes once past).
+ * Parity with measure.py `_estimate_before_after_savings` and the OpenClaw port.
+ * Prices the FROZEN pre-TO typical session (the per-session mean of the early
+ * `before` window) two ways:
+ *   OLD WAY / session = baseline mix + the typical session's own cache pattern.
+ *                       Depends only on frozen inputs + prices -> a STABLE baseline
+ *                       that does NOT re-roll with this period's workload.
+ *   NOW / session     = the SAME frozen tokens, pool redistributed at the CURRENT
+ *                       cache-hit and priced at the CURRENT mix. Moves ONLY with
+ *                       efficiency (model routing + caching).
+ * Per-session transformation = old_cps − now_cps. Monthly = that x the session count,
+ * so volume re-enters ONLY as a multiplier — never as a confounder of the baseline.
  *
- * MULTI-MODEL CORRECTNESS: OpenCode runs many models with very different pricing.
- * Each session_log row already carries cost_usd computed at ITS OWN model when
- * recorded, so the per-session mean is exact regardless of model mix -- no
- * blended-average-vector approximation. The waterfall uses the era's effective
- * $/token (real cost / real tokens), which encodes the mix, and telescopes
- * exactly to the headline delta.
+ * OpenCode persists every session to trends.db (session_log) with a pre-computed
+ * cost_usd, but the counterfactual reprices the SAME volume at a DIFFERENT mix,
+ * which the stored cost cannot supply. So we add a minimal per-class rate card
+ * (pricing.ts) and price both arms from token volume directly.
  *
- * Distinct from forward-looking waste detection: this measures what you HAVE
- * saved, against an early baseline, using your actual recorded spend.
+ * Three non-overlapping pools sum to the headline:
+ *   1. Main routing + caching (billed session_log volume). NO winsorization /
+ *      outlier drop — heavy sessions are real volume that genuinely cost more
+ *      at the baseline mix; dropping them is a pure definitional undercount.
+ *   2. Subagent (sidechain) routing — Claude-only. OpenCode has no Claude-style
+ *      sidechains (no is_sidechain column, no subagent transcripts), so this
+ *      pool is 0. DOCUMENTED GAP.
+ *   3. Compression add-back — tokens TO removed from context (tool_archive,
+ *      structure_map, resume_lean, checkpoint_restore, delta_read). Real volume
+ *      the old way would have re-read. Directly-metered (savings_events),
+ *      repriced to the baseline input mix. Disjoint from the billed pool.
+ *   4. Verbosity-steer add-back — estimated output tokens never produced due
+ *      to lean-output conciseness nudges, repriced at the baseline output mix. The
+ *      main counterfactual holds output volume constant, so this is a separate
+ *      lever. Estimated tier (trigger observed, magnitude not metered).
+ *
+ * BASELINE = the frozen EARLY-window mix + pool cache-hit, used ONLY for
+ * efficiency anchors (never volume). NO 95% Opus floor: OpenCode is a
+ * non-Anthropic runtime, so the before-arm is priced at the user's OWN measured
+ * baseline mix — never fabricated Opus they never ran.
  */
 import { TrendsStore } from "./storage/trends.js";
+import { price, price_cw, inputRatePerMTok, normalizeModelName } from "./pricing.js";
 // Constants mirror the other platforms' baseline tunables.
 const BASELINE_ONBOARDING_DAYS = 1;
 const BASELINE_EARLY_WINDOW_DAYS = 30;
 const BASELINE_MIN_STABLE_SESSIONS = 30;
 const AFTER_MIN_SESSIONS = 10;
-const WINSOR_PCT = 0.99;
-const WINSOR_MIN_SAMPLE = 10;
 const DAY_MS = 86_400_000;
 function num(v) {
     const n = typeof v === "number" ? v : parseFloat(String(v));
@@ -35,62 +55,49 @@ function toRec(row) {
     const ts = num(row.created_at) > 0
         ? num(row.created_at) * 1000
         : Date.parse(String(row.date ?? "")) || 0;
+    // Clamp every class >= 0 (corrupt-row protection, like measure.py's
+    // _session_token_vector clamps). cache-write is a separate billed column in
+    // session_log, kept distinct from fresh input.
     return {
         ts,
-        model: String(row.model ?? "unknown"),
-        tokens: num(row.tokens_input) +
-            num(row.tokens_output) +
-            num(row.tokens_cache_read) +
-            num(row.tokens_cache_write),
+        model: normalizeModelName(String(row.model ?? "unknown")),
+        fi: Math.max(0, num(row.tokens_input)),
+        cr: Math.max(0, num(row.tokens_cache_read)),
+        cw: Math.max(0, num(row.tokens_cache_write)),
+        out: Math.max(0, num(row.tokens_output)),
         cost: num(row.cost_usd),
     };
 }
-function mixLabel(shares) {
-    const top = Object.entries(shares).sort((a, b) => b[1] - a[1])[0];
-    return top ? `${Math.round(top[1] * 100)}% ${top[0]}` : "n/a";
-}
-/** Winsorize the top 1% of sessions by cost (scale cost AND tokens together so
- *  the effective rate stays consistent), then aggregate. */
-function computeEra(recs) {
-    const n = recs.length;
-    if (n === 0)
-        return { n: 0, costPerSession: 0, meanTokens: 0, effRate: 0, shares: {} };
-    let cap = Infinity;
-    if (n >= WINSOR_MIN_SAMPLE) {
-        const costs = recs.map((r) => r.cost).sort((a, b) => a - b);
-        // floor (not round): round((n-1)*0.99) == n-1 for n<=51, making the cap the
-        // max element and winsorization a no-op for every minimum-sample window.
-        // Clamp to <= n-2 so the single largest session is always above the cap.
-        cap = costs[Math.min(n - 2, Math.floor((n - 1) * WINSOR_PCT))];
-    }
-    let costSum = 0;
-    let tokSum = 0;
+/** Token-weighted model mix over a set of sessions (normalized pricing keys). */
+function modelMix(recs) {
     const byModel = {};
-    let modelTotal = 0;
+    let total = 0;
     for (const r of recs) {
-        const scale = r.cost > cap && r.cost > 0 ? cap / r.cost : 1;
-        costSum += r.cost * scale;
-        tokSum += r.tokens * scale;
-        byModel[r.model] = (byModel[r.model] ?? 0) + r.tokens;
-        modelTotal += r.tokens;
-    }
-    const shares = {};
-    if (modelTotal > 0) {
-        for (const [m, t] of Object.entries(byModel))
-            shares[m] = t / modelTotal;
+        const t = r.fi + r.cr + r.cw + r.out;
+        byModel[r.model] = (byModel[r.model] ?? 0) + t;
+        total += t;
     }
-    return {
-        n,
-        costPerSession: costSum / n,
-        meanTokens: tokSum / n,
-        effRate: tokSum > 0 ? costSum / tokSum : 0,
-        shares,
-    };
+    if (total <= 0)
+        return {};
+    const mix = {};
+    for (const [m, t] of Object.entries(byModel))
+        mix[m] = t / total;
+    return mix;
+}
+function mixLabel(mix) {
+    const top = Object.entries(mix).sort((a, b) => b[1] - a[1])[0];
+    return top ? `${Math.round(top[1] * 100)}% ${top[0]}` : "n/a";
 }
 const NOT_READY = (status) => ({
     ready: false,
     status,
     monthlySavingsUsd: 0,
+    actualMonthlyUsd: 0,
+    counterfactualMonthlyUsd: 0,
+    transformationPct: 0,
+    compressionMeasuredUsd: 0,
+    verbosityMeasuredUsd: 0,
+    verbosityTransformationUsd: 0,
     savingsPerSession: 0,
     beforeCostPerSession: 0,
     afterCostPerSession: 0,
@@ -100,20 +107,32 @@ const NOT_READY = (status) => ({
     cumulativeSavedUsd: 0,
     installDate: null,
     breakdown: [],
+    baselineBuilding: null,
 });
 /**
- * Compute realized before/after savings from trends.db. `now` is injectable for
- * testing; `rowsOverride` lets tests bypass the DB entirely.
+ * Compute realized savings via the current-volume counterfactual.
+ *   `now`               injectable for testing.
+ *   `rowsOverride`      bypasses the DB (raw session_log rows) for tests.
+ *   `compressionOverride` injects the measured compression dollars when the DB
+ *                       is bypassed (rowsOverride present); default 0.
  */
-export function computeRealizedSavings(dataDir, days = 30, now = Date.now(), rowsOverride) {
+export function computeRealizedSavings(dataDir, days = 30, now = Date.now(), rowsOverride, compressionOverride) {
     let rows = rowsOverride ?? [];
+    let measuredCompression = compressionOverride ?? 0;
+    let measuredVerbosity = 0;
     if (!rowsOverride) {
         const store = new TrendsStore(dataDir);
         try {
             rows = store.getAllSessions();
+            // Compression add-back (pool #3) reads metered savings_events for the window.
+            measuredCompression = store.getCompressionSavings(days, now).totalCostSavedUsd;
+            // Verbosity-steer add-back (pool #4) reads estimated savings_events.
+            measuredVerbosity = store.getVerbositySavings(days, now);
         }
         catch {
             rows = [];
+            measuredCompression = 0;
+            measuredVerbosity = 0;
         }
         finally {
             store.close();
@@ -128,57 +147,248 @@ export function computeRealizedSavings(dataDir, days = 30, now = Date.now(), row
     const windowEnd = windowStart + BASELINE_EARLY_WINDOW_DAYS * DAY_MS;
     const before = history.filter((r) => r.ts >= windowStart && r.ts < windowEnd);
     if (before.length < BASELINE_MIN_STABLE_SESSIONS) {
+        const daysLeft = Math.max(0, Math.ceil((windowEnd - now) / DAY_MS));
         const r = NOT_READY(`building baseline (${before.length}/${BASELINE_MIN_STABLE_SESSIONS} early sessions)`);
         r.installDate = installDate;
+        r.baselineBuilding = {
+            sessionsInWindow: before.length,
+            sessionsNeeded: BASELINE_MIN_STABLE_SESSIONS,
+            earlyWindowDays: BASELINE_EARLY_WINDOW_DAYS,
+            daysLeft,
+            firstDate: installDate,
+        };
         return r;
     }
     if (now < windowEnd) {
         const daysLeft = Math.ceil((windowEnd - now) / DAY_MS);
         const r = NOT_READY(`building baseline (${daysLeft}d of early window left)`);
         r.installDate = installDate;
+        r.baselineBuilding = {
+            sessionsInWindow: before.length,
+            sessionsNeeded: BASELINE_MIN_STABLE_SESSIONS,
+            earlyWindowDays: BASELINE_EARLY_WINDOW_DAYS,
+            daysLeft,
+            firstDate: installDate,
+        };
         return r;
     }
-    // After = recent sessions in lookback, strictly after the baseline window.
+    // CURRENT window = recent sessions in lookback, strictly after the baseline
+    // window (cohort separation). This is the EXACT volume held constant on both arms.
     const afterStart = Math.max(windowEnd, now - days * DAY_MS);
     const after = history.filter((r) => r.ts >= afterStart);
-    const bs = computeEra(before);
+    // BASELINE efficiency anchors (mix + pool cache-hit), from the early window.
+    const beforeMix = modelMix(before);
     if (after.length < AFTER_MIN_SESSIONS) {
         const r = NOT_READY(`building comparison (${after.length}/${AFTER_MIN_SESSIONS} recent sessions)`);
         r.installDate = installDate;
-        r.beforeCostPerSession = bs.costPerSession;
-        r.beforeMixLabel = mixLabel(bs.shares);
+        r.beforeMixLabel = mixLabel(beforeMix);
+        // Baseline window is closed and frozen — daysLeft=0 here.
+        r.baselineBuilding = {
+            sessionsInWindow: before.length,
+            sessionsNeeded: BASELINE_MIN_STABLE_SESSIONS,
+            earlyWindowDays: BASELINE_EARLY_WINDOW_DAYS,
+            daysLeft: 0,
+            firstDate: installDate,
+        };
         return r;
     }
-    const as = computeEra(after);
-    const perSession = bs.costPerSession - as.costPerSession;
+    // Aggregate the CURRENT window billed token classes (SUM, not mean). NO
+    // winsorization / outlier drop: a heavy session's tokens are real volume that
+    // genuinely cost more at the baseline mix.
+    let F = 0, CR = 0, CW = 0;
+    for (const r of after) {
+        F += r.fi;
+        CR += r.cr;
+        CW += r.cw;
+    }
+    // Numeric safety: clamp the aggregated totals to finite, non-negative values
+    // (mirrors measure.py's _session_token_vector clamps). Per-row reads are already
+    // clamped in toRec, but a corrupt/overflowing row could still poison the SUM
+    // (e.g. a row injected via rowsOverride bypassing the DB type system). A single
+    // bad total must never NaN/negative the headline.
+    const clampTotal = (x) => (Number.isFinite(x) && x > 0 ? x : 0);
+    F = clampTotal(F);
+    CR = clampTotal(CR);
+    CW = clampTotal(CW);
+    const totalIn = F + CR + CW;
+    if (totalIn <= 0) {
+        const r = NOT_READY("no recent volume");
+        r.installDate = installDate;
+        r.beforeMixLabel = mixLabel(beforeMix);
+        r.baselineBuilding = {
+            sessionsInWindow: before.length,
+            sessionsNeeded: BASELINE_MIN_STABLE_SESSIONS,
+            earlyWindowDays: BASELINE_EARLY_WINDOW_DAYS,
+            daysLeft: 0,
+            firstDate: installDate,
+        };
+        return r;
+    }
+    const afterMix = modelMix(after);
+    // CURRENT pool cache-hit over FRESH+CACHE_READ (cache-write excluded) — the one
+    // efficiency signal the "now" arm needs from the current window.
+    const curPool = F + CR;
+    const curHit = curPool > 0 ? CR / curPool : 0;
+    // FROZEN typical session = the per-session MEAN of the early (`before`) window, a
+    // fixed install-anchored cohort -> a stable, factual baseline. Both arms price THIS
+    // session, so per-session figures move ONLY with efficiency, never with the current
+    // period's workload volume. Mirrors measure.py _estimate_before_after_savings.
+    const nBefore = Math.max(1, before.length);
+    const tFi = before.reduce((s, r) => s + r.fi, 0) / nBefore;
+    const tCr = before.reduce((s, r) => s + r.cr, 0) / nBefore;
+    const tCw = before.reduce((s, r) => s + r.cw, 0) / nBefore;
+    const tOut = before.reduce((s, r) => s + r.out, 0) / nBefore;
+    const tPool = tFi + tCr; // frozen fresh + cache_read pool
     const afterWindowDays = Math.max(1, (now - afterStart) / DAY_MS);
     const sessionsPerMonth = (after.length / afterWindowDays) * 30;
-    const monthly = perSession * sessionsPerMonth;
+    // MONTHLY SCALING: the token classes above are summed over the `days` window,
+    // so every dollar figure derived from them is a WINDOW total, not a monthly one.
+    // `days` is user-controllable (dashboard.ts clamps to [1,365]); at days=7 the raw
+    // window sum is ~1/4 of the true monthly figure and at days=90 ~3x. Scale every
+    // dollar OUTPUT by 30/days so the headline is monthly regardless of `days`,
+    // mirroring openclaw/src/savings.ts (`monthlyScale = 30/max(1,days)`) and
+    // measure.py's monthly conversion. `sessionsPerMonth` already annualizes; the
+    // dollar aggregates did NOT — this closes that gap. At days=30, scale == 1, so
+    // the locked days=30 worked example is byte-identical (no regression).
+    const monthlyScale = 30 / Math.max(1, days);
+    const m = (x) => x * monthlyScale;
+    // OLD WAY / session (counterfactual) = the typical session's native fresh/cache_read
+    // split priced at the baseline mix + cache-write (5m, conservative) at the baseline
+    // mix. Depends only on the frozen early window + prices -> stable across runs.
+    const oldCps = price(tFi, tCr, tOut, beforeMix) + price_cw(tCw, beforeMix);
+    // NOW / session (actual) = the SAME frozen tokens, pool redistributed at the CURRENT
+    // pool-hit and priced at the CURRENT mix. Cache-write priced at the actual mix.
+    const curCRs = curHit * tPool;
+    const curFs = tPool - curCRs;
+    const nowCps = price(curFs, curCRs, tOut, afterMix) + price_cw(tCw, afterMix);
+    if (!Number.isFinite(oldCps) || !Number.isFinite(nowCps) ||
+        oldCps <= 0 || nowCps <= 0) {
+        const r = NOT_READY("insufficient pricing data");
+        r.installDate = installDate;
+        r.beforeMixLabel = mixLabel(beforeMix);
+        r.baselineBuilding = {
+            sessionsInWindow: before.length,
+            sessionsNeeded: BASELINE_MIN_STABLE_SESSIONS,
+            earlyWindowDays: BASELINE_EARLY_WINDOW_DAYS,
+            daysLeft: 0,
+            firstDate: installDate,
+        };
+        return r;
+    }
+    // Monthly main arms = the per-session anchor x the monthly session count.
+    const cfMonthlyMain = oldCps * sessionsPerMonth;
+    const actualMonthlyMain = nowCps * sessionsPerMonth;
+    // COMPRESSION ADD-BACK (#3): the measured removed-token dollars repriced to the
+    // baseline input mix (baseline_input_rate / current_input_rate). actual = 0 for
+    // this pool (the tokens were never billed), so the whole repriced value is
+    // transformation. Disjoint from the billed pool and the caching lever.
+    // `measuredCompression` is already WINDOWED to `days` by getCompressionSavings
+    // (cutoff = now - days*DAY), so it scales by the same 30/days as the billed arms.
+    const inAfter = inputRatePerMTok(afterMix);
+    const inBefore = inputRatePerMTok(beforeMix);
+    const compReprice = inAfter > 0 ? inBefore / inAfter : 1;
+    const compressionAddbackWindow = Math.max(0, measuredCompression * compReprice);
+    // VERBOSITY-STEER ADD-BACK (#4): estimated output tokens never produced due
+    // to lean-output conciseness nudges. The main counterfactual holds output volume
+    // constant (both arms price the same O), so the output reduction from nudges
+    // is NOT captured by mainTransformation. These are estimated savings logged
+    // to savings_events but excluded from measuredCompression. Reprice to the
+    // baseline OUTPUT rate: the old way would have produced verbose output at the
+    // baseline model mix's output rate. Actual for this pool is 0, so the whole
+    // repriced value is transformation. Mirrors measure.py verbosity_addback.
+    const outAfter = price(0, 0, 1_000_000, afterMix);
+    const outBefore = price(0, 0, 1_000_000, beforeMix);
+    const vsReprice = outAfter > 0 ? outBefore / outAfter : 1;
+    const verbosityAddbackWindow = Math.max(0, measuredVerbosity * vsReprice);
+    // Monthly arms. Main arms come from the frozen per-session anchors x session count;
+    // the add-back pools are still window sums scaled to monthly via m().
+    const actualMonthly = actualMonthlyMain;
+    const counterfactualMonthly = cfMonthlyMain;
+    const compressionAddback = m(compressionAddbackWindow);
+    const verbosityAddback = m(verbosityAddbackWindow);
+    // MAIN transformation = counterfactual − actual (clamped >= 0), monthly.
+    const mainTransformation = Math.max(0, counterfactualMonthly - actualMonthly);
+    // SUBAGENT pool (#2) = 0. OpenCode has NO Claude-style sidechains: no
+    // is_sidechain column on session_log, no separate subagent transcripts to read.
+    // This pool is a DOCUMENTED GAP — when OpenCode exposes delegated/subagent
+    // sessions distinctly, port _subagent_pool_savings here.
+    const subagentTransformation = 0;
+    // Headline = main + subagent (0) + compression add-back + verbosity add-back
+    // (four disjoint pools), monthly.
+    const transformation = mainTransformation + subagentTransformation + compressionAddback + verbosityAddback;
+    // Per-session keys (dashboard reads them) = the FROZEN typical-session anchors
+    // directly. before_* = "the old way" (stable across runs); after_* = "now" (moves
+    // only with efficiency). recentN drives the cumulative figure below.
+    const recentN = after.length;
+    const beforeCps = oldCps;
+    const afterCps = nowCps;
+    // Cumulative: per-session transformation across every post-baseline session.
+    // Uses the full transformation (all 4 pools: main + subagent + compression +
+    // verbosity) divided by current session count, times all post-baseline sessions.
+    // Matches OpenClaw's approach.
     const allAfter = history.filter((r) => r.ts >= windowEnd);
-    const cumulative = perSession * allAfter.length;
-    // 2-lever waterfall (telescopes exactly to perSession):
-    //   routing/mix = (effRate_before - effRate_after) * meanTokens_before
-    //   volume      = effRate_after * (meanTokens_before - meanTokens_after)
-    const perMonth = (x) => x * sessionsPerMonth;
-    const routing = (bs.effRate - as.effRate) * bs.meanTokens;
-    const volume = as.effRate * (bs.meanTokens - as.meanTokens);
+    const perSessionTransformation = transformation / Math.max(1, recentN);
+    const cumulative = perSessionTransformation * allAfter.length;
+    // --- Attribution breakdown: morph the counterfactual into the actual one lever
+    // at a time so the UNROUNDED steps telescope to the headline. ---
+    //   routing  = counterfactual − (cf footprint repriced at today's mix, incl CW)
+    //   caching  = (cf footprint at today's mix) − actual
+    // Routing carries the cache-write reprice (#2). Compression is the third lever.
+    // Levers are computed on the WINDOW arms then scaled by m() so they telescope to
+    // the (monthly) main transformation.
+    let sRoute = 0, sCache = 0;
+    if (mainTransformation > 0) {
+        // Per-session: typical baseline cache split repriced at the actual mix, then x count.
+        const vRouteS = price(tFi, tCr, tOut, afterMix) + price_cw(tCw, afterMix);
+        sRoute = (oldCps - vRouteS) * sessionsPerMonth; // before->after mix (incl CW)
+        sCache = (vRouteS - nowCps) * sessionsPerMonth; // remaining gap = caching
+    }
     const breakdown = [
-        { key: "routing", label: "Model routing & pricing", monthlyUsd: perMonth(routing) },
-        { key: "volume", label: "Token volume", monthlyUsd: perMonth(volume) },
-    ];
+        { key: "routing", label: "Smarter model routing (lighter mix)", monthlyUsd: sRoute },
+        { key: "context_rereads", label: "Lighter sessions (better cache reuse)", monthlyUsd: sCache },
+        { key: "subagent_routing", label: "Cheaper subagents (no sidechains on OpenCode)", monthlyUsd: subagentTransformation },
+        { key: "context_compression", label: "Lighter context (fewer re-reads, metered)", monthlyUsd: compressionAddback },
+        { key: "verbosity_steer", label: "Lean output nudges (less output, estimated)", monthlyUsd: verbosityAddback },
+    ]
+        .filter((b) => b.key !== "subagent_routing" || b.monthlyUsd !== 0) // drop the always-0 sidechain lever
+        .sort((a, b) => Math.abs(b.monthlyUsd) - Math.abs(a.monthlyUsd));
+    // transformationPct: fraction of combined counterfactual spend eliminated.
+    // The combined counterfactual = main cf + compression add-back + verbosity
+    // add-back (both add-back pools' actual is 0, so their cf == their contribution).
+    // Clamped [0,1].
+    const combinedCf = counterfactualMonthly + compressionAddback + verbosityAddback;
+    const transformationPct = combinedCf > 0
+        ? Math.max(0, Math.min(1, transformation / combinedCf))
+        : 0;
+    // compressionMeasuredUsd: the RAW metered floor (before repricing to baseline mix).
+    // This is the proven, event-by-event subset of compressionAddback. It is returned
+    // as a SEPARATE field so the dashboard can render it in its own card, kept OUT of
+    // the transformation headline. INVARIANT: never summed into monthlySavingsUsd.
+    const compressionMeasuredUsd = m(Math.max(0, measuredCompression));
+    // verbosityMeasuredUsd: the RAW estimated verbosity $ (before repricing to
+    // baseline output mix). Also a separate field for the dashboard, kept OUT of
+    // the transformation headline.
+    const verbosityMeasuredUsd = m(Math.max(0, measuredVerbosity));
     return {
         ready: true,
         status: "ok",
-        monthlySavingsUsd: monthly,
-        savingsPerSession: perSession,
-        beforeCostPerSession: bs.costPerSession,
-        afterCostPerSession: as.costPerSession,
+        monthlySavingsUsd: transformation,
+        actualMonthlyUsd: actualMonthly,
+        counterfactualMonthlyUsd: combinedCf,
+        transformationPct,
+        compressionMeasuredUsd,
+        verbosityMeasuredUsd,
+        verbosityTransformationUsd: verbosityAddback,
+        savingsPerSession: beforeCps - afterCps,
+        beforeCostPerSession: beforeCps,
+        afterCostPerSession: afterCps,
         sessionsPerMonth,
-        beforeMixLabel: mixLabel(bs.shares),
-        afterMixLabel: mixLabel(as.shares),
+        beforeMixLabel: mixLabel(beforeMix),
+        afterMixLabel: mixLabel(afterMix),
         cumulativeSavedUsd: cumulative,
         installDate,
         breakdown,
+        baselineBuilding: null, // not needed when ready=true
     };
 }
 //# sourceMappingURL=savings.js.map

package/dist/savings.js.map

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

package/dist/storage/trends.d.ts

@@ -19,6 +19,80 @@ export declare class TrendsStore {
     private dbPath;
     constructor(dataDir: string);
     private connect;
+    /**
+     * Log a realized-savings event to the savings_events table.
+     *
+     * This is the TypeScript equivalent of Python's `_log_savings_event`.
+     * Model is not known at checkpoint-inject time, so cost_saved_usd is
+     * priced at the Sonnet input fallback rate — same behaviour as Python's
+     * resolver when the session model cannot be determined.
+     *
+     * Guards:
+     *   - tokensSaved <= 0  → no-op (never credit zero or negative)
+     *   - Any exception     → silently swallowed (must never break the caller)
+     */
+    logSavingsEvent(eventType: string, tokensSaved: number, sessionId: string | null, detail: string | null, model?: string | null): void;
+    /**
+     * True if a savings event of the given type for the given target session was
+     * already credited within the specified window.
+     *
+     * Prevents double-counting when a user opens the same cold session from two
+     * different fresh sessions (cross-session dedup). Mirrors Python's
+     * `_resume_lean_already_credited` which dedups on the TARGET session_uuid.
+     *
+     * Best-effort: returns false on any error so we never block savings accounting.
+     */
+    hasRecentSavingsEvent(eventType: string, sessionId: string, withinMs: number): boolean;
+    /**
+     * Returns the tokens_cache_write value from session_log for the given session,
+     * or 0 if not found / unavailable.
+     *
+     * This is the closest opencode equivalent to Python's
+     * `cache_create_1h_tokens + cache_create_5m_tokens` — the real cold-rewrite
+     * cost that a lean resume avoids. Used by logResumeLeanSavings for the
+     * primary avoided-cost estimate.
+     *
+     * OVERCOUNT VERIFICATION (Fix 7): tokens_cache_write is populated from
+     * `t?.cache?.write` in the message.updated handler, which maps directly to
+     * OpenCode SDK's `Message.tokens.cache.write` field. Per the SDK type definition
+     * (types.gen.d.ts L120), `cache.write` is the cache CREATION count only —
+     * distinct from `cache.read` (cheap hits). A `--resume` cold rewrite ONLY incurs
+     * write (creation) cost; read hits on an established cache do NOT re-pay write cost.
+     * Therefore tokens_cache_write is write-only and does NOT conflate cache-read tokens.
+     * No discount needed: this column is the correct, non-overcounting avoided-cost metric.
+     *
+     * Best-effort: returns 0 on any error.
+     */
+    getSessionCacheWrite(sessionId: string): number;
+    /**
+     * Summarize compression/volume-reduction savings_events over the window for
+     * the realized-savings compression add-back (pool #3).
+     *
+     * Mirrors Python's `_get_savings_summary`: the returned `totalCostSavedUsd` is
+     * the MEASURED compression floor with estimated-tier categories relocated OUT
+     * (setup_optimization, mcp_cap, hint_followed) and tool_archive re-expansions
+     * NETTED against tool_archive (a re-popped result didn't stay collapsed, so its
+     * eager credit is reversed, floored at 0). What remains is the directly-metered
+     * removed-token dollars the old way would have re-read.
+     *
+     * Best-effort: returns zeros on any error (never throws). `now` is injectable
+     * for testing.
+     */
+    getCompressionSavings(days?: number, now?: number): {
+        totalTokensSaved: number;
+        totalCostSavedUsd: number;
+        totalEvents: number;
+    };
+    /**
+     * Sum the ESTIMATED verbosity_steer savings (cost_saved_usd) over the window.
+     * These are estimated output-token reductions from lean-output conciseness nudges —
+     * the trigger is observed but the magnitude is not metered. Mirrors measure.py
+     * `_get_savings_summary` which relocates verbosity_steer to the estimated tier.
+     * The caller reprices to the baseline OUTPUT rate and adds as a separate pool.
+     *
+     * Best-effort: returns 0 on any error (never throws). `now` is injectable.
+     */
+    getVerbositySavings(days?: number, now?: number): number;
     close(): void;
     recordSession(data: SessionTrendData): void;
     getRecentSessions(days?: number): Array<Record<string, unknown>>;

package/dist/storage/trends.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trends.d.ts","sourceRoot":"","sources":["../../src/storage/trends.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,MAAM;IAQ3B,OAAO,CAAC,OAAO;IAUf,KAAK,IAAI,IAAI;IAOb,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAwC3C,iBAAiB,CAAC,IAAI,GAAE,MAAW,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAWpE;+DAC2D;IAC3D,cAAc,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAOhD,aAAa,CAAC,IAAI,GAAE,MAAW,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAqBjE"}
+{"version":3,"file":"trends.d.ts","sourceRoot":"","sources":["../../src/storage/trends.ts"],"names":[],"mappings":"AA4CA,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,MAAM;IAQ3B,OAAO,CAAC,OAAO;IAWf;;;;;;;;;;;OAWG;IACH,eAAe,CACb,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,KAAK,GAAE,MAAM,GAAG,IAAW,GAC1B,IAAI;IAuBP;;;;;;;;;OASG;IACH,qBAAqB,CACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO;IAkBV;;;;;;;;;;;;;;;;;;;OAmBG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAgB/C;;;;;;;;;;;;;OAaG;IACH,qBAAqB,CAAC,IAAI,GAAE,MAAW,EAAE,GAAG,GAAE,MAAmB,GAAG;QAClE,gBAAgB,EAAE,MAAM,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,WAAW,EAAE,MAAM,CAAC;KACrB;IAwDD;;;;;;;;OAQG;IACH,mBAAmB,CAAC,IAAI,GAAE,MAAW,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM;IAgBxE,KAAK,IAAI,IAAI;IAOb,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAwC3C,iBAAiB,CAAC,IAAI,GAAE,MAAW,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAWpE;+DAC2D;IAC3D,cAAc,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAOhD,aAAa,CAAC,IAAI,GAAE,MAAW,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAqBjE"}