free-coding-models 0.5.28 → 0.5.30

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,8 +307,8 @@ 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,

package/src/tui/command-palette.js

@@ -202,6 +202,7 @@ 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: '\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).
@@ -1613,6 +1658,7 @@ export function createKeyHandler(ctx) {
       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
     }
@@ -1805,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
       }
 
@@ -1824,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
@@ -2413,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'

package/src/tui/render-table.js

@@ -49,7 +49,7 @@ import {
 } from '../core/constants.js'
 import { themeColors, currentPalette, getProviderRgb, getTierRgb, getReadableTextRgb, getTheme, THEME_BG_RGB } from './theme.js'
 import { TIER_COLOR } from './tier-colors.js'
-import { getAvg, getVerdict, getUptime, getStabilityScore, getVersionStatusInfo, NEW_MODELS } from '../core/utils.js'
+import { getAvg, getVerdict, getUptime, getStabilityScore, getVersionStatusInfo, isNewModel } from '../core/utils.js'
 import { usagePlaceholderForProvider } from '../core/ping.js'
 import { formatBenchmarkLatency, formatBenchmarkTps } from '../core/benchmark.js'
 import { calculateViewport, sortResultsWithPinnedFavorites, padEndDisplay, displayWidth, stripAnsi, fadedRow } from './render-helpers.js'
@@ -656,13 +656,13 @@ export function renderTable({
       : providerName
     const source = themeColors.provider(r.providerKey, providerDisplay.padEnd(wSource))
     // 📖 Prefix: ⭐ favorite > 🎯 recommended > 🆕 new — only one emoji, never shifts the line
-    const isNewModel = NEW_MODELS.has(r.modelId) || NEW_MODELS.has(`${r.providerKey}/${r.modelId}`)
+    const modelIsNew = isNewModel(r.addedDate)
     let favoritePrefix = ''
     if (r.isRecommended) {
       favoritePrefix = '🎯 '
     } else if (r.isFavorite) {
       favoritePrefix = '⭐ '
-    } else if (isNewModel) {
+    } else if (modelIsNew) {
       favoritePrefix = '🆕 '
     }
     const prefixDisplayWidth = displayWidth(favoritePrefix)