infernoflow 0.10.13 → 0.10.14

package/lib/commands/check.mjs

@@ -1,179 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { header, ok, fail, warn, info, section, done, errorAndExit, cyan, bold, red, green, yellow, gray } from "../ui/output.mjs";
-import { docGateCommand } from "./docGate.mjs";
-
-function readJson(filePath, jsonOut = false) {
-  try { return JSON.parse(fs.readFileSync(filePath, "utf8")); }
-  catch (err) {
-    if (jsonOut) {
-      throw new Error(`Cannot parse ${path.basename(filePath)}`);
-    }
-    errorAndExit(
-      `Cannot parse ${path.basename(filePath)}`,
-      `Check JSON syntax in: ${filePath}`
-    );
-  }
-}
-
-function getScenarioFiles(scenariosDir) {
-  if (!fs.existsSync(scenariosDir)) return [];
-  return fs.readdirSync(scenariosDir)
-    .filter(f => f.endsWith(".json"))
-    .map(f => path.join(scenariosDir, f));
-}
-
-function getCovered(scenarioFiles) {
-  const covered = new Set();
-  for (const f of scenarioFiles) {
-    try {
-      const s = JSON.parse(fs.readFileSync(f, "utf8"));
-      (s.capabilitiesCovered || []).forEach(c => covered.add(c));
-    } catch {}
-  }
-  return covered;
-}
-
-export async function checkCommand(args) {
-  const cwd = process.cwd();
-  const infernoDir = path.join(cwd, "inferno");
-  const skipDocGate = args.includes("--skip-doc-gate");
-  const jsonOut = args.includes("--json");
-
-  if (!jsonOut) header("check");
-
-  const errors = [];
-  const warnings = [];
-
-  // ── inferno/ exists ─────────────────────────────────────────────
-  if (!fs.existsSync(infernoDir)) {
-    if (jsonOut) { console.log(JSON.stringify({ ok: false, errors: ["inferno/ not found"] })); process.exit(1); }
-    errorAndExit("inferno/ not found", `Run: infernoflow init`);
-  }
-
-  // ── contract.json ───────────────────────────────────────────────
-  const contractPath = path.join(infernoDir, "contract.json");
-  const capsPath = path.join(infernoDir, "capabilities.json");
-  const scenariosDir = path.join(infernoDir, "scenarios");
-  const changelogPath = path.join(infernoDir, "CHANGELOG.md");
-
-  if (!jsonOut) section("Contract");
-  if (!fs.existsSync(contractPath)) {
-    fail("contract.json not found", "Run: infernoflow init");
-    errors.push("contract.json missing");
-  } else {
-    let contract;
-    try {
-      contract = readJson(contractPath, jsonOut);
-    } catch (err) {
-      errors.push(err.message);
-      if (!jsonOut) {
-        fail(err.message);
-        process.exit(1);
-      }
-      console.log(JSON.stringify({ ok: false, errors, warnings }, null, 2));
-      process.exit(1);
-    }
-    const caps = contract.capabilities || [];
-
-    if (!contract.policyId) { fail("policyId missing"); errors.push("policyId missing"); }
-    else if (!jsonOut) ok(`policyId: ${bold(contract.policyId)}`);
-
-    if (!Number.isInteger(contract.policyVersion)) { fail("policyVersion must be an integer"); errors.push("policyVersion invalid"); }
-    else if (!jsonOut) ok(`policyVersion: ${bold("v" + contract.policyVersion)}`);
-
-    if (caps.length === 0) { fail("capabilities array is empty"); errors.push("no capabilities"); }
-    else if (!jsonOut) ok(`${caps.length} capabilities declared`);
-
-    // ── capabilities.json ────────────────────────────────────────
-    if (!jsonOut) section("Capabilities Registry");
-    if (!fs.existsSync(capsPath)) {
-      fail("capabilities.json not found"); errors.push("capabilities.json missing");
-    } else {
-      let registry;
-      try {
-        registry = readJson(capsPath, jsonOut);
-      } catch (err) {
-        errors.push(err.message);
-        if (!jsonOut) {
-          fail(err.message);
-          process.exit(1);
-        }
-        console.log(JSON.stringify({ ok: false, errors, warnings }, null, 2));
-        process.exit(1);
-      }
-      const registryIds = new Set((registry.capabilities || []).map(c => c?.id).filter(Boolean));
-
-      const missingInRegistry = caps.filter(c => !registryIds.has(c));
-      if (missingInRegistry.length > 0) {
-        missingInRegistry.forEach(c => {
-          if (!jsonOut) fail(`"${c}" in contract but missing from capabilities.json`, `Add it to inferno/capabilities.json`);
-          errors.push(`"${c}" not registered`);
-        });
-      } else if (!jsonOut) {
-        ok(`All ${registryIds.size} capabilities registered`);
-      }
-
-      // ── scenarios ───────────────────────────────────────────────
-      if (!jsonOut) section("Scenarios");
-      const scenarioFiles = getScenarioFiles(scenariosDir);
-      if (scenarioFiles.length === 0) {
-        warn("No scenarios found"); warnings.push("no scenarios");
-      } else {
-        const covered = getCovered(scenarioFiles);
-        const requireCoverage = contract?.rules?.requireScenarioForEachCapability !== false;
-        const uncovered = caps.filter(c => !covered.has(c));
-
-        if (!jsonOut) ok(`${scenarioFiles.length} scenario file(s) found`);
-
-        if (uncovered.length > 0 && requireCoverage) {
-          uncovered.forEach(c => {
-            if (!jsonOut) fail(`"${c}" has no scenario coverage`, `Add to capabilitiesCovered in a scenario file`);
-            errors.push(`"${c}" uncovered`);
-          });
-        } else if (!jsonOut) {
-          ok(`All capabilities covered by scenarios`);
-        }
-      }
-    }
-  }
-
-  // ── CHANGELOG ────────────────────────────────────────────────────
-  if (!jsonOut) section("Changelog");
-  if (!fs.existsSync(changelogPath)) {
-    fail("inferno/CHANGELOG.md not found"); errors.push("CHANGELOG missing");
-  } else {
-    const txt = fs.readFileSync(changelogPath, "utf8");
-    if (!/##\s+Unreleased/i.test(txt)) {
-      fail("Missing '## Unreleased' section", "Add it to inferno/CHANGELOG.md");
-      errors.push("CHANGELOG missing Unreleased");
-    } else if (!jsonOut) {
-      ok("CHANGELOG.md has ## Unreleased section");
-    }
-  }
-
-  // ── doc-gate ─────────────────────────────────────────────────────
-  if (!skipDocGate) {
-    if (!jsonOut) section("Doc Gate");
-    await docGateCommand({ silent: jsonOut, captureExit: true }).catch(() => {
-      errors.push("doc-gate failed");
-    });
-  }
-
-  // ── Summary ──────────────────────────────────────────────────────
-  if (jsonOut) {
-    console.log(JSON.stringify({ ok: errors.length === 0, errors, warnings }, null, 2));
-    if (errors.length > 0) process.exit(1);
-    return;
-  }
-
-  console.log();
-  if (errors.length > 0) {
-    console.log("  " + red(`✘ check failed — ${errors.length} error(s)\n`));
-    process.exit(1);
-  } else if (warnings.length > 0) {
-    console.log("  " + yellow(`⚠  check passed with ${warnings.length} warning(s)\n`));
-  } else {
-    done("check passed — everything is in sync");
-  }
-}

package/lib/commands/context.mjs

@@ -1,164 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { execSync } from "node:child_process";
-import { bold, gray, cyan, red, green, yellow } from "../ui/output.mjs";
-import { buildCursorImplementPrompt, buildGenericImplementPrompt } from "../ui/prompts.mjs";
-
-function copyToClipboard(text) {
-  try {
-    const p = process.platform;
-    if (p === "win32") execSync("clip", { input: text });
-    else if (p === "darwin") execSync("pbcopy", { input: text });
-    else { try { execSync("xclip -selection clipboard", { input: text }); } catch { execSync("xsel --clipboard --input", { input: text }); } }
-    return true;
-  } catch { return false; }
-}
-
-const INFERNO_DIR = "inferno";
-const CONTEXT_FILE = path.join(INFERNO_DIR, "CONTEXT.md");
-const STATE_FILE  = path.join(INFERNO_DIR, "context-state.json");
-
-function readJSON(f) { try { return JSON.parse(fs.readFileSync(f,"utf8")); } catch { return null; } }
-function readFile(f) { try { return fs.readFileSync(f,"utf8"); } catch { return null; } }
-function loadState() { const r=readFile(STATE_FILE); if(!r) return {}; try { return JSON.parse(r); } catch { return {}; } }
-function saveState(s) { fs.writeFileSync(STATE_FILE,JSON.stringify(s,null,2),"utf8"); }
-function fmtDate(iso) { if(!iso) return "unknown"; return new Date(iso).toLocaleDateString("en-GB",{day:"2-digit",month:"short",year:"numeric"}); }
-function parseChangelog(txt,max) {
-  if(!txt) return [];
-  const entries=[]; let cur=null;
-  for(const line of txt.split("\n")) {
-    if(line.startsWith("## ")) { if(cur&&entries.length<max) entries.push(cur); if(entries.length>=max) break; cur={title:line.replace("## ","").trim(),items:[]}; }
-    else if(cur&&line.startsWith("- ")) cur.items.push(line.replace("- ","").trim());
-  }
-  if(cur&&entries.length<max) entries.push(cur);
-  return entries.filter(e=>e.items.length>0);
-}
-
-export async function contextCommand(args) {
-  const has  = (f) => args.includes(f);
-  const flag = (f) => { const i=args.indexOf(f); return i!==-1&&args[i+1]?args[i+1]:null; };
-
-  const intent   = flag("--intent")   || flag("-i");
-  const working  = flag("--working")  || flag("-w");
-  const decision = flag("--decision") || flag("-d");
-  const showOnly = has("--show")  || has("-s");
-  const copyFlag = has("--copy")  || has("-c");
-  const cursorFlag  = has("--cursor");
-  const copilotFlag = has("--copilot");
-  const resetFlag= has("--reset");
-
-  console.log("\n  "+bold("��� infernoflow — context"));
-  console.log("  "+"─".repeat(50)+"\n");
-
-  if(!fs.existsSync(INFERNO_DIR)){
-    console.error(red("  ✘ inferno/ not found"));
-    console.error(gray("  → Run: infernoflow init\n"));
-    process.exit(1);
-  }
-
-  const contract     = readJSON(path.join(INFERNO_DIR,"contract.json"));
-  const capabilities = readJSON(path.join(INFERNO_DIR,"capabilities.json"));
-  const changelog    = readFile(path.join(INFERNO_DIR,"CHANGELOG.md"));
-
-  if(!contract||!capabilities){
-    console.error(red("  ✘ Missing contract.json or capabilities.json\n"));
-    process.exit(1);
-  }
-
-  let state = loadState();
-  if(resetFlag){ state={}; console.log(yellow("  ⚠ State reset\n")); }
-  if(intent)   { state.intent=intent; state.intentUpdated=new Date().toISOString(); console.log(green('  ✔ Intent saved: "'+intent+'"')); }
-  if(working)  { state.working=working; state.workingUpdated=new Date().toISOString(); console.log(green('  ✔ Working on: "'+working+'"')); }
-  if(decision) { if(!state.decisions) state.decisions=[]; state.decisions.push({text:decision,date:new Date().toISOString()}); console.log(green('  ✔ Decision recorded: "'+decision+'"')); }
-  if(intent||working||decision) saveState(state);
-
-  const capList   = capabilities.capabilities||[];
-  const allInSync = capList.length===(contract.capabilities||[]).length;
-  const recent    = parseChangelog(changelog,3);
-  const version   = String(contract.policyVersion).replace(/^v/i,"");
-  const now       = new Date().toLocaleDateString("en-GB",{day:"2-digit",month:"short",year:"numeric"});
-  const syncBadge = allInSync?"✓ validated":"⚠ out of sync";
-  const implementTask = state.intent || "describe the exact task to implement";
-  const implementInput = { task: implementTask, contract, caps: capabilities, scenarios: [], state };
-  const cursorPrompt = buildCursorImplementPrompt(implementInput);
-  const genericPrompt = buildGenericImplementPrompt(implementInput);
-
-  const capLines  = capList.map(c=>"- **"+c.id+"** — "+c.title).join("\n");
-  const chgLines  = recent.length>0 ? recent.map(e=>"### "+e.title+"\n"+e.items.map(i=>"  - "+i).join("\n")).join("\n\n") : "_No recent changes_";
-  const intentLine  = state.intent   ? state.intent+"  _("+fmtDate(state.intentUpdated)+")_"  : "_Not set — run: infernoflow context --intent \"...\"_";
-  const workingLine = state.working  ? state.working+"  _("+fmtDate(state.workingUpdated)+")_" : "_Not set — run: infernoflow context --working \"...\"_";
-  const decLines    = state.decisions&&state.decisions.length>0 ? state.decisions.slice(-5).map(d=>"- "+d.text+"  _("+fmtDate(d.date)+")_").join("\n") : "_No decisions recorded_";
-
-  const md = [
-    "# Project Context — "+contract.policyId+" v"+version,
-    "> Generated by infernoflow | "+now+" | "+syncBadge,
-    "","---","",
-    "## What this system does","",capLines,"","---","",
-    "## Recent changes","",chgLines,"","---","",
-    "## Current state","",
-    "- **Capabilities:** "+capList.length,
-    "- **Version:** v"+version,
-    "- **Sync:** "+syncBadge,
-    "","---","",
-    "## What I am working on right now","",workingLine,"","---","",
-    "## Intent — what I want to build next","",intentLine,"","---","",
-    "## Decisions & notes","",decLines,"","---",
-    "",
-    "## Implementation Prompt Seed","",
-    "Use this to start coding immediately with an agent:","",
-    "```bash",
-    `infernoflow implement "${implementTask}" --mode both`,
-    "```",
-    "",
-    "### Cursor Agent Prompt","",
-    "```text",
-    cursorPrompt,
-    "```",
-    "",
-    "### Generic Agent Prompt","",
-    "```text",
-    genericPrompt,
-    "```",
-    "",
-    "---",
-    "_Paste this block at the start of any new AI session._"
-  ].join("\n");
-
-  if(!showOnly){ fs.writeFileSync(CONTEXT_FILE,md,"utf8"); console.log(green("\n  ✔ Context written → "+CONTEXT_FILE)); }
-
-  if(copyFlag){
-    const ok=copyToClipboard(md);
-    console.log(ok ? green("  ✔ Copied to clipboard — paste with Ctrl+V") : yellow("  ⚠ Clipboard copy failed — open inferno/CONTEXT.md manually"));
-  }
-
-  if (cursorFlag) {
-    fs.writeFileSync(".cursorrules", md, "utf8");
-    console.log(green("  ✔ Written to .cursorrules — Cursor loads this automatically"));
-  }
-  if (copilotFlag) {
-    if (!fs.existsSync(".github")) fs.mkdirSync(".github");
-    fs.writeFileSync(".github/copilot-instructions.md", md, "utf8");
-    console.log(green("  ✔ Written to .github/copilot-instructions.md — Copilot loads this automatically"));
-  }
-  console.log("\n  "+bold("Context Summary"));
-  console.log("  "+"─".repeat(50));
-  console.log("  Project      "+contract.policyId+" — v"+version);
-  console.log("  Capabilities "+capList.length+" registered");
-  console.log("  Sync         "+(allInSync?green("✓ in sync"):yellow("⚠ check needed")));
-  console.log("  Working on   "+(state.working?cyan(state.working):gray("not set")));
-  console.log("  Intent       "+(state.intent ?cyan(state.intent) :gray("not set")));
-  console.log("  Decisions    "+(state.decisions?state.decisions.length:0)+" recorded\n");
-  console.log("  "+bold("Implementation Prompt"));
-  console.log("  "+cyan("→")+" Run "+cyan(`infernoflow implement "${implementTask}" --mode both`)+"\n");
-
-  if(copyFlag){
-    console.log("  "+bold("Ready to use:"));
-    console.log("  "+cyan("→")+" Paste into Claude / Cursor / Copilot with "+cyan("Ctrl+V")+"\n");
-  } else {
-    console.log("  "+bold("Ready to use:"));
-    console.log("  "+cyan("1.")+" Open "+cyan("inferno/CONTEXT.md"));
-    console.log("  "+cyan("2.")+" Copy everything");
-    console.log("  "+cyan("3.")+" Paste at the start of your next AI session");
-    console.log("  "+gray("  tip: use --copy to skip steps 1-2 automatically")+"\n");
-  }
-}

package/lib/commands/docGate.mjs

@@ -1,81 +0,0 @@
-import { execSync } from "node:child_process";
-import { ok, fail, warn, info, gray } from "../ui/output.mjs";
-
-function sh(cmd) {
-  return execSync(cmd, { stdio: ["ignore", "pipe", "pipe"] }).toString("utf8").trim();
-}
-
-const CODE_PREFIXES = [
-  "src/", "frontend/", "backend/",
-  "app/", "pages/", "components/",
-  "Controllers/", "Services/", "Endpoints/",
-  "lib/", "api/", "server/"
-];
-
-export async function docGateCommand(opts = {}) {
-  const fromArgs = Array.isArray(opts);
-  const silent = fromArgs ? false : (opts?.silent || false);
-  const captureExit = fromArgs ? false : (opts?.captureExit || false);
-  const jsonOut = fromArgs ? opts.includes("--json") : Boolean(opts?.json);
-  const base = process.env.BASE_SHA || "HEAD~1";
-  const head = process.env.HEAD_SHA || "HEAD";
-
-  let files = [];
-  try {
-    const out = sh(`git diff --name-only ${base}..${head}`);
-    files = out ? out.split("\n").filter(Boolean) : [];
-  } catch {
-    if (jsonOut) {
-      console.log(JSON.stringify({ ok: true, skipped: true, reason: "no_git_available" }, null, 2));
-      return;
-    }
-    if (!silent) info(gray("doc-gate skipped (no git available)"));
-    return;
-  }
-
-  if (files.length === 0) {
-    if (jsonOut) {
-      console.log(JSON.stringify({ ok: true, changedFiles: 0, changedCode: false, changedInferno: false }, null, 2));
-      return;
-    }
-    if (!silent) ok("doc-gate: no changed files");
-    return;
-  }
-
-  const changedCode = files.some(f =>
-    CODE_PREFIXES.some(p => f.startsWith(p) || f.includes("/" + p))
-  );
-  const changedInferno = files.some(f => f.startsWith("inferno/"));
-  const codeFiles = files.filter(f => CODE_PREFIXES.some(p => f.startsWith(p))).slice(0, 5);
-
-  if (jsonOut) {
-    const payload = {
-      ok: !(changedCode && !changedInferno),
-      changedFiles: files.length,
-      changedCode,
-      changedInferno,
-      sampleCodeFiles: codeFiles,
-      hint: changedCode && !changedInferno ? "Update at least one file in inferno/ before committing" : null,
-    };
-    console.log(JSON.stringify(payload, null, 2));
-    if (!payload.ok) process.exit(1);
-    return;
-  }
-
-  if (changedCode && !changedInferno) {
-    if (!silent) {
-      fail(
-        "Code changed but inferno/ was NOT updated",
-        "Update at least one file in inferno/ before committing"
-      );
-      if (codeFiles.length) {
-        console.log();
-        codeFiles.forEach(f => console.log("      " + gray("• " + f)));
-      }
-    }
-    if (captureExit) throw new Error("doc-gate failed");
-    process.exit(1);
-  }
-
-  if (!silent) ok("doc-gate: docs are up to date");
-}

package/lib/commands/implement.mjs

@@ -1,103 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { execSync } from "node:child_process";
-import { header, section, info, warn, cyan, gray, errorAndExit } from "../ui/output.mjs";
-import {
-  loadImplementContext,
-  buildCursorImplementPrompt,
-  buildGenericImplementPrompt,
-} from "../ui/prompts.mjs";
-
-function getFlagValue(args, flag) {
-  const idx = args.indexOf(flag);
-  return idx !== -1 && args[idx + 1] ? args[idx + 1] : null;
-}
-
-function extractTask(args) {
-  const skipNextFor = new Set(["--mode"]);
-  const parts = [];
-  for (let i = 0; i < args.length; i += 1) {
-    const token = args[i];
-    if (token.startsWith("-")) {
-      if (skipNextFor.has(token)) i += 1;
-      continue;
-    }
-    if (i === 0) continue; // command name
-    parts.push(token);
-  }
-  return parts.join(" ").trim();
-}
-
-function copyToClipboard(text) {
-  try {
-    const p = process.platform;
-    if (p === "win32") execSync("clip", { input: text });
-    else if (p === "darwin") execSync("pbcopy", { input: text });
-    else {
-      try { execSync("xclip -selection clipboard", { input: text }); }
-      catch { execSync("xsel --clipboard --input", { input: text }); }
-    }
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-export async function implementCommand(args = []) {
-  header("implement");
-
-  const cwd = process.cwd();
-  const infernoDir = path.join(cwd, "inferno");
-  if (!fs.existsSync(infernoDir)) {
-    errorAndExit("inferno/ not found", "Run: infernoflow init");
-  }
-
-  const mode = (getFlagValue(args, "--mode") || "both").toLowerCase();
-  const copyFlag = args.includes("--copy") || args.includes("-c");
-  if (!["cursor", "generic", "both"].includes(mode)) {
-    errorAndExit("Invalid --mode value", "Use: --mode cursor|generic|both");
-  }
-
-  const rawTask = extractTask(args);
-  if (!rawTask) {
-    errorAndExit("No task provided", 'Usage: infernoflow implement "your task description"');
-  }
-
-  const context = loadImplementContext(cwd);
-  const cursorPrompt = buildCursorImplementPrompt({ task: rawTask, ...context });
-  const genericPrompt = buildGenericImplementPrompt({ task: rawTask, ...context });
-
-  info(`Task: ${cyan(rawTask)}`);
-  info(`Mode: ${cyan(mode)}`);
-  warn("If you hit model high-load/resource-exhausted, retry with Auto/another model.");
-
-  if (mode === "cursor" || mode === "both") {
-    section("Cursor Agent Prompt");
-    console.log();
-    console.log(gray("─".repeat(50)));
-    console.log(cursorPrompt);
-    console.log(gray("─".repeat(50)));
-  }
-
-  if (mode === "generic" || mode === "both") {
-    section("Generic Agent Prompt");
-    console.log();
-    console.log(gray("─".repeat(50)));
-    console.log(genericPrompt);
-    console.log(gray("─".repeat(50)));
-  }
-
-  if (copyFlag) {
-    const textToCopy =
-      mode === "cursor"
-        ? cursorPrompt
-        : mode === "generic"
-          ? genericPrompt
-          : `## Cursor Agent Prompt\n\n${cursorPrompt}\n\n## Generic Agent Prompt\n\n${genericPrompt}`;
-    const ok = copyToClipboard(textToCopy);
-    if (ok) info(`Copied ${mode} prompt${mode === "both" ? "s" : ""} to clipboard.`);
-    else warn("Clipboard copy failed. Copy from terminal output.");
-  }
-
-  console.log();
-}