infernoflow 0.12.0 → 0.13.0

package/dist/bin/infernoflow.mjs

@@ -31,6 +31,7 @@ const COMMAND_DESCRIPTIONS = {
   "generate-skills": "Generate personalised Cursor rules + skill files from your developer profile",
   synthesize: "Auto-detect workflow patterns and synthesize reusable skills + agents",
   agent: "Manage and run auto-synthesized agents (list | run | show | delete)",
+  version: "Smart semver bump recommendation based on capability changes (--apply to write)",
 };
 
 const COMMAND_HANDLERS = {
@@ -55,6 +56,7 @@ const COMMAND_HANDLERS = {
   "generate-skills": async (args) => (await import("../lib/commands/generateSkills.mjs")).generateSkillsCommand(args),
   synthesize: async (args) => (await import("../lib/commands/synthesize.mjs")).synthesizeCommand(args),
   agent: async (args) => (await import("../lib/commands/agent.mjs")).agentCommand(args),
+  version: async (args) => (await import("../lib/commands/version.mjs")).versionCommand(args),
 };
 
 function formatCommandsHelp() {
@@ -160,6 +162,11 @@ ${formatCommandsHelp()}
     --response <json|@file>   Provide AI response directly (use with --json)
     --apply                   Apply the response changes when using --json --response
 
+  ${bold("version options:")}
+    --ref <tag|commit>    Compare against a specific ref (default: last git tag)
+    --apply               Write recommended version bump to package.json
+    --json                Machine-readable output
+
   ${bold("Machine output:")}
     ${gray("status --json")}
     ${gray("check --json")}
@@ -169,6 +176,8 @@ ${formatCommandsHelp()}
     ${gray('run "task" --json')}
     ${gray('suggest "what changed" --json')}
     ${gray('suggest "what changed" --json --response \'{"newCapabilities":[...]}\' --apply')}
+    ${gray("version --json")}
+    ${gray("version --apply")}
 `;
 
 // ── Silent behavior observation ───────────────────────────────────────────

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 ───────────────────────────────────────────────────────

package/dist/lib/commands/version.mjs

@@ -0,0 +1,282 @@
+/**
+ * infernoflow version
+ *
+ * Smart semver bump recommendation based on capability changes since the last
+ * git tag (or a custom ref).
+ *
+ * Classification rules:
+ *   MAJOR  — any capability was REMOVED  (breaking: callers lose functionality)
+ *   MINOR  — capabilities were ADDED     (non-breaking: new surface area)
+ *   PATCH  — only metadata changed       (title / description / status edits)
+ *   NONE   — no capability changes at all
+ *
+ * Usage:
+ *   infernoflow version              # recommend bump type + show next version
+ *   infernoflow version --apply      # apply recommended bump to package.json
+ *   infernoflow version --ref v1.2.3 # compare against a specific ref
+ *   infernoflow version --json       # machine-readable output
+ */
+
+import * as fs   from "node:fs";
+import * as path from "node:path";
+import { execSync } from "node:child_process";
+import { header, ok, warn, info, bold, cyan, gray, green, red, yellow, done } from "../ui/output.mjs";
+
+// ── git helpers (shared with diff.mjs) ───────────────────────────────────────
+
+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) {
+  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;
+}
+
+function loadCapsAtRef(ref, infernoRelDir, cwd) {
+  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 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 };
+}
+
+// ── semver helpers ────────────────────────────────────────────────────────────
+
+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";
+}
+
+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 pkgPath = path.join(cwd, "package.json");
+  if (!fs.existsSync(pkgPath)) return null;
+  try {
+    return JSON.parse(fs.readFileSync(pkgPath, "utf8")).version || null;
+  } catch { return null; }
+}
+
+function writePackageVersion(cwd, newVersion) {
+  const pkgPath = path.join(cwd, "package.json");
+  const raw  = fs.readFileSync(pkgPath, "utf8");
+  const data = JSON.parse(raw);
+  data.version = newVersion;
+  fs.writeFileSync(pkgPath, JSON.stringify(data, null, 2) + "\n", "utf8");
+}
+
+// ── reason builder ────────────────────────────────────────────────────────────
+
+function buildReason(type, diff, ref) {
+  const lines = [];
+  if (type === "major") {
+    lines.push(`${diff.removed.length} capability removed — breaking change`);
+    for (const c of diff.removed.slice(0, 3)) lines.push(`  - ${c.id}: ${c.title}`);
+    if (diff.removed.length > 3) lines.push(`  … and ${diff.removed.length - 3} more`);
+  } else if (type === "minor") {
+    lines.push(`${diff.added.length} new capability added`);
+    for (const c of diff.added.slice(0, 3)) lines.push(`  + ${c.id}: ${c.title}`);
+    if (diff.added.length > 3) lines.push(`  … and ${diff.added.length - 3} more`);
+  } else if (type === "patch") {
+    lines.push(`${diff.changed.length} capability metadata updated`);
+  } else {
+    lines.push(`No capability changes since ${ref}`);
+  }
+  return lines;
+}
+
+// ── MCP-compatible JSON output ────────────────────────────────────────────────
+
+function emitJson(payload) {
+  console.log(JSON.stringify(payload, null, 2));
+}
+
+// ── main command ──────────────────────────────────────────────────────────────
+
+export async function versionCommand(rawArgs) {
+  const args   = rawArgs.slice(1);
+  const asJson = args.includes("--json");
+  const apply  = args.includes("--apply");
+
+  const refIdx = args.indexOf("--ref");
+  let ref = refIdx !== -1 ? args[refIdx + 1] : null;
+
+  const cwd        = process.cwd();
+  const infernoDir = path.join(cwd, "inferno");
+
+  if (!asJson) header("infernoflow version");
+
+  // ── Validate ───────────────────────────────────────────────────────────────
+  if (!fs.existsSync(infernoDir)) {
+    if (asJson) { emitJson({ ok: false, error: "inferno_not_found" }); process.exit(1); }
+    warn("inferno/ not found — run: infernoflow init");
+    process.exit(1);
+  }
+
+  // ── Resolve ref ────────────────────────────────────────────────────────────
+  if (!ref) {
+    ref = lastTag(cwd);
+    if (!ref) {
+      const parentExists = capture("git rev-parse HEAD~1", cwd);
+      ref = parentExists ? "HEAD~1" : null;
+    }
+  }
+
+  if (!ref) {
+    const currentVersion = readPackageVersion(cwd) || "0.0.0";
+    if (asJson) {
+      emitJson({ ok: true, bump: "minor", current: currentVersion, next: applyBump(currentVersion, "minor"), reason: ["No git history — defaulting to minor for first release"], ref: null });
+    } else {
+      info("No git history found — defaulting to minor for first release");
+      ok(`Recommended: ${bold(cyan("minor"))}  →  ${bold(applyBump(currentVersion, "minor"))}`);
+    }
+    return;
+  }
+
+  // ── Load capabilities ──────────────────────────────────────────────────────
+  const current  = loadCapsFromDisk(infernoDir);
+  const previous = loadCapsAtRef(ref, "inferno", cwd);
+
+  if (!current) {
+    if (asJson) { emitJson({ ok: false, error: "no_capabilities" }); process.exit(1); }
+    warn("No capabilities.json or contract.json found");
+    process.exit(1);
+  }
+
+  // If no previous snapshot, treat all current caps as new → minor
+  const prevCaps = previous || [];
+  const diff = diffCaps(prevCaps, current);
+  const bump = classifyBump(diff);
+
+  const currentVersion = readPackageVersion(cwd) || "0.0.0";
+  const nextVersion    = bump === "none" ? currentVersion : applyBump(currentVersion, bump);
+  const reason         = buildReason(bump, diff, ref);
+
+  // ── JSON output ────────────────────────────────────────────────────────────
+  if (asJson) {
+    emitJson({
+      ok: true,
+      bump,
+      current: currentVersion,
+      next: nextVersion,
+      ref,
+      reason,
+      diff: {
+        added:   diff.added.length,
+        removed: diff.removed.length,
+        changed: diff.changed.length,
+      },
+    });
+    return;
+  }
+
+  // ── Human output ──────────────────────────────────────────────────────────
+  const bumpColor = bump === "major" ? red
+                  : bump === "minor" ? green
+                  : bump === "patch" ? yellow
+                  : gray;
+
+  console.log();
+  console.log(`  Current version  ${bold(currentVersion)}  ${gray("(" + ref + ")")}`);
+  console.log();
+
+  if (bump === "none") {
+    ok(`No capability changes — version stays at ${bold(currentVersion)}`);
+  } else {
+    console.log(`  ${bold("Recommended bump:")}  ${bumpColor(bold(bump.toUpperCase()))}`);
+    console.log();
+    for (const line of reason) {
+      const prefix = line.startsWith("  +") ? green("  +")
+                   : line.startsWith("  -") ? red("  -")
+                   : line.startsWith("  …") ? gray("  …")
+                   : "  ";
+      const text = line.replace(/^\s+[+\-…]\s?/, "");
+      if (line.startsWith("  ") && !line.startsWith("  …")) {
+        console.log(`    ${line.trim()}`);
+      } else {
+        console.log(`  ${gray(line)}`);
+      }
+    }
+    console.log();
+    console.log(`  ${bold(currentVersion)}  →  ${bumpColor(bold(nextVersion))}`);
+  }
+
+  // ── Apply ──────────────────────────────────────────────────────────────────
+  if (apply && bump !== "none") {
+    const pkgPath = path.join(cwd, "package.json");
+    if (!fs.existsSync(pkgPath)) {
+      warn("No package.json found — skipping --apply");
+    } else {
+      writePackageVersion(cwd, nextVersion);
+      console.log();
+      done(`package.json updated → ${bold(nextVersion)}`);
+    }
+  } else if (apply && bump === "none") {
+    console.log();
+    info("No changes to apply — version unchanged");
+  } else if (bump !== "none") {
+    console.log();
+    info(`Run ${cyan("infernoflow version --apply")} to write ${nextVersion} to package.json`);
+  }
+
+  console.log();
+}

package/dist/templates/cursor/inferno-mcp-server.mjs

@@ -68,6 +68,14 @@ const TOOLS = [
     description: "Execute a saved workflow agent by name. Check infernoflow_agent_list first. Can replace multi-step manual workflows with one call.",
     inputSchema: { type: "object", properties: { name: { type: "string", description: "Agent name to run" } }, required: ["name"] }
   },
+  {
+    name: "infernoflow_version",
+    description: "Get the recommended semver bump (major/minor/patch) based on capability changes since the last git tag. CALL THIS AUTOMATICALLY when the developer asks about releasing, bumping version, or publishing. Returns bump type and next version number. Pass apply:true to write the bump to package.json.",
+    inputSchema: { type: "object", properties: {
+      apply: { type: "boolean", description: "If true, write the recommended version to package.json" },
+      ref:   { type: "string",  description: "Compare against a specific git ref (default: last tag)" }
+    }}
+  },
   {
     name: "infernoflow_run",
     description: "Generate a full infernoflow task prompt. Use infernoflow_implement instead for most cases — it's simpler. Use this for complex multi-step flows.",
@@ -576,6 +584,11 @@ function handleTool(id, name, input) {
       text = listAgents();
     } else if (name === "infernoflow_agent_run") {
       text = runAgent(input.name);
+    } else if (name === "infernoflow_version") {
+      const parts = ["version", "--json"];
+      if (input.ref)   parts.push(`--ref "${input.ref}"`);
+      if (input.apply) parts.push("--apply");
+      text = runCmd(parts.join(" "));
     } else { return sendError(id, -32601, `Unknown tool: ${name}`); }
     sendResult(id, { content: [{ type: "text", text: text || "(no output)" }] });
   } catch (err) { sendError(id, -32000, err.message); }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "infernoflow",
-  "version": "0.12.0",
-  "description": "The forge for liquid code — keep capabilities, contracts, and docs in sync.",
+  "version": "0.13.0",
+  "description": "The forge for liquid code - keep capabilities, contracts, and docs in sync.",
   "type": "module",
   "bin": {
     "infernoflow": "dist/bin/infernoflow.mjs"
@@ -20,7 +20,8 @@
     "test": "node scripts/smoke.mjs && node scripts/json-smoke.mjs && node scripts/json-negative-smoke.mjs && node scripts/implement-smoke.mjs && node scripts/adopt-smoke.mjs && node scripts/pr-impact-smoke.mjs && node scripts/sync-smoke.mjs && node scripts/run-smoke.mjs",
     "test:help": "node bin/infernoflow.mjs --help",
     "build": "node build.mjs",
-    "prepublishOnly": "node build.mjs"
+    "prepublishOnly": "node build.mjs",
+    "inferno:promote-draft": "node scripts/inferno-promote-draft.mjs"
   },
   "keywords": [
     "cli",
@@ -45,4 +46,4 @@
   "devDependencies": {
     "esbuild": "^0.28.0"
   }
-}
+}