natureco-cli 2.23.29 → 2.23.31

package/src/commands/doctor.js

@@ -1,492 +1,143 @@
-const chalk = require('chalk');
-const fs = require('fs');
-const path = require('path');
-const net = require('net');
-const { getConfig, saveConfig, CONFIG_FILE, CONFIG_DIR, listBackups } = require('../utils/config');
-const { getBots } = require('../utils/api');
-const { getSkills } = require('../utils/skills');
-const { NatureCoError, ApiError, ConfigError, handleError } = require('../utils/errors');
-const { listSecretRefs, resolveSecretRef } = require('../utils/secrets');
-const { loadApprovals, resolveEffectivePolicy } = require('../utils/approvals');
-
-async function doctor(options) {
-  const shouldFix = options && (options.includes('--fix') || options.includes('-f'));
-  
-  console.clear();
-  console.log('');
-  console.log(chalk.green.bold('  (\\_/)'));
-  console.log(chalk.green.bold('  (•ᴥ•)'));
-  console.log(chalk.green('  />🌿'));
-  console.log('');
-  console.log(chalk.green.bold('  NatureCo CLI — Sistem Kontrolü'));
-  if (shouldFix) console.log(chalk.yellow('  --fix modu aktif\n'));
-  else console.log(chalk.gray('  Sorunları otomatik düzeltmek için: natureco doctor --fix\n'));
-  console.log(chalk.gray('  ' + '─'.repeat(48)));
-  console.log('');
-  
-  const results = [];
-  let passed = 0;
-  let total = 0;
-  let criticalPassed = 0;
-  let criticalTotal = 0;
-  
-  // 1. Node.js versiyon kontrolü
-  total++;
-  criticalTotal++;
-  const nodeVersion = process.version;
-  const nodeMajor = parseInt(nodeVersion.slice(1).split('.')[0]);
-  if (nodeMajor >= 18) {
-    console.log(chalk.green('✅ Node.js versiyonu:'), chalk.white(nodeVersion));
-    passed++;
-    criticalPassed++;
-    results.push({ status: 'ok', message: 'Node.js 18+' });
-  } else {
-    console.log(chalk.red('❌ Node.js versiyonu:'), chalk.white(nodeVersion), chalk.gray('(18+ gerekli)'));
-    results.push({ status: 'error', message: 'Node.js 18+ gerekli', fix: 'Node.js güncelleyin: https://nodejs.org' });
-  }
-  
-  // 2. Config dosyası kontrolü
-  total++;
-  criticalTotal++;
-  let config = null;
-  if (fs.existsSync(CONFIG_FILE)) {
-    try {
-      const data = fs.readFileSync(CONFIG_FILE, 'utf-8');
-      config = JSON.parse(data);
-      console.log(chalk.green('✅ Config dosyası:'), chalk.white(CONFIG_FILE));
-      passed++;
-      criticalPassed++;
-      results.push({ status: 'ok', message: 'Config dosyası geçerli' });
-    } catch (err) {
-      console.log(chalk.red('❌ Config dosyası:'), chalk.white('Bozuk JSON'));
-      results.push({ status: 'error', message: 'Config dosyası bozuk', fix: 'Config yeniden oluşturulacak' });
-      
-      if (shouldFix) {
-        console.log(chalk.yellow('   🔧 Config yeniden oluşturuluyor...'));
-        config = { setupCompleted: false, skills: { enabled: true, list: [] }, mcpServers: {} };
-        saveConfig(config);
-        console.log(chalk.green('   ✓ Config oluşturuldu'));
-      }
-    }
-  } else {
-    console.log(chalk.yellow('⚠️  Config dosyası:'), chalk.white('Bulunamadı'));
-    results.push({ status: 'warning', message: 'Config dosyası yok', fix: 'Config oluşturulacak' });
-    
-    if (shouldFix) {
-      console.log(chalk.yellow('   🔧 Config oluşturuluyor...'));
-      if (!fs.existsSync(CONFIG_DIR)) {
-        fs.mkdirSync(CONFIG_DIR, { recursive: true });
-      }
-      config = { setupCompleted: false, skills: { enabled: true, list: [] }, mcpServers: {} };
-      saveConfig(config);
-      console.log(chalk.green('   ✓ Config oluşturuldu'));
-    }
-  }
-  
-  // 3. Provider URL kontrolü (v2.x)
-  total++;
-  criticalTotal++;
-  let providerValid = false;
-  if (config && config.providerUrl) {
-    console.log(chalk.green('✅ Provider URL:'), chalk.white(config.providerUrl));
-    passed++;
-    criticalPassed++;
-    providerValid = true;
-    results.push({ status: 'ok', message: 'Provider URL ayarlanmış' });
-  } else {
-    console.log(chalk.red('❌ Provider URL:'), chalk.white('Ayarlanmamış'));
-    results.push({ status: 'error', message: 'Provider URL yok', fix: 'Setup çalıştırılacak' });
-  }
-  
-  if (shouldFix && !providerValid) {
-    console.log(chalk.yellow('   🔧 Setup başlatılıyor...'));
-    console.log(chalk.gray('   Lütfen setup\'ı manuel çalıştırın: natureco setup'));
-  }
-  
-  // 4. Provider Model kontrolü (v2.x)
-  total++;
-  if (config && config.providerModel) {
-    console.log(chalk.green('✅ Provider Model:'), chalk.white(config.providerModel));
-    passed++;
-    results.push({ status: 'ok', message: 'Provider model ayarlanmış' });
-  } else {
-    console.log(chalk.yellow('⚠️  Provider Model:'), chalk.white('Ayarlanmamış'));
-    results.push({ status: 'warning', message: 'Provider model yok', fix: 'Setup ile ayarlanabilir' });
-  }
-  
-  // 5. Skills kontrolü
-  total++;
-  try {
-    const skills = getSkills();
-    const skillCount = skills.length;
-    
-    if (skillCount > 0) {
-      console.log(chalk.green('✅ Skills:'), chalk.white(`${skillCount} yüklü`));
-      passed++;
-      results.push({ status: 'ok', message: `${skillCount} skill yüklü` });
-    } else {
-      console.log(chalk.yellow('⚠️  Skills:'), chalk.white('Yüklü skill yok'));
-      results.push({ status: 'warning', message: 'Skill yok', fix: 'Yerleşik skill\'ler yüklenebilir' });
-    }
-  } catch (err) {
-    console.log(chalk.yellow('⚠️  Skills:'), chalk.white('Kontrol edilemedi'));
-    results.push({ status: 'warning', message: 'Skills kontrol edilemedi' });
-  }
-  
-  // 6. MCP sunucuları kontrolü
-  total++;
-  const mcpCount = config && config.mcpServers ? Object.keys(config.mcpServers).length : 0;
-  if (mcpCount > 0) {
-    console.log(chalk.green('✅ MCP sunucuları:'), chalk.white(`${mcpCount} kayıtlı`));
-    passed++;
-    results.push({ status: 'ok', message: `${mcpCount} MCP sunucusu` });
-  } else {
-    console.log(chalk.yellow('⚠️  MCP sunucuları:'), chalk.white('Kayıtlı sunucu yok'));
-    results.push({ status: 'warning', message: 'MCP sunucusu yok' });
-  }
-  
-  // 7. Hafıza kontrolü
-  total++;
-  const memoryDir = path.join(CONFIG_DIR, 'memory');
-  let memoryActive = false;
-  
-  if (fs.existsSync(memoryDir)) {
-    try {
-      const files = fs.readdirSync(memoryDir);
-      const memoryFiles = files.filter(f => f.endsWith('.json'));
-      if (memoryFiles.length > 0) {
-        memoryActive = true;
-        console.log(chalk.green('✅ Hafıza:'), chalk.white(`Aktif (${memoryFiles.length} dosya)`));
-        passed++;
-        results.push({ status: 'ok', message: `Hafıza aktif (${memoryFiles.length} dosya)` });
-      } else {
-        console.log(chalk.yellow('⚠️  Hafıza:'), chalk.white('Klasör var, dosya yok'));
-        results.push({ status: 'warning', message: 'Hafıza dosyası yok' });
-      }
-    } catch (err) {
-      console.log(chalk.yellow('⚠️  Hafıza:'), chalk.white('Kontrol edilemedi'));
-      results.push({ status: 'warning', message: 'Hafıza kontrol edilemedi' });
-    }
-  } else {
-    console.log(chalk.yellow('⚠️  Hafıza:'), chalk.white('Pasif'));
-    results.push({ status: 'warning', message: 'Hafıza pasif' });
-  }
-  
-  // 8. Telegram kontrolü (opsiyonel)
-  if (config && config.telegramToken) {
-    console.log(chalk.green('✅ Telegram:'), chalk.white('Bağlı'));
-    results.push({ status: 'ok', message: 'Telegram bağlı', optional: true });
-  } else {
-    console.log(chalk.gray('⚪ Telegram:'), chalk.white('Bağlı değil'));
-    results.push({ status: 'info', message: 'Telegram bağlı değil', optional: true });
-  }
-  
-  // 9. Discord kontrolü (opsiyonel)
-  if (config && config.discordToken) {
-    console.log(chalk.green('✅ Discord:'), chalk.white('Bağlı'));
-    results.push({ status: 'ok', message: 'Discord bağlı', optional: true });
-  } else {
-    console.log(chalk.gray('⚪ Discord:'), chalk.white('Bağlı değil'));
-    results.push({ status: 'info', message: 'Discord bağlı değil', optional: true });
-  }
-  
-  // 10. Slack kontrolü (opsiyonel)
-  if (config && config.slackToken) {
-    console.log(chalk.green('✅ Slack:'), chalk.white('Bağlı'));
-    results.push({ status: 'ok', message: 'Slack bağlı', optional: true });
-  } else {
-    console.log(chalk.gray('⚪ Slack:'), chalk.white('Bağlı değil'));
-    results.push({ status: 'info', message: 'Slack bağlı değil', optional: true });
-  }
-  
-  // 11. WhatsApp kontrolü (opsiyonel)
-  if (config && config.whatsappConnected) {
-    console.log(chalk.green('✅ WhatsApp:'), chalk.white('Bağlı'));
-    results.push({ status: 'ok', message: 'WhatsApp bağlı', optional: true });
-  } else {
-    console.log(chalk.gray('⚪ WhatsApp:'), chalk.white('Bağlı değil'));
-    results.push({ status: 'info', message: 'WhatsApp bağlı değil', optional: true });
-  }
-  
-  // 12. Dashboard kontrolü (opsiyonel)
-  const dashboardRunning = await checkPort(3848);
-  if (dashboardRunning) {
-    console.log(chalk.green('✅ Dashboard:'), chalk.white('Çalışıyor (port 3848)'));
-    results.push({ status: 'ok', message: 'Dashboard çalışıyor', optional: true });
-  } else {
-    console.log(chalk.gray('⚪ Dashboard:'), chalk.white('Çalışmıyor'));
-    results.push({ status: 'info', message: 'Dashboard çalışmıyor', fix: 'natureco dashboard start', optional: true });
-    
-    if (shouldFix) {
-      console.log(chalk.yellow('   🔧 Dashboard başlatılıyor...'));
-      console.log(chalk.gray('   Lütfen manuel başlatın: natureco dashboard start'));
-    }
-  }
-  
-  // 13. Gateway kontrolü (opsiyonel)
-  const gatewayPidFile = path.join(CONFIG_DIR, 'gateway.pid');
-  let gatewayRunning = false;
-  
-  if (fs.existsSync(gatewayPidFile)) {
-    try {
-      const pid = parseInt(fs.readFileSync(gatewayPidFile, 'utf-8').trim());
-      
-      // Check if process is running
-      try {
-        process.kill(pid, 0); // Signal 0 checks if process exists
-        gatewayRunning = true;
-        console.log(chalk.green('✅ Gateway:'), chalk.white(`Çalışıyor (PID: ${pid})`));
-        results.push({ status: 'ok', message: 'Gateway çalışıyor', optional: true });
-      } catch {
-        console.log(chalk.yellow('⚠️  Gateway:'), chalk.white('PID dosyası var ama process çalışmıyor'));
-        results.push({ status: 'warning', message: 'Gateway PID stale', fix: 'natureco gateway start', optional: true });
-      }
-    } catch {
-      console.log(chalk.gray('⚪ Gateway:'), chalk.white('PID dosyası okunamadı'));
-      results.push({ status: 'info', message: 'Gateway PID okunamadı', optional: true });
-    }
-  } else {
-    console.log(chalk.gray('⚪ Gateway:'), chalk.white('Çalışmıyor'));
-    results.push({ status: 'info', message: 'Gateway çalışmıyor', fix: 'natureco gateway start', optional: true });
-  }
-  
-  // 14. Tavily API key kontrolü (web search için)
-  total++;
-  if (config && config.tavilyApiKey) {
-    console.log(chalk.green('✅ Tavily API:'), chalk.white(config.tavilyApiKey.slice(0, 10) + '...'));
-    passed++;
-    results.push({ status: 'ok', message: 'Tavily API key ayarlanmış' });
-  } else {
-    console.log(chalk.yellow('⚠️  Tavily API:'), chalk.white('Ayarlanmamış (web search çalışmayacak)'));
-    results.push({ status: 'warning', message: 'Tavily API key yok', fix: 'natureco config set tavilyApiKey tvly_xxx' });
-  }
-  
-  // 15. Provider erişim kontrolü (gerçek API doğrulama)
-  total++;
-  criticalTotal++;
-  if (config && config.providerUrl) {
-    try {
-      const response = await fetch(config.providerUrl, {
-        method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-          ...(config.providerApiKey ? { 'Authorization': `Bearer ${config.providerApiKey}` } : {}),
-        },
-        body: JSON.stringify({
-          model: config.providerModel || 'llama-3.3-70b-versatile',
-          messages: [{ role: 'user', content: 'test' }],
-          max_tokens: 1,
-        }),
-        signal: AbortSignal.timeout(15000),
-      });
-
-      if (response.ok) {
-        console.log(chalk.green('✅ Provider:'), chalk.white('API doğrulandı'));
-        passed++;
-        criticalPassed++;
-        results.push({ status: 'ok', message: 'Provider API doğrulandı' });
-      } else if (response.status === 401 || response.status === 403) {
-        console.log(chalk.red('❌ Provider:'), chalk.white('API key geçersiz'));
-        results.push({ status: 'error', message: 'API key reddedildi', fix: 'natureco config set providerApiKey <key>' });
-      } else {
-        console.log(chalk.yellow('⚠️  Provider:'), chalk.white(`HTTP ${response.status} — beklenmeyen yanıt`));
-        results.push({ status: 'warning', message: `Provider HTTP ${response.status} döndü` });
-      }
-    } catch (err) {
-      console.log(chalk.red('❌ Provider:'), chalk.white('Bağlantı hatası: ' + err.message));
-      results.push({ status: 'error', message: 'Provider bağlantı hatası' });
-    }
-  } else {
-    console.log(chalk.gray('⚪ Provider Erişim:'), chalk.white('Provider URL ayarlanmamış'));
-    results.push({ status: 'info', message: 'Provider URL yok' });
-  }
-  
-  // 16. Güncelleme kontrolü
-  total++;
-  try {
-    const packageJson = require('../../package.json');
-    const currentVersion = packageJson.version;
-    
-    const response = await fetch('https://registry.npmjs.org/natureco-cli/latest', {
-      signal: AbortSignal.timeout(5000),
-    });
-    
-    if (response.ok) {
-      const data = await response.json();
-      const latestVersion = data.version;
-      
-      if (currentVersion === latestVersion) {
-        console.log(chalk.green('✅ Versiyon:'), chalk.white(`${currentVersion} (güncel)`));
-        passed++;
-        results.push({ status: 'ok', message: 'Versiyon güncel' });
-      } else {
-        console.log(chalk.yellow('⚠️  Versiyon:'), chalk.white(`${currentVersion} → ${latestVersion} mevcut`));
-        results.push({ status: 'warning', message: 'Yeni versiyon mevcut', fix: 'npm install -g natureco-cli@latest' });
-        
-        if (shouldFix) {
-          console.log(chalk.yellow('   🔧 Güncelleme başlatılıyor...'));
-          console.log(chalk.gray('   Lütfen manuel güncelleyin: npm install -g natureco-cli@latest'));
-        }
-      }
-    } else {
-      console.log(chalk.gray('⚪ Versiyon:'), chalk.white('Kontrol edilemedi'));
-      results.push({ status: 'info', message: 'Versiyon kontrol edilemedi' });
-    }
-  } catch (err) {
-    console.log(chalk.red('Bağlantı hatası: ' + err.message));
-    results.push({ status: 'info', message: 'Versiyon kontrol edilemedi' });
-  }
-  
-  // 17. Exec approvals kontrolü
-  total++;
-  const approvals = loadApprovals();
-  const policy = resolveEffectivePolicy(approvals);
-  const allowlistCount = (approvals.allowlist || []).length;
-  if (policy !== 'deny' || allowlistCount > 0) {
-    passed++;
-    results.push({ status: 'ok', message: `Güvenlik: ${policy} (${allowlistCount} allowlist)` });
-    console.log(chalk.green('✅ Exec Güvenlik:'), chalk.white(`${policy} — ${allowlistCount} allowlist kuralı`));
-  } else {
-    results.push({ status: 'warning', message: 'Exec güvenlik deny modunda', fix: 'natureco security policy set allowlist' });
-    console.log(chalk.yellow('⚠️  Exec Güvenlik:'), chalk.white('deny modunda, komut çalıştırma engelli'));
-  }
-  
-  // 18. Exec approvals allowlist durumu (opsiyonel detay)
-  if (allowlistCount > 0) {
-    const expired = (approvals.allowlist || []).filter(e => e.expires && new Date(e.expires) < new Date()).length;
-    if (expired > 0) {
-      console.log(chalk.yellow(`  ⚠  ${expired} allowlist kuralı süresi dolmuş`));
-    }
-  }
-  
-  // 19. Config yedekleri kontrolü
-  total++;
-  try {
-    const backupDir = path.join(CONFIG_DIR, 'backups');
-    if (fs.existsSync(backupDir)) {
-      const backups = fs.readdirSync(backupDir).filter(f => f.startsWith('config-') && f.endsWith('.json'));
-      if (backups.length > 0) {
-        passed++;
-        results.push({ status: 'ok', message: `${backups.length} config yedeği mevcut` });
-        console.log(chalk.green('✅ Config Yedek:'), chalk.white(`${backups.length} yedek`));
-        
-        if (backups.length >= 10) {
-          console.log(chalk.yellow('  ⚠  Maksimum yedek sayısına ulaşıldı (10)'));
-        }
-      } else {
-        results.push({ status: 'info', message: 'Config yedeği yok' });
-        console.log(chalk.gray('⚪ Config Yedek:'), chalk.white('Yedek bulunamadı'));
-      }
-    } else {
-      results.push({ status: 'info', message: 'Config yedeği yok' });
-      console.log(chalk.gray('⚪ Config Yedek:'), chalk.white('Yedek klasörü yok'));
-    }
-  } catch {
-    results.push({ status: 'info', message: 'Config yedekleri kontrol edilemedi' });
-    console.log(chalk.gray('⚪ Config Yedek:'), chalk.white('Kontrol edilemedi'));
-  }
-  
-  // 20. Secret referansları kontrolü
-  total++;
-  try {
-    const secretRefs = listSecretRefs(config || {});
-    if (secretRefs.length > 0) {
-      const unresolved = secretRefs.filter(ref => {
-        try {
-          return resolveSecretRef(ref) === null;
-        } catch {
-          return true;
-        }
-      });
-      
-      if (unresolved.length === 0) {
-        passed++;
-        results.push({ status: 'ok', message: `${secretRefs.length} secret referansı çözüldü` });
-        console.log(chalk.green('✅ Secrets:'), chalk.white(`${secretRefs.length} referans çözüldü`));
-      } else {
-        results.push({ status: 'warning', message: `${unresolved.length}/${secretRefs.length} secret çözülemedi`, fix: '.env dosyası oluşturun' });
-        console.log(chalk.yellow('⚠️  Secrets:'), chalk.white(`${unresolved.length}/${secretRefs.length} referans çözülemedi`));
-      }
-    } else {
-      results.push({ status: 'info', message: 'Secret referansı yok' });
-      console.log(chalk.gray('⚪ Secrets:'), chalk.white('Referans yok'));
-    }
-  } catch {
-    results.push({ status: 'info', message: 'Secrets kontrol edilemedi' });
-    console.log(chalk.gray('⚪ Secrets:'), chalk.white('Kontrol edilemedi'));
-  }
-  
-  // 21. .env dosyası varlığı (secret ref varsa)
-  if (config) {
-    const envFile = path.join(CONFIG_DIR, '.env');
-    if (fs.existsSync(envFile)) {
-      console.log(chalk.gray('  📄 .env dosyası:'), chalk.white('Mevcut'));
-    } else {
-      console.log(chalk.gray('  📄 .env dosyası:'), chalk.white('Yok'));
-    }
-  }
-  
-  // Özet
-  console.log('');
-  console.log(chalk.gray('  ' + '─'.repeat(48)));
-  
-  const criticalPercentage = criticalTotal > 0 ? Math.round((criticalPassed / criticalTotal) * 100) : 100;
-  let statusColor = chalk.green;
-  let statusText = 'Mükemmel';
-  
-  if (criticalPercentage < 75) {
-    statusColor = chalk.red;
-    statusText = 'Kritik sorun var';
-  } else if (criticalPercentage < 100) {
-    statusColor = chalk.yellow;
-    statusText = 'Dikkat gerekiyor';
-  } else if (passed < total) {
-    statusColor = chalk.cyan;
-    statusText = 'İyi';
-  }
-  
-  console.log('');
-  console.log(chalk.gray('  Durum    : ') + statusColor.bold(statusText));
-  console.log(chalk.gray('  Kontrol  : ') + chalk.white(`${passed}/${total} geçti`));
-  console.log(chalk.gray('  Kritik   : ') + chalk.white(`${criticalPassed}/${criticalTotal}`));
-  
-  const errors = results.filter(r => r.status === 'error');
-  const warnings = results.filter(r => r.status === 'warning');
-  
-  if (errors.length > 0) {
-    console.log(chalk.red(`\n  ❌ ${errors.length} hata bulundu`));
-  }
-  if (warnings.length > 0) {
-    console.log(chalk.yellow(`  ⚠  ${warnings.length} uyarı bulundu`));
-  }
-  if (!shouldFix && (errors.length > 0 || warnings.length > 0)) {
-    console.log(chalk.gray('\n  Otomatik onarım: ') + chalk.cyan('natureco doctor --fix'));
-  }
-  console.log('');
-}
-
-function checkPort(port) {
-  return new Promise((resolve) => {
-    const socket = new net.Socket();
-    
-    socket.setTimeout(1000);
-    
-    socket.on('connect', () => {
-      socket.destroy();
-      resolve(true);
-    });
-    
-    socket.on('timeout', () => {
-      socket.destroy();
-      resolve(false);
-    });
-    
-    socket.on('error', () => {
-      resolve(false);
-    });
-    
-    socket.connect(port, '127.0.0.1');
-  });
-}
-
-module.exports = doctor;
+const chalk = require('chalk');
+const F = require('../utils/format');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const BASE_DIR = path.join(os.homedir(), '.natureco');
+const CONFIG_FILE = path.join(BASE_DIR, 'config.json');
+
+const CHECKS = [
+  { name: 'configExists', label: 'Config file exists' },
+  { name: 'nodeVersion', label: 'Node.js version >= 18' },
+  { name: 'npmPackages', label: 'Required npm packages installed' },
+  { name: 'diskSpace', label: 'Sufficient disk space' },
+  { name: 'writePermission', label: 'Write permission on ~/.natureco' },
+];
+
+function doctor(params) {
+  try {
+    const [action, checkName] = params || [];
+
+    if (!action || action === 'run') return cmdRun();
+    if (action === 'list') return cmdList();
+    if (action === 'check') return cmdCheck(checkName);
+
+    console.log(chalk.red(`\n  Unknown doctor action: ${action}\n`));
+    console.log(chalk.gray('  Usage: natureco doctor [run|list|check <name>]\n'));
+  } catch (err) {
+    console.log(chalk.red(`\n  Doctor error: ${err.message}\n`));
+  }
+}
+
+function cmdList() {
+  F.list(CHECKS.map(c => ({ label: c.name, value: c.label })));
+}
+
+function cmdCheck(name) {
+  if (!name) {
+    console.log(chalk.red('\n  Usage: natureco doctor check <name>\n'));
+    console.log(chalk.gray('  Available checks: ' + CHECKS.map(c => c.name).join(', ') + '\n'));
+    return;
+  }
+
+  const check = CHECKS.find(c => c.name === name);
+  if (!check) {
+    console.log(chalk.red(`\n  Unknown check: ${name}\n`));
+    console.log(chalk.gray('  Available checks: ' + CHECKS.map(c => c.name).join(', ') + '\n'));
+    return;
+  }
+
+  const result = runCheck(name);
+  F.kv('Check', check.label);
+  if (result.pass) {
+    F.success(result.message);
+  } else {
+    F.error(result.message);
+  }
+}
+
+function cmdRun() {
+  F.header('System Doctor');
+
+  const rows = [];
+  let passed = 0;
+  let failed = 0;
+
+  for (const check of CHECKS) {
+    const result = runCheck(check.name);
+    rows.push([
+      check.label,
+      result.pass ? '✓' : '✗',
+      result.message,
+    ]);
+    if (result.pass) passed++; else failed++;
+  }
+
+  F.table(['Check', 'Status', 'Message'], rows);
+
+  const total = passed + failed;
+  F.meta(`${passed}/${total} checks passed`);
+
+  if (failed > 0) {
+    F.warning('Some checks failed. Run individual checks for details.');
+  }
+}
+
+function runCheck(name) {
+  switch (name) {
+    case 'configExists':
+      return {
+        pass: fs.existsSync(CONFIG_FILE),
+        message: fs.existsSync(CONFIG_FILE) ? 'Found at ' + CONFIG_FILE : 'Missing at ' + CONFIG_FILE,
+      };
+
+    case 'nodeVersion': {
+      const v = process.version.slice(1).split('.')[0];
+      const ok = parseInt(v) >= 18;
+      return {
+        pass: ok,
+        message: ok ? 'Running Node ' + process.version : 'Node 18+ required, found ' + process.version,
+      };
+    }
+
+    case 'npmPackages': {
+      const required = ['chalk', 'commander'];
+      const missing = required.filter(p => { try { require.resolve(p); return false; } catch { return true; } });
+      return {
+        pass: missing.length === 0,
+        message: missing.length === 0 ? 'All dependencies installed' : 'Missing: ' + missing.join(', '),
+      };
+    }
+
+    case 'diskSpace': {
+      try {
+        const stats = require('os').freemem();
+        const freeGB = stats / 1024 / 1024 / 1024;
+        return {
+          pass: freeGB > 0.5,
+          message: freeGB > 0.5 ? `${freeGB.toFixed(1)} GB free` : 'Less than 500 MB free',
+        };
+      } catch {
+        return { pass: true, message: 'Unable to check' };
+      }
+    }
+
+    case 'writePermission': {
+      try {
+        if (!fs.existsSync(BASE_DIR)) fs.mkdirSync(BASE_DIR, { recursive: true });
+        const testFile = path.join(BASE_DIR, '.write-test');
+        fs.writeFileSync(testFile, 'test');
+        fs.unlinkSync(testFile);
+        return { pass: true, message: 'Write access OK' };
+      } catch (e) {
+        return { pass: false, message: e.message };
+      }
+    }
+
+    default:
+      return { pass: false, message: 'Unknown check' };
+  }
+}
+
+module.exports = doctor;