free-coding-models 0.5.88 → 0.5.89

package/src/core/utils.js

@@ -608,6 +608,13 @@ export function parseArgs(argv) {
   const daemonBackgroundMode = flags.includes('--daemon-bg')
   const daemonStopMode = flags.includes('--daemon-stop')
   const daemonStatusMode = flags.includes('--daemon-status')
+  // 📖 Router v2 (beta) lifecycle flags - run v2 alongside v1 on its own
+  // port (19380) with persisted breakers + decision traces. See
+  // src/core/router-v2/daemon.js and docs/router-v2.md.
+  const routerV2Mode = flags.includes('--router-v2')
+  const routerV2BackgroundMode = flags.includes('--router-v2-bg')
+  const routerV2StopMode = flags.includes('--router-v2-stop')
+  const routerV2StatusMode = flags.includes('--router-v2-status')
 
   // 📖 --fix-permissions / --yes / -y - auto-answer "yes" to the config-permission
   // 📖 security prompt (chmod 600, best-effort on Windows) so scripts, CI and
@@ -706,6 +713,11 @@ export function parseArgs(argv) {
     checkDriftMode,
     driftThreshold,
     daemonStatusMode,
+    // 📖 Router v2 (beta) lifecycle flags - see src/core/router-v2/daemon.js
+    routerV2Mode,
+    routerV2BackgroundMode,
+    routerV2StopMode,
+    routerV2StatusMode,
     // 📖 Profile system removed - API keys now persist permanently across all sessions
     recommendMode,
     devMode,

package/src/tui/app.js

@@ -123,6 +123,7 @@ import { createOverlayRenderers } from './overlays.js'
 import { createKeyHandler, createMouseEventHandler } from './key-handler.js'
 import { createMouseHandler, containsMouseSequence } from './mouse.js'
 import { stopRouterDashboardClient } from '../core/router-dashboard.js'
+import { stopRouterV2DashboardClient } from '../core/router-v2/tui-dashboard.js'
 import { getToolModeOrder, getToolMeta } from '../core/tool-metadata.js'
 import { startExternalTool } from '../core/tool-launchers.js'
 import { getToolInstallPlan, installToolWithPlan, isToolInstalled } from '../core/tool-bootstrap.js'
@@ -758,6 +759,7 @@ export async function runApp(cliArgs, config, startupOptions = {}) {
     clearTimeout(state.pingIntervalObj)
     clearInterval(state.versionRecheckTimer)
     stopRouterDashboardClient(state)
+    stopRouterV2DashboardClient(state)
     process.stdout.write(ALT_LEAVE)
     if (process.stdout.isTTY) {
       process.stdout.flush && process.stdout.flush()
@@ -782,6 +784,7 @@ export async function runApp(cliArgs, config, startupOptions = {}) {
     clearTimeout(state.pingIntervalObj)
     clearInterval(state.versionRecheckTimer)
     stopRouterDashboardClient(state)
+    stopRouterV2DashboardClient(state)
     // 📖 Remove the actual registered wrappers (see keypressWrapper/mouseDataWrapper).
     if (keypressWrapper) process.stdin.removeListener('keypress', keypressWrapper)
     if (mouseDataWrapper) process.stdin.removeListener('data', mouseDataWrapper)
@@ -1118,6 +1121,8 @@ export async function runApp(cliArgs, config, startupOptions = {}) {
         ? overlays.renderInstalledModels()
       : state.routerDashboardOpen
         ? overlays.renderRouterDashboard()
+      : state.routerV2DashboardOpen
+        ? overlays.renderRouterV2Dashboard()
       : state.playgroundOpen
         ? overlays.renderPlayground()
       : state.tokenUsageOpen
@@ -1261,9 +1266,9 @@ export async function runApp(cliArgs, config, startupOptions = {}) {
     }
 
     state.results.forEach(r => {
-      // 📖 When router dashboard is open, ONLY ping favorites every second
+      // 📖 When a router dashboard is open, ONLY ping favorites every second
       // 📖 to prevent massive rate limiting across the entire 90+ model catalog.
-      if (state.routerDashboardOpen) {
+      if (state.routerDashboardOpen || state.routerV2DashboardOpen) {
         const favKey = `${r.providerKey}/${r.modelId}`
         if (!state.config.favorites.includes(favKey)) return
       }

package/src/tui/cli-help.js

@@ -47,6 +47,10 @@ const CONFIG_FLAGS = [
   { flag: '--daemon-bg', description: 'Start the FCM Router daemon in the background' },
   { flag: '--daemon-status', description: 'Print FCM Router daemon status JSON' },
   { flag: '--daemon-stop', description: 'Gracefully stop the FCM Router daemon' },
+  { flag: '--router-v2', description: 'Start the Router v2 daemon (BETA) on port 19380: content-validated failover + Anthropic /v1/messages' },
+  { flag: '--router-v2-bg', description: 'Start Router v2 (BETA) in the background' },
+  { flag: '--router-v2-status', description: 'Print Router v2 (BETA) daemon status JSON' },
+  { flag: '--router-v2-stop', description: 'Gracefully stop the Router v2 (BETA) daemon' },
   { flag: '--sync-set [name]', description: 'Auto-discover and live-probe models into a router set' },
   { flag: '--config-dir <dir>', description: 'Store config.json + backups/ in <dir> (e.g. --config-dir ~/.config/free-coding-models for the XDG layout)' },
   { flag: '--fix-permissions, --yes, -y', description: 'Auto-fix insecure config file permissions (chmod 600) without prompting; safe for scripts and CI' },

package/src/tui/key-handler.js

@@ -46,6 +46,15 @@ import {
   setDashboardNotice,
   toggleRouterDashboardProbePause,
 } from '../core/router-dashboard.js'
+import {
+  closeRouterV2DashboardOverlay,
+  cycleRouterV2ProbeMode,
+  openRouterV2DashboardOverlay,
+  renderRouterV2Dashboard,
+  setRouterV2Notice,
+  testAllVisibleViaRouterV2,
+  testModelViaRouterV2,
+} from '../core/router-v2/tui-dashboard.js'
 import {
   closePlaygroundOverlay,
   openPlaygroundOverlay,
@@ -82,8 +91,8 @@ function spawnDaemonCommand(state, args) {
   })
   child.unref()
 
-  // 📖 Only capture stdout for start commands — stop doesn't need error surfacing.
-  if (!args.includes('--daemon-bg')) return
+  // 📖 Only capture stdout for start commands - stop doesn't need error surfacing.
+  if (!args.includes('--daemon-bg') && !args.includes('--router-v2-bg')) return
 
   let stdout = ''
   let stderr = ''
@@ -1502,6 +1511,7 @@ export function createKeyHandler(ctx) {
 
       case 'open-recommend': return openRecommendOverlay()
       case 'open-router-dashboard': return openRouterDashboardOverlay(state)
+      case 'open-router-v2-dashboard': return openRouterV2DashboardOverlay(state)
       case 'open-playground': return openPlaygroundOverlay(state)
       case 'open-token-usage': return openTokenUsageOverlay()
       case 'open-runtime-report': return openRuntimeReportOverlay()
@@ -1774,6 +1784,82 @@ export function createKeyHandler(ctx) {
       return
     }
 
+    // 📖 Router v2 (BETA) dashboard: ↑↓ navigate the fallback chain,
+    // T tests the model under the cursor through the router (pinned request
+    // through the FULL chain), S toggles the daemon, I cycles probe speed,
+    // C clears the persisted history, Esc goes back.
+    if (state.routerV2DashboardOpen) {
+      const routingOrder = Array.isArray(state.routerV2Stats?.routingOrder) ? state.routerV2Stats.routingOrder : []
+      const maxCursor = Math.max(0, routingOrder.length)
+      const pageStep = Math.max(1, (state.terminalRows || 1) - 4)
+
+      if (key.name === 'escape') {
+        closeRouterV2DashboardOverlay(state)
+        return
+      }
+
+      if (key.name === 's') {
+        const isRunning = state.routerV2Status === 'ready' || state.routerV2Status === 'partial'
+        state.routerV2Status = 'loading'
+        spawnDaemonCommand(state, [isRunning ? '--daemon-stop' : '--daemon-bg'])
+        return
+      }
+
+      if (key.name === 'return' || key.name === 'enter') {
+        if ((state.routerV2CursorIndex ?? 0) === maxCursor) {
+          const isRunning = state.routerV2Status === 'ready' || state.routerV2Status === 'partial'
+          state.routerV2Status = 'loading'
+          spawnDaemonCommand(state, [isRunning ? '--daemon-stop' : '--daemon-bg'])
+        }
+        return
+      }
+
+      if (key.name === 't') {
+        const entry = routingOrder[state.routerV2CursorIndex ?? 0]
+        if (entry?.key) void testModelViaRouterV2(state, entry.key)
+        return
+      }
+
+      if (key.name === 'up' || key.name === 'k') {
+        state.routerV2CursorIndex = Math.max(0, (state.routerV2CursorIndex ?? 0) - 1)
+        return
+      }
+      if (key.name === 'down' || key.name === 'j') {
+        state.routerV2CursorIndex = Math.min(maxCursor, (state.routerV2CursorIndex ?? 0) + 1)
+        return
+      }
+      if (key.name === 'pageup') {
+        state.routerV2ScrollOffset = Math.max(0, (state.routerV2ScrollOffset || 0) - pageStep)
+        return
+      }
+      if (key.name === 'pagedown') {
+        state.routerV2ScrollOffset = (state.routerV2ScrollOffset || 0) + pageStep
+        return
+      }
+      if (key.name === 'home') {
+        state.routerV2CursorIndex = 0
+        state.routerV2ScrollOffset = 0
+        return
+      }
+      if (key.name === 'i') {
+        try { await cycleRouterV2ProbeMode(state) } catch {}
+        return
+      }
+      if (key.name === 'c') {
+        void (async () => {
+          try {
+            if (state.routerV2BaseUrl) {
+              await fetch(`${state.routerV2BaseUrl}/api/router-v2/history`, { method: 'DELETE' })
+              state.routerV2History = null
+              setRouterV2Notice(state, 'success', 'Request history cleared.')
+            }
+          } catch {}
+        })()
+        return
+      }
+      return
+    }
+
     // 📖 Playground overlay: handles Enter, Esc, Backspace, Ctrl+S, Ctrl+L,
     // 📖 PageUp/PageDown, and printable input itself. The dedicated handler
     // 📖 in core/playground.js owns the draft and submission state.
@@ -2926,6 +3012,16 @@ export function createKeyHandler(ctx) {
       return
     }
 
+    // 📖 Shift+V: Open / close the Router v2 (BETA) dashboard.
+    if (key.name === 'v' && key.shift && !key.ctrl && !key.meta) {
+      if (state.routerV2DashboardOpen) {
+        closeRouterV2DashboardOverlay(state)
+        return
+      }
+      openRouterV2DashboardOverlay(state)
+      return
+    }
+
     // 📖 Shift+T: open the Token Usage screen.
     if (key.name === 't' && key.shift && !key.ctrl && !key.meta) {
       openTokenUsageOverlay()
@@ -3070,6 +3166,25 @@ export function createKeyHandler(ctx) {
       return
     }
 
+    // 📖 Ctrl+T: test the selected model THROUGH the Router v2 daemon (beta).
+    // 📖 Unlike Ctrl+A (direct provider call), this exercises the full routing
+    // chain: schema normalization, pre-prompt, content gate and the breaker
+    // update. The pinned-model request runs with failover disabled.
+    if (key.ctrl && key.name === 't' && !key.shift) {
+      const selected = state.visibleSorted?.[state.cursor]
+      if (selected?.providerKey && selected?.modelId) {
+        void testModelViaRouterV2(state, `${selected.providerKey}/${selected.modelId}`)
+      }
+      return
+    }
+
+    // 📖 Ctrl+Shift+T: test every visible configured model through Router v2,
+    // results streaming into the Shift+V overlay as they land.
+    if (key.ctrl && key.shift && key.name === 't') {
+      void testAllVisibleViaRouterV2(state)
+      return
+    }
+
     if (key.shift && key.name === 'up') {
       const selected = state.visibleSorted?.[state.cursor]
       if (selected?.isFavorite) {

package/src/tui/overlays.js

@@ -21,6 +21,7 @@
 
 import { buildCliHelpLines } from './cli-help.js'
 import { renderRouterDashboard as renderRouterDashboardOverlay } from '../core/router-dashboard.js'
+import { renderRouterV2Dashboard as renderRouterV2DashboardOverlay } from '../core/router-v2/tui-dashboard.js'
 import { renderPlayground as renderPlaygroundOverlay } from '../core/playground.js'
 import { themeColors, getThemeStatusLabel, getProviderRgb } from './theme.js'
 import { getProviderBillingNote, getProviderLabelWithBilling } from '../core/provider-metadata.js'
@@ -1016,6 +1017,8 @@ 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+T')}  Test selected model via Router v2  ${hint('(real request through the daemon: gate + failover included)')}`)
+    lines.push(`  ${key('Ctrl+Shift+T')}  Test all visible models via Router v2  ${hint('(results stream into the Shift+V dashboard)')}`)
     lines.push(`  ${key('Shift+P')}  Re-probe failed rows  ${hint('(retry only rows showing auth fail / 429 / 404 / timeout - not the whole list)')}`)
     lines.push(`  ${key('Ctrl+Shift+P')}  Probe All Models  ${hint('(test all configured models; auto-hide broken 404/410)')}`)
     lines.push(`  ${key('Space')}  Expand selected row  ${hint('(2-line detail: provider, endpoint, full model id; Space again or move to collapse)')}`)
@@ -1413,6 +1416,12 @@ export function createOverlayRenderers(state, deps) {
     return renderRouterDashboardOverlay(state, { LOCAL_VERSION })
   }
 
+  // 📖 Router v2 (BETA) overlay (Shift+V): hardened failover daemon view with
+  // request chains, DEGRADED states and pinned-model tests through the router.
+  function renderRouterV2Dashboard() {
+    return renderRouterV2DashboardOverlay(state, { LOCAL_VERSION })
+  }
+
   // ─── Playground overlay ───────────────────────────────────────────────────────
   // 📖 Renders the in-TUI chat playground when the user presses `;` or opens
   // 📖 it from the command palette. All chat traffic flows to the local
@@ -1648,6 +1657,7 @@ export function createOverlayRenderers(state, deps) {
     renderChangelog,
     renderInstalledModels,
     renderRouterDashboard,
+    renderRouterV2Dashboard,
     renderPlayground,
     renderIncompatibleFallback,
     renderTokenUsage,

package/src/tui/tui-state.js

@@ -292,6 +292,28 @@ export function createTuiState({
     routerDashboardEverOpened: false,
     routerDashboardCursorIndex: 0,
 
+    // 📖 Router v2 (BETA) dashboard overlay (Shift+V). Talks to the parallel
+    // v2 daemon on port 19380: same defensive polling shape as v1 plus
+    // pinned-model test results and the persisted request-chain history.
+    routerV2DashboardOpen: false,
+    routerV2Status: 'idle',
+    routerV2BaseUrl: null,
+    routerV2Port: null,
+    routerV2Health: null,
+    routerV2Stats: null,
+    routerV2History: null,
+    routerV2Error: null,
+    routerV2ScrollOffset: 0,
+    routerV2CursorIndex: 0,
+    routerV2PollTimer: null,
+    routerV2EventAbort: null,
+    routerV2Notice: null,
+    routerV2NoticeTimer: null,
+    routerV2TestResults: new Map(),
+    routerV2TestRunning: new Set(),
+    routerV2BatchTest: null,
+    routerV2LastEventAt: null,
+
     // 📖 Custom text filter (Ctrl+P → type text → Enter). Ephemeral — not saved to config.
     customTextFilter: null,