infernoflow 0.18.0 → 0.20.0

package/dist/lib/commands/dashboard.mjs

@@ -80,6 +80,92 @@ function runCheck(infernoDir) {
   }
 }
 
+// ── Analytics data loaders ────────────────────────────────────────────────────
+
+function loadAudit(infernoDir) {
+  const p = path.join(infernoDir, "audit.json");
+  if (!fs.existsSync(p)) return null;
+  try { return JSON.parse(fs.readFileSync(p, "utf8")); } catch { return null; }
+}
+
+function loadLinks(infernoDir) {
+  const p = path.join(infernoDir, "links.json");
+  if (!fs.existsSync(p)) return [];
+  try { return JSON.parse(fs.readFileSync(p, "utf8")); } catch { return []; }
+}
+
+/**
+ * Parse git log for inferno/ directory to build analytics:
+ *   - capability velocity (caps added/removed per week)
+ *   - contributor activity (commits per author)
+ *   - health score trend (from check logs or heuristic via commit frequency)
+ */
+function loadGitAnalytics(cwd, infernoDir) {
+  try {
+    // Commits touching inferno/ in past 90 days (iso date, author email, subject)
+    const raw = execSync(
+      `git log --since="90 days ago" --format="%aI|%ae|%s" -- inferno/`,
+      { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"], timeout: 8000 }
+    ).trim();
+
+    if (!raw) return { velocity: [], contributors: [], healthTrend: [] };
+
+    const commits = raw.split("\n").filter(Boolean).map(line => {
+      const [date, email, ...subjectParts] = line.split("|");
+      return { date: new Date(date), email: email || "unknown", subject: subjectParts.join("|") };
+    });
+
+    // Bucket by ISO week (YYYY-Www)
+    function isoWeek(d) {
+      const dt  = new Date(Date.UTC(d.getFullYear(), d.getMonth(), d.getDate()));
+      const day = dt.getUTCDay() || 7;
+      dt.setUTCDate(dt.getUTCDate() + 4 - day);
+      const yearStart = new Date(Date.UTC(dt.getUTCFullYear(), 0, 1));
+      const week = Math.ceil((((dt - yearStart) / 86400000) + 1) / 7);
+      return `${dt.getUTCFullYear()}-W${String(week).padStart(2, "0")}`;
+    }
+
+    // Velocity: commits per week
+    const weekMap = new Map();
+    for (const c of commits) {
+      const w = isoWeek(c.date);
+      weekMap.set(w, (weekMap.get(w) || 0) + 1);
+    }
+    // Fill in the last 13 weeks
+    const velocity = [];
+    const now = new Date();
+    for (let i = 12; i >= 0; i--) {
+      const d = new Date(now);
+      d.setDate(d.getDate() - i * 7);
+      const w = isoWeek(d);
+      velocity.push({ week: w, commits: weekMap.get(w) || 0 });
+    }
+
+    // Contributors: unique authors, sorted by commit count
+    const authorMap = new Map();
+    for (const c of commits) {
+      const name = c.email.split("@")[0];
+      authorMap.set(name, (authorMap.get(name) || 0) + 1);
+    }
+    const contributors = [...authorMap.entries()]
+      .map(([name, count]) => ({ name, count }))
+      .sort((a, b) => b.count - a.count)
+      .slice(0, 8);
+
+    // Health trend: simple heuristic from commit density per week
+    // More commits → more drift activity. We mark weeks with >3 commits as "busy" (amber), 0 = stale, else ok
+    const healthTrend = velocity.map(v => ({
+      week:  v.week,
+      score: v.commits === 0 ? 40 : v.commits <= 2 ? 75 : v.commits <= 5 ? 90 : 85,
+      label: v.commits === 0 ? "stale" : v.commits <= 2 ? "ok" : v.commits <= 5 ? "healthy" : "busy",
+    }));
+
+    return { velocity, contributors, healthTrend };
+  } catch {
+    return { velocity: [], contributors: [], healthTrend: [] };
+  }
+}
+
 function gatherData(infernoDir) {
   const caps     = loadCapabilities(infernoDir);
   const contract = loadContract(infernoDir);
@@ -87,19 +173,74 @@ function gatherData(infernoDir) {
   const agents   = loadAgents(infernoDir);
   const hookLog  = loadHookLog(infernoDir);
   const check    = runCheck(infernoDir);
+  const audit    = loadAudit(infernoDir);
+  const links    = loadLinks(infernoDir);
   const sessions = profile?.recentSessions?.slice(-10) || [];
   const candidates = [
     ...(profile?.agentCandidates || []),
     ...(profile?.skillCandidates || []),
   ];
+  const cwd       = path.dirname(infernoDir);
+  const analytics = loadGitAnalytics(cwd, infernoDir);
+
+  return { caps, contract, agents, hookLog, check, sessions, candidates, audit, links, analytics, infernoDir };
+}
+
+// ── HTML builder ──────────────────────────────────────────────────────────────
+
+// ── SVG chart builders ────────────────────────────────────────────────────────
+
+function barChart(values, labels, color = "#f97316", height = 80) {
+  const W = 600, H = height;
+  const n = values.length;
+  if (!n) return `<svg width="${W}" height="${H}"></svg>`;
+  const max   = Math.max(...values, 1);
+  const bw    = Math.floor(W / n) - 4;
+  const bars  = values.map((v, i) => {
+    const bh = Math.max(2, Math.round((v / max) * (H - 20)));
+    const x  = i * (W / n) + 2;
+    const y  = H - bh - 10;
+    return `<rect x="${x}" y="${y}" width="${bw}" height="${bh}" fill="${color}" rx="2" opacity="0.85"/>
+            <title>${labels[i]}: ${v}</title>`;
+  }).join("\n");
+  return `<svg viewBox="0 0 ${W} ${H}" width="100%" height="${H}" xmlns="http://www.w3.org/2000/svg">${bars}</svg>`;
+}
 
-  return { caps, contract, agents, hookLog, check, sessions, candidates, infernoDir };
+function lineChart(values, color = "#3b82f6", height = 80) {
+  const W = 600, H = height;
+  const n = values.length;
+  if (n < 2) return `<svg width="${W}" height="${H}"></svg>`;
+  const max  = Math.max(...values, 1);
+  const min  = Math.min(...values, 0);
+  const range = max - min || 1;
+  const pts  = values.map((v, i) => {
+    const x = Math.round((i / (n - 1)) * (W - 20)) + 10;
+    const y = Math.round(H - 10 - ((v - min) / range) * (H - 20));
+    return `${x},${y}`;
+  }).join(" ");
+  return `<svg viewBox="0 0 ${W} ${H}" width="100%" height="${H}" xmlns="http://www.w3.org/2000/svg">
+    <polyline points="${pts}" fill="none" stroke="${color}" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"/>
+    ${values.map((v, i) => {
+      const [px, py] = pts.split(" ")[i].split(",");
+      return `<circle cx="${px}" cy="${py}" r="4" fill="${color}"><title>${v}</title></circle>`;
+    }).join("")}
+  </svg>`;
+}
+
+function heatRow(name, count, maxCount) {
+  const pct  = maxCount > 0 ? Math.round((count / maxCount) * 100) : 0;
+  const fill = pct > 70 ? "#f97316" : pct > 40 ? "#f59e0b" : pct > 10 ? "#3b82f6" : "#2d3148";
+  return `<div class="heat-row">
+    <span class="heat-name">${esc(name)}</span>
+    <div class="heat-bar-wrap"><div class="heat-bar" style="width:${pct}%;background:${fill}"></div></div>
+    <span class="heat-count">${count}</span>
+  </div>`;
 }
 
 // ── HTML builder ──────────────────────────────────────────────────────────────
 
 function buildHtml(data, projectName) {
-  const { caps, agents, check, sessions, candidates } = data;
+  const { caps, agents, check, sessions, candidates, audit, links, analytics } = data;
 
   const statusColor = check?.status === "ok"      ? "#22c55e"
                     : check?.status === "warning"  ? "#f59e0b"
@@ -153,6 +294,29 @@ function buildHtml(data, projectName) {
     `<li class="candidate">${esc(c.name || c.id || "unnamed")}: ${esc(c.description || "")}</li>`
   ).join("\n");
 
+  // ── Analytics ─────────────────────────────────────────────────────────────
+  const vel    = analytics?.velocity    || [];
+  const contribs = analytics?.contributors || [];
+  const trend  = analytics?.healthTrend || [];
+
+  const velValues  = vel.map(v => v.commits);
+  const velLabels  = vel.map(v => v.week);
+  const velChart   = barChart(velValues, velLabels, "#f97316", 90);
+
+  const trendValues = trend.map(t => t.score);
+  const trendChart  = lineChart(trendValues, "#3b82f6", 80);
+
+  const maxContrib = contribs.length ? Math.max(...contribs.map(c => c.count)) : 1;
+  const heatRows   = contribs.length
+    ? contribs.map(c => heatRow(c.name, c.count, maxContrib)).join("\n")
+    : `<div class="empty">No git history in inferno/ yet</div>`;
+
+  // Audit summary card
+  const auditStats   = audit?.stats || null;
+  const auditHigh    = auditStats?.high ?? "—";
+  const auditMedium  = auditStats?.medium ?? "—";
+  const linkedCount  = links.length;
+
   return `<!DOCTYPE html>
 <html lang="en">
 <head>
@@ -200,6 +364,22 @@ function buildHtml(data, projectName) {
   .session-item:last-child { border-bottom: none; }
   .session-date { font-size: 11px; color: var(--muted); white-space: nowrap; min-width: 140px; }
   .session-cmds { font-size: 12px; color: var(--text); }
+  /* Analytics */
+  .chart-wrap { padding: 16px 18px; }
+  .chart-label { font-size: 11px; color: var(--muted); margin-top: 6px; text-align: center; }
+  .analytics-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 20px; }
+  .heat-row { display: flex; align-items: center; gap: 10px; padding: 6px 18px; border-bottom: 1px solid var(--border); }
+  .heat-row:last-child { border-bottom: none; }
+  .heat-name  { min-width: 110px; font-size: 12px; color: var(--text); font-family: monospace; }
+  .heat-bar-wrap { flex: 1; height: 10px; background: var(--border); border-radius: 5px; overflow: hidden; }
+  .heat-bar   { height: 100%; border-radius: 5px; transition: width 0.3s; }
+  .heat-count { font-size: 12px; color: var(--muted); min-width: 30px; text-align: right; }
+  .audit-tags { display: flex; gap: 8px; padding: 14px 18px; flex-wrap: wrap; }
+  .tag { font-size: 12px; padding: 4px 10px; border-radius: 9px; font-weight: 600; }
+  .tag-high   { background: rgba(239,68,68,0.15);  color: #ef4444; }
+  .tag-medium { background: rgba(245,158,11,0.15); color: #f59e0b; }
+  .tag-low    { background: rgba(34,197,94,0.15);  color: #22c55e; }
+  .tag-link   { background: rgba(59,130,246,0.15); color: #3b82f6; }
   footer { text-align: center; color: var(--muted); font-size: 11px; padding: 24px; }
 </style>
 </head>
@@ -236,6 +416,17 @@ function buildHtml(data, projectName) {
       <div class="value">${sessions.length}</div>
       <div class="sub">recent sessions logged</div>
     </div>
+    ${auditStats ? `
+    <div class="card">
+      <div class="label">Security surface</div>
+      <div class="value" style="color:${auditHigh > 0 ? "var(--red)" : "var(--green)"}">${auditHigh}</div>
+      <div class="sub">${auditHigh} high · ${auditMedium} medium risk caps</div>
+    </div>` : ""}
+    <div class="card">
+      <div class="label">Linked tickets</div>
+      <div class="value" style="color:var(--blue)">${linkedCount}</div>
+      <div class="sub">caps linked to Jira/Linear/GitHub</div>
+    </div>
   </div>
 
   ${issueCount > 0 ? `
@@ -279,6 +470,61 @@ function buildHtml(data, projectName) {
       : `<div class="empty">No session data yet — sessions are logged automatically as you use infernoflow</div>`}
   </section>
 
+  <!-- Analytics: velocity + health trend -->
+  ${vel.length > 0 ? `
+  <div class="analytics-grid">
+    <section>
+      <h2>📈 Capability Velocity (13 weeks)</h2>
+      <div class="chart-wrap">
+        ${velChart}
+        <div class="chart-label">Commits touching inferno/ per week</div>
+      </div>
+    </section>
+    <section>
+      <h2>💚 Health Score Trend</h2>
+      <div class="chart-wrap">
+        ${trendChart}
+        <div class="chart-label">Heuristic health score over last 13 weeks</div>
+      </div>
+    </section>
+  </div>` : ""}
+
+  <!-- Contributor heatmap -->
+  ${contribs.length > 0 ? `
+  <section>
+    <h2>👥 Contributor Heatmap (90 days)</h2>
+    ${heatRows}
+  </section>` : ""}
+
+  <!-- Audit surface map (if audit.json exists) -->
+  ${auditStats ? `
+  <section>
+    <h2>🔐 Security Surface (last audit)</h2>
+    <div class="audit-tags">
+      <span class="tag tag-high">🔴 ${auditStats.high} HIGH</span>
+      <span class="tag tag-medium">🟡 ${auditStats.medium} MEDIUM</span>
+      <span class="tag tag-low">🟢 ${auditStats.low} LOW</span>
+      ${linkedCount > 0 ? `<span class="tag tag-link">🔗 ${linkedCount} linked to tickets</span>` : ""}
+    </div>
+    ${audit.capabilities ? `
+    <table>
+      <thead><tr><th>Severity</th><th>Capability</th><th>Tags</th></tr></thead>
+      <tbody>
+        ${audit.capabilities.filter(c => c.severity === "high" || c.severity === "medium").slice(0, 10).map(c => `
+        <tr>
+          <td style="color:${c.severity === "high" ? "var(--red)" : "var(--yellow)"}">${c.severity}</td>
+          <td><code>${esc(c.id)}</code></td>
+          <td>${esc((c.tags || []).join(", "))}</td>
+        </tr>`).join("")}
+      </tbody>
+    </table>` : ""}
+    <div style="padding:8px 18px;font-size:11px;color:var(--muted)">Run <code>infernoflow audit</code> to refresh · Last run: ${esc(audit.runAt ? new Date(audit.runAt).toLocaleString() : "unknown")}</div>
+  </section>` : `
+  <section>
+    <h2>🔐 Security Surface</h2>
+    <div class="empty">No audit data yet — run <code>infernoflow audit</code> to classify capabilities by security sensitivity</div>
+  </section>`}
+
 </main>
 <footer>infernoflow dashboard · auto-refreshes every 10s · <a href="/" style="color:var(--muted)">refresh now</a></footer>
 <script>

package/dist/lib/commands/export.mjs

@@ -0,0 +1,239 @@
+/**
+ * infernoflow export
+ *
+ * Export the capability contract to external formats so it can travel
+ * outside the repo — into API docs, service catalogs, spreadsheets, wikis.
+ *
+ * Formats:
+ *   openapi      OpenAPI 3.1 JSON (stubs for each capability)
+ *   backstage    Backstage catalog-info.yaml
+ *   csv          Spreadsheet-ready CSV
+ *   markdown     Confluence/Notion-ready Markdown table
+ *   json         Clean JSON (normalised, no internal infernoflow fields)
+ *
+ * Usage:
+ *   infernoflow export --format openapi
+ *   infernoflow export --format backstage --out catalog-info.yaml
+ *   infernoflow export --format csv --out capabilities.csv
+ *   infernoflow export --format markdown
+ *   infernoflow export --format json --out contract-export.json
+ */
+
+import * as fs   from "node:fs";
+import * as path from "node:path";
+import { done, warn, info, bold, cyan, gray } from "../ui/output.mjs";
+
+// ── Contract reader ───────────────────────────────────────────────────────────
+
+function readContract(infernoDir) {
+  for (const f of ["contract.json", "capabilities.json"]) {
+    const p = path.join(infernoDir, f);
+    if (!fs.existsSync(p)) continue;
+    try { return JSON.parse(fs.readFileSync(p, "utf8")); } catch {}
+  }
+  return null;
+}
+
+function normaliseCaps(contract) {
+  const raw = contract?.capabilities || [];
+  return raw.map(c => {
+    if (typeof c === "string") return { id: c, description: "", tags: [], status: "active" };
+    return {
+      id:          c.id || c.name || "unknown",
+      description: c.description || "",
+      tags:        c.tags || [],
+      status:      c.status || "active",
+      since:       c.since || "",
+      owner:       c.owner || "",
+    };
+  });
+}
+
+function readMeta(infernoDir) {
+  const pkgPath = path.join(path.dirname(infernoDir), "package.json");
+  try {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+    return { name: pkg.name || "my-service", version: pkg.version || "0.0.0", description: pkg.description || "" };
+  } catch {
+    return { name: path.basename(path.dirname(infernoDir)), version: "0.0.0", description: "" };
+  }
+}
+
+// ── Formatters ────────────────────────────────────────────────────────────────
+
+function toOpenApi(caps, meta) {
+  const paths = {};
+  for (const cap of caps) {
+    const route = `/${cap.id.replace(/_/g, "-")}`;
+    paths[route] = {
+      get: {
+        operationId: cap.id,
+        summary:     cap.description || cap.id,
+        tags:        cap.tags.length ? cap.tags : [meta.name],
+        parameters:  [],
+        responses: {
+          "200": { description: "Success", content: { "application/json": { schema: { type: "object" } } } },
+          "401": { description: "Unauthorized" },
+          "500": { description: "Internal Server Error" },
+        },
+      },
+    };
+  }
+
+  return JSON.stringify({
+    openapi: "3.1.0",
+    info: {
+      title:       meta.name,
+      version:     meta.version,
+      description: meta.description || `Capability contract for ${meta.name}`,
+    },
+    paths,
+    components: { schemas: {}, securitySchemes: {} },
+  }, null, 2);
+}
+
+function toBackstage(caps, meta) {
+  const tags = [...new Set(caps.flatMap(c => c.tags))].slice(0, 10);
+  const lines = [
+    `apiVersion: backstage.io/v1alpha1`,
+    `kind: Component`,
+    `metadata:`,
+    `  name: ${meta.name}`,
+    `  description: "${(meta.description || meta.name).replace(/"/g, '\\"')}"`,
+    `  annotations:`,
+    `    infernoflow/capability-count: "${caps.length}"`,
+    `    infernoflow/generated-at: "${new Date().toISOString()}"`,
+    tags.length ? `  tags:\n${tags.map(t => `    - ${t}`).join("\n")}` : "",
+    `spec:`,
+    `  type: service`,
+    `  lifecycle: production`,
+    `  owner: team-default`,
+    `  providesApis: []`,
+    `---`,
+    `# Capabilities`,
+    ...caps.map(c => [
+      `# ${c.id}`,
+      `#   ${c.description || "(no description)"}`,
+      `#   tags: ${c.tags.join(", ") || "none"}`,
+      `#   status: ${c.status}`,
+    ].join("\n")),
+  ].filter(Boolean);
+  return lines.join("\n") + "\n";
+}
+
+function toCsv(caps) {
+  const header = ["id", "description", "tags", "status", "since", "owner"];
+  const rows   = caps.map(c => [
+    c.id,
+    (c.description || "").replace(/"/g, '""'),
+    c.tags.join("|"),
+    c.status,
+    c.since,
+    c.owner,
+  ].map(v => `"${v}"`).join(","));
+  return [header.join(","), ...rows].join("\n") + "\n";
+}
+
+function toMarkdown(caps, meta) {
+  const lines = [
+    `# ${meta.name} — Capability Contract`,
+    ``,
+    `> Generated by infernoflow on ${new Date().toISOString().slice(0, 10)}`,
+    `> ${caps.length} capabilities tracked`,
+    ``,
+    `| Capability | Description | Tags | Status |`,
+    `|---|---|---|---|`,
+    ...caps.map(c =>
+      `| \`${c.id}\` | ${c.description || ""} | ${c.tags.join(", ") || "—"} | ${c.status} |`
+    ),
+    ``,
+  ];
+  return lines.join("\n");
+}
+
+function toCleanJson(caps, meta) {
+  return JSON.stringify({
+    name:        meta.name,
+    version:     meta.version,
+    exportedAt:  new Date().toISOString(),
+    capabilities: caps,
+  }, null, 2) + "\n";
+}
+
+// ── Entry ─────────────────────────────────────────────────────────────────────
+
+const FORMAT_EXT = {
+  openapi:   "openapi.json",
+  backstage: "catalog-info.yaml",
+  csv:       "capabilities.csv",
+  markdown:  "capabilities.md",
+  json:      "capabilities-export.json",
+};
+
+export async function exportCommand(rawArgs) {
+  const args      = rawArgs.slice(1);
+  const jsonMode  = args.includes("--json");
+  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 fmtIdx   = args.indexOf("--format");
+  const format   = fmtIdx !== -1 ? args[fmtIdx + 1] : null;
+  const outIdx   = args.indexOf("--out");
+  const outArg   = outIdx !== -1 ? args[outIdx + 1] : null;
+
+  const validFormats = Object.keys(FORMAT_EXT);
+
+  if (!format || !validFormats.includes(format)) {
+    const msg = `Usage: infernoflow export --format <${validFormats.join("|")}> [--out <path>]`;
+    if (jsonMode) console.log(JSON.stringify({ ok: false, error: msg }));
+    else {
+      warn(msg);
+      console.log();
+      console.log(`  ${gray("Available formats:")}`);
+      console.log(`  ${bold("openapi")}   — OpenAPI 3.1 JSON with a stub path per capability`);
+      console.log(`  ${bold("backstage")} — Backstage catalog-info.yaml component definition`);
+      console.log(`  ${bold("csv")}       — Spreadsheet-ready CSV`);
+      console.log(`  ${bold("markdown")} — Confluence/Notion table`);
+      console.log(`  ${bold("json")}      — Clean normalised JSON`);
+      console.log();
+    }
+    return;
+  }
+
+  const contract = readContract(infernoDir);
+  if (!contract) {
+    const msg = "No contract.json or capabilities.json found.";
+    if (jsonMode) console.log(JSON.stringify({ ok: false, error: msg }));
+    else warn(msg);
+    process.exit(1);
+  }
+
+  const caps = normaliseCaps(contract);
+  const meta = readMeta(infernoDir);
+  const outPath = outArg || path.join(cwd, FORMAT_EXT[format]);
+
+  let output;
+  switch (format) {
+    case "openapi":   output = toOpenApi(caps, meta);   break;
+    case "backstage": output = toBackstage(caps, meta); break;
+    case "csv":       output = toCsv(caps);             break;
+    case "markdown":  output = toMarkdown(caps, meta);  break;
+    case "json":      output = toCleanJson(caps, meta); break;
+  }
+
+  fs.writeFileSync(outPath, output);
+
+  if (jsonMode) {
+    console.log(JSON.stringify({ ok: true, format, file: outPath, capabilities: caps.length }));
+  } else {
+    done(`Exported ${bold(String(caps.length))} capabilities → ${cyan(path.relative(cwd, outPath))}`);
+    console.log();
+  }
+}