46 lines
5.2 KiB
Markdown
46 lines
5.2 KiB
Markdown
# 完成/恢复生产路径专项回归结果
|
||
|
||
日期：2026-10-10。负责范围：`handleProcessComplete` / `recoverProcesses` / Codex App 运行态 / 保存失败分支的生产函数行为回归，不改生产实现。
|
||
|
||
## 新增脚本
|
||
|
||
`scripts/history-runtime-completion-unit.js`：从 `server.js` 按函数边界抽取真实完成、恢复与失败分支函数，配真实 `lib/session-history-store.js`、真实 `lib/agent-runtime.js` 事件解析和临时目录执行；不复制实现、不读写真实会话、不启动外部进程。已注册进 `scripts/regression.js` 的 `assertHistoryRecallContract` 专项列表。
|
||
|
||
原有 13 项覆盖：
|
||
|
||
- CLI 纯文本完成回合保持字符串内容形状，重开可读（防止 `[object Object]` 形状回归）。
|
||
- CLI 混合内容块（含图片块）与 130 条纯工具调用完整归档。
|
||
- CLI 完成保存失败时保留运行目录与 `output.jsonl`，`done` 标记 `historySaved=false`；存储恢复后由 `recoverProcesses` 恰好补齐一次。
|
||
- CLI 清理失败时重复恢复按 `runKey` 去重，不重复入库。
|
||
- Codex App 完整 turn 运行态先于预览保存（60 万字符正文与工具调用不裁剪），恢复恰好入库一次。
|
||
- Codex App 会话暂不可读时保留 `_history/_turns`、run 目录与预览状态，恢复后恰好入库一次。
|
||
- Codex App 损坏运行态文件保留，不误入库。
|
||
- Codex App 完成路径 `saveSession` 失败时先保留完整运行态，恢复后恰好一条正文且不补中断提示。
|
||
- 初次用户消息保存失败时不创建运行目录、不改写磁盘会话。
|
||
- 跨会话回传保存失败保留 `ready` 重试机会，重试恰好一个气泡；崩溃重试按处理标记去重。
|
||
- 子会话冲刷保存失败保留队列与有界重试标记，存储恢复后提交。
|
||
- 任务看板元数据适配器按 ID 重读完整档案，只提交元数据，不接受截断对象覆盖 650 条历史。
|
||
- Codex App steer 保存失败不调用 `turn/steer`。
|
||
|
||
新增两个完成入口读取失败回归（共 15 项）：
|
||
|
||
- CLI `handleProcessComplete` 的 `loadSession` 返回 `null` 时，真实完整归档保持原文，真实 run 目录与 `output.jsonl` 保留；应发送 `session_load_failed`、`done.historySaved=false`。恢复读取后，真实 `recoverProcesses` 恰好入库一次，成功提交后才清理。
|
||
- Codex App `handleCodexAppTurnComplete` 的 `loadSession` 返回 `null` 时，真实完整归档保持原文，`_history/_turns`、运行态预览与输出文件保留；最新完整 turn 保持正文、工具和 `completed` 状态。恢复读取后，真实 `recoverCodexAppTurnState` 恰好入库一次，不误补中断提示。
|
||
|
||
两个用例通过损坏真实档案文件制造读取不可用（`loadSession` 收敛为 `null`）：完成阶段断言归档未被重写、运行态保留；恢复阶段写回原档案后由同一存储实例补交；没有用 `saveSession=false` 替代读取故障，也不依赖跨 harness 桩函数。
|
||
|
||
## 验证结果
|
||
|
||
- 原有 13 项在此前实现上通过；新增读取失败用例的修复前运行为 **13 项通过、2 项失败**，分别真实复现 CLI 运行目录被删除和 Codex App 完整 turn 被删除。日志 `/tmp/ccweb-completion-load-null-before.txt`。
|
||
- 旧实现对照：`timeout 60s node scripts/history-runtime-completion-unit.js --baseline-head`，新增两个用例分别在 CLI 运行目录保留断言和 Codex App 运行目录保留断言上失败；它们进入真实完成函数后才失败，不依赖缺少新函数或新 writer 返回值复现。对照日志 `/tmp/ccweb-completion-load-null-head.txt`；当前共 15 项失败，预期失败清单包含新增两项。
|
||
- 修复后 15 项最终结果：主线程改为“真实损坏档案 → 完成保护 → 修复档案 → 同实例恢复补交”后复跑 `timeout 60s node scripts/history-runtime-completion-unit.js`，**15/15 通过**（2026-10-10，日志 `/tmp/completion-unit-fixed.txt`）。
|
||
- 最终全量回归：`npm run regression`，**Regression checks passed**（19:52:25→19:53:59），日志 `/tmp/cc-web-regression-final-verify.log`；运行前后 `server.js`、`public/app.js`、`scripts/regression.js`、`scripts/mock-codex-app-server.js`、`lib/session-history-store.js`、`lib/agent-runtime.js`、`lib/codex-app-runtime.js` 的 sha256 一致。
|
||
- 此前全量回归：`npm run regression`，**Regression checks passed**；当次运行前后 `server.js` md5 均为 `94fe21059863b9b1c7088c14d4743ed2`，日志 `/tmp/cc-web-regression-completion-2.log`。共享源码后来继续变化，此结果不能代替最终树验收。
|
||
- `git diff --check`、`node --check` 通过。
|
||
|
||
说明：首次全量回归（日志 `/tmp/cc-web-regression-completion.log`）在 `scripts/regression.js:9622` 出现 steer 超时，当时存在并发验收和共享源码修改；后续串行重跑曾通过。现有证据只支持“steer 时序失败”，没有充分证据把诱因归结为并发负载，也不能以一次复跑通过排除其他时序缺陷。
|
||
|
||
## 边界
|
||
|
||
以上均为临时目录与夹具验证；未读取或修改用户在另一客户端看到的真实会话，未重启生产服务，未部署。不能据此声称那 45 条旧消息已经找回。
|