feat(graph): complete stategraph cleanup and acceptance

2026-07-20 10:23:27 +08:00
parent 208a231113
commit 190013c901
46 changed files with 1223 additions and 1211 deletions
@@ -0,0 +1,32 @@
+# Chat Diagnosis StateGraph Cleanup And Final Acceptance
+
+## 背景
+
+ISS-011 阶段 0-4 已完成 StateGraph 设计冻结、路由骨架、真实 Nodes、ChatService 单轨切换和三层权威测试。阶段 5 负责删除旧 Hook/ThreadLocal/full-trace service 闭包、对齐当前文档与 demo executable contract，并以唯一 Run 完成最终 Maven、日志和数据库验收。
+
+## 目标
+
+- 只保留 bounded StateGraph 复杂 Chat 编排和 verified-only Verifier 输入。
+- 让 current architecture/eval/demo 文档与 Run-owned orchestration trace 一致。
+- 先通过确定性回归，再用 Maven `mvp-demo` 证明 exact Chat/Trace/feedback、日志和数据库 ownership。
+- 所有门禁通过后关闭 ISS-011，并归档阶段 5 OpenSpec。
+
+## 范围
+
+- 删除 `VerifierInputHook`、`VerifierContextHolder`、`ToolTraceSummaryService` 及其 focused test。
+- 更新 current architecture/eval/demo 文档和 interview demo check。
+- 修复 live 暴露的 Graph event classloader 边界与 nested ReactAgent resume config 问题。
+- 完成 Graph/Chat/Trace/Eval 回归、Maven live E2E、日志/MySQL 核验、进程清理和 Issue 生命周期收口。
+
+## 非目标
+
+- 不修改公开 Chat/feedback API、Executor/Verifier/Composer 业务协议或数据库 schema。
+- 不重写 archived issues、历史 design notes 和 legacy fixtures。
+- 不删除旧 Trace/fixture 对 `tool_trace_summary` 的只读兼容。
+- 不 push，不删除失败尝试的审计数据。
+
+## 元数据
+
+- 分档：complex
+- OpenSpec：`chat-diagnosis-stategraph-cleanup-docs`
+- 接口影响：L2 内部类型/状态表示修复；外部 API/DTO/schema 不变