ai-burnrate-tool 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,208 @@
-# Temporary Holding Version
+<div align="center">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# 🔥 ai-burnrate ⚡
+
+**Real-Time Local Token & Equivalent API Cost Tracker for Antigravity CLI & Claude Code**
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-10b981.svg?style=flat-square)](https://github.com/Cise07/ai-burnrate-tool)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-06b6d4.svg?style=flat-square)](https://nodejs.org/)
+[![GitHub Repo](https://img.shields.io/badge/GitHub-Cise07%2Fai--burnrate--tool-d946ef.svg?style=flat-square)](https://github.com/Cise07/ai-burnrate-tool)
+[![100% Local](https://img.shields.io/badge/Privacy-100%25%20Local-f59e0b.svg?style=flat-square)](#)
+
+Track in real time how many tokens you are consuming across **Antigravity CLI** (`~/.gemini`) and **Claude Code** (`~/.claude`), what your equivalent pay-as-you-go API spend would be in **USD (`$`) or EUR (`€`)**, and how much money you are saving through Prompt Caching and your monthly subscriptions.
+
+</div>
+
+---
+
+## ✨ Key Features
+
+- 🔒 **100% Local, Dynamic & Cross-Platform:** Automatically resolves your user home directory (`os.homedir()` → `~/.gemini` and `~/.claude`) on Windows, macOS, and Linux with zero hardcoded paths. You can also override watched folders via `BURNRATE_GEMINI_DIR` and `BURNRATE_CLAUDE_DIR`.
+- 🟢 **Live Dashboard & Server-Sent Events (SSE):** A background file watcher (`chokidar`) monitors your active AI transcripts and pushes instant real-time updates to charts, KPIs, and session tables in the browser via `/api/events`.
+- 🔄 **Automatic Official Price Sync & Historical Tariff Protection:** On startup (and on manual rescan), `ai-burnrate` automatically fetches the latest official per-token model prices from the public **LiteLLM Pricing Registry** and the official repository feed. Whenever a model's price changes, a new timestamped rate snapshot (`effectiveFrom`) is appended to `~/.burnrate/pricing-ledger.json`—**tokens consumed before the price change are never recalculated**, and the new tariff applies strictly to turns recorded after the change.
+- 💱 **Instant `$ USD` / `€ EUR` Currency Switch:** Toggle the entire dashboard (KPI cards, monthly subscription comparison, charts, and live session table) between US Dollars and Euros with persistent `localStorage` state.
+- 🧠 **Granular Per-Model Token Breakdown:** Dedicated central widget and ANSI CLI tables breaking down *Input (Uncached)*, *Cache Read (Context)*, and *Output (Thinking + Response/Code)* with automatic streaming chunk deduplication.
+- 🖥️ **Instant Terminal Mode (`--cli`):** Prints colorized ANSI tables (Tool Breakdown, Model Breakdown, and Top 12 Recent Sessions) directly in your terminal and exits immediately.
+
+---
+
+## 🚀 Quick Install (Latest Version)
+
+You don't need to manually download or clone the repository—simply paste **one command** into your terminal from any directory. The installer automatically resolves the latest GitHub Release (falling back to `main` if none exist yet).
+
+> ⚠️ **Prerequisite:** Make sure you have [Node.js (>= 18)](https://nodejs.org/) and `npm` installed.
+
+### 🪟 Windows (PowerShell)
+Open PowerShell and run:
+```powershell
+irm https://raw.githubusercontent.com/Cise07/ai-burnrate-tool/main/scripts/install.ps1 | iex
+```
+> 💡 **Note on Windows permissions:** If PowerShell blocks the script with an `ExecutionPolicy` or permission error, enable script execution for your user by running:
+> ```powershell
+> Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
+> ```
+
+### 🍎 macOS / 🐧 Linux (Bash / Zsh)
+Open your terminal and run:
+```bash
+curl -fsSL https://raw.githubusercontent.com/Cise07/ai-burnrate-tool/main/scripts/install.sh | bash
+```
+
+### 📦 Universal Alternative via `npm` (Cross-Platform)
+```bash
+npm install -g https://github.com/Cise07/ai-burnrate-tool/archive/main.tar.gz
+```
+
+*(Want to run it once without installing? Use `npx https://github.com/Cise07/ai-burnrate-tool/archive/main.tar.gz`)*
+
+### 🏷️ Install a Specific Release Version
+To pin a specific release tag (e.g., `v1.0.1`), use the release tarball directly or pass `BURNRATE_VERSION` to the installer:
+
+```bash
+# Universal (recommended for GitHub Release notes)
+npm install -g https://github.com/Cise07/ai-burnrate-tool/archive/refs/tags/vX.Y.Z.tar.gz
+```
+
+```powershell
+# Windows PowerShell
+$env:BURNRATE_VERSION="vX.Y.Z"; irm https://raw.githubusercontent.com/Cise07/ai-burnrate-tool/main/scripts/install.ps1 | iex
+```
+
+```bash
+# macOS / Linux
+BURNRATE_VERSION=vX.Y.Z curl -fsSL https://raw.githubusercontent.com/Cise07/ai-burnrate-tool/main/scripts/install.sh | bash
+```
+
+---
+
+## 🛠️ Install from Local Clone (For Developers)
+
+If you clone the repository locally, the installer script automatically detects `package.json`, installs dependencies, compiles both the React frontend (`dist/public`) and CLI (`dist/cli`), and registers the global `burnrate` binary:
+
+```bash
+# 1. Clone the repository
+git clone https://github.com/Cise07/ai-burnrate-tool.git
+cd ai-burnrate-tool
+
+# 2. Build and install globally
+.\scripts\install.ps1   # Windows PowerShell
+./scripts/install.sh    # macOS / Linux
+# Or via npm script:
+npm run setup
+```
+
+---
+
+## 🎮 Usage & CLI Flags
+
+Once installed, the **`burnrate`** (or **`ai-burnrate`**) command is available globally from **any folder** in your terminal:
+
+| Command | Description |
+| :--- | :--- |
+| `burnrate` | 🟢 **Live Mode (Default):** Syncs official pricing, starts the local HTTP + SSE server, watches `~/.gemini` & `~/.claude`, and opens the React Dashboard in your browser. |
+| `burnrate --cli` | 📊 **Terminal Mode:** Syncs pricing, prints the full token & cost report in colorized ANSI tables in the terminal, and exits immediately. |
+| `burnrate --no-open` | 🔇 **Headless Mode:** Starts the live server and file watcher without automatically opening the browser. |
+| `burnrate -p, --port <number>` | 🔌 **Custom Port:** Starts the dashboard on a specific port (default: `4321`, automatically falling back to the next free port if busy). |
+| `burnrate --update` | 🔄 **Self-Update:** Updates `ai-burnrate` to the latest release directly from GitHub. |
+| `burnrate --uninstall` | 🗑️ **Self-Uninstall:** Completely removes the global `burnrate` package from your system. |
+| `burnrate -V, --version` | 🏷️ Prints the installed version (`1.0.0`). |
+| `burnrate -h, --help` | ℹ️ Displays all available CLI options. |
+
+> 💡 **Clean Shutdown:** While running in live mode (`burnrate`), press `Ctrl+C` (`SIGINT`) to cleanly close all SSE streams, active HTTP sockets, and the `chokidar` file watcher.
+
+---
+
+## 🗑️ How to Uninstall `ai-burnrate`
+
+You can remove the tool at any time using any of the following methods:
+
+### 1️⃣ Built-in CLI Flag (Recommended)
+From any directory in your terminal, simply run:
+```bash
+burnrate --uninstall
+```
+
+### 2️⃣ Via `npm`
+```bash
+npm uninstall -g ai-burnrate-tool
+```
+
+### 3️⃣ Via One-Liner Script
+- **Windows (PowerShell):**
+  ```powershell
+  irm https://raw.githubusercontent.com/Cise07/ai-burnrate-tool/main/scripts/uninstall.ps1 | iex
+  ```
+- **macOS / Linux:**
+  ```bash
+  curl -fsSL https://raw.githubusercontent.com/Cise07/ai-burnrate-tool/main/scripts/uninstall.sh | bash
+  ```
+
+---
+
+## 💰 How Pricing & Historical Rate Versioning Work
+
+`ai-burnrate` uses a time-versioned pricing engine (`src/core/pricing.ts`) so that price updates from AI providers never distort your past spending history:
+
+1. **Initial Seed (`config/pricing.json`):** Provides the initial baseline rates (effective from `1970-01-01T00:00:00.000Z`) and offline fallback for **Claude** (*Opus 4.x, Sonnet 4.x, 3.7 Sonnet, 3.5 Sonnet, Haiku*) and **Google Gemini** (*Gemini 4 Argon, Gemini Pro, Gemini 3.8 Flash High, Gemini Flash, Flash-Lite*).
+2. **Automatic Live Sync (`syncOfficialPricing`):** At launch and whenever you click the **Rescan** button in the UI, `ai-burnrate` queries the official **LiteLLM Model Pricing Registry** and the GitHub repository feed (with a 3.5s non-blocking timeout for offline resilience).
+3. **Immutable Historical Ledger (`~/.burnrate/pricing-ledger.json`):**
+   - When the sync detects that a provider has changed a model's `input`, `output`, `cacheRead`, or `cacheWrite` rate, it **does not overwrite** previous rates.
+   - Instead, it appends a new `RateSnapshot` to the `history` array in `~/.burnrate/pricing-ledger.json` stamped with `effectiveFrom: <current ISO timestamp>`.
+4. **Per-Turn Timestamp Matching (`getHistoricalRate`):**
+   - Every turn parsed from `~/.gemini` and `~/.claude` has its own `timestamp`.
+   - `calculateTurnCost` matches each turn's timestamp against `pricing.history` (`snapshot.effectiveFrom <= turn.timestamp`).
+   - All tokens used **before** a price change remain permanently valued at the old rate, while tokens used **after** the price change are valued at the new rate.
+
+---
+
+## 📊 Dashboard Overview
+
+- **🔝 Non-Wrapping Top Bar:** Displays the pulsing `LIVE` SSE connection badge, tool filter (`All`, `Antigravity`, `Claude`), time window selector (`24h`, `7d`, `30d`, `all`), `$ USD` / `€ EUR` currency switch, and manual rescan button.
+- **💸 4 Top KPI Cards:**
+  1. **API Equivalent Spend:** Total spend with per-tool split (`AGY` vs `Claude`) and ROI multiplier against monthly subscription plans.
+  2. **Total Tokens:** Cumulative tokens processed across all LLM turns, split into `Input`, `Output`, and `Cached`.
+  3. **Cache Savings:** Total money saved via context caching and overall *Cache Hit Ratio* percentage.
+  4. **Sessions & Projects:** Active sessions count, distinct workspaces count, and average cost per session.
+- **📈 Interactive Charts & Model Token Widget:**
+  - **Daily API Burn Rate:** Stacked area chart comparing Antigravity CLI and Claude Code spend over time.
+  - **Cost by Model:** Horizontal bar chart ranking spend by model.
+  - **Total Token Usage by Model:** Central grid showing total tokens, percentage share, and `Input / Cached / Output` breakdown for every model.
+- **🗂️ Live Sessions & Workspaces Table:** Real-time searchable table displaying tool badge, relative workspace path (`~/...`), primary model, turns, input/output tokens, cache read tokens, cache savings, API cost, and relative last-active time.
+
+---
+
+## 📁 Project Structure
+
+```text
+ai-burnrate/
+├── config/
+│   └── pricing.json        # Initial baseline model rates & subscription references
+├── scripts/
+│   ├── install.ps1         # Windows remote one-liner & local installer
+│   ├── uninstall.ps1       # Windows one-liner uninstaller
+│   ├── install.sh          # macOS/Linux remote one-liner & local installer
+│   └── uninstall.sh        # macOS/Linux one-liner uninstaller
+├── src/
+│   ├── cli/
+│   │   ├── index.ts        # CLI entrypoint (#!/usr/bin/env node)
+│   │   └── reporter.ts     # ANSI terminal table formatter (--cli)
+│   ├── core/
+│   │   ├── parser.ts       # Dynamic ~/.gemini & ~/.claude JSONL parser
+│   │   ├── pricing.ts      # Official price auto-sync & historical rate ledger
+│   │   ├── watcher.ts      # Real-time file watcher with chokidar
+│   │   └── types.ts        # Shared TypeScript interfaces
+│   ├── server/
+│   │   └── index.ts        # Local HTTP server + SSE stream (/api/events)
+│   └── web/
+│       ├── App.tsx         # Dark Mode React Dashboard + USD/EUR toggle
+│       ├── main.tsx        # React entrypoint
+│       └── index.css       # Tailwind CSS styles
+├── dist/                   # Prebuilt bundle (CLI + static web assets)
+└── package.json
+```
+
+---
+
+## 📄 License
+
+Distributed under the **MIT** License by [Cise07](https://github.com/Cise07). Feel free to open Issues or Pull Requests! ❤️

package/config/pricing.json

@@ -0,0 +1,247 @@
+{
+  "updatedAt": "2026-11-13",
+  "currency": "USD",
+  "unit": "per_1m_tokens",
+  "subscriptions": {
+    "claude_max": {
+      "name": "Claude Pro / Max",
+      "monthlyUSD": 20.0
+    },
+    "antigravity_pro": {
+      "name": "Google AI Ultra / Pro",
+      "monthlyUSD": 20.0
+    },
+    "combinedMonthlyUSD": 40.0
+  },
+  "models": {
+    "claude-3-7-sonnet": {
+      "label": "Claude 3.7 Sonnet",
+      "provider": "anthropic",
+      "input": 3.0,
+      "output": 15.0,
+      "cacheRead": 0.3,
+      "cacheWrite": 3.75
+    },
+    "claude-sonnet-4": {
+      "label": "Claude Sonnet 4.x",
+      "provider": "anthropic",
+      "input": 3.0,
+      "output": 15.0,
+      "cacheRead": 0.3,
+      "cacheWrite": 3.75
+    },
+    "claude-3-5-sonnet": {
+      "label": "Claude 3.5 Sonnet",
+      "provider": "anthropic",
+      "input": 3.0,
+      "output": 15.0,
+      "cacheRead": 0.3,
+      "cacheWrite": 3.75
+    },
+    "claude-opus-4": {
+      "label": "Claude Opus 4.x",
+      "provider": "anthropic",
+      "input": 15.0,
+      "output": 75.0,
+      "cacheRead": 1.5,
+      "cacheWrite": 18.75
+    },
+    "claude-3-opus": {
+      "label": "Claude 3 Opus",
+      "provider": "anthropic",
+      "input": 15.0,
+      "output": 75.0,
+      "cacheRead": 1.5,
+      "cacheWrite": 18.75
+    },
+    "claude-3-5-haiku": {
+      "label": "Claude 3.5 Haiku",
+      "provider": "anthropic",
+      "input": 0.8,
+      "output": 4.0,
+      "cacheRead": 0.08,
+      "cacheWrite": 1.0
+    },
+    "claude-haiku-4": {
+      "label": "Claude Haiku 4.x",
+      "provider": "anthropic",
+      "input": 0.8,
+      "output": 4.0,
+      "cacheRead": 0.08,
+      "cacheWrite": 1.0
+    },
+    "gemini-4-argon": {
+      "label": "Gemini 4 Argon",
+      "provider": "google",
+      "input": 2.0,
+      "output": 10.0,
+      "cacheRead": 0.1,
+      "cacheWrite": 2.0,
+      "isPromo": true,
+      "promoStart": "2026-10-21T00:00:00.000Z",
+      "promoEnd": "2026-11-30T23:59:59.999Z",
+      "promoNote": "Promo Google AI Launch (-50% dal 21/10/2026 al 30/11/2026)",
+      "standardInput": 4.0,
+      "standardOutput": 20.0,
+      "standardCacheRead": 0.2,
+      "standardCacheWrite": 4.0
+    },
+    "gemini-4-carbon": {
+      "label": "Gemini 4 Carbon",
+      "provider": "google",
+      "input": 2.0,
+      "output": 10.0,
+      "cacheRead": 0.1,
+      "cacheWrite": 2.0,
+      "isPromo": true,
+      "promoStart": "2026-10-21T00:00:00.000Z",
+      "promoEnd": "2026-11-30T23:59:59.999Z",
+      "promoNote": "Promo Google AI Launch (-50% dal 21/10/2026 al 30/11/2026)",
+      "standardInput": 4.0,
+      "standardOutput": 20.0,
+      "standardCacheRead": 0.2,
+      "standardCacheWrite": 4.0
+    },
+    "gemini-4-hydrogen": {
+      "label": "Gemini 4 Hydrogen",
+      "provider": "google",
+      "input": 1.5,
+      "output": 7.5,
+      "cacheRead": 0.075,
+      "cacheWrite": 1.5,
+      "isPromo": false
+    },
+    "orchestrator-carbon": {
+      "label": "Orchestrator (Carbon)",
+      "provider": "google",
+      "input": 1.65,
+      "output": 8.25,
+      "cacheRead": 0.0825,
+      "cacheWrite": 1.65,
+      "isPromo": true,
+      "promoStart": "2026-10-21T00:00:00.000Z",
+      "promoEnd": "2026-11-30T23:59:59.999Z",
+      "promoNote": "Promo Google AI Launch su Planner Carbon (-50% fino al 30/11/2026) + Hydrogen",
+      "standardInput": 2.25,
+      "standardOutput": 11.25,
+      "standardCacheRead": 0.1125,
+      "standardCacheWrite": 2.25
+    },
+    "orchestrator-argon": {
+      "label": "Orchestrator (Argon)",
+      "provider": "google",
+      "input": 1.65,
+      "output": 8.25,
+      "cacheRead": 0.0825,
+      "cacheWrite": 1.65,
+      "isPromo": true,
+      "promoStart": "2026-10-21T00:00:00.000Z",
+      "promoEnd": "2026-11-30T23:59:59.999Z",
+      "promoNote": "Promo Google AI Launch su Planner Argon (-50% fino al 30/11/2026) + Hydrogen",
+      "standardInput": 2.25,
+      "standardOutput": 11.25,
+      "standardCacheRead": 0.1125,
+      "standardCacheWrite": 2.25
+    },
+    "gemini-2.5-pro": {
+      "label": "Gemini Pro",
+      "provider": "google",
+      "input": 1.25,
+      "output": 10.0,
+      "cacheRead": 0.125,
+      "cacheWrite": 1.25,
+      "isPromo": true,
+      "promoStart": "2026-06-01T00:00:00.000Z",
+      "promoEnd": "2026-12-31T23:59:59.999Z",
+      "promoNote": "Promo Google AI (<200k tokens)",
+      "standardInput": 2.5,
+      "standardOutput": 12.5,
+      "standardCacheRead": 0.625,
+      "standardCacheWrite": 2.5
+    },
+    "gemini-pro": {
+      "label": "Gemini Pro",
+      "provider": "google",
+      "input": 1.25,
+      "output": 10.0,
+      "cacheRead": 0.125,
+      "cacheWrite": 1.25,
+      "isPromo": true,
+      "promoStart": "2026-06-01T00:00:00.000Z",
+      "promoEnd": "2026-12-31T23:59:59.999Z",
+      "promoNote": "Promo Google AI (<200k tokens)",
+      "standardInput": 2.5,
+      "standardOutput": 12.5,
+      "standardCacheRead": 0.625,
+      "standardCacheWrite": 2.5
+    },
+    "gemini-3.8-flash": {
+      "label": "Gemini 3.8 Flash (High)",
+      "provider": "google",
+      "input": 0.75,
+      "output": 3.75,
+      "cacheRead": 0.075,
+      "cacheWrite": 0.75,
+      "isPromo": true,
+      "promoStart": "2026-09-15T00:00:00.000Z",
+      "promoEnd": "2026-12-31T23:59:59.999Z",
+      "promoNote": "Promo Google AI (-50% dal 15/09/2026 al 31/12/2026)",
+      "standardInput": 1.5,
+      "standardOutput": 7.5,
+      "standardCacheRead": 0.15,
+      "standardCacheWrite": 1.5
+    },
+    "gemini-2.5-flash": {
+      "label": "Gemini Flash",
+      "provider": "google",
+      "input": 0.3,
+      "output": 2.5,
+      "cacheRead": 0.03,
+      "cacheWrite": 0.3,
+      "isPromo": true,
+      "promoStart": "2026-06-01T00:00:00.000Z",
+      "promoEnd": "2026-12-31T23:59:59.999Z",
+      "promoNote": "Promo Google AI Introductory",
+      "standardInput": 0.5,
+      "standardOutput": 2.5,
+      "standardCacheRead": 0.125,
+      "standardCacheWrite": 0.5
+    },
+    "gemini-flash": {
+      "label": "Gemini Flash",
+      "provider": "google",
+      "input": 0.3,
+      "output": 2.5,
+      "cacheRead": 0.03,
+      "cacheWrite": 0.3,
+      "isPromo": true,
+      "promoStart": "2026-06-01T00:00:00.000Z",
+      "promoEnd": "2026-12-31T23:59:59.999Z",
+      "promoNote": "Promo Google AI Introductory",
+      "standardInput": 0.5,
+      "standardOutput": 2.5,
+      "standardCacheRead": 0.125,
+      "standardCacheWrite": 0.5
+    },
+    "gemini-flash-lite": {
+      "label": "Gemini Flash-Lite",
+      "provider": "google",
+      "input": 0.1,
+      "output": 0.4,
+      "cacheRead": 0.01,
+      "cacheWrite": 0.1,
+      "isPromo": true,
+      "promoStart": "2026-06-01T00:00:00.000Z",
+      "promoEnd": "2026-12-31T23:59:59.999Z",
+      "promoNote": "Promo Google AI Tier",
+      "standardInput": 0.15,
+      "standardOutput": 0.6,
+      "standardCacheRead": 0.0375,
+      "standardCacheWrite": 0.15
+    }
+  },
+  "defaults": {
+    "claude": "claude-sonnet-4",
+    "antigravity": "gemini-4-argon"
+  }
+}

package/dist/cli/index.js

@@ -0,0 +1,150 @@
+#!/usr/bin/env node
+import { execSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { Command } from 'commander';
+import open from 'open';
+import pc from 'picocolors';
+import { scanAllLogs } from '../core/parser.js';
+import { getPackageRoot, syncOfficialPricing } from '../core/pricing.js';
+import { startLogWatcher } from '../core/watcher.js';
+import { startServer } from '../server/index.js';
+import { printCliReport } from './reporter.js';
+const REPO_SLUG = 'Cise07/ai-burnrate-tool';
+function getPackageVersion() {
+    try {
+        const pkgPath = path.join(getPackageRoot(), 'package.json');
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        return pkg.version || '1.0.0';
+    }
+    catch {
+        return '1.0.0';
+    }
+}
+async function resolveUpdateTarget() {
+    const requested = process.env.BURNRATE_VERSION?.trim();
+    if (requested) {
+        const tag = requested.startsWith('v') ? requested : `v${requested}`;
+        return {
+            label: tag,
+            url: `https://github.com/${REPO_SLUG}/archive/refs/tags/${tag}.tar.gz`,
+        };
+    }
+    try {
+        const res = await fetch(`https://api.github.com/repos/${REPO_SLUG}/releases/latest`, {
+            headers: { 'User-Agent': 'ai-burnrate-cli' },
+            signal: AbortSignal.timeout(4000),
+        });
+        if (res.ok) {
+            const data = (await res.json());
+            if (data.tag_name) {
+                return {
+                    label: data.tag_name,
+                    url: `https://github.com/${REPO_SLUG}/archive/refs/tags/${data.tag_name}.tar.gz`,
+                };
+            }
+        }
+    }
+    catch {
+        // Fallback to main branch if no GitHub Release exists yet or offline
+    }
+    return {
+        label: 'main',
+        url: `https://github.com/${REPO_SLUG}/archive/refs/heads/main.tar.gz`,
+    };
+}
+const program = new Command();
+program
+    .name('burnrate')
+    .description('Real-time local token & API equivalent cost tracker for Antigravity CLI and Claude Code')
+    .version(getPackageVersion())
+    .option('--cli', 'Print the usage report in ANSI tables in the terminal and exit immediately', false)
+    .option('--no-open', 'Start the live server and file watcher without automatically opening the browser')
+    .option('-p, --port <number>', 'Specify a custom port for the dashboard server', '4321')
+    .option('--update', 'Update ai-burnrate to the latest release from GitHub', false)
+    .option('--uninstall', 'Uninstall ai-burnrate globally from your system', false);
+program.parse(process.argv);
+const opts = program.opts();
+async function main() {
+    if (opts.update) {
+        const target = await resolveUpdateTarget();
+        console.log(`\n  ${pc.cyan('●')} Updating ${pc.bold('ai-burnrate')} (${pc.cyan(target.label)}) from GitHub...`);
+        try {
+            execSync(`npm install -g ${target.url}`, {
+                stdio: 'inherit',
+            });
+            console.log(`  ${pc.green('✓')} ${pc.bold('ai-burnrate')} updated successfully to ${pc.bold(target.label)}!\n`);
+            process.exit(0);
+        }
+        catch {
+            console.error(`  ${pc.red('✗')} Failed to update automatically. Try running:\n  ${pc.cyan(`npm install -g ${target.url}`)}\n`);
+            process.exit(1);
+        }
+    }
+    if (opts.uninstall) {
+        console.log(`\n  ${pc.yellow('●')} Uninstalling ${pc.bold('ai-burnrate')} globally...`);
+        try {
+            execSync('npm uninstall -g ai-burnrate-tool', { stdio: 'inherit' });
+            console.log(`  ${pc.green('✓')} ${pc.bold('ai-burnrate')} has been completely removed from your system.\n`);
+            process.exit(0);
+        }
+        catch {
+            console.error(`  ${pc.red('✗')} Failed to uninstall automatically. Run: ${pc.cyan('npm uninstall -g ai-burnrate-tool')}`);
+            process.exit(1);
+        }
+    }
+    const syncResult = await syncOfficialPricing();
+    if (syncResult.updated && syncResult.effectiveFrom) {
+        console.log(`  ${pc.cyan('↻')} Official pricing updated (new tariff active for turns from ${pc.bold(syncResult.effectiveFrom)}; past turns preserved).`);
+    }
+    const snapshot = scanAllLogs(true);
+    if (opts.cli) {
+        printCliReport(snapshot);
+        process.exit(0);
+    }
+    const preferredPort = Number.parseInt(String(opts.port || '4321'), 10) || 4321;
+    const server = await startServer(preferredPort, snapshot);
+    const watcherHandle = startLogWatcher((updatedSnapshot, changedPath) => {
+        server.broadcast(updatedSnapshot, changedPath);
+        const timeStr = new Date().toLocaleTimeString();
+        console.log(`${pc.dim(`[${timeStr}]`)} ${pc.green('● SSE Sync')} ${pc.dim('←')} ${pc.cyan(changedPath)}`);
+    });
+    console.log('');
+    console.log(`  ${pc.bgGreen(pc.black(pc.bold(' AI-BURNRATE ')))} ${pc.green('● LIVE')} ${pc.bold('Real-Time Token & Cost Tracker')}`);
+    console.log(`  ${pc.dim('─'.repeat(58))}`);
+    console.log(`  ${pc.bold('Dashboard URL:')}  ${pc.cyan(pc.underline(server.url))}`);
+    console.log(`  ${pc.bold('SSE Stream:')}     ${pc.dim(`${server.url}/api/events`)}`);
+    console.log(`  ${pc.bold('Watching:')}       ${pc.dim(snapshot.watchedPaths.join(' & '))}`);
+    console.log(`  ${pc.bold('Sessions Found:')} ${pc.yellow(String(snapshot.sessions.length))}`);
+    console.log(`  ${pc.dim('─'.repeat(58))}`);
+    console.log(`  ${pc.dim('Press Ctrl+C to stop the live watcher and exit.')}\n`);
+    if (opts.open !== false) {
+        try {
+            await open(server.url);
+        }
+        catch {
+            console.log(`  ${pc.yellow('!')} Could not auto-open browser. Open ${pc.cyan(server.url)} manually.`);
+        }
+    }
+    let shuttingDown = false;
+    const shutdown = async (signal) => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        console.log(`\n  ${pc.yellow('●')} Received ${signal}. Closing file watcher and SSE connections...`);
+        try {
+            await Promise.all([watcherHandle.close(), server.close()]);
+        }
+        catch {
+            // ignore
+        }
+        console.log(`  ${pc.green('✓')} ai-burnrate stopped cleanly.`);
+        process.exit(0);
+    };
+    process.on('SIGINT', () => void shutdown('SIGINT'));
+    process.on('SIGTERM', () => void shutdown('SIGTERM'));
+}
+main().catch((err) => {
+    console.error(pc.red('Fatal error starting ai-burnrate:'), err);
+    process.exit(1);
+});