kairn-cli 1.2.0 → 1.4.0

package/dist/cli.js

@@ -1,5 +1,5 @@
 // src/cli.ts
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 
 // src/commands/init.ts
 import { Command } from "commander";
@@ -217,6 +217,37 @@ You must output a JSON object matching the EnvironmentSpec schema.
 - **Concise CLAUDE.md.** Under 100 lines. No generic text like "be helpful." Include build/test commands, reference docs/ and skills/.
 - **Security by default.** Always include deny rules for destructive commands and secret file access.
 
+## CLAUDE.md Template (mandatory structure)
+
+The \`claude_md\` field MUST follow this exact structure (max 100 lines):
+
+\`\`\`
+# {Project Name}
+
+## Purpose
+{one-line description}
+
+## Tech Stack
+{bullet list of frameworks/languages}
+
+## Commands
+{concrete build/test/lint/dev commands}
+
+## Architecture
+{brief folder structure, max 10 lines}
+
+## Conventions
+{3-5 specific coding rules}
+
+## Key Commands
+{list /project: commands with descriptions}
+
+## Output
+{where results go, key files}
+\`\`\`
+
+Do not add generic filler. Every line must be specific to the user's workflow.
+
 ## What You Must Always Include
 
 1. A concise, workflow-specific \`claude_md\` (the CLAUDE.md content)
@@ -228,6 +259,116 @@ You must output a JSON object matching the EnvironmentSpec schema.
 7. A \`rules/continuity.md\` rule encouraging updates to DECISIONS.md and LEARNINGS.md
 8. A \`rules/security.md\` rule with essential security instructions
 9. settings.json with deny rules for \`rm -rf\`, \`curl|sh\`, reading \`.env\` and \`secrets/\`
+10. A \`/project:status\` command for code projects (uses ! for live git/test output)
+11. A \`/project:fix\` command for code projects (uses $ARGUMENTS for issue number)
+12. A \`docs/SPRINT.md\` file for sprint contracts (acceptance criteria, verification steps)
+
+## Shell-Integrated Commands
+
+Commands that reference live project state should use Claude Code's \`!\` prefix for shell output:
+
+\`\`\`markdown
+# Example: .claude/commands/review.md
+Review the staged changes for quality and security:
+
+!git diff --staged
+
+Run tests and check for failures:
+
+!npm test 2>&1 | tail -20
+
+Focus on: security, error handling, test coverage.
+\`\`\`
+
+Use \`!\` when a command needs: git status, test results, build output, or file listings.
+
+## Path-Scoped Rules
+
+For code projects with multiple domains (API, frontend, tests), generate path-scoped rules using YAML frontmatter:
+
+\`\`\`markdown
+# Example: rules/api.md
+---
+paths:
+  - "src/api/**"
+  - "src/routes/**"
+---
+- All handlers return { data, error } shape
+- Use Zod for request validation
+- Log errors with request ID context
+\`\`\`
+
+\`\`\`markdown
+# Example: rules/testing.md
+---
+paths:
+  - "tests/**"
+  - "**/*.test.*"
+  - "**/*.spec.*"
+---
+- Use AAA pattern: Arrange-Act-Assert
+- One assertion per test when possible
+- Mock external dependencies, never real APIs
+\`\`\`
+
+Keep \`security.md\` and \`continuity.md\` as unconditional (no paths frontmatter).
+Only generate scoped rules when the workflow involves multiple code domains.
+
+## Hooks
+
+Generate hooks in settings.json based on project type:
+
+**All code projects** \u2014 block destructive commands:
+\`\`\`json
+{
+  "hooks": {
+    "PreToolUse": [{
+      "matcher": "Bash",
+      "hooks": [{
+        "type": "command",
+        "command": "CMD=$(cat | jq -r '.tool_input.command // empty') && echo \\"$CMD\\" | grep -qiE 'rm\\\\s+-rf\\\\s+/|DROP\\\\s+TABLE|curl.*\\\\|\\\\s*sh' && echo 'Blocked destructive command' >&2 && exit 2 || true"
+      }]
+    }]
+  }
+}
+\`\`\`
+
+**Projects with Prettier/ESLint/Black** \u2014 auto-format on write:
+\`\`\`json
+{
+  "hooks": {
+    "PostToolUse": [{
+      "matcher": "Edit|Write",
+      "hooks": [{
+        "type": "command",
+        "command": "FILE=$(cat | jq -r '.tool_input.file_path // empty') && [ -n \\"$FILE\\" ] && npx prettier --write \\"$FILE\\" 2>/dev/null || true"
+      }]
+    }]
+  }
+}
+\`\`\`
+
+Merge hooks into the \`settings\` object alongside permissions. Choose the formatter hook based on detected dependencies (Prettier \u2192 prettier, ESLint \u2192 eslint, Black \u2192 black).
+
+## PostCompact Hook
+
+All projects should include a PostCompact hook to restore context after compaction:
+
+\`\`\`json
+{
+  "hooks": {
+    "PostCompact": [{
+      "matcher": "",
+      "hooks": [{
+        "type": "prompt",
+        "prompt": "Re-read CLAUDE.md and docs/SPRINT.md (if it exists) to restore project context after compaction."
+      }]
+    }]
+  }
+}
+\`\`\`
+
+Merge this into the settings hooks alongside the PreToolUse and PostToolUse hooks.
 
 ## Tool Selection Rules
 
@@ -238,14 +379,37 @@ You must output a JSON object matching the EnvironmentSpec schema.
 - Maximum 6-8 MCP servers to avoid context bloat
 - Include a \`reason\` for each selected tool explaining why it fits this workflow
 
+## Context Budget (STRICT)
+
+- MCP servers: maximum 6. Prefer fewer.
+- CLAUDE.md: maximum 100 lines.
+- Rules: maximum 5 files, each under 20 lines.
+- Skills: maximum 3. Only include directly relevant ones.
+- Agents: maximum 3. QA pipeline + one specialist.
+- Commands: no limit (loaded on demand, zero context cost).
+- Hooks: maximum 4 (auto-format, block-destructive, PostCompact, plus one contextual).
+
+If the workflow doesn't clearly need a tool, DO NOT include it.
+Each MCP server costs 500-2000 tokens of context window.
+
 ## For Code Projects, Additionally Include
 
 - \`/project:plan\` command (plan before coding)
 - \`/project:review\` command (review changes)
 - \`/project:test\` command (run and fix tests)
 - \`/project:commit\` command (conventional commits)
-- A TDD skill if testing is relevant
-- A reviewer agent (read-only, Sonnet model)
+- \`/project:status\` command (live git status, recent commits, TODO overview using ! prefix)
+- \`/project:fix\` command (takes $ARGUMENTS as issue number, plans fix, implements, tests, commits)
+- \`/project:sprint\` command (define acceptance criteria before coding, writes to docs/SPRINT.md)
+- A TDD skill using the 3-phase isolation pattern (RED \u2192 GREEN \u2192 REFACTOR):
+  - RED: Write failing test only. Verify it FAILS.
+  - GREEN: Write MINIMUM code to pass. Nothing extra.
+  - REFACTOR: Improve while keeping tests green.
+  Rules: never write tests and implementation in same step, AAA pattern, one assertion per test.
+- A multi-agent QA pipeline:
+  - \`@qa-orchestrator\` (sonnet) \u2014 delegates to linter and e2e-tester, compiles QA report
+  - \`@linter\` (haiku) \u2014 runs formatters, linters, security scanners
+  - \`@e2e-tester\` (sonnet, only when Playwright is in tools) \u2014 browser-based QA via Playwright
 
 ## For Research Projects, Additionally Include
 
@@ -284,7 +448,10 @@ Return ONLY valid JSON matching this structure:
     },
     "commands": {
       "help": "markdown content for /project:help",
-      "tasks": "markdown content for /project:tasks"
+      "tasks": "markdown content for /project:tasks",
+      "status": "Show project status:\\n\\n!git status --short\\n\\n!git log --oneline -5\\n\\nRead TODO.md and summarize progress.",
+      "fix": "Fix issue #$ARGUMENTS:\\n\\n1. Read the issue and understand the problem\\n2. Plan the fix\\n3. Implement the fix\\n4. Run tests:\\n\\n!npm test 2>&1 | tail -20\\n\\n5. Commit with: fix: resolve #$ARGUMENTS",
+      "sprint": "Define a sprint contract for the next feature:\\n\\n1. Read docs/TODO.md for context:\\n\\n!cat docs/TODO.md 2>/dev/null\\n\\n2. Write a CONTRACT to docs/SPRINT.md with: feature name, acceptance criteria, verification steps, files to modify, scope estimate.\\n3. Do NOT start coding until contract is confirmed."
     },
     "rules": {
       "continuity": "markdown content for continuity rule",
@@ -294,12 +461,15 @@ Return ONLY valid JSON matching this structure:
       "skill-name/SKILL": "markdown content with YAML frontmatter"
     },
     "agents": {
-      "agent-name": "markdown content with YAML frontmatter"
+      "qa-orchestrator": "---\\nname: qa-orchestrator\\ndescription: Orchestrates QA pipeline\\nmodel: sonnet\\n---\\nRun QA: delegate to @linter for static analysis, @e2e-tester for browser tests. Compile consolidated report.",
+      "linter": "---\\nname: linter\\ndescription: Fast static analysis\\nmodel: haiku\\n---\\nRun available linters (eslint, prettier, biome, ruff, mypy, semgrep). Report issues.",
+      "e2e-tester": "---\\nname: e2e-tester\\ndescription: Browser-based QA via Playwright\\nmodel: sonnet\\n---\\nTest user flows via Playwright. Verify behavior, not just DOM. Screenshot failures."
     },
     "docs": {
       "TODO": "# TODO\\n\\n- [ ] First task based on workflow",
       "DECISIONS": "# Decisions\\n\\nArchitectural decisions for this project.",
-      "LEARNINGS": "# Learnings\\n\\nNon-obvious discoveries and gotchas."
+      "LEARNINGS": "# Learnings\\n\\nNon-obvious discoveries and gotchas.",
+      "SPRINT": "# Sprint Contract\\n\\nDefine acceptance criteria before starting work."
     }
   }
 }
@@ -435,6 +605,24 @@ async function callLLM(config, userMessage) {
   }
   throw new Error(`Unsupported provider: ${config.provider}. Run \`kairn init\` to reconfigure.`);
 }
+function validateSpec(spec, onProgress) {
+  const warnings = [];
+  if (spec.tools.length > 8) {
+    warnings.push(`${spec.tools.length} MCP servers selected (recommended: \u22646)`);
+  }
+  if (spec.harness.claude_md) {
+    const lines = spec.harness.claude_md.split("\n").length;
+    if (lines > 150) {
+      warnings.push(`CLAUDE.md is ${lines} lines (recommended: \u2264100)`);
+    }
+  }
+  if (spec.harness.skills && Object.keys(spec.harness.skills).length > 5) {
+    warnings.push(`${Object.keys(spec.harness.skills).length} skills (recommended: \u22643)`);
+  }
+  for (const warning of warnings) {
+    onProgress?.(`\u26A0 ${warning}`);
+  }
+}
 async function compile(intent, onProgress) {
   const config = await loadConfig();
   if (!config) {
@@ -453,6 +641,7 @@ async function compile(intent, onProgress) {
     created_at: (/* @__PURE__ */ new Date()).toISOString(),
     ...parsed
   };
+  validateSpec(spec, onProgress);
   await ensureDirs();
   const envPath = path2.join(getEnvsDir(), `${spec.id}.json`);
   await fs2.writeFile(envPath, JSON.stringify(spec, null, 2), "utf-8");
@@ -466,6 +655,50 @@ async function writeFile(filePath, content) {
   await fs3.mkdir(path3.dirname(filePath), { recursive: true });
   await fs3.writeFile(filePath, content, "utf-8");
 }
+function buildFileMap(spec) {
+  const files = /* @__PURE__ */ new Map();
+  if (spec.harness.claude_md) {
+    files.set(".claude/CLAUDE.md", spec.harness.claude_md);
+  }
+  if (spec.harness.settings && Object.keys(spec.harness.settings).length > 0) {
+    files.set(
+      ".claude/settings.json",
+      JSON.stringify(spec.harness.settings, null, 2)
+    );
+  }
+  if (spec.harness.mcp_config && Object.keys(spec.harness.mcp_config).length > 0) {
+    files.set(
+      ".mcp.json",
+      JSON.stringify({ mcpServers: spec.harness.mcp_config }, null, 2)
+    );
+  }
+  if (spec.harness.commands) {
+    for (const [name, content] of Object.entries(spec.harness.commands)) {
+      files.set(`.claude/commands/${name}.md`, content);
+    }
+  }
+  if (spec.harness.rules) {
+    for (const [name, content] of Object.entries(spec.harness.rules)) {
+      files.set(`.claude/rules/${name}.md`, content);
+    }
+  }
+  if (spec.harness.skills) {
+    for (const [skillPath, content] of Object.entries(spec.harness.skills)) {
+      files.set(`.claude/skills/${skillPath}.md`, content);
+    }
+  }
+  if (spec.harness.agents) {
+    for (const [name, content] of Object.entries(spec.harness.agents)) {
+      files.set(`.claude/agents/${name}.md`, content);
+    }
+  }
+  if (spec.harness.docs) {
+    for (const [name, content] of Object.entries(spec.harness.docs)) {
+      files.set(`.claude/docs/${name}.md`, content);
+    }
+  }
+  return files;
+}
 async function writeEnvironment(spec, targetDir) {
   const claudeDir = path3.join(targetDir, ".claude");
   const written = [];
@@ -1007,6 +1240,58 @@ async function scanProject(dir) {
 }
 
 // src/commands/optimize.ts
+function simpleDiff(oldContent, newContent) {
+  const oldLines = oldContent.split("\n");
+  const newLines = newContent.split("\n");
+  const output = [];
+  const maxLines = Math.max(oldLines.length, newLines.length);
+  for (let i = 0; i < maxLines; i++) {
+    const oldLine = oldLines[i];
+    const newLine = newLines[i];
+    if (oldLine === void 0) {
+      output.push(chalk6.green(`+ ${newLine}`));
+    } else if (newLine === void 0) {
+      output.push(chalk6.red(`- ${oldLine}`));
+    } else if (oldLine !== newLine) {
+      output.push(chalk6.red(`- ${oldLine}`));
+      output.push(chalk6.green(`+ ${newLine}`));
+    }
+  }
+  return output;
+}
+async function generateDiff(spec, targetDir) {
+  const fileMap = buildFileMap(spec);
+  const results = [];
+  for (const [relativePath, newContent] of fileMap) {
+    const absolutePath = path9.join(targetDir, relativePath);
+    let oldContent = null;
+    try {
+      oldContent = await fs9.readFile(absolutePath, "utf-8");
+    } catch {
+    }
+    if (oldContent === null) {
+      results.push({
+        path: relativePath,
+        status: "new",
+        diff: chalk6.green("+ NEW FILE")
+      });
+    } else if (oldContent === newContent) {
+      results.push({
+        path: relativePath,
+        status: "unchanged",
+        diff: ""
+      });
+    } else {
+      const diffLines = simpleDiff(oldContent, newContent);
+      results.push({
+        path: relativePath,
+        status: "modified",
+        diff: diffLines.join("\n")
+      });
+    }
+  }
+  return results;
+}
 async function loadRegistry3() {
   const __filename = fileURLToPath4(import.meta.url);
   const __dirname = path9.dirname(__filename);
@@ -1080,6 +1365,10 @@ ${profile.existingClaudeMd}`);
     parts.push("- Are security rules present?");
     parts.push("- Is there a continuity rule for session memory?");
     parts.push("- Are there unnecessary MCP servers adding context bloat?");
+    parts.push("- Are hooks configured in settings.json for destructive command blocking?");
+    parts.push("- Are there path-scoped rules for different code domains (api, testing, frontend)?");
+    parts.push("- Does the project have a /project:status command with live git output?");
+    parts.push("- Is there a /project:fix command for issue-driven development?");
     if (profile.claudeMdLineCount > 200) {
       parts.push(`- CLAUDE.md is ${profile.claudeMdLineCount} lines \u2014 needs aggressive trimming`);
     }
@@ -1099,7 +1388,7 @@ ${profile.existingClaudeMd}`);
   }
   return parts.join("\n");
 }
-var optimizeCommand = new Command6("optimize").description("Scan an existing project and generate or optimize its Claude Code environment").option("-y, --yes", "Skip confirmation prompts").option("--audit-only", "Only audit the existing harness, don't generate changes").action(async (options) => {
+var optimizeCommand = new Command6("optimize").description("Scan an existing project and generate or optimize its Claude Code environment").option("-y, --yes", "Skip confirmation prompts").option("--audit-only", "Only audit the existing harness, don't generate changes").option("--diff", "Preview changes as a diff without writing").action(async (options) => {
   const config = await loadConfig();
   if (!config) {
     console.log(
@@ -1136,6 +1425,9 @@ var optimizeCommand = new Command6("optimize").description("Scan an existing pro
     if (profile.mcpServerCount === 0 && profile.dependencies.length > 0) issues.push("No MCP servers configured");
     if (profile.hasTests && !profile.existingCommands.includes("test")) issues.push("Has tests but no /project:test command");
     if (!profile.existingCommands.includes("tasks")) issues.push("Missing /project:tasks command");
+    if (!profile.existingSettings?.hooks) issues.push("No hooks configured \u2014 missing destructive command blocking");
+    const scopedRules = profile.existingRules.filter((r) => r !== "security" && r !== "continuity");
+    if (profile.hasSrc && scopedRules.length === 0) issues.push("No path-scoped rules \u2014 consider adding api.md, testing.md, or frontend.md rules");
     if (issues.length > 0) {
       console.log(chalk6.yellow("\n  Issues Found:\n"));
       for (const issue of issues) {
@@ -1210,6 +1502,34 @@ var optimizeCommand = new Command6("optimize").description("Scan an existing pro
       console.log(chalk6.yellow(`    ${cmd}`));
     }
   }
+  if (options.diff) {
+    const diffs = await generateDiff(spec, targetDir);
+    const changedDiffs = diffs.filter((d) => d.status !== "unchanged");
+    if (changedDiffs.length === 0) {
+      console.log(chalk6.green("\n  \u2713 No changes needed \u2014 environment is already up to date.\n"));
+      return;
+    }
+    console.log(chalk6.cyan("\n  Changes preview:\n"));
+    for (const d of changedDiffs) {
+      console.log(chalk6.cyan(`  --- ${d.path}`));
+      if (d.status === "new") {
+        console.log(`    ${d.diff}`);
+      } else {
+        for (const line of d.diff.split("\n")) {
+          console.log(`    ${line}`);
+        }
+      }
+      console.log("");
+    }
+    const apply = await confirm2({
+      message: "Apply these changes?",
+      default: true
+    });
+    if (!apply) {
+      console.log(chalk6.dim("\n  Aborted.\n"));
+      return;
+    }
+  }
   const written = await writeEnvironment(spec, targetDir);
   console.log(chalk6.green("\n  \u2713 Environment written\n"));
   for (const file of written) {
@@ -1240,16 +1560,185 @@ var optimizeCommand = new Command6("optimize").description("Scan an existing pro
   );
 });
 
+// src/commands/doctor.ts
+import { Command as Command7 } from "commander";
+import chalk7 from "chalk";
+function runChecks(profile) {
+  const checks = [];
+  if (!profile.existingClaudeMd) {
+    checks.push({
+      name: "CLAUDE.md",
+      weight: 3,
+      status: "fail",
+      message: "Missing CLAUDE.md"
+    });
+  } else if (profile.claudeMdLineCount > 200) {
+    checks.push({
+      name: "CLAUDE.md",
+      weight: 2,
+      status: "warn",
+      message: `${profile.claudeMdLineCount} lines (recommended: \u2264100)`
+    });
+  } else {
+    checks.push({
+      name: "CLAUDE.md",
+      weight: 3,
+      status: "pass",
+      message: `${profile.claudeMdLineCount} lines`
+    });
+  }
+  if (!profile.existingSettings) {
+    checks.push({
+      name: "settings.json",
+      weight: 2,
+      status: "fail",
+      message: "Missing settings.json"
+    });
+  } else {
+    const perms2 = profile.existingSettings.permissions;
+    const hasDeny = perms2?.deny && Array.isArray(perms2.deny) && perms2.deny.length > 0;
+    checks.push({
+      name: "Deny rules",
+      weight: 2,
+      status: hasDeny ? "pass" : "warn",
+      message: hasDeny ? "Deny rules configured" : "No deny rules in settings.json"
+    });
+  }
+  if (profile.mcpServerCount > 8) {
+    checks.push({
+      name: "MCP servers",
+      weight: 1,
+      status: "warn",
+      message: `${profile.mcpServerCount} servers (recommended: \u22648)`
+    });
+  } else if (profile.mcpServerCount > 0) {
+    checks.push({
+      name: "MCP servers",
+      weight: 1,
+      status: "pass",
+      message: `${profile.mcpServerCount} servers`
+    });
+  } else {
+    checks.push({
+      name: "MCP servers",
+      weight: 1,
+      status: "warn",
+      message: "No MCP servers configured"
+    });
+  }
+  checks.push({
+    name: "/project:help",
+    weight: 2,
+    status: profile.existingCommands.includes("help") ? "pass" : "fail",
+    message: profile.existingCommands.includes("help") ? "Help command present" : "Missing /project:help command"
+  });
+  checks.push({
+    name: "/project:tasks",
+    weight: 1,
+    status: profile.existingCommands.includes("tasks") ? "pass" : "warn",
+    message: profile.existingCommands.includes("tasks") ? "Tasks command present" : "Missing /project:tasks command"
+  });
+  checks.push({
+    name: "Security rule",
+    weight: 3,
+    status: profile.existingRules.includes("security") ? "pass" : "fail",
+    message: profile.existingRules.includes("security") ? "Security rule present" : "Missing rules/security.md"
+  });
+  checks.push({
+    name: "Continuity rule",
+    weight: 2,
+    status: profile.existingRules.includes("continuity") ? "pass" : "warn",
+    message: profile.existingRules.includes("continuity") ? "Continuity rule present" : "Missing rules/continuity.md"
+  });
+  const hasHooks = profile.existingSettings?.hooks;
+  checks.push({
+    name: "Hooks",
+    weight: 1,
+    status: hasHooks ? "pass" : "warn",
+    message: hasHooks ? "Hooks configured" : "No hooks in settings.json"
+  });
+  const perms = profile.existingSettings?.permissions;
+  const denyList = perms?.deny || [];
+  const envProtected = denyList.some((d) => d.includes(".env"));
+  checks.push({
+    name: ".env protection",
+    weight: 2,
+    status: envProtected ? "pass" : "warn",
+    message: envProtected ? ".env in deny list" : ".env not in deny list"
+  });
+  if (profile.existingClaudeMd) {
+    const requiredSections = ["## Purpose", "## Commands", "## Tech Stack"];
+    const missingSections = requiredSections.filter(
+      (s) => !profile.existingClaudeMd.includes(s)
+    );
+    if (missingSections.length > 0) {
+      checks.push({
+        name: "CLAUDE.md sections",
+        weight: 1,
+        status: "warn",
+        message: `Missing: ${missingSections.join(", ")}`
+      });
+    } else {
+      checks.push({
+        name: "CLAUDE.md sections",
+        weight: 1,
+        status: "pass",
+        message: "Required sections present"
+      });
+    }
+  }
+  return checks;
+}
+var doctorCommand = new Command7("doctor").description(
+  "Validate the current Claude Code environment against best practices"
+).action(async () => {
+  const targetDir = process.cwd();
+  console.log(chalk7.dim("\n  Checking .claude/ environment...\n"));
+  const profile = await scanProject(targetDir);
+  if (!profile.hasClaudeDir) {
+    console.log(chalk7.red("  \u274C No .claude/ directory found.\n"));
+    console.log(
+      chalk7.dim("  Run ") + chalk7.bold("kairn describe") + chalk7.dim(" or ") + chalk7.bold("kairn optimize") + chalk7.dim(" to generate one.\n")
+    );
+    process.exit(1);
+  }
+  const checks = runChecks(profile);
+  for (const check of checks) {
+    const icon = check.status === "pass" ? chalk7.green("\u2705") : check.status === "warn" ? chalk7.yellow("\u26A0\uFE0F ") : chalk7.red("\u274C");
+    const msg = check.status === "pass" ? chalk7.dim(check.message) : check.status === "warn" ? chalk7.yellow(check.message) : chalk7.red(check.message);
+    console.log(`  ${icon} ${check.name}: ${msg}`);
+  }
+  const maxScore = checks.reduce((sum, c) => sum + c.weight, 0);
+  const score = checks.reduce((sum, c) => {
+    if (c.status === "pass") return sum + c.weight;
+    if (c.status === "warn") return sum + Math.floor(c.weight / 2);
+    return sum;
+  }, 0);
+  const percentage = Math.round(score / maxScore * 100);
+  const scoreColor = percentage >= 80 ? chalk7.green : percentage >= 50 ? chalk7.yellow : chalk7.red;
+  console.log(
+    `
+  Score: ${scoreColor(`${score}/${maxScore}`)} (${scoreColor(`${percentage}%`)})
+`
+  );
+  if (percentage < 80) {
+    console.log(
+      chalk7.dim("  Run ") + chalk7.bold("kairn optimize") + chalk7.dim(" to fix issues.\n")
+    );
+  }
+});
+
 // src/cli.ts
-var program = new Command7();
+var program = new Command8();
 program.name("kairn").description(
   "Compile natural language intent into optimized Claude Code environments"
-).version("1.0.0");
+).version("1.4.0");
 program.addCommand(initCommand);
 program.addCommand(describeCommand);
 program.addCommand(optimizeCommand);
 program.addCommand(listCommand);
 program.addCommand(activateCommand);
 program.addCommand(updateRegistryCommand);
+program.addCommand(doctorCommand);
 program.parse();
 //# sourceMappingURL=cli.js.map