free-coding-models 0.5.27 → 0.5.29

package/src/core/utils.js

@@ -41,6 +41,7 @@
  * @exports sortResults, filterByTier, findBestModel, parseArgs
  * @exports scoreModelForTask, getTopRecommendations
  * @exports TIER_ORDER, VERDICT_ORDER, TIER_LETTER_MAP, TASK_TYPES, PRIORITY_TYPES, CONTEXT_BUDGETS
+ * @exports parseCtxToK, parseSweToNum, formatCtxWindow, labelFromId, NEW_MODELS, getVersionStatusInfo, formatResultsAsJSON
  *
  * @see bin/free-coding-models.js — main CLI that imports these utils
  * @see sources.js — model definitions consumed by these functions
@@ -115,80 +116,27 @@ export const getAvg = (r) => {
 //
 // 📖 The "wasUpBefore" check is key — it distinguishes between a model that's
 //    temporarily flaky vs one that was never reachable in the first place.
+// 📖 NEW_MODEL_DURATION_MS — how long a model shows the 🆕 badge after being added.
+// 📖 5 days in milliseconds.
+export const NEW_MODEL_DURATION_MS = 5 * 24 * 60 * 60 * 1000
+
+/**
+ * 📖 Check if a model should display the 🆕 badge.
+ * 📖 A model is "new" if its addedDate is within the last 5 days.
+ * 📖 `addedDate` comes from sources.js as the optional 6th element of model tuples.
+ * @param {string|null|undefined} addedDate — ISO date string (e.g. '2026-06-10')
+ * @returns {boolean}
+ */
+export function isNewModel(addedDate) {
+  if (!addedDate || typeof addedDate !== 'string') return false
+  const added = Date.parse(addedDate)
+  if (!Number.isFinite(added)) return false
+  return (Date.now() - added) < NEW_MODEL_DURATION_MS
+}
+
+// 📖 NEW_MODELS kept for backward compat with web/website surfaces that
+// 📖 don't have addedDate. Will be removed once all surfaces migrate.
 export const NEW_MODELS = new Set([
-  'nvidia/nemotron-3-ultra-550b-a55b',
-  '@cf/meta/llama-3.2-90b-instruct',
-  '@cf/mistralai/mistral-7b-instruct-v0.2',
-  '@cf/google/gemma-2-9b-it',
-  '@cf/anthropic/claude-3-5-sonnet',
-  '@cf/openai/gpt-4o-mini',
-  '@cf/qwen/qwen3-30b-a3b-fp8',
-  '@cf/qwen/qwen2.5-coder-32b-instruct',
-  '@cf/meta/llama-3.3-70b-instruct-fp8-fast',
-  '@cf/google/gemma-4-26b-a4b-it',
-  '@cf/mistralai/mistral-small-3.1-24b-instruct',
-  '@cf/ibm/granite-4.0-h-micro',
-  'minimaxai/minimax-m2.7',
-  'z-ai/glm-5.1',
-  'moonshotai/kimi-k2.6',
-  'stepfun-ai/step-3.5-flash',
-  'stepfun-ai/step-3.7-flash',
-  'qwen/qwen3-coder-480b-a35b-instruct',
-  'qwen/qwen3.5-397b-a17b',
-  'meta/llama-4-maverick-17b-128e-instruct',
-  'mistralai/mistral-medium-3.5-128b',
-  'mistralai/mistral-small-4-119b-2603',
-  'qwen/qwen3.5-122b-a10b',
-  'mistralai/mistral-large-3-675b-instruct-2512',
-  'nvidia/nemotron-3-super-120b-a12b',
-  'nvidia/nemotron-3-nano-omni-30b-a3b-reasoning',
-  'google/gemma-4-31b-it',
-  'bytedance/seed-oss-36b-instruct',
-  'stockmark/stockmark-2-100b-instruct',
-  'mistralai/ministral-14b-instruct-2512',
-  'meta/llama-3.2-11b-vision-instruct',
-  'microsoft/phi-4-mini-instruct',
-  'gemma-3-12b-it',
-  'nvidia/nemotron-nano-9b-v2',
-  'openrouter/owl-alpha',
-  'nousresearch/hermes-3-llama-3.1-405b:free',
-  'nvidia/nemotron-nano-30b-a3b:free',
-  'cognitivecomputations/dolphin-mistral-24b-venice-edition:free',
-  'meta-llama/llama-3.3-70b-instruct:free',
-  'meta-llama/llama-3.2-3b-instruct:free',
-  'liquid/lfm-2.5-1.2b-instruct:free',
-  'liquid/lfm-2.5-1.2b-thinking:free',
-  'qwen3.7-max',
-  'qwen3-max',
-  'qwen3.6-plus',
-  'qwen3-235b-a22b',
-  'qwen3.5-plus',
-  'qwen3-coder-plus',
-  'qwen3-coder-next',
-  'qwen3.6-flash',
-  'qwen3.5-flash',
-  'qwen3-coder-flash',
-  'qwen3-32b',
-  'qwen3-coder-30b-a3b-instruct',
-  'holo2-30b-a3b',
-  'llama-3.3-70b-instruct',
-  'mistral-small-3.2-24b-instruct-2506',
-  'gemma-3-27b-it',
-  'qwen3.5-397b-a17b',
-  'qwen3-coder-30b-a3b-instruct',
-  'gpt-oss-120b',
-  'gpt-oss-20b',
-  'Meta-Llama-3_3-70B-Instruct',
-  'Qwen3-32B',
-  'Mistral-Small-3.2-24B-Instruct-2506',
-  'Mistral-7B-Instruct-v0.3',
-  'Mistral-Nemo-Instruct-2407',
-  'Qwen3.5-9B',
-  'big-pickle',
-  'deepseek-v4-flash-free',
-  'mimo-v2.5-free',
-  'nemotron-3-super-free',
-  'minimax-m3-free'
 ]);
 
 export const getVerdict = (r) => {
@@ -376,34 +324,12 @@ export const sortResults = (results, sortColumn, sortDirection, { benchmarkResul
         break
       case 'swe': {
         // 📖 Sort by SWE-bench score — higher is better
-        // 📖 Parse percentage strings like "49.2%", "73.1%" or use 0 for missing values
-        const parseSwe = (score) => {
-          if (!score || score === '—') return 0
-          const num = parseFloat(score.replace('%', ''))
-          return isNaN(num) ? 0 : num
-        }
-        cmp = parseSwe(a.sweScore) - parseSwe(b.sweScore)
+        cmp = parseSweToNum(a.sweScore) - parseSweToNum(b.sweScore)
         break
       }
       case 'ctx': {
-        // 📖 Sort by context window size — larger is better
-        // 📖 Parse strings like "128k", "32k", "1m" into numeric tokens
-        const parseCtx = (ctx) => {
-          if (!ctx || ctx === '—') return 0
-          const str = ctx.toLowerCase()
-          // 📖 Handle millions (1m = 1000k)
-          if (str.includes('m')) {
-            const num = parseFloat(str.replace('m', ''))
-            return num * 1000
-          }
-          // 📖 Handle thousands (128k)
-          if (str.includes('k')) {
-            const num = parseFloat(str.replace('k', ''))
-            return num
-          }
-          return 0
-        }
-        cmp = parseCtx(a.ctx) - parseCtx(b.ctx)
+        // 📖 Sort by context window size — larger is better (uses parseCtxToK)
+        cmp = parseCtxToK(a.ctx) - parseCtxToK(b.ctx)
         break
       }
       case 'condition':
@@ -727,7 +653,7 @@ export const CONTEXT_BUDGETS = {
 
 // 📖 parseCtxToK: Convert context window string ("128k", "1m", "200k") into numeric K tokens.
 // 📖 Used by the scoring engine to compare against CONTEXT_BUDGETS thresholds.
-function parseCtxToK(ctx) {
+export function parseCtxToK(ctx) {
   if (!ctx || ctx === '—') return 0
   const str = ctx.toLowerCase()
   if (str.includes('m')) return parseFloat(str.replace('m', '')) * 1000
@@ -756,7 +682,7 @@ export function labelFromId(id) {
 
 // 📖 parseSweToNum: Convert SWE-bench score string ("49.2%", "73.1%") into a 0–100 number.
 // 📖 Returns 0 for missing or invalid scores.
-function parseSweToNum(sweScore) {
+export function parseSweToNum(sweScore) {
   if (!sweScore || sweScore === '—') return 0
   const num = parseFloat(sweScore.replace('%', ''))
   return isNaN(num) ? 0 : num

package/src/tui/app.js

@@ -307,14 +307,26 @@ export async function runApp(cliArgs, config, startupOptions = {}) {
 
   let results = MODELS
     .filter(([,,,,,providerKey]) => isProviderEnabled(config, providerKey))
-    .map(([modelId, label, tier, sweScore, ctx, providerKey], i) => ({
-      idx: i + 1, modelId, label, tier, sweScore, ctx, providerKey,
+    .map(([modelId, label, tier, sweScore, ctx, providerKey, addedDate], i) => ({
+      idx: i + 1, modelId, label, tier, sweScore, ctx, providerKey, addedDate: addedDate || null,
       status: 'pending',
       pings: [],  // 📖 All ping results (ms or 'TIMEOUT')
       httpCode: null,
       isPinging: false, // 📖 Per-row live flag so Last Ping can keep last value and show a spinner during refresh.
       hidden: false,  // 📖 Simple flag to hide/show models
     }))
+
+  // 📖 Auto-hide models that were previously marked broken by the 404 probe.
+  // 📖 Only applies when autoHideBrokenModels setting is enabled (default).
+  if (config.settings?.autoHideBrokenModels !== false && config.hiddenModels instanceof Set) {
+    for (const r of results) {
+      const modelKey = `${r.providerKey}/${r.modelId}`
+      if (config.hiddenModels.has(modelKey)) {
+        r.hidden = true
+      }
+    }
+  }
+
   syncFavoriteFlags(results, config)
   // 📖 Garbage-collect favorites that reference models no longer in sources.js,
   // 📖 so the router dashboard only shows real, launchable models.
@@ -826,6 +838,10 @@ export async function runApp(cliArgs, config, startupOptions = {}) {
       benchmarkResults: state.benchmarkResults,
       benchmarkRunning: state.benchmarkRunning,
       headerFlashColumn: state.headerFlashColumn,
+      probeRunning: state.probeRunning,
+      probeTotal: state.probeTotal,
+      probeCompleted: state.probeCompleted,
+      probeHiddenCount: state.probeHiddenCount,
     }
     if (state.commandPaletteOpen) {
       if (!state.commandPaletteFrozenTable) {

package/src/tui/command-palette.js

@@ -200,7 +200,9 @@ const BASE_COMMAND_TREE = [
         ],
       },
       { id: 'action-cycle-theme', label: 'Cycle theme', shortcut: 'G', icon: '🌗', description: 'Switch dark/light/auto', keywords: ['theme', 'dark', 'light', 'auto'] },
-      { id: 'action-reset-view', label: 'Reset view', shortcut: 'N', icon: '🔄', description: 'Reset filters and sort', keywords: ['reset', 'view', 'sort', 'filters'] },
+      { id: 'action-reset-view', label: 'Reset view', shortcut: 'N', icon: '\u{1F504}', description: 'Reset filters and sort', keywords: ['reset', 'view', 'sort', 'filters'] },
+      { id: 'action-probe-404', label: 'Probe 404 Models', shortcut: 'Ctrl+Shift+P', icon: '\u{1F50D}', description: 'Test all configured models for 404/410 errors. Auto-hides broken models.', keywords: ['probe', '404', 'broken', 'dead', 'health', 'check', 'test', 'verify'] },
+      { id: 'action-toggle-auto-hide-broken', label: 'Toggle Auto-hide Broken Models', icon: '\u{1F6A9}', description: 'Enable/disable auto-hiding of 404/410 models. Unhides all when disabled.', keywords: ['auto', 'hide', 'broken', '404', 'models', 'toggle', 'probe'] },
     ],
   },
   // 📖 Pages - directly at root level, not in submenu

package/src/tui/key-handler.js

@@ -39,6 +39,7 @@ import { join, dirname } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { spawn } from 'node:child_process'
 import { cleanupLegacyProxyArtifacts } from '../core/legacy-proxy-cleanup.js'
+import { sleep } from '../core/shared-helpers.js'
 import { getLastLayout, COLUMN_SORT_MAP } from './render-table.js'
 import { cycleThemeSetting, detectActiveTheme } from './theme.js'
 import { syncShellEnv, ensureShellRcSource, removeShellEnv } from '../core/shell-env.js'
@@ -53,6 +54,7 @@ import {
   cycleRouterDashboardProbeMode,
   openRouterDashboardOverlay,
   restartRouterDashboardDaemon,
+  setDashboardNotice,
   toggleRouterDashboardProbePause,
 } from '../core/router-dashboard.js'
 import {
@@ -61,6 +63,7 @@ import {
   handlePlaygroundKeypress,
 } from '../core/playground.js'
 import { benchmarkModel } from '../core/benchmark.js'
+import { isPackageDevMode } from '../core/updater.js'
 
 // 📖 Some providers need an explicit probe model because the first catalog entry
 // 📖 is not guaranteed to be accepted by their chat endpoint.
@@ -76,6 +79,52 @@ const PROVIDER_TEST_MODEL_OVERRIDES = {
 const SETTINGS_TEST_MAX_ATTEMPTS = 10
 const SETTINGS_TEST_RETRY_DELAY_MS = 4000
 
+// 📖 spawnDaemonCommand — spawns `--daemon-bg` or `--daemon-stop` and captures
+// 📖 the JSON result from stdout so we can surface startup errors to the user.
+// 📖 Falls back to a generic notice when stdout isn't parseable.
+function spawnDaemonCommand(state, args) {
+  const binPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'bin', 'free-coding-models.js')
+  // 📖 Inherit FCM_DEV so the spawned daemon matches the TUI's dev/prod mode.
+  // 📖 Without this, a dev-mode TUI (git checkout) spawns a production daemon
+  // 📖 that writes to the wrong PID/port files and can't be discovered later.
+  // 📖 isPackageDevMode() detects git checkouts even without --dev or FCM_DEV=1.
+  const env = { ...process.env }
+  if (isPackageDevMode() && !env.FCM_DEV) env.FCM_DEV = '1'
+  const child = spawn('node', [binPath, ...args], {
+    detached: true,
+    stdio: ['ignore', 'pipe', 'pipe'],
+    env,
+  })
+  child.unref()
+
+  // 📖 Only capture stdout for start commands — stop doesn't need error surfacing.
+  if (!args.includes('--daemon-bg')) return
+
+  let stdout = ''
+  let stderr = ''
+  child.stdout?.on('data', (chunk) => { stdout += chunk })
+  child.stderr?.on('data', (chunk) => { stderr += chunk })
+  child.on('close', (code) => {
+    if (code === 0) return
+    // 📖 Try to parse the JSON result from --daemon-bg for a precise error message.
+    let errorMsg = null
+    try {
+      const parsed = JSON.parse(stdout.trim())
+      if (parsed?.error) errorMsg = parsed.error
+    } catch {}
+    if (!errorMsg && stderr.trim()) {
+      // 📖 Common startup crash reasons: port in use, config corruption, etc.
+      const lines = stderr.trim().split('\n').filter(l => !l.startsWith('node:'))
+      errorMsg = lines.slice(0, 2).join(' — ') || stderr.trim().slice(0, 120)
+    }
+    if (errorMsg) {
+      setDashboardNotice(state, 'error', `Daemon failed to start: ${errorMsg}`, 8000)
+    } else if (code !== 0) {
+      setDashboardNotice(state, 'error', `Daemon failed to start (exit code ${code})`, 8000)
+    }
+  })
+}
+
 // 📖 PROVIDER_AUTH_ENDPOINTS maps provider keys to their auth-check URL + method.
 // 📖 For most providers this is the /models endpoint (returns 200=valid, 401=invalid).
 // 📖 Providers without an auth-check endpoint use null (falls back to chat completion ping).
@@ -114,11 +163,7 @@ const PROVIDER_AUTH_ENDPOINTS = {
   'ollama-cloud': { url: 'https://ollama.com/v1/models', method: 'GET' },
 }
 
-// 📖 Sleep helper kept local to this module so the Settings key test flow can
-// 📖 back off between retries without leaking timer logic into the rest of the TUI.
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms))
-}
+// 📖 Sleep imported from shared-helpers.js
 
 // 📖 testProviderKeyDirect: Fast auth-only check using /v1/account or /v1/models.
 // 📖 Fires 3 parallel probes to get a fast decisive result (auth error vs timeout vs 200).
@@ -792,6 +837,42 @@ export function createKeyHandler(ctx) {
     })
   }
 
+  // 📖 toggleAutoHideBrokenModels: Toggle auto-hiding of 404/410 models from probe.
+  // 📖 When disabling, unhide all previously hidden models so they become visible again.
+  function toggleAutoHideBrokenModels() {
+    if (!state.config.settings || typeof state.config.settings !== 'object') state.config.settings = {}
+    const wasEnabled = state.config.settings.autoHideBrokenModels !== false
+    state.config.settings.autoHideBrokenModels = !wasEnabled
+
+    if (!wasEnabled) {
+      // 📖 Just enabled — models that were hidden before enabling will be picked up on next probe
+    } else {
+      // 📖 Just disabled — unhide all probe-hidden models so user can see them again
+      if (state.config.hiddenModels instanceof Set && state.config.hiddenModels.size > 0) {
+        const keysToUnhide = [...state.config.hiddenModels]
+        state.config.hiddenModels.clear()
+        for (const key of keysToUnhide) {
+          const [pk, ...rest] = key.split('/')
+          const modelId = rest.join('/')
+          const result = state.results.find(r => r.providerKey === pk && r.modelId === modelId)
+          if (result) result.hidden = false
+        }
+      }
+    }
+
+    saveConfig(state.config)
+    const hiddenCount = state.config.hiddenModels instanceof Set ? state.config.hiddenModels.size : 0
+    state.settingsSyncStatus = {
+      type: 'success',
+      msg: state.config.settings.autoHideBrokenModels
+        ? `✅ Auto-hide enabled — broken models (404/410) from Ctrl+Shift+P probe are hidden automatically.${hiddenCount ? ` (${hiddenCount} currently hidden)` : ''}`
+        : '✅ Auto-hide disabled — all models are visible. Previously hidden models have been unhidden.',
+    }
+    trackAppAction('auto_hide_broken_models_toggled', {
+      enabled: state.config.settings.autoHideBrokenModels !== false,
+    })
+  }
+
   function toggleShellEnv() {
     if (!state.config.settings) state.config.settings = {}
     const currentlyEnabled = state.config.settings.shellEnvEnabled === true
@@ -1132,6 +1213,96 @@ export function createKeyHandler(ctx) {
     return Promise.all(workers).then(() => results)
   }
 
+  // 📖 runBrokenModelProbe: Probe all configured models for 404/broken endpoints.
+  // 📖 Sends a real chat-completion request to each model with an API key.
+  // 📖 Models returning 404 or 410 are auto-hidden when setting is enabled.
+  // 📖 Results flash live in the TUI table — models flip status in real time.
+  async function runBrokenModelProbe(state) {
+    if (state.probeRunning) return
+
+    // 📖 Only probe models where the user has an API key configured
+    const probeable = state.results.filter(r => {
+      const apiKey = getApiKey(state.config, r.providerKey)
+      return !!apiKey
+    })
+
+    if (probeable.length === 0) return
+
+    state.probeRunning = true
+    state.probeTotal = probeable.length
+    state.probeCompleted = 0
+    state.probeHiddenCount = 0
+
+    const autoHide = state.config.settings?.autoHideBrokenModels !== false
+    const HTTP_CODES_404 = new Set([404, '404'])
+    const HTTP_CODES_GONE = new Set([410, '410'])
+
+    const tasks = probeable.map(r => async () => {
+      const apiKey = getApiKey(state.config, r.providerKey) ?? null
+      const providerUrl = sources[r.providerKey]?.url ?? null
+      if (!apiKey || !providerUrl) {
+        state.probeCompleted++
+        return { model: r, ok: false, reason: 'no_key' }
+      }
+
+      try {
+        const { code } = await ping(apiKey, r.modelId, r.providerKey, providerUrl)
+        state.probeCompleted++
+
+        if (HTTP_CODES_404.has(code) || HTTP_CODES_GONE.has(code)) {
+          // 📖 Model is broken (404/410) — mark it
+          r.status = 'down'
+          r.httpCode = String(code)
+
+          if (autoHide) {
+            const modelKey = `${r.providerKey}/${r.modelId}`
+            if (!state.config.hiddenModels) state.config.hiddenModels = new Set()
+            state.config.hiddenModels.add(modelKey)
+            r.hidden = true
+            state.probeHiddenCount++
+          }
+
+          return { model: r, ok: false, code, reason: 'broken' }
+        } else if (code === '200') {
+          // 📖 Model is alive — unhide if it was previously hidden by probe
+          const modelKey = `${r.providerKey}/${r.modelId}`
+          if (state.config.hiddenModels?.has(modelKey)) {
+            state.config.hiddenModels.delete(modelKey)
+            r.hidden = false
+          }
+          r.status = 'up'
+          return { model: r, ok: true, code }
+        } else {
+          // 📖 Other codes (401, 429, etc.) — leave status unchanged, don't hide
+          return { model: r, ok: false, code, reason: 'other' }
+        }
+      } catch (err) {
+        state.probeCompleted++
+        return { model: r, ok: false, reason: 'error', error: err?.message }
+      }
+    })
+
+    await runWithConcurrency(tasks, 5)
+
+    // 📖 Persist hidden models set to config
+    if (autoHide && state.probeHiddenCount > 0) {
+      saveConfig(state.config)
+    }
+
+    state.probeRunning = false
+    // 📖 Keep totals visible for a few seconds so user can see results
+    setTimeout(() => {
+      if (!state.probeRunning) {
+        state.probeTotal = 0
+        state.probeCompleted = 0
+        // 📖 Don't reset probeHiddenCount immediately — user needs to see how many were hidden
+        setTimeout(() => {
+          state.probeHiddenCount = 0
+        }, 5000)
+      }
+    }, 3000)
+  }
+
   // 📖 runGlobalBenchmark: Benchmark all visible models with up to 5 concurrent requests.
   // 📖 Results are stored in state.benchmarkResults (same format as individual benchmarks).
   async function runGlobalBenchmark(state) {
@@ -1486,6 +1657,8 @@ export function createKeyHandler(ctx) {
       case 'action-toggle-favorite': return toggleFavoriteOnSelectedRow()
       case 'action-toggle-favorite-mode': return toggleFavoritesDisplayMode()
       case 'action-reset-view': return resetViewSettings()
+      case 'action-probe-404': return runBrokenModelProbe(state)
+      case 'action-toggle-auto-hide-broken': return toggleAutoHideBrokenModels()
       default:
         return
     }
@@ -1512,13 +1685,22 @@ export function createKeyHandler(ctx) {
     }
 
     // 📖 Ctrl+U: Global AI Speed Benchmark (benchmark all visible models, 5 concurrent)
-    // 📖 Also handles the raw \x15 byte as a fallback for terminals where readline doesn't
-    // 📖 set key.ctrl properly (same pattern as Ctrl+C → \x03 fallback).
+    // Also handles the raw \x15 byte as a fallback for terminals where readline doesn't
+    // set key.ctrl properly (same pattern as Ctrl+C → \x03 fallback).
     if ((key.ctrl && key.name === 'u') || str === '\x15') {
       await runGlobalBenchmark(state)
       return
     }
 
+    // 📖 Ctrl+Shift+P: Probe all configured models for 404/broken endpoints.
+    // 📖 Sends a real chat-completion request to every model that has an API key.
+    // 📖 Models returning 404/410 are auto-hidden (when setting is enabled).
+    // 📖 Results flash live in the table — models flip from down→up in real time.
+    if (key.ctrl && key.shift && key.name === 'p') {
+      await runBrokenModelProbe(state)
+      return
+    }
+
     // 📖 Command palette captures the keyboard while active.
     if (state.commandPaletteOpen) {
       if (key.ctrl && key.name === 'c') { exit(0); return }
@@ -1669,15 +1851,9 @@ export function createKeyHandler(ctx) {
       // 📖 S: Toggle daemon start/stop
       if (key.name === 's') {
         const isRunning = state.routerDashboardStatus === 'ready' || state.routerDashboardStatus === 'partial'
-        const binPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'bin', 'free-coding-models.js')
         const args = isRunning ? ['--daemon-stop'] : ['--daemon-bg']
-        
         state.routerDashboardStatus = 'loading'
-        const child = spawn('node', [binPath, ...args], {
-          detached: true,
-          stdio: 'ignore',
-        })
-        child.unref()
+        spawnDaemonCommand(state, args)
         return
       }
 
@@ -1688,15 +1864,9 @@ export function createKeyHandler(ctx) {
 
         if ((state.routerDashboardCursorIndex ?? 0) === btnCursor) {
           const isRunning = state.routerDashboardStatus === 'ready' || state.routerDashboardStatus === 'partial'
-          const binPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'bin', 'free-coding-models.js')
           const args = isRunning ? ['--daemon-stop'] : ['--daemon-bg']
-          
           state.routerDashboardStatus = 'loading'
-          const child = spawn('node', [binPath, ...args], {
-            detached: true,
-            stdio: 'ignore',
-          })
-          child.unref()
+          spawnDaemonCommand(state, args)
         } else if ((state.routerDashboardCursorIndex ?? 0) === installBtnCursor) {
           state.routerDashboardOpen = false
           state.installEndpointsOpen = true
@@ -2277,9 +2447,32 @@ export function createKeyHandler(ctx) {
             const binPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'bin', 'free-coding-models.js')
             const child = spawn('node', [binPath, '--daemon-bg'], {
               detached: true,
-              stdio: 'ignore',
+              stdio: ['ignore', 'pipe', 'pipe'],
+              env: { ...process.env, ...(isPackageDevMode() && !process.env.FCM_DEV ? { FCM_DEV: '1' } : {}) },
             })
             child.unref()
+
+            // 📖 Capture daemon startup output so we can show the real error reason
+            let onboardingStdout = ''
+            let onboardingStderr = ''
+            child.stdout?.on('data', (chunk) => { onboardingStdout += chunk })
+            child.stderr?.on('data', (chunk) => { onboardingStderr += chunk })
+            child.on('close', (code) => {
+              if (code === 0) return
+              let detail = null
+              try {
+                const parsed = JSON.parse(onboardingStdout.trim())
+                if (parsed?.error) detail = parsed.error
+              } catch {}
+              if (!detail && onboardingStderr.trim()) {
+                const lines = onboardingStderr.trim().split('\n').filter(l => !l.startsWith('node:'))
+                detail = lines.slice(0, 2).join(' — ') || onboardingStderr.trim().slice(0, 120)
+              }
+              if (state.routerOnboardingPhase === 'loading') {
+                state.routerOnboardingPhase = 'error'
+                state.routerOnboardingError = detail || `Daemon exited with code ${code}`
+              }
+            })
             await new Promise((r) => setTimeout(r, 2000))
             if (state.routerOnboardingPhase === 'loading') {
               state.routerOnboardingPhase = 'success'
@@ -2534,7 +2727,8 @@ export function createKeyHandler(ctx) {
       const themeRowIdx = updateRowIdx + 1
       const favoritesModeRowIdx = themeRowIdx + 1
       const startupAiSpeedScanRowIdx = favoritesModeRowIdx + 1
-      const cleanupLegacyProxyRowIdx = startupAiSpeedScanRowIdx + 1
+      const autoHideBrokenModelsRowIdx = startupAiSpeedScanRowIdx + 1
+      const cleanupLegacyProxyRowIdx = autoHideBrokenModelsRowIdx + 1
       const changelogViewRowIdx = cleanupLegacyProxyRowIdx + 1
       const shellEnvRowIdx = changelogViewRowIdx + 1
         // 📖 Profile system removed - API keys now persist permanently across all sessions
@@ -2696,6 +2890,12 @@ export function createKeyHandler(ctx) {
           return
         }
 
+        // 📖 Auto-hide broken models toggle
+        if (state.settingsCursor === autoHideBrokenModelsRowIdx) {
+          toggleAutoHideBrokenModels()
+          return
+        }
+
         if (state.settingsCursor === cleanupLegacyProxyRowIdx) {
           runLegacyProxyCleanup()
           return
@@ -2753,6 +2953,11 @@ export function createKeyHandler(ctx) {
           toggleStartupAiSpeedScan()
           return
         }
+        // 📖 Auto-hide broken models toggle (space)
+        if (state.settingsCursor === autoHideBrokenModelsRowIdx) {
+          toggleAutoHideBrokenModels()
+          return
+        }
         // 📖 Profile system removed - API keys now persist permanently across all sessions
 
         // 📖 Toggle enabled/disabled for selected provider
@@ -2770,6 +2975,7 @@ export function createKeyHandler(ctx) {
           || state.settingsCursor === themeRowIdx
           || state.settingsCursor === favoritesModeRowIdx
           || state.settingsCursor === startupAiSpeedScanRowIdx
+          || state.settingsCursor === autoHideBrokenModelsRowIdx
           || state.settingsCursor === cleanupLegacyProxyRowIdx
           || state.settingsCursor === changelogViewRowIdx
         ) return

package/src/tui/overlays.js

@@ -121,7 +121,8 @@ export function createOverlayRenderers(state, deps) {
     const themeRowIdx = updateRowIdx + 1
     const favoritesModeRowIdx = themeRowIdx + 1
     const startupAiSpeedScanRowIdx = favoritesModeRowIdx + 1
-    const cleanupLegacyProxyRowIdx = startupAiSpeedScanRowIdx + 1
+    const autoHideBrokenModelsRowIdx = startupAiSpeedScanRowIdx + 1
+    const cleanupLegacyProxyRowIdx = autoHideBrokenModelsRowIdx + 1
     const changelogViewRowIdx = cleanupLegacyProxyRowIdx + 1
     const shellEnvRowIdx = changelogViewRowIdx + 1
     const EL = '\x1b[K'
@@ -277,6 +278,16 @@ export function createOverlayRenderers(state, deps) {
     cursorLineByRow[startupAiSpeedScanRowIdx] = lines.length
     lines.push(state.settingsCursor === startupAiSpeedScanRowIdx ? themeColors.bgCursorSettingsList(startupAiSpeedScanRow) : startupAiSpeedScanRow)
 
+    // 📖 Auto-hide broken models row: toggles auto-hiding of 404/410 models from probe.
+    const autoHideEnabled = state.config.settings?.autoHideBrokenModels !== false
+    const hiddenCount = state.config.hiddenModels instanceof Set ? state.config.hiddenModels.size : 0
+    const autoHideStatus = autoHideEnabled
+      ? themeColors.successBold(`✅ Enabled (${hiddenCount} hidden)`)
+      : themeColors.errorBold('❌ Disabled')
+    const autoHideRow = `${bullet(state.settingsCursor === autoHideBrokenModelsRowIdx)}${themeColors.textBold('Auto-hide Broken Models').padEnd(44)} ${autoHideStatus}`
+    cursorLineByRow[autoHideBrokenModelsRowIdx] = lines.length
+    lines.push(state.settingsCursor === autoHideBrokenModelsRowIdx ? themeColors.bgCursorSettingsList(autoHideRow) : autoHideRow)
+
     if (updateState === 'error' && state.settingsUpdateError) {
       lines.push(themeColors.error(`      ${state.settingsUpdateError}`))
     }
@@ -950,6 +961,7 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${key('Ctrl+P')}  Open ⚡️ command palette  ${hint('(search and run actions quickly)')}`)
     lines.push(`  ${key('Ctrl+A')}  AI Speed Test  ${hint('(benchmark selected model → time + TPS)')}`)
     lines.push(`  ${key('Ctrl+U')}  Global AI Speed Test  ${hint('(benchmark all models; Settings can auto-run it on startup)')}`)
+    lines.push(`  ${key('Ctrl+Shift+P')}  Probe 404 Models  ${hint('(test all configured models; auto-hide broken 404/410)')}`)
     lines.push(`  ${key('E')}  Cycle filter mode  ${hint('(Normal → Configured only → Usable only)')}`)
     lines.push(`  ${key('Z')}  Cycle tool mode  ${hint('(📦 OpenCode → π Pi → 🪼 jcode → 📦 Desktop → 🦞 OpenClaw → 💘 Crush → 🪿 Goose → 🛠 Aider → 🐉 Qwen → 🤲 OpenHands → ⚡ Amp)')}`)
     lines.push(`  ${key('F')}  Toggle favorite on selected row  ${hint('(1️⃣2️⃣3️⃣ = router fallback order, capped at 🔟)')}`)