@eldrforge/kodrdriv 0.0.13 → 0.0.15

package/.kodrdriv/context/content.md

@@ -1 +1,7 @@
-KodrDriv is a tool that is designed to help automate the creation of commit messages and release notes.  It is also a tool that has been designed to support an opinionated approach to organizing related projects and conducting structured releases with Git.   This initial version focuses on pnpm and GitHub, but there are plans to expand coverage over time.
+KodrDriv is a tool that is designed to help automate the creation of commit messages and release notes.  It is also a tool that has been designed to support an opinionated approach to organizing related projects and conducting structured releases with Git.   This initial version focuses on pnpm and GitHub, but there are plans to expand coverage over time.
+
+KodrDriv is available as an module on npmjs.org under @eldrforge/kodrdriv
+
+The name sometimes sounds like "Coder Driv" or "Coder Riv" but that should be corrected to "KodrDriv"
+
+Same with the name of the scope "Elder Forge" or "Elderforth" should be corrected to "Edlrforge"

package/RELEASE_NOTES.md

@@ -0,0 +1,14 @@
+This release updates workspace management and CI deployment for projects using pnpm with an opinionated structure. The changes restore explicit workspace scoping and local package link overrides, improving multi-package development while streamlining documentation deployment.
+
+**Improvements**
+
+* Restored exclusions for the `docs` directory and local dependency overrides in `pnpm-workspace.yaml` to clarify project boundaries and enable local development workflows for core packages.
+* Simplified the `deploy-docs.yml` workflow by removing temporary renaming of the workspace file; documentation builds and deployments now work directly with the refined workspace configuration.
+
+**Why these changes matter:**
+
+* Empower clearer separation between core packages and documentation in the monorepo setup.
+* Align local development processes and CI deployment behavior.
+* Reduce special-casing and ad-hoc workarounds in documentation workflows.
+
+_No breaking changes or new features are introduced for end users._

package/dist/arguments.js

@@ -3,6 +3,7 @@ import { z } from 'zod';
 import { PROGRAM_NAME, VERSION, KODRDRIV_DEFAULTS, ALLOWED_COMMANDS, DEFAULT_COMMAND, DEFAULT_CHARACTER_ENCODING, DEFAULT_INSTRUCTIONS_DIR } 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(),
@@ -16,6 +17,7 @@ z.object({
     contextDirectories: z.array(z.string()).optional(),
     instructions: z.string().optional(),
     configDir: z.string().optional(),
+    outputDir: z.string().optional(),
     cached: z.boolean().optional(),
     add: z.boolean().optional(),
     sendit: z.boolean().optional(),
@@ -23,6 +25,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',
@@ -30,7 +34,16 @@ z.object({
         'rebase'
     ]).optional(),
     scopeRoots: z.string().optional(),
-    workspaceFile: z.string().optional()
+    workspaceFile: z.string().optional(),
+    includeCommitHistory: z.boolean().optional(),
+    includeRecentDiffs: z.boolean().optional(),
+    includeReleaseNotes: z.boolean().optional(),
+    includeGithubIssues: z.boolean().optional(),
+    commitHistoryLimit: z.number().optional(),
+    diffHistoryLimit: z.number().optional(),
+    releaseNotesLimit: z.number().optional(),
+    githubIssuesLimit: z.number().optional(),
+    selectAudioDevice: z.boolean().optional()
 });
 // Function to transform flat CLI args into nested Config structure
 const transformCliArgs = (finalCliArgs)=>{
@@ -45,6 +58,8 @@ const transformCliArgs = (finalCliArgs)=>{
     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;
     // Nested mappings for 'commit' options
     if (finalCliArgs.cached !== undefined || finalCliArgs.sendit !== undefined || finalCliArgs.add !== undefined) {
         transformedCliArgs.commit = {};
@@ -53,6 +68,12 @@ 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.selectAudioDevice !== undefined) {
+        transformedCliArgs.audioCommit = {};
+        transformedCliArgs.audioCommit.selectAudioDevice = finalCliArgs.selectAudioDevice;
     }
     // Nested mappings for 'release' options
     if (finalCliArgs.from !== undefined || finalCliArgs.to !== undefined) {
@@ -73,13 +94,43 @@ 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}`);
             }
         }
         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) {
+        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;
+        // 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;
+    }
+    // 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
     return transformedCliArgs;
@@ -137,7 +188,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);
@@ -167,6 +218,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(', ')}`);
@@ -183,17 +235,97 @@ 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('--output-dir <outputDir>', 'output directory for generated files').option('--excluded-paths [excludedPatterns...]', 'paths to exclude from the diff');
     };
     // 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);
+    // 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'
+                ],
+                [
+                    '-i, --instructions <file>',
+                    'instructions for the AI'
+                ],
+                [
+                    '--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);
+        }
+    });
+    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('--select-audio-device', 'interactively select audio device and save to configuration').description('Record audio to provide context, then generate and optionally commit with AI-generated message');
+    addSharedOptions(audioCommitCommand);
     const releaseCommand = program.command('release').option('--from <from>', 'branch to generate release notes from').option('--to <to>', 'branch to generate release notes to').option('--context <context>', 'context for the commit message').description('Generate release notes');
     addSharedOptions(releaseCommand);
     const publishCommand = program.command('publish').option('--merge-method <method>', 'method to merge PR (merge, squash, rebase)', 'squash').description('Publish a release');
@@ -202,6 +334,137 @@ 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');
+    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'
+                ],
+                [
+                    '-i, --instructions <file>',
+                    'instructions for the AI'
+                ],
+                [
+                    '--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);
+        }
+    });
+    const cleanCommand = program.command('clean').description('Remove the output directory and all generated files');
+    addSharedOptions(cleanCommand);
     program.parse();
     const cliArgs = program.opts(); // Get all opts initially
     // Determine which command is being run
@@ -215,6 +478,18 @@ 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) {
             commandOptions = releaseCommand.opts();
         } else if (commandName === 'publish' && publishCommand.opts) {
@@ -223,6 +498,22 @@ function getCliConfig(program) {
             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();
         }
     }
     // Include command name in CLI args for merging
@@ -254,12 +545,12 @@ 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_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_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_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_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_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_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_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_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 = {
@@ -271,13 +562,20 @@ async function validateAndProcessOptions(options) {
         instructions: instructions,
         contextDirectories: contextDirectories,
         configDirectory: configDir,
+        outputDirectory: (_options_outputDirectory = options.outputDirectory) !== null && _options_outputDirectory !== void 0 ? _options_outputDirectory : KODRDRIV_DEFAULTS.outputDirectory,
         // 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,
+            selectAudioDevice: (_options_audioCommit2 = options.audioCommit) === null || _options_audioCommit2 === void 0 ? void 0 : _options_audioCommit2.selectAudioDevice
         },
         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,
@@ -285,6 +583,31 @@ async function validateAndProcessOptions(options) {
             messageLimit: (_options_release_messageLimit = (_options_release2 = options.release) === null || _options_release2 === void 0 ? void 0 : _options_release2.messageLimit) !== null && _options_release_messageLimit !== void 0 ? _options_release_messageLimit : KODRDRIV_DEFAULTS.release.messageLimit,
             context: (_options_release3 = options.release) === null || _options_release3 === void 0 ? void 0 : _options_release3.context
         },
+        audioReview: {
+            includeCommitHistory: (_options_audioReview_includeCommitHistory = (_options_audioReview = options.audioReview) === null || _options_audioReview === void 0 ? void 0 : _options_audioReview.includeCommitHistory) !== null && _options_audioReview_includeCommitHistory !== void 0 ? _options_audioReview_includeCommitHistory : KODRDRIV_DEFAULTS.audioReview.includeCommitHistory,
+            includeRecentDiffs: (_options_audioReview_includeRecentDiffs = (_options_audioReview1 = options.audioReview) === null || _options_audioReview1 === void 0 ? void 0 : _options_audioReview1.includeRecentDiffs) !== null && _options_audioReview_includeRecentDiffs !== void 0 ? _options_audioReview_includeRecentDiffs : KODRDRIV_DEFAULTS.audioReview.includeRecentDiffs,
+            includeReleaseNotes: (_options_audioReview_includeReleaseNotes = (_options_audioReview2 = options.audioReview) === null || _options_audioReview2 === void 0 ? void 0 : _options_audioReview2.includeReleaseNotes) !== null && _options_audioReview_includeReleaseNotes !== void 0 ? _options_audioReview_includeReleaseNotes : KODRDRIV_DEFAULTS.audioReview.includeReleaseNotes,
+            includeGithubIssues: (_options_audioReview_includeGithubIssues = (_options_audioReview3 = options.audioReview) === null || _options_audioReview3 === void 0 ? void 0 : _options_audioReview3.includeGithubIssues) !== null && _options_audioReview_includeGithubIssues !== void 0 ? _options_audioReview_includeGithubIssues : KODRDRIV_DEFAULTS.audioReview.includeGithubIssues,
+            commitHistoryLimit: (_options_audioReview_commitHistoryLimit = (_options_audioReview4 = options.audioReview) === null || _options_audioReview4 === void 0 ? void 0 : _options_audioReview4.commitHistoryLimit) !== null && _options_audioReview_commitHistoryLimit !== void 0 ? _options_audioReview_commitHistoryLimit : KODRDRIV_DEFAULTS.audioReview.commitHistoryLimit,
+            diffHistoryLimit: (_options_audioReview_diffHistoryLimit = (_options_audioReview5 = options.audioReview) === null || _options_audioReview5 === void 0 ? void 0 : _options_audioReview5.diffHistoryLimit) !== null && _options_audioReview_diffHistoryLimit !== void 0 ? _options_audioReview_diffHistoryLimit : KODRDRIV_DEFAULTS.audioReview.diffHistoryLimit,
+            releaseNotesLimit: (_options_audioReview_releaseNotesLimit = (_options_audioReview6 = options.audioReview) === null || _options_audioReview6 === void 0 ? void 0 : _options_audioReview6.releaseNotesLimit) !== null && _options_audioReview_releaseNotesLimit !== void 0 ? _options_audioReview_releaseNotesLimit : KODRDRIV_DEFAULTS.audioReview.releaseNotesLimit,
+            githubIssuesLimit: (_options_audioReview_githubIssuesLimit = (_options_audioReview7 = options.audioReview) === null || _options_audioReview7 === void 0 ? void 0 : _options_audioReview7.githubIssuesLimit) !== null && _options_audioReview_githubIssuesLimit !== void 0 ? _options_audioReview_githubIssuesLimit : KODRDRIV_DEFAULTS.audioReview.githubIssuesLimit,
+            context: (_options_audioReview8 = options.audioReview) === null || _options_audioReview8 === void 0 ? void 0 : _options_audioReview8.context,
+            sendit: (_options_audioReview_sendit = (_options_audioReview9 = options.audioReview) === null || _options_audioReview9 === void 0 ? void 0 : _options_audioReview9.sendit) !== null && _options_audioReview_sendit !== void 0 ? _options_audioReview_sendit : KODRDRIV_DEFAULTS.audioReview.sendit
+        },
+        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,