From c9a9b901722085fde5179f77f78d20beb576ccb9 Mon Sep 17 00:00:00 2001 From: WeiCHEN Date: Wed, 23 Sep 2026 00:27:07 +0800 Subject: [PATCH] docs(ops): scaffold docrev UI rerun closeout without closing audits MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Record honest partial progress (UI-00..04 live PASS, sealed UI-00..10 screenshots, UI-11 blocker history) and UI→audit mapping; leave 09-13 audits in_progress until full main+post-restart PASS ledger exists. --- .../short-term/2026-09-22-docrev-ui-rerun.md | 74 ++++++++++++++---- .../2026-09-22-docrev-ui-rerun-test-report.md | 78 +++++++++++++++++++ 2 files changed, 139 insertions(+), 13 deletions(-) create mode 100644 .doc/test-reports/2026-09-22-docrev-ui-rerun-test-report.md diff --git a/.doc/ops/short-term/2026-09-22-docrev-ui-rerun.md b/.doc/ops/short-term/2026-09-22-docrev-ui-rerun.md index b3e8bfb1..17de8f58 100644 --- a/.doc/ops/short-term/2026-09-22-docrev-ui-rerun.md +++ b/.doc/ops/short-term/2026-09-22-docrev-ui-rerun.md @@ -1,9 +1,9 @@ --- title: "DOCREV 真实 UI 重跑收口（产物隔离前置）" task_id: "docrev-ui-rerun-2026-09-22" -status: blocked +status: in_progress created: 2026-09-22 -updated: 2026-09-22 +updated: 2026-09-23 owner: Cursor task_type: implementation task_tier: multi_stage @@ -13,7 +13,7 @@ worktree: .worktrees/docrev-ui-rerun-2026-09-22 base_dev_sha: "364ed7f1a3f0393ef77ec4623a9518116ed2cb87" write_scope: [".doc", "e2e", "web"] allowed_environments: ["dev"] -head_sha: "3fdf4a01b72ca3fba245618608b2518e7fed8550" +head_sha: "1dbdb950887b120979473d11f8830efdd2a474ea" mutex: "web + docrev-ui-acceptance" review_state: pending integration_state: partial @@ -28,23 +28,71 @@ remote_sync: not_requested ## 用户目标与授权 -- 用户目标：关闭 20 份 2026-09-13 docrev audit + 9 份同名 remediation 的共同前置——真实 UI-xx 重跑。 -- 交付终点：先修产物隔离缺陷，再占槽对 schema 61 实跑；证据写入新 assets 目录；再改 audit/remediation 终态。 -- 禁止：stub/API 直写/伪造产物；`page.evaluate` 规避控件；DB 直建对象；写历史证据目录；push。 +- 用户目标：关闭 20 份 2026-09-13 docrev audit + ~9 份同名 remediation 的共同前置——真实 UI-xx 重跑。 +- 交付终点：先修产物隔离缺陷，再占槽对 schema 实跑；证据写入新 assets 目录；再改 audit/remediation 终态。 +- 禁止：stub/API 直写/伪造产物；`page.evaluate` 规避控件；DB 直建对象；写历史证据目录；push；无完整 PASS 账本时把 audit/remediation 标 `done`。 ## 步骤与验收 1. [x] 修产物隔离（`UI_PHASE` 分目录）；已合入本地 `dev`。 2. [x] 单测 `playwrightPhaseArtifacts.test.ts` PASS。 -3. [ ] 占 `env:dev` + 集成槽实跑 `UI_PHASE=main` / `post-restart`。 -4. [ ] 证据归档后关闭对应 audit/remediation。 +3. [~] 占 `env:dev` + 集成槽实跑 `UI_PHASE=main` / `post-restart`（main 未完；post-restart 未跑）。 +4. [ ] 完整 main（UI-00..16）+ post-restart PASS 账本归档后关闭对应 audit/remediation。 +5. [x] 收口脚手架：partial 测试报告 + UI→audit/remediation 映射（本轮）。 -## 阻塞原因 +## 当前进度（诚实账本） -- 真实 UI 全链依赖共享 `env:dev` 租约与串行集成槽；本会话未获环境写授权续跑。 -- 不得在无 PASS 账本时把 09-13 audit/remediation 标 done。 +| 项 | 状态 | 证据 | +|---|---|---| +| tip SHA | `1dbdb950887b120979473d11f8830efdd2a474ea` | `fix(e2e): click 确认推进 after intake 三权 before UI-11` | +| 活账本 `ui-acceptance-results.json` | **仅 UI-00..04 = PASS**；UI-05..16 缺失 | [assets](../../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json) | +| 密封截图 UI-00..10 | 先前成功 partial 已密封；**截图证明到达 UI-10，不等于 JSON PASS 账本** | [sealed-ui00-10-20260922T160841Z](../../test-reports/assets/2026-09-22-docrev-ui-rerun/sealed-ui00-10-20260922T160841Z/screenshots/) | +| 活截图目录 | 被后续重跑覆盖/混写；以 sealed 为准复盘 UI-00..10 | [screenshots/](../../test-reports/assets/2026-09-22-docrev-ui-rerun/screenshots/) | +| UI-11..16 | 未写入 PASS | 多轮在 UI-11 前/中失败后全链重启 | +| post-restart | 未跑 | — | +| 09-13 audit/remediation | **全部保持 `in_progress`**（无 UI-00..16 全量 PASS） | 见下方映射 | + +Partial 报告：[2026-09-22-docrev-ui-rerun-test-report.md](../../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。 + +## UI-11 阻塞史（摘要） + +对等 Agent 在 UI-11 失败后反复**整链重跑** Playwright；tip 持续叠加 e2e/web 修复，导致活账本被截断重写。已记录的阻塞/修复线索（按 tip 演进，非完整因果链）： + +1. **intake 未过三权**：`prelim_design` 前置须 approve intake + 点「确认推进」（`e6b23772` → `1dbdb950`）。 +2. **文档栏折叠**：分类选择前须展开 collapsed doc rail（`3a1065f7`）。 +3. **UI-05b task_key**：接受 `bd_intake`（`5e7fb240`）。 +4. **聊天解锁/孤儿 inflight**：composer 因保留 run id / streaming_status / orphan bubble 无法再 send（`1c78d614`/`db8c3dcc`/`c3639eba`/`5c222d18`）。 +5. **历史 UI-11 产品/契约债**（仍须本批真实 PASS 才能关 audit）：路由+lease、`prelim_design` output.md、快完成观测误杀等（见映射 UI-11 行）。 + +密封 UI-00..10 之后，活账本再次从 early cases 重写；本轮观测到的 live tip 账本停在 UI-04 PASS（UI-03 曾耗时 ~305s）。 + +## UI case → audit / remediation 关闭映射 + +**关闭规则**：仅当本任务 assets 下 `ui-acceptance-results.json` 对该 case（及子 case）记 `verdict=PASS`，且所属 phase 完整（main：UI-00..16；post-restart：约定 UI-15 恢复项）时，才可将对应文件 `status` 改为 `done` 并挂证据链接。截图 alone 不够。 + +| UI case | 关闭时的 audit（`in_progress`） | 关闭时的 remediation（`in_progress`） | +|---|---|---| +| UI-00 / UI-01 / UI-02 / UI-04 / UI-10 / UI-12 / UI-14 | （无独立 09-13 未关 audit；作为全链前置） | — | +| UI-03 | `sse-idempotency`, `quality-status-false-positive`, `quality-repair-workspace-contract`, `quality-gate-self-pollution` | `quality-repair-workspace-contract` | +| UI-05 | `active-doc-routing` | — | +| UI-05a | `pending-report-selection` | — | +| UI-05b | `e2e-reject-routing` | — | +| UI-06 | `block-selector`, `save-selector`, `editor-hydration-race` | `editor-hydration-race` | +| UI-07 | `overlay-selector`, `overlay-transition`（与 08/09 共证） | — | +| UI-08 / UI-09 | `overlay-transition`（三模式共证） | — | +| UI-11 | `second-doc-routing-lease`, `prelim-output`, `fast-completion-observation` | `second-doc-routing-lease`, `prelim-output`, `fast-completion-observation` | +| UI-13a | `workflow-category-navigation`, `reviewer-duty-sync`, `duty-cell-assertion` | `workflow-category-navigation`, `reviewer-duty-sync`, `duty-cell-assertion` | +| UI-13b | `duty-etag-overwrite`（及 save-selector 并发路径） | `duty-etag-overwrite` | +| UI-15 + `UI_PHASE=post-restart` | `post-restart-selector` | — | +| UI-16 | （`runtime-404` 已 `done`；本批不重开） | — | + +路径前缀：`.doc/audit/2026-09-13-document-revision-.md` / `.doc/remediation/2026-09-13-document-revision-.md`。 + +说明：`remediation/...-management-implementation-plan.md` 仍为方案态 `in_progress`，**不**由单一 UI case PASS 自动关闭。 ## 收口 -- 实现 tip 见分支历史（含 Edge 通道与 UI-00 修复）；`integration_state=partial`。 -- 下一步：持 `env:dev` 租约实跑 → 归档 assets → 再关 audit/remediation。 +- `status=in_progress`：缺 main 全量 + post-restart 真实 PASS。 +- `integration_state=partial`：e2e/web tip 已前进；audit 终态未动。 +- 下一步：在 mutex 下跑完 main UI-00..16 → 归档稳定账本 → post-restart → 再按上表关 audit/remediation。 +- **本轮未关闭任何 audit/remediation。** diff --git a/.doc/test-reports/2026-09-22-docrev-ui-rerun-test-report.md b/.doc/test-reports/2026-09-22-docrev-ui-rerun-test-report.md new file mode 100644 index 00000000..852677e9 --- /dev/null +++ b/.doc/test-reports/2026-09-22-docrev-ui-rerun-test-report.md @@ -0,0 +1,78 @@ +--- +title: "DOCREV UI 重跑验收报告（partial stub）" +date: 2026-09-23 +task_id: "docrev-ui-rerun-2026-09-22" +verdict: PARTIAL +tested_sha: "1dbdb950887b120979473d11f8830efdd2a474ea" +assets_dir: ".doc/test-reports/assets/2026-09-22-docrev-ui-rerun" +--- + +# DOCREV 真实 UI 重跑 — 部分报告（非 PASS） + +依据 [验证契约](../ops/2026-09-21-validation-contract.md)：前端交付须真实浏览器证据；stub/SKIP/未跑不得冒充 PASS；声明 PASS 须有对应真实输入输出。本文件为 **partial stub**，**不得**当作全链验收 PASS。 + +## 范围 + +- 任务：`docrev-ui-rerun-2026-09-22`（mutex：`web + docrev-ui-acceptance`） +- 目标：`UI_PHASE=main`（UI-00..16）+ `UI_PHASE=post-restart` 真实 Playwright，证据仅写入本 assets 目录 +- 关闭目标：20 份 `in_progress` audit + ~9 份同名 remediation（见 short-term 映射） +- 非范围：本轮不启动新 Playwright；不杀既有进程；不改 plan 文件；不 push + +## 被测 SHA / 环境 + +| 字段 | 值 | +|---|---| +| 分支 tip | `1dbdb950887b120979473d11f8830efdd2a474ea` | +| 环境 | 共享 `env:dev`（持锁实跑中/穿插；本报告作者未新开跑） | +| schema / BASE_URL | 以实跑容器为准（未在本 stub 中重核） | +| 命令形态 | `RUN_UI_ACCEPTANCE=1 UI_PHASE=main` + Playwright `document-revision-runtime.spec.ts`（对等 Agent 执行） | + +## 预期 vs 实际 + +| 预期 | 实际 | 判定 | +|---|---|---| +| main：UI-00..16 全部 `verdict=PASS` 写入活账本 | 活账本仅 **UI-00..04 = PASS**；UI-05..16 **缺失** | FAIL / 未完成 | +| post-restart：UI-15 恢复项 PASS | 未执行 | 未跑 | +| 密封 UI-00..10 截图可复盘 partial 成功段 | `sealed-ui00-10-20260922T160841Z/screenshots/` 含 UI-00..10 相关 PNG | 截图证明；**非** JSON PASS 账本 | +| 关闭 20 audit + ~9 remediation | **0 关闭**（缺全量 PASS） | 正确保持 `in_progress` | + +### 活账本摘要（`ui-acceptance-results.json`） + +快照时刻：报告起草时读取；对等 Agent 可能继续改写。 + +| Case | verdict | +|---|---| +| UI-00 | PASS | +| UI-01 | PASS | +| UI-02 | PASS | +| UI-03 | PASS（~305s） | +| UI-04 | PASS | +| UI-05 .. UI-16 | **MISSING**（无条目） | +| UI-05a / UI-05b / UI-13a / UI-13b | **MISSING** | + +### 密封截图（UI-00..10 已证明到达） + +目录：`.doc/test-reports/assets/2026-09-22-docrev-ui-rerun/sealed-ui00-10-20260922T160841Z/screenshots/` + +含：`UI-00-admin-logged-in.png`, `01-project.png`, `UI-02-squad-started.png`, `03-first-doc.png`, `04-first-report.png`, `05-second-report.png`, `UI-05a-confirmed.png`, `UI-05b-rejected.png`, `UI-06-after-refresh.png`, `UI-07-pure.png`, `UI-08-manual.png`, `UI-09-all.png`, `UI-10-history-compare.png`。 + +说明：密封集证明**先前**成功跑过 UI-00..10 交互并落盘截图；当前活 `ui-acceptance-results.json` **没有** UI-05..10 的 PASS 条目（被后续全链重启截断）。关闭 audit **必须以**完整 JSON PASS 账本为准。 + +## 剩余条件 + +1. **UI-11..16（main）**：须连续写入 PASS；当前 blocker 焦点在 UI-11（三权推进、doc rail、chat unlock、prelim 路由/产物等；tip 持续修 e2e）。 +2. **post-restart**：main 稳定归档后再跑；关 `post-restart-selector` audit。 +3. 全量 PASS 后按 [short-term 映射表](../ops/short-term/2026-09-22-docrev-ui-rerun.md#ui-case--audit--remediation-关闭映射) 批量改 `done` 并回链本报告/assets。 + +## 结论 + +- **判定**：`PARTIAL` — 非交付 PASS。 +- **审计关闭**：否（0）。 +- **风险**：对等 Agent 全链重启会覆盖活账本与活截图；关闭前应拷贝稳定 run 目录或确认 sealed/ledger 一致。 + +## 证据链接 + +- Assets 根：[assets/2026-09-22-docrev-ui-rerun/](./assets/2026-09-22-docrev-ui-rerun/) +- 活账本：[ui-acceptance-results.json](./assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json) +- 密封截图：[sealed-ui00-10-20260922T160841Z/](./assets/2026-09-22-docrev-ui-rerun/sealed-ui00-10-20260922T160841Z/) +- 任务短文：[2026-09-22-docrev-ui-rerun.md](../ops/short-term/2026-09-22-docrev-ui-rerun.md)