kerf-cli 0.1.1 → 0.1.3

package/dist/index.js

@@ -314,8 +314,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 +422,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 +493,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)) {
@@ -573,7 +595,7 @@ function Dashboard({ sessionFilePath, interval }) {
   const recentMessages = session.messages.slice(-8);
   return /* @__PURE__ */ jsxs3(Box3, { flexDirection: "column", children: [
     /* @__PURE__ */ jsxs3(Box3, { borderStyle: "round", borderColor: "cyan", paddingX: 1, children: [
-      /* @__PURE__ */ jsx3(Text3, { bold: true, color: "cyan", children: "kerf watch" }),
+      /* @__PURE__ */ jsx3(Text3, { bold: true, color: "cyan", children: "kerf-cli watch" }),
       /* @__PURE__ */ jsxs3(Text3, { children: [
         " | session: ",
         session.sessionId.slice(0, 8),
@@ -633,7 +655,7 @@ function registerWatchCommand(program2) {
     }
     if (!sessionFilePath) {
       console.log(
-        "No active Claude Code session found. Start Claude Code and run 'kerf watch' again."
+        "No active Claude Code session found. Start Claude Code and run 'kerf-cli watch' again."
       );
       process.exit(0);
     }
@@ -674,8 +696,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"
       });
@@ -736,7 +758,7 @@ async function estimateTaskCost(taskDescription, options = {}) {
     recommendations.push(`Using Opus would cost ~${formatCost(expectedCost * ratio)} (${ratio.toFixed(0)}x more)`);
   }
   if (overhead.percentUsable < 60) {
-    recommendations.push(`High ghost token overhead (${(100 - overhead.percentUsable).toFixed(0)}%). Run 'kerf audit' to optimize.`);
+    recommendations.push(`High ghost token overhead (${(100 - overhead.percentUsable).toFixed(0)}%). Run 'kerf-cli audit' to optimize.`);
   }
   if (fileTokens > 5e4) {
     recommendations.push(`Large file context (${(fileTokens / 1e3).toFixed(0)}K tokens). Consider narrowing scope.`);
@@ -768,7 +790,7 @@ function EstimateCard({ task, estimate }) {
   const formatK = (n) => `${(n / 1e3).toFixed(1)}K`;
   return /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 2, paddingY: 1, children: [
     /* @__PURE__ */ jsxs4(Text4, { bold: true, color: "cyan", children: [
-      "kerf estimate: '",
+      "kerf-cli estimate: '",
       task,
       "'"
     ] }),
@@ -1087,7 +1109,7 @@ function registerBudgetCommand(program2) {
     const projectPath = opts.project || process.cwd();
     const status = manager.checkBudget(projectPath);
     if (!status) {
-      console.log("No budget set for this project. Use 'kerf budget set <amount>' to set one.");
+      console.log("No budget set for this project. Use 'kerf-cli budget set <amount>' to set one.");
       manager.close();
       return;
     }
@@ -1102,7 +1124,7 @@ function registerBudgetCommand(program2) {
     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 budget\n"));
+    console.log(chalk.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))}`);
@@ -1118,11 +1140,11 @@ function registerBudgetCommand(program2) {
     const manager = new BudgetManager();
     const projects = manager.listProjects();
     if (projects.length === 0) {
-      console.log("No projects with budgets. Use 'kerf budget set <amount>' to set one.");
+      console.log("No projects with budgets. Use 'kerf-cli budget set <amount>' to set one.");
       manager.close();
       return;
     }
-    console.log(chalk.bold.cyan("\n  kerf budget list\n"));
+    console.log(chalk.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)})` : "";
@@ -1410,12 +1432,12 @@ function registerAuditCommand(program2) {
       return;
     }
     const gradeColor = result.grade === "A" ? chalk2.green : result.grade === "B" ? chalk2.yellow : chalk2.red;
-    console.log(chalk2.bold.cyan("\n  kerf audit report\n"));
+    console.log(chalk2.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) {
+    if (!opts.claudeMdOnly) {
       console.log(chalk2.bold("  Ghost Token Breakdown:"));
       const oh = result.contextOverhead;
       const fmt = (label, tokens) => {
@@ -1444,17 +1466,52 @@ function registerAuditCommand(program2) {
       console.log(
         `    Critical rules in dead zone: ${cma.criticalRulesInDeadZone > 0 ? chalk2.red(String(cma.criticalRulesInDeadZone)) : "0"}`
       );
+      if (opts.claudeMdOnly) {
+        console.log();
+        console.log(chalk2.bold("  Sections:"));
+        for (const section of cma.sections) {
+          const zone = section.attentionZone === "low-middle" ? chalk2.red(" [dead zone]") : chalk2.green(" [high attention]");
+          const critical = section.hasCriticalRules ? chalk2.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(chalk2.bold("  Suggested section order:"));
+          cma.suggestedReorder.forEach((title, i) => {
+            console.log(`    ${i + 1}. ${title}`);
+          });
+        }
+      }
       console.log();
+    } else if (!opts.mcpOnly && !result.claudeMdAnalysis) {
+      console.log(chalk2.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(chalk2.bold("  MCP Servers:"));
+      for (const server of result.mcpServers) {
+        const heavy = server.isHeavy ? chalk2.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(chalk2.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(chalk2.bold("  Recommendations:"));
+        filteredRecs.forEach((rec, i) => {
+          const priorityColor = rec.priority === "high" ? chalk2.red : rec.priority === "medium" ? chalk2.yellow : chalk2.dim;
+          console.log(
+            `    ${i + 1}. ${priorityColor(`[${rec.priority.toUpperCase()}]`)} ${rec.action}`
+          );
+          console.log(chalk2.dim(`       Impact: ${rec.impact}`));
+        });
+      }
     }
     console.log();
     if (opts.fix) {
@@ -1557,7 +1614,7 @@ function registerReportCommand(program2) {
     }
     const periodLabel = opts.period === "today" ? now.format("ddd, MMM D, YYYY") : opts.period;
     console.log(chalk3.bold.cyan(`
-  kerf report -- ${periodLabel}
+  kerf-cli report -- ${periodLabel}
 `));
     console.log(`  Total Cost:       ${chalk3.bold(formatCost(totalCost))}`);
     console.log(`  Total Tokens:     ${formatTokens(totalInput)} in / ${formatTokens(totalOutput)} out`);
@@ -1609,8 +1666,8 @@ import { mkdirSync as mkdirSync2, existsSync as existsSync5, readFileSync as rea
 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 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!\n"));
+  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("  Setting up cost intelligence for Claude Code...\n");
     const kerfDir = join6(homedir4(), ".kerf");
     if (!existsSync5(kerfDir)) {
@@ -1628,14 +1685,14 @@ function registerInitCommand(program2) {
       }
     }
     try {
-      const { execSync } = await import("node:child_process");
+      const { execSync: execSync2 } = await import("node:child_process");
       try {
-        execSync("which rtk", { stdio: "ignore" });
+        execSync2("which rtk", { stdio: "ignore" });
         console.log(chalk4.green("  Detected RTK (command compression) -- compatible!"));
       } catch {
       }
       try {
-        execSync("which ccusage", { stdio: "ignore" });
+        execSync2("which ccusage", { stdio: "ignore" });
         console.log(chalk4.green("  Detected ccusage -- will import historical data"));
       } catch {
       }
@@ -1664,7 +1721,7 @@ function registerInitCommand(program2) {
         CLAUDE_AUTOCOMPACT_PCT_OVERRIDE: "50"
       }
     }, null, 4).split("\n").map((l) => "    " + l).join("\n")));
-    console.log(chalk4.bold.cyan("\n  Run 'kerf watch' to start the live dashboard!\n"));
+    console.log(chalk4.bold.cyan("\n  Run 'kerf-cli watch' to start the live dashboard!\n"));
   });
 }
 function installHooks(settingsPath) {
@@ -1691,7 +1748,7 @@ function installHooks(settingsPath) {
 
 // src/cli/index.ts
 var program = new Command();
-program.name("kerf").version("0.1.0").description("Cost intelligence for Claude Code. Know before you spend.");
+program.name("kerf-cli").version("0.1.0").description("Cost intelligence for Claude Code. Know before you spend.");
 registerWatchCommand(program);
 registerEstimateCommand(program);
 registerBudgetCommand(program);