luckerr 0.41.0

package/dist/cli/chunk-5FTI4KXH.js

@@ -0,0 +1,150 @@
+#!/usr/bin/env node
+import { createRequire as __cr } from 'node:module'; if (typeof globalThis.require === 'undefined') { globalThis.require = __cr(import.meta.url); }
+import {
+  aggregateUsage,
+  bucketCacheHitRatio,
+  bucketSavingsFraction,
+  defaultUsageLogPath,
+  formatLogSize,
+  readUsageLog
+} from "./chunk-M4K6U37F.js";
+
+// src/cli/commands/stats.ts
+import { existsSync, readFileSync } from "fs";
+function statsCommand(opts) {
+  if (opts.transcript) {
+    transcriptSummary(opts.transcript);
+    return;
+  }
+  dashboard(opts);
+}
+function transcriptSummary(path) {
+  if (!existsSync(path)) {
+    console.error(`no such transcript: ${path}`);
+    process.exit(1);
+  }
+  const lines = readFileSync(path, "utf8").split(/\r?\n/).filter(Boolean);
+  let assistantTurns = 0;
+  let toolCalls = 0;
+  let lastTurn = 0;
+  for (const line of lines) {
+    try {
+      const rec = JSON.parse(line);
+      if (rec.role === "assistant_final") assistantTurns++;
+      if (rec.role === "tool") toolCalls++;
+      if (typeof rec.turn === "number") lastTurn = Math.max(lastTurn, rec.turn);
+    } catch {
+    }
+  }
+  console.log(`transcript:       ${path}`);
+  console.log(`assistant turns:  ${assistantTurns}`);
+  console.log(`tool invocations: ${toolCalls}`);
+  console.log(`last turn index:  ${lastTurn}`);
+}
+function dashboard(opts) {
+  const path = opts.logPath ?? defaultUsageLogPath();
+  const records = readUsageLog(path);
+  if (records.length === 0) {
+    console.log("no usage data yet.");
+    console.log("");
+    console.log(`  ${path}`);
+    console.log("");
+    console.log("run `luckerr chat`, `luckerr code`, or `luckerr run <task>` \u2014 every turn");
+    console.log("appends one line to the log and `luckerr stats` will roll it up.");
+    return;
+  }
+  const agg = aggregateUsage(records, { now: opts.now });
+  console.log(renderDashboard(agg, path));
+}
+function renderDashboard(agg, logPath) {
+  const lines = [];
+  const size = formatLogSize(logPath);
+  lines.push(`Luckerr usage \u2014 ${logPath}${size ? ` (${size})` : ""}`);
+  lines.push("");
+  lines.push(header());
+  lines.push(divider());
+  for (const b of agg.buckets) {
+    lines.push(bucketRow(b));
+  }
+  lines.push("");
+  if (agg.byModel.length > 0) {
+    const totalTurns = agg.buckets[agg.buckets.length - 1]?.turns ?? 0;
+    const top = agg.byModel[0];
+    if (top && totalTurns > 0) {
+      const pct = (top.turns / totalTurns * 100).toFixed(0);
+      lines.push(`most used model:   ${top.model} (${pct}% of turns)`);
+    }
+  }
+  if (agg.bySession.length > 0) {
+    const top = agg.bySession[0];
+    if (top) lines.push(`top session:       ${top.session} (${top.turns} turns)`);
+  }
+  if (agg.firstSeen) {
+    lines.push(`tracked since:     ${new Date(agg.firstSeen).toISOString().slice(0, 10)}`);
+  }
+  if (agg.subagents) {
+    lines.push("");
+    lines.push(renderSubagentSection(agg.subagents));
+  }
+  return lines.join("\n");
+}
+function renderSubagentSection(sub) {
+  const lines = [];
+  const seconds = (sub.totalDurationMs / 1e3).toFixed(1);
+  lines.push(
+    `subagent activity: ${sub.total} run(s) \xB7 $${sub.costUsd.toFixed(6)} \xB7 ${seconds}s total`
+  );
+  const top = sub.bySkill.slice(0, 5);
+  for (const s of top) {
+    const sec = (s.durationMs / 1e3).toFixed(1);
+    lines.push(
+      `  ${pad(s.skillName, 18)} ${pad(`${s.count}`, 4, "right")}  $${s.costUsd.toFixed(6)}  ${sec}s`
+    );
+  }
+  if (sub.bySkill.length > top.length) {
+    lines.push(`  (+${sub.bySkill.length - top.length} more)`);
+  }
+  return lines.join("\n");
+}
+function header() {
+  return [
+    pad("", 10),
+    pad("turns", 8, "right"),
+    pad("cache hit", 10, "right"),
+    pad("cost (USD)", 14, "right"),
+    pad("cache saved", 14, "right"),
+    pad("vs Claude", 14, "right"),
+    pad("saved", 10, "right")
+  ].join("  ");
+}
+function divider() {
+  return "-".repeat(86);
+}
+function bucketRow(b) {
+  const hit = bucketCacheHitRatio(b);
+  const savings = bucketSavingsFraction(b);
+  return [
+    pad(b.label, 10),
+    pad(b.turns.toString(), 8, "right"),
+    pad(b.turns > 0 ? `${(hit * 100).toFixed(1)}%` : "\u2014", 10, "right"),
+    pad(b.turns > 0 ? `$${b.costUsd.toFixed(6)}` : "\u2014", 14, "right"),
+    pad(
+      b.turns > 0 && b.cacheSavingsUsd > 0 ? `$${b.cacheSavingsUsd.toFixed(4)}` : "\u2014",
+      14,
+      "right"
+    ),
+    pad(b.turns > 0 ? `$${b.claudeEquivUsd.toFixed(4)}` : "\u2014", 14, "right"),
+    pad(b.turns > 0 && savings > 0 ? `${(savings * 100).toFixed(1)}%` : "\u2014", 10, "right")
+  ].join("  ");
+}
+function pad(s, width, align = "left") {
+  if (s.length >= width) return s;
+  const fill = " ".repeat(width - s.length);
+  return align === "right" ? `${fill}${s}` : `${s}${fill}`;
+}
+
+export {
+  statsCommand,
+  renderDashboard
+};
+//# sourceMappingURL=chunk-5FTI4KXH.js.map

package/dist/cli/chunk-5FTI4KXH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/commands/stats.ts"],"sourcesContent":["/** `luckerr stats [path]` — path arg switches to per-transcript mode; default is the cross-session dashboard. */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport {\n  type UsageAggregate,\n  type UsageBucket,\n  aggregateUsage,\n  bucketCacheHitRatio,\n  bucketSavingsFraction,\n  defaultUsageLogPath,\n  formatLogSize,\n  readUsageLog,\n} from \"../../telemetry/usage.js\";\n\nexport interface StatsOptions {\n  /** Optional transcript path. Absent → dashboard mode. */\n  transcript?: string;\n  /** Override usage log location (tests). */\n  logPath?: string;\n  /** Inject a fixed timestamp (tests) so rolling windows are deterministic. */\n  now?: number;\n}\n\nexport function statsCommand(opts: StatsOptions): void {\n  if (opts.transcript) {\n    transcriptSummary(opts.transcript);\n    return;\n  }\n  dashboard(opts);\n}\n\nfunction transcriptSummary(path: string): void {\n  if (!existsSync(path)) {\n    console.error(`no such transcript: ${path}`);\n    process.exit(1);\n  }\n  const lines = readFileSync(path, \"utf8\").split(/\\r?\\n/).filter(Boolean);\n  let assistantTurns = 0;\n  let toolCalls = 0;\n  let lastTurn = 0;\n  for (const line of lines) {\n    try {\n      const rec = JSON.parse(line);\n      if (rec.role === \"assistant_final\") assistantTurns++;\n      if (rec.role === \"tool\") toolCalls++;\n      if (typeof rec.turn === \"number\") lastTurn = Math.max(lastTurn, rec.turn);\n    } catch {\n      /* skip */\n    }\n  }\n  console.log(`transcript:       ${path}`);\n  console.log(`assistant turns:  ${assistantTurns}`);\n  console.log(`tool invocations: ${toolCalls}`);\n  console.log(`last turn index:  ${lastTurn}`);\n}\n\nfunction dashboard(opts: StatsOptions): void {\n  const path = opts.logPath ?? defaultUsageLogPath();\n  const records = readUsageLog(path);\n  if (records.length === 0) {\n    console.log(\"no usage data yet.\");\n    console.log(\"\");\n    console.log(`  ${path}`);\n    console.log(\"\");\n    console.log(\"run `luckerr chat`, `luckerr code`, or `luckerr run <task>` — every turn\");\n    console.log(\"appends one line to the log and `luckerr stats` will roll it up.\");\n    return;\n  }\n\n  const agg = aggregateUsage(records, { now: opts.now });\n  console.log(renderDashboard(agg, path));\n}\n\n/** Pure renderer — pulled out so tests can assert on the string directly. */\nexport function renderDashboard(agg: UsageAggregate, logPath: string): string {\n  const lines: string[] = [];\n  const size = formatLogSize(logPath);\n  lines.push(`Luckerr usage — ${logPath}${size ? ` (${size})` : \"\"}`);\n  lines.push(\"\");\n  lines.push(header());\n  lines.push(divider());\n  for (const b of agg.buckets) {\n    lines.push(bucketRow(b));\n  }\n  lines.push(\"\");\n\n  // Model + session breakdown — both trim to top 3 so a user with 20\n  // sessions doesn't drown the table.\n  if (agg.byModel.length > 0) {\n    const totalTurns = agg.buckets[agg.buckets.length - 1]?.turns ?? 0;\n    const top = agg.byModel[0];\n    if (top && totalTurns > 0) {\n      const pct = ((top.turns / totalTurns) * 100).toFixed(0);\n      lines.push(`most used model:   ${top.model} (${pct}% of turns)`);\n    }\n  }\n  if (agg.bySession.length > 0) {\n    const top = agg.bySession[0];\n    if (top) lines.push(`top session:       ${top.session} (${top.turns} turns)`);\n  }\n  if (agg.firstSeen) {\n    lines.push(`tracked since:     ${new Date(agg.firstSeen).toISOString().slice(0, 10)}`);\n  }\n  if (agg.subagents) {\n    lines.push(\"\");\n    lines.push(renderSubagentSection(agg.subagents));\n  }\n  return lines.join(\"\\n\");\n}\n\nfunction renderSubagentSection(sub: NonNullable<UsageAggregate[\"subagents\"]>): string {\n  const lines: string[] = [];\n  const seconds = (sub.totalDurationMs / 1000).toFixed(1);\n  lines.push(\n    `subagent activity: ${sub.total} run(s) · $${sub.costUsd.toFixed(6)} · ${seconds}s total`,\n  );\n  // Show at most 5 skills so the section never dwarfs the main table.\n  const top = sub.bySkill.slice(0, 5);\n  for (const s of top) {\n    const sec = (s.durationMs / 1000).toFixed(1);\n    lines.push(\n      `  ${pad(s.skillName, 18)} ${pad(`${s.count}`, 4, \"right\")}  $${s.costUsd.toFixed(6)}  ${sec}s`,\n    );\n  }\n  if (sub.bySkill.length > top.length) {\n    lines.push(`  (+${sub.bySkill.length - top.length} more)`);\n  }\n  return lines.join(\"\\n\");\n}\n\nfunction header(): string {\n  // Fixed column widths so alignment works in any TTY.\n  // `cache saved` reports DeepSeek's hit-vs-miss USD diff; the existing\n  // `saved` column is the % saved vs Claude-Sonnet equivalent.\n  return [\n    pad(\"\", 10),\n    pad(\"turns\", 8, \"right\"),\n    pad(\"cache hit\", 10, \"right\"),\n    pad(\"cost (USD)\", 14, \"right\"),\n    pad(\"cache saved\", 14, \"right\"),\n    pad(\"vs Claude\", 14, \"right\"),\n    pad(\"saved\", 10, \"right\"),\n  ].join(\"  \");\n}\n\nfunction divider(): string {\n  return \"-\".repeat(86);\n}\n\nfunction bucketRow(b: UsageBucket): string {\n  const hit = bucketCacheHitRatio(b);\n  const savings = bucketSavingsFraction(b);\n  return [\n    pad(b.label, 10),\n    pad(b.turns.toString(), 8, \"right\"),\n    pad(b.turns > 0 ? `${(hit * 100).toFixed(1)}%` : \"—\", 10, \"right\"),\n    pad(b.turns > 0 ? `$${b.costUsd.toFixed(6)}` : \"—\", 14, \"right\"),\n    pad(\n      b.turns > 0 && b.cacheSavingsUsd > 0 ? `$${b.cacheSavingsUsd.toFixed(4)}` : \"—\",\n      14,\n      \"right\",\n    ),\n    pad(b.turns > 0 ? `$${b.claudeEquivUsd.toFixed(4)}` : \"—\", 14, \"right\"),\n    pad(b.turns > 0 && savings > 0 ? `${(savings * 100).toFixed(1)}%` : \"—\", 10, \"right\"),\n  ].join(\"  \");\n}\n\nfunction pad(s: string, width: number, align: \"left\" | \"right\" = \"left\"): string {\n  if (s.length >= width) return s;\n  const fill = \" \".repeat(width - s.length);\n  return align === \"right\" ? `${fill}${s}` : `${s}${fill}`;\n}\n"],"mappings":"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","names":[]}