infernoflow 0.12.0 → 0.14.0

package/dist/lib/commands/prComment.mjs

@@ -0,0 +1,361 @@
+/**
+ * infernoflow pr-comment
+ *
+ * Posts a capability drift analysis as a GitHub PR comment.
+ * Designed to run in CI (GitHub Actions) on pull_request events.
+ *
+ * Auto-reads context from GitHub Actions environment variables:
+ *   GITHUB_TOKEN        — required for posting comments
+ *   GITHUB_REPOSITORY   — e.g. "owner/repo"
+ *   GITHUB_EVENT_PATH   — path to the event JSON (contains PR number)
+ *   GITHUB_SHA          — current commit SHA
+ *   GITHUB_BASE_REF     — base branch name (e.g. "main")
+ *
+ * Usage:
+ *   infernoflow pr-comment                  # auto-detect from CI env
+ *   infernoflow pr-comment --pr 42          # explicit PR number
+ *   infernoflow pr-comment --repo owner/r   # explicit repo
+ *   infernoflow pr-comment --token ghp_...  # explicit token
+ *   infernoflow pr-comment --dry-run        # print comment without posting
+ *   infernoflow pr-comment --json           # machine-readable result
+ */
+
+import * as fs   from "node:fs";
+import * as path from "node:path";
+import * as https from "node:https";
+import { execSync } from "node:child_process";
+import { header, ok, warn, info, done, 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) {
+  return capture("git describe --tags --abbrev=0", cwd) || null;
+}
+
+function fileAtRef(ref, relPath, cwd) {
+  return capture(`git show "${ref}:${relPath}"`, cwd);
+}
+
+// ── capability helpers ────────────────────────────────────────────────────────
+
+function parseCaps(jsonText) {
+  if (!jsonText) return null;
+  try {
+    const obj = JSON.parse(jsonText);
+    const raw = obj.capabilities || [];
+    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), status: c.status };
+    });
+  } catch { return null; }
+}
+
+function loadCapsFromDisk(infernoDir) {
+  for (const name of ["capabilities.json", "contract.json"]) {
+    const p = path.join(infernoDir, name);
+    if (fs.existsSync(p)) return parseCaps(fs.readFileSync(p, "utf8"));
+  }
+  return null;
+}
+
+function loadCapsAtRef(ref, cwd) {
+  for (const name of ["capabilities.json", "contract.json"]) {
+    const content = fileAtRef(ref, `inferno/${name}`, cwd);
+    if (content) return parseCaps(content);
+  }
+  return null;
+}
+
+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 || "")) changes.push({ field: "status", from: old.status || "—", to: c.status || "—" });
+    if (changes.length) changed.push({ id: c.id, changes });
+  }
+  return { added, removed, changed };
+}
+
+function classifyBump(diff) {
+  if (diff.removed.length > 0) return "major";
+  if (diff.added.length   > 0) return "minor";
+  if (diff.changed.length > 0) return "patch";
+  return "none";
+}
+
+// ── comment builder ───────────────────────────────────────────────────────────
+
+function buildComment(diff, bump, ref, currentVersion, nextVersion) {
+  const lines = [];
+
+  // Header
+  const bumpEmoji = bump === "major" ? "🔴" : bump === "minor" ? "🟡" : bump === "patch" ? "🟢" : "✅";
+  const bumpLabel = bump === "none" ? "No capability changes" : `${bump.toUpperCase()} bump recommended`;
+  lines.push(`## 🔥 infernoflow — Capability Analysis`);
+  lines.push(``);
+  lines.push(`${bumpEmoji} **${bumpLabel}**${bump !== "none" ? ` · \`${currentVersion}\` → \`${nextVersion}\`` : ""}`);
+  lines.push(``);
+
+  // Summary table
+  const hasChanges = diff.added.length || diff.removed.length || diff.changed.length;
+  if (!hasChanges) {
+    lines.push(`> No capability changes detected since \`${ref}\`. Contract is in sync.`);
+  } else {
+    lines.push(`| Change | Count |`);
+    lines.push(`|--------|-------|`);
+    if (diff.added.length)   lines.push(`| ➕ Added    | ${diff.added.length} |`);
+    if (diff.removed.length) lines.push(`| ❌ Removed  | ${diff.removed.length} |`);
+    if (diff.changed.length) lines.push(`| ✏️ Modified | ${diff.changed.length} |`);
+    lines.push(``);
+
+    // Detail sections
+    if (diff.added.length) {
+      lines.push(`<details><summary>➕ Added capabilities (${diff.added.length})</summary>`);
+      lines.push(``);
+      for (const c of diff.added) lines.push(`- \`${c.id}\` — ${c.title}`);
+      lines.push(``);
+      lines.push(`</details>`);
+      lines.push(``);
+    }
+
+    if (diff.removed.length) {
+      lines.push(`<details><summary>❌ Removed capabilities (${diff.removed.length}) — breaking change</summary>`);
+      lines.push(``);
+      for (const c of diff.removed) lines.push(`- \`${c.id}\` — ${c.title}`);
+      lines.push(``);
+      lines.push(`</details>`);
+      lines.push(``);
+    }
+
+    if (diff.changed.length) {
+      lines.push(`<details><summary>✏️ Modified capabilities (${diff.changed.length})</summary>`);
+      lines.push(``);
+      for (const item of diff.changed) {
+        lines.push(`- \`${item.id}\``);
+        for (const ch of item.changes) lines.push(`  - ${ch.field}: \`${ch.from}\` → \`${ch.to}\``);
+      }
+      lines.push(``);
+      lines.push(`</details>`);
+      lines.push(``);
+    }
+  }
+
+  // Bump recommendation
+  if (bump === "major") {
+    lines.push(`> ⚠️ **Breaking change detected.** Capabilities were removed. Consider a major version bump.`);
+    lines.push(`> Run \`infernoflow version --apply\` to update \`package.json\`.`);
+  } else if (bump === "minor") {
+    lines.push(`> ℹ️ New capabilities added. A minor version bump is recommended.`);
+    lines.push(`> Run \`infernoflow version --apply\` to update \`package.json\`.`);
+  }
+
+  lines.push(``);
+  lines.push(`---`);
+  lines.push(`<sub>Generated by [infernoflow](https://github.com/ronmiz/infernoflow) · compared against \`${ref}\`</sub>`);
+
+  return lines.join("\n");
+}
+
+// ── GitHub API ────────────────────────────────────────────────────────────────
+
+function githubRequest(method, pathname, body, token) {
+  return new Promise((resolve, reject) => {
+    const data = body ? JSON.stringify(body) : null;
+    const req = https.request({
+      hostname: "api.github.com",
+      path: pathname,
+      method,
+      headers: {
+        "Authorization": `Bearer ${token}`,
+        "Accept": "application/vnd.github+json",
+        "Content-Type": "application/json",
+        "User-Agent": "infernoflow-cli",
+        ...(data ? { "Content-Length": Buffer.byteLength(data) } : {}),
+      },
+    }, (res) => {
+      let raw = "";
+      res.on("data", chunk => raw += chunk);
+      res.on("end", () => {
+        try { resolve({ status: res.statusCode, body: JSON.parse(raw) }); }
+        catch { resolve({ status: res.statusCode, body: raw }); }
+      });
+    });
+    req.on("error", reject);
+    if (data) req.write(data);
+    req.end();
+  });
+}
+
+async function findExistingComment(repo, prNumber, token) {
+  // Look for a previous infernoflow comment to update instead of creating a new one
+  const res = await githubRequest("GET", `/repos/${repo}/issues/${prNumber}/comments?per_page=100`, null, token);
+  if (res.status !== 200 || !Array.isArray(res.body)) return null;
+  return res.body.find(c => c.body && c.body.includes("🔥 infernoflow — Capability Analysis")) || null;
+}
+
+async function postComment(repo, prNumber, body, token) {
+  // Update existing comment if found (avoids spam on multiple pushes)
+  const existing = await findExistingComment(repo, prNumber, token);
+  if (existing) {
+    return githubRequest("PATCH", `/repos/${repo}/issues/comments/${existing.id}`, { body }, token);
+  }
+  return githubRequest("POST", `/repos/${repo}/issues/${prNumber}/comments`, { body }, token);
+}
+
+// ── env helpers ───────────────────────────────────────────────────────────────
+
+function readGithubEventPr() {
+  const eventPath = process.env.GITHUB_EVENT_PATH;
+  if (!eventPath || !fs.existsSync(eventPath)) return null;
+  try {
+    const event = JSON.parse(fs.readFileSync(eventPath, "utf8"));
+    return event.pull_request?.number || event.number || null;
+  } catch { return null; }
+}
+
+function applyBump(version, type) {
+  const parts = (version || "0.0.0").split(".").map(Number);
+  if (type === "major") { parts[0]++; parts[1] = 0; parts[2] = 0; }
+  else if (type === "minor") { parts[1]++; parts[2] = 0; }
+  else if (type === "patch") { parts[2]++; }
+  return parts.join(".");
+}
+
+function readPackageVersion(cwd) {
+  const p = path.join(cwd, "package.json");
+  if (!fs.existsSync(p)) return "0.0.0";
+  try { return JSON.parse(fs.readFileSync(p, "utf8")).version || "0.0.0"; } catch { return "0.0.0"; }
+}
+
+// ── main ──────────────────────────────────────────────────────────────────────
+
+export async function prCommentCommand(rawArgs) {
+  const args   = rawArgs.slice(1);
+  const dryRun = args.includes("--dry-run");
+  const asJson = args.includes("--json");
+
+  const prIdx    = args.indexOf("--pr");
+  const repoIdx  = args.indexOf("--repo");
+  const tokenIdx = args.indexOf("--token");
+  const refIdx   = args.indexOf("--ref");
+
+  const cwd = process.cwd();
+  const infernoDir = path.join(cwd, "inferno");
+
+  if (!asJson) header("infernoflow pr-comment");
+
+  // ── Resolve inputs ────────────────────────────────────────────────────────
+  const token    = tokenIdx !== -1 ? args[tokenIdx + 1] : process.env.GITHUB_TOKEN;
+  const repo     = repoIdx  !== -1 ? args[repoIdx  + 1] : process.env.GITHUB_REPOSITORY;
+  const prNumber = prIdx    !== -1 ? parseInt(args[prIdx + 1], 10)
+                                   : readGithubEventPr();
+
+  let ref = refIdx !== -1 ? args[refIdx + 1] : null;
+  if (!ref) ref = process.env.GITHUB_BASE_REF ? `origin/${process.env.GITHUB_BASE_REF}` : null;
+  if (!ref) ref = lastTag(cwd);
+  if (!ref) {
+    const parentExists = capture("git rev-parse HEAD~1", cwd);
+    ref = parentExists ? "HEAD~1" : null;
+  }
+
+  // ── Validate ──────────────────────────────────────────────────────────────
+  if (!fs.existsSync(infernoDir)) {
+    const msg = "inferno/ not found — run: infernoflow init";
+    if (asJson) { console.log(JSON.stringify({ ok: false, error: msg })); process.exit(1); }
+    warn(msg); process.exit(1);
+  }
+
+  if (!dryRun && !token) {
+    const msg = "No GitHub token found. Set GITHUB_TOKEN env var or use --token";
+    if (asJson) { console.log(JSON.stringify({ ok: false, error: msg })); process.exit(1); }
+    warn(msg); process.exit(1);
+  }
+
+  if (!dryRun && !repo) {
+    const msg = "No repository found. Set GITHUB_REPOSITORY env var or use --repo owner/repo";
+    if (asJson) { console.log(JSON.stringify({ ok: false, error: msg })); process.exit(1); }
+    warn(msg); process.exit(1);
+  }
+
+  if (!dryRun && !prNumber) {
+    const msg = "No PR number found. Use --pr <number> or run in GitHub Actions on pull_request event";
+    if (asJson) { console.log(JSON.stringify({ ok: false, error: msg })); process.exit(1); }
+    warn(msg); process.exit(1);
+  }
+
+  // ── Load capabilities and compute diff ───────────────────────────────────
+  const current  = loadCapsFromDisk(infernoDir);
+  const previous = ref ? loadCapsAtRef(ref, cwd) : null;
+
+  if (!current) {
+    const msg = "No capabilities.json or contract.json found in inferno/";
+    if (asJson) { console.log(JSON.stringify({ ok: false, error: msg })); process.exit(1); }
+    warn(msg); process.exit(1);
+  }
+
+  const diff = diffCaps(previous || [], current);
+  const bump = classifyBump(diff);
+  const currentVersion = readPackageVersion(cwd);
+  const nextVersion    = bump !== "none" ? applyBump(currentVersion, bump) : currentVersion;
+
+  // ── Build comment ─────────────────────────────────────────────────────────
+  const commentBody = buildComment(diff, bump, ref || "HEAD", currentVersion, nextVersion);
+
+  // ── Dry run ───────────────────────────────────────────────────────────────
+  if (dryRun) {
+    if (asJson) {
+      console.log(JSON.stringify({ ok: true, dryRun: true, bump, currentVersion, nextVersion, comment: commentBody }));
+    } else {
+      console.log();
+      info("DRY RUN — comment that would be posted:");
+      console.log();
+      console.log(commentBody);
+      console.log();
+    }
+    return;
+  }
+
+  // ── Post comment ──────────────────────────────────────────────────────────
+  if (!asJson) info(`Posting to ${bold(repo)} PR #${prNumber}...`);
+
+  try {
+    const result = await postComment(repo, prNumber, commentBody, token);
+
+    if (result.status === 200 || result.status === 201) {
+      const commentUrl = result.body?.html_url || "";
+      if (asJson) {
+        console.log(JSON.stringify({ ok: true, bump, currentVersion, nextVersion, prNumber, repo, commentUrl }));
+      } else {
+        ok(`Comment posted → ${cyan(commentUrl || `PR #${prNumber}`)}`);
+        if (bump !== "none") {
+          console.log();
+          info(`Recommended bump: ${bold(bump.toUpperCase())}  ${currentVersion} → ${nextVersion}`);
+        }
+        console.log();
+      }
+    } else {
+      const msg = `GitHub API error ${result.status}: ${JSON.stringify(result.body)}`;
+      if (asJson) { console.log(JSON.stringify({ ok: false, error: msg })); }
+      else { warn(msg); }
+      process.exit(1);
+    }
+  } catch (err) {
+    const msg = `Failed to post comment: ${err.message}`;
+    if (asJson) { console.log(JSON.stringify({ ok: false, error: msg })); }
+    else { warn(msg); }
+    process.exit(1);
+  }
+}

package/dist/lib/commands/publish.mjs

@@ -119,9 +119,9 @@ export async function publishCommand(rawArgs) {
   const yes        = args.includes("--yes") || args.includes("-y");
 
   const bumpIdx = args.indexOf("--bump");
-  const bumpType = bumpIdx !== -1 ? (args[bumpIdx + 1] || "patch") : "patch";
+  let bumpType = bumpIdx !== -1 ? (args[bumpIdx + 1] || "patch") : null;
 
-  if (!["patch", "minor", "major"].includes(bumpType)) {
+  if (bumpType && !["patch", "minor", "major"].includes(bumpType)) {
     console.error(`  Invalid --bump value: ${bumpType}. Must be patch, minor, or major.`);
     process.exit(1);
   }
@@ -136,6 +136,29 @@ export async function publishCommand(rawArgs) {
   const pkgPath = path.join(PKG_ROOT, "package.json");
   const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
   const oldVersion = pkg.version;
+
+  // ── Auto-detect bump type from capability diff if not specified ───────────
+  if (!bumpType) {
+    try {
+      const { versionCommand: _vc, ...versionModule } = await import("./version.mjs");
+      // Use the JSON output to get the recommendation
+      const { execSync: _exec } = await import("node:child_process");
+      const result = _exec("node " + JSON.stringify(path.join(PKG_ROOT, "bin", "infernoflow.mjs")) + " version --json", {
+        cwd: PKG_ROOT, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"],
+      });
+      const parsed = JSON.parse(result);
+      if (parsed.bump && parsed.bump !== "none") {
+        bumpType = parsed.bump;
+        info(`Auto-detected bump type: ${bold(cyan(bumpType))} (from capability diff)`);
+      } else {
+        bumpType = "patch";
+        info(`No capability changes detected — defaulting to ${bold("patch")}`);
+      }
+    } catch {
+      bumpType = "patch";
+    }
+  }
+
   const newVersion = bumpVersion(oldVersion, bumpType);
 
   console.log();

package/dist/lib/commands/setup.mjs

@@ -54,6 +54,7 @@ const MCP_TOOLS = [
   "infernoflow_synthesize",
   "infernoflow_agent_list",
   "infernoflow_agent_run",
+  "infernoflow_version",
 ];
 
 // ── Git hooks installer ───────────────────────────────────────────────────────