kerf-cli 0.1.2 → 0.1.4

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 // src/cli/index.ts
+import { createRequire } from "node:module";
 import { Command } from "commander";
 
 // src/cli/commands/watch.ts
@@ -314,8 +315,11 @@ function getPeriodKey(timestamp, period) {
 }
 function formatPeriodLabel(key, period) {
   switch (period) {
-    case "hour":
-      return dayjs2(key, "YYYY-MM-DD-HH").format("MMM D, h A");
+    case "hour": {
+      const parts = key.split("-");
+      const dateStr = `${parts[0]}-${parts[1]}-${parts[2]}T${parts[3]}:00:00`;
+      return dayjs2(dateStr).format("MMM D, h A");
+    }
     case "day":
       return dayjs2(key).format("ddd, MMM D");
     case "week":
@@ -419,8 +423,25 @@ function ContextBar({ used, total, overhead }) {
 
 // src/core/tokenCounter.ts
 import { readFileSync as readFileSync2, existsSync } from "node:fs";
+import { execSync } from "node:child_process";
 import { join as join3 } from "node:path";
 import { homedir as homedir2 } from "node:os";
+function findGitRootClaudeMd() {
+  try {
+    const gitRoot = execSync("git rev-parse --show-toplevel", {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "ignore"]
+    }).trim();
+    if (gitRoot && gitRoot !== process.cwd()) {
+      return [
+        join3(gitRoot, "CLAUDE.md"),
+        join3(gitRoot, ".claude", "CLAUDE.md")
+      ];
+    }
+  } catch {
+  }
+  return [];
+}
 function estimateTokens(text) {
   return Math.ceil(text.length / 3.5);
 }
@@ -473,7 +494,9 @@ function parseClaudeMdSections(content) {
 function analyzeClaudeMd(filePath) {
   const paths = filePath ? [filePath] : [
     join3(process.cwd(), "CLAUDE.md"),
-    join3(process.cwd(), ".claude", "CLAUDE.md")
+    join3(process.cwd(), ".claude", "CLAUDE.md"),
+    ...findGitRootClaudeMd(),
+    join3(homedir2(), ".claude", "CLAUDE.md")
   ];
   for (const p of paths) {
     if (existsSync(p)) {
@@ -554,10 +577,13 @@ function Dashboard({ sessionFilePath, interval }) {
     const timer = setInterval(refresh, interval);
     return () => clearInterval(timer);
   }, [sessionFilePath, interval]);
-  useInput((input) => {
-    if (input === "q") exit();
-    if (input === "b") setShowBudget((prev) => !prev);
-  });
+  useInput(
+    (input) => {
+      if (input === "q") exit();
+      if (input === "b") setShowBudget((prev) => !prev);
+    },
+    { isActive: process.stdin.isTTY ?? false }
+  );
   if (!session || session.messages.length === 0) {
     return /* @__PURE__ */ jsx3(Box3, { paddingX: 1, children: /* @__PURE__ */ jsx3(Text3, { dimColor: true, children: "Waiting for session data..." }) });
   }
@@ -637,6 +663,12 @@ function registerWatchCommand(program2) {
       );
       process.exit(0);
     }
+    if (!process.stdin.isTTY) {
+      console.log(
+        "kerf-cli watch requires an interactive terminal (TTY). Run it directly in a terminal tab, not piped."
+      );
+      process.exit(1);
+    }
     const { waitUntilExit } = render(
       React2.createElement(Dashboard, { sessionFilePath, interval })
     );
@@ -648,6 +680,7 @@ function registerWatchCommand(program2) {
 import React3 from "react";
 import { render as render2 } from "ink";
 import { glob as glob2 } from "glob";
+import chalk from "chalk";
 
 // src/core/estimator.ts
 import { glob } from "glob";
@@ -674,8 +707,8 @@ async function estimateTaskCost(taskDescription, options = {}) {
   let fileList = options.files ?? [];
   if (fileList.length === 0) {
     try {
-      const { execSync } = await import("node:child_process");
-      const output = execSync("git diff --name-only HEAD 2>/dev/null || git ls-files -m 2>/dev/null", {
+      const { execSync: execSync2 } = await import("node:child_process");
+      const output = execSync2("git diff --name-only HEAD 2>/dev/null || git ls-files -m 2>/dev/null", {
         cwd,
         encoding: "utf-8"
       });
@@ -837,17 +870,42 @@ function registerEstimateCommand(program2) {
     }
     if (opts.compare) {
       const models = ["sonnet", "opus", "haiku"];
-      for (const model of models) {
-        const estimate2 = await estimateTaskCost(task, { model, files, cwd: process.cwd() });
-        if (opts.json) {
+      if (opts.json) {
+        for (const model of models) {
+          const estimate2 = await estimateTaskCost(task, { model, files, cwd: process.cwd() });
           console.log(JSON.stringify(estimate2, null, 2));
-        } else {
-          const { waitUntilExit: waitUntilExit2 } = render2(
-            React3.createElement(EstimateCard, { task, estimate: estimate2 })
-          );
-          await waitUntilExit2();
         }
+        return;
+      }
+      const estimates = await Promise.all(
+        models.map(async (model) => ({
+          model,
+          estimate: await estimateTaskCost(task, { model, files, cwd: process.cwd() })
+        }))
+      );
+      console.log(chalk.bold.cyan(`
+  kerf-cli estimate: '${task}'
+`));
+      console.log(
+        `  ${"Model".padEnd(10)} ${"Turns".padEnd(14)} ${"Low".padEnd(12)} ${"Expected".padEnd(12)} ${"High".padEnd(12)}`
+      );
+      console.log("  " + "-".repeat(58));
+      for (const { model, estimate: estimate2 } of estimates) {
+        const turns = `${estimate2.estimatedTurns.low}-${estimate2.estimatedTurns.high}`;
+        console.log(
+          `  ${model.padEnd(10)} ${turns.padEnd(14)} ${chalk.green(estimate2.estimatedCost.low.padEnd(12))} ${chalk.yellow(estimate2.estimatedCost.expected.padEnd(12))} ${chalk.red(estimate2.estimatedCost.high.padEnd(12))}`
+        );
       }
+      console.log();
+      const cheapest = estimates[2];
+      const priciest = estimates[1];
+      console.log(
+        chalk.dim(`  Cheapest: ${cheapest.model} at ${cheapest.estimate.estimatedCost.expected}`)
+      );
+      console.log(
+        chalk.dim(`  Priciest: ${priciest.model} at ${priciest.estimate.estimatedCost.expected}`)
+      );
+      console.log();
       return;
     }
     const estimate = await estimateTaskCost(task, {
@@ -867,7 +925,7 @@ function registerEstimateCommand(program2) {
 }
 
 // src/cli/commands/budget.ts
-import chalk from "chalk";
+import chalk2 from "chalk";
 
 // src/core/budgetManager.ts
 import dayjs3 from "dayjs";
@@ -1073,12 +1131,12 @@ function registerBudgetCommand(program2) {
     const projectPath = opts.project || process.cwd();
     const amountNum = parseFloat(amount);
     if (isNaN(amountNum) || amountNum <= 0) {
-      console.log(chalk.red("Budget amount must be a positive number."));
+      console.log(chalk2.red("Budget amount must be a positive number."));
       process.exit(1);
     }
     manager.setBudget(projectPath, amountNum, opts.period);
     console.log(
-      chalk.green(`Budget set: ${formatCost(amountNum)}/${opts.period} for ${projectPath}`)
+      chalk2.green(`Budget set: ${formatCost(amountNum)}/${opts.period} for ${projectPath}`)
     );
     manager.close();
   });
@@ -1101,14 +1159,14 @@ function registerBudgetCommand(program2) {
     const filled = Math.round(Math.min(pct, 100) / 100 * barWidth);
     const empty = barWidth - filled;
     const color = pct < 50 ? "green" : pct < 80 ? "yellow" : "red";
-    const barColor = color === "green" ? chalk.green : color === "yellow" ? chalk.yellow : chalk.red;
-    console.log(chalk.bold.cyan("\n  kerf-cli budget\n"));
+    const barColor = color === "green" ? chalk2.green : color === "yellow" ? chalk2.yellow : chalk2.red;
+    console.log(chalk2.bold.cyan("\n  kerf-cli budget\n"));
     console.log(`  Period:  ${status.period} (${status.periodStart.slice(0, 10)} to ${status.periodEnd.slice(0, 10)})`);
     console.log(`  Budget:  ${formatCost(status.budget)}`);
     console.log(`  Spent:   ${barColor(formatCost(status.spent))}`);
     console.log(`  ${barColor("[" + "\u2588".repeat(filled) + "\u2591".repeat(empty) + "]")} ${pct.toFixed(1)}%`);
     if (status.isOverBudget) {
-      console.log(chalk.red.bold(`
+      console.log(chalk2.red.bold(`
   OVER BUDGET by ${formatCost(status.spent - status.budget)}`));
     }
     console.log();
@@ -1122,12 +1180,12 @@ function registerBudgetCommand(program2) {
       manager.close();
       return;
     }
-    console.log(chalk.bold.cyan("\n  kerf-cli budget list\n"));
+    console.log(chalk2.bold.cyan("\n  kerf-cli budget list\n"));
     for (const p of projects) {
       const budgetStr = p.budget ? `${formatCost(p.budget)}/${p.period}` : "no budget";
       const spentStr = p.spent > 0 ? ` (spent: ${formatCost(p.spent)})` : "";
-      console.log(`  ${chalk.bold(p.name)} \u2014 ${budgetStr}${spentStr}`);
-      console.log(chalk.dim(`    ${p.path}`));
+      console.log(`  ${chalk2.bold(p.name)} \u2014 ${budgetStr}${spentStr}`);
+      console.log(chalk2.dim(`    ${p.path}`));
     }
     console.log();
     manager.close();
@@ -1137,7 +1195,7 @@ function registerBudgetCommand(program2) {
     const projectPath = opts.project || process.cwd();
     const removed = manager.removeBudget(projectPath);
     if (removed) {
-      console.log(chalk.green("Budget removed."));
+      console.log(chalk2.green("Budget removed."));
     } else {
       console.log("No budget found for this project.");
     }
@@ -1146,7 +1204,7 @@ function registerBudgetCommand(program2) {
 }
 
 // src/cli/commands/audit.ts
-import chalk2 from "chalk";
+import chalk3 from "chalk";
 
 // src/audit/ghostTokens.ts
 function calculateGrade(percentUsable) {
@@ -1409,14 +1467,14 @@ function registerAuditCommand(program2) {
       console.log(JSON.stringify(result, null, 2));
       return;
     }
-    const gradeColor = result.grade === "A" ? chalk2.green : result.grade === "B" ? chalk2.yellow : chalk2.red;
-    console.log(chalk2.bold.cyan("\n  kerf-cli audit report\n"));
+    const gradeColor = result.grade === "A" ? chalk3.green : result.grade === "B" ? chalk3.yellow : chalk3.red;
+    console.log(chalk3.bold.cyan("\n  kerf-cli audit report\n"));
     console.log(
       `  Context Window Health: ${gradeColor.bold(result.grade)} (${result.contextOverhead.percentUsable.toFixed(0)}% usable)
 `
     );
-    if (!opts.mcpOnly) {
-      console.log(chalk2.bold("  Ghost Token Breakdown:"));
+    if (!opts.claudeMdOnly) {
+      console.log(chalk3.bold("  Ghost Token Breakdown:"));
       const oh = result.contextOverhead;
       const fmt = (label, tokens) => {
         const pct = (tokens / CONTEXT_WINDOW_SIZE * 100).toFixed(1);
@@ -1436,35 +1494,70 @@ function registerAuditCommand(program2) {
     }
     if (!opts.mcpOnly && result.claudeMdAnalysis) {
       const cma = result.claudeMdAnalysis;
-      console.log(chalk2.bold("  CLAUDE.md Analysis:"));
+      console.log(chalk3.bold("  CLAUDE.md Analysis:"));
       console.log(
-        `    Lines: ${cma.totalLines}${cma.isOverLineLimit ? chalk2.yellow(" (over 200 limit)") : ""}`
+        `    Lines: ${cma.totalLines}${cma.isOverLineLimit ? chalk3.yellow(" (over 200 limit)") : ""}`
       );
       console.log(`    Tokens: ${cma.totalTokens.toLocaleString()}`);
       console.log(
-        `    Critical rules in dead zone: ${cma.criticalRulesInDeadZone > 0 ? chalk2.red(String(cma.criticalRulesInDeadZone)) : "0"}`
+        `    Critical rules in dead zone: ${cma.criticalRulesInDeadZone > 0 ? chalk3.red(String(cma.criticalRulesInDeadZone)) : "0"}`
       );
+      if (opts.claudeMdOnly) {
+        console.log();
+        console.log(chalk3.bold("  Sections:"));
+        for (const section of cma.sections) {
+          const zone = section.attentionZone === "low-middle" ? chalk3.red(" [dead zone]") : chalk3.green(" [high attention]");
+          const critical = section.hasCriticalRules ? chalk3.yellow(" *critical rules*") : "";
+          console.log(
+            `    ${section.title.padEnd(30)} ${String(section.tokens).padStart(5)} tokens  L${section.lineStart}-${section.lineEnd}${zone}${critical}`
+          );
+        }
+        if (cma.suggestedReorder.length > 0) {
+          console.log();
+          console.log(chalk3.bold("  Suggested section order:"));
+          cma.suggestedReorder.forEach((title, i) => {
+            console.log(`    ${i + 1}. ${title}`);
+          });
+        }
+      }
       console.log();
+    } else if (!opts.mcpOnly && !result.claudeMdAnalysis) {
+      console.log(chalk3.yellow("  No CLAUDE.md found in current directory or git root.\n"));
     }
-    if (result.recommendations.length > 0) {
-      console.log(chalk2.bold("  Recommendations:"));
-      result.recommendations.forEach((rec, i) => {
-        const priorityColor = rec.priority === "high" ? chalk2.red : rec.priority === "medium" ? chalk2.yellow : chalk2.dim;
+    if (opts.mcpOnly && result.mcpServers.length > 0) {
+      console.log(chalk3.bold("  MCP Servers:"));
+      for (const server of result.mcpServers) {
+        const heavy = server.isHeavy ? chalk3.red(" [heavy]") : "";
         console.log(
-          `    ${i + 1}. ${priorityColor(`[${rec.priority.toUpperCase()}]`)} ${rec.action}`
+          `    ${server.name.padEnd(20)} ${String(server.toolCount).padStart(3)} tools  ${server.estimatedTokens.toLocaleString().padStart(6)} tokens${heavy}`
         );
-        console.log(chalk2.dim(`       Impact: ${rec.impact}`));
-      });
+      }
+      console.log();
+    } else if (opts.mcpOnly && result.mcpServers.length === 0) {
+      console.log(chalk3.dim("  No MCP servers configured.\n"));
+    }
+    if (result.recommendations.length > 0) {
+      const filteredRecs = opts.claudeMdOnly ? result.recommendations.filter((r) => r.category === "claude-md") : opts.mcpOnly ? result.recommendations.filter((r) => r.category === "mcp") : result.recommendations;
+      if (filteredRecs.length > 0) {
+        console.log(chalk3.bold("  Recommendations:"));
+        filteredRecs.forEach((rec, i) => {
+          const priorityColor = rec.priority === "high" ? chalk3.red : rec.priority === "medium" ? chalk3.yellow : chalk3.dim;
+          console.log(
+            `    ${i + 1}. ${priorityColor(`[${rec.priority.toUpperCase()}]`)} ${rec.action}`
+          );
+          console.log(chalk3.dim(`       Impact: ${rec.impact}`));
+        });
+      }
     }
     console.log();
     if (opts.fix) {
-      console.log(chalk2.yellow("  --fix: Auto-fix is not yet implemented. Coming in v0.2.0.\n"));
+      console.log(chalk3.yellow("  --fix: Auto-fix is not yet implemented. Coming in v0.2.0.\n"));
     }
   });
 }
 
 // src/cli/commands/report.ts
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 import dayjs4 from "dayjs";
 function registerReportCommand(program2) {
   program2.command("report").description("Historical cost reports").option("--period <period>", "Time period (today|week|month|all)", "today").option("-p, --project <path>", "Filter to specific project").option("--model", "Show per-model breakdown").option("--sessions", "Show per-session breakdown").option("--csv", "Export as CSV").option("--json", "Export as JSON").action(async (opts) => {
@@ -1556,10 +1649,10 @@ function registerReportCommand(program2) {
       return;
     }
     const periodLabel = opts.period === "today" ? now.format("ddd, MMM D, YYYY") : opts.period;
-    console.log(chalk3.bold.cyan(`
+    console.log(chalk4.bold.cyan(`
   kerf-cli report -- ${periodLabel}
 `));
-    console.log(`  Total Cost:       ${chalk3.bold(formatCost(totalCost))}`);
+    console.log(`  Total Cost:       ${chalk4.bold(formatCost(totalCost))}`);
     console.log(`  Total Tokens:     ${formatTokens(totalInput)} in / ${formatTokens(totalOutput)} out`);
     console.log(`  Cache Hit Rate:   ${cacheHitRate.toFixed(1)}%`);
     console.log(`  Sessions:         ${sessionSummaries.length}`);
@@ -1572,7 +1665,7 @@ function registerReportCommand(program2) {
         existing.sessions++;
         byModel.set(s.model, existing);
       }
-      console.log(chalk3.bold("  Model Breakdown:"));
+      console.log(chalk4.bold("  Model Breakdown:"));
       for (const [model, data] of byModel) {
         const pct = totalCost > 0 ? (data.cost / totalCost * 100).toFixed(1) : "0";
         const shortModel = model.replace("claude-", "").replace(/-20\d{6}$/, "");
@@ -1583,7 +1676,7 @@ function registerReportCommand(program2) {
       console.log();
     }
     if (opts.sessions) {
-      console.log(chalk3.bold("  Session Breakdown:"));
+      console.log(chalk4.bold("  Session Breakdown:"));
       for (const s of sessionSummaries.sort((a, b) => b.cost - a.cost)) {
         console.log(`    ${s.id.slice(0, 12)}  ${formatCost(s.cost)}  ${s.messages} msgs  [${s.model}]`);
       }
@@ -1591,7 +1684,7 @@ function registerReportCommand(program2) {
     }
     const hourly = aggregateCosts(allMessages, "hour");
     if (hourly.length > 1) {
-      console.log(chalk3.bold("  Hourly:"));
+      console.log(chalk4.bold("  Hourly:"));
       const maxCost = Math.max(...hourly.map((h) => h.totalCost));
       for (const h of hourly.slice(-8)) {
         const barLen = maxCost > 0 ? Math.round(h.totalCost / maxCost * 12) : 0;
@@ -1604,39 +1697,39 @@ function registerReportCommand(program2) {
 }
 
 // src/cli/commands/init.ts
-import chalk4 from "chalk";
+import chalk5 from "chalk";
 import { mkdirSync as mkdirSync2, existsSync as existsSync5, readFileSync as readFileSync5, writeFileSync, copyFileSync } from "node:fs";
 import { join as join6, dirname as dirname2 } from "node:path";
 import { homedir as homedir4 } from "node:os";
 function registerInitCommand(program2) {
   program2.command("init").description("Set up kerf-cli for the current project").option("--global", "Install hooks globally").option("--hooks-only", "Only install hooks").option("--no-hooks", "Skip hook installation").option("--force", "Skip confirmation prompts").action(async (opts) => {
-    console.log(chalk4.bold.cyan("\n  Welcome to kerf-cli!\n"));
+    console.log(chalk5.bold.cyan("\n  Welcome to kerf-cli!\n"));
     console.log("  Setting up cost intelligence for Claude Code...\n");
     const kerfDir = join6(homedir4(), ".kerf");
     if (!existsSync5(kerfDir)) {
       mkdirSync2(kerfDir, { recursive: true });
-      console.log(chalk4.green("  Created ~/.kerf/"));
+      console.log(chalk5.green("  Created ~/.kerf/"));
     }
     if (!opts.hooksOnly) {
       try {
         const db = initDatabase();
         runMigrations(db);
         db.close();
-        console.log(chalk4.green("  Created ~/.kerf/kerf.db"));
+        console.log(chalk5.green("  Created ~/.kerf/kerf.db"));
       } catch (err) {
-        console.log(chalk4.red(`  Failed to create database: ${err}`));
+        console.log(chalk5.red(`  Failed to create database: ${err}`));
       }
     }
     try {
-      const { execSync } = await import("node:child_process");
+      const { execSync: execSync2 } = await import("node:child_process");
       try {
-        execSync("which rtk", { stdio: "ignore" });
-        console.log(chalk4.green("  Detected RTK (command compression) -- compatible!"));
+        execSync2("which rtk", { stdio: "ignore" });
+        console.log(chalk5.green("  Detected RTK (command compression) -- compatible!"));
       } catch {
       }
       try {
-        execSync("which ccusage", { stdio: "ignore" });
-        console.log(chalk4.green("  Detected ccusage -- will import historical data"));
+        execSync2("which ccusage", { stdio: "ignore" });
+        console.log(chalk5.green("  Detected ccusage -- will import historical data"));
       } catch {
       }
     } catch {
@@ -1650,21 +1743,21 @@ function registerInitCommand(program2) {
   Hooks will be added to ${opts.global ? "~/.claude" : ".claude"}/settings.json`);
       try {
         installHooks(settingsPath);
-        console.log(chalk4.green("\n  Hooks installed"));
+        console.log(chalk5.green("\n  Hooks installed"));
       } catch (err) {
-        console.log(chalk4.yellow(`
+        console.log(chalk5.yellow(`
   Skipped hook installation: ${err}`));
       }
     }
-    console.log(chalk4.bold("\n  Recommended settings for your setup:"));
-    console.log(chalk4.dim("  Add to .claude/settings.json or ~/.claude/settings.json:"));
-    console.log(chalk4.dim(JSON.stringify({
+    console.log(chalk5.bold("\n  Recommended settings for your setup:"));
+    console.log(chalk5.dim("  Add to .claude/settings.json or ~/.claude/settings.json:"));
+    console.log(chalk5.dim(JSON.stringify({
       env: {
         MAX_THINKING_TOKENS: "10000",
         CLAUDE_AUTOCOMPACT_PCT_OVERRIDE: "50"
       }
     }, null, 4).split("\n").map((l) => "    " + l).join("\n")));
-    console.log(chalk4.bold.cyan("\n  Run 'kerf-cli watch' to start the live dashboard!\n"));
+    console.log(chalk5.bold.cyan("\n  Run 'kerf-cli watch' to start the live dashboard!\n"));
   });
 }
 function installHooks(settingsPath) {
@@ -1690,8 +1783,10 @@ function installHooks(settingsPath) {
 }
 
 // src/cli/index.ts
+var require2 = createRequire(import.meta.url);
+var pkg = require2("../../package.json");
 var program = new Command();
-program.name("kerf-cli").version("0.1.0").description("Cost intelligence for Claude Code. Know before you spend.");
+program.name("kerf-cli").version(pkg.version).description("Cost intelligence for Claude Code. Know before you spend.");
 registerWatchCommand(program);
 registerEstimateCommand(program);
 registerBudgetCommand(program);