@hyperdrive.bot/bmad-workflow 1.0.18 → 1.0.19

package/dist/commands/mcp/status.js

@@ -0,0 +1,180 @@
+/**
+ * MCP Status Command
+ *
+ * Displays a structured dashboard showing gateway health, per-server health
+ * with latency, credential status, and current active preset name.
+ */
+import { Command } from '@oclif/core';
+import chalk from 'chalk';
+import { DEFAULT_GATEWAY_URL, formatDockerError, isDockerAvailable } from '../../mcp/utils/docker-utils.js';
+import { createLogger } from '../../utils/logger.js';
+const logger = createLogger({ namespace: 'commands:mcp:status' });
+/**
+ * Format latency for display
+ */
+function formatLatency(ms) {
+    if (ms === null)
+        return '—';
+    if (ms >= 1000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    return `${ms}ms`;
+}
+/**
+ * Format health status with icon
+ */
+function formatStatus(status) {
+    switch (status) {
+        case 'disabled': {
+            return chalk.gray('✗ disabled');
+        }
+        case 'healthy': {
+            return chalk.green('✓ healthy');
+        }
+        case 'offline': {
+            return chalk.red('✗ offline');
+        }
+        case 'unhealthy': {
+            return chalk.yellow('! unhealthy');
+        }
+        default: {
+            return chalk.dim(status);
+        }
+    }
+}
+/**
+ * Render the status dashboard to the terminal
+ */
+function renderDashboard(healthReport, presetName, credentials) {
+    const lines = [];
+    // Header
+    lines.push(chalk.bold('MCP Gateway Status'));
+    lines.push(chalk.dim('=================='));
+    // Gateway line
+    const gwStatus = formatStatus(healthReport.gateway.status);
+    const gwLatency = formatLatency(healthReport.gateway.latency);
+    const gwLine = healthReport.gateway.latency !== null
+        ? `${gwStatus}    (${gwLatency})`
+        : gwStatus;
+    lines.push(`Gateway:     ${healthReport.gateway.url}  ${gwLine}`);
+    lines.push(`Preset:      ${presetName}`);
+    // Servers section
+    lines.push('');
+    lines.push(chalk.bold('Servers:'));
+    if (healthReport.servers.length === 0) {
+        lines.push(chalk.dim('  No servers configured'));
+    }
+    else {
+        // Calculate column widths for alignment
+        const maxNameLen = Math.max(...healthReport.servers.map((s) => s.name.length));
+        for (const server of healthReport.servers) {
+            const name = server.name.padEnd(maxNameLen);
+            const status = formatStatus(server.status);
+            const latency = server.status === 'disabled' ? '—' : formatLatency(server.latency);
+            const padLatency = `(${latency})`.padEnd(10);
+            const useCase = server.useCase || '';
+            lines.push(`  ${name}  ${status}  ${padLatency}  ${useCase}`);
+        }
+    }
+    // Credentials section
+    if (credentials.length > 0) {
+        lines.push('');
+        lines.push(chalk.bold('Credentials:'));
+        const maxKeyLen = Math.max(...credentials.map((c) => c.key.length));
+        for (const cred of credentials) {
+            const key = cred.key.padEnd(maxKeyLen);
+            if (cred.configured) {
+                lines.push(`  ${key}  ${chalk.green('✓ configured')}`);
+            }
+            else if (!cred.requiredByPreset) {
+                lines.push(`  ${key}  ${chalk.dim('— not set (not needed for current preset)')}`);
+            }
+            else {
+                lines.push(`  ${key}  ${chalk.yellow('✗ not set')}`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+export default class McpStatus extends Command {
+    static description = 'Display MCP gateway status dashboard with server health and credentials';
+    static examples = [
+        '<%= config.bin %> mcp status',
+    ];
+    async run() {
+        logger.info('Checking MCP gateway status');
+        // 1. Check Docker availability
+        const dockerCheck = isDockerAvailable();
+        if (!dockerCheck.available) {
+            this.error(formatDockerError(dockerCheck), { exit: 1 });
+            return;
+        }
+        // 2. Gather status data
+        // NOTE: McpHealthChecker, McpConfigManager, and McpCredentialManager
+        // are provided by Epic 1 / Story 2.4. Until those are implemented,
+        // we fall back to a direct health check and sensible defaults.
+        const healthReport = await this.getHealthReport();
+        const presetName = this.getPresetName();
+        const credentials = this.getCredentials();
+        // 3. Render dashboard
+        const dashboard = renderDashboard(healthReport, presetName, credentials);
+        this.log(dashboard);
+    }
+    /**
+     * Get credentials status — delegates to McpCredentialManager when available
+     */
+    getCredentials() {
+        try {
+            // TODO: Replace with McpCredentialManager.list() when Epic 1 is complete
+            return [];
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Gather health report — delegates to McpHealthChecker when available
+     */
+    async getHealthReport() {
+        // TODO: Replace with McpHealthChecker.checkAll() when Story 2.4 is complete
+        // For now, do a simple gateway health check
+        const gatewayUrl = DEFAULT_GATEWAY_URL;
+        const healthUrl = `${gatewayUrl}/health`;
+        try {
+            const start = Date.now();
+            const response = await fetch(healthUrl, { signal: AbortSignal.timeout(5000) });
+            const latency = Date.now() - start;
+            return {
+                gateway: {
+                    latency,
+                    status: response.ok ? 'healthy' : 'unhealthy',
+                    url: gatewayUrl,
+                },
+                servers: [],
+            };
+        }
+        catch {
+            return {
+                gateway: {
+                    latency: null,
+                    status: 'offline',
+                    url: gatewayUrl,
+                },
+                servers: [],
+            };
+        }
+    }
+    /**
+     * Get current preset name — delegates to McpConfigManager when available
+     */
+    getPresetName() {
+        try {
+            // TODO: Replace with McpConfigManager.getPresetName() when Epic 1 is complete
+            return 'unknown';
+        }
+        catch {
+            return 'unknown';
+        }
+    }
+}
+// Export the render function for testing
+export { renderDashboard };

package/dist/commands/mcp/stop.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MCP Stop Command
+ *
+ * Shuts down the Docker MCP gateway via docker compose down
+ * and confirms shutdown to the user.
+ */
+import { Command } from '@oclif/core';
+export default class McpStop extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/mcp/stop.js

@@ -0,0 +1,47 @@
+/**
+ * MCP Stop Command
+ *
+ * Shuts down the Docker MCP gateway via docker compose down
+ * and confirms shutdown to the user.
+ */
+import { execSync } from 'node:child_process';
+import { Command } from '@oclif/core';
+import chalk from 'chalk';
+import { dockerComposeFileExists, formatDockerError, getDockerComposeFilePath, isDockerAvailable, } from '../../mcp/utils/docker-utils.js';
+import { createLogger } from '../../utils/logger.js';
+const logger = createLogger({ namespace: 'commands:mcp:stop' });
+export default class McpStop extends Command {
+    static description = 'Stop the Docker MCP gateway';
+    static examples = [
+        '<%= config.bin %> mcp stop',
+    ];
+    async run() {
+        logger.info('Stopping MCP gateway');
+        // 1. Check Docker availability
+        const dockerCheck = isDockerAvailable();
+        if (!dockerCheck.available) {
+            this.error(formatDockerError(dockerCheck), { exit: 1 });
+            return;
+        }
+        // 2. Verify compose file exists
+        const composePath = getDockerComposeFilePath();
+        if (!dockerComposeFileExists()) {
+            this.error(`Docker Compose file not found at: ${composePath}\nNothing to stop — the gateway has not been initialized.`, { exit: 1 });
+            return;
+        }
+        // 3. Shut down gateway
+        this.log(chalk.dim('Stopping MCP gateway containers...'));
+        try {
+            execSync(`docker compose -f "${composePath}" down`, { stdio: 'pipe', timeout: 60_000 });
+            this.log('');
+            this.log(chalk.green.bold('✓ MCP Gateway stopped successfully'));
+            logger.info('Gateway stopped');
+        }
+        catch (error) {
+            const err = error;
+            const stderr = err.stderr ? err.stderr.toString() : err.message;
+            logger.error('Failed to stop gateway: %s', stderr);
+            this.error(`Failed to stop MCP gateway:\n${stderr}`, { exit: 1 });
+        }
+    }
+}

package/dist/commands/stories/create.d.ts

@@ -39,6 +39,7 @@ export default class StoriesCreateCommand extends Command {
         provider: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         task: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'review-timeout': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'max-retries': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         'retry-backoff': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
     };

package/dist/commands/stories/develop.d.ts

@@ -41,6 +41,7 @@ export default class StoriesDevelopCommand extends Command {
         provider: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         task: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'review-timeout': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'max-retries': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         'retry-backoff': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
     };

package/dist/commands/stories/qa.js

@@ -21,6 +21,7 @@ import { GlobMatcher } from '../../services/file-system/glob-matcher.js';
 import { PathResolver } from '../../services/file-system/path-resolver.js';
 import { StoryParserFactory } from '../../services/parsers/story-parser-factory.js';
 import * as colors from '../../utils/colors.js';
+import { parseDuration } from '../../utils/duration.js';
 import { createLogger, generateCorrelationId } from '../../utils/logger.js';
 import { runAgentWithRetry } from '../../utils/retry.js';
 /**
@@ -84,9 +85,11 @@ export default class StoriesQaCommand extends Command {
             description: 'Additional context files for agents',
             multiple: true,
         }),
-        timeout: Flags.integer({
+        timeout: Flags.custom({
+            parse: async (input) => parseDuration(input),
+        })({
             default: 2_700_000,
-            description: 'Agent execution timeout in milliseconds (default: 2700000 = 45 minutes)',
+            description: 'Agent execution timeout — accepts durations like 30s, 5m, 1h, 90m, or raw milliseconds (default: 45m)',
             helpGroup: 'Resilience',
         }),
         'agent-retries': Flags.integer({

package/dist/commands/stories/review.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Stories Review Command
+ *
+ * Standalone command that discovers and reviews existing story files outside
+ * the full workflow pipeline. Runs automated code review (scanners + self-heal)
+ * on matched stories and produces PASS/FAIL verdicts.
+ *
+ * @example
+ * ```bash
+ * bmad-workflow stories review "docs/qa/stories/AUTH-*.md"
+ * bmad-workflow stories review "stories/*.md" --scanners ai,lint --dry-run
+ * bmad-workflow stories review "stories/*.md" --json
+ * bmad-workflow stories review "stories/*.md" --block-on CRITICAL --max-fix 5
+ * ```
+ */
+import { Command } from '@oclif/core';
+import { Severity } from '../../services/review/types.js';
+/**
+ * Parse and validate --scanners flag value
+ *
+ * @param value - Comma-separated scanner names
+ * @returns Array of valid scanner names
+ * @throws Error if any scanner name is invalid
+ */
+export declare function parseScanners(value: string): string[];
+/**
+ * Parse and validate --block-on flag value
+ *
+ * @param value - Comma-separated severity names
+ * @returns Array of valid severity strings
+ * @throws Error if any severity is invalid
+ */
+export declare function parseBlockOn(value: string): Severity;
+/**
+ * Validate --max-fix is a positive integer
+ *
+ * @param value - Value to validate
+ * @returns The validated integer
+ * @throws Error if value is not a positive integer
+ */
+export declare function validateMaxFix(value: number): number;
+/**
+ * Stories Review Command
+ *
+ * Discovers story files via glob pattern and runs automated code review on each.
+ * Supports --dry-run (findings only, no fixes) and --json (structured CI output).
+ */
+export default class StoriesReviewCommand extends Command {
+    static args: {
+        pattern: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: {
+        command: string;
+        description: string;
+    }[];
+    static flags: {
+        'block-on': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'max-fix': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        scanners: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        agent: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        cwd: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        model: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        provider: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        task: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'review-timeout': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'max-retries': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'retry-backoff': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    private agentRunner;
+    private fileManager;
+    private globMatcher;
+    private logger;
+    private pathResolver;
+    private storyParserFactory;
+    /**
+     * Run the command
+     */
+    run(): Promise<void>;
+    /**
+     * Validate and parse all CLI flags into a typed config object
+     */
+    private validateFlags;
+    /**
+     * Discover story files matching the glob pattern
+     */
+    private discoverStories;
+    /**
+     * Review all discovered stories sequentially
+     */
+    private reviewStories;
+    /**
+     * Write review results to story files and session directory
+     */
+    private writeResults;
+    /**
+     * Output structured JSON to stdout (for --json mode)
+     */
+    private outputJson;
+    /**
+     * Display human-readable summary table
+     */
+    private displaySummary;
+    /**
+     * Initialize service dependencies
+     */
+    private initializeServices;
+    /**
+     * Extract story ID from file path
+     * e.g., "docs/stories/PROJ-story-1.001.md" → "PROJ-story-1.001"
+     */
+    private extractStoryId;
+    /**
+     * Group issues by severity level
+     */
+    private groupIssuesBySeverity;
+    /**
+     * Format duration in human-readable format
+     */
+    private formatDuration;
+}