task-o-matic-core 0.1.0

package/src/lib/index.ts

@@ -0,0 +1,166 @@
+/**
+ * task-o-matic Library Entry Point
+ *
+ * This module exports the core services, types, and utilities for using
+ * task-o-matic as a library in TUI, web applications, or other Node.js projects.
+ *
+ * @example
+ * ```typescript
+ * import { TaskService, Task, AIConfig } from 'task-o-matic';
+ *
+ * const taskService = new TaskService();
+ * const result = await taskService.createTask({
+ *   title: 'My Task',
+ *   content: 'Task description',
+ *   aiEnhance: true
+ * });
+ * ```
+ */
+
+// ============================================================================
+// Main Services - Business Logic Layer
+// ============================================================================
+
+/**
+ * TaskService - Core task management operations
+ * Handles creating, updating, listing, enhancing, splitting, and planning tasks
+ */
+export { TaskService } from "../services/tasks";
+
+/**
+ * PRDService - Product Requirements Document parsing and processing
+ * Handles PRD parsing, task extraction, and PRD improvement
+ */
+export { PRDService } from "../services/prd";
+
+/**
+ * WorkflowService - Complete workflow orchestration
+ * Handles project initialization, PRD management, task generation, and task splitting
+ */
+export { WorkflowService } from "../services/workflow";
+
+/**
+ * BenchmarkService - AI model benchmarking
+ * Handles running benchmarks, storing results, and comparing models
+ */
+export { BenchmarkService } from "../services/benchmark";
+
+// ============================================================================
+// Result Types - Service Operation Results
+// ============================================================================
+
+/**
+ * Result types for workflow service operations
+ */
+export type {
+  InitializeResult,
+  DefinePRDResult,
+  RefinePRDResult,
+  GenerateTasksResult,
+  SplitTasksResult,
+} from "../types/workflow-results";
+
+// ============================================================================
+// Core Types - Type Definitions
+// ============================================================================
+
+/**
+ * Re-export all types from the types module
+ * Includes Task, AIConfig, StreamingOptions, and all related interfaces
+ */
+export * from "../types";
+
+/**
+ * Re-export callback types
+ */
+export type { ProgressCallback } from "../types/callbacks";
+
+/**
+ * Re-export option types
+ */
+export type {
+  CreateTaskOptions,
+  SplitTaskOptions,
+  PlanTaskOptions,
+  EnhanceTaskOptions,
+} from "../types/options";
+
+// ============================================================================
+// Utility Factories - Singleton Service Instances
+// ============================================================================
+
+/**
+ * Factory functions for getting singleton instances of core services
+ * These ensure only one instance exists throughout the application
+ */
+export {
+  getAIOperations,
+  getModelProvider,
+  getStorage,
+  getContextBuilder,
+  resetServiceInstances,
+  initializeServices,
+} from "../utils/ai-service-factory";
+
+/**
+ * AI configuration builder utility
+ */
+export { buildAIConfig } from "../utils/ai-config-builder";
+export type { AIOptions } from "../utils/ai-config-builder";
+
+// ============================================================================
+// Core Classes - Direct Class Exports
+// ============================================================================
+
+/**
+ * LocalStorage - File-based storage abstraction for tasks and metadata
+ * Note: This is Node.js file-system based and not compatible with browser environments
+ */
+export { FileSystemStorage } from "./storage/file-system";
+export type { TaskRepository } from "./storage/types";
+
+/**
+ * ConfigManager - Configuration management for task-o-matic projects
+ */
+export { ConfigManager, configManager } from "./config";
+
+/**
+ * AIOperations - AI service operations wrapper
+ */
+export { AIOperations } from "./ai-service/ai-operations";
+
+/**
+ * ModelProvider - AI model provider abstraction
+ */
+export { ModelProvider } from "./ai-service/model-provider";
+
+/**
+ * ContextBuilder - Task context assembly for AI operations
+ */
+export { ContextBuilder } from "./context-builder";
+
+/**
+ * PromptBuilder - Prompt template management
+ */
+export { PromptBuilder } from "./prompt-builder";
+
+// ============================================================================
+// Utilities
+// ============================================================================
+
+/**
+ * Stack formatter utility
+ */
+export { formatStackInfo } from "../utils/stack-formatter";
+
+// Streaming options builders moved to CLI package
+// import from packages/cli/src/utils/streaming-options.ts instead
+
+// ============================================================================
+// Validation
+// ============================================================================
+
+/**
+ * Validation utilities
+ */
+export { isValidAIProvider, runValidations } from "./validation";

package/src/lib/logger.ts

@@ -0,0 +1,43 @@
+/**
+ * Logger - Thin wrapper that emits log events to the hooks system
+ *
+ * This decouples logging from direct console output, allowing:
+ * - CLI to render styled chalk output by subscribing to events
+ * - Web/TUI to handle logs differently
+ * - Testing without console pollution
+ */
+
+import { hooks } from "./hooks";
+
+export interface Logger {
+  info(message: string, context?: Record<string, unknown>): void;
+  warn(message: string, context?: Record<string, unknown>): void;
+  error(message: string, context?: Record<string, unknown>): void;
+  success(message: string, context?: Record<string, unknown>): void;
+  progress(message: string, context?: Record<string, unknown>): void;
+}
+
+/**
+ * Event-based logger that emits to the hooks system
+ */
+export const logger: Logger = {
+  info(message: string, context?: Record<string, unknown>) {
+    hooks.emit("log:info", { message, context });
+  },
+
+  warn(message: string, context?: Record<string, unknown>) {
+    hooks.emit("log:warn", { message, context });
+  },
+
+  error(message: string, context?: Record<string, unknown>) {
+    hooks.emit("log:error", { message, context });
+  },
+
+  success(message: string, context?: Record<string, unknown>) {
+    hooks.emit("log:success", { message, context });
+  },
+
+  progress(message: string, context?: Record<string, unknown>) {
+    hooks.emit("log:progress", { message, context });
+  },
+};

package/src/lib/notifications.ts

@@ -0,0 +1,103 @@
+import { exec } from "child_process";
+import { promisify } from "util";
+import { logger } from "./logger";
+import type { ExecuteLoopResult } from "../types";
+
+const execAsync = promisify(exec);
+
+/**
+ * Send notifications after loop completion
+ * Supports both URLs (POST request) and commands (execute with env var)
+ */
+export async function sendNotifications(
+  targets: string[],
+  result: ExecuteLoopResult
+): Promise<void> {
+  if (!targets || targets.length === 0) return;
+
+  const summary = {
+    totalTasks: result.totalTasks,
+    completedTasks: result.completedTasks,
+    failedTasks: result.failedTasks,
+    duration: result.duration,
+    success: result.failedTasks === 0,
+  };
+
+  for (const target of targets) {
+    try {
+      if (target.startsWith("http://") || target.startsWith("https://")) {
+        await postToUrl(target, result);
+      } else {
+        await executeCommand(target, summary);
+      }
+    } catch (error) {
+      logger.warn(
+        `⚠️  Notification failed for ${target}: ${
+          error instanceof Error ? error.message : "Unknown error"
+        }`
+      );
+    }
+  }
+}
+
+/**
+ * POST result to a URL
+ */
+async function postToUrl(
+  url: string,
+  result: ExecuteLoopResult
+): Promise<void> {
+  logger.info(`📤 Sending notification to ${url}`);
+
+  try {
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify(result),
+    });
+
+    if (response.ok) {
+      logger.success(`✅ Notification sent to ${url}`);
+    } else {
+      logger.warn(`⚠️  Notification to ${url} returned ${response.status}`);
+    }
+  } catch (error) {
+    throw new Error(
+      `Failed to POST to ${url}: ${
+        error instanceof Error ? error.message : "Unknown error"
+      }`
+    );
+  }
+}
+
+/**
+ * Execute a command with result in environment variable
+ */
+async function executeCommand(
+  command: string,
+  summary: Record<string, unknown>
+): Promise<void> {
+  logger.info(`🔔 Running notification command: ${command}`);
+
+  try {
+    await execAsync(command, {
+      env: {
+        ...process.env,
+        TASK_LOOP_RESULT: JSON.stringify(summary),
+        TASK_LOOP_TOTAL: String(summary.totalTasks),
+        TASK_LOOP_COMPLETED: String(summary.completedTasks),
+        TASK_LOOP_FAILED: String(summary.failedTasks),
+        TASK_LOOP_SUCCESS: String(summary.success),
+      },
+    });
+    logger.success(`✅ Notification command completed`);
+  } catch (error) {
+    throw new Error(
+      `Command failed: ${
+        error instanceof Error ? error.message : "Unknown error"
+      }`
+    );
+  }
+}