feat(conditions): add support for OR conditions in workflow steps and chained prompts

implement conditionsAny field to allow steps to be executed when any of the specified conditions are met
update condition checking logic in workflow runner and chained prompts loader to handle both AND and OR conditions

Author: moazbuilds

src/agents/runner/chained.ts

@@ -233,8 +233,18 @@ function isConditionalPath(entry: ChainedPathEntry): entry is ConditionalChained
  */
 function meetsConditions(entry: ChainedPathEntry, selectedConditions: string[]): boolean {
   if (typeof entry === 'string') return true;
-  if (!entry.conditions?.length) return true;
-  return entry.conditions.every(c => selectedConditions.includes(c));
+  const requiredAll = entry.conditions ?? [];
+  const requiredAny = entry.conditionsAny ?? [];
+
+  if (requiredAll.length > 0 && !requiredAll.every(c => selectedConditions.includes(c))) {
+    return false;
+  }
+
+  if (requiredAny.length > 0 && !requiredAny.some(c => selectedConditions.includes(c))) {
+    return false;
+  }
+
+  return true;
 }
 
 /**
@@ -279,8 +289,11 @@ export async function loadChainedPrompts(
     // Check both conditions AND tracks (both must pass)
     if (!meetsConditions(entry, selectedConditions)) {
       const pathStr = getPath(entry);
-      const conditions = isConditionalPath(entry) ? entry.conditions : [];
-      debug(`Skipped chained path: ${pathStr} (unmet conditions: ${conditions?.join(', ')})`);
+      const conditionsAll = isConditionalPath(entry) ? entry.conditions : [];
+      const conditionsAny = isConditionalPath(entry) ? entry.conditionsAny : [];
+      debug(
+        `Skipped chained path: ${pathStr} (unmet conditions: all=${conditionsAll?.join(', ') || 'n/a'}, any=${conditionsAny?.join(', ') || 'n/a'})`
+      );
       continue;
     }
 

src/shared/agents/config/types.ts

@@ -4,6 +4,7 @@
 export type ConditionalChainedPath = {
   path: string;
   conditions?: string[];
+  conditionsAny?: string[];
   tracks?: string[];
 };
 
@@ -20,6 +21,8 @@ export type AgentDefinition = {
   engine?: string; // Engine to use for this agent (dynamically determined from registry)
   chainedPromptsPath?: ChainedPathEntry | ChainedPathEntry[]; // Path(s) to folder(s) containing chained prompt .md files
   role?: 'controller'; // Agent role - 'controller' agents can drive autonomous mode
+  conditions?: string[];
+  conditionsAny?: string[];
   [key: string]: unknown;
 };
 

src/workflows/run.ts

@@ -209,14 +209,23 @@ export async function runWorkflow(options: RunWorkflowOptions = {}): Promise<voi
         idx, step.agentId, step.tracks, selectedTrack);
       return false;
     }
+    const selected = selectedConditions ?? [];
     if (step.conditions?.length) {
-      const missing = step.conditions.filter(c => !(selectedConditions ?? []).includes(c));
+      const missing = step.conditions.filter(c => !selected.includes(c));
       if (missing.length > 0) {
         debug('[Workflow] Step %d: agentId=%s, conditions=%O, missing=%O → EXCLUDED (missing conditions)',
           idx, step.agentId, step.conditions, missing);
         return false;
       }
     }
+    if (step.conditionsAny?.length) {
+      const matched = step.conditionsAny.some(c => selected.includes(c));
+      if (!matched) {
+        debug('[Workflow] Step %d: agentId=%s, conditionsAny=%O → EXCLUDED (no match)',
+          idx, step.agentId, step.conditionsAny);
+        return false;
+      }
+    }
     debug('[Workflow] Step %d: agentId=%s → included', idx, step.agentId);
     return true;
   });

src/workflows/templates/types.ts

@@ -42,6 +42,7 @@ export interface ModuleStep {
   interactive?: boolean; // Controls waiting behavior: true=wait for input, false=auto-advance
   tracks?: string[]; // Track names this step belongs to (e.g., ['bmad', 'enterprise'])
   conditions?: string[]; // Conditions required for this step (e.g., ['has_ui', 'has_api'])
+  conditionsAny?: string[]; // OR conditions for this step (e.g., ['full-workflow', 'workflow-definition'])
 }
 
 export interface Separator {

src/workflows/utils/resolvers/module.ts

@@ -68,6 +68,7 @@ export function resolveModule(id: string, overrides: ModuleOverrides = {}): Work
     interactive: overrides.interactive,
     tracks: overrides.tracks ?? moduleEntry.tracks as string[] | undefined,
     conditions: overrides.conditions ?? moduleEntry.conditions as string[] | undefined,
+    conditionsAny: overrides.conditionsAny ?? moduleEntry.conditionsAny as string[] | undefined,
     module: {
       id: moduleEntry.id,
       behavior,

src/workflows/utils/resolvers/step.ts

@@ -33,5 +33,6 @@ export function resolveStep(id: string, overrides: StepOverrides = {}): Workflow
     interactive: overrides.interactive,
     tracks: overrides.tracks ?? agent.tracks as string[] | undefined,
     conditions: overrides.conditions ?? agent.conditions as string[] | undefined,
+    conditionsAny: overrides.conditionsAny ?? agent.conditionsAny as string[] | undefined,
   };
 }

src/workflows/utils/types.ts

@@ -8,6 +8,7 @@ export interface StepOverrides {
   interactive?: boolean; // Controls waiting behavior: true=wait for input, false=auto-advance
   tracks?: string[]; // Track names this step belongs to (e.g., ['bmad', 'enterprise'])
   conditions?: string[]; // Conditions required for this step (e.g., ['has_ui', 'has_api'])
+  conditionsAny?: string[]; // OR conditions for this step (e.g., ['full-workflow', 'workflow-definition'])
 }
 
 export interface WorkflowStep {
@@ -23,6 +24,7 @@ export interface WorkflowStep {
   interactive?: boolean; // Controls waiting behavior: true=wait for input, false=auto-advance
   tracks?: string[]; // Track names this step belongs to (e.g., ['bmad', 'enterprise'])
   conditions?: string[]; // Conditions required for this step (e.g., ['has_ui', 'has_api'])
+  conditionsAny?: string[]; // OR conditions for this step (e.g., ['full-workflow', 'workflow-definition'])
 }
 
 export interface LoopBehaviorConfig {