Govern task context and advance execution pointer

2026-08-20 06:02:43 -04:00
parent 380cbed4ff
commit 10640aeb3c
984 changed files with 543475 additions and 327 deletions
--- a/tests/golden/M16-GAP-00013/manifest.json
+++ b/tests/golden/M16-GAP-00013/manifest.json
@@ -0,0 +1,57 @@
+{
+  "schemaVersion": 1,
+  "task": "M16-GAP-00013",
+  "parentTask": "M16-GAP-00012",
+  "enablingTask": false,
+  "parityStateChange": true,
+  "runtime": "BLENDER_5_2_LOCAL_EXACT",
+  "operation": "MATERIAL_DATABLOCK_LOCAL_EXACT",
+  "status": "done",
+  "artifacts": {
+    "parentManifest": {
+      "path": "tests/golden/M16-GAP-00012/manifest.json",
+      "sha256": "c71a0d9e23d13bf51a190c99f16e4e7e98da1f12cba50f2404bef8fcb6e94d4c"
+    },
+    "fixture": {
+      "path": "tests/files/web/generated/M16-GAP-00013-datablock-Material.blend",
+      "sha256": "e17880024b28e0fbc8fac5b815a2c673fe11d5000cb1d23a794cdc3d83658d76"
+    },
+    "generator": {
+      "path": "tools/web/generated/M16-GAP-00013.py",
+      "sha256": "bb04dd1da461e061c27be9d4e160b2787026855198661e72ff4fee802b72c817"
+    },
+    "desktopChecker": {
+      "path": "tools/web/check-material-desktop.py",
+      "sha256": "42a870bb79eceb8e1789686db689842dfe390d58db2744fded8dd571fe9cd8f5"
+    },
+    "webChecker": {
+      "path": "tools/web/check-generated-gap.mjs",
+      "sha256": "e0e510273337e56435cf44adef246ff5bf12d6857691376ac2aacf6a4fc79ed8"
+    },
+    "reader": {
+      "path": "blender-5.2.0/source/blender/web_engine/web_engine_blend_reader.cpp",
+      "sha256": "3c2c69a66d60692049956530c2570db377e5d10838d0048aa4e0f3fb210f9c62"
+    },
+    "protocol": {
+      "path": "web/protocol/scene-ir.ts",
+      "sha256": "7d96e706de6b42f4372d937708600be150190ae593e214066a06d030bcac8b73"
+    },
+    "wasm": {
+      "path": "web/app/src/vendor/blender/web_engine.wasm",
+      "sha256": "4a33528e8bd4d50956e741cba93ab0215350943c59f56b7c82e18df19f4ee450"
+    },
+    "wasmJs": {
+      "path": "web/app/src/vendor/blender/web_engine.js",
+      "sha256": "9c831d0351ac9d0714cce3b1da748cba416ced3086e3c59595cf24ac4da459ed"
+    },
+    "desktopReport": {
+      "path": "tests/golden/M16-GAP-00013/material-desktop-report.json",
+      "sha256": "7adfdd70f9b116268301e0bb6cf7e0b88cf8eb2ab20d25c944586df3a9cc000c"
+    },
+    "webReport": {
+      "path": "tests/golden/M16-GAP-00013/material-local-exact-report.json",
+      "sha256": "229f3fc85518da4539e311e6ca70fd6b156cdcc9ae4c4b901e0de5c895b3d333"
+    }
+  },
+  "nextTask": "M16-GAP-00014"
+}
--- a/tests/golden/M16-GAP-00013/material-desktop-report.json
+++ b/tests/golden/M16-GAP-00013/material-desktop-report.json
@@ -0,0 +1,39 @@
+{
+  "blenderVersion": "5.2.0 LTS",
+  "fixture": "/home/mes123456/workinf_Blender_Wasm/tests/files/web/generated/M16-GAP-00013-datablock-Material.blend",
+  "fixtureSha256": "e17880024b28e0fbc8fac5b815a2c673fe11d5000cb1d23a794cdc3d83658d76",
+  "material": {
+    "alpha": 0.9,
+    "baseColor": [
+      0.2,
+      0.4,
+      0.8,
+      0.9
+    ],
+    "coatRoughness": 0.12,
+    "coatWeight": 0.64,
+    "emissionColor": [
+      0.05,
+      0.1,
+      0.2,
+      1.0
+    ],
+    "emissionStrength": 3.5,
+    "id": "material:WebGapMaterial",
+    "ior": 1.6,
+    "linkCount": 1,
+    "metallic": 0.35,
+    "name": "WebGapMaterial",
+    "nodeTypes": [
+      "ShaderNodeBsdfPrincipled",
+      "ShaderNodeOutputMaterial"
+    ],
+    "roughness": 0.6,
+    "specularIORLevel": 0.35,
+    "transmissionWeight": 0.27
+  },
+  "operation": "MATERIAL_DATABLOCK_DESKTOP",
+  "saveReopen": "EXACT",
+  "schemaVersion": 1,
+  "task": "M16-GAP-00013"
+}
--- a/tests/golden/M16-GAP-00013/material-local-exact-report.json
+++ b/tests/golden/M16-GAP-00013/material-local-exact-report.json
@@ -0,0 +1,26 @@
+{
+  "schemaVersion": 1,
+  "task": "M16-GAP-00013",
+  "operation": "MATERIAL_DATABLOCK_LOCAL_EXACT",
+  "fixture": {
+    "path": "tests/files/web/generated/M16-GAP-00013-datablock-Material.blend",
+    "sha256": "e17880024b28e0fbc8fac5b815a2c673fe11d5000cb1d23a794cdc3d83658d76"
+  },
+  "desktop": {
+    "status": "EXACT",
+    "report": "tests/golden/M16-GAP-00013/material-desktop-report.json",
+    "saveReopen": "EXACT"
+  },
+  "wasm": {
+    "status": "EXACT",
+    "materialId": "material:WebGapMaterial",
+    "shaderGraphHash": "6c4cc2b22454e1cc33d19d77aeab827415c4b90304d8113d0bbb4c70ac862a3a",
+    "nodeCount": 2,
+    "linkCount": 1
+  },
+  "saveReopen": "EXACT",
+  "negative": {
+    "malformedBlend": "REJECTED_WITHOUT_MAIN_MUTATION"
+  },
+  "nextTask": "M16-GAP-00014"
+}
--- a/tests/golden/M16-GAP-00013/task-context.json
+++ b/tests/golden/M16-GAP-00013/task-context.json
@@ -0,0 +1,124 @@
+{
+  "schemaVersion": 1,
+  "task": "M16-GAP-00013",
+  "parentTask": "M16-GAP-00012",
+  "status": "in_progress",
+  "goal": "Make the same minimal fixture produce observable datablock:Material 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.",
+  "scope": {
+    "gap": "datablock:Material",
+    "ownerFamily": "RNA_DATABLOCK",
+    "implementationClass": "LOCAL_EXACT"
+  },
+  "commands": [
+    "build_blender_5.2.0/bin/blender -b --factory-startup --python tools/web/generated/M16-GAP-00013.py -- tests/files/web/generated/M16-GAP-00013-datablock-Material.blend",
+    "npm --prefix web run test:generated-gap -- --task M16-GAP-00013",
+    "node tools/web/check-generated-gap.mjs --task M16-GAP-00013"
+  ],
+  "inputPaths": [
+    "tests/files/web/generated/M16-GAP-00013-datablock-Material.blend",
+    "tools/web/generated/M16-GAP-00013.py",
+    "blender-5.2.0/source/blender/web_engine/web_engine_blend_reader.cpp",
+    "tools/web/check-generated-gap.mjs",
+    "tests/golden/M16-GAP-00013/",
+    "docs/status/M16-GAP-00013.md",
+    "tests/golden/M16-GAP-00013/manifest.json"
+  ],
+  "exitCriteria": [
+    "desktop fixture evidence exists",
+    "WASM uses the same fixture",
+    "comparator passes",
+    "save/reopen preserves Main",
+    "manifest hashes all artifacts"
+  ],
+  "nextTask": "M16-GAP-00014",
+  "sourceDocuments": {
+    "queue": "docs/EXECUTION_QUEUE.md",
+    "taskCard": "docs/tasks/M16-GAP-00013.md",
+    "taskIndex": "tests/golden/M15-03A/task-index.json",
+    "parentManifest": "tests/golden/M16-GAP-00012/manifest.json",
+    "parentStatus": "docs/status/M16-GAP-00012.md"
+  },
+  "readPolicy": {
+    "required": [
+      "docs/EXECUTION_QUEUE.md",
+      "docs/tasks/M16-GAP-00013.md",
+      "tests/golden/M16-GAP-00012/manifest.json",
+      "docs/status/M16-GAP-00012.md"
+    ],
+    "machineOnly": [
+      "tests/golden/M15-03A/task-index.json",
+      "tests/golden/M15-03A/task-catalog.jsonl"
+    ],
+    "optionalByNeed": [
+      "docs/WEB_BLENDER_MODELER_V1_SCOPE.md",
+      "任务卡列出的精确协议/生产路径",
+      "任务卡明确命名的长期计划小节"
+    ],
+    "forbiddenByDefault": [
+      "完整 CURRENT_EXECUTION_PLAN.md",
+      "完整 PROJECT_STATUS_AND_NEXT_WORK.md",
+      "全部 docs/status/*.md",
+      "完整 parity/WBS 计划",
+      "README 历史和 test-results/"
+    ]
+  },
+  "parent": {
+    "manifest": {
+      "schemaVersion": 1,
+      "task": "M16-GAP-00012",
+      "parentTask": "M16-GAP-00011",
+      "status": "done",
+      "nextTask": "M16-GAP-00013",
+      "artifactCount": 11
+    },
+    "statusSummary": [
+      "# M16-GAP-00012 Status",
+      "status: done  ",
+      "task: Light data-block LOCAL_EXACT slice  ",
+      "updated: 2026-08-19 America/New_York",
+      "scope: Blender 5.2 Area Light metadata: type, color, energy, exposure, temperature, temperature enablement, shadow flag, radius, area shape/size/spread and bounded default spot/sun fields.",
+      "evidence:",
+      "- `tools/web/generated/M16-GAP-00012.py` generated a single `WebGapLight` Area Light fixture with deterministic RNA values.",
+      "- Desktop report reopened the fixture after save and matched exactly, including Light type 4, rectangle shape 1, color `[0.25, 0.5, 0.75]`, energy 400, exposure 1, temperature 5000, area size 3x2 and spread 2.4."
+    ]
+  },
+  "budgets": {
+    "queueBytes": 4096,
+    "taskBytes": 1739,
+    "parentManifestBytes": 24576,
+    "parentStatusBytes": 6144,
+    "contextTokens": 3500,
+    "taskLines": 38,
+    "taskTokens": 428
+  },
+  "size": {
+    "documents": [
+      {
+        "path": "docs/EXECUTION_QUEUE.md",
+        "bytes": 1969,
+        "lines": 41,
+        "tokens": 321
+      },
+      {
+        "path": "docs/tasks/M16-GAP-00013.md",
+        "bytes": 1739,
+        "lines": 38,
+        "tokens": 428
+      },
+      {
+        "path": "tests/golden/M16-GAP-00012/manifest.json",
+        "bytes": 2178,
+        "lines": 58,
+        "tokens": 545
+      },
+      {
+        "path": "docs/status/M16-GAP-00012.md",
+        "bytes": 1837,
+        "lines": 26,
+        "tokens": 460
+      }
+    ],
+    "totalTokens": 1754,
+    "withinBudget": true
+  }
+}