infernoflow 0.32.8 → 0.32.9

package/dist/lib/commands/explain.mjs

@@ -1,438 +1,8 @@
-/**
- * infernoflow explain
- *
- * AI-generated narrative about a capability — what it does, why it exists,
- * what's risky about it, and what to test before changing it.
- *
- * Synthesises: stability level, git history, scenarios, callers, services,
- * source files — then calls the AI provider for a 3-5 sentence human narrative.
- *
- * Usage:
- *   infernoflow explain user-auth
- *   infernoflow explain payment-process --dry-run    (print prompt only)
- *   infernoflow explain user-auth --json
- */
-
-import * as fs      from "node:fs";
-import * as path    from "node:path";
-import { execSync } from "node:child_process";
-import { bold, cyan, gray, green, yellow, red } from "../ui/output.mjs";
-
-// ── helpers ───────────────────────────────────────────────────────────────────
-
-function loadJson(p) {
-  try { return JSON.parse(fs.readFileSync(p, "utf8")); }
-  catch { return null; }
-}
-
-function runGit(cmd, cwd) {
-  try {
-    return execSync(cmd, { cwd, encoding: "utf8", stdio: ["pipe","pipe","pipe"] }).trim();
-  } catch { return ""; }
-}
-
-const LEVEL_ICON  = { frozen: "🧊", stable: "〰️ ", experimental: "🌊" };
-const LEVEL_COLOR = { frozen: red, stable: yellow, experimental: green };
-
-function stability(cap) { return cap?.stability || "experimental"; }
-
-// ── git helpers ───────────────────────────────────────────────────────────────
-
-function getFirstCommit(filePath, cwd) {
-  if (!filePath) return null;
-  const rel = path.relative(cwd, path.resolve(cwd, filePath));
-  const log = runGit(
-    `git log --follow --format="%h|%aI|%ae|%s" -- ${JSON.stringify(rel)}`, cwd
-  );
-  if (!log) return null;
-  const lines = log.split("\n").filter(Boolean);
-  if (!lines.length) return null;
-  const [hash, date, author, ...subjectParts] = lines[lines.length - 1].split("|");
-  return {
-    hash:    hash?.trim(),
-    date:    date?.trim() ? new Date(date.trim()).toLocaleDateString() : "",
-    author:  author?.trim(),
-    subject: subjectParts.join("|").trim(),
-  };
-}
-
-function getRecentHistory(filePath, cwd, limit = 5) {
-  if (!filePath) return [];
-  const rel = path.relative(cwd, path.resolve(cwd, filePath));
-  const log = runGit(
-    `git log --follow --format="%h|%aI|%ae|%s" -${limit} -- ${JSON.stringify(rel)}`, cwd
-  );
-  if (!log) return [];
-  return log.split("\n").filter(Boolean).map(line => {
-    const [hash, date, author, ...subjectParts] = line.split("|");
-    return {
-      hash:    hash?.trim(),
-      date:    date?.trim() ? new Date(date.trim()).toLocaleDateString() : "",
-      author:  author?.trim(),
-      subject: subjectParts.join("|").trim(),
-    };
-  });
-}
-
-// ── scenario finder ───────────────────────────────────────────────────────────
-
-function findScenarios(capId, infernoDir) {
-  const dir = path.join(infernoDir, "scenarios");
-  if (!fs.existsSync(dir)) return [];
-  const found = [];
-  for (const f of fs.readdirSync(dir)) {
-    if (!f.endsWith(".json")) continue;
-    try {
-      const s = JSON.parse(fs.readFileSync(path.join(dir, f), "utf8"));
-      const covered = s.capabilitiesCovered || s.capabilities || [];
-      if (covered.some(c => c.toLowerCase() === capId.toLowerCase())) {
-        found.push(s);
-      }
-    } catch {}
-  }
-  return found;
-}
-
-// ── prompt builder ────────────────────────────────────────────────────────────
-
-function buildPrompt(capId, cap, scanEntry, graph, allCaps, scenarios, firstCommit, recentHistory) {
-  const level      = stability(cap);
-  const files      = scanEntry?.codeAnalysis?.sourceFiles   || [];
-  const functions  = scanEntry?.codeAnalysis?.functions     || [];
-  const services   = scanEntry?.codeAnalysis?.services      || [];
-  const throws_    = scanEntry?.codeAnalysis?.throws        || [];
-  const calls      = scanEntry?.codeAnalysis?.calls         || [];
-  const deps       = graph?.deps?.[capId]       || [];
-  const dependents = graph?.dependents?.[capId] || [];
-
-  const lines = [
-    `You are a senior engineer writing a brief, plain-English explanation of a software capability for a teammate who is about to modify it.`,
-    ``,
-    `Write 3–5 sentences covering:`,
-    `  1. What this capability does and why it exists`,
-    `  2. The most important thing to know before changing it (stability, callers, risk)`,
-    `  3. What to test or verify after any modification`,
-    ``,
-    `Be concrete and direct. Do not use bullet points. Do not repeat the capability ID verbatim in every sentence.`,
-    ``,
-    `=== Capability: ${capId} ===`,
-    `Name:        ${cap.name || cap.title || capId}`,
-    `Description: ${cap.description || "(none provided)"}`,
-    `Stability:   ${level}`,
-  ];
-
-  if (files.length)     lines.push(`Source files: ${files.join(", ")}`);
-  if (functions.length) lines.push(`Functions:    ${functions.join(", ")}`);
-  if (services.length)  lines.push(`External services used: ${services.join(", ")}`);
-  if (throws_.length)   lines.push(`Can throw: ${throws_.join(", ")}`);
-  if (calls.length)     lines.push(`Internal calls: ${calls.join(", ")}`);
-
-  if (deps.length) {
-    const depDetails = deps.map(d => {
-      const dc = allCaps.find(c => c.id === d);
-      return `${d} (${stability(dc)})`;
-    });
-    lines.push(`Calls capabilities: ${depDetails.join(", ")}`);
-  }
-
-  if (dependents.length) {
-    const depDetails = dependents.map(d => {
-      const dc = allCaps.find(c => c.id === d);
-      return `${d} (${stability(dc)})`;
-    });
-    lines.push(`Called by capabilities: ${depDetails.join(", ")}`);
-  }
-
-  if (scenarios.length) {
-    lines.push(`Test scenarios: ${scenarios.map(s => s.scenarioId || s.description || "unnamed").join(", ")}`);
-  } else {
-    lines.push(`Test scenarios: none registered`);
-  }
-
-  if (firstCommit) {
-    lines.push(`First introduced: ${firstCommit.date} by ${firstCommit.author} — "${firstCommit.subject}"`);
-  }
-
-  if (recentHistory.length) {
-    lines.push(`Recent changes:`);
-    for (const h of recentHistory.slice(0, 3)) {
-      lines.push(`  ${h.date} — ${h.subject}`);
-    }
-  }
-
-  if (level === "frozen") {
-    lines.push(`IMPORTANT: This capability is FROZEN. Any modification requires explicit approval.`);
-  } else if (level === "stable") {
-    lines.push(`NOTE: This capability is STABLE. Prefer additive changes; avoid breaking the public API.`);
-  }
-
-  return lines.join("\n");
-}
-
-// ── AI caller ─────────────────────────────────────────────────────────────────
-
-async function callAI(prompt, cwd) {
-  try {
-    const { callAI: call } = await import("../ai/providerRouter.mjs");
-    return await call(prompt, cwd);
-  } catch {
-    // Provider not available — return a structured fallback
-    return null;
-  }
-}
-
-// ── fallback narrative (no AI) ────────────────────────────────────────────────
-
-function buildFallback(capId, cap, scanEntry, graph, allCaps, scenarios) {
-  const level      = stability(cap);
-  const name       = cap.name || cap.title || capId;
-  const services   = scanEntry?.codeAnalysis?.services || [];
-  const dependents = graph?.dependents?.[capId] || [];
-  const deps       = graph?.deps?.[capId]       || [];
-
-  const parts = [];
-
-  // What it does
-  if (cap.description && cap.description !== "(none provided)") {
-    parts.push(`${name} — ${cap.description}.`);
-  } else {
-    parts.push(`${name} handles the ${capId} flow within this system.`);
-  }
-
-  // External services
-  if (services.length) {
-    parts.push(`It integrates with ${services.join(" and ")}.`);
-  }
-
-  // Dependencies
-  if (deps.length) {
-    parts.push(`It depends on: ${deps.join(", ")}.`);
-  }
-  if (dependents.length) {
-    const frozenDeps = dependents.filter(d => stability(allCaps.find(c => c.id === d)) === "frozen");
-    if (frozenDeps.length) {
-      parts.push(`⚠️  ${frozenDeps.join(", ")} depend${frozenDeps.length === 1 ? "s" : ""} on this — changing it may break frozen capabilities.`);
-    } else {
-      parts.push(`${dependents.join(", ")} depend${dependents.length === 1 ? "s" : ""} on this capability.`);
-    }
-  }
-
-  // Stability advice
-  if (level === "frozen") {
-    parts.push(`This capability is FROZEN — do not modify without explicit instruction.`);
-  } else if (level === "stable") {
-    parts.push(`This capability is stable — prefer additive changes and avoid breaking the existing API surface.`);
-  } else {
-    parts.push(`This capability is experimental — free to refactor as needed.`);
-  }
-
-  // Test advice
-  if (scenarios.length) {
-    parts.push(`Before shipping changes, run the registered scenarios: ${scenarios.map(s => s.scenarioId || "unnamed").join(", ")}.`);
-  } else {
-    parts.push(`No test scenarios are registered — consider adding one before making changes.`);
-  }
-
-  return parts.join(" ");
-}
-
-// ── printer ───────────────────────────────────────────────────────────────────
-
-function printExplain(capId, cap, narrative, provider, dryRun) {
-  const level = stability(cap);
-  const icon  = LEVEL_ICON[level]  || "🌊";
-  const color = LEVEL_COLOR[level] || green;
-
-  console.log();
-  console.log(bold(`  ${icon} ${color(capId)}`));
-  if (cap.name || cap.title) console.log(gray(`     ${cap.name || cap.title}`));
-  console.log();
-
-  if (dryRun) {
-    console.log(yellow("  [dry-run] Prompt only — no AI call made"));
-    console.log();
-    return;
-  }
-
-  // Word-wrap narrative at ~80 chars
-  const words  = narrative.split(" ");
-  let   line   = "  ";
-  const lines  = [];
-  for (const word of words) {
-    if (line.length + word.length > 82) { lines.push(line); line = "  " + word; }
-    else line += (line === "  " ? "" : " ") + word;
-  }
-  if (line.trim()) lines.push(line);
-
-  for (const l of lines) console.log(l);
-  console.log();
-
-  if (provider) {
-    console.log(gray(`  ── via ${provider}`));
-  } else {
-    console.log(gray("  ── structural summary (no AI provider configured)"));
-    console.log(`  ${yellow("💡")} ${gray("For richer AI narratives:")}  ${cyan("infernoflow ai setup")}`);
-  }
-  console.log();
-}
-
-// ── entry point ───────────────────────────────────────────────────────────────
-
-export async function explainCommand(rawArgs) {
-  const args    = (rawArgs || []).slice(1);
-  const dryRun  = args.includes("--dry-run");
-  const jsonMode = args.includes("--json");
-
-  const arg = args.find(a => !a.startsWith("--"));
-
-  if (!arg) {
-    console.error(red("✗ Usage: infernoflow explain <capability-id|file-path> [--dry-run] [--json]"));
-    console.error(gray("  Examples:"));
-    console.error(gray("    infernoflow explain CreateTask"));
-    console.error(gray("    infernoflow explain src/components/TaskComposer.jsx"));
-    process.exit(1);
-  }
-
-  const cwd        = process.cwd();
-  const infernoDir = path.join(cwd, "inferno");
-
-  // Load capabilities
-  let allCaps = [];
-  const rawCaps = loadJson(path.join(infernoDir, "capabilities.json"));
-  if (rawCaps) allCaps = Array.isArray(rawCaps) ? rawCaps : (rawCaps.capabilities || []);
-
-  // Detect if arg is a file path and resolve to capability IDs
-  const isFilePath = arg.includes("/") || arg.includes("\\") || /\.\w+$/.test(arg);
-
-  let capIdsToExplain = [];
-
-  if (isFilePath) {
-    // Look up which capabilities are mapped to this file via scan.json
-    const scanData = loadJson(path.join(infernoDir, "scan.json"));
-    const scanCaps = scanData?.capabilities || [];
-    const relTarget = path.relative(cwd, path.resolve(cwd, arg));
-
-    for (const entry of scanCaps) {
-      const sourceFiles = entry.codeAnalysis?.sourceFiles || [];
-      const matched = sourceFiles.some(f =>
-        f === relTarget || f.endsWith(relTarget) || relTarget.endsWith(f)
-      );
-      if (matched) capIdsToExplain.push(entry.id);
-    }
-
-    if (capIdsToExplain.length === 0) {
-      // scan.json may not exist yet — try capability-map.json
-      const capMap = loadJson(path.join(infernoDir, "capability-map.json"));
-      if (capMap) {
-        const relNorm = relTarget.replace(/\\/g, "/");
-        for (const [capId, files] of Object.entries(capMap)) {
-          const fileList = Array.isArray(files) ? files : [files];
-          if (fileList.some(f => f === relNorm || f.endsWith(relNorm) || relNorm.endsWith(f))) {
-            capIdsToExplain.push(capId);
-          }
-        }
-      }
-    }
-
-    if (capIdsToExplain.length === 0) {
-      console.error(red(`✗ No capabilities found mapped to "${arg}"`));
-      console.error(gray("  Run: infernoflow scan — to build the source-file → capability map"));
-      console.error(gray("  Then retry: infernoflow explain " + arg));
-      process.exit(1);
-    }
-
-    if (!jsonMode) {
-      console.log(gray(`\n  infernoflow explain  →  ${bold(arg)}`));
-      console.log(gray(`  Found ${capIdsToExplain.length} mapped ${capIdsToExplain.length > 1 ? "capabilities" : "capability"}: ${capIdsToExplain.join(", ")}`));
-      console.log();
-    }
-  } else {
-    capIdsToExplain = [arg];
-  }
-
-  // Explain each capability
-  const jsonResults = [];
-  for (const capId of capIdsToExplain) {
-    const cap = allCaps.find(c => c.id === capId);
-    if (!cap) {
-      if (!jsonMode) {
-        console.error(red(`✗ Capability "${capId}" not found in capabilities.json`));
-        console.error(gray("  Run: infernoflow stability — to list all capability IDs"));
-      }
-      continue;
-    }
-
-    // Load scan + graph for this cap
-    const scanData  = loadJson(path.join(infernoDir, "scan.json"));
-    const graph     = loadJson(path.join(infernoDir, "graph.json"));
-    const scanEntry = scanData?.capabilities?.find(c => c.id === capId);
-
-    // Git history
-    const files          = scanEntry?.codeAnalysis?.sourceFiles || [];
-    const firstCommit    = getFirstCommit(files[0], cwd);
-    const recentHistory  = getRecentHistory(files[0], cwd);
-
-    // Scenarios
-    const scenarios = findScenarios(capId, infernoDir);
-
-    // Build prompt
-    const prompt = buildPrompt(capId, cap, scanEntry, graph, allCaps, scenarios, firstCommit, recentHistory);
-
-    if (dryRun && !jsonMode) {
-      console.log(gray(`  ── ${bold(capId)} ──────────────────────────────────────────────────────`));
-      printExplain(capId, cap, "", null, true);
-      if (capIdsToExplain.length === 1) {
-        console.log(bold("  Prompt that would be sent to AI:"));
-        console.log();
-        console.log(prompt.split("\n").map(l => "    " + l).join("\n"));
-      }
-      console.log();
-      continue;
-    }
-
-    // Call AI
-    let narrative = null;
-    let provider  = null;
-
-    if (!dryRun) {
-      try {
-        const result = await callAI(prompt, cwd);
-        if (result?.text) {
-          narrative = result.text.trim();
-          provider  = result.provider;
-        }
-      } catch {}
-    }
-
-    if (!narrative) {
-      narrative = buildFallback(capId, cap, scanEntry, graph, allCaps, scenarios);
-      provider  = null;
-    }
-
-    if (jsonMode) {
-      jsonResults.push({
-        capId,
-        name:      cap.name || cap.title,
-        stability: stability(cap),
-        narrative,
-        provider:  provider || "fallback",
-        sourceFiles: files,
-        scenarios:   scenarios.map(s => s.scenarioId || s.description),
-        firstCommit,
-      });
-    } else {
-      if (!isFilePath) {
-        console.log(gray(`\n  infernoflow explain  →  ${bold(capId)}`));
-        console.log(gray("  ──────────────────────────────────────────────────────────────"));
-      }
-      printExplain(capId, cap, narrative, provider, false);
-    }
-  }
-
-  if (jsonMode) {
-    const out = capIdsToExplain.length === 1 ? jsonResults[0] : jsonResults;
-    console.log(JSON.stringify(out, null, 2));
-    return;
-  }
-
-}
+import*as S from"node:fs";import*as b from"node:path";import{execSync as R}from"node:child_process";import{bold as I,cyan as W,gray as y,green as L,yellow as N,red as C}from"../ui/output.mjs";function T(n){try{return JSON.parse(S.readFileSync(n,"utf8"))}catch{return null}}function k(n,e){try{return R(n,{cwd:e,encoding:"utf8",stdio:["pipe","pipe","pipe"]}).trim()}catch{return""}}const P={frozen:"\u{1F9CA}",stable:"\u3030\uFE0F ",experimental:"\u{1F30A}"},z={frozen:C,stable:N,experimental:L};function x(n){return n?.stability||"experimental"}function J(n,e){if(!n)return null;const l=b.relative(e,b.resolve(e,n)),a=k(`git log --follow --format="%h|%aI|%ae|%s" -- ${JSON.stringify(l)}`,e);if(!a)return null;const i=a.split(`
+`).filter(Boolean);if(!i.length)return null;const[r,c,u,...d]=i[i.length-1].split("|");return{hash:r?.trim(),date:c?.trim()?new Date(c.trim()).toLocaleDateString():"",author:u?.trim(),subject:d.join("|").trim()}}function B(n,e,l=5){if(!n)return[];const a=b.relative(e,b.resolve(e,n)),i=k(`git log --follow --format="%h|%aI|%ae|%s" -${l} -- ${JSON.stringify(a)}`,e);return i?i.split(`
+`).filter(Boolean).map(r=>{const[c,u,d,...p]=r.split("|");return{hash:c?.trim(),date:u?.trim()?new Date(u.trim()).toLocaleDateString():"",author:d?.trim(),subject:p.join("|").trim()}}):[]}function M(n,e){const l=b.join(e,"scenarios");if(!S.existsSync(l))return[];const a=[];for(const i of S.readdirSync(l))if(i.endsWith(".json"))try{const r=JSON.parse(S.readFileSync(b.join(l,i),"utf8"));(r.capabilitiesCovered||r.capabilities||[]).some(u=>u.toLowerCase()===n.toLowerCase())&&a.push(r)}catch{}return a}function _(n,e,l,a,i,r,c,u){const d=x(e),p=l?.codeAnalysis?.sourceFiles||[],f=l?.codeAnalysis?.functions||[],o=l?.codeAnalysis?.services||[],t=l?.codeAnalysis?.throws||[],m=l?.codeAnalysis?.calls||[],j=a?.deps?.[n]||[],v=a?.dependents?.[n]||[],s=["You are a senior engineer writing a brief, plain-English explanation of a software capability for a teammate who is about to modify it.","","Write 3\u20135 sentences covering:","  1. What this capability does and why it exists","  2. The most important thing to know before changing it (stability, callers, risk)","  3. What to test or verify after any modification","","Be concrete and direct. Do not use bullet points. Do not repeat the capability ID verbatim in every sentence.","",`=== Capability: ${n} ===`,`Name:        ${e.name||e.title||n}`,`Description: ${e.description||"(none provided)"}`,`Stability:   ${d}`];if(p.length&&s.push(`Source files: ${p.join(", ")}`),f.length&&s.push(`Functions:    ${f.join(", ")}`),o.length&&s.push(`External services used: ${o.join(", ")}`),t.length&&s.push(`Can throw: ${t.join(", ")}`),m.length&&s.push(`Internal calls: ${m.join(", ")}`),j.length){const h=j.map(g=>{const A=i.find(w=>w.id===g);return`${g} (${x(A)})`});s.push(`Calls capabilities: ${h.join(", ")}`)}if(v.length){const h=v.map(g=>{const A=i.find(w=>w.id===g);return`${g} (${x(A)})`});s.push(`Called by capabilities: ${h.join(", ")}`)}if(r.length?s.push(`Test scenarios: ${r.map(h=>h.scenarioId||h.description||"unnamed").join(", ")}`):s.push("Test scenarios: none registered"),c&&s.push(`First introduced: ${c.date} by ${c.author} \u2014 "${c.subject}"`),u.length){s.push("Recent changes:");for(const h of u.slice(0,3))s.push(`  ${h.date} \u2014 ${h.subject}`)}return d==="frozen"?s.push("IMPORTANT: This capability is FROZEN. Any modification requires explicit approval."):d==="stable"&&s.push("NOTE: This capability is STABLE. Prefer additive changes; avoid breaking the public API."),s.join(`
+`)}async function V(n,e){try{const{callAI:l}=await import("../ai/providerRouter.mjs");return await l(n,e)}catch{return null}}function Z(n,e,l,a,i,r){const c=x(e),u=e.name||e.title||n,d=l?.codeAnalysis?.services||[],p=a?.dependents?.[n]||[],f=a?.deps?.[n]||[],o=[];if(e.description&&e.description!=="(none provided)"?o.push(`${u} \u2014 ${e.description}.`):o.push(`${u} handles the ${n} flow within this system.`),d.length&&o.push(`It integrates with ${d.join(" and ")}.`),f.length&&o.push(`It depends on: ${f.join(", ")}.`),p.length){const t=p.filter(m=>x(i.find(j=>j.id===m))==="frozen");t.length?o.push(`\u26A0\uFE0F  ${t.join(", ")} depend${t.length===1?"s":""} on this \u2014 changing it may break frozen capabilities.`):o.push(`${p.join(", ")} depend${p.length===1?"s":""} on this capability.`)}return c==="frozen"?o.push("This capability is FROZEN \u2014 do not modify without explicit instruction."):c==="stable"?o.push("This capability is stable \u2014 prefer additive changes and avoid breaking the existing API surface."):o.push("This capability is experimental \u2014 free to refactor as needed."),r.length?o.push(`Before shipping changes, run the registered scenarios: ${r.map(t=>t.scenarioId||"unnamed").join(", ")}.`):o.push("No test scenarios are registered \u2014 consider adding one before making changes."),o.join(" ")}function E(n,e,l,a,i){const r=x(e),c=P[r]||"\u{1F30A}",u=z[r]||L;if(console.log(),console.log(I(`  ${c} ${u(n)}`)),(e.name||e.title)&&console.log(y(`     ${e.name||e.title}`)),console.log(),i){console.log(N("  [dry-run] Prompt only \u2014 no AI call made")),console.log();return}const d=l.split(" ");let p="  ";const f=[];for(const o of d)p.length+o.length>82?(f.push(p),p="  "+o):p+=(p==="  "?"":" ")+o;p.trim()&&f.push(p);for(const o of f)console.log(o);console.log(),a?console.log(y(`  \u2500\u2500 via ${a}`)):(console.log(y("  \u2500\u2500 structural summary (no AI provider configured)")),console.log(`  ${N("\u{1F4A1}")} ${y("For richer AI narratives:")}  ${W("infernoflow ai setup")}`)),console.log()}async function H(n){const e=(n||[]).slice(1),l=e.includes("--dry-run"),a=e.includes("--json"),i=e.find(t=>!t.startsWith("--"));i||(console.error(C("\u2717 Usage: infernoflow explain <capability-id|file-path> [--dry-run] [--json]")),console.error(y("  Examples:")),console.error(y("    infernoflow explain CreateTask")),console.error(y("    infernoflow explain src/components/TaskComposer.jsx")),process.exit(1));const r=process.cwd(),c=b.join(r,"inferno");let u=[];const d=T(b.join(c,"capabilities.json"));d&&(u=Array.isArray(d)?d:d.capabilities||[]);const p=i.includes("/")||i.includes("\\")||/\.\w+$/.test(i);let f=[];if(p){const m=T(b.join(c,"scan.json"))?.capabilities||[],j=b.relative(r,b.resolve(r,i));for(const v of m)(v.codeAnalysis?.sourceFiles||[]).some(g=>g===j||g.endsWith(j)||j.endsWith(g))&&f.push(v.id);if(f.length===0){const v=T(b.join(c,"capability-map.json"));if(v){const s=j.replace(/\\/g,"/");for(const[h,g]of Object.entries(v))(Array.isArray(g)?g:[g]).some(w=>w===s||w.endsWith(s)||s.endsWith(w))&&f.push(h)}}f.length===0&&(console.error(C(`\u2717 No capabilities found mapped to "${i}"`)),console.error(y("  Run: infernoflow scan \u2014 to build the source-file \u2192 capability map")),console.error(y("  Then retry: infernoflow explain "+i)),process.exit(1)),a||(console.log(y(`
+  infernoflow explain  \u2192  ${I(i)}`)),console.log(y(`  Found ${f.length} mapped ${f.length>1?"capabilities":"capability"}: ${f.join(", ")}`)),console.log())}else f=[i];const o=[];for(const t of f){const m=u.find($=>$.id===t);if(!m){a||(console.error(C(`\u2717 Capability "${t}" not found in capabilities.json`)),console.error(y("  Run: infernoflow stability \u2014 to list all capability IDs")));continue}const j=T(b.join(c,"scan.json")),v=T(b.join(c,"graph.json")),s=j?.capabilities?.find($=>$.id===t),h=s?.codeAnalysis?.sourceFiles||[],g=J(h[0],r),A=B(h[0],r),w=M(t,c),O=_(t,m,s,v,u,w,g,A);if(l&&!a){console.log(y(`  \u2500\u2500 ${I(t)} \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`)),E(t,m,"",null,!0),f.length===1&&(console.log(I("  Prompt that would be sent to AI:")),console.log(),console.log(O.split(`
+`).map($=>"    "+$).join(`
+`))),console.log();continue}let F=null,D=null;if(!l)try{const $=await V(O,r);$?.text&&(F=$.text.trim(),D=$.provider)}catch{}F||(F=Z(t,m,s,v,u,w),D=null),a?o.push({capId:t,name:m.name||m.title,stability:x(m),narrative:F,provider:D||"fallback",sourceFiles:h,scenarios:w.map($=>$.scenarioId||$.description),firstCommit:g}):(p||(console.log(y(`
+  infernoflow explain  \u2192  ${I(t)}`)),console.log(y("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"))),E(t,m,F,D,!1))}if(a){const t=f.length===1?o[0]:o;console.log(JSON.stringify(t,null,2));return}}export{H as explainCommand};