infernoflow 0.33.0 → 0.34.0

package/dist/lib/commands/doctor.mjs

@@ -1,3 +1,321 @@
-import*as l from"node:fs";import*as c from"node:path";import*as $ from"node:os";import*as k from"node:http";import{execSync as O,spawnSync as N}from"node:child_process";import{bold as j,cyan as y,gray as x,green as g,yellow as C,red as S}from"../ui/output.mjs";import{detectAvailableProviders as b}from"../ai/providerRouter.mjs";function f(o,e){try{const t=e();return{label:o,...t}}catch(t){return{label:o,status:"error",message:t.message,fix:null}}}function a(o,e){return{status:"pass",message:o,detail:e||null,fix:null}}function u(o,e){return{status:"warn",message:o,detail:null,fix:e||null}}function m(o,e){return{status:"fail",message:o,detail:null,fix:e||null}}function v(){const o=process.version,e=parseInt(o.slice(1).split(".")[0],10);return e>=20?a(`Node.js ${o}`,"Node 20+ recommended"):e>=18?a(`Node.js ${o}`):m(`Node.js ${o} \u2014 infernoflow requires Node 18+`,"Install Node 20 from nodejs.org")}function A(){try{const o=N("infernoflow",["--version"],{encoding:"utf8",timeout:5e3,shell:!0});return o.status===0&&o.stdout.trim()?a(`infernoflow v${o.stdout.trim()} on PATH`):u("infernoflow not resolvable in subprocesses","Ensure npm global bin folder is in your PATH")}catch{return u("infernoflow not resolvable in subprocesses","Ensure npm global bin folder is in your PATH")}}function E(o){try{return O("git rev-parse --git-dir",{cwd:o,stdio:"ignore"}),a("Git repository detected")}catch{return m("Not a git repository","git init && git add . && git commit -m 'init'")}}function P(o){const e=c.join(o,"inferno");return l.existsSync(e)?a("inferno/ directory exists"):m("inferno/ not found","infernoflow init")}function I(o){const e=c.join(o,"inferno");for(const t of["contract.json","capabilities.json"]){const s=c.join(e,t);if(l.existsSync(s))try{const r=(JSON.parse(l.readFileSync(s,"utf8")).capabilities||[]).length;return a(`${t} valid \u2014 ${r} capabilities`)}catch{return m(`${t} contains invalid JSON`,`Fix the JSON syntax in inferno/${t}`)}}return m("No contract.json or capabilities.json","infernoflow init")}function G(o){const e=c.join(o,"inferno","scenarios");if(!l.existsSync(e))return u("No scenarios/ directory","infernoflow init");const t=l.readdirSync(e).filter(s=>s.endsWith(".json"));return t.length?a(`${t.length} scenario file${t.length!==1?"s":""} found`):u("scenarios/ is empty","Add scenario files or run infernoflow suggest")}function T(o){const e=c.join(o,"inferno","CHANGELOG.md");return l.existsSync(e)?a("inferno/CHANGELOG.md exists"):u("No inferno/CHANGELOG.md","infernoflow init")}function _(o){const e=c.join(o,"inferno","CONTEXT.md");if(!l.existsSync(e))return u("No CONTEXT.md generated","infernoflow context");const t=(Date.now()-l.statSync(e).mtimeMs)/(1e3*60*60*24);return t>7?u(`CONTEXT.md is ${Math.round(t)} days old \u2014 may be stale`,"infernoflow context"):a(`CONTEXT.md present (${Math.round(t)}d old)`)}function F(o){const e=c.join(o,".git","hooks"),t=c.join(e,"post-commit"),s=c.join(e,"pre-push"),i=l.existsSync(t)&&l.readFileSync(t,"utf8").includes("infernoflow"),r=l.existsSync(s)&&l.readFileSync(s,"utf8").includes("infernoflow");return i&&r?a("Git hooks installed (post-commit + pre-push)"):u(i||r?"Partial git hooks installed":"Git hooks not installed","infernoflow setup --yes")}function M(o){const e=[c.join(o,".cursor","mcp.json"),c.join(o,".mcp.json"),c.join($.homedir(),".cursor","mcp.json"),c.join($.homedir(),"Library","Application Support","Claude","claude_desktop_config.json"),c.join($.homedir(),"AppData","Roaming","Claude","claude_desktop_config.json")];for(const t of e)if(l.existsSync(t))try{const s=JSON.parse(l.readFileSync(t,"utf8")),i=s.mcpServers||s.mcp_servers||{};if(Object.keys(i).some(r=>r.toLowerCase().includes("inferno")))return a(`MCP server configured in ${c.basename(t)}`)}catch{}return u("MCP server not configured","infernoflow setup --yes   (adds to Cursor/Claude config)")}function D(o){const e=b(o),t=Object.entries(e).filter(([,s])=>s).map(([s])=>s);return t.length?a(`AI provider${t.length!==1?"s":""}: ${t.join(", ")}`):u("No AI provider configured",`Set ANTHROPIC_API_KEY, OPENAI_API_KEY, GOOGLE_AI_API_KEY, or OPENROUTER_API_KEY
-     Or install Ollama (ollama.com) for free local AI
-     Or use VS Code with GitHub Copilot (zero config)`)}async function H(){return new Promise(o=>{const e=k.get({hostname:"localhost",port:11434,path:"/api/tags",timeout:1500},t=>{o(a("Ollama running on localhost:11434"))});e.on("error",()=>o({status:"info",message:"Ollama not running (optional)",fix:"ollama serve",detail:null})),e.on("timeout",()=>{e.destroy(),o({status:"info",message:"Ollama not running (optional)",fix:null,detail:null})})})}function L(o){const e=c.join(o,"inferno","integrations.json");if(!l.existsSync(e))return{status:"info",message:"Cloud sync not configured (optional)",fix:"infernoflow cloud init",detail:null};try{return JSON.parse(l.readFileSync(e,"utf8")).cloud?.token?a("Cloud sync configured"):{status:"info",message:"Cloud sync not configured (optional)",fix:"infernoflow cloud init",detail:null}}catch{return{status:"info",message:"Cloud sync not configured (optional)",fix:null,detail:null}}}function R(o,e){const t=o.filter(i=>i.status==="warn"&&i.fix),s=[];for(const i of t){const r=i.fix;if(r.startsWith("infernoflow ")){const d=r.slice(12).split(" ");N("infernoflow",d,{cwd:e,encoding:"utf8",timeout:3e4}).status===0&&s.push(i.label)}}return s}function J(o){return o==="pass"?g("\u2714"):o==="warn"?C("\u26A0"):o==="fail"?S("\u2717"):x("\xB7")}function X(o,e){const t={pass:0,warn:0,fail:0,info:0,error:0};for(const n of o)t[n.status]=(t[n.status]||0)+1;console.log(),console.log(`  ${j("\u{1F525} infernoflow doctor")}`),console.log();const s=Math.max(...o.map(n=>n.label.length))+2;for(const n of o)console.log(`  ${J(n.status)}  ${j(n.label.padEnd(s))} ${n.message}`),n.detail&&console.log(`     ${" ".repeat(s)} ${x(n.detail)}`),n.fix&&(n.status==="warn"||n.status==="fail")&&console.log(`     ${" ".repeat(s)} ${y("fix:")} ${x(n.fix)}`);console.log();const i=t.fail>0?S("issues found"):t.warn>0?C("warnings"):g("all good");console.log(`  ${i}  \u2014  ${g(String(t.pass))} pass \xB7 ${C(String(t.warn))} warn \xB7 ${S(String(t.fail))} fail  (${e}ms)`),console.log();const r=[],d=o.filter(n=>n.status==="fail");for(const n of d)n.fix?r.push({priority:"\u{1F534}",text:n.fix}):r.push({priority:"\u{1F534}",text:`Fix: ${n.label} \u2014 ${n.message}`});const p=o.find(n=>n.label==="AI providers");p&&p.status!=="pass"&&r.push({priority:"\u{1F4A1}",text:`Connect an AI provider: ${y("infernoflow ai setup")}  (unlocks explain, why, review, changelog)`});const w=o.filter(n=>n.status==="warn"&&n.label!=="AI providers");for(const n of w)n.fix&&r.push({priority:"\u26A0\uFE0F ",text:n.fix});if(r.length>0){console.log(`  ${j("Next steps:")}`);for(const n of r)console.log(`    ${n.priority}  ${n.text}`);console.log(),w.length>0&&console.log(`  ${x("Auto-fix warnings:")}  ${y("infernoflow doctor --fix")}`),console.log()}else console.log(`  ${g("\u2713")}  You're all set. Run ${y("infernoflow demo")} to see the full capability chain.`),console.log()}async function Y(o){const e=o.slice(1),t=e.includes("--json"),s=e.includes("--fix"),i=process.cwd(),r=Date.now(),d=[f("Node.js version",()=>v()),f("infernoflow CLI",()=>A()),f("Git repository",()=>E(i)),f("inferno/ directory",()=>P(i)),f("Contract file",()=>I(i)),f("Scenarios",()=>G(i)),f("Changelog",()=>T(i)),f("CONTEXT.md",()=>_(i)),f("Git hooks",()=>F(i)),f("MCP server",()=>M(i)),f("AI providers",()=>D(i)),f("Cloud sync",()=>L(i)),await H().then(n=>({label:"Ollama (local AI)",...n}))],p=Date.now()-r;if(s){const n=R(d,i);if(n.length)return t||(console.log(),n.forEach(h=>console.log(`  ${g("\u2714")} Fixed: ${h}`)),console.log()),Y(["doctor","--json"])}if(t){const n={pass:0,warn:0,fail:0,info:0};d.forEach(h=>n[h.status]=(n[h.status]||0)+1),console.log(JSON.stringify({ok:n.fail===0,counts:n,results:d,elapsed:p}));return}X(d,p),d.some(n=>n.status==="fail")&&process.exit(1)}export{Y as doctorCommand};
+/**
+ * infernoflow doctor
+ *
+ * Comprehensive setup diagnostic — like `brew doctor`.
+ * Checks every component of the infernoflow setup and tells you
+ * exactly what's wrong and how to fix it.
+ *
+ * Usage:
+ *   infernoflow doctor         Print full diagnostic report
+ *   infernoflow doctor --fix   Auto-fix common issues
+ *   infernoflow doctor --json  Machine-readable output
+ */
+
+import * as fs        from "node:fs";
+import * as path      from "node:path";
+import * as os        from "node:os";
+import * as http      from "node:http";
+import { execSync, spawnSync } from "node:child_process";
+import { bold, cyan, gray, green, yellow, red } from "../ui/output.mjs";
+import { detectAvailableProviders } from "../ai/providerRouter.mjs";
+
+// ── Check runners ─────────────────────────────────────────────────────────────
+
+function check(label, fn) {
+  try {
+    const result = fn();
+    return { label, ...result };
+  } catch (err) {
+    return { label, status: "error", message: err.message, fix: null };
+  }
+}
+
+function pass(message, detail)  { return { status: "pass",  message, detail: detail || null, fix: null }; }
+function warn(message, fix)     { return { status: "warn",  message, detail: null, fix: fix || null }; }
+function fail(message, fix)     { return { status: "fail",  message, detail: null, fix: fix || null }; }
+
+// ── Individual checks ─────────────────────────────────────────────────────────
+
+function checkNodeVersion() {
+  const v     = process.version;
+  const major = parseInt(v.slice(1).split(".")[0], 10);
+  if (major >= 20) return pass(`Node.js ${v}`, "Node 20+ recommended");
+  if (major >= 18) return pass(`Node.js ${v}`);
+  return fail(`Node.js ${v} — infernoflow requires Node 18+`, "Install Node 20 from nodejs.org");
+}
+
+function checkCli() {
+  // Use shell: true so Windows .cmd wrappers resolve correctly.
+  // If the spawn fails entirely, we're still clearly running — downgrade to warn.
+  try {
+    const r = spawnSync("infernoflow", ["--version"], { encoding: "utf8", timeout: 5000, shell: true });
+    if (r.status === 0 && r.stdout.trim()) {
+      return pass(`infernoflow v${r.stdout.trim()} on PATH`);
+    }
+    // Running but PATH lookup failed for subprocesses (common on Windows)
+    return warn("infernoflow not resolvable in subprocesses", "Ensure npm global bin folder is in your PATH");
+  } catch {
+    return warn("infernoflow not resolvable in subprocesses", "Ensure npm global bin folder is in your PATH");
+  }
+}
+
+function checkGitRepo(cwd) {
+  try {
+    execSync("git rev-parse --git-dir", { cwd, stdio: "ignore" });
+    return pass("Git repository detected");
+  } catch {
+    return fail("Not a git repository", "git init && git add . && git commit -m 'init'");
+  }
+}
+
+function checkInfernoDir(cwd) {
+  const infernoDir = path.join(cwd, "inferno");
+  if (!fs.existsSync(infernoDir)) return fail("inferno/ not found", "infernoflow init");
+  return pass("inferno/ directory exists");
+}
+
+function checkContract(cwd) {
+  const infernoDir = path.join(cwd, "inferno");
+  for (const f of ["contract.json", "capabilities.json"]) {
+    const p = path.join(infernoDir, f);
+    if (!fs.existsSync(p)) continue;
+    try {
+      const data = JSON.parse(fs.readFileSync(p, "utf8"));
+      const caps = (data.capabilities || []).length;
+      return pass(`${f} valid — ${caps} capabilities`);
+    } catch {
+      return fail(`${f} contains invalid JSON`, `Fix the JSON syntax in inferno/${f}`);
+    }
+  }
+  return fail("No contract.json or capabilities.json", "infernoflow init");
+}
+
+function checkScenarios(cwd) {
+  const scenDir = path.join(cwd, "inferno", "scenarios");
+  if (!fs.existsSync(scenDir)) return warn("No scenarios/ directory", "infernoflow init");
+  const files = fs.readdirSync(scenDir).filter(f => f.endsWith(".json"));
+  if (!files.length) return warn("scenarios/ is empty", "Add scenario files or run infernoflow suggest");
+  return pass(`${files.length} scenario file${files.length !== 1 ? "s" : ""} found`);
+}
+
+function checkChangelog(cwd) {
+  const p = path.join(cwd, "inferno", "CHANGELOG.md");
+  if (!fs.existsSync(p)) return warn("No inferno/CHANGELOG.md", "infernoflow init");
+  return pass("inferno/CHANGELOG.md exists");
+}
+
+function checkContextMd(cwd) {
+  const p = path.join(cwd, "inferno", "CONTEXT.md");
+  if (!fs.existsSync(p)) return warn("No CONTEXT.md generated", "infernoflow context");
+  const age = (Date.now() - fs.statSync(p).mtimeMs) / (1000 * 60 * 60 * 24);
+  if (age > 7) return warn(`CONTEXT.md is ${Math.round(age)} days old — may be stale`, "infernoflow context");
+  return pass(`CONTEXT.md present (${Math.round(age)}d old)`);
+}
+
+function checkGitHooks(cwd) {
+  const hooksDir  = path.join(cwd, ".git", "hooks");
+  const postCommit = path.join(hooksDir, "post-commit");
+  const prePush    = path.join(hooksDir, "pre-push");
+  const hasPost    = fs.existsSync(postCommit) && fs.readFileSync(postCommit, "utf8").includes("infernoflow");
+  const hasPre     = fs.existsSync(prePush)    && fs.readFileSync(prePush, "utf8").includes("infernoflow");
+  if (hasPost && hasPre) return pass("Git hooks installed (post-commit + pre-push)");
+  if (hasPost || hasPre) return warn("Partial git hooks installed", "infernoflow setup --yes");
+  return warn("Git hooks not installed", "infernoflow setup --yes");
+}
+
+function checkMcp(cwd) {
+  // Check for MCP server in cursor config or .mcp.json
+  const checks = [
+    path.join(cwd, ".cursor", "mcp.json"),
+    path.join(cwd, ".mcp.json"),
+    path.join(os.homedir(), ".cursor", "mcp.json"),
+    path.join(os.homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json"),
+    path.join(os.homedir(), "AppData", "Roaming", "Claude", "claude_desktop_config.json"),
+  ];
+  for (const p of checks) {
+    if (!fs.existsSync(p)) continue;
+    try {
+      const data = JSON.parse(fs.readFileSync(p, "utf8"));
+      const servers = data.mcpServers || data.mcp_servers || {};
+      if (Object.keys(servers).some(k => k.toLowerCase().includes("inferno"))) {
+        return pass(`MCP server configured in ${path.basename(p)}`);
+      }
+    } catch {}
+  }
+  return warn("MCP server not configured", "infernoflow setup --yes   (adds to Cursor/Claude config)");
+}
+
+function checkAiProviders(cwd) {
+  const providers = detectAvailableProviders(cwd);
+  const available = Object.entries(providers).filter(([, v]) => v).map(([k]) => k);
+
+  if (available.length) return pass(`AI provider${available.length !== 1 ? "s" : ""}: ${available.join(", ")}`);
+
+  return warn(
+    "No AI provider configured",
+    "Set ANTHROPIC_API_KEY, OPENAI_API_KEY, GOOGLE_AI_API_KEY, or OPENROUTER_API_KEY\n" +
+    "     Or install Ollama (ollama.com) for free local AI\n" +
+    "     Or use VS Code with GitHub Copilot (zero config)"
+  );
+}
+
+async function checkOllama() {
+  return new Promise(resolve => {
+    const req = http.get({ hostname: "localhost", port: 11434, path: "/api/tags", timeout: 1500 }, res => {
+      resolve(pass("Ollama running on localhost:11434"));
+    });
+    req.on("error", () => resolve({ status: "info", message: "Ollama not running (optional)", fix: "ollama serve", detail: null }));
+    req.on("timeout", () => { req.destroy(); resolve({ status: "info", message: "Ollama not running (optional)", fix: null, detail: null }); });
+  });
+}
+
+function checkCloudToken(cwd) {
+  const p = path.join(cwd, "inferno", "integrations.json");
+  if (!fs.existsSync(p)) return { status: "info", message: "Cloud sync not configured (optional)", fix: "infernoflow cloud init", detail: null };
+  try {
+    const data = JSON.parse(fs.readFileSync(p, "utf8"));
+    if (data.cloud?.token) return pass("Cloud sync configured");
+    return { status: "info", message: "Cloud sync not configured (optional)", fix: "infernoflow cloud init", detail: null };
+  } catch {
+    return { status: "info", message: "Cloud sync not configured (optional)", fix: null, detail: null };
+  }
+}
+
+// ── Auto-fix ──────────────────────────────────────────────────────────────────
+
+function autoFix(results, cwd) {
+  const fixable = results.filter(r => r.status === "warn" && r.fix);
+  const fixed   = [];
+
+  for (const r of fixable) {
+    const fix = r.fix;
+    if (fix.startsWith("infernoflow ")) {
+      const args = fix.slice("infernoflow ".length).split(" ");
+      const res  = spawnSync("infernoflow", args, { cwd, encoding: "utf8", timeout: 30_000 });
+      if (res.status === 0) fixed.push(r.label);
+    }
+  }
+  return fixed;
+}
+
+// ── Renderer ──────────────────────────────────────────────────────────────────
+
+function icon(status) {
+  if (status === "pass") return green("✔");
+  if (status === "warn") return yellow("⚠");
+  if (status === "fail") return red("✗");
+  return gray("·");
+}
+
+function printReport(results, elapsed) {
+  const counts = { pass: 0, warn: 0, fail: 0, info: 0, error: 0 };
+  for (const r of results) counts[r.status] = (counts[r.status] || 0) + 1;
+
+  console.log();
+  console.log(`  ${bold("🔥 infernoflow doctor")}`);
+  console.log();
+
+  const w = Math.max(...results.map(r => r.label.length)) + 2;
+  for (const r of results) {
+    console.log(`  ${icon(r.status)}  ${bold(r.label.padEnd(w))} ${r.message}`);
+    if (r.detail) console.log(`     ${" ".repeat(w)} ${gray(r.detail)}`);
+    if (r.fix && (r.status === "warn" || r.status === "fail")) {
+      console.log(`     ${" ".repeat(w)} ${cyan("fix:")} ${gray(r.fix)}`);
+    }
+  }
+
+  console.log();
+  const overall = counts.fail > 0 ? red("issues found") : counts.warn > 0 ? yellow("warnings") : green("all good");
+  console.log(`  ${overall}  —  ${green(String(counts.pass))} pass · ${yellow(String(counts.warn))} warn · ${red(String(counts.fail))} fail  (${elapsed}ms)`);
+  console.log();
+
+  // Prioritized action list — show concrete next steps, not just status flags
+  const actions = [];
+
+  // Failures first
+  const fails = results.filter(r => r.status === "fail");
+  for (const f of fails) {
+    if (f.fix) actions.push({ priority: "🔴", text: f.fix });
+    else       actions.push({ priority: "🔴", text: `Fix: ${f.label} — ${f.message}` });
+  }
+
+  // AI provider — very common gap, elevate it
+  const aiCheck = results.find(r => r.label === "AI providers");
+  if (aiCheck && aiCheck.status !== "pass") {
+    actions.push({ priority: "💡", text: `Connect an AI provider: ${cyan("infernoflow ai setup")}  (unlocks explain, why, review, changelog)` });
+  }
+
+  // Warnings
+  const warns = results.filter(r => r.status === "warn" && r.label !== "AI providers");
+  for (const w of warns) {
+    if (w.fix) actions.push({ priority: "⚠️ ", text: w.fix });
+  }
+
+  if (actions.length > 0) {
+    console.log(`  ${bold("Next steps:")}`);
+    for (const a of actions) {
+      console.log(`    ${a.priority}  ${a.text}`);
+    }
+    console.log();
+    if (warns.length > 0) {
+      console.log(`  ${gray("Auto-fix warnings:")}  ${cyan("infernoflow doctor --fix")}`);
+    }
+    console.log();
+  } else {
+    console.log(`  ${green("✓")}  You're all set. Run ${cyan("infernoflow demo")} to see the full capability chain.`);
+    console.log();
+  }
+}
+
+// ── Entry ─────────────────────────────────────────────────────────────────────
+
+export async function doctorCommand(rawArgs) {
+  const args     = rawArgs.slice(1);
+  const jsonMode = args.includes("--json");
+  const fixMode  = args.includes("--fix");
+  const cwd      = process.cwd();
+  const start    = Date.now();
+
+  const results = [
+    check("Node.js version",   () => checkNodeVersion()),
+    check("infernoflow CLI",   () => checkCli()),
+    check("Git repository",    () => checkGitRepo(cwd)),
+    check("inferno/ directory",() => checkInfernoDir(cwd)),
+    check("Contract file",     () => checkContract(cwd)),
+    check("Scenarios",         () => checkScenarios(cwd)),
+    check("Changelog",         () => checkChangelog(cwd)),
+    check("CONTEXT.md",        () => checkContextMd(cwd)),
+    check("Git hooks",         () => checkGitHooks(cwd)),
+    check("MCP server",        () => checkMcp(cwd)),
+    check("AI providers",      () => checkAiProviders(cwd)),
+    check("Cloud sync",        () => checkCloudToken(cwd)),
+    await checkOllama().then(r => ({ label: "Ollama (local AI)", ...r })),
+  ];
+
+  const elapsed = Date.now() - start;
+
+  if (fixMode) {
+    const fixed = autoFix(results, cwd);
+    if (fixed.length) {
+      if (!jsonMode) {
+        console.log();
+        fixed.forEach(f => console.log(`  ${green("✔")} Fixed: ${f}`));
+        console.log();
+      }
+      // Re-run checks after fixing
+      return doctorCommand(["doctor", "--json"]);
+    }
+  }
+
+  if (jsonMode) {
+    const counts = { pass: 0, warn: 0, fail: 0, info: 0 };
+    results.forEach(r => counts[r.status] = (counts[r.status] || 0) + 1);
+    console.log(JSON.stringify({ ok: counts.fail === 0, counts, results, elapsed }));
+    return;
+  }
+
+  printReport(results, elapsed);
+
+  const hasFail = results.some(r => r.status === "fail");
+  if (hasFail) process.exit(1);
+}