@codemcp/workflows 5.3.0 → 6.0.2

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

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