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-00016/manifest.json
+++ b/tests/golden/M16-GAP-00016/manifest.json
@@ -0,0 +1,57 @@
+{
+  "schemaVersion": 1,
+  "task": "M16-GAP-00016",
+  "parentTask": "M16-GAP-00015",
+  "enablingTask": false,
+  "parityStateChange": true,
+  "runtime": "BLENDER_5_2_LOCAL_EXACT",
+  "operation": "NODETREE_DATABLOCK_LOCAL_EXACT",
+  "status": "done",
+  "artifacts": {
+    "parentManifest": {
+      "path": "tests/golden/M16-GAP-00015/manifest.json",
+      "sha256": "641d43e8184dd710fb5dc5a7278e943c3f8bc70287abda6f5cb5afc5a56bbb7c"
+    },
+    "fixture": {
+      "path": "tests/files/web/generated/M16-GAP-00016-datablock-NodeTree.blend",
+      "sha256": "7075a345a9991d456fc2c6cc68b3a836fc837dbfd99328173f0018b59e0e483c"
+    },
+    "generator": {
+      "path": "tools/web/generated/M16-GAP-00016.py",
+      "sha256": "12033eb9f1ef9f09fe86135259382e7cc938928c23a89b637d39e8e36c51982e"
+    },
+    "desktopChecker": {
+      "path": "tools/web/check-nodetree-desktop.py",
+      "sha256": "e0fa9c2dbe5f9877c00c33d83e5aa2407606a003163be086a082e631da3cd9a5"
+    },
+    "webChecker": {
+      "path": "tools/web/check-generated-gap.mjs",
+      "sha256": "942362700a8e76db689a57004024b1042ac2b796a225f0b31a25b93dc78e490d"
+    },
+    "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-00016/nodetree-desktop-report.json",
+      "sha256": "b1a6608a41fdbbaeb670dfc0222fbef3b6b73e3728add751564194dda1eb2924"
+    },
+    "webReport": {
+      "path": "tests/golden/M16-GAP-00016/nodetree-local-exact-report.json",
+      "sha256": "8df89df7ef013b8eed71c19e748eff6b7288772a10f139306a87cb2431eb26b3"
+    }
+  },
+  "nextTask": "M16-GAP-00017"
+}
--- a/tests/golden/M16-GAP-00016/nodetree-desktop-report.json
+++ b/tests/golden/M16-GAP-00016/nodetree-desktop-report.json
@@ -0,0 +1,38 @@
+{
+  "blenderVersion": "5.2.0 LTS",
+  "fixture": "/home/mes123456/workinf_Blender_Wasm/tests/files/web/generated/M16-GAP-00016-datablock-NodeTree.blend",
+  "fixtureSha256": "7075a345a9991d456fc2c6cc68b3a836fc837dbfd99328173f0018b59e0e483c",
+  "nodeTree": {
+    "id": "nodetree:WebGapNodeTreeMaterial",
+    "linkCount": 2,
+    "links": [
+      [
+        "ShaderNodeBsdfPrincipled",
+        "BSDF",
+        "ShaderNodeOutputMaterial",
+        "Surface"
+      ],
+      [
+        "ShaderNodeRGB",
+        "Color",
+        "ShaderNodeBsdfPrincipled",
+        "Base Color"
+      ]
+    ],
+    "name": "Shader Nodetree",
+    "nodeNames": [
+      "Material Output",
+      "Principled BSDF",
+      "WebGapRGB"
+    ],
+    "nodeTypes": [
+      "ShaderNodeBsdfPrincipled",
+      "ShaderNodeOutputMaterial",
+      "ShaderNodeRGB"
+    ]
+  },
+  "operation": "NODETREE_DATABLOCK_DESKTOP",
+  "saveReopen": "EXACT",
+  "schemaVersion": 1,
+  "task": "M16-GAP-00016"
+}
--- a/tests/golden/M16-GAP-00016/nodetree-local-exact-report.json
+++ b/tests/golden/M16-GAP-00016/nodetree-local-exact-report.json
@@ -0,0 +1,26 @@
+{
+  "schemaVersion": 1,
+  "task": "M16-GAP-00016",
+  "operation": "NODETREE_DATABLOCK_LOCAL_EXACT",
+  "fixture": {
+    "path": "tests/files/web/generated/M16-GAP-00016-datablock-NodeTree.blend",
+    "sha256": "7075a345a9991d456fc2c6cc68b3a836fc837dbfd99328173f0018b59e0e483c"
+  },
+  "desktop": {
+    "status": "EXACT",
+    "report": "tests/golden/M16-GAP-00016/nodetree-desktop-report.json",
+    "saveReopen": "EXACT"
+  },
+  "wasm": {
+    "status": "EXACT",
+    "nodeTreeId": "nodetree:WebGapNodeTreeMaterial",
+    "nodeCount": 3,
+    "linkCount": 2,
+    "shaderGraphHash": "0c983ebf5de333f8314784b3a05483d222c3808db825e606620fa6df64c45a60"
+  },
+  "saveReopen": "EXACT",
+  "negative": {
+    "malformedBlend": "REJECTED_WITHOUT_MAIN_MUTATION"
+  },
+  "nextTask": "M16-GAP-00017"
+}
--- a/tests/golden/M16-GAP-00016/task-context.json
+++ b/tests/golden/M16-GAP-00016/task-context.json
@@ -0,0 +1,124 @@
+{
+  "schemaVersion": 1,
+  "task": "M16-GAP-00016",
+  "parentTask": "M16-GAP-00015",
+  "status": "in_progress",
+  "goal": "Make the same minimal fixture produce observable datablock:NodeTree 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:NodeTree",
+    "ownerFamily": "RNA_DATABLOCK",
+    "implementationClass": "LOCAL_EXACT"
+  },
+  "commands": [
+    "build_blender_5.2.0/bin/blender -b --factory-startup --python tools/web/generated/M16-GAP-00016.py -- tests/files/web/generated/M16-GAP-00016-datablock-NodeTree.blend",
+    "npm --prefix web run test:generated-gap -- --task M16-GAP-00016",
+    "node tools/web/check-generated-gap.mjs --task M16-GAP-00016"
+  ],
+  "inputPaths": [
+    "tests/files/web/generated/M16-GAP-00016-datablock-NodeTree.blend",
+    "tools/web/generated/M16-GAP-00016.py",
+    "blender-5.2.0/source/blender/web_engine/web_engine_blend_reader.cpp",
+    "tools/web/check-generated-gap.mjs",
+    "tests/golden/M16-GAP-00016/",
+    "docs/status/M16-GAP-00016.md",
+    "tests/golden/M16-GAP-00016/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-00017",
+  "sourceDocuments": {
+    "queue": "docs/EXECUTION_QUEUE.md",
+    "taskCard": "docs/tasks/M16-GAP-00016.md",
+    "taskIndex": "tests/golden/M15-03A/task-index.json",
+    "parentManifest": "tests/golden/M16-GAP-00015/manifest.json",
+    "parentStatus": "docs/status/M16-GAP-00015.md"
+  },
+  "readPolicy": {
+    "required": [
+      "docs/EXECUTION_QUEUE.md",
+      "docs/tasks/M16-GAP-00016.md",
+      "tests/golden/M16-GAP-00015/manifest.json",
+      "docs/status/M16-GAP-00015.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-00015",
+      "parentTask": "M16-GAP-00014",
+      "status": "done",
+      "nextTask": "M16-GAP-00016",
+      "artifactCount": 11
+    },
+    "statusSummary": [
+      "# M16-GAP-00015 Status",
+      "status: done  ",
+      "task: MetaBall data-block LOCAL_EXACT slice  ",
+      "updated: 2026-08-19 America/New_York",
+      "scope: Blender 5.2 MetaBall element metadata: point count, element positions, radii and anisotropic scale values.",
+      "evidence:",
+      "- `tools/web/generated/M16-GAP-00015.py` generated one `WebGapMetaBall` data-block with two deterministic elements and a linked object.",
+      "- Desktop report reopened after save and matched exactly: two elements at `[-0.65, 0, 0.4]` and `[0.65, 0, 0.4]`, radii 0.75/0.55 and scales 1.1/0.9/1.2 and 0.8/1.05/0.95."
+    ]
+  },
+  "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-00016.md",
+        "bytes": 1739,
+        "lines": 38,
+        "tokens": 428
+      },
+      {
+        "path": "tests/golden/M16-GAP-00015/manifest.json",
+        "bytes": 2193,
+        "lines": 58,
+        "tokens": 549
+      },
+      {
+        "path": "docs/status/M16-GAP-00015.md",
+        "bytes": 1719,
+        "lines": 26,
+        "tokens": 430
+      }
+    ],
+    "totalTokens": 1728,
+    "withinBudget": true
+  }
+}