task-o-matic 0.0.12 → 0.0.13

package/dist/utils/model-executor-parser.d.ts

@@ -0,0 +1,38 @@
+import { ExecutorTool, ModelAttemptConfig } from "../types";
+/**
+ * Valid executor tools
+ */
+export declare const VALID_EXECUTORS: ExecutorTool[];
+/**
+ * Parse --try-models option into ModelAttemptConfig array
+ * Supports formats:
+ * - "model1,model2,model3" - just models (uses default executor)
+ * - "opencode:gpt-4o,claude:sonnet-4" - executor:model format
+ * - Mixed: "gpt-4o,claude:sonnet-4,gemini:gemini-2.0"
+ *
+ * @param value - Comma-separated model/executor specifications
+ * @returns Array of model attempt configurations
+ * @throws Error if an invalid executor is specified
+ *
+ * @example
+ * ```typescript
+ * parseTryModels("gpt-4o-mini,gpt-4o"); // [{ model: "gpt-4o-mini" }, { model: "gpt-4o" }]
+ * parseTryModels("opencode:gpt-4o,claude:sonnet-4"); // [{ executor: "opencode", model: "gpt-4o" }, ...]
+ * ```
+ */
+export declare function parseTryModels(value: string): ModelAttemptConfig[];
+/**
+ * Validate that an executor name is valid
+ *
+ * @param executor - Executor name to validate
+ * @returns Type guard confirming executor is valid
+ *
+ * @example
+ * ```typescript
+ * if (validateExecutor(options.tool)) {
+ *   // TypeScript knows options.tool is ExecutorTool
+ * }
+ * ```
+ */
+export declare function validateExecutor(executor: string): executor is ExecutorTool;
+//# sourceMappingURL=model-executor-parser.d.ts.map

package/dist/utils/model-executor-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-executor-parser.d.ts","sourceRoot":"","sources":["../../src/utils/model-executor-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,YAAY,EAKzC,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,EAAE,CA2BlE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,IAAI,YAAY,CAE3E"}

package/dist/utils/model-executor-parser.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_EXECUTORS = void 0;
+exports.parseTryModels = parseTryModels;
+exports.validateExecutor = validateExecutor;
+/**
+ * Valid executor tools
+ */
+exports.VALID_EXECUTORS = [
+    "opencode",
+    "claude",
+    "gemini",
+    "codex",
+];
+/**
+ * Parse --try-models option into ModelAttemptConfig array
+ * Supports formats:
+ * - "model1,model2,model3" - just models (uses default executor)
+ * - "opencode:gpt-4o,claude:sonnet-4" - executor:model format
+ * - Mixed: "gpt-4o,claude:sonnet-4,gemini:gemini-2.0"
+ *
+ * @param value - Comma-separated model/executor specifications
+ * @returns Array of model attempt configurations
+ * @throws Error if an invalid executor is specified
+ *
+ * @example
+ * ```typescript
+ * parseTryModels("gpt-4o-mini,gpt-4o"); // [{ model: "gpt-4o-mini" }, { model: "gpt-4o" }]
+ * parseTryModels("opencode:gpt-4o,claude:sonnet-4"); // [{ executor: "opencode", model: "gpt-4o" }, ...]
+ * ```
+ */
+function parseTryModels(value) {
+    return value.split(",").map((item) => {
+        const trimmed = item.trim();
+        // Check if it includes executor specification (executor:model format)
+        if (trimmed.includes(":")) {
+            const [executor, model] = trimmed.split(":");
+            if (!exports.VALID_EXECUTORS.includes(executor)) {
+                throw new Error(`Invalid executor "${executor}" in --try-models. Must be one of: ${exports.VALID_EXECUTORS.join(", ")}`);
+            }
+            return {
+                executor: executor,
+                model: model.trim(),
+            };
+        }
+        // Just a model name - use default executor
+        return {
+            model: trimmed,
+        };
+    });
+}
+/**
+ * Validate that an executor name is valid
+ *
+ * @param executor - Executor name to validate
+ * @returns Type guard confirming executor is valid
+ *
+ * @example
+ * ```typescript
+ * if (validateExecutor(options.tool)) {
+ *   // TypeScript knows options.tool is ExecutorTool
+ * }
+ * ```
+ */
+function validateExecutor(executor) {
+    return exports.VALID_EXECUTORS.includes(executor);
+}

package/dist/utils/progress-tracking.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Progress event payload from AI operations
+ */
+export interface ProgressEvent {
+    taskId?: string;
+    operation?: string;
+    step?: string;
+    progress?: number;
+    message?: string;
+    phase?: string;
+    [key: string]: any;
+}
+/**
+ * Execute an async function with automatic progress tracking
+ * Registers a progress handler, executes the function, and cleans up
+ *
+ * @param fn - The async function to execute with progress tracking
+ * @returns The result of the function
+ *
+ * @example
+ * ```typescript
+ * const result = await withProgressTracking(async () => {
+ *   return await taskService.enhanceTask(taskId);
+ * });
+ * ```
+ */
+export declare function withProgressTracking<T>(fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=progress-tracking.d.ts.map

package/dist/utils/progress-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-tracking.d.ts","sourceRoot":"","sources":["../../src/utils/progress-tracking.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAiBD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CASZ"}

package/dist/utils/progress-tracking.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withProgressTracking = withProgressTracking;
+const hooks_1 = require("../lib/hooks");
+/**
+ * Display progress information to the console
+ */
+function displayProgress(payload) {
+    const { operation, step, message, phase } = payload;
+    if (phase) {
+        console.log(`[${phase}]`, message || step || operation || "");
+    }
+    else if (operation && step) {
+        console.log(`${operation}: ${step}`);
+    }
+    else if (message) {
+        console.log(message);
+    }
+}
+/**
+ * Execute an async function with automatic progress tracking
+ * Registers a progress handler, executes the function, and cleans up
+ *
+ * @param fn - The async function to execute with progress tracking
+ * @returns The result of the function
+ *
+ * @example
+ * ```typescript
+ * const result = await withProgressTracking(async () => {
+ *   return await taskService.enhanceTask(taskId);
+ * });
+ * ```
+ */
+async function withProgressTracking(fn) {
+    const progressHandler = (payload) => displayProgress(payload);
+    hooks_1.hooks.on("task:progress", progressHandler);
+    try {
+        return await fn();
+    }
+    finally {
+        hooks_1.hooks.off("task:progress", progressHandler);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "task-o-matic",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "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);
-    }
-});