infernoflow 0.32.8 → 0.32.9

package/dist/lib/ui/prompts.mjs

@@ -1,147 +1,6 @@
-// Zero-dependency interactive prompts using readline
-
-import * as readline from "node:readline";
-import * as fs from "node:fs";
-import * as path from "node:path";
-
-function ask(question, defaultVal = "") {
-  return new Promise(resolve => {
-    const hint = defaultVal ? ` (${defaultVal})` : "";
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    rl.question(`  ${question}${hint}: `, answer => {
-      rl.close();
-      resolve(answer.trim() || defaultVal);
-    });
-  });
-}
-
-export async function promptInit() {
-  const policyId = await ask("Project / policy name", process.env._INFERNO_DEFAULT_POLICY || "my-project");
-  const caps = await ask("Capabilities (comma-separated)", "CreateTask, ReadTasks, UpdateTask, DeleteTask");
-  return { policyId, capabilities: caps.split(",").map(c => c.trim()).filter(Boolean) };
-}
-
-function readJson(filePath) {
-  try {
-    return JSON.parse(fs.readFileSync(filePath, "utf8"));
-  } catch {
-    return null;
-  }
-}
-
-export function loadImplementContext(cwd) {
-  const infernoDir = path.join(cwd, "inferno");
-  const contract = readJson(path.join(infernoDir, "contract.json")) || {};
-  const caps = readJson(path.join(infernoDir, "capabilities.json")) || { capabilities: [] };
-  const state = readJson(path.join(infernoDir, "context-state.json")) || {};
-  const scenariosDir = path.join(infernoDir, "scenarios");
-
-  const scenarios = [];
-  if (fs.existsSync(scenariosDir)) {
-    for (const fileName of fs.readdirSync(scenariosDir).filter((f) => f.endsWith(".json"))) {
-      const scenario = readJson(path.join(scenariosDir, fileName));
-      if (scenario) scenarios.push({ file: fileName, scenario });
-    }
-  }
-
-  return { contract, caps, state, scenarios };
-}
-
-function renderCaps(capsRegistry) {
-  const list = capsRegistry?.capabilities || [];
-  if (list.length === 0) return "- none";
-  return list.map((c) => `- ${c.id}: ${c.title || c.id}`).join("\n");
-}
-
-function renderScenarios(scenarios) {
-  if (!scenarios || scenarios.length === 0) return "- none";
-  return scenarios
-    .map(({ file, scenario }) => {
-      const covered = (scenario.capabilitiesCovered || []).join(", ") || "none";
-      return `- ${file}: covers [${covered}]`;
-    })
-    .join("\n");
-}
-
-function baseContextBlock({ contract, caps, scenarios, state }) {
-  const policy = contract?.policyId || "unknown-policy";
-  const version = contract?.policyVersion ?? "unknown";
-  const declared = (contract?.capabilities || []).join(", ") || "none";
-  const working = state?.working || "not set";
-  const intent = state?.intent || "not set";
-
-  return [
-    `Project policyId: ${policy}`,
-    `Policy version: ${version}`,
-    `Declared capabilities: [${declared}]`,
-    `Working on: ${working}`,
-    `Intent: ${intent}`,
-    "",
-    "Capabilities registry:",
-    renderCaps(caps),
-    "",
-    "Scenarios:",
-    renderScenarios(scenarios),
-  ].join("\n");
-}
-
-export function buildCursorImplementPrompt({ task, contract, caps, scenarios, state }) {
-  return [
-    "You are a Cursor coding agent working inside my repository.",
-    "Implement the task end-to-end with minimal reliable changes.",
-    "",
-    baseContextBlock({ contract, caps, scenarios, state }),
-    "",
-    `Task: ${task}`,
-    "",
-    "Requirements:",
-    "1) Propose smallest safe implementation.",
-    "2) Explain which files you changed and why.",
-    "3) Implement production-ready code.",
-    "4) Preserve backward compatibility unless explicitly requested.",
-    "5) Update tests or add smoke checks.",
-    "6) Provide run/verify commands.",
-    "7) If assumptions are needed, state briefly and proceed with sensible defaults.",
-    "",
-    "Output format:",
-    "- Plan (short)",
-    "- Code changes (by file)",
-    "- Tests updated/added",
-    "- Commands to run",
-    "- Acceptance checklist",
-    "",
-    "Quality bar:",
-    "- No TODO placeholders in final code",
-    "- Handle edge cases and errors",
-    "- Keep naming/style consistent",
-    "- Prefer simple maintainable solutions",
-    "",
-    "If model is overloaded (resource exhausted), retry with Auto/another model and continue deterministically.",
-  ].join("\n");
-}
-
-export function buildGenericImplementPrompt({ task, contract, caps, scenarios, state }) {
-  return [
-    "You are my senior software engineer pair.",
-    "Implement this task end-to-end in my project.",
-    "",
-    baseContextBlock({ contract, caps, scenarios, state }),
-    "",
-    `Goal: ${task}`,
-    "",
-    "Deliverables:",
-    "- Short implementation plan",
-    "- Exact file-level changes",
-    "- Test updates",
-    "- Verification commands",
-    "- Final acceptance checklist",
-    "",
-    "Constraints:",
-    "- Keep backward compatibility by default",
-    "- Make minimal reliable changes",
-    "- Handle edge cases and error states",
-    "- Keep output concise and actionable",
-    "",
-    "If you encounter temporary model high-load errors, retry and preserve the same output structure.",
-  ].join("\n");
-}
+import*as f from"node:readline";import*as d from"node:fs";import*as a from"node:path";function m(e,n=""){return new Promise(t=>{const o=n?` (${n})`:"",i=f.createInterface({input:process.stdin,output:process.stdout});i.question(`  ${e}${o}: `,r=>{i.close(),t(r.trim()||n)})})}async function b(){const e=await m("Project / policy name",process.env._INFERNO_DEFAULT_POLICY||"my-project"),n=await m("Capabilities (comma-separated)","CreateTask, ReadTasks, UpdateTask, DeleteTask");return{policyId:e,capabilities:n.split(",").map(t=>t.trim()).filter(Boolean)}}function p(e){try{return JSON.parse(d.readFileSync(e,"utf8"))}catch{return null}}function k(e){const n=a.join(e,"inferno"),t=p(a.join(n,"contract.json"))||{},o=p(a.join(n,"capabilities.json"))||{capabilities:[]},i=p(a.join(n,"context-state.json"))||{},r=a.join(n,"scenarios"),c=[];if(d.existsSync(r))for(const l of d.readdirSync(r).filter(s=>s.endsWith(".json"))){const s=p(a.join(r,l));s&&c.push({file:l,scenario:s})}return{contract:t,caps:o,state:i,scenarios:c}}function y(e){const n=e?.capabilities||[];return n.length===0?"- none":n.map(t=>`- ${t.id}: ${t.title||t.id}`).join(`
+`)}function h(e){return!e||e.length===0?"- none":e.map(({file:n,scenario:t})=>{const o=(t.capabilitiesCovered||[]).join(", ")||"none";return`- ${n}: covers [${o}]`}).join(`
+`)}function u({contract:e,caps:n,scenarios:t,state:o}){const i=e?.policyId||"unknown-policy",r=e?.policyVersion??"unknown",c=(e?.capabilities||[]).join(", ")||"none",l=o?.working||"not set",s=o?.intent||"not set";return[`Project policyId: ${i}`,`Policy version: ${r}`,`Declared capabilities: [${c}]`,`Working on: ${l}`,`Intent: ${s}`,"","Capabilities registry:",y(n),"","Scenarios:",h(t)].join(`
+`)}function j({task:e,contract:n,caps:t,scenarios:o,state:i}){return["You are a Cursor coding agent working inside my repository.","Implement the task end-to-end with minimal reliable changes.","",u({contract:n,caps:t,scenarios:o,state:i}),"",`Task: ${e}`,"","Requirements:","1) Propose smallest safe implementation.","2) Explain which files you changed and why.","3) Implement production-ready code.","4) Preserve backward compatibility unless explicitly requested.","5) Update tests or add smoke checks.","6) Provide run/verify commands.","7) If assumptions are needed, state briefly and proceed with sensible defaults.","","Output format:","- Plan (short)","- Code changes (by file)","- Tests updated/added","- Commands to run","- Acceptance checklist","","Quality bar:","- No TODO placeholders in final code","- Handle edge cases and errors","- Keep naming/style consistent","- Prefer simple maintainable solutions","","If model is overloaded (resource exhausted), retry with Auto/another model and continue deterministically."].join(`
+`)}function g({task:e,contract:n,caps:t,scenarios:o,state:i}){return["You are my senior software engineer pair.","Implement this task end-to-end in my project.","",u({contract:n,caps:t,scenarios:o,state:i}),"",`Goal: ${e}`,"","Deliverables:","- Short implementation plan","- Exact file-level changes","- Test updates","- Verification commands","- Final acceptance checklist","","Constraints:","- Keep backward compatibility by default","- Make minimal reliable changes","- Handle edge cases and error states","- Keep output concise and actionable","","If you encounter temporary model high-load errors, retry and preserve the same output structure."].join(`
+`)}export{j as buildCursorImplementPrompt,g as buildGenericImplementPrompt,k as loadImplementContext,b as promptInit};

package/dist/lib/vsCodeCopilotHooksInstall.mjs

@@ -1,42 +1 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { installInfernoDraftTooling } from "./draftToolingInstall.mjs";
-
-/**
- * VS Code + GitHub Copilot agent hooks (Preview). See:
- * https://code.visualstudio.com/docs/copilot/customization/hooks
- *
- * @param {object} opts
- * @param {string} opts.cwd
- * @param {string} opts.templatesRoot
- * @param {boolean} opts.force
- * @param {boolean} opts.silent
- * @param {(msg: string) => void} [opts.logOk]
- * @param {(msg: string) => void} [opts.logWarn]
- */
-export function installVsCodeCopilotHooksArtifacts(opts) {
-  const { cwd, templatesRoot, force, silent } = opts;
-  const logOk = opts.logOk || (() => {});
-  const logWarn = opts.logWarn || (() => {});
-
-  function copyFile(src, dst) {
-    if (fs.existsSync(dst) && !force) {
-      if (!silent) logWarn("Skipped (exists): " + path.relative(cwd, dst));
-      return false;
-    }
-    fs.mkdirSync(path.dirname(dst), { recursive: true });
-    fs.copyFileSync(src, dst);
-    if (!silent) logOk("Created: " + path.relative(cwd, dst));
-    return true;
-  }
-
-  installInfernoDraftTooling({ cwd, templatesRoot, force, silent, logOk, logWarn });
-
-  const srcHooks = path.join(templatesRoot, "github-hooks", "infernoflow-drafts.json");
-  const dstHooks = path.join(cwd, ".github", "hooks", "infernoflow-drafts.json");
-  const srcHookScript = path.join(templatesRoot, "scripts", "inferno-vscode-copilot-hook.mjs");
-  const dstHookScript = path.join(cwd, "scripts", "inferno-vscode-copilot-hook.mjs");
-
-  copyFile(srcHooks, dstHooks);
-  copyFile(srcHookScript, dstHookScript);
-}
+import*as e from"node:fs";import*as o from"node:path";import{installInfernoDraftTooling as j}from"./draftToolingInstall.mjs";function h(t){const{cwd:i,templatesRoot:r,force:c,silent:s}=t,f=t.logOk||(()=>{}),l=t.logWarn||(()=>{});function a(d,n){return e.existsSync(n)&&!c?(s||l("Skipped (exists): "+o.relative(i,n)),!1):(e.mkdirSync(o.dirname(n),{recursive:!0}),e.copyFileSync(d,n),s||f("Created: "+o.relative(i,n)),!0)}j({cwd:i,templatesRoot:r,force:c,silent:s,logOk:f,logWarn:l});const p=o.join(r,"github-hooks","infernoflow-drafts.json"),k=o.join(i,".github","hooks","infernoflow-drafts.json"),m=o.join(r,"scripts","inferno-vscode-copilot-hook.mjs"),u=o.join(i,"scripts","inferno-vscode-copilot-hook.mjs");a(p,k),a(m,u)}export{h as installVsCodeCopilotHooksArtifacts};

package/dist/templates/cursor/inferno-mcp-server.mjs

@@ -86,6 +86,25 @@ const TOOLS = [
     description: "Apply an infernoflow suggestion JSON. Use after infernoflow_run when you have a JSON response ready to apply.",
     inputSchema: { type: "object", properties: { json: { type: "string", description: "The JSON suggestion to apply" } }, required: ["json"] }
   },
+  {
+    name: "infernoflow_cloud_push",
+    description: "CALL THIS AUTOMATICALLY when the developer says 'sync', 'push to cloud', or 'share with the team'. Uploads the local capability contract to infernoflow cloud so the whole team sees the latest state. Requires infernoflow cloud init to have been run first.",
+    inputSchema: { type: "object", properties: {
+      dryRun: { type: "boolean", description: "If true, show what would be pushed without sending" }
+    }}
+  },
+  {
+    name: "infernoflow_cloud_pull",
+    description: "CALL THIS AUTOMATICALLY when the developer says 'pull from cloud', 'sync from team', or 'get latest contract'. Downloads the latest capability contract from infernoflow cloud. Warns if there are conflicts between local and remote.",
+    inputSchema: { type: "object", properties: {
+      force: { type: "boolean", description: "Overwrite local contract even if there are conflicts" }
+    }}
+  },
+  {
+    name: "infernoflow_cloud_status",
+    description: "Check whether local capabilities are in sync with infernoflow cloud. Call when the developer asks 'are we in sync?' or 'what does the team see?'. Returns local vs remote capability counts and hash comparison.",
+    inputSchema: { type: "object", properties: {} }
+  },
 ];
 
 // ── git drift detection (inline — no external imports in this template file) ─
@@ -589,6 +608,16 @@ function handleTool(id, name, input) {
       if (input.ref)   parts.push(`--ref "${input.ref}"`);
       if (input.apply) parts.push("--apply");
       text = runCmd(parts.join(" "));
+    } else if (name === "infernoflow_cloud_push") {
+      const parts = ["cloud", "push", "--json"];
+      if (input.dryRun) parts.push("--dry-run");
+      text = runCmd(parts.join(" "));
+    } else if (name === "infernoflow_cloud_pull") {
+      const parts = ["cloud", "pull", "--json"];
+      if (input.force) parts.push("--force");
+      text = runCmd(parts.join(" "));
+    } else if (name === "infernoflow_cloud_status") {
+      text = runCmd("cloud status --json");
     } else { return sendError(id, -32601, `Unknown tool: ${name}`); }
     sendResult(id, { content: [{ type: "text", text: text || "(no output)" }] });
   } catch (err) { sendError(id, -32000, err.message); }

package/dist/templates/github-app/GITHUB_APP.md

@@ -0,0 +1,67 @@
+# infernoflow GitHub App
+
+A GitHub App that automatically posts capability drift analysis on every PR — without needing a GitHub Actions workflow in each repo.
+
+## How it differs from the Actions workflow
+
+| | GitHub Actions workflow | GitHub App |
+|---|---|---|
+| Setup per repo | Copy `.github/workflows/infernoflow.yml` | Install app once, covers all repos |
+| Token needed | Yes (needs `GITHUB_TOKEN`) | No (app has its own token) |
+| Works on forks | Limited | Yes |
+| Private repos | Needs repo write permission | Yes, with install approval |
+
+## Install
+
+### Option 1 — Install the hosted app (fastest)
+
+Visit: **https://github.com/apps/infernoflow**
+
+Click Install → select repos → done. No configuration needed.
+
+### Option 2 — Self-host your own app (full control)
+
+1. Go to: **https://github.com/settings/apps/new**
+
+2. Paste the contents of `app-manifest.json` (update `YOUR_DOMAIN` first):
+   ```
+   Name:        infernoflow
+   Homepage:    https://github.com/ronmiz/infernoflow
+   Webhook URL: https://your-worker.workers.dev/github/webhook
+   Permissions:
+     Pull requests: Read & Write
+     Contents:      Read
+     Checks:        Read & Write
+   Events:
+     Pull request, Push
+   ```
+
+3. After creating, note your App ID and generate a Private Key (download the `.pem` file).
+
+4. Deploy the GitHub App worker (see `cloud-backend/github-app-worker.mjs`):
+   ```bash
+   cd cloud-backend
+   GITHUB_APP_ID=12345 \
+   GITHUB_PRIVATE_KEY="$(cat your-app.pem)" \
+   npx wrangler deploy github-app-worker.mjs --name infernoflow-app
+   ```
+
+5. Install the app on your repos at:
+   `https://github.com/apps/YOUR_APP_NAME`
+
+## What happens on a PR
+
+When a PR is opened or updated, the app:
+
+1. Checks out the `inferno/contract.json` from both base and head branches
+2. Runs a capability diff
+3. Posts a comment with the drift analysis (same format as `infernoflow pr-comment`)
+4. Sets a GitHub Check (green ✔ / yellow ⚠ / red ✗)
+
+## Environment variables
+
+| Variable | Description |
+|---|---|
+| `GITHUB_APP_ID` | Your app's numeric ID |
+| `GITHUB_PRIVATE_KEY` | PEM-encoded private key |
+| `GITHUB_WEBHOOK_SECRET` | Optional — validates webhook payloads |

package/dist/templates/github-app/app-manifest.json

@@ -0,0 +1,20 @@
+{
+  "name": "infernoflow",
+  "description": "Automatic capability drift analysis on every PR — powered by infernoflow",
+  "url": "https://github.com/ronmiz/infernoflow",
+  "hook_attributes": {
+    "url": "https://infernoflow-app.YOUR_DOMAIN.workers.dev/github/webhook"
+  },
+  "redirect_url": "https://infernoflow-app.YOUR_DOMAIN.workers.dev/github/callback",
+  "public": true,
+  "default_permissions": {
+    "pull_requests": "write",
+    "contents":      "read",
+    "checks":        "write",
+    "metadata":      "read"
+  },
+  "default_events": [
+    "pull_request",
+    "push"
+  ]
+}

package/package.json

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