@tokz/cli 0.2.3 → 0.2.5

package/dist/chunk-65BQE6TI.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+
+// src/mcp.ts
+import { readFile } from "fs/promises";
+import { homedir } from "os";
+import { join } from "path";
+async function readJson(file) {
+  try {
+    return JSON.parse(await readFile(file, "utf8"));
+  } catch {
+    return void 0;
+  }
+}
+function serverNames(obj) {
+  if (obj && typeof obj === "object" && !Array.isArray(obj)) return Object.keys(obj);
+  return [];
+}
+async function findMcpServers(projectPath, home = homedir()) {
+  const out = /* @__PURE__ */ new Map();
+  const add = (names, source) => {
+    for (const name of names) if (!out.has(name)) out.set(name, { name, source });
+  };
+  const projectFile = join(projectPath, ".mcp.json");
+  const projectCfg = await readJson(projectFile);
+  add(serverNames(projectCfg?.mcpServers), projectFile);
+  const globalFile = join(home, ".claude.json");
+  const globalCfg = await readJson(globalFile);
+  add(serverNames(globalCfg?.mcpServers), globalFile);
+  const projects = globalCfg?.projects;
+  if (projects && typeof projects === "object") {
+    const entry = projects[projectPath];
+    add(serverNames(entry?.mcpServers), `${globalFile} (project entry)`);
+  }
+  return [...out.values()];
+}
+
+export {
+  findMcpServers
+};

package/dist/chunk-6Y6MKFHZ.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+import {
+  addUsage,
+  compact,
+  costUsd,
+  emptyUsage,
+  shortModel,
+  usd
+} from "./chunk-Z5W5QH2Z.js";
+
+// src/blocks.ts
+var BLOCK_LENGTH_MS = 5 * 60 * 60 * 1e3;
+var HOUR_MS = 60 * 60 * 1e3;
+function finalize(b) {
+  for (const [model, u] of Object.entries(b.usageByModel)) {
+    b.totalTokens += u.inputTokens + u.cacheReadTokens + u.cacheCreationTokens + u.outputTokens;
+    b.costUsd += costUsd(u, model).total;
+  }
+  return b;
+}
+function buildBlocks(events, opts) {
+  const len = opts?.sessionLengthMs ?? BLOCK_LENGTH_MS;
+  const now = opts?.now ?? Date.now();
+  const sorted = [...events].sort((a, b) => a.ts - b.ts);
+  const blocks = [];
+  let cur;
+  for (const e of sorted) {
+    if (!cur || e.ts >= cur.end) {
+      if (cur) blocks.push(finalize(cur));
+      const start = Math.floor(e.ts / HOUR_MS) * HOUR_MS;
+      cur = {
+        start,
+        end: start + len,
+        firstTs: e.ts,
+        lastTs: e.ts,
+        usageByModel: {},
+        totalTokens: 0,
+        costUsd: 0,
+        active: false
+      };
+    }
+    cur.lastTs = Math.max(cur.lastTs, e.ts);
+    addUsage(cur.usageByModel[e.model] ??= emptyUsage(), e.usage);
+  }
+  if (cur) {
+    cur.active = now < cur.end;
+    blocks.push(finalize(cur));
+  }
+  return blocks;
+}
+function burnRate(b, now = Date.now()) {
+  if (!b.active) return void 0;
+  const elapsed = Math.max(6e4, now - b.firstTs);
+  const remainingMs = Math.max(0, b.end - now);
+  const tokensPerMinute = b.totalTokens / (elapsed / 6e4);
+  const costPerHour = b.costUsd / (elapsed / HOUR_MS);
+  return {
+    tokensPerMinute,
+    costPerHour,
+    projectedTokens: Math.round(b.totalTokens + tokensPerMinute * (remainingMs / 6e4)),
+    projectedCostUsd: b.costUsd + costPerHour * (remainingMs / HOUR_MS),
+    remainingMs
+  };
+}
+function maxBlockTokens(blocks) {
+  return blocks.filter((b) => !b.active).reduce((m, b) => Math.max(m, b.totalTokens), 0);
+}
+
+// src/blocksReport.ts
+import Table from "cli-table3";
+import pc from "picocolors";
+function fmtMs(ms) {
+  const mins = Math.round(ms / 6e4);
+  if (mins < 1) return "<1m";
+  if (mins < 60) return `${mins}m`;
+  const h = Math.floor(mins / 60);
+  const m = mins % 60;
+  return m > 0 ? `${h}h ${m}m` : `${h}h`;
+}
+function fmtStart(ms) {
+  const d = new Date(ms);
+  return `${d.toISOString().slice(0, 10)} ${d.toISOString().slice(11, 16)} UTC`;
+}
+function renderBlocksReport(blocks, opts) {
+  if (blocks.length === 0) return "No Claude Code activity found.";
+  const now = opts?.now ?? Date.now();
+  const limit = opts?.tokenLimit === "max" ? maxBlockTokens(blocks) : opts?.tokenLimit;
+  const parts = [];
+  parts.push(
+    pc.bold(`tokz blocks \u2014 ${blocks.length} \xD7 5-hour billing windows`) + pc.dim("  (Claude usage limits reset per rolling 5h block)")
+  );
+  const table = new Table({ head: ["Block start", "Status", "Models", "Tokens", "Cost"] });
+  for (const b of blocks) {
+    const models = [...new Set(Object.keys(b.usageByModel).map(shortModel))].join(", ");
+    const status = b.active ? pc.green(`ACTIVE \xB7 ${fmtMs(b.end - now)} left`) : pc.dim(`done \xB7 ${fmtMs(b.lastTs - b.firstTs)}`);
+    const tokens = limit && b.totalTokens > limit ? pc.red(`${compact(b.totalTokens)} \u{1F6A8}`) : limit && b.totalTokens > limit * 0.8 ? pc.yellow(`${compact(b.totalTokens)} \u26A0\uFE0F`) : compact(b.totalTokens);
+    table.push([fmtStart(b.start), status, models, tokens, usd(b.costUsd)]);
+  }
+  parts.push(table.toString());
+  const active = blocks.find((b) => b.active);
+  const rate = active ? burnRate(active, now) : void 0;
+  if (active && rate) {
+    const lines = [
+      pc.bold("Active block") + ` \u2014 started ${fmtStart(active.start)}, ${pc.green(fmtMs(rate.remainingMs))} remaining`,
+      `  burn rate   ${compact(Math.round(rate.tokensPerMinute))} tok/min \xB7 ${usd(rate.costPerHour)}/hr`,
+      `  projected   ${compact(rate.projectedTokens)} tokens \xB7 ${usd(rate.projectedCostUsd)} by block end`
+    ];
+    if (limit) {
+      const over = rate.projectedTokens > limit;
+      const nearing = !over && active.totalTokens > limit * 0.8;
+      lines.push(
+        `  limit       ${compact(limit)} tokens \u2014 ` + (over ? pc.red(`\u{1F6A8} projected to exceed (${compact(rate.projectedTokens)})`) : nearing ? pc.yellow(`\u26A0\uFE0F ${Math.round(active.totalTokens / limit * 100)}% used`) : pc.green(`${Math.round(active.totalTokens / limit * 100)}% used`))
+      );
+    }
+    parts.push(lines.join("\n"));
+  }
+  return parts.join("\n\n");
+}
+
+export {
+  buildBlocks,
+  burnRate,
+  fmtMs,
+  renderBlocksReport
+};

package/dist/{chunk-JAZOB7NC.js → chunk-Z5W5QH2Z.js}

@@ -12,6 +12,11 @@ var PRICES = {
   "claude-sonnet-4-6": { inputPerMTok: 3, outputPerMTok: 15 },
   "claude-haiku-4-5": { inputPerMTok: 1, outputPerMTok: 5 },
   // OpenAI (no cache-write charge; cached input 0.1x)
+  "gpt-5.6-sol": { inputPerMTok: 5, outputPerMTok: 30, cacheWriteMult: 0 },
+  "gpt-5.6-terra": { inputPerMTok: 2.5, outputPerMTok: 15, cacheWriteMult: 0 },
+  "gpt-5.6-luna": { inputPerMTok: 1, outputPerMTok: 6, cacheWriteMult: 0 },
+  "gpt-5.5-pro": { inputPerMTok: 30, outputPerMTok: 180, cacheWriteMult: 0, cacheReadMult: 1 },
+  "gpt-5.5": { inputPerMTok: 5, outputPerMTok: 30, cacheWriteMult: 0 },
   "gpt-5-codex": { inputPerMTok: 1.25, outputPerMTok: 10, cacheWriteMult: 0 },
   "gpt-5-mini": { inputPerMTok: 0.25, outputPerMTok: 2, cacheWriteMult: 0 },
   "gpt-5-nano": { inputPerMTok: 0.05, outputPerMTok: 0.4, cacheWriteMult: 0 },
@@ -22,6 +27,8 @@ var PRICES = {
   "o4-mini": { inputPerMTok: 1.1, outputPerMTok: 4.4, cacheWriteMult: 0, cacheReadMult: 0.25 },
   o3: { inputPerMTok: 2, outputPerMTok: 8, cacheWriteMult: 0, cacheReadMult: 0.25 },
   // Google
+  "gemini-3.1-pro": { inputPerMTok: 2, outputPerMTok: 12, cacheWriteMult: 0 },
+  "gemini-3.5-flash": { inputPerMTok: 1.5, outputPerMTok: 9, cacheWriteMult: 0 },
   "gemini-2.5-pro": { inputPerMTok: 1.25, outputPerMTok: 10, cacheWriteMult: 0 },
   "gemini-2.5-flash": { inputPerMTok: 0.3, outputPerMTok: 2.5, cacheWriteMult: 0 }
 };
@@ -29,17 +36,29 @@ var DEFAULT_CACHE_READ_MULT = 0.1;
 var DEFAULT_CACHE_WRITE_MULT = 1.25;
 var CLAUDE_FALLBACK = PRICES["claude-opus-4-8"];
 var UNKNOWN = { inputPerMTok: 0, outputPerMTok: 0 };
-function resolvePrice(modelId) {
+var livePrices = {};
+var resolveCache = /* @__PURE__ */ new Map();
+function setLivePrices(prices) {
+  livePrices = prices;
+  resolveCache.clear();
+}
+function longestPrefix(modelId, table) {
   let best;
   let bestLen = -1;
-  for (const [prefix, price] of Object.entries(PRICES)) {
+  for (const [prefix, price] of Object.entries(table)) {
     if (modelId.startsWith(prefix) && prefix.length > bestLen) {
       best = price;
       bestLen = prefix.length;
     }
   }
-  if (best) return best;
-  return modelId.startsWith("claude") ? CLAUDE_FALLBACK : UNKNOWN;
+  return best;
+}
+function resolvePrice(modelId) {
+  const hit = resolveCache.get(modelId);
+  if (hit) return hit;
+  const price = livePrices[modelId] ?? longestPrefix(modelId, PRICES) ?? longestPrefix(modelId, livePrices) ?? (modelId.startsWith("claude") ? CLAUDE_FALLBACK : UNKNOWN);
+  resolveCache.set(modelId, price);
+  return price;
 }
 function emptyUsage() {
   return { inputTokens: 0, cacheReadTokens: 0, cacheCreationTokens: 0, outputTokens: 0, turns: 0 };
@@ -53,7 +72,8 @@ function costUsd(usage, modelId) {
   const cacheRead = usage.cacheReadTokens / 1e6 * p.inputPerMTok * readMult;
   const write1h = Math.min(usage.cacheCreation1hTokens ?? 0, usage.cacheCreationTokens);
   const write5m = usage.cacheCreationTokens - write1h;
-  const cacheWrite = write5m / 1e6 * p.inputPerMTok * writeMult + write1h / 1e6 * p.inputPerMTok * (p.cacheWriteMult ?? CACHE_WRITE_1H_MULT);
+  const write1hMult = p.cacheWrite1hMult ?? (p.cacheWriteMult === 0 ? 0 : CACHE_WRITE_1H_MULT);
+  const cacheWrite = write5m / 1e6 * p.inputPerMTok * writeMult + write1h / 1e6 * p.inputPerMTok * write1hMult;
   const output = usage.outputTokens / 1e6 * p.outputPerMTok;
   return { input, cacheRead, cacheWrite, output, total: input + cacheRead + cacheWrite + output };
 }
@@ -220,6 +240,85 @@ function buildReport(sessions, servers, range) {
   };
 }
 
+// src/format.ts
+var usd = (n) => `$${n.toFixed(2)}`;
+var tok = (n) => n.toLocaleString("en-US");
+function compact(n) {
+  if (n >= 1e9) return `${(n / 1e9).toFixed(1)}B`;
+  if (n >= 1e6) return `${(n / 1e6).toFixed(1)}M`;
+  if (n >= 1e3) return `${(n / 1e3).toFixed(1)}k`;
+  return String(n);
+}
+var pct = (fraction) => `${Math.round(fraction * 100)}%`;
+var pct1 = (fraction) => `${(fraction * 100).toFixed(1)}%`;
+var shortModel = (id) => id.replace(/^claude-/, "").replace(/-\d{8}$/, "");
+function duration(startIso, endIso) {
+  if (!startIso || !endIso) return "\u2014";
+  const mins = Math.round((Date.parse(endIso) - Date.parse(startIso)) / 6e4);
+  if (mins < 1) return "<1m";
+  if (mins < 60) return `${mins}m`;
+  const h = Math.floor(mins / 60);
+  const m = mins % 60;
+  return m > 0 ? `${h}h ${m}m` : `${h}h`;
+}
+function relativeDate(iso, now = Date.now()) {
+  if (!iso) return "\u2014";
+  const date = iso.slice(0, 10);
+  const days = Math.floor((now - Date.parse(date)) / 864e5);
+  if (days <= 0) return "today";
+  if (days === 1) return "yesterday";
+  if (days < 30) return `${days}d ago`;
+  return date;
+}
+
+// src/dates.ts
+var zone;
+var formatter;
+function setTimezone(tz) {
+  zone = tz === "utc" || tz === void 0 ? void 0 : tz;
+  formatter = zone ? new Intl.DateTimeFormat("en-CA", {
+    timeZone: zone === "local" ? void 0 : zone,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit"
+  }) : void 0;
+}
+function dayKey(ts) {
+  if (!formatter) return typeof ts === "string" ? ts.slice(0, 10) : new Date(ts).toISOString().slice(0, 10);
+  return formatter.format(typeof ts === "string" ? new Date(ts) : ts);
+}
+function weekKey(day) {
+  const d = /* @__PURE__ */ new Date(`${day}T00:00:00Z`);
+  const dow = (d.getUTCDay() + 6) % 7;
+  d.setUTCDate(d.getUTCDate() - dow);
+  return d.toISOString().slice(0, 10);
+}
+function monthKey(day) {
+  return day.slice(0, 7);
+}
+function groupDaily(daily, unit) {
+  if (unit === "day") return daily;
+  const keyOf = unit === "week" ? weekKey : monthKey;
+  const out = /* @__PURE__ */ new Map();
+  for (const d of daily) {
+    const key = keyOf(d.date);
+    const acc = out.get(key) ?? { date: key, costUsd: 0, inputTokens: 0, cacheReadTokens: 0, cacheCreationTokens: 0, outputTokens: 0, turns: 0 };
+    acc.costUsd += d.costUsd;
+    acc.inputTokens += d.inputTokens;
+    acc.cacheReadTokens += d.cacheReadTokens;
+    acc.cacheCreationTokens += d.cacheCreationTokens;
+    acc.outputTokens += d.outputTokens;
+    acc.turns += d.turns;
+    out.set(key, acc);
+  }
+  return [...out.values()].sort((a, b) => a.date < b.date ? -1 : 1);
+}
+function parseDateArg(raw) {
+  if (!raw) return void 0;
+  const m = /^(\d{4})-?(\d{2})-?(\d{2})$/.exec(raw.trim());
+  return m ? `${m[1]}-${m[2]}-${m[3]}` : void 0;
+}
+
 // src/discover.ts
 import { homedir } from "os";
 import { join } from "path";
@@ -235,40 +334,6 @@ async function findTranscripts(projectPath, home = homedir()) {
   return glob(["**/*.jsonl"], { cwd, absolute: true }).catch(() => []);
 }
 
-// src/mcp.ts
-import { readFile } from "fs/promises";
-import { homedir as homedir2 } from "os";
-import { join as join2 } from "path";
-async function readJson(file) {
-  try {
-    return JSON.parse(await readFile(file, "utf8"));
-  } catch {
-    return void 0;
-  }
-}
-function serverNames(obj) {
-  if (obj && typeof obj === "object" && !Array.isArray(obj)) return Object.keys(obj);
-  return [];
-}
-async function findMcpServers(projectPath, home = homedir2()) {
-  const out = /* @__PURE__ */ new Map();
-  const add = (names, source) => {
-    for (const name of names) if (!out.has(name)) out.set(name, { name, source });
-  };
-  const projectFile = join2(projectPath, ".mcp.json");
-  const projectCfg = await readJson(projectFile);
-  add(serverNames(projectCfg?.mcpServers), projectFile);
-  const globalFile = join2(home, ".claude.json");
-  const globalCfg = await readJson(globalFile);
-  add(serverNames(globalCfg?.mcpServers), globalFile);
-  const projects = globalCfg?.projects;
-  if (projects && typeof projects === "object") {
-    const entry = projects[projectPath];
-    add(serverNames(entry?.mcpServers), `${globalFile} (project entry)`);
-  }
-  return [...out.values()];
-}
-
 // src/transcript.ts
 import { createReadStream } from "fs";
 import { createInterface } from "readline";
@@ -293,7 +358,7 @@ var AssistantLine = z.object({
     content: z.array(z.object({ type: z.string(), id: z.string().optional(), name: z.string().optional() }).passthrough()).optional()
   })
 });
-async function parseTranscript(file, seenMessages = /* @__PURE__ */ new Map(), seenToolIds = /* @__PURE__ */ new Set()) {
+async function parseTranscript(file, seenMessages = /* @__PURE__ */ new Map(), seenToolIds = /* @__PURE__ */ new Set(), events) {
   const stats = { file, usageByModel: {}, toolCalls: {}, toolCostUsd: {}, dailyUsage: {} };
   const rl = createInterface({ input: createReadStream(file, "utf8"), crlfDelay: Infinity });
   for await (const line of rl) {
@@ -345,8 +410,9 @@ async function parseTranscript(file, seenMessages = /* @__PURE__ */ new Map(), s
       if (hasDelta) {
         const accs = [stats.usageByModel[model] ??= emptyUsage()];
         if (timestamp) {
-          const day = stats.dailyUsage[timestamp.slice(0, 10)] ??= {};
+          const day = stats.dailyUsage[dayKey(timestamp)] ??= {};
           accs.push(day[model] ??= emptyUsage());
+          events?.push({ ts: Date.parse(timestamp), model, usage: delta });
         }
         for (const acc of accs) {
           acc.inputTokens += delta.inputTokens;
@@ -379,47 +445,14 @@ async function parseTranscript(file, seenMessages = /* @__PURE__ */ new Map(), s
   return stats;
 }
 
-// src/format.ts
-var usd = (n) => `$${n.toFixed(2)}`;
-var tok = (n) => n.toLocaleString("en-US");
-function compact(n) {
-  if (n >= 1e9) return `${(n / 1e9).toFixed(1)}B`;
-  if (n >= 1e6) return `${(n / 1e6).toFixed(1)}M`;
-  if (n >= 1e3) return `${(n / 1e3).toFixed(1)}k`;
-  return String(n);
-}
-var pct = (fraction) => `${Math.round(fraction * 100)}%`;
-var pct1 = (fraction) => `${(fraction * 100).toFixed(1)}%`;
-var shortModel = (id) => id.replace(/^claude-/, "").replace(/-\d{8}$/, "");
-function duration(startIso, endIso) {
-  if (!startIso || !endIso) return "\u2014";
-  const mins = Math.round((Date.parse(endIso) - Date.parse(startIso)) / 6e4);
-  if (mins < 1) return "<1m";
-  if (mins < 60) return `${mins}m`;
-  const h = Math.floor(mins / 60);
-  const m = mins % 60;
-  return m > 0 ? `${h}h ${m}m` : `${h}h`;
-}
-function relativeDate(iso, now = Date.now()) {
-  if (!iso) return "\u2014";
-  const date = iso.slice(0, 10);
-  const days = Math.floor((now - Date.parse(date)) / 864e5);
-  if (days <= 0) return "today";
-  if (days === 1) return "yesterday";
-  if (days < 30) return `${days}d ago`;
-  return date;
-}
-
 export {
+  setLivePrices,
   emptyUsage,
   costUsd,
   addUsage,
   cacheSavings,
   cacheHitRate,
   buildReport,
-  sanitizeProjectPath,
-  findTranscripts,
-  findMcpServers,
   usd,
   tok,
   compact,
@@ -428,5 +461,11 @@ export {
   shortModel,
   duration,
   relativeDate,
+  setTimezone,
+  dayKey,
+  groupDaily,
+  parseDateArg,
+  sanitizeProjectPath,
+  findTranscripts,
   parseTranscript
 };

package/dist/cli.js

@@ -1,21 +1,107 @@
 #!/usr/bin/env node
+import {
+  buildBlocks,
+  renderBlocksReport
+} from "./chunk-6Y6MKFHZ.js";
+import {
+  findMcpServers
+} from "./chunk-65BQE6TI.js";
 import {
   buildReport,
-  findMcpServers,
   findTranscripts,
+  groupDaily,
+  parseDateArg,
   parseTranscript,
   pct1,
+  setLivePrices,
+  setTimezone,
   tok,
   usd
-} from "./chunk-JAZOB7NC.js";
+} from "./chunk-Z5W5QH2Z.js";
 
 // src/cli.ts
 import { createRequire } from "module";
 import { Command } from "commander";
 
+// src/livePricing.ts
+import { mkdir, readFile, writeFile } from "fs/promises";
+import { homedir } from "os";
+import { join } from "path";
+var LITELLM_URL = "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json";
+var CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
+var FETCH_TIMEOUT_MS = 3500;
+function mapLitellmPrices(raw) {
+  const out = {};
+  for (const [key, value] of Object.entries(raw)) {
+    if (!value || typeof value !== "object") continue;
+    const e = value;
+    const inCost = e.input_cost_per_token;
+    const outCost = e.output_cost_per_token;
+    if (typeof inCost !== "number" || typeof outCost !== "number" || inCost <= 0) continue;
+    const name = key.includes("/") ? key.slice(key.lastIndexOf("/") + 1) : key;
+    if (key.includes("/") && out[name]) continue;
+    const p = { inputPerMTok: inCost * 1e6, outputPerMTok: outCost * 1e6 };
+    if (typeof e.cache_read_input_token_cost === "number")
+      p.cacheReadMult = e.cache_read_input_token_cost / inCost;
+    if (typeof e.cache_creation_input_token_cost === "number")
+      p.cacheWriteMult = e.cache_creation_input_token_cost / inCost;
+    else if (!name.startsWith("claude"))
+      p.cacheWriteMult = 0;
+    if (typeof e.cache_creation_input_token_cost_above_1hr === "number")
+      p.cacheWrite1hMult = e.cache_creation_input_token_cost_above_1hr / inCost;
+    out[name] = p;
+  }
+  return out;
+}
+async function initPricing(opts) {
+  const dir = opts?.cacheDir ?? join(homedir(), ".tokz");
+  const file = join(dir, "litellm-prices.json");
+  let cached;
+  try {
+    cached = JSON.parse(await readFile(file, "utf8"));
+  } catch {
+  }
+  const fresh = cached && Date.now() - cached.fetchedAt < CACHE_TTL_MS;
+  if (cached && (fresh || opts?.offline)) {
+    setLivePrices(cached.prices);
+    return "cached";
+  }
+  if (opts?.offline) return "static";
+  try {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), FETCH_TIMEOUT_MS);
+    const res = await fetch(LITELLM_URL, { signal: ctrl.signal });
+    clearTimeout(timer);
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+    const prices = mapLitellmPrices(await res.json());
+    setLivePrices(prices);
+    try {
+      await mkdir(dir, { recursive: true });
+      await writeFile(file, JSON.stringify({ fetchedAt: Date.now(), prices }));
+    } catch {
+    }
+    return "live";
+  } catch {
+    if (cached) {
+      setLivePrices(cached.prices);
+      return "cached";
+    }
+    return "static";
+  }
+}
+
 // src/report.ts
 import Table from "cli-table3";
 import pc from "picocolors";
+function renderActivity(rows, unit) {
+  const head = unit === "week" ? "Week of" : "Month";
+  const table = new Table({ head: [head, "Cost", "Input", "Cache read", "Cache write", "Output", "Turns"] });
+  for (const d of rows) {
+    table.push([d.date, usd(d.costUsd), tok(d.inputTokens), tok(d.cacheReadTokens), tok(d.cacheCreationTokens), tok(d.outputTokens), String(d.turns)]);
+  }
+  return `${pc.bold(`Activity by ${unit}`)}
+${table.toString()}`;
+}
 function renderReport(report) {
   const parts = [];
   const span = report.spanStart && report.spanEnd ? `${report.spanStart} \u2192 ${report.spanEnd}` : `${report.spanDays} days`;
@@ -62,47 +148,110 @@ function renderReport(report) {
 // src/cli.ts
 var { version } = createRequire(import.meta.url)("../package.json");
 var program = new Command();
-program.name("tokz").description("Audit where your coding agent's context window and API dollars go.").version(version);
-program.command("audit").argument("[project]", "project path (default: current directory)").option("--all", "scan all projects under ~/.claude/projects").option("--json", "output raw JSON report").option("--days <n>", "only include the last N days of activity").action(async (project, opts) => {
+program.name("tokz").description("Audit where your coding agent's context window and API dollars go.").option("--offline", "don't fetch live pricing; use cached/built-in rates").option("--timezone <zone>", 'group days in this timezone: "utc" (default), "local", or an IANA name').version(version);
+function applyGlobals() {
+  const opts = program.opts();
+  setTimezone(opts.timezone);
+  return { offline: opts.offline };
+}
+async function parseAll(projectPath, events) {
+  const transcripts = await findTranscripts(projectPath);
+  const seenMessageIds = /* @__PURE__ */ new Map();
+  const seenToolIds = /* @__PURE__ */ new Set();
+  const sessions = await Promise.all(
+    transcripts.map((f) => parseTranscript(f, seenMessageIds, seenToolIds, events))
+  );
+  return { transcripts, sessions };
+}
+program.command("audit").argument("[project]", "project path (default: current directory)").option("--all", "scan all projects under ~/.claude/projects").option("--json", "output raw JSON report").option("--days <n>", "only include the last N days of activity").option("--since <date>", "start date, YYYY-MM-DD or YYYYMMDD (inclusive)").option("--until <date>", "end date, YYYY-MM-DD or YYYYMMDD (inclusive)").option("--weekly", "append activity grouped by week").option("--monthly", "append activity grouped by month").action(async (project, opts) => {
+  const globals = applyGlobals();
   const projectPath = project ?? process.cwd();
-  const transcripts = await findTranscripts(opts.all ? void 0 : projectPath);
+  const [{ transcripts, sessions }] = await Promise.all([
+    parseAll(opts.all ? void 0 : projectPath),
+    initPricing(globals)
+  ]);
   if (transcripts.length === 0) {
     console.error(`No Claude Code transcripts found for ${opts.all ? "any project" : projectPath}.`);
     process.exitCode = 1;
     return;
   }
-  const seenMessageIds = /* @__PURE__ */ new Map();
-  const seenToolIds = /* @__PURE__ */ new Set();
-  const sessions = await Promise.all(
-    transcripts.map((f) => parseTranscript(f, seenMessageIds, seenToolIds))
-  );
   const servers = opts.all ? [] : await findMcpServers(projectPath);
   const days = opts.days ? Number.parseInt(opts.days, 10) : void 0;
   const isoDay = (offset) => new Date(Date.now() - offset * 864e5).toISOString().slice(0, 10);
-  const range = days && days > 0 ? { from: isoDay(days - 1), to: isoDay(0) } : void 0;
+  const since = parseDateArg(opts.since);
+  const until = parseDateArg(opts.until);
+  let range;
+  if (since || until) range = { from: since ?? "0000-01-01", to: until ?? "9999-12-31" };
+  else if (days && days > 0) range = { from: isoDay(days - 1), to: isoDay(0) };
   const report = buildReport(sessions, servers, range);
-  console.log(opts.json ? JSON.stringify(report, null, 2) : renderReport(report));
+  if (opts.json) {
+    console.log(JSON.stringify(report, null, 2));
+    return;
+  }
+  const parts = [renderReport(report)];
+  const grouping = opts.monthly ? "month" : opts.weekly ? "week" : void 0;
+  if (grouping) parts.push(renderActivity(groupDaily(report.daily, grouping), grouping));
+  console.log(parts.join("\n\n"));
+});
+program.command("blocks").description("Claude usage grouped into rolling 5-hour billing windows").option("--json", "output raw JSON").option("--active", "show only the currently active block").option("--recent", "only blocks from the last 3 days").option("--token-limit <n>", 'warn near this many tokens per block ("max" = highest past block)').option("--session-length <hours>", "block length in hours (default 5)").action(async (opts) => {
+  const globals = applyGlobals();
+  const events = [];
+  await Promise.all([parseAll(void 0, events), initPricing(globals)]);
+  const hours = opts.sessionLength ? Number.parseFloat(opts.sessionLength) : 5;
+  let blocks = buildBlocks(events, { sessionLengthMs: hours * 36e5 });
+  if (opts.recent) blocks = blocks.filter((b) => b.lastTs >= Date.now() - 3 * 864e5);
+  if (opts.active) blocks = blocks.filter((b) => b.active);
+  const tokenLimit = opts.tokenLimit === "max" ? "max" : opts.tokenLimit ? Number.parseInt(opts.tokenLimit, 10) : void 0;
+  if (opts.json) {
+    console.log(JSON.stringify(blocks, null, 2));
+    return;
+  }
+  console.log(renderBlocksReport(blocks, { tokenLimit }));
+});
+program.command("statusline").description("compact usage line for Claude Code's statusLine hook (reads hook JSON on stdin)").argument("[action]", '"enable" writes the hook into ~/.claude/settings.json, "disable" removes it').option("--cost-source <mode>", "session cost source: auto | cc | calc | both", "auto").action(async (action, opts) => {
+  const globals = applyGlobals();
+  const sl = await import("./statusline-EXFMQYFF.js");
+  if (action === "enable" || action === "disable") {
+    try {
+      console.log(action === "enable" ? await sl.enableStatusline() : await sl.disableStatusline());
+    } catch (err) {
+      console.error(`Could not update settings: ${err instanceof Error ? err.message : err}`);
+      process.exitCode = 1;
+    }
+    return;
+  }
+  if (action !== void 0) {
+    console.error(`Unknown action "${action}" \u2014 use "enable" or "disable".`);
+    process.exitCode = 1;
+    return;
+  }
+  await initPricing({ ...globals, offline: true });
+  let input = {};
+  try {
+    input = JSON.parse(await sl.readStdin());
+  } catch {
+  }
+  const valid = ["auto", "cc", "calc", "both"];
+  const costSource = valid.includes(opts.costSource ?? "auto") ? opts.costSource ?? "auto" : "auto";
+  console.log(await sl.statusline(input, Date.now(), void 0, { costSource }));
 });
 program.action(async () => {
+  const globals = applyGlobals();
+  await initPricing(globals);
   if (!process.stdout.isTTY) {
-    const transcripts = await findTranscripts(void 0);
+    const { transcripts, sessions } = await parseAll(void 0);
     if (transcripts.length === 0) {
       console.error("No Claude Code transcripts found.");
       process.exitCode = 1;
       return;
     }
-    const seenMessageIds = /* @__PURE__ */ new Map();
-    const seenToolIds = /* @__PURE__ */ new Set();
-    const sessions = await Promise.all(
-      transcripts.map((f) => parseTranscript(f, seenMessageIds, seenToolIds))
-    );
     console.log(renderReport(buildReport(sessions, [])));
     return;
   }
   const [{ render }, React, { Root }, { Fullscreen }] = await Promise.all([
     import("ink"),
     import("react"),
-    import("./Root-6SZ5FQDN.js"),
+    import("./Root-TUEV5MJB.js"),
     import("./Fullscreen-GK2ZYXHV.js")
   ]);
   render(React.createElement(Fullscreen, null, React.createElement(Root)));