#!/usr/bin/env node import { spawn } from "node:child_process"; import { createHash } from "node:crypto"; import { createConnection } from "node:net"; import { mkdir, readFile, writeFile } from "node:fs/promises"; import path from "node:path"; import { fileURLToPath, pathToFileURL } from "node:url"; import { chromium } from "playwright"; const rootDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), ".."); const outDir = process.argv[3] ?? process.env.MOTRIXSIM_PRODUCT_OUT ?? "test-results/product-readiness"; const defaultManifestUrl = process.env.MOTRIXSIM_MANIFEST_URL ?? "http://127.0.0.1:18090/manifest"; const frontendMode = process.env.MOTRIXSIM_PRODUCT_FRONTEND_MODE === "preview" ? "preview" : "dev"; const failOnWarn = process.env.MOTRIXSIM_PRODUCT_FAIL_ON_WARN === "1"; const defaultFrontendPort = process.env.MOTRIXSIM_PRODUCT_FRONTEND_PORT ?? (frontendMode === "preview" ? "4173" : "5173"); const explicitFrontendUrl = process.argv[2] ?? process.env.MOTRIXSIM_WEB_URL; const expectedPhysicalRobotPose = [1.85, -0.95, 0]; const backendStoreSceneId = "g1-store-blocks-physics"; function defaultFrontendUrl(port = defaultFrontendPort) { return `http://127.0.0.1:${port}/?manifest=${encodeURIComponent(defaultManifestUrl)}&v=product-readiness`; } let frontendUrl = new URL(explicitFrontendUrl ?? defaultFrontendUrl()); const manifestUrl = frontendUrl.searchParams.get("manifest") ?? defaultManifestUrl; const thresholds = { minObjects: Number(process.env.MIN_PRODUCT_OBJECTS ?? "500"), minMeshes: Number(process.env.MIN_PRODUCT_MESHES ?? "100"), minBodyBindings: Number(process.env.MIN_PRODUCT_BINDINGS ?? "500"), minEditableGroups: Number(process.env.MIN_PRODUCT_GROUPS ?? "1"), minGroupedObjects: Number(process.env.MIN_PRODUCT_GROUPED_OBJECTS ?? "500"), minMobileObjects: Number(process.env.MIN_PRODUCT_MOBILE_OBJECTS ?? "100"), minMobileMeshes: Number(process.env.MIN_PRODUCT_MOBILE_MESHES ?? "20"), targetUiControlMs: Number(process.env.TARGET_PRODUCT_UI_CONTROL_MS ?? "3000"), maxUiControlMs: Number(process.env.MAX_PRODUCT_UI_CONTROL_MS ?? "6000"), browserReadyMs: Number(process.env.PRODUCT_BROWSER_READY_MS ?? "180000"), minEvidenceImageBytes: Number(process.env.MIN_PRODUCT_EVIDENCE_IMAGE_BYTES ?? "10000"), minEvidenceExportBytes: Number(process.env.MIN_PRODUCT_EVIDENCE_EXPORT_BYTES ?? "1000"), }; const checks = []; let startedFrontend; function check(id, stateOrOk, detail, level = "fail") { const state = typeof stateOrOk === "boolean" ? (stateOrOk ? "pass" : level) : stateOrOk; checks.push({ id, state, detail }); } function summarize(items) { const failed = items.filter((item) => item.state === "fail").length; const warned = items.filter((item) => item.state === "warn").length; const passed = items.filter((item) => item.state === "pass").length; return { result: failed > 0 ? "fail" : warned > 0 ? "warn" : "pass", passed, warned, failed, total: items.length, }; } function logProgress(message) { process.stderr.write(`[product-gate] ${message}\n`); } async function withTimeout(label, promise, timeoutMs = 15000) { let timeout; try { return await Promise.race([ promise, new Promise((_, reject) => { timeout = setTimeout(() => reject(new Error(`${label} timed out after ${timeoutMs}ms`)), timeoutMs); }), ]); } finally { clearTimeout(timeout); } } async function closeContext(context, label) { try { await withTimeout(label, context.close(), 15000); } catch (error) { check(`${label}-close`, "warn", error.message); } } async function closeBrowser(browser) { try { await withTimeout("browser.close", browser.close(), 15000); } catch (error) { check("browser-close", "warn", error.message); } } function run(args, options = {}) { const [bin, ...rest] = args; return new Promise((resolve) => { const child = spawn(bin, rest, { cwd: rootDir, stdio: ["ignore", "pipe", "pipe"], ...options.spawn, }); let stdout = ""; let stderr = ""; child.stdout?.on("data", (chunk) => { stdout += chunk; }); child.stderr?.on("data", (chunk) => { stderr += chunk; }); child.on("error", (error) => { resolve({ code: 1, stdout, stderr: `${stderr}${error.message}` }); }); child.on("close", (code) => { resolve({ code: code ?? 1, stdout, stderr }); }); }); } function parseJsonOutput(output) { const start = output.indexOf("{"); const end = output.lastIndexOf("}"); if (start < 0 || end < start) { return undefined; } try { return JSON.parse(output.slice(start, end + 1)); } catch { return undefined; } } async function runJsonStep(id, args) { const result = await run(args); const json = parseJsonOutput(result.stdout); const failed = json?.summary?.failed ?? json?.summary?.fail ?? undefined; const stepOk = result.code === 0 && json && (failed === undefined || failed === 0); check(id, stepOk ? "pass" : "fail", stepOk ? `exit=0 ${json?.summary?.passed ?? "-"} passed` : `exit=${result.code} ${result.stderr.trim() || result.stdout.slice(0, 240)}`); return { ...result, json }; } function outputTail(output = "", maxLines = 24) { return output.split(/\r?\n/).filter(Boolean).slice(-maxLines).join("\n").slice(-4000); } async function runExitStep(id, args, successDetail) { const result = await run(args); check( id, result.code === 0 ? "pass" : "fail", result.code === 0 ? successDetail : `exit=${result.code} ${result.stderr.trim() || outputTail(result.stdout, 8)}`, ); return result; } function shouldEnsureRealBackend() { if (process.env.MOTRIXSIM_PRODUCT_SKIP_BACKEND_UP === "1") { return false; } const url = new URL(manifestUrl); return ["127.0.0.1", "localhost", "::1"].includes(url.hostname) && url.pathname.endsWith("/manifest"); } async function ensureRealBackend() { if (!shouldEnsureRealBackend()) { check("real-backend-up", "pass", "skipped for non-local manifest or explicit opt-out"); return undefined; } return runExitStep( "real-backend-up", ["node", "scripts/real-backend-dev.mjs", "up"], "remote bridge synced, restarted, tunnel checked, and editing verifier passed", ); } function portOpen(host, port, timeoutMs = 700) { return new Promise((resolve) => { const socket = createConnection({ host, port }); const done = (value) => { socket.destroy(); resolve(value); }; socket.setTimeout(timeoutMs); socket.once("connect", () => done(true)); socket.once("timeout", () => done(false)); socket.once("error", () => done(false)); }); } async function fetchOk(url, timeoutMs = 2000) { const controller = new AbortController(); const timeout = setTimeout(() => controller.abort(), timeoutMs); try { const response = await fetch(url, { cache: "no-store", signal: controller.signal }); return response.ok; } catch { return false; } finally { clearTimeout(timeout); } } function controlUrlFromManifest() { const url = new URL(manifestUrl); url.pathname = url.pathname.replace(/\/manifest$/, "/control"); return url.href; } function frontendOrigin() { const url = new URL(frontendUrl.href); return `${url.protocol}//${url.host}`; } function stateUrlFromManifest({ compact = false } = {}) { const url = new URL(manifestUrl); url.pathname = url.pathname.replace(/\/manifest$/, "/state"); if (compact) { url.searchParams.set("compact", "1"); } return url.href; } async function postControl(action) { const response = await fetch(controlUrlFromManifest(), { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ action, compact: true }), }); const text = await response.text(); let json; try { json = JSON.parse(text); } catch { json = { text }; } return { ok: response.ok, status: response.status, json }; } async function fetchState(options) { const response = await fetch(stateUrlFromManifest(options), { cache: "no-store" }); const json = await response.json(); return { ok: response.ok, status: response.status, json }; } async function waitForHttp(url, timeoutMs = 20000) { const deadline = Date.now() + timeoutMs; while (Date.now() < deadline) { if (await fetchOk(url)) { return true; } await new Promise((resolve) => setTimeout(resolve, 300)); } return false; } function frontendPort() { return Number(frontendUrl.port || (frontendUrl.protocol === "https:" ? "443" : "80")); } async function selectAvailableFrontendPort() { if (explicitFrontendUrl) { return; } let port = frontendPort(); for (let attempt = 0; attempt < 20; attempt += 1) { if (!(await portOpen(frontendUrl.hostname, port))) { frontendUrl = new URL(defaultFrontendUrl(String(port))); return; } port += 1; } } function frontendSpawnArgs(port) { if (frontendMode === "preview") { return ["run", "preview", "--", "--host", "127.0.0.1", "--port", String(port), "--strictPort"]; } return ["run", "dev", "--", "--host", "127.0.0.1", "--port", String(port), "--strictPort"]; } async function ensureFrontend() { const forceStart = process.env.MOTRIXSIM_PRODUCT_FORCE_FRONTEND === "1"; if (forceStart) { await selectAvailableFrontendPort(); } const baseUrl = new URL("/", frontendUrl).href; const port = frontendPort(); if (!forceStart && await portOpen(frontendUrl.hostname, port) && await fetchOk(baseUrl)) { check("frontend-server", "pass", `${baseUrl} already available (${frontendMode})`); return; } if (process.env.MOTRIXSIM_PRODUCT_START_FRONTEND === "0") { check("frontend-server", "fail", `${baseUrl} is not available`); return; } startedFrontend = spawn("npm", frontendSpawnArgs(port), { cwd: rootDir, stdio: ["ignore", "pipe", "pipe"], }); const ready = await waitForHttp(baseUrl, 30000); check("frontend-server", ready ? "pass" : "fail", ready ? `${baseUrl} ${frontendMode} started` : `${baseUrl} ${frontendMode} did not start`); } function numericText(text) { const match = String(text ?? "").match(/-?\d+(?:\.\d+)?/); return match ? Number(match[0]) : 0; } function parseGroups(text) { const match = String(text ?? "").match(/(\d+)\s*\/\s*(\d+)/); return { groups: match ? Number(match[1]) : 0, groupedObjects: match ? Number(match[2]) : 0, }; } function acceptanceScoreHasNoFailures(text) { const value = String(text ?? ""); if (value.includes("0 失败") || value.includes("0 fail")) { return true; } const chinese = value.match(/(\d+)\s*失败/); if (chinese) { return Number(chinese[1]) === 0; } const english = value.match(/fail(?:ed|ure|s)?\D+(\d+)/i) ?? value.match(/(\d+)\D+fail(?:ed|ure|s)?/i); return english ? Number(english[1]) === 0 : false; } function backendPhysicsCoverage(profile = {}, objectCount = 0) { return Number(profile.backendFixed ?? 0) >= 1 && (Number(profile.backendDynamic ?? 0) + Number(profile.backendStateOnly ?? 0)) >= 1 && Number(profile.total ?? objectCount) === objectCount && Number(profile.visualOnly ?? Number.POSITIVE_INFINITY) === 0; } function compactStateFrame(state) { return state ? { ok: state.ok, scene: state.scene, step: state.step, paused: state.paused, running: state.running, server_time: state.server_time, bodyCount: Object.keys(state.bodies ?? {}).length, step_ms: state.step_ms, } : state; } async function describeArtifact(filePath) { const absolutePath = path.resolve(rootDir, filePath); const bytes = await readFile(absolutePath); return { path: filePath, bytes: bytes.byteLength, sha256: createHash("sha256").update(bytes).digest("hex"), }; } async function gitOutput(args) { const result = await run(["git", ...args]); return result.code === 0 ? result.stdout.trim() : undefined; } function parseGitRemotes(output = "") { return output .split(/\r?\n/) .map((line) => line.trim()) .filter(Boolean) .map((line) => { const match = line.match(/^(\S+)\s+(\S+)\s+\((fetch|push)\)$/); return match ? { name: match[1], url: match[2], direction: match[3] } : undefined; }) .filter(Boolean); } async function collectGitProvenance() { const [ commit, shortCommit, branch, upstream, committedAt, status, remotes, ] = await Promise.all([ gitOutput(["rev-parse", "HEAD"]), gitOutput(["rev-parse", "--short=12", "HEAD"]), gitOutput(["rev-parse", "--abbrev-ref", "HEAD"]), gitOutput(["rev-parse", "--abbrev-ref", "--symbolic-full-name", "@{u}"]), gitOutput(["show", "-s", "--format=%cI", "HEAD"]), gitOutput(["status", "--porcelain"]), gitOutput(["remote", "-v"]), ]); const dirtyFiles = status ? status.split(/\r?\n/).filter(Boolean) : []; return { commit, shortCommit, branch, upstream, committedAt, dirty: dirtyFiles.length > 0, dirtyFiles, remotes: parseGitRemotes(remotes), }; } function captureStrategy(capture) { return capture?.strategy ?? capture?.fallback ?? "viewport"; } async function collectEvidenceArtifacts(browserEvidence) { const builderCapture = browserEvidence?.screenshots?.builderCompose; const shareRestoreCapture = browserEvidence?.screenshots?.shareRestore; const configImportCapture = browserEvidence?.screenshots?.configImportRestore; const visualOnlyBoundaryCapture = browserEvidence?.screenshots?.visualOnlyBoundary; const desktopCapture = browserEvidence?.screenshots?.desktop; const debugCapture = browserEvidence?.screenshots?.debugCapture; const mobileCapture = browserEvidence?.screenshots?.mobile; const builderConfigExport = browserEvidence?.exports?.builderConfig; const packageExport = browserEvidence?.exports?.package; const reportExport = browserEvidence?.exports?.report; const builderCompose = builderCapture ? { ...(await describeArtifact(builderCapture.path)), strategy: captureStrategy(builderCapture), viewport: browserEvidence?.builderCompose?.viewport, builderStatus: browserEvidence?.builderCompose?.builderStatus, summaryProps: browserEvidence?.builderCompose?.summaryProps, } : undefined; const shareRestore = shareRestoreCapture ? { ...(await describeArtifact(shareRestoreCapture.path)), strategy: captureStrategy(shareRestoreCapture), linkHasBuilderParam: browserEvidence?.shareLink?.hasBuilderParam, restoredStatus: browserEvidence?.shareRestore?.workspaceStatus, summaryProps: browserEvidence?.shareRestore?.stats?.summaryProps, } : undefined; const configImportRestore = configImportCapture ? { ...(await describeArtifact(configImportCapture.path)), strategy: captureStrategy(configImportCapture), restoredStatus: browserEvidence?.configImportRestore?.workspaceStatus, summaryProps: browserEvidence?.configImportRestore?.stats?.summaryProps, } : undefined; const visualOnlyBoundary = visualOnlyBoundaryCapture ? { ...(await describeArtifact(visualOnlyBoundaryCapture.path)), strategy: captureStrategy(visualOnlyBoundaryCapture), acceptanceState: browserEvidence?.visualOnlyBoundary?.stats?.acceptanceTelemetry?.state, acceptanceScore: browserEvidence?.visualOnlyBoundary?.stats?.acceptanceScore, builderPhysics: browserEvidence?.visualOnlyBoundary?.stats?.builderPhysics, } : undefined; const desktop = { ...(await describeArtifact(desktopCapture?.path ?? "")), strategy: captureStrategy(desktopCapture), canvas: browserEvidence?.desktop?.canvas, }; const mobile = { ...(await describeArtifact(mobileCapture?.path ?? "")), strategy: captureStrategy(mobileCapture), canvas: browserEvidence?.mobile?.canvas, }; const debugPng = debugCapture ? { ...(await describeArtifact(debugCapture.path)), strategy: captureStrategy(debugCapture), mime: debugCapture.mime, } : undefined; const validDesktop = desktop.bytes >= thresholds.minEvidenceImageBytes && desktop.sha256.length === 64 && desktop.strategy === "canvas"; const validMobile = mobile.bytes >= thresholds.minEvidenceImageBytes && mobile.sha256.length === 64 && ["canvas", "preview", "page"].includes(mobile.strategy); const validDebugPng = Boolean(debugPng) && debugPng.bytes >= thresholds.minEvidenceImageBytes && debugPng.sha256.length === 64 && debugPng.strategy === "debug-capture" && debugPng.mime === "image/png"; const validBuilderCompose = Boolean(builderCompose) && builderCompose.bytes >= thresholds.minEvidenceImageBytes && builderCompose.sha256.length === 64 && ["page", "preview", "canvas"].includes(builderCompose.strategy); const validShareRestore = Boolean(shareRestore) && shareRestore.bytes >= thresholds.minEvidenceImageBytes && shareRestore.sha256.length === 64 && ["page", "preview", "canvas"].includes(shareRestore.strategy); const validConfigImportRestore = Boolean(configImportRestore) && configImportRestore.bytes >= thresholds.minEvidenceImageBytes && configImportRestore.sha256.length === 64 && ["page", "preview", "canvas"].includes(configImportRestore.strategy); const validVisualOnlyBoundary = Boolean(visualOnlyBoundary) && visualOnlyBoundary.bytes >= thresholds.minEvidenceImageBytes && visualOnlyBoundary.sha256.length === 64 && ["page", "preview", "canvas"].includes(visualOnlyBoundary.strategy) && visualOnlyBoundary.acceptanceState === "pass" && Number(visualOnlyBoundary.builderPhysics?.visualOnly ?? Number.POSITIVE_INFINITY) === 0; const builderConfig = builderConfigExport ? { ...(await describeArtifact(builderConfigExport.path)), suggestedFilename: builderConfigExport.suggestedFilename, version: builderConfigExport.version, sceneId: builderConfigExport.sceneId, robotId: builderConfigExport.robotId, robotPose: builderConfigExport.robotPose, propCount: builderConfigExport.propCount, physics: builderConfigExport.physics, workspaceStatus: builderConfigExport.workspaceStatus, } : undefined; const acceptancePackage = packageExport ? { ...(await describeArtifact(packageExport.path)), suggestedFilename: packageExport.suggestedFilename, schema: packageExport.schema, acceptanceState: packageExport.acceptanceState, passCount: packageExport.passCount, failCount: packageExport.failCount, objectCount: packageExport.objectCount, controlUrl: packageExport.controlUrl, objectPhysics: packageExport.objectPhysics, builderPhysics: packageExport.builderPhysics, } : undefined; const acceptanceReport = reportExport ? { ...(await describeArtifact(reportExport.path)), suggestedFilename: reportExport.suggestedFilename, title: reportExport.title, containsBackendPhysics: reportExport.containsBackendPhysics, containsControlEndpoint: reportExport.containsControlEndpoint, containsPhysicsTiers: reportExport.containsPhysicsTiers, render: reportExport.render ? { ...(await describeArtifact(reportExport.render.path)), title: reportExport.render.title, h1: reportExport.render.h1, verdict: reportExport.render.verdict, caseRowCount: reportExport.render.caseRowCount, checkRowCount: reportExport.render.checkRowCount, containsBackendPhysics: reportExport.render.containsBackendPhysics, containsControlEndpoint: reportExport.render.containsControlEndpoint, containsPhysicsTiers: reportExport.render.containsPhysicsTiers, } : undefined, } : undefined; const validPackage = Boolean(acceptancePackage) && acceptancePackage.bytes >= thresholds.minEvidenceExportBytes && acceptancePackage.sha256.length === 64 && acceptancePackage.schema === "motrixsim-web.acceptance-package.v1" && acceptancePackage.acceptanceState === "pass" && acceptancePackage.failCount === 0 && acceptancePackage.objectCount >= thresholds.minObjects && backendPhysicsCoverage(acceptancePackage.objectPhysics, acceptancePackage.objectCount) && Number(acceptancePackage.builderPhysics?.backendDynamic ?? Number.NaN) === 0 && Number(acceptancePackage.builderPhysics?.visualOnly ?? Number.POSITIVE_INFINITY) === 0 && Number(acceptancePackage.builderPhysics?.total ?? Number.NaN) === 0 && acceptancePackage.builderPhysics?.ready === true && String(acceptancePackage.controlUrl ?? "").includes("/control"); const validBuilderConfig = Boolean(builderConfig) && builderConfig.bytes >= 256 && builderConfig.sha256.length === 64 && builderConfig.version === 1 && builderConfig.sceneId === backendStoreSceneId && vec3Near(builderConfig.robotPose, expectedPhysicalRobotPose) && builderConfig.propCount === 0 && builderConfig.physics?.ready === true && Number(builderConfig.physics?.backendDynamic ?? Number.NaN) === 0 && Number(builderConfig.physics?.visualOnly ?? Number.POSITIVE_INFINITY) === 0 && Number(builderConfig.physics?.total ?? Number.NaN) === 0; const validReport = Boolean(acceptanceReport) && acceptanceReport.bytes >= thresholds.minEvidenceExportBytes && acceptanceReport.sha256.length === 64 && acceptanceReport.containsBackendPhysics === true && acceptanceReport.containsControlEndpoint === true && acceptanceReport.containsPhysicsTiers === true && acceptanceReport.render?.bytes >= thresholds.minEvidenceImageBytes && acceptanceReport.render?.sha256.length === 64 && acceptanceReport.render?.caseRowCount >= 1 && acceptanceReport.render?.checkRowCount >= 1 && acceptanceReport.render?.containsBackendPhysics === true && acceptanceReport.render?.containsControlEndpoint === true && acceptanceReport.render?.containsPhysicsTiers === true; check( "evidence-screenshot-artifacts", validDesktop && validMobile && validDebugPng && validBuilderCompose && validShareRestore && validConfigImportRestore && validVisualOnlyBoundary, `builder ${Math.round((builderCompose?.bytes ?? 0) / 1024)} KiB ${builderCompose?.strategy ?? "-"}; share ${Math.round((shareRestore?.bytes ?? 0) / 1024)} KiB ${shareRestore?.strategy ?? "-"}; import ${Math.round((configImportRestore?.bytes ?? 0) / 1024)} KiB ${configImportRestore?.strategy ?? "-"}; boundary ${Math.round((visualOnlyBoundary?.bytes ?? 0) / 1024)} KiB ${visualOnlyBoundary?.strategy ?? "-"}; desktop ${Math.round(desktop.bytes / 1024)} KiB ${desktop.strategy}; debug ${Math.round((debugPng?.bytes ?? 0) / 1024)} KiB ${debugPng?.strategy ?? "-"}; mobile ${Math.round(mobile.bytes / 1024)} KiB ${mobile.strategy}`, ); check( "evidence-export-artifacts", validPackage && validReport && validBuilderConfig, `config ${Math.round((builderConfig?.bytes ?? 0) / 1024)} KiB v${builderConfig?.version ?? "-"}; package ${Math.round((acceptancePackage?.bytes ?? 0) / 1024)} KiB ${acceptancePackage?.schema ?? "-"}; report ${Math.round((acceptanceReport?.bytes ?? 0) / 1024)} KiB; rendered ${Math.round((acceptanceReport?.render?.bytes ?? 0) / 1024)} KiB`, ); return { screenshots: { builderCompose, shareRestore, configImportRestore, visualOnlyBoundary, desktop, debugPng, mobile, }, exports: { builderConfig, acceptancePackage, acceptanceReport, }, }; } async function readBrowserStats(page) { return page.evaluate(() => { const text = (selector) => document.querySelector(selector)?.textContent?.trim() ?? ""; const numberData = (key) => { const raw = document.documentElement.dataset[key]; if (raw === undefined || raw.trim() === "") { return undefined; } const parsed = Number(raw); return Number.isFinite(parsed) ? parsed : undefined; }; const data = document.documentElement.dataset; const canvas = document.querySelector("canvas"); return { lang: document.documentElement.lang, title: document.title, h1: text("h1"), status: text("#status"), stateStatus: text("#state-status"), controlStatus: text("#control-status"), sourceLabel: text("#viewport-source-label"), projectSource: text("#project-simulation-source"), builderStatus: text("#builder-status"), summaryProps: text("#summary-props"), summaryPhysics: text("#summary-physics"), manifest: text("#stat-manifest"), objects: text("#stat-objects"), bindings: text("#stat-bindings"), groups: text("#stat-groups"), meshes: text("#stat-meshes"), fallbacks: text("#stat-fallbacks"), physics: text("#stat-physics"), step: text("#stat-step"), paused: text("#stat-paused"), pixels: text("#stat-pixels"), acceptanceVerdict: text("#acceptance-verdict"), acceptanceScore: text("#acceptance-score"), acceptanceTelemetry: { runAt: data.acceptanceRunAt, elapsedMs: numberData("acceptanceElapsedMs"), state: data.acceptanceState, passCount: numberData("acceptancePassCount"), warnCount: numberData("acceptanceWarnCount"), failCount: numberData("acceptanceFailCount"), total: numberData("acceptanceTotal"), }, runState: text("#viewport-run-state"), builderSceneTelemetry: window.__motrixPreviewDebug?.getBuilderSceneTelemetry?.() ?? window.__motrixBuilderSceneTelemetry?.current, physicsTiers: { backendDynamic: numberData("physicsBackendDynamic"), backendFixed: numberData("physicsBackendFixed"), backendStateOnly: numberData("physicsBackendStateOnly"), visualOnly: numberData("physicsVisualOnly"), total: numberData("physicsTotalObjects"), }, builderPhysics: { backendDynamic: numberData("builderBackendDynamic"), visualOnly: numberData("builderVisualOnly"), total: numberData("builderTotalObjects"), ready: data.builderPhysicsReady === "true", }, renderPerformance: { largeSceneMode: data.largeSceneMode === "true", targetRenderFps: numberData("targetRenderFps"), actualRenderFps: numberData("actualRenderFps"), renderPixelRatio: numberData("renderPixelRatio"), preserveDrawingBufferEnabled: data.preserveDrawingBufferEnabled === "true", shadowsEnabled: data.shadowsEnabled === "true", renderSkipCount: numberData("renderSkipCount"), lastRenderDurationMs: numberData("lastRenderDurationMs"), readbackRenderCount: numberData("readbackRenderCount"), controlsUpdateCount: numberData("controlsUpdateCount"), controlsUpdateSkippedCount: numberData("controlsUpdateSkippedCount"), hoverPickIntervalMs: numberData("hoverPickIntervalMs"), sceneLoadTotalMs: numberData("sceneLoadTotalMs"), sceneLoadConfigureMs: numberData("sceneLoadConfigureMs"), sceneLoadMaterialsMs: numberData("sceneLoadMaterialsMs"), sceneLoadHelpersMs: numberData("sceneLoadHelpersMs"), sceneLoadObjectsMs: numberData("sceneLoadObjectsMs"), sceneLoadEditableRefreshMs: numberData("sceneLoadEditableRefreshMs"), sceneLoadCameraFitMs: numberData("sceneLoadCameraFitMs"), instancedMeshPrewarmCount: numberData("instancedMeshPrewarmCount"), instancedMeshPrewarmMs: numberData("instancedMeshPrewarmMs"), instancedMeshFinalizeMs: numberData("instancedMeshFinalizeMs"), frozenStaticObjectCount: numberData("frozenStaticObjectCount"), preFrozenMeshCloneCount: numberData("preFrozenMeshCloneCount"), spinningScanSkippedCount: numberData("spinningScanSkippedCount"), instancedMeshObjectCount: numberData("instancedMeshObjectCount"), instancedMeshBatchCount: numberData("instancedMeshBatchCount"), instancedMeshDrawCount: numberData("instancedMeshDrawCount"), instancedMeshMatrixUpdateCount: numberData("instancedMeshMatrixUpdateCount"), instancedMeshFrustumCulledCount: numberData("instancedMeshFrustumCulledCount"), instancedMeshStaticMatrixCount: numberData("instancedMeshStaticMatrixCount"), instancedLocalObjectElisionCount: numberData("instancedLocalObjectElisionCount"), virtualInstancedRootCount: numberData("virtualInstancedRootCount"), manualMatrixRootCount: numberData("manualMatrixRootCount"), manualMatrixUpdateCount: numberData("manualMatrixUpdateCount"), primitiveGeometryCount: numberData("primitiveGeometryCount"), pickProxyCount: numberData("pickProxyCount"), hoverPickTargetCount: numberData("hoverPickTargetCount"), appliedBodyStateCount: numberData("appliedBodyStateCount"), skippedBodyStateCount: numberData("skippedBodyStateCount"), unchangedFrameCount: numberData("unchangedFrameCount"), dragMoveEventCount: numberData("dragMoveEventCount"), dragCoalescedMoveCount: numberData("dragCoalescedMoveCount"), dragAppliedMoveCount: numberData("dragAppliedMoveCount"), releasedGeometryCount: numberData("releasedGeometryCount"), releasedMaterialCount: numberData("releasedMaterialCount"), releasedTextureCount: numberData("releasedTextureCount"), meshSourceLoadLimit: numberData("meshSourceLoadLimit"), activeMeshSourceLoadCount: numberData("activeMeshSourceLoadCount"), peakMeshSourceLoadCount: numberData("peakMeshSourceLoadCount"), queuedMeshSourceLoadCount: numberData("queuedMeshSourceLoadCount"), meshCacheSourceCount: numberData("meshCacheSourceCount"), meshCacheHitCount: numberData("meshCacheHitCount"), meshCacheMissCount: numberData("meshCacheMissCount"), fastObjParseCount: numberData("fastObjParseCount"), fastObjLineScanCount: numberData("fastObjLineScanCount"), fastObjStreamChunkCount: numberData("fastObjStreamChunkCount"), fastObjStreamByteCount: numberData("fastObjStreamByteCount"), objLoaderFallbackCount: numberData("objLoaderFallbackCount"), fastStlParseCount: numberData("fastStlParseCount"), fastStlTriangleCount: numberData("fastStlTriangleCount"), fastStlByteCount: numberData("fastStlByteCount"), stlLoaderFallbackCount: numberData("stlLoaderFallbackCount"), retainedMeshGeometryCount: numberData("retainedMeshGeometryCount"), retainedMeshMaterialCount: numberData("retainedMeshMaterialCount"), sceneObjectBoundsCount: numberData("sceneObjectBoundsCount"), fastPickProxyBoundsCount: numberData("fastPickProxyBoundsCount"), pickBoundsScratchTransformCount: numberData("pickBoundsScratchTransformCount"), meshSourceBoundsCount: numberData("meshSourceBoundsCount"), hoverProxyBoundsHitCount: numberData("hoverProxyBoundsHitCount"), hoverCachedBoundsHitCount: numberData("hoverCachedBoundsHitCount"), hoverRootBoundsFallbackCount: numberData("hoverRootBoundsFallbackCount"), cameraFitTraversalCount: numberData("cameraFitTraversalCount"), sceneLoadSuppressedRenderCount: numberData("sceneLoadSuppressedRenderCount"), sceneBuildYieldCount: numberData("sceneBuildYieldCount"), statePayloadBodyCount: numberData("statePayloadBodyCount"), mergedBodyStateCount: numberData("mergedBodyStateCount"), reducedStateFrameCount: numberData("reducedStateFrameCount"), incrementalBodyMergeCount: numberData("incrementalBodyMergeCount"), stateBasePollIntervalMs: numberData("stateBasePollIntervalMs"), statePausedPollIntervalMs: numberData("statePausedPollIntervalMs"), stateLastScheduledPollIntervalMs: numberData("stateLastScheduledPollIntervalMs"), statePollRequestCount: numberData("statePollRequestCount"), stateActivePollRequestCount: numberData("stateActivePollRequestCount"), statePausedPollRequestCount: numberData("statePausedPollRequestCount"), stateParsedPollFrameCount: numberData("stateParsedPollFrameCount"), stateForwardedPollFrameCount: numberData("stateForwardedPollFrameCount"), stateSkippedDuplicatePollFrameCount: numberData("stateSkippedDuplicatePollFrameCount"), stateHashedPollFrameCount: numberData("stateHashedPollFrameCount"), stateSkippedDuplicateHashPollFrameCount: numberData("stateSkippedDuplicateHashPollFrameCount"), stateSkippedDuplicateSemanticPollFrameCount: numberData("stateSkippedDuplicateSemanticPollFrameCount"), stateNotModifiedPollFrameCount: numberData("stateNotModifiedPollFrameCount"), batchedSceneRootCount: numberData("batchedSceneRootCount"), sceneRootBatchCount: numberData("sceneRootBatchCount"), objectPhysicsProfileCacheHitCount: numberData("objectPhysicsProfileCacheHitCount"), objectPhysicsProfileCacheMissCount: numberData("objectPhysicsProfileCacheMissCount"), builderPhysicsProfileCacheHitCount: numberData("builderPhysicsProfileCacheHitCount"), builderPhysicsProfileCacheMissCount: numberData("builderPhysicsProfileCacheMissCount"), textWriteCount: numberData("textWriteCount"), textWriteSkipCount: numberData("textWriteSkipCount"), textSelectorCacheHitCount: numberData("textSelectorCacheHitCount"), textSelectorCacheMissCount: numberData("textSelectorCacheMissCount"), diagnosticsPanelRenderCount: numberData("diagnosticsPanelRenderCount"), diagnosticsPanelSkipCount: numberData("diagnosticsPanelSkipCount"), statsRefreshIntervalMs: numberData("statsRefreshIntervalMs"), statsRefreshRenderCount: numberData("statsRefreshRenderCount"), statsRefreshSkipCount: numberData("statsRefreshSkipCount"), builderPanelRenderCount: numberData("builderPanelRenderCount"), builderPanelDeferredRenderCount: numberData("builderPanelDeferredRenderCount"), builderPanelCoalescedRenderCount: numberData("builderPanelCoalescedRenderCount"), }, diagnostics: { manifestUrl: text("#diag-manifest-url"), stateUrl: text("#diag-state-url"), controlUrl: text("#diag-control-url"), source: text("#diag-source"), lastControl: text("#diag-last-control"), latency: text("#diag-control-latency"), acceptanceLatency: text("#diag-acceptance-latency"), binding: text("#diag-binding"), physicsTiers: text("#diag-physics-tiers"), builderPhysics: text("#diag-builder-physics"), assets: text("#diag-assets"), renderPerformance: text("#diag-render-performance"), status: text("#diagnostics-status"), }, canvas: canvas ? { width: canvas.width, height: canvas.height, clientWidth: canvas.clientWidth, clientHeight: canvas.clientHeight, } : null, }; }); } function numberOrDash(value) { return Number.isFinite(Number(value)) ? Math.round(Number(value)) : "-"; } function builderSceneTelemetryDetail(telemetry) { if (!telemetry) { return "telemetry=missing"; } return [ `telemetry=${numberOrDash(telemetry.totalMs)}ms`, `compose=${numberOrDash(telemetry.composeMs)}ms`, `preview=${numberOrDash(telemetry.previewLoadMs)}ms`, `state=${numberOrDash(telemetry.stateConnectMs)}ms`, `stats=${numberOrDash(telemetry.statsRenderMs)}ms`, `pixelWait=${numberOrDash(telemetry.pixelProofWaitMs)}ms`, `pixel=${numberOrDash(telemetry.pixelProofMs)}ms`, `load=${numberOrDash(telemetry.loadResolvedManifestMs)}ms`, `drag=${numberOrDash(telemetry.dragSetupMs)}ms`, `reset=${numberOrDash(telemetry.resetMs)}ms`, `cached=${telemetry.cached ?? "-"}`, `resetApplied=${telemetry.resetApplied ?? "-"}`, ].join(" "); } function hasValidBuilderSceneTelemetry(telemetry) { return telemetry && telemetry.schema === "motrixsim-web.builder-scene-telemetry.v1" && telemetry.backendCompose === true && Number(telemetry.totalMs) > 0 && Number(telemetry.composeMs) >= 0 && Number(telemetry.previewLoadMs) > 0 && Number(telemetry.loadResolvedManifestMs) >= Number(telemetry.previewLoadMs) && Number(telemetry.statsRenderMs) >= 0 && Number(telemetry.pixelProofMs) > 0 && telemetry.resetApplied === true && !telemetry.error; } async function waitForStableBodyStateCache(page) { await page.waitForFunction(([minBindings]) => { const skipped = Number(document.documentElement.dataset.skippedBodyStateCount ?? "0"); const payload = Number(document.documentElement.dataset.statePayloadBodyCount ?? "0"); const merged = Number(document.documentElement.dataset.mergedBodyStateCount ?? "0"); const reduced = Number(document.documentElement.dataset.reducedStateFrameCount ?? "0"); const paused = document.querySelector("#stat-paused")?.textContent?.trim() === "true"; return paused && skipped > 0 && reduced > 0 && payload > 0 && payload < minBindings && merged >= minBindings; }, [thresholds.minBodyBindings], { polling: 100, timeout: thresholds.browserReadyMs }); return readBrowserStats(page); } async function waitForAdaptiveStatePolling(page) { const before = await readBrowserStats(page); const beforePausedPolls = before.renderPerformance?.statePausedPollRequestCount ?? 0; const beforeDuplicateSkips = before.renderPerformance?.stateSkippedDuplicatePollFrameCount ?? 0; await page.waitForFunction(([previousPausedPolls, previousDuplicateSkips]) => { const data = document.documentElement.dataset; const base = Number(data.stateBasePollIntervalMs ?? "0"); const paused = Number(data.statePausedPollIntervalMs ?? "0"); const scheduled = Number(data.stateLastScheduledPollIntervalMs ?? "0"); const activePolls = Number(data.stateActivePollRequestCount ?? "0"); const pausedPolls = Number(data.statePausedPollRequestCount ?? "0"); const parsedFrames = Number(data.stateParsedPollFrameCount ?? "0"); const forwardedFrames = Number(data.stateForwardedPollFrameCount ?? "0"); const skippedDuplicates = Number(data.stateSkippedDuplicatePollFrameCount ?? "0"); const hashedFrames = Number(data.stateHashedPollFrameCount ?? "0"); const hashSkippedFrames = Number(data.stateSkippedDuplicateHashPollFrameCount ?? "0"); const notModifiedFrames = Number(data.stateNotModifiedPollFrameCount ?? "0"); return base > 0 && base <= 80 && paused >= 2000 && scheduled >= paused && activePolls > 0 && pausedPolls > previousPausedPolls && skippedDuplicates > previousDuplicateSkips && forwardedFrames > 0 && parsedFrames >= forwardedFrames && hashedFrames >= pausedPolls && hashSkippedFrames > 0 && notModifiedFrames > 0 && parsedFrames < pausedPolls; }, [beforePausedPolls, beforeDuplicateSkips], { polling: 100, timeout: 10000 }); const stats = await readBrowserStats(page); const perf = stats.renderPerformance ?? {}; return { ok: (perf.stateBasePollIntervalMs ?? Number.POSITIVE_INFINITY) <= 80 && (perf.statePausedPollIntervalMs ?? 0) >= 2000 && (perf.stateLastScheduledPollIntervalMs ?? 0) >= (perf.statePausedPollIntervalMs ?? Number.POSITIVE_INFINITY) && (perf.stateActivePollRequestCount ?? 0) > 0 && (perf.statePausedPollRequestCount ?? 0) > beforePausedPolls && (perf.stateSkippedDuplicatePollFrameCount ?? 0) > beforeDuplicateSkips && (perf.stateForwardedPollFrameCount ?? 0) > 0 && (perf.stateParsedPollFrameCount ?? 0) >= (perf.stateForwardedPollFrameCount ?? Number.POSITIVE_INFINITY) && (perf.stateHashedPollFrameCount ?? 0) >= (perf.statePausedPollRequestCount ?? Number.POSITIVE_INFINITY) && (perf.stateSkippedDuplicateHashPollFrameCount ?? 0) > 0 && (perf.stateNotModifiedPollFrameCount ?? 0) > 0 && (perf.stateParsedPollFrameCount ?? Number.POSITIVE_INFINITY) < (perf.statePausedPollRequestCount ?? 0), before, stats, detail: `poll=${perf.stateBasePollIntervalMs ?? "-"}/${perf.statePausedPollIntervalMs ?? "-"}/${perf.stateLastScheduledPollIntervalMs ?? "-"}ms requests=${perf.statePollRequestCount ?? "-"}/${perf.stateActivePollRequestCount ?? "-"}/${perf.statePausedPollRequestCount ?? "-"} semantic=${perf.stateParsedPollFrameCount ?? "-"}/${perf.stateForwardedPollFrameCount ?? "-"}/${perf.stateSkippedDuplicatePollFrameCount ?? "-"} hash=${perf.stateHashedPollFrameCount ?? "-"}/${perf.stateSkippedDuplicateHashPollFrameCount ?? "-"}/${perf.stateSkippedDuplicateSemanticPollFrameCount ?? "-"} notModified=${perf.stateNotModifiedPollFrameCount ?? "-"} before=${beforePausedPolls}/${beforeDuplicateSkips}`, }; } async function exerciseHoverProxyBounds(page) { const before = await readBrowserStats(page); const beforeHits = before.renderPerformance?.hoverProxyBoundsHitCount ?? 0; const beforeCachedHits = before.renderPerformance?.hoverCachedBoundsHitCount ?? 0; const canvasBox = await page.locator("canvas").boundingBox(); if (!canvasBox) { return { ok: false, before, stats: before, hoverText: "", detail: "canvas not found" }; } const fractions = [0.5, 0.35, 0.65, 0.2, 0.8]; let stats = before; let hoverText = ""; let point = ""; for (const fy of fractions) { for (const fx of fractions) { const x = canvasBox.x + canvasBox.width * fx; const y = canvasBox.y + canvasBox.height * fy; point = `${fx.toFixed(2)},${fy.toFixed(2)}`; await page.mouse.move(x, y); await page.waitForTimeout(90); stats = await readBrowserStats(page); hoverText = await page.locator("#hover-target").textContent().catch(() => "") ?? ""; if ( (stats.renderPerformance?.hoverProxyBoundsHitCount ?? 0) > beforeHits && (stats.renderPerformance?.hoverCachedBoundsHitCount ?? 0) > beforeCachedHits && hoverText.trim() ) { return { ok: true, before, stats, hoverText: hoverText.trim(), point }; } } } return { ok: (stats.renderPerformance?.hoverProxyBoundsHitCount ?? 0) > beforeHits && (stats.renderPerformance?.hoverCachedBoundsHitCount ?? 0) > beforeCachedHits, before, stats, hoverText: hoverText.trim(), point, }; } async function exerciseBuilderDragPanelCoalescing(page) { const before = await readBrowserStats(page); const summaryProps = numericText(before.summaryProps); if (summaryProps === 0) { return { ok: true, skipped: true, before, stats: before, detail: "no builder props in stocked shelf scene; drag coalescing is not applicable", }; } const target = await page.evaluate(() => { const rows = Array.from(document.querySelectorAll("[data-select-prop]")); for (const row of rows) { const id = row instanceof HTMLElement ? row.dataset.selectProp : undefined; const point = id ? window.__motrixPreviewDebug?.getObjectScreenPoint?.(id) : undefined; if (id && point?.visible) { return { id, point }; } } return undefined; }); if (!target?.point?.visible) { return { ok: false, before, stats: before, point: target?.point, detail: "visible builder prop screen point unavailable" }; } const point = target.point; await page.mouse.move(point.x, point.y); await page.waitForTimeout(80); await page.mouse.down(); await page.mouse.move(point.x + 84, point.y - 28, { steps: 28 }); await page.mouse.up(); await page.waitForTimeout(260); const stats = await readBrowserStats(page); const beforeCoalesced = before.renderPerformance?.builderPanelCoalescedRenderCount ?? 0; const beforeDeferred = before.renderPerformance?.builderPanelDeferredRenderCount ?? 0; const beforeRendered = before.renderPerformance?.builderPanelRenderCount ?? 0; const beforeDragEvents = before.renderPerformance?.dragMoveEventCount ?? 0; const beforeDragApplied = before.renderPerformance?.dragAppliedMoveCount ?? 0; const beforeDragCoalesced = before.renderPerformance?.dragCoalescedMoveCount ?? 0; const coalesced = stats.renderPerformance?.builderPanelCoalescedRenderCount ?? 0; const deferred = stats.renderPerformance?.builderPanelDeferredRenderCount ?? 0; const rendered = stats.renderPerformance?.builderPanelRenderCount ?? 0; const dragEvents = stats.renderPerformance?.dragMoveEventCount ?? 0; const dragApplied = stats.renderPerformance?.dragAppliedMoveCount ?? 0; const dragCoalesced = stats.renderPerformance?.dragCoalescedMoveCount ?? 0; return { ok: coalesced > beforeCoalesced && deferred > beforeDeferred && rendered > beforeRendered && dragEvents > beforeDragEvents && dragApplied > beforeDragApplied && dragCoalesced > beforeDragCoalesced && dragApplied < dragEvents, before, stats, point, detail: `target=${target.id} point=${Math.round(point.x)},${Math.round(point.y)} panels=${rendered}/${deferred}/${coalesced} before=${beforeRendered}/${beforeDeferred}/${beforeCoalesced} drag=${dragEvents}/${dragApplied}/${dragCoalesced} beforeDrag=${beforeDragEvents}/${beforeDragApplied}/${beforeDragCoalesced}`, }; } async function waitForProductScene(page) { await page.waitForFunction(([limits]) => { const num = (selector) => Number((document.querySelector(selector)?.textContent ?? "0").match(/-?\d+(?:\.\d+)?/)?.[0] ?? "0"); const status = document.querySelector("#status")?.textContent ?? ""; const groupText = document.querySelector("#stat-groups")?.textContent ?? ""; const groupMatch = groupText.match(/(\d+)\s*\/\s*(\d+)/); const groups = groupMatch ? Number(groupMatch[1]) : 0; const groupedObjects = groupMatch ? Number(groupMatch[2]) : 0; return /已加载 manifest|loaded manifest|manifest loaded/i.test(status) && num("#stat-objects") >= limits.minObjects && num("#stat-bindings") >= limits.minBodyBindings && num("#stat-meshes") >= limits.minMeshes && groups >= limits.minEditableGroups && groupedObjects >= limits.minGroupedObjects && num("#stat-pixels") > 0 && (document.querySelector("#stat-step")?.textContent ?? "-") !== "-"; }, [thresholds], { timeout: thresholds.browserReadyMs }); await page.waitForTimeout(2000); } async function waitForMobileScene(page) { await page.waitForFunction(([limits]) => { const num = (selector) => Number((document.querySelector(selector)?.textContent ?? "0").match(/-?\d+(?:\.\d+)?/)?.[0] ?? "0"); const status = document.querySelector("#status")?.textContent ?? ""; const groupText = document.querySelector("#stat-groups")?.textContent ?? ""; const groupMatch = groupText.match(/(\d+)\s*\/\s*(\d+)/); const groups = groupMatch ? Number(groupMatch[1]) : 0; const groupedObjects = groupMatch ? Number(groupMatch[2]) : 0; return /已加载 manifest|loaded manifest|manifest loaded/i.test(status) && num("#stat-objects") >= limits.minObjects && num("#stat-bindings") >= limits.minBodyBindings && num("#stat-meshes") >= limits.minMeshes && groups >= limits.minEditableGroups && groupedObjects >= limits.minGroupedObjects && num("#stat-pixels") > 0 && (document.querySelector("#stat-step")?.textContent ?? "-") !== "-"; }, [thresholds], { timeout: thresholds.browserReadyMs }); await page.waitForTimeout(1000); } async function captureCanvasScreenshot(page, filePath, pageError, options = {}) { try { await page.locator("canvas").screenshot({ path: filePath, timeout: 15000 }); return options.fallback ? { ok: true, path: filePath, fallback: "canvas", pageError } : { ok: true, path: filePath, strategy: "canvas", pageError }; } catch { return undefined; } } async function captureDebugPng(page, filePath) { try { const dataUrl = await page.evaluate(() => window.__motrixPreviewDebug?.capturePng?.()); if (!dataUrl?.startsWith("data:image/png;base64,")) { return { ok: false, path: filePath, mime: "", bytes: 0, error: "debug capture did not return a PNG data URL" }; } const bytes = Buffer.from(dataUrl.split(",", 2)[1] ?? "", "base64"); await writeFile(filePath, bytes); return { ok: true, path: filePath, strategy: "debug-capture", mime: "image/png", bytes: bytes.length }; } catch (error) { return { ok: false, path: filePath, mime: "", bytes: 0, error: error.message }; } } async function capturePreviewScreenshot(page, filePath, pageError, options = {}) { await page.locator("#preview").screenshot({ path: filePath, timeout: 15000 }); return options.fallback ? { ok: true, path: filePath, fallback: "preview", pageError } : { ok: true, path: filePath, strategy: "preview", pageError }; } async function safeScreenshot(id, page, filePath, options = {}) { if (options.preferCanvas) { const canvasResult = await captureCanvasScreenshot(page, filePath); if (canvasResult) { check(id, "pass", filePath); return canvasResult; } } if (options.preferPreview) { try { const result = await capturePreviewScreenshot(page, filePath); check(id, "pass", filePath); return result; } catch (previewError) { try { const canvasResult = await captureCanvasScreenshot(page, filePath, previewError.message, { fallback: true }); if (canvasResult) { check(id, "pass", `${filePath} (canvas fallback)`); return canvasResult; } } catch { // Fall through to the viewport screenshot path for its more complete error reporting. } } } try { await page.screenshot({ path: filePath, fullPage: false, timeout: 15000 }); check(id, "pass", filePath); return { ok: true, path: filePath }; } catch (pageError) { try { const canvasResult = await captureCanvasScreenshot(page, filePath, pageError.message, { fallback: true }); if (canvasResult) { check(id, "pass", `${filePath} (canvas fallback)`); return canvasResult; } } catch { // Try a DOM-element screenshot below; the original page screenshot error is more useful if both fallbacks fail. } try { await capturePreviewScreenshot(page, filePath, pageError.message, { fallback: true }); check(id, "pass", `${filePath} (preview fallback)`); return { ok: true, path: filePath, fallback: "preview", pageError: pageError.message }; } catch (previewError) { check(id, "warn", `${pageError.message}; preview fallback: ${previewError.message}`); return { ok: false, path: filePath, error: pageError.message, fallbackError: previewError.message }; } } } async function captureBuilderUiScreenshot(page, filePath) { try { await page.screenshot({ path: filePath, fullPage: false, timeout: 30000 }); check("browser-builder-compose-screenshot", "pass", filePath); return { ok: true, path: filePath, strategy: "page" }; } catch { return safeScreenshot("browser-builder-compose-screenshot", page, filePath, { preferPreview: true }); } } async function captureShareRestoreScreenshot(page, filePath) { await page.evaluate(() => { document.querySelector("#workspace-status")?.scrollIntoView({ block: "center", inline: "nearest" }); }); try { await page.screenshot({ path: filePath, fullPage: false, timeout: 30000 }); check("browser-share-link-screenshot", "pass", filePath); return { ok: true, path: filePath, strategy: "page" }; } catch { return safeScreenshot("browser-share-link-screenshot", page, filePath, { preferPreview: true }); } } async function captureConfigImportRestoreScreenshot(page, filePath) { await page.evaluate(() => { document.querySelector("#workspace-status")?.scrollIntoView({ block: "center", inline: "nearest" }); }); try { await page.screenshot({ path: filePath, fullPage: false, timeout: 30000 }); check("browser-builder-config-import-screenshot", "pass", filePath); return { ok: true, path: filePath, strategy: "page" }; } catch (pageError) { return safeScreenshot("browser-builder-config-import-screenshot", page, filePath, { preferPreview: true, pageError: pageError.message, }); } } async function clickButton(page, selector) { const started = performance.now(); await page.evaluate((targetSelector) => { const element = document.querySelector(targetSelector); if (!(element instanceof HTMLButtonElement)) { throw new Error(`button not found: ${targetSelector}`); } element.click(); }, selector); return Math.round(performance.now() - started); } async function clickAndSaveDownload(page, selector, filePath) { const started = performance.now(); const [download, clickMs] = await Promise.all([ page.waitForEvent("download", { timeout: 15000 }), clickButton(page, selector), ]); const suggestedFilename = download.suggestedFilename(); await withTimeout(`save download ${suggestedFilename}`, download.saveAs(filePath), 15000); return { path: filePath, suggestedFilename, clickMs, elapsedMs: Math.round(performance.now() - started), }; } async function renderAcceptanceReportArtifact(page, reportPath) { const reportPage = await page.context().newPage(); const screenshotPath = path.join(outDir, "product-readiness-acceptance-report.jpg"); try { await reportPage.setViewportSize({ width: 1120, height: 900 }); await reportPage.goto(pathToFileURL(path.resolve(reportPath)).href, { waitUntil: "load" }); await reportPage.waitForSelector("table", { timeout: 10000 }); const render = await reportPage.evaluate(() => { const text = (selector) => document.querySelector(selector)?.textContent?.trim() ?? ""; const tables = Array.from(document.querySelectorAll("table")); const bodyText = document.body?.textContent ?? ""; return { title: document.title, h1: text("h1"), verdict: text(".verdict"), caseRowCount: tables[0]?.querySelectorAll("tbody tr").length ?? 0, checkRowCount: tables[1]?.querySelectorAll("tbody tr").length ?? 0, containsBackendPhysics: /后端物理|backend physics/i.test(bodyText), containsControlEndpoint: /\/control/.test(bodyText), containsPhysicsTiers: /backendDynamic|对象物理分层|Object physics tiers/i.test(bodyText), }; }); try { await reportPage.screenshot({ path: screenshotPath, fullPage: false, timeout: 15000 }); } catch { await reportPage.locator("main").screenshot({ path: screenshotPath, timeout: 15000 }); } const renderOk = /MotrixSim Web/i.test(render.title) && render.h1.length > 0 && render.verdict.length > 0 && render.caseRowCount >= 1 && render.checkRowCount >= 1 && render.containsBackendPhysics && render.containsControlEndpoint && render.containsPhysicsTiers; check( "browser-acceptance-report-render", renderOk, `${path.basename(screenshotPath)}; title=${render.title}; cases=${render.caseRowCount}; checks=${render.checkRowCount}; backendPhysics=${render.containsBackendPhysics}; control=${render.containsControlEndpoint}; tiers=${render.containsPhysicsTiers}`, ); return { path: screenshotPath, ...render }; } finally { await reportPage.close(); } } async function exportAcceptanceArtifacts(page) { const packageDownload = await clickAndSaveDownload( page, "#acceptance-export", path.join(outDir, "product-readiness-acceptance-package.json"), ); const packageText = await readFile(packageDownload.path, "utf8"); let packageJson; try { packageJson = JSON.parse(packageText); } catch (error) { packageJson = { parseError: error.message }; } const packageObjectCount = Number(packageJson?.stats?.objectCount ?? 0); const packageControlUrl = packageJson?.diagnostics?.controlUrl; const packagePhysics = packageJson?.diagnostics?.stats?.objectPhysics ?? {}; const packageBuilderPhysics = packageJson?.diagnostics?.stats?.builderPhysics ?? {}; const packageOk = packageJson?.schema === "motrixsim-web.acceptance-package.v1" && packageJson?.acceptance?.state === "pass" && packageJson?.acceptance?.failCount === 0 && packageObjectCount >= thresholds.minObjects && backendPhysicsCoverage(packagePhysics, packageObjectCount) && Number(packageBuilderPhysics.backendDynamic ?? Number.NaN) === 0 && Number(packageBuilderPhysics.visualOnly ?? Number.POSITIVE_INFINITY) === 0 && Number(packageBuilderPhysics.total ?? Number.NaN) === 0 && packageBuilderPhysics.ready === true && String(packageControlUrl ?? "").includes("/control"); check( "browser-acceptance-package-export", packageOk, `${packageDownload.suggestedFilename}; state=${packageJson?.acceptance?.state}; objects=${packageObjectCount}; dynamic=${packagePhysics.backendDynamic ?? "-"}; fixed=${packagePhysics.backendFixed ?? "-"}; builderDynamic=${packageBuilderPhysics.backendDynamic ?? "-"}; builderVisual=${packageBuilderPhysics.visualOnly ?? "-"}; control=${packageControlUrl ?? "-"}`, ); const reportDownload = await clickAndSaveDownload( page, "#acceptance-export-report", path.join(outDir, "product-readiness-acceptance-report.html"), ); const reportHtml = await readFile(reportDownload.path, "utf8"); const reportTitle = reportHtml.match(/