@peterwangze/claude-trigger-router 1.14.0 → 1.16.0

package/docs/configuration-guide.md

@@ -270,7 +270,7 @@ Governance:
 - 复用当前可用配置
 - 迁移旧 `claude-code-router` 配置
 - 在没有可用配置时先询问“本地使用”、“连接远程服务”或“部署为远程服务端”
-- 本地使用时新建最小配置
+- 本地使用时先新建 `Models[].id + Router.default` 最小配置；如果继续添加复杂任务模型，可直接把它接到 `Router.think` / `Router.longContext`，并可生成 SmartRouter 规则或候选兜底
 - 连接远程服务时写入 `Runtime.remote_service`，不要求先填写本地 provider/model
 - 部署为远程服务端时写入 `HOST: "0.0.0.0"`、bootstrap admin `APIKEY`、`Runtime.mode: "server"` 和可编辑的 `Models + Router.default` 起步模板，并且不会自动启动服务
 - 保存后按角色输出下一步：本地路径提示本地代理状态、`ctr code` 和路由模板；远程客户端路径提示 `ctr status`、远端 ready/status、本地代理转发和可选直连 `ANTHROPIC_BASE_URL` / `ANTHROPIC_AUTH_TOKEN`；服务端路径提示 `ctr doctor` 与 `ctr start --daemon`

package/docs/release-notes-v1.15.0.md

@@ -0,0 +1,45 @@
+# Release notes v1.15.0
+
+`v1.15.0` 定位为“CLI/setup UX 重设计收口版”。这个版本不扩展新的运行时路由策略，而是把 fresh setup、legacy migration、remote client、server profile、SmartRouter 起步引导和短入口 smoke 继续收敛到同一条用户主路径。
+
+## What changed
+
+1. migration-first 与 model-id-first 主路径收口。
+   - `ctr setup` 继续优先复用当前配置或迁移旧 `claude-code-router` 配置；fresh setup 才进入新建流程。
+   - fresh setup 的核心问题保持为默认模型 `Models[].id`，`Router.default` 引用这个 model id。
+   - setup 持久化边界写出 canonical `Models[].id/api/key/interface/model/thinking/metadata`，不会把 `api_base_url/api_key/protocol` 作为新配置入口回流。
+   - `ctr help` 和 README quick start 已同步“复用/迁移优先；首次按 Models[].id 创建默认路由”的入口心智。
+
+2. 多模型与 SmartRouter 起步引导。
+   - fresh setup 在最小配置后可继续添加复杂任务模型。
+   - 新增基础槽位引导：复杂任务模型可直接接到 `Router.think`，或同时接到 `Router.think + Router.longContext`。
+   - SmartRouter 起步仍是可选项：可只生成复杂任务规则，也可生成规则 + candidates 智能兜底。
+   - 配置指南已说明 setup 可以直接生成可运行、可解释的多模型/SmartRouter 起步配置。
+
+3. 完成页 next steps 一致性。
+   - 本地使用完成页明确提示先用 `ctr doctor` 或 `ctr status` 确认代理状态，再用 `ctr code` 进入 Claude Code；需要查看配置、路由原因或健康状态时运行 `ctr ui`。
+   - 远程客户端完成页继续提示 `doctor/status -> code` 的本地 thin proxy 主路径。
+   - 服务端部署完成页继续提示检查 `Models[].id/api/key/interface/model` 后运行 `ctr doctor && ctr start --daemon`。
+   - packaged CLI E2E 覆盖三类 setup profile 的完成提示和副作用边界。
+
+4. CLI 帮助与入口 smoke 补强。
+   - packaged help e2e 现在断言 setup、doctor、code、ui 和 route preview 示例的用户可见文案。
+   - `npm run test:e2e:cli:entry` 已纳入 help smoke，短入口门禁覆盖 help、init、doctor、start/status/stop、setup fresh、setup remote client、setup server deployment、code 和 ui。
+
+## Validation
+
+Targeted validation before release:
+
+```bash
+npx vitest --run src/setup/index.test.ts src/setup/templates.test.ts src/cli-run.test.ts src/build-script.test.ts src/deploy-assets.test.ts
+npx vitest --run src/e2e/cli-e2e.test.ts -t "setup can create a fresh config on first use when no current or legacy config exists"
+npx vitest --run src/e2e/cli-e2e.test.ts -t "setup can create a fresh config|setup can create a remote-service client config|setup can create a server deployment profile"
+npx vitest --run src/e2e/cli-acceptance.test.ts -t "fresh setup -> status -> code smoke"
+npm run test:e2e:cli:entry
+```
+
+Final release gate:
+
+```bash
+npm run release:verify
+```

package/docs/release-notes-v1.16.0.md

@@ -0,0 +1,46 @@
+# Release notes v1.16.0
+
+`v1.16.0` 定位为“用户视角复审与入口一致性校准版”。这个版本不新增新的运行时路由策略，而是把项目目标、用户高频入口、已发布 closed 事项和 `/ui` 第一屏重新对齐到同一条产品主路径。
+
+## 本次闭环
+
+1. 项目目标与实现一致性复审
+   - 复核 README、configuration guide、setup、doctor、`/ui`、远程客户端与运行时主路径。
+   - 当前产品目标继续收敛为 Claude Code 本地/远程路由代理，不扩张为完整 agent 平台或托管控制面。
+   - fresh setup、远程转发、配置保存、鉴权、route preview、结构化 API error 和发布门禁继续作为用户主路径底线。
+
+2. 角色化 `/ui` 入口
+   - `/ui` 第一屏新增本地使用者、远程客户端、服务维护者和路由设计辅助入口。
+   - 新增 UX 诊断面板，帮助后续评估入口可见性、角色路径、核心路由解释和维护者排障入口。
+   - 宽表格约束在工作台面板内，避免第一屏或维护者视图出现整页横向溢出。
+
+3. 高频入口与核心路由体感验证
+   - 复核 fresh setup、legacy migration、remote client、server profile、route preview、结构化 API error、stream error、remote forwarding 和 `/ui`。
+   - `npm run test:e2e:cli:entry` 继续保护 help、setup、doctor、code、ui 等短入口。
+   - packaged entry slice 继续覆盖 `setup can create a remote-service client config` 和 server deployment profile，避免远程客户端完成页与真实 CLI 入口漂移。
+   - `npm run test:route-ux` 继续保护 route preview、即时流式输出、上游断流可读错误、远程中转取消和结构化错误。
+
+4. 已发布 closed 事项校准
+   - 抽样复核 v1.9.0 到 v1.15.0 的用户入口、远程客户端、SmartRouter 协作口径、流式韧性、配置产品化和 setup UX 闭环证据。
+   - 本轮未发现需要推翻 closed 结论的新漂移。
+
+## 发布边界
+
+- 不改变 SmartRouter 默认运行时语义；v1.10.0 的协作模式仍是 contract，不默认开启多模型并发。
+- 不新增新的模型调度策略、治理算法或远程部署形态。
+- 不完成 v1.17.0 计划中的 UI CSS/JS helper 拆分、trace span 视图和真实浏览器 smoke。
+
+## 发布前验证
+
+本版本发布前至少执行：
+
+```bash
+npx vitest --run src/deploy-assets.test.ts
+npm run test:ui
+npm run test:e2e:cli:entry
+npm run test:route-ux
+npm run build
+npm run release:verify
+```
+
+其中 `release:verify` 仍是最终发布门禁。

package/docs/releasing.md

@@ -7,7 +7,7 @@
 - `Release Check`：在 PR、`master` push 和手动触发时执行发布前检查
 - `Publish Package`：在版本 tag、GitHub Release 或手动触发时执行正式发布
 
-本次 `v1.14.0` minor release 的优先级是配置产品化最终收口。发布检查需要优先保护既有 `setup / start / status / code / doctor / ui` 入口主路径，以及 `Models[].id/api/key/interface/model/thinking/metadata` 字段心智、doctor 修复写回、路由槽位诊断、capability warning action、UI 保存/预览 warning contract、配置写回 canonical 字段、route preview 可读解释、`/v1/messages` 流式即时透传、上游中途断流的可读 SSE error、远程中转客户端断开取消上游和结构化 API error 返回不回退。
+本次 `v1.16.0` minor release 的优先级是用户视角复审与入口一致性校准。发布检查需要优先保护既有 `setup / start / status / code / doctor / ui` 入口主路径，以及 fresh setup、远程转发、配置保存、鉴权、route preview 可读解释、`/v1/messages` 流式即时透传、上游中途断流的可读 SSE error、远程中转客户端断开取消上游、结构化 API error 返回不回退和 `/ui` 角色化第一屏不漂移。
 
 ## 一次性准备
 
@@ -26,20 +26,23 @@
 
 1. 更新版本号
    - `vX.Y.0` 这类 minor release 还需要同步更新版本依赖用例、README 发布定位和对应 release notes。
-   - 本次 `v1.14.0` 的发布边界以 `docs/release-notes-v1.14.0.md` 为准：主打 Models 字段心智统一、路由槽位配置产品化、capability warning action 一致和配置保存/预览 contract 收口。
+   - 本次 `v1.16.0` 的发布边界以 `docs/release-notes-v1.16.0.md` 为准：主打用户视角复审、入口一致性校准、角色化 `/ui` 第一屏、高频入口验证和已发布 closed 事项抽样校准。
 2. 本地先执行发布包验证：
 
 ```bash
 npm run release:verify
 ```
 
-v1.14.0 期间建议在正式 `release:verify` 前额外跑一次配置产品化专项：
+v1.16.0 期间建议在正式 `release:verify` 前额外跑一次用户入口与核心路由体感专项：
 
 ```bash
-npx vitest --run src/doctor/index.test.ts src/setup/index.test.ts src/setup/setup.test.ts src/server.test.ts src/ui/workbench.dom.test.ts src/router/route-preview.test.ts src/deploy-assets.test.ts src/utils/validation-contract.test.ts
+npx vitest --run src/deploy-assets.test.ts
+npm run test:ui
+npm run test:e2e:cli:entry
+npm run test:route-ux
 ```
 
-这条专项把 doctor 修复写回、setup 字段提示、server 保存/预览、UI 草稿保存、route preview、文档资产和 validation issue contract 串成同一个发布前门禁。它关注用户能直接感知的“该填哪些字段、哪个槽位生效、warning 怎么修、保存后看到的配置是否一致”，不是只检查内部函数返回。
+这条专项把 README/发布说明入口、`/ui` 角色化第一屏、help/setup/doctor/code/ui 短入口、setup fresh、remote client、server deployment、route preview、即时流式输出、上游断流可读 error、远程中转取消和结构化 API error 串成同一个发布前门禁。它关注用户能直接感知的“能不能进入、会不会卡住、错误能不能读懂、路由选择能不能预期”，不是只检查内部函数返回。
 
 v1.12.0 期间建议在正式 `release:verify` 前额外跑一次流式稳定专项：
 
@@ -52,7 +55,7 @@ npm run test:e2e:cli
 npm run test:e2e:acceptance
 ```
 
-其中 coverage 口径已经从早期 `src/trigger/**/*.ts` 扩展到 setup、config、models、protocols、governance、server、auth、doctor、cli 主链；`test:ui` 是源码侧 `/ui` DOM smoke，用于保护配置载入、compiled preview、保存失败提示、Health action、benchmark history 和人工校准表单这类基础交互；`test:e2e:cli:entry` 是较短的打包后入口 smoke，用于先保护 init、doctor、start/status/stop、setup fresh、setup remote client、setup server deployment、code 和 ui；后续新增入口功能时，先补对应看护再扩展低频能力。
+其中 coverage 口径已经从早期 `src/trigger/**/*.ts` 扩展到 setup、config、models、protocols、governance、server、auth、doctor、cli 主链；`test:ui` 是源码侧 `/ui` DOM smoke，用于保护配置载入、compiled preview、保存失败提示、Health action、benchmark history 和人工校准表单这类基础交互；`test:e2e:cli:entry` 是较短的打包后入口 smoke，用于先保护 help、init、doctor、start/status/stop、setup fresh、setup remote client、setup server deployment、code 和 ui；后续新增入口功能时，先补对应看护再扩展低频能力。
 
 这一步会依次执行：
 
@@ -69,7 +72,7 @@ npm run test:e2e:acceptance
 
 其中两层打包后验证分别承担不同职责：
 
-- `npm run test:e2e:cli:entry`：覆盖打包后 CLI 的入口 smoke，优先保护 init、doctor、start/status/stop、setup fresh、setup remote client、setup server deployment、code 和 ui
+- `npm run test:e2e:cli:entry`：覆盖打包后 CLI 的入口 smoke，优先保护 help、init、doctor、start/status/stop、setup fresh、setup remote client、setup server deployment、code 和 ui
 - `npm run test:e2e:cli`：覆盖打包后 CLI 的主要命令、选择路径与文件副作用边界；当前 Windows 本地完整运行约 3-4 分钟
 - `npm run test:e2e:acceptance`：通过真实 shell / 全局 wrapper / 隔离 HOME 做更贴近人工验收的主路径看护
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peterwangze/claude-trigger-router",
-  "version": "1.14.0",
+  "version": "1.16.0",
   "description": "Intelligent trigger-based router for Claude Code with automatic task type detection and model routing",
   "bin": {
     "ctr": "dist/cli.js"
@@ -30,7 +30,7 @@
     "test:route-ux": "vitest --run src/router/route-preview.test.ts src/doctor/index.test.ts src/governance/stream-response-governance.test.ts src/index-startup.test.ts src/e2e/cli-e2e.test.ts -t \"route preview|previews route decisions|router slot summary|emits streamed chunks|readable SSE error|remote forwarding|structured 502|upstream error payloads|SmartRouter rules route|SmartRouter selects\"",
     "test:ui": "vitest --run src/ui/workbench.dom.test.ts",
     "test:e2e:cli": "vitest --run src/e2e/cli-e2e.test.ts",
-    "test:e2e:cli:entry": "vitest --run src/e2e/cli-e2e.test.ts -t \"init --force generates|doctor can repair|start/status/stop work|code reuses|ui prints|setup can create a fresh config|setup can create a remote-service client config|setup can create a server deployment profile\"",
+    "test:e2e:cli:entry": "vitest --run src/e2e/cli-e2e.test.ts -t \"help exits cleanly|init --force generates|doctor can repair|start/status/stop work|code reuses|ui prints|setup can create a fresh config|setup can create a remote-service client config|setup can create a server deployment profile\"",
     "test:e2e:acceptance": "vitest --run src/e2e/cli-acceptance.test.ts",
     "verify:package": "pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/verify-package.ps1",
     "install:local-release": "pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/install-local-release.ps1",