feat(harness): add evidence and semantic guards

2026-07-21 23:50:51 +08:00
parent 2362665519
commit ee0949d464
40 changed files with 2980 additions and 2 deletions
@@ -0,0 +1,32 @@
+# Brief: single-react-evidence-semantic-guards
+
+## Background
+
+阶段 4 已能生成带框架 Tool Call ID 的 `DiagnosisDraft`，但草稿在发布前还缺少当前 Run 证据验真、独立语义审查和 fail-closed 释放边界。
+
+## Goal
+
+在不恢复业务 Graph、不切换公开入口的前提下，实现确定性 EvidenceGuard、一次语义不变的结构修复、无 Tool/无记忆的单轮 SemanticGuard，以及只发布原 Draft 或固定 SafeFallback 的内部 release use case。
+
+## Scope
+
+- Draft 结构、Analysis/报告引用和 canonical Tool invocation 验真。
+- RAG/log/MySQL verified evidence snapshot。
+- Evidence repair 单次调用与语义不变约束。
+- SemanticGuard 模型/Token/字节预算、超时、取消、技术重试和严格二元输出。
+- SUPPORTED/UNSUPPORTED/unavailable/evidence-failed release policy。
+- focused tests、Harness/Tool/Agent 回归和静态范围验证。
+
+## Non-goals
+
+- 不切换 Chat/AiOps/SSE 公开协议。
+- 不实现 Intent Router、PreviousTurn、Run persistence 或最终报告渲染。
+- 不删除旧 Gatekeeper/Verifier/Composer/多 Agent 链路。
+- 不运行 live model/Redis/MySQL E2E；统一留到阶段 7。
+
+## Metadata
+
+- Scale: complex
+- Interface impact: L2 internal
+- OpenSpec: `single-react-evidence-semantic-guards`
+- Parent issue: `ISS-014`