@eldrforge/kodrdriv 0.0.13 → 0.0.15

package/dist/commands/audio-review.js

@@ -0,0 +1,677 @@
+#!/usr/bin/env node
+import path from 'path';
+import fs from 'fs/promises';
+import { getLogger } from '../logging.js';
+import { transcribeAudio } from '../util/openai.js';
+import { run } from '../util/child.js';
+import { DEFAULT_OUTPUT_DIRECTORY } from '../constants.js';
+import { getTimestampedAudioFilename, getOutputPath, getTimestampedTranscriptFilename } from '../util/general.js';
+import { create } from '../util/storage.js';
+import { execute as execute$1 } from './review.js';
+
+const detectBestAudioDevice = async ()=>{
+    try {
+        // Get list of audio devices - this command always "fails" but gives us the device list
+        try {
+            await run('ffmpeg -f avfoundation -list_devices true -i ""');
+        } catch (result) {
+            // ffmpeg returns error code but we get the device list in stderr
+            const output = result.stderr || result.stdout || '';
+            // Parse audio devices from output
+            const audioDevicesSection = output.split('AVFoundation audio devices:')[1];
+            if (!audioDevicesSection) return '1'; // Default fallback
+            const deviceLines = audioDevicesSection.split('\n').filter((line)=>line.includes('[') && line.includes(']')).map((line)=>line.trim());
+            // Prefer AirPods, then built-in microphone over virtual/external devices
+            const preferredDevices = [
+                'AirPods',
+                'MacBook Pro Microphone',
+                'MacBook Air Microphone',
+                'Built-in Microphone',
+                'Internal Microphone'
+            ];
+            for (const deviceLine of deviceLines){
+                for (const preferred of preferredDevices){
+                    if (deviceLine.toLowerCase().includes(preferred.toLowerCase())) {
+                        // Extract device index
+                        const match = deviceLine.match(/\[(\d+)\]/);
+                        if (match) {
+                            return match[1];
+                        }
+                    }
+                }
+            }
+        }
+        // If no preferred device found, use device 1 as default (usually better than 0)
+        return '1';
+    } catch (error) {
+        // Fallback to device 1
+        return '1';
+    }
+};
+const parseAudioDevices = async ()=>{
+    try {
+        try {
+            await run('ffmpeg -f avfoundation -list_devices true -i ""');
+        } catch (result) {
+            const output = result.stderr || result.stdout || '';
+            const audioDevicesSection = output.split('AVFoundation audio devices:')[1];
+            if (audioDevicesSection) {
+                const deviceLines = audioDevicesSection.split('\n').filter((line)=>line.includes('[') && line.includes(']')).map((line)=>line.trim());
+                return deviceLines.map((line)=>{
+                    const match = line.match(/\[(\d+)\]\s+(.+)/);
+                    if (match) {
+                        return {
+                            index: match[1],
+                            name: match[2]
+                        };
+                    }
+                    return null;
+                }).filter(Boolean);
+            }
+        }
+        return [];
+    } catch (error) {
+        return [];
+    }
+};
+const selectAudioDeviceInteractively = async (runConfig)=>{
+    const logger = getLogger();
+    logger.info('🎙️  Available audio devices:');
+    const devices = await parseAudioDevices();
+    if (devices.length === 0) {
+        logger.error('❌ No audio devices found. Make sure ffmpeg is installed and audio devices are available.');
+        return null;
+    }
+    // Display devices
+    devices.forEach((device, i)=>{
+        logger.info(`   ${i + 1}. [${device.index}] ${device.name}`);
+    });
+    logger.info('');
+    logger.info('📋 Select an audio device by entering its number (1-' + devices.length + '):');
+    return new Promise((resolve)=>{
+        // Set up keyboard input
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.setEncoding('utf8');
+        let inputBuffer = '';
+        const keyHandler = (key)=>{
+            const keyCode = key.charCodeAt(0);
+            if (keyCode === 13) {
+                const selectedIndex = parseInt(inputBuffer) - 1;
+                if (selectedIndex >= 0 && selectedIndex < devices.length) {
+                    const selectedDevice = devices[selectedIndex];
+                    logger.info(`✅ Selected: [${selectedDevice.index}] ${selectedDevice.name}`);
+                    // Save to configuration
+                    saveAudioDeviceToConfig(runConfig, selectedDevice.index, selectedDevice.name).then(()=>{
+                        logger.info('💾 Audio device saved to configuration');
+                    }).catch((error)=>{
+                        logger.warn('⚠️  Failed to save audio device to configuration: %s', error.message);
+                    });
+                    // Cleanup and resolve
+                    process.stdin.setRawMode(false);
+                    process.stdin.pause();
+                    process.stdin.removeListener('data', keyHandler);
+                    resolve(selectedDevice.index);
+                } else {
+                    logger.error('❌ Invalid selection. Please enter a number between 1 and ' + devices.length);
+                    inputBuffer = '';
+                    process.stdout.write('📋 Select an audio device: ');
+                }
+            } else if (keyCode === 3) {
+                logger.info('\n❌ Selection cancelled');
+                process.stdin.setRawMode(false);
+                process.stdin.pause();
+                process.stdin.removeListener('data', keyHandler);
+                resolve(null);
+            } else if (keyCode >= 48 && keyCode <= 57) {
+                inputBuffer += key;
+                process.stdout.write(key);
+            } else if (keyCode === 127) {
+                if (inputBuffer.length > 0) {
+                    inputBuffer = inputBuffer.slice(0, -1);
+                    process.stdout.write('\b \b');
+                }
+            }
+        };
+        process.stdin.on('data', keyHandler);
+        process.stdout.write('📋 Select an audio device: ');
+    });
+};
+const saveAudioDeviceToConfig = async (runConfig, deviceIndex, deviceName)=>{
+    const logger = getLogger();
+    const storage = create({
+        log: logger.info
+    });
+    try {
+        const configDir = runConfig.configDirectory || DEFAULT_OUTPUT_DIRECTORY;
+        await storage.ensureDirectory(configDir);
+        const configPath = getOutputPath(configDir, 'audio-config.json');
+        // Read existing config or create new one
+        let audioConfig = {};
+        try {
+            const existingConfig = await storage.readFile(configPath, 'utf-8');
+            audioConfig = JSON.parse(existingConfig);
+        } catch (error) {
+            // File doesn't exist or is invalid, start with empty config
+            audioConfig = {};
+        }
+        // Update audio device
+        audioConfig.audioDevice = deviceIndex;
+        audioConfig.audioDeviceName = deviceName;
+        audioConfig.lastUpdated = new Date().toISOString();
+        // Save updated config
+        await storage.writeFile(configPath, JSON.stringify(audioConfig, null, 2), 'utf-8');
+        logger.debug('Saved audio configuration to: %s', configPath);
+    } catch (error) {
+        logger.error('Failed to save audio configuration: %s', error.message);
+        throw error;
+    }
+};
+const loadAudioDeviceFromConfig = async (runConfig)=>{
+    const logger = getLogger();
+    const storage = create({
+        log: logger.info
+    });
+    try {
+        const configDir = runConfig.configDirectory || DEFAULT_OUTPUT_DIRECTORY;
+        const configPath = getOutputPath(configDir, 'audio-config.json');
+        const configContent = await storage.readFile(configPath, 'utf-8');
+        const audioConfig = JSON.parse(configContent);
+        if (audioConfig.audioDevice) {
+            logger.debug('Loaded audio device from config: [%s] %s', audioConfig.audioDevice, audioConfig.audioDeviceName || 'Unknown');
+            return audioConfig.audioDevice;
+        }
+        return null;
+    } catch (error) {
+        // Config file doesn't exist or is invalid
+        logger.debug('No saved audio device configuration found');
+        return null;
+    }
+};
+const listAudioDevices = async ()=>{
+    const logger = getLogger();
+    try {
+        try {
+            await run('ffmpeg -f avfoundation -list_devices true -i ""');
+        } catch (result) {
+            const output = result.stderr || result.stdout || '';
+            const audioDevicesSection = output.split('AVFoundation audio devices:')[1];
+            if (audioDevicesSection) {
+                logger.info('🎙️  Available audio devices:');
+                const deviceLines = audioDevicesSection.split('\n').filter((line)=>line.includes('[') && line.includes(']')).map((line)=>line.trim());
+                deviceLines.forEach((line)=>{
+                    const match = line.match(/\[(\d+)\]\s+(.+)/);
+                    if (match) {
+                        logger.info(`   [${match[1]}] ${match[2]}`);
+                    }
+                });
+            }
+        }
+    } catch (error) {
+        logger.debug('Could not list audio devices');
+    }
+};
+const execute = async (runConfig)=>{
+    var _runConfig_audioReview, _runConfig_audioReview1, _runConfig_audioReview2, _runConfig_audioReview3, _runConfig_audioReview4, _runConfig_audioReview5, _runConfig_audioReview6, _runConfig_audioReview7, _runConfig_audioReview8, _runConfig_audioReview9, _runConfig_audioReview10, _runConfig_review;
+    const logger = getLogger();
+    const isDryRun = runConfig.dryRun || false;
+    // Handle audio device selection if requested
+    if ((_runConfig_audioReview = runConfig.audioReview) === null || _runConfig_audioReview === void 0 ? void 0 : _runConfig_audioReview.selectAudioDevice) {
+        logger.info('🎛️  Starting audio device selection...');
+        const selectedDevice = await selectAudioDeviceInteractively(runConfig);
+        if (selectedDevice === null) {
+            logger.error('❌ Audio device selection cancelled or failed');
+            process.exit(1);
+        }
+        logger.info('✅ Audio device selection complete');
+        logger.info('');
+        logger.info('You can now run the audio-review command without --select-audio-device to use your saved device');
+        return 'Audio device configured successfully';
+    }
+    if (isDryRun) {
+        var _runConfig_review1;
+        logger.info('DRY RUN: Would start audio recording for review context');
+        logger.info('DRY RUN: Would transcribe audio and use as context for review analysis');
+        logger.info('DRY RUN: Would then delegate to regular review command');
+        // In dry run, just call the regular review command with empty note
+        return execute$1({
+            ...runConfig,
+            review: {
+                ...runConfig.review,
+                note: ((_runConfig_review1 = runConfig.review) === null || _runConfig_review1 === void 0 ? void 0 : _runConfig_review1.note) || ''
+            }
+        });
+    }
+    // Start audio recording and transcription
+    logger.info('Starting audio recording for review context...');
+    logger.info('This command will use your system\'s default audio recording tool');
+    logger.info('💡 Tip: Use --select-audio-device to choose a specific microphone');
+    logger.info('Press Ctrl+C after you finish speaking to generate your review analysis');
+    const audioContext = await recordAndTranscribeAudio(runConfig);
+    // Now delegate to the regular review command with the audio context
+    logger.info('🤖 Analyzing review using audio context...');
+    const result = await execute$1({
+        ...runConfig,
+        review: {
+            // Map audioReview configuration to review configuration
+            includeCommitHistory: (_runConfig_audioReview1 = runConfig.audioReview) === null || _runConfig_audioReview1 === void 0 ? void 0 : _runConfig_audioReview1.includeCommitHistory,
+            includeRecentDiffs: (_runConfig_audioReview2 = runConfig.audioReview) === null || _runConfig_audioReview2 === void 0 ? void 0 : _runConfig_audioReview2.includeRecentDiffs,
+            includeReleaseNotes: (_runConfig_audioReview3 = runConfig.audioReview) === null || _runConfig_audioReview3 === void 0 ? void 0 : _runConfig_audioReview3.includeReleaseNotes,
+            includeGithubIssues: (_runConfig_audioReview4 = runConfig.audioReview) === null || _runConfig_audioReview4 === void 0 ? void 0 : _runConfig_audioReview4.includeGithubIssues,
+            commitHistoryLimit: (_runConfig_audioReview5 = runConfig.audioReview) === null || _runConfig_audioReview5 === void 0 ? void 0 : _runConfig_audioReview5.commitHistoryLimit,
+            diffHistoryLimit: (_runConfig_audioReview6 = runConfig.audioReview) === null || _runConfig_audioReview6 === void 0 ? void 0 : _runConfig_audioReview6.diffHistoryLimit,
+            releaseNotesLimit: (_runConfig_audioReview7 = runConfig.audioReview) === null || _runConfig_audioReview7 === void 0 ? void 0 : _runConfig_audioReview7.releaseNotesLimit,
+            githubIssuesLimit: (_runConfig_audioReview8 = runConfig.audioReview) === null || _runConfig_audioReview8 === void 0 ? void 0 : _runConfig_audioReview8.githubIssuesLimit,
+            sendit: (_runConfig_audioReview9 = runConfig.audioReview) === null || _runConfig_audioReview9 === void 0 ? void 0 : _runConfig_audioReview9.sendit,
+            context: (_runConfig_audioReview10 = runConfig.audioReview) === null || _runConfig_audioReview10 === void 0 ? void 0 : _runConfig_audioReview10.context,
+            // Use the transcribed audio as content
+            note: audioContext.trim() || ((_runConfig_review = runConfig.review) === null || _runConfig_review === void 0 ? void 0 : _runConfig_review.note) || ''
+        }
+    });
+    // Final cleanup to ensure process can exit
+    try {
+        if (process.stdin.setRawMode) {
+            process.stdin.setRawMode(false);
+            process.stdin.pause();
+            process.stdin.removeAllListeners();
+        }
+        process.removeAllListeners('SIGINT');
+        process.removeAllListeners('SIGTERM');
+    } catch (error) {
+    // Ignore cleanup errors
+    }
+    return result;
+};
+const recordAndTranscribeAudio = async (runConfig)=>{
+    var _runConfig_audioReview;
+    const logger = getLogger();
+    const outputDirectory = runConfig.outputDirectory || DEFAULT_OUTPUT_DIRECTORY;
+    const storage = create({
+        log: logger.info
+    });
+    await storage.ensureDirectory(outputDirectory);
+    const tempDir = await fs.mkdtemp(path.join(outputDirectory, '.temp-audio-'));
+    const audioFilePath = path.join(tempDir, 'recording.wav');
+    // Declare variables at function scope for cleanup access
+    let recordingProcess = null;
+    let recordingFinished = false;
+    let recordingCancelled = false;
+    let countdownInterval = null;
+    let remainingSeconds = 30;
+    let intendedRecordingTime = 30;
+    const maxRecordingTime = ((_runConfig_audioReview = runConfig.audioReview) === null || _runConfig_audioReview === void 0 ? void 0 : _runConfig_audioReview.maxRecordingTime) || 300; // 5 minutes default
+    const extensionTime = 30; // 30 seconds per extension
+    try {
+        // Use system recording tool - cross-platform approach
+        logger.info('🎤 Starting recording... Speak now!');
+        logger.info('📋 Controls: ENTER=done, E=extend+30s, C/Ctrl+C=cancel');
+        // List available audio devices in debug mode
+        if (runConfig.debug) {
+            await listAudioDevices();
+        }
+        // Start countdown display
+        const startCountdown = ()=>{
+            // Show initial countdown
+            updateCountdownDisplay();
+            countdownInterval = setInterval(()=>{
+                remainingSeconds--;
+                if (remainingSeconds > 0) {
+                    updateCountdownDisplay();
+                } else {
+                    process.stdout.write('\r⏱️  Recording: Time\'s up!                                        \n');
+                    if (countdownInterval) {
+                        clearInterval(countdownInterval);
+                        countdownInterval = null;
+                    }
+                    // Auto-stop when intended time is reached
+                    stopRecording();
+                }
+            }, 1000);
+        };
+        const updateCountdownDisplay = ()=>{
+            const maxMinutes = Math.floor(maxRecordingTime / 60);
+            const intendedMinutes = Math.floor(intendedRecordingTime / 60);
+            const intendedSeconds = intendedRecordingTime % 60;
+            process.stdout.write(`\r⏱️  Recording: ${remainingSeconds}s left (${intendedMinutes}:${intendedSeconds.toString().padStart(2, '0')}/${maxMinutes}:00 max) [ENTER=done, E=+30s, C=cancel]`);
+        };
+        const extendRecording = ()=>{
+            const newTotal = intendedRecordingTime + extensionTime;
+            if (newTotal <= maxRecordingTime) {
+                intendedRecordingTime = newTotal;
+                remainingSeconds += extensionTime;
+                logger.info(`🔄 Extended recording by ${extensionTime}s (total: ${Math.floor(intendedRecordingTime / 60)}:${(intendedRecordingTime % 60).toString().padStart(2, '0')})`);
+                updateCountdownDisplay();
+            } else {
+                const canExtend = maxRecordingTime - intendedRecordingTime;
+                if (canExtend > 0) {
+                    intendedRecordingTime = maxRecordingTime;
+                    remainingSeconds += canExtend;
+                    logger.info(`🔄 Extended recording by ${canExtend}s (maximum reached: ${Math.floor(maxRecordingTime / 60)}:${(maxRecordingTime % 60).toString().padStart(2, '0')})`);
+                    updateCountdownDisplay();
+                } else {
+                    logger.warn(`⚠️  Cannot extend: maximum recording time (${Math.floor(maxRecordingTime / 60)}:${(maxRecordingTime % 60).toString().padStart(2, '0')}) reached`);
+                }
+            }
+        };
+        // Set up keyboard input handling
+        const setupKeyboardHandling = ()=>{
+            process.stdin.setRawMode(true);
+            process.stdin.resume();
+            process.stdin.setEncoding('utf8');
+            const keyHandler = (key)=>{
+                const keyCode = key.charCodeAt(0);
+                if (keyCode === 13) {
+                    // Immediate feedback
+                    process.stdout.write('\r✅ ENTER pressed - stopping recording...                          \n');
+                    process.stdin.setRawMode(false);
+                    process.stdin.pause();
+                    process.stdin.removeListener('data', keyHandler);
+                    stopRecording();
+                } else if (key.toLowerCase() === 'e') {
+                    extendRecording();
+                } else if (key.toLowerCase() === 'c' || keyCode === 3) {
+                    // Immediate feedback
+                    process.stdout.write('\r❌ Cancelling recording...                                       \n');
+                    process.stdin.setRawMode(false);
+                    process.stdin.pause();
+                    process.stdin.removeListener('data', keyHandler);
+                    cancelRecording();
+                }
+            };
+            process.stdin.on('data', keyHandler);
+        };
+        // Determine which recording command to use based on platform (using max time)
+        let recordCommand;
+        if (process.platform === 'darwin') {
+            // macOS - try ffmpeg first, then fall back to manual recording
+            try {
+                var _runConfig_audioReview1, _runConfig_audioReview2;
+                // Check if ffmpeg is available
+                await run('which ffmpeg');
+                // Get the best audio device (from saved config, CLI config, or auto-detected)
+                const savedDevice = await loadAudioDeviceFromConfig(runConfig);
+                const audioDevice = ((_runConfig_audioReview1 = runConfig.audioReview) === null || _runConfig_audioReview1 === void 0 ? void 0 : _runConfig_audioReview1.audioDevice) || savedDevice || await detectBestAudioDevice();
+                recordCommand = `ffmpeg -f avfoundation -i ":${audioDevice}" -t ${maxRecordingTime} -y "${audioFilePath}"`;
+                if ((_runConfig_audioReview2 = runConfig.audioReview) === null || _runConfig_audioReview2 === void 0 ? void 0 : _runConfig_audioReview2.audioDevice) {
+                    logger.info(`🎙️  Using audio device ${audioDevice} (from CLI configuration)`);
+                } else if (savedDevice) {
+                    logger.info(`🎙️  Using audio device ${audioDevice} (from saved configuration)`);
+                } else {
+                    logger.info(`🎙️  Using audio device ${audioDevice} (auto-detected)`);
+                }
+            } catch  {
+                // ffmpeg not available, try sox/rec
+                try {
+                    await run('which rec');
+                    recordCommand = `rec -r 44100 -c 1 -t wav "${audioFilePath}" trim 0 ${maxRecordingTime}`;
+                } catch  {
+                    // Neither available, use manual fallback
+                    throw new Error('MANUAL_RECORDING_NEEDED');
+                }
+            }
+        } else if (process.platform === 'win32') {
+            // Windows - use ffmpeg if available, otherwise fallback
+            try {
+                await run('where ffmpeg');
+                recordCommand = `ffmpeg -f dshow -i audio="Microphone" -t ${maxRecordingTime} -y "${audioFilePath}"`;
+            } catch  {
+                throw new Error('MANUAL_RECORDING_NEEDED');
+            }
+        } else {
+            // Linux - use arecord (ALSA) or ffmpeg
+            try {
+                await run('which arecord');
+                recordCommand = `arecord -f cd -t wav -d ${maxRecordingTime} "${audioFilePath}"`;
+            } catch  {
+                try {
+                    await run('which ffmpeg');
+                    recordCommand = `ffmpeg -f alsa -i default -t ${maxRecordingTime} -y "${audioFilePath}"`;
+                } catch  {
+                    throw new Error('MANUAL_RECORDING_NEEDED');
+                }
+            }
+        }
+        // Start recording as a background process (with max time, we'll stop it early if needed)
+        try {
+            recordingProcess = run(recordCommand);
+        } catch (error) {
+            if (error.message === 'MANUAL_RECORDING_NEEDED') {
+                // Provide helpful instructions for manual recording
+                logger.warn('⚠️  Automatic recording not available on this system.');
+                logger.warn('📱 Please record audio manually using your system\'s built-in tools:');
+                logger.warn('');
+                if (process.platform === 'darwin') {
+                    logger.warn('🍎 macOS options:');
+                    logger.warn('   1. Use QuickTime Player: File → New Audio Recording');
+                    logger.warn('   2. Use Voice Memos app');
+                    logger.warn('   3. Install ffmpeg: brew install ffmpeg');
+                    logger.warn('   4. Install sox: brew install sox');
+                } else if (process.platform === 'win32') {
+                    logger.warn('🪟 Windows options:');
+                    logger.warn('   1. Use Voice Recorder app');
+                    logger.warn('   2. Install ffmpeg: https://ffmpeg.org/download.html');
+                } else {
+                    logger.warn('🐧 Linux options:');
+                    logger.warn('   1. Install alsa-utils: sudo apt install alsa-utils');
+                    logger.warn('   2. Install ffmpeg: sudo apt install ffmpeg');
+                }
+                logger.warn('');
+                logger.warn(`💾 Save your recording as: ${audioFilePath}`);
+                logger.warn('🎵 Recommended format: WAV, 44.1kHz, mono or stereo');
+                logger.warn('');
+                logger.warn('⌨️  Press ENTER when you have saved the audio file...');
+                // Wait for user input (disable our keyboard handling for this)
+                await new Promise((resolve)=>{
+                    const originalRawMode = process.stdin.setRawMode;
+                    process.stdin.setRawMode(true);
+                    process.stdin.resume();
+                    const enterHandler = (key)=>{
+                        if (key[0] === 13) {
+                            process.stdin.setRawMode(false);
+                            process.stdin.pause();
+                            process.stdin.removeListener('data', enterHandler);
+                            resolve(void 0);
+                        }
+                    };
+                    process.stdin.on('data', enterHandler);
+                });
+                // Skip the automatic recording and keyboard handling for manual recording
+                recordingProcess = null;
+            } else {
+                throw error;
+            }
+        }
+        // Set up graceful shutdown
+        const stopRecording = async ()=>{
+            if (!recordingFinished && !recordingCancelled) {
+                recordingFinished = true;
+                // Clear countdown
+                if (countdownInterval) {
+                    clearInterval(countdownInterval);
+                    countdownInterval = null;
+                }
+                // Clear the countdown line and show recording stopped
+                process.stdout.write('\r⏱️  Recording finished!                                  \n');
+                if (recordingProcess && recordingProcess.kill) {
+                    recordingProcess.kill('SIGTERM');
+                }
+                logger.info('🛑 Recording stopped - proceeding with review');
+            }
+        };
+        // Set up cancellation
+        const cancelRecording = async ()=>{
+            if (!recordingFinished && !recordingCancelled) {
+                recordingCancelled = true;
+                // Clear countdown
+                if (countdownInterval) {
+                    clearInterval(countdownInterval);
+                    countdownInterval = null;
+                }
+                // Clear the countdown line and show cancellation
+                process.stdout.write('\r❌ Recording cancelled!                                 \n');
+                if (recordingProcess && recordingProcess.kill) {
+                    recordingProcess.kill('SIGTERM');
+                }
+                logger.info('❌ Audio review cancelled by user');
+                process.exit(0);
+            }
+        };
+        // Remove the old SIGINT handler and use our new keyboard handling
+        // Note: We'll still handle SIGINT for cleanup, but route it through cancelRecording
+        process.on('SIGINT', cancelRecording);
+        // Start keyboard handling and countdown if we have a recording process
+        if (recordingProcess) {
+            setupKeyboardHandling();
+            startCountdown();
+            // Create a promise that resolves when user manually stops recording
+            const manualStopPromise = new Promise((resolve)=>{
+                const checkInterval = setInterval(()=>{
+                    if (recordingFinished || recordingCancelled) {
+                        clearInterval(checkInterval);
+                        resolve();
+                    }
+                }, 100);
+            });
+            // Wait for either the recording to finish naturally or manual stop
+            try {
+                await Promise.race([
+                    recordingProcess,
+                    manualStopPromise
+                ]);
+                // If manually stopped, force kill the process if it's still running
+                if (recordingFinished && recordingProcess && !recordingProcess.killed) {
+                    recordingProcess.kill('SIGKILL');
+                    // Give it a moment to die
+                    await new Promise((resolve)=>setTimeout(resolve, 200));
+                }
+                // Only show completion message if not manually finished
+                if (!recordingCancelled && !recordingFinished) {
+                    // Clear countdown on successful completion
+                    if (countdownInterval) {
+                        clearInterval(countdownInterval);
+                        countdownInterval = null;
+                    }
+                    process.stdout.write('\r⏱️  Recording completed!                               \n');
+                    logger.info('✅ Recording completed automatically');
+                }
+            } catch (error) {
+                // Only handle errors if not cancelled and not manually finished
+                if (!recordingCancelled && !recordingFinished) {
+                    // Clear countdown on error
+                    if (countdownInterval) {
+                        clearInterval(countdownInterval);
+                        countdownInterval = null;
+                    }
+                    if (error.signal === 'SIGTERM' || error.signal === 'SIGKILL') {
+                        // This is expected when we kill the process
+                        logger.debug('Recording process terminated as expected');
+                    } else {
+                        logger.warn('Recording process ended unexpectedly: %s', error.message);
+                    }
+                }
+            }
+            // Always clean up keyboard input
+            if (process.stdin.setRawMode) {
+                process.stdin.setRawMode(false);
+                process.stdin.pause();
+            }
+        }
+        // If recording was cancelled, exit early
+        if (recordingCancelled) {
+            return '';
+        }
+        // Wait a moment for the recording file to be fully written
+        if (recordingFinished) {
+            await new Promise((resolve)=>setTimeout(resolve, 500));
+        }
+        // Check if audio file exists
+        try {
+            await fs.access(audioFilePath);
+            const stats = await fs.stat(audioFilePath);
+            if (stats.size === 0) {
+                throw new Error('Audio file is empty');
+            }
+            logger.info('✅ Audio file created successfully (%d bytes)', stats.size);
+        } catch (error) {
+            throw new Error(`Failed to create audio file: ${error.message}`);
+        }
+        // Transcribe the audio
+        logger.info('🎯 Transcribing audio...');
+        logger.info('⏳ This may take a few seconds depending on audio length...');
+        const transcription = await transcribeAudio(audioFilePath);
+        const audioContext = transcription.text;
+        logger.info('✅ Audio transcribed successfully');
+        logger.debug('Transcription: %s', audioContext);
+        // Save audio file and transcript to output directory
+        logger.info('💾 Saving audio file and transcript...');
+        try {
+            const outputDirectory = runConfig.outputDirectory || DEFAULT_OUTPUT_DIRECTORY;
+            const storage = create({
+                log: logger.info
+            });
+            await storage.ensureDirectory(outputDirectory);
+            // Save audio file copy
+            const audioOutputFilename = getTimestampedAudioFilename();
+            const audioOutputPath = getOutputPath(outputDirectory, audioOutputFilename);
+            await fs.copyFile(audioFilePath, audioOutputPath);
+            logger.debug('Saved audio file: %s', audioOutputPath);
+            // Save transcript
+            if (audioContext.trim()) {
+                const transcriptOutputFilename = getTimestampedTranscriptFilename();
+                const transcriptOutputPath = getOutputPath(outputDirectory, transcriptOutputFilename);
+                const transcriptContent = `# Audio Transcript\n\n**Recorded:** ${new Date().toISOString()}\n\n**Transcript:**\n\n${audioContext}`;
+                await storage.writeFile(transcriptOutputPath, transcriptContent, 'utf-8');
+                logger.debug('Saved transcript: %s', transcriptOutputPath);
+            }
+        } catch (error) {
+            logger.warn('Failed to save audio/transcript files: %s', error.message);
+        }
+        if (!audioContext.trim()) {
+            logger.warn('No audio content was transcribed. Proceeding without audio context.');
+            return '';
+        } else {
+            logger.info('📝 Using transcribed audio as review note');
+            return audioContext;
+        }
+    } catch (error) {
+        logger.error('Audio recording/transcription failed: %s', error.message);
+        logger.info('Proceeding with review analysis without audio context...');
+        return '';
+    } finally{
+        // Comprehensive cleanup to ensure program can exit
+        try {
+            // Clear any remaining countdown interval
+            if (countdownInterval) {
+                clearInterval(countdownInterval);
+                countdownInterval = null;
+            }
+            // Ensure stdin is properly reset
+            if (process.stdin.setRawMode) {
+                process.stdin.setRawMode(false);
+                process.stdin.pause();
+                process.stdin.removeAllListeners('data');
+            }
+            // Remove process event listeners that we added
+            process.removeAllListeners('SIGINT');
+            process.removeAllListeners('SIGTERM');
+            // Force kill any remaining recording process
+            if (recordingProcess && !recordingProcess.killed) {
+                try {
+                    recordingProcess.kill('SIGKILL');
+                } catch (killError) {
+                // Ignore kill errors
+                }
+            }
+            // Clean up temporary directory
+            await fs.rm(tempDir, {
+                recursive: true,
+                force: true
+            });
+        } catch (cleanupError) {
+            logger.debug('Cleanup warning: %s', cleanupError.message);
+        }
+    }
+};
+
+export { execute };
+//# sourceMappingURL=audio-review.js.map