SuperBizAgent-java/devflow/projects/2026-07-17-chat-diagnosis-stategraph-routing-skeleton/acceptance.md

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/。