Files
FreeCADWasmDev/tools/run_p6_material_object_module_batch_gate.mjs
wangdequan 9a7c4f0335 Save FreeCAD Web workspace sources and user validation evidence
IFC native binding remains incomplete; preserve accurate test results.
2026-09-15 22:01:58 +08:00

63 lines
8.1 KiB
JavaScript

#!/usr/bin/env node
import crypto from "node:crypto";
import fs from "node:fs";
import os from "node:os";
import path from "node:path";
import { execFileSync } from "node:child_process";
import { Worker } from "node:worker_threads";
import { pathToFileURL } from "node:url";
const root = "/home/mes123456/FreeCADWasmDev/working/FreeCAD";
const build = path.resolve(process.argv[2] ?? path.join(root, "freecad-source/build-web/configure/bin"));
const batchPath = path.resolve(process.env.MATERIAL_BATCH_MANIFEST ?? path.join(root, "docs/current/module-batch-manifest.json"));
const batch = JSON.parse(fs.readFileSync(batchPath, "utf8"));
if (batch.status !== "ready" || batch.selected?.module !== "Material" || !["tier-1-readonly", "tier-2-pure", "tier-3-stateful"].includes(batch.selected?.tier) || typeof batch.selected?.family !== "string" || batch.records.length < 2 || batch.records.length > 32) throw new Error("unexpected Material batch manifest");
const tier = batch.selected.tier;
const family = batch.selected.family;
const records = batch.records.map(([apiId, name, disposition, sourcePath]) => ({ apiId, name, family, kind: "function", sourcePath, disposition }));
const output = fs.mkdtempSync(path.join(os.tmpdir(), "freecad-material-object-batch-"));
const hash = value => crypto.createHash("sha256").update(JSON.stringify(value)).digest("hex");
const fileHash = file => crypto.createHash("sha256").update(fs.readFileSync(file)).digest("hex");
execFileSync(path.join(root, "web/node_modules/.bin/tsc"), ["--target", "ES2022", "--module", "ESNext", "--moduleResolution", "Bundler", "--strict", "--skipLibCheck", "--outDir", output, "--declaration", "false", "--noEmit", "false", path.join(root, "web/src/facade-envelope.ts"), path.join(root, "web/src/material-python-family-facade.ts")], { cwd: root, stdio: "inherit" });
const facade = await import(pathToFileURL(path.join(output, "material-python-family-facade.js")));
const envelope = await import(pathToFileURL(path.join(output, "facade-envelope.js")));
const request = (requestId, rows = records, requestTier = tier) => facade.createMaterialPythonFamilyRequest(requestId, rows, requestTier);
const worker = new Worker(path.join(root, "tools/material-python-family-facade-smoke-worker.mjs"), { workerData: { buildDirectory: build, facadePath: pathToFileURL(path.join(output, "material-python-family-facade.js")).href, envelopePath: pathToFileURL(path.join(output, "facade-envelope.js")).href } });
const next = () => new Promise((resolve, reject) => { const onMessage = value => { worker.off("error", onError); resolve(value); }; const onError = error => { worker.off("message", onMessage); reject(error); }; worker.once("message", onMessage); worker.once("error", onError); });
const ready = await next();
worker.postMessage(request("material-object-batch-success"));
const success = await next();
worker.postMessage(request("material-object-batch-repeat"));
const repeat = await next();
worker.postMessage(request("material-object-batch-cross", [{ ...records[0], apiId: "obj:BIM:Materials::Library" }]));
const cross = await next();
worker.postMessage({ ...request("material-object-batch-invalid"), payload: { ...request("material-object-batch-invalid").payload, tier: "tier-unsupported" } });
const malformed = await next();
const cancelRequest = request("material-object-batch-cancel");
worker.postMessage(cancelRequest);
worker.postMessage(envelope.createCancel("material-object-batch-cancel-control", cancelRequest.requestId, "material-python-family"));
const cancelled = await next();
worker.postMessage({ kind: "reset", requestId: "material-object-batch-reset" });
const reset = await next();
await worker.terminate();
if (ready.kind !== "ready" || success.kind !== "result" || repeat.kind !== "result" || cross.kind !== "result" || malformed.kind !== "error" || cancelled.kind !== "error" || reset.requestId !== "material-object-batch-reset") throw new Error(JSON.stringify({ ready, success, repeat, cross, malformed, cancelled, reset }));
const result = success.result;
const terminal = new Set(["exposed", "restricted", "nonportable", "not_implemented"]);
if (result.module !== "Material" || result.tier !== tier || result.count !== records.length || result.records.length !== records.length || result.resourcesReleased !== true) throw new Error("Material batch result is incomplete");
if (result.records.some(row => !terminal.has(row.status) || row.native !== true || row.resourcesReleased !== true || typeof row.sourceRevision !== "string" || typeof row.sourceEntry !== "string" || typeof row.parameterSchema !== "string" || typeof row.returnSchema !== "string")) throw new Error("Material object batch record schema is incomplete");
if (JSON.stringify(result) !== JSON.stringify(repeat.result)) throw new Error("Material object batch replay changed native result");
if (cross.result.records?.[0]?.status !== "not_implemented" || cross.result.records?.[0]?.code !== "unmatched_source_record") throw new Error("Material object cross-module boundary failed");
if (malformed.error.code !== "invalid_request") throw new Error("Material object invalid tier was not rejected");
if (cancelled.error.code !== "cancelled") throw new Error("Material object cancellation boundary failed");
const evidencePath = `docs/p6/material-module-batch-${batch.batchId}-runtime.json`;
const matrixPath = path.join(root, "docs/p6/python-api-manifest.json");
const matrix = JSON.parse(fs.readFileSync(matrixPath, "utf8"));
const byId = new Map(result.records.map(row => [row.apiId, row]));
for (const row of matrix.records ?? []) { const native = byId.get(row.id); if (!native) continue; row.status = native.status; row.dispositionEvidence = [evidencePath]; row.dispositionReason = native.message; }
fs.writeFileSync(matrixPath, `${JSON.stringify(matrix, null, 2)}\n`);
const dispositionCounts = Object.fromEntries([...terminal].map(status => [status, result.records.filter(row => row.status === status).length]));
const report = { schema: "freecad-web-material-module-batch-runtime/v1", taskId: "FW-P6-FPA-Y", batchId: batch.batchId, module: "Material", tier, family, status: "pass_with_boundaries", sourceRevision: result.records[0]?.sourceRevision, route: { command: "material.pythonFamilyBatch", native: "freecad-source/src/WebAssembly/FreeCADCoreProbe/MaterialKernelProbe.cpp:fc_web_dispatch_json", facade: "web/src/material-python-family-facade.ts", worker: "web/src/material.worker.ts" }, input: { cmd: "material.pythonFamilyBatch", args: { tier, records } }, inputSha256: hash(records), result, resultSha256: hash(result), replay: { equal: true, resultSha256: hash(repeat.result) }, facadeWorker: { ready, success, repeat, crossModule: cross, malformed, cancelled, reset, traceSha256: hash({ ready, success, repeat, cross, malformed, cancelled, reset }) }, dispositionCounts, records: result.records.map(row => ({ apiId: row.apiId, name: row.name, status: row.status, code: row.code, message: row.message, sourceEntry: row.sourceEntry, sourceRevision: row.sourceRevision, evidenceSha256: hash(row) })), resources: { resourcesReleased: true, documentMutation: false }, artifacts: { wasm: { path: "web/public/kernel/FreeCADWebMaterialKernelProbe.wasm", sha256: fileHash(path.join(root, "web/public/kernel/FreeCADWebMaterialKernelProbe.wasm")) }, loader: { path: "web/public/kernel/FreeCADWebMaterialKernelProbe.js", sha256: fileHash(path.join(root, "web/public/kernel/FreeCADWebMaterialKernelProbe.js")) } }, boundaries: ["MaterialManagerExternal remains restricted because BUILD_MATERIAL_EXTERNAL is disabled in the Web build.", "All statuses, schemas and hashes come from compiled FreeCAD through fc_web_dispatch_json; JavaScript only transports and validates the batch envelope."] };
fs.writeFileSync(path.join(root, evidencePath), `${JSON.stringify(report, null, 2)}\n`);
fs.writeFileSync(path.join(root, `docs/freecad-p6-material-module-batch-${batch.batchId}.log`), `${JSON.stringify({ status: report.status, batchId: batch.batchId, count: records.length, dispositionCounts, resultSha256: report.resultSha256 })}\n`);
console.log(JSON.stringify({ status: report.status, batchId: batch.batchId, count: records.length, dispositionCounts, resultSha256: report.resultSha256 }));