feat: add auto update checker with cmr update command

- Server startup: non-blocking check against npm registry once per day
- CLI: cmr update checks for updates and offers one-command install
- Rate-limited: stores last check timestamp, max once per 24h

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: GoldVelen

bin/cmr.js

@@ -769,6 +769,55 @@ async function cmdDashboard() {
   process.exit(0);
 }
 
+// ─── Update ──────────────────────────────────────────────────────────
+
+async function cmdUpdate() {
+  console.log('Checking for updates...');
+
+  const pkgPath = join(PROJECT_DIR, 'package.json');
+  let currentVersion = '0.0.0';
+  try {
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    currentVersion = pkg.version || '0.0.0';
+  } catch { /* ignore */ }
+
+  const { checkForUpdate } = await import(
+    pathToFileURL(join(PROJECT_DIR, 'dist', 'utils', 'update-checker.js')).href
+  );
+  const result = await checkForUpdate(currentVersion);
+
+  if (!result.updateAvailable) {
+    console.log(`Already up to date (v${result.current})`);
+    return;
+  }
+
+  console.log(`\x1b[33mUpdate available: v${result.current} → v${result.latest}\x1b[0m`);
+
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  const ask = (q) => new Promise((resolve) => rl.question(q, resolve));
+  const install = await ask('Install now? [Y/n]: ');
+  rl.close();
+
+  if (install.toLowerCase() === 'n') {
+    console.log('Skipped. Run `npm install -g claude-model-router` to update later.');
+    return;
+  }
+
+  console.log('Installing...');
+  const child = spawn('npm', ['install', '-g', 'claude-model-router'], {
+    stdio: 'inherit',
+    shell: true,
+  });
+
+  child.on('exit', (code) => {
+    if (code === 0) {
+      console.log(`\nUpdated to v${result.latest}. Run 'cmr restart' to restart the proxy.`);
+    } else {
+      console.log(`\nInstall failed (exit code ${code}). Try manually: npm install -g claude-model-router`);
+    }
+  });
+}
+
 // ─── Help ───────────────────────────────────────────────────────────
 
 function cmdHelp() {
@@ -790,6 +839,7 @@ Commands:
   dashboard Real-time monitoring dashboard (press 'q' to quit)
   logs      Show last 50 log lines
   config    Show current config (api keys redacted)
+  update    Check for updates and install
   run       Run task through model pipeline
             cmr run <task>                  # Single-line task
             cmr run                         # Interactive multi-line input
@@ -826,6 +876,7 @@ async function main() {
     case 'dashboard': await cmdDashboard(); break;
     case 'logs':    cmdLogs(); break;
     case 'config':  cmdConfigShow(); break;
+    case 'update':  await cmdUpdate(); break;
     case 'setup':   await cmdSetup(); break;
     case 'run': {
       const mode = process.argv[3];

package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-model-router",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Zero-dependency Anthropic-format API proxy for Claude Code. Multi-backend routing, hot reload, config validation, and detailed logging.",
   "keywords": [
     "claude-code",

src/index.ts

@@ -2,11 +2,26 @@ import { getConfig, reloadConfig, getConfigPath } from './config.js';
 import { createServer } from './server.js';
 import { startConfigWatcher } from './watcher.js';
 import { ensureBackends } from './stats/stats-store.js';
+import { checkForUpdate } from './utils/update-checker.js';
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
 
 const config = getConfig();
 ensureBackends(Object.keys(config.backends));
 const server = createServer();
 
+// Background update check — non-blocking
+const pkg = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json'), 'utf-8')) as { version: string };
+checkForUpdate(pkg.version).then((result) => {
+  if (result.updateAvailable) {
+    console.log('');
+    console.log(`\x1b[33m  Update available: ${result.current} → ${result.latest}\x1b[0m`);
+    console.log(`\x1b[33m  Run: npm install -g claude-model-router\x1b[0m`);
+    console.log('');
+  }
+});
+
 server.listen(config.port, () => {
   const deepseekBackend = Object.values(config.backends).find((b) => b.modelPattern?.includes('deepseek'));
   const deepseekHost = deepseekBackend ? new URL(deepseekBackend.url).hostname : 'unknown';

src/utils/update-checker.ts

@@ -0,0 +1,86 @@
+import https from 'node:https';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+
+const DATA_DIR = join(homedir(), '.local', 'share', 'claude-model-router');
+const CHECKED_PATH = join(DATA_DIR, '.last_update_check');
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
+const REGISTRY_URL = 'https://registry.npmjs.org/claude-model-router/latest';
+
+interface CheckResult {
+  updateAvailable: boolean;
+  current: string;
+  latest: string;
+}
+
+function ensureDir(dir: string): void {
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+}
+
+function shouldCheck(): boolean {
+  if (!existsSync(CHECKED_PATH)) return true;
+  try {
+    const ts = parseInt(readFileSync(CHECKED_PATH, 'utf-8').trim(), 10);
+    return Date.now() - ts > CHECK_INTERVAL_MS;
+  } catch {
+    return true;
+  }
+}
+
+function markChecked(): void {
+  ensureDir(DATA_DIR);
+  writeFileSync(CHECKED_PATH, String(Date.now()), 'utf-8');
+}
+
+function compareVersions(a: string, b: string): number {
+  const pa = a.split('.').map(Number);
+  const pb = b.split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    const da = pa[i] ?? 0;
+    const db = pb[i] ?? 0;
+    if (da > db) return 1;
+    if (da < db) return -1;
+  }
+  return 0;
+}
+
+function fetchLatestVersion(): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const req = https.get(REGISTRY_URL, { timeout: 5000 }, (res) => {
+      let body = '';
+      res.on('data', (chunk) => (body += chunk));
+      res.on('end', () => {
+        try {
+          const parsed = JSON.parse(body) as { version?: string };
+          resolve(parsed.version ?? '');
+        } catch {
+          reject(new Error('Failed to parse registry response'));
+        }
+      });
+    });
+    req.on('error', reject);
+    req.on('timeout', () => { req.destroy(); reject(new Error('Timeout')); });
+  });
+}
+
+export async function checkForUpdate(currentVersion: string): Promise<CheckResult> {
+  if (!shouldCheck()) {
+    return { updateAvailable: false, current: currentVersion, latest: currentVersion };
+  }
+
+  const result = await fetchLatestVersion()
+    .then((latest) => {
+      markChecked();
+      return {
+        updateAvailable: compareVersions(latest, currentVersion) > 0,
+        current: currentVersion,
+        latest,
+      };
+    })
+    .catch(() => {
+      return { updateAvailable: false, current: currentVersion, latest: currentVersion };
+    });
+
+  return result;
+}