infernoflow 0.33.0 → 0.34.0

package/dist/lib/commands/diff.mjs

@@ -1,5 +1,274 @@
-import*as u from"node:fs";import*as v from"node:path";import{execSync as C}from"node:child_process";import{header as N,ok as J,fail as m,bold as d,cyan as k,gray as c,green as $,red as y,yellow as x}from"../ui/output.mjs";function h(n,e){try{return C(n,{cwd:e,encoding:"utf8",stdio:["ignore","pipe","pipe"]}).trim()}catch{return null}}function D(n){const e=h("git describe --tags --abbrev=0",n);return e||null}function j(n,e,o){return h(`git show "${n}:${e}"`,o)}function z(n){return h("git rev-parse --abbrev-ref HEAD",n)||"HEAD"}function O(n,e){const o=h(`git log -1 --format=%ci "${e}"`,n),t=o?o.slice(0,10):null;return t?`${e}  ${c("("+t+")")}`:e}function b(n){if(!n)return null;try{return(JSON.parse(n).capabilities||[]).map(t=>typeof t=="string"?{id:t,title:t}:{id:t.id||t,title:t.title||t.id||String(t),since:t.since,status:t.status})}catch{return null}}function _(n,e,o){const t=j(n,`${e}/capabilities.json`,o);if(t)return b(t);const g=j(n,`${e}/contract.json`,o);return b(g)}function E(n){const e=v.join(n,"capabilities.json"),o=v.join(n,"contract.json");return u.existsSync(e)?b(u.readFileSync(e,"utf8")):u.existsSync(o)?b(u.readFileSync(o,"utf8")):null}function R(n,e){const o=new Map(n.map(i=>[i.id,i])),t=new Map(e.map(i=>[i.id,i])),g=e.filter(i=>!o.has(i.id)),s=n.filter(i=>!t.has(i.id)),l=[];for(const i of e){const f=o.get(i.id);if(!f)continue;const a=[];f.title!==i.title&&a.push({field:"title",from:f.title,to:i.title}),f.status!==i.status&&(f.status||i.status)&&a.push({field:"status",from:f.status||"\u2014",to:i.status||"\u2014"}),a.length&&l.push({id:i.id,changes:a})}return{added:g,removed:s,changed:l}}function H(n){if(n.length){console.log(`
-  ${d($("+ Added"))}  ${c("("+n.length+")")}`);for(const e of n){const o=e.since?c("  since "+e.since):"";console.log(`    ${$("+")} ${d(e.id)}  ${c(e.title)}${o}`)}}}function M(n){if(n.length){console.log(`
-  ${d(y("- Removed"))}  ${c("("+n.length+")")}`);for(const e of n)console.log(`    ${y("-")} ${d(e.id)}  ${c(e.title)}`)}}function F(n){if(n.length){console.log(`
-  ${d(x("~ Changed"))}  ${c("("+n.length+")")}`);for(const e of n){console.log(`    ${x("~")} ${d(e.id)}`);for(const o of e.changes)console.log(`        ${c(o.field+":")}  ${y(o.from)}  \u2192  ${$(o.to)}`)}}}function U(n){n!==0&&console.log(`
-  ${c("  Unchanged  "+n)}`)}function w(n,e){const o=[];n.added.length&&o.push($("+"+n.added.length+" added")),n.removed.length&&o.push(y("-"+n.removed.length+" removed")),n.changed.length&&o.push(x("~"+n.changed.length+" changed")),o.length||o.push(c("no changes")),console.log(`  ${o.join("  ")}  ${c("vs "+e)}`)}async function G(n){const e=n.slice(1),o=e.includes("--json"),t=e.includes("--summary"),g=e.indexOf("--ref");let s=g!==-1?e[g+1]:null;const l=process.cwd(),i=v.join(l,"inferno"),f="inferno";o||N("diff"),u.existsSync(i)||(o&&(console.log(JSON.stringify({ok:!1,error:"inferno_not_found"})),process.exit(1)),m("inferno/ not found","Run: infernoflow init"),process.exit(1)),s||(s=D(l),s||(h("git rev-parse HEAD~1",l)?s="HEAD~1":(o&&(console.log(JSON.stringify({ok:!1,error:"no_ref",hint:"No git tags found and no parent commit. Use --ref <commit>"})),process.exit(1)),m("No git tags found","Create a tag first: git tag v0.1.0  or use --ref <commit>"),process.exit(1))));const a=E(i);a||(o&&(console.log(JSON.stringify({ok:!1,error:"no_capabilities_found"})),process.exit(1)),m("No capabilities.json or contract.json found in inferno/"),process.exit(1));const p=_(s,f,l);p||(o&&(console.log(JSON.stringify({ok:!1,error:"ref_not_found",ref:s,hint:"Does inferno/capabilities.json exist at that ref?"})),process.exit(1)),m(`Could not read capabilities at ${s}`,"The inferno/ directory may not exist at that ref"),process.exit(1));const r=R(p,a),S=a.length-r.added.length-r.changed.length;if(o){console.log(JSON.stringify({ok:!0,ref:s,current:a.length,previous:p.length,added:r.added,removed:r.removed,changed:r.changed,unchanged:S},null,2));return}const A=O(l,s);if(console.log(),console.log(`  Comparing ${d(k("current"))}  vs  ${d(A)}`),console.log(`  ${c(a.length+" capabilities now  /  "+p.length+" before")}`),t){w(r,s),console.log();return}if(!(r.added.length||r.removed.length||r.changed.length)){console.log(),J("No capability changes since "+s),console.log();return}H(r.added),M(r.removed),F(r.changed),U(S),console.log(),w(r,s),console.log()}export{G as diffCommand};
+/**
+ * infernoflow diff
+ *
+ * Compare capabilities between the current working tree and a git ref.
+ * Defaults to the most recent git tag; falls back to HEAD~1 if no tags exist.
+ *
+ * Usage:
+ *   infernoflow diff                  # vs last tag
+ *   infernoflow diff --ref v0.10.18   # vs specific tag / commit
+ *   infernoflow diff --ref HEAD~5     # vs 5 commits ago
+ *   infernoflow diff --json           # machine-readable output
+ *   infernoflow diff --summary        # one-liner count only
+ */
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { execSync } from "node:child_process";
+import { header, ok, fail, warn, info, bold, cyan, gray, green, red, yellow } from "../ui/output.mjs";
+
+// ── git helpers ──────────────────────────────────────────────────────────────
+
+function capture(cmd, cwd) {
+  try {
+    return execSync(cmd, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }).trim();
+  } catch {
+    return null;
+  }
+}
+
+function lastTag(cwd) {
+  // Try to find the most recent reachable tag
+  const tag = capture("git describe --tags --abbrev=0", cwd);
+  if (tag) return tag;
+  return null;
+}
+
+function fileAtRef(ref, relPath, cwd) {
+  // Returns file content at a git ref, or null if not found
+  const content = capture(`git show "${ref}:${relPath}"`, cwd);
+  return content;
+}
+
+function currentBranch(cwd) {
+  return capture("git rev-parse --abbrev-ref HEAD", cwd) || "HEAD";
+}
+
+function refDescription(cwd, ref) {
+  // Human label: "v0.10.18 (2026-04-10)" or "HEAD~1"
+  const date = capture(`git log -1 --format=%ci "${ref}"`, cwd);
+  const short = date ? date.slice(0, 10) : null;
+  return short ? `${ref}  ${gray("(" + short + ")")}` : ref;
+}
+
+// ── capability helpers ───────────────────────────────────────────────────────
+
+function parseCaps(jsonText) {
+  // Accepts capabilities.json OR contract.json — both have a "capabilities" array
+  if (!jsonText) return null;
+  try {
+    const obj = JSON.parse(jsonText);
+    const raw = obj.capabilities || [];
+    // capabilities.json: array of objects { id, title, ... }
+    // contract.json: array of id strings
+    return raw.map(c => {
+      if (typeof c === "string") return { id: c, title: c };
+      return { id: c.id || c, title: c.title || c.id || String(c), since: c.since, status: c.status };
+    });
+  } catch {
+    return null;
+  }
+}
+
+function loadCapsAtRef(ref, infernoRelDir, cwd) {
+  // Try capabilities.json first, fall back to contract.json
+  const capsJson = fileAtRef(ref, `${infernoRelDir}/capabilities.json`, cwd);
+  if (capsJson) return parseCaps(capsJson);
+  const contractJson = fileAtRef(ref, `${infernoRelDir}/contract.json`, cwd);
+  return parseCaps(contractJson);
+}
+
+function loadCapsFromDisk(infernoDir) {
+  const capsPath = path.join(infernoDir, "capabilities.json");
+  const contractPath = path.join(infernoDir, "contract.json");
+  if (fs.existsSync(capsPath)) {
+    return parseCaps(fs.readFileSync(capsPath, "utf8"));
+  }
+  if (fs.existsSync(contractPath)) {
+    return parseCaps(fs.readFileSync(contractPath, "utf8"));
+  }
+  return null;
+}
+
+// ── diff logic ───────────────────────────────────────────────────────────────
+
+function diffCaps(before, after) {
+  const beforeMap = new Map(before.map(c => [c.id, c]));
+  const afterMap  = new Map(after.map(c  => [c.id, c]));
+
+  const added   = after.filter(c  => !beforeMap.has(c.id));
+  const removed = before.filter(c => !afterMap.has(c.id));
+
+  const changed = [];
+  for (const c of after) {
+    const old = beforeMap.get(c.id);
+    if (!old) continue;
+    const changes = [];
+    if (old.title !== c.title) changes.push({ field: "title", from: old.title, to: c.title });
+    if (old.status !== c.status && (old.status || c.status)) changes.push({ field: "status", from: old.status || "—", to: c.status || "—" });
+    if (changes.length) changed.push({ id: c.id, changes });
+  }
+
+  return { added, removed, changed };
+}
+
+// ── rendering ────────────────────────────────────────────────────────────────
+
+function renderAdded(caps) {
+  if (!caps.length) return;
+  console.log(`\n  ${bold(green("+ Added"))}  ${gray("(" + caps.length + ")")}`);
+  for (const c of caps) {
+    const since = c.since ? gray("  since " + c.since) : "";
+    console.log(`    ${green("+")} ${bold(c.id)}  ${gray(c.title)}${since}`);
+  }
+}
+
+function renderRemoved(caps) {
+  if (!caps.length) return;
+  console.log(`\n  ${bold(red("- Removed"))}  ${gray("(" + caps.length + ")")}`);
+  for (const c of caps) {
+    console.log(`    ${red("-")} ${bold(c.id)}  ${gray(c.title)}`);
+  }
+}
+
+function renderChanged(items) {
+  if (!items.length) return;
+  console.log(`\n  ${bold(yellow("~ Changed"))}  ${gray("(" + items.length + ")")}`);
+  for (const item of items) {
+    console.log(`    ${yellow("~")} ${bold(item.id)}`);
+    for (const ch of item.changes) {
+      console.log(`        ${gray(ch.field + ":")}  ${red(ch.from)}  →  ${green(ch.to)}`);
+    }
+  }
+}
+
+function renderUnchanged(count) {
+  if (count === 0) return;
+  console.log(`\n  ${gray("  Unchanged  " + count)}`);
+}
+
+function renderSummaryLine(result, refLabel) {
+  const parts = [];
+  if (result.added.length)   parts.push(green("+" + result.added.length + " added"));
+  if (result.removed.length) parts.push(red("-" + result.removed.length + " removed"));
+  if (result.changed.length) parts.push(yellow("~" + result.changed.length + " changed"));
+  if (!parts.length)         parts.push(gray("no changes"));
+  console.log(`  ${parts.join("  ")}  ${gray("vs " + refLabel)}`);
+}
+
+// ── main ─────────────────────────────────────────────────────────────────────
+
+export async function diffCommand(rawArgs) {
+  const args = rawArgs.slice(1);
+
+  const asJson   = args.includes("--json");
+  const summary  = args.includes("--summary");
+
+  const refIdx = args.indexOf("--ref");
+  let ref = refIdx !== -1 ? args[refIdx + 1] : null;
+
+  const cwd       = process.cwd();
+  const infernoDir = path.join(cwd, "inferno");
+  const infernoRelDir = "inferno"; // relative for git show
+
+  if (!asJson) header("diff");
+
+  // ── Validate inferno/ exists ─────────────────────────────────────────────
+  if (!fs.existsSync(infernoDir)) {
+    if (asJson) {
+      console.log(JSON.stringify({ ok: false, error: "inferno_not_found" }));
+      process.exit(1);
+    }
+    fail("inferno/ not found", "Run: infernoflow init");
+    process.exit(1);
+  }
+
+  // ── Resolve ref ──────────────────────────────────────────────────────────
+  if (!ref) {
+    ref = lastTag(cwd);
+    if (!ref) {
+      // No tags — fall back to HEAD~1
+      const parentExists = capture("git rev-parse HEAD~1", cwd);
+      if (parentExists) {
+        ref = "HEAD~1";
+      } else {
+        if (asJson) {
+          console.log(JSON.stringify({ ok: false, error: "no_ref", hint: "No git tags found and no parent commit. Use --ref <commit>" }));
+          process.exit(1);
+        }
+        fail("No git tags found", "Create a tag first: git tag v0.1.0  or use --ref <commit>");
+        process.exit(1);
+      }
+    }
+  }
+
+  // ── Load capabilities ────────────────────────────────────────────────────
+  const current = loadCapsFromDisk(infernoDir);
+  if (!current) {
+    if (asJson) {
+      console.log(JSON.stringify({ ok: false, error: "no_capabilities_found" }));
+      process.exit(1);
+    }
+    fail("No capabilities.json or contract.json found in inferno/");
+    process.exit(1);
+  }
+
+  const previous = loadCapsAtRef(ref, infernoRelDir, cwd);
+  if (!previous) {
+    if (asJson) {
+      console.log(JSON.stringify({ ok: false, error: "ref_not_found", ref, hint: "Does inferno/capabilities.json exist at that ref?" }));
+      process.exit(1);
+    }
+    fail(`Could not read capabilities at ${ref}`, "The inferno/ directory may not exist at that ref");
+    process.exit(1);
+  }
+
+  // ── Compute diff ─────────────────────────────────────────────────────────
+  const result = diffCaps(previous, current);
+  const unchanged = current.length - result.added.length - result.changed.length;
+
+  // ── JSON output ──────────────────────────────────────────────────────────
+  if (asJson) {
+    console.log(JSON.stringify({
+      ok: true,
+      ref,
+      current: current.length,
+      previous: previous.length,
+      added:   result.added,
+      removed: result.removed,
+      changed: result.changed,
+      unchanged,
+    }, null, 2));
+    return;
+  }
+
+  // ── Human output ─────────────────────────────────────────────────────────
+  const refLabel = refDescription(cwd, ref);
+  console.log();
+  console.log(`  Comparing ${bold(cyan("current"))}  vs  ${bold(refLabel)}`);
+  console.log(`  ${gray(current.length + " capabilities now  /  " + previous.length + " before")}`);
+
+  if (summary) {
+    renderSummaryLine(result, ref);
+    console.log();
+    return;
+  }
+
+  const hasAny = result.added.length || result.removed.length || result.changed.length;
+
+  if (!hasAny) {
+    console.log();
+    ok("No capability changes since " + ref);
+    console.log();
+    return;
+  }
+
+  renderAdded(result.added);
+  renderRemoved(result.removed);
+  renderChanged(result.changed);
+  renderUnchanged(unchanged);
+
+  console.log();
+  renderSummaryLine(result, ref);
+  console.log();
+}

package/dist/lib/commands/docGate.mjs

@@ -1,2 +1,81 @@
-import{execSync as m}from"node:child_process";import{ok as f,fail as E,info as y,gray as d}from"../ui/output.mjs";function S(n){return m(n,{stdio:["ignore","pipe","pipe"]}).toString("utf8").trim()}const g=["src/","frontend/","backend/","app/","pages/","components/","Controllers/","Services/","Endpoints/","lib/","api/","server/"];async function C(n={}){const a=Array.isArray(n),t=a?!1:n?.silent||!1,p=a?!1:n?.captureExit||!1,l=a?n.includes("--json"):!!n?.json,u=process.env.BASE_SHA||"HEAD~1",h=process.env.HEAD_SHA||"HEAD";let o=[];try{const e=S(`git diff --name-only ${u}..${h}`);o=e?e.split(`
-`).filter(Boolean):[]}catch{if(l){console.log(JSON.stringify({ok:!0,skipped:!0,reason:"no_git_available"},null,2));return}t||y(d("doc-gate skipped (no git available)"));return}if(o.length===0){if(l){console.log(JSON.stringify({ok:!0,changedFiles:0,changedCode:!1,changedInferno:!1},null,2));return}t||f("doc-gate: no changed files");return}const i=o.some(e=>g.some(r=>e.startsWith(r)||e.includes("/"+r))),s=o.some(e=>e.startsWith("inferno/")),c=o.filter(e=>g.some(r=>e.startsWith(r))).slice(0,5);if(l){const e={ok:!(i&&!s),changedFiles:o.length,changedCode:i,changedInferno:s,sampleCodeFiles:c,hint:i&&!s?"Update at least one file in inferno/ before committing":null};console.log(JSON.stringify(e,null,2)),e.ok||process.exit(1);return}if(i&&!s){if(t||(E("Code changed but inferno/ was NOT updated","Update at least one file in inferno/ before committing"),c.length&&(console.log(),c.forEach(e=>console.log("      "+d("\u2022 "+e))))),p)throw new Error("doc-gate failed");process.exit(1)}t||f("doc-gate: docs are up to date")}export{C as docGateCommand};
+import { execSync } from "node:child_process";
+import { ok, fail, warn, info, gray } from "../ui/output.mjs";
+
+function sh(cmd) {
+  return execSync(cmd, { stdio: ["ignore", "pipe", "pipe"] }).toString("utf8").trim();
+}
+
+const CODE_PREFIXES = [
+  "src/", "frontend/", "backend/",
+  "app/", "pages/", "components/",
+  "Controllers/", "Services/", "Endpoints/",
+  "lib/", "api/", "server/"
+];
+
+export async function docGateCommand(opts = {}) {
+  const fromArgs = Array.isArray(opts);
+  const silent = fromArgs ? false : (opts?.silent || false);
+  const captureExit = fromArgs ? false : (opts?.captureExit || false);
+  const jsonOut = fromArgs ? opts.includes("--json") : Boolean(opts?.json);
+  const base = process.env.BASE_SHA || "HEAD~1";
+  const head = process.env.HEAD_SHA || "HEAD";
+
+  let files = [];
+  try {
+    const out = sh(`git diff --name-only ${base}..${head}`);
+    files = out ? out.split("\n").filter(Boolean) : [];
+  } catch {
+    if (jsonOut) {
+      console.log(JSON.stringify({ ok: true, skipped: true, reason: "no_git_available" }, null, 2));
+      return;
+    }
+    if (!silent) info(gray("doc-gate skipped (no git available)"));
+    return;
+  }
+
+  if (files.length === 0) {
+    if (jsonOut) {
+      console.log(JSON.stringify({ ok: true, changedFiles: 0, changedCode: false, changedInferno: false }, null, 2));
+      return;
+    }
+    if (!silent) ok("doc-gate: no changed files");
+    return;
+  }
+
+  const changedCode = files.some(f =>
+    CODE_PREFIXES.some(p => f.startsWith(p) || f.includes("/" + p))
+  );
+  const changedInferno = files.some(f => f.startsWith("inferno/"));
+  const codeFiles = files.filter(f => CODE_PREFIXES.some(p => f.startsWith(p))).slice(0, 5);
+
+  if (jsonOut) {
+    const payload = {
+      ok: !(changedCode && !changedInferno),
+      changedFiles: files.length,
+      changedCode,
+      changedInferno,
+      sampleCodeFiles: codeFiles,
+      hint: changedCode && !changedInferno ? "Update at least one file in inferno/ before committing" : null,
+    };
+    console.log(JSON.stringify(payload, null, 2));
+    if (!payload.ok) process.exit(1);
+    return;
+  }
+
+  if (changedCode && !changedInferno) {
+    if (!silent) {
+      fail(
+        "Code changed but inferno/ was NOT updated",
+        "Update at least one file in inferno/ before committing"
+      );
+      if (codeFiles.length) {
+        console.log();
+        codeFiles.forEach(f => console.log("      " + gray("• " + f)));
+      }
+    }
+    if (captureExit) throw new Error("doc-gate failed");
+    process.exit(1);
+  }
+
+  if (!silent) ok("doc-gate: docs are up to date");
+}