70 lines
2.6 KiB
Markdown
70 lines
2.6 KiB
Markdown
# Chat Diagnosis StateGraph Routing Skeleton Acceptance
|
||
|
||
## 结果
|
||
|
||
已接受。阶段 1 完成未接生产入口的 Graph 骨架和 Fake Node 路由体系。
|
||
|
||
## 验证
|
||
|
||
### 静态验证
|
||
|
||
- 命令：`git diff --check`
|
||
- 结果：passed。
|
||
- 检查：production refs、forbidden deps、23 changed paths 白名单。
|
||
- 结果：passed，outside refs=0，forbidden refs=0，out-of-scope=0。
|
||
|
||
### 脚本验证
|
||
|
||
- 命令：`mvn -q "-Dtest=DiagnosisGraphRoutingTest,DiagnosisOrchestrationTraceBuilderTest" test`
|
||
- 结果：passed，35 tests（29 routing + 6 trace），0 failure/error。
|
||
- 覆盖：正常、三类技术 retry、Executor 不重试、Gatekeeper、evidence retry、Composer、unknown fail-closed、threadId、Append events 和 trace。
|
||
|
||
- 命令：`mvn -q "-DskipTests" test`
|
||
- 结果：passed。
|
||
- 覆盖：main/test compilation。
|
||
|
||
- 命令：`openspec validate chat-diagnosis-stategraph-routing-skeleton --type change --strict --json`
|
||
- 结果：passed，1/1。
|
||
|
||
- 命令：`openspec validate --specs --strict --json`
|
||
- 结果：passed，12/12（归档前）。
|
||
|
||
### 浏览器/人工验证
|
||
|
||
- 结果：not run。
|
||
- 原因：无 UI 或生产入口变化。
|
||
|
||
### 未验证
|
||
|
||
- Maven E2E：not run，用户要求仅阶段 5 全部实现后统一执行。
|
||
- `logs/`：not inspected，保留到阶段 5。
|
||
- 数据库：not queried，保留到阶段 5。
|
||
- 真实模型/Agent：not invoked，属于阶段 2。
|
||
|
||
## 已完成范围
|
||
|
||
- 显式 Graph Core direct dependency。
|
||
- 26 state keys、typed status、topology/route/reason constants。
|
||
- 八个 config-aware action ports 和真实 CompiledGraph factory。
|
||
- Planner/Verifier/Composer 技术计数、一次 evidence retry、recursion limit 32。
|
||
- fail-closed router、events Append 和 trace builder。
|
||
- 35 个 Fake Node/trace tests。
|
||
|
||
## 已知限制
|
||
|
||
- Skeleton 没有生产消费者，阶段 3 才切换 ChatService。
|
||
- Fake Node 只证明控制流，不证明真实 Agent JSON、Gatekeeper 或安全输入映射。
|
||
- orchestration trace 尚未持久化或通过 API 暴露。
|
||
|
||
## Bug 修复和诊断
|
||
|
||
- 架构审计发现并修正 Graph Core 传递依赖所有权，改为 BOM 管理的直接依赖。
|
||
- 自查补齐全部正常节点 threadId、Verifier REJECT 和缺失 effective verdict 场景。
|
||
|
||
## 交接
|
||
|
||
- 下一步：阶段 1 Git commit；完成后才能创建阶段 2 change。
|
||
- Delta sync：新增 `chat-diagnosis-stategraph-routing-skeleton` 主 spec，共 6 requirements。
|
||
- OpenSpec 归档确认：用户已要求每阶段 archive，授权已存在。
|
||
- OpenSpec 归档结果：已同步主 spec，并归档到 `openspec/changes/archive/2026-07-17-chat-diagnosis-stategraph-routing-skeleton/`。
|