refactor(harness): freeze single-agent contracts

2026-07-21 17:33:25 +08:00
parent 30d3296043
commit 58c39107c5
47 changed files with 2607 additions and 24 deletions
@@ -0,0 +1,31 @@
+# Brief: single-react-design-freeze
+
+## 背景
+
+ISS-014 将 Chat 诊断从多 Agent、Hook、ThreadLocal 和外层重试编排收敛为单体 Diagnosis ReAct Agent、确定性 Harness 和隔离 SemanticGuard。阶段 0 先冻结后续实施共同依赖的契约和安全边界。
+
+## 目标
+
+- 提供可复用的 Diagnosis Draft、Knowledge Answer、Fallback、published result 和 previous turn 类型。
+- 固定 framework Tool Call ID、调用生命周期和证据结果双状态。
+- 固定取消、重试、no-evidence、阶段门禁和安全凭据策略。
+- 保持当前公开 Chat 运行行为不变。
+
+## 范围
+
+- `com.superbiz.agent.harness.contract` 类型层和 focused tests。
+- ISS-014 的 11 个串行 OpenSpec changes 台账。
+- 主配置、查询脚本和集成测试中的明文 Secret 清理。
+- OpenSpec、devflow glossary 和阶段验收基线。
+
+## 非目标
+
+- 不接入新 Harness、Agent 或 Guards。
+- 不切换 `/api/chat`，不删除旧运行链。
+- 不执行 live E2E。
+
+## 元数据
+
+- Scale: complex
+- Parent issue: `ISS-014`
+- OpenSpec: `openspec/changes/single-react-design-freeze`