token-rats 0.0.3 → 0.0.4

package/dist/index.js

@@ -4279,7 +4279,11 @@ var ENDPOINTS = {
   stripeWebhook: "/webhooks/stripe",
   // Phase 3 Track M
   proxyAnthropicMessages: "/v1/proxy/anthropic/v1/messages",
-  proxyAnthropicKey: "/v1/proxy/keys/anthropic"
+  proxyAnthropicKey: "/v1/proxy/keys/anthropic",
+  // Admin analytics (project-owner only)
+  adminSignups: "/v1/admin/signups",
+  adminActivity: "/v1/admin/activity",
+  adminReferrers: "/v1/admin/referrers"
 };
 
 // ../contracts/src/errors.ts
@@ -4337,6 +4341,48 @@ var LiveEvent = z.discriminatedUnion("kind", [
   })
 ]);
 
+// ../contracts/src/admin.ts
+var AdminSignupsDay = z.object({
+  day: z.string(),
+  // YYYY-MM-DD UTC
+  /** Newly created users on this day. */
+  newUsers: z.number().int().nonnegative(),
+  /** Running total of users created up to and including this day. */
+  cumulative: z.number().int().nonnegative()
+});
+var AdminSignupsResponse = z.object({
+  totalUsers: z.number().int().nonnegative(),
+  /** Length = 30, ordered oldest -> newest. */
+  series: z.array(AdminSignupsDay),
+  generatedAt: z.number().int().positive()
+});
+var AdminActivityDay = z.object({
+  day: z.string(),
+  // YYYY-MM-DD UTC
+  activeUsers: z.number().int().nonnegative()
+});
+var AdminActivityResponse = z.object({
+  /** Length = 30, ordered oldest -> newest. */
+  series: z.array(AdminActivityDay),
+  /** Distinct users active in the full 30-day window. */
+  activeUsers30d: z.number().int().nonnegative(),
+  generatedAt: z.number().int().positive()
+});
+var AdminReferrerRow = z.object({
+  /** A label describing the source of the signal. */
+  label: z.string(),
+  /** Number of users (or events) attributed to this label. */
+  count: z.number().int().nonnegative()
+});
+var AdminReferrersResponse = z.object({
+  /** True iff a real referral attribution column / table exists. */
+  tracked: z.boolean(),
+  /** Description of what `rows` represents (e.g. "First CLI source"). */
+  signal: z.string(),
+  rows: z.array(AdminReferrerRow),
+  generatedAt: z.number().int().positive()
+});
+
 // src/lib/api.ts
 var DEFAULT_API_URL = "https://api.tokenrats.com";
 function isTransient(status) {
@@ -4366,7 +4412,7 @@ var ApiClient = class {
   headers() {
     const h = { "Content-Type": "application/json" };
     if (this.token) {
-      h["Authorization"] = `Bearer ${this.token}`;
+      h.Authorization = `Bearer ${this.token}`;
     }
     return h;
   }
@@ -4386,7 +4432,7 @@ var ApiClient = class {
       }
       attempt++;
       if (attempt <= maxRetries) {
-        await sleep(1e3 * Math.pow(2, attempt - 1));
+        await sleep(1e3 * 2 ** (attempt - 1));
       }
     }
     throw lastErr;
@@ -4453,7 +4499,7 @@ import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
 function tokenDir() {
-  const xdgConfig = process.env["XDG_CONFIG_HOME"];
+  const xdgConfig = process.env.XDG_CONFIG_HOME;
   const base = xdgConfig ?? path.join(os.homedir(), ".config");
   return path.join(base, "token-rats");
 }
@@ -4592,7 +4638,7 @@ async function loginCommand(opts) {
   const codeMatch = verificationUrl.match(/[?&]code=([A-Z0-9-]+)/);
   const code = codeMatch?.[1] ?? "";
   console.log("");
-  console.log(`  Open this URL to sign in:`);
+  console.log("  Open this URL to sign in:");
   console.log(`  \x1B[1m\x1B[36m${verificationUrl}\x1B[0m`);
   if (code) {
     console.log(`  Code: \x1B[1m${code}\x1B[0m`);
@@ -4745,13 +4791,13 @@ function parseClaudeCode(input) {
     }
     if (typeof event !== "object" || event === null) continue;
     const ev = event;
-    const sidCamel = ev["sessionId"];
-    const sidSnake = ev["session_id"];
+    const sidCamel = ev.sessionId;
+    const sidSnake = ev.session_id;
     const sessionId = typeof sidCamel === "string" ? sidCamel : typeof sidSnake === "string" ? sidSnake : null;
     if (!sessionId) continue;
-    const rawTs = ev["timestamp"];
+    const rawTs = ev.timestamp;
     let timestamp = 0;
-    if (typeof rawTs === "number" && isFinite(rawTs)) {
+    if (typeof rawTs === "number" && Number.isFinite(rawTs)) {
       timestamp = rawTs;
     } else if (typeof rawTs === "string") {
       const parsed = Date.parse(rawTs);
@@ -4773,18 +4819,18 @@ function parseClaudeCode(input) {
       if (acc.startedAt === 0 || timestamp < acc.startedAt) acc.startedAt = timestamp;
       if (timestamp > acc.endedAt) acc.endedAt = timestamp;
     }
-    if (ev["type"] !== "assistant") continue;
-    const message = ev["message"];
+    if (ev.type !== "assistant") continue;
+    const message = ev.message;
     if (typeof message !== "object" || message === null) continue;
     const msg = message;
-    if (typeof msg["model"] === "string" && msg["model"].length > 0) {
-      acc.model = msg["model"];
+    if (typeof msg.model === "string" && msg.model.length > 0) {
+      acc.model = msg.model;
     }
-    const usage = msg["usage"];
+    const usage = msg.usage;
     if (typeof usage === "object" && usage !== null) {
       const u = usage;
-      const inputTokens = toNonNegInt(u["input_tokens"]);
-      const outputTokens = toNonNegInt(u["output_tokens"]);
+      const inputTokens = toNonNegInt(u.input_tokens);
+      const outputTokens = toNonNegInt(u.output_tokens);
       acc.inTokens += inputTokens;
       acc.outTokens += outputTokens;
     }
@@ -4818,7 +4864,7 @@ function parseClaudeCode(input) {
   return results;
 }
 function toNonNegInt(v) {
-  if (typeof v !== "number" || !isFinite(v)) return 0;
+  if (typeof v !== "number" || !Number.isFinite(v)) return 0;
   return Math.max(0, Math.floor(v));
 }
 
@@ -4843,14 +4889,14 @@ function parseCodex(input) {
     }
     if (typeof event !== "object" || event === null) continue;
     const ev = event;
-    const ts = parseTimestamp(ev["timestamp"]);
-    const type = typeof ev["type"] === "string" ? ev["type"] : null;
-    const payload = typeof ev["payload"] === "object" && ev["payload"] !== null ? ev["payload"] : null;
+    const ts = parseTimestamp(ev.timestamp);
+    const type = typeof ev.type === "string" ? ev.type : null;
+    const payload = typeof ev.payload === "object" && ev.payload !== null ? ev.payload : null;
     if (type === "session_meta" && payload) {
-      const id = typeof payload["id"] === "string" ? payload["id"] : null;
+      const id = typeof payload.id === "string" ? payload.id : null;
       if (!id) continue;
       currentSessionId = id;
-      const metaTs = parseTimestamp(payload["timestamp"]) || ts;
+      const metaTs = parseTimestamp(payload.timestamp) || ts;
       const acc2 = upsert(sessions, id);
       if (metaTs > 0 && (acc2.startedAt === 0 || metaTs < acc2.startedAt)) {
         acc2.startedAt = metaTs;
@@ -4864,20 +4910,20 @@ function parseCodex(input) {
       if (acc.startedAt === 0) acc.startedAt = ts;
       if (ts > acc.endedAt) acc.endedAt = ts;
     }
-    if (type === "turn_context" && payload && typeof payload["model"] === "string") {
-      acc.model = payload["model"];
+    if (type === "turn_context" && payload && typeof payload.model === "string") {
+      acc.model = payload.model;
       continue;
     }
-    if (type === "event_msg" && payload && payload["type"] === "token_count") {
-      const info2 = payload["info"];
+    if (type === "event_msg" && payload && payload.type === "token_count") {
+      const info2 = payload.info;
       if (typeof info2 !== "object" || info2 === null) continue;
-      const total = info2["total_token_usage"];
+      const total = info2.total_token_usage;
       if (typeof total !== "object" || total === null) continue;
       const t = total;
-      const inputTotal = toNonNegInt2(t["input_tokens"]);
-      const cachedInput = toNonNegInt2(t["cached_input_tokens"]);
-      const output = toNonNegInt2(t["output_tokens"]);
-      const reasoning = toNonNegInt2(t["reasoning_output_tokens"]);
+      const inputTotal = toNonNegInt2(t.input_tokens);
+      const cachedInput = toNonNegInt2(t.cached_input_tokens);
+      const output = toNonNegInt2(t.output_tokens);
+      const reasoning = toNonNegInt2(t.reasoning_output_tokens);
       acc.inTokens = Math.max(0, inputTotal - cachedInput);
       acc.outTokens = output + reasoning;
     }
@@ -4889,13 +4935,7 @@ function parseCodex(input) {
     if (startedAt <= 0 || endedAt <= 0) continue;
     const model = acc.model.length > 0 ? acc.model : "unknown";
     const { costUsdCents } = priceOf(model, acc.inTokens, acc.outTokens);
-    const dedupeKey = computeDedupeKey(
-      "codex",
-      model,
-      startedAt,
-      acc.inTokens,
-      acc.outTokens
-    );
+    const dedupeKey = computeDedupeKey("codex", model, startedAt, acc.inTokens, acc.outTokens);
     results.push({
       id: `codex:${acc.sessionId}`,
       source: "codex",
@@ -4926,7 +4966,7 @@ function upsert(map, sessionId) {
   return acc;
 }
 function parseTimestamp(v) {
-  if (typeof v === "number" && isFinite(v)) return v;
+  if (typeof v === "number" && Number.isFinite(v)) return v;
   if (typeof v === "string") {
     const parsed = Date.parse(v);
     if (!Number.isNaN(parsed)) return parsed;
@@ -4934,26 +4974,21 @@ function parseTimestamp(v) {
   return 0;
 }
 function toNonNegInt2(v) {
-  if (typeof v !== "number" || !isFinite(v)) return 0;
+  if (typeof v !== "number" || !Number.isFinite(v)) return 0;
   return Math.max(0, Math.floor(v));
 }
 
 // ../parsers/src/cursor.ts
-var CURSOR_MODEL_MAP = {
-  // Claude models — Cursor uses abbreviated names without date suffixes
-  "claude-3.5-sonnet": "claude-3-5-sonnet-20241022",
-  "claude-3-5-sonnet": "claude-3-5-sonnet-20241022",
-  "claude-3.5-haiku": "claude-3-5-haiku-20241022",
-  "claude-3-5-haiku": "claude-3-5-haiku-20241022",
-  "claude-3.5-opus": "claude-3-opus-20240229",
-  "claude-3-opus": "claude-3-opus-20240229",
-  "claude-3-sonnet": "claude-3-sonnet-20240229",
-  "claude-3-haiku": "claude-3-haiku-20240307",
-  // GPT models — Cursor may omit date suffixes
-  "gpt-4o-mini": "gpt-4o-mini",
-  "gpt-4o": "gpt-4o",
-  "gpt-4-turbo": "gpt-4-turbo"
+var ESTIMATES = {
+  composer: { inTokens: 1e4, outTokens: 2e3, model: "cursor-composer" }
+  // "tab" deliberately omitted — see file header.
 };
+var INPUT_USD_PER_MTOK = 3;
+var OUTPUT_USD_PER_MTOK = 15;
+function estimatedCostCents(inTokens, outTokens) {
+  const dollars = inTokens / 1e6 * INPUT_USD_PER_MTOK + outTokens / 1e6 * OUTPUT_USD_PER_MTOK;
+  return Math.round(dollars * 100);
+}
 function parseCursor(input) {
   let text;
   if (typeof input === "string") {
@@ -4974,15 +5009,15 @@ function parseCursor(input) {
     const row = raw;
     const id = typeof row["id"] === "string" ? row["id"] : null;
     if (!id) continue;
-    const rawModel = typeof row["model"] === "string" ? row["model"] : "";
-    const model = rawModel.length > 0 ? CURSOR_MODEL_MAP[rawModel] ?? rawModel : "unknown";
-    const inTokens = toNonNegInt3(row["promptTokens"]);
-    const outTokens = toNonNegInt3(row["completionTokens"]);
-    const startedAt = typeof row["startedAt"] === "number" && isFinite(row["startedAt"]) && row["startedAt"] > 0 ? row["startedAt"] : null;
-    const endedAt = typeof row["endedAt"] === "number" && isFinite(row["endedAt"]) && row["endedAt"] > 0 ? row["endedAt"] : null;
-    if (startedAt === null || endedAt === null) continue;
-    const { costUsdCents } = priceOf(model, inTokens, outTokens);
-    const dedupeKey = computeDedupeKey("cursor", model, startedAt, inTokens, outTokens);
+    const type = typeof row["type"] === "string" ? row["type"] : null;
+    if (!type) continue;
+    const unixMs = typeof row["unixMs"] === "number" && isFinite(row["unixMs"]) && row["unixMs"] > 0 ? row["unixMs"] : null;
+    if (unixMs === null) continue;
+    const estimate = ESTIMATES[type];
+    if (!estimate) continue;
+    const { inTokens, outTokens, model } = estimate;
+    const costUsdCents = estimatedCostCents(inTokens, outTokens);
+    const dedupeKey = computeDedupeKey("cursor", model, unixMs, inTokens, outTokens);
     results.push({
       id: `cursor:${id}`,
       source: "cursor",
@@ -4990,169 +5025,167 @@ function parseCursor(input) {
       inTokens,
       outTokens,
       costUsdCents,
-      startedAt,
-      endedAt,
+      startedAt: unixMs,
+      endedAt: unixMs,
       dedupeKey
     });
   }
   return results;
 }
-function toNonNegInt3(v) {
-  if (typeof v !== "number" || !isFinite(v)) return 0;
-  return Math.max(0, Math.floor(v));
-}
 
 // src/lib/cursor-extract.ts
+import { existsSync, readdirSync } from "node:fs";
 import { readFile } from "node:fs/promises";
-async function tryNodeSqlite(dbPath) {
-  let DatabaseConstructor;
-  try {
-    const mod = await import("node:sqlite");
-    DatabaseConstructor = mod.DatabaseSync;
-    if (!DatabaseConstructor) return null;
-  } catch {
-    return null;
+import { homedir as homedir2 } from "node:os";
+import { join as join2 } from "node:path";
+function cursorWorkspaceStorageDir() {
+  const home = homedir2();
+  const rel = join2("Cursor", "User", "workspaceStorage");
+  if (process.platform === "darwin") {
+    return join2(home, "Library", "Application Support", rel);
+  }
+  if (process.platform === "win32") {
+    const appData = process.env["APPDATA"] ?? join2(home, "AppData", "Roaming");
+    return join2(appData, rel);
+  }
+  const xdgConfig = process.env["XDG_CONFIG_HOME"] ?? join2(home, ".config");
+  return join2(xdgConfig, rel);
+}
+function discoverWorkspaceDbs() {
+  const root = cursorWorkspaceStorageDir();
+  if (!existsSync(root)) return [];
+  const out = [];
+  for (const entry of readdirSync(root, { withFileTypes: true })) {
+    if (!entry.isDirectory()) continue;
+    const candidate = join2(root, entry.name, "state.vscdb");
+    if (existsSync(candidate)) out.push(candidate);
   }
-  return readWithDb(() => new DatabaseConstructor(dbPath, { readOnly: true }));
+  return out;
 }
-async function trySqlJs(dbPath) {
-  let initSqlJs;
+async function openDb(dbPath) {
   try {
-    const mod = await import("sql.js");
-    initSqlJs = mod.default ?? mod;
+    const mod = await import("node:sqlite");
+    const DatabaseSync = mod.DatabaseSync;
+    if (DatabaseSync) {
+      const db = new DatabaseSync(dbPath, { readOnly: true });
+      return {
+        exec: (sql) => {
+          const stmt = db.prepare(sql);
+          const rows = stmt.all();
+          if (rows.length === 0) return [];
+          const columns = Object.keys(rows[0]);
+          return [
+            {
+              columns,
+              values: rows.map((r) => columns.map((c2) => r[c2]))
+            }
+          ];
+        },
+        close: () => db.close()
+      };
+    }
   } catch {
-    return null;
   }
-  let SQL;
-  let fileBytes;
   try {
-    SQL = await initSqlJs();
-    fileBytes = await readFile(dbPath);
+    const sqlJs = await import("sql.js");
+    const initSqlJs = sqlJs.default ?? sqlJs;
+    const SQL = await initSqlJs();
+    const bytes = await readFile(dbPath);
+    return new SQL.Database(new Uint8Array(bytes));
   } catch {
-    return null;
   }
-  const sqlDb = new SQL.Database(new Uint8Array(fileBytes));
-  const adapter = {
-    prepare: (sql) => ({
-      all: () => {
-        const results = sqlDb.exec(sql);
-        if (results.length === 0) return [];
-        const { columns, values } = results[0];
-        return values.map((row) => {
-          const obj = {};
-          for (let i = 0; i < columns.length; i++) {
-            obj[columns[i]] = row[i];
-          }
-          return obj;
-        });
-      }
-    }),
-    close: () => sqlDb.close()
-  };
-  return readWithDb(() => adapter);
-}
-async function tryBetterSqlite3(dbPath) {
-  let Database;
   try {
     const mod = await import("better-sqlite3");
-    Database = mod.default ?? mod;
+    const Database = mod.default ?? mod;
+    const db = new Database(dbPath, { readonly: true, fileMustExist: true });
+    return {
+      exec: (sql) => {
+        const stmt = db.prepare(sql);
+        const rows = stmt.all();
+        if (rows.length === 0) return [];
+        const columns = Object.keys(rows[0]);
+        return [
+          {
+            columns,
+            values: rows.map((r) => columns.map((c2) => r[c2]))
+          }
+        ];
+      },
+      close: () => db.close()
+    };
   } catch {
     return null;
   }
-  return readWithDb(() => new Database(dbPath, { readonly: true, fileMustExist: true }));
 }
-function readWithDb(factory) {
-  let db = null;
+async function readGenerationsFromDb(dbPath) {
+  const db = await openDb(dbPath);
+  if (!db) return [];
   try {
-    db = factory();
-    const rows = tryItemTable(db) ?? tryDirectTable(db) ?? [];
-    return rows;
+    const res = db.exec(`SELECT value FROM ItemTable WHERE key = 'aiService.generations'`);
+    if (res.length === 0 || res[0].values.length === 0) return [];
+    const raw = res[0].values[0][0];
+    if (typeof raw !== "string") return [];
+    let parsed;
+    try {
+      parsed = JSON.parse(raw);
+    } catch {
+      return [];
+    }
+    if (!Array.isArray(parsed)) return [];
+    const out = [];
+    for (const item of parsed) {
+      if (typeof item !== "object" || item === null) continue;
+      const r = item;
+      const id = typeof r["generationUUID"] === "string" ? r["generationUUID"] : null;
+      const type = typeof r["type"] === "string" ? r["type"] : null;
+      const unixMs = typeof r["unixMs"] === "number" && isFinite(r["unixMs"]) && r["unixMs"] > 0 ? r["unixMs"] : null;
+      if (!id || !type || unixMs === null) continue;
+      out.push({ id, type, unixMs });
+    }
+    return out;
   } catch {
-    return null;
+    return [];
   } finally {
     try {
-      db?.close();
+      db.close();
     } catch {
     }
   }
 }
-function tryItemTable(db) {
-  try {
-    const stmt = db.prepare("SELECT value FROM ItemTable WHERE key = 'aiRequests'");
-    const rows = stmt.all();
-    if (rows.length === 0) return null;
-    const raw = rows[0]?.value;
-    if (typeof raw !== "string") return null;
-    let parsed;
+async function extractCursorGenerations() {
+  const dbPaths = discoverWorkspaceDbs();
+  if (dbPaths.length === 0) {
+    return {
+      rows: [],
+      skipped: null,
+      dbCount: 0
+    };
+  }
+  const seen2 = /* @__PURE__ */ new Set();
+  const rows = [];
+  let openFailures = 0;
+  for (const p of dbPaths) {
+    let perDb = [];
     try {
-      parsed = JSON.parse(raw);
+      perDb = await readGenerationsFromDb(p);
     } catch {
-      return null;
+      openFailures++;
+      continue;
+    }
+    for (const r of perDb) {
+      if (seen2.has(r.id)) continue;
+      seen2.add(r.id);
+      rows.push(r);
     }
-    if (!Array.isArray(parsed)) return null;
-    return normalizeRows(parsed);
-  } catch {
-    return null;
-  }
-}
-function tryDirectTable(db) {
-  try {
-    const stmt = db.prepare(
-      `SELECT id, model,
-              prompt_tokens as promptTokens, completion_tokens as completionTokens,
-              started_at as startedAt, ended_at as endedAt
-       FROM cursor_requests
-       ORDER BY started_at DESC
-       LIMIT 50000`
-    );
-    const rows = stmt.all();
-    return normalizeRows(rows);
-  } catch {
-    return null;
-  }
-}
-function normalizeRows(rows) {
-  const results = [];
-  for (const raw of rows) {
-    if (typeof raw !== "object" || raw === null) continue;
-    const r = raw;
-    const id = typeof r["id"] === "string" ? r["id"] : null;
-    if (!id) continue;
-    const model = typeof r["model"] === "string" ? r["model"] : "unknown";
-    const promptTokens = toNonNegInt4(r["promptTokens"] ?? r["prompt_tokens"]);
-    const completionTokens = toNonNegInt4(r["completionTokens"] ?? r["completion_tokens"]);
-    const startedAt = toPositiveMs(r["startedAt"] ?? r["started_at"]);
-    const endedAt = toPositiveMs(r["endedAt"] ?? r["ended_at"]);
-    if (startedAt === null || endedAt === null) continue;
-    results.push({ id, model, promptTokens, completionTokens, startedAt, endedAt });
-  }
-  return results;
-}
-function toNonNegInt4(v) {
-  if (typeof v !== "number" || !isFinite(v)) return 0;
-  return Math.max(0, Math.floor(v));
-}
-function toPositiveMs(v) {
-  if (typeof v !== "number" || !isFinite(v) || v <= 0) return null;
-  return v;
-}
-async function readCursorDb(dbPath) {
-  const fromNodeSqlite = await tryNodeSqlite(dbPath);
-  if (fromNodeSqlite !== null) {
-    return { rows: fromNodeSqlite, skipped: null };
-  }
-  const fromSqlJs = await trySqlJs(dbPath);
-  if (fromSqlJs !== null) {
-    return { rows: fromSqlJs, skipped: null };
   }
-  const fromBetter = await tryBetterSqlite3(dbPath);
-  if (fromBetter !== null) {
-    return { rows: fromBetter, skipped: null };
+  if (rows.length === 0 && openFailures === dbPaths.length) {
+    return {
+      rows: [],
+      dbCount: dbPaths.length,
+      skipped: "Could not open any Cursor workspace DB (sqlite drivers unavailable). Run `npx token-rats install-cursor` for native speed, or upgrade to Node \u226522.5."
+    };
   }
-  return {
-    rows: [],
-    skipped: "Could not open Cursor DB (sqlite drivers unavailable). Run `npx token-rats install-cursor` for native speed, or upgrade to Node \u226522.5."
-  };
+  return { rows, dbCount: dbPaths.length, skipped: null };
 }
 
 // src/lib/discover.ts
@@ -5176,7 +5209,7 @@ function findJsonlFiles(dir) {
 function claudeCodeProjectsDir() {
   const home = os2.homedir();
   if (process.platform === "win32") {
-    const profile = process.env["USERPROFILE"] ?? home;
+    const profile = process.env.USERPROFILE ?? home;
     return path2.join(profile, ".claude", "projects");
   }
   return path2.join(home, ".claude", "projects");
@@ -5189,9 +5222,9 @@ function codexSessionsDirs() {
   const home = os2.homedir();
   const candidates = [];
   if (process.platform === "win32") {
-    const profile = process.env["USERPROFILE"] ?? home;
+    const profile = process.env.USERPROFILE ?? home;
     candidates.push(path2.join(profile, ".codex", "sessions"));
-    const appData = process.env["APPDATA"] ?? path2.join(profile, "AppData", "Roaming");
+    const appData = process.env.APPDATA ?? path2.join(profile, "AppData", "Roaming");
     candidates.push(path2.join(appData, "Codex", "sessions"));
   } else {
     candidates.push(path2.join(home, ".codex", "sessions"));
@@ -5225,23 +5258,6 @@ function discoverCodexFiles() {
   }
   return out;
 }
-function cursorDbPath() {
-  const home = os2.homedir();
-  const rel = path2.join("Cursor", "User", "globalStorage", "state.vscdb");
-  if (process.platform === "darwin") {
-    return path2.join(home, "Library", "Application Support", rel);
-  }
-  if (process.platform === "win32") {
-    const appData = process.env["APPDATA"] ?? path2.join(home, "AppData", "Roaming");
-    return path2.join(appData, rel);
-  }
-  const xdgConfig = process.env["XDG_CONFIG_HOME"] ?? path2.join(home, ".config");
-  return path2.join(xdgConfig, rel);
-}
-function discoverCursorDb() {
-  const p = cursorDbPath();
-  return fs2.existsSync(p) ? p : null;
-}
 
 // src/commands/sync.ts
 var BATCH_SIZE = 500;
@@ -5333,25 +5349,26 @@ async function syncCommand(opts) {
     }
   }
   const cursorSessions = [];
-  const cursorDbPath2 = discoverCursorDb();
-  if (cursorDbPath2) {
-    if (opts.verbose) info(`Found Cursor DB at ${cursorDbPath2}`);
-    const { rows, skipped } = await readCursorDb(cursorDbPath2);
-    if (skipped) {
-      warn(skipped);
-    } else if (rows.length > 0) {
-      try {
-        const records = parseCursor(JSON.stringify(rows));
-        cursorSessions.push(...records);
-        if (opts.verbose) dim(`  Cursor DB: ${records.length} session(s)`);
-      } catch {
-        if (opts.verbose) warn("Failed to parse Cursor rows \u2014 skipping");
+  const { rows, skipped, dbCount } = await extractCursorGenerations();
+  if (skipped) {
+    warn(skipped);
+  } else if (dbCount === 0) {
+    if (opts.verbose) info("No Cursor workspace storage found \u2014 skipping Cursor source");
+  } else if (rows.length > 0) {
+    if (opts.verbose) info(`Scanned ${dbCount} Cursor workspace DB(s)`);
+    try {
+      const records = parseCursor(JSON.stringify(rows));
+      cursorSessions.push(...records);
+      if (opts.verbose) {
+        dim(
+          `  Cursor: ${rows.length} generation event(s) \u2192 ${records.length} session(s) (tokens estimated, see help)`
+        );
       }
-    } else if (opts.verbose) {
-      dim("  Cursor DB: 0 rows found");
+    } catch {
+      if (opts.verbose) warn("Failed to parse Cursor rows \u2014 skipping");
     }
-  } else {
-    if (opts.verbose) info("Cursor DB not found \u2014 skipping Cursor source");
+  } else if (opts.verbose) {
+    dim(`  Scanned ${dbCount} Cursor workspace DB(s): no AI generations found`);
   }
   const mergedClaude = mergeBySessionId(claudeSessions);
   if (opts.verbose && mergedClaude.length !== claudeSessions.length) {
@@ -5525,7 +5542,9 @@ async function watchCommand(opts) {
   }, debounceMs);
   let cleanup = null;
   try {
-    const chokidar = await new Function("m", "return import(m)")("chokidar");
+    const chokidar = await new Function("m", "return import(m)")(
+      "chokidar"
+    );
     const watcher = chokidar.watch(`${dir}/**/*.jsonl`, {
       ignoreInitial: true,
       persistent: true,
@@ -5577,7 +5596,7 @@ async function watchCommand(opts) {
           const watcher = watch(dir, { recursive: true, signal: controller.signal });
           for await (const event of watcher) {
             const filename = event.filename;
-            if (filename && filename.endsWith(".jsonl")) {
+            if (filename?.endsWith(".jsonl")) {
               const fullPath = `${dir}/${filename}`;
               onChanged(fullPath);
             }
@@ -5623,7 +5642,7 @@ async function whoamiCommand(opts) {
 
 // src/index.ts
 function getVersion() {
-  return "0.0.3";
+  return "0.0.4";
 }
 function printHelp() {
   console.log(`
@@ -5658,6 +5677,12 @@ function printHelp() {
   The parser source is in packages/parsers/. We literally can't read
   what you typed.
 
+\x1B[1mCursor notes:\x1B[0m
+  Cursor doesn't store token counts locally, so per-request tokens
+  are *estimated* (10k in / 2k out per composer turn, claude-3-5-sonnet
+  rates). Tab autocomplete is excluded. Numbers are comparable across
+  Token Rats users but won't match cursor.com to the token.
+
 \x1B[1mExamples:\x1B[0m
   npx token-rats login
   npx token-rats sync
@@ -5729,7 +5754,7 @@ async function main() {
       break;
     default:
       console.error(`\x1B[31mUnknown command: ${command}\x1B[0m`);
-      console.error(`Run \x1B[1mtoken-rats help\x1B[0m for a list of commands.`);
+      console.error("Run \x1B[1mtoken-rats help\x1B[0m for a list of commands.");
       process.exit(1);
   }
 }

package/package.json

@@ -1,30 +1,20 @@
 {
   "name": "token-rats",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "Sync your Claude Code + Cursor token usage to your Token Rats leaderboard.",
   "license": "UNLICENSED",
   "type": "module",
   "bin": {
     "token-rats": "./dist/index.js"
   },
-  "files": [
-    "dist",
-    "README.md"
-  ],
+  "files": ["dist", "README.md"],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/hsalberti/token-rats.git",
     "directory": "packages/cli"
   },
   "homepage": "https://tokenrats.com",
-  "keywords": [
-    "claude",
-    "claude-code",
-    "cursor",
-    "tokens",
-    "leaderboard",
-    "ai-usage"
-  ],
+  "keywords": ["claude", "claude-code", "cursor", "tokens", "leaderboard", "ai-usage"],
   "publishConfig": {
     "access": "public"
   },