chore: bump version to 0.8.2, update changelog and readme

Author: iamtoruk

CHANGELOG.md

@@ -1,14 +1,23 @@
 # Changelog
 
-## Unreleased
+## 0.8.2 - 2026-04-20
 
 ### Added
-- **Persistent parse cache for all providers.** Repeated CLI runs now reuse parsed source summaries across fresh processes instead of reparsing raw logs every time.
-- **`--no-cache` on parse-backed commands.** `report`, `today`, `month`, `status`, `export`, `optimize`, and `compare` can bypass cached entries for that run and rebuild them from raw logs.
-- **`Updating cache` stderr progress.** Non-JSON cold or partial cache rebuilds now show progress while CodeBurn refreshes changed sources.
+- **Persistent parse cache for all providers.** Repeated CLI runs now reuse parsed source summaries across fresh processes instead of reparsing raw logs every time. Cache lives at `~/.cache/codeburn/source-cache-v1/` with atomic writes and 0600 file permissions. Credit: @spMohanty (PR #116).
+- **`--no-cache` on parse-backed commands.** `report`, `today`, `month`, `status`, `export`, `optimize`, and `compare` can bypass cached entries for that run and rebuild them from raw logs. Credit: @spMohanty (PR #116).
+- **`Updating cache` stderr progress.** Non-JSON cold or partial cache rebuilds now show progress while CodeBurn refreshes changed sources. Credit: @spMohanty (PR #116).
+- **`codeburn plan` subscription tracking.** Set your plan (`claude-pro`, `claude-max`, `cursor-pro`, or custom) to see a usage progress bar in the dashboard. Includes 7-day trailing median projection and billing-cycle-aware period math. Credit: @tmchow (PR #74).
 
 ### Changed
-- **Cursor now uses the shared parse cache.** The provider-specific Cursor cache path is gone; SQLite-backed provider data now flows through the same persistent cache layer as the other providers.
+- **Cursor now uses the shared parse cache.** The provider-specific Cursor cache path is gone; SQLite-backed provider data now flows through the same persistent cache layer as the other providers. Credit: @spMohanty (PR #116).
+
+### Fixed
+- **Model pricing: removed bidirectional fuzzy match.** `canonical.startsWith(key) || key.startsWith(canonical)` could match unrelated models. Now uses one-directional prefix only. Credit: @hobostay (PR #77).
+- **Zero-cost models incorrectly filtered.** `!entry.input_cost_per_token` treated `0` as missing. Now checks `=== undefined` so free-tier models retain their pricing entry. Credit: @hobostay (PR #77).
+- **File descriptor leak in `readSessionLines`.** Generator now calls `stream.destroy()` in a `finally` block so early abandonment does not leak open handles. Credit: @hobostay (PR #77).
+- **CSV injection guard extended.** Tab and carriage return characters at cell start are now escaped alongside `=`, `+`, `-`, `@`. Credit: @hobostay (PR #77).
+- **Crash on empty export periods.** Optional chaining prevents `undefined` access when a period has no projects. Credit: @hobostay (PR #77).
+- **Config read crash on malformed JSON.** Restored catch-all error handling in `readConfig` so a corrupt `config.json` returns defaults instead of crashing.
 
 ## 0.8.0 - 2026-04-19
 

README.md

@@ -10,7 +10,7 @@
   <a href="https://www.npmjs.com/package/codeburn"><img src="https://img.shields.io/npm/v/codeburn.svg" alt="npm version" /></a>
   <a href="https://www.npmjs.com/package/codeburn"><img src="https://img.shields.io/npm/dt/codeburn.svg" alt="total downloads" /></a>
   <a href="https://github.com/getagentseal/codeburn/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/codeburn.svg" alt="license" /></a>
-  <a href="https://github.com/getagentseal/codeburn"><img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg" alt="node version" /></a>
+  <a href="https://github.com/getagentseal/codeburn"><img src="https://img.shields.io/badge/node-%3E%3D22-brightgreen.svg" alt="node version" /></a>
 </p>
 
 <p align="center">
@@ -35,9 +35,9 @@ npx codeburn
 
 ### Requirements
 
-- Node.js 20+
+- Node.js 22+
 - Claude Code (`~/.claude/projects/`), Codex (`~/.codex/sessions/`), Cursor, OpenCode, Pi (`~/.pi/agent/sessions/`), and/or GitHub Copilot (`~/.copilot/session-state/`)
-- For Cursor/OpenCode support: `better-sqlite3` is installed automatically as an optional dependency
+- For Cursor/OpenCode support: uses Node's built-in `node:sqlite` (Node 22+)
 
 ## Usage
 
@@ -159,7 +159,7 @@ Either flag alone is valid. Inverted or malformed dates exit with a clear error.
 
 Codex tool names are normalized to match Claude's conventions (`exec_command` shows as `Bash`, `read_file` as `Read`, etc.) so the activity classifier and tool breakdown work across providers.
 
-Cursor reads token usage from its local SQLite database. Since Cursor's "Auto" mode hides the actual model used, costs are estimated using Sonnet pricing (labeled "Auto (Sonnet est.)" in the dashboard). The Cursor view shows a **Languages** panel (extracted from code blocks) instead of Core Tools/Shell/MCP panels, since Cursor does not log individual tool calls. First run on a large Cursor database may take up to a minute; results are cached and subsequent runs are instant.
+Cursor reads token usage from its local SQLite database via Node's built-in `node:sqlite`. Since Cursor's "Auto" mode hides the actual model used, costs are estimated using Sonnet pricing (labeled "Auto (Sonnet est.)" in the dashboard). The Cursor view shows a **Languages** panel (extracted from code blocks) instead of Core Tools/Shell/MCP panels, since Cursor does not log individual tool calls. Parsed results are cached through the shared persistent cache layer.
 
 GitHub Copilot only logs output tokens in its session state, so Copilot cost rows sit below actual API cost. The model is tracked via `session.model_change` events; messages before the first model change are skipped to avoid silent misattribution.
 
@@ -339,28 +339,35 @@ CodeBurn reads these files, deduplicates messages (by API message ID for Claude,
 
 ```
 src/
-  cli.ts          Commander.js entry point
-  dashboard.tsx   Ink TUI (React for terminals)
-  parser.ts       JSONL reader, dedup, date filter, provider orchestration
-  models.ts       LiteLLM pricing, cost calculation
-  classifier.ts   13-category task classifier
-  compare-stats.ts Model comparison engine (metrics, category breakdown, working style)
-  types.ts        Type definitions
-  format.ts       Text rendering (status bar)
-  menubar-json.ts Payload builder consumed by the native macOS menubar app in mac/
-  export.ts       CSV/JSON multi-period export
-  config.ts       Config file management (~/.config/codeburn/)
-  currency.ts     Currency conversion, exchange rates, Intl formatting
-  sqlite.ts       SQLite adapter (lazy-loads better-sqlite3)
-  cursor-cache.ts Cursor result cache (file-based, auto-invalidating)
+  cli.ts            Commander.js entry point
+  dashboard.tsx     Ink TUI (React for terminals)
+  parser.ts         JSONL reader, dedup, date filter, provider orchestration
+  models.ts         LiteLLM pricing, cost calculation
+  classifier.ts     13-category task classifier
+  compare-stats.ts  Model comparison engine (metrics, category breakdown, working style)
+  types.ts          Type definitions
+  format.ts         Text rendering (status bar)
+  menubar-json.ts   Payload builder consumed by the native macOS menubar app in mac/
+  export.ts         CSV/JSON multi-period export
+  config.ts         Config file management (~/.config/codeburn/)
+  currency.ts       Currency conversion, exchange rates, Intl formatting
+  sqlite.ts         SQLite adapter (node:sqlite)
+  source-cache.ts   Persistent parse cache (manifest + per-source entries)
+  discovery-cache.ts Provider directory scan caching
+  parse-progress.ts Stderr progress bar for cache rebuilds
+  provider-colors.ts Provider color and label constants
+  plans.ts          Subscription plan presets and validators
+  plan-usage.ts     Billing period math and usage projection
+  fs-utils.ts       Bounded file readers with stream support
   providers/
-    types.ts      Provider interface definitions
-    index.ts      Provider registry (lazy-loads Cursor, OpenCode)
-    claude.ts     Claude Code session discovery
-    codex.ts      Codex session discovery and JSONL parsing
-    cursor.ts     Cursor SQLite parsing, language extraction
-    opencode.ts   OpenCode SQLite session discovery and parsing
-    pi.ts         Pi agent JSONL session discovery and parsing
+    types.ts        Provider interface definitions
+    index.ts        Provider registry (lazy-loads Cursor, OpenCode)
+    claude.ts       Claude Code session discovery
+    codex.ts        Codex session discovery and JSONL parsing
+    copilot.ts      GitHub Copilot session state parsing
+    cursor.ts       Cursor SQLite parsing, language extraction
+    opencode.ts     OpenCode SQLite session discovery and parsing
+    pi.ts           Pi agent JSONL session discovery and parsing
 ```
 
 ## Star History

package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeburn",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "See where your AI coding tokens go - by task, tool, model, and project",
   "type": "module",
   "main": "./dist/cli.js",