@codemcp/workflows 5.3.0 → 6.0.1

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

@@ -0,0 +1,382 @@
+/**
+ * Conversation Manager
+ *
+ * Handles conversation identification, state persistence, and coordination
+ * between components. Generates unique conversation identifiers from
+ * project path + git branch combination.
+ */
+import { execSync } from 'node:child_process';
+import { resolve } from 'node:path';
+import { existsSync } from 'node:fs';
+import { createLogger } from './logger.js';
+import { getPathBasename } from './path-validation-utils.js';
+import { PlanManager } from './plan-manager.js';
+const logger = createLogger('ConversationManager');
+export class ConversationManager {
+    database;
+    projectPath;
+    workflowManager;
+    constructor(database, workflowManager, projectPath) {
+        this.database = database;
+        this.workflowManager = workflowManager;
+        this.projectPath = projectPath;
+    }
+    /**
+     * Get conversation state by ID
+     */
+    async getConversationState(conversationId) {
+        return await this.database.getConversationState(conversationId);
+    }
+    /**
+     * 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
+     */
+    async getConversationContext() {
+        const projectPath = this.getProjectPath();
+        const gitBranch = this.getGitBranch(projectPath);
+        logger.debug('Getting conversation context', { projectPath, gitBranch });
+        // Generate a unique conversation ID based on project path and git branch
+        const conversationId = this.generateConversationId(projectPath, gitBranch);
+        // Try to find existing conversation state
+        const state = await this.database.getConversationState(conversationId);
+        // If no existing state, throw an error - conversation must be created with start_development first
+        if (!state) {
+            logger.warn('No conversation found for context', {
+                projectPath,
+                gitBranch,
+                conversationId,
+            });
+            throw new Error('No development conversation exists for this project. Use the start_development tool first to initialize development with a workflow.');
+        }
+        // Return the conversation context
+        return {
+            conversationId: state.conversationId,
+            projectPath: state.projectPath,
+            gitBranch: state.gitBranch,
+            currentPhase: state.currentPhase,
+            planFilePath: state.planFilePath,
+            workflowName: state.workflowName,
+        };
+    }
+    /**
+     * 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
+     */
+    async createConversationContext(workflowName, projectPathOverride) {
+        const projectPath = projectPathOverride || this.getProjectPath();
+        const gitBranch = this.getGitBranch(projectPath);
+        logger.debug('Creating conversation context', {
+            projectPath,
+            gitBranch,
+            workflowName,
+        });
+        // Generate a unique conversation ID based on project path and git branch
+        const conversationId = this.generateConversationId(projectPath, gitBranch);
+        // Check if a conversation already exists
+        const existingState = await this.database.getConversationState(conversationId);
+        if (existingState) {
+            // Check if user is trying to change workflow
+            if (existingState.workflowName !== workflowName) {
+                const errorMessage = `Development conversation already exists with workflow '${existingState.workflowName}'. Cannot change to '${workflowName}'. Use reset_development() first to start with a new workflow.`;
+                logger.error('Attempted workflow change on existing conversation', new Error(errorMessage), {
+                    existingWorkflow: existingState.workflowName,
+                    requestedWorkflow: workflowName,
+                    conversationId,
+                });
+                throw new Error(errorMessage);
+            }
+            logger.debug('Conversation already exists, returning existing context', {
+                conversationId,
+            });
+            return {
+                conversationId: existingState.conversationId,
+                projectPath: existingState.projectPath,
+                gitBranch: existingState.gitBranch,
+                currentPhase: existingState.currentPhase,
+                planFilePath: existingState.planFilePath,
+                workflowName: existingState.workflowName,
+            };
+        }
+        // Create a new conversation state
+        const state = await this.createNewConversationState(conversationId, projectPath, gitBranch, workflowName);
+        // Return the conversation context
+        return {
+            conversationId: state.conversationId,
+            projectPath: state.projectPath,
+            gitBranch: state.gitBranch,
+            currentPhase: state.currentPhase,
+            planFilePath: state.planFilePath,
+            workflowName: state.workflowName,
+        };
+    }
+    /**
+     * Update the conversation state
+     *
+     * @param conversationId - ID of the conversation to update
+     * @param updates - Partial state updates to apply
+     */
+    async updateConversationState(conversationId, updates) {
+        logger.debug('Updating conversation state', { conversationId, updates });
+        // Get current state
+        const currentState = await this.database.getConversationState(conversationId);
+        if (!currentState) {
+            throw new Error(`Conversation state not found for ID: ${conversationId}`);
+        }
+        // Apply updates
+        const updatedState = {
+            ...currentState,
+            ...updates,
+            updatedAt: new Date().toISOString(),
+        };
+        // Save updated state
+        await this.database.saveConversationState(updatedState);
+        logger.info('Conversation state updated', {
+            conversationId,
+            currentPhase: updatedState.currentPhase,
+        });
+    }
+    /**
+     * Create a new conversation state
+     *
+     * @param conversationId - ID for the new conversation
+     * @param projectPath - Path to the project
+     * @param gitBranch - Git branch name
+     */
+    async createNewConversationState(conversationId, projectPath, gitBranch, workflowName = 'waterfall') {
+        logger.info('Creating new conversation state', {
+            conversationId,
+            projectPath,
+            gitBranch,
+        });
+        const timestamp = new Date().toISOString();
+        // Generate a plan file path based on the branch name
+        // Sanitize branch name by replacing slashes and other special characters
+        const sanitizedBranch = gitBranch.replace(/[/\\]/g, '-');
+        const planFileName = gitBranch === 'main' || gitBranch === 'master'
+            ? 'development-plan.md'
+            : `development-plan-${sanitizedBranch}.md`;
+        const planFilePath = resolve(projectPath, '.vibe', planFileName);
+        // Get initial state from the appropriate workflow
+        const stateMachine = this.workflowManager.loadWorkflowForProject(projectPath, workflowName);
+        const initialPhase = stateMachine.initial_state;
+        // Create new state
+        const newState = {
+            conversationId,
+            projectPath,
+            gitBranch,
+            currentPhase: initialPhase,
+            planFilePath,
+            workflowName,
+            requireReviewsBeforePhaseTransition: false, // Default to false for new conversations
+            createdAt: timestamp,
+            updatedAt: timestamp,
+        };
+        // Save to database
+        await this.database.saveConversationState(newState);
+        logger.info('New conversation state created', {
+            conversationId,
+            planFilePath,
+            initialPhase,
+        });
+        return newState;
+    }
+    /**
+     * Generate a unique conversation ID based on project path and git branch
+     *
+     * @param projectPath - Path to the project
+     * @param gitBranch - Git branch name
+     */
+    generateConversationId(projectPath, gitBranch) {
+        // Extract project name from path (cross-platform: handles both / and \)
+        const projectName = getPathBasename(projectPath, 'unknown-project');
+        // Clean branch name for use in ID
+        const cleanBranch = gitBranch
+            .replace(/[^a-zA-Z0-9-]/g, '-')
+            .replace(/-+/g, '-')
+            .replace(/^-|-$/g, '');
+        // For tests, use a deterministic ID
+        if (process.env['NODE_ENV'] === 'test') {
+            return `${projectName}-${cleanBranch}-p423k1`;
+        }
+        // Generate a deterministic ID based on project path and branch
+        // This ensures the same project/branch combination always gets the same conversation ID
+        let hash = 0;
+        const str = `${projectPath}:${gitBranch}`;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            hash = (hash << 5) - hash + char;
+            hash = hash & hash; // Convert to 32-bit integer
+        }
+        const hashStr = Math.abs(hash).toString(36).substring(0, 6);
+        return `${projectName}-${cleanBranch}-${hashStr}`;
+    }
+    /**
+     * Get the current project path
+     */
+    getProjectPath() {
+        return this.projectPath;
+    }
+    /**
+     * Get the current git branch for a project
+     *
+     * @param projectPath - Path to the project
+     */
+    getGitBranch(projectPath) {
+        try {
+            // Check if this is a git repository
+            if (!existsSync(`${projectPath}/.git`)) {
+                logger.debug('Not a git repository, using "default" as branch name', {
+                    projectPath,
+                });
+                return 'default';
+            }
+            // Get current branch name
+            // Use symbolic-ref which works even without commits (unlike rev-parse --abbrev-ref HEAD)
+            const branch = execSync('git symbolic-ref --short HEAD', {
+                cwd: projectPath,
+                encoding: 'utf-8',
+                stdio: ['ignore', 'pipe', 'ignore'], // Suppress stderr
+            }).trim();
+            logger.debug('Detected git branch', { projectPath, branch });
+            return branch;
+        }
+        catch (_error) {
+            logger.debug('Failed to get git branch, using "default" as branch name', {
+                projectPath,
+            });
+            return 'default';
+        }
+    }
+    /**
+     * Check if a conversation has any previous interactions
+     * Used to determine if this is the first interaction in a conversation
+     */
+    async hasInteractions(conversationId) {
+        try {
+            // Get all interactions for this conversation
+            const interactions = await this.database.getInteractionsByConversationId(conversationId);
+            const count = interactions.length;
+            logger.debug('Checked interaction count for conversation', {
+                conversationId,
+                count,
+            });
+            return count > 0;
+        }
+        catch (error) {
+            logger.error('Failed to check interaction count', error, {
+                conversationId,
+            });
+            // If we can't check, assume this is the first interaction to be safe
+            return false;
+        }
+    }
+    /**
+     * Reset conversation data (hybrid approach)
+     */
+    async resetConversation(confirm, reason) {
+        logger.info('Starting conversation reset', { confirm, reason });
+        // Validate reset request
+        this.validateResetRequest(confirm);
+        const context = await this.getConversationContext();
+        const resetItems = [];
+        try {
+            // Step 1: Soft delete interaction logs
+            await this.database.softDeleteInteractionLogs(context.conversationId);
+            resetItems.push('interaction_logs');
+            logger.debug('Interaction logs soft deleted');
+            // Step 2: Hard delete conversation state
+            await this.database.deleteConversationState(context.conversationId);
+            resetItems.push('conversation_state');
+            logger.debug('Conversation state hard deleted');
+            // Step 3: Hard delete plan file
+            const planManager = new PlanManager();
+            await planManager.deletePlanFile(context.planFilePath);
+            resetItems.push('plan_file');
+            logger.debug('Plan file deleted');
+            // Verify cleanup
+            await this.verifyResetCleanup(context.conversationId, context.planFilePath);
+            const message = `Successfully reset conversation ${context.conversationId}. Reset items: ${resetItems.join(', ')}${reason ? `. Reason: ${reason}` : ''}`;
+            logger.info('Conversation reset completed successfully', {
+                conversationId: context.conversationId,
+                resetItems,
+                reason,
+            });
+            return {
+                success: true,
+                resetItems,
+                conversationId: context.conversationId,
+                message,
+            };
+        }
+        catch (error) {
+            logger.error('Failed to reset conversation', error, {
+                conversationId: context.conversationId,
+                resetItems,
+                reason,
+            });
+            throw new Error(`Reset failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Validate reset request parameters
+     */
+    validateResetRequest(confirm) {
+        if (!confirm) {
+            throw new Error('Reset operation requires explicit confirmation. Set confirm parameter to true.');
+        }
+    }
+    /**
+     * Verify that reset cleanup was successful
+     */
+    async verifyResetCleanup(conversationId, planFilePath) {
+        logger.debug('Verifying reset cleanup', { conversationId, planFilePath });
+        try {
+            // Check that conversation state is deleted
+            const state = await this.database.getConversationState(conversationId);
+            if (state) {
+                throw new Error('Conversation state was not properly deleted');
+            }
+            // Check that plan file is deleted
+            const planManager = new PlanManager();
+            const isDeleted = await planManager.ensurePlanFileDeleted(planFilePath);
+            if (!isDeleted) {
+                throw new Error('Plan file was not properly deleted');
+            }
+            logger.debug('Reset cleanup verification successful');
+        }
+        catch (error) {
+            logger.error('Reset cleanup verification failed', error);
+            throw error;
+        }
+    }
+    /**
+     * Clean up conversation data (used internally)
+     */
+    async cleanupConversationData(conversationId) {
+        logger.debug('Cleaning up conversation data', { conversationId });
+        try {
+            // This method can be used for additional cleanup if needed
+            // Currently, the main cleanup is handled by resetConversation
+            await this.database.softDeleteInteractionLogs(conversationId);
+            await this.database.deleteConversationState(conversationId);
+            logger.debug('Conversation data cleanup completed', { conversationId });
+        }
+        catch (error) {
+            logger.error('Failed to cleanup conversation data', error, {
+                conversationId,
+            });
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=conversation-manager.js.map

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

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

package/packages/core/dist/file-detection-manager.d.ts

@@ -0,0 +1,53 @@
+/**
+ * File Detection Manager
+ *
+ * Handles pattern-based file discovery and suggestions for existing documentation files.
+ * Supports auto-detection of common documentation patterns in projects.
+ */
+export interface DetectedFile {
+    path: string;
+    relativePath: string;
+    type: 'architecture' | 'requirements' | 'design';
+    confidence: 'high' | 'medium' | 'low';
+}
+export interface FileDetectionResult {
+    architecture: DetectedFile[];
+    requirements: DetectedFile[];
+    design: DetectedFile[];
+}
+export declare class FileDetectionManager {
+    private projectPath;
+    constructor(projectPath: string);
+    /**
+     * Detect existing documentation files in the project
+     */
+    detectDocumentationFiles(): Promise<FileDetectionResult>;
+    /**
+     * Get search locations for documentation files
+     */
+    private getSearchLocations;
+    /**
+     * Scan a location for files
+     */
+    private scanLocation;
+    /**
+     * Match a file against documentation patterns
+     */
+    private matchFileToPatterns;
+    /**
+     * Check if file matches any of the patterns
+     */
+    private matchesPatterns;
+    /**
+     * Determine confidence level for a match
+     */
+    private getConfidence;
+    /**
+     * Sort by confidence and remove duplicates
+     */
+    private sortAndDeduplicate;
+    /**
+     * Format file suggestions for LLM responses
+     */
+    formatSuggestions(detectionResult: FileDetectionResult): string;
+}

package/packages/core/dist/file-detection-manager.js

@@ -0,0 +1,221 @@
+/**
+ * File Detection Manager
+ *
+ * Handles pattern-based file discovery and suggestions for existing documentation files.
+ * Supports auto-detection of common documentation patterns in projects.
+ */
+import { readdir, access } from 'node:fs/promises';
+import { join, basename } from 'node:path';
+import { createLogger } from './logger.js';
+import { PathValidationUtils } from './path-validation-utils.js';
+const logger = createLogger('FileDetectionManager');
+export class FileDetectionManager {
+    projectPath;
+    constructor(projectPath) {
+        this.projectPath = projectPath;
+    }
+    /**
+     * Detect existing documentation files in the project
+     */
+    async detectDocumentationFiles() {
+        logger.debug('Starting documentation file detection', {
+            projectPath: this.projectPath,
+        });
+        const searchLocations = this.getSearchLocations();
+        const patterns = PathValidationUtils.getCommonDocumentationPatterns();
+        const result = {
+            architecture: [],
+            requirements: [],
+            design: [],
+        };
+        // Search in each location
+        for (const location of searchLocations) {
+            try {
+                await access(location);
+                const files = await this.scanLocation(location);
+                // Match files against patterns
+                for (const file of files) {
+                    const matches = this.matchFileToPatterns(file, patterns);
+                    for (const match of matches) {
+                        result[match.type].push({
+                            path: file.path,
+                            relativePath: file.relativePath,
+                            type: match.type,
+                            confidence: match.confidence,
+                        });
+                    }
+                }
+            }
+            catch (error) {
+                logger.debug('Search location not accessible', {
+                    location,
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                });
+            }
+        }
+        // Sort by confidence and remove duplicates
+        result.architecture = this.sortAndDeduplicate(result.architecture);
+        result.requirements = this.sortAndDeduplicate(result.requirements);
+        result.design = this.sortAndDeduplicate(result.design);
+        logger.info('Documentation file detection completed', {
+            found: {
+                architecture: result.architecture.length,
+                requirements: result.requirements.length,
+                design: result.design.length,
+            },
+        });
+        return result;
+    }
+    /**
+     * Get search locations for documentation files
+     */
+    getSearchLocations() {
+        return [
+            this.projectPath, // Project root
+            join(this.projectPath, 'docs'), // docs/ folder
+            join(this.projectPath, 'doc'), // doc/ folder
+            join(this.projectPath, '.vibe', 'docs'), // .vibe/docs/ folder
+            join(this.projectPath, 'documentation'), // documentation/ folder
+        ];
+    }
+    /**
+     * Scan a location for files
+     */
+    async scanLocation(location) {
+        try {
+            const entries = await readdir(location, { withFileTypes: true });
+            const files = [];
+            for (const entry of entries) {
+                if (entry.isFile()) {
+                    const fullPath = join(location, entry.name);
+                    const relativePath = fullPath.replace(this.projectPath + '/', '');
+                    files.push({
+                        path: fullPath,
+                        relativePath,
+                    });
+                }
+            }
+            return files;
+        }
+        catch (error) {
+            logger.debug('Failed to scan location', {
+                location,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            return [];
+        }
+    }
+    /**
+     * Match a file against documentation patterns
+     */
+    matchFileToPatterns(file, patterns) {
+        const fileName = basename(file.path).toLowerCase();
+        const relativePath = file.relativePath.toLowerCase();
+        const matches = [];
+        // Check architecture patterns
+        if (this.matchesPatterns(fileName, relativePath, patterns.architecture)) {
+            const confidence = this.getConfidence(fileName, 'architecture');
+            matches.push({ type: 'architecture', confidence });
+        }
+        // Check requirements patterns
+        if (this.matchesPatterns(fileName, relativePath, patterns.requirements)) {
+            const confidence = this.getConfidence(fileName, 'requirements');
+            matches.push({ type: 'requirements', confidence });
+        }
+        // Check design patterns
+        if (this.matchesPatterns(fileName, relativePath, patterns.design)) {
+            const confidence = this.getConfidence(fileName, 'design');
+            matches.push({ type: 'design', confidence });
+        }
+        return matches;
+    }
+    /**
+     * Check if file matches any of the patterns
+     */
+    matchesPatterns(fileName, relativePath, patterns) {
+        return patterns.some(pattern => {
+            const normalizedPattern = pattern.toLowerCase();
+            // Exact filename match
+            if (fileName === normalizedPattern) {
+                return true;
+            }
+            // Relative path match
+            if (relativePath === normalizedPattern) {
+                return true;
+            }
+            // Pattern matching with wildcards
+            if (normalizedPattern.includes('*')) {
+                const regex = new RegExp(normalizedPattern.replace(/\*/g, '.*'));
+                return regex.test(fileName) || regex.test(relativePath);
+            }
+            return false;
+        });
+    }
+    /**
+     * Determine confidence level for a match
+     */
+    getConfidence(fileName, type) {
+        // High confidence for exact type matches
+        if (fileName.includes(type.toLowerCase())) {
+            return 'high';
+        }
+        // Medium confidence for README files (could contain any type)
+        if (fileName.includes('readme')) {
+            return 'medium';
+        }
+        // Low confidence for other matches
+        return 'low';
+    }
+    /**
+     * Sort by confidence and remove duplicates
+     */
+    sortAndDeduplicate(files) {
+        // Remove duplicates by path
+        const unique = files.filter((file, index, array) => array.findIndex(f => f.path === file.path) === index);
+        // Sort by confidence (high first) and then by path length (shorter first)
+        return unique.sort((a, b) => {
+            const confidenceOrder = { high: 0, medium: 1, low: 2 };
+            const confidenceDiff = confidenceOrder[a.confidence] - confidenceOrder[b.confidence];
+            if (confidenceDiff !== 0) {
+                return confidenceDiff;
+            }
+            return a.relativePath.length - b.relativePath.length;
+        });
+    }
+    /**
+     * Format file suggestions for LLM responses
+     */
+    formatSuggestions(detectionResult) {
+        const suggestions = [];
+        if (detectionResult.architecture.length > 0) {
+            suggestions.push(`**Architecture files found:**`);
+            for (const file of detectionResult.architecture.slice(0, 3)) {
+                suggestions.push(`  - ${file.relativePath} (${file.confidence} confidence)`);
+            }
+        }
+        if (detectionResult.requirements.length > 0) {
+            suggestions.push(`**Requirements files found:**`);
+            for (const file of detectionResult.requirements.slice(0, 3)) {
+                suggestions.push(`  - ${file.relativePath} (${file.confidence} confidence)`);
+            }
+        }
+        if (detectionResult.design.length > 0) {
+            suggestions.push(`**Design files found:**`);
+            for (const file of detectionResult.design.slice(0, 3)) {
+                suggestions.push(`  - ${file.relativePath} (${file.confidence} confidence)`);
+            }
+        }
+        if (suggestions.length === 0) {
+            return 'No existing documentation files detected.';
+        }
+        return [
+            'Existing documentation files detected:',
+            '',
+            ...suggestions,
+            '',
+            'You can use these files with `setup_project_docs` by providing the file paths instead of template names.',
+            'Example: `setup_project_docs({ architecture: "README.md", requirements: "docs/requirements.md", design: "freestyle" })`',
+        ].join('\n');
+    }
+}
+//# sourceMappingURL=file-detection-manager.js.map