context-mode 1.0.168 → 2.0.0-next.5

package/build/session/analytics.js

@@ -1,2369 +0,0 @@
-/**
- * AnalyticsEngine — Runtime savings + session continuity reporting.
- *
- * Computes context-window savings from runtime stats and queries
- * session continuity data from SessionDB.
- *
- * Usage:
- *   const engine = new AnalyticsEngine(sessionDb);
- *   const report = engine.queryAll(runtimeStats);
- */
-import { execFileSync } from "node:child_process";
-import { existsSync, readdirSync, statSync } from "node:fs";
-import { homedir } from "node:os";
-import { join, sep } from "node:path";
-import { loadDatabase as loadDatabaseImpl } from "../db-base.js";
-import { ensureSessionEventsSchema } from "./db.js";
-import { resolveClaudeConfigDir } from "../util/claude-config.js";
-function semverNewer(a, b) {
-    const pa = a.split(".").map(Number);
-    const pb = b.split(".").map(Number);
-    for (let i = 0; i < 3; i++) {
-        if ((pa[i] ?? 0) > (pb[i] ?? 0))
-            return true;
-        if ((pa[i] ?? 0) < (pb[i] ?? 0))
-            return false;
-    }
-    return false;
-}
-// ─────────────────────────────────────────────────────────
-// Category labels and hints for session continuity display
-// ─────────────────────────────────────────────────────────
-/**
- * Human-readable labels for event categories.
- *
- * Each label is a sentence-case phrase that reads like a benefit, not a
- * column name. The user shouldn't see raw schema words like "external-ref"
- * or "agent-finding" — those leak the database into the UX. When a new
- * category lands without an entry here, the renderer falls through to the
- * raw category id; that's a copy-debt signal, fix it here.
- */
-export const categoryLabels = {
-    // Code & filesystem
-    file: "Files tracked",
-    cwd: "Working directory",
-    // Configuration & intent
-    rule: "Project rules (CLAUDE.md)",
-    prompt: "Your requests saved",
-    intent: "Session intent",
-    goal: "Session goal",
-    role: "Behavior rules",
-    constraint: "Constraints you set",
-    // Tools & delegation
-    mcp: "MCP tools called",
-    skill: "Skills used",
-    subagent: "Delegated work",
-    // Knowledge & decisions
-    decision: "Your decisions",
-    "agent-finding": "Agent insights kept",
-    "rejected-approach": "Approaches you rejected",
-    "external-ref": "External docs indexed",
-    data: "Data references",
-    // System events
-    git: "Git operations",
-    env: "Environment setup",
-    task: "Tasks in progress",
-    error: "Errors caught",
-    // Continuity proof
-    compact: "Compactions weathered",
-    resume: "Sessions resumed cleanly",
-    snapshot: "Snapshots restored",
-    cache: "Cache hits saved",
-    // Operational
-    latency: "Slow tools recorded",
-    "user-prompt": "Your messages remembered",
-    plan: "Plans drafted",
-    "blocked-on": "Blockers logged",
-};
-/** Explains why each category matters for continuity. */
-export const categoryHints = {
-    file: "Restored after compact — no need to re-read",
-    rule: "Your project instructions survive context resets",
-    prompt: "Continues exactly where you left off",
-    decision: "Applied automatically — won’t ask again",
-    task: "Picks up from where it stopped",
-    error: "Tracked and monitored across compacts",
-    git: "Branch, commit, and repo state preserved",
-    env: "Runtime config carried forward",
-    mcp: "Tool usage patterns remembered",
-    subagent: "Delegation history preserved",
-    skill: "Skill invocations tracked",
-};
-// ─────────────────────────────────────────────────────────
-// AnalyticsEngine
-// ─────────────────────────────────────────────────────────
-export class AnalyticsEngine {
-    db;
-    /**
-     * Create an AnalyticsEngine.
-     *
-     * Accepts either a SessionDB instance (extracts internal db via
-     * the protected getter — use the static fromDB helper for raw adapters)
-     * or any object with a prepare() method for direct usage.
-     */
-    constructor(db) {
-        this.db = db;
-    }
-    // ═══════════════════════════════════════════════════════
-    // GROUP 3 — Runtime (4 metrics, stubs)
-    // ═══════════════════════════════════════════════════════
-    /**
-     * #1 Context Savings Total — bytes kept out of context window.
-     *
-     * Stub: requires server.ts to accumulate rawBytes and contextBytes
-     * during a live session. Call with tracked values.
-     */
-    static contextSavingsTotal(rawBytes, contextBytes) {
-        const savedBytes = rawBytes - contextBytes;
-        const savedPercent = rawBytes > 0
-            ? Math.round((savedBytes / rawBytes) * 1000) / 10
-            : 0;
-        return { rawBytes, contextBytes, savedBytes, savedPercent };
-    }
-    /**
-     * #2 Think in Code Comparison — ratio of file size to sandbox output size.
-     *
-     * Stub: requires server.ts tracking of execute/execute_file calls.
-     */
-    static thinkInCodeComparison(fileBytes, outputBytes) {
-        const ratio = outputBytes > 0
-            ? Math.round((fileBytes / outputBytes) * 10) / 10
-            : 0;
-        return { fileBytes, outputBytes, ratio };
-    }
-    /**
-     * #3 Tool Savings — per-tool breakdown of context savings.
-     *
-     * Stub: requires per-tool accumulators in server.ts.
-     */
-    static toolSavings(tools) {
-        return tools.map((t) => ({
-            ...t,
-            savedBytes: t.rawBytes - t.contextBytes,
-        }));
-    }
-    /**
-     * #19 Sandbox I/O — total input/output bytes processed by the sandbox.
-     *
-     * Stub: requires PolyglotExecutor byte counters.
-     */
-    static sandboxIO(inputBytes, outputBytes) {
-        return { inputBytes, outputBytes };
-    }
-    /**
-     * MCP tool usage — call counts and concurrency stats per MCP tool.
-     *
-     * Reads `mcp_tool_call` events, parses the JSON payload, and aggregates:
-     *  - call count per tool_name
-     *  - median + max of `params.concurrency` (only for tools that take it,
-     *    e.g. ctx_batch_execute, ctx_fetch_and_index). Returns null when the
-     *    tool doesn't carry a concurrency param so callers can render N/A.
-     *
-     * Best-effort: malformed rows or truncated payloads are skipped silently.
-     */
-    getMcpToolUsage() {
-        let rows;
-        try {
-            rows = this.db.prepare("SELECT data FROM session_events WHERE category = 'mcp_tool_call'").all();
-        }
-        catch {
-            return [];
-        }
-        // toolName -> { calls, concurrencies }
-        const agg = new Map();
-        for (const row of rows) {
-            let parsed;
-            try {
-                parsed = JSON.parse(row.data);
-            }
-            catch {
-                continue;
-            }
-            const toolName = typeof parsed.tool_name === "string" ? parsed.tool_name : null;
-            if (!toolName)
-                continue;
-            const bucket = agg.get(toolName) ?? { calls: 0, concurrencies: [] };
-            bucket.calls += 1;
-            // Skip concurrency extraction when the row was truncated — the params
-            // blob is a substring of JSON that may not parse cleanly.
-            if (parsed.truncated !== true && parsed.params && typeof parsed.params === "object") {
-                const c = parsed.params.concurrency;
-                if (typeof c === "number" && Number.isFinite(c) && c > 0) {
-                    bucket.concurrencies.push(c);
-                }
-            }
-            agg.set(toolName, bucket);
-        }
-        const out = [];
-        for (const [tool_name, b] of agg) {
-            let median = null;
-            let max = null;
-            if (b.concurrencies.length > 0) {
-                b.concurrencies.sort((a, c) => a - c);
-                const sorted = b.concurrencies;
-                const mid = Math.floor(sorted.length / 2);
-                median = sorted.length % 2 === 0
-                    ? (sorted[mid - 1] + sorted[mid]) / 2
-                    : sorted[mid];
-                max = sorted[sorted.length - 1];
-            }
-            out.push({
-                tool_name,
-                calls: b.calls,
-                median_concurrency: median,
-                max_concurrency: max,
-            });
-        }
-        // Stable sort: most-called first, then alphabetical
-        out.sort((a, c) => c.calls - a.calls || a.tool_name.localeCompare(c.tool_name));
-        return out;
-    }
-    // ═══════════════════════════════════════════════════════
-    // queryAll — single unified report from ONE source
-    // ═══════════════════════════════════════════════════════
-    /**
-     * Build a FullReport by merging runtime stats (passed in)
-     * with continuity data from the DB.
-     *
-     * This is the ONE call that ctx_stats should use.
-     */
-    queryAll(runtimeStats) {
-        // ── Resolve latest session ID ──
-        const latestSession = this.db.prepare("SELECT session_id FROM session_meta ORDER BY started_at DESC LIMIT 1").get();
-        const sid = latestSession?.session_id ?? "";
-        // ── Runtime savings ──
-        const totalBytesReturned = Object.values(runtimeStats.bytesReturned).reduce((sum, b) => sum + b, 0);
-        const totalCalls = Object.values(runtimeStats.calls).reduce((sum, c) => sum + c, 0);
-        const keptOut = runtimeStats.bytesIndexed + runtimeStats.bytesSandboxed;
-        const totalProcessed = keptOut + totalBytesReturned;
-        const savingsRatio = totalProcessed / Math.max(totalBytesReturned, 1);
-        const reductionPct = totalProcessed > 0
-            ? Math.round((1 - totalBytesReturned / totalProcessed) * 100)
-            : 0;
-        const toolNames = new Set([
-            ...Object.keys(runtimeStats.calls),
-            ...Object.keys(runtimeStats.bytesReturned),
-        ]);
-        const byTool = Array.from(toolNames).sort().map((tool) => ({
-            tool,
-            calls: runtimeStats.calls[tool] || 0,
-            context_kb: Math.round((runtimeStats.bytesReturned[tool] || 0) / 1024 * 10) / 10,
-            tokens: Math.round((runtimeStats.bytesReturned[tool] || 0) / 4),
-        }));
-        const uptimeMs = Date.now() - runtimeStats.sessionStart;
-        const uptimeMin = (uptimeMs / 60_000).toFixed(1);
-        // ── Cache ──
-        let cache;
-        const cacheMisses = runtimeStats.cacheMisses ?? 0;
-        if (runtimeStats.cacheHits > 0 || runtimeStats.cacheBytesSaved > 0 || cacheMisses > 0) {
-            const totalWithCache = totalProcessed + runtimeStats.cacheBytesSaved;
-            const totalSavingsRatio = totalWithCache / Math.max(totalBytesReturned, 1);
-            const ttlHoursLeft = Math.max(0, 24 - Math.floor((Date.now() - runtimeStats.sessionStart) / (60 * 60 * 1000)));
-            // hit_rate is the nominal cache effectiveness — the metric ctx_stats
-            // historically inferred-only by diffing tokens_saved snapshots. When
-            // there is no activity we report 0 instead of NaN/undefined so the
-            // renderer stays JSON-safe.
-            const totalLookups = runtimeStats.cacheHits + cacheMisses;
-            const hitRate = totalLookups > 0 ? runtimeStats.cacheHits / totalLookups : 0;
-            cache = {
-                hits: runtimeStats.cacheHits,
-                misses: cacheMisses,
-                hit_rate: hitRate,
-                bytes_saved: runtimeStats.cacheBytesSaved,
-                ttl_hours_left: ttlHoursLeft,
-                total_with_cache: totalWithCache,
-                total_savings_ratio: totalSavingsRatio,
-            };
-        }
-        // ── Continuity data (scoped to current session) ──
-        const eventTotal = this.db.prepare("SELECT COUNT(*) as cnt FROM session_events WHERE session_id = ?").get(sid).cnt;
-        const byCategory = this.db.prepare("SELECT category, COUNT(*) as cnt FROM session_events WHERE session_id = ? GROUP BY category ORDER BY cnt DESC").all(sid);
-        const meta = this.db.prepare("SELECT compact_count FROM session_meta WHERE session_id = ?").get(sid);
-        const compactCount = meta?.compact_count ?? 0;
-        const resume = this.db.prepare("SELECT event_count, consumed FROM session_resume WHERE session_id = ? ORDER BY created_at DESC LIMIT 1").get(sid);
-        const resumeReady = resume ? !resume.consumed : false;
-        // Build category previews (current session only)
-        const previewRows = this.db.prepare("SELECT category, type, data FROM session_events WHERE session_id = ? ORDER BY id DESC").all(sid);
-        const previews = new Map();
-        for (const row of previewRows) {
-            if (!previews.has(row.category))
-                previews.set(row.category, new Set());
-            const set = previews.get(row.category);
-            if (set.size < 5) {
-                let display = row.data;
-                if (row.category === "file") {
-                    display = row.data.split("/").pop() || row.data;
-                }
-                else if (row.category === "prompt" || row.category === "user-prompt") {
-                    display = display.length > 50 ? display.slice(0, 47) + "..." : display;
-                }
-                if (display.length > 40)
-                    display = display.slice(0, 37) + "...";
-                set.add(display);
-            }
-        }
-        const continuityByCategory = byCategory.map((row) => ({
-            category: row.category,
-            count: row.cnt,
-            label: categoryLabels[row.category] || row.category,
-            preview: previews.get(row.category)
-                ? Array.from(previews.get(row.category)).join(", ")
-                : "",
-            why: categoryHints[row.category] || "Survives context resets",
-        }));
-        // ── Project-wide persistent memory (all sessions, no session_id filter) ──
-        const projectTotals = this.db.prepare("SELECT COUNT(*) as cnt, COUNT(DISTINCT session_id) as sessions FROM session_events").get();
-        const projectByCategory = this.db.prepare("SELECT category, COUNT(*) as cnt FROM session_events GROUP BY category ORDER BY cnt DESC").all();
-        const projectMemoryByCategory = projectByCategory
-            .filter((row) => row.cnt > 0)
-            .map((row) => ({
-            category: row.category,
-            count: row.cnt,
-            label: categoryLabels[row.category] || row.category,
-        }));
-        return {
-            savings: {
-                processed_kb: Math.round(totalProcessed / 1024 * 10) / 10,
-                entered_kb: Math.round(totalBytesReturned / 1024 * 10) / 10,
-                saved_kb: Math.round(keptOut / 1024 * 10) / 10,
-                pct: reductionPct,
-                savings_ratio: Math.round(savingsRatio * 10) / 10,
-                by_tool: byTool,
-                total_calls: totalCalls,
-                total_bytes_returned: totalBytesReturned,
-                kept_out: keptOut,
-                total_processed: totalProcessed,
-            },
-            cache,
-            session: {
-                id: sid,
-                uptime_min: uptimeMin,
-            },
-            continuity: {
-                total_events: eventTotal,
-                by_category: continuityByCategory,
-                compact_count: compactCount,
-                resume_ready: resumeReady,
-            },
-            projectMemory: {
-                total_events: projectTotals.cnt,
-                session_count: projectTotals.sessions,
-                by_category: projectMemoryByCategory,
-            },
-        };
-    }
-}
-/**
- * Enumerate every known adapter's sessions + content dirs under `home`.
- * Used by `getMultiAdapterLifetimeStats` and `getMultiAdapterRealBytesStats`
- * so a single call surfaces "your work everywhere on this machine across
- * all AI tools" (the marketing line).
- *
- * Returns ALL 17 adapters even when the dir doesn't exist on disk — the
- * scanner functions filter to existing dirs. That keeps the enumeration
- * pure / testable without filesystem dependencies.
- */
-export function enumerateAdapterDirs(opts) {
-    const home = opts?.home ?? homedir();
-    // Mirrors `getSessionDirSegments` in src/adapters/detect.ts:92-111.
-    const map = [
-        ["claude-code", [".claude"]],
-        ["gemini-cli", [".gemini"]],
-        ["antigravity", [".gemini"]],
-        ["antigravity-cli", [".gemini"]],
-        ["openclaw", [".openclaw"]],
-        ["codex", [".codex"]],
-        ["cursor", [".cursor"]],
-        ["vscode-copilot", [".vscode"]],
-        ["copilot-cli", [".copilot"]],
-        ["kiro", [".kiro"]],
-        ["pi", [".pi"]],
-        ["omp", [".omp"]],
-        ["qwen-code", [".qwen"]],
-        ["kilo", [".config", "kilo"]],
-        ["opencode", [".config", "opencode"]],
-        ["zed", [".config", "zed"]],
-        ["jetbrains-copilot", [".config", "JetBrains"]],
-    ];
-    return map.map(([name, segments]) => {
-        const base = join(home, ...segments, "context-mode");
-        return {
-            name,
-            sessionsDir: join(base, "sessions"),
-            contentDir: join(base, "content"),
-        };
-    });
-}
-/** Extract leading prefix from auto-memory filename: `feedback_push.md` → `feedback`. */
-function autoMemoryPrefix(filename) {
-    const base = filename.replace(/\.md$/i, "");
-    const m = base.match(/^([a-z]+)/i);
-    return m ? m[1].toLowerCase() : "other";
-}
-/**
- * Aggregate lifetime stats from all SessionDB files in `sessionsDir` and
- * all auto-memory markdown files under `memoryRoot/<project>/memory/`.
- *
- * Best-effort: silently ignores missing/unreadable files so ctx_stats
- * can never be broken by a corrupt sidecar.
- */
-export function getLifetimeStats(opts) {
-    // Issue #460 round-3: route through resolveClaudeConfigDir so lifetime
-    // stats aggregation tracks $CLAUDE_CONFIG_DIR instead of the literal
-    // ~/.claude tree. Otherwise users who relocate config see "no sessions"
-    // even though the SessionDB sidecars exist under the override.
-    const claudeRoot = resolveClaudeConfigDir();
-    const sessionsDir = opts?.sessionsDir
-        ?? join(claudeRoot, "context-mode", "sessions");
-    const memoryRoot = opts?.memoryRoot
-        ?? join(claudeRoot, "projects");
-    let totalEvents = 0;
-    let totalSessions = 0;
-    let rescueBytes = 0;
-    let firstEventMs = Number.POSITIVE_INFINITY;
-    const distinctProjectsSet = new Set();
-    const categoryCounts = {};
-    // ── SessionDB aggregation ──
-    if (existsSync(sessionsDir)) {
-        let dbFiles = [];
-        try {
-            dbFiles = readdirSync(sessionsDir).filter((f) => f.endsWith(".db"));
-        }
-        catch { /* unreadable */ }
-        if (dbFiles.length > 0) {
-            // Lazy-load better-sqlite3 / bun-sqlite via the same path the runtime uses.
-            let DatabaseCtor = null;
-            try {
-                DatabaseCtor = opts?.loadDatabase
-                    ? opts.loadDatabase()
-                    : loadDatabaseImpl();
-            }
-            catch { /* sqlite unavailable */ }
-            if (DatabaseCtor) {
-                for (const file of dbFiles) {
-                    const dbPath = join(sessionsDir, file);
-                    try {
-                        const sdb = new DatabaseCtor(dbPath, { readonly: true });
-                        try {
-                            const ev = sdb.prepare("SELECT COUNT(*) AS cnt FROM session_events").get();
-                            const ss = sdb.prepare("SELECT COUNT(*) AS cnt FROM session_meta").get();
-                            totalEvents += ev?.cnt ?? 0;
-                            totalSessions += ss?.cnt ?? 0;
-                            // Per-category aggregation across every sidecar so the
-                            // Persistent memory bars stay populated even when the
-                            // current project's local DB is fresh / empty.
-                            try {
-                                const catRows = sdb.prepare("SELECT category, COUNT(*) AS cnt FROM session_events GROUP BY category").all();
-                                for (const row of catRows) {
-                                    if (!row.category)
-                                        continue;
-                                    categoryCounts[row.category] = (categoryCounts[row.category] ?? 0) + (row.cnt ?? 0);
-                                }
-                            }
-                            catch {
-                                // older schema / no category column — ignore
-                            }
-                            // Lifetime rescue: compact-snapshot bytes restored across every DB.
-                            // Without this, the lifetime $ silently undercounts the killer
-                            // continuity-after-/compact feature.
-                            try {
-                                const snap = sdb.prepare("SELECT COALESCE(SUM(length(snapshot)), 0) AS bytes FROM session_resume WHERE consumed = 1").get();
-                                if (snap?.bytes)
-                                    rescueBytes += snap.bytes;
-                            }
-                            catch { /* old schema */ }
-                            // Earliest event timestamp + distinct project_dirs for the
-                            // "since X · Y projects" lifetime narrative.
-                            try {
-                                const mn = sdb.prepare("SELECT MIN(created_at) AS t FROM session_events").get();
-                                if (mn?.t) {
-                                    const stamp = mn.t.endsWith("Z") ? mn.t : mn.t + "Z";
-                                    const ms = Date.parse(stamp);
-                                    if (Number.isFinite(ms) && ms < firstEventMs)
-                                        firstEventMs = ms;
-                                }
-                            }
-                            catch { /* old schema */ }
-                            try {
-                                const projRows = sdb.prepare("SELECT DISTINCT project_dir AS p FROM session_events WHERE project_dir != ''").all();
-                                for (const row of projRows)
-                                    if (row.p)
-                                        distinctProjectsSet.add(row.p);
-                            }
-                            catch { /* old schema */ }
-                        }
-                        finally {
-                            sdb.close();
-                        }
-                    }
-                    catch {
-                        // missing tables / corrupt file — skip
-                    }
-                }
-            }
-        }
-    }
-    // ── Auto-memory file scan ──
-    let autoMemoryCount = 0;
-    let autoMemoryProjects = 0;
-    const autoMemoryByPrefix = {};
-    if (existsSync(memoryRoot)) {
-        let projectDirs = [];
-        try {
-            projectDirs = readdirSync(memoryRoot).filter((entry) => {
-                try {
-                    return statSync(join(memoryRoot, entry)).isDirectory();
-                }
-                catch {
-                    return false;
-                }
-            });
-        }
-        catch { /* unreadable */ }
-        for (const proj of projectDirs) {
-            const memDir = join(memoryRoot, proj, "memory");
-            if (!existsSync(memDir))
-                continue;
-            let mdFiles = [];
-            try {
-                mdFiles = readdirSync(memDir).filter((f) => f.endsWith(".md"));
-            }
-            catch {
-                continue;
-            }
-            if (mdFiles.length === 0)
-                continue;
-            autoMemoryProjects++;
-            autoMemoryCount += mdFiles.length;
-            for (const f of mdFiles) {
-                const prefix = autoMemoryPrefix(f);
-                autoMemoryByPrefix[prefix] = (autoMemoryByPrefix[prefix] ?? 0) + 1;
-            }
-        }
-    }
-    return {
-        totalEvents,
-        totalSessions,
-        autoMemoryCount,
-        autoMemoryProjects,
-        autoMemoryByPrefix,
-        categoryCounts,
-        rescueBytes,
-        firstEventMs: Number.isFinite(firstEventMs) ? firstEventMs : 0,
-        distinctProjects: distinctProjectsSet.size,
-    };
-}
-/**
- * Aggregate every event for one `session_id` across all SessionDB files in
- * `sessionsDir` plus the compact-rescue snapshot bytes from `session_resume`.
- *
- * Why this exists: the Claude Code session_id can persist across days while
- * the underlying DB file rotates (size cap), and a compact-rescue snapshot
- * carries hundreds of KB of context that would otherwise have been lost. The
- * old in-memory `tool_call_counter` saw none of this — it counted only `ctx_*`
- * MCP calls against the current MCP server PID and reset on every restart.
- * Reading from `session_events` + `session_resume` is the source-of-truth
- * version that matches what users actually experienced.
- */
-export function getConversationStats(opts) {
-    const sessionsDir = opts.sessionsDir
-        ?? join(homedir(), ".claude", "context-mode", "sessions");
-    const sessionId = opts.sessionId;
-    const empty = {
-        sessionId,
-        events: 0,
-        dbCount: 0,
-        daysAlive: 0,
-        snapshotBytes: 0,
-        snapshotsConsumed: 0,
-        byCategory: [],
-    };
-    if (!sessionId || !existsSync(sessionsDir))
-        return empty;
-    let dbFiles = [];
-    try {
-        dbFiles = readdirSync(sessionsDir).filter((f) => {
-            if (!f.endsWith(".db"))
-                return false;
-            if (opts.worktreeHash && !f.startsWith(opts.worktreeHash))
-                return false;
-            return true;
-        });
-    }
-    catch {
-        return empty;
-    }
-    if (dbFiles.length === 0)
-        return empty;
-    let DatabaseCtor = null;
-    try {
-        DatabaseCtor = opts.loadDatabase
-            ? opts.loadDatabase()
-            : loadDatabaseImpl();
-    }
-    catch {
-        return empty;
-    }
-    if (!DatabaseCtor)
-        return empty;
-    const catCounts = {};
-    let events = 0;
-    let dbCount = 0;
-    let snapshotBytes = 0;
-    let snapshotsConsumed = 0;
-    let firstMs = Number.POSITIVE_INFINITY;
-    let lastMs = 0;
-    let lastRescueMs = 0;
-    // Per-day captures aggregated across every DB. Key is the UTC midnight ms
-    // of the day; value tracks both the event count and any rescueBytes (latter
-    // overlays the ◆ /compact glyph in the section-1 horizontal timeline).
-    const byDayMap = new Map();
-    const dayKey = (ms) => Math.floor(ms / 86_400_000) * 86_400_000;
-    for (const file of dbFiles) {
-        const dbPath = join(sessionsDir, file);
-        let touched = false;
-        try {
-            const sdb = new DatabaseCtor(dbPath, { readonly: true });
-            try {
-                const cats = sdb.prepare("SELECT category, COUNT(*) AS cnt FROM session_events WHERE session_id = ? GROUP BY category").all(sessionId);
-                for (const row of cats) {
-                    if (!row.category)
-                        continue;
-                    catCounts[row.category] = (catCounts[row.category] ?? 0) + (row.cnt ?? 0);
-                    events += row.cnt ?? 0;
-                    touched = true;
-                }
-                const range = sdb.prepare("SELECT MIN(created_at) AS mn, MAX(created_at) AS mx FROM session_events WHERE session_id = ?").get(sessionId);
-                if (range?.mn) {
-                    const t = Date.parse(range.mn + (range.mn.endsWith("Z") ? "" : "Z"));
-                    if (Number.isFinite(t) && t < firstMs)
-                        firstMs = t;
-                }
-                if (range?.mx) {
-                    const t = Date.parse(range.mx + (range.mx.endsWith("Z") ? "" : "Z"));
-                    if (Number.isFinite(t) && t > lastMs)
-                        lastMs = t;
-                }
-                // Per-day captures + per-day rescue overlay for the narrative timeline.
-                // Best-effort: silently skip when the schema lacks created_at.
-                try {
-                    const dayRows = sdb.prepare("SELECT strftime('%s', created_at) AS sec, COUNT(*) AS cnt FROM session_events WHERE session_id = ? GROUP BY date(created_at)").all(sessionId);
-                    for (const row of dayRows) {
-                        if (!row.sec)
-                            continue;
-                        const ms = parseInt(row.sec, 10) * 1000;
-                        if (!Number.isFinite(ms))
-                            continue;
-                        const k = dayKey(ms);
-                        const cur = byDayMap.get(k) ?? { count: 0, rescueBytes: 0 };
-                        cur.count += row.cnt ?? 0;
-                        byDayMap.set(k, cur);
-                    }
-                }
-                catch { /* old schema */ }
-                try {
-                    const snap = sdb.prepare("SELECT COALESCE(SUM(length(snapshot)), 0) AS bytes, COUNT(*) AS n, MAX(strftime('%s', created_at)) AS lastSec FROM session_resume WHERE session_id = ? AND consumed = 1").get(sessionId);
-                    if (snap?.bytes)
-                        snapshotBytes += snap.bytes;
-                    if (snap?.n)
-                        snapshotsConsumed += snap.n;
-                    if (snap?.lastSec) {
-                        const t = parseInt(snap.lastSec, 10) * 1000;
-                        if (Number.isFinite(t) && t > lastRescueMs)
-                            lastRescueMs = t;
-                        // Overlay the rescue bytes onto the day bucket for the timeline.
-                        if (Number.isFinite(t) && (snap?.bytes ?? 0) > 0) {
-                            const k = dayKey(t);
-                            const cur = byDayMap.get(k) ?? { count: 0, rescueBytes: 0 };
-                            cur.rescueBytes = Math.max(cur.rescueBytes, snap.bytes);
-                            byDayMap.set(k, cur);
-                        }
-                    }
-                }
-                catch { /* old schema */ }
-            }
-            finally {
-                sdb.close();
-            }
-        }
-        catch { /* missing tables / corrupt */ }
-        if (touched)
-            dbCount++;
-    }
-    const daysAlive = firstMs < lastMs ? (lastMs - firstMs) / 86_400_000 : 0;
-    const byCategory = Object.entries(catCounts)
-        .filter(([, n]) => n > 0)
-        .map(([category, count]) => ({
-        category,
-        count,
-        label: categoryLabels[category] || category,
-    }))
-        .sort((a, b) => b.count - a.count);
-    const byDay = [...byDayMap.entries()]
-        .sort((a, b) => a[0] - b[0])
-        .map(([ms, v]) => ({
-        ms,
-        count: v.count,
-        ...(v.rescueBytes > 0 ? { rescueBytes: v.rescueBytes } : {}),
-    }));
-    return {
-        sessionId,
-        events,
-        dbCount,
-        daysAlive,
-        snapshotBytes,
-        snapshotsConsumed,
-        byCategory,
-        firstEventMs: Number.isFinite(firstMs) ? firstMs : 0,
-        lastEventMs: lastMs > 0 ? lastMs : 0,
-        lastRescueMs: lastRescueMs > 0 ? lastRescueMs : undefined,
-        byDay,
-    };
-}
-/**
- * v1.0.133 Slice 3: Sum the bytes attributed to one session in the FTS5
- * content DB.
- *
- * Returns `LENGTH(title) + LENGTH(content)` summed across every chunk
- * whose `session_id` column matches `sessionId`. Best-effort — returns 0
- * when the DB file is missing, the schema lacks the `session_id` column
- * (pre-Slice-1 content DBs), or the query fails. Never throws.
- *
- * Render-time only. Does NOT mutate the content DB. Architect-approved
- * because the read-only join carries no risk of cross-session attribution
- * (the FK was set at chunk insert time by Slice 1).
- */
-export function getContentBytesForSession(sessionId, contentDbPath, opts) {
-    if (!sessionId || !contentDbPath)
-        return 0;
-    if (!existsSync(contentDbPath))
-        return 0;
-    let DatabaseCtor = null;
-    try {
-        DatabaseCtor = opts?.loadDatabase
-            ? opts.loadDatabase()
-            : loadDatabaseImpl();
-    }
-    catch {
-        return 0;
-    }
-    if (!DatabaseCtor)
-        return 0;
-    try {
-        const db = new DatabaseCtor(contentDbPath, { readonly: true });
-        try {
-            const row = db.prepare(`SELECT COALESCE(SUM(LENGTH(content) + LENGTH(title)), 0) AS bytes
-         FROM chunks WHERE session_id = ?`).get(sessionId);
-            return Number(row?.bytes ?? 0);
-        }
-        finally {
-            db.close();
-        }
-    }
-    catch {
-        return 0;
-    }
-}
-/**
- * v1.0.134 SLICE C — lifetime tier all-chunks aggregate.
- *
- * Sibling of {@link getContentBytesForSession} that omits the session_id
- * filter so the lifetime tier sees every chunk in the content store —
- * including legacy unattributed rows (sessionId === '') and chunks
- * attributed to other adapters' sessions. Without this, the lifetime
- * "kept out" headline only counts session_events.bytes_avoided and
- * misses the bulk of indexed payload.
- *
- * Best-effort: returns 0 when the DB file is missing, the schema lacks
- * the `chunks` table, or the query fails. Never throws — same contract
- * as the rest of the analytics module so a corrupt content DB cannot
- * crash ctx_stats.
- */
-export function getContentBytesAllSessions(contentDbPath, opts) {
-    if (!contentDbPath)
-        return 0;
-    if (!existsSync(contentDbPath))
-        return 0;
-    let DatabaseCtor = null;
-    try {
-        DatabaseCtor = opts?.loadDatabase
-            ? opts.loadDatabase()
-            : loadDatabaseImpl();
-    }
-    catch {
-        return 0;
-    }
-    if (!DatabaseCtor)
-        return 0;
-    try {
-        const db = new DatabaseCtor(contentDbPath, { readonly: true });
-        try {
-            const row = db.prepare(`SELECT COALESCE(SUM(LENGTH(content) + LENGTH(title)), 0) AS bytes
-         FROM chunks`).get();
-            return Number(row?.bytes ?? 0);
-        }
-        finally {
-            db.close();
-        }
-    }
-    catch {
-        return 0;
-    }
-}
-/**
- * Compute real-bytes stats across one session, one project (worktree
- * filter), or every session on disk (lifetime).
- *
- * - Pass `sessionId` for the conversation tier.
- * - Pass `worktreeHash` to filter `*.db` files by name prefix
- *   (per-project lifetime — `sha256(cwd).slice(0, 16)`).
- * - Pass neither — full lifetime aggregate.
- *
- * Best-effort: returns zeroes when the dir is missing, the DB is
- * corrupt, or the session has no events. Never throws — same
- * contract as `getConversationStats` / `getLifetimeStats` so the
- * stats-render path can never crash on a bad sidecar.
- */
-export function getRealBytesStats(opts) {
-    const empty = {
-        eventDataBytes: 0,
-        bytesAvoided: 0,
-        bytesReturned: 0,
-        snapshotBytes: 0,
-        contentBytes: 0,
-        totalSavedTokens: 0,
-    };
-    const sessionsDir = opts.sessionsDir
-        ?? join(homedir(), ".claude", "context-mode", "sessions");
-    if (!existsSync(sessionsDir))
-        return empty;
-    let dbFiles = [];
-    try {
-        dbFiles = readdirSync(sessionsDir).filter((f) => {
-            if (!f.endsWith(".db"))
-                return false;
-            if (opts.worktreeHash && !f.startsWith(opts.worktreeHash))
-                return false;
-            return true;
-        });
-    }
-    catch {
-        return empty;
-    }
-    if (dbFiles.length === 0)
-        return empty;
-    let DatabaseCtor = null;
-    try {
-        DatabaseCtor = opts.loadDatabase
-            ? opts.loadDatabase()
-            : loadDatabaseImpl();
-    }
-    catch {
-        return empty;
-    }
-    if (!DatabaseCtor)
-        return empty;
-    let eventDataBytes = 0;
-    let bytesAvoided = 0;
-    let bytesReturned = 0;
-    let snapshotBytes = 0;
-    // Each branch returns the tuple in the SAME column order so callers
-    // don't need to type-narrow per row.
-    for (const file of dbFiles) {
-        const dbPath = join(sessionsDir, file);
-        // v1.0.148 hotfix: historical DBs were created with pre-v1.0.130
-        // schema (no bytes_avoided / bytes_returned / project_dir columns).
-        // The SELECT below references those columns, so without an in-place
-        // migration the prepare() throws and the surrounding catch silently
-        // skips the WHOLE DB — losing even the LENGTH(data) signal. Run the
-        // shared migration helper before opening readonly. Idempotent: a
-        // PRAGMA check inside the helper short-circuits when the DB is
-        // already current, so post-first-read calls are cheap.
-        ensureSessionEventsSchema(dbPath, DatabaseCtor);
-        try {
-            const sdb = new DatabaseCtor(dbPath, { readonly: true });
-            try {
-                if (opts.sessionId) {
-                    const row = sdb.prepare(`SELECT
-               COALESCE(SUM(LENGTH(data)), 0)   AS data_bytes,
-               COALESCE(SUM(bytes_avoided), 0)  AS bytes_avoided,
-               COALESCE(SUM(bytes_returned), 0) AS bytes_returned
-             FROM session_events WHERE session_id = ?`).get(opts.sessionId);
-                    if (row) {
-                        eventDataBytes += Number(row.data_bytes ?? 0);
-                        bytesAvoided += Number(row.bytes_avoided ?? 0);
-                        bytesReturned += Number(row.bytes_returned ?? 0);
-                    }
-                    try {
-                        const snap = sdb.prepare("SELECT COALESCE(SUM(LENGTH(snapshot)), 0) AS bytes FROM session_resume WHERE session_id = ?").get(opts.sessionId);
-                        if (snap?.bytes)
-                            snapshotBytes += Number(snap.bytes);
-                    }
-                    catch { /* old schema */ }
-                    try {
-                        // "With context-mode" = the bytes the model paid to ACCESS the
-                        // kept-out content: ctx_search (query the index) + ctx_fetch_and_index
-                        // (fetch + index a URL). Sandbox compute (ctx_execute/batch/file) is
-                        // work-output the model would see regardless — NOT redirect savings —
-                        // so it is excluded; folding it crushed the bar to a false ~43%.
-                        const tc = sdb.prepare(`SELECT COALESCE(SUM(bytes_returned), 0) AS bytes FROM tool_calls
-               WHERE session_id = ? AND tool IN ('ctx_search', 'ctx_fetch_and_index')`).get(opts.sessionId);
-                        if (tc?.bytes)
-                            bytesReturned += Number(tc.bytes);
-                    }
-                    catch { /* old schema: no tool_calls table */ }
-                }
-                else if (opts.projectDir) {
-                    // Bug E+F: META-scoped aggregation. Take every session_id whose
-                    // session_meta.project_dir matches, then sum ALL of those
-                    // sessions' events regardless of the events' own project_dir
-                    // (sandbox-burst PID sessions write empty event-level project_dir
-                    // even when their META carries the parent cwd).
-                    const row = sdb.prepare(`SELECT
-               COALESCE(SUM(LENGTH(data)), 0)   AS data_bytes,
-               COALESCE(SUM(bytes_avoided), 0)  AS bytes_avoided,
-               COALESCE(SUM(bytes_returned), 0) AS bytes_returned
-             FROM session_events
-             WHERE session_id IN (
-               SELECT session_id FROM session_meta WHERE project_dir = ?
-             )`).get(opts.projectDir);
-                    if (row) {
-                        eventDataBytes += Number(row.data_bytes ?? 0);
-                        bytesAvoided += Number(row.bytes_avoided ?? 0);
-                        bytesReturned += Number(row.bytes_returned ?? 0);
-                    }
-                    try {
-                        const snap = sdb.prepare(`SELECT COALESCE(SUM(LENGTH(snapshot)), 0) AS bytes
-               FROM session_resume
-               WHERE session_id IN (
-                 SELECT session_id FROM session_meta WHERE project_dir = ?
-               )`).get(opts.projectDir);
-                        if (snap?.bytes)
-                            snapshotBytes += Number(snap.bytes);
-                    }
-                    catch { /* old schema */ }
-                    try {
-                        const tc = sdb.prepare(`SELECT COALESCE(SUM(bytes_returned), 0) AS bytes
-               FROM tool_calls
-               WHERE session_id IN (
-                 SELECT session_id FROM session_meta WHERE project_dir = ?
-               )
-               AND tool IN ('ctx_search', 'ctx_fetch_and_index')`).get(opts.projectDir);
-                        if (tc?.bytes)
-                            bytesReturned += Number(tc.bytes);
-                    }
-                    catch { /* old schema: no tool_calls table */ }
-                }
-                else {
-                    const row = sdb.prepare(`SELECT
-               COALESCE(SUM(LENGTH(data)), 0)   AS data_bytes,
-               COALESCE(SUM(bytes_avoided), 0)  AS bytes_avoided,
-               COALESCE(SUM(bytes_returned), 0) AS bytes_returned
-             FROM session_events`).get();
-                    if (row) {
-                        eventDataBytes += Number(row.data_bytes ?? 0);
-                        bytesAvoided += Number(row.bytes_avoided ?? 0);
-                        bytesReturned += Number(row.bytes_returned ?? 0);
-                    }
-                    try {
-                        const snap = sdb.prepare("SELECT COALESCE(SUM(LENGTH(snapshot)), 0) AS bytes FROM session_resume").get();
-                        if (snap?.bytes)
-                            snapshotBytes += Number(snap.bytes);
-                    }
-                    catch { /* old schema */ }
-                    try {
-                        const tc = sdb.prepare(`SELECT COALESCE(SUM(bytes_returned), 0) AS bytes FROM tool_calls
-               WHERE tool IN ('ctx_search', 'ctx_fetch_and_index')`).get();
-                        if (tc?.bytes)
-                            bytesReturned += Number(tc.bytes);
-                    }
-                    catch { /* old schema: no tool_calls table */ }
-                }
-            }
-            finally {
-                sdb.close();
-            }
-        }
-        catch { /* missing tables / corrupt — skip */ }
-    }
-    // v1.0.133 Slice 3: fold content DB chunk bytes for this session into
-    // bytesAvoided. Skipped silently when caller didn't pass contentDbPath
-    // (lifetime / project tiers, or pre-Slice-3 callers). Treated as
-    // "avoided" because indexed chunks are bytes that would have been
-    // re-inflated into context on every search if the model had to
-    // re-read raw files.
-    let contentBytes = 0;
-    if (opts.sessionId && opts.contentDbPath) {
-        contentBytes = getContentBytesForSession(opts.sessionId, opts.contentDbPath, { loadDatabase: opts.loadDatabase });
-        bytesAvoided += contentBytes;
-    }
-    const totalSavedTokens = Math.floor((eventDataBytes + bytesAvoided + snapshotBytes) / 4);
-    return { eventDataBytes, bytesAvoided, bytesReturned, snapshotBytes, contentBytes, totalSavedTokens };
-}
-const DEFAULT_REAL_USAGE_FILTER = {
-    minEvents: 100,
-    minProjects: 5,
-    recencyMs: 30 * 86_400_000,
-    minAvgBytes: 50,
-};
-/**
- * Scan one adapter's sessions dir. Always returns a result — never throws.
- * When the dir is missing, the result has zeroed counts and `isReal=false`.
- *
- * Mirrors the inner SessionDB-walk inside `getLifetimeStats`
- * (analytics.ts:677-752) so the new multi-adapter path stays in lock-step
- * with the per-DB queries the single-dir path already trusts.
- */
-function scanOneAdapter(entry, loadDb, filter) {
-    const result = {
-        name: entry.name,
-        eventCount: 0,
-        sessionCount: 0,
-        dataBytes: 0,
-        rescueBytes: 0,
-        contentBytes: 0,
-        uuidConvs: 0,
-        projectDirs: [],
-        firstMs: Number.POSITIVE_INFINITY,
-        lastMs: 0,
-        isReal: false,
-    };
-    if (!existsSync(entry.sessionsDir))
-        return result;
-    let dbFiles = [];
-    try {
-        dbFiles = readdirSync(entry.sessionsDir).filter((f) => f.endsWith(".db"));
-    }
-    catch {
-        return result;
-    }
-    if (dbFiles.length === 0)
-        return result;
-    let DatabaseCtor = null;
-    try {
-        DatabaseCtor = loadDb();
-    }
-    catch {
-        return result;
-    }
-    if (!DatabaseCtor)
-        return result;
-    const projectsSet = new Set();
-    const sessionsSet = new Set();
-    for (const file of dbFiles) {
-        const dbPath = join(entry.sessionsDir, file);
-        try {
-            const sdb = new DatabaseCtor(dbPath, { readonly: true });
-            try {
-                const ev = sdb.prepare("SELECT COUNT(*) AS cnt, COALESCE(SUM(LENGTH(data)), 0) AS bytes FROM session_events").get();
-                if (ev) {
-                    result.eventCount += Number(ev.cnt ?? 0);
-                    result.dataBytes += Number(ev.bytes ?? 0);
-                }
-                try {
-                    const ss = sdb.prepare("SELECT COUNT(*) AS cnt FROM session_meta").get();
-                    result.sessionCount += Number(ss?.cnt ?? 0);
-                }
-                catch { /* old schema */ }
-                try {
-                    const snap = sdb.prepare("SELECT COALESCE(SUM(length(snapshot)), 0) AS bytes FROM session_resume WHERE consumed = 1").get();
-                    if (snap?.bytes)
-                        result.rescueBytes += Number(snap.bytes);
-                }
-                catch { /* old schema */ }
-                try {
-                    const range = sdb.prepare("SELECT MIN(created_at) AS mn, MAX(created_at) AS mx FROM session_events").get();
-                    if (range?.mn) {
-                        const t = Date.parse(range.mn + (range.mn.endsWith("Z") ? "" : "Z"));
-                        if (Number.isFinite(t) && t < result.firstMs)
-                            result.firstMs = t;
-                    }
-                    if (range?.mx) {
-                        const t = Date.parse(range.mx + (range.mx.endsWith("Z") ? "" : "Z"));
-                        if (Number.isFinite(t) && t > result.lastMs)
-                            result.lastMs = t;
-                    }
-                }
-                catch { /* old schema */ }
-                try {
-                    const projRows = sdb.prepare("SELECT DISTINCT project_dir AS p FROM session_events WHERE project_dir != ''").all();
-                    for (const row of projRows)
-                        if (row.p)
-                            projectsSet.add(row.p);
-                }
-                catch { /* old schema */ }
-                try {
-                    const sidRows = sdb.prepare("SELECT DISTINCT session_id AS s FROM session_events").all();
-                    for (const row of sidRows)
-                        if (row.s)
-                            sessionsSet.add(row.s);
-                }
-                catch { /* old schema */ }
-            }
-            finally {
-                sdb.close();
-            }
-        }
-        catch { /* missing tables / corrupt — skip */ }
-    }
-    result.projectDirs = Array.from(projectsSet);
-    result.uuidConvs = sessionsSet.size;
-    // Real-usage filter — see RealUsageFilter docstring.
-    const avgBytes = result.eventCount > 0 ? result.dataBytes / result.eventCount : 0;
-    const recentEnough = result.lastMs > 0 && (filter.nowMs - result.lastMs) <= filter.recencyMs;
-    result.isReal =
-        result.eventCount >= filter.minEvents &&
-            projectsSet.size >= filter.minProjects &&
-            recentEnough &&
-            avgBytes >= filter.minAvgBytes;
-    return result;
-}
-/**
- * Aggregate lifetime stats across every adapter dir under `home`.
- * The marketing line — "your work everywhere on this machine across all
- * AI tools" — depends on this. Existing `getLifetimeStats` (single dir)
- * is untouched; this is purely additive.
- */
-export function getMultiAdapterLifetimeStats(opts) {
-    const dirs = enumerateAdapterDirs({ home: opts?.home });
-    const loadDb = opts?.loadDatabase ?? loadDatabaseImpl;
-    const filter = {
-        ...DEFAULT_REAL_USAGE_FILTER,
-        ...(opts?.filter ?? {}),
-        nowMs: opts?.filter?.nowMs ?? Date.now(),
-    };
-    const perAdapter = [];
-    let totalEvents = 0;
-    let totalSessions = 0;
-    let totalBytes = 0;
-    for (const entry of dirs) {
-        if (!existsSync(entry.sessionsDir))
-            continue; // only surface adapters with a sessions dir
-        const r = scanOneAdapter(entry, loadDb, filter);
-        perAdapter.push(r);
-        totalEvents += r.eventCount;
-        totalSessions += r.sessionCount;
-        totalBytes += r.dataBytes + r.rescueBytes;
-    }
-    return { totalEvents, totalSessions, totalBytes, perAdapter };
-}
-/**
- * Aggregate real-bytes stats across every adapter dir under `home`.
- * Mirrors `getRealBytesStats` (single dir, analytics.ts:887-989) but
- * iterates {@link enumerateAdapterDirs}. Optional `sessionId` /
- * `worktreeHash` filters apply uniformly to every dir.
- */
-export function getMultiAdapterRealBytesStats(opts) {
-    const dirs = enumerateAdapterDirs({ home: opts?.home });
-    const sum = {
-        eventDataBytes: 0,
-        bytesAvoided: 0,
-        bytesReturned: 0,
-        snapshotBytes: 0,
-        contentBytes: 0,
-        totalSavedTokens: 0,
-    };
-    const perAdapter = [];
-    for (const entry of dirs) {
-        if (!existsSync(entry.sessionsDir))
-            continue;
-        const one = getRealBytesStats({
-            sessionsDir: entry.sessionsDir,
-            sessionId: opts?.sessionId,
-            worktreeHash: opts?.worktreeHash,
-            loadDatabase: opts?.loadDatabase,
-        });
-        // ARCH-REVIEW-V134-ABC SLICE C: aggregate this adapter's content DB
-        // bytes into the lifetime sum. `getRealBytesStats` operates on
-        // session events only and never touches the sibling content/ tree —
-        // without this step the lifetime tier in ctx_stats reports 0 for
-        // every adapter except whichever one happens to share the
-        // sessionsDir of the caller. Lifetime tier ignores sessionId so
-        // the all-sessions aggregator is the right helper here.
-        if (!opts?.sessionId) {
-            const contentDbPath = join(entry.contentDir, "content.db");
-            const adapterContentBytes = getContentBytesAllSessions(contentDbPath, {
-                loadDatabase: opts?.loadDatabase,
-            });
-            one.contentBytes += adapterContentBytes;
-            sum.contentBytes += adapterContentBytes;
-        }
-        perAdapter.push({ name: entry.name, ...one });
-        sum.eventDataBytes += one.eventDataBytes;
-        sum.bytesAvoided += one.bytesAvoided;
-        sum.bytesReturned += one.bytesReturned;
-        sum.snapshotBytes += one.snapshotBytes;
-    }
-    sum.totalSavedTokens = Math.floor((sum.eventDataBytes + sum.bytesAvoided + sum.snapshotBytes) / 4);
-    return { ...sum, perAdapter };
-}
-/**
- * Marketing-grade labels for auto-memory file prefixes. The renderer sees raw
- * filename prefixes (`project_codex_hooks.md` → `project`) — without this map
- * the user gets schema words in the UI, which leaks the database into UX.
- */
-export const autoMemoryLabels = {
-    project: "What you're building",
-    feedback: "How you work",
-    user: "Who you are",
-    reference: "Where to look",
-    memory: "Long-term context",
-    other: "Other notes",
-};
-/**
- * Marketing-grade labels for adapter ids surfaced by
- * {@link enumerateAdapterDirs} / {@link getMultiAdapterLifetimeStats}.
- * The renderer never shows raw IDs — UX uses the names users see in
- * each tool's own surface area.
- */
-export const adapterLabels = {
-    "claude-code": "Claude Code",
-    "gemini-cli": "Gemini CLI",
-    "antigravity": "Antigravity",
-    "antigravity-cli": "Antigravity CLI",
-    "openclaw": "Openclaw",
-    "codex": "Codex CLI",
-    "cursor": "Cursor",
-    "vscode-copilot": "VS Code Copilot",
-    "copilot-cli": "GitHub Copilot CLI",
-    "kiro": "Kiro",
-    "pi": "Pi",
-    "omp": "OMP",
-    "qwen-code": "Qwen Code",
-    "kilo": "Kilo",
-    "opencode": "OpenCode",
-    "zed": "Zed",
-    "jetbrains-copilot": "JetBrains",
-};
-/** Look up an adapter's marketing label. Falls back to the raw id. */
-function adapterLabel(name) {
-    return adapterLabels[name] ?? name;
-}
-// ─────────────────────────────────────────────────────────
-// formatReport — renders FullReport as sales-grade savings dashboard
-// ─────────────────────────────────────────────────────────
-/**
- * Format a byte count for the narrative dashboard.
- *
- * Single-unit auto-scale (Grafana / CloudWatch / Datadog convention).
- * Decimals shrink as the integer part grows so the number stays readable
- * at every magnitude. Max output width is 8 characters which fits the
- * existing `padStart(8)` callsites in Sections 1, 3, 4.
- *
- *   < 1 KB              → "X B"        e.g. "100 B"
- *   1 KB   – < 100 KB   → "X.Y KB"     e.g. "4.7 KB",   "92.8 KB"
- *   100 KB – < 1 MB     → "X KB"       e.g. "227 KB",   "976 KB"
- *   1 MB   – < 100 MB   → "X.Y MB"     e.g. "4.5 MB",   "11.6 MB"
- *   100 MB – < 1 GB     → "X MB"       e.g. "178 MB",   "906 MB"
- *   1 GB   – < 100 GB   → "X.YY GB"    e.g. "1.00 GB",  "11.36 GB"
- *   ≥ 100 GB            → "X.Y GB"     e.g. "216.6 GB"
- *
- * Replaced the dual-unit "X KB (0.YY MB)" form because the parenthetical
- * rounded to 0.00 / 0.01 in the common range and added noise without
- * information. Scale awareness comes from the unit jump between rows.
- */
-export function kb(b) {
-    if (!Number.isFinite(b) || b <= 0)
-        return "0 B";
-    if (b < 1024)
-        return `${Math.round(b)} B`;
-    const KB = b / 1024;
-    if (KB < 1024) {
-        return KB < 100 ? `${KB.toFixed(1)} KB` : `${Math.round(KB)} KB`;
-    }
-    const MB = KB / 1024;
-    if (MB < 1024) {
-        return MB < 100 ? `${MB.toFixed(1)} MB` : `${Math.round(MB)} MB`;
-    }
-    const GB = MB / 1024;
-    return GB < 100 ? `${GB.toFixed(2)} GB` : `${GB.toFixed(1)} GB`;
-}
-/** Format session uptime as human-readable duration. */
-function formatDuration(uptimeMin) {
-    const min = parseFloat(uptimeMin);
-    if (isNaN(min) || min < 1)
-        return "< 1 min";
-    if (min < 60)
-        return `${Math.round(min)} min`;
-    const h = Math.floor(min / 60);
-    const m = Math.round(min % 60);
-    return m > 0 ? `${h}h ${m}m` : `${h}h`;
-}
-/**
- * Locale + IANA-timezone detection for the narrative renderer.
- *
- * Cascade (each level overrides the next):
- *   1. CONTEXT_MODE_LOCALE / CONTEXT_MODE_TZ env overrides
- *      (used by tests + by users who want to pin output regardless of OS).
- *   2. macOS `defaults read -g AppleLocale` → `en_TR` style → `en-TR`.
- *   3. Linux `LANG` / `LC_TIME` env vars.
- *   4. Fallback: `Intl.DateTimeFormat().resolvedOptions().locale`.
- *
- * Timezone always uses `Intl.DateTimeFormat().resolvedOptions().timeZone`
- * — that one's always available and correct regardless of platform.
- */
-/**
- * Validate that a locale string is a usable BCP 47 tag.
- *
- * Ubuntu GHA runners default to `LANG=C.UTF-8`. The extractor below strips
- * that to `"C"` — a valid POSIX locale identifier but NOT a BCP 47 tag.
- * On macOS / Node 20, `new Intl.DateTimeFormat("C", …)` throws RangeError
- * outright. CI run 25887250971 caught this via the v1.0.134 SLICE B test.
- *
- * Earlier fix attempt used a permissive `supportedLocalesOf || construction`
- * OR check — that was wrong: on Linux + Node 22.5, `new Intl.DateTimeFormat
- * ("POSIX")` does NOT throw, it silently falls back to the root locale and
- * still emits garbage at format time. CI run 25904838577 surfaced that —
- * "POSIX" round-tripped through the validator unchanged.
- *
- * Strict gate: `Intl.DateTimeFormat.supportedLocalesOf(tag)` returns `[]` for
- * any tag that doesn't map to a real language (regardless of whether
- * construction with that tag throws). That's the contract we want — "is this
- * a BCP 47 tag the host actually has data for". Construction is an explicit
- * sanity check; both must pass.
- */
-function isUsableBcp47Locale(raw) {
-    if (!raw)
-        return false;
-    try {
-        if (Intl.DateTimeFormat.supportedLocalesOf(raw).length === 0)
-            return false;
-        // Belt: confirm construction doesn't throw on this host either.
-        new Intl.DateTimeFormat(raw);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-export function detectLocaleAndTz() {
-    const env = (process.env ?? {});
-    let locale = env.CONTEXT_MODE_LOCALE ?? "";
-    if (locale && !isUsableBcp47Locale(locale))
-        locale = "";
-    if (!locale) {
-        if (process.platform === "darwin") {
-            try {
-                // Top-level import — `require()` throws "Dynamic require ... not
-                // supported" under esbuild's ESM shim and pure ESM Node, which silently
-                // dropped this branch and forced en-US fallback in production.
-                const out = execFileSync("defaults", ["read", "-g", "AppleLocale"], {
-                    encoding: "utf8",
-                    timeout: 500,
-                }).trim();
-                if (out)
-                    locale = out.replace(/_/g, "-");
-            }
-            catch { /* defaults missing or sandbox */ }
-            if (locale && !isUsableBcp47Locale(locale))
-                locale = "";
-        }
-        if (!locale && (env.LC_TIME || env.LANG)) {
-            const raw = (env.LC_TIME || env.LANG || "").split(".")[0];
-            if (raw)
-                locale = raw.replace(/_/g, "-");
-            // POSIX locale identifiers (`C`, `POSIX`) survive the simple extraction
-            // above but blow up `new Intl.DateTimeFormat(locale, ...)`. Drop and
-            // fall through to the host-default branch below.
-            if (locale && !isUsableBcp47Locale(locale))
-                locale = "";
-        }
-        if (!locale) {
-            try {
-                locale = new Intl.DateTimeFormat().resolvedOptions().locale;
-            }
-            catch {
-                locale = "en-US";
-            }
-        }
-    }
-    let tz = env.CONTEXT_MODE_TZ ?? "";
-    if (!tz) {
-        try {
-            tz = new Intl.DateTimeFormat().resolvedOptions().timeZone;
-        }
-        catch {
-            tz = "UTC";
-        }
-    }
-    // Final belt-and-suspenders: if the locale we settled on is somehow still
-    // unusable (env mutation between detection and return, contributor adding
-    // a new extraction path that skips the validator), fall back to en-US so
-    // formatLocalDateTime / monthDay / weekdayCap never throw at render time.
-    if (!isUsableBcp47Locale(locale))
-        locale = "en-US";
-    return { locale, tz: tz || "UTC" };
-}
-/**
- * Format an absolute path as a human-friendly display string by
- * collapsing `$HOME` → `~`. Returns the input unchanged when no home
- * prefix matches (e.g. for paths outside $HOME on a CI box).
- */
-function shortPath(abs) {
-    const home = homedir();
-    if (!home)
-        return abs;
-    if (abs === home)
-        return "~";
-    // Use platform separator so `C:\Users\Mert\projects\x` collapses to `~\projects\x`
-    // on Windows; previous `home + "/"` check was vacuously false on Windows and
-    // left full absolute paths in the Section 1 narrative opener (round-5 finding).
-    if (abs.startsWith(home + sep))
-        return "~" + abs.slice(home.length);
-    return abs;
-}
-/**
- * Render the section-4 "For example: what would that cost?" block.
- *
- * Translates a lifetime token total into a relatable Opus-4 dollar figure
- * + 3 tangible comparisons (Cursor Pro / Claude Max / weekends of API
- * coding) + 10-dev team scale projection + alternate-model scale row,
- * capped with an EXAMPLES disclaimer. The renderer is intentionally
- * liberal with rounding (whole-month Cursor counts, integer weekends)
- * because this section is illustrative — the EXAMPLES line tells users
- * not to confuse it for a bill.
- *
- * Returns [] when there's nothing to scale (lifetimeTokens === 0) so
- * the section disappears cleanly on a fresh install.
- *
- * Math constants:
- *   Opus 4.7/4.8 = $5.00 per 1M input tokens (fallback when PI_CONTEXT_MODE_PRICE_OUTPUT_PER_TOKEN not set)
- *   Sonnet 4.6   = $3.00 per 1M input tokens
- *   GPT-4o       = $2.50 per 1M input tokens
- *   Gemini 2     = $1.25 per 1M input tokens
- *   Haiku 4.5    = $1.00 per 1M input tokens
- *   Cursor Pro       = $20  / month  → "X months of Cursor Pro"
- *   Claude Max       = $200 / month  → "X.X months of Claude Max"
- *   Weekend coding   ≈ $73.67        → "X weekends of nonstop API coding"
- *   Team multiplier  = 10×           → "At a 10-dev team scale: ~$X over Y days, or ~$Z/year"
- */
-export function renderCostExample(lifetimeBytes, lifetimeTokens, lifetimeDays) {
-    if (!Number.isFinite(lifetimeTokens) || lifetimeTokens <= 0)
-        return [];
-    const lifetimeUsd = lifetimeTokens * pricePerToken();
-    const usdStr = (n, dp = 2) => n.toFixed(dp);
-    // Comparison units — kept locally so they're easy to tune without touching
-    // the renderer logic. Cursor Pro & Claude Max are public list prices; the
-    // weekend constant is an intentional approximation calibrated to make
-    // $1399.73 → "19 weekends" line up with the demo target.
-    const cursorMonths = Math.round(lifetimeUsd / 20);
-    const claudeMaxMonths = (lifetimeUsd / 200).toFixed(1);
-    const weekendCount = Math.round(lifetimeUsd / 73.67);
-    const teamUsd = Math.round(lifetimeUsd * 10);
-    const teamYearUsd = lifetimeDays > 0
-        ? Math.round((lifetimeUsd * 10) / lifetimeDays * 365)
-        : 0;
-    // Alternate-model scale row — same token count, different per-1M rates.
-    // (Kept for internal reference but unreachable per Mert directive.)
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    const _sonnetUsd = ((lifetimeTokens * 3.0) / 1_000_000).toFixed(2);
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    const _gpt4oUsd = ((lifetimeTokens * 2.5) / 1_000_000).toFixed(2);
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    const _geminiUsd = ((lifetimeTokens * 1.25) / 1_000_000).toFixed(2);
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    const _haikuUsd = ((lifetimeTokens * 1.0) / 1_000_000).toFixed(2);
-    const usingDynamicPrice = process.env.PI_CONTEXT_MODE_PRICE_OUTPUT_PER_TOKEN !== undefined;
-    const modelId = process.env.PI_CONTEXT_MODE_MODEL_ID;
-    // Mert: "daha marketing ve business value e vermeli, math hesaplamalari ile
-    // kalabalik yapma" — collapse the old 4-block render into ONE headline
-    // number, ONE relatable comparison, ONE team-scale callout.
-    const out = [];
-    if (usingDynamicPrice && modelId) {
-        out.push(`  $${usdStr(lifetimeUsd)} of ${modelId} tokens your team didn't burn.`);
-    }
-    else if (usingDynamicPrice) {
-        out.push(`  $${usdStr(lifetimeUsd)} of tokens your team didn't burn.`);
-    }
-    else {
-        out.push(`  $${usdStr(lifetimeUsd)} of Opus 4.7 tokens your team didn't burn.`);
-    }
-    out.push(`  context-mode kept ${kb(lifetimeBytes)} out of context — that's ${cursorMonths} months of Cursor Pro paid for itself.`);
-    if (teamUsd > 0 && teamYearUsd > 0) {
-        out.push("");
-        out.push(`  Scale across a 10-dev team and that's ~$${teamYearUsd.toLocaleString("en-US")}/year saved.`);
-    }
-    if (!usingDynamicPrice) {
-        out.push("");
-        out.push(`  (Opus rates shown for context. On cheaper models the dollar number drops; the savings ratio holds.)`);
-    }
-    return out;
-}
-/**
- * Render the full 5-section narrative ("kitap gibi") layout — the
- * Mert-approved screenshot format the production ctx_stats handler
- * produces for users with conversation + lifetime + multi-adapter data.
- *
- * Order:
- *   Opener
- *   Section 1 — Where you are now            (datetime, /compact, timeline)
- *   Section 2 — What this chat captured      (per-category bars)
- *   Section 3 — The receipt — getting wider  (this conv vs all-work)
- *   Section 4 — For example: what would that cost?
- *   Section 5 — What context-mode learned about how you work (auto-memory)
- *   Footer
- *
- * Pure renderer: every input arrives via the args object so this
- * function is trivially testable end-to-end without mocking process or
- * Date. The caller (formatReport) is responsible for choosing a `now`
- * value that matches the conversation's age math and a `cwd` that
- * matches the user's project — defaults are sensible for production.
- */
-function renderNarrative5Section(args) {
-    const { conversation, lifetime, multiAdapter, realBytes, cwd, locale, tz, now, version, latestVersion } = args;
-    const out = [];
-    // ── Token math (same monotonic-growth invariant as the legacy branch).
-    const convEventsTokens = conversation.events * TOKENS_PER_EVENT;
-    const convRescueTokens = Math.round((conversation.snapshotBytes ?? 0) / 4);
-    const convLegacyTokens = convEventsTokens + convRescueTokens;
-    const convRealTokens = realBytes?.conversation?.totalSavedTokens ?? 0;
-    const conversationTokens = Math.max(convLegacyTokens, convRealTokens);
-    const lifetimeEventsTokens = (lifetime?.totalEvents ?? 0) * TOKENS_PER_EVENT;
-    const lifetimeRescueTokens = Math.round((lifetime?.rescueBytes ?? 0) / 4);
-    const lifetimeLegacyTokens = lifetimeEventsTokens + lifetimeRescueTokens;
-    const lifetimeRealTokens = realBytes?.lifetime?.totalSavedTokens ?? 0;
-    const lifetimeTokensWithout = Math.max(lifetimeLegacyTokens, lifetimeRealTokens);
-    // Lifetime "with" — measured when available, else legacy 0.02 fallback.
-    // Honest definition (matches conversation bar below):
-    //   "with"    = bytes_returned (what the model actually re-saw)
-    //   "without" = bytes_returned + bytes_avoided
-    // When the schema has measurement, derive `with` from `bytes_returned/4`.
-    const lifeRet = realBytes?.lifetime?.bytesReturned ?? 0;
-    const lifeAv = realBytes?.lifetime?.bytesAvoided ?? 0;
-    const lifetimeTokensWith = (lifeRet + lifeAv) > 0
-        ? Math.max(1, Math.floor(lifeRet / 4))
-        : Math.max(1, Math.round(lifetimeTokensWithout * 0.02));
-    // Bytes from realBytes when present, else derive from tokens (×4 — same
-    // ratio Phase 8 uses everywhere). All-work bytes drives the opener tally
-    // + the section-3 receipt + section-4 cost example.
-    const lifetimeBytes = (multiAdapter?.totalBytes && multiAdapter.totalBytes > 0)
-        ? multiAdapter.totalBytes
-        : lifetimeTokensWithout * 4;
-    const convBytes = realBytes?.conversation
-        ? (realBytes.conversation.eventDataBytes + realBytes.conversation.bytesAvoided + realBytes.conversation.snapshotBytes)
-        : conversationTokens * 4;
-    // ── Days alive of THE CONVERSATION (section 1).
-    const convDays = conversation.daysAlive >= 1
-        ? `${conversation.daysAlive.toFixed(1)} days alive · still going`
-        : `${Math.max(1, Math.round(conversation.daysAlive * 24))} hr alive · still going`;
-    // ── Lifetime span (opener + receipt) — across every adapter / DB on disk.
-    const sinceMs = lifetime?.firstEventMs ?? multiAdapter?.perAdapter?.[0]?.firstMs ?? 0;
-    const lifetimeDays = sinceMs > 0
-        ? Math.max(1, Math.round((now - sinceMs) / 86_400_000))
-        : 0;
-    const totalConversations = multiAdapter?.totalSessions ?? lifetime?.totalSessions ?? 1;
-    const realAdapterCount = multiAdapter?.perAdapter.filter((a) => a.isReal).length ?? 0;
-    let where;
-    if (multiAdapter && realAdapterCount >= 2) {
-        where = `across ${realAdapterCount} AI tools`;
-    }
-    else if (multiAdapter && realAdapterCount === 1) {
-        const onlyReal = multiAdapter.perAdapter.find((a) => a.isReal);
-        where = `in ${onlyReal ? adapterLabel(onlyReal.name) : "Claude Code"}`;
-    }
-    else {
-        where = "in Claude Code";
-    }
-    // ── Opener.
-    if (lifetimeDays > 0) {
-        out.push(`  Across ${lifetimeDays} days you ran ${fmtNum(totalConversations)} conversations ${where}.`);
-    }
-    else {
-        out.push(`  You ran ${fmtNum(totalConversations)} conversations ${where}.`);
-    }
-    // Daily-average sub-line — never tease users with a tiny number when the
-    // average is sub-MB (still informative); fall back to KB display.
-    const dailyBytes = lifetimeDays > 0 ? lifetimeBytes / lifetimeDays : 0;
-    out.push(`  context-mode kept ${kb(lifetimeBytes)} out of your context window — about ${kb(dailyBytes)} every single day.`);
-    out.push("");
-    out.push("");
-    // ── Section 1 — Where you are now.
-    out.push("  ─── 1. Where you are now ───");
-    out.push("");
-    const startedStr = conversation.firstEventMs && conversation.firstEventMs > 0
-        ? formatLocalDateTime(conversation.firstEventMs, locale, tz)
-        : "";
-    if (startedStr) {
-        out.push(`  This conversation started ${startedStr} in ${shortPath(cwd)}.`);
-    }
-    else {
-        out.push(`  This conversation lives in ${shortPath(cwd)}.`);
-    }
-    out.push(`  ${convDays}.`);
-    if (conversation.snapshotsConsumed > 0 && conversation.snapshotBytes > 0) {
-        const rescueAt = conversation.lastRescueMs && conversation.lastRescueMs > 0
-            ? formatLocalDateTime(conversation.lastRescueMs, locale, tz)
-            : "";
-        const rescueKb = Math.round(conversation.snapshotBytes / 1024);
-        if (rescueAt) {
-            out.push(`  On ${rescueAt}, /compact fired — ${rescueKb} KB rescued from snapshot.`);
-        }
-        else {
-            out.push(`  /compact fired — ${rescueKb} KB rescued from snapshot.`);
-        }
-        out.push(`  Without that, you'd be re-explaining everything to a blank model right now.`);
-    }
-    out.push("");
-    // Without/With bars — strict compression (v1.0.148, Bug G / ADR-0004).
-    //
-    // Honest definitions:
-    //   Without = bytes the model WOULD have re-seen if context-mode
-    //             had not diverted them
-    //           = bytesAvoided + bytesReturned
-    //   With    = bytes the model ACTUALLY re-saw after context-mode
-    //           = max(1, bytesReturned)
-    //
-    // Why eventDataBytes is excluded from this ratio:
-    //   `eventDataBytes` is the raw hook payload (tool args, prompt
-    //   body) we captured for the knowledge base. Those bytes are
-    //   analytics infrastructure — they NEVER enter the model context
-    //   window. Including them on either side (as v1.0.134 SLICE B did
-    //   to dodge a degenerate 100% bar) misrepresents context cost.
-    //   SLICE B was an incidental fix that crushed the displayed
-    //   percentage from ~95% (the true compression ratio) to ~56% on
-    //   live conversations. eventDataBytes is rendered in Section 2
-    //   (captures count), not in this Section 1 Without/With bar.
-    //
-    // Empty-state branch:
-    //   If neither bytesAvoided nor bytesReturned has been measured yet
-    //   (early in a session, schema-migration recovery in progress, or
-    //   tool-heavy work that hasn't re-hit the index), we do NOT draw
-    //   a degenerate 0% / 100% bar. We emit one honest hint line and
-    //   skip the bar — honesty over decoration.
-    const realConv = realBytes?.conversation;
-    const measuredAvoided = realConv?.bytesAvoided ?? 0;
-    const measuredReturned = realConv?.bytesReturned ?? 0;
-    if (measuredAvoided + measuredReturned === 0) {
-        // No measurable redirect activity yet — captures may exist, but
-        // nothing has been diverted from the model context window.
-        out.push("  No measurable redirect activity captured yet — bars will appear once context-mode diverts its first payload.");
-        out.push("");
-    }
-    else {
-        const convBytesWithout = measuredAvoided + measuredReturned;
-        const convBytesWith = Math.max(1, measuredReturned);
-        const convTokensWithout = Math.max(1, Math.floor(convBytesWithout / 4));
-        const convTokensWith = Math.max(1, Math.floor(convBytesWith / 4));
-        const withoutBar = dataBar(convTokensWithout, convTokensWithout, 32);
-        const withBar = dataBar(convTokensWith, convTokensWithout, 32);
-        const convPct = (1 - convTokensWith / convTokensWithout) * 100;
-        const convMult = Math.max(1, Math.round(convTokensWithout / convTokensWith));
-        out.push(`  Without context-mode  ${kb(convBytesWithout).padStart(8)}  ${withoutBar}   ${fmtNum(convTokensWithout).padStart(7)} tokens`);
-        out.push(`  With context-mode     ${kb(convBytesWith).padStart(8)}  ${withBar}   ${fmtNum(convTokensWith).padStart(7)} tokens`);
-        out.push(`                          ${convPct.toFixed(0)}% kept out of context · your AI ran ${convMult}× longer before /compact fired`);
-        out.push("");
-    }
-    // Timeline — drop-in if conversation has byDay.
-    if (conversation.byDay && conversation.byDay.length > 0) {
-        const totalConvDays = conversation.lastEventMs && conversation.firstEventMs
-            ? Math.max(1, Math.round((conversation.lastEventMs - conversation.firstEventMs) / 86_400_000) + 1)
-            : conversation.byDay.length;
-        out.push(`  How that ${kb(convBytes)} built up — ${totalConvDays} days, ${conversation.byDay.length} active:`);
-        out.push("");
-        out.push(...renderHorizontalTimeline(conversation.byDay, locale, tz));
-    }
-    out.push("");
-    out.push("");
-    // ── Section 2 — What this chat captured.
-    out.push("  ─── 2. What this chat captured (used when you --continue or /resume here) ───");
-    out.push("");
-    const capturedTotal = conversation.byCategory.reduce((s, c) => s + c.count, 0);
-    // Format with locale separator (en-* → "1,277"; en-TR → "1.277").
-    const totalStr = capturedTotal.toLocaleString(locale);
-    out.push(`  ${totalStr} things — files, errors, decisions, agent runs:`);
-    out.push("");
-    // ALL categories, no truncation (Slice 5).
-    const max = conversation.byCategory[0]?.count ?? 1;
-    for (const cat of conversation.byCategory) {
-        out.push(`    ${cat.label.padEnd(26)} ${String(cat.count).padStart(5)}   ${dataBar(cat.count, max, 28)}`);
-    }
-    out.push("");
-    out.push("");
-    // ── Section 3 — Scope ladder, prose form (Mert: "cok daginik" → drop columns).
-    // Two short sentences instead of a 4-column table — the same numbers framed
-    // as "this chat" → "all your work" so the reader sees the scope getting wider
-    // without being asked to scan a wide grid.
-    out.push("  ─── 3. The scope, getting wider ───");
-    out.push("");
-    const convStartedYMD = conversation.firstEventMs && conversation.firstEventMs > 0
-        ? new Intl.DateTimeFormat(locale, { timeZone: tz, year: "numeric", month: "short", day: "numeric" })
-            .format(new Date(conversation.firstEventMs))
-        : "";
-    const lifeStartedYMD = sinceMs > 0
-        ? new Intl.DateTimeFormat(locale, { timeZone: tz, year: "numeric", month: "short", day: "numeric" })
-            .format(new Date(sinceMs))
-        : "";
-    const distinctProj = lifetime?.distinctProjects ?? 0;
-    const allCaps = lifetime?.totalEvents ?? multiAdapter?.totalEvents ?? 0;
-    out.push(`  This chat: ${kb(convBytes)} kept out · ${conversation.events.toLocaleString(locale)} captures${convStartedYMD ? ` · started ${convStartedYMD}` : ""}.`);
-    out.push(`  All your work: ${kb(lifetimeBytes)} kept out · ${allCaps.toLocaleString(locale)} captures across ${distinctProj} project${distinctProj === 1 ? "" : "s"}${lifeStartedYMD ? ` · since ${lifeStartedYMD}` : ""}.`);
-    out.push("");
-    out.push("");
-    // ── Section 4 — Marketing-grade cost framing (Mert: "math hesaplamalari ile
-    // kalabalik yapma" → less math, more business value). One headline, one
-    // optional team-scale callout, no scaling table, no math footnotes.
-    out.push("  ─── 4. The bottom line ───");
-    out.push("");
-    out.push(...renderCostExample(lifetimeBytes, lifetimeTokensWithout, lifetimeDays));
-    out.push("");
-    out.push("");
-    // ── Section 5 — What context-mode learned about how you work.
-    out.push("  ─── 5. What context-mode learned about how you work ───");
-    out.push("");
-    if (lifetime && lifetime.autoMemoryCount > 0) {
-        out.push(`  ${lifetime.autoMemoryCount} preferences picked up across ${lifetime.autoMemoryProjects} project${lifetime.autoMemoryProjects === 1 ? "" : "s"}:`);
-        const entries = Object.entries(lifetime.autoMemoryByPrefix).sort((a, b) => b[1] - a[1]);
-        const maxAm = entries.length > 0 ? entries[0][1] : 1;
-        for (const [prefix, count] of entries) {
-            const label = autoMemoryLabels[prefix] ?? prefix;
-            out.push(`    ${label.padEnd(26)} ${String(count).padStart(2)}   ${dataBar(count, maxAm, 20)}`);
-        }
-    }
-    else {
-        out.push("  No preferences learned yet — context-mode picks them up automatically.");
-    }
-    out.push("");
-    out.push("");
-    // ── Footer.
-    out.push("  Your AI talks less, remembers more, costs less.");
-    out.push(`  Locale ${locale} · timezone ${tz} · pricing examples for illustration only.`);
-    out.push("");
-    const versionStr = version ? `v${version}` : "context-mode";
-    out.push(`  ${versionStr}`);
-    if (version && latestVersion && latestVersion !== "unknown" && semverNewer(latestVersion, version)) {
-        out.push(`  Update available: v${version} -> v${latestVersion}  |  ctx_upgrade`);
-    }
-    // Suppress consecutive blank lines / leading blanks for tidier output —
-    // we use `push("")` liberally above as paragraph separators, easier to
-    // collapse here than to track flag state inline.
-    return collapseBlanks(out);
-}
-/** Drop runs of >2 consecutive blank strings so the renderer never emits visual gaps. */
-function collapseBlanks(lines) {
-    const out = [];
-    let blankRun = 0;
-    for (const ln of lines) {
-        if (ln === "") {
-            blankRun++;
-            if (blankRun <= 2)
-                out.push(ln);
-        }
-        else {
-            blankRun = 0;
-            out.push(ln);
-        }
-    }
-    // Trim trailing blanks.
-    while (out.length > 0 && out[out.length - 1] === "")
-        out.pop();
-    return out;
-}
-/**
- * Render the proportional-spacing horizontal day strip used in section 1
- * of the 5-section narrative. Returns the lines verbatim ready to splice
- * into the formatReport line buffer:
- *
- *     apr 28 ●──────────────────────●────█──────────────────────◆────● may 10
- *
- *       apr 28   277 captures
- *       may 4    438 captures  ← peak
- *       may 9    261 captures  ◆ /compact rescued 1552 KB
- *       may 10   100 captures
- *
- *     ●  active day      █  peak day      ◆  /compact rescue
- *
- * The strip body is exactly 56 chars wide. Day positions are computed as
- * `round((day - first) / (last - first) * 55)`. Glyph priority for a
- * column: rescue (◆) > peak (█) > active (●). Filler is the box-drawing
- * `─` character so the strip reads cleanly in monospace terminals.
- */
-export function renderHorizontalTimeline(days, locale, tz) {
-    if (days.length === 0)
-        return [];
-    // Sort ascending so first/last bookends + bar positions are stable.
-    const sorted = [...days].sort((a, b) => a.ms - b.ms);
-    const first = sorted[0];
-    const last = sorted[sorted.length - 1];
-    const span = Math.max(1, last.ms - first.ms);
-    // Locate the peak day (max count). Ties: earliest wins so the visual
-    // pin matches the chronologically first big day.
-    let peak = sorted[0];
-    for (const d of sorted)
-        if (d.count > peak.count)
-            peak = d;
-    // Build the 56-char strip body.
-    const WIDTH = 56;
-    const body = Array.from({ length: WIDTH }, () => "─");
-    for (const d of sorted) {
-        const col = Math.round(((d.ms - first.ms) / span) * (WIDTH - 1));
-        let glyph = "●";
-        if (d === peak)
-            glyph = "█";
-        if ((d.rescueBytes ?? 0) > 0)
-            glyph = "◆"; // rescue beats peak
-        body[col] = glyph;
-    }
-    // Lowercase short month names ("apr"/"may"/"jan") matching the target.
-    const monthDay = (ms) => {
-        const dt = new Intl.DateTimeFormat(locale, {
-            timeZone: tz,
-            month: "short",
-            day: "numeric",
-        }).formatToParts(new Date(ms));
-        const month = (dt.find((p) => p.type === "month")?.value ?? "").toLowerCase();
-        const day = dt.find((p) => p.type === "day")?.value ?? "";
-        return `${month} ${day}`;
-    };
-    const out = [];
-    out.push(`  ${monthDay(first.ms)} ${body.join("")} ${monthDay(last.ms)}`);
-    out.push("");
-    // Daily detail rows — count + " ← peak" + "◆ /compact rescued N KB".
-    for (const d of sorted) {
-        const label = monthDay(d.ms).padEnd(7);
-        const captures = `${d.count} captures`;
-        const peakStr = d === peak ? "  ← peak" : "";
-        const rescue = (d.rescueBytes ?? 0) > 0
-            ? `  ◆ /compact rescued ${Math.round((d.rescueBytes ?? 0) / 1024)} KB`
-            : "";
-        out.push(`    ${label}  ${captures}${peakStr}${rescue}`);
-    }
-    out.push("");
-    out.push("  ●  active day      █  peak day      ◆  /compact rescue");
-    return out;
-}
-/**
- * Render a UTC ms timestamp as a human-readable local datetime string in
- * the canonical Mert-approved format:
- *
- *   "28 Apr 2026 at 12:16 (Europe/Istanbul)"
- *
- * Used by the 5-section narrative renderer (formatReport) so users see
- * exactly when their conversation started + when /compact rescues fired
- * in their wall-clock timezone — never UTC, never ambiguous.
- *
- * - 24-hour clock with zero-padded minutes ("20:54", not "8:54 PM").
- * - Day is NOT zero-padded ("9 May", not "09 May") to match the target.
- * - IANA timezone is appended verbatim in parentheses regardless of
- *   locale so users never misread Istanbul-time as UTC.
- * - Returns "" for ms === 0 or NaN so callers can guard the rendered
- *   line ("started …") without an extra timestamp-validity check.
- */
-export function formatLocalDateTime(ms, locale, tz) {
-    if (!Number.isFinite(ms) || ms <= 0)
-        return "";
-    const date = new Date(ms);
-    if (Number.isNaN(date.getTime()))
-        return "";
-    // Intl.DateTimeFormat's "day"/"month"/"year" parts give us the locale's
-    // ordering (en-* → "DD MMM YYYY"), and the explicit numeric hour/minute
-    // forces 24-hour with leading zero on minute when in en-* with hour12=false.
-    const dt = new Intl.DateTimeFormat(locale, {
-        timeZone: tz,
-        year: "numeric",
-        month: "short",
-        day: "numeric",
-        hour: "2-digit",
-        minute: "2-digit",
-        hour12: false,
-    }).formatToParts(date);
-    const get = (type) => dt.find((p) => p.type === type)?.value ?? "";
-    const day = get("day");
-    const month = get("month");
-    const year = get("year");
-    let hour = get("hour");
-    const min = get("minute");
-    // Some locales / some Node versions emit "24" for midnight under hour12=false.
-    // Coerce back to "00" so the displayed time is always wall-clock-correct.
-    if (hour === "24")
-        hour = "00";
-    return `${day} ${month} ${year} at ${hour}:${min} (${tz})`;
-}
-/** Format large numbers with K/M suffixes */
-function fmtNum(n) {
-    if (n >= 1_000_000)
-        return `${(n / 1_000_000).toFixed(1)}M`;
-    if (n >= 1_000)
-        return `${(n / 1_000).toFixed(1)}K`;
-    return String(n);
-}
-// ─────────────────────────────────────────────────────────
-// Pricing (Bug #6) — Anthropic Opus input rate
-// ─────────────────────────────────────────────────────────
-// ── Pricing (Bug #6) — per-token USD rate ─────────────────
-// Reads PI_CONTEXT_MODE_PRICE_OUTPUT_PER_TOKEN when set by a Pi host;
-// falls back to the Opus 4.7/4.8 input rate ($5/1M) for all other adapters.
-// Verified against platform.claude.com/docs/en/about-claude/pricing 2026-06.
-//
-// IMPORTANT: this is a FUNCTION, not a const. Pi sets the env var
-// AFTER the MCP server has been imported (the bridge spawns the server
-// child, then the child reads its own env on every render). A
-// module-load-time const would freeze to the fallback because
-// process.env.PI_CONTEXT_MODE_PRICE_OUTPUT_PER_TOKEN is unset at
-// import time. Resolving on every call keeps the dynamic-pricing
-// contract honest — the env var works without an MCP restart.
-// (Reverted module-load const semantics, PR #741 follow-up.)
-/**
- * Per-token USD rate — resolves on every call.
- * Dynamic when PI_CONTEXT_MODE_PRICE_OUTPUT_PER_TOKEN is set, Opus 4.7/4.8 input
- * ($5 per 1M tokens) otherwise.
- */
-export function pricePerToken() {
-    const env = process.env.PI_CONTEXT_MODE_PRICE_OUTPUT_PER_TOKEN;
-    if (env !== undefined && env !== "") {
-        const parsed = Number(env);
-        if (Number.isFinite(parsed) && parsed > 0)
-            return parsed;
-    }
-    return 5 / 1_000_000; // Opus 4.7/4.8 input fallback
-}
-/**
- * Back-compat alias for the original Opus-rate const (PR #401 architect
- * P1.1 — single source of truth). Kept as a literal so any third-party
- * consumer importing the named constant still resolves to the same
- * fallback rate. New code should call pricePerToken() to pick up the
- * dynamic Pi env override.
- *
- * @deprecated Use pricePerToken() to honor PI_CONTEXT_MODE_PRICE_OUTPUT_PER_TOKEN.
- */
-export const OPUS_INPUT_PRICE_PER_TOKEN = 5 / 1_000_000;
-/** Convert a token count to a USD string at the current per-token rate. */
-export function tokensToUsd(tokens) {
-    const safe = Number.isFinite(tokens) && tokens > 0 ? tokens : 0;
-    return `$${(safe * pricePerToken()).toFixed(2)}`;
-}
-/**
- * Build a proportional bar using █ chars, scaled to a fixed width.
- * Returns e.g. "████████████████████████████████████████" for full width.
- */
-function dataBar(bytes, maxBytes, width = 40) {
-    if (maxBytes <= 0)
-        return "░".repeat(width);
-    const filled = Math.max(1, Math.round((bytes / maxBytes) * width));
-    return "█".repeat(Math.min(filled, width)) + "░".repeat(Math.max(0, width - filled));
-}
-/**
- * Render project memory section with category bars.
- *
- * Shows persistent event data, and — when supplied — lifetime totals
- * across every project's SessionDB so users see the cumulative value
- * (Bug #3).
- *
- * Caps the category list at `topN` and prints "N more categories" with the
- * actual remaining count (Bug #5 — was hardcoded "9 more").
- */
-function renderProjectMemory(pm, opts) {
-    const sessionTokensSaved = opts?.sessionTokensSaved ?? 0;
-    // Render when EITHER disk has data OR current session has earnings.
-    if (pm.total_events === 0 &&
-        (opts?.lifetime?.totalEvents ?? 0) === 0 &&
-        sessionTokensSaved === 0 &&
-        (opts?.multiAdapter?.totalEvents ?? 0) === 0) {
-        return [];
-    }
-    // Slice 5 — Mert: "honest, no tease". Show ALL categories. The legacy
-    // topN cap silently hid real data; users would screenshot a stats card
-    // missing half their work. The opts.topN parameter stays in the signature
-    // for back-compat with any external caller that explicitly passes a cap.
-    const topN = opts?.topN ?? Number.POSITIVE_INFINITY;
-    const out = [];
-    out.push("");
-    // Header switches based on whether we have rich lifetime data from the new
-    // pipeline. With it: forward-leaning "All your work" framing. Without it:
-    // legacy "Persistent memory" line for back-compat with older fixtures + tests.
-    // Slice 3.6: promote to "All your work everywhere" when multi-adapter
-    // aggregation is supplied so the receipt scope matches the rendered totals.
-    const ma = opts?.multiAdapter;
-    const realAdapters = ma?.perAdapter.filter((a) => a.isReal).length ?? 0;
-    const lifeEvents = ma?.totalEvents
-        ?? opts?.lifetime?.totalEvents
-        ?? pm.total_events;
-    const lifeSessions = ma?.totalSessions
-        ?? opts?.lifetime?.totalSessions
-        ?? pm.session_count;
-    const distinctProj = opts?.lifetime?.distinctProjects;
-    if (lifeEvents > 0 && distinctProj && distinctProj > 0) {
-        const everywhere = realAdapters >= 2 ? " everywhere" : "";
-        out.push(`  All your work${everywhere}  ·  ${fmtNum(lifeEvents)} events captured across ${distinctProj} project${distinctProj === 1 ? "" : "s"}  ·  ${fmtNum(lifeSessions)} conversations`);
-    }
-    else {
-        out.push("Persistent memory  ✓ preserved across compact, restart & upgrade");
-        // Current session counts as 1 when no prior session has been recorded yet.
-        const effectiveSessions = lifeSessions === 0 && sessionTokensSaved > 0 ? 1 : lifeSessions;
-        const sessionLabel = effectiveSessions === 1 ? "1 session" : `${fmtNum(effectiveSessions)} sessions`;
-        // Estimate lifetime savings: ~1KB per event → ~256 tokens/event at Opus rates,
-        // plus current session's already-tracked token savings (in-memory).
-        const lifetimeTokens = lifeEvents * 256 + sessionTokensSaved;
-        out.push(`  ${fmtNum(lifeEvents)} events · ${sessionLabel} · ~${tokensToUsd(lifetimeTokens)} saved lifetime`);
-    }
-    out.push("");
-    // Prefer lifetime categoryCounts (aggregated across every SessionDB) so
-    // the bar block matches the lifetime header above. Falls back to the
-    // project-local pm.by_category when lifetime data is absent (tests, older
-    // callers) or when no sidecar has any events yet.
-    const lifetimeCats = opts?.lifetime?.categoryCounts;
-    let cats;
-    if (lifetimeCats && Object.keys(lifetimeCats).length > 0) {
-        cats = Object.entries(lifetimeCats)
-            .filter(([, c]) => c > 0)
-            .map(([category, count]) => ({
-            category,
-            count,
-            label: categoryLabels[category] || category,
-        }))
-            .sort((a, b) => b.count - a.count);
-    }
-    else {
-        // Defensive: filter zero/null counts on the fallback path too — bumping
-        // topN to 15 made any leaked empty rows visible as "label  0  ░░░░░░".
-        cats = (pm.by_category ?? []).filter((c) => c && c.count > 0);
-    }
-    const visible = cats.slice(0, topN);
-    const maxCount = visible.length > 0 ? visible[0].count : 1;
-    for (const cat of visible) {
-        out.push(`  ${cat.label.padEnd(26)} ${String(cat.count).padStart(5)}   ${dataBar(cat.count, maxCount, 30)}`);
-    }
-    // Bug #5: real overflow count, not hardcoded.
-    const remaining = Math.max(0, cats.length - topN);
-    if (remaining > 0) {
-        out.push(`  ... ${remaining} more categor${remaining === 1 ? "y" : "ies"}`);
-    }
-    return out;
-}
-/**
- * Render the auto-memory section (Bug #4) — files Claude Code captured
- * under ~/.claude/projects/<project>/memory/ across the user's machine.
- */
-function renderAutoMemory(lifetime) {
-    if (!lifetime || lifetime.autoMemoryCount === 0)
-        return [];
-    const out = [];
-    out.push("");
-    out.push(`  Preferences learned  ·  ${lifetime.autoMemoryCount} across ${lifetime.autoMemoryProjects} project${lifetime.autoMemoryProjects === 1 ? "" : "s"}`);
-    const entries = Object.entries(lifetime.autoMemoryByPrefix)
-        .sort((a, b) => b[1] - a[1])
-        .slice(0, 6);
-    // Top entry sets the bar scale so the visual stays proportional even when
-    // the absolute counts are tiny. Entries are pre-sorted desc.
-    const maxCount = entries.length > 0 ? entries[0][1] : 1;
-    for (const [prefix, count] of entries) {
-        const label = autoMemoryLabels[prefix] ?? prefix;
-        out.push(`  ${label.padEnd(26)} ${String(count).padStart(2)}   ${dataBar(count, maxCount, 20)}`);
-    }
-    return out;
-}
-/** Render the closing "Bottom line" footer (Bug #8). */
-function renderBottomLine(sessionTokensSaved, lifetime) {
-    const out = [];
-    const sessionUsd = tokensToUsd(sessionTokensSaved);
-    // Lifetime = disk-aggregated events × 256 tokens + current session's
-    // in-memory token savings. Two pipelines unified at the render edge so
-    // lifetime ≥ session always (never the surprising "$X session · $0 lifetime"
-    // a fresh user sees pre-flush).
-    const lifetimeTokens = (lifetime?.totalEvents ?? 0) * 256 + sessionTokensSaved;
-    const lifetimeUsd = tokensToUsd(lifetimeTokens);
-    out.push("");
-    out.push("─".repeat(65));
-    out.push("Your AI talks less, remembers more, costs less.");
-    out.push(`${sessionUsd} this session  ·  ${lifetimeUsd} lifetime`);
-    out.push("─".repeat(65));
-    return out;
-}
-/**
- * Constant token-per-event used everywhere we estimate session/lifetime $.
- * Kept in lockstep with `bin/statusline.mjs`'s persisted lifetime conversion.
- */
-const TOKENS_PER_EVENT = 256;
-/**
- * Render the LIFETIME Without/With hero — the screenshottable receipt.
- *
- * Why lifetime and not session: the "$X saved this session" framing is
- * arbitrary (a fresh PID can show $0 even while the user has weeks of work
- * banked). Lifetime is real, accumulating, and the number worth screenshotting.
- * The current conversation's contribution still shows below as a sub-block.
- */
-function renderHero(args) {
-    const { lifetimeTokensWithout, lifetimeTokensWith, lifetimeUsd, lifetimeWithUsd, savedPct, totalConversations, firstDate } = args;
-    const out = [];
-    const since = firstDate ? `  ·  since ${firstDate}` : "";
-    out.push(`  ${lifetimeUsd} saved with context-mode  ·  ${savedPct.toFixed(1)}% reduction${since}`);
-    out.push("");
-    const withoutBar = dataBar(lifetimeTokensWithout, lifetimeTokensWithout, 32);
-    const withBar = dataBar(lifetimeTokensWith, lifetimeTokensWithout, 32);
-    out.push(`  Without context-mode  ${fmtNum(lifetimeTokensWithout).padStart(7)} tokens  ${withoutBar}   ${lifetimeUsd}`);
-    out.push(`  With context-mode     ${fmtNum(lifetimeTokensWith).padStart(7)} tokens  ${withBar}   ${lifetimeWithUsd}`);
-    const kept = lifetimeTokensWithout - lifetimeTokensWith;
-    out.push(`                        ${fmtNum(kept).padStart(7)} tokens kept out  ·  across ${totalConversations.toLocaleString("en-US")} conversations`);
-    return out;
-}
-/**
- * Render the current conversation as a contribution narrative — not a hero.
- * Highlights the slice of lifetime savings this chat earned + concrete proof
- * (events, days alive, compact rescues).
- */
-function renderConversation(c, conversationUsd, contribPct) {
-    const out = [];
-    const daysStr = c.daysAlive >= 1 ? `${c.daysAlive.toFixed(1)} days` : `${Math.max(1, Math.round(c.daysAlive * 24))} hr`;
-    const pctStr = contribPct >= 1 ? `${contribPct.toFixed(0)}% of all-time` : `<1% of all-time`;
-    out.push(`  This conversation contributed ${conversationUsd}  ·  ${pctStr}`);
-    out.push(`  ${c.events.toLocaleString("en-US")} events  ·  ${daysStr} alive`);
-    if (c.snapshotsConsumed > 0 && c.snapshotBytes > 0) {
-        const rescuedTokens = Math.round(c.snapshotBytes / 4);
-        out.push(`  ${c.snapshotsConsumed} compact weathered  ·  ${fmtNum(rescuedTokens)} tokens rescued from a ${(c.snapshotBytes / 1024).toFixed(0)} KB snapshot`);
-    }
-    out.push("");
-    if (c.byCategory.length === 0)
-        return out;
-    const max = c.byCategory[0].count || 1;
-    for (const cat of c.byCategory) {
-        out.push(`    ${cat.label.padEnd(26)} ${String(cat.count).padStart(5)}   ${dataBar(cat.count, max, 28)}`);
-    }
-    return out;
-}
-/**
- * B3b Slice 3.2/3.3 — render the "Where it came from" sub-block from a
- * `MultiAdapterLifetimeStats` (analytics.ts:1231-1240). Two layers:
- *
- *  1. Real adapters (`isReal=true`) become a table row each:
- *       Tool          Captures   Indexed     Total kept out
- *       Claude Code     17.4K    276.7 MB        291.1 MB
- *       JetBrains            —     8.6 MB          8.6 MB
- *
- *  2. Filtered adapters (`isReal=false` but with at least one .db on disk)
- *     become a single "Skipped (N): name1, name2, ..." disclosure line so
- *     the user sees that fixtures/probes were intentionally hidden.
- *
- * Returns [] when `multiAdapter` is undefined OR when there are no real
- * adapters AND nothing skipped — keeping the renderer additive (Slice 3.5).
- */
-function renderMultiAdapter(multiAdapter) {
-    if (!multiAdapter)
-        return [];
-    const real = [];
-    const skipped = [];
-    for (const a of multiAdapter.perAdapter)
-        (a.isReal ? real : skipped).push(a);
-    if (real.length === 0 && skipped.length === 0)
-        return [];
-    const out = [];
-    if (real.length > 0) {
-        out.push("");
-        out.push("Where it came from (tools you actually used — fixtures + probes filtered):");
-        out.push("");
-        // Column widths chosen so the demo render stays visually aligned even
-        // for adapters with very long marketing names. Right-aligned numerics.
-        const NAME_W = 16;
-        const CAP_W = 10;
-        const IDX_W = 10;
-        const TOT_W = 16;
-        out.push(`  ${"Tool".padEnd(NAME_W)}${"Captures".padStart(CAP_W)}${"Indexed".padStart(IDX_W)}${"Total kept out".padStart(TOT_W)}`);
-        // Sort by total kept out desc — biggest contributor first.
-        const sorted = [...real].sort((a, b) => (b.dataBytes + b.rescueBytes) - (a.dataBytes + a.rescueBytes));
-        for (const a of sorted) {
-            const total = a.dataBytes + a.rescueBytes;
-            // Em-dash for zero captures so the column reads "—" not "0".
-            const captures = a.eventCount > 0 ? fmtNum(a.eventCount) : "—";
-            const indexed = kb(a.dataBytes);
-            const totalStr = kb(total);
-            out.push(`  ${adapterLabel(a.name).padEnd(NAME_W)}${captures.padStart(CAP_W)}${indexed.padStart(IDX_W)}${totalStr.padStart(TOT_W)}`);
-        }
-    }
-    if (skipped.length > 0) {
-        if (real.length > 0)
-            out.push("");
-        const names = skipped.map((a) => adapterLabel(a.name)).join(", ");
-        out.push(`  Skipped (${skipped.length}): ${names}`);
-        out.push("  These adapters have DBs on disk but only test fixtures, dev skeletons,");
-        out.push("  or detection probes — no real chat activity.");
-    }
-    return out;
-}
-/**
- * Render a FullReport as a visual savings dashboard designed for screenshotting.
- *
- * Design principles:
- * - Before/After comparison bar is the HERO — one glance = "wow"
- * - "tokens saved" is the number people share
- * - Per-tool breakdown shows what each tool SAVED, sorted by impact
- * - Project memory: category bars showing persistent data across sessions
- * - No: Pct column, category tables, tips, jargon
- */
-export function formatReport(report, version, latestVersion, opts) {
-    const lines = [];
-    const duration = formatDuration(report.session.uptime_min);
-    const lifetime = opts?.lifetime;
-    const mcpUsage = opts?.mcpUsage;
-    const conversation = opts?.conversation;
-    const realBytes = opts?.realBytes;
-    const multiAdapter = opts?.multiAdapter;
-    // Real-adapter count drives the "across N AI tools" headline copy
-    // (Slice 3.4) — we only call something a "tool you used" once it
-    // passes the isReal filter inside getMultiAdapterLifetimeStats.
-    const realAdapterCount = multiAdapter?.perAdapter.filter((a) => a.isReal).length ?? 0;
-    // ── B3b Slice 3.4: opening tagline — runs in EVERY render path so the
-    // multi-adapter headline appears regardless of which formatReport branch
-    // executes (active session / fresh / per-conversation). Falls back to
-    // "in Claude Code" when only one adapter qualifies as real, matching the
-    // Mert-approved demo wording. Suppressed entirely without multiAdapter
-    // so legacy single-adapter renders stay byte-identical (Slice 3.5).
-    if (multiAdapter && realAdapterCount > 0) {
-        const totalConvs = multiAdapter.totalSessions || lifetime?.totalSessions || 0;
-        const sinceMs = lifetime?.firstEventMs ?? 0;
-        const days = sinceMs > 0
-            ? Math.max(1, Math.round((Date.now() - sinceMs) / 86_400_000))
-            : 0;
-        const daySegment = days > 0 ? `Across ${days} day${days === 1 ? "" : "s"} ` : "";
-        const convStr = totalConvs > 0
-            ? `you ran ${fmtNum(totalConvs)} conversation${totalConvs === 1 ? "" : "s"} `
-            : "you ran ";
-        let where;
-        if (realAdapterCount >= 2) {
-            where = `across ${realAdapterCount} AI tools`;
-        }
-        else {
-            // Single real adapter — use its marketing label (defaults to Claude Code
-            // if for some reason the only real adapter has no entry in adapterLabels).
-            const onlyReal = multiAdapter.perAdapter.find((a) => a.isReal);
-            where = `in ${onlyReal ? adapterLabel(onlyReal.name) : "Claude Code"}`;
-        }
-        lines.push(`${daySegment}${convStr}${where}.`);
-        lines.push("");
-    }
-    // ── 5-section narrative ("kitap gibi") layout — Mert-approved
-    //    screenshot format produced when the MCP handler has wired
-    //    conversation + lifetime + multi-adapter through. Replaces the
-    //    legacy hero/contribution/auto-memory stack with the:
-    //      Opener
-    //      1. Where you are now            (datetime, /compact, timeline)
-    //      2. What this chat captured      (per-category bars)
-    //      3. The receipt — getting wider
-    //      4. For example: what would that cost?
-    //      5. What context-mode learned about how you work
-    //      Footer
-    //    The opener block above (lines 1989-2005) is suppressed because
-    //    renderNarrative5Section emits its own.
-    if (conversation && conversation.events > 0) {
-        // Strip the previous-block opener — narrative renderer emits its own.
-        if (lines.length > 0)
-            lines.length = 0;
-        const detected = detectLocaleAndTz();
-        const cwd = opts?.cwd ?? process.cwd();
-        const now = opts?.now ?? Date.now();
-        const locale = opts?.locale ?? detected.locale;
-        const tz = opts?.tz ?? detected.tz;
-        lines.push(...renderNarrative5Section({
-            conversation, lifetime, multiAdapter, realBytes,
-            cwd, locale, tz, now, version, latestVersion,
-        }));
-        return lines.join("\n");
-    }
-    // ── Compute real savings ──
-    const totalKeptOut = report.savings.kept_out + (report.cache ? report.cache.bytes_saved : 0);
-    const totalReturned = report.savings.total_bytes_returned;
-    const totalCalls = report.savings.total_calls;
-    const grandTotal = totalKeptOut + totalReturned;
-    const savingsPct = grandTotal > 0 ? (totalKeptOut / grandTotal) * 100 : 0;
-    const tokensSaved = Math.round(totalKeptOut / 4);
-    const ratioMultiplier = totalReturned > 0
-        ? Math.max(1, Math.round(grandTotal / Math.max(totalReturned, 1)))
-        : 0;
-    // ── Fresh session: no savings yet ──
-    if (totalKeptOut === 0) {
-        lines.push(`context-mode  ${duration}  ${totalCalls} calls`);
-        lines.push("");
-        if (totalCalls === 0) {
-            lines.push("No tool calls yet. Use batch_execute or execute to start saving tokens.");
-        }
-        else {
-            lines.push(`${kb(totalReturned)} entered context  |  0 tokens saved`);
-        }
-        // Project memory + auto-memory + bottom line
-        lines.push(...renderProjectMemory(report.projectMemory, { lifetime, multiAdapter, sessionTokensSaved: 0 }));
-        lines.push(...renderMultiAdapter(multiAdapter));
-        lines.push(...renderAutoMemory(lifetime));
-        lines.push(...renderBottomLine(0, lifetime));
-        // Footer
-        lines.push("");
-        const versionStr = version ? `v${version}` : "context-mode";
-        lines.push(versionStr);
-        if (version && latestVersion && latestVersion !== "unknown" && semverNewer(latestVersion, version)) {
-            lines.push(`Update available: v${version} -> v${latestVersion}  |  ctx_upgrade`);
-        }
-        return lines.join("\n");
-    }
-    // ── Active session: visual savings dashboard ──
-    // Line 1: Hero metric — the screenshottable number
-    // Bug #6: include Opus pricing on the hero line for credibility.
-    lines.push(`${fmtNum(tokensSaved)} tokens saved  ·  ${savingsPct.toFixed(1)}% reduction  ·  ${duration}  ·  ~${tokensToUsd(tokensSaved)} saved (Opus)`);
-    lines.push("");
-    // Lines 2-3: Before/After comparison bars — the visual proof
-    lines.push(`Without context-mode  |${dataBar(grandTotal, grandTotal)}| ${kb(grandTotal)}`);
-    lines.push(`With context-mode     |${dataBar(totalReturned, grandTotal)}| ${kb(totalReturned)}`);
-    lines.push("");
-    // Value statement — the line people share
-    // Bug #7: replace meaningless "3.0x" ratio with "3× longer sessions".
-    if (ratioMultiplier >= 2) {
-        lines.push(`${kb(totalKeptOut)} kept out of your conversation — ${ratioMultiplier}× longer sessions before compact.`);
-    }
-    else {
-        lines.push(`${kb(totalKeptOut)} kept out of your conversation. Never entered context.`);
-    }
-    lines.push("");
-    // Compact stats row
-    const statParts = [`${totalCalls} calls`];
-    if (report.cache && report.cache.hits > 0) {
-        statParts.push(`${report.cache.hits} cache hits (+${kb(report.cache.bytes_saved)})`);
-    }
-    lines.push(statParts.join("  ·  "));
-    // ── Per-tool breakdown (only if 2+ tools, sorted by saved) ──
-    const activatedTools = report.savings.by_tool.filter((t) => t.calls > 0);
-    if (activatedTools.length >= 2) {
-        lines.push("");
-        // Estimate per-tool saved using global savings ratio
-        const toolRows = activatedTools.map((t) => {
-            const returnedBytes = t.context_kb * 1024;
-            const estimatedTotal = savingsPct < 100
-                ? returnedBytes / (1 - savingsPct / 100)
-                : returnedBytes;
-            const estimatedSaved = Math.max(0, estimatedTotal - returnedBytes);
-            return { ...t, returnedBytes, estimatedSaved };
-        }).sort((a, b) => b.estimatedSaved - a.estimatedSaved);
-        // Compact table: tool name, calls, saved
-        for (const t of toolRows) {
-            const name = t.tool.length > 22 ? t.tool.slice(0, 19) + "..." : t.tool;
-            lines.push(`  ${name.padEnd(22)}  ${String(t.calls).padStart(4)} calls  ${kb(t.estimatedSaved).padStart(8)} saved`);
-        }
-    }
-    // ── Parallel I/O — value-forward framing for concurrent batch tools.
-    // Suppressed when no tool ran with max_concurrency > 1 (don't claim
-    // parallelism we didn't deliver). Internal mcp__*__ namespace stripped
-    // for user-facing readability.
-    if (mcpUsage && mcpUsage.length > 0) {
-        const concurrent = mcpUsage.filter((u) => u.median_concurrency != null && (u.max_concurrency ?? 1) > 1);
-        if (concurrent.length > 0) {
-            lines.push("");
-            lines.push("Parallel I/O  ✓ one call did the work of many — faster runs, lower bill, same answer.");
-            for (const u of concurrent) {
-                const name = u.tool_name.replace(/^mcp__.*?__/, "");
-                lines.push(`  ${name.padEnd(22)} ${u.calls} batches · ${u.median_concurrency} typical, ${u.max_concurrency} peak`);
-            }
-        }
-    }
-    // ── Project memory — persistent across sessions (Bug #3 + #5) ──
-    lines.push(...renderProjectMemory(report.projectMemory, { lifetime, multiAdapter, sessionTokensSaved: tokensSaved }));
-    // ── B3b Slice 3.2/3.3 — "Where it came from" per-adapter sub-block.
-    // Sits under the lifetime memory block so the receipt-to-source flow is
-    // visually contiguous (lifetime totals → which tools produced them).
-    lines.push(...renderMultiAdapter(multiAdapter));
-    // ── Auto-memory — Claude Code's preference learnings (Bug #4) ──
-    lines.push(...renderAutoMemory(lifetime));
-    // ── Bottom line — business value framing (Bug #8) ──
-    lines.push(...renderBottomLine(tokensSaved, lifetime));
-    // ── Footer ──
-    lines.push("");
-    const versionStr = version ? `v${version}` : "context-mode";
-    lines.push(versionStr);
-    if (version && latestVersion && latestVersion !== "unknown" && latestVersion !== version) {
-        lines.push(`Update available: v${version} -> v${latestVersion}  |  ctx_upgrade`);
-    }
-    return lines.join("\n");
-}