@cardor/agent-harness-kit 1.7.5 → 1.8.0

package/dist/cli.js

@@ -83,7 +83,8 @@ var MCP_CLAUDE_PERMISSIONS_LEAD = [
   "mcp__agent-harness-kit__tasks_archive",
   "mcp__agent-harness-kit__tasks_unarchive",
   "mcp__agent-harness-kit__tasks_acceptance_get",
-  "mcp__agent-harness-kit__docs_search"
+  "mcp__agent-harness-kit__docs_search",
+  "mcp__agent-harness-kit__ahk_doctor"
 ];
 var MCP_CLAUDE_PERMISSIONS_EXPLORER = [
   "mcp__agent-harness-kit__actions_start",
@@ -95,7 +96,8 @@ var MCP_CLAUDE_PERMISSIONS_EXPLORER = [
   "mcp__agent-harness-kit__tasks_get",
   "mcp__agent-harness-kit__tasks_claim",
   "mcp__agent-harness-kit__tasks_acceptance_get",
-  "mcp__agent-harness-kit__docs_search"
+  "mcp__agent-harness-kit__docs_search",
+  "mcp__agent-harness-kit__ahk_doctor"
 ];
 var MCP_CLAUDE_PERMISSIONS_BUILDER = [
   "mcp__agent-harness-kit__actions_start",
@@ -112,7 +114,8 @@ var MCP_CLAUDE_PERMISSIONS_BUILDER = [
   "mcp__agent-harness-kit__tasks_archive",
   "mcp__agent-harness-kit__tasks_unarchive",
   "mcp__agent-harness-kit__tasks_acceptance_get",
-  "mcp__agent-harness-kit__docs_search"
+  "mcp__agent-harness-kit__docs_search",
+  "mcp__agent-harness-kit__ahk_doctor"
 ];
 var MCP_CLAUDE_PERMISSIONS_REVIEWER = [
   "mcp__agent-harness-kit__actions_start",
@@ -130,7 +133,8 @@ var MCP_CLAUDE_PERMISSIONS_REVIEWER = [
   "mcp__agent-harness-kit__tasks_unarchive",
   "mcp__agent-harness-kit__tasks_acceptance_update",
   "mcp__agent-harness-kit__tasks_acceptance_get",
-  "mcp__agent-harness-kit__docs_search"
+  "mcp__agent-harness-kit__docs_search",
+  "mcp__agent-harness-kit__ahk_doctor"
 ];
 var MCP_CLAUDE_PERMISSIONS_CONSULTANT = [
   "mcp__agent-harness-kit__actions_start",
@@ -144,7 +148,8 @@ var MCP_CLAUDE_PERMISSIONS_CONSULTANT = [
   "mcp__agent-harness-kit__tasks_acceptance_get",
   "mcp__agent-harness-kit__deps_snapshot",
   "mcp__agent-harness-kit__deps_check",
-  "mcp__agent-harness-kit__docs_search"
+  "mcp__agent-harness-kit__docs_search",
+  "mcp__agent-harness-kit__ahk_doctor"
 ];
 var MCP_CLAUDE_PERMISSIONS = [
   .../* @__PURE__ */ new Set([
@@ -249,7 +254,8 @@ function mergeCodexConfigToml(filePath, port) {
 
 // src/core/materializer/scaffold-utils.ts
 import { existsSync as existsSync2, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
-import { join as join3, resolve as resolve2 } from "path";
+import { dirname as dirname3, join as join3, resolve as resolve2 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/core/materializer/templates.ts
 import { readFileSync as readFileSync2 } from "fs";
@@ -655,6 +661,7 @@ var GITIGNORE_ENTRIES = `
 `;
 
 // src/core/materializer/scaffold-utils.ts
+var __dirname2 = dirname3(fileURLToPath2(import.meta.url));
 function writeAgentFile(cwd2, relPath, content) {
   const abs = join3(cwd2, relPath);
   if (existsSync2(abs)) return;
@@ -672,6 +679,16 @@ function appendGitignore(cwd2) {
 function slugify(title) {
   return title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64);
 }
+function writeSkills(cwd2, skillsDir) {
+  const skillNames = ["ahk-ask", "ahk-consultant", "ahk-triage"];
+  for (const skillName of skillNames) {
+    const src = join3(__dirname2, "skills", skillName, "SKILL.md");
+    const destDir = join3(cwd2, skillsDir, skillName);
+    const dest = join3(destDir, "SKILL.md");
+    mkdirSync3(destDir, { recursive: true });
+    writeFileSync3(dest, readFileSync3(src, "utf8"), "utf8");
+  }
+}
 
 // src/core/materializer/claude-code.ts
 var ClaudeCodeMaterializer = class {
@@ -709,6 +726,7 @@ No tasks in progress.
     mergeClaudeSettingsJson(join4(cwd2, ".claude/settings.json"));
     mergeClaudeSettingsLocalJson(join4(cwd2, ".claude/settings.local.json"));
     appendGitignore(cwd2);
+    writeSkills(cwd2, ".claude/skills");
   }
   async build(config, cwd2) {
     const write2 = (relPath, content) => {
@@ -729,6 +747,7 @@ No tasks in progress.
     mergeClaudeMcpJson(join4(cwd2, ".mcp.json"), config.tools.mcp.port);
     mergeClaudeSettingsJson(join4(cwd2, ".claude/settings.json"));
     mergeClaudeSettingsLocalJson(join4(cwd2, ".claude/settings.local.json"));
+    writeSkills(cwd2, ".claude/skills");
   }
   async migrate(config, _to, _cwd) {
     void config;
@@ -807,6 +826,7 @@ No tasks in progress.
     writeAgentFile(cwd2, ".codex/agents/default.toml", agentLeadAsDefaultToml({ projectName }));
     mergeCodexConfigToml(join5(cwd2, ".codex/config.toml"), config.tools.mcp.port);
     appendGitignore(cwd2);
+    writeSkills(cwd2, ".agents/skills");
   }
   async build(config, cwd2) {
     const write2 = (relPath, content) => {
@@ -825,6 +845,7 @@ No tasks in progress.
     writeAgentFile(cwd2, ".codex/agents/reviewer.toml", agentReviewerToml({ projectName }));
     writeAgentFile(cwd2, ".codex/agents/default.toml", agentLeadAsDefaultToml({ projectName }));
     mergeCodexConfigToml(join5(cwd2, ".codex/config.toml"), config.tools.mcp.port);
+    writeSkills(cwd2, ".agents/skills");
   }
   async migrate(config, _to, _cwd) {
     void config;
@@ -873,6 +894,7 @@ No tasks in progress.
     writeAgentFile(cwd2, ".opencode/agents/reviewer.md", translateFrontmatterForOpenCode(agentReviewer({ projectName })));
     mergeOpencodeJson(join6(cwd2, "opencode.json"), config.tools.mcp.port);
     appendGitignore(cwd2);
+    writeSkills(cwd2, ".opencode/skills");
   }
   async build(config, cwd2) {
     const write2 = (relPath, content) => {
@@ -890,6 +912,7 @@ No tasks in progress.
     writeAgentFile(cwd2, ".opencode/agents/builder.md", translateFrontmatterForOpenCode(agentBuilder({ projectName, writablePaths })));
     writeAgentFile(cwd2, ".opencode/agents/reviewer.md", translateFrontmatterForOpenCode(agentReviewer({ projectName })));
     mergeOpencodeJson(join6(cwd2, "opencode.json"), config.tools.mcp.port);
+    writeSkills(cwd2, ".opencode/skills");
   }
   async migrate(config, _to, _cwd) {
     void config;
@@ -954,8 +977,8 @@ async function buildOnce(cwd2) {
 }
 
 // src/commands/dashboard.ts
-import { dirname as dirname4, join as join9, resolve as resolve7 } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
+import { dirname as dirname5, join as join9, resolve as resolve7 } from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
 import pc2 from "picocolors";
 
 // src/core/dashboard-server.ts
@@ -1165,7 +1188,7 @@ async function startDashboardServer(db, dbPath, staticPath, port) {
 // src/core/db.ts
 import { randomUUID } from "crypto";
 import { mkdirSync as mkdirSync7, writeFileSync as writeFileSync7 } from "fs";
-import { dirname as dirname3, join as join8, resolve as resolve6 } from "path";
+import { dirname as dirname4, join as join8, resolve as resolve6 } from "path";
 
 // src/core/repositories/ActionRepository.ts
 var ActionRepository = class {
@@ -1648,7 +1671,7 @@ var HarnessDB = class {
   async regenerateCurrentMd() {
     if (!this.config.storage.markdownFallback.enabled) return;
     const mdPath = resolve6(this.config.storage.markdownFallback.path);
-    mkdirSync7(dirname3(mdPath), { recursive: true });
+    mkdirSync7(dirname4(mdPath), { recursive: true });
     const inProgress = await this.tasks.getAll("in_progress");
     const now = (/* @__PURE__ */ new Date()).toISOString();
     let md = `<!-- AUTO-GENERATED by agent-harness-kit \u2014 DO NOT EDIT MANUALLY -->
@@ -1761,7 +1784,7 @@ var HarnessDB = class {
       }))
     );
     const path = join8(resolve6(cwd2), this.config.storage.dir, "feature_list.json");
-    mkdirSync7(dirname3(path), { recursive: true });
+    mkdirSync7(dirname4(path), { recursive: true });
     writeFileSync7(path, JSON.stringify(list, null, 2) + "\n", "utf8");
   }
 };
@@ -1786,12 +1809,12 @@ async function openDB(config, cwd2) {
 }
 
 // src/commands/dashboard.ts
-var __dirname2 = dirname4(fileURLToPath2(import.meta.url));
+var __dirname3 = dirname5(fileURLToPath3(import.meta.url));
 async function runDashboard(cwd2, opts) {
   const config = await loadConfig(cwd2);
   const db = await openDB(config, cwd2);
   const dbPath = config.database.type === "sqlite" ? resolve7(cwd2, config.database.path) : null;
-  const staticPath = join9(__dirname2, "dashboard-dist");
+  const staticPath = join9(__dirname3, "dashboard-dist");
   const { url } = await startDashboardServer(db, dbPath, staticPath, opts.port);
   console.log(pc2.green(`\u2713`) + ` Dashboard running at ${pc2.bold(pc2.cyan(url))}`);
   console.log(pc2.dim(`  WebSocket live updates enabled`));
@@ -1807,12 +1830,255 @@ async function runDashboard(cwd2, opts) {
   });
 }
 
+// src/commands/doctor.ts
+import pc3 from "picocolors";
+
+// src/core/doctor.ts
+import { existsSync as existsSync7, readFileSync as readFileSync6 } from "fs";
+import { dirname as dirname7, join as join11 } from "path";
+import { fileURLToPath as fileURLToPath5 } from "url";
+
+// src/core/package-data.ts
+import { createRequire } from "module";
+import { dirname as dirname6, join as join10 } from "path";
+import { fileURLToPath as fileURLToPath4 } from "url";
+var require2 = createRequire(import.meta.url);
+var pkgPath = join10(dirname6(fileURLToPath4(import.meta.url)), "..", "package.json");
+var pkg = require2(pkgPath);
+
+// src/core/doctor.ts
+var REGISTRY_URL = `https://registry.npmjs.org/${pkg.name}/latest`;
+var TIMEOUT_MS = 2e3;
+var AGENT_NAMES = ["lead", "explorer", "consultant", "builder", "reviewer"];
+var SKILL_NAMES = ["ahk-ask", "ahk-consultant", "ahk-triage"];
+var __dirname4 = dirname7(fileURLToPath5(import.meta.url));
+async function checkLibVersion() {
+  const current = pkg.version;
+  try {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+    const res = await fetch(REGISTRY_URL, { signal: controller.signal });
+    clearTimeout(timer);
+    const data = await res.json();
+    const latest = data.version;
+    const outdated = isNewer(latest, current);
+    return { current, latest, outdated };
+  } catch {
+    return { current, latest: null, outdated: false };
+  }
+}
+function isNewer(latest, current) {
+  const toNum = (v4) => v4.split(".").map(Number);
+  const [lMaj, lMin, lPat] = toNum(latest);
+  const [cMaj, cMin, cPat] = toNum(current);
+  if (lMaj !== cMaj) return lMaj > cMaj;
+  if (lMin !== cMin) return lMin > cMin;
+  return lPat > cPat;
+}
+function getProviderAgentInfo(provider) {
+  switch (provider) {
+    case "claude-code":
+      return { agentsDir: ".claude/agents", ext: ".md" };
+    case "opencode":
+      return { agentsDir: ".opencode/agents", ext: ".md" };
+    case "codex-cli":
+      return { agentsDir: ".codex/agents", ext: ".toml" };
+    default:
+      return { agentsDir: ".claude/agents", ext: ".md" };
+  }
+}
+function generateExpectedAgentContent(agentName, provider, vars) {
+  const { projectName, allowedPaths, writablePaths } = vars;
+  if (provider === "claude-code") {
+    const templateFns = {
+      lead: () => agentLead({ projectName }),
+      explorer: () => agentExplorer({ projectName, allowedPaths }),
+      consultant: () => agentConsultant({ projectName }),
+      builder: () => agentBuilder({ projectName, writablePaths }),
+      reviewer: () => agentReviewer({ projectName })
+    };
+    return translateFrontmatterForClaudeCode(templateFns[agentName](), agentName);
+  }
+  if (provider === "opencode") {
+    const templateFns = {
+      lead: () => agentLead({ projectName }),
+      explorer: () => agentExplorer({ projectName, allowedPaths }),
+      consultant: () => agentConsultant({ projectName }),
+      builder: () => agentBuilder({ projectName, writablePaths }),
+      reviewer: () => agentReviewer({ projectName })
+    };
+    return translateFrontmatterForOpenCode(templateFns[agentName]());
+  }
+  const tomlFns = {
+    lead: () => agentLeadToml({ projectName }),
+    explorer: () => agentExplorerToml({ projectName, allowedPaths }),
+    consultant: () => agentConsultantToml({ projectName }),
+    builder: () => agentBuilderToml({ projectName, writablePaths }),
+    reviewer: () => agentReviewerToml({ projectName })
+  };
+  return tomlFns[agentName]();
+}
+function checkAgentFiles(cwd2, provider, projectName, allowedPaths, writablePaths) {
+  const { agentsDir, ext } = getProviderAgentInfo(provider);
+  return AGENT_NAMES.map((name) => {
+    const filePath = join11(cwd2, agentsDir, `${name}${ext}`);
+    if (!existsSync7(filePath)) {
+      return { name, status: "missing" };
+    }
+    try {
+      const live = readFileSync6(filePath, "utf8");
+      const expected = generateExpectedAgentContent(name, provider, {
+        projectName,
+        allowedPaths,
+        writablePaths
+      });
+      return { name, status: live === expected ? "ok" : "outdated" };
+    } catch {
+      return { name, status: "outdated" };
+    }
+  });
+}
+function getProviderSkillsDir(provider) {
+  switch (provider) {
+    case "claude-code":
+      return ".claude/skills";
+    case "opencode":
+      return ".opencode/skills";
+    case "codex-cli":
+      return ".agents/skills";
+    default:
+      return ".claude/skills";
+  }
+}
+function checkSkills(cwd2, provider) {
+  const skillsDir = getProviderSkillsDir(provider);
+  const skillSourceBase = join11(__dirname4, "materializer", "skills");
+  return SKILL_NAMES.map((name) => {
+    const livePath = join11(cwd2, skillsDir, name, "SKILL.md");
+    const sourcePath = join11(skillSourceBase, name, "SKILL.md");
+    if (!existsSync7(livePath)) {
+      return { name, status: "missing" };
+    }
+    try {
+      const live = readFileSync6(livePath, "utf8");
+      const source = readFileSync6(sourcePath, "utf8");
+      return { name, status: live === source ? "ok" : "outdated" };
+    } catch {
+      return { name, status: "outdated" };
+    }
+  });
+}
+async function getDoctorStatus(cwd2) {
+  const lib = await checkLibVersion();
+  let config;
+  try {
+    config = await loadConfig(cwd2);
+  } catch {
+    return {
+      lib,
+      agents: [],
+      skills: []
+    };
+  }
+  const provider = config.provider;
+  const projectName = config.project.name;
+  const allowedPaths = (config.agents.explorer.allowedPaths ?? []).join(", ");
+  const writablePaths = (config.agents.builder.writablePaths ?? []).join(", ");
+  const agents = checkAgentFiles(cwd2, provider, projectName, allowedPaths, writablePaths);
+  const skills = checkSkills(cwd2, provider);
+  return { lib, agents, skills };
+}
+
+// src/commands/doctor.ts
+function ok(label, detail) {
+  console.log(`  ${pc3.cyan(label.padEnd(16))}${pc3.green("[\u2713]")} ${detail}`);
+}
+function warn(label, detail, hint) {
+  console.log(`  ${pc3.cyan(label.padEnd(16))}${pc3.yellow("[!]")} ${detail}`);
+  if (hint) {
+    console.log(`  ${"".padEnd(16)}    ${pc3.dim(hint)}`);
+  }
+}
+function neutral(label, detail) {
+  console.log(`  ${pc3.cyan(label.padEnd(16))}${pc3.dim("[~]")} ${detail}`);
+}
+function printLibSection(lib) {
+  if (lib.latest === null) {
+    neutral("lib version", `${lib.current} (unknown \u2014 could not reach npm registry)`);
+  } else if (lib.outdated) {
+    warn(
+      "lib version",
+      `${lib.current} \u2192 ${lib.latest} available`,
+      `run: npm i @cardor/agent-harness-kit@latest && ahk build`
+    );
+  } else {
+    ok("lib version", `${lib.current} (up to date)`);
+  }
+}
+function printAgentsSection(agents) {
+  if (agents.length === 0) {
+    warn("agent files", "no config found \u2014 run: ahk init");
+    return;
+  }
+  const missing = agents.filter((a) => a.status === "missing");
+  const outdated = agents.filter((a) => a.status === "outdated");
+  if (missing.length === 0 && outdated.length === 0) {
+    ok("agent files", "all up to date");
+    return;
+  }
+  for (const agent of missing) {
+    warn("agent files", `${agent.name} missing`, "run: ahk build");
+  }
+  for (const agent of outdated) {
+    warn("agent files", `${agent.name} outdated`, "run: ahk build");
+  }
+}
+function printSkillsSection(skills) {
+  if (skills.length === 0) {
+    warn("harness skills", "no config found \u2014 run: ahk init");
+    return;
+  }
+  const issues = skills.filter((s) => s.status !== "ok");
+  if (issues.length === 0) {
+    ok("harness skills", "all present and up to date");
+    return;
+  }
+  for (const skill of issues) {
+    const detail = skill.status === "missing" ? `${skill.name} missing` : `${skill.name} outdated`;
+    warn("harness skills", detail, "run: ahk build");
+  }
+}
+async function runDoctor(cwd2) {
+  let configFound = true;
+  try {
+    await loadConfig(cwd2);
+  } catch {
+    configFound = false;
+  }
+  console.log("");
+  console.log(pc3.bold(`\u25CF ahk doctor ` + "\u2500".repeat(44)));
+  console.log("");
+  const status = await getDoctorStatus(cwd2);
+  printLibSection(status.lib);
+  if (!configFound) {
+    console.log("");
+    warn("config", "no agent-harness-kit.config found", "run: ahk init");
+    console.log("");
+    return;
+  }
+  console.log("");
+  printAgentsSection(status.agents);
+  console.log("");
+  printSkillsSection(status.skills);
+  console.log("");
+}
+
 // src/commands/export.ts
 import { writeFileSync as writeFileSync8 } from "fs";
-import pc3 from "picocolors";
+import pc4 from "picocolors";
 async function runExport(cwd2, opts) {
   if (!opts.sql && !opts.json) {
-    console.error(pc3.red("Specify --sql or --json"));
+    console.error(pc4.red("Specify --sql or --json"));
     process.exit(1);
   }
   const config = await loadConfig(cwd2);
@@ -1823,13 +2089,13 @@ async function runExport(cwd2, opts) {
       const out = JSON.stringify(data, null, 2) + "\n";
       if (opts.output) {
         writeFileSync8(opts.output, out, "utf8");
-        console.log(pc3.green(`\u2713 Exported JSON \u2192 ${opts.output}`));
+        console.log(pc4.green(`\u2713 Exported JSON \u2192 ${opts.output}`));
       } else {
         process.stdout.write(out);
       }
     }
     if (opts.sql) {
-      console.error(pc3.dim("SQL dump requires direct SQLite access \u2014 use: sqlite3 .harness/harness.db .dump"));
+      console.error(pc4.dim("SQL dump requires direct SQLite access \u2014 use: sqlite3 .harness/harness.db .dump"));
       process.exit(1);
     }
   } finally {
@@ -1839,27 +2105,27 @@ async function runExport(cwd2, opts) {
 
 // src/commands/health.ts
 import { spawnSync } from "child_process";
-import { existsSync as existsSync7 } from "fs";
-import { join as join10, resolve as resolve8 } from "path";
-import pc4 from "picocolors";
-function checkLine(label, ok2, message, indent = 0) {
-  const prefix = label ? pc4.cyan(`[${label}] `) : " ".repeat(indent);
-  const icon = ok2 ? pc4.green("\u2713") : pc4.red("\u2717");
-  console.log(prefix + icon + " " + (ok2 ? pc4.green(message) : pc4.red(message)));
+import { existsSync as existsSync8 } from "fs";
+import { join as join12, resolve as resolve8 } from "path";
+import pc5 from "picocolors";
+function checkLine(label, ok3, message, indent = 0) {
+  const prefix = label ? pc5.cyan(`[${label}] `) : " ".repeat(indent);
+  const icon = ok3 ? pc5.green("\u2713") : pc5.red("\u2717");
+  console.log(prefix + icon + " " + (ok3 ? pc5.green(message) : pc5.red(message)));
 }
 async function runHealth(cwd2) {
   let config;
   try {
     config = await loadConfig(cwd2);
   } catch {
-    console.error(pc4.red("\u2717 No config found. Run: ahk init"));
+    console.error(pc5.red("\u2717 No config found. Run: ahk init"));
     process.exit(1);
   }
   let allOk = true;
   let dbOk;
   if (config.database.type === "sqlite") {
     const dbPath = resolve8(cwd2, config.database.path);
-    dbOk = existsSync7(dbPath);
+    dbOk = existsSync8(dbPath);
     checkLine("checking DB", dbOk, `${config.database.path} reachable`);
   } else {
     dbOk = true;
@@ -1872,31 +2138,31 @@ async function runHealth(cwd2) {
   const agentsLabelWidth = "[checking agents] ".length;
   for (let i = 0; i < agentNames.length; i++) {
     const name = agentNames[i];
-    const agentPath = join10(cwd2, agentsDir, `${name}${providerFiles.agentExtension}`);
-    const ok2 = existsSync7(agentPath);
+    const agentPath = join12(cwd2, agentsDir, `${name}${providerFiles.agentExtension}`);
+    const ok3 = existsSync8(agentPath);
     checkLine(
       i === 0 ? "checking agents" : null,
-      ok2,
+      ok3,
       `${name}${providerFiles.agentExtension} present`,
       agentsLabelWidth
     );
-    if (!ok2) allOk = false;
+    if (!ok3) allOk = false;
   }
   if (config.tools.mcp.enabled) {
     const mcpFile = providerFiles.mcpFile;
     const mcpPath = resolve8(cwd2, mcpFile);
-    const mcpOk = existsSync7(mcpPath);
+    const mcpOk = existsSync8(mcpPath);
     checkLine("checking MCP", mcpOk, `${mcpFile} valid`);
     if (!mcpOk) allOk = false;
   }
   if (!allOk) {
     console.log("");
-    console.error(pc4.red("\u2717 Harness checks failed \u2014 fix the above before running health.sh"));
+    console.error(pc5.red("\u2717 Harness checks failed \u2014 fix the above before running health.sh"));
     process.exit(1);
   }
   const scriptPath = resolve8(cwd2, config.health.scriptPath);
-  if (!existsSync7(scriptPath)) {
-    console.error(pc4.red(`\u2717 health.sh not found: ${scriptPath}`));
+  if (!existsSync8(scriptPath)) {
+    console.error(pc5.red(`\u2717 health.sh not found: ${scriptPath}`));
     console.error("  Run ahk init first.");
     process.exit(1);
   }
@@ -1906,14 +2172,14 @@ async function runHealth(cwd2) {
     encoding: "utf8"
   });
   if (result.error) {
-    console.error(pc4.red(`\u2717 Failed to run health.sh: ${result.error.message}`));
+    console.error(pc5.red(`\u2717 Failed to run health.sh: ${result.error.message}`));
     process.exit(1);
   }
   if (result.status === 0) {
-    console.log(pc4.green("\u2713 Health check passed"));
+    console.log(pc5.green("\u2713 Health check passed"));
     process.exit(0);
   } else {
-    console.error(pc4.red(`\u2717 Health check failed (exit ${result.status ?? "unknown"})`));
+    console.error(pc5.red(`\u2717 Health check failed (exit ${result.status ?? "unknown"})`));
     process.exit(result.status ?? 1);
   }
 }
@@ -1932,9 +2198,9 @@ function getProviderHealthFiles(provider) {
 
 // src/commands/init.ts
 import { mkdirSync as mkdirSync8, writeFileSync as writeFileSync9 } from "fs";
-import { join as join12 } from "path";
+import { join as join14 } from "path";
 import * as p3 from "@clack/prompts";
-import pc6 from "picocolors";
+import pc7 from "picocolors";
 
 // src/schema/init.ts
 import * as v from "valibot";
@@ -1987,14 +2253,14 @@ var cliFormWithRetry = async (formFn, schema) => {
 };
 
 // src/commands/init-helpers.ts
-import { existsSync as existsSync8, readFileSync as readFileSync6 } from "fs";
-import { join as join11 } from "path";
-import pc5 from "picocolors";
+import { existsSync as existsSync9, readFileSync as readFileSync7 } from "fs";
+import { join as join13 } from "path";
+import pc6 from "picocolors";
 function readProjectNameFromPackageJson(cwd2) {
   try {
-    const pkgPath2 = join11(cwd2, "package.json");
-    if (!existsSync8(pkgPath2)) return null;
-    const content = readFileSync6(pkgPath2, "utf8");
+    const pkgPath2 = join13(cwd2, "package.json");
+    if (!existsSync9(pkgPath2)) return null;
+    const content = readFileSync7(pkgPath2, "utf8");
     const pkg2 = JSON.parse(content);
     const name = pkg2?.name;
     if (typeof name === "string" && name.trim()) return name.trim();
@@ -2005,10 +2271,10 @@ function readProjectNameFromPackageJson(cwd2) {
 }
 function detectConfigExtension(cwd2) {
   try {
-    if (existsSync8(join11(cwd2, "tsconfig.json"))) return "ts";
-    const pkgPath2 = join11(cwd2, "package.json");
-    if (!existsSync8(pkgPath2)) return "mjs";
-    const pkg2 = JSON.parse(readFileSync6(pkgPath2, "utf8"));
+    if (existsSync9(join13(cwd2, "tsconfig.json"))) return "ts";
+    const pkgPath2 = join13(cwd2, "package.json");
+    if (!existsSync9(pkgPath2)) return "mjs";
+    const pkg2 = JSON.parse(readFileSync7(pkgPath2, "utf8"));
     if (pkg2?.type === "module") return "mjs";
   } catch {
   }
@@ -2059,27 +2325,27 @@ function stripAnsi(str2) {
 function drawBox(lines) {
   const width = Math.max(...lines.map((l) => stripAnsi(l).length));
   const border = "\u2500".repeat(width);
-  console.log(pc5.yellow(`\u250C${border}\u2510`));
+  console.log(pc6.yellow(`\u250C${border}\u2510`));
   for (const line of lines) {
     const pad = width - stripAnsi(line).length;
     const padStr = pad > 0 ? " ".repeat(pad) : "";
-    console.log(pc5.yellow("\u2502") + line + padStr + pc5.yellow("\u2502"));
+    console.log(pc6.yellow("\u2502") + line + padStr + pc6.yellow("\u2502"));
   }
-  console.log(pc5.yellow(`\u2514${border}\u2518`));
+  console.log(pc6.yellow(`\u2514${border}\u2518`));
 }
 function printWelcomeMessage(projectName) {
   const sep = "\u2500".repeat(38);
   const lines = [
-    `  ${pc5.bold(pc5.white("agent-harness-kit"))}  `,
-    `  ${pc5.gray("\u2014")} harness scaffolding ${pc5.gray("\u2014")}  `,
-    `  ${pc5.gray(sep)}  `,
-    `  ${pc5.bold("Project:")}  ${projectName || "\u2014"}  `,
-    `  ${pc5.bold("Status:")}   ${pc5.green("ready to configure")}  `,
-    `  ${pc5.gray(sep)}  `,
-    `  ${pc5.gray("Next steps:")}  `,
-    `  ${pc5.gray("\u2192")} ${pc5.gray("Set up your AI provider config")}  `,
-    `  ${pc5.gray("\u2192")} ${pc5.gray("Run your health check to verify")}  `,
-    `  ${pc5.gray("\u2192")} ${pc5.gray("Start adding tasks for your agents")}  `
+    `  ${pc6.bold(pc6.white("agent-harness-kit"))}  `,
+    `  ${pc6.gray("\u2014")} harness scaffolding ${pc6.gray("\u2014")}  `,
+    `  ${pc6.gray(sep)}  `,
+    `  ${pc6.bold("Project:")}  ${projectName || "\u2014"}  `,
+    `  ${pc6.bold("Status:")}   ${pc6.green("ready to configure")}  `,
+    `  ${pc6.gray(sep)}  `,
+    `  ${pc6.gray("Next steps:")}  `,
+    `  ${pc6.gray("\u2192")} ${pc6.gray("Set up your AI provider config")}  `,
+    `  ${pc6.gray("\u2192")} ${pc6.gray("Run your health check to verify")}  `,
+    `  ${pc6.gray("\u2192")} ${pc6.gray("Start adding tasks for your agents")}  `
   ];
   console.log();
   drawBox(lines);
@@ -2091,18 +2357,18 @@ async function runInit(cwd2, flags) {
   const existingConfig = findConfigFile(cwd2);
   if (existingConfig) {
     console.log(
-      pc6.yellow("\u26A0") + " " + pc6.bold("Project already initialized.") + pc6.dim(` (${existingConfig})`)
+      pc7.yellow("\u26A0") + " " + pc7.bold("Project already initialized.") + pc7.dim(` (${existingConfig})`)
     );
     console.log();
-    console.log(pc6.dim("Suggested next steps:"));
+    console.log(pc7.dim("Suggested next steps:"));
     console.log(
-      "  " + pc6.cyan("ahk build") + pc6.dim("         \u2014 re-sync agent files after updating the library")
+      "  " + pc7.cyan("ahk build") + pc7.dim("         \u2014 re-sync agent files after updating the library")
     );
-    console.log("  " + pc6.cyan("ahk build --sync") + pc6.dim("  \u2014 also sync agent permissions"));
+    console.log("  " + pc7.cyan("ahk build --sync") + pc7.dim("  \u2014 also sync agent permissions"));
     console.log(
-      "  " + pc6.cyan("ahk reset") + pc6.dim("         \u2014 wipe and re-initialize from scratch")
+      "  " + pc7.cyan("ahk reset") + pc7.dim("         \u2014 wipe and re-initialize from scratch")
     );
-    console.log("  " + pc6.cyan("ahk dashboard") + pc6.dim("         \u2014 open the harness dashboard"));
+    console.log("  " + pc7.cyan("ahk dashboard") + pc7.dim("         \u2014 open the harness dashboard"));
     process.exit(0);
   }
   const detectedName = flags.name ?? readProjectNameFromPackageJson(cwd2);
@@ -2241,8 +2507,8 @@ async function runInit(cwd2, flags) {
       tasksAdapter,
       port: config.tools.mcp.port
     });
-    writeFileSync9(join12(installDir, configFileName), configContent, "utf8");
-    mkdirSync8(join12(installDir, config.storage.dir), { recursive: true });
+    writeFileSync9(join14(installDir, configFileName), configContent, "utf8");
+    mkdirSync8(join14(installDir, config.storage.dir), { recursive: true });
     const db = await openDB(config, installDir);
     await materializer.scaffold(config, { cwd: installDir, firstTask });
     if (firstTask) {
@@ -2261,30 +2527,30 @@ async function runInit(cwd2, flags) {
     p3.log.error(err instanceof Error ? err.message : String(err));
     throw err;
   }
-  console.log(pc6.green("\u2713 Scaffolded harness in current directory"));
+  console.log(pc7.green("\u2713 Scaffolded harness in current directory"));
   const agentsDir = provider === "claude-code" ? ".claude/agents/" : ".opencode/agents/";
   const mcpFile = provider === "claude-code" ? ".claude/mcp.json" : "./opencode.json";
   console.log("");
-  console.log(pc6.green(`\u2713 agent-harness-kit.config.${configExt}`));
-  console.log(pc6.green("\u2713 AGENTS.md"));
-  console.log(pc6.green("\u2713 health.sh"));
-  console.log(pc6.green("\u2713 .harness/harness.db"));
-  console.log(pc6.green("\u2713 .harness/current.md"));
-  console.log(pc6.green(`\u2713 ${agentsDir}lead.md`));
-  console.log(pc6.green(`\u2713 ${agentsDir}explorer.md`));
-  console.log(pc6.green(`\u2713 ${agentsDir}builder.md`));
-  console.log(pc6.green(`\u2713 ${agentsDir}reviewer.md`));
-  console.log(pc6.green(`\u2713 ${mcpFile}`));
-  console.log(pc6.green("\u2713 .gitignore entries added"));
+  console.log(pc7.green(`\u2713 agent-harness-kit.config.${configExt}`));
+  console.log(pc7.green("\u2713 AGENTS.md"));
+  console.log(pc7.green("\u2713 health.sh"));
+  console.log(pc7.green("\u2713 .harness/harness.db"));
+  console.log(pc7.green("\u2713 .harness/current.md"));
+  console.log(pc7.green(`\u2713 ${agentsDir}lead.md`));
+  console.log(pc7.green(`\u2713 ${agentsDir}explorer.md`));
+  console.log(pc7.green(`\u2713 ${agentsDir}builder.md`));
+  console.log(pc7.green(`\u2713 ${agentsDir}reviewer.md`));
+  console.log(pc7.green(`\u2713 ${mcpFile}`));
+  console.log(pc7.green("\u2713 .gitignore entries added"));
   console.log("");
-  console.log(pc6.cyan("\u2192") + ` Edit ${pc6.cyan("health.sh")} with your project checks`);
-  console.log(pc6.cyan("\u2192") + ` ${pc6.cyan("ahk task add")} to queue work for agents`);
+  console.log(pc7.cyan("\u2192") + ` Edit ${pc7.cyan("health.sh")} with your project checks`);
+  console.log(pc7.cyan("\u2192") + ` ${pc7.cyan("ahk task add")} to queue work for agents`);
   console.log(
-    pc6.cyan("\u2192") + ` Enrich your docs with knowledge graphs: ${pc6.cyan("https://github.com/safishamsi/graphify")}`
+    pc7.cyan("\u2192") + ` Enrich your docs with knowledge graphs: ${pc7.cyan("https://github.com/safishamsi/graphify")}`
   );
   const recommendations = [
     `   Give a try to Heimdall MCP: Transparent proxy that traces every MCP tool call with OpenTelemetry.  `,
-    `   Learn more: ${pc6.cyan("https://github.com/enmanuelmag/heimdall-mcp")}                              `
+    `   Learn more: ${pc7.cyan("https://github.com/enmanuelmag/heimdall-mcp")}                              `
   ];
   console.log("");
   drawBox(recommendations);
@@ -2292,7 +2558,7 @@ async function runInit(cwd2, flags) {
 
 // src/commands/migrate.ts
 import * as p4 from "@clack/prompts";
-import pc7 from "picocolors";
+import pc8 from "picocolors";
 async function runMigrate(cwd2, opts) {
   const config = await loadConfig(cwd2);
   let target;
@@ -2314,7 +2580,7 @@ async function runMigrate(cwd2, opts) {
     target = val;
   }
   if (target === config.provider) {
-    console.log(pc7.dim(`Already on ${target} \u2014 nothing to migrate.`));
+    console.log(pc8.dim(`Already on ${target} \u2014 nothing to migrate.`));
     return;
   }
   const spinner6 = p4.spinner();
@@ -2322,27 +2588,27 @@ async function runMigrate(cwd2, opts) {
   try {
     const targetMaterializer = getMaterializer(target);
     await targetMaterializer.build(config, cwd2);
-    spinner6.stop(pc7.green(`Migrated to ${target}`));
+    spinner6.stop(pc8.green(`Migrated to ${target}`));
     p4.log.warn(`Update agent-harness-kit.config.ts: set provider: '${target}'`);
     p4.log.warn(`Then run: ahk build`);
   } catch (err) {
-    spinner6.stop(pc7.red("Migration failed"));
+    spinner6.stop(pc8.red("Migration failed"));
     p4.log.error(err instanceof Error ? err.message : String(err));
     process.exit(1);
   }
 }
 
 // src/commands/reset.ts
-import { existsSync as existsSync9, readdirSync, rmSync } from "fs";
-import { join as join13, resolve as resolve9 } from "path";
+import { existsSync as existsSync10, readdirSync, rmSync } from "fs";
+import { join as join15, resolve as resolve9 } from "path";
 import * as p5 from "@clack/prompts";
-import pc8 from "picocolors";
+import pc9 from "picocolors";
 var AGENT_MD_FILES = ["lead", "explorer", "consultant", "builder", "reviewer"];
 async function resetAgentMds(cwd2, provider) {
   const agentDir = provider === "claude-code" ? ".claude/agents" : ".opencode/agents";
   const agentDirPath = resolve9(cwd2, agentDir);
-  if (!existsSync9(agentDirPath)) {
-    console.log(pc8.yellow(`  Skipping agent files \u2014 directory not found: ${agentDirPath}`));
+  if (!existsSync10(agentDirPath)) {
+    console.log(pc9.yellow(`  Skipping agent files \u2014 directory not found: ${agentDirPath}`));
     return;
   }
   const existingFiles = [];
@@ -2354,11 +2620,11 @@ async function resetAgentMds(cwd2, provider) {
       }
     }
   } catch {
-    console.log(pc8.yellow(`  Skipping agent files \u2014 ${agentDirPath} is not readable`));
+    console.log(pc9.yellow(`  Skipping agent files \u2014 ${agentDirPath} is not readable`));
     return;
   }
   if (existingFiles.length === 0) {
-    console.log(pc8.yellow(`  No agent MD files found in ${agentDir}/`));
+    console.log(pc9.yellow(`  No agent MD files found in ${agentDir}/`));
     return;
   }
   for (const file of existingFiles) {
@@ -2367,19 +2633,19 @@ async function resetAgentMds(cwd2, provider) {
       initialValue: true
     });
     if (p5.isCancel(confirm3)) {
-      console.log(pc8.red("  Cancelled by user."));
+      console.log(pc9.red("  Cancelled by user."));
       return;
     }
     if (confirm3) {
       try {
-        const filePath = join13(agentDirPath, file);
+        const filePath = join15(agentDirPath, file);
         rmSync(filePath, { force: true });
-        console.log(pc8.green(`  Removed ${file}`));
+        console.log(pc9.green(`  Removed ${file}`));
       } catch {
-        console.error(pc8.red(`  Failed to remove ${file}`));
+        console.error(pc9.red(`  Failed to remove ${file}`));
       }
     } else {
-      console.log(pc8.cyan(`  Skipped ${file}`));
+      console.log(pc9.cyan(`  Skipped ${file}`));
     }
   }
 }
@@ -2388,7 +2654,7 @@ async function runReset(cwd2, opts) {
   try {
     config = await loadConfig(cwd2);
   } catch {
-    console.error(pc8.red("\u2717 No agent-harness-kit.config found. Run: ahk init"));
+    console.error(pc9.red("\u2717 No agent-harness-kit.config found. Run: ahk init"));
     process.exit(1);
   }
   const storageDir = config.storage.dir || ".harness";
@@ -2397,12 +2663,12 @@ async function runReset(cwd2, opts) {
   let resetDb = false;
   let resetFeatureList = false;
   let resetAgentMdsFlag = false;
-  if (dbPath && existsSync9(dbPath)) {
+  if (dbPath && existsSync10(dbPath)) {
     if (opts.force) {
       resetDb = true;
     } else {
       if (config.database.type !== "sqlite") {
-        console.log(pc8.yellow(`  Skipping DB reset \u2014 database type "${config.database.type}" is not managed by this command.`));
+        console.log(pc9.yellow(`  Skipping DB reset \u2014 database type "${config.database.type}" is not managed by this command.`));
         resetDb = false;
       } else {
         const confirm3 = await p5.confirm({
@@ -2410,16 +2676,16 @@ async function runReset(cwd2, opts) {
           initialValue: true
         });
         if (p5.isCancel(confirm3)) {
-          console.log(pc8.red("  Cancelled by user."));
+          console.log(pc9.red("  Cancelled by user."));
           return;
         }
         resetDb = confirm3;
       }
     }
   } else if (!dbPath) {
-    console.log(pc8.dim(`  Skipping DB reset \u2014 remote ${config.database.type} database is not managed by this command.`));
+    console.log(pc9.dim(`  Skipping DB reset \u2014 remote ${config.database.type} database is not managed by this command.`));
   }
-  if (existsSync9(featureListPath)) {
+  if (existsSync10(featureListPath)) {
     if (opts.force) {
       resetFeatureList = true;
     } else {
@@ -2428,7 +2694,7 @@ async function runReset(cwd2, opts) {
         initialValue: true
       });
       if (p5.isCancel(confirm3)) {
-        console.log(pc8.red("  Cancelled by user."));
+        console.log(pc9.red("  Cancelled by user."));
         return;
       }
       resetFeatureList = confirm3;
@@ -2442,17 +2708,17 @@ async function runReset(cwd2, opts) {
       rmSync(dbPath, { force: true });
       rmSync(`${dbPath}-wal`, { force: true });
       rmSync(`${dbPath}-shm`, { force: true });
-      console.log(pc8.green(`  \u2713 Removed ${dbPath}`));
+      console.log(pc9.green(`  \u2713 Removed ${dbPath}`));
     } catch {
-      console.error(pc8.red(`  \u2717 Failed to remove ${dbPath}`));
+      console.error(pc9.red(`  \u2717 Failed to remove ${dbPath}`));
     }
   }
   if (resetFeatureList) {
     try {
       rmSync(featureListPath, { force: true });
-      console.log(pc8.green(`  \u2713 Removed ${storageDir}/feature_list.json`));
+      console.log(pc9.green(`  \u2713 Removed ${storageDir}/feature_list.json`));
     } catch {
-      console.error(pc8.red(`  \u2717 Failed to remove ${featureListPath}`));
+      console.error(pc9.red(`  \u2717 Failed to remove ${featureListPath}`));
     }
   }
   if (resetAgentMdsFlag) {
@@ -2460,16 +2726,16 @@ async function runReset(cwd2, opts) {
     await resetAgentMds(cwd2, opts.provider || "claude-code");
   }
   if (!resetDb && !resetFeatureList && !resetAgentMdsFlag) {
-    console.log(pc8.yellow("  Nothing to reset (all items missing or skipped)."));
+    console.log(pc9.yellow("  Nothing to reset (all items missing or skipped)."));
     return;
   }
   console.log("");
-  console.log(pc8.green('\u2713 Reset complete. Run "ahk init" to scaffold a fresh harness.'));
+  console.log(pc9.green('\u2713 Reset complete. Run "ahk init" to scaffold a fresh harness.'));
 }
 
 // src/core/mcp-server.ts
-import { existsSync as existsSync11, mkdirSync as mkdirSync9, readdirSync as readdirSync2, readFileSync as readFileSync8, statSync, writeFileSync as writeFileSync10 } from "fs";
-import { join as join15, resolve as resolve10 } from "path";
+import { existsSync as existsSync12, mkdirSync as mkdirSync9, readdirSync as readdirSync2, readFileSync as readFileSync9, statSync, writeFileSync as writeFileSync10 } from "fs";
+import { join as join17, resolve as resolve10 } from "path";
 import { Server } from "@modelcontextprotocol/sdk/server";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import {
@@ -2478,8 +2744,8 @@ import {
 } from "@modelcontextprotocol/sdk/types.js";
 
 // src/core/permissions-check.ts
-import { existsSync as existsSync10, readFileSync as readFileSync7 } from "fs";
-import { join as join14 } from "path";
+import { existsSync as existsSync11, readFileSync as readFileSync8 } from "fs";
+import { join as join16 } from "path";
 var CANONICAL = {
   lead: [...MCP_CLAUDE_PERMISSIONS_LEAD],
   explorer: [...MCP_CLAUDE_PERMISSIONS_EXPLORER],
@@ -2502,21 +2768,21 @@ function checkPermissionsSync(cwd2, config) {
   const agents = {};
   let in_sync = true;
   for (const agent of ["lead", "explorer", "consultant", "builder", "reviewer"]) {
-    const filePath = join14(cwd2, ".claude", "agents", `${agent}.md`);
-    if (!existsSync10(filePath)) {
+    const filePath = join16(cwd2, ".claude", "agents", `${agent}.md`);
+    if (!existsSync11(filePath)) {
       const missing2 = CANONICAL[agent];
       agents[agent] = { ok: false, missing: missing2, extra: [] };
       in_sync = false;
       continue;
     }
-    const content = readFileSync7(filePath, "utf-8");
+    const content = readFileSync8(filePath, "utf-8");
     const installed = parseToolsFromFrontmatter(content);
     const canonical = CANONICAL[agent];
     const missing = canonical.filter((t) => !installed.includes(t));
     const extra = installed.filter((t) => !canonical.includes(t));
-    const ok2 = missing.length === 0 && extra.length === 0;
-    if (!ok2) in_sync = false;
-    agents[agent] = { ok: ok2, missing, extra };
+    const ok3 = missing.length === 0 && extra.length === 0;
+    if (!ok3) in_sync = false;
+    agents[agent] = { ok: ok3, missing, extra };
   }
   return { in_sync, agents };
 }
@@ -2772,6 +3038,11 @@ var TOOLS = [
     name: "deps.check",
     description: "Compare current package.json against .harness/deps-lock.json and report changes",
     inputSchema: { type: "object", properties: {}, required: [] }
+  },
+  {
+    name: "ahk.doctor",
+    description: "Check lib version, agent files, and harness skills sync status. Returns structured JSON.",
+    inputSchema: { type: "object", properties: {}, required: [] }
   }
 ];
 async function startMcpServer(config, cwd2) {
@@ -2789,7 +3060,7 @@ async function startMcpServer(config, cwd2) {
       const result = await dispatch(name, a, db, docsPath, cwd2, config);
       return result;
     } catch (err) {
-      return ok(`Error: ${err instanceof Error ? err.message : String(err)}`, true);
+      return ok2(`Error: ${err instanceof Error ? err.message : String(err)}`, true);
     }
   });
   const transport = new StdioServerTransport();
@@ -2801,20 +3072,20 @@ async function dispatch(name, args, db, docsPath, cwd2, config) {
       const taskId = num(args, "taskId");
       const agent = str(args, "agent");
       const action = await db.startAction(taskId, agent);
-      return ok(JSON.stringify({ actionId: action.id, taskId, agent, status: "in_progress" }));
+      return ok2(JSON.stringify({ actionId: action.id, taskId, agent, status: "in_progress" }));
     }
     case "actions.write": {
       const actionId = str(args, "actionId");
       const sectionType = str(args, "sectionType");
       const content = str(args, "content");
       await db.writeSection(actionId, sectionType, content);
-      return ok(JSON.stringify({ actionId, sectionType, recorded: true }));
+      return ok2(JSON.stringify({ actionId, sectionType, recorded: true }));
     }
     case "actions.complete": {
       const actionId = str(args, "actionId");
       const summary = str(args, "summary");
       const action = await db.completeAction(actionId, summary);
-      return ok(
+      return ok2(
         JSON.stringify({ actionId, status: action.status, completedAt: action.completed_at })
       );
     }
@@ -2827,22 +3098,22 @@ async function dispatch(name, args, db, docsPath, cwd2, config) {
           sections: await db.getActionSections(a.id)
         }))
       );
-      return ok(JSON.stringify(full, null, 2));
+      return ok2(JSON.stringify(full, null, 2));
     }
     case "tasks.get": {
       const status = args["status"];
       const includeArchived = args["includeArchived"];
       const tasks = status ? await db.getTasks(status, includeArchived ?? false) : await db.getTasks(void 0, includeArchived ?? false);
-      return ok(JSON.stringify(tasks, null, 2));
+      return ok2(JSON.stringify(tasks, null, 2));
     }
     case "tasks.claim": {
       const id = num(args, "id");
       const agent = str(args, "agent");
       const task2 = await db.claimTask(id, agent);
       if (!task2) {
-        return ok(JSON.stringify({ error: "task_already_claimed", taskId: id }));
+        return ok2(JSON.stringify({ error: "task_already_claimed", taskId: id }));
       }
-      return ok(JSON.stringify(task2));
+      return ok2(JSON.stringify(task2));
     }
     case "tasks.add": {
       const title = str(args, "title");
@@ -2850,7 +3121,7 @@ async function dispatch(name, args, db, docsPath, cwd2, config) {
       const description = args["description"];
       const acceptance = args["acceptance"];
       const task2 = await db.addTask({ slug, title, description, acceptance });
-      return ok(JSON.stringify(task2));
+      return ok2(JSON.stringify(task2));
     }
     case "tasks.update": {
       const id = num(args, "id");
@@ -2859,12 +3130,12 @@ async function dispatch(name, args, db, docsPath, cwd2, config) {
         await db.closeOrphanedActions(id);
       }
       const task2 = await db.updateTaskStatus(id, status);
-      return ok(JSON.stringify(task2));
+      return ok2(JSON.stringify(task2));
     }
     case "docs.search": {
       const query = str(args, "query");
       const results = searchDocs(docsPath, query);
-      return ok(JSON.stringify(results, null, 2));
+      return ok2(JSON.stringify(results, null, 2));
     }
     case "actions.record_file": {
       const actionId = str(args, "actionId");
@@ -2872,17 +3143,17 @@ async function dispatch(name, args, db, docsPath, cwd2, config) {
       const operation = str(args, "operation");
       const notes = args["notes"];
       await db.recordFile(actionId, filePath, operation, notes);
-      return ok(JSON.stringify({ actionId, filePath, operation, recorded: true }));
+      return ok2(JSON.stringify({ actionId, filePath, operation, recorded: true }));
     }
     case "tasks.acceptance.update": {
       const criterionId = num(args, "criterionId");
       await db.markAcceptanceMet(criterionId);
-      return ok(JSON.stringify({ criterionId, met: true }));
+      return ok2(JSON.stringify({ criterionId, met: true }));
     }
     case "tasks.acceptance.get": {
       const taskId = num(args, "taskId");
       const criteria = await db.getTaskAcceptance(taskId);
-      return ok(JSON.stringify(criteria, null, 2));
+      return ok2(JSON.stringify(criteria, null, 2));
     }
     case "actions.record_tool": {
       const actionId = str(args, "actionId");
@@ -2890,7 +3161,7 @@ async function dispatch(name, args, db, docsPath, cwd2, config) {
       const argsJson = args["argsJson"];
       const resultSummary = args["resultSummary"];
       await db.recordTool(actionId, toolName, argsJson, resultSummary);
-      return ok(JSON.stringify({ actionId, toolName, recorded: true }));
+      return ok2(JSON.stringify({ actionId, toolName, recorded: true }));
     }
     case "tasks.edit": {
       const id = num(args, "id");
@@ -2898,7 +3169,7 @@ async function dispatch(name, args, db, docsPath, cwd2, config) {
       const description = args["description"];
       const acceptance = args["acceptance"];
       const task2 = await db.getTaskById(id);
-      if (!task2) return ok(JSON.stringify({ error: "Task not found", taskId: id }), true);
+      if (!task2) return ok2(JSON.stringify({ error: "Task not found", taskId: id }), true);
       await db.updateTask(id, {
         title,
         description: description !== void 0 ? description : void 0
@@ -2907,37 +3178,37 @@ async function dispatch(name, args, db, docsPath, cwd2, config) {
         await db.updateTaskAcceptance(id, acceptance);
       }
       const updated = await db.getTaskById(id);
-      return ok(JSON.stringify(updated));
+      return ok2(JSON.stringify(updated));
     }
     case "tasks.archive": {
       const id = num(args, "id");
       const task2 = await db.archiveTask(id);
-      return ok(JSON.stringify(task2));
+      return ok2(JSON.stringify(task2));
     }
     case "tasks.unarchive": {
       const id = num(args, "id");
       const task2 = await db.unarchiveTask(id);
-      return ok(JSON.stringify(task2));
+      return ok2(JSON.stringify(task2));
     }
     case "permissions.check": {
       const result = checkPermissionsSync(cwd2, config);
-      return ok(JSON.stringify(result, null, 2));
+      return ok2(JSON.stringify(result, null, 2));
     }
     case "deps.snapshot": {
-      const pkgPath2 = join15(cwd2, "package.json");
-      if (!existsSync11(pkgPath2)) {
-        return ok("package.json not found in project root", true);
+      const pkgPath2 = join17(cwd2, "package.json");
+      if (!existsSync12(pkgPath2)) {
+        return ok2("package.json not found in project root", true);
       }
-      const pkg2 = JSON.parse(readFileSync8(pkgPath2, "utf8"));
+      const pkg2 = JSON.parse(readFileSync9(pkgPath2, "utf8"));
       const snapshot = {
         capturedAt: (/* @__PURE__ */ new Date()).toISOString(),
         dependencies: pkg2.dependencies ?? {},
         devDependencies: pkg2.devDependencies ?? {}
       };
-      const harnessDir = join15(cwd2, ".harness");
+      const harnessDir = join17(cwd2, ".harness");
       mkdirSync9(harnessDir, { recursive: true });
-      writeFileSync10(join15(harnessDir, "deps-lock.json"), JSON.stringify(snapshot, null, 2), "utf8");
-      return ok(
+      writeFileSync10(join17(harnessDir, "deps-lock.json"), JSON.stringify(snapshot, null, 2), "utf8");
+      return ok2(
         JSON.stringify({
           message: "Snapshot saved to .harness/deps-lock.json",
           capturedAt: snapshot.capturedAt
@@ -2945,21 +3216,21 @@ async function dispatch(name, args, db, docsPath, cwd2, config) {
       );
     }
     case "deps.check": {
-      const pkgPath2 = join15(cwd2, "package.json");
-      const lockPath = join15(cwd2, ".harness", "deps-lock.json");
-      if (!existsSync11(pkgPath2)) {
-        return ok("package.json not found in project root", true);
+      const pkgPath2 = join17(cwd2, "package.json");
+      const lockPath = join17(cwd2, ".harness", "deps-lock.json");
+      if (!existsSync12(pkgPath2)) {
+        return ok2("package.json not found in project root", true);
       }
-      if (!existsSync11(lockPath)) {
-        return ok(
+      if (!existsSync12(lockPath)) {
+        return ok2(
           JSON.stringify({
             status: "no-snapshot",
             message: "No deps-lock.json found. Run deps.snapshot first to establish a baseline."
           })
         );
       }
-      const pkg2 = JSON.parse(readFileSync8(pkgPath2, "utf8"));
-      const lock = JSON.parse(readFileSync8(lockPath, "utf8"));
+      const pkg2 = JSON.parse(readFileSync9(pkgPath2, "utf8"));
+      const lock = JSON.parse(readFileSync9(lockPath, "utf8"));
       const current = { ...pkg2.dependencies ?? {}, ...pkg2.devDependencies ?? {} };
       const previous = { ...lock.dependencies ?? {}, ...lock.devDependencies ?? {} };
       const added = [];
@@ -2986,7 +3257,7 @@ async function dispatch(name, args, db, docsPath, cwd2, config) {
       }
       const significant = added.length > 0 || removed.length > 0 || majorBumps.length > 0;
       const advisory = significant ? "Significant dependency changes detected. Consider running `pnpx autoskills` (or `npx autoskills` if pnpm is unavailable) to refresh agent skills. Clearing stale skills before re-running is recommended." : "No significant dependency changes detected.";
-      return ok(
+      return ok2(
         JSON.stringify({
           significant,
           added,
@@ -2997,8 +3268,25 @@ async function dispatch(name, args, db, docsPath, cwd2, config) {
         })
       );
     }
+    case "ahk.doctor": {
+      const status = await getDoctorStatus(cwd2);
+      const result = {
+        lib: { current: status.lib.current, latest: status.lib.latest, outdated: status.lib.outdated },
+        agents: {
+          missing: status.agents.filter((a) => a.status === "missing").map((a) => a.name),
+          outdated: status.agents.filter((a) => a.status === "outdated").map((a) => a.name),
+          ok: status.agents.filter((a) => a.status === "ok").map((a) => a.name)
+        },
+        skills: {
+          missing: status.skills.filter((s) => s.status === "missing").map((s) => s.name),
+          outdated: status.skills.filter((s) => s.status === "outdated").map((s) => s.name),
+          ok: status.skills.filter((s) => s.status === "ok").map((s) => s.name)
+        }
+      };
+      return ok2(JSON.stringify(result, null, 2));
+    }
     default:
-      return ok(`Unknown tool: ${name}`, true);
+      return ok2(`Unknown tool: ${name}`, true);
   }
 }
 function searchDocs(docsPath, query, maxResults = 10) {
@@ -3009,7 +3297,7 @@ function searchDocs(docsPath, query, maxResults = 10) {
     for (const file of files) {
       if (results.length >= maxResults) break;
       try {
-        const content = readFileSync8(file, "utf8");
+        const content = readFileSync9(file, "utf8");
         const lines = content.split("\n");
         for (let i = 0; i < lines.length; i++) {
           const lower = lines[i].toLowerCase();
@@ -3034,7 +3322,7 @@ function collectMarkdownFiles(dir) {
   const files = [];
   try {
     for (const entry of readdirSync2(dir)) {
-      const full = join15(dir, entry);
+      const full = join17(dir, entry);
       const stat = statSync(full);
       if (stat.isDirectory()) {
         files.push(...collectMarkdownFiles(full));
@@ -3046,7 +3334,7 @@ function collectMarkdownFiles(dir) {
   }
   return files;
 }
-function ok(text4, isError = false) {
+function ok2(text4, isError = false) {
   return { content: [{ type: "text", text: text4 }], isError };
 }
 function str(args, key) {
@@ -3085,12 +3373,12 @@ async function runServe(cwd2, opts) {
 
 // src/commands/status.ts
 import Table from "cli-table3";
-import pc9 from "picocolors";
+import pc10 from "picocolors";
 var STATUS_COLOR = {
-  pending: (s) => pc9.dim(s),
-  in_progress: (s) => pc9.cyan(s),
-  done: (s) => pc9.green(s),
-  blocked: (s) => pc9.red(s)
+  pending: (s) => pc10.dim(s),
+  in_progress: (s) => pc10.cyan(s),
+  done: (s) => pc10.green(s),
+  blocked: (s) => pc10.red(s)
 };
 async function runStatus(cwd2, opts) {
   const config = await loadConfig(cwd2);
@@ -3111,11 +3399,11 @@ async function runStatus(cwd2, opts) {
       return;
     }
     if (tasks.length === 0) {
-      console.log(pc9.dim("No tasks yet. Run: ahk task add"));
+      console.log(pc10.dim("No tasks yet. Run: ahk task add"));
       return;
     }
     const table = new Table({
-      head: ["ID", "Slug", "Title", "Status", "Assigned", "Started"].map((h) => pc9.bold(h)),
+      head: ["ID", "Slug", "Title", "Status", "Assigned", "Started"].map((h) => pc10.bold(h)),
       style: { head: [], border: [] }
     });
     for (const t of tasks) {
@@ -3133,12 +3421,12 @@ async function runStatus(cwd2, opts) {
     const inProgress = tasks.filter((t) => t.status === "in_progress");
     if (inProgress.length > 0) {
       console.log("");
-      console.log(pc9.bold("Active actions:"));
+      console.log(pc10.bold("Active actions:"));
       for (const t of inProgress) {
         const actions = await db.getActionsForTask(t.id);
         const active = actions.filter((a) => a.status === "in_progress");
         for (const a of active) {
-          console.log(`  ${pc9.cyan(a.agent.padEnd(10))} \u2192 task #${t.id} ${t.slug}`);
+          console.log(`  ${pc10.cyan(a.agent.padEnd(10))} \u2192 task #${t.id} ${t.slug}`);
         }
       }
     }
@@ -3147,10 +3435,10 @@ async function runStatus(cwd2, opts) {
       const fn = STATUS_COLOR[s.status] ?? ((x) => x);
       return `${fn(s.status)}: ${s.total}`;
     });
-    console.log(pc9.dim("Tasks \u2014 ") + parts.join(pc9.dim(" | ")));
+    console.log(pc10.dim("Tasks \u2014 ") + parts.join(pc10.dim(" | ")));
     const archivedTasks = await db.getArchivedTasks();
     if (archivedTasks.length > 0) {
-      console.log(pc9.dim(`${archivedTasks.length} archived (use \`ahk task list --archived\` to view)`));
+      console.log(pc10.dim(`${archivedTasks.length} archived (use \`ahk task list --archived\` to view)`));
     }
   } finally {
     await db.close();
@@ -3158,13 +3446,13 @@ async function runStatus(cwd2, opts) {
 }
 
 // src/commands/sync.ts
-import { existsSync as existsSync12, readFileSync as readFileSync9 } from "fs";
-import { join as join16, resolve as resolve11 } from "path";
-import pc10 from "picocolors";
+import { existsSync as existsSync13, readFileSync as readFileSync10 } from "fs";
+import { join as join18, resolve as resolve11 } from "path";
+import pc11 from "picocolors";
 async function runSync(cwd2, opts) {
   const config = await loadConfig(cwd2);
   const direction = opts.direction ?? "both";
-  const featureListPath = resolve11(join16(cwd2, config.storage.dir, "feature_list.json"));
+  const featureListPath = resolve11(join18(cwd2, config.storage.dir, "feature_list.json"));
   const db = await openDB(config, cwd2);
   try {
     if (direction === "in" || direction === "both") {
@@ -3178,44 +3466,44 @@ async function runSync(cwd2, opts) {
   }
 }
 async function syncIn(featureListPath, db, dryRun) {
-  if (!existsSync12(featureListPath)) {
-    console.log(pc10.dim(`feature_list.json not found at ${featureListPath} \u2014 skipping in-sync`));
+  if (!existsSync13(featureListPath)) {
+    console.log(pc11.dim(`feature_list.json not found at ${featureListPath} \u2014 skipping in-sync`));
     return;
   }
   let seeds;
   try {
-    seeds = JSON.parse(readFileSync9(featureListPath, "utf8"));
+    seeds = JSON.parse(readFileSync10(featureListPath, "utf8"));
   } catch (err) {
-    console.error(pc10.red(`Failed to parse feature_list.json: ${err}`));
+    console.error(pc11.red(`Failed to parse feature_list.json: ${err}`));
     process.exit(1);
   }
   if (dryRun) {
-    console.log(pc10.bold("Dry run \u2014 in-sync (feature_list.json \u2192 SQLite):"));
+    console.log(pc11.bold("Dry run \u2014 in-sync (feature_list.json \u2192 SQLite):"));
     for (const t of seeds) {
       const existing = await db.getTaskBySlug(t.slug);
-      console.log(`  ${existing ? pc10.dim("skip") : pc10.green("add ")} ${t.slug}`);
+      console.log(`  ${existing ? pc11.dim("skip") : pc11.green("add ")} ${t.slug}`);
     }
     return;
   }
   const result = await db.syncFromFeatureList(seeds);
-  console.log(pc10.green(`\u2713 In-sync: ${result.added} added, ${result.skipped} already existed`));
+  console.log(pc11.green(`\u2713 In-sync: ${result.added} added, ${result.skipped} already existed`));
 }
 async function syncOut(db, cwd2, dryRun) {
   if (dryRun) {
     const tasks = await db.getTasks();
-    console.log(pc10.bold("Dry run \u2014 out-sync (SQLite \u2192 feature_list.json):"));
+    console.log(pc11.bold("Dry run \u2014 out-sync (SQLite \u2192 feature_list.json):"));
     console.log(`  ${tasks.length} tasks would be written`);
     return;
   }
   await db.writeFeatureList(cwd2);
-  console.log(pc10.green("\u2713 Out-sync: feature_list.json updated"));
+  console.log(pc11.green("\u2713 Out-sync: feature_list.json updated"));
 }
 
 // src/commands/task/add.ts
 import * as p6 from "@clack/prompts";
-import pc11 from "picocolors";
+import pc12 from "picocolors";
 async function runTaskAdd(cwd2) {
-  p6.intro(pc11.bold("agent-harness-kit \u2014 add task"));
+  p6.intro(pc12.bold("agent-harness-kit \u2014 add task"));
   const title = await cliFormWithRetry(
     async () => {
       const val = await p6.text({ message: "Task title" });
@@ -3258,10 +3546,10 @@ async function runTaskAdd(cwd2) {
     await db.writeFeatureList(cwd2);
     await db.close();
     spinner6.stop("");
-    console.log(pc11.green(`\u2713 Task #${task2.id} added \u2014 ${task2.slug} (pending)`));
-    console.log(pc11.cyan("\u2192") + " " + pc11.cyan("ahk status") + " to see all tasks");
+    console.log(pc12.green(`\u2713 Task #${task2.id} added \u2014 ${task2.slug} (pending)`));
+    console.log(pc12.cyan("\u2192") + " " + pc12.cyan("ahk status") + " to see all tasks");
   } catch (err) {
-    spinner6.stop(pc11.red("Failed"));
+    spinner6.stop(pc12.red("Failed"));
     p6.log.error(err instanceof Error ? err.message : String(err));
     process.exit(1);
   }
@@ -3269,17 +3557,17 @@ async function runTaskAdd(cwd2) {
 
 // src/commands/task/done.ts
 import { spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync13 } from "fs";
+import { existsSync as existsSync14 } from "fs";
 import { resolve as resolve12 } from "path";
-import pc12 from "picocolors";
+import pc13 from "picocolors";
 async function runTaskDone(cwd2, idOrSlug) {
   const config = await loadConfig(cwd2);
   if (config.health.required) {
     const scriptPath = resolve12(cwd2, config.health.scriptPath);
-    if (existsSync13(scriptPath)) {
+    if (existsSync14(scriptPath)) {
       const result = spawnSync2("bash", [scriptPath], { cwd: cwd2, stdio: "pipe", encoding: "utf8" });
       if (result.status !== 0) {
-        console.error(pc12.red("\u2717 Health check failed \u2014 cannot mark task as done."));
+        console.error(pc13.red("\u2717 Health check failed \u2014 cannot mark task as done."));
         if (result.stdout) console.error(result.stdout);
         if (result.stderr) console.error(result.stderr);
         process.exit(1);
@@ -3292,16 +3580,16 @@ async function runTaskDone(cwd2, idOrSlug) {
     const isId = !isNaN(parsed);
     const task2 = isId ? await db.getTaskById(parsed) : await db.getTaskBySlug(idOrSlug);
     if (!task2) {
-      console.error(pc12.red(`Task not found: ${idOrSlug}`));
+      console.error(pc13.red(`Task not found: ${idOrSlug}`));
       process.exit(1);
     }
     if (task2.status === "done") {
-      console.log(pc12.dim(`Task #${task2.id} is already done.`));
+      console.log(pc13.dim(`Task #${task2.id} is already done.`));
       return;
     }
     await db.updateTaskStatus(task2.id, "done");
     await db.writeFeatureList(cwd2);
-    console.log(pc12.green(`\u2713 Task #${task2.id} \u2014 ${task2.slug} marked as done`));
+    console.log(pc13.green(`\u2713 Task #${task2.id} \u2014 ${task2.slug} marked as done`));
   } finally {
     await db.close();
   }
@@ -3309,9 +3597,9 @@ async function runTaskDone(cwd2, idOrSlug) {
 
 // src/commands/task/edit.ts
 import * as p7 from "@clack/prompts";
-import pc13 from "picocolors";
+import pc14 from "picocolors";
 async function runTaskEdit(cwd2) {
-  p7.intro(pc13.bold("agent-harness-kit \u2014 edit task"));
+  p7.intro(pc14.bold("agent-harness-kit \u2014 edit task"));
   const config = await loadConfig(cwd2);
   const db = await openDB(config, cwd2);
   try {
@@ -3389,9 +3677,9 @@ async function runTaskEdit(cwd2) {
       await db.updateTaskAcceptance(task2.id, newAcceptance);
       await db.writeFeatureList(cwd2);
       spinner6.stop("");
-      console.log(pc13.green(`\u2713 Task #${task2.id} updated \u2014 ${newSlug}`));
+      console.log(pc14.green(`\u2713 Task #${task2.id} updated \u2014 ${newSlug}`));
     } catch (err) {
-      spinner6.stop(pc13.red("Failed"));
+      spinner6.stop(pc14.red("Failed"));
       p7.log.error(err instanceof Error ? err.message : String(err));
       process.exit(1);
     }
@@ -3402,12 +3690,12 @@ async function runTaskEdit(cwd2) {
 
 // src/commands/task/list.ts
 import Table2 from "cli-table3";
-import pc14 from "picocolors";
+import pc15 from "picocolors";
 var STATUS_COLOR2 = {
-  pending: (s) => pc14.dim(s),
-  in_progress: (s) => pc14.cyan(s),
-  done: (s) => pc14.green(s),
-  blocked: (s) => pc14.red(s)
+  pending: (s) => pc15.dim(s),
+  in_progress: (s) => pc15.cyan(s),
+  done: (s) => pc15.green(s),
+  blocked: (s) => pc15.red(s)
 };
 async function runTaskList(cwd2, opts) {
   const config = await loadConfig(cwd2);
@@ -3424,11 +3712,11 @@ async function runTaskList(cwd2, opts) {
       let msg = "No tasks";
       if (filterStatus) msg += ` with status: ${filterStatus}`;
       if (opts.archived) msg += " (archived)";
-      console.log(pc14.dim(msg + "."));
+      console.log(pc15.dim(msg + "."));
       return;
     }
     const table = new Table2({
-      head: ["ID", "Slug", "Title", "Status"].map((h) => pc14.bold(h)),
+      head: ["ID", "Slug", "Title", "Status"].map((h) => pc15.bold(h)),
       style: { head: [], border: [] }
     });
     for (const t of tasks) {
@@ -3439,7 +3727,7 @@ async function runTaskList(cwd2, opts) {
     if (!opts.archived && !opts.includeArchived) {
       const archivedTasks = await db.getArchivedTasks();
       if (archivedTasks.length > 0) {
-        console.log(pc14.dim(`${archivedTasks.length} archived task${archivedTasks.length !== 1 ? "s" : ""} (use --archived to view)`));
+        console.log(pc15.dim(`${archivedTasks.length} archived task${archivedTasks.length !== 1 ? "s" : ""} (use --archived to view)`));
       }
     }
   } finally {
@@ -3447,25 +3735,17 @@ async function runTaskList(cwd2, opts) {
   }
 }
 
-// src/core/package-data.ts
-import { createRequire } from "module";
-import { dirname as dirname5, join as join17 } from "path";
-import { fileURLToPath as fileURLToPath3 } from "url";
-var require2 = createRequire(import.meta.url);
-var pkgPath = join17(dirname5(fileURLToPath3(import.meta.url)), "..", "package.json");
-var pkg = require2(pkgPath);
-
 // src/core/update-check.ts
-import pc15 from "picocolors";
-var REGISTRY_URL = `https://registry.npmjs.org/${pkg.name}/latest`;
-var TIMEOUT_MS = 2500;
+import pc16 from "picocolors";
+var REGISTRY_URL2 = `https://registry.npmjs.org/${pkg.name}/latest`;
+var TIMEOUT_MS2 = 2500;
 function checkForUpdate(currentVersion) {
   return new Promise((resolve13) => {
-    const timer = setTimeout(() => resolve13(null), TIMEOUT_MS);
-    fetch(REGISTRY_URL).then((res) => res.json()).then((data) => {
+    const timer = setTimeout(() => resolve13(null), TIMEOUT_MS2);
+    fetch(REGISTRY_URL2).then((res) => res.json()).then((data) => {
       clearTimeout(timer);
       const latest = data.version;
-      resolve13(isNewer(latest, currentVersion) ? { current: currentVersion, latest } : null);
+      resolve13(isNewer2(latest, currentVersion) ? { current: currentVersion, latest } : null);
     }).catch(() => {
       clearTimeout(timer);
       resolve13(null);
@@ -3474,12 +3754,12 @@ function checkForUpdate(currentVersion) {
 }
 function printUpdateMessage({ current, latest }) {
   const lines = [
-    `  Update available ${pc15.dim(current)} \u2192 ${pc15.green(latest)}  `,
-    `  Run: ${pc15.cyan(`pnpm i ${pkg.name}@${latest}`)}          `
+    `  Update available ${pc16.dim(current)} \u2192 ${pc16.green(latest)}  `,
+    `  Run: ${pc16.cyan(`pnpm i ${pkg.name}@${latest}`)}          `
   ];
   drawBox(lines);
 }
-function isNewer(latest, current) {
+function isNewer2(latest, current) {
   const toNum = (v4) => v4.split(".").map(Number);
   const [lMaj, lMin, lPat] = toNum(latest);
   const [cMaj, cMin, cPat] = toNum(current);
@@ -3536,6 +3816,9 @@ program.command("export").description("Export the database").option("--sql", "SQ
 program.command("reset").description("Reset/clear harness data (DB, feature list, agent files)").option("--force", "Skip confirmation prompts").option("--provider <claude-code|opencode>", "Reset agent MD files for specified provider").action(async (opts) => {
   await runReset(cwd, opts);
 });
+program.command("doctor").description("Check lib version, agent files, and harness skills sync status").action(async () => {
+  await runDoctor(cwd);
+});
 program.hook("postAction", async () => {
   const update = await updateCheck;
   if (update) printUpdateMessage(update);