claude-launchpad 1.12.0 → 1.14.0

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   readSyncConfig
-} from "./chunk-ZLI4LI33.js";
+} from "./chunk-M6GVFN67.js";
 import {
   BACKLOG_CONTENT,
   ENHANCE_SKILL_VERSION,
@@ -16,6 +16,7 @@ import {
   STALE_SWARM_PHRASE,
   STOP_AND_SWARM_CONTENT,
   TESTING_DISCIPLINE_CONTENT,
+  VERIFICATION_RULE_VERSION,
   WORKFLOW_CHECK_WRAPPER,
   WORKFLOW_RULE_VERSION,
   applyFixes,
@@ -26,6 +27,7 @@ import {
   generateEnhanceSkill,
   generateHooksRule,
   generateReviewerAgent,
+  generateVerificationRule,
   generateWorkflowRule,
   hasEnvVarHookPattern,
   isJqAvailable,
@@ -38,7 +40,7 @@ import {
   sprintReviewsContent,
   writeSprintHygieneScripts,
   writeWorkflowCheckScript
-} from "./chunk-KPO4YURF.js";
+} from "./chunk-QEPE3WVF.js";
 
 // src/cli.ts
 import { Command as Command5 } from "commander";
@@ -250,16 +252,22 @@ function dirTreeContains(dir, needle, depth) {
 
 // src/commands/init/index.ts
 function createInitCommand() {
-  return new Command("init").description("Set up Claude Code configuration for any project").option("-n, --name <name>", "Project name").option("-y, --yes", "Accept all defaults (does not overwrite existing files)").option("-f, --force", "Overwrite existing CLAUDE.md").action(async (opts) => {
+  return new Command("init").description("Set up Claude Code configuration for any project").option("-n, --name <name>", "Project name").option(
+    "-y, --yes",
+    "Accept all defaults (does not overwrite existing files)"
+  ).option("-f, --force", "Overwrite existing CLAUDE.md").action(async (opts) => {
     printBanner();
     const root = process.cwd();
     log.step("Detecting project...");
     const detected = await detectProject(root);
     if (detected.language) {
       log.success(`Found ${detected.framework ?? detected.language} project`);
-      if (detected.packageManager) log.info(`Package manager: ${detected.packageManager}`);
-      if (detected.devCommand) log.info(`Dev command: ${detected.devCommand}`);
-      if (detected.testCommand) log.info(`Test command: ${detected.testCommand}`);
+      if (detected.packageManager)
+        log.info(`Package manager: ${detected.packageManager}`);
+      if (detected.devCommand)
+        log.info(`Dev command: ${detected.devCommand}`);
+      if (detected.testCommand)
+        log.info(`Test command: ${detected.testCommand}`);
     } else {
       log.warn("Could not detect project type \u2014 generating minimal config");
     }
@@ -271,13 +279,18 @@ function createInitCommand() {
     const description = opts.yes ? "" : await input({
       message: "One-line description (optional):"
     });
-    const options = { name: name.trim(), description: description.trim() };
+    const options = {
+      name: name.trim(),
+      description: description.trim()
+    };
     const hasClaudeMd = await fileExists(join2(root, "CLAUDE.md"));
     if (hasClaudeMd) {
       if (opts.force) {
         log.warn("Overwriting existing CLAUDE.md (--force)");
       } else if (opts.yes) {
-        log.error("CLAUDE.md already exists. `--yes` will not overwrite existing files.");
+        log.error(
+          "CLAUDE.md already exists. `--yes` will not overwrite existing files."
+        );
         log.info("Run `claude-launchpad doctor --fix` to update in place,");
         log.info("or re-run with `--force` to overwrite.");
         process.exitCode = 1;
@@ -290,7 +303,9 @@ function createInitCommand() {
         if (!overwrite) {
           log.info("Keeping existing CLAUDE.md");
           await createEnhanceSkillPrompt(root, false);
-          log.step("Tip: run `claude-launchpad doctor` to check your existing config");
+          log.step(
+            "Tip: run `claude-launchpad doctor` to check your existing config"
+          );
           return;
         }
       }
@@ -300,14 +315,19 @@ function createInitCommand() {
 }
 async function scaffold(root, options, detected, skipPrompts) {
   log.step("Generating configuration...");
-  const claudeMd = generateClaudeMd(options, detected, { superpowers: isSuperpowersInstalled() });
+  const claudeMd = generateClaudeMd(options, detected, {
+    superpowers: isSuperpowersInstalled()
+  });
   const tasksMd = generateTasksMd(options);
   const backlogMd = generateBacklogMd(options);
   const settings = generateSettings(detected);
   const claudeignore = generateClaudeignore(detected);
   await mkdir(join2(root, ".claude", "rules"), { recursive: true });
   const settingsPath = join2(root, ".claude", "settings.json");
-  const mergedSettings = await mergeSettings(settingsPath, settings);
+  const mergedSettings = await mergeSettings(
+    settingsPath,
+    settings
+  );
   const backlogPath = join2(root, "BACKLOG.md");
   const hasBacklog = await fileExists(backlogPath);
   const claudeignorePath = join2(root, ".claudeignore");
@@ -320,6 +340,13 @@ async function scaffold(root, options, detected, skipPrompts) {
   const hasWorkflowRule = await fileExists(workflowRulePath);
   const hooksRulePath = join2(root, ".claude", "rules", "hooks.md");
   const hasHooksRule = await fileExists(hooksRulePath);
+  const verificationRulePath = join2(
+    root,
+    ".claude",
+    "rules",
+    "verification.md"
+  );
+  const hasVerificationRule = await fileExists(verificationRulePath);
   const writes = [
     writeFile(join2(root, "CLAUDE.md"), claudeMd),
     writeFile(join2(root, "TASKS.md"), tasksMd),
@@ -332,16 +359,21 @@ async function scaffold(root, options, detected, skipPrompts) {
     writes.push(writeFile(claudeignorePath, claudeignore));
   }
   if (!hasClaudeGitignore) {
-    writes.push(writeFile(claudeGitignorePath, [
-      "# Local-only Claude Code files (never commit these)",
-      "CLAUDE.md",
-      "settings.local.json",
-      "plans/",
-      "memory/",
-      "sessions/",
-      "tmp/",
-      ""
-    ].join("\n")));
+    writes.push(
+      writeFile(
+        claudeGitignorePath,
+        [
+          "# Local-only Claude Code files (never commit these)",
+          "CLAUDE.md",
+          "settings.local.json",
+          "plans/",
+          "memory/",
+          "sessions/",
+          "tmp/",
+          ""
+        ].join("\n")
+      )
+    );
   }
   if (!hasRules) {
     const rulesContent = generateStarterRules(detected);
@@ -353,6 +385,9 @@ async function scaffold(root, options, detected, skipPrompts) {
   if (!hasHooksRule) {
     writes.push(writeFile(hooksRulePath, generateHooksRule()));
   }
+  if (!hasVerificationRule) {
+    writes.push(writeFile(verificationRulePath, generateVerificationRule()));
+  }
   const reviewerAgentPath = join2(root, ".claude", "agents", "code-reviewer.md");
   const hasReviewerAgent = await fileExists(reviewerAgentPath);
   if (!hasReviewerAgent) {
@@ -363,26 +398,47 @@ async function scaffold(root, options, detected, skipPrompts) {
   await writeSprintHygieneScripts(root);
   await writeWorkflowCheckScript(root);
   log.success("Generated CLAUDE.md");
-  if (!hasReviewerAgent) log.success("Generated .claude/agents/code-reviewer.md (independent sprint reviewer)");
+  if (!hasReviewerAgent)
+    log.success(
+      "Generated .claude/agents/code-reviewer.md (independent sprint reviewer)"
+    );
   log.success("Generated TASKS.md");
   if (!hasBacklog) log.success("Generated BACKLOG.md");
   log.success("Generated .claude/settings.json (schema, permissions, hooks)");
   if (!hasClaudeGitignore) log.success("Generated .claude/.gitignore");
   if (!hasClaudeignore) log.success("Generated .claudeignore");
   if (!hasRules) log.success("Generated .claude/rules/conventions.md");
-  if (!hasWorkflowRule) log.success("Generated .claude/rules/workflow.md (workflow rules, path-scoped)");
-  if (!hasHooksRule) log.success("Generated .claude/rules/hooks.md (hook authoring rules, path-scoped)");
-  log.success("Generated .claude/hooks/sprint-{size,open}-check.sh + workflow-check.sh");
+  if (!hasWorkflowRule)
+    log.success(
+      "Generated .claude/rules/workflow.md (workflow rules, path-scoped)"
+    );
+  if (!hasHooksRule)
+    log.success(
+      "Generated .claude/rules/hooks.md (hook authoring rules, path-scoped)"
+    );
+  if (!hasVerificationRule)
+    log.success(
+      "Generated .claude/rules/verification.md (evidence-before-assertion discipline)"
+    );
+  log.success(
+    "Generated .claude/hooks/sprint-{size,open}-check.sh + workflow-check.sh"
+  );
   await createEnhanceSkillPrompt(root, skipPrompts);
   log.blank();
   if (!isJqAvailable()) {
-    log.warn("jq not found on PATH \u2014 the generated hooks (including the .env and destructive-command guards) will silently no-op until you install it: https://jqlang.github.io/jq/download/");
+    log.warn(
+      "jq not found on PATH \u2014 the generated hooks (including the .env and destructive-command guards) will silently no-op until you install it: https://jqlang.github.io/jq/download/"
+    );
   }
   if (!isSuperpowersInstalled()) {
-    log.info("Optional: the superpowers plugin adds brainstorm/plan/TDD/review discipline \u2014 /plugin install superpowers@claude-plugins-official");
+    log.info(
+      "Optional: the superpowers plugin adds brainstorm/plan/TDD/review discipline \u2014 /plugin install superpowers@claude-plugins-official"
+    );
   }
   log.success("Done! Run `claude` to start.");
-  log.info("Use `/lp-enhance` inside Claude Code to have AI complete your CLAUDE.md.");
+  log.info(
+    "Use `/lp-enhance` inside Claude Code to have AI complete your CLAUDE.md."
+  );
   log.info("Run `claude-launchpad doctor` to check your config quality.");
   log.blank();
 }
@@ -414,19 +470,32 @@ function generateStarterRules(detected) {
   lines.push("", "## Testing Discipline", "", TESTING_DISCIPLINE_CONTENT);
   const verify = [detected.testCommand, detected.lintCommand].filter((c) => !!c).map((c) => `\`${c}\``).join(" && ");
   lines.push("", "## Pre-Commit Checklist", "");
-  lines.push(verify ? `1. Run ${verify} \u2014 never commit if either fails` : "1. Run the project's test and typecheck commands \u2014 never commit if either fails");
-  lines.push("2. For hard-TDD surfaces, confirm the test was written before the implementation");
-  lines.push("3. Before sprint-ending commits: run /code-review on the sprint diff (see ## Sprint Reviews in CLAUDE.md)");
+  lines.push(
+    verify ? `1. Run ${verify} \u2014 never commit if either fails` : "1. Run the project's test and typecheck commands \u2014 never commit if either fails"
+  );
+  lines.push(
+    "2. For hard-TDD surfaces, confirm the test was written before the implementation"
+  );
+  lines.push(
+    "3. Before sprint-ending commits: run /code-review on the sprint diff (see ## Sprint Reviews in CLAUDE.md)"
+  );
   lines.push("", "## Skill Authoring", "", SKILL_AUTHORING_CONTENT);
   lines.push("");
   return lines.join("\n");
 }
 async function createEnhanceSkillPrompt(root, skipPrompts) {
   const projectPath = join2(root, ".claude", "skills", "lp-enhance", "SKILL.md");
-  const globalPath = join2(homedir2(), ".claude", "skills", "lp-enhance", "SKILL.md");
+  const globalPath = join2(
+    homedir2(),
+    ".claude",
+    "skills",
+    "lp-enhance",
+    "SKILL.md"
+  );
   const legacyProject = join2(root, ".claude", "commands", "lp-enhance.md");
   const legacyGlobal = join2(homedir2(), ".claude", "commands", "lp-enhance.md");
-  if (await fileExists(projectPath) || await fileExists(globalPath) || await fileExists(legacyProject) || await fileExists(legacyGlobal)) return;
+  if (await fileExists(projectPath) || await fileExists(globalPath) || await fileExists(legacyProject) || await fileExists(legacyGlobal))
+    return;
   const scope = skipPrompts ? "project" : await select({
     message: "Install /lp-enhance skill (AI-powered CLAUDE.md improver):",
     choices: [
@@ -443,7 +512,9 @@ async function createEnhanceSkillPrompt(root, skipPrompts) {
 }
 async function mergeSettings(existingPath, generated) {
   try {
-    const existing = JSON.parse(await readFile(existingPath, "utf-8"));
+    const existing = JSON.parse(
+      await readFile(existingPath, "utf-8")
+    );
     const existingHooks = existing.hooks ?? {};
     const generatedHooks = generated.hooks ?? {};
     const mergedHooks = { ...existingHooks };
@@ -1000,7 +1071,9 @@ async function analyzeRules(config) {
       fix: "Run `claude-launchpad init` or `doctor --fix` to generate one"
     });
   }
-  const hasWorkflowRule = await fileExists(join4(projectRoot, ".claude", "rules", "workflow.md"));
+  const hasWorkflowRule = await fileExists(
+    join4(projectRoot, ".claude", "rules", "workflow.md")
+  );
   if (!hasWorkflowRule) {
     issues.push({
       analyzer: "Rules",
@@ -1009,7 +1082,9 @@ async function analyzeRules(config) {
       fix: "Run `doctor --fix` to generate it"
     });
   }
-  const hasReviewerAgent = await fileExists(join4(projectRoot, ".claude", "agents", "code-reviewer.md"));
+  const hasReviewerAgent = await fileExists(
+    join4(projectRoot, ".claude", "agents", "code-reviewer.md")
+  );
   if (!hasReviewerAgent) {
     issues.push({
       analyzer: "Rules",
@@ -1026,7 +1101,10 @@ async function analyzeRules(config) {
     });
   }
   if (hasWorkflowRule) {
-    const wfContent = await readFile2(join4(projectRoot, ".claude", "rules", "workflow.md"), "utf-8").catch(() => "");
+    const wfContent = await readFile2(
+      join4(projectRoot, ".claude", "rules", "workflow.md"),
+      "utf-8"
+    ).catch(() => "");
     const wfMatch = wfContent.match(/<!-- lp-workflow-version: (\d+) -->/);
     const wfVersion = wfMatch ? parseInt(wfMatch[1], 10) : null;
     if (wfVersion !== null && wfVersion < WORKFLOW_RULE_VERSION) {
@@ -1038,7 +1116,9 @@ async function analyzeRules(config) {
       });
     }
   }
-  const hasHooksRule = await fileExists(join4(projectRoot, ".claude", "rules", "hooks.md"));
+  const hasHooksRule = await fileExists(
+    join4(projectRoot, ".claude", "rules", "hooks.md")
+  );
   if (!hasHooksRule) {
     issues.push({
       analyzer: "Rules",
@@ -1047,6 +1127,33 @@ async function analyzeRules(config) {
       fix: "Run `doctor --fix` to generate it"
     });
   }
+  const verificationPath = join4(
+    projectRoot,
+    ".claude",
+    "rules",
+    "verification.md"
+  );
+  const hasVerificationRule = await fileExists(verificationPath);
+  if (!hasVerificationRule) {
+    issues.push({
+      analyzer: "Rules",
+      severity: "medium",
+      message: "No .claude/rules/verification.md found \u2014 nothing stops premature 'done' claims without evidence",
+      fix: "Run `doctor --fix` to generate it"
+    });
+  } else {
+    const vContent = await readFile2(verificationPath, "utf-8").catch(() => "");
+    const vMatch = vContent.match(/<!-- lp-verification-version: (\d+) -->/);
+    const vVersion = vMatch ? parseInt(vMatch[1], 10) : null;
+    if (vVersion !== null && vVersion < VERIFICATION_RULE_VERSION) {
+      issues.push({
+        analyzer: "Rules",
+        severity: "low",
+        message: `verification.md rule is outdated (v${vVersion}, latest v${VERIFICATION_RULE_VERSION})`,
+        fix: "Run `doctor --fix` to update it"
+      });
+    }
+  }
   const hasClaudeignore = await fileExists(join4(projectRoot, ".claudeignore"));
   if (!hasClaudeignore) {
     issues.push({
@@ -1059,7 +1166,9 @@ async function analyzeRules(config) {
   const hasSkillInProject = config.skills.some(
     (s) => basename(s) === "SKILL.md" && s.includes("lp-enhance") || basename(s) === "lp-enhance.md"
   );
-  const hasSkillGlobal = await fileExists(join4(homedir3(), ".claude", "skills", "lp-enhance", "SKILL.md")) || await fileExists(join4(homedir3(), ".claude", "commands", "lp-enhance.md"));
+  const hasSkillGlobal = await fileExists(
+    join4(homedir3(), ".claude", "skills", "lp-enhance", "SKILL.md")
+  ) || await fileExists(join4(homedir3(), ".claude", "commands", "lp-enhance.md"));
   if (!hasSkillInProject && !hasSkillGlobal) {
     issues.push({
       analyzer: "Rules",
@@ -1530,6 +1639,17 @@ async function analyzeMemory(config, projectRoot) {
       fix: "Run `doctor --fix` to add agentic-memory to allowedMcpServers"
     });
   }
+  const hasBareBinaryHook = config.hooks.some(
+    (h) => h.command?.includes("claude-launchpad memory") && !h.command.includes("npx claude-launchpad")
+  );
+  if (hasBareBinaryHook) {
+    issues.push({
+      analyzer: "Memory",
+      severity: "medium",
+      message: "Memory hook(s) call the bare claude-launchpad binary \u2014 fails silently on machines without a global install",
+      fix: "Run `doctor --fix` to rewrite them to the npx form"
+    });
+  }
   const syncConfig = readSyncConfig();
   if (syncConfig) {
     const hasSessionStartPull = config.hooks.some(
@@ -2305,6 +2425,10 @@ async function listYamlFiles(dir) {
     return [];
   }
 }
+function resolveRuns(scenarioRuns, cliRuns, userChoseRuns) {
+  if (userChoseRuns) return cliRuns;
+  return scenarioRuns ?? cliRuns;
+}
 
 // src/commands/eval/runner.ts
 import { mkdir as mkdir2, writeFile as writeFile2, rm, cp } from "fs/promises";
@@ -2616,8 +2740,19 @@ async function scoreResults(scenario, sandboxDir, transcript, model) {
 
 // src/commands/eval/index.ts
 function createEvalCommand() {
-  return new Command3("eval").description("Test your Claude Code config against eval scenarios").option("-s, --suite <suite>", "Eval suite to run (e.g., security, conventions, workflow)").option("-p, --path <path>", "Project root path", process.cwd()).option("--scenarios <path>", "Custom scenarios directory").option("--runs <n>", "Runs per scenario (default: 3)", "3").option("--timeout <ms>", "Timeout per run in ms (default: 120000)", "120000").option("--json", "Output as JSON").option("--debug", "Keep sandbox directories for inspection").option("--model <model>", "Model to use for eval (e.g., sonnet, haiku, opus)").action(async (opts) => {
+  return new Command3("eval").description("Test your Claude Code config against eval scenarios").option(
+    "-s, --suite <suite>",
+    "Eval suite to run (e.g., security, conventions, workflow)"
+  ).option("-p, --path <path>", "Project root path", process.cwd()).option("--scenarios <path>", "Custom scenarios directory").option("--runs <n>", "Runs per scenario (default: 3)", "3").option(
+    "--timeout <ms>",
+    "Timeout per run in ms (default: 120000)",
+    "120000"
+  ).option("--json", "Output as JSON").option("--debug", "Keep sandbox directories for inspection").option(
+    "--model <model>",
+    "Model to use for eval (e.g., sonnet, haiku, opus)"
+  ).action(async (opts, command) => {
     printBanner();
+    let userChoseRuns = command.getOptionValueSource("runs") === "cli";
     const hasFlags = opts.suite || opts.model || opts.runs !== "3" || opts.timeout !== "120000" || opts.path !== process.cwd() || Boolean(opts.scenarios) || opts.json || opts.debug;
     if (!hasFlags) {
       opts.suite = await select2({
@@ -2625,8 +2760,8 @@ function createEvalCommand() {
         choices: [
           { name: "security (7 scenarios)", value: "security" },
           { name: "conventions (5 scenarios)", value: "conventions" },
-          { name: "workflow (4 scenarios)", value: "workflow" },
-          { name: "all (16 scenarios)", value: void 0 }
+          { name: "workflow (5 scenarios)", value: "workflow" },
+          { name: "all (17 scenarios)", value: void 0 }
         ]
       });
       opts.runs = await select2({
@@ -2637,6 +2772,7 @@ function createEvalCommand() {
           { name: "5 \u2014 thorough", value: "5" }
         ]
       });
+      userChoseRuns = true;
       opts.model = await select2({
         message: "Model",
         choices: [
@@ -2649,8 +2785,12 @@ function createEvalCommand() {
     }
     const claudeAvailable = await checkClaudeCli();
     if (!claudeAvailable) {
-      log.error("Claude CLI not found. Install it: https://docs.anthropic.com/en/docs/claude-code");
-      log.info("The eval command runs Claude headless against scenarios \u2014 it requires the CLI.");
+      log.error(
+        "Claude CLI not found. Install it: https://docs.anthropic.com/en/docs/claude-code"
+      );
+      log.info(
+        "The eval command runs Claude headless against scenarios \u2014 it requires the CLI."
+      );
       process.exit(1);
     }
     log.step("Loading eval scenarios...");
@@ -2661,7 +2801,9 @@ function createEvalCommand() {
     if (scenarios.length === 0) {
       log.warn("No matching scenarios found.");
       if (opts.suite) {
-        log.info(`Check that the suite "${opts.suite}" exists in the scenarios directory.`);
+        log.info(
+          `Check that the suite "${opts.suite}" exists in the scenarios directory.`
+        );
       }
       return;
     }
@@ -2670,10 +2812,11 @@ function createEvalCommand() {
       log.info(`Model: ${opts.model}`);
     }
     log.blank();
-    const runs = parseInt(opts.runs, 10);
+    const cliRuns = parseInt(opts.runs, 10);
     const timeout = parseInt(opts.timeout, 10);
     const results = [];
     for (const scenario of scenarios) {
+      const runs = resolveRuns(scenario.runs, cliRuns, userChoseRuns);
       const spinner = ora({
         text: `Running: ${scenario.name} (${runs} run${runs > 1 ? "s" : ""})`,
         prefixText: "  "
@@ -2681,13 +2824,22 @@ function createEvalCommand() {
       try {
         const result = await runScenarioWithRetries(
           { ...scenario, runs },
-          { projectRoot: opts.path, timeout, debug: opts.debug, model: opts.model }
+          {
+            projectRoot: opts.path,
+            timeout,
+            debug: opts.debug,
+            model: opts.model
+          }
         );
         results.push(result);
         if (result.passed) {
-          spinner.succeed(`${scenario.name}  ${result.score}/${result.maxScore}`);
+          spinner.succeed(
+            `${scenario.name}  ${result.score}/${result.maxScore}`
+          );
         } else {
-          spinner.fail(`${scenario.name}  ${result.score}/${result.maxScore}`);
+          spinner.fail(
+            `${scenario.name}  ${result.score}/${result.maxScore}`
+          );
         }
       } catch (error) {
         spinner.fail(`${scenario.name}  ERROR`);
@@ -2698,7 +2850,11 @@ function createEvalCommand() {
           score: 0,
           maxScore: scenario.checks.reduce((s, c) => s + c.points, 0),
           passed: false,
-          checks: scenario.checks.map((c) => ({ label: c.label, passed: false, points: c.points }))
+          checks: scenario.checks.map((c) => ({
+            label: c.label,
+            passed: false,
+            points: c.points
+          }))
         });
       }
     }
@@ -2706,13 +2862,19 @@ function createEvalCommand() {
     if (opts.json) {
       const overallScore = results.reduce((s, r) => s + r.score, 0);
       const overallMax = results.reduce((s, r) => s + r.maxScore, 0);
-      console.log(JSON.stringify({
-        results,
-        overallScore,
-        overallMax,
-        passed: overallScore >= overallMax * 0.8,
-        timestamp: (/* @__PURE__ */ new Date()).toISOString()
-      }, null, 2));
+      console.log(
+        JSON.stringify(
+          {
+            results,
+            overallScore,
+            overallMax,
+            passed: overallScore >= overallMax * 0.8,
+            timestamp: (/* @__PURE__ */ new Date()).toISOString()
+          },
+          null,
+          2
+        )
+      );
       return;
     }
     renderEvalReport(results);
@@ -2724,7 +2886,9 @@ function renderEvalReport(results) {
     const icon = result.passed ? chalk2.green("\u2713") : chalk2.red("\u2717");
     const status = result.passed ? chalk2.green("PASS") : chalk2.red("FAIL");
     const score = `${result.score}/${result.maxScore}`;
-    console.log(`  ${icon} ${chalk2.bold(result.scenario)}  ${score}  ${status}`);
+    console.log(
+      `  ${icon} ${chalk2.bold(result.scenario)}  ${score}  ${status}`
+    );
     const failedChecks = result.checks.filter((c) => !c.passed);
     for (const check of failedChecks) {
       console.log(`    ${chalk2.red("\u2717")} ${chalk2.dim(check.label)}`);
@@ -2741,7 +2905,9 @@ function renderEvalReport(results) {
   if (failed === 0) {
     log.success(`All ${passed} scenario(s) passed.`);
   } else {
-    log.warn(`${passed} passed, ${failed} failed out of ${results.length} scenario(s).`);
+    log.warn(
+      `${passed} passed, ${failed} failed out of ${results.length} scenario(s).`
+    );
   }
 }
 async function saveEvalReport(results, projectRoot, suite, model) {
@@ -2765,7 +2931,9 @@ async function saveEvalReport(results, projectRoot, suite, model) {
   ];
   for (const result of results) {
     const status = result.passed ? "PASS" : "FAIL";
-    lines.push(`### ${result.scenario} \u2014 ${result.score}/${result.maxScore} ${status}`);
+    lines.push(
+      `### ${result.scenario} \u2014 ${result.score}/${result.maxScore} ${status}`
+    );
     const failedChecks = result.checks.filter((c) => !c.passed);
     const passedChecks = result.checks.filter((c) => c.passed);
     for (const check of passedChecks) {
@@ -2783,7 +2951,9 @@ async function saveEvalReport(results, projectRoot, suite, model) {
       lines.push(`### Fix: ${result.scenario}`);
       const failedChecks = result.checks.filter((c) => !c.passed);
       for (const check of failedChecks) {
-        lines.push(`- ${check.label} \u2014 update CLAUDE.md instructions or add hooks to enforce this behavior`);
+        lines.push(
+          `- ${check.label} \u2014 update CLAUDE.md instructions or add hooks to enforce this behavior`
+        );
       }
       lines.push("");
     }
@@ -2833,43 +3003,66 @@ function hasMemoryHook(path) {
     const sessionStart = hooks.SessionStart;
     return sessionStart?.some((h) => {
       const inner = h.hooks;
-      return inner?.some((ih) => String(ih.command ?? "").includes("memory context"));
+      return inner?.some(
+        (ih) => String(ih.command ?? "").includes("memory context")
+      );
     }) ?? false;
   } catch {
     return false;
   }
 }
 function createMemoryCommand() {
-  const memory = new Command4("memory").description("Project-scoped memory with decay, sync, and a TUI dashboard").option("--dashboard", "Open the memory dashboard").action(async (opts) => {
+  const memory = new Command4("memory").description("Project-scoped memory with decay, sync, and a TUI dashboard").showHelpAfterError(
+    "(see `claude-launchpad memory --help` for the available subcommands)"
+  ).showSuggestionAfterError(true).option("--dashboard", "Open the memory dashboard").action(async (opts) => {
     if (opts.dashboard) {
       if (!isMemoryInstalled()) {
-        log.error("Knowledge base not set up yet. Run `claude-launchpad memory` first.");
+        log.error(
+          "Knowledge base not set up yet. Run `claude-launchpad memory` first."
+        );
         return;
       }
-      const { requireMemoryDeps } = await import("./require-deps-ZISUZLYD.js");
+      const { requireMemoryDeps } = await import("./require-deps-WDMHDGBN.js");
       await requireMemoryDeps();
-      const { startTui } = await import("./tui-2UJ2OIHB.js");
+      const { startTui } = await import("./tui-HVJNLRY2.js");
       await startTui();
       return;
     }
     if (!isMemoryInstalled()) {
-      const { detectExistingSetup } = await import("./install-Q23F37GK.js");
+      if (!process.stdin.isTTY) {
+        log.error(
+          "Knowledge base not set up and no TTY to prompt. Run `claude-launchpad memory install -y`."
+        );
+        process.exitCode = 1;
+        return;
+      }
+      const { detectExistingSetup } = await import("./install-D32PV7SF.js");
       const existing = detectExistingSetup(process.cwd());
       const mcpMissing = existing !== null && !isMemoryMcpRegistered(process.cwd());
       if (existing) {
         const location = existing === "local" ? ".claude/CLAUDE.md + settings.local.json" : "CLAUDE.md + settings.json";
         log.blank();
-        log.success(`Memory config found (${location}) but ${mcpMissing ? "MCP server not registered" : "database not set up"}.`);
+        log.success(
+          `Memory config found (${location}) but ${mcpMissing ? "MCP server not registered" : "database not set up"}.`
+        );
         log.info("Run `claude-launchpad memory install` to complete setup.");
         log.blank();
       } else {
         log.blank();
-        log.step("Claude doesn't have a knowledge base for this project yet.");
+        log.step(
+          "Claude doesn't have a knowledge base for this project yet."
+        );
         log.blank();
         log.info("After setup, Claude will:");
-        log.info("  - Remember decisions, gotchas, and learnings across sessions");
-        log.info("  - Automatically recall relevant context when you start a session");
-        log.info("  - Save important facts as you work, so nothing gets lost");
+        log.info(
+          "  - Remember decisions, gotchas, and learnings across sessions"
+        );
+        log.info(
+          "  - Automatically recall relevant context when you start a session"
+        );
+        log.info(
+          "  - Save important facts as you work, so nothing gets lost"
+        );
         log.blank();
       }
       const proceed = await confirm2({
@@ -2880,29 +3073,51 @@ function createMemoryCommand() {
         log.info("Skipped.");
         return;
       }
-      const { runInstall } = await import("./install-Q23F37GK.js");
+      const { runInstall } = await import("./install-D32PV7SF.js");
       await runInstall({});
     } else {
-      const { requireMemoryDeps } = await import("./require-deps-ZISUZLYD.js");
+      const { requireMemoryDeps } = await import("./require-deps-WDMHDGBN.js");
       await requireMemoryDeps();
-      const { runStats } = await import("./stats-SV53G6PQ.js");
+      const { runStats } = await import("./stats-77BYLKYP.js");
       await runStats({});
     }
   });
   memory.addCommand(
-    new Command4("install").description("Install (or re-install) the knowledge base for this project").option("--db-path <path>", "Override the default data directory").option("-y, --yes", "Non-interactive: accept defaults (shared placement)").action(async (opts) => {
+    new Command4("install").description(
+      "Install (or re-install) the knowledge base for this project"
+    ).option("--db-path <path>", "Override the default data directory").option(
+      "-y, --yes",
+      "Non-interactive: accept defaults (shared placement)"
+    ).action(async (opts) => {
       try {
-        const { runInstall } = await import("./install-Q23F37GK.js");
-        await runInstall({ ...opts.dbPath ? { dbPath: opts.dbPath } : {}, yes: opts.yes === true });
+        const { runInstall } = await import("./install-D32PV7SF.js");
+        await runInstall({
+          ...opts.dbPath ? { dbPath: opts.dbPath } : {},
+          yes: opts.yes === true
+        });
       } catch (err) {
         log.error(err instanceof Error ? err.message : String(err));
         process.exitCode = 1;
       }
     })
   );
+  memory.addCommand(
+    new Command4("stats").description("Show memory counts, health, and injection stats").option("--json", "JSON output").action(async (opts) => {
+      const { requireMemoryDeps } = await import("./require-deps-WDMHDGBN.js");
+      await requireMemoryDeps();
+      const { runStats } = await import("./stats-77BYLKYP.js");
+      await runStats(opts);
+    })
+  );
+  memory.addCommand(
+    new Command4("doctor").description("Diagnose the memory setup (DB, hooks, MCP registration)").option("--json", "JSON output").action(async (opts) => {
+      const { runMemoryDoctor } = await import("./doctor-DCHFJ3XV.js");
+      await runMemoryDoctor(opts);
+    })
+  );
   memory.addCommand(
     new Command4("context").description("Load session context (hook handler)").option("--json", "JSON output").action(async (opts) => {
-      const { runContext } = await import("./context-JALSYDYO.js");
+      const { runContext } = await import("./context-YIPO4LBS.js");
       await runContext(opts);
     }).helpCommand(false),
     { hidden: true }
@@ -2917,29 +3132,34 @@ function createMemoryCommand() {
   memory.addCommand(
     new Command4("push").description("Push current project's memories to GitHub Gist").option("--all", "Push all projects").option("-y, --yes", "Skip confirmation prompt").action(async (opts) => {
       await handleSyncErrors(async () => {
-        const { runPush } = await import("./push-QSBK7BQU.js");
+        const { runPush } = await import("./push-U4IVTFOU.js");
         await runPush(opts);
       });
     })
   );
   memory.addCommand(
-    new Command4("pull").description("Pull current project's memories from GitHub Gist").option("--all", "Pull all projects").option("-y, --yes", "Non-interactive (accepted for symmetry with push; pull never prompts)").action(async (opts) => {
+    new Command4("pull").description("Pull current project's memories from GitHub Gist").option("--all", "Pull all projects").option(
+      "-y, --yes",
+      "Non-interactive (accepted for symmetry with push; pull never prompts)"
+    ).action(async (opts) => {
       await handleSyncErrors(async () => {
-        const { runPull } = await import("./pull-FYKNNLYC.js");
+        const { runPull } = await import("./pull-YUQTDRUP.js");
         await runPull(opts);
       });
     })
   );
-  const sync = new Command4("sync").description("Sync memories with the gist (pull + push); subcommands manage sync state").option("--all", "Sync all projects").option("-y, --yes", "Skip confirmation prompt").action(async (opts) => {
+  const sync = new Command4("sync").description(
+    "Sync memories with the gist (pull + push); subcommands manage sync state"
+  ).option("--all", "Sync all projects").option("-y, --yes", "Skip confirmation prompt").action(async (opts) => {
     await handleSyncErrors(async () => {
-      const { runSync } = await import("./sync-2LDM44U4.js");
+      const { runSync } = await import("./sync-DTCWK2CY.js");
       await runSync(opts);
     });
   });
   sync.addCommand(
     new Command4("status").description("Show local vs remote memory counts per project").action(async () => {
       await handleSyncErrors(async () => {
-        const { runSyncStatus } = await import("./sync-status-V6WTI32X.js");
+        const { runSyncStatus } = await import("./sync-status-2V2RCYZO.js");
         await runSyncStatus();
       });
     })
@@ -2947,7 +3167,7 @@ function createMemoryCommand() {
   sync.addCommand(
     new Command4("clean").description("Remove a project from the sync gist").argument("<project>", "Project slug to remove").option("-y, --yes", "Skip confirmation prompt").action(async (project, opts) => {
       await handleSyncErrors(async () => {
-        const { runSyncClean } = await import("./sync-clean-HQ523N7V.js");
+        const { runSyncClean } = await import("./sync-clean-ACZCB3NZ.js");
         await runSyncClean(project, opts);
       });
     })
@@ -2957,7 +3177,7 @@ function createMemoryCommand() {
 }
 
 // src/cli.ts
-var program = new Command5().name("claude-launchpad").description("Score your Claude Code config, fix the gaps, prove Claude follows your rules.").version("1.12.0", "-v, --version").action(async () => {
+var program = new Command5().name("claude-launchpad").description("Score your Claude Code config, fix the gaps, prove Claude follows your rules.").version("1.14.0", "-v, --version").action(async () => {
   const hasConfig = await fileExists(join13(process.cwd(), "CLAUDE.md")) || await fileExists(join13(process.cwd(), ".claude", "settings.json"));
   if (hasConfig) {
     await program.commands.find((c) => c.name() === "doctor")?.parseAsync([], { from: "user" });