refactor(harness): remove legacy agent architecture

2026-07-22 18:02:01 +08:00
parent bc36248cd8
commit 8ee7cc0b70
148 changed files with 3091 additions and 13889 deletions
@@ -0,0 +1,30 @@
+# Brief: single-react-cleanup-e2e
+
+## Background
+
+ISS-014 阶段 0-6B 已建立单一 Diagnosis ReAct Agent、Harness、ACI Tool、Guard 和 named SSE，但仓库仍存在 legacy AiOps/Sequential/Redis Session 链、旧 Tool contract、副作用式审计和过时文档。阶段 7 负责物理清理、durable metadata audit 和最终 live E2E。
+
+## Goals
+
+- 公开诊断只保留 `POST /api/chat`，业务代码只保留一个拥有 Tool loop 的 `diagnosis_agent`。
+- RAG/log 仅作为 Harness backend；Agent-facing Tool 只来自 `HarnessEvidenceTools`。
+- AgentStep 与 ToolInvocation 使用 exact sessionId/runId，长期持久化仅包含有界 metadata。
+- 通过 Maven 启动、named SSE、日志与 MySQL exact-run 查询完成最终验收。
+
+## Scope
+
+- 删除 legacy Controller、Service、Hook、ThreadLocal、prompt、前端入口、测试和死文档。
+- 新增 Harness-native Agent/Tool durable audit，修正文档、issue 与 OpenSpec strict 缺陷。
+- 为旧 V012 数据库增加幂等 V013 兼容迁移，并校准可重复 payment-timeout demo。
+
+## Non-goals
+
+- 不实现真实 CLS 或生产业务 MySQL Tool datasource。
+- 不修改三类 Intent、DiagnosisDraft、EvidenceGuard、SemanticGuard 或 Release Policy 语义。
+- 不保留 legacy endpoint、兼容分支、Graph 或第二套 Tool Call ID。
+
+## Classification
+
+- Scale: `complex`
+- Interface impact: L4 breaking HTTP/frontend cleanup
+- OpenSpec: `single-react-cleanup-e2e`