@peterwangze/claude-trigger-router 1.16.0 → 1.18.0

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

@@ -0,0 +1,48 @@
+# Release notes v1.17.0
+
+`v1.17.0` 定位为“UI 双层工作台收敛版”。这个版本不改变路由运行时语义，而是把 `/ui` 从功能集合页继续收敛为面向本地使用者、远程客户端、服务维护者和路由设计者的角色化工作台。
+
+## 本次闭环
+
+1. UI 渲染边界继续拆分
+   - `workbench-styles.ts` 承接工作台 CSS helper。
+   - `workbench-view-model.ts` 承接首屏状态派生。
+   - `renderWorkbenchHtml()` 不再继续直接堆叠角色入口、服务状态和响应式样式。
+
+2. Trace span 与路由证据视图
+   - 维护者 Trace Detail 先展示 route decision、switch continuity、handoff stages、routing evidence 和 trace spans。
+   - 原始 JSON 仍保留为深挖入口。
+   - 新视图复用已有 trace payload，不新增平行观测结构。
+
+3. 角色化 UI 体验设计 contract
+   - 已把“Web UI 缺少设计、不同角色易用性不足”的反馈纳入 v1.17.0。
+   - 已安装 `figma-create-design-system-rules`、`figma-generate-design`、`figma-implement-design` 三个 Codex/Figma 辅助 skill，Codex 重启后可用于后续设计系统和设计实现闭环。
+   - UI contract 明确角色/任务流、信息架构、设计 token、组件状态、页面密度、响应式行为和不新增平行 UI 状态。
+
+4. 真实浏览器 smoke
+   - 新增 `npm run test:ui:browser`。
+   - browser smoke 会 build、启动隔离 HOME 的 CTR、打开 `/ui`，在桌面和移动 viewport 检查角色入口、UX 设计辅助面板、trace evidence detail、维护者入口跳转和整页无横向溢出。
+   - 浏览器失败会输出 URL、页面摘要和最宽元素，方便把真实布局问题回填进 CSS / fragment contract。
+
+## 发布边界
+
+- 不改变 SmartRouter 默认运行时语义。
+- 不新增新的模型调度策略、治理算法或远程部署形态。
+- 不把 `/ui` 改写成新的 SPA，也不新增平行客户端状态模型。
+- 后续治理观测运营化进入 v1.18.0。
+
+## 发布前验证
+
+本版本发布前至少执行：
+
+```bash
+npx vitest --run src/deploy-assets.test.ts
+npm run test:ui
+npm run test:ui:browser
+npm run test:e2e:cli:entry
+npm run test:route-ux
+npm run build
+npm run release:verify
+```
+
+其中 `release:verify` 仍是最终发布门禁。

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

@@ -0,0 +1,49 @@
+# Release notes v1.18.0
+
+`v1.18.0` 定位为“治理观测运营化增强版”。这个版本不改变默认路由运行时语义，而是把维护者已经能看到的 trace、metrics、pool health、key quota 和 guardrail 信号继续收敛成可排序、可行动、可在 Web UI 中快速扫描的运营闭环。
+
+## 本次闭环
+
+1. Routing outcome scorecard
+   - `/api/governance/metrics` 新增 `outcomeScorecard`。
+   - route reason、final model、semantic intent 三类 outcome 会按 priority score 排序。
+   - scorecard 同时结合 model switch、alignment、cascade、latency、quality evidence 和 task comparison，给出 status、evidence、action 和 configPath。
+   - CSV export 同步包含 scorecard 摘要和条目。
+
+2. Operations risk
+   - `/api/service-info` 新增 `operations` 汇总。
+   - model pool health 与 managed key quota 不再只分散在两个表格中，而是合并为统一 status 和 actions。
+   - `/ui` 维护者工作台新增 Operations risk 面板。
+
+3. Guardrail summary
+   - `/api/governance/metrics` 新增 `guardrails` 汇总。
+   - 输入侧 prompt injection / secret exfiltration 和输出侧 placeholder / tool error 会按 code、severity、count、rate 和 action 汇总。
+   - `/ui` 维护者工作台新增 Guardrail summary 面板。
+
+4. Web UI 功能审视与视觉设计优化
+   - 维护者工作台顶部新增 decision rail。
+   - Operations、Guardrails 和 Outcome 三类运营信号先汇总为状态和下一步动作，再进入明细表。
+   - decision rail 在桌面保持三列，在移动端回落单列，并纳入 DOM/style/browser smoke 看护。
+
+## 发布边界
+
+- 不改变 SmartRouter 默认运行时语义。
+- 不新增新的模型调度策略或远程部署形态。
+- 不新增平行观测结构；新增汇总均复用现有 trace、metrics、service-info、pool health、auth quota 和 UI contract。
+- 后续部署形态与远程接入收敛进入 v1.19.0。
+
+## 发布前验证
+
+本版本发布前至少执行：
+
+```bash
+npx vitest --run src/deploy-assets.test.ts
+npm run test:ui
+npm run test:ui:browser
+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.16.0` minor release 的优先级是用户视角复审与入口一致性校准。发布检查需要优先保护既有 `setup / start / status / code / doctor / ui` 入口主路径，以及 fresh setup、远程转发、配置保存、鉴权、route preview 可读解释、`/v1/messages` 流式即时透传、上游中途断流的可读 SSE error、远程中转客户端断开取消上游、结构化 API error 返回不回退和 `/ui` 角色化第一屏不漂移。
+本次 `v1.18.0` minor release 的优先级是治理观测运营化增强。发布检查需要优先保护既有 `setup / start / status / code / doctor / ui` 入口主路径，以及 fresh setup、远程转发、配置保存、鉴权、route preview 可读解释、`/v1/messages` 流式即时透传、上游中途断流的可读 SSE error、远程中转客户端断开取消上游、结构化 API error 返回不回退、`/ui` 角色化入口不漂移、outcome scorecard、Operations risk、Guardrail summary、decision rail、trace evidence detail 可达和真实浏览器布局不横向溢出。
 
 ## 一次性准备
 
@@ -26,23 +26,24 @@
 
 1. 更新版本号
    - `vX.Y.0` 这类 minor release 还需要同步更新版本依赖用例、README 发布定位和对应 release notes。
-   - 本次 `v1.16.0` 的发布边界以 `docs/release-notes-v1.16.0.md` 为准：主打用户视角复审、入口一致性校准、角色化 `/ui` 第一屏、高频入口验证和已发布 closed 事项抽样校准。
+   - 本次 `v1.18.0` 的发布边界以 `docs/release-notes-v1.18.0.md` 为准：主打治理观测运营化、outcome scorecard、Operations risk、Guardrail summary、Web UI decision rail 和真实浏览器 smoke。
 2. 本地先执行发布包验证：
 
 ```bash
 npm run release:verify
 ```
 
-v1.16.0 期间建议在正式 `release:verify` 前额外跑一次用户入口与核心路由体感专项：
+v1.18.0 期间建议在正式 `release:verify` 前额外跑一次 UI 与治理观测运营化专项：
 
 ```bash
 npx vitest --run src/deploy-assets.test.ts
 npm run test:ui
+npm run test:ui:browser
 npm run test:e2e:cli:entry
 npm run test:route-ux
 ```
 
-这条专项把 README/发布说明入口、`/ui` 角色化第一屏、help/setup/doctor/code/ui 短入口、setup fresh、remote client、server deployment、route preview、即时流式输出、上游断流可读 error、远程中转取消和结构化 API error 串成同一个发布前门禁。它关注用户能直接感知的“能不能进入、会不会卡住、错误能不能读懂、路由选择能不能预期”，不是只检查内部函数返回。
+这条专项把 README/发布说明入口、`/ui` 角色化第一屏、outcome scorecard、Operations risk、Guardrail summary、decision rail、trace evidence detail、真实浏览器桌面/移动布局、help/setup/doctor/code/ui 短入口、setup fresh、remote client、server deployment、route preview、即时流式输出、上游断流可读 error、远程中转取消和结构化 API error 串成同一个发布前门禁。它关注用户能直接感知的“能不能进入、会不会卡住、错误能不能读懂、路由选择能不能预期、页面会不会溢出”，不是只检查内部函数返回。
 
 v1.12.0 期间建议在正式 `release:verify` 前额外跑一次流式稳定专项：
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peterwangze/claude-trigger-router",
-  "version": "1.16.0",
+  "version": "1.18.0",
   "description": "Intelligent trigger-based router for Claude Code with automatic task type detection and model routing",
   "bin": {
     "ctr": "dist/cli.js"
@@ -29,6 +29,7 @@
     "test": "vitest --exclude src/e2e/**",
     "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:ui:browser": "npm run build && node scripts/ui-browser-smoke.mjs",
     "test:e2e:cli": "vitest --run src/e2e/cli-e2e.test.ts",
     "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",