free-coding-models 0.5.6 → 0.5.9

package/README.md

@@ -155,7 +155,7 @@ free-coding-models web
 
 This starts the realtime Web Dashboard locally, opens it in your browser, and uses `http://localhost:3333/` by default. Override the port with `FCM_WEB_PORT=3334 free-coding-models web`.
 
-#### Web Dashboard features (M1 parity with TUI)
+#### Web Dashboard features (M4 parity with TUI)
 
 The local Web Dashboard is a real-time control center for the model catalog
 — not just a static table. The header holds every navigation entry, the
@@ -164,24 +164,29 @@ and every TUI capability that's safe to port ships behind a button or chip.
 
 | Area | What's there |
 |---|---|
-| **Header** | Logo + version · primary nav (Dashboard, Settings, Analytics, Recommend, Router) · kebab menu (Help, Changelog, Install Endpoints, Installed Models) · `⌘K` command palette · AI Latency · theme · export |
-| **Model table** | Full-bleed (no left/right border, no margin) under the sticky header + filter bar · 16 columns, resizable widths persisted in localStorage, ⭐ star per row, medal borders for top-3, dark-red row class for tool-incompatible models, click AI Lat. cell to run a per-row benchmark · table header row stays sticky while scrolling |
+| **Header** | Logo + version · primary nav (Dashboard, Settings, Analytics, Recommend, Router) · kebab menu (Help, Changelog, Install Endpoints, Installed Models) · endpoint target picker · `⌘K` command palette · AI Latency · theme · export |
+| **Model table** | Full-bleed (no left/right border, no margin) under the sticky header + filter bar · 17 columns, resizable widths persisted in localStorage, ⭐ star per row, 🔌 install-endpoint button per row, medal borders for top-3, dark-red row class for tool-incompatible models, click AI Lat. cell to run a per-row benchmark · table header row stays sticky while scrolling |
 | **Filter bar** | Sticky right below the header (always visible) · Tier / Status / Verdict / Health chip rows · Visibility dropdown (Normal / Configured only / Usable only) · Provider select · custom text filter chip with `X` clear · Reset button (TUI `N`) · ping mode (Speed / Normal / Slow / Forced) · "next ping in Xs" countdown (TUI style, always shown) |
 | **Stats bar** | Removed in M1 (users found it noisy; the table + chips carry the same info at a glance) |
-| **Detail panel** | Slide-in from the right on row click · per-row benchmark button (TUI `Ctrl+A`) · favorite toggle (TUI `F`) + up/down reorder (TUI `Shift+↑↓`) · latency trend chart · all stats |
+| **Detail panel** | Slide-in from the right on row click · endpoint target indicator + install-endpoint button · per-row benchmark button (TUI `Ctrl+A`) · favorite toggle (TUI `F`) + up/down reorder (TUI `Shift+↑↓`) · latency trend chart · all stats |
 | **Command palette** | `⌘K` / `Ctrl+P` (the only global keyboard shortcut) · fuzzy search across views, theme, ping mode, reset, export, **and the full TUI command registry** (every filter / sort / tool / page entry from `src/tui/command-palette.js`) |
 | **Keyboard** | `Esc` closes any modal · `Cmd+K` toggles the palette — that's it. Everything else is mouse-first. |
-| **URL deep-linking** | `?tier=S+&sort=verdict&origin=groq&view=dashboard&q=…` hydrates the dashboard on load **and** every filter / sort / view change is reflected back in the URL (debounced 80ms, `history.replaceState`). CLI flags become shareable links. |
+| **URL deep-linking** | `?tier=S+&sort=verdict&origin=groq&toolMode=goose&q=…` hydrates the dashboard on load **and** every filter / sort / view / endpoint target change is reflected back in the URL (debounced 80ms, `history.replaceState`). CLI flags become shareable links. |
 | **Favorites** | Shared with the TUI through `~/.free-coding-models.json` — a star in the Web is a star in the TUI. Includes pinned+sticky display mode (TUI `Y`). |
 | **Help modal** | Header overflow menu → "Help" opens a full-screen modal with all the TUI's keyboard shortcuts, filter behavior, and parity notes. Live search bar. |
 | **Changelog modal** | Header overflow menu → "Changelog" or Settings "Open Changelog" link. Two-phase (index of versions + per-version release notes). Deep-linkable to a specific version. |
 | **Update flow** | Header `⬆ vX.Y.Z` chip + popover with "Update now" + "What's new" (jumps to the new version's changelog entry). Polls every 5 min. |
 | **Settings parity** | Full Settings page: theme (auto/dark/light), favorites pinned mode, startup AI Speed Scan, shell env export, legacy proxy cleanup, per-provider **Test** key button (TUI `T` key), update row. All settings persisted to the same `~/.free-coding-models.json` the TUI uses. |
 | **Theme** | Tri-state `auto / dark / light` cycle (TUI `G`) — auto follows the OS preference. |
-
-Roadmap items (header menu badges show "M3 / M4" until they land):
-- **M3** — Smart Recommend (3-question wizard → 10s analysis → Top 3), tool mode picker, per-row Launch, missing-tool install prompt, incompatible-fallback modal.
-- **M4** — Router Dashboard, Token Usage, Install Endpoints wizard, Installed Models manager.
+| **Smart Recommend** | Header "Recommend" opens the 3-question wizard, runs the 10s analysis phase, then returns the Top 3 shared-score recommendations with Pin + install-endpoint actions. |
+| **Endpoint installs** | The Web never starts external tools. It writes the selected provider/model endpoint into the chosen tool config (`/api/install-endpoint`), then users start their tool themselves. |
+| **Router Dashboard** | Header "Router" opens a full modal with daemon start/stop, model health table with circuit breaker badges, request log, probe mode selector, and quick-setup card (copy base URL + model to clipboard). |
+| **Token Usage** | Integrated inside Analytics: today + all-time summary cards, 7-day usage bar chart, top models and top providers breakdown. |
+| **Installed Models** | Header overflow → "Installed Models" opens a modal that scans all tool configs (Goose, Crush, Aider, Kilo, Qwen, Pi, OpenHands, Amp) and shows configured models with soft-delete (backup saved). |
+| **Install Endpoints wizard** | Header overflow → "Install Endpoints" opens a 4-step wizard: pick provider → pick tool → select models → install. Writes managed provider catalogs into tool configs using the same engine as the TUI. |
+
+Roadmap items:
+- **M5** — Polish, accessibility, mobile hamburger nav, Lighthouse a11y ≥ 95.
 
 ### Available Image Tags
 

package/changelog/v0.5.7.md

@@ -0,0 +1,20 @@
+# Changelog v0.5.7 - 2026-06-02
+
+### Added
+- **Router Dashboard** (M4) — Full TUI-parity modal for the smart model router daemon. Shows running status, port, uptime, start/stop controls, model health table with circuit breaker badges (CLOSED / OPEN / HALF_OPEN / AUTH_ERROR), request log with failover indicators, probe mode selector (eco / balanced / aggressive), and quick-setup card for one-click clipboard copy of base URL + model.
+- **Token Usage** (M4) — New panel inside Analytics view. Shows today + all-time token summary cards, 7-day bar chart, top models, and top providers breakdown. Reads from the same `~/.free-coding-models-tokens.json` file the daemon writes.
+- **Installed Models** (M4) — New modal accessible from the header overflow menu. Scans all 8 supported tool configs (Goose, Crush, Aider, Kilo, Qwen, Pi, OpenHands, Amp) and shows installed models grouped by tool. Soft-delete button per model saves a backup to `~/.free-coding-models-backups.json`.
+- **Install Endpoints Wizard** (M4) — New 4-step modal: (1) pick provider, (2) pick target tool, (3) select all or specific models, (4) install. Uses the same `installProviderEndpoints` engine from `src/core/endpoint-installer.js` that powers the TUI's install flow.
+- **15 new server endpoints** for the above features: `/api/router/status`, `/api/router/stats`, `/api/router/tokens`, `/api/router/start`, `/api/router/stop`, `/api/router/sets`, `/api/router/probe-mode`, `/api/router/quick-setup`, `/api/installed-models`, `/api/installed-models/:tool/:model/disable`, `/api/install-endpoints/providers`, `/api/install-endpoints/catalog`, `/api/install-endpoints/wizard`.
+- **Mobile hamburger nav** (M5) — At viewports under 768px, the header nav buttons hide and a hamburger menu appears. Tapping it opens a full-width dropdown with all nav and overflow items. Never a left sidebar.
+- **Global `:focus-visible` outlines** (M5) — Keyboard users now see a visible focus ring on all interactive elements. Mouse clicks don't trigger the ring. Improves accessibility for keyboard-only navigation.
+- **`aria-label` audit** (M5) — All header buttons now have descriptive `aria-label` attributes for screen readers.
+
+### Changed
+- Header overflow menu items (Install Endpoints, Installed Models, Router) no longer show "M4" coming-soon badges — they're live.
+- Router nav button is now a real working navigation target instead of a placeholder toast.
+- README updated from "M3 parity" to "M4 parity" with all new features documented.
+- 11 new tests for M4 endpoints, hooks, and component wiring (474 total, up from 463).
+
+### Fixed
+- Header overflow menu now also closes on Esc when the mobile nav is open.

package/changelog/v0.5.8.md

@@ -0,0 +1,23 @@
+# Changelog v0.5.8 - 2026-06-02
+
+### Added
+- **Lighthouse Accessibility score: 96** (target ≥ 95). Web Dashboard passes comprehensive a11y audit.
+- **Global `:focus-visible` outlines** — All interactive elements show a visible focus ring for keyboard users. Mouse clicks don't trigger the ring.
+- **Mobile hamburger navigation** — At viewports ≤ 768px, primary nav buttons collapse into a hamburger menu that opens a full-width dropdown. Never a left sidebar.
+- **`aria-label` audit** — All header buttons (benchmark, theme, export, command palette, kebab menu) now have descriptive `aria-label` attributes for screen readers.
+- **`<main>` landmark** — Dashboard view now uses a `<main>` element for proper HTML5 document structure.
+- **Select element labels** — Visibility and Provider `<select>` elements now have `htmlFor`/`id` linkage and `aria-label` attributes.
+
+### Changed
+- **Color contrast improvements** — Version badge uses `--color-text-muted` instead of `--color-text-dim`. Model ID text in the table uses `--color-text-muted`. Dark-theme B+/B/C tier badge colors brightened for WCAG compliance.
+- **Benchmark button `aria-label`** matches visible text to avoid label-content-name-mismatch.
+- **Header overflow menu** closes on Esc when mobile nav is open.
+- **README** updated from "M3 parity" to "M4 parity" with Router Dashboard, Token Usage, Installed Models, and Install Endpoints documented. M5 roadmap listed.
+- **Changelog** — `changelog/v0.5.7.md` updated to cover both M4 and M5 changes.
+- **Plan tracker** — `ideas/tui-web-feature-parity.md` updated: all 5 milestones marked DONE.
+
+### Fixed
+- Lighthouse `landmark-one-main` — Added `<main>` element.
+- Lighthouse `select-name` — Linked labels to selects via `htmlFor`/`id`.
+- Lighthouse `label-content-name-mismatch` — Fixed benchmark button accessible name.
+- Lighthouse `color-contrast` — Brightened low-contrast text in version badge, model IDs, and tier badges.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-coding-models",
-  "version": "0.5.6",
+  "version": "0.5.9",
   "description": "Find the fastest coding LLM models in seconds — ping free models from multiple providers, pick the best one for OpenCode, Cursor, or any AI coding assistant.",
   "keywords": [
     "nvidia",

package/src/core/endpoint-installer.js

@@ -53,8 +53,8 @@ import { getToolMeta } from './tool-metadata.js'
 // 📖 zai and opencode-zen ARE OpenAI-compatible and CAN be installed into any tool.
 const DIRECT_INSTALL_UNSUPPORTED_PROVIDERS = new Set(['replicate', 'rovo', 'gemini'])
 // 📖 Install Endpoints only lists tools whose persisted config shape is actually supported here.
-// 📖 Claude Code, Codex, and Gemini stay out while their dedicated bridges are being rebuilt.
-const INSTALL_TARGET_MODES = ['opencode', 'opencode-desktop', 'opencode-web', 'openclaw', 'kilo', 'crush', 'goose', 'pi', 'aider', 'qwen', 'openhands', 'amp', 'hermes', 'continue', 'cline', 'forgecode', 'fcm_router']
+// 📖 Launch-only tools stay out: the Web dashboard configures endpoints, it never starts CLIs.
+const INSTALL_TARGET_MODES = ['opencode', 'opencode-desktop', 'opencode-web', 'openclaw', 'crush', 'goose', 'pi', 'aider', 'qwen', 'openhands', 'amp', 'forgecode', 'fcm_router']
 
 function getDefaultPaths() {
   const home = homedir()
@@ -131,7 +131,7 @@ function writeSimpleYamlMap(filePath, entries) {
 }
 
 function canonicalizeToolMode(toolMode) {
-  return toolMode === 'opencode-desktop' ? 'opencode' : toolMode
+  return toolMode === 'opencode-desktop' || toolMode === 'opencode-web' ? 'opencode' : toolMode
 }
 
 function getManagedProviderId(providerKey) {

package/src/core/tool-launchers.js

@@ -1094,13 +1094,13 @@ export async function startExternalTool(mode, model, config) {
   }
 
   if (mode === 'xcode') {
-    const xcodeUrl = baseUrl ? baseUrl.replace(/\/v1$/, '').replace(/\/v1\/chat\/completions$/, '') : ''
+    const xcodeUrl = launchPlan.baseUrl ? launchPlan.baseUrl.replace(/\/v1$/, '').replace(/\/v1\/chat\/completions$/, '') : ''
     console.log(chalk.bold.cyan('\n  🛠️  Xcode Intelligence Setup Instructions:'))
     console.log(chalk.white('  1. Open Xcode and go to ') + chalk.bold('Xcode > Settings > Intelligence'))
     console.log(chalk.white('  2. Click ') + chalk.bold('Add a Chat Provider') + chalk.white(' and select ') + chalk.bold('Internet Hosted'))
     console.log(chalk.white('  3. Enter the following details:'))
     console.log(chalk.dim('     URL: ') + chalk.green(xcodeUrl))
-    console.log(chalk.dim('     API Key: ') + chalk.green(apiKey || '<your_api_key>'))
+    console.log(chalk.dim('     API Key: ') + chalk.green(launchPlan.apiKey || '<your_api_key>'))
     console.log(chalk.dim('     API Key Header: ') + chalk.green('Authorization') + chalk.dim(' (or x-api-key)'))
     console.log(chalk.dim('     Description: ') + chalk.green(`FCM - ${sources[model.providerKey]?.name || model.providerKey}`))
     console.log(chalk.white(`  4. Click Add, then select `) + chalk.bold(model.modelId) + chalk.white(` from the list.\n`))