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,70 @@
+# Chat Diagnosis StateGraph Design Freeze Acceptance
+
+## 结果
+
+已接受。阶段 0 完成设计冻结，没有修改运行时实现。
+
+## 验证
+
+### 静态验证
+
+- 命令：`git diff --check`
+- 结果：passed
+- 备注：仅有现有 LF/CRLF 提示，无 whitespace error。
+
+- 检查：Git changed/untracked 路径运行时拒绝列表。
+- 结果：passed，12 个路径，`src/`、Maven、运行配置、脚本、数据库迁移命中 0。
+- 备注：阶段 0 只包含 Issue、glossary、OpenSpec/devflow 和执行记录。
+
+- 检查：proposal → design → specs → tasks 四向对齐。
+- 结果：passed，gap=0。
+- 备注：状态、路由、Fallback、审计、测试迁移和六阶段边界均闭环。
+
+### 脚本验证
+
+- 命令：`openspec validate chat-diagnosis-stategraph-design-freeze --type change --strict --json`
+- 结果：passed，1/1。
+- 备注：当前 change 无结构或场景格式问题。
+
+- 命令：`openspec validate --specs --strict --json`
+- 结果：passed，11/11。
+- 备注：归档前主规格基线未回归。
+
+### 浏览器/人工验证
+
+- 结果：not run。
+- 原因：阶段 0 无 UI 或运行行为。
+
+### 未验证
+
+- 单元测试：not run。阶段 0 无代码行为，新增或运行单元测试没有新的验收价值。
+- Maven E2E：not run。用户明确要求仅阶段 5 在全部实现完成后统一执行。
+- `logs/`：not inspected for stage acceptance；保留到阶段 5。
+- 数据库：not queried for stage acceptance；保留到阶段 5。
+- 备注：此前改造前 live baseline 仅为 research，不计入本阶段验收。
+
+## 已完成范围
+
+- 冻结最小 Graph State、所有条件边、四类独立计数和终止路径。
+- 冻结 verified-input、两类 Fallback、Run 状态与 orchestration trace 边界。
+- 冻结 L4 消费者、兼容、迁移、回滚和测试替换策略。
+- 创建 ADR-001，并规定阶段 1–5 引用本阶段 archive。
+- OpenSpec apply tasks 7/7 完成。
+
+## 已知限制
+
+- 运行时仍为旧 Sequential 编排，这是阶段 0 的有意状态。
+- 新设计尚未经过 Graph 编译、Node 单测、Chat 集成或最终 E2E；后续阶段逐项证明。
+- 主运行时 specs 暂时仍描述旧行为，只新增设计基线 capability。
+
+## Bug 修复和诊断
+
+- 更正此前错误流程模型：删除未提交的总 change，改为六个独立 sm-flow/change。
+- 更正此前错误 E2E 门禁：阶段 0–4 不做 E2E，阶段 5 统一验证。
+
+## 交接
+
+- 下一步：阶段 0 Git commit；提交完成后才能创建阶段 1 change。
+- Delta sync：新增 `chat-diagnosis-stategraph-design-freeze` 主 spec，共 6 个 requirements，无现有 spec 修改/删除。
+- OpenSpec 归档确认：用户已在目标中明确要求每阶段 archive，并在后续澄清中再次确认，视为已授权。
+- OpenSpec 归档结果：已同步主 spec，并归档到 `openspec/changes/archive/2026-07-17-chat-diagnosis-stategraph-design-freeze/`。