free-coding-models 0.4.2 → 0.5.0

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).

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,43 @@
+# 📦 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 relies on HTTP and Server-Sent Events (SSE) to talk to the engine:
+* `GET /api/models`: Fetches the live model catalog, complete with stability scores and latency details.
+* `GET /api/config`: Retrieves active provider toggles (keys are masked).
+* `POST /api/settings`: Updates API keys and provider preferences.
+* `GET /api/events` / `EventSource`: Listens for real-time SSE updates broadcasted by the ping and benchmark loops.
+
+---
+
+## 🛠️ 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.