feat(graph): complete stategraph cleanup and acceptance

mvp/architecture/executor-evidence-pipeline-refactor.md

@@ -1,7 +1,7 @@
 # Chat Evidence Pipeline Contracts
 
 **状态**：当前实现
-**更新日期**：2026-07-08
+**更新日期**：2026-07-17
 **范围**：Chat 复杂诊断链路中的 Planner、Executor、Gatekeeper、Verifier、Composer 数据契约
 
 当前 Chat 复杂诊断链路是：
@@ -9,7 +9,8 @@
 ```text
 chat_planner
   -> chat_executor
-  -> VerifierInputHook / ExecutorGatekeeperService
+  -> GatekeeperNode / ExecutorGatekeeperService
+  -> VerifiedInputNode
   -> chat_verifier
   -> chat_composer
   -> final answer
@@ -219,13 +220,13 @@ Executor 必须遵守：
 
 ## 4. Gatekeeper
 
-Gatekeeper 位于 Verifier 前，由 `VerifierInputHook` 触发，负责代码级引用真实性校验。
+Gatekeeper 是 StateGraph 中的显式 Node，调用 `ExecutorGatekeeperService` 对当前 Run 的证据引用做代码级真实性校验。
 
 ### 4.1 输入
 
-- `sessionId`
+- `sessionId + runId`（来自 `RunnableConfig`，工具查询以 `runId` 为边界）
 - `executor_structured_output`
-- 当前 session 的 `tool_invocation`
+- 当前 run 的 `tool_invocation`
 
 ### 4.2 输出
 
@@ -304,22 +305,20 @@ Gatekeeper 位于 Verifier 前，由 `VerifierInputHook` 触发，负责代码
 
 ## 5. Verifier
 
-Verifier 输入由 `VerifierInputHook` 构造：
+`VerifiedInputNode` 只保留 Gatekeeper 检查通过的 claim/binding，并为 Verifier 构造最小输入：
 
 ```json
 {
-  "original_query": "用户原始问题",
-  "executor_final_answer": "{...executor raw text for debug/fallback only...}",
-  "executor_structured_output": {
+  "diagnosis_context": {
+    "query": "用户原始问题"
+  },
+  "verified_executor_output": {
     "answer_version": "executor_evidence_v2",
     "claims": []
   },
-  "executor_output_parse_status": {
-    "status": "valid",
-    "detail": "parsed executor evidence contract"
-  },
-  "tool_trace_summary": [],
-  "gatekeeper_result": {},
+  "verified_evidence": [],
+  "gatekeeper_audit": {},
+  "verdict_ceiling": "PASS",
   "retry_context": null
 }
 ```
@@ -330,7 +329,7 @@ Verifier 职责：
 - 不读 skill。
 - 不逐字核验 excerpt 真伪；这由 Gatekeeper 完成。
 - 只判断 `claim_text` 是否能由已核验的 `evidence_excerpt` 推出。
-- 结构化输出有效时，不得从 `executor_final_answer` 抽取额外确认事实。
+- 不读取 Executor 原始答复或完整工具 Trace，只读取 verified projection。
 - 对 `gatekeeper_result.severity=reject` 不得输出 `PASS`。
 - 对 `gatekeeper_result.severity=low_confid` 不得输出 `PASS`。
 
@@ -410,7 +409,7 @@ Composer 位于 Verifier 之后，输入是 ChatService 过滤后的允许表达
       "rule_set_version": "gatekeeper-rules-v1"
     },
     "composer_output": {},
-    "tool_trace_summary": []
+    "verified_evidence": []
   }
 }
 ```
@@ -422,6 +421,9 @@ Trace API 可用于回放：
 - Gatekeeper 是否通过、是否自动回填。
 - Verifier 如何判断可推导性。
 - Composer 最终如何表达给用户。
+- `run.orchestrationTrace` 如何经过条件边、有限重试并终止。
+
+历史 Run/fixture 的 `verifier_evaluation.tool_trace_summary` 仍可被 Trace UI 或离线评测只读解析，但它是旧链路兼容字段，不是当前 Verifier 输入，也不再由生产链路生成。
 
 ---