Skip to content

Releases

tledger 0.4.0

Choose a tag to compare

@jskoiz jskoiz released this 11 Sep 02:10

Token Ledger 0.4.0

Highlights

  • One-day PNG reports now show hourly token usage and cache efficiency, with
    a partial current hour and support for daylight-saving transitions.
  • Add --private to a report to replace project names with ranked anonymous
    labels. Usage figures stay visible, the source snapshot stays unchanged,
    and the default output filename ends in -private.png.
  • Recognize Astra in usage reports. Models without bundled prices remain
    explicitly unrated in purchased-credit and API-equivalent estimates.
  • Keep model names and token amounts readable in narrow bars, with floating
    labels for small segments and captions for small model-mix shares.
  • Show unrecorded fast-mode status separately from confirmed fast usage.

Correctness and reliability

  • Allocate compacted usage across local calendar and hourly boundaries, retain
    persisted call counts, and compare equivalent partial reporting periods.
  • Keep report cutoffs fixed during collection and disclose allocated estimates.
  • Repair token timestamps that precede their own recorded turn, preserve token
    totals, and mark the replacement time as estimated.
  • Reject impossible quota-window timestamps so valid meter history remains
    visible, and keep meter attribution separate from daily token precision.
  • Correct detailed-call coverage for total-only records while retaining valid
    partial coverage in compacted history.
  • Preserve competing snapshot replacements during publication checks.
  • Redact local project paths during legacy migration and report materialization,
    and redact local paths in CLI and collector diagnostics.
  • Reject malformed quota readings, handle fragmented terminal key sequences,
    and tolerate XML-invalid label characters during PNG encoding.
  • Improve cross-month labels, narrow chart spacing, peak-hour labels, and
    fallback to token bars when observed drain is unavailable.
  • Preserve persisted thread-title updates and isolate benchmark state from the
    live ledger.

Release checks and requirements

Requires Node.js 22.13 or newer. CI and prepublish checks include regular and
stress tests, lint, and offline installation of the packed artifact with CLI
and PNG smoke tests. Token Ledger remains a local-only CLI.

tledger 0.3.1

Choose a tag to compare

@jskoiz jskoiz released this 23 Aug 19:25
a249bce

What's changed

  • Current-day reports now end at the latest verified local data time instead of drawing a misleading flat line through the rest of the day.
  • Weekly-limit readings are clearly identified as OpenAI-reported; dashed holds mean the report is awaiting another provider update.
  • Report generation cheaply checks local source modification times and only reruns the full parser when the sources changed.
  • Partial-day/report-time labels, responsive chart details, and timezone-aligned trend boundaries are corrected.

Verification

  • 161 automated tests passed.
  • GitHub CI passed on Node 22.13.0 and Node 26.x.
  • GitGuardian checks passed.
  • The release tarball passed clean-install, CLI, report PNG, and cache-report PNG smoke tests.

tledger 0.3.0

Choose a tag to compare

@jskoiz jskoiz released this 23 Aug 18:01
c325a58

Highlights

  • Rebuilt the 7-day report around actual token volume, corrected Luna/model representation, continuous weekly-meter lines, aligned cache reporting, and safe project-label truncation.
  • Added bounded, privacy-reduced gzip snapshots with adaptive historical rollups, a 16 MiB compressed cap, and a 64 MiB decompression limit.
  • Allocated boundary-spanning compacted history proportionally so day, rolling-window, chart, cache, project, and quota totals remain additive.
  • Simplified the default CLI help to the essential commands while retaining the full reference under tledger --help-all.

Install

npm install -g tledger@0.3.0

Published on npm as tledger@0.3.0.

Verification

Validated on Node 22.13 and Node 26, including 159 tests, lint, clean tarball installation, terminal smoke tests, and both PNG report paths.

tledger 0.1.4

Choose a tag to compare

@jskoiz jskoiz released this 12 Aug 00:13
70d593c

What is new

  • Model Mix now names every active model, including Daybreak Blue and previously unrecognized identifiers.
  • The new -anon option replaces project names with Project 1, Project 2, and so on in terminal output.
  • Height-aware fullscreen rendering keeps navigation controls and key usage sections visible as the model list grows.
  • The new --version and -v options report the installed package version.

Release quality

  • Verified on exact Node 22.13.0 and Node 26.
  • Publication is gated by 36 tests and an isolated eight-file packed-install check.
  • The public synthetic demo now covers Daybreak Blue and unrecognized model names.

Install or update
npm install --global tledger@0.1.4