task-o-matic 0.0.13 → 0.0.15

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,8 +10,10 @@ 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 Better-T-Stack");
+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
 exports.initCommand
     .command("init")
@@ -24,7 +26,7 @@ exports.initCommand
     .option("--temperature <temp>", "AI temperature", "0.5")
     .option("--no-bootstrap", "Skip bootstrap after initialization")
     .option("--project-name <name>", "Project name for bootstrap")
-    .option("--frontend <frontend>", "Frontend framework for bootstrap", "next")
+    .option("--frontend <frontends...>", "Frontend framework(s) - space/comma-separated (next, native-bare, cli, tui, etc.)", "next")
     .option("--backend <backend>", "Backend framework for bootstrap", "convex")
     .option("--database <database>", "Database for bootstrap")
     .option("--auth <auth>", "Authentication for bootstrap", "better-auth")
@@ -33,6 +35,8 @@ exports.initCommand
     .option("--package-manager <pm>", "Package manager (npm/pnpm/bun)", "npm")
     .option("--runtime <runtime>", "Runtime (bun/node)", "node")
     .option("--payment <payment>", "Payment provider (none/polar)", "none")
+    .option("--cli-deps <level>", "CLI dependency level (minimal/standard/full/task-o-matic)", "standard")
+    .option("--tui-framework <framework>", "TUI framework (solid/vue/react)", "solid")
     .action(async (options) => {
     // Handle directory creation/setup first
     if (options.directory) {
@@ -61,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
         }
     }
@@ -136,9 +147,9 @@ async function initializeProjectStructure(options) {
 // Bootstrap project with Better-T-Stack
 exports.initCommand
     .command("bootstrap")
-    .description("Bootstrap a new project using Better-T-Stack")
+    .description("Bootstrap a new project (web/native/cli/tui)")
     .argument("<name>", "Project name")
-    .option("--frontend <frontend>", "Frontend framework (next/tanstack-router/react-router/etc)", "next")
+    .option("--frontend <frontends...>", "Frontend framework(s) - space/comma-separated (next, native-bare, cli, tui, etc.)", "next")
     .option("--backend <backend>", "Backend framework (hono/express/elysia)", "hono")
     .option("--database <database>", "Database (sqlite/postgres/mysql/mongodb)", "sqlite")
     .option("--orm <orm>", "ORM (drizzle/prisma/none)", "drizzle")
@@ -152,6 +163,8 @@ exports.initCommand
     .option("--runtime <runtime>", "Runtime (bun/node)", "node")
     .option("--api <type>", "API type (trpc/orpc)")
     .option("--payment <payment>", "Payment provider (none/polar)", "none")
+    .option("--cli-deps <level>", "CLI dependency level (minimal/standard/full/task-o-matic)", "standard")
+    .option("--tui-framework <framework>", "TUI framework (solid/vue/react)", "solid")
     .action(async (name, options) => {
     const taskOMaticDir = config_1.configManager.getTaskOMaticDir();
     if (!(0, fs_1.existsSync)(taskOMaticDir)) {
@@ -176,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
@@ -192,11 +211,32 @@ exports.initCommand.action(() => {
     console.log("  task-o-matic init bootstrap <name>        Bootstrap Better-T-Stack project");
     console.log("");
     console.log(chalk_1.default.cyan("Examples:"));
+    console.log("  # Basic initialization:");
     console.log("  task-o-matic init init");
     console.log("  task-o-matic init init --project-name my-app");
-    console.log("  task-o-matic init init --project-name my-app --ai-provider openrouter --ai-key your-key --frontend next --backend hono");
+    console.log("");
+    console.log("  # Web + Native + CLI + TUI (monorepo):");
+    console.log("  task-o-matic init init --project-name my-app --frontend \"next native-uniwind cli tui\" --backend hono");
+    console.log("");
+    console.log("  # CLI only:");
+    console.log("  task-o-matic init init --project-name my-cli --frontend cli --cli-deps full");
+    console.log("");
+    console.log("  # TUI only:");
+    console.log("  task-o-matic init init --project-name my-tui --frontend tui --tui-framework solid");
+    console.log("");
+    console.log("  # Web + Native (monorepo):");
+    console.log("  task-o-matic init init --project-name my-app --frontend \"next native-bare\" --backend hono");
+    console.log("");
+    console.log("  # Multiple web frontends:");
+    console.log("  task-o-matic init init --project-name my-app --frontend \"next tanstack-router\" --backend hono");
+    console.log("");
+    console.log("  # No bootstrap:");
     console.log("  task-o-matic init init --project-name my-app --no-bootstrap");
+    console.log("");
+    console.log("  # Custom directory:");
     console.log("  task-o-matic init init --directory my-workspace --project-name my-app");
+    console.log("");
+    console.log("  # Bootstrap command:");
     console.log("  task-o-matic init bootstrap my-app --frontend next --backend hono --database postgres");
     console.log("");
     console.log(chalk_1.default.cyan("Init Options:"));
@@ -211,8 +251,16 @@ exports.initCommand.action(() => {
     console.log("  --directory <dir>            Working directory for the project");
     console.log("");
     console.log(chalk_1.default.cyan("Bootstrap Options:"));
-    console.log("  --frontend <frontend>         Frontend framework (next/tanstack-router/react-router/etc)");
-    console.log("  --backend <backend>           Backend framework (hono/express/elysia)");
+    console.log("  --frontend <frontends...>     Frontend framework(s) - multiple values supported");
+    console.log("                                Web: next, tanstack-router, react-router, nuxt, svelte, solid");
+    console.log("                                Native: native-bare, native-uniwind, native-unistyles");
+    console.log("                                Custom: cli, tui");
+    console.log("  --backend <backend>           Backend framework (hono/express/elysia/convex)");
     console.log("  --database <database>         Database (sqlite/postgres/mysql/mongodb)");
-    console.log("  --auth                       Include authentication");
+    console.log("  --auth <auth>                Authentication (better-auth/none)");
+    console.log("  --cli-deps <level>           CLI dependency level (minimal/standard/full/task-o-matic)");
+    console.log("  --tui-framework <framework>  TUI framework (solid/vue/react)");
+    console.log("  --package-manager <pm>       Package manager (npm/pnpm/bun)");
+    console.log("  --runtime <runtime>          Runtime (node/bun)");
+    console.log("  --payment <payment>          Payment provider (none/polar)");
 });

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,15 +8,16 @@ 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("--id <id>", "Task ID")
-    .requiredOption("--doc-file <path>", "Path to documentation file")
-    .option("--overwrite", "Overwrite existing documentation")
+    .requiredOption("-i, --id <id>", "Task ID")
+    .requiredOption("-f, --doc-file <path>", "Path to documentation file")
+    .option("-o, --overwrite", "Overwrite existing 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/list.js

@@ -7,8 +7,8 @@ const task_1 = require("../../cli/display/task");
 const progress_1 = require("../../cli/display/progress");
 exports.listCommand = new commander_1.Command("list")
     .description("List all tasks")
-    .option("--status <status>", "Filter by status (todo/in-progress/completed)")
-    .option("--tag <tag>", "Filter by tag")
+    .option("-s, --status <status>", "Filter by status (todo/in-progress/completed)")
+    .option("-t, --tag <tag>", "Filter by tag")
     .action(async (options) => {
     try {
         const tasks = await tasks_1.taskService.listTasks({

package/dist/commands/tasks/next.js

@@ -11,10 +11,10 @@ const task_1 = require("../../cli/display/task");
 const progress_1 = require("../../cli/display/progress");
 exports.nextCommand = new commander_1.Command("get-next")
     .description("Get the next task to work on (defaults to hierarchical order)")
-    .option("--status <status>", "Filter by status (todo/in-progress)")
-    .option("--tag <tag>", "Filter by tag")
-    .option("--effort <effort>", "Filter by effort (small/medium/large)")
-    .option("--priority <priority>", "Sort priority (newest/oldest/effort)", "hierarchical")
+    .option("-s, --status <status>", "Filter by status (todo/in-progress)")
+    .option("-t, --tag <tag>", "Filter by tag")
+    .option("-e, --effort <effort>", "Filter by effort (small/medium/large)")
+    .option("-p, --priority <priority>", "Sort priority (newest/oldest/effort)", "hierarchical")
     .action(async (options) => {
     try {
         // Default to todo status if not specified

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,15 +5,16 @@ 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("--id <id>", "Task ID")
-    .requiredOption("--status <status>", "New status (todo/in-progress/completed)")
+    .requiredOption("-i, --id <id>", "Task ID")
+    .requiredOption("-s, --status <status>", "New status (todo/in-progress/completed)")
     .action(async (options) => {
     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/lib/ai-service/ai-operations.d.ts

@@ -36,6 +36,6 @@ export declare class AIOperations extends BaseOperations {
         library: string;
         content: string;
     }>, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>): Promise<string>;
-    planTask(taskContext: string, taskDetails: string, config?: Partial<AIConfig>, promptOverride?: string, userMessage?: string, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>): Promise<any>;
+    planTask(taskContext: string, taskDetails: string, config?: Partial<AIConfig>, promptOverride?: string, userMessage?: string, streamingOptions?: StreamingOptions, retryConfig?: Partial<RetryConfig>): Promise<string>;
 }
 //# sourceMappingURL=ai-operations.d.ts.map

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

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

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

@@ -8,6 +8,28 @@ export declare class BaseOperations {
     protected context7Client: Context7Client;
     protected retryHandler: RetryHandler;
     protected modelProvider: ModelProvider;
+    /**
+     * Merges AI configuration with proper precedence.
+     *
+     * Configuration precedence (highest to lowest):
+     * 1. Method parameter `config` (operation-specific overrides)
+     * 2. ConfigManager global config (project-level settings)
+     * 3. Environment variables (OPENAI_API_KEY, etc.)
+     * 4. Provider defaults (defined in config.ts)
+     *
+     * @param config - Optional operation-specific config overrides
+     * @returns Merged AIConfig with all precedence levels applied
+     *
+     * @example
+     * ```typescript
+     * // Override just the model for this operation
+     * const finalConfig = this.mergeAIConfig({ model: "gpt-4o" });
+     *
+     * // Use default config (from ConfigManager + env vars)
+     * const finalConfig = this.mergeAIConfig();
+     * ```
+     */
+    protected mergeAIConfig(config?: Partial<AIConfig>): AIConfig;
     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;IAExC,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;CA+EnB"}
+{"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"}