tledger 0.1.3 → 0.1.4

package/README.md

@@ -1,9 +1,10 @@
 # Token Ledger
 
 Token Ledger is a lightweight, local-only terminal dashboard for Codex token
-usage. It ranks projects, shows model and cache mix, and adds reset-cycle
-context without sending usage data anywhere. Codex Auto Review is shown
-separately with its token total, distinct-turn share, and cached-input share.
+usage. It ranks projects, names every active model—including Daybreak Blue—and
+shows cache and reset-cycle context without sending usage data anywhere. Codex
+Auto Review is shown separately with its token total, distinct-turn share, and
+cached-input share.
 
 Token Ledger reads Codex history stored on the computer where it runs. It does
 not sign in, fetch account-wide usage, or combine activity from other machines.
@@ -29,7 +30,7 @@ Token Ledger has no runtime npm dependencies and runs no installation script.
 
 ```bash
 npm install --global tledger
-tledger --help
+tledger --version
 ```
 
 ## Use
@@ -40,8 +41,15 @@ tledger week            # same default, stated explicitly
 tledger day             # today
 tledger day yesterday
 tledger week 2026-08-05
+tledger month           # rolling 30-day window
+tledger 90d             # rolling 90-day window
+tledger 90d 2026-08-05  # 90 days ending on a chosen day
+tledger all             # every dated event in the local snapshot
 ```
 
+`week`, `month`, and custom ranges such as `90d` are inclusive rolling
+calendar-day windows ending today unless an end day is supplied.
+
 The local timezone and top 10 projects are selected automatically. The default
 view is interactive in a terminal; use arrow keys or `j`/`k` to move and `q` or
 Escape to exit. If the selected period is empty, Token Ledger reports the most
@@ -58,11 +66,13 @@ Useful options:
 --codex-home <dir>   Read another Codex data directory
 --no-archived        Skip archived sessions during collection
 --raw-projects       Keep singleton project labels separate
+-anon                Show Project 1, Project 2, etc. instead of project names
 --static             Print once instead of opening the interactive view
 --plain              Print once without ANSI color
 --ascii              Use ASCII bars
 --width <40-200>     Set the static layout width
 --date <day>         Set today, yesterday, or YYYY-MM-DD
+-v, --version        Show the installed version
 --help               Show complete CLI help
 ```
 
@@ -70,6 +80,7 @@ Useful options:
 
 ```bash
 npm install --global tledger@latest
+tledger --version
 npm uninstall --global tledger
 ```
 
@@ -87,15 +98,16 @@ workers; unchanged runs read the existing cache. Token Ledger makes no network
 requests and excludes
 message bodies, reasoning text, tool payloads, credentials, and full local
 paths from the cache. Project labels can still reveal local context, so keep
-snapshots private unless you have reviewed them. Reset-cycle burn
-is an estimate, not official quota or billing data.
+snapshots private unless you have reviewed them. Use `-anon` to hide project
+names in terminal output; it does not rewrite the cached snapshot. Reset-cycle
+burn is an estimate, not official quota or billing data.
 
 ## Develop
 
 ```bash
 npm test
 npm run demo
-npm pack --dry-run
+npm run verify:release
 ```
 
 ## License

package/bin/token-ledger-terminal.mjs

@@ -1,3 +1,8 @@
+import {
+  modelColorKey,
+  modelDisplayName,
+} from "../lib/token-ledger-models.mjs";
+
 const RESET = "\u001b[0m";
 const DIM = [38, 5, 245];
 const TEAL = [38, 5, 80];
@@ -6,6 +11,7 @@ export const MODEL_COLORS = {
   luna: [38, 5, 80],
   terra: [38, 5, 179],
   gpt: [38, 5, 176],
+  daybreakBlue: [38, 5, 69],
   autoReview: [38, 5, 153],
   other: [38, 5, 60],
 };
@@ -95,23 +101,11 @@ function plural(value, singular, pluralForm = `${singular}s`) {
 
 function modelLabel(value) {
   const model = sanitizeText(value) || "Unknown model";
-  const lower = model.toLowerCase().replaceAll("_", "-");
-  if (lower === "codex-auto-review" || lower.startsWith("codex-auto-review-")) {
-    return "Auto Review";
-  }
-  if (lower.includes("sol")) return "Sol";
-  if (lower.includes("luna")) return "Luna";
-  if (lower.includes("terra")) return "Terra";
-  if (lower.includes("gpt-5.5") || lower.includes("gpt-5.4")) return "GPT";
-  return "Other";
+  return modelDisplayName(model);
 }
 
 function modelColor(model) {
-  const key = String(model || "")
-    .toLowerCase()
-    .replace(/[\s_-]+/g, "-");
-  if (key === "auto-review") return MODEL_COLORS.autoReview;
-  return MODEL_COLORS[key] ?? MODEL_COLORS.other;
+  return MODEL_COLORS[modelColorKey(model)] ?? MODEL_COLORS.other;
 }
 
 function usageTypeLabel(value) {
@@ -134,7 +128,7 @@ function displayProject(row) {
 }
 
 function dateLabel(bounds, range = "day") {
-  if (range === "week" && bounds.startDateString && bounds.endDateString) {
+  if (range !== "day" && bounds.rangeDays !== 1 && bounds.startDateString && bounds.endDateString) {
     const startParts = bounds.startDateString.split("-").map(Number);
     const endParts = bounds.endDateString.split("-").map(Number);
     const monthNames = [
@@ -143,7 +137,12 @@ function dateLabel(bounds, range = "day") {
     ];
     const start = `${monthNames[startParts[1] - 1]} ${String(startParts[2]).padStart(2, "0")}`;
     const end = `${monthNames[endParts[1] - 1]} ${String(endParts[2]).padStart(2, "0")}`;
-    return `${start} – ${end} ${endParts[0]}`;
+    if (bounds.startDateString === bounds.endDateString) {
+      return `${end} ${endParts[0]}`;
+    }
+    return startParts[0] === endParts[0]
+      ? `${start} – ${end} ${endParts[0]}`
+      : `${start} ${startParts[0]} – ${end} ${endParts[0]}`;
   }
   const parts = new Intl.DateTimeFormat("en-US", {
     timeZone: bounds.timeZone,
@@ -160,6 +159,13 @@ function dateLabel(bounds, range = "day") {
   return `${values.weekday} ${values.day} ${values.month} ${values.year}`.toUpperCase();
 }
 
+function rangeModeLabel(bounds, range = "day", compact = false) {
+  if (range === "all") return "ALL";
+  if (range === "day") return "DAY";
+  const days = bounds.rangeDays ?? 1;
+  return compact ? `${days}D` : `${days} ${days === 1 ? "DAY" : "DAYS"}`;
+}
+
 function modelTotals(events) {
   const totals = new Map();
   for (const event of events) {
@@ -340,21 +346,11 @@ function summary(events) {
 }
 
 function modelLegendItems(models, totalTokens) {
-  const known = new Map();
-  for (const model of models) {
-    const key = ["Sol", "Luna", "Terra", "GPT", "Auto Review"].includes(model.model)
-      ? model.model
-      : "Other";
-    known.set(key, (known.get(key) ?? 0) + model.totalTokens);
-  }
-  const order = ["Luna", "Sol", "Terra", "GPT"];
-  if ((known.get("Auto Review") ?? 0) > 0) order.push("Auto Review");
-  order.push("Other");
-  return order
+  return models
+    .filter((model) => model.totalTokens > 0)
     .map((model) => ({
-      model,
-      totalTokens: known.get(model) ?? 0,
-      share: totalTokens > 0 ? ((known.get(model) ?? 0) / totalTokens) * 100 : 0,
+      ...model,
+      share: totalTokens > 0 ? (model.totalTokens / totalTokens) * 100 : 0,
     }));
 }
 
@@ -430,6 +426,7 @@ function panelLines(rows, allRows, totalTokens, panelWidth, options, enabled) {
     panelWidth - labelWidth - shareWidth - totalWidth - 1 - rightPadding,
   );
   const maxTokens = allRows[0]?.totalTokens ?? 0;
+  const rowOffset = Number.isInteger(options.rowOffset) ? options.rowOffset : 0;
   const lines = [];
   const heading = colorize("TOKENS BY PROJECT", TEAL, enabled);
   const barHeaderWidth = barWidth;
@@ -444,13 +441,14 @@ function panelLines(rows, allRows, totalTokens, panelWidth, options, enabled) {
   lines.push(colorize("─".repeat(panelWidth), DIM, enabled));
 
   for (const [index, row] of rows.entries()) {
+    const rankValue = rowOffset + index + 1;
     const share = totalTokens > 0 ? (row.totalTokens / totalTokens) * 100 : 0;
     const selected = !options.static && index === (options.selectedIndex ?? 0);
     const caretValue = selected ? (options.ascii ? ">" : "▶") : " ";
-    const prefix = `${caretValue} ${index + 1}. `;
+    const prefix = `${caretValue} ${rankValue}. `;
     const projectText = truncateText(displayProject(row), labelWidth - prefix.length);
     const caret = selected ? colorize(caretValue, [1, ...TEAL], enabled) : caretValue;
-    const rank = colorize(`${index + 1}.`, TITLE_STYLE, enabled);
+    const rank = colorize(`${rankValue}.`, TITLE_STYLE, enabled);
     const title = `${caret} ${rank} ${colorize(projectText, TITLE_STYLE, enabled)}`;
     const label = fit(title, labelWidth);
     const metrics = `${fit(compact(row.totalTokens), totalWidth, "right")}${fit(percent(share), shareWidth, "right")}${" ".repeat(rightPadding)}`;
@@ -483,15 +481,26 @@ function sidebarLines(stats, panelWidth, enabled, options = {}, quota = null) {
   const heading = (value) => colorize(value, TEAL, enabled);
   push(heading("MODEL MIX"));
   if (!compactSidebar) push();
-  for (const item of modelLegendItems(stats.models, stats.totalTokens)) {
+  const modelShareWidth = 6;
+  const modelNameWidth = Math.max(1, contentWidth - modelShareWidth - 2);
+  const modelItems = modelLegendItems(stats.models, stats.totalTokens);
+  const modelLimit = Number.isInteger(options.modelLimit)
+    ? Math.max(0, options.modelLimit)
+    : modelItems.length;
+  const visibleModelItems = modelItems.slice(0, modelLimit);
+  for (const item of visibleModelItems) {
     const swatch = colorize("■", modelColor(item.model), enabled);
-    push(`${swatch} ${fit(item.model, Math.max(1, contentWidth - 10))}${fit(percent(item.share), 8, "right")}`);
+    push(`${swatch} ${fit(item.model, modelNameWidth)}${fit(percent(item.share), modelShareWidth, "right")}`);
     if (item.model === "Auto Review" && stats.autoReview.present) {
       const turnLabel = stats.autoReview.turns === 1 ? "turn" : "turns";
       push(`  ${compact(stats.autoReview.turns)} ${turnLabel} · ${percent(stats.autoReview.turnShare)}`);
       push(`  ${compact(stats.autoReview.totalTokens)} · ${percent(stats.autoReview.cachedInputShare)} cached`);
     }
   }
+  const hiddenModelCount = modelItems.length - visibleModelItems.length;
+  if (hiddenModelCount > 0) {
+    push(colorize(`… ${plural(hiddenModelCount, "more model")}`, DIM, enabled));
+  }
   if (!compactSidebar) push();
   divider();
   push(heading("USAGE TYPE · TOKENS"));
@@ -554,7 +563,7 @@ function panel(leftLines, rightLines, leftWidth, rightWidth, enabled, ascii) {
 function headerLines(stats, bounds, frameWidth, options, enabled) {
   const left = colorize("TOKEN LEDGER", TITLE_STYLE, enabled);
   const date = colorize(dateLabel(bounds, options.range), TEXT_STYLE, enabled);
-  const mode = colorize(options.range === "week" ? "7 DAYS" : "DAY", [1, ...TEAL], enabled);
+  const mode = colorize(rangeModeLabel(bounds, options.range), [1, ...TEAL], enabled);
   const metric = (value, label) =>
     `${colorize(String(value), TITLE_STYLE, enabled)} ${colorize(label, DIM, enabled)}`;
   const separator = colorize("·", DIM, enabled);
@@ -573,10 +582,14 @@ function headerLines(stats, bounds, frameWidth, options, enabled) {
     return [alignHeader(fullLine)];
   }
 
-  const compactDate = dateLabel(bounds, options.range)
-    .replace(/ 20\d{2}$/, "")
-    .replace(" – ", "–");
-  const compactMode = options.range === "week" ? "7D" : "DAY";
+  const crossesCalendarYear =
+    bounds.startDateString?.slice(0, 4) !== bounds.endDateString?.slice(0, 4);
+  const compactDate = (
+    crossesCalendarYear
+      ? dateLabel(bounds, options.range)
+      : dateLabel(bounds, options.range).replace(/ 20\d{2}$/, "")
+  ).replace(" – ", "–");
+  const compactMode = rangeModeLabel(bounds, options.range, true);
   const compactLine = [
     left,
     colorize(compactDate, TEXT_STYLE, enabled),
@@ -653,30 +666,84 @@ export function renderFullscreen({ options, snapshot, bounds, events, rows, allR
   const columns = Math.max(40, Number(width) || Number(process.stdout.columns) || 120);
   const screenHeight = Math.max(1, Number(height) || Number(process.stdout.rows) || 32);
   const frameWidth = Math.max(38, Math.min(158, columns - 4));
+  const forceSideBySide = frameWidth >= 84;
+  const staticBudget = Math.max(0, screenHeight - 1);
+  let visibleRows = rows;
+  let fullscreenOptions = {
+    ...options,
+    forceColor: enabled,
+    forceSideBySide,
+    highlight: false,
+    compactSidebar: true,
+    hideHelp: true,
+    width: frameWidth + 2,
+  };
+
+  if (forceSideBySide && staticBudget >= 3) {
+    const stats = summary(events);
+    const quota = quotaCycleSummary(snapshot, events);
+    const panelContentBudget = Math.max(1, staticBudget - 3);
+    const visibleRowCount = Math.min(
+      rows.length,
+      Math.max(1, Math.floor((panelContentBudget - 2) / 2)),
+    );
+    const selectedIndex = Math.max(
+      0,
+      Math.min(rows.length - 1, Number(options.selectedIndex) || 0),
+    );
+    const rowOffset = Math.min(
+      Math.max(0, selectedIndex - visibleRowCount + 1),
+      Math.max(0, rows.length - visibleRowCount),
+    );
+    visibleRows = rows.slice(rowOffset, rowOffset + visibleRowCount);
+
+    const sideWidth = stats.autoReview.present ? 28 : 26;
+    let modelLimit = modelLegendItems(stats.models, stats.totalTokens).length;
+    while (
+      modelLimit > 0 &&
+      sidebarLines(
+        stats,
+        sideWidth,
+        enabled,
+        { ...fullscreenOptions, modelLimit },
+        quota,
+      ).length > panelContentBudget
+    ) {
+      modelLimit -= 1;
+    }
+
+    fullscreenOptions = {
+      ...fullscreenOptions,
+      modelLimit,
+      rowOffset,
+      selectedIndex: selectedIndex - rowOffset,
+    };
+  }
+
   const staticOutput = renderTerminal({
-    options: {
-      ...options,
-      forceColor: enabled,
-      forceSideBySide: frameWidth >= 84,
-      highlight: false,
-      compactSidebar: true,
-      hideHelp: true,
-      width: frameWidth + 2,
-    },
+    options: fullscreenOptions,
     snapshot,
     bounds,
     events,
-    rows,
+    rows: visibleRows,
     allRows,
   });
-  const staticLines = staticOutput.split("\n");
+  let staticLines = staticOutput.split("\n");
   if (staticLines.at(-1) === "") staticLines.pop();
-  const summaryLine = staticLines.shift() ?? "";
   const help = colorize("↑/↓ move   •   j/k move   •   q/esc quit", DIM, enabled);
+  const includeSpacer = staticLines.length + 2 <= screenHeight;
+  const availableStaticLines = Math.max(
+    0,
+    screenHeight - 1 - (includeSpacer ? 1 : 0),
+  );
+  staticLines = staticLines.slice(0, availableStaticLines);
+  const summaryLine = staticLines.shift();
   const content = [
-    { line: summaryLine, background: SCREEN_BASE },
+    ...(summaryLine === undefined
+      ? []
+      : [{ line: summaryLine, background: SCREEN_BASE }]),
     ...staticLines.map((line) => ({ line, background: PANEL_BASE })),
-    { line: "", background: SCREEN_BASE },
+    ...(includeSpacer ? [{ line: "", background: SCREEN_BASE }] : []),
     { line: help, background: SCREEN_BASE },
   ];
   const topPadding = Math.max(0, Math.floor((screenHeight - content.length) / 2));

package/bin/token-ledger.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 import { existsSync, realpathSync } from "node:fs";
+import { createRequire } from "node:module";
 import {
   readFile,
   stat,
@@ -11,6 +12,10 @@ import { fileURLToPath } from "node:url";
 
 import { renderTerminal } from "./token-ledger-terminal.mjs";
 import { startInteractive } from "./token-ledger-tui.mjs";
+import { modelDisplayName } from "../lib/token-ledger-models.mjs";
+
+const require = createRequire(import.meta.url);
+export const VERSION = require("../package.json").version;
 
 export const DEFAULT_SNAPSHOT = resolve(
   homedir(),
@@ -18,6 +23,7 @@ export const DEFAULT_SNAPSHOT = resolve(
   "token-ledger-snapshot.json",
 );
 const DEFAULT_TOP = 10;
+const MAX_RANGE_DAYS = 100_000;
 const DEFAULT_TIME_ZONE = Intl.DateTimeFormat().resolvedOptions().timeZone;
 
 function usage() {
@@ -27,6 +33,16 @@ Usage:
   tledger
   tledger week [end-day]
   tledger day [day]
+  tledger month [end-day]
+  tledger <number>d [end-day]
+  tledger all
+
+Ranges:
+  day                  One calendar day
+  week                 7 days ending on end-day (default: today)
+  month                30 days ending on end-day (default: today)
+  <number>d            That many days ending on end-day, for example 90d
+  all                  Every dated event in the snapshot
 
 Options:
   --date <day>         Date as YYYY-MM-DD, today, or yesterday
@@ -38,10 +54,12 @@ Options:
   --top <number>       Number of projects to show (default: 10)
   --width <number>     Terminal layout width in columns
   --raw-projects       Keep singleton thread labels instead of grouping them
+  -anon                Replace project names with Project 1, Project 2, and so on
   --no-archived        Skip archived_sessions when refreshing
   --plain              Disable terminal colors
   --ascii              Use ASCII bars instead of Unicode blocks
   --static             Print once instead of opening the interactive dashboard
+  -v, --version        Show the installed version
   --help               Show this help
 
 The default view is the seven-day window ending today. Token Ledger never
@@ -56,14 +74,38 @@ function readOption(argv, index, name) {
   return value;
 }
 
+function rangeSpec(value) {
+  if (value === "day") return { range: "day", rangeDays: 1 };
+  if (value === "week") return { range: "week", rangeDays: 7 };
+  if (value === "month") return { range: "month", rangeDays: 30 };
+  if (value === "all") return { range: "all", rangeDays: null };
+  const custom = /^(\d+)d$/.exec(value ?? "");
+  if (!custom) return null;
+  const rangeDays = Number(custom[1]);
+  if (
+    !Number.isSafeInteger(rangeDays) ||
+    rangeDays < 1 ||
+    rangeDays > MAX_RANGE_DAYS
+  ) {
+    throw new Error(
+      `Day range must be an integer from 1 to ${MAX_RANGE_DAYS.toLocaleString("en-US")}, for example 90d.`,
+    );
+  }
+  return { range: `${rangeDays}d`, rangeDays };
+}
+
 export function parseArgs(argv) {
-  const commandExplicit = argv[0] === "day" || argv[0] === "week";
+  const requestedRange = rangeSpec(argv[0]);
+  const commandExplicit = Boolean(requestedRange);
   if (argv[0] && !argv[0].startsWith("-") && !commandExplicit) {
-    throw new Error(`Unknown command: ${argv[0]}. Use day or week.`);
+    throw new Error(
+      `Unknown command: ${argv[0]}. Use day, week, month, all, or a duration like 90d.`,
+    );
   }
-  const command = commandExplicit ? argv[0] : "week";
+  const command = requestedRange ?? { range: "week", rangeDays: 7 };
   const options = {
-    range: command,
+    range: command.range,
+    rangeDays: command.rangeDays,
     date: null,
     input: DEFAULT_SNAPSHOT,
     inputExplicit: false,
@@ -75,9 +117,11 @@ export function parseArgs(argv) {
     top: DEFAULT_TOP,
     width: null,
     rawProjects: false,
+    anonymizeProjects: false,
     plain: false,
     ascii: false,
     static: false,
+    version: false,
     help: false,
   };
 
@@ -86,6 +130,8 @@ export function parseArgs(argv) {
     const argument = argv[index];
     if (argument === "--help" || argument === "-h") {
       options.help = true;
+    } else if (argument === "--version" || argument === "-v") {
+      options.version = true;
     } else if (argument === "--date") {
       options.date = readOption(argv, index, "--date");
       index += 1;
@@ -119,6 +165,8 @@ export function parseArgs(argv) {
       index += 1;
     } else if (argument === "--raw-projects") {
       options.rawProjects = true;
+    } else if (argument === "-anon") {
+      options.anonymizeProjects = true;
     } else if (argument === "--no-archived") {
       options.includeArchived = false;
     } else if (argument === "--plain") {
@@ -134,13 +182,16 @@ export function parseArgs(argv) {
     }
   }
 
-  if (!options.help && !options.date) {
+  if (!options.help && !options.version && options.range === "all" && options.date) {
+    throw new Error("The all range does not accept an end day.");
+  }
+  if (!options.help && !options.version && !options.date && options.range !== "all") {
     options.date = "today";
   }
-  if (!options.help && options.refresh && !options.autoRefresh) {
+  if (!options.help && !options.version && options.refresh && !options.autoRefresh) {
     throw new Error("--refresh cannot be combined with --no-refresh.");
   }
-  if (!options.help && options.refresh && options.inputExplicit) {
+  if (!options.help && !options.version && options.refresh && options.inputExplicit) {
     throw new Error("--refresh cannot be combined with --input.");
   }
   return options;
@@ -243,21 +294,99 @@ export function dayBounds(value, timeZone) {
   const nextDateString = shiftCalendarDate(dateString, 1);
   const start = zonedMidnight(dateString, timeZone);
   const end = zonedMidnight(nextDateString, timeZone);
-  return { dateString, start, end, timeZone };
+  return {
+    dateString,
+    startDateString: dateString,
+    endDateString: dateString,
+    start,
+    end,
+    timeZone,
+    rangeDays: 1,
+  };
 }
 
-export function weekBounds(value, timeZone) {
+export function rollingBounds(value, timeZone, rangeDays) {
+  if (
+    !Number.isSafeInteger(rangeDays) ||
+    rangeDays < 1 ||
+    rangeDays > MAX_RANGE_DAYS
+  ) {
+    throw new Error(
+      `Range days must be an integer from 1 to ${MAX_RANGE_DAYS.toLocaleString("en-US")}.`,
+    );
+  }
   const endDay = dayBounds(value, timeZone);
-  const startDateString = shiftCalendarDate(endDay.dateString, -6);
+  const startDateString = shiftCalendarDate(endDay.dateString, -(rangeDays - 1));
   return {
     ...endDay,
     startDateString,
     endDateString: endDay.dateString,
     start: zonedMidnight(startDateString, timeZone),
-    rangeDays: 7,
+    rangeDays,
   };
 }
 
+export function weekBounds(value, timeZone) {
+  return rollingBounds(value, timeZone, 7);
+}
+
+export function monthBounds(value, timeZone) {
+  return rollingBounds(value, timeZone, 30);
+}
+
+function eventTimestamp(event) {
+  if (typeof event?.timestamp !== "string" || !event.timestamp.trim()) {
+    return Number.NaN;
+  }
+  return new Date(event.timestamp).getTime();
+}
+
+export function allBounds(snapshot, timeZone) {
+  validateTimeZone(timeZone);
+  let earliest = Number.POSITIVE_INFINITY;
+  let latest = Number.NEGATIVE_INFINITY;
+  for (const event of snapshot.events ?? []) {
+    const timestamp = eventTimestamp(event);
+    if (!Number.isFinite(timestamp)) continue;
+    earliest = Math.min(earliest, timestamp);
+    latest = Math.max(latest, timestamp);
+  }
+  if (!Number.isFinite(earliest)) {
+    return {
+      ...dayBounds("today", timeZone),
+      rangeDays: null,
+      allTime: true,
+    };
+  }
+  const dateString = (timestamp) => dateStringFromParts(numericDateParts({
+    value: new Date(timestamp),
+    timeZone,
+  }));
+  const startDateString = dateString(earliest);
+  const endDateString = dateString(latest);
+  return {
+    dateString: endDateString,
+    startDateString,
+    endDateString,
+    start: zonedMidnight(startDateString, timeZone),
+    end: zonedMidnight(shiftCalendarDate(endDateString, 1), timeZone),
+    timeZone,
+    rangeDays: null,
+    allTime: true,
+  };
+}
+
+function boundsForOptions(options, snapshot) {
+  if (options.range === "all") return allBounds(snapshot, options.timeZone);
+  return rollingBounds(options.date, options.timeZone, options.rangeDays);
+}
+
+function describeRange(options, bounds) {
+  if (options.range === "all") return "all time";
+  if (bounds.rangeDays === 1) return bounds.dateString;
+  return `${bounds.startDateString} through ${bounds.endDateString}`;
+}
+
 export function sanitizeTerminalText(value) {
   return String(value ?? "")
     .replace(/\u001b\][^\u0007]*(?:\u0007|\u001b\\)/g, "")
@@ -298,20 +427,14 @@ export function oneOffProjects(snapshot) {
 
 function modelLabel(value) {
   const model = cleanLabel(value, "Unknown model");
-  const lower = model.toLowerCase();
-  if (lower.includes("sol")) return "Sol";
-  if (lower.includes("luna")) return "Luna";
-  if (lower.includes("terra")) return "Terra";
-  if (lower === "gpt-5.5") return "GPT-5.5";
-  if (lower === "gpt-5.4") return "GPT-5.4";
-  return model;
+  return modelDisplayName(model);
 }
 
 export function filterDayEvents(snapshot, bounds) {
   const start = bounds.start.getTime();
   const end = bounds.end.getTime();
   return (snapshot.events ?? []).filter((event) => {
-    const timestamp = new Date(event.timestamp).getTime();
+    const timestamp = eventTimestamp(event);
     return Number.isFinite(timestamp) && timestamp >= start && timestamp < end;
   });
 }
@@ -369,7 +492,13 @@ export function aggregateProjects(snapshot, events, options = {}) {
         return right.totalTokens - left.totalTokens;
       }
       return left.project.localeCompare(right.project);
-    });
+    })
+    .map((row, index) => ({
+      ...row,
+      displayProject: options.anonymizeProjects
+        ? `Project ${index + 1}`
+        : row.displayProject,
+    }));
 }
 
 function sourceLabel(snapshotPath, snapshot) {
@@ -385,7 +514,7 @@ function sourceLabel(snapshotPath, snapshot) {
 function latestActivityDateString(snapshot, timeZone) {
   let latestTimestamp = Number.NEGATIVE_INFINITY;
   for (const event of snapshot.events ?? []) {
-    const timestamp = new Date(event.timestamp).getTime();
+    const timestamp = eventTimestamp(event);
     if (Number.isFinite(timestamp) && timestamp > latestTimestamp) {
       latestTimestamp = timestamp;
     }
@@ -408,11 +537,8 @@ function displayCalendarDate(dateString) {
 }
 
 function emptyState(options, snapshot, bounds) {
-  const rangeDescription = options.range === "week"
-    ? `${bounds.startDateString} through ${bounds.endDateString}`
-    : bounds.dateString;
   const lines = [
-    `No model-call events found for ${rangeDescription} (${bounds.timeZone}).`,
+    `No model-call events found for ${describeRange(options, bounds)} (${bounds.timeZone}).`,
     "Token Ledger reads only Codex history stored on this computer.",
   ];
   const latestDate = latestActivityDateString(snapshot, bounds.timeZone);
@@ -525,10 +651,9 @@ function render(options, snapshot, bounds, events, rows, allRows) {
 }
 
 export async function run(options) {
-  const bounds = options.range === "week"
-    ? weekBounds(options.date, options.timeZone)
-    : dayBounds(options.date, options.timeZone);
+  if (options.range !== "all") boundsForOptions(options);
   const snapshot = await loadSnapshot(options);
+  const bounds = boundsForOptions(options, snapshot);
   const events = filterDayEvents(snapshot, bounds);
   if (events.length === 0) {
     return emptyState(options, snapshot, bounds);
@@ -549,10 +674,9 @@ function shouldUseInteractive(options) {
 }
 
 async function runInteractive(options) {
-  const bounds = options.range === "week"
-    ? weekBounds(options.date, options.timeZone)
-    : dayBounds(options.date, options.timeZone);
+  if (options.range !== "all") boundsForOptions(options);
   const snapshot = await loadSnapshot(options);
+  const bounds = boundsForOptions(options, snapshot);
   const events = filterDayEvents(snapshot, bounds);
   if (events.length === 0) {
     process.stdout.write(`${emptyState(options, snapshot, bounds)}\n`);
@@ -577,6 +701,10 @@ async function main() {
       process.stdout.write(`${usage()}\n`);
       return;
     }
+    if (options.version) {
+      process.stdout.write(`${VERSION}\n`);
+      return;
+    }
     if (shouldUseInteractive(options)) {
       await runInteractive(options);
     } else {

package/lib/token-ledger-collector.mjs

@@ -39,6 +39,8 @@ import {
   workerData,
 } from "node:worker_threads";
 
+import { normalizeModelIdentifier } from "./token-ledger-models.mjs";
+
 const SCHEMA_VERSION = 1;
 const WEEK_MINUTES = 10_080;
 const DEFAULT_MAX_SCAN_WORKERS = 4;
@@ -230,19 +232,7 @@ function hasDetailedBreakdown(usage) {
 }
 
 function normalizeModel(model) {
-  const value = sanitizeLabel(model, "unknown")
-    .toLowerCase()
-    .replaceAll("_", "-");
-  if (value.startsWith("gpt-5.6-sol")) return "gpt-5.6-sol";
-  if (value.startsWith("gpt-5.6-terra")) return "gpt-5.6-terra";
-  if (value.startsWith("gpt-5.6-luna")) return "gpt-5.6-luna";
-  if (value.startsWith("gpt-5.5-cyber")) return "gpt-5.5-cyber";
-  if (value.startsWith("gpt-5.5")) return "gpt-5.5";
-  if (value.startsWith("gpt-5.4-mini")) return "gpt-5.4-mini";
-  if (value.startsWith("gpt-5.4")) return "gpt-5.4";
-  if (value.startsWith("gpt-5.3-codex")) return "gpt-5.3-codex";
-  if (value.startsWith("gpt-5.2")) return "gpt-5.2";
-  return value || "unknown";
+  return normalizeModelIdentifier(sanitizeLabel(model, "unknown"));
 }
 
 function parseStructuredSource(value) {

package/lib/token-ledger-models.mjs

@@ -0,0 +1,113 @@
+const MODEL_PRESENTATIONS = [
+  {
+    canonical: "codex-auto-review",
+    families: ["auto-review", "codex-auto-review"],
+    label: "Auto Review",
+    colorKey: "autoReview",
+  },
+  {
+    canonical: "gpt-daybreak-blue",
+    families: ["daybreak-blue", "gpt-daybreak-blue"],
+    label: "Daybreak Blue",
+    colorKey: "daybreakBlue",
+  },
+  {
+    canonical: "gpt-5.6-sol",
+    families: ["sol", "gpt-5.6-sol"],
+    label: "Sol",
+    colorKey: "sol",
+  },
+  {
+    canonical: "gpt-5.6-luna",
+    families: ["luna", "gpt-5.6-luna"],
+    label: "Luna",
+    colorKey: "luna",
+  },
+  {
+    canonical: "gpt-5.6-terra",
+    families: ["terra", "gpt-5.6-terra"],
+    label: "Terra",
+    colorKey: "terra",
+  },
+  {
+    canonical: "gpt-5.5-cyber",
+    families: ["gpt-5.5-cyber"],
+    label: "GPT-5.5 Cyber",
+    colorKey: "gpt",
+  },
+  {
+    canonical: "gpt-5.5",
+    families: ["gpt-5.5"],
+    label: "GPT-5.5",
+    colorKey: "gpt",
+  },
+  {
+    canonical: "gpt-5.4-mini",
+    families: ["gpt-5.4-mini"],
+    label: "GPT-5.4 Mini",
+    colorKey: "gpt",
+  },
+  {
+    canonical: "gpt-5.4",
+    families: ["gpt-5.4"],
+    label: "GPT-5.4",
+    colorKey: "gpt",
+  },
+  {
+    canonical: "gpt-5.3-codex",
+    families: ["gpt-5.3-codex"],
+    label: "GPT-5.3 Codex",
+    colorKey: "gpt",
+  },
+  {
+    canonical: "gpt-5.2",
+    families: ["gpt-5.2"],
+    label: "GPT-5.2",
+    colorKey: "gpt",
+  },
+  {
+    canonical: "gpt",
+    families: ["gpt"],
+    label: "GPT",
+    colorKey: "gpt",
+    exact: true,
+  },
+  {
+    canonical: "unknown",
+    families: ["unknown", "unknown-model"],
+    label: "Unknown model",
+    colorKey: "other",
+    exact: true,
+  },
+];
+
+function normalizedModel(value) {
+  return String(value || "")
+    .trim()
+    .toLowerCase()
+    .replaceAll("_", "-")
+    .replace(/\s+/g, "-");
+}
+
+function presentationFor(value) {
+  const normalized = normalizedModel(value);
+  return MODEL_PRESENTATIONS.find((presentation) => presentation.families.some(
+    (family) => normalized === family || (
+      presentation.exact !== true && normalized.startsWith(`${family}-`)
+    ),
+  ));
+}
+
+export function normalizeModelIdentifier(value) {
+  const normalized = normalizedModel(value) || "unknown";
+  return presentationFor(normalized)?.canonical || normalized;
+}
+
+export function modelDisplayName(value) {
+  const model = String(value || "").trim();
+  return presentationFor(model)?.label || model || "Unknown model";
+}
+
+export function modelColorKey(value) {
+  return presentationFor(value)?.colorKey || "other";
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tledger",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "A local-only terminal dashboard for Codex token usage",
   "license": "MIT",
   "keywords": [
@@ -36,7 +36,10 @@
     "test:cli": "node --test tests/token-ledger-cli.test.mjs",
     "test:collector": "node --test tests/token-ledger-collector.test.mjs",
     "demo": "node scripts/generate-demo-screenshot.mjs",
-    "prepublishOnly": "npm test"
+    "demo:check": "node scripts/generate-demo-screenshot.mjs --check",
+    "verify:packed": "node scripts/verify-release.mjs",
+    "verify:release": "npm test && npm run verify:packed",
+    "prepublishOnly": "npm run verify:release"
   },
   "publishConfig": {
     "access": "public"