tokentrace 0.12.0 → 0.13.0

package/CHANGELOG.md

@@ -4,11 +4,48 @@ All notable changes to TokenTrace are documented here.
 
 ## Unreleased
 
+## [0.13.0] - 2026-05-20
+
+### Changed
+
+- Overview now uses focused data assembly and smaller panel components, with quieter local development overlays.
+- Overview trend aggregation now avoids SQLite localtime bucketing so large local databases load the first dashboard view much faster.
+- Overview now uses a page-specific analytics profile to avoid computing secondary page insights during first load.
+- Slow dashboard analytics queries now surface through internal timing guardrails and doctor output.
+- CLI startup code is split into focused context, help, runtime, serve, and command modules while keeping the executable entrypoint thin.
+- Analytics queries are split into summary, trends, entities, repair, scan-trust, and insight domains to reduce hotspot risk.
+- Scan Health is split into focused diagnostics panels so the route stays limited to data assembly and composition.
+- Session Explorer now has sticky dense-table headers, clearer active-filter chips, row-density controls, faster reset actions, and stronger empty states.
+- Session Explorer filtering, summaries, high-cost thresholding, active-filter labels, and saved-view serialization now live in pure helper functions.
+- Repair now highlights the top unknown-cost cause, next best repair, expected impact, and clearer resolved, ignored, and parser-review state copy backed by executable repair actions.
+- Repair page data loading, summary cards, guidance, and repair queue table now live in focused modules so the route stays small.
+- Model Rates now has clearer repair-context copy, edit validation, duplicate provider/model warnings, save-result feedback, and CSV import/export for bulk rate changes.
+- Codex CLI ingestion now handles JSON-array session exports, warns on malformed local records, and persistence now reports empty, duplicate, or mismatched replacement imports before writing.
+- Unknown-cost repair actions are split into a focused helper module for clearer repair causes, next actions, and resolved-state copy.
+- Settings is split into focused scan, import profile, guardrail, package trust, export, storage, and custom-folder sections.
+- Mobile navigation now uses a compact command menu plus priority shortcuts, and first-run setup now leads users through local folders, model rates, scan, Scan Health, and review without cloud or sample-data assumptions.
+- Dashboard tables, page actions, and compact metric cards now behave better at narrow mobile widths.
+- `tokentrace serve` now prints clearer startup progress, help examples, browser-open guidance, and fixed-port conflict recovery steps.
+- CLI smoke checks are split into discovery, JSON/data, runtime watch, and dashboard serve modules so package smoke failures point to the broken surface.
+- Route loading copy now reinforces that TokenTrace is reading local database records without sending telemetry.
+- Repair and Model Rates now use mobile card layouts on narrow screens instead of forcing wide table workflows.
+- Unknown-cost repair, scan ingestion, Evidence Trail, and Pricing Settings internals are split into smaller focused modules to reduce hotspot risk and make future repair work safer.
+- Pricing saves, model-rate refreshes, and scans now report a repair delta showing unknown-cost before/after counts, resolved groups, and the top remaining blocked cause.
+- Settings now defers dense package trust, guardrail, import profile, and export sections while preserving section anchors.
+- Added `npm run browser:guard` to fail browser smoke runs on console errors, page errors, Next dev overlay issues, blank charts, and severe mobile overflow.
+
+## [0.12.1] - 2026-05-19
+
+### Fixed
+
+- Public docs, CLI help, package runtime output, and agent-readable release status now describe shipped TokenTrace behavior only.
+- Future-version roadmap labels no longer appear in public package surfaces.
+
 ## [0.12.0] - 2026-05-19
 
 ### Added
 
-- 0.12.0 Local Sources & Trust roadmap, rolling the 0.13.0 Evidence Portability, 0.14.0 Local Operations, 0.15.0 Governance & Guardrails, 0.16.0 Parser Studio, 0.17.0 Reports, and 0.18.0 Agent Handoff themes into one larger release.
+- Local Sources & Trust release bundle covering native local ingestion, evidence packs, scan scheduling, scoped guardrails, import-profile preview, saved reports, operating metadata export, and agent-readable release status.
 - Native structured usage log ingestion for local wrappers and team JSONL/NDJSON logs with session, model, token, and source-cost fields.
 - Native Cursor-style chat/composer export ingestion with local source evidence and no raw prompt storage by default.
 - Source Catalog and Source Coverage in Scan Health so users can distinguish native, profile-assisted, fallback, and unsupported local files.
@@ -18,7 +55,7 @@ All notable changes to TokenTrace are documented here.
 - Import Profile preview for sampling a local file, checking parser fit, reviewing detected fields, and applying recommended matchers without exposing raw content.
 - Saved report definitions and export endpoints for weekly usage, high-cost sessions, unknown-cost repair, confidence trends, guardrail status, and source coverage in Markdown, JSON, and CSV.
 - Operating metadata export for settings, source catalog, schedules, guardrails, report definitions, and roadmap status without raw usage records.
-- Agent-readable Roadmap V2 with current release, next planned release, rolled-up release themes, action recipes, evidence paths, verification gates, and release status.
+- Agent-readable release status with implemented cards, action recipes, evidence paths, verification gates, and release status.
 
 ### Changed
 
@@ -37,7 +74,7 @@ All notable changes to TokenTrace are documented here.
 - Chart cards now show lightweight loading placeholders during client hydration instead of appearing blank while Recharts initializes.
 - Session Explorer now paginates large local result sets to keep dense session tables responsive.
 - Repair now opens as a capped workbench of the top visible unknown-cost groups, while keeping full summary counts and focused repair links for deep review.
-- Roadmap CLI/API now report the 0.12.0 Local Sources & Trust release contract and the next planned 0.19.0 direction.
+- Roadmap CLI/API now report the 0.12.0 release contract, implemented cards, action recipes, evidence paths, verification gates, and release status.
 
 ### Fixed
 
@@ -295,7 +332,7 @@ All notable changes to TokenTrace are documented here.
 ### Added
 
 - Visible running TokenTrace version in the desktop sidebar, mobile header, and Settings.
-- 0.4.0 roadmap and release checklist documenting internal milestones without intermediate public releases.
+- 0.4.0 roadmap and release checklist for maintainer-approved public releases.
 - `tokentrace doctor --json` plus a shared Doctor report model for scan health and repair recommendations.
 - Bundled parser provenance metadata on imported scan files, including parser id, display name, source, and version.
 - Unknown-cost repair queue on Overview, grouped by cause, model, tool, source file, and repair path.

package/README.md

@@ -40,7 +40,7 @@ tokentrace agent --json # Print machine-readable agent discovery manifest
 tokentrace capabilities --json
                         # Alias for agent discovery manifest
 tokentrace roadmap --json
-                        # Print Local Sources & Trust release handoff
+                        # Print release status handoff
 tokentrace scan         # Scan local AI CLI usage logs
 tokentrace doctor --json
                         # Inspect scan health and repair recommendations
@@ -159,10 +159,9 @@ tokentrace roadmap --json
 
 ## Local Sources And Trust
 
-TokenTrace 0.12.0 rolls the next several roadmap themes into one larger
-release: local source expansion, evidence portability, local operations,
-scoped guardrails, parser profile preview, saved reports, and agent-readable
-roadmap handoff.
+TokenTrace 0.12.0 bundles local source expansion, evidence exports, scan
+scheduling, scoped guardrails, parser profile preview, saved reports, and
+agent-readable release status.
 
 New trust surfaces include:
 
@@ -196,9 +195,9 @@ The dashboard surfaces a Data Confidence score on Overview, Projects, Sessions,
 and Session Timeline pages. Scan Health also includes a supply-chain IOC check
 so package trust is visible in the product, not only in release scripts.
 
-Release work uses internal milestone commits until the next public minor
-release. See [docs/RELEASE_CHECKLIST.md](docs/RELEASE_CHECKLIST.md) before
-bumping versions, tagging, creating GitHub releases, or publishing npm.
+Public releases require maintainer approval. See
+[docs/RELEASE_CHECKLIST.md](docs/RELEASE_CHECKLIST.md) before bumping versions,
+tagging, creating GitHub releases, or publishing npm.
 
 In local development, the SQLite database defaults to `.tokentrace/tokentrace.db`. Override it with:
 

package/TOKENTRACE_AGENT.md

@@ -26,9 +26,9 @@ curl http://127.0.0.1:3030/api/agent
 curl http://127.0.0.1:3030/api/capabilities
 ```
 
-## Roadmap Status
+## Release Status
 
-Inspect the current 0.12.0 Local Sources & Trust handoff, action recipes, and release blockers:
+Inspect the current release handoff, action recipes, and release status:
 
 ```bash
 tokentrace roadmap --json

package/app/api/prices/route.ts

@@ -62,6 +62,7 @@ export async function POST(request: Request) {
     interactionsChecked: result.interactionsChecked,
     unknownCostInteractions: result.unknownCostInteractions,
     modelAliasesUpdated: result.modelsUpdated,
-    resolvedRepairItems: result.resolvedRepairItems
+    resolvedRepairItems: result.resolvedRepairItems,
+    repairDelta: result.repairDelta
   });
 }