task-o-matic 0.0.2 → 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/prd.js

@@ -24,6 +24,7 @@ exports.prdCommand
     .option("--ai-provider-url <url>", "AI provider URL override")
     .option("--ai-reasoning <tokens>", "Enable reasoning for OpenRouter models (max reasoning tokens)")
     .option("--stream", "Show streaming AI output during parsing")
+    .option("--tools", "Enable filesystem tools for project analysis")
     .action(async (options) => {
     try {
         // Determine working directory from current process location
@@ -33,6 +34,7 @@ exports.prdCommand
         const result = await prd_1.prdService.parsePRD({
             file: options.file,
             workingDirectory, // Pass working directory explicitly to service
+            enableFilesystemTools: options.tools,
             aiOptions: {
                 aiProvider: options.aiProvider,
                 aiModel: options.aiModel,
@@ -94,6 +96,7 @@ exports.prdCommand
     .option("--ai-provider-url <url>", "AI provider URL override")
     .option("--ai-reasoning <tokens>", "Enable reasoning for OpenRouter models (max reasoning tokens)")
     .option("--stream", "Show streaming AI output during rework")
+    .option("--tools", "Enable filesystem tools for project analysis")
     .action(async (options) => {
     try {
         // Determine working directory from current process location
@@ -105,6 +108,7 @@ exports.prdCommand
             feedback: options.feedback,
             output: options.output,
             workingDirectory, // Pass working directory explicitly to service
+            enableFilesystemTools: options.tools,
             aiOptions: {
                 aiProvider: options.aiProvider,
                 aiModel: options.aiModel,

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

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/commands/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBpC,eAAO,MAAM,aAAa,SAkOtB,CAAC"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/commands/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBpC,eAAO,MAAM,aAAa,SAyPtB,CAAC"}

package/dist/commands/prompt.js

@@ -21,6 +21,8 @@ exports.promptCommand = new commander_1.Command("prompt")
     .option("--var <key=value>", "Custom variable in format key=value (can be used multiple times)", (value, previous = []) => {
     return [...previous, value];
 }, [])
+    .option("--full-context", "Include comprehensive project context (file structure, dependencies, etc.)", false)
+    .option("--executor <type>", "Format output for specific executor: opencode, claude, gemini, codex")
     .action(async (name, options) => {
     try {
         // Handle list option
@@ -55,91 +57,92 @@ exports.promptCommand = new commander_1.Command("prompt")
             console.error('Error: --type must be either "system" or "user"');
             (0, process_1.exit)(1);
         }
-        // Build variables object
+        // Build variables object with AUTOMATIC DETECTION FIRST (like all other commands)
         const variables = {};
-        // Parse custom variables (--var key=value)
-        if (options.var) {
-            for (const varPair of options.var) {
-                const [key, ...valueParts] = varPair.split("=");
-                if (!key || valueParts.length === 0) {
-                    console.error(`Error: Invalid variable format: ${varPair}. Expected format: key=value`);
-                    (0, process_1.exit)(1);
-                }
-                variables[key] = valueParts.join("=");
-            }
-        }
-        // Handle PRD content
-        let prdContent = options.prdContent;
+        // STEP 1: AUTO-DETECT EVERYTHING (default behavior)
+        // Auto-detect PRD content ALWAYS
+        const autoPrdContent = await prompt_builder_1.PromptBuilder.autoDetectPRDContent();
+        if (autoPrdContent) {
+            variables.PRD_CONTENT = autoPrdContent;
+        }
+        // Auto-detect stack info ALWAYS
+        const autoStackInfo = await prompt_builder_1.PromptBuilder.detectStackInfo(process.cwd());
+        if (autoStackInfo !== "Not detected") {
+            variables.STACK_INFO = autoStackInfo;
+        }
+        // STEP 2: OVERRIDE with explicit options if provided
+        // Override PRD if explicitly provided
         if (options.prdFile) {
-            prdContent = prompt_builder_1.PromptBuilder.loadPRDContent(options.prdFile);
+            variables.PRD_CONTENT = prompt_builder_1.PromptBuilder.loadPRDContent(options.prdFile);
         }
-        if (prdContent) {
-            variables.PRD_CONTENT = prdContent;
+        else if (options.prdContent) {
+            variables.PRD_CONTENT = options.prdContent;
         }
-        else if (!prdContent && !variables.PRD_CONTENT) {
-            // Auto-detect PRD content if not provided
-            prdContent = await prompt_builder_1.PromptBuilder.autoDetectPRDContent();
-            if (prdContent) {
-                variables.PRD_CONTENT = prdContent;
-            }
+        // Override stack if explicitly provided
+        if (options.stackInfo) {
+            variables.STACK_INFO = options.stackInfo;
         }
         // Handle task information
-        let taskDescription = options.taskDescription;
-        if (options.taskFile) {
-            taskDescription = await prompt_builder_1.PromptBuilder.buildTaskContext("", "", options.taskFile);
-        }
         if (options.taskTitle) {
             variables.TASK_TITLE = options.taskTitle;
         }
-        if (taskDescription) {
-            variables.TASK_DESCRIPTION = taskDescription;
+        if (options.taskFile) {
+            variables.TASK_DESCRIPTION = await prompt_builder_1.PromptBuilder.buildTaskContext(options.taskTitle || "", "", options.taskFile);
+        }
+        else if (options.taskDescription) {
+            variables.TASK_DESCRIPTION = options.taskDescription;
         }
-        // If we have both title and description, build rich context
+        // Build rich task context if we have title and description
         if (options.taskTitle && (options.taskDescription || options.taskFile)) {
-            const richContext = await prompt_builder_1.PromptBuilder.buildTaskContext(options.taskTitle, options.taskDescription, options.taskFile);
-            variables.TASK_CONTEXT = richContext;
+            variables.TASK_CONTEXT = await prompt_builder_1.PromptBuilder.buildTaskContext(options.taskTitle, options.taskDescription, options.taskFile);
         }
-        // Handle stack info (don't auto-detect if custom var provided)
-        if (options.stackInfo) {
-            variables.STACK_INFO = options.stackInfo;
+        // Handle user feedback
+        if (options.userFeedback) {
+            variables.USER_FEEDBACK = options.userFeedback;
         }
-        else if (!variables.STACK_INFO) {
-            // Auto-detect stack info from current directory
-            const stackInfo = await prompt_builder_1.PromptBuilder.detectStackInfo(process.cwd());
-            if (stackInfo !== "Not detected") {
-                variables.STACK_INFO = stackInfo;
+        // Build comprehensive CONTEXT_INFO (combining everything)
+        const contextParts = [];
+        // Add stack info if available
+        if (variables.STACK_INFO) {
+            contextParts.push(`**Technology Stack:** ${variables.STACK_INFO}`);
+        }
+        // Add PRD content if available
+        if (variables.PRD_CONTENT) {
+            contextParts.push(`**Product Requirements:**\n${variables.PRD_CONTENT}`);
+        }
+        // Add full context if requested
+        if (options.fullContext) {
+            const fullContext = await prompt_builder_1.PromptBuilder.buildFullProjectContext(process.cwd());
+            if (fullContext) {
+                contextParts.push(fullContext);
             }
         }
-        // Build CONTEXT_INFO from stack and PRD if not explicitly provided
-        if (!options.contextInfo && !variables.CONTEXT_INFO) {
-            const contextParts = [];
-            // Add stack info if available
-            if (variables.STACK_INFO) {
-                contextParts.push(`**Technology Stack:** ${variables.STACK_INFO}`);
-            }
-            // Add PRD content if available
-            if (variables.PRD_CONTENT) {
-                contextParts.push(`**Product Requirements:**\n${variables.PRD_CONTENT}`);
-            }
-            // Set combined context info
-            if (contextParts.length > 0) {
-                variables.CONTEXT_INFO = contextParts.join('\n\n');
-            }
+        // Set combined context info
+        if (contextParts.length > 0) {
+            variables.CONTEXT_INFO = contextParts.join('\n\n');
         }
-        // Handle other variables
+        // Override context info if explicitly provided
         if (options.contextInfo) {
             variables.CONTEXT_INFO = options.contextInfo;
         }
-        if (options.userFeedback) {
-            variables.USER_FEEDBACK = options.userFeedback;
+        // STEP 3: FINAL OVERRIDE with custom --var variables (highest priority)
+        if (options.var) {
+            for (const varPair of options.var) {
+                const [key, ...valueParts] = varPair.split("=");
+                if (!key || valueParts.length === 0) {
+                    console.error(`Error: Invalid variable format: ${varPair}. Expected format: key=value`);
+                    (0, process_1.exit)(1);
+                }
+                variables[key] = valueParts.join("=");
+            }
         }
         // Build the prompt
         const result = prompt_builder_1.PromptBuilder.buildPrompt({
-            name,
+            name: name, // name is checked above, will not be undefined here
             type: options.type,
             variables,
         });
-        if (!result.success) {
+        if (!result.success || !result.prompt) {
             console.error(`Error: ${result.error}`);
             if (result.missingVariables && result.missingVariables.length > 0) {
                 console.error("\nMissing required variables:");
@@ -159,8 +162,13 @@ exports.promptCommand = new commander_1.Command("prompt")
             }
             (0, process_1.exit)(1);
         }
+        // Format output based on executor if specified
+        let outputPrompt = result.prompt;
+        if (options.executor) {
+            outputPrompt = prompt_builder_1.PromptBuilder.formatForExecutor(result.prompt, options.executor);
+        }
         // Output the built prompt
-        console.log(result.prompt);
+        console.log(outputPrompt);
     }
     catch (error) {
         console.error(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);

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"}