0.5.32 - 🔄 Restart outdated daemon automatically on version mismatch

Author: vava-nessa

bin/free-coding-models.js

@@ -10,7 +10,7 @@
 // 📖 npm install running on the same machine.
 // 📖 IMPORTANT: these checks MUST run synchronously before any static imports
 // 📖 resolve, because router-daemon.js reads FCM_DEV at module load time.
-import { existsSync } from 'node:fs'
+import { existsSync, readFileSync } from 'node:fs'
 import { join, dirname } from 'node:path'
 import { fileURLToPath } from 'node:url'
 if (process.argv.includes('--dev') || (!process.env.FCM_DEV && existsSync(join(dirname(fileURLToPath(import.meta.url)), '..', '.git')))) {
@@ -78,7 +78,14 @@ async function main() {
     })
     : { latestVersion: null, allowedOutdated: false, warningMessage: null, failures: 0, checked: false, updated: false, blocked: false };
 
-  if (startupUpdate.updated) return;
+  if (startupUpdate.updated) {
+    try {
+      // 📖 Stop any running daemon so that the relaunch/restart will start the new version.
+      const { stopRouterDaemon } = await import('../src/core/router-daemon.js');
+      await stopRouterDaemon();
+    } catch {}
+    return;
+  }
   if (startupUpdate.blocked) process.exit(1);
   if (startupUpdate.allowedOutdated) {
     process.env.FCM_UPDATE_ALLOWED_OUTDATED = '1';
@@ -87,6 +94,19 @@ async function main() {
     process.env.FCM_UPDATE_FAILURES = String(startupUpdate.failures || 0);
   }
 
+  // 📖 If the daemon is running an outdated version, stop it so it will restart on the new version.
+  if (!cliArgs.daemonStopMode && !cliArgs.daemonStatusMode) {
+    try {
+      const { getRouterDaemonStatus, stopRouterDaemon } = await import('../src/core/router-daemon.js');
+      const status = await getRouterDaemonStatus();
+      const LOCAL_VERSION = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;
+      if (status.ok && status.version && status.version !== LOCAL_VERSION) {
+        console.log(chalk.yellow(`  ⚠ Outdated daemon version v${status.version} detected (current: v${LOCAL_VERSION}). Stopping old daemon...`));
+        await stopRouterDaemon();
+      }
+    } catch {}
+  }
+
   // 📖 Standalone web dashboard: same full-catalog ping UI as the TUI, served
   // 📖 locally with Socket.IO/SSE/REST realtime updates.
   if (cliArgs.webMode) {

changelog/v0.5.32.md

@@ -0,0 +1,4 @@
+# Changelog v0.5.32 - 2026-06-15
+
+### Added
+- **Automatic daemon restart on version mismatch.** Added version detection to the daemon `/health` status payload. The CLI now automatically checks the running daemon version on startup (or when starting the daemon in the background) and terminates the outdated daemon if a version mismatch with the current CLI is detected, forcing a restart on the new version.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-coding-models",
-  "version": "0.5.31",
+  "version": "0.5.32",
   "description": "Find the fastest coding LLM models in seconds — ping free models from multiple providers, pick the best one for OpenCode, Cursor, or any AI coding assistant.",
   "keywords": [
     "nvidia",

src/core/router-daemon.js

@@ -1379,6 +1379,7 @@ class RouterRuntime {
       // 📖 the Playground showed "router offline" even when the Router card
       // 📖 said "Running" — both hit /api/router/status but read different fields.
       running: true,
+      version: LOCAL_VERSION,
       pid: process.pid,
       port: this.port,
       enabled: router.enabled,
@@ -3526,7 +3527,13 @@ export async function getRouterDaemonStatus() {
 
 export async function startRouterDaemonBackground() {
   const existing = await getRouterDaemonStatus()
-  if (existing.ok) return { ...existing, alreadyRunning: true }
+  if (existing.ok) {
+    if (existing.version && existing.version !== LOCAL_VERSION) {
+      await stopRouterDaemon()
+    } else {
+      return { ...existing, alreadyRunning: true }
+    }
+  }
 
   const child = fork(CLI_ENTRY_PATH, ['--daemon'], {
     detached: true,