docs(plans): add Spec-1 implementation plan with Codex review fixes

2026-07-11 08:12:07 -04:00
parent ef402c46a2
commit 39c6352781
6 changed files with 635 additions and 3 deletions
@@ -33,7 +33,7 @@
 |------|-----|------|
 | 重试次数 | 2 | 第 3 次失败才整题终止（stop_reason=error 不变） |
 | 退避 | 20s / 40s | 用户指定 |
-| 可重试异常 | 显式类型元组：`ssl.SSLError`、`TimeoutError`、`ConnectionError`、`OSError`、openai SDK 传输类异常（`APIConnectionError`/`APITimeoutError`） | 遵循 CLAUDE.md P5（不做全 Exception 兜底）；`asyncio.CancelledError` 绝不吞；其余未知异常 fail-fast 整题终止（现状行为） |
+| 可重试异常 | 显式类型元组，默认 `(TimeoutError, OSError)`（`ssl.SSLError`/`ConnectionError` 均为 OSError 子类，覆盖实测穿透案例）；作为构造参数可注入扩展 | 遵循 CLAUDE.md P5（不做全 Exception 兜底）；core/ 不依赖 openai SDK——API 类异常由 GovernedLLMClient 内部重试栈负责；`asyncio.CancelledError` 绝不吞；未知异常 fail-fast 整题终止（现状行为） |
 | 上下文 | 原样保留 | messages 不回滚，重试即重发 |
 | 遥测 | 失败尝试的 error 记录由 `GovernedLLMClient` 内部负责（已有）；AgentLoop 侧只以 loguru 记录步级重试事件（不注入 TelemetryRecorder） | AgentLoop 无遥测端口，不越层补写 |