token-goat 2.9.13 → 2.9.15

package/dist/token-goat-chunk-IVUQLQWN.mjs

@@ -0,0 +1,2046 @@
+import { createRequire as __cjsRequire } from 'node:module';
+const require = __cjsRequire(import.meta.url);
+import {
+  getDb
+} from "./token-goat-chunk-K7F2BFIK.mjs";
+import {
+  getHarnessName,
+  loadConfig
+} from "./token-goat-chunk-S4XRY446.mjs";
+import {
+  registerReset
+} from "./token-goat-chunk-EEIDFMEM.mjs";
+import {
+  VERSION,
+  atomicWriteText,
+  countNoun,
+  dataDir,
+  dataDirForHome,
+  ensureDirSync,
+  sanitizeIdForFilename,
+  tokenGoatHome
+} from "./token-goat-chunk-PM76YS22.mjs";
+import {
+  displaySafeText
+} from "./token-goat-chunk-ERTXEKB6.mjs";
+import {
+  growsExponentially,
+  hasNestedQuantifier
+} from "./token-goat-chunk-GMOUBOX4.mjs";
+import {
+  init_define_import_meta_env
+} from "./token-goat-chunk-A37V4PBF.mjs";
+
+// src/render/ansi.ts
+init_define_import_meta_env();
+function _colorStream(isatty) {
+  if (process.env["NO_COLOR"]) return false;
+  return isatty;
+}
+function colorStdout() {
+  return _colorStream(process.stdout.isTTY === true);
+}
+var _E = "\x1B";
+var RESET = `${_E}[0m`;
+var _ANSI_ESCAPE_RE = /\x1B\[[0-?]*[ -/]*[@-~]|\x1B\].*?(?:\x07|\x1B\\|$)|\x1B[PX^_].*?\x1B\\|\x1B[@-_]/gs;
+var _PUA_RE = /[\u{E000}-\u{F8FF}\u{F0000}-\u{FFFFD}]/gu;
+function stripAnsiEscapes(s) {
+  if (!s.includes("\x1B")) {
+    return s;
+  }
+  return s.replace(_ANSI_ESCAPE_RE, "");
+}
+function stripAnsi(s) {
+  if (!s.includes("\x1B")) {
+    return s;
+  }
+  return stripAnsiEscapes(s).replace(_PUA_RE, "");
+}
+function fmtBytes(n) {
+  let value = n;
+  const units = ["B", "KB", "MB", "GB", "TB"];
+  for (const unit of units) {
+    if (Math.abs(value) < 1024) {
+      return unit === "B" ? `${Math.trunc(value)}${unit}` : `${value.toFixed(1)}${unit}`;
+    }
+    value = value / 1024;
+  }
+  return `${value.toFixed(1)}PB`;
+}
+function fg(r, g, b) {
+  return `${_E}[38;2;${r};${g};${b}m`;
+}
+function vlen(s) {
+  return stripAnsi(s).length;
+}
+function padR(s, w) {
+  return s + " ".repeat(Math.max(0, w - vlen(s)));
+}
+function padL(s, w) {
+  return " ".repeat(Math.max(0, w - vlen(s))) + s;
+}
+function lerpRgb(a, b, t) {
+  return [
+    Math.round(a[0] + (b[0] - a[0]) * t),
+    Math.round(a[1] + (b[1] - a[1]) * t),
+    Math.round(a[2] + (b[2] - a[2]) * t)
+  ];
+}
+var C = {
+  TEXT_PRIMARY: [201, 209, 217],
+  TEXT_BRIGHT: [240, 246, 252],
+  TEXT_MUTED: [125, 133, 144],
+  TEXT_DIM: [72, 79, 88],
+  BG_TILE: [22, 27, 34],
+  TRACK: [28, 35, 41],
+  GREEN1: [31, 77, 44],
+  GREEN2: [46, 160, 67],
+  GREEN3: [63, 185, 80],
+  GREEN4: [86, 211, 100],
+  GREEN5: [126, 231, 135],
+  BLUE: [88, 166, 255],
+  PURPLE: [188, 140, 255],
+  TEAL: [138, 212, 255],
+  ORANGE: [235, 165, 80],
+  YELLOW: [240, 215, 80],
+  RED: [200, 60, 60]
+};
+
+// src/stats.ts
+init_define_import_meta_env();
+import * as path from "node:path";
+
+// src/render/stats_renderer.ts
+init_define_import_meta_env();
+var _STATS_MESSAGES_FALLBACK = {
+  bytesModeOnlyNote: "tracks bytes, not vision tokens",
+  sessionHintSplitNote: "session_hint shows realized savings; session_hint_overhead shows injected hint cost",
+  insights: {
+    biggestSaver: "Biggest saver  ",
+    mostActive: "Most active    ",
+    tokenLeader: "Token leader   "
+  }
+};
+var _STATS_MESSAGES = _STATS_MESSAGES_FALLBACK;
+var _TERM_W = process.stdout.columns || 100;
+var _CONTENT_W = Math.min(Math.max(_TERM_W, 80), 140);
+var _M = "  ";
+var _COL_NAME = 18;
+var _COL_DATA = 10;
+var _COL_TOKENS = 12;
+var _COL_SHARE = 6;
+var _COL_EVENTS = 6;
+var _COLS_FIXED = _COL_NAME + 1 + 2 + _COL_DATA + 2 + _COL_TOKENS + 2 + _COL_SHARE + 2 + _COL_EVENTS;
+var _BAR_W = Math.max(16, _CONTENT_W - _M.length * 2 - _COLS_FIXED);
+var _RULE = _M + fg(...C.TEXT_DIM) + "\u2500".repeat(_CONTENT_W - _M.length * 2) + RESET;
+var _BYTE_TIERS = [
+  { threshold: 1e15, divisor: 1e15, unit: "PB", color: C.PURPLE },
+  { threshold: 1e12, divisor: 1e12, unit: "TB", color: C.BLUE },
+  { threshold: 1e9, divisor: 1e9, unit: "GB", color: C.TEAL },
+  { threshold: 1e6, divisor: 1e6, unit: "MB", color: C.GREEN4 },
+  { threshold: 1e3, divisor: 1e3, unit: "KB", color: C.TEXT_MUTED },
+  { threshold: 0, divisor: 1, unit: "B", color: C.TEXT_DIM }
+];
+var _TOKEN_TIERS = [
+  { threshold: 1e12, divisor: 1e12, unit: "Tt", color: C.GREEN5 },
+  { threshold: 1e9, divisor: 1e9, unit: "Gt", color: C.TEAL },
+  { threshold: 1e6, divisor: 1e6, unit: "Mt", color: C.PURPLE },
+  { threshold: 1e3, divisor: 1e3, unit: "kt", color: C.BLUE },
+  { threshold: 0, divisor: 1, unit: "t", color: C.TEXT_DIM }
+];
+function _fmtMagnitude(n, tiers, zeroLabel) {
+  if (zeroLabel !== void 0 && n === 0) {
+    return `${fg(...C.TEXT_DIM)}${zeroLabel}${RESET}`;
+  }
+  if (n < 0) {
+    const a = -n;
+    const color = C.TEXT_DIM;
+    for (const tier of tiers) {
+      if (a >= tier.threshold && tier.threshold > 0) {
+        return `${fg(...color)}-${(a / tier.divisor).toLocaleString("en", { maximumFractionDigits: 1 })} ${tier.unit}${RESET}`;
+      }
+    }
+    const lastTier2 = tiers[tiers.length - 1];
+    if (lastTier2) {
+      return `${fg(...color)}-${a} ${lastTier2.unit}${RESET}`;
+    }
+    return `${fg(...color)}-${a}${RESET}`;
+  }
+  for (const tier of tiers) {
+    if (n >= tier.threshold && tier.threshold > 0) {
+      return `${fg(...tier.color)}${(n / tier.divisor).toLocaleString("en", { maximumFractionDigits: 1 })} ${tier.unit}${RESET}`;
+    }
+  }
+  const lastTier = tiers[tiers.length - 1];
+  if (lastTier) {
+    return `${fg(...lastTier.color)}${n} ${lastTier.unit}${RESET}`;
+  }
+  return `${n}${RESET}`;
+}
+function _fmtBytes(n) {
+  return _fmtMagnitude(n, _BYTE_TIERS);
+}
+function _fmtTokens(n) {
+  return _fmtMagnitude(n, _TOKEN_TIERS, "0 t");
+}
+function _fmtPct(fraction) {
+  return `${(fraction * 100).toFixed(1)}%`;
+}
+function _fmtDelta(delta) {
+  if (!delta && delta !== 0) {
+    return "";
+  }
+  const up = (delta ?? 0) >= 0;
+  const color = up ? C.GREEN5 : C.RED;
+  const arrow = up ? "\u2191" : "\u2193";
+  return ` ${fg(...color)}${arrow} ${Math.round(Math.abs(delta ?? 0))}%${RESET}`;
+}
+var _EIGHTHS = ["\u258F", "\u258E", "\u258D", "\u258C", "\u258B", "\u258A", "\u2589"];
+var _BLOCK = "\u2588";
+var _TRACK = "\u2591";
+var _GRADIENT = [C.GREEN1, C.GREEN2, C.GREEN3, C.GREEN4, C.GREEN5];
+function _distribute(total, n) {
+  if (total <= 0 || n <= 0) {
+    return Array(Math.max(0, n)).fill(0);
+  }
+  const base = Math.floor(total / n);
+  const rem = total % n;
+  return Array.from({ length: n }, (_, i) => base + (i >= n - rem ? 1 : 0));
+}
+function _renderBar(fraction, width = _BAR_W) {
+  const f = Math.max(0, Math.min(1, fraction));
+  const raw = f * width;
+  let nFull = Math.floor(raw);
+  const eighths = Math.round((raw - nFull) * 8);
+  if (eighths >= 8) {
+    nFull += 1;
+  }
+  const hasPartial = eighths > 0 && eighths < 8;
+  const nTrack = Math.max(0, width - nFull - (hasPartial ? 1 : 0));
+  const counts = _distribute(nFull, _GRADIENT.length);
+  let bar = counts.map((count, i) => count > 0 ? `${fg(_GRADIENT[i][0], _GRADIENT[i][1], _GRADIENT[i][2])}${_BLOCK.repeat(count)}` : "").join("");
+  if (hasPartial) {
+    const lastGrad = _GRADIENT[_GRADIENT.length - 1];
+    bar += `${fg(lastGrad[0], lastGrad[1], lastGrad[2])}${_EIGHTHS[eighths - 1]}`;
+  }
+  if (nTrack > 0) {
+    bar += `${fg(...C.TRACK)}${_TRACK.repeat(nTrack)}`;
+  }
+  return bar + RESET;
+}
+var _SPARK = "\u2581\u2582\u2583\u2584\u2585\u2586\u2587\u2588";
+function _resample(vals, length) {
+  if (vals.length === 0) {
+    return Array(length).fill(0);
+  }
+  if (vals.length === length) {
+    return [...vals];
+  }
+  const result = [];
+  for (let i = 0; i < length; i++) {
+    const src = i / (length - 1 || 1) * (vals.length - 1);
+    const lo = Math.floor(src);
+    const hi = Math.min(vals.length - 1, lo + 1);
+    const t = src - lo;
+    const loVal = vals[lo] ?? 0;
+    const hiVal = vals[hi] ?? 0;
+    result.push(loVal * (1 - t) + hiVal * t);
+  }
+  return result;
+}
+function _renderSparkline(values, width = 8) {
+  const pts = _resample(values, width);
+  const hi = pts.length > 0 ? Math.max(...pts) : 1;
+  const lo = pts.length > 0 ? Math.min(...pts) : 0;
+  const span = hi - lo || 1;
+  const chars = [];
+  for (let i = 0; i < pts.length; i++) {
+    const v = pts[i];
+    if (v === void 0) continue;
+    const idx = Math.min(7, Math.floor((v - lo) / span * 8));
+    const color = lerpRgb(C.GREEN1, C.GREEN5, i / (width - 1 || 1));
+    chars.push(`${fg(color[0], color[1], color[2])}${_SPARK[idx]}`);
+  }
+  return chars.join("") + RESET;
+}
+function _tokenOrByteShare(itemTokens, itemBytes, totalTokens, totalBytes) {
+  if (totalTokens > 0) {
+    return itemTokens / totalTokens;
+  }
+  if (totalBytes > 0) {
+    return itemBytes / totalBytes;
+  }
+  return 0;
+}
+function _barFraction(itemBytes, grossBytes) {
+  return itemBytes > 0 ? itemBytes / grossBytes : 0;
+}
+function _computeShareDenominators(items) {
+  let grossBytesSum = 0;
+  let shareByteSum = 0;
+  let shareTokensSum = 0;
+  for (const item of items) {
+    if (item.bytes > 0) {
+      grossBytesSum += item.bytes;
+    }
+    shareByteSum += Math.abs(item.bytes);
+    shareTokensSum += Math.abs(item.tokens);
+  }
+  return {
+    grossBytes: Math.max(grossBytesSum, 1),
+    shareBytesDenom: Math.max(shareByteSum, 1),
+    shareTokensDenom: shareTokensSum
+  };
+}
+function _absShare(itemBytes, itemTokens, shareBytesDenom, shareTokensDenom) {
+  if (shareTokensDenom === 0) {
+    return itemBytes / shareBytesDenom;
+  }
+  return itemTokens / shareTokensDenom;
+}
+function _sectionHeader(title, subtitle = "") {
+  const sub = subtitle ? `  ${fg(...C.TEXT_MUTED)}${subtitle}${RESET}` : "";
+  return [
+    "",
+    `${_M}${fg(...C.TEXT_BRIGHT)}${title}${RESET}${sub}`,
+    _RULE
+  ];
+}
+function _tableHeader(firstColLabel) {
+  return [
+    _M,
+    padR(`${fg(...C.TEXT_DIM)}${firstColLabel}${RESET}`, _COL_NAME),
+    " ",
+    padR(`${fg(...C.TEXT_DIM)}savings${RESET}`, _BAR_W),
+    "  ",
+    padL(`${fg(...C.TEXT_DIM)}data saved${RESET}`, _COL_DATA),
+    "  ",
+    padL(`${fg(...C.TEXT_DIM)}tokens saved${RESET}`, _COL_TOKENS),
+    "  ",
+    padL(`${fg(...C.TEXT_DIM)}share${RESET}`, _COL_SHARE),
+    "  ",
+    padL(`${fg(...C.TEXT_DIM)}events${RESET}`, _COL_EVENTS)
+  ].join("");
+}
+function _tableRow({
+  name,
+  fraction,
+  bytes,
+  tokens,
+  events,
+  share,
+  bytesModeOnly = false,
+  namePrefix = "",
+  nameColor = C.TEXT_PRIMARY
+}) {
+  const prefixW = vlen(namePrefix);
+  const maxName = _COL_NAME - prefixW;
+  const truncated = name.length > maxName ? name.slice(0, maxName - 1) + "\u2026" : name;
+  const nameStr = padR(`${namePrefix}${fg(...nameColor)}${truncated}${RESET}`, _COL_NAME);
+  const dataStr = padL(_fmtBytes(bytes), _COL_DATA);
+  const tokStr = bytesModeOnly ? padL(`${fg(...C.TEXT_DIM)}\u2014${RESET}`, _COL_TOKENS) : padL(_fmtTokens(tokens), _COL_TOKENS);
+  const sharePct = share * 100;
+  let shareColor;
+  if (sharePct < 0) {
+    shareColor = C.RED;
+  } else if (sharePct >= 50) {
+    shareColor = C.GREEN5;
+  } else if (sharePct >= 10) {
+    shareColor = C.TEXT_PRIMARY;
+  } else {
+    shareColor = C.TEXT_MUTED;
+  }
+  const shareStr = padL(`${fg(...shareColor)}${_fmtPct(share)}${RESET}`, _COL_SHARE);
+  const evStr = padL(`${fg(...C.TEXT_PRIMARY)}${events.toLocaleString()}${RESET}`, _COL_EVENTS);
+  return [_M, nameStr, " ", _renderBar(fraction), "  ", dataStr, "  ", tokStr, "  ", shareStr, "  ", evStr].join("");
+}
+function _renderKpiSection(stats) {
+  const totals = stats.totals;
+  const colW = Math.floor((_CONTENT_W - _M.length * 2) / 3);
+  function card(label, value, delta, spark2) {
+    return [
+      padR(`${fg(C.TEXT_MUTED[0], C.TEXT_MUTED[1], C.TEXT_MUTED[2])}${label}${RESET}`, colW),
+      padR(`${fg(C.TEXT_BRIGHT[0], C.TEXT_BRIGHT[1], C.TEXT_BRIGHT[2])}${value}${RESET}${delta}`, colW),
+      spark2 !== null ? padR(spark2, colW) : padR("", colW)
+    ];
+  }
+  const spark = totals.sparklines;
+  const c1 = card(
+    "events",
+    `${totals.events.toLocaleString()}`,
+    _fmtDelta(totals.events_delta ?? null),
+    spark ? _renderSparkline(spark.events) : null
+  );
+  const c2 = card(
+    "data saved",
+    _fmtBytes(totals.bytes),
+    _fmtDelta(totals.bytes_delta ?? null),
+    spark ? _renderSparkline(spark.bytes) : null
+  );
+  const c3 = card(
+    "tokens saved",
+    _fmtTokens(totals.tokens),
+    _fmtDelta(totals.tokens_delta ?? null),
+    spark ? _renderSparkline(spark.tokens) : null
+  );
+  const border = fg(C.TEXT_DIM[0], C.TEXT_DIM[1], C.TEXT_DIM[2]);
+  const frameBar = "\u2500".repeat(colW * 3 + 2);
+  function framed(content) {
+    return `${_M}${border}\u2502${RESET} ${content} ${border}\u2502${RESET}`;
+  }
+  const lines = [
+    "",
+    `${_M}${border}\u256D${frameBar}\u256E${RESET}`,
+    framed(c1[0] + c2[0] + c3[0]),
+    framed(c1[1] + c2[1] + c3[1])
+  ];
+  if (spark) {
+    lines.push(framed(c1[2] + c2[2] + c3[2]));
+  }
+  lines.push(`${_M}${border}\u2570${frameBar}\u256F${RESET}`);
+  return lines;
+}
+var _KIND_GROUPS = [
+  {
+    label: "Read savings",
+    members: /* @__PURE__ */ new Set([
+      "read_replacement",
+      "section_replacement",
+      "symbol_read",
+      "section_read",
+      "stub_view",
+      "outline",
+      "exports",
+      "imports",
+      "changed_lookup",
+      "dep_docs",
+      // Every other SOURCE_READ kind in stats.ts's KIND_TO_SOURCE: the surgical-read commands over documents, structured data and session/PR state. They were registered and produced but grouped nowhere, so `stats --full` printed the whole family under 'Other', away from the read-savings siblings they are measured against. image_meta/image_text sit here rather than under 'Images' because stats.ts files them as SOURCE_READ: they save read bytes, they do not shrink an image.
+      "brief_view",
+      "conflicts",
+      "coverage_report_gaps",
+      "csv_query",
+      "csv_profile",
+      "compact_doc",
+      "docx_outline",
+      "docx_tables",
+      "docx_text",
+      "gdrive_sections",
+      "image_meta",
+      "image_text",
+      "json_query",
+      "json_outline",
+      "note_read",
+      "note_list",
+      "openapi_op",
+      "openapi_outline",
+      "pdf_extract",
+      "pdf_locate",
+      "pdf_outline",
+      "pdf_meta",
+      "pptx_outline",
+      "pptx_slide",
+      "pptx_notes",
+      "pptx_text",
+      "pr_slice",
+      "session_outline",
+      "session_slice",
+      "sqlite_query",
+      "sqlite_schema",
+      "sqlite_tables",
+      "transcript",
+      "transcript_outline",
+      "video_chapters",
+      "xlsx_sheets",
+      "xlsx_head",
+      "xlsx_range",
+      "xlsx_query",
+      "xlsx_columns",
+      "xml_query",
+      "xml_outline",
+      "html_query",
+      "html_outline",
+      "yaml_query",
+      "yaml_outline",
+      "zip_list",
+      "zip_read"
+    ])
+  },
+  { label: "Lookups", members: /* @__PURE__ */ new Set(["symbol_lookup", "semantic_search", "map_lookup"]) },
+  {
+    label: "Images",
+    members: /* @__PURE__ */ new Set([
+      "image_shrink",
+      "gdrive_image",
+      "webfetch_image",
+      "image_shrink_skipped",
+      "image_shrink_cache_hit",
+      "image_ocr"
+    ])
+  },
+  {
+    label: "Hints",
+    members: /* @__PURE__ */ new Set([
+      "session_hint",
+      "session_hint_overhead",
+      "session_hint_suppressed",
+      "read_count_deny",
+      "read_served_deny",
+      "subagent_markdown_first_read_deny",
+      "grep_dedup_hint",
+      "glob_dedup_hint",
+      "diff_hint",
+      "predictive_prefetch_hit",
+      "structured_file_hint",
+      "write_rewrite_hint",
+      "websearch_dedup_hint",
+      "large_file_hint_followed",
+      "large_file_hint_ignored",
+      "evidence_cache_hit"
+    ])
+  },
+  // Empty for the same reason as MCP below: every live Bash kind arrives through _kindGroupLabel's `bash_compress:` prefix branch, not through a literal name. The fifteen literal names this set used to carry (bash_output_cached, bash_dedup_hint, env_probe_cache_hit and the rest) came over with the Python port and were never recorded or registered anywhere in this tree, so they grouped rows that could not exist.
+  { label: "Bash", members: /* @__PURE__ */ new Set() },
+  {
+    label: "Web",
+    members: /* @__PURE__ */ new Set([
+      "web_fetch",
+      "injection_detected"
+    ])
+  },
+  // Membership comes from _kindGroupLabel's `mcp:` prefix branch, not from this set, which is why
+  // it is empty. The entry still has to exist: _renderByKindSection iterates _KIND_GROUPS' labels
+  // (plus 'Other') to decide what to print, so a label _kindGroupLabel returns but that is missing
+  // here does not fall back to 'Other' -- its rows disappear from the table entirely.
+  { label: "MCP", members: /* @__PURE__ */ new Set() },
+  {
+    label: "Compact / Skills",
+    members: /* @__PURE__ */ new Set([
+      "skill_load",
+      "skill_oversized_first_load",
+      "skill_compact_inlined",
+      "skill_heading_tree_inlined"
+    ])
+  },
+  // SOURCE_CONTENT: real rewrites of tool output that remove real bytes (agent report compaction, Grep fold, browser tab dedup, bash/content compression and the handoff pair). The by-source table has shown a 'content' row since the source was added, but the by-kind table had no member set for it, so every one of these kinds printed under 'Other'. The taskoutput: prefix branch in _kindGroupLabel routes here too.
+  {
+    label: "Content",
+    members: /* @__PURE__ */ new Set([
+      "content_compress",
+      "content_retrieve",
+      "agent_report_compact",
+      "agent_report_compact_declined",
+      "browser_tab_dedup",
+      "grep:fold",
+      "read:served_elide",
+      "read:body_fold",
+      "read:markdown_outline",
+      "read:source_skeleton",
+      "handoff_create",
+      "handoff_resolve",
+      "plan_echo_collapse"
+    ])
+  }
+];
+function _kindGroupLabel(kind) {
+  if (kind.startsWith("bash_compress:") || kind.startsWith("bashoutput:")) {
+    return "Bash";
+  }
+  if (kind.startsWith("webfetch:") || kind.startsWith("gdrive:")) {
+    return "Web";
+  }
+  if (kind.startsWith("mcp:")) {
+    return "MCP";
+  }
+  if (kind.startsWith("skill_body:") || kind.startsWith("skill_compact:")) {
+    return "Compact / Skills";
+  }
+  if (kind.startsWith("taskoutput:")) {
+    return "Content";
+  }
+  for (const group of _KIND_GROUPS) {
+    if (group.members.has(kind)) {
+      return group.label;
+    }
+  }
+  return "Other";
+}
+function _groupSeparator(label) {
+  return `${_M}  ${fg(...C.TEXT_DIM)}${label}${RESET}`;
+}
+function _renderByKindSection(stats) {
+  if (stats.by_kind.length === 0) {
+    return [];
+  }
+  const lines = [..._sectionHeader("By kind"), _tableHeader("name")];
+  const { grossBytes, shareBytesDenom, shareTokensDenom } = _computeShareDenominators(stats.by_kind);
+  const kindNames = new Set(stats.by_kind.map((k) => k.kind));
+  const bytesModeKinds = stats.by_kind.filter((k) => k.bytes_mode_only).map((k) => k.kind);
+  function share(k) {
+    if (k.bytes_mode_only) {
+      return k.bytes / shareBytesDenom;
+    }
+    return _absShare(k.bytes, k.tokens, shareBytesDenom, shareTokensDenom);
+  }
+  const byGroup = /* @__PURE__ */ new Map();
+  for (const k of stats.by_kind) {
+    const grp = _kindGroupLabel(k.kind);
+    if (!byGroup.has(grp)) {
+      byGroup.set(grp, []);
+    }
+    byGroup.get(grp).push(k);
+  }
+  for (const grpKinds of byGroup.values()) {
+    grpKinds.sort((a, b) => share(b) - share(a));
+  }
+  const groupLabels = [..._KIND_GROUPS.map((g) => g.label), "Other"];
+  let firstGroup = true;
+  for (const label of groupLabels) {
+    const groupKinds = byGroup.get(label);
+    if (!groupKinds || groupKinds.length === 0) {
+      continue;
+    }
+    if (!firstGroup) {
+      lines.push("");
+    }
+    firstGroup = false;
+    lines.push(_groupSeparator(label));
+    for (const k of groupKinds) {
+      const s = share(k);
+      lines.push(
+        _tableRow({
+          name: k.kind,
+          fraction: _barFraction(k.bytes, grossBytes),
+          bytes: k.bytes,
+          tokens: k.tokens,
+          events: k.events,
+          share: s,
+          bytesModeOnly: k.bytes_mode_only ?? false
+        })
+      );
+    }
+  }
+  if (bytesModeKinds.length > 0) {
+    const names = bytesModeKinds.join(", ");
+    lines.push(`${_M}${fg(...C.TEXT_DIM)}i  ${names} ${_STATS_MESSAGES.bytesModeOnlyNote}${RESET}`);
+  }
+  if (kindNames.has("session_hint") && kindNames.has("session_hint_overhead")) {
+    lines.push(`${_M}${fg(...C.TEXT_DIM)}i  ${_STATS_MESSAGES.sessionHintSplitNote}${RESET}`);
+  }
+  return lines;
+}
+var _SOURCE_COLORS = {
+  image: C.PURPLE,
+  hint: C.BLUE,
+  read: C.GREEN4,
+  compact: C.TEAL,
+  bash: C.ORANGE,
+  web: C.YELLOW,
+  other: C.TEXT_MUTED
+};
+function _sourceColor(source) {
+  const color = _SOURCE_COLORS[source];
+  return color || C.TEXT_MUTED;
+}
+function _renderBySourceSection(stats) {
+  if (!stats.by_source || stats.by_source.length === 0) {
+    return [];
+  }
+  const lines = [..._sectionHeader("By source"), _tableHeader("source")];
+  const { grossBytes, shareBytesDenom, shareTokensDenom } = _computeShareDenominators(stats.by_source);
+  function share(s) {
+    return _absShare(s.bytes, s.tokens, shareBytesDenom, shareTokensDenom);
+  }
+  for (const s of [...stats.by_source].sort((a, b) => share(b) - share(a))) {
+    const s_val = share(s);
+    const color = _sourceColor(s.source);
+    lines.push(
+      _tableRow({
+        name: s.source,
+        fraction: _barFraction(s.bytes, grossBytes),
+        bytes: s.bytes,
+        tokens: s.tokens,
+        events: s.events,
+        share: s_val,
+        namePrefix: `${fg(...color)}\u25CF${RESET} `,
+        nameColor: C.TEXT_PRIMARY
+      })
+    );
+  }
+  return lines;
+}
+function _renderByCommandSection(stats) {
+  if (!stats.by_command || stats.by_command.length === 0) {
+    return [];
+  }
+  const lines = [..._sectionHeader("By command"), _tableHeader("command")];
+  const { grossBytes, shareBytesDenom, shareTokensDenom } = _computeShareDenominators(stats.by_command);
+  function share(c) {
+    return _absShare(c.bytes, c.tokens, shareBytesDenom, shareTokensDenom);
+  }
+  for (const c of [...stats.by_command].sort((a, b) => share(b) - share(a))) {
+    const s_val = share(c);
+    lines.push(
+      _tableRow({
+        name: c.command,
+        fraction: _barFraction(c.bytes, grossBytes),
+        bytes: c.bytes,
+        tokens: c.tokens,
+        events: c.events,
+        share: s_val,
+        nameColor: C.TEXT_PRIMARY
+      })
+    );
+  }
+  return lines;
+}
+function _renderByHarnessSection(stats) {
+  if (!stats.by_harness || stats.by_harness.length < 2) {
+    return [];
+  }
+  const lines = [..._sectionHeader("By harness"), _tableHeader("harness")];
+  const { grossBytes, shareBytesDenom, shareTokensDenom } = _computeShareDenominators(stats.by_harness);
+  function share(h) {
+    return _absShare(h.bytes, h.tokens, shareBytesDenom, shareTokensDenom);
+  }
+  for (const h of [...stats.by_harness].sort((a, b) => share(b) - share(a))) {
+    lines.push(
+      _tableRow({
+        name: h.harness,
+        fraction: _barFraction(h.bytes, grossBytes),
+        bytes: h.bytes,
+        tokens: h.tokens,
+        events: h.events,
+        share: share(h),
+        nameColor: C.TEXT_PRIMARY
+      })
+    );
+  }
+  return lines;
+}
+function _renderByDaySection(stats) {
+  if (stats.by_day.length === 0) {
+    return [];
+  }
+  const lines = [..._sectionHeader("By day"), _tableHeader("date")];
+  function share(d) {
+    return _tokenOrByteShare(d.tokens, d.bytes, stats.totals.tokens, stats.totals.bytes);
+  }
+  for (const d of [...stats.by_day].sort((a, b) => b.date < a.date ? -1 : b.date > a.date ? 1 : 0)) {
+    const s = share(d);
+    lines.push(
+      _tableRow({
+        name: d.date,
+        fraction: s,
+        bytes: d.bytes,
+        tokens: d.tokens,
+        events: d.events,
+        share: s
+      })
+    );
+  }
+  return lines;
+}
+var _PROJECT_COLORS = [C.PURPLE, C.TEAL, C.BLUE, C.GREEN4, C.TEXT_MUTED];
+function _hashColor(hashStr) {
+  let n = 0;
+  for (const c of hashStr) {
+    n += c.charCodeAt(0);
+  }
+  return _PROJECT_COLORS[n % _PROJECT_COLORS.length] ?? C.TEXT_MUTED;
+}
+function _renderByProjectSection(stats) {
+  if (stats.by_project.length === 0) {
+    return [];
+  }
+  const lines = [..._sectionHeader(`By project (top ${stats.by_project.length})`), _tableHeader("project")];
+  function share(p) {
+    return _tokenOrByteShare(p.tokens, p.bytes, stats.totals.tokens, stats.totals.bytes);
+  }
+  for (const p of [...stats.by_project].sort((a, b) => share(b) - share(a))) {
+    const s = share(p);
+    const color = _hashColor(p.hash);
+    lines.push(
+      _tableRow({
+        name: p.project,
+        fraction: s,
+        bytes: p.bytes,
+        tokens: p.tokens,
+        events: p.events,
+        share: s,
+        namePrefix: `${fg(...color)}\u25CF${RESET} `,
+        nameColor: C.TEXT_PRIMARY
+      })
+    );
+    lines.push(`${_M}  ${fg(...C.TEXT_DIM)}\u2514\u2500 ${p.hash}  ${displaySafeText(stripAnsi(p.path))}${RESET}`);
+  }
+  return lines;
+}
+function _renderInsightsSection(stats) {
+  const lines = [..._sectionHeader("Insights")];
+  const bullet = `${fg(...C.GREEN3)}\u25B8${RESET}`;
+  function dim(s) {
+    return `${fg(...C.TEXT_MUTED)}${s}${RESET}`;
+  }
+  const savingKinds = stats.by_kind.filter((k) => k.bytes > 0);
+  const topKind = savingKinds.reduce((max, k) => k.bytes > (max?.bytes || -Infinity) ? k : max, savingKinds[0]);
+  if (topKind) {
+    const share = stats.totals.bytes > 0 ? topKind.bytes / stats.totals.bytes : 0;
+    lines.push(
+      `${_M}${bullet} ${dim(_STATS_MESSAGES.insights.biggestSaver)}${fg(...C.TEXT_PRIMARY)}${topKind.kind}${RESET}${dim(" \u2014 ")}${fg(...C.GREEN5)}${_fmtPct(share)}${RESET}${dim(` of saved data across ${topKind.events.toLocaleString()} events`)}`
+    );
+  }
+  const topDay = stats.by_day.reduce((max, d) => d.events > (max?.events || -Infinity) ? d : max, stats.by_day[0]);
+  if (topDay) {
+    lines.push(
+      `${_M}${bullet} ${dim(_STATS_MESSAGES.insights.mostActive)}${fg(...C.TEXT_PRIMARY)}${topDay.date}${RESET}${dim(" \u2014 ")}${topDay.events.toLocaleString()} events, ${_fmtBytes(topDay.bytes)}${dim(" saved")}`
+    );
+  }
+  const tokenKinds = stats.by_kind.filter((k) => !k.bytes_mode_only && k.tokens > 0);
+  const topToken = tokenKinds.reduce((max, k) => k.tokens > (max?.tokens || -Infinity) ? k : max, tokenKinds[0]);
+  if (topToken) {
+    lines.push(
+      `${_M}${bullet} ${dim(_STATS_MESSAGES.insights.tokenLeader)}${fg(...C.TEXT_PRIMARY)}${topToken.kind}${RESET}${dim(" \u2014 ")}${_fmtTokens(topToken.tokens)}${dim(` saved in ${topToken.events.toLocaleString()} events`)}`
+    );
+  }
+  if ((stats.by_command?.length ?? 0) === 0) {
+    const hintSource = stats.by_source?.find((s) => s.source === "hint");
+    if (hintSource && hintSource.events > 0) {
+      lines.push(
+        `${_M}${fg(...C.YELLOW)}\u25B8${RESET} ${dim("0 direct commands   ")}${fg(...C.TEXT_PRIMARY)}${hintSource.events.toLocaleString()}${RESET}${dim(" hint(s) fired but not acted on \u2014 run symbol/read/section/semantic/outline/skeleton directly to capture these savings")}`
+      );
+    }
+  }
+  return lines;
+}
+function _renderHeader(stats) {
+  let line = `${_M}${fg(...C.TEXT_BRIGHT)}token-goat${RESET}`;
+  if (stats.version) {
+    line += `  ${fg(...C.TEXT_MUTED)}v${stats.version}${RESET}`;
+  }
+  if (stats.window_label) {
+    line += `  ${fg(...C.TEXT_DIM)}\xB7  ${stats.window_label}${RESET}`;
+  }
+  return [line];
+}
+function _renderShortHint() {
+  return [
+    "",
+    `${_M}${fg(...C.TEXT_MUTED)}Run 'token-goat stats --full' for the full breakdown (by source, by command, by day).${RESET}`
+  ];
+}
+function renderStats(stats, opts) {
+  if (opts?.short) {
+    const sections2 = [_renderHeader(stats), _renderKpiSection(stats), _renderShortHint(), [""]];
+    return sections2.flatMap((s) => s).join("\n");
+  }
+  const sections = [
+    _renderHeader(stats),
+    _renderKpiSection(stats),
+    _renderByKindSection(stats),
+    _renderBySourceSection(stats),
+    _renderByCommandSection(stats),
+    _renderByHarnessSection(stats),
+    _renderByDaySection(stats),
+    _renderByProjectSection(stats),
+    _renderInsightsSection(stats),
+    [""]
+  ];
+  return sections.flatMap((s) => s).join("\n");
+}
+
+// src/stats.ts
+var HARNESS_UNRECORDED = "unrecorded (pre-2.8.1)";
+var PRICING_VERSION_UNRECORDED = "unrecorded (pre-tg_version column)";
+function hasMixedPricingEras(summary) {
+  return Object.keys(summary.by_pricing_version).length > 1;
+}
+var SOURCE_IMAGE = "image";
+var SOURCE_HINT = "hint";
+var SOURCE_READ = "read";
+var SOURCE_BASH = "bash";
+var SOURCE_WEB = "web";
+var SOURCE_MCP = "mcp";
+var SOURCE_SKILL = "skill";
+var SOURCE_CONTENT = "content";
+var SOURCE_OTHER = "other";
+var _BYTES_MODE_ONLY_KINDS = /* @__PURE__ */ new Set(["webfetch_image", "gdrive_image"]);
+var COUNT_ONLY_KINDS = /* @__PURE__ */ new Set(["secret_redacted"]);
+function savedTokensFromBytes(bytes) {
+  return Math.round(Math.max(0, bytes) / 4);
+}
+var KIND_TO_SOURCE = {
+  image_shrink: SOURCE_IMAGE,
+  image_shrink_cache_hit: SOURCE_IMAGE,
+  image_shrink_skipped: SOURCE_IMAGE,
+  image_ocr: SOURCE_IMAGE,
+  webfetch_image: SOURCE_IMAGE,
+  gdrive_image: SOURCE_IMAGE,
+  session_hint: SOURCE_HINT,
+  session_hint_suppressed: SOURCE_HINT,
+  diff_hint: SOURCE_HINT,
+  evidence_cache_hit: SOURCE_HINT,
+  structured_file_hint: SOURCE_HINT,
+  predictive_prefetch_hit: SOURCE_HINT,
+  grep_dedup_hint: SOURCE_HINT,
+  glob_dedup_hint: SOURCE_HINT,
+  write_rewrite_hint: SOURCE_HINT,
+  websearch_dedup_hint: SOURCE_HINT,
+  large_file_hint_followed: SOURCE_HINT,
+  large_file_hint_ignored: SOURCE_HINT,
+  read_count_deny: SOURCE_HINT,
+  read_served_deny: SOURCE_HINT,
+  // hooks_read.ts's subagent first-read markdown deny (hints.subagent_markdown_first_read_deny, off by default). Always recorded at 0 bytes / 0 tokens: no first-read deny of this shape exists in the transcript corpus, so its abandoned/substituted/shell-read/retried rates are unknown and can only be borrowed from the re-read heading-tree census. Booking withheld bytes against borrowed rates would claim a saving this path cannot back up. The kind exists to make the intervention countable in session-audit, not to claim a win.
+  subagent_markdown_first_read_deny: SOURCE_HINT,
+  read_replacement: SOURCE_READ,
+  section_replacement: SOURCE_READ,
+  symbol_read: SOURCE_READ,
+  section_read: SOURCE_READ,
+  stub_view: SOURCE_READ,
+  symbol_lookup: SOURCE_READ,
+  semantic_search: SOURCE_READ,
+  map_lookup: SOURCE_READ,
+  changed_lookup: SOURCE_READ,
+  outline: SOURCE_READ,
+  exports: SOURCE_READ,
+  imports: SOURCE_READ,
+  dep_docs: SOURCE_READ,
+  csv_query: SOURCE_READ,
+  csv_profile: SOURCE_READ,
+  pdf_extract: SOURCE_READ,
+  pdf_locate: SOURCE_READ,
+  pdf_outline: SOURCE_READ,
+  pdf_meta: SOURCE_READ,
+  xlsx_sheets: SOURCE_READ,
+  xlsx_head: SOURCE_READ,
+  xlsx_range: SOURCE_READ,
+  xlsx_query: SOURCE_READ,
+  xlsx_columns: SOURCE_READ,
+  pptx_outline: SOURCE_READ,
+  pptx_slide: SOURCE_READ,
+  pptx_notes: SOURCE_READ,
+  pptx_text: SOURCE_READ,
+  docx_outline: SOURCE_READ,
+  docx_tables: SOURCE_READ,
+  docx_text: SOURCE_READ,
+  transcript_outline: SOURCE_READ,
+  transcript: SOURCE_READ,
+  video_chapters: SOURCE_READ,
+  image_meta: SOURCE_READ,
+  image_text: SOURCE_READ,
+  coverage_report_gaps: SOURCE_READ,
+  json_query: SOURCE_READ,
+  json_outline: SOURCE_READ,
+  yaml_query: SOURCE_READ,
+  yaml_outline: SOURCE_READ,
+  xml_query: SOURCE_READ,
+  xml_outline: SOURCE_READ,
+  html_query: SOURCE_READ,
+  html_outline: SOURCE_READ,
+  openapi_op: SOURCE_READ,
+  openapi_outline: SOURCE_READ,
+  zip_list: SOURCE_READ,
+  zip_read: SOURCE_READ,
+  sqlite_query: SOURCE_READ,
+  sqlite_schema: SOURCE_READ,
+  sqlite_tables: SOURCE_READ,
+  conflicts: SOURCE_READ,
+  brief_view: SOURCE_READ,
+  session_outline: SOURCE_READ,
+  session_slice: SOURCE_READ,
+  gdrive_sections: SOURCE_READ,
+  pr_slice: SOURCE_READ,
+  compact_doc: SOURCE_READ,
+  note_read: SOURCE_READ,
+  note_list: SOURCE_READ,
+  // note-add is a write (like insert-section/replace, which record no stat at all -- neither
+  // has a "full source it replaces" savings concept). It still gets an event-only entry here
+  // (no bytesSaved/tokensSaved argument, same as skill_load) purely so `token-goat note-add`
+  // usage is visible in `token-goat stats --full` at all -- SOURCE_OTHER, not SOURCE_READ,
+  // since it is not a token-savings substitute for a read.
+  note_write: SOURCE_OTHER,
+  web_fetch: SOURCE_WEB,
+  injection_detected: SOURCE_WEB,
+  skill_load: SOURCE_SKILL,
+  skill_oversized_first_load: SOURCE_SKILL,
+  // Cold first load of an oversized skill where preSkillHandler inlined the compact slice in its reply instead of pointing at `skill-body --compact`. Unlike its skill_oversized_first_load sibling (event-only, 0 bytes -- the pointer deny saves nothing by itself, the follow-up command does) this one records real savings: the full body never landed, the slice did, so bytesSaved is body minus slice.
+  skill_compact_inlined: SOURCE_SKILL,
+  // Cold first load of an oversized skill with no compact marker at all, where preSkillHandler inlined a heading tree in its reply instead of letting the whole body fall through. Same shape as skill_compact_inlined: real savings, bytesSaved is body minus the rendered tree.
+  skill_heading_tree_inlined: SOURCE_SKILL,
+  secret_redacted: SOURCE_OTHER,
+  // Fail-soft diagnostic counters from hooks_edit.ts: they record that a side task threw, never a byte saving, so "other" is the right home. Listed explicitly rather than left to kindToSource()'s fallback so the registration guard can tell a deliberate placement from an unregistered kind.
+  dirty_queue_append_failed: SOURCE_OTHER,
+  worker_healthcheck_failed: SOURCE_OTHER,
+  known_root_record_failed: SOURCE_OTHER,
+  // Measurement of what a compaction produced (hooks_compact.ts postCompactHandler): summary size and how many manifest paths survived into it. SOURCE_OTHER and always recorded at (0, 0) -- the summary was written whether or not token-goat was watching, so there is no counterfactual in which those bytes were saved. Filing it anywhere with a savings total would credit token-goat for the whole summary, which is the accounting mistake this registry exists to prevent.
+  compact_summary: SOURCE_OTHER,
+  // Envelope compaction of an oversized subagent report (hooks_agent_spawn.ts). SOURCE_CONTENT, not SOURCE_HINT: the handler's sibling session_hint entry is advisory (it only appends a recall pointer and genuinely saves nothing), whereas this kind records a real rewrite with real bytes removed, so filing it under the advisory bucket would understate the compaction and repeat the zero-savings desync this registry keeps getting bitten by.
+  agent_report_compact: SOURCE_CONTENT,
+  // Decline counterpart to agent_report_compact: the fence-collapse net-benefit gate ran and found at least one over-long fence, but declined to rewrite because net savings did not clear the notice cost. Always recorded at (0, 0) -- see the recordStat call site -- so it never contributes to any savings total; it exists purely to make gate hit-rate and near-misses visible instead of the decline being invisible.
+  agent_report_compact_declined: SOURCE_CONTENT,
+  content_compress: SOURCE_CONTENT,
+  // Verbatim-repeat collapse of a browser tool's "Tab Context:" text block (hooks_browser_image.ts postBrowserImageHandler). SOURCE_CONTENT for the same reason as agent_report_compact above: it is a real rewrite with real bytes removed, not an advisory nudge. Deliberately not SOURCE_IMAGE -- it shares a handler with image_shrink but collapses text, and folding text bytes into the image ledger is the two-units-under-one-label mistake this file's image_shrink entry was just fixed for.
+  browser_tab_dedup: SOURCE_CONTENT,
+  // Collapse of the plan echo in an approved ExitPlanMode result (hooks_exitplanmode.ts). SOURCE_CONTENT for the same reason as agent_report_compact: real bytes removed from a tool result, not an advisory nudge. The handler shipped for releases emitting this rewrite and recording nothing at all, so the mechanism was invisible in `stats` and its net benefit could not be checked against the gate that admits it.
+  plan_echo_collapse: SOURCE_CONTENT,
+  // Lossless re-layout of Grep content-mode output (hooks_grep.ts foldGrepContentHandler). SOURCE_CONTENT, not SOURCE_HINT, for the same reason as agent_report_compact above: its sibling grep_dedup_hint is advisory and saves nothing directly, whereas this is a real rewrite with real bytes removed. Filing it under the advisory bucket would silently add non-hint savings to hint_stats.ts's savedBytes (which reads by_source[SOURCE_HINT] wholesale) and overstate the hint ledger's net benefit.
+  "grep:fold": SOURCE_CONTENT,
+  // Withholding of already-served stretches from a completed Read (hooks_read.ts
+  // elideAlreadyServedLines). SOURCE_CONTENT, not SOURCE_HINT, for the same reason as
+  // grep:fold above: its siblings read_count_deny and read_served_deny are decisions about
+  // whether a read happens at all, whereas this is a rewrite of a result that did happen,
+  // with real bytes removed from it. Filing it under the advisory bucket would add non-hint
+  // savings to hint_stats.ts's savedBytes, which reads by_source[SOURCE_HINT] wholesale.
+  "read:served_elide": SOURCE_CONTENT,
+  // Same bucket and same reasoning as read:served_elide directly above: a rewrite of a Read that did happen, with real bytes removed, not an advisory about whether to read at all.
+  "read:body_fold": SOURCE_CONTENT,
+  // Same bucket and same reasoning as read:body_fold directly above: a coarser sibling rewrite of a large untargeted markdown Read (hooks_read.ts foldMarkdownOutline) that replaces the body with a heading tree plus preamble, with real bytes removed, not an advisory about whether to read at all.
+  "read:markdown_outline": SOURCE_CONTENT,
+  // Same bucket and same reasoning as read:markdown_outline directly above, on source instead of prose: the structural-skeleton replacement of a large untargeted source Read (hooks_read.ts foldSourceSkeleton), with real bytes removed, not an advisory about whether to read at all.
+  "read:source_skeleton": SOURCE_CONTENT,
+  content_retrieve: SOURCE_CONTENT,
+  handoff_create: SOURCE_CONTENT,
+  handoff_resolve: SOURCE_CONTENT
+};
+var KIND_PREFIX_TO_SOURCE = [
+  ["bash_compress:", SOURCE_BASH],
+  ["webfetch:", SOURCE_WEB],
+  ["gdrive:", SOURCE_WEB],
+  ["mcp:", SOURCE_MCP],
+  ["skill_body:", SOURCE_SKILL],
+  ["skill_compact:", SOURCE_SKILL],
+  ["bashoutput:", SOURCE_BASH],
+  ["taskoutput:", SOURCE_CONTENT]
+];
+var COMMAND_KINDS = {
+  symbol: /* @__PURE__ */ new Set(["symbol_lookup"]),
+  read: /* @__PURE__ */ new Set(["read_replacement"]),
+  section: /* @__PURE__ */ new Set(["section_replacement", "section_read"]),
+  semantic: /* @__PURE__ */ new Set(["semantic_search"]),
+  outline: /* @__PURE__ */ new Set(["outline"]),
+  exports: /* @__PURE__ */ new Set(["exports"]),
+  imports: /* @__PURE__ */ new Set(["imports"]),
+  skeleton: /* @__PURE__ */ new Set(["stub_view"]),
+  refs: /* @__PURE__ */ new Set(["symbol_read"]),
+  map: /* @__PURE__ */ new Set(["map_lookup"]),
+  changed: /* @__PURE__ */ new Set(["changed_lookup"]),
+  "dep-docs": /* @__PURE__ */ new Set(["dep_docs"]),
+  "csv-query": /* @__PURE__ */ new Set(["csv_query"]),
+  "csv-profile": /* @__PURE__ */ new Set(["csv_profile"]),
+  "pdf-extract": /* @__PURE__ */ new Set(["pdf_extract"]),
+  "pdf-locate": /* @__PURE__ */ new Set(["pdf_locate"]),
+  "pdf-outline": /* @__PURE__ */ new Set(["pdf_outline"]),
+  "pdf-meta": /* @__PURE__ */ new Set(["pdf_meta"]),
+  "xlsx-sheets": /* @__PURE__ */ new Set(["xlsx_sheets"]),
+  "xlsx-head": /* @__PURE__ */ new Set(["xlsx_head"]),
+  "xlsx-range": /* @__PURE__ */ new Set(["xlsx_range"]),
+  "xlsx-query": /* @__PURE__ */ new Set(["xlsx_query"]),
+  "xlsx-columns": /* @__PURE__ */ new Set(["xlsx_columns"]),
+  "pptx-outline": /* @__PURE__ */ new Set(["pptx_outline"]),
+  "pptx-slide": /* @__PURE__ */ new Set(["pptx_slide"]),
+  "pptx-notes": /* @__PURE__ */ new Set(["pptx_notes"]),
+  "pptx-text": /* @__PURE__ */ new Set(["pptx_text"]),
+  "docx-outline": /* @__PURE__ */ new Set(["docx_outline"]),
+  "docx-tables": /* @__PURE__ */ new Set(["docx_tables"]),
+  "docx-text": /* @__PURE__ */ new Set(["docx_text"]),
+  "transcript-outline": /* @__PURE__ */ new Set(["transcript_outline"]),
+  transcript: /* @__PURE__ */ new Set(["transcript"]),
+  "video-chapters": /* @__PURE__ */ new Set(["video_chapters"]),
+  "image-meta": /* @__PURE__ */ new Set(["image_meta"]),
+  "image-text": /* @__PURE__ */ new Set(["image_text"]),
+  "coverage-report-gaps": /* @__PURE__ */ new Set(["coverage_report_gaps"]),
+  "json-query": /* @__PURE__ */ new Set(["json_query"]),
+  "json-outline": /* @__PURE__ */ new Set(["json_outline"]),
+  "yaml-query": /* @__PURE__ */ new Set(["yaml_query"]),
+  "yaml-outline": /* @__PURE__ */ new Set(["yaml_outline"]),
+  "xml-query": /* @__PURE__ */ new Set(["xml_query"]),
+  "xml-outline": /* @__PURE__ */ new Set(["xml_outline"]),
+  "html-query": /* @__PURE__ */ new Set(["html_query"]),
+  "html-outline": /* @__PURE__ */ new Set(["html_outline"]),
+  "openapi-op": /* @__PURE__ */ new Set(["openapi_op"]),
+  "openapi-outline": /* @__PURE__ */ new Set(["openapi_outline"]),
+  "zip-list": /* @__PURE__ */ new Set(["zip_list"]),
+  "zip-read": /* @__PURE__ */ new Set(["zip_read"]),
+  "sqlite-query": /* @__PURE__ */ new Set(["sqlite_query"]),
+  "sqlite-schema": /* @__PURE__ */ new Set(["sqlite_schema"]),
+  "sqlite-tables": /* @__PURE__ */ new Set(["sqlite_tables"]),
+  conflicts: /* @__PURE__ */ new Set(["conflicts"]),
+  brief: /* @__PURE__ */ new Set(["brief_view"]),
+  "session-outline": /* @__PURE__ */ new Set(["session_outline"]),
+  "session-slice": /* @__PURE__ */ new Set(["session_slice"]),
+  "gdrive-sections": /* @__PURE__ */ new Set(["gdrive_sections"]),
+  "pr-slice": /* @__PURE__ */ new Set(["pr_slice"]),
+  "compact-doc": /* @__PURE__ */ new Set(["compact_doc"]),
+  "note-add": /* @__PURE__ */ new Set(["note_write"]),
+  "note-get": /* @__PURE__ */ new Set(["note_read"]),
+  "note-list": /* @__PURE__ */ new Set(["note_list"]),
+  "compress-text": /* @__PURE__ */ new Set(["content_compress"]),
+  retrieve: /* @__PURE__ */ new Set(["content_retrieve"]),
+  "handoff-create": /* @__PURE__ */ new Set(["handoff_create"]),
+  "handoff-resolve": /* @__PURE__ */ new Set(["handoff_resolve"]),
+  npm: /* @__PURE__ */ new Set([
+    "bash_compress:npm_install",
+    "bash_compress:npm_ci",
+    "bash_compress:npm_audit",
+    "bash_compress:npm_ls",
+    "bash_compress:npm_outdated",
+    "bash_compress:npx"
+  ])
+};
+var OVERHEAD_SUFFIX = "_overhead";
+function kindToSource(kind) {
+  const src = KIND_TO_SOURCE[kind];
+  if (src !== void 0) return src;
+  if (kind.endsWith(OVERHEAD_SUFFIX)) {
+    const base = kind.slice(0, -OVERHEAD_SUFFIX.length);
+    const baseSrc = KIND_TO_SOURCE[base];
+    if (baseSrc !== void 0) return baseSrc;
+  }
+  for (const [prefix, prefixSrc] of KIND_PREFIX_TO_SOURCE) {
+    if (kind.startsWith(prefix)) return prefixSrc;
+  }
+  return SOURCE_OTHER;
+}
+function toLocalDateKey(d) {
+  const year = d.getFullYear();
+  const month = String(d.getMonth() + 1).padStart(2, "0");
+  const day = String(d.getDate()).padStart(2, "0");
+  return `${year}-${month}-${day}`;
+}
+function formatLocalTimestamp(d) {
+  const hours = String(d.getHours()).padStart(2, "0");
+  const minutes = String(d.getMinutes()).padStart(2, "0");
+  const seconds = String(d.getSeconds()).padStart(2, "0");
+  return `${toLocalDateKey(d)}T${hours}:${minutes}:${seconds}`;
+}
+function zeroBucket() {
+  return { events: 0, bytes_saved: 0, tokens_saved: 0 };
+}
+function incBucket(bucket, bytesSaved, tokensSaved) {
+  bucket.events += 1;
+  bucket.bytes_saved += bytesSaved;
+  bucket.tokens_saved += tokensSaved;
+}
+var GLOBAL_SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS stats (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  ts INTEGER NOT NULL,
+  kind TEXT NOT NULL,
+  tokens_saved INTEGER NOT NULL DEFAULT 0,
+  bytes_saved INTEGER NOT NULL DEFAULT 0,
+  detail TEXT,
+  harness TEXT,
+  traceparent TEXT,
+  tg_version TEXT
+);
+CREATE INDEX IF NOT EXISTS idx_stats_ts ON stats(ts);
+CREATE INDEX IF NOT EXISTS idx_stats_kind ON stats(kind);
+-- Day-granularity rollup of stats rows older than STATS_RETENTION_DAYS -- see
+-- rollupAndPruneStats's doc comment for why raw rows are pruned instead of kept forever, and
+-- summarize()'s rollup merge for how a --window-days report spanning pruned days still gets a
+-- correct total. Deliberately day+kind+harness+tg_version, not day+kind alone: those are exactly
+-- the dimensions summarize() breaks totals out by, and collapsing any of them here would make an
+-- old --window-days report under-report a breakdown a recent one still shows in full.
+CREATE TABLE IF NOT EXISTS stats_daily_rollup (
+  day TEXT NOT NULL,
+  kind TEXT NOT NULL,
+  harness TEXT NOT NULL DEFAULT '',
+  tg_version TEXT NOT NULL DEFAULT '',
+  events INTEGER NOT NULL DEFAULT 0,
+  bytes_saved INTEGER NOT NULL DEFAULT 0,
+  tokens_saved INTEGER NOT NULL DEFAULT 0,
+  PRIMARY KEY (day, kind, harness, tg_version)
+);
+CREATE INDEX IF NOT EXISTS idx_stats_daily_rollup_day ON stats_daily_rollup(day);
+-- Single-row (id=1, same pattern as embedding_provenance in db.ts) throttle so the rollup+prune
+-- pass -- an aggregate scan over the whole stats table -- runs at most once per
+-- STATS_ROLLUP_INTERVAL_MS regardless of how often recordStat() itself is called (many times a
+-- minute during active use).
+CREATE TABLE IF NOT EXISTS stats_maintenance (
+  id INTEGER PRIMARY KEY CHECK (id = 1),
+  last_rollup_ts INTEGER NOT NULL DEFAULT 0
+);
+CREATE TABLE IF NOT EXISTS unmapped_tools (
+  harness TEXT NOT NULL,
+  tool_name TEXT NOT NULL,
+  event_name TEXT NOT NULL,
+  near_miss TEXT,
+  first_seen INTEGER NOT NULL,
+  last_seen INTEGER NOT NULL,
+  hits INTEGER NOT NULL DEFAULT 0,
+  PRIMARY KEY (harness, tool_name, event_name)
+);
+`;
+var _globalSchemaApplied = /* @__PURE__ */ new Set();
+registerReset(() => _globalSchemaApplied.clear());
+function migrateGlobalSchema(db) {
+  try {
+    db.exec("ALTER TABLE stats ADD COLUMN harness TEXT");
+  } catch (err) {
+    if (!(err instanceof Error) || !/duplicate column/i.test(err.message)) throw err;
+  }
+  try {
+    db.exec("ALTER TABLE stats ADD COLUMN traceparent TEXT");
+  } catch (err) {
+    if (!(err instanceof Error) || !/duplicate column/i.test(err.message)) throw err;
+  }
+  try {
+    db.exec("ALTER TABLE stats ADD COLUMN tg_version TEXT");
+  } catch (err) {
+    if (!(err instanceof Error) || !/duplicate column/i.test(err.message)) throw err;
+  }
+}
+var _harnessColumnByDb = /* @__PURE__ */ new WeakMap();
+function statsHasHarnessColumn(db) {
+  const cached = _harnessColumnByDb.get(db);
+  if (cached !== void 0) return cached;
+  let present;
+  try {
+    present = db.prepare("PRAGMA table_info(stats)").all().some(
+      (c) => c.name === "harness"
+    );
+  } catch {
+    present = false;
+  }
+  _harnessColumnByDb.set(db, present);
+  return present;
+}
+var _traceparentColumnByDb = /* @__PURE__ */ new WeakMap();
+function statsHasTraceparentColumn(db) {
+  const cached = _traceparentColumnByDb.get(db);
+  if (cached !== void 0) return cached;
+  let present;
+  try {
+    present = db.prepare("PRAGMA table_info(stats)").all().some(
+      (c) => c.name === "traceparent"
+    );
+  } catch {
+    present = false;
+  }
+  _traceparentColumnByDb.set(db, present);
+  return present;
+}
+var _versionColumnByDb = /* @__PURE__ */ new WeakMap();
+function statsHasVersionColumn(db) {
+  const cached = _versionColumnByDb.get(db);
+  if (cached !== void 0) return cached;
+  let present;
+  try {
+    present = db.prepare("PRAGMA table_info(stats)").all().some(
+      (c) => c.name === "tg_version"
+    );
+  } catch {
+    present = false;
+  }
+  _versionColumnByDb.set(db, present);
+  return present;
+}
+function getGlobalDb(homeDir) {
+  const basePath = homeDir ? dataDirForHome(homeDir) : dataDir();
+  const dbPath = path.join(basePath, "global.db");
+  const db = getDb(dbPath);
+  if (!_globalSchemaApplied.has(dbPath)) {
+    db.exec(GLOBAL_SCHEMA_SQL);
+    migrateGlobalSchema(db);
+    _globalSchemaApplied.add(dbPath);
+  }
+  return db;
+}
+var STATS_RETENTION_DAYS = 180;
+var STATS_ROLLUP_INTERVAL_MS = 6 * 60 * 60 * 1e3;
+function rollupAndPruneStats(db, retentionDays = STATS_RETENTION_DAYS) {
+  try {
+    const cutoffTs = Math.floor(Date.now() / 1e3) - retentionDays * 86400;
+    const run = db.transaction((cutoff) => {
+      db.prepare(
+        `INSERT INTO stats_daily_rollup (day, kind, harness, tg_version, events, bytes_saved, tokens_saved)
+         SELECT strftime('%Y-%m-%d', ts, 'unixepoch', 'localtime') AS day,
+                kind,
+                COALESCE(harness, '') AS harness,
+                COALESCE(tg_version, '') AS tg_version,
+                COUNT(*), SUM(bytes_saved), SUM(tokens_saved)
+         FROM stats
+         WHERE ts < ?
+         GROUP BY day, kind, harness, tg_version
+         ON CONFLICT(day, kind, harness, tg_version) DO UPDATE SET
+           events = events + excluded.events,
+           bytes_saved = bytes_saved + excluded.bytes_saved,
+           tokens_saved = tokens_saved + excluded.tokens_saved`
+      ).run(cutoff);
+      db.prepare(`DELETE FROM stats WHERE ts < ?`).run(cutoff);
+    });
+    run(cutoffTs);
+  } catch {
+  }
+}
+function maybeRunStatsMaintenance(db) {
+  try {
+    const now = Date.now();
+    const row = db.prepare(`SELECT last_rollup_ts FROM stats_maintenance WHERE id = 1`).get();
+    const last = row?.last_rollup_ts ?? 0;
+    if (now - last < STATS_ROLLUP_INTERVAL_MS) return;
+    db.prepare(
+      `INSERT INTO stats_maintenance (id, last_rollup_ts) VALUES (1, ?)
+       ON CONFLICT(id) DO UPDATE SET last_rollup_ts = excluded.last_rollup_ts`
+    ).run(now);
+    rollupAndPruneStats(db);
+  } catch {
+  }
+}
+function noStatsMessage(windowDays, homeDir) {
+  if (windowDays <= 0) return "No stats recorded yet.";
+  const db = getGlobalDb(homeDir);
+  let total = db.prepare("SELECT COUNT(*) as c FROM stats").get().c;
+  try {
+    const rollupTable = db.prepare(`SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = 'stats_daily_rollup'`).get();
+    if (rollupTable !== void 0) {
+      const rolledUp = db.prepare("SELECT COALESCE(SUM(events), 0) as c FROM stats_daily_rollup").get().c;
+      total += rolledUp;
+    }
+  } catch {
+  }
+  if (total === 0) return "No stats recorded yet.";
+  return `No stats in the last ${countNoun(windowDays, "day")} (${total} recorded outside this window; use --window-days 0 for all time).`;
+}
+function recordStat(kind, bytesSaved = 0, tokensSaved = 0, _testDb, detail, traceparent) {
+  try {
+    const db = _testDb ?? getGlobalDb();
+    const ts = Math.floor(Date.now() / 1e3);
+    const tp = traceparent ?? process.env["TRACEPARENT"] ?? process.env["traceparent"] ?? null;
+    const cols = ["ts", "kind", "bytes_saved", "tokens_saved", "detail"];
+    const vals = [ts, kind, bytesSaved, tokensSaved, detail ?? null];
+    if (statsHasHarnessColumn(db)) {
+      cols.push("harness");
+      vals.push(getHarnessName());
+    }
+    if (statsHasTraceparentColumn(db)) {
+      cols.push("traceparent");
+      vals.push(tp);
+    }
+    if (statsHasVersionColumn(db)) {
+      cols.push("tg_version");
+      vals.push(VERSION);
+    }
+    db.prepare(
+      `INSERT INTO stats (${cols.join(", ")}) VALUES (${cols.map(() => "?").join(", ")})`
+    ).run(...vals);
+    maybeRunStatsMaintenance(db);
+  } catch {
+  }
+}
+var MAX_TOOL_NAME_CHARS = 200;
+function recordUnmappedTool(toolName, eventName, nearMiss, _testDb) {
+  try {
+    if (!toolName) return;
+    const db = _testDb ?? getGlobalDb();
+    const now = Math.floor(Date.now() / 1e3);
+    db.prepare(
+      `INSERT INTO unmapped_tools (harness, tool_name, event_name, near_miss, first_seen, last_seen, hits)
+       VALUES (?, ?, ?, ?, ?, ?, 1)
+       ON CONFLICT(harness, tool_name, event_name) DO UPDATE SET
+         hits = hits + 1,
+         last_seen = excluded.last_seen,
+         near_miss = excluded.near_miss`
+    ).run(getHarnessName(), toolName.slice(0, MAX_TOOL_NAME_CHARS), eventName, nearMiss, now, now);
+  } catch {
+  }
+}
+function readUnmappedTools(dbPath, homeDir) {
+  try {
+    const db = dbPath ? getDb(dbPath) : getGlobalDb(homeDir);
+    return db.prepare(
+      "SELECT harness, tool_name, event_name, near_miss, hits, last_seen FROM unmapped_tools ORDER BY hits DESC, tool_name ASC"
+    ).all();
+  } catch {
+    return [];
+  }
+}
+function summarize(windowDays = 30, testDb, homeDir) {
+  const t0 = Date.now();
+  const sinceTs = windowDays > 0 ? Math.floor((Date.now() - windowDays * 24 * 60 * 60 * 1e3) / 1e3) : null;
+  const byKind = {};
+  const byDay = {};
+  const byHarness = {};
+  const byPricingVersion = {};
+  let totalEvents = 0;
+  let totalBytes = 0;
+  let totalTokens = 0;
+  const db = testDb ?? getGlobalDb(homeDir);
+  const hasHarness = statsHasHarnessColumn(db);
+  const hasVersion = statsHasVersionColumn(db);
+  const cols = [
+    "ts",
+    "kind",
+    "bytes_saved",
+    "tokens_saved",
+    ...hasHarness ? ["harness"] : [],
+    ...hasVersion ? ["tg_version"] : []
+  ].join(", ");
+  const query = sinceTs !== null ? `SELECT ${cols} FROM stats WHERE ts >= ? ORDER BY ts DESC` : `SELECT ${cols} FROM stats ORDER BY ts DESC`;
+  const stmt = db.prepare(query);
+  const rows = sinceTs !== null ? stmt.all(sinceTs) : stmt.all();
+  const tsToDateCache = {};
+  const counts = {};
+  for (const row of rows) {
+    const bytesSaved = row.bytes_saved ?? 0;
+    const recorded = row.tokens_saved ?? 0;
+    const kind = row.kind;
+    const isCount = COUNT_ONLY_KINDS.has(kind);
+    if (isCount) counts[kind] = (counts[kind] ?? 0) + recorded;
+    const tokensSaved = isCount ? 0 : recorded;
+    const tsRaw = row.ts;
+    if (tsRaw === void 0) continue;
+    const ts = tsRaw;
+    totalEvents += 1;
+    totalBytes += bytesSaved;
+    totalTokens += tokensSaved;
+    if (!byKind[kind]) {
+      byKind[kind] = zeroBucket();
+    }
+    incBucket(byKind[kind], bytesSaved, tokensSaved);
+    const dateKey = tsToDateCache[ts] || toLocalDateKey(new Date(ts * 1e3));
+    tsToDateCache[ts] = dateKey;
+    if (!byDay[dateKey]) {
+      byDay[dateKey] = zeroBucket();
+    }
+    incBucket(byDay[dateKey], bytesSaved, tokensSaved);
+    const harness = row.harness || HARNESS_UNRECORDED;
+    if (!byHarness[harness]) {
+      byHarness[harness] = zeroBucket();
+    }
+    incBucket(byHarness[harness], bytesSaved, tokensSaved);
+    const pricingVersion = row.tg_version || PRICING_VERSION_UNRECORDED;
+    if (!byPricingVersion[pricingVersion]) {
+      byPricingVersion[pricingVersion] = zeroBucket();
+    }
+    incBucket(byPricingVersion[pricingVersion], bytesSaved, tokensSaved);
+  }
+  try {
+    const rollupTable = db.prepare(`SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = 'stats_daily_rollup'`).get();
+    if (rollupTable !== void 0) {
+      const sinceDayKey = sinceTs !== null ? toLocalDateKey(new Date(sinceTs * 1e3)) : null;
+      const rollupRows = sinceDayKey !== null ? db.prepare(`SELECT day, kind, harness, tg_version, events, bytes_saved, tokens_saved FROM stats_daily_rollup WHERE day >= ?`).all(sinceDayKey) : db.prepare(`SELECT day, kind, harness, tg_version, events, bytes_saved, tokens_saved FROM stats_daily_rollup`).all();
+      const addBucket = (bucket, events, bytesSaved, tokensSaved) => {
+        bucket.events += events;
+        bucket.bytes_saved += bytesSaved;
+        bucket.tokens_saved += tokensSaved;
+      };
+      for (const r of rollupRows) {
+        const isCount = COUNT_ONLY_KINDS.has(r.kind);
+        if (isCount) counts[r.kind] = (counts[r.kind] ?? 0) + r.tokens_saved;
+        const tokensSaved = isCount ? 0 : r.tokens_saved;
+        const bytesSaved = r.bytes_saved;
+        totalEvents += r.events;
+        totalBytes += bytesSaved;
+        totalTokens += tokensSaved;
+        if (!byKind[r.kind]) byKind[r.kind] = zeroBucket();
+        addBucket(byKind[r.kind], r.events, bytesSaved, tokensSaved);
+        if (!byDay[r.day]) byDay[r.day] = zeroBucket();
+        addBucket(byDay[r.day], r.events, bytesSaved, tokensSaved);
+        const harness = r.harness || HARNESS_UNRECORDED;
+        if (!byHarness[harness]) byHarness[harness] = zeroBucket();
+        addBucket(byHarness[harness], r.events, bytesSaved, tokensSaved);
+        const pricingVersion = r.tg_version || PRICING_VERSION_UNRECORDED;
+        if (!byPricingVersion[pricingVersion]) byPricingVersion[pricingVersion] = zeroBucket();
+        addBucket(byPricingVersion[pricingVersion], r.events, bytesSaved, tokensSaved);
+      }
+    }
+  } catch {
+  }
+  const bySourceDict = {};
+  for (const [kind, bucket] of Object.entries(byKind)) {
+    const source = kindToSource(kind);
+    if (!bySourceDict[source]) {
+      bySourceDict[source] = zeroBucket();
+    }
+    bySourceDict[source].events += bucket.events;
+    bySourceDict[source].bytes_saved += bucket.bytes_saved;
+    bySourceDict[source].tokens_saved += bucket.tokens_saved;
+  }
+  const byCommandDict = {};
+  for (const [cmd, kinds] of Object.entries(COMMAND_KINDS)) {
+    byCommandDict[cmd] = zeroBucket();
+    for (const kind of kinds) {
+      if (byKind[kind]) {
+        byCommandDict[cmd].events += byKind[kind].events;
+        byCommandDict[cmd].bytes_saved += byKind[kind].bytes_saved;
+        byCommandDict[cmd].tokens_saved += byKind[kind].tokens_saved;
+      }
+    }
+  }
+  const byDayList = Object.entries(byDay).map(([date, bucket]) => ({ ...bucket, date })).sort((a, b) => new Date(b.date).getTime() - new Date(a.date).getTime());
+  const byProjectList = [];
+  const t1 = Date.now();
+  if (t1 - t0 > 1e3) {
+    console.warn(`summarize took ${t1 - t0}ms (window=${windowDays}d, total=${totalEvents} rows)`);
+  }
+  return {
+    total_events: totalEvents,
+    total_bytes_saved: totalBytes,
+    total_tokens_saved: totalTokens,
+    by_kind: byKind,
+    by_day: byDayList,
+    by_project: byProjectList,
+    by_source: bySourceDict,
+    by_harness: byHarness,
+    by_pricing_version: byPricingVersion,
+    counts,
+    by_command: Object.entries(byCommandDict).map(([command, bucket]) => ({ ...bucket, command })).filter((r) => r.events > 0),
+    window_days: windowDays
+  };
+}
+function _totalsLines(summary) {
+  return [
+    "# token-goat stats",
+    `Total events:   ${summary.total_events}`,
+    `Bytes saved:    ${fmtBytes(summary.total_bytes_saved)}`,
+    `Tokens saved:   ${summary.total_tokens_saved}`,
+    // Disclosure, not a correction: `total_tokens_saved` above sums rows written under whichever
+    // pricing formula was live when each was recorded, and `tg_version` cannot be read back into
+    // "which formula" for a row from before this disclosure existed (PRICING_VERSION_UNRECORDED is
+    // the overwhelming majority of all-time rows). Excluding those rows from the headline would
+    // discard nearly the whole figure rather than fix it, so the honest move is to keep the sum and
+    // say plainly that it spans more than one era, not to quietly present a mixed total as single-formula.
+    ...hasMixedPricingEras(summary) ? [
+      `Pricing note:   totals mix ${countNoun(Object.keys(summary.by_pricing_version).length, "tg_version era")} (${countNoun(summary.by_pricing_version[PRICING_VERSION_UNRECORDED]?.events ?? 0, "row")} unrecorded); see 'token-goat stats --json' -> by_pricing_version for the breakdown`
+    ] : [],
+    // Printed on its own line, below the token total and never inside it, because it counts
+    // placeholders rather than tokens. Omitted entirely when nothing was redacted, so the line is
+    // information rather than a permanent zero. See COUNT_ONLY_KINDS.
+    ...summary.counts["secret_redacted"] ? [`Secrets hidden: ${summary.counts["secret_redacted"]} (a count, not tokens)`] : [],
+    `Window:         ${summary.window_days} days`
+  ];
+}
+function _useRichStats() {
+  if (process.env["NO_COLOR"]) return false;
+  if (process.stdout.isTTY === true) return true;
+  return process.stdout.isTTY === void 0 && !process.env["CI"];
+}
+function _renderShortTotals(summary) {
+  const lines = [
+    ..._totalsLines(summary),
+    "",
+    "Run 'token-goat stats --full' for the full breakdown (by source, by command, by day)."
+  ];
+  console.log(lines.join("\n"));
+}
+function _plainTextStats(summary) {
+  const lines = _totalsLines(summary);
+  if (Object.keys(summary.by_source).length > 0) {
+    lines.push("", "## By Source");
+    const sources = Object.entries(summary.by_source).filter(([, b]) => b.events > 0).sort((a, b) => b[1].tokens_saved - a[1].tokens_saved);
+    for (const [source, bucket] of sources) {
+      lines.push(
+        `  ${source.padEnd(8)} ${bucket.events.toString().padStart(6)} events  ${fmtBytes(bucket.bytes_saved).padStart(8)}  ${bucket.tokens_saved.toString().padStart(8)} tokens`
+      );
+    }
+  }
+  const harnesses = Object.entries(summary.by_harness).filter(([, b]) => b.events > 0).sort((a, b) => b[1].tokens_saved - a[1].tokens_saved);
+  if (harnesses.length > 1) {
+    lines.push("", "## By Harness");
+    for (const [harness, bucket] of harnesses) {
+      lines.push(
+        `  ${harness.padEnd(22)} ${bucket.events.toString().padStart(6)} events  ${fmtBytes(bucket.bytes_saved).padStart(8)}  ${bucket.tokens_saved.toString().padStart(8)} tokens`
+      );
+    }
+  }
+  if (summary.by_command.length > 0) {
+    lines.push("", "## By Command");
+    for (const row of summary.by_command) {
+      lines.push(
+        `  ${row.command.padEnd(12)} ${row.events.toString().padStart(6)} events  ${fmtBytes(row.bytes_saved).padStart(8)}  ${row.tokens_saved.toString().padStart(8)} tokens`
+      );
+    }
+  } else {
+    const hintBucket = summary.by_source[SOURCE_HINT];
+    if (hintBucket && hintBucket.events > 0) {
+      lines.push(
+        "",
+        "## By Command",
+        `  0 direct command invocations this window -- ${hintBucket.events} hint(s) fired but not acted on.`,
+        "  Run token-goat symbol/read/section/semantic/outline/skeleton directly to capture these savings."
+      );
+    }
+  }
+  if (summary.by_day.length > 0) {
+    lines.push("", "## Last 7 Days");
+    for (const row of summary.by_day.slice(0, 7)) {
+      lines.push(
+        `  ${row.date} ${row.events.toString().padStart(6)} events  ${fmtBytes(row.bytes_saved).padStart(8)}  ${row.tokens_saved.toString().padStart(8)} tokens`
+      );
+    }
+  }
+  console.log(lines.join("\n"));
+}
+function _buildStatsData(summary, windowDays) {
+  const now = /* @__PURE__ */ new Date();
+  const periodStart = windowDays > 0 ? new Date(now.getTime() - windowDays * 24 * 60 * 60 * 1e3) : /* @__PURE__ */ new Date(0);
+  const sparkDays = [...summary.by_day].reverse().slice(-30);
+  const sparklines = sparkDays.length > 1 ? {
+    events: sparkDays.map((d) => d.events),
+    bytes: sparkDays.map((d) => d.bytes_saved),
+    tokens: sparkDays.map((d) => d.tokens_saved)
+  } : null;
+  return {
+    period_start: periodStart,
+    period_end: now,
+    version: VERSION,
+    window_label: windowDays > 0 ? `last ${countNoun(windowDays, "day")}` : "all time",
+    totals: {
+      events: summary.total_events,
+      bytes: summary.total_bytes_saved,
+      tokens: summary.total_tokens_saved,
+      sparklines
+    },
+    by_kind: Object.entries(summary.by_kind).map(([kind, bucket]) => ({
+      kind,
+      bytes: bucket.bytes_saved,
+      tokens: bucket.tokens_saved,
+      events: bucket.events,
+      bytes_mode_only: _BYTES_MODE_ONLY_KINDS.has(kind)
+    })).sort((a, b) => b.bytes - a.bytes),
+    by_day: summary.by_day.map((d) => ({
+      date: d.date,
+      bytes: d.bytes_saved,
+      tokens: d.tokens_saved,
+      events: d.events
+    })),
+    by_project: [],
+    by_source: Object.entries(summary.by_source).filter(([, b]) => b.events > 0).map(([source, bucket]) => ({
+      source,
+      bytes: bucket.bytes_saved,
+      tokens: bucket.tokens_saved,
+      events: bucket.events
+    })).sort((a, b) => b.bytes - a.bytes),
+    by_command: summary.by_command.map((c) => ({
+      command: c.command,
+      bytes: c.bytes_saved,
+      tokens: c.tokens_saved,
+      events: c.events
+    })),
+    by_harness: Object.entries(summary.by_harness).filter(([, b]) => b.events > 0).map(([harness, bucket]) => ({
+      harness,
+      bytes: bucket.bytes_saved,
+      tokens: bucket.tokens_saved,
+      events: bucket.events
+    })).sort((a, b) => b.bytes - a.bytes)
+  };
+}
+function renderShortStats(opts) {
+  const windowDays = opts?.windowDays ?? 30;
+  const summary = summarize(windowDays, void 0, opts?.homeDir);
+  if (summary.total_events === 0) {
+    console.log(noStatsMessage(windowDays, opts?.homeDir));
+    return;
+  }
+  const useTty = process.env["NO_COLOR"] ? false : opts?.force === true ? true : _useRichStats();
+  if (!useTty) {
+    _renderShortTotals(summary);
+    return;
+  }
+  const statsData = _buildStatsData(summary, windowDays);
+  process.stdout.write(renderStats(statsData, { short: true }) + "\n");
+}
+function renderStats2(opts) {
+  const windowDays = opts?.windowDays ?? 30;
+  const summary = summarize(windowDays, void 0, opts?.homeDir);
+  if (summary.total_events === 0) {
+    console.log(noStatsMessage(windowDays, opts?.homeDir));
+    return;
+  }
+  const useTty = _useRichStats();
+  if (!useTty) {
+    _plainTextStats(summary);
+    return;
+  }
+  const statsData = _buildStatsData(summary, windowDays);
+  process.stdout.write(renderStats(statsData) + "\n");
+}
+
+// src/secret_redact.ts
+init_define_import_meta_env();
+var SECRET_PATTERNS = [
+  // Anthropic keys share OpenAI's "sk-" prefix but are more specific ("sk-ant-"), so they're matched first — the generic OpenAI pattern's negative lookahead below is defense in depth, not the sole guard.
+  ["anthropic_api_key", /sk-ant-[A-Za-z0-9_-]{20,}/g],
+  // Modern (post-2024, now the default) OpenAI project keys: "sk-proj-" followed by a long base64url-ish body that legitimately contains '-' and '_' -- the generic pattern below deliberately excludes those characters (hyphenated prose would false-fire), so this needs its own entry with the more specific prefix matched first, like sk-ant- above.
+  ["openai_project_key", /sk-proj-[A-Za-z0-9_-]{20,}/g],
+  ["openai_api_key", /sk-(?!ant-|proj-)[A-Za-z0-9]{20,}/g],
+  ["aws_access_key", /AKIA[0-9A-Z]{16}/g],
+  // Fine-grained PATs ("github_pat_...") are matched before the classic gh[oprsu]_ pattern so the full token is always consumed as one match -- a fine-grained token's own body can contain '_' and could otherwise partially match the classic pattern.
+  ["github_token", /github_pat_[A-Za-z0-9_]{22,}/g],
+  ["github_token", /gh[oprsu]_[A-Za-z0-9]{36,}/g],
+  // xapp- is Slack's app-level token (Socket Mode), a bearer credential in its own right that the xox[baprs]- prefix does not cover. It gets its own entry rather than joining the alternation above because it needs the full segmented shape (xapp-<ver>-<app id>-<digits>- <hex>) to be safe: a bare /xapp-[A-Za-z0-9-]+/ redacted ordinary identifiers like "xapp-config" and the css class "xapp-container", mangling normal source. The xox* prefixes are distinctive enough on their own; "xapp-" is not.
+  ["slack_token", /xox[baprs]-[A-Za-z0-9-]+/g],
+  ["slack_token", /xapp-\d-[A-Za-z0-9]{6,}-\d{8,}-[A-Za-z0-9]{16,}/g],
+  // Matches the full block (BEGIN marker through its matching END marker), not just the header -- the actual secret material is the base64 body between them, so redacting only the header line would leave the key bytes themselves fully readable in the cached blob. The body is lazy and additionally refuses to cross a following BEGIN marker. Both halves matter. The laziness bounds a successful match at the very next END marker; the negative lookahead bounds a *failing* one, because a BEGIN with no END of its own would otherwise scan to end-of-input, and a blob full of such markers made the pass quadratic -- 6 ms, 20 ms and 78 ms for 2000, 4000 and 8000 of them, four times the work for twice the input, the same shape as the lookbehind incident described above. Private key blocks do not nest, so refusing to cross a BEGIN costs nothing in correctness. The algorithm and ` BLOCK` groups are backreferenced in the END marker rather than repeated, so a BEGIN only ever pairs with its own END spelling. Written as two independent optional groups, `BEGIN PGP PRIVATE KEY` would happily close on a distant `END RSA PRIVATE KEY BLOCK` and redact everything in between. A non-participating group backreferences as the empty string in JS, which is exactly what the unprefixed `BEGIN PRIVATE KEY` form needs. The algorithm list covers every armored private-key header openssl, ssh-keygen and gpg actually emit, not just the ones a first draft happened to think of. ENCRYPTED is the PKCS#8 passphrase-protected form (`openssl genpkey -aes256`, `ssh-keygen -m PKCS8`) and is the most common shape of all; DSA is legacy but still written verbatim; PGP carries the ` BLOCK` suffix, which is why that suffix is optional here. All three used to fall through to disk in full. An encrypted key is still key material: the passphrase can be attacked offline once the bytes are cached, so it is redacted like any other. PuTTY `.ppk` files are deliberately not matched. They have no END marker -- the private section is a `Private-Lines: N` count followed by exactly N base64 lines -- so bounding a match would take a stateful parse rather than a regex, on a path that runs over every command output. A regex guess at where the body ends is exactly the over-eager match this module's header warns against.
+  ["private_key_block", /-----BEGIN (RSA |DSA |EC |OPENSSH |ENCRYPTED |PGP )?PRIVATE KEY( BLOCK)?-----(?:(?!-----BEGIN )[\s\S])*?-----END \1PRIVATE KEY\2-----/g],
+  // Redacts only the token itself, not the "Authorization: Bearer " prefix -- the lookbehind anchors on the header name and scheme so the surrounding request-log line stays readable, matching how AWS_ACCESS_KEY_ID=... above keeps its own prefix intact. The optional quotes on either side of the colon are what let this see a header carried in JSON rather than in raw wire format. Without them the lookbehind demanded the colon sit directly against the header name and the scheme directly against the space, so a body like {"Authorization": "Bearer <token>"} -- the shape any logged fetch or MCP result arrives in -- matched nothing and the token was cached verbatim. `token` is the second scheme spelling in wide use -- it is what curl and gh examples pass for GitHub and many other APIs -- and an opaque value behind it carries exactly the same authority as one behind `Bearer`. The trailing gap is `{1,8}` rather than a single space for the same reason every other gap in this lookbehind already is: a hand-aligned or reformatted header ("Authorization: Bearer <token>") is ordinary, and demanding exactly one space there made this the one position in the pattern that a second space defeated.
+  ["auth_bearer_token", /(?<=Authorization["']?[ \t]{0,8}:[ \t]{0,8}["']?[ \t]{0,8}(?:Bearer|token)[ \t]{1,8})[A-Za-z0-9\-._~+/]{10,}=*/gi],
+  ["auth_basic_token", /(?<=Authorization["']?[ \t]{0,8}:[ \t]{0,8}["']?[ \t]{0,8}Basic[ \t])[A-Za-z0-9+/]{6,}=*/gi],
+  // JWTs have no distinctive prefix of their own, but the base64url encoding of the smallest realistic header ('{"alg":' or similar) always starts with "eyJ", so that's the practical anchor here -- each of the three dot-separated segments requires a minimum length to avoid matching a short, coincidentally dotted token.
+  //
+  // The trailing `={0,2}` on each segment is what makes a padded token match. Base64url as the JWT spec defines it drops the `=` padding, but producers that reach for a plain base64 encoder emit it anyway, and a `=` in the header or payload segment used to defeat the match outright: not a partial redaction, but none at all, so the entire token was printed. `=` cannot appear anywhere except the end of a segment, since it is not one of the characters the segment body allows, so accepting it here cannot widen the match onto anything else.
+  ["jwt", /eyJ[A-Za-z0-9_-]{10,}={0,2}\.[A-Za-z0-9_-]{10,}={0,2}\.[A-Za-z0-9_-]{10,}={0,2}/g],
+  ["npm_token", /npm_[A-Za-z0-9]{36}/g],
+  // rk_live_ (restricted keys) share the sk_live_/sk_test_ secret-key shape and risk level, so one pattern covers all three rather than adding a near-duplicate entry.
+  ["stripe_key", /(?:sk_live_|sk_test_|rk_live_)[A-Za-z0-9]{20,}/g],
+  ["google_api_key", /AIza[A-Za-z0-9_-]{35}/g],
+  // Presigned-url signatures: AWS SigV4 (X-Amz-Signature), Google Cloud Storage (X-Goog-Signature), and Azure blob SAS (sig). These are bearer credentials in query-string clothing -- anyone holding the whole url can read or write the object until it expires, and none of the prefix-anchored patterns above match them because the signature is a bare hex or base64 blob with no distinctive prefix of its own. The '[?&]' anchor and the 16-char floor are what make the short, generic 'sig' name safe to key on: a prose or code mention of "sig" never sits directly after a query separator followed by that much opaque token.
+  ["presigned_signature", /(?<=[?&](?:X-Amz-Signature|X-Goog-Signature|sig)=)[A-Za-z0-9%+/=_-]{16,}/gi],
+  // A password inside a connection url. `postgres://user:hunter2@db.internal` carries the credential in the authority section, where there is no `key=value` separator for the generic pattern below to anchor on, so a DATABASE_URL echoed by a failing migration or a psql error went through untouched. The anchors are what keep this narrow: a scheme's `://`, a userinfo segment, the colon, and a following `@`. `http://host:8080/path` has no `@` and is left alone; so is any url without credentials.
+  ["url_credentials", /(?<=:\/\/[^\s:@/]{1,64}:)[^\s:@/]{1,256}(?=@)/g],
+  // Azure storage account connection strings (`DefaultEndpointsProtocol=https;AccountName=...; AccountKey=<base64>==;EndpointSuffix=core.windows.net`) carry a full read/write key to the account in the AccountKey field, and none of the generic patterns above catch it: generic_secret_assignment's keyword list (password|passwd|secret|api[_-]?key| access[_-]?token|refresh[_-]?token|id[_-]?token) has nothing that matches "AccountKey", and an unanchored base64-shape pattern was deliberately rejected -- this module's header already warns that a bare high-entropy-blob heuristic false-fires on ordinary code, JSON and log output, and an 88-char base64 value is exactly the shape a hash, a compiled asset digest or a generated id can also take. Anchoring on the literal `AccountKey=` field name instead keeps the match specific to this one connection-string field. The value class is base64 proper (letters, digits, `+`, `/`, trailing `=` padding) and none of those characters include `;`, so the match terminates on its own at the `;` that starts the next `Name=` field -- unlike generic_secret_assignment's separator characters (`& ; # , :`), which double as ordinary credential characters and need a lookahead to tell the two roles apart, `;` is never valid base64 and needs no such lookahead here. The lookbehind keeps `AccountKey=` itself in the output, matching auth_bearer_token and presigned_signature above, so `;EndpointSuffix=core.windows.net` after it stays fully readable too. `SharedAccessKey` is the same credential one Azure service over: Service Bus, Event Hubs and Relay spell it that way (`Endpoint=sb://ns.servicebus.windows.net/;SharedAccessKeyName=Root; SharedAccessKey=<base64>`) and it carries the same authority over that namespace that AccountKey does over a storage account. `SharedAccessKeyName` is a plain identifier rather than a secret, and never matches: the separator in the lookbehind sits directly against the key name, so the `Name` in between stops it dead. The separator is spelled the way auth_bearer_token above spells its own, for the same reasons that comment records having learned the hard way. Optional quotes on either side of it, so the JSON and YAML forms a logged MCP result or api response actually arrives in are matched rather than stopped dead at the opening quote. A bounded gap rather than exactly one space, so a hand-aligned or reformatted `AccountKey = ...` in an appsettings file is not the single variant that defeats the whole pattern. Case-insensitive for the same reason presigned_signature is. The leading word boundary is what keeps the widened name from reaching into the middle of a longer identifier such as `myaccountkey=`.
+  ["azure_storage_key", /(?<=\b(?:AccountKey|SharedAccessKey)["']?[ \t]{0,8}[:=][ \t]{0,8}["']?)[A-Za-z0-9+/]{40,}=*/gi],
+  // Generic key=value assignments in .env-file and connection-string/query-string shape. The lookbehind again redacts only the value, and the value's character class deliberately excludes whitespace, '&', ';', '#', quote characters, and '[' ']' ':' -- that exclusion is what stops this from swallowing the rest of the line (a trailing comment or the next key=value pair) or the remainder of a query string past the matched parameter, which is exactly the kind of over-eager match this module's own design note above warns broad heuristics produce. The '[' ']' ':' exclusion also matters because this pattern runs last: an earlier pattern's own "OPENAI_API_KEY=[REDACTED:openai_project_key]" replacement text contains "API_KEY=" too, and without excluding those characters this pattern would re-match and double-redact its own placeholder. The length has a lower bound only (no upper bound): capping it at 64 used to leave the tail of any longer secret unredacted in plain text, which is worse than no redaction because it looks handled. A single negated-class quantifier like this cannot backtrack catastrophically -- there is no nested or overlapping quantifier for the engine to explore multiple ways of matching, so removing the upper bound does not introduce a ReDoS risk. Quotes are permitted around the separator, but never inside the value class. A quoted value is the ordinary way secrets are written -- .env files, JSON, YAML, TOML all quote by default -- and the lookbehind used to stop dead at the opening quote, so `API_KEY="..."` passed through in full while the bare `API_KEY=...` was caught. The closing quote of the key name blocked it from the other side too, which is what kept every JSON body unredacted. Keeping quotes out of the value class is still what stops the match running past the closing quote. The keyword may be a prefix of a longer key name rather than the whole of it, so the trailing identifier class below is load-bearing: without it the lookbehind required the keyword to sit immediately before the separator, and AWS_SECRET_ACCESS_KEY=, SECRET_KEY=, and DB_PASSWORD_HASH= all passed through in full. That class matches identifier characters only, so prose that merely mentions a keyword still never reaches a separator and stays unredacted. api[_-]?key covers the apikey and api-key spellings too. `& ; # , :` play two incompatible roles. They separate one field from the next (a query string, a cookie header, an inline env list), and they are also perfectly ordinary credential characters. Rejecting them outright got the first role right and the second badly wrong: the match stopped at the first one and left everything after it in plain text, so `password=corr&horse&battery` redacted four characters and printed the rest, and `DB_PASSWORD=Aa1:xyz` matched nothing at all because the run before the `:` was under the four-character floor. A tail left sitting in the open is the outcome this module's header calls worse than no redaction, because it reads as handled.
+  //
+  // So the separator role is decided by what follows rather than assumed: one of these characters ends the value only when the next thing along is another `name=` / `name:` pair, which is what an actual field separator is always followed by. `,OTHER=public` and `; other=1` still end it; the `&` in the middle of a passphrase does not. Whitespace, quotes and brackets are unchanged -- they end a value unconditionally, which is also what keeps this pattern from re-matching the `[REDACTED:...]` placeholder it just wrote.
+  ["generic_secret_assignment", /(?<=(?:password|passwd|secret|api[_-]?key|access[_-]?token|refresh[_-]?token|id[_-]?token)[a-z0-9_-]{0,64}["']?[ \t]{0,8}[:=][ \t]{0,8}["']?)(?:\\[^\n]|[^\s\\&;#,:'"[\]{}]|[&;#,:](?![ \t]*[A-Za-z_][A-Za-z0-9_.-]*[ \t]*[:=])){4,}/gi]
+];
+function countRedactionPlaceholders(text) {
+  return text.match(/\[REDACTED:[a-z0-9_]+\]/g)?.length ?? 0;
+}
+var MAX_CUSTOM_PATTERNS = 64;
+var MAX_CUSTOM_PATTERN_LENGTH = 512;
+var customCache = null;
+function compileCustomPatterns(sources) {
+  const key = JSON.stringify(sources);
+  if (customCache !== null && customCache.key === key) {
+    return { patterns: customCache.patterns, problems: customCache.problems };
+  }
+  const patterns = [];
+  const problems = [];
+  const written = sources.map((raw) => raw.trim()).filter((source) => source.length > 0);
+  for (const source of written.slice(0, MAX_CUSTOM_PATTERNS)) {
+    if (source.length > MAX_CUSTOM_PATTERN_LENGTH) {
+      problems.push({ pattern: source.slice(0, 60), reason: `longer than ${MAX_CUSTOM_PATTERN_LENGTH} characters` });
+      continue;
+    }
+    if (hasNestedQuantifier(source)) {
+      problems.push({
+        pattern: source,
+        reason: "repeats a group that already repeats, which can take exponential time to match"
+      });
+      continue;
+    }
+    let compiled;
+    try {
+      compiled = new RegExp(source, "g");
+    } catch (e) {
+      problems.push({ pattern: source, reason: e instanceof Error ? e.message : "is not a valid regular expression" });
+      continue;
+    }
+    if (new RegExp(source).test("")) {
+      problems.push({
+        pattern: source,
+        reason: "matches the empty string, so it would replace every position in the text"
+      });
+      continue;
+    }
+    if (growsExponentially(compiled)) {
+      problems.push({
+        pattern: source,
+        reason: "its running time doubles as the text grows, which can stall the process on a short input"
+      });
+      continue;
+    }
+    patterns.push(compiled);
+  }
+  if (written.length > MAX_CUSTOM_PATTERNS) {
+    problems.push({
+      pattern: `(${written.length} entries)`,
+      reason: `only the first ${MAX_CUSTOM_PATTERNS} custom patterns are used`
+    });
+  }
+  customCache = { key, patterns, problems };
+  return { patterns, problems };
+}
+var STRICT_CANDIDATE = /[A-Za-z0-9+/_-]{24,}={0,2}/g;
+function entropyBitsPerChar(s) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const ch of s) counts.set(ch, (counts.get(ch) ?? 0) + 1);
+  let bits = 0;
+  for (const n of counts.values()) {
+    const p = n / s.length;
+    bits -= p * Math.log2(p);
+  }
+  return bits;
+}
+function characterClasses(s) {
+  let n = 0;
+  if (/[a-z]/.test(s)) n++;
+  if (/[A-Z]/.test(s)) n++;
+  if (/[0-9]/.test(s)) n++;
+  if (/[+/=_-]/.test(s)) n++;
+  return n;
+}
+function looksLikeCredential(s) {
+  return characterClasses(s) >= 3 && entropyBitsPerChar(s) >= 3.5;
+}
+function redactSecrets(text, config = loadConfig()) {
+  let count = 0;
+  let out = text;
+  for (const [kind, pattern] of SECRET_PATTERNS) {
+    out = out.replace(pattern, () => {
+      count++;
+      return `[REDACTED:${kind}]`;
+    });
+  }
+  for (const pattern of compileCustomPatterns(config.redaction.custom_patterns).patterns) {
+    out = out.replace(pattern, () => {
+      count++;
+      return "[REDACTED:custom]";
+    });
+  }
+  if (config.redaction.strict) {
+    out = out.replace(STRICT_CANDIDATE, (candidate) => {
+      if (!looksLikeCredential(candidate)) return candidate;
+      count++;
+      return "[REDACTED:high_entropy]";
+    });
+  }
+  return { text: out, count };
+}
+
+// src/disk_cache.ts
+init_define_import_meta_env();
+import * as fs from "node:fs";
+import * as path2 from "node:path";
+var DEFAULT_MAX_COUNT = 200;
+var DEFAULT_MAX_AGE_MS = 24 * 3600 * 1e3;
+function sanitizeId(id) {
+  return sanitizeIdForFilename(id, 64);
+}
+function blobDir(subdir) {
+  return path2.join(tokenGoatHome(), subdir);
+}
+function blobPath(subdir, id) {
+  const safe = sanitizeId(id);
+  if (!safe) return null;
+  const dir = blobDir(subdir);
+  const candidate = path2.join(dir, `${safe}.json`);
+  try {
+    const rel = path2.relative(dir, candidate);
+    if (rel.startsWith("..")) return null;
+  } catch {
+    return null;
+  }
+  return candidate;
+}
+function isBlobStale(subdir, id) {
+  const p = blobPath(subdir, id);
+  if (p === null) return false;
+  try {
+    const stat = fs.statSync(p);
+    return Date.now() - stat.mtimeMs > DEFAULT_MAX_AGE_MS;
+  } catch {
+    return false;
+  }
+}
+function subdirCacheDefaults(subdir) {
+  try {
+    if (subdir === "bash_outputs") {
+      const bc = loadConfig().bash_compress;
+      return { maxCount: bc.cache_max_file_count, maxBytes: bc.cache_max_bytes, maxBytesPerItem: bc.cache_max_bytes_per_output };
+    }
+    if (subdir === "web_outputs") {
+      const wf = loadConfig().webfetch;
+      return { maxCount: wf.max_file_count, maxBytes: wf.max_bytes, maxBytesPerItem: Number.POSITIVE_INFINITY };
+    }
+  } catch {
+  }
+  return { maxCount: DEFAULT_MAX_COUNT, maxBytes: Number.POSITIVE_INFINITY, maxBytesPerItem: Number.POSITIVE_INFINITY };
+}
+function storeBlob(subdir, id, value, opts = {}) {
+  const p = blobPath(subdir, id);
+  if (!p) return false;
+  const defaults = subdirCacheDefaults(subdir);
+  const maxBytesPerItem = opts.maxBytesPerItem ?? defaults.maxBytesPerItem;
+  let rawJson;
+  try {
+    rawJson = JSON.stringify(value);
+  } catch {
+    return false;
+  }
+  let json;
+  try {
+    const result = redactSecrets(rawJson);
+    json = result.text;
+    if (result.count > 0) recordStat("secret_redacted", 0, result.count, void 0, subdir);
+  } catch {
+    return false;
+  }
+  if (Number.isFinite(maxBytesPerItem) && Buffer.byteLength(json, "utf-8") > maxBytesPerItem) return false;
+  try {
+    const dir = path2.dirname(p);
+    if (!fs.existsSync(dir)) ensureDirSync(dir);
+    atomicWriteText(p, json);
+  } catch {
+    return false;
+  }
+  pruneBlobs(
+    subdir,
+    opts.maxCount ?? defaults.maxCount,
+    opts.maxAgeMs ?? DEFAULT_MAX_AGE_MS,
+    opts.maxBytes ?? defaults.maxBytes,
+    p
+  );
+  return true;
+}
+function loadBlob(subdir, id) {
+  const p = blobPath(subdir, id);
+  if (!p) return null;
+  try {
+    if (!fs.existsSync(p)) return null;
+    return JSON.parse(fs.readFileSync(p, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function listBlobs(subdir) {
+  const dir = blobDir(subdir);
+  const out = [];
+  try {
+    if (!fs.existsSync(dir)) return out;
+    for (const file of fs.readdirSync(dir)) {
+      if (!file.endsWith(".json")) continue;
+      const id = file.slice(0, -5);
+      let mtime = 0;
+      try {
+        mtime = fs.statSync(path2.join(dir, file)).mtimeMs;
+      } catch {
+      }
+      const value = loadBlob(subdir, id);
+      if (value !== null) out.push({ id, mtime, value });
+    }
+  } catch {
+    return out;
+  }
+  return out;
+}
+function pruneBlobs(subdir, maxCount = DEFAULT_MAX_COUNT, maxAgeMs = DEFAULT_MAX_AGE_MS, maxBytes = Number.POSITIVE_INFINITY, protectedPath) {
+  return pruneBlobDir(blobDir(subdir), maxCount, maxAgeMs, maxBytes, protectedPath);
+}
+function pruneBlobDir(dir, maxCount = DEFAULT_MAX_COUNT, maxAgeMs = DEFAULT_MAX_AGE_MS, maxBytes = Number.POSITIVE_INFINITY, protectedPath) {
+  let removed = 0;
+  try {
+    if (!fs.existsSync(dir)) return 0;
+    const cutoff = Date.now() - maxAgeMs;
+    let kept = [];
+    let protectedEntry;
+    for (const file of fs.readdirSync(dir)) {
+      const full = path2.join(dir, file);
+      let stat;
+      try {
+        stat = fs.statSync(full);
+      } catch {
+        continue;
+      }
+      if (!stat.isFile()) continue;
+      if (protectedPath !== void 0 && full === protectedPath) {
+        protectedEntry = [full, stat.mtimeMs, stat.size];
+        continue;
+      }
+      if (stat.mtimeMs < cutoff) {
+        try {
+          fs.unlinkSync(full);
+          removed++;
+        } catch {
+          continue;
+        }
+      } else if (file.endsWith(".json")) {
+        kept.push([full, stat.mtimeMs, stat.size]);
+      }
+    }
+    const countBudget = protectedEntry ? Math.max(0, maxCount - 1) : maxCount;
+    if (kept.length > countBudget) {
+      kept.sort((a, b) => a[1] - b[1]);
+      const excess = kept.slice(0, kept.length - countBudget);
+      kept = kept.slice(kept.length - countBudget);
+      for (const [full] of excess) {
+        try {
+          fs.unlinkSync(full);
+          removed++;
+        } catch {
+          continue;
+        }
+      }
+    }
+    if (Number.isFinite(maxBytes)) {
+      kept.sort((a, b) => a[1] - b[1]);
+      let total = kept.reduce((sum, [, , size]) => sum + size, 0) + (protectedEntry ? protectedEntry[2] : 0);
+      while (total > maxBytes && kept.length > 0) {
+        const oldest = kept.shift();
+        if (!oldest) break;
+        const [full, , size] = oldest;
+        try {
+          fs.unlinkSync(full);
+          removed++;
+          total -= size;
+        } catch {
+          break;
+        }
+      }
+    }
+  } catch {
+    return removed;
+  }
+  return removed;
+}
+var SWEEPABLE_CACHE_SUBDIRS = [
+  { subdir: "bash_outputs", countCapped: true },
+  { subdir: "web_outputs", countCapped: true },
+  { subdir: "mcp_outputs", countCapped: true },
+  { subdir: "sessions", countCapped: false }
+];
+function sweepCacheRoots(extraRoots = []) {
+  let removed = 0;
+  const roots = [tokenGoatHome(), ...extraRoots];
+  const seen = /* @__PURE__ */ new Set();
+  for (const root of roots) {
+    if (!root || seen.has(root)) continue;
+    seen.add(root);
+    for (const { subdir, countCapped } of SWEEPABLE_CACHE_SUBDIRS) {
+      try {
+        const defaults = subdirCacheDefaults(subdir);
+        removed += pruneBlobDir(
+          path2.join(root, subdir),
+          countCapped ? defaults.maxCount : Number.POSITIVE_INFINITY,
+          DEFAULT_MAX_AGE_MS,
+          countCapped ? defaults.maxBytes : Number.POSITIVE_INFINITY
+        );
+      } catch {
+      }
+    }
+  }
+  return removed;
+}
+
+export {
+  colorStdout,
+  RESET,
+  stripAnsiEscapes,
+  stripAnsi,
+  fg,
+  C,
+  SOURCE_HINT,
+  savedTokensFromBytes,
+  formatLocalTimestamp,
+  recordStat,
+  recordUnmappedTool,
+  readUnmappedTools,
+  summarize,
+  _useRichStats,
+  renderShortStats,
+  renderStats2 as renderStats,
+  countRedactionPlaceholders,
+  compileCustomPatterns,
+  redactSecrets,
+  DEFAULT_MAX_COUNT,
+  DEFAULT_MAX_AGE_MS,
+  blobPath,
+  isBlobStale,
+  storeBlob,
+  loadBlob,
+  listBlobs,
+  pruneBlobs,
+  sweepCacheRoots
+};