@codemcp/workflows 5.3.0 → 6.0.2

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

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

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

package/packages/core/dist/file-storage.d.ts

@@ -0,0 +1,93 @@
+/**
+ * File-Based Storage Implementation
+ *
+ * Implements the IPersistence interface using a file-based approach with
+ * directory-per-conversation structure. Provides transparent, human-readable
+ * persistence.
+ *
+ * Directory Structure:
+ *   .vibe/conversations/{conversationId}/
+ *     state.json          - ConversationState data
+ *     interactions.jsonl  - Append-only interaction logs (one JSON per line)
+ */
+import type { IPersistence } from './persistence-interface.js';
+import type { ConversationState, InteractionLog } from './types.js';
+/**
+ * File-based persistence implementation
+ */
+export declare class FileStorage implements IPersistence {
+    private conversationsDir;
+    private basePath;
+    /**
+     * @param basePath - Path to the storage location (e.g., .vibe/conversations)
+     */
+    constructor(basePath: string);
+    /**
+     * Initialize file-based storage
+     * Creates the conversations directory if it doesn't exist
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get the directory path for a conversation
+     */
+    private getConversationDir;
+    /**
+     * Get the state file path for a conversation
+     */
+    private getStateFilePath;
+    /**
+     * Get the interactions file path for a conversation
+     */
+    private getInteractionsFilePath;
+    /**
+     * Write data atomically using temp file + rename
+     * Uses unique temp file names to prevent concurrent write collisions
+     */
+    private writeAtomic;
+    /**
+     * Save or update a conversation state
+     */
+    saveConversationState(state: ConversationState): Promise<void>;
+    /**
+     * Get a conversation state by ID
+     * Returns null if not found or corrupted
+     */
+    getConversationState(conversationId: string): Promise<ConversationState | null>;
+    /**
+     * Get all conversation states
+     * Skips corrupted state files
+     */
+    getAllConversationStates(): Promise<ConversationState[]>;
+    /**
+     * Delete a conversation state
+     * Returns true if deleted, false if not found
+     */
+    deleteConversationState(conversationId: string): Promise<boolean>;
+    /**
+     * Log an interaction
+     * Appends to interactions.jsonl file
+     */
+    logInteraction(log: InteractionLog): Promise<void>;
+    /**
+     * Get interaction logs for a conversation
+     * Skips corrupted JSONL lines, returns empty array if file doesn't exist
+     */
+    getInteractionLogs(conversationId: string): Promise<InteractionLog[]>;
+    /**
+     * Get interaction logs by conversation ID (alias for compatibility)
+     */
+    getInteractionsByConversationId(conversationId: string): Promise<InteractionLog[]>;
+    /**
+     * Soft delete interaction logs
+     * Actually performs hard delete (removes interactions.jsonl file)
+     */
+    softDeleteInteractionLogs(conversationId: string): Promise<void>;
+    /**
+     * Reset conversation state (update timestamp)
+     */
+    resetConversationState(conversationId: string): Promise<void>;
+    /**
+     * Close file storage (no-op for file-based storage)
+     */
+    close(): Promise<void>;
+}

package/packages/core/dist/file-storage.js

@@ -0,0 +1,301 @@
+/**
+ * File-Based Storage Implementation
+ *
+ * Implements the IPersistence interface using a file-based approach with
+ * directory-per-conversation structure. Provides transparent, human-readable
+ * persistence.
+ *
+ * Directory Structure:
+ *   .vibe/conversations/{conversationId}/
+ *     state.json          - ConversationState data
+ *     interactions.jsonl  - Append-only interaction logs (one JSON per line)
+ */
+import { promises as fs } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { createLogger } from './logger.js';
+const logger = createLogger('FileStorage');
+/**
+ * File-based persistence implementation
+ */
+export class FileStorage {
+    conversationsDir;
+    basePath;
+    /**
+     * @param basePath - Path to the storage location (e.g., .vibe/conversations)
+     */
+    constructor(basePath) {
+        this.basePath = basePath;
+        this.conversationsDir = join(dirname(basePath), 'conversations');
+    }
+    /**
+     * Initialize file-based storage
+     * Creates the conversations directory if it doesn't exist
+     */
+    async initialize() {
+        try {
+            // Create conversations directory
+            await fs.mkdir(this.conversationsDir, { recursive: true });
+            logger.debug('FileStorage initialized', {
+                conversationsDir: this.conversationsDir,
+            });
+        }
+        catch (error) {
+            logger.error('Failed to initialize FileStorage', error);
+            throw error;
+        }
+    }
+    /**
+     * Get the directory path for a conversation
+     */
+    getConversationDir(conversationId) {
+        return join(this.conversationsDir, conversationId);
+    }
+    /**
+     * Get the state file path for a conversation
+     */
+    getStateFilePath(conversationId) {
+        return join(this.getConversationDir(conversationId), 'state.json');
+    }
+    /**
+     * Get the interactions file path for a conversation
+     */
+    getInteractionsFilePath(conversationId) {
+        return join(this.getConversationDir(conversationId), 'interactions.jsonl');
+    }
+    /**
+     * Write data atomically using temp file + rename
+     * Uses unique temp file names to prevent concurrent write collisions
+     */
+    async writeAtomic(filePath, data) {
+        // Use timestamp + random suffix to ensure unique temp file names for concurrent operations
+        const uniqueSuffix = `${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+        const tempPath = `${filePath}.tmp.${uniqueSuffix}`;
+        try {
+            await fs.writeFile(tempPath, data, 'utf-8');
+            await fs.rename(tempPath, filePath);
+        }
+        catch (error) {
+            // Clean up temp file if it exists
+            try {
+                await fs.unlink(tempPath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            throw error;
+        }
+    }
+    /**
+     * Save or update a conversation state
+     */
+    async saveConversationState(state) {
+        const conversationDir = this.getConversationDir(state.conversationId);
+        const stateFilePath = this.getStateFilePath(state.conversationId);
+        try {
+            // Ensure conversation directory exists
+            await fs.mkdir(conversationDir, { recursive: true });
+            // Write state atomically
+            const stateJson = JSON.stringify(state, null, 2);
+            await this.writeAtomic(stateFilePath, stateJson);
+            logger.debug('Conversation state saved', {
+                conversationId: state.conversationId,
+                currentPhase: state.currentPhase,
+            });
+        }
+        catch (error) {
+            logger.error('Failed to save conversation state', error, {
+                conversationId: state.conversationId,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Get a conversation state by ID
+     * Returns null if not found or corrupted
+     */
+    async getConversationState(conversationId) {
+        const stateFilePath = this.getStateFilePath(conversationId);
+        try {
+            const stateJson = await fs.readFile(stateFilePath, 'utf-8');
+            const state = JSON.parse(stateJson);
+            return state;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                // File doesn't exist - return null (expected for non-existent conversations)
+                return null;
+            }
+            // JSON parse error or other error - log warning and return null
+            logger.warn('Failed to read conversation state, returning null', {
+                conversationId,
+                error: error.message,
+            });
+            return null;
+        }
+    }
+    /**
+     * Get all conversation states
+     * Skips corrupted state files
+     */
+    async getAllConversationStates() {
+        try {
+            const entries = await fs.readdir(this.conversationsDir, {
+                withFileTypes: true,
+            });
+            const states = [];
+            for (const entry of entries) {
+                if (entry.isDirectory()) {
+                    const conversationId = entry.name;
+                    const state = await this.getConversationState(conversationId);
+                    if (state) {
+                        states.push(state);
+                    }
+                    // Corrupted states are already logged and skipped by getConversationState
+                }
+            }
+            // Sort by updatedAt DESC (most recent first)
+            states.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+            return states;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                // Conversations directory doesn't exist yet - return empty array
+                return [];
+            }
+            logger.error('Failed to get all conversation states', error);
+            throw error;
+        }
+    }
+    /**
+     * Delete a conversation state
+     * Returns true if deleted, false if not found
+     */
+    async deleteConversationState(conversationId) {
+        const conversationDir = this.getConversationDir(conversationId);
+        try {
+            await fs.rm(conversationDir, { recursive: true, force: true });
+            logger.debug('Conversation state deleted', { conversationId });
+            return true;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                // Directory doesn't exist - return false
+                return false;
+            }
+            logger.error('Failed to delete conversation state', error, {
+                conversationId,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Log an interaction
+     * Appends to interactions.jsonl file
+     */
+    async logInteraction(log) {
+        const interactionsFilePath = this.getInteractionsFilePath(log.conversationId);
+        const conversationDir = this.getConversationDir(log.conversationId);
+        try {
+            // Ensure conversation directory exists
+            await fs.mkdir(conversationDir, { recursive: true });
+            // Append to JSONL file (one JSON per line)
+            const logLine = JSON.stringify(log) + '\n';
+            await fs.appendFile(interactionsFilePath, logLine, 'utf-8');
+            logger.debug('Interaction logged', {
+                conversationId: log.conversationId,
+                toolName: log.toolName,
+            });
+        }
+        catch (error) {
+            logger.error('Failed to log interaction', error, {
+                conversationId: log.conversationId,
+                toolName: log.toolName,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Get interaction logs for a conversation
+     * Skips corrupted JSONL lines, returns empty array if file doesn't exist
+     */
+    async getInteractionLogs(conversationId) {
+        const interactionsFilePath = this.getInteractionsFilePath(conversationId);
+        try {
+            const content = await fs.readFile(interactionsFilePath, 'utf-8');
+            const lines = content.split('\n').filter(line => line.trim());
+            const logs = [];
+            for (const line of lines) {
+                try {
+                    const log = JSON.parse(line);
+                    logs.push(log);
+                }
+                catch {
+                    // Skip corrupted line, log warning
+                    logger.warn('Skipping corrupted interaction log line', {
+                        conversationId,
+                    });
+                }
+            }
+            return logs;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                // File doesn't exist - return empty array
+                return [];
+            }
+            logger.error('Failed to get interaction logs', error, {
+                conversationId,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Get interaction logs by conversation ID (alias for compatibility)
+     */
+    async getInteractionsByConversationId(conversationId) {
+        return this.getInteractionLogs(conversationId);
+    }
+    /**
+     * Soft delete interaction logs
+     * Actually performs hard delete (removes interactions.jsonl file)
+     */
+    async softDeleteInteractionLogs(conversationId) {
+        const interactionsFilePath = this.getInteractionsFilePath(conversationId);
+        try {
+            await fs.unlink(interactionsFilePath);
+            logger.debug('Interaction logs deleted', { conversationId });
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                // File doesn't exist - nothing to delete
+                return;
+            }
+            logger.warn('Failed to delete interaction logs', {
+                conversationId,
+                error: error.message,
+            });
+        }
+    }
+    /**
+     * Reset conversation state (update timestamp)
+     */
+    async resetConversationState(conversationId) {
+        const state = await this.getConversationState(conversationId);
+        if (!state) {
+            throw new Error(`Conversation state not found for ID: ${conversationId}`);
+        }
+        const updatedState = {
+            ...state,
+            updatedAt: new Date().toISOString(),
+        };
+        await this.saveConversationState(updatedState);
+        logger.debug('Conversation state reset', { conversationId });
+    }
+    /**
+     * Close file storage (no-op for file-based storage)
+     */
+    async close() {
+        logger.debug('FileStorage closed');
+    }
+}
+//# sourceMappingURL=file-storage.js.map

package/packages/core/dist/file-storage.js.map

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

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

@@ -0,0 +1,22 @@
+export declare class GitManager {
+    /**
+     * Check if a directory is a git repository
+     */
+    static isGitRepository(projectPath: string): boolean;
+    /**
+     * Get the current git branch for a project
+     */
+    static getCurrentBranch(projectPath: string): string;
+    /**
+     * Get the current HEAD commit hash (for tracking start of development)
+     */
+    static getCurrentCommitHash(projectPath: string): string | null;
+    /**
+     * Create a commit with the given message
+     */
+    static createCommit(message: string, projectPath: string): boolean;
+    /**
+     * Check if there are uncommitted changes
+     */
+    static hasUncommittedChanges(projectPath: string): boolean;
+}