docs(mvp): align architecture and audit table design

mvp/architecture/current-mvp-architecture.md

@@ -1,6 +1,6 @@
 # 当前 MVP 架构
 
-**更新日期**：2026-07-22
+**更新日期**：2026-07-23
 **状态**：当前可运行架构
 
 ## 1. 系统定位
@@ -25,10 +25,14 @@ flowchart TB
     Release --> Chat
     App --> Run["diagnosis_run"]
     Diagnosis --> Step["agent_step metadata audit"]
+    App --> Timeline["diagnosis_trace_event"]
+    Diagnosis --> Reasoning["agent_reasoning_audit restricted"]
     Tools --> Invocation["tool_invocation metadata audit"]
     Run --> Trace["Diagnosis Trace API"]
     Step --> Trace
     Invocation --> Trace
+    Timeline --> Trace
+    Reasoning --> ReasoningAPI["Reasoning Audit API"]
 ```
 
 ## 3. 唯一 Chat 主链
@@ -66,20 +70,31 @@ chat_session(sessionId)
   -> diagnosis_run(runId)
       -> agent_step(runId)
       -> tool_invocation(runId)
+      -> diagnosis_trace_event(runId)
+      -> agent_reasoning_audit(runId, restricted)
 ```
 
 - `chat_session` 是 JPA Run 目录与多轮 metadata，不保存完整对话历史。
 - `diagnosis_run` 是 Run 状态、intent、release outcome、安全发布结果和预算汇总真理源。
 - `agent_step` 只保存模型步骤 metadata，不保存 Prompt、消息正文、模型正文或 Thought。
 - `tool_invocation` 只保存 Tool durable audit metadata；完整调用由 Redis canonical store 短期保存。
+- `diagnosis_trace_event` 是追加式统一 Timeline，记录 Run、Routing、Agent、Tool、Evidence、Semantic 和 Release 生命周期事件；`details` 只能保存有界安全 metadata。
+- `agent_reasoning_audit` 与普通 Trace 分表，只保存 Provider 实际返回的 reasoning 或明确的 unavailable 记录；reasoning 不属于事实证据。
 
 ## 6. 公开 API
 
-当前诊断执行入口只有 `POST /api/chat`。Trace、feedback、文档与检索 API 保持独立；已删除的旧诊断和 Redis conversation Session endpoint 不提供兼容分支。
+当前诊断执行入口只有 `POST /api/chat`。诊断审计读取分为：
+
+- `GET /api/diagnosis/{sessionId}/trace?runId={runId}`：普通 Trace，返回 Run、步骤、Tool metadata 和统一 Timeline，不返回 reasoning 原文。
+- `GET /api/diagnosis/{sessionId}/trace/reasoning?runId={runId}`：独立 reasoning 审计读取，`runId` 必填并校验其属于 path `sessionId`。
+
+Reasoning endpoint 是敏感审计面，不属于普通业务 API。当前已完成数据和查询隔离；认证授权、保留期限、加密要求及真实 Provider 验证仍由 ISS-015 收敛。Feedback、文档与检索 API 保持独立；已删除的旧诊断和 Redis conversation Session endpoint 不提供兼容分支。
 
 ## 7. 安全边界
 
-- 不输出或长期持久化 Chain of Thought。
+- 普通 SSE、Trace、Evidence Snapshot、业务结果和应用日志不输出或保存 reasoning 原文。
+- 仅当 Provider 在模型 metadata 中实际返回 reasoning 时，审计 Hook 才将其截断后写入独立表；Provider 未返回时不得伪造。
+- Reasoning 不能作为事实证据，也不能绕过 EvidenceGuard 或 SemanticGuard。
 - 不向 Agent 暴露 Redis、canonical key、完整 Tool 请求/响应或数据库凭据。
 - EvidenceGuard 只接受当前 Run 的 READY canonical invocation。
 - SemanticGuard 无 Tool、无记忆、无回调主 Agent 能力。