infernoflow 0.10.23 → 0.10.26

package/dist/lib/commands/init.mjs

@@ -1,17 +1,401 @@
-import*as c from"node:fs";import*as r from"node:path";import*as _ from"node:readline";import{fileURLToPath as K}from"node:url";import{header as M,ok as p,warn as O,done as Q,nextSteps as Y,cyan as l,yellow as x,gray as C}from"../ui/output.mjs";import{discoverProjectSignals as P,reviewCapabilitiesInteractive as ee,writeAdoptionBaseline as oe,buildAdoptionReport as ne,summarizeCapabilities as ie,buildSignalsReport as te}from"./adopt.mjs";import{installCursorHooksArtifacts as re}from"../cursorHooksInstall.mjs";import{installVsCodeCopilotHooksArtifacts as se}from"../vsCodeCopilotHooksInstall.mjs";const ae=r.dirname(K(import.meta.url));function ce(){return r.resolve(ae,"../../templates")}function S(e,o,n=""){return new Promise(i=>{const f=n?C(` (${n})`):"";e.question(`  ${o}${f}: `,d=>{i(d.trim()||n)})})}function L(e,...o){for(const n of o){const i=e.indexOf(n);if(i!==-1&&e[i+1]&&!e[i+1].startsWith("-"))return e[i+1]}return null}function T(e,o,n,i=!1){return c.existsSync(o)&&!n?(i||O("Skipped (exists): "+r.relative(process.cwd(),o)),!1):(c.mkdirSync(r.dirname(o),{recursive:!0}),c.copyFileSync(e,o),i||p("Created: "+l(r.relative(process.cwd(),o))),!0)}function le(e,o,n){c.mkdirSync(o,{recursive:!0});for(const i of c.readdirSync(e,{withFileTypes:!0})){const f=r.join(e,i.name),d=r.join(o,i.name);i.isDirectory()?le(f,d,n):T(f,d,n)}}function pe(e,o=!1){const n=r.join(e,"package.json");if(!c.existsSync(n))return;const i=JSON.parse(c.readFileSync(n,"utf8"));i.scripts=i.scripts||{};let f=!1;const d={"inferno:check":"infernoflow check","inferno:status":"infernoflow status","inferno:gate":"infernoflow doc-gate","inferno:impact":"infernoflow pr-impact --json","inferno:sync":"infernoflow sync --auto --json","inferno:run":'infernoflow run "sync check" --provider auto --json',"inferno:hooks":"node scripts/inferno-install-hooks.mjs"};for(const[y,F]of Object.entries(d))i.scripts[y]||(i.scripts[y]=F,f=!0);f&&(c.writeFileSync(n,JSON.stringify(i,null,2)+`
-`,"utf8"),o||p("Updated "+l("package.json")+" scripts"))}function fe(e){const o=r.join(e,"package.json");if(c.existsSync(o))try{const n=JSON.parse(c.readFileSync(o,"utf8"));if(n.name)return n.name.replace(/[^a-z0-9_-]/gi,"_")}catch{}return r.basename(e)}function de(e,o,n){const i={policyId:o,policyVersion:1,capabilities:n,rules:{docsRequiredOnCapabilityChange:!0,requireScenarioForEachCapability:!0,requireChangelogOnCapabilityChange:!0}};c.writeFileSync(e,JSON.stringify(i,null,2)+`
-`)}function ue(e,o){const n={schemaVersion:1,capabilities:o.map(i=>({id:i,title:i.replace(/([A-Z])/g," $1").trim(),since:"0.1.0"}))};c.writeFileSync(e,JSON.stringify(n,null,2)+`
-`)}function me(e,o){c.mkdirSync(e,{recursive:!0});const n={scenarioId:"happy_path",description:"Basic happy-path flow covering all capabilities",capabilitiesCovered:o,steps:o.map(i=>({action:i,expect:`${i} works as expected`}))};c.writeFileSync(r.join(e,"happy_path.json"),JSON.stringify(n,null,2)+`
-`)}function ye(e,o){const n=`# Changelog \u2014 ${o}
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as readline from "node:readline";
+import { fileURLToPath } from "node:url";
+import { header, ok, warn, done, nextSteps, cyan, yellow, gray } from "../ui/output.mjs";
+import {
+  discoverProjectSignals,
+  reviewCapabilitiesInteractive,
+  writeAdoptionBaseline,
+  buildAdoptionReport,
+  summarizeCapabilities,
+  buildSignalsReport,
+} from "./adopt.mjs";
+import { installCursorHooksArtifacts } from "../cursorHooksInstall.mjs";
+import { installVsCodeCopilotHooksArtifacts } from "../vsCodeCopilotHooksInstall.mjs";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+function getTemplatesRoot() {
+  return path.resolve(__dirname, "../../templates");
+}
+
+function ask(rl, question, defaultVal = "") {
+  return new Promise(resolve => {
+    const hint = defaultVal ? gray(` (${defaultVal})`) : "";
+    rl.question(`  ${question}${hint}: `, answer => {
+      resolve(answer.trim() || defaultVal);
+    });
+  });
+}
+
+function getArgValue(args, ...flags) {
+  for (const flag of flags) {
+    const i = args.indexOf(flag);
+    if (i !== -1 && args[i + 1] && !args[i + 1].startsWith("-")) return args[i + 1];
+  }
+  return null;
+}
+
+function copyFile(src, dst, force, silent = false) {
+  if (fs.existsSync(dst) && !force) {
+    if (!silent) warn("Skipped (exists): " + path.relative(process.cwd(), dst));
+    return false;
+  }
+  fs.mkdirSync(path.dirname(dst), { recursive: true });
+  fs.copyFileSync(src, dst);
+  if (!silent) ok("Created: " + cyan(path.relative(process.cwd(), dst)));
+  return true;
+}
+
+function copyDirDeep(srcDir, dstDir, force) {
+  fs.mkdirSync(dstDir, { recursive: true });
+  for (const entry of fs.readdirSync(srcDir, { withFileTypes: true })) {
+    const src = path.join(srcDir, entry.name);
+    const dst = path.join(dstDir, entry.name);
+    if (entry.isDirectory()) copyDirDeep(src, dst, force);
+    else copyFile(src, dst, force);
+  }
+}
+
+function upsertScripts(cwd, silent = false) {
+  const pkgPath = path.join(cwd, "package.json");
+  if (!fs.existsSync(pkgPath)) return;
+  const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+  pkg.scripts = pkg.scripts || {};
+  let changed = false;
+  const toAdd = {
+    "inferno:check":  "infernoflow check",
+    "inferno:status": "infernoflow status",
+    "inferno:gate":   "infernoflow doc-gate",
+    "inferno:impact": "infernoflow pr-impact --json",
+    "inferno:sync":   "infernoflow sync --auto --json",
+    "inferno:run":    "infernoflow run \"sync check\" --provider auto --json",
+    "inferno:hooks":  "node scripts/inferno-install-hooks.mjs"
+  };
+  for (const [k, v] of Object.entries(toAdd)) {
+    if (!pkg.scripts[k]) { pkg.scripts[k] = v; changed = true; }
+  }
+  if (changed) {
+    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf8");
+    if (!silent) ok("Updated " + cyan("package.json") + " scripts");
+  }
+}
+
+function detectProjectName(cwd) {
+  const pkgPath = path.join(cwd, "package.json");
+  if (fs.existsSync(pkgPath)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+      if (pkg.name) return pkg.name.replace(/[^a-z0-9_-]/gi, "_");
+    } catch {}
+  }
+  return path.basename(cwd);
+}
+
+function writeContract(contractPath, policyId, capabilities) {
+  const contract = {
+    policyId,
+    policyVersion: 1,
+    capabilities,
+    rules: {
+      docsRequiredOnCapabilityChange: true,
+      requireScenarioForEachCapability: true,
+      requireChangelogOnCapabilityChange: true
+    }
+  };
+  fs.writeFileSync(contractPath, JSON.stringify(contract, null, 2) + "\n");
+}
+
+function writeCapabilities(capsPath, capabilities) {
+  const registry = {
+    schemaVersion: 1,
+    capabilities: capabilities.map(id => ({
+      id,
+      title: id.replace(/([A-Z])/g, " $1").trim(),
+      since: "0.1.0"
+    }))
+  };
+  fs.writeFileSync(capsPath, JSON.stringify(registry, null, 2) + "\n");
+}
+
+function writeScenario(scenariosDir, capabilities) {
+  fs.mkdirSync(scenariosDir, { recursive: true });
+  const scenario = {
+    scenarioId: "happy_path",
+    description: "Basic happy-path flow covering all capabilities",
+    capabilitiesCovered: capabilities,
+    steps: capabilities.map(c => ({
+      action: c,
+      expect: `${c} works as expected`
+    }))
+  };
+  fs.writeFileSync(
+    path.join(scenariosDir, "happy_path.json"),
+    JSON.stringify(scenario, null, 2) + "\n"
+  );
+}
+
+function writeChangelog(changelogPath, policyId) {
+  const content = `# Changelog — ${policyId}
 
 ## Unreleased
 
 - Initial capabilities defined
 
-## 0.1.0 \u2014 Initial release
+## 0.1.0 — Initial release
 
 - Project initialized with infernoflow
-`;c.writeFileSync(e,n)}async function Ce(e){const o=process.cwd(),n=e.includes("--force")||e.includes("-f"),i=e.includes("--yes")||e.includes("-y"),f=e.includes("--adopt"),d=e.includes("--cursor-hooks"),y=e.includes("--vscode-copilot-hooks"),F=e.includes("--report-json"),v=e.includes("--report-json-only"),I=e.includes("--report-human-only"),N=L(e,"--lang"),R=L(e,"--framework"),A=L(e,"--project-type"),s=v;v&&I&&(console.error("Error: --report-json-only and --report-human-only cannot be used together."),process.exit(1)),s||M("init");const m=r.join(o,"inferno"),$=r.join(o,".github","workflows");c.existsSync(m)&&!n&&(s&&(console.log(JSON.stringify({ok:!1,error:"inferno_exists",hint:"Use --force to overwrite"},null,2)),process.exit(1)),O("inferno/ already exists. Use --force to overwrite."),console.log(),process.exit(0));const k=fe(o),E="CreateTask, ReadTasks, UpdateTask, ToggleComplete, DeleteTask";let j=k,g=E.split(",").map(a=>a.trim());if(f){let t=P(o,{language:N||void 0,framework:R||void 0,projectType:A||void 0});if(!i&&!v){const w=_.createInterface({input:process.stdin,output:process.stdout}),b=t.developmentProfile||{},J=b.detected||{};console.log(C(`  Review inferred development stack (press Enter to accept detected values)
-`));const V=await S(w,"Language",b.language||J.language||"unknown"),X=await S(w,"Framework",b.framework||J.framework||"unknown"),Z=await S(w,"Project type",b.projectType||J.projectType||"unknown");w.close(),t=P(o,{language:V,framework:X,projectType:Z})}const u=t.capabilities,H=ie(u);v?console.log(JSON.stringify({mode:"adopt",policyId:k,inferredCapabilities:H,components:t.components,displayFields:t.displayFields,externalLibraries:t.externalLibraries,uiLayout:t.uiLayout,styling:t.styling,developmentProfile:t.developmentProfile,apiCalls:t.apiCalls},null,2)):(console.log(),console.log(C(ne(u))),console.log(),console.log(C(te(t))),console.log(),F&&!I&&(console.log(JSON.stringify({mode:"adopt",policyId:k,inferredCapabilities:H,components:t.components,displayFields:t.displayFields,externalLibraries:t.externalLibraries,uiLayout:t.uiLayout,styling:t.styling,developmentProfile:t.developmentProfile,apiCalls:t.apiCalls},null,2)),console.log()));const B=await ee(u,i);j=k,g=B.map(w=>w.id)}else if(!i){const a=_.createInterface({input:process.stdin,output:process.stdout});console.log(C(`  Press Enter to accept defaults
-`)),j=await S(a,"Project / policy name",k),g=(await S(a,"Capabilities (comma-separated)",E)).split(",").map(u=>u.trim()).filter(Boolean),a.close(),console.log()}if(c.mkdirSync(m,{recursive:!0}),f){const a=g.map(u=>({id:u,title:u.replace(/([A-Z])/g," $1").trim()})),t=P(o,{language:N||void 0,framework:R||void 0,projectType:A||void 0});oe(m,j,a,t),s||(p("Created: "+l("inferno/contract.json")),p("Created: "+l("inferno/capabilities.json")),p("Created: "+l("inferno/scenarios/adoption_baseline.json")),p("Created: "+l("inferno/adoption_profile.json")),p("Created: "+l("inferno/CHANGELOG.md")))}else de(r.join(m,"contract.json"),j,g),s||p("Created: "+l("inferno/contract.json")),ue(r.join(m,"capabilities.json"),g),s||p("Created: "+l("inferno/capabilities.json")),me(r.join(m,"scenarios"),g),s||p("Created: "+l("inferno/scenarios/happy_path.json")),ye(r.join(m,"CHANGELOG.md"),j),s||p("Created: "+l("inferno/CHANGELOG.md"));const h=ce(),G=r.join(h,"scripts","inferno-doc-gate.mjs"),U=r.join(o,"scripts","inferno-doc-gate.mjs");T(G,U,n,s);const z=r.join(h,"scripts","inferno-install-hooks.mjs"),D=r.join(o,"scripts","inferno-install-hooks.mjs");T(z,D,n,s);const W=r.join(h,"ci","github-inferno-check.yml"),q=r.join($,"infernoflow-check.yml");if(T(W,q,n,s),pe(o,s),d&&re({cwd:o,templatesRoot:h,force:n,silent:s,logOk:a=>{s||p(a)},logWarn:a=>{s||O(a)}}),y&&se({cwd:o,templatesRoot:h,force:n,silent:s,logOk:a=>{s||p(a)},logWarn:a=>{s||O(a)}}),f){const a=r.join(m,"context-state.json");let t={};try{t=JSON.parse(c.readFileSync(a,"utf8"))}catch{}const u=P(o,{language:N||void 0,framework:R||void 0,projectType:A||void 0});t.stack=u.developmentProfile,c.writeFileSync(a,JSON.stringify(t,null,2)+`
-`,"utf8"),s||p("Created: "+l("inferno/context-state.json"))}s||(Q("infernoflow initialized!"),Y([l("infernoflow status")+"  \u2014 see your contract at a glance",l("infernoflow check")+"   \u2014 validate everything",(f?"Review inferred baseline in ":"Edit ")+x("inferno/capabilities.json")+(f?" and refine IDs/titles":" to describe each capability in detail"),"Add more "+x("inferno/scenarios/*.json")+" files for edge cases","Add "+l("inferno:check")+" to your CI pipeline",...d?["Restart Cursor \u2014 hooks write assistant text to "+x("inferno/CONTEXT.draft.md"),"Promote when ready: "+l("npm run inferno:promote-draft -- --append-notes")]:[],...y?["Restart VS Code \u2014 Copilot hooks append prompts + assistant (from transcript) to "+x("inferno/CONTEXT.draft.md"),"Promote when ready: "+l("npm run inferno:promote-draft -- --append-notes")]:[],...!d&&!y?["Optional: "+l("infernoflow install-cursor-hooks")+" or "+l("infernoflow install-vscode-copilot-hooks")]:[]]))}export{Ce as initCommand};
+`;
+  fs.writeFileSync(changelogPath, content);
+}
+
+export async function initCommand(args) {
+  const cwd = process.cwd();
+  const force = args.includes("--force") || args.includes("-f");
+  const yes = args.includes("--yes") || args.includes("-y");
+  const adopt = args.includes("--adopt");
+  const cursorHooks = args.includes("--cursor-hooks");
+  const vscodeCopilotHooks = args.includes("--vscode-copilot-hooks");
+  const reportJson = args.includes("--report-json");
+  const reportJsonOnly = args.includes("--report-json-only");
+  const reportHumanOnly = args.includes("--report-human-only");
+  const langOverride = getArgValue(args, "--lang");
+  const frameworkOverride = getArgValue(args, "--framework");
+  const projectTypeOverride = getArgValue(args, "--project-type");
+  const silent = reportJsonOnly;
+
+  if (reportJsonOnly && reportHumanOnly) {
+    console.error("Error: --report-json-only and --report-human-only cannot be used together.");
+    process.exit(1);
+  }
+
+  if (!silent) {
+    header("init");
+  }
+
+  const infernoDir = path.join(cwd, "inferno");
+  const workflowsDir = path.join(cwd, ".github", "workflows");
+  if (fs.existsSync(infernoDir) && !force) {
+    if (silent) {
+      console.log(JSON.stringify({ ok: false, error: "inferno_exists", hint: "Use --force to overwrite" }, null, 2));
+      process.exit(1);
+    }
+    warn("inferno/ already exists. Use --force to overwrite.");
+    console.log();
+    process.exit(0);
+  }
+
+  const detectedName = detectProjectName(cwd);
+  const defaultCaps = "CreateTask, ReadTasks, UpdateTask, ToggleComplete, DeleteTask";
+
+  let policyId = detectedName;
+  let capabilities = defaultCaps.split(",").map(c => c.trim());
+
+  if (adopt) {
+    const profileOverrides = {
+      language: langOverride || undefined,
+      framework: frameworkOverride || undefined,
+      projectType: projectTypeOverride || undefined,
+    };
+    let signals = discoverProjectSignals(cwd, profileOverrides);
+    if (!yes && !reportJsonOnly) {
+      const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+      const profile = signals.developmentProfile || {};
+      const detected = profile.detected || {};
+      console.log(gray("  Review inferred development stack (press Enter to accept detected values)\n"));
+      const language = await ask(rl, "Language", profile.language || detected.language || "unknown");
+      const framework = await ask(rl, "Framework", profile.framework || detected.framework || "unknown");
+      const projectType = await ask(rl, "Project type", profile.projectType || detected.projectType || "unknown");
+      rl.close();
+      signals = discoverProjectSignals(cwd, { language, framework, projectType });
+    }
+    const inferred = signals.capabilities;
+    const summarized = summarizeCapabilities(inferred);
+    if (reportJsonOnly) {
+      console.log(
+        JSON.stringify(
+          {
+            mode: "adopt",
+            policyId: detectedName,
+            inferredCapabilities: summarized,
+            components: signals.components,
+            displayFields: signals.displayFields,
+            externalLibraries: signals.externalLibraries,
+            uiLayout: signals.uiLayout,
+            styling: signals.styling,
+            developmentProfile: signals.developmentProfile,
+            apiCalls: signals.apiCalls,
+          },
+          null,
+          2
+        )
+      );
+    } else {
+      console.log();
+      console.log(gray(buildAdoptionReport(inferred)));
+      console.log();
+      console.log(gray(buildSignalsReport(signals)));
+      console.log();
+      if (reportJson && !reportHumanOnly) {
+        console.log(
+          JSON.stringify(
+            {
+              mode: "adopt",
+              policyId: detectedName,
+              inferredCapabilities: summarized,
+              components: signals.components,
+              displayFields: signals.displayFields,
+              externalLibraries: signals.externalLibraries,
+              uiLayout: signals.uiLayout,
+              styling: signals.styling,
+              developmentProfile: signals.developmentProfile,
+              apiCalls: signals.apiCalls,
+            },
+            null,
+            2
+          )
+        );
+        console.log();
+      }
+    }
+    const reviewed = await reviewCapabilitiesInteractive(inferred, yes);
+    policyId = detectedName;
+    capabilities = reviewed.map((c) => c.id);
+  } else if (!yes) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    console.log(gray("  Press Enter to accept defaults\n"));
+    policyId = await ask(rl, "Project / policy name", detectedName);
+    const capsRaw = await ask(rl, "Capabilities (comma-separated)", defaultCaps);
+    capabilities = capsRaw.split(",").map(c => c.trim()).filter(Boolean);
+    rl.close();
+    console.log();
+  }
+
+  // Write files
+  fs.mkdirSync(infernoDir, { recursive: true });
+
+  if (adopt) {
+    const capDetails = capabilities.map((id) => ({
+      id,
+      title: id.replace(/([A-Z])/g, " $1").trim(),
+    }));
+    const signals = discoverProjectSignals(cwd, {
+      language: langOverride || undefined,
+      framework: frameworkOverride || undefined,
+      projectType: projectTypeOverride || undefined,
+    });
+    writeAdoptionBaseline(infernoDir, policyId, capDetails, signals);
+    if (!silent) {
+      ok("Created: " + cyan("inferno/contract.json"));
+      ok("Created: " + cyan("inferno/capabilities.json"));
+      ok("Created: " + cyan("inferno/scenarios/adoption_baseline.json"));
+      ok("Created: " + cyan("inferno/adoption_profile.json"));
+      ok("Created: " + cyan("inferno/CHANGELOG.md"));
+    }
+  } else {
+    writeContract(path.join(infernoDir, "contract.json"), policyId, capabilities);
+    if (!silent) ok("Created: " + cyan("inferno/contract.json"));
+
+    writeCapabilities(path.join(infernoDir, "capabilities.json"), capabilities);
+    if (!silent) ok("Created: " + cyan("inferno/capabilities.json"));
+
+    writeScenario(path.join(infernoDir, "scenarios"), capabilities);
+    if (!silent) ok("Created: " + cyan("inferno/scenarios/happy_path.json"));
+
+    writeChangelog(path.join(infernoDir, "CHANGELOG.md"), policyId);
+    if (!silent) ok("Created: " + cyan("inferno/CHANGELOG.md"));
+  }
+
+  // Copy doc-gate script
+  const templates = getTemplatesRoot();
+  const srcScript = path.join(templates, "scripts", "inferno-doc-gate.mjs");
+  const dstScript = path.join(cwd, "scripts", "inferno-doc-gate.mjs");
+  copyFile(srcScript, dstScript, force, silent);
+  const srcHookScript = path.join(templates, "scripts", "inferno-install-hooks.mjs");
+  const dstHookScript = path.join(cwd, "scripts", "inferno-install-hooks.mjs");
+  copyFile(srcHookScript, dstHookScript, force, silent);
+  const srcWorkflow = path.join(templates, "ci", "github-inferno-check.yml");
+  const dstWorkflow = path.join(workflowsDir, "infernoflow-check.yml");
+  copyFile(srcWorkflow, dstWorkflow, force, silent);
+
+  upsertScripts(cwd, silent);
+
+  if (cursorHooks) {
+    installCursorHooksArtifacts({
+      cwd,
+      templatesRoot: templates,
+      force,
+      silent,
+      logOk: (msg) => {
+        if (!silent) ok(msg);
+      },
+      logWarn: (msg) => {
+        if (!silent) warn(msg);
+      },
+    });
+  }
+  if (vscodeCopilotHooks) {
+    installVsCodeCopilotHooksArtifacts({
+      cwd,
+      templatesRoot: templates,
+      force,
+      silent,
+      logOk: (msg) => {
+        if (!silent) ok(msg);
+      },
+      logWarn: (msg) => {
+        if (!silent) warn(msg);
+      },
+    });
+  }
+
+  if (adopt) {
+    const statePath = path.join(infernoDir, "context-state.json");
+    let state = {};
+    try {
+      state = JSON.parse(fs.readFileSync(statePath, "utf8"));
+    } catch {}
+    const signals = discoverProjectSignals(cwd, {
+      language: langOverride || undefined,
+      framework: frameworkOverride || undefined,
+      projectType: projectTypeOverride || undefined,
+    });
+    state.stack = signals.developmentProfile;
+    fs.writeFileSync(statePath, JSON.stringify(state, null, 2) + "\n", "utf8");
+    if (!silent) ok("Created: " + cyan("inferno/context-state.json"));
+  }
+
+  if (!silent) {
+    done("infernoflow initialized!");
+
+    nextSteps([
+      cyan("infernoflow status") + "  — see your contract at a glance",
+      cyan("infernoflow check") + "   — validate everything",
+      (adopt ? "Review inferred baseline in " : "Edit ") + yellow("inferno/capabilities.json") + (adopt ? " and refine IDs/titles" : " to describe each capability in detail"),
+      "Add more " + yellow("inferno/scenarios/*.json") + " files for edge cases",
+      "Add " + cyan("inferno:check") + " to your CI pipeline",
+      ...(cursorHooks
+        ? [
+            "Restart Cursor — hooks write assistant text to " + yellow("inferno/CONTEXT.draft.md"),
+            "Promote when ready: " + cyan("npm run inferno:promote-draft -- --append-notes"),
+          ]
+        : []),
+      ...(vscodeCopilotHooks
+        ? [
+            "Restart VS Code — Copilot hooks append prompts + assistant (from transcript) to " +
+              yellow("inferno/CONTEXT.draft.md"),
+            "Promote when ready: " + cyan("npm run inferno:promote-draft -- --append-notes"),
+          ]
+        : []),
+      ...(!cursorHooks && !vscodeCopilotHooks
+        ? [
+            "Optional: " +
+              cyan("infernoflow install-cursor-hooks") +
+              " or " +
+              cyan("infernoflow install-vscode-copilot-hooks"),
+          ]
+        : []),
+    ]);
+  }
+}

package/dist/lib/commands/installCursorHooks.mjs

@@ -1 +1,36 @@
-import*as t from"node:path";import{fileURLToPath as i}from"node:url";import{header as d,ok as m,warn as p,done as l,nextSteps as f,cyan as r,yellow as n}from"../ui/output.mjs";import{installCursorHooksArtifacts as c}from"../cursorHooksInstall.mjs";const u=t.dirname(i(import.meta.url));function h(){return t.resolve(u,"../../templates")}async function g(e){const s=process.cwd(),a=e.includes("--force")||e.includes("-f");d("install-cursor-hooks"),c({cwd:s,templatesRoot:h(),force:a,silent:!1,logOk:o=>m(o),logWarn:o=>p(o)}),l("Cursor draft hooks installed"),f(["Restart Cursor (or reload window) so "+n(".cursor/hooks.json")+" is picked up","Use Agent chat \u2014 each assistant reply appends to "+n("inferno/CONTEXT.draft.md")+" (gitignored)",r("npm run inferno:promote-draft")+" \u2014 preview draft",r("npm run inferno:promote-draft -- --append-notes")+" \u2014 merge into inferno/CONTEXT.md under Decisions",r("npm run inferno:promote-draft -- --clear")+" \u2014 discard draft"])}export{g as installCursorHooksCommand};
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { header, ok, warn, done, nextSteps, cyan, yellow } from "../ui/output.mjs";
+import { installCursorHooksArtifacts } from "../cursorHooksInstall.mjs";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+function getTemplatesRoot() {
+  return path.resolve(__dirname, "../../templates");
+}
+
+export async function installCursorHooksCommand(args) {
+  const cwd = process.cwd();
+  const force = args.includes("--force") || args.includes("-f");
+
+  header("install-cursor-hooks");
+
+  installCursorHooksArtifacts({
+    cwd,
+    templatesRoot: getTemplatesRoot(),
+    force,
+    silent: false,
+    logOk: (msg) => ok(msg),
+    logWarn: (msg) => warn(msg),
+  });
+
+  done("Cursor draft hooks installed");
+
+  nextSteps([
+    "Restart Cursor (or reload window) so " + yellow(".cursor/hooks.json") + " is picked up",
+    "Use Agent chat — each assistant reply appends to " + yellow("inferno/CONTEXT.draft.md") + " (gitignored)",
+    cyan("npm run inferno:promote-draft") + " — preview draft",
+    cyan("npm run inferno:promote-draft -- --append-notes") + " — merge into inferno/CONTEXT.md under Decisions",
+    cyan("npm run inferno:promote-draft -- --clear") + " — discard draft",
+  ]);
+}

package/dist/lib/commands/installVsCodeCopilotHooks.mjs

@@ -1 +1,37 @@
-import*as e from"node:path";import{fileURLToPath as a}from"node:url";import{header as l,ok as d,warn as p,done as m,nextSteps as c,cyan as n,yellow as r}from"../ui/output.mjs";import{installVsCodeCopilotHooksArtifacts as f}from"../vsCodeCopilotHooksInstall.mjs";const u=e.dirname(a(import.meta.url));function h(){return e.resolve(u,"../../templates")}async function g(t){const s=process.cwd(),i=t.includes("--force")||t.includes("-f");l("install-vscode-copilot-hooks"),f({cwd:s,templatesRoot:h(),force:i,silent:!1,logOk:o=>d(o),logWarn:o=>p(o)}),m("VS Code / Copilot draft hooks installed"),c(["Requires VS Code + GitHub Copilot and **Agent hooks (Preview)** \u2014 see "+r("https://code.visualstudio.com/docs/copilot/customization/hooks"),"Hooks load from "+r(".github/hooks/*.json")+" \u2014 restart VS Code or reload window after first install","Check the **GitHub Copilot Chat Hooks** output channel if nothing runs",n("npm run inferno:promote-draft")+" \u2014 preview draft",n("npm run inferno:promote-draft -- --append-notes")+" \u2014 merge into inferno/CONTEXT.md"])}export{g as installVsCodeCopilotHooksCommand};
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { header, ok, warn, done, nextSteps, cyan, yellow } from "../ui/output.mjs";
+import { installVsCodeCopilotHooksArtifacts } from "../vsCodeCopilotHooksInstall.mjs";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+function getTemplatesRoot() {
+  return path.resolve(__dirname, "../../templates");
+}
+
+export async function installVsCodeCopilotHooksCommand(args) {
+  const cwd = process.cwd();
+  const force = args.includes("--force") || args.includes("-f");
+
+  header("install-vscode-copilot-hooks");
+
+  installVsCodeCopilotHooksArtifacts({
+    cwd,
+    templatesRoot: getTemplatesRoot(),
+    force,
+    silent: false,
+    logOk: (msg) => ok(msg),
+    logWarn: (msg) => warn(msg),
+  });
+
+  done("VS Code / Copilot draft hooks installed");
+
+  nextSteps([
+    "Requires VS Code + GitHub Copilot and **Agent hooks (Preview)** — see " +
+      yellow("https://code.visualstudio.com/docs/copilot/customization/hooks"),
+    "Hooks load from " + yellow(".github/hooks/*.json") + " — restart VS Code or reload window after first install",
+    "Check the **GitHub Copilot Chat Hooks** output channel if nothing runs",
+    cyan("npm run inferno:promote-draft") + " — preview draft",
+    cyan("npm run inferno:promote-draft -- --append-notes") + " — merge into inferno/CONTEXT.md",
+  ]);
+}

package/dist/lib/commands/prImpact.mjs

@@ -1,2 +1,157 @@
-import{execSync as k}from"node:child_process";import*as S from"node:fs";import*as m from"node:path";import{header as w,section as y,ok as d,warn as E,fail as N,gray as $,cyan as g,yellow as _}from"../ui/output.mjs";const D=["src/","frontend/","backend/","app/","pages/","components/","lib/","api/","server/","Controllers/"];function A(n){return k(n,{stdio:["ignore","pipe","pipe"]}).toString("utf8").trim()}function I(n,t=null){try{return JSON.parse(S.readFileSync(n,"utf8"))}catch{return t}}function F(n,t=""){try{return S.readFileSync(n,"utf8")}catch{return t}}function H(n,t){const a=A(n&&t?`git diff --name-only ${n}..${t}`:"git diff --name-only HEAD");return a?a.split(`
-`).map(r=>r.trim()).filter(Boolean):[]}function O(n){const t=m.join(n,"inferno"),a=I(m.join(t,"contract.json"),{capabilities:[]}),r=I(m.join(t,"capabilities.json"),{capabilities:[]}),c=new Map((r.capabilities||[]).map(e=>[e.id,e.title||e.id]));return(a.capabilities||[]).map(e=>{const i=c.get(e)||e,l=new Set(`${e} ${i}`.replace(/([A-Z])/g," $1").toLowerCase().split(/[^a-z0-9]+/).filter(s=>s.length>=4));return{id:e,title:i,keywords:Array.from(l)}})}function R(n,t){const a=O(n),r=[];for(const c of a){const e=[];for(const i of t){const l=m.join(n,i),s=F(l,"").toLowerCase();s&&c.keywords.some(f=>s.includes(f))&&e.push(i)}e.length&&r.push({id:c.id,title:c.title,matchedFiles:e.slice(0,5)})}return r}async function x(n=[]){const t=n.includes("--json"),a=process.cwd(),r=process.env.BASE_SHA||null,c=process.env.HEAD_SHA||null;let e=[];try{e=H(r,c)}catch{const o={ok:!0,skipped:!0,reason:"no_git_available"};if(t){console.log(JSON.stringify(o,null,2));return}w("pr-impact"),E("git not available; cannot compute PR impact"),console.log();return}const i=e.filter(o=>D.some(C=>o.startsWith(C))),l=e.filter(o=>o.startsWith("inferno/")),s=R(a,i),f=i.length>0,h=f&&l.length===0,b=s.length>0?"high":f?"medium":"low",p=[];f&&p.push("CODE_CHANGED"),h&&p.push("INFERNO_NOT_UPDATED"),s.length>0&&p.push("CAPABILITY_HINT_MATCH"),p.length||p.push("NO_BEHAVIOR_SIGNAL");const u={ok:!h,base:r||"HEAD",head:c||"WORKTREE",changedFiles:e,changedCodeFiles:i,changedInfernoFiles:l,inferredBehaviorChange:f,impactedCapabilities:s,confidence:b,reasonCodes:p,recommendations:h?['Run infernoflow suggest "describe behavior change" and update inferno/',"Run infernoflow check --json"]:["Run infernoflow check --json to validate final state"]};t&&(console.log(JSON.stringify(u,null,2)),process.exit(u.ok?0:1)),w("pr-impact"),y("Diff Scope"),d(`Changed files: ${g(String(e.length))}`),d(`Code files: ${g(String(i.length))}`),d(`Inferno files: ${g(String(l.length))}`),y("Capability Impact"),s.length===0?E("No capability hints matched changed code files"):s.forEach(o=>{console.log(`  ${g("\u2022")} ${o.id} ${$(`(${o.title})`)}`),o.matchedFiles.slice(0,3).forEach(C=>console.log(`      ${$("- "+C)}`))}),y("Doc Sync"),h?N("Code changed but inferno/ was not updated","Run infernoflow suggest and then infernoflow check"):d("No immediate inferno drift signal from changed files"),d(`Confidence: ${g(b)}`),y("Suggested Next"),u.recommendations.forEach(o=>console.log(`  ${_("\u2192")} ${o}`)),console.log(),process.exit(u.ok?0:1)}export{x as prImpactCommand};
+import { execSync } from "node:child_process";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { header, section, ok, warn, fail, gray, cyan, yellow } from "../ui/output.mjs";
+
+const CODE_PREFIXES = ["src/", "frontend/", "backend/", "app/", "pages/", "components/", "lib/", "api/", "server/", "Controllers/"];
+
+function sh(cmd) {
+  return execSync(cmd, { stdio: ["ignore", "pipe", "pipe"] }).toString("utf8").trim();
+}
+
+function readJson(filePath, fallback = null) {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, "utf8"));
+  } catch {
+    return fallback;
+  }
+}
+
+function readFile(filePath, fallback = "") {
+  try {
+    return fs.readFileSync(filePath, "utf8");
+  } catch {
+    return fallback;
+  }
+}
+
+function getChangedFiles(base, head) {
+  const out = base && head
+    ? sh(`git diff --name-only ${base}..${head}`)
+    : sh("git diff --name-only HEAD");
+  return out ? out.split("\n").map((s) => s.trim()).filter(Boolean) : [];
+}
+
+function buildCapabilityHints(cwd) {
+  const infernoDir = path.join(cwd, "inferno");
+  const contract = readJson(path.join(infernoDir, "contract.json"), { capabilities: [] });
+  const registry = readJson(path.join(infernoDir, "capabilities.json"), { capabilities: [] });
+  const titleById = new Map((registry.capabilities || []).map((c) => [c.id, c.title || c.id]));
+  return (contract.capabilities || []).map((id) => {
+    const title = titleById.get(id) || id;
+    const keywords = new Set(
+      `${id} ${title}`
+        .replace(/([A-Z])/g, " $1")
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((k) => k.length >= 4)
+    );
+    return { id, title, keywords: Array.from(keywords) };
+  });
+}
+
+function inferImpactedCapabilities(cwd, changedCodeFiles) {
+  const hints = buildCapabilityHints(cwd);
+  const impacted = [];
+  for (const hint of hints) {
+    const matched = [];
+    for (const rel of changedCodeFiles) {
+      const abs = path.join(cwd, rel);
+      const text = readFile(abs, "").toLowerCase();
+      if (!text) continue;
+      if (hint.keywords.some((k) => text.includes(k))) {
+        matched.push(rel);
+      }
+    }
+    if (matched.length) {
+      impacted.push({ id: hint.id, title: hint.title, matchedFiles: matched.slice(0, 5) });
+    }
+  }
+  return impacted;
+}
+
+export async function prImpactCommand(args = []) {
+  const asJson = args.includes("--json");
+  const cwd = process.cwd();
+  const base = process.env.BASE_SHA || null;
+  const head = process.env.HEAD_SHA || null;
+
+  let changedFiles = [];
+  try {
+    changedFiles = getChangedFiles(base, head);
+  } catch {
+    const payload = { ok: true, skipped: true, reason: "no_git_available" };
+    if (asJson) {
+      console.log(JSON.stringify(payload, null, 2));
+      return;
+    }
+    header("pr-impact");
+    warn("git not available; cannot compute PR impact");
+    console.log();
+    return;
+  }
+
+  const changedCodeFiles = changedFiles.filter((f) => CODE_PREFIXES.some((p) => f.startsWith(p)));
+  const changedInfernoFiles = changedFiles.filter((f) => f.startsWith("inferno/"));
+  const impactedCapabilities = inferImpactedCapabilities(cwd, changedCodeFiles);
+  const inferredBehaviorChange = changedCodeFiles.length > 0;
+  const missingInfernoUpdate = inferredBehaviorChange && changedInfernoFiles.length === 0;
+  const confidence = impactedCapabilities.length > 0 ? "high" : inferredBehaviorChange ? "medium" : "low";
+  const reasonCodes = [];
+  if (inferredBehaviorChange) reasonCodes.push("CODE_CHANGED");
+  if (missingInfernoUpdate) reasonCodes.push("INFERNO_NOT_UPDATED");
+  if (impactedCapabilities.length > 0) reasonCodes.push("CAPABILITY_HINT_MATCH");
+  if (!reasonCodes.length) reasonCodes.push("NO_BEHAVIOR_SIGNAL");
+
+  const payload = {
+    ok: !missingInfernoUpdate,
+    base: base || "HEAD",
+    head: head || "WORKTREE",
+    changedFiles,
+    changedCodeFiles,
+    changedInfernoFiles,
+    inferredBehaviorChange,
+    impactedCapabilities,
+    confidence,
+    reasonCodes,
+    recommendations: missingInfernoUpdate
+      ? ["Run infernoflow suggest \"describe behavior change\" and update inferno/", "Run infernoflow check --json"]
+      : ["Run infernoflow check --json to validate final state"],
+  };
+
+  if (asJson) {
+    console.log(JSON.stringify(payload, null, 2));
+    process.exit(payload.ok ? 0 : 1);
+  }
+
+  header("pr-impact");
+
+  section("Diff Scope");
+  ok(`Changed files: ${cyan(String(changedFiles.length))}`);
+  ok(`Code files: ${cyan(String(changedCodeFiles.length))}`);
+  ok(`Inferno files: ${cyan(String(changedInfernoFiles.length))}`);
+
+  section("Capability Impact");
+  if (impactedCapabilities.length === 0) {
+    warn("No capability hints matched changed code files");
+  } else {
+    impactedCapabilities.forEach((c) => {
+      console.log(`  ${cyan("•")} ${c.id} ${gray(`(${c.title})`)}`);
+      c.matchedFiles.slice(0, 3).forEach((f) => console.log(`      ${gray("- " + f)}`));
+    });
+  }
+
+  section("Doc Sync");
+  if (missingInfernoUpdate) {
+    fail("Code changed but inferno/ was not updated", "Run infernoflow suggest and then infernoflow check");
+  } else {
+    ok("No immediate inferno drift signal from changed files");
+  }
+  ok(`Confidence: ${cyan(confidence)}`);
+
+  section("Suggested Next");
+  payload.recommendations.forEach((r) => console.log(`  ${yellow("→")} ${r}`));
+  console.log();
+  process.exit(payload.ok ? 0 : 1);
+}
+