feat(graph): add diagnosis routing skeleton

2026-07-17 11:17:13 +08:00
parent 581daffdad
commit 42ba204532
26 changed files with 2455 additions and 0 deletions
@@ -0,0 +1,69 @@
+# 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/`。