cursor-route 0.1.15 → 0.1.16

package/CHANGELOG.md

@@ -4,6 +4,12 @@
 
 _(none)_
 
+## 0.1.16 — 2026-09-16
+
+- `--worker opencode --model free` now ranks the **strongest listed-free coding model** by capability tokens (ultra/pro/max > preview > generic > flash/lite), then coding-family, then `context_length`. No locked live winner id.
+- Ox Alpha (`opencode/x-preview-f-free`) is the offline / fetch-fail / empty-catalog **fallback only**, not a live pin. Pin `CURSOR_ROUTE_OPENCODE_MODEL` to freeze an id.
+- `hy3-free` is may-train (−20), not a coding-family boost. Contributor-free is penalized. Mid lane still `claude-ds`; no worker swap. Hero demo fixture regenerated to **0.1.16**.
+
 ## 0.1.15 — 2026-09-11
 
 - Mid default is `deepseek-flash` (DeepSeek V4.1 Flash, native vision). `--model pro` and `--model vision` are legacy aliases to the same id. Pro is off rotation.

package/README.md

@@ -29,7 +29,7 @@ If you already live in Cursor, X Premium (Grok CLI), and DeepSeek — stop payin
 | Grok CLI | X Premium | `--lane hard` implement |
 | DeepSeek via claude-ds | DeepSeek API / plan | `--lane mid` implement (**Flash** default; `--model vision` for screenshots; `--model pro` harder mid / hard backup only) |
 | OpenRouter free models | OpenRouter API (free tier) | `--lane easy` live free pick at start — non-secret prompts only (see Security) |
-| OpenCode (opt-in) | OpenCode Zen free models | `--worker opencode` implement on live Zen free pick (Ox Alpha while listed) |
+| OpenCode (opt-in) | OpenCode Zen free models | `--worker opencode` implement on live Zen free pick (strongest listed-free; no locked id) |
 | Codex / extra Claude | Optional | Not required for v0 |
 
 Exact dollars vary — the point is **reuse subscriptions you already have**.
@@ -116,10 +116,10 @@ docs/fixtures/generate-hero-demo.sh      # regenerate docs/fixtures/hero-demo.lo
 
 ```text
 $ cursor-route --version
-0.1.15
+0.1.16
 
 $ CURSOR_ROUTE_RELAXED=1 cursor-route health
-cursor-route v0.1.15
+cursor-route v0.1.16
 health: OK
 
 $ cursor-route start --lane mid --model flash --dry-run "Add a unit test for shellQuote"
@@ -243,9 +243,10 @@ key-shaped material in `start` / `send`, and the runner re-checks the prompt fil
 ## OpenCode setup (opt-in free coding worker)
 
 `--worker opencode` runs [OpenCode](https://opencode.ai) as a **coding agent** on
-live OpenCode Zen free models (`--model free` fetches the catalog and ranks,
-same idea as the OpenRouter free picker). Ox Alpha (`opencode/x-preview-f-free`)
-wins while it is listed and free. This is **not** a lane default — mid stays
+live OpenCode Zen free models (`--model free` fetches the catalog and ranks the
+strongest listed-free coding model, same idea as the OpenRouter free picker).
+There is no locked live id. Offline / empty-catalog fallback is
+`opencode/x-preview-f-free`. This is **not** a lane default — mid stays
 `claude-ds`; easy stays OpenRouter chat (no tools). Use it to burn fewer Grok /
 DeepSeek tokens on implement work.
 
@@ -271,7 +272,7 @@ for ~15 minutes (`CURSOR_ROUTE_ZEN_CACHE_MINUTES`).
 **Non-secret prompts:** several Zen free models may log or train on prompts during
 their free period (see [OpenCode Zen](https://opencode.ai/docs/zen/) privacy notes).
 The same refuse gate as every lane still applies. `opencode/x-preview-f-free`
-(Ox Alpha) is the zero-retention free option if you need it.
+(Ox Alpha) is the zero-retention **fallback** option if you need it.
 
 ## Jobs directory
 

package/SECURITY.md

@@ -15,7 +15,7 @@ Do **not** open a public issue for credential leaks or RCE-class bugs.
 
 1. **No secrets in prompts or job files.** Do not paste API keys, SSH private keys, Discord tokens, or `.env` contents into `cursor-route start` / `send` prompts.
 2. **Free OpenRouter easy-lane models may log prompts.** `--lane easy` / `--worker openrouter` is for **non-secret** wording/drafts only. The refuse gate (`start` / `send`, plus the runner's re-check) applies to every lane — never send key-shaped material to the easy lane.
-3. **OpenCode Zen free models may log or train during their free period.** `--worker opencode --model free` picks from the live Zen catalog (Ox Alpha / `x-preview-f-free` currently ranks first and is zero-retention). Treat other free Zen models like the easy lane for secrets. Pin `CURSOR_ROUTE_OPENCODE_MODEL` when you need a specific id.
+3. **OpenCode Zen free models may log or train during their free period.** `--worker opencode --model free` ranks the strongest listed-free coding model. Treat free Zen models like the easy lane for secrets. Pin `CURSOR_ROUTE_OPENCODE_MODEL` for a frozen id. Ox Alpha (`opencode/x-preview-f-free`) remains the zero-retention **fallback** option.
 4. **Always-approve is powerful.** Default headless workers skip interactive permission prompts (`--always-approve` / `--dangerously-skip-permissions` / OpenCode `--auto`). Opt out with `--ask` / `CURSOR_ROUTE_ASK=1` when you need HITL.
 5. **Install from known channels only.** Prefer `npm i -g cursor-route` or a git clone of this repo. Do not pipe unknown `curl | bash` installers as the primary path.
 6. **Workers inherit your auth.** Grok CLI, Claude Code / claude-ds, and OpenCode use *your* local login. Treat worker panes like you would treat your own shell.

package/dist/adapters/opencode.js

@@ -4,9 +4,9 @@ import { shellQuote } from "../util.js";
 import { openCodeModel, OPENCODE_DEFAULT_MODEL, cachedZenFreePick } from "../config.js";
 /**
  * Opt-in OpenCode worker (`opencode run`) — a coding agent on live OpenCode
- * Zen free models (`--model free` ranks the catalog; Ox Alpha wins while
- * listed). Not a lane default: mid stays claude-ds; easy stays OpenRouter
- * chat (no tools).
+ * Zen free models (`--model free` ranks the strongest listed-free coding
+ * model). Not a lane default: mid stays claude-ds; easy stays OpenRouter
+ * chat (no tools). Pin `CURSOR_ROUTE_OPENCODE_MODEL` to freeze an id.
  *
  * We never rewrite ~/.config/opencode/opencode.json (parallel jobs would
  * race). Always-approve maps to `opencode run --auto` (still honors explicit
@@ -42,7 +42,7 @@ export const opencodeAdapter = {
                 detail: "opencode not found — install: npm i -g opencode-ai (or brew install opencode). Then: opencode auth login. Mid default remains claude-ds.",
             };
         }
-        // Health stays offline: show a fresh cache hit, else the Ox Alpha fallback.
+        // Health stays offline: show a fresh cache hit, else the fallback id.
         const pick = cachedZenFreePick() || OPENCODE_DEFAULT_MODEL;
         return {
             worker: "opencode",

package/dist/config.js

@@ -79,7 +79,7 @@ function maxConcurrentJobsFromEnv() {
  */
 export const config = {
     product: "cursor-route",
-    version: "0.1.15",
+    version: "0.1.16",
     get jobsDir() {
         return defaultJobsDir();
     },

package/dist/zen-free.js

@@ -11,12 +11,15 @@ import { join } from "node:path";
  * `big-pickle` / `x-preview-f-free`; the CLI wants `opencode/<id>`.
  */
 export const ZEN_MODELS_URL_DEFAULT = "https://opencode.ai/zen/v1/models";
-/** Offline / fetch-fail fallback — Ox Alpha (zero-retention, currently top-tier free). */
+/** Offline / fetch-fail fallback only — not a live pin. */
 export const OPENCODE_DEFAULT_MODEL = "opencode/x-preview-f-free";
 const EXCLUDE_RE = /lyria|whisper|tts|embed|embedding|image|vision-only|audio|diffusion|flux|stable-diffusion|moderation/i;
-const CODING_RE = /coder|instruct|chat|laguna|nemotron|glm|qwen|kimi|deepseek|mimo|hy3|gpt-oss|north|gemma/i;
-const OX_ALPHA_RE = /x-preview|ox-alpha|oxalpha/i;
-const CONTRIBUTOR_RE = /contributor-free/i;
+const POWER_ULTRA_RE = /ultra|(^|[-/])opus($|[-/])|(^|[-/_])pro($|[-/])|(^|[-/])max($|[-/])|plus|(^|[-/])large($|[-/])/;
+const POWER_PREVIEW_RE = /x-preview|ox-alpha|oxalpha|(^|[-/])alpha($|[-/])|preview/;
+const POWER_FLASH_RE = /flash|lightning|lite|mini|nano|small|haiku|fin-/;
+const CODING_FAMILY_RE = /coder|code|instruct|laguna|glm|qwen|kimi|deepseek|gpt-oss|north|gemma|nemotron|mimo|muse/;
+const CONTRIBUTOR_RE = /contributor-free/;
+const MAY_TRAIN_RE = /(^|\/)big-pickle$|(^|\/)hy3-free$/;
 function zenModelsUrl() {
     return (process.env.CURSOR_ROUTE_ZEN_MODELS_URL || ZEN_MODELS_URL_DEFAULT).trim();
 }
@@ -65,20 +68,32 @@ export function isZenFreeModel(m) {
         /(^|\/)big-pickle$/i.test(id);
     return tagged || pricedFree;
 }
-/** Higher boost wins. Ox Alpha first while it is in the free catalog. */
+/**
+ * Higher boost wins. Generic capability tokens only — never a locked model id.
+ * Coding-family matches the model slug so the provider `opencode/` does not
+ * trip `code`.
+ */
 export function zenFreeBoost(id) {
     const s = id.toLowerCase();
-    if (OX_ALPHA_RE.test(s))
-        return 40;
+    const slug = s.includes("/") ? s.slice(s.lastIndexOf("/") + 1) : s;
+    let score = 0;
+    if (POWER_ULTRA_RE.test(s))
+        score += 50;
+    else if (POWER_PREVIEW_RE.test(s))
+        score += 42;
+    else if (POWER_FLASH_RE.test(s))
+        score += 15;
+    else
+        score += 30;
+    if (CODING_FAMILY_RE.test(slug))
+        score += 20;
+    else if (s.endsWith("-free") || s.endsWith(":free"))
+        score += 10;
     if (CONTRIBUTOR_RE.test(s))
-        return 1;
-    if (CODING_RE.test(s))
-        return 20;
-    if (s.endsWith("-free") || s.endsWith(":free"))
-        return 10;
-    if (/(^|\/)big-pickle$/.test(s))
-        return 5;
-    return 0;
+        score -= 25;
+    if (MAY_TRAIN_RE.test(s))
+        score -= 20;
+    return score;
 }
 export function rankZenFreeModels(models) {
     const out = [];

package/docs/briefs/WORKING.md

@@ -1,9 +1,9 @@
 ---
 title: cursor-route workspace — working brief (edit in place)
 repo: ~/Projects/cursor-route
-npm: cursor-route@0.1.15
+npm: cursor-route@0.1.16
 created: 2026-08-12
-updated: 2026-09-11
+updated: 2026-09-16
 ---
 
 # cursor-route — living brief
@@ -21,11 +21,11 @@ Cursor Agent plans. Workers run in tmux via `cursor-route`:
 | `easy` | OpenRouter free (live pick) | Wording / drafts — non-secret prompts only |
 | `mid` | claude-ds (DeepSeek behind Claude Code) | Default implement (**Flash** `deepseek-flash`; `--model vision` / `--model pro` are legacy aliases to the same id) |
 | `hard` | Grok CLI | Hard implement |
-| opt-in | OpenCode | `--worker opencode` coding agent; `--model free` ranks live Zen catalog (Ox Alpha first while listed) |
+| opt-in | OpenCode | `--worker opencode` coding agent; `--model free` ranks strongest listed-free Zen coding model (no locked id; offline fallback `opencode/x-preview-f-free`) |
 
 Always-approve on for coding worktrees (`--ask` / `CURSOR_ROUTE_ASK=1` to opt out) — not LIVE Discord/trading. Jobs live in `~/.local/share/cursor-route/jobs`, not in this clone.
 
-Install: `npm i -g cursor-route` → **0.1.15** (not LIVE until parent publishes). Release notes: [CHANGELOG.md](../../CHANGELOG.md).
+Install: `npm i -g cursor-route` → **0.1.16** (parent publishes). Release notes: [CHANGELOG.md](../../CHANGELOG.md).
 
 ## Open (edit / check off)
 
@@ -44,8 +44,9 @@ Install: `npm i -g cursor-route` → **0.1.15** (not LIVE until parent publishes
 - [x] **Flash-first + vision + live OpenRouter pick** — 0.1.12: `--model flash` stays the cheap Grok-out default; `--model vision` + screenshot auto-pick; easy lane live-picks free OpenRouter text models (`openrouter/free` is fetch-fail fallback only). Health never fetches `/models`. `route-orch` ProgRouter + MoRe one-liners. Hero fixture regenerated to 0.1.12. No npm publish in this slice.
 - [x] **Kimi 0.1.13 follow-up** — do not cache OpenRouter fallback; health labels uncached fallback; no Authorization on GET /models; env-invalid model error names the env vars; `\bimage\b` vision trigger.
 - [x] **Super-audit OR ranker parity (0.1.14)** — tier-rank Qwen/GLM/Kimi above Nemotron 550B in `or-free.ts` (match agent-toolkit `select-openrouter-free-model.ps1`); brief `docs/briefs/2026-09-02_super-audit-or-ranker-parity.md`
-- [x] **V4.1 Flash wire (0.1.15)** — mid default `deepseek-flash` (native vision). `--model pro` / `--model vision` are legacy aliases to the same id. Pro is off rotation. Mid still `claude-ds`. Hero fixture regenerated. npm not LIVE until parent publishes. Brief `docs/briefs/2026-09-11_v41-flash-not-pro.md`
+- [x] **V4.1 Flash wire (0.1.15)** — mid default `deepseek-flash` (native vision). `--model pro` / `--model vision` are legacy aliases to the same id. Pro is off rotation. Mid still `claude-ds`. Hero fixture regenerated. Brief `docs/briefs/2026-09-11_v41-flash-not-pro.md`
 - [ ] **Hero GIF** — still outstanding; dry-run fixture ships as the substitute for now (`docs/fixtures/hero-demo.log` — see `docs/DEMO_GIF.md`)
+- [x] **Zen strongest-free ranker (0.1.16)** — `zenFreeBoost` ports capability tokens (ultra/pro/max > preview > generic > flash/lite), then coding-family, then `context_length`. No locked live id. Ox Alpha is offline fallback only. SIP: `docs/briefs/2026-09-16_zen-strongest-free.md`. Mid still `claude-ds`.
 - [x] **Do not** paste private `ROUTE_KIT`, SIP, prod paths, or hang-watchdog env into this public repo
 
 ## Repo map
@@ -84,4 +85,6 @@ Install: `npm i -g cursor-route` → **0.1.15** (not LIVE until parent publishes
 | 2026-08-29 | Kimi audit follow-up → 0.1.13 LIVE on npm: no fallback cache, health labels, unauth GET /models, env error wording. |
 | 2026-09-02 | Tier-rank OpenRouter free picks in `or-free.ts` (Qwen 100 / GLM-Kimi 95 / DeepSeek 90 / coding 70 / Nemotron 15 / default 40; ctx bonus capped at 131072) → 0.1.14. Commit + tag `v0.1.14`. Mid stays claude-ds. |
 | 2026-09-02 | Kimi audit follow-up → ranker tests (seven tiers, score/id ties, 131072 cap, cache round-trip) then **0.1.14 LIVE** on npm. |
-| 2026-09-11 | Map mid models to `deepseek-flash` (V4.1 Flash, native vision). `--model pro` / `--model vision` are legacy aliases. Pro is off rotation. Mid still `claude-ds` → 0.1.15. |
+| 2026-09-11 | Map mid models to `deepseek-flash` (V4.1 Flash, native vision). `--model pro` / `--model vision` are legacy aliases. Pro is off rotation. Mid still `claude-ds` → **0.1.15 LIVE** on npm. |
+| 2026-09-16 | Pickup brief: `docs/briefs/2026-09-16_zen-strongest-free.md`. Port private `/route` Zen capability-token ranker so `--model free` picks strongest listed-free coding model. Target npm `0.1.16`. Open checkbox added. |
+| 2026-09-16 | Ship Zen strongest-free ranker → **0.1.16** (commit + tag; parent publishes npm). Ox Alpha is offline fallback only, not a live pin. Mid still `claude-ds`. |

package/docs/demo-notes.md

@@ -6,10 +6,10 @@ Simulated capture output for README / tweet assets — replace with a real GIF o
 
 ```
 $ cursor-route --version
-0.1.15
+0.1.16
 
 $ cursor-route health
-cursor-route v0.1.15
+cursor-route v0.1.16
 health: OK
   ✓ tmux
   ✓ runtime          bun ok

package/docs/fixtures/hero-demo.log

@@ -1,8 +1,8 @@
 $ cursor-route --version
-0.1.15
+0.1.16
 
 $ CURSOR_ROUTE_RELAXED=1 cursor-route health
-cursor-route v0.1.15
+cursor-route v0.1.16
 health: OK
 
   ✓ tmux             ok

package/llms.txt

@@ -2,13 +2,13 @@
 
 > Cursor stays the planner. DeepSeek (mid), Grok CLI (hard), and OpenRouter free models (easy) run parallel coding workers in tmux. `--worker opencode` is an opt-in coding agent on OpenCode Zen free models.
 
-MIT CLI + Cursor skill. npm: https://www.npmjs.com/package/cursor-route (latest **0.1.15**)
+MIT CLI + Cursor skill. npm: https://www.npmjs.com/package/cursor-route (latest **0.1.16**)
 GitHub: https://github.com/cemini23/cursor-route
 
 ## FAQ
 
 ### What is cursor-route?
-cursor-route is a public MIT CLI and Cursor skill that runs parallel coding workers in tmux while Cursor remains the planner. DeepSeek handles the mid lane, Grok CLI handles the hard lane, and OpenRouter free models handle the easy lane (wording/drafts, non-secret prompts only). `--worker opencode` is an opt-in coding agent (`--model free` ranks the live Zen catalog; Ox Alpha wins while listed) — not a lane default.
+cursor-route is a public MIT CLI and Cursor skill that runs parallel coding workers in tmux while Cursor remains the planner. DeepSeek handles the mid lane, Grok CLI handles the hard lane, and OpenRouter free models handle the easy lane (wording/drafts, non-secret prompts only). `--worker opencode` is an opt-in coding agent (`--model free` ranks the strongest listed-free Zen coding model; pin to freeze) — not a lane default.
 
 ### How is this different from Codex orchestrator?
 It uses the familiar strategist and worker-pane shape, but it is not a Codex clone. cursor-route uses Cursor as the planner and DeepSeek plus Grok CLI as workers. Codex is not required.
@@ -26,7 +26,7 @@ No. The mid worker is DeepSeek. Claude Code is the harness, configured with `ANT
 This map matches DeepSeek's 2026-09-10 API id `deepseek-flash`.
 
 ### How do I use OpenCode free models?
-Install OpenCode (`npm i -g opencode-ai`), run `opencode auth login`, then `cursor-route start --worker opencode "…"`. `--model free` ranks live Zen free models (Ox Alpha first while listed). Mid stays `claude-ds`.
+Install OpenCode (`npm i -g opencode-ai`), run `opencode auth login`, then `cursor-route start --worker opencode "…"`. `--model free` ranks the strongest listed-free Zen coding model (offline fallback `opencode/x-preview-f-free`). Mid stays `claude-ds`.
 
 ### How do I install?
 Run `npm i -g cursor-route`, install tmux if needed, then run `cursor-route health`. Copy the Cursor skill from `$(npm root -g)/cursor-route/skills/route-orch`. Source: https://github.com/cemini23/cursor-route

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cursor-route",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "description": "Cursor stays the brain. Grok CLI + DeepSeek (claude-ds) + OpenRouter easy lane + OpenCode (opt-in free) are the parallel army \u2014 lane-aware /route orchestration in tmux.",
   "type": "module",
   "license": "MIT",

package/skills/route-orch/SKILL.md

@@ -75,7 +75,7 @@ cursor-route start --worker opencode --model free --dir "$PWD" "…"
 cursor-route start --worker opencode --model opencode/hy3-free --dir "$PWD" "…"
 ```
 
-Health ✓ needs `opencode` on PATH (override `CURSOR_ROUTE_OPENCODE_BIN`). `--model free` / unset ranks the live OpenCode Zen catalog (Ox Alpha first while listed; pin with `CURSOR_ROUTE_OPENCODE_MODEL` or `--model provider/model`). Always-approve → `opencode run --auto`; `--ask` omits `--auto`. Never rewrites `~/.config/opencode/opencode.json`. Free Zen models may log/train — keep secrets off this worker (same refuse gate as easy). Ox Alpha (`opencode/x-preview-f-free`) is the zero-retention free option.
+Health ✓ needs `opencode` on PATH (override `CURSOR_ROUTE_OPENCODE_BIN`). `--model free` / unset ranks the strongest listed-free OpenCode Zen coding model (pin with `CURSOR_ROUTE_OPENCODE_MODEL` or `--model provider/model` to freeze). Always-approve → `opencode run --auto`; `--ask` omits `--auto`. Never rewrites `~/.config/opencode/opencode.json`. Free Zen models may log/train — keep secrets off this worker (same refuse gate as easy). Ox Alpha (`opencode/x-preview-f-free`) is the zero-retention fallback option.
 
 ## Workflow
 

package/src/adapters/opencode.test.ts

@@ -11,7 +11,7 @@ import {
 } from "../config.ts";
 
 describe("openCodeModel", () => {
-  test("defaults to live Zen pick (Ox Alpha fallback when offline)", () => {
+  test("defaults to live Zen pick (fallback id when offline)", () => {
     const prev = {
       model: process.env.CURSOR_ROUTE_OPENCODE_MODEL,
       offline: process.env.CURSOR_ROUTE_ZEN_OFFLINE,

package/src/adapters/opencode.ts

@@ -6,9 +6,9 @@ import { openCodeModel, OPENCODE_DEFAULT_MODEL, cachedZenFreePick } from "../con
 
 /**
  * Opt-in OpenCode worker (`opencode run`) — a coding agent on live OpenCode
- * Zen free models (`--model free` ranks the catalog; Ox Alpha wins while
- * listed). Not a lane default: mid stays claude-ds; easy stays OpenRouter
- * chat (no tools).
+ * Zen free models (`--model free` ranks the strongest listed-free coding
+ * model). Not a lane default: mid stays claude-ds; easy stays OpenRouter
+ * chat (no tools). Pin `CURSOR_ROUTE_OPENCODE_MODEL` to freeze an id.
  *
  * We never rewrite ~/.config/opencode/opencode.json (parallel jobs would
  * race). Always-approve maps to `opencode run --auto` (still honors explicit
@@ -47,7 +47,7 @@ export const opencodeAdapter: Adapter = {
           "opencode not found — install: npm i -g opencode-ai (or brew install opencode). Then: opencode auth login. Mid default remains claude-ds.",
       };
     }
-    // Health stays offline: show a fresh cache hit, else the Ox Alpha fallback.
+    // Health stays offline: show a fresh cache hit, else the fallback id.
     const pick = cachedZenFreePick() || OPENCODE_DEFAULT_MODEL;
     return {
       worker: "opencode",

package/src/cli.test.ts

@@ -935,7 +935,7 @@ describe("health", () => {
   test("returns structured report", () => {
     const r = runHealth();
     expect(r.product).toBe("cursor-route");
-    expect(r.version).toBe("0.1.15");
+    expect(r.version).toBe("0.1.16");
     expect(r.checks.length).toBeGreaterThan(3);
     expect(r.checks.some((c) => c.name === "tmux")).toBe(true);
     expect(r.checks.some((c) => c.name === "cursor_cli")).toBe(true);
@@ -947,8 +947,8 @@ describe("health", () => {
     expect(r.checks.some((c) => c.name === "worker:deepseek")).toBe(true);
   });
 
-  test("config version is 0.1.15", () => {
-    expect(config.version).toBe("0.1.15");
+  test("config version is 0.1.16", () => {
+    expect(config.version).toBe("0.1.16");
   });
 
   test("OR-gate: ok can be true while worker:opencode is false", () => {

package/src/config.ts

@@ -123,7 +123,7 @@ function maxConcurrentJobsFromEnv(): number {
  */
 export const config = {
   product: "cursor-route",
-  version: "0.1.15",
+  version: "0.1.16",
   get jobsDir(): string {
     return defaultJobsDir();
   },

package/src/zen-free.test.ts

@@ -38,30 +38,91 @@ describe("zen free catalog", () => {
     ).toBe(true);
   });
 
-  test("Ox Alpha outranks coding free, which outranks big-pickle and contributor", () => {
-    expect(zenFreeBoost("opencode/x-preview-f-free")).toBe(40);
-    expect(zenFreeBoost("opencode/laguna-s-2.1-free")).toBe(20);
+  test("capability tokens: ultra > preview > generic coding > flash > may-train", () => {
+    expect(zenFreeBoost("opencode/nemotron-3-ultra-free")).toBe(70);
+    expect(zenFreeBoost("opencode/x-preview-f-free")).toBe(52);
+    expect(zenFreeBoost("opencode/laguna-s-2.1-free")).toBe(50);
+    expect(zenFreeBoost("opencode/deepseek-v4-flash-free")).toBe(35);
+    expect(zenFreeBoost("opencode/muse-spark-1.2-contributor-free")).toBe(25);
     expect(zenFreeBoost("opencode/hy3-free")).toBe(20);
-    expect(zenFreeBoost("opencode/big-pickle")).toBe(5);
-    expect(zenFreeBoost("opencode/muse-spark-1.2-contributor-free")).toBe(1);
+    expect(zenFreeBoost("opencode/big-pickle")).toBe(10);
   });
 
-  test("rank: Ox Alpha first while listed; paid/whisper dropped", () => {
+  test("relative boosts: ultra > preview > flash > big-pickle", () => {
+    expect(zenFreeBoost("opencode/nemotron-3-ultra-free")).toBeGreaterThan(
+      zenFreeBoost("opencode/x-preview-f-free"),
+    );
+    expect(zenFreeBoost("opencode/x-preview-f-free")).toBeGreaterThan(
+      zenFreeBoost("opencode/deepseek-v4-flash-free"),
+    );
+    expect(zenFreeBoost("opencode/deepseek-v4-flash-free")).toBeGreaterThan(
+      zenFreeBoost("opencode/big-pickle"),
+    );
+  });
+
+  test("hy3-free is may-train, not coding-family", () => {
+    // else 30 + -free 10 − 20 may-train = 20. Coding-family would be 30.
+    expect(zenFreeBoost("opencode/hy3-free")).toBe(20);
+    expect(zenFreeBoost("opencode/hy3-free")).toBeLessThan(
+      zenFreeBoost("opencode/laguna-s-2.1-free"),
+    );
+  });
+
+  test("rank: paid/whisper dropped; preview may beat laguna (52 > 50)", () => {
     const ranked = rankZenFreeModels(CATALOG);
     expect(ranked[0]?.id).toBe("opencode/x-preview-f-free");
     expect(ranked.map((r) => r.id)).not.toContain("opencode/claude-opus-4-6");
     expect(ranked.map((r) => r.id)).not.toContain("opencode/whisper-free");
-    expect(ranked.at(-1)?.id).toBe("opencode/muse-spark-1.2-contributor-free");
+    expect(ranked.at(-1)?.id).toBe("opencode/big-pickle");
   });
 
-  test("rank without Ox: coding free beats big-pickle", () => {
+  test("rank without preview: coding free beats big-pickle", () => {
     const ranked = rankZenFreeModels([
       { id: "big-pickle" },
       { id: "laguna-s-2.1-free" },
       { id: "muse-spark-1.2-contributor-free" },
     ]);
     expect(ranked[0]?.id).toBe("opencode/laguna-s-2.1-free");
-    expect(ranked[1]?.id).toBe("opencode/big-pickle");
+    expect(ranked[1]?.id).toBe("opencode/muse-spark-1.2-contributor-free");
+    expect(ranked[2]?.id).toBe("opencode/big-pickle");
+  });
+
+  test("hy3 + preview + big-pickle → preview", () => {
+    expect(
+      pickZenFreeModel({
+        catalog: [{ id: "hy3-free" }, { id: "x-preview-f-free" }, { id: "big-pickle" }],
+      }),
+    ).toBe("opencode/x-preview-f-free");
+  });
+
+  test("hy3 + big-pickle + flash → flash coding", () => {
+    expect(
+      pickZenFreeModel({
+        catalog: [
+          { id: "hy3-free" },
+          { id: "big-pickle" },
+          { id: "deepseek-v4-flash-free" },
+        ],
+      }),
+    ).toBe("opencode/deepseek-v4-flash-free");
+  });
+
+  test("flash + ultra + preview → ultra", () => {
+    expect(
+      pickZenFreeModel({
+        catalog: [
+          { id: "deepseek-v4-flash-free" },
+          { id: "nemotron-3-ultra-free" },
+          { id: "x-preview-f-free" },
+        ],
+      }),
+    ).toBe("opencode/nemotron-3-ultra-free");
+  });
+
+  test("only big-pickle → big-pickle", () => {
+    expect(pickZenFreeModel({ catalog: [{ id: "big-pickle" }] })).toBe(
+      "opencode/big-pickle",
+    );
   });
 
   test("asOpenCodeZenId prefixes bare Zen ids", () => {
@@ -73,8 +134,11 @@ describe("zen free catalog", () => {
     expect(pickZenFreeModel({ catalog: CATALOG })).toBe("opencode/x-preview-f-free");
   });
 
-  test("offline / empty catalog falls back to Ox Alpha", () => {
+  test("offline / empty / paid-only catalog falls back to Ox Alpha", () => {
     expect(pickZenFreeModel({ catalog: [] })).toBe(OPENCODE_DEFAULT_MODEL);
+    expect(pickZenFreeModel({ catalog: [{ id: "claude-opus-4-6" }] })).toBe(
+      OPENCODE_DEFAULT_MODEL,
+    );
     expect(OPENCODE_DEFAULT_MODEL).toBe("opencode/x-preview-f-free");
   });
 });
@@ -119,10 +183,16 @@ describe("openCodeModel live pick", () => {
     });
   });
 
-  test("free + injected catalog → Ox Alpha", () => {
+  test("free + injected catalog → strongest listed-free (ultra)", () => {
     isolate(() => {
-      process.env.CURSOR_ROUTE_ZEN_CATALOG_JSON = JSON.stringify({ data: CATALOG });
-      expect(openCodeModel("free")).toBe("opencode/x-preview-f-free");
+      process.env.CURSOR_ROUTE_ZEN_CATALOG_JSON = JSON.stringify({
+        data: [
+          { id: "deepseek-v4-flash-free" },
+          { id: "nemotron-3-ultra-free" },
+          { id: "x-preview-f-free" },
+        ],
+      });
+      expect(openCodeModel("free")).toBe("opencode/nemotron-3-ultra-free");
     });
   });
 

package/src/zen-free.ts

@@ -14,7 +14,7 @@ import { join } from "node:path";
 
 export const ZEN_MODELS_URL_DEFAULT = "https://opencode.ai/zen/v1/models";
 
-/** Offline / fetch-fail fallback — Ox Alpha (zero-retention, currently top-tier free). */
+/** Offline / fetch-fail fallback only — not a live pin. */
 export const OPENCODE_DEFAULT_MODEL = "opencode/x-preview-f-free";
 
 export interface ZenModel {
@@ -36,10 +36,14 @@ export interface ZenFreePick {
 
 const EXCLUDE_RE =
   /lyria|whisper|tts|embed|embedding|image|vision-only|audio|diffusion|flux|stable-diffusion|moderation/i;
-const CODING_RE =
-  /coder|instruct|chat|laguna|nemotron|glm|qwen|kimi|deepseek|mimo|hy3|gpt-oss|north|gemma/i;
-const OX_ALPHA_RE = /x-preview|ox-alpha|oxalpha/i;
-const CONTRIBUTOR_RE = /contributor-free/i;
+const POWER_ULTRA_RE =
+  /ultra|(^|[-/])opus($|[-/])|(^|[-/_])pro($|[-/])|(^|[-/])max($|[-/])|plus|(^|[-/])large($|[-/])/;
+const POWER_PREVIEW_RE = /x-preview|ox-alpha|oxalpha|(^|[-/])alpha($|[-/])|preview/;
+const POWER_FLASH_RE = /flash|lightning|lite|mini|nano|small|haiku|fin-/;
+const CODING_FAMILY_RE =
+  /coder|code|instruct|laguna|glm|qwen|kimi|deepseek|gpt-oss|north|gemma|nemotron|mimo|muse/;
+const CONTRIBUTOR_RE = /contributor-free/;
+const MAY_TRAIN_RE = /(^|\/)big-pickle$|(^|\/)hy3-free$/;
 
 function zenModelsUrl(): string {
   return (process.env.CURSOR_ROUTE_ZEN_MODELS_URL || ZEN_MODELS_URL_DEFAULT).trim();
@@ -94,15 +98,28 @@ export function isZenFreeModel(m: ZenModel): boolean {
   return tagged || pricedFree;
 }
 
-/** Higher boost wins. Ox Alpha first while it is in the free catalog. */
+/**
+ * Higher boost wins. Generic capability tokens only — never a locked model id.
+ * Coding-family matches the model slug so the provider `opencode/` does not
+ * trip `code`.
+ */
 export function zenFreeBoost(id: string): number {
   const s = id.toLowerCase();
-  if (OX_ALPHA_RE.test(s)) return 40;
-  if (CONTRIBUTOR_RE.test(s)) return 1;
-  if (CODING_RE.test(s)) return 20;
-  if (s.endsWith("-free") || s.endsWith(":free")) return 10;
-  if (/(^|\/)big-pickle$/.test(s)) return 5;
-  return 0;
+  const slug = s.includes("/") ? s.slice(s.lastIndexOf("/") + 1) : s;
+  let score = 0;
+
+  if (POWER_ULTRA_RE.test(s)) score += 50;
+  else if (POWER_PREVIEW_RE.test(s)) score += 42;
+  else if (POWER_FLASH_RE.test(s)) score += 15;
+  else score += 30;
+
+  if (CODING_FAMILY_RE.test(slug)) score += 20;
+  else if (s.endsWith("-free") || s.endsWith(":free")) score += 10;
+
+  if (CONTRIBUTOR_RE.test(s)) score -= 25;
+  if (MAY_TRAIN_RE.test(s)) score -= 20;
+
+  return score;
 }
 
 export function rankZenFreeModels(models: ZenModel[]): Array<{