@eldrforge/kodrdriv 0.0.19 → 0.0.24

package/dist/arguments.js

@@ -0,0 +1,664 @@
+import { Command } from 'commander';
+import { z } from 'zod';
+import { PROGRAM_NAME, VERSION, KODRDRIV_DEFAULTS, ALLOWED_COMMANDS, DEFAULT_COMMAND } from './constants.js';
+import { getLogger } from './logging.js';
+import { create } from './util/storage.js';
+import { readStdin } from './util/stdin.js';
+
+z.object({
+    dryRun: z.boolean().optional(),
+    verbose: z.boolean().optional(),
+    debug: z.boolean().optional(),
+    overrides: z.boolean().optional(),
+    checkConfig: z.boolean().optional(),
+    initConfig: z.boolean().optional(),
+    model: z.string().optional(),
+    contextDirectories: z.array(z.string()).optional(),
+    configDir: z.string().optional(),
+    outputDir: z.string().optional(),
+    preferencesDir: z.string().optional(),
+    cached: z.boolean().optional(),
+    add: z.boolean().optional(),
+    sendit: z.boolean().optional(),
+    from: z.string().optional(),
+    to: z.string().optional(),
+    excludedPatterns: z.array(z.string()).optional(),
+    context: z.string().optional(),
+    note: z.string().optional(),
+    direction: z.string().optional(),
+    messageLimit: z.number().optional(),
+    mergeMethod: z.enum([
+        'merge',
+        'squash',
+        'rebase'
+    ]).optional(),
+    scopeRoots: z.string().optional(),
+    workspaceFile: z.string().optional(),
+    includeCommitHistory: z.boolean().optional(),
+    includeRecentDiffs: z.boolean().optional(),
+    includeReleaseNotes: z.boolean().optional(),
+    includeGithubIssues: z.boolean().optional(),
+    commitHistoryLimit: z.number().optional(),
+    diffHistoryLimit: z.number().optional(),
+    releaseNotesLimit: z.number().optional(),
+    githubIssuesLimit: z.number().optional(),
+    file: z.string().optional(),
+    keepTemp: z.boolean().optional()
+});
+// Function to transform flat CLI args into nested Config structure
+const transformCliArgs = (finalCliArgs)=>{
+    const transformedCliArgs = {};
+    // Direct mappings from Input to Config
+    if (finalCliArgs.dryRun !== undefined) transformedCliArgs.dryRun = finalCliArgs.dryRun;
+    if (finalCliArgs.verbose !== undefined) transformedCliArgs.verbose = finalCliArgs.verbose;
+    if (finalCliArgs.debug !== undefined) transformedCliArgs.debug = finalCliArgs.debug;
+    if (finalCliArgs.overrides !== undefined) transformedCliArgs.overrides = finalCliArgs.overrides;
+    if (finalCliArgs.model !== undefined) transformedCliArgs.model = finalCliArgs.model;
+    if (finalCliArgs.contextDirectories !== undefined) transformedCliArgs.contextDirectories = finalCliArgs.contextDirectories;
+    // Map configDir (CLI) to configDirectory (Cardigantime standard)
+    if (finalCliArgs.configDir !== undefined) transformedCliArgs.configDirectory = finalCliArgs.configDir;
+    // Map outputDir (CLI) to outputDirectory (Config standard)
+    if (finalCliArgs.outputDir !== undefined) transformedCliArgs.outputDirectory = finalCliArgs.outputDir;
+    // Map preferencesDir (CLI) to preferencesDirectory (Config standard)
+    if (finalCliArgs.preferencesDir !== undefined) transformedCliArgs.preferencesDirectory = finalCliArgs.preferencesDir;
+    // Nested mappings for 'commit' options
+    if (finalCliArgs.cached !== undefined || finalCliArgs.sendit !== undefined || finalCliArgs.add !== undefined) {
+        transformedCliArgs.commit = {};
+        if (finalCliArgs.add !== undefined) transformedCliArgs.commit.add = finalCliArgs.add;
+        if (finalCliArgs.cached !== undefined) transformedCliArgs.commit.cached = finalCliArgs.cached;
+        if (finalCliArgs.sendit !== undefined) transformedCliArgs.commit.sendit = finalCliArgs.sendit;
+        if (finalCliArgs.messageLimit !== undefined) transformedCliArgs.commit.messageLimit = finalCliArgs.messageLimit;
+        if (finalCliArgs.context !== undefined) transformedCliArgs.commit.context = finalCliArgs.context;
+        if (finalCliArgs.direction !== undefined) transformedCliArgs.commit.direction = finalCliArgs.direction;
+    }
+    // Nested mappings for 'audioCommit' options
+    if (finalCliArgs.file !== undefined || finalCliArgs.keepTemp !== undefined) {
+        transformedCliArgs.audioCommit = {};
+        if (finalCliArgs.file !== undefined) transformedCliArgs.audioCommit.file = finalCliArgs.file;
+        if (finalCliArgs.keepTemp !== undefined) transformedCliArgs.audioCommit.keepTemp = finalCliArgs.keepTemp;
+    }
+    // Nested mappings for 'release' options
+    if (finalCliArgs.from !== undefined || finalCliArgs.to !== undefined) {
+        transformedCliArgs.release = {};
+        if (finalCliArgs.from !== undefined) transformedCliArgs.release.from = finalCliArgs.from;
+        if (finalCliArgs.to !== undefined) transformedCliArgs.release.to = finalCliArgs.to;
+        if (finalCliArgs.context !== undefined) transformedCliArgs.release.context = finalCliArgs.context;
+        if (finalCliArgs.messageLimit !== undefined) transformedCliArgs.release.messageLimit = finalCliArgs.messageLimit;
+    }
+    // Nested mappings for 'publish' options
+    if (finalCliArgs.mergeMethod !== undefined) {
+        transformedCliArgs.publish = {};
+        if (finalCliArgs.mergeMethod !== undefined) transformedCliArgs.publish.mergeMethod = finalCliArgs.mergeMethod;
+    }
+    // Nested mappings for 'link' and 'unlink' options (both use the same configuration)
+    if (finalCliArgs.scopeRoots !== undefined || finalCliArgs.workspaceFile !== undefined) {
+        transformedCliArgs.link = {};
+        if (finalCliArgs.scopeRoots !== undefined) {
+            try {
+                transformedCliArgs.link.scopeRoots = JSON.parse(finalCliArgs.scopeRoots);
+            } catch (error) {
+                throw new Error(`Invalid JSON for scope-roots: ${finalCliArgs.scopeRoots}`);
+            }
+        }
+        if (finalCliArgs.workspaceFile !== undefined) transformedCliArgs.link.workspaceFile = finalCliArgs.workspaceFile;
+    }
+    // Nested mappings for 'audio-review' options
+    if (finalCliArgs.includeCommitHistory !== undefined || finalCliArgs.includeRecentDiffs !== undefined || finalCliArgs.includeReleaseNotes !== undefined || finalCliArgs.includeGithubIssues !== undefined || finalCliArgs.commitHistoryLimit !== undefined || finalCliArgs.diffHistoryLimit !== undefined || finalCliArgs.releaseNotesLimit !== undefined || finalCliArgs.githubIssuesLimit !== undefined || finalCliArgs.file !== undefined || finalCliArgs.keepTemp !== undefined) {
+        transformedCliArgs.audioReview = {};
+        if (finalCliArgs.includeCommitHistory !== undefined) transformedCliArgs.audioReview.includeCommitHistory = finalCliArgs.includeCommitHistory;
+        if (finalCliArgs.includeRecentDiffs !== undefined) transformedCliArgs.audioReview.includeRecentDiffs = finalCliArgs.includeRecentDiffs;
+        if (finalCliArgs.includeReleaseNotes !== undefined) transformedCliArgs.audioReview.includeReleaseNotes = finalCliArgs.includeReleaseNotes;
+        if (finalCliArgs.includeGithubIssues !== undefined) transformedCliArgs.audioReview.includeGithubIssues = finalCliArgs.includeGithubIssues;
+        if (finalCliArgs.commitHistoryLimit !== undefined) transformedCliArgs.audioReview.commitHistoryLimit = finalCliArgs.commitHistoryLimit;
+        if (finalCliArgs.diffHistoryLimit !== undefined) transformedCliArgs.audioReview.diffHistoryLimit = finalCliArgs.diffHistoryLimit;
+        if (finalCliArgs.releaseNotesLimit !== undefined) transformedCliArgs.audioReview.releaseNotesLimit = finalCliArgs.releaseNotesLimit;
+        if (finalCliArgs.githubIssuesLimit !== undefined) transformedCliArgs.audioReview.githubIssuesLimit = finalCliArgs.githubIssuesLimit;
+        if (finalCliArgs.context !== undefined) transformedCliArgs.audioReview.context = finalCliArgs.context;
+        if (finalCliArgs.sendit !== undefined) transformedCliArgs.audioReview.sendit = finalCliArgs.sendit;
+        if (finalCliArgs.file !== undefined) transformedCliArgs.audioReview.file = finalCliArgs.file;
+        if (finalCliArgs.keepTemp !== undefined) transformedCliArgs.audioReview.keepTemp = finalCliArgs.keepTemp;
+    }
+    // Nested mappings for 'review' options
+    if (finalCliArgs.includeCommitHistory !== undefined || finalCliArgs.includeRecentDiffs !== undefined || finalCliArgs.includeReleaseNotes !== undefined || finalCliArgs.includeGithubIssues !== undefined || finalCliArgs.commitHistoryLimit !== undefined || finalCliArgs.diffHistoryLimit !== undefined || finalCliArgs.releaseNotesLimit !== undefined || finalCliArgs.githubIssuesLimit !== undefined || finalCliArgs.context !== undefined || finalCliArgs.sendit !== undefined || finalCliArgs.note !== undefined) {
+        transformedCliArgs.review = {};
+        if (finalCliArgs.note !== undefined) transformedCliArgs.review.note = finalCliArgs.note;
+        // Include optional review configuration options if specified
+        if (finalCliArgs.includeCommitHistory !== undefined) transformedCliArgs.review.includeCommitHistory = finalCliArgs.includeCommitHistory;
+        if (finalCliArgs.includeRecentDiffs !== undefined) transformedCliArgs.review.includeRecentDiffs = finalCliArgs.includeRecentDiffs;
+        if (finalCliArgs.includeReleaseNotes !== undefined) transformedCliArgs.review.includeReleaseNotes = finalCliArgs.includeReleaseNotes;
+        if (finalCliArgs.includeGithubIssues !== undefined) transformedCliArgs.review.includeGithubIssues = finalCliArgs.includeGithubIssues;
+        if (finalCliArgs.commitHistoryLimit !== undefined) transformedCliArgs.review.commitHistoryLimit = finalCliArgs.commitHistoryLimit;
+        if (finalCliArgs.diffHistoryLimit !== undefined) transformedCliArgs.review.diffHistoryLimit = finalCliArgs.diffHistoryLimit;
+        if (finalCliArgs.releaseNotesLimit !== undefined) transformedCliArgs.review.releaseNotesLimit = finalCliArgs.releaseNotesLimit;
+        if (finalCliArgs.githubIssuesLimit !== undefined) transformedCliArgs.review.githubIssuesLimit = finalCliArgs.githubIssuesLimit;
+        if (finalCliArgs.context !== undefined) transformedCliArgs.review.context = finalCliArgs.context;
+        if (finalCliArgs.sendit !== undefined) transformedCliArgs.review.sendit = finalCliArgs.sendit;
+    }
+    if (finalCliArgs.excludedPatterns !== undefined) transformedCliArgs.excludedPatterns = finalCliArgs.excludedPatterns;
+    // Note: openaiApiKey is handled separately via environment variable only
+    return transformedCliArgs;
+};
+// Update configure signature to accept cardigantime
+const configure = async (cardigantime)=>{
+    var _config_contextDirectories, _config_link;
+    const logger = getLogger();
+    let program = new Command();
+    // Configure program basics
+    program.name(PROGRAM_NAME).summary('Create Intelligent Release Notes or Change Logs from Git').description('Create Intelligent Release Notes or Change Logs from Git').version(VERSION);
+    // Let cardigantime add its arguments first
+    program = await cardigantime.configure(program);
+    // Check if --check-config is in process.argv early
+    if (process.argv.includes('--check-config')) {
+        // For check-config, use CardiganTime's built-in checkConfig method
+        program.parse();
+        const cliArgs = program.opts();
+        // Transform the flat CLI args
+        const transformedCliArgs = transformCliArgs(cliArgs);
+        // Use CardiganTime's built-in checkConfig method which displays
+        // hierarchical configuration information in a well-formatted way
+        await cardigantime.checkConfig(transformedCliArgs);
+        // Return minimal config for consistency, but main processing is done
+        const config = await validateAndProcessOptions({});
+        const secureConfig = await validateAndProcessSecureOptions();
+        const commandConfig = {
+            commandName: 'check-config'
+        };
+        return [
+            config,
+            secureConfig,
+            commandConfig
+        ];
+    }
+    // Check if --init-config is in process.argv early
+    if (process.argv.includes('--init-config')) {
+        // For init-config, use CardiganTime's built-in generateConfig method
+        program.parse();
+        const cliArgs = program.opts();
+        // Transform the flat CLI args
+        const transformedCliArgs = transformCliArgs(cliArgs);
+        // Use CardiganTime's built-in generateConfig method
+        await cardigantime.generateConfig(transformedCliArgs.configDirectory || KODRDRIV_DEFAULTS.configDirectory);
+        // Return minimal config for consistency, but main processing is done
+        const config = await validateAndProcessOptions({});
+        const secureConfig = await validateAndProcessSecureOptions();
+        const commandConfig = {
+            commandName: 'init-config'
+        };
+        return [
+            config,
+            secureConfig,
+            commandConfig
+        ];
+    }
+    // Get CLI arguments using the new function
+    const [finalCliArgs, commandConfig] = await getCliConfig(program);
+    logger.silly('Loaded Command Line Options: %s', JSON.stringify(finalCliArgs, null, 2));
+    // Transform the flat CLI args using the new function
+    const transformedCliArgs = transformCliArgs(finalCliArgs);
+    logger.silly('Transformed CLI Args for merging: %s', JSON.stringify(transformedCliArgs, null, 2));
+    // Get values from config file using Cardigantime's hierarchical configuration
+    const fileValues = await cardigantime.read(transformedCliArgs);
+    // Merge configurations: Defaults -> File -> CLI
+    // Properly merge the link section to preserve scope roots from config file
+    const mergedLink = {
+        ...KODRDRIV_DEFAULTS.link,
+        ...fileValues.link,
+        ...transformedCliArgs.link
+    };
+    const partialConfig = {
+        ...KODRDRIV_DEFAULTS,
+        ...fileValues,
+        ...transformedCliArgs,
+        link: mergedLink
+    }; // Cast to Partial<Config> initially
+    // Specific validation and processing after merge
+    const config = await validateAndProcessOptions(partialConfig);
+    // Log effective configuration summary at verbose level
+    logger.verbose('Configuration complete. Effective settings:');
+    logger.verbose(`  Command: ${commandConfig.commandName}`);
+    logger.verbose(`  Model: ${config.model}`);
+    logger.verbose(`  Dry run: ${config.dryRun}`);
+    logger.verbose(`  Debug: ${config.debug}`);
+    logger.verbose(`  Verbose: ${config.verbose}`);
+    logger.verbose(`  Config directory: ${config.configDirectory}`);
+    logger.verbose(`  Output directory: ${config.outputDirectory}`);
+    logger.verbose(`  Context directories: ${((_config_contextDirectories = config.contextDirectories) === null || _config_contextDirectories === void 0 ? void 0 : _config_contextDirectories.join(', ')) || 'none'}`);
+    if (config.excludedPatterns && config.excludedPatterns.length > 0) {
+        logger.verbose(`  Excluded patterns: ${config.excludedPatterns.join(', ')}`);
+    }
+    if (Object.keys(((_config_link = config.link) === null || _config_link === void 0 ? void 0 : _config_link.scopeRoots) || {}).length > 0) {
+        logger.verbose(`  Link scope roots: ${Object.keys(config.link.scopeRoots).join(', ')}`);
+    }
+    logger.silly('Final configuration: %s', JSON.stringify(config, null, 2));
+    const secureConfig = await validateAndProcessSecureOptions();
+    return [
+        config,
+        secureConfig,
+        commandConfig
+    ];
+};
+// Function to handle CLI argument parsing and processing
+async function getCliConfig(program) {
+    const addSharedOptions = (command)=>{
+        command.option('--dry-run', 'perform a dry run without saving files') // Removed default, will be handled by merging
+        .option('--verbose', 'enable verbose logging').option('--debug', 'enable debug logging').option('--overrides', 'enable overrides').option('--model <model>', 'OpenAI model to use').option('-d, --context-directories [contextDirectories...]', 'directories to scan for context').option('--config-dir <configDir>', 'configuration directory') // Keep config-dir for specifying location
+        .option('--output-dir <outputDir>', 'output directory for generated files').option('--preferences-dir <preferencesDir>', 'preferences directory for personal settings').option('--excluded-paths [excludedPatterns...]', 'paths to exclude from the diff').option('--keep-temp', 'keep temporary recording files');
+    };
+    // Add global options to the main program
+    // (cardigantime already adds most global options like --verbose, --debug, --config-dir)
+    // Add subcommands
+    const commitCommand = program.command('commit').argument('[direction]', 'direction or guidance for the commit message').description('Generate commit notes').option('--context <context>', 'context for the commit message').option('--cached', 'use cached diff').option('--add', 'add all changes before committing').option('--sendit', 'Commit with the message generated. No review.').option('--message-limit <messageLimit>', 'limit the number of messages to generate');
+    // Add shared options to commit command
+    addSharedOptions(commitCommand);
+    // Customize help output for commit command
+    commitCommand.configureHelp({
+        formatHelp: (cmd, helper)=>{
+            const nameAndVersion = `${helper.commandUsage(cmd)}\n\n${helper.commandDescription(cmd)}\n`;
+            const commitOptions = [
+                [
+                    '--context <context>',
+                    'context for the commit message'
+                ]
+            ];
+            const behavioralOptions = [
+                [
+                    '--cached',
+                    'use cached diff'
+                ],
+                [
+                    '--add',
+                    'add all changes before committing'
+                ],
+                [
+                    '--sendit',
+                    'Commit with the message generated. No review.'
+                ],
+                [
+                    '--message-limit <messageLimit>',
+                    'limit the number of messages to generate'
+                ]
+            ];
+            const globalOptions = [
+                [
+                    '--dry-run',
+                    'perform a dry run without saving files'
+                ],
+                [
+                    '--verbose',
+                    'enable verbose logging'
+                ],
+                [
+                    '--debug',
+                    'enable debug logging'
+                ],
+                [
+                    '--overrides',
+                    'enable overrides'
+                ],
+                [
+                    '--model <model>',
+                    'OpenAI model to use'
+                ],
+                [
+                    '-d, --context-directories [contextDirectories...]',
+                    'directories to scan for context'
+                ],
+                [
+                    '--config-dir <configDir>',
+                    'configuration directory'
+                ],
+                [
+                    '--excluded-paths [excludedPatterns...]',
+                    'paths to exclude from the diff'
+                ],
+                [
+                    '-h, --help',
+                    'display help for command'
+                ]
+            ];
+            const formatOptionsSection = (title, options)=>{
+                const maxWidth = Math.max(...options.map(([flag])=>flag.length));
+                return `${title}:\n` + options.map(([flag, desc])=>`  ${flag.padEnd(maxWidth + 2)} ${desc}`).join('\n') + '\n';
+            };
+            return nameAndVersion + '\n' + formatOptionsSection('Commit Message Options', commitOptions) + '\n' + formatOptionsSection('Behavioral Options', behavioralOptions) + '\n' + formatOptionsSection('Global Options', globalOptions) + '\n' + 'Environment Variables:\n' + '  OPENAI_API_KEY          OpenAI API key (required)\n';
+        }
+    });
+    const audioCommitCommand = program.command('audio-commit').option('--cached', 'use cached diff').option('--add', 'add all changes before committing').option('--sendit', 'Commit with the message generated. No review.').option('--direction <direction>', 'direction or guidance for the commit message').option('--message-limit <messageLimit>', 'limit the number of messages to generate').option('--file <file>', 'audio file path').description('Record audio to provide context, then generate and optionally commit with AI-generated message');
+    addSharedOptions(audioCommitCommand);
+    const releaseCommand = program.command('release').option('--from <from>', 'branch to generate release notes from').option('--to <to>', 'branch to generate release notes to').option('--context <context>', 'context for the commit message').description('Generate release notes');
+    addSharedOptions(releaseCommand);
+    const publishCommand = program.command('publish').option('--merge-method <method>', 'method to merge PR (merge, squash, rebase)', 'squash').description('Publish a release');
+    addSharedOptions(publishCommand);
+    const linkCommand = program.command('link').option('--scope-roots <scopeRoots>', 'JSON mapping of scopes to root directories (e.g., \'{"@company": "../"}\')').option('--workspace-file <workspaceFile>', 'path to workspace file', 'pnpm-workspace.yaml').description('Manage pnpm workspace links for local development');
+    addSharedOptions(linkCommand);
+    const unlinkCommand = program.command('unlink').option('--scope-roots <scopeRoots>', 'JSON mapping of scopes to root directories (e.g., \'{"@company": "../"}\')').option('--workspace-file <workspaceFile>', 'path to workspace file', 'pnpm-workspace.yaml').description('Remove pnpm workspace links and rebuild dependencies');
+    addSharedOptions(unlinkCommand);
+    const audioReviewCommand = program.command('audio-review').option('--include-commit-history', 'include recent commit log messages in context (default: true)').option('--no-include-commit-history', 'exclude commit log messages from context').option('--include-recent-diffs', 'include recent commit diffs in context (default: true)').option('--no-include-recent-diffs', 'exclude recent diffs from context').option('--include-release-notes', 'include recent release notes in context (default: false)').option('--no-include-release-notes', 'exclude release notes from context').option('--include-github-issues', 'include open GitHub issues in context (default: true)').option('--no-include-github-issues', 'exclude GitHub issues from context').option('--commit-history-limit <limit>', 'number of recent commits to include', parseInt).option('--diff-history-limit <limit>', 'number of recent commit diffs to include', parseInt).option('--release-notes-limit <limit>', 'number of recent release notes to include', parseInt).option('--github-issues-limit <limit>', 'number of open GitHub issues to include (max 20)', parseInt).option('--context <context>', 'additional context for the audio review').option('--file <file>', 'audio file path').description('Record audio, transcribe with Whisper, and analyze for project issues using AI');
+    addSharedOptions(audioReviewCommand);
+    const reviewCommand = program.command('review').argument('[note]', 'review note to analyze for project issues').option('--include-commit-history', 'include recent commit log messages in context (default: true)').option('--no-include-commit-history', 'exclude commit log messages from context').option('--include-recent-diffs', 'include recent commit diffs in context (default: true)').option('--no-include-recent-diffs', 'exclude recent diffs from context').option('--include-release-notes', 'include recent release notes in context (default: false)').option('--no-include-release-notes', 'exclude release notes from context').option('--include-github-issues', 'include open GitHub issues in context (default: true)').option('--no-include-github-issues', 'exclude GitHub issues from context').option('--commit-history-limit <limit>', 'number of recent commits to include', parseInt).option('--diff-history-limit <limit>', 'number of recent commit diffs to include', parseInt).option('--release-notes-limit <limit>', 'number of recent release notes to include', parseInt).option('--github-issues-limit <limit>', 'number of open GitHub issues to include (max 20)', parseInt).option('--context <context>', 'additional context for the review').option('--sendit', 'Create GitHub issues automatically without confirmation').description('Analyze review note for project issues using AI');
+    addSharedOptions(reviewCommand);
+    // Customize help output for review command
+    reviewCommand.configureHelp({
+        formatHelp: (cmd, helper)=>{
+            const nameAndVersion = `kodrdriv review [note] [options]\n\nAnalyze review note for project issues using AI\n`;
+            const argumentsSection = [
+                [
+                    'note',
+                    'review note to analyze for project issues (can also be piped via STDIN)'
+                ]
+            ];
+            const reviewOptions = [
+                [
+                    '--context <context>',
+                    'additional context for the review'
+                ]
+            ];
+            const gitContextOptions = [
+                [
+                    '--include-commit-history',
+                    'include recent commit log messages in context (default: true)'
+                ],
+                [
+                    '--no-include-commit-history',
+                    'exclude commit log messages from context'
+                ],
+                [
+                    '--include-recent-diffs',
+                    'include recent commit diffs in context (default: true)'
+                ],
+                [
+                    '--no-include-recent-diffs',
+                    'exclude recent diffs from context'
+                ],
+                [
+                    '--include-release-notes',
+                    'include recent release notes in context (default: false)'
+                ],
+                [
+                    '--no-include-release-notes',
+                    'exclude release notes from context'
+                ],
+                [
+                    '--include-github-issues',
+                    'include open GitHub issues in context (default: true)'
+                ],
+                [
+                    '--no-include-github-issues',
+                    'exclude GitHub issues from context'
+                ],
+                [
+                    '--commit-history-limit <limit>',
+                    'number of recent commits to include'
+                ],
+                [
+                    '--diff-history-limit <limit>',
+                    'number of recent commit diffs to include'
+                ],
+                [
+                    '--release-notes-limit <limit>',
+                    'number of recent release notes to include'
+                ],
+                [
+                    '--github-issues-limit <limit>',
+                    'number of open GitHub issues to include (max 20)'
+                ]
+            ];
+            const behavioralOptions = [
+                [
+                    '--sendit',
+                    'Create GitHub issues automatically without confirmation'
+                ]
+            ];
+            const globalOptions = [
+                [
+                    '--dry-run',
+                    'perform a dry run without saving files'
+                ],
+                [
+                    '--verbose',
+                    'enable verbose logging'
+                ],
+                [
+                    '--debug',
+                    'enable debug logging'
+                ],
+                [
+                    '--overrides',
+                    'enable overrides'
+                ],
+                [
+                    '--model <model>',
+                    'OpenAI model to use'
+                ],
+                [
+                    '-d, --context-directories [contextDirectories...]',
+                    'directories to scan for context'
+                ],
+                [
+                    '--config-dir <configDir>',
+                    'configuration directory'
+                ],
+                [
+                    '--output-dir <outputDir>',
+                    'output directory for generated files'
+                ],
+                [
+                    '--excluded-paths [excludedPatterns...]',
+                    'paths to exclude from the diff'
+                ],
+                [
+                    '-h, --help',
+                    'display help for command'
+                ]
+            ];
+            const formatOptionsSection = (title, options)=>{
+                const maxWidth = Math.max(...options.map(([flag])=>flag.length));
+                return `${title}:\n` + options.map(([flag, desc])=>`  ${flag.padEnd(maxWidth + 2)} ${desc}`).join('\n') + '\n';
+            };
+            return nameAndVersion + '\n' + formatOptionsSection('Arguments', argumentsSection) + '\n' + formatOptionsSection('Options', reviewOptions) + '\n' + formatOptionsSection('Git Context Parameters', gitContextOptions) + '\n' + formatOptionsSection('Behavioral Options', behavioralOptions) + '\n' + formatOptionsSection('Global Options', globalOptions) + '\n' + 'Environment Variables:\n' + '  OPENAI_API_KEY          OpenAI API key (required)\n';
+        }
+    });
+    const cleanCommand = program.command('clean').description('Remove the output directory and all generated files');
+    addSharedOptions(cleanCommand);
+    const selectAudioCommand = program.command('select-audio').description('Interactively select and save audio device for recording');
+    addSharedOptions(selectAudioCommand);
+    program.parse();
+    const cliArgs = program.opts(); // Get all opts initially
+    // Determine which command is being run
+    let commandName = DEFAULT_COMMAND;
+    let commandOptions = {}; // Store specific command options
+    if (program.args.length > 0) {
+        commandName = program.args[0];
+        validateCommand(commandName);
+    }
+    // Only proceed with command-specific options if validation passed
+    if (ALLOWED_COMMANDS.includes(commandName)) {
+        if (commandName === 'commit' && commitCommand.opts) {
+            commandOptions = commitCommand.opts();
+            // Handle positional argument for direction
+            const args = commitCommand.args;
+            if (args && args.length > 0 && args[0]) {
+                commandOptions.direction = args[0];
+            }
+            // Check for STDIN input for direction (takes precedence over positional argument)
+            const stdinInput = await readStdin();
+            if (stdinInput) {
+                commandOptions.direction = stdinInput;
+            }
+        } else if (commandName === 'audio-commit' && audioCommitCommand.opts) {
+            commandOptions = audioCommitCommand.opts();
+        } else if (commandName === 'release' && releaseCommand.opts) {
+            commandOptions = releaseCommand.opts();
+        } else if (commandName === 'publish' && publishCommand.opts) {
+            commandOptions = publishCommand.opts();
+        } else if (commandName === 'link' && linkCommand.opts) {
+            commandOptions = linkCommand.opts();
+        } else if (commandName === 'unlink' && unlinkCommand.opts) {
+            commandOptions = unlinkCommand.opts();
+        } else if (commandName === 'audio-review' && audioReviewCommand.opts) {
+            commandOptions = audioReviewCommand.opts();
+        } else if (commandName === 'review' && reviewCommand.opts) {
+            commandOptions = reviewCommand.opts();
+            // Handle positional argument for note
+            const args = reviewCommand.args;
+            if (args && args.length > 0 && args[0]) {
+                commandOptions.note = args[0];
+            }
+            // Check for STDIN input for note (takes precedence over positional argument)
+            const stdinInput = await readStdin();
+            if (stdinInput) {
+                commandOptions.note = stdinInput;
+            }
+        } else if (commandName === 'clean' && cleanCommand.opts) {
+            commandOptions = cleanCommand.opts();
+        } else if (commandName === 'select-audio' && selectAudioCommand.opts) {
+            commandOptions = selectAudioCommand.opts();
+        }
+    }
+    // Include command name in CLI args for merging
+    const finalCliArgs = {
+        ...cliArgs,
+        ...commandOptions
+    };
+    const commandConfig = {
+        commandName
+    };
+    return [
+        finalCliArgs,
+        commandConfig
+    ];
+}
+async function validateAndProcessSecureOptions() {
+    // For check-config and init-config commands, we don't want to throw an error for missing API key
+    const isCheckConfig = process.argv.includes('--check-config');
+    const isInitConfig = process.argv.includes('--init-config');
+    if (!process.env.OPENAI_API_KEY && !isCheckConfig && !isInitConfig) {
+        throw new Error('OpenAI API key is required. Please set the OPENAI_API_KEY environment variable.');
+    }
+    // Prefer CLI key if provided, otherwise use env var (might be undefined for check-config/init-config)
+    const openaiApiKey = process.env.OPENAI_API_KEY;
+    const secureConfig = {
+        openaiApiKey: openaiApiKey
+    };
+    return secureConfig;
+}
+// Renamed validation function to reflect its broader role
+async function validateAndProcessOptions(options) {
+    var _options_commit, _options_commit1, _options_commit2, _options_commit3, _options_commit4, _options_commit5, _options_audioCommit, _options_audioCommit1, _options_audioCommit2, _options_audioCommit3, _options_release, _options_release1, _options_release2, _options_release3, _options_audioReview, _options_audioReview1, _options_audioReview2, _options_audioReview3, _options_audioReview4, _options_audioReview5, _options_audioReview6, _options_audioReview7, _options_audioReview8, _options_audioReview9, _options_audioReview10, _options_audioReview11, _options_audioReview12, _options_audioReview13, _options_review, _options_review1, _options_review2, _options_review3, _options_review4, _options_review5, _options_review6, _options_review7, _options_review8, _options_review9, _options_review10, _options_publish, _options_publish1, _options_publish2, _options_publish3, _options_publish4, _options_link, _options_link1, _options_link2;
+    const contextDirectories = await validateContextDirectories(options.contextDirectories || KODRDRIV_DEFAULTS.contextDirectories);
+    const configDir = options.configDirectory || KODRDRIV_DEFAULTS.configDirectory;
+    var _options_dryRun, _options_verbose, _options_debug, _options_overrides, _options_model, _options_outputDirectory, _options_preferencesDirectory, _options_discoveredConfigDirs, _options_resolvedConfigDirs, _options_commit_add, _options_commit_cached, _options_commit_sendit, _options_commit_messageLimit, _options_audioCommit_maxRecordingTime, _options_audioCommit_audioDevice, _options_release_from, _options_release_to, _options_release_messageLimit, _options_audioReview_includeCommitHistory, _options_audioReview_includeRecentDiffs, _options_audioReview_includeReleaseNotes, _options_audioReview_includeGithubIssues, _options_audioReview_commitHistoryLimit, _options_audioReview_diffHistoryLimit, _options_audioReview_releaseNotesLimit, _options_audioReview_githubIssuesLimit, _options_audioReview_sendit, _options_audioReview_maxRecordingTime, _options_audioReview_audioDevice, _options_review_includeCommitHistory, _options_review_includeRecentDiffs, _options_review_includeReleaseNotes, _options_review_includeGithubIssues, _options_review_commitHistoryLimit, _options_review_diffHistoryLimit, _options_review_releaseNotesLimit, _options_review_githubIssuesLimit, _options_review_sendit, _options_publish_mergeMethod, _options_publish_requiredEnvVars, _options_publish_linkWorkspacePackages, _options_publish_unlinkWorkspacePackages, _options_link_scopeRoots, _options_link_workspaceFile, _options_link_dryRun, _options_excludedPatterns;
+    // Skip config directory validation since Cardigantime handles hierarchical lookup
+    // Ensure all required fields are present and have correct types after merging
+    const finalConfig = {
+        dryRun: (_options_dryRun = options.dryRun) !== null && _options_dryRun !== void 0 ? _options_dryRun : KODRDRIV_DEFAULTS.dryRun,
+        verbose: (_options_verbose = options.verbose) !== null && _options_verbose !== void 0 ? _options_verbose : KODRDRIV_DEFAULTS.verbose,
+        debug: (_options_debug = options.debug) !== null && _options_debug !== void 0 ? _options_debug : KODRDRIV_DEFAULTS.debug,
+        overrides: (_options_overrides = options.overrides) !== null && _options_overrides !== void 0 ? _options_overrides : KODRDRIV_DEFAULTS.overrides,
+        model: (_options_model = options.model) !== null && _options_model !== void 0 ? _options_model : KODRDRIV_DEFAULTS.model,
+        contextDirectories: contextDirectories,
+        configDirectory: configDir,
+        outputDirectory: (_options_outputDirectory = options.outputDirectory) !== null && _options_outputDirectory !== void 0 ? _options_outputDirectory : KODRDRIV_DEFAULTS.outputDirectory,
+        preferencesDirectory: (_options_preferencesDirectory = options.preferencesDirectory) !== null && _options_preferencesDirectory !== void 0 ? _options_preferencesDirectory : KODRDRIV_DEFAULTS.preferencesDirectory,
+        // Cardigantime-specific properties (from fileValues or defaults)
+        discoveredConfigDirs: (_options_discoveredConfigDirs = options.discoveredConfigDirs) !== null && _options_discoveredConfigDirs !== void 0 ? _options_discoveredConfigDirs : [],
+        resolvedConfigDirs: (_options_resolvedConfigDirs = options.resolvedConfigDirs) !== null && _options_resolvedConfigDirs !== void 0 ? _options_resolvedConfigDirs : [],
+        // Command-specific options with defaults
+        commit: {
+            add: (_options_commit_add = (_options_commit = options.commit) === null || _options_commit === void 0 ? void 0 : _options_commit.add) !== null && _options_commit_add !== void 0 ? _options_commit_add : KODRDRIV_DEFAULTS.commit.add,
+            cached: (_options_commit_cached = (_options_commit1 = options.commit) === null || _options_commit1 === void 0 ? void 0 : _options_commit1.cached) !== null && _options_commit_cached !== void 0 ? _options_commit_cached : KODRDRIV_DEFAULTS.commit.cached,
+            sendit: (_options_commit_sendit = (_options_commit2 = options.commit) === null || _options_commit2 === void 0 ? void 0 : _options_commit2.sendit) !== null && _options_commit_sendit !== void 0 ? _options_commit_sendit : KODRDRIV_DEFAULTS.commit.sendit,
+            messageLimit: (_options_commit_messageLimit = (_options_commit3 = options.commit) === null || _options_commit3 === void 0 ? void 0 : _options_commit3.messageLimit) !== null && _options_commit_messageLimit !== void 0 ? _options_commit_messageLimit : KODRDRIV_DEFAULTS.commit.messageLimit,
+            context: (_options_commit4 = options.commit) === null || _options_commit4 === void 0 ? void 0 : _options_commit4.context,
+            direction: (_options_commit5 = options.commit) === null || _options_commit5 === void 0 ? void 0 : _options_commit5.direction
+        },
+        audioCommit: {
+            maxRecordingTime: (_options_audioCommit_maxRecordingTime = (_options_audioCommit = options.audioCommit) === null || _options_audioCommit === void 0 ? void 0 : _options_audioCommit.maxRecordingTime) !== null && _options_audioCommit_maxRecordingTime !== void 0 ? _options_audioCommit_maxRecordingTime : KODRDRIV_DEFAULTS.audioCommit.maxRecordingTime,
+            audioDevice: (_options_audioCommit_audioDevice = (_options_audioCommit1 = options.audioCommit) === null || _options_audioCommit1 === void 0 ? void 0 : _options_audioCommit1.audioDevice) !== null && _options_audioCommit_audioDevice !== void 0 ? _options_audioCommit_audioDevice : KODRDRIV_DEFAULTS.audioCommit.audioDevice,
+            file: (_options_audioCommit2 = options.audioCommit) === null || _options_audioCommit2 === void 0 ? void 0 : _options_audioCommit2.file,
+            keepTemp: (_options_audioCommit3 = options.audioCommit) === null || _options_audioCommit3 === void 0 ? void 0 : _options_audioCommit3.keepTemp
+        },
+        release: {
+            from: (_options_release_from = (_options_release = options.release) === null || _options_release === void 0 ? void 0 : _options_release.from) !== null && _options_release_from !== void 0 ? _options_release_from : KODRDRIV_DEFAULTS.release.from,
+            to: (_options_release_to = (_options_release1 = options.release) === null || _options_release1 === void 0 ? void 0 : _options_release1.to) !== null && _options_release_to !== void 0 ? _options_release_to : KODRDRIV_DEFAULTS.release.to,
+            messageLimit: (_options_release_messageLimit = (_options_release2 = options.release) === null || _options_release2 === void 0 ? void 0 : _options_release2.messageLimit) !== null && _options_release_messageLimit !== void 0 ? _options_release_messageLimit : KODRDRIV_DEFAULTS.release.messageLimit,
+            context: (_options_release3 = options.release) === null || _options_release3 === void 0 ? void 0 : _options_release3.context
+        },
+        audioReview: {
+            includeCommitHistory: (_options_audioReview_includeCommitHistory = (_options_audioReview = options.audioReview) === null || _options_audioReview === void 0 ? void 0 : _options_audioReview.includeCommitHistory) !== null && _options_audioReview_includeCommitHistory !== void 0 ? _options_audioReview_includeCommitHistory : KODRDRIV_DEFAULTS.audioReview.includeCommitHistory,
+            includeRecentDiffs: (_options_audioReview_includeRecentDiffs = (_options_audioReview1 = options.audioReview) === null || _options_audioReview1 === void 0 ? void 0 : _options_audioReview1.includeRecentDiffs) !== null && _options_audioReview_includeRecentDiffs !== void 0 ? _options_audioReview_includeRecentDiffs : KODRDRIV_DEFAULTS.audioReview.includeRecentDiffs,
+            includeReleaseNotes: (_options_audioReview_includeReleaseNotes = (_options_audioReview2 = options.audioReview) === null || _options_audioReview2 === void 0 ? void 0 : _options_audioReview2.includeReleaseNotes) !== null && _options_audioReview_includeReleaseNotes !== void 0 ? _options_audioReview_includeReleaseNotes : KODRDRIV_DEFAULTS.audioReview.includeReleaseNotes,
+            includeGithubIssues: (_options_audioReview_includeGithubIssues = (_options_audioReview3 = options.audioReview) === null || _options_audioReview3 === void 0 ? void 0 : _options_audioReview3.includeGithubIssues) !== null && _options_audioReview_includeGithubIssues !== void 0 ? _options_audioReview_includeGithubIssues : KODRDRIV_DEFAULTS.audioReview.includeGithubIssues,
+            commitHistoryLimit: (_options_audioReview_commitHistoryLimit = (_options_audioReview4 = options.audioReview) === null || _options_audioReview4 === void 0 ? void 0 : _options_audioReview4.commitHistoryLimit) !== null && _options_audioReview_commitHistoryLimit !== void 0 ? _options_audioReview_commitHistoryLimit : KODRDRIV_DEFAULTS.audioReview.commitHistoryLimit,
+            diffHistoryLimit: (_options_audioReview_diffHistoryLimit = (_options_audioReview5 = options.audioReview) === null || _options_audioReview5 === void 0 ? void 0 : _options_audioReview5.diffHistoryLimit) !== null && _options_audioReview_diffHistoryLimit !== void 0 ? _options_audioReview_diffHistoryLimit : KODRDRIV_DEFAULTS.audioReview.diffHistoryLimit,
+            releaseNotesLimit: (_options_audioReview_releaseNotesLimit = (_options_audioReview6 = options.audioReview) === null || _options_audioReview6 === void 0 ? void 0 : _options_audioReview6.releaseNotesLimit) !== null && _options_audioReview_releaseNotesLimit !== void 0 ? _options_audioReview_releaseNotesLimit : KODRDRIV_DEFAULTS.audioReview.releaseNotesLimit,
+            githubIssuesLimit: (_options_audioReview_githubIssuesLimit = (_options_audioReview7 = options.audioReview) === null || _options_audioReview7 === void 0 ? void 0 : _options_audioReview7.githubIssuesLimit) !== null && _options_audioReview_githubIssuesLimit !== void 0 ? _options_audioReview_githubIssuesLimit : KODRDRIV_DEFAULTS.audioReview.githubIssuesLimit,
+            context: (_options_audioReview8 = options.audioReview) === null || _options_audioReview8 === void 0 ? void 0 : _options_audioReview8.context,
+            sendit: (_options_audioReview_sendit = (_options_audioReview9 = options.audioReview) === null || _options_audioReview9 === void 0 ? void 0 : _options_audioReview9.sendit) !== null && _options_audioReview_sendit !== void 0 ? _options_audioReview_sendit : KODRDRIV_DEFAULTS.audioReview.sendit,
+            maxRecordingTime: (_options_audioReview_maxRecordingTime = (_options_audioReview10 = options.audioReview) === null || _options_audioReview10 === void 0 ? void 0 : _options_audioReview10.maxRecordingTime) !== null && _options_audioReview_maxRecordingTime !== void 0 ? _options_audioReview_maxRecordingTime : KODRDRIV_DEFAULTS.audioReview.maxRecordingTime,
+            audioDevice: (_options_audioReview_audioDevice = (_options_audioReview11 = options.audioReview) === null || _options_audioReview11 === void 0 ? void 0 : _options_audioReview11.audioDevice) !== null && _options_audioReview_audioDevice !== void 0 ? _options_audioReview_audioDevice : KODRDRIV_DEFAULTS.audioReview.audioDevice,
+            file: (_options_audioReview12 = options.audioReview) === null || _options_audioReview12 === void 0 ? void 0 : _options_audioReview12.file,
+            keepTemp: (_options_audioReview13 = options.audioReview) === null || _options_audioReview13 === void 0 ? void 0 : _options_audioReview13.keepTemp
+        },
+        review: {
+            includeCommitHistory: (_options_review_includeCommitHistory = (_options_review = options.review) === null || _options_review === void 0 ? void 0 : _options_review.includeCommitHistory) !== null && _options_review_includeCommitHistory !== void 0 ? _options_review_includeCommitHistory : KODRDRIV_DEFAULTS.review.includeCommitHistory,
+            includeRecentDiffs: (_options_review_includeRecentDiffs = (_options_review1 = options.review) === null || _options_review1 === void 0 ? void 0 : _options_review1.includeRecentDiffs) !== null && _options_review_includeRecentDiffs !== void 0 ? _options_review_includeRecentDiffs : KODRDRIV_DEFAULTS.review.includeRecentDiffs,
+            includeReleaseNotes: (_options_review_includeReleaseNotes = (_options_review2 = options.review) === null || _options_review2 === void 0 ? void 0 : _options_review2.includeReleaseNotes) !== null && _options_review_includeReleaseNotes !== void 0 ? _options_review_includeReleaseNotes : KODRDRIV_DEFAULTS.review.includeReleaseNotes,
+            includeGithubIssues: (_options_review_includeGithubIssues = (_options_review3 = options.review) === null || _options_review3 === void 0 ? void 0 : _options_review3.includeGithubIssues) !== null && _options_review_includeGithubIssues !== void 0 ? _options_review_includeGithubIssues : KODRDRIV_DEFAULTS.review.includeGithubIssues,
+            commitHistoryLimit: (_options_review_commitHistoryLimit = (_options_review4 = options.review) === null || _options_review4 === void 0 ? void 0 : _options_review4.commitHistoryLimit) !== null && _options_review_commitHistoryLimit !== void 0 ? _options_review_commitHistoryLimit : KODRDRIV_DEFAULTS.review.commitHistoryLimit,
+            diffHistoryLimit: (_options_review_diffHistoryLimit = (_options_review5 = options.review) === null || _options_review5 === void 0 ? void 0 : _options_review5.diffHistoryLimit) !== null && _options_review_diffHistoryLimit !== void 0 ? _options_review_diffHistoryLimit : KODRDRIV_DEFAULTS.review.diffHistoryLimit,
+            releaseNotesLimit: (_options_review_releaseNotesLimit = (_options_review6 = options.review) === null || _options_review6 === void 0 ? void 0 : _options_review6.releaseNotesLimit) !== null && _options_review_releaseNotesLimit !== void 0 ? _options_review_releaseNotesLimit : KODRDRIV_DEFAULTS.review.releaseNotesLimit,
+            githubIssuesLimit: (_options_review_githubIssuesLimit = (_options_review7 = options.review) === null || _options_review7 === void 0 ? void 0 : _options_review7.githubIssuesLimit) !== null && _options_review_githubIssuesLimit !== void 0 ? _options_review_githubIssuesLimit : KODRDRIV_DEFAULTS.review.githubIssuesLimit,
+            context: (_options_review8 = options.review) === null || _options_review8 === void 0 ? void 0 : _options_review8.context,
+            sendit: (_options_review_sendit = (_options_review9 = options.review) === null || _options_review9 === void 0 ? void 0 : _options_review9.sendit) !== null && _options_review_sendit !== void 0 ? _options_review_sendit : KODRDRIV_DEFAULTS.review.sendit,
+            note: (_options_review10 = options.review) === null || _options_review10 === void 0 ? void 0 : _options_review10.note
+        },
+        publish: {
+            mergeMethod: (_options_publish_mergeMethod = (_options_publish = options.publish) === null || _options_publish === void 0 ? void 0 : _options_publish.mergeMethod) !== null && _options_publish_mergeMethod !== void 0 ? _options_publish_mergeMethod : KODRDRIV_DEFAULTS.publish.mergeMethod,
+            dependencyUpdatePatterns: (_options_publish1 = options.publish) === null || _options_publish1 === void 0 ? void 0 : _options_publish1.dependencyUpdatePatterns,
+            requiredEnvVars: (_options_publish_requiredEnvVars = (_options_publish2 = options.publish) === null || _options_publish2 === void 0 ? void 0 : _options_publish2.requiredEnvVars) !== null && _options_publish_requiredEnvVars !== void 0 ? _options_publish_requiredEnvVars : KODRDRIV_DEFAULTS.publish.requiredEnvVars,
+            linkWorkspacePackages: (_options_publish_linkWorkspacePackages = (_options_publish3 = options.publish) === null || _options_publish3 === void 0 ? void 0 : _options_publish3.linkWorkspacePackages) !== null && _options_publish_linkWorkspacePackages !== void 0 ? _options_publish_linkWorkspacePackages : KODRDRIV_DEFAULTS.publish.linkWorkspacePackages,
+            unlinkWorkspacePackages: (_options_publish_unlinkWorkspacePackages = (_options_publish4 = options.publish) === null || _options_publish4 === void 0 ? void 0 : _options_publish4.unlinkWorkspacePackages) !== null && _options_publish_unlinkWorkspacePackages !== void 0 ? _options_publish_unlinkWorkspacePackages : KODRDRIV_DEFAULTS.publish.unlinkWorkspacePackages
+        },
+        link: {
+            scopeRoots: (_options_link_scopeRoots = (_options_link = options.link) === null || _options_link === void 0 ? void 0 : _options_link.scopeRoots) !== null && _options_link_scopeRoots !== void 0 ? _options_link_scopeRoots : KODRDRIV_DEFAULTS.link.scopeRoots,
+            workspaceFile: (_options_link_workspaceFile = (_options_link1 = options.link) === null || _options_link1 === void 0 ? void 0 : _options_link1.workspaceFile) !== null && _options_link_workspaceFile !== void 0 ? _options_link_workspaceFile : KODRDRIV_DEFAULTS.link.workspaceFile,
+            dryRun: (_options_link_dryRun = (_options_link2 = options.link) === null || _options_link2 === void 0 ? void 0 : _options_link2.dryRun) !== null && _options_link_dryRun !== void 0 ? _options_link_dryRun : KODRDRIV_DEFAULTS.link.dryRun
+        },
+        excludedPatterns: (_options_excludedPatterns = options.excludedPatterns) !== null && _options_excludedPatterns !== void 0 ? _options_excludedPatterns : KODRDRIV_DEFAULTS.excludedPatterns
+    };
+    // Final validation against the MainConfig shape (optional, cardigantime might handle it)
+    // You could potentially use ConfigShape.parse(finalConfig) here if needed
+    return finalConfig;
+}
+// Export for testing
+function validateCommand(commandName) {
+    if (!ALLOWED_COMMANDS.includes(commandName)) {
+        throw new Error(`Invalid command: ${commandName}, allowed commands: ${ALLOWED_COMMANDS.join(', ')}`);
+    }
+    return commandName;
+}
+// Export for testing
+async function validateContextDirectories(contextDirectories) {
+    const logger = getLogger();
+    const storage = create({
+        log: logger.info
+    });
+    // Filter out directories that don't exist
+    const validDirectories = [];
+    for (const dir of contextDirectories){
+        try {
+            if (await storage.isDirectoryReadable(dir)) {
+                validDirectories.push(dir);
+            } else {
+                logger.warn(`Directory not readable: ${dir}`);
+            }
+        } catch (error) {
+            logger.warn(`Error validating directory ${dir}: ${error.message}`);
+        }
+    }
+    return validDirectories;
+}
+
+export { configure, getCliConfig, transformCliArgs, validateAndProcessOptions, validateAndProcessSecureOptions, validateCommand, validateContextDirectories };
+//# sourceMappingURL=arguments.js.map