Improve execution preflight diagnostics
This commit is contained in:
39
docs/EXECUTION_HEALTH.md
Normal file
39
docs/EXECUTION_HEALTH.md
Normal 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。这避免无效任务浪费启动时间,
|
||||
也让失败停在真正的输入问题上。
|
||||
37
docs/tasks/M16-GAP-00282.md
Normal file
37
docs/tasks/M16-GAP-00282.md
Normal 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.
|
||||
Reference in New Issue
Block a user