mcp-prompt-optimizer 1.3.2 → 1.3.3

package/lib/diagnose.js file.txt

@@ -0,0 +1,252 @@
+#!/usr/bin/env node
+
+/**
+ * Diagnostic Command for MCP Prompt Optimizer
+ * Enhanced with comprehensive network analysis and development mode support
+ */
+
+const CloudApiKeyManager = require('./api-key-manager');
+const packageJson = require('../package.json');
+
+async function runDiagnostic() {
+    const developmentMode = process.env.NODE_ENV === 'development' || process.env.OPTIMIZER_DEV_MODE === 'true';
+    const modeText = developmentMode ? ' (Development Mode)' : '';
+    
+    console.log(`🔬 MCP Prompt Optimizer v${packageJson.version} - Comprehensive Diagnostic${modeText}\n`);
+    
+    try {
+        const apiKey = process.env.OPTIMIZER_API_KEY;
+        
+        if (!apiKey) {
+            console.log('⚠️  No API key found, running partial diagnostic');
+            console.log('Set OPTIMIZER_API_KEY for complete analysis\n');
+        }
+
+        const manager = new CloudApiKeyManager(apiKey || 'dummy-key-for-diagnostic', { 
+            developmentMode 
+        });
+        const diagnostic = await manager.getDiagnosticInfo();
+        
+        console.log('📋 Diagnostic Information:');
+        console.log('=' .repeat(60));
+        
+        // Basic system information
+        console.log(`🔑 API Key: ${diagnostic.apiKey}`);
+        console.log(`🌐 Backend URL: ${diagnostic.backendUrl}`);
+        console.log(`💾 Cache File: ${diagnostic.cacheFile}`);
+        console.log(`🏥 Health File: ${diagnostic.healthFile}`);
+        console.log(`⏰ Cache Expiry: ${diagnostic.cacheExpiry / 1000 / 60} minutes`);
+        console.log(`⏰ Fallback Cache Expiry: ${diagnostic.fallbackCacheExpiry / 1000 / 60 / 60} hours`);
+        console.log(`📱 Offline Mode: ${diagnostic.offlineMode}`);
+        console.log(`🧪 Development Mode: ${diagnostic.developmentMode}`);
+        console.log(`🔄 Max Retries: ${diagnostic.maxRetries}`);
+        console.log(`⏱️  Request Timeout: ${diagnostic.requestTimeout}ms`);
+        console.log(`🔧 Node Environment: ${diagnostic.nodeEnv || 'not set'}`);
+        console.log(`📦 Package Version: ${diagnostic.packageVersion}`);
+        
+        // Network health section
+        console.log('\n🌐 Network Health:');
+        const health = diagnostic.networkHealth;
+        console.log(`   📊 Consecutive Failures: ${health.consecutiveFailures}`);
+        console.log(`   ✅ Last Successful: ${health.lastSuccessful ? new Date(health.lastSuccessful).toLocaleString() : 'Never'}`);
+        console.log(`   ⚡ Avg Response Time: ${health.avgResponseTime ? health.avgResponseTime + 'ms' : 'Unknown'}`);
+        console.log(`   ❌ Last Error Type: ${health.lastErrorType || 'None'}`);
+        
+        // Cache status
+        console.log('\n📄 Cache Status:');
+        if (diagnostic.cache.error) {
+            console.log(`   ❌ Error: ${diagnostic.cache.error}`);
+        } else {
+            console.log(`   📁 Exists: ${diagnostic.cache.exists}`);
+            console.log(`   ⏳ Normal Cache Expired: ${diagnostic.cache.expired}`);
+            console.log(`   🔄 Fallback Cache Expired: ${diagnostic.cache.fallbackExpired}`);
+            console.log(`   📅 Age: ${diagnostic.cache.age} minutes`);
+            
+            if (diagnostic.cache.backendUrl) {
+                console.log(`   🌐 Cached Backend: ${diagnostic.cache.backendUrl}`);
+            }
+            if (diagnostic.cache.packageVersion) {
+                console.log(`   📦 Cached Version: ${diagnostic.cache.packageVersion}`);
+            }
+        }
+        
+        // API key format check
+        console.log('\n🔍 API Key Format Check:');
+        if (diagnostic.keyFormat.valid) {
+            console.log(`   ✅ Valid: ${diagnostic.keyFormat.keyType}`);
+        } else {
+            console.log(`   ❌ Invalid: ${diagnostic.keyFormat.error}`);
+        }
+        
+        // Backend connectivity analysis
+        console.log('\n🌐 Backend Connectivity Analysis:');
+        const connectivity = diagnostic.backendConnectivity;
+        if (connectivity.status === 'success') {
+            console.log('   ✅ Connection successful');
+            if (connectivity.responseTime) {
+                console.log(`   ⚡ Response time: ${connectivity.responseTime}ms`);
+            }
+        } else {
+            console.log(`   ❌ Connection failed: ${connectivity.error}`);
+            
+            // Enhanced error analysis
+            if (connectivity.dns) {
+                console.log('   🔍 Issue Type: DNS Resolution Failure');
+                console.log('   💡 Likely Causes:');
+                console.log('      - Internet connection issues');
+                console.log('      - DNS server problems');
+                console.log('      - Corporate firewall blocking DNS');
+                console.log('      - VPN/proxy configuration issues');
+            } else if (connectivity.connection) {
+                console.log('   🔍 Issue Type: Connection Refused/Reset');
+                console.log('   💡 Likely Causes:');
+                console.log('      - Backend server is down');
+                console.log('      - Port blocking by firewall');
+                console.log('      - Network routing issues');
+                console.log('      - Load balancer problems');
+            } else if (connectivity.timeout) {
+                console.log('   🔍 Issue Type: Connection Timeout');
+                console.log('   💡 Likely Causes:');
+                console.log('      - Slow network connection');
+                console.log('      - Backend server overload');
+                console.log('      - Proxy/firewall delays');
+                console.log('      - Geographic distance');
+            } else if (connectivity.network) {
+                console.log('   🔍 Issue Type: General Network Error');
+                console.log('   💡 Likely Causes:');
+                console.log('      - Network instability');
+                console.log('      - ISP issues');
+                console.log('      - WiFi connectivity problems');
+                console.log('      - Mobile data limitations');
+            }
+        }
+        
+        // Development mode specific information
+        if (developmentMode) {
+            console.log('\n🧪 Development Mode Analysis:');
+            console.log('   ✅ Development mode active');
+            console.log('   🔄 Mock responses available');
+            console.log('   📴 Offline operation supported');
+            console.log('   🧪 No backend dependency required');
+            
+            if (apiKey && (apiKey.startsWith('sk-dev-') || apiKey.startsWith('sk-local-'))) {
+                console.log('   ✅ Development API key detected');
+            } else {
+                console.log('   ⚠️  Consider using development API key (sk-dev-* or sk-local-*)');
+            }
+        }
+        
+        // Recommendations section
+        console.log('\n💡 Recommendations:');
+        
+        if (!apiKey) {
+            console.log('   🔑 Set API key: export OPTIMIZER_API_KEY=sk-opt-your-key');
+            console.log('   🆓 Get free trial: https://promptoptimizer-blog.vercel.app/pricing');
+        }
+        
+        if (health.consecutiveFailures > 0) {
+            console.log(`   🔄 ${health.consecutiveFailures} consecutive network failures detected`);
+            console.log('   🧪 Consider development mode: export OPTIMIZER_DEV_MODE=true');
+            console.log('   📡 Check network connectivity and firewall settings');
+        }
+        
+        if (diagnostic.cache.exists && diagnostic.cache.expired && !diagnostic.cache.fallbackExpired) {
+            console.log('   💾 Cache available for fallback mode');
+            console.log('   🔄 Package can operate with reduced functionality');
+        }
+        
+        if (!developmentMode && connectivity.status === 'failed') {
+            console.log('   🧪 Try development mode for offline testing:');
+            console.log('      export OPTIMIZER_DEV_MODE=true');
+            console.log('      export OPTIMIZER_API_KEY=sk-dev-test-key');
+        }
+        
+        if (connectivity.status === 'success' && health.avgResponseTime > 5000) {
+            console.log('   ⚡ Network latency is high (>5s)');
+            console.log('   🌐 Consider checking network quality or VPN settings');
+        }
+        
+        // Action items
+        console.log('\n🎯 Suggested Actions:');
+        
+        if (connectivity.status === 'failed') {
+            console.log('   1. 🌐 Test basic internet: ping google.com');
+            console.log('   2. 🔍 Check DNS: nslookup p01--project-optimizer--fvrdk8m9k9j.code.run');
+            console.log('   3. 🛡️  Verify firewall allows HTTPS traffic');
+            console.log('   4. 🔄 Try again in a few minutes');
+            console.log('   5. 🧪 Use development mode for immediate testing');
+        } else {
+            console.log('   1. ✅ Network connectivity is working well');
+            console.log('   2. 🚀 Ready for production use');
+            
+            if (!apiKey || !diagnostic.keyFormat.valid) {
+                console.log('   3. 🔑 Set up proper API key for full functionality');
+            } else {
+                console.log('   3. 🎯 All systems operational');
+            }
+        }
+        
+        // Network environment detection
+        console.log('\n🌍 Network Environment:');
+        const userAgent = `mcp-prompt-optimizer/${diagnostic.packageVersion}`;
+        console.log(`   📱 User Agent: ${userAgent}`);
+        console.log(`   🏢 Corporate Network: ${connectivity.timeout || connectivity.dns ? 'Likely' : 'Unlikely'}`);
+        console.log(`   🔒 Firewall/Proxy: ${connectivity.timeout ? 'Possible' : 'Unlikely'}`);
+        console.log(`   📶 Connection Quality: ${health.avgResponseTime ? 
+            (health.avgResponseTime < 1000 ? 'Excellent' : 
+             health.avgResponseTime < 3000 ? 'Good' : 
+             health.avgResponseTime < 5000 ? 'Fair' : 'Poor') : 'Unknown'}`);
+        
+        console.log(`\n🕐 Generated: ${diagnostic.timestamp}`);
+        
+        // Final status summary
+        console.log('\n' + '='.repeat(60));
+        console.log('📊 DIAGNOSTIC SUMMARY:');
+        
+        const issues = [];
+        const working = [];
+        
+        if (!apiKey) issues.push('No API key configured');
+        else working.push('API key present');
+        
+        if (!diagnostic.keyFormat.valid) issues.push('Invalid API key format');
+        else working.push('API key format valid');
+        
+        if (connectivity.status === 'failed') issues.push('Backend connectivity failed');
+        else working.push('Backend connectivity working');
+        
+        if (diagnostic.cache.error) issues.push('Cache system error');
+        else working.push('Cache system working');
+        
+        if (health.consecutiveFailures > 3) issues.push('Multiple network failures');
+        else working.push('Network stability good');
+        
+        console.log(`✅ Working (${working.length}): ${working.join(', ')}`);
+        if (issues.length > 0) {
+            console.log(`⚠️  Issues (${issues.length}): ${issues.join(', ')}`);
+        }
+        
+        const overallStatus = issues.length === 0 ? 'EXCELLENT' : 
+                             issues.length <= 2 ? 'GOOD' : 'NEEDS ATTENTION';
+        console.log(`\n🎯 Overall Status: ${overallStatus}`);
+        
+        if (developmentMode) {
+            console.log('🧪 Development mode provides full offline functionality');
+        }
+        
+    } catch (error) {
+        console.error('❌ Diagnostic failed:', error.message);
+        console.log('\n🆘 Emergency Diagnostic:');
+        console.log('   - Package installation may be corrupted');
+        console.log('   - Try: npm install --force');
+        console.log('   - Ensure Node.js version >= 16.0.0');
+        console.log('   - Contact support: support@promptoptimizer.help');
+        process.exit(1);
+    }
+}
+
+if (require.main === module) {
+    runDiagnostic();
+}
+
+module.exports = runDiagnostic;

package/lib/test-integration.js

@@ -0,0 +1,250 @@
+#!/usr/bin/env node
+
+/**
+ * Test Integration Command for MCP Prompt Optimizer
+ * Enhanced with development mode support and comprehensive network testing
+ */
+
+const CloudApiKeyManager = require('./api-key-manager');
+const packageJson = require('../package.json');
+
+async function testIntegration() {
+    const developmentMode = process.env.NODE_ENV === 'development' || process.env.OPTIMIZER_DEV_MODE === 'true';
+    const modeText = developmentMode ? ' (Development Mode)' : '';
+    
+    console.log(`🧪 MCP Prompt Optimizer v${packageJson.version} - Integration Test${modeText}\n`);
+    
+    try {
+        const apiKey = process.env.OPTIMIZER_API_KEY;
+        
+        if (!apiKey) {
+            console.error('❌ No API key found for testing');
+            console.log('📝 Set API key for complete testing:');
+            console.log('   export OPTIMIZER_API_KEY=sk-opt-your-key');
+            
+            if (developmentMode) {
+                console.log('\n🧪 Development Mode Options:');
+                console.log('   export OPTIMIZER_API_KEY=sk-dev-test-key');
+                console.log('   export OPTIMIZER_API_KEY=sk-local-test-key');
+                console.log('   Features: Offline testing, mock responses');
+            }
+            
+            process.exit(1);
+        }
+
+        const manager = new CloudApiKeyManager(apiKey, { developmentMode });
+        
+        console.log('🔬 Running comprehensive integration tests...\n');
+        console.log('📋 Test Configuration:');
+        console.log(`   🔑 API Key: ${apiKey.substring(0, 16)}...`);
+        console.log(`   🧪 Development Mode: ${developmentMode}`);
+        console.log(`   🌐 Backend URL: ${manager.backendUrl}`);
+        console.log(`   🔄 Max Retries: ${manager.maxRetries}`);
+        console.log(`   ⏱️  Timeout: ${manager.requestTimeout}ms`);
+        console.log('');
+        
+        const results = await manager.testIntegration();
+        
+        console.log('📋 Integration Test Results:');
+        console.log('=' .repeat(60));
+        
+        let totalTests = 0;
+        let passedTests = 0;
+        
+        Object.entries(results).forEach(([testName, result]) => {
+            if (testName === 'generalError') {
+                console.log(`❌ General Error: ${result}`);
+                return;
+            }
+            
+            if (testName === 'networkHealth') {
+                console.log(`📊 Network Health: ${JSON.stringify(result, null, 2)}`);
+                return;
+            }
+            
+            totalTests++;
+            const status = result.passed ? '✅ PASS' : '❌ FAIL';
+            const displayName = testName.replace(/([A-Z])/g, ' $1').trim()
+                .replace(/^\w/, c => c.toUpperCase());
+            
+            console.log(`${status} ${displayName}`);
+            
+            if (result.passed) {
+                passedTests++;
+                
+                // Show additional success details
+                if (result.keyType) {
+                    console.log(`     ✓ Key Type: ${result.keyType}`);
+                }
+                if (result.tier) {
+                    console.log(`     ✓ Tier: ${result.tier}`);
+                }
+                if (result.responseStructure) {
+                    console.log(`     ✓ Response Fields: ${result.responseStructure.join(', ')}`);
+                }
+                if (result.avgResponseTime) {
+                    console.log(`     ✓ Avg Response Time: ${result.avgResponseTime}ms`);
+                }
+                if (result.cacheAge !== undefined) {
+                    console.log(`     ✓ Cache Age: ${result.cacheAge}s`);
+                }
+                if (result.mode) {
+                    const modes = [];
+                    if (result.mode.development) modes.push('Development');
+                    if (result.mode.mock) modes.push('Mock');
+                    if (result.mode.fallback) modes.push('Fallback');
+                    if (result.mode.offline) modes.push('Offline');
+                    
+                    if (modes.length > 0) {
+                        console.log(`     ✓ Mode: ${modes.join(', ')}`);
+                    }
+                }
+            } else {
+                // Show failure details
+                if (result.error) {
+                    console.log(`     ✗ Error: ${result.error}`);
+                }
+                if (result.consecutiveFailures) {
+                    console.log(`     ✗ Consecutive Failures: ${result.consecutiveFailures}`);
+                }
+            }
+        });
+        
+        // Network health analysis
+        if (results.networkHealth) {
+            console.log('\n🌐 Network Health Analysis:');
+            const health = results.networkHealth;
+            
+            console.log(`   📊 Consecutive Failures: ${health.consecutiveFailures}`);
+            console.log(`   ✅ Last Successful: ${health.lastSuccessful ? new Date(health.lastSuccessful).toLocaleString() : 'Never'}`);
+            console.log(`   ⚡ Avg Response Time: ${health.avgResponseTime ? health.avgResponseTime + 'ms' : 'Unknown'}`);
+            console.log(`   ❌ Last Error: ${health.lastErrorType || 'None'}`);
+            
+            // Network quality assessment
+            if (health.avgResponseTime) {
+                const quality = health.avgResponseTime < 1000 ? 'Excellent' :
+                               health.avgResponseTime < 3000 ? 'Good' :
+                               health.avgResponseTime < 5000 ? 'Fair' : 'Poor';
+                console.log(`   📶 Connection Quality: ${quality}`);
+            }
+            
+            if (health.consecutiveFailures > 0) {
+                console.log(`   ⚠️  Network instability detected`);
+            }
+        }
+        
+        console.log('\n' + '='.repeat(60));
+        console.log(`📊 Integration Test Summary: ${passedTests}/${totalTests} tests passed`);
+        
+        if (passedTests === totalTests) {
+            console.log('🎉 All integration tests passed! System is working correctly.');
+            
+            if (developmentMode) {
+                console.log('\n🧪 Development Mode Features Verified:');
+                console.log('   ✅ Mock validation working');
+                console.log('   ✅ Offline operation capability');
+                console.log('   ✅ Development key support');
+                console.log('   ✅ Enhanced debugging available');
+            } else {
+                console.log('\n🚀 Production Features Verified:');
+                console.log('   ✅ Backend connectivity established');
+                console.log('   ✅ API key validation working');
+                console.log('   ✅ Network resilience active');
+                console.log('   ✅ Caching system operational');
+            }
+            
+            console.log('\n📈 Performance Metrics:');
+            if (results.backendConnectivity?.avgResponseTime) {
+                const responseTime = results.backendConnectivity.avgResponseTime;
+                console.log(`   ⚡ Backend Response: ${responseTime}ms`);
+                
+                if (responseTime < 1000) {
+                    console.log('   🚀 Excellent response time');
+                } else if (responseTime < 3000) {
+                    console.log('   ✅ Good response time');
+                } else {
+                    console.log('   ⚠️  Consider checking network quality');
+                }
+            }
+            
+            console.log('\n🎯 Ready for:');
+            console.log('   ✅ MCP client integration');
+            console.log('   ✅ Production optimization workloads');
+            console.log('   ✅ Team collaboration');
+            console.log('   ✅ Enterprise deployment');
+            
+        } else {
+            console.log('⚠️  Some integration tests failed. Review issues above.');
+            
+            const failedTests = totalTests - passedTests;
+            
+            if (results.backendConnectivity && !results.backendConnectivity.passed) {
+                console.log('\n🌐 Backend Connectivity Issues:');
+                console.log('   - Check internet connection');
+                console.log('   - Verify firewall/proxy settings');
+                console.log('   - Backend may be temporarily unavailable');
+                
+                if (!developmentMode) {
+                    console.log('   - Try development mode: export OPTIMIZER_DEV_MODE=true');
+                }
+            }
+            
+            if (results.formatValidation && !results.formatValidation.passed) {
+                console.log('\n🔑 API Key Format Issues:');
+                console.log('   - Check API key format (sk-opt-*, sk-team-*, sk-dev-*, sk-local-*)');
+                console.log('   - Get new key: https://promptoptimizer-blog.vercel.app/pricing');
+            }
+            
+            if (results.cacheOperations && !results.cacheOperations.passed) {
+                console.log('\n💾 Cache System Issues:');
+                console.log('   - Clear cache: mcp-prompt-optimizer clear-cache');
+                console.log('   - Check file system permissions');
+            }
+            
+            console.log('\n🛠️  Recommended Actions:');
+            console.log('   1. Run diagnostic: mcp-prompt-optimizer diagnose');
+            console.log('   2. Clear cache: mcp-prompt-optimizer clear-cache');
+            console.log('   3. Validate key: mcp-prompt-optimizer validate-key');
+            
+            if (failedTests > 2) {
+                console.log('   4. Check system requirements');
+                console.log('   5. Contact support: support@promptoptimizer.help');
+            }
+            
+            if (!developmentMode && results.backendConnectivity && !results.backendConnectivity.passed) {
+                console.log('\n🧪 Alternative: Try Development Mode');
+                console.log('   export OPTIMIZER_DEV_MODE=true');
+                console.log('   export OPTIMIZER_API_KEY=sk-dev-test-key');
+                console.log('   mcp-prompt-optimizer test');
+                console.log('   Features: Offline operation, mock responses, no backend required');
+            }
+            
+            process.exit(1);
+        }
+        
+        console.log('\n💡 Integration Complete. System ready for MCP client connections.');
+        
+    } catch (error) {
+        console.error('❌ Integration test failed:', error.message);
+        
+        console.log('\n🛠️  Emergency Troubleshooting:');
+        console.log('   1. Check Node.js version: node --version (>= 16.0.0)');
+        console.log('   2. Reinstall dependencies: npm install');
+        console.log('   3. Clear all cache: mcp-prompt-optimizer clear-cache');
+        console.log('   4. Run diagnostic: mcp-prompt-optimizer diagnose');
+        
+        if (!developmentMode) {
+            console.log('   5. Try development mode: export OPTIMIZER_DEV_MODE=true');
+        }
+        
+        console.log('   6. Contact support: support@promptoptimizer.help');
+        
+        process.exit(1);
+    }
+}
+
+if (require.main === module) {
+    testIntegration();
+}
+
+module.exports = testIntegration;