@peterwangze/claude-trigger-router 1.7.0 → 1.8.0

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

@@ -0,0 +1,38 @@
+# v1.8.0 Release Notes
+
+`v1.8.0` 定位为“低侵入 agent/tool 增强与架构减压版”。这个版本承接已有 image agent、tools fallback、governance trace、远程转发和模型池基础，目标是让 agent/tool 能力继续服务 Claude Code 路由代理，而不是扩张成一套平行 agent 平台。
+
+## 本次发布主线
+
+- Runtime pipeline contract：新增 `src/runtime/pipeline.ts`，把 `auth -> remote_forward -> smart_router -> agent_tools -> router -> context_guard -> protocol_dispatch -> agent_stream -> response_governance` 固化为请求级阶段记录和顺序看护。
+- 管理 API route contract：新增 `src/server/management-routes.ts`，统一记录管理接口 method、path、domain、requiredScope 和 sensitive response，并让 `apiKeyAuth` 复用同一权限矩阵。
+- UI fragment contract：新增 `src/ui/workbench-fragments.ts`，抽出 surface tabs、HTML escaping、inline JSON helper 和关键 DOM anchor contract，降低 `/ui` 继续扩展时的单文件压力。
+- Route handoff summary：governance trace、API 和 `/ui` 都能展示 initial/final model、pipeline 阶段、切换状态和 failed/cascade/context guard 风险摘要。
+- Tool capability guardrail：工具可以声明 required model capabilities，运行时只注入当前 selected model 能满足的工具，并把 allow/deny 原因写入 trace。
+- 输入/输出 guardrail：非阻断识别 prompt injection、secret exfiltration、placeholder output、tool result error 和 refusal/incomplete output，并写入 governance trace。
+- Trace spans：`governanceTrace.spans` 统一承载 runtime pipeline、model pool fallback、input guardrail 和 output guardrail 证据，为 UI 和后续排障提供同一观测结构。
+
+## 发布边界
+
+本版本聚焦低侵入增强与架构减压，不宣称以下能力：
+
+- 独立 agent 编排、任务队列、长任务工作流或完整工具平台。
+- 完整 cloud 托管控制面、节点集群编排或多租户组织/计费系统。
+- 阻断式安全网关；当前输入/输出 guardrail 是 trace-first 的非阻断看护。
+- 全量浏览器端 trace span 可视化；本轮先稳定数据 contract 和 route handoff 摘要入口。
+
+## 发布前必跑
+
+```bash
+npm run release:verify
+npm run release:stage
+```
+
+正式发布前确认：
+
+- `package.json` 与 `package-lock.json` 版本均为 `1.8.0`
+- `ctr version` 输出 `Version: 1.8.0`
+- `v1.8.0` tag 与包版本一致
+- npm registry 中不存在 `@peterwangze/claude-trigger-router@1.8.0`
+- npm trusted publisher 指向 `peterwangze/claude-trigger-router` 的 `publish.yml`
+- GitHub publish workflow 使用 Node 24 / npm 11.5.1+

package/docs/releasing.md

@@ -7,7 +7,7 @@
 - `Release Check`：在 PR、`master` push 和手动触发时执行发布前检查
 - `Publish Package`：在版本 tag、GitHub Release 或手动触发时执行正式发布
 
-本次 `v1.7.0` minor release 的优先级是远程服务与模型池安全体验。发布检查需要同时保护既有 `setup / start / status / code / doctor / ui` 入口主路径，以及 server deploy、managed key、quota、remote forward、model pool health、主动探测和模型池调度策略。
+本次 `v1.8.0` minor release 的优先级是低侵入 agent/tool 增强与架构减压。发布检查需要同时保护既有 `setup / start / status / code / doctor / ui` 入口主路径，以及 runtime pipeline、管理 API 权限矩阵、UI fragment contract、route handoff summary、tool capability guardrail、输入/输出 guardrail 和 trace spans。
 
 ## 一次性准备
 
@@ -26,14 +26,14 @@
 
 1. 更新版本号
    - `vX.Y.0` 这类 minor release 还需要同步更新版本依赖用例、README 发布定位和对应 release notes。
-   - 本次 `v1.7.0` 的发布边界以 `docs/release-notes-v1.7.0.md` 为准：主打远程服务与模型池安全体验，不宣称完整云端托管控制面、节点集群编排或 agent 平台。
+   - 本次 `v1.8.0` 的发布边界以 `docs/release-notes-v1.8.0.md` 为准：主打低侵入 agent/tool 增强与架构减压，不宣称独立 agent 编排、完整工具平台、完整云端托管控制面或节点集群编排。
 2. 本地先执行发布包验证：
 
 ```bash
 npm run release:verify
 ```
 
-v1.7.0 期间建议在正式 `release:verify` 前额外跑一次服务安全与模型池专项：
+v1.8.0 期间建议在正式 `release:verify` 前额外跑一次 agent/tool 与架构 contract 专项：
 
 ```bash
 npm test -- --run --coverage
@@ -80,7 +80,7 @@ npm run test:e2e:acceptance
 - 目标端口被非本服务占用时的安全提示与“无额外文件修改”边界
 - 残留 / 失效 PID 文件的安全清理
 - `release:stage` 生成的 `.release-stage\ctr-release-home.cmd` wrapper 是否真的指向隔离 `.release-home`
-- v1.7.0 服务安全与模型池发布承诺的 server security policy、managed key rotation、pool health probe、成本/速率元数据和 round-robin / health-aware / cost-aware 策略
+- v1.8.0 agent/tool 与架构减压发布承诺的 runtime pipeline、管理 API route contract、UI fragment anchors、route handoff summary、tool capability guardrail、输入/输出 guardrail 和 trace spans
 
 只有这一步通过后，才继续正式发布，避免“发布后才发现包内容、CLI 启动或 setup 主流程有问题”。
 

package/package.json

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