文档：记录 DirectProject 回合错误命名化、wire 拆分与终态判别联合

- AGC 命令错误 ADR：三条错误表补 DirectProject 现有命名（TurnError / TurnFailure / EnqueueError），并写明"回合终态 TurnCompletion 是宿主内部判别联合，不导出、不进 wire" - 决策记录新增 2026-10-02 条目：命名去冗余前缀、wire.rs 按职责拆分、宿主终态改判别联合与 TurnCompletion 的落点
2026-10-02 18:10:54 +08:00
parent bee23a0a25
commit c18c73fa2f
2 changed files with 16 additions and 1 deletions
@@ -52,7 +52,11 @@ DirectProject 已经解决过同一类问题（[`【ADR】DirectProject命令接
  `runtimeSessionInstallFailed` / `authClientInitFailed` 三个 catch 用本操作的固定文案，路径等敏感片段
  由报告侧的 sanitize 换成占位符。
 - `#[tauri::command]` 的 `Err` 直接携带该枚举（Tauri 2 的 `InvokeError(pub serde_json::Value)` 支持结构化错误）。
-  这是 DirectProject 已有的做法（`enqueue_direct_codex_turn -> Result<(), DirectTurnEnqueueFailure>`），不是新约定。
+  这是 DirectProject 已有的做法（`enqueue_direct_codex_turn -> Result<(), EnqueueError>`），不是新约定。
+  DirectProject 的三条通道固定为三张类型表：入队拒绝 `EnqueueError`、宿主内部回合错误 `TurnError`
+  （不导出、不跨进程）、`turn.completed.failure` 载荷 `TurnFailure`；类型随所属深模块命名
+  （`agent/codex_app_server/turn_error.rs`、`agent/thread_manager/wire/failure.rs`），不再带 `Direct` 前缀；
+  回合终态判定 `TurnCompletion` 是宿主内部判别联合（`agent/thread_manager/turn_completion.rs`），不导出、不进 `wire/`。
 - 变体按**可判定的事实**命名。服务端 400 只提供 `status + message`（`AppError.code` 仍是通用
  `BAD_REQUEST`），所以 400 变体按"哪条请求的输入被拒"命名（如 `passwordLoginRejected`），
  不假装能区分密码长度/手机号格式；**任何地方都不允许对错误文案做判断**。