imtoagent 0.3.23 → 0.3.25

package/bin/imtoagent-real

@@ -14,6 +14,7 @@
 
 import * as fs from 'fs';
 import * as path from 'path';
+import * as readline from 'readline';
 import { spawn, execSync } from 'child_process';
 import { getDataDir } from '../modules/utils/paths';
 
@@ -54,6 +55,21 @@ switch (command) {
     await cmdUpdateBackend(backendType);
     break;
   }
+  case 'uninstall':
+    await cmdUninstall();
+    break;
+  case 'health':
+    await cmdHealth();
+    break;
+  case 'doctor':
+    await cmdDoctor();
+    break;
+  case 'config':
+    await cmdConfig();
+    break;
+  case 'autostart':
+    await cmdAutostart();
+    break;
   case undefined: {
     const dataDir = getDataDir();
     const configPath = path.join(dataDir, 'config.json');
@@ -108,6 +124,19 @@ Usage:
   imtoagent update-system       Upgrade imtoagent itself
   imtoagent update-backend      Upgrade current Bot's backend
   imtoagent update-backend TYPE Upgrade specific backend (codex|claude|opencode)
+  imtoagent uninstall           Uninstall imtoagent (keep data by default)
+  imtoagent uninstall --purge   Uninstall and delete all data
+  imtoagent health              Run comprehensive health check
+  imtoagent doctor              Diagnose & fix configuration issues
+  imtoagent config              Manage Bot configuration
+  imtoagent config list         List all Bots
+  imtoagent config show NAME    Show Bot details
+  imtoagent config add          Add a new Bot
+  imtoagent config remove NAME  Remove a Bot
+  imtoagent config modify NAME  Modify Bot settings
+  imtoagent autostart enable    Enable auto-start on login (launchd)
+  imtoagent autostart disable   Disable auto-start
+  imtoagent autostart status    Check auto-start status
 
 Data directory: ${getDataDir()}
 `);
@@ -223,6 +252,9 @@ echo $PID`;
     process.exit(1);
   }
 
+  // Non-blocking version check
+  checkForUpdates().then(printUpdateHint).catch(() => {});
+
   // Explicitly exit — Bun may keep event loop alive due to inherited stdio
   process.exit(0);
 }
@@ -616,3 +648,705 @@ async function cmdUpdateBackend(backendType?: 'claude' | 'codex' | 'opencode'):
     process.exit(1);
   }
 }
+
+// ================================================================
+// uninstall — remove imtoagent
+// ================================================================
+async function cmdUninstall(): Promise<void> {
+  const dataDir = getDataDir();
+  const purge = process.argv.includes('--purge');
+  const force = process.argv.includes('--force') || process.argv.includes('-f');
+
+  console.log('\n🗑️  imtoagent Uninstall');
+  console.log(`   Data directory: ${dataDir}`);
+
+  if (!purge && !force) {
+    console.log('\n   ⚠️  This will uninstall the imtoagent npm package but KEEP your data.');
+    console.log(`   Your data in ${dataDir} will be preserved.`);
+    console.log('');
+    console.log('   To also delete all data, use: imtoagent uninstall --purge');
+    console.log('');
+    console.log('   Continue? [y/N]');
+  } else if (purge && !force) {
+    console.log('\n   🔴 This will DELETE all imtoagent data and the npm package.');
+    console.log(`   The following will be permanently removed:`);
+    console.log(`   - Data directory: ${dataDir}`);
+    console.log('   - npm global package: imtoagent');
+    console.log('');
+    console.log('   Continue? [y/N]');
+  } else {
+    console.log('   --force: skipping confirmation\n');
+  }
+
+  // Confirmation
+  if (!force) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise<string>((resolve) => {
+      rl.question('   > ', resolve);
+    }).finally(() => rl.close());
+    if (answer.trim().toLowerCase() !== 'y' && answer.trim().toLowerCase() !== 'yes') {
+      console.log('❌ Uninstall cancelled.');
+      return;
+    }
+  }
+
+  // Step 1: Stop gateway if running
+  if (fs.existsSync(PID_FILE)) {
+    const pid = parseInt(fs.readFileSync(PID_FILE, 'utf-8').trim());
+    try {
+      process.kill(pid, 0);
+      console.log(`⏹  Stopping gateway (PID=${pid})...`);
+      process.kill(pid, 'SIGTERM');
+      for (let i = 0; i < 10; i++) {
+        try { process.kill(pid, 0); await new Promise(r => setTimeout(r, 500)); } catch { break; }
+      }
+      try { process.kill(pid, 0); process.kill(pid, 'SIGKILL'); } catch {}
+      console.log('✅ Gateway stopped');
+    } catch {}
+    try { fs.unlinkSync(PID_FILE); } catch {}
+  } else {
+    console.log('ℹ️  Gateway is not running');
+  }
+
+  // Step 2: Remove launchd plist
+  const plistPath = path.join(process.env.HOME || '', 'Library', 'LaunchAgents', 'com.imtoagent.gateway.plist');
+  if (fs.existsSync(plistPath)) {
+    try {
+      execSync(`launchctl unload "${plistPath}" 2>/dev/null`, { encoding: 'utf-8' });
+      console.log('⏹  Launchd service unloaded');
+    } catch {}
+    try {
+      fs.unlinkSync(plistPath);
+      console.log('🗑️  Launchd plist removed');
+    } catch {}
+  } else {
+    console.log('ℹ️  No launchd service configured');
+  }
+
+  // Step 3: Uninstall npm package
+  console.log('\n📦 Uninstalling npm package...');
+  try {
+    execSync('npm uninstall -g imtoagent', {
+      encoding: 'utf-8',
+      stdio: 'inherit',
+      timeout: 30000,
+    });
+    console.log('✅ npm package uninstalled');
+  } catch (e: any) {
+    console.error(`⚠️  npm uninstall may have failed: ${e.message}`);
+  }
+
+  // Step 4: Purge data if requested
+  if (purge) {
+    console.log(`\n🔥 Deleting data directory: ${dataDir}`);
+    try {
+      execSync(`rm -rf "${dataDir}"`, { encoding: 'utf-8', timeout: 10000 });
+      console.log('✅ Data directory deleted');
+    } catch (e: any) {
+      console.error(`⚠️  Failed to delete data directory: ${e.message}`);
+      console.error(`   Please remove manually: rm -rf "${dataDir}"`);
+    }
+  } else {
+    console.log(`\n💾 Data preserved at: ${dataDir}`);
+    console.log('   To remove it later: rm -rf ~/.imtoagent');
+  }
+
+  console.log('\n✅ imtoagent uninstalled');
+}
+
+// ================================================================
+// health — comprehensive health check
+// ================================================================
+async function cmdHealth(): Promise<void> {
+  const dataDir = getDataDir();
+  const configPath = path.join(dataDir, 'config.json');
+  const logFile = path.join(dataDir, 'logs', 'imtoagent.log');
+
+  console.log(`\n🔍 imtoagent Health Check`);
+  console.log(`   Data directory: ${dataDir}`);
+  console.log(`   Time: ${new Date().toISOString()}\n`);
+
+  let errorCount = 0;
+  let warnCount = 0;
+
+  // ---- 1. Gateway Process ----
+  console.log('── Gateway Process ──');
+  if (fs.existsSync(PID_FILE)) {
+    const pid = parseInt(fs.readFileSync(PID_FILE, 'utf-8').trim());
+    try {
+      process.kill(pid, 0);
+      console.log(`   ✅ Running (PID=${pid})`);
+    } catch {
+      console.log(`   ❌ PID file exists but process ${pid} is gone (stale)`);
+      errorCount++;
+    }
+  } else {
+    console.log(`   ⏸  Not running`);
+  }
+
+  // ---- 2. Configuration ----
+  console.log('\n── Configuration ──');
+  if (fs.existsSync(configPath)) {
+    try {
+      const cfg = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+      console.log(`   ✅ config.json parse OK`);
+
+      // Check required fields
+      if (!cfg.bots || !Array.isArray(cfg.bots) || cfg.bots.length === 0) {
+        console.log(`   ⚠️  No bots configured`);
+        warnCount++;
+      } else {
+        console.log(`   ✅ ${cfg.bots.length} Bot(s) configured`);
+        for (const bot of cfg.bots) {
+          const issues: string[] = [];
+          if (!bot.name) issues.push('missing name');
+          if (!bot.im) issues.push('missing IM platform');
+          if (!bot.backend) issues.push('missing backend');
+          if (issues.length > 0) {
+            console.log(`   ⚠️  Bot "${bot.name || '?'}": ${issues.join(', ')}`);
+            warnCount++;
+          } else {
+            console.log(`   ✅ ${bot.name} (${bot.im} + ${bot.backend})`);
+          }
+        }
+      }
+
+      // Check providers.json
+      const providersPath = path.join(dataDir, 'providers.json');
+      if (fs.existsSync(providersPath)) {
+        try {
+          const prov = JSON.parse(fs.readFileSync(providersPath, 'utf-8'));
+          console.log(`   ✅ providers.json parse OK`);
+          // Check for placeholder API keys
+          const provStr = JSON.stringify(prov);
+          if (provStr.includes('YOUR_') || provStr.includes('sk-xxx') || provStr.includes('placehold')) {
+            console.log(`   ⚠️  providers.json may contain placeholder API keys`);
+            warnCount++;
+          }
+        } catch {
+          console.log(`   ❌ providers.json parse error`);
+          errorCount++;
+        }
+      } else {
+        console.log(`   ⚠️  providers.json not found`);
+        warnCount++;
+      }
+    } catch {
+      console.log(`   ❌ config.json parse error`);
+      errorCount++;
+    }
+  } else {
+    console.log(`   ❌ config.json not found (run "imtoagent setup")`);
+    errorCount++;
+  }
+
+  // ---- 3. Backend Status ----
+  console.log('\n── Backend Status ──');
+  try {
+    const { checkBackend } = await import('../modules/utils/backend-check');
+    if (fs.existsSync(configPath)) {
+      const cfg = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+      const checkedTypes = new Set<string>();
+      for (const bot of cfg.bots || []) {
+        if (bot.backend && ['claude', 'codex', 'opencode'].includes(bot.backend) && !checkedTypes.has(bot.backend)) {
+          checkedTypes.add(bot.backend);
+          const info = checkBackend(bot.backend as any);
+          if (info.installed) {
+            console.log(`   ✅ ${info.label} v${info.version} (${info.installSource})`);
+          } else {
+            console.log(`   ❌ ${info.label} not installed → ${info.installHint}`);
+            errorCount++;
+          }
+        }
+      }
+      if (checkedTypes.size === 0) {
+        console.log(`   ℹ️  No backends to check`);
+      }
+    }
+  } catch {
+    console.log(`   ⚠️  Backend check skipped`);
+    warnCount++;
+  }
+
+  // ---- 4. Proxy Port ----
+  console.log('\n── Proxy Port (:18899) ──');
+  try {
+    const net = await import('net');
+    const checkPort = (port: number): Promise<boolean> => {
+      return new Promise((resolve) => {
+        const socket = new net.Socket();
+        socket.setTimeout(2000);
+        socket.on('connect', () => { socket.destroy(); resolve(true); });
+        socket.on('error', () => resolve(false));
+        socket.on('timeout', () => { socket.destroy(); resolve(false); });
+        socket.connect(port, '127.0.0.1');
+      });
+    };
+    const reachable = await checkPort(18899);
+    if (reachable) {
+      console.log(`   ✅ Port 18899 is reachable`);
+    } else {
+      // Check if port is in use by another process
+      try {
+        const lsofOut = execSync(`lsof -i :18899 2>/dev/null`, { encoding: 'utf-8', timeout: 3000 }).trim();
+        if (lsofOut) {
+          console.log(`   ❌ Port 18899 is occupied by another process:`);
+          lsofOut.split('\n').forEach(line => console.log(`      ${line}`));
+        } else {
+          console.log(`   ⏸  Port 18899 is free (gateway not running)`);
+        }
+      } catch {
+        console.log(`   ⏸  Port 18899 is free (gateway not running)`);
+      }
+    }
+  } catch {
+    console.log(`   ⚠️  Port check failed`);
+    warnCount++;
+  }
+
+  // ---- 5. Recent Log Errors ----
+  console.log('\n── Recent Log Errors ──');
+  if (fs.existsSync(logFile)) {
+    const stats = fs.statSync(logFile);
+    const size = stats.size > 1024 * 1024
+      ? (stats.size / (1024 * 1024)).toFixed(1) + ' MB'
+      : (stats.size / 1024).toFixed(1) + ' KB';
+    console.log(`   Log: ${size}`);
+
+    // Read last 50 lines looking for ERROR/WARN
+    try {
+      const content = fs.readFileSync(logFile, 'utf-8');
+      const lines = content.split('\n');
+      const recent = lines.slice(-50);
+      const errors = recent.filter(l => l.includes('ERROR') || l.includes('[error]'));
+      const warns = recent.filter(l => l.includes('WARN') || l.includes('[warn]'));
+
+      if (errors.length > 0) {
+        console.log(`   ❌ ${errors.length} recent ERROR(s):`);
+        for (const line of errors.slice(-3)) {
+          console.log(`      ${line.trim().slice(0, 120)}`);
+        }
+        errorCount++;
+      } else {
+        console.log(`   ✅ No recent errors`);
+      }
+      if (warns.length > 0 && errors.length === 0) {
+        console.log(`   ℹ️  ${warns.length} recent warning(s) (non-critical)`);
+      }
+    } catch {
+      console.log(`   ⚠️  Could not read log file`);
+      warnCount++;
+    }
+  } else {
+    console.log(`   ℹ️  No log file yet`);
+  }
+
+  // ---- Summary ----
+  console.log('\n── Summary ──');
+  if (errorCount === 0 && warnCount === 0) {
+    console.log(`   ✅ All checks passed!`);
+  } else {
+    if (errorCount > 0) console.log(`   ❌ ${errorCount} error(s)`);
+    if (warnCount > 0) console.log(`   ⚠️  ${warnCount} warning(s)`);
+  }
+  console.log();
+}
+
+// ================================================================
+// config — Bot 配置管理
+// ================================================================
+async function cmdConfig(): Promise<void> {
+  const subcommand = process.argv[3];
+
+  switch (subcommand) {
+    case 'list':
+      await cmdConfigList();
+      break;
+    case 'show': {
+      const name = process.argv[4];
+      if (!name) { console.error('Usage: imtoagent config show <name>'); process.exit(1); }
+      await cmdConfigShow(name);
+      break;
+    }
+    case 'add':
+      await cmdConfigAdd();
+      break;
+    case 'remove': {
+      const name = process.argv[4];
+      if (!name) { console.error('Usage: imtoagent config remove <name>'); process.exit(1); }
+      await cmdConfigRemove(name);
+      break;
+    }
+    case 'modify': {
+      const name = process.argv[4];
+      if (!name) { console.error('Usage: imtoagent config modify <name>'); process.exit(1); }
+      await cmdConfigModify(name);
+      break;
+    }
+    case undefined:
+    case 'help':
+    case '--help':
+    case '-h':
+      console.log(`
+imtoagent config — Manage Bot configuration
+
+Usage:
+  imtoagent config list         List all Bots
+  imtoagent config show NAME    Show Bot details
+  imtoagent config add          Add a new Bot (interactive)
+  imtoagent config remove NAME  Remove a Bot
+  imtoagent config modify NAME  Modify Bot settings
+`);
+      break;
+    default:
+      console.error(`❌ Unknown config subcommand: ${subcommand}`);
+      console.log('   Run "imtoagent config help" for usage.');
+      process.exit(1);
+  }
+}
+
+// ---- Config subcommand wrappers ----
+async function cmdConfigList(): Promise<void> {
+  const m = await import('../modules/utils/config-manager');
+  await m.cmdConfigList();
+}
+async function cmdConfigShow(name: string): Promise<void> {
+  const m = await import('../modules/utils/config-manager');
+  await m.cmdConfigShow(name);
+}
+async function cmdConfigAdd(): Promise<void> {
+  const m = await import('../modules/utils/config-manager');
+  await m.cmdConfigAdd();
+}
+async function cmdConfigRemove(name: string): Promise<void> {
+  const m = await import('../modules/utils/config-manager');
+  await m.cmdConfigRemove(name);
+}
+async function cmdConfigModify(name: string): Promise<void> {
+  const m = await import('../modules/utils/config-manager');
+  await m.cmdConfigModify(name);
+}
+
+
+// ================================================================
+// doctor — 配置诊断与自动修复
+// ================================================================
+async function cmdDoctor(): Promise<void> {
+  console.log(`\n🔧 imtoagent Doctor — Configuration Diagnosis\n`);
+
+  try {
+    const { runDoctorChecks, formatIssues } = await import('../modules/utils/doctor');
+    const issues = await runDoctorChecks();
+
+    // 分组
+    const fixableIssues = issues.filter(i => i.fixable);
+    const unfixableIssues = issues.filter(i => !i.fixable);
+    const errors = issues.filter(i => i.severity === 'error');
+    const warnings = issues.filter(i => i.severity === 'warning');
+    const infos = issues.filter(i => i.severity === 'info');
+
+    // 打印所有问题
+    if (issues.length === 0) {
+      console.log('   ✅ All checks passed! Nothing to fix.\n');
+      return;
+    }
+
+    // 打印 errors
+    if (errors.length > 0) {
+      console.log('❌ Errors:');
+      for (const e of errors) {
+        console.log(`   ${e.message}`);
+        if (e.fixable && e.fixDescription) {
+          console.log(`   → 🔧 ${e.fixDescription}`);
+        }
+      }
+      console.log();
+    }
+
+    // 打印 warnings
+    if (warnings.length > 0) {
+      console.log('⚠️  Warnings:');
+      for (const w of warnings) {
+        console.log(`   ${w.message}`);
+      }
+      console.log();
+    }
+
+    // 打印 infos
+    if (infos.length > 0) {
+      console.log('✅ OK:');
+      for (const i of infos) {
+        console.log(`   ${i.message}`);
+      }
+      console.log();
+    }
+
+    // 尝试自动修复
+    if (fixableIssues.length > 0) {
+      console.log(`─── Auto-Fix ───`);
+      let fixed = 0;
+      for (const issue of fixableIssues) {
+        if (!issue.fix) continue;
+        try {
+          console.log(`\n🔧 Fixing: ${issue.fixDescription}`);
+          const success = await issue.fix();
+          if (success) {
+            console.log(`   ✅ Fixed`);
+            fixed++;
+          } else {
+            console.log(`   ❌ Fix failed`);
+          }
+        } catch (e: any) {
+          console.log(`   ❌ Fix failed: ${e.message}`);
+        }
+      }
+      console.log(`\n   ${fixed}/${fixableIssues.length} issues fixed`);
+      if (fixed > 0) {
+        console.log(`\n💡 Run "imtoagent doctor" again to re-check after fixes.\n`);
+      }
+    }
+
+    // Summary
+    console.log('── Summary ──');
+    if (errors.length === 0) {
+      console.log('   ✅ No errors found');
+    } else {
+      console.log(`   ❌ ${errors.length} error(s) — some may be fixable`);
+    }
+    if (warnings.length > 0) {
+      console.log(`   ⚠️  ${warnings.length} warning(s) — review recommended`);
+    }
+    console.log();
+
+  } catch (e: any) {
+    console.error(`❌ Doctor check failed: ${e.message}\n`);
+    process.exit(1);
+  }
+}
+// ================================================================
+// autostart — launchd integration (macOS only)
+// ================================================================
+async function cmdAutostart(): Promise<void> {
+  const subcommand = process.argv[3];
+  const home = process.env.HOME || '';
+  const plistDir = path.join(home, 'Library', 'LaunchAgents');
+  const plistPath = path.join(plistDir, 'com.imtoagent.gateway.plist');
+
+  if (process.platform !== 'darwin') {
+    console.error('❌ autostart is only supported on macOS (launchd)');
+    process.exit(1);
+  }
+
+  switch (subcommand) {
+    case 'enable':
+      await cmdAutostartEnable(plistPath, plistDir, home);
+      break;
+    case 'disable':
+      await cmdAutostartDisable(plistPath);
+      break;
+    case 'status':
+      await cmdAutostartStatus(plistPath);
+      break;
+    default:
+      console.log('Usage:');
+      console.log('  imtoagent autostart enable    Enable auto-start on login');
+      console.log('  imtoagent autostart disable   Disable auto-start');
+      console.log('  imtoagent autostart status    Check auto-start status');
+  }
+}
+
+async function cmdAutostartEnable(plistPath: string, plistDir: string, home: string): Promise<void> {
+  const dataDir = getDataDir();
+  const binPath = execSync('command -v imtoagent', { encoding: 'utf-8', timeout: 3000 }).trim();
+
+  if (!binPath) {
+    console.error('❌ Cannot find imtoagent binary');
+    process.exit(1);
+  }
+
+  // Find node and bun paths for launchd (which has minimal PATH)
+  const nodePath = execSync('which node', { encoding: 'utf-8', timeout: 3000 }).trim();
+  const bunPath = execSync('which bun', { encoding: 'utf-8', timeout: 3000 }).trim();
+  const launchdPATH = `${path.dirname(nodePath)}:${path.dirname(bunPath)}:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/homebrew/bin:/opt/homebrew/opt/node@24/bin`;
+
+  const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.imtoagent.gateway</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>${binPath}</string>
+        <string>daemon</string>
+    </array>
+    <key>WorkingDirectory</key>
+    <string>${dataDir}</string>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>IMTOAGENT_HOME</key>
+        <string>${dataDir}</string>
+        <key>PATH</key>
+        <string>${launchdPATH}</string>
+    </dict>
+    <key>StandardOutPath</key>
+    <string>${path.join(dataDir, 'logs', 'launchd.log')}</string>
+    <key>StandardErrorPath</key>
+    <string>${path.join(dataDir, 'logs', 'launchd-error.log')}</string>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <dict>
+        <key>SuccessfulExit</key>
+        <false/>
+    </dict>
+    <key>ThrottleInterval</key>
+    <integer>30</integer>
+    <key>ProcessType</key>
+    <string>Background</string>
+</dict>
+</plist>
+`;
+
+  fs.mkdirSync(plistDir, { recursive: true });
+  fs.writeFileSync(plistPath, plist);
+  console.log(`✅ Plist written: ${plistPath}`);
+
+  // Unload existing (if any) then reload
+  try { execSync(`launchctl unload "${plistPath}" 2>/dev/null`, { encoding: 'utf-8' }); } catch {}
+
+  try {
+    execSync(`launchctl load "${plistPath}"`, { encoding: 'utf-8', timeout: 5000 });
+    console.log('✅ launchd service loaded');
+  } catch (e: any) {
+    console.error(`⚠️  launchctl load failed: ${e.message}`);
+    console.error('   Plist written. Manual: launchctl load ' + plistPath);
+  }
+
+  console.log(`\n📌 Auto-start enabled. Gateway starts on login.`);
+  console.log(`   Logs: ${path.join(dataDir, 'logs', 'launchd.log')}`);
+}
+
+async function cmdAutostartDisable(plistPath: string): Promise<void> {
+  if (!fs.existsSync(plistPath)) {
+    console.log('ℹ️  No autostart configured');
+    return;
+  }
+
+  try {
+    execSync(`launchctl unload "${plistPath}" 2>/dev/null`, { encoding: 'utf-8', timeout: 5000 });
+    console.log('✅ launchd service unloaded');
+  } catch {
+    console.log('ℹ️  Service was not loaded');
+  }
+
+  try {
+    fs.unlinkSync(plistPath);
+    console.log('✅ Plist removed');
+  } catch (e: any) {
+    console.error(`⚠️  Failed to remove plist: ${e.message}`);
+  }
+
+  console.log('\n📌 Auto-start disabled');
+}
+
+async function cmdAutostartStatus(plistPath: string): Promise<void> {
+  const exists = fs.existsSync(plistPath);
+  console.log(`\n📌 Autostart Status`);
+  console.log(`   Plist file: ${plistPath}`);
+  console.log(`   Installed: ${exists ? '✅ Yes' : '❌ No'}`);
+
+  if (exists) {
+    try {
+      const out = execSync(`launchctl list | grep com.imtoagent`, { encoding: 'utf-8', timeout: 3000 }).trim();
+      console.log(`   Running: ${out ? '✅ Yes' : '❌ No (plist exists but not loaded)'}`);
+      if (out) console.log(`   ${out}`);
+    } catch {
+      console.log(`   Running: ❌ No`);
+    }
+  }
+  console.log();
+}
+
+// ================================================================
+// version-check — non-blocking npm registry check
+// ================================================================
+
+/**
+ * Check if a newer version is available on npm.
+ * Returns null if check fails or no update available.
+ * Caches result for 24 hours.
+ */
+async function checkForUpdates(): Promise<string | null> {
+  const dataDir = getDataDir();
+  const cacheFile = path.join(dataDir, '.last-version-check');
+  const pkg = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf-8'));
+  const currentVer = pkg.version;
+
+  // Check cache (24h TTL)
+  try {
+    if (fs.existsSync(cacheFile)) {
+      const cached = JSON.parse(fs.readFileSync(cacheFile, 'utf-8'));
+      const ageMs = Date.now() - cached.timestamp;
+      if (ageMs < 24 * 60 * 60 * 1000) {
+        // Cache hit — return stored result
+        if (cached.latest && cached.latest !== currentVer) {
+          return cached.latest;
+        }
+        return null;
+      }
+    }
+  } catch {}
+
+  // Fetch from npm registry (3s timeout, npmmirror for China)
+  try {
+    const http = await import('http');
+    const https = await import('https');
+
+    const fetchJson = (url: string): Promise<any> => {
+      return new Promise((resolve, reject) => {
+        const client = url.startsWith('https') ? https : http;
+        const req = client.get(url, { timeout: 3000 }, (res) => {
+          let data = '';
+          res.on('data', chunk => data += chunk);
+          res.on('end', () => {
+            try { resolve(JSON.parse(data)); } catch { reject(new Error('parse error')); }
+          });
+        });
+        req.on('error', reject);
+        req.on('timeout', () => { req.destroy(); reject(new Error('timeout')); });
+      });
+    };
+
+    // Try npmmirror first (China-friendly), fallback to npmjs
+    let result: any;
+    try {
+      result = await fetchJson('https://registry.npmmirror.com/imtoagent');
+    } catch {
+      result = await fetchJson('https://registry.npmjs.org/imtoagent');
+    }
+
+    const latest = result['dist-tags']?.latest;
+    if (latest && latest !== currentVer) {
+      // Cache the result
+      fs.writeFileSync(cacheFile, JSON.stringify({ latest, timestamp: Date.now() }));
+      return latest;
+    }
+
+    // Cache "no update" result too
+    fs.writeFileSync(cacheFile, JSON.stringify({ latest: currentVer, timestamp: Date.now() }));
+    return null;
+  } catch {
+    // Silently fail — non-blocking
+    return null;
+  }
+}
+
+/** Print version update hint if available */
+function printUpdateHint(latestVer: string | null): void {
+  if (latestVer) {
+    const pkg = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf-8'));
+    console.log(`\n⬆️  New version available: ${pkg.version} → ${latestVer}`);
+    console.log(`   Upgrade: imtoagent update-system`);
+  }
+}