@windagency/valora 2.0.1

package/dist/executor/command-loader.js

@@ -0,0 +1,93 @@
+/**
+ * Command loader - loads command definitions from markdown files
+ */
+import { getLogger } from '../output/logger.js';
+import { readFile } from '../utils/file-utils.js';
+import { parseMarkdownWithFrontmatter } from '../utils/yaml-parser.js';
+import { commandFileExists, getCommandFilePath, listAvailableCommands, validateCommandName } from './command-discovery.js';
+import { handleCommandLoadError, validateCommandMetadata } from './command-validation.js';
+export class CommandLoader {
+    commandsDir;
+    cache = new Map();
+    constructor(commandsDir) {
+        this.commandsDir = commandsDir;
+        // commandsDir is handled by the imported functions
+    }
+    /**
+     * Load a specific command by name
+     */
+    async loadCommand(commandName, loadContent = true) {
+        // Validate command name for security
+        validateCommandName(commandName);
+        // Check cache first
+        if (this.cache.has(commandName)) {
+            return this.cache.get(commandName);
+        }
+        const filePath = getCommandFilePath(commandName, this.commandsDir);
+        try {
+            const content = await readFile(filePath);
+            const parsed = parseMarkdownWithFrontmatter(content, filePath);
+            // Validate command metadata using the validation module
+            validateCommandMetadata(parsed.metadata, filePath);
+            const command = {
+                ...parsed.metadata,
+                content: loadContent ? parsed.content : '' // Lazy load content
+            };
+            // Cache the command
+            this.cache.set(commandName, command);
+            return command;
+        }
+        catch (error) {
+            handleCommandLoadError(error, commandName, filePath);
+        }
+    }
+    /**
+     * Load all commands
+     */
+    async loadAllCommands() {
+        const logger = getLogger();
+        const commandNames = await listAvailableCommands(this.commandsDir);
+        // Load all commands in parallel
+        const commandEntries = await Promise.all(commandNames.map(async (commandName) => {
+            try {
+                const command = await this.loadCommand(commandName);
+                return { command, commandName };
+            }
+            catch (error) {
+                logger.warn(`Failed to load command ${commandName}`, { error: error.message });
+                return null;
+            }
+        }));
+        // Convert successful entries to Map, filtering out failed loads
+        return new Map(commandEntries
+            .filter((entry) => entry !== null)
+            .map(({ command, commandName }) => [commandName, command]));
+    }
+    /**
+     * List available command names
+     */
+    async listCommands() {
+        return listAvailableCommands(this.commandsDir);
+    }
+    /**
+     * Check if a command exists
+     */
+    async commandExists(commandName) {
+        // Validate command name for security
+        validateCommandName(commandName);
+        return commandFileExists(commandName, this.commandsDir);
+    }
+    /**
+     * Clear cache
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache size
+     */
+    getCacheSize() {
+        return this.cache.size;
+    }
+}
+//# sourceMappingURL=command-loader.js.map

package/dist/executor/command-loader.js.map

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

package/dist/executor/command-validation.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Command validation utilities - handles command definition validation and metadata checking
+ */
+import type { CommandMetadata } from '../types/command.types.js';
+/**
+ * Required fields for command metadata
+ */
+export declare const REQUIRED_COMMAND_FIELDS: string[];
+/**
+ * Validate command metadata structure
+ */
+export declare function validateCommandMetadata(metadata: CommandMetadata, filePath: string): void;
+/**
+ * Validate pipeline stages structure
+ */
+export declare function validatePipelineStages(pipeline: unknown[], filePath: string): void;
+/**
+ * Handle command loading errors with appropriate error types
+ */
+export declare function handleCommandLoadError(error: unknown, commandName: string, filePath: string): never;
+//# sourceMappingURL=command-validation.d.ts.map

package/dist/executor/command-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-validation.d.ts","sourceRoot":"","sources":["../../src/executor/command-validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D;;GAEG;AACH,eAAO,MAAM,uBAAuB,UAA+D,CAAC;AAEpG;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CA0BzF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CA+BlF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,CAQnG"}

package/dist/executor/command-validation.js

@@ -0,0 +1,79 @@
+/**
+ * Command validation utilities - handles command definition validation and metadata checking
+ */
+import { ValidationError } from '../utils/error-handler.js';
+import { validateRequiredFields, YamlParseError } from '../utils/yaml-parser.js';
+/**
+ * Required fields for command metadata
+ */
+export const REQUIRED_COMMAND_FIELDS = ['name', 'description', 'model', 'allowed-tools', 'prompts'];
+/**
+ * Validate command metadata structure
+ */
+export function validateCommandMetadata(metadata, filePath) {
+    // Validate required fields
+    validateRequiredFields(metadata, REQUIRED_COMMAND_FIELDS, filePath);
+    // Additional validation for agent field based on dynamic selection
+    if (!metadata.dynamic_agent_selection && !metadata.agent) {
+        throw new ValidationError('Command must have either an agent field or dynamic_agent_selection enabled', {
+            file: filePath
+        });
+    }
+    if (metadata.dynamic_agent_selection && !metadata.fallback_agent) {
+        throw new ValidationError('Commands with dynamic_agent_selection must specify a fallback_agent', {
+            file: filePath
+        });
+    }
+    // Validate prompts structure
+    if (!metadata.prompts?.pipeline || !Array.isArray(metadata.prompts.pipeline)) {
+        throw new ValidationError('Command must have a valid prompts.pipeline array', {
+            file: filePath
+        });
+    }
+    // Validate pipeline stages
+    validatePipelineStages(metadata.prompts.pipeline, filePath);
+}
+/**
+ * Validate pipeline stages structure
+ */
+export function validatePipelineStages(pipeline, filePath) {
+    if (!Array.isArray(pipeline)) {
+        throw new ValidationError('Pipeline must be an array', {
+            file: filePath
+        });
+    }
+    pipeline.forEach((stage) => {
+        if (typeof stage !== 'object' || stage === null) {
+            throw new ValidationError('Pipeline stage must be an object', {
+                file: filePath,
+                stage
+            });
+        }
+        const stageObj = stage;
+        if (!stageObj['stage'] || typeof stageObj['stage'] !== 'string') {
+            throw new ValidationError('Pipeline stage must have a "stage" string property', {
+                file: filePath,
+                stage: stageObj
+            });
+        }
+        if (!stageObj['prompt'] || typeof stageObj['prompt'] !== 'string') {
+            throw new ValidationError('Pipeline stage must have a "prompt" string property', {
+                file: filePath,
+                stage: stageObj
+            });
+        }
+    });
+}
+/**
+ * Handle command loading errors with appropriate error types
+ */
+export function handleCommandLoadError(error, commandName, filePath) {
+    if (error instanceof YamlParseError || error instanceof ValidationError) {
+        throw error;
+    }
+    throw new ValidationError(`Failed to load command: ${commandName}`, {
+        error: error.message,
+        file: filePath
+    });
+}
+//# sourceMappingURL=command-validation.js.map

package/dist/executor/command-validation.js.map

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

package/dist/executor/dry-run-cache.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Dry Run Cache - Caches dry-run analysis results for faster subsequent execution
+ *
+ * When a command is run with --dry-run, the analysis/planning phase is cached.
+ * When the same command is run without --dry-run, the cached result is used
+ * to skip redundant analysis and speed up execution.
+ */
+import type { CommandDefinition, PipelineStage, StageOutput } from '../types/command.types.js';
+/**
+ * Pre-loaded prompt data for faster execution
+ */
+export interface PreloadedPrompt {
+    content: string;
+    id: string;
+    metadata: Record<string, unknown>;
+}
+/**
+ * Pre-loaded agent data for faster execution
+ */
+export interface PreloadedAgent {
+    content: string;
+    decisionMaking?: {
+        escalationCriteria?: string[];
+    };
+    role: string;
+}
+/**
+ * Pre-resolved stage inputs (static variables that don't depend on LLM output)
+ */
+export interface PreresolvedInputs {
+    enrichedInputs: Record<string, unknown>;
+    resolvedInputs: Record<string, unknown>;
+    stageName: string;
+}
+/**
+ * Cached dry-run result
+ */
+export interface DryRunCacheEntry {
+    /** The command that was analyzed */
+    commandName: string;
+    /** Timestamp when the cache entry was created */
+    createdAt: number;
+    /** TTL in milliseconds for this cache entry */
+    ttl: number;
+    /** The planned pipeline stages after analysis */
+    plannedStages: PipelineStage[];
+    /** Analysis outputs from the dry-run (e.g., resolved variables, agent selection) */
+    analysisOutputs: Record<string, unknown>;
+    /** Pre-computed stage outputs if available */
+    precomputedOutputs?: StageOutput[];
+    /** Hash of the command definition for invalidation */
+    commandHash: string;
+    /** The resolved agent role */
+    agentRole?: string;
+    /** The resolved model */
+    model?: string;
+    /** Session context snapshot */
+    sessionContextSnapshot?: Record<string, unknown>;
+    /** Pre-loaded prompts for all pipeline stages */
+    preloadedPrompts?: PreloadedPrompt[];
+    /** Pre-loaded agent definition */
+    preloadedAgent?: PreloadedAgent;
+    /** Pre-resolved inputs for each stage (static variables only) */
+    preresolvedInputs?: PreresolvedInputs[];
+    /** Pipeline validation results (true = valid) */
+    pipelineValidated?: boolean;
+    /** Resolved args map for variable resolution */
+    resolvedArgs?: Record<string, unknown>;
+}
+/**
+ * Options for cache lookup
+ */
+export interface DryRunCacheLookupOptions {
+    args: string[];
+    command: CommandDefinition;
+    commandName: string;
+    flags: Record<string, boolean | string | undefined>;
+    sessionContext?: Record<string, unknown>;
+}
+/**
+ * Result of a cache lookup
+ */
+export interface DryRunCacheLookupResult {
+    entry?: DryRunCacheEntry;
+    hit: boolean;
+    reason?: string;
+}
+/**
+ * Dry Run Cache Service
+ *
+ * Provides in-memory caching of dry-run results for improved performance
+ * when the same command is run without --dry-run.
+ */
+export declare class DryRunCache {
+    private static instance;
+    private cache;
+    private defaultTtl;
+    constructor(defaultTtl?: number);
+    /**
+     * Get singleton instance
+     */
+    static getInstance(): DryRunCache;
+    /**
+     * Reset singleton instance (for testing)
+     */
+    static resetInstance(): void;
+    /**
+     * Generate a cache key from command options
+     */
+    generateCacheKey(options: DryRunCacheLookupOptions): string;
+    /**
+     * Generate a hash of the command definition for invalidation
+     */
+    generateCommandHash(command: CommandDefinition): string;
+    /**
+     * Store a dry-run result in the cache
+     */
+    set(options: DryRunCacheLookupOptions, entry: Omit<DryRunCacheEntry, 'commandHash' | 'createdAt' | 'ttl'>): void;
+    /**
+     * Look up a cached dry-run result
+     */
+    get(options: DryRunCacheLookupOptions): DryRunCacheLookupResult;
+    /**
+     * Invalidate a cache entry
+     */
+    invalidate(options: DryRunCacheLookupOptions): boolean;
+    /**
+     * Invalidate all cache entries for a command
+     */
+    invalidateCommand(commandName: string): number;
+    /**
+     * Clear all cache entries
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        entries: Array<{
+            ageMs: number;
+            commandName: string;
+            key: string;
+        }>;
+        size: number;
+    };
+    /**
+     * Evict oldest cache entries
+     */
+    private evictOldest;
+}
+/**
+ * Get the singleton dry-run cache instance
+ */
+export declare function getDryRunCache(): DryRunCache;
+//# sourceMappingURL=dry-run-cache.d.ts.map

package/dist/executor/dry-run-cache.d.ts.map

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

package/dist/executor/dry-run-cache.js

@@ -0,0 +1,191 @@
+/**
+ * Dry Run Cache - Caches dry-run analysis results for faster subsequent execution
+ *
+ * When a command is run with --dry-run, the analysis/planning phase is cached.
+ * When the same command is run without --dry-run, the cached result is used
+ * to skip redundant analysis and speed up execution.
+ */
+import { createHash } from 'crypto';
+import { getLogger } from '../output/logger.js';
+/**
+ * Default TTL for cache entries (5 minutes)
+ */
+const DEFAULT_TTL_MS = 5 * 60 * 1000;
+/**
+ * Maximum number of cache entries to keep
+ */
+const MAX_CACHE_ENTRIES = 50;
+/**
+ * Dry Run Cache Service
+ *
+ * Provides in-memory caching of dry-run results for improved performance
+ * when the same command is run without --dry-run.
+ */
+export class DryRunCache {
+    static instance = null;
+    cache = new Map();
+    defaultTtl;
+    constructor(defaultTtl = DEFAULT_TTL_MS) {
+        this.defaultTtl = defaultTtl;
+    }
+    /**
+     * Get singleton instance
+     */
+    static getInstance() {
+        DryRunCache.instance ??= new DryRunCache();
+        return DryRunCache.instance;
+    }
+    /**
+     * Reset singleton instance (for testing)
+     */
+    static resetInstance() {
+        DryRunCache.instance = null;
+    }
+    /**
+     * Generate a cache key from command options
+     */
+    generateCacheKey(options) {
+        const { args, commandName, flags } = options;
+        // Filter out flags that shouldn't affect the cache key
+        const relevantFlags = { ...flags };
+        delete relevantFlags['dryRun'];
+        delete relevantFlags['dry-run'];
+        delete relevantFlags['verbose'];
+        delete relevantFlags['quiet'];
+        delete relevantFlags['progress'];
+        const keyData = JSON.stringify({
+            args: args.sort(),
+            commandName,
+            flags: Object.entries(relevantFlags)
+                .filter(([, v]) => v !== undefined)
+                .sort(([a], [b]) => a.localeCompare(b))
+        });
+        return createHash('sha256').update(keyData).digest('hex').substring(0, 16);
+    }
+    /**
+     * Generate a hash of the command definition for invalidation
+     */
+    generateCommandHash(command) {
+        const hashData = JSON.stringify({
+            agent: command.agent,
+            model: command.model,
+            name: command.name,
+            prompts: command.prompts
+        });
+        return createHash('sha256').update(hashData).digest('hex').substring(0, 16);
+    }
+    /**
+     * Store a dry-run result in the cache
+     */
+    set(options, entry) {
+        const logger = getLogger();
+        const cacheKey = this.generateCacheKey(options);
+        const commandHash = this.generateCommandHash(options.command);
+        const fullEntry = {
+            ...entry,
+            commandHash,
+            createdAt: Date.now(),
+            ttl: this.defaultTtl
+        };
+        // Enforce max cache size by removing oldest entries
+        if (this.cache.size >= MAX_CACHE_ENTRIES) {
+            this.evictOldest();
+        }
+        this.cache.set(cacheKey, fullEntry);
+        logger.debug('Dry-run cache: stored entry', {
+            cacheKey,
+            commandName: entry.commandName,
+            stageCount: entry.plannedStages.length
+        });
+    }
+    /**
+     * Look up a cached dry-run result
+     */
+    get(options) {
+        const logger = getLogger();
+        const cacheKey = this.generateCacheKey(options);
+        const entry = this.cache.get(cacheKey);
+        if (!entry) {
+            return { hit: false, reason: 'no_entry' };
+        }
+        // Check TTL
+        const now = Date.now();
+        if (now - entry.createdAt > entry.ttl) {
+            this.cache.delete(cacheKey);
+            logger.debug('Dry-run cache: entry expired', { cacheKey, commandName: entry.commandName });
+            return { hit: false, reason: 'expired' };
+        }
+        // Check command hash for invalidation
+        const currentHash = this.generateCommandHash(options.command);
+        if (currentHash !== entry.commandHash) {
+            this.cache.delete(cacheKey);
+            logger.debug('Dry-run cache: command definition changed', { cacheKey, commandName: entry.commandName });
+            return { hit: false, reason: 'command_changed' };
+        }
+        logger.info('Dry-run cache: hit', {
+            ageMs: now - entry.createdAt,
+            cacheKey,
+            commandName: entry.commandName
+        });
+        return { entry, hit: true };
+    }
+    /**
+     * Invalidate a cache entry
+     */
+    invalidate(options) {
+        const cacheKey = this.generateCacheKey(options);
+        return this.cache.delete(cacheKey);
+    }
+    /**
+     * Invalidate all cache entries for a command
+     */
+    invalidateCommand(commandName) {
+        let count = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            if (entry.commandName === commandName) {
+                this.cache.delete(key);
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Clear all cache entries
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        const now = Date.now();
+        const entries = Array.from(this.cache.entries()).map(([key, entry]) => ({
+            ageMs: now - entry.createdAt,
+            commandName: entry.commandName,
+            key
+        }));
+        return { entries, size: this.cache.size };
+    }
+    /**
+     * Evict oldest cache entries
+     */
+    evictOldest() {
+        const logger = getLogger();
+        const sortedEntries = Array.from(this.cache.entries()).sort(([, a], [, b]) => a.createdAt - b.createdAt);
+        // Remove oldest 10% of entries
+        const toRemove = Math.max(1, Math.floor(sortedEntries.length * 0.1));
+        for (let i = 0; i < toRemove; i++) {
+            const [key, entry] = sortedEntries[i];
+            this.cache.delete(key);
+            logger.debug('Dry-run cache: evicted entry', { commandName: entry.commandName, key });
+        }
+    }
+}
+/**
+ * Get the singleton dry-run cache instance
+ */
+export function getDryRunCache() {
+    return DryRunCache.getInstance();
+}
+//# sourceMappingURL=dry-run-cache.js.map

package/dist/executor/dry-run-cache.js.map

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

package/dist/executor/dry-run-preview.service.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Dry Run Preview Service
+ *
+ * Displays a comprehensive summary of simulated operations from dry-run mode.
+ * Shows file changes with diffs, terminal commands, and token/cost estimates.
+ */
+import type { LLMMessage } from '../types/llm.types.js';
+import { type ColorAdapter } from '../output/color-adapter.interface.js';
+import { type ConsoleOutput } from '../output/console-output.js';
+import { type TokenEstimate } from '../utils/token-estimator.js';
+import type { SimulatedOperation } from './tools/dry-run-simulator.service.js';
+/**
+ * Options for displaying the dry-run preview
+ */
+export interface DryRunPreviewOptions {
+    /** Model name for cost estimation */
+    model?: string;
+    /** Show diff previews for file changes */
+    showDiffs?: boolean;
+    /** Show token/cost estimates */
+    showTokenEstimates?: boolean;
+}
+/**
+ * Summary of dry-run execution
+ */
+export interface DryRunSummary {
+    /** Total estimated cost */
+    estimatedCost?: TokenEstimate;
+    /** File operations (create, modify, delete) */
+    fileOperations: SimulatedOperation[];
+    /** Terminal commands that would be executed */
+    terminalCommands: SimulatedOperation[];
+    /** Total number of simulated operations */
+    totalOperations: number;
+}
+/**
+ * Service for displaying dry-run preview summaries
+ */
+export declare class DryRunPreviewService {
+    private readonly color;
+    private readonly console;
+    constructor(console?: ConsoleOutput, color?: ColorAdapter);
+    /**
+     * Build a summary from simulated operations
+     */
+    buildSummary(operations: SimulatedOperation[], messages?: LLMMessage[], model?: string): DryRunSummary;
+    /**
+     * Display the full dry-run preview
+     */
+    display(operations: SimulatedOperation[], options?: DryRunPreviewOptions): void;
+    /**
+     * Display the preview with token estimates
+     */
+    displayWithEstimates(operations: SimulatedOperation[], messages: LLMMessage[], options?: DryRunPreviewOptions): void;
+    /**
+     * Display header
+     */
+    private displayHeader;
+    /**
+     * Display file operations section
+     */
+    private displayFileOperations;
+    /**
+     * Display a single file operation
+     */
+    private displayFileOperation;
+    /**
+     * Display diff for a file operation
+     */
+    private displayDiff;
+    /**
+     * Apply colour to a diff line based on its prefix
+     */
+    private colorizeDiffLine;
+    /**
+     * Display terminal commands section
+     */
+    private displayTerminalCommands;
+    /**
+     * Display external operations section (web search, MCP, etc.)
+     */
+    private displayExternalOperations;
+    /**
+     * Display token estimates section
+     */
+    private displayTokenEstimates;
+    /**
+     * Display footer
+     */
+    private displayFooter;
+    /**
+     * Display a compact summary (single line)
+     */
+    displayCompact(operations: SimulatedOperation[]): void;
+    /**
+     * Group operations by type using reduce
+     */
+    private groupByType;
+}
+export declare function getDryRunPreviewService(): DryRunPreviewService;
+//# sourceMappingURL=dry-run-preview.service.d.ts.map