@codemcp/workflows 5.3.0 → 6.0.1

package/packages/cli/dist/index.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+import { existsSync } from "fs";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname(__filename);
+var args = process.argv.slice(2);
+if (args.length === 0) {
+  const isLocal = existsSync(join(__dirname, "../../mcp-server/dist/index.js"));
+  if (isLocal) {
+    import("./dist-UGVUJIDN.js");
+  } else {
+    const mcpServerModule = "@codemcp/workflows-server";
+    import(mcpServerModule);
+  }
+} else {
+  const { runCli } = await import("./cli-CZ4FMSWR.js");
+  await runCli();
+}

package/packages/cli/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@codemcp/workflows-cli",
+  "version": "6.0.1",
+  "description": "CLI tools for responsible-vibe development workflows",
+  "type": "module",
+  "scripts": {
+    "build": "tsup && pnpm copy-resources",
+    "copy-resources": "rm -rf resources && cp -r ../core/resources .",
+    "build:tsc": "tsc -p tsconfig.build.json",
+    "test": "vitest --run",
+    "clean:build": "rimraf ./dist",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint --fix .",
+    "format:check": "prettier --check .",
+    "format": "prettier --write ."
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@codemcp/workflows-core": "workspace:*",
+    "@codemcp/workflows-server": "workspace:*",
+    "@types/node": "^22.0.0",
+    "rimraf": "^5.0.10",
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "4.0.18"
+  },
+  "private": true
+}

package/packages/core/dist/beads-integration.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Beads Integration Utilities
+ *
+ * Provides utilities for integrating with beads distributed issue tracker:
+ * - Project epic creation
+ * - Phase task management
+ * - Task hierarchy setup
+ */
+import { YamlState } from './state-machine-types.js';
+export interface BeadsPhaseTask {
+    phaseId: string;
+    phaseName: string;
+    taskId: string;
+}
+/**
+ * Beads integration manager for the workflows server
+ */
+export declare class BeadsIntegration {
+    private projectPath;
+    constructor(projectPath: string);
+    /**
+     * Ensure beads is initialized in the project directory
+     */
+    private ensureBeadsInitialized;
+    /**
+     * Create a project epic in beads for the development session
+     */
+    createProjectEpic(projectName: string, workflowName: string, description?: string, planFilename?: string): Promise<string>;
+    /**
+     * Create phase tasks for all workflow phases under the project epic
+     */
+    createPhaseTasks(epicId: string, phases: Record<string, YamlState>, workflowName: string): Promise<BeadsPhaseTask[]>;
+    /**
+     * Create sequential dependencies between workflow phase tasks
+     * Implements graceful error handling: logs warnings for failed dependencies but continues
+     */
+    createPhaseDependencies(phaseTasks: BeadsPhaseTask[]): Promise<void>;
+    /**
+     * Capitalize phase name for display
+     */
+    private capitalizePhase;
+    /**
+     * Validate parameters for epic creation
+     */
+    private validateCreateEpicParameters;
+    /**
+     * Validate parameters for phase task creation
+     */
+    private validateCreatePhaseParameters;
+}

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;
+}