@hypercli/gen 0.1.1

package/dist/recipe-engine/tools/shell-tool.js

@@ -0,0 +1,149 @@
+/**
+ * Shell Tool Implementation for Recipe Step System
+ *
+ * This tool executes shell commands as part of the recipe execution pipeline.
+ * It integrates with the existing shell operations in src/ops/shell.ts.
+ */
+import { renderTemplate } from "#template-engines/jig-engine";
+import { Tool } from "./base.js";
+export class ShellTool extends Tool {
+    constructor(name = "shell-tool", options = {}) {
+        super("shell", name, options);
+    }
+    async onValidate(step, context) {
+        const errors = [];
+        const warnings = [];
+        const suggestions = [];
+        if (!step.command) {
+            errors.push("Shell command is required");
+        }
+        if (step.cwd && typeof step.cwd !== "string") {
+            errors.push("Working directory (cwd) must be a string");
+        }
+        return {
+            isValid: errors.length === 0,
+            errors,
+            warnings,
+            suggestions,
+            estimatedExecutionTime: 1000,
+            resourceRequirements: {
+                memory: 10 * 1024 * 1024,
+                disk: 0,
+                network: true, // Optimistically assume network might be used
+                processes: 1,
+            },
+        };
+    }
+    async onExecute(step, context, options) {
+        const startTime = new Date();
+        this.debug("Executing shell command: %s", step.command);
+        try {
+            // Render command through Jig to support @if/@elseif/@end tags and {{ variable }} interpolation
+            const renderContext = this.buildRenderContext(step, context);
+            const command = await renderTemplate(step.command, renderContext);
+            const cwd = step.cwd ? await renderTemplate(step.cwd, renderContext) : context.projectRoot;
+            // shell() returns a Promise<ActionResult> (which is { status: string })
+            // but also executes the command. The current shell op implementation seems to be
+            // specific to the legacy action system. We might need to adapt it or use simple exec.
+            // However, for now let's use it as requested.
+            // NOTE: The current ops/shell.ts implementation is tied to legacy ops.
+            // It returns a function runner format. Since we want standard behavior, we might
+            // rely on node's child_process directly if ops/shell is too specific, but let's try to reuse.
+            // Wait, looking at ops/shell.ts, it uses `exec` from context.
+            // We need to provide that context.
+            // For now, let's implement a direct execution to be safe and avoid legacy baggage,
+            // enabling full control over the step result.
+            const { exec } = await import("node:child_process");
+            const { promisify } = await import("node:util");
+            const execAsync = promisify(exec);
+            // Strip CLAUDECODE env var to prevent "nested session" errors when
+            // running inside Claude Code (the env var makes child processes think
+            // they're inside a Claude session and refuse to run).
+            const { CLAUDECODE, ...cleanEnv } = process.env;
+            const { stdout, stderr } = await execAsync(command, {
+                cwd,
+                env: { ...cleanEnv, ...step.env },
+            });
+            const endTime = new Date();
+            const duration = endTime.getTime() - startTime.getTime();
+            return {
+                status: "completed",
+                stepName: step.name,
+                toolType: "shell",
+                startTime,
+                endTime,
+                duration,
+                retryCount: 0,
+                dependenciesSatisfied: true,
+                toolResult: {
+                    exitCode: 0,
+                    stdout: stdout.toString(),
+                    stderr: stderr.toString(),
+                },
+                output: {
+                    stdout: stdout.toString(),
+                },
+            };
+        }
+        catch (error) {
+            const endTime = new Date();
+            const duration = endTime.getTime() - startTime.getTime();
+            return {
+                status: "failed",
+                stepName: step.name,
+                toolType: "shell",
+                startTime,
+                endTime,
+                duration,
+                retryCount: 0,
+                dependenciesSatisfied: true,
+                error: {
+                    message: error.message,
+                    code: "SHELL_EXECUTION_ERROR",
+                    cause: error,
+                },
+            };
+        }
+    }
+    /**
+     * Build render context by merging step and recipe variables.
+     * This matches the pattern used in template-tool.ts for consistency.
+     */
+    buildRenderContext(step, context) {
+        // Merge variables: recipe vars < context vars < step vars
+        const mergedVars = {
+            ...context.recipeVariables,
+            ...context.variables,
+            ...step.variables,
+        };
+        return {
+            ...mergedVars,
+            // Recipe-specific context
+            recipe: context.recipe,
+            step: { name: step.name, description: step.description },
+            // Utility functions
+            utils: context.utils,
+            // Step results for dependency access
+            stepResults: context.stepResults ? Object.fromEntries(context.stepResults) : {},
+        };
+    }
+}
+export class ShellToolFactory {
+    create(name = "shell-tool", options = {}) {
+        return new ShellTool(name, options);
+    }
+    getToolType() {
+        return "shell";
+    }
+    validateConfig(config) {
+        // Shell tool setup config is usually empty, but we can validate options if any
+        return {
+            isValid: true,
+            errors: [],
+            warnings: [],
+            suggestions: [],
+        };
+    }
+}
+export const shellToolFactory = new ShellToolFactory();
+//# sourceMappingURL=shell-tool.js.map

package/dist/recipe-engine/tools/shell-tool.js.map

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

package/dist/recipe-engine/tools/template-tool.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Template Tool Implementation for Recipe Step System
+ *
+ * This tool processes template files using Hypergen's existing template engines,
+ * handles frontmatter processing, and generates files to the filesystem.
+ * It integrates seamlessly with the Jig template engine while supporting
+ * all existing template features like composition and variable substitution.
+ */
+import { type StepContext, type StepExecutionOptions, type StepResult, type TemplateStep } from "#recipe-engine/types";
+import { Tool, type ToolValidationResult } from "./base.js";
+/**
+ * Template Tool for processing template files in the Recipe Step System
+ *
+ * Features:
+ * - Integration with the Jig template engine
+ * - Frontmatter processing (to:, skip_if:, inject:, unless_exists:, force:)
+ * - Template discovery and resolution
+ * - Variable substitution and context management
+ * - File generation with path resolution
+ * - Template composition support
+ * - Comprehensive error handling and validation
+ */
+export declare class TemplateTool extends Tool<TemplateStep> {
+    private templateEnginesInitialized;
+    private templateCache;
+    constructor(name?: string, options?: Record<string, any>);
+    /**
+     * Initialize template engines and prepare tool for execution
+     */
+    protected onInitialize(): Promise<void>;
+    /**
+     * Validate template step configuration
+     */
+    protected onValidate(step: TemplateStep, context: StepContext): Promise<ToolValidationResult>;
+    /**
+     * Execute the template tool
+     */
+    protected onExecute(step: TemplateStep, context: StepContext, options?: StepExecutionOptions): Promise<StepResult>;
+    /**
+     * Tool-specific cleanup logic
+     */
+    protected onCleanup(): Promise<void>;
+    /**
+     * Resolve template identifier to file path and content
+     */
+    private resolveTemplate;
+    /**
+     * Process template composition (includes, extends)
+     */
+    private processTemplateComposition;
+    /**
+     * Render a template file with frontmatter processing
+     */
+    private renderTemplateFile;
+    /**
+     * Render a template string with the appropriate engine
+     */
+    private renderTemplate;
+    /**
+     * Build render context by merging step and recipe variables.
+     *
+     * Helpers are registered as Jig globals (not spread into context),
+     * so the context only contains data: variables, step results, and utilities.
+     */
+    private buildRenderContext;
+    /**
+     * Check if file should be skipped based on attributes
+     */
+    private shouldSkipFile;
+    /**
+     * Get skip reason for debugging
+     */
+    private getSkipReason;
+    /**
+     * Generate file using existing file operations
+     */
+    private generateFile;
+}
+/**
+ * Template Tool Factory
+ */
+export declare class TemplateToolFactory {
+    create(name?: string, options?: Record<string, any>): TemplateTool;
+    getToolType(): "template";
+    validateConfig(config: Record<string, any>): ToolValidationResult;
+}
+export declare const templateToolFactory: TemplateToolFactory;
+//# sourceMappingURL=template-tool.d.ts.map

package/dist/recipe-engine/tools/template-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-tool.d.ts","sourceRoot":"","sources":["../../../src/recipe-engine/tools/template-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,UAAU,EAEf,KAAK,YAAY,EAEjB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,IAAI,EAAE,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAC;AA+C5D;;;;;;;;;;;GAWG;AACH,qBAAa,YAAa,SAAQ,IAAI,CAAC,YAAY,CAAC;IACnD,OAAO,CAAC,0BAA0B,CAAS;IAC3C,OAAO,CAAC,aAAa,CAAyC;gBAElD,IAAI,SAAkB,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IAIrE;;OAEG;cACsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BtD;;OAEG;cACa,UAAU,CACzB,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,WAAW,GAClB,OAAO,CAAC,oBAAoB,CAAC;IA+FhC;;OAEG;cACa,SAAS,CACxB,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,UAAU,CAAC;IAmKtB;;OAEG;cACsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAKnD;;OAEG;YACW,eAAe;IAkF7B;;OAEG;YACW,0BAA0B;IA6BxC;;OAEG;YACW,kBAAkB;IAiEhC;;OAEG;YACW,cAAc;IAqB5B;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAgC1B;;OAEG;IACH,OAAO,CAAC,cAAc;IA2BtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;YACW,YAAY;CAwE1B;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC/B,MAAM,CAAC,IAAI,SAAkB,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,YAAY;IAI/E,WAAW,IAAI,UAAU;IAIzB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,oBAAoB;CAwBjE;AAGD,eAAO,MAAM,mBAAmB,qBAA4B,CAAC"}