WeiCHEN
4baa1220ee
Record real Playwright ledgers, mark 20 audits and 9 remediations done, and leave management-implementation-plan as plan-only.
3.9 KiB
3.9 KiB
title, status, created, updated
| title | status | created | updated |
|---|---|---|---|
| prelim_design 真实产物契约：embed + 映射 + settle fail-closed + 瞬时全新 step 有界重试 | done | 2026-09-13 | 2026-09-22 |
prelim_design 真实产物契约
W3 UI-rerun 关闭（2026-09-22）：
status=done。真实 Playwright 账本 PASS：ui-acceptance-results.json（main UI-00..16）+ui-acceptance-results-post-restart.json（UI-15）。任务 tip 已合入本地dev；详见 short-term 与 测试报告。
背景
链到 ../audit/2026-09-13-document-revision-prelim-output.md。
外部：MiniMax 首次 write 未执行（terminated）+ SDK 三次 Connection error。
产品：agent_settled / 进程 0 / trace success=true 被当成步成功，没有全新 step 重试。
目标
通用、fail-closed 的产物与重试契约：成功步必须有真实、非空目标文件。瞬时 provider 失败可做有界全新 step invocation。永久缺失不得空转重试。不得伪造 output.md、不得改 E2E prompt、不得从截断 write 参数落盘。
分波次计划
| 波次 | 内容 | 验收 |
|---|---|---|
| Wave 0 | //go:embed 官方 templates/docs/*.md；GetDocTemplate 先读 embed |
无盘上 templates/ 时仍是正式模板 |
| Wave 0 | .dockerignore 放行 templates/**/*.md 与 configs/**/*.md；COPY templates/configs 到 /app |
TestDockerBuildContext_TemplatesDocsReadable：镜像内可读官方 prelim_design.md |
| Wave 0 | Runner rel_path 归一化；缺产物则 Success=false |
绝对 / ./ / 重复子目录能落盘；空 patches 失败 |
| Wave 0 | runner.mjs：auto_retry_end 失败或目标不存在不得 ok:true |
与现场 agent_settled 假成功对齐 |
| Wave 1 | settle-policy：terminated / Connection error / auto_retry_end 后 settle 失败，返回 retryable |
干净 settle + 缺文件 → retryable=false |
| Wave 1 | Go AssessStepFailure + runOneStep 有界全新 invocation（≤2） |
仅 (provider terminated/connection + 缺目标) 或 runner 明确失败；本次写入不覆盖且失败不翻成功；上一轮残留不当成功；耗尽 fail-closed |
| Wave 1 | 旧 runner 假成功：扫描 execution.log 识别 settled failure |
不依赖本轮 env-service 重建 |
| Wave 2 | deploy/pi-agent/Dockerfile COPY settle-policy.mjs 及 runner 全部相对 import |
TestPiAgentDockerfileCopiesRunnerRelativeImports + context smoke；本轮不重建运行中容器 |
取舍
- 不从
execution.log截断的write参数拼出正文。 - 不改 UI-11 prompt。Dockerfile / dockerignore 已修并测 context；不执行 env-service 重建。
- 产品重试是新的
backend.Execute/ 新 PI 进程，不是回放 SDK 半截 session，也不是执行截断 toolCall。 - 超时（整步 timeout）不按瞬时重试，避免 2×30min。
验收标准
- embed + 路径映射 + runner fail-closed + 单测
- dockerignore 放行官方 markdown；Docker context 可读
/app/templates/docs/prelim_design.md - 瞬时/永久分类 + 有界全新 step 重试 + 已有目标不覆盖 + 单测（本机门禁；真实 UI 未重跑）
- pi-agent 镜像 COPY 齐 runner 相对模块（
settle-policy.mjs）；契约测试防回归 - 占槽后真实 UI-11 PASS 才可将本任务标
done