refactor(trace): enforce run-only diagnosis model

mvp/architecture/current-mvp-architecture.md

@@ -1,6 +1,6 @@
 # 当前 MVP 架构
 
-**更新日期**：2026-07-17
+**更新日期**：2026-07-20
 **状态**：当前可运行架构
 **适用范围**：Demo、面试讲解、后续迭代规划
 
@@ -96,8 +96,8 @@ flowchart TB
     RAG --> Store
     Tools --> Invocation
     Agent --> Step
-    App --> Session
-    TraceService --> Session
+    App --> ChatSession
+    TraceService --> ChatSession
     TraceService --> Step
     TraceService --> Invocation
 ```
@@ -167,7 +167,8 @@ sequenceDiagram
     participant Planner as Planner Agent
     participant Executor as Executor Agent
     participant Tool as Evidence Tools
-    participant Gatekeeper as Gatekeeper Hook
+    participant Gatekeeper as Gatekeeper Node
+    participant Projection as Verified Input Node
     participant Verifier as Verifier Agent
     participant Composer as Composer Agent
     participant DB as Trace Tables
@@ -184,11 +185,12 @@ sequenceDiagram
     Tool-->>Executor: 返回证据
     Executor->>Gatekeeper: 输出 executor_evidence_v2
     Gatekeeper->>DB: 读取 tool_invocation.evidence_refs 并校验引用
-    Gatekeeper->>Verifier: 传入已验真的 claims / excerpts
+    Gatekeeper->>Projection: 输出通过验真的 bindings
+    Projection->>Verifier: 只传入 verified claims / evidence
     Verifier->>DB: 合并 diagnosis_run.self_evaluation.verifier_evaluation
     Verifier->>Composer: 传入 allowed_claims / missing_info / actions
     Composer->>Chat: 生成最终用户答复
-    Chat->>DB: 保存 diagnosis_run.answer
+    Chat->>DB: 保存 answer / self_evaluation / orchestration_trace
     User->>Trace: GET /api/diagnosis/{sessionId}/trace?runId=...
     Trace->>DB: 聚合 run / step / tool
     Trace-->>User: 返回可回放诊断链路
@@ -204,19 +206,21 @@ POST /api/chat
               -> lookup_knowledge
               -> query_logs
               -> query_metrics
-          -> Gatekeeper 校验 Executor 证据引用真实性
-          -> Verifier 判断 claim 是否能由已核验证据推出
+          -> Gatekeeper Node 校验 Executor 证据引用真实性
+          -> Verified Input Node 只投影通过验真的 claims/evidence
+          -> Verifier 判断 claim 是否能由已验真证据推出
           -> Composer 生成最终用户答复
       -> 保存 chat_session metadata
       -> 保存 diagnosis_run
       -> 保存 agent_step.run_id
       -> 保存 tool_invocation.run_id
       -> 合并 diagnosis_run.self_evaluation.verifier_evaluation
+      -> 保存 diagnosis_run.orchestration_trace
 ```
 
-Chat 链路的质量门禁由三段组成：Gatekeeper 先做代码级引用验真，Verifier 再做 LLM 可推导性判断，Composer 最后控制对用户的表达边界。Gatekeeper、Verifier、Composer 的输出合并到当前 `diagnosis_run.self_evaluation.verifier_evaluation`，Trace API 会展示该验证结果。
+Chat 链路的质量门禁由四段组成：Gatekeeper 先做代码级引用验真，Verified Input 再隔离未通过的 binding，Verifier 做 LLM 可推导性判断，Composer 最后控制对用户的表达边界。结构化质量结果合并到 `diagnosis_run.self_evaluation.verifier_evaluation`；Node 路由、重试和降级摘要独立写入 `diagnosis_run.orchestration_trace`。
 
-Agent 编排细节见 [agent-orchestration.md](agent-orchestration.md)。
+最新运行时、路由和状态边界见 [stategraph-runtime-architecture.md](stategraph-runtime-architecture.md)，Agent 职责见 [agent-orchestration.md](agent-orchestration.md)。
 
 关键代码：
 
@@ -343,6 +347,7 @@ diagnosis_run
   -> run_id / session_id
   -> query / status / agent_flow / answer
   -> self_evaluation
+  -> orchestration_trace
   -> step_count / tool_call_count / duration
 
 agent_step
@@ -365,7 +370,7 @@ tool_invocation
 说明：
 
 - 旧的 `diagnosis_record` 已不是当前主模型。
-- `diagnosis_session` 已降级为历史兼容和回滚表，新执行写入 `chat_session + diagnosis_run`。
+- 当前运行时只使用 `chat_session + diagnosis_run`，不再映射、读取或写入 `diagnosis_session`。
 - `api_document` 仍用于文档元数据管理。
 - 文档向量内容存放在 Milvus/Zilliz collection 中。
 
@@ -384,7 +389,7 @@ Trace API 聚合：
 - Agent step 序列。
 - 工具调用和检索细节。
 - Chat Gatekeeper / Verifier / Composer 结果。
-- Chat `run.orchestrationTrace` 路由摘要，独立于 self-evaluation 和步骤/工具明细。
+- Chat `run.orchestrationTrace` 路由摘要，解析自 `diagnosis_run.orchestration_trace`，独立于 self-evaluation 和步骤/工具明细。
 - AIOps rule evaluation 结果。
 
 Trace 是本项目区别于普通问答系统的关键：答案不是孤立文本，而是可以追溯到 Agent 决策、工具调用和证据来源。
@@ -412,7 +417,7 @@ Prompt、StateGraph、Gatekeeper、Verifier、Composer 和评测门禁的完整
 已经完成：
 
 - Chat 和 AIOps 两条入口链路。
-- Chat 复杂诊断已单轨切换到 bounded StateGraph，并持久化 Run-owned `orchestration_trace`。
+- Chat 复杂诊断已单轨切换到 bounded StateGraph，并持久化 Run-owned `orchestration_trace`；Graph event 使用 portable Map，nested ReactAgent config 与外层 checkpoint/resume 控制信息隔离。
 - 显式 `lookup_knowledge` Agent Tool。
 - L0 从最终决策降级为 domain/entity hint。
 - `VectorSearchService` 作为稳定检索门面。
@@ -437,14 +442,16 @@ Prompt、StateGraph、Gatekeeper、Verifier、Composer 和评测门禁的完整
 - VectorStore 写入路径全面迁移。
 - 完整 LLM-based AIOps verifier。
 
-后续 Agent 拆分、Skill/Playbook、MCP 工具协议化和进程隔离等方向见 [evolution-roadmap.md](evolution-roadmap.md)。
+后续 Agent 拆分、Playbook 版本化增强、MCP 工具协议化和进程隔离等方向见 [evolution-roadmap.md](evolution-roadmap.md)。
 
 ## 10. 关键代码索引
 
 | 能力 | 代码 |
 |---|---|
 | Chat 入口与编排 | `ChatController`, `ChatService` |
-| Chat StateGraph | `ChatDiagnosisGraphRuntime`, `DiagnosisGraphFactory`, `DiagnosisRealGraphActionsFactory` |
+| Chat StateGraph runtime | `ChatDiagnosisGraphRuntime`, `DiagnosisGraphFactory`, `DiagnosisGraphRouter`, `DiagnosisGraphState` |
+| Chat Node assembly/config isolation | `DiagnosisRealGraphActionsFactory`, `ReactAgentDiagnosisInvoker` |
+| Graph result/audit mapping | `DiagnosisGraphResultMapper`, `DiagnosisOrchestrationTraceBuilder` |
 | AIOps 入口与编排 | `ChatController.aiOps`, `AiOpsService` |
 | AIOps 规则验证 | `AiOpsRuleEvaluationService` |
 | 知识库工具 | `LookupKnowledgeTool` |