free-coding-models 0.4.3 → 0.5.1

package/src/{app.js → tui/app.js}

@@ -96,45 +96,45 @@ import { readFileSync, writeFileSync, existsSync, copyFileSync, mkdirSync } from
 import { randomUUID } from 'crypto'
 import { homedir } from 'os'
 import { join, dirname } from 'path'
-import { MODELS, sources } from '../sources.js'
-import { getAvg, getVerdict, getUptime, getP95, getJitter, getStabilityScore, sortResults, filterByTier, findBestModel, parseArgs, TIER_ORDER, VERDICT_ORDER, TIER_LETTER_MAP, scoreModelForTask, getTopRecommendations, TASK_TYPES, PRIORITY_TYPES, CONTEXT_BUDGETS, formatCtxWindow, labelFromId, formatResultsAsJSON } from '../src/utils.js'
-import { loadConfig, saveConfig, getApiKey, resolveApiKeys, addApiKey, removeApiKey, isProviderEnabled, persistApiKeysForProvider } from '../src/config.js'
-import { buildMergedModels } from '../src/model-merger.js'
-import { loadOpenCodeConfig, saveOpenCodeConfig } from '../src/opencode-config.js'
-import { usageForRow as _usageForRow } from '../src/usage-reader.js'
-import { buildProviderModelTokenKey, loadTokenUsageByProviderModel } from '../src/token-usage-reader.js'
-import { parseOpenRouterResponse, fetchProviderQuota as _fetchProviderQuotaFromModule } from '../src/provider-quota-fetchers.js'
-import { isKnownQuotaTelemetry } from '../src/quota-capabilities.js'
-import { ALT_ENTER, ALT_LEAVE, ALT_HOME, PING_TIMEOUT, PING_INTERVAL, FPS, COL_MODEL, COL_MS, CELL_W, FRAMES, TIER_CYCLE, VERDICT_CYCLE, HEALTH_CYCLE, SETTINGS_OVERLAY_BG, HELP_OVERLAY_BG, RECOMMEND_OVERLAY_BG, OVERLAY_PANEL_WIDTH, TABLE_HEADER_LINES, TABLE_FOOTER_LINES, TABLE_FIXED_LINES, WIDTH_WARNING_MIN_COLS, msCell, spinCell } from '../src/constants.js'
-import { TIER_COLOR } from '../src/tier-colors.js'
-import { resolveCloudflareUrl, buildPingRequest, ping, extractQuotaPercent, getProviderQuotaPercentCached, usagePlaceholderForProvider } from '../src/ping.js'
-import { runFiableMode, filterByTierOrExit, fetchOpenRouterFreeModels } from '../src/analysis.js'
-import { PROVIDER_METADATA, ENV_VAR_NAMES, isWindows, isMac } from '../src/provider-metadata.js'
-import { parseTelemetryEnv, isTelemetryDebugEnabled, telemetryDebug, ensureTelemetryConfig, getTelemetryDistinctId, getTelemetrySystem, getTelemetryTerminal, isTelemetryEnabled, sendUsageTelemetry } from '../src/telemetry.js'
-import { ensureFavoritesConfig, toFavoriteKey, syncFavoriteFlags, toggleFavoriteModel, reorderFavorite, pruneOrphanedFavorites } from '../src/favorites.js'
-import { checkForUpdateDetailed, checkForUpdate, runUpdate, fetchLastReleaseDate } from './updater.js'
+import { MODELS, sources } from '../../sources.js'
+import { getAvg, getVerdict, getUptime, getP95, getJitter, getStabilityScore, sortResults, filterByTier, findBestModel, parseArgs, TIER_ORDER, VERDICT_ORDER, TIER_LETTER_MAP, scoreModelForTask, getTopRecommendations, TASK_TYPES, PRIORITY_TYPES, CONTEXT_BUDGETS, formatCtxWindow, labelFromId, formatResultsAsJSON } from '../core/utils.js'
+import { loadConfig, saveConfig, getApiKey, resolveApiKeys, addApiKey, removeApiKey, isProviderEnabled, persistApiKeysForProvider } from '../core/config.js'
+import { buildMergedModels } from '../core/model-merger.js'
+import { loadOpenCodeConfig, saveOpenCodeConfig } from '../core/opencode-config.js'
+import { usageForRow as _usageForRow } from '../core/usage-reader.js'
+import { buildProviderModelTokenKey, loadTokenUsageByProviderModel } from '../core/token-usage-reader.js'
+import { parseOpenRouterResponse, fetchProviderQuota as _fetchProviderQuotaFromModule } from '../core/provider-quota-fetchers.js'
+import { isKnownQuotaTelemetry } from '../core/quota-capabilities.js'
+import { ALT_ENTER, ALT_LEAVE, ALT_HOME, PING_TIMEOUT, PING_INTERVAL, FPS, COL_MODEL, COL_MS, CELL_W, FRAMES, TIER_CYCLE, VERDICT_CYCLE, HEALTH_CYCLE, SETTINGS_OVERLAY_BG, HELP_OVERLAY_BG, RECOMMEND_OVERLAY_BG, OVERLAY_PANEL_WIDTH, TABLE_HEADER_LINES, TABLE_FOOTER_LINES, TABLE_FIXED_LINES, WIDTH_WARNING_MIN_COLS, msCell, spinCell } from '../core/constants.js'
+import { TIER_COLOR } from './tier-colors.js'
+import { resolveCloudflareUrl, buildPingRequest, ping, extractQuotaPercent, getProviderQuotaPercentCached, usagePlaceholderForProvider } from '../core/ping.js'
+import { runFiableMode, filterByTierOrExit, fetchOpenRouterFreeModels } from '../core/analysis.js'
+import { PROVIDER_METADATA, ENV_VAR_NAMES, isWindows, isMac } from '../core/provider-metadata.js'
+import { parseTelemetryEnv, isTelemetryDebugEnabled, telemetryDebug, ensureTelemetryConfig, getTelemetryDistinctId, getTelemetrySystem, getTelemetryTerminal, isTelemetryEnabled, sendUsageTelemetry } from '../core/telemetry.js'
+import { ensureFavoritesConfig, toFavoriteKey, syncFavoriteFlags, toggleFavoriteModel, reorderFavorite, pruneOrphanedFavorites } from '../core/favorites.js'
+import { checkForUpdateDetailed, checkForUpdate, runUpdate, fetchLastReleaseDate } from '../core/updater.js'
 import { createTuiState, PING_MODE_INTERVALS, PING_MODE_CYCLE, SPEED_MODE_DURATION_MS, IDLE_SLOW_AFTER_MS, intervalToPingMode } from './tui-state.js'
-import { createPingLoop } from './ping-loop.js'
+import { createPingLoop } from '../core/ping-loop.js'
 import { createTuiFilters } from './tui-filters.js'
-import { promptApiKey } from '../src/setup.js'
-import { syncShellEnv, ensureShellRcSource, removeShellEnv } from '../src/shell-env.js'
-import { stripAnsi, maskApiKey, displayWidth, padEndDisplay, tintOverlayLines, keepOverlayTargetVisible, sliceOverlayLines, calculateViewport, sortResultsWithPinnedFavorites, adjustScrollOffset } from '../src/render-helpers.js'
-import { renderTable, PROVIDER_COLOR } from '../src/render-table.js'
-import { setOpenCodeModelData, startOpenCode, startOpenCodeDesktop, startOpenCodeWeb } from '../src/opencode.js'
-import { startKilo } from '../src/kilo.js'
-import { startOpenClaw } from '../src/openclaw.js'
-import { createOverlayRenderers } from '../src/overlays.js'
-import { createKeyHandler, createMouseEventHandler } from '../src/key-handler.js'
-import { createMouseHandler, containsMouseSequence } from '../src/mouse.js'
-import { stopRouterDashboardClient } from '../src/router-dashboard.js'
-import { getToolModeOrder, getToolMeta } from '../src/tool-metadata.js'
-import { startExternalTool } from '../src/tool-launchers.js'
-import { getToolInstallPlan, installToolWithPlan, isToolInstalled } from '../src/tool-bootstrap.js'
-import { getConfiguredInstallableProviders, installProviderEndpoints, refreshInstalledEndpoints, getInstallTargetModes, getProviderCatalogModels } from '../src/endpoint-installer.js'
-import { loadCache, saveCache, clearCache, getCacheAge } from '../src/cache.js'
-import { checkConfigSecurity } from '../src/security.js'
-import { buildCliHelpText } from '../src/cli-help.js'
-import { detectActiveTheme } from '../src/theme.js'
+import { promptApiKey } from '../core/setup.js'
+import { syncShellEnv, ensureShellRcSource, removeShellEnv } from '../core/shell-env.js'
+import { stripAnsi, maskApiKey, displayWidth, padEndDisplay, tintOverlayLines, keepOverlayTargetVisible, sliceOverlayLines, calculateViewport, sortResultsWithPinnedFavorites, adjustScrollOffset } from './render-helpers.js'
+import { renderTable, PROVIDER_COLOR } from './render-table.js'
+import { setOpenCodeModelData, startOpenCode, startOpenCodeDesktop, startOpenCodeWeb } from '../core/opencode.js'
+import { startKilo } from '../core/kilo.js'
+import { startOpenClaw } from '../core/openclaw.js'
+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 { getToolModeOrder, getToolMeta } from '../core/tool-metadata.js'
+import { startExternalTool } from '../core/tool-launchers.js'
+import { getToolInstallPlan, installToolWithPlan, isToolInstalled } from '../core/tool-bootstrap.js'
+import { getConfiguredInstallableProviders, installProviderEndpoints, refreshInstalledEndpoints, getInstallTargetModes, getProviderCatalogModels } from '../core/endpoint-installer.js'
+import { loadCache, saveCache, clearCache, getCacheAge } from '../core/cache.js'
+import { checkConfigSecurity } from '../core/security.js'
+import { buildCliHelpText } from './cli-help.js'
+import { detectActiveTheme } from './theme.js'
 
 // 📖 mergedModels: cross-provider grouped model list (one entry per label, N providers each)
 // 📖 mergedModelByLabel: fast lookup map from display label → merged model entry
@@ -149,7 +149,7 @@ const require = createRequire(import.meta.url)
 const readline = require('readline')
 
 // ─── Version check ────────────────────────────────────────────────────────────
-const pkg = require('../package.json')
+const pkg = require('../../package.json')
 const LOCAL_VERSION = pkg.version
 
 // 📖 sendBugReport → imported from ../src/telemetry.js

package/src/{cli-help.js → tui/cli-help.js}

@@ -18,7 +18,7 @@
  * @see ./tool-metadata.js — source of truth for launcher modes and their CLI flags
  */
 
-import { getToolModeOrder, getToolMeta } from './tool-metadata.js'
+import { getToolModeOrder, getToolMeta } from '../core/tool-metadata.js'
 
 const ANALYSIS_FLAGS = [
   { flag: '--best', description: 'Show only top tiers (A+, S, S+)' },
@@ -36,6 +36,7 @@ const ANALYSIS_FLAGS = [
 ]
 
 const CONFIG_FLAGS = [
+  { flag: 'web | --web | --gui', description: 'Start the full-catalog realtime Web Dashboard' },
   { flag: '--daemon', description: 'Start the FCM Router daemon + web dashboard (same port)' },
   { flag: '--daemon-bg', description: 'Start the FCM Router daemon in the background' },
   { flag: '--daemon-status', description: 'Print FCM Router daemon status JSON' },
@@ -47,6 +48,7 @@ const CONFIG_FLAGS = [
 
 const EXAMPLES = [
   'free-coding-models --help',
+  'free-coding-models web',
   'free-coding-models --daemon',
   'free-coding-models --daemon-bg',
   'free-coding-models --daemon-status',

package/src/{command-palette.js → tui/command-palette.js}

@@ -15,8 +15,8 @@
  * @see src/overlays.js
  */
 
-import { TOOL_METADATA, TOOL_MODE_ORDER } from './tool-metadata.js'
-import { sources } from '../sources.js'
+import { TOOL_METADATA, TOOL_MODE_ORDER } from '../core/tool-metadata.js'
+import { sources } from '../../sources.js'
 
 const PROVIDER_FILTER_COMMANDS = Object.entries(sources).map(([providerKey, source]) => {
   const label = source?.name || providerKey

package/src/{key-handler.js → tui/key-handler.js}

@@ -31,21 +31,21 @@
  * @exports { buildProviderModelsUrl, parseProviderModelIds, listProviderTestModels, classifyProviderTestOutcome, buildProviderTestDetail, createKeyHandler }
  */
 
-import { loadChangelog } from './changelog-loader.js'
-import { getToolMeta, isModelCompatibleWithTool, getCompatibleTools, findSimilarCompatibleModels } from './tool-metadata.js'
-import { loadConfig, saveConfig, replaceConfigContents, getApiKey } from './config.js'
-import { sources } from '../sources.js'
+import { loadChangelog } from '../core/changelog-loader.js'
+import { getToolMeta, isModelCompatibleWithTool, getCompatibleTools, findSimilarCompatibleModels } from '../core/tool-metadata.js'
+import { loadConfig, saveConfig, replaceConfigContents, getApiKey } from '../core/config.js'
+import { sources } from '../../sources.js'
 import { join, dirname } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { spawn } from 'node:child_process'
-import { cleanupLegacyProxyArtifacts } from './legacy-proxy-cleanup.js'
+import { cleanupLegacyProxyArtifacts } from '../core/legacy-proxy-cleanup.js'
 import { getLastLayout, COLUMN_SORT_MAP } from './render-table.js'
 import { cycleThemeSetting, detectActiveTheme } from './theme.js'
-import { syncShellEnv, ensureShellRcSource, removeShellEnv } from './shell-env.js'
+import { syncShellEnv, ensureShellRcSource, removeShellEnv } from '../core/shell-env.js'
 import { buildCommandPaletteTree, flattenCommandTree, filterCommandPaletteEntries } from './command-palette.js'
-import { WIDTH_WARNING_MIN_COLS, VERDICT_CYCLE, HEALTH_CYCLE } from './constants.js'
-import { scanAllToolConfigs, softDeleteModel } from './installed-models-manager.js'
-import { startExternalTool } from './tool-launchers.js'
+import { WIDTH_WARNING_MIN_COLS, VERDICT_CYCLE, HEALTH_CYCLE } from '../core/constants.js'
+import { scanAllToolConfigs, softDeleteModel } from '../core/installed-models-manager.js'
+import { startExternalTool } from '../core/tool-launchers.js'
 import {
   clearRouterDashboardRequestLog,
   closeRouterDashboardOverlay,
@@ -54,8 +54,8 @@ import {
   openRouterDashboardOverlay,
   restartRouterDashboardDaemon,
   toggleRouterDashboardProbePause,
-} from './router-dashboard.js'
-import { benchmarkModel } from './benchmark.js'
+} from '../core/router-dashboard.js'
+import { benchmarkModel } from '../core/benchmark.js'
 
 // 📖 Some providers need an explicit probe model because the first catalog entry
 // 📖 is not guaranteed to be accepted by their chat endpoint.

package/src/{overlays.js → tui/overlays.js}

@@ -19,9 +19,9 @@
  * @see ./key-handler.js — handles keypresses for all overlay interactions
  */
 
-import { loadChangelog } from './changelog-loader.js'
+import { loadChangelog } from '../core/changelog-loader.js'
 import { buildCliHelpLines } from './cli-help.js'
-import { renderRouterDashboard as renderRouterDashboardOverlay } from './router-dashboard.js'
+import { renderRouterDashboard as renderRouterDashboardOverlay } from '../core/router-dashboard.js'
 import { themeColors, getThemeStatusLabel, getProviderRgb } from './theme.js'
 
 export function createOverlayRenderers(state, deps) {

package/src/{render-helpers.js → tui/render-helpers.js}

@@ -47,8 +47,8 @@
  */
 
 import chalk from 'chalk'
-import { OVERLAY_PANEL_WIDTH, TABLE_FIXED_LINES, TABLE_HEADER_LINES, TABLE_FOOTER_LINES } from './constants.js'
-import { sortResults } from './utils.js'
+import { OVERLAY_PANEL_WIDTH, TABLE_FIXED_LINES, TABLE_HEADER_LINES, TABLE_FOOTER_LINES } from '../core/constants.js'
+import { sortResults } from '../core/utils.js'
 
 // 📖 stripAnsi: Remove ANSI color/control sequences to estimate visible text width before padding.
 // 📖 Strips CSI sequences (SGR colors) and OSC sequences (hyperlinks).

package/src/{render-table.js → tui/render-table.js}

@@ -34,7 +34,7 @@
 
 import chalk from 'chalk'
 import { createRequire } from 'module'
-import { sources } from '../sources.js'
+import { sources } from '../../sources.js'
 import {
   COL_MODEL,
   TIER_CYCLE,
@@ -44,19 +44,19 @@ import {
   WIDTH_WARNING_MIN_COLS,
   TABLE_FOOTER_LINES,
   FRAMES
-} from './constants.js'
+} from '../core/constants.js'
 import { themeColors, currentPalette, getProviderRgb, getTierRgb, getReadableTextRgb, getTheme } from './theme.js'
 import { TIER_COLOR } from './tier-colors.js'
-import { getAvg, getVerdict, getUptime, getStabilityScore, getVersionStatusInfo } from './utils.js'
-import { usagePlaceholderForProvider } from './ping.js'
-import { formatBenchmarkLatency, formatBenchmarkTps } from './benchmark.js'
+import { getAvg, getVerdict, getUptime, getStabilityScore, getVersionStatusInfo } from '../core/utils.js'
+import { usagePlaceholderForProvider } from '../core/ping.js'
+import { formatBenchmarkLatency, formatBenchmarkTps } from '../core/benchmark.js'
 import { calculateViewport, sortResultsWithPinnedFavorites, padEndDisplay, displayWidth, stripAnsi } from './render-helpers.js'
-import { getToolMeta, TOOL_METADATA, TOOL_MODE_ORDER, isModelCompatibleWithTool } from './tool-metadata.js'
+import { getToolMeta, TOOL_METADATA, TOOL_MODE_ORDER, isModelCompatibleWithTool } from '../core/tool-metadata.js'
 import { getColumnSpacing } from './ui-config.js'
-import { detectPackageManager, getManualInstallCmd } from './updater.js'
+import { detectPackageManager, getManualInstallCmd } from '../core/updater.js'
 
 const require = createRequire(import.meta.url)
-const { version: LOCAL_VERSION } = require('../package.json')
+const { version: LOCAL_VERSION } = require('../../package.json')
 
 // 📖 Mouse support: column boundary map updated every frame by renderTable().
 // 📖 Each entry maps a column name to its display X-start and X-end (1-based, inclusive).
@@ -412,7 +412,7 @@ export function renderTable({
   })
 
   const lines = [
-    `  ${themeColors.accentBold(`🚀 free-coding-models v${LOCAL_VERSION}`)}${modeBadge}${pingControlBadge}${tierBadge}${originBadge}${chalk.reset('')}   ` +
+    `  ${chalk.rgb(118, 185, 0).bgRgb(0, 0, 0).bold(' > ')}${chalk.rgb(118, 185, 0).bgRgb(0, 0, 0).bold('free')}${chalk.rgb(255, 255, 255).bgRgb(0, 0, 0).bold('-coding-models')}${chalk.rgb(118, 185, 0).bgRgb(0, 0, 0).bold('_ ')} ${themeColors.dim(`v${LOCAL_VERSION}`)}${modeBadge}${pingControlBadge}${tierBadge}${originBadge}${chalk.reset('')}   ` +
       themeColors.dim('📦 ') + themeColors.accentBold(`${completedPings}/${totalVisible}`) + themeColors.dim('  ') +
       themeColors.success(`✅ ${up}`) + themeColors.dim(' up  ') +
       themeColors.warning(`⏳ ${timeout}`) + themeColors.dim(' timeout  ') +

package/src/{tui-filters.js → tui/tui-filters.js}

@@ -26,9 +26,9 @@
  * @see src/tui-state.js — state shape for filter mode indices
  */
 
-import { TIER_CYCLE, VERDICT_CYCLE, HEALTH_CYCLE } from './constants.js'
-import { TIER_LETTER_MAP } from './utils.js'
-import { getVerdict } from './utils.js'
+import { TIER_CYCLE, VERDICT_CYCLE, HEALTH_CYCLE } from '../core/constants.js'
+import { TIER_LETTER_MAP } from '../core/utils.js'
+import { getVerdict } from '../core/utils.js'
 
 /**
  * 📖 createTuiFilters: Build the filter functions for a given TUI state + dependencies.

package/src/{tui-state.js → tui/tui-state.js}

@@ -24,7 +24,7 @@
  * @see src/ping-loop.js — reads ping mode fields from the state
  */
 
-import { WIDTH_WARNING_MIN_COLS } from './constants.js'
+import { WIDTH_WARNING_MIN_COLS } from '../core/constants.js'
 
 // 📖 Ping cadence intervals per mode (ms). Speed = startup burst, normal = steady,
 // 📖 slow = idle throttle, forced = user-triggered fast burst.

package/web/README.md

@@ -0,0 +1,46 @@
+# 📦 free-coding-models-web
+
+This directory contains the shared React SPA (Single Page Application) dashboard for `free-coding-models`.
+
+## 🌐 Architecture
+
+The frontend is a single SPA that is served in two distinct scenarios:
+1. **Web Dashboard / Docker Mode (`--daemon`):** Served directly by the local Node.js `router-daemon` process on `http://localhost:19280/`.
+2. **Desktop Mode (Tauri App):** Loaded locally inside Tauri's native webview from embedded assets in `web/dist/`, communicating via HTTP fetch to the background engine.
+
+To maintain maximum code sharing, **95%+ of all components and logic are kept completely identical** between the two distributions.
+
+---
+
+## ⚡ API & Event Integration
+
+The React app uses a realtime-first connection strategy against the local engine:
+* **Socket.IO** is preferred in dev/web-server mode for instant per-model ping and benchmark updates.
+* **`GET /api/events` / `EventSource`** is the streaming fallback used by daemon/Docker surfaces.
+* **`GET /api/state`** returns the wrapped live dashboard state for REST fallback polling.
+* **`GET /api/models`** remains the legacy flat model catalog endpoint for simple clients.
+* **`GET /api/config`** retrieves active provider toggles (keys are masked).
+* **`POST /api/settings`** updates API keys and provider preferences.
+* **`POST /api/global-benchmark`** benchmarks only the models currently visible in the web table, so filters/search control the benchmark scope.
+
+---
+
+## 🛠️ Development & Building
+
+### Prerequisites
+Make sure you have `pnpm` installed and dependencies initialized at the root of the project.
+
+### 1. Dev Server (HMR)
+To start the React frontend with Vite HMR (Hot Module Replacement):
+```bash
+cd web
+pnpm dev
+```
+By default, the dev server runs on `http://localhost:5173/`. Ensure a background daemon is running on port `19280` so the API requests proxy correctly.
+
+### 2. Production Build
+To compile the production-ready SPA:
+```bash
+pnpm build
+```
+This bundles the HTML, JS, and CSS assets into the `web/dist/` directory, which is then embedded inside both the CLI daemon and the Tauri desktop app binary.