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-00017/manifest.json
+++ b/tests/golden/M16-GAP-00017/manifest.json
@@ -0,0 +1,57 @@
+{
+  "schemaVersion": 1,
+  "task": "M16-GAP-00017",
+  "parentTask": "M16-GAP-00016",
+  "enablingTask": false,
+  "parityStateChange": true,
+  "runtime": "BLENDER_5_2_LOCAL_EXACT",
+  "operation": "OBJECT_DATABLOCK_LOCAL_EXACT",
+  "status": "done",
+  "artifacts": {
+    "parentManifest": {
+      "path": "tests/golden/M16-GAP-00016/manifest.json",
+      "sha256": "8d66f1e936cb08b6991465c795c12e7fa65ac0b9ae166eceec5aada32162fb10"
+    },
+    "fixture": {
+      "path": "tests/files/web/generated/M16-GAP-00017-datablock-Object.blend",
+      "sha256": "527eefc6ea01671a21634a3191790a8228038dd72a0744b6f00969be048e36ef"
+    },
+    "generator": {
+      "path": "tools/web/generated/M16-GAP-00017.py",
+      "sha256": "64bb9f488573946dcf7d2358bd5d5f540055bb2813942e98ed154da179cb201b"
+    },
+    "desktopChecker": {
+      "path": "tools/web/check-object-desktop.py",
+      "sha256": "3cb263b0bd2606cdce38bd433f90d50e738e93bf482c9fd16217306efb1521c0"
+    },
+    "webChecker": {
+      "path": "tools/web/check-generated-gap.mjs",
+      "sha256": "b4a5475d503e53f1405a5c3339d231947151b85f3b98e1072f811422d5385f99"
+    },
+    "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-00017/object-desktop-report.json",
+      "sha256": "6c9b16af1d114b00df2711b095778eef239c27b55588063d68872434f08631fd"
+    },
+    "webReport": {
+      "path": "tests/golden/M16-GAP-00017/object-local-exact-report.json",
+      "sha256": "38fbe19a794e05d1a05c0df5de7fca919c229c179ac59c452df08cc0c827ca91"
+    }
+  },
+  "nextTask": "M16-GAP-00018"
+}
--- a/tests/golden/M16-GAP-00017/object-desktop-report.json
+++ b/tests/golden/M16-GAP-00017/object-desktop-report.json
@@ -0,0 +1,32 @@
+{
+  "blenderVersion": "5.2.0 LTS",
+  "fixture": "/home/mes123456/workinf_Blender_Wasm/tests/files/web/generated/M16-GAP-00017-datablock-Object.blend",
+  "fixtureSha256": "527eefc6ea01671a21634a3191790a8228038dd72a0744b6f00969be048e36ef",
+  "object": {
+    "id": "object:WebGapObject",
+    "location": [
+      1.25,
+      -2.5,
+      3.75
+    ],
+    "name": "WebGapObject",
+    "parent": null,
+    "rotationEuler": [
+      0.2,
+      -0.35,
+      0.5
+    ],
+    "scale": [
+      1.5,
+      0.75,
+      2.0
+    ],
+    "selectable": true,
+    "type": "EMPTY",
+    "visible": true
+  },
+  "operation": "OBJECT_DATABLOCK_DESKTOP",
+  "saveReopen": "EXACT",
+  "schemaVersion": 1,
+  "task": "M16-GAP-00017"
+}
--- a/tests/golden/M16-GAP-00017/object-local-exact-report.json
+++ b/tests/golden/M16-GAP-00017/object-local-exact-report.json
@@ -0,0 +1,34 @@
+{
+  "schemaVersion": 1,
+  "task": "M16-GAP-00017",
+  "operation": "OBJECT_DATABLOCK_LOCAL_EXACT",
+  "fixture": {
+    "path": "tests/files/web/generated/M16-GAP-00017-datablock-Object.blend",
+    "sha256": "527eefc6ea01671a21634a3191790a8228038dd72a0744b6f00969be048e36ef"
+  },
+  "desktop": {
+    "status": "EXACT",
+    "report": "tests/golden/M16-GAP-00017/object-desktop-report.json",
+    "saveReopen": "EXACT"
+  },
+  "wasm": {
+    "status": "EXACT",
+    "objectId": "object:WebGapObject",
+    "type": "EMPTY",
+    "translation": [
+      1.25,
+      -2.5,
+      3.75
+    ],
+    "scale": [
+      1.5,
+      0.75,
+      2
+    ]
+  },
+  "saveReopen": "EXACT",
+  "negative": {
+    "malformedBlend": "REJECTED_WITHOUT_MAIN_MUTATION"
+  },
+  "nextTask": "M16-GAP-00018"
+}
--- a/tests/golden/M16-GAP-00017/task-context.json
+++ b/tests/golden/M16-GAP-00017/task-context.json
@@ -0,0 +1,124 @@
+{
+  "schemaVersion": 1,
+  "task": "M16-GAP-00017",
+  "parentTask": "M16-GAP-00016",
+  "status": "in_progress",
+  "goal": "Make the same minimal fixture produce observable datablock:Object 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:Object",
+    "ownerFamily": "RNA_DATABLOCK",
+    "implementationClass": "LOCAL_EXACT"
+  },
+  "commands": [
+    "build_blender_5.2.0/bin/blender -b --factory-startup --python tools/web/generated/M16-GAP-00017.py -- tests/files/web/generated/M16-GAP-00017-datablock-Object.blend",
+    "npm --prefix web run test:generated-gap -- --task M16-GAP-00017",
+    "node tools/web/check-generated-gap.mjs --task M16-GAP-00017"
+  ],
+  "inputPaths": [
+    "tests/files/web/generated/M16-GAP-00017-datablock-Object.blend",
+    "tools/web/generated/M16-GAP-00017.py",
+    "blender-5.2.0/source/blender/web_engine/web_engine_blend_reader.cpp",
+    "tools/web/check-generated-gap.mjs",
+    "tests/golden/M16-GAP-00017/",
+    "docs/status/M16-GAP-00017.md",
+    "tests/golden/M16-GAP-00017/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-00018",
+  "sourceDocuments": {
+    "queue": "docs/EXECUTION_QUEUE.md",
+    "taskCard": "docs/tasks/M16-GAP-00017.md",
+    "taskIndex": "tests/golden/M15-03A/task-index.json",
+    "parentManifest": "tests/golden/M16-GAP-00016/manifest.json",
+    "parentStatus": "docs/status/M16-GAP-00016.md"
+  },
+  "readPolicy": {
+    "required": [
+      "docs/EXECUTION_QUEUE.md",
+      "docs/tasks/M16-GAP-00017.md",
+      "tests/golden/M16-GAP-00016/manifest.json",
+      "docs/status/M16-GAP-00016.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-00016",
+      "parentTask": "M16-GAP-00015",
+      "status": "done",
+      "nextTask": "M16-GAP-00017",
+      "artifactCount": 11
+    },
+    "statusSummary": [
+      "# M16-GAP-00016 Status",
+      "status: done  ",
+      "task: NodeTree data-block LOCAL_EXACT slice  ",
+      "updated: 2026-08-19 America/New_York",
+      "scope: Blender 5.2 shader NodeTree observability through a retained Material: RGB -> Principled -> Material Output nodes, links and the reader's stable shader graph hash.",
+      "evidence:",
+      "- `tools/web/generated/M16-GAP-00016.py` generated `WebGapNodeTreeMaterial` with three nodes and two links, retained by a minimal triangle object.",
+      "- Desktop report reopened after save and matched exactly: ShaderNodeRGB, ShaderNodeBsdfPrincipled and ShaderNodeOutputMaterial with two deterministic links."
+    ]
+  },
+  "budgets": {
+    "queueBytes": 4096,
+    "taskBytes": 1729,
+    "parentManifestBytes": 24576,
+    "parentStatusBytes": 6144,
+    "contextTokens": 3500,
+    "taskLines": 38,
+    "taskTokens": 426
+  },
+  "size": {
+    "documents": [
+      {
+        "path": "docs/EXECUTION_QUEUE.md",
+        "bytes": 1969,
+        "lines": 41,
+        "tokens": 321
+      },
+      {
+        "path": "docs/tasks/M16-GAP-00017.md",
+        "bytes": 1729,
+        "lines": 38,
+        "tokens": 426
+      },
+      {
+        "path": "tests/golden/M16-GAP-00016/manifest.json",
+        "bytes": 2193,
+        "lines": 58,
+        "tokens": 549
+      },
+      {
+        "path": "docs/status/M16-GAP-00016.md",
+        "bytes": 1823,
+        "lines": 26,
+        "tokens": 456
+      }
+    ],
+    "totalTokens": 1752,
+    "withinBudget": true
+  }
+}