pnpm-catalog-updates 0.1.1

package/dist/cli/index.js

@@ -0,0 +1,244 @@
+#!/usr/bin/env node
+/**
+ * pnpm-catalog-updater CLI Entry Point
+ *
+ * A CLI tool for checking and updating pnpm workspace catalog dependencies.
+ * This is the main entry point that handles command parsing and execution.
+ */
+import chalk from 'chalk';
+import { Command } from 'commander';
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+// Services and Dependencies
+import { CatalogUpdateService } from '../application/services/CatalogUpdateService.js';
+import { WorkspaceService } from '../application/services/WorkspaceService.js';
+import { NpmRegistryService } from '../infrastructure/external-services/NpmRegistryService.js';
+import { FileSystemService } from '../infrastructure/file-system/FileSystemService.js';
+import { FileWorkspaceRepository } from '../infrastructure/repositories/FileWorkspaceRepository.js';
+// CLI Commands
+import { CheckCommand } from './commands/CheckCommand.js';
+import { UpdateCommand } from './commands/UpdateCommand.js';
+import { OutputFormatter } from './formatters/OutputFormatter.js';
+// Get package.json for version info
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(readFileSync(join(__dirname, '../../package.json'), 'utf-8'));
+/**
+ * Create service dependencies
+ */
+function createServices() {
+    const fileSystemService = new FileSystemService();
+    const workspaceRepository = new FileWorkspaceRepository(fileSystemService);
+    const registryService = new NpmRegistryService();
+    const catalogUpdateService = new CatalogUpdateService(workspaceRepository, registryService);
+    const workspaceService = new WorkspaceService(workspaceRepository);
+    return {
+        fileSystemService,
+        workspaceRepository,
+        registryService,
+        catalogUpdateService,
+        workspaceService,
+    };
+}
+/**
+ * Main CLI function
+ */
+export async function main() {
+    const program = new Command();
+    // Create services
+    const services = createServices();
+    // Configure the main command
+    program
+        .name('pcu')
+        .description('A CLI tool to check and update pnpm workspace catalog dependencies')
+        .version(packageJson.version)
+        .option('-v, --verbose', 'enable verbose logging')
+        .option('--workspace <path>', 'workspace directory path')
+        .option('--no-color', 'disable colored output');
+    // Check command
+    program
+        .command('check')
+        .description('check for outdated catalog dependencies')
+        .option('--catalog <name>', 'check specific catalog only')
+        .option('--format <type>', 'output format: table, json, yaml, minimal', 'table')
+        .option('--target <type>', 'update target: latest, greatest, minor, patch, newest', 'latest')
+        .option('--prerelease', 'include prerelease versions')
+        .option('--include <pattern>', 'include packages matching pattern', [])
+        .option('--exclude <pattern>', 'exclude packages matching pattern', [])
+        .action(async (options, command) => {
+        try {
+            const globalOptions = command.parent.opts();
+            const formatter = new OutputFormatter(options.format, !globalOptions.noColor);
+            const checkCommand = new CheckCommand(services.catalogUpdateService, formatter);
+            await checkCommand.execute({
+                workspace: globalOptions.workspace,
+                catalog: options.catalog,
+                format: options.format,
+                target: options.target,
+                prerelease: options.prerelease,
+                include: Array.isArray(options.include)
+                    ? options.include
+                    : [options.include].filter(Boolean),
+                exclude: Array.isArray(options.exclude)
+                    ? options.exclude
+                    : [options.exclude].filter(Boolean),
+                verbose: globalOptions.verbose,
+                color: !globalOptions.noColor,
+            });
+        }
+        catch (error) {
+            console.error(chalk.red('❌ Error:'), error);
+            process.exit(1);
+        }
+    });
+    // Update command
+    program
+        .command('update')
+        .description('update catalog dependencies')
+        .option('-i, --interactive', 'interactive mode to choose updates')
+        .option('-d, --dry-run', 'preview changes without writing files')
+        .option('--target <type>', 'update target: latest, greatest, minor, patch, newest', 'latest')
+        .option('--catalog <name>', 'update specific catalog only')
+        .option('--include <pattern>', 'include packages matching pattern', [])
+        .option('--exclude <pattern>', 'exclude packages matching pattern', [])
+        .option('--force', 'force updates even if risky')
+        .option('--prerelease', 'include prerelease versions')
+        .option('--create-backup', 'create backup files before updating')
+        .option('--format <type>', 'output format: table, json, yaml, minimal', 'table')
+        .action(async (options, command) => {
+        try {
+            const globalOptions = command.parent.opts();
+            const formatter = new OutputFormatter(options.format, !globalOptions.noColor);
+            const updateCommand = new UpdateCommand(services.catalogUpdateService, formatter);
+            await updateCommand.execute({
+                workspace: globalOptions.workspace,
+                catalog: options.catalog,
+                format: options.format,
+                target: options.target,
+                interactive: options.interactive,
+                dryRun: options.dryRun,
+                force: options.force,
+                prerelease: options.prerelease,
+                include: Array.isArray(options.include)
+                    ? options.include
+                    : [options.include].filter(Boolean),
+                exclude: Array.isArray(options.exclude)
+                    ? options.exclude
+                    : [options.exclude].filter(Boolean),
+                createBackup: options.createBackup,
+                verbose: globalOptions.verbose,
+                color: !globalOptions.noColor,
+            });
+        }
+        catch (error) {
+            console.error(chalk.red('❌ Error:'), error);
+            process.exit(1);
+        }
+    });
+    // Analyze command
+    program
+        .command('analyze')
+        .description('analyze the impact of updating a specific dependency')
+        .argument('<catalog>', 'catalog name')
+        .argument('<package>', 'package name')
+        .argument('[version]', 'new version (default: latest)')
+        .option('--format <type>', 'output format: table, json, yaml, minimal', 'table')
+        .action(async (catalog, packageName, version, options, command) => {
+        try {
+            const globalOptions = command.parent.opts();
+            const formatter = new OutputFormatter(options.format, !globalOptions.noColor);
+            // Get latest version if not specified
+            const targetVersion = version || (await services.registryService.getLatestVersion(packageName)).toString();
+            const analysis = await services.catalogUpdateService.analyzeImpact(catalog, packageName, targetVersion, globalOptions.workspace);
+            const formattedOutput = formatter.formatImpactAnalysis(analysis);
+            console.log(formattedOutput);
+        }
+        catch (error) {
+            console.error(chalk.red('❌ Error:'), error);
+            process.exit(1);
+        }
+    });
+    // Workspace command
+    program
+        .command('workspace')
+        .description('workspace information and validation')
+        .option('--validate', 'validate workspace configuration')
+        .option('--stats', 'show workspace statistics')
+        .option('--format <type>', 'output format: table, json, yaml, minimal', 'table')
+        .action(async (options, command) => {
+        try {
+            const globalOptions = command.parent.opts();
+            const formatter = new OutputFormatter(options.format, !globalOptions.noColor);
+            if (options.validate) {
+                const report = await services.workspaceService.validateWorkspace(globalOptions.workspace);
+                const formattedOutput = formatter.formatValidationReport(report);
+                console.log(formattedOutput);
+                process.exit(report.isValid ? 0 : 1);
+            }
+            else if (options.stats) {
+                const stats = await services.workspaceService.getWorkspaceStats(globalOptions.workspace);
+                const formattedOutput = formatter.formatWorkspaceStats(stats);
+                console.log(formattedOutput);
+            }
+            else {
+                const info = await services.workspaceService.getWorkspaceInfo(globalOptions.workspace);
+                console.log(formatter.formatMessage(`Workspace: ${info.name}`, 'info'));
+                console.log(formatter.formatMessage(`Path: ${info.path}`, 'info'));
+                console.log(formatter.formatMessage(`Packages: ${info.packageCount}`, 'info'));
+                console.log(formatter.formatMessage(`Catalogs: ${info.catalogCount}`, 'info'));
+                if (info.catalogNames.length > 0) {
+                    console.log(formatter.formatMessage(`Catalog names: ${info.catalogNames.join(', ')}`, 'info'));
+                }
+            }
+        }
+        catch (error) {
+            console.error(chalk.red('❌ Error:'), error);
+            process.exit(1);
+        }
+    });
+    // Add help command
+    program
+        .command('help')
+        .argument('[command]', 'command to get help for')
+        .description('display help for command')
+        .action((command) => {
+        if (command) {
+            const cmd = program.commands.find((c) => c.name() === command);
+            if (cmd) {
+                cmd.help();
+            }
+            else {
+                console.log(chalk.red(`Unknown command: ${command}`));
+            }
+        }
+        else {
+            program.help();
+        }
+    });
+    // Let commander handle help and version normally
+    // program.exitOverride() removed to fix help/version output
+    // Show help if no arguments provided
+    if (process.argv.length <= 2) {
+        program.help();
+    }
+    // Parse command line arguments
+    try {
+        await program.parseAsync(process.argv);
+    }
+    catch (error) {
+        console.error(chalk.red('❌ Unexpected error:'), error);
+        if (error instanceof Error && error.stack) {
+            console.error(chalk.gray(error.stack));
+        }
+        process.exit(1);
+    }
+}
+// Run the CLI if this file is executed directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch((error) => {
+        console.error(chalk.red('❌ Fatal error:'), error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/cli/options/GlobalOptions.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Global CLI Options
+ *
+ * Defines standardized option definitions for all CLI commands.
+ * Provides consistent option parsing and validation.
+ */
+import { Option } from 'commander';
+export interface GlobalCliOptions {
+    workspace?: string;
+    verbose?: boolean;
+    color?: boolean;
+    registry?: string;
+    timeout?: number;
+    config?: string;
+}
+export interface CheckCliOptions extends GlobalCliOptions {
+    catalog?: string;
+    format?: 'table' | 'json' | 'yaml' | 'minimal';
+    target?: 'latest' | 'greatest' | 'minor' | 'patch' | 'newest';
+    prerelease?: boolean;
+    include?: string[];
+    exclude?: string[];
+}
+export interface UpdateCliOptions extends CheckCliOptions {
+    interactive?: boolean;
+    dryRun?: boolean;
+    force?: boolean;
+    createBackup?: boolean;
+}
+export interface AnalyzeCliOptions extends GlobalCliOptions {
+    format?: 'table' | 'json' | 'yaml' | 'minimal';
+}
+export interface WorkspaceCliOptions extends GlobalCliOptions {
+    validate?: boolean;
+    stats?: boolean;
+    info?: boolean;
+    format?: 'table' | 'json' | 'yaml' | 'minimal';
+}
+/**
+ * Global options available to all commands
+ */
+export declare const globalOptions: Option[];
+/**
+ * Check command specific options
+ */
+export declare const checkOptions: Option[];
+/**
+ * Update command specific options
+ */
+export declare const updateOptions: Option[];
+/**
+ * Analyze command specific options
+ */
+export declare const analyzeOptions: Option[];
+/**
+ * Workspace command specific options
+ */
+export declare const workspaceOptions: Option[];
+/**
+ * Option groups for better help organization
+ */
+export declare const optionGroups: {
+    global: {
+        title: string;
+        options: Option[];
+    };
+    output: {
+        title: string;
+        options: Option[];
+    };
+    filtering: {
+        title: string;
+        options: Option[];
+    };
+    update: {
+        title: string;
+        options: Option[];
+    };
+    registry: {
+        title: string;
+        options: Option[];
+    };
+};
+/**
+ * Utility functions for option handling
+ */
+export declare class OptionUtils {
+    /**
+     * Parse and validate global options
+     */
+    static parseGlobalOptions(options: any): GlobalCliOptions;
+    /**
+     * Parse check command options
+     */
+    static parseCheckOptions(options: any): CheckCliOptions;
+    /**
+     * Parse update command options
+     */
+    static parseUpdateOptions(options: any): UpdateCliOptions;
+    /**
+     * Parse analyze command options
+     */
+    static parseAnalyzeOptions(options: any): AnalyzeCliOptions;
+    /**
+     * Parse workspace command options
+     */
+    static parseWorkspaceOptions(options: any): WorkspaceCliOptions;
+    /**
+     * Generate help text for option group
+     */
+    static generateHelpText(groupName: keyof typeof optionGroups): string;
+    /**
+     * Validate option combinations
+     */
+    static validateOptionCombinations(command: string, options: any): string[];
+}
+//# sourceMappingURL=GlobalOptions.d.ts.map

package/dist/cli/options/GlobalOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalOptions.d.ts","sourceRoot":"","sources":["../../../src/cli/options/GlobalOptions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC/C,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC9D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAChD;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,UAczB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,UAoBxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,UAUzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,UAO1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,UAa5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;CA2CxB,CAAC;AAEF;;GAEG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,GAAG,GAAG,gBAAgB;IAiCzD;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,GAAG,GAAG,eAAe;IAmCvD;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,GAAG,GAAG,gBAAgB;IAuBzD;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,GAAG,GAAG,iBAAiB;IAW3D;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,OAAO,EAAE,GAAG,GAAG,mBAAmB;IAuB/D;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,OAAO,YAAY,GAAG,MAAM;IAkBrE;;OAEG;IACH,MAAM,CAAC,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,MAAM,EAAE;CA6B3E"}

package/dist/cli/options/GlobalOptions.js

@@ -0,0 +1,278 @@
+/**
+ * Global CLI Options
+ *
+ * Defines standardized option definitions for all CLI commands.
+ * Provides consistent option parsing and validation.
+ */
+import { Option } from 'commander';
+/**
+ * Global options available to all commands
+ */
+export const globalOptions = [
+    new Option('-w, --workspace <path>', 'workspace directory path').env('PCU_WORKSPACE'),
+    new Option('-v, --verbose', 'enable verbose logging').env('PCU_VERBOSE'),
+    new Option('--no-color', 'disable colored output').env('PCU_NO_COLOR'),
+    new Option('--registry <url>', 'NPM registry URL').env('PCU_REGISTRY'),
+    new Option('--timeout <ms>', 'request timeout in milliseconds')
+        .argParser(parseInt)
+        .env('PCU_TIMEOUT'),
+    new Option('--config <path>', 'path to configuration file').env('PCU_CONFIG'),
+];
+/**
+ * Check command specific options
+ */
+export const checkOptions = [
+    ...globalOptions,
+    new Option('--catalog <name>', 'check specific catalog only').env('PCU_CATALOG'),
+    new Option('-f, --format <type>', 'output format')
+        .choices(['table', 'json', 'yaml', 'minimal'])
+        .default('table')
+        .env('PCU_OUTPUT_FORMAT'),
+    new Option('-t, --target <type>', 'update target')
+        .choices(['latest', 'greatest', 'minor', 'patch', 'newest'])
+        .default('latest')
+        .env('PCU_UPDATE_TARGET'),
+    new Option('--prerelease', 'include prerelease versions').env('PCU_PRERELEASE'),
+    new Option('--include <pattern...>', 'include packages matching pattern').env('PCU_INCLUDE'),
+    new Option('--exclude <pattern...>', 'exclude packages matching pattern').env('PCU_EXCLUDE'),
+];
+/**
+ * Update command specific options
+ */
+export const updateOptions = [
+    ...checkOptions,
+    new Option('-i, --interactive', 'interactive mode to choose updates').env('PCU_INTERACTIVE'),
+    new Option('-d, --dry-run', 'preview changes without writing files').env('PCU_DRY_RUN'),
+    new Option('--force', 'force updates even if risky').env('PCU_FORCE'),
+    new Option('--create-backup', 'create backup files before updating').env('PCU_CREATE_BACKUP'),
+];
+/**
+ * Analyze command specific options
+ */
+export const analyzeOptions = [
+    ...globalOptions,
+    new Option('-f, --format <type>', 'output format')
+        .choices(['table', 'json', 'yaml', 'minimal'])
+        .default('table')
+        .env('PCU_OUTPUT_FORMAT'),
+];
+/**
+ * Workspace command specific options
+ */
+export const workspaceOptions = [
+    ...globalOptions,
+    new Option('--validate', 'validate workspace configuration'),
+    new Option('--stats', 'show workspace statistics'),
+    new Option('--info', 'show workspace information'),
+    new Option('-f, --format <type>', 'output format')
+        .choices(['table', 'json', 'yaml', 'minimal'])
+        .default('table')
+        .env('PCU_OUTPUT_FORMAT'),
+];
+/**
+ * Option groups for better help organization
+ */
+export const optionGroups = {
+    global: {
+        title: 'Global Options',
+        options: globalOptions,
+    },
+    output: {
+        title: 'Output Options',
+        options: [
+            new Option('-f, --format <type>', 'output format')
+                .choices(['table', 'json', 'yaml', 'minimal'])
+                .default('table'),
+            new Option('--no-color', 'disable colored output'),
+            new Option('-v, --verbose', 'enable verbose logging'),
+        ],
+    },
+    filtering: {
+        title: 'Filtering Options',
+        options: [
+            new Option('--catalog <name>', 'check specific catalog only'),
+            new Option('--include <pattern...>', 'include packages matching pattern'),
+            new Option('--exclude <pattern...>', 'exclude packages matching pattern'),
+        ],
+    },
+    update: {
+        title: 'Update Options',
+        options: [
+            new Option('-t, --target <type>', 'update target')
+                .choices(['latest', 'greatest', 'minor', 'patch', 'newest'])
+                .default('latest'),
+            new Option('--prerelease', 'include prerelease versions'),
+            new Option('-i, --interactive', 'interactive mode'),
+            new Option('-d, --dry-run', 'preview changes only'),
+            new Option('--force', 'force updates'),
+            new Option('--create-backup', 'create backup files'),
+        ],
+    },
+    registry: {
+        title: 'Registry Options',
+        options: [
+            new Option('--registry <url>', 'NPM registry URL'),
+            new Option('--timeout <ms>', 'request timeout').argParser(parseInt),
+        ],
+    },
+};
+/**
+ * Utility functions for option handling
+ */
+export class OptionUtils {
+    /**
+     * Parse and validate global options
+     */
+    static parseGlobalOptions(options) {
+        const parsed = {};
+        if (options.workspace) {
+            parsed.workspace = String(options.workspace).trim();
+        }
+        if (options.verbose !== undefined) {
+            parsed.verbose = Boolean(options.verbose);
+        }
+        if (options.color !== undefined) {
+            parsed.color = Boolean(options.color);
+        }
+        if (options.registry) {
+            parsed.registry = String(options.registry).trim();
+        }
+        if (options.timeout) {
+            const timeout = parseInt(String(options.timeout), 10);
+            if (!isNaN(timeout) && timeout > 0) {
+                parsed.timeout = timeout;
+            }
+        }
+        if (options.config) {
+            parsed.config = String(options.config).trim();
+        }
+        return parsed;
+    }
+    /**
+     * Parse check command options
+     */
+    static parseCheckOptions(options) {
+        const global = this.parseGlobalOptions(options);
+        const check = { ...global };
+        if (options.catalog) {
+            check.catalog = String(options.catalog).trim();
+        }
+        if (options.format && typeof options.format === 'string') {
+            check.format = options.format;
+        }
+        if (options.target && typeof options.target === 'string') {
+            check.target = options.target;
+        }
+        if (options.prerelease !== undefined) {
+            check.prerelease = Boolean(options.prerelease);
+        }
+        if (options.include) {
+            check.include = Array.isArray(options.include)
+                ? options.include.map((p) => String(p).trim()).filter(Boolean)
+                : [String(options.include).trim()].filter(Boolean);
+        }
+        if (options.exclude) {
+            check.exclude = Array.isArray(options.exclude)
+                ? options.exclude.map((p) => String(p).trim()).filter(Boolean)
+                : [String(options.exclude).trim()].filter(Boolean);
+        }
+        return check;
+    }
+    /**
+     * Parse update command options
+     */
+    static parseUpdateOptions(options) {
+        const check = this.parseCheckOptions(options);
+        const update = { ...check };
+        if (options.interactive !== undefined) {
+            update.interactive = Boolean(options.interactive);
+        }
+        if (options.dryRun !== undefined) {
+            update.dryRun = Boolean(options.dryRun);
+        }
+        if (options.force !== undefined) {
+            update.force = Boolean(options.force);
+        }
+        if (options.createBackup !== undefined) {
+            update.createBackup = Boolean(options.createBackup);
+        }
+        return update;
+    }
+    /**
+     * Parse analyze command options
+     */
+    static parseAnalyzeOptions(options) {
+        const global = this.parseGlobalOptions(options);
+        const analyze = { ...global };
+        if (options.format && typeof options.format === 'string') {
+            analyze.format = options.format;
+        }
+        return analyze;
+    }
+    /**
+     * Parse workspace command options
+     */
+    static parseWorkspaceOptions(options) {
+        const global = this.parseGlobalOptions(options);
+        const workspace = { ...global };
+        if (options.validate !== undefined) {
+            workspace.validate = Boolean(options.validate);
+        }
+        if (options.stats !== undefined) {
+            workspace.stats = Boolean(options.stats);
+        }
+        if (options.info !== undefined) {
+            workspace.info = Boolean(options.info);
+        }
+        if (options.format && typeof options.format === 'string') {
+            workspace.format = options.format;
+        }
+        return workspace;
+    }
+    /**
+     * Generate help text for option group
+     */
+    static generateHelpText(groupName) {
+        const group = optionGroups[groupName];
+        if (!group)
+            return '';
+        const lines = [`${group.title}:`];
+        for (const option of group.options) {
+            const flags = option.flags;
+            const description = option.description || '';
+            const choices = option.argChoices ? ` (choices: ${option.argChoices.join(', ')})` : '';
+            const defaultValue = option.defaultValue ? ` (default: ${option.defaultValue})` : '';
+            lines.push(`  ${flags.padEnd(30)} ${description}${choices}${defaultValue}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Validate option combinations
+     */
+    static validateOptionCombinations(command, options) {
+        const errors = [];
+        switch (command) {
+            case 'update':
+                if (options.interactive && options.dryRun) {
+                    errors.push('Cannot use --interactive with --dry-run');
+                }
+                break;
+            case 'workspace':
+                const actionCount = [options.validate, options.stats, options.info].filter(Boolean).length;
+                if (actionCount > 1) {
+                    errors.push('Cannot use multiple workspace actions simultaneously');
+                }
+                if (actionCount === 0) {
+                    // Default to info
+                    options.info = true;
+                }
+                break;
+        }
+        // Global validations
+        if (options.verbose && options.silent) {
+            errors.push('Cannot use both --verbose and --silent');
+        }
+        return errors;
+    }
+}
+//# sourceMappingURL=GlobalOptions.js.map