npm - tokentracker-cli - Versions diffs - 0.2.25 → 0.2.27 - Mend

tokentracker-cli 0.2.25 → 0.2.27

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/dashboard/dist/index.html CHANGED Viewed

@@ -107,7 +107,7 @@
         ]
       }
     </script>
-    <script type="module" crossorigin src="/assets/main-DepLUlUX.js"></script>
+    <script type="module" crossorigin src="/assets/main-oIbJf8pA.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/main-hwTpulbk.css">
   </head>
   <body>

package/dashboard/dist/share.html CHANGED Viewed

@@ -51,7 +51,7 @@
         "description": "Shareable Token Tracker dashboard snapshot."
       }
     </script>
-    <script type="module" crossorigin src="/assets/main-DepLUlUX.js"></script>
+    <script type="module" crossorigin src="/assets/main-oIbJf8pA.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/main-hwTpulbk.css">
   </head>
   <body>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "tokentracker-cli",
-  "version": "0.2.25",
+  "version": "0.2.27",
   "description": "Token usage tracker for AI agent CLIs (Codex, Claude Code, Gemini, OpenCode, OpenClaw)",
   "main": "src/cli.js",
   "bin": {

package/src/lib/local-api.js CHANGED Viewed

@@ -12,14 +12,7 @@ const TRACKER_BIN = path.resolve(__dirname, "../../bin/tracker.js");
 function resolveQueuePath() {
   const home = os.homedir();
-  const candidates = [
-    path.join(home, ".tokentracker", "tracker", "queue.jsonl"),
-    path.join(home, ".vibeusage", "tracker", "queue.jsonl"),
-  ];
-  for (const p of candidates) {
-    if (fs.existsSync(p)) return p;
-  }
-  return candidates[0];
+  return path.join(home, ".tokentracker", "tracker", "queue.jsonl");
 }
 function readQueueData(queuePath) {
@@ -46,6 +39,7 @@ function aggregateByDay(rows) {
         input_tokens: 0,
         output_tokens: 0,
         cached_input_tokens: 0,
+        cache_creation_input_tokens: 0,
         reasoning_output_tokens: 0,
         conversation_count: 0,
       });
@@ -56,6 +50,7 @@ function aggregateByDay(rows) {
     a.input_tokens += row.input_tokens || 0;
     a.output_tokens += row.output_tokens || 0;
     a.cached_input_tokens += row.cached_input_tokens || 0;
+    a.cache_creation_input_tokens += row.cache_creation_input_tokens || 0;
     a.reasoning_output_tokens += row.reasoning_output_tokens || 0;
     a.conversation_count += row.conversation_count || 0;
   }
@@ -261,11 +256,12 @@ function createLocalApiHandler({ queuePath }) {
           acc.input_tokens += r.input_tokens;
           acc.output_tokens += r.output_tokens;
           acc.cached_input_tokens += r.cached_input_tokens;
+          acc.cache_creation_input_tokens += r.cache_creation_input_tokens;
           acc.reasoning_output_tokens += r.reasoning_output_tokens;
           acc.conversation_count += r.conversation_count;
           return acc;
         },
-        { total_tokens: 0, billable_total_tokens: 0, input_tokens: 0, output_tokens: 0, cached_input_tokens: 0, reasoning_output_tokens: 0, conversation_count: 0 },
+        { total_tokens: 0, billable_total_tokens: 0, input_tokens: 0, output_tokens: 0, cached_input_tokens: 0, cache_creation_input_tokens: 0, reasoning_output_tokens: 0, conversation_count: 0 },
       );
       const totalCost = (totals.total_tokens * 1.75) / 1_000_000;
@@ -379,22 +375,24 @@ function createLocalApiHandler({ queuePath }) {
         const src = row.source || "unknown";
         const mdl = row.model || "unknown";
         if (!bySource.has(src))
-          bySource.set(src, { source: src, totals: { total_tokens: 0, billable_total_tokens: 0, input_tokens: 0, output_tokens: 0, cached_input_tokens: 0, reasoning_output_tokens: 0, total_cost_usd: "0" }, models: new Map() });
+          bySource.set(src, { source: src, totals: { total_tokens: 0, billable_total_tokens: 0, input_tokens: 0, output_tokens: 0, cached_input_tokens: 0, cache_creation_input_tokens: 0, reasoning_output_tokens: 0, total_cost_usd: "0" }, models: new Map() });
         const sa = bySource.get(src);
         sa.totals.total_tokens += row.total_tokens || 0;
         sa.totals.billable_total_tokens += row.total_tokens || 0;
         sa.totals.input_tokens += row.input_tokens || 0;
         sa.totals.output_tokens += row.output_tokens || 0;
         sa.totals.cached_input_tokens += row.cached_input_tokens || 0;
+        sa.totals.cache_creation_input_tokens += row.cache_creation_input_tokens || 0;
         sa.totals.reasoning_output_tokens += row.reasoning_output_tokens || 0;
         if (!sa.models.has(mdl))
-          sa.models.set(mdl, { model: mdl, model_id: mdl, totals: { total_tokens: 0, billable_total_tokens: 0, input_tokens: 0, output_tokens: 0, cached_input_tokens: 0, reasoning_output_tokens: 0, total_cost_usd: "0" } });
+          sa.models.set(mdl, { model: mdl, model_id: mdl, totals: { total_tokens: 0, billable_total_tokens: 0, input_tokens: 0, output_tokens: 0, cached_input_tokens: 0, cache_creation_input_tokens: 0, reasoning_output_tokens: 0, total_cost_usd: "0" } });
         const ma = sa.models.get(mdl);
         ma.totals.total_tokens += row.total_tokens || 0;
         ma.totals.billable_total_tokens += row.total_tokens || 0;
         ma.totals.input_tokens += row.input_tokens || 0;
         ma.totals.output_tokens += row.output_tokens || 0;
         ma.totals.cached_input_tokens += row.cached_input_tokens || 0;
+        ma.totals.cache_creation_input_tokens += row.cache_creation_input_tokens || 0;
         ma.totals.reasoning_output_tokens += row.reasoning_output_tokens || 0;
       }
@@ -471,6 +469,7 @@ function createLocalApiHandler({ queuePath }) {
         input_tokens: r.input_tokens || 0,
         output_tokens: r.output_tokens || 0,
         cached_input_tokens: r.cached_input_tokens || 0,
+        cache_creation_input_tokens: r.cache_creation_input_tokens || 0,
         reasoning_output_tokens: r.reasoning_output_tokens || 0,
         conversation_count: r.conversation_count || 0,
       }));
@@ -490,13 +489,14 @@ function createLocalApiHandler({ queuePath }) {
         if (day < from || day > to) continue;
         const month = day.slice(0, 7);
         if (!byMonth.has(month))
-          byMonth.set(month, { month, total_tokens: 0, billable_total_tokens: 0, input_tokens: 0, output_tokens: 0, cached_input_tokens: 0, reasoning_output_tokens: 0, conversation_count: 0 });
+          byMonth.set(month, { month, total_tokens: 0, billable_total_tokens: 0, input_tokens: 0, output_tokens: 0, cached_input_tokens: 0, cache_creation_input_tokens: 0, reasoning_output_tokens: 0, conversation_count: 0 });
         const a = byMonth.get(month);
         a.total_tokens += row.total_tokens || 0;
         a.billable_total_tokens += row.total_tokens || 0;
         a.input_tokens += row.input_tokens || 0;
         a.output_tokens += row.output_tokens || 0;
         a.cached_input_tokens += row.cached_input_tokens || 0;
+        a.cache_creation_input_tokens += row.cache_creation_input_tokens || 0;
         a.reasoning_output_tokens += row.reasoning_output_tokens || 0;
         a.conversation_count += row.conversation_count || 0;
       }

package/src/lib/rollout.js CHANGED Viewed

@@ -206,6 +206,7 @@ async function parseClaudeIncremental({
   const projectMetaCache = projectEnabled ? new Map() : null;
   const publicRepoCache = projectEnabled ? new Map() : null;
   const touchedBuckets = new Set();
+  const seenMessageHashes = new Set();
   const defaultSource = normalizeSourceInput(source) || "claude";
   if (!cursors.files || typeof cursors.files !== "object") {
@@ -250,6 +251,7 @@ async function parseClaudeIncremental({
       projectTouchedBuckets,
       projectRef,
       projectKey,
+      seenMessageHashes,
     });
     cursors.files[key] = {
@@ -822,6 +824,7 @@ async function parseClaudeFile({
   projectTouchedBuckets,
   projectRef,
   projectKey,
+  seenMessageHashes,
 }) {
   const st = await fs.stat(filePath).catch(() => null);
   if (!st || !st.isFile()) return { endOffset: startOffset, eventsAggregated: 0 };
@@ -845,6 +848,16 @@ async function parseClaudeFile({
     const usage = obj?.message?.usage || obj?.usage;
     if (!usage || typeof usage !== "object") continue;
+    if (seenMessageHashes) {
+      const msgId = obj?.message?.id;
+      const reqId = obj?.requestId;
+      if (msgId && reqId) {
+        const hash = `${msgId}:${reqId}`;
+        if (seenMessageHashes.has(hash)) continue;
+        seenMessageHashes.add(hash);
+      }
+    }
     const model = normalizeModelInput(obj?.message?.model || obj?.model) || DEFAULT_MODEL;
     const tokenTimestamp = typeof obj?.timestamp === "string" ? obj.timestamp : null;
     if (!tokenTimestamp) continue;
@@ -1180,6 +1193,7 @@ async function enqueueTouchedBuckets({ queuePath, hourlyState, touchedBuckets })
             hour_start: group.hourStart,
             input_tokens: zeroTotals.input_tokens,
             cached_input_tokens: zeroTotals.cached_input_tokens,
+            cache_creation_input_tokens: zeroTotals.cache_creation_input_tokens,
             output_tokens: zeroTotals.output_tokens,
             reasoning_output_tokens: zeroTotals.reasoning_output_tokens,
             total_tokens: zeroTotals.total_tokens,
@@ -1227,6 +1241,7 @@ async function enqueueTouchedBuckets({ queuePath, hourlyState, touchedBuckets })
             hour_start: group.hourStart,
             input_tokens: totals.input_tokens,
             cached_input_tokens: totals.cached_input_tokens,
+            cache_creation_input_tokens: totals.cache_creation_input_tokens,
             output_tokens: totals.output_tokens,
             reasoning_output_tokens: totals.reasoning_output_tokens,
             total_tokens: totals.total_tokens,
@@ -1274,6 +1289,7 @@ async function enqueueTouchedBuckets({ queuePath, hourlyState, touchedBuckets })
             hour_start: group.hourStart,
             input_tokens: zeroTotals.input_tokens,
             cached_input_tokens: zeroTotals.cached_input_tokens,
+            cache_creation_input_tokens: zeroTotals.cache_creation_input_tokens,
             output_tokens: zeroTotals.output_tokens,
             reasoning_output_tokens: zeroTotals.reasoning_output_tokens,
             total_tokens: zeroTotals.total_tokens,
@@ -1294,6 +1310,7 @@ async function enqueueTouchedBuckets({ queuePath, hourlyState, touchedBuckets })
         hour_start: group.hourStart,
         input_tokens: unknownBucket.totals.input_tokens,
         cached_input_tokens: unknownBucket.totals.cached_input_tokens,
+        cache_creation_input_tokens: unknownBucket.totals.cache_creation_input_tokens,
         output_tokens: unknownBucket.totals.output_tokens,
         reasoning_output_tokens: unknownBucket.totals.reasoning_output_tokens,
         total_tokens: unknownBucket.totals.total_tokens,
@@ -1339,6 +1356,7 @@ async function enqueueTouchedBuckets({ queuePath, hourlyState, touchedBuckets })
           hour_start: group.hourStart,
           input_tokens: group.totals.input_tokens,
           cached_input_tokens: group.totals.cached_input_tokens,
+          cache_creation_input_tokens: group.totals.cache_creation_input_tokens,
           output_tokens: group.totals.output_tokens,
           reasoning_output_tokens: group.totals.reasoning_output_tokens,
           total_tokens: group.totals.total_tokens,
@@ -1392,6 +1410,7 @@ async function enqueueTouchedProjectBuckets({
         hour_start: bucket.hour_start,
         input_tokens: totals.input_tokens,
         cached_input_tokens: totals.cached_input_tokens,
+        cache_creation_input_tokens: totals.cache_creation_input_tokens,
         output_tokens: totals.output_tokens,
         reasoning_output_tokens: totals.reasoning_output_tokens,
         total_tokens: totals.total_tokens,
@@ -1646,6 +1665,7 @@ function initTotals() {
   return {
     input_tokens: 0,
     cached_input_tokens: 0,
+    cache_creation_input_tokens: 0,
     output_tokens: 0,
     reasoning_output_tokens: 0,
     total_tokens: 0,
@@ -1656,6 +1676,7 @@ function initTotals() {
 function addTotals(target, delta) {
   target.input_tokens += delta.input_tokens || 0;
   target.cached_input_tokens += delta.cached_input_tokens || 0;
+  target.cache_creation_input_tokens += delta.cache_creation_input_tokens || 0;
   target.output_tokens += delta.output_tokens || 0;
   target.reasoning_output_tokens += delta.reasoning_output_tokens || 0;
   target.total_tokens += delta.total_tokens || 0;
@@ -1666,6 +1687,7 @@ function totalsKey(totals) {
   return [
     totals.input_tokens || 0,
     totals.cached_input_tokens || 0,
+    totals.cache_creation_input_tokens || 0,
     totals.output_tokens || 0,
     totals.reasoning_output_tokens || 0,
     totals.total_tokens || 0,
@@ -1998,6 +2020,7 @@ function normalizeGeminiTokens(tokens) {
   return {
     input_tokens: input,
     cached_input_tokens: cached,
+    cache_creation_input_tokens: 0,
     output_tokens: output + tool,
     reasoning_output_tokens: thoughts,
     total_tokens: total,
@@ -2011,12 +2034,12 @@ function normalizeOpencodeTokens(tokens) {
   const reasoning = toNonNegativeInt(tokens.reasoning);
   const cached = toNonNegativeInt(tokens.cache?.read);
   const cacheWrite = toNonNegativeInt(tokens.cache?.write);
-  // cache tokens (read/write) excluded from input_tokens and total_tokens
-  const total = input + output + reasoning;
+  const total = input + output + reasoning + cached + cacheWrite;
   return {
     input_tokens: input,
     cached_input_tokens: cached,
+    cache_creation_input_tokens: cacheWrite,
     output_tokens: output,
     reasoning_output_tokens: reasoning,
     total_tokens: total,
@@ -2122,6 +2145,7 @@ function normalizeUsage(u) {
   for (const k of [
     "input_tokens",
     "cached_input_tokens",
+    "cache_creation_input_tokens",
     "output_tokens",
     "reasoning_output_tokens",
     "total_tokens",
@@ -2135,13 +2159,13 @@ function normalizeUsage(u) {
 function normalizeClaudeUsage(u) {
   const inputTokens = toNonNegativeInt(u?.input_tokens);
   const outputTokens = toNonNegativeInt(u?.output_tokens);
-  const hasTotal = u && Object.prototype.hasOwnProperty.call(u, "total_tokens");
-  const totalTokens = hasTotal
-    ? toNonNegativeInt(u?.total_tokens)
-    : inputTokens + outputTokens;
+  const cacheCreation = toNonNegativeInt(u?.cache_creation_input_tokens);
+  const cacheRead = toNonNegativeInt(u?.cache_read_input_tokens);
+  const totalTokens = inputTokens + outputTokens + cacheCreation + cacheRead;
   return {
     input_tokens: inputTokens,
-    cached_input_tokens: toNonNegativeInt(u?.cache_read_input_tokens),
+    cached_input_tokens: cacheRead,
+    cache_creation_input_tokens: cacheCreation,
     output_tokens: outputTokens,
     reasoning_output_tokens: 0,
     total_tokens: totalTokens,
@@ -2157,6 +2181,7 @@ function isAllZeroUsage(u) {
   for (const k of [
     "input_tokens",
     "cached_input_tokens",
+    "cache_creation_input_tokens",
     "output_tokens",
     "reasoning_output_tokens",
     "total_tokens",
@@ -2170,6 +2195,7 @@ function sameUsage(a, b) {
   for (const k of [
     "input_tokens",
     "cached_input_tokens",
+    "cache_creation_input_tokens",
     "output_tokens",
     "reasoning_output_tokens",
     "total_tokens",

package/README.old.md DELETED Viewed

@@ -1,324 +0,0 @@
-<div align="center">
-<img src="dashboard/public/icon-192.png" width="96" alt="VibeUsage Icon" />
-# 🟢 VIBEUSAGE
-**QUANTIFY YOUR AI OUTPUT**
-_Real-time AI Analytics for Codex CLI_
-[**www.vibeusage.cc**](https://www.vibeusage.cc)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
-[![Node.js Support](https://img.shields.io/badge/Node.js-%3E%3D18-brightgreen.svg)](https://nodejs.org/)
-[![Platform](https://img.shields.io/badge/Platform-macOS-lightgrey.svg)](https://www.apple.com/macos/)
-[**English**](README.md) • [**中文说明**](README.zh-CN.md)
-[**Documentation**](docs/) • [**Dashboard**](dashboard/) • [**Backend API**](BACKEND_API.md)
-<br/>
-<img src="docs/screenshots/dashboard.png" width="900" alt="VibeUsage Dashboard Preview"/>
-</div>
----
-## 🌌 Overview
-**VibeUsage** is an intelligent token usage tracking system designed specifically for macOS developers. Through the all-new **Matrix-A Design System**, it provides a high-fidelity cyberpunk-style dashboard that transforms your **AI Output** into quantifiable metrics, supported by the **Neural Divergence Map** for real-time monitoring of multi-model compute distribution.
-> [!TIP] > **Core Index**: Our signature metric that reflects your flow state by analyzing token consumption rates and patterns.
-## 🔒 Privacy-First Architecture (Stealth Protocol)
-We believe your code and thoughts are your own. VibeUsage is built with strict privacy pillars to ensure your data never leaves your control.
-- 🛡️ **No Content Upload**: We never upload prompts or responses. We only compute token counts locally and send counts plus minimal metadata (timestamps, model, device).
-- 📡 **Local Aggregation**: All token consumption analysis happens on your machine. We only relay quantized 30-minute usage buckets to the cloud.
-- 🔐 **Hashed Identity**: Device tokens are hashed using SHA-256 server-side. Your raw credentials never exist in our database.
-- 🔦 **Full Transparency**: Audit the sync logic yourself in `src/lib/rollout.js`. We literally only capture numbers and timestamps.
-## 🚀 Key Features
-- 📡 **Auto-Sync**: Real-time interception of AI CLI pipes with **automatic background synchronization**. Once initialized, your tokens are tracked and synced without any manual commands.
-- 🧭 **Universal-Sync**: Native support for multiple AI CLI tools:
-  - **Codex CLI** - OpenAI's official CLI
-  - **Every Code** - Community Codex alternative
-  - **Gemini CLI** - Google's AI CLI
-  - **Opencode** - AI coding assistant
-  - **Claude Code** - Anthropic's official CLI
-  - Whether it's GPT-4, Claude 3.5 Sonnet, or o1/Gemini, token consumption from all models is unified and counted.
-- 📊 **Matrix Dashboard**: High-performance dashboard built with React + Vite, featuring the new **Matrix-A** design language.
-  - **Neural Divergence Map**: Visualize multi-engine load balancing and compute distribution.
-  - **Cost Intelligence**: Real-time, multi-dimensional cost breakdown and forecasting.
-  - **Activity Heatmap**: GitHub-style contribution graph with streak tracking.
-  - **Smart Notifications**: Non-intrusive system-level alerts using a Golden (Gold/Amber) visual style for high-value information.
-- ⚡ **AI Analytics**: Deep analysis of Input/Output tokens, with dedicated tracking for Cached and Reasoning components.
-- 📈 **Leaderboard**: Daily, weekly, monthly, and all-time rankings with privacy-safe display names.
-- 🌐 **Public View**: Share your AI usage journey with a privacy-safe public profile.
-- 📁 **Project Stats**: Track token usage by project/repository across all time.
-- 🔒 **Identity Core**: Robust authentication and permission management to secure your development data.
-### 🌌 Visual Preview
-<img src="docs/screenshots/landing.png" width="900" alt="VibeUsage Landing Preview"/>
-## 🛠️ Quick Start
-### Installation
-Initialize your environment once and forget it. VibeUsage handles all synchronization in the background automatically.
-```bash
-npx --yes vibeusage init
-```
-**Authentication Methods:**
-1. **Browser Auth** (default) - Opens browser for secure authentication
-2. **Link Code** - Use `--link-code` to authenticate via dashboard-generated code
-3. **Password** - Direct password authentication (fallback)
-4. **Access Token** - For CI/automated environments
-**CLI Options:**
-- `--yes` - Skip consent prompts in non-interactive environments
-- `--dry-run` - Preview changes without writing files
-- `--link-code <code>` - Authenticate using a link code from dashboard
-- `--base-url <url>` - Override the default API endpoint
-**Supported CLI Tools Auto-Configuration:**
-| Tool | Config Location | Method |
-|------|----------------|--------|
-| Codex CLI | `~/.codex/config.toml` | `notify` hook |
-| Every Code | `~/.code/config.toml` (or `CODE_HOME`) | `notify` hook |
-| Gemini CLI | `~/.gemini/settings.json` (or `GEMINI_HOME`) | `SessionEnd` hook |
-| Opencode | Global plugins | Message parser plugin |
-| Claude Code | `~/.claude/hooks/` | Hook configuration |
-Once `init` completes, all supported CLI tools are automatically configured for data sync. No further intervention required.
-### Sync & Status
-While sync happens automatically, you can manually trigger a synchronization or check status anytime:
-```bash
-# Manually sync latest local session data (Optional)
-npx --yes vibeusage sync
-# Check current link status
-npx --yes vibeusage status
-```
-### Doctor
-```bash
-# Run health checks
-npx --yes vibeusage doctor
-# Emit JSON report (and write to file)
-npx --yes vibeusage doctor --json --out doctor.json
-# Override base URL (diagnostics only)
-npx --yes vibeusage doctor --base-url https://example.invalid
-```
-### Uninstall
-```bash
-# Standard uninstall (keeps data)
-npx --yes vibeusage uninstall
-# Full purge - removes all data including config and cached sessions
-npx --yes vibeusage uninstall --purge
-```
-### Log Sources
-| Tool | Log Location | Override Env |
-|------|-------------|--------------|
-| Codex CLI | `~/.codex/sessions/**/rollout-*.jsonl` | `CODEX_HOME` |
-| Every Code | `~/.code/sessions/**/rollout-*.jsonl` | `CODE_HOME` |
-| Gemini CLI | `~/.gemini/tmp/**/chats/session-*.json` | `GEMINI_HOME` |
-| Opencode | `~/.opencode/messages/*.json` | - |
-| Claude Code | Parsed from hook output | - |
-## 🔧 Environment Variables
-### Core Settings
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `VIBEUSAGE_HTTP_TIMEOUT_MS` | CLI HTTP timeout in ms (`0` disables, clamped `1000..120000`) | `20000` |
-| `VITE_VIBEUSAGE_HTTP_TIMEOUT_MS` | Dashboard request timeout in ms (`0` disables, clamped `1000..30000`) | `15000` |
-| `VIBEUSAGE_DEBUG` | Enable debug output (`1` or `true` to enable) | - |
-| `VIBEUSAGE_DASHBOARD_URL` | Custom dashboard URL | `https://www.vibeusage.cc` |
-| `VIBEUSAGE_INSFORGE_BASE_URL` | Custom API base URL | `https://5tmappuk.us-east.insforge.app` |
-| `VIBEUSAGE_DEVICE_TOKEN` | Pre-configured device token (for CI) | - |
-### CLI Tool Overrides
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `CODEX_HOME` | Codex CLI directory override | `~/.codex` |
-| `CODE_HOME` | Every Code directory override | `~/.code` |
-| `GEMINI_HOME` | Gemini CLI directory override | `~/.gemini` |
-### Deprecated
-- `VIBEUSAGE_ROLLUP_ENABLED`: Currently ignored; rollup aggregation is disabled pending table deployment.
-## 🧰 Troubleshooting
-### Debug Mode
-Enable debug output to see detailed request/response information:
-```bash
-VIBEUSAGE_DEBUG=1 npx --yes vibeusage sync
-# or
-npx --yes vibeusage sync --debug
-```
-### Health Check
-Run the built-in doctor command to diagnose issues:
-```bash
-# Basic health check
-npx --yes vibeusage doctor
-# JSON output for debugging
-npx --yes vibeusage doctor --json --out doctor.json
-# Test against a different endpoint
-npx --yes vibeusage doctor --base-url https://your-instance.insforge.app
-```
-### Streak shows 0 days while totals look correct
-- Streak is defined as consecutive days ending today. If today's total is 0, streak will be 0.
-- If you expect a non-zero streak, clear cached auth/heatmap data and sign in again:
-```js
-localStorage.removeItem("vibeusage.dashboard.auth.v1");
-Object.keys(localStorage)
-  .filter((k) => k.startsWith("vibeusage.heatmap."))
-  .forEach((k) => localStorage.removeItem(k));
-location.reload();
-```
-- Complete the landing page sign-in flow again after reload.
-- Note: `insforge-auth-token` is not used by the dashboard; use `vibeusage.dashboard.auth.v1`.
-### Sync Issues
-If data isn't appearing in the dashboard:
-1. Check status: `npx --yes vibeusage status`
-2. Force manual sync: `npx --yes vibeusage sync`
-3. Verify CLI tool hooks are configured (re-run `init` if needed)
-4. Check debug output: `VIBEUSAGE_DEBUG=1 npx vibeusage sync`
-### Timeout Errors
-Increase HTTP timeout for slow connections:
-```bash
-VIBEUSAGE_HTTP_TIMEOUT_MS=60000 npx --yes vibeusage sync
-```
-## 🏗️ Architecture
-```mermaid
-graph TD
-    A[Codex CLI] -->|Rollout Logs| F(Tracker CLI)
-    B[Every Code] -->|Rollout Logs| F
-    C[Gemini CLI] -->|Session Logs| F
-    D[Opencode] -->|Message Logs| F
-    E[Claude Code] -->|Hook Output| F
-    F -->|AI Tokens| G{Core Relay}
-    G --> H[VibeUsage Dashboard]
-    G --> I[AI Analytics Engine]
-    G --> J[Leaderboard Service]
-    G --> K[Public View API]
-```
-### Components
-- **Tracker CLI** (`src/`): Node.js CLI that parses logs from multiple AI tools and syncs token data
-- **Core Relay** (InsForge Edge Functions): Serverless backend handling ingestion, aggregation, and API
-- **Dashboard** (`dashboard/`): React + Vite frontend for visualization
-- **AI Analytics Engine**: Cost calculation, model breakdown, and usage forecasting
-## 💻 Developer Guide
-To run locally or contribute:
-### Dashboard Development
-```bash
-# Install dependencies
-cd dashboard
-npm install
-# Start dev server
-npm run dev
-```
-### Debug Payload (Usage Endpoints)
-When `debug=1` is included in a usage endpoint request, the response adds a `debug` object that helps the dashboard attribute slow queries without relying on response headers.
-```ts
-const res = await fetch(
-  `${baseUrl}/functions/vibeusage-usage-summary?from=2025-12-30&to=2025-12-30&debug=1`,
-  {
-    headers: { Authorization: `Bearer ${userJwt}` }
-  }
-);
-const data = await res.json();
-if (data.debug) {
-  console.debug('usage debug', {
-    requestId: data.debug.request_id,
-    status: data.debug.status,
-    queryMs: data.debug.query_ms,
-    slowThresholdMs: data.debug.slow_threshold_ms,
-    slowQuery: data.debug.slow_query
-  });
-}
-```
-### Architecture Validation
-```bash
-# Validate Copy Registry
-npm run validate:copy
-# Run smoke tests
-npm run smoke
-```
-### Architecture Canvas Focus
-```bash
-# Generate a focused canvas for a top-level module
-node scripts/ops/architecture-canvas.cjs --focus src
-# Alias: --module
-node scripts/ops/architecture-canvas.cjs --module dashboard
-```
-## 📜 License
-This project is licensed under the [MIT License](LICENSE).
----
-<div align="center">
-  <b>System_Ready // 2024 VibeUsage OS</b><br/>
-  <i>"More Tokens. More Vibe."</i>
-</div>