infernoflow 0.14.0 → 0.17.0

package/dist/lib/commands/onboard.mjs

@@ -0,0 +1,296 @@
+/**
+ * infernoflow onboard
+ *
+ * Interactive step-by-step onboarding wizard for new developers.
+ * Walks through: what infernoflow is, detecting the stack, running init,
+ * showing the first contract, explaining each file, and a test suggest.
+ *
+ * Designed for teams adding a new member — run once, understand everything.
+ *
+ * Usage:
+ *   infernoflow onboard
+ *   infernoflow onboard --yes    # non-interactive (auto-accept all steps)
+ */
+
+import * as fs      from "node:fs";
+import * as path    from "node:path";
+import * as readline from "node:readline";
+import { execSync }  from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { header, ok, warn, info, done, bold, cyan, gray, green, yellow, red } from "../ui/output.mjs";
+
+// ── readline helpers ──────────────────────────────────────────────────────────
+
+function createRl() {
+  return readline.createInterface({ input: process.stdin, output: process.stdout });
+}
+
+async function ask(rl, question) {
+  return new Promise(resolve => rl.question(question, resolve));
+}
+
+async function confirm(rl, question, defaultYes = true) {
+  const hint = defaultYes ? "[Y/n]" : "[y/N]";
+  const answer = await ask(rl, `  ${question} ${gray(hint)} `);
+  if (!answer.trim()) return defaultYes;
+  return answer.trim().toLowerCase().startsWith("y");
+}
+
+// ── step renderer ─────────────────────────────────────────────────────────────
+
+function step(n, total, title) {
+  console.log();
+  console.log(`  ${bold(cyan(`Step ${n}/${total}`))}  ${bold(title)}`);
+  console.log(`  ${gray("─".repeat(50))}`);
+}
+
+function explain(lines) {
+  for (const line of lines) {
+    console.log(`  ${gray(line)}`);
+  }
+  console.log();
+}
+
+// ── project detection ─────────────────────────────────────────────────────────
+
+function detectStack(cwd) {
+  const has = (f) => fs.existsSync(path.join(cwd, f));
+  const pkg = has("package.json") ? JSON.parse(fs.readFileSync(path.join(cwd, "package.json"), "utf8")) : {};
+  const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+
+  const framework = deps.react    ? "React"
+                  : deps.next     ? "Next.js"
+                  : deps.vue      ? "Vue"
+                  : deps.angular  ? "Angular"
+                  : deps.express  ? "Express"
+                  : deps.fastify  ? "Fastify"
+                  : has("requirements.txt") ? "Python"
+                  : has("go.mod")           ? "Go"
+                  : has("Cargo.toml")       ? "Rust"
+                  : "unknown";
+
+  const language = has("tsconfig.json") ? "TypeScript"
+                 : has("package.json")  ? "JavaScript"
+                 : has("requirements.txt") ? "Python"
+                 : has("go.mod")           ? "Go"
+                 : "unknown";
+
+  return { framework, language, name: pkg.name || path.basename(cwd) };
+}
+
+function capture(cmd, cwd) {
+  try {
+    return execSync(cmd, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }).trim();
+  } catch { return null; }
+}
+
+// ── main wizard ───────────────────────────────────────────────────────────────
+
+export async function onboardCommand(rawArgs) {
+  const args       = rawArgs.slice(1);
+  const autoYes    = args.includes("--yes") || args.includes("-y");
+  const cwd        = process.cwd();
+  const infernoDir = path.join(cwd, "inferno");
+  const TOTAL      = 7;
+
+  const rl = autoYes ? null : createRl();
+
+  const ask_confirm = autoYes
+    ? async () => true
+    : (q, def) => confirm(rl, q, def);
+
+  console.clear();
+  console.log();
+  console.log(`  ${bold("🔥 Welcome to infernoflow")}`);
+  console.log(`  ${gray("This wizard walks you through everything in about 5 minutes.")}`);
+  console.log(`  ${gray("You'll understand what infernoflow does and how it fits your workflow.")}`);
+  console.log();
+
+  if (!autoYes) {
+    const ready = await ask_confirm("Ready to start?", true);
+    if (!ready) { console.log("\n  See you next time!\n"); rl.close(); return; }
+  }
+
+  // ── Step 1: What is infernoflow? ───────────────────────────────────────────
+  step(1, TOTAL, "What is infernoflow?");
+  explain([
+    "infernoflow keeps a living record of your project's capabilities",
+    "— the features your code actually provides — and makes sure that",
+    "record never drifts out of sync as you build.",
+    "",
+    "It works invisibly in the background:",
+    "  • Claude auto-tracks capability changes as you code",
+    "  • Git hooks update the changelog on every commit",
+    "  • PRs get automatic capability drift analysis",
+    "  • Version bumps are recommended automatically (major/minor/patch)",
+    "",
+    "You write code. infernoflow handles the bookkeeping.",
+  ]);
+
+  await ask_confirm("Got it — continue?", true);
+
+  // ── Step 2: Detect your project ────────────────────────────────────────────
+  step(2, TOTAL, "Detecting your project");
+  const stack = detectStack(cwd);
+  const isGitRepo = !!capture("git rev-parse --git-dir", cwd);
+  const alreadySetup = fs.existsSync(infernoDir);
+
+  console.log(`  Project:    ${bold(stack.name)}`);
+  console.log(`  Framework:  ${bold(stack.framework)}`);
+  console.log(`  Language:   ${bold(stack.language)}`);
+  console.log(`  Git repo:   ${isGitRepo ? green("yes") : red("no — git init first")}`);
+  console.log(`  infernoflow: ${alreadySetup ? green("already set up") : yellow("not set up yet")}`);
+  console.log();
+
+  if (!isGitRepo) {
+    warn("This directory is not a git repository.");
+    warn("Run: git init && git add . && git commit -m 'init'");
+    warn("Then run: infernoflow onboard");
+    if (rl) rl.close();
+    process.exit(1);
+  }
+
+  await ask_confirm("Continue?", true);
+
+  // ── Step 3: Run infernoflow setup ──────────────────────────────────────────
+  step(3, TOTAL, "Setting up infernoflow");
+  if (alreadySetup) {
+    ok("infernoflow is already set up in this project");
+    explain(["The inferno/ folder exists — skipping init."]);
+  } else {
+    explain([
+      "infernoflow setup will:",
+      "  1. Scan your codebase and infer capabilities automatically",
+      "  2. Create the inferno/ folder with contract.json",
+      "  3. Install the MCP server (for Claude Code integration)",
+      "  4. Write CLAUDE.md (makes Claude auto-track capabilities)",
+      "  5. Install git hooks (auto changelog + drift check)",
+    ]);
+
+    const go = await ask_confirm("Run infernoflow setup now?", true);
+    if (go) {
+      console.log();
+      try {
+        execSync("npx infernoflow setup --yes", {
+          cwd,
+          stdio: "inherit",
+          timeout: 120_000,
+        });
+      } catch (err) {
+        warn("Setup encountered an issue — you can re-run it manually:");
+        warn("  infernoflow setup");
+      }
+    } else {
+      info("Skipped — run: infernoflow setup");
+    }
+  }
+
+  await ask_confirm("Continue?", true);
+
+  // ── Step 4: Your capability contract ──────────────────────────────────────
+  step(4, TOTAL, "Your capability contract");
+  explain([
+    "The inferno/contract.json is the heart of infernoflow.",
+    "It lists every capability your project has — the things users can DO.",
+    "",
+    "Think of it as a living API contract, but for features, not endpoints.",
+  ]);
+
+  const contractPath = path.join(infernoDir, "contract.json");
+  if (fs.existsSync(contractPath)) {
+    try {
+      const contract = JSON.parse(fs.readFileSync(contractPath, "utf8"));
+      const caps = contract.capabilities || [];
+      console.log(`  ${bold(String(caps.length))} capabilities tracked:\n`);
+      for (const c of caps.slice(0, 8)) {
+        const cap = typeof c === "string" ? { id: c, title: c } : c;
+        console.log(`    ${green("✔")} ${bold(cap.id)}  ${gray(cap.title || "")}`);
+      }
+      if (caps.length > 8) console.log(`    ${gray(`… and ${caps.length - 8} more`)}`);
+      console.log();
+    } catch {
+      warn("Could not read contract.json");
+    }
+  } else {
+    warn("No contract.json yet — run: infernoflow setup");
+  }
+
+  await ask_confirm("Continue?", true);
+
+  // ── Step 5: Your daily workflow ────────────────────────────────────────────
+  step(5, TOTAL, "Your daily workflow");
+  explain([
+    "Here's exactly how infernoflow fits into your git workflow:",
+    "",
+    "  1. git checkout -b feature/my-feature",
+    "     (branch from main as usual)",
+    "",
+    "  2. Write code in Claude / Cursor / VS Code",
+    "     infernoflow tracks capability changes automatically via CLAUDE.md",
+    "",
+    "  3. git commit -m 'add my feature'",
+    "     post-commit hook silently updates the changelog",
+    "",
+    "  4. git push && open PR",
+    "     GitHub Actions posts a capability drift analysis comment on the PR",
+    "     pre-push hook warns if drift is HIGH",
+    "",
+    "  5. infernoflow version",
+    "     see what semver bump is recommended (major/minor/patch)",
+    "",
+    "You never run infernoflow manually in day-to-day work.",
+    "It runs itself.",
+  ]);
+
+  await ask_confirm("Got it — continue?", true);
+
+  // ── Step 6: Key commands to know ──────────────────────────────────────────
+  step(6, TOTAL, "Key commands");
+  const commands = [
+    ["infernoflow status",          "Quick health check of the contract"],
+    ["infernoflow diff",            "What changed since the last release"],
+    ["infernoflow version",         "What semver bump to use"],
+    ["infernoflow version --apply", "Write the bump to package.json"],
+    ["infernoflow changelog ai",    "Generate a human-readable changelog"],
+    ["infernoflow dashboard",       "Open the live web dashboard"],
+    ["infernoflow team-sync status","See if your team is in sync"],
+    ["infernoflow suggest 'what I built'", "Manually update the contract"],
+  ];
+
+  const maxLen = Math.max(...commands.map(([c]) => c.length));
+  for (const [cmd, desc] of commands) {
+    console.log(`  ${cyan(cmd.padEnd(maxLen + 2))}${gray(desc)}`);
+  }
+  console.log();
+
+  await ask_confirm("Continue?", true);
+
+  // ── Step 7: Live test ─────────────────────────────────────────────────────
+  step(7, TOTAL, "Quick live test");
+  explain(["Let's run infernoflow status to confirm everything is working."]);
+
+  const runTest = await ask_confirm("Run infernoflow status now?", true);
+  if (runTest) {
+    console.log();
+    try {
+      execSync("npx infernoflow status", { cwd, stdio: "inherit", timeout: 30_000 });
+    } catch {
+      warn("Status check failed — try: infernoflow setup");
+    }
+  }
+
+  // ── Done ──────────────────────────────────────────────────────────────────
+  console.log();
+  console.log(`  ${bold("🎉 You're all set!")}`);
+  console.log();
+  console.log(`  ${green("✔")} infernoflow is installed and running`);
+  console.log(`  ${green("✔")} Claude will auto-track capabilities as you code`);
+  console.log(`  ${green("✔")} Git hooks handle changelog and drift automatically`);
+  console.log(`  ${green("✔")} PRs will get automatic capability analysis`);
+  console.log();
+  console.log(`  ${gray("Share this with teammates:")}  ${cyan("infernoflow onboard")}`);
+  console.log(`  ${gray("Questions?")}  ${cyan("infernoflow --help")}`);
+  console.log();
+
+  if (rl) rl.close();
+}

package/dist/lib/commands/share.mjs

@@ -0,0 +1,236 @@
+/**
+ * infernoflow share
+ *
+ * Generate a public read-only snapshot of your capability contract — no cloud
+ * account needed. Creates a self-contained HTML file you can host anywhere,
+ * or uploads to a paste service and prints a short link.
+ *
+ * Usage:
+ *   infernoflow share                  Generate share.html locally
+ *   infernoflow share --open           Open in browser immediately
+ *   infernoflow share --upload         Upload to dpaste.com and print URL
+ *   infernoflow share --copy           Copy HTML to clipboard
+ *   infernoflow share --json           Machine-readable: { ok, file, url }
+ *   infernoflow share --out <path>     Custom output path
+ */
+
+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 { done, warn, info, bold, cyan, gray, green } from "../ui/output.mjs";
+
+// ── Helpers ───────────────────────────────────────────────────────────────────
+
+function readContract(infernoDir) {
+  for (const f of ["contract.json", "capabilities.json"]) {
+    const p = path.join(infernoDir, f);
+    if (fs.existsSync(p)) {
+      try { return JSON.parse(fs.readFileSync(p, "utf8")); } catch {}
+    }
+  }
+  return null;
+}
+
+function readChangelog(cwd) {
+  const p = path.join(cwd, "CHANGELOG.md");
+  if (!fs.existsSync(p)) return null;
+  try {
+    const lines = fs.readFileSync(p, "utf8").split("\n");
+    const start = lines.findIndex(l => l.startsWith("## "));
+    if (start === -1) return null;
+    const end   = lines.findIndex((l, i) => i > start && l.startsWith("## "));
+    return lines.slice(start, end === -1 ? start + 30 : end).join("\n");
+  } catch { return null; }
+}
+
+// ── HTML generator ────────────────────────────────────────────────────────────
+
+function buildHtml(contract, changelog, generatedAt) {
+  const caps     = contract.capabilities || [];
+  const policyId = contract.policyId || "project";
+  const version  = contract.policyVersion || "?";
+
+  const capRows = caps.map(c => {
+    const id    = typeof c === "string" ? c : c.id;
+    const title = typeof c === "string" ? c : (c.title || c.id);
+    const cov   = typeof c === "object" ? c.covered : undefined;
+    const badge = cov === true  ? `<span class="cov yes">✔</span>`
+                : cov === false ? `<span class="cov no">✗</span>`
+                : `<span class="cov uk">·</span>`;
+    const desc  = typeof c === "object" && c.description ? `<div class="cap-desc">${c.description}</div>` : "";
+    return `<div class="cap-row">${badge}<div class="cap-body"><div class="cap-id">${id}</div><div class="cap-title">${title !== id ? title : ""}</div>${desc}</div></div>`;
+  }).join("");
+
+  const changelogHtml = changelog
+    ? `<section><h2>Latest changes</h2><pre class="changelog">${changelog.replace(/</g, "&lt;")}</pre></section>`
+    : "";
+
+  return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>${policyId} v${version} — infernoflow snapshot</title>
+<style>
+  *{box-sizing:border-box;margin:0;padding:0}
+  body{background:#0f0f1a;color:#e2e8f0;font-family:'Segoe UI',system-ui,sans-serif;line-height:1.5;padding:0 0 3rem}
+  header{background:#1a1a2e;border-bottom:2px solid #f97316;padding:1.5rem 2rem}
+  header h1{font-size:1.5rem;font-weight:700;color:#f97316}
+  header .meta{color:#64748b;font-size:0.85rem;margin-top:0.25rem}
+  main{max-width:860px;margin:2rem auto;padding:0 1.5rem}
+  section{margin-bottom:2rem}
+  h2{font-size:0.8rem;text-transform:uppercase;letter-spacing:0.08em;color:#64748b;margin-bottom:0.75rem;padding-bottom:0.4rem;border-bottom:1px solid #2d2d4e}
+  .stats{display:flex;gap:1rem;flex-wrap:wrap;margin-bottom:2rem}
+  .stat{background:#1a1a2e;border:1px solid #2d2d4e;border-radius:8px;padding:1rem 1.5rem;min-width:130px}
+  .stat .n{font-size:2rem;font-weight:700;color:#f97316}
+  .stat .l{font-size:0.75rem;color:#64748b;margin-top:2px}
+  .cap-row{display:flex;align-items:flex-start;gap:0.75rem;padding:0.6rem 0;border-bottom:1px solid #1e1e30}
+  .cap-row:last-child{border-bottom:none}
+  .cov{font-size:0.9rem;min-width:18px;text-align:center;margin-top:2px}
+  .cov.yes{color:#4ade80}.cov.no{color:#f87171}.cov.uk{color:#475569}
+  .cap-id{font-weight:600;font-size:0.9rem}
+  .cap-title{color:#94a3b8;font-size:0.8rem}
+  .cap-desc{color:#64748b;font-size:0.78rem;margin-top:2px}
+  .changelog{background:#1a1a2e;border:1px solid #2d2d4e;border-radius:6px;padding:1rem;font-size:0.8rem;white-space:pre-wrap;color:#94a3b8;overflow-x:auto}
+  footer{text-align:center;color:#334155;font-size:0.75rem;margin-top:3rem}
+  footer a{color:#f97316;text-decoration:none}
+</style>
+</head>
+<body>
+<header>
+  <h1>🔥 ${policyId}</h1>
+  <div class="meta">v${version} · ${caps.length} capabilities · snapshot ${generatedAt}</div>
+</header>
+<main>
+  <div class="stats">
+    <div class="stat"><div class="n">${caps.length}</div><div class="l">capabilities</div></div>
+    <div class="stat"><div class="n">${caps.filter(c => typeof c === "object" && c.covered).length || "—"}</div><div class="l">covered</div></div>
+    <div class="stat"><div class="n">v${version}</div><div class="l">version</div></div>
+  </div>
+  <section>
+    <h2>Capabilities</h2>
+    <div>${capRows || '<p style="color:#475569">No capabilities yet.</p>'}</div>
+  </section>
+  ${changelogHtml}
+</main>
+<footer>Generated by <a href="https://github.com/ronmiz/infernoflow">infernoflow</a> on ${generatedAt}</footer>
+</body>
+</html>`;
+}
+
+// ── Upload to dpaste ──────────────────────────────────────────────────────────
+
+function uploadToDpaste(content) {
+  return new Promise((resolve, reject) => {
+    const body = `content=${encodeURIComponent(content)}&syntax=html&expiry_days=365`;
+    const req  = https.request({
+      hostname: "dpaste.com",
+      path:     "/api/v2/",
+      method:   "POST",
+      headers: {
+        "Content-Type":   "application/x-www-form-urlencoded",
+        "Content-Length": Buffer.byteLength(body),
+        "User-Agent":     "infernoflow-cli",
+      },
+    }, (res) => {
+      let data = "";
+      res.on("data", d => (data += d));
+      res.on("end", () => {
+        const url = data.trim();
+        if (url.startsWith("http")) resolve(url + ".html");
+        else reject(new Error("Unexpected response: " + data));
+      });
+    });
+    req.on("error", reject);
+    req.write(body);
+    req.end();
+  });
+}
+
+// ── Main ──────────────────────────────────────────────────────────────────────
+
+export async function shareCommand(rawArgs) {
+  const args       = rawArgs.slice(1);
+  const jsonMode   = args.includes("--json");
+  const openBrowser = args.includes("--open");
+  const upload     = args.includes("--upload");
+  const copyToClip = args.includes("--copy");
+  const outIdx     = args.indexOf("--out");
+  const cwd        = process.cwd();
+  const infernoDir = path.join(cwd, "inferno");
+
+  if (!fs.existsSync(infernoDir)) {
+    const msg = "inferno/ not found. Run: infernoflow init";
+    if (jsonMode) { console.log(JSON.stringify({ ok: false, error: msg })); } else { warn(msg); }
+    process.exit(1);
+  }
+
+  const contract = readContract(infernoDir);
+  if (!contract) {
+    const msg = "No contract.json found. Run: infernoflow init";
+    if (jsonMode) { console.log(JSON.stringify({ ok: false, error: msg })); } else { warn(msg); }
+    process.exit(1);
+  }
+
+  const changelog   = readChangelog(cwd);
+  const generatedAt = new Date().toLocaleString();
+  const htmlContent = buildHtml(contract, changelog, generatedAt);
+
+  const outPath = outIdx !== -1 ? args[outIdx + 1] : path.join(cwd, "inferno", "share.html");
+  fs.writeFileSync(outPath, htmlContent, "utf8");
+
+  let url = null;
+
+  if (upload) {
+    if (!jsonMode) info("Uploading to dpaste.com…");
+    try {
+      url = await uploadToDpaste(htmlContent);
+    } catch (err) {
+      if (!jsonMode) warn(`Upload failed: ${err.message}`);
+    }
+  }
+
+  if (copyToClip) {
+    try {
+      const cmd = process.platform === "win32" ? `echo ${JSON.stringify(htmlContent)} | clip`
+                : process.platform === "darwin" ? `pbcopy`
+                : `xclip -selection clipboard`;
+      if (process.platform === "darwin") {
+        const { execSync: ex } = await import("node:child_process");
+        const proc = ex;
+        require("child_process").execSync("pbcopy", { input: htmlContent });
+      } else {
+        execSync(cmd, { input: htmlContent });
+      }
+      if (!jsonMode) info("HTML copied to clipboard");
+    } catch {}
+  }
+
+  if (openBrowser) {
+    try {
+      const target = url || outPath;
+      const cmd = process.platform === "win32" ? `start "" "${target}"`
+                : process.platform === "darwin" ? `open "${target}"`
+                : `xdg-open "${target}"`;
+      execSync(cmd, { stdio: "ignore" });
+    } catch {}
+  }
+
+  if (jsonMode) {
+    console.log(JSON.stringify({ ok: true, file: outPath, url }));
+    return;
+  }
+
+  const caps = (contract.capabilities || []).length;
+  done(`Snapshot created — ${bold(String(caps))} capabilities`);
+  console.log();
+  console.log(`  File: ${cyan(outPath)}`);
+  if (url) console.log(`  URL:  ${cyan(url)}`);
+  console.log();
+  if (!url) {
+    console.log(`  ${gray("Share the file or run with --upload to get a public URL:")}`);
+    console.log(`  ${cyan("infernoflow share --upload --open")}`);
+  }
+  console.log();
+}