tokentrace 0.12.0 → 0.12.1

package/CHANGELOG.md

@@ -4,11 +4,18 @@ All notable changes to TokenTrace are documented here.
 
 ## Unreleased
 
+## [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 +25,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 +44,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 +302,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/bin/tokentrace.js

@@ -30,7 +30,7 @@ Usage:
   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

package/dist/runtime/agent.mjs

@@ -112,15 +112,15 @@ var commands = [
   },
   {
     id: "roadmap",
-    title: "Print Local Sources & Trust release handoff",
+    title: "Print release status handoff",
     command: ["tokentrace", "roadmap", "--json"],
-    description: "Return current release, rolled-up roadmap themes, action recipes, evidence paths, verification gates, and release status.",
+    description: "Return current release status, implemented cards, action recipes, evidence paths, and verification gates.",
     output: "json",
     mutatesLocalState: false,
     startsLongRunningProcess: false,
     requiresNetwork: false,
     safeForAutomation: true,
-    useWhen: "The agent needs to explain Local Sources & Trust implementation, action recipes, and verification status.",
+    useWhen: "The agent needs to explain shipped implementation status, action recipes, and verification status.",
     followUps: [
       ["tokentrace", "agent", "--json"]
     ]

package/dist/runtime/roadmap.mjs

@@ -18,50 +18,6 @@ function isAtLeastVersion(version, target) {
   }
   return true;
 }
-var rolledUpReleases = [
-  {
-    version: "0.12.0",
-    title: "Local Sources",
-    thesis: "Make local source support explicit through native adapters, source catalog, and coverage metadata.",
-    includedIn: "0.12.0"
-  },
-  {
-    version: "0.13.0",
-    title: "Evidence Portability",
-    thesis: "Make evidence exportable without leaking raw prompt or message content.",
-    includedIn: "0.12.0"
-  },
-  {
-    version: "0.14.0",
-    title: "Local Operations",
-    thesis: "Add local scan scheduling, scan result status, and operating metadata.",
-    includedIn: "0.12.0"
-  },
-  {
-    version: "0.15.0",
-    title: "Governance & Guardrails",
-    thesis: "Add scoped guardrails, thresholds, movement, and anomaly surfaces.",
-    includedIn: "0.12.0"
-  },
-  {
-    version: "0.16.0",
-    title: "Parser Studio",
-    thesis: "Let users preview local files and build import profiles without parser code.",
-    includedIn: "0.12.0"
-  },
-  {
-    version: "0.17.0",
-    title: "Reports",
-    thesis: "Turn local usage into reusable Markdown, JSON, and CSV operating artifacts.",
-    includedIn: "0.12.0"
-  },
-  {
-    version: "0.18.0",
-    title: "Agent Handoff",
-    thesis: "Expose roadmap, actions, evidence paths, and release gates in stable machine-readable JSON.",
-    includedIn: "0.12.0"
-  }
-];
 var cards = [
   {
     id: "TT-120-01",
@@ -186,13 +142,13 @@ var cards = [
   },
   {
     id: "TT-120-10",
-    title: "Agent-Readable Roadmap V2",
-    outcome: "Roadmap JSON becomes a live handoff for agents.",
+    title: "Agent-Readable Release Status",
+    outcome: "Roadmap JSON reports shipped release status for agents.",
     status: "implemented",
     details: [
-      "Roadmap status includes current release, next planned release, and rolled-up release themes.",
+      "Roadmap status includes the current release, implemented cards, action recipes, evidence paths, verification gates, and release status.",
       "Action recipes cover scan, evidence export, repair review, reports, Scan Health, and model-rate review.",
-      "Evidence paths and verification gates remain machine-readable."
+      "Unreleased planning details stay out of machine-readable public status."
     ],
     evidence: ["src/lib/roadmap-status.ts", "scripts/roadmap.ts", "tests/roadmap-status.test.ts"]
   }
@@ -247,13 +203,7 @@ function buildRoadmapStatus(options = {}) {
     version: "0.12.0",
     codename: "Local Sources & Trust",
     packageVersion: options.packageVersion ?? "unknown",
-    thesis: "TokenTrace should import more local sources, make evidence portable, run local operations, enforce scoped guardrails, support parser setup, export reports, and hand agents a stable roadmap contract.",
-    next: {
-      version: "0.19.0",
-      title: "Team Operating Layer",
-      note: "After the rolled-up 0.12.0 release, the next roadmap can focus on team sharing, policy workflows, and deeper source-specific integrations."
-    },
-    rolledUpReleases,
+    thesis: "TokenTrace should import more local sources, explain evidence, run local scans, enforce scoped guardrails, support parser setup, export reports, and give agents a stable release-status contract.",
     cards,
     handoff: {
       schemaVersion: "tokentrace.roadmap.v2",
@@ -299,7 +249,7 @@ function usage() {
   tokentrace roadmap --json
 
 Options:
-  --json       Print the machine-readable Local Sources & Trust release handoff
+  --json       Print the machine-readable release status handoff
   -h, --help   Print roadmap help`;
 }
 function packageVersion() {

package/llms.txt

@@ -31,7 +31,7 @@ Roadmap status is available through `tokentrace roadmap --json` and
 - `tokentrace evidence --json`: trace aggregate numbers back to local sources.
 - `tokentrace repair --json`: inspect unknown-cost repair work.
 - `tokentrace digest --json`: summarize local usage.
-- `tokentrace roadmap --json`: inspect the 0.12.0 Local Sources & Trust handoff, action recipes, evidence paths, and release blockers.
+- `tokentrace roadmap --json`: inspect the current release handoff, action recipes, evidence paths, and release status.
 - `tokentrace statusline setup claude`: print Claude Code status-line setup.
 - `tokentrace watch --session --compact`: terminal sidecar fallback for Codex.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokentrace",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "Local-first dashboard for AI CLI token, cost, and session analytics.",
   "author": {
     "name": "Abhi Yoheswaran",

package/scripts/roadmap.ts

@@ -7,7 +7,7 @@ function usage() {
   tokentrace roadmap --json
 
 Options:
-  --json       Print the machine-readable Local Sources & Trust release handoff
+  --json       Print the machine-readable release status handoff
   -h, --help   Print roadmap help`;
 }
 

package/src/lib/agent-discovery.ts

@@ -180,15 +180,15 @@ const commands: AgentDiscoveryCommand[] = [
   },
   {
     id: "roadmap",
-    title: "Print Local Sources & Trust release handoff",
+    title: "Print release status handoff",
     command: ["tokentrace", "roadmap", "--json"],
-    description: "Return current release, rolled-up roadmap themes, action recipes, evidence paths, verification gates, and release status.",
+    description: "Return current release status, implemented cards, action recipes, evidence paths, and verification gates.",
     output: "json",
     mutatesLocalState: false,
     startsLongRunningProcess: false,
     requiresNetwork: false,
     safeForAutomation: true,
-    useWhen: "The agent needs to explain Local Sources & Trust implementation, action recipes, and verification status.",
+    useWhen: "The agent needs to explain shipped implementation status, action recipes, and verification status.",
     followUps: [
       ["tokentrace", "agent", "--json"]
     ]

package/src/lib/roadmap-status.ts

@@ -9,13 +9,6 @@ export type RoadmapCard = {
   evidence: string[];
 };
 
-export type RolledUpRelease = {
-  version: string;
-  title: string;
-  thesis: string;
-  includedIn: "0.12.0";
-};
-
 export type RoadmapActionRecipe = {
   id: string;
   title: string;
@@ -29,12 +22,6 @@ export type RoadmapStatus = {
   codename: "Local Sources & Trust";
   packageVersion: string;
   thesis: string;
-  next: {
-    version: "0.19.0";
-    title: "Team Operating Layer";
-    note: string;
-  };
-  rolledUpReleases: RolledUpRelease[];
   cards: RoadmapCard[];
   handoff: {
     schemaVersion: "tokentrace.roadmap.v2";
@@ -73,51 +60,6 @@ function isAtLeastVersion(version: string | undefined, target: string) {
   return true;
 }
 
-const rolledUpReleases: RolledUpRelease[] = [
-  {
-    version: "0.12.0",
-    title: "Local Sources",
-    thesis: "Make local source support explicit through native adapters, source catalog, and coverage metadata.",
-    includedIn: "0.12.0"
-  },
-  {
-    version: "0.13.0",
-    title: "Evidence Portability",
-    thesis: "Make evidence exportable without leaking raw prompt or message content.",
-    includedIn: "0.12.0"
-  },
-  {
-    version: "0.14.0",
-    title: "Local Operations",
-    thesis: "Add local scan scheduling, scan result status, and operating metadata.",
-    includedIn: "0.12.0"
-  },
-  {
-    version: "0.15.0",
-    title: "Governance & Guardrails",
-    thesis: "Add scoped guardrails, thresholds, movement, and anomaly surfaces.",
-    includedIn: "0.12.0"
-  },
-  {
-    version: "0.16.0",
-    title: "Parser Studio",
-    thesis: "Let users preview local files and build import profiles without parser code.",
-    includedIn: "0.12.0"
-  },
-  {
-    version: "0.17.0",
-    title: "Reports",
-    thesis: "Turn local usage into reusable Markdown, JSON, and CSV operating artifacts.",
-    includedIn: "0.12.0"
-  },
-  {
-    version: "0.18.0",
-    title: "Agent Handoff",
-    thesis: "Expose roadmap, actions, evidence paths, and release gates in stable machine-readable JSON.",
-    includedIn: "0.12.0"
-  }
-];
-
 const cards: RoadmapCard[] = [
   {
     id: "TT-120-01",
@@ -242,13 +184,13 @@ const cards: RoadmapCard[] = [
   },
   {
     id: "TT-120-10",
-    title: "Agent-Readable Roadmap V2",
-    outcome: "Roadmap JSON becomes a live handoff for agents.",
+    title: "Agent-Readable Release Status",
+    outcome: "Roadmap JSON reports shipped release status for agents.",
     status: "implemented",
     details: [
-      "Roadmap status includes current release, next planned release, and rolled-up release themes.",
+      "Roadmap status includes the current release, implemented cards, action recipes, evidence paths, verification gates, and release status.",
       "Action recipes cover scan, evidence export, repair review, reports, Scan Health, and model-rate review.",
-      "Evidence paths and verification gates remain machine-readable."
+      "Unreleased planning details stay out of machine-readable public status."
     ],
     evidence: ["src/lib/roadmap-status.ts", "scripts/roadmap.ts", "tests/roadmap-status.test.ts"]
   }
@@ -307,13 +249,7 @@ export function buildRoadmapStatus(options: RoadmapStatusOptions = {}): RoadmapS
     codename: "Local Sources & Trust",
     packageVersion: options.packageVersion ?? "unknown",
     thesis:
-      "TokenTrace should import more local sources, make evidence portable, run local operations, enforce scoped guardrails, support parser setup, export reports, and hand agents a stable roadmap contract.",
-    next: {
-      version: "0.19.0",
-      title: "Team Operating Layer",
-      note: "After the rolled-up 0.12.0 release, the next roadmap can focus on team sharing, policy workflows, and deeper source-specific integrations."
-    },
-    rolledUpReleases,
+      "TokenTrace should import more local sources, explain evidence, run local scans, enforce scoped guardrails, support parser setup, export reports, and give agents a stable release-status contract.",
     cards,
     handoff: {
       schemaVersion: "tokentrace.roadmap.v2",