@ipv9/tokentracker-cli 0.39.4 → 0.39.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ipv9/tokentracker-cli",
-  "version": "0.39.4",
+  "version": "0.39.5",
   "description": "Local-first token and cost dashboard for 22 AI coding tools, including Claude Code, Codex, Cursor, Gemini, Kiro, OpenCode, OpenClaw, Copilot, Antigravity, Zed, and Goose.",
   "main": "src/cli.js",
   "bin": {

package/src/cli.js

@@ -13,7 +13,7 @@ async function run(argv) {
 
   // No args → launch dashboard
   if (!command) {
-    await cmdServe(argv);
+    await cmdServe(["--sync"]);
     return;
   }
 

package/src/commands/serve.js

@@ -6,6 +6,10 @@ const cp = require("node:child_process");
 
 const { resolveTrackerPaths } = require("../lib/tracker-paths");
 const { createLocalApiHandler, resolveQueuePath } = require("../lib/local-api");
+const {
+  buildServeDataPreflightMessage,
+  summarizeQueueData,
+} = require("../lib/local-data-preflight");
 const { ensurePricingLoaded } = require("../lib/pricing");
 const { serveStaticFile } = require("../lib/static-server");
 const { openInBrowser } = require("../lib/browser-auth");
@@ -50,11 +54,12 @@ async function cmdServe(argv) {
   }
 
   // 1. Optional sync
+  let syncSummary = null;
   if (opts.sync) {
     process.stdout.write("Syncing local data...\n");
     try {
       const { cmdSync } = require("./sync");
-      await cmdSync(["--auto"]);
+      syncSummary = await cmdSync(["--auto"]);
       process.stdout.write("Sync done.\n");
     } catch (e) {
       process.stdout.write(`Sync warning: ${e?.message || e}\n`);
@@ -65,6 +70,18 @@ async function cmdServe(argv) {
   const queuePath = resolveQueuePath();
   const dashboardDir = resolveDashboardDir();
 
+  if (opts.sync) {
+    try {
+      const queueSummary = await summarizeQueueData(queuePath);
+      const preflight = buildServeDataPreflightMessage({ queueSummary, syncSummary });
+      if (preflight?.message) {
+        process.stdout.write(`${preflight.message}\n`);
+      }
+    } catch (e) {
+      process.stdout.write(`Token data preflight warning: ${e?.message || e}\n`);
+    }
+  }
+
   // 2.1 Refresh LiteLLM pricing data in the background. The seed snapshot is
   //     already loaded synchronously at require-time, so cost calculation is
   //     functional right now; ensurePricingLoaded() only upgrades to fresh

package/src/commands/sync.js

@@ -992,57 +992,65 @@ async function cmdSync(argv) {
       }
     }
 
+    const totalParsed =
+      parseResult.filesProcessed +
+      openclawResult.filesProcessed +
+      claudeResult.filesProcessed +
+      geminiResult.filesProcessed +
+      antigravityResult.filesProcessed +
+      opencodeResult.filesProcessed +
+      cursorResult.recordsProcessed +
+      kiroResult.recordsProcessed +
+      kiroCliResult.recordsProcessed +
+      hermesResult.recordsProcessed +
+      kimiResult.recordsProcessed +
+      kimiCodeResult.recordsProcessed +
+      codebuddyResult.recordsProcessed +
+      ompResult.recordsProcessed +
+      piResult.recordsProcessed +
+      craftResult.recordsProcessed +
+      grokResult.recordsProcessed +
+      copilotResult.recordsProcessed +
+      kiloResult.messagesProcessed +
+      kilocodeResult.recordsProcessed +
+      roocodeResult.recordsProcessed +
+      zedResult.recordsProcessed +
+      gooseResult.recordsProcessed +
+      droidResult.recordsProcessed;
+    const totalBuckets =
+      parseResult.bucketsQueued +
+      openclawResult.bucketsQueued +
+      claudeResult.bucketsQueued +
+      geminiResult.bucketsQueued +
+      antigravityResult.bucketsQueued +
+      opencodeResult.bucketsQueued +
+      cursorResult.bucketsQueued +
+      kiroResult.bucketsQueued +
+      kiroCliResult.bucketsQueued +
+      hermesResult.bucketsQueued +
+      kimiResult.bucketsQueued +
+      kimiCodeResult.bucketsQueued +
+      codebuddyResult.bucketsQueued +
+      ompResult.bucketsQueued +
+      piResult.bucketsQueued +
+      craftResult.bucketsQueued +
+      grokResult.bucketsQueued +
+      copilotResult.bucketsQueued +
+      kiloResult.bucketsQueued +
+      kilocodeResult.bucketsQueued +
+      roocodeResult.bucketsQueued +
+      zedResult.bucketsQueued +
+      gooseResult.bucketsQueued +
+      droidResult.bucketsQueued;
+    const summary = {
+      totalParsed,
+      totalBuckets,
+      upload: uploadResult,
+      uploadAttempted,
+      pendingBytes,
+    };
+
     if (!opts.auto) {
-      const totalParsed =
-        parseResult.filesProcessed +
-        openclawResult.filesProcessed +
-        claudeResult.filesProcessed +
-        geminiResult.filesProcessed +
-        antigravityResult.filesProcessed +
-        opencodeResult.filesProcessed +
-        cursorResult.recordsProcessed +
-        kiroResult.recordsProcessed +
-        kiroCliResult.recordsProcessed +
-        hermesResult.recordsProcessed +
-        kimiResult.recordsProcessed +
-        kimiCodeResult.recordsProcessed +
-        codebuddyResult.recordsProcessed +
-        ompResult.recordsProcessed +
-        piResult.recordsProcessed +
-        craftResult.recordsProcessed +
-        grokResult.recordsProcessed +
-        copilotResult.recordsProcessed +
-        kiloResult.messagesProcessed +
-        kilocodeResult.recordsProcessed +
-        roocodeResult.recordsProcessed +
-        zedResult.recordsProcessed +
-        gooseResult.recordsProcessed +
-        droidResult.recordsProcessed;
-      const totalBuckets =
-        parseResult.bucketsQueued +
-        openclawResult.bucketsQueued +
-        claudeResult.bucketsQueued +
-        geminiResult.bucketsQueued +
-        antigravityResult.bucketsQueued +
-        opencodeResult.bucketsQueued +
-        cursorResult.bucketsQueued +
-        kiroResult.bucketsQueued +
-        kiroCliResult.bucketsQueued +
-        hermesResult.bucketsQueued +
-        kimiResult.bucketsQueued +
-        kimiCodeResult.bucketsQueued +
-        codebuddyResult.bucketsQueued +
-        ompResult.bucketsQueued +
-        piResult.bucketsQueued +
-        craftResult.bucketsQueued +
-        grokResult.bucketsQueued +
-        copilotResult.bucketsQueued +
-        kiloResult.bucketsQueued +
-        kilocodeResult.bucketsQueued +
-        roocodeResult.bucketsQueued +
-        zedResult.bucketsQueued +
-        gooseResult.bucketsQueued +
-        droidResult.bucketsQueued;
       process.stdout.write(
         [
           "Sync finished:",
@@ -1060,6 +1068,7 @@ async function cmdSync(argv) {
           .join("\n"),
       );
     }
+    return summary;
   } finally {
     progress?.stop();
     await lock.release();

package/src/lib/local-data-preflight.js

@@ -0,0 +1,88 @@
+const fs = require("node:fs/promises");
+
+async function summarizeQueueData(queuePath) {
+  const raw = await fs.readFile(queuePath, "utf8").catch((error) => {
+    if (error?.code === "ENOENT") return "";
+    throw error;
+  });
+  const rowsByBucket = new Map();
+  let malformedLines = 0;
+  let lineCount = 0;
+
+  for (const line of raw.split("\n")) {
+    if (!line.trim()) continue;
+    lineCount += 1;
+    let row;
+    try {
+      row = JSON.parse(line);
+    } catch (_error) {
+      malformedLines += 1;
+      continue;
+    }
+    const hourStart = typeof row?.hour_start === "string" ? row.hour_start : "";
+    if (!hourStart) continue;
+    const source = typeof row?.source === "string" && row.source.trim() ? row.source.trim() : "codex";
+    const model = typeof row?.model === "string" && row.model.trim() ? row.model.trim() : "unknown";
+    rowsByBucket.set(`${source}|${model}|${hourStart}`, row);
+  }
+
+  let totalTokens = 0;
+  let billableTotalTokens = 0;
+  const sources = new Set();
+  for (const row of rowsByBucket.values()) {
+    totalTokens += Number(row?.total_tokens || 0);
+    billableTotalTokens += Number(row?.billable_total_tokens ?? row?.total_tokens ?? 0);
+    if (typeof row?.source === "string" && row.source.trim()) {
+      sources.add(row.source.trim());
+    }
+  }
+
+  return {
+    queuePath,
+    lineCount,
+    malformedLines,
+    bucketCount: rowsByBucket.size,
+    totalTokens,
+    billableTotalTokens,
+    sources: Array.from(sources).sort(),
+  };
+}
+
+function buildServeDataPreflightMessage({ queueSummary, syncSummary } = {}) {
+  const totalTokens = Number(queueSummary?.totalTokens || 0);
+  const parsedFiles = Number(syncSummary?.totalParsed || 0);
+  const queuedBuckets = Number(syncSummary?.totalBuckets || 0);
+
+  if (totalTokens > 0) {
+    const sources = Array.isArray(queueSummary?.sources) ? queueSummary.sources : [];
+    return {
+      status: "ok",
+      message: `Token data preflight: ${queueSummary.bucketCount} buckets, ${totalTokens.toLocaleString()} tokens${sources.length ? ` (${sources.join(", ")})` : ""}.`,
+    };
+  }
+
+  if (parsedFiles > 0 || queuedBuckets > 0 || Number(queueSummary?.lineCount || 0) > 0) {
+    return {
+      status: "warn",
+      message: [
+        "Token data preflight warning: local data was parsed, but the dashboard queue still has 0 tokens.",
+        `Parsed files: ${parsedFiles}; new buckets: ${queuedBuckets}; queue rows: ${queueSummary?.lineCount || 0}.`,
+        "Run `tokentracker status --light` or `tokentracker doctor` on this machine to check readable tool logs and hook state.",
+      ].join("\n"),
+    };
+  }
+
+  return {
+    status: "warn",
+    message: [
+      "Token data preflight warning: no local token data was found after sync.",
+      "The dashboard can open, but Total tokens will stay empty until this machine has readable AI tool session logs.",
+      "Run `tokentracker status --light` or `tokentracker doctor` on this machine to see which providers are configured or skipped.",
+    ].join("\n"),
+  };
+}
+
+module.exports = {
+  summarizeQueueData,
+  buildServeDataPreflightMessage,
+};