@codemcp/workflows 5.3.0 → 6.0.1

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

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

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

package/packages/core/dist/config-manager.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Configuration Manager
+ *
+ * Handles loading and validation of project configuration from .vibe/config.yaml
+ */
+export interface ProjectConfig {
+    enabled_workflows?: string[];
+}
+/**
+ * Manages project configuration loading and validation
+ */
+export declare class ConfigManager {
+    private static readonly CONFIG_FILENAME;
+    /**
+     * Load project configuration from .vibe/config.yaml
+     * Returns null if no config file exists (backward compatibility)
+     * Throws error for invalid configuration
+     */
+    static loadProjectConfig(projectPath: string): ProjectConfig | null;
+    /**
+     * Validate configuration structure and content
+     */
+    private static validateConfig;
+}

package/packages/core/dist/config-manager.js

@@ -0,0 +1,68 @@
+/**
+ * Configuration Manager
+ *
+ * Handles loading and validation of project configuration from .vibe/config.yaml
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import yaml from 'js-yaml';
+import { createLogger } from './logger.js';
+const logger = createLogger('ConfigManager');
+/**
+ * Manages project configuration loading and validation
+ */
+export class ConfigManager {
+    static CONFIG_FILENAME = 'config.yaml';
+    /**
+     * Load project configuration from .vibe/config.yaml
+     * Returns null if no config file exists (backward compatibility)
+     * Throws error for invalid configuration
+     */
+    static loadProjectConfig(projectPath) {
+        const configPath = path.join(projectPath, '.vibe', this.CONFIG_FILENAME);
+        // No config file = backward compatibility (all workflows available)
+        if (!fs.existsSync(configPath)) {
+            logger.debug('No config file found, using defaults', { configPath });
+            return null;
+        }
+        try {
+            const configContent = fs.readFileSync(configPath, 'utf-8');
+            const config = yaml.load(configContent);
+            this.validateConfig(config, configPath);
+            logger.info('Loaded project configuration', {
+                configPath,
+                enabledWorkflows: config.enabled_workflows?.length || 0,
+            });
+            return config;
+        }
+        catch (error) {
+            if (error instanceof yaml.YAMLException) {
+                throw new Error(`Invalid YAML in config file ${configPath}: ${error.message}`);
+            }
+            throw new Error(`Failed to load config file ${configPath}: ${error}`);
+        }
+    }
+    /**
+     * Validate configuration structure and content
+     */
+    static validateConfig(config, configPath) {
+        if (!config || typeof config !== 'object') {
+            throw new Error(`Invalid config file ${configPath}: must be a YAML object`);
+        }
+        if (config.enabled_workflows !== undefined) {
+            if (!Array.isArray(config.enabled_workflows)) {
+                throw new Error(`Invalid config file ${configPath}: enabled_workflows must be an array`);
+            }
+            if (config.enabled_workflows.length === 0) {
+                throw new Error(`Invalid config file ${configPath}: enabled_workflows cannot be empty`);
+            }
+            // Validate all entries are strings
+            for (const workflow of config.enabled_workflows) {
+                if (typeof workflow !== 'string' || workflow.trim() === '') {
+                    throw new Error(`Invalid config file ${configPath}: all workflow names must be non-empty strings`);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=config-manager.js.map

package/packages/core/dist/config-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.js","sourceRoot":"","sources":["../src/config-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;AAM7C;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,CAAU,eAAe,GAAG,aAAa,CAAC;IAExD;;;;OAIG;IACI,MAAM,CAAC,iBAAiB,CAAC,WAAmB;QACjD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QAEzE,oEAAoE;QACpE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;YACrE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAkB,CAAC;YAEzD,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAExC,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;gBAC1C,UAAU;gBACV,gBAAgB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,IAAI,CAAC;aACxD,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,IAAI,CAAC,aAAa,EAAE,CAAC;gBACxC,MAAM,IAAI,KAAK,CACb,+BAA+B,UAAU,KAAK,KAAK,CAAC,OAAO,EAAE,CAC9D,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,8BAA8B,UAAU,KAAK,KAAK,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,cAAc,CAC3B,MAAqB,EACrB,UAAkB;QAElB,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CACb,uBAAuB,UAAU,yBAAyB,CAC3D,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;YAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBAC7C,MAAM,IAAI,KAAK,CACb,uBAAuB,UAAU,sCAAsC,CACxE,CAAC;YACJ,CAAC;YAED,IAAI,MAAM,CAAC,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1C,MAAM,IAAI,KAAK,CACb,uBAAuB,UAAU,qCAAqC,CACvE,CAAC;YACJ,CAAC;YAED,mCAAmC;YACnC,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;gBAChD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;oBAC3D,MAAM,IAAI,KAAK,CACb,uBAAuB,UAAU,gDAAgD,CAClF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC"}

package/packages/core/dist/conversation-manager.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Conversation Manager
+ *
+ * Handles conversation identification, state persistence, and coordination
+ * between components. Generates unique conversation identifiers from
+ * project path + git branch combination.
+ */
+import type { IPersistence } from './persistence-interface.js';
+import type { ConversationState, ConversationContext } from './types.js';
+import { WorkflowManager } from './workflow-manager.js';
+export declare class ConversationManager {
+    private database;
+    private projectPath;
+    private workflowManager;
+    constructor(database: IPersistence, workflowManager: WorkflowManager, projectPath: string);
+    /**
+     * Get conversation state by ID
+     */
+    getConversationState(conversationId: string): Promise<ConversationState | null>;
+    /**
+     * Get the current conversation context
+     *
+     * Detects the current project path and git branch, then retrieves an existing
+     * conversation state for this context. Does NOT create a new conversation.
+     *
+     * @throws Error if no conversation exists for this context
+     */
+    getConversationContext(): Promise<ConversationContext>;
+    /**
+     * Create a new conversation context
+     *
+     * This should only be called by the start_development tool to explicitly
+     * create a new conversation with a selected workflow.
+     *
+     * @param workflowName - The workflow to use for this conversation
+     * @param projectPathOverride - Optional project path override
+     * @returns The newly created conversation context
+     */
+    createConversationContext(workflowName: string, projectPathOverride?: string): Promise<ConversationContext>;
+    /**
+     * Update the conversation state
+     *
+     * @param conversationId - ID of the conversation to update
+     * @param updates - Partial state updates to apply
+     */
+    updateConversationState(conversationId: string, updates: Partial<Pick<ConversationState, 'currentPhase' | 'planFilePath' | 'workflowName' | 'requireReviewsBeforePhaseTransition'>>): Promise<void>;
+    /**
+     * Create a new conversation state
+     *
+     * @param conversationId - ID for the new conversation
+     * @param projectPath - Path to the project
+     * @param gitBranch - Git branch name
+     */
+    private createNewConversationState;
+    /**
+     * Generate a unique conversation ID based on project path and git branch
+     *
+     * @param projectPath - Path to the project
+     * @param gitBranch - Git branch name
+     */
+    private generateConversationId;
+    /**
+     * Get the current project path
+     */
+    private getProjectPath;
+    /**
+     * Get the current git branch for a project
+     *
+     * @param projectPath - Path to the project
+     */
+    private getGitBranch;
+    /**
+     * Check if a conversation has any previous interactions
+     * Used to determine if this is the first interaction in a conversation
+     */
+    hasInteractions(conversationId: string): Promise<boolean>;
+    /**
+     * Reset conversation data (hybrid approach)
+     */
+    resetConversation(confirm: boolean, reason?: string): Promise<{
+        success: boolean;
+        resetItems: string[];
+        conversationId: string;
+        message: string;
+    }>;
+    /**
+     * Validate reset request parameters
+     */
+    private validateResetRequest;
+    /**
+     * Verify that reset cleanup was successful
+     */
+    private verifyResetCleanup;
+    /**
+     * Clean up conversation data (used internally)
+     */
+    cleanupConversationData(conversationId: string): Promise<void>;
+}