36 lines
11 KiB
JavaScript
36 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-spreadsheet-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/spreadsheet-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 === "FormulaTranslator" || owner === "exprNode") return "src/Mod/Spreadsheet/importXLSX.py"; if (owner.startsWith("ViewProvider")) return "src/Mod/Spreadsheet/Gui/ViewProviderSpreadsheet.pyi"; return `src/Mod/Spreadsheet/App/${owner}.pyi`; };
|
|
const records = manifest.records.filter((row) => row.module === "Spreadsheet" && 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 !== 22) throw new Error(`expected 22 Spreadsheet 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, "FreeCADWebSpreadsheetRuntimeProbe.js")));
|
|
const kernel = await loader.default({ wasmBinary: fs.readFileSync(path.join(build, "FreeCADWebSpreadsheetRuntimeProbe.wasm")), print: () => {}, printErr: () => {} });
|
|
const invoke = (request) => JSON.parse(String(kernel.ccall("fc_web_dispatch_json", "string", ["string"], [JSON.stringify(request)])));
|
|
const request = { cmd: "spreadsheet.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:Sheet" }] } }); const malformed = invoke({ cmd: request.cmd, args: { tier: "tier-2-pure", records } });
|
|
if (success.ok !== true || success.module !== "Spreadsheet" || success.tier !== "tier-1-readonly" || success.count !== records.length || success.resourcesReleased !== true || !Array.isArray(success.records) || success.records.length !== records.length) throw new Error("Spreadsheet 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("Spreadsheet 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 !== 0 || dispositionCounts.restricted !== 3 || dispositionCounts.nonportable !== 0 || dispositionCounts.not_implemented !== 19) throw new Error(`unexpected Spreadsheet disposition counts: ${JSON.stringify(dispositionCounts)}`); if (JSON.stringify(repeated) !== JSON.stringify(success)) throw new Error("Spreadsheet 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("Spreadsheet cross-module boundary failed"); if (malformed.ok !== false || malformed.code !== "invalid_request") throw new Error("Spreadsheet 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 !== "Spreadsheet" || 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/spreadsheet-tier1-readonly-family-runtime.json"]; row.dispositionReason = native.status === "restricted" ? native.message : native.status === "not_implemented" ? native.message : "native Spreadsheet 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-spreadsheet-tier1-readonly-family-runtime/v1", taskId: "FW-P6-FPA-F1-SPREADSHEET", module: "Spreadsheet", tier: "tier-1-readonly", status: "pass_with_restricted_and_pending", sourceRevision: success.records[0]?.sourceRevision, route: { worker: "web/src/spreadsheet-python.worker.ts", facade: "web/src/spreadsheet-python-family-facade.ts", command: request.cmd, native: "freecad-source/src/WebAssembly/FreeCADCoreProbe/SpreadsheetRuntimeProbe.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/FreeCADWebSpreadsheetRuntimeProbe.wasm", sha256: fileHash(path.join(root, "web/public/kernel/FreeCADWebSpreadsheetRuntimeProbe.wasm")) }, loader: { path: "web/public/kernel/FreeCADWebSpreadsheetRuntimeProbe.js", sha256: fileHash(path.join(root, "web/public/kernel/FreeCADWebSpreadsheetRuntimeProbe.js")) } }, boundaries: ["Spreadsheet GUI/view records remain restricted because FreeCADGui/view resources are unavailable in the headless Web runtime.", "Non-GUI Spreadsheet symbols/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/spreadsheet-tier1-readonly-family-runtime.json"), `${JSON.stringify(report, null, 2)}\n`); fs.writeFileSync(path.join(root, "docs/freecad-p6-spreadsheet-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, "spreadsheet-python-family-facade.js"))); const envelope = await import(pathToFileURL(path.join(out, "facade-envelope.js"))); const worker = new Worker(path.join(root, "tools/spreadsheet-python-family-facade-smoke-worker.mjs"), { workerData: { buildDirectory: build, facadePath: pathToFileURL(path.join(out, "spreadsheet-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.createSpreadsheetPythonFamilyRequest("spreadsheet-family-success-1", records); worker.postMessage(successRequest); const facadeSuccess = await receive(); worker.postMessage(successRequest); const duplicate = await receive(); const cancelRequest = facade.createSpreadsheetPythonFamilyRequest("spreadsheet-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("spreadsheet-family-cancel-control", cancelRequest.requestId, "spreadsheet-python-family")); const cancelled = await cancelledPromise; const crossRequest = facade.createSpreadsheetPythonFamilyRequest("spreadsheet-family-cross-1", [{ ...records[0], apiId: "py:BIM:class:Sheet" }]); worker.postMessage(crossRequest); const facadeCross = await receive(); worker.postMessage({ kind: "reset", requestId: "spreadsheet-family-reset-1" }); const reset = await receive(); worker.postMessage(facade.createSpreadsheetPythonFamilyRequest("spreadsheet-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 !== 22 || duplicate.error?.code !== "duplicate_request" || cancelled.error?.code !== "cancelled" || facadeCross.result.records[0].code !== "unmatched_source_record" || reset.requestId !== "spreadsheet-family-reset-1" || afterReset.kind !== "result") throw new Error("Spreadsheet 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-spreadsheet-tier1-readonly-family-facade/v1", taskId: "FW-P6-FPA-F1-SPREADSHEET", module: "Spreadsheet", command: facade.SPREADSHEET_PYTHON_FAMILY_COMMAND, result: "pass", envelopeSchema: envelope.FACADE_SCHEMA, typedSchema: facade.SPREADSHEET_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/spreadsheet-tier1-readonly-family-runtime.json", worker: "web/src/spreadsheet-python.worker.ts", facade: "web/src/spreadsheet-python-family-facade.ts" } }; fs.writeFileSync(path.join(root, "docs/p6/spreadsheet-tier1-readonly-family-facade.json"), `${JSON.stringify(facadeReport, null, 2)}\n`); fs.writeFileSync(path.join(root, "docs/freecad-p6-spreadsheet-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 }));
|