@plusplusoneplusplus/coc 1.0.2 → 1.0.3

package/node_modules/@plusplusoneplusplus/forge/dist/utils/prompt-resolver.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Prompt File Resolver
+ *
+ * Resolves and loads prompt files for YAML pipelines.
+ * Supports relative paths, search order for bare filenames, and frontmatter stripping.
+ *
+ * Path Resolution Strategy (same as CSV resolution):
+ * - Relative paths: resolved from pipeline package directory
+ * - Absolute paths: used as-is
+ * - Bare filenames: searched in order (pipeline dir, prompts/ subfolder, shared prompts)
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+import { PipelineCoreError } from '../errors';
+/**
+ * Error thrown for prompt file resolution issues
+ */
+export declare class PromptResolverError extends PipelineCoreError {
+    /** Paths that were searched when resolving the prompt */
+    readonly searchedPaths?: string[];
+    constructor(message: string, searchedPaths?: string[]);
+}
+/**
+ * Result of prompt file resolution
+ */
+export interface PromptResolutionResult {
+    /** The resolved prompt content (frontmatter stripped) */
+    content: string;
+    /** The absolute path where the prompt was found */
+    resolvedPath: string;
+    /** Whether frontmatter was stripped */
+    hadFrontmatter: boolean;
+}
+/**
+ * Get search paths for a bare filename (no path separators)
+ *
+ * Search order:
+ * 1. Pipeline package directory - {pipelineDir}/filename
+ * 2. prompts/ subfolder - {pipelineDir}/prompts/filename
+ * 3. Shared prompts folder - {pipelinesRoot}/prompts/filename
+ *
+ * @param filename Bare filename without path separators
+ * @param pipelineDirectory Pipeline package directory (where pipeline.yaml lives)
+ * @returns Array of paths to search, in order
+ */
+export declare function getSearchPaths(filename: string, pipelineDirectory: string): string[];
+/**
+ * Resolve a prompt file path to an absolute path
+ *
+ * Resolution rules:
+ * - Absolute paths: returned as-is
+ * - Paths with separators (e.g., "prompts/map.prompt.md"): resolved relative to pipelineDirectory
+ * - Bare filenames (e.g., "analyze.prompt.md"): searched using getSearchPaths()
+ *
+ * @param promptFile Path or filename from config
+ * @param pipelineDirectory Pipeline package directory (where pipeline.yaml lives)
+ * @returns Absolute path to the prompt file
+ * @throws PromptResolverError if file not found
+ */
+export declare function resolvePromptPath(promptFile: string, pipelineDirectory: string): string;
+/**
+ * Extract prompt content from file content, stripping frontmatter if present
+ *
+ * Frontmatter format:
+ * ---
+ * version: 1.0
+ * description: Bug analysis prompt
+ * variables: [title, description, priority]
+ * ---
+ *
+ * Actual prompt content starts here...
+ *
+ * @param fileContent Raw file content
+ * @returns Object with content and whether frontmatter was stripped
+ */
+export declare function extractPromptContent(fileContent: string): {
+    content: string;
+    hadFrontmatter: boolean;
+};
+/**
+ * Resolve and load a prompt file
+ *
+ * This is the main API for loading prompts from files.
+ *
+ * @param promptFile Path or filename from config
+ * @param pipelineDirectory Pipeline package directory (where pipeline.yaml lives)
+ * @returns Prompt content string (frontmatter stripped)
+ * @throws PromptResolverError if file not found or empty
+ *
+ * @example
+ * // Simple - prompt in same folder
+ * const prompt = await resolvePromptFile('analyze.prompt.md', '/path/to/pipeline');
+ *
+ * // With prompts subfolder
+ * const prompt = await resolvePromptFile('prompts/map.prompt.md', '/path/to/pipeline');
+ *
+ * // Using shared prompts
+ * const prompt = await resolvePromptFile('../shared/prompts/common.prompt.md', '/path/to/pipeline');
+ */
+export declare function resolvePromptFile(promptFile: string, pipelineDirectory: string): Promise<string>;
+/**
+ * Resolve and load a prompt file synchronously
+ *
+ * @param promptFile Path or filename from config
+ * @param pipelineDirectory Pipeline package directory (where pipeline.yaml lives)
+ * @returns Prompt content string (frontmatter stripped)
+ * @throws PromptResolverError if file not found or empty
+ */
+export declare function resolvePromptFileSync(promptFile: string, pipelineDirectory: string): string;
+/**
+ * Resolve and load a prompt file with full result details
+ *
+ * @param promptFile Path or filename from config
+ * @param pipelineDirectory Pipeline package directory (where pipeline.yaml lives)
+ * @returns Full resolution result with content, path, and frontmatter info
+ * @throws PromptResolverError if file not found or empty
+ */
+export declare function resolvePromptFileWithDetails(promptFile: string, pipelineDirectory: string): Promise<PromptResolutionResult>;
+/**
+ * Check if a prompt file exists (without loading it)
+ *
+ * @param promptFile Path or filename from config
+ * @param pipelineDirectory Pipeline package directory
+ * @returns True if the file exists at any of the search locations
+ */
+export declare function promptFileExists(promptFile: string, pipelineDirectory: string): boolean;
+/**
+ * Validate that a prompt file can be resolved (for config validation)
+ *
+ * @param promptFile Path or filename from config
+ * @param pipelineDirectory Pipeline package directory
+ * @returns Validation result with error message if invalid
+ */
+export declare function validatePromptFile(promptFile: string, pipelineDirectory: string): {
+    valid: boolean;
+    error?: string;
+    searchedPaths?: string[];
+};
+//# sourceMappingURL=prompt-resolver.d.ts.map

package/node_modules/@plusplusoneplusplus/forge/dist/utils/prompt-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/prompt-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAE,iBAAiB,EAAa,MAAM,WAAW,CAAC;AAEzD;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,iBAAiB;IACtD,yDAAyD;IACzD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;gBAG9B,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,EAAE;CAS/B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,cAAc,EAAE,OAAO,CAAC;CAC3B;AAkBD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM,EAAE,CAepF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAqCvF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,CAetG;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,iBAAiB,CACnC,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,GAC1B,OAAO,CAAC,MAAM,CAAC,CAwBjB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACjC,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,GAC1B,MAAM,CAwBR;AAED;;;;;;;GAOG;AACH,wBAAsB,4BAA4B,CAC9C,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,GAC1B,OAAO,CAAC,sBAAsB,CAAC,CA4BjC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAOvF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAC9B,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,GAC1B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAiB9D"}

package/node_modules/@plusplusoneplusplus/forge/dist/utils/prompt-resolver.js

@@ -0,0 +1,314 @@
+"use strict";
+/**
+ * Prompt File Resolver
+ *
+ * Resolves and loads prompt files for YAML pipelines.
+ * Supports relative paths, search order for bare filenames, and frontmatter stripping.
+ *
+ * Path Resolution Strategy (same as CSV resolution):
+ * - Relative paths: resolved from pipeline package directory
+ * - Absolute paths: used as-is
+ * - Bare filenames: searched in order (pipeline dir, prompts/ subfolder, shared prompts)
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptResolverError = void 0;
+exports.getSearchPaths = getSearchPaths;
+exports.resolvePromptPath = resolvePromptPath;
+exports.extractPromptContent = extractPromptContent;
+exports.resolvePromptFile = resolvePromptFile;
+exports.resolvePromptFileSync = resolvePromptFileSync;
+exports.resolvePromptFileWithDetails = resolvePromptFileWithDetails;
+exports.promptFileExists = promptFileExists;
+exports.validatePromptFile = validatePromptFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const errors_1 = require("../errors");
+/**
+ * Error thrown for prompt file resolution issues
+ */
+class PromptResolverError extends errors_1.PipelineCoreError {
+    constructor(message, searchedPaths) {
+        super(message, {
+            code: errors_1.ErrorCode.PROMPT_RESOLUTION_FAILED,
+            meta: searchedPaths ? { searchedPaths } : undefined,
+        });
+        this.name = 'PromptResolverError';
+        this.searchedPaths = searchedPaths;
+    }
+}
+exports.PromptResolverError = PromptResolverError;
+/**
+ * Frontmatter regex pattern
+ * Matches YAML frontmatter at the start of a file:
+ * ---
+ * key: value
+ * ---
+ */
+const FRONTMATTER_REGEX = /^---\r?\n[\s\S]*?\r?\n---\r?\n?/;
+/**
+ * Check if a path contains path separators (indicating it's not a bare filename)
+ */
+function hasPathSeparators(filePath) {
+    return filePath.includes('/') || filePath.includes('\\');
+}
+/**
+ * Get search paths for a bare filename (no path separators)
+ *
+ * Search order:
+ * 1. Pipeline package directory - {pipelineDir}/filename
+ * 2. prompts/ subfolder - {pipelineDir}/prompts/filename
+ * 3. Shared prompts folder - {pipelinesRoot}/prompts/filename
+ *
+ * @param filename Bare filename without path separators
+ * @param pipelineDirectory Pipeline package directory (where pipeline.yaml lives)
+ * @returns Array of paths to search, in order
+ */
+function getSearchPaths(filename, pipelineDirectory) {
+    const paths = [];
+    // 1. Pipeline package directory
+    paths.push(path.join(pipelineDirectory, filename));
+    // 2. prompts/ subfolder within pipeline package
+    paths.push(path.join(pipelineDirectory, 'prompts', filename));
+    // 3. Shared prompts folder (sibling to pipeline package)
+    // pipelinesRoot is the parent of pipelineDirectory
+    const pipelinesRoot = path.dirname(pipelineDirectory);
+    paths.push(path.join(pipelinesRoot, 'prompts', filename));
+    return paths;
+}
+/**
+ * Resolve a prompt file path to an absolute path
+ *
+ * Resolution rules:
+ * - Absolute paths: returned as-is
+ * - Paths with separators (e.g., "prompts/map.prompt.md"): resolved relative to pipelineDirectory
+ * - Bare filenames (e.g., "analyze.prompt.md"): searched using getSearchPaths()
+ *
+ * @param promptFile Path or filename from config
+ * @param pipelineDirectory Pipeline package directory (where pipeline.yaml lives)
+ * @returns Absolute path to the prompt file
+ * @throws PromptResolverError if file not found
+ */
+function resolvePromptPath(promptFile, pipelineDirectory) {
+    // Absolute path - use as-is
+    if (path.isAbsolute(promptFile)) {
+        if (!fs.existsSync(promptFile)) {
+            throw new PromptResolverError(`Prompt file not found: ${promptFile}`, [promptFile]);
+        }
+        return promptFile;
+    }
+    // Path with separators - resolve relative to pipeline directory
+    if (hasPathSeparators(promptFile)) {
+        const resolvedPath = path.resolve(pipelineDirectory, promptFile);
+        if (!fs.existsSync(resolvedPath)) {
+            throw new PromptResolverError(`Prompt file not found: ${promptFile}`, [resolvedPath]);
+        }
+        return resolvedPath;
+    }
+    // Bare filename - search in order
+    const searchPaths = getSearchPaths(promptFile, pipelineDirectory);
+    for (const searchPath of searchPaths) {
+        if (fs.existsSync(searchPath)) {
+            return searchPath;
+        }
+    }
+    // Not found anywhere
+    throw new PromptResolverError(`Prompt file "${promptFile}" not found. Searched paths:\n  - ${searchPaths.join('\n  - ')}`, searchPaths);
+}
+/**
+ * Extract prompt content from file content, stripping frontmatter if present
+ *
+ * Frontmatter format:
+ * ---
+ * version: 1.0
+ * description: Bug analysis prompt
+ * variables: [title, description, priority]
+ * ---
+ *
+ * Actual prompt content starts here...
+ *
+ * @param fileContent Raw file content
+ * @returns Object with content and whether frontmatter was stripped
+ */
+function extractPromptContent(fileContent) {
+    const match = fileContent.match(FRONTMATTER_REGEX);
+    if (match) {
+        const content = fileContent.slice(match[0].length).trim();
+        return {
+            content,
+            hadFrontmatter: true
+        };
+    }
+    return {
+        content: fileContent.trim(),
+        hadFrontmatter: false
+    };
+}
+/**
+ * Resolve and load a prompt file
+ *
+ * This is the main API for loading prompts from files.
+ *
+ * @param promptFile Path or filename from config
+ * @param pipelineDirectory Pipeline package directory (where pipeline.yaml lives)
+ * @returns Prompt content string (frontmatter stripped)
+ * @throws PromptResolverError if file not found or empty
+ *
+ * @example
+ * // Simple - prompt in same folder
+ * const prompt = await resolvePromptFile('analyze.prompt.md', '/path/to/pipeline');
+ *
+ * // With prompts subfolder
+ * const prompt = await resolvePromptFile('prompts/map.prompt.md', '/path/to/pipeline');
+ *
+ * // Using shared prompts
+ * const prompt = await resolvePromptFile('../shared/prompts/common.prompt.md', '/path/to/pipeline');
+ */
+async function resolvePromptFile(promptFile, pipelineDirectory) {
+    const resolvedPath = resolvePromptPath(promptFile, pipelineDirectory);
+    try {
+        const fileContent = await fs.promises.readFile(resolvedPath, 'utf-8');
+        const { content } = extractPromptContent(fileContent);
+        if (!content) {
+            throw new PromptResolverError(`Prompt file is empty after stripping frontmatter: ${promptFile}`, [resolvedPath]);
+        }
+        return content;
+    }
+    catch (error) {
+        if (error instanceof PromptResolverError) {
+            throw error;
+        }
+        throw new PromptResolverError(`Failed to read prompt file "${promptFile}": ${error instanceof Error ? error.message : String(error)}`, [resolvedPath]);
+    }
+}
+/**
+ * Resolve and load a prompt file synchronously
+ *
+ * @param promptFile Path or filename from config
+ * @param pipelineDirectory Pipeline package directory (where pipeline.yaml lives)
+ * @returns Prompt content string (frontmatter stripped)
+ * @throws PromptResolverError if file not found or empty
+ */
+function resolvePromptFileSync(promptFile, pipelineDirectory) {
+    const resolvedPath = resolvePromptPath(promptFile, pipelineDirectory);
+    try {
+        const fileContent = fs.readFileSync(resolvedPath, 'utf-8');
+        const { content } = extractPromptContent(fileContent);
+        if (!content) {
+            throw new PromptResolverError(`Prompt file is empty after stripping frontmatter: ${promptFile}`, [resolvedPath]);
+        }
+        return content;
+    }
+    catch (error) {
+        if (error instanceof PromptResolverError) {
+            throw error;
+        }
+        throw new PromptResolverError(`Failed to read prompt file "${promptFile}": ${error instanceof Error ? error.message : String(error)}`, [resolvedPath]);
+    }
+}
+/**
+ * Resolve and load a prompt file with full result details
+ *
+ * @param promptFile Path or filename from config
+ * @param pipelineDirectory Pipeline package directory (where pipeline.yaml lives)
+ * @returns Full resolution result with content, path, and frontmatter info
+ * @throws PromptResolverError if file not found or empty
+ */
+async function resolvePromptFileWithDetails(promptFile, pipelineDirectory) {
+    const resolvedPath = resolvePromptPath(promptFile, pipelineDirectory);
+    try {
+        const fileContent = await fs.promises.readFile(resolvedPath, 'utf-8');
+        const { content, hadFrontmatter } = extractPromptContent(fileContent);
+        if (!content) {
+            throw new PromptResolverError(`Prompt file is empty after stripping frontmatter: ${promptFile}`, [resolvedPath]);
+        }
+        return {
+            content,
+            resolvedPath,
+            hadFrontmatter
+        };
+    }
+    catch (error) {
+        if (error instanceof PromptResolverError) {
+            throw error;
+        }
+        throw new PromptResolverError(`Failed to read prompt file "${promptFile}": ${error instanceof Error ? error.message : String(error)}`, [resolvedPath]);
+    }
+}
+/**
+ * Check if a prompt file exists (without loading it)
+ *
+ * @param promptFile Path or filename from config
+ * @param pipelineDirectory Pipeline package directory
+ * @returns True if the file exists at any of the search locations
+ */
+function promptFileExists(promptFile, pipelineDirectory) {
+    try {
+        resolvePromptPath(promptFile, pipelineDirectory);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Validate that a prompt file can be resolved (for config validation)
+ *
+ * @param promptFile Path or filename from config
+ * @param pipelineDirectory Pipeline package directory
+ * @returns Validation result with error message if invalid
+ */
+function validatePromptFile(promptFile, pipelineDirectory) {
+    try {
+        resolvePromptPath(promptFile, pipelineDirectory);
+        return { valid: true };
+    }
+    catch (error) {
+        if (error instanceof PromptResolverError) {
+            return {
+                valid: false,
+                error: error.message,
+                searchedPaths: error.searchedPaths
+            };
+        }
+        return {
+            valid: false,
+            error: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
+//# sourceMappingURL=prompt-resolver.js.map

package/node_modules/@plusplusoneplusplus/forge/dist/utils/prompt-resolver.js.map

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

package/node_modules/@plusplusoneplusplus/forge/dist/utils/retry-utils.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Retry utilities for pipeline execution.
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+export interface RetryPolicy {
+    maxAttempts: number;
+    shouldRetry?: (error: unknown) => boolean;
+}
+/**
+ * Execute a function with retry logic based on the provided policy.
+ *
+ * @param fn - Function to execute; receives the attempt index (0-based).
+ * @param policy - Retry policy (maxAttempts, optional shouldRetry predicate).
+ * @returns Resolves with the function's result on success.
+ * @throws The last error thrown by `fn` when all attempts are exhausted.
+ */
+export declare function withRetry<T>(fn: (attempt: number) => Promise<T>, policy: RetryPolicy): Promise<T>;
+//# sourceMappingURL=retry-utils.d.ts.map

package/node_modules/@plusplusoneplusplus/forge/dist/utils/retry-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-utils.d.ts","sourceRoot":"","sources":["../../src/utils/retry-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,WAAW;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CAC7C;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC7B,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EACnC,MAAM,EAAE,WAAW,GACpB,OAAO,CAAC,CAAC,CAAC,CAmBZ"}

package/node_modules/@plusplusoneplusplus/forge/dist/utils/retry-utils.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * Retry utilities for pipeline execution.
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withRetry = withRetry;
+/**
+ * Execute a function with retry logic based on the provided policy.
+ *
+ * @param fn - Function to execute; receives the attempt index (0-based).
+ * @param policy - Retry policy (maxAttempts, optional shouldRetry predicate).
+ * @returns Resolves with the function's result on success.
+ * @throws The last error thrown by `fn` when all attempts are exhausted.
+ */
+async function withRetry(fn, policy) {
+    const { maxAttempts, shouldRetry } = policy;
+    let lastError;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        try {
+            return await fn(attempt);
+        }
+        catch (error) {
+            lastError = error;
+            const hasMoreAttempts = attempt < maxAttempts - 1;
+            const canRetry = hasMoreAttempts && (shouldRetry === undefined || shouldRetry(error));
+            if (!canRetry) {
+                throw error;
+            }
+        }
+    }
+    // Unreachable in practice; ensures TypeScript sees a definite return/throw.
+    throw lastError;
+}
+//# sourceMappingURL=retry-utils.js.map

package/node_modules/@plusplusoneplusplus/forge/dist/utils/retry-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-utils.js","sourceRoot":"","sources":["../../src/utils/retry-utils.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAeH,8BAsBC;AA9BD;;;;;;;GAOG;AACI,KAAK,UAAU,SAAS,CAC3B,EAAmC,EACnC,MAAmB;IAEnB,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAC5C,IAAI,SAAkB,CAAC;IAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACrD,IAAI,CAAC;YACD,OAAO,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,SAAS,GAAG,KAAK,CAAC;YAClB,MAAM,eAAe,GAAG,OAAO,GAAG,WAAW,GAAG,CAAC,CAAC;YAClD,MAAM,QAAQ,GAAG,eAAe,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;YACtF,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACZ,MAAM,KAAK,CAAC;YAChB,CAAC;QACL,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,MAAM,SAAS,CAAC;AACpB,CAAC"}

package/node_modules/@plusplusoneplusplus/forge/dist/utils/template-engine.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Template Engine
+ *
+ * Shared template variable substitution logic for prompts across the codebase.
+ * Provides a centralized implementation of {{variable}} placeholder replacement.
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+import { PipelineCoreError } from '../errors';
+/**
+ * Regular expression to match {{variable}} placeholders.
+ * Shared across all template substitution implementations.
+ */
+export declare const TEMPLATE_VARIABLE_REGEX: RegExp;
+/**
+ * Special template variables that are automatically provided by the system
+ * and should not be validated against item fields.
+ *
+ * - ITEMS: JSON array of all input items (available in map phase)
+ * - RESULTS: JSON array of map results (available in reduce phase)
+ * - RESULTS_FILE: Path to temp file with results (available in reduce phase)
+ * - COUNT: Total count of items/results
+ * - SUCCESS_COUNT: Count of successful items
+ * - FAILURE_COUNT: Count of failed items
+ */
+export declare const SPECIAL_VARIABLES: Set<string>;
+/**
+ * Options for template variable substitution
+ */
+export interface SubstituteVariablesOptions {
+    /**
+     * If true, throws on missing variables; if false, behavior depends on missingValueBehavior.
+     * @default false
+     */
+    strict?: boolean;
+    /**
+     * Behavior when a variable is missing and strict mode is false.
+     * - 'empty': Replace with empty string (default, backward compatible)
+     * - 'preserve': Leave the {{variable}} placeholder as-is
+     */
+    missingValueBehavior?: 'empty' | 'preserve';
+    /**
+     * If true, special system variables (ITEMS, RESULTS, etc.) are always preserved
+     * even in strict mode.
+     * @default true
+     */
+    preserveSpecialVariables?: boolean;
+}
+/**
+ * Error thrown when a template variable is missing in strict mode
+ */
+export declare class TemplateVariableError extends PipelineCoreError {
+    /** Name of the missing variable */
+    readonly variableName?: string;
+    constructor(message: string, variableName?: string);
+}
+/**
+ * Substitute template variables in a string with values from a variables object.
+ *
+ * @param template Template string with {{variable}} placeholders
+ * @param variables Object containing variable values (key-value pairs)
+ * @param options Substitution options
+ * @returns String with variables substituted
+ * @throws TemplateVariableError if strict mode is enabled and a variable is missing
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * substituteVariables('Hello {{name}}!', { name: 'World' });
+ * // Returns: 'Hello World!'
+ *
+ * // Strict mode
+ * substituteVariables('Hello {{name}}!', {}, { strict: true });
+ * // Throws: TemplateVariableError
+ *
+ * // Preserve missing variables
+ * substituteVariables('Hello {{name}}!', {}, { missingValueBehavior: 'preserve' });
+ * // Returns: 'Hello {{name}}!'
+ * ```
+ */
+export declare function substituteVariables(template: string, variables: Record<string, unknown>, options?: SubstituteVariablesOptions): string;
+/**
+ * Extract all variable names from a template string.
+ *
+ * @param template Template string to analyze
+ * @param excludeSpecial If true, excludes special system variables (ITEMS, RESULTS, etc.)
+ * @returns Array of unique variable names found in the template
+ *
+ * @example
+ * ```typescript
+ * extractVariables('Hello {{name}}, you have {{count}} messages');
+ * // Returns: ['name', 'count']
+ *
+ * extractVariables('Items: {{ITEMS}}, Name: {{name}}', true);
+ * // Returns: ['name'] (ITEMS is excluded)
+ *
+ * extractVariables('Items: {{ITEMS}}, Name: {{name}}', false);
+ * // Returns: ['ITEMS', 'name']
+ * ```
+ */
+export declare function extractVariables(template: string, excludeSpecial?: boolean): string[];
+/**
+ * Check if a template contains any variables.
+ *
+ * @param template Template string to check
+ * @returns True if the template contains at least one {{variable}} placeholder
+ */
+export declare function hasVariables(template: string): boolean;
+/**
+ * Check if a template contains any of the specified variables.
+ *
+ * @param template Template string to check
+ * @param variableNames Variable names to look for
+ * @returns True if the template contains any of the specified variables
+ */
+export declare function containsVariables(template: string, variableNames: string[]): boolean;
+/**
+ * Validate that all required variables are present in a variables object.
+ *
+ * @param template Template string
+ * @param variables Variables object to validate
+ * @returns Object with validation result and missing variables
+ */
+export declare function validateVariables(template: string, variables: Record<string, unknown>): {
+    valid: boolean;
+    missingVariables: string[];
+};
+//# sourceMappingURL=template-engine.d.ts.map

package/node_modules/@plusplusoneplusplus/forge/dist/utils/template-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.d.ts","sourceRoot":"","sources":["../../src/utils/template-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAa,MAAM,WAAW,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,QAAmB,CAAC;AAExD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,aAO5B,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAE5C;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACtC;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,iBAAiB;IACxD,mCAAmC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAG3B,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM;CAS5B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,CAC/B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,OAAO,GAAE,0BAA+B,GACzC,MAAM,CA4CR;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,GAAE,OAAc,GAAG,MAAM,EAAE,CAc3F;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAGpF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC7B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAAE,CAQhD"}