@workflow-manager/runner 0.4.0 → 0.4.1

package/dist/engine.js

@@ -6,7 +6,7 @@ import { executeClaudeCodeStep, shouldUseRealClaudeCode } from "./claudeCodeExec
 import { executeMockStep } from "./mockExecutor.js";
 import { executeOpencodeStep, shouldUseRealOpencode } from "./opencodeExecutor.js";
 import { executePiAgentStep } from "./piAgentExecutor.js";
-import { validateRuntimeRequirements } from "./runtimePreflight.js";
+import { adapterMockFallbackReason, validateRuntimeRequirements } from "./runtimePreflight.js";
 function nodeType(step) {
     if (step.kind === "approval")
         return "HUMAN";
@@ -302,6 +302,10 @@ async function executeStep(step, input, attempt, workflow, workflowFilePath, hoo
     if (adapterKey === "claude-code" && shouldUseRealClaudeCode(step)) {
         return executeClaudeCodeStep(step, input, attempt, workflow, workflowFilePath, hooks);
     }
+    const fallbackReason = adapterMockFallbackReason(step);
+    if (fallbackReason) {
+        hooks?.onStderr?.(`[wfm] ${step.key}: ${fallbackReason}\n`);
+    }
     return executeMockStep(step, input, attempt, hooks);
 }
 export async function runWorkflow(definition, options) {

package/dist/index.js

@@ -14,7 +14,7 @@ import { MAN_PAGE_SOURCE } from "./manPage.js";
 import { promptForApprovalDecision, runWorkflow } from "./engine.js";
 import { cmdAuth, cmdPublish, cmdPull, cmdRemoteInfo, cmdSearch } from "./remote/commands.js";
 import { emitRunTelemetryBestEffort } from "./remote/telemetry.js";
-import { adapterImplementationStatuses, runtimeDoctorChecks, validateRuntimeRequirements, } from "./runtimePreflight.js";
+import { adapterImplementationStatuses, adapterMockFallbackWarnings, runtimeDoctorChecks, validateRuntimeRequirements, } from "./runtimePreflight.js";
 function cliDisplayName() {
     const invokedAs = path.basename(process.argv[1] ?? "");
     if (invokedAs === "workflow-manager" || invokedAs === "wfm") {
@@ -486,12 +486,14 @@ function cmdDoctor(args) {
     let workflow = null;
     let workflowErrors = [];
     let runtimeErrors = [];
+    let adapterWarnings = [];
     if (workflowPath) {
         try {
             workflow = parseWorkflowFile(path.resolve(workflowPath));
             workflowErrors = validateWorkflow(workflow);
             if (workflowErrors.length === 0) {
                 runtimeErrors = validateRuntimeRequirements(workflow);
+                adapterWarnings = adapterMockFallbackWarnings(workflow);
             }
         }
         catch (err) {
@@ -515,6 +517,7 @@ function cmdDoctor(args) {
                     title: workflow.title,
                     errors: workflowErrors,
                     runtimeErrors,
+                    adapterWarnings,
                 }
                 : null,
             baselineErrors,
@@ -548,6 +551,12 @@ function cmdDoctor(args) {
         else {
             console.log("- OK workflow schema and runtime requirements");
         }
+        if (adapterWarnings.length > 0) {
+            console.log("\nAdapter warnings:");
+            for (const warning of adapterWarnings) {
+                console.log(`- ${warning.stepKey}: ${warning.message}`);
+            }
+        }
     }
     return exitCode;
 }
@@ -629,6 +638,9 @@ async function cmdRun(filePath) {
             });
             return 1;
         }
+        for (const warning of adapterMockFallbackWarnings(workflow)) {
+            process.stderr.write(`⚠ ${warning.stepKey}: ${warning.message}\n`);
+        }
         const objective = getFlag("--objective");
         const inputRaw = getFlag("--input");
         let input = {};

package/dist/runtimePreflight.d.ts

@@ -1,4 +1,4 @@
-import type { AdapterKey, WorkflowDefinition } from "./types.js";
+import type { AdapterKey, StepDefinition, WorkflowDefinition } from "./types.js";
 export interface RuntimeDoctorCheck {
     key: string;
     label: string;
@@ -13,4 +13,19 @@ export interface AdapterImplementationStatus {
 }
 export declare function validateRuntimeRequirements(definition: WorkflowDefinition, env?: NodeJS.ProcessEnv): string[];
 export declare function runtimeDoctorChecks(env?: NodeJS.ProcessEnv): RuntimeDoctorCheck[];
+export interface AdapterMockFallbackWarning {
+    stepKey: string;
+    adapter: AdapterKey;
+    message: string;
+}
+/**
+ * Detects a step that explicitly selects a host-backed adapter whose real
+ * execution path is gated behind opt-in payload flags that are not set. Without
+ * those flags the engine routes the step to the mock executor; returning a
+ * message here lets callers warn instead of silently mocking. Returns null when
+ * the step will run as the user expects (default pi-agent, an enabled real
+ * adapter, or an intentional mock/codex selection).
+ */
+export declare function adapterMockFallbackReason(step: StepDefinition): string | null;
+export declare function adapterMockFallbackWarnings(definition: WorkflowDefinition): AdapterMockFallbackWarning[];
 export declare function adapterImplementationStatuses(): AdapterImplementationStatus[];

package/dist/runtimePreflight.js

@@ -158,6 +158,37 @@ export function runtimeDoctorChecks(env = process.env) {
         envCheck("anthropic-key", "Anthropic API key", "ANTHROPIC_API_KEY", env),
     ];
 }
+/**
+ * Detects a step that explicitly selects a host-backed adapter whose real
+ * execution path is gated behind opt-in payload flags that are not set. Without
+ * those flags the engine routes the step to the mock executor; returning a
+ * message here lets callers warn instead of silently mocking. Returns null when
+ * the step will run as the user expects (default pi-agent, an enabled real
+ * adapter, or an intentional mock/codex selection).
+ */
+export function adapterMockFallbackReason(step) {
+    if (step.kind !== "task" || !step.taskSpec?.adapterKey) {
+        return null;
+    }
+    const adapter = resolveTaskAdapter(step.taskSpec.adapterKey);
+    if (adapter === "claude-code" && !shouldUseRealClaudeCode(step)) {
+        return "adapterKey 'claude-code' is set, but the real Claude Code CLI path is off, so the step runs as a mock. Set taskSpec.payload.useRealAdapter: true to drive the real `claude` CLI.";
+    }
+    if (adapter === "opencode" && !shouldUseRealOpencode(step)) {
+        return "adapterKey 'opencode' is set, but the real OpenCode CLI path is off, so the step runs as a mock. Set taskSpec.payload.useRealAdapter: true and taskSpec.payload.opencodeSmokeTest: true to drive the real `opencode` CLI.";
+    }
+    return null;
+}
+export function adapterMockFallbackWarnings(definition) {
+    const warnings = [];
+    for (const step of definition.steps) {
+        const message = adapterMockFallbackReason(step);
+        if (message) {
+            warnings.push({ stepKey: step.key, adapter: resolveTaskAdapter(step.taskSpec?.adapterKey), message });
+        }
+    }
+    return warnings;
+}
 export function adapterImplementationStatuses() {
     return [
         {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workflow-manager/runner",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "CLI runner for in-memory and markdown workflow orchestration using ATEP-like envelopes",
   "repository": {
     "type": "git",