@hypercli/gen 0.1.1

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

@@ -0,0 +1,20 @@
+/**
+ * Install Tool Implementation for Recipe Step System
+ *
+ * Installs packages using the project's package manager.
+ * Auto-detects bun/pnpm/yarn/npm from lockfiles.
+ */
+import type { InstallStep, StepContext, StepExecutionOptions, StepResult } from "#recipe-engine/types";
+import { Tool, type ToolValidationResult } from "./base.js";
+export declare class InstallTool extends Tool<InstallStep> {
+    constructor(name?: string, options?: Record<string, any>);
+    protected onValidate(step: InstallStep, context: StepContext): Promise<ToolValidationResult>;
+    protected onExecute(step: InstallStep, context: StepContext, options?: StepExecutionOptions): Promise<StepResult>;
+}
+export declare class InstallToolFactory {
+    create(name?: string, options?: Record<string, any>): InstallTool;
+    getToolType(): "install";
+    validateConfig(config: Record<string, any>): ToolValidationResult;
+}
+export declare const installToolFactory: InstallToolFactory;
+//# sourceMappingURL=install-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install-tool.d.ts","sourceRoot":"","sources":["../../../src/recipe-engine/tools/install-tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAEX,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,UAAU,EACV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAC;AA8C5D,qBAAa,WAAY,SAAQ,IAAI,CAAC,WAAW,CAAC;gBACrC,IAAI,SAAiB,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;cAIpD,UAAU,CACzB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,WAAW,GAClB,OAAO,CAAC,oBAAoB,CAAC;cAgChB,SAAS,CACxB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,UAAU,CAAC;CAsGtB;AAED,qBAAa,kBAAkB;IAC9B,MAAM,CAAC,IAAI,SAAiB,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,WAAW;IAI7E,WAAW,IAAI,SAAS;IAIxB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,oBAAoB;CAQjE;AAED,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

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

@@ -0,0 +1,194 @@
+/**
+ * Install Tool Implementation for Recipe Step System
+ *
+ * Installs packages using the project's package manager.
+ * Auto-detects bun/pnpm/yarn/npm from lockfiles.
+ */
+import { exec } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { promisify } from "node:util";
+import { Tool } from "./base.js";
+const execAsync = promisify(exec);
+/**
+ * Detect the project's package manager from lockfiles
+ */
+function detectPackageManager(projectRoot) {
+    const lockfiles = [
+        ["bun.lockb", "bun"],
+        ["bun.lock", "bun"],
+        ["pnpm-lock.yaml", "pnpm"],
+        ["yarn.lock", "yarn"],
+        ["package-lock.json", "npm"],
+    ];
+    for (const [file, pm] of lockfiles) {
+        if (fs.existsSync(path.join(projectRoot, file))) {
+            return pm;
+        }
+    }
+    // Default to npm
+    return "npm";
+}
+/**
+ * Build the install command for a package manager
+ */
+function buildInstallCommand(pm, packages, dev) {
+    const pkgList = packages.join(" ");
+    switch (pm) {
+        case "bun":
+            return `bun add ${dev ? "--dev " : ""}${pkgList}`;
+        case "pnpm":
+            return `pnpm add ${dev ? "--save-dev " : ""}${pkgList}`;
+        case "yarn":
+            return `yarn add ${dev ? "--dev " : ""}${pkgList}`;
+        case "npm":
+            return `npm install ${dev ? "--save-dev " : ""}${pkgList}`;
+    }
+}
+export class InstallTool extends Tool {
+    constructor(name = "install-tool", options = {}) {
+        super("install", name, options);
+    }
+    async onValidate(step, context) {
+        const errors = [];
+        const warnings = [];
+        const suggestions = [];
+        if (!step.packages || !Array.isArray(step.packages) || step.packages.length === 0) {
+            errors.push("At least one package is required");
+        }
+        if (step.packages) {
+            for (const pkg of step.packages) {
+                if (typeof pkg !== "string" || pkg.trim() === "") {
+                    errors.push(`Invalid package name: ${pkg}`);
+                }
+            }
+        }
+        return {
+            isValid: errors.length === 0,
+            errors,
+            warnings,
+            suggestions,
+            estimatedExecutionTime: 10000,
+            resourceRequirements: {
+                memory: 50 * 1024 * 1024,
+                disk: 100 * 1024 * 1024,
+                network: true,
+                processes: 1,
+            },
+        };
+    }
+    async onExecute(step, context, options) {
+        const startTime = new Date();
+        this.debug("Installing packages: %o", step.packages);
+        try {
+            const pm = step.packageManager || detectPackageManager(context.projectRoot);
+            const dev = step.dev || false;
+            const command = buildInstallCommand(pm, step.packages, dev);
+            this.debug("Using %s: %s", pm, command);
+            if (options?.dryRun || context.dryRun) {
+                const endTime = new Date();
+                return {
+                    status: "completed",
+                    stepName: step.name,
+                    toolType: "install",
+                    startTime,
+                    endTime,
+                    duration: endTime.getTime() - startTime.getTime(),
+                    retryCount: 0,
+                    dependenciesSatisfied: true,
+                    toolResult: {
+                        packageManager: pm,
+                        packages: step.packages,
+                        dev,
+                        dryRun: true,
+                        command,
+                    },
+                    output: { command, dryRun: true },
+                };
+            }
+            // Strip CLAUDECODE to avoid "nested session" errors inside Claude Code
+            const { CLAUDECODE: _, ...cleanEnv } = process.env;
+            const { stdout, stderr } = await execAsync(command, {
+                cwd: context.projectRoot,
+                env: { ...cleanEnv },
+            });
+            const endTime = new Date();
+            return {
+                status: "completed",
+                stepName: step.name,
+                toolType: "install",
+                startTime,
+                endTime,
+                duration: endTime.getTime() - startTime.getTime(),
+                retryCount: 0,
+                dependenciesSatisfied: true,
+                toolResult: {
+                    packageManager: pm,
+                    packages: step.packages,
+                    dev,
+                    exitCode: 0,
+                    stdout: stdout.toString(),
+                    stderr: stderr.toString(),
+                },
+                output: { stdout: stdout.toString() },
+            };
+        }
+        catch (error) {
+            const endTime = new Date();
+            const duration = endTime.getTime() - startTime.getTime();
+            // If optional, treat failure as completed with warning
+            if (step.optional) {
+                this.debug("Optional install failed (non-fatal): %s", error.message);
+                return {
+                    status: "completed",
+                    stepName: step.name,
+                    toolType: "install",
+                    startTime,
+                    endTime,
+                    duration,
+                    retryCount: 0,
+                    dependenciesSatisfied: true,
+                    toolResult: {
+                        packages: step.packages,
+                        optional: true,
+                        warning: `Install failed (optional): ${error.message}`,
+                    },
+                    output: { warning: error.message },
+                };
+            }
+            return {
+                status: "failed",
+                stepName: step.name,
+                toolType: "install",
+                startTime,
+                endTime,
+                duration,
+                retryCount: 0,
+                dependenciesSatisfied: true,
+                error: {
+                    message: error.message,
+                    code: "INSTALL_FAILED",
+                    cause: error,
+                },
+            };
+        }
+    }
+}
+export class InstallToolFactory {
+    create(name = "install-tool", options = {}) {
+        return new InstallTool(name, options);
+    }
+    getToolType() {
+        return "install";
+    }
+    validateConfig(config) {
+        return {
+            isValid: true,
+            errors: [],
+            warnings: [],
+            suggestions: [],
+        };
+    }
+}
+export const installToolFactory = new InstallToolFactory();
+//# sourceMappingURL=install-tool.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * Parallel Tool Implementation for Recipe Step System
+ *
+ * This tool executes a list of recipe steps concurrently.
+ * It leverages the StepExecutor's parallel execution capabilities.
+ */
+import type { ParallelStep, StepContext, StepExecutionOptions, StepResult } from "#recipe-engine/types";
+import { Tool, type ToolValidationResult } from "./base.js";
+export declare class ParallelTool extends Tool<ParallelStep> {
+    constructor(name?: string, options?: Record<string, any>);
+    protected onValidate(step: ParallelStep, context: StepContext): Promise<ToolValidationResult>;
+    protected onExecute(step: ParallelStep, context: StepContext, options?: StepExecutionOptions): Promise<StepResult>;
+    private createResult;
+}
+export declare class ParallelToolFactory {
+    create(name?: string, options?: Record<string, any>): ParallelTool;
+    getToolType(): "parallel";
+    validateConfig(config: Record<string, any>): ToolValidationResult;
+}
+export declare const parallelToolFactory: ParallelToolFactory;
+//# sourceMappingURL=parallel-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-tool.d.ts","sourceRoot":"","sources":["../../../src/recipe-engine/tools/parallel-tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAEX,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,UAAU,EACV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAE5D,qBAAa,YAAa,SAAQ,IAAI,CAAC,YAAY,CAAC;gBACvC,IAAI,SAAkB,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;cAIrD,UAAU,CACzB,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,WAAW,GAClB,OAAO,CAAC,oBAAoB,CAAC;cA0BhB,SAAS,CACxB,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,UAAU,CAAC;IAyDtB,OAAO,CAAC,YAAY;CAwCpB;AAED,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;CAQjE;AAED,eAAO,MAAM,mBAAmB,qBAA4B,CAAC"}

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

@@ -0,0 +1,134 @@
+/**
+ * Parallel Tool Implementation for Recipe Step System
+ *
+ * This tool executes a list of recipe steps concurrently.
+ * It leverages the StepExecutor's parallel execution capabilities.
+ */
+import { ErrorCode, ErrorHandler } from "@hypercli/core";
+import { StepExecutor } from "#recipe-engine/step-executor";
+import { Tool } from "./base.js";
+export class ParallelTool extends Tool {
+    constructor(name = "parallel-tool", options = {}) {
+        super("parallel", name, options);
+    }
+    async onValidate(step, context) {
+        const errors = [];
+        if (!step.steps || !Array.isArray(step.steps) || step.steps.length === 0) {
+            errors.push("Parallel steps must be a non-empty array");
+        }
+        if (step.limit && (typeof step.limit !== "number" || step.limit <= 0)) {
+            errors.push("Parallel limit must be a positive number");
+        }
+        return {
+            isValid: errors.length === 0,
+            errors,
+            warnings: [],
+            suggestions: [],
+            estimatedExecutionTime: 0, // Hard to estimate for parallel
+            resourceRequirements: {
+                memory: 0, // Dynamically determined by steps
+                disk: 0,
+                network: false,
+                processes: 0,
+            },
+        };
+    }
+    async onExecute(step, context, options) {
+        const startTime = new Date();
+        this.debug("Executing parallel step: %s with %d steps", step.name, step.steps.length);
+        try {
+            const executor = new StepExecutor(undefined, {
+                collectMetrics: false,
+                enableProgressTracking: false,
+                maxConcurrency: step.limit,
+                enableParallelExecution: true,
+            });
+            // If continueOnError is explicitly set to false (failedFast behavior), passing it to StepExecutor
+            // might need to be verified. StepExecutor's continueOnError typically means "continue execution of valid steps".
+            // For parallel execution, we want "if one fails, abort others" or "wait for all".
+            // The `StepExecutor` likely handles dependencies, but if we pass a flat list without deps, it can run them efficiently.
+            const executionOptions = {
+                ...options,
+                continueOnError: step.continueOnError ?? options?.continueOnError,
+            };
+            const results = await executor.executeSteps(step.steps, context, executionOptions);
+            const failed = results.filter((r) => r.status === "failed");
+            if (failed.length > 0 && !executionOptions.continueOnError) {
+                throw ErrorHandler.createError(ErrorCode.TEMPLATE_EXECUTION_ERROR, `Parallel execution failed: ${failed.map((f) => f.stepName).join(", ")}`, { template: step.name, cause: failed[0].error });
+            }
+            this.debug("Parallel execution completed");
+            return this.createResult(step, results, startTime, "completed");
+        }
+        catch (error) {
+            const endTime = new Date();
+            return {
+                status: "failed",
+                stepName: step.name,
+                toolType: "parallel",
+                startTime,
+                endTime,
+                duration: endTime.getTime() - startTime.getTime(),
+                retryCount: 0,
+                dependenciesSatisfied: true,
+                error: {
+                    message: error.message,
+                    code: error.code || "PARALLEL_EXECUTION_ERROR",
+                    cause: error,
+                },
+            };
+        }
+    }
+    createResult(step, results, startTime, status) {
+        const endTime = new Date();
+        const filesCreated = [];
+        const filesModified = [];
+        const filesDeleted = [];
+        results.forEach((r) => {
+            if (r.filesCreated)
+                filesCreated.push(...r.filesCreated);
+            if (r.filesModified)
+                filesModified.push(...r.filesModified);
+            if (r.filesDeleted)
+                filesDeleted.push(...r.filesDeleted);
+        });
+        return {
+            status,
+            stepName: step.name,
+            toolType: "parallel",
+            startTime,
+            endTime,
+            duration: endTime.getTime() - startTime.getTime(),
+            retryCount: 0,
+            dependenciesSatisfied: true,
+            filesCreated,
+            filesModified,
+            filesDeleted,
+            toolResult: {
+                steps: results,
+            },
+            output: {
+                totalSteps: results.length,
+                completed: results.filter((r) => r.status === "completed").length,
+                failed: results.filter((r) => r.status === "failed").length,
+            },
+        };
+    }
+}
+export class ParallelToolFactory {
+    create(name = "parallel-tool", options = {}) {
+        return new ParallelTool(name, options);
+    }
+    getToolType() {
+        return "parallel";
+    }
+    validateConfig(config) {
+        return {
+            isValid: true,
+            errors: [],
+            warnings: [],
+            suggestions: [],
+        };
+    }
+}
+export const parallelToolFactory = new ParallelToolFactory();
+//# sourceMappingURL=parallel-tool.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * Patch Tool Implementation for Recipe Step System
+ *
+ * Deep-merges structured data into existing files (JSON, YAML, TOML).
+ * Creates the file if it doesn't exist (configurable).
+ */
+import type { PatchStep, StepContext, StepExecutionOptions, StepResult } from "#recipe-engine/types";
+import { Tool, type ToolValidationResult } from "./base.js";
+export declare class PatchTool extends Tool<PatchStep> {
+    constructor(name?: string, options?: Record<string, any>);
+    protected onValidate(step: PatchStep, context: StepContext): Promise<ToolValidationResult>;
+    protected onExecute(step: PatchStep, context: StepContext, options?: StepExecutionOptions): Promise<StepResult>;
+    private resolveVariablesInObject;
+}
+export declare class PatchToolFactory {
+    create(name?: string, options?: Record<string, any>): PatchTool;
+    getToolType(): "patch";
+    validateConfig(config: Record<string, any>): ToolValidationResult;
+}
+export declare const patchToolFactory: PatchToolFactory;
+//# sourceMappingURL=patch-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"patch-tool.d.ts","sourceRoot":"","sources":["../../../src/recipe-engine/tools/patch-tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAEX,SAAS,EACT,WAAW,EACX,oBAAoB,EACpB,UAAU,EACV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAsG5D,qBAAa,SAAU,SAAQ,IAAI,CAAC,SAAS,CAAC;gBACjC,IAAI,SAAe,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;cAIlD,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC;cAqChF,SAAS,CACxB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,UAAU,CAAC;IAmFtB,OAAO,CAAC,wBAAwB;CAoBhC;AAED,qBAAa,gBAAgB;IAC5B,MAAM,CAAC,IAAI,SAAe,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,SAAS;IAIzE,WAAW,IAAI,OAAO;IAItB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,oBAAoB;CAQjE;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}

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

@@ -0,0 +1,248 @@
+/**
+ * Patch Tool Implementation for Recipe Step System
+ *
+ * Deep-merges structured data into existing files (JSON, YAML, TOML).
+ * Creates the file if it doesn't exist (configurable).
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { Tool } from "./base.js";
+/**
+ * Auto-detect file format from extension
+ */
+function detectFormat(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    switch (ext) {
+        case ".json":
+            return "json";
+        case ".yml":
+        case ".yaml":
+            return "yaml";
+        case ".toml":
+            return "toml";
+        default:
+            return undefined;
+    }
+}
+/**
+ * Deep merge source into target, mutating target.
+ * Arrays are replaced, not concatenated.
+ */
+function deepMerge(target, source) {
+    for (const key of Object.keys(source)) {
+        const srcVal = source[key];
+        const tgtVal = target[key];
+        if (srcVal !== null &&
+            typeof srcVal === "object" &&
+            !Array.isArray(srcVal) &&
+            tgtVal !== null &&
+            typeof tgtVal === "object" &&
+            !Array.isArray(tgtVal)) {
+            target[key] = deepMerge(tgtVal, srcVal);
+        }
+        else {
+            target[key] = srcVal;
+        }
+    }
+    return target;
+}
+/**
+ * Parse file content based on format
+ */
+async function parseFile(content, format) {
+    switch (format) {
+        case "json":
+            return JSON.parse(content);
+        case "yaml": {
+            const { parse } = await import("yaml");
+            return parse(content) ?? {};
+        }
+        case "toml": {
+            try {
+                // @ts-ignore -- optional dependency, only needed for TOML files
+                const { parse } = await import("smol-toml");
+                return parse(content);
+            }
+            catch {
+                throw new Error('TOML parsing requires the "smol-toml" package. Install it with: bun add smol-toml');
+            }
+        }
+        default:
+            throw new Error(`Unsupported format: ${format}`);
+    }
+}
+/**
+ * Serialize data to string based on format
+ */
+async function serializeFile(data, format, indent) {
+    switch (format) {
+        case "json":
+            return `${JSON.stringify(data, null, indent)}\n`;
+        case "yaml": {
+            const { stringify } = await import("yaml");
+            return stringify(data, { indent });
+        }
+        case "toml": {
+            try {
+                // @ts-ignore -- optional dependency, only needed for TOML files
+                const { stringify } = await import("smol-toml");
+                return `${stringify(data)}\n`;
+            }
+            catch {
+                throw new Error('TOML serialization requires the "smol-toml" package. Install it with: bun add smol-toml');
+            }
+        }
+        default:
+            throw new Error(`Unsupported format: ${format}`);
+    }
+}
+export class PatchTool extends Tool {
+    constructor(name = "patch-tool", options = {}) {
+        super("patch", name, options);
+    }
+    async onValidate(step, context) {
+        const errors = [];
+        const warnings = [];
+        const suggestions = [];
+        if (!step.file) {
+            errors.push("File path is required");
+        }
+        if (!step.merge || typeof step.merge !== "object" || Array.isArray(step.merge)) {
+            errors.push('"merge" must be a non-null object');
+        }
+        const format = step.format || (step.file ? detectFormat(step.file) : undefined);
+        if (step.file && !format) {
+            errors.push(`Cannot detect format for "${step.file}". Specify "format" explicitly.`);
+        }
+        if (format && !["json", "yaml", "toml"].includes(format)) {
+            errors.push(`Unsupported format: ${format}. Must be one of: json, yaml, toml`);
+        }
+        return {
+            isValid: errors.length === 0,
+            errors,
+            warnings,
+            suggestions,
+            estimatedExecutionTime: 200,
+            resourceRequirements: {
+                memory: 5 * 1024 * 1024,
+                disk: 1024,
+                network: false,
+                processes: 0,
+            },
+        };
+    }
+    async onExecute(step, context, options) {
+        const startTime = new Date();
+        this.debug("Patching file: %s", step.file);
+        try {
+            const filePath = path.resolve(context.projectRoot, step.file);
+            const format = step.format || detectFormat(step.file);
+            const indent = step.indent ?? 2;
+            const createIfMissing = step.createIfMissing ?? true;
+            if (!format) {
+                throw new Error(`Cannot detect format for "${step.file}". Specify "format" explicitly.`);
+            }
+            let existing = {};
+            let created = false;
+            if (fs.existsSync(filePath)) {
+                const content = fs.readFileSync(filePath, "utf-8");
+                existing = await parseFile(content, format);
+            }
+            else if (createIfMissing) {
+                created = true;
+                // Ensure parent directory exists
+                const dir = path.dirname(filePath);
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            else {
+                throw new Error(`File not found: ${step.file} (createIfMissing is false)`);
+            }
+            // Resolve variables in merge data
+            const resolvedMerge = this.resolveVariablesInObject(step.merge, context.variables);
+            // Deep merge
+            const merged = deepMerge(existing, resolvedMerge);
+            // Write back
+            if (!(options?.dryRun || context.dryRun)) {
+                const serialized = await serializeFile(merged, format, indent);
+                fs.writeFileSync(filePath, serialized, "utf-8");
+            }
+            const endTime = new Date();
+            const patchResult = {
+                file: step.file,
+                format,
+                created,
+                merged: resolvedMerge,
+            };
+            return {
+                status: "completed",
+                stepName: step.name,
+                toolType: "patch",
+                startTime,
+                endTime,
+                duration: endTime.getTime() - startTime.getTime(),
+                retryCount: 0,
+                dependenciesSatisfied: true,
+                toolResult: patchResult,
+                filesModified: created ? undefined : [filePath],
+                filesCreated: created ? [filePath] : undefined,
+                output: { file: step.file, created, format },
+            };
+        }
+        catch (error) {
+            const endTime = new Date();
+            return {
+                status: "failed",
+                stepName: step.name,
+                toolType: "patch",
+                startTime,
+                endTime,
+                duration: endTime.getTime() - startTime.getTime(),
+                retryCount: 0,
+                dependenciesSatisfied: true,
+                error: {
+                    message: error.message,
+                    code: "PATCH_FAILED",
+                    cause: error,
+                },
+            };
+        }
+    }
+    resolveVariablesInObject(obj, variables) {
+        if (typeof obj === "string") {
+            return obj.replace(/\{\{\s*([^}]+)\s*\}\}/g, (_, key) => {
+                const trimmed = key.trim();
+                const value = trimmed.split(".").reduce((o, k) => o?.[k], variables);
+                return value !== undefined ? String(value) : `{{${trimmed}}}`;
+            });
+        }
+        if (Array.isArray(obj)) {
+            return obj.map((item) => this.resolveVariablesInObject(item, variables));
+        }
+        if (obj !== null && typeof obj === "object") {
+            const result = {};
+            for (const [key, val] of Object.entries(obj)) {
+                result[key] = this.resolveVariablesInObject(val, variables);
+            }
+            return result;
+        }
+        return obj;
+    }
+}
+export class PatchToolFactory {
+    create(name = "patch-tool", options = {}) {
+        return new PatchTool(name, options);
+    }
+    getToolType() {
+        return "patch";
+    }
+    validateConfig(config) {
+        return {
+            isValid: true,
+            errors: [],
+            warnings: [],
+            suggestions: [],
+        };
+    }
+}
+export const patchToolFactory = new PatchToolFactory();
+//# sourceMappingURL=patch-tool.js.map