infernoflow 0.10.8 → 0.10.9

package/README.md

@@ -240,10 +240,11 @@ Works with any AI — Claude, ChatGPT, GitHub Copilot, Cursor, or your own setup
 
 Run one command and infernoflow will:
 1. Detect drift (`pr-impact`)
-2. Generate suggestion via local model
-3. Apply inferno updates
-4. Validate with `check`
-5. Roll back automatically if validation fails
+2. Resolve provider (`auto` defaults to IDE agent)
+3. Generate suggestion
+4. Apply inferno updates
+5. Validate with `check`
+6. Roll back automatically if validation fails
 
 ```bash
 infernoflow run "add favorite badge to tasks and filter by favorite"
@@ -255,10 +256,24 @@ Machine mode:
 infernoflow run "sync check" --json
 ```
 
-Local model configuration (required):
+Provider options:
 
 ```bash
-# default provider: ollama
+infernoflow run "task" --provider auto                # default (IDE agent first)
+infernoflow run "task" --provider agent --ide cursor  # require IDE agent
+infernoflow run "task" --provider local               # explicit local model
+infernoflow run "task" --provider prompt              # deterministic prompt fallback
+```
+
+IDE routing behavior:
+- `auto` + agent available -> uses IDE agent
+- `auto` + no agent -> falls back to prompt mode (`FALLBACK_PROMPT_MODE`)
+- `agent` + no agent -> exits with `EXPLICIT_AGENT_REQUIRED`
+
+Local model configuration (optional):
+
+```bash
+# local provider example: ollama
 set INFERNO_LOCAL_PROVIDER=ollama
 set INFERNO_LOCAL_ENDPOINT=http://127.0.0.1:11434/api/generate
 set INFERNO_LOCAL_MODEL=llama3.1:8b
@@ -320,12 +335,9 @@ Recommended chain:
 
 ```yaml
 # .github/workflows/ci.yml
-- name: infernoflow run
-  run: npx infernoflow run "sync check" --json
+- name: infernoflow run (headless)
+  run: npx infernoflow run "sync check" --provider prompt --json
   env:
-    INFERNO_LOCAL_PROVIDER: ollama
-    INFERNO_LOCAL_ENDPOINT: http://127.0.0.1:11434/api/generate
-    INFERNO_LOCAL_MODEL: llama3.1:8b
     BASE_SHA: ${{ github.event.pull_request.base.sha }}
     HEAD_SHA: ${{ github.event.pull_request.head.sha }}
 ```

package/bin/infernoflow.mjs

@@ -76,6 +76,8 @@ ${formatCommandsHelp()}
     --dry-run           Execute full flow without writing files
     --json              Emit machine-readable events and result payload
     --no-rollback       Keep changes even if validation fails
+    --provider <type>   auto | agent | local | prompt (default: auto)
+    --ide <name>        auto | cursor | vscode | windsurf (default: auto)
 
   ${bold("Typical workflow:")}
     ${gray('1. infernoflow context --intent "what I want to build"')}

package/lib/ai/ideDetection.mjs

@@ -0,0 +1,31 @@
+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 hasVscode = !!(env.VSCODE_PID || env.VSCODE_CWD || env.GITHUB_COPILOT_AGENT);
+  const hasWindsurf = !!(env.WINDSURF || env.CODEIUM || env.WINDSURF_SESSION_ID);
+
+  let ideDetected = "unknown";
+  if (hasCursor) ideDetected = "cursor";
+  else if (hasVscode) ideDetected = "vscode";
+  else if (hasWindsurf) ideDetected = "windsurf";
+
+  if (lowerPreferred !== "auto" && ["cursor", "vscode", "windsurf"].includes(lowerPreferred)) {
+    ideDetected = lowerPreferred;
+  }
+
+  const explicitAgentAvailability = env.INFERNO_AGENT_AVAILABLE;
+  const agentAvailable = explicitAgentAvailability != null
+    ? explicitAgentAvailability === "1" || explicitAgentAvailability === "true"
+    : ideDetected !== "unknown";
+
+  const reasonCodes = [];
+  if (ideDetected !== "unknown") reasonCodes.push(`IDE_${ideDetected.toUpperCase()}_DETECTED`);
+  else reasonCodes.push("IDE_UNKNOWN");
+  if (agentAvailable) reasonCodes.push("IDE_AGENT_AVAILABLE");
+  else reasonCodes.push("IDE_AGENT_UNAVAILABLE");
+
+  return { ideDetected, agentAvailable, reasonCodes };
+}
+

package/lib/ai/providerRouter.mjs

@@ -0,0 +1,73 @@
+import { detectIdeContext } from "./ideDetection.mjs";
+
+export async function resolveProvider(requestedProvider = "auto", preferredIde = "auto") {
+  const providerRequested = String(requestedProvider || "auto").toLowerCase();
+  const ide = detectIdeContext(preferredIde);
+  const reasonCodes = [...ide.reasonCodes];
+
+  if (providerRequested === "local") {
+    reasonCodes.push("LOCAL_PROVIDER_SELECTED");
+    return {
+      providerRequested,
+      providerResolved: "local",
+      ideDetected: ide.ideDetected,
+      agentAvailable: ide.agentAvailable,
+      reasonCodes,
+    };
+  }
+
+  if (providerRequested === "prompt") {
+    reasonCodes.push("PROMPT_PROVIDER_SELECTED");
+    return {
+      providerRequested,
+      providerResolved: "prompt",
+      ideDetected: ide.ideDetected,
+      agentAvailable: ide.agentAvailable,
+      reasonCodes,
+    };
+  }
+
+  if (providerRequested === "agent") {
+    if (!ide.agentAvailable) {
+      reasonCodes.push("EXPLICIT_AGENT_REQUIRED");
+      return {
+        providerRequested,
+        providerResolved: "none",
+        ideDetected: ide.ideDetected,
+        agentAvailable: ide.agentAvailable,
+        reasonCodes,
+        error: "agent_unavailable",
+      };
+    }
+    reasonCodes.push("IDE_AGENT_SELECTED");
+    return {
+      providerRequested,
+      providerResolved: "agent",
+      ideDetected: ide.ideDetected,
+      agentAvailable: ide.agentAvailable,
+      reasonCodes,
+    };
+  }
+
+  // auto
+  if (ide.agentAvailable) {
+    reasonCodes.push("IDE_AGENT_SELECTED");
+    return {
+      providerRequested: "auto",
+      providerResolved: "agent",
+      ideDetected: ide.ideDetected,
+      agentAvailable: ide.agentAvailable,
+      reasonCodes,
+    };
+  }
+
+  reasonCodes.push("FALLBACK_PROMPT_MODE");
+  return {
+    providerRequested: "auto",
+    providerResolved: "prompt",
+    ideDetected: ide.ideDetected,
+    agentAvailable: ide.agentAvailable,
+    reasonCodes,
+  };
+}
+

package/lib/commands/init.mjs

@@ -68,7 +68,7 @@ function upsertScripts(cwd, silent = false) {
     "inferno:gate":   "infernoflow doc-gate",
     "inferno:impact": "infernoflow pr-impact --json",
     "inferno:sync":   "infernoflow sync --auto --json",
-    "inferno:run":    "infernoflow run \"sync check\" --json",
+    "inferno:run":    "infernoflow run \"sync check\" --provider auto --json",
     "inferno:hooks":  "node scripts/inferno-install-hooks.mjs"
   };
   for (const [k, v] of Object.entries(toAdd)) {

package/lib/commands/run.mjs

@@ -3,6 +3,7 @@ import * as path from "node:path";
 import { execFileSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { generateWithLocalModel } from "../ai/localProvider.mjs";
+import { resolveProvider } from "../ai/providerRouter.mjs";
 import {
   buildPrompt,
   loadSuggestContext,
@@ -88,13 +89,59 @@ function writeRunArtifact(cwd, artifact) {
   return path.relative(cwd, filePath);
 }
 
+function getOptionValue(args, flag, fallback = null) {
+  const idx = args.indexOf(flag);
+  if (idx !== -1 && args[idx + 1] && !args[idx + 1].startsWith("-")) return args[idx + 1];
+  return fallback;
+}
+
+function extractTask(args) {
+  const takesValue = new Set(["--provider", "--ide"]);
+  const out = [];
+  for (let i = 1; i < args.length; i++) {
+    const token = args[i];
+    if (token.startsWith("-")) {
+      if (takesValue.has(token)) i += 1;
+      continue;
+    }
+    out.push(token);
+  }
+  return out.join(" ").trim();
+}
+
+function buildPromptFallbackSuggestion(task, contract) {
+  return {
+    summary: `Prompt fallback only: ${task}`,
+    newCapabilities: [],
+    removedCapabilities: [],
+    updatedScenarios: [],
+    changelogEntry: `- Prompt fallback mode for task: ${task} (no automatic contract mutation).`,
+    _meta: {
+      actionRequired: true,
+      nextStep: "Run infernoflow suggest or provide an agent bridge for automatic apply.",
+      capabilitiesCount: (contract?.capabilities || []).length,
+    },
+  };
+}
+
+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");
+  }
+  throw new Error("ide_agent_bridge_not_configured");
+}
+
 export async function runCommand(args = []) {
   const asJson = args.includes("--json");
   const dryRun = args.includes("--dry-run");
   const noRollback = args.includes("--no-rollback");
-  const task = args.filter((a) => !a.startsWith("-")).slice(1).join(" ").trim() || "sync check";
+  const providerRequested = (getOptionValue(args, "--provider", "auto") || "auto").toLowerCase();
+  const ideRequested = (getOptionValue(args, "--ide", "auto") || "auto").toLowerCase();
+  const task = extractTask(args) || "sync check";
   const cwd = process.cwd();
   const events = [];
+  const reasonCodes = [];
 
   if (!asJson) header("run");
   stageEvent(asJson, events, "init", "info", { task, dryRun, noRollback });
@@ -103,6 +150,30 @@ export async function runCommand(args = []) {
   const impact = runCliJson(["pr-impact", "--json"]);
   stageEvent(asJson, events, "detect", impact.data?.ok ? "ok" : "warn", { confidence: impact.data?.confidence || "low" });
 
+  const routed = await resolveProvider(providerRequested, ideRequested);
+  reasonCodes.push(...(routed.reasonCodes || []));
+  if (routed.error === "agent_unavailable") {
+    const payload = {
+      ok: false,
+      error: "agent_unavailable",
+      providerRequested,
+      providerResolved: routed.providerResolved,
+      ideDetected: routed.ideDetected,
+      agentAvailable: routed.agentAvailable,
+      reasonCodes,
+      events,
+    };
+    if (asJson) console.log(JSON.stringify(payload, null, 2));
+    else fail("provider agent unavailable", "Use --provider auto|local|prompt");
+    process.exit(1);
+  }
+  stageEvent(asJson, events, "route", "ok", {
+    providerRequested,
+    providerResolved: routed.providerResolved,
+    ideDetected: routed.ideDetected,
+    agentAvailable: routed.agentAvailable,
+  });
+
   const ctx = loadSuggestContext(cwd);
   if (!ctx?.contract) {
     const payload = { ok: false, error: "inferno_missing", events };
@@ -120,12 +191,19 @@ export async function runCommand(args = []) {
   });
   let suggestion;
   try {
-    const raw = await generateWithLocalModel(prompt);
-    suggestion = parseSuggestionJson(raw);
+    if (routed.providerResolved === "local") {
+      const raw = await generateWithLocalModel(prompt);
+      suggestion = parseSuggestionJson(raw);
+    } else if (routed.providerResolved === "agent") {
+      const raw = await generateWithIdeAgent(prompt);
+      suggestion = parseSuggestionJson(raw);
+    } else {
+      suggestion = buildPromptFallbackSuggestion(task, ctx.contract);
+    }
   } catch (err) {
-    const payload = { ok: false, error: "local_model_failed", reason: String(err.message || err), events };
+    const payload = { ok: false, error: "proposal_failed", reason: String(err.message || err), reasonCodes, events };
     if (asJson) console.log(JSON.stringify(payload, null, 2));
-    else fail(`local model failed`, err.message);
+    else fail("proposal generation failed", err.message);
     process.exit(1);
   }
   stageEvent(asJson, events, "propose", "ok", {
@@ -133,8 +211,8 @@ export async function runCommand(args = []) {
     removedCapabilities: (suggestion.removedCapabilities || []).length,
   });
 
-  const schemaErrors = validateSuggestion(suggestion);
-  const conflictErrors = detectSuggestionConflicts(ctx.contract, suggestion);
+  const schemaErrors = routed.providerResolved === "prompt" ? [] : validateSuggestion(suggestion);
+  const conflictErrors = routed.providerResolved === "prompt" ? [] : detectSuggestionConflicts(ctx.contract, suggestion);
   if (schemaErrors.length || conflictErrors.length) {
     const payload = {
       ok: false,
@@ -155,6 +233,11 @@ export async function runCommand(args = []) {
   try {
     if (dryRun) {
       stageEvent(asJson, events, "apply", "info", { dryRun: true });
+    } else if (routed.providerResolved === "prompt") {
+      stageEvent(asJson, events, "apply", "warn", {
+        skipped: true,
+        reason: "prompt_fallback_requires_manual_step",
+      });
     } else {
       applyChanged = applyChanges({
         cwd,
@@ -205,6 +288,11 @@ export async function runCommand(args = []) {
     mode: "run",
     task,
     dryRun,
+    providerRequested,
+    providerResolved: routed.providerResolved,
+    ideDetected: routed.ideDetected,
+    agentAvailable: routed.agentAvailable,
+    reasonCodes: Array.from(new Set(reasonCodes)),
     rolledBack,
     applyChanged,
     artifactPath,

package/package.json

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

package/templates/ci/github-inferno-check.yml

@@ -22,12 +22,9 @@ jobs:
       - name: Install dependencies
         run: npm ci --ignore-scripts || npm install --ignore-scripts
 
-      - name: Inferno one-command run
-        run: npx infernoflow run "sync check" --json
+      - name: Inferno one-command run (headless prompt mode)
+        run: npx infernoflow run "sync check" --provider prompt --json
         env:
-          INFERNO_LOCAL_PROVIDER: ollama
-          INFERNO_LOCAL_ENDPOINT: http://127.0.0.1:11434/api/generate
-          INFERNO_LOCAL_MODEL: llama3.1:8b
           BASE_SHA: ${{ github.event.pull_request.base.sha || github.event.before }}
           HEAD_SHA: ${{ github.event.pull_request.head.sha || github.sha }}
 

package/templates/scripts/inferno-install-hooks.mjs

@@ -14,13 +14,13 @@ if (!fs.existsSync(gitDir)) {
 fs.mkdirSync(hooksDir, { recursive: true });
 
 const preCommit = `#!/bin/sh
-echo "[inferno hooks] pre-commit: infernoflow run --dry-run"
-npx infernoflow run "sync check" --dry-run
+echo "[inferno hooks] pre-commit: infernoflow run --provider auto --dry-run"
+npx infernoflow run "sync check" --provider auto --dry-run
 `;
 
 const prePush = `#!/bin/sh
-echo "[inferno hooks] pre-push: infernoflow run --json"
-npx infernoflow run "sync check" --json
+echo "[inferno hooks] pre-push: infernoflow run --provider auto --json"
+npx infernoflow run "sync check" --provider auto --json
 `;
 
 const writeHook = (name, content) => {