Merge pull request #488 from pikasTech/fix/code-agent-partial-result-tests

fix: harden Code Agent result lifecycle

docs/reference/cloud-workbench.md

@@ -150,6 +150,19 @@ workspace；除非 Pod 重建、Codex supervisor 重启、用户显式清空对
 可用时优先使用；server 内存 session 因 Pod/replica 切换丢失时，只要本地 session 未过期，
 刷新页面不得要求用户重新登录。
 
+恢复出的历史消息如果携带 `traceId`，前端必须先对 `/v1/agent/chat/result/<traceId>` 做
+终态归一，再回放 `/trace`。旧的 `running` 消息不能只因为 localStorage restore 被降级成
+`source` 后停留在“处理中”文本；如果后端 result 已经完成，消息卡片必须替换为真实
+reply/blocker/session/providerTrace。如果 trace 只显示 `result:*` 终态事件而消息仍未完成，
+也必须立即查 result，而不是把 `Code Agent result is ready for short-connection polling.` 当成
+最终回复或让用户手工重试。
+
+Cloud Workbench 的 Code Agent 单元测试不得依赖真实 token、真实公网 provider 或真实硬件。
+前端状态机测试应使用固定 fixture/mock fetch 覆盖 submit accepted、result completed、result
+failed、session busy、partial timeout、trace compacted、SSE 断流和页面恢复；后端测试应使用
+fake Codex app-server client 覆盖长耗时和缺失 `turn/completed`。真实 DEV `--live` smoke 只用于
+发布后读写边界明确的验收，不作为 PR 默认回归测试。
+
 ## Lightweight Checks
 
 Use the existing lightweight checks unless a task explicitly authorizes a