docs(openspec): archive stategraph design freeze

2026-07-17 10:24:13 +08:00
parent a36fe72639
commit 581daffdad
15 changed files with 1167 additions and 57 deletions
@@ -0,0 +1,20 @@
+# Chat Diagnosis StateGraph Design Freeze Brief
+
+## 背景
+
+- 用户目标：将 ISS-011 阶段 0–5 分别作为独立 sm-flow，前一阶段 archive 并 Git commit 后才进入下一阶段。
+- 当前问题：复杂 Chat 的跨 Agent 状态机分散在 ChatService、SequentialAgent、VerifierInputHook 和 ThreadLocal 中；实现前需先冻结统一设计。
+- 关联 OpenSpec：`openspec/changes/chat-diagnosis-stategraph-design-freeze/`
+- devflow 分档：complex
+
+## 范围
+
+- 本次要做：冻结最小 Graph State、完整路由、有限重试、安全 Fallback、run-scoped 审计、L4 接口影响和测试替换边界。
+- 本次不做：任何 Java、SQL、Prompt、配置、运行时 spec 或运行行为修改；不运行 Maven E2E。
+- 影响区域：ISS-011、glossary、OpenSpec 设计基线、阶段 0 ADR 和后续五阶段交接契约。
+
+## OpenSpec 对齐
+
+- proposal 覆盖状态：已覆盖阶段 0 目标、范围、非目标、验收和风险。
+- specs 覆盖状态：新增设计基线 capability，不提前修改运行时 capabilities。
+- tasks 覆盖状态：7/7 完成，且仅包含文档、ADR 和静态验证。