@codemcp/workflows 5.3.0 → 6.0.2

package/packages/core/dist/beads-integration.js

@@ -0,0 +1,387 @@
+/**
+ * Beads Integration Utilities
+ *
+ * Provides utilities for integrating with beads distributed issue tracker:
+ * - Project epic creation
+ * - Phase task management
+ * - Task hierarchy setup
+ */
+import { execSync } from 'node:child_process';
+import { createLogger } from './logger.js';
+const logger = createLogger('BeadsIntegration');
+/**
+ * Beads integration manager for the workflows server
+ */
+export class BeadsIntegration {
+    projectPath;
+    constructor(projectPath) {
+        this.projectPath = projectPath;
+    }
+    /**
+     * Ensure beads is initialized in the project directory
+     */
+    async ensureBeadsInitialized() {
+        try {
+            // Check if beads is already initialized by running a simple command
+            execSync('bd list --limit 1', {
+                cwd: this.projectPath,
+                encoding: 'utf-8',
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            // If we get here, beads is already initialized
+            return;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // Check if the error suggests beads is not initialized
+            if (errorMessage.includes('not initialized') ||
+                errorMessage.includes('no database') ||
+                errorMessage.includes('init')) {
+                logger.info('Beads not initialized, running bd init --no-db', {
+                    projectPath: this.projectPath,
+                });
+                try {
+                    // Initialize beads without database
+                    execSync('bd init --no-db', {
+                        cwd: this.projectPath,
+                        encoding: 'utf-8',
+                        stdio: ['ignore', 'pipe', 'pipe'],
+                    });
+                    logger.info('Successfully initialized beads in project', {
+                        projectPath: this.projectPath,
+                    });
+                }
+                catch (initError) {
+                    const initErrorMessage = initError instanceof Error ? initError.message : String(initError);
+                    logger.error('Failed to initialize beads', initError instanceof Error
+                        ? initError
+                        : new Error(initErrorMessage), { projectPath: this.projectPath });
+                    throw new Error(`Failed to initialize beads: ${initErrorMessage}`);
+                }
+            }
+            else {
+                // Some other beads error, re-throw
+                throw error;
+            }
+        }
+    }
+    /**
+     * Create a project epic in beads for the development session
+     */
+    async createProjectEpic(projectName, workflowName, description, planFilename) {
+        // Validate parameters first
+        this.validateCreateEpicParameters(projectName, workflowName, description, planFilename);
+        // Ensure beads is initialized
+        await this.ensureBeadsInitialized();
+        const epicTitle = planFilename
+            ? `${projectName}: ${workflowName} (${planFilename})`
+            : `${projectName}: ${workflowName}`;
+        const epicDescription = description ||
+            `Responsible vibe engineering session using ${workflowName} workflow for ${projectName}`;
+        const priority = 2;
+        const command = `bd create "${epicTitle}" --description "${epicDescription}" --priority ${priority}`;
+        logger.debug('Creating beads project epic', {
+            command,
+            projectName,
+            workflowName,
+            projectPath: this.projectPath,
+        });
+        try {
+            const output = execSync(command, {
+                cwd: this.projectPath,
+                encoding: 'utf-8',
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            // Extract task ID from beads output
+            // Support both new format (v0.47.1+): "✓ Created issue: project-name-123"
+            // and legacy format: "Created bd-a1b2c3"
+            const match = output.match(/✓ Created issue: ([\w\d.-]+)/) ||
+                output.match(/Created issue: ([\w\d.-]+)/) ||
+                output.match(/Created (bd-[\w\d.]+)/);
+            if (!match) {
+                logger.warn('Failed to extract task ID from beads output', {
+                    command: `bd create "${epicTitle}" --description "${epicDescription}" --priority 2`,
+                    output: output.slice(0, 200), // Truncated for logging
+                });
+                throw new Error(`Failed to extract task ID from beads output: ${output.slice(0, 100)}...`);
+            }
+            const epicId = match[1] || '';
+            logger.info('Created beads project epic', {
+                epicId,
+                epicTitle,
+                projectPath: this.projectPath,
+            });
+            return epicId;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            const commandInfo = {
+                command,
+                projectName,
+                workflowName,
+                projectPath: this.projectPath,
+            };
+            logger.error('Failed to create beads project epic', error instanceof Error ? error : new Error(errorMessage), commandInfo);
+            // Include stderr if available for better debugging
+            const execError = error;
+            if (execError?.stderr) {
+                logger.error('Beads command stderr output', new Error('Command stderr'), {
+                    stderr: execError.stderr.toString(),
+                    ...commandInfo,
+                });
+            }
+            throw new Error(`Failed to create beads project epic: ${errorMessage}`);
+        }
+    }
+    /**
+     * Create phase tasks for all workflow phases under the project epic
+     */
+    async createPhaseTasks(epicId, phases, workflowName) {
+        // Validate parameters
+        this.validateCreatePhaseParameters(epicId, phases, workflowName);
+        const phaseTasks = [];
+        const phaseNames = Object.keys(phases);
+        for (const phase of phaseNames) {
+            const phaseTitle = `${this.capitalizePhase(phase)}`;
+            const priority = 3;
+            const stateDefinition = phases[phase];
+            // Escape the description to prevent shell injection and handle special characters
+            const description = (stateDefinition?.default_instructions ||
+                `${workflowName} workflow ${phase} phase tasks`)
+                .replace(/"/g, '\\"') // Escape double quotes
+                .replace(/\n/g, ' ') // Replace newlines with spaces
+                .replace(/\r/g, '') // Remove carriage returns
+                .trim();
+            const command = `bd create "${phaseTitle}" --description "${description}" --parent ${epicId} --priority ${priority}`;
+            logger.debug('Creating beads phase task', {
+                command,
+                phase,
+                epicId,
+                projectPath: this.projectPath,
+            });
+            try {
+                const output = execSync(command, {
+                    cwd: this.projectPath,
+                    encoding: 'utf-8',
+                    stdio: ['ignore', 'pipe', 'pipe'],
+                });
+                // Extract task ID from beads output
+                // Support both new format (v0.47.1+): "✓ Created issue: project-name-123"
+                // and legacy format: "Created bd-a1b2c3"
+                const match = output.match(/✓ Created issue: ([\w\d.-]+)/) ||
+                    output.match(/Created issue: ([\w\d.-]+)/) ||
+                    output.match(/Created (bd-[\w\d.]+)/);
+                if (!match) {
+                    logger.warn('Failed to extract phase task ID from beads output', {
+                        command,
+                        output: output.slice(0, 200), // Truncated for logging
+                    });
+                    throw new Error(`Failed to extract task ID from beads output: ${output.slice(0, 100)}...`);
+                }
+                const phaseTaskId = match[1] || '';
+                phaseTasks.push({
+                    phaseId: phase,
+                    phaseName: phaseTitle,
+                    taskId: phaseTaskId,
+                });
+                logger.debug('Created beads phase task', {
+                    phase,
+                    phaseTaskId,
+                    epicId,
+                    projectPath: this.projectPath,
+                });
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                const commandInfo = {
+                    command,
+                    phase,
+                    epicId,
+                    projectPath: this.projectPath,
+                };
+                logger.error('Failed to create beads phase task', error instanceof Error ? error : new Error(errorMessage), commandInfo);
+                // Include stderr if available for better debugging
+                const execError = error;
+                if (execError?.stderr) {
+                    logger.error('Beads phase command stderr output', new Error('Command stderr'), {
+                        stderr: execError.stderr.toString(),
+                        ...commandInfo,
+                    });
+                }
+                throw new Error(`Failed to create beads phase task for ${phase}: ${errorMessage}`);
+            }
+        }
+        logger.info('Created all beads phase tasks', {
+            count: phaseTasks.length,
+            epicId,
+            projectPath: this.projectPath,
+        });
+        return phaseTasks;
+    }
+    /**
+     * Create sequential dependencies between workflow phase tasks
+     * Implements graceful error handling: logs warnings for failed dependencies but continues
+     */
+    async createPhaseDependencies(phaseTasks) {
+        if (phaseTasks.length < 2) {
+            logger.debug('Skipping phase dependencies - less than 2 phases', {
+                phaseCount: phaseTasks.length,
+                projectPath: this.projectPath,
+            });
+            return;
+        }
+        logger.info('Creating sequential phase dependencies', {
+            phaseCount: phaseTasks.length,
+            projectPath: this.projectPath,
+        });
+        // Track failed dependencies for logging
+        const failedDependencies = [];
+        // Create dependencies in sequence: each phase blocks the next one
+        for (let i = 0; i < phaseTasks.length - 1; i++) {
+            const currentPhase = phaseTasks[i];
+            const nextPhase = phaseTasks[i + 1];
+            if (!currentPhase || !nextPhase) {
+                logger.warn('Skipping phase dependency - missing phase data', {
+                    currentPhaseIndex: i,
+                    nextPhaseIndex: i + 1,
+                    totalPhases: phaseTasks.length,
+                    projectPath: this.projectPath,
+                });
+                failedDependencies.push({
+                    from: `Phase ${i}`,
+                    to: `Phase ${i + 1}`,
+                    error: 'Missing phase data',
+                });
+                continue;
+            }
+            const command = `bd dep ${currentPhase.taskId} --blocks ${nextPhase.taskId}`;
+            logger.debug('Creating phase dependency', {
+                command,
+                currentPhase: currentPhase.phaseName,
+                nextPhase: nextPhase.phaseName,
+                currentTaskId: currentPhase.taskId,
+                nextTaskId: nextPhase.taskId,
+                projectPath: this.projectPath,
+            });
+            try {
+                execSync(command, {
+                    cwd: this.projectPath,
+                    encoding: 'utf-8',
+                    stdio: ['ignore', 'pipe', 'pipe'],
+                });
+                logger.debug('Successfully created phase dependency', {
+                    currentPhase: currentPhase.phaseName,
+                    nextPhase: nextPhase.phaseName,
+                    projectPath: this.projectPath,
+                });
+            }
+            catch (error) {
+                // Log as warning but don't fail the entire setup
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                logger.warn('Failed to create phase dependency - continuing anyway', {
+                    error: errorMessage,
+                    command,
+                    currentPhase: currentPhase.phaseName,
+                    nextPhase: nextPhase.phaseName,
+                    projectPath: this.projectPath,
+                });
+                // Include stderr if available for better debugging
+                const execError = error;
+                if (execError?.stderr) {
+                    logger.debug('Beads dependency command stderr', {
+                        stderr: execError.stderr.toString(),
+                        command,
+                        projectPath: this.projectPath,
+                    });
+                }
+                // Track failed dependency but continue
+                failedDependencies.push({
+                    from: currentPhase.phaseName,
+                    to: nextPhase.phaseName,
+                    error: errorMessage,
+                });
+            }
+        }
+        if (failedDependencies.length > 0) {
+            logger.warn('Some phase dependencies could not be created - app continues without these dependencies', {
+                failedCount: failedDependencies.length,
+                failedDependencies,
+                projectPath: this.projectPath,
+            });
+        }
+        logger.info('Completed phase dependency creation', {
+            dependencyCount: phaseTasks.length - 1,
+            successCount: phaseTasks.length - 1 - failedDependencies.length,
+            failedCount: failedDependencies.length,
+            projectPath: this.projectPath,
+        });
+    }
+    /**
+     * Capitalize phase name for display
+     */
+    capitalizePhase(phase) {
+        return phase
+            .split('_')
+            .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+            .join(' ');
+    }
+    /**
+     * Validate parameters for epic creation
+     */
+    validateCreateEpicParameters(projectName, workflowName, description, planFilename) {
+        if (!projectName ||
+            typeof projectName !== 'string' ||
+            projectName.trim() === '') {
+            throw new Error('Project name is required and cannot be empty');
+        }
+        if (!workflowName ||
+            typeof workflowName !== 'string' ||
+            workflowName.trim() === '') {
+            throw new Error('Workflow name is required and cannot be empty');
+        }
+        // Optional description validation - if provided, must be a valid string
+        if (description !== undefined &&
+            (typeof description !== 'string' || description.trim() === '')) {
+            throw new Error('Description, if provided, must be a non-empty string');
+        }
+        // Optional plan filename validation - if provided, must be a valid string
+        if (planFilename !== undefined &&
+            (typeof planFilename !== 'string' || planFilename.trim() === '')) {
+            throw new Error('Plan filename, if provided, must be a non-empty string');
+        }
+    }
+    /**
+     * Validate parameters for phase task creation
+     */
+    validateCreatePhaseParameters(epicId, phases, workflowName) {
+        if (!epicId || typeof epicId !== 'string' || epicId.trim() === '') {
+            throw new Error('Epic ID is required and cannot be empty');
+        }
+        if (!phases ||
+            typeof phases !== 'object' ||
+            Object.keys(phases).length === 0) {
+            throw new Error('Phases object is required and cannot be empty');
+        }
+        if (!workflowName ||
+            typeof workflowName !== 'string' ||
+            workflowName.trim() === '') {
+            throw new Error('Workflow name is required and cannot be empty');
+        }
+        // Validate each phase
+        for (const [phaseName, phaseState] of Object.entries(phases)) {
+            if (!phaseName ||
+                typeof phaseName !== 'string' ||
+                phaseName.trim() === '') {
+                throw new Error(`Invalid phase name: "${phaseName}" - phase names must be non-empty strings`);
+            }
+            if (!phaseState || typeof phaseState !== 'object') {
+                throw new Error(`Invalid phase state for "${phaseName}" - phase states must be objects`);
+            }
+            if (!phaseState.default_instructions ||
+                typeof phaseState.default_instructions !== 'string') {
+                throw new Error(`Invalid phase state for "${phaseName}" - default_instructions must be a non-empty string`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=beads-integration.js.map

package/packages/core/dist/beads-integration.js.map

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

package/packages/core/dist/beads-state-manager.d.ts

@@ -0,0 +1,58 @@
+/**
+ * BeadsStateManager
+ *
+ * Manages beads-specific conversation state including phase task mappings
+ * and epic information. Provides persistent storage for beads integration
+ * data with proper separation of concerns from conversation management.
+ */
+import type { BeadsPhaseTask } from './beads-integration.js';
+/**
+ * Beads-specific conversation state
+ */
+export interface BeadsConversationState {
+    conversationId: string;
+    projectPath: string;
+    epicId: string;
+    phaseTasks: BeadsPhaseTask[];
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Manager for beads conversation state persistence
+ */
+export declare class BeadsStateManager {
+    private projectPath;
+    constructor(projectPath: string);
+    /**
+     * Get the path to the beads state file for a conversation
+     */
+    private getBeadsStatePath;
+    /**
+     * Create beads state for a conversation
+     */
+    createState(conversationId: string, epicId: string, phaseTasks: BeadsPhaseTask[]): Promise<BeadsConversationState>;
+    /**
+     * Get beads state for a conversation
+     */
+    getState(conversationId: string): Promise<BeadsConversationState | null>;
+    /**
+     * Get phase task ID for a specific phase
+     */
+    getPhaseTaskId(conversationId: string, phase: string): Promise<string | null>;
+    /**
+     * Update beads state for a conversation
+     */
+    updateState(conversationId: string, updates: Partial<Omit<BeadsConversationState, 'conversationId' | 'createdAt'>>): Promise<BeadsConversationState | null>;
+    /**
+     * Clean up beads state for a conversation
+     */
+    cleanup(conversationId: string): Promise<void>;
+    /**
+     * Check if beads state exists for a conversation
+     */
+    hasState(conversationId: string): Promise<boolean>;
+    /**
+     * Save beads state to file
+     */
+    private saveState;
+}

package/packages/core/dist/beads-state-manager.js

@@ -0,0 +1,212 @@
+/**
+ * BeadsStateManager
+ *
+ * Manages beads-specific conversation state including phase task mappings
+ * and epic information. Provides persistent storage for beads integration
+ * data with proper separation of concerns from conversation management.
+ */
+import { writeFile, readFile, mkdir, access } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { createLogger } from './logger.js';
+const logger = createLogger('BeadsStateManager');
+/**
+ * Manager for beads conversation state persistence
+ */
+export class BeadsStateManager {
+    projectPath;
+    constructor(projectPath) {
+        this.projectPath = projectPath;
+    }
+    /**
+     * Get the path to the beads state file for a conversation
+     */
+    getBeadsStatePath(conversationId) {
+        return join(this.projectPath, '.vibe', `beads-state-${conversationId}.json`);
+    }
+    /**
+     * Create beads state for a conversation
+     */
+    async createState(conversationId, epicId, phaseTasks) {
+        const state = {
+            conversationId,
+            projectPath: this.projectPath,
+            epicId,
+            phaseTasks,
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        };
+        await this.saveState(state);
+        logger.info('Created beads conversation state', {
+            conversationId,
+            epicId,
+            phaseCount: phaseTasks.length,
+            projectPath: this.projectPath,
+        });
+        return state;
+    }
+    /**
+     * Get beads state for a conversation
+     */
+    async getState(conversationId) {
+        const statePath = this.getBeadsStatePath(conversationId);
+        try {
+            // Check if file exists
+            await access(statePath);
+            const content = await readFile(statePath, 'utf-8');
+            const state = JSON.parse(content);
+            logger.debug('Retrieved beads conversation state', {
+                conversationId,
+                epicId: state.epicId,
+                phaseCount: state.phaseTasks.length,
+                projectPath: this.projectPath,
+            });
+            return state;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                // File doesn't exist - this is normal for conversations without beads
+                logger.debug('No beads state found for conversation', {
+                    conversationId,
+                    projectPath: this.projectPath,
+                });
+                return null;
+            }
+            // Other errors (permission, invalid JSON, etc.)
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.warn('Failed to read beads state file', {
+                error: errorMessage,
+                conversationId,
+                statePath,
+                projectPath: this.projectPath,
+            });
+            return null;
+        }
+    }
+    /**
+     * Get phase task ID for a specific phase
+     */
+    async getPhaseTaskId(conversationId, phase) {
+        const state = await this.getState(conversationId);
+        if (!state) {
+            return null;
+        }
+        const phaseTask = state.phaseTasks.find(task => task.phaseId === phase);
+        if (phaseTask) {
+            logger.debug('Found phase task ID', {
+                conversationId,
+                phase,
+                taskId: phaseTask.taskId,
+                projectPath: this.projectPath,
+            });
+            return phaseTask.taskId;
+        }
+        logger.debug('No task ID found for phase', {
+            conversationId,
+            phase,
+            availablePhases: state.phaseTasks.map(t => t.phaseId),
+            projectPath: this.projectPath,
+        });
+        return null;
+    }
+    /**
+     * Update beads state for a conversation
+     */
+    async updateState(conversationId, updates) {
+        const existingState = await this.getState(conversationId);
+        if (!existingState) {
+            logger.warn('Cannot update non-existent beads state', {
+                conversationId,
+                projectPath: this.projectPath,
+            });
+            return null;
+        }
+        const updatedState = {
+            ...existingState,
+            ...updates,
+            conversationId, // Ensure conversationId doesn't change
+            updatedAt: new Date().toISOString(),
+        };
+        await this.saveState(updatedState);
+        logger.info('Updated beads conversation state', {
+            conversationId,
+            updatedFields: Object.keys(updates),
+            projectPath: this.projectPath,
+        });
+        return updatedState;
+    }
+    /**
+     * Clean up beads state for a conversation
+     */
+    async cleanup(conversationId) {
+        const statePath = this.getBeadsStatePath(conversationId);
+        try {
+            await access(statePath);
+            await writeFile(statePath + '.backup', await readFile(statePath));
+            logger.info('Cleaned up beads conversation state', {
+                conversationId,
+                statePath,
+                projectPath: this.projectPath,
+            });
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                // File doesn't exist - nothing to clean up
+                logger.debug('No beads state to clean up', {
+                    conversationId,
+                    projectPath: this.projectPath,
+                });
+                return;
+            }
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.warn('Failed to clean up beads state', {
+                error: errorMessage,
+                conversationId,
+                statePath,
+                projectPath: this.projectPath,
+            });
+        }
+    }
+    /**
+     * Check if beads state exists for a conversation
+     */
+    async hasState(conversationId) {
+        const statePath = this.getBeadsStatePath(conversationId);
+        try {
+            await access(statePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Save beads state to file
+     */
+    async saveState(state) {
+        const statePath = this.getBeadsStatePath(state.conversationId);
+        const stateDir = dirname(statePath);
+        try {
+            // Ensure .vibe directory exists
+            await mkdir(stateDir, { recursive: true });
+            // Write state with pretty formatting for readability
+            const content = JSON.stringify(state, null, 2);
+            await writeFile(statePath, content, 'utf-8');
+            logger.debug('Saved beads state to file', {
+                conversationId: state.conversationId,
+                statePath,
+                fileSize: content.length,
+                projectPath: this.projectPath,
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error('Failed to save beads state', error instanceof Error ? error : new Error(errorMessage), {
+                conversationId: state.conversationId,
+                statePath,
+                projectPath: this.projectPath,
+            });
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=beads-state-manager.js.map