@hypercli/gen 0.1.1

package/dist/recipe-engine/index.js

@@ -0,0 +1,223 @@
+/**
+ * Recipe Engine - Complete Recipe Step System
+ *
+ * Central export point for the entire Recipe Step System including:
+ * - Recipe Engine (main orchestrator and entry point)
+ * - Step Executor (orchestration engine)
+ * - Tool Framework (template, action, codemod, recipe tools)
+ * - Type System (comprehensive TypeScript definitions)
+ * - Registry System (tool management)
+ */
+// Main Recipe Engine
+export { RecipeEngine, createRecipeEngine, executeRecipe, loadRecipe, validateRecipe, } from "./recipe-engine.js";
+// Step Execution Engine
+export { StepExecutor, } from "./step-executor.js";
+// Complete Tool Framework
+export * from "./tools/index.js";
+// Complete Type System
+export * from "./types.js";
+// Export type guards from types
+export { isTemplateStep, isActionStep, isCodeModStep, isRecipeStep, isAIStep, isInstallStep, isQueryStep, isPatchStep, isEnsureDirsStep, StepExecutionError, RecipeDependencyError, CircularDependencyError, } from "./types.js";
+// Recipe Engine Constants and Utilities
+export const RECIPE_ENGINE_VERSION = "8.0.0";
+/**
+ * Supported recipe features in this version
+ */
+export const RECIPE_ENGINE_FEATURES = [
+    "step-orchestration",
+    "dependency-management",
+    "parallel-execution",
+    "conditional-logic",
+    "error-handling",
+    "progress-tracking",
+    "metrics-collection",
+    "tool-registry",
+    "action-pipelines",
+    "codemod-transformations",
+    "sub-recipe-execution",
+];
+/**
+ * Initialize the Recipe Engine with all components
+ *
+ * This is the main entry point for setting up the complete Recipe Step System.
+ * Call this once during application startup to configure all components.
+ */
+export function initializeRecipeEngine(config = {}) {
+    // Initialize tools framework first
+    const { initializeToolsFramework } = require("./tools/index.js");
+    const toolRegistry = initializeToolsFramework({
+        enableDebugLogging: config.enableDebugLogging,
+    });
+    // Initialize step executor
+    const { StepExecutor } = require("./step-executor.js");
+    const stepExecutor = new StepExecutor(toolRegistry, config.stepExecutor);
+    // Enable additional debug logging if requested
+    if (config.enableDebugLogging) {
+        const existing = process.env.DEBUG || "";
+        const recipeDebug = "hyper:recipe:*";
+        process.env.DEBUG = existing ? `${existing},${recipeDebug}` : recipeDebug;
+    }
+    const enabledFeatures = config.enabledFeatures || [...RECIPE_ENGINE_FEATURES];
+    return {
+        stepExecutor,
+        toolRegistry,
+        version: RECIPE_ENGINE_VERSION,
+        features: enabledFeatures,
+    };
+}
+/**
+ * Quick setup for common Recipe Engine use cases
+ */
+export const RecipeEnginePresets = {
+    /**
+     * Development preset - optimized for fast feedback
+     */
+    development: () => ({
+        stepExecutor: {
+            maxConcurrency: 5,
+            defaultTimeout: 15000,
+            collectMetrics: true,
+            enableProgressTracking: true,
+            continueOnError: true,
+        },
+        enableDebugLogging: true,
+    }),
+    /**
+     * Production preset - optimized for reliability and performance
+     */
+    production: () => ({
+        stepExecutor: {
+            maxConcurrency: 20,
+            defaultTimeout: 60000,
+            collectMetrics: false,
+            enableProgressTracking: false,
+            continueOnError: false,
+        },
+        enableDebugLogging: false,
+    }),
+    /**
+     * Testing preset - optimized for test isolation and debugging
+     */
+    testing: () => ({
+        stepExecutor: {
+            maxConcurrency: 1, // Sequential execution for predictable tests
+            defaultTimeout: 5000,
+            collectMetrics: true,
+            enableProgressTracking: true,
+            continueOnError: true,
+        },
+        enableDebugLogging: true,
+    }),
+    /**
+     * High performance preset - optimized for speed
+     */
+    performance: () => ({
+        stepExecutor: {
+            maxConcurrency: 50,
+            defaultTimeout: 30000,
+            collectMetrics: false,
+            enableProgressTracking: false,
+            continueOnError: false,
+        },
+        enableDebugLogging: false,
+    }),
+};
+/**
+ * Recipe Engine health check utility
+ */
+export function checkRecipeEngineHealth() {
+    const issues = [];
+    let stepExecutorHealthy = true;
+    let toolRegistryHealthy = true;
+    try {
+        // Check if StepExecutor can be imported
+        const { StepExecutor } = require("./step-executor.js");
+        if (!StepExecutor) {
+            stepExecutorHealthy = false;
+            issues.push("StepExecutor not available");
+        }
+    }
+    catch (error) {
+        stepExecutorHealthy = false;
+        issues.push(`StepExecutor import failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    try {
+        // Check tool registry health
+        const { checkRegistryHealth } = require("./tools/index.js");
+        const registryHealth = checkRegistryHealth();
+        if (!registryHealth.healthy) {
+            toolRegistryHealthy = false;
+            issues.push(...registryHealth.issues.map((issue) => `Tool Registry: ${issue}`));
+        }
+        return {
+            healthy: issues.length === 0,
+            version: RECIPE_ENGINE_VERSION,
+            issues,
+            components: {
+                stepExecutor: stepExecutorHealthy,
+                toolRegistry: toolRegistryHealthy,
+            },
+            toolRegistryHealth: registryHealth,
+        };
+    }
+    catch (error) {
+        toolRegistryHealthy = false;
+        issues.push(`Tool registry health check failed: ${error instanceof Error ? error.message : String(error)}`);
+        return {
+            healthy: false,
+            version: RECIPE_ENGINE_VERSION,
+            issues,
+            components: {
+                stepExecutor: stepExecutorHealthy,
+                toolRegistry: false,
+            },
+            toolRegistryHealth: {
+                healthy: false,
+                issues: ["Registry health check unavailable"],
+                stats: {},
+            },
+        };
+    }
+}
+/**
+ * Development utilities for Recipe Engine
+ */
+export const RecipeEngineDevUtils = {
+    /**
+     * Create a minimal step executor for testing
+     */
+    createTestStepExecutor: (config = {}) => {
+        const { StepExecutor } = require("./step-executor.js");
+        return new StepExecutor(undefined, {
+            maxConcurrency: 1,
+            collectMetrics: true,
+            enableProgressTracking: true,
+            continueOnError: true,
+            ...config,
+        });
+    },
+    /**
+     * Reset all Recipe Engine components for testing
+     */
+    resetForTesting: () => {
+        const { DevUtils } = require("./tools/index.js");
+        DevUtils.resetRegistry();
+    },
+    /**
+     * Get comprehensive debug information
+     */
+    getDebugInfo: () => {
+        const health = checkRecipeEngineHealth();
+        const { DevUtils } = require("./tools/index.js");
+        const registryInfo = DevUtils.getRegistryDebugInfo();
+        return {
+            engine: {
+                version: RECIPE_ENGINE_VERSION,
+                features: RECIPE_ENGINE_FEATURES,
+                health,
+            },
+            toolFramework: registryInfo,
+        };
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/recipe-engine/index.js.map

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

package/dist/recipe-engine/output-evaluator.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Output Expression Evaluator
+ *
+ * Evaluates step `output` expressions against tool results after step execution.
+ * Expressions use Jig template syntax for full flexibility.
+ *
+ * Example recipe YAML:
+ * ```yaml
+ * steps:
+ *   - name: generate-route
+ *     tool: template
+ *     template: ./templates/route.jig
+ *     output:
+ *       update-route-path: "{{ result.filesGenerated[0] }}"
+ *       route-name: "{{ result.variables.routeName | kebabCase }}"
+ * ```
+ */
+import type { StepContext } from "./types.js";
+/**
+ * Evaluate output expressions from a step's `output` field.
+ *
+ * @param outputExpressions  Map of variable names to Jig template expressions
+ * @param toolResult         The raw result returned by the tool
+ * @param context            Current step context (for access to variables etc.)
+ * @returns Map of variable name -> evaluated value
+ */
+export declare function evaluateStepOutputs(outputExpressions: Record<string, string>, toolResult: any, context: StepContext): Promise<Record<string, any>>;
+//# sourceMappingURL=output-evaluator.d.ts.map

package/dist/recipe-engine/output-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-evaluator.d.ts","sourceRoot":"","sources":["../../src/recipe-engine/output-evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACxC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,UAAU,EAAE,GAAG,EACf,OAAO,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAwC9B"}

package/dist/recipe-engine/output-evaluator.js

@@ -0,0 +1,78 @@
+/**
+ * Output Expression Evaluator
+ *
+ * Evaluates step `output` expressions against tool results after step execution.
+ * Expressions use Jig template syntax for full flexibility.
+ *
+ * Example recipe YAML:
+ * ```yaml
+ * steps:
+ *   - name: generate-route
+ *     tool: template
+ *     template: ./templates/route.jig
+ *     output:
+ *       update-route-path: "{{ result.filesGenerated[0] }}"
+ *       route-name: "{{ result.variables.routeName | kebabCase }}"
+ * ```
+ */
+import createDebug from "debug";
+import { renderTemplate } from "#template-engines/index";
+const debug = createDebug("hyper:recipe:output-evaluator");
+/**
+ * Evaluate output expressions from a step's `output` field.
+ *
+ * @param outputExpressions  Map of variable names to Jig template expressions
+ * @param toolResult         The raw result returned by the tool
+ * @param context            Current step context (for access to variables etc.)
+ * @returns Map of variable name -> evaluated value
+ */
+export async function evaluateStepOutputs(outputExpressions, toolResult, context) {
+    const outputs = {};
+    // Build evaluation context
+    const evalContext = {
+        result: toolResult ?? {},
+        step: context.step?.name,
+        status: "completed",
+        ...context.variables,
+    };
+    for (const [varName, expression] of Object.entries(outputExpressions)) {
+        try {
+            debug("Evaluating output expression: %s = %s", varName, expression);
+            // If the expression looks like a Jig template (contains {{ }}), render it
+            if (expression.includes("{{") || expression.includes("@")) {
+                const rendered = await renderTemplate(expression, evalContext);
+                // Trim whitespace that Jig may add
+                const trimmed = typeof rendered === "string" ? rendered.trim() : rendered;
+                outputs[varName] = trimmed;
+            }
+            else {
+                // Plain expression — evaluate as property access on the context
+                outputs[varName] = evaluateSimpleExpression(expression, evalContext);
+            }
+            debug("Output evaluated: %s = %o", varName, outputs[varName]);
+        }
+        catch (error) {
+            debug("Output expression evaluation failed: %s = %s (%s)", varName, expression, error instanceof Error ? error.message : String(error));
+            // Set to undefined on error rather than failing the whole step
+            outputs[varName] = undefined;
+        }
+    }
+    return outputs;
+}
+/**
+ * Evaluate a simple dot-notation expression against a context.
+ * e.g., "result.filesGenerated[0]" or "result.variables.name"
+ */
+function evaluateSimpleExpression(expression, context) {
+    try {
+        // Use Function constructor for safe(r) expression evaluation
+        const keys = Object.keys(context);
+        const values = Object.values(context);
+        const fn = new Function(...keys, `return ${expression}`);
+        return fn(...values);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=output-evaluator.js.map

package/dist/recipe-engine/output-evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-evaluator.js","sourceRoot":"","sources":["../../src/recipe-engine/output-evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,WAAW,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,MAAM,KAAK,GAAG,WAAW,CAAC,+BAA+B,CAAC,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,iBAAyC,EACzC,UAAe,EACf,OAAoB;IAEpB,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,2BAA2B;IAC3B,MAAM,WAAW,GAAwB;QACxC,MAAM,EAAE,UAAU,IAAI,EAAE;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI;QACxB,MAAM,EAAE,WAAW;QACnB,GAAG,OAAO,CAAC,SAAS;KACpB,CAAC;IAEF,KAAK,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACvE,IAAI,CAAC;YACJ,KAAK,CAAC,uCAAuC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;YAEpE,0EAA0E;YAC1E,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3D,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;gBAC/D,mCAAmC;gBACnC,MAAM,OAAO,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;gBAC1E,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACP,gEAAgE;gBAChE,OAAO,CAAC,OAAO,CAAC,GAAG,wBAAwB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;YACtE,CAAC;YAED,KAAK,CAAC,2BAA2B,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,KAAK,CACJ,mDAAmD,EACnD,OAAO,EACP,UAAU,EACV,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACtD,CAAC;YACF,+DAA+D;YAC/D,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;QAC9B,CAAC;IACF,CAAC;IAED,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,wBAAwB,CAAC,UAAkB,EAAE,OAA4B;IACjF,IAAI,CAAC;QACJ,6DAA6D;QAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,GAAG,IAAI,EAAE,UAAU,UAAU,EAAE,CAAC,CAAC;QACzD,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;AACF,CAAC"}

package/dist/recipe-engine/recipe-engine.d.ts

@@ -0,0 +1,227 @@
+/**
+ * Recipe Engine - Main Orchestrator for Recipe Step System
+ *
+ * The RecipeEngine is the primary entry point for executing recipes in HyperDev.
+ * It provides recipe discovery, loading, validation, variable resolution, and execution
+ * coordination through the complete Recipe Step System.
+ */
+import { EventEmitter } from "node:events";
+import { Logger } from "@hypercli/core";
+import type { AiServiceConfig } from "#ai/ai-config";
+import { type StepExecutorConfig } from "./step-executor.js";
+import type { RecipeConfig, RecipeExecution, RecipeValidationResult, StepExecutionOptions, StepResult } from "./types.js";
+/**
+ * Recipe source types for loading
+ */
+export type RecipeSource = {
+    type: "content";
+    content: string;
+    name: string;
+} | {
+    type: "file";
+    path: string;
+};
+/**
+ * Recipe execution options
+ */
+export interface RecipeExecutionOptions {
+    /** Variables to pass to the recipe */
+    variables?: Record<string, any>;
+    /** Environment variables */
+    environment?: Record<string, string>;
+    /** Working directory for execution */
+    workingDir?: string;
+    /** Whether to run in dry-run mode */
+    dryRun?: boolean;
+    /** Whether to force overwrite existing files */
+    force?: boolean;
+    /** Whether to continue on step failures */
+    continueOnError?: boolean;
+    /** Custom step execution options */
+    stepOptions?: Partial<StepExecutionOptions>;
+    /** Whether to skip user prompts (use defaults/existing values) */
+    skipPrompts?: boolean;
+    /** Who resolves missing variables: 'me' (interactive), 'ai', 'nobody' (error) */
+    askMode?: "me" | "ai" | "nobody";
+    /** Don't auto-apply default values — treat all vars as unresolved */
+    noDefaults?: boolean;
+    /** AI config for --ask=ai mode (from hypergen.config.js) */
+    aiConfig?: AiServiceConfig;
+    /** Custom logger for output */
+    logger?: Logger;
+    /** Progress callback */
+    onProgress?: (progress: {
+        step: string;
+        phase: string;
+        percentage: number;
+    }) => void;
+    /** Step completion callback */
+    onStepComplete?: (result: StepResult) => void;
+    /** AI answers for 2-pass generation (Pass 2) */
+    answers?: Record<string, any>;
+}
+/**
+ * Recipe engine configuration
+ */
+export interface RecipeEngineConfig {
+    /** Step executor configuration */
+    stepExecutor?: Partial<StepExecutorConfig>;
+    /** Working directory for all operations */
+    workingDir?: string;
+    /** Default timeout for all operations */
+    defaultTimeout?: number;
+    /** Whether to enable debug logging */
+    enableDebugLogging?: boolean;
+}
+/**
+ * Recipe execution result
+ */
+export interface RecipeExecutionResult {
+    /** Execution ID */
+    executionId: string;
+    /** Recipe that was executed */
+    recipe: RecipeConfig;
+    /** Overall execution status */
+    success: boolean;
+    /** Step execution results */
+    stepResults: StepResult[];
+    /** Total execution time in milliseconds */
+    duration: number;
+    /** Files created during execution */
+    filesCreated: string[];
+    /** Files modified during execution */
+    filesModified: string[];
+    /** Files deleted during execution */
+    filesDeleted: string[];
+    /** Execution errors */
+    errors: string[];
+    /** Execution warnings */
+    warnings: string[];
+    /** Final resolved variables */
+    variables: Record<string, any>;
+    /** Execution metadata */
+    metadata: {
+        startTime: Date;
+        endTime: Date;
+        workingDir: string;
+        totalSteps: number;
+        completedSteps: number;
+        failedSteps: number;
+        skippedSteps: number;
+        /** Values collected from recipe.provides declarations */
+        providedValues?: Record<string, any>;
+    };
+}
+/**
+ * Recipe loading result
+ */
+export interface RecipeLoadResult {
+    recipe: RecipeConfig;
+    source: RecipeSource;
+    validation: RecipeValidationResult;
+    dependencies: RecipeConfig[];
+}
+/**
+ * Main Recipe Engine
+ *
+ * The RecipeEngine provides the primary API for executing recipes. It handles:
+ * - Recipe discovery and loading from various sources
+ * - Recipe validation and preprocessing
+ * - Variable resolution with user prompts
+ * - Step orchestration through StepExecutor
+ * - Result aggregation and reporting
+ * - Error handling and recovery
+ */
+export declare class RecipeEngine extends EventEmitter {
+    private readonly config;
+    private readonly logger;
+    private readonly debug;
+    private readonly stepExecutor;
+    private readonly toolRegistry;
+    private readonly activeExecutions;
+    private executionCounter;
+    private readonly recipeCache;
+    constructor(config?: RecipeEngineConfig);
+    /**
+     * Execute a recipe from various sources
+     *
+     * @param source Recipe source (file path, URL, package name, or content)
+     * @param options Execution options including variables and behavior settings
+     * @returns Promise resolving to execution result
+     */
+    executeRecipe(source: string | RecipeSource, options?: RecipeExecutionOptions): Promise<RecipeExecutionResult>;
+    /**
+     * Load a recipe from a source without executing it
+     */
+    loadRecipe(source: string | RecipeSource): Promise<RecipeLoadResult>;
+    /**
+     * Validate a recipe configuration
+     */
+    validateRecipe(recipe: RecipeConfig): Promise<RecipeValidationResult>;
+    /**
+     * Get current execution status
+     */
+    getExecutions(): RecipeExecution[];
+    /**
+     * Cancel a recipe execution
+     */
+    cancelExecution(executionId: string): Promise<void>;
+    /**
+     * Cancel all active executions
+     */
+    cancelAllExecutions(): Promise<void>;
+    /**
+     * Clean up resources
+     */
+    cleanup(): Promise<void>;
+    private normalizeSource;
+    private getCacheKey;
+    private loadRecipeContent;
+    private loadFileContent;
+    private parseRecipeContent;
+    /**
+     * Parse the `provides` field from recipe YAML
+     */
+    private parseProvides;
+    /**
+     * Normalize steps to infer tool types from shorthands
+     */
+    private normalizeSteps;
+    private resolveVariables;
+    private getPromptType;
+    private createExecutionContext;
+    private createConditionEvaluator;
+    /**
+     * Recursively count steps including those nested in sequence/parallel tools
+     */
+    private countNestedSteps;
+    private aggregateResults;
+    /**
+     * Render and print onSuccess or onError message after recipe execution
+     */
+    private renderLifecycleMessage;
+    private loadDependencies;
+    private dependencyToSource;
+    private validateVariable;
+    private validateStep;
+    private validateStepDependencies;
+    private validateDependency;
+    private generateExecutionId;
+}
+/**
+ * Create a new recipe engine instance
+ */
+export declare function createRecipeEngine(config?: RecipeEngineConfig): RecipeEngine;
+/**
+ * Execute a recipe with default configuration
+ */
+export declare function executeRecipe(source: string | RecipeSource, options?: RecipeExecutionOptions): Promise<RecipeExecutionResult>;
+/**
+ * Load and validate a recipe without executing
+ */
+export declare function loadRecipe(source: string | RecipeSource, config?: RecipeEngineConfig): Promise<RecipeLoadResult>;
+/**
+ * Validate a recipe configuration
+ */
+export declare function validateRecipe(recipe: RecipeConfig, config?: RecipeEngineConfig): Promise<RecipeValidationResult>;
+//# sourceMappingURL=recipe-engine.d.ts.map

package/dist/recipe-engine/recipe-engine.d.ts.map

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