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-00023/manifest.json
+++ b/tests/golden/M16-GAP-00023/manifest.json
@@ -0,0 +1,25 @@
+{
+  "schemaVersion": 1,
+  "task": "M16-GAP-00023",
+  "parentTask": "M16-GAP-00022",
+  "enablingTask": false,
+  "parityStateChange": true,
+  "runtime": "BLENDER_5_2_LOCAL_EXACT",
+  "operation": "SPEAKER_DATABLOCK_LOCAL_EXACT",
+  "status": "done",
+  "artifacts": {
+    "parentManifest": {"path": "tests/golden/M16-GAP-00022/manifest.json", "sha256": "fac4a48e35b052acec9e50a5b26c801e532a1faa80185eda477dfa8a05f8dec3"},
+    "fixture": {"path": "tests/files/web/generated/M16-GAP-00023-datablock-Speaker.blend", "sha256": "6e422e16f6e020af7ab0a6f3fad3c721b42c924c8a0392bc98546c3f39ee9d23"},
+    "generator": {"path": "tools/web/generated/M16-GAP-00023.py", "sha256": "7bb8465ba094c9f7edbfbb66fd9f6d8b0a2e2b955d5fb990313daea09adbd22c"},
+    "desktopChecker": {"path": "tools/web/check-speaker-desktop.py", "sha256": "4f2b6e3359aeba90754ade475f1683acccc8d2f44a75552c3b04f79a0ddf13d5"},
+    "webChecker": {"path": "tools/web/check-generated-gap.mjs", "sha256": "8db1897b073b8a995e70747daabd11e52c4e235a7f45d4fb3b6f93df642b8bd1"},
+    "reader": {"path": "blender-5.2.0/source/blender/web_engine/web_engine_blend_reader.cpp", "sha256": "dda3f81b178856faf5d05a3e84d4820928e35bda66a47cdf52a55b443f50f015"},
+    "protocol": {"path": "web/protocol/scene-ir.ts", "sha256": "abbc02872f89bfd2e488c3b4c4e01c69a1e366bdfa3871e8564f1599b05d784e"},
+    "wasm": {"path": "web/app/src/vendor/blender/web_engine.wasm", "sha256": "76264df82ce5f21d6b3af2514bda865f902f8485be37cffa74145f2af387e5fd"},
+    "wasmPublic": {"path": "web/app/public/vendor/blender/web_engine.wasm", "sha256": "76264df82ce5f21d6b3af2514bda865f902f8485be37cffa74145f2af387e5fd"},
+    "wasmJs": {"path": "web/app/src/vendor/blender/web_engine.js", "sha256": "9c831d0351ac9d0714cce3b1da748cba416ced3086e3c59595cf24ac4da459ed"},
+    "desktopReport": {"path": "tests/golden/M16-GAP-00023/speaker-desktop-report.json", "sha256": "8ee6e52568f2c37098a8f64983f90243b2df69df1c16a0c4eaae855a7e9fad9d"},
+    "webReport": {"path": "tests/golden/M16-GAP-00023/speaker-local-exact-report.json", "sha256": "7d48447d03e39e5e29f41bf18a95040c5436ed73229cee1bdc32e09f7aae594d"}
+  },
+  "nextTask": "M16-GAP-00024"
+}
--- a/tests/golden/M16-GAP-00023/speaker-desktop-report.json
+++ b/tests/golden/M16-GAP-00023/speaker-desktop-report.json
@@ -0,0 +1,24 @@
+{
+  "blenderVersion": "5.2.0 LTS",
+  "fixture": "/home/mes123456/workinf_Blender_Wasm/tests/files/web/generated/M16-GAP-00023-datablock-Speaker.blend",
+  "fixtureSha256": "6e422e16f6e020af7ab0a6f3fad3c721b42c924c8a0392bc98546c3f39ee9d23",
+  "operation": "SPEAKER_DATABLOCK_DESKTOP",
+  "saveReopen": "EXACT",
+  "schemaVersion": 1,
+  "speaker": {
+    "attenuation": 0.75,
+    "coneAngleInner": 120.0,
+    "coneAngleOuter": 270.0,
+    "coneVolumeOuter": 0.3499999940395355,
+    "distanceMax": 12.5,
+    "distanceReference": 2.25,
+    "id": "speaker:WebGapSpeaker",
+    "name": "WebGapSpeaker",
+    "pitch": 1.100000023841858,
+    "soundId": "sound:WebGapSpeakerSound",
+    "volume": 0.6499999761581421,
+    "volumeMax": 0.8500000238418579,
+    "volumeMin": 0.15000000596046448
+  },
+  "task": "M16-GAP-00023"
+}
--- a/tests/golden/M16-GAP-00023/speaker-local-exact-report.json
+++ b/tests/golden/M16-GAP-00023/speaker-local-exact-report.json
@@ -0,0 +1,34 @@
+{
+  "schemaVersion": 1,
+  "task": "M16-GAP-00023",
+  "operation": "SPEAKER_DATABLOCK_LOCAL_EXACT",
+  "fixture": {
+    "path": "tests/files/web/generated/M16-GAP-00023-datablock-Speaker.blend",
+    "sha256": "6e422e16f6e020af7ab0a6f3fad3c721b42c924c8a0392bc98546c3f39ee9d23"
+  },
+  "desktop": {
+    "status": "EXACT",
+    "report": "tests/golden/M16-GAP-00023/speaker-desktop-report.json",
+    "saveReopen": "EXACT"
+  },
+  "wasm": {
+    "status": "EXACT",
+    "speakerId": "speaker:WebGapSpeaker",
+    "soundId": "sound:WebGapSpeakerSound",
+    "volumeMax": 0.8500000238418579,
+    "volumeMin": 0.15000000596046448,
+    "distanceMax": 12.5,
+    "distanceReference": 2.25,
+    "attenuation": 0.75,
+    "coneAngleOuter": 270,
+    "coneAngleInner": 120,
+    "coneVolumeOuter": 0.3499999940395355,
+    "volume": 0.6499999761581421,
+    "pitch": 1.100000023841858
+  },
+  "saveReopen": "EXACT",
+  "negative": {
+    "malformedBlend": "REJECTED_WITHOUT_MAIN_MUTATION"
+  },
+  "nextTask": "M16-GAP-00024"
+}
--- a/tests/golden/M16-GAP-00023/task-context.json
+++ b/tests/golden/M16-GAP-00023/task-context.json
@@ -0,0 +1,181 @@
+{
+  "schemaVersion": 1,
+  "task": "M16-GAP-00023",
+  "parentTask": "M16-GAP-00022",
+  "status": "in_progress",
+  "goal": "Make the same minimal fixture produce observable datablock:Speaker 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:Speaker",
+    "ownerFamily": "RNA_DATABLOCK",
+    "implementationClass": "LOCAL_EXACT"
+  },
+  "commands": [
+    "build_blender_5.2.0/bin/blender -b --factory-startup --python tools/web/generated/M16-GAP-00023.py -- tests/files/web/generated/M16-GAP-00023-datablock-Speaker.blend",
+    "npm --prefix web run test:generated-gap -- --task M16-GAP-00023",
+    "node tools/web/check-generated-gap.mjs --task M16-GAP-00023"
+  ],
+  "inputPaths": [
+    "tools/web/generated/M16-GAP-00023.py"
+  ],
+  "inputSelection": {
+    "schemaVersion": 1,
+    "limits": {
+      "maxFiles": 12,
+      "evidenceBytes": 8192,
+      "contextRemainingBytes": 6069,
+      "contextRemainingTokens": 1516
+    },
+    "source": {
+      "bytes": 7931,
+      "tokens": 1984
+    },
+    "selected": [
+      {
+        "path": "tools/web/generated/M16-GAP-00023.py",
+        "bytes": 1162,
+        "tokens": 291
+      }
+    ],
+    "excluded": [
+      {
+        "path": "tests/files/web/generated/M16-GAP-00023-datablock-Speaker.blend",
+        "bytes": 85935,
+        "reason": "EVIDENCE_BYTE_BUDGET"
+      },
+      {
+        "path": "blender-5.2.0/source/blender/web_engine/web_engine_blend_reader.cpp",
+        "bytes": 218721,
+        "reason": "EVIDENCE_BYTE_BUDGET"
+      },
+      {
+        "path": "tools/web/check-generated-gap.mjs",
+        "bytes": 84337,
+        "reason": "EVIDENCE_BYTE_BUDGET"
+      },
+      {
+        "path": "tests/golden/M16-GAP-00023/",
+        "bytes": null,
+        "reason": "GENERATED_EVIDENCE_OUTPUT"
+      },
+      {
+        "path": "docs/status/M16-GAP-00023.md",
+        "bytes": null,
+        "reason": "GENERATED_EVIDENCE_OUTPUT"
+      },
+      {
+        "path": "tests/golden/M16-GAP-00023/manifest.json",
+        "bytes": null,
+        "reason": "GENERATED_EVIDENCE_OUTPUT"
+      }
+    ],
+    "totals": {
+      "files": 1,
+      "bytes": 1162,
+      "tokens": 291
+    }
+  },
+  "exitCriteria": [
+    "desktop fixture evidence exists",
+    "WASM uses the same fixture",
+    "comparator passes",
+    "save/reopen preserves Main",
+    "manifest hashes all artifacts"
+  ],
+  "nextTask": "M16-GAP-00024",
+  "sourceDocuments": {
+    "queue": "docs/EXECUTION_QUEUE.md",
+    "taskCard": "docs/tasks/M16-GAP-00023.md",
+    "taskIndex": "tests/golden/M15-03A/task-index.json",
+    "parentManifest": "tests/golden/M16-GAP-00022/manifest.json",
+    "parentStatus": "docs/status/M16-GAP-00022.md"
+  },
+  "readPolicy": {
+    "required": [
+      "docs/EXECUTION_QUEUE.md",
+      "docs/tasks/M16-GAP-00023.md",
+      "tests/golden/M16-GAP-00022/manifest.json",
+      "docs/status/M16-GAP-00022.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-00022",
+      "parentTask": "M16-GAP-00021",
+      "status": "done",
+      "nextTask": "M16-GAP-00023",
+      "artifactCount": 12
+    },
+    "statusSummary": [
+      "# M16-GAP-00022 Status",
+      "status: done  ",
+      "task: Sound data-block LOCAL_EXACT slice  ",
+      "updated: 2026-08-20 America/New_York",
+      "scope: Blender 5.2 `bSound` identity and bounded sound resource fields through the same generated fixture in desktop and WASM/Main: source path, packing state, volume, pitch, channel count and sample rate.",
+      "evidence:",
+      "- `tools/web/generated/M16-GAP-00022.py` deterministically creates `sound:WebGapSound` from the repository WAV fixture and saves the Blend fixture.",
+      "- Desktop reopen report matches exactly: `sound:WebGapSound`, `//WebGapSound.wav`, unpacked, volume/pitch `0.0`, one audio channel and `8000` Hz."
+    ]
+  },
+  "budgets": {
+    "queueBytes": 4096,
+    "taskBytes": 1734,
+    "parentManifestBytes": 24576,
+    "parentStatusBytes": 6144,
+    "evidenceFiles": 12,
+    "evidenceBytes": 8192,
+    "contextTokens": 3500,
+    "taskLines": 38,
+    "taskTokens": 434
+  },
+  "size": {
+    "documents": [
+      {
+        "path": "docs/EXECUTION_QUEUE.md",
+        "bytes": 2168,
+        "lines": 45,
+        "tokens": 542
+      },
+      {
+        "path": "docs/tasks/M16-GAP-00023.md",
+        "bytes": 1734,
+        "lines": 38,
+        "tokens": 434
+      },
+      {
+        "path": "tests/golden/M16-GAP-00022/manifest.json",
+        "bytes": 2130,
+        "lines": 26,
+        "tokens": 533
+      },
+      {
+        "path": "docs/status/M16-GAP-00022.md",
+        "bytes": 1899,
+        "lines": 26,
+        "tokens": 475
+      }
+    ],
+    "sourceTokens": 1984,
+    "evidenceFiles": 1,
+    "evidenceBytes": 1162,
+    "evidenceTokens": 291,
+    "totalTokens": 2275,
+    "withinBudget": true
+  }
+}