@hyperdrive.bot/bmad-workflow 1.0.17 → 1.0.19

package/dist/models/workflow-config.d.ts

@@ -1,3 +1,4 @@
+import type { Severity } from '../services/review/types.js';
 /**
  * Configuration for workflow execution across all phases
  *
@@ -77,6 +78,31 @@ export interface WorkflowConfig {
      * - OpenCode: anthropic/claude-3-5-sonnet, openai/gpt-4o
      */
     model?: string;
+    /**
+     * Enable MCP tool discovery in agent prompts
+     *
+     * When true, MCP context (available tools/instructions) is prepended to
+     * agent prompts before each spawn. Requires McpContextInjector to be
+     * configured in the orchestrator.
+     * @default false
+     */
+    mcp?: boolean;
+    /**
+     * Restrict MCP injection to specific workflow phases
+     *
+     * When set, only the listed phases receive MCP tool context.
+     * When omitted (and mcp=true), all phases receive MCP context.
+     * @example ['epic', 'dev'] — only epic and dev phases get MCP tools
+     */
+    mcpPhases?: string[];
+    /**
+     * MCP preset name for tool configuration
+     *
+     * Overrides the configured preset for the pipeline run.
+     * Presets define which MCP servers and tools are available.
+     * @example 'research'
+     */
+    mcpPreset?: string;
     /**
      * Filename prefix for generated files
      *
@@ -90,6 +116,37 @@ export interface WorkflowConfig {
      * @default 'claude'
      */
     provider?: 'claude' | 'gemini' | 'opencode';
+    /**
+     * Run automated code review between dev and QA phases
+     *
+     * When true, completed stories are reviewed before forwarding to QA.
+     * In pipeline mode, review runs concurrently via ReviewQueue.
+     * Only PASS stories proceed to QA; FAIL stories are excluded with a warning.
+     * @default false
+     */
+    review?: boolean;
+    /**
+     * Minimum severity that blocks the pipeline during review
+     *
+     * Issues at or above this severity after self-heal will cause a FAIL verdict.
+     * @default Severity.HIGH
+     */
+    reviewBlockOn?: Severity;
+    /**
+     * Maximum self-heal iterations during review
+     *
+     * Controls how many scan→fix cycles the review phase attempts before
+     * giving up on blocking issues.
+     * @default 3
+     */
+    reviewMaxFix?: number;
+    /**
+     * List of scanner IDs to enable during review
+     *
+     * When specified, only these scanners are used (e.g., ['lint', 'ai']).
+     * When omitted, all configured scanners run.
+     */
+    reviewScanners?: string[];
     /**
      * Run QA workflow after development completes
      *
@@ -119,6 +176,13 @@ export interface WorkflowConfig {
      * @example ['docs/architecture.md', 'docs/tech-stack.md']
      */
     references: string[];
+    /**
+     * Absolute path to the workflow session directory
+     *
+     * When set, session-level reports (review summary, tech debt backlog)
+     * are written to this directory. When undefined, session reports are skipped.
+     */
+    sessionDir?: string;
     /**
      * Skip development phase
      *
@@ -147,8 +211,21 @@ export interface WorkflowConfig {
      * @default 60
      */
     storyInterval: number;
+    /**
+     * AI review scanner timeout in milliseconds
+     *
+     * Overrides the global timeout for the AI review phase only.
+     * When not set, falls back to the global timeout or the default (5 minutes).
+     * Accepts human-readable durations via CLI (e.g., "10m", "1h").
+     * @default 300_000 (5 minutes)
+     */
+    reviewTimeout?: number;
     /**
      * Agent execution timeout in milliseconds
+     *
+     * Global timeout ceiling for all agent spawns, review scanners, and
+     * infrastructure operations. Accepts human-readable durations via CLI
+     * (e.g., "45m", "1h", "90m").
      * @default 2_700_000 (45 minutes)
      */
     timeout?: number;

package/dist/models/workflow-result.d.ts

@@ -141,6 +141,13 @@ export interface WorkflowResult {
      * Undefined if QA phase was skipped or not executed.
      */
     qaPhase?: PhaseResult;
+    /**
+     * Review phase result
+     *
+     * Undefined if review phase was skipped or not executed.
+     * Present when config.review === true.
+     */
+    reviewPhase?: PhaseResult;
     /**
      * Story creation phase result
      *

package/dist/services/WorkflowReporter.d.ts

@@ -0,0 +1,165 @@
+/**
+ * WorkflowReporter
+ *
+ * Real-time progress visualization for multi-layer parallel workflow execution
+ * using listr2. Implements the WorkflowCallbacks interface to observe workflow
+ * lifecycle events without coupling to orchestration internals.
+ *
+ * Features:
+ * - Top-level phase task groups with emoji-annotated titles
+ * - Nested concurrent task groups for parallel spawn layers
+ * - Live status updates for spawn transitions (queued → running → completed/failed)
+ * - Collapsible layer summaries on completion
+ */
+import type { WorkflowCallbacks } from '../models/workflow-callbacks.js';
+/**
+ * Configuration options for WorkflowReporter
+ */
+export interface WorkflowReporterOptions {
+    /**
+     * Maximum terminal width for output formatting (default: 80)
+     */
+    maxWidth?: number;
+    /**
+     * Disable color output
+     */
+    noColor?: boolean;
+    /**
+     * Force non-TTY mode (use simple renderer)
+     * When true or when process.stdout.isTTY is false, disables spinners
+     * and uses plain-text output without ANSI escape codes
+     */
+    nonTTY?: boolean;
+    /**
+     * Enable verbose output mode (show spawn output inline in real-time)
+     * When enabled, spawn outputs are streamed with visual delimiters
+     */
+    verbose?: boolean;
+}
+/**
+ * Summary data for the final dashboard display
+ */
+export interface DashboardSummary {
+    /** Number of failed spawns */
+    failedCount: number;
+    /** Number of successful spawns */
+    passedCount: number;
+    /** Per-phase breakdown */
+    phases: Array<{
+        duration: number;
+        failed: number;
+        name: string;
+        passed: number;
+    }>;
+    /** Absolute path to the session report file */
+    sessionReportPath?: string;
+    /** Total duration in milliseconds */
+    totalDuration: number;
+    /** Total number of spawns across all phases */
+    totalSpawns: number;
+}
+/**
+ * WorkflowReporter provides real-time structured progress visualization
+ * of multi-layer parallel execution using listr2.
+ *
+ * Usage:
+ * ```typescript
+ * const reporter = new WorkflowReporter({ verbose: false })
+ * orchestrator.setCallbacks(reporter.getCallbacks())
+ * // ... workflow execution ...
+ * reporter.dispose()
+ * ```
+ */
+export declare class WorkflowReporter {
+    private currentPhaseIndex;
+    private currentPhaseName;
+    private disposed;
+    private readonly options;
+    private phaseOrder;
+    private phases;
+    private listrInstance;
+    private listrPromise;
+    private phaseTransitionChain;
+    private phaseTaskResolver;
+    private phaseTaskOutput;
+    private phaseTaskTitle;
+    private currentTaskPhase;
+    private pendingTitle;
+    private pendingOutput;
+    private tickerInterval;
+    private tickerFrame;
+    private static readonly SPINNER_FRAMES;
+    constructor(options?: WorkflowReporterOptions);
+    /**
+     * Display final boxed dashboard with workflow summary (AC: #4)
+     */
+    displayFinalDashboard(summary: DashboardSummary): void;
+    /**
+     * Dispose of resources and clean up listr2 instance
+     */
+    dispose(): void;
+    /**
+     * Get the workflow callbacks interface for registering with orchestrator
+     */
+    getCallbacks(): WorkflowCallbacks;
+    /**
+     * Get the configured max width for output formatting
+     */
+    getMaxWidth(): number;
+    /**
+     * Check if reporter has been disposed
+     */
+    isDisposed(): boolean;
+    /**
+     * Check if reporter is in TTY mode
+     */
+    isTTYMode(): boolean;
+    /**
+     * Check if reporter is in verbose mode
+     */
+    isVerboseMode(): boolean;
+    /**
+     * Wait for all listr2 tasks to complete (called after orchestrator finishes)
+     */
+    waitForCompletion(): Promise<void>;
+    /**
+     * Clean up the current listr2 instance — resolve pending tasks and wait for
+     * the renderer to finish so the next phase gets a clean terminal.
+     */
+    private cleanupCurrentListr;
+    /**
+     * Create a new listr2 instance for a phase. The phase gets a single top-level
+     * task with a spinner. Spawn progress is piped as task output (shown below the
+     * spinner line). The task resolves when handlePhaseComplete fires.
+     *
+     * Phase transitions are chained: old instance is fully cleaned up before the
+     * new one starts rendering, preventing two renderers fighting over stdout.
+     */
+    private createPhaseListr;
+    /**
+     * Display a phase banner. In verbose mode, shows a full formatBox banner.
+     * In non-verbose TTY mode, the listr2 spinner is the only display (no banner).
+     * In non-TTY mode, shows a plain-text header.
+     */
+    private displayPhaseBanner;
+    private displayPlainTextDashboard;
+    private displayRichDashboard;
+    private handlePhaseStart;
+    private handlePhaseComplete;
+    private handleLayerStart;
+    private handleLayerComplete;
+    private handleSpawnStart;
+    /**
+     * Live-tick the phase title — rotates through running spawns with elapsed time.
+     * Called every 2s by the ticker interval AND once immediately on spawn start.
+     */
+    private stopTicker;
+    /**
+     * Build and render all spawn lines with per-item spinners + elapsed time.
+     * Called every second by the ticker interval AND once on spawn start/complete.
+     */
+    private tickSpawns;
+    private handleSpawnComplete;
+    private handleSpawnOutput;
+    private handleError;
+}