@fractary/faber 2.4.39 → 2.4.40

package/dist/executors/registry.js

@@ -0,0 +1,146 @@
+/**
+ * @fractary/faber - Executor Registry
+ *
+ * Maps provider names to executor implementations and resolves which executor
+ * to use for a given step based on the config cascade:
+ *   step.executor > phase_executors[phase] > workflow.executor > null (default)
+ *
+ * When resolution returns null, the caller should use the default behavior
+ * (Claude Code direct execution in skill mode, or Claude API in CLI mode).
+ */
+import { ClaudeExecutor } from './providers/claude.js';
+import { OpenAIExecutor } from './providers/openai.js';
+import { OpenAICompatibleExecutor } from './providers/openai-compatible.js';
+import { HttpExecutor } from './providers/http.js';
+// ============================================================================
+// Registry
+// ============================================================================
+export class ExecutorRegistry {
+    executors = new Map();
+    instances = new Map();
+    /**
+     * Register an executor factory for a provider.
+     * Factories are called lazily on first use.
+     */
+    register(provider, factory) {
+        this.executors.set(provider, factory);
+        // Clear cached instance if re-registering
+        this.instances.delete(provider);
+    }
+    /**
+     * Get an executor for a provider. Creates the instance lazily.
+     * @throws Error if provider is not registered
+     */
+    get(provider) {
+        let instance = this.instances.get(provider);
+        if (instance)
+            return instance;
+        const factory = this.executors.get(provider);
+        if (!factory) {
+            const available = Array.from(this.executors.keys()).join(', ');
+            throw new Error(`Executor provider '${provider}' not registered. Available: ${available || 'none'}`);
+        }
+        instance = factory();
+        this.instances.set(provider, instance);
+        return instance;
+    }
+    /**
+     * Check if a provider is registered.
+     */
+    has(provider) {
+        return this.executors.has(provider);
+    }
+    /**
+     * List all registered provider names.
+     */
+    listProviders() {
+        return Array.from(this.executors.keys());
+    }
+    /**
+     * Resolve the executor for a step, applying the config cascade.
+     *
+     * Returns the executor and merged config, or null if no executor is configured
+     * (meaning the step should use the default execution path).
+     *
+     * Cascade order (most specific wins):
+     * 1. step.executor — explicit on the step
+     * 2. phaseExecutors[phase] — workflow-level per-phase override
+     * 3. workflowExecutor — workflow-level default
+     *
+     * @param step - The workflow step to resolve
+     * @param phase - Current phase name
+     * @param workflowExecutor - Workflow-level default executor config
+     * @param phaseExecutors - Per-phase executor overrides
+     * @returns Resolved executor and config, or null if no executor applies
+     */
+    resolveForStep(step, phase, workflowExecutor, phaseExecutors) {
+        // Cascade: step > phase > workflow
+        const config = step.executor ??
+            phaseExecutors?.[phase] ??
+            workflowExecutor ??
+            null;
+        if (!config)
+            return null;
+        const executor = this.get(config.provider);
+        return { executor, config };
+    }
+    /**
+     * Validate all executor configs in a resolved workflow.
+     * Returns errors for any invalid configurations (missing API keys, etc.).
+     * Useful for fast-fail at plan time before execution starts.
+     */
+    async validateWorkflow(steps, workflowExecutor, phaseExecutors) {
+        const errors = [];
+        // Collect all unique configs to validate
+        const configsToValidate = new Map();
+        if (workflowExecutor) {
+            configsToValidate.set(`workflow:${workflowExecutor.provider}`, workflowExecutor);
+        }
+        if (phaseExecutors) {
+            for (const [phase, config] of Object.entries(phaseExecutors)) {
+                if (config) {
+                    configsToValidate.set(`phase:${phase}:${config.provider}`, config);
+                }
+            }
+        }
+        for (let i = 0; i < steps.length; i++) {
+            const step = steps[i];
+            if (step.executor) {
+                configsToValidate.set(`step:${i}:${step.executor.provider}`, step.executor);
+            }
+        }
+        // Validate each unique config
+        for (const [key, config] of configsToValidate) {
+            if (!this.has(config.provider)) {
+                const [scope, id] = key.split(':');
+                errors.push({
+                    stepIndex: scope === 'step' ? parseInt(id) : -1,
+                    error: `Provider '${config.provider}' is not registered`,
+                });
+                continue;
+            }
+            const executor = this.get(config.provider);
+            const result = await executor.validate(config);
+            if (!result.valid) {
+                const [scope, id] = key.split(':');
+                errors.push({
+                    stepIndex: scope === 'step' ? parseInt(id) : -1,
+                    error: result.error || `Validation failed for provider '${config.provider}'`,
+                });
+            }
+        }
+        return errors;
+    }
+    /**
+     * Create a registry with all built-in providers registered.
+     */
+    static createDefault() {
+        const registry = new ExecutorRegistry();
+        registry.register('claude', () => new ClaudeExecutor());
+        registry.register('openai', () => new OpenAIExecutor());
+        registry.register('openai-compatible', () => new OpenAICompatibleExecutor());
+        registry.register('http', () => new HttpExecutor());
+        return registry;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/executors/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/executors/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,MAAM,OAAO,gBAAgB;IACnB,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC/C,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEhD;;;OAGG;IACH,QAAQ,CAAC,QAAgB,EAAE,OAAwB;QACjD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACtC,0CAA0C;QAC1C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,QAAgB;QAClB,IAAI,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAE9B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/D,MAAM,IAAI,KAAK,CACb,sBAAsB,QAAQ,gCAAgC,SAAS,IAAI,MAAM,EAAE,CACpF,CAAC;QACJ,CAAC;QAED,QAAQ,GAAG,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACvC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,QAAgB;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CACZ,IAAuC,EACvC,KAAa,EACb,gBAAqC,EACrC,cAA4D;QAE5D,mCAAmC;QACnC,MAAM,MAAM,GACV,IAAI,CAAC,QAAQ;YACb,cAAc,EAAE,CAAC,KAAK,CAAC;YACvB,gBAAgB;YAChB,IAAI,CAAC;QAEP,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,gBAAgB,CACpB,KAA+C,EAC/C,gBAAqC,EACrC,cAA4D;QAE5D,MAAM,MAAM,GAAgD,EAAE,CAAC;QAE/D,yCAAyC;QACzC,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAA8B,CAAC;QAEhE,IAAI,gBAAgB,EAAE,CAAC;YACrB,iBAAiB,CAAC,GAAG,CAAC,YAAY,gBAAgB,CAAC,QAAQ,EAAE,EAAE,gBAAgB,CAAC,CAAC;QACnF,CAAC;QAED,IAAI,cAAc,EAAE,CAAC;YACnB,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC7D,IAAI,MAAM,EAAE,CAAC;oBACX,iBAAiB,CAAC,GAAG,CAAC,SAAS,KAAK,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC;gBACrE,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;QAED,8BAA8B;QAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,iBAAiB,EAAE,CAAC;YAC9C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACnC,MAAM,CAAC,IAAI,CAAC;oBACV,SAAS,EAAE,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC/C,KAAK,EAAE,aAAa,MAAM,CAAC,QAAQ,qBAAqB;iBACzD,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC/C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAClB,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACnC,MAAM,CAAC,IAAI,CAAC;oBACV,SAAS,EAAE,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC/C,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,mCAAmC,MAAM,CAAC,QAAQ,GAAG;iBAC7E,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa;QAClB,MAAM,QAAQ,GAAG,IAAI,gBAAgB,EAAE,CAAC;QAExC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC;QACxD,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC;QACxD,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC,IAAI,wBAAwB,EAAE,CAAC,CAAC;QAC7E,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,YAAY,EAAE,CAAC,CAAC;QAEpD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/executors/types.d.ts

@@ -0,0 +1,148 @@
+/**
+ * @fractary/faber - Step Executor Types
+ *
+ * Defines the abstraction layer between workflow steps and the models/services
+ * that execute them. Enables multi-model workflows where individual steps can
+ * be routed to different providers (Claude, OpenAI, self-hosted LLMs, HTTP APIs).
+ */
+/**
+ * Executor configuration for a workflow step.
+ *
+ * When specified on a step, overrides the default execution behavior
+ * (Claude Code direct execution) and routes to the specified provider.
+ *
+ * Config cascade: step.executor > phase_executors[phase] > workflow.executor > system default
+ *
+ * @example
+ * ```yaml
+ * steps:
+ *   - id: review-code
+ *     prompt: "Review this code for security issues..."
+ *     executor:
+ *       provider: openai
+ *       model: gpt-4o
+ * ```
+ */
+export interface StepExecutorConfig {
+    /**
+     * Provider identifier.
+     *
+     * Built-in providers:
+     * - 'claude': Anthropic Messages API (default env: ANTHROPIC_API_KEY)
+     * - 'openai': OpenAI Chat Completions API (default env: OPENAI_API_KEY)
+     * - 'openai-compatible': Any OpenAI-compatible endpoint (Ollama, vLLM, Together, Groq)
+     * - 'http': Generic HTTP POST (for non-LLM APIs like Banana, Replicate)
+     * - 'command': Shell command execution
+     */
+    provider: string;
+    /** Model identifier within the provider (e.g., 'gpt-4o', 'claude-haiku-4-5', 'llama3') */
+    model?: string;
+    /** Base URL for openai-compatible or http providers */
+    base_url?: string;
+    /**
+     * Environment variable name containing the API key.
+     * When omitted, uses provider default (e.g., OPENAI_API_KEY for 'openai').
+     */
+    api_key_env?: string;
+    /** Maximum tokens for the response */
+    max_tokens?: number;
+    /** Temperature (0-2) */
+    temperature?: number;
+    /**
+     * System prompt override.
+     * Replaces the default system prompt for this step's execution.
+     * Useful for specializing model behavior (e.g., "You are an image generation assistant").
+     */
+    system_prompt?: string;
+}
+/**
+ * Context passed to executors for each step invocation.
+ * Provides the executor with information about the workflow, current step,
+ * and outputs from previous steps.
+ */
+export interface ExecutionContext {
+    /** Work item identifier (e.g., GitHub issue number) */
+    workId: string;
+    /** Current phase name (frame, architect, build, evaluate, release) */
+    phase: string;
+    /** Current step ID */
+    stepId: string;
+    /** Current step display name */
+    stepName: string;
+    /** Outputs from previously completed steps, keyed by step ID */
+    previousOutputs: Record<string, Record<string, unknown>>;
+    /** Issue context if available */
+    issue?: {
+        number: number;
+        title: string;
+        body: string;
+    };
+    /** Working directory for file operations */
+    workingDirectory: string;
+    /** Run ID for state tracking */
+    runId?: string;
+}
+/**
+ * Result from an executor invocation.
+ * Maps to the existing result_handling system (success/warning/failure).
+ */
+export interface ExecutorResult {
+    /** The textual output from the executor */
+    output: string;
+    /** Execution status, aligns with step result_handling */
+    status: 'success' | 'warning' | 'failure';
+    /** Metadata about the execution */
+    metadata: {
+        /** Provider that executed this step */
+        provider: string;
+        /** Model used (if applicable) */
+        model?: string;
+        /** Execution duration in milliseconds */
+        duration_ms: number;
+        /** Token usage (if the provider reports it) */
+        tokens_used?: {
+            input: number;
+            output: number;
+        };
+    };
+    /** Error message if status is 'failure' */
+    error?: string;
+}
+/**
+ * The Executor interface that all providers implement.
+ *
+ * Executors are stateless — each `execute()` call is independent.
+ * Configuration (API keys, endpoints) comes from the StepExecutorConfig
+ * and environment variables.
+ */
+export interface Executor {
+    /** Provider name (e.g., 'claude', 'openai', 'http') */
+    readonly provider: string;
+    /**
+     * Execute a step prompt and return the result.
+     *
+     * @param prompt - The step prompt text (may include context overlays)
+     * @param context - Workflow execution context
+     * @param config - Executor-specific configuration from the step/workflow
+     * @returns Structured result with output, status, and metadata
+     */
+    execute(prompt: string, context: ExecutionContext, config: StepExecutorConfig): Promise<ExecutorResult>;
+    /**
+     * Validate that the executor can run with the given config.
+     * Checks for required environment variables, endpoint reachability, etc.
+     * Called during plan validation for fast-fail before execution starts.
+     *
+     * @param config - Executor configuration to validate
+     * @returns Validation result with error message if invalid
+     */
+    validate(config: StepExecutorConfig): Promise<{
+        valid: boolean;
+        error?: string;
+    }>;
+}
+/**
+ * Factory function that creates an Executor instance.
+ * Used by the ExecutorRegistry for lazy instantiation.
+ */
+export type ExecutorFactory = () => Executor;
+//# sourceMappingURL=types.d.ts.map

package/dist/executors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/executors/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;OASG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB,0FAA0F;IAC1F,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IAEf,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IAEd,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IAEf,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IAEjB,gEAAgE;IAChE,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAEzD,iCAAiC;IACjC,KAAK,CAAC,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IAEF,4CAA4C;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IAEzB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IAEf,yDAAyD;IACzD,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAE1C,mCAAmC;IACnC,QAAQ,EAAE;QACR,uCAAuC;QACvC,QAAQ,EAAE,MAAM,CAAC;QACjB,iCAAiC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,yCAAyC;QACzC,WAAW,EAAE,MAAM,CAAC;QACpB,+CAA+C;QAC/C,WAAW,CAAC,EAAE;YACZ,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC;KACH,CAAC;IAEF,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;;;;;OAOG;IACH,OAAO,CACL,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,cAAc,CAAC,CAAC;IAE3B;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnF;AAMD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,QAAQ,CAAC"}

package/dist/executors/types.js

@@ -0,0 +1,9 @@
+/**
+ * @fractary/faber - Step Executor Types
+ *
+ * Defines the abstraction layer between workflow steps and the models/services
+ * that execute them. Enables multi-model workflows where individual steps can
+ * be routed to different providers (Claude, OpenAI, self-hosted LLMs, HTTP APIs).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/executors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/executors/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/executors/workflow-executor.d.ts

@@ -0,0 +1,92 @@
+/**
+ * @fractary/faber - Workflow Executor
+ *
+ * Deterministic workflow executor for CLI-native mode.
+ * Code controls the step iteration loop — no LLM needed for orchestration.
+ * Each step is dispatched to its configured executor (Claude API, OpenAI, HTTP, etc.).
+ *
+ * This is the multi-model successor to the legacy FaberWorkflow.run() and the
+ * deterministic executor bash prototype (execute-workflow.sh).
+ *
+ * @example
+ * ```typescript
+ * const registry = ExecutorRegistry.createDefault();
+ * const executor = new WorkflowExecutor(registry);
+ * const result = await executor.execute(plan, { workId: '123' });
+ * ```
+ */
+import type { ExecutorResult, StepExecutorConfig } from './types.js';
+import { ExecutorRegistry } from './registry.js';
+import type { ResolvedWorkflow, WorkflowStep, StepResultHandling } from '../workflow/resolver.js';
+/** Options for workflow execution */
+export interface WorkflowExecuteOptions {
+    /** Work item ID */
+    workId: string;
+    /** Issue context if available */
+    issue?: {
+        number: number;
+        title: string;
+        body: string;
+    };
+    /** Working directory */
+    workingDirectory?: string;
+    /** Only run these phases (others are skipped) */
+    phasesToRun?: string[];
+    /** Only run this specific step */
+    stepToRun?: string | null;
+    /** Callback for step progress */
+    onStepStart?: (phase: string, step: WorkflowStep, index: number, total: number) => void;
+    /** Callback for step completion */
+    onStepComplete?: (phase: string, step: WorkflowStep, result: ExecutorResult) => void;
+    /** Callback for phase start */
+    onPhaseStart?: (phase: string) => void;
+    /** Callback for phase complete */
+    onPhaseComplete?: (phase: string, status: 'completed' | 'failed' | 'skipped') => void;
+}
+/** Result from a complete workflow execution */
+export interface WorkflowExecuteResult {
+    status: 'completed' | 'failed' | 'paused';
+    phases: PhaseExecuteResult[];
+    duration_ms: number;
+    steps_completed: number;
+    steps_total: number;
+}
+/** Result from a single phase */
+export interface PhaseExecuteResult {
+    phase: string;
+    status: 'completed' | 'failed' | 'skipped';
+    steps: StepExecuteResult[];
+    duration_ms: number;
+}
+/** Result from a single step */
+export interface StepExecuteResult {
+    stepId: string;
+    stepName: string;
+    result: ExecutorResult;
+}
+export declare class WorkflowExecutor {
+    private registry;
+    constructor(registry: ExecutorRegistry);
+    /**
+     * Execute a resolved workflow.
+     *
+     * Iterates through phases and steps deterministically.
+     * For each step, resolves the executor from the config cascade
+     * and dispatches execution.
+     *
+     * Steps without an executor config use the Claude API executor
+     * as the default (since we're in CLI mode, not Claude Code).
+     */
+    execute(workflow: {
+        phases: ResolvedWorkflow['phases'];
+        executor?: StepExecutorConfig;
+        phase_executors?: Partial<Record<string, StepExecutorConfig>>;
+        result_handling?: StepResultHandling;
+    }, options: WorkflowExecuteOptions): Promise<WorkflowExecuteResult>;
+    /**
+     * Resolve result handling for a step using the cascade:
+     * step > phase > workflow > defaults
+     */
+    private resolveResultHandling;
+}
+//# sourceMappingURL=workflow-executor.d.ts.map

package/dist/executors/workflow-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-executor.d.ts","sourceRoot":"","sources":["../../src/executors/workflow-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAEV,cAAc,EACd,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAEV,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AAQjC,qCAAqC;AACrC,MAAM,WAAW,sBAAsB;IACrC,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,KAAK,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iCAAiC;IACjC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxF,mCAAmC;IACnC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IACrF,+BAA+B;IAC/B,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,kCAAkC;IAClC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,KAAK,IAAI,CAAC;CACvF;AAED,gDAAgD;AAChD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,iCAAiC;AACjC,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,gCAAgC;AAChC,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;CACxB;AAMD,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,gBAAgB;IAE9C;;;;;;;;;OASG;IACG,OAAO,CACX,QAAQ,EAAE;QACR,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACnC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;QAC9B,eAAe,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;QAC9D,eAAe,CAAC,EAAE,kBAAkB,CAAC;KACtC,EACD,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC;IAoJjC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;CAuB9B"}

package/dist/executors/workflow-executor.js

@@ -0,0 +1,176 @@
+/**
+ * @fractary/faber - Workflow Executor
+ *
+ * Deterministic workflow executor for CLI-native mode.
+ * Code controls the step iteration loop — no LLM needed for orchestration.
+ * Each step is dispatched to its configured executor (Claude API, OpenAI, HTTP, etc.).
+ *
+ * This is the multi-model successor to the legacy FaberWorkflow.run() and the
+ * deterministic executor bash prototype (execute-workflow.sh).
+ *
+ * @example
+ * ```typescript
+ * const registry = ExecutorRegistry.createDefault();
+ * const executor = new WorkflowExecutor(registry);
+ * const result = await executor.execute(plan, { workId: '123' });
+ * ```
+ */
+// ============================================================================
+// Types
+// ============================================================================
+/** Phase names in execution order */
+const PHASE_ORDER = ['frame', 'architect', 'build', 'evaluate', 'release'];
+// ============================================================================
+// Workflow Executor
+// ============================================================================
+export class WorkflowExecutor {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    /**
+     * Execute a resolved workflow.
+     *
+     * Iterates through phases and steps deterministically.
+     * For each step, resolves the executor from the config cascade
+     * and dispatches execution.
+     *
+     * Steps without an executor config use the Claude API executor
+     * as the default (since we're in CLI mode, not Claude Code).
+     */
+    async execute(workflow, options) {
+        const startTime = Date.now();
+        const phaseResults = [];
+        let totalStepsCompleted = 0;
+        let totalSteps = 0;
+        let workflowFailed = false;
+        // Count total steps
+        for (const phaseName of PHASE_ORDER) {
+            const phase = workflow.phases[phaseName];
+            if (phase.enabled) {
+                totalSteps += phase.steps.length;
+            }
+        }
+        // Track outputs from previous steps for context
+        const previousOutputs = {};
+        for (const phaseName of PHASE_ORDER) {
+            const phase = workflow.phases[phaseName];
+            // Skip disabled phases
+            if (!phase.enabled) {
+                phaseResults.push({
+                    phase: phaseName,
+                    status: 'skipped',
+                    steps: [],
+                    duration_ms: 0,
+                });
+                continue;
+            }
+            // Skip if not in phasesToRun filter
+            if (options.phasesToRun && !options.phasesToRun.includes(phaseName)) {
+                phaseResults.push({
+                    phase: phaseName,
+                    status: 'skipped',
+                    steps: [],
+                    duration_ms: 0,
+                });
+                continue;
+            }
+            // Execute phase
+            options.onPhaseStart?.(phaseName);
+            const phaseStartTime = Date.now();
+            const stepResults = [];
+            let phaseFailed = false;
+            for (let i = 0; i < phase.steps.length; i++) {
+                const step = phase.steps[i];
+                // If stepToRun is specified, skip all other steps
+                if (options.stepToRun && step.id !== options.stepToRun) {
+                    continue;
+                }
+                options.onStepStart?.(phaseName, step, i, phase.steps.length);
+                // Build execution context
+                const context = {
+                    workId: options.workId,
+                    phase: phaseName,
+                    stepId: step.id,
+                    stepName: step.name,
+                    previousOutputs,
+                    issue: options.issue,
+                    workingDirectory: options.workingDirectory || process.cwd(),
+                };
+                // Resolve executor (cascade: step > phase > workflow > default 'claude')
+                const resolved = this.registry.resolveForStep(step, phaseName, workflow.executor, workflow.phase_executors);
+                let result;
+                if (resolved) {
+                    // Execute with the resolved executor
+                    result = await resolved.executor.execute(step.prompt, context, resolved.config);
+                }
+                else {
+                    // No executor configured — use claude as default in CLI mode
+                    const claudeExecutor = this.registry.get('claude');
+                    result = await claudeExecutor.execute(step.prompt, context, { provider: 'claude' });
+                }
+                stepResults.push({
+                    stepId: step.id,
+                    stepName: step.name,
+                    result,
+                });
+                // Track outputs
+                previousOutputs[step.id] = {
+                    output: result.output,
+                    status: result.status,
+                };
+                totalStepsCompleted++;
+                options.onStepComplete?.(phaseName, step, result);
+                // Handle step result
+                if (result.status === 'failure') {
+                    const handling = this.resolveResultHandling(step, phase, workflow);
+                    if (handling.on_failure === 'stop') {
+                        phaseFailed = true;
+                        break;
+                    }
+                    // If on_failure is not 'stop', continue to next step
+                }
+            }
+            const phaseStatus = phaseFailed ? 'failed' : 'completed';
+            phaseResults.push({
+                phase: phaseName,
+                status: phaseStatus,
+                steps: stepResults,
+                duration_ms: Date.now() - phaseStartTime,
+            });
+            options.onPhaseComplete?.(phaseName, phaseStatus);
+            if (phaseFailed) {
+                workflowFailed = true;
+                break;
+            }
+        }
+        return {
+            status: workflowFailed ? 'failed' : 'completed',
+            phases: phaseResults,
+            duration_ms: Date.now() - startTime,
+            steps_completed: totalStepsCompleted,
+            steps_total: totalSteps,
+        };
+    }
+    /**
+     * Resolve result handling for a step using the cascade:
+     * step > phase > workflow > defaults
+     */
+    resolveResultHandling(step, phase, workflow) {
+        return {
+            on_success: step.result_handling?.on_success ??
+                phase.result_handling?.on_success ??
+                workflow.result_handling?.on_success ??
+                'continue',
+            on_warning: step.result_handling?.on_warning ??
+                phase.result_handling?.on_warning ??
+                workflow.result_handling?.on_warning ??
+                'continue',
+            on_failure: step.result_handling?.on_failure ??
+                phase.result_handling?.on_failure ??
+                workflow.result_handling?.on_failure ??
+                'stop',
+        };
+    }
+}
+//# sourceMappingURL=workflow-executor.js.map

package/dist/executors/workflow-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-executor.js","sourceRoot":"","sources":["../../src/executors/workflow-executor.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -11,6 +11,7 @@
  * - workflow: FABER workflow orchestration
  * - storage: Artifact storage (local and Codex integration)
  * - agents: Agent type templates and selection
+ * - executors: Multi-model step execution framework
  */
 export * from './types.js';
 export * from './errors.js';
@@ -26,5 +27,6 @@ export * from './workflow/index.js';
 export * from './storage/index.js';
 export * from './agents/index.js';
 export * from './changelog/index.js';
+export * from './executors/index.js';
 export * from './auth/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAG9B,cAAc,yBAAyB,CAAC;AAGxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAG9B,cAAc,yBAAyB,CAAC;AAGxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -11,6 +11,7 @@
  * - workflow: FABER workflow orchestration
  * - storage: Artifact storage (local and Codex integration)
  * - agents: Agent type templates and selection
+ * - executors: Multi-model step execution framework
  */
 // Core exports
 export * from './types.js';
@@ -29,6 +30,8 @@ export * from './workflow/index.js';
 export * from './storage/index.js';
 export * from './agents/index.js';
 export * from './changelog/index.js';
+// Executors module
+export * from './executors/index.js';
 // Auth module
 export * from './auth/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,eAAe;AACf,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAE9B,oBAAoB;AACpB,cAAc,yBAAyB,CAAC;AAExC,iBAAiB;AACjB,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AAErC,cAAc;AACd,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAe;AACf,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAE9B,oBAAoB;AACpB,cAAc,yBAAyB,CAAC;AAExC,iBAAiB;AACjB,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AAErC,mBAAmB;AACnB,cAAc,sBAAsB,CAAC;AAErC,cAAc;AACd,cAAc,iBAAiB,CAAC"}