infernoflow 0.33.0 → 0.34.0

package/dist/lib/commands/health.mjs

@@ -1,2 +1,309 @@
-import*as d from"node:fs";import*as h from"node:path";import{execSync as x}from"node:child_process";import{warn as C,info as O,bold as p,gray as N,green as D,yellow as S,red as b}from"../ui/output.mjs";const m={coverage:25,documentation:20,freshness:20,completeness:15,drift:20};function k(e){for(const n of["contract.json","capabilities.json"]){const t=h.join(e,n);if(d.existsSync(t))try{return JSON.parse(d.readFileSync(t,"utf8"))}catch{}}return null}function F(e){const n=h.join(e,"scenarios");return d.existsSync(n)?d.readdirSync(n).filter(t=>t.endsWith(".json")).flatMap(t=>{try{const o=JSON.parse(d.readFileSync(h.join(n,t),"utf8"));return o.capability?[o.capability]:o.capabilities||[]}catch{return[]}}):[]}function I(e){try{const n=x("npx infernoflow check --json",{cwd:e,encoding:"utf8",timeout:15e3,stdio:["ignore","pipe","pipe"]});return JSON.parse(n)}catch(n){try{return JSON.parse(n.stdout||"{}")}catch{return{}}}}function J(e){const n=["contract.json","capabilities.json"].map(o=>h.join(e,o)).filter(d.existsSync);if(!n.length)return 999;const t=Math.max(...n.map(o=>d.statSync(o).mtimeMs));return(Date.now()-t)/(1e3*60*60*24)}function T(e){if(!e.length)return{score:0,detail:"No capabilities"};const n=e.filter(o=>o.description&&o.description.length>5).length,t=Math.round(n/e.length*100);return{score:t,detail:`${n}/${e.length} capabilities have descriptions`,pct:t}}function B(e,n){if(!e.length)return{score:0,detail:"No capabilities"};const t=new Set(n.map(s=>String(s).toLowerCase())),o=e.filter(s=>t.has(s.id.toLowerCase())).length,l=Math.round(o/e.length*100);return{score:Math.min(100,l+(t.size===0?0:10)),detail:`${o}/${e.length} capabilities have test scenarios`,pct:l}}function P(e){let n,t;return e<=1?(n=100,t="updated today"):e<=3?(n=95,t=`updated ${Math.round(e)}d ago`):e<=7?(n=85,t=`updated ${Math.round(e)}d ago`):e<=14?(n=70,t=`updated ${Math.round(e)}d ago`):e<=30?(n=50,t=`updated ${Math.round(e)}d ago`):e<=60?(n=30,t=`updated ${Math.round(e)}d ago \u2014 stale`):(n=10,t=`not updated in ${Math.round(e)}d \u2014 very stale`),{score:n,detail:t}}function R(e,n){if(!e.length)return{score:0,detail:"No capabilities"};const t=!!(n?.version||n?.contractVersion),o=e.filter(a=>a.tags?.length).length,l=e.filter(a=>a.owner).length,s=e.filter(a=>a.since).length,r=Math.round(o/e.length*100),f=Math.round(l/e.length*100),u=Math.round(s/e.length*100),c=Math.round((t?20:0)+r*.3+f*.3+u*.2);return{score:Math.min(100,c),detail:`version: ${t?"\u2713":"\u2717"}, tags: ${r}%, owner: ${f}%, since: ${u}%`}}function E(e){const n=e?.issues||[],t=n.filter(r=>(r.severity||r.level||"error")==="warning").length,o=n.filter(r=>(r.severity||r.level||"error")==="error").length;return e?.status==="ok"||!o&&!t?{score:100,detail:"No issues found"}:{score:Math.max(0,100-o*20-t*8),detail:`${o} error${o!==1?"s":""}, ${t} warning${t!==1?"s":""}`}}function W(e,n){const t=k(e),o=(t?.capabilities||[]).map(c=>typeof c=="string"?{id:c,description:"",tags:[],owner:"",since:""}:c),l=F(e),s=J(e),r=I(n),f={coverage:T(o),documentation:B(o,l),freshness:P(s),completeness:R(o,t),drift:E(r)};return{totalScore:Math.round(Object.entries(f).reduce((c,[a,i])=>c+i.score*m[a]/100,0)),dimensions:f,caps:o,daysAgo:s,checkResult:r}}function y(e){return e>=80?D:e>=60?S:b}function M(e){return e>=90?"A":e>=80?"B":e>=70?"C":e>=60?"D":"F"}function v(e,n=30){const t=Math.round(e/100*n),o=n-t;return"\u2588".repeat(t)+"\u2591".repeat(o)}function G(e,n){const t=y(e),o=M(e);console.log(),console.log(`  ${p("\u{1F525} infernoflow health score")}`),console.log(),console.log(`  ${t(p(String(e)))} / 100   ${t(p(o))}   ${t(v(e))}`),console.log();const l={coverage:"Coverage     ",documentation:"Docs/Tests   ",freshness:"Freshness    ",completeness:"Completeness ",drift:"Drift risk   "};for(const[s,r]of Object.entries(n)){const f=m[s],u=r.score,c=y(u),a=v(u,20),i=Math.round(u*f/100);console.log(`  ${p(l[s])} ${c(String(u).padStart(3))}   ${c(a)}  ${N(`\xD7${f}% = ${i}pts  ${r.detail}`)}`)}console.log()}function H(e,n){const t=[];n.coverage.score<70&&t.push("Add descriptions to your capabilities in contract.json"),n.documentation.score<60&&t.push("Create scenario files in inferno/scenarios/ for each capability"),n.freshness.score<70&&t.push("Run `infernoflow suggest` to sync recent changes to the contract"),n.completeness.score<60&&t.push("Add version, tags, owner, and since fields to your capabilities"),n.drift.score<80&&t.push("Run `infernoflow check` and fix the reported issues"),t.length&&(console.log(`  ${p("Tips to improve:")}`),t.forEach(o=>console.log(`  ${S("\xB7")} ${o}`)),console.log())}async function q(e){const n=e.slice(1),t=n.includes("--json"),o=n.includes("--watch"),l=process.cwd(),s=h.join(l,"inferno");if(!d.existsSync(s)){const i="inferno/ not found. Run: infernoflow init";t?console.log(JSON.stringify({ok:!1,error:i})):C(i),process.exit(1)}const r=n.indexOf("--fail-below"),f=r!==-1?parseInt(n[r+1],10):null,u=n.indexOf("--interval"),c=u!==-1?parseInt(n[u+1],10):30,a=()=>{const{totalScore:i,dimensions:g}=W(s,l);if(t){const j=Object.fromEntries(Object.entries(g).map(([w,$])=>[w,{score:$.score,detail:$.detail,weight:m[w]}]));console.log(JSON.stringify({ok:!0,score:i,grade:M(i),dimensions:j}))}else o&&process.stdout.write("\x1Bc"),G(i,g),o||H(i,g);return f!==null&&i<f&&(t||console.error(b(`  \u2717  Score ${i} is below threshold ${f} \u2014 failing.
-`)),process.exit(1)),i};o?(t||O(`Watching health score every ${c}s \u2014 press Ctrl+C to stop`),a(),setInterval(a,c*1e3),await new Promise(()=>{})):a()}export{q as healthCommand};
+/**
+ * infernoflow health
+ *
+ * Computes a weighted 0–100 health score for the capability contract.
+ * Breaks it down across five dimensions so you know exactly where to improve.
+ *
+ * Dimensions:
+ *   Coverage      % of capabilities that have descriptions      (weight 25)
+ *   Documentation % with at least one scenario/test             (weight 20)
+ *   Freshness     How recently the contract was updated          (weight 20)
+ *   Completeness  Version field, owner, tags present            (weight 15)
+ *   Drift risk    Open issues from `infernoflow check`           (weight 20)
+ *
+ * Usage:
+ *   infernoflow health                  Print score + breakdown
+ *   infernoflow health --json           Machine-readable
+ *   infernoflow health --fail-below 70  Exit 1 if score < 70 (CI gate)
+ *   infernoflow health --watch          Re-run every 30s (for terminals)
+ */
+
+import * as fs          from "node:fs";
+import * as path        from "node:path";
+import { execSync }     from "node:child_process";
+import { done, warn, info, bold, cyan, gray, green, yellow, red } from "../ui/output.mjs";
+
+const WEIGHTS = {
+  coverage:      25,
+  documentation: 20,
+  freshness:     20,
+  completeness:  15,
+  drift:         20,
+};
+
+// ── Readers ───────────────────────────────────────────────────────────────────
+
+function readContract(infernoDir) {
+  for (const f of ["contract.json", "capabilities.json"]) {
+    const p = path.join(infernoDir, f);
+    if (!fs.existsSync(p)) continue;
+    try { return JSON.parse(fs.readFileSync(p, "utf8")); } catch {}
+  }
+  return null;
+}
+
+function readScenarios(infernoDir) {
+  const scenDir = path.join(infernoDir, "scenarios");
+  if (!fs.existsSync(scenDir)) return [];
+  return fs.readdirSync(scenDir)
+    .filter(f => f.endsWith(".json"))
+    .flatMap(f => {
+      try {
+        const data = JSON.parse(fs.readFileSync(path.join(scenDir, f), "utf8"));
+        return data.capability ? [data.capability] : (data.capabilities || []);
+      } catch { return []; }
+    });
+}
+
+function runCheck(cwd) {
+  try {
+    const out = execSync("npx infernoflow check --json", {
+      cwd, encoding: "utf8", timeout: 15_000, stdio: ["ignore", "pipe", "pipe"],
+    });
+    return JSON.parse(out);
+  } catch (err) {
+    try { return JSON.parse(err.stdout || "{}"); } catch { return {}; }
+  }
+}
+
+function lastModifiedDaysAgo(infernoDir) {
+  const files = ["contract.json", "capabilities.json"]
+    .map(f => path.join(infernoDir, f))
+    .filter(fs.existsSync);
+  if (!files.length) return 999;
+  const mtime = Math.max(...files.map(f => fs.statSync(f).mtimeMs));
+  return (Date.now() - mtime) / (1000 * 60 * 60 * 24);
+}
+
+// ── Scorers ───────────────────────────────────────────────────────────────────
+
+function scoreCoverage(caps) {
+  if (!caps.length) return { score: 0, detail: "No capabilities" };
+  const withDesc = caps.filter(c => c.description && c.description.length > 5).length;
+  const pct = Math.round((withDesc / caps.length) * 100);
+  return {
+    score:  pct,
+    detail: `${withDesc}/${caps.length} capabilities have descriptions`,
+    pct,
+  };
+}
+
+function scoreDocumentation(caps, scenarioCaps) {
+  if (!caps.length) return { score: 0, detail: "No capabilities" };
+  const scenSet = new Set(scenarioCaps.map(s => String(s).toLowerCase()));
+  const withScen = caps.filter(c => scenSet.has(c.id.toLowerCase())).length;
+  const pct = Math.round((withScen / caps.length) * 100);
+  return {
+    score:  Math.min(100, pct + (scenSet.size === 0 ? 0 : 10)), // bonus for having any scenarios
+    detail: `${withScen}/${caps.length} capabilities have test scenarios`,
+    pct,
+  };
+}
+
+function scoreFreshness(daysAgo) {
+  let score;
+  let label;
+  if (daysAgo <= 1)   { score = 100; label = "updated today"; }
+  else if (daysAgo <= 3)  { score = 95;  label = `updated ${Math.round(daysAgo)}d ago`; }
+  else if (daysAgo <= 7)  { score = 85;  label = `updated ${Math.round(daysAgo)}d ago`; }
+  else if (daysAgo <= 14) { score = 70;  label = `updated ${Math.round(daysAgo)}d ago`; }
+  else if (daysAgo <= 30) { score = 50;  label = `updated ${Math.round(daysAgo)}d ago`; }
+  else if (daysAgo <= 60) { score = 30;  label = `updated ${Math.round(daysAgo)}d ago — stale`; }
+  else                    { score = 10;  label = `not updated in ${Math.round(daysAgo)}d — very stale`; }
+  return { score, detail: label };
+}
+
+function scoreCompleteness(caps, contract) {
+  if (!caps.length) return { score: 0, detail: "No capabilities" };
+  const hasVersion = !!(contract?.version || contract?.contractVersion);
+  const withTags   = caps.filter(c => c.tags?.length).length;
+  const withOwner  = caps.filter(c => c.owner).length;
+  const withSince  = caps.filter(c => c.since).length;
+
+  const tagPct   = Math.round((withTags  / caps.length) * 100);
+  const ownerPct = Math.round((withOwner / caps.length) * 100);
+  const sincePct = Math.round((withSince / caps.length) * 100);
+
+  const score = Math.round(
+    (hasVersion ? 20 : 0) +
+    tagPct   * 0.3 +
+    ownerPct * 0.3 +
+    sincePct * 0.2
+  );
+
+  return {
+    score: Math.min(100, score),
+    detail: `version: ${hasVersion ? "✓" : "✗"}, tags: ${tagPct}%, owner: ${ownerPct}%, since: ${sincePct}%`,
+  };
+}
+
+function scoreDrift(checkResult) {
+  const issues   = checkResult?.issues || [];
+  const warnings = issues.filter(i => (i.severity || i.level || "error") === "warning").length;
+  const errors   = issues.filter(i => (i.severity || i.level || "error") === "error").length;
+  const status   = checkResult?.status;
+
+  if (status === "ok" || (!errors && !warnings)) return { score: 100, detail: "No issues found" };
+
+  const score = Math.max(0, 100 - (errors * 20) - (warnings * 8));
+  return {
+    score,
+    detail: `${errors} error${errors !== 1 ? "s" : ""}, ${warnings} warning${warnings !== 1 ? "s" : ""}`,
+  };
+}
+
+// ── Aggregate ─────────────────────────────────────────────────────────────────
+
+function computeHealth(infernoDir, cwd) {
+  const contract     = readContract(infernoDir);
+  const caps         = (contract?.capabilities || []).map(c =>
+    typeof c === "string" ? { id: c, description: "", tags: [], owner: "", since: "" } : c
+  );
+  const scenarioCaps = readScenarios(infernoDir);
+  const daysAgo      = lastModifiedDaysAgo(infernoDir);
+  const checkResult  = runCheck(cwd);
+
+  const dimensions = {
+    coverage:      scoreCoverage(caps),
+    documentation: scoreDocumentation(caps, scenarioCaps),
+    freshness:     scoreFreshness(daysAgo),
+    completeness:  scoreCompleteness(caps, contract),
+    drift:         scoreDrift(checkResult),
+  };
+
+  const totalScore = Math.round(
+    Object.entries(dimensions).reduce((sum, [key, dim]) => {
+      return sum + (dim.score * WEIGHTS[key]) / 100;
+    }, 0)
+  );
+
+  return { totalScore, dimensions, caps, daysAgo, checkResult };
+}
+
+// ── Renderer ──────────────────────────────────────────────────────────────────
+
+function scoreColor(score) {
+  if (score >= 80) return green;
+  if (score >= 60) return yellow;
+  return red;
+}
+
+function scoreGrade(score) {
+  if (score >= 90) return "A";
+  if (score >= 80) return "B";
+  if (score >= 70) return "C";
+  if (score >= 60) return "D";
+  return "F";
+}
+
+function barOf(score, width = 30) {
+  const filled = Math.round((score / 100) * width);
+  const empty  = width - filled;
+  return "█".repeat(filled) + "░".repeat(empty);
+}
+
+function printReport(totalScore, dimensions) {
+  const col   = scoreColor(totalScore);
+  const grade = scoreGrade(totalScore);
+
+  console.log();
+  console.log(`  ${bold("🔥 infernoflow health score")}`);
+  console.log();
+  console.log(`  ${col(bold(String(totalScore)))} / 100   ${col(bold(grade))}   ${col(barOf(totalScore))}`);
+  console.log();
+
+  const dimNames = {
+    coverage:      "Coverage     ",
+    documentation: "Docs/Tests   ",
+    freshness:     "Freshness    ",
+    completeness:  "Completeness ",
+    drift:         "Drift risk   ",
+  };
+
+  for (const [key, dim] of Object.entries(dimensions)) {
+    const w  = WEIGHTS[key];
+    const sc = dim.score;
+    const c  = scoreColor(sc);
+    const bar = barOf(sc, 20);
+    const weighted = Math.round((sc * w) / 100);
+    console.log(
+      `  ${bold(dimNames[key])} ${c(String(sc).padStart(3))}   ${c(bar)}  ${gray(`×${w}% = ${weighted}pts  ${dim.detail}`)}`
+    );
+  }
+  console.log();
+}
+
+function printTips(totalScore, dimensions) {
+  const tips = [];
+
+  if (dimensions.coverage.score < 70)
+    tips.push("Add descriptions to your capabilities in contract.json");
+  if (dimensions.documentation.score < 60)
+    tips.push("Create scenario files in inferno/scenarios/ for each capability");
+  if (dimensions.freshness.score < 70)
+    tips.push("Run `infernoflow suggest` to sync recent changes to the contract");
+  if (dimensions.completeness.score < 60)
+    tips.push("Add version, tags, owner, and since fields to your capabilities");
+  if (dimensions.drift.score < 80)
+    tips.push("Run `infernoflow check` and fix the reported issues");
+
+  if (tips.length) {
+    console.log(`  ${bold("Tips to improve:")}`);
+    tips.forEach(t => console.log(`  ${yellow("·")} ${t}`));
+    console.log();
+  }
+}
+
+// ── Entry ─────────────────────────────────────────────────────────────────────
+
+export async function healthCommand(rawArgs) {
+  const args      = rawArgs.slice(1);
+  const jsonMode  = args.includes("--json");
+  const watchMode = args.includes("--watch");
+  const cwd       = process.cwd();
+  const infernoDir = path.join(cwd, "inferno");
+
+  if (!fs.existsSync(infernoDir)) {
+    const msg = "inferno/ not found. Run: infernoflow init";
+    if (jsonMode) console.log(JSON.stringify({ ok: false, error: msg }));
+    else warn(msg);
+    process.exit(1);
+  }
+
+  const failBelowIdx = args.indexOf("--fail-below");
+  const failBelow    = failBelowIdx !== -1 ? parseInt(args[failBelowIdx + 1], 10) : null;
+
+  const intervalIdx  = args.indexOf("--interval");
+  const intervalSecs = intervalIdx !== -1 ? parseInt(args[intervalIdx + 1], 10) : 30;
+
+  const runOnce = () => {
+    const { totalScore, dimensions } = computeHealth(infernoDir, cwd);
+
+    if (jsonMode) {
+      const dimFlat = Object.fromEntries(
+        Object.entries(dimensions).map(([k, v]) => [k, { score: v.score, detail: v.detail, weight: WEIGHTS[k] }])
+      );
+      console.log(JSON.stringify({ ok: true, score: totalScore, grade: scoreGrade(totalScore), dimensions: dimFlat }));
+    } else {
+      if (watchMode) process.stdout.write("\x1Bc"); // clear screen
+      printReport(totalScore, dimensions);
+      if (!watchMode) printTips(totalScore, dimensions);
+    }
+
+    if (failBelow !== null && totalScore < failBelow) {
+      if (!jsonMode) console.error(red(`  ✗  Score ${totalScore} is below threshold ${failBelow} — failing.\n`));
+      process.exit(1);
+    }
+
+    return totalScore;
+  };
+
+  if (watchMode) {
+    if (!jsonMode) info(`Watching health score every ${intervalSecs}s — press Ctrl+C to stop`);
+    runOnce();
+    setInterval(runOnce, intervalSecs * 1000);
+    await new Promise(() => {});
+  } else {
+    runOnce();
+  }
+}

package/dist/lib/commands/impact.mjs

@@ -1,2 +1,325 @@
-import*as R from"node:fs";import*as k from"node:path";import{bold as C,gray as l,green as j,yellow as A,red as x}from"../ui/output.mjs";function E(t){try{return JSON.parse(R.readFileSync(t,"utf8"))}catch{return null}}const L={frozen:"\u{1F9CA}",stable:"\u3030\uFE0F ",experimental:"\u{1F30A}"},O={frozen:x,stable:A,experimental:j};function h(t){return t?.stability||"experimental"}function _(t,o,i=10){const c=new Set(o[t]||[]),n=new Set,r=[...c].map(u=>({id:u,depth:1})),e=new Set([t,...c]);for(;r.length>0;){const{id:u,depth:f}=r.shift();if(!(f>=i))for(const d of o[u]||[])e.has(d)||(e.add(d),n.add(d),r.push({id:d,depth:f+1}))}return{direct:c,transitive:n}}function F(t){const o=k.join(t,"scenarios");if(!R.existsSync(o))return[];const i=[];for(const c of R.readdirSync(o))if(c.endsWith(".json"))try{const n=JSON.parse(R.readFileSync(k.join(o,c),"utf8"));i.push(n)}catch{}return i}function D(t,o){return o.filter(i=>(i.capabilitiesCovered||i.capabilities||[]).some(n=>n.toLowerCase()===t.toLowerCase()))}function J(t,o,i){if(h(t)==="frozen"&&o.size>0)return"critical";for(const n of o){const r=i.find(e=>e.id===n);if(h(r)==="frozen")return"high"}for(const n of o){const r=i.find(e=>e.id===n);if(h(r)==="stable")return"medium"}return"low"}const K={critical:x,high:x,medium:A,low:j},M={critical:"\u{1F534}",high:"\u{1F534}",medium:"\u{1F7E1}",low:"\u{1F7E2}"},T={critical:"This capability is FROZEN \u2014 any change is high-risk. Requires explicit approval.",high:"A frozen capability depends on this \u2014 test thoroughly before merging.",medium:"A stable capability is in the blast zone \u2014 prefer additive changes only.",low:"All dependents are experimental \u2014 safe to iterate freely."};function U({capId:t,targetCap:o,direct:i,transitive:c,affectedScenarios:n,risk:r,allCaps:e,deps:u}){const f=h(o),d=L[f]||"\u{1F30A}",w=O[f]||j,I=K[r],m=M[r];if(console.log(),console.log(C(`  ${d} ${w(t)}`)),(o?.name||o?.title)&&console.log(l(`     ${o.name||o.title}`)),console.log(l("     stability: ")+w(f)),console.log(),u.length>0){console.log(l("  This cap calls:"));for(const s of u){const p=e.find(S=>S.id===s),g=L[h(p)]||"\u{1F30A}",y=O[h(p)]||j;console.log(`    ${g}  ${y(s)}`)}console.log()}if(i.size===0)console.log(l("  No capabilities depend on this one.")),console.log(l("  \u2714 Safe to change freely.")),console.log();else{console.log(C("  Direct dependents (will be immediately affected):"));for(const s of i){const p=e.find(v=>v.id===s),g=h(p),y=L[g]||"\u{1F30A}",S=O[g]||j;console.log(`    ${y}  ${S(s)}`)}if(console.log(),c.size>0){console.log(C("  Transitive dependents (indirectly affected):"));for(const s of c){const p=e.find(v=>v.id===s),g=h(p),y=L[g]||"\u{1F30A}",S=O[g]||j;console.log(`    ${y}  ${S(s)}`)}console.log()}}if(n.length>0){console.log(C("  Scenarios at risk:"));for(const s of n)console.log(`    ${A("\u26A0")}  ${s.scenarioId||s.description||"(unnamed)"}`),s.description&&console.log(l(`       ${s.description}`));console.log()}else i.size>0&&(console.log(l("  No scenarios cover the affected capabilities.")),console.log(l("  Consider adding scenarios before making this change.")),console.log());console.log(`  ${m}  Risk level: ${C(I(r.toUpperCase()))}`),console.log(`     ${l(T[r])}`),console.log();const $=i.size+c.size;$>0&&(console.log(l(`  \u2500\u2500 ${i.size} direct \xB7 ${c.size} transitive \xB7 ${$} total affected \xB7 ${n.length} scenario(s) at risk`)),console.log())}async function W(t){const o=(t||[]).slice(1),i=o.includes("--json"),c=o.includes("--check"),n=o.indexOf("--depth"),r=n!==-1&&parseInt(o[n+1],10)||10,e=o.find((a,b)=>!a.startsWith("--")&&(n===-1||b!==n+1));e||(console.error(x("\u2717 Usage: infernoflow impact <capability-id> [--depth N] [--json] [--check]")),console.error(l("  Example: infernoflow impact user-auth")),process.exit(1));const u=process.cwd(),f=k.join(u,"inferno"),d=E(k.join(f,"graph.json"));d||(console.error(x("\u2717 inferno/graph.json not found \u2014 run `infernoflow graph` first.")),process.exit(1));let w=[];const I=E(k.join(f,"capabilities.json"));I&&(w=Array.isArray(I)?I:I.capabilities||[]);const m=w.find(a=>a.id===e);m||(console.error(x(`\u2717 Capability "${e}" not found in capabilities.json`)),console.error(l("  Run: infernoflow stability \u2014 to list all capability IDs")),process.exit(1));const{direct:$,transitive:s}=_(e,d.dependents||{},r),p=new Set([...$,...s]),g=d.deps?.[e]||[],y=F(f),S=D(e,y),v=new Map;for(const a of S)v.set(a.scenarioId||a.description,a);for(const a of p)for(const b of D(a,y))v.set(b.scenarioId||b.description,b);const N=[...v.values()],z=J(m,p,w);if(i){const a={capId:e,name:m.name||m.title,stability:h(m),risk:z,direct:[...$],transitive:[...s],deps:g,affectedScenarios:N.map(b=>b.scenarioId||b.description),summary:{directCount:$.size,transitiveCount:s.size,totalAffected:p.size,scenariosAtRisk:N.length}};console.log(JSON.stringify(a,null,2)),c&&(z==="high"||z==="critical")&&process.exit(1);return}console.log(l(`
-  infernoflow impact  \u2192  ${C(e)}`)),console.log(l("  \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")),U({capId:e,targetCap:m,direct:$,transitive:s,affectedScenarios:N,risk:z,allCaps:w,deps:g}),c&&(z==="high"||z==="critical")&&(console.log(x("  \u2717 --check failed: risk level is "+z.toUpperCase())),process.exit(1))}export{W as impactCommand};
+/**
+ * infernoflow impact
+ *
+ * Before you touch a capability — see the blast radius.
+ *
+ * Given a capability ID, answers:
+ *   • Which caps directly depend on this one?
+ *   • Which caps transitively depend on it?
+ *   • What scenarios would be affected?
+ *   • What is the overall risk level? (low / medium / high / critical)
+ *   • Are any frozen/stable caps in the blast zone?
+ *
+ * Pure graph traversal — no AI needed. Fast and deterministic.
+ *
+ * Usage:
+ *   infernoflow impact auth-login
+ *   infernoflow impact auth-login --depth 5
+ *   infernoflow impact auth-login --json
+ *   infernoflow impact auth-login --check     Exit 1 if risk is HIGH or CRITICAL
+ */
+
+import * as fs   from "node:fs";
+import * as path from "node:path";
+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; }
+}
+
+const LEVEL_ICON  = { frozen: "🧊", stable: "〰️ ", experimental: "🌊" };
+const LEVEL_COLOR = { frozen: red, stable: yellow, experimental: green };
+
+function stability(cap) {
+  return cap?.stability || "experimental";
+}
+
+// ── blast radius (BFS on reverse graph) ──────────────────────────────────────
+
+/**
+ * Walk the reverse dependency graph (dependents) starting from capId.
+ * Returns: { direct: Set<string>, transitive: Set<string> }
+ */
+function blastRadius(capId, dependents, maxDepth = 10) {
+  const direct     = new Set(dependents[capId] || []);
+  const transitive = new Set();
+  const queue      = [...direct].map(id => ({ id, depth: 1 }));
+  const visited    = new Set([capId, ...direct]);
+
+  while (queue.length > 0) {
+    const { id, depth } = queue.shift();
+    if (depth >= maxDepth) continue;
+    for (const dep of (dependents[id] || [])) {
+      if (!visited.has(dep)) {
+        visited.add(dep);
+        transitive.add(dep);
+        queue.push({ id: dep, depth: depth + 1 });
+      }
+    }
+  }
+
+  return { direct, transitive };
+}
+
+// ── scenario finder ───────────────────────────────────────────────────────────
+
+function loadScenarios(infernoDir) {
+  const scenariosDir = path.join(infernoDir, "scenarios");
+  if (!fs.existsSync(scenariosDir)) return [];
+
+  const scenarios = [];
+  for (const f of fs.readdirSync(scenariosDir)) {
+    if (!f.endsWith(".json")) continue;
+    try {
+      const s = JSON.parse(fs.readFileSync(path.join(scenariosDir, f), "utf8"));
+      scenarios.push(s);
+    } catch {}
+  }
+  return scenarios;
+}
+
+function scenariosForCap(capId, scenarios) {
+  return scenarios.filter(s => {
+    const covered = s.capabilitiesCovered || s.capabilities || [];
+    return covered.some(c => c.toLowerCase() === capId.toLowerCase());
+  });
+}
+
+// ── risk calculator ───────────────────────────────────────────────────────────
+
+/**
+ * Risk levels:
+ *   critical  — the target cap itself is frozen AND has dependents
+ *   high      — a frozen cap is in the blast zone
+ *   medium    — a stable cap is in the blast zone
+ *   low       — all dependents are experimental
+ */
+function computeRisk(targetCap, allInBlast, allCaps) {
+  const targetLevel = stability(targetCap);
+
+  if (targetLevel === "frozen" && allInBlast.size > 0) {
+    return "critical";
+  }
+
+  for (const id of allInBlast) {
+    const cap = allCaps.find(c => c.id === id);
+    if (stability(cap) === "frozen") return "high";
+  }
+
+  for (const id of allInBlast) {
+    const cap = allCaps.find(c => c.id === id);
+    if (stability(cap) === "stable") return "medium";
+  }
+
+  return "low";
+}
+
+const RISK_COLOR = {
+  critical: red,
+  high:     red,
+  medium:   yellow,
+  low:      green,
+};
+
+const RISK_ICON = {
+  critical: "🔴",
+  high:     "🔴",
+  medium:   "🟡",
+  low:      "🟢",
+};
+
+const RISK_ADVICE = {
+  critical: "This capability is FROZEN — any change is high-risk. Requires explicit approval.",
+  high:     "A frozen capability depends on this — test thoroughly before merging.",
+  medium:   "A stable capability is in the blast zone — prefer additive changes only.",
+  low:      "All dependents are experimental — safe to iterate freely.",
+};
+
+// ── printer ───────────────────────────────────────────────────────────────────
+
+function printImpact({ capId, targetCap, direct, transitive, affectedScenarios, risk, allCaps, deps }) {
+  const targetLevel = stability(targetCap);
+  const targetIcon  = LEVEL_ICON[targetLevel] || "🌊";
+  const targetColor = LEVEL_COLOR[targetLevel] || green;
+  const riskColor   = RISK_COLOR[risk];
+  const riskIcon    = RISK_ICON[risk];
+
+  console.log();
+  console.log(bold(`  ${targetIcon} ${targetColor(capId)}`));
+  if (targetCap?.name || targetCap?.title) {
+    console.log(gray(`     ${targetCap.name || targetCap.title}`));
+  }
+  console.log(gray(`     stability: `) + targetColor(targetLevel));
+  console.log();
+
+  // What this cap calls (downstream)
+  if (deps.length > 0) {
+    console.log(gray("  This cap calls:"));
+    for (const dep of deps) {
+      const d = allCaps.find(c => c.id === dep);
+      const icon  = LEVEL_ICON[stability(d)]  || "🌊";
+      const color = LEVEL_COLOR[stability(d)] || green;
+      console.log(`    ${icon}  ${color(dep)}`);
+    }
+    console.log();
+  }
+
+  // Blast radius
+  if (direct.size === 0) {
+    console.log(gray("  No capabilities depend on this one."));
+    console.log(gray("  ✔ Safe to change freely."));
+    console.log();
+  } else {
+    console.log(bold("  Direct dependents (will be immediately affected):"));
+    for (const id of direct) {
+      const cap   = allCaps.find(c => c.id === id);
+      const level = stability(cap);
+      const icon  = LEVEL_ICON[level]  || "🌊";
+      const color = LEVEL_COLOR[level] || green;
+      console.log(`    ${icon}  ${color(id)}`);
+    }
+    console.log();
+
+    if (transitive.size > 0) {
+      console.log(bold("  Transitive dependents (indirectly affected):"));
+      for (const id of transitive) {
+        const cap   = allCaps.find(c => c.id === id);
+        const level = stability(cap);
+        const icon  = LEVEL_ICON[level]  || "🌊";
+        const color = LEVEL_COLOR[level] || green;
+        console.log(`    ${icon}  ${color(id)}`);
+      }
+      console.log();
+    }
+  }
+
+  // Affected scenarios
+  if (affectedScenarios.length > 0) {
+    console.log(bold("  Scenarios at risk:"));
+    for (const s of affectedScenarios) {
+      console.log(`    ${yellow("⚠")}  ${s.scenarioId || s.description || "(unnamed)"}`);
+      if (s.description) console.log(gray(`       ${s.description}`));
+    }
+    console.log();
+  } else if (direct.size > 0) {
+    console.log(gray("  No scenarios cover the affected capabilities."));
+    console.log(gray("  Consider adding scenarios before making this change."));
+    console.log();
+  }
+
+  // Risk banner
+  console.log(`  ${riskIcon}  Risk level: ${bold(riskColor(risk.toUpperCase()))}`);
+  console.log(`     ${gray(RISK_ADVICE[risk])}`);
+  console.log();
+
+  // Summary numbers
+  const total = direct.size + transitive.size;
+  if (total > 0) {
+    console.log(gray(
+      `  ── ${direct.size} direct · ${transitive.size} transitive · ${total} total affected · ${affectedScenarios.length} scenario(s) at risk`
+    ));
+    console.log();
+  }
+}
+
+// ── entry point ───────────────────────────────────────────────────────────────
+
+export async function impactCommand(rawArgs) {
+  const args      = (rawArgs || []).slice(1); // skip command name
+  const jsonMode  = args.includes("--json");
+  const checkMode = args.includes("--check");
+  const depthIdx  = args.indexOf("--depth");
+  const maxDepth  = depthIdx !== -1 ? parseInt(args[depthIdx + 1], 10) || 10 : 10;
+
+  const capId = args.find((a, i) => !a.startsWith("--") && (depthIdx === -1 || i !== depthIdx + 1));
+
+  if (!capId) {
+    console.error(red("✗ Usage: infernoflow impact <capability-id> [--depth N] [--json] [--check]"));
+    console.error(gray("  Example: infernoflow impact user-auth"));
+    process.exit(1);
+  }
+
+  const cwd        = process.cwd();
+  const infernoDir = path.join(cwd, "inferno");
+
+  // Load graph
+  const graph = loadJson(path.join(infernoDir, "graph.json"));
+  if (!graph) {
+    console.error(red("✗ inferno/graph.json not found — run `infernoflow graph` first."));
+    process.exit(1);
+  }
+
+  // Load capabilities
+  let allCaps = [];
+  const rawCaps = loadJson(path.join(infernoDir, "capabilities.json"));
+  if (rawCaps) allCaps = Array.isArray(rawCaps) ? rawCaps : (rawCaps.capabilities || []);
+
+  // Validate cap exists
+  const targetCap = allCaps.find(c => c.id === capId);
+  if (!targetCap) {
+    console.error(red(`✗ Capability "${capId}" not found in capabilities.json`));
+    console.error(gray("  Run: infernoflow stability — to list all capability IDs"));
+    process.exit(1);
+  }
+
+  // Blast radius
+  const { direct, transitive } = blastRadius(capId, graph.dependents || {}, maxDepth);
+  const allInBlast = new Set([...direct, ...transitive]);
+
+  // Dependencies (what this cap calls)
+  const deps = graph.deps?.[capId] || [];
+
+  // Scenarios
+  const scenarios     = loadScenarios(infernoDir);
+  const targetScenarios = scenariosForCap(capId, scenarios);
+  // Collect scenarios for all affected caps too
+  const affectedScenarioSet = new Map();
+  for (const s of targetScenarios) {
+    affectedScenarioSet.set(s.scenarioId || s.description, s);
+  }
+  for (const id of allInBlast) {
+    for (const s of scenariosForCap(id, scenarios)) {
+      affectedScenarioSet.set(s.scenarioId || s.description, s);
+    }
+  }
+  const affectedScenarios = [...affectedScenarioSet.values()];
+
+  // Risk
+  const risk = computeRisk(targetCap, allInBlast, allCaps);
+
+  // JSON mode
+  if (jsonMode) {
+    const out = {
+      capId,
+      name:        targetCap.name || targetCap.title,
+      stability:   stability(targetCap),
+      risk,
+      direct:      [...direct],
+      transitive:  [...transitive],
+      deps,
+      affectedScenarios: affectedScenarios.map(s => s.scenarioId || s.description),
+      summary: {
+        directCount:     direct.size,
+        transitiveCount: transitive.size,
+        totalAffected:   allInBlast.size,
+        scenariosAtRisk: affectedScenarios.length,
+      },
+    };
+    console.log(JSON.stringify(out, null, 2));
+    if (checkMode && (risk === "high" || risk === "critical")) process.exit(1);
+    return;
+  }
+
+  console.log(gray(`\n  infernoflow impact  →  ${bold(capId)}`));
+  console.log(gray("  ──────────────────────────────────────────────────────────────"));
+
+  printImpact({ capId, targetCap, direct, transitive, affectedScenarios, risk, allCaps, deps });
+
+  if (checkMode && (risk === "high" || risk === "critical")) {
+    console.log(red("  ✗ --check failed: risk level is " + risk.toUpperCase()));
+    process.exit(1);
+  }
+}