@codemcp/workflows 3.1.21

package/dist/tool-handlers/start-development.js

@@ -0,0 +1,448 @@
+/**
+ * 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 { validateRequiredArgs } from '../server-helpers.js';
+import { basename } from 'node:path';
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { GitManager } from '@codemcp/workflows-core';
+import { ProjectDocsManager } from '@codemcp/workflows-core';
+/**
+ * StartDevelopment tool handler implementation
+ */
+export class StartDevelopmentHandler extends BaseToolHandler {
+    projectDocsManager;
+    constructor() {
+        super();
+        this.projectDocsManager = new ProjectDocsManager();
+    }
+    async executeHandler(args, context) {
+        // Validate required arguments
+        validateRequiredArgs(args, ['workflow']);
+        const selectedWorkflow = args.workflow;
+        const requireReviews = args.require_reviews ?? false;
+        // Process git commit configuration
+        const isGitRepository = GitManager.isGitRepository(context.projectPath);
+        // Translate commit_behaviour to internal git config
+        const commitBehaviour = args.commit_behaviour ?? (isGitRepository ? 'end' : 'none');
+        const gitCommitConfig = {
+            enabled: commitBehaviour !== 'none',
+            commitOnStep: commitBehaviour === 'step',
+            commitOnPhase: commitBehaviour === 'phase',
+            commitOnComplete: commitBehaviour === 'end' ||
+                commitBehaviour === 'step' ||
+                commitBehaviour === 'phase',
+            initialMessage: 'Development session',
+            startCommitHash: GitManager.getCurrentCommitHash(context.projectPath) || undefined,
+        };
+        this.logger.debug('Processing start_development request', {
+            selectedWorkflow,
+            projectPath: context.projectPath,
+            commitBehaviour,
+            gitCommitConfig,
+        });
+        // Validate workflow selection (ensure project workflows are loaded first)
+        context.workflowManager.loadProjectWorkflows(context.projectPath);
+        if (!context.workflowManager.validateWorkflowName(selectedWorkflow, context.projectPath)) {
+            const availableWorkflows = context.workflowManager.getWorkflowNames();
+            throw new Error(`Invalid workflow: ${selectedWorkflow}. Available workflows: ${availableWorkflows.join(', ')}`);
+        }
+        // Check for project documentation artifacts and guide setup if needed
+        const artifactGuidance = await this.checkProjectArtifacts(context.projectPath, selectedWorkflow, context);
+        if (artifactGuidance) {
+            return artifactGuidance;
+        }
+        // Check if user is on main/master branch and prompt for branch creation
+        const currentBranch = this.getCurrentGitBranch(context.projectPath);
+        if (currentBranch === 'main' || currentBranch === 'master') {
+            const suggestedBranchName = this.generateBranchSuggestion();
+            const branchPromptResponse = {
+                phase: 'branch-prompt',
+                instructions: `You're currently on the ${currentBranch} branch. It's recommended to create a feature branch for development. Propose a branch creation by suggesting a branch command to the user call start_development again.\n\nSuggested command: \`git checkout -b ${suggestedBranchName}\`\n\nPlease create a new branch and then call start_development again to begin development.`,
+                plan_file_path: '',
+                conversation_id: '',
+                workflow: {},
+            };
+            this.logger.debug('User on main/master branch, prompting for branch creation', {
+                currentBranch,
+                suggestedBranchName,
+            });
+            return branchPromptResponse;
+        }
+        // Create or get conversation context with the selected workflow
+        const conversationContext = await context.conversationManager.createConversationContext(selectedWorkflow);
+        const currentPhase = conversationContext.currentPhase;
+        // Load the selected workflow
+        const stateMachine = context.workflowManager.loadWorkflowForProject(conversationContext.projectPath, selectedWorkflow);
+        const initialState = stateMachine.initial_state;
+        // Check if development is already started
+        if (currentPhase !== initialState) {
+            throw new Error(`Development already started. Current phase is '${currentPhase}', not initial state '${initialState}'. Use whats_next() to continue development.`);
+        }
+        // The initial state IS the first development phase - it's explicitly modeled
+        const targetPhase = initialState;
+        // Transition to the initial development phase
+        const transitionResult = await context.transitionEngine.handleExplicitTransition(currentPhase, targetPhase, conversationContext.projectPath, 'Development initialization', selectedWorkflow);
+        // Update conversation state with workflow, phase, and git commit configuration
+        await context.conversationManager.updateConversationState(conversationContext.conversationId, {
+            currentPhase: transitionResult.newPhase,
+            workflowName: selectedWorkflow,
+            gitCommitConfig: gitCommitConfig,
+            requireReviewsBeforePhaseTransition: requireReviews,
+        });
+        // Set state machine on plan manager before creating plan file
+        context.planManager.setStateMachine(stateMachine);
+        // Ensure plan file exists
+        await context.planManager.ensurePlanFile(conversationContext.planFilePath, conversationContext.projectPath, conversationContext.gitBranch);
+        // Ensure .vibe/.gitignore exists to exclude SQLite files for git repositories
+        this.ensureGitignoreEntry(conversationContext.projectPath);
+        // Generate workflow documentation URL
+        const workflowDocumentationUrl = this.generateWorkflowDocumentationUrl(selectedWorkflow);
+        // Generate instructions with simple i18n guidance
+        const baseInstructions = `Look at the plan file (${conversationContext.planFilePath}). Define entrance criteria for each phase of the workflow except the initial phase. Those criteria shall be based on the contents of the previous phase. \n      Example: \n      \`\`\`\n      ## Design\n\n      ### Phase Entrance Criteria:\n      - [ ] The requirements have been thoroughly defined.\n      - [ ] Alternatives have been evaluated and are documented. \n      - [ ] It's clear what's in scope and out of scope\n      \`\`\`\n      \n      IMPORTANT: Once you added reasonable entrance call the whats_next() tool to get guided instructions for the next current phase.`;
+        const i18nGuidance = `\n\nNOTE: If the user is communicating in a non-English language, please translate the plan file content to that language while keeping the structure intact, and continue all interactions in the user's language.`;
+        // Add workflow documentation information if available
+        const workflowDocumentationInfo = workflowDocumentationUrl
+            ? `\n\nInform the user about the chose workflow: He can visit: ${workflowDocumentationUrl} to get detailed information.`
+            : '';
+        const finalInstructions = baseInstructions + workflowDocumentationInfo + i18nGuidance;
+        const response = {
+            phase: transitionResult.newPhase,
+            instructions: finalInstructions,
+            plan_file_path: conversationContext.planFilePath,
+            conversation_id: conversationContext.conversationId,
+            workflow: stateMachine,
+            workflowDocumentationUrl,
+        };
+        // Log interaction
+        await this.logInteraction(context, conversationContext.conversationId, 'start_development', args, response, transitionResult.newPhase);
+        return response;
+    }
+    /**
+     * 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
+     */
+    async checkProjectArtifacts(projectPath, workflowName, context) {
+        try {
+            // Load the workflow to analyze its content
+            const stateMachine = context.workflowManager.loadWorkflowForProject(projectPath, workflowName);
+            // Check if this workflow requires documentation (defaults to false)
+            const requiresDocumentation = stateMachine.metadata?.requiresDocumentation ?? false;
+            // If workflow doesn't require documentation, skip artifact check entirely
+            if (!requiresDocumentation) {
+                this.logger.debug('Workflow does not require documentation, skipping artifact check', { workflowName, requiresDocumentation });
+                return null;
+            }
+            // Analyze workflow content to detect referenced document variables
+            const referencedVariables = this.analyzeWorkflowDocumentReferences(stateMachine, projectPath);
+            // If no document variables are referenced, skip artifact check
+            if (referencedVariables.length === 0) {
+                this.logger.debug('No document variables found in workflow, skipping artifact check', { workflowName });
+                return null;
+            }
+            // Check which referenced documents are missing
+            const docsInfo = await this.projectDocsManager.getProjectDocsInfo(projectPath);
+            const missingDocs = this.getMissingReferencedDocuments(referencedVariables, docsInfo, projectPath);
+            // If all referenced documents exist, continue with normal flow
+            if (missingDocs.length === 0) {
+                this.logger.debug('All referenced project artifacts exist, continuing with development', {
+                    workflowName,
+                    referencedVariables,
+                });
+                return null;
+            }
+            // Generate guidance for setting up missing artifacts
+            const setupGuidance = await this.generateArtifactSetupGuidance(missingDocs, workflowName, docsInfo, referencedVariables);
+            this.logger.info('Missing required project artifacts detected for workflow that requires documentation', {
+                workflowName,
+                requiresDocumentation,
+                referencedVariables,
+                missingDocs,
+                projectPath,
+            });
+            return {
+                phase: 'artifact-setup',
+                instructions: setupGuidance,
+                plan_file_path: '',
+                conversation_id: '',
+                workflow: {},
+            };
+        }
+        catch (error) {
+            this.logger.warn('Failed to analyze workflow for document references, proceeding without artifact check', {
+                workflowName,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return null;
+        }
+    }
+    /**
+     * Analyze workflow content to detect document variable references
+     */
+    analyzeWorkflowDocumentReferences(stateMachine, projectPath) {
+        // Get available document variables from ProjectDocsManager
+        const variableSubstitutions = this.projectDocsManager.getVariableSubstitutions(projectPath);
+        const documentVariables = Object.keys(variableSubstitutions);
+        const referencedVariables = new Set();
+        // Convert the entire state machine to a string for analysis
+        const workflowContent = JSON.stringify(stateMachine);
+        // Check for each document variable
+        for (const variable of documentVariables) {
+            if (workflowContent.includes(variable)) {
+                referencedVariables.add(variable);
+            }
+        }
+        this.logger.debug('Analyzed workflow for document references', {
+            workflowContent: workflowContent.length + ' characters',
+            availableVariables: documentVariables,
+            referencedVariables: Array.from(referencedVariables),
+        });
+        return Array.from(referencedVariables);
+    }
+    /**
+     * Determine which referenced documents are missing
+     */
+    getMissingReferencedDocuments(referencedVariables, docsInfo, projectPath) {
+        const missingDocs = [];
+        // Get variable substitutions to derive the mapping
+        const variableSubstitutions = this.projectDocsManager.getVariableSubstitutions(projectPath);
+        // Create reverse mapping from variable to document type
+        const variableToDocMap = {};
+        for (const [variable, path] of Object.entries(variableSubstitutions)) {
+            // Extract document type from path (e.g., 'architecture' from 'architecture.md')
+            const filename = path.split('/').pop() || '';
+            const docType = filename.replace('.md', '');
+            variableToDocMap[variable] = docType;
+        }
+        for (const variable of referencedVariables) {
+            const docType = variableToDocMap[variable];
+            if (docType && docType in docsInfo) {
+                const docInfo = docsInfo[docType];
+                if (docInfo && !docInfo.exists) {
+                    missingDocs.push(`${docType}.md`);
+                }
+            }
+        }
+        return missingDocs;
+    }
+    /**
+     * Generate guidance for setting up missing project artifacts
+     */
+    async generateArtifactSetupGuidance(missingDocs, workflowName, docsInfo, referencedVariables) {
+        const missingList = missingDocs.map(doc => `- ${doc}`).join('\n');
+        const existingDocs = [];
+        if (docsInfo.architecture.exists) {
+            const fileName = basename(docsInfo.architecture.path);
+            existingDocs.push(`✅ ${fileName}`);
+        }
+        if (docsInfo.requirements.exists) {
+            const fileName = basename(docsInfo.requirements.path);
+            existingDocs.push(`✅ ${fileName}`);
+        }
+        if (docsInfo.design.exists) {
+            const fileName = basename(docsInfo.design.path);
+            existingDocs.push(`✅ ${fileName}`);
+        }
+        const existingList = existingDocs.length > 0
+            ? `\n\n**Existing Documents:**\n${existingDocs.join('\n')}`
+            : '';
+        const referencedVariablesList = referencedVariables
+            .map(v => `\`${v}\``)
+            .join(', ');
+        // Get available templates dynamically
+        const availableTemplates = await this.projectDocsManager.templateManager.getAvailableTemplates();
+        const defaults = await this.projectDocsManager.templateManager.getDefaults();
+        // Generate template options dynamically
+        const templateOptionsText = this.generateTemplateOptionsText(availableTemplates);
+        return `## Project Documentation Setup Required
+
+The **${workflowName}** workflow references project documentation that doesn't exist yet.
+
+**Referenced Variables:** ${referencedVariablesList}
+
+**Missing Documents:**
+${missingList}${existingList}
+
+## 🚀 **Quick Setup**
+
+Use the \`setup_project_docs\` tool to create these documents with templates:
+
+\`\`\`
+setup_project_docs({
+  architecture: "${defaults.architecture}",        // or other available options
+  requirements: "${defaults.requirements}",         // or other available options
+  design: "${defaults.design}"       // or other available options
+})
+\`\`\`
+
+${templateOptionsText}
+
+## ⚡ **Next Steps**
+
+1. **Call \`setup_project_docs\`** with your preferred templates
+2. **Call \`start_development\`** again to begin the ${workflowName} workflow
+3. The workflow will reference these documents using the detected variables: ${referencedVariablesList}
+
+**Note:** You can also proceed without structured docs, but the workflow instructions will reference missing files.`;
+    }
+    /**
+     * Generate template options text dynamically
+     */
+    generateTemplateOptionsText(availableTemplates) {
+        const sections = [];
+        if (availableTemplates.architecture.length > 0) {
+            const archOptions = availableTemplates.architecture
+                .map(template => {
+                const description = this.getTemplateDescription(template, 'architecture');
+                return `- **${template}**: ${description}`;
+            })
+                .join('\n');
+            sections.push(`**Architecture Templates:**\n${archOptions}`);
+        }
+        if (availableTemplates.requirements.length > 0) {
+            const reqOptions = availableTemplates.requirements
+                .map(template => {
+                const description = this.getTemplateDescription(template, 'requirements');
+                return `- **${template}**: ${description}`;
+            })
+                .join('\n');
+            sections.push(`**Requirements Templates:**\n${reqOptions}`);
+        }
+        if (availableTemplates.design.length > 0) {
+            const designOptions = availableTemplates.design
+                .map(template => {
+                const description = this.getTemplateDescription(template, 'design');
+                return `- **${template}**: ${description}`;
+            })
+                .join('\n');
+            sections.push(`**Design Templates:**\n${designOptions}`);
+        }
+        return sections.length > 0
+            ? `## 📋 **Template Options**\n\n${sections.join('\n\n')}`
+            : '';
+    }
+    /**
+     * Get description for a template based on its name and type
+     */
+    getTemplateDescription(template, type) {
+        switch (template) {
+            case 'arc42':
+                return 'Comprehensive software architecture template with diagrams';
+            case 'ears':
+                return 'WHEN...THEN format for clear, testable requirements';
+            case 'comprehensive':
+                return 'Full implementation guide with testing strategy';
+            case 'freestyle':
+                return `Simple, flexible ${type} documentation`;
+            default:
+                return `${template} format for ${type} documentation`;
+        }
+    }
+    /**
+     * Generate workflow documentation URL for predefined workflows
+     * Returns undefined for custom workflows
+     */
+    generateWorkflowDocumentationUrl(workflowName) {
+        // Don't generate URL for custom workflows
+        if (workflowName === 'custom') {
+            return undefined;
+        }
+        // Generate URL for predefined workflows
+        return `https://mrsimpson.github.io/responsible-vibe-mcp/workflows/${workflowName}`;
+    }
+    /**
+     * Get the current git branch for a project
+     * Uses the same logic as ConversationManager but locally accessible
+     */
+    getCurrentGitBranch(projectPath) {
+        try {
+            const { execSync } = require('node:child_process');
+            const { existsSync } = require('node:fs');
+            // Check if this is a git repository
+            if (!existsSync(`${projectPath}/.git`)) {
+                this.logger.debug('Not a git repository, using "default" as branch name', { projectPath });
+                return 'default';
+            }
+            // Get current branch name
+            const branch = execSync('git rev-parse --abbrev-ref HEAD', {
+                cwd: projectPath,
+                encoding: 'utf-8',
+                stdio: ['ignore', 'pipe', 'ignore'], // Suppress stderr
+            }).trim();
+            this.logger.debug('Detected git branch', { projectPath, branch });
+            return branch;
+        }
+        catch (_error) {
+            this.logger.debug('Failed to get git branch, using "default" as branch name', { projectPath });
+            return 'default';
+        }
+    }
+    /**
+     * Generate a suggested branch name for feature development
+     */
+    generateBranchSuggestion() {
+        const timestamp = new Date().toISOString().slice(0, 10).replace(/-/g, '');
+        return `feature/development-${timestamp}`;
+    }
+    /**
+     * Ensure .gitignore exists in .vibe folder to exclude SQLite files
+     * This function is idempotent and self-contained within the .vibe directory
+     */
+    ensureGitignoreEntry(projectPath) {
+        try {
+            // Check if this is a git repository
+            if (!existsSync(`${projectPath}/.git`)) {
+                this.logger.debug('Not a git repository, skipping .gitignore management', { projectPath });
+                return;
+            }
+            const vibeDir = resolve(projectPath, '.vibe');
+            const gitignorePath = resolve(vibeDir, '.gitignore');
+            // Ensure .vibe directory exists
+            if (!existsSync(vibeDir)) {
+                mkdirSync(vibeDir, { recursive: true });
+            }
+            // Content for .vibe/.gitignore
+            const gitignoreContent = `# Exclude SQLite database files
+*.sqlite
+*.sqlite-*
+conversation-state.sqlite*
+`;
+            // Check if .gitignore already exists and has the right content
+            if (existsSync(gitignorePath)) {
+                try {
+                    const existingContent = readFileSync(gitignorePath, 'utf-8');
+                    if (existingContent.includes('*.sqlite') &&
+                        existingContent.includes('conversation-state.sqlite')) {
+                        this.logger.debug('.vibe/.gitignore already exists with SQLite exclusions', { gitignorePath });
+                        return;
+                    }
+                }
+                catch (error) {
+                    this.logger.warn('Failed to read existing .vibe/.gitignore, will recreate', {
+                        gitignorePath,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                }
+            }
+            // Write the .gitignore file
+            writeFileSync(gitignorePath, gitignoreContent, 'utf-8');
+            this.logger.info('Created .vibe/.gitignore to exclude SQLite files', {
+                projectPath,
+                gitignorePath,
+            });
+        }
+        catch (error) {
+            // Log warning but don't fail development start
+            this.logger.warn('Failed to create .vibe/.gitignore, continuing with development start', {
+                projectPath,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+}
+//# sourceMappingURL=start-development.js.map

package/dist/tool-handlers/start-development.js.map

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

package/dist/tool-handlers/whats-next.d.ts

@@ -0,0 +1,42 @@
+/**
+ * WhatsNext Tool Handler
+ *
+ * Handles the whats_next tool which analyzes conversation context and
+ * determines the next development phase with specific instructions for the LLM.
+ */
+import { ConversationRequiredToolHandler } from './base-tool-handler.js';
+import type { ConversationContext } from '@codemcp/workflows-core';
+import { ServerContext } from '../types.js';
+/**
+ * Arguments for the whats_next tool
+ */
+export interface WhatsNextArgs {
+    context?: string;
+    user_input?: string;
+    conversation_summary?: string;
+    recent_messages?: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>;
+}
+/**
+ * Response from the whats_next tool
+ */
+export interface WhatsNextResult {
+    phase: string;
+    instructions: string;
+    plan_file_path: string;
+    is_modeled_transition: boolean;
+    conversation_id: string;
+}
+/**
+ * WhatsNext tool handler implementation
+ */
+export declare class WhatsNextHandler extends ConversationRequiredToolHandler<WhatsNextArgs, WhatsNextResult> {
+    protected executeWithConversation(args: WhatsNextArgs, context: ServerContext, conversationContext: ConversationContext): Promise<WhatsNextResult>;
+    /**
+     * Determines whether conversation state should be updated for a phase transition
+     */
+    private shouldUpdateConversationState;
+}
+//# sourceMappingURL=whats-next.d.ts.map

package/dist/tool-handlers/whats-next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whats-next.d.ts","sourceRoot":"","sources":["../../src/tool-handlers/whats-next.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,KAAK,CAAC;QACtB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAC3B,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,+BAA+B,CACnE,aAAa,EACb,eAAe,CAChB;cACiB,uBAAuB,CACrC,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,aAAa,EACtB,mBAAmB,EAAE,mBAAmB,GACvC,OAAO,CAAC,eAAe,CAAC;IA8I3B;;OAEG;YACW,6BAA6B;CA2C5C"}

package/dist/tool-handlers/whats-next.js

@@ -0,0 +1,118 @@
+/**
+ * WhatsNext Tool Handler
+ *
+ * Handles the whats_next tool which analyzes conversation context and
+ * determines the next development phase with specific instructions for the LLM.
+ */
+import { ConversationRequiredToolHandler } from './base-tool-handler.js';
+/**
+ * WhatsNext tool handler implementation
+ */
+export class WhatsNextHandler extends ConversationRequiredToolHandler {
+    async executeWithConversation(args, context, conversationContext) {
+        const { context: requestContext = '', user_input = '', conversation_summary = '', recent_messages = [], } = args;
+        const conversationId = conversationContext.conversationId;
+        const currentPhase = conversationContext.currentPhase;
+        this.logger.debug('Processing whats_next request', {
+            conversationId,
+            currentPhase,
+            hasContext: !!requestContext,
+            hasUserInput: !!user_input,
+        });
+        // Ensure state machine is loaded for this project
+        this.ensureStateMachineForProject(context, conversationContext.projectPath, conversationContext.workflowName);
+        // Ensure plan file exists
+        await context.planManager.ensurePlanFile(conversationContext.planFilePath, conversationContext.projectPath, conversationContext.gitBranch);
+        // Analyze phase transition
+        const transitionResult = await context.transitionEngine.analyzePhaseTransition({
+            currentPhase,
+            projectPath: conversationContext.projectPath,
+            userInput: user_input,
+            context: requestContext,
+            conversationSummary: conversation_summary,
+            recentMessages: recent_messages,
+            conversationId: conversationContext.conversationId,
+        });
+        // Update conversation state if phase changed
+        if (transitionResult.newPhase !== currentPhase) {
+            const shouldUpdateState = await this.shouldUpdateConversationState(currentPhase, transitionResult.newPhase, conversationContext, context);
+            if (shouldUpdateState) {
+                await context.conversationManager.updateConversationState(conversationId, { currentPhase: transitionResult.newPhase });
+            }
+            // If this was a first-call auto-transition, regenerate the plan file
+            if (transitionResult.transitionReason.includes('Starting development - defining criteria')) {
+                this.logger.info('Regenerating plan file after first-call auto-transition', {
+                    from: currentPhase,
+                    to: transitionResult.newPhase,
+                    planFilePath: conversationContext.planFilePath,
+                });
+                await context.planManager.ensurePlanFile(conversationContext.planFilePath, conversationContext.projectPath, conversationContext.gitBranch);
+            }
+            this.logger.info('Phase transition completed', {
+                from: currentPhase,
+                to: transitionResult.newPhase,
+                reason: transitionResult.transitionReason,
+            });
+        }
+        // Check if plan file exists
+        const planInfo = await context.planManager.getPlanFileInfo(conversationContext.planFilePath);
+        // Generate enhanced instructions
+        const instructions = await context.instructionGenerator.generateInstructions(transitionResult.instructions, {
+            phase: transitionResult.newPhase,
+            conversationContext: {
+                ...conversationContext,
+                currentPhase: transitionResult.newPhase,
+            },
+            transitionReason: transitionResult.transitionReason,
+            isModeled: transitionResult.isModeled,
+            planFileExists: planInfo.exists,
+        });
+        // Add commit instructions if configured
+        let finalInstructions = instructions.instructions;
+        if (conversationContext.gitCommitConfig?.enabled &&
+            conversationContext.gitCommitConfig.commitOnStep) {
+            const commitMessage = requestContext || 'Step completion';
+            finalInstructions += `\n\n**Git Commit Required**: Create a commit for this step using:\n\`\`\`bash\ngit add . && git commit -m "${commitMessage}"\n\`\`\``;
+        }
+        // Prepare response
+        const response = {
+            phase: transitionResult.newPhase,
+            instructions: finalInstructions,
+            plan_file_path: conversationContext.planFilePath,
+            is_modeled_transition: transitionResult.isModeled,
+            conversation_id: conversationContext.conversationId,
+        };
+        // Log interaction
+        await this.logInteraction(context, conversationId, 'whats_next', args, response, transitionResult.newPhase);
+        return response;
+    }
+    /**
+     * Determines whether conversation state should be updated for a phase transition
+     */
+    async shouldUpdateConversationState(currentPhase, newPhase, conversationContext, context) {
+        if (!conversationContext.requireReviewsBeforePhaseTransition) {
+            return true;
+        }
+        const stateMachine = context.workflowManager.loadWorkflowForProject(conversationContext.projectPath, conversationContext.workflowName);
+        const currentState = stateMachine.states[currentPhase];
+        if (!currentState) {
+            return true;
+        }
+        const transition = currentState.transitions.find(t => t.to === newPhase);
+        if (!transition) {
+            return true;
+        }
+        const hasReviewPerspectives = transition.review_perspectives &&
+            transition.review_perspectives.length > 0;
+        if (hasReviewPerspectives) {
+            this.logger.debug('Preventing state update - review required for transition', {
+                from: currentPhase,
+                to: newPhase,
+                reviewPerspectives: transition.review_perspectives?.length || 0,
+            });
+            return false;
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=whats-next.js.map

package/dist/tool-handlers/whats-next.js.map

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