Complete HOOK modifier gap

2026-08-20 06:13:00 -04:00
parent f2c49061a6
commit 2ef2585676
12 changed files with 173 additions and 10 deletions
--- a/docs/EXECUTION_QUEUE.md
+++ b/docs/EXECUTION_QUEUE.md
@@ -9,10 +9,10 @@
 | 字段 | 值 |
 | --- | --- |
 | 里程碑 | M16 Main、Mesh、Modifier、Sculpt |
-| 当前任务 | `M16-GAP-00072` |
-| parent manifest | `tests/golden/M16-GAP-00071/manifest.json` |
-| 任务卡 | [`tasks/M16-GAP-00072.md`](tasks/M16-GAP-00072.md) |
-| 专项验收 | `npm --prefix web run test:generated-gap -- --task M16-GAP-00072` |
+| 当前任务 | `M16-GAP-00073` |
+| parent manifest | `tests/golden/M16-GAP-00072/manifest.json` |
+| 任务卡 | [`tasks/M16-GAP-00073.md`](tasks/M16-GAP-00073.md) |
+| 专项验收 | `npm --prefix web run test:generated-gap -- --task M16-GAP-00073` |

 领取前执行：

--- a/docs/status/M16-GAP-00072.md
+++ b/docs/status/M16-GAP-00072.md
@@ -0,0 +1,18 @@
+# M16-GAP-00072 Status
+
+status: done
+task: HOOK modifier LOCAL_EXACT slice
+updated: 2026-08-20 America/New_York
+
+scope: Mesh HOOK modifier stack exposure for `object:WebGapHookObject`.
+
+evidence:
+
+- Desktop fixture exposes `WebGapHook`; save/reopen is exact.
+- WASM/Main exposes HOOK type code 9 with metadata parameters on the mesh scene node.
+- Malformed Blend input is rejected without mutating Main.
+- Generator, npm comparator, and direct comparator exited 0.
+
+knownRisk: Hook deformation evaluation remains metadata-only; this slice covers modifier stack transport and parameter metadata.
+
+nextTask: `M16-GAP-00073`
--- a/docs/tasks/M16-GAP-00073.md
+++ b/docs/tasks/M16-GAP-00073.md
@@ -0,0 +1,37 @@
+# M16-GAP-00073: modifier:LAPLACIANDEFORM LOCAL_EXACT slice
+
+- task: M16-GAP-00073
+- parent: M16-GAP-00072
+- status: in_progress
+- gap: modifier:LAPLACIANDEFORM
+- ownerFamily: MODIFIER
+- targetImplementationClass: LOCAL_EXACT
+
+## 目标
+
+Make the same minimal fixture produce observable modifier:LAPLACIANDEFORM 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-00073-modifier-LAPLACIANDEFORM.blend`
+- Generator: `tools/web/generated/M16-GAP-00073.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-00073.py -- tests/files/web/generated/M16-GAP-00073-modifier-LAPLACIANDEFORM.blend
+npm --prefix web run test:generated-gap -- --task M16-GAP-00073
+node tools/web/check-generated-gap.mjs --task M16-GAP-00073
+
+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-00073/`
+- Status: `docs/status/M16-GAP-00073.md`
+- Manifest: `tests/golden/M16-GAP-00073/manifest.json`
+- Handoff: `node tools/web/check-task-context.mjs --task M16-GAP-00073 --write`
+- Rollback: remove this task production entry, fixture, tests, reports, manifest, status, and context; restore the parent as queue tail without rewriting parent evidence.
--- a/tests/files/web/generated/M16-GAP-00072-modifier-HOOK.blend
+++ b/tests/files/web/generated/M16-GAP-00072-modifier-HOOK.blend
--- a/tests/golden/M15-03A/next-task-plan.json
+++ b/tests/golden/M15-03A/next-task-plan.json
@@ -1671,7 +1671,7 @@
      "gapId": "modifier:HOOK",
      "ownerFamily": "MODIFIER",
      "sourceTask": "M15-01C",
-      "state": "active",
+      "state": "completed",
      "dependencies": [],
      "targetImplementationClass": "LOCAL_EXACT",
      "fixture": {
@@ -1694,7 +1694,7 @@
      "gapId": "modifier:LAPLACIANDEFORM",
      "ownerFamily": "MODIFIER",
      "sourceTask": "M15-01C",
-      "state": "pending",
+      "state": "active",
      "dependencies": [],
      "targetImplementationClass": "LOCAL_EXACT",
      "fixture": {
@@ -158734,7 +158734,7 @@
      ]
    }
  ],
-  "firstTask": "M16-GAP-00072",
+  "firstTask": "M16-GAP-00073",
  "closureGate": "M15-03E",
  "nextTask": "M15-03B"
 }
--- a/tests/golden/M15-03A/task-catalog.jsonl
+++ b/tests/golden/M15-03A/task-catalog.jsonl
@@ -69,8 +69,8 @@
 {"id":"M16-GAP-00069","gapId":"modifier:GREASE_PENCIL_TINT","ownerFamily":"MODIFIER","sourceTask":"M15-01C","state":"completed","targetImplementationClass":"LOCAL_EXACT"}
 {"id":"M16-GAP-00070","gapId":"modifier:GREASE_PENCIL_VERTEX_WEIGHT_ANGLE","ownerFamily":"MODIFIER","sourceTask":"M15-01C","state":"completed","targetImplementationClass":"LOCAL_EXACT"}
 {"id":"M16-GAP-00071","gapId":"modifier:GREASE_PENCIL_VERTEX_WEIGHT_PROXIMITY","ownerFamily":"MODIFIER","sourceTask":"M15-01C","state":"completed","targetImplementationClass":"LOCAL_EXACT"}
-{"id":"M16-GAP-00072","gapId":"modifier:HOOK","ownerFamily":"MODIFIER","sourceTask":"M15-01C","state":"active","targetImplementationClass":"LOCAL_EXACT"}
-{"id":"M16-GAP-00073","gapId":"modifier:LAPLACIANDEFORM","ownerFamily":"MODIFIER","sourceTask":"M15-01C","state":"pending","targetImplementationClass":"LOCAL_EXACT"}
+{"id":"M16-GAP-00072","gapId":"modifier:HOOK","ownerFamily":"MODIFIER","sourceTask":"M15-01C","state":"completed","targetImplementationClass":"LOCAL_EXACT"}
+{"id":"M16-GAP-00073","gapId":"modifier:LAPLACIANDEFORM","ownerFamily":"MODIFIER","sourceTask":"M15-01C","state":"active","targetImplementationClass":"LOCAL_EXACT"}
 {"id":"M16-GAP-00074","gapId":"modifier:LAPLACIANSMOOTH","ownerFamily":"MODIFIER","sourceTask":"M15-01C","state":"pending","targetImplementationClass":"LOCAL_EXACT"}
 {"id":"M16-GAP-00075","gapId":"modifier:LATTICE","ownerFamily":"MODIFIER","sourceTask":"M15-01C","state":"pending","targetImplementationClass":"LOCAL_EXACT"}
 {"id":"M16-GAP-00076","gapId":"modifier:LINEART","ownerFamily":"MODIFIER","sourceTask":"M15-01C","state":"pending","targetImplementationClass":"LOCAL_EXACT"}
--- a/tests/golden/M15-03A/task-index.json
+++ b/tests/golden/M15-03A/task-index.json
--- a/tests/golden/M16-GAP-00072/hook-modifier-desktop-report.json
+++ b/tests/golden/M16-GAP-00072/hook-modifier-desktop-report.json
@@ -0,0 +1,23 @@
+{
+  "blenderVersion": "5.2.0 LTS",
+  "fixture": "/home/mes123456/workinf_Blender_Wasm/tests/files/web/generated/M16-GAP-00072-modifier-HOOK.blend",
+  "fixtureSha256": "9fee2803c1400f07d4a58fb05a708b8e5bdf878820d636c57cecbb6deda9adec",
+  "modifier": {
+    "meshId": "mesh:WebGapHookObjectMesh",
+    "modifier": {
+      "name": "WebGapHook",
+      "showEditMode": false,
+      "showOnCage": false,
+      "showRender": true,
+      "showViewport": true,
+      "type": "HOOK",
+      "typeCode": 9
+    },
+    "objectId": "object:WebGapHookObject",
+    "task": "M16-GAP-00072"
+  },
+  "operation": "HOOK_MODIFIER_DESKTOP",
+  "saveReopen": "EXACT",
+  "schemaVersion": 1,
+  "task": "M16-GAP-00072"
+}
--- a/tests/golden/M16-GAP-00072/hook-modifier-local-exact-report.json
+++ b/tests/golden/M16-GAP-00072/hook-modifier-local-exact-report.json
@@ -0,0 +1,47 @@
+{
+  "schemaVersion": 1,
+  "task": "M16-GAP-00072",
+  "operation": "HOOK_MODIFIER_LOCAL_EXACT",
+  "fixture": {
+    "path": "tests/files/web/generated/M16-GAP-00072-modifier-HOOK.blend",
+    "sha256": "9fee2803c1400f07d4a58fb05a708b8e5bdf878820d636c57cecbb6deda9adec"
+  },
+  "desktop": {
+    "status": "EXACT",
+    "report": "tests/golden/M16-GAP-00072/hook-modifier-desktop-report.json",
+    "saveReopen": "EXACT"
+  },
+  "wasm": {
+    "status": "EXACT",
+    "objectId": "object:WebGapHookObject",
+    "meshId": "mesh:WebGapHookObjectMesh",
+    "modifier": {
+      "dependsOn": [],
+      "enabled": true,
+      "evaluationStatus": "METADATA_ONLY",
+      "name": "WebGapHook",
+      "parameters": {
+        "falloff": 0,
+        "falloffType": 3,
+        "flag": 5,
+        "force": 1,
+        "mode": 3,
+        "persistentUid": 1366665389,
+        "subtarget": "",
+        "typeCode": 9,
+        "vertexGroup": ""
+      },
+      "showEditMode": false,
+      "showOnCage": false,
+      "showRender": true,
+      "showViewport": true,
+      "type": "HOOK",
+      "uuid": "modifier:object:WebGapHookObject:1366665389"
+    }
+  },
+  "saveReopen": "EXACT",
+  "negative": {
+    "malformedBlend": "REJECTED_WITHOUT_MAIN_MUTATION"
+  },
+  "nextTask": "M16-GAP-00073"
+}
--- a/tests/golden/M16-GAP-00072/manifest.json
+++ b/tests/golden/M16-GAP-00072/manifest.json
@@ -0,0 +1,24 @@
+{
+  "schemaVersion": 1,
+  "task": "M16-GAP-00072",
+  "parentTask": "M16-GAP-00071",
+  "enablingTask": false,
+  "parityStateChange": true,
+  "runtime": "BLENDER_5_2_LOCAL_EXACT",
+  "operation": "HOOK_MODIFIER_LOCAL_EXACT",
+  "status": "done",
+  "artifacts": {
+    "parentManifest": {"path": "tests/golden/M16-GAP-00071/manifest.json", "sha256": "4415489e0e4d4ca2e5a81de4e74a9c17dcad65f94b30a95557c168ec1b0af9f7"},
+    "fixture": {"path": "tests/files/web/generated/M16-GAP-00072-modifier-HOOK.blend", "sha256": "9fee2803c1400f07d4a58fb05a708b8e5bdf878820d636c57cecbb6deda9adec"},
+    "generator": {"path": "tools/web/generated/M16-GAP-00072.py", "sha256": "239d1ec0c9cb68b93e48becd7451a80fcbead84430cb3de2fb7545a9da658bcf"},
+    "desktopChecker": {"path": "tools/web/check-generic-modifier-desktop.py", "sha256": "3a372e870f14c4559ee921aef1fbe086eccd609a0af5917e5b4872468ca22e51"},
+    "webChecker": {"path": "tools/web/check-generated-gap.mjs", "sha256": "a97a8b1b243dcf8ec6506280cc0c6e33a4c89f28b40f6b44b99a470fdf705224"},
+    "reader": {"path": "blender-5.2.0/source/blender/web_engine/web_engine_blend_reader.cpp", "sha256": "58cdbe34c1b5c3bd8b0f8ef5144ae8f1b6af8ff51a336862a9001bff79cec82b"},
+    "wasm": {"path": "web/app/src/vendor/blender/web_engine.wasm", "sha256": "90fa485cd6cc28d08e8f7ac8433f2e1ee1a88503ed6358d25ffea6f6ad18e5fb"},
+    "wasmPublic": {"path": "web/app/public/vendor/blender/web_engine.wasm", "sha256": "90fa485cd6cc28d08e8f7ac8433f2e1ee1a88503ed6358d25ffea6f6ad18e5fb"},
+    "wasmJs": {"path": "web/app/src/vendor/blender/web_engine.js", "sha256": "9c831d0351ac9d0714cce3b1da748cba416ced3086e3c59595cf24ac4da459ed"},
+    "desktopReport": {"path": "tests/golden/M16-GAP-00072/hook-modifier-desktop-report.json", "sha256": "819375aad6fbf6814a1fe85802472d12df216a205067f5ee0e132a8d383f247d"},
+    "webReport": {"path": "tests/golden/M16-GAP-00072/hook-modifier-local-exact-report.json", "sha256": "929d2a3e679e4972149ffac8ff1a7d692452cb9b1029418eea86434aa8d4c6d1"}
+  },
+  "nextTask": "M16-GAP-00073"
+}
--- a/tools/web/check-generated-gap.mjs
+++ b/tools/web/check-generated-gap.mjs
@@ -1099,6 +1099,7 @@ const genericModifierTasks = {
  "M16-GAP-00069": { type: "GREASE_PENCIL_TINT", stem: "WebGapGreasePencilTint", objectName: "GreasePencilObject", nextTask: "M16-GAP-00070" },
  "M16-GAP-00070": { type: "GREASE_PENCIL_VERTEX_WEIGHT_ANGLE", stem: "WebGapGreasePencilVertexWeightAngle", objectName: "GreasePencilObject", nextTask: "M16-GAP-00071" },
  "M16-GAP-00071": { type: "GREASE_PENCIL_VERTEX_WEIGHT_PROXIMITY", stem: "WebGapGreasePencilVertexWeightProximity", objectName: "GreasePencilObject", nextTask: "M16-GAP-00072" },
+  "M16-GAP-00072": { type: "HOOK", stem: "WebGapHook", nextTask: "M16-GAP-00073" },
 };
 if (genericModifierTasks[task]) {
  const config = genericModifierTasks[task];
--- a/tools/web/generated/M16-GAP-00072.py
+++ b/tools/web/generated/M16-GAP-00072.py
@@ -0,0 +1,13 @@
+#!/usr/bin/env python3
+import pathlib
+import sys
+
+sys.path.insert(0, str(pathlib.Path(__file__).resolve().parent))
+from modifier_gap_fixture import generate
+
+
+if __name__ == "__main__":
+    arguments = sys.argv[sys.argv.index("--") + 1:]
+    if len(arguments) != 1:
+        raise SystemExit("usage: blender -b --python M16-GAP-00072.py -- OUTPUT")
+    generate(pathlib.Path(arguments[0]), "HOOK", "WebGapHook")