task-o-matic 0.0.12 → 0.0.14

package/dist/utils/display-helpers.js

@@ -0,0 +1,109 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.displayOperationStart = displayOperationStart;
+exports.displayOperationSuccess = displayOperationSuccess;
+exports.displayOperationError = displayOperationError;
+exports.displayBulkProgress = displayBulkProgress;
+exports.displaySeparator = displaySeparator;
+exports.displaySectionHeader = displaySectionHeader;
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Display the start of an operation
+ *
+ * @param operation - Name of the operation (e.g., "Enhancing", "Splitting")
+ * @param target - Target of the operation (e.g., task title, file name)
+ *
+ * @example
+ * ```typescript
+ * displayOperationStart("Enhancing", "task-123");
+ * // Output: 🚀 Enhancing task-123...
+ * ```
+ */
+function displayOperationStart(operation, target) {
+    console.log(chalk_1.default.blue(`\n🚀 ${operation} ${target}...`));
+}
+/**
+ * Display successful completion of an operation
+ *
+ * @param operation - Name of the operation
+ * @param details - Optional details to append
+ *
+ * @example
+ * ```typescript
+ * displayOperationSuccess("Enhancement", "with Context7");
+ * // Output: ✅ Enhancement completed successfully: with Context7
+ * ```
+ */
+function displayOperationSuccess(operation, details) {
+    const message = details
+        ? `✅ ${operation} completed successfully: ${details}`
+        : `✅ ${operation} completed successfully`;
+    console.log(chalk_1.default.green(message));
+}
+/**
+ * Display an operation error
+ *
+ * @param operation - Name of the operation
+ * @param error - The error that occurred
+ *
+ * @example
+ * ```typescript
+ * displayOperationError("Enhancement", new Error("API failed"));
+ * // Output: ❌ Enhancement failed: API failed
+ * ```
+ */
+function displayOperationError(operation, error) {
+    console.log(chalk_1.default.red(`❌ ${operation} failed: ${error.message}`));
+}
+/**
+ * Display progress in a bulk operation
+ *
+ * @param current - Current item number (1-indexed)
+ * @param total - Total number of items
+ * @param operation - Operation being performed
+ *
+ * @example
+ * ```typescript
+ * displayBulkProgress(3, 10, "Enhancing task ABC");
+ * // Output: [3/10] Enhancing task ABC...
+ * ```
+ */
+function displayBulkProgress(current, total, operation) {
+    console.log(chalk_1.default.cyan(`\n[${current}/${total}] ${operation}...`));
+}
+/**
+ * Display a separator line
+ *
+ * @param length - Length of the separator (default: 60)
+ *
+ * @example
+ * ```typescript
+ * displaySeparator();
+ * // Output: ============================================================
+ * ```
+ */
+function displaySeparator(length = 60) {
+    console.log(chalk_1.default.blue("=".repeat(length)));
+}
+/**
+ * Display a section header
+ *
+ * @param title - Section title
+ *
+ * @example
+ * ```typescript
+ * displaySectionHeader("Execution Summary");
+ * // Output:
+ * // ============================================================
+ * // 📊 Execution Summary
+ * // ============================================================
+ * ```
+ */
+function displaySectionHeader(title) {
+    displaySeparator();
+    console.log(chalk_1.default.blue.bold(`📊 ${title}`));
+    displaySeparator();
+}

package/dist/utils/error-utils.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Extracts a readable error message from an unknown error value.
+ * Handles Error objects, strings, objects with message property, and unknown types.
+ *
+ * @param error - The error value to extract message from
+ * @returns A string error message
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   throw new Error("Something went wrong");
+ * } catch (error) {
+ *   console.log(getErrorMessage(error)); // "Something went wrong"
+ * }
+ * ```
+ */
+export declare function getErrorMessage(error: unknown): string;
+/**
+ * Formats an error with optional context information.
+ * Useful for adding context to error messages when rethrowing.
+ *
+ * @param error - The error value
+ * @param context - Optional context string to prepend to the error message
+ * @returns Formatted error message
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await fetchData();
+ * } catch (error) {
+ *   throw new Error(formatError(error, "Failed to fetch data"));
+ *   // Result: "Failed to fetch data: Connection timeout"
+ * }
+ * ```
+ */
+export declare function formatError(error: unknown, context?: string): string;
+/**
+ * Creates an error with a formatted message including context.
+ *
+ * @param error - The original error
+ * @param context - Context to add to the error
+ * @returns A new Error instance with formatted message
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await operation();
+ * } catch (error) {
+ *   throw createContextError(error, "Operation failed");
+ * }
+ * ```
+ */
+export declare function createContextError(error: unknown, context: string): Error;
+/**
+ * Type guard to check if an error is an Error instance.
+ *
+ * @param error - Value to check
+ * @returns true if error is an Error instance
+ */
+export declare function isError(error: unknown): error is Error;
+/**
+ * Safely converts any value to an Error instance.
+ * If the value is already an Error, returns it unchanged.
+ * Otherwise, creates a new Error with the string representation.
+ *
+ * @param error - Value to convert
+ * @returns An Error instance
+ */
+export declare function toError(error: unknown): Error;
+//# sourceMappingURL=error-utils.d.ts.map

package/dist/utils/error-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-utils.d.ts","sourceRoot":"","sources":["../../src/utils/error-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAkBtD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAK7C"}

package/dist/utils/error-utils.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getErrorMessage = getErrorMessage;
+exports.formatError = formatError;
+exports.createContextError = createContextError;
+exports.isError = isError;
+exports.toError = toError;
+/**
+ * Extracts a readable error message from an unknown error value.
+ * Handles Error objects, strings, objects with message property, and unknown types.
+ *
+ * @param error - The error value to extract message from
+ * @returns A string error message
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   throw new Error("Something went wrong");
+ * } catch (error) {
+ *   console.log(getErrorMessage(error)); // "Something went wrong"
+ * }
+ * ```
+ */
+function getErrorMessage(error) {
+    // Error instance
+    if (error instanceof Error) {
+        return error.message;
+    }
+    // String error
+    if (typeof error === "string") {
+        return error;
+    }
+    // Object with message property
+    if (error && typeof error === "object" && "message" in error) {
+        return String(error.message);
+    }
+    // Unknown type - convert to string
+    return "Unknown error occurred";
+}
+/**
+ * Formats an error with optional context information.
+ * Useful for adding context to error messages when rethrowing.
+ *
+ * @param error - The error value
+ * @param context - Optional context string to prepend to the error message
+ * @returns Formatted error message
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await fetchData();
+ * } catch (error) {
+ *   throw new Error(formatError(error, "Failed to fetch data"));
+ *   // Result: "Failed to fetch data: Connection timeout"
+ * }
+ * ```
+ */
+function formatError(error, context) {
+    const message = getErrorMessage(error);
+    return context ? `${context}: ${message}` : message;
+}
+/**
+ * Creates an error with a formatted message including context.
+ *
+ * @param error - The original error
+ * @param context - Context to add to the error
+ * @returns A new Error instance with formatted message
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await operation();
+ * } catch (error) {
+ *   throw createContextError(error, "Operation failed");
+ * }
+ * ```
+ */
+function createContextError(error, context) {
+    return new Error(formatError(error, context));
+}
+/**
+ * Type guard to check if an error is an Error instance.
+ *
+ * @param error - Value to check
+ * @returns true if error is an Error instance
+ */
+function isError(error) {
+    return error instanceof Error;
+}
+/**
+ * Safely converts any value to an Error instance.
+ * If the value is already an Error, returns it unchanged.
+ * Otherwise, creates a new Error with the string representation.
+ *
+ * @param error - Value to convert
+ * @returns An Error instance
+ */
+function toError(error) {
+    if (error instanceof Error) {
+        return error;
+    }
+    return new Error(getErrorMessage(error));
+}

package/dist/utils/file-utils.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Validates that a file exists at the given path (synchronous).
+ * Throws an error with a custom message if the file doesn't exist.
+ *
+ * @param filePath - Path to the file to validate
+ * @param customMessage - Optional custom error message
+ * @throws Error if file doesn't exist
+ *
+ * @example
+ * ```typescript
+ * validateFileExists("./config.json", "Configuration file not found");
+ * // Throws: Error("Configuration file not found") if file doesn't exist
+ * ```
+ */
+export declare function validateFileExists(filePath: string, customMessage?: string): void;
+/**
+ * Validates that a file exists at the given path (asynchronous).
+ * Throws an error with a custom message if the file doesn't exist.
+ *
+ * @param filePath - Path to the file to validate
+ * @param customMessage - Optional custom error message
+ * @throws Error if file doesn't exist
+ *
+ * @example
+ * ```typescript
+ * await validateFileExistsAsync("./data.json");
+ * // Throws: Error("File not found: ./data.json") if file doesn't exist
+ * ```
+ */
+export declare function validateFileExistsAsync(filePath: string, customMessage?: string): Promise<void>;
+/**
+ * Checks if a file exists at the given path (synchronous).
+ * Returns true if file exists, false otherwise.
+ * Unlike validateFileExists, this doesn't throw an error.
+ *
+ * @param filePath - Path to check
+ * @returns true if file exists, false otherwise
+ */
+export declare function fileExists(filePath: string): boolean;
+/**
+ * Checks if a file exists at the given path (asynchronous).
+ * Returns true if file exists, false otherwise.
+ * Unlike validateFileExistsAsync, this doesn't throw an error.
+ *
+ * @param filePath - Path to check
+ * @returns Promise resolving to true if file exists, false otherwise
+ */
+export declare function fileExistsAsync(filePath: string): Promise<boolean>;
+//# sourceMappingURL=file-utils.d.ts.map

package/dist/utils/file-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils.d.ts","sourceRoot":"","sources":["../../src/utils/file-utils.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI,CAIN;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOxE"}

package/dist/utils/file-utils.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateFileExists = validateFileExists;
+exports.validateFileExistsAsync = validateFileExistsAsync;
+exports.fileExists = fileExists;
+exports.fileExistsAsync = fileExistsAsync;
+const fs_1 = require("fs");
+const promises_1 = require("fs/promises");
+/**
+ * Validates that a file exists at the given path (synchronous).
+ * Throws an error with a custom message if the file doesn't exist.
+ *
+ * @param filePath - Path to the file to validate
+ * @param customMessage - Optional custom error message
+ * @throws Error if file doesn't exist
+ *
+ * @example
+ * ```typescript
+ * validateFileExists("./config.json", "Configuration file not found");
+ * // Throws: Error("Configuration file not found") if file doesn't exist
+ * ```
+ */
+function validateFileExists(filePath, customMessage) {
+    if (!(0, fs_1.existsSync)(filePath)) {
+        throw new Error(customMessage || `File not found: ${filePath}`);
+    }
+}
+/**
+ * Validates that a file exists at the given path (asynchronous).
+ * Throws an error with a custom message if the file doesn't exist.
+ *
+ * @param filePath - Path to the file to validate
+ * @param customMessage - Optional custom error message
+ * @throws Error if file doesn't exist
+ *
+ * @example
+ * ```typescript
+ * await validateFileExistsAsync("./data.json");
+ * // Throws: Error("File not found: ./data.json") if file doesn't exist
+ * ```
+ */
+async function validateFileExistsAsync(filePath, customMessage) {
+    try {
+        await (0, promises_1.access)(filePath, promises_1.constants.F_OK);
+    }
+    catch {
+        throw new Error(customMessage || `File not found: ${filePath}`);
+    }
+}
+/**
+ * Checks if a file exists at the given path (synchronous).
+ * Returns true if file exists, false otherwise.
+ * Unlike validateFileExists, this doesn't throw an error.
+ *
+ * @param filePath - Path to check
+ * @returns true if file exists, false otherwise
+ */
+function fileExists(filePath) {
+    return (0, fs_1.existsSync)(filePath);
+}
+/**
+ * Checks if a file exists at the given path (asynchronous).
+ * Returns true if file exists, false otherwise.
+ * Unlike validateFileExistsAsync, this doesn't throw an error.
+ *
+ * @param filePath - Path to check
+ * @returns Promise resolving to true if file exists, false otherwise
+ */
+async function fileExistsAsync(filePath) {
+    try {
+        await (0, promises_1.access)(filePath, promises_1.constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/utils/id-generator.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Generates unique task IDs with consistent format.
+ * Uses timestamp + random hex for uniqueness.
+ */
+export declare class TaskIDGenerator {
+    /**
+     * Generates a unique task ID with format: prefix-timestamp-random
+     *
+     * @param prefix - Prefix for the ID (default: "task")
+     * @returns Unique task ID
+     *
+     * @example
+     * ```typescript
+     * const id = TaskIDGenerator.generate();
+     * // Returns: "task-1733750400000-a1b2c3d4"
+     *
+     * const customId = TaskIDGenerator.generate("subtask");
+     * // Returns: "subtask-1733750400000-e5f6g7h8"
+     * ```
+     */
+    static generate(prefix?: string): string;
+    /**
+     * Validates a task ID format.
+     * Accepts three formats:
+     * - Timestamped: "task-1234567890-abcd1234"
+     * - Hierarchical: "1.2.3"
+     * - Numeric: "123"
+     *
+     * @param id - Task ID to validate
+     * @returns true if ID format is valid
+     *
+     * @example
+     * ```typescript
+     * TaskIDGenerator.validate("task-1234-abcd"); // true
+     * TaskIDGenerator.validate("1.2.3"); // true
+     * TaskIDGenerator.validate("123"); // true
+     * TaskIDGenerator.validate("invalid!"); // false
+     * ```
+     */
+    static validate(id: string): boolean;
+    /**
+     * Checks if an ID is unique within a set of existing IDs.
+     *
+     * @param id - ID to check
+     * @param existingIds - Set of existing IDs
+     * @returns true if ID is unique
+     */
+    static isUnique(id: string, existingIds: Set<string>): boolean;
+    /**
+     * Generates a unique ID that doesn't exist in the provided set.
+     * Retries up to maxAttempts times if collisions occur.
+     *
+     * @param existingIds - Set of existing IDs to avoid
+     * @param prefix - Prefix for the ID
+     * @param maxAttempts - Maximum number of generation attempts
+     * @returns Unique task ID
+     * @throws Error if unable to generate unique ID after maxAttempts
+     */
+    static generateUnique(existingIds: Set<string>, prefix?: string, maxAttempts?: number): string;
+    /**
+     * Generates a hierarchical child ID from a parent ID.
+     * If parent is "1.2", generates "1.2.1", "1.2.2", etc.
+     *
+     * @param parentId - Parent task ID
+     * @param childIndex - Index of the child (1-based)
+     * @returns Child task ID
+     *
+     * @example
+     * ```typescript
+     * TaskIDGenerator.generateChildId("1", 1); // "1.1"
+     * TaskIDGenerator.generateChildId("1.2", 3); // "1.2.3"
+     * ```
+     */
+    static generateChildId(parentId: string, childIndex: number): string;
+    /**
+     * Parses a hierarchical ID to extract parent ID and child index.
+     *
+     * @param id - Hierarchical task ID
+     * @returns Object with parentId and childIndex, or null if not hierarchical
+     *
+     * @example
+     * ```typescript
+     * TaskIDGenerator.parseHierarchicalId("1.2.3");
+     * // Returns: { parentId: "1.2", childIndex: 3 }
+     * ```
+     */
+    static parseHierarchicalId(id: string): {
+        parentId: string;
+        childIndex: number;
+    } | null;
+}
+//# sourceMappingURL=id-generator.d.ts.map

package/dist/utils/id-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.d.ts","sourceRoot":"","sources":["../../src/utils/id-generator.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,eAAe;IAC1B;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAE,MAAe,GAAG,MAAM;IAMhD;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IA0BpC;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO;IAI9D;;;;;;;;;OASG;IACH,MAAM,CAAC,cAAc,CACnB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EACxB,MAAM,GAAE,MAAe,EACvB,WAAW,GAAE,MAAW,GACvB,MAAM;IAaT;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAIpE;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,mBAAmB,CACxB,EAAE,EAAE,MAAM,GACT;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAcnD"}

package/dist/utils/id-generator.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskIDGenerator = void 0;
+const crypto_1 = require("crypto");
+/**
+ * Generates unique task IDs with consistent format.
+ * Uses timestamp + random hex for uniqueness.
+ */
+class TaskIDGenerator {
+    /**
+     * Generates a unique task ID with format: prefix-timestamp-random
+     *
+     * @param prefix - Prefix for the ID (default: "task")
+     * @returns Unique task ID
+     *
+     * @example
+     * ```typescript
+     * const id = TaskIDGenerator.generate();
+     * // Returns: "task-1733750400000-a1b2c3d4"
+     *
+     * const customId = TaskIDGenerator.generate("subtask");
+     * // Returns: "subtask-1733750400000-e5f6g7h8"
+     * ```
+     */
+    static generate(prefix = "task") {
+        const timestamp = Date.now();
+        const random = (0, crypto_1.randomBytes)(4).toString("hex");
+        return `${prefix}-${timestamp}-${random}`;
+    }
+    /**
+     * Validates a task ID format.
+     * Accepts three formats:
+     * - Timestamped: "task-1234567890-abcd1234"
+     * - Hierarchical: "1.2.3"
+     * - Numeric: "123"
+     *
+     * @param id - Task ID to validate
+     * @returns true if ID format is valid
+     *
+     * @example
+     * ```typescript
+     * TaskIDGenerator.validate("task-1234-abcd"); // true
+     * TaskIDGenerator.validate("1.2.3"); // true
+     * TaskIDGenerator.validate("123"); // true
+     * TaskIDGenerator.validate("invalid!"); // false
+     * ```
+     */
+    static validate(id) {
+        if (!id || typeof id !== "string") {
+            return false;
+        }
+        // Format 1: Timestamped (task-timestamp-random)
+        const timestampedPattern = /^[a-z]+-\d+-[a-f0-9]{8}$/;
+        if (timestampedPattern.test(id)) {
+            return true;
+        }
+        // Format 2: Hierarchical (1.2.3)
+        const hierarchicalPattern = /^[\d.]+$/;
+        if (hierarchicalPattern.test(id)) {
+            return true;
+        }
+        // Format 3: Numeric (123)
+        const numericPattern = /^\d+$/;
+        if (numericPattern.test(id)) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Checks if an ID is unique within a set of existing IDs.
+     *
+     * @param id - ID to check
+     * @param existingIds - Set of existing IDs
+     * @returns true if ID is unique
+     */
+    static isUnique(id, existingIds) {
+        return !existingIds.has(id);
+    }
+    /**
+     * Generates a unique ID that doesn't exist in the provided set.
+     * Retries up to maxAttempts times if collisions occur.
+     *
+     * @param existingIds - Set of existing IDs to avoid
+     * @param prefix - Prefix for the ID
+     * @param maxAttempts - Maximum number of generation attempts
+     * @returns Unique task ID
+     * @throws Error if unable to generate unique ID after maxAttempts
+     */
+    static generateUnique(existingIds, prefix = "task", maxAttempts = 10) {
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            const id = this.generate(prefix);
+            if (this.isUnique(id, existingIds)) {
+                return id;
+            }
+        }
+        throw new Error(`Failed to generate unique ID after ${maxAttempts} attempts`);
+    }
+    /**
+     * Generates a hierarchical child ID from a parent ID.
+     * If parent is "1.2", generates "1.2.1", "1.2.2", etc.
+     *
+     * @param parentId - Parent task ID
+     * @param childIndex - Index of the child (1-based)
+     * @returns Child task ID
+     *
+     * @example
+     * ```typescript
+     * TaskIDGenerator.generateChildId("1", 1); // "1.1"
+     * TaskIDGenerator.generateChildId("1.2", 3); // "1.2.3"
+     * ```
+     */
+    static generateChildId(parentId, childIndex) {
+        return `${parentId}.${childIndex}`;
+    }
+    /**
+     * Parses a hierarchical ID to extract parent ID and child index.
+     *
+     * @param id - Hierarchical task ID
+     * @returns Object with parentId and childIndex, or null if not hierarchical
+     *
+     * @example
+     * ```typescript
+     * TaskIDGenerator.parseHierarchicalId("1.2.3");
+     * // Returns: { parentId: "1.2", childIndex: 3 }
+     * ```
+     */
+    static parseHierarchicalId(id) {
+        const parts = id.split(".");
+        if (parts.length < 2) {
+            return null;
+        }
+        const childIndex = parseInt(parts[parts.length - 1], 10);
+        if (isNaN(childIndex)) {
+            return null;
+        }
+        const parentId = parts.slice(0, -1).join(".");
+        return { parentId, childIndex };
+    }
+}
+exports.TaskIDGenerator = TaskIDGenerator;

package/dist/utils/model-executor-parser.d.ts

@@ -0,0 +1,38 @@
+import { ExecutorTool, ModelAttemptConfig } from "../types";
+/**
+ * Valid executor tools
+ */
+export declare const VALID_EXECUTORS: ExecutorTool[];
+/**
+ * Parse --try-models option into ModelAttemptConfig array
+ * Supports formats:
+ * - "model1,model2,model3" - just models (uses default executor)
+ * - "opencode:gpt-4o,claude:sonnet-4" - executor:model format
+ * - Mixed: "gpt-4o,claude:sonnet-4,gemini:gemini-2.0"
+ *
+ * @param value - Comma-separated model/executor specifications
+ * @returns Array of model attempt configurations
+ * @throws Error if an invalid executor is specified
+ *
+ * @example
+ * ```typescript
+ * parseTryModels("gpt-4o-mini,gpt-4o"); // [{ model: "gpt-4o-mini" }, { model: "gpt-4o" }]
+ * parseTryModels("opencode:gpt-4o,claude:sonnet-4"); // [{ executor: "opencode", model: "gpt-4o" }, ...]
+ * ```
+ */
+export declare function parseTryModels(value: string): ModelAttemptConfig[];
+/**
+ * Validate that an executor name is valid
+ *
+ * @param executor - Executor name to validate
+ * @returns Type guard confirming executor is valid
+ *
+ * @example
+ * ```typescript
+ * if (validateExecutor(options.tool)) {
+ *   // TypeScript knows options.tool is ExecutorTool
+ * }
+ * ```
+ */
+export declare function validateExecutor(executor: string): executor is ExecutorTool;
+//# sourceMappingURL=model-executor-parser.d.ts.map