infernoflow 0.19.0 → 0.21.0

package/dist/lib/commands/vibe.mjs

@@ -0,0 +1,365 @@
+/**
+ * infernoflow vibe
+ *
+ * Persistent background process for vibe coding sessions.
+ * Completely invisible to the developer — just leave it running in a terminal.
+ *
+ * What it does every cycle:
+ *   1. Watches source files for saves
+ *   2. On save: runs infernoflow suggest to sync the contract
+ *   3. Regenerates CONTEXT.md so the next AI prompt is always fresh
+ *   4. Watches inferno/ for contract changes → updates CONTEXT.md automatically
+ *   5. Prints a one-line status ticker — nothing noisy
+ *
+ * Also provides a session summary on exit (Ctrl+C):
+ *   - Files changed
+ *   - Capabilities added / updated
+ *   - Health score delta
+ *
+ * Usage:
+ *   infernoflow vibe                    Start vibe mode (default dirs)
+ *   infernoflow vibe --dir src,api      Watch specific directories
+ *   infernoflow vibe --no-suggest       Watch + context only, skip suggest
+ *   infernoflow vibe --no-context       Skip CONTEXT.md regeneration
+ *   infernoflow vibe --interval 5       Debounce seconds (default 4)
+ *   infernoflow vibe --silent           Suppress all output (pure background)
+ *   infernoflow vibe --port 7337        Also start dashboard on this port
+ */
+
+import * as fs          from "node:fs";
+import * as path        from "node:path";
+import * as http        from "node:http";
+import * as os          from "node:os";
+import { execSync, spawnSync } from "node:child_process";
+import { bold, cyan, gray, green, yellow, red, info, warn } from "../ui/output.mjs";
+
+// ── Helpers ───────────────────────────────────────────────────────────────────
+
+const SOURCE_EXTENSIONS = new Set([".js", ".mjs", ".cjs", ".ts", ".tsx", ".jsx", ".py", ".rb", ".go", ".rs"]);
+const IGNORE_DIRS       = new Set(["node_modules", ".git", "dist", "build", ".next", "__pycache__", "vendor", "coverage", "inferno"]);
+
+function runCli(args, cwd, silent = false) {
+  const result = spawnSync("infernoflow", args, {
+    cwd,
+    encoding: "utf8",
+    env: { ...process.env, NO_COLOR: "1" },
+    timeout: 30_000,
+    stdio: ["ignore", "pipe", "pipe"],
+  });
+  if (!silent && result.error) return { ok: false, out: "", err: result.error.message };
+  return { ok: result.status === 0, out: result.stdout || "", err: result.stderr || "" };
+}
+
+function timestamp() {
+  return new Date().toLocaleTimeString("en-US", { hour12: false });
+}
+
+function readContractCapCount(infernoDir) {
+  for (const f of ["contract.json", "capabilities.json"]) {
+    const p = path.join(infernoDir, f);
+    if (!fs.existsSync(p)) continue;
+    try {
+      const data = JSON.parse(fs.readFileSync(p, "utf8"));
+      return (data.capabilities || []).length;
+    } catch {}
+  }
+  return 0;
+}
+
+function readHealthScore(cwd) {
+  const result = spawnSync("infernoflow", ["health", "--json"], {
+    cwd, encoding: "utf8", timeout: 20_000, stdio: ["ignore", "pipe", "pipe"],
+    env: { ...process.env, NO_COLOR: "1" },
+  });
+  try { return JSON.parse(result.stdout || "{}").score ?? null; } catch { return null; }
+}
+
+// ── Session state ─────────────────────────────────────────────────────────────
+
+class VibeSession {
+  constructor() {
+    this.startedAt      = new Date();
+    this.filesChanged   = new Set();
+    this.suggestRuns    = 0;
+    this.contextUpdates = 0;
+    this.capsAtStart    = 0;
+    this.capsNow        = 0;
+    this.scoreAtStart   = null;
+    this.scoreNow       = null;
+  }
+
+  recordChange(filePath) { this.filesChanged.add(filePath); }
+  recordSuggest()        { this.suggestRuns++; }
+  recordContext()        { this.contextUpdates++; }
+
+  elapsed() {
+    const ms   = Date.now() - this.startedAt.getTime();
+    const mins = Math.floor(ms / 60000);
+    const secs = Math.floor((ms % 60000) / 1000);
+    return mins > 0 ? `${mins}m ${secs}s` : `${secs}s`;
+  }
+
+  printSummary() {
+    const capDelta   = this.capsNow - this.capsAtStart;
+    const scoreDelta = this.scoreNow !== null && this.scoreAtStart !== null
+      ? this.scoreNow - this.scoreAtStart : null;
+
+    console.log();
+    console.log(`  ${bold("🔥 infernoflow vibe — session summary")}`);
+    console.log();
+    console.log(`  ${bold("Duration:")}      ${this.elapsed()}`);
+    console.log(`  ${bold("Files watched:")} ${this.filesChanged.size}`);
+    console.log(`  ${bold("Syncs run:")}     ${this.suggestRuns}`);
+    console.log(`  ${bold("Context refreshes:")} ${this.contextUpdates}`);
+
+    if (capDelta !== 0) {
+      const col = capDelta > 0 ? green : yellow;
+      console.log(`  ${bold("Capabilities:")}  ${col((capDelta > 0 ? "+" : "") + capDelta)} (${this.capsAtStart} → ${this.capsNow})`);
+    } else {
+      console.log(`  ${bold("Capabilities:")}  ${this.capsNow} (no change)`);
+    }
+
+    if (scoreDelta !== null) {
+      const col = scoreDelta > 0 ? green : scoreDelta < 0 ? yellow : gray;
+      console.log(`  ${bold("Health score:")}  ${col((scoreDelta > 0 ? "+" : "") + scoreDelta)} (${this.scoreAtStart} → ${this.scoreNow})`);
+    }
+
+    console.log();
+  }
+}
+
+// ── Status ticker ─────────────────────────────────────────────────────────────
+
+const SPINNERS = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+let spinIdx = 0;
+
+function tick(msg, col = gray) {
+  const spinner = SPINNERS[spinIdx++ % SPINNERS.length];
+  process.stdout.write(`\r  ${col(spinner)}  ${msg}                    `);
+}
+
+function tickDone(msg) {
+  process.stdout.write(`\r  ${green("✔")}  ${msg}                    \n`);
+}
+
+function tickWarn(msg) {
+  process.stdout.write(`\r  ${yellow("⚠")}  ${msg}                    \n`);
+}
+
+// ── Core cycle ────────────────────────────────────────────────────────────────
+
+async function runCycle(changedFile, cwd, infernoDir, opts, session) {
+  const rel = path.relative(cwd, changedFile);
+  session.recordChange(changedFile);
+
+  if (!opts.silent) tick(`${cyan(rel)} changed — syncing…`, cyan);
+
+  // 1. Suggest (sync contract)
+  if (!opts.noSuggest) {
+    const desc = `updated ${path.basename(changedFile)}`;
+    const r    = runCli(["suggest", desc, "--json"], cwd, true);
+    session.recordSuggest();
+
+    if (!opts.silent) {
+      if (r.ok) {
+        tickDone(`Synced: ${cyan(rel)}`);
+      } else {
+        tickWarn(`Suggest skipped (${gray("no AI provider")})`);
+      }
+    }
+  }
+
+  // 2. Regenerate CONTEXT.md
+  if (!opts.noContext) {
+    const r = runCli(["context"], cwd, true);
+    session.recordContext();
+    if (!opts.silent && r.ok) {
+      tick(`Context refreshed`, gray);
+    }
+  }
+
+  // 3. Update cap count
+  session.capsNow = readContractCapCount(infernoDir);
+}
+
+// ── File watcher ──────────────────────────────────────────────────────────────
+
+function watchDirs(dirs, cwd, infernoDir, opts, session) {
+  const watchers = [];
+  const debounceMap = new Map();
+
+  const onFileChange = (eventType, filePath) => {
+    if (!SOURCE_EXTENSIONS.has(path.extname(filePath))) return;
+    if ([...IGNORE_DIRS].some(d => filePath.includes(`${path.sep}${d}${path.sep}`))) return;
+
+    // Debounce per file
+    if (debounceMap.has(filePath)) clearTimeout(debounceMap.get(filePath));
+    debounceMap.set(filePath, setTimeout(async () => {
+      debounceMap.delete(filePath);
+      await runCycle(filePath, cwd, infernoDir, opts, session);
+    }, opts.interval * 1000));
+  };
+
+  for (const dir of dirs) {
+    if (!fs.existsSync(dir)) continue;
+    try {
+      const w = fs.watch(dir, { recursive: true }, (eventType, filename) => {
+        if (!filename) return;
+        onFileChange(eventType, path.join(dir, filename));
+      });
+      watchers.push(w);
+    } catch {}
+  }
+
+  // Also watch inferno/ for contract changes → regenerate CONTEXT.md
+  try {
+    const iw = fs.watch(infernoDir, { recursive: true }, (eventType, filename) => {
+      if (!filename) return;
+      if (!filename.endsWith(".json") && !filename.endsWith(".md")) return;
+      if (filename.includes("CONTEXT")) return; // avoid loop
+
+      if (debounceMap.has("__inferno__")) clearTimeout(debounceMap.get("__inferno__"));
+      debounceMap.set("__inferno__", setTimeout(async () => {
+        debounceMap.delete("__inferno__");
+        if (!opts.noContext) {
+          runCli(["context"], cwd, true);
+          session.recordContext();
+          if (!opts.silent) tick(`Contract updated — context refreshed`, gray);
+        }
+        session.capsNow = readContractCapCount(infernoDir);
+      }, 1000));
+    });
+    watchers.push(iw);
+  } catch {}
+
+  return watchers;
+}
+
+// ── Dashboard mini-server ─────────────────────────────────────────────────────
+
+function startMiniDashboard(port, cwd, infernoDir) {
+  const server = http.createServer((req, res) => {
+    if (req.url === "/status") {
+      const caps   = readContractCapCount(infernoDir);
+      const health = readHealthScore(cwd);
+      res.writeHead(200, { "Content-Type": "application/json" });
+      res.end(JSON.stringify({ ok: true, capabilities: caps, health, ts: new Date().toISOString() }));
+      return;
+    }
+    res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+    res.end(`<!DOCTYPE html><html><head><meta charset="UTF-8">
+    <meta http-equiv="refresh" content="10">
+    <title>🔥 vibe</title>
+    <style>body{font-family:system-ui;background:#0f1117;color:#e2e8f0;display:flex;align-items:center;justify-content:center;height:100vh;margin:0;flex-direction:column;gap:16px}
+    h1{color:#f97316;margin:0}.sub{color:#64748b;font-size:14px}</style></head>
+    <body><h1>🔥 infernoflow vibe</h1><div class="sub">Auto-refreshes every 10s</div>
+    <script>
+    fetch('/status').then(r=>r.json()).then(d=>{
+      document.body.innerHTML='<h1>🔥 vibe</h1><p style="color:#22c55e">'+d.capabilities+' capabilities</p>'
+        +(d.health!==null?'<p>Health: '+d.health+'/100</p>':'')
+        +'<p style="color:#64748b;font-size:12px">'+new Date(d.ts).toLocaleTimeString()+'</p>';
+    });
+    </script></body></html>`);
+  });
+  server.listen(port, "127.0.0.1", () => {});
+  return server;
+}
+
+// ── Entry ─────────────────────────────────────────────────────────────────────
+
+export async function vibeCommand(rawArgs) {
+  const args      = rawArgs.slice(1);
+  const silent    = args.includes("--silent");
+  const noSuggest = args.includes("--no-suggest");
+  const noContext = args.includes("--no-context");
+  const cwd       = process.cwd();
+  const infernoDir = path.join(cwd, "inferno");
+
+  if (!fs.existsSync(infernoDir)) {
+    warn("inferno/ not found. Run: infernoflow init");
+    process.exit(1);
+  }
+
+  // Parse flags
+  const dirIdx     = args.indexOf("--dir");
+  const intervalIdx = args.indexOf("--interval");
+  const portIdx    = args.indexOf("--port");
+
+  const interval   = intervalIdx !== -1 ? parseInt(args[intervalIdx + 1], 10) : 4;
+  const port       = portIdx !== -1 ? parseInt(args[portIdx + 1], 10) : null;
+
+  const scanDirs   = dirIdx !== -1
+    ? args[dirIdx + 1].split(",").map(d => path.resolve(cwd, d.trim()))
+    : ["src", "lib", "app", "api", "pages", "routes", "controllers", "handlers", "services"]
+        .map(d => path.join(cwd, d))
+        .filter(d => fs.existsSync(d));
+
+  if (!scanDirs.length) {
+    // Watch the whole project root as fallback
+    scanDirs.push(cwd);
+  }
+
+  const opts = { silent, noSuggest, noContext, interval };
+  const session = new VibeSession();
+
+  // Snapshot initial state
+  session.capsAtStart = readContractCapCount(infernoDir);
+  session.capsNow     = session.capsAtStart;
+  session.scoreAtStart = readHealthScore(cwd);
+
+  if (!silent) {
+    console.log();
+    console.log(`  ${bold("🔥 infernoflow vibe")} ${gray("— vibe coding mode active")}`);
+    console.log();
+    console.log(`  ${bold("Watching:")} ${scanDirs.map(d => path.relative(cwd, d) || ".").join(", ")}`);
+    console.log(`  ${bold("Debounce:")} ${interval}s`);
+    if (noSuggest) console.log(`  ${gray("--no-suggest: contract sync disabled")}`);
+    if (noContext)  console.log(`  ${gray("--no-context: CONTEXT.md refresh disabled")}`);
+    console.log();
+    console.log(`  ${cyan(String(session.capsAtStart))} capabilities in contract`);
+    if (session.scoreAtStart !== null) console.log(`  Health score: ${cyan(String(session.scoreAtStart))}/100`);
+    console.log();
+    console.log(`  ${gray("Watching for file saves… Press Ctrl+C to stop and see session summary.")}`);
+    console.log();
+  }
+
+  // Optional mini dashboard
+  if (port) {
+    startMiniDashboard(port, cwd, infernoDir);
+    if (!silent) info(`Mini dashboard → http://localhost:${port}`);
+  }
+
+  // Start watching
+  const watchers = watchDirs(scanDirs, cwd, infernoDir, opts, session);
+
+  if (!watchers.length) {
+    warn("No directories to watch. Use --dir src,lib,api");
+    process.exit(1);
+  }
+
+  // Spinner to show we're alive
+  let spinTimer = null;
+  if (!silent) {
+    let idleMsg = "Watching…";
+    spinTimer = setInterval(() => {
+      tick(idleMsg, gray);
+    }, 150);
+  }
+
+  // Graceful shutdown
+  const shutdown = async () => {
+    if (spinTimer) clearInterval(spinTimer);
+    process.stdout.write("\r                                              \r");
+    watchers.forEach(w => { try { w.close(); } catch {} });
+    session.scoreNow = readHealthScore(cwd);
+    session.capsNow  = readContractCapCount(infernoDir);
+    if (!silent) session.printSummary();
+    process.exit(0);
+  };
+
+  process.on("SIGINT",  shutdown);
+  process.on("SIGTERM", shutdown);
+
+  // Keep alive
+  await new Promise(() => {});
+}

package/dist/lib/templates/index.mjs

@@ -0,0 +1,131 @@
+/**
+ * infernoflow project templates
+ *
+ * Named starters for `infernoflow init --template <name>`.
+ * Each template provides:
+ *   - capabilities  : pre-populated capability list
+ *   - scenarios     : one starter scenario per capability
+ *   - contextHint   : first-session CONTEXT.md guidance
+ *   - scripts       : suggested package.json scripts to add
+ */
+
+export const TEMPLATES = {
+
+  // ── REST API ────────────────────────────────────────────────────────────────
+  "rest-api": {
+    description: "Express / Fastify / Hono REST API",
+    capabilities: [
+      { id: "list-items",      description: "GET /items — paginated list with filtering and sorting" },
+      { id: "get-item",        description: "GET /items/:id — fetch a single resource by ID" },
+      { id: "create-item",     description: "POST /items — create a new resource, validate input" },
+      { id: "update-item",     description: "PUT /items/:id — full update of an existing resource" },
+      { id: "delete-item",     description: "DELETE /items/:id — soft or hard delete" },
+      { id: "authenticate",    description: "POST /auth/login — exchange credentials for a JWT token" },
+      { id: "refresh-token",   description: "POST /auth/refresh — extend session with a new token" },
+      { id: "health-check",    description: "GET /health — liveness probe for load balancers" },
+      { id: "paginate",        description: "Cursor or offset pagination applied across list endpoints" },
+      { id: "validate-input",  description: "Schema validation on all incoming request bodies" },
+    ],
+    contextHint: "Building a REST API. Focus on route handlers, middleware, and input validation.",
+    scripts: {
+      "dev":   "node src/index.js",
+      "start": "node dist/index.js",
+    },
+  },
+
+  // ── Next.js ─────────────────────────────────────────────────────────────────
+  "nextjs": {
+    description: "Next.js full-stack app (App Router or Pages Router)",
+    capabilities: [
+      { id: "render-home-page",    description: "/ — server-rendered landing page with SEO metadata" },
+      { id: "render-dashboard",    description: "/dashboard — authenticated user dashboard" },
+      { id: "api-authenticate",    description: "POST /api/auth/login — issue session cookie or JWT" },
+      { id: "api-list-resources",  description: "GET /api/resources — paginated list, auth-protected" },
+      { id: "api-create-resource", description: "POST /api/resources — create and persist a resource" },
+      { id: "server-side-props",   description: "Fetch user-specific data server-side before render" },
+      { id: "static-generation",   description: "Pre-render marketing pages at build time" },
+      { id: "image-optimization",  description: "next/image usage for responsive, lazy-loaded images" },
+      { id: "middleware-auth",     description: "Edge middleware to protect dashboard routes" },
+      { id: "error-boundary",      description: "Global error.tsx / _error.tsx user-facing error page" },
+    ],
+    contextHint: "Building a Next.js app. Use Server Components by default; Client Components only when needed.",
+    scripts: {
+      "dev":   "next dev",
+      "build": "next build",
+      "start": "next start",
+    },
+  },
+
+  // ── CLI tool ────────────────────────────────────────────────────────────────
+  "cli": {
+    description: "Node.js / Python CLI tool",
+    capabilities: [
+      { id: "parse-args",       description: "Parse CLI arguments and flags, show help on --help" },
+      { id: "validate-config",  description: "Load and validate config file or env vars on startup" },
+      { id: "main-command",     description: "Primary command — the core action the CLI performs" },
+      { id: "output-formatter", description: "Format output as text, JSON, or table based on --format flag" },
+      { id: "error-handler",    description: "Friendly error messages with exit codes, no raw stack traces" },
+      { id: "progress-display", description: "Spinner or progress bar for long-running operations" },
+      { id: "update-check",     description: "Check npm/PyPI for a newer version on startup" },
+      { id: "plugin-loader",    description: "Discover and load user-installed plugins at runtime" },
+    ],
+    contextHint: "Building a CLI tool. Prioritise UX: helpful errors, --json flag, zero-config defaults.",
+    scripts: {
+      "start": "node bin/cli.js",
+      "link":  "npm link",
+    },
+  },
+
+  // ── GraphQL ─────────────────────────────────────────────────────────────────
+  "graphql": {
+    description: "GraphQL API (Apollo, Pothos, or similar)",
+    capabilities: [
+      { id: "query-viewer",       description: "query { viewer } — return the authenticated user" },
+      { id: "query-list",         description: "query { items(first: N, after: cursor) } — paginated list" },
+      { id: "query-node",         description: "query { node(id) } — global object lookup by ID" },
+      { id: "mutation-create",    description: "mutation { createItem(input) } — create and return new object" },
+      { id: "mutation-update",    description: "mutation { updateItem(id, input) } — update fields" },
+      { id: "mutation-delete",    description: "mutation { deleteItem(id) } — remove and return deleted" },
+      { id: "subscription-event", description: "subscription { itemUpdated } — real-time push via WebSocket" },
+      { id: "data-loader",        description: "Batch and cache DB calls with DataLoader to avoid N+1" },
+      { id: "auth-directive",     description: "@auth directive — enforce authentication on resolvers" },
+      { id: "error-formatting",   description: "Consistent GraphQL error shape with extensions and codes" },
+    ],
+    contextHint: "Building a GraphQL API. Use DataLoader for all relations, @auth directive on protected resolvers.",
+    scripts: {
+      "dev":       "ts-node src/server.ts",
+      "codegen":   "graphql-codegen",
+    },
+  },
+
+  // ── Monorepo ────────────────────────────────────────────────────────────────
+  "monorepo": {
+    description: "Monorepo workspace (nx / turborepo / pnpm workspaces)",
+    capabilities: [
+      { id: "build-all",         description: "Build all packages in dependency order" },
+      { id: "test-all",          description: "Run tests across all packages in parallel" },
+      { id: "lint-all",          description: "Lint all packages with shared ESLint / Prettier config" },
+      { id: "publish-packages",  description: "Bump versions and publish changed packages to npm" },
+      { id: "shared-ui-library", description: "packages/ui — shared React component library" },
+      { id: "shared-utils",      description: "packages/utils — shared utility functions and types" },
+      { id: "web-app",           description: "apps/web — primary Next.js or React web application" },
+      { id: "api-service",       description: "apps/api — backend service consumed by apps" },
+      { id: "cache-builds",      description: "Remote build cache via Turborepo or Nx Cloud" },
+      { id: "affected-only",     description: "Run tasks only for packages affected by a git change" },
+    ],
+    contextHint: "Working in a monorepo. Changes in packages/* may affect apps/*. Check affected packages before building.",
+    scripts: {
+      "build": "turbo build",
+      "dev":   "turbo dev",
+      "test":  "turbo test",
+    },
+  },
+};
+
+export function listTemplates() {
+  return Object.entries(TEMPLATES).map(([name, t]) => ({ name, description: t.description }));
+}
+
+export function getTemplate(name) {
+  return TEMPLATES[name] || null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "infernoflow",
-  "version": "0.19.0",
+  "version": "0.21.0",
   "description": "The forge for liquid code - keep capabilities, contracts, and docs in sync.",
   "type": "module",
   "bin": {
@@ -14,7 +14,8 @@
     "dist/lib",
     "dist/templates",
     "README.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "dist/lib/templates"
   ],
   "scripts": {
     "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",