@caliber-ai/cli 0.13.0 → 0.14.1

package/dist/bin.js

@@ -1185,20 +1185,8 @@ function writeClaudeConfig(config) {
   const written = [];
   fs9.writeFileSync("CLAUDE.md", config.claudeMd);
   written.push("CLAUDE.md");
-  const claudeDir = ".claude";
-  if (!fs9.existsSync(claudeDir)) fs9.mkdirSync(claudeDir, { recursive: true });
-  fs9.writeFileSync(
-    path10.join(claudeDir, "settings.json"),
-    JSON.stringify(config.settings, null, 2)
-  );
-  written.push(path10.join(claudeDir, "settings.json"));
-  fs9.writeFileSync(
-    path10.join(claudeDir, "settings.local.json"),
-    JSON.stringify(config.settingsLocal, null, 2)
-  );
-  written.push(path10.join(claudeDir, "settings.local.json"));
   if (config.skills?.length) {
-    const skillsDir = path10.join(claudeDir, "skills");
+    const skillsDir = path10.join(".claude", "skills");
     if (!fs9.existsSync(skillsDir)) fs9.mkdirSync(skillsDir, { recursive: true });
     for (const skill of config.skills) {
       const filename = `${skill.name.replace(/[^a-z0-9-]/gi, "-").toLowerCase()}.md`;
@@ -1212,9 +1200,7 @@ function writeClaudeConfig(config) {
     try {
       if (fs9.existsSync(".mcp.json")) {
         const existing = JSON.parse(fs9.readFileSync(".mcp.json", "utf-8"));
-        if (existing.mcpServers) {
-          existingServers = existing.mcpServers;
-        }
+        if (existing.mcpServers) existingServers = existing.mcpServers;
       }
     } catch {
     }
@@ -1319,7 +1305,11 @@ function fileChecksum(filePath) {
 // src/writers/index.ts
 function writeSetup(setup) {
   const filesToWrite = getFilesToWrite(setup);
-  const existingFiles = filesToWrite.filter((f) => fs13.existsSync(f));
+  const filesToDelete = (setup.deletions || []).map((d) => d.filePath).filter((f) => fs13.existsSync(f));
+  const existingFiles = [
+    ...filesToWrite.filter((f) => fs13.existsSync(f)),
+    ...filesToDelete
+  ];
   const backupDir = existingFiles.length > 0 ? createBackup(existingFiles) : void 0;
   const written = [];
   if ((setup.targetAgent === "claude" || setup.targetAgent === "both") && setup.claude) {
@@ -1328,15 +1318,28 @@ function writeSetup(setup) {
   if ((setup.targetAgent === "cursor" || setup.targetAgent === "both") && setup.cursor) {
     written.push(...writeCursorConfig(setup.cursor));
   }
+  const deleted = [];
+  for (const filePath of filesToDelete) {
+    fs13.unlinkSync(filePath);
+    deleted.push(filePath);
+  }
   ensureGitignore();
-  const entries = written.map((file) => ({
-    path: file,
-    action: existingFiles.includes(file) ? "modified" : "created",
-    checksum: fileChecksum(file),
-    timestamp: (/* @__PURE__ */ new Date()).toISOString()
-  }));
+  const entries = [
+    ...written.map((file) => ({
+      path: file,
+      action: existingFiles.includes(file) ? "modified" : "created",
+      checksum: fileChecksum(file),
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    })),
+    ...deleted.map((file) => ({
+      path: file,
+      action: "deleted",
+      checksum: "",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    }))
+  ];
   writeManifest({ version: 1, backupDir, entries });
-  return { written, backupDir };
+  return { written, deleted, backupDir };
 }
 function undoSetup() {
   const manifest = readManifest();
@@ -1351,7 +1354,7 @@ function undoSetup() {
         fs13.unlinkSync(entry.path);
         removed.push(entry.path);
       }
-    } else if (entry.action === "modified" && manifest.backupDir) {
+    } else if ((entry.action === "modified" || entry.action === "deleted") && manifest.backupDir) {
       if (restoreBackup(manifest.backupDir, entry.path)) {
         restored.push(entry.path);
       }
@@ -1366,7 +1369,7 @@ function undoSetup() {
 function getFilesToWrite(setup) {
   const files = [];
   if ((setup.targetAgent === "claude" || setup.targetAgent === "both") && setup.claude) {
-    files.push("CLAUDE.md", ".claude/settings.json", ".claude/settings.local.json");
+    files.push("CLAUDE.md");
     if (setup.claude.mcpServers) files.push(".mcp.json");
     if (setup.claude.skills) {
       for (const s of setup.claude.skills) {
@@ -1582,10 +1585,10 @@ async function initCommand(options) {
   `));
   console.log(chalk3.dim("  Configure your coding agent environment\n"));
   console.log(chalk3.bold("  What is Caliber?\n"));
-  console.log(chalk3.dim("  Caliber analyzes your project and generates optimized configurations"));
-  console.log(chalk3.dim("  for AI coding agents (Claude Code, Cursor). It creates CLAUDE.md,"));
-  console.log(chalk3.dim("  .cursorrules, skills, permissions, and MCP servers tailored to your"));
-  console.log(chalk3.dim("  codebase \u2014 so your AI agent understands your project from day one.\n"));
+  console.log(chalk3.dim("  Caliber audits your AI agent configurations and suggests targeted"));
+  console.log(chalk3.dim("  improvements. It analyzes CLAUDE.md, .cursorrules, skills, and MCP"));
+  console.log(chalk3.dim("  servers against your actual codebase \u2014 keeping what works, fixing"));
+  console.log(chalk3.dim("  what's stale, and adding what's missing.\n"));
   console.log(chalk3.bold("  How it works:\n"));
   console.log(chalk3.dim("  1. Scan      Analyze your code, dependencies, and file structure"));
   console.log(chalk3.dim("  2. Match     Detect existing configs and check for teammate setups"));
@@ -1704,15 +1707,15 @@ async function initCommand(options) {
   if (isEmpty) {
     fingerprint.description = await promptInput("What will you build in this project?");
   }
-  console.log(chalk3.hex("#6366f1").bold("  Step 4/6 \u2014 Planning a better setup\n"));
-  console.log(chalk3.dim("  AI is building CLAUDE.md, permissions, skills, and rules based on"));
-  console.log(chalk3.dim("  your project's stack and conventions.\n"));
+  console.log(chalk3.hex("#6366f1").bold("  Step 4/6 \u2014 Auditing your configs\n"));
+  console.log(chalk3.dim("  AI is auditing your CLAUDE.md, skills, and rules against your"));
+  console.log(chalk3.dim("  project's actual codebase and conventions.\n"));
   console.log(chalk3.dim("  This usually takes 1\u20133 minutes on first run.\n"));
   let generatedSetup = null;
-  let setupExplanation;
   let rawOutput;
   trackEvent("generation_started", { target_agent: targetAgent });
   const hasExistingConfig = !!(ec.claudeMd || ec.claudeSettings || ec.claudeSkills?.length || ec.cursorrules || ec.cursorRules?.length || ec.claudeMcpServers || ec.cursorMcpServers);
+  const genStartTime = Date.now();
   const genSpinner = ora2("Generating setup...").start();
   const genMessages = new SpinnerMessages(genSpinner, GENERATION_MESSAGES, { showElapsedTime: true });
   genMessages.start();
@@ -1729,7 +1732,6 @@ async function initCommand(options) {
       },
       (payload) => {
         generatedSetup = payload.setup;
-        setupExplanation = payload.explanation;
         rawOutput = payload.raw;
       },
       (error) => {
@@ -1757,21 +1759,19 @@ async function initCommand(options) {
     }
     throw new Error("__exit__");
   }
-  genSpinner.succeed("Setup generated");
+  const elapsedMs = Date.now() - genStartTime;
+  const mins = Math.floor(elapsedMs / 6e4);
+  const secs = Math.floor(elapsedMs % 6e4 / 1e3);
+  const timeStr = mins > 0 ? `${mins}m ${secs}s` : `${secs}s`;
+  genSpinner.succeed(`Setup generated ${chalk3.dim(`in ${timeStr}`)}`);
   printSetupSummary(generatedSetup);
   console.log(chalk3.hex("#6366f1").bold("  Step 5/6 \u2014 Review\n"));
-  console.log(chalk3.dim("  Review the proposed files below. You can accept, refine via chat,"));
-  console.log(chalk3.dim("  or see an explanation of why each item was recommended.\n"));
-  let explained = false;
-  let action = await promptAction(explained);
-  while (action === "explain") {
-    if (setupExplanation) {
-      printExplanation(setupExplanation);
-    } else {
-      console.log(chalk3.dim("\nNo explanation available for this setup.\n"));
-    }
-    explained = true;
-    action = await promptAction(explained);
+  console.log(chalk3.dim("  Review the proposed files. You can accept, refine via chat,"));
+  console.log(chalk3.dim("  or preview any file to see exactly what will be written.\n"));
+  let action = await promptAction();
+  while (action === "preview") {
+    await promptFilePreview(generatedSetup);
+    action = await promptAction();
   }
   if (action === "decline") {
     trackEvent("setup_declined");
@@ -1798,11 +1798,21 @@ async function initCommand(options) {
   try {
     const result = writeSetup(generatedSetup);
     writeSpinner.succeed("Config files written");
-    trackEvent("setup_applied", { files_written: result.written.length, target_agent: targetAgent });
+    trackEvent("setup_applied", {
+      files_written: result.written.length,
+      files_deleted: result.deleted.length,
+      target_agent: targetAgent
+    });
     console.log(chalk3.bold("\nFiles created/updated:"));
     for (const file of result.written) {
       console.log(`  ${chalk3.green("\u2713")} ${file}`);
     }
+    if (result.deleted.length > 0) {
+      console.log(chalk3.bold("\nFiles removed:"));
+      for (const file of result.deleted) {
+        console.log(`  ${chalk3.red("\u2717")} ${file}`);
+      }
+    }
     if (result.backupDir) {
       console.log(chalk3.dim(`
   Backups saved to ${result.backupDir}`));
@@ -1856,6 +1866,11 @@ async function initCommand(options) {
   }
   console.log(chalk3.bold.green("\nSetup complete! Your coding agent is now configured."));
   console.log(chalk3.dim("Run `caliber undo` to revert changes.\n"));
+  console.log(chalk3.bold("  Next steps:\n"));
+  console.log(`    ${chalk3.hex("#6366f1")("caliber health")}       Check your config quality and fix issues`);
+  console.log(`    ${chalk3.hex("#6366f1")("caliber recommend")}    Discover additional skills for your stack`);
+  console.log(`    ${chalk3.hex("#6366f1")("caliber diff")}         See what changed since last setup`);
+  console.log("");
 }
 async function refineLoop(currentSetup, _targetAgent) {
   const history = [];
@@ -1920,93 +1935,170 @@ async function promptAgent() {
     ]
   });
 }
-async function promptAction(explained) {
-  const choices = [
-    { name: "Accept and apply", value: "accept" },
-    { name: "Refine via chat", value: "refine" },
-    ...!explained ? [{ name: "Explain recommendations", value: "explain" }] : [],
-    { name: "Decline", value: "decline" }
-  ];
-  return select({ message: "What would you like to do?", choices });
-}
-function fileEntry(filePath, desc) {
-  const icon = fs16.existsSync(filePath) ? chalk3.yellow("~") : chalk3.green("+");
-  const description = desc ? chalk3.dim(`\u2014 ${desc}`) : "";
-  return `  ${icon} ${filePath} ${description}`;
+async function promptAction() {
+  return select({
+    message: "What would you like to do?",
+    choices: [
+      { name: "Accept and apply", value: "accept" },
+      { name: "Refine via chat", value: "refine" },
+      { name: "Preview a file", value: "preview" },
+      { name: "Decline", value: "decline" }
+    ]
+  });
 }
 function printSetupSummary(setup) {
   const claude = setup.claude;
   const cursor = setup.cursor;
-  const descriptions = setup.fileDescriptions || {};
+  const fileDescriptions = setup.fileDescriptions;
+  const deletions = setup.deletions;
   console.log("");
+  console.log(chalk3.bold("  Proposed changes:\n"));
+  const getDescription = (filePath) => {
+    return fileDescriptions?.[filePath];
+  };
   if (claude) {
     if (claude.claudeMd) {
-      console.log(fileEntry("CLAUDE.md", descriptions["CLAUDE.md"]));
-    }
-    if (claude.settings) {
-      console.log(fileEntry(".claude/settings.json", descriptions[".claude/settings.json"]));
-    }
-    if (claude.settingsLocal) {
-      console.log(fileEntry(".claude/settings.local.json", descriptions[".claude/settings.local.json"]));
+      const icon = fs16.existsSync("CLAUDE.md") ? chalk3.yellow("~") : chalk3.green("+");
+      const desc = getDescription("CLAUDE.md");
+      console.log(`  ${icon} ${chalk3.bold("CLAUDE.md")}`);
+      if (desc) {
+        console.log(chalk3.dim(`    ${desc}`));
+      }
+      console.log("");
     }
     const skills = claude.skills;
     if (Array.isArray(skills) && skills.length > 0) {
       for (const skill of skills) {
         const skillPath = `.claude/skills/${skill.name.replace(/[^a-z0-9-]/gi, "-").toLowerCase()}.md`;
-        console.log(fileEntry(skillPath, descriptions[skillPath] || skill.name));
+        const icon = fs16.existsSync(skillPath) ? chalk3.yellow("~") : chalk3.green("+");
+        const desc = getDescription(skillPath);
+        console.log(`  ${icon} ${chalk3.bold(skillPath)}`);
+        console.log(chalk3.dim(`    ${desc || summarizeSkill(skill)}`));
+        console.log("");
       }
     }
     const mcpServers = claude.mcpServers;
     if (mcpServers && Object.keys(mcpServers).length > 0) {
-      console.log(fileEntry(".mcp.json", descriptions[".mcp.json"] || Object.keys(mcpServers).join(", ")));
+      const icon = fs16.existsSync(".mcp.json") ? chalk3.yellow("~") : chalk3.green("+");
+      const serverNames = Object.keys(mcpServers);
+      const desc = getDescription(".mcp.json");
+      console.log(`  ${icon} ${chalk3.bold(".mcp.json")}`);
+      console.log(chalk3.dim(`    ${desc || `servers: ${serverNames.join(", ")}`}`));
+      console.log("");
     }
   }
   if (cursor) {
     if (cursor.cursorrules) {
-      console.log(fileEntry(".cursorrules", descriptions[".cursorrules"]));
+      const icon = fs16.existsSync(".cursorrules") ? chalk3.yellow("~") : chalk3.green("+");
+      const desc = getDescription(".cursorrules");
+      console.log(`  ${icon} ${chalk3.bold(".cursorrules")}`);
+      if (desc) console.log(chalk3.dim(`    ${desc}`));
+      console.log("");
     }
     const rules = cursor.rules;
     if (Array.isArray(rules) && rules.length > 0) {
       for (const rule of rules) {
         const rulePath = `.cursor/rules/${rule.filename}`;
-        console.log(fileEntry(rulePath, descriptions[rulePath]));
+        const icon = fs16.existsSync(rulePath) ? chalk3.yellow("~") : chalk3.green("+");
+        const desc = getDescription(rulePath);
+        console.log(`  ${icon} ${chalk3.bold(rulePath)}`);
+        if (desc) {
+          console.log(chalk3.dim(`    ${desc}`));
+        } else {
+          const firstLine = rule.content.split("\n").filter((l) => l.trim() && !l.trim().startsWith("#"))[0];
+          if (firstLine) console.log(chalk3.dim(`    ${firstLine.trim().slice(0, 80)}`));
+        }
+        console.log("");
       }
     }
     const mcpServers = cursor.mcpServers;
     if (mcpServers && Object.keys(mcpServers).length > 0) {
-      console.log(fileEntry(".cursor/mcp.json", descriptions[".cursor/mcp.json"] || Object.keys(mcpServers).join(", ")));
+      const icon = fs16.existsSync(".cursor/mcp.json") ? chalk3.yellow("~") : chalk3.green("+");
+      const serverNames = Object.keys(mcpServers);
+      const desc = getDescription(".cursor/mcp.json");
+      console.log(`  ${icon} ${chalk3.bold(".cursor/mcp.json")}`);
+      console.log(chalk3.dim(`    ${desc || `servers: ${serverNames.join(", ")}`}`));
+      console.log("");
     }
   }
-  console.log("");
-  console.log(`  ${chalk3.green("+")} ${chalk3.dim("new")}  ${chalk3.yellow("~")} ${chalk3.dim("modified")}`);
+  if (Array.isArray(deletions) && deletions.length > 0) {
+    for (const del of deletions) {
+      console.log(`  ${chalk3.red("-")} ${chalk3.bold(del.filePath)}`);
+      console.log(chalk3.dim(`    ${del.reason}`));
+      console.log("");
+    }
+  }
+  console.log(`  ${chalk3.green("+")} ${chalk3.dim("new")}  ${chalk3.yellow("~")} ${chalk3.dim("modified")}  ${chalk3.red("-")} ${chalk3.dim("removed")}`);
   console.log("");
 }
-function printExplanation(explanation) {
-  console.log(chalk3.bold("\n  Why this setup?\n"));
-  const lines = explanation.split("\n");
-  for (const line of lines) {
-    const trimmed = line.trim();
-    if (!trimmed) continue;
-    const headerMatch = trimmed.match(/^\[(.+)\]$/);
-    if (headerMatch) {
-      console.log(`  ${chalk3.bold.hex("#6366f1")(headerMatch[1])}`);
-      continue;
+function summarizeSkill(skill) {
+  const lines = skill.content.split("\n").filter((l) => l.trim() && !l.trim().startsWith("#"));
+  return lines[0]?.trim().slice(0, 80) || skill.name;
+}
+function collectSetupFiles(setup) {
+  const files = [];
+  const claude = setup.claude;
+  const cursor = setup.cursor;
+  if (claude) {
+    if (claude.claudeMd) files.push({ path: "CLAUDE.md", content: claude.claudeMd });
+    const skills = claude.skills;
+    if (Array.isArray(skills)) {
+      for (const skill of skills) {
+        const skillPath = `.claude/skills/${skill.name.replace(/[^a-z0-9-]/gi, "-").toLowerCase()}.md`;
+        files.push({ path: skillPath, content: skill.content });
+      }
     }
-    const itemMatch = trimmed.match(/^-\s+\*\*(.+?)\*\*[:\s]*(.*)$/);
-    if (itemMatch) {
-      const name = itemMatch[1];
-      const desc = itemMatch[2].replace(/^\s*[-—:]\s*/, "");
-      console.log(`    ${chalk3.dim("\u25B8")} ${chalk3.white(name)}  ${chalk3.dim(desc)}`);
-      continue;
+    if (claude.mcpServers && Object.keys(claude.mcpServers).length > 0) {
+      files.push({ path: ".mcp.json", content: JSON.stringify({ mcpServers: claude.mcpServers }, null, 2) });
     }
-    const plainMatch = trimmed.match(/^-\s+(.*)$/);
-    if (plainMatch) {
-      console.log(`    ${chalk3.dim("\u25B8")} ${chalk3.dim(plainMatch[1])}`);
-      continue;
+  }
+  if (cursor) {
+    if (cursor.cursorrules) files.push({ path: ".cursorrules", content: cursor.cursorrules });
+    const rules = cursor.rules;
+    if (Array.isArray(rules)) {
+      for (const rule of rules) {
+        files.push({ path: `.cursor/rules/${rule.filename}`, content: rule.content });
+      }
+    }
+    if (cursor.mcpServers && Object.keys(cursor.mcpServers).length > 0) {
+      files.push({ path: ".cursor/mcp.json", content: JSON.stringify({ mcpServers: cursor.mcpServers }, null, 2) });
     }
-    console.log(`  ${chalk3.dim(trimmed)}`);
   }
+  return files;
+}
+function previewFileContent(filePath, content, maxLines = 25) {
+  const lines = content.split("\n");
+  const displayLines = lines.slice(0, maxLines);
+  const maxWidth = Math.max(60, ...displayLines.map((l) => l.length + 4));
+  const width = Math.min(maxWidth, 80);
   console.log("");
+  console.log(`  ${chalk3.dim("\u250C\u2500")} ${chalk3.bold(filePath)} ${chalk3.dim("\u2500".repeat(Math.max(0, width - filePath.length - 5)) + "\u2510")}`);
+  console.log(`  ${chalk3.dim("\u2502")}${" ".repeat(width - 1)}${chalk3.dim("\u2502")}`);
+  for (const line of displayLines) {
+    const truncated = line.length > width - 5 ? line.slice(0, width - 8) + "..." : line;
+    const padding = " ".repeat(Math.max(0, width - truncated.length - 3));
+    console.log(`  ${chalk3.dim("\u2502")}  ${truncated}${padding}${chalk3.dim("\u2502")}`);
+  }
+  if (lines.length > maxLines) {
+    console.log(`  ${chalk3.dim("\u2502")}${" ".repeat(width - 1)}${chalk3.dim("\u2502")}`);
+    const note = `(showing first ${maxLines} lines, full file is ${lines.length} lines)`;
+    const notePadding = " ".repeat(Math.max(0, width - note.length - 3));
+    console.log(`  ${chalk3.dim("\u2502")}  ${chalk3.dim(note)}${notePadding}${chalk3.dim("\u2502")}`);
+  }
+  console.log(`  ${chalk3.dim("\u2514" + "\u2500".repeat(width - 1) + "\u2518")}`);
+  console.log("");
+}
+async function promptFilePreview(setup) {
+  const files = collectSetupFiles(setup);
+  if (files.length === 0) {
+    console.log(chalk3.dim("\n  No files to preview.\n"));
+    return;
+  }
+  const choice = await select({
+    message: "Which file to preview?",
+    choices: files.map((f, i) => ({ name: f.path, value: i }))
+  });
+  previewFileContent(files[choice].path, files[choice].content);
 }
 
 // src/commands/undo.ts
@@ -2416,6 +2508,7 @@ function printRecommendations(recs) {
 // src/commands/health.ts
 import chalk9 from "chalk";
 import ora6 from "ora";
+import confirm2 from "@inquirer/confirm";
 async function healthCommand(options) {
   const auth2 = getStoredAuth();
   if (!auth2) {
@@ -2450,30 +2543,44 @@ async function healthCommand(options) {
     return;
   }
   printReport(report);
-  if (options.fix) {
-    console.log(chalk9.bold("\nGenerating fix plan..."));
+  const shouldFix = options.fix || report.recommendations.length > 0 && !options.json && await confirm2({ message: "Would you like to fix these issues?", default: true });
+  if (shouldFix) {
+    const planSpinner = ora6("Generating fix plan...").start();
     const plan = await apiRequest(
       `/api/context/reports/${report.id}/fix-plan`,
       { method: "POST", body: { projectId } }
     );
+    planSpinner.succeed("Fix plan ready");
     if (!plan?.actions.length) {
-      console.log(chalk9.dim("No fixes needed."));
+      console.log(chalk9.dim("  No fixes needed."));
       return;
     }
-    console.log(chalk9.bold("\nProposed actions:"));
+    console.log(chalk9.bold("\n  Fix Plan:\n"));
     for (const action of plan.actions) {
-      const icon = action.type === "remove" ? chalk9.red("- ") : action.type === "add" ? chalk9.green("+ ") : chalk9.yellow("~ ");
-      console.log(`  ${icon}${action.type}: ${action.items.join(", ")}`);
+      if (action.type === "remove") {
+        console.log(`    ${chalk9.red("\u2717 Remove")} ${action.items.join(", ")}`);
+        if (action.reason) console.log(chalk9.dim(`      ${action.reason}`));
+      } else if (action.type === "add") {
+        console.log(`    ${chalk9.green("+ Add")} ${action.items.join(", ")}`);
+        if (action.reason) console.log(chalk9.dim(`      ${action.reason}`));
+      }
+      console.log("");
+    }
+    const scoreAfterStr = plan.estimatedScoreAfter != null ? String(plan.estimatedScoreAfter) : `${report.score + plan.estimatedScoreImprovement}`;
+    console.log(`  Expected: ${report.score} \u2192 ${chalk9.green(scoreAfterStr)}/100
+`);
+    const shouldExecute = options.fix || await confirm2({ message: "Apply this fix plan?", default: true });
+    if (!shouldExecute) {
+      console.log(chalk9.dim("  Fix cancelled."));
+      return;
     }
-    console.log(chalk9.dim(`
-Estimated improvement: +${plan.estimatedScoreImprovement} points`));
-    const fixSpinner = ora6("Executing fix plan...").start();
+    const fixSpinner = ora6("Applying fixes...").start();
     try {
       const result = await apiRequest(
         `/api/context/reports/${report.id}/fix-execute`,
         { method: "POST", body: { projectId } }
       );
-      fixSpinner.succeed("Fix applied");
+      fixSpinner.succeed("Fixes applied");
       console.log("");
       console.log(`  Score: ${result.scoreBefore} \u2192 ${chalk9.green(String(result.scoreAfter))} (${chalk9.green(`+${result.improvement}`)})`);
       if (result.itemsRemoved) console.log(`  Removed: ${result.itemsRemoved} items`);
@@ -2486,6 +2593,13 @@ Estimated improvement: +${plan.estimatedScoreImprovement} points`));
     }
   }
 }
+var CATEGORY_DESCRIPTIONS = {
+  tooling: "build/test/lint commands (helps agents the most)",
+  essential: "constraints agents can't discover from code",
+  convention: "style/naming rules (linters handle this; low value)",
+  overview: "project summaries (agents discover this by reading code)",
+  workflow: "development workflows and processes"
+};
 function printReport(report) {
   const gradeColors = {
     A: chalk9.green,
@@ -2498,24 +2612,43 @@ function printReport(report) {
   console.log(chalk9.bold("\n  Context Health Report\n"));
   console.log(`  Grade: ${gradeColor(report.grade)}  Score: ${gradeColor(String(report.score))}/100
 `);
-  if (Object.keys(report.category_breakdown).length) {
-    console.log(chalk9.dim("  Category Breakdown:"));
-    const categories = Object.entries(report.category_breakdown);
-    const maxCount = Math.max(...categories.map(([, v]) => v.count));
+  const categories = Object.entries(report.category_breakdown);
+  if (categories.length) {
+    console.log(chalk9.bold("  Category Breakdown:\n"));
+    const itemsByCategory = /* @__PURE__ */ new Map();
+    if (report.item_classifications) {
+      for (const item of report.item_classifications) {
+        const cat = item.category.toLowerCase();
+        if (!itemsByCategory.has(cat)) itemsByCategory.set(cat, []);
+        itemsByCategory.get(cat).push(item);
+      }
+    }
     for (const [name, data] of categories) {
-      const barLen = maxCount > 0 ? Math.round(data.count / maxCount * 20) : 0;
-      const bar = "\u2588".repeat(barLen) + "\u2591".repeat(20 - barLen);
-      console.log(`    ${name.padEnd(12)} ${bar} ${data.count} items (${data.tokens} tokens)`);
+      const desc = CATEGORY_DESCRIPTIONS[name] || "";
+      const header = desc ? `${chalk9.bold(name)} ${chalk9.dim(`\u2014 ${desc}`)}` : chalk9.bold(name);
+      console.log(`    ${header}`);
+      const items = itemsByCategory.get(name);
+      if (items?.length) {
+        for (const item of items) {
+          const icon = item.impactScore >= 0 ? chalk9.green("\u2713") : chalk9.red("\u2717");
+          const snippet = item.recommendation.length > 70 ? item.recommendation.slice(0, 67) + "..." : item.recommendation;
+          console.log(`      ${icon} ${item.itemName.padEnd(22)} ${chalk9.dim(`"${snippet}"`)}`);
+        }
+      }
+      console.log(chalk9.dim(`      ${data.count} items \xB7 ${data.tokens} tokens
+`));
     }
-    console.log("");
   }
   if (report.recommendations.length) {
-    console.log(chalk9.dim("  Recommendations:"));
+    console.log(chalk9.bold("  Recommendations:\n"));
     for (const rec of report.recommendations) {
       const icon = rec.priority === "high" ? chalk9.red("!") : rec.priority === "medium" ? chalk9.yellow("~") : chalk9.dim("-");
       console.log(`    ${icon} ${rec.description}`);
+      if (rec.reasoning) {
+        console.log(chalk9.dim(`      ${rec.reasoning}`));
+      }
+      console.log("");
     }
-    console.log("");
   }
 }
 
@@ -3041,7 +3174,7 @@ import chalk14 from "chalk";
 import readline2 from "readline";
 import ora10 from "ora";
 import select2 from "@inquirer/select";
-import confirm2 from "@inquirer/confirm";
+import confirm3 from "@inquirer/confirm";
 function prompt(question) {
   const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
   return new Promise((resolve2) => {
@@ -3121,7 +3254,7 @@ async function reviewCommand(message, options) {
   console.log(`  Most useful:     ${bestPart || chalk14.dim("(skipped)")}`);
   console.log(`  Could be better: ${biggestGap || chalk14.dim("(skipped)")}`);
   console.log(`  Would recommend: ${wouldRecommend}`);
-  const shouldSubmit = await confirm2({ message: "Submit this review?", default: true });
+  const shouldSubmit = await confirm3({ message: "Submit this review?", default: true });
   if (!shouldSubmit) {
     console.log(chalk14.dim("\n  Review cancelled.\n"));
     return;
@@ -3135,7 +3268,8 @@ var pkg3 = JSON.parse(
   fs20.readFileSync(path17.resolve(__dirname2, "..", "package.json"), "utf-8")
 );
 var program = new Command();
-program.name("caliber").description("Configure your coding agent environment").version(pkg3.version);
+var displayVersion = process.env.CALIBER_LOCAL ? `${pkg3.version}-local` : pkg3.version;
+program.name(process.env.CALIBER_LOCAL ? "caloc" : "caliber").description("Configure your coding agent environment").version(displayVersion);
 program.command("init").description("Initialize coding agent setup for this project").option("--agent <type>", "Target agent: claude, cursor, or both").option("--dry-run", "Preview changes without writing files").option("--force", "Overwrite existing setup without prompting").action(initCommand);
 program.command("undo").description("Revert all config changes made by Caliber").action(undoCommand);
 program.command("status").description("Show current Caliber setup status").option("--json", "Output as JSON").action(statusCommand);
@@ -3160,13 +3294,13 @@ import { fileURLToPath as fileURLToPath4 } from "url";
 import { execSync as execSync4 } from "child_process";
 import chalk15 from "chalk";
 import ora11 from "ora";
-import confirm3 from "@inquirer/confirm";
+import confirm4 from "@inquirer/confirm";
 var __dirname_vc = path18.dirname(fileURLToPath4(import.meta.url));
 var pkg4 = JSON.parse(
   fs21.readFileSync(path18.resolve(__dirname_vc, "..", "package.json"), "utf-8")
 );
 async function promptYesNo(question) {
-  return confirm3({ message: question, default: true });
+  return confirm4({ message: question, default: true });
 }
 async function checkForUpdates() {
   if (process.env.CALIBER_SKIP_UPDATE_CHECK) return;
@@ -3231,6 +3365,9 @@ Restarting: caliber ${args.join(" ")}
 }
 
 // src/bin.ts
+if (process.env.CALIBER_LOCAL) {
+  process.env.CALIBER_SKIP_UPDATE_CHECK = "1";
+}
 var firstRun = isFirstRun();
 getDeviceId();
 if (firstRun) {