@codemcp/workflows 5.3.0 → 6.0.2

package/packages/core/dist/state-machine-loader.js

@@ -0,0 +1,273 @@
+/**
+ * State Machine Loader
+ *
+ * Loads and validates YAML-based state machine definitions
+ */
+import fs from 'node:fs';
+import yaml from 'js-yaml';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createRequire } from 'node:module';
+import { createLogger } from './logger.js';
+const logger = createLogger('StateMachineLoader');
+/**
+ * Loads and manages YAML-based state machine definitions
+ */
+export class StateMachineLoader {
+    stateMachine = null;
+    validPhases = new Set();
+    /**
+     * Get all valid phases from the loaded state machine
+     */
+    getValidPhases() {
+        if (!this.stateMachine) {
+            throw new Error('State machine not loaded');
+        }
+        return Array.from(this.validPhases);
+    }
+    /**
+     * Get the initial state from the loaded state machine
+     */
+    getInitialState() {
+        if (!this.stateMachine) {
+            throw new Error('State machine not loaded');
+        }
+        return this.stateMachine.initial_state;
+    }
+    /**
+     * Load state machine from YAML file
+     *
+     * Checks for custom state machine file in project directory first,
+     * then falls back to waterfall workflow as default
+     */
+    loadStateMachine(projectPath) {
+        // Check for custom state machine file in project directory
+        const customFilePaths = [
+            path.join(projectPath, '.vibe', 'workflow.yaml'),
+            path.join(projectPath, '.vibe', 'workflow.yml'),
+        ];
+        // Try to load custom state machine file
+        for (const filePath of customFilePaths) {
+            if (fs.existsSync(filePath)) {
+                logger.info('Loading custom state machine file', { filePath });
+                try {
+                    return this.loadFromFile(filePath);
+                }
+                catch (error) {
+                    logger.warn('Failed to load custom state machine, falling back to default', {
+                        filePath,
+                        error: error.message,
+                    });
+                    // Continue to try next file or fall back to default
+                }
+            }
+        }
+        // Fall back to waterfall workflow as default
+        const defaultFilePath = this.resolveWorkflowPath('waterfall.yaml');
+        logger.info('Loading default state machine file', { defaultFilePath });
+        return this.loadFromFile(defaultFilePath);
+    }
+    /**
+     * Resolve workflow path using similar strategy as TemplateManager
+     */
+    resolveWorkflowPath(filename) {
+        const strategies = [];
+        // Strategy 1: Local resources directory (symlinked from root)
+        strategies.push(path.join(path.dirname(fileURLToPath(import.meta.url)), '../resources/workflows', filename));
+        // Strategy 2: From compiled dist directory
+        const currentFileUrl = import.meta.url;
+        if (currentFileUrl.startsWith('file://')) {
+            const currentFilePath = fileURLToPath(currentFileUrl);
+            // From dist/state-machine-loader.js -> ../resources/workflows
+            strategies.push(path.join(path.dirname(currentFilePath), '../resources/workflows', filename));
+        }
+        // Strategy 3: Current working directory (for development)
+        strategies.push(path.join(process.cwd(), 'resources/workflows', filename));
+        // Strategy 4: From node_modules
+        strategies.push(path.join(process.cwd(), 'node_modules/@codemcp/workflows-core/resources/workflows', filename));
+        // 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 = path.dirname(packagePath);
+            strategies.push(path.join(packageDir, 'resources/workflows', filename));
+        }
+        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
+                fs.accessSync(strategy);
+                logger.debug('Using workflow 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 workflow path found, using fallback', { path: fallback });
+        return fallback;
+    }
+    loadFromFile(filePath) {
+        try {
+            const yamlContent = fs.readFileSync(path.resolve(filePath), 'utf8');
+            const stateMachine = yaml.load(yamlContent);
+            // Validate the state machine
+            this.validateStateMachine(stateMachine);
+            // Store valid phases for later validation
+            this.validPhases = new Set(Object.keys(stateMachine.states));
+            this.stateMachine = stateMachine;
+            logger.info('State machine loaded successfully', {
+                name: stateMachine.name,
+                stateCount: Object.keys(stateMachine.states).length,
+                phases: Array.from(this.validPhases),
+            });
+            return stateMachine;
+        }
+        catch (error) {
+            logger.error('Failed to load state machine', error);
+            throw new Error(`Failed to load state machine: ${error.message}`);
+        }
+    }
+    /**
+     * Validate the state machine structure and references
+     */
+    validateStateMachine(stateMachine) {
+        // Check required properties
+        if (!stateMachine.name ||
+            !stateMachine.description ||
+            !stateMachine.initial_state ||
+            !stateMachine.states) {
+            throw new Error('State machine is missing required properties');
+        }
+        // Get all state names
+        const stateNames = Object.keys(stateMachine.states);
+        // Check initial state is valid
+        if (!stateNames.includes(stateMachine.initial_state)) {
+            throw new Error(`Initial state "${stateMachine.initial_state}" is not defined in states`);
+        }
+        // Validate states and transitions
+        for (const [stateName, state] of Object.entries(stateMachine.states)) {
+            // Check required state properties
+            if (!state.description || !state.default_instructions) {
+                throw new Error(`State "${stateName}" is missing required properties (description or default_instructions)`);
+            }
+            if (!state.transitions || !Array.isArray(state.transitions)) {
+                throw new Error(`State "${stateName}" has invalid transitions property`);
+            }
+            for (const transition of state.transitions) {
+                if (!stateNames.includes(transition.to)) {
+                    throw new Error(`State "${stateName}" has transition to unknown state "${transition.to}"`);
+                }
+                if (!transition.transition_reason) {
+                    throw new Error(`Transition from "${stateName}" to "${transition.to}" is missing transition_reason`);
+                }
+            }
+        }
+        logger.debug('State machine validation successful');
+    }
+    /**
+     * Get transition instructions for a specific state change
+     */
+    getTransitionInstructions(fromState, toState, trigger) {
+        if (!this.stateMachine) {
+            throw new Error('State machine not loaded');
+        }
+        // Get target state definition
+        const targetState = this.stateMachine.states[toState];
+        if (!targetState) {
+            throw new Error(`Target state "${toState}" not found`);
+        }
+        // Look for a modeled transition first
+        const fromStateDefinition = this.stateMachine.states[fromState];
+        if (fromStateDefinition) {
+            const transition = fromStateDefinition.transitions.find(t => t.to === toState && (!trigger || t.trigger === trigger));
+            if (transition) {
+                // For modeled transitions, compose instructions
+                let composedInstructions = targetState.default_instructions;
+                // If transition has specific instructions, use those instead of default
+                if (transition.instructions) {
+                    composedInstructions = transition.instructions;
+                }
+                // If transition has additional instructions, combine them
+                if (transition.additional_instructions) {
+                    composedInstructions = `${composedInstructions}\n\n**Additional Context:**\n${transition.additional_instructions}`;
+                }
+                return {
+                    instructions: composedInstructions,
+                    transitionReason: transition.transition_reason,
+                    isModeled: true,
+                };
+            }
+        }
+        // Fall back to target state's default instructions for unmodeled transitions
+        return {
+            instructions: targetState.default_instructions,
+            transitionReason: `Direct transition to ${toState} phase`,
+            isModeled: false,
+        };
+    }
+    /**
+     * Get all possible transitions from a given state
+     */
+    getPossibleTransitions(fromState) {
+        if (!this.stateMachine) {
+            throw new Error('State machine not loaded');
+        }
+        const stateDefinition = this.stateMachine.states[fromState];
+        return stateDefinition ? stateDefinition.transitions : [];
+    }
+    /**
+     * Check if a transition is modeled (shown in state diagram)
+     */
+    isModeledTransition(fromState, toState) {
+        if (!this.stateMachine) {
+            throw new Error('State machine not loaded');
+        }
+        const stateDefinition = this.stateMachine.states[fromState];
+        if (!stateDefinition)
+            return false;
+        return stateDefinition.transitions.some(t => t.to === toState);
+    }
+    /**
+     * Check if a phase is valid in the current state machine
+     */
+    isValidPhase(phase) {
+        return this.validPhases.has(phase);
+    }
+    /**
+     * Get phase-specific instructions for continuing work in current phase
+     */
+    getContinuePhaseInstructions(phase) {
+        if (!this.stateMachine) {
+            throw new Error('State machine not loaded');
+        }
+        const stateDefinition = this.stateMachine.states[phase];
+        if (!stateDefinition) {
+            logger.error('Unknown phase', new Error(`Unknown phase: ${phase}`));
+            throw new Error(`Unknown phase: ${phase}`);
+        }
+        // Look for a self-transition (continue in same phase)
+        const continueTransition = stateDefinition.transitions.find(t => t.to === phase);
+        if (continueTransition) {
+            // Compose instructions for continue transition
+            let composedInstructions = stateDefinition.default_instructions;
+            // If transition has specific instructions, use those instead of default
+            if (continueTransition.instructions) {
+                composedInstructions = continueTransition.instructions;
+            }
+            // If transition has additional instructions, combine them
+            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;
+    }
+}
+//# sourceMappingURL=state-machine-loader.js.map

package/packages/core/dist/state-machine-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine-loader.js","sourceRoot":"","sources":["../src/state-machine-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,MAAM,MAAM,GAAG,YAAY,CAAC,oBAAoB,CAAC,CAAC;AAElD;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACrB,YAAY,GAA4B,IAAI,CAAC;IAC7C,WAAW,GAAgB,IAAI,GAAG,EAAE,CAAC;IAE7C;;OAEG;IACI,cAAc;QACnB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACI,eAAe;QACpB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACI,gBAAgB,CAAC,WAAmB;QACzC,2DAA2D;QAC3D,MAAM,eAAe,GAAG;YACtB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,eAAe,CAAC;YAChD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,cAAc,CAAC;SAChD,CAAC;QAEF,wCAAwC;QACxC,KAAK,MAAM,QAAQ,IAAI,eAAe,EAAE,CAAC;YACvC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC/D,IAAI,CAAC;oBACH,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;gBACrC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,CACT,8DAA8D,EAC9D;wBACE,QAAQ;wBACR,KAAK,EAAG,KAAe,CAAC,OAAO;qBAChC,CACF,CAAC;oBACF,oDAAoD;gBACtD,CAAC;YACH,CAAC;QACH,CAAC;QAED,6CAA6C;QAC7C,MAAM,eAAe,GAAG,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;QAEnE,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,QAAgB;QAC1C,MAAM,UAAU,GAAa,EAAE,CAAC;QAEhC,8DAA8D;QAC9D,UAAU,CAAC,IAAI,CACb,IAAI,CAAC,IAAI,CACP,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAC5C,wBAAwB,EACxB,QAAQ,CACT,CACF,CAAC;QAEF,2CAA2C;QAC3C,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QACvC,IAAI,cAAc,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,MAAM,eAAe,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;YACtD,8DAA8D;YAC9D,UAAU,CAAC,IAAI,CACb,IAAI,CAAC,IAAI,CACP,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAC7B,wBAAwB,EACxB,QAAQ,CACT,CACF,CAAC;QACJ,CAAC;QAED,0DAA0D;QAC1D,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,qBAAqB,EAAE,QAAQ,CAAC,CAAC,CAAC;QAE3E,gCAAgC;QAChC,UAAU,CAAC,IAAI,CACb,IAAI,CAAC,IAAI,CACP,OAAO,CAAC,GAAG,EAAE,EACb,0DAA0D,EAC1D,QAAQ,CACT,CACF,CAAC;QAEF,uDAAuD;QACvD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC/C,MAAM,WAAW,GACf,OAAO,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;YAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAC7C,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,qBAAqB,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,8BAA8B;QAChC,CAAC;QAED,+BAA+B;QAC/B,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,wCAAwC;gBACxC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBACxB,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACxD,OAAO,QAAQ,CAAC;YAClB,CAAC;YAAC,OAAO,MAAM,EAAE,CAAC;gBAChB,4BAA4B;YAC9B,CAAC;QACH,CAAC;QAED,2CAA2C;QAC3C,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC1E,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEM,YAAY,CAAC,QAAgB;QAClC,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;YACpE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAqB,CAAC;YAEhE,6BAA6B;YAC7B,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;YAExC,0CAA0C;YAC1C,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;YAE7D,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE;gBAC/C,IAAI,EAAE,YAAY,CAAC,IAAI;gBACvB,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,MAAM;gBACnD,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC;aACrC,CAAC,CAAC;YAEH,OAAO,YAAY,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAc,CAAC,CAAC;YAC7D,MAAM,IAAI,KAAK,CACb,iCAAkC,KAAe,CAAC,OAAO,EAAE,CAC5D,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,YAA8B;QACzD,4BAA4B;QAC5B,IACE,CAAC,YAAY,CAAC,IAAI;YAClB,CAAC,YAAY,CAAC,WAAW;YACzB,CAAC,YAAY,CAAC,aAAa;YAC3B,CAAC,YAAY,CAAC,MAAM,EACpB,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QAED,sBAAsB;QACtB,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAEpD,+BAA+B;QAC/B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CACb,kBAAkB,YAAY,CAAC,aAAa,4BAA4B,CACzE,CAAC;QACJ,CAAC;QAED,kCAAkC;QAClC,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YACrE,kCAAkC;YAClC,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC;gBACtD,MAAM,IAAI,KAAK,CACb,UAAU,SAAS,wEAAwE,CAC5F,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC5D,MAAM,IAAI,KAAK,CACb,UAAU,SAAS,oCAAoC,CACxD,CAAC;YACJ,CAAC;YAED,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;gBAC3C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;oBACxC,MAAM,IAAI,KAAK,CACb,UAAU,SAAS,sCAAsC,UAAU,CAAC,EAAE,GAAG,CAC1E,CAAC;gBACJ,CAAC;gBAED,IAAI,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC;oBAClC,MAAM,IAAI,KAAK,CACb,oBAAoB,SAAS,SAAS,UAAU,CAAC,EAAE,gCAAgC,CACpF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACI,yBAAyB,CAC9B,SAAiB,EACjB,OAAe,EACf,OAAgB;QAEhB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QAED,8BAA8B;QAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,iBAAiB,OAAO,aAAa,CAAC,CAAC;QACzD,CAAC;QAED,sCAAsC;QACtC,MAAM,mBAAmB,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChE,IAAI,mBAAmB,EAAE,CAAC;YACxB,MAAM,UAAU,GAAG,mBAAmB,CAAC,WAAW,CAAC,IAAI,CACrD,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAC7D,CAAC;YAEF,IAAI,UAAU,EAAE,CAAC;gBACf,gDAAgD;gBAChD,IAAI,oBAAoB,GAAG,WAAW,CAAC,oBAAoB,CAAC;gBAE5D,wEAAwE;gBACxE,IAAI,UAAU,CAAC,YAAY,EAAE,CAAC;oBAC5B,oBAAoB,GAAG,UAAU,CAAC,YAAY,CAAC;gBACjD,CAAC;gBAED,0DAA0D;gBAC1D,IAAI,UAAU,CAAC,uBAAuB,EAAE,CAAC;oBACvC,oBAAoB,GAAG,GAAG,oBAAoB,gCAAgC,UAAU,CAAC,uBAAuB,EAAE,CAAC;gBACrH,CAAC;gBAED,OAAO;oBACL,YAAY,EAAE,oBAAoB;oBAClC,gBAAgB,EAAE,UAAU,CAAC,iBAAiB;oBAC9C,SAAS,EAAE,IAAI;iBAChB,CAAC;YACJ,CAAC;QACH,CAAC;QAED,6EAA6E;QAC7E,OAAO;YACL,YAAY,EAAE,WAAW,CAAC,oBAAoB;YAC9C,gBAAgB,EAAE,wBAAwB,OAAO,QAAQ;YACzD,SAAS,EAAE,KAAK;SACjB,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,sBAAsB,CAAC,SAAiB;QAC7C,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC5D,OAAO,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,CAAC;IAED;;OAEG;IACI,mBAAmB,CAAC,SAAiB,EAAE,OAAe;QAC3D,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC5D,IAAI,CAAC,eAAe;YAAE,OAAO,KAAK,CAAC;QAEnC,OAAO,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACI,YAAY,CAAC,KAAa;QAC/B,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACI,4BAA4B,CAAC,KAAa;QAC/C,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxD,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,IAAI,KAAK,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,sDAAsD;QACtD,MAAM,kBAAkB,GAAG,eAAe,CAAC,WAAW,CAAC,IAAI,CACzD,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CACpB,CAAC;QAEF,IAAI,kBAAkB,EAAE,CAAC;YACvB,+CAA+C;YAC/C,IAAI,oBAAoB,GAAG,eAAe,CAAC,oBAAoB,CAAC;YAEhE,wEAAwE;YACxE,IAAI,kBAAkB,CAAC,YAAY,EAAE,CAAC;gBACpC,oBAAoB,GAAG,kBAAkB,CAAC,YAAY,CAAC;YACzD,CAAC;YAED,0DAA0D;YAC1D,IAAI,kBAAkB,CAAC,uBAAuB,EAAE,CAAC;gBAC/C,oBAAoB,GAAG,GAAG,oBAAoB,gCAAgC,kBAAkB,CAAC,uBAAuB,EAAE,CAAC;YAC7H,CAAC;YAED,OAAO,oBAAoB,CAAC;QAC9B,CAAC;QAED,kDAAkD;QAClD,OAAO,eAAe,CAAC,oBAAoB,CAAC;IAC9C,CAAC;CACF"}

package/packages/core/dist/state-machine-types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * State Machine Types
+ *
+ * Type definitions for YAML-based state machine
+ */
+/**
+ * Transition between states
+ */
+export interface YamlTransition {
+    /** Event that triggers this transition */
+    trigger: string;
+    /** Target state after transition */
+    to: string;
+    /** Instructions to provide when this transition occurs (optional - uses target state default if not provided) */
+    instructions?: string;
+    /** Additional instructions to combine with target state's default instructions (optional) */
+    additional_instructions?: string;
+    /** Reason for this transition */
+    transition_reason: string;
+    /** Optional review perspectives for this transition */
+    review_perspectives?: Array<{
+        perspective: string;
+        prompt: string;
+    }>;
+    /** Optional role targeting for crowd workflows (e.g., 'business-analyst', 'architect', 'developer') */
+    role?: string;
+}
+/**
+ * State definition
+ */
+export interface YamlState {
+    /** Description of this state */
+    description: string;
+    /** Default instructions when entering this state */
+    default_instructions: string;
+    /** Transitions from this state */
+    transitions: YamlTransition[];
+}
+/**
+ * Complete state machine definition
+ */
+export interface YamlStateMachine {
+    /** Name of the state machine */
+    name: string;
+    /** Description of the state machine's purpose */
+    description: string;
+    /** The starting state of the machine */
+    initial_state: string;
+    /** Map of states in the state machine */
+    states: Record<string, YamlState>;
+    /** Optional metadata for enhanced discoverability */
+    metadata?: {
+        complexity?: 'low' | 'medium' | 'high';
+        domain: string;
+        bestFor?: string[];
+        useCases?: string[];
+        examples?: string[];
+        requiresDocumentation?: boolean;
+        /** Indicates this workflow supports multi-agent collaboration */
+        collaboration?: boolean;
+        /** Required agent roles for this collaborative workflow */
+        requiredRoles?: string[];
+    };
+}

package/packages/core/dist/state-machine-types.js

@@ -0,0 +1,7 @@
+/**
+ * State Machine Types
+ *
+ * Type definitions for YAML-based state machine
+ */
+export {};
+//# sourceMappingURL=state-machine-types.js.map

package/packages/core/dist/state-machine-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine-types.js","sourceRoot":"","sources":["../src/state-machine-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/packages/core/dist/state-machine.d.ts

@@ -0,0 +1,52 @@
+/**
+ * State Machine Definition for Vibe Feature MCP Server
+ *
+ * This module defines the development workflow state machine, including:
+ * - Development phases (states)
+ * - Transition triggers and conditions
+ * - Phase-specific instructions for LLM guidance
+ * - Transition-specific prompts for contextual guidance
+ */
+export type DevelopmentPhase = 'idle' | 'requirements' | 'design' | 'implementation' | 'qa' | 'testing' | 'complete';
+export type TransitionTrigger = 'new_feature_request' | 'refine_requirements' | 'requirements_complete' | 'abandon_feature' | 'refine_design' | 'requirements_unclear' | 'design_complete' | 'refine_implementation' | 'design_issues' | 'implementation_complete' | 'refine_qa' | 'implementation_issues' | 'qa_complete' | 'refine_testing' | 'qa_issues' | 'testing_complete' | 'feature_delivered' | 'direct_transition';
+export interface StateTransition {
+    from: DevelopmentPhase;
+    to: DevelopmentPhase;
+    trigger: TransitionTrigger;
+    isModeled: boolean;
+    instructions: string;
+    transitionReason: string;
+}
+/**
+ * Complete state transition table
+ *
+ * This table defines all possible transitions between development phases.
+ * - Modeled transitions: Shown in the state diagram, get contextual guidance
+ * - Direct transitions: Not shown in diagram, get general phase instructions
+ */
+export declare const STATE_TRANSITIONS: StateTransition[];
+/**
+ * Direct transition instructions for non-modeled transitions
+ * These are used when users jump directly to any phase using proceed_to_phase
+ */
+export declare const DIRECT_PHASE_INSTRUCTIONS: Record<DevelopmentPhase, string>;
+/**
+ * Get transition instructions for a specific state change
+ */
+export declare function getTransitionInstructions(fromState: DevelopmentPhase, toState: DevelopmentPhase, trigger?: TransitionTrigger): {
+    instructions: string;
+    transitionReason: string;
+    isModeled: boolean;
+};
+/**
+ * Get all possible transitions from a given state
+ */
+export declare function getPossibleTransitions(fromState: DevelopmentPhase): StateTransition[];
+/**
+ * Check if a transition is modeled (shown in state diagram)
+ */
+export declare function isModeledTransition(fromState: DevelopmentPhase, toState: DevelopmentPhase): boolean;
+/**
+ * Get phase-specific instructions for continuing work in current phase
+ */
+export declare function getContinuePhaseInstructions(phase: DevelopmentPhase): string;