task-o-matic 0.0.14 → 0.0.16

package/dist/cli/display/progress.d.ts

@@ -5,7 +5,20 @@ import type { ProgressEvent } from "../../types/callbacks";
  */
 export declare function displayProgress(event: ProgressEvent): void;
 /**
- * Display an error message
+ * Display an error message with full TaskOMaticError details
+ *
+ * If the error is a TaskOMaticError, displays:
+ * - Error code (e.g., [TASK_NOT_FOUND])
+ * - Error message
+ * - Context information
+ * - Actionable suggestions
+ * - Metadata (in verbose mode)
+ * - Stack trace (in debug mode)
+ *
+ * For regular errors, displays the message and stack trace.
  */
-export declare function displayError(error: Error | unknown): void;
+export declare function displayError(error: Error | unknown, options?: {
+    verbose?: boolean;
+    debug?: boolean;
+}): void;
 //# sourceMappingURL=progress.d.ts.map

package/dist/cli/display/progress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../src/cli/display/progress.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAuC1D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,GAAG,IAAI,CAGzD"}
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../src/cli/display/progress.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG3D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAuC1D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAmE3G"}

package/dist/cli/display/progress.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.displayProgress = displayProgress;
 exports.displayError = displayError;
 const chalk_1 = __importDefault(require("chalk"));
+const task_o_matic_error_1 = require("../../utils/task-o-matic-error");
 /**
  * Display progress events for the CLI
  * This function is used as a callback for services to report progress
@@ -42,9 +43,76 @@ function displayProgress(event) {
     }
 }
 /**
- * Display an error message
+ * Display an error message with full TaskOMaticError details
+ *
+ * If the error is a TaskOMaticError, displays:
+ * - Error code (e.g., [TASK_NOT_FOUND])
+ * - Error message
+ * - Context information
+ * - Actionable suggestions
+ * - Metadata (in verbose mode)
+ * - Stack trace (in debug mode)
+ *
+ * For regular errors, displays the message and stack trace.
  */
-function displayError(error) {
-    const message = error instanceof Error ? error.message : "Unknown error";
-    console.error(chalk_1.default.red("❌ Error:"), message);
+function displayError(error, options) {
+    const verbose = options?.verbose ?? false;
+    const debug = options?.debug ?? process.env.DEBUG === "true";
+    if ((0, task_o_matic_error_1.isTaskOMaticError)(error)) {
+        // Display TaskOMaticError with full formatting
+        const taskError = error;
+        // Error header with code
+        console.error(chalk_1.default.red(`❌ [${taskError.code}] ${taskError.message}`));
+        // Context information
+        if (taskError.context) {
+            console.error(chalk_1.default.gray(`\nContext: ${taskError.context}`));
+        }
+        // Actionable suggestions
+        if (taskError.suggestions && taskError.suggestions.length > 0) {
+            console.error(chalk_1.default.yellow("\n💡 Suggestions:"));
+            taskError.suggestions.forEach((suggestion, index) => {
+                console.error(chalk_1.default.yellow(`   ${index + 1}. ${suggestion}`));
+            });
+        }
+        // Metadata (only in verbose mode)
+        if (verbose && taskError.metadata) {
+            console.error(chalk_1.default.gray("\nMetadata:"));
+            Object.entries(taskError.metadata).forEach(([key, value]) => {
+                console.error(chalk_1.default.gray(`   ${key}: ${JSON.stringify(value)}`));
+            });
+        }
+        // Cause chain
+        if (taskError.cause && verbose) {
+            console.error(chalk_1.default.gray("\nCaused by:"));
+            let cause = taskError.cause;
+            let depth = 1;
+            while (cause && depth <= 3) {
+                const causeMsg = cause instanceof Error ? cause.message : String(cause);
+                console.error(chalk_1.default.gray(`   ${"  ".repeat(depth - 1)}↳ ${causeMsg}`));
+                cause = cause.cause;
+                depth++;
+            }
+        }
+        // Stack trace (only in debug mode)
+        if (debug && taskError.stack) {
+            console.error(chalk_1.default.gray("\nStack trace:"));
+            console.error(chalk_1.default.gray(taskError.stack));
+        }
+    }
+    else if (error instanceof Error) {
+        // Regular Error object
+        console.error(chalk_1.default.red("❌ Error:"), error.message);
+        if (debug && error.stack) {
+            console.error(chalk_1.default.gray("\nStack trace:"));
+            console.error(chalk_1.default.gray(error.stack));
+        }
+    }
+    else {
+        // Unknown error type
+        console.error(chalk_1.default.red("❌ Unknown error:"), String(error));
+    }
+    // Footer with help hint
+    if (!verbose && !debug) {
+        console.error(chalk_1.default.gray("\n💭 Run with --verbose for more details, or --debug for stack traces"));
+    }
 }

package/dist/commands/benchmark.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"benchmark.d.ts","sourceRoot":"","sources":["../../src/commands/benchmark.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,eAAO,MAAM,gBAAgB,SAE5B,CAAC"}
+{"version":3,"file":"benchmark.d.ts","sourceRoot":"","sources":["../../src/commands/benchmark.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,eAAO,MAAM,gBAAgB,SAE5B,CAAC"}

package/dist/commands/benchmark.js

@@ -40,14 +40,22 @@ exports.benchmarkCommand = void 0;
 const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
 const benchmark_1 = require("../services/benchmark");
+const progress_1 = require("../cli/display/progress");
 const workflow_prompts_1 = require("../utils/workflow-prompts");
 exports.benchmarkCommand = new commander_1.Command("benchmark").description("Run and manage AI benchmarks");
+const task_o_matic_error_1 = require("../utils/task-o-matic-error");
 // Helper to parse model string
 // Format: provider:model[:reasoning=<tokens>]
 function parseModelString(modelStr) {
     const parts = modelStr.split(":");
     if (parts.length < 2) {
-        throw new Error(`Invalid model format: ${modelStr}. Expected provider:model[:reasoning=<tokens>]`);
+        throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.INVALID_INPUT, `Invalid model format: ${modelStr}. Expected provider:model[:reasoning=<tokens>]`, {
+            suggestions: [
+                "Use the format 'provider:model'",
+                "Example: 'anthropic:claude-3.5-sonnet'",
+                "Optionally add reasoning tokens: 'openai:gpt-4:reasoning=2048'",
+            ],
+        });
     }
     const provider = parts[0];
     const model = parts[1];
@@ -192,7 +200,7 @@ exports.benchmarkCommand
         });
     }
     catch (error) {
-        console.error(chalk_1.default.red("Benchmark failed:"), error.message);
+        (0, progress_1.displayError)(error);
         process.exit(1);
     }
 });
@@ -375,7 +383,7 @@ exports.benchmarkCommand
         await runWorkflowBenchmark(options);
     }
     catch (error) {
-        console.error(chalk_1.default.red("Workflow benchmark failed:"), error.message);
+        (0, progress_1.displayError)(error);
         process.exit(1);
     }
 });

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,eAAO,MAAM,WAAW,SAEvB,CAAC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,eAAO,MAAM,WAAW,SAEvB,CAAC"}

package/dist/commands/init.js

@@ -10,6 +10,8 @@ const chalk_1 = __importDefault(require("chalk"));
 const fs_1 = require("fs");
 const path_1 = require("path");
 const config_1 = require("../lib/config");
+const progress_1 = require("../cli/display/progress");
+const task_o_matic_error_1 = require("../utils/task-o-matic-error");
 const better_t_stack_cli_1 = require("../lib/better-t-stack-cli");
 exports.initCommand = new commander_1.Command("init").description("Initialize task-o-matic project and bootstrap projects (web/native/cli/tui)");
 // Initialize task-o-matic project
@@ -63,13 +65,20 @@ exports.initCommand
                 await config_1.configManager.load();
                 // Initialize task-o-matic structure in the new project directory
                 await initializeProjectStructure(options);
+                // ... (existing code)
             }
             else {
-                throw new Error(result.message);
+                throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.UNEXPECTED_ERROR, result.message, {
+                    context: "Bootstrap process failed. The error originated from the 'better-t-stack-cli' tool.",
+                    suggestions: [
+                        "Check the output from 'better-t-stack-cli' for more details.",
+                        "Ensure that 'better-t-stack-cli' is installed and configured correctly.",
+                    ],
+                });
             }
         }
         catch (error) {
-            console.error(chalk_1.default.red("Bootstrap failed:"), error);
+            (0, progress_1.displayError)(error);
             return; // Stop if bootstrap fails
         }
     }
@@ -180,11 +189,17 @@ exports.initCommand
             console.log(chalk_1.default.green(result.message));
         }
         else {
-            throw new Error(result.message);
+            throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.UNEXPECTED_ERROR, result.message, {
+                context: "Bootstrap process failed. The error originated from the 'better-t-stack-cli' tool.",
+                suggestions: [
+                    "Check the output from 'better-t-stack-cli' for more details.",
+                    "Ensure that 'better-t-stack-cli' is installed and configured correctly.",
+                ],
+            });
         }
     }
     catch (error) {
-        // No chdir needed anymore
+        (0, progress_1.displayError)(error);
     }
 });
 // Default action - show help

package/dist/commands/prd.js

@@ -46,11 +46,17 @@ const prd_1 = require("../services/prd");
 const streaming_options_1 = require("../utils/streaming-options");
 const progress_1 = require("../cli/display/progress");
 exports.prdCommand = new commander_1.Command("prd").description("Manage PRDs and generate tasks");
+const task_o_matic_error_1 = require("../utils/task-o-matic-error");
 // Helper to parse model string (provider:model)
 function parseModelString(modelStr) {
     const parts = modelStr.split(":");
     if (parts.length < 2) {
-        throw new Error(`Invalid model format: ${modelStr}. Expected provider:model`);
+        throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.INVALID_INPUT, `Invalid model format: ${modelStr}. Expected provider:model`, {
+            suggestions: [
+                "Use the format 'provider:model'",
+                "Example: 'anthropic:claude-3.5-sonnet'",
+            ],
+        });
     }
     return { provider: parts[0], model: parts[1] };
 }

package/dist/commands/tasks/delete.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,eAAO,MAAM,aAAa,SAmCtB,CAAC"}
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,eAAO,MAAM,aAAa,SAmCtB,CAAC"}

package/dist/commands/tasks/delete.js

@@ -9,6 +9,7 @@ const chalk_1 = __importDefault(require("chalk"));
 const tasks_1 = require("../../services/tasks");
 const task_1 = require("../../cli/display/task");
 const progress_1 = require("../../cli/display/progress");
+const task_o_matic_error_1 = require("../../utils/task-o-matic-error");
 exports.deleteCommand = new commander_1.Command("delete")
     .description("Delete a task")
     .requiredOption("--id <id>", "Task ID to delete")
@@ -19,7 +20,7 @@ exports.deleteCommand = new commander_1.Command("delete")
         if (!options.force) {
             const task = await tasks_1.taskService.getTask(options.id);
             if (!task) {
-                throw new Error(`Task with ID ${options.id} not found`);
+                throw (0, task_o_matic_error_1.formatTaskNotFoundError)(options.id);
             }
             console.log(chalk_1.default.red(`\n⚠️  Are you sure you want to delete task: ${task.title} (${task.id})?`));
             console.log(chalk_1.default.red("This action cannot be undone."));

package/dist/commands/tasks/document/add.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../../src/commands/tasks/document/add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,eAAO,MAAM,uBAAuB,SAyC/B,CAAC"}
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../../src/commands/tasks/document/add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,eAAO,MAAM,uBAAuB,SAyC/B,CAAC"}

package/dist/commands/tasks/document/add.js

@@ -8,6 +8,7 @@ const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
 const tasks_1 = require("../../../services/tasks");
 const command_error_handler_1 = require("../../../utils/command-error-handler");
+const task_o_matic_error_1 = require("../../../utils/task-o-matic-error");
 exports.addDocumentationCommand = new commander_1.Command("add-documentation")
     .description("Add documentation to a task from a file")
     .requiredOption("-i, --id <id>", "Task ID")
@@ -16,7 +17,7 @@ exports.addDocumentationCommand = new commander_1.Command("add-documentation")
     .action((0, command_error_handler_1.wrapCommandHandler)("Add documentation", async (options) => {
     const task = await tasks_1.taskService.getTask(options.id);
     if (!task) {
-        throw new Error(`Task with ID ${options.id} not found`);
+        throw (0, task_o_matic_error_1.formatTaskNotFoundError)(options.id);
     }
     // Check if documentation already exists
     const existingDoc = await tasks_1.taskService.getTaskDocumentation(options.id);

package/dist/commands/tasks/document/get.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../../src/commands/tasks/document/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,eAAO,MAAM,uBAAuB,SA2B/B,CAAC"}
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../../src/commands/tasks/document/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,eAAO,MAAM,uBAAuB,SA2B/B,CAAC"}

package/dist/commands/tasks/document/get.js

@@ -8,13 +8,14 @@ const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
 const tasks_1 = require("../../../services/tasks");
 const command_error_handler_1 = require("../../../utils/command-error-handler");
+const task_o_matic_error_1 = require("../../../utils/task-o-matic-error");
 exports.getDocumentationCommand = new commander_1.Command("get-documentation")
     .description("Get existing documentation for a task")
     .requiredOption("--id <id>", "Task ID")
     .action((0, command_error_handler_1.wrapCommandHandler)("Get documentation", async (options) => {
     const task = await tasks_1.taskService.getTask(options.id);
     if (!task) {
-        throw new Error(`Task with ID ${options.id} not found`);
+        throw (0, task_o_matic_error_1.formatTaskNotFoundError)(options.id);
     }
     const documentation = await tasks_1.taskService.getTaskDocumentation(options.id);
     if (!documentation) {

package/dist/commands/tasks/plan/set.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../../src/commands/tasks/plan/set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,eAAO,MAAM,cAAc,SAiCtB,CAAC"}
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../../src/commands/tasks/plan/set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,eAAO,MAAM,cAAc,SAkDxB,CAAC"}

package/dist/commands/tasks/plan/set.js

@@ -8,6 +8,7 @@ const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
 const tasks_1 = require("../../../services/tasks");
 const command_error_handler_1 = require("../../../utils/command-error-handler");
+const task_o_matic_error_1 = require("../../../utils/task-o-matic-error");
 exports.setPlanCommand = new commander_1.Command("set-plan")
     .description("Set implementation plan for a task")
     .requiredOption("--id <id>", "Task ID")
@@ -16,13 +17,20 @@ exports.setPlanCommand = new commander_1.Command("set-plan")
     .action((0, command_error_handler_1.wrapCommandHandler)("Set plan", async (options) => {
     const task = await tasks_1.taskService.getTask(options.id);
     if (!task) {
-        throw new Error(`Task with ID ${options.id} not found`);
+        throw (0, task_o_matic_error_1.formatTaskNotFoundError)(options.id);
     }
     if (!options.plan && !options.planFile) {
-        throw new Error("Either --plan or --plan-file must be specified");
+        throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.INVALID_INPUT, "Either --plan or --plan-file must be specified", {
+            suggestions: [
+                "Provide the plan directly using --plan '...' ",
+                "Provide a file containing the plan using --plan-file <path>",
+            ],
+        });
     }
     if (options.plan && options.planFile) {
-        throw new Error("Cannot specify both --plan and --plan-file");
+        throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.INVALID_INPUT, "Cannot specify both --plan and --plan-file", {
+            suggestions: ["Provide either --plan or --plan-file, but not both."],
+        });
     }
     const result = await tasks_1.taskService.setTaskPlan(options.id, options.plan || undefined, options.planFile || undefined);
     console.log(chalk_1.default.green(`✓ Plan set for task: ${task.title} (${options.id})`));

package/dist/commands/tasks/show.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/show.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,WAAW,SAgBpB,CAAC"}
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/show.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,eAAO,MAAM,WAAW,SAgBpB,CAAC"}

package/dist/commands/tasks/show.js

@@ -5,6 +5,7 @@ const commander_1 = require("commander");
 const tasks_1 = require("../../services/tasks");
 const task_1 = require("../../cli/display/task");
 const progress_1 = require("../../cli/display/progress");
+const task_o_matic_error_1 = require("../../utils/task-o-matic-error");
 exports.showCommand = new commander_1.Command("show")
     .description("Show detailed information about a task")
     .requiredOption("--id <id>", "Task ID")
@@ -12,7 +13,7 @@ exports.showCommand = new commander_1.Command("show")
     try {
         const task = await tasks_1.taskService.getTask(options.id);
         if (!task) {
-            throw new Error(`Task with ID ${options.id} not found`);
+            throw (0, task_o_matic_error_1.formatTaskNotFoundError)(options.id);
         }
         await (0, task_1.displayTaskDetails)(task);
     }

package/dist/commands/tasks/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,aAAa,SAyBtB,CAAC"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,eAAO,MAAM,aAAa,SAyBtB,CAAC"}

package/dist/commands/tasks/status.js

@@ -5,6 +5,7 @@ const commander_1 = require("commander");
 const tasks_1 = require("../../services/tasks");
 const task_1 = require("../../cli/display/task");
 const progress_1 = require("../../cli/display/progress");
+const task_o_matic_error_1 = require("../../utils/task-o-matic-error");
 exports.statusCommand = new commander_1.Command("status")
     .description("Set task status")
     .requiredOption("-i, --id <id>", "Task ID")
@@ -13,7 +14,7 @@ exports.statusCommand = new commander_1.Command("status")
     try {
         const task = await tasks_1.taskService.getTask(options.id);
         if (!task) {
-            throw new Error(`Task with ID ${options.id} not found`);
+            throw (0, task_o_matic_error_1.formatTaskNotFoundError)(options.id);
         }
         const oldStatus = task.status;
         const updatedTask = await tasks_1.taskService.setTaskStatus(options.id, options.status);

package/dist/commands/tasks/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,aAAa,SA4BtB,CAAC"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,eAAO,MAAM,aAAa,SAqCtB,CAAC"}

package/dist/commands/tasks/update.js

@@ -5,6 +5,7 @@ const commander_1 = require("commander");
 const tasks_1 = require("../../services/tasks");
 const task_1 = require("../../cli/display/task");
 const progress_1 = require("../../cli/display/progress");
+const task_o_matic_error_1 = require("../../utils/task-o-matic-error");
 exports.updateCommand = new commander_1.Command("update")
     .description("Update an existing task")
     .requiredOption("--id <id>", "Task ID to update")
@@ -17,7 +18,12 @@ exports.updateCommand = new commander_1.Command("update")
     try {
         const { id, ...updates } = options;
         if (Object.keys(updates).length === 0) {
-            throw new Error("At least one field must be specified for update");
+            throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.INVALID_INPUT, "At least one field must be specified for update", {
+                suggestions: [
+                    "Specify a field to update, e.g., --title 'New Title'",
+                    "Use --help for a list of available options",
+                ],
+            });
         }
         const updatedTask = await tasks_1.taskService.updateTask(id, {
             title: updates.title,

package/dist/commands/workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/commands/workflow.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBpC,eAAO,MAAM,eAAe,SAsKxB,CAAC"}
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/commands/workflow.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0BpC,eAAO,MAAM,eAAe,SAsKxB,CAAC"}

package/dist/commands/workflow.js

@@ -48,6 +48,7 @@ const inquirer_1 = __importDefault(require("inquirer"));
 const workflow_prompts_1 = require("../utils/workflow-prompts");
 const streaming_options_1 = require("../utils/streaming-options");
 const progress_1 = require("../cli/display/progress");
+const task_o_matic_error_1 = require("../utils/task-o-matic-error");
 exports.workflowCommand = new commander_1.Command("workflow")
     .description("Interactive workflow for complete project setup and task management")
     // Existing AI options
@@ -336,7 +337,13 @@ async function stepDefinePRD(state, options, streamingOptions) {
             multiGenerationModels = modelsInput.split(",").map((m) => {
                 const parts = m.trim().split(":");
                 if (parts.length < 2) {
-                    throw new Error(`Invalid model format: ${m}. Expected provider:model`);
+                    throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.WORKFLOW_EXECUTION_ERROR, `Invalid model format: ${m}. Expected provider:model`, {
+                        context: "Model format validation failed during multi-generation setup",
+                        suggestions: [
+                            "Use format: provider:model (e.g., anthropic:claude-sonnet-4.5)",
+                            "Check for typos in provider or model name",
+                        ],
+                    });
                 }
                 return { provider: parts[0], model: parts[1] };
             });
@@ -347,7 +354,13 @@ async function stepDefinePRD(state, options, streamingOptions) {
                 if (combineModelInput && combineModelInput.trim()) {
                     const parts = combineModelInput.trim().split(":");
                     if (parts.length < 2) {
-                        throw new Error(`Invalid model format: ${combineModelInput}. Expected provider:model`);
+                        throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.WORKFLOW_EXECUTION_ERROR, `Invalid model format: ${combineModelInput}. Expected provider:model`, {
+                            context: "Model format validation failed during PRD combine setup",
+                            suggestions: [
+                                "Use format: provider:model (e.g., anthropic:claude-sonnet-4.5)",
+                                "Check for typos in provider or model name",
+                            ],
+                        });
                     }
                     combineAI = { provider: parts[0], model: parts[1] };
                 }

package/dist/lib/ai-service/base-operations.d.ts

@@ -30,6 +30,14 @@ export declare class BaseOperations {
      * ```
      */
     protected mergeAIConfig(config?: Partial<AIConfig>): AIConfig;
+    /**
+     * Handles Context7 tool results by caching documentation.
+     * Extracts and saves documentation from get-library-docs tool results.
+     *
+     * @param chunk - The chunk to check for Context7 tool results
+     * @protected
+     */
+    protected handleContext7ToolResult(chunk: any): void;
     streamText(prompt: string, config?: Partial<AIConfig>, systemPrompt?: string, userMessage?: string, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>): Promise<string>;
 }
 //# sourceMappingURL=base-operations.d.ts.map

package/dist/lib/ai-service/base-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-operations.d.ts","sourceRoot":"","sources":["../../../src/lib/ai-service/base-operations.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,qBAAa,cAAc;IACzB,SAAS,CAAC,UAAU,aAAoB;IACxC,SAAS,CAAC,cAAc,iBAAwB;IAChD,SAAS,CAAC,YAAY,eAAsB;IAC5C,SAAS,CAAC,aAAa,gBAAuB;IAE9C;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ;IAQvD,UAAU,CACd,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,YAAY,CAAC,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,EACpB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GACjC,OAAO,CAAC,MAAM,CAAC;CAgFnB"}
+{"version":3,"file":"base-operations.d.ts","sourceRoot":"","sources":["../../../src/lib/ai-service/base-operations.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,qBAAa,cAAc;IACzB,SAAS,CAAC,UAAU,aAAoB;IACxC,SAAS,CAAC,cAAc,iBAAwB;IAChD,SAAS,CAAC,YAAY,eAAsB;IAC5C,SAAS,CAAC,aAAa,gBAAuB;IAE9C;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ;IAQ7D;;;;;;OAMG;IACH,SAAS,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI;IAqB9C,UAAU,CACd,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC1B,YAAY,CAAC,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,EACpB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GACjC,OAAO,CAAC,MAAM,CAAC;CAgEnB"}

package/dist/lib/ai-service/base-operations.js

@@ -38,6 +38,27 @@ class BaseOperations {
         // Apply operation-specific overrides (highest priority)
         return { ...baseConfig, ...config };
     }
+    /**
+     * Handles Context7 tool results by caching documentation.
+     * Extracts and saves documentation from get-library-docs tool results.
+     *
+     * @param chunk - The chunk to check for Context7 tool results
+     * @protected
+     */
+    handleContext7ToolResult(chunk) {
+        if (chunk.type === "tool-result" &&
+            chunk.toolName === "get-library-docs") {
+            const docs = chunk.output;
+            const libraryID = chunk.input?.context7CompatibleLibraryID || "unknown";
+            const topic = chunk.input?.topic || "general";
+            if (docs && typeof docs === "object" && "content" in docs) {
+                this.context7Client.saveContext7Documentation(libraryID, docs.content, topic);
+            }
+            else if (docs && typeof docs === "string") {
+                this.context7Client.saveContext7Documentation(libraryID, docs, topic);
+            }
+        }
+    }
     async streamText(prompt, config, systemPrompt, userMessage, streamingOptions, retryConfig) {
         // Merge config with proper precedence (Bug fix 2.9)
         const aiConfig = this.mergeAIConfig(config);
@@ -60,16 +81,8 @@ class BaseOperations {
                         else if (chunk.type === "reasoning-delta") {
                             streamingOptions.onReasoning?.(chunk.text);
                         }
-                        else if (chunk.type === "tool-result" &&
-                            chunk.toolName === "get-library-docs") {
-                            const docs = chunk.output;
-                            if (docs && typeof docs === "object" && "content" in docs) {
-                                this.context7Client.saveContext7Documentation(chunk.input?.context7CompatibleLibraryID || "unknown", docs.content, chunk.input?.topic || "general");
-                            }
-                            else if (docs && typeof docs === "string") {
-                                this.context7Client.saveContext7Documentation(chunk.input?.context7CompatibleLibraryID || "unknown", docs, chunk.input?.topic || "general");
-                            }
-                        }
+                        // Handle Context7 tool result caching
+                        this.handleContext7ToolResult(chunk);
                     }
                     : undefined,
                 onFinish: streamingOptions?.onFinish

package/dist/lib/ai-service/model-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-provider.d.ts","sourceRoot":"","sources":["../../../src/lib/ai-service/model-provider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,qBAAa,aAAa;IACjB,WAAW,IAAI,QAAQ;IAY9B,OAAO,CAAC,YAAY;IAsBpB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,eAAe;CA+B9C"}
+{"version":3,"file":"model-provider.d.ts","sourceRoot":"","sources":["../../../src/lib/ai-service/model-provider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAOvC,qBAAa,aAAa;IACjB,WAAW,IAAI,QAAQ;IAY9B,OAAO,CAAC,YAAY;IAsBpB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,eAAe;CA0F9C"}

package/dist/lib/ai-service/model-provider.js

@@ -6,6 +6,7 @@ const anthropic_1 = require("@ai-sdk/anthropic");
 const openai_compatible_1 = require("@ai-sdk/openai-compatible");
 const ai_sdk_provider_1 = require("@openrouter/ai-sdk-provider");
 const config_1 = require("../config");
+const task_o_matic_error_1 = require("../../utils/task-o-matic-error");
 class ModelProvider {
     getAIConfig() {
         const config = config_1.configManager.getAIConfig();
@@ -41,22 +42,47 @@ class ModelProvider {
         switch (provider) {
             case "openai":
                 if (!apiKey)
-                    throw new Error("OpenAI API key is required");
+                    throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.AI_CONFIGURATION_ERROR, "OpenAI API key is required", {
+                        suggestions: [
+                            "Set the OPENAI_API_KEY environment variable.",
+                            "Run `task-o-matic config set-ai-key <key>`",
+                        ],
+                    });
                 return (0, openai_1.openai)(model);
             case "anthropic":
                 if (!apiKey)
-                    throw new Error("Anthropic API key is required");
+                    throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.AI_CONFIGURATION_ERROR, "Anthropic API key is required", {
+                        suggestions: [
+                            "Set the ANTHROPIC_API_KEY environment variable.",
+                            "Run `task-o-matic config set-ai-key <key>`",
+                        ],
+                    });
                 return (0, anthropic_1.anthropic)(model);
             case "openrouter":
                 if (!apiKey)
-                    throw new Error("OpenRouter API key is required");
+                    throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.AI_CONFIGURATION_ERROR, "OpenRouter API key is required", {
+                        suggestions: [
+                            "Set the OPENROUTER_API_KEY environment variable.",
+                            "Run `task-o-matic config set-ai-key <key>`",
+                        ],
+                    });
                 const openRouterProvider = (0, ai_sdk_provider_1.createOpenRouter)({ apiKey });
                 return openRouterProvider(model);
             case "custom":
                 if (!apiKey)
-                    throw new Error("Custom API key is required");
+                    throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.AI_CONFIGURATION_ERROR, "Custom API key is required for custom provider", {
+                        suggestions: [
+                            "Set the CUSTOM_API_KEY environment variable.",
+                            "Run `task-o-matic config set-ai-key <key>`",
+                        ],
+                    });
                 if (!baseURL)
-                    throw new Error("Custom provider requires baseURL");
+                    throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.AI_CONFIGURATION_ERROR, "Custom provider requires baseURL", {
+                        suggestions: [
+                            "Set the CUSTOM_API_URL environment variable.",
+                            "Run `task-o-matic config set-ai-provider-url <url>`",
+                        ],
+                    });
                 const customProvider = (0, openai_compatible_1.createOpenAICompatible)({
                     name: "custom",
                     apiKey,
@@ -64,7 +90,12 @@ class ModelProvider {
                 });
                 return customProvider(model);
             default:
-                throw new Error(`Unsupported provider: ${provider}`);
+                throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.AI_CONFIGURATION_ERROR, `Unsupported provider: ${provider}`, {
+                    suggestions: [
+                        "Use one of the supported providers: 'openai', 'anthropic', 'openrouter', 'custom'.",
+                        "Run `task-o-matic config set-ai-provider <provider>`",
+                    ],
+                });
         }
     }
 }