task-o-matic-core 0.1.1-beta.7 → 0.1.1-beta.9

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "task-o-matic-core",
-  "version": "0.1.1-beta.7",
+  "version": "0.1.1-beta.9",
   "description": "Core logic for Task-O-Matic",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",

package/src/index.ts

@@ -1,36 +0,0 @@
-export * from "./types";
-export * from "./lib/config";
-export * from "./lib/logger";
-export * from "./lib/better-t-stack-cli";
-export * from "./lib/validation";
-export * from "./lib/context-builder";
-export * from "./lib/ai-service/ai-operations";
-export * from "./lib/ai-service/task-operations";
-export * from "./lib/ai-service/prd-operations";
-export * from "./lib/ai-service/documentation-operations";
-export * from "./lib/executors/executor-factory";
-export * from "./lib/prompt-builder";
-export * from "./lib/task-execution";
-export * from "./lib/task-loop-execution";
-
-export * from "./services/tasks";
-export * from "./services/workflow";
-export * from "./services/prd";
-export * from "./services/benchmark";
-export * from "./lib/benchmark/registry";
-export * from "./lib/benchmark/types";
-
-export * from "./utils/ai-service-factory";
-export * from "./utils/task-o-matic-error";
-
-export * from "./lib/hooks";
-
-// Moved to CLI:
-// - ./utils/streaming-options
-// - ./utils/display-helpers
-// - ./lib/hooks/logger
-
-export * from "./utils/model-executor-parser";
-export * from "./utils/model-parser";
-
-export * from "./prompts";

package/src/lib/ai-service/ai-operations.ts

@@ -1,310 +0,0 @@
-import {
-  AIConfig,
-  Task,
-  AIPRDParseResult,
-  DocumentationDetection,
-  StreamingOptions,
-  RetryConfig,
-  TaskDocumentation,
-} from "../../types";
-import { BaseOperations } from "./base-operations";
-import { PRDOperations } from "./prd-operations";
-import { TaskOperations } from "./task-operations";
-import { DocumentationOperations } from "./documentation-operations";
-
-/**
- * Main AIOperations class that delegates to specialized operation classes.
- * This provides a unified API for all AI operations while keeping the implementation modular.
- */
-export class AIOperations extends BaseOperations {
-  private prdOps = new PRDOperations();
-  private taskOps = new TaskOperations();
-  private docOps = new DocumentationOperations();
-
-  // PRD Operations - Delegated to PRDOperations
-
-  async parsePRD(
-    prdContent: string,
-    config?: Partial<AIConfig>,
-    promptOverride?: string,
-    userMessage?: string,
-    streamingOptions?: StreamingOptions,
-    retryConfig?: Partial<RetryConfig>,
-    workingDirectory?: string,
-    enableFilesystemTools?: boolean
-  ): Promise<AIPRDParseResult> {
-    return this.prdOps.parsePRD(
-      prdContent,
-      config,
-      promptOverride,
-      userMessage,
-      streamingOptions,
-      retryConfig,
-      workingDirectory,
-      enableFilesystemTools
-    );
-  }
-
-  // Task Operations - Delegated to TaskOperations
-
-  async breakdownTask(
-    task: Task,
-    config?: Partial<AIConfig>,
-    promptOverride?: string,
-    userMessage?: string,
-    streamingOptions?: StreamingOptions,
-    retryConfig?: Partial<RetryConfig>,
-    fullContent?: string,
-    stackInfo?: string,
-    existingSubtasks?: Task[],
-    enableFilesystemTools?: boolean
-  ): Promise<
-    Array<{ title: string; content: string; estimatedEffort?: string }>
-  > {
-    return this.taskOps.breakdownTask(
-      task,
-      config,
-      promptOverride,
-      userMessage,
-      streamingOptions,
-      retryConfig,
-      fullContent,
-      stackInfo,
-      existingSubtasks,
-      enableFilesystemTools
-    );
-  }
-
-  async enhanceTask(
-    title: string,
-    description?: string,
-    config?: Partial<AIConfig>,
-    promptOverride?: string,
-    userMessage?: string,
-    taskId?: string,
-    streamingOptions?: StreamingOptions,
-    retryConfig?: Partial<RetryConfig>
-  ): Promise<string> {
-    return this.taskOps.enhanceTask(
-      title,
-      description,
-      config,
-      promptOverride,
-      userMessage,
-      taskId,
-      streamingOptions,
-      retryConfig
-    );
-  }
-
-  async reworkPRD(
-    prdContent: string,
-    feedback: string,
-    config?: Partial<AIConfig>,
-    promptOverride?: string,
-    userMessage?: string,
-    streamingOptions?: StreamingOptions,
-    retryConfig?: Partial<RetryConfig>,
-    workingDirectory?: string,
-    enableFilesystemTools?: boolean
-  ): Promise<string> {
-    return this.prdOps.reworkPRD(
-      prdContent,
-      feedback,
-      config,
-      promptOverride,
-      userMessage,
-      streamingOptions,
-      retryConfig,
-      workingDirectory,
-      enableFilesystemTools
-    );
-  }
-
-  async generatePRDQuestions(
-    prdContent: string,
-    config?: Partial<AIConfig>,
-    promptOverride?: string,
-    userMessage?: string,
-    streamingOptions?: StreamingOptions,
-    retryConfig?: Partial<RetryConfig>,
-    workingDirectory?: string,
-    enableFilesystemTools?: boolean
-  ): Promise<string[]> {
-    return this.prdOps.generatePRDQuestions(
-      prdContent,
-      config,
-      promptOverride,
-      userMessage,
-      streamingOptions,
-      retryConfig,
-      workingDirectory,
-      enableFilesystemTools
-    );
-  }
-
-  async answerPRDQuestions(
-    prdContent: string,
-    questions: string[],
-    config?: Partial<AIConfig>,
-    contextInfo?: {
-      stackInfo?: string;
-      projectDescription?: string;
-    },
-    streamingOptions?: StreamingOptions,
-    retryConfig?: Partial<RetryConfig>
-  ): Promise<Record<string, string>> {
-    return this.prdOps.answerPRDQuestions(
-      prdContent,
-      questions,
-      config,
-      contextInfo,
-      streamingOptions,
-      retryConfig
-    );
-  }
-
-  async generatePRD(
-    description: string,
-    config?: Partial<AIConfig>,
-    promptOverride?: string,
-    userMessage?: string,
-    streamingOptions?: StreamingOptions,
-    retryConfig?: Partial<RetryConfig>
-  ): Promise<string> {
-    return this.prdOps.generatePRD(
-      description,
-      config,
-      promptOverride,
-      userMessage,
-      streamingOptions,
-      retryConfig
-    );
-  }
-
-  async combinePRDs(
-    prds: string[],
-    originalDescription: string,
-    config?: Partial<AIConfig>,
-    promptOverride?: string,
-    userMessage?: string,
-    streamingOptions?: StreamingOptions,
-    retryConfig?: Partial<RetryConfig>
-  ): Promise<string> {
-    return this.prdOps.combinePRDs(
-      prds,
-      originalDescription,
-      config,
-      promptOverride,
-      userMessage,
-      streamingOptions,
-      retryConfig
-    );
-  }
-
-  // Documentation Operations - Delegated to DocumentationOperations
-
-  async enhanceTaskWithDocumentation(
-    taskId: string,
-    taskTitle: string,
-    taskDescription: string,
-    stackInfo?: string,
-    streamingOptions?: StreamingOptions,
-    retryConfig?: Partial<RetryConfig>,
-    config?: Partial<AIConfig>,
-    existingResearch?: Record<string, Array<{ query: string; doc: string }>>
-  ): Promise<string> {
-    return this.docOps.enhanceTaskWithDocumentation(
-      taskId,
-      taskTitle,
-      taskDescription,
-      stackInfo,
-      streamingOptions,
-      retryConfig,
-      config,
-      existingResearch
-    );
-  }
-
-  async analyzeDocumentationNeeds(
-    taskId: string,
-    taskTitle: string,
-    taskDescription: string,
-    stackInfo?: string,
-    streamingOptions?: StreamingOptions,
-    retryConfig?: Partial<RetryConfig>,
-    config?: Partial<AIConfig>,
-    existingResearch?: (TaskDocumentation | undefined)[]
-  ): Promise<DocumentationDetection> {
-    return this.docOps.analyzeDocumentationNeeds(
-      taskId,
-      taskTitle,
-      taskDescription,
-      stackInfo,
-      streamingOptions,
-      retryConfig,
-      config,
-      existingResearch
-    );
-  }
-
-  async generateDocumentationRecap(
-    libraries: Array<{ name: string; context7Id: string; reason: string }>,
-    documentContents: Array<{ library: string; content: string }>,
-    streamingOptions?: StreamingOptions,
-    retryConfig?: Partial<RetryConfig>
-  ): Promise<string> {
-    return this.docOps.generateDocumentationRecap(
-      libraries,
-      documentContents,
-      streamingOptions,
-      retryConfig
-    );
-  }
-
-  async planTask(
-    taskContext: string,
-    taskDetails: string,
-    config?: Partial<AIConfig>,
-    promptOverride?: string,
-    userMessage?: string,
-    streamingOptions?: StreamingOptions,
-    retryConfig?: Partial<RetryConfig>
-  ): Promise<string> {
-    return this.taskOps.planTask(
-      taskContext,
-      taskDetails,
-      config,
-      promptOverride,
-      userMessage,
-      streamingOptions,
-      retryConfig
-    );
-  }
-
-  // Stack suggestion - Delegated to PRDOperations
-
-  async suggestStack(
-    prdContent: string,
-    projectName?: string,
-    config?: Partial<AIConfig>,
-    promptOverride?: string,
-    userMessage?: string,
-    streamingOptions?: StreamingOptions,
-    retryConfig?: Partial<RetryConfig>,
-    workingDirectory?: string,
-    enableFilesystemTools?: boolean
-  ): Promise<{ config: import("../../types").BTSConfig; reasoning: string }> {
-    return this.prdOps.suggestStack(
-      prdContent,
-      projectName,
-      config,
-      promptOverride,
-      userMessage,
-      streamingOptions,
-      retryConfig,
-      workingDirectory,
-      enableFilesystemTools
-    );
-  }
-}

package/src/lib/ai-service/base-operations.ts

@@ -1,139 +0,0 @@
-import { streamText, type LanguageModel } from "ai";
-import { AIConfig, StreamingOptions, RetryConfig } from "../../types";
-import { JSONParser } from "./json-parser";
-import { Context7Client } from "./mcp-client";
-import { RetryHandler } from "./retry-handler";
-import { ModelProvider } from "./model-provider";
-
-export class BaseOperations {
-  protected jsonParser = new JSONParser();
-  protected context7Client = new Context7Client();
-  protected retryHandler = new RetryHandler();
-  protected modelProvider = new ModelProvider();
-
-  /**
-   * Merges AI configuration with proper precedence.
-   *
-   * Configuration precedence (highest to lowest):
-   * 1. Method parameter `config` (operation-specific overrides)
-   * 2. ConfigManager global config (project-level settings)
-   * 3. Environment variables (OPENAI_API_KEY, etc.)
-   * 4. Provider defaults (defined in config.ts)
-   *
-   * @param config - Optional operation-specific config overrides
-   * @returns Merged AIConfig with all precedence levels applied
-   *
-   * @example
-   * ```typescript
-   * // Override just the model for this operation
-   * const finalConfig = this.mergeAIConfig({ model: "gpt-4o" });
-   *
-   * // Use default config (from ConfigManager + env vars)
-   * const finalConfig = this.mergeAIConfig();
-   * ```
-   */
-  protected mergeAIConfig(config?: Partial<AIConfig>): AIConfig {
-    // Get base config (includes ConfigManager + env vars + defaults)
-    const baseConfig = this.modelProvider.getAIConfig();
-
-    // Apply operation-specific overrides (highest priority)
-    return { ...baseConfig, ...config };
-  }
-
-  /**
-   * Handles Context7 tool results by caching documentation.
-   * Extracts and saves documentation from get-library-docs tool results.
-   *
-   * @param chunk - The chunk to check for Context7 tool results
-   * @protected
-   */
-  protected handleContext7ToolResult(chunk: any): void {
-    if (chunk.type === "tool-result" && chunk.toolName === "get-library-docs") {
-      const docs = chunk.output;
-      const libraryID = chunk.input?.context7CompatibleLibraryID || "unknown";
-      const topic = chunk.input?.topic || "general";
-
-      if (docs && typeof docs === "object" && "content" in docs) {
-        this.context7Client.saveContext7Documentation(
-          libraryID,
-          docs.content,
-          topic
-        );
-      } else if (docs && typeof docs === "string") {
-        this.context7Client.saveContext7Documentation(libraryID, docs, topic);
-      }
-    }
-  }
-
-  async streamText(
-    prompt: string,
-    config?: Partial<AIConfig>,
-    systemPrompt?: string,
-    userMessage?: string,
-    streamingOptions?: StreamingOptions,
-    retryConfig?: Partial<RetryConfig>
-  ): Promise<string> {
-    // Merge config with proper precedence (Bug fix 2.9)
-    const aiConfig = this.mergeAIConfig(config);
-
-    return this.retryHandler.executeWithRetry(
-      async () => {
-        const model = this.modelProvider.getModel(aiConfig);
-
-        const result = streamText({
-          model,
-          system: systemPrompt,
-          messages: [{ role: "user", content: userMessage || prompt }],
-          maxRetries: 0,
-          onError: ({ error }) => {
-            streamingOptions?.onError?.(error);
-            throw error;
-          },
-          onChunk: streamingOptions?.onChunk
-            ? ({ chunk }) => {
-                if (chunk.type === "text-delta") {
-                  streamingOptions.onChunk!(chunk.text);
-                } else if (chunk.type === "reasoning-delta") {
-                  streamingOptions.onReasoning?.(chunk.text);
-                }
-                // Handle Context7 tool result caching
-                this.handleContext7ToolResult(chunk);
-              }
-            : undefined,
-          onFinish: streamingOptions?.onFinish
-            ? ({ text, finishReason, usage }) => {
-                streamingOptions.onFinish!({
-                  text,
-                  finishReason,
-                  usage,
-                  isAborted: false,
-                });
-              }
-            : undefined,
-          ...(aiConfig.provider === "openrouter" &&
-          aiConfig.reasoning &&
-          aiConfig.reasoning.maxTokens
-            ? {
-                providerOptions: {
-                  openrouter: {
-                    reasoning: {
-                      max_tokens: aiConfig.reasoning.maxTokens,
-                    },
-                  },
-                },
-              }
-            : {}),
-        });
-
-        let fullText = "";
-        for await (const textPart of result.textStream) {
-          fullText += textPart;
-        }
-
-        return fullText;
-      },
-      retryConfig,
-      "AI streaming"
-    );
-  }
-}