tledger 0.1.2 → 0.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jskoiz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,21 +1,36 @@
 # 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.
 
 ![Token Ledger running with synthetic demo data](https://raw.githubusercontent.com/jskoiz/token-ledger/main/docs/token-ledger-demo.svg)
 
 _The screenshot is generated from an intentionally synthetic fixture._
 
+## Requirements
+
+Token Ledger requires Node.js 22.13 or newer and npm. Install a supported LTS
+release from [nodejs.org](https://nodejs.org/en/download) if either command is
+missing, then confirm the versions in a new terminal:
+
+```bash
+node --version
+npm --version
+```
+
 ## Install
 
-Token Ledger requires Node.js 22.13 or newer and has no runtime npm
-dependencies.
+Token Ledger has no runtime npm dependencies and runs no installation script.
 
 ```bash
 npm install --global tledger
+tledger --version
 ```
 
 ## Use
@@ -26,11 +41,19 @@ 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.
+Escape to exit. If the selected period is empty, Token Ledger reports the most
+recent local activity date and prints the exact command for opening it.
 
 Useful options:
 
@@ -43,14 +66,31 @@ 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
 ```
 
+## Update or uninstall
+
+```bash
+npm install --global tledger@latest
+tledger --version
+npm uninstall --global tledger
+```
+
+Uninstalling the npm package leaves the privacy-reduced cache at
+`~/.token-ledger/token-ledger-snapshot.json`. Remove that directory separately
+only when you also want the next installation to perform a completely fresh
+scan.
+
+## Local data and privacy
+
 By default, Token Ledger reads `CODEX_HOME` or `~/.codex` and keeps a
 privacy-reduced cache at `~/.token-ledger/token-ledger-snapshot.json`. It checks
 source freshness automatically. Fresh scans use a bounded pool of up to four
@@ -58,13 +98,18 @@ 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
+
+[MIT](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) {
@@ -382,6 +511,45 @@ function sourceLabel(snapshotPath, snapshot) {
   return `${cleanLabel(basename(snapshotPath), "snapshot")} · captured ${generated}`;
 }
 
+function latestActivityDateString(snapshot, timeZone) {
+  let latestTimestamp = Number.NEGATIVE_INFINITY;
+  for (const event of snapshot.events ?? []) {
+    const timestamp = eventTimestamp(event);
+    if (Number.isFinite(timestamp) && timestamp > latestTimestamp) {
+      latestTimestamp = timestamp;
+    }
+  }
+  if (!Number.isFinite(latestTimestamp)) return null;
+  return dateStringFromParts(numericDateParts({
+    value: new Date(latestTimestamp),
+    timeZone,
+  }));
+}
+
+function displayCalendarDate(dateString) {
+  const [year, month, day] = dateString.split("-").map(Number);
+  return new Intl.DateTimeFormat("en-US", {
+    month: "long",
+    day: "numeric",
+    year: "numeric",
+    timeZone: "UTC",
+  }).format(new Date(Date.UTC(year, month - 1, day)));
+}
+
+function emptyState(options, snapshot, bounds) {
+  const lines = [
+    `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);
+  if (latestDate) {
+    lines.push(`Latest local activity: ${displayCalendarDate(latestDate)}.`);
+    lines.push(`Try: tledger ${options.range} ${latestDate}`);
+  }
+  lines.push(`Source: ${sourceLabel(options.input, snapshot)}`);
+  return lines.join("\n");
+}
+
 async function readSnapshot(snapshotPath) {
   let parsed;
   try {
@@ -483,19 +651,12 @@ 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) {
-    const rangeDescription = options.range === "week"
-      ? `${bounds.startDateString} through ${bounds.endDateString}`
-      : bounds.dateString;
-    return [
-      `No model-call events found for ${rangeDescription} (${bounds.timeZone}).`,
-      `Source: ${sourceLabel(options.input, snapshot)}`,
-    ].join("\n");
+    return emptyState(options, snapshot, bounds);
   }
   const allRows = aggregateProjects(snapshot, events, options);
   const rows = allRows.slice(0, options.top);
@@ -513,20 +674,12 @@ 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) {
-    const rangeDescription = options.range === "week"
-      ? `${bounds.startDateString} through ${bounds.endDateString}`
-      : bounds.dateString;
-    process.stdout.write([
-      `No model-call events found for ${rangeDescription} (${bounds.timeZone}).`,
-      `Source: ${sourceLabel(options.input, snapshot)}`,
-      "",
-    ].join("\n"));
+    process.stdout.write(`${emptyState(options, snapshot, bounds)}\n`);
     return;
   }
   const allRows = aggregateProjects(snapshot, events, options);
@@ -548,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,7 +1,8 @@
 {
   "name": "tledger",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "A local-only terminal dashboard for Codex token usage",
+  "license": "MIT",
   "keywords": [
     "codex",
     "cli",
@@ -24,6 +25,7 @@
   "files": [
     "bin/",
     "lib/",
+    "LICENSE",
     "README.md"
   ],
   "bin": {
@@ -34,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"