@eldrforge/kodrdriv 0.0.14 → 0.0.17

package/README.md

@@ -121,12 +121,4 @@ Apache-2.0 - see [LICENSE](LICENSE) file for details.
 
 ## About the Name
 
-Ski carving and efficient software development have a lot in common. Carving uses edge control to follow a smooth, energy-efficient arc — just like automation uses clean, repeatable scripts to replace manual work. Both are about flow: linking turns or commits without hesitation. As carving unlocks speed and control, automation unlocks scalability and momentum. The result is clean tracks — razor-thin arcs on snow, or tidy diffs in code. And when you've mastered your craft, you don't stop to think about your last move. Your code leaves a clean trail — and your commit message can be automated straight from the diff.
-
-
-
-
-
-
-
-
+Like Thor's hammer, this tool smashes through your repetitive coding tasks. But unlike Mjölnir, it won't make you worthy — it'll just make you faster. Strike through commits, forge releases, and channel the lightning of AI to automate your workflow. Because sometimes you need a hammer, and sometimes you need a tool that actually works.

package/dist/arguments.js

@@ -1,8 +1,9 @@
 import { Command } from 'commander';
 import { z } from 'zod';
-import { PROGRAM_NAME, VERSION, KODRDRIV_DEFAULTS, ALLOWED_COMMANDS, DEFAULT_COMMAND, DEFAULT_CHARACTER_ENCODING, DEFAULT_INSTRUCTIONS_DIR } from './constants.js';
+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(),
@@ -11,11 +12,11 @@ z.object({
     overrides: z.boolean().optional(),
     checkConfig: z.boolean().optional(),
     initConfig: z.boolean().optional(),
-    openaiApiKey: z.string().optional(),
     model: z.string().optional(),
     contextDirectories: z.array(z.string()).optional(),
-    instructions: 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(),
@@ -23,6 +24,8 @@ z.object({
     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',
@@ -38,7 +41,9 @@ z.object({
     commitHistoryLimit: z.number().optional(),
     diffHistoryLimit: z.number().optional(),
     releaseNotesLimit: z.number().optional(),
-    githubIssuesLimit: 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)=>{
@@ -50,9 +55,12 @@ const transformCliArgs = (finalCliArgs)=>{
     if (finalCliArgs.overrides !== undefined) transformedCliArgs.overrides = finalCliArgs.overrides;
     if (finalCliArgs.model !== undefined) transformedCliArgs.model = finalCliArgs.model;
     if (finalCliArgs.contextDirectories !== undefined) transformedCliArgs.contextDirectories = finalCliArgs.contextDirectories;
-    if (finalCliArgs.instructions !== undefined) transformedCliArgs.instructions = finalCliArgs.instructions;
     // 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 = {};
@@ -61,6 +69,13 @@ const transformCliArgs = (finalCliArgs)=>{
         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) {
@@ -81,7 +96,6 @@ const transformCliArgs = (finalCliArgs)=>{
         if (finalCliArgs.scopeRoots !== undefined) {
             try {
                 transformedCliArgs.link.scopeRoots = JSON.parse(finalCliArgs.scopeRoots);
-            // eslint-disable-next-line @typescript-eslint/no-unused-vars
             } catch (error) {
                 throw new Error(`Invalid JSON for scope-roots: ${finalCliArgs.scopeRoots}`);
             }
@@ -89,7 +103,7 @@ const transformCliArgs = (finalCliArgs)=>{
         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) {
+    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;
@@ -99,12 +113,29 @@ const transformCliArgs = (finalCliArgs)=>{
         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;
-        // Only add context and sendit if we already have an audioReview object from the specific properties above
         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: finalCliArgs.openaiApiKey is intentionally omitted here as it belongs to SecureConfig
+    // Note: openaiApiKey is handled separately via environment variable only
     return transformedCliArgs;
 };
 // Update configure signature to accept cardigantime
@@ -160,7 +191,7 @@ const configure = async (cardigantime)=>{
         ];
     }
     // Get CLI arguments using the new function
-    const [finalCliArgs, commandConfig] = getCliConfig(program);
+    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);
@@ -190,6 +221,7 @@ const configure = async (cardigantime)=>{
     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(', ')}`);
@@ -206,18 +238,92 @@ const configure = async (cardigantime)=>{
     ];
 };
 // Function to handle CLI argument parsing and processing
-function getCliConfig(program) {
+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('-i, --instructions <file>', 'instructions for the AI').option('--config-dir <configDir>', 'configuration directory') // Keep config-dir for specifying location
-        .option('--excluded-paths [excludedPatterns...]', 'paths to exclude from the diff');
+        .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').option('--cached', 'use cached diff').option('--add', 'add all changes before committing').option('--sendit', 'Commit with the message generated. No review.').option('--context <context>', 'context for the commit message').option('--message-limit <messageLimit>', 'limit the number of messages to generate').description('Generate commit notes');
+    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);
-    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('--message-limit <messageLimit>', 'limit the number of messages to generate').description('Record audio to provide context, then generate and optionally commit with AI-generated message');
+    // 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);
@@ -227,10 +333,135 @@ function getCliConfig(program) {
     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('--sendit', 'Create GitHub issues automatically without confirmation').description('Record audio, transcribe with Whisper, and analyze for project issues using AI');
+    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
@@ -244,6 +475,16 @@ function getCliConfig(program) {
     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) {
@@ -256,8 +497,22 @@ function getCliConfig(program) {
             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
@@ -278,7 +533,7 @@ async function validateAndProcessSecureOptions() {
     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, set OPENAI_API_KEY environment variable or provide --openai-api-key');
+        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;
@@ -289,12 +544,10 @@ async function validateAndProcessSecureOptions() {
 }
 // Renamed validation function to reflect its broader role
 async function validateAndProcessOptions(options) {
-    var _options_commit, _options_commit1, _options_commit2, _options_commit3, _options_commit4, _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_publish, _options_publish1, _options_publish2, _options_link, _options_link1, _options_link2;
+    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 instructionsPathOrContent = options.instructions || KODRDRIV_DEFAULTS.instructions;
-    const instructions = await validateAndReadInstructions(instructionsPathOrContent);
     const configDir = options.configDirectory || KODRDRIV_DEFAULTS.configDirectory;
-    var _options_dryRun, _options_verbose, _options_debug, _options_overrides, _options_model, _options_commit_add, _options_commit_cached, _options_commit_sendit, _options_commit_messageLimit, _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_publish_mergeMethod, _options_publish_requiredEnvVars, _options_link_scopeRoots, _options_link_workspaceFile, _options_link_dryRun, _options_excludedPatterns;
+    var _options_dryRun, _options_verbose, _options_debug, _options_overrides, _options_model, _options_outputDirectory, _options_preferencesDirectory, _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 = {
@@ -303,16 +556,24 @@ async function validateAndProcessOptions(options) {
         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,
-        instructions: instructions,
         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,
         // 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
+            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,
@@ -330,12 +591,31 @@ async function validateAndProcessOptions(options) {
             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
+            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
+            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,
@@ -376,35 +656,6 @@ async function validateContextDirectories(contextDirectories) {
     }
     return validDirectories;
 }
-// Updated to handle reading the file content
-// Export for testing
-async function validateAndReadInstructions(instructionsPath) {
-    const logger = getLogger();
-    const storage = create({
-        log: logger.info
-    });
-    try {
-        // Assume it's a file path first
-        if (await storage.isFileReadable(instructionsPath)) {
-            logger.verbose(`Reading instructions from file: ${instructionsPath}`);
-            return storage.readFile(instructionsPath, DEFAULT_CHARACTER_ENCODING);
-        } else {
-            // If not a readable file, assume it might be the content itself (e.g., from config file)
-            logger.verbose(`Using provided instructions string directly.`);
-            return instructionsPath; // Return the string as is
-        }
-    } catch (error) {
-        logger.error('Error reading instructions file %s: %s', instructionsPath, error.message);
-        // Decide how to handle error: throw, return default, etc.
-        // Returning default for now, but might need adjustment
-        logger.warn('Falling back to default instructions path due to error.');
-        // Re-read the default file path if the provided one failed
-        if (await storage.isFileReadable(DEFAULT_INSTRUCTIONS_DIR)) {
-            return storage.readFile(DEFAULT_INSTRUCTIONS_DIR, DEFAULT_CHARACTER_ENCODING);
-        }
-        throw new Error(`Failed to read instructions from ${instructionsPath} or default location.`);
-    }
-}
 
-export { configure, getCliConfig, transformCliArgs, validateAndProcessOptions, validateAndProcessSecureOptions, validateAndReadInstructions, validateCommand, validateContextDirectories };
+export { configure, getCliConfig, transformCliArgs, validateAndProcessOptions, validateAndProcessSecureOptions, validateCommand, validateContextDirectories };
 //# sourceMappingURL=arguments.js.map