79 lines
11 KiB
JavaScript
79 lines
11 KiB
JavaScript
#!/usr/bin/env node
|
|
import crypto from "node:crypto";
|
|
import fs from "node:fs";
|
|
import path from "node:path";
|
|
import { createRequire } from "node:module";
|
|
import { execFileSync } from "node:child_process";
|
|
import { Worker } from "node:worker_threads";
|
|
import { fileURLToPath, pathToFileURL } from "node:url";
|
|
|
|
const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
|
|
const build = path.resolve(process.argv[2] ?? path.join(root, "freecad-source/build-web/configure/bin"));
|
|
const out = fs.mkdtempSync(path.join("/tmp", "freecad-p6-sketcher-family-"));
|
|
execFileSync(path.join(root, "web/node_modules/.bin/tsc"), ["--target", "ES2022", "--module", "ESNext", "--moduleResolution", "Bundler", "--strict", "--skipLibCheck", "--outDir", out, "--declaration", "false", "--noEmit", "false", "web/src/facade-envelope.ts", "web/src/sketcher-python-family-facade.ts"], { cwd: root, stdio: "inherit" });
|
|
|
|
const manifestPath = path.join(root, "docs/p6/python-api-manifest.json");
|
|
const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
|
|
const sourcePath = (name) => {
|
|
const owner = name.split(".", 1)[0];
|
|
if (owner === "SketcherWorkbench") return "src/Mod/Sketcher/InitGui.py";
|
|
if (owner.startsWith("ViewProvider")) return "src/Mod/Sketcher/Gui/ViewProviderSketchGeometryExtension.pyi";
|
|
return `src/Mod/Sketcher/App/${owner}.pyi`;
|
|
};
|
|
const records = manifest.records.filter((row) => row.module === "Sketcher" && row.tier === "tier-1-readonly").map((row) => ({ apiId: row.id, name: row.name, family: row.family, sourcePath: sourcePath(row.name), disposition: row.disposition }));
|
|
if (records.length !== 20) throw new Error(`expected 20 Sketcher Tier-1 records, got ${records.length}`);
|
|
|
|
globalThis.__dirname = `${build}${path.sep}`;
|
|
globalThis.require = createRequire(import.meta.url);
|
|
const loader = await import(pathToFileURL(path.join(build, "FreeCADWebSketcherProbe.js")));
|
|
const kernel = await loader.default({ wasmBinary: fs.readFileSync(path.join(build, "FreeCADWebSketcherProbe.wasm")), print: () => {}, printErr: () => {} });
|
|
const invoke = (request) => JSON.parse(String(kernel.ccall("fc_web_dispatch_json", "string", ["string"], [JSON.stringify(request)])));
|
|
const request = { cmd: "sketcher.pythonFamilyBatch", args: { tier: "tier-1-readonly", records } };
|
|
const success = invoke(request);
|
|
const repeated = invoke(request);
|
|
const crossModule = invoke({ cmd: request.cmd, args: { tier: request.args.tier, records: [{ ...records[0], apiId: "py:BIM:class:Constraint" }] } });
|
|
const malformed = invoke({ cmd: request.cmd, args: { tier: "tier-2-pure", records } });
|
|
if (success.ok !== true || success.module !== "Sketcher" || success.tier !== "tier-1-readonly" || success.count !== records.length || success.resourcesReleased !== true || !Array.isArray(success.records) || success.records.length !== records.length) throw new Error("Sketcher family dispatch did not return a complete result");
|
|
const terminal = new Set(["exposed", "restricted", "nonportable", "not_implemented"]);
|
|
if (success.records.some((record) => !terminal.has(record.status) || record.native !== true || record.resourcesReleased !== true || !record.sourceEntry || !record.sourceRevision)) throw new Error("Sketcher family result contains a non-terminal or non-native record");
|
|
const dispositionCounts = Object.fromEntries([...terminal].map((status) => [status, success.records.filter((record) => record.status === status).length]));
|
|
if (dispositionCounts.exposed !== 6 || dispositionCounts.restricted !== 2 || dispositionCounts.nonportable !== 0 || dispositionCounts.not_implemented !== 12) throw new Error(`unexpected Sketcher disposition counts: ${JSON.stringify(dispositionCounts)}`);
|
|
if (JSON.stringify(repeated) !== JSON.stringify(success)) throw new Error("Sketcher family replay changed the native result");
|
|
if (crossModule.ok !== true || crossModule.records?.[0]?.status !== "not_implemented" || crossModule.records?.[0]?.code !== "unmatched_source_record") throw new Error("Sketcher cross-module boundary failed");
|
|
if (malformed.ok !== false || malformed.code !== "invalid_request") throw new Error("Sketcher invalid tier was not rejected");
|
|
|
|
const hash = (value) => crypto.createHash("sha256").update(JSON.stringify(value)).digest("hex");
|
|
const fileHash = (file) => crypto.createHash("sha256").update(fs.readFileSync(file)).digest("hex");
|
|
const byId = new Map(success.records.map((record) => [record.apiId, record]));
|
|
for (const row of manifest.records) {
|
|
if (row.module !== "Sketcher" || row.tier !== "tier-1-readonly") continue;
|
|
const native = byId.get(row.id);
|
|
if (!native) throw new Error(`native result missing ${row.id}`);
|
|
row.disposition = native.status;
|
|
row.dispositionEvidence = ["docs/p6/sketcher-tier1-readonly-family-runtime.json"];
|
|
row.dispositionReason = native.status === "restricted" ? native.message : native.status === "not_implemented" ? native.message : "native Sketcher Python symbol was resolved and replayed by the FreeCAD Web runtime";
|
|
}
|
|
fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
|
|
const report = { schema: "freecad-web-p6-sketcher-tier1-readonly-family-runtime/v1", taskId: "FW-P6-FPA-F1-SKETCHER", module: "Sketcher", tier: "tier-1-readonly", status: "pass_with_restricted_and_pending", sourceRevision: success.records[0]?.sourceRevision, route: { worker: "web/src/sketcher-python.worker.ts", facade: "web/src/sketcher-python-family-facade.ts", command: request.cmd, native: "freecad-source/src/WebAssembly/FreeCADCoreProbe/SketcherProbe.cpp:fc_web_dispatch_json" }, input: request, inputSha256: hash(request), result: success, resultSha256: hash(success), replay: { equal: true, resultSha256: hash(repeated) }, crossModuleBoundary: { result: crossModule, resultSha256: hash(crossModule) }, malformedRequest: { result: malformed, resultSha256: hash(malformed) }, dispositionCounts, records: success.records.map((record) => ({ apiId: record.apiId, name: record.name, family: record.family, status: record.status, code: record.code, parameterSchema: record.parameterSchema, returnSchema: record.returnSchema, replay: record.replay, sourceEntry: record.sourceEntry, sourceRevision: record.sourceRevision, evidenceSha256: hash(record) })), resources: { resourcesReleased: true, documentMutation: false }, artifacts: { wasm: { path: "web/public/kernel/FreeCADWebSketcherProbe.wasm", sha256: fileHash(path.join(root, "web/public/kernel/FreeCADWebSketcherProbe.wasm")) }, loader: { path: "web/public/kernel/FreeCADWebSketcherProbe.js", sha256: fileHash(path.join(root, "web/public/kernel/FreeCADWebSketcherProbe.js")) } }, boundaries: ["Sketcher Workbench and ViewProvider records remain restricted because FreeCADGui/view resources are unavailable in the headless Web runtime.", "Non-GUI SketchObject/Facade methods remain not_implemented until method-level native argument/return replay exists.", "All statuses, schemas and hashes come from compiled FreeCAD source through fc_web_dispatch_json; no JavaScript API result is substituted."] };
|
|
fs.writeFileSync(path.join(root, "docs/p6/sketcher-tier1-readonly-family-runtime.json"), `${JSON.stringify(report, null, 2)}\n`);
|
|
fs.writeFileSync(path.join(root, "docs/freecad-p6-sketcher-tier1-readonly-family.log"), `${JSON.stringify({ status: report.status, count: records.length, dispositionCounts, resultSha256: report.resultSha256 })}\n`);
|
|
console.log(JSON.stringify({ status: report.status, count: records.length, dispositionCounts, resultSha256: report.resultSha256 }));
|
|
|
|
const facade = await import(pathToFileURL(path.join(out, "sketcher-python-family-facade.js")));
|
|
const envelope = await import(pathToFileURL(path.join(out, "facade-envelope.js")));
|
|
const worker = new Worker(path.join(root, "tools/sketcher-python-family-facade-smoke-worker.mjs"), { workerData: { buildDirectory: build, facadePath: pathToFileURL(path.join(out, "sketcher-python-family-facade.js")).href, envelopePath: pathToFileURL(path.join(out, "facade-envelope.js")).href } });
|
|
const receive = () => new Promise((resolve, reject) => { const onMessage = (value) => { worker.off("error", reject); resolve(value); }; worker.once("message", onMessage); worker.once("error", reject); });
|
|
const ready = await receive();
|
|
const successRequest = facade.createSketcherPythonFamilyRequest("sketcher-family-success-1", records); worker.postMessage(successRequest); const facadeSuccess = await receive();
|
|
worker.postMessage(successRequest); const duplicate = await receive();
|
|
const cancelRequest = facade.createSketcherPythonFamilyRequest("sketcher-family-cancel-1", records); const cancelledPromise = new Promise((resolve, reject) => { const onMessage = (value) => { if (value.requestId === cancelRequest.requestId) { worker.off("error", reject); resolve(value); } }; worker.on("message", onMessage); worker.once("error", reject); }); worker.postMessage(cancelRequest); worker.postMessage(envelope.createCancel("sketcher-family-cancel-control", cancelRequest.requestId, "sketcher-python-family")); const cancelled = await cancelledPromise;
|
|
const crossRequest = facade.createSketcherPythonFamilyRequest("sketcher-family-cross-1", [{ ...records[0], apiId: "py:BIM:class:Constraint" }]); worker.postMessage(crossRequest); const facadeCross = await receive();
|
|
worker.postMessage({ kind: "reset", requestId: "sketcher-family-reset-1" }); const reset = await receive(); worker.postMessage(facade.createSketcherPythonFamilyRequest("sketcher-family-after-reset-1", records.slice(0, 1))); const afterReset = await receive(); await worker.terminate();
|
|
if (ready.kind !== "ready" || facadeSuccess.kind !== "result" || facadeSuccess.result.records.length !== 20 || facadeSuccess.result.resourcesReleased !== true || duplicate.error?.code !== "duplicate_request" || cancelled.error?.code !== "cancelled" || facadeCross.result.records[0].code !== "unmatched_source_record" || reset.requestId !== "sketcher-family-reset-1" || afterReset.kind !== "result") throw new Error("Sketcher family facade sequencing failed");
|
|
const trace = { ready, success: facadeSuccess, duplicate, cancelled, crossModule: facadeCross, reset, afterReset };
|
|
const traceSha256 = hash(trace);
|
|
const facadeReport = { schema: "freecad-web-p6-sketcher-tier1-readonly-family-facade/v1", taskId: "FW-P6-FPA-F1-SKETCHER", module: "Sketcher", command: facade.SKETCHER_PYTHON_FAMILY_COMMAND, result: "pass", envelopeSchema: envelope.FACADE_SCHEMA, typedSchema: facade.SKETCHER_PYTHON_FAMILY_SCHEMA, trace, traceSha256, sequencing: { requestCount: 5, responseCount: 7, maxActive: 1, cancelAccepted: true, resetAccepted: true }, schemaChecks: { nativeSource: facadeSuccess.result.source === "freecad-source", resourcesReleased: facadeSuccess.result.resourcesReleased === true, terminalStatuses: facadeSuccess.result.records.every((record) => terminal.has(record.status)), noNativePointers: !JSON.stringify(trace).match(/pointer/i) }, artifacts: { native: "docs/p6/sketcher-tier1-readonly-family-runtime.json", worker: "web/src/sketcher-python.worker.ts", facade: "web/src/sketcher-python-family-facade.ts" } };
|
|
fs.writeFileSync(path.join(root, "docs/p6/sketcher-tier1-readonly-family-facade.json"), `${JSON.stringify(facadeReport, null, 2)}\n`);
|
|
fs.writeFileSync(path.join(root, "docs/freecad-p6-sketcher-tier1-readonly-family-facade.log"), `${JSON.stringify({ result: facadeReport.result, traceSha256, cancel: cancelled.error.code, reset: reset.requestId })}\n`);
|
|
console.log(JSON.stringify({ result: facadeReport.result, traceSha256, cancel: cancelled.error.code, reset: reset.requestId }));
|