@peterwangze/claude-trigger-router 1.18.0 → 1.19.0

package/docs/configuration-guide.md

@@ -118,7 +118,7 @@ Router: {}
 相关状态接口：
 
 - `GET /api/service-info`
-- `GET /api/remote-status`
+- `GET /api/remote-status`：本地 thin proxy 的远程 discovery / availability 摘要，包含远端 ready、远端模型数、upstream 服务数、客户端下一步和 service-scope 边界
 - `GET /api/registration`
 - `GET /api/governance/health`
 
@@ -293,7 +293,7 @@ Governance:
 - 当前角色：本地代理或远程路由服务
 - 当前监听地址，以及 server/cloud 模式下远程客户端应使用的 `ANTHROPIC_BASE_URL`
 - 当前鉴权状态、bootstrap key 和 active managed key 摘要
-- 如果启用了 `Runtime.remote_service`，会探测远程服务是否 reachable / ready
+- 如果启用了 `Runtime.remote_service`，会探测远程服务是否 reachable / ready、输出 service-scope discovery 边界，并在可达时显示远端注册模型数和 upstream 服务数
 
 如果远程客户端配置没有本地 `Models`，doctor 会跳过本地模型探测，不会再询问是否探测 `0` 个模型。
 
@@ -302,10 +302,10 @@ Governance:
 - 本地服务 ready 状态和端口
 - `Runtime.mode` 与服务角色
 - 监听地址、维护入口和远程客户端连接建议
-- 远程服务状态摘要
+- 远程服务状态摘要、remote discovery 和 remote availability
 - Registration 模型和上游服务摘要
 
-这些信息来自现有 `/api/service-info` 和 `/api/remote-status`，不会引入新的平行运行时。启用 `Runtime.remote_service` 时，`/api/remote-status` 还会只读同步远端 `/api/registration` 的脱敏摘要，用于显示远端注册模型数和 upstream 服务数；它不会把远端注册写回本地配置。
+这些信息来自现有 `/api/service-info` 和 `/api/remote-status`，不会引入新的平行运行时。启用 `Runtime.remote_service` 时，`/api/remote-status` 还会只读同步远端 `/api/registration` 的脱敏摘要，用于显示远端注册模型数、upstream 服务数、模型 ID 和客户端下一步；它不会把远端注册写回本地配置，也不表示已经支持节点/集群编排。
 
 维护者工作台还会展示治理 Health 摘要。它来自 `/api/governance/health`，同样也包含在 `/api/governance/metrics` 的 `health` 字段里：
 

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

@@ -0,0 +1,45 @@
+# Release notes v1.19.0
+
+`v1.19.0` 定位为“部署形态与远程接入收敛版”。这个版本不新增托管控制面或集群调度，而是在现有 local thin proxy、server profile、remote status 和 registration 基础上，让远程客户端与服务维护者更清楚地判断连到谁、远端是否 ready、有哪些模型可用，以及失败后该找谁处理。
+
+## 本次闭环
+
+1. Remote service discovery
+   - `/api/remote-status` 新增 `discovery` 摘要。
+   - 远端 service-info、registration、当前 runtime role 和失败状态会被合并为 `disabled / misconfigured / unreachable / not_ctr_service / not_ready / ready`。
+   - boundary 明确保持 service 级，`nodeOrchestration`、`clusterOrchestration` 和 `configWriteback` 均为 `unsupported`。
+   - `/ui` Role & connection guide 新增 remote discovery 状态和动作提示。
+
+2. Remote availability
+   - `/api/remote-status` 新增 `availability` 摘要。
+   - 远端 ready、registration 可用性、远端模型数、upstream 服务数、模型 ID、upstream service ID、客户端下一步和维护者动作进入同一运营状态。
+   - `/ui` 同步展示 remote availability，并把 client next steps 合并到 remote discovery 动作列表。
+
+3. Server/client guidance alignment
+   - README、configuration guide、server maintainer guide 和 remote client guide 已同步 remote discovery / availability、service-scope 边界和 `client + read-only` key 口径。
+   - `ctr doctor` 远程客户端路径新增 service-scope discovery 和远端注册摘要输出。
+   - `ctr setup` 远程路径下一步新增 `/api/remote-status` discovery/availability 观测提示。
+
+## 发布边界
+
+- 不新增完整 cloud/托管控制面。
+- 不新增节点/集群编排、多活调度或远端配置写回。
+- 不改变远程模型调用转发语义；本地 `ctr` 仍作为 thin proxy 转发 `/v1/messages` 与 `/v1/chat/completions`。
+- 后续发布与进展治理可持续化进入 v1.20.0。
+
+## 发布前验证
+
+本版本发布前至少执行：
+
+```bash
+npx vitest --run src/service-health.test.ts src/server.test.ts
+npx vitest --run src/ui/workbench.dom.test.ts
+npx vitest --run src/doctor/index.test.ts src/setup/index.test.ts src/deploy-assets.test.ts
+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.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 可达和真实浏览器布局不横向溢出。
+本次 `v1.19.0` minor release 的优先级是部署形态与远程接入收敛。发布检查需要优先保护既有 `setup / start / status / code / doctor / ui` 入口主路径，以及 fresh setup、远程转发、配置保存、鉴权、route preview 可读解释、`/v1/messages` 流式即时透传、上游中途断流的可读 SSE error、远程中转客户端断开取消上游、结构化 API error 返回不回退、`/ui` 角色化入口不漂移、remote discovery、remote availability、远端 registration 摘要、server/client 角色口径、trace evidence detail 可达和真实浏览器布局不横向溢出。
 
 ## 一次性准备
 
@@ -26,24 +26,26 @@
 
 1. 更新版本号
    - `vX.Y.0` 这类 minor release 还需要同步更新版本依赖用例、README 发布定位和对应 release notes。
-   - 本次 `v1.18.0` 的发布边界以 `docs/release-notes-v1.18.0.md` 为准：主打治理观测运营化、outcome scorecard、Operations risk、Guardrail summary、Web UI decision rail 和真实浏览器 smoke。
+   - 本次 `v1.19.0` 的发布边界以 `docs/release-notes-v1.19.0.md` 为准：主打部署形态与远程接入收敛、remote discovery、remote availability、server/client guidance alignment 和真实浏览器 smoke。
 2. 本地先执行发布包验证：
 
 ```bash
 npm run release:verify
 ```
 
-v1.18.0 期间建议在正式 `release:verify` 前额外跑一次 UI 与治理观测运营化专项：
+v1.19.0 期间建议在正式 `release:verify` 前额外跑一次远程接入与 UI 专项：
 
 ```bash
 npx vitest --run src/deploy-assets.test.ts
+npx vitest --run src/service-health.test.ts src/server.test.ts
+npx vitest --run src/doctor/index.test.ts src/setup/index.test.ts
 npm run test:ui
 npm run test:ui:browser
 npm run test:e2e:cli:entry
 npm run test:route-ux
 ```
 
-这条专项把 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 串成同一个发布前门禁。它关注用户能直接感知的“能不能进入、会不会卡住、错误能不能读懂、路由选择能不能预期、页面会不会溢出”，不是只检查内部函数返回。
+这条专项把 README/发布说明入口、`/ui` 角色化第一屏、remote discovery、remote availability、远端 registration 摘要、server/client 角色口径、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/docs/remote-client-guide.md

@@ -46,7 +46,9 @@ ctr status
 ctr ui
 ```
 
-`doctor` checks the configured remote service and reports whether it is reachable and ready. `status` shows the local role and remote-service connection hint. `ui` shows remote health through `/api/remote-status`, including the remote server's redacted registration summary when `/api/registration` is reachable.
+`doctor` checks the configured remote service and reports whether it is reachable and ready. It also prints the service-scope discovery boundary and a redacted remote registration summary when `/api/registration` is reachable.
+
+`status` shows the local role and remote-service connection hint. `ui` shows remote health through `/api/remote-status`, including remote discovery, availability, remote model count, upstream service count and client next steps. This is still a service-level contract; it does not mean node/cluster orchestration, hosted cloud control plane or remote config writeback is supported.
 
 ## Use with Claude Code through local ctr
 

package/docs/server-maintainer-guide.md

@@ -25,6 +25,8 @@ Edit `Models[].key`, `Models[].api`, `Models[].interface` and `Models[].model` b
 
 `GET /api/service-info` returns the same security policy and a deployment checklist so maintainers can verify the live service before sharing the URL.
 
+Remote clients read `GET /api/remote-status` from their local thin proxy. That response now includes discovery and availability summaries so clients can see the remote service role, service-scope boundary, remote model count, upstream service count and next steps without receiving secrets. Keep `/api/registration` redacted and treat it as an observability source, not remote config writeback.
+
 ## 2. Diagnose and start
 
 ```bash
@@ -103,3 +105,5 @@ curl -H "Authorization: Bearer $CTR_ADMIN_KEY" http://127.0.0.1:5678/api/service
 ```
 
 For model pools, use `GET /api/models/pool-health` for current health and `POST /api/models/pool-health/probe` for an operator-triggered lightweight reachability probe. The probe does not send a model request; it uses `HEAD` against enabled endpoints, records latency for reachable endpoints, and records failures into the existing cooldown/circuit breaker state.
+
+This server profile still does not provide node/cluster orchestration or a hosted cloud control plane. If remote clients report missing expected models in availability, inspect `Registration.models`, `Registration.upstream_services` and model pool health on this server.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peterwangze/claude-trigger-router",
-  "version": "1.18.0",
+  "version": "1.19.0",
   "description": "Intelligent trigger-based router for Claude Code with automatic task type detection and model routing",
   "bin": {
     "ctr": "dist/cli.js"