feat: archive mvp demo trace acceptance

This commit is contained in:
zhuyongxin
2026-07-03 16:25:00 +08:00
parent 5b827fe90e
commit 6919092b83
24 changed files with 1343 additions and 2 deletions
@@ -0,0 +1,25 @@
# MVP Demo Trace Acceptance Evidence
## Evidence
| Source | Evidence | Conclusion | Reported |
|---|---|---|---|
| `DiagnosisSessionRepository` | Existing `findBySessionId(String)` query | Trace can locate the session without new repository methods | Yes |
| `AgentStepRepository` | Existing `findBySessionIdOrderByStepIndex(String)` query | Agent steps can be returned in execution order | Yes |
| `ToolInvocationRepository` | Existing `findBySessionIdOrderByIdAsc(String)` query | Tool evidence can be returned in persisted order | Yes |
| `GlobalExceptionHandler` | Handles `SessionNotFoundException` as HTTP 404 with `Result.error(404, ...)` | Missing trace can reuse existing error contract | Yes |
| `mvn -q "-Dtest=DiagnosisTraceServiceTest" test` | Command passed | Trace aggregation behavior is covered offline | Yes |
| `mvn -q -DskipTests compile` | Command passed | New code compiles with the full project | Yes |
| `gitnexus detect-changes --repo SuperBizAgent-java` | Command completed with `No changes detected` and line-ending warnings | Required GitNexus check ran; output likely does not capture newly added files | Yes |
## Evidence-driven Conclusions
- Conclusion: No database migration is required.
- Evidence: All trace fields are available from existing `diagnosis_session`, `agent_step`, and `tool_invocation` entities.
- Risk: Response shape becomes a new API contract.
- User confirmation: Not required; additive L3 API recorded in OpenSpec.
- Conclusion: Trace aggregation can be tested without external infrastructure.
- Evidence: `DiagnosisTraceServiceTest` uses mocked repositories and an `ObjectMapper`.
- Risk: Runtime integration still depends on configured infrastructure.
- User confirmation: Not required; limitation recorded in acceptance docs.