@codemcp/workflows 3.1.21

package/dist/tool-handlers/resume-workflow.d.ts

@@ -0,0 +1,88 @@
+/**
+ * ResumeWorkflow Tool Handler
+ *
+ * Handles resuming development workflow after conversation compression.
+ * Returns comprehensive project context, current state, system prompt instructions,
+ * and next steps to seamlessly continue development.
+ */
+import { ConversationRequiredToolHandler } from './base-tool-handler.js';
+import type { YamlStateMachine } from '@codemcp/workflows-core';
+import { ServerContext } from '../types.js';
+/**
+ * Arguments for the resume_workflow tool
+ */
+export interface ResumeWorkflowArgs {
+    include_system_prompt?: boolean;
+}
+/**
+ * Plan file analysis result
+ */
+interface PlanAnalysis {
+    sections: string[];
+    tasks_completed: number;
+    tasks_total: number;
+    key_decisions: string[];
+    recent_updates: string[];
+    active_tasks?: string[];
+    completed_tasks?: string[];
+}
+/**
+ * Conversation context for resume workflow
+ */
+interface ConversationContext {
+    conversationId: string;
+    currentPhase: string;
+    projectPath: string;
+    workflowName: string;
+    gitBranch: string;
+    planFilePath: string;
+    current_phase?: string;
+    workflow_name?: string;
+    project_context?: string;
+    recent_activity?: string[];
+}
+/**
+ * Response from the resume_workflow tool
+ */
+export interface ResumeWorkflowResult {
+    workflow_status: {
+        conversation_id: string;
+        current_phase: string;
+        project_path: string;
+        git_branch: string;
+        state_machine: YamlStateMachine;
+    };
+    plan_status: {
+        exists: boolean;
+        path: string;
+        analysis?: PlanAnalysis | null;
+    };
+    system_prompt?: string | null;
+    recommendations: {
+        immediate_actions: string[];
+        phase_guidance: string;
+        potential_issues: string[];
+    };
+    generated_at: string;
+    tool_version: string;
+}
+/**
+ * ResumeWorkflow tool handler implementation
+ */
+export declare class ResumeWorkflowHandler extends ConversationRequiredToolHandler<ResumeWorkflowArgs, ResumeWorkflowResult> {
+    protected executeWithConversation(args: ResumeWorkflowArgs, context: ServerContext, conversationContext: ConversationContext): Promise<ResumeWorkflowResult>;
+    /**
+     * Analyze plan file content to extract key information
+     */
+    private analyzePlanFile;
+    /**
+     * Get state machine information
+     */
+    private getStateMachineInfo;
+    /**
+     * Generate recommendations for next steps based on state machine transitions
+     */
+    private generateRecommendations;
+}
+export {};
+//# sourceMappingURL=resume-workflow.d.ts.map

package/dist/tool-handlers/resume-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-workflow.d.ts","sourceRoot":"","sources":["../../src/tool-handlers/resume-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAEzE,OAAO,KAAK,EAAE,gBAAgB,EAAa,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;GAEG;AACH,UAAU,YAAY;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,UAAU,mBAAmB;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAWD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE;QACf,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,gBAAgB,CAAC;KACjC,CAAC;IACF,WAAW,EAAE;QACX,MAAM,EAAE,OAAO,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;KAChC,CAAC;IACF,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE;QACf,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;IACF,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,+BAA+B,CACxE,kBAAkB,EAClB,oBAAoB,CACrB;cACiB,uBAAuB,CACrC,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,aAAa,EACtB,mBAAmB,EAAE,mBAAmB,GACvC,OAAO,CAAC,oBAAoB,CAAC;IA8EhC;;OAEG;IACH,OAAO,CAAC,eAAe;IAiDvB;;OAEG;YACW,mBAAmB;IAuCjC;;OAEG;IACH,OAAO,CAAC,uBAAuB;CA6GhC"}

package/dist/tool-handlers/resume-workflow.js

@@ -0,0 +1,213 @@
+/**
+ * ResumeWorkflow Tool Handler
+ *
+ * Handles resuming development workflow after conversation compression.
+ * Returns comprehensive project context, current state, system prompt instructions,
+ * and next steps to seamlessly continue development.
+ */
+import { ConversationRequiredToolHandler } from './base-tool-handler.js';
+import { generateSystemPrompt } from '@codemcp/workflows-core';
+/**
+ * ResumeWorkflow tool handler implementation
+ */
+export class ResumeWorkflowHandler extends ConversationRequiredToolHandler {
+    async executeWithConversation(args, context, conversationContext) {
+        const includeSystemPrompt = args.include_system_prompt !== false; // Default to true
+        this.logger.debug('Processing resume_workflow request', {
+            conversationId: conversationContext.conversationId,
+            includeSystemPrompt,
+        });
+        // Get plan file information
+        const planInfo = await context.planManager.getPlanFileInfo(conversationContext.planFilePath);
+        // Analyze plan file content for key information
+        const planAnalysis = planInfo.exists && planInfo.content
+            ? this.analyzePlanFile(planInfo.content)
+            : null;
+        // Get current state machine information
+        const stateMachineInfo = await this.getStateMachineInfo(context, conversationContext.projectPath, conversationContext.workflowName);
+        const stateMachine = context.transitionEngine.getStateMachine(conversationContext.projectPath, conversationContext.workflowName);
+        // Generate system prompt if requested
+        const systemPrompt = includeSystemPrompt
+            ? generateSystemPrompt(stateMachine)
+            : null;
+        // Build comprehensive response
+        const response = {
+            // Core workflow resumption info
+            workflow_status: {
+                conversation_id: conversationContext.conversationId,
+                current_phase: conversationContext.currentPhase,
+                project_path: conversationContext.projectPath,
+                git_branch: conversationContext.gitBranch,
+                state_machine: stateMachineInfo,
+            },
+            // Plan file analysis
+            plan_status: {
+                exists: planInfo.exists,
+                path: conversationContext.planFilePath,
+                analysis: planAnalysis,
+            },
+            // System prompt (if requested)
+            system_prompt: systemPrompt,
+            // Next steps and recommendations
+            recommendations: this.generateRecommendations(conversationContext, planAnalysis, context),
+            // Metadata
+            generated_at: new Date().toISOString(),
+            tool_version: '1.0.0',
+        };
+        this.logger.debug('resume_workflow response generated', {
+            conversationId: conversationContext.conversationId,
+            phase: conversationContext.currentPhase,
+            planExists: planInfo.exists,
+            includeSystemPrompt,
+        });
+        return response;
+    }
+    /**
+     * Analyze plan file content to extract key information
+     */
+    analyzePlanFile(content) {
+        const analysis = {
+            active_tasks: [],
+            completed_tasks: [],
+            recent_decisions: [],
+            next_steps: [],
+        };
+        const lines = content.split('\n');
+        let inTaskSection = false;
+        let currentSection = '';
+        for (const line of lines) {
+            const trimmed = line.trim();
+            // Detect sections
+            if (trimmed.startsWith('##')) {
+                currentSection = trimmed.toLowerCase();
+                inTaskSection =
+                    currentSection.includes('task') || currentSection.includes('todo');
+            }
+            // Extract tasks
+            if (inTaskSection) {
+                if (trimmed.startsWith('- [x]')) {
+                    analysis.completed_tasks.push(trimmed.substring(5).trim());
+                }
+                else if (trimmed.startsWith('- [ ]')) {
+                    analysis.active_tasks.push(trimmed.substring(5).trim());
+                }
+            }
+            // Extract decisions (look for decision log sections)
+            if (currentSection.includes('decision') && trimmed.startsWith('- ')) {
+                analysis.recent_decisions.push(trimmed.substring(2).trim());
+            }
+        }
+        return {
+            sections: [currentSection],
+            tasks_completed: analysis.completed_tasks.length,
+            tasks_total: analysis.active_tasks.length + analysis.completed_tasks.length,
+            key_decisions: analysis.recent_decisions,
+            recent_updates: analysis.next_steps,
+            active_tasks: analysis.active_tasks,
+            completed_tasks: analysis.completed_tasks,
+        };
+    }
+    /**
+     * Get state machine information
+     */
+    async getStateMachineInfo(context, projectPath, workflowName) {
+        try {
+            // Get the actual state machine for this project
+            const stateMachine = context.transitionEngine.getStateMachine(projectPath, workflowName);
+            return {
+                name: stateMachine.name,
+                description: stateMachine.description,
+                initial_state: stateMachine.initial_state,
+                phases: Object.keys(stateMachine.states),
+                phase_descriptions: Object.fromEntries(Object.entries(stateMachine.states).map(([phase, definition]) => [
+                    phase,
+                    definition.description,
+                ])),
+            };
+        }
+        catch (error) {
+            const err = error;
+            this.logger.warn('Could not determine state machine info', {
+                error: err.message,
+            });
+            return {
+                name: 'unknown',
+                description: 'Could not load workflow',
+                initial_state: 'unknown',
+                phases: [],
+                phase_descriptions: {},
+            };
+        }
+    }
+    /**
+     * Generate recommendations for next steps based on state machine transitions
+     */
+    generateRecommendations(conversationContext, planAnalysis, context) {
+        const recommendations = {
+            immediate_actions: [],
+            phase_guidance: '',
+            potential_issues: [],
+        };
+        try {
+            // Get the state machine for this project
+            const stateMachine = context.transitionEngine.getStateMachine(conversationContext.projectPath, conversationContext.workflowName);
+            const currentPhase = conversationContext.currentPhase;
+            const phaseDefinition = stateMachine.states[currentPhase];
+            if (phaseDefinition) {
+                // Set phase guidance from state machine description
+                recommendations.phase_guidance = `Current phase: ${phaseDefinition.description}`;
+                // Generate transition-based recommendations
+                if (phaseDefinition.transitions &&
+                    phaseDefinition.transitions.length > 0) {
+                    recommendations.immediate_actions.push('From here, you can transition to:');
+                    for (const transition of phaseDefinition.transitions) {
+                        const targetPhase = stateMachine.states[transition.to];
+                        const targetDescription = targetPhase
+                            ? targetPhase.description
+                            : transition.to;
+                        recommendations.immediate_actions.push(`• ${transition.to}: ${targetDescription}`);
+                    }
+                    // Add instruction on how to transition
+                    recommendations.immediate_actions.push('Use proceed_to_phase() tool when ready to transition');
+                }
+                else {
+                    recommendations.immediate_actions.push('Continue working in current phase');
+                }
+                // Add current phase specific guidance
+                recommendations.immediate_actions.push(`Focus on: ${phaseDefinition.description}`);
+            }
+            else {
+                // Fallback if phase not found in state machine
+                recommendations.phase_guidance = `Current phase: ${currentPhase}`;
+                recommendations.immediate_actions.push('Continue working in current phase');
+            }
+        }
+        catch (error) {
+            const err = error;
+            this.logger.warn('Could not generate state machine recommendations', {
+                error: err.message,
+            });
+            // Basic fallback
+            recommendations.phase_guidance = `Current phase: ${conversationContext.currentPhase}`;
+            recommendations.immediate_actions.push('Continue working in current phase');
+        }
+        // Plan-based recommendations
+        if (planAnalysis) {
+            if (planAnalysis.active_tasks && planAnalysis.active_tasks.length > 0) {
+                recommendations.immediate_actions.push(`Continue working on active tasks: ${planAnalysis.active_tasks.slice(0, 2).join(', ')}`);
+            }
+            if ((!planAnalysis.active_tasks ||
+                planAnalysis.active_tasks.length === 0) &&
+                planAnalysis.completed_tasks &&
+                planAnalysis.completed_tasks.length > 0) {
+                recommendations.potential_issues.push('No active tasks found - may be ready to transition to next phase');
+            }
+        }
+        // Always recommend calling whats_next
+        if (!recommendations.immediate_actions.some(action => action.includes('whats_next'))) {
+            recommendations.immediate_actions.unshift('Call whats_next() to get current phase-specific guidance');
+        }
+        return recommendations;
+    }
+}
+//# sourceMappingURL=resume-workflow.js.map

package/dist/tool-handlers/resume-workflow.js.map

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

package/dist/tool-handlers/setup-project-docs.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Setup Project Docs Handler
+ *
+ * Creates project documentation artifacts (architecture.md, requirements.md, design.md)
+ * using configurable templates OR by linking existing files via symlinks.
+ * Supports different template formats for each document type and file path linking.
+ */
+import { BaseToolHandler } from './base-tool-handler.js';
+import { ServerContext } from '../types.js';
+export interface SetupProjectDocsArgs {
+    architecture: string;
+    requirements: string;
+    design: string;
+}
+export interface SetupProjectDocsResult {
+    success: boolean;
+    created: string[];
+    linked: string[];
+    skipped: string[];
+    paths: {
+        architecture: string;
+        requirements: string;
+        design: string;
+    };
+    message: string;
+}
+export declare class SetupProjectDocsHandler extends BaseToolHandler<SetupProjectDocsArgs, SetupProjectDocsResult> {
+    private projectDocsManager;
+    constructor();
+    protected executeHandler(args: SetupProjectDocsArgs, context: ServerContext): Promise<SetupProjectDocsResult>;
+    /**
+     * Validate and process arguments to determine templates vs file paths
+     */
+    private validateAndProcessArgs;
+}
+//# sourceMappingURL=setup-project-docs.d.ts.map

package/dist/tool-handlers/setup-project-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-project-docs.d.ts","sourceRoot":"","sources":["../../src/tool-handlers/setup-project-docs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAIzD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,uBAAwB,SAAQ,eAAe,CAC1D,oBAAoB,EACpB,sBAAsB,CACvB;IACC,OAAO,CAAC,kBAAkB,CAAqB;;cAO/B,cAAc,CAC5B,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,sBAAsB,CAAC;IA2FlC;;OAEG;YACW,sBAAsB;CAoFrC"}

package/dist/tool-handlers/setup-project-docs.js

@@ -0,0 +1,136 @@
+/**
+ * Setup Project Docs Handler
+ *
+ * Creates project documentation artifacts (architecture.md, requirements.md, design.md)
+ * using configurable templates OR by linking existing files via symlinks.
+ * Supports different template formats for each document type and file path linking.
+ */
+import { BaseToolHandler } from './base-tool-handler.js';
+import { ProjectDocsManager } from '@codemcp/workflows-core';
+import { PathValidationUtils } from '@codemcp/workflows-core';
+export class SetupProjectDocsHandler extends BaseToolHandler {
+    projectDocsManager;
+    constructor() {
+        super();
+        this.projectDocsManager = new ProjectDocsManager();
+    }
+    async executeHandler(args, context) {
+        const projectPath = context.projectPath || process.cwd();
+        this.logger.info('Setting up project docs with enhanced file linking support', { args, projectPath });
+        try {
+            // Get available templates for validation
+            const availableTemplates = await this.projectDocsManager.templateManager.getAvailableTemplates();
+            // Validate and process each parameter
+            const processedArgs = await this.validateAndProcessArgs(args, availableTemplates, projectPath);
+            if (!processedArgs.success) {
+                return {
+                    success: false,
+                    created: [],
+                    linked: [],
+                    skipped: [],
+                    paths: this.projectDocsManager.getDocumentPaths(projectPath),
+                    message: processedArgs.error || 'Unknown error during validation',
+                };
+            }
+            // Create/link project documents
+            if (!processedArgs.templateOptions || !processedArgs.filePaths) {
+                throw new Error('Invalid processed args: missing templateOptions or filePaths');
+            }
+            const result = await this.projectDocsManager.createOrLinkProjectDocs(projectPath, processedArgs.templateOptions, processedArgs.filePaths);
+            // Get document paths for response
+            const paths = this.projectDocsManager.getDocumentPaths(projectPath);
+            // Create success message
+            let message = 'Project documentation setup completed.';
+            if (result.created.length > 0) {
+                message += ` Created: ${result.created.join(', ')}.`;
+            }
+            if (result.linked.length > 0) {
+                message += ` Linked: ${result.linked.join(', ')}.`;
+            }
+            if (result.skipped.length > 0) {
+                message += ` Skipped existing: ${result.skipped.join(', ')}.`;
+            }
+            this.logger.info('Project docs setup completed', {
+                created: result.created,
+                linked: result.linked,
+                skipped: result.skipped,
+                paths,
+            });
+            return {
+                success: true,
+                created: result.created,
+                linked: result.linked,
+                skipped: result.skipped,
+                paths,
+                message,
+            };
+        }
+        catch (error) {
+            this.logger.error('Failed to setup project docs', error, {
+                args,
+                projectPath,
+            });
+            return {
+                success: false,
+                created: [],
+                linked: [],
+                skipped: [],
+                paths: this.projectDocsManager.getDocumentPaths(projectPath),
+                message: `Failed to setup project docs: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            };
+        }
+    }
+    /**
+     * Validate and process arguments to determine templates vs file paths
+     */
+    async validateAndProcessArgs(args, availableTemplates, projectPath) {
+        const templateOptions = {};
+        const filePaths = {};
+        const errors = [];
+        // Validate architecture parameter
+        const archValidation = await PathValidationUtils.validateParameter(args.architecture, availableTemplates.architecture, projectPath);
+        if (archValidation.isTemplate) {
+            templateOptions.architecture = args.architecture;
+        }
+        else if (archValidation.isFilePath && archValidation.resolvedPath) {
+            filePaths.architecture = archValidation.resolvedPath;
+        }
+        else {
+            errors.push(`Architecture: ${archValidation.error}`);
+        }
+        // Validate requirements parameter
+        const reqValidation = await PathValidationUtils.validateParameter(args.requirements, availableTemplates.requirements, projectPath);
+        if (reqValidation.isTemplate) {
+            templateOptions.requirements = args.requirements;
+        }
+        else if (reqValidation.isFilePath && reqValidation.resolvedPath) {
+            filePaths.requirements = reqValidation.resolvedPath;
+        }
+        else {
+            errors.push(`Requirements: ${reqValidation.error}`);
+        }
+        // Validate design parameter
+        const designValidation = await PathValidationUtils.validateParameter(args.design, availableTemplates.design, projectPath);
+        if (designValidation.isTemplate) {
+            templateOptions.design = args.design;
+        }
+        else if (designValidation.isFilePath && designValidation.resolvedPath) {
+            filePaths.design = designValidation.resolvedPath;
+        }
+        else {
+            errors.push(`Design: ${designValidation.error}`);
+        }
+        if (errors.length > 0) {
+            return {
+                success: false,
+                error: `Parameter validation failed:\n${errors.join('\n')}`,
+            };
+        }
+        return {
+            success: true,
+            templateOptions,
+            filePaths,
+        };
+    }
+}
+//# sourceMappingURL=setup-project-docs.js.map

package/dist/tool-handlers/setup-project-docs.js.map

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

package/dist/tool-handlers/start-development.d.ts

@@ -0,0 +1,82 @@
+/**
+ * StartDevelopment Tool Handler
+ *
+ * Handles initialization of development workflow and transition to the initial
+ * development phase. Allows users to choose from predefined workflows or use a custom workflow.
+ */
+import { BaseToolHandler } from './base-tool-handler.js';
+import type { YamlStateMachine } from '@codemcp/workflows-core';
+import { ServerContext } from '../types.js';
+/**
+ * Arguments for the start_development tool
+ */
+export interface StartDevelopmentArgs {
+    workflow: string;
+    commit_behaviour?: 'step' | 'phase' | 'end' | 'none';
+    require_reviews?: boolean;
+}
+/**
+ * Response from the start_development tool
+ */
+export interface StartDevelopmentResult {
+    phase: string;
+    instructions: string;
+    plan_file_path: string;
+    conversation_id: string;
+    workflow: YamlStateMachine;
+    workflowDocumentationUrl?: string;
+}
+/**
+ * StartDevelopment tool handler implementation
+ */
+export declare class StartDevelopmentHandler extends BaseToolHandler<StartDevelopmentArgs, StartDevelopmentResult> {
+    private projectDocsManager;
+    constructor();
+    protected executeHandler(args: StartDevelopmentArgs, context: ServerContext): Promise<StartDevelopmentResult>;
+    /**
+     * Check if project documentation artifacts exist and provide setup guidance if needed
+     * Dynamically analyzes the selected workflow to determine which documents are referenced
+     * Blocks workflow start if the workflow requires documentation
+     */
+    private checkProjectArtifacts;
+    /**
+     * Analyze workflow content to detect document variable references
+     */
+    private analyzeWorkflowDocumentReferences;
+    /**
+     * Determine which referenced documents are missing
+     */
+    private getMissingReferencedDocuments;
+    /**
+     * Generate guidance for setting up missing project artifacts
+     */
+    private generateArtifactSetupGuidance;
+    /**
+     * Generate template options text dynamically
+     */
+    private generateTemplateOptionsText;
+    /**
+     * Get description for a template based on its name and type
+     */
+    private getTemplateDescription;
+    /**
+     * Generate workflow documentation URL for predefined workflows
+     * Returns undefined for custom workflows
+     */
+    private generateWorkflowDocumentationUrl;
+    /**
+     * Get the current git branch for a project
+     * Uses the same logic as ConversationManager but locally accessible
+     */
+    private getCurrentGitBranch;
+    /**
+     * Generate a suggested branch name for feature development
+     */
+    private generateBranchSuggestion;
+    /**
+     * Ensure .gitignore exists in .vibe folder to exclude SQLite files
+     * This function is idempotent and self-contained within the .vibe directory
+     */
+    private ensureGitignoreEntry;
+}
+//# sourceMappingURL=start-development.d.ts.map

package/dist/tool-handlers/start-development.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-development.d.ts","sourceRoot":"","sources":["../../src/tool-handlers/start-development.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAOzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IACrD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,eAAe,CAC1D,oBAAoB,EACpB,sBAAsB,CACvB;IACC,OAAO,CAAC,kBAAkB,CAAqB;;cAO/B,cAAc,CAC5B,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,sBAAsB,CAAC;IAiLlC;;;;OAIG;YACW,qBAAqB;IAmGnC;;OAEG;IACH,OAAO,CAAC,iCAAiC;IA6BzC;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAiCrC;;OAEG;YACW,6BAA6B;IAyE3C;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAgDnC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAe9B;;;OAGG;IACH,OAAO,CAAC,gCAAgC;IAYxC;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAiC3B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAKhC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;CAqE7B"}