@codemcp/workflows-core 3.1.22 → 3.2.0

package/src/types.ts

@@ -1,60 +0,0 @@
-/**
- * Common types used across the application
- */
-
-/**
- * Interface for interaction log entries
- */
-export interface InteractionLog {
-  id?: number;
-  conversationId: string;
-  toolName: string;
-  inputParams: string;
-  responseData: string;
-  currentPhase: string;
-  timestamp: string;
-  isReset?: boolean;
-  resetAt?: string;
-}
-
-/**
- * Interface for conversation state
- */
-/**
- * Git commit configuration options
- */
-export interface GitCommitConfig {
-  enabled: boolean;
-  commitOnStep: boolean; // Commit after each step (before whats_next)
-  commitOnPhase: boolean; // Commit after each phase (before phase transition)
-  commitOnComplete: boolean; // Final commit at development end with rebase+squash
-  initialMessage: string; // Initial user message for commit context
-  startCommitHash?: string; // Hash of commit when development started (for squashing)
-}
-
-export interface ConversationState {
-  conversationId: string;
-  projectPath: string;
-  gitBranch: string;
-  currentPhase: string;
-  planFilePath: string;
-  workflowName: string;
-  gitCommitConfig?: GitCommitConfig;
-  requireReviewsBeforePhaseTransition: boolean;
-  createdAt: string;
-  updatedAt: string;
-}
-
-/**
- * Interface for conversation context
- */
-export interface ConversationContext {
-  conversationId: string;
-  projectPath: string;
-  gitBranch: string;
-  currentPhase: string;
-  planFilePath: string;
-  workflowName: string;
-  gitCommitConfig?: GitCommitConfig;
-  requireReviewsBeforePhaseTransition?: boolean;
-}

package/src/workflow-manager.ts

@@ -1,606 +0,0 @@
-/**
- * Workflow Manager
- *
- * Manages multiple predefined workflows and provides workflow discovery and selection
- */
-
-import fs from 'node:fs';
-import path from 'node:path';
-import { createRequire } from 'node:module';
-import { fileURLToPath } from 'node:url';
-import { createLogger } from './logger.js';
-import { StateMachineLoader } from './state-machine-loader.js';
-import { YamlStateMachine } from './state-machine-types.js';
-import { ConfigManager } from './config-manager.js';
-
-const logger = createLogger('WorkflowManager');
-
-export interface WorkflowInfo {
-  name: string;
-  displayName: string;
-  description: string;
-  initialState: string;
-  phases: string[];
-  // Enhanced metadata for better discoverability
-  metadata?: {
-    domain?: string;
-    complexity?: 'low' | 'medium' | 'high';
-    bestFor?: string[];
-    useCases?: string[];
-    examples?: string[];
-  };
-}
-
-/**
- * Manages predefined workflows and provides workflow discovery
- */
-export class WorkflowManager {
-  private predefinedWorkflows: Map<string, YamlStateMachine> = new Map();
-  private projectWorkflows: Map<string, YamlStateMachine> = new Map();
-  private workflowInfos: Map<string, WorkflowInfo> = new Map();
-  private stateMachineLoader: StateMachineLoader;
-  private lastProjectPath: string | null = null; // Track last loaded project path
-  private enabledDomains: Set<string>;
-
-  constructor() {
-    this.stateMachineLoader = new StateMachineLoader();
-    this.enabledDomains = this.parseEnabledDomains();
-    this.loadPredefinedWorkflows();
-  }
-
-  /**
-   * Parse enabled domains from environment variable
-   */
-  private parseEnabledDomains(): Set<string> {
-    const domainsEnv = process.env.VIBE_WORKFLOW_DOMAINS;
-    if (!domainsEnv) {
-      return new Set(['code']);
-    }
-
-    return new Set(
-      domainsEnv
-        .split(',')
-        .map(d => d.trim())
-        .filter(d => d)
-    );
-  }
-
-  /**
-   * Load project-specific workflows from .vibe/workflows/
-   */
-  public loadProjectWorkflows(projectPath: string): void {
-    // Clear project workflows cache if project path changed
-    if (this.lastProjectPath !== projectPath) {
-      this.projectWorkflows.clear();
-      this.lastProjectPath = projectPath;
-    }
-
-    // First, migrate any legacy workflow files
-    this.migrateLegacyWorkflow(projectPath);
-
-    const workflowsDir = path.join(projectPath, '.vibe', 'workflows');
-
-    if (!fs.existsSync(workflowsDir)) {
-      return;
-    }
-
-    try {
-      const files = fs.readdirSync(workflowsDir);
-      const yamlFiles = files.filter(
-        file => file.endsWith('.yaml') || file.endsWith('.yml')
-      );
-
-      for (const file of yamlFiles) {
-        try {
-          const filePath = path.join(workflowsDir, file);
-          const workflow = this.stateMachineLoader.loadFromFile(filePath);
-          const workflowName = workflow.name; // Use name from YAML, not filename
-
-          // Project workflows are always loaded (no domain filtering)
-          this.projectWorkflows.set(workflowName, workflow);
-
-          const workflowInfo: WorkflowInfo = {
-            name: workflowName,
-            displayName: workflow.name,
-            description: workflow.description,
-            initialState: workflow.initial_state,
-            phases: Object.keys(workflow.states),
-            metadata: workflow.metadata,
-          };
-
-          this.workflowInfos.set(workflowName, workflowInfo);
-
-          logger.info('Loaded project workflow', {
-            name: workflowName,
-            domain: workflow.metadata?.domain,
-          });
-        } catch (error) {
-          logger.error('Failed to load project workflow', error as Error, {
-            file,
-          });
-        }
-      }
-    } catch (error) {
-      logger.error(
-        'Failed to scan project workflows directory',
-        error as Error,
-        { workflowsDir }
-      );
-    }
-  }
-
-  /**
-   * Migrate legacy workflow.yaml to new workflows directory
-   */
-  private migrateLegacyWorkflow(projectPath: string): void {
-    const legacyPaths = [
-      path.join(projectPath, '.vibe', 'workflow.yaml'),
-      path.join(projectPath, '.vibe', 'workflow.yml'),
-    ];
-
-    const workflowsDir = path.join(projectPath, '.vibe', 'workflows');
-    const targetPath = path.join(workflowsDir, 'custom.yaml');
-
-    for (const legacyPath of legacyPaths) {
-      if (fs.existsSync(legacyPath) && !fs.existsSync(targetPath)) {
-        try {
-          // Create workflows directory if it doesn't exist
-          if (!fs.existsSync(workflowsDir)) {
-            fs.mkdirSync(workflowsDir, { recursive: true });
-          }
-
-          // Copy the file to new location
-          fs.copyFileSync(legacyPath, targetPath);
-
-          // Remove the old file
-          fs.unlinkSync(legacyPath);
-
-          logger.info('Migrated legacy workflow to new location', {
-            from: legacyPath,
-            to: targetPath,
-          });
-          break;
-        } catch (_error) {
-          logger.error('Failed to migrate legacy workflow');
-        }
-      }
-    }
-  }
-  /**
-   * Get all available workflows regardless of domain filtering
-   */
-  public getAllAvailableWorkflows(): WorkflowInfo[] {
-    // Create a temporary manager with all domains enabled
-    const originalEnv = process.env.VIBE_WORKFLOW_DOMAINS;
-    process.env.VIBE_WORKFLOW_DOMAINS = 'code,architecture,office';
-
-    try {
-      const tempManager = new WorkflowManager();
-      return tempManager.getAvailableWorkflows();
-    } finally {
-      if (originalEnv !== undefined) {
-        process.env.VIBE_WORKFLOW_DOMAINS = originalEnv;
-      } else {
-        delete process.env.VIBE_WORKFLOW_DOMAINS;
-      }
-    }
-  }
-
-  public getAvailableWorkflows(): WorkflowInfo[] {
-    return Array.from(this.workflowInfos.values());
-  }
-
-  /**
-   * Get available workflows for a specific project
-   * Applies configuration filtering and loads project-specific workflows
-   */
-  public getAvailableWorkflowsForProject(projectPath: string): WorkflowInfo[] {
-    // Load project workflows first
-    this.loadProjectWorkflows(projectPath);
-
-    const allWorkflows = this.getAvailableWorkflows();
-
-    // Load project configuration
-    const config = ConfigManager.loadProjectConfig(projectPath);
-
-    // Apply configuration filtering if enabled_workflows is specified
-    let filteredWorkflows = allWorkflows;
-    if (config?.enabled_workflows) {
-      // Validate that all configured workflows exist
-      for (const workflowName of config.enabled_workflows) {
-        if (
-          workflowName !== 'custom' &&
-          !this.isPredefinedWorkflow(workflowName)
-        ) {
-          throw new Error(
-            `Invalid workflow '${workflowName}' in configuration. Available workflows: ${this.getWorkflowNames().join(', ')}, custom`
-          );
-        }
-      }
-
-      // Filter to only enabled workflows
-      filteredWorkflows = allWorkflows.filter(
-        w => config.enabled_workflows?.includes(w.name) ?? false
-      );
-    }
-
-    // Handle custom workflow (only if custom is in enabled list or no config)
-    const customEnabled =
-      !config?.enabled_workflows || config.enabled_workflows.includes('custom');
-    if (customEnabled) {
-      const hasCustomWorkflow = this.validateWorkflowName(
-        'custom',
-        projectPath
-      );
-      if (hasCustomWorkflow) {
-        // Add custom workflow to the list if it exists and is enabled
-        const customWorkflowInfo: WorkflowInfo = {
-          name: 'custom',
-          displayName: 'Custom Workflow',
-          description: 'Project-specific custom workflow',
-          initialState: 'unknown', // Will be determined when loaded
-          phases: [], // Will be determined when loaded
-        };
-        filteredWorkflows.push(customWorkflowInfo);
-      }
-    }
-
-    return filteredWorkflows;
-  }
-
-  /**
-   * Get workflow information by name
-   */
-  public getWorkflowInfo(name: string): WorkflowInfo | undefined {
-    return this.workflowInfos.get(name);
-  }
-
-  /**
-   * Get a specific workflow by name (checks both predefined and project workflows)
-   */
-  public getWorkflow(name: string): YamlStateMachine | undefined {
-    return (
-      this.projectWorkflows.get(name) || this.predefinedWorkflows.get(name)
-    );
-  }
-
-  /**
-   * Check if a workflow name is a predefined workflow
-   */
-  public isPredefinedWorkflow(name: string): boolean {
-    return this.predefinedWorkflows.has(name);
-  }
-
-  /**
-   * Get workflow names as enum values for tool schema
-   * Includes both predefined and project workflows
-   */
-  public getWorkflowNames(): string[] {
-    const predefinedNames = Array.from(this.predefinedWorkflows.keys());
-    const projectNames = Array.from(this.projectWorkflows.keys());
-
-    // Combine and deduplicate (project workflows override predefined ones)
-    const allNames = [...predefinedNames];
-    for (const projectName of projectNames) {
-      if (!allNames.includes(projectName)) {
-        allNames.push(projectName);
-      }
-    }
-
-    return allNames;
-  }
-
-  /**
-   * Load a workflow (predefined or custom) for a project
-   * FIXED: Now respects the workflow parameter correctly
-   */
-  public loadWorkflowForProject(
-    projectPath: string,
-    workflowName?: string
-  ): YamlStateMachine {
-    // Load project workflows first
-    this.loadProjectWorkflows(projectPath);
-
-    // If no workflow specified, use first available workflow
-    if (!workflowName) {
-      const availableWorkflows =
-        this.getAvailableWorkflowsForProject(projectPath);
-      if (availableWorkflows.length === 0) {
-        throw new Error(
-          'No workflows available. Please install a workflow or adjust VIBE_WORKFLOW_DOMAINS environment variable.'
-        );
-      }
-      workflowName = availableWorkflows[0].name;
-    }
-
-    // If it's a predefined workflow, return it
-    if (this.isPredefinedWorkflow(workflowName)) {
-      const workflow = this.getWorkflow(workflowName);
-      if (workflow) {
-        logger.info('Loading predefined workflow', { workflowName });
-        return workflow;
-      }
-    }
-
-    // Check project workflows
-    if (this.projectWorkflows.has(workflowName)) {
-      const workflow = this.projectWorkflows.get(workflowName);
-      if (workflow) {
-        logger.info('Loading project workflow', { workflowName });
-        return workflow;
-      }
-    }
-
-    throw new Error(`Unknown workflow: ${workflowName}`);
-  }
-
-  /**
-   * Find the workflows directory using multiple strategies
-   * This handles both development and npm package deployment scenarios
-   */
-  private findWorkflowsDirectory(): string | null {
-    const currentFileUrl = import.meta.url;
-    const currentFilePath = fileURLToPath(currentFileUrl);
-    const strategies: string[] = [];
-
-    // Strategy 1: Local resources directory (symlinked from root)
-    strategies.push(
-      path.join(path.dirname(currentFilePath), '../resources/workflows')
-    );
-
-    // Strategy 2: Relative to current file (development and direct npm scenarios)
-    // From packages/core/dist/workflow-manager.js -> ../../../../resources/workflows
-    strategies.push(
-      path.resolve(
-        path.dirname(currentFilePath),
-        '../../../../resources/workflows'
-      )
-    );
-
-    // Strategy 3: Find package root by looking for package.json with our package name
-    let currentDir = path.dirname(currentFilePath);
-    for (let i = 0; i < 10; i++) {
-      // Limit search depth
-      const packageJsonPath = path.join(currentDir, 'package.json');
-      if (fs.existsSync(packageJsonPath)) {
-        try {
-          const packageJson = JSON.parse(
-            fs.readFileSync(packageJsonPath, 'utf-8')
-          );
-          if (packageJson.name === '@codemcp/workflows-core') {
-            strategies.push(path.join(currentDir, 'resources/workflows'));
-            break;
-          }
-        } catch (_error) {
-          // Ignore JSON parse errors and continue searching
-        }
-      }
-      const parentDir = path.dirname(currentDir);
-      if (parentDir === currentDir) break; // Reached filesystem root
-      currentDir = parentDir;
-    }
-
-    // Strategy 3: Common npm installation paths
-    // Local node_modules (when used as dependency)
-    strategies.push(
-      path.join(
-        process.cwd(),
-        'node_modules/@codemcp/workflows-core/resources/workflows'
-      )
-    );
-
-    // Global npm installation (when installed globally)
-    if (process.env.NODE_PATH) {
-      strategies.push(
-        path.join(
-          process.env.NODE_PATH,
-          '@codemcp/workflows-core/resources/workflows'
-        )
-      );
-    }
-
-    // Strategy 4: npx cache locations (for npx responsible-vibe-mcp@latest)
-    // npx typically caches packages in ~/.npm/_npx or similar locations
-    const homeDir = process.env.HOME || process.env.USERPROFILE;
-    if (homeDir) {
-      // Common npx cache locations
-      const npxCachePaths = [
-        path.join(homeDir, '.npm/_npx'),
-        path.join(homeDir, '.npm/_cacache'),
-        path.join(homeDir, 'AppData/Local/npm-cache/_npx'), // Windows
-        path.join(homeDir, 'Library/Caches/npm/_npx'), // macOS
-      ];
-
-      for (const cachePath of npxCachePaths) {
-        if (fs.existsSync(cachePath)) {
-          try {
-            // Look for responsible-vibe-mcp in cache subdirectories
-            const cacheEntries = fs.readdirSync(cachePath);
-            for (const entry of cacheEntries) {
-              const entryPath = path.join(cachePath, entry);
-              if (fs.statSync(entryPath).isDirectory()) {
-                // Look for our package in this cache entry
-                const possiblePaths = [
-                  path.join(
-                    entryPath,
-                    'node_modules/@codemcp/workflows-core/resources/workflows'
-                  ),
-                  path.join(
-                    entryPath,
-                    '@codemcp/workflows-core/resources/workflows'
-                  ),
-                ];
-                strategies.push(...possiblePaths);
-              }
-            }
-          } catch (_error) {
-            // Ignore errors reading cache directories
-          }
-        }
-      }
-    }
-
-    // Strategy 5: Look in the directory where the current executable is located
-    // This handles cases where npx runs the package from a temporary location
-    const executableDir = path.dirname(process.argv[1] || '');
-    if (executableDir) {
-      strategies.push(path.join(executableDir, '../resources/workflows'));
-      strategies.push(path.join(executableDir, 'resources/workflows'));
-    }
-
-    // Strategy 6: Use require.resolve to find the package location
-    try {
-      // Try to resolve the package.json of our own package
-      const require = createRequire(import.meta.url);
-      const packagePath = require.resolve('responsible-vibe-mcp/package.json');
-      const packageDir = path.dirname(packagePath);
-      strategies.push(path.join(packageDir, 'resources/workflows'));
-    } catch (_error) {
-      // require.resolve might fail in some environments, that's okay
-    }
-
-    // Remove duplicates and invalid paths
-    const uniqueStrategies = [...new Set(strategies)].filter(
-      p => p.trim() !== '/resources/workflows'
-    );
-
-    // Test each strategy
-    for (const workflowsDir of uniqueStrategies) {
-      logger.debug('Trying workflows directory', { workflowsDir });
-      if (fs.existsSync(workflowsDir)) {
-        // Verify it contains workflow files
-        try {
-          const files = fs.readdirSync(workflowsDir);
-          const yamlFiles = files.filter(
-            file => file.endsWith('.yaml') || file.endsWith('.yml')
-          );
-          if (yamlFiles.length > 0) {
-            logger.info('Found workflows directory', {
-              workflowsDir,
-              yamlFiles: yamlFiles.length,
-            });
-            return workflowsDir;
-          }
-        } catch (error) {
-          // Directory exists but can't read it, continue to next strategy
-          logger.debug('Cannot read workflows directory', {
-            workflowsDir,
-            error,
-          });
-        }
-      }
-    }
-
-    logger.error(
-      'Could not find workflows directory',
-      new Error('Workflows directory not found'),
-      {
-        strategiesCount: uniqueStrategies.length,
-        currentFilePath,
-        strategies: uniqueStrategies,
-      }
-    );
-    return null;
-  }
-
-  /**
-   * Load all predefined workflows from resources/workflows directory
-   */
-  private loadPredefinedWorkflows(): void {
-    try {
-      const workflowsDir = this.findWorkflowsDirectory();
-
-      if (!workflowsDir || !fs.existsSync(workflowsDir)) {
-        logger.warn('Workflows directory not found', { workflowsDir });
-        return;
-      }
-
-      // Read all YAML files in the workflows directory
-      const files = fs.readdirSync(workflowsDir);
-      const yamlFiles = files.filter(
-        file => file.endsWith('.yaml') || file.endsWith('.yml')
-      );
-
-      logger.info('Loading predefined workflows', {
-        workflowsDir,
-        yamlFiles: yamlFiles.length,
-      });
-
-      for (const file of yamlFiles) {
-        try {
-          const filePath = path.join(workflowsDir, file);
-          const workflow = this.stateMachineLoader.loadFromFile(filePath);
-          const workflowName = path.basename(file, path.extname(file));
-
-          // Apply domain filtering
-          if (this.enabledDomains.size > 0 && workflow.metadata?.domain) {
-            if (!this.enabledDomains.has(workflow.metadata.domain)) {
-              logger.debug('Skipping workflow due to domain filter', {
-                name: workflowName,
-                domain: workflow.metadata.domain,
-                enabledDomains: Array.from(this.enabledDomains),
-              });
-              continue;
-            }
-          }
-
-          this.predefinedWorkflows.set(workflowName, workflow);
-
-          const workflowInfo: WorkflowInfo = {
-            name: workflowName,
-            displayName: workflow.name,
-            description: workflow.description,
-            initialState: workflow.initial_state,
-            phases: Object.keys(workflow.states),
-            metadata: workflow.metadata,
-          };
-
-          this.workflowInfos.set(workflowName, workflowInfo);
-
-          logger.info('Loaded predefined workflow', {
-            name: workflowName,
-            domain: workflow.metadata?.domain,
-            phases: workflowInfo.phases.length,
-          });
-        } catch (error) {
-          logger.error('Failed to load workflow file', error as Error, {
-            file,
-          });
-        }
-      }
-
-      logger.info('Predefined workflows loaded', {
-        count: this.predefinedWorkflows.size,
-        workflows: Array.from(this.predefinedWorkflows.keys()),
-      });
-    } catch (error) {
-      logger.error('Failed to load predefined workflows', error as Error);
-    }
-  }
-
-  /**
-   * Validate a workflow name
-   */
-  public validateWorkflowName(
-    workflowName: string,
-    projectPath: string
-  ): boolean {
-    // Check if it's a predefined workflow
-    if (this.isPredefinedWorkflow(workflowName)) {
-      return true;
-    }
-
-    // Check if it's a project workflow (load project workflows first)
-    this.loadProjectWorkflows(projectPath);
-    if (this.projectWorkflows.has(workflowName)) {
-      return true;
-    }
-
-    // Also check workflow infos in case workflow failed to load but info was created
-    if (this.workflowInfos.has(workflowName)) {
-      return true;
-    }
-
-    return false;
-  }
-}