@exaudeus/workrail 0.1.10 → 0.2.1

package/dist/application/services/workflow-service.d.ts

@@ -34,6 +34,8 @@ export declare class DefaultWorkflowService implements WorkflowService {
         context?: ConditionContext;
     }>;
     private buildStepPrompt;
+    private collectConditionVars;
+    private collectEqualsValues;
     private findLoopStepById;
     validateStepOutput(workflowId: string, stepId: string, output: string): Promise<{
         valid: boolean;

package/dist/application/services/workflow-service.js

@@ -189,6 +189,61 @@ class DefaultWorkflowService {
             }
             return this.getNextStep(workflowId, completedSteps, loopStartSizeCheck.context);
         }
+        if (!nextStep) {
+            const remainingConditionalSteps = workflow.steps.filter((step) => {
+                if (completed.includes(step.id))
+                    return false;
+                if (loopBodySteps.has(step.id))
+                    return false;
+                return !!step.runCondition;
+            });
+            if (remainingConditionalSteps.length > 0) {
+                const requiredVars = new Set();
+                const allowedValues = {};
+                for (const step of remainingConditionalSteps) {
+                    const condition = step.runCondition;
+                    this.collectConditionVars(condition, requiredVars);
+                    this.collectEqualsValues(condition, allowedValues);
+                }
+                const issues = [];
+                for (const variableName of requiredVars) {
+                    const currentValue = enhancedContext[variableName];
+                    const allowed = allowedValues[variableName]
+                        ? Array.from(allowedValues[variableName])
+                        : [];
+                    if (currentValue === undefined || currentValue === null || currentValue === '') {
+                        if (allowed.length > 0) {
+                            issues.push(`Set '${variableName}' to one of: ${allowed.map(v => `'${v}'`).join(', ')}`);
+                        }
+                        else {
+                            issues.push(`Provide a value for '${variableName}'`);
+                        }
+                    }
+                    else if (allowed.length > 0) {
+                        const matchesExactly = allowed.some(v => v === String(currentValue));
+                        const matchesCaseInsensitive = allowed.some(v => v.toLowerCase() === String(currentValue).toLowerCase());
+                        if (!matchesExactly) {
+                            if (matchesCaseInsensitive) {
+                                issues.push(`Normalize casing for '${variableName}': use one of ${allowed.map(v => `'${v}'`).join(', ')} (current '${currentValue}')`);
+                            }
+                            else {
+                                issues.push(`Adjust '${variableName}' to one of: ${allowed.map(v => `'${v}'`).join(', ')} (current '${currentValue}')`);
+                            }
+                        }
+                    }
+                }
+                if (issues.length > 0) {
+                    return {
+                        step: null,
+                        guidance: {
+                            prompt: `No eligible step due to unmet conditions. Please update context:\n- ${issues.join('\n- ')}`
+                        },
+                        isComplete: false,
+                        context: enhancedContext
+                    };
+                }
+            }
+        }
         const isComplete = !nextStep;
         let finalPrompt = 'Workflow complete.';
         if (nextStep) {
@@ -232,6 +287,46 @@ class DefaultWorkflowService {
         }
         return finalPrompt;
     }
+    collectConditionVars(condition, sink) {
+        if (!condition || typeof condition !== 'object')
+            return;
+        if (typeof condition.var === 'string' && condition.var.length > 0) {
+            sink.add(condition.var);
+        }
+        if (Array.isArray(condition.and)) {
+            for (const sub of condition.and)
+                this.collectConditionVars(sub, sink);
+        }
+        if (Array.isArray(condition.or)) {
+            for (const sub of condition.or)
+                this.collectConditionVars(sub, sink);
+        }
+        if (condition.not)
+            this.collectConditionVars(condition.not, sink);
+    }
+    collectEqualsValues(condition, sink) {
+        if (!condition || typeof condition !== 'object')
+            return;
+        if (typeof condition.var === 'string' && Object.prototype.hasOwnProperty.call(condition, 'equals')) {
+            const variableName = condition.var;
+            const value = condition.equals;
+            if (value !== undefined && value !== null) {
+                if (!sink[variableName])
+                    sink[variableName] = new Set();
+                sink[variableName].add(String(value));
+            }
+        }
+        if (Array.isArray(condition.and)) {
+            for (const sub of condition.and)
+                this.collectEqualsValues(sub, sink);
+        }
+        if (Array.isArray(condition.or)) {
+            for (const sub of condition.or)
+                this.collectEqualsValues(sub, sink);
+        }
+        if (condition.not)
+            this.collectEqualsValues(condition.not, sink);
+    }
     findLoopStepById(workflow, stepId) {
         const step = workflow.steps.find(s => s.id === stepId);
         return step && (0, workflow_types_1.isLoopStep)(step) ? step : null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exaudeus/workrail",
-  "version": "0.1.10",
+  "version": "0.2.1",
   "description": "MCP server for structured workflow orchestration and step-by-step task guidance",
   "license": "MIT",
   "bin": {

package/workflows/coding-task-workflow-with-loops.json

@@ -431,7 +431,7 @@
                 {
                     "id": "phase-6-prep",
                     "title": "PREP: Prepare for Step {{currentStepNumber + 1}}",
-                    "prompt": "**PREPARATION PHASE for Step {{currentStepNumber + 1}}/{{totalImplementationSteps}}**\n\nBefore implementing this step, you must first PREPARE:\n\n1. **Read implementation_plan.md** and locate step #{{currentStepNumber + 1}}\n2. **Extract step details**: Note the title, description, and expected outputs\n3. **Confirm prerequisites**: Verify the previous step (if any) was completed correctly\n4. **Validate current state**: Ensure the plan for this step is still valid in the current codebase\n5. **List requirements**: Identify all required inputs, files, or dependencies\n\n**BRANCH SETUP (first iteration only):** If this is the first implementation step ({{currentStepNumber}} === 0):\n- Check git availability with 'git status'\n- If available, create feature branch: 'git checkout -b wip-[unique-task-id]'\n- Track the featureBranch variable for later use\n- If git unavailable: Skip branching, log in CONTEXT.md\n\n**CRITICAL CONTEXT OPTIMIZATION:**\nWhen calling workflow_next after this step, send ONLY:\n- currentStepNumber and totalImplementationSteps\n- Any NEW variables you created (like featureBranch)\n- DO NOT send: arrays, plans, _loopState, _currentLoop, unchanged data\n\n**Do not proceed if anything is unclear or missing.**",
+                    "prompt": "**PREPARATION PHASE for Step {{currentStepNumber + 1}}/{{totalImplementationSteps}}**\n\nBefore implementing this step, you must first PREPARE:\n\n1. **Read implementation_plan.md** and locate step #{{currentStepNumber + 1}}\n2. **Extract step details**: Note the title, description, and expected outputs\n3. **Confirm prerequisites**: Verify the previous step (if any) was completed correctly\n4. **Validate current state**: Ensure the plan for this step is still valid in the current codebase\n5. **List requirements**: Identify all required inputs, files, or dependencies\n\n**BRANCH SETUP (first iteration only):** If this is the first implementation step ({{currentStepNumber}} === 0):\n- Check git availability with 'git status'\n- If available, create feature branch: 'git checkout -b wip-[unique-task-id]'\n- Track the featureBranch variable for later use\n- If git unavailable: Skip branching, log in CONTEXT.md\n\n**Do not proceed if anything is unclear or missing.**",
                     "agentRole": "You are preparing to implement a specific step from the plan. Be meticulous in verifying all prerequisites are met before proceeding.",
                     "guidance": [
                         "This is step {{currentStepNumber + 1}} of {{totalImplementationSteps}} total implementation steps",
@@ -444,7 +444,7 @@
                 {
                     "id": "phase-6-implement",
                     "title": "IMPLEMENT: Execute Step {{currentStepNumber + 1}}",
-                    "prompt": "**IMPLEMENTATION PHASE for Step {{currentStepNumber + 1}}/{{totalImplementationSteps}}**\n\nNow implement the step you just prepared for:\n\n**Instructions:**\n1. Re-read step #{{currentStepNumber + 1}} from implementation_plan.md\n2. Focus only on this single step\n3. useTools() to make code changes\n4. Follow quality standards\n5. Adapt to unexpected discoveries\n6. createFile() for ALL code changes\n\n**Remember:** applyUserRules() and matchPatterns() throughout.\n\n**Progress Tracking:**\n- This is step {{currentStepNumber + 1}} of {{totalImplementationSteps}}\n- If we've done > 20 steps total, pause for user intervention\n\n**CONTEXT UPDATES:** If this is every 3rd step ({{currentStepNumber + 1}} % 3 === 0):\n- Update CONTEXT.md\n- addResumptionJson(phase-6-implement)\n- updateDecisionLog()\n- List files modified with line ranges\n\n**CONTEXT OPTIMIZATION for workflow_next:**\nSend ONLY: currentStepNumber, totalImplementationSteps, filesCreated (new), any other NEW data\nDO NOT send: arrays, plans, _loopState, unchanged fields",
+                    "prompt": "**IMPLEMENTATION PHASE for Step {{currentStepNumber + 1}}/{{totalImplementationSteps}}**\n\nNow implement the step you just prepared for:\n\n**Instructions:**\n1. Re-read step #{{currentStepNumber + 1}} from implementation_plan.md\n2. Focus only on this single step\n3. useTools() to make code changes\n4. Follow quality standards\n5. Adapt to unexpected discoveries\n6. createFile() for ALL code changes\n\n**Remember:** applyUserRules() and matchPatterns() throughout.\n\n**Progress Tracking:**\n- This is step {{currentStepNumber + 1}} of {{totalImplementationSteps}}\n- If we've done > 20 steps total, pause for user intervention\n\n**CONTEXT UPDATES:** If this is every 3rd step ({{currentStepNumber + 1}} % 3 === 0):\n- Update CONTEXT.md\n- addResumptionJson(phase-6-implement)\n- updateDecisionLog()\n- List files modified with line ranges\n\n",
                     "agentRole": "You are implementing a specific step from the approved plan. Focus on precise execution while maintaining code quality.",
                     "guidance": [
                         "Implement only what this step requires",
@@ -456,7 +456,7 @@
                 {
                     "id": "phase-6-verify",
                     "title": "VERIFY: Validate Step {{currentStepNumber + 1}}",
-                    "prompt": "**VERIFICATION PHASE for Step {{currentStepNumber + 1}}/{{totalImplementationSteps}}**\n\nVerify the implementation is complete and correct:\n\n**Required:** verifyImplementation()\n\n**COMMIT Decision (if all passes):**\n- checkAutomation(commit)\n- gitCommit(type, scope: description)\n- If git unavailable: Log in CONTEXT.md\n\n**FAILURE PROTOCOL:** If verification fails after 2 attempts:\n1. Do not try a third time\n2. Fall back to alternative tools\n3. updateDecisionLog() with failure details\n4. Present summary and recommendations\n5. Set 'verificationFailed' context variable to true\n\n**CONTEXT OPTIMIZATION:**\nFor workflow_next, send ONLY what changed: currentStepNumber, verificationResult, verificationFailed (if true)\nNEVER send back the full context!",
+                    "prompt": "**VERIFICATION PHASE for Step {{currentStepNumber + 1}}/{{totalImplementationSteps}}**\n\nVerify the implementation is complete and correct:\n\n**Required:** verifyImplementation()\n\n**COMMIT Decision (if all passes):**\n- checkAutomation(commit)\n- gitCommit(type, scope: description)\n- If git unavailable: Log in CONTEXT.md\n\n**FAILURE PROTOCOL:** If verification fails after 2 attempts:\n1. Do not try a third time\n2. Fall back to alternative tools\n3. updateDecisionLog() with failure details\n4. Present summary and recommendations\n5. Set 'verificationFailed' context variable to true\n\n",
                     "agentRole": "You are verifying the implementation meets all quality standards. Be thorough but respect failure bounds.",
                     "guidance": [
                         "All three verification steps must pass",