infernoflow 0.10.11 → 0.10.13

package/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog — infernoflow
+
+## Unreleased
+
+## 0.10.12 — 2026-04-12
+
+### Added
+- `infernoflow install-cursor-hooks` — Cursor Agent hooks append assistant replies to `inferno/CONTEXT.draft.md`; `infernoflow init --cursor-hooks`.
+- `infernoflow install-vscode-copilot-hooks` — VS Code + GitHub Copilot agent hooks (Preview) via `.github/hooks/`; `infernoflow init --vscode-copilot-hooks`.
+- Shared draft tooling: `scripts/inferno-promote-draft.mjs`, `.gitignore` entry for `inferno/CONTEXT.draft.md`.
+- `lib/draftToolingInstall.mjs` — shared installer logic for promote script and gitignore.
+
+### Changed
+- CLI help widens command column for long names (e.g. `install-vscode-copilot-hooks`).
+
+## 0.1.0 — 2026-02-26
+
+### Added
+- `infernoflow init` — interactive scaffold with prompts
+- `infernoflow check` — full validation with clear error messages  
+- `infernoflow status` — at-a-glance dashboard
+- `infernoflow doc-gate` — CI hook for keeping docs in sync
+- Zero npm dependencies — works with Node.js 18+ out of the box
+- `--json` flag on check for CI pipelines
+- Auto-detect project name from package.json
+- Auto-add npm scripts to package.json on init

package/lib/ai/ideDetection.mjs

@@ -2,7 +2,7 @@ export function detectIdeContext(preferredIde = "auto") {
   const env = process.env;
   const lowerPreferred = String(preferredIde || "auto").toLowerCase();
 
-  const hasCursor = !!(env.CURSOR_TRACE_ID || env.CURSOR_AGENT || env.CURSOR_SESSION_ID);
+  const hasCursor = !!(env.CURSOR_TRACE_ID || env.CURSOR_AGENT || env.CURSOR_SESSION_ID || (env.VSCODE_GIT_ASKPASS_NODE || "").toLowerCase().includes("cursor") || (env.VSCODE_GIT_ASKPASS_MAIN || "").toLowerCase().includes("cursor"));
   const hasVscode = !!(env.VSCODE_PID || env.VSCODE_CWD || env.GITHUB_COPILOT_AGENT);
   const hasWindsurf = !!(env.WINDSURF || env.CODEIUM || env.WINDSURF_SESSION_ID);
 

package/lib/commands/run.mjs

@@ -126,10 +126,33 @@ function buildPromptFallbackSuggestion(task, contract) {
 
 async function generateWithIdeAgent(prompt) {
   if (process.env.INFERNO_AGENT_MOCK_RESPONSE) return process.env.INFERNO_AGENT_MOCK_RESPONSE;
-  if (process.env.INFERNO_AGENT_RESPONSE_FILE && fs.existsSync(process.env.INFERNO_AGENT_RESPONSE_FILE)) {
-    return fs.readFileSync(process.env.INFERNO_AGENT_RESPONSE_FILE, "utf8");
+  const responseFile = process.env.INFERNO_AGENT_RESPONSE_FILE
+    ? process.env.INFERNO_AGENT_RESPONSE_FILE
+    : path.join(process.cwd(), "inferno", "agent-response.json");
+  if (fs.existsSync(responseFile)) {
+    const data = fs.readFileSync(responseFile, "utf8");
+    fs.unlinkSync(responseFile);
+    return data;
   }
-  throw new Error("ide_agent_bridge_not_configured");
+  const infernoDir = path.join(process.cwd(), "inferno");
+  const promptFile = path.join(infernoDir, "agent-prompt.md");
+  if (fs.existsSync(promptFile)) fs.unlinkSync(promptFile);
+  fs.writeFileSync(promptFile, prompt, "utf8");
+  process.stderr.write("\n  \u2139 Prompt written to inferno/agent-prompt.md\n");
+  process.stderr.write("  \u2192 Open it, paste into Cursor or Claude\n");
+  process.stderr.write("  \u2192 Save the JSON reply to: inferno/agent-response.json\n");
+  process.stderr.write("  Waiting up to 5 minutes...\n\n");
+  const deadline = Date.now() + 300_000;
+  while (Date.now() < deadline) {
+    await new Promise(r => setTimeout(r, 1000));
+    if (fs.existsSync(responseFile)) {
+      const data = fs.readFileSync(responseFile, "utf8");
+      fs.unlinkSync(responseFile);
+      process.stderr.write("  \u2714 Response received\n\n");
+      return data;
+    }
+  }
+  throw new Error("ide_agent_bridge_timeout");
 }
 
 export async function runCommand(args = []) {

package/package.json

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

package/templates/cursor/hooks/inferno-session-draft.mjs

@@ -1,112 +1,197 @@
-#!/usr/bin/env node
-/**
- * Cursor hook: append agent output to inferno/CONTEXT.draft.md (gitignored).
- * - Default stdin: afterAgentResponse → { text }
- * - --agent-stop stdin: stop → { status, loop_count, ... }
- * Never fail closed: errors go to stderr; stdout is {} for Cursor.
- */
-import * as fs from "node:fs";
-import * as path from "node:path";
-
-/** Keep in sync with templates/scripts/inferno-promote-draft.mjs (split at first \\n---\\n). */
-const DRAFT_HEADER = `# CONTEXT draft (gitignored)
-
-Auto-captured by Cursor hooks (\`.cursor/hooks/inferno-session-draft.mjs\`). **Not product truth** — review, then run \`npm run inferno:promote-draft\` or \`infernoflow context\`.
-
----
-`;
-
-const MAX_MESSAGE_CHARS = 120_000;
-const MAX_FILE_BYTES = 280_000;
-
-function projectRoot() {
-  return process.cwd();
-}
-
-function draftPath() {
-  return path.join(projectRoot(), "inferno", "CONTEXT.draft.md");
-}
-
-function ensureDraftFile(file) {
-  if (!fs.existsSync(file)) {
-    fs.mkdirSync(path.dirname(file), { recursive: true });
-    fs.writeFileSync(file, DRAFT_HEADER, "utf8");
-  }
-}
-
-function trimFile(file) {
-  const raw = fs.readFileSync(file, "utf8");
-  if (Buffer.byteLength(raw, "utf8") <= MAX_FILE_BYTES) return;
-  const keep = raw.slice(-Math.floor(MAX_FILE_BYTES * 0.85));
-  const idx = keep.indexOf("\n### ");
-  const body = idx === -1 ? keep : keep.slice(idx);
-  fs.writeFileSync(file, `${DRAFT_HEADER}\n_(older capture trimmed for size)_\n\n${body}`, "utf8");
-}
-
-function appendBlock(file, block) {
-  ensureDraftFile(file);
-  fs.appendFileSync(file, block, "utf8");
-  trimFile(file);
-}
-
-async function readStdin() {
-  const chunks = [];
-  for await (const c of process.stdin) chunks.push(c);
-  return Buffer.concat(chunks).toString("utf8");
-}
-
-function main() {
-  const agentStop = process.argv.includes("--agent-stop");
-
-  readStdin()
-    .then((raw) => {
-      let data = {};
-      try {
-        data = raw.trim() ? JSON.parse(raw) : {};
-      } catch (e) {
-        console.error("[inferno-session-draft] stdin JSON parse:", e.message);
-        console.log("{}");
-        process.exit(0);
-        return;
-      }
-
-      const file = draftPath();
-      if (agentStop) {
-        const status = data.status ?? "unknown";
-        const loop = data.loop_count ?? 0;
-        appendBlock(
-          file,
-          `\n### _agent stop_ (${new Date().toISOString()})\n\nstatus: \`${status}\` · loop_count: ${loop}\n\n---\n`
-        );
-        console.log("{}");
-        process.exit(0);
-        return;
-      }
-
-      const text = typeof data.text === "string" ? data.text : "";
-      if (!text.trim()) {
-        console.log("{}");
-        process.exit(0);
-        return;
-      }
-
-      const clipped =
-        text.length > MAX_MESSAGE_CHARS
-          ? `${text.slice(0, MAX_MESSAGE_CHARS)}\n\n_…trimmed (${text.length - MAX_MESSAGE_CHARS} chars omitted)_\n`
-          : text;
-
-      appendBlock(
-        file,
-        `\n### Assistant message (${new Date().toISOString()})\n\n${clipped}\n\n---\n`
-      );
-      console.log("{}");
-      process.exit(0);
-    })
-    .catch((e) => {
-      console.error("[inferno-session-draft]", e);
-      console.log("{}");
-      process.exit(0);
-    });
-}
-
-main();
+#!/usr/bin/env node
+/**
+ * Cursor hook: capture agent output for infernoflow.
+ *
+ * Two jobs in one:
+ *   1. Always append agent text to inferno/CONTEXT.draft.md (existing behaviour)
+ *   2. When infernoflow is waiting (inferno/agent-prompt.md exists),
+ *      extract the JSON block from the agent reply and write it to
+ *      inferno/agent-response.json so infernoflow picks it up automatically.
+ *
+ * Trigger in .cursor/hooks.json:
+ *   afterAgentResponse → { text }
+ *   stop              → { status, loop_count, ... }  (--agent-stop flag)
+ *
+ * Never fail closed: errors go to stderr; stdout is {} for Cursor.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+/** Keep in sync with templates/scripts/inferno-promote-draft.mjs */
+const DRAFT_HEADER = `# CONTEXT draft (gitignored)
+Auto-captured by Cursor hooks (\`.cursor/hooks/inferno-session-draft.mjs\`). **Not product truth** — review, then run \`npm run inferno:promote-draft\` or \`infernoflow context\`.
+---
+`;
+
+const MAX_MESSAGE_CHARS = 120_000;
+const MAX_FILE_BYTES = 280_000;
+
+// ── paths ──────────────────────────────────────────────────────────────────
+
+function projectRoot() {
+  return process.cwd();
+}
+
+function draftPath() {
+  return path.join(projectRoot(), "inferno", "CONTEXT.draft.md");
+}
+
+function agentPromptPath() {
+  return path.join(projectRoot(), "inferno", "agent-prompt.md");
+}
+
+function agentResponsePath() {
+  return path.join(projectRoot(), "inferno", "agent-response.json");
+}
+
+// ── CONTEXT.draft.md helpers ───────────────────────────────────────────────
+
+function ensureDraftFile(file) {
+  if (!fs.existsSync(file)) {
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, DRAFT_HEADER, "utf8");
+  }
+}
+
+function trimFile(file) {
+  const raw = fs.readFileSync(file, "utf8");
+  if (Buffer.byteLength(raw, "utf8") <= MAX_FILE_BYTES) return;
+  const keep = raw.slice(-Math.floor(MAX_FILE_BYTES * 0.85));
+  const idx = keep.indexOf("\n### ");
+  const body = idx === -1 ? keep : keep.slice(idx);
+  fs.writeFileSync(
+    file,
+    `${DRAFT_HEADER}\n_(older capture trimmed for size)_\n\n${body}`,
+    "utf8",
+  );
+}
+
+function appendBlock(file, block) {
+  ensureDraftFile(file);
+  fs.appendFileSync(file, block, "utf8");
+  trimFile(file);
+}
+
+// ── JSON extraction ────────────────────────────────────────────────────────
+
+function extractJsonFromText(text) {
+  // 1. fenced code block
+  const fenceMatch = text.match(/```(?:json)?\s*([\s\S]*?)```/);
+  if (fenceMatch) {
+    const candidate = fenceMatch[1].trim();
+    try {
+      JSON.parse(candidate);
+      return candidate;
+    } catch {}
+  }
+
+  // 2. largest bare JSON object in the text
+  const jsonMatch = text.match(/\{[\s\S]*\}/);
+  if (jsonMatch) {
+    try {
+      JSON.parse(jsonMatch[0]);
+      return jsonMatch[0];
+    } catch {}
+  }
+
+  return null;
+}
+
+// ── bridge: write agent-response.json if infernoflow is waiting ────────────
+
+function maybeWriteAgentResponse(text) {
+  const promptFile = agentPromptPath();
+  const responseFile = agentResponsePath();
+
+  if (!fs.existsSync(promptFile)) return false;
+
+  const json = extractJsonFromText(text);
+  if (!json) {
+    process.stderr.write(
+      "[inferno-session-draft] infernoflow waiting but no JSON found in agent reply\n",
+    );
+    return false;
+  }
+
+  fs.writeFileSync(responseFile, json, "utf8");
+  try {
+    fs.unlinkSync(promptFile);
+  } catch {}
+
+  process.stderr.write(
+    "[inferno-session-draft] ✔ agent-response.json written — infernoflow will continue\n",
+  );
+  return true;
+}
+
+// ── stdin ──────────────────────────────────────────────────────────────────
+
+async function readStdin() {
+  const chunks = [];
+  for await (const c of process.stdin) chunks.push(c);
+  return Buffer.concat(chunks).toString("utf8");
+}
+
+// ── main ───────────────────────────────────────────────────────────────────
+
+function main() {
+  const agentStop = process.argv.includes("--agent-stop");
+
+  readStdin()
+    .then((raw) => {
+      let data = {};
+      try {
+        data = raw.trim() ? JSON.parse(raw) : {};
+      } catch (e) {
+        console.error("[inferno-session-draft] stdin JSON parse:", e.message);
+        console.log("{}");
+        process.exit(0);
+        return;
+      }
+
+      const file = draftPath();
+
+      if (agentStop) {
+        const status = data.status ?? "unknown";
+        const loop = data.loop_count ?? 0;
+        appendBlock(
+          file,
+          `\n### _agent stop_ (${new Date().toISOString()})\n\nstatus: \`${status}\` · loop_count: ${loop}\n\n---\n`,
+        );
+        console.log("{}");
+        process.exit(0);
+        return;
+      }
+
+      const text = typeof data.text === "string" ? data.text : "";
+      if (!text.trim()) {
+        console.log("{}");
+        process.exit(0);
+        return;
+      }
+
+      // Job 2: feed infernoflow's file-based bridge if it is waiting
+      maybeWriteAgentResponse(text);
+
+      // Job 1: always append to CONTEXT.draft.md
+      const clipped =
+        text.length > MAX_MESSAGE_CHARS
+          ? `${text.slice(0, MAX_MESSAGE_CHARS)}\n\n_…trimmed (${text.length - MAX_MESSAGE_CHARS} chars omitted)_\n`
+          : text;
+
+      appendBlock(
+        file,
+        `\n### Assistant message (${new Date().toISOString()})\n\n${clipped}\n\n---\n`,
+      );
+
+      console.log("{}");
+      process.exit(0);
+    })
+    .catch((e) => {
+      console.error("[inferno-session-draft]", e);
+      console.log("{}");
+      process.exit(0);
+    });
+}
+
+main();