infernoflow 0.37.1 → 0.37.4

package/dist/lib/commands/watch.mjs

@@ -1,204 +1,5 @@
-/**
- * infernoflow watch
- *
- * File-system watcher that runs `infernoflow suggest` automatically whenever
- * source files are saved. Zero manual steps — just code, save, and the
- * contract stays in sync.
- *
- * Usage:
- *   infernoflow watch                  Watch src/ (or auto-detected root)
- *   infernoflow watch src lib          Watch specific directories
- *   infernoflow watch --interval 5     Debounce interval in seconds (default: 3)
- *   infernoflow watch --dry-run        Print what would run, don't actually run
- *   infernoflow watch --silent         No output (git-hook friendly)
- *
- * What it does on each save:
- *   1. Debounce (3 s default) — batches rapid multi-file saves
- *   2. Diff changed files against capability-map.json
- *   3. If relevant capabilities may be affected → run suggest
- *   4. Run check silently — log issues to inferno/WATCH.log
- */
+import*as f from"node:fs";import*as e from"node:path";import{fileURLToPath as $}from"node:url";import{spawnSync as b}from"node:child_process";import{warn as m,bold as x,cyan as D,gray as d,green as I,yellow as P}from"../ui/output.mjs";const R=new Set([".ts",".tsx",".js",".jsx",".mjs",".cjs",".py",".go",".java",".cs",".rb",".swift"]),M=new Set(["node_modules",".git","dist","build","out",".next",".angular","vendor","coverage","__pycache__"]);function W(t){const i=["src","lib","app","pages","components","server","api"].filter(o=>f.existsSync(e.join(t,o)));return i.length?i.map(o=>e.join(t,o)):[t]}function k(t){return R.has(e.extname(t).toLowerCase())}function A(t,r){const i=e.join(r,"capability-map.json");if(!f.existsSync(i))return{relevant:!0,reason:"no cap-map \u2014 suggesting broadly"};let o;try{o=JSON.parse(f.readFileSync(i,"utf8"))}catch{return{relevant:!0,reason:"cap-map unreadable"}}const s=[];for(const g of t){const c=e.relative(process.cwd(),g).replace(/\\/g,"/");for(const[a,u]of Object.entries(o))c.startsWith(a.replace(/\\/g,"/"))&&s.push(...u)}return s.length>0?{relevant:!0,reason:`touches: ${[...new Set(s)].slice(0,3).join(", ")}`}:{relevant:!1,reason:"no mapped capabilities affected"}}function N(t,r,i,o,s){const c=`code changes in ${t.map(a=>e.basename(a,e.extname(a))).slice(0,3).join(", ")}`;if(s||process.stdout.write(`  ${P("\u27F3")}  suggesting from ${x(String(t.length))} changed file${t.length!==1?"s":""}\u2026 `),o){s||console.log(d("(dry run)"));return}try{b(process.execPath,[e.join(e.dirname(e.dirname(e.dirname($(import.meta.url)))),"bin","infernoflow.mjs"),"suggest",c,"--json"],{cwd:r,encoding:"utf8",timeout:3e4,stdio:"ignore"}),s||console.log(I("done"))}catch{s||console.log(d("skipped (no changes)"))}try{const u=b(process.execPath,[e.join(e.dirname(e.dirname(e.dirname($(import.meta.url)))),"bin","infernoflow.mjs"),"check","--json"],{cwd:r,encoding:"utf8",timeout:15e3}).stdout?.trim();if(u){const w=JSON.parse(u);if(w.status==="error"||w.status==="warning")f.writeFileSync(e.join(i,"WATCH.log"),u+`
+`),s||m("Contract issues detected \u2014 see inferno/WATCH.log");else{const p=e.join(i,"WATCH.log");f.existsSync(p)&&f.unlinkSync(p)}}}catch{}}async function U(t){const r=t.slice(1),i=r.includes("--dry-run"),o=r.includes("--silent"),s=r.indexOf("--interval"),g=((s!==-1?parseFloat(r[s+1]):3)||3)*1e3,c=process.cwd(),a=e.join(c,"inferno");f.existsSync(a)||(m("inferno/ not found. Run: infernoflow init"),process.exit(1));const u=r.filter(n=>!n.startsWith("-")&&n!==String(r[s+1])),p=(u.length?u.map(n=>e.resolve(c,n)):W(c)).filter(n=>f.existsSync(n));p.length||(m("No valid directories to watch."),process.exit(1)),o||(console.log(),console.log(`  ${x("\u{1F525} infernoflow watch")}  ${d("(Ctrl+C to stop)")}`),console.log(),p.forEach(n=>console.log(`  ${D("watching")} ${d(e.relative(c,n)||".")}`)),console.log(`  ${d(`debounce: ${g/1e3}s`)}`),console.log());let y=null;const S=new Set,C=n=>{k(n)&&(S.add(n),y&&clearTimeout(y),y=setTimeout(()=>{const l=Array.from(S);if(S.clear(),!o){const T=l.map(_=>e.relative(c,_)).slice(0,3).join(", ");process.stdout.write(`
+  ${d(new Date().toLocaleTimeString())}  ${x(T)}${l.length>3?` +${l.length-3} more`:""}  `)}const{relevant:v,reason:h}=A(l,a);if(!v){o||console.log(d(`skip (${h})`));return}N(l,c,a,i,o)},g))},j=[];for(const n of p)try{const l=f.watch(n,{recursive:!0},(v,h)=>{h&&C(e.join(n,h))});j.push(l)}catch(l){o||m(`Cannot watch ${n}: ${l.message}`)}j.length||(m("No directories could be watched."),process.exit(1)),process.on("SIGINT",()=>{j.forEach(n=>n.close()),o||(console.log(`
 
-import * as fs   from "node:fs";
-import * as path from "node:path";
-import { fileURLToPath } from "node:url";
-import { execSync, spawnSync } from "node:child_process";
-import { ok, warn, info, bold, cyan, gray, green, yellow } from "../ui/output.mjs";
-
-// ── Source file detection ─────────────────────────────────────────────────────
-
-const SOURCE_EXTS = new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".py", ".go", ".java", ".cs", ".rb", ".swift"]);
-const SKIP_DIRS   = new Set(["node_modules", ".git", "dist", "build", "out", ".next", ".angular", "vendor", "coverage", "__pycache__"]);
-
-function defaultWatchDirs(cwd) {
-  const candidates = ["src", "lib", "app", "pages", "components", "server", "api"];
-  const found = candidates.filter(d => fs.existsSync(path.join(cwd, d)));
-  return found.length ? found.map(d => path.join(cwd, d)) : [cwd];
-}
-
-function isSourceFile(filePath) {
-  return SOURCE_EXTS.has(path.extname(filePath).toLowerCase());
-}
-
-// ── Capability relevance check ────────────────────────────────────────────────
-
-function capabilityRelevance(changedFiles, infernoDir) {
-  const mapPath = path.join(infernoDir, "capability-map.json");
-  if (!fs.existsSync(mapPath)) return { relevant: true, reason: "no cap-map — suggesting broadly" };
-
-  let capMap;
-  try { capMap = JSON.parse(fs.readFileSync(mapPath, "utf8")); } catch { return { relevant: true, reason: "cap-map unreadable" }; }
-
-  const hits = [];
-  for (const file of changedFiles) {
-    const rel = path.relative(process.cwd(), file).replace(/\\/g, "/");
-    for (const [prefix, capIds] of Object.entries(capMap)) {
-      if (rel.startsWith(prefix.replace(/\\/g, "/"))) {
-        hits.push(...capIds);
-      }
-    }
-  }
-
-  if (hits.length > 0) return { relevant: true, reason: `touches: ${[...new Set(hits)].slice(0,3).join(", ")}` };
-  return { relevant: false, reason: "no mapped capabilities affected" };
-}
-
-// ── Run suggest + check ───────────────────────────────────────────────────────
-
-function runSuggest(changedFiles, cwd, infernoDir, dryRun, silent) {
-  const names = changedFiles.map(f => path.basename(f, path.extname(f))).slice(0, 3).join(", ");
-  const desc  = `code changes in ${names}`;
-
-  if (!silent) {
-    process.stdout.write(`  ${yellow("⟳")}  suggesting from ${bold(String(changedFiles.length))} changed file${changedFiles.length !== 1 ? "s" : ""}… `);
-  }
-
-  if (dryRun) {
-    if (!silent) console.log(gray("(dry run)"));
-    return;
-  }
-
-  try {
-    spawnSync(process.execPath, [
-      path.join(path.dirname(path.dirname(path.dirname(fileURLToPath(import.meta.url)))), "bin", "infernoflow.mjs"),
-      "suggest", desc, "--json"
-    ], { cwd, encoding: "utf8", timeout: 30_000, stdio: "ignore" });
-
-    if (!silent) console.log(green("done"));
-  } catch {
-    if (!silent) console.log(gray("skipped (no changes)"));
-  }
-
-  // Silent check — write issues to WATCH.log
-  try {
-    const result = spawnSync(process.execPath, [
-      path.join(path.dirname(path.dirname(path.dirname(fileURLToPath(import.meta.url)))), "bin", "infernoflow.mjs"),
-      "check", "--json"
-    ], { cwd, encoding: "utf8", timeout: 15_000 });
-
-    const out = result.stdout?.trim();
-    if (out) {
-      const data = JSON.parse(out);
-      if (data.status === "error" || data.status === "warning") {
-        fs.writeFileSync(path.join(infernoDir, "WATCH.log"), out + "\n");
-        if (!silent) warn(`Contract issues detected — see inferno/WATCH.log`);
-      } else {
-        const logPath = path.join(infernoDir, "WATCH.log");
-        if (fs.existsSync(logPath)) fs.unlinkSync(logPath);
-      }
-    }
-  } catch {}
-}
-
-// ── Watcher ───────────────────────────────────────────────────────────────────
-
-export async function watchCommand(rawArgs) {
-  const args       = rawArgs.slice(1);
-  const dryRun     = args.includes("--dry-run");
-  const silent     = args.includes("--silent");
-  const intervalIdx = args.indexOf("--interval");
-  const debounceMs = ((intervalIdx !== -1 ? parseFloat(args[intervalIdx + 1]) : 3) || 3) * 1000;
-  const cwd        = process.cwd();
-  const infernoDir = path.join(cwd, "inferno");
-
-  if (!fs.existsSync(infernoDir)) {
-    warn("inferno/ not found. Run: infernoflow init");
-    process.exit(1);
-  }
-
-  // Collect directories to watch
-  const dirArgs  = args.filter(a => !a.startsWith("-") && a !== String(args[intervalIdx + 1]));
-  const watchDirs = dirArgs.length
-    ? dirArgs.map(d => path.resolve(cwd, d))
-    : defaultWatchDirs(cwd);
-
-  const validDirs = watchDirs.filter(d => fs.existsSync(d));
-  if (!validDirs.length) {
-    warn("No valid directories to watch.");
-    process.exit(1);
-  }
-
-  if (!silent) {
-    console.log();
-    console.log(`  ${bold("🔥 infernoflow watch")}  ${gray("(Ctrl+C to stop)")}`);
-    console.log();
-    validDirs.forEach(d => console.log(`  ${cyan("watching")} ${gray(path.relative(cwd, d) || ".")}`));
-    console.log(`  ${gray(`debounce: ${debounceMs / 1000}s`)}`);
-    console.log();
-  }
-
-  let debounceTimer = null;
-  const pendingFiles = new Set();
-
-  const handleChange = (filePath) => {
-    if (!isSourceFile(filePath)) return;
-    pendingFiles.add(filePath);
-
-    if (debounceTimer) clearTimeout(debounceTimer);
-    debounceTimer = setTimeout(() => {
-      const changed = Array.from(pendingFiles);
-      pendingFiles.clear();
-
-      if (!silent) {
-        const names = changed.map(f => path.relative(cwd, f)).slice(0, 3).join(", ");
-        process.stdout.write(`\n  ${gray(new Date().toLocaleTimeString())}  ${bold(names)}${changed.length > 3 ? ` +${changed.length - 3} more` : ""}  `);
-      }
-
-      const { relevant, reason } = capabilityRelevance(changed, infernoDir);
-      if (!relevant) {
-        if (!silent) console.log(gray(`skip (${reason})`));
-        return;
-      }
-
-      runSuggest(changed, cwd, infernoDir, dryRun, silent);
-    }, debounceMs);
-  };
-
-  // Start watchers on each directory
-  const watchers = [];
-  for (const dir of validDirs) {
-    try {
-      const watcher = fs.watch(dir, { recursive: true }, (event, filename) => {
-        if (filename) handleChange(path.join(dir, filename));
-      });
-      watchers.push(watcher);
-    } catch (err) {
-      if (!silent) warn(`Cannot watch ${dir}: ${err.message}`);
-    }
-  }
-
-  if (!watchers.length) {
-    warn("No directories could be watched.");
-    process.exit(1);
-  }
-
-  // Keep alive
-  process.on("SIGINT", () => {
-    watchers.forEach(w => w.close());
-    if (!silent) { console.log("\n\n  Stopped."); console.log(); }
-    process.exit(0);
-  });
-
-  // Block forever
-  await new Promise(() => {});
-}
+  Stopped.`),console.log()),process.exit(0)}),await new Promise(()=>{})}export{U as watchCommand};

package/dist/lib/commands/why.mjs

@@ -1,358 +1,4 @@
-/**
- * infernoflow why
- *
- * Given a file path or function name — answer:
- *   • Which capability does this serve?
- *   • What is its stability level?
- *   • What scenarios cover it?
- *   • Who introduced it and when?
- *   • What does it call / what calls it?
- *
- * Pure correlation — no AI needed. Uses scan.json + graph.json + scenarios/ + git log.
- *
- * Usage:
- *   infernoflow why src/auth.ts
- *   infernoflow why loginUser
- *   infernoflow why src/auth.ts --function loginUser
- *   infernoflow why --json src/auth.ts
- */
-
-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";
-}
-
-// ── matchers ─────────────────────────────────────────────────────────────────
-
-/**
- * Given a target (file path or function name), find all matching
- * capabilities from scan.json.
- * Returns: [{ capId, capEntry, matchedVia, score }]
- */
-function findCapabilities(target, scanCaps, allCaps, cwd) {
-  const results = [];
-  const isFile  = target.includes("/") || target.includes("\\") || target.includes(".");
-  const relTarget = isFile ? path.relative(cwd, path.resolve(cwd, target)) : null;
-
-  for (const entry of scanCaps) {
-    const analysis = entry.codeAnalysis;
-    if (!analysis) continue;
-
-    const capFull = allCaps.find(c => c.id === entry.id) || {};
-
-    if (isFile) {
-      // Match by source file
-      const fileMatch = (analysis.sourceFiles || []).some(f =>
-        f === relTarget || f.endsWith(relTarget) || relTarget?.endsWith(f)
-      );
-      if (fileMatch) {
-        results.push({ capId: entry.id, capEntry: entry, capFull, matchedVia: "file", score: 1.0 });
-        continue;
-      }
-    }
-
-    if (!isFile) {
-      // Match by function name (exact or contains)
-      const fnMatch = (analysis.functions || []).some(fn =>
-        fn.toLowerCase() === target.toLowerCase() ||
-        fn.toLowerCase().includes(target.toLowerCase()) ||
-        target.toLowerCase().includes(fn.toLowerCase())
-      );
-      if (fnMatch) {
-        results.push({ capId: entry.id, capEntry: entry, capFull, matchedVia: "function", score: 1.0 });
-        continue;
-      }
-    }
-  }
-
-  return results;
-}
-
-// ── scenario finder ───────────────────────────────────────────────────────────
-
-function findScenarios(capId, infernoDir) {
-  const scenariosDir = path.join(infernoDir, "scenarios");
-  if (!fs.existsSync(scenariosDir)) return [];
-
-  const found = [];
-  for (const f of fs.readdirSync(scenariosDir)) {
-    if (!f.endsWith(".json")) continue;
-    try {
-      const s = JSON.parse(fs.readFileSync(path.join(scenariosDir, f), "utf8"));
-      const covered = s.capabilitiesCovered || s.capabilities || [];
-      if (covered.includes(capId) || covered.some(c =>
-        c.toLowerCase() === capId.toLowerCase()
-      )) {
-        found.push({ file: f, scenario: s });
-      }
-    } catch {}
-  }
-  return found;
-}
-
-// ── git history ───────────────────────────────────────────────────────────────
-
-function getGitHistory(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(),
-    };
-  });
-}
-
-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(),
-  };
-}
-
-// ── printer ───────────────────────────────────────────────────────────────────
-
-function printResult(result, scenarios, history, firstCommit, graph, allCaps, target) {
-  const { capId, capEntry, capFull, matchedVia } = result;
-  const level = stability(capFull);
-  const icon  = LEVEL_ICON[level]  || "🌊";
-  const color = LEVEL_COLOR[level] || green;
-
-  console.log();
-  console.log(bold(`  ${icon} ${color(capId)}`));
-  if (capFull.name || capFull.title) {
-    console.log(gray(`     ${capFull.name || capFull.title}`));
-  }
-  if (capFull.description) {
-    console.log(gray(`     ${capFull.description}`));
-  }
-  console.log();
-
-  // Matched via
-  console.log(gray(`  matched via:   `) + matchedVia + gray(` → `) + cyan(target));
-
-  // Stability
-  console.log(gray(`  stability:     `) + color(level));
-
-  // Source files
-  const files = capEntry.codeAnalysis?.sourceFiles || [];
-  if (files.length) {
-    console.log(gray(`  source files:  `) + files.join(", "));
-  }
-
-  // Functions
-  const fns = capEntry.codeAnalysis?.functions || [];
-  if (fns.length) {
-    console.log(gray(`  functions:     `) + fns.join(", "));
-  }
-
-  // External services
-  const services = capEntry.codeAnalysis?.services || [];
-  if (services.length) {
-    console.log(gray(`  uses:          `) + cyan(services.join(", ")));
-  }
-
-  // Throws
-  const throws = capEntry.codeAnalysis?.throws || [];
-  if (throws.length) {
-    console.log(gray(`  throws:        `) + yellow(throws.join(", ")));
-  }
-
-  // Dependencies from graph
-  if (graph) {
-    const deps      = graph.deps?.[capId]       || [];
-    const dependents = graph.dependents?.[capId] || [];
-    if (deps.length) {
-      console.log(gray(`  calls:         `) + deps.map(d => {
-        const dCap = allCaps.find(c => c.id === d);
-        const dIcon = LEVEL_ICON[stability(dCap)] || "🌊";
-        return `${dIcon} ${d}`;
-      }).join("  "));
-    }
-    if (dependents.length) {
-      console.log(gray(`  called by:     `) + dependents.map(d => {
-        const dCap = allCaps.find(c => c.id === d);
-        const dIcon = LEVEL_ICON[stability(dCap)] || "🌊";
-        return `${dIcon} ${d}`;
-      }).join("  "));
-    }
-  }
-
-  console.log();
-
-  // Scenarios
-  if (scenarios.length > 0) {
-    console.log(bold("  Scenarios that cover this capability:"));
-    for (const { scenario } of scenarios) {
-      const steps = scenario.steps?.length || 0;
-      console.log(`    ${green("✔")} ${scenario.scenarioId || scenario.description || scenario.file}`);
-      if (scenario.description) console.log(gray(`      ${scenario.description}`));
-      if (steps) console.log(gray(`      ${steps} step(s)`));
-    }
-    console.log();
-  } else {
-    console.log(yellow("  ⚠  No scenarios found for this capability."));
-    console.log(gray(`     Run: infernoflow suggest "add scenario for ${capId}"`));
-    console.log();
-  }
-
-  // Git history
-  if (firstCommit) {
-    console.log(bold("  Origin:"));
-    console.log(`    ${gray("first commit:")} ${firstCommit.hash} · ${firstCommit.date} · ${firstCommit.author}`);
-    console.log(`    ${gray("subject:")}      ${firstCommit.subject}`);
-    console.log();
-  }
-
-  if (history.length > 0) {
-    console.log(bold("  Recent changes:"));
-    for (const h of history.slice(0, 4)) {
-      console.log(`    ${gray(h.hash)} ${gray(h.date.padEnd(12))} ${h.subject}`);
-    }
-    console.log();
-  }
-
-  // Frozen warning
-  if (level === "frozen") {
-    console.log(red("  🧊 This capability is FROZEN — do not modify without explicit instruction."));
-    console.log();
-  }
-}
-
-// ── entry point ───────────────────────────────────────────────────────────────
-
-export async function whyCommand(rawArgs) {
-  const args     = (rawArgs || []).slice(1); // skip command name
-  const jsonMode = args.includes("--json");
-  const fnFlag   = args.indexOf("--function");
-  const fnFilter = fnFlag !== -1 ? args[fnFlag + 1] : null;
-
-  // Target: first non-flag argument (skip the value after --function if present)
-  const target = args.find((a, i) => !a.startsWith("--") && (fnFlag === -1 || i !== fnFlag + 1));
-
-  if (!target) {
-    console.error(red("✗ Usage: infernoflow why <file-or-function> [--function <name>] [--json]"));
-    console.error(gray("  Examples:"));
-    console.error(gray("    infernoflow why src/auth.ts"));
-    console.error(gray("    infernoflow why loginUser"));
-    process.exit(1);
-  }
-
-  const cwd        = process.cwd();
-  const infernoDir = path.join(cwd, "inferno");
-
-  // Load scan.json
-  const scan = loadJson(path.join(infernoDir, "scan.json"));
-  if (!scan) {
-    console.error(red("✗ inferno/scan.json not found — run `infernoflow scan` first."));
-    process.exit(1);
-  }
-
-  // Load capabilities.json for stability + metadata
-  let allCaps = [];
-  const rawCaps = loadJson(path.join(infernoDir, "capabilities.json"));
-  if (rawCaps) allCaps = Array.isArray(rawCaps) ? rawCaps : (rawCaps.capabilities || []);
-
-  // Load graph.json
-  const graph = loadJson(path.join(infernoDir, "graph.json"));
-
-  // Find capabilities
-  const scanCaps = scan.capabilities || [];
-  let results    = findCapabilities(target, scanCaps, allCaps, cwd);
-
-  // Apply --function filter
-  if (fnFilter && results.length > 1) {
-    results = results.filter(r =>
-      (r.capEntry.codeAnalysis?.functions || []).some(fn =>
-        fn.toLowerCase().includes(fnFilter.toLowerCase())
-      )
-    );
-  }
-
-  if (results.length === 0) {
-    console.log();
-    console.log(yellow(`  No capability found matching: ${bold(target)}`));
-    console.log(gray("  Tip: run `infernoflow scan` to update code analysis, then try again."));
-    console.log(gray("  Tip: use a function name or relative file path."));
-    console.log();
-    process.exit(0);
-  }
-
-  if (jsonMode) {
-    const out = results.map(r => {
-      const scenarios = findScenarios(r.capId, infernoDir);
-      const files     = r.capEntry.codeAnalysis?.sourceFiles || [];
-      const history   = getGitHistory(files[0], cwd);
-      const first     = getFirstCommit(files[0], cwd);
-      return {
-        capId:       r.capId,
-        name:        r.capFull.name || r.capFull.title,
-        stability:   stability(r.capFull),
-        matchedVia:  r.matchedVia,
-        sourceFiles: files,
-        functions:   r.capEntry.codeAnalysis?.functions || [],
-        services:    r.capEntry.codeAnalysis?.services  || [],
-        throws:      r.capEntry.codeAnalysis?.throws    || [],
-        deps:        graph?.deps?.[r.capId]        || [],
-        dependents:  graph?.dependents?.[r.capId]  || [],
-        scenarios:   scenarios.map(s => s.scenario?.scenarioId || s.file),
-        firstCommit: first,
-        recentHistory: history,
-      };
-    });
-    console.log(JSON.stringify(out, null, 2));
-    return;
-  }
-
-  console.log(gray(`\n  infernoflow why  →  ${bold(target)}`));
-  console.log(gray("  ──────────────────────────────────────────────────────────────"));
-
-  for (const result of results) {
-    const files     = result.capEntry.codeAnalysis?.sourceFiles || [];
-    const scenarios = findScenarios(result.capId, infernoDir);
-    const history   = getGitHistory(files[0], cwd);
-    const first     = getFirstCommit(files[0], cwd);
-    printResult(result, scenarios, history, first, graph, allCaps, target);
-  }
-}
+import*as F from"node:fs";import*as h from"node:path";import{execSync as W}from"node:child_process";import{bold as C,cyan as V,gray as n,green as x,yellow as I,red as L}from"../ui/output.mjs";function O(o){try{return JSON.parse(F.readFileSync(o,"utf8"))}catch{return null}}function D(o,t){try{return W(o,{cwd:t,encoding:"utf8",stdio:["pipe","pipe","pipe"]}).trim()}catch{return""}}const N={frozen:"\u{1F9CA}",stable:"\u3030\uFE0F ",experimental:"\u{1F30A}"},z={frozen:L,stable:I,experimental:x};function v(o){return o?.stability||"experimental"}function B(o,t,p,i){const c=[],l=o.includes("/")||o.includes("\\")||o.includes("."),r=l?h.relative(i,h.resolve(i,o)):null;for(const e of t){const d=e.codeAnalysis;if(!d)continue;const f=p.find(y=>y.id===e.id)||{};if(l&&(d.sourceFiles||[]).some(u=>u===r||u.endsWith(r)||r?.endsWith(u))){c.push({capId:e.id,capEntry:e,capFull:f,matchedVia:"file",score:1});continue}if(!l&&(d.functions||[]).some(u=>u.toLowerCase()===o.toLowerCase()||u.toLowerCase().includes(o.toLowerCase())||o.toLowerCase().includes(u.toLowerCase()))){c.push({capId:e.id,capEntry:e,capFull:f,matchedVia:"function",score:1});continue}}return c}function J(o,t){const p=h.join(t,"scenarios");if(!F.existsSync(p))return[];const i=[];for(const c of F.readdirSync(p))if(c.endsWith(".json"))try{const l=JSON.parse(F.readFileSync(h.join(p,c),"utf8")),r=l.capabilitiesCovered||l.capabilities||[];(r.includes(o)||r.some(e=>e.toLowerCase()===o.toLowerCase()))&&i.push({file:c,scenario:l})}catch{}return i}function M(o,t,p=5){if(!o)return[];const i=h.relative(t,h.resolve(t,o)),c=D(`git log --follow --format="%h|%aI|%ae|%s" -${p} -- ${JSON.stringify(i)}`,t);return c?c.split(`
+`).filter(Boolean).map(l=>{const[r,e,d,...f]=l.split("|");return{hash:r?.trim(),date:e?.trim()?new Date(e.trim()).toLocaleDateString():"",author:d?.trim(),subject:f.join("|").trim()}}):[]}function R(o,t){if(!o)return null;const p=h.relative(t,h.resolve(t,o)),i=D(`git log --follow --format="%h|%aI|%ae|%s" -- ${JSON.stringify(p)}`,t);if(!i)return null;const c=i.split(`
+`).filter(Boolean);if(!c.length)return null;const[l,r,e,...d]=c[c.length-1].split("|");return{hash:l?.trim(),date:r?.trim()?new Date(r.trim()).toLocaleDateString():"",author:e?.trim(),subject:d.join("|").trim()}}function G(o,t,p,i,c,l,r){const{capId:e,capEntry:d,capFull:f,matchedVia:y}=o,u=v(f),E=N[u]||"\u{1F30A}",m=z[u]||x;console.log(),console.log(C(`  ${E} ${m(e)}`)),(f.name||f.title)&&console.log(n(`     ${f.name||f.title}`)),f.description&&console.log(n(`     ${f.description}`)),console.log(),console.log(n("  matched via:   ")+y+n(" \u2192 ")+V(r)),console.log(n("  stability:     ")+m(u));const g=d.codeAnalysis?.sourceFiles||[];g.length&&console.log(n("  source files:  ")+g.join(", "));const s=d.codeAnalysis?.functions||[];s.length&&console.log(n("  functions:     ")+s.join(", "));const b=d.codeAnalysis?.services||[];b.length&&console.log(n("  uses:          ")+V(b.join(", ")));const w=d.codeAnalysis?.throws||[];if(w.length&&console.log(n("  throws:        ")+I(w.join(", "))),c){const a=c.deps?.[e]||[],$=c.dependents?.[e]||[];a.length&&console.log(n("  calls:         ")+a.map(j=>{const S=l.find(A=>A.id===j);return`${N[v(S)]||"\u{1F30A}"} ${j}`}).join("  ")),$.length&&console.log(n("  called by:     ")+$.map(j=>{const S=l.find(A=>A.id===j);return`${N[v(S)]||"\u{1F30A}"} ${j}`}).join("  "))}if(console.log(),t.length>0){console.log(C("  Scenarios that cover this capability:"));for(const{scenario:a}of t){const $=a.steps?.length||0;console.log(`    ${x("\u2714")} ${a.scenarioId||a.description||a.file}`),a.description&&console.log(n(`      ${a.description}`)),$&&console.log(n(`      ${$} step(s)`))}console.log()}else console.log(I("  \u26A0  No scenarios found for this capability.")),console.log(n(`     Run: infernoflow suggest "add scenario for ${e}"`)),console.log();if(i&&(console.log(C("  Origin:")),console.log(`    ${n("first commit:")} ${i.hash} \xB7 ${i.date} \xB7 ${i.author}`),console.log(`    ${n("subject:")}      ${i.subject}`),console.log()),p.length>0){console.log(C("  Recent changes:"));for(const a of p.slice(0,4))console.log(`    ${n(a.hash)} ${n(a.date.padEnd(12))} ${a.subject}`);console.log()}u==="frozen"&&(console.log(L("  \u{1F9CA} This capability is FROZEN \u2014 do not modify without explicit instruction.")),console.log())}async function _(o){const t=(o||[]).slice(1),p=t.includes("--json"),i=t.indexOf("--function"),c=i!==-1?t[i+1]:null,l=t.find((g,s)=>!g.startsWith("--")&&(i===-1||s!==i+1));l||(console.error(L("\u2717 Usage: infernoflow why <file-or-function> [--function <name>] [--json]")),console.error(n("  Examples:")),console.error(n("    infernoflow why src/auth.ts")),console.error(n("    infernoflow why loginUser")),process.exit(1));const r=process.cwd(),e=h.join(r,"inferno"),d=O(h.join(e,"scan.json"));d||(console.error(L("\u2717 inferno/scan.json not found \u2014 run `infernoflow scan` first.")),process.exit(1));let f=[];const y=O(h.join(e,"capabilities.json"));y&&(f=Array.isArray(y)?y:y.capabilities||[]);const u=O(h.join(e,"graph.json")),E=d.capabilities||[];let m=B(l,E,f,r);if(c&&m.length>1&&(m=m.filter(g=>(g.capEntry.codeAnalysis?.functions||[]).some(s=>s.toLowerCase().includes(c.toLowerCase())))),m.length===0&&(console.log(),console.log(I(`  No capability found matching: ${C(l)}`)),console.log(n("  Tip: run `infernoflow scan` to update code analysis, then try again.")),console.log(n("  Tip: use a function name or relative file path.")),console.log(),process.exit(0)),p){const g=m.map(s=>{const b=J(s.capId,e),w=s.capEntry.codeAnalysis?.sourceFiles||[],a=M(w[0],r),$=R(w[0],r);return{capId:s.capId,name:s.capFull.name||s.capFull.title,stability:v(s.capFull),matchedVia:s.matchedVia,sourceFiles:w,functions:s.capEntry.codeAnalysis?.functions||[],services:s.capEntry.codeAnalysis?.services||[],throws:s.capEntry.codeAnalysis?.throws||[],deps:u?.deps?.[s.capId]||[],dependents:u?.dependents?.[s.capId]||[],scenarios:b.map(j=>j.scenario?.scenarioId||j.file),firstCommit:$,recentHistory:a}});console.log(JSON.stringify(g,null,2));return}console.log(n(`
+  infernoflow why  \u2192  ${C(l)}`)),console.log(n("  \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"));for(const g of m){const s=g.capEntry.codeAnalysis?.sourceFiles||[],b=J(g.capId,e),w=M(s[0],r),a=R(s[0],r);G(g,b,w,a,u,f,l)}}export{_ as whyCommand};

package/dist/lib/cursorHooksInstall.mjs

@@ -1,60 +1 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { installInfernoDraftTooling } from "./draftToolingInstall.mjs";
-
-/**
- * @param {object} opts
- * @param {string} opts.cwd
- * @param {string} opts.templatesRoot
- * @param {boolean} opts.force
- * @param {boolean} opts.silent
- * @param {(msg: string) => void} [opts.logOk]
- * @param {(msg: string) => void} [opts.logWarn]
- */
-export function installCursorHooksArtifacts(opts) {
-  const { cwd, templatesRoot, force, silent } = opts;
-  const logOk = opts.logOk || (() => {});
-  const logWarn = opts.logWarn || (() => {});
-
-  function copyFile(src, dst) {
-    if (fs.existsSync(dst) && !force) {
-      if (!silent) logWarn("Skipped (exists): " + path.relative(cwd, dst));
-      return false;
-    }
-    fs.mkdirSync(path.dirname(dst), { recursive: true });
-    fs.copyFileSync(src, dst);
-    if (!silent) logOk("Created: " + path.relative(cwd, dst));
-    return true;
-  }
-
-  installInfernoDraftTooling({ cwd, templatesRoot, force, silent, logOk, logWarn });
-
-  const srcHooksJson = path.join(templatesRoot, "cursor", "hooks.json");
-  const dstHooksJson = path.join(cwd, ".cursor", "hooks.json");
-  const srcHook = path.join(templatesRoot, "cursor", "hooks", "inferno-session-draft.mjs");
-  const dstHook = path.join(cwd, ".cursor", "hooks", "inferno-session-draft.mjs");
-
-  copyFile(srcHooksJson, dstHooksJson);
-  copyFile(srcHook, dstHook);
-
-  // MCP server
-  const srcMcp = path.join(templatesRoot, "cursor", "inferno-mcp-server.mjs");
-  const dstMcp = path.join(cwd, "inferno-mcp-server.mjs");
-  copyFile(srcMcp, dstMcp);
-
-  // .cursor/mcp.json
-  const mcpJsonPath = path.join(cwd, ".cursor", "mcp.json");
-  if (!fs.existsSync(mcpJsonPath) || force) {
-    let existing = {};
-    if (fs.existsSync(mcpJsonPath)) {
-      try { existing = JSON.parse(fs.readFileSync(mcpJsonPath, "utf8")); } catch {}
-    }
-    if (!existing.mcpServers) existing.mcpServers = {};
-    existing.mcpServers.infernoflow = { command: "node", args: ["./inferno-mcp-server.mjs"], env: {} };
-    fs.mkdirSync(path.dirname(mcpJsonPath), { recursive: true });
-    fs.writeFileSync(mcpJsonPath, JSON.stringify(existing, null, 2), "utf8");
-    if (!silent) logOk("Created: .cursor/mcp.json");
-  } else {
-    if (!silent) logWarn("Skipped (exists): .cursor/mcp.json");
-  }
-}
+import*as r from"node:fs";import*as o from"node:path";import{installInfernoDraftTooling as v}from"./draftToolingInstall.mjs";function h(f){const{cwd:s,templatesRoot:t,force:m,silent:e}=f,a=f.logOk||(()=>{}),l=f.logWarn||(()=>{});function p(n,c){return r.existsSync(c)&&!m?(e||l("Skipped (exists): "+o.relative(s,c)),!1):(r.mkdirSync(o.dirname(c),{recursive:!0}),r.copyFileSync(n,c),e||a("Created: "+o.relative(s,c)),!0)}v({cwd:s,templatesRoot:t,force:m,silent:e,logOk:a,logWarn:l});const u=o.join(t,"cursor","hooks.json"),j=o.join(s,".cursor","hooks.json"),k=o.join(t,"cursor","hooks","inferno-session-draft.mjs"),S=o.join(s,".cursor","hooks","inferno-session-draft.mjs");p(u,j),p(k,S);const d=o.join(t,"cursor","inferno-mcp-server.mjs"),y=o.join(s,"inferno-mcp-server.mjs");p(d,y);const i=o.join(s,".cursor","mcp.json");if(!r.existsSync(i)||m){let n={};if(r.existsSync(i))try{n=JSON.parse(r.readFileSync(i,"utf8"))}catch{}n.mcpServers||(n.mcpServers={}),n.mcpServers.infernoflow={command:"node",args:["./inferno-mcp-server.mjs"],env:{}},r.mkdirSync(o.dirname(i),{recursive:!0}),r.writeFileSync(i,JSON.stringify(n,null,2),"utf8"),e||a("Created: .cursor/mcp.json")}else e||l("Skipped (exists): .cursor/mcp.json")}export{h as installCursorHooksArtifacts};