@goldensheepai/toknxr-cli 0.2.2 → 0.3.0

package/lib/cli.js

@@ -1,10 +1,13 @@
+#!/usr/bin/env node
 import 'dotenv/config';
 import { Command } from 'commander';
 import chalk from 'chalk';
-import readline from 'readline';
+import inquirer from 'inquirer';
 import { startProxyServer } from './proxy.js';
+import { testConnection, generateSampleInteraction } from './utils.js';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
+import os from 'os';
 import open from 'open';
 import { createStatsOverview, createProviderTable, createQualityBreakdown, createOperationProgress, createInteractiveMenu, createBox, createCostChart, createPaginatedDisplay, createFilterInterface, createSearchInterface, InteractiveDataExplorer, CliStateManager, filterAndSearchInteractions, } from './ui.js';
 // Gracefully handle broken pipe (e.g., piping output to `head`)
@@ -18,28 +21,34 @@ process.stderr.on('error', (err) => {
 });
 const program = new Command();
 // ASCII Art Welcome Screen with gradient colors
-const asciiArt = `
-${chalk.blue('  ████████╗')}${chalk.hex('#6B5BED')('  ██████╗ ')}${chalk.hex('#9B5BED')(' ██╗  ██╗')}${chalk.hex('#CB5BED')(' ███╗   ██╗')}${chalk.hex('#ED5B9B')(' ██╗  ██╗')}${chalk.hex('#ED5B6B')(' ██████╗ ')}
-${chalk.blue('  ╚══██╔══╝')}${chalk.hex('#6B5BED')(' ██╔═══██╗')}${chalk.hex('#9B5BED')(' ██║ ██╔╝')}${chalk.hex('#CB5BED')(' ████╗  ██║')}${chalk.hex('#ED5B9B')(' ╚██╗██╔╝')}${chalk.hex('#ED5B6B')(' ██╔══██╗')}
-${chalk.blue('     ██║   ')}${chalk.hex('#6B5BED')(' ██║   ██║')}${chalk.hex('#9B5BED')(' █████╔╝ ')}${chalk.hex('#CB5BED')(' ██╔██╗ ██║')}${chalk.hex('#ED5B9B')('  ╚███╔╝ ')}${chalk.hex('#ED5B6B')(' ██████╔╝')}
-${chalk.blue('     ██║   ')}${chalk.hex('#6B5BED')(' ██║   ██║')}${chalk.hex('#9B5BED')(' ██╔═██╗ ')}${chalk.hex('#CB5BED')(' ██║╚██╗██║')}${chalk.hex('#ED5B9B')('  ██╔██╗ ')}${chalk.hex('#ED5B6B')(' ██╔══██╗')}
-${chalk.blue('     ██║   ')}${chalk.hex('#6B5BED')(' ╚██████╔╝')}${chalk.hex('#9B5BED')(' ██║  ██╗')}${chalk.hex('#CB5BED')(' ██║ ╚████║')}${chalk.hex('#ED5B9B')(' ██╔╝ ██╗')}${chalk.hex('#ED5B6B')(' ██║  ██║')}
-${chalk.blue('     ╚═╝   ')}${chalk.hex('#6B5BED')('  ╚═════╝ ')}${chalk.hex('#9B5BED')(' ╚═╝  ╚═╝')}${chalk.hex('#CB5BED')(' ╚═╝  ╚═══╝')}${chalk.hex('#ED5B9B')(' ╚═╝  ╚═╝')}${chalk.hex('#ED5B6B')(' ╚═╝  ╚═╝')}
+const welcomeMessage = `
+${chalk.bold.hex('#FFD700')('🐑 Welcome to TokNXR by Golden Sheep AI 🐑')}
 
-${chalk.cyan('Tips for getting started:')}
-${chalk.white('1. Start tracking:')} ${chalk.yellow('toknxr start')} ${chalk.gray('- Launch the proxy server')}
-${chalk.white('2. View analytics:')} ${chalk.yellow('toknxr stats')} ${chalk.gray('- See token usage and code quality')}
-${chalk.white('3. Deep dive:')} ${chalk.yellow('toknxr code-analysis')} ${chalk.gray('- Detailed quality insights')}
-${chalk.white('4. Interactive menu:')} ${chalk.yellow('toknxr menu')} ${chalk.gray('- Guided command interface')}
-${chalk.white('5. Set limits:')} ${chalk.yellow('toknxr policy:init')} ${chalk.gray('- Configure spending policies')}
-${chalk.white('7. Need help?')} ${chalk.yellow('toknxr --help')} ${chalk.gray('- View all commands')}
+${chalk.bold.cyan('Your AI Effectiveness & Code Quality Analysis CLI')}
 
-${chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')}
+${chalk.bold.underline('Getting Started Guide:')}
 
-${chalk.hex('#FFD700')('🐑 Powered by Golden Sheep AI')}
+${chalk.bold.white('Chapter 1: Core Functionality')}
+  ${chalk.white('1.1 Launching the Proxy Server:')}
+     ${chalk.yellow('toknxr start')} ${chalk.gray('- Begin tracking your AI interactions.')}
+  ${chalk.white('1.2 Viewing Analytics:')}
+     ${chalk.yellow('toknxr stats')} ${chalk.gray('- Get an overview of token usage and code quality.')}
+  ${chalk.white('1.3 Deep Code Analysis:')}
+     ${chalk.yellow('toknxr code-analysis')} ${chalk.gray('- Dive into detailed quality insights for your AI-generated code.')}
 
+${chalk.bold.white('Chapter 2: Advanced Usage')}
+  ${chalk.white('2.1 Interactive Command Menu:')}
+     ${chalk.yellow('toknxr menu')} ${chalk.gray('- Navigate through commands with a guided interface.')}
+  ${chalk.white('2.2 Configuring Spending Policies:')}
+     ${chalk.yellow('toknxr policy:init')} ${chalk.gray('- Set up and manage your AI spending limits.')}
+
+${chalk.bold.white('Chapter 3: Need Assistance?')}
+  ${chalk.white('3.1 Accessing Help:')}
+     ${chalk.yellow('toknxr --help')} ${chalk.gray('- View all available commands and their options.')}
+
+${chalk.gray('------------------------------------------------------------')}
 `;
-console.log(asciiArt);
+console.log(welcomeMessage);
 /**
  * Generate weekly cost trends for the cost chart visualization
  */
@@ -75,7 +84,7 @@ function generateWeeklyCostTrends(interactions) {
     }
     return dailyCosts;
 }
-program.name('toknxr').description('AI Effectiveness & Code Quality Analysis CLI').version('0.1.0');
+program.name('toknxr').description('AI Effectiveness & Code Quality Analysis CLI').version('0.3.0');
 program
     .command('menu')
     .description('Interactive menu system for TokNXR operations')
@@ -100,36 +109,27 @@ program
             },
             { name: chalk.red('⚙️ Initialize') + chalk.gray(' - Set up configuration'), value: 'init' },
         ]);
-        switch (choice) {
-            case 'start':
-                console.log(chalk.blue.bold('\n🚀 Starting TokNXR Proxy Server'));
-                const spinner = createOperationProgress('Initializing', [
-                    'Loading configuration',
-                    'Setting up providers',
-                    'Starting analytics engine',
-                    'Ready for requests',
-                ]);
-                setTimeout(() => spinner.updateProgress(0), 500);
-                setTimeout(() => spinner.updateProgress(1), 1000);
-                setTimeout(() => spinner.updateProgress(2), 1500);
-                setTimeout(() => {
-                    spinner.updateProgress(3);
-                    spinner.succeed('Proxy server launched successfully!');
-                    startProxyServer();
-                }, 2000);
-                break;
-            case 'stats':
-                // This will auto-trigger the stats command
-                break;
-            case 'analysis':
-                // This will auto-trigger the code-analysis command
-                break;
-            case 'hallucinations':
-                // This will trigger hallucination analytics
-                break;
-            case 'init':
-                // This will trigger init command
-                break;
+        try {
+            switch (choice) {
+                case 'start':
+                    await program.parseAsync(['node', 'toknxr', 'start']);
+                    break;
+                case 'stats':
+                    await program.parseAsync(['node', 'toknxr', 'stats']);
+                    break;
+                case 'analysis':
+                    await program.parseAsync(['node', 'toknxr', 'code-analysis']);
+                    break;
+                case 'hallucinations':
+                    await program.parseAsync(['node', 'toknxr', 'hallucinations']);
+                    break;
+                case 'init':
+                    await program.parseAsync(['node', 'toknxr', 'init']);
+                    break;
+            }
+        }
+        catch (e) {
+            // This will catch the exit override
         }
     }
     catch (error) {
@@ -327,10 +327,6 @@ program
     // Interactive navigation and context-aware guidance
     console.log('\n' + chalk.blue.bold('🔍 Interactive Navigation'));
     console.log(chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout,
-    });
     // Analyze current situation for intelligent suggestions
     const currentSituation = {
         needsBudgetAttention: grandTotals.costUSD > 40, // 80% of monthly budget
@@ -383,94 +379,97 @@ program
             recommended: false,
         },
     ];
-    console.log(chalk.gray('Select an option to continue your analysis journey:'));
-    console.log();
-    navigationOptions.forEach(option => {
-        const prefix = option.recommended ? chalk.green('★') : ' ';
-        console.log(`${prefix} ${chalk.bold(option.key)}) ${option.title}`);
-        console.log(`    ${option.description}`);
-    });
-    console.log();
-    rl.question(chalk.cyan('Your choice: '), answer => {
-        const choice = answer.toLowerCase().trim();
-        switch (choice) {
-            case '1':
-                console.log(chalk.blue('\n🔍 Navigating to detailed analysis...'));
-                console.log(chalk.cyan('Use: ') +
-                    chalk.yellow('toknxr code-analysis') +
-                    chalk.gray(' for deep quality insights'));
-                setTimeout(async () => {
-                    try {
-                        const { execSync } = await import('child_process');
-                        execSync("node -e \"if(require('fs').existsSync('package.json')) { process.chdir(__dirname); require('tsx/dist/esbuild-register').register(); require('./code-analysis.ts').action(); }\" 2>/dev/null || echo \"Please run: toknxr code-analysis\"", { stdio: 'inherit' });
-                    }
-                    catch {
-                        console.log(chalk.gray('Please run: ') + chalk.cyan('toknxr code-analysis'));
-                    }
-                }, 500);
-                break;
-            case '2':
-                console.log(chalk.magenta('\n🧠 Navigating to AI performance insights...'));
-                console.log(chalk.cyan('Use: ') +
-                    chalk.yellow('toknxr hallucinations') +
-                    chalk.gray(' for hallucination analysis'));
-                setTimeout(async () => {
-                    try {
-                        const { execSync } = await import('child_process');
-                        execSync("node -e \"if(require('fs').existsSync('package.json')) { process.chdir(__dirname); require('tsx/dist/esbuild-register').register(); require('./hallucinations.ts').action(); }\" 2>/dev/null || echo \"Please run: toknxr hallucinations\"", { stdio: 'inherit' });
-                    }
-                    catch {
-                        console.log(chalk.gray('Please run: ') + chalk.cyan('toknxr hallucinations'));
-                    }
-                }, 500);
-                break;
-            case '3':
-                console.log(chalk.yellow('\n💰 Navigating to budget optimization...'));
-                console.log(chalk.gray('📋 Budget Optimization Strategies:'));
-                console.log(`  • Monthly budget: $${(50).toFixed(2)} (spent: $${grandTotals.costUSD.toFixed(2)})`);
-                console.log(`  • Daily average: $${(grandTotals.costUSD / Math.max(1, Math.ceil((new Date().getTime() - new Date(interactions[0]?.timestamp || Date.now()).getTime()) / (1000 * 60 * 60 * 24)))).toFixed(2)}`);
-                console.log(`  • ${avgQuality >= 80 ? 'Try cheaper providers with similar quality' : 'Focus on prompt optimization to reduce request volume'}`);
-                break;
-            case '4':
-                console.log(chalk.green('\n📈 Starting real-time monitoring...'));
-                console.log(chalk.cyan('Use: ') +
-                    chalk.yellow('toknxr tail') +
-                    chalk.gray(' to monitor live interactions'));
-                setTimeout(async () => {
-                    try {
-                        const { execSync } = await import('child_process');
-                        execSync("node -e \"if(require('fs').existsSync('package.json')) { process.chdir(__dirname); require('tsx/dist/esbuild-register').register(); require('./tail.ts').action(); }\" 2>/dev/null || echo \"Please run: toknxr tail\"", { stdio: 'inherit' });
-                    }
-                    catch {
-                        console.log(chalk.gray('Please run: ') + chalk.cyan('toknxr tail'));
-                    }
-                }, 500);
-                break;
-            case '5':
-                console.log(chalk.blue('\n🚀 Starting AI refinement journey...'));
-                console.log(chalk.gray('📝 Improvement Recommendations:'));
-                if (avgQuality < 75) {
-                    console.log(chalk.yellow('  • 🎯 Switch to higher-quality AI models (91vs88 scores)'));
-                    console.log(chalk.yellow('  • 📝 Use more specific prompt instructions'));
+    console.log(chalk.gray('\nSelect an option to continue your analysis journey:'));
+    const choices = navigationOptions.map(option => ({
+        name: `${option.recommended ? chalk.green('★') : ' '}${chalk.bold(option.key)}) ${option.title}\n    ${option.description}`,
+        value: option.key,
+    }));
+    const { choice } = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'choice',
+            message: 'Your choice:',
+            choices: choices,
+        },
+    ]);
+    switch (choice) {
+        case '1':
+            console.log(chalk.blue('\n🔍 Navigating to detailed analysis...'));
+            console.log(chalk.cyan('Use: ') +
+                chalk.yellow('toknxr code-analysis') +
+                chalk.gray(' for deep quality insights'));
+            setTimeout(async () => {
+                try {
+                    const { execSync } = await import('child_process');
+                    execSync("node -e \"if(require('fs').existsSync('package.json')) { process.chdir(__dirname); require('tsx/dist/esbuild-register').register(); require('./code-analysis.ts').action(); }\" 2>/dev/null || echo \"Please run: toknxr code-analysis\"", { stdio: 'inherit' });
                 }
-                if (grandTotals.costUSD > 25) {
-                    console.log(chalk.red('  • 💰 Consider API usage limits or budget alerts'));
-                    console.log(chalk.red('  • 🔄 Explore cost-efficient AI providers'));
+                catch {
+                    console.log(chalk.gray('Please run: ') + chalk.cyan('toknxr code-analysis'));
                 }
-                if (Object.keys(stats).length === 1) {
-                    console.log(chalk.blue('  • 🧪 A/B test multiple AI providers for your use case'));
+            }, 500);
+            break;
+        case '2':
+            console.log(chalk.magenta('\n🧠 Navigating to AI performance insights...'));
+            console.log(chalk.cyan('Use: ') +
+                chalk.yellow('toknxr hallucinations') +
+                chalk.gray(' for hallucination analysis'));
+            setTimeout(async () => {
+                try {
+                    const { execSync } = await import('child_process');
+                    execSync("node -e \"if(require('fs').existsSync('package.json')) { process.chdir(__dirname); require('tsx/dist/esbuild-register').register(); require('./hallucinations.ts').action(); }\" 2>/dev/null || echo \"Please run: toknxr hallucinations\"", { stdio: 'inherit' });
                 }
-                break;
-            case 'm':
-            case 'menu':
-                console.log(chalk.gray('\n📋 Opening interactive menu...'));
-                setTimeout(async () => {
-                    try {
-                        const { spawn } = await import('child_process');
-                        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-                        const menuCommand = spawn('node', [
-                            '-e',
-                            `
+                catch {
+                    console.log(chalk.gray('Please run: ') + chalk.cyan('toknxr hallucinations'));
+                }
+            }, 500);
+            break;
+        case '3':
+            console.log(chalk.yellow('\n💰 Navigating to budget optimization...'));
+            console.log(chalk.gray('📋 Budget Optimization Strategies:'));
+            console.log(`  • Monthly budget: $${(50).toFixed(2)} (spent: $${grandTotals.costUSD.toFixed(2)})`);
+            console.log(`  • Daily average: $${(grandTotals.costUSD / Math.max(1, Math.ceil((new Date().getTime() - new Date(interactions[0]?.timestamp || Date.now()).getTime()) / (1000 * 60 * 60 * 24)))).toFixed(2)}`);
+            console.log(`  • ${avgQuality >= 80 ? 'Try cheaper providers with similar quality' : 'Focus on prompt optimization to reduce request volume'}`);
+            break;
+        case '4':
+            console.log(chalk.green('\n📈 Starting real-time monitoring...'));
+            console.log(chalk.cyan('Use: ') +
+                chalk.yellow('toknxr tail') +
+                chalk.gray(' to monitor live interactions'));
+            setTimeout(async () => {
+                try {
+                    const { execSync } = await import('child_process');
+                    execSync("node -e \"if(require('fs').existsSync('package.json')) { process.chdir(__dirname); require('tsx/dist/esbuild-register').register(); require('./tail.ts').action(); }\" 2>/dev/null || echo \"Please run: toknxr tail\"", { stdio: 'inherit' });
+                }
+                catch {
+                    console.log(chalk.gray('Please run: ') + chalk.cyan('toknxr tail'));
+                }
+            }, 500);
+            break;
+        case '5':
+            console.log(chalk.blue('\n🚀 Starting AI refinement journey...'));
+            console.log(chalk.gray('📝 Improvement Recommendations:'));
+            if (avgQuality < 75) {
+                console.log(chalk.yellow('  • 🎯 Switch to higher-quality AI models (91vs88 scores)'));
+                console.log(chalk.yellow('  • 📝 Use more specific prompt instructions'));
+            }
+            if (grandTotals.costUSD > 25) {
+                console.log(chalk.red('  • 💰 Consider API usage limits or budget alerts'));
+                console.log(chalk.red('  • 🔄 Explore cost-efficient AI providers'));
+            }
+            if (Object.keys(stats).length === 1) {
+                console.log(chalk.blue('  • 🧪 A/B test multiple AI providers for your use case'));
+            }
+            break;
+        case 'm':
+        case 'menu':
+            console.log(chalk.gray('\n📋 Opening interactive menu...'));
+            setTimeout(async () => {
+                try {
+                    const { spawn } = await import('child_process');
+                    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+                    const menuCommand = spawn('node', [
+                        '-e',
+                        `
                 try {
                   process.chdir('${process.cwd().replace(/\\/g, '\\\\')}');
                   require('tsx/dist/esbuild-register').register();
@@ -483,29 +482,27 @@ program
                   console.log('Please run: toknxr menu');
                 }
               `,
-                        ], { stdio: 'inherit' });
-                    }
-                    catch (e) {
-                        console.log('Please run: toknxr menu');
-                    }
-                }, 300);
-                break;
-            case 'q':
-            case 'quit':
-            case 'exit':
-                console.log(chalk.gray('\n👋 Thanks for using TokNXR analytics!'));
-                console.log(chalk.gray('Raw data available in: ') + chalk.cyan('interactions.log'));
-                break;
-            default:
-                console.log(chalk.yellow(`Unknown option "${answer}". Showing help...`));
-                console.log(chalk.cyan('\nAvailable commands:'));
-                console.log(`  ${chalk.yellow('toknxr menu')}     - Interactive command menu`);
-                console.log(`  ${chalk.yellow('toknxr stats')}    - Current usage overview`);
-                console.log(`  ${chalk.yellow('toknxr start')}    - Launch proxy server`);
-                console.log(`  ${chalk.yellow('toknxr --help')}   - View all commands`);
-        }
-        rl.close();
-    });
+                    ], { stdio: 'inherit' });
+                }
+                catch (e) {
+                    console.log('Please run: toknxr menu');
+                }
+            }, 300);
+            break;
+        case 'q':
+        case 'quit':
+        case 'exit':
+            console.log(chalk.gray('\n👋 Thanks for using TokNXR analytics!'));
+            console.log(chalk.gray('Raw data available in: ') + chalk.cyan('interactions.log'));
+            break;
+        default:
+            console.log(chalk.yellow(`Unknown option "${choice}". Showing help...`));
+            console.log(chalk.cyan('\nAvailable commands:'));
+            console.log(`  ${chalk.yellow('toknxr menu')}     - Interactive command menu`);
+            console.log(`  ${chalk.yellow('toknxr stats')}    - Current usage overview`);
+            console.log(`  ${chalk.yellow('toknxr start')}    - Launch proxy server`);
+            console.log(`  ${chalk.yellow('toknxr --help')}   - View all commands`);
+    }
 });
 program
     .command('init')
@@ -612,7 +609,7 @@ program
 program
     .command('code-analysis')
     .description('Show detailed code quality analysis from coding interactions')
-    .action(() => {
+    .action(async () => {
     const logFilePath = path.resolve(process.cwd(), 'interactions.log');
     if (!fs.existsSync(logFilePath)) {
         console.log(chalk.yellow('No interactions logged yet. Use the `start` command to begin tracking.'));
@@ -721,6 +718,103 @@ program
         console.log('  • Consider establishing code review processes for edge cases');
     }
     console.log(`\n${chalk.gray('Total coding interactions analyzed: ' + interactions.length)}`);
+    // Interactive navigation
+    console.log('\n' + chalk.blue.bold('🔍 Interactive Navigation'));
+    console.log(chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+    const navigationOptions = [
+        {
+            key: '1',
+            title: chalk.cyan('📊 View Detailed Metrics'),
+            description: 'Drill down into specific quality metrics',
+            available: interactions.length > 0,
+        },
+        {
+            key: '2',
+            title: chalk.magenta('🧠 Hallucination Analysis'),
+            description: 'Analyze potential hallucinations in code',
+            available: interactions.length > 0,
+        },
+        {
+            key: '3',
+            title: chalk.yellow('🔄 Provider Comparison'),
+            description: 'Compare code quality across AI providers',
+            available: interactions.length > 0,
+        },
+        {
+            key: '4',
+            title: chalk.green('📈 View All Analytics'),
+            description: 'Go to comprehensive statistics view',
+            available: true,
+        },
+        {
+            key: '5',
+            title: chalk.blue('🔍 Browse Interactions'),
+            description: 'Browse through individual interactions',
+            available: interactions.length > 0,
+        },
+        {
+            key: 'm',
+            title: chalk.gray('📋 Main Menu'),
+            description: 'Return to main menu',
+            available: true,
+        },
+        {
+            key: 'q',
+            title: chalk.gray('❌ Exit'),
+            description: 'Exit code analysis',
+            available: true,
+        },
+    ];
+    const availableChoices = navigationOptions
+        .filter(option => option.available)
+        .map(option => ({
+        name: `${chalk.bold(option.key)}) ${option.title}\n    ${option.description}`,
+        value: option.key,
+    }));
+    const { choice } = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'choice',
+            message: 'What would you like to explore?',
+            choices: availableChoices,
+        },
+    ]);
+    switch (choice) {
+        case '1':
+            console.log(chalk.cyan('\n📊 Showing detailed quality metrics...'));
+            console.log(chalk.gray('Detailed breakdown by language and complexity:'));
+            Object.entries(langStats).forEach(([lang, count]) => {
+                const langInteractions = interactions.filter(i => (i.codeQualityMetrics?.language || 'unknown') === lang);
+                const avgQuality = langInteractions.reduce((sum, i) => sum + (i.codeQualityScore || 0), 0) / langInteractions.length;
+                console.log(`  • ${lang}: ${count} requests, avg quality: ${avgQuality.toFixed(1)}/100`);
+            });
+            break;
+        case '2':
+            console.log(chalk.magenta('\n🧠 Opening hallucination analysis...'));
+            console.log(chalk.gray('Run: ') + chalk.yellow('toknxr hallucinations'));
+            break;
+        case '3':
+            console.log(chalk.yellow('\n🔄 Opening provider comparison...'));
+            console.log(chalk.gray('Run: ') + chalk.yellow('toknxr providers'));
+            break;
+        case '4':
+            console.log(chalk.green('\n📈 Opening comprehensive analytics...'));
+            console.log(chalk.gray('Run: ') + chalk.yellow('toknxr stats'));
+            break;
+        case '5':
+            console.log(chalk.blue('\n🔍 Opening interaction browser...'));
+            console.log(chalk.gray('Run: ') + chalk.yellow('toknxr browse'));
+            break;
+        case 'm':
+            console.log(chalk.gray('\n📋 Opening main menu...'));
+            console.log(chalk.gray('Run: ') + chalk.yellow('toknxr menu'));
+            break;
+        case 'q':
+            console.log(chalk.gray('\n👋 Exiting code analysis...'));
+            break;
+        default:
+            console.log(chalk.yellow(`Unknown option "${choice}".`));
+    }
 });
 // Import required modules for new AI analysis commands
 import { hallucinationDetector } from './hallucination-detector.js';
@@ -836,7 +930,7 @@ program
     .description('Show hallucination statistics and trends')
     .option('-p, --provider <provider>', 'Filter by AI provider')
     .option('-l, --last <hours>', 'Show last N hours (default: 24)', '24')
-    .action(options => {
+    .action(async (options) => {
     const analytics = aiAnalytics.generateAnalytics();
     console.log(chalk.bold.blue('🧠 Hallucination Analytics'));
     console.log(chalk.gray('━'.repeat(50)));
@@ -867,11 +961,98 @@ program
             console.log(`  • ${rec}`);
         });
     }
+    // Interactive navigation
+    console.log('\n' + chalk.blue.bold('🔍 Interactive Navigation'));
+    console.log(chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+    const navigationOptions = [
+        {
+            key: '1',
+            title: chalk.cyan('📊 View Detailed Analysis'),
+            description: 'Deep dive into specific hallucination patterns',
+            available: analytics.totalInteractions > 0,
+        },
+        {
+            key: '2',
+            title: chalk.magenta('🔄 Compare Providers'),
+            description: 'Detailed provider comparison for hallucinations',
+            available: Object.keys(analytics.providerComparison).length > 1,
+        },
+        {
+            key: '3',
+            title: chalk.yellow('💰 Business Impact Analysis'),
+            description: 'Analyze cost and time impact of hallucinations',
+            available: analytics.hallucinationMetrics.businessImpact.estimatedDevTimeWasted > 0,
+        },
+        {
+            key: '4',
+            title: chalk.green('📈 View All Analytics'),
+            description: 'Go to comprehensive statistics view',
+            available: true,
+        },
+        {
+            key: 'm',
+            title: chalk.gray('📋 Main Menu'),
+            description: 'Return to main menu',
+            available: true,
+        },
+        {
+            key: 'q',
+            title: chalk.gray('❌ Exit'),
+            description: 'Exit hallucination analysis',
+            available: true,
+        },
+    ];
+    const availableChoices = navigationOptions
+        .filter(option => option.available)
+        .map(option => ({
+        name: `${chalk.bold(option.key)}) ${option.title}\n    ${option.description}`,
+        value: option.key,
+    }));
+    const { choice } = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'choice',
+            message: 'What would you like to explore?',
+            choices: availableChoices,
+        },
+    ]);
+    switch (choice) {
+        case '1':
+            console.log(chalk.cyan('\n📊 Opening detailed hallucination analysis...'));
+            console.log(chalk.gray('Run: ') + chalk.yellow('toknxr code-analysis'));
+            break;
+        case '2':
+            console.log(chalk.magenta('\n🔄 Opening provider comparison...'));
+            console.log(chalk.gray('Run: ') + chalk.yellow('toknxr providers'));
+            break;
+        case '3':
+            console.log(chalk.yellow('\n💰 Analyzing business impact...'));
+            console.log(chalk.gray('Business impact details:'));
+            const impact = analytics.hallucinationMetrics.businessImpact;
+            console.log(`  • Estimated dev time wasted: ${impact.estimatedDevTimeWasted}h`);
+            console.log(`  • Quality degradation score: ${impact.qualityDegradationScore}/100`);
+            console.log(`  • ROI impact: ${impact.roiImpact}% reduction`);
+            console.log(`  • Extra cost from hallucinations: ${impact.costOfHallucinations.toFixed(2)}`);
+            break;
+        case '4':
+            console.log(chalk.green('\n📈 Opening comprehensive analytics...'));
+            console.log(chalk.gray('Run: ') + chalk.yellow('toknxr stats'));
+            break;
+        case 'm':
+            console.log(chalk.gray('\n📋 Opening main menu...'));
+            console.log(chalk.gray('Run: ') + chalk.yellow('toknxr menu'));
+            break;
+        case 'q':
+            console.log(chalk.gray('\n👋 Exiting hallucination analysis...'));
+            break;
+        default:
+            console.log(chalk.yellow(`Unknown option "${choice}".`));
+    }
 });
 program
     .command('providers')
     .description('Compare AI provider performance')
-    .action(() => {
+    .action(async () => {
     const analytics = aiAnalytics.generateAnalytics();
     console.log(chalk.bold.blue('🔄 AI Provider Comparison'));
     console.log(chalk.gray('━'.repeat(50)));
@@ -918,18 +1099,172 @@ program
         console.log(`  Best Provider: ${chalk.green(bestProvider[0])} (${bestProvider[1].avgQualityScore}/100 quality)`);
         console.log(`  Needs Attention: ${chalk.red(worstProvider[0])} (${worstProvider[1].avgQualityScore}/100 quality)`);
     }
+    // Interactive navigation
+    console.log('\n' + chalk.blue.bold('🔍 Interactive Navigation'));
+    console.log(chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+    const providerList = Object.keys(analytics.providerComparison);
+    const navigationOptions = [
+        {
+            key: '1',
+            title: chalk.cyan('📊 Detailed Provider Analysis'),
+            description: 'Deep dive into individual provider metrics',
+            available: providerList.length > 0,
+        },
+        {
+            key: '2',
+            title: chalk.magenta('🧠 Hallucination Comparison'),
+            description: 'Compare hallucination rates across providers',
+            available: providerList.length > 1,
+        },
+        {
+            key: '3',
+            title: chalk.yellow('💰 Cost Optimization'),
+            description: 'Analyze cost-effectiveness by provider',
+            available: true,
+        },
+        {
+            key: '4',
+            title: chalk.green('📈 View All Analytics'),
+            description: 'Go to comprehensive statistics view',
+            available: true,
+        },
+        {
+            key: 'm',
+            title: chalk.gray('📋 Main Menu'),
+            description: 'Return to main menu',
+            available: true,
+        },
+        {
+            key: 'q',
+            title: chalk.gray('❌ Exit'),
+            description: 'Exit provider comparison',
+            available: true,
+        },
+    ];
+    const availableChoices = navigationOptions
+        .filter(option => option.available)
+        .map(option => ({
+        name: `${chalk.bold(option.key)}) ${option.title}\n    ${option.description}`,
+        value: option.key,
+    }));
+    const { choice } = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'choice',
+            message: 'What would you like to explore?',
+            choices: availableChoices,
+        },
+    ]);
+    switch (choice) {
+        case '1':
+            console.log(chalk.cyan('\n📊 Opening detailed provider analysis...'));
+            if (providerList.length > 1) {
+                const { selectedProvider } = await inquirer.prompt([
+                    {
+                        type: 'list',
+                        name: 'selectedProvider',
+                        message: 'Select a provider to analyze:',
+                        choices: providerList.map(provider => ({
+                            name: `${provider} (${analytics.providerComparison[provider].avgQualityScore}/100 quality)`,
+                            value: provider,
+                        })),
+                    },
+                ]);
+                const providerStats = analytics.providerComparison[selectedProvider];
+                console.log(chalk.cyan(`\n📊 Detailed Analysis for ${selectedProvider}:`));
+                console.log(`  Total Interactions: ${providerStats.totalInteractions}`);
+                console.log(`  Avg Quality Score: ${providerStats.avgQualityScore}/100`);
+                console.log(`  Avg Effectiveness: ${providerStats.avgEffectivenessScore}/100`);
+                console.log(`  Hallucination Rate: ${providerStats.hallucinationRate}%`);
+                console.log(`  Dev Time Wasted: ${providerStats.businessImpact.estimatedDevTimeWasted}h`);
+            }
+            else {
+                console.log(chalk.gray('Only one provider available. Run: ') + chalk.yellow('toknxr code-analysis'));
+            }
+            break;
+        case '2':
+            console.log(chalk.magenta('\n🧠 Opening hallucination comparison...'));
+            console.log(chalk.gray('Run: ') + chalk.yellow('toknxr hallucinations'));
+            break;
+        case '3':
+            console.log(chalk.yellow('\n💰 Analyzing cost optimization...'));
+            console.log(chalk.gray('Cost optimization recommendations:'));
+            providerList.forEach(provider => {
+                const stats = analytics.providerComparison[provider];
+                const efficiency = stats.avgQualityScore / (stats.businessImpact.costOfHallucinations || 1);
+                console.log(`  • ${provider}: Quality/Cost ratio = ${efficiency.toFixed(2)}`);
+            });
+            break;
+        case '4':
+            console.log(chalk.green('\n📈 Opening comprehensive analytics...'));
+            console.log(chalk.gray('Run: ') + chalk.yellow('toknxr stats'));
+            break;
+        case 'm':
+            console.log(chalk.gray('\n📋 Opening main menu...'));
+            console.log(chalk.gray('Run: ') + chalk.yellow('toknxr menu'));
+            break;
+        case 'q':
+            console.log(chalk.gray('\n👋 Exiting provider comparison...'));
+            break;
+        default:
+            console.log(chalk.yellow(`Unknown option "${choice}".`));
+    }
 });
 program
     .command('export')
     .description('Export analytics data to JSON file')
-    .option('-o, --output <file>', 'Output file path', 'ai-analytics-export.json')
-    .action(options => {
+    .option('-o, --output <file>', 'Output file path')
+    .action(async (options) => {
     try {
-        aiAnalytics.exportAnalytics(options.output);
-        console.log(chalk.green(`✅ Analytics exported to ${options.output}`));
+        let outputPath = options.output;
+        if (!outputPath) { // If -o option is not provided, use interactive mode
+            const { locationType } = await inquirer.prompt([
+                {
+                    type: 'list',
+                    name: 'locationType',
+                    message: 'Where would you like to save the export file?',
+                    choices: [
+                        { name: 'Current Directory', value: 'current' },
+                        { name: 'Desktop', value: 'desktop' },
+                        { name: 'Custom Path', value: 'custom' },
+                    ],
+                },
+            ]);
+            let chosenDirectory = process.cwd();
+            if (locationType === 'desktop') {
+                chosenDirectory = path.join(os.homedir(), 'Desktop');
+            }
+            else if (locationType === 'custom') {
+                const { customPath } = await inquirer.prompt([
+                    {
+                        type: 'input',
+                        name: 'customPath',
+                        message: 'Enter the custom directory path:',
+                        default: process.cwd(),
+                    },
+                ]);
+                chosenDirectory = customPath;
+            }
+            const { filename } = await inquirer.prompt([
+                {
+                    type: 'input',
+                    name: 'filename',
+                    message: 'Enter the filename for the export:',
+                    default: 'ai-analytics-export.json',
+                },
+            ]);
+            // Ensure the chosen directory exists
+            if (!fs.existsSync(chosenDirectory)) {
+                fs.mkdirSync(chosenDirectory, { recursive: true });
+                console.log(chalk.green(`Created directory: ${chosenDirectory}`));
+            }
+            outputPath = path.join(chosenDirectory, filename);
+        }
+        aiAnalytics.exportAnalytics(outputPath);
+        console.log(chalk.green(`✅ Analytics exported to ${outputPath}`));
     }
-    catch {
-        console.error(chalk.red('❌ Export failed'));
+    catch (error) {
+        console.error(chalk.red('❌ Export failed'), error);
     }
 });
 // Enhanced Interactive Commands - Phase 3+
@@ -998,15 +1333,96 @@ program
     console.log(createPaginatedDisplay(explorer.getCurrentPageData(), pageSize, currentPage, renderInteraction, `🐙 AI Interactions Browser (${explorer.getPaginationInfo().totalItems} total)`));
     // Interactive navigation
     const pagination = explorer.getPaginationInfo();
-    if (pagination.totalPages > 1) {
-        console.log(chalk.cyan('\nNavigation:'));
-        console.log(chalk.gray('• Use ') +
-            chalk.yellow('toknxr browse --page 2') +
-            chalk.gray(' to go to page 2'));
-        console.log(chalk.gray('• Use ') +
-            chalk.yellow('toknxr browse --size 25') +
-            chalk.gray(' for more items per page'));
-        console.log(chalk.gray('• Use ') + chalk.yellow('toknxr filter') + chalk.gray(' to filter results'));
+    console.log('\n' + chalk.blue.bold('🔍 Interactive Navigation'));
+    console.log(chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+    const navigationOptions = [
+        {
+            key: 'n',
+            title: chalk.cyan('📄 Next Page'),
+            description: `Go to page ${currentPage + 1}`,
+            available: currentPage < pagination.totalPages,
+        },
+        {
+            key: 'p',
+            title: chalk.cyan('📄 Previous Page'),
+            description: `Go to page ${currentPage - 1}`,
+            available: currentPage > 1,
+        },
+        {
+            key: 'f',
+            title: chalk.magenta('🔍 Filter Results'),
+            description: 'Apply filters to narrow down interactions',
+            available: true,
+        },
+        {
+            key: 's',
+            title: chalk.yellow('🔍 Search Interactions'),
+            description: 'Search through all interactions',
+            available: true,
+        },
+        {
+            key: 'a',
+            title: chalk.green('📊 View Analytics'),
+            description: 'Go to detailed statistics view',
+            available: true,
+        },
+        {
+            key: 'm',
+            title: chalk.gray('📋 Main Menu'),
+            description: 'Return to main menu',
+            available: true,
+        },
+        {
+            key: 'q',
+            title: chalk.gray('❌ Exit'),
+            description: 'Exit browser',
+            available: true,
+        },
+    ];
+    const availableChoices = navigationOptions
+        .filter(option => option.available)
+        .map(option => ({
+        name: `${chalk.bold(option.key)}) ${option.title}\n    ${option.description}`,
+        value: option.key,
+    }));
+    const { choice } = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'choice',
+            message: 'What would you like to do?',
+            choices: availableChoices,
+        },
+    ]);
+    switch (choice) {
+        case 'n':
+            console.log(chalk.cyan(`\n📄 Going to page ${currentPage + 1}...`));
+            console.log(chalk.gray('Run: ') + chalk.yellow(`toknxr browse --page ${currentPage + 1}`));
+            break;
+        case 'p':
+            console.log(chalk.cyan(`\n📄 Going to page ${currentPage - 1}...`));
+            console.log(chalk.gray('Run: ') + chalk.yellow(`toknxr browse --page ${currentPage - 1}`));
+            break;
+        case 'f':
+            console.log(chalk.magenta('\n🔍 Opening filter interface...'));
+            console.log(chalk.gray('Run: ') + chalk.yellow('toknxr filter'));
+            break;
+        case 's':
+            console.log(chalk.yellow('\n🔍 Opening search interface...'));
+            console.log(chalk.gray('Run: ') + chalk.yellow('toknxr search --query "your terms"'));
+            break;
+        case 'a':
+            console.log(chalk.green('\n📊 Opening analytics view...'));
+            console.log(chalk.gray('Run: ') + chalk.yellow('toknxr stats'));
+            break;
+        case 'm':
+            console.log(chalk.gray('\n📋 Opening main menu...'));
+            console.log(chalk.gray('Run: ') + chalk.yellow('toknxr menu'));
+            break;
+        case 'q':
+            console.log(chalk.gray('\n👋 Exiting browser...'));
+            break;
+        default:
+            console.log(chalk.yellow(`Unknown option "${choice}".`));
     }
 });
 program
@@ -1427,10 +1843,10 @@ program
         console.log(chalk.gray('━'.repeat(50)));
         console.log(chalk.bold('\n🗂️  Log File Information:'));
         try {
-            const logPath = path.resolve(process.cwd(), 'audit.log');
-            if (fs.existsSync(logPath)) {
-                const stats = fs.statSync(logPath);
-                console.log(`  Location: ${logPath}`);
+            const auditLogPath = path.resolve(process.cwd(), 'audit.log');
+            if (fs.existsSync(auditLogPath)) {
+                const stats = fs.statSync(auditLogPath);
+                console.log(`  Location: ${auditLogPath}`);
                 console.log(`  Size: ${stats.size} bytes (${(stats.size / 1024).toFixed(1)} KB)`);
                 console.log(`  Modified: ${stats.mtime.toLocaleString()}`);
                 console.log(`  Encrypted: ${auditLogger['config'].encryptionEnabled ? 'Yes' : 'No'}`);
@@ -1481,22 +1897,60 @@ program
     .description('Validate environment, config, and runtime readiness')
     .action(async () => {
     const results = [];
-    // Environment checks
-    const geminiKey = process.env.GEMINI_API_KEY;
-    const openaiKey = process.env.OPENAI_API_KEY;
-    const anthropicKey = process.env.ANTHROPIC_API_KEY;
-    results.push({
-        label: 'AI Provider API key',
-        ok: !!(geminiKey || openaiKey || anthropicKey),
-        hint: 'Set GEMINI_API_KEY, OPENAI_API_KEY, or ANTHROPIC_API_KEY in your environment',
-    });
     // Filesystem checks
     const configPath = path.resolve(process.cwd(), 'toknxr.config.json');
-    results.push({
-        label: `Provider config at ${configPath}`,
-        ok: fs.existsSync(configPath),
-        hint: 'Run: toknxr init',
-    });
+    let providerConfig;
+    if (fs.existsSync(configPath)) {
+        results.push({
+            label: `Provider config at ${configPath}`,
+            ok: true,
+        });
+        try {
+            const configFile = fs.readFileSync(configPath, 'utf8');
+            providerConfig = JSON.parse(configFile);
+        }
+        catch (error) {
+            results.push({
+                label: `Parse toknxr.config.json`,
+                ok: false,
+                hint: `Error parsing config file: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            });
+        }
+    }
+    else {
+        results.push({
+            label: `Provider config at ${configPath}`,
+            ok: false,
+            hint: 'Run: toknxr init',
+        });
+    }
+    // Environment variable checks for each configured provider
+    if (providerConfig && providerConfig.providers) {
+        for (const provider of providerConfig.providers) {
+            if (provider.apiKeyEnvVar) {
+                const apiKey = process.env[provider.apiKeyEnvVar];
+                results.push({
+                    label: `${provider.name} API Key (${provider.apiKeyEnvVar})`,
+                    ok: !!apiKey,
+                    hint: `Set ${provider.apiKeyEnvVar} in your environment or .env file`,
+                });
+            }
+            else {
+                results.push({
+                    label: `${provider.name} API Key`,
+                    ok: true,
+                    hint: 'No API key required for this provider',
+                });
+            }
+        }
+    }
+    else if (providerConfig) {
+        results.push({
+            label: 'No providers configured in toknxr.config.json',
+            ok: false,
+            hint: 'Edit toknxr.config.json to add AI providers',
+        });
+    }
     const logPath = path.resolve(process.cwd(), 'interactions.log');
     try {
         // Touch file if missing (no-op if exists)
@@ -1508,30 +1962,94 @@ program
         results.push({ label: `interactions.log at ${logPath}`, ok: false, hint: 'Check write permissions' });
     }
     // Runtime checks (proxy health if running)
-    let healthOk = false;
+    let proxyHealthOk = false;
     try {
         const res = await fetch('http://localhost:8788/health');
-        healthOk = res.ok;
+        proxyHealthOk = res.ok;
     }
     catch {
-        healthOk = false;
+        proxyHealthOk = false;
     }
     results.push({
-        label: 'Proxy reachable at http://localhost:8788/health',
-        ok: healthOk,
+        label: 'Proxy server running (http://localhost:8788/health)',
+        ok: proxyHealthOk,
         hint: 'Run: toknxr start (then retry doctor)'
     });
-    // Optional: add one fixture interaction if none exists and provider key missing
-    try {
-        const file = path.resolve(process.cwd(), 'interactions.log');
-        const hasKey = !!(process.env.GEMINI_API_KEY || process.env.OPENAI_API_KEY);
-        const size = fs.existsSync(file) ? fs.statSync(file).size : 0;
-        if (!hasKey && size === 0) {
-            const { appendFixtureInteraction } = await import('./fixtures/canary-interaction.js');
-            appendFixtureInteraction();
+    // AI Provider Connectivity Tests (only if proxy is running and config is loaded)
+    let anyProviderConnected = false;
+    if (proxyHealthOk && providerConfig && providerConfig.providers) {
+        for (const provider of providerConfig.providers) {
+            const apiKey = provider.apiKeyEnvVar ? process.env[provider.apiKeyEnvVar] : undefined;
+            if (provider.apiKeyEnvVar && !apiKey) {
+                results.push({
+                    label: `${provider.name} connection test`,
+                    ok: false,
+                    hint: `Skipped: API key (${provider.apiKeyEnvVar}) not set.`,
+                });
+                continue;
+            }
+            const { ok, message } = await testConnection(provider, apiKey);
+            if (ok) {
+                anyProviderConnected = true;
+            }
+            results.push({
+                label: `${provider.name} connection test`,
+                ok: ok,
+                hint: ok ? undefined : message,
+            });
+        }
+    }
+    else if (proxyHealthOk && !providerConfig) {
+        results.push({
+            label: 'AI Provider connection tests',
+            ok: false,
+            hint: 'Skipped: toknxr.config.json not loaded or invalid.',
+        });
+    }
+    else if (!proxyHealthOk) {
+        results.push({
+            label: 'AI Provider connection tests',
+            ok: false,
+            hint: 'Skipped: Proxy server is not running.',
+        });
+    }
+    // Conditional: add one sample interaction if none exists and at least one provider connected
+    const logFileExists = fs.existsSync(logPath);
+    let logFileSize = 0;
+    if (logFileExists) {
+        try {
+            logFileSize = fs.statSync(logPath).size;
         }
+        catch { }
+    }
+    if (anyProviderConnected && logFileSize === 0) {
+        const firstConnectedProvider = providerConfig?.providers.find((p) => {
+            const apiKey = p.apiKeyEnvVar ? process.env[p.apiKeyEnvVar] : undefined;
+            return p.apiKeyEnvVar ? !!apiKey : true; // Check if key is set for providers that need it
+        });
+        if (firstConnectedProvider) {
+            const { ok, message } = generateSampleInteraction(firstConnectedProvider.name, logPath);
+            results.push({
+                label: 'Generate sample interaction',
+                ok: ok,
+                hint: ok ? 'Run: toknxr stats or toknxr code-analysis' : message,
+            });
+        }
+    }
+    else if (logFileSize > 0) {
+        results.push({
+            label: 'Generate sample interaction',
+            ok: true,
+            hint: 'interactions.log already contains data.',
+        });
+    }
+    else {
+        results.push({
+            label: 'Generate sample interaction',
+            ok: false,
+            hint: 'No connected providers or interactions.log already has data.',
+        });
     }
-    catch { }
     // Print report
     console.log(chalk.blue.bold('\nTokNXR Doctor Report'));
     console.log(chalk.gray('━'.repeat(60)));
@@ -1544,7 +2062,7 @@ program
     }
     console.log(chalk.gray('━'.repeat(60)));
     if (allOk) {
-        console.log(chalk.green('All checks passed. You are ready to use TokNXR.'));
+        console.log(chalk.green('All essential checks passed. You are ready to use TokNXR.'));
     }
     else {
         console.log(chalk.yellow('Some checks failed. Fix the hints above and re-run: toknxr doctor'));
@@ -1576,4 +2094,10 @@ function highlightMatch(text, query) {
     });
     return highlighted;
 }
-program.parse(process.argv);
+program.exitOverride();
+try {
+    program.parse(process.argv);
+}
+catch (e) {
+    // This will catch the exit override and prevent the process from exiting
+}

package/lib/ui.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import readline from 'readline';
+import inquirer from 'inquirer';
 export const createStatsOverview = (cost, requests, waste, hallucinations) => `
   ${chalk.bold.blue('📊 TokNXR Analytics Overview')}
   ${chalk.gray('------------------------------------')}
@@ -45,19 +45,16 @@ export const createOperationProgress = (title, steps) => {
     console.log(chalk.bold.blue(title));
     return spinner;
 };
-export const createInteractiveMenu = (options) => {
-    return new Promise(resolve => {
-        console.log(chalk.bold.blue('MENU'));
-        options.forEach(option => console.log(option.name));
-        const rl = readline.createInterface({
-            input: process.stdin,
-            output: process.stdout,
-        });
-        rl.question('Choose an option: ', answer => {
-            rl.close();
-            resolve(answer);
-        });
-    });
+export const createInteractiveMenu = async (options) => {
+    const { choice } = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'choice',
+            message: 'Select an operation:',
+            choices: options,
+        },
+    ]);
+    return choice;
 };
 export const createBox = (title, content, options) => {
     const { borderColor, titleColor } = options;

package/lib/utils.js

@@ -0,0 +1,117 @@
+import axios from 'axios';
+import * as fs from 'node:fs';
+// Helper to resolve dot notation paths (copied from proxy.ts for consistency)
+const getValueFromPath = (obj, path) => {
+    if (!path || !obj)
+        return 0;
+    try {
+        const result = path.split('.').reduce((res, prop) => res && typeof res === 'object' && prop in res ? res[prop] : undefined, obj);
+        return Number(result) || 0;
+    }
+    catch {
+        return 0;
+    }
+};
+// Minimal payload for testing various providers
+const TEST_PAYLOADS = {
+    'gemini': {
+        contents: [{ parts: [{ text: "Hello" }] }]
+    },
+    'openai': {
+        model: "gpt-3.5-turbo",
+        messages: [{ role: "user", content: "Hello" }]
+    },
+    'anthropic': {
+        model: "claude-3-opus-20240229",
+        messages: [{ role: "user", content: "Hello" }],
+        max_tokens: 10
+    },
+    'ollama': {
+        model: "llama3",
+        prompt: "Hello",
+        stream: false
+    }
+};
+export async function testConnection(provider, apiKey) {
+    const proxyUrl = `http://localhost:8788${provider.routePrefix}`;
+    const testPayload = TEST_PAYLOADS[provider.name.toLowerCase().split('-')[0]] || TEST_PAYLOADS['gemini']; // Default to gemini payload
+    if (!testPayload) {
+        return { ok: false, message: `No test payload defined for provider: ${provider.name}` };
+    }
+    try {
+        const headers = { 'Content-Type': 'application/json' };
+        // The proxy handles adding the actual API key to the upstream request
+        // We just need to ensure the proxy itself is reachable and responds
+        // For the test, we don't need to pass the API key here, as the proxy will add it.
+        // However, if the proxy itself fails due to missing key, that's what we want to catch.
+        const res = await axios.post(proxyUrl, testPayload, {
+            headers,
+            timeout: 5000, // 5 second timeout
+            validateStatus: () => true, // Don't throw on non-2xx status codes
+        });
+        if (res.status === 200) {
+            // Basic check for a valid response structure
+            if (res.data && (res.data.candidates || res.data.choices || res.data.response)) {
+                return { ok: true };
+            }
+            else {
+                return { ok: false, message: `Unexpected response format from ${provider.name}` };
+            }
+        }
+        else if (res.status === 401 || res.status === 403) {
+            return { ok: false, message: `Authentication failed (Status: ${res.status}). Check API key.` };
+        }
+        else if (res.status === 429) {
+            return { ok: false, message: `Rate limit exceeded (Status: ${res.status}).` };
+        }
+        else if (res.status === 500 && res.data && res.data.error) {
+            // Catch specific proxy errors, e.g., "API key not set"
+            return { ok: false, message: `Proxy error: ${res.data.error}` };
+        }
+        else {
+            return { ok: false, message: `Proxy returned status ${res.status}: ${JSON.stringify(res.data)}` };
+        }
+    }
+    catch (error) {
+        if (axios.isAxiosError(error)) {
+            if (error.code === 'ECONNREFUSED' || error.code === 'ENOTFOUND') {
+                return { ok: false, message: `Proxy not running or unreachable at ${proxyUrl}.` };
+            }
+            else if (error.response) {
+                return { ok: false, message: `Proxy returned status ${error.response.status}: ${JSON.stringify(error.response.data)}` };
+            }
+            return { ok: false, message: `Network error: ${error.message}` };
+        }
+        return { ok: false, message: `Unknown error during connection test: ${error.message}` };
+    }
+}
+export function generateSampleInteraction(providerName, logFilePath) {
+    const sampleInteraction = {
+        requestId: `sample-${Date.now()}`,
+        timestamp: new Date().toISOString(),
+        provider: providerName,
+        model: `${providerName}-test-model`,
+        promptTokens: 10,
+        completionTokens: 20,
+        totalTokens: 30,
+        costUSD: 0.0005,
+        taskType: 'chat',
+        userPrompt: 'Generate a sample interaction for testing.',
+        aiResponse: 'This is a sample AI response generated by the doctor command.',
+        codeQualityScore: 85,
+        effectivenessScore: 90,
+        hallucinationDetection: {
+            isLikelyHallucination: false,
+            confidence: 5,
+            severity: 'low',
+            issues: []
+        }
+    };
+    try {
+        fs.appendFileSync(logFilePath, JSON.stringify(sampleInteraction) + '\n');
+        return { ok: true, message: `Generated sample interaction for ${providerName}.` };
+    }
+    catch (error) {
+        return { ok: false, message: `Failed to write sample interaction: ${error.message}` };
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goldensheepai/toknxr-cli",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "CLI-powered AI effectiveness & code quality analysis tool - 100% Local",
   "license": "MIT",
   "type": "module",