infernoflow 0.13.0 → 0.16.0

package/dist/bin/infernoflow.mjs

@@ -32,6 +32,11 @@ const COMMAND_DESCRIPTIONS = {
   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)",
+  "pr-comment": "Post capability drift analysis as a GitHub PR comment (works in CI automatically)",
+  dashboard: "Launch local web dashboard on localhost:7337 — live contract health, capabilities, agents",
+  "team-sync": "Sync capability contract across a team via a shared git branch (push | pull | status | init)",
+  onboard: "Interactive onboarding wizard for new developers — explains infernoflow in 5 minutes",
+  cloud:   "Sync capability contracts via infernoflow cloud (init | push | pull | status | dashboard)",
 };
 
 const COMMAND_HANDLERS = {
@@ -57,6 +62,11 @@ const COMMAND_HANDLERS = {
   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),
+  "pr-comment": async (args) => (await import("../lib/commands/prComment.mjs")).prCommentCommand(args),
+  dashboard: async (args) => (await import("../lib/commands/dashboard.mjs")).dashboardCommand(args),
+  "team-sync": async (args) => (await import("../lib/commands/teamSync.mjs")).teamSyncCommand(args),
+  onboard: async (args) => (await import("../lib/commands/onboard.mjs")).onboardCommand(args),
+  cloud:   async (args) => (await import("../lib/commands/cloud.mjs")).cloudCommand(args),
 };
 
 function formatCommandsHelp() {
@@ -86,7 +96,9 @@ ${formatCommandsHelp()}
     update                    Draft ## Unreleased from commits (default sub-command)
     show                      Print the current ## Unreleased block
     list                      List commits since last tag
+    ai                        Generate human-readable changelog with AI (Anthropic or Ollama)
     --ref <tag|commit>        Use a specific ref instead of last tag
+    --version <x.y.z>         Version label for the AI-generated entry
     --dry-run                 Print what would be written without modifying file
     --append                  Append to existing ## Unreleased instead of replacing
     --json                    Machine-readable output
@@ -167,6 +179,28 @@ ${formatCommandsHelp()}
     --apply               Write recommended version bump to package.json
     --json                Machine-readable output
 
+  ${bold("pr-comment options:")}
+    --pr <number>         PR number to comment on (auto-detected in GitHub Actions)
+    --repo <owner/repo>   GitHub repository (auto-detected in GitHub Actions)
+    --token <ghp_...>     GitHub token (auto-detected from GITHUB_TOKEN env var)
+    --ref <ref>           Base ref to diff against (auto-detected from GITHUB_BASE_REF)
+    --dry-run             Print the comment without posting it
+    --json                Machine-readable output
+
+  ${bold("cloud sub-commands:")}
+    init                      Generate a project token and configure cloud sync
+    push                      Upload local capability contract to cloud
+    pull                      Download latest contract from cloud (conflict detection)
+    status                    Compare local vs cloud (hashes, capability counts)
+    dashboard                 Print hosted dashboard URL and open in browser
+
+  ${bold("cloud options:")}
+    --token <tok>             Override token (or set INFERNOFLOW_TOKEN env var)
+    --endpoint <url>          Override default endpoint (https://cloud.infernoflow.dev)
+    --force, -f               Overwrite on init; overwrite local on conflicted pull
+    --dry-run                 Print what would happen without sending
+    --json                    Machine-readable output
+
   ${bold("Machine output:")}
     ${gray("status --json")}
     ${gray("check --json")}

package/dist/lib/commands/changelog.mjs

@@ -303,6 +303,248 @@ async function subcmdUpdate(cwd, changelogPath, opts) {
   console.log(`  Run ${cyan("infernoflow publish")} when ready to cut the release\n`);
 }
 
+// ── AI changelog writer ───────────────────────────────────────────────────────
+
+function parseCaps(jsonText) {
+  if (!jsonText) return [];
+  try {
+    const obj = JSON.parse(jsonText);
+    const raw = obj.capabilities || [];
+    return raw.map(c => typeof c === "string" ? { id: c, title: c } : c);
+  } catch { return []; }
+}
+
+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 [];
+}
+
+function loadCapsAtRef(ref, cwd) {
+  const { execSync: _exec } = await import ? null : null; // handled below
+  try {
+    const { execSync: ex } = await import("node:child_process");
+    for (const name of ["capabilities.json", "contract.json"]) {
+      try {
+        const content = ex(`git show "${ref}:inferno/${name}"`, {
+          cwd, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"]
+        }).trim();
+        if (content) return parseCaps(content);
+      } catch {}
+    }
+  } catch {}
+  return [];
+}
+
+function diffCapsSimple(before, after) {
+  const beforeMap = new Map(before.map(c => [c.id, c]));
+  const afterMap  = new Map(after.map(c  => [c.id, c]));
+  return {
+    added:   after.filter(c  => !beforeMap.has(c.id)),
+    removed: before.filter(c => !afterMap.has(c.id)),
+    changed: after.filter(c  => {
+      const old = beforeMap.get(c.id);
+      return old && old.title !== c.title;
+    }),
+  };
+}
+
+function buildAiPrompt(commits, diff, ref, version) {
+  const lines = [];
+  lines.push(`You are writing a changelog entry for a software release.`);
+  lines.push(`Write it in a friendly, clear, developer-facing tone.`);
+  lines.push(`Use Markdown. Start with ## ${version || "Unreleased"}`);
+  lines.push(`Include sections: ### Added, ### Fixed, ### Changed, ### Removed (only if non-empty).`);
+  lines.push(`Be concise — one line per item. Do not include commit hashes.`);
+  lines.push(`Do not invent features that are not listed below.`);
+  lines.push(``);
+  lines.push(`## Capability changes since ${ref || "last release"}:`);
+  if (diff.added.length)   lines.push(`Added: ${diff.added.map(c => c.title || c.id).join(", ")}`);
+  if (diff.removed.length) lines.push(`Removed: ${diff.removed.map(c => c.title || c.id).join(", ")}`);
+  if (diff.changed.length) lines.push(`Changed: ${diff.changed.map(c => c.title || c.id).join(", ")}`);
+  if (!diff.added.length && !diff.removed.length && !diff.changed.length) lines.push(`(no capability changes)`);
+  lines.push(``);
+  lines.push(`## Git commits since ${ref || "last release"}:`);
+  for (const c of commits.slice(0, 40)) lines.push(`- ${c.subject}`);
+  lines.push(``);
+  lines.push(`Write the changelog entry now:`);
+  return lines.join("\n");
+}
+
+function buildStructuredFallback(commits, diff, version) {
+  // High-quality template fallback when no AI provider is available
+  const sections = groupCommits(commits);
+
+  // Merge capability changes into sections
+  for (const c of diff.added)   sections.Added.unshift(`${c.title || c.id} capability`);
+  for (const c of diff.removed) sections.Removed.unshift(`${c.title || c.id} capability`);
+  for (const c of diff.changed) sections.Changed.unshift(`Updated ${c.title || c.id} capability`);
+
+  // Deduplicate
+  for (const key of Object.keys(sections)) sections[key] = [...new Set(sections[key])];
+
+  const tag = version || "Unreleased";
+  const date = new Date().toISOString().slice(0, 10);
+  const lines = [`## ${tag} — ${date}`, ""];
+
+  const ORDER = ["Breaking", "Added", "Fixed", "Changed", "Removed"];
+  for (const heading of ORDER) {
+    const items = sections[heading];
+    if (!items?.length) continue;
+    lines.push(`### ${heading}`);
+    for (const item of items) lines.push(`- ${item}`);
+    lines.push("");
+  }
+
+  return lines.join("\n");
+}
+
+async function callLocalAi(prompt) {
+  // Try Ollama (localhost:11434) — most common local AI setup
+  try {
+    const { default: http } = await import("node:http");
+    return new Promise((resolve, reject) => {
+      const body = JSON.stringify({ model: "llama3", prompt, stream: false });
+      const req = http.request({
+        hostname: "localhost", port: 11434,
+        path: "/api/generate", method: "POST",
+        headers: { "Content-Type": "application/json", "Content-Length": Buffer.byteLength(body) },
+      }, (res) => {
+        let raw = "";
+        res.on("data", d => raw += d);
+        res.on("end", () => {
+          try { resolve(JSON.parse(raw).response || null); } catch { resolve(null); }
+        });
+      });
+      req.setTimeout(30_000, () => { req.destroy(); reject(new Error("timeout")); });
+      req.on("error", reject);
+      req.write(body);
+      req.end();
+    });
+  } catch { return null; }
+}
+
+async function callAnthropicAi(prompt, apiKey) {
+  const { default: https } = await import("node:https");
+  return new Promise((resolve, reject) => {
+    const body = JSON.stringify({
+      model: "claude-haiku-4-5-20251001",
+      max_tokens: 1024,
+      messages: [{ role: "user", content: prompt }],
+    });
+    const req = https.request({
+      hostname: "api.anthropic.com",
+      path: "/v1/messages", method: "POST",
+      headers: {
+        "x-api-key": apiKey,
+        "anthropic-version": "2023-06-01",
+        "Content-Type": "application/json",
+        "Content-Length": Buffer.byteLength(body),
+      },
+    }, (res) => {
+      let raw = "";
+      res.on("data", d => raw += d);
+      res.on("end", () => {
+        try {
+          const data = JSON.parse(raw);
+          resolve(data.content?.[0]?.text || null);
+        } catch { resolve(null); }
+      });
+    });
+    req.setTimeout(30_000, () => { req.destroy(); reject(new Error("timeout")); });
+    req.on("error", reject);
+    req.write(body);
+    req.end();
+  });
+}
+
+async function subcmdAi(cwd, changelogPath, opts) {
+  const { ref, dryRun, asJson, version } = opts;
+  const infernoDir = path.join(cwd, "inferno");
+
+  const tag     = ref || lastTag(cwd);
+  const commits = commitsSince(tag, cwd);
+
+  // Load capability diff
+  const currentCaps = fs.existsSync(infernoDir) ? loadCapsFromDisk(infernoDir) : [];
+  const prevCaps    = tag ? (() => {
+    try {
+      const ex = require("child_process").execSync;
+      for (const name of ["capabilities.json", "contract.json"]) {
+        try {
+          const c = ex(`git show "${tag}:inferno/${name}"`, { cwd, encoding: "utf8", stdio: ["ignore","pipe","pipe"] }).trim();
+          if (c) return parseCaps(c);
+        } catch {}
+      }
+      return [];
+    } catch { return []; }
+  })() : [];
+
+  const diff = diffCapsSimple(prevCaps, currentCaps);
+
+  if (!asJson) {
+    info(`Generating AI changelog since ${bold(tag || "beginning")}...`);
+    info(`${commits.length} commits · ${diff.added.length} added · ${diff.removed.length} removed · ${diff.changed.length} changed`);
+    console.log();
+  }
+
+  const prompt = buildAiPrompt(commits, diff, tag, version);
+  let aiText = null;
+  let provider = "template";
+
+  // Try AI providers in order: Anthropic API → Ollama → structured template
+  const anthropicKey = process.env.ANTHROPIC_API_KEY;
+  if (anthropicKey) {
+    try {
+      aiText = await callAnthropicAi(prompt, anthropicKey);
+      if (aiText) provider = "anthropic";
+    } catch {}
+  }
+
+  if (!aiText) {
+    try {
+      aiText = await callLocalAi(prompt);
+      if (aiText) provider = "ollama";
+    } catch {}
+  }
+
+  // Fallback: structured template
+  if (!aiText) {
+    aiText = buildStructuredFallback(commits, diff, version);
+    provider = "template";
+  }
+
+  if (asJson) {
+    console.log(JSON.stringify({ ok: true, provider, ref: tag, commits: commits.length, markdown: aiText }));
+    return;
+  }
+
+  console.log(gray("  ─── Generated changelog ──────────────────────────────"));
+  aiText.split("\n").forEach(l => console.log("  " + l));
+  console.log(gray("  ──────────────────────────────────────────────────────"));
+  console.log();
+  info(`Generated via: ${bold(provider)}`);
+
+  if (dryRun) {
+    warn("Dry run — CHANGELOG.md not modified");
+    console.log();
+    return;
+  }
+
+  // Write to CHANGELOG.md
+  let text = fs.existsSync(changelogPath) ? fs.readFileSync(changelogPath, "utf8") : "# Changelog\n\n";
+  const updated = injectUnreleased(text, aiText);
+  fs.writeFileSync(changelogPath, updated);
+
+  ok(`CHANGELOG.md updated with AI-generated entry`);
+  if (provider === "template") {
+    info(`Tip: set ANTHROPIC_API_KEY for richer AI-written changelogs`);
+  }
+  console.log();
+}
+
 // ── main ─────────────────────────────────────────────────────────────────────
 
 export async function changelogCommand(rawArgs) {
@@ -311,12 +553,14 @@ export async function changelogCommand(rawArgs) {
   // Sub-command: first non-flag arg
   const sub = args.find(a => !a.startsWith("-")) || "update";
 
-  const dryRun = args.includes("--dry-run");
-  const append = args.includes("--append");
-  const asJson = args.includes("--json");
+  const dryRun  = args.includes("--dry-run");
+  const append  = args.includes("--append");
+  const asJson  = args.includes("--json");
 
-  const refIdx = args.indexOf("--ref");
-  const ref    = refIdx !== -1 ? args[refIdx + 1] : null;
+  const refIdx     = args.indexOf("--ref");
+  const versionIdx = args.indexOf("--version");
+  const ref     = refIdx     !== -1 ? args[refIdx + 1]     : null;
+  const version = versionIdx !== -1 ? args[versionIdx + 1] : null;
 
   const cwd           = process.cwd();
   const changelogPath = path.join(cwd, "CHANGELOG.md");
@@ -338,6 +582,11 @@ export async function changelogCommand(rawArgs) {
     return;
   }
 
-  fail(`Unknown sub-command: ${sub}`, "Use: update | show | list");
+  if (sub === "ai") {
+    await subcmdAi(cwd, changelogPath, { ref, dryRun, asJson, version });
+    return;
+  }
+
+  fail(`Unknown sub-command: ${sub}`, "Use: update | show | list | ai");
   process.exit(1);
 }