@hyperdrive.bot/bmad-workflow 1.0.17 → 1.0.19

package/dist/services/orchestration/workflow-orchestrator.d.ts

@@ -44,7 +44,7 @@
  * ```
  */
 import type pino from 'pino';
-import type { InputDetectionResult, WorkflowConfig, WorkflowResult } from '../../models/index.js';
+import type { InputDetectionResult, WorkflowCallbacks, WorkflowConfig, WorkflowResult } from '../../models/index.js';
 import type { AIProviderRunner } from '../agents/agent-runner.js';
 import type { WorkflowLogger } from '../logging/workflow-logger.js';
 import { FileManager } from '../file-system/file-manager.js';
@@ -53,6 +53,8 @@ import { EpicParser } from '../parsers/epic-parser.js';
 import { PrdParser } from '../parsers/prd-parser.js';
 import { BatchProcessor } from './batch-processor.js';
 import { StoryTypeDetector } from './story-type-detector.js';
+import type { McpContextInjector } from '../mcp/mcp-context-injector.js';
+import type { ReviewPhaseExecutor } from '../review/review-phase-executor.js';
 /**
  * InputDetector interface (to be implemented in Story 4.2)
  *
@@ -87,14 +89,20 @@ export interface WorkflowOrchestratorConfig {
     inputDetector: InputDetector;
     /** Logger instance for structured logging */
     logger: pino.Logger;
+    /** Optional MCP context injector for tool discovery in agent prompts */
+    mcpContextInjector?: McpContextInjector;
     /** Service to resolve file paths from config */
     pathResolver: PathResolver;
     /** Service to parse PRD files and extract epics */
     prdParser: PrdParser;
+    /** Optional ReviewPhaseExecutor for automated code review */
+    reviewPhaseExecutor?: ReviewPhaseExecutor;
     /** Service to detect story type for auto-documentation */
     storyTypeDetector: StoryTypeDetector;
     /** Optional WorkflowLogger for pipeline progress tracking */
     workflowLogger?: WorkflowLogger;
+    /** Optional lifecycle event callbacks for workflow observability */
+    callbacks?: WorkflowCallbacks;
 }
 /**
  * Options for building an epic creation prompt
@@ -136,14 +144,17 @@ export interface StoryPromptOptions {
 export declare class WorkflowOrchestrator {
     private readonly agentRunner;
     private readonly batchProcessor;
+    private readonly callbacks?;
     private readonly epicParser;
     private readonly fileManager;
     private readonly fileScaffolder;
     private readonly inputDetector;
     private readonly logger;
+    private readonly mcpContextInjector?;
     private readonly pathResolver;
     private readonly prdFixer;
     private readonly prdParser;
+    private readonly reviewPhaseExecutor?;
     private readonly storyTypeDetector;
     private readonly workflowLogger?;
     /**
@@ -163,6 +174,20 @@ export declare class WorkflowOrchestrator {
      * @throws {ValidationError} If configuration is invalid
      */
     execute(config: WorkflowConfig): Promise<WorkflowResult>;
+    /**
+     * Get MCP prompt prefix for a given phase
+     *
+     * Returns MCP tool discovery instructions to prepend before agent prompts.
+     * Returns empty string when MCP is disabled, injector is unavailable,
+     * phase is filtered out, or injector returns empty/errors.
+     *
+     * @param phase - Workflow phase (epic, story, dev, review, qa)
+     * @param agentType - Agent type being spawned
+     * @param config - Workflow configuration
+     * @returns Instructions string to prepend, or empty string
+     * @private
+     */
+    private getMcpPromptPrefix;
     /**
      * Build prompt for epic creation
      *
@@ -202,6 +227,35 @@ export declare class WorkflowOrchestrator {
      * @private
      */
     private buildSuccessResult;
+    /**
+     * Invoke a callback safely, catching and logging any errors
+     *
+     * All callback invocations are wrapped in try-catch to prevent
+     * callback errors from interrupting workflow execution.
+     *
+     * @param callbackName - Name of the callback for logging
+     * @param callback - The callback function to invoke
+     * @param context - The context to pass to the callback
+     * @private
+     */
+    private invokeCallback;
+    /**
+     * Invoke the onSpawnOutput callback safely
+     *
+     * @param callback - The callback function to invoke
+     * @param context - The spawn context
+     * @param output - The output text
+     * @private
+     */
+    private invokeSpawnOutputCallback;
+    /**
+     * Invoke the onError callback safely
+     *
+     * @param error - The error that occurred
+     * @param options - Additional context for the error
+     * @private
+     */
+    private invokeErrorCallback;
     /**
      * Check which files already exist in a directory
      *
@@ -379,11 +433,41 @@ export declare class WorkflowOrchestrator {
      */
     private executePipelinedDevPhase;
     /**
-     * Execute pipelined workflow (story and dev phases in parallel)
+     * Review worker that consumes stories from the ReviewQueue and processes them.
+     *
+     * Worker loop:
+     * 1. Dequeue next story (blocks/waits if queue empty)
+     * 2. If null returned, queue is closed and empty → terminate worker
+     * 3. For each story, invoke ReviewPhaseExecutor.reviewStory()
+     * 4. Collect pass/fail results
+     *
+     * @param workerId - Worker identifier for logging
+     * @param reviewQueue - ReviewQueue to dequeue stories from
+     * @param config - Workflow configuration
+     * @returns Worker result with passed and failed story arrays
+     * @private
+     */
+    private reviewWorker;
+    /**
+     * Execute pipelined review phase with worker pool.
+     *
+     * @param reviewQueue - ReviewQueue to consume stories from
+     * @param config - Workflow configuration
+     * @returns PhaseResult with aggregate success/failure counts and passed stories
+     * @private
+     */
+    private executePipelinedReviewPhase;
+    /**
+     * Execute pipelined workflow (story, dev, and optionally review phases in parallel)
+     *
+     * When config.review === true && reviewPhaseExecutor is available:
+     *   [StoryQueue] → dev workers → [ReviewQueue] → review workers → QA collection
+     * When config.review === false (default):
+     *   [StoryQueue] → dev workers → QA collection (unchanged behavior)
      *
      * @param config - Workflow configuration
      * @param detection - Input detection result
-     * @returns Story and dev phase results
+     * @returns Story, dev, and optional review phase results
      * @private
      */
     private executePipelinedWorkflow;