claude-launchpad 0.3.0 → 0.3.2

package/README.md

@@ -113,24 +113,26 @@ You see Claude working in real-time — same experience as running `claude` your
 
 ### `eval` — Prove your config works
 
-Runs Claude headless against 9 reproducible scenarios using the [Agent SDK](https://www.npmjs.com/package/@anthropic-ai/claude-agent-sdk) and **scores how well your config actually drives correct behavior**.
+Runs Claude headless against 11 reproducible scenarios using the [Agent SDK](https://www.npmjs.com/package/@anthropic-ai/claude-agent-sdk) and **scores how well your config actually drives correct behavior**.
 
 ```bash
 claude-launchpad eval --suite common
 ```
 
 ```
-  ✓ security/sql-injection          10/10  PASS
-  ✓ security/env-protection         10/10  PASS
-  ✓ security/secret-exposure        10/10  PASS
-  ✓ security/input-validation       10/10  PASS
-  ✓ conventions/error-handling      10/10  PASS
-  ✓ conventions/immutability        10/10  PASS
-  ✓ conventions/no-hardcoded-values 10/10  PASS
-  ✓ conventions/file-size           10/10  PASS
-  ✗ workflow/git-conventions         7/10  WARN
-
-  Config Eval Score      ━━━━━━━━━━━━━━━━━━──    89%
+  ✓ security/sql-injection            10/10  PASS
+  ✓ security/env-protection           10/10  PASS
+  ✓ security/secret-exposure          10/10  PASS
+  ✓ security/input-validation         10/10  PASS
+  ✓ conventions/error-handling        10/10  PASS
+  ✓ conventions/immutability          10/10  PASS
+  ✓ conventions/no-hardcoded-values   10/10  PASS
+  ✓ conventions/naming-conventions    10/10  PASS
+  ✓ conventions/file-size             10/10  PASS
+  ✓ workflow/git-conventions          10/10  PASS
+  ✗ workflow/session-continuity        7/10  WARN
+
+  Config Eval Score      ━━━━━━━━━━━━━━━━━━━─    95%
 ```
 
 Each scenario is a YAML file. [Write your own](scenarios/CONTRIBUTING.md).
@@ -180,7 +182,9 @@ jobs:
 
 Exit code is 1 when score is below the threshold, 0 when it passes.
 
-## Install as a Plugin
+## Plugin (pending marketplace review)
+
+The plugin has been submitted to the Claude Code marketplace. Once approved:
 
 ```bash
 claude plugin install claude-launchpad
@@ -206,7 +210,7 @@ Claude Launchpad gives you a number. Fix the issues, re-run, watch the number go
 - **Enhance uses Claude.** Spawns an interactive session to understand your codebase — costs tokens but produces a CLAUDE.md that actually knows your project.
 - **Eval uses the Agent SDK.** Runs Claude headless in sandboxes with explicit tool permissions — proof that your config works.
 - **Works with any stack.** Auto-detects your project. No fixed menu of supported frameworks.
-- **50 tests.** The tool that tests configs is itself well-tested.
+- **57 tests.** The tool that tests configs is itself well-tested.
 - **You never clone this repo.** It's a tool you run with `npx`, not a template you fork.
 
 ## License

package/dist/cli.js

@@ -2,7 +2,6 @@
 
 // src/cli.ts
 import { Command as Command5 } from "commander";
-import { access as access8 } from "fs/promises";
 import { join as join10 } from "path";
 
 // src/commands/init/index.ts
@@ -70,9 +69,60 @@ function printIssue(severity, analyzer, message, fix) {
   }
   console.log();
 }
+function renderDoctorReport(results) {
+  const overallScore = Math.round(
+    results.reduce((sum, r) => sum + r.score, 0) / results.length
+  );
+  for (const result of results) {
+    printScoreCard(result.name, result.score);
+  }
+  log.blank();
+  printScoreCard("Overall", overallScore);
+  log.blank();
+  const allIssues = results.flatMap((r) => r.issues);
+  const actionable = allIssues.filter((i) => i.severity !== "info");
+  if (actionable.length === 0) {
+    log.success("No issues found. Your configuration looks solid.");
+    return { overallScore, actionableCount: 0 };
+  }
+  const sorted = [...actionable].sort((a, b) => {
+    const order = { critical: 0, high: 1, medium: 2, low: 3, info: 4 };
+    return (order[a.severity] ?? 4) - (order[b.severity] ?? 4);
+  });
+  for (const issue of sorted) {
+    printIssue(issue.severity, issue.analyzer, issue.message, issue.fix);
+  }
+  log.info(`${actionable.length} issue(s) found. Fix critical/high first.`);
+  return { overallScore, actionableCount: actionable.length };
+}
 
-// src/lib/detect.ts
+// src/lib/fs-utils.ts
 import { readFile, access } from "fs/promises";
+async function fileExists(path) {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function readFileOrNull(path) {
+  try {
+    return await readFile(path, "utf-8");
+  } catch {
+    return null;
+  }
+}
+async function readJsonOrNull(path) {
+  try {
+    const content = await readFile(path, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+
+// src/lib/detect.ts
 import { join, basename } from "path";
 async function detectProject(root) {
   const name = basename(root);
@@ -300,29 +350,6 @@ function pmRun(pkg) {
   if (pm?.startsWith("bun")) return "bun";
   return "npm run";
 }
-async function readJsonOrNull(path) {
-  try {
-    const content = await readFile(path, "utf-8");
-    return JSON.parse(content);
-  } catch {
-    return null;
-  }
-}
-async function readFileOrNull(path) {
-  try {
-    return await readFile(path, "utf-8");
-  } catch {
-    return null;
-  }
-}
-async function fileExists(path) {
-  try {
-    await access(path);
-    return true;
-  } catch {
-    return false;
-  }
-}
 async function globExists(dir, pattern) {
   const { readdir: readdir5 } = await import("fs/promises");
   try {
@@ -425,63 +452,24 @@ function generateSettings(detected) {
   if (postToolUse.length > 0) hooks.PostToolUse = postToolUse;
   return Object.keys(hooks).length > 0 ? { hooks } : {};
 }
+var SAFE_FORMATTERS = {
+  TypeScript: { extensions: ["ts", "tsx"], command: "npx prettier --write" },
+  JavaScript: { extensions: ["js", "jsx"], command: "npx prettier --write" },
+  Python: { extensions: ["py"], command: "ruff format" },
+  Go: { extensions: ["go"], command: "gofmt -w" },
+  Rust: { extensions: ["rs"], command: "rustfmt" },
+  Ruby: { extensions: ["rb"], command: "rubocop -A" },
+  Dart: { extensions: ["dart"], command: "dart format" },
+  PHP: { extensions: ["php"], command: "vendor/bin/pint" },
+  Kotlin: { extensions: ["kt", "kts"], command: "ktlint -F" },
+  Java: { extensions: ["java"], command: "google-java-format -i" },
+  Swift: { extensions: ["swift"], command: "swift-format format -i" },
+  Elixir: { extensions: ["ex", "exs"], command: "mix format" },
+  "C#": { extensions: ["cs"], command: "dotnet format" }
+};
 function buildFormatHook(detected) {
   if (!detected.language) return null;
-  const formatters = {
-    TypeScript: {
-      extensions: ["ts", "tsx"],
-      command: detected.formatCommand ?? "npx prettier --write"
-    },
-    JavaScript: {
-      extensions: ["js", "jsx"],
-      command: detected.formatCommand ?? "npx prettier --write"
-    },
-    Python: {
-      extensions: ["py"],
-      command: detected.formatCommand ?? "ruff format"
-    },
-    Go: {
-      extensions: ["go"],
-      command: "gofmt -w"
-    },
-    Rust: {
-      extensions: ["rs"],
-      command: "rustfmt"
-    },
-    Ruby: {
-      extensions: ["rb"],
-      command: "rubocop -A"
-    },
-    Dart: {
-      extensions: ["dart"],
-      command: "dart format"
-    },
-    PHP: {
-      extensions: ["php"],
-      command: detected.formatCommand ?? "vendor/bin/pint"
-    },
-    Kotlin: {
-      extensions: ["kt", "kts"],
-      command: "ktlint -F"
-    },
-    Java: {
-      extensions: ["java"],
-      command: "google-java-format -i"
-    },
-    Swift: {
-      extensions: ["swift"],
-      command: "swift-format format -i"
-    },
-    Elixir: {
-      extensions: ["ex", "exs"],
-      command: "mix format"
-    },
-    "C#": {
-      extensions: ["cs"],
-      command: "dotnet format"
-    }
-  };
-  const config = formatters[detected.language];
+  const config = SAFE_FORMATTERS[detected.language];
   if (!config) return null;
   const extChecks = config.extensions.map((ext) => `[ "$ext" = "${ext}" ]`).join(" || ");
   return {
@@ -640,7 +628,7 @@ function createInitCommand() {
       message: "One-line description (optional):"
     });
     const options = { name: name.trim(), description: description.trim() };
-    const hasClaudeMd = await fileExists2(join2(root, "CLAUDE.md"));
+    const hasClaudeMd = await fileExists(join2(root, "CLAUDE.md"));
     if (hasClaudeMd && !opts.yes) {
       const overwrite = await confirm({
         message: "CLAUDE.md already exists. Overwrite?",
@@ -665,7 +653,7 @@ async function scaffold(root, options, detected) {
   const settingsPath = join2(root, ".claude", "settings.json");
   const mergedSettings = await mergeSettings(settingsPath, settings);
   const claudeignorePath = join2(root, ".claudeignore");
-  const hasClaudeignore = await fileExists2(claudeignorePath);
+  const hasClaudeignore = await fileExists(claudeignorePath);
   const writes = [
     writeFile(join2(root, "CLAUDE.md"), claudeMd),
     writeFile(join2(root, "TASKS.md"), tasksMd),
@@ -686,14 +674,6 @@ async function scaffold(root, options, detected) {
   log.info("Run `claude-launchpad doctor` to check your config quality.");
   log.blank();
 }
-async function fileExists2(path) {
-  try {
-    await readFile2(path);
-    return true;
-  } catch {
-    return false;
-  }
-}
 async function mergeSettings(existingPath, generated) {
   try {
     const existing = JSON.parse(await readFile2(existingPath, "utf-8"));
@@ -719,7 +699,7 @@ async function mergeSettings(existingPath, generated) {
 import { Command as Command2 } from "commander";
 
 // src/lib/parser.ts
-import { readFile as readFile3, readdir, access as access2 } from "fs/promises";
+import { readdir, access as access2 } from "fs/promises";
 import { join as join3, resolve } from "path";
 var CLAUDE_MD = "CLAUDE.md";
 var CLAUDE_DIR = ".claude";
@@ -750,7 +730,7 @@ async function parseClaudeConfig(projectRoot) {
   };
 }
 async function readClaudeMd(root) {
-  return readFileOrNull2(join3(root, CLAUDE_MD));
+  return readFileOrNull(join3(root, CLAUDE_MD));
 }
 function countInstructions(content) {
   const lines = content.split("\n");
@@ -766,7 +746,7 @@ function countInstructions(content) {
   return count;
 }
 async function readSettings(claudeDir) {
-  const raw = await readFileOrNull2(join3(claudeDir, SETTINGS_FILE));
+  const raw = await readFileOrNull(join3(claudeDir, SETTINGS_FILE));
   if (raw === null) return null;
   try {
     return JSON.parse(raw);
@@ -775,7 +755,7 @@ async function readSettings(claudeDir) {
   }
 }
 async function readHooks(claudeDir) {
-  const settingsRaw = await readFileOrNull2(join3(claudeDir, SETTINGS_FILE));
+  const settingsRaw = await readFileOrNull(join3(claudeDir, SETTINGS_FILE));
   if (settingsRaw === null) return [];
   try {
     const settings = JSON.parse(settingsRaw);
@@ -818,7 +798,7 @@ async function readRules(claudeDir) {
   return listFilesRecursive(rulesDir, ".md");
 }
 async function readMcpServers(claudeDir) {
-  const settingsRaw = await readFileOrNull2(join3(claudeDir, SETTINGS_FILE));
+  const settingsRaw = await readFileOrNull(join3(claudeDir, SETTINGS_FILE));
   if (settingsRaw === null) return [];
   try {
     const settings = JSON.parse(settingsRaw);
@@ -848,13 +828,6 @@ async function readSkills(claudeDir) {
   ]);
   return [...commands, ...skills];
 }
-async function readFileOrNull2(path) {
-  try {
-    return await readFile3(path, "utf-8");
-  } catch {
-    return null;
-  }
-}
 async function listFilesRecursive(dir, ext) {
   try {
     await access2(dir);
@@ -1028,12 +1001,12 @@ async function analyzeHooks(config) {
 }
 
 // src/commands/doctor/analyzers/rules.ts
-import { readFile as readFile4, access as access3 } from "fs/promises";
+import { readFile as readFile3 } from "fs/promises";
 import { basename as basename2, join as join4, dirname } from "path";
 async function analyzeRules(config) {
   const issues = [];
   const projectRoot = config.claudeMdPath ? dirname(config.claudeMdPath) : process.cwd();
-  const hasClaudeignore = await fileExists3(join4(projectRoot, ".claudeignore"));
+  const hasClaudeignore = await fileExists(join4(projectRoot, ".claudeignore"));
   if (!hasClaudeignore) {
     issues.push({
       analyzer: "Rules",
@@ -1053,7 +1026,7 @@ async function analyzeRules(config) {
   }
   for (const rulePath of config.rules) {
     try {
-      const content = await readFile4(rulePath, "utf-8");
+      const content = await readFile3(rulePath, "utf-8");
       const trimmed = content.trim();
       if (trimmed.length === 0) {
         issues.push({
@@ -1080,14 +1053,6 @@ async function analyzeRules(config) {
   const score = Math.max(0, 100 - issues.length * 10);
   return { name: "Rules", issues, score };
 }
-async function fileExists3(path) {
-  try {
-    await access3(path);
-    return true;
-  } catch {
-    return false;
-  }
-}
 
 // src/commands/doctor/analyzers/permissions.ts
 async function analyzePermissions(config) {
@@ -1134,7 +1099,7 @@ async function analyzePermissions(config) {
 }
 
 // src/commands/doctor/analyzers/mcp.ts
-import { access as access4 } from "fs/promises";
+import { access as access3 } from "fs/promises";
 async function analyzeMcp(config) {
   const issues = [];
   const servers = config.mcpServers;
@@ -1167,7 +1132,7 @@ async function analyzeMcp(config) {
       const executable = server.command.split(" ")[0];
       if (executable.startsWith("/") || executable.startsWith("./")) {
         try {
-          await access4(executable);
+          await access3(executable);
         } catch {
           issues.push({
             analyzer: "MCP",
@@ -1266,7 +1231,7 @@ async function analyzeQuality(config) {
 }
 
 // src/commands/doctor/fixer.ts
-import { readFile as readFile5, writeFile as writeFile2, mkdir as mkdir2, access as access5 } from "fs/promises";
+import { readFile as readFile4, writeFile as writeFile2, mkdir as mkdir2, access as access4 } from "fs/promises";
 import { join as join5 } from "path";
 async function applyFixes(issues, projectRoot) {
   const detected = await detectProject(projectRoot);
@@ -1351,13 +1316,13 @@ async function addEnvProtectionHook(root) {
 async function addAutoFormatHook(root, detected) {
   if (!detected.language) return false;
   const formatters = {
-    TypeScript: { extensions: ["ts", "tsx"], command: detected.formatCommand ?? "npx prettier --write" },
-    JavaScript: { extensions: ["js", "jsx"], command: detected.formatCommand ?? "npx prettier --write" },
-    Python: { extensions: ["py"], command: detected.formatCommand ?? "ruff format" },
+    TypeScript: { extensions: ["ts", "tsx"], command: "npx prettier --write" },
+    JavaScript: { extensions: ["js", "jsx"], command: "npx prettier --write" },
+    Python: { extensions: ["py"], command: "ruff format" },
     Go: { extensions: ["go"], command: "gofmt -w" },
     Rust: { extensions: ["rs"], command: "rustfmt" },
     Ruby: { extensions: ["rb"], command: "rubocop -A" },
-    PHP: { extensions: ["php"], command: detected.formatCommand ?? "vendor/bin/pint" }
+    PHP: { extensions: ["php"], command: "vendor/bin/pint" }
   };
   const config = formatters[detected.language];
   if (!config) return false;
@@ -1407,7 +1372,7 @@ async function addClaudeMdSection(root, heading, content) {
   const claudeMdPath = join5(root, "CLAUDE.md");
   let existing;
   try {
-    existing = await readFile5(claudeMdPath, "utf-8");
+    existing = await readFile4(claudeMdPath, "utf-8");
   } catch {
     return false;
   }
@@ -1427,7 +1392,7 @@ ${content}
 async function createClaudeignore(root, detected) {
   const ignorePath = join5(root, ".claudeignore");
   try {
-    await access5(ignorePath);
+    await access4(ignorePath);
     return false;
   } catch {
   }
@@ -1439,7 +1404,7 @@ async function createClaudeignore(root, detected) {
 async function createStarterRules(root) {
   const rulesDir = join5(root, ".claude", "rules");
   try {
-    await access5(rulesDir);
+    await access4(rulesDir);
     return false;
   } catch {
   }
@@ -1460,7 +1425,7 @@ async function createStarterRules(root) {
 async function readSettingsJson(root) {
   const path = join5(root, ".claude", "settings.json");
   try {
-    const content = await readFile5(path, "utf-8");
+    const content = await readFile4(path, "utf-8");
     return JSON.parse(content);
   } catch {
     return {};
@@ -1540,29 +1505,7 @@ async function runAndDisplay(projectRoot) {
     analyzePermissions(config),
     analyzeMcp(config)
   ]);
-  const overallScore = Math.round(
-    results.reduce((sum, r) => sum + r.score, 0) / results.length
-  );
-  for (const result of results) {
-    printScoreCard(result.name, result.score);
-  }
-  log.blank();
-  printScoreCard("Overall", overallScore);
-  log.blank();
-  const allIssues = results.flatMap((r) => r.issues);
-  const actionable = allIssues.filter((i) => i.severity !== "info");
-  if (actionable.length === 0) {
-    log.success("No issues found. Your configuration looks solid.");
-    return;
-  }
-  const sorted = [...actionable].sort((a, b) => {
-    const order = { critical: 0, high: 1, medium: 2, low: 3, info: 4 };
-    return (order[a.severity] ?? 4) - (order[b.severity] ?? 4);
-  });
-  for (const issue of sorted) {
-    printIssue(issue.severity, issue.analyzer, issue.message, issue.fix);
-  }
-  log.info(`${actionable.length} issue(s) found. Fix critical/high first.`);
+  renderDoctorReport(results);
 }
 
 // src/commands/doctor/index.ts
@@ -1591,13 +1534,13 @@ function createDoctorCommand() {
       analyzeMcp(config)
     ]);
     if (opts.json) {
-      const overallScore = Math.round(
+      const overallScore2 = Math.round(
         results.reduce((sum, r) => sum + r.score, 0) / results.length
       );
-      console.log(JSON.stringify({ overallScore, analyzers: results, timestamp: (/* @__PURE__ */ new Date()).toISOString() }, null, 2));
+      console.log(JSON.stringify({ overallScore: overallScore2, analyzers: results, timestamp: (/* @__PURE__ */ new Date()).toISOString() }, null, 2));
       return;
     }
-    renderReport(results);
+    const { overallScore } = renderDoctorReport(results);
     if (opts.fix) {
       const allIssues = results.flatMap((r) => r.issues);
       const fixable = allIssues.filter((i) => i.severity !== "info");
@@ -1616,9 +1559,6 @@ function createDoctorCommand() {
       }
     }
     if (opts.minScore) {
-      const overallScore = Math.round(
-        results.reduce((sum, r) => sum + r.score, 0) / results.length
-      );
       const threshold = parseInt(opts.minScore, 10);
       if (overallScore < threshold) {
         process.exit(1);
@@ -1626,31 +1566,6 @@ function createDoctorCommand() {
     }
   });
 }
-function renderReport(results) {
-  const overallScore = Math.round(
-    results.reduce((sum, r) => sum + r.score, 0) / results.length
-  );
-  for (const result of results) {
-    printScoreCard(result.name, result.score);
-  }
-  log.blank();
-  printScoreCard("Overall", overallScore);
-  log.blank();
-  const allIssues = results.flatMap((r) => r.issues);
-  const actionable = allIssues.filter((i) => i.severity !== "info");
-  if (actionable.length === 0) {
-    log.success("No issues found. Your configuration looks solid.");
-    return;
-  }
-  for (const issue of sortBySeverity(actionable)) {
-    printIssue(issue.severity, issue.analyzer, issue.message, issue.fix);
-  }
-  log.info(`${actionable.length} issue(s) found. Fix critical/high first.`);
-}
-function sortBySeverity(issues) {
-  const order = { critical: 0, high: 1, medium: 2, low: 3, info: 4 };
-  return [...issues].sort((a, b) => (order[a.severity] ?? 4) - (order[b.severity] ?? 4));
-}
 
 // src/commands/eval/index.ts
 import { Command as Command3 } from "commander";
@@ -1658,7 +1573,7 @@ import ora from "ora";
 import chalk2 from "chalk";
 
 // src/commands/eval/loader.ts
-import { readFile as readFile6, readdir as readdir3, access as access6 } from "fs/promises";
+import { readFile as readFile5, readdir as readdir3, access as access5 } from "fs/promises";
 import { join as join7, resolve as resolve2, dirname as dirname2 } from "path";
 import { fileURLToPath } from "url";
 import { parse as parseYaml } from "yaml";
@@ -1773,7 +1688,7 @@ async function findScenariosDir() {
 }
 async function dirExists(path) {
   try {
-    await access6(path);
+    await access5(path);
     return true;
   } catch {
     return false;
@@ -1789,7 +1704,7 @@ async function loadScenarios(options) {
     const files = await listYamlFiles(dir);
     for (const file of files) {
       try {
-        const content = await readFile6(file, "utf-8");
+        const content = await readFile5(file, "utf-8");
         const raw = parseYaml(content);
         const scenario = validateScenario(raw, file);
         scenarios.push(scenario);
@@ -1819,7 +1734,7 @@ async function listYamlFiles(dir) {
 }
 
 // src/commands/eval/runner.ts
-import { mkdir as mkdir3, writeFile as writeFile3, readFile as readFile7, readdir as readdir4, rm } from "fs/promises";
+import { mkdir as mkdir3, writeFile as writeFile3, readFile as readFile6, readdir as readdir4, rm } from "fs/promises";
 import { join as join8, dirname as dirname3 } from "path";
 import { tmpdir } from "os";
 import { randomUUID } from "crypto";
@@ -1972,7 +1887,7 @@ async function evaluateSingleCheck(check, sandboxDir) {
 async function checkGrep(check, sandboxDir) {
   if (!check.pattern) return false;
   try {
-    const content = await readFile7(join8(sandboxDir, check.target), "utf-8");
+    const content = await readFile6(join8(sandboxDir, check.target), "utf-8");
     let found;
     try {
       found = new RegExp(check.pattern).test(content);
@@ -1986,7 +1901,7 @@ async function checkGrep(check, sandboxDir) {
 }
 async function checkFileExists(check, sandboxDir) {
   try {
-    await readFile7(join8(sandboxDir, check.target));
+    await readFile6(join8(sandboxDir, check.target));
     return check.expect === "present";
   } catch {
     return check.expect === "absent";
@@ -1994,7 +1909,7 @@ async function checkFileExists(check, sandboxDir) {
 }
 async function checkFileAbsent(check, sandboxDir) {
   try {
-    await readFile7(join8(sandboxDir, check.target));
+    await readFile6(join8(sandboxDir, check.target));
     return check.expect === "absent";
   } catch {
     return check.expect === "present";
@@ -2005,7 +1920,7 @@ async function checkMaxLines(check, sandboxDir) {
   try {
     const files = await listAllFiles(join8(sandboxDir, check.target));
     for (const file of files) {
-      const content = await readFile7(file, "utf-8");
+      const content = await readFile6(file, "utf-8");
       if (content.split("\n").length > maxLines) {
         return check.expect === "absent";
       }
@@ -2145,7 +2060,7 @@ async function checkClaudeCli() {
 import { Command as Command4 } from "commander";
 import { spawn, execFile as execFile2 } from "child_process";
 import { promisify as promisify2 } from "util";
-import { access as access7 } from "fs/promises";
+import { access as access6 } from "fs/promises";
 import { join as join9 } from "path";
 var execAsync = promisify2(execFile2);
 var ENHANCE_PROMPT = `Read CLAUDE.md and the project's codebase, then update CLAUDE.md to fill in missing or incomplete sections.
@@ -2163,6 +2078,12 @@ Sections to fill in or preserve (DO NOT remove any existing section):
 5. **## Key Decisions** \u2014 only decisions that affect how Claude should work in this codebase
 6. **MCP server suggestions** \u2014 look at what external services the project uses (databases, APIs, storage). If you spot Postgres, Redis, Stripe, GitHub API, or similar, suggest relevant MCP servers the user could add. Print these as suggestions at the end, not in CLAUDE.md.
 
+Also review .claude/settings.json hooks:
+- Read the existing hooks in .claude/settings.json
+- If you see project-specific patterns that deserve hooks (e.g., protected directories, test file patterns, migration files), suggest adding them
+- DO NOT overwrite existing hooks \u2014 only add new ones that are specific to this project
+- Print hook suggestions at the end with the exact JSON to add, don't modify settings.json directly
+
 Rules:
 - Don't remove existing content \u2014 only add or improve
 - Be specific to THIS project, not generic advice
@@ -2175,7 +2096,7 @@ function createEnhanceCommand() {
     const root = opts.path;
     const claudeMdPath = join9(root, "CLAUDE.md");
     try {
-      await access7(claudeMdPath);
+      await access6(claudeMdPath);
     } catch {
       log.error("No CLAUDE.md found. Run `claude-launchpad init` first.");
       process.exit(1);
@@ -2202,8 +2123,8 @@ function createEnhanceCommand() {
 }
 
 // src/cli.ts
-var program = new Command5().name("claude-launchpad").description("CLI toolkit that makes Claude Code setups measurably good").version("0.3.0", "-v, --version").action(async () => {
-  const hasConfig = await fileExists4(join10(process.cwd(), "CLAUDE.md")) || await fileExists4(join10(process.cwd(), ".claude", "settings.json"));
+var program = new Command5().name("claude-launchpad").description("CLI toolkit that makes Claude Code setups measurably good").version("0.3.2", "-v, --version").action(async () => {
+  const hasConfig = await fileExists(join10(process.cwd(), "CLAUDE.md")) || await fileExists(join10(process.cwd(), ".claude", "settings.json"));
   if (hasConfig) {
     await program.commands.find((c) => c.name() === "doctor")?.parseAsync([], { from: "user" });
   } else {
@@ -2221,12 +2142,4 @@ program.addCommand(createDoctorCommand());
 program.addCommand(createEnhanceCommand());
 program.addCommand(createEvalCommand());
 program.parse();
-async function fileExists4(path) {
-  try {
-    await access8(path);
-    return true;
-  } catch {
-    return false;
-  }
-}
 //# sourceMappingURL=cli.js.map