free-coding-models 0.5.65 → 0.5.66

package/changelog/v0.5.66.md

@@ -0,0 +1,55 @@
+# Changelog v0.5.66 - 2026-07-29
+
+### Added
+
+- 📚 **Project-wide documentation overhaul** — The README, the `docs/` repo, and the marketing site (`website/`) were rewritten end-to-end by a pro doc pass. ~2,000 insertions / ~1,600 deletions across **29 files**. Public behaviour is unchanged; this is a content-only release.
+
+- **Reordered README around the product priority** — TUI → Web → Agent Extensions → Smart Model Router (last). The router and the extensions moved out of the middle of the doc and into dedicated sections at the end, so the TUI and the Web Dashboard (the two core surfaces) are now the centerpiece of the reading flow.
+
+- **Expanded Quick Start** — grew from a 3-step outline to a 6-step user-centric walkthrough (Install → Grab a key → Launch & paste → Pick & launch → The 30-second cool tour → Go further). Each step links to the relevant deep section. Includes a `headless` sidebar (`--json`, `--fiable`) and a `pre-target a tool from the command line` example block.
+
+- **🟢 Free AI Providers** — kept the 20-provider table near the top, but now sits after Quick Start with a clean `⚠️ Health checks consume provider quota` note and a collapsible `🧹 Providers removed from the catalog` details block.
+
+- **🎛️ TUI section** — now opens with a `First-run flow` (3 steps), then 7 user-framed workflows (`"Give me the fastest model that actually works"`, `"Pick a model & launch"`, `"Benchmark before I commit"`, `"Smart Recommend"`, `"Keep my go-to models pinned"`, `"Switch tools without restarting"`, `"My terminal theme fights the TUI colors"`), followed by the complete keyboard reference and a mouse reference.
+
+- **🌐 Web Dashboard** — feature table condensed, `web` (port 3333) vs `--daemon` (port 19280) port distinction made explicit, Docker quick-start + image tags + env vars + compose + troubleshooting all in one place.
+
+- **🔌 19 per-tool integration pages** — replaced the previous 3 generic integration pages (`opencode`, `pi-extension`, `openclaw`) with a dedicated page for every supported target: OpenCode, Pi, OpenClaw, Crush, Goose, Aider, Kilo, Hermes, Continue, Cline, Amp, Qwen Code, ForgeCode, ZCode, jcode, Caveman Code, Copilot CLI, OpenHands, Xcode Intelligence. Each page documents the launch flag, the exact config file FCM writes (path + JSON example verified against `src/core/tool-launchers.js`), the install/bootstrap behaviour, and (for OpenCode + Pi) the in-agent plugin commands.
+
+- **OpenCode + Pi merged into one page per tool** — `integrations/opencode.mdx` and `integrations/pi.mdx` each combine the FCM launch flow (CLI flag, config, install) with the in-agent plugin (`/fcm` commands, progress display, architecture). The old `pi-extension` slug redirects to `pi` so any external link still resolves.
+
+- **📖 5 video wrappers added across the docs and the landing** — `<Video name="…" />` placeholders for the 5 planned screen recordings (`tui-first-launch`, `tui-pick-and-launch`, `tui-speed-test`, `web-url-deep-linking`, `router-playground`). On the doc pages a `<Callout>` immediately below each wrapper contains the recording script (shot list, export spec, file location) and a `{/* AGENT TODO: … */}` comment that tells the next agent exactly which block to delete once the `.mp4` is committed. On the landing page the wrappers are bare — no Callout, because the landing is public.
+
+- **🧠 Persistent site component changes** — a new `<Video />` component (`website/src/components/Video.tsx`) renders an autoplay / muted / loop / playsinline `<video>` in a styled figure. The Markdown renderer now wraps every MDX `<table>` in a `.table-scroll` container so wide tables scroll *inside* the page instead of pushing the viewport wider, and the first column gets a `min-width: 8rem` so label columns (e.g. the "Area" column in the Web Dashboard features table) stay readable. The "On this page" right-side table-of-contents was removed from every docs page; the content was already in flow and the column was redundant.
+
+- **Sidebar "View more" toggle on long nav groups** — `Agent Integrations` now lists the 9 most-used tools in the user's preferred order (OpenCode, Pi, Hermes, OpenClaw, Qwen Code, Cline, Goose, Kilo, jcode) and hides the remaining 10 behind a "+ View 10 more…" toggle that expands to "- View less". The active page is always shown even when the group is collapsed, so you never lose your place in the nav.
+
+- **Repository docs cleaned up** — `docs/config.md` no longer lists the deprecated providers that were removed from the active catalog (huggingface, replicate, deepinfra, siliconflow, together, perplexity); the env-var table is now aligned with the 20 active providers. `docs/development.md` is updated from the stale `160 models across 20 providers` figure to the real `222 models`, and the file-path table is rewritten from the obsolete `src/*.js` layout to the current `src/core/`, `src/tui/`, `src/data/` structure. `docs/integrations.md` now lists **19 tools + the FCM router** in the tool → config mapping.
+
+- **Marketing site MDX content realigned** — the entire `website/src/content/docs/` tree was rewritten to match the README. Architectural inaccuracies (e.g. `Gemini CLI` referenced as a provider, fabricated REST endpoints like `/api/best`, half-true circuit-breaker states) were corrected against the source code and the README. The `cli-tui.mdx` keybinding table was rebuilt from the README so it is now 100% accurate (fixing the historical bugs where `N` was mislabelled as "Sort by Context" and `Y` was mislabelled as "Sort by Tier"). The docs nav sidebar was reordered so the surfaces (TUI, Web, Docker) come first, the agent integrations follow, and the Smart Router is the last item in "Core concepts & advanced" — matching the README's reading order.
+
+- **Landing-page video integration** — the static `LogoMark` + `MorphingText` content in the Hero card was replaced with the `<Video name="tui-first-launch">` wrapper so the first thing a visitor sees becomes a live demo as soon as the recording lands. The router demo is embedded in the FailoverSection, and the remaining three demos live in a new "See it live" grid at the bottom of the SurfacesSection.
+
+### Changed
+
+- **README "double title" bug** — every docs page used to render the title twice (once in the route header, once in the leading `# Title` of the MDX body). All 18 MDX files had their leading `# <Title>` line removed; the route header is now the single source of truth for the page title.
+- **Markdown renderer table overflow** — the previous `.prose table { white-space: nowrap }` rule forced every cell onto a single line, which exploded the page width whenever a cell contained a long description (e.g. the "Highlights" column in the Web Dashboard features table). Tables now wrap their content (`overflow-wrap: anywhere`) and live inside a horizontal-scroll wrapper as a fallback so even pathological tables scroll *inside* the page instead of stretching the viewport.
+- **`README.md` now contains 5 video references** — the same 5 recordings are available on the landing and the docs; all three surfaces reference the same files in `website/public/videos/`. Mutualised, no duplication.
+- **Removed `pi-extension.mdx`** — superseded by the merged `integrations/pi.mdx`. A redirect from the old slug lives in `docs/$.tsx` so any external link still resolves.
+
+### Migration / workaround
+
+> **No code or behaviour changes.** This release is documentation-only. No new flags, no new endpoints, no breaking changes. Upgrade is safe and invisible to runtime users.
+>
+> **The 5 videos are not yet recorded.** The wrappers currently render empty `<video>` frames everywhere. Drop the recorded `.mp4` files at `website/public/videos/<name>.mp4` and the surrounding `<Callout>` recording scripts in the docs remove themselves via the `{/* AGENT TODO: … */}` comment the next time an agent touches them. Public behaviour is unchanged.
+
+### Files
+
+- **Modified**: `README.md` (full rewrite, ~1,000 lines), `docs/config.md`, `docs/development.md`, `docs/integrations.md`, 16 docs MDX files under `website/src/content/docs/`, `website/src/components/MdxComponents.tsx` (registers `Video`, `table`), `website/src/components/DocsSidebar.tsx` (refactored with `NavGroup` + `View more` toggle), `website/src/routes/index.tsx` (landing videos + import cleanup), `website/src/routes/docs/$.tsx` (TOC removed, `pi-extension` redirect), `website/src/styles.css` (table wrapping + scroll wrapper, `.table-scroll` activated), `website/src/content/nav.ts` (reordered + `primaryCount`), `package.json` (`0.5.65` → `0.5.66`), this changelog.
+- **New**: `website/src/components/Video.tsx` (~35 lines).
+- **New folder**: `website/public/videos/` (target for the 5 upcoming recordings).
+- **Deleted**: `website/src/content/docs/integrations/pi-extension.mdx` (replaced by `integrations/pi.mdx`; redirect handles old links).
+
+### Breaking changes
+
+None. This is a documentation-only release. No CLI flags added, no flags removed, no endpoints changed, no behaviour changed.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "free-coding-models",
-  "version": "0.5.65",
-  "description": "Find the fastest coding LLM models in seconds \u2014 ping free models from multiple providers, pick the best one for OpenCode, Cursor, or any AI coding assistant.",
+  "version": "0.5.66",
+  "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",
     "nim",
@@ -89,4 +89,4 @@
     "vite": "^8.0.16",
     "vite-plus": "^0.2.6"
   }
-}
+}