task-o-matic 0.0.14 → 0.0.16

package/dist/lib/storage/file-system.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileSystemStorage = void 0;
 const config_1 = require("../config");
 const storage_callbacks_1 = require("./storage-callbacks");
+const task_o_matic_error_1 = require("../../utils/task-o-matic-error");
 class FileSystemStorage {
     callbacks;
     constructor(callbacks) {
@@ -16,30 +17,54 @@ class FileSystemStorage {
     }
     validateTaskId(taskId) {
         if (!taskId || typeof taskId !== "string" || taskId.trim() === "") {
-            throw new Error("Task ID must be a non-empty string");
+            throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.INVALID_INPUT, "Task ID must be a non-empty string", {
+                context: "validateTaskId",
+                suggestions: ["Provide a valid task ID string"],
+                metadata: { taskId },
+            });
         }
     }
     validateTaskRequest(task) {
         if (!task || typeof task !== "object") {
-            throw new Error("Task request must be a valid object");
+            throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.INVALID_INPUT, "Task request must be a valid object", {
+                context: "validateTaskRequest",
+                suggestions: ["Provide a valid task request object"],
+            });
         }
         if (!task.title ||
             typeof task.title !== "string" ||
             task.title.trim() === "") {
-            throw new Error("Task title is required and must be a non-empty string");
+            throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.INVALID_INPUT, "Task title is required and must be a non-empty string", {
+                context: "validateTaskRequest - title validation",
+                suggestions: ["Provide a non-empty title for the task"],
+            });
         }
         if (task.parentId && typeof task.parentId !== "string") {
-            throw new Error("Parent ID must be a string if provided");
+            throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.INVALID_INPUT, "Parent ID must be a string if provided", {
+                context: "validateTaskRequest - parentId validation",
+                suggestions: ["Provide a valid parent ID string or omit the field"],
+                metadata: { parentId: task.parentId },
+            });
         }
         if (task.estimatedEffort &&
             !["small", "medium", "large"].includes(task.estimatedEffort)) {
-            throw new Error("Estimated effort must be 'small', 'medium', or 'large'");
+            throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.INVALID_INPUT, "Estimated effort must be 'small', 'medium', or 'large'", {
+                context: "validateTaskRequest - estimatedEffort validation",
+                suggestions: ["Use 'small', 'medium', or 'large' for estimatedEffort"],
+                metadata: { estimatedEffort: task.estimatedEffort },
+            });
         }
         if (task.dependencies && !Array.isArray(task.dependencies)) {
-            throw new Error("Dependencies must be an array if provided");
+            throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.INVALID_INPUT, "Dependencies must be an array if provided", {
+                context: "validateTaskRequest - dependencies validation",
+                suggestions: ["Provide dependencies as an array of task IDs"],
+            });
         }
         if (task.tags && !Array.isArray(task.tags)) {
-            throw new Error("Tags must be an array if provided");
+            throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.INVALID_INPUT, "Tags must be an array if provided", {
+                context: "validateTaskRequest - tags validation",
+                suggestions: ["Provide tags as an array of strings"],
+            });
         }
     }
     async loadTasksData() {
@@ -60,7 +85,7 @@ class FileSystemStorage {
             await this.callbacks.write("tasks.json", JSON.stringify(data, null, 2));
         }
         catch (error) {
-            throw new Error(`Failed to save tasks data: ${error instanceof Error ? error.message : "Unknown error"}`);
+            throw (0, task_o_matic_error_1.formatStorageError)("write tasks.json", error instanceof Error ? error : undefined);
         }
     }
     findTaskInHierarchy(tasks, id) {
@@ -111,7 +136,15 @@ class FileSystemStorage {
         if (task.parentId) {
             const parentResult = this.findTaskInHierarchy(data.tasks, task.parentId);
             if (!parentResult.task) {
-                throw new Error(`Parent task with ID ${task.parentId} not found`);
+                throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.TASK_NOT_FOUND, `Parent task with ID ${task.parentId} not found`, {
+                    context: "createTask - parent validation",
+                    suggestions: [
+                        "Create the parent task first",
+                        "Check that the parent ID is correct",
+                        "List all tasks to see available parent IDs",
+                    ],
+                    metadata: { parentId: task.parentId },
+                });
             }
             const siblingCount = (parentResult.task.subtasks?.length || 0) + 1;
             id = `${task.parentId}.${siblingCount}`;
@@ -129,11 +162,26 @@ class FileSystemStorage {
             for (const depId of task.dependencies) {
                 const depExists = this.taskExists(data.tasks, depId);
                 if (!depExists) {
-                    throw new Error(`Dependency task not found: ${depId}`);
+                    throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.TASK_NOT_FOUND, `Dependency task not found: ${depId}`, {
+                        context: "createTask - dependency validation",
+                        suggestions: [
+                            "Create the dependency task first",
+                            "Check that the dependency ID is correct",
+                            "Remove the dependency from the task",
+                        ],
+                        metadata: { dependencyId: depId, taskDependencies: task.dependencies },
+                    });
                 }
             }
             if (this.wouldCreateCircularDependency(data.tasks, id, task.dependencies)) {
-                throw new Error(`Circular dependency detected for task ${id}`);
+                throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.STORAGE_INTEGRITY_ERROR, `Circular dependency detected for task ${id}`, {
+                    context: "createTask - circular dependency check",
+                    suggestions: [
+                        "Remove circular dependencies from the task",
+                        "Review the dependency chain",
+                    ],
+                    metadata: { taskId: id, dependencies: task.dependencies },
+                });
             }
         }
         let contentFile;
@@ -184,7 +232,10 @@ class FileSystemStorage {
     async updateTask(id, updates) {
         this.validateTaskId(id);
         if (!updates || typeof updates !== "object") {
-            throw new Error("Updates must be a valid object");
+            throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.INVALID_INPUT, "Updates must be a valid object", {
+                context: "updateTask - updates validation",
+                suggestions: ["Provide a valid updates object with task properties"],
+            });
         }
         const data = await this.loadTasksData();
         const result = this.findTaskInHierarchy(data.tasks, id);
@@ -314,28 +365,34 @@ class FileSystemStorage {
     async saveTaskContent(taskId, content) {
         this.validateTaskId(taskId);
         if (typeof content !== "string") {
-            throw new Error("Content must be a string");
+            throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.INVALID_INPUT, "Content must be a string", {
+                context: "Content validation",
+                suggestions: ["Provide content as a string"],
+            });
         }
         const contentFileName = `tasks/${taskId}.md`;
         try {
             await this.callbacks.write(contentFileName, content);
         }
         catch (error) {
-            throw new Error(`Failed to save task content: ${error instanceof Error ? error.message : "Unknown error"}`);
+            throw (0, task_o_matic_error_1.formatStorageError)("write task content", error instanceof Error ? error : undefined);
         }
         return contentFileName;
     }
     async saveEnhancedTaskContent(taskId, content) {
         this.validateTaskId(taskId);
         if (typeof content !== "string") {
-            throw new Error("Content must be a string");
+            throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.INVALID_INPUT, "Content must be a string", {
+                context: "Content validation",
+                suggestions: ["Provide content as a string"],
+            });
         }
         const contentFileName = `tasks/enhanced/${taskId}.md`;
         try {
             await this.callbacks.write(contentFileName, content);
         }
         catch (error) {
-            throw new Error(`Failed to save enhanced task content: ${error instanceof Error ? error.message : "Unknown error"}`);
+            throw (0, task_o_matic_error_1.formatStorageError)("write enhanced task content", error instanceof Error ? error : undefined);
         }
         return contentFileName;
     }
@@ -496,7 +553,7 @@ class FileSystemStorage {
             await this.callbacks.write(planFile, JSON.stringify(planData, null, 2));
         }
         catch (error) {
-            throw new Error(`Failed to save plan for task ${taskId}: ${error instanceof Error ? error.message : "Unknown error"}`);
+            throw (0, task_o_matic_error_1.formatStorageError)(`write plan for task ${taskId}`, error instanceof Error ? error : undefined);
         }
     }
     async getPlan(taskId) {
@@ -509,7 +566,7 @@ class FileSystemStorage {
             return JSON.parse(content);
         }
         catch (error) {
-            throw new Error(`Failed to read plan for task ${taskId}: ${error instanceof Error ? error.message : "Unknown error"}`);
+            throw (0, task_o_matic_error_1.formatStorageError)(`read plan for task ${taskId}`, error instanceof Error ? error : undefined);
         }
     }
     async listPlans() {
@@ -534,7 +591,7 @@ class FileSystemStorage {
             return plans.sort((a, b) => b.updatedAt - a.updatedAt);
         }
         catch (error) {
-            throw new Error(`Failed to list plans: ${error instanceof Error ? error.message : "Unknown error"}`);
+            throw (0, task_o_matic_error_1.formatStorageError)("list plans", error instanceof Error ? error : undefined);
         }
     }
     async deletePlan(taskId) {
@@ -551,14 +608,17 @@ class FileSystemStorage {
     async saveTaskDocumentation(taskId, documentation) {
         this.validateTaskId(taskId);
         if (typeof documentation !== "string") {
-            throw new Error("Documentation must be a string");
+            throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.INVALID_INPUT, "Documentation must be a string", {
+                context: "Documentation validation",
+                suggestions: ["Provide documentation as a string"],
+            });
         }
         const documentationFileName = `docs/tasks/${taskId}.md`;
         try {
             await this.callbacks.write(documentationFileName, documentation);
         }
         catch (error) {
-            throw new Error(`Failed to save task documentation: ${error instanceof Error ? error.message : "Unknown error"}`);
+            throw (0, task_o_matic_error_1.formatStorageError)("write task documentation", error instanceof Error ? error : undefined);
         }
         return documentationFileName;
     }

package/dist/lib/task-execution-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-execution-core.d.ts","sourceRoot":"","sources":["../../src/lib/task-execution-core.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EAKpB,MAAM,UAAU,CAAC;AAWlB;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CA+D9B"}
+{"version":3,"file":"task-execution-core.d.ts","sourceRoot":"","sources":["../../src/lib/task-execution-core.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EAKpB,MAAM,UAAU,CAAC;AAWlB;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CA+D9B"}

package/dist/lib/task-execution-core.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.executeTaskCore = executeTaskCore;
+const task_o_matic_error_1 = require("../utils/task-o-matic-error");
 const tasks_1 = require("../services/tasks");
 const executor_factory_1 = require("./executors/executor-factory");
 const validation_1 = require("./validation");
@@ -23,7 +24,7 @@ async function executeTaskCore(taskId, config) {
     // Load task
     const task = await tasks_1.taskService.getTask(taskId);
     if (!task) {
-        throw new Error(`Task with ID ${taskId} not found`);
+        throw (0, task_o_matic_error_1.formatTaskNotFoundError)(taskId);
     }
     // Check if task has subtasks and should execute them recursively
     if (executeSubtasks && !customMessage) {
@@ -254,7 +255,7 @@ async function executeSingleAttempt(task, config, attempts, planContent, attempt
             retryContext,
         });
         if (!promptResult.success) {
-            throw new Error(`Failed to build execution prompt: ${promptResult.error}`);
+            throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.CONFIGURATION_ERROR, `Failed to build execution prompt: ${promptResult.error}`);
         }
         executionMessage = promptResult.prompt;
     }

package/dist/services/prd.d.ts

@@ -1,12 +1,28 @@
+import { getAIOperations, getStorage } from "../utils/ai-service-factory";
 import { AIOptions } from "../utils/ai-config-builder";
 import { StreamingOptions } from "../types";
 import { PRDParseResult } from "../types/results";
 import { ProgressCallback } from "../types/callbacks";
+/**
+ * Dependencies for PRDService
+ */
+export interface PRDServiceDependencies {
+    storage?: ReturnType<typeof getStorage>;
+    aiOperations?: ReturnType<typeof getAIOperations>;
+}
 /**
  * PRDService - Business logic for PRD operations
  * Handles PRD parsing, task extraction, and PRD improvement
  */
 export declare class PRDService {
+    private storage;
+    private aiOperations;
+    /**
+     * Create a new PRDService
+     *
+     * @param dependencies - Optional dependencies to inject (for testing)
+     */
+    constructor(dependencies?: PRDServiceDependencies);
     parsePRD(input: {
         file: string;
         workingDirectory?: string;
@@ -98,5 +114,6 @@ export declare class PRDService {
         };
     }>;
 }
+export declare function getPRDService(): PRDService;
 export declare const prdService: PRDService;
 //# sourceMappingURL=prd.d.ts.map

package/dist/services/prd.d.ts.map

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

package/dist/services/prd.js

@@ -34,6 +34,8 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.prdService = exports.PRDService = void 0;
+exports.getPRDService = getPRDService;
+const task_o_matic_error_1 = require("../utils/task-o-matic-error");
 const fs_1 = require("fs");
 const path_1 = require("path");
 const ai_service_factory_1 = require("../utils/ai-service-factory");
@@ -47,6 +49,18 @@ const file_utils_1 = require("../utils/file-utils");
  * Handles PRD parsing, task extraction, and PRD improvement
  */
 class PRDService {
+    storage;
+    aiOperations;
+    /**
+     * Create a new PRDService
+     *
+     * @param dependencies - Optional dependencies to inject (for testing)
+     */
+    constructor(dependencies = {}) {
+        // Use injected dependencies or fall back to singletons
+        this.storage = dependencies.storage ?? (0, ai_service_factory_1.getStorage)();
+        this.aiOperations = dependencies.aiOperations ?? (0, ai_service_factory_1.getAIOperations)();
+    }
     async parsePRD(input) {
         const startTime = Date.now();
         const steps = [];
@@ -59,7 +73,9 @@ class PRDService {
         // Ensure we're in a task-o-matic project
         const taskOMaticDir = config_1.configManager.getTaskOMaticDir();
         if (!(0, fs_1.existsSync)(taskOMaticDir)) {
-            throw new Error(`Not a task-o-matic project. Run 'task-o-matic init init' first.`);
+            throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.CONFIGURATION_ERROR, "Not a task-o-matic project. Run 'task-o-matic init init' first.", {
+                suggestions: ["Run `task-o-matic init init` in your project root."],
+            });
         }
         // Set working directory and reload config (DRY fix 1.4)
         const workingDir = input.workingDirectory || process.cwd();
@@ -94,7 +110,9 @@ class PRDService {
         // Validate AI provider if specified
         if (input.aiOptions?.aiProvider &&
             !(0, validation_1.isValidAIProvider)(input.aiOptions.aiProvider)) {
-            throw new Error(`Invalid AI provider: ${input.aiOptions.aiProvider}`);
+            throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.AI_CONFIGURATION_ERROR, `Invalid AI provider: ${input.aiOptions.aiProvider}`, {
+                suggestions: ["Use a valid AI provider, e.g., 'openai', 'anthropic'"],
+            });
         }
         const aiConfig = (0, ai_config_builder_1.buildAIConfig)(input.aiOptions);
         input.callbacks?.onProgress?.({
@@ -104,7 +122,7 @@ class PRDService {
         const stepStart2 = Date.now();
         // Use utility to wrap streaming options and capture metrics (DRY fix 1.1)
         const { options: metricsStreamingOptions, getMetrics } = (0, streaming_utils_1.createMetricsStreamingOptions)(input.streamingOptions, stepStart2);
-        const result = await (0, ai_service_factory_1.getAIOperations)().parsePRD(prdContent, aiConfig, input.promptOverride, input.messageOverride, metricsStreamingOptions, undefined, // retryConfig
+        const result = await this.aiOperations.parsePRD(prdContent, aiConfig, input.promptOverride, input.messageOverride, metricsStreamingOptions, undefined, // retryConfig
         workingDir, // Pass working directory to AI operations
         input.enableFilesystemTools);
         // Extract metrics after AI call
@@ -130,7 +148,7 @@ class PRDService {
                 current: i + 1,
                 total: result.tasks.length,
             });
-            const createdTask = await (0, ai_service_factory_1.getStorage)().createTask({
+            const createdTask = await this.storage.createTask({
                 id: task.id, // Preserve AI-generated ID for dependencies
                 title: task.title,
                 description: task.description,
@@ -152,7 +170,7 @@ class PRDService {
                 aiModel: input.aiOptions?.aiModel,
                 generatedAt: Date.now(),
             };
-            await (0, ai_service_factory_1.getStorage)().saveTaskAIMetadata(aiMetadata);
+            await this.storage.saveTaskAIMetadata(aiMetadata);
         }
         steps.push({
             step: "Create Tasks",
@@ -209,14 +227,16 @@ class PRDService {
         const prdContent = (0, fs_1.readFileSync)(input.file, "utf-8");
         if (input.aiOptions?.aiProvider &&
             !(0, validation_1.isValidAIProvider)(input.aiOptions.aiProvider)) {
-            throw new Error(`Invalid AI provider: ${input.aiOptions.aiProvider}`);
+            throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.AI_CONFIGURATION_ERROR, `Invalid AI provider: ${input.aiOptions.aiProvider}`, {
+                suggestions: ["Use a valid AI provider, e.g., 'openai', 'anthropic'"],
+            });
         }
         const aiConfig = (0, ai_config_builder_1.buildAIConfig)(input.aiOptions);
         input.callbacks?.onProgress?.({
             type: "progress",
             message: "Analyzing PRD with AI...",
         });
-        const questions = await (0, ai_service_factory_1.getAIOperations)().generatePRDQuestions(prdContent, aiConfig, input.promptOverride, input.messageOverride, input.streamingOptions, undefined, workingDir, input.enableFilesystemTools);
+        const questions = await this.aiOperations.generatePRDQuestions(prdContent, aiConfig, input.promptOverride, input.messageOverride, input.streamingOptions, undefined, workingDir, input.enableFilesystemTools);
         input.callbacks?.onProgress?.({
             type: "completed",
             message: `Generated ${questions.length} questions`,
@@ -241,14 +261,16 @@ class PRDService {
         // Validate AI provider if specified
         if (input.aiOptions?.aiProvider &&
             !(0, validation_1.isValidAIProvider)(input.aiOptions.aiProvider)) {
-            throw new Error(`Invalid AI provider: ${input.aiOptions.aiProvider}`);
+            throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.AI_CONFIGURATION_ERROR, `Invalid AI provider: ${input.aiOptions.aiProvider}`, {
+                suggestions: ["Use a valid AI provider, e.g., 'openai', 'anthropic'"],
+            });
         }
         const aiConfig = (0, ai_config_builder_1.buildAIConfig)(input.aiOptions);
         input.callbacks?.onProgress?.({
             type: "progress",
             message: "Calling AI to improve PRD...",
         });
-        const improvedPRD = await (0, ai_service_factory_1.getAIOperations)().reworkPRD(prdContent, input.feedback, aiConfig, input.promptOverride, input.messageOverride, input.streamingOptions, undefined, // retryConfig
+        const improvedPRD = await this.aiOperations.reworkPRD(prdContent, input.feedback, aiConfig, input.promptOverride, input.messageOverride, input.streamingOptions, undefined, // retryConfig
         workingDir, // Pass working directory to AI operations
         input.enableFilesystemTools);
         input.callbacks?.onProgress?.({
@@ -311,7 +333,7 @@ class PRDService {
             // User mode: return questions for CLI to prompt user
             // Answers should be provided in input.answers
             if (!input.answers || Object.keys(input.answers).length === 0) {
-                throw new Error("User mode selected but no answers provided. CLI layer should collect answers.");
+                throw (0, task_o_matic_error_1.createStandardError)(task_o_matic_error_1.TaskOMaticErrorCodes.INVALID_INPUT, "User mode selected but no answers provided. CLI layer should collect answers.");
             }
             answers = input.answers;
         }
@@ -324,7 +346,7 @@ class PRDService {
             const prdContent = (0, fs_1.readFileSync)(input.file, "utf-8");
             // Use questionAIOptions if provided, otherwise use main aiOptions
             const answeringAIConfig = (0, ai_config_builder_1.buildAIConfig)(input.questionAIOptions || input.aiOptions);
-            answers = await (0, ai_service_factory_1.getAIOperations)().answerPRDQuestions(prdContent, questions, answeringAIConfig, {
+            answers = await this.aiOperations.answerPRDQuestions(prdContent, questions, answeringAIConfig, {
                 stackInfo,
             }, input.streamingOptions);
         }
@@ -359,48 +381,23 @@ class PRDService {
     }
     async generatePRD(input) {
         const startTime = Date.now();
-        let tokenUsage;
-        let timeToFirstToken;
-        let cost;
         input.callbacks?.onProgress?.({
             type: "started",
             message: "Generating PRD...",
         });
-        // Capture metrics
-        const metricsStreamingOptions = {
-            ...input.streamingOptions,
-            onFinish: async (result) => {
-                if (result.usage) {
-                    tokenUsage = {
-                        prompt: result.usage.inputTokens || result.usage.promptTokens || 0,
-                        completion: result.usage.outputTokens || result.usage.completionTokens || 0,
-                        total: result.usage.totalTokens || 0,
-                    };
-                    // Simple cost estimation placeholder
-                    if (tokenUsage.total > 0) {
-                        cost = tokenUsage.total * 0.000001;
-                    }
-                }
-                await input.streamingOptions?.onFinish?.(result);
-            },
-            onChunk: (chunk) => {
-                if (chunk && !timeToFirstToken) {
-                    timeToFirstToken = Date.now() - startTime;
-                }
-                input.streamingOptions?.onChunk?.(chunk);
-            },
-        };
+        // Use utility to wrap streaming options and capture metrics
+        const { options: metricsStreamingOptions, getMetrics } = (0, streaming_utils_1.createMetricsStreamingOptions)(input.streamingOptions, startTime);
         const aiConfig = (0, ai_config_builder_1.buildAIConfig)(input.aiOptions);
-        const content = await (0, ai_service_factory_1.getAIOperations)().generatePRD(input.description, aiConfig, undefined, undefined, metricsStreamingOptions);
-        // Save file
-        const taskOMaticDir = config_1.configManager.getTaskOMaticDir();
-        const prdDir = input.outputDir || (0, path_1.join)(taskOMaticDir, "prd");
-        if (!(0, fs_1.existsSync)(prdDir)) {
-            (0, fs_1.mkdirSync)(prdDir, { recursive: true });
+        const content = await this.aiOperations.generatePRD(input.description, aiConfig, undefined, undefined, metricsStreamingOptions);
+        // Get metrics after AI operation
+        const { tokenUsage, timeToFirstToken } = getMetrics();
+        // Calculate cost if needed
+        let cost;
+        if (tokenUsage && tokenUsage.total > 0) {
+            cost = tokenUsage.total * 0.000001; // Placeholder cost calculation
         }
-        const filename = input.filename || "prd.md";
-        const path = (0, path_1.join)(prdDir, filename);
-        (0, fs_1.writeFileSync)(path, content);
+        // Save file using utility
+        const path = (0, file_utils_1.savePRDFile)(content, input.filename, input.outputDir);
         input.callbacks?.onProgress?.({
             type: "completed",
             message: `PRD generated and saved to ${path}`,
@@ -418,47 +415,23 @@ class PRDService {
     }
     async combinePRDs(input) {
         const startTime = Date.now();
-        let tokenUsage;
-        let timeToFirstToken;
-        let cost;
         input.callbacks?.onProgress?.({
             type: "started",
             message: "Combining PRDs...",
         });
-        // Capture metrics
-        const metricsStreamingOptions = {
-            ...input.streamingOptions,
-            onFinish: async (result) => {
-                if (result.usage) {
-                    tokenUsage = {
-                        prompt: result.usage.inputTokens || result.usage.promptTokens || 0,
-                        completion: result.usage.outputTokens || result.usage.completionTokens || 0,
-                        total: result.usage.totalTokens || 0,
-                    };
-                    if (tokenUsage.total > 0) {
-                        cost = tokenUsage.total * 0.000001;
-                    }
-                }
-                await input.streamingOptions?.onFinish?.(result);
-            },
-            onChunk: (chunk) => {
-                if (chunk && !timeToFirstToken) {
-                    timeToFirstToken = Date.now() - startTime;
-                }
-                input.streamingOptions?.onChunk?.(chunk);
-            },
-        };
+        // Use utility to wrap streaming options and capture metrics
+        const { options: metricsStreamingOptions, getMetrics } = (0, streaming_utils_1.createMetricsStreamingOptions)(input.streamingOptions, startTime);
         const aiConfig = (0, ai_config_builder_1.buildAIConfig)(input.aiOptions);
-        const content = await (0, ai_service_factory_1.getAIOperations)().combinePRDs(input.prds, input.originalDescription, aiConfig, undefined, undefined, metricsStreamingOptions);
-        // Save file
-        const taskOMaticDir = config_1.configManager.getTaskOMaticDir();
-        const prdDir = input.outputDir || (0, path_1.join)(taskOMaticDir, "prd");
-        if (!(0, fs_1.existsSync)(prdDir)) {
-            (0, fs_1.mkdirSync)(prdDir, { recursive: true });
+        const content = await this.aiOperations.combinePRDs(input.prds, input.originalDescription, aiConfig, undefined, undefined, metricsStreamingOptions);
+        // Get metrics after AI operation
+        const { tokenUsage, timeToFirstToken } = getMetrics();
+        // Calculate cost if needed
+        let cost;
+        if (tokenUsage && tokenUsage.total > 0) {
+            cost = tokenUsage.total * 0.000001;
         }
-        const filename = input.filename || "prd-master.md";
-        const path = (0, path_1.join)(prdDir, filename);
-        (0, fs_1.writeFileSync)(path, content);
+        // Save file using utility (defaults to "prd.md" if no filename, so we provide the default for combinePRDs)
+        const path = (0, file_utils_1.savePRDFile)(content, input.filename || "prd-master.md", input.outputDir);
         input.callbacks?.onProgress?.({
             type: "completed",
             message: `Master PRD saved to ${path}`,
@@ -476,5 +449,17 @@ class PRDService {
     }
 }
 exports.PRDService = PRDService;
-// Export singleton instance
-exports.prdService = new PRDService();
+// Lazy singleton instance - only created when first accessed
+let prdServiceInstance;
+function getPRDService() {
+    if (!prdServiceInstance) {
+        prdServiceInstance = new PRDService();
+    }
+    return prdServiceInstance;
+}
+// Backward compatibility: export as const but use getter
+exports.prdService = new Proxy({}, {
+    get(target, prop) {
+        return getPRDService()[prop];
+    },
+});