feat(trace): finish run-aware demo verification

mvp/architecture/current-mvp-architecture.md

@@ -65,7 +65,8 @@ flowchart TB
     end
 
     subgraph Store["Persistence and Trace"]
-        Session["diagnosis_session"]
+        ChatSession["chat_session"]
+        Run["diagnosis_run"]
         Step["agent_step"]
         Invocation["tool_invocation"]
         ApiDoc["api_document"]
@@ -130,9 +131,10 @@ RAG Retrieval
   -> Milvus SDK fallback
 
 Persistence
-  -> diagnosis_session
-  -> agent_step
-  -> tool_invocation
+  -> chat_session
+  -> diagnosis_run
+  -> agent_step.run_id
+  -> tool_invocation.run_id
   -> api_document
   -> Milvus/Zilliz collection
 
@@ -163,21 +165,22 @@ sequenceDiagram
 
     User->>API: 提交诊断问题
     API->>Chat: execute chat strategy
+    Chat->>DB: 创建 chat_session metadata + diagnosis_run(runId)
     Chat->>Planner: 复杂问题进入规划
-    Planner->>DB: 写入 agent_step
+    Planner->>DB: 写入 agent_step.run_id
     Planner->>Executor: 下发排查方向
     Executor->>Tool: lookup_knowledge / logs / metrics
-    Tool->>DB: 写入 tool_invocation
+    Tool->>DB: 写入 tool_invocation.run_id
     Tool-->>Executor: 返回证据
     Executor->>Gatekeeper: 输出 executor_evidence_v2
     Gatekeeper->>DB: 读取 tool_invocation.evidence_refs 并校验引用
     Gatekeeper->>Verifier: 传入已验真的 claims / excerpts
-    Verifier->>DB: 合并 self_evaluation.verifier_evaluation
+    Verifier->>DB: 合并 diagnosis_run.self_evaluation.verifier_evaluation
     Verifier->>Composer: 传入 allowed_claims / missing_info / actions
     Composer->>Chat: 生成最终用户答复
-    Chat->>DB: 保存 diagnosis_session.answer
-    User->>Trace: GET /api/diagnosis/{sessionId}/trace
-    Trace->>DB: 聚合 session / step / tool
+    Chat->>DB: 保存 diagnosis_run.answer
+    User->>Trace: GET /api/diagnosis/{sessionId}/trace?runId=...
+    Trace->>DB: 聚合 run / step / tool
     Trace-->>User: 返回可回放诊断链路
 ```
 
@@ -194,13 +197,14 @@ POST /api/chat
           -> Gatekeeper 校验 Executor 证据引用真实性
           -> Verifier 判断 claim 是否能由已核验证据推出
           -> Composer 生成最终用户答复
-      -> 保存 diagnosis_session
-      -> 保存 agent_step
-      -> 保存 tool_invocation
-      -> 合并 self_evaluation.verifier_evaluation
+      -> 保存 chat_session metadata
+      -> 保存 diagnosis_run
+      -> 保存 agent_step.run_id
+      -> 保存 tool_invocation.run_id
+      -> 合并 diagnosis_run.self_evaluation.verifier_evaluation
 ```
 
-Chat 链路的质量门禁由三段组成：Gatekeeper 先做代码级引用验真，Verifier 再做 LLM 可推导性判断，Composer 最后控制对用户的表达边界。Gatekeeper、Verifier、Composer 的输出合并到 `diagnosis_session.self_evaluation.verifier_evaluation`，Trace API 会展示该验证结果。
+Chat 链路的质量门禁由三段组成：Gatekeeper 先做代码级引用验真，Verifier 再做 LLM 可推导性判断，Composer 最后控制对用户的表达边界。Gatekeeper、Verifier、Composer 的输出合并到当前 `diagnosis_run.self_evaluation.verifier_evaluation`，Trace API 会展示该验证结果。
 
 Agent 编排细节见 [agent-orchestration.md](agent-orchestration.md)。
 
@@ -255,7 +259,7 @@ POST /api/ai_ops
           -> Prometheus / logs / knowledge tools
       -> 生成告警分析报告
       -> AiOpsRuleEvaluationService
-      -> 合并 self_evaluation.aiops_rule_evaluation
+      -> 合并 diagnosis_run.self_evaluation.aiops_rule_evaluation
       -> Trace API 可查看全链路
 ```
 
@@ -317,23 +321,30 @@ RAG 总体设计见 [rag-architecture.md](rag-architecture.md)，检索运行细
 
 ## 6. 持久化模型
 
-当前诊断持久化以三张表为核心：
+当前诊断持久化以 session/run/trace 明细为核心：
 
 ```text
-diagnosis_session
-  -> 一次诊断会话的主记录
+chat_session
+  -> 多轮会话目录和元数据
+  -> session_id / status / message_pair_count
+
+diagnosis_run
+  -> 一次诊断运行的主记录
+  -> run_id / session_id
   -> query / status / agent_flow / answer
   -> self_evaluation
   -> step_count / tool_call_count / duration
 
 agent_step
   -> Agent 模型调用步骤
+  -> session_id / run_id
   -> step_index / agent_name
   -> model_input / model_output / thought
   -> duration / token_count
 
 tool_invocation
   -> 工具调用事实
+  -> session_id / run_id
   -> tool_name / input_params / output_preview
   -> retrieval_layer / retrieval_details
   -> retrieval_details.evidence_refs
@@ -343,7 +354,8 @@ tool_invocation
 
 说明：
 
-- 旧的 `diagnosis_record` 已不是当前主模型，迁移脚本中已经由 `diagnosis_session + agent_step + tool_invocation` 取代。
+- 旧的 `diagnosis_record` 已不是当前主模型。
+- `diagnosis_session` 已降级为历史兼容和回滚表，新执行写入 `chat_session + diagnosis_run`。
 - `api_document` 仍用于文档元数据管理。
 - 文档向量内容存放在 Milvus/Zilliz collection 中。
 
@@ -353,11 +365,12 @@ tool_invocation
 
 ```text
 GET /api/diagnosis/{sessionId}/trace
+GET /api/diagnosis/{sessionId}/trace?runId=run-...
 ```
 
 Trace API 聚合：
 
-- 会话状态和最终报告。
+- 会话元数据、运行状态和最终报告。
 - Agent step 序列。
 - 工具调用和检索细节。
 - Chat Gatekeeper / Verifier / Composer 结果。