# Single React Diagnosis Agent Acceptance

## 结果

已接受。阶段 4 Committed OpenSpec 的 11 项任务全部完成，新链路仅通过内部 Java/test 入口运行，公开 Chat 未切换。

## 验证

### 静态验证

- 检查：新 `harness.agent` 包与 Prompt 搜索 `ThreadLocal|SessionContextHolder|while|SequentialAgent|SupervisorAgent|StateGraph|Planner|Composer|Verifier|raw_response`。
- 结果：通过，无匹配。
- 检查：`git diff --name-only` 限定 Controller、ChatService、AiOpsService。
- 结果：通过，无 diff。
- 检查：OpenSpec artifact status、cross-artifact、L2 interface impact、`.committed`、`.archive-ready`。
- 结果：通过。

### 脚本验证

- 命令：`mvn -q -DskipTests compile`
- 结果：通过。
- 命令：`mvn -q '-Dtest=HarnessToolInterceptorTest,DiagnosisAgentUseCaseTest' test`
- 结果：通过，14 tests。
- 命令：`mvn -q '-Dtest=DiagnosisAgentUseCaseTest,HarnessToolInterceptorTest,DiagnosisHarnessCoreTest,ToolBoundaryTest,ToolAdapterTest,MysqlToolAdapterTest,CanonicalInvocationStoreTest,HarnessContractTest,RagToolContractTest,QueryLogsToolContractTest,MysqlToolContractTest' test`
- 结果：通过。
- 命令：`openspec validate single-react-diagnosis-agent --strict`
- 结果：通过。
- 命令：归档后 `openspec validate single-react-diagnosis-agent --type spec --strict`
- 结果：通过；仓库级 `openspec validate --specs --strict` 另发现前序 `mysql-readonly-tool`、`rag-log-projections` 主规格仍使用旧 scenario 格式，本阶段不跨归档边界修改。

### 浏览器/人工验证

- 不适用。本阶段无 UI、HTTP 或 SSE 行为变化。

### 未验证

- 未启动 Maven 应用、外部模型、MySQL、Redis、Milvus 或日志服务；按 ISS-014 门禁统一留到阶段 7 live E2E。
- 未验证 provider 生产响应始终携带 Token Usage；缺失 Usage 时模型调用次数仍强制，实际 Token 只能在 provider 返回时记录。

## 已完成范围

- 单一 Diagnosis ReactAgent、单 Prompt 和固定 Query/PreviousTurn 输入。
- 框架原生 tool loop、exact Tool Call ID 和三类 Harness adapter bridge。
- 模型/Token/Tool/上下文/Draft 预算与无自动 retry。
- 严格 DiagnosisDraft 输出和无证据停止规则。
- 显式 sessionId/runId audit metadata、可注入 AgentStep Hook、canonical Tool invocation。
- 公开 Chat/AiOps 与旧多 Agent 路径保持不变。

## 已知限制

- Draft 尚未经过 EvidenceGuard/SemanticGuard，不能公开发布；阶段 5 负责释放门禁。
- previous turn 由调用方传入，阶段 6A 才实现同 Session 安全 Run 选择和确定性组装。
- 真实业务 adapter/Spring Bean 装配和公开入口切换分别留给阶段 6A/6B。
- 仓库级全规格 strict validation 仍受阶段 3B/3C 主规格 scenario 标题格式阻塞，建议阶段 7 文档清理时统一修正并复验。

## Bug 修复和诊断

- 编译发现框架 `Interceptor.getName()` 必须实现，已补充稳定名称并回归。
- 首次测试修正了两个测试假设：callback 异常包装类型，以及 ToolResponseMessage 在 Prompt instructions 中的实际位置；生产规格与实现方向未变。
- 提交前自审发现默认 BeanOutputConverter schema 不允许 `conclusion=null`，与冻结的无证据契约冲突；已增加 schema post-process 和 focused regression，未放宽其他 Draft 字段。

## 交接

- 下一步：提交独立阶段 4 commit，再进入阶段 5。
- OpenSpec 归档确认：用户已对 ISS-014 每阶段 Apply、Archive 和 Git commit 提供持续授权；已归档至 `openspec/changes/archive/2026-07-21-single-react-diagnosis-agent`，主规格已同步至 `openspec/specs/single-react-diagnosis-agent/spec.md`。