Improve execution preflight diagnostics
Some checks failed
M6 deployable RC / quick (push) Has been cancelled
M6 deployable RC / chromium (push) Has been cancelled
M6 deployable RC / release (push) Has been cancelled

This commit is contained in:
mes123456
2026-08-24 17:04:16 -04:00
parent 5c8cfd1a8c
commit 603a5a92f2
6 changed files with 240 additions and 3 deletions

39
docs/EXECUTION_HEALTH.md Normal file
View File

@@ -0,0 +1,39 @@
# 执行健康与恢复顺序
这份报告只记录当前可复验的执行阻塞,不替代 `docs/EXECUTION_QUEUE.md`、parent
manifest 或任务卡。先运行廉价预检,再运行 Blender/WASM 或浏览器命令:
```bash
node tools/web/check-execution-health.mjs
```
预检会一次性检查当前 queue、parent `nextTask`、task index、catalog 唯一 active
记录、紧凑任务卡,以及当前 gap 的 fixture/generator。它在发现阻塞时退出码为 `2`
不会启动 Blender、加载 WASM 或写入任何证据。
## 当前基线2026-08-24
- `npm --prefix web run test:task-context`:通过,约 `708 ms`
- `npm --prefix web run test:context-governance`:失败,约 `732 ms`index/catalog
active 仍是 `M16-GAP-00281`queue 已指向 `M16-GAP-00282`
- `node tools/web/check-generated-gap.mjs --task M16-GAP-00282`:预检失败,约
`131 ms`;任务仍是 `pending`fixture 和 generator 均不存在。
- `npm --prefix web test`:约 `13.5 s``398/417` 通过19 个失败来自历史
manifest 的 artifact SHA-256 漂移,不能通过放宽校验解决。
- `npm --prefix web run typecheck`:约 `15.7 s`,通过。
- `npm --prefix web run lint`:约 `12.8 s`,通过。
## 恢复顺序
1. 先修复 queue、plan、catalog、index 的单一指针来源,并重新生成 index不得手工
修改 active 状态或 offset。
2. 为当前任务生成非空紧凑卡:
`node tools/web/generate-task-card.mjs --task M16-GAP-00282`
3. 只有任务变为 `active` 且 fixture/generator 真实存在后,才运行专项 gap 命令。
4. 历史 manifest hash 漂移需要不可变的源快照或经审计的重签流程;禁止在 checker 中
忽略漂移,也不要把 `CANCELLED`、metadata-only 或 negative-only 证据计为功能完成。
5. 专项任务通过后才运行浏览器验收;浏览器门永久限制为 Chromium。
`tools/web/check-generated-gap.mjs` 现在先执行同一套轻量预检,并把状态、缺失输入
和修复方向打印成单行诊断;只有预检通过才动态加载 WASM。这避免无效任务浪费启动时间
也让失败停在真正的输入问题上。

View File

@@ -0,0 +1,37 @@
# M16-GAP-00282: operator:asset.screenshot_preview LOCAL_EXACT slice
- task: M16-GAP-00282
- parent: M16-GAP-00281
- status: in_progress
- gap: operator:asset.screenshot_preview
- ownerFamily: OPERATOR
- targetImplementationClass: LOCAL_EXACT
## 目标
Make the same minimal fixture produce observable operator:asset.screenshot_preview data in Blender desktop and WASM/Main, with save/reopen stability. Change only this gap; do not expand to other data-blocks, editors, or browsers.
## 输入与范围
- Fixture: `tests/files/web/generated/M16-GAP-00282-operator-asset.screenshot_preview.blend`
- Generator: `tools/web/generated/M16-GAP-00282.py`
- Production: `blender-5.2.0/source/blender/web_engine/web_engine_blend_reader.cpp`
- Checker: `tools/web/check-generated-gap.mjs`
- Do: field read, desktop/WASM comparison, save/reopen, structured report.
- Do not: other gaps, Firefox/WebKit, or full editor behavior.
## 验收
build_blender_5.2.0/bin/blender -b --factory-startup --python tools/web/generated/M16-GAP-00282.py -- tests/files/web/generated/M16-GAP-00282-operator-asset.screenshot_preview.blend
npm --prefix web run test:generated-gap -- --task M16-GAP-00282
node tools/web/check-generated-gap.mjs --task M16-GAP-00282
Malformed/unsupported, cancellation, duplicate, over-budget, or hash-drift cases must keep in_progress; they must not change Main revision or advance nextTask.
## 交付与回滚
- Reports: `tests/golden/M16-GAP-00282/`
- Status: `docs/status/M16-GAP-00282.md`
- Manifest: `tests/golden/M16-GAP-00282/manifest.json`
- Handoff: `node tools/web/check-task-context.mjs --task M16-GAP-00282 --write`
- Rollback: remove this task production entry, fixture, tests, reports, manifest, status, and context; restore the parent as queue tail without rewriting parent evidence.