opencode-token-tracker 1.7.0 → 1.7.1

package/README.md

@@ -33,6 +33,8 @@ If you are building AI-assisted engineering workflows, we strongly recommend ado
 
 ## Installation
 
+### Plugin
+
 Add to your OpenCode config file (`~/.config/opencode/opencode.json`):
 
 ```json
@@ -44,6 +46,36 @@ Add to your OpenCode config file (`~/.config/opencode/opencode.json`):
 
 Restart OpenCode and the plugin will be automatically installed.
 
+This installs the package for OpenCode's plugin runtime. It does not add the
+`opencode-tokens` CLI command to your shell `PATH`.
+
+### CLI
+
+If you only need to run the CLI occasionally, use it through npm without a
+persistent install:
+
+```bash
+npx -y --package opencode-token-tracker opencode-tokens today
+```
+
+Equivalent `npm exec` form:
+
+```bash
+npm exec --yes --package opencode-token-tracker -- opencode-tokens today
+```
+
+If you want `opencode-tokens` to be available as a normal shell command, install
+the package with npm's global bin linking:
+
+```bash
+npm install -g opencode-token-tracker
+opencode-tokens today
+```
+
+If `opencode-tokens: command not found` appears after configuring the plugin,
+the plugin is still installed for OpenCode, but the CLI command has not been
+installed into your shell `PATH`. Use one of the CLI options above.
+
 ## Usage
 
 For an end-to-end setup and verification path, see [walkthrough.md](./walkthrough.md).
@@ -238,6 +270,9 @@ Config changes are automatically backed up to `token-tracker.json.bak`.
 # Check budget status
 opencode-tokens budget
 
+# Diagnose plugin config, logs, and pricing fallbacks
+opencode-tokens doctor
+
 # Show built-in pricing table
 opencode-tokens pricing
 
@@ -269,7 +304,11 @@ This helps you understand:
 - Whether pricing is from built-in table, your config, or default fallback
 - What to add to your config file
 
-`config init` is safe for piping because stdout contains only valid JSON and no file is written. `config generate` is the file-writing path: stdout stays empty, guides and status messages go to stderr, the parent directory is created when needed, and an existing config is backed up before overwrite.
+`config init` is safe for piping because stdout contains only valid JSON and no file is written. `config generate` is the file-writing path: stdout stays empty, guides and status messages go to stderr, the parent directory is created when needed, and an existing config is backed up before overwrite. Both commands inspect local logs and pre-fill likely zero-cost providers such as GitHub Copilot, Cursor, and Ollama.
+
+`doctor` is a read-only setup check. It reports whether the OpenCode plugin
+entry is present, whether the tracker config and token log exist, the latest log
+record, default-priced models, and the next command to run.
 
 ## Log Files
 
@@ -375,8 +414,9 @@ All prices are in **USD per 1 million tokens**:
 
 | Scenario | Config |
 |----------|--------|
-| Subscription service (GitHub Copilot, Cursor) | `{ "input": 0, "output": 0 }` |
-| Free/local model | `{ "input": 0, "output": 0 }` |
+| Subscription service (GitHub Copilot, Cursor) | Provider override: `{ "input": 0, "output": 0 }` |
+| Free/local provider (Ollama, LM Studio, localhost) | Provider override: `{ "input": 0, "output": 0 }` |
+| Free/local model under a paid provider | Model override: `{ "input": 0, "output": 0 }` |
 | Custom API with known pricing | Look up provider's pricing page |
 
 ### Pricing Override
@@ -394,13 +434,14 @@ Exact user config is intentionally checked before built-ins, while broad partial
 
 #### Example: Free providers
 
-If you're using GitHub Copilot or other subscription-based services, set their cost to $0:
+If you're using GitHub Copilot, Ollama, LM Studio, or other subscription/local providers, set their provider cost to $0:
 
 ```json
 {
   "providers": {
     "github-copilot": { "input": 0, "output": 0 },
-    "cursor": { "input": 0, "output": 0 }
+    "cursor": { "input": 0, "output": 0 },
+    "ollama": { "input": 0, "output": 0 }
   }
 }
 ```

package/README.zh-CN.md

@@ -33,6 +33,8 @@
 
 ## 安装
 
+### 插件
+
 在 OpenCode 配置文件 `~/.config/opencode/opencode.json` 中添加插件：
 
 ```json
@@ -44,6 +46,35 @@
 
 重启 OpenCode 后会自动安装插件。
 
+这一步只会让 OpenCode 的插件运行时安装并加载该包，不会把
+`opencode-tokens` CLI 命令加入你的 shell `PATH`。
+
+### CLI
+
+如果只是偶尔查看统计，可以不做持久安装，直接通过 npm 运行：
+
+```bash
+npx -y --package opencode-token-tracker opencode-tokens today
+```
+
+等价的 `npm exec` 写法：
+
+```bash
+npm exec --yes --package opencode-token-tracker -- opencode-tokens today
+```
+
+如果希望 `opencode-tokens` 成为普通 shell 命令，需要让 npm 建立全局
+bin 链接：
+
+```bash
+npm install -g opencode-token-tracker
+opencode-tokens today
+```
+
+如果你已经在 OpenCode 配置里添加了插件，但执行 `opencode-tokens today`
+提示 `opencode-tokens: command not found`，说明插件已供 OpenCode 加载，
+但 CLI 命令还没有安装到 shell `PATH`。请使用上面的任一 CLI 运行方式。
+
 ## 使用
 
 端到端安装、验证与 dogfood 路径见 [walkthrough.md](./walkthrough.md)。
@@ -243,6 +274,9 @@ opencode-tokens config unset budget.daily
 # 查看预算状态
 opencode-tokens budget
 
+# 诊断插件配置、日志与默认定价回退
+opencode-tokens doctor
+
 # 查看内置定价表
 opencode-tokens pricing
 
@@ -275,7 +309,10 @@ opencode-tokens config generate
 - 定价来源是内置表、用户配置还是默认回退
 - 需要在配置文件中补充哪些模型定价
 
-`config init` 适合管道重定向，因为 stdout 只包含合法 JSON，且不会写文件。`config generate` 是写文件路径：stdout 保持为空，说明和状态信息输出到 stderr；父目录不存在时会自动创建，覆盖已有配置前会先备份。
+`config init` 适合管道重定向，因为 stdout 只包含合法 JSON，且不会写文件。`config generate` 是写文件路径：stdout 保持为空，说明和状态信息输出到 stderr；父目录不存在时会自动创建，覆盖已有配置前会先备份。两个命令都会读取本地日志，并为 GitHub Copilot、Cursor、Ollama 这类疑似零成本 provider 预填覆盖配置。
+
+`doctor` 是只读诊断命令，会检查 OpenCode 插件入口、tracker 配置、token log、
+最新记录、默认定价回退模型，并给出下一步应该运行的命令。
 
 ## 日志文件
 
@@ -367,8 +404,9 @@ token 记录保存在：
 
 | 场景 | 配置 |
 | --- | --- |
-| 订阅制服务（GitHub Copilot、Cursor） | `{ "input": 0, "output": 0 }` |
-| 免费/本地模型 | `{ "input": 0, "output": 0 }` |
+| 订阅制服务（GitHub Copilot、Cursor） | Provider 覆盖：`{ "input": 0, "output": 0 }` |
+| 免费/本地 provider（Ollama、LM Studio、localhost） | Provider 覆盖：`{ "input": 0, "output": 0 }` |
+| 付费 provider 下的免费/本地模型 | Model 覆盖：`{ "input": 0, "output": 0 }` |
 | 自定义 API（已知定价） | 查看 provider 官方定价页 |
 
 ### 定价优先级
@@ -386,13 +424,14 @@ token 记录保存在：
 
 #### 示例：免费 provider
 
-使用 GitHub Copilot 等订阅制服务时，将成本设为 $0：
+使用 GitHub Copilot、Ollama、LM Studio 等订阅制或本地 provider 时，将 provider 成本设为 $0：
 
 ```json
 {
   "providers": {
     "github-copilot": { "input": 0, "output": 0 },
-    "cursor": { "input": 0, "output": 0 }
+    "cursor": { "input": 0, "output": 0 },
+    "ollama": { "input": 0, "output": 0 }
   }
 }
 ```

package/dist/bin/opencode-tokens.js

@@ -1,11 +1,17 @@
 #!/usr/bin/env node
 import { closeSync, copyFileSync, existsSync, mkdirSync, openSync, readFileSync, readSync, statSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
-import { join } from "node:path";
-import { BUILTIN_PRICING, DEFAULT_CONFIG, formatCost, formatTokens, getStartOfDay, getStartOfMonth, getStartOfWeek, validateConfig, BUILTIN_PRICING_META, resolvePricingStatus, round2 } from "../lib/shared.js";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { BUILTIN_PRICING, BUILTIN_PRICING_META, DEFAULT_CONFIG, formatCost, formatLocalDateKey, formatTokens, getStartOfDay, getStartOfMonth, getStartOfWeek, hasBillableTokenUsage, resolvePricingStatus, round2, validateConfig, } from "../lib/shared.js";
 const CONFIG_DIR = join(homedir(), ".config", "opencode");
 const CONFIG_FILE = join(CONFIG_DIR, "token-tracker.json");
 const LOG_FILE = join(CONFIG_DIR, "logs", "token-tracker", "tokens.jsonl");
+const PACKAGE_ROOT = join(dirname(fileURLToPath(import.meta.url)), "..", "..");
+const OPENCODE_CONFIG_FILES = [
+    join(CONFIG_DIR, "opencode.json"),
+    join(CONFIG_DIR, "opencode.jsonc"),
+];
 // ============================================================================
 // Helpers
 // ============================================================================
@@ -20,6 +26,41 @@ function truncateSessionId(sessionId) {
         return "unknown";
     return sessionId.length > 16 ? `${sessionId.slice(0, 14)}…` : sessionId;
 }
+function formatAge(ts) {
+    const diffMs = Date.now() - ts;
+    if (diffMs < 60_000)
+        return "less than 1m ago";
+    const minutes = Math.floor(diffMs / 60_000);
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    return `${Math.floor(hours / 24)}d ago`;
+}
+const ZERO_COST_PROVIDER_HINTS = [
+    { match: "copilot", reason: "subscription/bundled provider" },
+    { match: "cursor", reason: "subscription/bundled provider" },
+    { match: "free", reason: "free provider name" },
+    { match: "ollama", reason: "local/self-hosted provider" },
+    { match: "lmstudio", reason: "local/self-hosted provider" },
+    { match: "lm-studio", reason: "local/self-hosted provider" },
+    { match: "llamacpp", reason: "local/self-hosted provider" },
+    { match: "llama.cpp", reason: "local/self-hosted provider" },
+    { match: "local", reason: "local/self-hosted provider" },
+    { match: "localhost", reason: "local/self-hosted provider" },
+    { match: "self-hosted", reason: "local/self-hosted provider" },
+    { match: "selfhosted", reason: "local/self-hosted provider" },
+];
+function getZeroCostProviderMatch(provider) {
+    const normalized = provider.toLowerCase().replace(/\s+/g, "");
+    for (const hint of ZERO_COST_PROVIDER_HINTS) {
+        if (normalized.includes(hint.match)) {
+            return { provider, reason: hint.reason };
+        }
+    }
+    return undefined;
+}
 function parseArgs(args) {
     const positional = [];
     const flags = new Map();
@@ -49,7 +90,7 @@ function parseArgs(args) {
             i++;
             continue;
         }
-        if (arg.startsWith("-") && arg.length === 2 && arg !== "--") {
+        if (/^-[A-Za-z]$/.test(arg)) {
             const next = args[i + 1];
             if (next && !next.startsWith("-")) {
                 flags.set(arg.slice(1), next);
@@ -109,7 +150,7 @@ function loadEntries(since) {
                     shouldStop = true;
                     break;
                 }
-                if (!entry.input && !entry.output)
+                if (!hasBillableTokenUsage(entry))
                     continue;
                 entries.push(entry);
             }
@@ -122,7 +163,7 @@ function loadEntries(since) {
     if (!shouldStop && leftover.trim()) {
         try {
             const entry = JSON.parse(leftover.trim());
-            if (entry.type === "tokens" && (!since || entry._ts >= since) && (entry.input || entry.output)) {
+            if (entry.type === "tokens" && (!since || entry._ts >= since) && hasBillableTokenUsage(entry)) {
                 entries.push(entry);
             }
         }
@@ -233,7 +274,7 @@ function printTable(title, groups, labelHeader) {
 function printDailyBreakdown(entries) {
     const byDay = groupBy(entries, (e) => {
         const date = new Date(e._ts);
-        return date.toISOString().slice(0, 10);
+        return formatLocalDateKey(date);
     });
     const sorted = Array.from(byDay.entries()).sort((a, b) => b[0].localeCompare(a[0]));
     if (sorted.length === 0) {
@@ -258,6 +299,38 @@ function printDailyBreakdown(entries) {
 // ============================================================================
 // Commands
 // ============================================================================
+const STATS_BREAKDOWNS = ["model", "agent", "provider", "day", "daily", "session", "all"];
+const STATS_PERIODS = ["today", "week", "month", "all"];
+const TOP_LEVEL_COMMANDS = ["budget", "doctor", "pricing", "models", "config", "export", "trend"];
+function isStatsBreakdown(value) {
+    return STATS_BREAKDOWNS.includes(value);
+}
+function isStatsPeriod(value) {
+    return STATS_PERIODS.includes(value);
+}
+function isTopLevelCommand(value) {
+    return TOP_LEVEL_COMMANDS.includes(value);
+}
+function getStatsBreakdown(flags) {
+    const longValue = flagValue(flags, "by");
+    const shortValue = flagValue(flags, "b");
+    if (flags.has("by") && !longValue) {
+        failCli("Missing value for --by", "Usage: opencode-tokens [today|week|month|all] --by model|agent|provider|daily|session|all");
+        return undefined;
+    }
+    if (flags.has("b") && !shortValue) {
+        failCli("Missing value for -b", "Usage: opencode-tokens [today|week|month|all] -b model|agent|provider|daily|session|all");
+        return undefined;
+    }
+    const breakdown = longValue ?? shortValue;
+    if (!breakdown)
+        return undefined;
+    if (!isStatsBreakdown(breakdown)) {
+        failCli(`Unsupported stats breakdown: ${breakdown}`, "Allowed breakdowns: model, agent, provider, daily, day, session, all");
+        return undefined;
+    }
+    return breakdown;
+}
 function cmdStats(period, breakdown) {
     const now = new Date();
     let since;
@@ -322,12 +395,12 @@ function cmdPricing() {
 `);
     // Group by provider
     const groups = {
-        "Anthropic Claude": ["claude-opus-4.6", "claude-opus-4.5", "claude-sonnet-4.5", "claude-sonnet-4", "claude-haiku-4.5", "claude-haiku-4", "claude-opus-4.1", "claude-opus-4", "claude-haiku-3"],
-        "OpenAI": ["gpt-5.2", "gpt-5.2-pro", "gpt-5-mini", "gpt-5.1", "gpt-5", "gpt-4.1", "gpt-4.1-mini", "gpt-4.1-nano", "gpt-4o", "gpt-4o-mini", "o3", "o3-mini", "o4-mini", "o1", "o1-mini"],
-        "DeepSeek": ["deepseek-chat", "deepseek-reasoner"],
-        "Google Gemini": ["gemini-3-pro", "gemini-3-pro-preview", "gemini-3-flash", "gemini-3-flash-preview", "gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.5-flash-lite", "gemini-2.0-flash", "gemini-2.0-flash-lite"],
+        "Anthropic Claude": ["claude-opus-4.8", "claude-opus-4.7", "claude-opus-4.6", "claude-opus-4.5", "claude-sonnet-4.6", "claude-sonnet-4.5", "claude-sonnet-4", "claude-haiku-4.5", "claude-haiku-4", "claude-opus-4.1", "claude-opus-4", "claude-haiku-3"],
+        "OpenAI": ["gpt-5.5", "gpt-5.5-pro", "gpt-5.4", "gpt-5.4-mini", "gpt-5.4-nano", "gpt-5.4-pro", "gpt-5.3-codex", "gpt-5.3-chat-latest", "gpt-5.2", "gpt-5.2-pro", "gpt-5-mini", "gpt-5-nano", "gpt-5.1", "gpt-5.1-chat-latest", "gpt-5.1-codex-max", "gpt-5.1-codex", "gpt-5.1-codex-mini", "gpt-5", "gpt-5-chat-latest", "gpt-5-codex", "gpt-4.1", "gpt-4.1-mini", "gpt-4.1-nano", "gpt-4o", "gpt-4o-mini", "o3", "o3-mini", "o4-mini", "o1", "o1-mini"],
+        "DeepSeek": ["deepseek-chat", "deepseek-reasoner", "deepseek-v4-pro"],
+        "Google Gemini": ["gemini-3.1-pro-preview", "gemini-3-pro", "gemini-3-pro-preview", "gemini-3.5-flash", "gemini-3-flash", "gemini-3-flash-preview", "gemini-3.1-flash-lite", "gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.5-flash-lite", "gemini-2.0-flash", "gemini-2.0-flash-lite"],
     };
-    const modelWidth = 20;
+    const modelWidth = 24;
     const priceWidth = 10;
     for (const [group, models] of Object.entries(groups)) {
         console.log(`  ${group}`);
@@ -392,8 +465,19 @@ function cmdModels() {
     const statusWidth = 12;
     console.log(`  ${padRight("Model", modelWidth)}  ${padRight("Provider", providerWidth)}  ${padLeft("Msgs", countWidth)}  ${padRight("Pricing", statusWidth)}`);
     console.log(`  ${"-".repeat(modelWidth)}  ${"-".repeat(providerWidth)}  ${"-".repeat(countWidth)}  ${"-".repeat(statusWidth)}`);
+    const defaultModels = [];
+    const zeroCostProviderModels = [];
     for (const { model, provider, count } of sorted) {
         const status = resolvePricingStatus(config, model, provider);
+        if (status === "default") {
+            const zeroCostMatch = getZeroCostProviderMatch(provider);
+            if (zeroCostMatch) {
+                zeroCostProviderModels.push({ model, provider, count, reason: zeroCostMatch.reason });
+            }
+            else {
+                defaultModels.push({ model, provider, count });
+            }
+        }
         console.log(`  ${padRight(model, modelWidth)}  ${padRight(provider, providerWidth)}  ${padLeft(count.toString(), countWidth)}  ${padRight(status, statusWidth)}`);
     }
     console.log();
@@ -403,6 +487,194 @@ function cmdModels() {
     console.log(`    model cfg    = overridden by models config`);
     console.log(`    default      = unknown model, using $1/$4 per 1M tokens`);
     console.log();
+    if (zeroCostProviderModels.length > 0 || defaultModels.length > 0) {
+        console.log(`  Next steps for default pricing:`);
+        const total = zeroCostProviderModels.length + defaultModels.length;
+        console.log(`    ${total} model/provider ${total === 1 ? "pair uses" : "pairs use"} the default $1/$4 estimate.`);
+        console.log(`    Run: opencode-tokens config init`);
+        console.log(`    Or:  opencode-tokens config generate`);
+        console.log();
+        if (zeroCostProviderModels.length > 0) {
+            console.log(`    Likely zero-cost provider overrides to review:`);
+            for (const { provider, reason } of dedupeZeroCostProviderMatches(zeroCostProviderModels).slice(0, 5)) {
+                console.log(`    - ${provider} (${reason}): { "input": 0, "output": 0 }`);
+            }
+            if (zeroCostProviderModels.length > 5) {
+                console.log(`    - ...and ${zeroCostProviderModels.length - 5} more model/provider pairs`);
+            }
+            console.log();
+        }
+        if (defaultModels.length > 0) {
+            console.log(`    Model overrides to review before saving:`);
+            for (const { model, provider, count } of defaultModels.slice(0, 5)) {
+                console.log(`    - ${model} (${provider}, ${count} msgs): { "input": 1, "output": 4 }`);
+            }
+            if (defaultModels.length > 5) {
+                console.log(`    - ...and ${defaultModels.length - 5} more`);
+            }
+            console.log();
+        }
+    }
+}
+function cmdDoctor() {
+    const entries = loadEntries();
+    const configDiagnostics = inspectTrackerConfig();
+    const pluginDiagnostics = inspectOpenCodePluginConfig();
+    console.log(`
+  OpenCode Token Tracker Doctor
+  ══════════════════════════════════════════════════════════════════
+`);
+    console.log(`  CLI`);
+    console.log(`    Entry: ${process.argv[1] ?? "unknown"}`);
+    console.log(`    Package version: ${readPackageJsonVersion()}`);
+    console.log();
+    console.log(`  OpenCode plugin config`);
+    if (pluginDiagnostics.found) {
+        console.log(`    File: ${pluginDiagnostics.path}`);
+        console.log(`    Plugin entry: ${pluginDiagnostics.hasPlugin ? "found" : "missing"}`);
+    }
+    else {
+        console.log(`    File: not found (${OPENCODE_CONFIG_FILES.map((p) => p.replace(`${homedir()}/`, "~/")).join(" or ")})`);
+        console.log(`    Plugin entry: unknown`);
+    }
+    console.log();
+    console.log(`  Tracker config`);
+    console.log(`    File: ${CONFIG_FILE}`);
+    console.log(`    Status: ${configDiagnostics.exists ? "exists" : "using defaults"}`);
+    if (configDiagnostics.parseError) {
+        console.log(`    Warning: ${configDiagnostics.parseError}`);
+    }
+    for (const warning of configDiagnostics.warnings) {
+        console.log(`    Warning: ${warning}`);
+    }
+    const budget = configDiagnostics.config.budget;
+    const hasBudget = Boolean(budget.daily || budget.weekly || budget.monthly);
+    console.log(`    Budget: ${hasBudget ? "configured" : "not configured"}`);
+    console.log();
+    console.log(`  Token log`);
+    if (!existsSync(LOG_FILE)) {
+        console.log(`    File: not found (${LOG_FILE})`);
+        console.log(`    Entries: 0`);
+    }
+    else {
+        const latest = entries[entries.length - 1];
+        console.log(`    File: ${LOG_FILE}`);
+        console.log(`    Entries: ${entries.length}`);
+        console.log(`    Latest: ${latest ? `${new Date(latest._ts).toISOString()} (${formatAge(latest._ts)})` : "none"}`);
+    }
+    console.log();
+    const defaultModels = getDefaultModelProviders(entries, configDiagnostics.config);
+    const zeroCostProviders = dedupeZeroCostProviderMatches(defaultModels.flatMap(({ model, provider, count }) => {
+        const match = getZeroCostProviderMatch(provider);
+        return match ? [{ model, provider, count, reason: match.reason }] : [];
+    }));
+    console.log(`  Pricing`);
+    console.log(`    Built-in pricing updated: ${BUILTIN_PRICING_META.pricingLastUpdated}`);
+    console.log(`    Default-priced model/provider pairs: ${defaultModels.length}`);
+    for (const { model, provider, count } of defaultModels.slice(0, 5)) {
+        console.log(`    - ${model} (${provider}, ${count} msgs)`);
+    }
+    if (defaultModels.length > 5) {
+        console.log(`    - ...and ${defaultModels.length - 5} more`);
+    }
+    if (zeroCostProviders.length > 0) {
+        console.log(`    Likely zero-cost providers:`);
+        for (const { provider, reason } of zeroCostProviders.slice(0, 5)) {
+            console.log(`    - ${provider} (${reason})`);
+        }
+    }
+    console.log();
+    const nextSteps = [];
+    if (!pluginDiagnostics.found || !pluginDiagnostics.hasPlugin) {
+        nextSteps.push(`Add "opencode-token-tracker" to your OpenCode plugin config.`);
+    }
+    if (!existsSync(LOG_FILE) || entries.length === 0) {
+        nextSteps.push(`Run an OpenCode request, then check ${LOG_FILE}.`);
+    }
+    if (configDiagnostics.parseError || configDiagnostics.warnings.length > 0) {
+        nextSteps.push(`Fix ${CONFIG_FILE} or regenerate it with: opencode-tokens config generate`);
+    }
+    if (defaultModels.length > 0) {
+        nextSteps.push(`Review default pricing with: opencode-tokens models`);
+        nextSteps.push(`Generate suggested overrides with: opencode-tokens config init`);
+    }
+    if (!hasBudget) {
+        nextSteps.push(`Configure optional budgets with: opencode-tokens config init`);
+    }
+    console.log(`  Next steps`);
+    if (nextSteps.length === 0) {
+        console.log(`    No obvious issues found.`);
+    }
+    else {
+        for (const step of nextSteps) {
+            console.log(`    - ${step}`);
+        }
+    }
+    console.log();
+}
+function readPackageJsonVersion() {
+    try {
+        const pkg = JSON.parse(readFileSync(join(PACKAGE_ROOT, "package.json"), "utf-8"));
+        return typeof pkg.version === "string" ? pkg.version : "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
+function inspectOpenCodePluginConfig() {
+    for (const path of OPENCODE_CONFIG_FILES) {
+        if (!existsSync(path))
+            continue;
+        const raw = readFileSync(path, "utf-8");
+        return {
+            found: true,
+            path,
+            hasPlugin: raw.includes("opencode-token-tracker"),
+        };
+    }
+    return { found: false, hasPlugin: false };
+}
+function inspectTrackerConfig() {
+    if (!existsSync(CONFIG_FILE)) {
+        return { exists: false, config: DEFAULT_CONFIG, warnings: [] };
+    }
+    try {
+        const raw = JSON.parse(readFileSync(CONFIG_FILE, "utf-8"));
+        const result = validateConfig(raw);
+        return { exists: true, config: result.config, warnings: result.warnings };
+    }
+    catch {
+        return { exists: true, config: DEFAULT_CONFIG, warnings: [], parseError: "Config file is not valid JSON, using defaults" };
+    }
+}
+function getDefaultModelProviders(entries, config) {
+    const counts = new Map();
+    for (const e of entries) {
+        const model = e.model ?? "unknown";
+        const provider = e.provider ?? "unknown";
+        if (model === "unknown" || provider === "unknown")
+            continue;
+        const key = `${model}|${provider}`;
+        let item = counts.get(key);
+        if (!item) {
+            item = { model, provider, count: 0, lastUsed: 0 };
+            counts.set(key, item);
+        }
+        item.count++;
+        item.lastUsed = Math.max(item.lastUsed, e._ts);
+    }
+    return Array.from(counts.values())
+        .filter(({ model, provider }) => resolvePricingStatus(config, model, provider) === "default")
+        .sort((a, b) => b.lastUsed - a.lastUsed);
+}
+function dedupeZeroCostProviderMatches(items) {
+    const providers = new Map();
+    for (const item of items) {
+        if (!providers.has(item.provider)) {
+            providers.set(item.provider, { provider: item.provider, reason: item.reason });
+        }
+    }
+    return Array.from(providers.values());
 }
 function cmdConfig(positional) {
     const action = positional[1];
@@ -444,12 +716,14 @@ function cmdConfig(positional) {
             },
         };
         const suggestedProviders = [];
-        // Add providers as comments/examples (Common free providers)
+        const suggestedProviderNames = new Set();
+        // Add likely zero-cost providers detected from logs.
         for (const provider of providers) {
-            const pLower = provider.toLowerCase();
-            if (pLower.includes("copilot") || pLower.includes("cursor") || pLower.includes("free")) {
+            const zeroCostMatch = getZeroCostProviderMatch(provider);
+            if (zeroCostMatch) {
                 exampleConfig.providers[provider] = { input: 0, output: 0 };
-                suggestedProviders.push(provider);
+                suggestedProviders.push(zeroCostMatch);
+                suggestedProviderNames.add(provider);
             }
         }
         const suggestedModels = [];
@@ -458,6 +732,8 @@ function cmdConfig(positional) {
             const [model, provider] = mp.split("|");
             if (model === "unknown" || provider === "unknown")
                 continue;
+            if (suggestedProviderNames.has(provider))
+                continue;
             const status = resolvePricingStatus(config, model, provider);
             if (status === "default") {
                 exampleConfig.models[model] = { input: 1, output: 4 };
@@ -488,10 +764,10 @@ function cmdConfig(positional) {
         }
         if (suggestedProviders.length > 0) {
             suggestionsSummary += `
-  Detected zero-cost/subscription providers:
+  Detected likely zero-cost providers:
 `;
-            for (const p of suggestedProviders) {
-                suggestionsSummary += `    • ${p} (automatically pre-configured to $0.00)\n`;
+            for (const { provider, reason } of suggestedProviders) {
+                suggestionsSummary += `    • ${provider} (${reason}, automatically pre-configured to $0.00)\n`;
             }
         }
         if (suggestedModels.length > 0) {
@@ -518,11 +794,11 @@ function cmdConfig(positional) {
 
   Examples:
     { "input": 15, "output": 75 }     = $15 per 1M input, $75 per 1M output
-    { "input": 0, "output": 0 }       = Free (subscription or local model)
+    { "input": 0, "output": 0 }       = Free (subscription or local provider/model)
 
   Common scenarios:
     - GitHub Copilot, Cursor, etc.   → Set provider to { input: 0, output: 0 }
-    - Local/self-hosted models       → Set to 0
+    - Ollama, LM Studio, localhost   → Set provider to { input: 0, output: 0 }
     - Direct API usage               → Look up provider's pricing page
 
   Where to find pricing:
@@ -570,11 +846,11 @@ function cmdConfig(positional) {
     if (action === "get") {
         const key = positional[2];
         if (!key) {
-            console.log("\n  Usage: opencode-tokens config get <key>\n");
+            failCli("Missing config key", "Usage: opencode-tokens config get <key>");
             return;
         }
         if (!SETTABLE_KEYS[key]) {
-            console.log(`\n  Unknown key: ${key}\n  Available: ${Object.keys(SETTABLE_KEYS).join(", ")}\n`);
+            failCli(`Unknown config key: ${key}`, `Available keys: ${Object.keys(SETTABLE_KEYS).join(", ")}`);
             return;
         }
         const value = resolveConfigKey(config, key);
@@ -584,27 +860,31 @@ function cmdConfig(positional) {
     if (action === "set") {
         const key = positional[2];
         const rawValue = positional[3];
-        if (!key || !rawValue) {
-            console.log("\n  Usage: opencode-tokens config set <key> <value>\n");
+        if (!key) {
+            failCli("Missing config key", "Usage: opencode-tokens config set <key> <value>");
+            return;
+        }
+        if (!rawValue) {
+            failCli("Missing config value", "Usage: opencode-tokens config set <key> <value>");
             return;
         }
         const spec = SETTABLE_KEYS[key];
         if (!spec) {
-            console.log(`\n  Unknown key: ${key}\n  Available: ${Object.keys(SETTABLE_KEYS).join(", ")}\n`);
+            failCli(`Unknown config key: ${key}`, `Available keys: ${Object.keys(SETTABLE_KEYS).join(", ")}`);
             return;
         }
         const value = parseConfigValue(rawValue);
         if (typeof value !== spec.type) {
-            console.log(`\n  Invalid type: expected ${spec.type}, got ${typeof value}\n`);
+            failCli(`Invalid type for ${key}: expected ${spec.type}, got ${typeof value}`);
             return;
         }
         if (typeof value === "number") {
             if (value < 0) {
-                console.log(`\n  Value must be >= 0\n`);
+                failCli(`Invalid value for ${key}: must be >= 0`);
                 return;
             }
             if (spec.max !== undefined && value > spec.max) {
-                console.log(`\n  Value must be <= ${spec.max}\n`);
+                failCli(`Invalid value for ${key}: must be <= ${spec.max}`);
                 return;
             }
         }
@@ -615,12 +895,12 @@ function cmdConfig(positional) {
     if (action === "unset") {
         const key = positional[2];
         if (!key) {
-            console.log("\n  Usage: opencode-tokens config unset <key>\n");
+            failCli("Missing config key", "Usage: opencode-tokens config unset <key>");
             return;
         }
         const spec = SETTABLE_KEYS[key];
         if (!spec) {
-            console.log(`\n  Unknown key: ${key}\n  Available: ${Object.keys(SETTABLE_KEYS).join(", ")}\n`);
+            failCli(`Unknown config key: ${key}`, `Available keys: ${Object.keys(SETTABLE_KEYS).join(", ")}`);
             return;
         }
         applyConfigUnset(key);
@@ -628,8 +908,7 @@ function cmdConfig(positional) {
         return;
     }
     if (action && action !== "show") {
-        console.log(`\n  Unknown config action: ${action}`);
-        console.log(`  Usage: opencode-tokens config [show|init|generate|get|set|unset]\n`);
+        failCli(`Unknown config action: ${action}`, "Usage: opencode-tokens config [show|init|generate|get|set|unset]");
         return;
     }
     // Show current config
@@ -733,10 +1012,48 @@ function saveConfig(raw) {
 // ============================================================================
 // Export
 // ============================================================================
+const EXPORT_FORMATS = ["csv", "json"];
+const EXPORT_PERIODS = ["today", "week", "month", "all"];
+function failCli(message, usage) {
+    process.stderr.write(`\n  Error: ${message}\n`);
+    if (usage) {
+        process.stderr.write(`  ${usage}\n`);
+    }
+    process.stderr.write("\n");
+    process.exitCode = 1;
+}
+function isExportFormat(format) {
+    return EXPORT_FORMATS.includes(format);
+}
+function isExportPeriod(period) {
+    return EXPORT_PERIODS.includes(period);
+}
 function cmdExport(flags) {
-    const format = flagValue(flags, "format") || "csv";
-    const period = flagValue(flags, "period") || "all";
+    const formatValue = flagValue(flags, "format");
+    const periodValue = flagValue(flags, "period");
     const outputFile = flagValue(flags, "output");
+    if (flags.has("format") && !formatValue) {
+        failCli("Missing value for --format", "Usage: opencode-tokens export --format csv|json");
+        return;
+    }
+    if (flags.has("period") && !periodValue) {
+        failCli("Missing value for --period", "Usage: opencode-tokens export --period today|week|month|all");
+        return;
+    }
+    if (flags.has("output") && !outputFile) {
+        failCli("Missing value for --output", "Usage: opencode-tokens export --output <file>");
+        return;
+    }
+    const format = formatValue ?? "csv";
+    const period = periodValue ?? "all";
+    if (!isExportFormat(format)) {
+        failCli(`Unsupported export format: ${format}`, "Allowed formats: csv, json");
+        return;
+    }
+    if (!isExportPeriod(period)) {
+        failCli(`Unsupported export period: ${period}`, "Allowed periods: today, week, month, all");
+        return;
+    }
     const now = new Date();
     let since;
     switch (period) {
@@ -780,7 +1097,14 @@ function cmdExport(flags) {
         output = `${[headers.join(","), ...rows].join("\n")}\n`;
     }
     if (outputFile) {
-        writeFileSync(outputFile, output);
+        try {
+            writeFileSync(outputFile, output);
+        }
+        catch (error) {
+            const detail = error instanceof Error ? error.message : String(error);
+            failCli(`Failed to write export file: ${detail}`);
+            return;
+        }
         console.log(`\n  Exported ${entries.length} entries to ${outputFile}\n`);
     }
     else {
@@ -897,6 +1221,7 @@ function cmdHelp() {
   Commands:
     (default)     Show usage statistics
     budget        Show budget status (daily/weekly/monthly)
+    doctor        Diagnose plugin config, logs, and pricing fallbacks
     pricing       Show built-in pricing table
     models        Show your used models and their pricing status
     config        Show/generate/modify configuration
@@ -935,6 +1260,7 @@ function cmdHelp() {
 
   Examples:
     opencode-tokens                       # All-time summary
+    opencode-tokens doctor                # Diagnose setup and logs
     opencode-tokens today --by model      # Today by model
     opencode-tokens week --by session     # This week by session
     opencode-tokens trend --days 7        # 7-day cost trend
@@ -945,6 +1271,10 @@ function cmdHelp() {
   Costs are estimates from local logs; budgets are warnings, not enforcement.
 `);
 }
+const TREND_METRICS = ["cost", "tokens", "messages"];
+function isTrendMetric(metric) {
+    return TREND_METRICS.includes(metric);
+}
 function getTrendValue(point, metric) {
     return metric === "tokens" ? point.tokens : metric === "messages" ? point.messages : point.cost;
 }
@@ -958,6 +1288,25 @@ function formatSignedTrendValue(value, metric) {
 function metricLabel(metric) {
     return metric === "tokens" ? "Token Trend" : metric === "messages" ? "Message Trend" : "Cost Trend";
 }
+function parsePositiveIntegerOption(flags, name, defaultValue, usage) {
+    const value = flagValue(flags, name);
+    if (flags.has(name) && !value) {
+        failCli(`Missing value for --${name}`, usage);
+        return undefined;
+    }
+    if (!value)
+        return defaultValue;
+    if (!/^\d+$/.test(value)) {
+        failCli(`Invalid value for --${name}: ${value}`, usage);
+        return undefined;
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (parsed <= 0) {
+        failCli(`Invalid value for --${name}: ${value}`, usage);
+        return undefined;
+    }
+    return parsed;
+}
 function buildLineRows(points, width, height) {
     const grid = Array.from({ length: height }, () => Array.from({ length: width }, () => " "));
     // 1. Calculate the exact integer row r[x] for every column x from 0 to width - 1
@@ -1064,9 +1413,22 @@ function buildTrendXAxis(points, chartPoints, chartWidth) {
     };
 }
 function cmdTrend(flags) {
-    const days = parseInt(String(flagValue(flags, "days") ?? "30"), 10);
-    const metric = flagValue(flags, "metric") ?? "cost";
-    const width = parseInt(String(flagValue(flags, "width") ?? "60"), 10);
+    const days = parsePositiveIntegerOption(flags, "days", 30, "Usage: opencode-tokens trend --days <positive-integer>");
+    if (days === undefined)
+        return;
+    const metricValue = flagValue(flags, "metric");
+    if (flags.has("metric") && !metricValue) {
+        failCli("Missing value for --metric", "Usage: opencode-tokens trend --metric cost|tokens|messages");
+        return;
+    }
+    const metric = metricValue ?? "cost";
+    if (!isTrendMetric(metric)) {
+        failCli(`Unsupported trend metric: ${metric}`, "Allowed metrics: cost, tokens, messages");
+        return;
+    }
+    const width = parsePositiveIntegerOption(flags, "width", 60, "Usage: opencode-tokens trend --width <positive-integer>");
+    if (width === undefined)
+        return;
     const since = getStartOfDay(new Date(Date.now() - days * 86400000));
     const entries = loadEntries(since);
     if (entries.length === 0) {
@@ -1173,33 +1535,45 @@ function main() {
         return;
     }
     const { command } = parsed;
-    switch (command) {
-        case "budget":
-            cmdBudget();
-            return;
-        case "pricing":
-            cmdPricing();
-            return;
-        case "models":
-            cmdModels();
-            return;
-        case "config":
-            cmdConfig(parsed.positional);
-            return;
-        case "export":
-            cmdExport(parsed.flags);
-            return;
-        case "trend":
-            cmdTrend(parsed.flags);
-            return;
-    }
+    if (isTopLevelCommand(command))
+        switch (command) {
+            case "budget":
+                cmdBudget();
+                return;
+            case "doctor":
+                cmdDoctor();
+                return;
+            case "pricing":
+                cmdPricing();
+                return;
+            case "models":
+                cmdModels();
+                return;
+            case "config":
+                cmdConfig(parsed.positional);
+                return;
+            case "export":
+                cmdExport(parsed.flags);
+                return;
+            case "trend":
+                cmdTrend(parsed.flags);
+                return;
+        }
     // Default: stats
     let period = "all";
-    const breakdown = flagValue(parsed.flags, "by") || (parsed.flags.has("b") ? String(parsed.flags.get("b")) : undefined);
-    for (const p of ["today", "week", "month", "all"]) {
-        if (parsed.positional.includes(p)) {
-            period = p;
-            break;
+    const breakdown = getStatsBreakdown(parsed.flags);
+    if (process.exitCode)
+        return;
+    if (command) {
+        if (!isStatsPeriod(command)) {
+            failCli(`Unknown command or stats period: ${command}`, "Usage: opencode-tokens [today|week|month|all] [--by model|agent|provider|daily|session|all]");
+            return;
+        }
+        period = command;
+        const extraArgs = parsed.positional.slice(1);
+        if (extraArgs.length > 0) {
+            failCli(`Unexpected argument for stats command: ${extraArgs[0]}`, "Usage: opencode-tokens [today|week|month|all] [--by model|agent|provider|daily|session|all]");
+            return;
         }
     }
     cmdStats(period, breakdown);

package/dist/index.js

@@ -1,4 +1,4 @@
-import { DEFAULT_CONFIG, formatCost, formatTokens, getStartOfDay, getStartOfWeek, getStartOfMonth, validateConfig, evaluateBudgetStatus, calculateCost } from "./lib/shared.js";
+import { DEFAULT_CONFIG, calculateCost, evaluateBudgetStatus, formatCost, formatTokens, getStartOfDay, getStartOfMonth, getStartOfWeek, hasBillableTokenUsage, validateConfig, } from "./lib/shared.js";
 import { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, openSync, readSync, closeSync } from "fs";
 import { open } from "fs/promises";
 import { join } from "path";
@@ -366,8 +366,7 @@ export const TokenTrackerPlugin = async ({ directory, client }) => {
                         const reasoning = info.tokens.reasoning ?? 0;
                         const cacheRead = info.tokens.cache?.read ?? 0;
                         const cacheWrite = info.tokens.cache?.write ?? 0;
-                        const hasTokens = input > 0 || output > 0 || cacheRead > 0 || cacheWrite > 0;
-                        if (!hasTokens)
+                        if (!hasBillableTokenUsage({ input, output, cacheRead, cacheWrite }))
                             return;
                         const dedupeKey = `${messageId}-${input}-${output}-${cacheRead}-${cacheWrite}`;
                         if (isDuplicate(dedupeKey))

package/dist/lib/shared.d.ts

@@ -4,12 +4,18 @@ export interface ModelPricing {
     cacheRead?: number;
     cacheWrite?: number;
 }
+export interface BillableTokenUsage {
+    input?: number;
+    output?: number;
+    cacheRead?: number;
+    cacheWrite?: number;
+}
 export interface ProviderModelPricingMap {
     [provider: string]: ModelPricing;
 }
 export declare const BUILTIN_PRICING_META: {
-    readonly pricingLastUpdated: "2026-02-11";
-    readonly metadataLastUpdated: "2026-05-24";
+    readonly pricingLastUpdated: "2026-05-29";
+    readonly metadataLastUpdated: "2026-05-29";
     readonly source: "Provider official pricing pages";
     readonly notes: "Manually maintained. Report stale prices: https://github.com/tongsh6/opencode-token-tracker/issues/new";
 };
@@ -21,7 +27,9 @@ export declare function formatCost(cost: number): string;
  * @param millionDecimals - decimal places for M-level values (default 1)
  */
 export declare function formatTokens(tokens: number, millionDecimals?: number): string;
+export declare function hasBillableTokenUsage(usage: BillableTokenUsage): boolean;
 export declare function getStartOfDay(date?: Date): number;
+export declare function formatLocalDateKey(date: Date): string;
 export declare function getStartOfWeek(date?: Date): number;
 export declare function getStartOfMonth(date?: Date): number;
 export interface ToastConfig {

package/dist/lib/shared.js

@@ -2,28 +2,30 @@
 // Shared types, pricing data, and utilities for opencode-token-tracker
 // ============================================================================
 // ============================================================================
-// Built-in Pricing (USD per 1M tokens) - Updated 2026-02-11
+// Built-in Pricing (USD per 1M tokens) - Updated 2026-05-29
 // Sources:
-// - Anthropic: https://www.anthropic.com/pricing#api
-// - OpenAI: https://openai.com/api/pricing/
+// - Anthropic: https://platform.claude.com/docs/en/about-claude/pricing
+// - OpenAI: https://developers.openai.com/api/docs/pricing
 // - DeepSeek: https://api-docs.deepseek.com/quick_start/pricing
 // - Google: https://cloud.google.com/vertex-ai/generative-ai/pricing
 // ============================================================================
 export const BUILTIN_PRICING_META = {
-    pricingLastUpdated: "2026-02-11",
-    metadataLastUpdated: "2026-05-24",
+    pricingLastUpdated: "2026-05-29",
+    metadataLastUpdated: "2026-05-29",
     source: "Provider official pricing pages",
     notes: "Manually maintained. Report stale prices: https://github.com/tongsh6/opencode-token-tracker/issues/new",
 };
 export const BUILTIN_PRICING = {
-    // Anthropic Claude (https://www.anthropic.com/pricing#api)
-    // Opus 4.6: $5 input, $25 output (≤200K), cache write $6.25, cache read $0.50
+    // Anthropic Claude (https://platform.claude.com/docs/en/about-claude/pricing)
+    // Opus 4.8/4.7/4.6/4.5: $5 input, $25 output, cache write $6.25, cache read $0.50
+    "claude-opus-4.8": { input: 5, output: 25, cacheRead: 0.5, cacheWrite: 6.25 },
+    "claude-opus-4.7": { input: 5, output: 25, cacheRead: 0.5, cacheWrite: 6.25 },
     "claude-opus-4.6": { input: 5, output: 25, cacheRead: 0.5, cacheWrite: 6.25 },
-    // Opus 4.5 (legacy): same pricing as Opus 4.6
     "claude-opus-4.5": { input: 5, output: 25, cacheRead: 0.5, cacheWrite: 6.25 },
-    // Sonnet 4.5: $3 input, $15 output (≤200K), cache write $3.75, cache read $0.30
+    // Sonnet 4.6/4.5: $3 input, $15 output, cache write $3.75, cache read $0.30
+    "claude-sonnet-4.6": { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 },
     "claude-sonnet-4.5": { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 },
-    // Sonnet 4: $3 input, $15 output
+    // Sonnet 4 (deprecated): $3 input, $15 output
     "claude-sonnet-4": { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 },
     // Haiku 4.5: $1 input, $5 output, cache write $1.25, cache read $0.10
     "claude-haiku-4.5": { input: 1, output: 5, cacheRead: 0.1, cacheWrite: 1.25 },
@@ -32,38 +34,63 @@ export const BUILTIN_PRICING = {
     "claude-opus-4.1": { input: 15, output: 75, cacheRead: 1.5, cacheWrite: 18.75 },
     "claude-opus-4": { input: 15, output: 75, cacheRead: 1.5, cacheWrite: 18.75 },
     "claude-haiku-3": { input: 0.25, output: 1.25, cacheRead: 0.03, cacheWrite: 0.3 },
-    // OpenAI GPT (https://openai.com/api/pricing/)
-    // GPT-5.2: $1.75 input, $14 output (flagship)
+    // OpenAI GPT (https://developers.openai.com/api/docs/pricing)
+    // GPT-5.5/5.4 standard short-context text pricing.
+    "gpt-5.5": { input: 5, output: 30, cacheRead: 0.5 },
+    "gpt-5.5-pro": { input: 30, output: 180 },
+    "gpt-5.4": { input: 2.5, output: 15, cacheRead: 0.25 },
+    "gpt-5.4-mini": { input: 0.75, output: 4.5, cacheRead: 0.075 },
+    "gpt-5.4-nano": { input: 0.2, output: 1.25, cacheRead: 0.02 },
+    "gpt-5.4-pro": { input: 30, output: 180 },
+    "gpt-5.3-codex": { input: 1.75, output: 14, cacheRead: 0.175 },
+    "gpt-5.3-chat-latest": { input: 1.75, output: 14, cacheRead: 0.175 },
+    // GPT-5.2 and earlier GPT-5 family.
     "gpt-5.2": { input: 1.75, output: 14, cacheRead: 0.175 },
     "gpt-5.2-pro": { input: 21, output: 168 },
     "gpt-5-mini": { input: 0.25, output: 2, cacheRead: 0.025 },
-    "gpt-5.1": { input: 2, output: 8 },
-    "gpt-5": { input: 5, output: 15 },
-    // GPT-4.1 series (fine-tuning prices, base may differ)
-    "gpt-4.1": { input: 3, output: 12, cacheRead: 0.75 },
-    "gpt-4.1-mini": { input: 0.8, output: 3.2, cacheRead: 0.2 },
-    "gpt-4.1-nano": { input: 0.2, output: 0.8, cacheRead: 0.05 },
+    "gpt-5-nano": { input: 0.05, output: 0.4, cacheRead: 0.005 },
+    "gpt-5.1": { input: 1.25, output: 10, cacheRead: 0.125 },
+    "gpt-5.1-chat-latest": { input: 1.25, output: 10, cacheRead: 0.125 },
+    "gpt-5.1-codex-max": { input: 1.25, output: 10, cacheRead: 0.125 },
+    "gpt-5.1-codex": { input: 1.25, output: 10, cacheRead: 0.125 },
+    "gpt-5.1-codex-mini": { input: 0.25, output: 2, cacheRead: 0.025 },
+    "gpt-5": { input: 1.25, output: 10, cacheRead: 0.125 },
+    "gpt-5-chat-latest": { input: 1.25, output: 10, cacheRead: 0.125 },
+    "gpt-5-codex": { input: 1.25, output: 10, cacheRead: 0.125 },
+    // GPT-4.1 series
+    "gpt-4.1": { input: 2, output: 8, cacheRead: 0.5 },
+    "gpt-4.1-mini": { input: 0.4, output: 1.6, cacheRead: 0.1 },
+    "gpt-4.1-nano": { input: 0.1, output: 0.4, cacheRead: 0.025 },
     // GPT-4o series (may be deprecated)
-    "gpt-4o": { input: 2.5, output: 10 },
-    "gpt-4o-mini": { input: 0.15, output: 0.6 },
+    "gpt-4o": { input: 2.5, output: 10, cacheRead: 1.25 },
+    "gpt-4o-mini": { input: 0.15, output: 0.6, cacheRead: 0.075 },
     // Reasoning models
-    "o3": { input: 10, output: 40 },
-    "o3-mini": { input: 1.1, output: 4.4 },
-    "o4-mini": { input: 4, output: 16, cacheRead: 1 },
-    "o1": { input: 15, output: 60 },
-    "o1-mini": { input: 1.1, output: 4.4 },
+    "o3": { input: 2, output: 8, cacheRead: 0.5 },
+    "o3-mini": { input: 1.1, output: 4.4, cacheRead: 0.55 },
+    "o4-mini": { input: 1.1, output: 4.4, cacheRead: 0.275 },
+    "o1": { input: 15, output: 60, cacheRead: 7.5 },
+    "o1-mini": { input: 1.1, output: 4.4, cacheRead: 0.55 },
     // DeepSeek (https://api-docs.deepseek.com/quick_start/pricing)
     // DeepSeek-V4 Flash compatibility pricing for deepseek-chat / deepseek-reasoner.
     // $0.14 input (cache miss), $0.0028 input (cache hit), $0.28 output
     "deepseek-chat": { input: 0.14, output: 0.28, cacheRead: 0.0028 },
     "deepseek-reasoner": { input: 0.14, output: 0.28, cacheRead: 0.0028 },
+    // DeepSeek-V4-Pro discounted pricing, current until 2026-05-31 15:59 UTC.
+    // $0.435 input (cache miss), $0.003625 input (cache hit), $0.87 output
+    "deepseek-v4-pro": { input: 0.435, output: 0.87, cacheRead: 0.003625 },
     // Google Gemini (https://cloud.google.com/vertex-ai/generative-ai/pricing)
-    // Gemini 3 Pro Preview: $2 input, $12 output (≤200K)
+    // Standard global text pricing at <=200K input tokens where tiered pricing applies.
+    // Gemini 3.1 Pro Preview: $2 input, $12 output, cache read $0.20
+    "gemini-3.1-pro-preview": { input: 2, output: 12, cacheRead: 0.2 },
     "gemini-3-pro": { input: 2, output: 12, cacheRead: 0.2 },
     "gemini-3-pro-preview": { input: 2, output: 12, cacheRead: 0.2 },
+    // Gemini 3.5 Flash: $1.50 input, $9 output, cache read $0.15
+    "gemini-3.5-flash": { input: 1.5, output: 9, cacheRead: 0.15 },
     // Gemini 3 Flash Preview: $0.5 input, $3 output
     "gemini-3-flash": { input: 0.5, output: 3, cacheRead: 0.05 },
     "gemini-3-flash-preview": { input: 0.5, output: 3, cacheRead: 0.05 },
+    // Gemini 3.1 Flash-Lite: $0.25 input, $1.50 output, cache read $0.025
+    "gemini-3.1-flash-lite": { input: 0.25, output: 1.5, cacheRead: 0.025 },
     // Gemini 2.5 Pro: $1.25 input, $10 output (≤200K)
     "gemini-2.5-pro": { input: 1.25, output: 10, cacheRead: 0.125 },
     // Gemini 2.5 Flash: $0.3 input, $2.5 output
@@ -99,6 +126,12 @@ export function formatTokens(tokens, millionDecimals = 1) {
         return `${(tokens / 1_000).toFixed(1)}K`;
     return tokens.toString();
 }
+export function hasBillableTokenUsage(usage) {
+    return (usage.input ?? 0) > 0
+        || (usage.output ?? 0) > 0
+        || (usage.cacheRead ?? 0) > 0
+        || (usage.cacheWrite ?? 0) > 0;
+}
 // ============================================================================
 // Time Utilities
 // ============================================================================
@@ -107,6 +140,12 @@ export function getStartOfDay(date = new Date()) {
     d.setHours(0, 0, 0, 0);
     return d.getTime();
 }
+export function formatLocalDateKey(date) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, "0");
+    const day = String(date.getDate()).padStart(2, "0");
+    return `${year}-${month}-${day}`;
+}
 export function getStartOfWeek(date = new Date()) {
     const d = new Date(date);
     const day = d.getDay();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-token-tracker",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "description": "Real-time token usage and cost tracking plugin for OpenCode with Toast notifications and CLI stats",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,7 +11,10 @@
   "scripts": {
     "build": "tsc",
     "test": "tsc && node --test dist/test/*.test.js",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "release:check": "node scripts/release.js check",
+    "release:prepare": "node scripts/release.js prepare",
+    "release:tag": "node scripts/release.js tag"
   },
   "keywords": [
     "opencode",