cursor-route 0.1.6 → 0.1.8

package/dist/config.js

@@ -8,17 +8,39 @@ export const DS_MODEL_IDS = {
     flash: "deepseek-v4-flash",
     pro: "deepseek-v4-pro",
 };
-/** Resolve --model flash|pro (or full deepseek-v4-* id) to a CLI alias. Default: flash. */
-export function resolveDsModelAlias(raw) {
-    if (!raw || !raw.trim())
-        return "flash";
+/**
+ * Resolve --model / env to alias + concrete model id.
+ * Preserves `deepseek-v4-pro[1m]` (does not silently strip the SKU).
+ * Empty → Flash.
+ */
+export function resolveDsModel(raw) {
+    if (!raw || !raw.trim()) {
+        return { alias: "flash", id: DS_MODEL_IDS.flash };
+    }
     const v = raw.trim().toLowerCase();
-    if (v === "flash" || v === "deepseek-v4-flash")
-        return "flash";
-    if (v === "pro" || v === "deepseek-v4-pro" || v === "deepseek-v4-pro[1m]")
-        return "pro";
+    if (v === "flash" || v === "deepseek-v4-flash") {
+        return { alias: "flash", id: DS_MODEL_IDS.flash };
+    }
+    if (v === "pro" || v === "deepseek-v4-pro") {
+        return { alias: "pro", id: DS_MODEL_IDS.pro };
+    }
+    if (v === "deepseek-v4-pro[1m]") {
+        return { alias: "pro", id: "deepseek-v4-pro[1m]" };
+    }
     throw new Error(`Invalid --model ${raw}; expected flash|pro`);
 }
+/** Alias-only helper (tests / callers that do not need the concrete id). */
+export function resolveDsModelAlias(raw) {
+    return resolveDsModel(raw).alias;
+}
+/**
+ * Mid default from env: CURSOR_ROUTE_DS_MODEL, else ANTHROPIC_MODEL, else flash.
+ * Throws if the env value is set but invalid (fail loud on start).
+ */
+export function defaultDsModelFromEnv() {
+    const raw = process.env.CURSOR_ROUTE_DS_MODEL || process.env.ANTHROPIC_MODEL;
+    return resolveDsModel(raw);
+}
 /** OpenRouter model for the easy lane (env CURSOR_ROUTE_OPENROUTER_MODEL). */
 export function openRouterModel() {
     return process.env.CURSOR_ROUTE_OPENROUTER_MODEL || "openrouter/free";
@@ -43,20 +65,34 @@ function maxConcurrentJobsFromEnv() {
  */
 export const config = {
     product: "cursor-route",
-    version: "0.1.6",
+    version: "0.1.8",
     get jobsDir() {
         return defaultJobsDir();
     },
     tmuxPrefix: "cursor-route",
     defaultWorker: "grok",
-    /** Lane → default worker (Cemini /route public core). */
+    /**
+     * Lane → default worker (Cemini /route public core).
+     * `deepseek` is experimental only — mid stays on claude-ds.
+     */
     laneWorkers: {
         easy: "openrouter",
         mid: "claude-ds",
         hard: "grok",
     },
-    /** Default mid DeepSeek model (Flash = cheap execute). Override: --model pro */
-    defaultDsModel: "flash",
+    /**
+     * Default mid DeepSeek model (Flash = cheap execute).
+     * Live: CURSOR_ROUTE_DS_MODEL / ANTHROPIC_MODEL; invalid env → flash (health-safe).
+     * Override on start: --model. startJob uses defaultDsModelFromEnv() and fails on invalid env.
+     */
+    get defaultDsModel() {
+        try {
+            return defaultDsModelFromEnv().alias;
+        }
+        catch {
+            return "flash";
+        }
+    },
     jobsListLimit: 20,
     /** Max simultaneously active (running|pending) jobs. Override: CURSOR_ROUTE_MAX_JOBS. */
     get maxConcurrentJobs() {

package/dist/jobs.js

@@ -2,7 +2,7 @@ import { mkdirSync, writeFileSync, readFileSync, readdirSync, existsSync, unlink
 import { join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { dirname } from "node:path";
-import { config, sessionName, } from "./config.js";
+import { config, sessionName, defaultDsModelFromEnv, DS_MODEL_IDS, } from "./config.js";
 import { getAdapter } from "./adapters/index.js";
 import { spawn } from "node:child_process";
 import { spawnSync } from "node:child_process";
@@ -217,7 +217,30 @@ export function startJob(opts) {
     const id = newJobId();
     const paths = jobPaths(id);
     writeSecure(paths.prompt, opts.prompt);
-    const model = worker === "claude-ds" ? opts.model ?? config.defaultDsModel : undefined;
+    let model;
+    let modelId;
+    if (worker === "claude-ds" || worker === "deepseek") {
+        if (opts.model) {
+            model = opts.model;
+            modelId = opts.modelId ?? DS_MODEL_IDS[opts.model];
+        }
+        else {
+            try {
+                const choice = defaultDsModelFromEnv();
+                model = choice.alias;
+                modelId = opts.modelId ?? choice.id;
+            }
+            catch (e) {
+                try {
+                    unlinkSync(paths.prompt);
+                }
+                catch {
+                    /* ignore */
+                }
+                return { ok: false, error: e.message };
+            }
+        }
+    }
     let plan;
     try {
         plan = adapter.buildLaunch({
@@ -225,6 +248,8 @@ export function startJob(opts) {
             cwd,
             alwaysApprove,
             model,
+            modelId,
+            dryRun: Boolean(opts.dryRun),
         });
     }
     catch (e) {
@@ -397,7 +422,7 @@ export function cleanJobs(olderThanDays = 7) {
             if (Number.isFinite(t) &&
                 t < cutoff &&
                 (job.status === "completed" || job.status === "failed" || job.status === "killed")) {
-                for (const ext of [".json", ".prompt", ".log"]) {
+                for (const ext of [".json", ".prompt", ".log", ".dsh-patch.yml"]) {
                     const fp = underJobsDir(id, ext);
                     if (existsSync(fp))
                         unlinkSync(fp);

package/docs/DEMO_GIF.md

@@ -1,5 +1,21 @@
 # Hero demo recording (GIF)
 
+## Status
+
+No real GIF yet — the checkbox stays open until a `docs/fixtures/hero.gif` exists.
+
+Committed fixture for now: [docs/fixtures/hero-demo.log](./fixtures/hero-demo.log),
+a reproducible dry-run capture (no live workers, no secrets). Regenerate it with:
+
+```bash
+docs/fixtures/generate-hero-demo.sh
+```
+
+Also see [docs/fixtures/claude-ds-smoke.log](./fixtures/claude-ds-smoke.log)
+(headless `claude-ds` smoke proof). Both are machine-agnostic.
+
+## Recording the real GIF (later)
+
 tmux is required for the viral attach/send demo. On this laptop brew needs sudo — record after:
 
 ```bash
@@ -13,7 +29,8 @@ cursor-route health
 
 # Terminal A — three parallel jobs
 cursor-route start --lane hard --dir "$PWD" "Add README section Demo"
-cursor-route start --lane mid --dir "$PWD" "Add a unit test for shellQuote"
+cursor-route start --lane mid --dir "$PWD" "Add a unit test for shellQuote"   # Flash default
+# Optional: cursor-route start --lane mid --model pro --dir "$PWD" "…"
 cursor-route start --worker grok --dir "$PWD" "List open TODOs in src/"
 
 # Terminal B — watch
@@ -26,4 +43,4 @@ If you previously exported `$HOME/.cursor-route/bin`, that dir is stale — remo
 
 Record with [asciinema](https://asciinema.org/) or CleanShot → export GIF → `docs/fixtures/hero.gif`.
 
-Until then, use `docs/fixtures/claude-ds-smoke.log` as the committed proof fixture.
+When a real GIF lands, check off the **Hero GIF** item in `docs/briefs/WORKING.md` and reference it here.

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.6
+npm: cursor-route@0.1.8 (LIVE on npm latest)
 created: 2026-08-12
-updated: 2026-08-12
+updated: 2026-08-14
 ---
 
 # cursor-route — living brief
@@ -19,20 +19,24 @@ Cursor Agent plans. Workers run in tmux via `cursor-route`:
 | Lane | Worker | Intent |
 |------|--------|--------|
 | `easy` | OpenRouter free | Wording / drafts — non-secret prompts only |
-| `mid` | claude-ds (DeepSeek behind Claude Code) | Default implement (**Flash**) |
+| `mid` | claude-ds (DeepSeek behind Claude Code) | Default implement (**Flash**; `--model pro` when needed) |
 | `hard` | Grok CLI | Hard implement |
 
 Always-approve on (`--ask` / `CURSOR_ROUTE_ASK=1` to opt out). Jobs live in `~/.local/share/cursor-route/jobs`, not in this clone.
 
+Install: `npm i -g cursor-route` → **0.1.8**. Release notes: [CHANGELOG.md](../../CHANGELOG.md).
+
 ## Open (edit / check off)
 
-- [x] **Flash vs Pro on the CLI** — public default **Flash**; `--model pro` → `deepseek-v4-pro`
+- [x] **Flash vs Pro on the CLI** — public default **Flash**; `--model pro` → `deepseek-v4-pro` (LIVE 0.1.6+)
   - [x] pass `claude-ds -Model deepseek-v4-flash|deepseek-v4-pro` from the adapter
   - [x] add `--model flash|pro` on `start`
   - [x] document Grok **auth** ≠ usage-out (`grok login`) vs quota → Pro stand-in
 - [x] **Skill `route-orch`** — Flash/Pro table in `skills/` + `.cursor/skills/`
-- [x] **Official DeepSeek Harness** — `deepseek` adapter slot present; mid stays on claude-ds
-- [ ] **Hero GIF** — still outstanding (`docs/DEMO_GIF.md`)
+- [x] **Official DeepSeek Harness** — `deepseek` adapter slot present; `@deepseek-ai/dsh` 0.1.0-rc.6 (2026-08-13, github.com/deepseek-ai/deepseek-harness, MIT) is a developer-preview plugin kernel (web UI + `dsh --profile headless "job"`), not a Claude Code replacement; mid does not swap
+- [x] **0.1.7 debug fixes** — env default wired through `startJob`; Anthropic hatch omits DS ids; preserve `[1m]`
+- [x] **Experimental `--worker deepseek`** — 0.1.8: real dsh adapter (`dsh --profile headless` + per-job Cordis patch pins the model; never writes `~/.dsh/settings.yaml`). Always-approve → `DSH_PERMISSION_MODE=danger-full-access`, `--ask` → `workspace-write`; key via env only. Health ✓ needs `dsh` + `DEEPSEEK_API_KEY` (override `CURSOR_ROUTE_DSH_BIN`). Mid stays **claude-ds**.
+- [ ] **Hero GIF** — still outstanding; dry-run fixture ships as the substitute for now (`docs/fixtures/hero-demo.log` — see `docs/DEMO_GIF.md`)
 - [x] **Do not** paste private `ROUTE_KIT`, SIP, prod paths, or hang-watchdog env into this public repo
 
 ## Repo map
@@ -41,10 +45,11 @@ Always-approve on (`--ask` / `CURSOR_ROUTE_ASK=1` to opt out). Jobs live in `~/.
 |------|------|
 | `src/cli.ts` | `health` / `start` / `jobs` / `capture` / `send` / `kill` |
 | `src/adapters/claude-ds.ts` | Mid worker; DeepSeek URL required; `--model` → `-Model` |
-| `src/adapters/deepseek.ts` | Reserved unreleased harness slot |
+| `src/adapters/deepseek.ts` | Experimental dsh worker (`--worker deepseek`; mid stays claude-ds) |
 | `src/adapters/grok.ts` | Hard worker |
 | `src/adapters/openrouter.ts` | Easy worker |
 | `skills/route-orch/SKILL.md` | Cursor skill — spawn CLI, do not implement in-session |
+| `CHANGELOG.md` | Release notes |
 | `SECURITY.md` | Secret refuse gate |
 
 ## Edit log
@@ -53,3 +58,9 @@ Always-approve on (`--ask` / `CURSOR_ROUTE_ASK=1` to opt out). Jobs live in `~/.
 |------|--------|
 | 2026-08-12 | Brief created in this repo. Flash/Pro CLI + skill still open. |
 | 2026-08-12 | Shipped Flash default + `--model pro`, deepseek slot, skill table → 0.1.6. |
+| 2026-08-12 | npm `cursor-route@0.1.6` LIVE; CHANGELOG + README skill-install path fixed. |
+| 2026-08-12 | Grok debug → 0.1.7: env DS default, Anthropic hatch, `[1m]` preserve. |
+| 2026-08-13 | Hero demo dry-run fixture + docs: `docs/fixtures/generate-hero-demo.sh` → `hero-demo.log`; README Demo, DEMO_GIF.md, demo-notes pointer. Real GIF still open. |
+| 2026-08-13 | GPTSOL fixes: scrub inherited env/paths, stable job ids, ignore `docs/briefs/handoffs/`, GIF checkbox wording. |
+| 2026-08-14 | DeepSeek Harness eval: `@deepseek-ai/dsh` 0.1.0-rc.6 is a developer-preview plugin kernel, not a mid replacement; `--worker deepseek` stays unhealthy; mid remains claude-ds (docs-only, no version bump). |
+| 2026-08-14 | Experimental `--worker deepseek` wired to official dsh (headless + per-job patch + `DSH_PERMISSION_MODE` + key-via-env); `--model` applies to claude-ds + deepseek; mid stays claude-ds → 0.1.8 LIVE. |

package/docs/demo-notes.md

@@ -1,13 +1,15 @@
 # Demo fixture log (no secrets)
 
+> **Current fixture:** [docs/fixtures/hero-demo.log](./fixtures/hero-demo.log) — generated, dry-run, machine-agnostic (regenerate: `docs/fixtures/generate-hero-demo.sh`). Real GIF still pending: [DEMO_GIF.md](./DEMO_GIF.md).
+
 Simulated capture output for README / tweet assets — replace with a real GIF once tmux is available.
 
 ```
 $ cursor-route --version
-0.1.6
+0.1.8
 
 $ cursor-route health
-cursor-route v0.1.6
+cursor-route v0.1.8
 health: OK
   ✓ tmux
   ✓ runtime          bun ok
@@ -15,7 +17,7 @@ health: OK
   ✓ worker:grok
   ✓ worker:claude-ds
   ✓ worker:openrouter
-  ✗ worker:deepseek  unreleased — mid lane uses claude-ds
+  ✗ worker:deepseek  dsh not found — mid default remains claude-ds
   ✓ jobs_dir         ~/.local/share/cursor-route/jobs
 
 $ cursor-route start --lane mid "Add a failing test then make it pass"

package/docs/fixtures/generate-hero-demo.sh

@@ -0,0 +1,109 @@
+#!/usr/bin/env bash
+# generate-hero-demo.sh — regenerate docs/fixtures/hero-demo.log
+#
+# Dry-run only: no live Grok, no worker spawned, no secrets. Jobs dir is
+# sandboxed (trap-cleaned). Output is path-scrubbed + id-normalized so the
+# committed fixture is machine-agnostic and regenerates stably.
+#
+# Prerequisites: Bun or Node 20+; runnable ./bin/cursor-route
+# (git clone: bun install; npm global install ships dist/).
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+BIN="$ROOT/bin/cursor-route"
+OUT="$ROOT/docs/fixtures/hero-demo.log"
+
+if [[ ! -f "$BIN" ]]; then
+  echo "missing $BIN — run from a cursor-route checkout (need bun/node 20+)" >&2
+  exit 1
+fi
+
+# Neutralize inherited overrides that would leak private paths into the log.
+unset CURSOR_ROUTE_CLAUDE_DS_BIN CURSOR_ROUTE_GROK_BIN CURSOR_ROUTE_DSH_BIN \
+  CURSOR_ROUTE_ALLOW_ANTHROPIC \
+  CURSOR_ROUTE_ALLOW_STOCK_CLAUDE CURSOR_ROUTE_ANTHROPIC_BASE_URL CURSOR_ROUTE_DS_MODEL \
+  CURSOR_ROUTE_OPENROUTER_MODEL OPENROUTER_API_KEY OPENROUTER_BASE_URL \
+  ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_API_KEY ANTHROPIC_MODEL \
+  DEEPSEEK_API_KEY XAI_API_KEY 2>/dev/null || true
+
+TMP="$(mktemp -d)"
+trap 'rm -rf "$TMP"' EXIT
+export CURSOR_ROUTE_JOBS_DIR="$TMP/.demo-jobs"
+# Pin dsh to a missing path so worker:deepseek renders identically on machines
+# that do have a real dsh installed (the adapter shows the install hint, no path).
+export CURSOR_ROUTE_DSH_BIN="$TMP/no-such-dsh"
+
+RAW="$TMP/hero-demo.raw"
+NORM="$TMP/hero-demo.norm"
+
+{
+  echo "\$ cursor-route --version"
+  "$BIN" --version
+  echo
+
+  echo "\$ CURSOR_ROUTE_RELAXED=1 cursor-route health"
+  CURSOR_ROUTE_RELAXED=1 "$BIN" health
+  echo
+
+  echo "\$ cursor-route start --lane mid --model flash --dry-run \"Add a unit test for shellQuote\""
+  "$BIN" start --lane mid --model flash --dry-run "Add a unit test for shellQuote"
+  echo
+
+  echo "\$ cursor-route start --lane easy --dry-run \"Rewrite this FAQ answer in 3 sentences\""
+  "$BIN" start --lane easy --dry-run "Rewrite this FAQ answer in 3 sentences"
+  echo
+
+  echo "\$ cursor-route start --lane hard --dry-run \"Refactor auth module; run tests; report verify evidence\""
+  "$BIN" start --lane hard --dry-run "Refactor auth module; run tests; report verify evidence"
+  echo
+
+  echo "\$ cursor-route start --lane mid --dry-run --json \"Add a failing test then make it pass\""
+  "$BIN" start --lane mid --dry-run --json "Add a failing test then make it pass"
+  echo
+
+  echo "\$ cursor-route jobs --json"
+  "$BIN" jobs --json
+} > "$RAW"
+
+jobs_display="$HOME/.local/share/cursor-route/jobs"
+{
+  while IFS= read -r line || [[ -n "$line" ]]; do
+    line="${line//$TMP\/.demo-jobs/$jobs_display}"
+    line="${line//$ROOT/~/Projects/cursor-route}"
+    line="${line//$HOME/~}"
+    line="$(printf '%s' "$line" | sed -E \
+      -e 's#/Users/[^/\"'\'' ]+#~#g' \
+      -e 's#/home/[^/\"'\'' ]+#~#g' \
+      -e 's#/opt/cemini[^\"'\'' ]*#~#g' \
+      -e 's#/var/folders/[^\"'\'' ]+#/tmp#g')"
+    printf '%s\n' "$line"
+  done
+} < "$RAW" > "$NORM"
+
+python3 - "$NORM" "$OUT" <<'PY'
+import re, sys
+src, dst = sys.argv[1], sys.argv[2]
+text = open(src, encoding="utf-8").read()
+seq = ["a1b2c3d4", "b2c3d4e5", "c3d4e5f6", "d4e5f6a7"]
+seen: dict[str, str] = {}
+
+def take(jid: str) -> str:
+    if jid not in seen:
+        seen[jid] = seq[len(seen)] if len(seen) < len(seq) else f"{len(seen):08x}"
+    return seen[jid]
+
+out = []
+for line in text.splitlines(True):
+    def sub(m: re.Match[str]) -> str:
+        return m.group(1) + take(m.group(2)) + m.group(3)
+
+    line = re.sub(r"(dry-run job )([0-9a-f]{8})(\b)", sub, line)
+    line = re.sub(r'("id": ")([0-9a-f]{8})(")', sub, line)
+    line = re.sub(r"(jobs/)([0-9a-f]{8})(\.prompt)", sub, line)
+    line = re.sub(r"(headless-|cursor-route-)([0-9a-f]{8})(\b)", sub, line)
+    line = re.sub(r'("createdAt": ")[^"]+(")', r"\g<1>2026-08-13T00:00:00.000Z\2", line)
+    out.append(line)
+open(dst, "w", encoding="utf-8").write("".join(out))
+PY
+
+echo "wrote $OUT"

package/docs/fixtures/hero-demo.log

@@ -0,0 +1,52 @@
+$ cursor-route --version
+0.1.8
+
+$ CURSOR_ROUTE_RELAXED=1 cursor-route health
+cursor-route v0.1.8
+health: OK
+
+  ✓ tmux             ok
+  ✓ runtime          bun ok
+  ✓ script(1)        ok (tty log capture)
+  ✓ worker:grok      ok (auth checked at first start — run grok login if jobs fail) @ ~/.grok/bin/grok
+  ✓ worker:claude-ds ok (claude-ds (DeepSeek shim); default model deepseek-v4-flash) @ ~/.local/bin/claude-ds
+  ✗ worker:openrouter OPENROUTER_API_KEY not set — export your OpenRouter key (easy lane model defaults to openrouter/free) @ node '~/Projects/cursor-route/dist/openrouter-run.js'
+  ✗ worker:deepseek  dsh (@deepseek-ai/dsh) not found — install: npm i -g @deepseek-ai/dsh. Mid default remains claude-ds.
+  ✓ cursor_cli       optional ok (agent on PATH) — v0 supervisor is Cursor skill, not CLI
+  ✓ relaxed          CURSOR_ROUTE_RELAXED=1 — tmux optional (headless OK)
+  ✓ jobs_dir         ~/.local/share/cursor-route/jobs
+
+$ cursor-route start --lane mid --model flash --dry-run "Add a unit test for shellQuote"
+dry-run job a1b2c3d4
+worker: claude-ds
+model:  flash
+command: cd '~/Projects/cursor-route' && '~/.local/bin/claude-ds' -PromptFile '~/.local/share/cursor-route/jobs/a1b2c3d4.prompt' -Model 'deepseek-v4-flash' --dangerously-skip-permissions
+
+$ cursor-route start --lane easy --dry-run "Rewrite this FAQ answer in 3 sentences"
+dry-run job b2c3d4e5
+worker: openrouter
+command: node '~/Projects/cursor-route/dist/openrouter-run.js' --prompt-file '~/.local/share/cursor-route/jobs/b2c3d4e5.prompt'
+
+$ cursor-route start --lane hard --dry-run "Refactor auth module; run tests; report verify evidence"
+dry-run job c3d4e5f6
+worker: grok
+command: '~/.grok/bin/grok' -p "$(cat '~/.local/share/cursor-route/jobs/c3d4e5f6.prompt')" --cwd '~/Projects/cursor-route' --no-auto-update --output-format plain --always-approve
+
+$ cursor-route start --lane mid --dry-run --json "Add a failing test then make it pass"
+{
+  "id": "d4e5f6a7",
+  "schema": "cursor-route.job.v1",
+  "status": "pending",
+  "worker": "claude-ds",
+  "lane": "mid",
+  "model": "flash",
+  "prompt": "Add a failing test then make it pass",
+  "cwd": "~/Projects/cursor-route",
+  "alwaysApprove": true,
+  "tmuxSession": "cursor-route-d4e5f6a7",
+  "createdAt": "2026-08-13T00:00:00.000Z",
+  "command": "cd '~/Projects/cursor-route' && '~/.local/bin/claude-ds' -PromptFile '~/.local/share/cursor-route/jobs/d4e5f6a7.prompt' -Model 'deepseek-v4-flash' --dangerously-skip-permissions"
+}
+
+$ cursor-route jobs --json
+[]

package/llms.txt

@@ -2,7 +2,7 @@
 
 > Cursor stays the planner. DeepSeek (mid), Grok CLI (hard), and OpenRouter free models (easy) run parallel coding workers in tmux.
 
-MIT CLI + Cursor skill. npm: https://www.npmjs.com/package/cursor-route  
+MIT CLI + Cursor skill. npm: https://www.npmjs.com/package/cursor-route (latest **0.1.8**)
 GitHub: https://github.com/cemini23/cursor-route
 
 ## FAQ
@@ -16,8 +16,14 @@ It uses the familiar strategist and worker-pane shape, but it is not a Codex clo
 ### Does mid lane use Anthropic Claude?
 No. The mid worker is DeepSeek. Claude Code is the harness, configured with `ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic` and a DeepSeek key in `ANTHROPIC_AUTH_TOKEN`. Default model is Flash (`--model flash`); use `--model pro` for harder mid work or when Grok usage is exhausted (not the same as a missing `grok login`).
 
+### Flash vs Pro?
+| Flag | Model | When |
+|------|-------|------|
+| `--model flash` (default) | `deepseek-v4-flash` | Cheap mid execute |
+| `--model pro` | `deepseek-v4-pro` | Harder mid / Grok usage stand-in |
+
 ### How do I install?
-Run `npm i -g cursor-route`, install tmux if needed, then run `cursor-route health`. The package is available at https://www.npmjs.com/package/cursor-route, and the source is at https://github.com/cemini23/cursor-route.
+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
 
 ### Is it free?
 The cursor-route code is open source under MIT. It does not make the worker services free. Your costs depend on Cursor, DeepSeek API usage, and the Grok access or balance available to you. The easy lane can be free on OpenRouter's free-model route (`openrouter/free`).
@@ -26,4 +32,5 @@ The cursor-route code is open source under MIT. It does not make the worker serv
 
 - npm: `npm i -g cursor-route`
 - Health: `cursor-route health`
+- Mid: `cursor-route start --lane mid "…"` (Flash) · `--model pro` when needed
 - Skill: `/route-orch` (Cursor)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cursor-route",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Cursor stays the brain. Grok CLI + DeepSeek (claude-ds) + OpenRouter easy lane are the parallel army \u2014 lane-aware /route orchestration in tmux.",
   "type": "module",
   "license": "MIT",
@@ -23,6 +23,7 @@
     "SECURITY.md",
     "SUPPORT.md",
     "CONTRIBUTING.md",
+    "CHANGELOG.md",
     "README.md",
     "llms.txt"
   ],

package/skills/route-orch/SKILL.md

@@ -46,6 +46,19 @@ cursor-route start --lane mid --model pro --dir "$PWD" "…"
 
 If `worker:grok` is ✗ on health, that is usually **auth** (`grok login` / `XAI_API_KEY`) — not the Pro stand-in case.
 
+## Experimental: --worker deepseek (dsh)
+
+Official DeepSeek Harness headless as an opt-in worker — **not the mid default** (mid stays `claude-ds`).
+
+```bash
+npm i -g @deepseek-ai/dsh
+export DEEPSEEK_API_KEY=...        # platform.deepseek.com
+cursor-route start --worker deepseek --dir "$PWD" "…"
+cursor-route start --worker deepseek --model pro --dir "$PWD" "…"   # --model applies here too
+```
+
+Health ✓ needs `dsh` on PATH and `DEEPSEEK_API_KEY` set. The adapter pins `--model` via a per-job `--patch` (never touches `~/.dsh/settings.yaml`); always-approve → `DSH_PERMISSION_MODE=danger-full-access`, `--ask` → `workspace-write`. The key never enters the command or patch.
+
 ## Workflow
 
 1. Run `cursor-route health` (or `CURSOR_ROUTE_RELAXED=1` for headless). If the **target worker** is unhealthy, fix before spawning.
@@ -63,7 +76,7 @@ EOF
 )"
 ```
 
-Or `--worker grok` / `--worker claude-ds` / `--worker openrouter` (or `--lane easy`). Use `--no-tmux` only when tmux is unavailable.
+Or `--worker grok` / `--worker claude-ds` / `--worker deepseek` (experimental) / `--worker openrouter` (or `--lane easy`). Use `--no-tmux` only when tmux is unavailable.
 
 4. Monitor: `cursor-route jobs --json` · `cursor-route capture <id>` · `cursor-route send <id> "…"` (tmux only).
 5. Summarize worker results with **verify evidence** — no status-only “done”. If verify fails, `send` a correction or spawn a follow-up — do not invent success.
@@ -75,6 +88,6 @@ Defaults on for workers. Opt out: `cursor-route start … --ask` or `CURSOR_ROUT
 ## Anti-patterns
 
 - Do not paste API keys / private keys into prompts or `send`
-- Do not claim DeepSeek-native harness until that adapter ships — today is **claude-ds**
+- Do not claim the official DeepSeek harness (`@deepseek-ai/dsh`) is the mid default — `--worker deepseek` is experimental only; mid stays **claude-ds**
 - Do not open-source or dump private Cemini `agent-toolkit` paths into public handoffs
 - Do not mark done without reading `capture` / exit status

package/src/adapters/claude-ds.ts

@@ -7,7 +7,7 @@ import {
   DS_MODEL_IDS,
   type DsModelAlias,
   config,
-  resolveDsModelAlias,
+  resolveDsModel,
 } from "../config.ts";
 import { shellQuote } from "../util.ts";
 
@@ -29,6 +29,8 @@ function which(cmd: string): string | null {
       execSync(`command -v ${shellQuote(cmd)}`, {
         encoding: "utf8",
         stdio: ["ignore", "pipe", "ignore"],
+        // Bun may ignore mutated process.env.PATH unless env is passed explicitly
+        env: { ...process.env },
       }).trim() || null
     );
   } catch {
@@ -65,14 +67,16 @@ function deepseekBaseFromSettings(): string | null {
 
 /** Resolved DeepSeek base URL for the mid-lane harness, or null. */
 export function resolvedDeepSeekBaseUrl(): string | null {
+  // Explicit env wins: a non-DeepSeek ANTHROPIC_BASE_URL must not fall through to settings.
   for (const candidate of [
     process.env.ANTHROPIC_BASE_URL,
     process.env.CURSOR_ROUTE_ANTHROPIC_BASE_URL,
-    deepseekBaseFromSettings(),
   ]) {
-    if (candidate && isDeepSeekBaseUrl(candidate)) return candidate;
+    if (candidate) {
+      return isDeepSeekBaseUrl(candidate) ? candidate : null;
+    }
   }
-  return null;
+  return deepseekBaseFromSettings();
 }
 
 /** True when Claude Code harness is routed to DeepSeek (cheap path). */
@@ -120,18 +124,16 @@ function resolveClaudeDs(): { binary: string; mode: string } | null {
   return null;
 }
 
-function pickModelAlias(requested?: DsModelAlias): DsModelAlias {
-  if (requested) return requested;
-  // Env override for power users who already export ANTHROPIC_MODEL
-  const fromEnv = process.env.CURSOR_ROUTE_DS_MODEL || process.env.ANTHROPIC_MODEL;
-  if (fromEnv) {
-    try {
-      return resolveDsModelAlias(fromEnv);
-    } catch {
-      /* fall through to default */
-    }
+function pickModel(requested?: DsModelAlias, modelId?: string): { alias: DsModelAlias; id: string } {
+  if (modelId) {
+    const alias = requested ?? resolveDsModel(modelId).alias;
+    return { alias, id: modelId };
+  }
+  if (requested) {
+    return { alias: requested, id: DS_MODEL_IDS[requested] };
   }
-  return config.defaultDsModel;
+  // Env default (startJob normally resolves this; kept for direct buildLaunch callers)
+  return resolveDsModel(process.env.CURSOR_ROUTE_DS_MODEL || process.env.ANTHROPIC_MODEL);
 }
 
 /**
@@ -177,30 +179,45 @@ export const claudeDsAdapter: Adapter = {
       detail: `ok (${resolved.mode}; default model ${DS_MODEL_IDS[config.defaultDsModel]})`,
     };
   },
-  buildLaunch({ promptFile, cwd, alwaysApprove, model }) {
+  buildLaunch({ promptFile, cwd, alwaysApprove, model, modelId }) {
     const resolved = resolveClaudeDs();
     if (!resolved) {
       throw new Error("DeepSeek worker not available — run: cursor-route health");
     }
 
-    const alias = pickModelAlias(model);
-    const modelId = DS_MODEL_IDS[alias];
-
     const ask = process.env.CURSOR_ROUTE_ASK === "1" || process.env.CLAUDE_DS_ASK === "1";
     const skip = alwaysApprove && !ask;
-    // Stock `claude` needs DeepSeek env injected into the worker process
-    // (tmux panes may not inherit client env from a long-lived server).
-    const env = resolved.mode.startsWith("claude → DeepSeek")
-      ? deepSeekWorkerEnv(modelId)
-      : undefined;
+    const isAnthropicEscape = resolved.mode.startsWith("claude → Anthropic");
+    const isDeepSeekStock = resolved.mode.startsWith("claude → DeepSeek");
+    const isShim =
+      resolved.mode.startsWith("claude-ds") || resolved.mode.startsWith("deepseek-claude");
+
+    // Anthropic escape hatch: do not pass DeepSeek model ids (unknown to Anthropic).
+    // --model flash|pro is DeepSeek-only; stock Claude uses its own defaults / ANTHROPIC_MODEL.
+    if (isAnthropicEscape) {
+      const parts = [
+        shellQuote(resolved.binary),
+        "-p",
+        `"$(cat ${shellQuote(promptFile)})"`,
+      ];
+      if (skip) parts.push("--dangerously-skip-permissions");
+      return {
+        worker: "claude-ds",
+        command: `cd ${shellQuote(cwd)} && ${parts.join(" ")}`,
+        alwaysApprove: skip,
+      };
+    }
+
+    const choice = pickModel(model, modelId);
+    const env = isDeepSeekStock ? deepSeekWorkerEnv(choice.id) : undefined;
 
-    if (resolved.mode.startsWith("claude-ds") || resolved.mode.startsWith("deepseek-claude")) {
+    if (isShim) {
       const parts = [
         shellQuote(resolved.binary),
         "-PromptFile",
         shellQuote(promptFile),
         "-Model",
-        shellQuote(modelId),
+        shellQuote(choice.id),
       ];
       if (skip) parts.push("--dangerously-skip-permissions");
       return {
@@ -211,12 +228,13 @@ export const claudeDsAdapter: Adapter = {
       };
     }
 
+    // Stock claude → DeepSeek
     const parts = [
       shellQuote(resolved.binary),
       "-p",
       `"$(cat ${shellQuote(promptFile)})"`,
       "--model",
-      shellQuote(modelId),
+      shellQuote(choice.id),
     ];
     if (skip) parts.push("--dangerously-skip-permissions");
     return {