infernoflow 0.17.0 → 0.19.0

package/dist/lib/commands/report.mjs

@@ -0,0 +1,320 @@
+/**
+ * infernoflow report
+ *
+ * Generate a weekly/monthly HTML or Markdown report of capability changes,
+ * version history, drift events, and agent usage. Can be committed to the
+ * repo on a schedule or emailed to the team.
+ *
+ * Usage:
+ *   infernoflow report                   Generate HTML report (last 30 days)
+ *   infernoflow report --format md       Markdown instead of HTML
+ *   infernoflow report --since 7d        Last 7 days
+ *   infernoflow report --since 2024-01-01  Since a specific date
+ *   infernoflow report --out report.html   Custom output path
+ *   infernoflow report --open            Open in browser after generating
+ *   infernoflow report --json            Machine-readable summary
+ */
+
+import * as fs   from "node:fs";
+import * as path from "node:path";
+import { execSync, spawnSync } from "node:child_process";
+import { done, warn, info, bold, cyan, gray } from "../ui/output.mjs";
+
+// ── Git helpers ───────────────────────────────────────────────────────────────
+
+function git(cmd, cwd) {
+  try { return execSync(cmd, { cwd, encoding: "utf8", timeout: 15_000 }).trim(); }
+  catch { return ""; }
+}
+
+function parseSinceDuration(since) {
+  if (!since) return new Date(Date.now() - 30 * 24 * 60 * 60 * 1000);
+  if (/^\d+d$/.test(since)) return new Date(Date.now() - parseInt(since) * 24 * 60 * 60 * 1000);
+  if (/^\d+w$/.test(since)) return new Date(Date.now() - parseInt(since) * 7 * 24 * 60 * 60 * 1000);
+  if (/^\d{4}-\d{2}-\d{2}$/.test(since)) return new Date(since);
+  return new Date(Date.now() - 30 * 24 * 60 * 60 * 1000);
+}
+
+function getCommitsSince(cwd, since) {
+  const iso = since.toISOString();
+  const out = git(`git log --after="${iso}" --format="%H|%s|%an|%ad" --date=short`, cwd);
+  if (!out) return [];
+  return out.split("\n").filter(Boolean).map(line => {
+    const [hash, subject, author, date] = line.split("|");
+    return { hash: hash?.slice(0, 8), subject, author, date };
+  });
+}
+
+function getCapabilityHistory(infernoDir, cwd, since) {
+  const out = git(`git log --after="${since.toISOString()}" --format="%H|%ad" --date=short -- inferno/`, cwd);
+  if (!out) return [];
+  return out.split("\n").filter(Boolean).map(line => {
+    const [hash, date] = line.split("|");
+    return { hash: hash?.slice(0, 8), date };
+  });
+}
+
+function getVersionTags(cwd, since) {
+  const out = git(`git tag --sort=-version:refname`, cwd);
+  if (!out) return [];
+  return out.split("\n").filter(t => t.startsWith("v")).slice(0, 10).map(tag => {
+    const date = git(`git log -1 --format=%ad --date=short ${tag}`, cwd);
+    return { tag, date };
+  }).filter(t => !since || new Date(t.date) >= since);
+}
+
+// ── Data gathering ────────────────────────────────────────────────────────────
+
+function gatherData(cwd, infernoDir, since) {
+  const contract = (() => {
+    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 {};
+  })();
+
+  const caps    = contract.capabilities || [];
+  const covered = caps.filter(c => typeof c === "object" && c.covered).length;
+
+  const commits     = getCommitsSince(cwd, since);
+  const capCommits  = getCapabilityHistory(infernoDir, cwd, since);
+  const versionTags = getVersionTags(cwd, since);
+
+  const agents = (() => {
+    const dir = path.join(infernoDir, "agents");
+    if (!fs.existsSync(dir)) return [];
+    return fs.readdirSync(dir).filter(f => f.endsWith(".json")).map(f => {
+      try { return JSON.parse(fs.readFileSync(path.join(dir, f), "utf8")); }
+      catch { return null; }
+    }).filter(Boolean);
+  })();
+
+  const changelog = (() => {
+    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 + 20 : end).join("\n");
+    } catch { return null; }
+  })();
+
+  return {
+    project:      contract.policyId || path.basename(cwd),
+    version:      contract.policyVersion || "?",
+    caps,
+    covered,
+    commits,
+    capCommits,
+    versionTags,
+    agents,
+    changelog,
+    since,
+    generatedAt:  new Date().toLocaleString(),
+  };
+}
+
+// ── HTML report ───────────────────────────────────────────────────────────────
+
+function buildHtmlReport(data) {
+  const { project, version, caps, covered, commits, capCommits, versionTags, agents, changelog, since, generatedAt } = data;
+  const sinceStr = since.toLocaleDateString();
+  const coverage = caps.length ? Math.round((covered / caps.length) * 100) : 0;
+
+  const capRows = caps.slice(0, 30).map(c => {
+    const id  = typeof c === "string" ? c : c.id;
+    const cov = typeof c === "object" ? c.covered : undefined;
+    const badge = cov === true ? `<span style="color:#4ade80">✔</span>` : cov === false ? `<span style="color:#f87171">✗</span>` : `<span style="color:#475569">·</span>`;
+    return `<tr><td style="padding:4px 10px">${badge}</td><td style="padding:4px 10px;font-weight:600">${id}</td></tr>`;
+  }).join("");
+
+  const versionRows = versionTags.map(t =>
+    `<tr><td style="padding:4px 10px;font-weight:600">${t.tag}</td><td style="padding:4px 10px;color:#94a3b8">${t.date}</td></tr>`
+  ).join("") || `<tr><td colspan="2" style="padding:4px 10px;color:#475569">No version tags in this period</td></tr>`;
+
+  const agentRows = agents.map(a => {
+    const steps = (a.steps || []).map(s => typeof s === "string" ? s : s.command).join(" → ");
+    const conf  = a.confidence ? Math.round(a.confidence * 100) + "%" : "—";
+    return `<tr><td style="padding:4px 10px;font-weight:600">${a.name}</td><td style="padding:4px 10px;color:#94a3b8">${conf}</td><td style="padding:4px 10px;color:#64748b;font-size:0.8em">${steps}</td></tr>`;
+  }).join("") || `<tr><td colspan="3" style="padding:4px 10px;color:#475569">No agents synthesized yet</td></tr>`;
+
+  return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>infernoflow report — ${project}</title>
+<style>
+  *{box-sizing:border-box;margin:0;padding:0}
+  body{background:#0f0f1a;color:#e2e8f0;font-family:'Segoe UI',system-ui,sans-serif;padding:0 0 3rem}
+  header{background:#1a1a2e;border-bottom:2px solid #f97316;padding:1.5rem 2rem;display:flex;justify-content:space-between;align-items:flex-end}
+  header h1{font-size:1.4rem;font-weight:700;color:#f97316}
+  header .meta{color:#64748b;font-size:0.8rem}
+  main{max-width:960px;margin:2rem auto;padding:0 1.5rem}
+  .grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(150px,1fr));gap:1rem;margin-bottom:2rem}
+  .card{background:#1a1a2e;border:1px solid #2d2d4e;border-radius:8px;padding:1rem 1.25rem}
+  .card .n{font-size:2rem;font-weight:700;color:#f97316}
+  .card .l{font-size:0.72rem;color:#64748b;text-transform:uppercase;letter-spacing:0.06em;margin-top:2px}
+  .section{margin-bottom:2rem}
+  h2{font-size:0.78rem;text-transform:uppercase;letter-spacing:0.08em;color:#64748b;margin-bottom:0.6rem;padding-bottom:0.35rem;border-bottom:1px solid #2d2d4e}
+  table{width:100%;border-collapse:collapse;background:#1a1a2e;border:1px solid #2d2d4e;border-radius:6px;overflow:hidden;font-size:0.875rem}
+  tr:nth-child(even) td{background:#16162a}
+  .prog{background:#2d2d4e;border-radius:999px;height:8px;margin-top:6px}
+  .prog-bar{background:#f97316;border-radius:999px;height:100%;transition:width 0.3s}
+  pre{background:#1a1a2e;border:1px solid #2d2d4e;border-radius:6px;padding:1rem;font-size:0.78rem;white-space:pre-wrap;color:#94a3b8;overflow-x:auto}
+  footer{text-align:center;color:#334155;font-size:0.72rem;margin-top:3rem}
+  footer a{color:#f97316;text-decoration:none}
+</style>
+</head>
+<body>
+<header>
+  <div>
+    <h1>🔥 infernoflow report — ${project}</h1>
+    <div class="meta">v${version} · ${sinceStr} → ${generatedAt}</div>
+  </div>
+  <div class="meta" style="text-align:right">${commits.length} commits · ${capCommits.length} contract updates</div>
+</header>
+<main>
+  <div class="grid">
+    <div class="card"><div class="n">${caps.length}</div><div class="l">capabilities</div></div>
+    <div class="card"><div class="n">${coverage}%</div><div class="l">coverage</div><div class="prog"><div class="prog-bar" style="width:${coverage}%"></div></div></div>
+    <div class="card"><div class="n">${commits.length}</div><div class="l">commits</div></div>
+    <div class="card"><div class="n">${capCommits.length}</div><div class="l">contract updates</div></div>
+    <div class="card"><div class="n">${versionTags.length}</div><div class="l">releases</div></div>
+    <div class="card"><div class="n">${agents.length}</div><div class="l">agents</div></div>
+  </div>
+
+  <div class="section">
+    <h2>Capabilities (${caps.length})</h2>
+    <table><tbody>${capRows}${caps.length > 30 ? `<tr><td colspan="2" style="padding:6px 10px;color:#475569">… and ${caps.length - 30} more</td></tr>` : ""}</tbody></table>
+  </div>
+
+  <div class="section">
+    <h2>Version history</h2>
+    <table><tbody>${versionRows}</tbody></table>
+  </div>
+
+  <div class="section">
+    <h2>Agents (${agents.length})</h2>
+    <table><tbody>${agentRows}</tbody></table>
+  </div>
+
+  ${changelog ? `<div class="section"><h2>Latest changelog</h2><pre>${changelog.replace(/</g, "&lt;")}</pre></div>` : ""}
+</main>
+<footer>Generated by <a href="https://github.com/ronmiz/infernoflow">infernoflow</a> on ${generatedAt}</footer>
+</body>
+</html>`;
+}
+
+// ── Markdown report ───────────────────────────────────────────────────────────
+
+function buildMarkdownReport(data) {
+  const { project, version, caps, covered, commits, capCommits, versionTags, agents, changelog, since, generatedAt } = data;
+  const coverage = caps.length ? Math.round((covered / caps.length) * 100) : 0;
+
+  const lines = [
+    `# 🔥 infernoflow report — ${project}`,
+    ``,
+    `**Version:** v${version}  ·  **Period:** ${since.toLocaleDateString()} → ${generatedAt}`,
+    ``,
+    `## Summary`,
+    ``,
+    `| Metric | Value |`,
+    `|---|---|`,
+    `| Capabilities | ${caps.length} |`,
+    `| Coverage | ${coverage}% |`,
+    `| Commits | ${commits.length} |`,
+    `| Contract updates | ${capCommits.length} |`,
+    `| Releases | ${versionTags.length} |`,
+    `| Agents | ${agents.length} |`,
+    ``,
+    `## Capabilities`,
+    ``,
+    ...caps.slice(0, 30).map(c => {
+      const id  = typeof c === "string" ? c : c.id;
+      const cov = typeof c === "object" ? c.covered : undefined;
+      return `- ${cov === true ? "✅" : cov === false ? "❌" : "·"} **${id}**`;
+    }),
+    caps.length > 30 ? `- *… and ${caps.length - 30} more*` : "",
+    ``,
+    `## Version history`,
+    ``,
+    ...(versionTags.length
+      ? versionTags.map(t => `- **${t.tag}** — ${t.date}`)
+      : ["- *No releases in this period*"]),
+    ``,
+    `## Agents`,
+    ``,
+    ...(agents.length
+      ? agents.map(a => `- **${a.name}** (${a.confidence ? Math.round(a.confidence * 100) + "%" : "—"}) — ${a.description || ""}`)
+      : ["- *No agents synthesized yet*"]),
+    ``,
+    changelog ? `## Latest changelog\n\n\`\`\`\n${changelog}\n\`\`\`` : "",
+    ``,
+    `---`,
+    `*Generated by [infernoflow](https://github.com/ronmiz/infernoflow) on ${generatedAt}*`,
+  ];
+
+  return lines.filter(l => l !== undefined).join("\n");
+}
+
+// ── Main ──────────────────────────────────────────────────────────────────────
+
+export async function reportCommand(rawArgs) {
+  const args      = rawArgs.slice(1);
+  const jsonMode  = args.includes("--json");
+  const openBrowser = args.includes("--open");
+  const format    = args.includes("--format") ? args[args.indexOf("--format") + 1] : "html";
+  const sinceArg  = args.includes("--since") ? args[args.indexOf("--since") + 1] : null;
+  const outArg    = args.includes("--out") ? args[args.indexOf("--out") + 1] : null;
+  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);
+  }
+
+  if (!jsonMode) info(`Generating ${format} report…`);
+
+  const since = parseSinceDuration(sinceArg);
+  const data  = gatherData(cwd, infernoDir, since);
+
+  const ext       = format === "md" ? "md" : "html";
+  const outPath   = outArg || path.join(infernoDir, `report.${ext}`);
+  const content   = format === "md" ? buildMarkdownReport(data) : buildHtmlReport(data);
+
+  fs.writeFileSync(outPath, content, "utf8");
+
+  if (openBrowser && format === "html") {
+    try {
+      const cmd = process.platform === "win32" ? `start "" "${outPath}"`
+                : process.platform === "darwin" ? `open "${outPath}"`
+                : `xdg-open "${outPath}"`;
+      execSync(cmd, { stdio: "ignore" });
+    } catch {}
+  }
+
+  if (jsonMode) {
+    console.log(JSON.stringify({
+      ok: true,
+      file: outPath,
+      format,
+      project: data.project,
+      version: data.version,
+      capabilities: data.caps.length,
+      commits: data.commits.length,
+      agents: data.agents.length,
+    }));
+    return;
+  }
+
+  done(`Report generated`);
+  console.log(`  ${cyan(outPath)}`);
+  console.log(`  ${gray(data.caps.length + " capabilities · " + data.commits.length + " commits · " + data.agents.length + " agents")}`);
+  console.log();
+}

package/dist/lib/ui/errors.mjs

@@ -0,0 +1,142 @@
+/**
+ * Shared error handling utilities for infernoflow commands.
+ *
+ * Provides consistent, friendly error messages with actionable hints.
+ */
+
+import { warn, info, bold, cyan, gray, red } from "./output.mjs";
+
+// ── Common error types ────────────────────────────────────────────────────────
+
+export const ERR = {
+  NO_INFERNO_DIR:   "inferno/ directory not found.",
+  NO_CONTRACT:      "No contract.json or capabilities.json found.",
+  NO_GIT:           "This directory is not a git repository.",
+  NO_NETWORK:       "Network request failed.",
+  INVALID_JSON:     "Invalid JSON in response.",
+  PERMISSION:       "Permission denied.",
+  TIMEOUT:          "Command timed out.",
+};
+
+// ── Error formatter ───────────────────────────────────────────────────────────
+
+export function fatalError(message, hint, jsonMode = false) {
+  if (jsonMode) {
+    console.log(JSON.stringify({ ok: false, error: message, hint: hint || undefined }));
+  } else {
+    console.error();
+    console.error(`  ${red("✗")}  ${bold(message)}`);
+    if (hint) console.error(`     ${gray(hint)}`);
+    console.error();
+  }
+  process.exit(1);
+}
+
+export function softWarn(message, hint, jsonMode = false) {
+  if (!jsonMode) {
+    warn(message);
+    if (hint) console.error(`  ${gray(hint)}`);
+  }
+}
+
+// ── Pre-flight checks ─────────────────────────────────────────────────────────
+
+import * as fs   from "node:fs";
+import * as path from "node:path";
+import { execSync } from "node:child_process";
+
+/**
+ * Ensure inferno/ exists. Exits with a friendly message if not.
+ */
+export function requireInfernoDir(cwd, jsonMode = false) {
+  const infernoDir = path.join(cwd, "inferno");
+  if (!fs.existsSync(infernoDir)) {
+    fatalError(
+      ERR.NO_INFERNO_DIR,
+      "Run: infernoflow init   (or: infernoflow setup  for full setup)",
+      jsonMode
+    );
+  }
+  return infernoDir;
+}
+
+/**
+ * Ensure a git repo exists. Exits with a friendly message if not.
+ */
+export function requireGitRepo(cwd, jsonMode = false) {
+  try {
+    execSync("git rev-parse --git-dir", { cwd, stdio: "ignore" });
+  } catch {
+    fatalError(
+      ERR.NO_GIT,
+      "Run: git init && git add . && git commit -m 'init'",
+      jsonMode
+    );
+  }
+}
+
+/**
+ * Read and parse a JSON file, with a friendly error on failure.
+ */
+export function readJsonFile(filePath, label, jsonMode = false) {
+  if (!fs.existsSync(filePath)) return null;
+  try {
+    return JSON.parse(fs.readFileSync(filePath, "utf8"));
+  } catch (err) {
+    fatalError(
+      `Could not parse ${label}: ${err.message}`,
+      `Check the file for syntax errors: ${filePath}`,
+      jsonMode
+    );
+  }
+}
+
+/**
+ * Read contract.json or capabilities.json, whichever exists.
+ */
+export function readContract(infernoDir, jsonMode = false) {
+  for (const f of ["contract.json", "capabilities.json"]) {
+    const p = path.join(infernoDir, f);
+    const data = readJsonFile(p, f, jsonMode);
+    if (data) return data;
+  }
+  fatalError(ERR.NO_CONTRACT, "Run: infernoflow init", jsonMode);
+}
+
+/**
+ * Parse a semver string. Returns { major, minor, patch } or null.
+ */
+export function parseSemver(v) {
+  const m = String(v || "").match(/^(\d+)\.(\d+)\.(\d+)/);
+  if (!m) return null;
+  return { major: +m[1], minor: +m[2], patch: +m[3], raw: m[0] };
+}
+
+/**
+ * Validate a URL string. Returns true if valid http/https URL.
+ */
+export function isValidUrl(str) {
+  try {
+    const u = new URL(str);
+    return u.protocol === "http:" || u.protocol === "https:";
+  } catch { return false; }
+}
+
+/**
+ * Wrap an async command handler with top-level error catching.
+ * Prints a friendly message instead of a raw stack trace.
+ */
+export function withErrorHandling(fn, jsonMode = false) {
+  return fn().catch(err => {
+    if (jsonMode) {
+      console.log(JSON.stringify({ ok: false, error: err.message }));
+    } else {
+      console.error();
+      console.error(`  ${red("✗")}  ${bold("Unexpected error:")} ${err.message}`);
+      if (process.env.DEBUG) console.error(err.stack);
+      else console.error(`     ${gray("Set DEBUG=1 for a full stack trace.")}`);
+      console.error();
+    }
+    process.exit(1);
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "infernoflow",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "description": "The forge for liquid code - keep capabilities, contracts, and docs in sync.",
   "type": "module",
   "bin": {