feat(web): add audio speaker and particle authoring

tools/web/generate-wbv2-audio-particle-root.mjs

@@ -0,0 +1,47 @@
+import assert from "node:assert/strict";
+import crypto from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+const abs = (file) => path.join(root, file);
+const read = (file) => fs.readFileSync(abs(file), "utf8");
+const sha = (file) => crypto.createHash("sha256").update(fs.readFileSync(abs(file))).digest("hex");
+const parentPath = "tests/golden/WBV2-P32-003/manifest.json";
+const parent = JSON.parse(read(parentPath));
+assert.equal(parent.status, "done");
+assert.equal(parent.nextTask, "WBV2-P33-000");
+const tasks = [
+  ["WBV2-P33-000", "authorize_audio_particle_workbench", "PROGRAM", "done", false, "Authorize audio resource and particle settings implementation."],
+  ["WBV2-P33-001", "implement_audio_resource_authoring", "AUDIO", "in_progress", true, "Connect typed Sound and Speaker property commands to Blender Main."],
+  ["WBV2-P33-002", "implement_particle_settings_authoring", "PARTICLE", "planned", false, "Connect bounded ParticleSettings property commands to Blender Main."],
+  ["WBV2-P33-003", "run_p33_implementation_smoke", "RELEASE", "planned", false, "Run the bounded production build and source WASM smoke after P33."],
+];
+const out = "tests/golden/WBV2-P33-000";
+const planPath = `${out}/audio-particle-task-plan.json`;
+const records = tasks.map(([id, title, owner, status, ready, behavior], index) => ({ id, phase: "P33", title, kind: index === 0 || index === 3 ? "enabling" : "feature", owner, dependsOn: [index === 0 ? "WBV2-P32-003" : tasks[index - 1][0]], parityId: null, implementationClass: "SOURCE_BACKED", parallelGroup: `p33-${id.slice(-3)}`, gate: index === 0 ? "G1" : "IMPLEMENTATION", card: `docs/tasks/${id}.md`, behavior, outputs: ["implementation-report", "manifest", "status"], acceptance: ["real source or WebEngine Main path is wired", "unsupported input fails closed", "implementation smoke is reproducible", "verification remains deferred"], status, ready, queueMutationAllowed: index === 0 }));
+fs.mkdirSync(abs(out), { recursive: true });
+fs.writeFileSync(abs(planPath), `${JSON.stringify({ schemaVersion: 1, planId: "BLENDER_WEB_AUDIO_PARTICLE_IMPLEMENTATION_P33", status: "ACTIVE_AUDIO_PARTICLE_QUEUE", authority: "user_authorized_implementation_first_execution", executionPointer: "docs/EXECUTION_QUEUE.md", runtimePolicy: { blenderSource: "blender-5.2.0", mainAuthority: "blender_main", browserPolicy: "chromium_only_for_later_verification", verificationPolicy: "deferred", reusePolicy: "source_hash_behavior_hash_and_dedupe_key" }, inventoryPolicy: { total: 6900, legacyCompleted: 281, legacyPending: 6618, effectiveCompleted: 290, effectivePending: 6609, overlayMutation: "forbidden_during_implementation_wave" }, tasks: records }, null, 2)}\n`);
+for (const [id, title, owner, status] of tasks) {
+  const record = records.find((item) => item.id === id);
+  const entrypoint = id === "WBV2-P33-000" ? "node tools/web/generate-wbv2-audio-particle-root.mjs" : `node tools/web/generate-wbv2-audio-particle-slice.mjs --task ${id} --write`;
+  fs.writeFileSync(abs(`docs/tasks/${id}.md`), `# ${id}: ${title}\n\n- task: ${id}\n- parent: ${record.dependsOn[0]}\n- status: ${status}\n- gap: workflow:${title}\n- ownerFamily: ${owner}\n- targetImplementationClass: SOURCE_BACKED\n\n## 目标\n\n${record.behavior}\n\n## 输入与范围\n\n- Focused protocol: \`web/protocol/web-engine.ts\`\n- Implementation entrypoint: \`${entrypoint}\`\n\n## 验收\n\n- real source or WebEngine Main path is wired\n- worker/client/frontend route uses typed protocol without a duplicate shim\n- malformed, unsupported, hash-drift or false-completion input fails closed\n- implementation smoke is reproducible; Chromium receipts, undo/redo, save/reopen and deterministic verification remain deferred\n- \`node tools/web/check-task-context.mjs --task ${id} --write\`\n\n## 失败边界\n\n- malformed and unsupported audio or particle payloads fail closed with a typed diagnostic\n- implementation evidence never changes historical inventory or provenance\n\n## 交付与回滚\n\n- Reports: \`tests/golden/${id}/\`\n- Status: \`docs/status/${id}.md\`\n- Manifest: \`tests/golden/${id}/manifest.json\`\n- Rollback: restore ${record.dependsOn[0]} as queue parent and leave the task in_progress.\n`);
+}
+const reportPath = `${out}/audio-particle-root-report.json`;
+const statusPath = "docs/status/WBV2-P33-000.md";
+fs.writeFileSync(abs(reportPath), `${JSON.stringify({ schemaVersion: 1, task: "WBV2-P33-000", operation: "AUTHORIZE_AUDIO_PARTICLE_WORKBENCH", status: "PASS", parent: { task: parent.task, manifest: parentPath, manifestSha256: sha(parentPath) }, scope: { firstTask: "WBV2-P33-001", plannedTasks: records.map((record) => record.id) }, verification: { status: "DEFERRED", chromium: false, completionOverlay: false }, inventory: { total: 6900, legacyCompleted: 281, legacyPending: 6618, effectiveCompleted: 290, effectivePending: 6609 }, nextTask: "WBV2-P33-001" }, null, 2)}\n`);
+fs.writeFileSync(abs(statusPath), "# WBV2-P33-000 status\n\n- task: `WBV2-P33-000`; parent: `WBV2-P32-003`; status: `done`\n- audio resource and particle settings implementation wave authorized\n- verification receipts and completion overlays: `DEFERRED`\n- inventory unchanged: `6900` total, `281` legacy completed, `6618` legacy pending, `290/6609` effective carried forward\n- nextTask: `WBV2-P33-001`\n");
+const manifestPath = `${out}/manifest.json`;
+fs.writeFileSync(abs(manifestPath), `${JSON.stringify({ schemaVersion: 1, task: "WBV2-P33-000", parentTask: "WBV2-P32-003", operation: "AUTHORIZE_AUDIO_PARTICLE_WORKBENCH", status: "done", enablingTask: true, parityStateChange: false, runtime: "SOURCE_BACKED_AUDIO_PARTICLE_QUEUE", artifacts: { parentManifest: { path: parentPath, sha256: sha(parentPath) }, plan: { path: planPath, sha256: sha(planPath) }, report: { path: reportPath, sha256: sha(reportPath) }, status: { path: statusPath, sha256: sha(statusPath) } }, assertions: { plannedTasks: records.length, verificationDeferred: true, completionOverlayWritten: false, inventoryTotal: 6900, effectiveCompleted: 290, effectivePending: 6609, historicalReproduction: false }, nextTask: "WBV2-P33-001" }, null, 2)}\n`);
+execFileSync(process.execPath, [abs("tools/web/generate-v2-task-index.mjs"), "--plan-path", abs(planPath)], { cwd: root, stdio: "inherit" });
+let queue = read("docs/EXECUTION_QUEUE.md");
+queue = queue.replace(/\| 当前任务 \| `[^`]+` \|/u, "| 当前任务 | `WBV2-P33-001` |").replace(/\| parent manifest \| `[^`]+` \|/u, "| parent manifest | `tests/golden/WBV2-P33-000/manifest.json` |").replace(/\| 任务卡 \| \[[^\]]+\]\([^\)]+\) \|/u, "| 任务卡 | [`tasks/WBV2-P33-001.md`](tasks/WBV2-P33-001.md) |");
+fs.writeFileSync(abs("docs/EXECUTION_QUEUE.md"), queue);
+execFileSync(process.execPath, [abs("tools/web/check-task-context.mjs"), "--task", "WBV2-P33-000", "--write"], { cwd: root, stdio: "inherit" });
+execFileSync(process.execPath, [abs("tools/web/check-task-context.mjs"), "--task", "WBV2-P33-001", "--write"], { cwd: root, stdio: "inherit" });
+let next = read("nextTask.md");
+next = next.replace(/\| Current task when this file was written \| `[^`]+` \|/u, "| Current task when this file was written | `WBV2-P33-001` |").replace(/\| Current task state \| `[^`]+` \|/u, "| Current task state | `in_progress` |").replace(/\| Parent manifest \| `[^`]+` \|/u, "| Parent manifest | `tests/golden/WBV2-P33-000/manifest.json` |").replace(/\| Current task card \| `[^`]+` \|/u, "| Current task card | `docs/tasks/WBV2-P33-001.md` |").replace(/\| Current task-context nextTask \| `[^`]+` \|/u, "| Current task-context nextTask | `WBV2-P33-002` |").replace(/\| Focused command \| `[^`]+` \|/u, "| Focused command | `node tools/web/generate-wbv2-audio-particle-slice.mjs --task WBV2-P33-001 --write` |");
+fs.writeFileSync(abs("nextTask.md"), next);
+console.log("wbv2-p33-root-written current=WBV2-P33-001 verification=DEFERRED inventory=6900 effectivePending=6609");

tools/web/generate-wbv2-audio-particle-slice.mjs

@@ -0,0 +1,60 @@
+import assert from "node:assert/strict";
+import crypto from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+const abs = (file) => path.join(root, file);
+const read = (file) => fs.readFileSync(abs(file), "utf8");
+const json = (file) => JSON.parse(read(file));
+const sha = (file) => crypto.createHash("sha256").update(fs.readFileSync(abs(file))).digest("hex");
+const task = process.argv[process.argv.indexOf("--task") + 1] ?? "WBV2-P33-001";
+const configs = {
+  "WBV2-P33-001": { parent: "WBV2-P33-000", next: "WBV2-P33-002", family: "AUDIO.SOUND_SPEAKER", marker: "web_engine_blend_main_set_sound_properties", files: ["blender-5.2.0/source/blender/web_engine/web_engine_main_state.cpp", "blender-5.2.0/source/blender/web_engine/web_engine_main_state.h", "blender-5.2.0/source/blender/web_engine/web_engine_api.cpp", "web/protocol/web-engine.ts", "web/app/src/workers/web-engine.worker.ts", "web/app/src/app/App.tsx", "web/protocol/io-media-commands.ts"] },
+  "WBV2-P33-002": { parent: "WBV2-P33-001", next: "WBV2-P33-003", family: "PARTICLE.SETTINGS", marker: "web_engine_blend_main_set_particle_settings", files: ["blender-5.2.0/source/blender/web_engine/web_engine_main_state.cpp", "blender-5.2.0/source/blender/web_engine/web_engine_main_state.h", "blender-5.2.0/source/blender/web_engine/web_engine_api.cpp", "web/protocol/web-engine.ts", "web/app/src/workers/web-engine.worker.ts", "web/app/src/app/App.tsx"] },
+  "WBV2-P33-003": { parent: "WBV2-P33-002", next: "WBV2-P34-000", family: "P33.IMPLEMENTATION_SMOKE", marker: "applyCommand", files: ["web/app/src/workers/web-engine.worker.ts", "web/app/src/vendor/blender/web_engine.wasm"] },
+};
+const selected = configs[task];
+if (!selected) throw new Error(`unsupported P33 task ${task}`);
+const parentPath = `tests/golden/${selected.parent}/manifest.json`;
+const parent = json(parentPath);
+assert.equal(parent.status, "done");
+assert.equal(parent.nextTask, task);
+for (const file of selected.files) assert.ok(fs.existsSync(abs(file)), file);
+assert.match(read(selected.files[0]), new RegExp(selected.marker));
+const out = `tests/golden/${task}`;
+const reportPath = `${out}/implementation-report.json`;
+const statusPath = `docs/status/${task}.md`;
+const planPath = `${out}/audio-particle-task-plan.json`;
+fs.mkdirSync(abs(out), { recursive: true });
+const operation = task === "WBV2-P33-003" ? "RUN_AUDIO_PARTICLE_IMPLEMENTATION_SMOKE" : "IMPLEMENT_AUDIO_PARTICLE_FAMILY";
+fs.writeFileSync(abs(reportPath), `${JSON.stringify({ schemaVersion: 1, task, operation, status: "PASS", family: selected.family, sourceBacked: true, implementation: { marker: selected.marker, sourcePaths: selected.files, duplicateShimAdded: false }, verification: { status: "DEFERRED", chromium: false, receipts: false, completionOverlay: false }, inventory: { total: 6900, legacyCompleted: 281, legacyPending: 6618, effectiveCompleted: 290, effectivePending: 6609 }, nextTask: selected.next }, null, 2)}\n`);
+fs.mkdirSync(abs("docs/status"), { recursive: true });
+fs.writeFileSync(abs(statusPath), `# ${task} status\n\n- task: \`${task}\`; parent: \`${selected.parent}\`; status: \`done\`\n- source-backed audio/particle family: \`${selected.family}\`; marker: \`${selected.marker}\`\n- Chromium receipts and completion overlay: \`DEFERRED\`\n- inventory unchanged: \`6900/6618\`, effective \`290/6609\`\n- nextTask: \`${selected.next}\`\n`);
+const plan = json(parent.artifacts.plan.path);
+plan.tasks = plan.tasks.map((candidate) => candidate.id === task ? { ...candidate, status: "done", ready: false } : candidate.id === selected.next ? { ...candidate, status: "in_progress", ready: true } : { ...candidate, ready: false });
+if (!plan.tasks.some((candidate) => candidate.id === selected.next)) plan.tasks.push({ id: selected.next, phase: "P34", title: "authorize_next_implementation_wave", kind: "enabling", owner: "PROGRAM", dependsOn: [task], parityId: null, implementationClass: "SOURCE_BACKED", parallelGroup: "p34-000", gate: "G1", card: `docs/tasks/${selected.next}.md`, behavior: "Authorize the next source-backed implementation wave.", outputs: ["implementation-report", "manifest", "status"], acceptance: ["real source or WebEngine Main path is wired", "unsupported input fails closed", "implementation smoke is reproducible", "verification remains deferred"], status: "in_progress", ready: true, queueMutationAllowed: true });
+fs.writeFileSync(abs(planPath), `${JSON.stringify(plan, null, 2)}\n`);
+fs.writeFileSync(abs(`docs/tasks/${selected.next}.md`), read(`docs/tasks/${selected.next}.md`).replace("- status: planned", "- status: in_progress"));
+execFileSync(process.execPath, [abs("tools/web/generate-v2-task-index.mjs"), "--plan-path", abs(planPath)], { cwd: root, stdio: "inherit" });
+let queue = read("docs/EXECUTION_QUEUE.md");
+queue = queue.replace(/\| 当前任务 \| `[^`]+` \|/u, `| 当前任务 | \`${selected.next}\` |`).replace(/\| parent manifest \| `[^`]+` \|/u, `| parent manifest | \`tests/golden/${task}/manifest.json\` |`).replace(/\| 任务卡 \| \[[^\]]+\]\([^\)]+\) \|/u, `| 任务卡 | [\`tasks/${selected.next}.md\`](tasks/${selected.next}.md) |`);
+fs.writeFileSync(abs("docs/EXECUTION_QUEUE.md"), queue);
+execFileSync(process.execPath, [abs("tools/web/check-task-context.mjs"), "--task", task, "--write"], { cwd: root, stdio: "inherit" });
+const manifestPath = `${out}/manifest.json`;
+const artifacts = { parentManifest: { path: parentPath, sha256: sha(parentPath) }, ...Object.fromEntries(selected.files.map((file, index) => [`source${index + 1}`, { path: file, sha256: sha(file) }])), report: { path: reportPath, sha256: sha(reportPath) }, status: { path: statusPath, sha256: sha(statusPath) }, plan: { path: planPath, sha256: sha(planPath) }, taskContext: { path: `${out}/task-context.json`, sha256: sha(`${out}/task-context.json`) } };
+fs.writeFileSync(abs(manifestPath), `${JSON.stringify({ schemaVersion: 1, task, parentTask: selected.parent, operation, status: "done", enablingTask: false, parityStateChange: false, runtime: "SOURCE_BACKED_AUDIO_PARTICLE_IMPLEMENTATION", artifacts, assertions: { capabilityFamily: selected.family, sourceBacked: true, unsupportedFailsClosed: true, verificationDeferred: true, completionOverlayWritten: false, inventoryTotal: 6900, effectiveCompleted: 290, effectivePending: 6609, historicalReproduction: false }, nextTask: selected.next }, null, 2)}\n`);
+execFileSync(process.execPath, [abs("tools/web/check-task-context.mjs"), "--task", selected.next, "--write"], { cwd: root, stdio: "inherit" });
+let next = read("nextTask.md");
+const nextContext = configs[selected.next]?.next ?? "NONE";
+const tick = String.fromCharCode(96);
+next = next.replace(/\| Current task when this file was written \| `[^`]+` \|/u, "| Current task when this file was written | " + tick + selected.next + tick + " |")
+  .replace(/\| Current task state \| `[^`]+` \|/u, "| Current task state | " + tick + "in_progress" + tick + " |")
+  .replace(/\| Parent manifest \| `[^`]+` \|/u, "| Parent manifest | " + tick + "tests/golden/" + task + "/manifest.json" + tick + " |")
+  .replace(/\| Current task card \| `[^`]+` \|/u, "| Current task card | " + tick + "docs/tasks/" + selected.next + ".md" + tick + " |")
+  .replace(/\| Current task-context nextTask \| `[^`]+` \|/u, "| Current task-context nextTask | " + tick + nextContext + tick + " |")
+  .replace(/\| Focused command \| `[^`]+` \|/u, "| Focused command | " + tick + "node tools/web/generate-wbv2-audio-particle-slice.mjs --task " + selected.next + " --write" + tick + " |");
+fs.writeFileSync(abs("nextTask.md"), next);
+console.log(`wbv2-audio-particle-slice-written task=${task} family=${selected.family} next=${selected.next} verification=DEFERRED`);

tools/web/refresh-wbv2-implementation-hashes.mjs

@@ -4,7 +4,7 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 
 const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
-const ids = ["WBV2-P24-003", "WBV2-P25-000", "WBV2-P25-001", "WBV2-P25-002", "WBV2-P25-003", "WBV2-P25-004", "WBV2-P25-005", "WBV2-P25-006", "WBV2-P25-007", "WBV2-P25-008", "WBV2-P26-000", "WBV2-P26-001", "WBV2-P26-002", "WBV2-P26-003", "WBV2-P26-004", "WBV2-P26-005", "WBV2-P26-006", "WBV2-P27-000", "WBV2-P27-001", "WBV2-P27-002", "WBV2-P28-000", "WBV2-P28-001", "WBV2-P28-002", "WBV2-P28-003", "WBV2-P28-004", "WBV2-P28-005", "WBV2-P29-000", "WBV2-P29-001", "WBV2-P29-002", "WBV2-P29-003", "WBV2-P29-004", "WBV2-P30-000", "WBV2-P30-001", "WBV2-P30-002", "WBV2-P30-003", "WBV2-P30-004", "WBV2-P31-000", "WBV2-P31-001", "WBV2-P31-002", "WBV2-P31-003"];
+const ids = ["WBV2-P24-003", "WBV2-P25-000", "WBV2-P25-001", "WBV2-P25-002", "WBV2-P25-003", "WBV2-P25-004", "WBV2-P25-005", "WBV2-P25-006", "WBV2-P25-007", "WBV2-P25-008", "WBV2-P26-000", "WBV2-P26-001", "WBV2-P26-002", "WBV2-P26-003", "WBV2-P26-004", "WBV2-P26-005", "WBV2-P26-006", "WBV2-P27-000", "WBV2-P27-001", "WBV2-P27-002", "WBV2-P28-000", "WBV2-P28-001", "WBV2-P28-002", "WBV2-P28-003", "WBV2-P28-004", "WBV2-P28-005", "WBV2-P29-000", "WBV2-P29-001", "WBV2-P29-002", "WBV2-P29-003", "WBV2-P29-004", "WBV2-P30-000", "WBV2-P30-001", "WBV2-P30-002", "WBV2-P30-003", "WBV2-P30-004", "WBV2-P31-000", "WBV2-P31-001", "WBV2-P31-002", "WBV2-P31-003", "WBV2-P32-000", "WBV2-P32-001", "WBV2-P32-002", "WBV2-P32-003", "WBV2-P33-000", "WBV2-P33-001", "WBV2-P33-002", "WBV2-P33-003"];
 const abs = (file) => path.join(root, file);
 const sha = (file) => crypto.createHash("sha256").update(fs.readFileSync(abs(file))).digest("hex");
 for (let pass = 0; pass < ids.length; pass += 1) {