task-o-matic 0.0.12 → 0.0.14

package/docs/agents/cli.md

@@ -1,191 +1,100 @@
-# Task-O-Matic CLI Agent Guide
+# Task-O-Matic Agent Guide
 
-You are an AI agent with access to the Task-O-Matic CLI tool for managing development tasks. This guide provides comprehensive usage patterns and command reference for autonomous development workflows.
+Concise reference for AI agents using Task-O-Matic in autonomous workflows.
 
-## Core Commands Reference
+## Core Workflow Commands
 
 ### Task Management
-```bash
-# Get next task to work on (prioritizes subtasks over parent tasks)
-task-o-matic tasks get-next [--status todo] [--tag <tag>] [--effort <small|medium|large>]
-
-# Show detailed task information  
-task-o-matic tasks show --id <task-id>
-
-# Update task status
-task-o-matic tasks status --id <task-id> --status <todo|in-progress|completed>
-
-# List all tasks with optional filtering
-task-o-matic tasks list [--status <status>] [--tag <tag>]
-
-# Create new tasks
-task-o-matic tasks create --title "Task Title" [--content "Description"] [--effort <small|medium|large>] [--parent-id <id>] [--ai-enhance] [--stream]
-
-# Split tasks into subtasks using AI
-task-o-matic tasks split --task-id <id> [--tools] [--stream] [--ai-provider <provider>]
-
-# Update task details
-task-o-matic tasks update --id <task-id> [--title "New Title"] [--description "New Description"] [--status <status>] [--effort <effort>]
-
-# Delete tasks
-task-o-matic tasks delete --id <task-id> --force [--cascade]
-```
-
-### Planning & Documentation
-```bash
-# Generate AI implementation plans for tasks
-task-o-matic tasks plan --id <task-id> [--stream] [--ai-provider <provider>]
-
-# View existing implementation plans
-task-o-matic tasks get-plan --id <task-id>
-
-# Set manual implementation plan
-task-o-matic tasks set-plan --id <task-id> --plan "Plan text" [or --plan-file <path>]
-
-# Generate AI task documentation with project context
-task-o-matic tasks document --task-id <task-id> [--force] [--stream] [--ai-provider <provider>]
-
-# Get existing task documentation
-task-o-matic tasks get-documentation --id <task-id>
 
-# Add documentation from external file
-task-o-matic tasks add-documentation --id <task-id> --doc-file <path> [--overwrite]
-```
-
-### PRD Management
 ```bash
-# Parse PRD into structured tasks
-task-o-matic prd parse --file <prd-file> [--tools] [--stream] [--ai-provider <provider>]
+# List tasks (filter by status or tag)
+task-o-matic tasks list [-s <status>] [-t <tag>]
 
-# Improve PRD based on feedback
-task-o-matic prd rework --file <prd-file> --feedback "Feedback text" [--tools] [--output <output-file>] [--stream]
-```
+# Get next task to work on (prioritizes subtasks)
+task-o-matic tasks get-next [-s <status>] [-t <tag>]
 
-### Project Initialization
-```bash
-# Initialize task-o-matic in current directory
-task-o-matic init init
+# Update task status
+task-o-matic tasks status -i <task-id> -s <todo|in-progress|completed>
 
-# Configure AI providers
-task-o-matic config set --provider <openai|anthropic|openrouter> --model <model-name> [--api-key <key>]
+# Add documentation from file
+task-o-matic tasks add-documentation -i <task-id> --doc-file <path>
 ```
 
-## Autonomous Development Workflow
+## Typical Agent Workflow
 
-### Primary Work Loop
 ```bash
-# 1. Get next available task (subtasks have priority)
-TASK_ID=$(task-o-matic tasks get-next --status todo | grep -oE '[a-f0-9-]{36}')
-
-# 2. Show task details and mark as in-progress
-task-o-matic tasks show --id $TASK_ID
-task-o-matic tasks status --id $TASK_ID --status in-progress
-
-# 3. Generate implementation plan with project context
-task-o-matic tasks plan --id $TASK_ID --stream
-
-# 4. Check for existing documentation or create it
-task-o-matic tasks get-documentation --id $TASK_ID || \
-task-o-matic tasks document --task-id $TASK_ID --stream
+# 1. Get next task
+TASK=$(task-o-matic tasks get-next -s todo)
 
-# 5. Execute implementation (use your development tools)
-# - Read project files using filesystem access
-# - Implement code changes
-# - Add tests if needed
+# 2. Mark as in-progress
+task-o-matic tasks status -i $TASK_ID -s in-progress
 
-# 6. Validate implementation
-npm run check-types    # Fix any type errors
-npm run build         # Fix any build errors  
-npm test             # Fix any test failures
+# 3. Implement the task
+# (use your development tools)
 
-# 7. Commit changes with descriptive message
-git add .
-git commit -m "$(task-o-matic tasks show --id $TASK_ID | grep Title | cut -d: -f2-) - completed"
+# 4. Validate
+npm run check-types && npm run build && npm test
 
-# 8. Mark task as completed
-task-o-matic tasks status --id $TASK_ID --status completed
+# 5. Mark as completed
+task-o-matic tasks status -i $TASK_ID -s completed
 
-# 9. Repeat - get next task
-task-o-matic tasks get-next
+# 6. Repeat
 ```
 
-## Advanced Features
+## Bootstrap Options
 
-### AI-Enhanced Operations
-Use `--tools` flag to enable filesystem tools for AI operations:
+### Web Projects
 ```bash
-# Parse PRD with project context awareness
-task-o-matic prd parse --file prd.md --tools --stream
-
-# Split tasks with understanding of current codebase
-task-o-matic tasks split --task-id <id> --tools --stream
-
-# Rework PRD considering current implementation
-task-o-matic prd rework --file prd.md --feedback "Add auth" --tools --stream
+task-o-matic init init --project-name my-app --frontend next --backend hono
 ```
 
-### Getting Help
+### Multi-Frontend Monorepo
 ```bash
-# Get help for main commands
-task-o-matic --help
+# Web + Native + CLI + TUI
+task-o-matic init init --project-name my-app --frontend "next native-uniwind cli tui" --backend hono
 
-# Get help for specific command groups
-task-o-matic tasks --help
-task-o-matic prd --help
-task-o-matic config --help
+# Web + Native
+task-o-matic init init --project-name my-app --frontend "next native-bare" --backend hono
 
-# Get help for specific commands
-task-o-matic tasks create --help
-task-o-matic tasks split --help
+# Web + CLI
+task-o-matic init init --project-name my-app --frontend "next cli" --backend hono
 ```
 
-### AI Provider Configuration
+### Single Frontend Projects
 ```bash
-# Configure different AI providers
-task-o-matic config set --provider openai --model gpt-4 --api-key <your-key>
-task-o-matic config set --provider anthropic --model claude-3-sonnet-20240229 --api-key <your-key>
-task-o-matic config set --provider openrouter --model anthropic/claude-3.5-sonnet --api-key <your-key>
+# CLI only
+task-o-matic init init --project-name my-cli --frontend cli --cli-deps full
 
-# Use different providers per command
-task-o-matic tasks plan --id <task-id> --ai-provider anthropic --ai-model claude-3-sonnet-20240229
-```
+# TUI only
+task-o-matic init init --project-name my-tui --frontend tui --tui-framework solid
 
-## Best Practices for AI Agents
+# Native only
+task-o-matic init init --project-name my-mobile --frontend native-uniwind --backend hono
+```
 
-### Task Prioritization
-1. **Always work on subtasks first** - `get-next` automatically prioritizes them
-2. **Mark parent tasks as in-progress** when starting their subtasks
-3. **Complete subtasks before marking parent as complete**
+### Frontend Options
+- **Web**: next, tanstack-router, react-router, nuxt, svelte, solid
+- **Native**: native-bare, native-uniwind, native-unistyles
+- **Custom**: cli, tui
 
-### Quality Assurance
-1. **Always validate before completion**: type-check → build → test → commit
-2. **Use streaming output** (`--stream`) to monitor AI operations in real-time
-3. **Enable filesystem tools** (`--tools`) when context awareness is beneficial
+### CLI Dependency Levels
+- **minimal**: commander + chalk only
+- **standard**: + inquirer + dotenv (default)
+- **full**: + mocha + tsx (testing)
+- **task-o-matic**: + AI SDK (Vercel AI)
 
-### Error Recovery
-- **Type errors**: Fix immediately, re-run `npm run check-types`
-- **Build errors**: Fix immediately, re-run `npm run build`  
-- **Test failures**: Fix immediately, re-run `npm test`
-- **Task confusion**: Use `task-o-matic tasks show --id <id>` for clarification
+### TUI Framework Options
+- **solid**: Solid.js (default, recommended)
+- **vue**: Vue.js
+- **react**: React
 
-### Continuous Development
-- **Never stop the loop**: Immediately get next task after completing current one
-- **Maintain clean git history**: One commit per completed task
-- **Use descriptive commit messages**: Include task title and completion status
-- **Leverage AI enhancements**: Use `--ai-enhance`, `--tools`, and `--stream` flags appropriately
+## Getting Help
 
-## Command Discovery
-When you need to discover available commands or options:
+All commands support `--help`:
 ```bash
-# Explore available commands
 task-o-matic --help
-
-# Explore command groups  
 task-o-matic tasks --help
-task-o-matic prd --help
-
-# Get detailed help for specific commands
-task-o-matic tasks [command] --help
+task-o-matic tasks list --help
 ```
 
-This comprehensive reference enables autonomous AI agents to effectively use Task-O-Matic CLI for continuous development workflows with proper task management, planning, documentation, and quality assurance.
+Full command reference: `docs/task-o-matic_help.md`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "task-o-matic",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "description": "AI-powered task management CLI",
   "keywords": [
     "task-management",

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

@@ -1,5 +0,0 @@
-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

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

@@ -1,118 +0,0 @@
-"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/plan.d.ts

@@ -1,7 +0,0 @@
-import { Command } from "commander";
-export declare const planCommand: Command;
-export declare const getPlanCommand: Command;
-export declare const listPlanCommand: Command;
-export declare const deletePlanCommand: Command;
-export declare const setPlanCommand: Command;
-//# sourceMappingURL=plan.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,eAAO,MAAM,WAAW,SA+CpB,CAAC;AAEL,eAAO,MAAM,cAAc,SA4BvB,CAAC;AAEL,eAAO,MAAM,eAAe,SAsBxB,CAAC;AAEL,eAAO,MAAM,iBAAiB,SAW1B,CAAC;AAEL,eAAO,MAAM,cAAc,SAsCvB,CAAC"}

package/dist/commands/tasks/plan.js

@@ -1,131 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setPlanCommand = exports.deletePlanCommand = exports.listPlanCommand = exports.getPlanCommand = exports.planCommand = 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 plan_1 = require("../../cli/display/plan");
-exports.planCommand = new commander_1.Command("plan")
-    .description("Create detailed implementation plan for a task or subtask")
-    .requiredOption("--id <id>", "Task or subtask ID to plan")
-    .option("--stream", "Show streaming AI output during planning")
-    .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, "Planning");
-        const progressHandler = (payload) => {
-            (0, progress_1.displayProgress)(payload);
-        };
-        hooks_1.hooks.on("task:progress", progressHandler);
-        try {
-            const result = await tasks_1.taskService.planTask(options.id, {
-                aiProvider: options.aiProvider,
-                aiModel: options.aiModel,
-                aiKey: options.aiKey,
-                aiProviderUrl: options.aiProviderUrl,
-                aiReasoning: options.reasoning,
-            }, streamingOptions);
-            // Display the plan
-            (0, plan_1.displayPlanCreation)(options.id, result.task.title);
-            console.log(chalk_1.default.cyan(result.plan));
-        }
-        finally {
-            hooks_1.hooks.off("task:progress", progressHandler);
-        }
-    }
-    catch (error) {
-        (0, progress_1.displayError)(error);
-        process.exit(1);
-    }
-});
-exports.getPlanCommand = new commander_1.Command("get-plan")
-    .description("View existing implementation plan for a task or subtask")
-    .requiredOption("--id <id>", "Task or subtask ID")
-    .action(async (options) => {
-    try {
-        const plan = await tasks_1.taskService.getTaskPlan(options.id);
-        if (!plan) {
-            console.log(chalk_1.default.yellow(`⚠️  No plan found for task/subtask ${options.id}`));
-            return;
-        }
-        const task = await tasks_1.taskService.getTask(options.id);
-        const taskTitle = task ? task.title : options.id;
-        (0, plan_1.displayPlanView)(taskTitle, options.id, plan.plan, plan.createdAt, plan.updatedAt);
-    }
-    catch (error) {
-        (0, progress_1.displayError)(error);
-        process.exit(1);
-    }
-});
-exports.listPlanCommand = new commander_1.Command("list-plan")
-    .description("List all available implementation plans")
-    .action(async () => {
-    try {
-        const plans = await tasks_1.taskService.listTaskPlans();
-        // Get task titles for each plan
-        const plansWithTitles = await Promise.all(plans.map(async (plan) => {
-            const task = await tasks_1.taskService.getTask(plan.taskId);
-            return {
-                ...plan,
-                taskTitle: task ? task.title : plan.taskId,
-            };
-        }));
-        (0, plan_1.displayPlanList)(plansWithTitles);
-    }
-    catch (error) {
-        (0, progress_1.displayError)(error);
-        process.exit(1);
-    }
-});
-exports.deletePlanCommand = new commander_1.Command("delete-plan")
-    .description("Delete implementation plan for a task")
-    .requiredOption("--id <id>", "Task ID")
-    .action(async (options) => {
-    try {
-        const success = await tasks_1.taskService.deleteTaskPlan(options.id);
-        (0, plan_1.displayPlanDeletion)(options.id, success);
-    }
-    catch (error) {
-        (0, progress_1.displayError)(error);
-        process.exit(1);
-    }
-});
-exports.setPlanCommand = new commander_1.Command("set-plan")
-    .description("Set implementation plan for a task")
-    .requiredOption("--id <id>", "Task ID")
-    .option("--plan <text>", "Plan text (use quotes for multi-line)")
-    .option("--plan-file <path>", "Path to file containing the plan")
-    .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`);
-        }
-        if (!options.plan && !options.planFile) {
-            throw new Error("Either --plan or --plan-file must be specified");
-        }
-        if (options.plan && options.planFile) {
-            throw new Error("Cannot specify both --plan and --plan-file");
-        }
-        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})`));
-        console.log(chalk_1.default.gray(`   Plan file: ${result.planFile}`));
-        if (options.planFile) {
-            console.log(chalk_1.default.gray(`   Source file: ${options.planFile}`));
-        }
-    }
-    catch (error) {
-        (0, progress_1.displayError)(error);
-        process.exit(1);
-    }
-});