mcp-prompt-optimizer 1.3.2 → 1.3.3

package/lib/clear-cache.js

@@ -1,100 +1,134 @@
 #!/usr/bin/env node
 
 /**
- * Clear Cache Utility for MCP Prompt Optimizer
- * Clears validation cache and provides fresh start
+ * Clear Cache Command for MCP Prompt Optimizer
+ * Enhanced with network health data clearing and development mode support
  */
 
 const CloudApiKeyManager = require('./api-key-manager');
-const fs = require('fs').promises;
-const path = require('path');
-const os = require('os');
+const packageJson = require('../package.json');
 
 async function clearCache() {
-    console.log('🗑️  MCP Prompt Optimizer - Clear Cache\n');
-
-    const cacheFile = path.join(os.homedir(), '.mcp-cloud-api-cache.json');
-    let cacheCleared = false;
-
+    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} - Clear Cache${modeText}\n`);
+    
     try {
-        // Check if cache file exists
-        await fs.access(cacheFile);
-        
-        // Read cache info before clearing
-        try {
-            const cacheContent = await fs.readFile(cacheFile, 'utf8');
-            const cacheData = JSON.parse(cacheContent);
-            const cacheAge = Date.now() - cacheData.timestamp;
-            const ageHours = Math.floor(cacheAge / (1000 * 60 * 60));
-            const ageMinutes = Math.floor((cacheAge % (1000 * 60 * 60)) / (1000 * 60));
-            
-            console.log('📄 Found cache file:');
-            console.log(`   Location: ${cacheFile}`);
-            console.log(`   Age: ${ageHours}h ${ageMinutes}m`);
-            if (cacheData.data && cacheData.data.tier) {
-                console.log(`   Cached tier: ${cacheData.data.tier}`);
-            }
-        } catch (parseError) {
-            console.log('📄 Found cache file (invalid format)');
+        const apiKey = process.env.OPTIMIZER_API_KEY;
+        
+        if (!apiKey) {
+            console.log('⚠️  No API key found, clearing system caches only');
         }
 
-        // Clear the cache
-        await fs.unlink(cacheFile);
-        cacheCleared = true;
-        console.log('\n✅ Cache cleared successfully');
-
-    } catch (error) {
-        if (error.code === 'ENOENT') {
-            console.log('📄 No cache file found - nothing to clear');
-        } else {
-            console.warn(`⚠️  Error accessing cache: ${error.message}`);
+        // Create manager instance for cache operations
+        const manager = new CloudApiKeyManager(apiKey || 'dummy-key-for-cache-clear', { 
+            developmentMode 
+        });
+        
+        console.log('🔍 Analyzing cache status...');
+        
+        // Check what caches exist before clearing
+        const diagnostic = await manager.getDiagnosticInfo();
+        
+        let cachesFound = 0;
+        let healthDataFound = false;
+        
+        if (diagnostic.cache.exists) {
+            cachesFound++;
+            console.log(`📄 Found validation cache (${diagnostic.cache.age} minutes old)`);
         }
-    }
-
-    // Also try to clear any additional cache files
-    const additionalCaches = [
-        path.join(os.homedir(), '.mcp-prompt-optimizer-cache.json'),
-        path.join(os.homedir(), '.optimizer-cache.json'),
-        path.join(os.homedir(), '.mcp-cache.json')
-    ];
-
-    for (const cacheFile of additionalCaches) {
-        try {
-            await fs.access(cacheFile);
-            await fs.unlink(cacheFile);
-            console.log(`✅ Cleared additional cache: ${path.basename(cacheFile)}`);
-            cacheCleared = true;
-        } catch (error) {
-            // File doesn't exist, that's fine
+        
+        if (diagnostic.networkHealth.lastSuccessful || diagnostic.networkHealth.consecutiveFailures > 0) {
+            healthDataFound = true;
+            console.log(`🏥 Found network health data (${diagnostic.networkHealth.consecutiveFailures} failures recorded)`);
         }
-    }
-
-    if (cacheCleared) {
-        console.log('\n🚀 Cache cleared - next validation will be fresh');
-        console.log('\n📝 What this means:');
-        console.log('   - API key will be re-validated with backend');
-        console.log('   - Fresh quota information will be fetched');
-        console.log('   - Any cached errors will be cleared');
-        
-        console.log('\n🔧 Next Steps:');
-        console.log('   1. Test your API key: mcp-prompt-optimizer validate-key');
+        
+        if (cachesFound === 0 && !healthDataFound) {
+            console.log('✨ No caches found - system is already clean!');
+            console.log('\n📊 Cache Status: Clean');
+            console.log('🏥 Network Health: Clean');
+            return;
+        }
+        
+        console.log('\n🧹 Clearing caches...');
+        
+        // Clear all caches
+        await manager.clearCache();
+        
+        console.log('✅ Cache clearing completed successfully!\n');
+        
+        // Report what was cleared
+        console.log('📊 Cleared Items:');
+        if (cachesFound > 0) {
+            console.log('   ✅ API key validation cache');
+            console.log('   ✅ Subscription status cache');
+            console.log('   ✅ Backend response cache');
+        }
+        
+        if (healthDataFound) {
+            console.log('   ✅ Network health metrics');
+            console.log('   ✅ Connection failure history');
+            console.log('   ✅ Response time statistics');
+        }
+        
+        console.log('\n🎯 Benefits of Cache Clearing:');
+        console.log('   🔄 Forces fresh API key validation');
+        console.log('   📡 Tests current backend connectivity');
+        console.log('   🧹 Removes stale network health data');
+        console.log('   🔍 Enables accurate diagnostic information');
+        console.log('   ⚡ May resolve authentication issues');
+        
+        if (developmentMode) {
+            console.log('\n🧪 Development Mode Notes:');
+            console.log('   🔄 Mock cache data cleared');
+            console.log('   📴 Ready for fresh offline testing');
+            console.log('   🧪 Development flags reset');
+        }
+        
+        console.log('\n📝 Next Steps:');
+        console.log('   1. Run validation: mcp-prompt-optimizer validate-key');
         console.log('   2. Check status: mcp-prompt-optimizer check-status');
-        console.log('   3. Start using: Configure in Claude Desktop');
-    } else {
-        console.log('\n✨ No cache found - your setup is already clean');
+        console.log('   3. Test integration: mcp-prompt-optimizer test');
+        console.log('   4. Run diagnostic: mcp-prompt-optimizer diagnose');
+        
+        console.log('\n💡 When to Clear Cache:');
+        console.log('   🔑 After updating API key');
+        console.log('   🌐 When experiencing connection issues');
+        console.log('   🔄 After changing backend URL');
+        console.log('   🧪 Before switching between dev/production modes');
+        console.log('   🛠️  When troubleshooting authentication problems');
+        
+    } catch (error) {
+        console.error(`❌ Cache clearing failed: ${error.message}\n`);
+        
+        if (error.message.includes('ENOENT')) {
+            console.log('ℹ️  Cache files not found - nothing to clear');
+            console.log('✨ System is already clean!');
+        } else if (error.message.includes('EACCES') || error.message.includes('permission')) {
+            console.log('🔒 Permission Issue:');
+            console.log('   - Cache files may be locked by another process');
+            console.log('   - Try running with elevated permissions');
+            console.log('   - Ensure no other MCP processes are running');
+        } else {
+            console.log('🛠️  Troubleshooting:');
+            console.log('   1. Check file system permissions');
+            console.log('   2. Ensure no processes are using cache files');
+            console.log('   3. Try restarting terminal/command prompt');
+            console.log('   4. Contact support if issue persists');
+        }
+        
+        console.log('\n📁 Manual Cache Locations:');
+        console.log(`   Validation: ${diagnostic?.cacheFile || '~/.mcp-cloud-api-cache.json'}`);
+        console.log(`   Health: ${diagnostic?.healthFile || '~/.mcp-cloud-health.json'}`);
+        console.log('   You can manually delete these files if needed');
+        
+        process.exit(1);
     }
-
-    // Offer to validate immediately
-    console.log('\n💡 Want to validate your API key now?');
-    console.log('   Run: mcp-prompt-optimizer validate-key');
 }
 
-// Run if called directly
 if (require.main === module) {
-    clearCache().catch(error => {
-        console.error(`❌ Error clearing cache: ${error.message}`);
-        process.exit(1);
-    });
+    clearCache();
 }
 
 module.exports = clearCache;

package/lib/diagnose.js

@@ -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;