@codemcp/workflows 5.3.0 → 6.0.1

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

@@ -0,0 +1,231 @@
+/**
+ * Template Manager
+ *
+ * Handles loading and rendering of project document templates.
+ * Supports different template formats for architecture, requirements, and design documents.
+ */
+import { readFile, readdir, stat } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createRequire } from 'node:module';
+import { createLogger } from './logger.js';
+const logger = createLogger('TemplateManager');
+export class TemplateManager {
+    templatesPath;
+    constructor() {
+        this.templatesPath = this.resolveTemplatesPath();
+    }
+    /**
+     * Resolve templates path using similar strategy as WorkflowManager
+     */
+    resolveTemplatesPath() {
+        const strategies = [];
+        // Strategy 1: Local resources directory (symlinked from root)
+        strategies.push(join(dirname(fileURLToPath(import.meta.url)), '../resources/templates'));
+        // Strategy 2: From compiled dist directory
+        const currentFileUrl = import.meta.url;
+        if (currentFileUrl.startsWith('file://')) {
+            const currentFilePath = fileURLToPath(currentFileUrl);
+            // From dist/template-manager.js -> ../resources/templates
+            strategies.push(join(dirname(currentFilePath), '../resources/templates'));
+        }
+        // Strategy 3: Current working directory (for development)
+        strategies.push(join(process.cwd(), 'resources/templates'));
+        // Strategy 4: From node_modules
+        strategies.push(join(process.cwd(), 'node_modules/@codemcp/workflows-core/resources/templates'));
+        // Strategy 5: From package directory (for development)
+        try {
+            const require = createRequire(import.meta.url);
+            const packagePath = require.resolve('@codemcp/workflows-core/package.json');
+            const packageDir = dirname(packagePath);
+            strategies.push(join(packageDir, 'resources/templates'));
+        }
+        catch (_error) {
+            // Ignore if package not found
+        }
+        // Find the first existing path
+        for (const strategy of strategies) {
+            try {
+                // This will throw if path doesn't exist
+                require('node:fs').accessSync(strategy);
+                logger.debug('Using templates path', { path: strategy });
+                return strategy;
+            }
+            catch (_error) {
+                // Continue to next strategy
+            }
+        }
+        // Fallback to first strategy if none found
+        const fallback = strategies[0];
+        logger.warn('No templates directory found, using fallback', {
+            fallback,
+            strategies,
+        });
+        return fallback;
+    }
+    /**
+     * Get the default template options based on available templates
+     */
+    async getDefaults() {
+        const availableTemplates = await this.getAvailableTemplates();
+        return {
+            architecture: this.getPreferredTemplate(availableTemplates.architecture, [
+                'arc42',
+                'freestyle',
+            ]),
+            requirements: this.getPreferredTemplate(availableTemplates.requirements, [
+                'ears',
+                'freestyle',
+            ]),
+            design: this.getPreferredTemplate(availableTemplates.design, [
+                'comprehensive',
+                'freestyle',
+            ]),
+        };
+    }
+    /**
+     * Get preferred template from available options, with fallback preferences
+     */
+    getPreferredTemplate(available, preferences) {
+        // Try to find the first preference that's available
+        for (const preference of preferences) {
+            if (available.includes(preference)) {
+                return preference;
+            }
+        }
+        // If no preferences are available, return the first available template
+        return available[0] || preferences[0];
+    }
+    /**
+     * Load and render a template
+     */
+    async loadTemplate(type, template) {
+        const templatePath = join(this.templatesPath, type, template);
+        const templateFilePath = `${templatePath}.md`;
+        try {
+            // First try to check if it's a directory (like arc42)
+            try {
+                const stats = await stat(templatePath);
+                if (stats.isDirectory()) {
+                    return await this.loadDirectoryTemplate(templatePath);
+                }
+            }
+            catch (_error) {
+                // Not a directory, continue to file check
+            }
+            // Try to load as a markdown file
+            const content = await readFile(templateFilePath, 'utf-8');
+            return { content };
+        }
+        catch (error) {
+            logger.error(`Failed to load template: ${type}/${template}`, error);
+            throw new Error(`Template not found: ${type}/${template}. Tried: ${templatePath} (directory) and ${templateFilePath} (file)`);
+        }
+    }
+    /**
+     * Load a directory-based template (like arc42 with images)
+     */
+    async loadDirectoryTemplate(templatePath) {
+        const additionalFiles = [];
+        // Find the main markdown file
+        const files = await readdir(templatePath);
+        const markdownFile = files.find(file => file.endsWith('.md'));
+        if (!markdownFile) {
+            throw new Error(`No markdown file found in template directory: ${templatePath}`);
+        }
+        const content = await readFile(join(templatePath, markdownFile), 'utf-8');
+        // Load additional files (like images)
+        await this.loadAdditionalFiles(templatePath, '', additionalFiles);
+        return {
+            content,
+            additionalFiles: additionalFiles.filter(file => !file.relativePath.endsWith('.md')),
+        };
+    }
+    /**
+     * Recursively load additional files from template directory
+     */
+    async loadAdditionalFiles(basePath, relativePath, additionalFiles) {
+        const currentPath = join(basePath, relativePath);
+        const items = await readdir(currentPath);
+        for (const item of items) {
+            const itemPath = join(currentPath, item);
+            const itemRelativePath = relativePath ? join(relativePath, item) : item;
+            const stats = await stat(itemPath);
+            if (stats.isDirectory()) {
+                // Recursively process subdirectories
+                await this.loadAdditionalFiles(basePath, itemRelativePath, additionalFiles);
+            }
+            else if (!item.endsWith('.md')) {
+                // Load non-markdown files as additional files
+                const content = await readFile(itemPath);
+                additionalFiles.push({
+                    relativePath: itemRelativePath,
+                    content,
+                });
+            }
+        }
+    }
+    /**
+     * Validate template options against available templates
+     */
+    async validateOptions(options) {
+        const availableTemplates = await this.getAvailableTemplates();
+        if (options.architecture &&
+            !availableTemplates.architecture.includes(options.architecture)) {
+            throw new Error(`Invalid architecture template: ${options.architecture}. Valid options: ${availableTemplates.architecture.join(', ')}`);
+        }
+        if (options.requirements &&
+            !availableTemplates.requirements.includes(options.requirements)) {
+            throw new Error(`Invalid requirements template: ${options.requirements}. Valid options: ${availableTemplates.requirements.join(', ')}`);
+        }
+        if (options.design && !availableTemplates.design.includes(options.design)) {
+            throw new Error(`Invalid design template: ${options.design}. Valid options: ${availableTemplates.design.join(', ')}`);
+        }
+    }
+    /**
+     * Get available templates for each type by scanning the file system
+     */
+    async getAvailableTemplates() {
+        const result = {
+            architecture: [],
+            requirements: [],
+            design: [],
+        };
+        try {
+            // Scan each template type directory
+            for (const [type, templates] of Object.entries(result)) {
+                const typePath = join(this.templatesPath, type);
+                try {
+                    const entries = await readdir(typePath, { withFileTypes: true });
+                    for (const entry of entries) {
+                        if (entry.isDirectory()) {
+                            // Directory-based template (like arc42)
+                            templates.push(entry.name);
+                        }
+                        else if (entry.isFile() && entry.name.endsWith('.md')) {
+                            // File-based template (like freestyle.md)
+                            const templateName = entry.name.replace('.md', '');
+                            templates.push(templateName);
+                        }
+                    }
+                    // Sort templates for consistent ordering
+                    templates.sort();
+                }
+                catch (error) {
+                    logger.warn(`Failed to scan templates for type: ${type}`, {
+                        typePath,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                }
+            }
+            logger.debug('Discovered available templates', result);
+            return result;
+        }
+        catch (error) {
+            logger.error('Failed to discover templates', error);
+            // Return empty arrays if discovery fails
+            return result;
+        }
+    }
+}
+//# sourceMappingURL=template-manager.js.map

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

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

package/packages/core/dist/transition-engine.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Transition Engine
+ *
+ * Manages the development state machine and determines appropriate phase transitions.
+ * Analyzes conversation context and user input to make intelligent phase decisions.
+ */
+import type { ConversationState } from './types.js';
+export interface TransitionContext {
+    currentPhase: string;
+    projectPath: string;
+    conversationId: string;
+    userInput?: string;
+    context?: string;
+    conversationSummary?: string;
+    recentMessages?: Array<{
+        role: string;
+        content: string;
+    }>;
+}
+export interface TransitionResult {
+    newPhase: string;
+    instructions: string;
+    transitionReason: string;
+    isModeled: boolean;
+}
+export declare class TransitionEngine {
+    private stateMachineLoader;
+    private workflowManager;
+    private conversationManager?;
+    constructor(projectPath: string);
+    /**
+     * Set the conversation manager (dependency injection)
+     */
+    setConversationManager(conversationManager: {
+        hasInteractions: (conversationId: string) => Promise<boolean>;
+        getConversationState: (conversationId: string) => Promise<ConversationState | null>;
+    }): void;
+    /**
+     * Get the loaded state machine for the current project
+     */
+    getStateMachine(projectPath: string, workflowName?: string): import("./state-machine-types.js").YamlStateMachine;
+    /**
+     * Check if this is the first call from initial state based on database interactions
+     */
+    private isFirstCallFromInitialState;
+    /**
+     * Generate instructions for defining phase entrance criteria
+     */
+    private generateCriteriaDefinitionInstructions;
+    /**
+     * Get phase-specific instructions for continuing work in current phase
+     */
+    private getContinuePhaseInstructions;
+    /**
+     * Get the first development phase from the state machine
+     */
+    private getFirstDevelopmentPhase;
+    /**
+     * Analyze context and determine appropriate phase transition
+     */
+    analyzePhaseTransition(context: TransitionContext): Promise<TransitionResult>;
+    /**
+     * Handle explicit phase transition request
+     */
+    handleExplicitTransition(currentPhase: string, targetPhase: string, projectPath: string, reason?: string, workflowName?: string): TransitionResult;
+    /**
+     * Capitalize phase name for display
+     */
+    private capitalizePhase;
+    /**
+     * Filter transitions based on agent role (for crowd workflows)
+     * Returns transitions applicable to the current agent
+     */
+    filterTransitionsByRole<T extends {
+        role?: string;
+    }>(transitions: T[], agentRole?: string): T[];
+}

package/packages/core/dist/transition-engine.js

@@ -0,0 +1,244 @@
+/**
+ * Transition Engine
+ *
+ * Manages the development state machine and determines appropriate phase transitions.
+ * Analyzes conversation context and user input to make intelligent phase decisions.
+ */
+import { createLogger } from './logger.js';
+import { StateMachineLoader } from './state-machine-loader.js';
+import { WorkflowManager } from './workflow-manager.js';
+const logger = createLogger('TransitionEngine');
+export class TransitionEngine {
+    stateMachineLoader;
+    workflowManager;
+    conversationManager;
+    constructor(projectPath) {
+        this.stateMachineLoader = new StateMachineLoader();
+        this.workflowManager = new WorkflowManager();
+        logger.info('TransitionEngine initialized', { projectPath });
+    }
+    /**
+     * Set the conversation manager (dependency injection)
+     */
+    setConversationManager(conversationManager) {
+        this.conversationManager = conversationManager;
+    }
+    /**
+     * Get the loaded state machine for the current project
+     */
+    getStateMachine(projectPath, workflowName) {
+        // Use WorkflowManager to load the appropriate workflow
+        return this.workflowManager.loadWorkflowForProject(projectPath, workflowName);
+    }
+    /**
+     * Check if this is the first call from initial state based on database interactions
+     */
+    async isFirstCallFromInitialState(context) {
+        // Check database for any previous interactions in this conversation
+        if (!this.conversationManager) {
+            logger.warn('ConversationManager not set, assuming first call');
+            return true;
+        }
+        const hasInteractions = await this.conversationManager.hasInteractions(context.conversationId);
+        logger.debug('Checking first call from initial state', {
+            hasInteractions,
+            conversationId: context.conversationId,
+            currentPhase: context.currentPhase,
+        });
+        return !hasInteractions;
+    }
+    /**
+     * Generate instructions for defining phase entrance criteria
+     */
+    async generateCriteriaDefinitionInstructions(projectPath, conversationId) {
+        // Get workflow name from conversation state
+        const conversationState = await this.conversationManager?.getConversationState(conversationId);
+        const workflowName = conversationState?.workflowName;
+        const stateMachine = this.workflowManager.loadWorkflowForProject(projectPath, workflowName);
+        const phases = Object.keys(stateMachine.states);
+        let instructions = `Welcome to ${stateMachine.name}!
+
+Before we begin development, let's establish clear entrance criteria for each phase. This will help us make informed decisions about when to transition between phases throughout the development process.
+
+Please update the plan file with a "Phase Entrance Criteria" section that defines specific, measurable criteria for entering each phase:
+
+## Phase Entrance Criteria
+
+`;
+        // Generate criteria template for each phase (except initial state)
+        for (const phase of phases) {
+            if (phase === stateMachine.initial_state)
+                continue; // Skip initial state
+            const phaseDefinition = stateMachine.states[phase];
+            const capitalizedPhase = this.capitalizePhase(phase);
+            instructions += `### ${capitalizedPhase} Phase
+*${phaseDefinition.description}*
+
+**Enter when:**
+- [ ] [Define specific criteria for entering ${phase} phase]
+- [ ] [Add measurable conditions that must be met]
+- [ ] [Include any deliverables or milestones required]
+
+`;
+        }
+        instructions += `
+Once you've defined these criteria, we can begin development. Throughout the process, consult these criteria when considering phase transitions.
+
+**Remember**: These criteria should be specific and measurable so we can clearly determine when each phase is ready to begin.`;
+        return instructions;
+    }
+    /**
+     * Get phase-specific instructions for continuing work in current phase
+     */
+    async getContinuePhaseInstructions(phase, projectPath, conversationId) {
+        // Get workflow name from conversation state
+        const conversationState = await this.conversationManager?.getConversationState(conversationId);
+        const workflowName = conversationState?.workflowName;
+        const stateMachine = this.workflowManager.loadWorkflowForProject(projectPath, workflowName);
+        const stateDefinition = stateMachine.states[phase];
+        if (!stateDefinition) {
+            logger.error('Unknown phase', new Error(`Unknown phase: ${phase}`));
+            throw new Error(`Unknown phase: ${phase}`);
+        }
+        const continueTransition = stateDefinition.transitions.find(t => t.to === phase);
+        if (continueTransition) {
+            // Use the transition instructions if available, otherwise use default + additional
+            if (continueTransition.instructions) {
+                return continueTransition.instructions;
+            }
+            else {
+                let composedInstructions = stateDefinition.default_instructions;
+                if (continueTransition.additional_instructions) {
+                    composedInstructions = `${composedInstructions}\n\n**Additional Context:**\n${continueTransition.additional_instructions}`;
+                }
+                return composedInstructions;
+            }
+        }
+        // Fall back to default instructions for the phase
+        return stateDefinition.default_instructions;
+    }
+    /**
+     * Get the first development phase from the state machine
+     */
+    async getFirstDevelopmentPhase(projectPath, conversationId) {
+        // Get workflow name from conversation state
+        const conversationState = await this.conversationManager?.getConversationState(conversationId);
+        const workflowName = conversationState?.workflowName;
+        const stateMachine = this.workflowManager.loadWorkflowForProject(projectPath, workflowName);
+        const initialState = stateMachine.initial_state;
+        // The first development phase IS the initial state - we should stay there
+        // Don't automatically transition to the first transition target
+        return initialState;
+    }
+    /**
+     * Analyze context and determine appropriate phase transition
+     */
+    async analyzePhaseTransition(context) {
+        const { currentPhase, projectPath, conversationId, userInput, context: additionalContext, conversationSummary, } = context;
+        // Load the appropriate workflow for this project/conversation
+        logger.debug('Analyzing phase transition', {
+            currentPhase,
+            projectPath,
+            hasUserInput: !!userInput,
+            hasContext: !!additionalContext,
+            hasSummary: !!conversationSummary,
+            userInput: userInput
+                ? userInput.substring(0, 50) + (userInput.length > 50 ? '...' : '')
+                : undefined,
+        });
+        // Check if this is the first call from initial state - transition to first development phase
+        if (await this.isFirstCallFromInitialState(context)) {
+            const firstDevelopmentPhase = await this.getFirstDevelopmentPhase(projectPath, conversationId);
+            logger.info('First call from initial state - transitioning to first development phase with criteria', {
+                currentPhase,
+                firstDevelopmentPhase,
+                projectPath,
+            });
+            // Combine criteria definition with first phase instructions
+            const criteriaInstructions = await this.generateCriteriaDefinitionInstructions(projectPath, conversationId);
+            const phaseInstructions = await this.getContinuePhaseInstructions(firstDevelopmentPhase, projectPath, conversationId);
+            return {
+                newPhase: firstDevelopmentPhase, // Transition to first development phase
+                instructions: criteriaInstructions + '\n\n---\n\n' + phaseInstructions,
+                transitionReason: 'Starting development - defining criteria and beginning first phase',
+                isModeled: true,
+            };
+        }
+        // For all other cases, stay in current phase and let LLM decide based on plan file criteria
+        // The LLM will consult the entrance criteria in the plan file and use proceed_to_phase when ready
+        const continueInstructions = await this.getContinuePhaseInstructions(currentPhase, projectPath, conversationId);
+        logger.debug('Continuing in current phase - LLM will evaluate transition criteria', {
+            currentPhase,
+            projectPath,
+        });
+        return {
+            newPhase: currentPhase,
+            instructions: continueInstructions,
+            transitionReason: 'Continue current phase - LLM will evaluate transition criteria from plan file',
+            isModeled: false,
+        };
+    }
+    /**
+     * Handle explicit phase transition request
+     */
+    handleExplicitTransition(currentPhase, targetPhase, projectPath, reason, workflowName) {
+        // Load the appropriate state machine for this project/workflow
+        const stateMachine = this.getStateMachine(projectPath, workflowName);
+        logger.debug('Handling explicit phase transition', {
+            currentPhase,
+            targetPhase,
+            projectPath,
+            workflowName,
+            reason,
+        });
+        // Validate that the target phase exists in the state machine
+        if (!stateMachine.states[targetPhase]) {
+            const validPhases = Object.keys(stateMachine.states);
+            const errorMsg = `Invalid target phase: "${targetPhase}". Valid phases are: ${validPhases.join(', ')}`;
+            logger.error('Invalid target phase', new Error(errorMsg));
+            throw new Error(errorMsg);
+        }
+        // Get default instructions from the target state
+        const targetState = stateMachine.states[targetPhase];
+        const instructions = targetState.default_instructions;
+        const transitionInfo = {
+            instructions: instructions,
+            transitionReason: reason || `Moving to ${targetPhase}`,
+            isModeled: false, // Direct phase transitions are not modeled
+        };
+        logger.info('Explicit phase transition processed', {
+            fromPhase: currentPhase,
+            toPhase: targetPhase,
+            reason: transitionInfo.transitionReason,
+            isModeled: transitionInfo.isModeled,
+        });
+        return {
+            newPhase: targetPhase,
+            instructions: transitionInfo.instructions,
+            transitionReason: reason || transitionInfo.transitionReason,
+            isModeled: transitionInfo.isModeled,
+        };
+    }
+    /**
+     * Capitalize phase name for display
+     */
+    capitalizePhase(phase) {
+        return phase
+            .split('_')
+            .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+            .join(' ');
+    }
+    /**
+     * Filter transitions based on agent role (for crowd workflows)
+     * Returns transitions applicable to the current agent
+     */
+    filterTransitionsByRole(transitions, agentRole) {
+        // If no role specified, return all transitions (single-agent mode)
+        if (!agentRole) {
+            return transitions;
+        }
+        // Filter transitions: include if no role specified OR role matches
+        return transitions.filter(t => !t.role || t.role === agentRole);
+    }
+}
+//# sourceMappingURL=transition-engine.js.map

package/packages/core/dist/transition-engine.js.map

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

package/packages/core/dist/types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Common types used across the application
+ */
+/**
+ * Interface for interaction log entries
+ */
+export interface InteractionLog {
+    id?: number;
+    conversationId: string;
+    toolName: string;
+    inputParams: string;
+    responseData: string;
+    currentPhase: string;
+    timestamp: string;
+    isReset?: boolean;
+    resetAt?: string;
+}
+/**
+ * Interface for conversation state
+ */
+/**
+ * Git commit configuration options
+ */
+export interface GitCommitConfig {
+    enabled: boolean;
+    commitOnStep: boolean;
+    commitOnPhase: boolean;
+    commitOnComplete: boolean;
+    initialMessage: string;
+    startCommitHash?: string;
+}
+export interface ConversationState {
+    conversationId: string;
+    projectPath: string;
+    gitBranch: string;
+    currentPhase: string;
+    planFilePath: string;
+    workflowName: string;
+    requireReviewsBeforePhaseTransition: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Interface for conversation context
+ */
+export interface ConversationContext {
+    conversationId: string;
+    projectPath: string;
+    gitBranch: string;
+    currentPhase: string;
+    planFilePath: string;
+    workflowName: string;
+    requireReviewsBeforePhaseTransition?: boolean;
+}

package/packages/core/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Common types used across the application
+ */
+export {};
+//# sourceMappingURL=types.js.map