@grunnverk/kodrdriv 1.3.0 → 1.5.1

package/temp-dist/arguments.js

@@ -1,817 +0,0 @@
-/* eslint-disable @typescript-eslint/no-unused-vars */
-import { Command } from "commander";
-import path from "path";
-import { z } from "zod";
-import { ALLOWED_COMMANDS, DEFAULT_COMMAND, KODRDRIV_DEFAULTS, PROGRAM_NAME, VERSION } from "./constants";
-import { getLogger } from "./logging";
-import * as Storage from "./util/storage";
-import { safeJsonParse } from './util/validation';
-import { readStdin } from "./util/stdin";
-export const InputSchema = 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(),
-    interactive: z.boolean().optional(),
-    from: z.string().optional(),
-    to: z.string().optional(),
-    excludedPatterns: z.array(z.string()).optional(),
-    excludedPaths: z.array(z.string()).optional(),
-    context: z.string().optional(),
-    note: z.string().optional(), // For review command positional argument/STDIN
-    direction: z.string().optional(),
-    messageLimit: z.number().optional(),
-    skipFileCheck: z.boolean().optional(),
-    maxDiffBytes: z.number().optional(),
-    mergeMethod: z.enum(['merge', 'squash', 'rebase']).optional(),
-    scopeRoots: z.string().optional(),
-    startFrom: z.string().optional(),
-    script: z.string().optional(),
-    cmd: z.string().optional(),
-    publish: z.boolean().optional(),
-    parallel: z.boolean().optional(),
-    continue: z.boolean().optional(),
-    includeCommitHistory: z.boolean().optional(),
-    includeRecentDiffs: z.boolean().optional(),
-    editorTimeout: z.number().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(), // Audio file path for audio-commit and audio-review
-    directory: z.string().optional(), // Add directory option at top level (for audio commands)
-    directories: z.array(z.string()).optional(), // Add directories option at top level (for tree commands)
-    keepTemp: z.boolean().optional(), // Keep temporary recording files
-});
-// Function to transform flat CLI args into nested Config structure
-export const transformCliArgs = (finalCliArgs, commandName) => {
-    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 || finalCliArgs.skipFileCheck !== undefined || finalCliArgs.maxDiffBytes !== undefined || finalCliArgs.interactive !== 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.interactive !== undefined)
-            transformedCliArgs.commit.interactive = finalCliArgs.interactive;
-        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;
-        if (finalCliArgs.skipFileCheck !== undefined)
-            transformedCliArgs.commit.skipFileCheck = finalCliArgs.skipFileCheck;
-        if (finalCliArgs.maxDiffBytes !== undefined)
-            transformedCliArgs.commit.maxDiffBytes = finalCliArgs.maxDiffBytes;
-    }
-    // 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 || finalCliArgs.maxDiffBytes !== undefined || finalCliArgs.interactive !== 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.interactive !== undefined)
-            transformedCliArgs.release.interactive = finalCliArgs.interactive;
-        if (finalCliArgs.messageLimit !== undefined)
-            transformedCliArgs.release.messageLimit = finalCliArgs.messageLimit;
-        if (finalCliArgs.maxDiffBytes !== undefined)
-            transformedCliArgs.release.maxDiffBytes = finalCliArgs.maxDiffBytes;
-    }
-    // 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) {
-        transformedCliArgs.link = {};
-        if (finalCliArgs.scopeRoots !== undefined) {
-            try {
-                transformedCliArgs.link.scopeRoots = safeJsonParse(finalCliArgs.scopeRoots, 'scopeRoots CLI argument');
-            }
-            catch (error) {
-                throw new Error(`Invalid JSON for scope-roots: ${finalCliArgs.scopeRoots}`);
-            }
-        }
-    }
-    // Nested mappings for 'audio-review' options (only when it's not a tree command)
-    if (commandName !== 'tree' && (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.directories !== 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.directory !== undefined)
-            transformedCliArgs.audioReview.directory = finalCliArgs.directory;
-        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.editorTimeout !== undefined)
-            transformedCliArgs.review.editorTimeout = finalCliArgs.editorTimeout;
-    }
-    // Nested mappings for 'tree' options (add when relevant args present)
-    if (commandName === 'tree') {
-        const treeExcludedPatterns = finalCliArgs.excludedPatterns || finalCliArgs.excludedPaths;
-        const builtInCommand = finalCliArgs.builtInCommand;
-        if (finalCliArgs.directory !== undefined || finalCliArgs.directories !== undefined || treeExcludedPatterns !== undefined || finalCliArgs.startFrom !== undefined || finalCliArgs.cmd !== undefined || finalCliArgs.parallel !== undefined || builtInCommand !== undefined || finalCliArgs.continue !== undefined) {
-            transformedCliArgs.tree = {};
-            if (finalCliArgs.directories !== undefined)
-                transformedCliArgs.tree.directories = finalCliArgs.directories;
-            else if (finalCliArgs.directory !== undefined)
-                transformedCliArgs.tree.directories = [finalCliArgs.directory];
-            if (treeExcludedPatterns !== undefined)
-                transformedCliArgs.tree.excludedPatterns = treeExcludedPatterns;
-            if (finalCliArgs.startFrom !== undefined)
-                transformedCliArgs.tree.startFrom = finalCliArgs.startFrom;
-            if (finalCliArgs.cmd !== undefined)
-                transformedCliArgs.tree.cmd = finalCliArgs.cmd;
-            if (finalCliArgs.parallel !== undefined)
-                transformedCliArgs.tree.parallel = finalCliArgs.parallel;
-            if (builtInCommand !== undefined)
-                transformedCliArgs.tree.builtInCommand = builtInCommand;
-            if (finalCliArgs.continue !== undefined)
-                transformedCliArgs.tree.continue = finalCliArgs.continue;
-        }
-    }
-    // Handle excluded patterns (Commander.js converts --excluded-paths to excludedPaths)
-    const excludedPatterns = finalCliArgs.excludedPatterns || finalCliArgs.excludedPaths;
-    if (excludedPatterns !== undefined)
-        transformedCliArgs.excludedPatterns = excludedPatterns;
-    // Note: openaiApiKey is handled separately via environment variable only
-    return transformedCliArgs;
-};
-// Update configure signature to accept cardigantime
-export const configure = async (cardigantime) => {
-    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, commandConfig.commandName);
-    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, // Start with Kodrdriv defaults
-        ...fileValues, // Apply file values (overwrites defaults)
-        ...transformedCliArgs, // Apply CLI args last (highest precedence)
-        link: mergedLink, // Override with properly merged link section
-    }; // 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?.join(', ') || 'none'}`);
-    if (config.excludedPatterns && config.excludedPatterns.length > 0) {
-        logger.verbose(`  Excluded patterns: ${config.excludedPatterns.join(', ')}`);
-    }
-    if (Object.keys(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
-export 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('--interactive', 'Present commit message for interactive review and editing')
-        .option('--message-limit <messageLimit>', 'limit the number of messages to generate')
-        .option('--skip-file-check', 'skip check for file: dependencies before committing')
-        .option('--max-diff-bytes <maxDiffBytes>', 'maximum bytes per file in diff (default: 2048)');
-    // 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.'],
-                ['--interactive', 'Present commit message for interactive review and editing'],
-                ['--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')
-        .option('--interactive', 'Present release notes for interactive review and editing')
-        .option('--max-diff-bytes <maxDiffBytes>', 'maximum bytes per file in diff (default: 2048)')
-        .description('Generate release notes');
-    addSharedOptions(releaseCommand);
-    const publishCommand = program
-        .command('publish')
-        .option('--merge-method <method>', 'method to merge PR (merge, squash, rebase)', 'squash')
-        .option('--sendit', 'skip all confirmation prompts and proceed automatically')
-        .description('Publish a release');
-    addSharedOptions(publishCommand);
-    const treeCommand = program
-        .command('tree [command]')
-        .option('--directory <directory>', 'target directory containing multiple packages (defaults to current directory)')
-        .option('--directories [directories...]', 'target directories containing multiple packages (defaults to current directory)')
-        .option('--start-from <startFrom>', 'resume execution from this package directory name (useful for restarting failed builds)')
-        .option('--cmd <cmd>', 'shell command to execute in each package directory (e.g., "npm install", "git status")')
-        .option('--parallel', 'execute packages in parallel when dependencies allow (packages with no interdependencies run simultaneously)')
-        .option('--excluded-patterns [excludedPatterns...]', 'patterns to exclude packages from processing (e.g., "**/node_modules/**", "dist/*")')
-        .option('--continue', 'continue from previous tree publish execution')
-        .description('Analyze package dependencies in workspace and execute commands in dependency order. Supports built-in commands: commit, publish, link, unlink');
-    addSharedOptions(treeCommand);
-    const linkCommand = program
-        .command('link')
-        .option('--scope-roots <scopeRoots>', 'JSON mapping of scopes to root directories (e.g., \'{"@company": "../"}\')')
-        .description('Create npm file: dependencies for local development');
-    addSharedOptions(linkCommand);
-    const unlinkCommand = program
-        .command('unlink')
-        .option('--scope-roots <scopeRoots>', 'JSON mapping of scopes to root directories (e.g., \'{"@company": "../"}\')')
-        .description('Restore original dependencies and rebuild node_modules');
-    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')
-        .option('--directory <directory>', 'directory containing audio files to process')
-        .option('--max-recording-time <time>', 'maximum recording time in seconds', parseInt)
-        .option('--sendit', 'Create GitHub issues automatically without confirmation')
-        .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')
-        .option('--editor-timeout <timeout>', 'timeout for editor in milliseconds (default: no timeout)', parseInt)
-        .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 === 'tree' && treeCommand.opts) {
-            commandOptions = treeCommand.opts();
-            // Handle positional argument for built-in command
-            const args = treeCommand.args;
-            if (args && args.length > 0 && args[0]) {
-                // Store the built-in command for later processing
-                commandOptions.builtInCommand = args[0];
-            }
-        }
-        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 };
-    // Debug logging to help troubleshoot configuration issues
-    const logger = getLogger();
-    logger.debug('CLI parsing debug:');
-    logger.debug('  cliArgs:', JSON.stringify(cliArgs, null, 2));
-    logger.debug('  commandOptions:', JSON.stringify(commandOptions, null, 2));
-    logger.debug('  finalCliArgs:', JSON.stringify(finalCliArgs, null, 2));
-    logger.debug('  commandName:', commandName);
-    return [finalCliArgs, commandConfig];
-}
-export 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
-export async function validateAndProcessOptions(options) {
-    const contextDirectories = await validateContextDirectories(options.contextDirectories || KODRDRIV_DEFAULTS.contextDirectories);
-    const configDir = options.configDirectory || KODRDRIV_DEFAULTS.configDirectory;
-    // 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 ?? KODRDRIV_DEFAULTS.dryRun,
-        verbose: options.verbose ?? KODRDRIV_DEFAULTS.verbose,
-        debug: options.debug ?? KODRDRIV_DEFAULTS.debug,
-        overrides: options.overrides ?? KODRDRIV_DEFAULTS.overrides,
-        model: options.model ?? KODRDRIV_DEFAULTS.model,
-        contextDirectories: contextDirectories,
-        configDirectory: configDir,
-        outputDirectory: options.outputDirectory ?? KODRDRIV_DEFAULTS.outputDirectory,
-        preferencesDirectory: options.preferencesDirectory ?? KODRDRIV_DEFAULTS.preferencesDirectory,
-        // Cardigantime-specific properties (from fileValues or defaults)
-        discoveredConfigDirs: options.discoveredConfigDirs ?? [],
-        resolvedConfigDirs: options.resolvedConfigDirs ?? [],
-        // Command-specific options with defaults
-        commit: {
-            add: options.commit?.add ?? KODRDRIV_DEFAULTS.commit.add,
-            cached: options.commit?.cached ?? KODRDRIV_DEFAULTS.commit.cached, // Might be undefined if not commit command
-            sendit: options.commit?.sendit ?? KODRDRIV_DEFAULTS.commit.sendit,
-            interactive: options.commit?.interactive ?? KODRDRIV_DEFAULTS.commit.interactive,
-            messageLimit: options.commit?.messageLimit ?? KODRDRIV_DEFAULTS.commit.messageLimit,
-            context: options.commit?.context,
-            direction: options.commit?.direction,
-            skipFileCheck: options.commit?.skipFileCheck ?? KODRDRIV_DEFAULTS.commit.skipFileCheck,
-            maxDiffBytes: options.commit?.maxDiffBytes ?? KODRDRIV_DEFAULTS.commit.maxDiffBytes,
-        },
-        audioCommit: {
-            maxRecordingTime: options.audioCommit?.maxRecordingTime ?? KODRDRIV_DEFAULTS.audioCommit.maxRecordingTime,
-            audioDevice: options.audioCommit?.audioDevice ?? KODRDRIV_DEFAULTS.audioCommit.audioDevice,
-            file: options.audioCommit?.file,
-            keepTemp: options.audioCommit?.keepTemp,
-        },
-        release: {
-            from: options.release?.from ?? KODRDRIV_DEFAULTS.release.from,
-            to: options.release?.to ?? KODRDRIV_DEFAULTS.release.to,
-            messageLimit: options.release?.messageLimit ?? KODRDRIV_DEFAULTS.release.messageLimit,
-            context: options.release?.context,
-            interactive: options.release?.interactive ?? KODRDRIV_DEFAULTS.release.interactive,
-            maxDiffBytes: options.release?.maxDiffBytes ?? KODRDRIV_DEFAULTS.release.maxDiffBytes,
-        },
-        audioReview: {
-            includeCommitHistory: options.audioReview?.includeCommitHistory ?? KODRDRIV_DEFAULTS.audioReview.includeCommitHistory,
-            includeRecentDiffs: options.audioReview?.includeRecentDiffs ?? KODRDRIV_DEFAULTS.audioReview.includeRecentDiffs,
-            includeReleaseNotes: options.audioReview?.includeReleaseNotes ?? KODRDRIV_DEFAULTS.audioReview.includeReleaseNotes,
-            includeGithubIssues: options.audioReview?.includeGithubIssues ?? KODRDRIV_DEFAULTS.audioReview.includeGithubIssues,
-            commitHistoryLimit: options.audioReview?.commitHistoryLimit ?? KODRDRIV_DEFAULTS.audioReview.commitHistoryLimit,
-            diffHistoryLimit: options.audioReview?.diffHistoryLimit ?? KODRDRIV_DEFAULTS.audioReview.diffHistoryLimit,
-            releaseNotesLimit: options.audioReview?.releaseNotesLimit ?? KODRDRIV_DEFAULTS.audioReview.releaseNotesLimit,
-            githubIssuesLimit: options.audioReview?.githubIssuesLimit ?? KODRDRIV_DEFAULTS.audioReview.githubIssuesLimit,
-            context: options.audioReview?.context,
-            sendit: options.audioReview?.sendit ?? KODRDRIV_DEFAULTS.audioReview.sendit,
-            maxRecordingTime: options.audioReview?.maxRecordingTime ?? KODRDRIV_DEFAULTS.audioReview.maxRecordingTime,
-            audioDevice: options.audioReview?.audioDevice ?? KODRDRIV_DEFAULTS.audioReview.audioDevice,
-            file: options.audioReview?.file,
-            directory: options.audioReview?.directory,
-            keepTemp: options.audioReview?.keepTemp,
-        },
-        review: {
-            includeCommitHistory: options.review?.includeCommitHistory ?? KODRDRIV_DEFAULTS.review.includeCommitHistory,
-            includeRecentDiffs: options.review?.includeRecentDiffs ?? KODRDRIV_DEFAULTS.review.includeRecentDiffs,
-            includeReleaseNotes: options.review?.includeReleaseNotes ?? KODRDRIV_DEFAULTS.review.includeReleaseNotes,
-            includeGithubIssues: options.review?.includeGithubIssues ?? KODRDRIV_DEFAULTS.review.includeGithubIssues,
-            commitHistoryLimit: options.review?.commitHistoryLimit ?? KODRDRIV_DEFAULTS.review.commitHistoryLimit,
-            diffHistoryLimit: options.review?.diffHistoryLimit ?? KODRDRIV_DEFAULTS.review.diffHistoryLimit,
-            releaseNotesLimit: options.review?.releaseNotesLimit ?? KODRDRIV_DEFAULTS.review.releaseNotesLimit,
-            githubIssuesLimit: options.review?.githubIssuesLimit ?? KODRDRIV_DEFAULTS.review.githubIssuesLimit,
-            context: options.review?.context,
-            sendit: options.review?.sendit ?? KODRDRIV_DEFAULTS.review.sendit,
-            note: options.review?.note,
-            editorTimeout: options.review?.editorTimeout,
-        },
-        publish: {
-            mergeMethod: options.publish?.mergeMethod ?? KODRDRIV_DEFAULTS.publish.mergeMethod,
-            dependencyUpdatePatterns: options.publish?.dependencyUpdatePatterns,
-            requiredEnvVars: options.publish?.requiredEnvVars ?? KODRDRIV_DEFAULTS.publish.requiredEnvVars,
-            linkWorkspacePackages: options.publish?.linkWorkspacePackages ?? KODRDRIV_DEFAULTS.publish.linkWorkspacePackages,
-            unlinkWorkspacePackages: options.publish?.unlinkWorkspacePackages ?? KODRDRIV_DEFAULTS.publish.unlinkWorkspacePackages,
-            sendit: options.publish?.sendit ?? KODRDRIV_DEFAULTS.publish.sendit,
-        },
-        link: {
-            scopeRoots: options.link?.scopeRoots ?? KODRDRIV_DEFAULTS.link.scopeRoots,
-            dryRun: options.link?.dryRun ?? KODRDRIV_DEFAULTS.link.dryRun,
-        },
-        tree: {
-            directories: options.tree?.directories ?? KODRDRIV_DEFAULTS.tree.directories,
-            excludedPatterns: options.tree?.excludedPatterns ?? KODRDRIV_DEFAULTS.tree.excludedPatterns,
-            startFrom: options.tree?.startFrom ?? KODRDRIV_DEFAULTS.tree.startFrom,
-            cmd: options.tree?.cmd ?? KODRDRIV_DEFAULTS.tree.cmd,
-            parallel: options.tree?.parallel ?? KODRDRIV_DEFAULTS.tree.parallel,
-            builtInCommand: options.tree?.builtInCommand ?? KODRDRIV_DEFAULTS.tree.builtInCommand,
-            continue: options.tree?.continue ?? KODRDRIV_DEFAULTS.tree.continue,
-        },
-        excludedPatterns: 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
-export function validateCommand(commandName) {
-    if (!ALLOWED_COMMANDS.includes(commandName)) {
-        throw new Error(`Invalid command: ${commandName}, allowed commands: ${ALLOWED_COMMANDS.join(', ')}`);
-    }
-    return commandName;
-}
-export async function validateConfigDir(configDir) {
-    const logger = getLogger();
-    const storage = Storage.create({ log: logger.info });
-    // Make sure the config directory is absolute
-    const absoluteConfigDir = path.isAbsolute(configDir) ?
-        configDir :
-        path.resolve(process.cwd(), configDir);
-    try {
-        // Check if the path exists
-        if (!(await storage.exists(absoluteConfigDir))) {
-            // Directory doesn't exist, warn and fall back to defaults
-            logger.warn(`Config directory does not exist: ${absoluteConfigDir}. Using default configuration.`);
-            return absoluteConfigDir; // Return the path anyway, app will use defaults
-        }
-        // Path exists, check if it's a directory
-        if (!(await storage.isDirectory(absoluteConfigDir))) {
-            throw new Error(`Config directory is not a directory: ${absoluteConfigDir}`);
-        }
-        // Check if it's writable
-        if (!(await storage.isDirectoryWritable(absoluteConfigDir))) {
-            throw new Error(`Config directory is not writable: ${absoluteConfigDir}`);
-        }
-    }
-    catch (error) {
-        logger.error(`Failed to validate config directory: ${absoluteConfigDir}`, error);
-        throw new Error(`Failed to validate config directory: ${absoluteConfigDir}: ${error.message}`);
-    }
-    return absoluteConfigDir;
-}
-// Export for testing
-export async function validateContextDirectories(contextDirectories) {
-    const logger = getLogger();
-    const storage = 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;
-}