@hyperdrive.bot/bmad-workflow 1.0.17 → 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,8 +21,8 @@ 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 { createSpinner } from '../../utils/progress.js';
 import { runAgentWithRetry } from '../../utils/retry.js';
 /**
  * Stories QA Command
@@ -85,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({
@@ -127,11 +129,10 @@ export default class StoriesQaCommand extends Command {
             // Match story files using glob pattern
             const storyFiles = await this.matchStoryFiles(args.pattern);
             if (storyFiles.length === 0) {
-                this.log(colors.warning(`No story files matched pattern: ${args.pattern}`));
+                this.logger.info({ pattern: args.pattern }, 'No story files matched pattern');
                 return;
             }
-            this.log(colors.info(`Found ${storyFiles.length} story file(s) to QA`));
-            this.log('');
+            this.logger.info({ count: storyFiles.length }, 'Found story file(s) to QA');
             // Process stories sequentially
             const results = await this.qaStoriesSequentially(storyFiles, flags);
             // Display summary report
@@ -245,13 +246,8 @@ ${result.finalGate === 'PASS' ? '3. [x] Final QA Validation - PASSED' : result.f
      * Display countdown timer between stories
      */
     async displayCountdown(intervalSeconds) {
-        /* eslint-disable no-await-in-loop */
-        for (let remaining = intervalSeconds; remaining > 0; remaining--) {
-            process.stdout.write(`\r${colors.warning(`⏳ Next story in ${remaining}s...`)}`);
-            await this.sleep(1000);
-        }
-        /* eslint-enable no-await-in-loop */
-        process.stdout.write('\r' + ' '.repeat(40) + '\r'); // Clear countdown line
+        this.logger.info({ seconds: intervalSeconds }, 'Waiting before next story');
+        await this.sleep(intervalSeconds * 1000);
     }
     /**
      * Display summary report
@@ -264,45 +260,22 @@ ${result.finalGate === 'PASS' ? '3. [x] Final QA Validation - PASSED' : result.f
         const errorCount = results.filter((r) => !r.success).length;
         const movedToDone = results.filter((r) => r.movedTo === 'done').length;
         const movedBack = results.filter((r) => r.movedTo === 'stories').length;
-        // Box drawing
-        const boxTop = '┌─────────────────────────────────────────┐';
-        const boxDivider = '├─────────────────────────────────────────┤';
-        const boxBottom = '└─────────────────────────────────────────┘';
-        this.log('');
-        this.log(boxTop);
-        this.log('│         Story QA Summary                │');
-        this.log(boxDivider);
-        this.log(`│ ${colors.success('PASS:')}            ${passCount.toString().padEnd(20)}│`);
-        if (concernsCount > 0) {
-            this.log(`│ ${colors.warning('CONCERNS:')}        ${concernsCount.toString().padEnd(20)}│`);
-        }
-        if (failCount > 0) {
-            this.log(`│ ${colors.error('FAIL:')}            ${failCount.toString().padEnd(20)}│`);
-        }
-        if (waivedCount > 0) {
-            this.log(`│ WAIVED:           ${waivedCount.toString().padEnd(20)}│`);
-        }
-        if (errorCount > 0) {
-            this.log(`│ ${colors.error('Errors:')}          ${errorCount.toString().padEnd(20)}│`);
-        }
-        this.log(boxDivider);
-        this.log(`│ Moved to Done:    ${movedToDone.toString().padEnd(20)}│`);
-        this.log(`│ Returned to Dev:  ${movedBack.toString().padEnd(20)}│`);
-        this.log(boxDivider);
-        this.log(`│ Duration:         ${(duration / 1000).toFixed(2)}s${' '.repeat(15)}│`);
-        this.log(boxBottom);
-        // List details for non-PASS stories
         const nonPassStories = results.filter((r) => r.finalGate !== 'PASS' || !r.success);
-        if (nonPassStories.length > 0) {
-            this.log('');
-            this.log(colors.bold('Stories Requiring Attention:'));
-            for (const result of nonPassStories) {
-                const status = result.success ? result.finalGate : 'ERROR';
-                const statusColor = status === 'CONCERNS' ? colors.warning : colors.error;
-                this.log(statusColor(`  ${status}: ${result.storyNumber} - ${path.basename(result.storyPath)}${result.error ? ` (${result.error})` : ''}`));
-            }
-        }
-        this.log('');
+        this.logger.info({
+            concerns: concernsCount,
+            durationSec: (duration / 1000).toFixed(2),
+            errors: errorCount,
+            fail: failCount,
+            movedBack,
+            movedToDone,
+            nonPass: nonPassStories.map((r) => ({
+                error: r.error,
+                gate: r.success ? r.finalGate : 'ERROR',
+                story: r.storyNumber,
+            })),
+            pass: passCount,
+            waived: waivedCount,
+        }, 'Story QA Summary');
     }
     /**
      * Extract gate status from story content or gate file
@@ -393,19 +366,16 @@ ${result.finalGate === 'PASS' ? '3. [x] Final QA Validation - PASSED' : result.f
         for (let index = 0; index < storyFiles.length; index++) {
             const storyPath = storyFiles[index];
             const storyNum = index + 1;
-            this.log(colors.bold(`\n[${storyNum}/${total}] QA: ${path.basename(storyPath)}`));
+            this.logger.info({ storyNum, total, story: path.basename(storyPath) }, 'QA starting');
             // Parse story metadata
-            const spinner = createSpinner('Parsing story metadata...');
-            spinner.start();
             let storyMetadata;
             try {
                 storyMetadata = await this.storyParserFactory.parseStory(storyPath);
-                const storyId = storyMetadata.id;
-                spinner.succeed(colors.success(`Story ${storyId}: ${storyMetadata.title}`));
+                this.logger.info({ storyId: storyMetadata.id, title: storyMetadata.title }, 'Parsed story');
             }
             catch (error) {
                 const err = error;
-                spinner.fail(colors.error(`Failed to parse story: ${err.message}`));
+                this.logger.error({ error: err.message, storyPath }, 'Failed to parse story');
                 results.push({
                     error: `Parse error: ${err.message}`,
                     finalGate: 'UNKNOWN',
@@ -425,19 +395,8 @@ ${result.finalGate === 'PASS' ? '3. [x] Final QA Validation - PASSED' : result.f
                 reference: flags.reference,
             });
             results.push(result);
-            // Display result
-            if (result.finalGate === 'PASS') {
-                this.log(colors.success(`  ✓ PASSED - Moved to done`));
-            }
-            else if (result.finalGate === 'WAIVED') {
-                this.log(colors.warning(`  ⚠ WAIVED - Moved to done`));
-            }
-            else if (result.success) {
-                this.log(colors.warning(`  ⚠ ${result.finalGate} - Returned for rework`));
-            }
-            else {
-                this.log(colors.error(`  ✗ Error: ${result.error}`));
-            }
+            // Log result
+            this.logger.info({ gate: result.finalGate, movedTo: result.movedTo, story: path.basename(storyPath), success: result.success }, result.success ? `QA ${result.finalGate}` : `QA error: ${result.error}`);
             // Display countdown timer before next story (except for last story)
             if (index < storyFiles.length - 1) {
                 await this.displayCountdown(flags.interval);
@@ -456,7 +415,7 @@ ${result.finalGate === 'PASS' ? '3. [x] Final QA Validation - PASSED' : result.f
         this.logger.info({ storyNumber, storyPath }, 'Starting story QA workflow');
         try {
             // Phase 1: Initial QA Deep Dive
-            this.log(colors.info('  Phase 1: QA Deep Dive Review...'));
+            this.logger.info('Phase 1: QA Deep Dive Review');
             const agentTimeout = flags.timeout ?? 2_700_000;
             const agentRetries = flags['agent-retries'];
             const retryBackoff = flags['retry-backoff'];
@@ -475,11 +434,11 @@ ${result.finalGate === 'PASS' ? '3. [x] Final QA Validation - PASSED' : result.f
             // Read story to get gate status
             let storyContent = await this.fileManager.readFile(storyPath);
             currentGate = this.extractGateStatus(storyContent);
-            this.log(colors.info(`  Initial Gate: ${currentGate}`));
+            this.logger.info({ gate: currentGate }, 'Initial gate result');
             // Phase 2: Dev Fix-Forward Loop (if needed and retries allowed)
             while ((currentGate === 'CONCERNS' || currentGate === 'FAIL') && retriesUsed < flags['max-retries']) {
                 retriesUsed++;
-                this.log(colors.warning(`  Phase 2: Dev Fix-Forward (Retry ${retriesUsed}/${flags['max-retries']})...`));
+                this.logger.info({ retry: retriesUsed, maxRetries: flags['max-retries'] }, 'Phase 2: Dev Fix-Forward');
                 // Run Dev agent to fix issues (sequential retry loop by design)
                 const devPrompt = this.buildDevFixPrompt(storyPath, flags['dev-prompt'], flags.reference);
                 // eslint-disable-next-line no-await-in-loop
@@ -496,7 +455,7 @@ ${result.finalGate === 'PASS' ? '3. [x] Final QA Validation - PASSED' : result.f
                     // Continue anyway - QA will re-evaluate
                 }
                 // Phase 3: Re-run QA to validate fixes
-                this.log(colors.info(`  Phase 3: QA Re-validation (Retry ${retriesUsed})...`));
+                this.logger.info({ retry: retriesUsed }, 'Phase 3: QA Re-validation');
                 // eslint-disable-next-line no-await-in-loop
                 const reQaResult = await runAgentWithRetry(this.agentRunner, qaPrompt, {
                     agentType: 'tea',
@@ -513,7 +472,7 @@ ${result.finalGate === 'PASS' ? '3. [x] Final QA Validation - PASSED' : result.f
                 // eslint-disable-next-line no-await-in-loop
                 storyContent = await this.fileManager.readFile(storyPath);
                 currentGate = this.extractGateStatus(storyContent);
-                this.log(colors.info(`  Gate after retry ${retriesUsed}: ${currentGate}`));
+                this.logger.info({ gate: currentGate, retry: retriesUsed }, 'Gate after retry');
             }
             // Append QA workflow summary to story
             const result = {

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;
+}