@windagency/valora 2.0.1

package/dist/executor/execution-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.d.ts","sourceRoot":"","sources":["../../src/executor/execution-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;IACpD,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,wBAAwB,CAAC;IACrC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,WAAW,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC3B,2DAA2D;IAC3D,SAAS,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAC5B,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7C,SAAgB,IAAI,EAAE,MAAM,EAAE,CAAC;IAC/B,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;IACpE,SAAgB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtC,SAAgB,SAAS,CAAC,EAAE,wBAAwB,CAAC;IACrD,SAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1C,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,KAAK,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAgB,QAAQ,EAAE,WAAW,CAAC;IACtC,SAAgB,WAAW,CAAC,EAAE,WAAW,CAAC;IAEnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAM;IAC5D,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,yBAAyB,CAA4B;gBAEjD,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,CAAC,EAAE,yBAAyB;IAkBnG;;;OAGG;IACH,mBAAmB,IAAI,yBAAyB;IAIhD;;;OAGG;IACH,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAcrD;;OAEG;IACH,eAAe,IAAI,WAAW,EAAE;IAIhC;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI5C;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAc9B;;;OAGG;IACH,yBAAyB,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE;IAc1E;;OAEG;IACH,OAAO,CAAC,+BAA+B;CA0CvC"}

package/dist/executor/execution-context.js

@@ -0,0 +1,158 @@
+/**
+ * Execution Context - Manages shared state between pipeline execution and variable resolution
+ *
+ * Separates concerns between:
+ * - PipelineExecutor: Orchestrates stage execution (Command)
+ * - VariableResolver: Resolves variables (Query)
+ * - ExecutionContext: Manages shared state and coordination
+ *
+ * This implements Command Query Separation by ensuring:
+ * - Commands (execution) don't perform queries (resolution)
+ * - Queries (resolution) don't modify state
+ * - State management is centralized in the context
+ */
+import { VariableResolutionService } from './variable-resolution.service.js';
+/**
+ * Execution Context - Coordinates between pipeline execution and variable resolution
+ *
+ * Responsible for:
+ * - Maintaining execution state (stages, context, resolver)
+ * - Coordinating between PipelineExecutor and VariableResolver
+ * - Providing clean interfaces for both query and command operations
+ */
+export class ExecutionContext {
+    agentRole;
+    allowedTools;
+    args;
+    commandName;
+    flags;
+    interactive;
+    isolation;
+    knowledgeFiles;
+    mode;
+    model;
+    provider;
+    sessionInfo;
+    stages = {};
+    completedStages = new Set();
+    stageOutputs = [];
+    variableResolutionService;
+    constructor(options, variableResolutionService) {
+        this.commandName = options.commandName;
+        this.args = options.args;
+        this.flags = options.flags;
+        this.provider = options.provider;
+        this.agentRole = options.agentRole;
+        this.model = options.model;
+        this.mode = options.mode;
+        this.isolation = options.isolation;
+        this.interactive = options.interactive;
+        this.allowedTools = options.allowedTools;
+        this.knowledgeFiles = options.knowledgeFiles;
+        this.sessionInfo = options.sessionInfo;
+        // Initialize variable resolution service with initial context or use provided one
+        this.variableResolutionService = variableResolutionService ?? this.createVariableResolutionService(options);
+    }
+    /**
+     * Get the variable resolution service for query operations
+     * This allows stages to resolve variables without modifying state
+     */
+    getVariableResolver() {
+        return this.variableResolutionService;
+    }
+    /**
+     * Record a completed stage and update variable resolution context
+     * This is the command operation that modifies state
+     */
+    recordStageCompletion(stageOutput) {
+        this.stageOutputs.push(stageOutput);
+        if (stageOutput.success) {
+            // Update variable resolution service with new stage outputs for future resolutions
+            this.variableResolutionService.addStageOutputs(stageOutput.stage, stageOutput.outputs);
+            this.completedStages.add(stageOutput.stage);
+        }
+        else {
+            // Track failed stages for potential retry logic or error reporting
+            // Could be extended to support stage retry mechanisms
+            this.completedStages.add(`${stageOutput.stage}:failed`);
+        }
+    }
+    /**
+     * Get all stage outputs
+     */
+    getStageOutputs() {
+        return [...this.stageOutputs];
+    }
+    /**
+     * Check if a stage has been completed successfully
+     */
+    isStageCompleted(stageName) {
+        return this.completedStages.has(stageName);
+    }
+    /**
+     * Get execution summary
+     */
+    getExecutionSummary() {
+        const totalStages = this.stageOutputs.length;
+        const successfulStages = this.stageOutputs.filter((s) => s.success).length;
+        const failedStages = totalStages - successfulStages;
+        return {
+            commandName: this.commandName,
+            completedStages: Array.from(this.completedStages),
+            failedStages,
+            successfulStages,
+            totalStages
+        };
+    }
+    /**
+     * Validate that all stage dependencies are satisfied
+     * This is a query operation that checks state without modifying it
+     */
+    validateStageDependencies(stageInputs) {
+        const errors = [];
+        if (!stageInputs) {
+            return errors;
+        }
+        // Check if any inputs reference stages that haven't completed yet
+        const validationErrors = this.variableResolutionService.validateVariables(stageInputs);
+        errors.push(...validationErrors);
+        return errors;
+    }
+    /**
+     * Create the initial variable resolution service with context
+     */
+    createVariableResolutionService(options) {
+        // Convert positional args to indexed object
+        const argsObj = {};
+        this.args.forEach((arg, idx) => {
+            argsObj[(idx + 1).toString()] = arg;
+        });
+        // Merge flags into args with normalized keys
+        // Store flags under multiple key formats for flexibility:
+        // - Original key (e.g., specsFile from Commander)
+        // - Kebab-case (e.g., specs-file from CLI)
+        // - Snake_case (e.g., specs_file for $ARG_ references)
+        Object.entries(this.flags).forEach(([key, value]) => {
+            // Store original key
+            argsObj[key] = value;
+            // Convert camelCase to kebab-case (specsFile -> specs-file)
+            // This is needed because Commander converts --specs-file to specsFile,
+            // but $ARG_specs-file references expect kebab-case
+            const kebabCase = key.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
+            if (kebabCase !== key) {
+                argsObj[kebabCase] = value;
+            }
+            // Also store snake_case version for $ARG_ variable resolution
+            // Convert kebab-case (specs-file) and camelCase (specsFile) to snake_case (specs_file)
+            const snakeCase = key
+                .replace(/-/g, '_') // kebab-case to snake_case
+                .replace(/([a-z])([A-Z])/g, '$1_$2') // camelCase to snake_case
+                .toLowerCase();
+            if (snakeCase !== key) {
+                argsObj[snakeCase] = value;
+            }
+        });
+        return VariableResolutionService.createWithContext(argsObj, options.initialStageOutputs ?? {}, options.sessionContext ?? {});
+    }
+}
+//# sourceMappingURL=execution-context.js.map

package/dist/executor/execution-context.js.map

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

package/dist/executor/execution-strategy.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Command Execution Strategy Pattern
+ *
+ * Implements different execution strategies for commands:
+ * - Dry-run execution (preview and cache)
+ * - Pipeline execution (default, with cache support)
+ * - Isolated stage execution
+ * - Interactive execution
+ */
+import type { CommandDefinition, CommandResult } from '../types/command.types.js';
+import type { ExecutionContext } from './execution-context.js';
+export interface CommandExecutionStrategy {
+    /**
+     * Check if this strategy can handle the given command and options
+     */
+    canExecute(command: CommandDefinition, context: ExecutionContext): boolean;
+    /**
+     * Execute the command using this strategy
+     */
+    execute(command: CommandDefinition, context: ExecutionContext): Promise<CommandResult>;
+}
+/**
+ * Pipeline Execution Strategy
+ *
+ * Executes commands through the full pipeline with all stages.
+ * Supports using cached dry-run results for faster execution.
+ */
+export declare class PipelineExecutionStrategy implements CommandExecutionStrategy {
+    constructor();
+    canExecute(command: CommandDefinition, context: ExecutionContext): boolean;
+    execute(command: CommandDefinition, context: ExecutionContext): Promise<CommandResult>;
+    /**
+     * Execute pipeline with cached dry-run analysis
+     */
+    private executeWithCachedAnalysis;
+    /**
+     * Inject cached analysis outputs into execution context
+     */
+    private injectCachedAnalysisOutputs;
+    /**
+     * Record precomputed outputs as completed stages
+     */
+    private recordPrecomputedStages;
+    /**
+     * Get stages that need execution (excluding cached ones)
+     */
+    private getStagesForExecution;
+    /**
+     * Log cached resource usage statistics
+     */
+    private logCachedResourceUsage;
+    /**
+     * Execute pipeline stages using cached precomputed data
+     */
+    private executePipelineStagesWithCache;
+    /**
+     * Execute standard pipeline
+     */
+    private executePipeline;
+    /**
+     * Execute pipeline stages
+     */
+    private executePipelineStages;
+}
+/**
+ * Isolated Stage Execution Strategy
+ *
+ * Executes only specific stages of a command in isolation
+ */
+export declare class IsolatedExecutionStrategy implements CommandExecutionStrategy {
+    canExecute(command: CommandDefinition, context: ExecutionContext): boolean;
+    execute(command: CommandDefinition, context: ExecutionContext): Promise<CommandResult>;
+}
+/**
+ * Interactive Execution Strategy
+ *
+ * Executes commands with interactive prompts and user input
+ */
+export declare class InteractiveExecutionStrategy implements CommandExecutionStrategy {
+    canExecute(_command: CommandDefinition, context: ExecutionContext): boolean;
+    execute(_command: CommandDefinition, context: ExecutionContext): Promise<CommandResult>;
+}
+/**
+ * Strategy Factory for Command Execution
+ *
+ * Determines the appropriate execution strategy based on command and context.
+ * Strategy order matters - first matching strategy is used:
+ * 1. DryRunExecutionStrategy - handles --dry-run mode
+ * 2. IsolatedExecutionStrategy - handles --isolated mode
+ * 3. InteractiveExecutionStrategy - handles --interactive mode
+ * 4. PipelineExecutionStrategy - default (also checks for cached dry-run results)
+ */
+export declare class CommandExecutionStrategyFactory {
+    private strategies;
+    /**
+     * Get the appropriate execution strategy for the given command and context
+     */
+    getStrategy(command: CommandDefinition, context: ExecutionContext): CommandExecutionStrategy;
+    /**
+     * Register a new execution strategy
+     */
+    registerStrategy(strategy: CommandExecutionStrategy): void;
+}
+//# sourceMappingURL=execution-strategy.d.ts.map

package/dist/executor/execution-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-strategy.d.ts","sourceRoot":"","sources":["../../src/executor/execution-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAiB,MAAM,qBAAqB,CAAC;AAK3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAK5D,MAAM,WAAW,wBAAwB;IACxC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC;IAE3E;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACvF;AAED;;;;;GAKG;AACH,qBAAa,yBAA0B,YAAW,wBAAwB;;IAKzE,UAAU,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAKpE,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAoC5F;;OAEG;YACW,yBAAyB;IAqBvC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAOnC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAO/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiB9B;;OAEG;YACW,8BAA8B;IAmD5C;;OAEG;YACW,eAAe;IAI7B;;OAEG;YACW,qBAAqB;CAWnC;AAED;;;;GAIG;AACH,qBAAa,yBAA0B,YAAW,wBAAwB;IACzE,UAAU,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAKpE,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;CAmB5F;AAED;;;;GAIG;AACH,qBAAa,4BAA6B,YAAW,wBAAwB;IAC5E,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAKrE,OAAO,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;CAW7F;AAED;;;;;;;;;GASG;AACH,qBAAa,+BAA+B;IAC3C,OAAO,CAAC,UAAU,CAKhB;IAEF;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,gBAAgB,GAAG,wBAAwB;IAU5F;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,IAAI;CAI1D"}

package/dist/executor/execution-strategy.js

@@ -0,0 +1,259 @@
+/**
+ * Command Execution Strategy Pattern
+ *
+ * Implements different execution strategies for commands:
+ * - Dry-run execution (preview and cache)
+ * - Pipeline execution (default, with cache support)
+ * - Isolated stage execution
+ * - Interactive execution
+ */
+import { getLogger } from '../output/logger.js';
+import { getDryRunCache } from './dry-run-cache.js';
+import { DryRunExecutionStrategy } from './dry-run-strategy.js';
+/**
+ * Pipeline Execution Strategy
+ *
+ * Executes commands through the full pipeline with all stages.
+ * Supports using cached dry-run results for faster execution.
+ */
+export class PipelineExecutionStrategy {
+    constructor() {
+        // No constructor initialization needed
+    }
+    canExecute(command, context) {
+        // Can execute any command that has pipeline prompts and no isolation specified
+        return !context.isolation && !!command.prompts?.pipeline;
+    }
+    async execute(command, context) {
+        const logger = getLogger();
+        // Check for cached dry-run results
+        const cache = getDryRunCache();
+        const lookupOptions = {
+            args: context.args,
+            command,
+            commandName: command.name,
+            flags: context.flags
+        };
+        const cacheResult = cache.get(lookupOptions);
+        if (cacheResult.hit && cacheResult.entry) {
+            logger.info('Using cached dry-run analysis for faster execution', {
+                cacheAge: Date.now() - cacheResult.entry.createdAt,
+                commandName: command.name
+            });
+            // Invalidate cache after use (one-time use)
+            cache.invalidate(lookupOptions);
+            // Use cached analysis to speed up execution
+            return this.executeWithCachedAnalysis(command, context, cacheResult.entry);
+        }
+        logger.debug('Executing command via pipeline strategy', {
+            cacheStatus: cacheResult.reason ?? 'no_cache',
+            commandName: command.name,
+            stages: command.prompts.pipeline.length
+        });
+        // Standard pipeline execution
+        return this.executePipeline(command, context);
+    }
+    /**
+     * Execute pipeline with cached dry-run analysis
+     */
+    async executeWithCachedAnalysis(command, context, cachedEntry) {
+        const logger = getLogger();
+        // Inject cached analysis and record precomputed stages
+        this.injectCachedAnalysisOutputs(context, cachedEntry);
+        this.recordPrecomputedStages(context, cachedEntry);
+        // Determine which stages to execute
+        const stagesToExecute = this.getStagesForExecution(command, cachedEntry);
+        // Log cached resources being used
+        this.logCachedResourceUsage(logger, command, stagesToExecute, cachedEntry);
+        // Execute remaining stages through the pipeline with cached data
+        return this.executePipelineStagesWithCache(stagesToExecute, context, cachedEntry);
+    }
+    /**
+     * Inject cached analysis outputs into execution context
+     */
+    injectCachedAnalysisOutputs(context, cachedEntry) {
+        if (cachedEntry.analysisOutputs) {
+            const variableResolver = context.getVariableResolver();
+            variableResolver.addStageOutputs('dry_run_cache', cachedEntry.analysisOutputs);
+        }
+    }
+    /**
+     * Record precomputed outputs as completed stages
+     */
+    recordPrecomputedStages(context, cachedEntry) {
+        if (!cachedEntry.precomputedOutputs)
+            return;
+        for (const output of cachedEntry.precomputedOutputs) {
+            context.recordStageCompletion(output);
+        }
+    }
+    /**
+     * Get stages that need execution (excluding cached ones)
+     */
+    getStagesForExecution(command, cachedEntry) {
+        const completedStageNames = new Set(cachedEntry.precomputedOutputs?.map((o) => `${o.stage}.${o.prompt}`) ?? []);
+        return command.prompts.pipeline.filter((stage) => !completedStageNames.has(`${stage.stage}.${stage.prompt}`));
+    }
+    /**
+     * Log cached resource usage statistics
+     */
+    logCachedResourceUsage(logger, command, stagesToExecute, cachedEntry) {
+        logger.info('Using cached dry-run resources for faster execution', {
+            originalStages: command.prompts.pipeline.length,
+            pipelineValidated: cachedEntry.pipelineValidated ?? false,
+            preloadedAgent: !!cachedEntry.preloadedAgent,
+            preloadedPrompts: cachedEntry.preloadedPrompts?.length ?? 0,
+            preresolvedInputs: cachedEntry.preresolvedInputs?.length ?? 0,
+            stagesSkipped: command.prompts.pipeline.length - stagesToExecute.length,
+            stagesToExecute: stagesToExecute.length
+        });
+    }
+    /**
+     * Execute pipeline stages using cached precomputed data
+     */
+    async executePipelineStagesWithCache(stages, context, cachedEntry) {
+        // Import here to avoid circular dependencies
+        const pipelineModule = await import('./pipeline.js');
+        const promptLoaderModule = await import('./prompt-loader.js');
+        const agentLoaderModule = await import('./agent-loader.js');
+        // Create loaders with pre-populated caches from dry-run
+        const promptLoader = new promptLoaderModule.PromptLoader();
+        const agentLoader = new agentLoaderModule.AgentLoader();
+        // Pre-populate prompt loader cache with cached prompts
+        if (cachedEntry.preloadedPrompts && cachedEntry.preloadedPrompts.length > 0) {
+            for (const preloadedPrompt of cachedEntry.preloadedPrompts) {
+                promptLoader.injectCachedPrompt(preloadedPrompt.id, {
+                    category: preloadedPrompt.metadata['category'],
+                    content: preloadedPrompt.content,
+                    description: preloadedPrompt.metadata['description'],
+                    id: preloadedPrompt.id,
+                    name: preloadedPrompt.metadata['name'],
+                    version: preloadedPrompt.metadata['version']
+                });
+            }
+        }
+        // Pre-populate agent loader cache with cached agent
+        if (cachedEntry.preloadedAgent) {
+            agentLoader.injectCachedAgent(cachedEntry.preloadedAgent.role, {
+                content: cachedEntry.preloadedAgent.content,
+                decision_making: cachedEntry.preloadedAgent.decisionMaking
+                    ? { escalation_criteria: cachedEntry.preloadedAgent.decisionMaking.escalationCriteria }
+                    : undefined
+            });
+        }
+        // Inject pre-resolved inputs into the variable resolver
+        if (cachedEntry.preresolvedInputs && cachedEntry.preresolvedInputs.length > 0) {
+            const variableResolver = context.getVariableResolver();
+            for (const preresolvedInput of cachedEntry.preresolvedInputs) {
+                // Add enriched inputs (includes file contents) as stage outputs
+                variableResolver.addStageOutputs(`preresolved_${preresolvedInput.stageName}`, preresolvedInput.enrichedInputs);
+            }
+        }
+        const pipelineExecutor = new pipelineModule.PipelineExecutor(promptLoader, agentLoader);
+        return pipelineExecutor.execute(stages, { executionContext: context });
+    }
+    /**
+     * Execute standard pipeline
+     */
+    async executePipeline(command, context) {
+        return this.executePipelineStages(command.prompts.pipeline, context);
+    }
+    /**
+     * Execute pipeline stages
+     */
+    async executePipelineStages(stages, context) {
+        // Import here to avoid circular dependencies
+        const pipelineModule = await import('./pipeline.js');
+        const promptLoaderModule = await import('./prompt-loader.js');
+        const agentLoaderModule = await import('./agent-loader.js');
+        const promptLoader = new promptLoaderModule.PromptLoader();
+        const agentLoader = new agentLoaderModule.AgentLoader();
+        const pipelineExecutor = new pipelineModule.PipelineExecutor(promptLoader, agentLoader);
+        return pipelineExecutor.execute(stages, { executionContext: context });
+    }
+}
+/**
+ * Isolated Stage Execution Strategy
+ *
+ * Executes only specific stages of a command in isolation
+ */
+export class IsolatedExecutionStrategy {
+    canExecute(command, context) {
+        // Can execute if isolation options are specified
+        return !!context.isolation && !!command.prompts?.pipeline;
+    }
+    async execute(command, context) {
+        const logger = getLogger();
+        logger.debug('Executing command via isolated strategy', {
+            commandName: command.name,
+            isolatedStages: context.isolation?.stages?.length ?? 'all'
+        });
+        // Import here to avoid circular dependencies
+        const isolationExecutorModule = await import('./command-isolation.executor.js');
+        const stageExecutorModule = await import('./stage-executor.js');
+        const promptLoaderModule = await import('./prompt-loader.js');
+        const agentLoaderModule = await import('./agent-loader.js');
+        const promptLoader = new promptLoaderModule.PromptLoader();
+        const agentLoader = new agentLoaderModule.AgentLoader();
+        const stageExecutor = new stageExecutorModule.StageExecutor(promptLoader, agentLoader);
+        const isolationExecutor = new isolationExecutorModule.CommandIsolationExecutor(stageExecutor);
+        return isolationExecutor.executeIsolated(command.name, command.prompts.pipeline, context.isolation ?? {}, context);
+    }
+}
+/**
+ * Interactive Execution Strategy
+ *
+ * Executes commands with interactive prompts and user input
+ */
+export class InteractiveExecutionStrategy {
+    canExecute(_command, context) {
+        // Can execute interactive commands when interactive mode is enabled
+        return context.interactive === true;
+    }
+    async execute(_command, context) {
+        const logger = getLogger();
+        logger.debug('Executing command via interactive strategy', {
+            commandName: _command.name
+        });
+        // For now, fall back to pipeline execution
+        // TODO: Implement full interactive execution
+        const pipelineStrategy = new PipelineExecutionStrategy();
+        return pipelineStrategy.execute(_command, context);
+    }
+}
+/**
+ * Strategy Factory for Command Execution
+ *
+ * Determines the appropriate execution strategy based on command and context.
+ * Strategy order matters - first matching strategy is used:
+ * 1. DryRunExecutionStrategy - handles --dry-run mode
+ * 2. IsolatedExecutionStrategy - handles --isolated mode
+ * 3. InteractiveExecutionStrategy - handles --interactive mode
+ * 4. PipelineExecutionStrategy - default (also checks for cached dry-run results)
+ */
+export class CommandExecutionStrategyFactory {
+    strategies = [
+        new DryRunExecutionStrategy(), // Handle dry-run mode first
+        new IsolatedExecutionStrategy(),
+        new InteractiveExecutionStrategy(),
+        new PipelineExecutionStrategy() // Default strategy - checked last (also uses cache)
+    ];
+    /**
+     * Get the appropriate execution strategy for the given command and context
+     */
+    getStrategy(command, context) {
+        const strategy = this.strategies.find((s) => s.canExecute(command, context));
+        if (!strategy) {
+            throw new Error(`No suitable execution strategy found for command: ${command.name}`);
+        }
+        return strategy;
+    }
+    /**
+     * Register a new execution strategy
+     */
+    registerStrategy(strategy) {
+        // Insert before the default pipeline strategy
+        this.strategies.splice(this.strategies.length - 1, 0, strategy);
+    }
+}
+//# sourceMappingURL=execution-strategy.js.map

package/dist/executor/execution-strategy.js.map

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

package/dist/executor/hook-execution.service.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Hook Execution Service
+ *
+ * Intercepts tool calls before (PreToolUse) and after (PostToolUse) execution,
+ * running user-configured shell commands that can validate, block, modify, or
+ * observe tool operations.
+ *
+ * Hooks are configured in data/hooks.default.json (built-in) or .valora/hooks.json (project-level override).
+ * Hook commands receive tool call info via stdin JSON and control execution
+ * via exit codes (0=allow, 2=deny for PreToolUse; PostToolUse is non-blocking).
+ */
+import type { HookCommand, HookEventName, HookExecutionResult, HookInput, HookMatcher, HookOutput } from '../types/hook.types.js';
+import type { LLMToolCall } from '../types/llm.types.js';
+export declare class HookExecutionService {
+    private hooksFileCache;
+    private hooksFileMtime;
+    private readonly logger;
+    private sessionId?;
+    /**
+     * Fast check to skip processing when no hooks are configured.
+     * Returns false for zero-overhead path when hooks are not in use.
+     */
+    hasHooks(eventName: HookEventName): boolean;
+    /**
+     * Set the session ID included in hook input payloads.
+     */
+    setSessionId(sessionId: string): void;
+    /**
+     * Execute PreToolUse hooks for a tool call.
+     * Hooks can block execution (exit code 2) or modify tool input (exit code 0 with updatedInput).
+     * Hooks execute sequentially; first deny stops the chain.
+     */
+    executePreToolUseHooks(toolCall: LLMToolCall): Promise<HookExecutionResult>;
+    /**
+     * Run a single PreToolUse hook and apply its result.
+     * Returns true if the hook blocked execution (deny).
+     */
+    private runPreToolUseHook;
+    /**
+     * Handle a PreToolUse hook deny (exit code 2).
+     */
+    private handlePreToolUseDeny;
+    /**
+     * Handle a PreToolUse hook allow (exit code 0), applying any updatedInput.
+     */
+    private handlePreToolUseAllow;
+    /**
+     * Execute PostToolUse hooks for a tool call (non-blocking, informational only).
+     * Exit codes are logged but never block the pipeline.
+     * Async hooks fire-and-forget without awaiting completion.
+     */
+    executePostToolUseHooks(toolCall: LLMToolCall, toolResult: string): Promise<void>;
+    /**
+     * Spawn a shell command, writing JSON to stdin.
+     * Returns the exit code, stdout, and stderr.
+     */
+    executeHookCommand(hook: HookCommand, input: HookInput): Promise<{
+        exitCode: number;
+        stderr: string;
+        stdout: string;
+    }>;
+    /**
+     * Test regex matchers against tool name and collect matching hook commands.
+     * Invalid regexes are skipped with a warning (graceful degradation).
+     */
+    findMatchingHooks(toolName: string, matchers: HookMatcher[]): HookCommand[];
+    /**
+     * Safely parse JSON output from a hook command's stdout.
+     * Returns null if stdout is empty or not valid JSON.
+     */
+    parseHookOutput(stdout: string): HookOutput | null;
+    /**
+     * Load hooks from data/hooks.default.json with mtime-based caching.
+     * Returns null if the file doesn't exist or can't be parsed.
+     */
+    private loadHooksFile;
+    /**
+     * Read hooks config, merging data/hooks.default.json (primary) with config.json (fallback).
+     * For each event name, hooks.json matchers come first; duplicates by matcher pattern
+     * are resolved in favour of hooks.json.
+     */
+    private getHooksConfig;
+    /**
+     * Merge two HooksConfig objects. Primary (hooks.json) takes priority;
+     * config.json matchers with the same pattern are skipped.
+     */
+    private mergeHooksConfigs;
+    /**
+     * Build the HookInput object sent to hook commands via stdin.
+     */
+    private buildHookInput;
+}
+export declare function getHookExecutionService(): HookExecutionService;
+export declare function setHookExecutionService(service: HookExecutionService): void;
+//# sourceMappingURL=hook-execution.service.d.ts.map

package/dist/executor/hook-execution.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-execution.service.d.ts","sourceRoot":"","sources":["../../src/executor/hook-execution.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACX,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,SAAS,EACT,WAAW,EACX,UAAU,EAEV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAenD,qBAAa,oBAAoB;IAChC,OAAO,CAAC,cAAc,CAAwC;IAC9D,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,SAAS,CAAC,CAAS;IAE3B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO;IAS3C;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIrC;;;;OAIG;IACG,sBAAsB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAoCjF;;;OAGG;YACW,iBAAiB;IAoC/B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;;;OAIG;IACG,uBAAuB,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuEvF;;;OAGG;IACH,kBAAkB,CACjB,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,SAAS,GACd,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAgChE;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE;IA2B3E;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAalD;;;OAGG;IACH,OAAO,CAAC,aAAa;IAqBrB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAiBtB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;OAEG;IACH,OAAO,CAAC,cAAc;CAetB;AAKD,wBAAgB,uBAAuB,IAAI,oBAAoB,CAG9D;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAE3E"}