tokentracker-cli 0.81.2 → 0.82.0

package/src/lib/session-analytics.js

@@ -0,0 +1,612 @@
+"use strict";
+
+// Metadata-only session analytics sidecar. This scanner deliberately never
+// persists prompts, assistant text, tool arguments, command output, or diffs.
+
+const crypto = require("node:crypto");
+const fs = require("node:fs");
+const fsp = require("node:fs/promises");
+const os = require("node:os");
+const path = require("node:path");
+const readline = require("node:readline");
+const { listClaudeProjectFiles, listRolloutFilesDeep, claudeMessageDedupKey } = require("./rollout");
+const { parseCodexRolloutFile } = require("./codex-rollout-parser");
+const { computeRowCost } = require("./pricing");
+
+// Bump the sidecar when derived metrics change so cached rows are rebuilt
+// instead of leaving the dashboard on the previous (over-counted) heuristic.
+const SIDECAR_VERSION = 6;
+const EDIT_TOOLS = new Set(["apply_patch", "edit", "write", "multiedit", "notebookedit"]);
+const PLACEHOLDER_MODELS = new Set(["<synthetic>", "synthetic", "<unknown>", "unknown"]);
+const CLAUDE_MEM_OBSERVER_PROJECT_SUFFIX = "--claude-mem-observer-sessions";
+const CODEX_SUBAGENT_TOOLS = new Set(["spawn_agent", "multi_agent_v1__spawn_agent"]);
+const CODEX_SIGNAL_TOOLS = new Set([...EDIT_TOOLS, ...CODEX_SUBAGENT_TOOLS]);
+
+function normalizeSessionModel(value) {
+  if (typeof value !== "string") return null;
+  const model = value.trim();
+  if (!model || PLACEHOLDER_MODELS.has(model.toLowerCase())) return null;
+  return model;
+}
+
+function resolveSessionSidecarPath(home = os.homedir()) {
+  return path.join(home, ".tokentracker", "tracker", "session.queue.jsonl");
+}
+
+function sessionHash(source, id) {
+  return crypto.createHash("sha256").update(`${source}\0${id || "unknown"}`).digest("hex").slice(0, 24);
+}
+
+function finite(value) {
+  const number = Number(value || 0);
+  return Number.isFinite(number) && number > 0 ? number : 0;
+}
+
+function tokenTotals(usage) {
+  const input_tokens = finite(usage?.input_tokens);
+  const cached_input_tokens = finite(usage?.cache_read_input_tokens ?? usage?.cached_input_tokens);
+  const cache_creation_input_tokens = finite(usage?.cache_creation_input_tokens);
+  const output_tokens = finite(usage?.output_tokens);
+  const reasoning_output_tokens = finite(usage?.reasoning_output_tokens);
+  const total_tokens = input_tokens + cached_input_tokens + cache_creation_input_tokens + output_tokens;
+  return { input_tokens, cached_input_tokens, cache_creation_input_tokens, output_tokens, reasoning_output_tokens, total_tokens };
+}
+
+function addTotals(target, delta) {
+  for (const key of ["input_tokens", "cached_input_tokens", "cache_creation_input_tokens", "output_tokens", "reasoning_output_tokens", "total_tokens"]) {
+    target[key] = finite(target[key]) + finite(delta?.[key]);
+  }
+}
+
+function emptyTotals() {
+  return tokenTotals({});
+}
+
+function safeTimestamp(value) {
+  if (typeof value !== "string" || !Number.isFinite(Date.parse(value))) return null;
+  return new Date(value).toISOString();
+}
+
+function updateBounds(bounds, value) {
+  const timestamp = safeTimestamp(value);
+  if (!timestamp) return;
+  if (!bounds.started_at || timestamp < bounds.started_at) bounds.started_at = timestamp;
+  if (!bounds.ended_at || timestamp > bounds.ended_at) bounds.ended_at = timestamp;
+}
+
+function projectKey(cwd, filePath) {
+  const value = cwd || path.dirname(filePath || "");
+  return path.basename(String(value).replace(/[\\/]+$/, "")) || "unknown";
+}
+
+function extractClaudePrompt(obj) {
+  if (!obj || obj.type !== "user" || obj.isMeta) return null;
+  const content = obj.message?.content;
+  if (Array.isArray(content)) {
+    if (content.length > 0 && content.every((block) => block?.type === "tool_result")) return null;
+    const text = content
+      .filter((block) => block?.type === "text" && typeof block.text === "string")
+      .map((block) => block.text)
+      .join("\n")
+      .trim();
+    if (!text) return null;
+    if (text === "[Request interrupted by user]" || text.startsWith("<task-notification>")) return null;
+    return text;
+  }
+  if (typeof content !== "string") return null;
+  const text = content.trim();
+  if (!text || text === "[Request interrupted by user]" || text.startsWith("<task-notification>")) return null;
+  return text;
+}
+
+function promptFingerprint(prompt) {
+  return crypto.createHash("sha256").update(prompt.replace(/\s+/g, " ")).digest("hex");
+}
+
+function extractCodexPrompt(obj) {
+  if (obj?.type !== "event_msg" || obj.payload?.type !== "user_message") return null;
+  if (typeof obj.payload.message === "string") {
+    const message = obj.payload.message.trim();
+    return message || null;
+  }
+  const elements = Array.isArray(obj.payload.text_elements) ? obj.payload.text_elements : [];
+  const text = elements
+    .map((item) => {
+      if (typeof item === "string") return item;
+      if (typeof item?.text === "string") return item.text;
+      if (typeof item?.value === "string") return item.value;
+      return "";
+    })
+    .filter(Boolean)
+    .join("\n")
+    .trim();
+  return text || null;
+}
+
+function canonicalToolName(value) {
+  const name = String(value || "").trim().toLowerCase();
+  if (!name) return "";
+  return name.replace(/^functions[.:/]/, "").replace(/^tools[.:/]/, "");
+}
+
+function extractCodexSignalTools(payload) {
+  if (!payload || !["function_call", "custom_tool_call"].includes(payload.type)) return [];
+  const directName = canonicalToolName(payload.name);
+  if (directName && directName !== "exec") return [directName];
+  if (directName !== "exec" || typeof payload.input !== "string") return [];
+
+  const names = [];
+  for (const name of CODEX_SIGNAL_TOOLS) {
+    const pattern = new RegExp(`\\btools\\.${name}\\s*\\(`, "gi");
+    for (const _match of payload.input.matchAll(pattern)) names.push(name);
+  }
+  return names;
+}
+
+function finalizeRecord(record) {
+  const startedMs = Date.parse(record.started_at || "");
+  const endedMs = Date.parse(record.ended_at || "");
+  record.duration_ms = Number.isFinite(startedMs) && Number.isFinite(endedMs)
+    ? Math.max(0, endedMs - startedMs)
+    : 0;
+  record.total_tokens = finite(record.total_tokens || record.tokens?.total_tokens);
+  record.cost_usd = computeRowCost({ source: record.source, model: record.model, ...record.tokens });
+  record.productive = record.edit_turns > 0;
+  // A first-pass delivery has exactly one user turn containing an observed
+  // edit and no repeated user request. The legacy one_shot field stays as an
+  // API/CSV alias, but now follows this cross-provider definition.
+  record.first_pass = record.edit_turns === 1 && record.retry_turns === 0;
+  record.one_shot = record.first_pass;
+  record.tokens_per_edit = record.edit_turns > 0 ? record.total_tokens / record.edit_turns : null;
+  record.cost_per_edit = record.edit_turns > 0 ? record.cost_usd / record.edit_turns : null;
+  return record;
+}
+
+async function scanClaudeSession(filePath) {
+  const input = fs.createReadStream(filePath, { encoding: "utf8" });
+  const lines = readline.createInterface({ input, crlfDelay: Infinity });
+  const tokens = emptyTotals();
+  const seenMessages = new Set();
+  const bounds = { started_at: null, ended_at: null };
+  let rawSessionId = path.basename(filePath, ".jsonl");
+  let cwd = null;
+  let model = "unknown";
+  let turns = 0;
+  let editTurns = 0;
+  let retryTurns = 0;
+  let currentHadEdit = false;
+  let subagentCalls = 0;
+  const subagentTypes = new Map();
+
+  function closeTurn() {
+    if (currentHadEdit) {
+      editTurns += 1;
+    }
+    currentHadEdit = false;
+  }
+  let lastPromptFingerprint = null;
+
+  for await (const line of lines) {
+    let obj;
+    try { obj = JSON.parse(line); } catch { continue; }
+    updateBounds(bounds, obj.timestamp || obj.message?.timestamp);
+    if (typeof obj.sessionId === "string" && obj.sessionId) rawSessionId = obj.sessionId;
+    if (typeof obj.cwd === "string" && obj.cwd) cwd = obj.cwd;
+    if (obj.type === "user") {
+      const prompt = extractClaudePrompt(obj);
+      if (!prompt) continue;
+      const fingerprint = promptFingerprint(prompt);
+      if (lastPromptFingerprint && fingerprint === lastPromptFingerprint) retryTurns += 1;
+      lastPromptFingerprint = fingerprint;
+      closeTurn();
+      turns += 1;
+      continue;
+    }
+    if (obj.type !== "assistant" || !obj.message) continue;
+    const dedupKey = claudeMessageDedupKey(obj);
+    if (dedupKey && seenMessages.has(dedupKey)) continue;
+    if (dedupKey) seenMessages.add(dedupKey);
+    // Claude writes internal summary/observer messages with model
+    // "<synthetic>". They are not a billable model and can appear after the
+    // real assistant messages in the same session. Keep the latest real
+    // model instead of letting that marker overwrite it.
+    const candidateModel = normalizeSessionModel(obj.message.model);
+    if (candidateModel) model = candidateModel;
+    addTotals(tokens, tokenTotals(obj.message.usage));
+    const content = Array.isArray(obj.message.content) ? obj.message.content : [];
+    for (const block of content) {
+      if (!block || block.type !== "tool_use") continue;
+      const name = String(block.name || "").toLowerCase();
+      if (EDIT_TOOLS.has(name)) currentHadEdit = true;
+      if (name === "agent" || name === "task") {
+        subagentCalls += 1;
+        const subtype = typeof block.input?.subagent_type === "string"
+          ? block.input.subagent_type.trim().slice(0, 64)
+          : "unspecified";
+        subagentTypes.set(subtype || "unspecified", (subagentTypes.get(subtype || "unspecified") || 0) + 1);
+      }
+    }
+  }
+  closeTurn();
+  return finalizeRecord({
+    version: SIDECAR_VERSION,
+    session_hash: sessionHash("claude", rawSessionId),
+    source: "claude",
+    project_key: projectKey(cwd, filePath),
+    project_ref: cwd || null,
+    model,
+    ...bounds,
+    turns,
+    edit_turns: editTurns,
+    retry_turns: retryTurns,
+    subagent_calls: subagentCalls,
+    subagent_types: Object.fromEntries([...subagentTypes.entries()].sort()),
+    tokens,
+    provenance: { source: "local-session-log", confidence: "observed", retry_confidence: "inferred", content_retained: false },
+  });
+}
+
+async function scanCodexDeliverySignals(filePath) {
+  const bounds = { started_at: null, ended_at: null };
+  const input = fs.createReadStream(filePath, { encoding: "utf8" });
+  const lines = readline.createInterface({ input, crlfDelay: Infinity });
+  let turns = 0;
+  let editTurns = 0;
+  let retryTurns = 0;
+  let currentTurnOpen = false;
+  let currentTurnKey = null;
+  let currentHadEdit = false;
+  let hasTurnContext = false;
+  let lastPromptFingerprint = null;
+  let subagentCalls = 0;
+  const subagentTypes = new Map();
+
+  function closeTurn() {
+    if (currentTurnOpen && currentHadEdit) editTurns += 1;
+    currentHadEdit = false;
+  }
+
+  function beginTurn(key) {
+    if (currentTurnOpen && key && currentTurnKey === key) return;
+    if (currentTurnOpen) closeTurn();
+    currentTurnOpen = true;
+    currentTurnKey = key || null;
+    turns += 1;
+  }
+
+  for await (const line of lines) {
+    let obj;
+    try { obj = JSON.parse(line); } catch { continue; }
+    updateBounds(bounds, obj.timestamp);
+    if (obj.type === "turn_context") {
+      hasTurnContext = true;
+      beginTurn(String(obj.payload?.turn_id || obj.timestamp || turns + 1));
+      continue;
+    }
+    const prompt = extractCodexPrompt(obj);
+    if (prompt) {
+      const fingerprint = promptFingerprint(prompt);
+      if (lastPromptFingerprint && fingerprint === lastPromptFingerprint) retryTurns += 1;
+      lastPromptFingerprint = fingerprint;
+      if (!hasTurnContext) beginTurn(String(obj.timestamp || turns + 1));
+      continue;
+    }
+    if (obj.type !== "response_item") continue;
+    const toolNames = extractCodexSignalTools(obj.payload);
+    if (!toolNames.length) continue;
+    if (!currentTurnOpen) beginTurn(String(obj.timestamp || turns + 1));
+    if (toolNames.some((name) => EDIT_TOOLS.has(name))) currentHadEdit = true;
+    for (const name of toolNames) {
+      if (!CODEX_SUBAGENT_TOOLS.has(name)) continue;
+      subagentCalls += 1;
+      const displayName = name === "multi_agent_v1__spawn_agent" ? "spawn_agent" : name;
+      subagentTypes.set(displayName, (subagentTypes.get(displayName) || 0) + 1);
+    }
+  }
+  closeTurn();
+  return {
+    bounds,
+    turns,
+    editTurns,
+    retryTurns,
+    subagentCalls,
+    subagentTypes: Object.fromEntries([...subagentTypes.entries()].sort()),
+  };
+}
+
+async function scanCodexSession(filePath) {
+  const [parsed, signals] = await Promise.all([
+    parseCodexRolloutFile(filePath),
+    scanCodexDeliverySignals(filePath),
+  ]);
+  const parsedModel = normalizeSessionModel(parsed.model);
+  const provider = normalizeSessionModel(parsed.provider);
+  // Older Codex rollouts can omit turn_context.model. The shared parser then
+  // falls back to model_provider (for example "openai"), which is provenance
+  // rather than a model and must not become a model-table row.
+  const model = parsedModel && parsedModel.toLowerCase() !== provider?.toLowerCase()
+    ? parsedModel
+    : "unknown";
+  return finalizeRecord({
+    version: SIDECAR_VERSION,
+    session_hash: sessionHash("codex", parsed.sessionId || filePath),
+    source: "codex",
+    project_key: projectKey(parsed.cwd, filePath),
+    project_ref: parsed.cwd || null,
+    model,
+    ...signals.bounds,
+    turns: signals.turns || finite(parsed.turnCount),
+    edit_turns: signals.editTurns,
+    retry_turns: signals.retryTurns,
+    subagent_calls: signals.subagentCalls,
+    subagent_types: signals.subagentTypes,
+    tokens: parsed.totals || emptyTotals(),
+    provenance: { source: "local-session-log", confidence: "observed", retry_confidence: "inferred", content_retained: false },
+  });
+}
+
+async function discoverSessionFiles(home) {
+  const [allClaude, codex, archived] = await Promise.all([
+    listClaudeProjectFiles(path.join(home, ".claude", "projects")),
+    listRolloutFilesDeep(path.join(home, ".codex", "sessions")),
+    listRolloutFilesDeep(path.join(home, ".codex", "archived_sessions")),
+  ]);
+  // Claude Memory stores thousands of background observer transcripts beside
+  // real Claude Code sessions. They contain <synthetic>/haiku bookkeeping and
+  // no user coding outcome, so scanning them both slows the card dramatically
+  // and dilutes its efficiency metrics.
+  const claude = allClaude.filter((filePath) => !filePath
+    .split(path.sep)
+    .some((segment) => segment.endsWith(CLAUDE_MEM_OBSERVER_PROJECT_SUFFIX)));
+  const codexBySession = new Map();
+  const mtimeOf = (filePath) => {
+    try { return fs.statSync(filePath).mtimeMs; } catch { return -Infinity; }
+  };
+  for (const filePath of [...codex, ...archived]) {
+    const id = path.basename(filePath).match(/([0-9a-f-]{36})\.jsonl$/i)?.[1] || filePath;
+    const previous = codexBySession.get(id);
+    if (!previous || mtimeOf(filePath) > mtimeOf(previous)) codexBySession.set(id, filePath);
+  }
+  return { claude, codex: [...codexBySession.values()] };
+}
+
+function filesSignature(files) {
+  const hash = crypto.createHash("sha256");
+  for (const filePath of files) {
+    try {
+      const stat = fs.statSync(filePath);
+      hash.update(`${filePath}\0${stat.size}\0${stat.mtimeMs}\n`);
+    } catch { /* vanished during discovery */ }
+  }
+  return hash.digest("hex");
+}
+
+function sessionFileCacheKey(source, filePath) {
+  return crypto
+    .createHash("sha256")
+    .update(`${source}\0${path.resolve(filePath)}`)
+    .digest("hex")
+    .slice(0, 24);
+}
+
+function sessionFileStatKey(filePath) {
+  try {
+    const stat = fs.statSync(filePath);
+    return `${stat.size}:${stat.mtimeMs}:${stat.ctimeMs}`;
+  } catch {
+    return null;
+  }
+}
+
+function readSidecar(sidecarPath) {
+  try {
+    return fs.readFileSync(sidecarPath, "utf8").split("\n").filter(Boolean).map((line) => JSON.parse(line));
+  } catch { return []; }
+}
+
+async function writeAtomic(filePath, content) {
+  await fsp.mkdir(path.dirname(filePath), { recursive: true, mode: 0o700 });
+  const temp = `${filePath}.${process.pid}.${Date.now()}.tmp`;
+  await fsp.writeFile(temp, content, { encoding: "utf8", mode: 0o600 });
+  await fsp.rename(temp, filePath);
+}
+
+async function buildSessionAnalyticsInternal({ home = os.homedir(), force = false, cacheTtlMs = 5 * 60_000 } = {}) {
+  const sidecarPath = resolveSessionSidecarPath(home);
+  const metaPath = `${sidecarPath}.meta.json`;
+  let previousMeta = null;
+  if (!force) {
+    try {
+      previousMeta = JSON.parse(fs.readFileSync(metaPath, "utf8"));
+      const checkedAt = Date.parse(previousMeta.checked_at || previousMeta.generated_at || "");
+      if (
+        previousMeta.version === SIDECAR_VERSION &&
+        Number.isFinite(checkedAt) &&
+        Date.now() - checkedAt < Math.max(0, Number(cacheTtlMs) || 0)
+      ) {
+        return readSidecar(sidecarPath);
+      }
+    } catch { /* first run */ }
+  }
+  const discovered = await discoverSessionFiles(home);
+  const signature = filesSignature([...discovered.claude, ...discovered.codex]);
+  if (!force && previousMeta?.version === SIDECAR_VERSION && previousMeta.signature === signature) {
+    await writeAtomic(metaPath, `${JSON.stringify({ ...previousMeta, checked_at: new Date().toISOString() })}\n`);
+    return readSidecar(sidecarPath);
+  }
+
+  const previousRows = !force && previousMeta?.version === SIDECAR_VERSION
+    ? readSidecar(sidecarPath)
+    : [];
+  const previousRowsByFile = new Map(previousRows
+    .filter((row) => typeof row?._cache_key === "string")
+    .map((row) => [row._cache_key, row]));
+  const previousFiles = previousMeta?.version === SIDECAR_VERSION && previousMeta.files
+    ? previousMeta.files
+    : {};
+  const nextFiles = {};
+  const sessions = [];
+  const entries = [
+    ...discovered.claude.map((filePath) => ({ source: "claude", filePath, scan: scanClaudeSession })),
+    ...discovered.codex.map((filePath) => ({ source: "codex", filePath, scan: scanCodexSession })),
+  ];
+  for (const entry of entries) {
+    const cacheKey = sessionFileCacheKey(entry.source, entry.filePath);
+    const statKey = sessionFileStatKey(entry.filePath);
+    if (!statKey) continue;
+    let row = null;
+    if (!force && previousFiles[cacheKey]?.stat_key === statKey) {
+      row = previousRowsByFile.get(cacheKey) || null;
+    }
+    if (!row) {
+      try { row = await entry.scan(entry.filePath); } catch { /* one active/partial session must not poison the sidecar */ }
+    }
+    if (!row) continue;
+    // A one-way file hash enables incremental reuse without persisting or
+    // exposing the user's local session path.
+    row._cache_key = cacheKey;
+    sessions.push(row);
+    nextFiles[cacheKey] = { stat_key: statKey };
+  }
+  sessions.sort((a, b) => String(b.ended_at || "").localeCompare(String(a.ended_at || "")));
+  const content = sessions.map((row) => JSON.stringify(row)).join("\n") + (sessions.length ? "\n" : "");
+  await writeAtomic(sidecarPath, content);
+  const generatedAt = new Date().toISOString();
+  await writeAtomic(metaPath, `${JSON.stringify({
+    version: SIDECAR_VERSION,
+    signature,
+    generated_at: generatedAt,
+    checked_at: generatedAt,
+    files: nextFiles,
+  })}\n`);
+  return sessions;
+}
+
+// A cold scan walks every local Claude/Codex session file. Period switches can
+// issue overlapping requests while that scan is still running; share the
+// promise per home so those requests wait for one scan instead of multiplying
+// the disk work and racing the atomic sidecar write.
+const sessionAnalyticsBuilds = new Map();
+
+function buildSessionAnalytics(options = {}) {
+  const normalizedOptions = options && typeof options === "object" ? options : {};
+  const home = path.resolve(String(normalizedOptions.home || os.homedir()));
+  const existing = sessionAnalyticsBuilds.get(home);
+  if (existing) return existing;
+
+  const promise = buildSessionAnalyticsInternal({ ...normalizedOptions, home });
+  sessionAnalyticsBuilds.set(home, promise);
+  const clear = () => {
+    if (sessionAnalyticsBuilds.get(home) === promise) sessionAnalyticsBuilds.delete(home);
+  };
+  promise.then(clear, clear);
+  return promise;
+}
+
+function summarizeSessions(sessions, { from = "", to = "", includeSessions = true } = {}) {
+  const filtered = (sessions || []).filter((row) => {
+    const day = String(row.started_at || row.ended_at || "").slice(0, 10);
+    return (!from || day >= from) && (!to || day <= to);
+  });
+  const byModel = new Map();
+  const subagents = new Map();
+  for (const row of filtered) {
+    const key = row.model || "unknown";
+    const agg = byModel.get(key) || {
+      model: key,
+      sessions: 0,
+      productive_sessions: 0,
+      one_shot_sessions: 0,
+      edit_turns: 0,
+      retries: 0,
+      total_tokens: 0,
+      cost_usd: 0,
+      edit_tokens: 0,
+      edit_cost_usd: 0,
+    };
+    agg.sessions += 1;
+    if (row.productive) agg.productive_sessions += 1;
+    if (row.first_pass ?? row.one_shot) agg.one_shot_sessions += 1;
+    agg.edit_turns += finite(row.edit_turns);
+    agg.retries += finite(row.retry_turns);
+    agg.total_tokens += finite(row.total_tokens);
+    agg.cost_usd += finite(row.cost_usd);
+    if (row.productive) {
+      agg.edit_tokens += finite(row.total_tokens);
+      agg.edit_cost_usd += finite(row.cost_usd);
+    }
+    byModel.set(key, agg);
+    for (const [name, calls] of Object.entries(row.subagent_types || {})) {
+      const sub = subagents.get(name) || { name, calls: 0, sessions: 0, total_tokens: 0, cost_usd: 0 };
+      sub.calls += finite(calls);
+      sub.sessions += 1;
+      // Token allocation is an explicit estimate because vendor logs do not
+      // consistently expose child usage separately.
+      const share = Math.min(1, finite(calls) / Math.max(1, finite(row.turns)));
+      sub.total_tokens += finite(row.total_tokens) * share;
+      sub.cost_usd += finite(row.cost_usd) * share;
+      subagents.set(name, sub);
+    }
+  }
+  const by_model = [...byModel.values()].map((row) => ({
+    ...row,
+    productive_rate: row.sessions ? row.productive_sessions / row.sessions : null,
+    one_shot_rate: row.productive_sessions ? row.one_shot_sessions / row.productive_sessions : null,
+    edit_sessions: row.productive_sessions,
+    first_pass_sessions: row.one_shot_sessions,
+    edit_session_rate: row.sessions ? row.productive_sessions / row.sessions : null,
+    first_pass_rate: row.productive_sessions ? row.one_shot_sessions / row.productive_sessions : null,
+    tokens_per_edit: row.edit_turns ? row.edit_tokens / row.edit_turns : null,
+    cost_per_edit: row.edit_turns ? row.edit_cost_usd / row.edit_turns : null,
+  })).sort((a, b) => b.edit_turns - a.edit_turns || b.productive_sessions - a.productive_sessions || b.sessions - a.sessions);
+  const totals = by_model.reduce((acc, row) => {
+    for (const key of ["sessions", "productive_sessions", "one_shot_sessions", "edit_turns", "retries", "total_tokens", "cost_usd", "edit_tokens", "edit_cost_usd"]) acc[key] += finite(row[key]);
+    return acc;
+  }, { sessions: 0, productive_sessions: 0, one_shot_sessions: 0, edit_turns: 0, retries: 0, total_tokens: 0, cost_usd: 0, edit_tokens: 0, edit_cost_usd: 0 });
+  return {
+    available: filtered.length > 0,
+    // Local filesystem paths are required internally for Git attribution but
+    // never leave the Node process through API/CSV payloads.
+    sessions: includeSessions
+      ? filtered.map(({ project_ref: _projectRef, _cache_key: _cacheKey, ...row }) => row)
+      : [],
+    session_count: filtered.length,
+    summary: {
+      ...totals,
+      productive_rate: totals.sessions ? totals.productive_sessions / totals.sessions : null,
+      one_shot_rate: totals.productive_sessions ? totals.one_shot_sessions / totals.productive_sessions : null,
+      edit_sessions: totals.productive_sessions,
+      first_pass_sessions: totals.one_shot_sessions,
+      edit_session_rate: totals.sessions ? totals.productive_sessions / totals.sessions : null,
+      first_pass_rate: totals.productive_sessions ? totals.one_shot_sessions / totals.productive_sessions : null,
+      tokens_per_edit: totals.edit_turns ? totals.edit_tokens / totals.edit_turns : null,
+      cost_per_edit: totals.edit_turns ? totals.edit_cost_usd / totals.edit_turns : null,
+    },
+    by_model,
+    subagents: [...subagents.values()].sort((a, b) => b.calls - a.calls),
+    provenance: {
+      source: "local-session-log",
+      confidence: "observed",
+      privacy: "metadata-only",
+      methodology: "edit-turn-v2",
+      edit_turn: "user turn containing an observed edit tool",
+      first_pass: "exactly one edit turn and no repeated user request",
+    },
+  };
+}
+
+function sessionsToCsv(rows) {
+  const columns = ["session_hash", "source", "project_key", "model", "started_at", "ended_at", "duration_ms", "turns", "edit_turns", "retry_turns", "subagent_calls", "total_tokens", "cost_usd", "productive", "first_pass", "one_shot"];
+  const escape = (value) => `"${String(value ?? "").replaceAll('"', '""')}"`;
+  return [columns.join(","), ...(rows || []).map((row) => columns.map((key) => escape(row[key])).join(","))].join("\n") + "\n";
+}
+
+module.exports = {
+  resolveSessionSidecarPath,
+  sessionHash,
+  scanClaudeSession,
+  scanCodexSession,
+  buildSessionAnalytics,
+  summarizeSessions,
+  sessionsToCsv,
+};

package/src/lib/usage-limits.js

@@ -3037,6 +3037,27 @@ async function fetchUsageLimitsUncached({
     opencodeGo: withPlanLabel(opencodeGo, opencodeGo?.plan_label, "OpenCode Go"),
   };
 
+  for (const [providerName, provider] of Object.entries(data)) {
+    if (providerName === "fetched_at" || !provider || typeof provider !== "object") continue;
+    const capturedAt = provider.cached_at || data.fetched_at;
+    const ageMs = Math.max(0, nowMs - Date.parse(capturedAt || ""));
+    const stale = provider.stale === true || (Number.isFinite(ageMs) && ageMs > 10 * 60 * 1000);
+    const explicitSource = typeof provider.source === "string" ? provider.source : "";
+    const source = explicitSource || (stale ? "disk-cache" : "provider-api");
+    const confidence = /estimate|inferred/i.test(source)
+      ? "inferred"
+      : /local|database|sqlite|cache/i.test(source)
+        ? "observed"
+        : "official";
+    provider.provenance = {
+      source,
+      confidence,
+      captured_at: capturedAt,
+      stale,
+      age_seconds: Number.isFinite(ageMs) ? Math.round(ageMs / 1000) : null,
+    };
+  }
+
   cache = { data, expiresAtMs: cacheExpiresAtMs(data, nowMs) };
   return data;
 }

package/dashboard/dist/assets/AchievementBadge-DXWHZrAL.js

@@ -1 +0,0 @@
-import{c as o,R as N,j as r}from"./main-CeaB5N36.js";import{Z as $}from"./zap-DlAOTwFs.js";import{F as A}from"./flame-0eyhMnfU.js";const j=[["path",{d:"M10 22V7a1 1 0 0 0-1-1H4a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-5a1 1 0 0 0-1-1H2",key:"1ah6g2"}],["rect",{x:"14",y:"2",width:"8",height:"8",rx:"1",key:"88lufb"}]],E=o("blocks",j);const L=[["path",{d:"M12 18V5",key:"adv99a"}],["path",{d:"M15 13a4.17 4.17 0 0 1-3-4 4.17 4.17 0 0 1-3 4",key:"1e3is1"}],["path",{d:"M17.598 6.5A3 3 0 1 0 12 5a3 3 0 1 0-5.598 1.5",key:"1gqd8o"}],["path",{d:"M17.997 5.125a4 4 0 0 1 2.526 5.77",key:"iwvgf7"}],["path",{d:"M18 18a4 4 0 0 0 2-7.464",key:"efp6ie"}],["path",{d:"M19.967 17.483A4 4 0 1 1 12 18a4 4 0 1 1-7.967-.517",key:"1gq6am"}],["path",{d:"M6 18a4 4 0 0 1-2-7.464",key:"k1g0md"}],["path",{d:"M6.003 5.125a4 4 0 0 0-2.526 5.77",key:"q97ue3"}]],C=o("brain",L);const T=[["path",{d:"M8 2v4",key:"1cmpym"}],["path",{d:"M16 2v4",key:"4m81vk"}],["rect",{width:"18",height:"18",x:"3",y:"4",rx:"2",key:"1hopcy"}],["path",{d:"M3 10h18",key:"8toen8"}],["path",{d:"M8 14h.01",key:"6423bh"}],["path",{d:"M12 14h.01",key:"1etili"}],["path",{d:"M16 14h.01",key:"1gbofw"}],["path",{d:"M8 18h.01",key:"lrp35t"}],["path",{d:"M12 18h.01",key:"mhygvu"}],["path",{d:"M16 18h.01",key:"kzsmim"}]],z=o("calendar-days",T);const B=[["path",{d:"M11.562 3.266a.5.5 0 0 1 .876 0L15.39 8.87a1 1 0 0 0 1.516.294L21.183 5.5a.5.5 0 0 1 .798.519l-2.834 10.246a1 1 0 0 1-.956.734H5.81a1 1 0 0 1-.957-.734L2.02 6.02a.5.5 0 0 1 .798-.519l4.276 3.664a1 1 0 0 0 1.516-.294z",key:"1vdc57"}],["path",{d:"M5 21h14",key:"11awu3"}]],R=o("crown",B);const q=[["path",{d:"M12.67 19a2 2 0 0 0 1.416-.588l6.154-6.172a6 6 0 0 0-8.49-8.49L5.586 9.914A2 2 0 0 0 5 11.328V18a1 1 0 0 0 1 1z",key:"18jl4k"}],["path",{d:"M16 8 2 22",key:"vp34q"}],["path",{d:"M17.5 15H9",key:"1oz8nu"}]],H=o("feather",q);const D=[["path",{d:"M18 19a5 5 0 0 1-5-5v8",key:"sz5oeg"}],["path",{d:"M9 20H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H20a2 2 0 0 1 2 2v5",key:"1w6njk"}],["circle",{cx:"13",cy:"12",r:"2",key:"1j92g6"}],["circle",{cx:"20",cy:"19",r:"2",key:"1obnsp"}]],F=o("folder-git-2",D);const I=[["path",{d:"M4 16v-2.38C4 11.5 2.97 10.5 3 8c.03-2.72 1.49-6 4.5-6C9.37 2 10 3.8 10 5.5c0 3.11-2 5.66-2 8.68V16a2 2 0 1 1-4 0Z",key:"1dudjm"}],["path",{d:"M20 20v-2.38c0-2.12 1.03-3.12 1-5.62-.03-2.72-1.49-6-4.5-6C14.63 6 14 7.8 14 9.5c0 3.11 2 5.66 2 8.68V20a2 2 0 1 0 4 0Z",key:"l2t8xc"}],["path",{d:"M16 17h4",key:"1dejxt"}],["path",{d:"M4 13h4",key:"1bwh8b"}]],G=o("footprints",I);const V=[["path",{d:"M2 9.5a5.5 5.5 0 0 1 9.591-3.676.56.56 0 0 0 .818 0A5.49 5.49 0 0 1 22 9.5c0 2.29-1.5 4-3 5.5l-5.492 5.313a2 2 0 0 1-3 .019L5 15c-1.5-1.5-3-3.2-3-5.5",key:"mvr1a0"}]],S=o("heart",V);const Z=[["path",{d:"M7.21 15 2.66 7.14a2 2 0 0 1 .13-2.2L4.4 2.8A2 2 0 0 1 6 2h12a2 2 0 0 1 1.6.8l1.6 2.14a2 2 0 0 1 .14 2.2L16.79 15",key:"143lza"}],["path",{d:"M11 12 5.12 2.2",key:"qhuxz6"}],["path",{d:"m13 12 5.88-9.8",key:"hbye0f"}],["path",{d:"M8 7h8",key:"i86dvs"}],["circle",{cx:"12",cy:"17",r:"5",key:"qbz8iq"}],["path",{d:"M12 18v-2h-.5",key:"fawc4q"}]],O=o("medal",Z);const P=[["path",{d:"M18 5h4",key:"1lhgn2"}],["path",{d:"M20 3v4",key:"1olli1"}],["path",{d:"M20.985 12.486a9 9 0 1 1-9.473-9.472c.405-.022.617.46.402.803a6 6 0 0 0 8.268 8.268c.344-.215.825-.004.803.401",key:"kfwtm"}]],X=o("moon-star",P);const K=[["path",{d:"M12 15v5s3.03-.55 4-2c1.08-1.62 0-5 0-5",key:"qeys4"}],["path",{d:"M4.5 16.5c-1.5 1.26-2 5-2 5s3.74-.5 5-2c.71-.84.7-2.13-.09-2.91a2.18 2.18 0 0 0-2.91-.09",key:"u4xsad"}],["path",{d:"M9 12a22 22 0 0 1 2-3.95A12.88 12.88 0 0 1 22 2c0 2.72-.78 7.5-6 11a22.4 22.4 0 0 1-4 2z",key:"676m9"}],["path",{d:"M9 12H4s.55-3.03 2-4c1.62-1.08 5 .05 5 .05",key:"92ym6u"}]],U=o("rocket",K);const W=[["path",{d:"M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z",key:"oel41y"}],["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}]],Y=o("shield-check",W);const J=[["path",{d:"M16 7h6v6",key:"box55l"}],["path",{d:"m22 7-8.5 8.5-5-5L2 17",key:"1t1m79"}]],Q=o("trending-up",J),k=[{id:"token_titan",scope:"cloud",icon:R,format:"tokens",art:"/achievements/token-titan.png"},{id:"big_day",scope:"cloud",icon:$,format:"tokens",art:"/achievements/big-day.png"},{id:"wordsmith",scope:"cloud",icon:H,format:"tokens",art:"/achievements/wordsmith.png"},{id:"marathoner",scope:"cloud",icon:G,format:"days",art:"/achievements/marathoner.png"},{id:"streak",scope:"cloud",icon:A,format:"days",art:"/achievements/streak.png"},{id:"weekend_warrior",scope:"cloud",icon:z,format:"days",art:"/achievements/weekend-warrior.png"},{id:"momentum",scope:"cloud",icon:Q,format:"multiplier",art:"/achievements/momentum.png"},{id:"polyglot",scope:"cloud",icon:C,format:"count",art:"/achievements/polyglot.png"},{id:"trendsetter",scope:"cloud",icon:U,format:"count",art:"/achievements/trendsetter.png"},{id:"multitool",scope:"cloud",icon:E,format:"count",art:"/achievements/multitool.png"},{id:"podium",scope:"cloud",icon:O,format:"rank",art:"/achievements/podium.png"},{id:"veteran",scope:"cloud",icon:Y,format:"days",art:"/achievements/veteran.png"},{id:"project_hopper",scope:"local",icon:F,format:"count",art:"/achievements/project-hopper.png"},{id:"project_devotion",scope:"local",icon:S,format:"tokens",art:"/achievements/project-devotion.png"},{id:"night_owl",scope:"local",icon:X,format:"count",art:"/achievements/night-owl.png"}],u=new Map(k.map(e=>[e.id,e])),m=new Map(k.map((e,a)=>[e.id,a]));function de(e,a){return`achievements.badge.${e}.${a}`}function ee(e){return[...e||[]].sort((a,t)=>{const c=(t?.tier||0)-(a?.tier||0);return c!==0?c:(m.get(a?.id)??99)-(m.get(t?.id)??99)})}function re(e){const a=(e||[]).filter(t=>t&&(t.tier||0)>=1&&u.has(t.id));return a.length===0?null:ee(a)[0]}const v={1:"bronze",2:"silver",3:"gold",4:"diamond"},ie=["bronze","silver","gold","diamond"],ae={bronze:{rim:["#a06a44","#5c3a22"],face:["#d29a6c","#96602f"],glyph:"#3f2817",ring:"#e8c3a0",sheen:"rgba(255, 236, 220, 0.45)",label:"#a06a44"},silver:{rim:["#aab3bb","#67707b"],face:["#dde2e7","#9ba5ae"],glyph:"#39424b",ring:"#f2f5f7",sheen:"rgba(255, 255, 255, 0.55)",label:"#8b959f"},gold:{rim:["#c9971c","#8a6508"],face:["#f2ca52","#cf9c26"],glyph:"#5c430e",ring:"#ffe9a8",sheen:"rgba(255, 248, 214, 0.55)",label:"#b8860b"},diamond:{rim:["#62b1e0","#7c6fd9"],face:["#c8ecf6","#84b4ea"],glyph:"#27496d",ring:"#eafcff",sheen:"rgba(255, 255, 255, 0.65)",label:"#5a9bd8"}},y={rim:["#a8ada9","#7c817d"],face:["#cdd2ce","#a3a8a4"],glyph:"#6a706c",ring:"#dde1de",sheen:"rgba(255, 255, 255, 0.25)",label:"#8b908c"};function te(e,a=!1){return a||!e||e<1?y:ae[v[Math.min(e,4)]]||y}function se(e){return v[e]||null}const g={xs:18,sm:24,md:44,xl:88,lg:108},f={xs:.75,sm:1,md:1.5,xl:2,lg:2};function le({badgeId:e,tier:a=0,size:t="md",locked:c=!1,label:i,className:M=""}){const s=u.get(e),h=c||!a||a<1,n=te(a,h),d=t==="fill",l=d?"100%":g[t]||g.md,b=d?4:f[t]||f.md,[_,x]=N.useState(!1),p=s?.icon||null,w=!!s?.art&&!_;return r.jsx("span",{role:i?"img":void 0,"aria-label":i||void 0,"aria-hidden":i?void 0:!0,className:`inline-flex shrink-0 rounded-full ${M}`,style:{width:l,height:l,padding:b,background:`linear-gradient(135deg, ${n.rim[0]} 0%, ${n.ring} 42%, ${n.rim[1]} 100%)`,boxShadow:d||t==="md"||t==="xl"||t==="lg"?"0 0 0 1px rgba(10, 15, 12, 0.06), 0 1px 2px rgba(10, 15, 12, 0.08)":void 0},children:w?r.jsx("img",{src:s.art,alt:"",draggable:!1,loading:"lazy",onError:()=>x(!0),className:"h-full w-full rounded-full object-cover",style:h?{filter:"grayscale(1)",opacity:.55}:void 0}):r.jsx("span",{className:"flex h-full w-full items-center justify-center rounded-full",style:{background:`linear-gradient(145deg, ${n.face[0]}, ${n.face[1]})`},children:p?r.jsx(p,{size:d?64:Math.round(l*.5),color:n.glyph,strokeWidth:2}):null})})}export{le as A,k as B,S as H,ae as T,u as a,de as b,ie as c,re as h,te as p,ee as s,se as t};

package/dashboard/dist/assets/AchievementsPage-BhrQXniL.js

@@ -1,2 +0,0 @@
-const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/BadgeDetailModal-DGKPuvDU.js","assets/main-CeaB5N36.js","assets/main-DAc77vwF.css","assets/AchievementBadge-DXWHZrAL.js","assets/zap-DlAOTwFs.js","assets/flame-0eyhMnfU.js","assets/use-transform-BvXyGAtb.js","assets/AchievementsSection-gzP3m1Ml.js","assets/format-tokens-CkfBUcoa.js","assets/DialogTitle-sLJxKWjv.js","assets/useScrollLock-BfU2EMvG.js"])))=>i.map(i=>d[i]);
-import{r as l,V as x,am as f,U as v,j as e,E as c,L as p,R as g,_ as y,a as b,an as k,a4 as j}from"./main-CeaB5N36.js";import{A as w}from"./AchievementsSection-gzP3m1Ml.js";import{B as h}from"./AchievementBadge-DXWHZrAL.js";import"./format-tokens-CkfBUcoa.js";import"./zap-DlAOTwFs.js";import"./flame-0eyhMnfU.js";function N({enabled:a=!0}={}){const[n,t]=l.useState({status:"loading",achievements:[],error:null}),s=l.useMemo(()=>x(),[]);return l.useEffect(()=>{if(!a){t({status:"disabled",achievements:[],error:null});return}let i=!1;return t(r=>({...r,status:"loading"})),f({timeZone:s,tzOffsetMinutes:v()}).then(r=>{i||t({status:"ready",achievements:Array.isArray(r?.achievements)?r.achievements:[],error:null})}).catch(r=>{i||t({status:"error",achievements:[],error:r})}),()=>{i=!0}},[a,s]),n}const A=g.lazy(()=>j(()=>import("./BadgeDetailModal-DGKPuvDU.js"),__vite__mapDeps([0,1,2,3,4,5,6,7,8,9,10])));function I({authLoading:a,authEnabled:n,authUserId:t,mockEnabled:s}){if(s)return{authLoading:!1,signedIn:!0,userId:"mock-user"};const i=!!(n&&t);return{authLoading:!!a,signedIn:i,userId:i?t:null}}function B(){const a=y(),[n,t]=l.useState({status:"loading",achievements:[],userId:null}),s=b(),{authLoading:i,signedIn:r,userId:o}=I({authLoading:a?.loading,authEnabled:a?.enabled,authUserId:a?.user?.id,mockEnabled:s});return l.useEffect(()=>{if(i){t({status:"loading",achievements:[],userId:null});return}if(!r){t({status:"signed-out",achievements:[],userId:null});return}let d=!1;return t({status:"loading",achievements:[],userId:o}),(async()=>{try{const u=s?null:await a.getAccessToken?.(),m=await k({accessToken:u,userId:o});if(d)return;t({status:"ready",achievements:Array.isArray(m?.badges)?m.badges:[],userId:o})}catch{d||t({status:"error",achievements:[],userId:o})}})(),()=>{d=!0}},[i,s,r,o]),{...n,signedIn:r,settled:_({authLoading:i,signedIn:r,userId:o,state:n})}}function _({authLoading:a,signedIn:n,userId:t,state:s}){return a?!1:n?s.userId===t&&(s.status==="ready"||s.status==="error"):s.status==="signed-out"}function E(){return e.jsx("div",{className:"mx-0 grid animate-pulse grid-cols-[repeat(3,max-content)] justify-between gap-y-7 sm:-mx-2 sm:grid-cols-[repeat(4,max-content)] lg:grid-cols-[repeat(5,max-content)]","aria-hidden":!0,children:Array.from({length:h.length}).map((a,n)=>e.jsxs("div",{className:"flex w-[6.75rem] flex-col items-center px-0 pb-3 pt-4 sm:w-[7.75rem]",children:[e.jsx("div",{className:"h-[108px] w-[108px] rounded-full bg-oai-gray-200 dark:bg-oai-gray-800"}),e.jsx("div",{className:"mt-3 h-3 w-16 rounded bg-oai-gray-200 dark:bg-oai-gray-800"}),e.jsx("div",{className:"mt-2 h-2 w-10 rounded bg-oai-gray-100 dark:bg-oai-gray-800/60"})]},n))})}function R(){const a=N(),n=B(),[t,s]=l.useState(null),i=a.status==="loading"||!n.settled,r=l.useMemo(()=>[...n.achievements||[],...a.achievements||[]],[n.achievements,a.achievements]),o=l.useMemo(()=>r.filter(u=>(u?.tier||0)>=1).length,[r]),d=h.length;return e.jsxs("div",{className:"flex flex-1 flex-col font-oai text-oai-black antialiased dark:text-oai-white",children:[e.jsx("main",{className:"flex-1 pb-12 pt-8 sm:pb-16 sm:pt-10",children:e.jsxs("div",{className:"mx-auto max-w-4xl px-4 sm:px-6",children:[e.jsxs("div",{className:"mb-7 flex items-baseline justify-between gap-4",children:[e.jsxs("div",{className:"min-w-0",children:[e.jsx("h1",{className:"text-3xl font-semibold tracking-tight text-oai-black dark:text-white sm:text-4xl",children:c("achievements.page.title")}),e.jsx("p",{className:"mt-1.5 text-sm text-oai-gray-500 dark:text-oai-gray-400",children:c("achievements.page.local_note")})]}),!i&&e.jsxs("div",{className:"shrink-0 text-right",children:[e.jsxs("div",{className:"font-mono text-2xl font-semibold leading-none tabular-nums text-oai-black dark:text-white",children:[o,e.jsxs("span",{className:"text-oai-gray-400 dark:text-oai-gray-600",children:["/",d]})]}),e.jsx("div",{className:"mt-2 h-1 w-24 overflow-hidden rounded-full bg-oai-gray-200 dark:bg-oai-gray-800",children:e.jsx("div",{className:"h-full rounded-full bg-oai-brand-600 transition-[width] duration-500",style:{width:`${Math.round(o/d*100)}%`}})})]})]}),!n.signedIn&&!i&&e.jsxs("div",{className:"mb-6 flex flex-wrap items-center justify-between gap-x-4 gap-y-2 rounded-xl border border-oai-gray-200 bg-oai-gray-50 px-4 py-3 dark:border-oai-gray-800 dark:bg-oai-gray-900/60",children:[e.jsx("p",{className:"text-sm text-oai-gray-600 dark:text-oai-gray-300",children:c("achievements.signin.prompt")}),e.jsx(p,{to:"/login",className:"shrink-0 rounded-lg bg-oai-brand-600 px-3 py-1.5 text-sm font-medium text-white transition-colors duration-200 hover:bg-oai-brand-700 active:scale-[0.98]",children:c("achievements.signin.action")})]}),i?e.jsx(E,{}):e.jsxs(e.Fragment,{children:[e.jsx(w,{achievements:r,isOwn:!0,columns:"wide",size:"lg",animateIn:!0,onSelect:s}),e.jsxs("p",{className:"mt-10 text-center text-xs text-oai-gray-400 dark:text-oai-gray-500",children:[c("achievements.page.suggest")," ",e.jsx("a",{href:"https://github.com/mm7894215/TokenTracker/issues",target:"_blank",rel:"noopener noreferrer",className:"underline decoration-oai-gray-300 underline-offset-2 transition-colors hover:text-oai-gray-700 hover:decoration-oai-gray-500 dark:decoration-oai-gray-600 dark:hover:text-oai-gray-300",children:c("achievements.page.suggest_link")})]})]})]})}),t&&e.jsx(g.Suspense,{fallback:null,children:e.jsx(A,{badge:t,onClose:()=>s(null)})})]})}export{_ as cloudBadgesSettled,R as default,I as resolveCloudBadgeIdentity};