feat(harness): add chat application use case

2026-07-22 00:57:39 +08:00
parent ee0949d464
commit f8809cb7dd
56 changed files with 2815 additions and 6 deletions
@@ -0,0 +1,31 @@
+# Brief: single-react-chat-application-usecase
+
+## Background
+
+阶段 2-5 已具备 RunContext、单一 Diagnosis Agent 和安全释放门禁，但没有统一应用用例拥有 Session/Run、意图路由、PreviousTurn、固定执行器和最终持久化，阶段 6B 因而无法只做协议切换。
+
+## Goal
+
+在不改变公开 Chat/SSE 行为的前提下，建立内部 `ChatApplicationUseCase`，统一三类意图、同一 Run 生命周期、安全 PreviousTurn 和 typed public content。
+
+## Scope
+
+- 无 Tool、无记忆、无 ReAct 的三分类 Intent Router。
+- SYSTEM_CHAT、KNOWLEDGE_QUERY、DIAGNOSIS 固定执行器。
+- Knowledge exact invocation/document reference validation。
+- 同 Session 最近安全 Diagnosis SUCCESS 的有界 PreviousTurn。
+- `diagnosis_run` V012 字段、JPA store 和安全 `PublishedResult`。
+- Protocol-neutral observer、Run control、终态持久化和 focused tests。
+
+## Non-goals
+
+- 不修改 Controller、`/api/chat`、`/api/chat_stream`、SSE schema 或前端消费者。
+- 不删除旧 ChatService、多 Agent、ThreadLocal 或旧 session storage。
+- 不运行真实模型、Redis、日志和 MySQL live E2E；统一留到阶段 7。
+
+## Metadata
+
+- Scale: complex
+- Interface impact: L3 database/collaboration
+- OpenSpec: `single-react-chat-application-usecase`
+- Parent issue: `ISS-014`