task-o-matic 0.0.12 → 0.0.14

package/dist/types/results.d.ts

@@ -1,16 +1,50 @@
 import { Task, TaskAIMetadata, DocumentationDetection } from "./index";
-export interface OperationResult<T = any> {
-    success: boolean;
-    data?: T;
-    error?: string;
+/**
+ * Generic operation result using discriminated union pattern.
+ * Prevents invalid states like { success: true, error: "..." }
+ *
+ * Note: This type uses discriminated unions for operations that may return
+ * either success or failure. Most task operations throw exceptions on error
+ * instead of returning error results.
+ *
+ * @example
+ * ```typescript
+ * const result: OperationResult<Task> =
+ *   condition
+ *     ? { success: true, data: task }
+ *     : { success: false, error: "Task not found" };
+ *
+ * if (result.success) {
+ *   console.log(result.data.title); // ✓ TypeScript knows data exists
+ * } else {
+ *   console.error(result.error); // ✓ TypeScript knows error exists
+ * }
+ * ```
+ */
+export type OperationResult<T = any> = {
+    success: true;
+    data: T;
     stats?: Record<string, any>;
     metadata?: Record<string, any>;
-}
+} | {
+    success: false;
+    error: string;
+    stats?: Record<string, any>;
+    metadata?: Record<string, any>;
+};
+/**
+ * Result of task creation operation.
+ * Always returns success; throws exception on error.
+ */
 export interface CreateTaskResult {
     success: true;
     task: Task;
     aiMetadata?: TaskAIMetadata;
 }
+/**
+ * Result of task enhancement operation.
+ * Always returns success; throws exception on error.
+ */
 export interface EnhanceTaskResult {
     success: true;
     task: Task;
@@ -33,6 +67,10 @@ export interface EnhanceTaskResult {
         confidence: number;
     };
 }
+/**
+ * Result of task splitting operation.
+ * Always returns success; throws exception on error.
+ */
 export interface SplitTaskResult {
     success: true;
     task: Task;
@@ -54,6 +92,10 @@ export interface SplitTaskResult {
         confidence?: number;
     };
 }
+/**
+ * Result of task planning operation.
+ * Always returns success; throws exception on error.
+ */
 export interface PlanTaskResult {
     success: true;
     task: Task;
@@ -73,6 +115,10 @@ export interface PlanTaskResult {
         aiModel: string;
     };
 }
+/**
+ * Result of task documentation operation.
+ * Always returns success; throws exception on error.
+ */
 export interface DocumentTaskResult {
     success: true;
     task: Task;
@@ -82,13 +128,21 @@ export interface DocumentTaskResult {
         duration: number;
     };
 }
+/**
+ * Result of task deletion operation.
+ * Always returns success; throws exception on error.
+ */
 export interface DeleteTaskResult {
     success: true;
     deleted: Task[];
     orphanedSubtasks: Task[];
 }
+/**
+ * Result of PRD parsing operation.
+ * Always returns success; throws exception on error.
+ */
 export interface PRDParseResult {
-    success: boolean;
+    success: true;
     prd: {
         overview: string;
         objectives: string[];

package/dist/types/results.d.ts.map

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

package/dist/utils/bulk-operations.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Configuration for bulk operation execution
+ */
+export interface BulkOperationConfig<T = void> {
+    /** Name of the operation (e.g., "Enhancing", "Splitting") */
+    operationName: string;
+    /** Emoji to display before operation name (optional) */
+    operationEmoji?: string;
+    /** Custom success message function (optional) */
+    successMessage?: (taskId: string, result: T) => string;
+    /** Custom error message function (optional) */
+    errorMessage?: (taskId: string, error: Error) => string;
+    /** Optional filters for task selection */
+    filters?: {
+        status?: string;
+        tag?: string;
+    };
+}
+/**
+ * Result of a bulk operation execution
+ */
+export interface BulkOperationResult {
+    /** Task IDs that succeeded */
+    succeeded: string[];
+    /** Tasks that failed with their errors */
+    failed: Array<{
+        id: string;
+        error: Error;
+    }>;
+}
+/**
+ * Execute an operation on multiple tasks with consistent error handling and progress reporting
+ *
+ * @param operation - The async function to execute for each task
+ * @param config - Configuration for the bulk operation
+ * @returns Result containing succeeded and failed task IDs
+ *
+ * @example
+ * ```typescript
+ * const result = await executeBulkOperation(
+ *   (taskId) => taskService.enhanceTask(taskId),
+ *   {
+ *     operationName: "Enhancing",
+ *     operationEmoji: "🤖",
+ *     filters: { status: "todo", tag: "bug" },
+ *   }
+ * );
+ * ```
+ */
+export declare function executeBulkOperation<T>(operation: (taskId: string) => Promise<T>, config: BulkOperationConfig<T>): Promise<BulkOperationResult>;
+//# sourceMappingURL=bulk-operations.d.ts.map

package/dist/utils/bulk-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-operations.d.ts","sourceRoot":"","sources":["../../src/utils/bulk-operations.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,IAAI;IAC3C,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAC;IAEtB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,iDAAiD;IACjD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC;IAEvD,+CAA+C;IAC/C,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;IAExD,0CAA0C;IAC1C,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,0CAA0C;IAC1C,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EACzC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CA4D9B"}

package/dist/utils/bulk-operations.js

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeBulkOperation = executeBulkOperation;
+const chalk_1 = __importDefault(require("chalk"));
+const tasks_1 = require("../services/tasks");
+/**
+ * Execute an operation on multiple tasks with consistent error handling and progress reporting
+ *
+ * @param operation - The async function to execute for each task
+ * @param config - Configuration for the bulk operation
+ * @returns Result containing succeeded and failed task IDs
+ *
+ * @example
+ * ```typescript
+ * const result = await executeBulkOperation(
+ *   (taskId) => taskService.enhanceTask(taskId),
+ *   {
+ *     operationName: "Enhancing",
+ *     operationEmoji: "🤖",
+ *     filters: { status: "todo", tag: "bug" },
+ *   }
+ * );
+ * ```
+ */
+async function executeBulkOperation(operation, config) {
+    // Fetch tasks with optional filters
+    const tasks = await tasks_1.taskService.listTasks(config.filters || {});
+    if (tasks.length === 0) {
+        console.log(chalk_1.default.yellow(`No tasks found to ${config.operationName.toLowerCase()}`));
+        return { succeeded: [], failed: [] };
+    }
+    const emoji = config.operationEmoji || "🔄";
+    console.log(chalk_1.default.blue(`${emoji} ${config.operationName} ${tasks.length} tasks...`));
+    const succeeded = [];
+    const failed = [];
+    // Process each task
+    for (let i = 0; i < tasks.length; i++) {
+        const task = tasks[i];
+        console.log(chalk_1.default.cyan(`\n[${i + 1}/${tasks.length}] ${config.operationName} ${task.title}`));
+        try {
+            const result = await operation(task.id);
+            succeeded.push(task.id);
+            const msg = config.successMessage
+                ? config.successMessage(task.id, result)
+                : `✓ ${config.operationName} task ${task.id}`;
+            console.log(chalk_1.default.green(msg));
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            failed.push({ id: task.id, error: err });
+            const msg = config.errorMessage
+                ? config.errorMessage(task.id, err)
+                : `❌ Failed to ${config.operationName.toLowerCase()} ${task.id}: ${err.message}`;
+            console.log(chalk_1.default.red(msg));
+        }
+    }
+    // Print summary
+    console.log(chalk_1.default.blue(`\n${"=".repeat(60)}`));
+    console.log(chalk_1.default.green(`✓ ${succeeded.length} tasks succeeded`));
+    if (failed.length > 0) {
+        console.log(chalk_1.default.red(`❌ ${failed.length} tasks failed`));
+    }
+    console.log(chalk_1.default.blue(`${"=".repeat(60)}\n`));
+    return { succeeded, failed };
+}

package/dist/utils/cli-validators.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Validate that exactly one of two mutually exclusive options is provided
+ *
+ * @param options - The command options object
+ * @param field1 - First field name in options
+ * @param field2 - Second field name in options
+ * @param field1Label - Display label for first field (defaults to field1)
+ * @param field2Label - Display label for second field (defaults to field2)
+ * @throws Error if neither or both fields are provided
+ *
+ * @example
+ * ```typescript
+ * validateMutuallyExclusive(options, "taskId", "all", "task-id", "all");
+ * ```
+ */
+export declare function validateMutuallyExclusive(options: any, field1: string, field2: string, field1Label?: string, field2Label?: string): void;
+/**
+ * Field specification for validateOneRequired
+ */
+export interface FieldSpec {
+    name: string;
+    label: string;
+}
+/**
+ * Validate that exactly one of multiple mutually exclusive options is provided
+ *
+ * @param options - The command options object
+ * @param fields - Array of field specifications
+ * @throws Error if none or multiple fields are provided
+ *
+ * @example
+ * ```typescript
+ * validateOneRequired(options,
+ *   { name: "taskId", label: "task-id" },
+ *   { name: "all", label: "all" },
+ *   { name: "status", label: "status" }
+ * );
+ * ```
+ */
+export declare function validateOneRequired(options: any, ...fields: FieldSpec[]): void;
+/**
+ * Parse a comma-separated string option into an array of trimmed non-empty strings
+ *
+ * @param value - Comma-separated string value
+ * @returns Array of trimmed non-empty strings
+ *
+ * @example
+ * ```typescript
+ * const ids = parseCsvOption("1, 2, 3"); // ["1", "2", "3"]
+ * const tags = parseCsvOption("bug,feature,  "); // ["bug", "feature"]
+ * ```
+ */
+export declare function parseCsvOption(value: string): string[];
+//# sourceMappingURL=cli-validators.d.ts.map

package/dist/utils/cli-validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-validators.d.ts","sourceRoot":"","sources":["../../src/utils/cli-validators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,GAAE,MAAe,EAC5B,WAAW,GAAE,MAAe,GAC3B,IAAI,CAcN;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,GAAG,EACZ,GAAG,MAAM,EAAE,SAAS,EAAE,GACrB,IAAI,CAWN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAKtD"}

package/dist/utils/cli-validators.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateMutuallyExclusive = validateMutuallyExclusive;
+exports.validateOneRequired = validateOneRequired;
+exports.parseCsvOption = parseCsvOption;
+/**
+ * Validate that exactly one of two mutually exclusive options is provided
+ *
+ * @param options - The command options object
+ * @param field1 - First field name in options
+ * @param field2 - Second field name in options
+ * @param field1Label - Display label for first field (defaults to field1)
+ * @param field2Label - Display label for second field (defaults to field2)
+ * @throws Error if neither or both fields are provided
+ *
+ * @example
+ * ```typescript
+ * validateMutuallyExclusive(options, "taskId", "all", "task-id", "all");
+ * ```
+ */
+function validateMutuallyExclusive(options, field1, field2, field1Label = field1, field2Label = field2) {
+    const has1 = Boolean(options[field1]);
+    const has2 = Boolean(options[field2]);
+    if (!has1 && !has2) {
+        throw new Error(`Either --${field1Label} or --${field2Label} must be specified`);
+    }
+    if (has1 && has2) {
+        throw new Error(`Cannot specify both --${field1Label} and --${field2Label}`);
+    }
+}
+/**
+ * Validate that exactly one of multiple mutually exclusive options is provided
+ *
+ * @param options - The command options object
+ * @param fields - Array of field specifications
+ * @throws Error if none or multiple fields are provided
+ *
+ * @example
+ * ```typescript
+ * validateOneRequired(options,
+ *   { name: "taskId", label: "task-id" },
+ *   { name: "all", label: "all" },
+ *   { name: "status", label: "status" }
+ * );
+ * ```
+ */
+function validateOneRequired(options, ...fields) {
+    const provided = fields.filter((f) => Boolean(options[f.name]));
+    if (provided.length === 0) {
+        const labels = fields.map((f) => `--${f.label}`).join(", ");
+        throw new Error(`One of ${labels} must be specified`);
+    }
+    if (provided.length > 1) {
+        const labels = provided.map((f) => `--${f.label}`).join(", ");
+        throw new Error(`Cannot specify multiple options: ${labels}`);
+    }
+}
+/**
+ * Parse a comma-separated string option into an array of trimmed non-empty strings
+ *
+ * @param value - Comma-separated string value
+ * @returns Array of trimmed non-empty strings
+ *
+ * @example
+ * ```typescript
+ * const ids = parseCsvOption("1, 2, 3"); // ["1", "2", "3"]
+ * const tags = parseCsvOption("bug,feature,  "); // ["bug", "feature"]
+ * ```
+ */
+function parseCsvOption(value) {
+    return value
+        .split(",")
+        .map((x) => x.trim())
+        .filter(Boolean);
+}

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

@@ -0,0 +1,32 @@
+/**
+ * Handle command errors with consistent formatting and exit behavior
+ *
+ * @param operationName - Name of the operation that failed (e.g., "Task enhancement", "Task execution")
+ * @param error - The error that occurred
+ * @returns Never returns (exits process with code 1)
+ *
+ * @example
+ * ```typescript
+ * catch (error) {
+ *   handleCommandError("Task enhancement", error);
+ * }
+ * ```
+ */
+export declare function handleCommandError(operationName: string, error: unknown): never;
+/**
+ * Wrap a command handler function with automatic error handling
+ *
+ * @param operationName - Name of the operation for error messages
+ * @param handler - The async command handler function
+ * @returns Wrapped handler function with error handling
+ *
+ * @example
+ * ```typescript
+ * .action(wrapCommandHandler("Task enhancement", async (options) => {
+ *   // command logic that might throw
+ *   await taskService.enhanceTask(options.taskId);
+ * }))
+ * ```
+ */
+export declare function wrapCommandHandler<T extends any[]>(operationName: string, handler: (...args: T) => Promise<void>): (...args: T) => Promise<void>;
+//# sourceMappingURL=command-error-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/command-error-handler.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,OAAO,GACb,KAAK,CAIP;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,GAAG,EAAE,EAChD,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GACrC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAQ/B"}

package/dist/utils/command-error-handler.js

@@ -0,0 +1,52 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleCommandError = handleCommandError;
+exports.wrapCommandHandler = wrapCommandHandler;
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Handle command errors with consistent formatting and exit behavior
+ *
+ * @param operationName - Name of the operation that failed (e.g., "Task enhancement", "Task execution")
+ * @param error - The error that occurred
+ * @returns Never returns (exits process with code 1)
+ *
+ * @example
+ * ```typescript
+ * catch (error) {
+ *   handleCommandError("Task enhancement", error);
+ * }
+ * ```
+ */
+function handleCommandError(operationName, error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    console.error(chalk_1.default.red(`${operationName} failed:`), message);
+    process.exit(1);
+}
+/**
+ * Wrap a command handler function with automatic error handling
+ *
+ * @param operationName - Name of the operation for error messages
+ * @param handler - The async command handler function
+ * @returns Wrapped handler function with error handling
+ *
+ * @example
+ * ```typescript
+ * .action(wrapCommandHandler("Task enhancement", async (options) => {
+ *   // command logic that might throw
+ *   await taskService.enhanceTask(options.taskId);
+ * }))
+ * ```
+ */
+function wrapCommandHandler(operationName, handler) {
+    return async (...args) => {
+        try {
+            await handler(...args);
+        }
+        catch (error) {
+            handleCommandError(operationName, error);
+        }
+    };
+}

package/dist/utils/confirmation.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Ask for user confirmation before performing a bulk operation
+ *
+ * @param operationName - Name of the operation (e.g., "enhance", "split")
+ * @param taskCount - Number of tasks that will be affected
+ * @param force - If true, skip confirmation and return true
+ * @returns Promise resolving to true if confirmed, false otherwise
+ *
+ * @example
+ * ```typescript
+ * const confirmed = await confirmBulkOperation("enhance", 10, options.force);
+ * if (!confirmed) {
+ *   console.log(chalk.yellow("Operation cancelled"));
+ *   return;
+ * }
+ * ```
+ */
+export declare function confirmBulkOperation(operationName: string, taskCount: number, force?: boolean): Promise<boolean>;
+//# sourceMappingURL=confirmation.d.ts.map

package/dist/utils/confirmation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmation.d.ts","sourceRoot":"","sources":["../../src/utils/confirmation.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,OAAe,GACrB,OAAO,CAAC,OAAO,CAAC,CAmBlB"}

package/dist/utils/confirmation.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.confirmBulkOperation = confirmBulkOperation;
+const inquirer_1 = __importDefault(require("inquirer"));
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Ask for user confirmation before performing a bulk operation
+ *
+ * @param operationName - Name of the operation (e.g., "enhance", "split")
+ * @param taskCount - Number of tasks that will be affected
+ * @param force - If true, skip confirmation and return true
+ * @returns Promise resolving to true if confirmed, false otherwise
+ *
+ * @example
+ * ```typescript
+ * const confirmed = await confirmBulkOperation("enhance", 10, options.force);
+ * if (!confirmed) {
+ *   console.log(chalk.yellow("Operation cancelled"));
+ *   return;
+ * }
+ * ```
+ */
+async function confirmBulkOperation(operationName, taskCount, force = false) {
+    if (force)
+        return true;
+    console.log(chalk_1.default.yellow(`\n⚠️  This will ${operationName.toLowerCase()} ${taskCount} task(s).`));
+    const { confirmed } = await inquirer_1.default.prompt([
+        {
+            type: "confirm",
+            name: "confirmed",
+            message: `Are you sure you want to proceed?`,
+            default: false,
+        },
+    ]);
+    return confirmed;
+}

package/dist/utils/display-helpers.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 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...
+ * ```
+ */
+export declare function displayOperationStart(operation: string, target: string): void;
+/**
+ * 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
+ * ```
+ */
+export declare function displayOperationSuccess(operation: string, details?: string): void;
+/**
+ * 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
+ * ```
+ */
+export declare function displayOperationError(operation: string, error: Error): void;
+/**
+ * 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...
+ * ```
+ */
+export declare function displayBulkProgress(current: number, total: number, operation: string): void;
+/**
+ * Display a separator line
+ *
+ * @param length - Length of the separator (default: 60)
+ *
+ * @example
+ * ```typescript
+ * displaySeparator();
+ * // Output: ============================================================
+ * ```
+ */
+export declare function displaySeparator(length?: number): void;
+/**
+ * Display a section header
+ *
+ * @param title - Section title
+ *
+ * @example
+ * ```typescript
+ * displaySectionHeader("Execution Summary");
+ * // Output:
+ * // ============================================================
+ * // 📊 Execution Summary
+ * // ============================================================
+ * ```
+ */
+export declare function displaySectionHeader(title: string): void;
+//# sourceMappingURL=display-helpers.d.ts.map

package/dist/utils/display-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/display-helpers.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI,CAKN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAE3E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,IAAI,CAEN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,MAAW,GAAG,IAAI,CAE1D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAIxD"}