task-o-matic 0.0.3 → 0.0.4

package/README.md

@@ -5,6 +5,7 @@ AI-powered task management for CLI, TUI, and web applications. Parse PRDs, enhan
 ## ✨ Features
 
 - 🤖 **AI-Powered**: Parse PRDs and enhance tasks using multiple AI providers
+- 🎭 **Interactive Workflow**: Guided setup from project init to task generation with AI assistance
 - 📦 **Multi-Purpose Package**: Use as CLI tool, library, or MCP server
 - 📁 **Project-Local Storage**: All data stored locally in `.task-o-matic/` directory
 - 🎯 **Task Management**: Full CRUD operations with AI enhancement
@@ -102,36 +103,41 @@ npm install task-o-matic
 #### Basic Example
 
 ```typescript
-import { TaskService, PRDService, type Task, type AIConfig } from 'task-o-matic';
+import {
+  TaskService,
+  PRDService,
+  type Task,
+  type AIConfig,
+} from "task-o-matic";
 
 // Initialize the service
 const taskService = new TaskService();
 
 // Create a task with AI enhancement
 const result = await taskService.createTask({
-  title: 'Implement user authentication',
-  content: 'Add login and signup functionality',
+  title: "Implement user authentication",
+  content: "Add login and signup functionality",
   aiEnhance: true,
   aiOptions: {
-    provider: 'anthropic',
-    model: 'claude-3-5-sonnet',
-    apiKey: process.env.ANTHROPIC_API_KEY
+    provider: "anthropic",
+    model: "claude-3-5-sonnet",
+    apiKey: process.env.ANTHROPIC_API_KEY,
   },
   callbacks: {
     onProgress: (event) => {
       console.log(`Progress: ${event.message}`);
-    }
-  }
+    },
+  },
 });
 
-console.log('Task created:', result.task);
+console.log("Task created:", result.task);
 ```
 
 #### TUI Integration Example
 
 ```typescript
-import { TaskService } from 'task-o-matic';
-import type { ProgressCallback } from 'task-o-matic';
+import { TaskService } from "task-o-matic";
+import type { ProgressCallback } from "task-o-matic";
 
 const taskService = new TaskService();
 
@@ -140,12 +146,12 @@ const progressCallback: ProgressCallback = {
   onProgress: (event) => {
     // Update your TUI with progress
     tuiStatusBar.update(event.message);
-  }
+  },
 };
 
 // Create task with streaming
 const result = await taskService.createTask({
-  title: 'Add payment integration',
+  title: "Add payment integration",
   aiEnhance: true,
   streamingOptions: {
     enabled: true,
@@ -154,37 +160,37 @@ const result = await taskService.createTask({
       tuiTextArea.append(chunk);
     },
     onFinish: ({ text }) => {
-      tuiStatusBar.success('Task enhanced!');
-    }
+      tuiStatusBar.success("Task enhanced!");
+    },
   },
-  callbacks: progressCallback
+  callbacks: progressCallback,
 });
 ```
 
 #### PRD Parsing Example
 
 ```typescript
-import { PRDService } from 'task-o-matic';
+import { PRDService } from "task-o-matic";
 
 const prdService = new PRDService();
 
 const result = await prdService.parsePRD({
-  file: './requirements.md',
+  file: "./requirements.md",
   workingDirectory: process.cwd(),
   aiOptions: {
-    provider: 'openrouter',
-    model: 'anthropic/claude-3.5-sonnet',
-    apiKey: process.env.OPENROUTER_API_KEY
+    provider: "openrouter",
+    model: "anthropic/claude-3.5-sonnet",
+    apiKey: process.env.OPENROUTER_API_KEY,
   },
   callbacks: {
     onProgress: (event) => {
       console.log(event.message);
-    }
-  }
+    },
+  },
 });
 
 console.log(`Created ${result.tasks.length} tasks from PRD`);
-result.tasks.forEach(task => {
+result.tasks.forEach((task) => {
   console.log(`- ${task.title}`);
 });
 ```
@@ -192,11 +198,7 @@ result.tasks.forEach(task => {
 #### Using Utility Factories
 
 ```typescript
-import {
-  getStorage,
-  getAIOperations,
-  buildAIConfig
-} from 'task-o-matic';
+import { getStorage, getAIOperations, buildAIConfig } from "task-o-matic";
 
 // Get singleton instances
 const storage = getStorage();
@@ -204,9 +206,9 @@ const aiOps = getAIOperations();
 
 // Build AI configuration
 const aiConfig = buildAIConfig({
-  provider: 'openai',
-  model: 'gpt-4',
-  apiKey: process.env.OPENAI_API_KEY
+  provider: "openai",
+  model: "gpt-4",
+  apiKey: process.env.OPENAI_API_KEY,
 });
 
 // Use storage directly
@@ -224,8 +226,8 @@ import type {
   StreamingOptions,
   CreateTaskOptions,
   PRDParseResult,
-  TaskAIMetadata
-} from 'task-o-matic';
+  TaskAIMetadata,
+} from "task-o-matic";
 ```
 
 ### CLI Usage
@@ -298,17 +300,71 @@ task-o-matic prd parse --file my-prd.md --stream
 task-o-matic tasks list
 ```
 
+### 7. Interactive Workflow (Recommended for New Projects)
+
+The interactive workflow guides you through the entire setup process:
+
+```bash
+# Start the interactive workflow
+task-o-matic workflow
+
+# With streaming AI output
+task-o-matic workflow --stream
+```
+
+**The workflow will guide you through:**
+
+1. **Project Initialization** - Choose quick start, custom, or AI-assisted configuration
+2. **PRD Definition** - Upload file, write manually, or use AI to generate from description
+3. **PRD Refinement** - Optional AI-assisted improvements
+4. **Task Generation** - Parse PRD into actionable tasks
+5. **Task Splitting** - Break down complex tasks into subtasks
+
+**AI Assistance at Every Step:**
+
+At each step, you can choose "AI-assisted" to describe your needs in natural language:
+
+```bash
+# Example AI-assisted workflow
+task-o-matic workflow --stream
+
+# Step 1: "I want to build a SaaS platform for team collaboration"
+# Step 2: "Real-time chat, file sharing, and task management features"
+# Step 3: "Add more details about authentication and security"
+# Step 4: "Focus on MVP features first"
+# Step 5: "Break tasks into 2-4 hour chunks"
+```
+
 ## 📚 Documentation
 
 - [Configuration](docs/configuration.md) - AI providers and settings
 - [Task Management](docs/tasks.md) - Full task lifecycle with AI features
 - [PRD Processing](docs/prd.md) - Parse and rework Product Requirements Documents
+- [Interactive Workflow](docs/workflow-command.md) - Guided setup with AI assistance
 - [AI Integration](docs/ai-integration.md) - AI providers and prompt engineering
 - [Project Initialization](docs/projects.md) - Project setup and bootstrapping
 - [Streaming Output](docs/streaming.md) - Real-time AI streaming capabilities
 
 ## 🎯 Common Workflows
 
+### Workflow 0: Interactive Guided Setup (Recommended)
+
+```bash
+# One command to rule them all
+task-o-matic workflow --stream
+
+# The workflow will guide you through:
+# 1. Project initialization with AI-assisted configuration
+# 2. PRD creation (manual, upload, or AI-generated)
+# 3. PRD refinement with AI feedback
+# 4. Task generation from PRD
+# 5. Complex task splitting
+
+# After completion:
+task-o-matic tasks list
+task-o-matic tasks tree
+```
+
 ### Workflow 1: From PRD to Tasks
 
 ```bash
@@ -467,15 +523,15 @@ The package is structured for both CLI and library use:
 
 ```json
 {
-  "main": "./dist/lib/index.js",          // CommonJS library entry
-  "types": "./dist/lib/index.d.ts",       // TypeScript definitions
+  "main": "./dist/lib/index.js", // CommonJS library entry
+  "types": "./dist/lib/index.d.ts", // TypeScript definitions
   "bin": {
-    "task-o-matic": "./dist/cli/bin.js",  // CLI binary
-    "task-o-matic-mcp": "./dist/mcp/server.js"  // MCP server binary
+    "task-o-matic": "./dist/cli/bin.js", // CLI binary
+    "task-o-matic-mcp": "./dist/mcp/server.js" // MCP server binary
   },
   "exports": {
-    ".": "./dist/lib/index.js",           // Main library export
-    "./types": "./dist/types/index.js"    // Type-only exports
+    ".": "./dist/lib/index.js", // Main library export
+    "./types": "./dist/types/index.js" // Type-only exports
   }
 }
 ```

package/dist/commands/tasks/create.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const createCommand: Command;
+//# sourceMappingURL=create.d.ts.map

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

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

package/dist/commands/tasks/create.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCommand = void 0;
+const commander_1 = require("commander");
+const tasks_1 = require("../../services/tasks");
+const hooks_1 = require("../../lib/hooks");
+const streaming_options_1 = require("../../utils/streaming-options");
+const progress_1 = require("../../cli/display/progress");
+const common_1 = require("../../cli/display/common");
+const task_1 = require("../../cli/display/task");
+exports.createCommand = new commander_1.Command("create")
+    .description("Create a new task with AI enhancement using Context7")
+    .requiredOption("--title <title>", "Task title")
+    .option("--content <content>", "Task content (supports markdown)")
+    .option("--effort <effort>", "Estimated effort (small/medium/large)")
+    .option("--parent-id <id>", "Parent task ID (creates subtask)")
+    .option("--ai-enhance", "Enhance task with AI using Context7 documentation")
+    .option("--stream", "Show streaming AI output during enhancement")
+    .option("--ai-provider <provider>", "AI provider override")
+    .option("--ai-model <model>", "AI model override")
+    .option("--ai-key <key>", "AI API key override")
+    .option("--ai-provider-url <url>", "AI provider URL override")
+    .option("--reasoning <tokens>", "Enable reasoning for OpenRouter models (max reasoning tokens)")
+    .action(async (options) => {
+    try {
+        const streamingOptions = (0, streaming_options_1.createStreamingOptions)(options.aiEnhance && options.stream, "Enhancement");
+        const progressHandler = (payload) => {
+            (0, progress_1.displayProgress)(payload);
+        };
+        hooks_1.hooks.on("task:progress", progressHandler);
+        try {
+            const result = await tasks_1.taskService.createTask({
+                title: options.title,
+                content: options.content,
+                parentId: options.parentId,
+                effort: options.effort,
+                aiEnhance: options.aiEnhance,
+                aiOptions: {
+                    aiProvider: options.aiProvider,
+                    aiModel: options.aiModel,
+                    aiKey: options.aiKey,
+                    aiProviderUrl: options.aiProviderUrl,
+                    aiReasoning: options.reasoning,
+                },
+                streamingOptions,
+            });
+            (0, common_1.displayEnhancementResult)(options.aiEnhance && options.stream);
+            (0, task_1.displayCreatedTask)(result.task, result.aiMetadata);
+        }
+        finally {
+            hooks_1.hooks.off("task:progress", progressHandler);
+        }
+    }
+    catch (error) {
+        (0, progress_1.displayError)(error);
+        process.exit(1);
+    }
+});

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

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const deleteCommand: Command;
+//# sourceMappingURL=delete.d.ts.map

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

@@ -0,0 +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"}

package/dist/commands/tasks/delete.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteCommand = void 0;
+const commander_1 = require("commander");
+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");
+exports.deleteCommand = new commander_1.Command("delete")
+    .description("Delete a task")
+    .requiredOption("--id <id>", "Task ID to delete")
+    .option("--force", "Skip confirmation and delete anyway")
+    .option("--cascade", "Delete all subtasks as well")
+    .action(async (options) => {
+    try {
+        if (!options.force) {
+            const task = await tasks_1.taskService.getTask(options.id);
+            if (!task) {
+                throw new Error(`Task with ID ${options.id} not found`);
+            }
+            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."));
+            // Simple confirmation - in a real CLI you might want a proper prompt
+            console.log(chalk_1.default.yellow("Use --force to confirm deletion."));
+            return;
+        }
+        const result = await tasks_1.taskService.deleteTask(options.id, {
+            cascade: options.cascade,
+            force: options.force,
+        });
+        (0, task_1.displayTaskDelete)(result.deleted, result.orphanedSubtasks);
+    }
+    catch (error) {
+        (0, progress_1.displayError)(error);
+        process.exit(1);
+    }
+});

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

@@ -0,0 +1,5 @@
+import { Command } from "commander";
+export declare const documentCommand: Command;
+export declare const getDocumentationCommand: Command;
+export declare const addDocumentationCommand: Command;
+//# sourceMappingURL=document.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,eAAO,MAAM,eAAe,SA2ExB,CAAC;AAEL,eAAO,MAAM,uBAAuB,SAgChC,CAAC;AAEL,eAAO,MAAM,uBAAuB,SA8ChC,CAAC"}

package/dist/commands/tasks/document.js

@@ -0,0 +1,118 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addDocumentationCommand = exports.getDocumentationCommand = exports.documentCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const tasks_1 = require("../../services/tasks");
+const hooks_1 = require("../../lib/hooks");
+const streaming_options_1 = require("../../utils/streaming-options");
+const progress_1 = require("../../cli/display/progress");
+const common_1 = require("../../cli/display/common");
+exports.documentCommand = new commander_1.Command("document")
+    .description("Analyze and fetch documentation for a task using AI with Context7")
+    .requiredOption("--task-id <id>", "Task ID")
+    .option("--force", "Force refresh documentation even if recent")
+    .option("--stream", "Show streaming AI output during analysis")
+    .option("--ai-provider <provider>", "AI provider override")
+    .option("--ai-model <model>", "AI model override")
+    .option("--ai-key <key>", "AI API key override")
+    .option("--ai-provider-url <url>", "AI provider URL override")
+    .option("--reasoning <tokens>", "Enable reasoning for OpenRouter models (max reasoning tokens)")
+    .action(async (options) => {
+    try {
+        const streamingOptions = (0, streaming_options_1.createStreamingOptions)(options.stream, "Analysis");
+        const progressHandler = (payload) => {
+            (0, progress_1.displayProgress)(payload);
+        };
+        hooks_1.hooks.on("task:progress", progressHandler);
+        try {
+            const result = await tasks_1.taskService.documentTask(options.taskId, options.force, {
+                aiProvider: options.aiProvider,
+                aiModel: options.aiModel,
+                aiKey: options.aiKey,
+                aiProviderUrl: options.aiProviderUrl,
+                aiReasoning: options.reasoning,
+            }, streamingOptions);
+            if (result.documentation && !options.force) {
+                const daysSinceFetch = (Date.now() - result.documentation.lastFetched) /
+                    (24 * 60 * 60 * 1000);
+                console.log(chalk_1.default.green(`✓ Documentation is fresh (${Math.round(daysSinceFetch)} days old)`));
+                console.log(chalk_1.default.cyan(`Recap: ${result.documentation.recap}`));
+                console.log(chalk_1.default.blue(`Libraries: ${result.documentation.libraries.join(", ")}`));
+                return;
+            }
+            if (result.analysis) {
+                (0, common_1.displayDocumentationAnalysis)(result.analysis);
+            }
+            if (result.documentation?.research) {
+                (0, common_1.displayResearchSummary)(result.documentation);
+            }
+        }
+        finally {
+            hooks_1.hooks.off("task:progress", progressHandler);
+        }
+    }
+    catch (error) {
+        (0, progress_1.displayError)(error);
+        process.exit(1);
+    }
+});
+exports.getDocumentationCommand = new commander_1.Command("get-documentation")
+    .description("Get existing documentation for a task")
+    .requiredOption("--id <id>", "Task ID")
+    .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`);
+        }
+        const documentation = await tasks_1.taskService.getTaskDocumentation(options.id);
+        if (!documentation) {
+            console.log(chalk_1.default.yellow(`⚠️  No documentation found for task ${options.id}`));
+            console.log(chalk_1.default.gray(`   Task: ${task.title}`));
+            return;
+        }
+        console.log(chalk_1.default.blue(`\n📖 Documentation for Task: ${task.title} (${options.id})`));
+        console.log(chalk_1.default.gray(`   File: .task-o-matic/docs/tasks/${options.id}.md`));
+        console.log("");
+        console.log(documentation);
+    }
+    catch (error) {
+        (0, progress_1.displayError)(error);
+        process.exit(1);
+    }
+});
+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")
+    .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`);
+        }
+        // Check if documentation already exists
+        const existingDoc = await tasks_1.taskService.getTaskDocumentation(options.id);
+        if (existingDoc && !options.overwrite) {
+            console.log(chalk_1.default.yellow(`⚠️  Documentation already exists for task ${options.id}`));
+            console.log(chalk_1.default.gray(`   Use --overwrite to replace existing documentation`));
+            return;
+        }
+        const result = await tasks_1.taskService.addTaskDocumentationFromFile(options.id, options.docFile);
+        console.log(chalk_1.default.green(`✓ Documentation added to task: ${task.title} (${options.id})`));
+        console.log(chalk_1.default.gray(`   Source file: ${options.docFile}`));
+        console.log(chalk_1.default.gray(`   Saved to: ${result.filePath}`));
+        if (options.overwrite) {
+            console.log(chalk_1.default.cyan(`   Previous documentation was overwritten`));
+        }
+    }
+    catch (error) {
+        (0, progress_1.displayError)(error);
+        process.exit(1);
+    }
+});

package/dist/commands/tasks/enhance.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const enhanceCommand: Command;
+//# sourceMappingURL=enhance.d.ts.map

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

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

package/dist/commands/tasks/enhance.js

@@ -0,0 +1,86 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enhanceCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const tasks_1 = require("../../services/tasks");
+const hooks_1 = require("../../lib/hooks");
+const streaming_options_1 = require("../../utils/streaming-options");
+const progress_1 = require("../../cli/display/progress");
+exports.enhanceCommand = new commander_1.Command("enhance")
+    .description("Enhance an existing task with AI using Context7 documentation")
+    .option("--task-id <id>", "Task ID to enhance")
+    .option("--all", "Enhance all existing tasks")
+    .option("--stream", "Show streaming AI output during enhancement")
+    .option("--ai-provider <provider>", "AI provider override")
+    .option("--ai-model <model>", "AI model override")
+    .option("--ai-key <key>", "AI API key override")
+    .option("--ai-provider-url <url>", "AI provider URL override")
+    .option("--reasoning <tokens>", "Enable reasoning for OpenRouter models (max reasoning tokens)")
+    .action(async (options) => {
+    try {
+        if (!options.taskId && !options.all) {
+            throw new Error("Either --task-id or --all must be specified");
+        }
+        if (options.taskId && options.all) {
+            throw new Error("Cannot specify both --task-id and --all");
+        }
+        const enhanceSingleTask = async (taskId) => {
+            const streamingOptions = (0, streaming_options_1.createStreamingOptions)(options.stream, "Enhancement");
+            const progressHandler = (payload) => {
+                (0, progress_1.displayProgress)(payload);
+            };
+            hooks_1.hooks.on("task:progress", progressHandler);
+            try {
+                const result = await tasks_1.taskService.enhanceTask(taskId, {
+                    aiProvider: options.aiProvider,
+                    aiModel: options.aiModel,
+                    aiKey: options.aiKey,
+                    aiProviderUrl: options.aiProviderUrl,
+                    aiReasoning: options.reasoning,
+                }, streamingOptions);
+                if (result.enhancedContent.length > 200) {
+                    console.log(chalk_1.default.cyan(`  Enhanced content saved to file.`));
+                }
+                else {
+                    console.log(chalk_1.default.cyan(`  Enhanced content updated in task description.`));
+                }
+                console.log(chalk_1.default.green("✓ Task enhanced with Context7 documentation"));
+                console.log(chalk_1.default.magenta(`  🤖 Enhanced using Context7 MCP tools`));
+            }
+            finally {
+                hooks_1.hooks.off("task:progress", progressHandler);
+            }
+        };
+        if (options.taskId) {
+            await enhanceSingleTask(options.taskId);
+        }
+        else if (options.all) {
+            const allTasks = await tasks_1.taskService.listTasks({});
+            if (allTasks.length === 0) {
+                console.log(chalk_1.default.yellow("No tasks found to enhance."));
+                return;
+            }
+            console.log(chalk_1.default.blue(`🤖 Enhancing ${allTasks.length} tasks in order...`));
+            for (let i = 0; i < allTasks.length; i++) {
+                const task = allTasks[i];
+                console.log(chalk_1.default.cyan(`\n[${i + 1}/${allTasks.length}] Enhancing: ${task.title} (${task.id})`));
+                try {
+                    await enhanceSingleTask(task.id);
+                    console.log(chalk_1.default.green(`✓ Enhanced task ${task.id}`));
+                }
+                catch (error) {
+                    console.log(chalk_1.default.red(`❌ Failed to enhance task ${task.id}: ${error instanceof Error ? error.message : "Unknown error"}`));
+                }
+            }
+            console.log(chalk_1.default.green(`\n✓ Bulk enhancement complete! Processed ${allTasks.length} tasks.`));
+        }
+    }
+    catch (error) {
+        (0, progress_1.displayError)(error);
+        process.exit(1);
+    }
+});

package/dist/commands/tasks/execute.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const executeCommand: Command;
+//# sourceMappingURL=execute.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/execute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,cAAc,SAoCvB,CAAC"}

package/dist/commands/tasks/execute.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const task_execution_1 = require("../../lib/task-execution");
+exports.executeCommand = new commander_1.Command("execute")
+    .description("Execute a task using an external coding assistant")
+    .requiredOption("--id <id>", "Task ID to execute")
+    .option("--tool <tool>", "External tool to use (opencode/claude/gemini/codex)", "opencode")
+    .option("--message <message>", "Custom message to send to the tool (uses task plan if not provided)")
+    .option("--dry", "Show what would be executed without running it")
+    .option("--validate <command>", "Validation command to run after execution (can be used multiple times)", (value, previous = []) => {
+    return [...previous, value];
+})
+    .action(async (options) => {
+    try {
+        await (0, task_execution_1.executeTask)({
+            taskId: options.id,
+            tool: options.tool,
+            message: options.message,
+            dry: options.dry,
+            validate: options.validate || [],
+        });
+    }
+    catch (error) {
+        console.error(chalk_1.default.red("Execution failed:"), error instanceof Error ? error.message : "Unknown error");
+        process.exit(1);
+    }
+});

package/dist/commands/tasks/index.d.ts

@@ -0,0 +1,16 @@
+export * from "./list";
+export * from "./create";
+export * from "./show";
+export * from "./update";
+export * from "./delete";
+export * from "./status";
+export * from "./tags";
+export * from "./plan";
+export * from "./enhance";
+export * from "./split";
+export * from "./document";
+export * from "./execute";
+export * from "./subtasks";
+export * from "./tree";
+export * from "./next";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC"}