@hyperdrive.bot/bmad-workflow 1.0.2

package/bin/dev

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import {execute} from '@oclif/core'
+
+await execute({development: true, dir: import.meta.url})

package/bin/dev.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node --loader ts-node/esm --no-warnings=ExperimentalWarning "%~dp0\dev" %*

package/bin/dev.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env -S node --loader ts-node/esm --disable-warning=ExperimentalWarning
+
+import {execute} from '@oclif/core'
+
+await execute({development: true, dir: import.meta.url})

package/bin/run

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import {execute} from '@oclif/core'
+
+await execute({dir: import.meta.url})

package/bin/run.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node "%~dp0\run" %*

package/bin/run.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import {execute} from '@oclif/core'
+
+await execute({dir: import.meta.url})

package/dist/commands/config/show.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Config Show Command
+ *
+ * Displays current BMAD configuration from .bmad-core/core-config.yaml
+ * Supports both human-readable YAML and machine-readable JSON output.
+ */
+import { Command } from '@oclif/core';
+/**
+ * Show Command - Displays current BMAD configuration
+ *
+ * Reads .bmad-core/core-config.yaml and displays its contents in either
+ * YAML format (default) or JSON format (with --json flag).
+ *
+ * @example
+ * // Display config in YAML format
+ * bmad-workflow config show
+ *
+ * // Display config as JSON
+ * bmad-workflow config show --json
+ */
+export default class Show extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    /**
+     * Execute the show command
+     *
+     * Loads configuration file, parses YAML, and displays in requested format.
+     * Handles missing file and parse errors gracefully with user-friendly messages.
+     */
+    run(): Promise<void>;
+}

package/dist/commands/config/show.js

@@ -0,0 +1,108 @@
+/**
+ * Config Show Command
+ *
+ * Displays current BMAD configuration from .bmad-core/core-config.yaml
+ * Supports both human-readable YAML and machine-readable JSON output.
+ */
+import { Command, Flags } from '@oclif/core';
+import { dump, load } from 'js-yaml';
+import { FileManager } from '../../services/file-system/file-manager.js';
+import * as colors from '../../utils/colors.js';
+import { ConfigurationError, FileSystemError } from '../../utils/errors.js';
+import { createLogger } from '../../utils/logger.js';
+const logger = createLogger({ namespace: 'commands:config:show' });
+/**
+ * Default path to configuration file relative to project root
+ */
+const CONFIG_FILE_PATH = '.bmad-core/core-config.yaml';
+/**
+ * Show Command - Displays current BMAD configuration
+ *
+ * Reads .bmad-core/core-config.yaml and displays its contents in either
+ * YAML format (default) or JSON format (with --json flag).
+ *
+ * @example
+ * // Display config in YAML format
+ * bmad-workflow config show
+ *
+ * // Display config as JSON
+ * bmad-workflow config show --json
+ */
+export default class Show extends Command {
+    static description = 'Display current BMAD configuration from .bmad-core/core-config.yaml';
+    static examples = ['<%= config.bin %> <%= command.id %>', '<%= config.bin %> <%= command.id %> --json'];
+    static flags = {
+        json: Flags.boolean({
+            default: false,
+            description: 'Output configuration as JSON instead of YAML',
+        }),
+    };
+    /**
+     * Execute the show command
+     *
+     * Loads configuration file, parses YAML, and displays in requested format.
+     * Handles missing file and parse errors gracefully with user-friendly messages.
+     */
+    async run() {
+        const { flags } = await this.parse(Show);
+        logger.info('Running config show command with flags: %O', flags);
+        // Initialize FileManager
+        const fileManager = new FileManager(logger);
+        try {
+            // Resolve config file path (relative to current working directory)
+            const configPath = `${process.cwd()}/${CONFIG_FILE_PATH}`;
+            logger.info('Loading configuration from: %s', configPath);
+            // Check if config file exists
+            const exists = await fileManager.fileExists(configPath);
+            if (!exists) {
+                const errorMsg = `Configuration file not found at '${CONFIG_FILE_PATH}'. Ensure you're running this command from the project root directory.`;
+                this.error(colors.error(errorMsg), { exit: 1 });
+                return;
+            }
+            // Read configuration file
+            const fileContent = await fileManager.readFile(configPath);
+            logger.debug('Configuration file read successfully');
+            // Parse YAML
+            let config;
+            try {
+                config = load(fileContent);
+                logger.debug('YAML parsed successfully');
+            }
+            catch (error) {
+                // YAML syntax error - extract line information if available
+                const yamlError = error;
+                const lineInfo = yamlError.mark ? ` at line ${yamlError.mark.line + 1}` : '';
+                const errorMsg = `Invalid YAML syntax in '${CONFIG_FILE_PATH}'${lineInfo}: ${yamlError.message}`;
+                this.error(colors.error(errorMsg), { exit: 1 });
+                return;
+            }
+            // Display configuration in requested format
+            if (flags.json) {
+                // JSON output - machine-readable
+                this.log(JSON.stringify(config, null, 2));
+            }
+            else {
+                // YAML output - human-readable with formatting
+                this.log(colors.bold('Configuration (.bmad-core/core-config.yaml):'));
+                this.log('');
+                this.log(dump(config, { indent: 2, lineWidth: 120 }));
+            }
+            logger.info('Configuration displayed successfully');
+        }
+        catch (error) {
+            // Handle FileSystemError and other unexpected errors
+            if (error instanceof FileSystemError) {
+                this.error(colors.error(error.message), { exit: 1 });
+                return;
+            }
+            if (error instanceof ConfigurationError) {
+                this.error(colors.error(error.message), { exit: 1 });
+                return;
+            }
+            // Unexpected error
+            const err = error;
+            logger.error('Unexpected error: %O', err);
+            this.error(colors.error(`Unexpected error: ${err.message}`), { exit: 1 });
+        }
+    }
+}

package/dist/commands/config/validate.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Config Validate Command
+ *
+ * Validates BMAD configuration from .bmad-core/core-config.yaml
+ * Reports specific validation errors with field names and expected types.
+ */
+import { Command } from '@oclif/core';
+/**
+ * Validate Command - Validates BMAD configuration
+ *
+ * Reads .bmad-core/core-config.yaml, validates structure and types,
+ * and reports any errors with specific field information.
+ * Exits with code 0 for valid configuration, 1 for invalid.
+ *
+ * @example
+ * // Validate configuration
+ * bmad-workflow config validate
+ */
+export default class Validate extends Command {
+    static description: string;
+    static examples: string[];
+    /**
+     * Execute the validate command
+     *
+     * Loads configuration file, parses YAML, validates structure,
+     * and reports validation status with detailed errors if invalid.
+     */
+    run(): Promise<void>;
+}

package/dist/commands/config/validate.js

@@ -0,0 +1,131 @@
+/**
+ * Config Validate Command
+ *
+ * Validates BMAD configuration from .bmad-core/core-config.yaml
+ * Reports specific validation errors with field names and expected types.
+ */
+import { Command } from '@oclif/core';
+import { load as yamlLoad } from 'js-yaml';
+import { FileManager } from '../../services/file-system/file-manager.js';
+import { ConfigValidator } from '../../services/validation/config-validator.js';
+import * as colors from '../../utils/colors.js';
+import { FileSystemError, ValidationError } from '../../utils/errors.js';
+import { createLogger } from '../../utils/logger.js';
+const logger = createLogger({ namespace: 'commands:config:validate' });
+/**
+ * Default path to configuration file relative to project root
+ */
+const CONFIG_FILE_PATH = '.bmad-core/core-config.yaml';
+/**
+ * Validate Command - Validates BMAD configuration
+ *
+ * Reads .bmad-core/core-config.yaml, validates structure and types,
+ * and reports any errors with specific field information.
+ * Exits with code 0 for valid configuration, 1 for invalid.
+ *
+ * @example
+ * // Validate configuration
+ * bmad-workflow config validate
+ */
+export default class Validate extends Command {
+    static description = 'Validate BMAD configuration from .bmad-core/core-config.yaml';
+    static examples = ['<%= config.bin %> <%= command.id %>'];
+    /**
+     * Execute the validate command
+     *
+     * Loads configuration file, parses YAML, validates structure,
+     * and reports validation status with detailed errors if invalid.
+     */
+    async run() {
+        logger.info('Running config validate command');
+        // Initialize services
+        const fileManager = new FileManager(logger);
+        const configValidator = new ConfigValidator(fileManager, logger);
+        try {
+            // Resolve config file path (relative to current working directory)
+            const configPath = `${process.cwd()}/${CONFIG_FILE_PATH}`;
+            logger.info('Loading configuration from: %s', configPath);
+            // Check if config file exists
+            const exists = await fileManager.fileExists(configPath);
+            if (!exists) {
+                const errorMsg = `Configuration file not found at '${CONFIG_FILE_PATH}'. Ensure you're running this command from the project root directory.`;
+                this.log(colors.error(errorMsg));
+                this.exit(1);
+                return;
+            }
+            // Read configuration file
+            const fileContent = await fileManager.readFile(configPath);
+            logger.debug('Configuration file read successfully');
+            // Parse YAML
+            let config;
+            try {
+                config = yamlLoad(fileContent);
+                logger.debug('YAML parsed successfully');
+            }
+            catch (error) {
+                // YAML syntax error - extract line information if available
+                const yamlError = error;
+                const lineInfo = yamlError.mark ? ` at line ${yamlError.mark.line + 1}` : '';
+                this.log(colors.error('Configuration validation failed:'));
+                this.log('');
+                this.log(`  ${colors.bold('YAML Syntax Error')}`);
+                this.log(`  Location: ${CONFIG_FILE_PATH}${lineInfo}`);
+                this.log(`  Error: ${yamlError.message}`);
+                if (yamlError.mark) {
+                    this.log('');
+                    this.log(`  Problematic line ${yamlError.mark.line + 1}:`);
+                    const lines = fileContent.split('\n');
+                    const problematicLine = lines[yamlError.mark.line];
+                    if (problematicLine !== undefined) {
+                        this.log(`    ${colors.dim(problematicLine)}`);
+                    }
+                }
+                this.exit(1);
+                return;
+            }
+            // Validate configuration against schema
+            try {
+                await configValidator.validate(config);
+                // Validation successful
+                this.log(colors.success('Configuration is valid'));
+                logger.info('Configuration validation successful');
+                this.exit(0);
+            }
+            catch (error) {
+                // Validation failed - display detailed error information
+                if (error instanceof ValidationError) {
+                    this.log(colors.error('Configuration validation failed:'));
+                    this.log('');
+                    // Parse error message to extract field and details
+                    const errorMsg = error.message;
+                    const context = error.context;
+                    if (context?.field) {
+                        this.log(`  ${colors.bold('Field:')} ${context.field}`);
+                    }
+                    this.log(`  ${colors.bold('Error:')} ${errorMsg}`);
+                    if (context?.received !== undefined) {
+                        this.log(`  ${colors.bold('Received:')} ${JSON.stringify(context.received)}`);
+                    }
+                    logger.error('Configuration validation failed: %s', errorMsg);
+                    this.exit(1);
+                    return;
+                }
+                // Re-throw unexpected errors
+                throw error;
+            }
+        }
+        catch (error) {
+            // Handle FileSystemError and other unexpected errors
+            if (error instanceof FileSystemError) {
+                this.log(colors.error(error.message));
+                this.exit(1);
+                return;
+            }
+            // Unexpected error
+            const err = error;
+            logger.error('Unexpected error: %O', err);
+            this.log(colors.error(`Unexpected error: ${err.message}`));
+            this.exit(1);
+        }
+    }
+}

package/dist/commands/decompose.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Decompose Command
+ *
+ * Decomposes large goals into executable task graphs with dependency management.
+ * Supports per-file task generation, parallel execution, and intelligent dependency resolution.
+ */
+import { Command } from '@oclif/core';
+/**
+ * Decompose Command
+ *
+ * Breaks down large goals into small, executable tasks with dependency management.
+ *
+ * @example
+ * ```bash
+ * # Decompose a goal with per-file mode
+ * bmad-cli decompose "Migrate project to TypeScript" --per-file --file-pattern "src/*.js"
+ *
+ * # Plan only without execution
+ * bmad-cli decompose "Add authentication" --plan-only
+ *
+ * # Execute with custom context
+ * bmad-cli decompose "Refactor API layer" --context package.json --context tsconfig.json --execute
+ * ```
+ */
+export default class Decompose extends Command {
+    static args: {
+        goal: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        agent: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        context: 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>;
+        execute: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'file-pattern': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'max-parallel': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'output-dir': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'per-file': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'plan-only': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        provider: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'story-format': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'story-prefix': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'task-timeout': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    private cancelled;
+    private fileManager;
+    private logger;
+    private scaffolder;
+    /**
+     * Main command execution
+     */
+    run(): Promise<void>;
+    /**
+     * Confirm execution with user
+     */
+    private confirmExecution;
+    /**
+     * Display execution results
+     */
+    private displayExecutionResults;
+    /**
+     * Display command header
+     */
+    private displayHeader;
+    /**
+     * Display task graph summary
+     */
+    private displayTaskGraphSummary;
+    /**
+     * Initialize services
+     */
+    private initializeServices;
+    /**
+     * Register signal handlers for graceful cancellation
+     */
+    private registerSignalHandlers;
+}