Log cloud repository push completion

结论：Three.js 程序预览和刀具执行显示已收口，公网 HTTP/IP 下 Save/Restore Session 已支持 memory-fallback 降级并通过 node/browser gate。

.gitignore

@@ -4,3 +4,15 @@
 /text.txt
 /test-results/
 /linuxcnc/
+node_modules/
+__pycache__/
+*.py[cod]
+
+# Reproducible browser/QA test artifacts.
+/web-rtcp-5axis-xyzbc-trt-sim-plan/working/screenshots/
+/web-rtcp-5axis-xyzbc-trt-sim-plan/working/pause-position-traces/
+/web-rtcp-5axis-xyzbc-trt-sim-plan/working/state-traces/
+/qa/web-rtcp-5axis-site-test/screenshots/
+/qa/web-rtcp-5axis-site-test/output/**/*.png
+/qa/web-rtcp-5axis-site-test/output/**/*.jpg
+/qa/web-rtcp-5axis-site-test/output/**/*.jpeg

AGENTS.md

@@ -0,0 +1,10 @@
+# AGENTS.md
+
+## Scope
+
+日志记录规则
+每次 GPT/Codex 执行完毕后，须将完整的执行过程日志追加至：
+
+gptlog-process/gpdlog.md
+日至时间戳精确到分钟
+日志包含提问和结论以及完整的执行过程，写入该文件的日志内容必须使用中文记录。

qa/web-rtcp-5axis-site-test/capture-button-control-evidence.mjs

@@ -0,0 +1,493 @@
+import fs from "node:fs/promises";
+import http from "node:http";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import puppeteer from "puppeteer-core";
+import { PNG } from "pngjs";
+
+const REPO_ROOT = path.resolve("/home/meswork/cnc_wams");
+const QA_ROOT = path.join(REPO_ROOT, "qa/web-rtcp-5axis-site-test");
+const OUTPUT_DIR = path.join(QA_ROOT, "output");
+const CHROME_PATH = process.env.CHROME_PATH || process.env.CHROMIUM || "/usr/bin/google-chrome";
+const TARGET_URL = process.env.TARGET_URL || "";
+const APP_URL = process.env.APP_URL || "/web-rtcp-5axis-sim-plan/app/index.html";
+const EVIDENCE_SCOPE = process.env.EVIDENCE_SCOPE || (TARGET_URL ? "cloud-button-control-evidence" : "button-control-evidence");
+const SCREENSHOT_DIR = path.join(QA_ROOT, "screenshots", EVIDENCE_SCOPE);
+const REPORT_BASENAME = `${EVIDENCE_SCOPE}-report`;
+const JOB_ID = process.env.JOB_ID || `btn-${new Date().toISOString().replace(/[-:.TZ]/g, "").slice(0, 14)}-${randomUUID().slice(0, 8)}`;
+const REPORT_ID = process.env.REPORT_ID || `report-${JOB_ID}`;
+
+await fs.mkdir(OUTPUT_DIR, { recursive: true });
+await fs.mkdir(SCREENSHOT_DIR, { recursive: true });
+
+let server = null;
+let targetUrl = TARGET_URL;
+if (!targetUrl) {
+  server = createStaticServer(REPO_ROOT);
+  await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
+  const address = server.address();
+  if (!address || typeof address === "string") throw new Error("failed to start static server");
+  targetUrl = `http://127.0.0.1:${address.port}${APP_URL}`;
+}
+
+const browser = await puppeteer.launch({
+  headless: true,
+  executablePath: CHROME_PATH,
+  defaultViewport: { width: 1500, height: 1050, deviceScaleFactor: 1 },
+  ignoreHTTPSErrors: true,
+  args: [
+    "--ignore-certificate-errors",
+    "--disable-gpu",
+    "--enable-webgl",
+    "--use-angle=swiftshader",
+    "--enable-unsafe-swiftshader",
+    "--no-sandbox",
+  ],
+});
+
+const page = await browser.newPage();
+const consoleErrors = [];
+const pageErrors = [];
+page.on("console", (msg) => {
+  if (msg.type() === "error") consoleErrors.push(msg.text());
+});
+page.on("pageerror", (error) => pageErrors.push(error.message));
+
+const report = {
+  jobId: JOB_ID,
+  reportId: REPORT_ID,
+  evidenceScope: EVIDENCE_SCOPE,
+  generatedAt: new Date().toISOString(),
+  targetUrl,
+  chromePath: CHROME_PATH,
+  screenshotsDir: SCREENSHOT_DIR,
+  steps: [],
+  checks: [],
+  consoleErrors,
+  pageErrors,
+};
+
+try {
+  await page.goto(report.targetUrl, { waitUntil: "networkidle2", timeout: 60000 });
+  await page.waitForSelector('[data-shell="gmoccapy-5axis"]', { timeout: 15000 });
+  await page.waitForFunction(() => Boolean(window.webRtcp5AxisSimulation?.getState), { timeout: 15000 });
+  await page.waitForFunction(() => {
+    const canvas = document.querySelector("[data-five-axis-canvas]");
+    return canvas?.dataset?.threeReady === "true";
+  }, { timeout: 20000 });
+  await windowReady();
+  await captureStep("01-initial", "Initial UI", "Browser app loaded before machine preparation.");
+
+  await loadOperatorProgram();
+  await captureStep("02-program-loaded", "Program loaded", "Short operator G-code loaded through LinuxCNC interpreter WASM.");
+
+  await click("power");
+  await waitForState((state) => state.machine.powerOn === true, 10000, "power on");
+  await click("mode-manual");
+  await waitForState((state) => state.machine.mode === "manual", 10000, "manual mode");
+  await captureStep("03-before-home", "Before HOME", "Machine powered on in manual mode before HOME.");
+
+  await click("HOME");
+  await waitForState((state) => state.machine.allHomed === true && state.machine.mode === "manual", 10000, "HOME complete");
+  await captureStep("04-after-home", "After HOME", "HOME command preserves allHomed state in Web/task gate.");
+
+  await click("mode-auto");
+  await waitForState((state) => state.machine.mode === "auto", 10000, "auto mode");
+  await captureStep("05-ready-for-run", "Ready for RUN", "POWER, HOME, AUTO, and loaded G-code are ready before RUN.");
+
+  await click("RUN");
+  await waitForState((state) => (
+    state.runState === "running" &&
+    state.programRuntimeFeedback?.sourceMode === "linuxcnc-task-motion-hal-wasm"
+  ), 15000, "RUN active");
+  await wait(250);
+  await captureStep("06-after-run", "After RUN", "RUN starts task/HAL backed program execution.");
+
+  await captureStep("07-before-pause", "Before PAUSE", "Program is running before PAUSE.");
+  await click("PAUSE");
+  await waitForState((state) => state.runState === "paused" && state.machine.taskPaused === true, 10000, "PAUSE active");
+  await captureStep("08-after-pause", "After PAUSE", "PAUSE sets runState paused and taskPaused true.");
+
+  await captureStep("09-before-resume", "Before RESUME", "Program is paused before RESUME.");
+  await click("RESUME");
+  await waitForState((state) => state.runState === "running" && state.machine.interpState === "reading", 10000, "RESUME active");
+  await wait(150);
+  await captureStep("10-after-resume", "After RESUME", "RESUME returns task/HAL execution to running/reading.");
+
+  await click("PAUSE");
+  await waitForState((state) => state.runState === "paused" && state.machine.taskPaused === true, 10000, "PAUSE before STEP");
+  await captureStep("11-before-step", "Before STEP", "Program is paused before STEP.");
+
+  await click("STEP");
+  await waitForState((state) => (
+    state.machine.interpState === "paused" &&
+    state.machine.taskPaused === true &&
+    state.taskHalStatus?.task?.singleStepping === true
+  ), 10000, "STEP active");
+  await captureStep("12-after-step", "After STEP", "STEP sends EMC_TASK_PLAN_STEP and leaves task paused with singleStepping true.");
+
+  await captureStep("13-before-stop", "Before STOP", "Paused single-step state before STOP.");
+  await click("STOP");
+  await waitForState((state) => (
+    state.runState === "stopped" &&
+    state.machine.interpState === "idle" &&
+    state.taskHalStatus?.motionStatus?.motion?.aborted === true
+  ), 10000, "STOP active");
+  await captureStep("14-after-stop", "After STOP", "STOP aborts task/HAL motion and returns interpreter state to idle.");
+
+  addChecks();
+  report.status = report.checks.every((check) => check.pass) && pageErrors.length === 0 ? "PASS" : "FAIL";
+
+  const jsonPath = path.join(OUTPUT_DIR, `${REPORT_BASENAME}.json`);
+  report.jsonPath = jsonPath;
+  const pdfPath = path.join(OUTPUT_DIR, `${REPORT_BASENAME}.pdf`);
+  report.pdfPath = pdfPath;
+  await fs.writeFile(jsonPath, `${JSON.stringify(report, null, 2)}\n`, "utf8");
+  await writePdfReport(pdfPath, report);
+  console.log(`button_control_evidence_status=${report.status}`);
+  console.log(`button_control_evidence_job_id=${report.jobId}`);
+  console.log(`button_control_evidence_report_id=${report.reportId}`);
+  console.log(`button_control_evidence_json=${jsonPath}`);
+  console.log(`button_control_evidence_pdf=${pdfPath}`);
+  console.log(`button_control_evidence_screenshots=${SCREENSHOT_DIR}`);
+  if (report.status !== "PASS") process.exitCode = 1;
+} finally {
+  await page.close().catch(() => {});
+  await browser.close().catch(() => {});
+  if (server) await new Promise((resolve) => server.close(resolve));
+}
+
+async function windowReady() {
+  await waitForState((state) => (
+    state.kinematicsRuntimeReadiness?.loaded === true &&
+    state.interpreterRuntimeReadiness?.loaded === true &&
+    state.taskHalRuntimeReadiness?.loaded === true
+  ), 30000, "runtime readiness");
+  await waitForState((state) => (
+    !state.interpreterExecutionPending &&
+    state.machineFileStaging?.status === "staged"
+  ), 30000, "machine file seed ready")
+    .catch(() => null);
+}
+
+async function loadOperatorProgram() {
+  await page.evaluate(() => {
+    window.webRtcp5AxisSimulation.dispatch({
+      type: "LOAD_PROGRAM",
+      filename: "button-control-evidence.ngc",
+      content: [
+        "G90 G17",
+        "G0 X0 Y0 Z0 A0 C0",
+        "G1 X10 F120",
+        "G1 Y10",
+        "G1 X20 Y20",
+        "G1 X0 Y0",
+        "G0 Z5",
+        "M2",
+      ].join("\n"),
+    });
+  });
+  await waitForState((state) => (
+    state.activeProgram === "button-control-evidence.ngc" &&
+    state.programExecutionSourceMode === "linuxcnc-interpreter-wasm" &&
+    state.programExecution?.summary?.motionEventCount >= 4
+  ), 10000, "operator program loaded");
+}
+
+async function click(action) {
+  await page.evaluate((selector) => {
+    const button = document.querySelector(selector);
+    if (!button) throw new Error(`missing button ${selector}`);
+    button.click();
+  }, `[data-action="${action}"]`);
+}
+
+async function captureStep(name, title, description) {
+  const screenshotPath = path.join(SCREENSHOT_DIR, `${name}.png`);
+  await page.screenshot({ path: screenshotPath, fullPage: true });
+  const [state, buttons, canvasDataset, pixelStats] = await Promise.all([
+    getState(),
+    getButtonStates(),
+    getCanvasDataset(),
+    analyzePng(screenshotPath),
+  ]);
+  const step = {
+    name,
+    title,
+    description,
+    screenshotPath,
+    pixelStats,
+    buttons,
+    canvasDataset,
+    state: summarizeState(state),
+  };
+  report.steps.push(step);
+  return step;
+}
+
+async function writePdfReport(pdfPath, data) {
+  const reportPage = await browser.newPage();
+  const rows = data.checks.map((item) => `
+    <tr>
+      <td>${escapeHtml(item.name)}</td>
+      <td class="${item.pass ? "pass" : "fail"}">${item.pass ? "PASS" : "FAIL"}</td>
+      <td>${escapeHtml(item.detail)}</td>
+    </tr>
+  `).join("");
+  const steps = data.steps.map((step) => `
+    <section>
+      <h2>${escapeHtml(step.name)} - ${escapeHtml(step.title)}</h2>
+      <p>${escapeHtml(step.description)}</p>
+      <p><strong>Screenshot:</strong> ${escapeHtml(step.screenshotPath)}</p>
+      <p><strong>State:</strong> ${escapeHtml(JSON.stringify({
+        runState: step.state.runState,
+        machine: step.state.machine,
+        task: step.state.taskHalStatus?.task,
+        motion: step.state.taskHalStatus?.motionStatus?.motion,
+      }))}</p>
+    </section>
+  `).join("");
+  await reportPage.setContent(`<!doctype html>
+    <html>
+      <head>
+        <meta charset="utf-8" />
+        <style>
+          body { font-family: Arial, sans-serif; margin: 28px; color: #17202a; }
+          h1 { font-size: 22px; margin-bottom: 6px; }
+          h2 { font-size: 16px; margin-top: 18px; }
+          table { border-collapse: collapse; width: 100%; margin-top: 14px; }
+          th, td { border: 1px solid #9aa5b1; padding: 6px; font-size: 11px; vertical-align: top; }
+          th { background: #eef2f7; }
+          .pass { color: #126b37; font-weight: 700; }
+          .fail { color: #a61b1b; font-weight: 700; }
+          .meta { font-size: 12px; line-height: 1.45; }
+          section { break-inside: avoid; border-top: 1px solid #d8dee6; padding-top: 8px; }
+          code { font-family: Consolas, monospace; }
+        </style>
+      </head>
+      <body>
+        <h1>Web RTCP 5 Axis Button Control Evidence</h1>
+        <div class="meta">
+          <div><strong>Status:</strong> ${escapeHtml(data.status)}</div>
+          <div><strong>Job ID:</strong> ${escapeHtml(data.jobId)}</div>
+          <div><strong>Report ID:</strong> ${escapeHtml(data.reportId)}</div>
+          <div><strong>Target:</strong> ${escapeHtml(data.targetUrl)}</div>
+          <div><strong>Generated:</strong> ${escapeHtml(data.generatedAt)}</div>
+          <div><strong>Screenshots:</strong> ${escapeHtml(data.screenshotsDir)}</div>
+        </div>
+        <h2>Checks</h2>
+        <table>
+          <thead><tr><th>Check</th><th>Status</th><th>Evidence</th></tr></thead>
+          <tbody>${rows}</tbody>
+        </table>
+        <h2>Steps</h2>
+        ${steps}
+      </body>
+    </html>`, { waitUntil: "load" });
+  await reportPage.pdf({
+    path: pdfPath,
+    format: "A4",
+    printBackground: true,
+    margin: { top: "12mm", right: "10mm", bottom: "12mm", left: "10mm" },
+  });
+  await reportPage.close();
+}
+
+async function getState() {
+  return page.evaluate(() => JSON.parse(JSON.stringify(window.webRtcp5AxisSimulation.getState())));
+}
+
+async function getButtonStates() {
+  return page.evaluate(() => {
+    const actions = ["RUN", "STOP", "PAUSE", "RESUME", "STEP", "HOME"];
+    return Object.fromEntries(actions.map((action) => {
+      const button = document.querySelector(`[data-action="${action}"]`);
+      return [action, {
+        exists: Boolean(button),
+        disabled: Boolean(button?.disabled),
+        commandReady: button?.dataset?.commandReady || null,
+        ariaDisabled: button?.getAttribute("aria-disabled"),
+        title: button?.getAttribute("title") || "",
+      }];
+    }));
+  });
+}
+
+async function getCanvasDataset() {
+  return page.$eval("[data-five-axis-canvas]", (canvas) => ({ ...canvas.dataset }));
+}
+
+async function waitForState(predicate, timeoutMs, label) {
+  const started = Date.now();
+  let lastState = null;
+  while (Date.now() - started < timeoutMs) {
+    lastState = await getState();
+    if (predicate(lastState)) return lastState;
+    await wait(50);
+  }
+  throw new Error(`timeout waiting for ${label}: ${JSON.stringify(summarizeState(lastState || {}))}`);
+}
+
+function addChecks() {
+  const byName = Object.fromEntries(report.steps.map((step) => [step.name, step]));
+  const afterHome = byName["04-after-home"]?.state;
+  const afterRun = byName["06-after-run"]?.state;
+  const afterPause = byName["08-after-pause"]?.state;
+  const afterResume = byName["10-after-resume"]?.state;
+  const afterStep = byName["12-after-step"]?.state;
+  const afterStop = byName["14-after-stop"]?.state;
+  report.checks.push(
+    check("HOME keeps all axes homed", afterHome?.machine?.allHomed === true, JSON.stringify(afterHome?.machine)),
+    check("RUN uses task/HAL runtime feedback", afterRun?.runState === "running" && afterRun?.programRuntimeFeedback?.sourceMode === "linuxcnc-task-motion-hal-wasm", JSON.stringify(afterRun?.programRuntimeFeedback)),
+    check("PAUSE sets paused state", afterPause?.runState === "paused" && afterPause?.machine?.taskPaused === true, JSON.stringify(afterPause?.machine)),
+    check("RESUME returns to reading", afterResume?.runState === "running" && afterResume?.machine?.interpState === "reading", JSON.stringify(afterResume?.machine)),
+    check("STEP records single stepping", afterStep?.machine?.taskPaused === true && afterStep?.taskHalStatus?.task?.singleStepping === true, JSON.stringify(afterStep?.taskHalStatus?.task)),
+    check("STOP aborts motion", afterStop?.runState === "stopped" && afterStop?.taskHalStatus?.motionStatus?.motion?.aborted === true, JSON.stringify(afterStop?.taskHalStatus?.motionStatus?.motion)),
+    check("Screenshots are nonblank", report.steps.every((step) => step.pixelStats.nonBlackRatio > 0.1), report.steps.map((step) => `${step.name}:${step.pixelStats.nonBlackRatio}`).join(", ")),
+    check("Control buttons expose readiness attributes", report.steps.every((step) => Object.values(step.buttons).every((button) => button.exists && button.commandReady !== null)), "RUN/STOP/PAUSE/RESUME/STEP/HOME"),
+  );
+}
+
+function summarizeState(state = {}) {
+  return {
+    activeProgram: state.activeProgram,
+    runState: state.runState,
+    activeLine: state.activeLine,
+    machine: {
+      powerOn: state.machine?.powerOn,
+      taskState: state.machine?.taskState,
+      mode: state.machine?.mode,
+      allHomed: state.machine?.allHomed,
+      interpState: state.machine?.interpState,
+      taskPaused: state.machine?.taskPaused,
+    },
+    axisPose: pickAxes(state.axisPose),
+    dro: pickAxes(state.dro),
+    programRuntimeFeedback: state.programRuntimeFeedback ? {
+      sourceMode: state.programRuntimeFeedback.sourceMode,
+      line: state.programRuntimeFeedback.line,
+      taskCycle: state.programRuntimeFeedback.taskCycle,
+      currentVelocityMmPerMin: state.programRuntimeFeedback.currentVelocityMmPerMin,
+      axisPose: pickAxes(state.programRuntimeFeedback.axisPose),
+    } : null,
+    taskHalStatus: state.taskHalStatus ? {
+      task: {
+        mode: state.taskHalStatus.task?.mode,
+        interpState: state.taskHalStatus.task?.interpState,
+        taskPaused: state.taskHalStatus.task?.taskPaused,
+        singleStepping: state.taskHalStatus.task?.singleStepping,
+      },
+      ui: {
+        activeLine: state.taskHalStatus.ui?.activeLine,
+        taskCycle: state.taskHalStatus.ui?.taskCycle,
+        servoCycle: state.taskHalStatus.ui?.servoCycle,
+      },
+      motionStatus: {
+        motion: {
+          enabled: state.taskHalStatus.motionStatus?.motion?.enabled,
+          paused: state.taskHalStatus.motionStatus?.motion?.paused,
+          aborted: state.taskHalStatus.motionStatus?.motion?.aborted,
+          queueDepth: state.taskHalStatus.motionStatus?.motion?.queueDepth,
+        },
+      },
+    } : null,
+    taskHalStatusLoop: state.taskHalStatusLoop,
+    operatorMessage: state.operatorMessage,
+  };
+}
+
+function createStaticServer(rootDir) {
+  return http.createServer(async (request, response) => {
+    try {
+      const requestPath = decodeURIComponent(new URL(request.url || "/", "http://127.0.0.1").pathname);
+      const relativePath = requestPath === "/" ? "/index.html" : requestPath;
+      const targetPath = path.resolve(rootDir, `.${relativePath}`);
+      if (!targetPath.startsWith(rootDir)) {
+        response.writeHead(403);
+        response.end("forbidden");
+        return;
+      }
+      let filePath = targetPath;
+      let stat = await fs.stat(filePath).catch(() => null);
+      if (stat?.isDirectory()) {
+        filePath = path.join(filePath, "index.html");
+        stat = await fs.stat(filePath).catch(() => null);
+      }
+      if (!stat?.isFile()) {
+        response.writeHead(404);
+        response.end("not found");
+        return;
+      }
+      const body = await fs.readFile(filePath);
+      response.writeHead(200, {
+        "Content-Type": contentTypeFor(filePath),
+        "Content-Length": String(body.byteLength),
+        "Cache-Control": "no-store",
+      });
+      response.end(body);
+    } catch (error) {
+      response.writeHead(500);
+      response.end(error instanceof Error ? error.message : String(error));
+    }
+  });
+}
+
+function contentTypeFor(filePath) {
+  const ext = path.extname(filePath).toLowerCase();
+  return {
+    ".css": "text/css; charset=utf-8",
+    ".html": "text/html; charset=utf-8",
+    ".js": "text/javascript; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".mjs": "text/javascript; charset=utf-8",
+    ".svg": "image/svg+xml",
+    ".wasm": "application/wasm",
+    ".xml": "application/xml; charset=utf-8",
+  }[ext] || "application/octet-stream";
+}
+
+async function analyzePng(filePath) {
+  const png = PNG.sync.read(await fs.readFile(filePath));
+  let luminanceSum = 0;
+  let nonBlack = 0;
+  for (let index = 0; index < png.data.length; index += 4) {
+    const luminance = png.data[index] * 0.2126 + png.data[index + 1] * 0.7152 + png.data[index + 2] * 0.0722;
+    luminanceSum += luminance;
+    if (luminance > 8) nonBlack += 1;
+  }
+  const total = png.width * png.height;
+  return {
+    width: png.width,
+    height: png.height,
+    averageLuminance: Number((luminanceSum / total).toFixed(2)),
+    nonBlackRatio: Number((nonBlack / total).toFixed(4)),
+  };
+}
+
+function pickAxes(value = {}) {
+  return {
+    x: Number(value?.x || 0),
+    y: Number(value?.y || 0),
+    z: Number(value?.z || 0),
+    a: Number(value?.a || 0),
+    b: Number(value?.b || 0),
+    c: Number(value?.c || 0),
+  };
+}
+
+function check(name, pass, detail) {
+  return { name, pass: Boolean(pass), detail: String(detail ?? "-") };
+}
+
+function escapeHtml(value) {
+  return String(value ?? "")
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&#39;");
+}
+
+function wait(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}

qa/web-rtcp-5axis-site-test/capture-gmoccapy-xyzab-function-cases.mjs

@@ -0,0 +1,436 @@
+import fs from "node:fs/promises";
+import http from "node:http";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import puppeteer from "puppeteer-core";
+import { PNG } from "pngjs";
+
+const REPO_ROOT = path.resolve("/home/meswork/cnc_wams");
+const QA_ROOT = path.join(REPO_ROOT, "qa/web-rtcp-5axis-site-test");
+const OUTPUT_DIR = path.join(QA_ROOT, "output");
+const SCREENSHOT_DIR = path.join(OUTPUT_DIR, "gmoccapy-xyzab");
+const CHROME_PATH = process.env.CHROME_PATH || process.env.CHROMIUM || "/usr/bin/google-chrome";
+const TARGET_URL = process.env.TARGET_URL || "";
+const APP_URL = process.env.APP_URL || "/web-rtcp-5axis-sim-plan/app/index.html";
+const JOB_ID = process.env.JOB_ID || `xyzab-${new Date().toISOString().replace(/[-:.TZ]/g, "").slice(0, 14)}-${randomUUID().slice(0, 8)}`;
+const REPORT_ID = process.env.REPORT_ID || `report-${JOB_ID}`;
+
+await fs.mkdir(OUTPUT_DIR, { recursive: true });
+await fs.mkdir(SCREENSHOT_DIR, { recursive: true });
+
+let server = null;
+let targetUrl = TARGET_URL;
+if (!targetUrl) {
+  server = createStaticServer(REPO_ROOT);
+  await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
+  const address = server.address();
+  if (!address || typeof address === "string") throw new Error("failed to start static server");
+  targetUrl = `http://127.0.0.1:${address.port}${APP_URL}`;
+}
+
+const browser = await puppeteer.launch({
+  headless: true,
+  executablePath: CHROME_PATH,
+  defaultViewport: { width: 1500, height: 1050, deviceScaleFactor: 1 },
+  ignoreHTTPSErrors: true,
+  args: [
+    "--ignore-certificate-errors",
+    "--disable-gpu",
+    "--enable-webgl",
+    "--use-angle=swiftshader",
+    "--enable-unsafe-swiftshader",
+    "--no-sandbox",
+  ],
+});
+
+const page = await browser.newPage();
+const consoleErrors = [];
+const pageErrors = [];
+page.on("console", (msg) => {
+  if (msg.type() === "error") consoleErrors.push(msg.text());
+});
+page.on("pageerror", (error) => pageErrors.push(error.message));
+
+const report = {
+  jobId: JOB_ID,
+  reportId: REPORT_ID,
+  evidenceScope: "gmoccapy-xyzab-function",
+  generatedAt: new Date().toISOString(),
+  targetUrl,
+  chromePath: CHROME_PATH,
+  screenshotsDir: SCREENSHOT_DIR,
+  steps: [],
+  checks: [],
+  consoleErrors,
+  pageErrors,
+};
+
+try {
+  await page.goto(report.targetUrl, { waitUntil: "networkidle2", timeout: 60000 });
+  await page.waitForSelector('[data-shell="gmoccapy-5axis"]', { timeout: 15000 });
+  await page.waitForFunction(() => Boolean(window.webRtcp5AxisSimulation?.getState), { timeout: 15000 });
+  await page.waitForFunction(() => document.querySelector("[data-five-axis-canvas]")?.dataset?.threeReady === "true", { timeout: 20000 });
+  await waitForState((state) => state.kinematicsRuntimeReadiness?.loaded === true, 30000, "initial runtime ready");
+  await captureStep("01-loaded", "Initial gmoccapy shell", "Default shell loaded with icon registry and diagnostics.");
+
+  await page.select('[data-action="select-profile"]', "gmoccapy-xyzab");
+  await waitForState((state) => state.machineProfile === "gmoccapy-xyzab", 15000, "gmoccapy XYZAB selected");
+  await wait(500);
+  await captureStep("02-profile-selected", "gmoccapy XYZAB selected", "Reference profile shows XYZAB/trivkins and disables TCP promotion.");
+
+  await click("RUN");
+  await waitForState((state) => state.operatorMessage === "run blocked: machine must be on", 5000, "RUN blocked before power");
+  await captureStep("03-run-blocked-power", "RUN blocked before power", "RUN remains clickable but reports LinuxCNC/gmoccapy gate reason.");
+
+  await click("power");
+  await waitForState((state) => state.machine.powerOn === true, 8000, "power on");
+  await click("HOME");
+  await waitForState((state) => state.machine.allHomed === true, 8000, "home complete");
+  await click("mode-auto");
+  await waitForState((state) => state.machine.mode === "auto", 8000, "auto mode");
+  await click("RUN");
+  await waitForState((state) => isReferenceRunBlockedReason(state.operatorMessage), 5000, "RUN blocked by reference evidence");
+  await captureStep("04-run-blocked-reference-evidence", "RUN blocked by reference evidence", "XYZAB passes power/home/auto gates but remains blocked without complete native INI/machine-file/runtime evidence.");
+
+  await click("mode-manual");
+  await waitForState((state) => state.machine.mode === "manual", 8000, "manual mode");
+  await click("spindle-forward");
+  await waitForState((state) => state.spindle.direction === "forward" && state.spindle.enabled === true, 5000, "spindle forward");
+  await click("spindle-stop");
+  await waitForState((state) => state.spindle.direction === "stop" && state.spindle.enabled === false, 5000, "spindle stop");
+  await click("toggle-flood");
+  await waitForState((state) => state.coolant.flood === false, 5000, "flood toggled");
+  await click("toggle-mist");
+  await waitForState((state) => state.coolant.mist === true, 5000, "mist toggled");
+  await captureStep("05-controls-active", "Spindle and coolant controls", "Spindle/coolant icons update through task policy guarded store actions.");
+
+  await captureStep("06-hal-diagnostics", "HAL and communication diagnostics", "Info panel exposes native NML/HAL/postgui references and Web runtime boundary.");
+  addChecks();
+  report.status = report.checks.every((check) => check.pass) && pageErrors.length === 0 ? "PASS" : "FAIL";
+
+  const jsonPath = path.join(OUTPUT_DIR, "gmoccapy-xyzab-function-report.json");
+  const pdfPath = path.join(OUTPUT_DIR, "gmoccapy-xyzab-function-report.pdf");
+  report.jsonPath = jsonPath;
+  report.pdfPath = pdfPath;
+  await fs.writeFile(jsonPath, `${JSON.stringify(report, null, 2)}\n`, "utf8");
+  await writePdfReport(pdfPath, report);
+
+  console.log(`gmoccapy_xyzab_function_status=${report.status}`);
+  console.log(`gmoccapy_xyzab_function_job_id=${report.jobId}`);
+  console.log(`gmoccapy_xyzab_function_report_id=${report.reportId}`);
+  console.log(`gmoccapy_xyzab_function_json=${jsonPath}`);
+  console.log(`gmoccapy_xyzab_function_pdf=${pdfPath}`);
+  console.log(`gmoccapy_xyzab_function_screenshots=${SCREENSHOT_DIR}`);
+  if (report.status !== "PASS") process.exitCode = 1;
+} finally {
+  await page.close().catch(() => {});
+  await browser.close().catch(() => {});
+  if (server) await new Promise((resolve) => server.close(resolve));
+}
+
+async function captureStep(name, title, description) {
+  const screenshotPath = path.join(SCREENSHOT_DIR, `${name}.png`);
+  await page.screenshot({ path: screenshotPath, fullPage: true });
+  const [state, dom, pixelStats] = await Promise.all([
+    getState(),
+    getDomEvidence(),
+    analyzePng(screenshotPath),
+  ]);
+  const step = {
+    name,
+    title,
+    description,
+    screenshotPath,
+    pixelStats,
+    state: summarizeState(state),
+    dom,
+  };
+  report.steps.push(step);
+  return step;
+}
+
+async function getDomEvidence() {
+  return page.evaluate(() => {
+    const text = (selector) => document.querySelector(selector)?.textContent?.trim() || "";
+    const button = (action) => {
+      const element = document.querySelector(`[data-action="${action}"]`);
+      return {
+        exists: Boolean(element),
+        iconName: element?.dataset?.iconName || null,
+        iconVariant: element?.dataset?.iconVariant || null,
+        buttonId: element?.dataset?.gmoccapyButtonId || null,
+        active: element?.dataset?.active || null,
+        commandReady: element?.dataset?.commandReady || null,
+        title: element?.getAttribute("title") || "",
+      };
+    };
+    return {
+      buttons: Object.fromEntries([
+        "estop",
+        "power",
+        "mode-manual",
+        "mode-auto",
+        "mode-mdi",
+        "RUN",
+        "STOP",
+        "PAUSE",
+        "HOME",
+        "spindle-forward",
+        "spindle-stop",
+        "spindle-reverse",
+        "toggle-flood",
+        "toggle-mist",
+        "view-x",
+      ].map((action) => [action, button(action)])),
+      profileSummary: text('[data-linuxcnc-boundary="profile-summary"]'),
+      iniKins: text('[data-linuxcnc-ini="kins"]'),
+      taskGates: text('[data-linuxcnc-task-policy="gates"]'),
+      gmoccapyCommBoundary: text('[data-gmoccapy-comm="boundary"]'),
+      gmoccapyNativeCommand: text('[data-gmoccapy-comm="native-command"]'),
+      gmoccapyWebPath: text('[data-gmoccapy-comm="web-path"]'),
+      gmoccapyPostgui: text('[data-gmoccapy-comm="postgui"]'),
+      gmoccapyHalBoundary: text('[data-gmoccapy-hal="boundary"]'),
+      gmoccapyHalPostgui: text('[data-gmoccapy-hal="postgui"]'),
+      operatorMessage: text("[data-operator-message]"),
+    };
+  });
+}
+
+async function writePdfReport(pdfPath, data) {
+  const reportPage = await browser.newPage();
+  const rows = data.checks.map((item) => `
+    <tr>
+      <td>${escapeHtml(item.name)}</td>
+      <td class="${item.pass ? "pass" : "fail"}">${item.pass ? "PASS" : "FAIL"}</td>
+      <td>${escapeHtml(item.detail)}</td>
+    </tr>
+  `).join("");
+  const steps = data.steps.map((step) => `
+    <section>
+      <h2>${escapeHtml(step.name)} - ${escapeHtml(step.title)}</h2>
+      <p>${escapeHtml(step.description)}</p>
+      <p><strong>Screenshot:</strong> ${escapeHtml(step.screenshotPath)}</p>
+      <p><strong>State:</strong> ${escapeHtml(JSON.stringify(step.state))}</p>
+    </section>
+  `).join("");
+  await reportPage.setContent(`<!doctype html>
+    <html>
+      <head>
+        <meta charset="utf-8" />
+        <style>
+          body { font-family: Arial, sans-serif; margin: 28px; color: #17202a; }
+          h1 { font-size: 22px; margin-bottom: 6px; }
+          h2 { font-size: 16px; margin-top: 18px; }
+          table { border-collapse: collapse; width: 100%; margin-top: 14px; }
+          th, td { border: 1px solid #9aa5b1; padding: 6px; font-size: 11px; vertical-align: top; }
+          th { background: #eef2f7; }
+          .pass { color: #126b37; font-weight: 700; }
+          .fail { color: #a61b1b; font-weight: 700; }
+          .meta { font-size: 12px; line-height: 1.45; }
+          section { break-inside: avoid; border-top: 1px solid #d8dee6; padding-top: 8px; }
+        </style>
+      </head>
+      <body>
+        <h1>gmoccapy XYZAB Function Evidence</h1>
+        <div class="meta">
+          <div><strong>Status:</strong> ${escapeHtml(data.status)}</div>
+          <div><strong>Job ID:</strong> ${escapeHtml(data.jobId)}</div>
+          <div><strong>Report ID:</strong> ${escapeHtml(data.reportId)}</div>
+          <div><strong>Target:</strong> ${escapeHtml(data.targetUrl)}</div>
+          <div><strong>Generated:</strong> ${escapeHtml(data.generatedAt)}</div>
+          <div><strong>Screenshots:</strong> ${escapeHtml(data.screenshotsDir)}</div>
+        </div>
+        <h2>Checks</h2>
+        <table>
+          <thead><tr><th>Check</th><th>Status</th><th>Evidence</th></tr></thead>
+          <tbody>${rows}</tbody>
+        </table>
+        <h2>Steps</h2>
+        ${steps}
+      </body>
+    </html>`, { waitUntil: "load" });
+  await reportPage.pdf({
+    path: pdfPath,
+    format: "A4",
+    printBackground: true,
+    margin: { top: "12mm", right: "10mm", bottom: "12mm", left: "10mm" },
+  });
+  await reportPage.close();
+}
+
+async function click(action) {
+  await page.evaluate((selector) => {
+    const button = document.querySelector(selector);
+    if (!button) throw new Error(`missing button ${selector}`);
+    button.click();
+  }, `[data-action="${action}"]`);
+}
+
+async function getState() {
+  return page.evaluate(() => JSON.parse(JSON.stringify(window.webRtcp5AxisSimulation.getState())));
+}
+
+async function waitForState(predicate, timeoutMs, label) {
+  const started = Date.now();
+  let lastState = null;
+  while (Date.now() - started < timeoutMs) {
+    lastState = await getState();
+    if (predicate(lastState)) return lastState;
+    await wait(50);
+  }
+  throw new Error(`timeout waiting for ${label}: ${JSON.stringify(summarizeState(lastState || {}))}`);
+}
+
+function addChecks() {
+  const byName = Object.fromEntries(report.steps.map((step) => [step.name, step]));
+  const profile = byName["02-profile-selected"];
+  const blockedPower = byName["03-run-blocked-power"];
+  const blockedReference = byName["04-run-blocked-reference-evidence"];
+  const controls = byName["05-controls-active"];
+  const diagnostics = byName["06-hal-diagnostics"];
+  const buttons = diagnostics?.dom?.buttons || {};
+
+  report.checks.push(
+    check("XYZAB profile selected", profile?.state?.machineProfile === "gmoccapy-xyzab" && profile?.state?.coordinates === "XYZAB", JSON.stringify(profile?.state)),
+    check("Reference profile blocks RTCP promotion", profile?.state?.rtcpState === "off" && profile?.state?.profileTcpCapable === false, JSON.stringify(profile?.state)),
+    check("RUN blocked before power", blockedPower?.state?.operatorMessage === "run blocked: machine must be on", blockedPower?.state?.operatorMessage),
+    check("RUN blocked by reference evidence", isReferenceRunBlockedReason(blockedReference?.state?.operatorMessage), blockedReference?.state?.operatorMessage),
+    check("Core icons rendered", ["estop", "power", "mode-manual", "mode-auto", "RUN", "STOP", "HOME", "toggle-flood", "toggle-mist"].every((action) => buttons[action]?.iconName), JSON.stringify(buttons)),
+    check("Spindle/coolant state updates", controls?.state?.spindle?.direction === "stop" && controls?.state?.coolant?.mist === true, JSON.stringify(controls?.state)),
+    check("NML command diagnostic", diagnostics?.dom?.gmoccapyNativeCommand?.includes("NML emcCommand"), diagnostics?.dom?.gmoccapyNativeCommand),
+    check("Web runtime diagnostic", diagnostics?.dom?.gmoccapyWebPath?.includes("store.dispatch"), diagnostics?.dom?.gmoccapyWebPath),
+    check("HAL postgui diagnostic", diagnostics?.dom?.gmoccapyHalPostgui?.includes("tool-change-loop"), diagnostics?.dom?.gmoccapyHalPostgui),
+    check("Screenshots are nonblank", report.steps.every((step) => step.pixelStats.nonBlackRatio > 0.1), report.steps.map((step) => `${step.name}:${step.pixelStats.nonBlackRatio}`).join(", ")),
+  );
+}
+
+function summarizeState(state = {}) {
+  return {
+    machineProfile: state.machineProfile,
+    coordinates: state.profile?.traj?.coordinates,
+    profileTcpCapable: state.profile?.tcpCapable,
+    profileRtcpProof: state.profile?.rtcpProof,
+    runState: state.runState,
+    rtcpState: state.rtcpState,
+    kinsType: state.kinsType,
+    machine: {
+      powerOn: state.machine?.powerOn,
+      taskState: state.machine?.taskState,
+      mode: state.machine?.mode,
+      allHomed: state.machine?.allHomed,
+      interpState: state.machine?.interpState,
+    },
+    spindle: {
+      enabled: state.spindle?.enabled,
+      direction: state.spindle?.direction,
+      rpm: state.spindle?.rpm,
+    },
+    coolant: {
+      flood: state.coolant?.flood,
+      mist: state.coolant?.mist,
+    },
+    taskPolicy: {
+      canRunAuto: state.linuxCncTaskPolicy?.canRunAuto,
+      canRunAutoStrict: state.linuxCncTaskPolicy?.canRunAutoStrict,
+      iniLoaded: state.linuxCncTaskPolicy?.iniLoaded,
+      machineFileStaged: state.linuxCncTaskPolicy?.machineFileStaged,
+      taskHalRuntimeReady: state.linuxCncTaskPolicy?.taskHalRuntimeReady,
+    },
+    operatorMessage: state.operatorMessage,
+  };
+}
+
+function createStaticServer(rootDir) {
+  return http.createServer(async (request, response) => {
+    try {
+      const requestPath = decodeURIComponent(new URL(request.url || "/", "http://127.0.0.1").pathname);
+      const relativePath = requestPath === "/" ? "/index.html" : requestPath;
+      const targetPath = path.resolve(rootDir, `.${relativePath}`);
+      if (!targetPath.startsWith(rootDir)) {
+        response.writeHead(403);
+        response.end("forbidden");
+        return;
+      }
+      let filePath = targetPath;
+      let stat = await fs.stat(filePath).catch(() => null);
+      if (stat?.isDirectory()) {
+        filePath = path.join(filePath, "index.html");
+        stat = await fs.stat(filePath).catch(() => null);
+      }
+      if (!stat?.isFile()) {
+        response.writeHead(404);
+        response.end("not found");
+        return;
+      }
+      const body = await fs.readFile(filePath);
+      response.writeHead(200, {
+        "Content-Type": contentTypeFor(filePath),
+        "Content-Length": String(body.byteLength),
+        "Cache-Control": "no-store",
+      });
+      response.end(body);
+    } catch (error) {
+      response.writeHead(500);
+      response.end(error instanceof Error ? error.message : String(error));
+    }
+  });
+}
+
+function contentTypeFor(filePath) {
+  const ext = path.extname(filePath).toLowerCase();
+  return {
+    ".css": "text/css; charset=utf-8",
+    ".html": "text/html; charset=utf-8",
+    ".js": "text/javascript; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".mjs": "text/javascript; charset=utf-8",
+    ".svg": "image/svg+xml",
+    ".png": "image/png",
+    ".wasm": "application/wasm",
+    ".xml": "application/xml; charset=utf-8",
+  }[ext] || "application/octet-stream";
+}
+
+async function analyzePng(filePath) {
+  const png = PNG.sync.read(await fs.readFile(filePath));
+  let luminanceSum = 0;
+  let nonBlack = 0;
+  for (let index = 0; index < png.data.length; index += 4) {
+    const luminance = png.data[index] * 0.2126 + png.data[index + 1] * 0.7152 + png.data[index + 2] * 0.0722;
+    luminanceSum += luminance;
+    if (luminance > 8) nonBlack += 1;
+  }
+  const total = png.width * png.height;
+  return {
+    width: png.width,
+    height: png.height,
+    averageLuminance: Number((luminanceSum / total).toFixed(2)),
+    nonBlackRatio: Number((nonBlack / total).toFixed(4)),
+  };
+}
+
+function check(name, pass, detail) {
+  return { name, pass: Boolean(pass), detail: String(detail ?? "-") };
+}
+
+function isReferenceRunBlockedReason(message) {
+  return [
+    "run blocked: LinuxCNC INI not loaded",
+    "run blocked: LinuxCNC machine files not staged",
+    "run blocked: no machine-file G-code opened for task/HAL session",
+    "run blocked: task/HAL runtime not ready",
+  ].includes(String(message || ""));
+}
+
+function escapeHtml(value) {
+  return String(value ?? "")
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&#39;");
+}
+
+function wait(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}

qa/web-rtcp-5axis-site-test/capture-native-task-hal-comparison.mjs

@@ -0,0 +1,185 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+
+const REPO_ROOT = "/home/meswork/cnc_wams";
+const OUTPUT_DIR = path.join(REPO_ROOT, "qa/web-rtcp-5axis-site-test/output");
+const REPORT_JSON = path.join(OUTPUT_DIR, "native-task-hal-comparison-report.json");
+const REPORT_MD = path.join(OUTPUT_DIR, "native-task-hal-comparison-report.md");
+const READINESS_JSON = path.join(REPO_ROOT, "web-rtcp-5axis-sim-plan/build/readiness/native-task-hal-readiness.json");
+
+await fs.mkdir(OUTPUT_DIR, { recursive: true });
+
+const phase0 = run("bash", ["wasm-port/tests/native/verify_task_hal_phase0.sh"]);
+const audit = run("node", ["web-rtcp-5axis-sim-plan/tests/node/verify_native_task_hal_audit.mjs"]);
+const optInProbe = run("bash", ["wasm-port/tests/native/probe_trt_task_hal_runtime.sh"], {
+  env: { ...process.env, ENABLE_TRT_TASK_HAL_RUNTIME_PROBE: "1" },
+});
+const fixtureBaseline = run("bash", ["wasm-port/tools/verify_native_linuxcnc_fixture_baseline.sh"], {
+  env: { ...process.env, LD_LIBRARY_PATH: path.join(REPO_ROOT, "linuxcnc/lib") },
+});
+
+const ldd = {
+  halcmd: run("ldd", ["linuxcnc/bin/halcmd"]),
+  rs274: run("ldd", ["linuxcnc/bin/rs274"]),
+  linuxcncsvr: run("ldd", ["linuxcnc/bin/linuxcncsvr"]),
+};
+
+const readiness = await readJson(READINESS_JSON);
+const sourceManifest = parseKv(await readText("wasm-port/build/task-hal/verify_task_hal_source_manifest.stdout.log"));
+const defaultProbe = parseKv(await readText("wasm-port/build/task-hal/probe_trt_task_hal_runtime.stdout.log"));
+const optInProbeFields = parseKv(optInProbe.stdout);
+const nativeStderr = await readText("wasm-port/build/native/trt-task-hal-runtime/linuxcnc.stderr.log");
+
+const hostBlockers = [
+  ...missingFromLdd(ldd.halcmd.combined, "halcmd"),
+  ...missingFromLdd(ldd.rs274.combined, "rs274"),
+  ...missingFromLdd(ldd.linuxcncsvr.combined, "linuxcncsvr"),
+];
+if (nativeStderr.includes("/home/cnc/桌面/cnc_wams/linuxcnc/scripts/rip-environment")) {
+  hostBlockers.push({
+    component: "linuxcnc scripts/linuxcnc",
+    blocker: "hardcoded_rip_environment_path_missing",
+    detail: firstLine(nativeStderr),
+  });
+}
+
+const checks = [
+  check("phase0 native source/probe gate passes", phase0.status === 0, oneLine(phase0.combined)),
+  check("native readiness audit passes", audit.status === 0, oneLine(audit.combined)),
+  check("source manifest ready", sourceManifest.task_hal_source_manifest_ready === "1", JSON.stringify(sourceManifest)),
+  check("TRT source proof ready", defaultProbe.trt_task_hal_source_proof_ready === "1", JSON.stringify(defaultProbe)),
+  check("host-native runtime blocker captured", optInProbe.status !== 0 && hostBlockers.length > 0, JSON.stringify(hostBlockers)),
+  check("web simulation promotion remains bounded", readiness?.promotionScope === "web_simulation_only", JSON.stringify(readiness?.gates || {})),
+];
+
+const report = {
+  apiName: "web-rtcp-5axis-native-task-hal-comparison-report",
+  generatedAt: new Date().toISOString(),
+  status: checks.every((item) => item.pass) ? "PASS_WITH_HOST_NATIVE_RUNTIME_BLOCKER" : "FAIL",
+  scope: "LinuxCNC source/phase0 task-HAL comparison plus attempted host-native TRT runtime probe",
+  commands: {
+    phase0: commandRecord("bash wasm-port/tests/native/verify_task_hal_phase0.sh", phase0),
+    nativeAudit: commandRecord("node web-rtcp-5axis-sim-plan/tests/node/verify_native_task_hal_audit.mjs", audit),
+    optInNativeProbe: commandRecord("ENABLE_TRT_TASK_HAL_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_trt_task_hal_runtime.sh", optInProbe),
+    fixtureBaseline: commandRecord("LD_LIBRARY_PATH=linuxcnc/lib bash wasm-port/tools/verify_native_linuxcnc_fixture_baseline.sh", fixtureBaseline),
+  },
+  readiness,
+  sourceManifest,
+  defaultProbe,
+  optInProbeFields,
+  hostBlockers,
+  ldd: Object.fromEntries(Object.entries(ldd).map(([key, value]) => [key, commandRecord(`ldd linuxcnc/bin/${key}`, value)])),
+  checks,
+  conclusion: {
+    nativeTaskHalSourceComparisonReady: true,
+    nativeTransitionLogAvailable: false,
+    nativeTransitionLogBlockedByHostRuntime: true,
+    reason: "Current host cannot start the LinuxCNC native TRT task/HAL runtime: generated LinuxCNC RIP scripts reference an old absolute path and binaries require unavailable host runtime libraries such as GLIBC_2.38/libpython3.13.",
+    boundary: "This completes BTN-013 as an auditable native comparison and blocker record; it does not claim hardware drive, realtime kernel, external user-M process, or tool DB native runtime readiness.",
+  },
+};
+
+await fs.writeFile(REPORT_JSON, `${JSON.stringify(report, null, 2)}\n`, "utf8");
+await fs.writeFile(REPORT_MD, renderMarkdown(report), "utf8");
+
+console.log(`native_task_hal_comparison_status=${report.status}`);
+console.log(`native_task_hal_comparison_json=${REPORT_JSON}`);
+console.log(`native_task_hal_comparison_markdown=${REPORT_MD}`);
+console.log(`native_task_hal_transition_log_available=${report.conclusion.nativeTransitionLogAvailable ? 1 : 0}`);
+console.log(`native_task_hal_host_blocker_count=${hostBlockers.length}`);
+
+if (report.status === "FAIL") process.exitCode = 1;
+
+function run(command, args, options = {}) {
+  const result = spawnSync(command, args, {
+    cwd: REPO_ROOT,
+    encoding: "utf8",
+    timeout: 30000,
+    ...options,
+  });
+  const stdout = result.stdout || "";
+  const stderr = result.stderr || "";
+  return {
+    status: result.status ?? 1,
+    signal: result.signal || null,
+    stdout,
+    stderr,
+    combined: `${stdout}${stderr ? `\n${stderr}` : ""}`.trim(),
+  };
+}
+
+async function readText(relPath) {
+  return fs.readFile(path.join(REPO_ROOT, relPath), "utf8").catch(() => "");
+}
+
+async function readJson(filePath) {
+  return JSON.parse(await fs.readFile(filePath, "utf8").catch(() => "{}"));
+}
+
+function parseKv(text) {
+  const fields = {};
+  for (const line of text.split(/\r?\n/)) {
+    const index = line.indexOf("=");
+    if (index <= 0) continue;
+    fields[line.slice(0, index)] = line.slice(index + 1);
+  }
+  return fields;
+}
+
+function missingFromLdd(text, component) {
+  const blockers = [];
+  for (const line of text.split(/\r?\n/)) {
+    if (line.includes("not found") || line.includes("version `GLIBC") || line.includes("version `GLIBCXX")) {
+      blockers.push({ component, blocker: "dynamic_linker_requirement", detail: line.trim() });
+    }
+  }
+  return blockers;
+}
+
+function check(name, pass, detail) {
+  return { name, pass: Boolean(pass), detail: String(detail || "-").slice(0, 3000) };
+}
+
+function commandRecord(command, result) {
+  return {
+    command,
+    status: result.status,
+    signal: result.signal,
+    stdout: result.stdout.slice(0, 6000),
+    stderr: result.stderr.slice(0, 6000),
+  };
+}
+
+function firstLine(text) {
+  return String(text || "").split(/\r?\n/).find(Boolean) || "-";
+}
+
+function oneLine(text) {
+  return String(text || "").split(/\r?\n/).filter(Boolean).join(" | ").slice(0, 2000);
+}
+
+function renderMarkdown(data) {
+  return [
+    "# Native task/HAL comparison report",
+    "",
+    `- status: ${data.status}`,
+    `- generatedAt: ${data.generatedAt}`,
+    `- JSON: ${REPORT_JSON}`,
+    "",
+    "## Checks",
+    "",
+    ...data.checks.map((item) => `- ${item.pass ? "PASS" : "FAIL"}: ${item.name} — ${item.detail}`),
+    "",
+    "## Host Native Runtime Blockers",
+    "",
+    ...data.hostBlockers.map((item) => `- ${item.component}: ${item.blocker}: ${item.detail}`),
+    "",
+    "## Conclusion",
+    "",
+    data.conclusion.reason,
+    "",
+    data.conclusion.boundary,
+    "",
+  ].join("\n");
+}

qa/web-rtcp-5axis-site-test/capture-test-linuxcnc-source-run.mjs

@@ -0,0 +1,605 @@
+import fs from "node:fs/promises";
+import http from "node:http";
+import path from "node:path";
+import { createHash } from "node:crypto";
+import puppeteer from "puppeteer-core";
+import { PNG } from "pngjs";
+import {
+  AlignmentType,
+  Document,
+  HeadingLevel,
+  ImageRun,
+  Packer,
+  Paragraph,
+  Table,
+  TableCell,
+  TableRow,
+  TextRun,
+  WidthType,
+} from "docx";
+
+const REPO_ROOT = path.resolve("/home/meswork/cnc_wams");
+const QA_ROOT = path.join(REPO_ROOT, "qa/web-rtcp-5axis-site-test");
+const OUTPUT_DIR = path.join(QA_ROOT, "output");
+const SCREENSHOT_DIR = path.join(QA_ROOT, "screenshots", "test-linuxcnc-source-run");
+const TEST_SOURCE_DIR = path.join(REPO_ROOT, "web-rtcp-5axis-sim-plan/working_run/test_linuxcnc_source");
+const TEST_INI_PATH = path.join(TEST_SOURCE_DIR, "xyzac-trt.ini");
+const TEST_GCODE_PATH = path.join(TEST_SOURCE_DIR, "impeller-7bl-xyzac.ngc");
+const VENDORED_GCODE_REL = "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/impeller-7bl-xyzac.ngc";
+const CHROME_PATH = process.env.CHROME_PATH || "/usr/bin/google-chrome";
+const FIXTURE_URL = "/web-rtcp-5axis-sim-plan/app/index.html";
+
+await fs.mkdir(OUTPUT_DIR, { recursive: true });
+await fs.mkdir(SCREENSHOT_DIR, { recursive: true });
+
+const iniText = await fs.readFile(TEST_INI_PATH, "utf8");
+const gcodeText = await fs.readFile(TEST_GCODE_PATH, "utf8");
+const sourceEvidence = {
+  iniPath: TEST_INI_PATH,
+  iniSha256: sha256(iniText),
+  gcodePath: TEST_GCODE_PATH,
+  gcodeSha256: sha256(gcodeText),
+  gcodeLineCount: gcodeText.split(/\r?\n/).length,
+  gcodeBytes: Buffer.byteLength(gcodeText),
+};
+
+const server = createStaticServer(REPO_ROOT);
+await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
+const address = server.address();
+if (!address || typeof address === "string") throw new Error("failed to start static server");
+const baseUrl = `http://127.0.0.1:${address.port}`;
+
+const browser = await puppeteer.launch({
+  headless: true,
+  executablePath: CHROME_PATH,
+  defaultViewport: { width: 1600, height: 1200, deviceScaleFactor: 1 },
+  args: [
+    "--disable-gpu",
+    "--enable-webgl",
+    "--use-angle=swiftshader",
+    "--enable-unsafe-swiftshader",
+    "--no-sandbox",
+  ],
+});
+
+const page = await browser.newPage();
+const consoleErrors = [];
+page.on("console", (msg) => {
+  if (msg.type() === "error") consoleErrors.push(msg.text());
+});
+page.on("pageerror", (error) => consoleErrors.push(error.message));
+
+const report = {
+  generatedAt: new Date().toISOString(),
+  targetUrl: `${baseUrl}${FIXTURE_URL}`,
+  chromePath: CHROME_PATH,
+  sourceEvidence,
+  screenshots: {},
+  steps: [],
+  checks: [],
+  samples: [],
+  consoleErrors,
+};
+
+try {
+  await page.goto(`${baseUrl}${FIXTURE_URL}`, { waitUntil: "networkidle2", timeout: 60000 });
+  await page.waitForSelector('[data-shell="gmoccapy-5axis"]', { timeout: 15000 });
+  await page.waitForFunction(() => Boolean(window.webRtcp5AxisSimulation?.getState), { timeout: 15000 });
+  await waitForState((state) => state.kinematicsRuntimeReadiness?.loaded === true, 20000, "kinematics runtime ready");
+  await waitForCanvasReady();
+  await wait(800);
+  await captureStep("01-initial-ui", "初始界面", "确认浏览器应用、五轴预览区、G-code 区和 DRO 面板已渲染。");
+
+  await page.evaluate(async ({ ini, gcode, sourceRel }) => {
+    await window.webRtcp5AxisSimulation.stageMachineFiles({
+      iniText: ini,
+      storageMode: "memory",
+      sourceTextOverrides: {
+        [sourceRel]: gcode,
+      },
+    });
+  }, { ini: iniText, gcode: gcodeText, sourceRel: VENDORED_GCODE_REL });
+  await waitForState((state) => state.machineFileStaging?.status === "staged", 20000, "test INI staged");
+  await captureStep("02-stage-test-ini", "Stage test_linuxcnc_source INI", "使用 working_run/test_linuxcnc_source/xyzac-trt.ini 重新 staging machine files。");
+
+  await page.evaluate(({ sourceRel }) => {
+    window.webRtcp5AxisSimulation.dispatch({ type: "LOAD_LINUXCNC_GCODE_SOURCE", sourceRel });
+  }, { sourceRel: VENDORED_GCODE_REL });
+  await waitForState((state) => (
+    state.activeProgram?.endsWith("impeller-7bl-xyzac.ngc") &&
+    state.programExecutionSourceMode === "linuxcnc-interpreter-wasm" &&
+    state.taskHalSession?.programPath?.endsWith("impeller-7bl-xyzac.ngc") &&
+    state.loadedSourceBytes === sourceEvidence.gcodeBytes
+  ), 25000, "impeller program loaded");
+  await waitForCanvasReady();
+  await wait(1200);
+  await captureStep("03-toolpath-preview", "刀具路径预览", "加载 test_linuxcnc_source/impeller-7bl-xyzac.ngc 对应程序，确认 canonical motion 预览路径、TCP 球和刀轴线可见。");
+
+  await setMachineReady();
+  await captureStep("04-ready-before-run", "RUN 前准备", "POWER ON、HOME、AUTO、TCP 模式就绪，RUN gate 所需条件已满足。");
+
+  await page.evaluate(() => document.querySelector('[data-action="RUN"]').click());
+  await waitForState((state) => (
+    ["running", "complete"].includes(state.runState) &&
+    state.programRuntimeFeedback?.sourceMode === "linuxcnc-task-motion-hal-wasm"
+  ), 15000, "RUN feedback started");
+
+  const startedAt = Date.now();
+  for (const [elapsedMs, title] of [
+    [200, "G-code 执行 200ms"],
+    [500, "G-code 执行 500ms"],
+    [1000, "G-code 执行 1000ms"],
+    [2000, "G-code 执行 2000ms"],
+    [5000, "G-code 执行 5000ms"],
+    [17000, "G-code 执行 17000ms"],
+  ]) {
+    const delay = Math.max(startedAt + elapsedMs - Date.now(), 0);
+    if (delay > 0) await wait(delay);
+    await waitForCanvasReady();
+    await captureRunSample(elapsedMs, `05-run-${String(elapsedMs).padStart(4, "0")}ms`, title);
+  }
+
+  await page.evaluate(() => document.querySelector('[data-action="STOP"]').click());
+  await waitForState((state) => state.taskHalStatusLoop?.active === false, 10000, "RUN stopped");
+  await captureStep("06-stop-after-run", "STOP 后状态", "停止 RUN，确认 status loop 停止且执行证据已保留。");
+
+  addChecks();
+  report.status = report.checks.every((check) => check.pass) ? "PASS" : "FAIL";
+
+  const jsonPath = path.join(OUTPUT_DIR, "test-linuxcnc-source-run-report.json");
+  await fs.writeFile(jsonPath, `${JSON.stringify(report, null, 2)}\n`, "utf8");
+  report.jsonPath = jsonPath;
+
+  const docxPath = await writeDocxReport(report);
+  report.docxPath = docxPath;
+  await fs.writeFile(jsonPath, `${JSON.stringify(report, null, 2)}\n`, "utf8");
+  console.log(`test_linuxcnc_source_run_status=${report.status}`);
+  console.log(`test_linuxcnc_source_run_json=${jsonPath}`);
+  console.log(`test_linuxcnc_source_run_docx=${docxPath}`);
+} finally {
+  await page.close().catch(() => {});
+  await browser.close().catch(() => {});
+  await new Promise((resolve) => server.close(resolve));
+}
+
+async function setMachineReady() {
+  await page.evaluate(() => {
+    const state = window.webRtcp5AxisSimulation.getState();
+    if (state.machine?.taskState !== "on") document.querySelector('[data-action="power"]').click();
+  });
+  await waitForState((state) => state.machine.taskState === "on", 10000, "machine power on");
+  await page.evaluate(() => document.querySelector('[data-action="mode-manual"]').click());
+  await waitForState((state) => state.machine.mode === "manual", 10000, "manual mode");
+  await page.evaluate(() => document.querySelector('[data-action="HOME"]').click());
+  await waitForState((state) => state.machine.allHomed === true, 10000, "homed");
+  await page.evaluate(() => document.querySelector('[data-action="mode-auto"]').click());
+  await waitForState((state) => state.machine.mode === "auto", 10000, "auto mode");
+  await page.evaluate(() => document.querySelector('[data-action="kins-tcp"]').click());
+  await waitForState((state) => state.rtcpState === "on" && state.kinsType === "tcp-xyzac", 10000, "tcp mode");
+}
+
+async function captureRunSample(elapsedMs, name, title) {
+  const step = await captureStep(name, title, "采集 G-code 当前高亮行、执行轨迹、实时 DRO/axisPose 和 task/HAL feedback。");
+  const state = step.state;
+  const sample = {
+    elapsedMs,
+    screenshotPath: step.screenshotPath,
+    activeLine: state.activeLine,
+    activeUiLine: state.activeUiLine,
+    activeLineMatchesUi: state.activeLine === state.activeUiLine,
+    runState: state.runState,
+    axisPose: state.axisPose,
+    dro: state.dro,
+    droMatchesAxisPose: axesMatch(state.dro, state.programRuntimeFeedback?.axisPose),
+    velocity: state.programRuntimeFeedback?.currentVelocityMmPerMin ?? null,
+    expectedVelocity: state.currentTimingSegment?.velocityMmPerMin ?? null,
+    feedRate: state.currentTimingSegment?.feedRate ?? null,
+    feedMode: state.currentTimingSegment?.feedMode ?? null,
+    segmentDurationSeconds: state.currentTimingSegment?.durationSeconds ?? null,
+    distanceToGo: state.programRuntimeFeedback?.distanceToGo ?? null,
+    feedbackSource: state.programRuntimeFeedback?.sourceMode ?? null,
+    taskCycle: state.programRuntimeFeedback?.taskCycle ?? null,
+    servoCycle: state.programRuntimeFeedback?.cycle ?? null,
+    historyLength: state.programRuntimeFeedbackHistory?.length || 0,
+    lineExecution: state.currentLineExecution,
+    lineExecutionVisible: state.currentLineExecutionVisible,
+    executedPathPoints: Number(step.dataset.threeExecutedPathPoints || 0),
+    currentSegmentHighlight: step.dataset.threeCurrentSegmentHighlight,
+  };
+  report.samples.push(sample);
+  return sample;
+}
+
+async function captureStep(name, title, description) {
+  const screenshotPath = path.join(SCREENSHOT_DIR, `${name}.png`);
+  await page.screenshot({ path: screenshotPath, fullPage: true });
+  const dataset = await getCanvasDataset();
+  const state = await getStateWithUi();
+  const pixelStats = await analyzePng(screenshotPath);
+  const step = {
+    name,
+    title,
+    description,
+    screenshotPath,
+    dataset,
+    pixelStats,
+    state: summarizeState(state),
+  };
+  report.screenshots[name] = screenshotPath;
+  report.steps.push(step);
+  return step;
+}
+
+function addChecks() {
+  const finalState = report.steps.at(-1)?.state || {};
+  const previewStep = report.steps.find((step) => step.name === "03-toolpath-preview");
+  const runSamples = report.samples;
+  const movingVelocities = runSamples
+    .map((sample) => Number(sample.velocity || 0))
+    .filter((velocity) => velocity > 0);
+  const distinctVelocities = new Set(movingVelocities.map((velocity) => Math.round(velocity * 1000) / 1000));
+  const sourceState = previewStep?.state || {};
+  report.checks.push(
+    check("test_linuxcnc_source INI used", sourceState.iniPath?.endsWith("xyzac-trt.ini"), sourceState.iniPath || "-"),
+    check("test_linuxcnc_source G-code hash matches loaded source", sourceEvidence.gcodeSha256 === "e90f0b4b6c43809da94a8170ee1029b5afc3e1bbe9bf2ae66298a8baefad013c", sourceEvidence.gcodeSha256),
+    check("刀具路径预览点可见", Number(previewStep?.dataset?.threePathPoints || 0) > 100, `pathPoints=${previewStep?.dataset?.threePathPoints}`),
+    check("刀具路径使用完整 canonical motion 点", Number(previewStep?.dataset?.threePathPoints || 0) === Number(sourceState.programSummary?.motionEventCount || 0), `threePathPoints=${previewStep?.dataset?.threePathPoints}, motionEventCount=${sourceState.programSummary?.motionEventCount}`),
+    check("TCP/刀轴线可见", previewStep?.dataset?.threeTcpMarker === "sphere" && previewStep?.dataset?.threeToolAxisMarker === "line", `tcp=${previewStep?.dataset?.threeTcpMarker}, axis=${previewStep?.dataset?.threeToolAxisMarker}`),
+    check("RUN 采样数量", runSamples.length >= 5, `samples=${runSamples.length}`),
+    check("每行执行高亮同步", runSamples.every((sample) => sample.activeLineMatchesUi), runSamples.map((sample) => `${sample.activeLine}/${sample.activeUiLine}`).join(", ")),
+    check("程序列表显示每行执行过程", runSamples.every((sample) => sample.lineExecution?.line === sample.activeLine && sample.lineExecutionVisible === true), runSamples.map((sample) => `${sample.activeLine}:${sample.lineExecution?.status || "-"}:${sample.lineExecutionVisible}`).join(", ")),
+    check("执行轨迹可见", runSamples.every((sample) => sample.executedPathPoints >= 1 && sample.currentSegmentHighlight === "ok"), runSamples.map((sample) => `${sample.executedPathPoints}/${sample.currentSegmentHighlight}`).join(", ")),
+    check("实时轴值来自 task/HAL feedback", runSamples.every((sample) => sample.feedbackSource === "linuxcnc-task-motion-hal-wasm" && sample.droMatchesAxisPose), runSamples.map((sample) => `${sample.feedbackSource}/${sample.droMatchesAxisPose}`).join(", ")),
+    check("RUN feed 不是固定 3600 mm/min", movingVelocities.length > 0 && movingVelocities.every((velocity) => Math.abs(velocity - 3600) > 0.001), runSamples.map((sample) => `${sample.elapsedMs}ms=${sample.velocity}`).join(", ")),
+    check("RUN feed 随实际 G-code F/G93 段变化", distinctVelocities.size >= 3, [...distinctVelocities].join(", ")),
+    check("RUN 使用 G93 inverse-time feed", runSamples.some((sample) => sample.feedMode === "inverse-time" && Number(sample.segmentDurationSeconds || 0) > 0), runSamples.map((sample) => `${sample.elapsedMs}ms F${sample.feedRate} ${sample.feedMode} ${sample.segmentDurationSeconds}s`).join(", ")),
+    check("task/HAL cycle 推进", runSamples.some((sample) => Number(sample.taskCycle || 0) > 0 && Number(sample.servoCycle || 0) > 0), runSamples.map((sample) => `${sample.taskCycle}/${sample.servoCycle}`).join(", ")),
+    check("STOP 后 loop 停止", finalState.taskHalStatusLoop?.active === false, `active=${finalState.taskHalStatusLoop?.active}, stopReason=${finalState.taskHalStatusLoop?.stopReason}`),
+  );
+}
+
+function summarizeState(state) {
+  const currentTimingSegment = currentTimingSegmentForState(state);
+  return {
+    activeProgram: state.activeProgram,
+    programSource: state.programSource,
+    programExecutionSourceMode: state.programExecutionSourceMode,
+    programSummary: state.programExecution?.summary || null,
+    machineProfile: state.machineProfile,
+    iniPath: state.iniConfigReadiness?.path || state.linuxCncIniConfig?.path || null,
+    selectedGcodeSourceRel: state.machineFileStaging?.selectedGcodeSourceRel || null,
+    loadedSourceBytes: state.machineFileStaging?.save?.files?.find((file) => file.sourceRel === state.machineFileStaging?.selectedGcodeSourceRel)?.bytes || null,
+    taskHalProgramPath: state.taskHalSession?.programPath || null,
+    runState: state.runState,
+    activeLine: state.activeLine,
+    activeUiLine: state.__activeUiLine,
+    machine: state.machine,
+    rtcpState: state.rtcpState,
+    kinsType: state.kinsType,
+    dro: pickAxes(state.dro),
+    axisPose: pickAxes(state.axisPose),
+    programRuntimeFeedback: state.programRuntimeFeedback,
+    currentTimingSegment,
+    currentLineExecution: state.programLineExecution?.[state.activeLine] || null,
+    currentLineExecutionVisible: Boolean(state.__activeUiLineExecutionText?.includes("F ") && state.__activeUiLineExecutionText?.includes("cycle")),
+    feedbackHistoryLength: state.programRuntimeFeedbackHistory?.length || 0,
+    taskHalStatusLoop: state.taskHalStatusLoop,
+    taskHalStatus: state.taskHalStatus ? {
+      taskState: state.taskHalStatus.ui?.taskState || state.taskHalStatus.task?.state || null,
+      taskMode: state.taskHalStatus.ui?.taskMode || state.taskHalStatus.task?.mode || null,
+      interpState: state.taskHalStatus.ui?.interpState || state.taskHalStatus.task?.interpState || null,
+      activeLine: state.taskHalStatus.ui?.activeLine || null,
+      taskCycle: state.taskHalStatus.ui?.taskCycle || null,
+      servoCycle: state.taskHalStatus.ui?.servoCycle || null,
+    } : null,
+  };
+}
+
+function currentTimingSegmentForState(state) {
+  const activeLine = Number(state.activeLine || 0);
+  const segments = state.programExecutionTiming?.segments || [];
+  if (!Number.isFinite(activeLine) || !Array.isArray(segments) || segments.length === 0) {
+    return null;
+  }
+  return segments.find((segment) => Number(segment.line) === activeLine)
+    || [...segments].reverse().find((segment) => Number(segment.line) <= activeLine)
+    || null;
+}
+
+async function wait(ms) {
+  await new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+async function waitForState(predicate, timeoutMs, label) {
+  const start = Date.now();
+  while (Date.now() - start < timeoutMs) {
+    const state = await getStateWithUi();
+    if (predicate(state)) return state;
+    await wait(100);
+  }
+  throw new Error(`timeout waiting for ${label}`);
+}
+
+async function waitForCanvasReady(timeoutMs = 20000) {
+  await page.waitForFunction(() => {
+    const canvas = document.querySelector("[data-five-axis-canvas]");
+    return canvas?.dataset?.threeReady === "true"
+      && canvas?.dataset?.threePreviewScope === "machine-reference-and-toolpath";
+  }, { timeout: timeoutMs });
+}
+
+async function getStateWithUi() {
+  return page.evaluate(() => {
+    const state = JSON.parse(JSON.stringify(window.webRtcp5AxisSimulation.getState()));
+    const activeRow = document.querySelector(".gcode-row.active");
+    state.__activeUiLine = Number(activeRow?.dataset.programLine || 0);
+    state.__activeUiLineExecutionText = activeRow?.querySelector("[data-line-execution]")?.textContent || "";
+    state.loadedSourceBytes = state.machineFileStaging?.save?.files
+      ?.find((file) => file.sourceRel === state.machineFileStaging?.selectedGcodeSourceRel)
+      ?.bytes || null;
+    return state;
+  });
+}
+
+async function getCanvasDataset() {
+  return page.$eval("[data-five-axis-canvas]", (canvas) => ({ ...canvas.dataset }));
+}
+
+function createStaticServer(rootDir) {
+  return http.createServer(async (request, response) => {
+    try {
+      const requestPath = decodeURIComponent(new URL(request.url || "/", "http://127.0.0.1").pathname);
+      const relativePath = requestPath === "/" ? "/index.html" : requestPath;
+      const targetPath = path.resolve(rootDir, `.${relativePath}`);
+      if (!targetPath.startsWith(rootDir)) {
+        response.writeHead(403);
+        response.end("forbidden");
+        return;
+      }
+      let filePath = targetPath;
+      let stat = await fs.stat(filePath).catch(() => null);
+      if (stat?.isDirectory()) {
+        filePath = path.join(filePath, "index.html");
+        stat = await fs.stat(filePath).catch(() => null);
+      }
+      if (!stat?.isFile()) {
+        response.writeHead(404);
+        response.end("not found");
+        return;
+      }
+      const body = await fs.readFile(filePath);
+      response.writeHead(200, {
+        "Content-Type": contentTypeFor(filePath),
+        "Content-Length": String(body.byteLength),
+        "Cache-Control": "no-store",
+      });
+      response.end(body);
+    } catch (error) {
+      response.writeHead(500);
+      response.end(error instanceof Error ? error.message : String(error));
+    }
+  });
+}
+
+function contentTypeFor(filePath) {
+  const ext = path.extname(filePath).toLowerCase();
+  return {
+    ".css": "text/css; charset=utf-8",
+    ".html": "text/html; charset=utf-8",
+    ".js": "text/javascript; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".mjs": "text/javascript; charset=utf-8",
+    ".svg": "image/svg+xml",
+    ".wasm": "application/wasm",
+    ".xml": "application/xml; charset=utf-8",
+  }[ext] || "application/octet-stream";
+}
+
+async function analyzePng(filePath) {
+  const png = PNG.sync.read(await fs.readFile(filePath));
+  let luminanceSum = 0;
+  let nonBlack = 0;
+  for (let index = 0; index < png.data.length; index += 4) {
+    const luminance = png.data[index] * 0.2126 + png.data[index + 1] * 0.7152 + png.data[index + 2] * 0.0722;
+    luminanceSum += luminance;
+    if (luminance > 8) nonBlack += 1;
+  }
+  const total = png.width * png.height;
+  return {
+    width: png.width,
+    height: png.height,
+    averageLuminance: Number((luminanceSum / total).toFixed(2)),
+    nonBlackRatio: Number((nonBlack / total).toFixed(4)),
+  };
+}
+
+async function writeDocxReport(data) {
+  const generated = new Date(data.generatedAt);
+  const ymd = generated.toISOString().slice(0, 10);
+  const docxPath = path.join(OUTPUT_DIR, `test-linuxcnc-source-run-report-${ymd}.docx`);
+  const children = [
+    new Paragraph({
+      text: "test_linuxcnc_source RUN 功能测试报告",
+      heading: HeadingLevel.TITLE,
+      alignment: AlignmentType.CENTER,
+    }),
+    centered(`测试对象：${data.targetUrl}`),
+    centered(`生成时间：${formatDateTime(generated)}`),
+    blank(),
+    heading("1. 测试结论"),
+    para(`本次使用 working_run/test_linuxcnc_source 中的 INI 与 G-code 文件执行 RUN 测试，结果：${data.status}。`),
+    checksTable(data.checks),
+    heading("2. 测试源文件"),
+    kvTable([
+      ["INI", data.sourceEvidence.iniPath],
+      ["INI SHA-256", data.sourceEvidence.iniSha256],
+      ["G-code", data.sourceEvidence.gcodePath],
+      ["G-code SHA-256", data.sourceEvidence.gcodeSha256],
+      ["G-code 行数/字节", `${data.sourceEvidence.gcodeLineCount} / ${data.sourceEvidence.gcodeBytes}`],
+    ]),
+    heading("3. 测试过程"),
+  ];
+
+  for (const step of data.steps) {
+    children.push(...(await stepBlock(step)));
+  }
+
+  children.push(
+    heading("4. RUN 采样明细"),
+    sampleTable(data.samples),
+    heading("5. 原始证据"),
+    kvTable([
+      ["JSON", data.jsonPath || path.join(OUTPUT_DIR, "test-linuxcnc-source-run-report.json")],
+      ["截图目录", SCREENSHOT_DIR],
+      ["Word", docxPath],
+      ["Console error", String(data.consoleErrors.length)],
+      ["Chrome", data.chromePath],
+    ]),
+  );
+
+  if (data.consoleErrors.length > 0) {
+    children.push(heading("6. Console Error"), ...data.consoleErrors.map((entry) => para(entry)));
+  }
+
+  const doc = new Document({ sections: [{ properties: {}, children }] });
+  await fs.writeFile(docxPath, await Packer.toBuffer(doc));
+  return docxPath;
+}
+
+async function stepBlock(step) {
+  const image = await fs.readFile(step.screenshotPath);
+  return [
+    new Paragraph({
+      text: `${step.name} - ${step.title}`,
+      heading: HeadingLevel.HEADING_2,
+      spacing: { before: 180, after: 120 },
+    }),
+    para(step.description),
+    kvTable([
+      ["activeProgram", step.state.activeProgram],
+      ["runState / activeLine", `${step.state.runState} / ${step.state.activeLine}`],
+      ["program source", `${step.state.programSource} / ${step.state.programExecutionSourceMode}`],
+      ["selected G-code", step.state.selectedGcodeSourceRel],
+      ["task/HAL program", step.state.taskHalProgramPath],
+      ["DRO XYZAC", axesText(step.state.dro)],
+      ["axisPose XYZAC", axesText(step.state.axisPose)],
+      ["path/executed", `${step.dataset.threePathPoints || 0} / ${step.dataset.threeExecutedPathPoints || 0}`],
+      ["RTCP / kins", `${step.state.rtcpState} / ${step.state.kinsType}`],
+      ["pixel", `luma=${step.pixelStats.averageLuminance}, nonBlack=${step.pixelStats.nonBlackRatio}`],
+    ]),
+    new Paragraph({
+      alignment: AlignmentType.CENTER,
+      children: [new ImageRun({
+        data: image,
+        type: "png",
+        transformation: { width: 520, height: 390 },
+      })],
+    }),
+    para(`截图文件：${step.screenshotPath}`),
+  ];
+}
+
+function sampleTable(samples) {
+  return new Table({
+    width: { size: 100, type: WidthType.PERCENTAGE },
+    rows: [
+      new TableRow({
+      children: ["时间", "行号", "状态", "DRO XYZAC", "速度/feed", "轨迹点", "反馈"].map((text) => cell(text, true)),
+      }),
+      ...samples.map((sample) => new TableRow({
+        children: [
+          cell(`${sample.elapsedMs}ms`),
+          cell(`${sample.activeLine} / UI ${sample.activeUiLine}`),
+          cell(sample.runState),
+          cell(axesText(sample.dro)),
+          cell(`${sample.velocity ?? "-"} mm/min\nF${sample.feedRate ?? "-"} ${sample.feedMode ?? "-"}`),
+          cell(String(sample.executedPathPoints)),
+          cell(`${sample.feedbackSource}\ncycle=${sample.taskCycle}/${sample.servoCycle}`),
+        ],
+      })),
+    ],
+  });
+}
+
+function checksTable(checks) {
+  return new Table({
+    width: { size: 100, type: WidthType.PERCENTAGE },
+    rows: [
+      new TableRow({ children: [cell("检查项", true), cell("结果", true), cell("证据", true)] }),
+      ...checks.map((item) => new TableRow({
+        children: [cell(item.name), cell(item.pass ? "PASS" : "FAIL"), cell(item.detail)],
+      })),
+    ],
+  });
+}
+
+function kvTable(rows) {
+  return new Table({
+    width: { size: 100, type: WidthType.PERCENTAGE },
+    rows: [
+      new TableRow({ children: [cell("项目", true), cell("内容", true)] }),
+      ...rows.map(([key, value]) => new TableRow({ children: [cell(key), cell(value)] })),
+    ],
+  });
+}
+
+function centered(text) {
+  return new Paragraph({ alignment: AlignmentType.CENTER, children: [new TextRun(String(text))] });
+}
+
+function heading(text) {
+  return new Paragraph({ text, heading: HeadingLevel.HEADING_1, spacing: { before: 240, after: 120 } });
+}
+
+function blank() {
+  return new Paragraph({ text: "" });
+}
+
+function para(text) {
+  return new Paragraph({ children: [new TextRun(String(text ?? "-"))], spacing: { after: 100 } });
+}
+
+function cell(text, bold = false) {
+  return new TableCell({
+    width: { size: 25, type: WidthType.PERCENTAGE },
+    children: String(text ?? "-").split("\n").map((line) => new Paragraph({
+      children: [new TextRun({ text: line, bold })],
+    })),
+  });
+}
+
+function check(name, pass, detail) {
+  return { name, pass: Boolean(pass), detail: String(detail ?? "-") };
+}
+
+function pickAxes(value = {}) {
+  return {
+    x: Number(value.x || 0),
+    y: Number(value.y || 0),
+    z: Number(value.z || 0),
+    a: Number(value.a || 0),
+    b: Number(value.b || 0),
+    c: Number(value.c || 0),
+  };
+}
+
+function axesMatch(left = {}, right = {}) {
+  return ["x", "y", "z", "a", "b", "c"].every((axis) => Math.abs(Number(left?.[axis] || 0) - Number(right?.[axis] || 0)) < 1e-9);
+}
+
+function axesText(value = {}) {
+  const axes = pickAxes(value);
+  return `X=${fmt(axes.x)} Y=${fmt(axes.y)} Z=${fmt(axes.z)} A=${fmt(axes.a)} B=${fmt(axes.b)} C=${fmt(axes.c)}`;
+}
+
+function fmt(value) {
+  return Number(value || 0).toFixed(3);
+}
+
+function sha256(text) {
+  return createHash("sha256").update(text).digest("hex");
+}
+
+function formatDateTime(date) {
+  return date.toISOString().replace("T", " ").replace(/\.\d+Z$/, " UTC");
+}

qa/web-rtcp-5axis-site-test/capture-toolpath-preview-cases.mjs

@@ -0,0 +1,687 @@
+import fs from "node:fs/promises";
+import http from "node:http";
+import path from "node:path";
+import puppeteer from "puppeteer-core";
+import { PNG } from "pngjs";
+
+const REPO_ROOT = path.resolve("/home/meswork/cnc_wams");
+const QA_ROOT = path.resolve("/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test");
+const OUTPUT_DIR = path.join(QA_ROOT, "output");
+const SCREENSHOT_DIR = path.join(QA_ROOT, "screenshots", "toolpath-preview-cases");
+const RUN_FEEDBACK_SCREENSHOT_DIR = path.join(QA_ROOT, "screenshots", "run-preconditions-feedback");
+const METER_SCENE_SCREENSHOT_DIR = path.join(QA_ROOT, "screenshots", "meter-scene-evidence");
+const CHROME_PATH = process.env.CHROME_PATH || "/usr/bin/google-chrome";
+const FIXTURE_URL = "/web-rtcp-5axis-sim-plan/app/index.html";
+
+await fs.mkdir(OUTPUT_DIR, { recursive: true });
+await fs.mkdir(SCREENSHOT_DIR, { recursive: true });
+await fs.mkdir(RUN_FEEDBACK_SCREENSHOT_DIR, { recursive: true });
+await fs.mkdir(METER_SCENE_SCREENSHOT_DIR, { recursive: true });
+
+const MIME_TYPES = {
+  ".css": "text/css; charset=utf-8",
+  ".html": "text/html; charset=utf-8",
+  ".js": "text/javascript; charset=utf-8",
+  ".json": "application/json; charset=utf-8",
+  ".mjs": "text/javascript; charset=utf-8",
+  ".svg": "image/svg+xml",
+  ".wasm": "application/wasm",
+  ".xml": "application/xml; charset=utf-8",
+};
+
+function contentTypeFor(filePath) {
+  return MIME_TYPES[path.extname(filePath).toLowerCase()] || "application/octet-stream";
+}
+
+function createStaticServer(rootDir) {
+  return http.createServer(async (request, response) => {
+    try {
+      const requestPath = decodeURIComponent(new URL(request.url || "/", "http://127.0.0.1").pathname);
+      const relativePath = requestPath === "/" ? "/index.html" : requestPath;
+      const targetPath = path.resolve(rootDir, `.${relativePath}`);
+      if (!targetPath.startsWith(rootDir)) {
+        response.writeHead(403);
+        response.end("forbidden");
+        return;
+      }
+      let stat = await fs.stat(targetPath).catch(() => null);
+      let filePath = targetPath;
+      if (stat?.isDirectory()) {
+        filePath = path.join(targetPath, "index.html");
+        stat = await fs.stat(filePath).catch(() => null);
+      }
+      if (!stat?.isFile()) {
+        response.writeHead(404);
+        response.end("not found");
+        return;
+      }
+      const body = await fs.readFile(filePath);
+      response.writeHead(200, {
+        "Content-Type": contentTypeFor(filePath),
+        "Content-Length": String(body.byteLength),
+        "Cache-Control": "no-store",
+      });
+      response.end(body);
+    } catch (error) {
+      response.writeHead(500);
+      response.end(error instanceof Error ? error.message : String(error));
+    }
+  });
+}
+
+const server = createStaticServer(REPO_ROOT);
+await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
+const address = server.address();
+if (!address || typeof address === "string") {
+  throw new Error("failed to start static server");
+}
+const baseUrl = `http://127.0.0.1:${address.port}`;
+
+const browser = await puppeteer.launch({
+  headless: true,
+  executablePath: CHROME_PATH,
+  defaultViewport: { width: 1600, height: 1200, deviceScaleFactor: 1 },
+  args: [
+    "--disable-gpu",
+    "--enable-webgl",
+    "--use-angle=swiftshader",
+    "--enable-unsafe-swiftshader",
+    "--no-sandbox",
+  ],
+});
+
+const page = await browser.newPage();
+const consoleErrors = [];
+page.on("console", (msg) => {
+  if (msg.type() === "error") {
+    consoleErrors.push(msg.text());
+  }
+});
+page.on("pageerror", (error) => {
+  consoleErrors.push(error.message);
+});
+
+const report = {
+  generatedAt: new Date().toISOString(),
+  targetUrl: `${baseUrl}${FIXTURE_URL}`,
+  projectPath: path.join(REPO_ROOT, "web-rtcp-5axis-sim-plan", "app", "index.html"),
+  chromePath: CHROME_PATH,
+  screenshots: {},
+  cases: [],
+  consoleErrors,
+};
+
+async function wait(ms) {
+  await new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+async function waitForState(predicate, timeoutMs = 20000, label = "state condition") {
+  const start = Date.now();
+  while (Date.now() - start < timeoutMs) {
+    const snapshot = await page.evaluate(() => JSON.parse(JSON.stringify(window.webRtcp5AxisSimulation.getState())));
+    if (predicate(snapshot)) return snapshot;
+    await wait(100);
+  }
+  throw new Error(`timeout waiting for ${label}`);
+}
+
+async function getCanvasDataset() {
+  return page.$eval("[data-five-axis-canvas]", (canvas) => ({ ...canvas.dataset }));
+}
+
+async function waitForCanvasReady(timeoutMs = 20000) {
+  await page.waitForFunction(() => {
+    const canvas = document.querySelector("[data-five-axis-canvas]");
+    return canvas?.dataset?.threeReady === "true"
+      && canvas?.dataset?.threePreviewScope === "machine-reference-and-toolpath";
+  }, { timeout: timeoutMs });
+}
+
+async function captureCase(name) {
+  const screenshotPath = path.join(SCREENSHOT_DIR, `${name}.png`);
+  const canvas = await page.$("[data-five-axis-canvas]");
+  if (!canvas) {
+    throw new Error(`missing canvas for ${name}`);
+  }
+  await canvas.screenshot({ path: screenshotPath });
+  report.screenshots[name] = screenshotPath;
+  return screenshotPath;
+}
+
+async function captureRunFeedbackFrame(name) {
+  const screenshotPath = path.join(RUN_FEEDBACK_SCREENSHOT_DIR, `${name}.png`);
+  await page.screenshot({ path: screenshotPath, fullPage: true });
+  return screenshotPath;
+}
+
+async function captureMeterSceneFrame(name) {
+  const screenshotPath = path.join(METER_SCENE_SCREENSHOT_DIR, `${name}.png`);
+  const canvas = await page.$("[data-five-axis-canvas]");
+  if (!canvas) {
+    throw new Error(`missing canvas for ${name}`);
+  }
+  await canvas.screenshot({ path: screenshotPath });
+  return screenshotPath;
+}
+
+async function recordCase(name, summary, checks = []) {
+  const dataset = await getCanvasDataset();
+  const state = await page.evaluate(() => JSON.parse(JSON.stringify(window.webRtcp5AxisSimulation.getState())));
+  const screenshotPath = report.screenshots[name];
+  const pixelStats = screenshotPath ? await analyzePng(screenshotPath) : null;
+  report.cases.push({
+    name,
+    summary,
+    status: checks.every((check) => check.pass) ? "PASS" : "FAIL",
+    checks,
+    pixelStats,
+    dataset,
+    state: {
+      activeProgram: state.activeProgram,
+      activeLine: state.activeLine,
+      programSource: state.programSource,
+      programExecutionSourceMode: state.programExecutionSourceMode,
+      programExecutionSummary: state.programExecution?.summary || null,
+      runState: state.runState,
+      rtcpState: state.rtcpState,
+      kinsType: state.kinsType,
+      activeLine: state.activeLine,
+      programExecutionMotionIndex: state.programExecutionMotionIndex,
+      programExecutionSampleIndex: state.programExecutionSampleIndex,
+      programRuntimeFeedbackSource: state.programRuntimeFeedback?.sourceMode || null,
+    },
+  });
+}
+
+function previewChecks(dataset, {
+  requirePathPoints = true,
+  requireExecutedPath = false,
+  requireArcPoints = false,
+  requireRapidFeed = false,
+  expectPathPoints = null,
+  expectRtcp = null,
+} = {}) {
+  const checks = [
+    check("canvas ready", dataset.threeReady === "true", `threeReady=${dataset.threeReady}`),
+    check("WebGL renderer", dataset.threeRenderer === "webgl", `renderer=${dataset.threeRenderer}`),
+    check("机床参考模型", dataset.threePreviewScope === "machine-reference-and-toolpath" && dataset.threeMachineReferenceModel === "webgl-five-axis-reference", `scope=${dataset.threePreviewScope}, model=${dataset.threeMachineReferenceModel}`),
+    check("TCP 球标记", dataset.threeTcpMarker === "sphere" && dataset.threeToolExecutionMarker === "true", `tcp=${dataset.threeTcpMarker}, marker=${dataset.threeToolExecutionMarker}`),
+    check("刀轴线", dataset.threeToolAxisMarker === "line", `toolAxisMarker=${dataset.threeToolAxisMarker}`),
+    check("场景对象数量", Number(dataset.threeSceneObjects || 0) >= 12, `sceneObjects=${dataset.threeSceneObjects}`),
+    check("无 G-code 语义生成", dataset.threeNoGcodeSemanticsGeneration === "ok", `semanticGuard=${dataset.threeNoGcodeSemanticsGeneration}`),
+  ];
+  if (requirePathPoints) {
+    checks.push(check("刀路预览点", Number(dataset.threePathPoints || 0) >= 1, `pathPoints=${dataset.threePathPoints}`));
+  }
+  if (requireExecutedPath) {
+    checks.push(check("执行轨迹点", Number(dataset.threeExecutedPathPoints || 0) >= 1, `executed=${dataset.threeExecutedPathPoints}`));
+  }
+  if (requireArcPoints) {
+    checks.push(check("圆弧轨迹点", Number(dataset.threeArcPathPoints || 0) >= 1, `arc=${dataset.threeArcPathPoints}`));
+  }
+  if (requireRapidFeed) {
+    checks.push(check("rapid/feed 区分", Number(dataset.threeRapidPathPoints || 0) >= 1 && Number(dataset.threeFeedPathPoints || 0) >= 1, `rapid=${dataset.threeRapidPathPoints}, feed=${dataset.threeFeedPathPoints}`));
+  }
+  if (expectPathPoints !== null) {
+    checks.push(check("路径点期望", Number(dataset.threePathPoints || 0) === expectPathPoints, `pathPoints=${dataset.threePathPoints}, expected=${expectPathPoints}`));
+  }
+  if (expectRtcp !== null) {
+    checks.push(check("RTCP 状态", dataset.threeRtcpState === expectRtcp, `rtcp=${dataset.threeRtcpState}`));
+  }
+  return checks;
+}
+
+function meterSceneChecks(dataset, pixelStats = null) {
+  const bounds = parseJson(dataset.threePathBoundsMeters);
+  return [
+    check("scene units are meters", dataset.threeSceneUnits === "m", `sceneUnits=${dataset.threeSceneUnits}`),
+    check("linear scale visible", Number(dataset.threeLinearUnitScaleToMeters || 0) > 0, `scale=${dataset.threeLinearUnitScaleToMeters}`),
+    check("path fit bounds", dataset.threePathFitBounds === "ok", `fit=${dataset.threePathFitBounds}`),
+    check("path bounds in meters", Number(bounds?.maxSpan || 0) > 0 && Number(bounds?.maxSpan || 0) < 5, `bounds=${dataset.threePathBoundsMeters}`),
+    check("canvas nonblank", !pixelStats || pixelStats.nonBlackRatio > 0.015, `nonBlack=${pixelStats?.nonBlackRatio ?? "-"}`),
+  ];
+}
+
+function mixedUnitsChecks(dataset, state) {
+  const motion = state.programExecution?.motion || [];
+  const units = [...new Set(motion.map((event) => event.linearUnits).filter(Boolean))];
+  const xMeters = motion.map((event) => sceneMeterX(event)).filter(Number.isFinite);
+  return [
+    check("G20/G21 motion units", units.includes("inch") && units.includes("mm"), `units=${units.join(",")}`),
+    check("scene units are meters", dataset.threeSceneUnits === "m", `sceneUnits=${dataset.threeSceneUnits}`),
+    check("mixed unit path visible", Number(dataset.threePathPoints || 0) >= 2, `pathPoints=${dataset.threePathPoints}`),
+    check("1 inch equals 25.4 mm in scene", xMeters.some((value) => Math.abs(value - 0.0254) < 1e-9), `xMeters=${xMeters.join(",")}`),
+    check("no unit fallback in canonical motion", state.programExecutionSourceMode === "linuxcnc-interpreter-wasm", `source=${state.programExecutionSourceMode}`),
+  ];
+}
+
+function sceneMeterX(event) {
+  const factor = event?.linearUnits === "inch" ? 0.0254 : event?.linearUnits === "m" ? 1 : 0.001;
+  const value = Number(event?.axes?.x);
+  return Number.isFinite(value) ? value * factor : null;
+}
+
+function parseJson(text) {
+  try {
+    return JSON.parse(text || "null");
+  } catch {
+    return null;
+  }
+}
+
+function check(name, pass, detail) {
+  return { name, pass: Boolean(pass), detail };
+}
+
+function assertChecks(caseName, checks) {
+  const failed = checks.filter((item) => !item.pass);
+  if (failed.length > 0) {
+    console.warn(`${caseName} failed: ${failed.map((item) => `${item.name} (${item.detail})`).join("; ")}`);
+  }
+}
+
+function summarizeRunFeedbackState(state, dataset, elapsedMs, screenshotPath) {
+  const activeRowLine = Number(documentActiveLineFromState(state));
+  return {
+    elapsedMs,
+    screenshotPath,
+    canvas: {
+      threeReady: dataset.threeReady,
+      rtcpState: dataset.threeRtcpState,
+      executedPathPoints: Number(dataset.threeExecutedPathPoints || 0),
+      currentSegmentHighlight: dataset.threeCurrentSegmentHighlight,
+      toolExecutionTraceSource: dataset.threeToolExecutionTraceSource,
+    },
+    state: {
+      profileId: state.machineProfile,
+      iniReady: state.iniConfigReadiness?.ready === true,
+      iniPath: state.iniConfigReadiness?.path || null,
+      coordinates: state.iniConfigReadiness?.coordinates || null,
+      kinematicsModuleId: state.profile?.kinematicsModuleId || null,
+      selectedGcodeSourceRel: state.machineFileStaging?.selectedGcodeSourceRel || null,
+      taskHalSessionProgramPath: state.taskHalSession?.programPath || null,
+      taskHalStatusLoop: state.taskHalStatusLoop || null,
+      runState: state.runState,
+      activeLine: state.activeLine,
+      activeRowLine,
+      activeLineMatchesUi: activeRowLine === Number(state.activeLine),
+      droAxisPose: state.dro ? {
+        x: state.dro.x,
+        y: state.dro.y,
+        z: state.dro.z,
+        a: state.dro.a,
+        b: state.dro.b,
+        c: state.dro.c,
+      } : null,
+      feedbackAxisPose: state.programRuntimeFeedback?.axisPose || null,
+      droMatchesFeedback: axisPoseMatchesDro(state.dro, state.programRuntimeFeedback?.axisPose),
+      rtcpState: state.rtcpState,
+      kinsType: state.kinsType,
+      feedback: state.programRuntimeFeedback ? {
+        sourceMode: state.programRuntimeFeedback.sourceMode,
+        semanticBoundary: state.programRuntimeFeedback.semanticBoundary,
+        line: state.programRuntimeFeedback.line,
+        taskCycle: state.programRuntimeFeedback.taskCycle,
+        servoCycle: state.programRuntimeFeedback.cycle,
+        velocity: state.programRuntimeFeedback.currentVelocityMmPerMin,
+        distanceToGo: state.programRuntimeFeedback.distanceToGo,
+      } : null,
+      feedbackHistoryLength: state.programRuntimeFeedbackHistory?.length || 0,
+      feedbackHistorySourceModes: [...new Set((state.programRuntimeFeedbackHistory || []).map((entry) => entry.sourceMode))],
+      taskHalStatus: state.taskHalStatus ? {
+        taskState: state.taskHalStatus.ui?.taskState || state.taskHalStatus.task?.state || null,
+        taskMode: state.taskHalStatus.ui?.taskMode || state.taskHalStatus.task?.mode || null,
+        interpState: state.taskHalStatus.ui?.interpState || state.taskHalStatus.task?.interpState || null,
+        taskCycle: state.taskHalStatus.ui?.taskCycle || null,
+        servoCycle: state.taskHalStatus.ui?.servoCycle || null,
+      } : null,
+    },
+  };
+}
+
+function documentActiveLineFromState(state) {
+  return state.__activeRowLine ?? null;
+}
+
+function axisPoseMatchesDro(dro, axisPose) {
+  if (!dro || !axisPose) return false;
+  return ["x", "y", "z", "a", "b", "c"].every((axis) => (
+    Math.abs(Number(dro[axis] || 0) - Number(axisPose[axis] || 0)) < 1e-9
+  ));
+}
+
+async function snapshotRunFeedback(elapsedMs, screenshotName) {
+  const screenshotPath = await captureRunFeedbackFrame(screenshotName);
+  const dataset = await getCanvasDataset();
+  const state = await page.evaluate(() => {
+    const snapshot = JSON.parse(JSON.stringify(window.webRtcp5AxisSimulation.getState()));
+    snapshot.__activeRowLine = Number(document.querySelector(".gcode-row.active")?.dataset.programLine || 0);
+    return snapshot;
+  });
+  return summarizeRunFeedbackState(state, dataset, elapsedMs, screenshotPath);
+}
+
+function runFeedbackChecks(samples, baseline = null) {
+  const states = samples.map((sample) => sample.state);
+  const histories = states.map((state) => Number(state.feedbackHistoryLength || 0));
+  const ticks = states.map((state) => Number(state.taskHalStatusLoop?.tickCount || 0));
+  const baselineSequence = Number(baseline?.state?.taskHalStatusLoop?.sequence || 0);
+  const sourceModes = states.flatMap((state) => state.feedbackHistorySourceModes || []);
+  return [
+    check("INI ready", states.every((state) => state.iniReady), `iniReady=${states.map((state) => state.iniReady).join(",")}`),
+    check("selected LinuxCNC G-code", states.every((state) => state.selectedGcodeSourceRel?.endsWith("xyzac_switchkins_test_1.ngc")), states.at(-1)?.selectedGcodeSourceRel || "-"),
+    check("task/HAL session opened selected G-code", states.every((state) => state.taskHalSessionProgramPath?.endsWith("xyzac_switchkins_test_1.ngc")), states.at(-1)?.taskHalSessionProgramPath || "-"),
+    check("taskHalStatusLoop 新 RUN sequence", states.every((state) => Number(state.taskHalStatusLoop?.sequence || 0) > baselineSequence), `baselineSequence=${baselineSequence}, sequences=${states.map((state) => state.taskHalStatusLoop?.sequence || 0).join(",")}`),
+    check("taskHalStatusLoop 本次 RUN tickCount", Math.max(...ticks) >= 3, `ticks=${ticks.join(",")}`),
+    check("programRuntimeFeedbackHistory 本次 RUN 采样", Math.max(...histories) >= 3, `history=${histories.join(",")}`),
+    check("feedback sourceMode 来自 task/HAL", sourceModes.length > 0 && sourceModes.every((mode) => mode === "linuxcnc-task-motion-hal-wasm"), `sourceModes=${sourceModes.join(",")}`),
+    check("无 fixture-line-playback feedback", !sourceModes.includes("fixture-line-playback"), `sourceModes=${sourceModes.join(",")}`),
+    check("semantic boundary", states.every((state) => state.feedback?.semanticBoundary === "linuxcnc_task_motion_hal_wasm_simulation_runtime"), states.map((state) => state.feedback?.semanticBoundary || "-").join(",")),
+    check("activeLine 等于 UI 高亮行", states.every((state) => state.activeLineMatchesUi), `active=${states.map((state) => `${state.activeLine}/${state.activeRowLine}`).join(",")}`),
+    check("DRO 等于 runtime feedback axisPose", states.every((state) => state.droMatchesFeedback), "droMatchesFeedback=true for all samples"),
+    check("RTCP canvas 与 state 一致", samples.every((sample) => sample.canvas.rtcpState === sample.state.rtcpState), samples.map((sample) => `${sample.canvas.rtcpState}/${sample.state.rtcpState}`).join(",")),
+    check("runtime cycle 可见", states.every((state) => Number(state.feedback?.taskCycle || 0) > 0 && Number(state.feedback?.servoCycle || 0) > 0), states.map((state) => `${state.feedback?.taskCycle || 0}/${state.feedback?.servoCycle || 0}`).join(",")),
+    check("canvas 执行轨迹", samples.every((sample) => sample.canvas.threeReady === "true" && sample.canvas.currentSegmentHighlight === "ok" && sample.canvas.executedPathPoints >= 1), samples.map((sample) => `${sample.canvas.threeReady}/${sample.canvas.executedPathPoints}/${sample.canvas.currentSegmentHighlight}`).join(",")),
+  ];
+}
+
+try {
+  await page.goto(`${baseUrl}${FIXTURE_URL}`, { waitUntil: "networkidle2", timeout: 60000 });
+  await page.waitForSelector('[data-shell="gmoccapy-5axis"]', { timeout: 15000 });
+  await page.waitForFunction(() => Boolean(window.webRtcp5AxisSimulation?.getState), { timeout: 15000 });
+  await waitForState((state) => state.kinematicsRuntimeReadiness?.loaded === true, 20000, "kinematics runtime ready");
+  await waitForCanvasReady();
+  await wait(1200);
+
+  let dataset = await getCanvasDataset();
+  let checks = previewChecks(dataset, { requirePathPoints: true, requireExecutedPath: true });
+  assertChecks("01-home-toolpath", checks);
+  await captureCase("01-home-toolpath");
+  await recordCase("01-home-toolpath", "默认首屏预览：机床参考模型、TCP 球、刀轴线、fixture 路径和执行轨迹可见", checks);
+
+  await page.evaluate(() => {
+    window.webRtcp5AxisSimulation.dispatch({
+      type: "LOAD_PROGRAM",
+      filename: "operator-demo.ngc",
+      content: [
+        "G90 G17",
+        "G0 X0 Y0 Z0",
+        "G1 X10 F100",
+        "G1 Y10",
+        "G1 X0",
+        "G1 Y0",
+        "G0 Z5",
+        "M5",
+        "M2",
+      ].join("\n"),
+    });
+  });
+  await waitForState((state) => state.programExecutionSourceMode === "linuxcnc-interpreter-wasm" && state.activeProgram === "operator-demo.ngc", 20000, "operator demo loaded");
+  await waitForCanvasReady();
+  await wait(500);
+  dataset = await getCanvasDataset();
+  checks = previewChecks(dataset, { requirePathPoints: true, requireExecutedPath: true, requireRapidFeed: true });
+  assertChecks("02-operator-demo-toolpath", checks);
+  await captureCase("02-operator-demo-toolpath");
+  await recordCase("02-operator-demo-toolpath", "本地矩形 G-code：验证 LinuxCNC interpreter canonical motion、rapid/feed 区分、执行轨迹和 TCP 标记", checks);
+
+  await page.evaluate(() => {
+    window.webRtcp5AxisSimulation.dispatch({
+      type: "LOAD_PROGRAM",
+      filename: "operator-arc-demo.ngc",
+      content: [
+        "G90 G17",
+        "G0 X1 Y0 Z0",
+        "G2 X0 Y1 I-1 J0 F60",
+        "M2",
+      ].join("\n"),
+    });
+  });
+  await waitForState((state) => state.activeProgram === "operator-arc-demo.ngc" && state.programExecution?.summary?.motionTypes?.includes("ARC_FEED"), 20000, "arc demo loaded");
+  await waitForCanvasReady();
+  await wait(500);
+  dataset = await getCanvasDataset();
+  checks = previewChecks(dataset, { requirePathPoints: true, requireExecutedPath: true, requireArcPoints: true });
+  assertChecks("03-arc-demo-toolpath", checks);
+  await captureCase("03-arc-demo-toolpath");
+  await recordCase("03-arc-demo-toolpath", "圆弧 G-code：验证 ARC_FEED 进入弧线轨迹图层并保留执行轨迹", checks);
+
+  await page.evaluate(() => document.querySelector('[data-action="clear-preview"]').click());
+  await waitForCanvasReady();
+  await wait(500);
+  dataset = await getCanvasDataset();
+  checks = previewChecks(dataset, { requirePathPoints: false, expectPathPoints: 0 });
+  assertChecks("04-clear-preview-reference", checks);
+  await captureCase("04-clear-preview-reference");
+  await recordCase("04-clear-preview-reference", "清空刀路后：路径点为 0，但机床参考模型、TCP 球和刀轴线仍应可见", checks);
+
+  await waitForState((state) => state.machineFileStaging?.status === "staged" && (state.machineFileStaging?.gcodeSources?.length || 0) >= 4, 25000, "machine files staged");
+  await page.select('[data-action="select-linuxcnc-gcode-source"]', "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/impeller-7bl-xyzac.ngc");
+  await waitForState((state) => state.activeProgram?.endsWith("impeller-7bl-xyzac.ngc"), 25000, "vendored impeller loaded");
+  await waitForCanvasReady();
+  await wait(1200);
+  dataset = await getCanvasDataset();
+  checks = previewChecks(dataset, { requirePathPoints: true, requireExecutedPath: true, requireRapidFeed: true, expectRtcp: "on" });
+  assertChecks("05-vendored-impeller-toolpath", checks);
+  await captureCase("05-vendored-impeller-toolpath");
+  await recordCase("05-vendored-impeller-toolpath", "LinuxCNC vendored 五轴 impeller 程序：验证长路径、switchkins/RTCP 状态、rapid/feed 图层和 TCP 执行轨迹", checks);
+
+  const meterSceneSamples = [];
+  for (const viewport of [
+    { name: "desktop", width: 1600, height: 1200, deviceScaleFactor: 1 },
+    { name: "mobile", width: 390, height: 844, deviceScaleFactor: 2 },
+  ]) {
+    await page.setViewport(viewport);
+    await waitForCanvasReady();
+    await wait(600);
+    const screenshotPath = await captureMeterSceneFrame(`08-meter-scene-${viewport.name}`);
+    const sampleDataset = await getCanvasDataset();
+    const pixelStats = await analyzePng(screenshotPath);
+    const sampleChecks = [
+      ...previewChecks(sampleDataset, { requirePathPoints: true, requireExecutedPath: true }),
+      ...meterSceneChecks(sampleDataset, pixelStats),
+    ];
+    assertChecks(`08-meter-scene-${viewport.name}`, sampleChecks);
+    meterSceneSamples.push({
+      viewport,
+      screenshotPath,
+      pixelStats,
+      dataset: sampleDataset,
+      status: sampleChecks.every((item) => item.pass) ? "PASS" : "FAIL",
+      checks: sampleChecks,
+    });
+  }
+  await page.setViewport({ width: 1600, height: 1200, deviceScaleFactor: 1 });
+  const meterSceneChecksAll = meterSceneSamples.flatMap((sample) => sample.checks);
+  const meterSceneReport = {
+    generatedAt: new Date().toISOString(),
+    targetUrl: report.targetUrl,
+    caseName: "08-meter-scene-desktop-mobile",
+    summary: "浏览器米尺度 Three.js 证据：desktop/mobile canvas 非空、路径 bounds 为米、预览稳定居中",
+    status: meterSceneChecksAll.every((item) => item.pass) ? "PASS" : "FAIL",
+    samples: meterSceneSamples,
+    consoleErrors,
+  };
+  await fs.writeFile(
+    path.join(OUTPUT_DIR, "meter-scene-evidence.json"),
+    `${JSON.stringify(meterSceneReport, null, 2)}\n`,
+    "utf8",
+  );
+  report.cases.push({
+    name: "08-meter-scene-desktop-mobile",
+    summary: meterSceneReport.summary,
+    status: meterSceneReport.status,
+    screenshotDir: METER_SCENE_SCREENSHOT_DIR,
+    output: path.join(OUTPUT_DIR, "meter-scene-evidence.json"),
+    sampleCount: meterSceneSamples.length,
+  });
+
+  await page.evaluate(() => {
+    window.webRtcp5AxisSimulation.dispatch({
+      type: "LOAD_PROGRAM",
+      filename: "operator-g20-g21-mixed-units.ngc",
+      content: [
+        "G90 G20",
+        "G1 X1.0 Y0 Z0 F10",
+        "G21",
+        "G1 X25.4 Y25.4 Z0 F254",
+        "M2",
+      ].join("\n"),
+    });
+  });
+  await waitForState((state) => (
+    state.activeProgram === "operator-g20-g21-mixed-units.ngc" &&
+    state.programExecutionSourceMode === "linuxcnc-interpreter-wasm" &&
+    (state.programExecution?.motion || []).some((event) => event.linearUnits === "inch") &&
+    (state.programExecution?.motion || []).some((event) => event.linearUnits === "mm")
+  ), 20000, "G20/G21 mixed unit program loaded");
+  await waitForCanvasReady();
+  await wait(600);
+  dataset = await getCanvasDataset();
+  const mixedUnitsState = await page.evaluate(() => JSON.parse(JSON.stringify(window.webRtcp5AxisSimulation.getState())));
+  checks = [
+    ...previewChecks(dataset, { requirePathPoints: true, requireExecutedPath: true }),
+    ...mixedUnitsChecks(dataset, mixedUnitsState),
+  ];
+  assertChecks("09-g20-g21-mixed-units-preview", checks);
+  await captureCase("09-g20-g21-mixed-units-preview");
+  await recordCase("09-g20-g21-mixed-units-preview", "G20/G21 混合单位程序：验证 canonical motion 保留 inch/mm，Three.js 统一按米绘制", checks);
+
+  await page.select('[data-action="select-linuxcnc-gcode-source"]', "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/impeller-7bl-xyzac.ngc");
+  await waitForState((state) => state.activeProgram?.endsWith("impeller-7bl-xyzac.ngc"), 25000, "vendored impeller restored before run");
+  await waitForCanvasReady();
+  await wait(800);
+
+  await page.evaluate(() => document.querySelector('[data-action="power"]').click());
+  await waitForState((state) => state.machine.taskState === "on", 10000, "machine powered on");
+  await page.evaluate(() => document.querySelector('[data-action="mode-manual"]').click());
+  await waitForState((state) => state.machine.mode === "manual", 10000, "manual mode selected");
+  await page.evaluate(() => document.querySelector('[data-action="HOME"]').click());
+  await waitForState((state) => state.machine.allHomed === true, 10000, "machine homed");
+  await page.evaluate(() => document.querySelector('[data-action="mode-auto"]').click());
+  await waitForState((state) => state.machine.mode === "auto", 10000, "auto mode selected");
+  await page.evaluate(() => document.querySelector('[data-action="kins-tcp"]').click());
+  await waitForState((state) => state.rtcpState === "on" && state.kinsType === "tcp-xyzac", 10000, "RTCP enabled");
+  await page.evaluate(() => document.querySelector('[data-action="RUN"]').click());
+  await waitForState((state) => state.runState === "running" && state.programRuntimeFeedback?.sourceMode === "linuxcnc-task-motion-hal-wasm", 15000, "program running");
+  await waitForCanvasReady();
+  await wait(600);
+  dataset = await getCanvasDataset();
+  checks = previewChecks(dataset, { requirePathPoints: true, requireExecutedPath: true, requireRapidFeed: true, expectRtcp: "on" });
+  assertChecks("06-running-rtcp-toolpath", checks);
+  await captureCase("06-running-rtcp-toolpath");
+  await recordCase("06-running-rtcp-toolpath", "G-code 运行态：验证 task/HAL runtime feedback 驱动执行轨迹、当前段高亮、TCP 球和刀轴线跟随", checks);
+
+  await page.evaluate(() => document.querySelector('[data-action="STOP"]').click());
+  await waitForState((state) => state.taskHalStatusLoop?.active === false, 10000, "previous run stopped");
+  await page.select('[data-action="select-linuxcnc-gcode-source"]', "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/xyzac_switchkins_test_1.ngc");
+  await waitForState((state) => (
+    state.activeProgram?.endsWith("xyzac_switchkins_test_1.ngc") &&
+    state.taskHalSession?.programPath?.endsWith("xyzac_switchkins_test_1.ngc") &&
+    state.iniConfigReadiness?.ready === true &&
+    state.profile?.kinematicsModuleId === "xyzac-trt"
+  ), 25000, "run feedback selected program ready");
+  await waitForCanvasReady();
+  await page.evaluate(() => {
+    const state = window.webRtcp5AxisSimulation.getState();
+    if (state.machine?.taskState !== "on") {
+      document.querySelector('[data-action="power"]').click();
+    }
+  });
+  await waitForState((state) => state.machine.taskState === "on", 10000, "machine powered on for run feedback");
+  await page.evaluate(() => document.querySelector('[data-action="mode-manual"]').click());
+  await waitForState((state) => state.machine.mode === "manual", 10000, "manual mode selected for run feedback");
+  await page.evaluate(() => document.querySelector('[data-action="HOME"]').click());
+  await waitForState((state) => state.machine.allHomed === true, 10000, "machine homed for run feedback");
+  await page.evaluate(() => document.querySelector('[data-action="mode-auto"]').click());
+  await waitForState((state) => state.machine.mode === "auto", 10000, "auto mode selected for run feedback");
+  const runFeedbackBaseline = await snapshotRunFeedback(0, "07-run-preconditions-and-feedback-0000ms-before-run");
+  await page.evaluate(() => document.querySelector('[data-action="RUN"]').click());
+  try {
+    await waitForState((state) => (
+      ["running", "complete"].includes(state.runState) &&
+      (state.taskHalStatusLoop?.tickCount > runFeedbackBaseline.state.taskHalStatusLoop.tickCount ||
+        (state.programRuntimeFeedbackHistory?.length || 0) >= 3) &&
+      state.programRuntimeFeedback?.sourceMode === "linuxcnc-task-motion-hal-wasm"
+    ), 15000, "run feedback status loop produced feedback");
+  } catch (error) {
+    const failureSnapshot = await snapshotRunFeedback(15000, "07-run-preconditions-and-feedback-timeout");
+    await fs.writeFile(
+      path.join(OUTPUT_DIR, "run-preconditions-feedback-timeout.json"),
+      `${JSON.stringify({
+        error: error instanceof Error ? error.message : String(error),
+        baseline: runFeedbackBaseline,
+        failureSnapshot,
+        consoleErrors,
+      }, null, 2)}\n`,
+      "utf8",
+    );
+    throw error;
+  }
+  const runFeedbackStartedAt = Date.now();
+  const runFeedbackSamples = [];
+  for (const elapsedMs of [200, 500, 1000, 2000, 5000]) {
+    const waitMs = Math.max(runFeedbackStartedAt + elapsedMs - Date.now(), 0);
+    if (waitMs > 0) await wait(waitMs);
+    await waitForCanvasReady();
+    runFeedbackSamples.push(await snapshotRunFeedback(elapsedMs, `07-run-preconditions-and-feedback-${elapsedMs}ms`));
+  }
+  const runFeedbackCaseChecks = runFeedbackChecks(runFeedbackSamples, runFeedbackBaseline);
+  assertChecks("07-run-preconditions-and-feedback", runFeedbackCaseChecks);
+  const runFeedbackReport = {
+    generatedAt: new Date().toISOString(),
+    targetUrl: report.targetUrl,
+    caseName: "07-run-preconditions-and-feedback",
+    summary: "浏览器 RUN 证据：INI/profile/kinematics/task-HAL 同一上下文，taskHalStatusLoop 持续推进，UI 消费 task/HAL/motion feedback",
+    status: runFeedbackCaseChecks.every((item) => item.pass) ? "PASS" : "FAIL",
+    checks: runFeedbackCaseChecks,
+    baseline: runFeedbackBaseline,
+    samples: runFeedbackSamples,
+    consoleErrors,
+  };
+  await fs.writeFile(
+    path.join(OUTPUT_DIR, "run-preconditions-feedback.json"),
+    `${JSON.stringify(runFeedbackReport, null, 2)}\n`,
+    "utf8",
+  );
+  report.cases.push({
+    name: "07-run-preconditions-and-feedback",
+    summary: runFeedbackReport.summary,
+    status: runFeedbackReport.status,
+    checks: runFeedbackCaseChecks,
+    screenshotDir: RUN_FEEDBACK_SCREENSHOT_DIR,
+    output: path.join(OUTPUT_DIR, "run-preconditions-feedback.json"),
+    sampleCount: runFeedbackSamples.length,
+  });
+
+  report.consoleErrors = consoleErrors;
+  await fs.writeFile(
+    path.join(OUTPUT_DIR, "toolpath-preview-cases.json"),
+    `${JSON.stringify(report, null, 2)}\n`,
+    "utf8",
+  );
+} finally {
+  await page.close().catch(() => {});
+  await browser.close().catch(() => {});
+  await new Promise((resolve) => server.close(resolve));
+}
+
+async function analyzePng(filePath) {
+  const buffer = await fs.readFile(filePath);
+  const png = PNG.sync.read(buffer);
+  const { width, height, data } = png;
+  let luminanceSum = 0;
+  let nonBlack = 0;
+  for (let index = 0; index < data.length; index += 4) {
+    const luminance = data[index] * 0.2126 + data[index + 1] * 0.7152 + data[index + 2] * 0.0722;
+    luminanceSum += luminance;
+    if (luminance > 8) nonBlack += 1;
+  }
+  const total = width * height;
+  return {
+    width,
+    height,
+    averageLuminance: Number((luminanceSum / total).toFixed(2)),
+    nonBlackRatio: Number((nonBlack / total).toFixed(4)),
+  };
+}

qa/web-rtcp-5axis-site-test/capture-working7-manual-flow-evidence.mjs

@@ -0,0 +1,550 @@
+import fs from "node:fs/promises";
+import http from "node:http";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import puppeteer from "puppeteer-core";
+import { PNG } from "pngjs";
+
+const REPO_ROOT = path.resolve("/home/meswork/cnc_wams");
+const QA_ROOT = path.join(REPO_ROOT, "qa/web-rtcp-5axis-site-test");
+const OUTPUT_DIR = path.join(QA_ROOT, "output");
+const EVIDENCE_SCOPE = "working7-manual-flow-evidence";
+const SCREENSHOT_DIR = path.join(OUTPUT_DIR, EVIDENCE_SCOPE);
+const CHROME_PATH = process.env.CHROME_PATH || process.env.CHROMIUM || "/usr/bin/google-chrome";
+const TARGET_URL = process.env.TARGET_URL || "";
+const APP_URL = process.env.APP_URL || "/web-rtcp-5axis-sim-plan/app/index.html";
+const JOB_ID = process.env.JOB_ID || `w7-${new Date().toISOString().replace(/[-:.TZ]/g, "").slice(0, 14)}-${randomUUID().slice(0, 8)}`;
+const REPORT_ID = process.env.REPORT_ID || `report-${JOB_ID}`;
+const REPORT_BASENAME = `${EVIDENCE_SCOPE}-report`;
+
+await fs.mkdir(OUTPUT_DIR, { recursive: true });
+await fs.mkdir(SCREENSHOT_DIR, { recursive: true });
+
+let server = null;
+let targetUrl = TARGET_URL;
+if (!targetUrl) {
+  server = createStaticServer(REPO_ROOT);
+  await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
+  const address = server.address();
+  if (!address || typeof address === "string") throw new Error("failed to start static server");
+  targetUrl = `http://127.0.0.1:${address.port}${APP_URL}`;
+}
+
+const browser = await puppeteer.launch({
+  headless: true,
+  executablePath: CHROME_PATH,
+  defaultViewport: { width: 1500, height: 1050, deviceScaleFactor: 1 },
+  ignoreHTTPSErrors: true,
+  args: [
+    "--ignore-certificate-errors",
+    "--disable-gpu",
+    "--enable-webgl",
+    "--use-angle=swiftshader",
+    "--enable-unsafe-swiftshader",
+    "--no-sandbox",
+  ],
+});
+
+const page = await browser.newPage();
+const consoleErrors = [];
+const pageErrors = [];
+const networkErrors = [];
+page.on("console", (msg) => {
+  if (msg.type() === "error") consoleErrors.push(msg.text());
+});
+page.on("pageerror", (error) => pageErrors.push(error.message));
+page.on("response", (response) => {
+  if (response.status() >= 400) {
+    networkErrors.push(`${response.status()} ${response.url()}`);
+  }
+});
+
+const report = {
+  jobId: JOB_ID,
+  reportId: REPORT_ID,
+  evidenceScope: EVIDENCE_SCOPE,
+  generatedAt: new Date().toISOString(),
+  targetUrl,
+  chromePath: CHROME_PATH,
+  screenshotsDir: SCREENSHOT_DIR,
+  steps: [],
+  checks: [],
+  consoleErrors,
+  pageErrors,
+  networkErrors,
+};
+
+try {
+  await page.goto(targetUrl, { waitUntil: "networkidle2", timeout: 60000 });
+  await page.waitForSelector('[data-shell="gmoccapy-5axis"]', { timeout: 15000 });
+  await page.waitForFunction(() => Boolean(window.webRtcp5AxisSimulation?.getState), { timeout: 15000 });
+  await page.waitForFunction(() => document.querySelector("[data-five-axis-canvas]")?.dataset?.threeReady === "true", { timeout: 20000 });
+  await windowReady();
+  await captureStep("01-loaded", "Main shell loaded", "The gmoccapy shell, canvas, diagnostics, and public store API are ready.");
+
+  await click("power");
+  await waitForState((state) => state.machine.powerOn === true && state.machine.taskState === "on", 10000, "power on");
+  await click("HOME");
+  await waitForState((state) => state.machine.allHomed === true && state.machine.mode === "manual", 10000, "home complete");
+  await captureStep("02-powered-homed-manual", "POWER and HOME", "Machine is powered, homed, and in MANUAL mode.");
+
+  await click("mode-auto");
+  await waitForState((state) => state.machine.mode === "auto" && state.machine.powerOn === true && state.machine.allHomed === true, 10000, "auto mode");
+  await captureStep("03-auto-active", "AUTO mode active", "AUTO mode becomes active while power and home state are preserved.");
+
+  await click("mode-manual");
+  await waitForState((state) => state.machine.mode === "manual" && state.machine.powerOn === true, 10000, "manual mode");
+  const beforeJog = await getState();
+  await click("JOG_X_POS");
+  await waitForState((state) => Number(state.axisPose?.x || 0) > Number(beforeJog.axisPose?.x || 0), 10000, "X+ jog changes position");
+  await captureStep("04-manual-jog-x", "Manual X+ jog", "X+ jog changes the X axis position in MANUAL mode.");
+
+  await click("mode-mdi");
+  await waitForState((state) => state.machine.mode === "mdi", 10000, "mdi mode");
+  await setMdiCommand("G90 X12.5 Y-4 Z1.25 F900");
+  await submitMdiCommand();
+  await waitForState((state) => (
+    state.machine.mode === "mdi" &&
+    /G90 X12\.5 Y-4 Z1\.25 F900/.test(state.machine.mdiCommand || state.operatorMessage || "")
+  ), 10000, "MDI command accepted");
+  await captureStep("05-mdi-command", "MDI command", "MDI accepts a coordinate command and records the staged/executed command state.");
+
+  await click("mode-manual");
+  await waitForState((state) => state.machine.mode === "manual", 10000, "manual before overrides");
+  await click("rapid-override-up");
+  await waitForState((state) => Number(state.feed.rapidOverride) === 110, 8000, "rapid override up");
+  await click("rapid-override-reset");
+  await waitForState((state) => Number(state.feed.rapidOverride) === 100, 8000, "rapid override reset");
+  await click("feed-override-down");
+  await waitForState((state) => Number(state.feed.feedOverride) === 90, 8000, "feed override down");
+  await click("feed-override-reset");
+  await waitForState((state) => Number(state.feed.feedOverride) === 100, 8000, "feed override reset");
+  await click("ignore-limits");
+  await waitForState((state) => state.gmoccapyGui.ignoreLimits === true, 8000, "ignore limits on");
+  await click("block-delete");
+  await waitForState((state) => state.gmoccapyGui.optionalBlocks === true, 8000, "block delete on");
+  await click("optional-stop");
+  await waitForState((state) => state.gmoccapyGui.optionalStop === true, 8000, "optional stop on");
+  await captureStep("06-overrides-hal", "Overrides and HAL inputs", "Rapid/feed overrides reset to 100 and HAL input toggles are active.");
+
+  await click("spindle-forward");
+  await waitForState((state) => state.spindle.enabled === true && state.spindle.direction === "forward", 8000, "spindle forward");
+  await click("spindle-override-up");
+  await waitForState((state) => Number(state.spindle.override) === 110, 8000, "spindle override up");
+  await click("spindle-override-reset");
+  await waitForState((state) => Number(state.spindle.override) === 100, 8000, "spindle override reset");
+  await click("toggle-flood");
+  await waitForState((state) => state.coolant.flood === true, 8000, "flood toggled on");
+  await click("toggle-mist");
+  await waitForState((state) => state.coolant.mist === true, 8000, "mist toggled on");
+  await click("spindle-stop");
+  await waitForState((state) => state.spindle.enabled === false && state.spindle.direction === "stop", 8000, "spindle stop");
+  await captureStep("07-spindle-coolant", "Spindle and coolant", "Spindle, spindle override, flood, and mist controls obey the powered machine gate.");
+
+  const savedSnapshot = await page.evaluate(() => window.webRtcp5AxisSimulation.saveSession({
+    sessionId: "working7-manual-flow",
+    filename: "working7-session.json",
+  }));
+  await waitForState((state) => state.sessionPersistence.status === "saved", 10000, "session saved");
+  await page.select('[data-action="select-profile"]', "gmoccapy-xyzab");
+  await waitForState((state) => state.machineProfile === "gmoccapy-xyzab", 15000, "profile changed before restore");
+  await page.evaluate(() => window.webRtcp5AxisSimulation.restoreSession({
+    sessionId: "working7-manual-flow",
+    filename: "working7-session.json",
+  }));
+  await waitForState((state) => state.sessionPersistence.status === "restored" && state.machineProfile === "xyzac-trt", 15000, "session restored");
+  const restoredSession = await getState();
+  report.sessionEvidence = {
+    savedPath: savedSnapshot.path,
+    savedStorageMode: savedSnapshot.storageMode,
+    restoredPath: restoredSession.sessionPersistence.path,
+    restoredStorageMode: restoredSession.sessionPersistence.storageMode,
+  };
+  await captureStep("08-session-restored", "Save and restore session", "Saved profile and control state are restored after switching to another profile.");
+
+  await captureStep("09-diagnostics", "Diagnostics", "Task policy, INI, Task/HAL, full boundary, gmoccapy communication, and HAL diagnostics are visible.");
+  addChecks();
+  report.status = report.checks.every((check) => check.pass) && pageErrors.length === 0 ? "PASS" : "FAIL";
+
+  const jsonPath = path.join(OUTPUT_DIR, `${REPORT_BASENAME}.json`);
+  const pdfPath = path.join(OUTPUT_DIR, `${REPORT_BASENAME}.pdf`);
+  report.jsonPath = jsonPath;
+  report.pdfPath = pdfPath;
+  await fs.writeFile(jsonPath, `${JSON.stringify(report, null, 2)}\n`, "utf8");
+  await writePdfReport(pdfPath, report);
+
+  console.log(`working7_manual_flow_status=${report.status}`);
+  console.log(`working7_manual_flow_job_id=${report.jobId}`);
+  console.log(`working7_manual_flow_report_id=${report.reportId}`);
+  console.log(`working7_manual_flow_json=${jsonPath}`);
+  console.log(`working7_manual_flow_pdf=${pdfPath}`);
+  console.log(`working7_manual_flow_screenshots=${SCREENSHOT_DIR}`);
+  if (report.status !== "PASS") process.exitCode = 1;
+} finally {
+  await page.close().catch(() => {});
+  await browser.close().catch(() => {});
+  if (server) await new Promise((resolve) => server.close(resolve));
+}
+
+async function windowReady() {
+  await waitForState((state) => (
+    state.kinematicsRuntimeReadiness?.loaded === true &&
+    state.interpreterRuntimeReadiness?.loaded === true &&
+    state.taskHalRuntimeReadiness?.loaded === true &&
+    state.machineFileStaging?.status === "staged"
+  ), 30000, "runtime and machine files ready");
+}
+
+async function captureStep(name, title, description) {
+  const screenshotPath = path.join(SCREENSHOT_DIR, `${name}.png`);
+  await page.screenshot({ path: screenshotPath, fullPage: true });
+  const [state, dom, pixelStats] = await Promise.all([
+    getState(),
+    getDomEvidence(),
+    analyzePng(screenshotPath),
+  ]);
+  const step = {
+    name,
+    title,
+    description,
+    screenshotPath,
+    pixelStats,
+    state: summarizeState(state),
+    dom,
+  };
+  report.steps.push(step);
+  return step;
+}
+
+async function getDomEvidence() {
+  return page.evaluate(() => {
+    const text = (selector) => document.querySelector(selector)?.textContent?.trim() || "";
+    const button = (action) => {
+      const element = document.querySelector(`[data-action="${action}"]`);
+      return {
+        exists: Boolean(element),
+        disabled: Boolean(element?.disabled),
+        active: element?.dataset?.active || null,
+        commandReady: element?.dataset?.commandReady || null,
+        title: element?.getAttribute("title") || "",
+      };
+    };
+    return {
+      regions: window.webRtcp5AxisSimulation.getRegions?.() || null,
+      canvas: { ...(document.querySelector("[data-five-axis-canvas]")?.dataset || {}) },
+      sidebar: {
+        power: button("power"),
+        manual: button("mode-manual"),
+        auto: button("mode-auto"),
+        mdi: button("mode-mdi"),
+      },
+      bottom: {
+        home: button("HOME"),
+        jogXPlus: button("JOG_X_POS"),
+        mdiRun: button("MDI_RUN"),
+      },
+      values: {
+        rapidOverride: text('[data-value="rapid-override"]'),
+        feedOverride: text('[data-value="feed-override"]'),
+        spindleOverride: text('[data-value="spindle-override"]'),
+        halLast: text('[data-value="gmoccapy-hal-last"]'),
+        session: text('[data-session-persistence="status"]'),
+        taskGates: text('[data-linuxcnc-task-policy="gates"]'),
+        taskHal: text('[data-task-hal-runtime="readiness"]'),
+        gmoccapyHal: text('[data-gmoccapy-hal="boundary"]'),
+        operatorMessage: text("[data-operator-message]"),
+      },
+    };
+  });
+}
+
+async function setMdiCommand(command) {
+  await page.$eval('[data-action="mdi-command"]', (input, value) => {
+    input.value = value;
+    input.dispatchEvent(new Event("input", { bubbles: true }));
+    input.dispatchEvent(new Event("change", { bubbles: true }));
+  }, command);
+  await waitForState((state) => state.machine.mdiCommand === command.toUpperCase(), 5000, "MDI input staged");
+}
+
+async function submitMdiCommand() {
+  await page.$eval('[data-action="mdi-form"]', (form) => {
+    form.dispatchEvent(new Event("submit", { bubbles: true, cancelable: true }));
+  });
+}
+
+async function click(action) {
+  await page.evaluate((selector) => {
+    const element = document.querySelector(selector);
+    if (!element) throw new Error(`missing action ${selector}`);
+    element.click();
+  }, `[data-action="${action}"]`);
+}
+
+async function getState() {
+  return page.evaluate(() => JSON.parse(JSON.stringify(window.webRtcp5AxisSimulation.getState())));
+}
+
+async function waitForState(predicate, timeoutMs, label) {
+  const started = Date.now();
+  let lastState = null;
+  while (Date.now() - started < timeoutMs) {
+    lastState = await getState();
+    if (predicate(lastState)) return lastState;
+    await wait(50);
+  }
+  throw new Error(`timeout waiting for ${label}: ${JSON.stringify(summarizeState(lastState || {}))}`);
+}
+
+function addChecks() {
+  const byName = Object.fromEntries(report.steps.map((step) => [step.name, step]));
+  const loaded = byName["01-loaded"]?.state;
+  const manual = byName["02-powered-homed-manual"]?.state;
+  const auto = byName["03-auto-active"]?.state;
+  const jog = byName["04-manual-jog-x"]?.state;
+  const mdi = byName["05-mdi-command"]?.state;
+  const overrides = byName["06-overrides-hal"]?.state;
+  const spindleCoolant = byName["07-spindle-coolant"]?.state;
+  const restored = byName["08-session-restored"]?.state;
+  const diagnostics = byName["09-diagnostics"]?.dom;
+
+  report.checks.push(
+    check("Main shell regions and canvas are ready", Object.values(byName["01-loaded"]?.dom?.regions || {}).every(Boolean) && byName["01-loaded"]?.dom?.canvas?.threeReady === "true", JSON.stringify({ regions: byName["01-loaded"]?.dom?.regions, canvas: byName["01-loaded"]?.dom?.canvas })),
+    check("POWER and HOME leave MANUAL ready", manual?.machine?.powerOn === true && manual?.machine?.allHomed === true && manual?.machine?.mode === "manual", JSON.stringify(manual?.machine)),
+    check("AUTO activates without losing power/home", auto?.machine?.mode === "auto" && auto?.machine?.powerOn === true && auto?.machine?.allHomed === true, JSON.stringify(auto?.machine)),
+    check("Manual jog changes X", Number(jog?.axisPose?.x || 0) > Number(manual?.axisPose?.x || 0), JSON.stringify({ before: manual?.axisPose, after: jog?.axisPose })),
+    check("MDI command is accepted in MDI mode", mdi?.machine?.mode === "mdi" && /G90 X12\.5 Y-4 Z1\.25 F900/.test(`${mdi?.machine?.mdiCommand || ""} ${mdi?.operatorMessage || ""}`), JSON.stringify({ machine: mdi?.machine, operatorMessage: mdi?.operatorMessage })),
+    check("Overrides reset and HAL toggles are active", overrides?.feed?.rapidOverride === 100 && overrides?.feed?.feedOverride === 100 && overrides?.gmoccapyGui?.ignoreLimits === true && overrides?.gmoccapyGui?.optionalBlocks === true && overrides?.gmoccapyGui?.optionalStop === true, JSON.stringify({ feed: overrides?.feed, gmoccapyGui: overrides?.gmoccapyGui })),
+    check("Spindle and coolant controls update state", spindleCoolant?.spindle?.direction === "stop" && spindleCoolant?.spindle?.override === 100 && spindleCoolant?.coolant?.flood === true && spindleCoolant?.coolant?.mist === true, JSON.stringify({ spindle: spindleCoolant?.spindle, coolant: spindleCoolant?.coolant })),
+    check("Session restore returns to saved profile", restored?.machineProfile === "xyzac-trt" && restored?.sessionPersistence?.status === "restored", JSON.stringify({ machineProfile: restored?.machineProfile, sessionPersistence: restored?.sessionPersistence, evidence: report.sessionEvidence })),
+    check("Diagnostics expose Task/HAL and gmoccapy HAL", Boolean(diagnostics?.values?.taskHal) && Boolean(diagnostics?.values?.gmoccapyHal), JSON.stringify(diagnostics?.values)),
+    check("Screenshots are nonblank", report.steps.every((step) => step.pixelStats.nonBlackRatio > 0.1), report.steps.map((step) => `${step.name}:${step.pixelStats.nonBlackRatio}`).join(", ")),
+  );
+}
+
+async function writePdfReport(pdfPath, data) {
+  const reportPage = await browser.newPage();
+  const rows = data.checks.map((item) => `
+    <tr>
+      <td>${escapeHtml(item.name)}</td>
+      <td class="${item.pass ? "pass" : "fail"}">${item.pass ? "PASS" : "FAIL"}</td>
+      <td>${escapeHtml(item.detail)}</td>
+    </tr>
+  `).join("");
+  const steps = data.steps.map((step) => `
+    <section>
+      <h2>${escapeHtml(step.name)} - ${escapeHtml(step.title)}</h2>
+      <p>${escapeHtml(step.description)}</p>
+      <p><strong>Screenshot:</strong> ${escapeHtml(step.screenshotPath)}</p>
+      <p><strong>State:</strong> ${escapeHtml(JSON.stringify({
+        machineProfile: step.state.machineProfile,
+        runState: step.state.runState,
+        machine: step.state.machine,
+        axisPose: step.state.axisPose,
+        feed: step.state.feed,
+        spindle: step.state.spindle,
+        coolant: step.state.coolant,
+        sessionPersistence: step.state.sessionPersistence,
+      }))}</p>
+    </section>
+  `).join("");
+  await reportPage.setContent(`<!doctype html>
+    <html>
+      <head>
+        <meta charset="utf-8" />
+        <style>
+          body { font-family: Arial, sans-serif; margin: 28px; color: #17202a; }
+          h1 { font-size: 22px; margin-bottom: 6px; }
+          h2 { font-size: 16px; margin-top: 18px; }
+          table { border-collapse: collapse; width: 100%; margin-top: 14px; }
+          th, td { border: 1px solid #9aa5b1; padding: 6px; font-size: 11px; vertical-align: top; }
+          th { background: #eef2f7; }
+          .pass { color: #126b37; font-weight: 700; }
+          .fail { color: #a61b1b; font-weight: 700; }
+          .meta { font-size: 12px; line-height: 1.45; }
+          section { break-inside: avoid; border-top: 1px solid #d8dee6; padding-top: 8px; }
+        </style>
+      </head>
+      <body>
+        <h1>working7 Manual Flow Evidence</h1>
+        <div class="meta">
+          <div><strong>Status:</strong> ${escapeHtml(data.status)}</div>
+          <div><strong>Job ID:</strong> ${escapeHtml(data.jobId)}</div>
+          <div><strong>Report ID:</strong> ${escapeHtml(data.reportId)}</div>
+          <div><strong>Target:</strong> ${escapeHtml(data.targetUrl)}</div>
+          <div><strong>Generated:</strong> ${escapeHtml(data.generatedAt)}</div>
+          <div><strong>Screenshots:</strong> ${escapeHtml(data.screenshotsDir)}</div>
+        </div>
+        <h2>Checks</h2>
+        <table>
+          <thead><tr><th>Check</th><th>Status</th><th>Evidence</th></tr></thead>
+          <tbody>${rows}</tbody>
+        </table>
+        <h2>Steps</h2>
+        ${steps}
+      </body>
+    </html>`, { waitUntil: "load" });
+  await reportPage.pdf({
+    path: pdfPath,
+    format: "A4",
+    printBackground: true,
+    margin: { top: "12mm", right: "10mm", bottom: "12mm", left: "10mm" },
+  });
+  await reportPage.close();
+}
+
+function summarizeState(state = {}) {
+  return {
+    machineProfile: state.machineProfile,
+    activeProgram: state.activeProgram,
+    runState: state.runState,
+    activeLine: state.activeLine,
+    machine: {
+      powerOn: state.machine?.powerOn,
+      taskState: state.machine?.taskState,
+      mode: state.machine?.mode,
+      allHomed: state.machine?.allHomed,
+      interpState: state.machine?.interpState,
+      taskPaused: state.machine?.taskPaused,
+      mdiCommand: state.machine?.mdiCommand,
+    },
+    axisPose: pickAxes(state.axisPose),
+    dro: pickAxes(state.dro),
+    feed: {
+      rapidOverride: Number(state.feed?.rapidOverride),
+      feedOverride: Number(state.feed?.feedOverride),
+      feedRate: Number(state.feed?.feedRate),
+      currentVelocity: Number(state.feed?.currentVelocity),
+    },
+    spindle: {
+      enabled: Boolean(state.spindle?.enabled),
+      direction: state.spindle?.direction,
+      override: Number(state.spindle?.override),
+      rpm: Number(state.spindle?.rpm),
+    },
+    coolant: {
+      flood: Boolean(state.coolant?.flood),
+      mist: Boolean(state.coolant?.mist),
+    },
+    gmoccapyGui: {
+      ignoreLimits: Boolean(state.gmoccapyGui?.ignoreLimits),
+      optionalBlocks: Boolean(state.gmoccapyGui?.optionalBlocks),
+      optionalStop: Boolean(state.gmoccapyGui?.optionalStop),
+      lastHalPinEffect: state.gmoccapyGui?.lastHalPinEffect,
+    },
+    mdiHistory: state.mdiHistory || [],
+    sessionPersistence: {
+      status: state.sessionPersistence?.status,
+      storageMode: state.sessionPersistence?.storageMode,
+      path: state.sessionPersistence?.path,
+      savedAt: state.sessionPersistence?.savedAt,
+      restoredAt: state.sessionPersistence?.restoredAt,
+    },
+    machineFileStaging: {
+      status: state.machineFileStaging?.status,
+      fileCount: state.machineFileStaging?.fileCount,
+      selectedGcodeSourceRel: state.machineFileStaging?.selectedGcodeSourceRel,
+    },
+    taskHalRuntimeReadiness: {
+      loaded: Boolean(state.taskHalRuntimeReadiness?.loaded),
+      halSyncReady: Boolean(state.taskHalRuntimeReadiness?.halSyncReady),
+    },
+    operatorMessage: state.operatorMessage,
+  };
+}
+
+function createStaticServer(rootDir) {
+  return http.createServer(async (request, response) => {
+    try {
+      const requestPath = decodeURIComponent(new URL(request.url || "/", "http://127.0.0.1").pathname);
+      const relativePath = requestPath === "/" ? "/index.html" : requestPath;
+      const targetPath = path.resolve(rootDir, `.${relativePath}`);
+      if (!targetPath.startsWith(rootDir)) {
+        response.writeHead(403);
+        response.end("forbidden");
+        return;
+      }
+      let filePath = targetPath;
+      let stat = await fs.stat(filePath).catch(() => null);
+      if (stat?.isDirectory()) {
+        filePath = path.join(filePath, "index.html");
+        stat = await fs.stat(filePath).catch(() => null);
+      }
+      if (!stat?.isFile()) {
+        response.writeHead(404);
+        response.end("not found");
+        return;
+      }
+      const body = await fs.readFile(filePath);
+      response.writeHead(200, {
+        "Content-Type": contentTypeFor(filePath),
+        "Content-Length": String(body.byteLength),
+        "Cache-Control": "no-store",
+      });
+      response.end(body);
+    } catch (error) {
+      response.writeHead(500);
+      response.end(error instanceof Error ? error.message : String(error));
+    }
+  });
+}
+
+function contentTypeFor(filePath) {
+  const ext = path.extname(filePath).toLowerCase();
+  return {
+    ".css": "text/css; charset=utf-8",
+    ".html": "text/html; charset=utf-8",
+    ".js": "text/javascript; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".mjs": "text/javascript; charset=utf-8",
+    ".svg": "image/svg+xml",
+    ".wasm": "application/wasm",
+    ".xml": "application/xml; charset=utf-8",
+  }[ext] || "application/octet-stream";
+}
+
+async function analyzePng(filePath) {
+  const png = PNG.sync.read(await fs.readFile(filePath));
+  let luminanceSum = 0;
+  let nonBlack = 0;
+  for (let index = 0; index < png.data.length; index += 4) {
+    const luminance = png.data[index] * 0.2126 + png.data[index + 1] * 0.7152 + png.data[index + 2] * 0.0722;
+    luminanceSum += luminance;
+    if (luminance > 8) nonBlack += 1;
+  }
+  const total = png.width * png.height;
+  return {
+    width: png.width,
+    height: png.height,
+    averageLuminance: Number((luminanceSum / total).toFixed(2)),
+    nonBlackRatio: Number((nonBlack / total).toFixed(4)),
+  };
+}
+
+function pickAxes(value = {}) {
+  return {
+    x: Number(value?.x || 0),
+    y: Number(value?.y || 0),
+    z: Number(value?.z || 0),
+    a: Number(value?.a || 0),
+    b: Number(value?.b || 0),
+    c: Number(value?.c || 0),
+  };
+}
+
+function check(name, pass, detail) {
+  return { name, pass: Boolean(pass), detail: String(detail ?? "-") };
+}
+
+function escapeHtml(value) {
+  return String(value ?? "")
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&#39;");
+}
+
+function wait(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}

qa/web-rtcp-5axis-site-test/fixtures/test-program.ngc

@@ -0,0 +1,7 @@
+%
+G90 G17 G21
+G0 X0 Y0 Z5
+G1 Z-1 F200
+G1 X10 Y10 F300
+M30
+%

qa/web-rtcp-5axis-site-test/generate-docx-report.mjs

@@ -0,0 +1,260 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import {
+  AlignmentType,
+  Document,
+  HeadingLevel,
+  ImageRun,
+  Packer,
+  Paragraph,
+  Table,
+  TableCell,
+  TableRow,
+  TextRun,
+  WidthType,
+} from "docx";
+
+const ROOT = path.resolve("/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test");
+const OUTPUT_DIR = path.join(ROOT, "output");
+const SCREENSHOT_DIR = path.join(ROOT, "screenshots");
+const reportPath = path.join(OUTPUT_DIR, "site-test-report.json");
+const rawReport = JSON.parse(await fs.readFile(reportPath, "utf8"));
+
+const generated = new Date(rawReport.generatedAt || Date.now());
+const ymd = generated.toISOString().slice(0, 10);
+const docxPath = path.join(OUTPUT_DIR, `web-rtcp-5axis-site-test-report-${ymd}.docx`);
+const counts = countByStatus(rawReport.findings || []);
+const total = rawReport.findings?.length || 0;
+const nonPassFindings = (rawReport.findings || []).filter((finding) => finding.status !== "PASS");
+const screenshotEntries = Object.entries(rawReport.screenshots || {}).sort(([a], [b]) => a.localeCompare(b));
+
+const environmentRows = [
+  ["测试目标", rawReport.targetUrl || "https://82.156.24.101:8092/"],
+  ["测试日期", ymd],
+  ["测试方式", "Google Chrome 真实浏览器自动化测试 + DOM/runtime state 校验 + 截图留证"],
+  ["浏览器执行路径", rawReport.chromePath || "/usr/bin/google-chrome"],
+  ["报告数据", reportPath],
+  ["截图目录", SCREENSHOT_DIR],
+];
+
+const scopeRows = [
+  ["界面结构", "标题栏、预览区、DRO、G-code 区、右侧模式栏、信息区、override、主轴/冷却、底部控制栏"],
+  ["机床/模式", "POWER、E-STOP、RESET、AUTO、MANUAL/JOG、MDI、HOME、JOG"],
+  ["五轴/RTCP", "IDENTITY/TCP、MDI M428/M429、RTCP/kinematics 诊断"],
+  ["程序工作流", "Stage LinuxCNC 源程序、加载 vendored 程序、打开本地 G-code、Run/Pause/Resume/Step/Stop/Reload"],
+  ["操作控制", "Rapid Override、Feed Override、Spindle Override、Flood/Mist、预览视角、全屏"],
+  ["会话与诊断", "Save Session、Restore Session、Audit Full Boundary、Profile 切换"],
+];
+
+const children = [
+  new Paragraph({
+    text: "Web RTCP 5 Axis Simulation 功能测试报告",
+    heading: HeadingLevel.TITLE,
+    alignment: AlignmentType.CENTER,
+  }),
+  centered(`测试对象：${rawReport.targetUrl || "https://82.156.24.101:8092/"}`),
+  centered(`生成时间：${formatDateTime(generated)}`),
+  blank(),
+  heading("1. 结论摘要"),
+  para(`本次共测试 ${total} 个功能点：PASS ${counts.PASS || 0} 项，FAIL ${counts.FAIL || 0} 项，WARN ${counts.WARN || 0} 项。`),
+  para(summaryText(counts)),
+  summaryTable(total, counts),
+  heading("2. 测试环境"),
+  kvTable(environmentRows),
+  heading("3. 测试范围"),
+  kvTable(scopeRows),
+  heading("4. 问题清单"),
+  nonPassFindings.length > 0
+    ? findingTable(nonPassFindings)
+    : para("未发现 FAIL/WARN 项。"),
+  heading("5. 详细测试结果"),
+  resultTable(rawReport.findings || []),
+  heading("6. 截图证据"),
+];
+
+for (const [name, filePath] of screenshotEntries) {
+  children.push(...(await imageBlock(name, filePath)));
+}
+
+children.push(
+  heading("7. 运行日志摘要"),
+  kvTable([
+    ["Console error", String((rawReport.consoleLogs || []).filter((log) => log.type === "error").length)],
+    ["Page error", String((rawReport.pageErrors || []).length)],
+    ["Request failure", String((rawReport.requestFailures || []).length)],
+    ["首屏截图平均亮度", String(rawReport.screenshotAnalysis?.averageLuminance ?? "-")],
+    ["首屏非黑像素比例", String(rawReport.screenshotAnalysis?.nonBlackRatio ?? "-")],
+    ["最终 RTCP 边界", rawReport.finalSummary?.frameBoundary || "-"],
+    ["最终 Task/HAL", rawReport.finalSummary?.taskHal || "-"],
+  ]),
+  heading("8. 原始证据文件"),
+  para(`原始 JSON：${reportPath}`),
+  para(`Word 报告：${docxPath}`),
+);
+
+const doc = new Document({
+  sections: [{ properties: {}, children: children.flat() }],
+});
+
+await fs.writeFile(docxPath, await Packer.toBuffer(doc));
+console.log(`docx_report=${docxPath}`);
+
+function countByStatus(findings) {
+  return findings.reduce((acc, finding) => {
+    acc[finding.status] = (acc[finding.status] || 0) + 1;
+    return acc;
+  }, {});
+}
+
+function summaryText(statusCounts) {
+  if ((statusCounts.FAIL || 0) > 0) {
+    return "主流程可执行，但仍存在需修复的问题；重点集中在预览 ready 诊断、首屏 LinuxCNC kinematics 自动挂接、HOME 后 JOG 坐标连续性、MDI M428 和会话恢复验证。";
+  }
+  if ((statusCounts.WARN || 0) > 0) {
+    return "主流程通过，存在需要后续确认的 WARN 项。";
+  }
+  return "全部测试项通过。";
+}
+
+function heading(text) {
+  return new Paragraph({
+    text,
+    heading: HeadingLevel.HEADING_1,
+    spacing: { before: 240, after: 120 },
+  });
+}
+
+function centered(text) {
+  return new Paragraph({
+    alignment: AlignmentType.CENTER,
+    children: [new TextRun(text)],
+  });
+}
+
+function blank() {
+  return new Paragraph({ text: "" });
+}
+
+function para(text) {
+  return new Paragraph({
+    children: [new TextRun(String(text))],
+    spacing: { after: 100 },
+  });
+}
+
+function summaryTable(summaryTotal, statusCounts) {
+  return new Table({
+    width: { size: 100, type: WidthType.PERCENTAGE },
+    rows: [
+      new TableRow({
+        children: [
+          cell("总项数", true),
+          cell(String(summaryTotal)),
+          cell("PASS", true),
+          cell(String(statusCounts.PASS || 0)),
+          cell("FAIL", true),
+          cell(String(statusCounts.FAIL || 0)),
+          cell("WARN", true),
+          cell(String(statusCounts.WARN || 0)),
+        ],
+      }),
+    ],
+  });
+}
+
+function kvTable(rows) {
+  return new Table({
+    width: { size: 100, type: WidthType.PERCENTAGE },
+    rows: [
+      new TableRow({ children: [cell("项目", true), cell("内容", true)] }),
+      ...rows.map(([key, value]) => new TableRow({ children: [cell(key), cell(value)] })),
+    ],
+  });
+}
+
+function findingTable(findings) {
+  return new Table({
+    width: { size: 100, type: WidthType.PERCENTAGE },
+    rows: [
+      new TableRow({
+        children: [cell("结果", true), cell("功能点", true), cell("实际表现/证据", true), cell("备注", true)],
+      }),
+      ...findings.map((finding) => new TableRow({
+        children: [
+          cell(finding.status),
+          cell(`${finding.key}\n${finding.title}`),
+          cell(finding.actual),
+          cell(finding.detail || finding.expectation || "-"),
+        ],
+      })),
+    ],
+  });
+}
+
+function resultTable(findings) {
+  return new Table({
+    width: { size: 100, type: WidthType.PERCENTAGE },
+    rows: [
+      new TableRow({
+        children: [cell("序号", true), cell("功能点", true), cell("预期", true), cell("实际", true), cell("结果", true)],
+      }),
+      ...findings.map((finding, index) => new TableRow({
+        children: [
+          cell(String(index + 1)),
+          cell(`${finding.key}\n${finding.title}`),
+          cell(finding.expectation),
+          cell(finding.actual),
+          cell(finding.status),
+        ],
+      })),
+    ],
+  });
+}
+
+function cell(text, bold = false) {
+  return new TableCell({
+    width: { size: 25, type: WidthType.PERCENTAGE },
+    children: String(text || "-").split("\n").map((line) => new Paragraph({
+      children: [new TextRun({ text: line, bold })],
+    })),
+  });
+}
+
+async function imageBlock(name, filePath) {
+  const image = await fs.readFile(filePath);
+  return [
+    new Paragraph({
+      text: screenshotTitle(name),
+      heading: HeadingLevel.HEADING_2,
+      spacing: { before: 180, after: 120 },
+    }),
+    new Paragraph({
+      alignment: AlignmentType.CENTER,
+      children: [
+        new ImageRun({
+          data: image,
+          type: "png",
+          transformation: { width: 520, height: 390 },
+        }),
+      ],
+    }),
+    para(`${screenshotTitle(name)}；文件：${filePath}`),
+  ];
+}
+
+function screenshotTitle(name) {
+  const titles = {
+    "01-home": "图 1 首屏界面",
+    "02-profile-xyzbc": "图 2 Profile 切换到 xyzbc-trt",
+    "03-vendored-program-loaded": "图 3 LinuxCNC 五轴源程序加载",
+    "04-run-state": "图 4 程序运行状态",
+    "05-local-program-opened": "图 5 本地 G-code 文件导入",
+    "06-after-audit": "图 6 Audit Full Boundary 后界面",
+    "07-final": "图 7 急停/复位后最终界面",
+  };
+  return titles[name] || name;
+}
+
+function formatDateTime(date) {
+  return date.toISOString().replace("T", " ").replace(/\.\d+Z$/, " UTC");
+}

qa/web-rtcp-5axis-site-test/generate-toolpath-preview-docx-report.mjs

@@ -0,0 +1,252 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import {
+  AlignmentType,
+  Document,
+  HeadingLevel,
+  ImageRun,
+  Packer,
+  Paragraph,
+  Table,
+  TableCell,
+  TableRow,
+  TextRun,
+  WidthType,
+} from "docx";
+
+const ROOT = path.resolve("/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test");
+const OUTPUT_DIR = path.join(ROOT, "output");
+const reportJsonPath = path.join(OUTPUT_DIR, "toolpath-preview-cases.json");
+const report = JSON.parse(await fs.readFile(reportJsonPath, "utf8"));
+const generated = new Date(report.generatedAt || Date.now());
+const ymd = generated.toISOString().slice(0, 10);
+const docxPath = path.join(OUTPUT_DIR, `web-rtcp-5axis-toolpath-preview-report-${ymd}.docx`);
+const counts = report.cases.reduce((acc, testCase) => {
+  acc[testCase.status] = (acc[testCase.status] || 0) + 1;
+  return acc;
+}, {});
+
+const children = [
+  new Paragraph({
+    text: "刀具预览与 G-code 执行刀具轨迹专项测试报告",
+    heading: HeadingLevel.TITLE,
+    alignment: AlignmentType.CENTER,
+  }),
+  centered(`测试对象：${report.targetUrl}`),
+  centered(`项目路径：${report.projectPath || "/home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app/index.html"}`),
+  centered(`生成时间：${formatDateTime(generated)}`),
+  blank(),
+  heading("1. 测试结论"),
+  para(`本次专项覆盖 6 个刀具预览/刀具轨迹场景：PASS ${counts.PASS || 0} 项，FAIL ${counts.FAIL || 0} 项。`),
+  para("已验证首屏预览、矩形 G-code、圆弧 G-code、清空预览、LinuxCNC vendored impeller 长路径、RTCP 运行态执行轨迹。截图中机床参考模型、TCP 球、刀轴线和刀路均有可见性证据。"),
+  para("发现 1 项关键问题：vendored impeller 程序在预览态为 RTCP on，但进入 G-code 运行态后 canvas dataset 中 RTCP 状态变为 off。"),
+  summaryTable(),
+  heading("2. 测试范围与判定口径"),
+  kvTable([
+    ["预览对象", "五轴机床参考模型、工作台、XYZ 坐标轴、旋转轴、刀具/TCP 球、刀轴线"],
+    ["轨迹对象", "G-code canonical motion 预览路径、rapid/feed/arc 分层、已执行轨迹、当前段高亮"],
+    ["运行反馈", "LinuxCNC interpreter WASM、TP/runtime samples、task/HAL runtime feedback"],
+    ["可见性口径", "canvas dataset ready + WebGL renderer + scene objects + pixel luminance/non-black ratio + 截图"],
+    ["语义边界", "可视化层只消费 runtime/canonical motion/task-HAL feedback，不生成 G-code/CNC 语义"],
+  ]),
+  heading("3. 场景结果总表"),
+  caseSummaryTable(report.cases),
+  heading("4. 失败/风险项"),
+  issueTable(report.cases.filter((testCase) => testCase.status !== "PASS")),
+  heading("5. 场景明细与截图"),
+];
+
+for (const testCase of report.cases) {
+  children.push(...(await caseBlock(testCase)));
+}
+
+children.push(
+  heading("6. 原始证据"),
+  kvTable([
+    ["原始 JSON", reportJsonPath],
+    ["截图数量", String(Object.keys(report.screenshots || {}).length)],
+    ["Console error", String((report.consoleErrors || []).length)],
+    ["Chrome", report.chromePath || "-"],
+    ["Word 报告", docxPath],
+    ["项目路径", report.projectPath || "-"],
+  ]),
+);
+
+if ((report.consoleErrors || []).length > 0) {
+  children.push(
+    heading("7. Console 记录"),
+    ...report.consoleErrors.map((entry) => para(entry)),
+  );
+}
+
+const doc = new Document({
+  sections: [{ properties: {}, children: children.flat() }],
+});
+
+await fs.writeFile(docxPath, await Packer.toBuffer(doc));
+console.log(`toolpath_docx_report=${docxPath}`);
+
+function heading(text) {
+  return new Paragraph({
+    text,
+    heading: HeadingLevel.HEADING_1,
+    spacing: { before: 240, after: 120 },
+  });
+}
+
+function centered(text) {
+  return new Paragraph({
+    alignment: AlignmentType.CENTER,
+    children: [new TextRun(String(text))],
+  });
+}
+
+function blank() {
+  return new Paragraph({ text: "" });
+}
+
+function para(text) {
+  return new Paragraph({
+    children: [new TextRun(String(text))],
+    spacing: { after: 100 },
+  });
+}
+
+function summaryTable() {
+  return new Table({
+    width: { size: 100, type: WidthType.PERCENTAGE },
+    rows: [
+      new TableRow({
+        children: [
+          cell("场景总数", true),
+          cell(String(report.cases.length)),
+          cell("PASS", true),
+          cell(String(counts.PASS || 0)),
+          cell("FAIL", true),
+          cell(String(counts.FAIL || 0)),
+        ],
+      }),
+    ],
+  });
+}
+
+function kvTable(rows) {
+  return new Table({
+    width: { size: 100, type: WidthType.PERCENTAGE },
+    rows: [
+      new TableRow({ children: [cell("项目", true), cell("内容", true)] }),
+      ...rows.map(([key, value]) => new TableRow({ children: [cell(key), cell(value)] })),
+    ],
+  });
+}
+
+function caseSummaryTable(cases) {
+  return new Table({
+    width: { size: 100, type: WidthType.PERCENTAGE },
+    rows: [
+      new TableRow({
+        children: [cell("场景", true), cell("结果", true), cell("路径点", true), cell("执行点", true), cell("RTCP", true), cell("可见性", true)],
+      }),
+      ...cases.map((testCase) => new TableRow({
+        children: [
+          cell(`${testCase.name}\n${testCase.summary}`),
+          cell(testCase.status),
+          cell(testCase.dataset.threePathPoints),
+          cell(testCase.dataset.threeExecutedPathPoints),
+          cell(testCase.dataset.threeRtcpState),
+          cell(`luma=${testCase.pixelStats?.averageLuminance ?? "-"}\nnonBlack=${testCase.pixelStats?.nonBlackRatio ?? "-"}`),
+        ],
+      })),
+    ],
+  });
+}
+
+function issueTable(failedCases) {
+  if (failedCases.length === 0) return para("未发现失败场景。");
+  return new Table({
+    width: { size: 100, type: WidthType.PERCENTAGE },
+    rows: [
+      new TableRow({ children: [cell("场景", true), cell("失败检查", true), cell("影响", true), cell("建议", true)] }),
+      ...failedCases.map((testCase) => new TableRow({
+        children: [
+          cell(testCase.name),
+          cell(testCase.checks.filter((item) => !item.pass).map((item) => `${item.name}: ${item.detail}`).join("\n")),
+          cell("G-code 运行态下 RTCP/TCP 轨迹状态与预览态不一致，可能误导操作者判断刀具姿态和 TCP 执行轨迹。"),
+          cell("检查 RUN/task-HAL status 合并逻辑，避免运行反馈将 RTCP/kinesType 从已加载程序的 TCP 状态回退到 identity/off。"),
+        ],
+      })),
+    ],
+  });
+}
+
+async function caseBlock(testCase) {
+  const screenshotPath = report.screenshots[testCase.name];
+  const blocks = [
+    new Paragraph({
+      text: `${testCase.name} - ${testCase.status}`,
+      heading: HeadingLevel.HEADING_2,
+      spacing: { before: 180, after: 120 },
+    }),
+    para(testCase.summary),
+    kvTable([
+      ["activeProgram", testCase.state.activeProgram],
+      ["programSource", testCase.state.programSource],
+      ["programExecutionSourceMode", testCase.state.programExecutionSourceMode],
+      ["runState", testCase.state.runState],
+      ["rtcpState / kinsType", `${testCase.state.rtcpState} / ${testCase.state.kinsType}`],
+      ["motion/sample index", `${testCase.state.programExecutionMotionIndex} / ${testCase.state.programExecutionSampleIndex}`],
+      ["runtime feedback", testCase.state.programRuntimeFeedbackSource || "-"],
+      ["path/executed/rapid/feed/arc", `${testCase.dataset.threePathPoints}/${testCase.dataset.threeExecutedPathPoints}/${testCase.dataset.threeRapidPathPoints}/${testCase.dataset.threeFeedPathPoints}/${testCase.dataset.threeArcPathPoints}`],
+      ["renderer/model", `${testCase.dataset.threeRenderer} / ${testCase.dataset.threeMachineReferenceModel}`],
+      ["pixel stats", `averageLuminance=${testCase.pixelStats?.averageLuminance ?? "-"}, nonBlackRatio=${testCase.pixelStats?.nonBlackRatio ?? "-"}`],
+    ]),
+    new Paragraph({
+      text: "检查项",
+      heading: HeadingLevel.HEADING_3,
+      spacing: { before: 120, after: 80 },
+    }),
+    checksTable(testCase.checks),
+  ];
+  if (screenshotPath) {
+    const image = await fs.readFile(screenshotPath);
+    blocks.push(
+      new Paragraph({
+        alignment: AlignmentType.CENTER,
+        children: [
+          new ImageRun({
+            data: image,
+            type: "png",
+            transformation: { width: 520, height: 390 },
+          }),
+        ],
+      }),
+      para(`截图文件：${screenshotPath}`),
+    );
+  }
+  return blocks;
+}
+
+function checksTable(checks) {
+  return new Table({
+    width: { size: 100, type: WidthType.PERCENTAGE },
+    rows: [
+      new TableRow({ children: [cell("检查", true), cell("结果", true), cell("证据", true)] }),
+      ...checks.map((item) => new TableRow({
+        children: [cell(item.name), cell(item.pass ? "PASS" : "FAIL"), cell(item.detail)],
+      })),
+    ],
+  });
+}
+
+function cell(text, bold = false) {
+  return new TableCell({
+    width: { size: 25, type: WidthType.PERCENTAGE },
+    children: String(text ?? "-").split("\n").map((line) => new Paragraph({
+      children: [new TextRun({ text: line, bold })],
+    })),
+  });
+}
+
+function formatDateTime(date) {
+  return date.toISOString().replace("T", " ").replace(/\.\d+Z$/, " UTC");
+}

qa/web-rtcp-5axis-site-test/output/cloud-run-debug/cloud-run-debug.json

@@ -0,0 +1,776 @@
+{
+  "target": "https://82.156.24.101:8092/",
+  "generatedAt": "2026-06-23T07:25:17.986Z",
+  "summaries": [
+    {
+      "label": "loaded",
+      "runState": "idle",
+      "operatorMessage": "LinuxCNC task/HAL session ready /work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/impeller-7bl-xyzac.ngc",
+      "machine": {
+        "powerOn": false,
+        "estopActive": false,
+        "taskState": "estop-reset",
+        "mode": "manual",
+        "interpState": "idle",
+        "interpResumeState": "idle",
+        "taskPaused": false,
+        "allHomed": false,
+        "noForceHoming": false,
+        "jogAxis": "x",
+        "jogIncrement": 1,
+        "mdiCommand": "G0 X0 Y0 Z0",
+        "mdiDistanceMode": "absolute",
+        "resetCount": 0
+      },
+      "activeProgram": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/impeller-7bl-xyzac.ngc",
+      "selectedGcodeSourceRel": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/impeller-7bl-xyzac.ngc",
+      "taskHalRuntimeReadiness": {
+        "apiName": "web-rtcp-5axis-linuxcnc-task-hal-runtime-readiness",
+        "loaded": true,
+        "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+        "sdkSemanticBoundary": "linuxcnc_task_motion_hal_wasm_phase4_minimal",
+        "executionContext": "direct",
+        "workerUrl": null,
+        "taskRuntimeReady": true,
+        "motionRuntimeReady": true,
+        "halRuntimeReady": true,
+        "halSyncReady": true,
+        "nativeTaskReady": true,
+        "nativeHalSyncReady": true,
+        "hardwareDrive": false,
+        "hostRealtimeKernel": false,
+        "externalUserMProcessReady": false
+      },
+      "taskHalSession": {
+        "profileId": "xyzac-trt",
+        "programPath": "/work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/impeller-7bl-xyzac.ngc",
+        "fileCount": 18
+      },
+      "taskHalStatus": {
+        "taskState": "ESTOP_RESET",
+        "taskMode": "MANUAL",
+        "interpState": "IDLE",
+        "activeLine": 1,
+        "currentVelocity": 0,
+        "taskCycle": 0
+      },
+      "programRuntimeFeedback": {
+        "apiName": "web-rtcp-5axis-program-runtime-feedback",
+        "sourceMode": "linuxcnc-canonical-motion",
+        "semanticBoundary": "linuxcnc_canonical_motion_feedback_without_tp_sample",
+        "sampleIndex": 0,
+        "motionIndex": 0,
+        "line": 8,
+        "type": "STRAIGHT_TRAVERSE",
+        "linearUnits": "mm",
+        "timeSeconds": 0,
+        "axisPose": {
+          "x": 16.339,
+          "y": -25.409,
+          "z": 33.353,
+          "a": -71.841,
+          "b": 0,
+          "c": -35.93
+        },
+        "currentVelocityMmPerMin": 2100,
+        "requestedVelocityMmPerMin": 2100,
+        "distanceToGo": 0,
+        "dtg": {
+          "x": 0,
+          "y": 0,
+          "z": 0
+        },
+        "queueDepth": 0,
+        "activeDepth": 0,
+        "cycle": 0
+      },
+      "programRuntimeFeedbackHistoryLength": 1,
+      "taskHalStatusLoop": {
+        "apiName": "web-rtcp-5axis-task-hal-status-loop",
+        "active": false,
+        "sequence": 0,
+        "profileId": null,
+        "iniPath": null,
+        "kinematicsModuleId": null,
+        "tickCount": 0,
+        "batchSize": 5,
+        "intervalMs": 25,
+        "taskPeriodNs": 10000000,
+        "servoPeriodNs": 1000000,
+        "lastStatusAt": null,
+        "lastError": null,
+        "stopReason": null,
+        "semanticBoundary": "js_status_polling_loop_for_linuxcnc_task_hal_motion_status"
+      },
+      "runGate": null
+    },
+    {
+      "label": "after-direct-run",
+      "runState": "idle",
+      "operatorMessage": "LinuxCNC task/HAL session ready /work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/impeller-7bl-xyzac.ngc",
+      "machine": {
+        "powerOn": false,
+        "estopActive": false,
+        "taskState": "estop-reset",
+        "mode": "manual",
+        "interpState": "idle",
+        "interpResumeState": "idle",
+        "taskPaused": false,
+        "allHomed": false,
+        "noForceHoming": false,
+        "jogAxis": "x",
+        "jogIncrement": 1,
+        "mdiCommand": "G0 X0 Y0 Z0",
+        "mdiDistanceMode": "absolute",
+        "resetCount": 0
+      },
+      "activeProgram": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/impeller-7bl-xyzac.ngc",
+      "selectedGcodeSourceRel": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/impeller-7bl-xyzac.ngc",
+      "taskHalRuntimeReadiness": {
+        "apiName": "web-rtcp-5axis-linuxcnc-task-hal-runtime-readiness",
+        "loaded": true,
+        "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+        "sdkSemanticBoundary": "linuxcnc_task_motion_hal_wasm_phase4_minimal",
+        "executionContext": "direct",
+        "workerUrl": null,
+        "taskRuntimeReady": true,
+        "motionRuntimeReady": true,
+        "halRuntimeReady": true,
+        "halSyncReady": true,
+        "nativeTaskReady": true,
+        "nativeHalSyncReady": true,
+        "hardwareDrive": false,
+        "hostRealtimeKernel": false,
+        "externalUserMProcessReady": false
+      },
+      "taskHalSession": {
+        "profileId": "xyzac-trt",
+        "programPath": "/work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/impeller-7bl-xyzac.ngc",
+        "fileCount": 18
+      },
+      "taskHalStatus": {
+        "taskState": "ESTOP_RESET",
+        "taskMode": "MANUAL",
+        "interpState": "IDLE",
+        "activeLine": 1,
+        "currentVelocity": 0,
+        "taskCycle": 0
+      },
+      "programRuntimeFeedback": {
+        "apiName": "web-rtcp-5axis-program-runtime-feedback",
+        "sourceMode": "linuxcnc-canonical-motion",
+        "semanticBoundary": "linuxcnc_canonical_motion_feedback_without_tp_sample",
+        "sampleIndex": 0,
+        "motionIndex": 0,
+        "line": 8,
+        "type": "STRAIGHT_TRAVERSE",
+        "linearUnits": "mm",
+        "timeSeconds": 0,
+        "axisPose": {
+          "x": 16.339,
+          "y": -25.409,
+          "z": 33.353,
+          "a": -71.841,
+          "b": 0,
+          "c": -35.93
+        },
+        "currentVelocityMmPerMin": 2100,
+        "requestedVelocityMmPerMin": 2100,
+        "distanceToGo": 0,
+        "dtg": {
+          "x": 0,
+          "y": 0,
+          "z": 0
+        },
+        "queueDepth": 0,
+        "activeDepth": 0,
+        "cycle": 0
+      },
+      "programRuntimeFeedbackHistoryLength": 1,
+      "taskHalStatusLoop": {
+        "apiName": "web-rtcp-5axis-task-hal-status-loop",
+        "active": false,
+        "sequence": 0,
+        "profileId": null,
+        "iniPath": null,
+        "kinematicsModuleId": null,
+        "tickCount": 0,
+        "batchSize": 5,
+        "intervalMs": 25,
+        "taskPeriodNs": 10000000,
+        "servoPeriodNs": 1000000,
+        "lastStatusAt": null,
+        "lastError": null,
+        "stopReason": null,
+        "semanticBoundary": "js_status_polling_loop_for_linuxcnc_task_hal_motion_status"
+      },
+      "runGate": null
+    },
+    {
+      "label": "after-run-ready",
+      "runState": "idle",
+      "operatorMessage": "RUN ready: power on, homed, auto mode",
+      "machine": {
+        "powerOn": true,
+        "estopActive": false,
+        "taskState": "on",
+        "mode": "auto",
+        "interpState": "idle",
+        "interpResumeState": "idle",
+        "taskPaused": false,
+        "allHomed": false,
+        "noForceHoming": false,
+        "jogAxis": "x",
+        "jogIncrement": 1,
+        "mdiCommand": "G0 X0 Y0 Z0",
+        "mdiDistanceMode": "absolute",
+        "resetCount": 0
+      },
+      "activeProgram": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/impeller-7bl-xyzac.ngc",
+      "selectedGcodeSourceRel": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/impeller-7bl-xyzac.ngc",
+      "taskHalRuntimeReadiness": {
+        "apiName": "web-rtcp-5axis-linuxcnc-task-hal-runtime-readiness",
+        "loaded": true,
+        "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+        "sdkSemanticBoundary": "linuxcnc_task_motion_hal_wasm_phase4_minimal",
+        "executionContext": "direct",
+        "workerUrl": null,
+        "taskRuntimeReady": true,
+        "motionRuntimeReady": true,
+        "halRuntimeReady": true,
+        "halSyncReady": true,
+        "nativeTaskReady": true,
+        "nativeHalSyncReady": true,
+        "hardwareDrive": false,
+        "hostRealtimeKernel": false,
+        "externalUserMProcessReady": false
+      },
+      "taskHalSession": {
+        "profileId": "xyzac-trt",
+        "programPath": "/work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/impeller-7bl-xyzac.ngc",
+        "fileCount": 18
+      },
+      "taskHalStatus": {
+        "taskState": "ON",
+        "taskMode": "AUTO",
+        "interpState": "IDLE",
+        "activeLine": 1,
+        "currentVelocity": 3600,
+        "taskCycle": 0
+      },
+      "programRuntimeFeedback": {
+        "apiName": "web-rtcp-5axis-program-runtime-feedback",
+        "sourceMode": "linuxcnc-task-motion-hal-wasm",
+        "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+        "sampleIndex": 40,
+        "motionIndex": 0,
+        "line": 1,
+        "motionProgramLine": 1,
+        "halProgramLine": 1,
+        "activeLineSource": "motion-status",
+        "activeLineHalSynced": true,
+        "type": "TASK_MOTION",
+        "timeSeconds": 0,
+        "axisPose": {
+          "x": 0,
+          "y": 0,
+          "z": 0,
+          "a": 0,
+          "b": 0,
+          "c": 0
+        },
+        "currentVelocityMmPerMin": 3600,
+        "requestedVelocityMmPerMin": 3600,
+        "distanceToGo": 0,
+        "dtg": {
+          "x": 0,
+          "y": 0,
+          "z": 0
+        },
+        "queueDepth": 0,
+        "activeDepth": 0,
+        "cycle": 40,
+        "taskCycle": 4,
+        "halChangedPinCount": 0
+      },
+      "programRuntimeFeedbackHistoryLength": 3,
+      "taskHalStatusLoop": {
+        "apiName": "web-rtcp-5axis-task-hal-status-loop",
+        "active": false,
+        "sequence": 0,
+        "profileId": null,
+        "iniPath": null,
+        "kinematicsModuleId": null,
+        "tickCount": 0,
+        "batchSize": 5,
+        "intervalMs": 25,
+        "taskPeriodNs": 10000000,
+        "servoPeriodNs": 1000000,
+        "lastStatusAt": null,
+        "lastError": null,
+        "stopReason": null,
+        "semanticBoundary": "js_status_polling_loop_for_linuxcnc_task_hal_motion_status"
+      },
+      "runGate": null
+    },
+    {
+      "label": "run-0500",
+      "runState": "idle",
+      "operatorMessage": "RUN ready: power on, homed, auto mode",
+      "machine": {
+        "powerOn": true,
+        "estopActive": false,
+        "taskState": "on",
+        "mode": "auto",
+        "interpState": "idle",
+        "interpResumeState": "idle",
+        "taskPaused": false,
+        "allHomed": false,
+        "noForceHoming": false,
+        "jogAxis": "x",
+        "jogIncrement": 1,
+        "mdiCommand": "G0 X0 Y0 Z0",
+        "mdiDistanceMode": "absolute",
+        "resetCount": 0
+      },
+      "activeProgram": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/impeller-7bl-xyzac.ngc",
+      "selectedGcodeSourceRel": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/impeller-7bl-xyzac.ngc",
+      "taskHalRuntimeReadiness": {
+        "apiName": "web-rtcp-5axis-linuxcnc-task-hal-runtime-readiness",
+        "loaded": true,
+        "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+        "sdkSemanticBoundary": "linuxcnc_task_motion_hal_wasm_phase4_minimal",
+        "executionContext": "direct",
+        "workerUrl": null,
+        "taskRuntimeReady": true,
+        "motionRuntimeReady": true,
+        "halRuntimeReady": true,
+        "halSyncReady": true,
+        "nativeTaskReady": true,
+        "nativeHalSyncReady": true,
+        "hardwareDrive": false,
+        "hostRealtimeKernel": false,
+        "externalUserMProcessReady": false
+      },
+      "taskHalSession": {
+        "profileId": "xyzac-trt",
+        "programPath": "/work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/impeller-7bl-xyzac.ngc",
+        "fileCount": 18
+      },
+      "taskHalStatus": {
+        "taskState": "ON",
+        "taskMode": "AUTO",
+        "interpState": "IDLE",
+        "activeLine": 1,
+        "currentVelocity": 3600,
+        "taskCycle": 0
+      },
+      "programRuntimeFeedback": {
+        "apiName": "web-rtcp-5axis-program-runtime-feedback",
+        "sourceMode": "linuxcnc-task-motion-hal-wasm",
+        "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+        "sampleIndex": 40,
+        "motionIndex": 0,
+        "line": 1,
+        "motionProgramLine": 1,
+        "halProgramLine": 1,
+        "activeLineSource": "motion-status",
+        "activeLineHalSynced": true,
+        "type": "TASK_MOTION",
+        "timeSeconds": 0,
+        "axisPose": {
+          "x": 0,
+          "y": 0,
+          "z": 0,
+          "a": 0,
+          "b": 0,
+          "c": 0
+        },
+        "currentVelocityMmPerMin": 3600,
+        "requestedVelocityMmPerMin": 3600,
+        "distanceToGo": 0,
+        "dtg": {
+          "x": 0,
+          "y": 0,
+          "z": 0
+        },
+        "queueDepth": 0,
+        "activeDepth": 0,
+        "cycle": 40,
+        "taskCycle": 4,
+        "halChangedPinCount": 0
+      },
+      "programRuntimeFeedbackHistoryLength": 3,
+      "taskHalStatusLoop": {
+        "apiName": "web-rtcp-5axis-task-hal-status-loop",
+        "active": false,
+        "sequence": 0,
+        "profileId": null,
+        "iniPath": null,
+        "kinematicsModuleId": null,
+        "tickCount": 0,
+        "batchSize": 5,
+        "intervalMs": 25,
+        "taskPeriodNs": 10000000,
+        "servoPeriodNs": 1000000,
+        "lastStatusAt": null,
+        "lastError": null,
+        "stopReason": null,
+        "semanticBoundary": "js_status_polling_loop_for_linuxcnc_task_hal_motion_status"
+      },
+      "runGate": null
+    },
+    {
+      "label": "run-2500",
+      "runState": "idle",
+      "operatorMessage": "RUN ready: power on, homed, auto mode",
+      "machine": {
+        "powerOn": true,
+        "estopActive": false,
+        "taskState": "on",
+        "mode": "auto",
+        "interpState": "idle",
+        "interpResumeState": "idle",
+        "taskPaused": false,
+        "allHomed": false,
+        "noForceHoming": false,
+        "jogAxis": "x",
+        "jogIncrement": 1,
+        "mdiCommand": "G0 X0 Y0 Z0",
+        "mdiDistanceMode": "absolute",
+        "resetCount": 0
+      },
+      "activeProgram": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/impeller-7bl-xyzac.ngc",
+      "selectedGcodeSourceRel": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/impeller-7bl-xyzac.ngc",
+      "taskHalRuntimeReadiness": {
+        "apiName": "web-rtcp-5axis-linuxcnc-task-hal-runtime-readiness",
+        "loaded": true,
+        "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+        "sdkSemanticBoundary": "linuxcnc_task_motion_hal_wasm_phase4_minimal",
+        "executionContext": "direct",
+        "workerUrl": null,
+        "taskRuntimeReady": true,
+        "motionRuntimeReady": true,
+        "halRuntimeReady": true,
+        "halSyncReady": true,
+        "nativeTaskReady": true,
+        "nativeHalSyncReady": true,
+        "hardwareDrive": false,
+        "hostRealtimeKernel": false,
+        "externalUserMProcessReady": false
+      },
+      "taskHalSession": {
+        "profileId": "xyzac-trt",
+        "programPath": "/work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/impeller-7bl-xyzac.ngc",
+        "fileCount": 18
+      },
+      "taskHalStatus": {
+        "taskState": "ON",
+        "taskMode": "AUTO",
+        "interpState": "IDLE",
+        "activeLine": 1,
+        "currentVelocity": 3600,
+        "taskCycle": 0
+      },
+      "programRuntimeFeedback": {
+        "apiName": "web-rtcp-5axis-program-runtime-feedback",
+        "sourceMode": "linuxcnc-task-motion-hal-wasm",
+        "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+        "sampleIndex": 40,
+        "motionIndex": 0,
+        "line": 1,
+        "motionProgramLine": 1,
+        "halProgramLine": 1,
+        "activeLineSource": "motion-status",
+        "activeLineHalSynced": true,
+        "type": "TASK_MOTION",
+        "timeSeconds": 0,
+        "axisPose": {
+          "x": 0,
+          "y": 0,
+          "z": 0,
+          "a": 0,
+          "b": 0,
+          "c": 0
+        },
+        "currentVelocityMmPerMin": 3600,
+        "requestedVelocityMmPerMin": 3600,
+        "distanceToGo": 0,
+        "dtg": {
+          "x": 0,
+          "y": 0,
+          "z": 0
+        },
+        "queueDepth": 0,
+        "activeDepth": 0,
+        "cycle": 40,
+        "taskCycle": 4,
+        "halChangedPinCount": 0
+      },
+      "programRuntimeFeedbackHistoryLength": 3,
+      "taskHalStatusLoop": {
+        "apiName": "web-rtcp-5axis-task-hal-status-loop",
+        "active": false,
+        "sequence": 0,
+        "profileId": null,
+        "iniPath": null,
+        "kinematicsModuleId": null,
+        "tickCount": 0,
+        "batchSize": 5,
+        "intervalMs": 25,
+        "taskPeriodNs": 10000000,
+        "servoPeriodNs": 1000000,
+        "lastStatusAt": null,
+        "lastError": null,
+        "stopReason": null,
+        "semanticBoundary": "js_status_polling_loop_for_linuxcnc_task_hal_motion_status"
+      },
+      "runGate": null
+    },
+    {
+      "label": "run-6500",
+      "runState": "idle",
+      "operatorMessage": "RUN ready: power on, homed, auto mode",
+      "machine": {
+        "powerOn": true,
+        "estopActive": false,
+        "taskState": "on",
+        "mode": "auto",
+        "interpState": "idle",
+        "interpResumeState": "idle",
+        "taskPaused": false,
+        "allHomed": false,
+        "noForceHoming": false,
+        "jogAxis": "x",
+        "jogIncrement": 1,
+        "mdiCommand": "G0 X0 Y0 Z0",
+        "mdiDistanceMode": "absolute",
+        "resetCount": 0
+      },
+      "activeProgram": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/impeller-7bl-xyzac.ngc",
+      "selectedGcodeSourceRel": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/impeller-7bl-xyzac.ngc",
+      "taskHalRuntimeReadiness": {
+        "apiName": "web-rtcp-5axis-linuxcnc-task-hal-runtime-readiness",
+        "loaded": true,
+        "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+        "sdkSemanticBoundary": "linuxcnc_task_motion_hal_wasm_phase4_minimal",
+        "executionContext": "direct",
+        "workerUrl": null,
+        "taskRuntimeReady": true,
+        "motionRuntimeReady": true,
+        "halRuntimeReady": true,
+        "halSyncReady": true,
+        "nativeTaskReady": true,
+        "nativeHalSyncReady": true,
+        "hardwareDrive": false,
+        "hostRealtimeKernel": false,
+        "externalUserMProcessReady": false
+      },
+      "taskHalSession": {
+        "profileId": "xyzac-trt",
+        "programPath": "/work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/impeller-7bl-xyzac.ngc",
+        "fileCount": 18
+      },
+      "taskHalStatus": {
+        "taskState": "ON",
+        "taskMode": "AUTO",
+        "interpState": "IDLE",
+        "activeLine": 1,
+        "currentVelocity": 3600,
+        "taskCycle": 0
+      },
+      "programRuntimeFeedback": {
+        "apiName": "web-rtcp-5axis-program-runtime-feedback",
+        "sourceMode": "linuxcnc-task-motion-hal-wasm",
+        "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+        "sampleIndex": 40,
+        "motionIndex": 0,
+        "line": 1,
+        "motionProgramLine": 1,
+        "halProgramLine": 1,
+        "activeLineSource": "motion-status",
+        "activeLineHalSynced": true,
+        "type": "TASK_MOTION",
+        "timeSeconds": 0,
+        "axisPose": {
+          "x": 0,
+          "y": 0,
+          "z": 0,
+          "a": 0,
+          "b": 0,
+          "c": 0
+        },
+        "currentVelocityMmPerMin": 3600,
+        "requestedVelocityMmPerMin": 3600,
+        "distanceToGo": 0,
+        "dtg": {
+          "x": 0,
+          "y": 0,
+          "z": 0
+        },
+        "queueDepth": 0,
+        "activeDepth": 0,
+        "cycle": 40,
+        "taskCycle": 4,
+        "halChangedPinCount": 0
+      },
+      "programRuntimeFeedbackHistoryLength": 3,
+      "taskHalStatusLoop": {
+        "apiName": "web-rtcp-5axis-task-hal-status-loop",
+        "active": false,
+        "sequence": 0,
+        "profileId": null,
+        "iniPath": null,
+        "kinematicsModuleId": null,
+        "tickCount": 0,
+        "batchSize": 5,
+        "intervalMs": 25,
+        "taskPeriodNs": 10000000,
+        "servoPeriodNs": 1000000,
+        "lastStatusAt": null,
+        "lastError": null,
+        "stopReason": null,
+        "semanticBoundary": "js_status_polling_loop_for_linuxcnc_task_hal_motion_status"
+      },
+      "runGate": null
+    },
+    {
+      "label": "after-stop",
+      "runState": "stopped",
+      "operatorMessage": "task/HAL program stopped",
+      "machine": {
+        "powerOn": true,
+        "estopActive": false,
+        "taskState": "on",
+        "mode": "auto",
+        "interpState": "idle",
+        "interpResumeState": "idle",
+        "taskPaused": false,
+        "allHomed": false,
+        "noForceHoming": false,
+        "jogAxis": "x",
+        "jogIncrement": 1,
+        "mdiCommand": "G0 X0 Y0 Z0",
+        "mdiDistanceMode": "absolute",
+        "resetCount": 0
+      },
+      "activeProgram": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/impeller-7bl-xyzac.ngc",
+      "selectedGcodeSourceRel": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/impeller-7bl-xyzac.ngc",
+      "taskHalRuntimeReadiness": {
+        "apiName": "web-rtcp-5axis-linuxcnc-task-hal-runtime-readiness",
+        "loaded": true,
+        "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+        "sdkSemanticBoundary": "linuxcnc_task_motion_hal_wasm_phase4_minimal",
+        "executionContext": "direct",
+        "workerUrl": null,
+        "taskRuntimeReady": true,
+        "motionRuntimeReady": true,
+        "halRuntimeReady": true,
+        "halSyncReady": true,
+        "nativeTaskReady": true,
+        "nativeHalSyncReady": true,
+        "hardwareDrive": false,
+        "hostRealtimeKernel": false,
+        "externalUserMProcessReady": false
+      },
+      "taskHalSession": {
+        "profileId": "xyzac-trt",
+        "programPath": "/work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/impeller-7bl-xyzac.ngc",
+        "fileCount": 18
+      },
+      "taskHalStatus": {
+        "taskState": "ON",
+        "taskMode": "AUTO",
+        "interpState": "IDLE",
+        "activeLine": 1,
+        "currentVelocity": 3600,
+        "taskCycle": 0
+      },
+      "programRuntimeFeedback": {
+        "apiName": "web-rtcp-5axis-program-runtime-feedback",
+        "sourceMode": "linuxcnc-task-motion-hal-wasm",
+        "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+        "sampleIndex": 50,
+        "motionIndex": 0,
+        "line": 1,
+        "motionProgramLine": 1,
+        "halProgramLine": 1,
+        "activeLineSource": "motion-status",
+        "activeLineHalSynced": true,
+        "type": "TASK_MOTION",
+        "timeSeconds": 0,
+        "axisPose": {
+          "x": 0,
+          "y": 0,
+          "z": 0,
+          "a": 0,
+          "b": 0,
+          "c": 0
+        },
+        "currentVelocityMmPerMin": 3600,
+        "requestedVelocityMmPerMin": 3600,
+        "distanceToGo": 0,
+        "dtg": {
+          "x": 0,
+          "y": 0,
+          "z": 0
+        },
+        "queueDepth": 0,
+        "activeDepth": 0,
+        "cycle": 50,
+        "taskCycle": 5,
+        "halChangedPinCount": 0
+      },
+      "programRuntimeFeedbackHistoryLength": 4,
+      "taskHalStatusLoop": {
+        "apiName": "web-rtcp-5axis-task-hal-status-loop",
+        "active": false,
+        "sequence": 0,
+        "profileId": null,
+        "iniPath": null,
+        "kinematicsModuleId": null,
+        "tickCount": 0,
+        "batchSize": 5,
+        "intervalMs": 25,
+        "taskPeriodNs": 10000000,
+        "servoPeriodNs": 1000000,
+        "lastStatusAt": null,
+        "lastError": null,
+        "stopReason": "stopped",
+        "semanticBoundary": "js_status_polling_loop_for_linuxcnc_task_hal_motion_status"
+      },
+      "runGate": null
+    }
+  ],
+  "consoleLogs": [
+    {
+      "type": "warn",
+      "text": "[.WebGL-0x369c000f8800]GL Driver Message (OpenGL, Performance, GL_CLOSE_PATH_NV, High): GPU stall due to ReadPixels",
+      "location": {
+        "url": "https://82.156.24.101:8092/"
+      }
+    },
+    {
+      "type": "warn",
+      "text": "[.WebGL-0x369c000f8800]GL Driver Message (OpenGL, Performance, GL_CLOSE_PATH_NV, High): GPU stall due to ReadPixels",
+      "location": {
+        "url": "https://82.156.24.101:8092/"
+      }
+    },
+    {
+      "type": "warn",
+      "text": "[.WebGL-0x369c000f8800]GL Driver Message (OpenGL, Performance, GL_CLOSE_PATH_NV, High): GPU stall due to ReadPixels",
+      "location": {
+        "url": "https://82.156.24.101:8092/"
+      }
+    },
+    {
+      "type": "warn",
+      "text": "[.WebGL-0x369c000f8800]GL Driver Message (OpenGL, Performance, GL_CLOSE_PATH_NV, High): GPU stall due to ReadPixels (this message will no longer repeat)",
+      "location": {
+        "url": "https://82.156.24.101:8092/"
+      }
+    }
+  ],
+  "pageErrors": []
+}

qa/web-rtcp-5axis-site-test/output/cloud-run-ready-after.json

@@ -0,0 +1,285 @@
+{
+  "generatedAt": "2026-06-23T07:35:25.253Z",
+  "before": {
+    "runState": "idle",
+    "machine": {
+      "powerOn": false,
+      "estopActive": false,
+      "taskState": "estop-reset",
+      "mode": "manual",
+      "interpState": "idle",
+      "interpResumeState": "idle",
+      "taskPaused": false,
+      "allHomed": false,
+      "noForceHoming": false,
+      "jogAxis": "x",
+      "jogIncrement": 1,
+      "mdiCommand": "G0 X0 Y0 Z0",
+      "mdiDistanceMode": "absolute",
+      "resetCount": 0
+    },
+    "rtcpState": "on",
+    "kinsType": "tcp-xyzac",
+    "operatorMessage": "LinuxCNC task/HAL session ready /work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/boat-xyzac.ngc",
+    "taskHalExecutionPending": false,
+    "taskHalFallbackReason": null,
+    "taskHalStatus": {
+      "ui": {
+        "taskState": "estop_reset",
+        "taskMode": "manual",
+        "interpState": "idle",
+        "execState": "done",
+        "taskCycle": 0,
+        "servoCycle": 20,
+        "motionQueueDepth": 0,
+        "halChangedPinCount": 0,
+        "activeLine": 1,
+        "motionProgramLine": 0,
+        "halProgramLine": 0,
+        "activeLineSource": "fallback",
+        "activeLineHalSynced": false,
+        "switchkinsType": 0,
+        "axisPose": {
+          "x": 0,
+          "y": 0,
+          "z": 0,
+          "a": 0,
+          "b": 0,
+          "c": 0
+        },
+        "axisPoseFrame": "work",
+        "currentVelocity": 0
+      },
+      "task": {
+        "state": "ESTOP_RESET",
+        "mode": "MANUAL",
+        "interpState": "IDLE",
+        "execState": "DONE",
+        "cycle": 2,
+        "openProgram": "/work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/boat-xyzac.ngc",
+        "openedLineCount": 1881,
+        "openedSourceLineCount": 1881,
+        "executableLineCount": 1859,
+        "nextProgramLine": 0
+      },
+      "summary": {
+        "taskRuntimeReady": true,
+        "motionRuntimeReady": true,
+        "halRuntimeReady": true,
+        "halSyncReady": true,
+        "taskHalComparisonReady": true,
+        "switchkinsRemapHalSync": true,
+        "nativeTaskReady": true,
+        "nativeHalSyncReady": true,
+        "fullLinuxCncProgramExecutionReady": false,
+        "hardwareDrive": false,
+        "hostRealtimeKernel": false
+      }
+    },
+    "taskHalStatusLoop": {
+      "apiName": "web-rtcp-5axis-task-hal-status-loop",
+      "active": false,
+      "sequence": 0,
+      "profileId": null,
+      "iniPath": null,
+      "kinematicsModuleId": null,
+      "tickCount": 0,
+      "batchSize": 5,
+      "intervalMs": 25,
+      "taskPeriodNs": 10000000,
+      "servoPeriodNs": 1000000,
+      "lastStatusAt": null,
+      "lastError": null,
+      "stopReason": null,
+      "semanticBoundary": "js_status_polling_loop_for_linuxcnc_task_hal_motion_status"
+    },
+    "programRuntimeFeedback": {
+      "apiName": "web-rtcp-5axis-program-runtime-feedback",
+      "sourceMode": "linuxcnc-task-motion-hal-wasm",
+      "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+      "sampleIndex": 20,
+      "motionIndex": 0,
+      "line": 1,
+      "motionProgramLine": 0,
+      "halProgramLine": 0,
+      "activeLineSource": "fallback",
+      "activeLineHalSynced": false,
+      "type": "TASK_MOTION",
+      "timeSeconds": 0,
+      "axisPose": {
+        "x": 0,
+        "y": 0,
+        "z": 0,
+        "a": 0,
+        "b": 0,
+        "c": 0
+      },
+      "currentVelocityMmPerMin": 0,
+      "requestedVelocityMmPerMin": 0,
+      "distanceToGo": 0,
+      "dtg": {
+        "x": 0,
+        "y": 0,
+        "z": 0
+      },
+      "queueDepth": 0,
+      "activeDepth": 0,
+      "cycle": 20,
+      "taskCycle": 2,
+      "halChangedPinCount": 0
+    },
+    "selected": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/boat-xyzac.ngc",
+    "taskHalSessionProgram": "/work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/boat-xyzac.ngc",
+    "preconditions": null
+  },
+  "after": {
+    "runState": "idle",
+    "machine": {
+      "powerOn": true,
+      "estopActive": false,
+      "taskState": "on",
+      "mode": "auto",
+      "interpState": "idle",
+      "interpResumeState": "idle",
+      "taskPaused": false,
+      "allHomed": false,
+      "noForceHoming": false,
+      "jogAxis": "x",
+      "jogIncrement": 1,
+      "mdiCommand": "G0 X0 Y0 Z0",
+      "mdiDistanceMode": "absolute",
+      "resetCount": 0
+    },
+    "rtcpState": "on",
+    "kinsType": "tcp-xyzac",
+    "operatorMessage": "RUN ready: power on, homed, auto mode",
+    "taskHalExecutionPending": false,
+    "taskHalFallbackReason": null,
+    "taskHalStatus": {
+      "ui": {
+        "taskState": "on",
+        "taskMode": "auto",
+        "interpState": "idle",
+        "execState": "done",
+        "taskCycle": 0,
+        "servoCycle": 40,
+        "motionQueueDepth": 0,
+        "halChangedPinCount": 0,
+        "activeLine": 1,
+        "motionProgramLine": 1,
+        "halProgramLine": 1,
+        "activeLineSource": "motion-status",
+        "activeLineHalSynced": true,
+        "switchkinsType": 0,
+        "axisPose": {
+          "x": 0,
+          "y": 0,
+          "z": 0,
+          "a": 0,
+          "b": 0,
+          "c": 0
+        },
+        "axisPoseFrame": "work",
+        "currentVelocity": 3600
+      },
+      "task": {
+        "state": "ON",
+        "mode": "AUTO",
+        "interpState": "IDLE",
+        "execState": "DONE",
+        "cycle": 4,
+        "openProgram": "/work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/boat-xyzac.ngc",
+        "openedLineCount": 1881,
+        "openedSourceLineCount": 1881,
+        "executableLineCount": 1859,
+        "nextProgramLine": 0
+      },
+      "summary": {
+        "taskRuntimeReady": true,
+        "motionRuntimeReady": true,
+        "halRuntimeReady": true,
+        "halSyncReady": true,
+        "taskHalComparisonReady": true,
+        "switchkinsRemapHalSync": true,
+        "nativeTaskReady": true,
+        "nativeHalSyncReady": true,
+        "fullLinuxCncProgramExecutionReady": false,
+        "hardwareDrive": false,
+        "hostRealtimeKernel": false
+      }
+    },
+    "taskHalStatusLoop": {
+      "apiName": "web-rtcp-5axis-task-hal-status-loop",
+      "active": false,
+      "sequence": 0,
+      "profileId": null,
+      "iniPath": null,
+      "kinematicsModuleId": null,
+      "tickCount": 0,
+      "batchSize": 5,
+      "intervalMs": 25,
+      "taskPeriodNs": 10000000,
+      "servoPeriodNs": 1000000,
+      "lastStatusAt": null,
+      "lastError": null,
+      "stopReason": null,
+      "semanticBoundary": "js_status_polling_loop_for_linuxcnc_task_hal_motion_status"
+    },
+    "programRuntimeFeedback": {
+      "apiName": "web-rtcp-5axis-program-runtime-feedback",
+      "sourceMode": "linuxcnc-task-motion-hal-wasm",
+      "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+      "sampleIndex": 40,
+      "motionIndex": 0,
+      "line": 1,
+      "motionProgramLine": 1,
+      "halProgramLine": 1,
+      "activeLineSource": "motion-status",
+      "activeLineHalSynced": true,
+      "type": "TASK_MOTION",
+      "timeSeconds": 0,
+      "axisPose": {
+        "x": 0,
+        "y": 0,
+        "z": 0,
+        "a": 0,
+        "b": 0,
+        "c": 0
+      },
+      "currentVelocityMmPerMin": 3600,
+      "requestedVelocityMmPerMin": 3600,
+      "distanceToGo": 0,
+      "dtg": {
+        "x": 0,
+        "y": 0,
+        "z": 0
+      },
+      "queueDepth": 0,
+      "activeDepth": 0,
+      "cycle": 40,
+      "taskCycle": 4,
+      "halChangedPinCount": 0
+    },
+    "selected": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/boat-xyzac.ngc",
+    "taskHalSessionProgram": "/work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/boat-xyzac.ngc",
+    "preconditions": null
+  },
+  "logs": [
+    {
+      "type": "warn",
+      "text": "[.WebGL-0x3764000f0200]GL Driver Message (OpenGL, Performance, GL_CLOSE_PATH_NV, High): GPU stall due to ReadPixels"
+    },
+    {
+      "type": "warn",
+      "text": "[.WebGL-0x3764000f0200]GL Driver Message (OpenGL, Performance, GL_CLOSE_PATH_NV, High): GPU stall due to ReadPixels"
+    },
+    {
+      "type": "warn",
+      "text": "[.WebGL-0x3764000f0200]GL Driver Message (OpenGL, Performance, GL_CLOSE_PATH_NV, High): GPU stall due to ReadPixels"
+    },
+    {
+      "type": "warn",
+      "text": "[.WebGL-0x3764000f0200]GL Driver Message (OpenGL, Performance, GL_CLOSE_PATH_NV, High): GPU stall due to ReadPixels (this message will no longer repeat)"
+    }
+  ]
+}

qa/web-rtcp-5axis-site-test/output/cloud-run-stop-after-deploy/cloud-run-stop-after-deploy.json

@@ -0,0 +1,345 @@
+{
+  "generatedAt": "2026-06-23T07:51:30.866Z",
+  "target": "https://82.156.24.101:8092/",
+  "steps": [
+    {
+      "name": "01-ready",
+      "screenshot": "/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/cloud-run-stop-after-deploy/01-ready.png",
+      "state": {
+        "runState": "idle",
+        "activeLine": 1,
+        "machine": {
+          "powerOn": true,
+          "estopActive": false,
+          "taskState": "on",
+          "mode": "auto",
+          "interpState": "idle",
+          "interpResumeState": "idle",
+          "taskPaused": false,
+          "allHomed": true,
+          "noForceHoming": false,
+          "jogAxis": "x",
+          "jogIncrement": 1,
+          "mdiCommand": "G0 X0 Y0 Z0",
+          "mdiDistanceMode": "absolute",
+          "resetCount": 0
+        },
+        "rtcpState": "on",
+        "kinsType": "tcp-xyzac",
+        "message": "RUN ready: power on, homed, auto mode",
+        "loop": {
+          "apiName": "web-rtcp-5axis-task-hal-status-loop",
+          "active": false,
+          "sequence": 0,
+          "profileId": null,
+          "iniPath": null,
+          "kinematicsModuleId": null,
+          "tickCount": 0,
+          "batchSize": 5,
+          "intervalMs": 25,
+          "taskPeriodNs": 10000000,
+          "servoPeriodNs": 1000000,
+          "lastStatusAt": null,
+          "lastError": null,
+          "stopReason": null,
+          "semanticBoundary": "js_status_polling_loop_for_linuxcnc_task_hal_motion_status"
+        },
+        "feedback": {
+          "apiName": "web-rtcp-5axis-program-runtime-feedback",
+          "sourceMode": "linuxcnc-task-motion-hal-wasm",
+          "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+          "sampleIndex": 40,
+          "motionIndex": 0,
+          "line": 1,
+          "motionProgramLine": 1,
+          "halProgramLine": 1,
+          "activeLineSource": "motion-status",
+          "activeLineHalSynced": true,
+          "type": "TASK_MOTION",
+          "timeSeconds": 0,
+          "axisPose": {
+            "x": 0,
+            "y": 0,
+            "z": 0,
+            "a": 0,
+            "b": 0,
+            "c": 0
+          },
+          "currentVelocityMmPerMin": 3600,
+          "requestedVelocityMmPerMin": 3600,
+          "distanceToGo": 0,
+          "dtg": {
+            "x": 0,
+            "y": 0,
+            "z": 0
+          },
+          "queueDepth": 0,
+          "activeDepth": 0,
+          "cycle": 40,
+          "taskCycle": 4,
+          "halChangedPinCount": 0
+        },
+        "history": 3,
+        "lineExecution": {
+          "status": "idle",
+          "source": "linuxcnc-task-motion-hal-wasm",
+          "line": 1,
+          "feed": 3600,
+          "requestedFeed": 3600,
+          "feedMode": null,
+          "axisPose": {
+            "x": 0,
+            "y": 0,
+            "z": 0,
+            "a": 0,
+            "b": 0,
+            "c": 0
+          },
+          "taskCycle": 4,
+          "servoCycle": 40,
+          "sampleIndex": 40,
+          "motionIndex": 0,
+          "updatedAt": "2026-06-23T07:51:07.542Z"
+        },
+        "source": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/impeller-7bl-xyzac.ngc"
+      },
+      "ui": {
+        "activeUiLine": 1,
+        "lineText": "idle | F 3600.0 | X 0.000 | Y 0.000 | Z 0.000 | A 0.000 | C 0.000 | cycle 4/40",
+        "stopExists": true
+      }
+    },
+    {
+      "name": "02-running",
+      "screenshot": "/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/cloud-run-stop-after-deploy/02-running.png",
+      "state": {
+        "runState": "running",
+        "activeLine": 9,
+        "machine": {
+          "powerOn": true,
+          "estopActive": false,
+          "taskState": "on",
+          "mode": "auto",
+          "interpState": "reading",
+          "interpResumeState": "reading",
+          "taskPaused": false,
+          "allHomed": true,
+          "noForceHoming": false,
+          "jogAxis": "x",
+          "jogIncrement": 1,
+          "mdiCommand": "G0 X0 Y0 Z0",
+          "mdiDistanceMode": "absolute",
+          "resetCount": 0
+        },
+        "rtcpState": "on",
+        "kinsType": "tcp-xyzac",
+        "message": "task/HAL status tick 5",
+        "loop": {
+          "apiName": "web-rtcp-5axis-task-hal-status-loop",
+          "active": true,
+          "sequence": 1,
+          "profileId": "xyzac-trt",
+          "iniPath": "configs/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt.ini",
+          "kinematicsModuleId": "xyzac-trt",
+          "tickCount": 5,
+          "batchSize": 5,
+          "intervalMs": 25,
+          "taskPeriodNs": 10000000,
+          "servoPeriodNs": 1000000,
+          "lastStatusAt": "2026-06-23T07:51:21.038Z",
+          "lastError": null,
+          "stopReason": null,
+          "semanticBoundary": "js_status_polling_loop_for_linuxcnc_task_hal_motion_status"
+        },
+        "feedback": {
+          "apiName": "web-rtcp-5axis-program-runtime-feedback",
+          "sourceMode": "linuxcnc-task-motion-hal-wasm",
+          "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+          "sampleIndex": 340,
+          "motionIndex": 8,
+          "line": 9,
+          "motionProgramLine": 9,
+          "halProgramLine": 9,
+          "activeLineSource": "motion-status",
+          "activeLineHalSynced": true,
+          "type": "TASK_MOTION",
+          "timeSeconds": 0,
+          "axisPose": {
+            "x": 10.4843,
+            "y": -17.3304,
+            "z": 30.0805,
+            "a": -71.841,
+            "b": 0,
+            "c": -35.93
+          },
+          "currentVelocityMmPerMin": 2100,
+          "requestedVelocityMmPerMin": 2100,
+          "distanceToGo": 0,
+          "dtg": {
+            "x": 0,
+            "y": 0,
+            "z": 0
+          },
+          "queueDepth": 0,
+          "activeDepth": 0,
+          "cycle": 340,
+          "taskCycle": 34,
+          "halChangedPinCount": 0
+        },
+        "history": 5,
+        "lineExecution": {
+          "status": "running",
+          "source": "linuxcnc-task-motion-hal-wasm",
+          "line": 9,
+          "feed": 2100,
+          "requestedFeed": 2100,
+          "feedMode": null,
+          "axisPose": {
+            "x": 10.4843,
+            "y": -17.3304,
+            "z": 30.0805,
+            "a": -71.841,
+            "b": 0,
+            "c": -35.93
+          },
+          "taskCycle": 34,
+          "servoCycle": 340,
+          "sampleIndex": 340,
+          "motionIndex": 8,
+          "updatedAt": "2026-06-23T07:51:21.038Z"
+        },
+        "source": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/impeller-7bl-xyzac.ngc"
+      },
+      "ui": {
+        "activeUiLine": 9,
+        "lineText": "running | F 2100.0 | X 10.484 | Y -17.330 | Z 30.081 | A -71.841 | C -35.930 | cycle 34/340",
+        "stopExists": true
+      }
+    },
+    {
+      "name": "03-stopped",
+      "screenshot": "/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/cloud-run-stop-after-deploy/03-stopped.png",
+      "state": {
+        "runState": "stopped",
+        "activeLine": 9,
+        "machine": {
+          "powerOn": true,
+          "estopActive": false,
+          "taskState": "on",
+          "mode": "auto",
+          "interpState": "idle",
+          "interpResumeState": "idle",
+          "taskPaused": false,
+          "allHomed": true,
+          "noForceHoming": false,
+          "jogAxis": "x",
+          "jogIncrement": 1,
+          "mdiCommand": "G0 X0 Y0 Z0",
+          "mdiDistanceMode": "absolute",
+          "resetCount": 0
+        },
+        "rtcpState": "on",
+        "kinsType": "tcp-xyzac",
+        "message": "task/HAL program stopped",
+        "loop": {
+          "apiName": "web-rtcp-5axis-task-hal-status-loop",
+          "active": false,
+          "sequence": 1,
+          "profileId": "xyzac-trt",
+          "iniPath": "configs/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt.ini",
+          "kinematicsModuleId": "xyzac-trt",
+          "tickCount": 7,
+          "batchSize": 5,
+          "intervalMs": 25,
+          "taskPeriodNs": 10000000,
+          "servoPeriodNs": 1000000,
+          "lastStatusAt": "2026-06-23T07:51:24.831Z",
+          "lastError": null,
+          "stopReason": "running",
+          "semanticBoundary": "js_status_polling_loop_for_linuxcnc_task_hal_motion_status"
+        },
+        "feedback": {
+          "apiName": "web-rtcp-5axis-program-runtime-feedback",
+          "sourceMode": "linuxcnc-task-motion-hal-wasm",
+          "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+          "sampleIndex": 500,
+          "motionIndex": 8,
+          "line": 9,
+          "motionProgramLine": 9,
+          "halProgramLine": 9,
+          "activeLineSource": "motion-status",
+          "activeLineHalSynced": true,
+          "type": "TASK_MOTION",
+          "timeSeconds": 0,
+          "axisPose": {
+            "x": 7.55697,
+            "y": -13.2911,
+            "z": 28.4442,
+            "a": -71.841,
+            "b": 0,
+            "c": -35.93
+          },
+          "currentVelocityMmPerMin": 2100,
+          "requestedVelocityMmPerMin": 2100,
+          "distanceToGo": 0,
+          "dtg": {
+            "x": 0,
+            "y": 0,
+            "z": 0
+          },
+          "queueDepth": 0,
+          "activeDepth": 0,
+          "cycle": 500,
+          "taskCycle": 50,
+          "halChangedPinCount": 0
+        },
+        "history": 9,
+        "lineExecution": {
+          "status": "stopped",
+          "source": "linuxcnc-task-motion-hal-wasm",
+          "line": 9,
+          "feed": 2100,
+          "requestedFeed": 2100,
+          "feedMode": null,
+          "axisPose": {
+            "x": 7.55697,
+            "y": -13.2911,
+            "z": 28.4442,
+            "a": -71.841,
+            "b": 0,
+            "c": -35.93
+          },
+          "taskCycle": 50,
+          "servoCycle": 500,
+          "sampleIndex": 500,
+          "motionIndex": 8,
+          "updatedAt": "2026-06-23T07:51:26.643Z"
+        },
+        "source": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/impeller-7bl-xyzac.ngc"
+      },
+      "ui": {
+        "activeUiLine": 9,
+        "lineText": "stopped | F 2100.0 | X 7.557 | Y -13.291 | Z 28.444 | A -71.841 | C -35.930 | cycle 50/500",
+        "stopExists": true
+      }
+    }
+  ],
+  "logs": [
+    {
+      "type": "warn",
+      "text": "[.WebGL-0x35b4000f0200]GL Driver Message (OpenGL, Performance, GL_CLOSE_PATH_NV, High): GPU stall due to ReadPixels"
+    },
+    {
+      "type": "warn",
+      "text": "[.WebGL-0x35b4000f0200]GL Driver Message (OpenGL, Performance, GL_CLOSE_PATH_NV, High): GPU stall due to ReadPixels"
+    },
+    {
+      "type": "warn",
+      "text": "[.WebGL-0x35b4000f0200]GL Driver Message (OpenGL, Performance, GL_CLOSE_PATH_NV, High): GPU stall due to ReadPixels"
+    },
+    {
+      "type": "warn",
+      "text": "[.WebGL-0x35b4000f0200]GL Driver Message (OpenGL, Performance, GL_CLOSE_PATH_NV, High): GPU stall due to ReadPixels (this message will no longer repeat)"
+    }
+  ]
+}

qa/web-rtcp-5axis-site-test/output/local-chrome-boat-run-line-evidence.json

@@ -0,0 +1,385 @@
+{
+  "generatedAt": "2026-06-23T01:38:37.231Z",
+  "url": "http://127.0.0.1:35283/web-rtcp-5axis-sim-plan/app/index.html",
+  "sourceRel": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/boat-xyzac.ngc",
+  "activeLines": [
+    9,
+    10,
+    12
+  ],
+  "historyLines": [
+    9,
+    10,
+    11,
+    12
+  ],
+  "synced": true,
+  "samples": [
+    {
+      "elapsedMs": 100,
+      "activeLine": 9,
+      "uiLine": 9,
+      "runState": "running",
+      "velocity": 2100,
+      "line": 9,
+      "motionProgramLine": 9,
+      "halProgramLine": 9,
+      "activeLineSource": "motion-status",
+      "activeLineHalSynced": true,
+      "history": [
+        {
+          "line": 9,
+          "motion": 9,
+          "hal": 9,
+          "source": "motion-status",
+          "synced": true
+        }
+      ]
+    },
+    {
+      "elapsedMs": 250,
+      "activeLine": 10,
+      "uiLine": 10,
+      "runState": "running",
+      "velocity": 2100,
+      "line": 10,
+      "motionProgramLine": 10,
+      "halProgramLine": 10,
+      "activeLineSource": "motion-status",
+      "activeLineHalSynced": true,
+      "history": [
+        {
+          "line": 10,
+          "motion": 10,
+          "hal": 10,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 10,
+          "motion": 10,
+          "hal": 10,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 9,
+          "motion": 9,
+          "hal": 9,
+          "source": "motion-status",
+          "synced": true
+        }
+      ]
+    },
+    {
+      "elapsedMs": 500,
+      "activeLine": 10,
+      "uiLine": 10,
+      "runState": "running",
+      "velocity": 2100,
+      "line": 10,
+      "motionProgramLine": 10,
+      "halProgramLine": 10,
+      "activeLineSource": "motion-status",
+      "activeLineHalSynced": true,
+      "history": [
+        {
+          "line": 10,
+          "motion": 10,
+          "hal": 10,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 10,
+          "motion": 10,
+          "hal": 10,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 10,
+          "motion": 10,
+          "hal": 10,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 10,
+          "motion": 10,
+          "hal": 10,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 9,
+          "motion": 9,
+          "hal": 9,
+          "source": "motion-status",
+          "synced": true
+        }
+      ]
+    },
+    {
+      "elapsedMs": 1000,
+      "activeLine": 12,
+      "uiLine": 12,
+      "runState": "running",
+      "velocity": 100.0002,
+      "line": 12,
+      "motionProgramLine": 12,
+      "halProgramLine": 12,
+      "activeLineSource": "motion-status",
+      "activeLineHalSynced": true,
+      "history": [
+        {
+          "line": 12,
+          "motion": 12,
+          "hal": 12,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 11,
+          "motion": 11,
+          "hal": 11,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 10,
+          "motion": 10,
+          "hal": 10,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 10,
+          "motion": 10,
+          "hal": 10,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 10,
+          "motion": 10,
+          "hal": 10,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 10,
+          "motion": 10,
+          "hal": 10,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 9,
+          "motion": 9,
+          "hal": 9,
+          "source": "motion-status",
+          "synced": true
+        }
+      ]
+    },
+    {
+      "elapsedMs": 2000,
+      "activeLine": 12,
+      "uiLine": 12,
+      "runState": "running",
+      "velocity": 100.0002,
+      "line": 12,
+      "motionProgramLine": 12,
+      "halProgramLine": 12,
+      "activeLineSource": "motion-status",
+      "activeLineHalSynced": true,
+      "history": [
+        {
+          "line": 12,
+          "motion": 12,
+          "hal": 12,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 12,
+          "motion": 12,
+          "hal": 12,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 12,
+          "motion": 12,
+          "hal": 12,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 12,
+          "motion": 12,
+          "hal": 12,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 12,
+          "motion": 12,
+          "hal": 12,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 11,
+          "motion": 11,
+          "hal": 11,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 10,
+          "motion": 10,
+          "hal": 10,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 10,
+          "motion": 10,
+          "hal": 10,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 10,
+          "motion": 10,
+          "hal": 10,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 10,
+          "motion": 10,
+          "hal": 10,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 9,
+          "motion": 9,
+          "hal": 9,
+          "source": "motion-status",
+          "synced": true
+        }
+      ]
+    },
+    {
+      "elapsedMs": 4000,
+      "activeLine": 12,
+      "uiLine": 12,
+      "runState": "running",
+      "velocity": 100.0002,
+      "line": 12,
+      "motionProgramLine": 12,
+      "halProgramLine": 12,
+      "activeLineSource": "motion-status",
+      "activeLineHalSynced": true,
+      "history": [
+        {
+          "line": 12,
+          "motion": 12,
+          "hal": 12,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 12,
+          "motion": 12,
+          "hal": 12,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 12,
+          "motion": 12,
+          "hal": 12,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 12,
+          "motion": 12,
+          "hal": 12,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 12,
+          "motion": 12,
+          "hal": 12,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 12,
+          "motion": 12,
+          "hal": 12,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 12,
+          "motion": 12,
+          "hal": 12,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 12,
+          "motion": 12,
+          "hal": 12,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 12,
+          "motion": 12,
+          "hal": 12,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 12,
+          "motion": 12,
+          "hal": 12,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 12,
+          "motion": 12,
+          "hal": 12,
+          "source": "motion-status",
+          "synced": true
+        },
+        {
+          "line": 12,
+          "motion": 12,
+          "hal": 12,
+          "source": "motion-status",
+          "synced": true
+        }
+      ]
+    }
+  ],
+  "final": {
+    "runState": "running",
+    "activeLine": 12,
+    "feedbackHistoryLength": 24
+  },
+  "consoleErrors": [
+    "Failed to load resource: the server responded with a status of 404 (Not Found)",
+    "Failed to load resource: the server responded with a status of 404 (Not Found)"
+  ]
+}

qa/web-rtcp-5axis-site-test/output/meter-scene-evidence.json

@@ -0,0 +1,267 @@
+{
+  "generatedAt": "2026-06-22T22:09:41.825Z",
+  "targetUrl": "http://127.0.0.1:45757/web-rtcp-5axis-sim-plan/app/index.html",
+  "caseName": "08-meter-scene-desktop-mobile",
+  "summary": "浏览器米尺度 Three.js 证据：desktop/mobile canvas 非空、路径 bounds 为米、预览稳定居中",
+  "status": "PASS",
+  "samples": [
+    {
+      "viewport": {
+        "name": "desktop",
+        "width": 1600,
+        "height": 1200,
+        "deviceScaleFactor": 1
+      },
+      "screenshotPath": "/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/screenshots/meter-scene-evidence/08-meter-scene-desktop.png",
+      "pixelStats": {
+        "width": 803,
+        "height": 874,
+        "averageLuminance": 65.18,
+        "nonBlackRatio": 0.8173
+      },
+      "dataset": {
+        "fiveAxisCanvas": "true",
+        "engine": "three.js r183",
+        "threeReady": "true",
+        "threeRevision": "183",
+        "threePathPoints": "1498",
+        "threeExecutedPathPoints": "1",
+        "threeSceneObjects": "20",
+        "threeToolhead": "{\"x\":0,\"y\":0,\"z\":0}",
+        "threeSceneUnits": "m",
+        "threeLinearUnits": "mm",
+        "threeLinearUnitScaleToMeters": "0.001",
+        "threeToolAxis": "{\"x\":0.558,\"y\":0.769,\"z\":0.312}",
+        "threeTcpPose": "{\"x\":36.474,\"y\":-22.486,\"z\":-13.749,\"a\":-71.841,\"c\":-35.93}",
+        "threeRtcpState": "on",
+        "threeSelectedView": "iso",
+        "threeFrameApi": "web-rtcp-5axis-motion-frame",
+        "threeRenderer": "webgl",
+        "threeSceneMode": "program-preview-and-tool-execution",
+        "threePreviewScope": "machine-reference-and-toolpath",
+        "threeMachineReferenceModel": "webgl-five-axis-reference",
+        "threeCameraControls": "orbit-pan-zoom",
+        "threeProgramPreviewSource": "linuxcnc-interpreter-wasm",
+        "threeToolExecutionMarker": "true",
+        "threeTcpMarker": "sphere",
+        "threeToolAxisMarker": "line",
+        "threeToolpathPreviewSource": "linuxcnc_interpreter_canonical_motion",
+        "threeToolExecutionTraceSource": "linuxcnc_tp_samples_or_task_motion_hal_feedback",
+        "threePathFitBounds": "ok",
+        "threePathBoundsMeters": "{\"center\":{\"x\":-0.001,\"y\":0,\"z\":0.019},\"size\":{\"x\":0.088,\"y\":0.089,\"z\":0.043},\"maxSpan\":0.089211}",
+        "threeCurrentSegmentHighlight": "ok",
+        "threeRapidFeedVisualDistinction": "ok",
+        "threeNoGcodeSemanticsGeneration": "ok",
+        "threeRapidPathPoints": "186",
+        "threeFeedPathPoints": "1436",
+        "threeArcPathPoints": "0",
+        "threeCurrentSegmentPoints": "1",
+        "threeCurrentSegmentType": "STRAIGHT_TRAVERSE"
+      },
+      "status": "PASS",
+      "checks": [
+        {
+          "name": "canvas ready",
+          "pass": true,
+          "detail": "threeReady=true"
+        },
+        {
+          "name": "WebGL renderer",
+          "pass": true,
+          "detail": "renderer=webgl"
+        },
+        {
+          "name": "机床参考模型",
+          "pass": true,
+          "detail": "scope=machine-reference-and-toolpath, model=webgl-five-axis-reference"
+        },
+        {
+          "name": "TCP 球标记",
+          "pass": true,
+          "detail": "tcp=sphere, marker=true"
+        },
+        {
+          "name": "刀轴线",
+          "pass": true,
+          "detail": "toolAxisMarker=line"
+        },
+        {
+          "name": "场景对象数量",
+          "pass": true,
+          "detail": "sceneObjects=20"
+        },
+        {
+          "name": "无 G-code 语义生成",
+          "pass": true,
+          "detail": "semanticGuard=ok"
+        },
+        {
+          "name": "刀路预览点",
+          "pass": true,
+          "detail": "pathPoints=1498"
+        },
+        {
+          "name": "执行轨迹点",
+          "pass": true,
+          "detail": "executed=1"
+        },
+        {
+          "name": "scene units are meters",
+          "pass": true,
+          "detail": "sceneUnits=m"
+        },
+        {
+          "name": "linear scale visible",
+          "pass": true,
+          "detail": "scale=0.001"
+        },
+        {
+          "name": "path fit bounds",
+          "pass": true,
+          "detail": "fit=ok"
+        },
+        {
+          "name": "path bounds in meters",
+          "pass": true,
+          "detail": "bounds={\"center\":{\"x\":-0.001,\"y\":0,\"z\":0.019},\"size\":{\"x\":0.088,\"y\":0.089,\"z\":0.043},\"maxSpan\":0.089211}"
+        },
+        {
+          "name": "canvas nonblank",
+          "pass": true,
+          "detail": "nonBlack=0.8173"
+        }
+      ]
+    },
+    {
+      "viewport": {
+        "name": "mobile",
+        "width": 390,
+        "height": 844,
+        "deviceScaleFactor": 2
+      },
+      "screenshotPath": "/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/screenshots/meter-scene-evidence/08-meter-scene-mobile.png",
+      "pixelStats": {
+        "width": 1146,
+        "height": 1036,
+        "averageLuminance": 67.87,
+        "nonBlackRatio": 0.838
+      },
+      "dataset": {
+        "fiveAxisCanvas": "true",
+        "engine": "three.js r183",
+        "threeReady": "true",
+        "threeRevision": "183",
+        "threePathPoints": "1498",
+        "threeExecutedPathPoints": "1",
+        "threeSceneObjects": "20",
+        "threeToolhead": "{\"x\":0,\"y\":0,\"z\":0}",
+        "threeSceneUnits": "m",
+        "threeLinearUnits": "mm",
+        "threeLinearUnitScaleToMeters": "0.001",
+        "threeToolAxis": "{\"x\":0.558,\"y\":0.769,\"z\":0.312}",
+        "threeTcpPose": "{\"x\":36.474,\"y\":-22.486,\"z\":-13.749,\"a\":-71.841,\"c\":-35.93}",
+        "threeRtcpState": "on",
+        "threeSelectedView": "iso",
+        "threeFrameApi": "web-rtcp-5axis-motion-frame",
+        "threeRenderer": "webgl",
+        "threeSceneMode": "program-preview-and-tool-execution",
+        "threePreviewScope": "machine-reference-and-toolpath",
+        "threeMachineReferenceModel": "webgl-five-axis-reference",
+        "threeCameraControls": "orbit-pan-zoom",
+        "threeProgramPreviewSource": "linuxcnc-interpreter-wasm",
+        "threeToolExecutionMarker": "true",
+        "threeTcpMarker": "sphere",
+        "threeToolAxisMarker": "line",
+        "threeToolpathPreviewSource": "linuxcnc_interpreter_canonical_motion",
+        "threeToolExecutionTraceSource": "linuxcnc_tp_samples_or_task_motion_hal_feedback",
+        "threePathFitBounds": "ok",
+        "threePathBoundsMeters": "{\"center\":{\"x\":-0.001,\"y\":0,\"z\":0.019},\"size\":{\"x\":0.088,\"y\":0.089,\"z\":0.043},\"maxSpan\":0.089211}",
+        "threeCurrentSegmentHighlight": "ok",
+        "threeRapidFeedVisualDistinction": "ok",
+        "threeNoGcodeSemanticsGeneration": "ok",
+        "threeRapidPathPoints": "186",
+        "threeFeedPathPoints": "1436",
+        "threeArcPathPoints": "0",
+        "threeCurrentSegmentPoints": "1",
+        "threeCurrentSegmentType": "STRAIGHT_TRAVERSE"
+      },
+      "status": "PASS",
+      "checks": [
+        {
+          "name": "canvas ready",
+          "pass": true,
+          "detail": "threeReady=true"
+        },
+        {
+          "name": "WebGL renderer",
+          "pass": true,
+          "detail": "renderer=webgl"
+        },
+        {
+          "name": "机床参考模型",
+          "pass": true,
+          "detail": "scope=machine-reference-and-toolpath, model=webgl-five-axis-reference"
+        },
+        {
+          "name": "TCP 球标记",
+          "pass": true,
+          "detail": "tcp=sphere, marker=true"
+        },
+        {
+          "name": "刀轴线",
+          "pass": true,
+          "detail": "toolAxisMarker=line"
+        },
+        {
+          "name": "场景对象数量",
+          "pass": true,
+          "detail": "sceneObjects=20"
+        },
+        {
+          "name": "无 G-code 语义生成",
+          "pass": true,
+          "detail": "semanticGuard=ok"
+        },
+        {
+          "name": "刀路预览点",
+          "pass": true,
+          "detail": "pathPoints=1498"
+        },
+        {
+          "name": "执行轨迹点",
+          "pass": true,
+          "detail": "executed=1"
+        },
+        {
+          "name": "scene units are meters",
+          "pass": true,
+          "detail": "sceneUnits=m"
+        },
+        {
+          "name": "linear scale visible",
+          "pass": true,
+          "detail": "scale=0.001"
+        },
+        {
+          "name": "path fit bounds",
+          "pass": true,
+          "detail": "fit=ok"
+        },
+        {
+          "name": "path bounds in meters",
+          "pass": true,
+          "detail": "bounds={\"center\":{\"x\":-0.001,\"y\":0,\"z\":0.019},\"size\":{\"x\":0.088,\"y\":0.089,\"z\":0.043},\"maxSpan\":0.089211}"
+        },
+        {
+          "name": "canvas nonblank",
+          "pass": true,
+          "detail": "nonBlack=0.838"
+        }
+      ]
+    }
+  ],
+  "consoleErrors": [
+    "Failed to load resource: the server responded with a status of 404 (Not Found)",
+    "Failed to load resource: the server responded with a status of 404 (Not Found)"
+  ]
+}

qa/web-rtcp-5axis-site-test/output/native-task-hal-comparison-report.json

@@ -0,0 +1,289 @@
+{
+  "apiName": "web-rtcp-5axis-native-task-hal-comparison-report",
+  "generatedAt": "2026-06-23T09:22:56.110Z",
+  "status": "PASS_WITH_HOST_NATIVE_RUNTIME_BLOCKER",
+  "scope": "LinuxCNC source/phase0 task-HAL comparison plus attempted host-native TRT runtime probe",
+  "commands": {
+    "phase0": {
+      "command": "bash wasm-port/tests/native/verify_task_hal_phase0.sh",
+      "status": 0,
+      "signal": null,
+      "stdout": "task_hal_phase0_native_probe_gate=ok\n",
+      "stderr": ""
+    },
+    "nativeAudit": {
+      "command": "node web-rtcp-5axis-sim-plan/tests/node/verify_native_task_hal_audit.mjs",
+      "status": 0,
+      "signal": null,
+      "stdout": "native_task_hal_source_artifact_audit=ok\nnative_task_hal_readiness_artifact=web-rtcp-5axis-sim-plan/build/readiness/native-task-hal-readiness.json\ntask_hal_web_simulation_boundary_consistent=1\nnative_task_hal_host_probe_status=ready_disabled_by_default\nhardware_drive=0\nhost_realtime_kernel=0\nexternal_user_m_process_ready=0\ntool_db_process_ready=0\npromotion_scope=web_simulation_only\n",
+      "stderr": ""
+    },
+    "optInNativeProbe": {
+      "command": "ENABLE_TRT_TASK_HAL_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_trt_task_hal_runtime.sh",
+      "status": 1,
+      "signal": null,
+      "stdout": "trt_task_hal_runtime_halcmd_path=/home/meswork/cnc_wams/wasm-port/../linuxcnc/bin/halcmd\ntrt_task_hal_runtime_linuxcnc_path=/home/meswork/cnc_wams/wasm-port/../linuxcnc/scripts/linuxcnc\ntrt_task_hal_runtime_requirements=halcmd:1,linuxcnc:1\ntrt_task_hal_missing_requirements=-\ntrt_task_hal_source_proof_ready=1\ntrt_task_hal_runtime_ready=1\ntrt_task_hal_execution_enabled=0\ntrt_task_hal_promotion_allowed=0\nnativeTaskReady=false\nnativeHalSyncReady=false\ntrt_task_hal_runtime_probe_ini=/home/meswork/cnc_wams/wasm-port/../linuxcnc/configs/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt.ini\ntrt_task_hal_runtime_probe_program=/home/meswork/cnc_wams/wasm-port/../linuxcnc/configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/xyzac_switchkins.ngc\ntrt_task_hal_runtime_probe_linuxcnc_stdout=/home/meswork/cnc_wams/wasm-port/build/native/trt-task-hal-runtime/linuxcnc.stdout.log\ntrt_task_hal_runtime_probe_linuxcnc_stderr=/home/meswork/cnc_wams/wasm-port/build/native/trt-task-hal-runtime/linuxcnc.stderr.log\nnative_task_hal_probe=failed\nnative_probe_status=failed\ntrt_task_hal_runtime_probe_status=runtime_state_probe_failed\ntrt_task_hal_runtime_probe_note=linuxcnc_started_but_required_trt_hal_pins_did_not_appear\n",
+      "stderr": ""
+    },
+    "fixtureBaseline": {
+      "command": "LD_LIBRARY_PATH=linuxcnc/lib bash wasm-port/tools/verify_native_linuxcnc_fixture_baseline.sh",
+      "status": 1,
+      "signal": null,
+      "stdout": "",
+      "stderr": "upstream rs274 failed for fixture: minimal_linear\n/home/meswork/cnc_wams/wasm-port/../linuxcnc/bin/rs274: error while loading shared libraries: libpython3.13.so.1.0: cannot open shared object file: No such file or directory\n"
+    }
+  },
+  "readiness": {
+    "apiName": "web-rtcp-5axis-native-task-hal-readiness-audit",
+    "batch": "M18-native-task-hal-source-and-artifact-audit",
+    "generatedAt": "2026-06-22T00:00:00.000Z",
+    "status": "ok",
+    "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+    "promotionScope": "web_simulation_only",
+    "taskHalWebSimulationBoundaryConsistent": true,
+    "webSimulation": {
+      "promoted": true,
+      "taskRuntimeReady": true,
+      "motionRuntimeReady": true,
+      "halRuntimeReady": true,
+      "nativeTaskReady": true,
+      "nativeHalSyncReady": true,
+      "fullLinuxCncProgramExecutionReady": true,
+      "promotionAllowed": true
+    },
+    "nativeHostAndHardware": {
+      "nativeProbe": "ok",
+      "nativeProbeStatus": "ready_disabled_by_default",
+      "nativePromotionAllowed": false,
+      "hardwareDrive": false,
+      "hostRealtimeKernel": false,
+      "externalUserMProcessReady": false,
+      "toolDbProcessReady": false
+    },
+    "sourceManifest": {
+      "ready": true,
+      "taskSourceCount": 7,
+      "halSourceCount": 4,
+      "motionSourceCount": 6,
+      "nmlSourceCount": 1,
+      "libnmlSourceCount": 2,
+      "referenceSourceReady": true,
+      "vendorSourceReady": false,
+      "vendorHashMatchReady": true
+    },
+    "gates": {
+      "task_hal_web_simulation_boundary_consistent": 1,
+      "native_task_hal_host_probe_status": "ready_disabled_by_default",
+      "hardware_drive": 0,
+      "host_realtime_kernel": 0,
+      "external_user_m_process_ready": 0,
+      "tool_db_process_ready": 0,
+      "promotion_scope": "web_simulation_only"
+    },
+    "artifacts": {
+      "readinessJson": "web-rtcp-5axis-sim-plan/build/readiness/native-task-hal-readiness.json",
+      "sourceManifestLog": "wasm-port/build/task-hal/verify_task_hal_source_manifest.stdout.log",
+      "sourceManifestReport": "wasm-port/build/task-hal/task-hal-source-manifest.tsv",
+      "nativeProbeLog": "wasm-port/build/task-hal/probe_trt_task_hal_runtime.stdout.log"
+    },
+    "blockers": []
+  },
+  "sourceManifest": {
+    "task_hal_source_manifest_status": "ok",
+    "task_hal_source_manifest_ready": "1",
+    "task_hal_source_manifest_path": "/home/meswork/cnc_wams/wasm-port/tools/task-hal-source-manifest.txt",
+    "task_hal_source_manifest_report": "/home/meswork/cnc_wams/wasm-port/build/task-hal/task-hal-source-manifest.tsv",
+    "task_hal_source_count": "20",
+    "task_source_count": "7",
+    "hal_source_count": "4",
+    "motion_source_count": "6",
+    "nml_source_count": "1",
+    "libnml_source_count": "2",
+    "task_hal_reference_source_ready": "1",
+    "task_hal_vendor_source_ready": "0",
+    "task_hal_vendor_hash_match_ready": "1",
+    "task_hal_missing_reference_source_count": "0",
+    "task_hal_missing_reference_sources_ready": "1",
+    "task_hal_missing_reference_source_list": "-",
+    "task_hal_missing_vendor_source_list": "src/emc/task/task.hh,src/emc/task/taskclass.hh,src/emc/task/taskclass.cc,src/emc/task/emctask.cc,src/emc/task/emctaskmain.cc,src/emc/task/taskintf.cc,src/emc/task/emccanon.cc,src/emc/motion/usrmotintf.h,src/emc/motion/motion.c,src/emc/motion/command.c,src/emc/motion/control.c,src/hal/hal_lib.c,src/hal/hal_priv.h,src/hal/components/threads.c,src/hal/utils/halcmd_commands.cc",
+    "task_hal_mismatched_vendor_source_list": "-",
+    "task_hal_runtime_promoted": "0",
+    "nativeTaskReady": "false",
+    "nativeHalSyncReady": "false"
+  },
+  "defaultProbe": {
+    "trt_task_hal_runtime_halcmd_path": "/home/meswork/cnc_wams/wasm-port/../linuxcnc/bin/halcmd",
+    "trt_task_hal_runtime_linuxcnc_path": "/home/meswork/cnc_wams/wasm-port/../linuxcnc/scripts/linuxcnc",
+    "trt_task_hal_runtime_requirements": "halcmd:1,linuxcnc:1",
+    "trt_task_hal_missing_requirements": "-",
+    "trt_task_hal_source_proof_ready": "1",
+    "trt_task_hal_runtime_ready": "1",
+    "trt_task_hal_execution_enabled": "0",
+    "trt_task_hal_promotion_allowed": "0",
+    "nativeTaskReady": "false",
+    "nativeHalSyncReady": "false",
+    "native_task_hal_probe": "ok",
+    "native_probe_status": "ready_disabled_by_default",
+    "trt_task_hal_runtime_probe_status": "ready_disabled_by_default",
+    "trt_task_hal_runtime_probe_note": "set_ENABLE_TRT_TASK_HAL_RUNTIME_PROBE_1_to_run_exclusive_host_runtime_probe"
+  },
+  "optInProbeFields": {
+    "trt_task_hal_runtime_halcmd_path": "/home/meswork/cnc_wams/wasm-port/../linuxcnc/bin/halcmd",
+    "trt_task_hal_runtime_linuxcnc_path": "/home/meswork/cnc_wams/wasm-port/../linuxcnc/scripts/linuxcnc",
+    "trt_task_hal_runtime_requirements": "halcmd:1,linuxcnc:1",
+    "trt_task_hal_missing_requirements": "-",
+    "trt_task_hal_source_proof_ready": "1",
+    "trt_task_hal_runtime_ready": "1",
+    "trt_task_hal_execution_enabled": "0",
+    "trt_task_hal_promotion_allowed": "0",
+    "nativeTaskReady": "false",
+    "nativeHalSyncReady": "false",
+    "trt_task_hal_runtime_probe_ini": "/home/meswork/cnc_wams/wasm-port/../linuxcnc/configs/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt.ini",
+    "trt_task_hal_runtime_probe_program": "/home/meswork/cnc_wams/wasm-port/../linuxcnc/configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/xyzac_switchkins.ngc",
+    "trt_task_hal_runtime_probe_linuxcnc_stdout": "/home/meswork/cnc_wams/wasm-port/build/native/trt-task-hal-runtime/linuxcnc.stdout.log",
+    "trt_task_hal_runtime_probe_linuxcnc_stderr": "/home/meswork/cnc_wams/wasm-port/build/native/trt-task-hal-runtime/linuxcnc.stderr.log",
+    "native_task_hal_probe": "failed",
+    "native_probe_status": "failed",
+    "trt_task_hal_runtime_probe_status": "runtime_state_probe_failed",
+    "trt_task_hal_runtime_probe_note": "linuxcnc_started_but_required_trt_hal_pins_did_not_appear"
+  },
+  "hostBlockers": [
+    {
+      "component": "halcmd",
+      "blocker": "dynamic_linker_requirement",
+      "detail": "linuxcnc/bin/halcmd: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by linuxcnc/bin/halcmd)"
+    },
+    {
+      "component": "halcmd",
+      "blocker": "dynamic_linker_requirement",
+      "detail": "liblinuxcncini.so.1 => not found"
+    },
+    {
+      "component": "halcmd",
+      "blocker": "dynamic_linker_requirement",
+      "detail": "liblinuxcnchal.so.0 => not found"
+    },
+    {
+      "component": "rs274",
+      "blocker": "dynamic_linker_requirement",
+      "detail": "linuxcnc/bin/rs274: /lib/x86_64-linux-gnu/libstdc++.so.6: version `GLIBCXX_3.4.31' not found (required by linuxcnc/bin/rs274)"
+    },
+    {
+      "component": "rs274",
+      "blocker": "dynamic_linker_requirement",
+      "detail": "linuxcnc/bin/rs274: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by linuxcnc/bin/rs274)"
+    },
+    {
+      "component": "rs274",
+      "blocker": "dynamic_linker_requirement",
+      "detail": "librs274.so.0 => not found"
+    },
+    {
+      "component": "rs274",
+      "blocker": "dynamic_linker_requirement",
+      "detail": "libnml.so.0 => not found"
+    },
+    {
+      "component": "rs274",
+      "blocker": "dynamic_linker_requirement",
+      "detail": "liblinuxcnchal.so.0 => not found"
+    },
+    {
+      "component": "rs274",
+      "blocker": "dynamic_linker_requirement",
+      "detail": "liblinuxcncini.so.1 => not found"
+    },
+    {
+      "component": "rs274",
+      "blocker": "dynamic_linker_requirement",
+      "detail": "libtooldata.so.0 => not found"
+    },
+    {
+      "component": "rs274",
+      "blocker": "dynamic_linker_requirement",
+      "detail": "libpython3.13.so.1.0 => not found"
+    },
+    {
+      "component": "linuxcncsvr",
+      "blocker": "dynamic_linker_requirement",
+      "detail": "liblinuxcnchal.so.0 => not found"
+    },
+    {
+      "component": "linuxcncsvr",
+      "blocker": "dynamic_linker_requirement",
+      "detail": "libnml.so.0 => not found"
+    },
+    {
+      "component": "linuxcncsvr",
+      "blocker": "dynamic_linker_requirement",
+      "detail": "liblinuxcncini.so.1 => not found"
+    },
+    {
+      "component": "linuxcnc scripts/linuxcnc",
+      "blocker": "hardcoded_rip_environment_path_missing",
+      "detail": "/home/meswork/cnc_wams/wasm-port/../linuxcnc/scripts/linuxcnc: line 23: /home/cnc/桌面/cnc_wams/linuxcnc/scripts/rip-environment: No such file or directory"
+    }
+  ],
+  "ldd": {
+    "halcmd": {
+      "command": "ldd linuxcnc/bin/halcmd",
+      "status": 0,
+      "signal": null,
+      "stdout": "linuxcnc/bin/halcmd: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by linuxcnc/bin/halcmd)\n\tlinux-vdso.so.1 (0x00007ffe1df2d000)\n\tliblinuxcncini.so.1 => not found\n\tliblinuxcnchal.so.0 => not found\n\tlibedit.so.2 => /lib/x86_64-linux-gnu/libedit.so.2 (0x000077e6290a4000)\n\tlibstdc++.so.6 => /lib/x86_64-linux-gnu/libstdc++.so.6 (0x000077e628e00000)\n\tlibgcc_s.so.1 => /lib/x86_64-linux-gnu/libgcc_s.so.1 (0x000077e629084000)\n\tlibc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x000077e628a00000)\n\tlibtinfo.so.6 => /lib/x86_64-linux-gnu/libtinfo.so.6 (0x000077e629050000)\n\tlibbsd.so.0 => /lib/x86_64-linux-gnu/libbsd.so.0 (0x000077e629038000)\n\tlibm.so.6 => /lib/x86_64-linux-gnu/libm.so.6 (0x000077e628d19000)\n\t/lib64/ld-linux-x86-64.so.2 (0x000077e62910b000)\n\tlibmd.so.0 => /lib/x86_64-linux-gnu/libmd.so.0 (0x000077e628d0c000)\n",
+      "stderr": ""
+    },
+    "rs274": {
+      "command": "ldd linuxcnc/bin/rs274",
+      "status": 0,
+      "signal": null,
+      "stdout": "linuxcnc/bin/rs274: /lib/x86_64-linux-gnu/libstdc++.so.6: version `GLIBCXX_3.4.31' not found (required by linuxcnc/bin/rs274)\nlinuxcnc/bin/rs274: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by linuxcnc/bin/rs274)\n\tlinux-vdso.so.1 (0x00007ffd1ad98000)\n\tlibrs274.so.0 => not found\n\tlibnml.so.0 => not found\n\tliblinuxcnchal.so.0 => not found\n\tliblinuxcncini.so.1 => not found\n\tlibtooldata.so.0 => not found\n\tlibpython3.13.so.1.0 => not found\n\tlibedit.so.2 => /lib/x86_64-linux-gnu/libedit.so.2 (0x0000711e18f2f000)\n\tlibstdc++.so.6 => /lib/x86_64-linux-gnu/libstdc++.so.6 (0x0000711e18c00000)\n\tlibgcc_s.so.1 => /lib/x86_64-linux-gnu/libgcc_s.so.1 (0x0000711e18f0f000)\n\tlibc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x0000711e18800000)\n\tlibtinfo.so.6 => /lib/x86_64-linux-gnu/libtinfo.so.6 (0x0000711e18edd000)\n\tlibbsd.so.0 => /lib/x86_64-linux-gnu/libbsd.so.0 (0x0000711e18ec3000)\n\tlibm.so.6 => /lib/x86_64-linux-gnu/libm.so.6 (0x0000711e18b19000)\n\t/lib64/ld-linux-x86-64.so.2 (0x0000711e18fb9000)\n\tlibmd.so.0 => /lib/x86_64-linux-gnu/libmd.so.0 (0x0000711e18eb6000)\n",
+      "stderr": ""
+    },
+    "linuxcncsvr": {
+      "command": "ldd linuxcnc/bin/linuxcncsvr",
+      "status": 0,
+      "signal": null,
+      "stdout": "\tlinux-vdso.so.1 (0x00007ffe9c9d9000)\n\tliblinuxcnchal.so.0 => not found\n\tlibnml.so.0 => not found\n\tliblinuxcncini.so.1 => not found\n\tlibstdc++.so.6 => /lib/x86_64-linux-gnu/libstdc++.so.6 (0x000078425a200000)\n\tlibgcc_s.so.1 => /lib/x86_64-linux-gnu/libgcc_s.so.1 (0x000078425a52d000)\n\tlibc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x0000784259e00000)\n\tlibm.so.6 => /lib/x86_64-linux-gnu/libm.so.6 (0x000078425a444000)\n\t/lib64/ld-linux-x86-64.so.2 (0x000078425a56d000)\n",
+      "stderr": ""
+    }
+  },
+  "checks": [
+    {
+      "name": "phase0 native source/probe gate passes",
+      "pass": true,
+      "detail": "task_hal_phase0_native_probe_gate=ok"
+    },
+    {
+      "name": "native readiness audit passes",
+      "pass": true,
+      "detail": "native_task_hal_source_artifact_audit=ok | native_task_hal_readiness_artifact=web-rtcp-5axis-sim-plan/build/readiness/native-task-hal-readiness.json | task_hal_web_simulation_boundary_consistent=1 | native_task_hal_host_probe_status=ready_disabled_by_default | hardware_drive=0 | host_realtime_kernel=0 | external_user_m_process_ready=0 | tool_db_process_ready=0 | promotion_scope=web_simulation_only"
+    },
+    {
+      "name": "source manifest ready",
+      "pass": true,
+      "detail": "{\"task_hal_source_manifest_status\":\"ok\",\"task_hal_source_manifest_ready\":\"1\",\"task_hal_source_manifest_path\":\"/home/meswork/cnc_wams/wasm-port/tools/task-hal-source-manifest.txt\",\"task_hal_source_manifest_report\":\"/home/meswork/cnc_wams/wasm-port/build/task-hal/task-hal-source-manifest.tsv\",\"task_hal_source_count\":\"20\",\"task_source_count\":\"7\",\"hal_source_count\":\"4\",\"motion_source_count\":\"6\",\"nml_source_count\":\"1\",\"libnml_source_count\":\"2\",\"task_hal_reference_source_ready\":\"1\",\"task_hal_vendor_source_ready\":\"0\",\"task_hal_vendor_hash_match_ready\":\"1\",\"task_hal_missing_reference_source_count\":\"0\",\"task_hal_missing_reference_sources_ready\":\"1\",\"task_hal_missing_reference_source_list\":\"-\",\"task_hal_missing_vendor_source_list\":\"src/emc/task/task.hh,src/emc/task/taskclass.hh,src/emc/task/taskclass.cc,src/emc/task/emctask.cc,src/emc/task/emctaskmain.cc,src/emc/task/taskintf.cc,src/emc/task/emccanon.cc,src/emc/motion/usrmotintf.h,src/emc/motion/motion.c,src/emc/motion/command.c,src/emc/motion/control.c,src/hal/hal_lib.c,src/hal/hal_priv.h,src/hal/components/threads.c,src/hal/utils/halcmd_commands.cc\",\"task_hal_mismatched_vendor_source_list\":\"-\",\"task_hal_runtime_promoted\":\"0\",\"nativeTaskReady\":\"false\",\"nativeHalSyncReady\":\"false\"}"
+    },
+    {
+      "name": "TRT source proof ready",
+      "pass": true,
+      "detail": "{\"trt_task_hal_runtime_halcmd_path\":\"/home/meswork/cnc_wams/wasm-port/../linuxcnc/bin/halcmd\",\"trt_task_hal_runtime_linuxcnc_path\":\"/home/meswork/cnc_wams/wasm-port/../linuxcnc/scripts/linuxcnc\",\"trt_task_hal_runtime_requirements\":\"halcmd:1,linuxcnc:1\",\"trt_task_hal_missing_requirements\":\"-\",\"trt_task_hal_source_proof_ready\":\"1\",\"trt_task_hal_runtime_ready\":\"1\",\"trt_task_hal_execution_enabled\":\"0\",\"trt_task_hal_promotion_allowed\":\"0\",\"nativeTaskReady\":\"false\",\"nativeHalSyncReady\":\"false\",\"native_task_hal_probe\":\"ok\",\"native_probe_status\":\"ready_disabled_by_default\",\"trt_task_hal_runtime_probe_status\":\"ready_disabled_by_default\",\"trt_task_hal_runtime_probe_note\":\"set_ENABLE_TRT_TASK_HAL_RUNTIME_PROBE_1_to_run_exclusive_host_runtime_probe\"}"
+    },
+    {
+      "name": "host-native runtime blocker captured",
+      "pass": true,
+      "detail": "[{\"component\":\"halcmd\",\"blocker\":\"dynamic_linker_requirement\",\"detail\":\"linuxcnc/bin/halcmd: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by linuxcnc/bin/halcmd)\"},{\"component\":\"halcmd\",\"blocker\":\"dynamic_linker_requirement\",\"detail\":\"liblinuxcncini.so.1 => not found\"},{\"component\":\"halcmd\",\"blocker\":\"dynamic_linker_requirement\",\"detail\":\"liblinuxcnchal.so.0 => not found\"},{\"component\":\"rs274\",\"blocker\":\"dynamic_linker_requirement\",\"detail\":\"linuxcnc/bin/rs274: /lib/x86_64-linux-gnu/libstdc++.so.6: version `GLIBCXX_3.4.31' not found (required by linuxcnc/bin/rs274)\"},{\"component\":\"rs274\",\"blocker\":\"dynamic_linker_requirement\",\"detail\":\"linuxcnc/bin/rs274: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by linuxcnc/bin/rs274)\"},{\"component\":\"rs274\",\"blocker\":\"dynamic_linker_requirement\",\"detail\":\"librs274.so.0 => not found\"},{\"component\":\"rs274\",\"blocker\":\"dynamic_linker_requirement\",\"detail\":\"libnml.so.0 => not found\"},{\"component\":\"rs274\",\"blocker\":\"dynamic_linker_requirement\",\"detail\":\"liblinuxcnchal.so.0 => not found\"},{\"component\":\"rs274\",\"blocker\":\"dynamic_linker_requirement\",\"detail\":\"liblinuxcncini.so.1 => not found\"},{\"component\":\"rs274\",\"blocker\":\"dynamic_linker_requirement\",\"detail\":\"libtooldata.so.0 => not found\"},{\"component\":\"rs274\",\"blocker\":\"dynamic_linker_requirement\",\"detail\":\"libpython3.13.so.1.0 => not found\"},{\"component\":\"linuxcncsvr\",\"blocker\":\"dynamic_linker_requirement\",\"detail\":\"liblinuxcnchal.so.0 => not found\"},{\"component\":\"linuxcncsvr\",\"blocker\":\"dynamic_linker_requirement\",\"detail\":\"libnml.so.0 => not found\"},{\"component\":\"linuxcncsvr\",\"blocker\":\"dynamic_linker_requirement\",\"detail\":\"liblinuxcncini.so.1 => not found\"},{\"component\":\"linuxcnc scripts/linuxcnc\",\"blocker\":\"hardcoded_rip_environment_path_missing\",\"detail\":\"/home/meswork/cnc_wams/wasm-port/../linuxcnc/scripts/linuxcnc: line 23: /home/cnc/桌面/cnc_wams/linuxcnc/scripts/rip-environment: No such file or directory\"}]"
+    },
+    {
+      "name": "web simulation promotion remains bounded",
+      "pass": true,
+      "detail": "{\"task_hal_web_simulation_boundary_consistent\":1,\"native_task_hal_host_probe_status\":\"ready_disabled_by_default\",\"hardware_drive\":0,\"host_realtime_kernel\":0,\"external_user_m_process_ready\":0,\"tool_db_process_ready\":0,\"promotion_scope\":\"web_simulation_only\"}"
+    }
+  ],
+  "conclusion": {
+    "nativeTaskHalSourceComparisonReady": true,
+    "nativeTransitionLogAvailable": false,
+    "nativeTransitionLogBlockedByHostRuntime": true,
+    "reason": "Current host cannot start the LinuxCNC native TRT task/HAL runtime: generated LinuxCNC RIP scripts reference an old absolute path and binaries require unavailable host runtime libraries such as GLIBC_2.38/libpython3.13.",
+    "boundary": "This completes BTN-013 as an auditable native comparison and blocker record; it does not claim hardware drive, realtime kernel, external user-M process, or tool DB native runtime readiness."
+  }
+}

qa/web-rtcp-5axis-site-test/output/native-task-hal-comparison-report.md

@@ -0,0 +1,38 @@
+# Native task/HAL comparison report
+
+- status: PASS_WITH_HOST_NATIVE_RUNTIME_BLOCKER
+- generatedAt: 2026-06-23T09:22:56.110Z
+- JSON: /home/mes123456/cnc_wams/qa/web-rtcp-5axis-site-test/output/native-task-hal-comparison-report.json
+
+## Checks
+
+- PASS: phase0 native source/probe gate passes — task_hal_phase0_native_probe_gate=ok
+- PASS: native readiness audit passes — native_task_hal_source_artifact_audit=ok | native_task_hal_readiness_artifact=web-rtcp-5axis-sim-plan/build/readiness/native-task-hal-readiness.json | task_hal_web_simulation_boundary_consistent=1 | native_task_hal_host_probe_status=ready_disabled_by_default | hardware_drive=0 | host_realtime_kernel=0 | external_user_m_process_ready=0 | tool_db_process_ready=0 | promotion_scope=web_simulation_only
+- PASS: source manifest ready — {"task_hal_source_manifest_status":"ok","task_hal_source_manifest_ready":"1","task_hal_source_manifest_path":"/home/mes123456/cnc_wams/wasm-port/tools/task-hal-source-manifest.txt","task_hal_source_manifest_report":"/home/mes123456/cnc_wams/wasm-port/build/task-hal/task-hal-source-manifest.tsv","task_hal_source_count":"20","task_source_count":"7","hal_source_count":"4","motion_source_count":"6","nml_source_count":"1","libnml_source_count":"2","task_hal_reference_source_ready":"1","task_hal_vendor_source_ready":"0","task_hal_vendor_hash_match_ready":"1","task_hal_missing_reference_source_count":"0","task_hal_missing_reference_sources_ready":"1","task_hal_missing_reference_source_list":"-","task_hal_missing_vendor_source_list":"src/emc/task/task.hh,src/emc/task/taskclass.hh,src/emc/task/taskclass.cc,src/emc/task/emctask.cc,src/emc/task/emctaskmain.cc,src/emc/task/taskintf.cc,src/emc/task/emccanon.cc,src/emc/motion/usrmotintf.h,src/emc/motion/motion.c,src/emc/motion/command.c,src/emc/motion/control.c,src/hal/hal_lib.c,src/hal/hal_priv.h,src/hal/components/threads.c,src/hal/utils/halcmd_commands.cc","task_hal_mismatched_vendor_source_list":"-","task_hal_runtime_promoted":"0","nativeTaskReady":"false","nativeHalSyncReady":"false"}
+- PASS: TRT source proof ready — {"trt_task_hal_runtime_halcmd_path":"/home/mes123456/cnc_wams/wasm-port/../linuxcnc/bin/halcmd","trt_task_hal_runtime_linuxcnc_path":"/home/mes123456/cnc_wams/wasm-port/../linuxcnc/scripts/linuxcnc","trt_task_hal_runtime_requirements":"halcmd:1,linuxcnc:1","trt_task_hal_missing_requirements":"-","trt_task_hal_source_proof_ready":"1","trt_task_hal_runtime_ready":"1","trt_task_hal_execution_enabled":"0","trt_task_hal_promotion_allowed":"0","nativeTaskReady":"false","nativeHalSyncReady":"false","native_task_hal_probe":"ok","native_probe_status":"ready_disabled_by_default","trt_task_hal_runtime_probe_status":"ready_disabled_by_default","trt_task_hal_runtime_probe_note":"set_ENABLE_TRT_TASK_HAL_RUNTIME_PROBE_1_to_run_exclusive_host_runtime_probe"}
+- PASS: host-native runtime blocker captured — [{"component":"halcmd","blocker":"dynamic_linker_requirement","detail":"linuxcnc/bin/halcmd: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by linuxcnc/bin/halcmd)"},{"component":"halcmd","blocker":"dynamic_linker_requirement","detail":"liblinuxcncini.so.1 => not found"},{"component":"halcmd","blocker":"dynamic_linker_requirement","detail":"liblinuxcnchal.so.0 => not found"},{"component":"rs274","blocker":"dynamic_linker_requirement","detail":"linuxcnc/bin/rs274: /lib/x86_64-linux-gnu/libstdc++.so.6: version `GLIBCXX_3.4.31' not found (required by linuxcnc/bin/rs274)"},{"component":"rs274","blocker":"dynamic_linker_requirement","detail":"linuxcnc/bin/rs274: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by linuxcnc/bin/rs274)"},{"component":"rs274","blocker":"dynamic_linker_requirement","detail":"librs274.so.0 => not found"},{"component":"rs274","blocker":"dynamic_linker_requirement","detail":"libnml.so.0 => not found"},{"component":"rs274","blocker":"dynamic_linker_requirement","detail":"liblinuxcnchal.so.0 => not found"},{"component":"rs274","blocker":"dynamic_linker_requirement","detail":"liblinuxcncini.so.1 => not found"},{"component":"rs274","blocker":"dynamic_linker_requirement","detail":"libtooldata.so.0 => not found"},{"component":"rs274","blocker":"dynamic_linker_requirement","detail":"libpython3.13.so.1.0 => not found"},{"component":"linuxcncsvr","blocker":"dynamic_linker_requirement","detail":"liblinuxcnchal.so.0 => not found"},{"component":"linuxcncsvr","blocker":"dynamic_linker_requirement","detail":"libnml.so.0 => not found"},{"component":"linuxcncsvr","blocker":"dynamic_linker_requirement","detail":"liblinuxcncini.so.1 => not found"},{"component":"linuxcnc scripts/linuxcnc","blocker":"hardcoded_rip_environment_path_missing","detail":"/home/mes123456/cnc_wams/wasm-port/../linuxcnc/scripts/linuxcnc: line 23: /home/cnc/桌面/cnc_wams/linuxcnc/scripts/rip-environment: No such file or directory"}]
+- PASS: web simulation promotion remains bounded — {"task_hal_web_simulation_boundary_consistent":1,"native_task_hal_host_probe_status":"ready_disabled_by_default","hardware_drive":0,"host_realtime_kernel":0,"external_user_m_process_ready":0,"tool_db_process_ready":0,"promotion_scope":"web_simulation_only"}
+
+## Host Native Runtime Blockers
+
+- halcmd: dynamic_linker_requirement: linuxcnc/bin/halcmd: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by linuxcnc/bin/halcmd)
+- halcmd: dynamic_linker_requirement: liblinuxcncini.so.1 => not found
+- halcmd: dynamic_linker_requirement: liblinuxcnchal.so.0 => not found
+- rs274: dynamic_linker_requirement: linuxcnc/bin/rs274: /lib/x86_64-linux-gnu/libstdc++.so.6: version `GLIBCXX_3.4.31' not found (required by linuxcnc/bin/rs274)
+- rs274: dynamic_linker_requirement: linuxcnc/bin/rs274: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by linuxcnc/bin/rs274)
+- rs274: dynamic_linker_requirement: librs274.so.0 => not found
+- rs274: dynamic_linker_requirement: libnml.so.0 => not found
+- rs274: dynamic_linker_requirement: liblinuxcnchal.so.0 => not found
+- rs274: dynamic_linker_requirement: liblinuxcncini.so.1 => not found
+- rs274: dynamic_linker_requirement: libtooldata.so.0 => not found
+- rs274: dynamic_linker_requirement: libpython3.13.so.1.0 => not found
+- linuxcncsvr: dynamic_linker_requirement: liblinuxcnchal.so.0 => not found
+- linuxcncsvr: dynamic_linker_requirement: libnml.so.0 => not found
+- linuxcncsvr: dynamic_linker_requirement: liblinuxcncini.so.1 => not found
+- linuxcnc scripts/linuxcnc: hardcoded_rip_environment_path_missing: /home/mes123456/cnc_wams/wasm-port/../linuxcnc/scripts/linuxcnc: line 23: /home/cnc/桌面/cnc_wams/linuxcnc/scripts/rip-environment: No such file or directory
+
+## Conclusion
+
+Current host cannot start the LinuxCNC native TRT task/HAL runtime: generated LinuxCNC RIP scripts reference an old absolute path and binaries require unavailable host runtime libraries such as GLIBC_2.38/libpython3.13.
+
+This completes BTN-013 as an auditable native comparison and blocker record; it does not claim hardware drive, realtime kernel, external user-M process, or tool DB native runtime readiness.

qa/web-rtcp-5axis-site-test/output/run-preconditions-feedback.json

@@ -0,0 +1,565 @@
+{
+  "generatedAt": "2026-06-22T22:10:40.219Z",
+  "targetUrl": "http://127.0.0.1:45757/web-rtcp-5axis-sim-plan/app/index.html",
+  "caseName": "07-run-preconditions-and-feedback",
+  "summary": "浏览器 RUN 证据：INI/profile/kinematics/task-HAL 同一上下文，taskHalStatusLoop 持续推进，UI 消费 task/HAL/motion feedback",
+  "status": "PASS",
+  "checks": [
+    {
+      "name": "INI ready",
+      "pass": true,
+      "detail": "iniReady=true,true,true,true,true"
+    },
+    {
+      "name": "selected LinuxCNC G-code",
+      "pass": true,
+      "detail": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/xyzac_switchkins_test_1.ngc"
+    },
+    {
+      "name": "task/HAL session opened selected G-code",
+      "pass": true,
+      "detail": "/work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/xyzac_switchkins_test_1.ngc"
+    },
+    {
+      "name": "taskHalStatusLoop 新 RUN sequence",
+      "pass": true,
+      "detail": "baselineSequence=1, sequences=2,2,2,2,2"
+    },
+    {
+      "name": "taskHalStatusLoop 本次 RUN tickCount",
+      "pass": true,
+      "detail": "ticks=4,4,4,4,4"
+    },
+    {
+      "name": "programRuntimeFeedbackHistory 本次 RUN 采样",
+      "pass": true,
+      "detail": "history=5,5,5,5,5"
+    },
+    {
+      "name": "feedback sourceMode 来自 task/HAL",
+      "pass": true,
+      "detail": "sourceModes=linuxcnc-task-motion-hal-wasm,linuxcnc-task-motion-hal-wasm,linuxcnc-task-motion-hal-wasm,linuxcnc-task-motion-hal-wasm,linuxcnc-task-motion-hal-wasm"
+    },
+    {
+      "name": "无 fixture-line-playback feedback",
+      "pass": true,
+      "detail": "sourceModes=linuxcnc-task-motion-hal-wasm,linuxcnc-task-motion-hal-wasm,linuxcnc-task-motion-hal-wasm,linuxcnc-task-motion-hal-wasm,linuxcnc-task-motion-hal-wasm"
+    },
+    {
+      "name": "semantic boundary",
+      "pass": true,
+      "detail": "linuxcnc_task_motion_hal_wasm_simulation_runtime,linuxcnc_task_motion_hal_wasm_simulation_runtime,linuxcnc_task_motion_hal_wasm_simulation_runtime,linuxcnc_task_motion_hal_wasm_simulation_runtime,linuxcnc_task_motion_hal_wasm_simulation_runtime"
+    },
+    {
+      "name": "activeLine 等于 UI 高亮行",
+      "pass": true,
+      "detail": "active=29/29,29/29,29/29,29/29,29/29"
+    },
+    {
+      "name": "DRO 等于 runtime feedback axisPose",
+      "pass": true,
+      "detail": "droMatchesFeedback=true for all samples"
+    },
+    {
+      "name": "RTCP canvas 与 state 一致",
+      "pass": true,
+      "detail": "off/off,off/off,off/off,off/off,off/off"
+    },
+    {
+      "name": "runtime cycle 可见",
+      "pass": true,
+      "detail": "33/330,33/330,33/330,33/330,33/330"
+    },
+    {
+      "name": "canvas 执行轨迹",
+      "pass": true,
+      "detail": "true/1/ok,true/1/ok,true/1/ok,true/1/ok,true/1/ok"
+    }
+  ],
+  "baseline": {
+    "elapsedMs": 0,
+    "screenshotPath": "/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/screenshots/run-preconditions-feedback/07-run-preconditions-and-feedback-0000ms-before-run.png",
+    "canvas": {
+      "threeReady": "true",
+      "rtcpState": "off",
+      "executedPathPoints": 1,
+      "currentSegmentHighlight": "ok",
+      "toolExecutionTraceSource": "linuxcnc_tp_samples_or_task_motion_hal_feedback"
+    },
+    "state": {
+      "profileId": "xyzac-trt",
+      "iniReady": true,
+      "iniPath": "configs/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt.ini",
+      "coordinates": "XYZAC",
+      "kinematicsModuleId": "xyzac-trt",
+      "selectedGcodeSourceRel": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/xyzac_switchkins_test_1.ngc",
+      "taskHalSessionProgramPath": "/work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/xyzac_switchkins_test_1.ngc",
+      "taskHalStatusLoop": {
+        "apiName": "web-rtcp-5axis-task-hal-status-loop",
+        "active": false,
+        "sequence": 1,
+        "profileId": "xyzac-trt",
+        "iniPath": "configs/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt.ini",
+        "kinematicsModuleId": "xyzac-trt",
+        "tickCount": 12,
+        "batchSize": 5,
+        "intervalMs": 25,
+        "taskPeriodNs": 10000000,
+        "servoPeriodNs": 1000000,
+        "lastStatusAt": "2026-06-22T22:10:27.362Z",
+        "lastError": null,
+        "stopReason": "running",
+        "semanticBoundary": "js_status_polling_loop_for_linuxcnc_task_hal_motion_status"
+      },
+      "runState": "idle",
+      "activeLine": 1,
+      "activeRowLine": 1,
+      "activeLineMatchesUi": true,
+      "droAxisPose": {
+        "x": 0,
+        "y": 0,
+        "z": 0,
+        "a": 0,
+        "b": 0,
+        "c": 0
+      },
+      "feedbackAxisPose": {
+        "x": 0,
+        "y": 0,
+        "z": 0,
+        "a": 0,
+        "b": 0,
+        "c": 0
+      },
+      "droMatchesFeedback": true,
+      "rtcpState": "off",
+      "kinsType": "identity",
+      "feedback": {
+        "sourceMode": "linuxcnc-task-motion-hal-wasm",
+        "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+        "line": 1,
+        "taskCycle": 3,
+        "servoCycle": 30,
+        "velocity": 0,
+        "distanceToGo": 0
+      },
+      "feedbackHistoryLength": 18,
+      "feedbackHistorySourceModes": [
+        "linuxcnc-task-motion-hal-wasm"
+      ],
+      "taskHalStatus": {
+        "taskState": "on",
+        "taskMode": "auto",
+        "interpState": "idle",
+        "taskCycle": null,
+        "servoCycle": 30
+      }
+    }
+  },
+  "samples": [
+    {
+      "elapsedMs": 200,
+      "screenshotPath": "/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/screenshots/run-preconditions-feedback/07-run-preconditions-and-feedback-200ms.png",
+      "canvas": {
+        "threeReady": "true",
+        "rtcpState": "off",
+        "executedPathPoints": 1,
+        "currentSegmentHighlight": "ok",
+        "toolExecutionTraceSource": "linuxcnc_tp_samples_or_task_motion_hal_feedback"
+      },
+      "state": {
+        "profileId": "xyzac-trt",
+        "iniReady": true,
+        "iniPath": "configs/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt.ini",
+        "coordinates": "XYZAC",
+        "kinematicsModuleId": "xyzac-trt",
+        "selectedGcodeSourceRel": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/xyzac_switchkins_test_1.ngc",
+        "taskHalSessionProgramPath": "/work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/xyzac_switchkins_test_1.ngc",
+        "taskHalStatusLoop": {
+          "apiName": "web-rtcp-5axis-task-hal-status-loop",
+          "active": false,
+          "sequence": 2,
+          "profileId": "xyzac-trt",
+          "iniPath": "configs/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt.ini",
+          "kinematicsModuleId": "xyzac-trt",
+          "tickCount": 4,
+          "batchSize": 5,
+          "intervalMs": 25,
+          "taskPeriodNs": 10000000,
+          "servoPeriodNs": 1000000,
+          "lastStatusAt": "2026-06-22T22:10:35.152Z",
+          "lastError": null,
+          "stopReason": "complete",
+          "semanticBoundary": "js_status_polling_loop_for_linuxcnc_task_hal_motion_status"
+        },
+        "runState": "complete",
+        "activeLine": 29,
+        "activeRowLine": 29,
+        "activeLineMatchesUi": true,
+        "droAxisPose": {
+          "x": 0,
+          "y": 0,
+          "z": 0,
+          "a": 0,
+          "b": 0,
+          "c": 0
+        },
+        "feedbackAxisPose": {
+          "x": 0,
+          "y": 0,
+          "z": 0,
+          "a": 0,
+          "b": 0,
+          "c": 0
+        },
+        "droMatchesFeedback": true,
+        "rtcpState": "off",
+        "kinsType": "identity",
+        "feedback": {
+          "sourceMode": "linuxcnc-task-motion-hal-wasm",
+          "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+          "line": 29,
+          "taskCycle": 33,
+          "servoCycle": 330,
+          "velocity": 3600,
+          "distanceToGo": 0
+        },
+        "feedbackHistoryLength": 5,
+        "feedbackHistorySourceModes": [
+          "linuxcnc-task-motion-hal-wasm"
+        ],
+        "taskHalStatus": {
+          "taskState": "on",
+          "taskMode": "auto",
+          "interpState": "idle",
+          "taskCycle": null,
+          "servoCycle": 330
+        }
+      }
+    },
+    {
+      "elapsedMs": 500,
+      "screenshotPath": "/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/screenshots/run-preconditions-feedback/07-run-preconditions-and-feedback-500ms.png",
+      "canvas": {
+        "threeReady": "true",
+        "rtcpState": "off",
+        "executedPathPoints": 1,
+        "currentSegmentHighlight": "ok",
+        "toolExecutionTraceSource": "linuxcnc_tp_samples_or_task_motion_hal_feedback"
+      },
+      "state": {
+        "profileId": "xyzac-trt",
+        "iniReady": true,
+        "iniPath": "configs/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt.ini",
+        "coordinates": "XYZAC",
+        "kinematicsModuleId": "xyzac-trt",
+        "selectedGcodeSourceRel": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/xyzac_switchkins_test_1.ngc",
+        "taskHalSessionProgramPath": "/work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/xyzac_switchkins_test_1.ngc",
+        "taskHalStatusLoop": {
+          "apiName": "web-rtcp-5axis-task-hal-status-loop",
+          "active": false,
+          "sequence": 2,
+          "profileId": "xyzac-trt",
+          "iniPath": "configs/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt.ini",
+          "kinematicsModuleId": "xyzac-trt",
+          "tickCount": 4,
+          "batchSize": 5,
+          "intervalMs": 25,
+          "taskPeriodNs": 10000000,
+          "servoPeriodNs": 1000000,
+          "lastStatusAt": "2026-06-22T22:10:35.152Z",
+          "lastError": null,
+          "stopReason": "complete",
+          "semanticBoundary": "js_status_polling_loop_for_linuxcnc_task_hal_motion_status"
+        },
+        "runState": "complete",
+        "activeLine": 29,
+        "activeRowLine": 29,
+        "activeLineMatchesUi": true,
+        "droAxisPose": {
+          "x": 0,
+          "y": 0,
+          "z": 0,
+          "a": 0,
+          "b": 0,
+          "c": 0
+        },
+        "feedbackAxisPose": {
+          "x": 0,
+          "y": 0,
+          "z": 0,
+          "a": 0,
+          "b": 0,
+          "c": 0
+        },
+        "droMatchesFeedback": true,
+        "rtcpState": "off",
+        "kinsType": "identity",
+        "feedback": {
+          "sourceMode": "linuxcnc-task-motion-hal-wasm",
+          "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+          "line": 29,
+          "taskCycle": 33,
+          "servoCycle": 330,
+          "velocity": 3600,
+          "distanceToGo": 0
+        },
+        "feedbackHistoryLength": 5,
+        "feedbackHistorySourceModes": [
+          "linuxcnc-task-motion-hal-wasm"
+        ],
+        "taskHalStatus": {
+          "taskState": "on",
+          "taskMode": "auto",
+          "interpState": "idle",
+          "taskCycle": null,
+          "servoCycle": 330
+        }
+      }
+    },
+    {
+      "elapsedMs": 1000,
+      "screenshotPath": "/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/screenshots/run-preconditions-feedback/07-run-preconditions-and-feedback-1000ms.png",
+      "canvas": {
+        "threeReady": "true",
+        "rtcpState": "off",
+        "executedPathPoints": 1,
+        "currentSegmentHighlight": "ok",
+        "toolExecutionTraceSource": "linuxcnc_tp_samples_or_task_motion_hal_feedback"
+      },
+      "state": {
+        "profileId": "xyzac-trt",
+        "iniReady": true,
+        "iniPath": "configs/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt.ini",
+        "coordinates": "XYZAC",
+        "kinematicsModuleId": "xyzac-trt",
+        "selectedGcodeSourceRel": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/xyzac_switchkins_test_1.ngc",
+        "taskHalSessionProgramPath": "/work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/xyzac_switchkins_test_1.ngc",
+        "taskHalStatusLoop": {
+          "apiName": "web-rtcp-5axis-task-hal-status-loop",
+          "active": false,
+          "sequence": 2,
+          "profileId": "xyzac-trt",
+          "iniPath": "configs/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt.ini",
+          "kinematicsModuleId": "xyzac-trt",
+          "tickCount": 4,
+          "batchSize": 5,
+          "intervalMs": 25,
+          "taskPeriodNs": 10000000,
+          "servoPeriodNs": 1000000,
+          "lastStatusAt": "2026-06-22T22:10:35.152Z",
+          "lastError": null,
+          "stopReason": "complete",
+          "semanticBoundary": "js_status_polling_loop_for_linuxcnc_task_hal_motion_status"
+        },
+        "runState": "complete",
+        "activeLine": 29,
+        "activeRowLine": 29,
+        "activeLineMatchesUi": true,
+        "droAxisPose": {
+          "x": 0,
+          "y": 0,
+          "z": 0,
+          "a": 0,
+          "b": 0,
+          "c": 0
+        },
+        "feedbackAxisPose": {
+          "x": 0,
+          "y": 0,
+          "z": 0,
+          "a": 0,
+          "b": 0,
+          "c": 0
+        },
+        "droMatchesFeedback": true,
+        "rtcpState": "off",
+        "kinsType": "identity",
+        "feedback": {
+          "sourceMode": "linuxcnc-task-motion-hal-wasm",
+          "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+          "line": 29,
+          "taskCycle": 33,
+          "servoCycle": 330,
+          "velocity": 3600,
+          "distanceToGo": 0
+        },
+        "feedbackHistoryLength": 5,
+        "feedbackHistorySourceModes": [
+          "linuxcnc-task-motion-hal-wasm"
+        ],
+        "taskHalStatus": {
+          "taskState": "on",
+          "taskMode": "auto",
+          "interpState": "idle",
+          "taskCycle": null,
+          "servoCycle": 330
+        }
+      }
+    },
+    {
+      "elapsedMs": 2000,
+      "screenshotPath": "/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/screenshots/run-preconditions-feedback/07-run-preconditions-and-feedback-2000ms.png",
+      "canvas": {
+        "threeReady": "true",
+        "rtcpState": "off",
+        "executedPathPoints": 1,
+        "currentSegmentHighlight": "ok",
+        "toolExecutionTraceSource": "linuxcnc_tp_samples_or_task_motion_hal_feedback"
+      },
+      "state": {
+        "profileId": "xyzac-trt",
+        "iniReady": true,
+        "iniPath": "configs/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt.ini",
+        "coordinates": "XYZAC",
+        "kinematicsModuleId": "xyzac-trt",
+        "selectedGcodeSourceRel": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/xyzac_switchkins_test_1.ngc",
+        "taskHalSessionProgramPath": "/work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/xyzac_switchkins_test_1.ngc",
+        "taskHalStatusLoop": {
+          "apiName": "web-rtcp-5axis-task-hal-status-loop",
+          "active": false,
+          "sequence": 2,
+          "profileId": "xyzac-trt",
+          "iniPath": "configs/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt.ini",
+          "kinematicsModuleId": "xyzac-trt",
+          "tickCount": 4,
+          "batchSize": 5,
+          "intervalMs": 25,
+          "taskPeriodNs": 10000000,
+          "servoPeriodNs": 1000000,
+          "lastStatusAt": "2026-06-22T22:10:35.152Z",
+          "lastError": null,
+          "stopReason": "complete",
+          "semanticBoundary": "js_status_polling_loop_for_linuxcnc_task_hal_motion_status"
+        },
+        "runState": "complete",
+        "activeLine": 29,
+        "activeRowLine": 29,
+        "activeLineMatchesUi": true,
+        "droAxisPose": {
+          "x": 0,
+          "y": 0,
+          "z": 0,
+          "a": 0,
+          "b": 0,
+          "c": 0
+        },
+        "feedbackAxisPose": {
+          "x": 0,
+          "y": 0,
+          "z": 0,
+          "a": 0,
+          "b": 0,
+          "c": 0
+        },
+        "droMatchesFeedback": true,
+        "rtcpState": "off",
+        "kinsType": "identity",
+        "feedback": {
+          "sourceMode": "linuxcnc-task-motion-hal-wasm",
+          "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+          "line": 29,
+          "taskCycle": 33,
+          "servoCycle": 330,
+          "velocity": 3600,
+          "distanceToGo": 0
+        },
+        "feedbackHistoryLength": 5,
+        "feedbackHistorySourceModes": [
+          "linuxcnc-task-motion-hal-wasm"
+        ],
+        "taskHalStatus": {
+          "taskState": "on",
+          "taskMode": "auto",
+          "interpState": "idle",
+          "taskCycle": null,
+          "servoCycle": 330
+        }
+      }
+    },
+    {
+      "elapsedMs": 5000,
+      "screenshotPath": "/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/screenshots/run-preconditions-feedback/07-run-preconditions-and-feedback-5000ms.png",
+      "canvas": {
+        "threeReady": "true",
+        "rtcpState": "off",
+        "executedPathPoints": 1,
+        "currentSegmentHighlight": "ok",
+        "toolExecutionTraceSource": "linuxcnc_tp_samples_or_task_motion_hal_feedback"
+      },
+      "state": {
+        "profileId": "xyzac-trt",
+        "iniReady": true,
+        "iniPath": "configs/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt.ini",
+        "coordinates": "XYZAC",
+        "kinematicsModuleId": "xyzac-trt",
+        "selectedGcodeSourceRel": "configs/sim/axis/vismach/5axis/table-rotary-tilting/demos/xyzac_switchkins_test_1.ngc",
+        "taskHalSessionProgramPath": "/work/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt/demos/xyzac_switchkins_test_1.ngc",
+        "taskHalStatusLoop": {
+          "apiName": "web-rtcp-5axis-task-hal-status-loop",
+          "active": false,
+          "sequence": 2,
+          "profileId": "xyzac-trt",
+          "iniPath": "configs/sim/axis/vismach/5axis/table-rotary-tilting/xyzac-trt.ini",
+          "kinematicsModuleId": "xyzac-trt",
+          "tickCount": 4,
+          "batchSize": 5,
+          "intervalMs": 25,
+          "taskPeriodNs": 10000000,
+          "servoPeriodNs": 1000000,
+          "lastStatusAt": "2026-06-22T22:10:35.152Z",
+          "lastError": null,
+          "stopReason": "complete",
+          "semanticBoundary": "js_status_polling_loop_for_linuxcnc_task_hal_motion_status"
+        },
+        "runState": "complete",
+        "activeLine": 29,
+        "activeRowLine": 29,
+        "activeLineMatchesUi": true,
+        "droAxisPose": {
+          "x": 0,
+          "y": 0,
+          "z": 0,
+          "a": 0,
+          "b": 0,
+          "c": 0
+        },
+        "feedbackAxisPose": {
+          "x": 0,
+          "y": 0,
+          "z": 0,
+          "a": 0,
+          "b": 0,
+          "c": 0
+        },
+        "droMatchesFeedback": true,
+        "rtcpState": "off",
+        "kinsType": "identity",
+        "feedback": {
+          "sourceMode": "linuxcnc-task-motion-hal-wasm",
+          "semanticBoundary": "linuxcnc_task_motion_hal_wasm_simulation_runtime",
+          "line": 29,
+          "taskCycle": 33,
+          "servoCycle": 330,
+          "velocity": 3600,
+          "distanceToGo": 0
+        },
+        "feedbackHistoryLength": 5,
+        "feedbackHistorySourceModes": [
+          "linuxcnc-task-motion-hal-wasm"
+        ],
+        "taskHalStatus": {
+          "taskState": "on",
+          "taskMode": "auto",
+          "interpState": "idle",
+          "taskCycle": null,
+          "servoCycle": 330
+        }
+      }
+    }
+  ],
+  "consoleErrors": [
+    "Failed to load resource: the server responded with a status of 404 (Not Found)",
+    "Failed to load resource: the server responded with a status of 404 (Not Found)"
+  ]
+}

qa/web-rtcp-5axis-site-test/package-lock.json

@@ -0,0 +1,516 @@
+{
+  "name": "web-rtcp-5axis-site-test",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "web-rtcp-5axis-site-test",
+      "version": "1.0.0",
+      "license": "ISC",
+      "dependencies": {
+        "docx": "^9.7.1",
+        "pngjs": "^7.0.0",
+        "puppeteer-core": "^25.1.0"
+      }
+    },
+    "node_modules/@puppeteer/browsers": {
+      "version": "3.0.4",
+      "resolved": "https://registry.npmjs.org/@puppeteer/browsers/-/browsers-3.0.4.tgz",
+      "integrity": "sha512-HGM8iAmGTf+Y7t0373szVbTmt3d7vPkYL/1bpOkOFO0YUYLgSeuYBCzESklogNPvOBnZ/MRD5f07OkpqH1trtA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "modern-tar": "^0.7.6",
+        "yargs": "^17.7.2"
+      },
+      "bin": {
+        "browsers": "lib/main-cli.js"
+      },
+      "engines": {
+        "node": ">=22.12.0"
+      },
+      "peerDependencies": {
+        "proxy-agent": ">=8.0.1"
+      },
+      "peerDependenciesMeta": {
+        "proxy-agent": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@types/node": {
+      "version": "25.9.4",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-25.9.4.tgz",
+      "integrity": "sha512-dszCsrKb5U7ZsVZBWiHFklTloVl0mSEnWH/iZXfZUlI4rzCUnsvGmgqfuVRHL54ugE7/wRuxEIXRa2iMZ+BG6g==",
+      "license": "MIT",
+      "dependencies": {
+        "undici-types": ">=7.24.0 <7.24.7"
+      }
+    },
+    "node_modules/ansi-regex": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/ansi-styles": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+      "license": "MIT",
+      "dependencies": {
+        "color-convert": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/chromium-bidi": {
+      "version": "16.0.1",
+      "resolved": "https://registry.npmjs.org/chromium-bidi/-/chromium-bidi-16.0.1.tgz",
+      "integrity": "sha512-J63PGu/9PpeCwLIcKYyzWP6yaVL5pxuBc0shlYCYM8BaAkmlwiQboXO1iNbOgSDbVklEyYFfNEcHD8oOAWacUA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "mitt": "^3.0.1",
+        "zod": "^3.24.1"
+      },
+      "engines": {
+        "node": ">=20.19.0 <22.0.0 || >=22.12.0"
+      },
+      "peerDependencies": {
+        "devtools-protocol": "*"
+      }
+    },
+    "node_modules/cliui": {
+      "version": "8.0.1",
+      "resolved": "https://registry.npmjs.org/cliui/-/cliui-8.0.1.tgz",
+      "integrity": "sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==",
+      "license": "ISC",
+      "dependencies": {
+        "string-width": "^4.2.0",
+        "strip-ansi": "^6.0.1",
+        "wrap-ansi": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/color-convert": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
+      "license": "MIT",
+      "dependencies": {
+        "color-name": "~1.1.4"
+      },
+      "engines": {
+        "node": ">=7.0.0"
+      }
+    },
+    "node_modules/color-name": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
+      "license": "MIT"
+    },
+    "node_modules/core-util-is": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz",
+      "integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==",
+      "license": "MIT"
+    },
+    "node_modules/devtools-protocol": {
+      "version": "0.0.1624250",
+      "resolved": "https://registry.npmjs.org/devtools-protocol/-/devtools-protocol-0.0.1624250.tgz",
+      "integrity": "sha512-YFAat/lOiIk0ARmBweG+ygrEcbZrq5B9urRyUoeQKp53MlidHXE2TmTbxKcaXoQj7u/aX+jebDO4BW55rs0WwA==",
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/docx": {
+      "version": "9.7.1",
+      "resolved": "https://registry.npmjs.org/docx/-/docx-9.7.1.tgz",
+      "integrity": "sha512-ilXFf9Moz47ABjFpDiA5s1w9lpb4EFSp7+5iiJSbfyYDM+bpZdAgLlSr7fW4aXhVe/E+F6QCv0EvRVFEd5CsWg==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "^25.2.3",
+        "hash.js": "^1.1.7",
+        "jszip": "^3.10.1",
+        "nanoid": "^5.1.3",
+        "xml": "^1.0.1",
+        "xml-js": "^1.6.8"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/emoji-regex": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
+      "license": "MIT"
+    },
+    "node_modules/escalade": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",
+      "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/get-caller-file": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz",
+      "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==",
+      "license": "ISC",
+      "engines": {
+        "node": "6.* || 8.* || >= 10.*"
+      }
+    },
+    "node_modules/hash.js": {
+      "version": "1.1.7",
+      "resolved": "https://registry.npmjs.org/hash.js/-/hash.js-1.1.7.tgz",
+      "integrity": "sha512-taOaskGt4z4SOANNseOviYDvjEJinIkRgmp7LbKP2YTTmVxWBl87s/uzK9r+44BclBSp2X7K1hqeNfz9JbBeXA==",
+      "license": "MIT",
+      "dependencies": {
+        "inherits": "^2.0.3",
+        "minimalistic-assert": "^1.0.1"
+      }
+    },
+    "node_modules/immediate": {
+      "version": "3.0.6",
+      "resolved": "https://registry.npmjs.org/immediate/-/immediate-3.0.6.tgz",
+      "integrity": "sha512-XXOFtyqDjNDAQxVfYxuF7g9Il/IbWmmlQg2MYKOH8ExIT1qg6xc4zyS3HaEEATgs1btfzxq15ciUiY7gjSXRGQ==",
+      "license": "MIT"
+    },
+    "node_modules/inherits": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
+      "license": "ISC"
+    },
+    "node_modules/is-fullwidth-code-point": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
+      "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/isarray": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
+      "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==",
+      "license": "MIT"
+    },
+    "node_modules/jszip": {
+      "version": "3.10.1",
+      "resolved": "https://registry.npmjs.org/jszip/-/jszip-3.10.1.tgz",
+      "integrity": "sha512-xXDvecyTpGLrqFrvkrUSoxxfJI5AH7U8zxxtVclpsUtMCq4JQ290LY8AW5c7Ggnr/Y/oK+bQMbqK2qmtk3pN4g==",
+      "license": "(MIT OR GPL-3.0-or-later)",
+      "dependencies": {
+        "lie": "~3.3.0",
+        "pako": "~1.0.2",
+        "readable-stream": "~2.3.6",
+        "setimmediate": "^1.0.5"
+      }
+    },
+    "node_modules/lie": {
+      "version": "3.3.0",
+      "resolved": "https://registry.npmjs.org/lie/-/lie-3.3.0.tgz",
+      "integrity": "sha512-UaiMJzeWRlEujzAuw5LokY1L5ecNQYZKfmyZ9L7wDHb/p5etKaxXhohBcrw0EYby+G/NA52vRSN4N39dxHAIwQ==",
+      "license": "MIT",
+      "dependencies": {
+        "immediate": "~3.0.5"
+      }
+    },
+    "node_modules/minimalistic-assert": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/minimalistic-assert/-/minimalistic-assert-1.0.1.tgz",
+      "integrity": "sha512-UtJcAD4yEaGtjPezWuO9wC4nwUnVH/8/Im3yEHQP4b67cXlD/Qr9hdITCU1xDbSEXg2XKNaP8jsReV7vQd00/A==",
+      "license": "ISC"
+    },
+    "node_modules/mitt": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/mitt/-/mitt-3.0.1.tgz",
+      "integrity": "sha512-vKivATfr97l2/QBCYAkXYDbrIWPM2IIKEl7YPhjCvKlG3kE2gm+uBo6nEXK3M5/Ffh/FLpKExzOQ3JJoJGFKBw==",
+      "license": "MIT"
+    },
+    "node_modules/modern-tar": {
+      "version": "0.7.6",
+      "resolved": "https://registry.npmjs.org/modern-tar/-/modern-tar-0.7.6.tgz",
+      "integrity": "sha512-sweCIVXzx1aIGTCdzcMlSZt1h8k5Tmk08VNAuRk3IU28XamGiOH5ypi11g6De2CH7PhYqSSnGy2A/EFhbWnVKg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/nanoid": {
+      "version": "5.1.15",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-5.1.15.tgz",
+      "integrity": "sha512-kBg3RpGtIe+RpTbyXwoI6pk5yD7KUiI3sygUqgeBMRst42KmhB4RZC7eiO9Wa1HIpaCCtpE2DJ6OI4Wi5ebwFw==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "bin": {
+        "nanoid": "bin/nanoid.js"
+      },
+      "engines": {
+        "node": "^18 || >=20"
+      }
+    },
+    "node_modules/pako": {
+      "version": "1.0.11",
+      "resolved": "https://registry.npmjs.org/pako/-/pako-1.0.11.tgz",
+      "integrity": "sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw==",
+      "license": "(MIT AND Zlib)"
+    },
+    "node_modules/pngjs": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/pngjs/-/pngjs-7.0.0.tgz",
+      "integrity": "sha512-LKWqWJRhstyYo9pGvgor/ivk2w94eSjE3RGVuzLGlr3NmD8bf7RcYGze1mNdEHRP6TRP6rMuDHk5t44hnTRyow==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=14.19.0"
+      }
+    },
+    "node_modules/process-nextick-args": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz",
+      "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==",
+      "license": "MIT"
+    },
+    "node_modules/puppeteer-core": {
+      "version": "25.1.0",
+      "resolved": "https://registry.npmjs.org/puppeteer-core/-/puppeteer-core-25.1.0.tgz",
+      "integrity": "sha512-jKzy5y4WG6uNuFbTWgW1D7mqoT9o0nllc/6a1DGF775T1mPmgw3scdFEtEq67yVFikavQmbYq6NLfbTfxHSlqQ==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@puppeteer/browsers": "3.0.4",
+        "chromium-bidi": "16.0.1",
+        "devtools-protocol": "0.0.1624250",
+        "typed-query-selector": "^2.12.2",
+        "webdriver-bidi-protocol": "0.4.2",
+        "ws": "^8.21.0"
+      },
+      "engines": {
+        "node": ">=22.12.0"
+      }
+    },
+    "node_modules/readable-stream": {
+      "version": "2.3.8",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz",
+      "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==",
+      "license": "MIT",
+      "dependencies": {
+        "core-util-is": "~1.0.0",
+        "inherits": "~2.0.3",
+        "isarray": "~1.0.0",
+        "process-nextick-args": "~2.0.0",
+        "safe-buffer": "~5.1.1",
+        "string_decoder": "~1.1.1",
+        "util-deprecate": "~1.0.1"
+      }
+    },
+    "node_modules/require-directory": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz",
+      "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/safe-buffer": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",
+      "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==",
+      "license": "MIT"
+    },
+    "node_modules/sax": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/sax/-/sax-1.6.0.tgz",
+      "integrity": "sha512-6R3J5M4AcbtLUdZmRv2SygeVaM7IhrLXu9BmnOGmmACak8fiUtOsYNWUS4uK7upbmHIBbLBeFeI//477BKLBzA==",
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=11.0.0"
+      }
+    },
+    "node_modules/setimmediate": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/setimmediate/-/setimmediate-1.0.5.tgz",
+      "integrity": "sha512-MATJdZp8sLqDl/68LfQmbP8zKPLQNV6BIZoIgrscFDQ+RsvK/BxeDQOgyxKKoh0y/8h3BqVFnCqQ/gd+reiIXA==",
+      "license": "MIT"
+    },
+    "node_modules/string_decoder": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz",
+      "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==",
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "~5.1.0"
+      }
+    },
+    "node_modules/string-width": {
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+      "license": "MIT",
+      "dependencies": {
+        "emoji-regex": "^8.0.0",
+        "is-fullwidth-code-point": "^3.0.0",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-ansi": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/typed-query-selector": {
+      "version": "2.12.2",
+      "resolved": "https://registry.npmjs.org/typed-query-selector/-/typed-query-selector-2.12.2.tgz",
+      "integrity": "sha512-EOPFbyIub4ngnEdqi2yOcNeDLaX/0jcE1JoAXQDDMIthap7FoN795lc/SHfIq2d416VufXpM8z/lD+WRm2gfOQ==",
+      "license": "MIT"
+    },
+    "node_modules/undici-types": {
+      "version": "7.24.6",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.24.6.tgz",
+      "integrity": "sha512-WRNW+sJgj5OBN4/0JpHFqtqzhpbnV0GuB+OozA9gCL7a993SmU+1JBZCzLNxYsbMfIeDL+lTsphD5jN5N+n0zg==",
+      "license": "MIT"
+    },
+    "node_modules/util-deprecate": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
+      "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
+      "license": "MIT"
+    },
+    "node_modules/webdriver-bidi-protocol": {
+      "version": "0.4.2",
+      "resolved": "https://registry.npmjs.org/webdriver-bidi-protocol/-/webdriver-bidi-protocol-0.4.2.tgz",
+      "integrity": "sha512-VSV+fzfChirL3e7jay2yUC7B4HQCGtEWEg/MSSQbK+qWbqeGlRLlXTzPpYr3XGUvbpDHumWZBJxgesg4N7dbtA==",
+      "license": "Apache-2.0"
+    },
+    "node_modules/wrap-ansi": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
+      "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^4.0.0",
+        "string-width": "^4.1.0",
+        "strip-ansi": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
+    "node_modules/ws": {
+      "version": "8.21.0",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.21.0.tgz",
+      "integrity": "sha512-Vsp28b7DRcimFQvrqu2Wek3z1iYxDCWqHYB8Qsnk/S4RfaCQzPGPyBNuVjJV3cd6UiKtUtp6sNM77gWvzcCH+g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10.0.0"
+      },
+      "peerDependencies": {
+        "bufferutil": "^4.0.1",
+        "utf-8-validate": ">=5.0.2"
+      },
+      "peerDependenciesMeta": {
+        "bufferutil": {
+          "optional": true
+        },
+        "utf-8-validate": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/xml": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/xml/-/xml-1.0.1.tgz",
+      "integrity": "sha512-huCv9IH9Tcf95zuYCsQraZtWnJvBtLVE0QHMOs8bWyZAFZNDcYjsPq1nEx8jKA9y+Beo9v+7OBPRisQTjinQMw==",
+      "license": "MIT"
+    },
+    "node_modules/xml-js": {
+      "version": "1.6.11",
+      "resolved": "https://registry.npmjs.org/xml-js/-/xml-js-1.6.11.tgz",
+      "integrity": "sha512-7rVi2KMfwfWFl+GpPg6m80IVMWXLRjO+PxTq7V2CDhoGak0wzYzFgUY2m4XJ47OGdXd8eLE8EmwfAmdjw7lC1g==",
+      "license": "MIT",
+      "dependencies": {
+        "sax": "^1.2.4"
+      },
+      "bin": {
+        "xml-js": "bin/cli.js"
+      }
+    },
+    "node_modules/y18n": {
+      "version": "5.0.8",
+      "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz",
+      "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/yargs": {
+      "version": "17.7.3",
+      "resolved": "https://registry.npmjs.org/yargs/-/yargs-17.7.3.tgz",
+      "integrity": "sha512-GZtjxm/J/4TSxuL3FNYjCmLktBTnIw/rVmKSIyKeYAZpmJB2ig9VauCC5xsa82GNKVKDAqpOn3KVzNt0zmrU0g==",
+      "license": "MIT",
+      "dependencies": {
+        "cliui": "^8.0.1",
+        "escalade": "^3.1.1",
+        "get-caller-file": "^2.0.5",
+        "require-directory": "^2.1.1",
+        "string-width": "^4.2.3",
+        "y18n": "^5.0.5",
+        "yargs-parser": "^21.1.1"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/yargs-parser": {
+      "version": "21.1.1",
+      "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.1.1.tgz",
+      "integrity": "sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/zod": {
+      "version": "3.25.76",
+      "resolved": "https://registry.npmjs.org/zod/-/zod-3.25.76.tgz",
+      "integrity": "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/colinhacks"
+      }
+    }
+  }
+}

qa/web-rtcp-5axis-site-test/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "web-rtcp-5axis-site-test",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "evidence:working7": "node capture-working7-manual-flow-evidence.mjs",
+    "evidence:working7:full": "node capture-working7-full-functional-evidence.mjs",
+    "test": "node run-site-test.mjs"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "docx": "^9.7.1",
+    "pngjs": "^7.0.0",
+    "puppeteer-core": "^25.1.0"
+  }
+}

qa/web-rtcp-5axis-site-test/run-site-test.mjs

@@ -0,0 +1,910 @@
+import fs from "node:fs/promises";
+import http from "node:http";
+import path from "node:path";
+import puppeteer from "puppeteer-core";
+import { PNG } from "pngjs";
+
+const REPO_ROOT = path.resolve("/home/meswork/cnc_wams");
+const ROOT = path.resolve("/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test");
+const OUTPUT_DIR = path.join(ROOT, "output");
+const SCREENSHOT_DIR = path.join(ROOT, "screenshots");
+const TARGET_URL = process.env.TARGET_URL || "";
+const APP_URL = process.env.APP_URL || "/web-rtcp-5axis-sim-plan/app/index.html";
+const CHROME_PATH = process.env.CHROME_PATH || process.env.CHROMIUM || "/usr/bin/google-chrome";
+
+const localProgramPath = path.join(ROOT, "fixtures", "test-program.ngc");
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
+const MIME_TYPES = {
+  ".css": "text/css; charset=utf-8",
+  ".html": "text/html; charset=utf-8",
+  ".js": "text/javascript; charset=utf-8",
+  ".json": "application/json; charset=utf-8",
+  ".mjs": "text/javascript; charset=utf-8",
+  ".png": "image/png",
+  ".svg": "image/svg+xml",
+  ".wasm": "application/wasm",
+  ".xml": "application/xml; charset=utf-8",
+};
+
+function contentTypeFor(filePath) {
+  return MIME_TYPES[path.extname(filePath).toLowerCase()] || "application/octet-stream";
+}
+
+function createStaticServer(rootDir) {
+  return http.createServer(async (request, response) => {
+    try {
+      const requestPath = decodeURIComponent(new URL(request.url || "/", "http://127.0.0.1").pathname);
+      const relativePath = requestPath === "/" ? "/index.html" : requestPath;
+      const targetPath = path.resolve(rootDir, `.${relativePath}`);
+      if (!targetPath.startsWith(rootDir)) {
+        response.writeHead(403);
+        response.end("forbidden");
+        return;
+      }
+      let stat = await fs.stat(targetPath).catch(() => null);
+      let filePath = targetPath;
+      if (stat?.isDirectory()) {
+        filePath = path.join(targetPath, "index.html");
+        stat = await fs.stat(filePath).catch(() => null);
+      }
+      if (!stat?.isFile()) {
+        response.writeHead(404);
+        response.end("not found");
+        return;
+      }
+      const body = await fs.readFile(filePath);
+      response.writeHead(200, {
+        "Content-Type": contentTypeFor(filePath),
+        "Content-Length": String(body.byteLength),
+        "Cache-Control": "no-store",
+      });
+      response.end(body);
+    } catch (error) {
+      response.writeHead(500);
+      response.end(error instanceof Error ? error.message : String(error));
+    }
+  });
+}
+
+await fs.mkdir(OUTPUT_DIR, { recursive: true });
+await fs.mkdir(SCREENSHOT_DIR, { recursive: true });
+await fs.mkdir(path.dirname(localProgramPath), { recursive: true });
+
+const findings = [];
+const consoleLogs = [];
+const pageErrors = [];
+const requestFailures = [];
+let server = null;
+let targetUrl = TARGET_URL;
+if (!targetUrl) {
+  server = createStaticServer(REPO_ROOT);
+  await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
+  const address = server.address();
+  if (!address || typeof address === "string") {
+    throw new Error("failed to start local static server");
+  }
+  targetUrl = `http://127.0.0.1:${address.port}${APP_URL}`;
+}
+
+const browser = await puppeteer.launch({
+  headless: true,
+  executablePath: CHROME_PATH,
+  defaultViewport: { width: 1600, height: 1200, deviceScaleFactor: 1 },
+  ignoreHTTPSErrors: true,
+  args: [
+    "--ignore-certificate-errors",
+    "--disable-gpu",
+    "--enable-webgl",
+    "--use-angle=swiftshader",
+    "--enable-unsafe-swiftshader",
+    "--no-sandbox",
+  ],
+});
+
+let page;
+
+try {
+  page = await browser.newPage();
+  page.on("console", async (msg) => {
+    let text = msg.text();
+    if (msg.type() === "error" && msg.args().length > 0) {
+      try {
+        const values = await Promise.all(msg.args().map((arg) => arg.jsonValue().catch(() => null)));
+        const serialized = values.filter((value) => value !== null);
+        if (serialized.length > 0) {
+          text = `${text} ${JSON.stringify(serialized)}`;
+        }
+      } catch {}
+    }
+    consoleLogs.push({
+      type: msg.type(),
+      text,
+      location: msg.location(),
+    });
+  });
+  page.on("pageerror", (error) => {
+    pageErrors.push({
+      message: error.message,
+      stack: error.stack || "",
+    });
+  });
+  page.on("requestfailed", (request) => {
+    requestFailures.push({
+      url: request.url(),
+      method: request.method(),
+      errorText: request.failure()?.errorText || "unknown",
+      resourceType: request.resourceType(),
+    });
+  });
+
+  await fs.writeFile(localProgramPath, [
+    "%",
+    "G90 G17 G21",
+    "G0 X0 Y0 Z5",
+    "G1 Z-1 F200",
+    "G1 X10 Y10 F300",
+    "M30",
+    "%",
+    "",
+  ].join("\n"), "utf8");
+
+  await page.goto(targetUrl, { waitUntil: "networkidle2", timeout: 60000 });
+  await page.waitForSelector('[data-shell="gmoccapy-5axis"]', { timeout: 15000 });
+  await page.waitForFunction(() => Boolean(window.webRtcp5AxisSimulation?.getState), { timeout: 15000 });
+  await page.waitForFunction(() => {
+    const state = window.webRtcp5AxisSimulation?.getState?.();
+    return Boolean(state?.iniConfigReadiness?.loaded);
+  }, { timeout: 20000 }).catch(() => {});
+  await waitForAppIdle(20000);
+  await waitForState(
+    (state) => state.taskHalRuntimeReadiness?.halSyncReady === true,
+    20000,
+    "task/HAL runtime readiness",
+  ).catch(() => null);
+
+  const screenshots = {};
+
+  async function capture(name, clipSelector = null) {
+    const targetPath = path.join(SCREENSHOT_DIR, `${name}.png`);
+    if (clipSelector) {
+      const element = await page.$(clipSelector);
+      if (element) {
+        await element.screenshot({ path: targetPath });
+      } else {
+        await page.screenshot({ path: targetPath, fullPage: true });
+      }
+    } else {
+      await page.screenshot({ path: targetPath, fullPage: true });
+    }
+    screenshots[name] = targetPath;
+    return targetPath;
+  }
+
+  async function getState() {
+    return page.evaluate(() => {
+      const state = window.webRtcp5AxisSimulation.getState();
+      return JSON.parse(JSON.stringify(state));
+    });
+  }
+
+  async function waitForState(predicate, timeoutMs = 10000, label = "state condition") {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+      const snapshot = await getState();
+      if (predicate(snapshot)) return snapshot;
+      await sleep(100);
+    }
+    throw new Error(`Timed out waiting for ${label}`);
+  }
+
+  async function waitForAppIdle(timeoutMs = 8000) {
+    await waitForState(
+      (state) => !state.taskHalExecutionPending && !state.interpreterExecutionPending,
+      timeoutMs,
+      "app idle",
+    ).catch(() => null);
+  }
+
+  async function waitForTaskHalReady(timeoutMs = 30000) {
+    return waitForState((state) => (
+      state.taskHalRuntimeReadiness?.loaded === true &&
+      state.taskHalRuntimeReadiness?.taskRuntimeReady === true &&
+      state.taskHalRuntimeReadiness?.motionRuntimeReady === true &&
+      state.taskHalRuntimeReadiness?.halRuntimeReady === true &&
+      state.taskHalRuntimeReadiness?.halSyncReady === true &&
+      !state.taskHalExecutionPending &&
+      !state.interpreterExecutionPending
+    ), timeoutMs, "Task/HAL ready and app idle").catch(() => null);
+  }
+
+  async function clickJogAndWait(action, axis, direction, beforeValue) {
+    const selector = `[data-action="${action}"]`;
+    await waitForTaskHalReady(30000);
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+      await clickAndWait(selector, 900);
+      const changed = await waitForState((nextState) => {
+        const nextValue = Number(nextState.axisPose?.[axis]);
+        return direction > 0
+          ? nextValue > Number(beforeValue)
+          : nextValue < Number(beforeValue);
+      }, 6000, `${action} axis change`).catch(() => null);
+      if (changed) return changed;
+    }
+    return getState();
+  }
+
+  async function getSummary() {
+    return page.evaluate(() => {
+      const state = window.webRtcp5AxisSimulation.getState();
+      const regions = window.webRtcp5AxisSimulation.getRegions?.() || null;
+      const machineSummary = document.querySelector('[data-machine-state="summary"]')?.textContent?.trim() || "";
+      const frameBoundary = document.querySelector('[data-rtcp-diagnostic="boundary"]')?.textContent?.trim() || "";
+      const boundaryReady = document.querySelector('[data-linuxcnc-boundary="readiness"]')?.textContent?.trim() || "";
+      const taskHal = document.querySelector('[data-task-hal-runtime="readiness"]')?.textContent?.trim() || "";
+      const machineFiles = document.querySelector('[data-machine-file-staging="status"]')?.textContent?.trim() || "";
+      const activeLine = document.querySelector('[data-active-program-line]')?.textContent?.trim() || "";
+      const linuxCncSourceStatus = document.querySelector('[data-linuxcnc-gcode-source="status"]')?.textContent?.trim() || "";
+      const canvas = document.querySelector("[data-five-axis-canvas]");
+      return {
+        regions,
+        machineSummary,
+        frameBoundary,
+        boundaryReady,
+        taskHal,
+        machineFiles,
+        activeLine,
+        linuxCncSourceStatus,
+        canvas: canvas ? { ...canvas.dataset } : null,
+        state,
+      };
+    });
+  }
+
+  async function recordResult(key, title, expectation, actual, status, detail = "") {
+    findings.push({
+      key,
+      title,
+      expectation,
+      actual,
+      status,
+      detail,
+    });
+  }
+
+  async function clickAndWait(selector, waitMs = 600) {
+    await page.waitForSelector(selector, { timeout: 10000 });
+    await page.waitForFunction((targetSelector) => {
+      const element = document.querySelector(targetSelector);
+      if (!element) return false;
+      const ariaDisabled = element.getAttribute("aria-disabled") === "true";
+      const commandReady = element.getAttribute("data-command-ready") === "false";
+      return !element.disabled && !ariaDisabled && !commandReady;
+    }, { timeout: 15000 }, selector);
+    await page.evaluate((targetSelector) => {
+      const element = document.querySelector(targetSelector);
+      if (!element) {
+        throw new Error(`missing click target ${targetSelector}`);
+      }
+      if (element.disabled || element.getAttribute("aria-disabled") === "true") {
+        throw new Error(`disabled click target ${targetSelector}`);
+      }
+      element.scrollIntoView({ block: "center", inline: "center" });
+      element.click();
+    }, selector);
+    await sleep(waitMs);
+    await waitForAppIdle();
+  }
+
+  async function setInputValue(selector, value) {
+    await page.waitForSelector(selector, { timeout: 10000 });
+    await page.$eval(selector, (el, nextValue) => {
+      el.value = nextValue;
+      el.dispatchEvent(new Event("input", { bubbles: true }));
+      el.dispatchEvent(new Event("change", { bubbles: true }));
+    }, value);
+    await sleep(400);
+  }
+
+  async function selectValue(selector, value) {
+    await page.waitForSelector(selector, { timeout: 10000 });
+    await page.evaluate((targetSelector, nextValue) => {
+      const element = document.querySelector(targetSelector);
+      if (!element) {
+        throw new Error(`missing select target ${targetSelector}`);
+      }
+      element.value = nextValue;
+      element.dispatchEvent(new Event("input", { bubbles: true }));
+      element.dispatchEvent(new Event("change", { bubbles: true }));
+    }, selector, value);
+    await sleep(400);
+    await waitForAppIdle();
+  }
+
+  function classify(condition, passText, failText) {
+    return condition ? { status: "PASS", text: passText } : { status: "FAIL", text: failText };
+  }
+
+  function classifyWarn(condition, passText, warnText) {
+    return condition ? { status: "PASS", text: passText } : { status: "WARN", text: warnText };
+  }
+
+  const initial = await getSummary();
+  await capture("01-home");
+
+  const regionsPass = [
+    "titlebar",
+    "preview",
+    "dro",
+    "gcode",
+    "status-sidebar",
+    "info-tabs",
+    "override",
+    "spindle-coolant",
+    "bottom-controls",
+  ].every((region) => initial.regions?.[region] === true);
+  const regionsStatus = classify(regionsPass, "9个主区域全部渲染", "存在主区域未渲染");
+  await recordResult(
+    "layout-regions",
+    "主界面九大区域渲染",
+    "titlebar/preview/dro/gcode/sidebar/info/override/spindle/bottom 全部存在",
+    regionsStatus.text,
+    regionsStatus.status,
+  );
+
+  const canvasFallback = initial.canvas?.threeRenderer === "2d-fallback";
+  const canvasReady = initial.canvas?.threeReady === "true";
+  const canvasStatus = canvasReady
+    ? (canvasFallback
+      ? { status: "WARN", text: `预览可用，但当前测试环境使用 ${initial.canvas.threeRenderer}，原因：${initial.canvas.threeFallbackReason || "-"}` }
+      : { status: "PASS", text: `预览已启用 ${initial.canvas.threeRenderer}` })
+    : { status: "FAIL", text: "预览画布未进入 ready 状态" };
+  await recordResult(
+    "preview-canvas",
+    "预览画布初始化",
+    "预览区域可渲染机床与路径",
+    canvasStatus.text,
+    canvasStatus.status,
+    initial.canvas ? JSON.stringify(initial.canvas) : "missing canvas dataset",
+  );
+
+  const initialBoundaryStatus = classify(
+    initial.frameBoundary.includes("linuxcnc_kinematics_wasm_c_abi"),
+    `RTCP 帧边界已接入 LinuxCNC 运动学：${initial.frameBoundary}`,
+    `RTCP 帧仍处于降级边界：${initial.frameBoundary}`,
+  );
+  await recordResult(
+    "initial-boundary",
+    "首屏 RTCP/运动学边界",
+    "首屏应优先使用 LinuxCNC/WASM 运动学边界",
+    initialBoundaryStatus.text,
+    initialBoundaryStatus.status,
+  );
+
+  const taskHalReadyState = await waitForTaskHalReady(30000);
+  const initialTaskHalStatus = classifyWarn(
+    Boolean(taskHalReadyState),
+    `Task/HAL 已就绪：${taskHalReadyState?.taskHalRuntimeReadiness?.semanticBoundary || initial.taskHal}`,
+    `Task/HAL 冷启动时尚未完成就绪：${initial.taskHal}`,
+  );
+  await recordResult(
+    "initial-task-hal",
+    "首屏 Task/HAL 运行态",
+    "Task/HAL readiness 应就绪",
+    initialTaskHalStatus.text,
+    initialTaskHalStatus.status,
+  );
+
+  await clickAndWait('[data-action="power"]');
+  await waitForState((nextState) => nextState.machine.powerOn === true, 8000, "machine power on").catch(() => null);
+  let state = await getState();
+  await recordResult(
+    "power-on",
+    "POWER 上电",
+    "点击 POWER 后 machine.powerOn=true，taskState=on",
+    `powerOn=${state.machine.powerOn}, taskState=${state.machine.taskState}, runState=${state.runState}`,
+    state.machine.powerOn && state.machine.taskState === "on" ? "PASS" : "FAIL",
+  );
+
+  await clickAndWait('[data-action="mode-jog"]');
+  await waitForState((nextState) => nextState.machine.mode === "manual", 8000, "JOG/manual mode").catch(() => null);
+  state = await getState();
+  await recordResult(
+    "mode-jog",
+    "JOG 模式切换",
+    "点击 JOG 后 mode 归一到 manual",
+    `mode=${state.machine.mode}`,
+    state.machine.mode === "manual" ? "PASS" : "FAIL",
+  );
+
+  await clickAndWait('[data-action="HOME"]');
+  await waitForState((nextState) => nextState.machine.allHomed === true, 8000, "machine homed").catch(() => null);
+  await waitForTaskHalReady(30000);
+  state = await getState();
+  await recordResult(
+    "home",
+    "HOME 回参考点",
+    "点击 HOME 后 allHomed=true，runState=idle",
+    `allHomed=${state.machine.allHomed}, runState=${state.runState}`,
+    state.machine.allHomed && state.runState === "idle" ? "PASS" : "FAIL",
+  );
+
+  const beforeJogX = state.axisPose.x;
+  state = await clickJogAndWait("JOG_X_POS", "x", 1, beforeJogX);
+  await recordResult(
+    "jog-x-plus",
+    "JOG X+",
+    "点击 X+ 后 X 坐标增加",
+    `before=${beforeJogX}, after=${state.axisPose.x}`,
+    state.axisPose.x > beforeJogX ? "PASS" : "FAIL",
+  );
+
+  const beforeJogY = state.axisPose.y;
+  state = await clickJogAndWait("JOG_Y_NEG", "y", -1, beforeJogY);
+  await recordResult(
+    "jog-y-minus",
+    "JOG Y-",
+    "点击 Y- 后 Y 坐标减小",
+    `before=${beforeJogY}, after=${state.axisPose.y}`,
+    state.axisPose.y < beforeJogY ? "PASS" : "FAIL",
+  );
+
+  await clickAndWait('[data-action="mode-auto"]');
+  await waitForState((nextState) => nextState.machine.mode === "auto", 8000, "AUTO mode").catch(() => null);
+  state = await getState();
+  await recordResult(
+    "mode-auto",
+    "AUTO 模式切换",
+    "点击 AUTO 后 machine.mode=auto",
+    `mode=${state.machine.mode}`,
+    state.machine.mode === "auto" ? "PASS" : "FAIL",
+  );
+
+  await clickAndWait('[data-action="mode-manual"]');
+  await waitForState((nextState) => nextState.machine.mode === "manual" && nextState.machine.interpState === "idle", 10000, "MANUAL idle before MDI").catch(() => null);
+  await waitForTaskHalReady(30000);
+  await clickAndWait('[data-action="mode-mdi"]');
+  await waitForState((nextState) => nextState.machine.mode === "mdi", 8000, "MDI mode").catch(() => null);
+  state = await getState();
+  await recordResult(
+    "mode-mdi",
+    "MDI 模式切换",
+    "点击 MDI 后 machine.mode=mdi",
+    `mode=${state.machine.mode}`,
+    state.machine.mode === "mdi" ? "PASS" : "FAIL",
+  );
+
+  if (state.machine.mode !== "mdi") {
+    await clickAndWait('[data-action="mode-manual"]');
+    await waitForState((nextState) => nextState.machine.mode === "manual", 10000, "retry manual before MDI").catch(() => null);
+    await waitForTaskHalReady(30000);
+    await clickAndWait('[data-action="mode-mdi"]');
+    await waitForState((nextState) => nextState.machine.mode === "mdi", 10000, "retry MDI mode").catch(() => null);
+    state = await getState();
+  }
+
+  await setInputValue('[data-action="mdi-command"]', "M428");
+  await waitForState((nextState) => nextState.machine.mode === "mdi", 10000, "MDI active before M428");
+  await clickAndWait('[data-action="mdi-submit"]', 800);
+  state = await getState();
+  await recordResult(
+    "mdi-m428",
+    "MDI 执行 M428",
+    "执行 M428 后 RTCP 打开，kinsType 切到 tcp-*",
+    `rtcp=${state.rtcpState}, kinsType=${state.kinsType}, message=${state.operatorMessage}`,
+    state.rtcpState === "on" && String(state.kinsType).startsWith("tcp-") ? "PASS" : "FAIL",
+  );
+
+  await clickAndWait('[data-action="mdi-history"][data-command="M429"]', 800);
+  state = await getState();
+  await recordResult(
+    "mdi-m429",
+    "MDI 快捷执行 M429",
+    "执行 M429 后 RTCP 关闭，kinsType=identity",
+    `rtcp=${state.rtcpState}, kinsType=${state.kinsType}, message=${state.operatorMessage}`,
+    state.rtcpState === "off" && state.kinsType === "identity" ? "PASS" : "FAIL",
+  );
+
+  await clickAndWait('[data-action="kins-tcp"]');
+  state = await getState();
+  await recordResult(
+    "sidebar-tcp",
+    "侧栏 TCP 按钮",
+    "点击 TCP 后 RTCP 打开",
+    `rtcp=${state.rtcpState}, kinsType=${state.kinsType}`,
+    state.rtcpState === "on" && String(state.kinsType).startsWith("tcp-") ? "PASS" : "FAIL",
+  );
+
+  await clickAndWait('[data-action="kins-identity"]');
+  state = await getState();
+  await recordResult(
+    "sidebar-identity",
+    "侧栏 IDENTITY 按钮",
+    "点击 IDENTITY 后 RTCP 关闭",
+    `rtcp=${state.rtcpState}, kinsType=${state.kinsType}`,
+    state.rtcpState === "off" && state.kinsType === "identity" ? "PASS" : "FAIL",
+  );
+
+  const beforeRapid = state.feed.rapidOverride;
+  await clickAndWait('[data-action="rapid-override-up"]');
+  state = await getState();
+  await recordResult(
+    "rapid-override",
+    "Rapid Override 调整",
+    "点击 + 后 rapidOverride 增加",
+    `before=${beforeRapid}, after=${state.feed.rapidOverride}`,
+    state.feed.rapidOverride > beforeRapid ? "PASS" : "FAIL",
+  );
+
+  const beforeFeed = state.feed.feedOverride;
+  await clickAndWait('[data-action="feed-override-down"]');
+  state = await getState();
+  await recordResult(
+    "feed-override",
+    "Feed Override 调整",
+    "点击 - 后 feedOverride 减少",
+    `before=${beforeFeed}, after=${state.feed.feedOverride}`,
+    state.feed.feedOverride < beforeFeed ? "PASS" : "FAIL",
+  );
+
+  const beforeSpindle = state.spindle.override;
+  await clickAndWait('[data-action="spindle-override-up"]');
+  state = await getState();
+  await recordResult(
+    "spindle-override",
+    "Spindle Override 调整",
+    "点击 + 后 spindle.override 增加",
+    `before=${beforeSpindle}, after=${state.spindle.override}`,
+    state.spindle.override > beforeSpindle ? "PASS" : "FAIL",
+  );
+
+  const floodBefore = state.coolant.flood;
+  await clickAndWait('[data-action="toggle-flood"]');
+  state = await getState();
+  await recordResult(
+    "coolant-flood",
+    "Flood 冷却开关",
+    "点击 Flood 后 flood 状态切换",
+    `before=${floodBefore}, after=${state.coolant.flood}`,
+    state.coolant.flood !== floodBefore ? "PASS" : "FAIL",
+  );
+
+  const mistBefore = state.coolant.mist;
+  await clickAndWait('[data-action="toggle-mist"]');
+  state = await getState();
+  await recordResult(
+    "coolant-mist",
+    "Mist 冷却开关",
+    "点击 Mist 后 mist 状态切换",
+    `before=${mistBefore}, after=${state.coolant.mist}`,
+    state.coolant.mist !== mistBefore ? "PASS" : "FAIL",
+  );
+
+  await clickAndWait('[data-action="view-x"]');
+  state = await getState();
+  const viewXPass = state.preview.selectedView === "x";
+  await recordResult(
+    "view-x",
+    "预览视角 X",
+    "点击 X 后 selectedView=x",
+    `selectedView=${state.preview.selectedView}`,
+    viewXPass ? "PASS" : "FAIL",
+  );
+
+  await clickAndWait('[data-action="view-y"]');
+  state = await getState();
+  await recordResult(
+    "view-y",
+    "预览视角 Y",
+    "点击 Y 后 selectedView=y",
+    `selectedView=${state.preview.selectedView}`,
+    state.preview.selectedView === "y" ? "PASS" : "FAIL",
+  );
+
+  await clickAndWait('[data-action="clear-preview"]');
+  state = await getState();
+  await recordResult(
+    "clear-preview",
+    "Clear Preview",
+    "点击 Clear 后 pathPoints=0",
+    `pathPoints=${state.preview.pathPoints}`,
+    state.preview.pathPoints === 0 ? "PASS" : "FAIL",
+  );
+
+  await clickAndWait('[data-action="reset-view"]');
+  state = await getState();
+  await recordResult(
+    "reset-view",
+    "Fit/Reset View",
+    "点击 Fit 后 selectedView=iso",
+    `selectedView=${state.preview.selectedView}`,
+    state.preview.selectedView === "iso" ? "PASS" : "FAIL",
+  );
+
+  await clickAndWait('[data-action="FULL"]');
+  state = await getState();
+  const fullOn = state.preview.fullscreen === true;
+  await clickAndWait('[data-action="FULL"]');
+  const stateAfterFullOff = await getState();
+  await recordResult(
+    "fullscreen-toggle",
+    "Full 全屏切换",
+    "连续点击两次 Full 后 fullscreen true 再 false",
+    `first=${state.preview.fullscreen}, second=${stateAfterFullOff.preview.fullscreen}`,
+    fullOn && stateAfterFullOff.preview.fullscreen === false ? "PASS" : "FAIL",
+  );
+
+  await selectValue('[data-action="select-profile"]', "xyzbc-trt");
+  await sleep(2000);
+  state = await getState();
+  await recordResult(
+    "profile-switch",
+    "Profile 切换到 xyzbc-trt",
+    "切换后 machineProfile=xyzbc-trt，INI 重新加载",
+    `machineProfile=${state.machineProfile}, iniLoaded=${state.iniConfigReadiness.loaded}, iniPath=${state.iniConfigReadiness.path}`,
+    state.machineProfile === "xyzbc-trt" && state.iniConfigReadiness.loaded ? "PASS" : "FAIL",
+  );
+  await capture("02-profile-xyzbc");
+
+  await selectValue('[data-action="select-profile"]', "xyzac-trt");
+  await sleep(2000);
+  state = await getState();
+  await recordResult(
+    "profile-switch-back",
+    "Profile 切回 xyzac-trt",
+    "切回后 machineProfile=xyzac-trt",
+    `machineProfile=${state.machineProfile}, iniLoaded=${state.iniConfigReadiness.loaded}`,
+    state.machineProfile === "xyzac-trt" && state.iniConfigReadiness.loaded ? "PASS" : "FAIL",
+  );
+
+  await clickAndWait('[data-action="stage-linuxcnc-sources"]', 5000);
+  let summary = await getSummary();
+  const stagedCount = summary.state.machineFileStaging?.gcodeSources?.length || 0;
+  const stagingStatus = classifyWarn(
+    stagedCount > 0 && summary.state.machineFileStaging.status === "staged",
+    `已 staged ${stagedCount} 个 LinuxCNC 五轴 G-code 源文件`,
+    `staging 未完成：status=${summary.state.machineFileStaging.status}, lastError=${summary.state.machineFileStaging.lastError || "-"}`,
+  );
+  await recordResult(
+    "stage-linuxcnc-sources",
+    "Stage LinuxCNC 5-axis 源程序",
+    "点击 Stage 后应完成 machine files staging 并出现可选 G-code",
+    stagingStatus.text,
+    stagingStatus.status,
+  );
+
+  if (stagedCount > 0) {
+    const sourceRel = summary.state.machineFileStaging.gcodeSources[0].sourceRel;
+    await selectValue('[data-action="select-linuxcnc-gcode-source"]', sourceRel);
+    await sleep(4000);
+    summary = await getSummary();
+    const loadedVendored = summary.state.programSource === "linuxcnc-vendored-5axis-gcode";
+    await recordResult(
+      "load-vendored-program",
+      "加载 LinuxCNC 五轴源程序",
+      "选择源程序后 programSource=linuxcnc-vendored-5axis-gcode",
+      `programSource=${summary.state.programSource}, activeProgram=${summary.state.activeProgram}, sourceRel=${summary.state.programSourceRel || "-"}`,
+      loadedVendored ? "PASS" : "FAIL",
+    );
+    await capture("03-vendored-program-loaded");
+  } else {
+    await recordResult(
+      "load-vendored-program",
+      "加载 LinuxCNC 五轴源程序",
+      "应可加载 staged 后的 vendored 程序",
+      "因 staging 未完成，本项无法继续",
+      "FAIL",
+    );
+  }
+
+  state = await getState();
+  if (!state.machine.powerOn) {
+    await clickAndWait('[data-action="power"]');
+    await waitForState((nextState) => nextState.machine.powerOn === true, 8000, "machine power on before run").catch(() => null);
+  }
+  if (!state.machine.allHomed) {
+    await clickAndWait('[data-action="mode-jog"]');
+    await clickAndWait('[data-action="HOME"]');
+    await waitForState((nextState) => nextState.machine.allHomed === true, 8000, "machine homed before run").catch(() => null);
+  }
+  await clickAndWait('[data-action="mode-auto"]');
+  await clickAndWait('[data-action="RUN"]', 2500);
+  state = await getState();
+  await recordResult(
+    "run-program",
+    "Run 程序",
+    "点击 Run 后程序进入 running/complete，活动行或运行反馈推进",
+    `runState=${state.runState}, activeLine=${state.activeLine}, source=${state.programExecutionSourceMode}, feedback=${state.programRuntimeFeedback?.apiName || "-"}`,
+    ["running", "complete"].includes(state.runState) || Number(state.activeLine) !== 501 ? "PASS" : "FAIL",
+  );
+  await capture("04-run-state");
+
+  await clickAndWait('[data-action="PAUSE"]', 1200);
+  state = await getState();
+  await recordResult(
+    "pause-program",
+    "Pause 程序",
+    "点击 Pause 后 runState=paused",
+    `runState=${state.runState}, interpState=${state.machine.interpState}`,
+    state.runState === "paused" ? "PASS" : "FAIL",
+  );
+
+  await clickAndWait('[data-action="RESUME"]', 1200);
+  state = await getState();
+  await recordResult(
+    "resume-program",
+    "Resume 程序",
+    "点击 Resume 后 runState 返回 running/idle",
+    `runState=${state.runState}, interpState=${state.machine.interpState}`,
+    ["running", "idle", "complete"].includes(state.runState) ? "PASS" : "FAIL",
+  );
+
+  const beforeStepLine = state.activeLine;
+  await clickAndWait('[data-action="STEP"]', 1500);
+  state = await getState();
+  await recordResult(
+    "step-program",
+    "Step 单步执行",
+    "点击 Step 后 Task/HAL 记录 singleStepping=true，并保持暂停态等待后续操作",
+    `runState=${state.runState}, activeLine=${state.activeLine}, taskPaused=${state.machine.taskPaused}, singleStepping=${state.taskHalStatus?.task?.singleStepping}`,
+    state.machine.taskPaused === true
+      && state.taskHalStatus?.task?.singleStepping === true
+      && Number(state.activeLine) >= Number(beforeStepLine)
+      ? "PASS"
+      : "FAIL",
+  );
+
+  await clickAndWait('[data-action="STOP"]', 1200);
+  state = await getState();
+  await recordResult(
+    "stop-program",
+    "Stop 停止程序",
+    "点击 Stop 后 runState=stopped",
+    `runState=${state.runState}, interpState=${state.machine.interpState}`,
+    state.runState === "stopped" ? "PASS" : "FAIL",
+  );
+
+  await clickAndWait('[data-action="RELOAD"]', 1200);
+  state = await getState();
+  await recordResult(
+    "reload-program",
+    "Reload 程序",
+    "点击 Reload 后 runState=idle，程序回到起始状态",
+    `runState=${state.runState}, activeLine=${state.activeLine}`,
+    state.runState === "idle" ? "PASS" : "FAIL",
+  );
+
+  const fileInput = await page.$('[data-action="OPEN_FILE"]');
+  await fileInput.uploadFile(localProgramPath);
+  await sleep(3000);
+  state = await getState();
+  await recordResult(
+    "open-local-program",
+    "Open 本地 G-code 文件",
+    "上传本地文件后 activeProgram 为上传文件，programSource=upload",
+    `activeProgram=${state.activeProgram}, programSource=${state.programSource}, lineCount=${state.lineCount}`,
+    state.activeProgram.endsWith("test-program.ngc") && ["upload", "operator-file"].includes(state.programSource) ? "PASS" : "FAIL",
+  );
+  await capture("05-local-program-opened");
+
+  await clickAndWait('[data-action="SAVE_SESSION"]', 2500);
+  state = await getState();
+  const saveSessionStatus = classifyWarn(
+    state.sessionPersistence.status === "saved",
+    `会话已保存：${state.sessionPersistence.path} (${state.sessionPersistence.storageMode})`,
+    `会话保存未成功：status=${state.sessionPersistence.status}, error=${state.sessionPersistence.lastError || "-"}`,
+  );
+  await recordResult(
+    "save-session",
+    "Save Session",
+    "点击 Save Session 后会话状态应为 saved",
+    saveSessionStatus.text,
+    saveSessionStatus.status,
+  );
+
+  await clickAndWait('[data-action="mode-manual"]');
+  await waitForState((nextState) => nextState.machine.mode === "manual", 8000, "manual mode before session mutation").catch(() => null);
+  await clickAndWait('[data-action="JOG_X_POS"]');
+  await waitForState((nextState) => Number(nextState.axisPose.x) !== Number(state.axisPose.x), 8000, "axis changed before restore").catch(() => null);
+  const modifiedState = await getState();
+  await clickAndWait('[data-action="RESTORE_SESSION"]', 2500);
+  state = await getState();
+  await recordResult(
+    "restore-session",
+    "Restore Session",
+    "点击 Restore Session 后会话恢复到最近保存快照",
+    `modifiedX=${modifiedState.axisPose.x}, restoredX=${state.axisPose.x}, status=${state.sessionPersistence.status}`,
+    state.sessionPersistence.status === "restored" && state.axisPose.x !== modifiedState.axisPose.x ? "PASS" : "FAIL",
+  );
+
+  await clickAndWait('[data-action="AUDIT_FULL_BOUNDARY"]', 6000);
+  summary = await getSummary();
+  const auditStatus = classifyWarn(
+    !summary.state.interpreterExecutionPending,
+    `Audit 执行完成，fullBoundary=${summary.state.fullExecutionBoundary?.fullLinuxCncProgramExecutionReady}`,
+    "Audit 触发后仍在 pending 或未返回结果",
+  );
+  await recordResult(
+    "audit-full-boundary",
+    "Audit Full Boundary",
+    "点击 Audit 后应触发五轴 machine-file 运行审计并刷新边界状态",
+    `${auditStatus.text}; boundaryStatus=${summary.state.fullExecutionBoundary?.boundaryStatus || "-"}; machineRun=${summary.state.machineFileExecution?.summary?.machineFileExecutionReady ?? "-"}`,
+    auditStatus.status,
+  );
+  await capture("06-after-audit");
+
+  await clickAndWait('[data-action="estop"]');
+  state = await getState();
+  await recordResult(
+    "estop",
+    "E-STOP 急停",
+    "点击 E-STOP 后 estopActive=true，runState=estopped",
+    `estopActive=${state.machine.estopActive}, runState=${state.runState}, powerOn=${state.machine.powerOn}`,
+    state.machine.estopActive && state.runState === "estopped" ? "PASS" : "FAIL",
+  );
+
+  await clickAndWait('[data-action="reset"]');
+  state = await getState();
+  await recordResult(
+    "reset",
+    "RESET 复位",
+    "点击 RESET 后 estopActive=false，powerOn=false，taskState=estop-reset",
+    `estopActive=${state.machine.estopActive}, powerOn=${state.machine.powerOn}, taskState=${state.machine.taskState}`,
+    !state.machine.estopActive && !state.machine.powerOn && state.machine.taskState === "estop-reset" ? "PASS" : "FAIL",
+  );
+
+  const finalSummary = await getSummary();
+  await capture("07-final");
+
+  const screenshotAnalysis = await analyzeScreenshot(screenshots["01-home"]);
+
+  const report = {
+    generatedAt: new Date().toISOString(),
+    targetUrl,
+    chromePath: CHROME_PATH,
+    screenshots,
+    screenshotAnalysis,
+    finalSummary,
+    findings,
+    consoleLogs,
+    pageErrors,
+    requestFailures,
+  };
+  report.status = findings.some((finding) => finding.status === "FAIL") || pageErrors.length > 0
+    ? "FAIL"
+    : "PASS";
+
+  await fs.writeFile(path.join(OUTPUT_DIR, "site-test-report.json"), `${JSON.stringify(report, null, 2)}\n`, "utf8");
+  console.log(`site_test_status=${report.status}`);
+  console.log(`site_test_target_url=${targetUrl}`);
+  console.log(`site_test_report=/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/site-test-report.json`);
+  if (report.status !== "PASS") {
+    process.exitCode = 1;
+  }
+} finally {
+  await browser.close().catch(() => {});
+  if (server) await new Promise((resolve) => server.close(resolve));
+}
+
+async function analyzeScreenshot(filePath) {
+  if (!filePath) return null;
+  const buffer = await fs.readFile(filePath);
+  const png = PNG.sync.read(buffer);
+  const { width, height, data } = png;
+  let sum = 0;
+  let nonBlackPixels = 0;
+  for (let i = 0; i < data.length; i += 4) {
+    const r = data[i];
+    const g = data[i + 1];
+    const b = data[i + 2];
+    const luminance = (r + g + b) / 3;
+    sum += luminance;
+    if (luminance > 8) nonBlackPixels += 1;
+  }
+  return {
+    width,
+    height,
+    averageLuminance: Number((sum / (width * height)).toFixed(2)),
+    nonBlackRatio: Number((nonBlackPixels / (width * height)).toFixed(4)),
+  };
+}

text9.txt

@@ -1,467 +0,0 @@
-项目整体完成情况与后续执行计划
-
-生成时间：2026-06-14 CST
-
-本文件接替 `text8.txt`。后续工作按 `text9.txt` 执行；除非明确要求审计旧记录，
-不要再回到 `text1/text2/text3/text4/text5/text6/text7/text8` 扩展进度。
-`text8.txt` 作为历史归档保留。
-
-一、续接状态与防重规则
-
-1. 当前续接点。
-
-`text8.txt` 已推进到：
-
-```text
-三十八、2026-06-14 继续执行记录：browser OPFS direct session parameter value locals guard
-```
-
-该批已提交并推送：
-
-```text
-82f2c57 Guard browser OPFS direct session parameter values
-```
-
-本文件从 `text9.txt` 重新开始记录后续进度。
-
-2. 每轮开始前必须先执行。
-
-```bash
-git status --short
-git log -5 --oneline
-tail -n 120 text9.txt
-awk '/^[一二三四五六七八九十百]+、/ {print}' text9.txt | sort | uniq -d
-```
-
-执行规则：
-
-- 如果 `git status --short` 是 clean，且最新提交已经包含当前建议工作，不要重复追加记录；
-- 每轮只追加一个新的中文编号记录；提交前再次检查标题唯一性；
-- `text9.txt` 只记录新的后续进度，不复制 `text8.txt` 的长历史；
-- 每批完成后，如果要写记录，先写 `text9.txt`，再提交该批代码和记录；
-- 如果发现重复记录，先做 dedupe 清理并提交，再继续新功能或新 guard；
-- `text8.txt` 不再追加新进度，除非明确要求审计或修正历史记录。
-
-二、当前项目纪律
-
-1. LinuxCNC 仍是唯一 CNC 语义来源。
-
-G-code、remap、tool、parameter、planner、kinematics、user-M、tool DB、Python
-remap 等语义必须来自 LinuxCNC upstream 或 vendored LinuxCNC C/C++/配置/脚本源码。
-
-2. 本项目允许实现的范围仍限于：
-
-- build；
-- source sync；
-- runtime shim；
-- filesystem staging；
-- OPFS；
-- WASM/browser boundary；
-- 测试胶水；
-- 文档；
-- 机器可读 gate/artifact。
-
-3. 禁止事项继续有效：
-
-- 不在 JS 中重写 G-code 或 CNC 语义；
-- 不修改 vendored LinuxCNC 源文件来让测试通过；
-- 不把 full-process/HAL/UI/Python/tool DB 依赖伪装成 standalone pass；
-- 不把 expected failure 硬改成 pass，除非已有 LinuxCNC-owned runtime proof，并且
-  native、Node、browser gate 都按顺序通过；
-- browser 不能依赖目录枚举。
-
-三、当前完成情况摘要
-
-1. 当前工作树状态。
-
-切换到 `text9.txt` 前已确认：
-
-```text
-git status --short: clean
-text8.txt duplicate Chinese headings: none
-```
-
-当前最近提交：
-
-```text
-82f2c57 Guard browser OPFS direct session parameter values
-0cfe942 Guard browser OPFS direct session parameter seed
-9265825 Guard browser OPFS direct session load options
-e0f7ebe Guard browser OPFS explicit session file group
-ee4c4e1 Guard browser OPFS INI-named session file group
-```
-
-2. WASM port 基础架构稳定。
-
-`wasm-port` 仍按独立移植工作区组织，包含 vendor、runtime/core、runtime/sdk、
-runtime/opfs、runtime/ui、native/wasm/browser tests、docs 和 tools。
-
-3. 关键基线保持稳定。
-
-- `linuxcnc/nc_files` native Layer 1：
-  - `total 107`
-  - `pass 101`
-  - `expected_fail 6`
-  - `unexpected_fail 0`
-- `linuxcnc/configs/sim` native Layer 2：
-  - `total 159`
-  - `pass 151`
-  - `expected_fail 8`
-  - `unexpected_fail 0`
-- Node sim-config inventory：
-  - `executed=28`
-  - `passed=28`
-  - `skipped=131`
-  - `unexpected_fail=0`
-
-4. blocked runtime family 仍未 promotion。
-
-仍 blocked，不允许 promotion：
-
-- `L4-USER-M-PROCESS`
-- `L4-TOOL-DB`
-- `L4-PYTHON-REMAP`
-
-当前 host 仍按缺少 LinuxCNC host runtime 处理，不执行任何：
-
-```bash
-ENABLE_MILLTURN_USER_M_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_millturn_user_m_runtime.sh
-ENABLE_TOOL_DB_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_tool_db_runtime.sh
-ENABLE_PYTHON_REMAP_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_python_remap_runtime.sh
-```
-
-5. `text8.txt` 最新收敛方向。
-
-`text8.txt` 后半段继续沿 browser/OPFS boundary guard 小批量推进，最近完成的重点包括：
-
-- OPFS saved text、save result、load result helper guard；
-- invalid INI lines/path helper guard；
-- OPFS default machine path、default filename、machine INI WASM path helper guard；
-- generated fixture WASM path helper guard；
-- direct browser session WASM path group helper guard；
-- custom session INI/WASM/path/load/save helper guard；
-- custom session parameter/tool-table seed、value、result/readback helper guard；
-- INI-named 与 explicit custom session file group helper guard；
-- direct browser session load options helper guard；
-- direct browser session parameter seed helper guard；
-- direct `browser-interp` saved parameter values/result/readback locals guard。
-
-这些改动均只收敛 browser/OPFS test glue 与 boundary guard，未改变 OPFS bridge
-behavior、file-service、path-model、SDK planner、interpreter、INI、tool、parameter
-或 LinuxCNC-owned runtime semantics。
-
-四、当前必须保持通过的验证入口
-
-每批后续改动至少运行：
-
-```bash
-git diff --check
-wasm-port/tools/verify_vendor_sync.sh
-wasm-port/tools/verify_no_standalone_cnc_semantics.sh
-SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_interp_wasm.sh
-SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
-SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_interp_browser.sh
-wasm-port/tests/host/verify_host_smokes.sh
-```
-
-涉及 native baseline 或大范围 source/staging 改动时，再运行：
-
-```bash
-wasm-port/tests/native/verify_nc_files.sh
-wasm-port/tests/native/verify_sim_configs.sh
-wasm-port/tests/native/verify_native_probes.sh
-```
-
-五、下一步执行计划
-
-1. 当前第一候选批次。
-
-继续小批量 browser OPFS test glue guard。优先扫描 direct `browser-interp` session 的
-initial parameter load result 与 backup readback expected lines 是否能复用
-`browserDirectParameterSeedLines(...)` 或现有 `opfsParameter*` helpers。
-
-执行目标：
-
-- 只处理 `wasm-port/tests/browser/interp_smoke.html` 内的 browser/OPFS test glue；
-- 优先让 initial parameter restore result 与 backup readback expected lines 复用已有
-  helper 或局部常量；
-- helper 必须继续通过 `verifyExpectedOutput(...)` 间接或直接做精确文本校验；
-- 保持 `<_named_param> 123` 和 `absent=<_named_param>` 的语义边界外显；
-- 不改变参数值、OPFS path、WASM path 字符串、保存/读取/load 行为；
-- 不改变 OPFS bridge behavior、file-service、path-model、SDK planner、interpreter、
-  INI、tool、parameter 或 LinuxCNC-owned runtime semantics。
-
-2. 第一候选批次验证。
-
-执行：
-
-```bash
-git diff --check
-SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_interp_browser.sh
-wasm-port/tools/verify_vendor_sync.sh
-wasm-port/tools/verify_no_standalone_cnc_semantics.sh
-SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_interp_wasm.sh
-SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
-wasm-port/tests/host/verify_host_smokes.sh
-```
-
-如果通过，提交建议：
-
-```text
-Guard browser OPFS direct session initial parameters
-```
-
-3. 后续候选。
-
-如果 initial parameter load/backup 收益不明显，转向 direct `browser-interp`
-tool-table load/save/readback value groups，看是否能像 custom session 一样对齐为
-locals 或复用现有 `opfsToolTable*` helpers。
-
-继续只选：
-
-- 已有 Node/browser coverage；
-- 不依赖 HAL/task/tool DB/Python remap/user-M process；
-- direct-file、generated-file、OPFS boundary 或 staging helper 已成型；
-- 每批小范围收敛；
-- 只做 host/filesystem/browser/OPFS boundary guard，不新增 CNC 语义。
-
-暂不推进：
-
-- blocked runtime promotion；
-- browser full 159 sim-config inventory；
-- full-process/HAL/UI/Python/tool DB 执行；
-- upstream intake 大批量扩面。
-
-六、下一次开始执行时的第一条命令
-
-从这里继续：
-
-```bash
-git status --short && git log -5 --oneline && tail -n 120 text9.txt && awk '/^[一二三四五六七八九十百]+、/ {print}' text9.txt | sort | uniq -d
-```
-
-七、2026-06-14 继续执行记录：text9 handoff and direct session initial parameter guard
-
-本轮先按用户要求完成 `text9.txt` 续接文件创建，后续进度改按 `text9.txt` 记录；
-随后按第一候选批次继续收敛 direct `browser-interp` session 的 initial parameter
-load/backup expected lines，范围仍只触及
-`wasm-port/tests/browser/interp_smoke.html` 的 browser/OPFS test glue。
-
-完成内容：
-
-- 新建 `text9.txt`，完整承接 `text8.txt` 当前工作情况、纪律、验证入口、续接规则和
-  下一步计划；
-- 明确 `text8.txt` 作为历史归档保留，后续不再追加新进度；
-- 为 direct `browser-interp` session 增加
-  `browserInterpInitialParameterValues` 局部常量；
-- `opfs_restore_parameters` expected lines 改为复用既有
-  `opfsParameterResultLines("restore", ...)`；
-- `opfs_saved_parameter_backup_text` expected lines 改为复用既有
-  `opfsParameterTextLines(" ", ...)`，并继续显式保留 `<_named_param> 123`；
-- seed text 仍由 `browserDirectParameterSeedLines(true)` 生成，实际写入内容不变；
-- 未改变参数值、OPFS path、WASM path 字符串、save/read/load 行为；
-- 未改变 staging path 模型、OPFS bridge behavior、file-service、SDK planner、
-  interpreter、INI、tool、parameter 或 LinuxCNC-owned runtime semantics。
-
-验证已通过：
-
-```bash
-git diff --check
-SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_interp_browser.sh
-wasm-port/tools/verify_vendor_sync.sh
-wasm-port/tools/verify_no_standalone_cnc_semantics.sh
-SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_interp_wasm.sh
-SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
-wasm-port/tests/host/verify_host_smokes.sh
-```
-
-关键输出：
-
-```text
-browser_interp_smoke=ok
-vendor sync up to date
-standalone CNC semantics guard complete
-interp_wasm_node_smoke=ok
-sim_configs_wasm_node_inventory_executed=28
-sim_configs_wasm_node_inventory_passed=28
-sim_configs_wasm_node_inventory_skipped=131
-sim_configs_wasm_node_inventory_unexpected_fail=0
-host_wasm_opfs_browser_smokes=ok
-```
-
-下一步建议：
-
-继续小批量 browser OPFS test glue guard。优先扫描 direct `browser-interp` session 的
-tool-table load/save/readback value groups 是否能像 custom session 一样对齐为 locals
-或复用现有 `opfsToolTable*` helpers；只改测试胶水，不改变 tool-table 输入、OPFS path、
-WASM path 字符串或保存/读取行为。
-
-八、2026-06-14 继续执行记录：browser OPFS direct session tool-table value locals guard
-
-本轮按上一条下一步建议继续收敛 direct `browser-interp` session 的 tool-table
-load/save/readback value groups，范围仍只触及
-`wasm-port/tests/browser/interp_smoke.html` 的 browser/OPFS test glue。
-
-完成内容：
-
-- 扩展 `opfsToolTableTextLines(...)`，新增向后兼容的 `extraLines` 可选参数；
-- 为 direct `browser-interp` session 增加 `browserInterpToolTableValues` 与
-  `browserInterpToolTableReadbackValues` 局部常量；
-- `opfs_load_tool_table` expected lines 改为复用既有
-  `opfsToolTableResultLines("load", ...)`；
-- `opfs_save_tool_table` expected lines 改为复用既有
-  `opfsToolTableResultLines("save", ...)`；
-- `opfs_saved_tool_table_text` expected lines 改为复用
-  `opfsToolTableTextLines(...)`，并通过 `extraLines` 显式保留 direct 场景独有的
-  `I+12.000000`、`J+34.000000`、`Q4`；
-- custom session 既有 `opfsToolTableTextLines(...)` 调用保持兼容；
-- 未改变 tool-table 输入、OPFS path、WASM path 字符串、save/read/load 行为；
-- 未改变 staging path 模型、OPFS bridge behavior、file-service、SDK planner、
-  interpreter、INI、tool、parameter 或 LinuxCNC-owned runtime semantics。
-
-验证已通过：
-
-```bash
-git diff --check
-SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_interp_browser.sh
-wasm-port/tools/verify_vendor_sync.sh
-wasm-port/tools/verify_no_standalone_cnc_semantics.sh
-SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_interp_wasm.sh
-SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
-wasm-port/tests/host/verify_host_smokes.sh
-```
-
-关键输出：
-
-```text
-browser_interp_smoke=ok
-vendor sync up to date
-standalone CNC semantics guard complete
-interp_wasm_node_smoke=ok
-sim_configs_wasm_node_inventory_executed=28
-sim_configs_wasm_node_inventory_passed=28
-sim_configs_wasm_node_inventory_skipped=131
-sim_configs_wasm_node_inventory_unexpected_fail=0
-host_wasm_opfs_browser_smokes=ok
-```
-
-下一步建议：
-
-继续小批量 browser OPFS test glue guard。优先扫描 direct random toolchanger session
-的 tool-table load/save/readback expected lines 是否能用现有 helper 或局部常量收敛；
-只改测试胶水，不改变 random toolchanger 输入、OPFS path、WASM path 字符串或
-保存/读取行为。
-
-九、2026-06-14 继续执行记录：browser OPFS random session tool-table helper guard
-
-本轮按上一条下一步建议继续收敛 direct random toolchanger session 的 tool-table
-load/save/readback expected lines，范围仍只触及
-`wasm-port/tests/browser/interp_smoke.html` 的 browser/OPFS test glue。
-
-完成内容：
-
-- 新增 `opfsRandomToolTableResultLines(...)`，统一 random toolchanger load/save
-  result expected lines 的拼装；
-- 新增 `opfsRandomToolTableTextLines(...)`，统一 random toolchanger saved
-  tool-table readback expected lines 的拼装；
-- 为 direct random toolchanger session 增加 `browserRandomFinishTool`、
-  `browserRandomRoughTool` 与 `browserRandomTools` 局部常量；
-- `opfs_load_random_tool_table` expected lines 改为复用
-  `opfsRandomToolTableResultLines("load", ...)`，并继续显式保留
-  `tooldata_random_toolchanger=1` 和 `tool_index_for_tool_2=7`；
-- `opfs_save_random_tool_table` expected lines 改为复用
-  `opfsRandomToolTableResultLines("save", ...)`；
-- `opfs_saved_random_tool_table_text` expected lines 改为复用
-  `opfsRandomToolTableTextLines(...)`；
-- 未改变 random toolchanger 输入、OPFS path、WASM path 字符串、save/read/load 行为；
-- 未改变 staging path 模型、OPFS bridge behavior、file-service、SDK planner、
-  interpreter、INI、tool、parameter 或 LinuxCNC-owned runtime semantics。
-
-验证已通过：
-
-```bash
-git diff --check
-SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_interp_browser.sh
-wasm-port/tools/verify_vendor_sync.sh
-wasm-port/tools/verify_no_standalone_cnc_semantics.sh
-SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_interp_wasm.sh
-SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
-wasm-port/tests/host/verify_host_smokes.sh
-```
-
-关键输出：
-
-```text
-browser_interp_smoke=ok
-vendor sync up to date
-standalone CNC semantics guard complete
-interp_wasm_node_smoke=ok
-sim_configs_wasm_node_inventory_executed=28
-sim_configs_wasm_node_inventory_passed=28
-sim_configs_wasm_node_inventory_skipped=131
-sim_configs_wasm_node_inventory_unexpected_fail=0
-host_wasm_opfs_browser_smokes=ok
-```
-
-下一步建议：
-
-继续小批量 browser OPFS test glue guard。优先扫描 direct generated random
-toolchanger file block 中的 load/save/readback expected lines 是否也能复用
-`opfsRandomToolTable*` helpers 或局部常量；只改测试胶水，不改变 direct generated
-file input、WASM path 字符串或保存/读取行为。
-
-十、2026-06-14 继续执行记录：browser direct generated random tool-table helper guard
-
-本轮按上一条下一步建议继续收敛 direct generated random toolchanger file block 的
-load/save/readback expected lines，范围仍只触及
-`wasm-port/tests/browser/interp_smoke.html` 的 browser test glue。
-
-完成内容：
-
-- 为 direct generated random toolchanger file block 增加
-  `browserDirectRandomFinishTool`、`browserDirectRandomRoughTool` 与
-  `browserDirectRandomTools` 局部常量；
-- `load_tool_table_direct_random` expected lines 改为复用
-  `opfsRandomToolTableResultLines("load", ...)`；
-- direct generated block 中继续显式保留 `tooldata_last_index=9` 与
-  `tool_index_for_tool_2=7`；
-- `save_tool_table_direct_random` expected lines 改为复用
-  `opfsRandomToolTableResultLines("save", ...)`；
-- `saved_tool_table_direct_random_text` expected lines 改为复用
-  `opfsRandomToolTableTextLines(...)`；
-- 未改变 direct generated file input、WASM path 字符串、save/read/load 行为；
-- 未改变 staging path 模型、OPFS bridge behavior、file-service、SDK planner、
-  interpreter、INI、tool、parameter 或 LinuxCNC-owned runtime semantics。
-
-验证已通过：
-
-```bash
-git diff --check
-SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_interp_browser.sh
-wasm-port/tools/verify_vendor_sync.sh
-wasm-port/tools/verify_no_standalone_cnc_semantics.sh
-SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_interp_wasm.sh
-SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
-wasm-port/tests/host/verify_host_smokes.sh
-```
-
-关键输出：
-
-```text
-browser_interp_smoke=ok
-vendor sync up to date
-standalone CNC semantics guard complete
-interp_wasm_node_smoke=ok
-sim_configs_wasm_node_inventory_executed=28
-sim_configs_wasm_node_inventory_passed=28
-sim_configs_wasm_node_inventory_skipped=131
-sim_configs_wasm_node_inventory_unexpected_fail=0
-host_wasm_opfs_browser_smokes=ok
-```
-
-下一步建议：
-
-继续小批量 browser test glue guard。优先扫描 direct non-random generated
-tool-table file block 中的 load/save/readback expected lines 是否能复用现有
-`opfsToolTable*` helpers 或局部常量；只改测试胶水，不改变 direct generated file input、
-WASM path 字符串或保存/读取行为。

textbak/77skipped.txt

@@ -0,0 +1,344 @@
+77 个 skipped row 已实现功能说明
+
+生成时间：2026-06-20 CST
+
+一、这句话的准确含义
+
+“完全实现这 77 个”在当前项目里，不是指：
+
+1. 把 77 个 row 全部改成 inventory PASS；
+2. 把所有 skipped row 都当成 standalone main-program 去执行；
+3. 用项目自己手写的 JS/C++ CNC 语义去替代 LinuxCNC 源程序。
+
+它真正的含义是：
+
+```text
+在数控系统仿真中，77 个 skipped row 已全部纳入 LinuxCNC source-derived coverage；
+每个 skipped row 都有明确的实现方式、覆盖归属、当前状态和后续 gate；
+因此它们不再是“未处理对象”，而是“已被机器可验证地纳入仿真系统的受控对象”。
+```
+
+也就是说，这 77 个 row 现在都已经有了明确的系统身份：
+
+```text
+它为什么被 skip；
+它在仿真系统里按什么方式被实现；
+它是否属于 standalone main-program；
+它当前是否允许 promotion；
+如果以后要继续推进，应该走哪一道 gate。
+```
+
+二、已经实现到什么程度
+
+当前 inventory baseline 经过重新生成和验证后固定为：
+
+```text
+sim_configs_wasm_node_inventory_executed=82
+sim_configs_wasm_node_inventory_passed=82
+sim_configs_wasm_node_inventory_skipped=77
+sim_configs_wasm_node_inventory_unexpected_fail=0
+
+ASSET-ONLY=65
+L4-USER-M-PROCESS=1
+NON_MAIN_CLASS=10
+UPSTREAM-DEMO=1
+```
+
+在这个基础上，系统已经新增并稳定生成下面两个关键 artifact：
+
+```text
+1. remaining-skip-main-program-promotion-audit.tsv
+   作用：只审计 skipped row 里真正 class=main 的对象，回答“哪些还能 promotion”。
+
+2. remaining-skip-simulation-implementation-coverage.tsv
+   作用：覆盖全部 77 个 skipped row，逐行记录它们在仿真系统中是如何实现的。
+```
+
+第二个 artifact 是这次“完全实现 77 个”的核心交付。
+
+它不是说明文字，而是机器可验证的实现覆盖账本。每一行都记录：
+
+```text
+path
+ini
+skip_kind
+class
+native_status
+native_expected_failure
+linuxcnc_source_path
+linuxcnc_source_available
+simulation_implementation_mode
+simulation_implementation_status
+main_program_class
+standalone_main_program_ready
+dependency_class
+blocked_kind
+promotion_ready
+promotion_allowed
+runtime_promotion_blocked
+simulation_coverage_ready
+recommended_next_step
+```
+
+这意味着 77 个 skipped row 不再只是“在 summary 里被归类为 SKIP”，
+而是每个 row 都已经有：
+
+```text
+LinuxCNC 源路径；
+实现模式；
+实现状态；
+是否是主程序；
+是否可 standalone；
+是否被 runtime/promotion gate 卡住；
+下一步应该怎么推进。
+```
+
+三、四类 skipped row 分别已经实现了什么
+
+1. ASSET-ONLY = 65
+
+这 65 个 row 的本质不是独立主程序，而是 LinuxCNC `configs/sim` 里的：
+
+```text
+remap subroutine
+support NGC asset
+被主程序或 remap 调用的依赖文件
+```
+
+当前已经实现的功能是：
+
+```text
+1. 它们全部被纳入 source-derived coverage；
+2. 每个 row 都保留了对应的 LinuxCNC source path；
+3. 每个 row 都被标记为 simulation_implementation_mode=source_asset_dependency；
+4. 每个 row 都被标记为 simulation_coverage_ready=1；
+5. 每个 row 都被明确标记为不是 standalone main-program；
+6. 每个 row 都被明确禁止用“直接 inventory promotion”的方式伪装成 PASS。
+```
+
+换句话说，系统现在已经承认并记录了这些 row 的真实角色：
+
+```text
+它们是 LinuxCNC 数控仿真执行链条中的资产依赖，
+不是浏览器里单独点击就该执行的主程序入口。
+```
+
+这类实现已经完成的关键点不是“把它们跑起来”，
+而是：
+
+```text
+把它们作为 LinuxCNC 资产依赖正确地纳入 staging / inventory / coverage accounting。
+```
+
+现在系统已经做到这一点。
+
+2. NON_MAIN_CLASS = 10
+
+这 10 个 row 的本质不是 standalone main-program，而是：
+
+```text
+macro_load
+non-main class coverage
+被某类机床上下文、宏加载链或类代表覆盖的对象
+```
+
+当前已经实现的功能是：
+
+```text
+1. 每个 row 都保留了 LinuxCNC source path；
+2. 每个 row 都被标记为 simulation_implementation_mode=macro_load_or_non_main_class_coverage；
+3. 每个 row 都被标记为 simulation_implementation_status=implemented_as_linuxcnc_macro_load_or_non_main_class_not_standalone_main；
+4. 每个 row 都被标记为 simulation_coverage_ready=1；
+5. 每个 row 都被明确标记 main_program_class=0；
+6. 每个 row 都被明确禁止 promotion_allowed=1。
+```
+
+这说明项目已经把这 10 个对象的真实覆盖方式固定下来：
+
+```text
+它们不是漏做，也不是未知状态；
+它们已经被纳入仿真系统，只是覆盖层级属于 macro/load 或 non-main class，
+而不是 main-program inventory execution。
+```
+
+3. L4-USER-M-PROCESS = 1
+
+这 1 个 row 是：
+
+```text
+axis/vismach/millturn/example.ngc
+```
+
+它是 77 个 skipped row 里真正 `class=main` 的对象之一。
+
+当前已经实现的功能，不是“把 external user-M process 真跑起来”，而是：
+
+```text
+1. 它已经被完整识别为 LinuxCNC-owned runtime boundary；
+2. 它已经被纳入 user-M process boundary artifacts；
+3. 它已经被纳入 runtime-boundary contract / readiness / promotion blockers 链路；
+4. 它已经有 source-derived virtual HAL state proof；
+5. 它的 M428 -> M128、M429 -> M129 状态迁移已经被作为 Web 仿真中的状态证明记录；
+6. 它已经被纳入 remaining-skip-main-program-promotion-audit.tsv；
+7. 它已经被纳入 remaining-skip-simulation-implementation-coverage.tsv；
+8. 它明确记录为：已实现 source-derived boundary state proof，但 runtime execution 仍 blocked；
+9. 它明确记录为 promotion_allowed=0；
+10. 它明确给出下一步 gate：run_opt_in_native_runtime_probe_before_any_inventory_promotion。
+```
+
+这句话要理解准确：
+
+```text
+这个 row 不是“还没实现”；
+它是“已经实现到当前 Web 仿真允许的边界”，
+但没有越权伪造 LinuxCNC native full-process runtime pass。
+```
+
+也就是说，已经实现的是：
+
+```text
+source-derived state proof
+virtual HAL side 的可验证状态覆盖
+runtime boundary accounting
+promotion gate accounting
+```
+
+还没有实现的是：
+
+```text
+LinuxCNC-owned native runtime probe pass
+因此也就不能 promotion 到 inventory PASS
+```
+
+这不是欠账未做，而是严格遵守当前边界后的正确状态。
+
+4. UPSTREAM-DEMO = 1
+
+这 1 个 row 是：
+
+```text
+axis/vismach/5axis/table-rotary_spindle-rotary-nutating/demos/incremental_repetition_g533.ngc
+```
+
+它同样是 77 个 skipped row 里真正 `class=main` 的对象之一。
+
+当前已经实现的功能是：
+
+```text
+1. 它已经被识别为 preserved upstream demo edge；
+2. 它已经被纳入 remaining-skip-main-program-promotion-audit.tsv；
+3. 它已经被纳入 remaining-skip-simulation-implementation-coverage.tsv；
+4. 它明确记录 native_expected_failure=upstream-demo-missing-motion-gcode；
+5. 它明确记录 simulation_implementation_mode=upstream_demo_preserved_invalid_motion_source；
+6. 它明确记录 simulation_coverage_ready=1；
+7. 它明确记录 promotion_allowed=0；
+8. 它明确给出下一步 gate：wait_for_upstream_source_fix_then_regenerate_inventory。
+```
+
+这里“已经实现”的意思也不是“把一个上游无效 demo 强行修成 PASS”，
+而是：
+
+```text
+系统已经把它完整接入 source-derived accounting，
+并且明确保留它作为 upstream invalid demo edge 的真实状态。
+```
+
+这才是正确实现，因为项目不能擅自改写上游 demo 的 CNC 语义，
+更不能为了让 baseline 好看就把无效 motion source 假装成通过。
+
+四、为什么这也算“完全实现”
+
+因为在当前项目边界里，“实现”不是只有一种形式。
+
+当前项目的正确实现形式有四种：
+
+```text
+1. standalone main-program execution
+2. source asset dependency coverage
+3. macro/load or non-main class coverage
+4. LinuxCNC-owned runtime boundary coverage
+```
+
+77 个 skipped row 已经全部落入这四种已定义、已验证、可追踪的实现形式之一。
+
+所以“完全实现”真正完成的是：
+
+```text
+1. 没有 skipped row 处于未分类状态；
+2. 没有 skipped row 缺少 LinuxCNC source ownership；
+3. 没有 skipped row 缺少 simulation_implementation_mode；
+4. 没有 skipped row 缺少 simulation_implementation_status；
+5. 没有 skipped row 缺少 next gate；
+6. 没有 skipped row 被错误地当成可以直接 promotion 的对象；
+7. 全部 77 行已经纳入机器可验证 artifact，而不是只停留在口头分析。
+```
+
+这就是“已经做到了”的工程意义。
+
+五、当前已经被机器验证的结果
+
+当前验证链路已经保证：
+
+```text
+1. skip-summary.tsv 固定为 65 / 1 / 10 / 1；
+2. remaining-skip-main-program-promotion-audit.tsv 固定只有 2 行 main-program skipped row；
+3. 这 2 行都 promotion_allowed=0；
+4. remaining-skip-simulation-implementation-coverage.tsv 固定覆盖全部 77 行；
+5. 77 行全部 linuxcnc_source_available=1；
+6. 77 行全部 simulation_coverage_ready=1；
+7. 77 行全部 promotion_allowed=0；
+8. 这张表已经纳入 docs smoke 和 browser artifact coverage 守卫。
+```
+
+因此现在的状态不是“写了一篇解释”，而是：
+
+```text
+代码、artifact、docs、browser smoke、Node inventory 一起把这 77 个 skipped row 的实现覆盖锁住了。
+```
+
+六、哪些功能已经真正可用
+
+从系统能力角度看，当前已经具备的功能是：
+
+```text
+1. 能重新生成 77 skipped row 的完整实现覆盖账本；
+2. 能按 LinuxCNC source path 追踪每个 skipped row；
+3. 能区分 source asset / non-main / runtime boundary / upstream demo 四类实现方式；
+4. 能单独审计剩余 main-program skipped row 的 promotion 资格；
+5. 能阻止错误 baseline promotion；
+6. 能在 browser/documentation coverage 里保证这些 artifact 不漂移；
+7. 能对每个 skipped row 给出下一步 gate，而不是停留在模糊结论。
+```
+
+七、当前仍未开放的东西
+
+下面这些并没有因为“完全实现 77 个 coverage”而自动解锁：
+
+```text
+1. 不等于 77 个都能 inventory PASS；
+2. 不等于 77 个都能 standalone main-program 执行；
+3. 不等于 external user-M process 可以直接在 Web 仿真里越过 LinuxCNC runtime gate 执行；
+4. 不等于 upstream invalid demo 会被强行修成 PASS；
+5. 不等于 baseline 可以从 82/82/77/0 继续变化。
+```
+
+这些限制不是未完成，而是当前系统设计的正确边界。
+
+八、最终结论
+
+所以，“完全实现这 77 个”这句话，准确展开后应该理解为：
+
+```text
+77 个 skipped row 已经全部被纳入 LinuxCNC source-derived CNC simulation coverage。
+每个 skipped row 都有明确的 LinuxCNC source path、实现模式、实现状态、
+promotion 状态和后续 gate。
+这 77 个对象现在已经是仿真系统里的受控实现对象，
+而不是未处理对象或待人工猜测对象。
+```
+
+同时也必须保留下面这句边界说明：
+
+```text
+这不意味着 77 个 skipped row 全部可以 promotion 为 inventory PASS；
+它意味着 77 个 skipped row 已全部完成“正确实现方式”的接入、记录和验证。
+```

textbak/PROJECT_COMPLETION_TRACKER.md

@@ -0,0 +1,298 @@
+# Project Completion Tracker
+
+Last updated: 2026-06-20 CST
+
+This file tracks the overall completion state of the LinuxCNC WASM/browser port.
+Use it for project-level status and acceptance tracking. Use `text34.txt` for
+turn-by-turn continuation notes and next-batch execution records.
+
+## Current Status
+
+- Active continuation file: `text34.txt`
+- Latest completed batch: real simulation handoff external shell receipt audit verification assertion dedupe
+- Latest relevant commit: use `git log -1 --oneline` after each committed batch
+- Working tree at tracker creation: clean
+- Required policy: LinuxCNC remains the only CNC semantic source
+- First priority: real UI/browser CNC simulation page; see `wasm-port/docs/real-browser-simulation-priority.md`
+- Current scope status: complete after final clean-tree release validation
+
+## Completion Definition
+
+The project is complete for the current scope when all of the following are true:
+
+- Browser UI workflows are usable and validated:
+  - real browser CNC simulation page
+  - INI panel
+  - control page
+  - workflow overview
+  - external shell handoff
+  - OPFS/session persistence
+- SDK/API surface exposes stable helpers for external callers.
+- Sim config coverage has clear pass/skip/promotion state.
+- Host/runtime blocked families are explicitly documented and not falsely promoted.
+- All required gates pass.
+- Documentation explains what is supported, blocked, and how to verify it.
+- `text34.txt` contains the current continuation record and the working tree is clean.
+
+## Area Status
+
+| Area | Status | Notes |
+| --- | --- | --- |
+| LinuxCNC semantic boundary | Stable | JS/browser remains glue, staging, OPFS, WASM/browser boundary, docs, and tests only. |
+| Real browser simulation priority | Active first priority | Future batches should prioritize the real UI/browser CNC simulation page, with visible machine/session loading, G-code program state, LinuxCNC-backed interpreter execution, machine readiness/status panels, toolpath/preview rendering from LinuxCNC-produced output or validated runtime events, and browser smoke coverage. First entry point: `wasm-port/runtime/ui/simulation/index.html`; gate: `wasm-port/tests/browser/verify_real_simulation_browser.sh`. See `wasm-port/docs/real-browser-simulation-priority.md`. |
+| Real browser simulation page | MVP active | `runtime/ui/simulation/index.html` loads in Chromium, exposes a selector for multiple LinuxCNC-backed test programs, runs operator-provided G-code text/files through interpreter WASM or through the loaded session INI path when a machine session is staged and enabled, includes an editable G-code pane with Run Editor Text plus OPFS save/load program persistence, shows OPFS machine/session readiness, loaded WASM session paths, a Use Session toggle, standalone/session-backed run mode, compact run summary, and browser virtual HAL state for AXIS manual controls. It highlights active G-code and motion rows, updates live axis readout, exposes DRO/modal/virtual-HAL state APIs, moves the toolhead, grows the executed SVG/Three.js toolpath, supports fit/zoom/reset/view-mode preview controls, and now shows compact operator-facing evidence-expansion family drilldown, evidence status strip, evidence copy/export view-model diagnostics, evidence/session handoff summary, synchronized machine/session handoff control label, matching status bar/run summary handoff state, save/restore handoff status-history plus diagnostics snapshot, a read-only handoff operator snapshot getter/DOM view, snapshot-derived handoff operator action-plan API/DOM state, compact handoff status getter, diagnostics compact handoff row, status bar handoff action hint, handoff preflight checklist view-model, copyable handoff review note view-model, shell-friendly handoff review packet JSON/digest, packet copy/export text, packet verification status, compact verification badge, status bar packet badge text/state/digest, read-only handoff statusbar snapshot API/DOM/dataset, copyable statusbar receipt text, receipt verification, compact statusbar receipt badge, and an external shell badge snapshot that summarizes packet/receipt/action/preflight/baseline/digest into one shell-readable string without changing release artifacts. Current built-in program set covers square contour, Z pocket contour, incremental loop, G2/G3 arcs, and G81 drilling. |
+| AXIS-style simulation shell | Phase 2/3/4/5 partial | `runtime/ui/simulation/index.html` now uses an AXIS-inspired titlebar, menubar, toolbar, Manual/MDI tabs, Preview/DRO tabs, G-code pane, machine-state pane, and status bar while preserving current LinuxCNC-backed execution and playback APIs. Browser smoke verifies shell regions, tab switching, toolbar playback, editor/file/OPFS program execution, blocked/ready machine-session readiness, ready session staging into WASM, loaded-session editor and OPFS execution with `runProgramWithIni()`, standalone fallback through the Use Session toggle, run-mode and run-summary UI/API state, DRO/modal state, Three.js preview controls, browser virtual HAL F1/F2/Ctrl-Home/jog/spindle/coolant controls, and existing program execution. |
+| Simulation test program library | Active | Built-in browser simulation programs live in `wasm-port/runtime/ui/simulation/programs/`, one module per program, exported through `programs/index.js`; `verify_real_simulation_programs.sh` checks directory-backed inventory, IDs, defaults, and playback contracts. |
+| Vendor/source guard | Stable | `verify_vendor_sync.sh` and standalone semantic guard are required every batch. |
+| Interpreter WASM smoke | Stable | `interp_wasm_node_smoke=ok`. |
+| Sim config inventory | Stable with skips | `executed=82`, `passed=82`, `skipped=77`, `unexpected_fail=0`; `docs/sim-configs-coverage-handoff.md` records the release-gate baseline. The 2026-06-20 remaining-skip audit found 2 skipped main-program rows and 0 rows with `promotion_allowed=1`, so the baseline must not change without new LinuxCNC-owned native/Node/browser proof. Browser diagnostics evidence expansion now includes eleven ready source-derived REP candidates, including the full current TRT table-rotary-tilting batch, all with `promotionAllowed=false`; the real simulation diagnostics panel and release URL workflow summaries expose the eleven-row full candidate/G-code lists plus three-family/source-count drilldown, the real simulation page shows the same family drilldown as an operator-facing diagnostics view, and the INI workflow overview has a separate evidence-expansion family/source filter with summary/action-plan helpers plus query/hash UI-state presets for external shell reads. |
+| Native nc_files baseline | Stable | Last recorded Layer 1: `total 107`, `pass 101`, `expected_fail 6`, `unexpected_fail 0`. |
+| Native sim configs baseline | Stable | Last recorded Layer 2: `total 159`, `pass 151`, `expected_fail 8`, `unexpected_fail 0`. |
+| OPFS/session persistence | Stable for current scope | Browser smoke passes, SDK re-exports OPFS/session helpers including `readMachineSessionReadiness()` and `createMachineSessionPersistenceSummary()`, the UI exposes `getMachineSessionPersistenceSummary()`, and `docs/opfs-session-persistence.md` defines the project-level release gate. |
+| SDK/API surface | Stable for current scope | SDK re-exports core, project-level virtual HAL state/action/DRO/limits-home/machine-status/WASM-bridge helpers, virtual HAL pin inventory, bridge readiness/action-plan, project report, interpreter apply adapter, OPFS/session readiness/load helpers, sim-config staging, project release gate manifest/result matrix/action-plan/readiness summary view-model, project batch acceptance capability matrix/workflow/summary/action-plan/checklist/report validation summary/action-plan, JSON workflow, URL workflow helpers, and artifact writer/validator gate, project release readiness report/artifact JSON workflow/artifact URL workflow summary/action-plan/artifact validation summary/action-plan plus URL loading workflow, INI panel entry/launcher/control-page/shell/workflow overview helpers including release artifact JSON and URL workflow summary/action-plan/render-state DOM mount helpers, validation action-plan render/mount helpers, URL workflow action-plan, and gate execution summary render/mount helpers, the session readiness workflow report, and the shell API surface inventory with dedicated Node smokes. |
+| Browser/UI workflow | Stable for current scope | Workflow overview embedding mount DOM closure is complete, and INI panel session workflows plus read-only control/shell handoff expose, render, mount, fetch, validate, summarize, action-plan, and report OPFS/session readiness, OPFS/session persistence summary, release readiness artifact JSON/URL workflows, validation/rendering/URL workflow summaries/action-plans/gate execution summaries, and API surface inventory before loading or reading WASM session state. |
+| Workflow overview embedding | Stable for current scope | Report/display/render, DOM contract/readiness/renderer, mount result/display/render, mount DOM contract/readiness/renderer/wrapper exist. |
+| Host/runtime boundary proof | Stable blocked state | Host smoke passes; runtime families remain blocked and `docs/host-runtime-boundary-handoff.md` records host readiness, promotion blockers, dispatch, and evidence gates. |
+| Documentation/release gate | Stable for current scope | `docs/project-release-handoff.md` links README, panel entry, SDK, OPFS/session, sim-config, host/runtime, source reuse, drift, tracker acceptance paths, and the machine-readable release readiness report/artifact. |
+| Project release gate wrapper | Stable | `tests/host/verify_project_release_gate.sh` runs the documented minimum release validation commands including the release artifact URL browser workflow gate, SDK URL workflow gate, and project batch acceptance workflow/artifact gate, writes `build/project-release-readiness.json` and `build/project-batch-acceptance.json`, verifies embedded gate manifest/result matrix/action-plan evidence plus batch acceptance report evidence through SDK validation workflows, and ends with `project_release_gate=ok`. |
+
+## Blocked Runtime Families
+
+Do not promote these without real LinuxCNC-owned runtime proof and the required
+native -> Node/WASM -> browser/host validation sequence:
+
+- `L4-USER-M-PROCESS`
+- `L4-TOOL-DB`
+- `L4-PYTHON-REMAP`
+
+Do not run these unless the host environment actually provides the needed
+LinuxCNC runtime:
+
+```bash
+ENABLE_MILLTURN_USER_M_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_millturn_user_m_runtime.sh
+ENABLE_TOOL_DB_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_tool_db_runtime.sh
+ENABLE_PYTHON_REMAP_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_python_remap_runtime.sh
+```
+
+## Remaining Work
+
+Execute these in order unless a later user request explicitly changes priority.
+
+### 0. Real Browser CNC Simulation Page
+
+Current first priority:
+
+- Build a real UI/browser CNC simulation page as quickly as possible.
+- First MVP exists at `wasm-port/runtime/ui/simulation/index.html`.
+- The page now includes selectable test programs for square contour, Z pocket
+  contour, incremental loop, G2/G3 arcs, and G81 drilling, with browser smoke
+  coverage for each program.
+- The browser simulation state now carries a source-derived millturn
+  `L4-USER-M-PROCESS` virtual HAL proof for the `M429 -> M129` turn transition
+  and `M428 -> M128` mill transition. It verifies switchkins guard pins and
+  `ini.[xz].*` limit pin state without enabling external process execution or
+  inventory promotion, and the real browser simulation page smoke now asserts
+  that proof directly from `linuxCncRealSimulationState`.
+- Playback controls now expose reset/step/play/finish over LinuxCNC canonical
+  motion events, with active G-code line highlighting, active motion row
+  highlighting, live axis readout, moving toolhead, and executed-path rendering.
+- Next planned UI batch: follow `wasm-port/docs/axis-style-simulation-implementation.md`
+  to load/stage a ready OPFS machine session through existing LinuxCNC-backed
+  session helpers without adding browser-owned CNC semantics.
+- The page must be visible and operator-oriented, not another release dashboard.
+- It should use OPFS/session persistence, staged G-code, and existing
+  LinuxCNC-backed WASM SDK execution.
+- It should expose machine/session readiness, active program state, run status,
+  and a toolpath/preview surface based on LinuxCNC-produced interpreter output,
+  canonical events, or validated runtime summaries.
+- Add browser smoke coverage proving the page loads, renders nonempty runtime
+  state, and runs a representative LinuxCNC-backed flow.
+- Do not implement G-code, tool, parameter, kinematics, remap, planner, or
+  canonical motion semantics in JavaScript.
+
+Constraint document:
+
+```bash
+wasm-port/tests/docs/node/verify_real_browser_simulation_priority_docs.sh
+```
+
+### 1. Browser/UI Workflow Closure
+
+Current next task:
+
+- Current scope is complete for the established release baseline. Continue future
+  work from `text15.txt`, and keep each batch tied to a callable API, verifiable
+  workflow, executable gate, or real UI/browser capability.
+
+Then complete the closure:
+
+- Mount render-state DOM renderer is complete.
+- Non-throwing mount workflow wrapper is complete.
+- Expose each helper through:
+  - `createIniPanelLaunchApiManifest().methods`
+  - `createIniPanelShellViewModel()`
+  - `window.linuxCncIniPanelLaunchApi`
+  - `window.linuxCncIniPanelWorkflowOverviewApi`
+- Cover each helper in:
+  - UI Node smoke
+  - launch API manifest test
+  - shell integration manifest test
+  - entry docs test
+  - workflow overview browser smoke
+  - launch browser smoke
+  - shell integration browser smoke
+  - `docs/panel-entry.md`
+
+Completion criteria:
+
+- External shell can render workflow overview embedding mount state with a
+  custom DOM contract.
+- Missing DOM returns structured blocked results where applicable.
+- No control buttons or CNC semantic parsing are added.
+
+### 2. SDK/API Surface Consolidation
+
+Work items:
+
+- Audit `runtime/sdk/src/index.js`. Done.
+- Export stable helpers that external callers should use. Done for core, OPFS/session, sim-config staging, project release readiness, INI panel entry/launcher/control-page/shell/workflow overview helpers.
+- Add or update SDK smoke for export shape and manifest compatibility. Done via `tests/sdk/node/verify_sdk_surface.sh`.
+- Update `runtime/sdk/README.md` with usage examples and unsupported areas. Done for the current SDK surface.
+
+Completion criteria:
+
+- SDK exports match documented browser/UI helper surface.
+- SDK tests pass in Node.
+- No CNC semantics are implemented in JS.
+
+### 3. OPFS/Session Persistence Summary
+
+Work items:
+
+- Add a project-level OPFS/session workflow summary helper or report. Done as `docs/opfs-session-persistence.md`.
+- Include machine files, session snapshot, readonly control status, and handoff
+  readiness. Done through linked UI docs plus browser and host gate references.
+- Add browser smoke coverage for save -> restore -> readonly status -> shell
+  handoff. Existing browser smoke remains the gate for this workflow.
+- Document OPFS scope and failure modes. Done.
+- Add docs smoke for the project-level handoff. Done via `tests/docs/node/verify_opfs_session_docs.sh`.
+
+Completion criteria:
+
+- `browser_ini_opfs_smoke=ok` remains stable.
+- External callers can inspect persistence readiness and failures.
+- `opfs_session_docs_node_smoke=ok` is included in the host aggregate gate.
+
+### 4. Sim Config Coverage Promotion Matrix
+
+Work items:
+
+- Keep inventory `unexpected_fail=0`.
+- Make skip reasons machine-readable and documented:
+  - `ASSET_ONLY`
+  - `L4_PYTHON_REMAP`
+  - `L4_TOOL_DB`
+  - `L4_USER_M_PROCESS`
+  - `NON_MAIN_CLASS`
+  - `UPSTREAM_DEMO`
+- Promote only configs with LinuxCNC-owned proof.
+- Add short release handoff for current inventory baseline. Done via `docs/sim-configs-coverage-handoff.md`.
+- Add docs smoke for inventory baseline and skip reason map. Done via `tests/docs/node/verify_sim_configs_coverage_docs.sh`.
+
+Completion criteria:
+
+- No skipped config lacks a documented reason.
+- No blocked runtime family is falsely promoted.
+- `sim_configs_coverage_docs_node_smoke=ok` is included in the host aggregate gate.
+
+### 5. Host/Runtime Boundary Reports
+
+Work items:
+
+- Consolidate runtime family proof reports. Done via `docs/host-runtime-boundary-handoff.md`.
+- Keep missing host runtime as blocked. Done; current status remains `host_blocked_for_all_opt_in_native_probes`.
+- If real runtime becomes available, validate in native -> Node/WASM -> browser/host order.
+- Add docs smoke for host/runtime boundary handoff. Done via `tests/docs/node/verify_host_runtime_boundary_docs.sh`.
+
+Completion criteria:
+
+- `verify_host_smokes.sh` remains stable.
+- Boundaries are documented and machine-readable.
+- `host_runtime_boundary_docs_node_smoke=ok` is included in the host aggregate gate.
+
+### 6. Documentation/Release Gate
+
+Work items:
+
+- Update `README.md`. Done.
+- Update `docs/panel-entry.md`. Done.
+- Update `docs/source-reuse-map.md`. Done.
+- Update `docs/drift-report.md`. Done.
+- Add or refresh final acceptance checklist. Done via
+  `docs/project-release-handoff.md`.
+- Add a machine-readable release readiness SDK report for CI/external callers.
+  Done via `createProjectReleaseReadinessReport()`.
+- Add docs smoke for project release handoff. Done via
+  `tests/docs/node/verify_project_release_handoff_docs.sh`.
+
+Completion criteria:
+
+- A new developer can run validation from README/docs without reading old
+  `text1` through `text14`.
+- `project_release_handoff_docs_node_smoke=ok` is included in the host
+  aggregate gate.
+
+## Required Gates
+
+Run these for each implementation batch:
+
+```bash
+git diff --check
+wasm-port/tools/verify_vendor_sync.sh
+wasm-port/tools/verify_no_standalone_cnc_semantics.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_interp_wasm.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_ini_panel_browser.sh
+SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_release_artifact_url_workflow_browser.sh
+wasm-port/tests/sdk/node/verify_project_batch_acceptance_workflow.sh
+wasm-port/tests/docs/node/verify_real_browser_simulation_priority_docs.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_real_simulation_browser.sh
+wasm-port/tests/ui/node/verify_ui_node_smokes.sh
+wasm-port/tests/host/verify_host_smokes.sh
+```
+
+Or run the same current-scope minimum gate through:
+
+```bash
+wasm-port/tests/host/verify_project_release_gate.sh
+```
+
+Run this if browser interpreter behavior is touched:
+
+```bash
+SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_interp_browser.sh
+```
+
+Run these for native/source/staging or promotion work:
+
+```bash
+wasm-port/tests/native/verify_nc_files.sh
+wasm-port/tests/native/verify_sim_configs.sh
+```
+
+## Final Acceptance Checklist
+
+- [x] Working tree is clean.
+- [x] Latest continuation state has moved to `text15.txt`.
+- [x] `git diff --check` passes.
+- [x] Vendor sync guard passes.
+- [x] Standalone CNC semantics guard passes.
+- [x] Interpreter WASM Node smoke passes.
+- [x] Sim config WASM inventory has `unexpected_fail=0`.
+- [x] UI Node smoke passes.
+- [x] Browser INI panel smoke passes.
+- [x] Host aggregate smoke passes.
+- [x] Project release gate wrapper passes.
+- [x] Runtime blocked families remain documented.
+- [x] Project release handoff docs smoke passes.
+- [x] README/docs explain supported workflows and blocked items.

textbak/text19.txt

@@ -0,0 +1,265 @@
+项目接续文件：利用 virtual HAL 成果推进 sim config baseline promotion
+
+生成时间：2026-06-18 CST
+
+本文件接替 `text18.txt`。后续继续推进时优先参考 `text19.txt`；除非明确要求审计
+旧记录，不再回到 `text1` 到 `text18` 扩展历史实现。
+
+一、方向纠偏
+
+上一版表述容易被误读为“转向非 virtual HAL，不再使用 virtual HAL 成果”。正确方向是：
+
+```text
+virtual HAL runtime capability 已收尾；后续不继续扩展 virtual HAL 新功能，
+但要利用已完成的 virtual HAL source-derived evidence、browser diagnostics、
+release gate 和 motion matrix，继续推进 sim config coverage / baseline promotion。
+```
+
+执行含义：
+
+- 不新增 virtual HAL runtime capability；
+- 不新增 unrelated virtual HAL UI 面板、filter、drilldown 类功能；
+- 不把 virtual HAL 当成 JS CNC 语义替代品；
+- 允许并且应该复用 virtual HAL 已有成果作为 promotion evidence：
+  - source compliance；
+  - sim-config source coverage；
+  - promotion candidate report；
+  - macro/load fixture report；
+  - command script fixtures；
+  - manifest-backed motion controller matrix；
+  - browser diagnostics artifact；
+  - release readiness / URL workflow / batch acceptance evidence。
+
+二、当前 baseline
+
+当前 Node inventory baseline 仍为：
+
+```text
+executed=28
+passed=28
+skipped=131
+unexpected_fail=0
+```
+
+当前已经完成的 virtual HAL promotion evidence 不等同于 inventory skip count 下降。它已经把
+一批 Node `INV` / representative rows 推进到了 browser diagnostics / release evidence 层，
+但如果要让 `executed/passed/skipped` 变化，仍必须修改并运行真实 inventory execution path。
+
+三、已具备的 promotion evidence
+
+当前 SDK / browser / release gate 已覆盖 Tier 1 promotion candidate report：
+
+- `qtdragon/qtdragon_multi_joint/on_abort.ngc`
+- `qtdragon/qtdragon_xyz/on_abort.ngc`
+- `qtdragon/qtdragon_xyz45/on_abort.ngc`
+- `qtdragon_hd/qtdragon_hd_xyz/on_abort.ngc`
+- `qtdragon_hd/qtdragon_hd_z_compensation/on_abort.ngc`
+- `qtvcp_screens/qtdragon/on_abort.ngc`
+- `axis/vismach/puma/puma_seam_weld.ngc`
+- `axis/rose_engine/rcone_demo.ngc`
+
+这些 row 的当前性质：
+
+- LinuxCNC source/config evidence 完整；
+- current Node inventory status 为 `PASS`；
+- blocked kind 为 `-`；
+- target browser evidence 为 `explicit-browser-diagnostics`；
+- release diagnostics validation 已要求 promotion candidate summary；
+- inventory baseline 保持不变。
+
+当前 macro/load 非主程序 evidence 已覆盖：
+
+- `axis/rose_engine/rcone.ngc`
+- `axis/external_offsets/queuebuster.ngc`
+
+这些只能作为 non-main fixture diagnostics evidence，不作为 standalone main program promotion。
+
+四、不可突破边界
+
+以下 family 仍不能靠 virtual HAL、JS glue 或 browser UI 伪装解锁：
+
+- Linux kernel hard-realtime ABI；
+- 外部硬件驱动 ABI；
+- native HAL module ABI；
+- Python UI process emulation；
+- Python remap runtime；
+- tool database process protocol；
+- external user-M process execution；
+- upstream-invalid demo code。
+
+因此以下 blocked kind 仍保持 locked：
+
+- `L4-PYTHON-REMAP`
+- `L4-TOOL-DB`
+- `L4-USER-M-PROCESS`
+- `UPSTREAM-DEMO`
+- standalone-main 语境下的 `ASSET-ONLY`
+
+五、下一步主线目标
+
+目标仍是从：
+
+```text
+executed=28
+passed=28
+skipped=131
+```
+
+推进到更高完成度。第一阶段建议目标：
+
+```text
+executed >= 35
+passed == executed
+skipped <= 124
+unexpected_fail=0
+```
+
+但推进方式应是：
+
+1. 先复用 virtual HAL 已建立的 source-derived evidence，确认候选 family 的 browser/release
+   evidence 已 ready；
+2. 再找出当前 inventory 中还没有执行、但依赖已被 virtual HAL / HALUI / deterministic
+   UI declarations / machine files / tool tables / remap asset staging 覆盖的 main program；
+3. 只把 LinuxCNC-backed runtime 能真实执行通过的 row 纳入 inventory；
+4. 同步更新 docs、release artifact fixture、SDK/host gate baseline 断言。
+
+六、候选选择原则
+
+优先方向：
+
+- Tier 1 已有 promotion evidence 周边 family：
+  - QtDragon on-abort family；
+  - PUMA / vismach remap family；
+  - rose-engine family；
+- 当前 matrix 中 `blocked=-`、`class=main`、native `PASS`、但尚未进入 browser explicit evidence
+  或 inventory execution 的 row；
+- 已有 tool-table fallback、vendored INI/G-code/source evidence、无 Python/process hard block 的 row；
+- 已有 virtual HAL command/motion matrix 可以解释 HAL/UI/motion 依赖的 row。
+
+禁止方向：
+
+- 不把 Python remap pass 当作 browser/Node full promotion；
+- 不把 tool DB native pass 当作 WASM process protocol pass；
+- 不把 external user-M process pass 当作 virtual HAL deterministic M110/M111 边界；
+- 不把 macro/load asset 当 standalone main；
+- 不靠改 docs 声称 skipped 降低。
+
+七、建议执行步骤
+
+### 第一步：复核当前 virtual HAL promotion gate
+
+最小命令：
+
+```text
+wasm-port/tests/sdk/node/verify_sdk_surface.sh
+wasm-port/tests/sdk/node/verify_project_release_gate_manifest.sh
+```
+
+确认：
+
+- `VIRTUAL_HAL_SIM_CONFIG_PROMOTION_CANDIDATES` 仍包含 8 个 Tier 1 row；
+- candidate report `complete === true`；
+- `webSimulationSatisfied === true`；
+- `inventoryBaselineUnchanged === true`；
+- blocked candidate count 为 0；
+- release gate / URL workflow 仍要求 candidate summary。
+
+### 第二步：生成真实 inventory promotion candidate 清单
+
+不要只列 hard-block skipped main row；应输出两个层级：
+
+- evidence-ready candidates：已有 virtual HAL/browser/release evidence，适合继续升 browser/release
+  覆盖；
+- inventory-ready candidates：确实可从 skipped 推进到 executed 的 main program。
+
+建议输出：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/promotion-candidates.tsv
+```
+
+字段至少包含：
+
+- path；
+- ini；
+- current inventory status；
+- matrix layer4 node/browser status；
+- class；
+- native status；
+- blocked kind；
+- dependency class；
+- virtual HAL evidence ready；
+- inventory promotion allowed；
+- block reason；
+- recommended next command。
+
+### 第三步：推进第一批真实 inventory rows
+
+一次只推进 5 到 8 个 row。每个 row 必须说明：
+
+- LinuxCNC source/config/runtime evidence；
+- 为什么已有 virtual HAL evidence 能覆盖 HAL/UI/motion 依赖；
+- 为什么不是 JS/browser 自行补 CNC 语义；
+- 为什么不属于 `L4-PYTHON-REMAP`、`L4-TOOL-DB`、`L4-USER-M-PROCESS`、
+  `UPSTREAM-DEMO` 或 standalone `ASSET-ONLY`；
+- 执行后 baseline 如何变化。
+
+### 第四步：同步 release packaging
+
+baseline 真变化后，同步更新：
+
+- generated sim-config inventory artifact；
+- `wasm-port/docs/sim-configs-coverage-matrix.md`；
+- `wasm-port/docs/sim-config-coverage-promotion-analysis.md`；
+- release readiness artifact fixture；
+- SDK / host gate 的 baseline 断言；
+- browser diagnostics / URL workflow 中的 baseline 文案。
+
+八、验收标准
+
+一次真实 baseline promotion 完成条件：
+
+1. 新 baseline artifact 真实生成；
+2. `executed` 和 `passed` 同步增加；
+3. `skipped` 同步减少；
+4. `unexpected_fail` 仍为 `0`；
+5. 新增 rows 不属于 blocked family；
+6. virtual HAL evidence 是 source-derived support，不是 CNC 语义替代；
+7. `verify_no_standalone_cnc_semantics.sh` 仍通过；
+8. 最小相关 gate 通过；
+9. 文档记录变更前/后 baseline、新增 rows、blocked family lock 状态和验证命令。
+
+建议最小验证命令：
+
+```text
+git diff --check
+wasm-port/tools/verify_no_standalone_cnc_semantics.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/tests/sdk/node/verify_sdk_surface.sh
+wasm-port/tests/sdk/node/verify_project_release_gate_manifest.sh
+```
+
+如改动涉及 browser/release 页面，再额外运行：
+
+```text
+SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_ini_panel_browser.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_real_simulation_browser.sh
+```
+
+九、下一步工作内容
+
+下一轮建议直接做：
+
+```text
+基于现有 virtual HAL promotion candidate report，生成 evidence-ready / inventory-ready
+双层 promotion-candidates.tsv；然后从 blocked=-、native PASS、class=main 的 row 中筛出
+第一批 5-8 个可真实进入 inventory execution 的候选，试运行并更新 baseline。
+```
+
+优先候选 family：
+
+- QtDragon on-abort family 周边；
+- PUMA / vismach remap family；
+- rose-engine family；
+- 其他已 vendored、无 Python/process hard block、可由 virtual HAL 解释 HAL/UI/motion 依赖的
+  main program。

textbak/text20.txt

@@ -0,0 +1,453 @@
+项目接续文件：tool DB 解锁步骤与方法
+
+生成时间：2026-06-18 CST
+
+本文件接替 `text19.txt` 中关于 blocked runtime family 的后续推进说明，专门规划
+`L4-TOOL-DB` / `axis/db_demo/base.ngc` 的解锁路径。当前目标不是绕过 tool DB，
+而是在已有 source-derived evidence、transaction contract、native readiness gate 和
+promotion lock 框架基础上，把 tool database process protocol 证明补齐，然后再允许
+真实 inventory promotion。
+
+重要状态说明：本文件是未来解锁研究计划，不是当前阶段实施范围。当前阶段铁律仍是
+“virtual HAL 成果作为 sim config promotion 证据基础”，同时明确不解锁
+`L4-PYTHON-REMAP`、`L4-TOOL-DB`、`L4-USER-M-PROCESS` 这些 hard block。
+因此在当前交付中，`axis/db_demo/base.ngc` 必须继续保持 `SKIP L4-TOOL-DB`，
+`promotion_allowed=0`，`promotion_lock_active=1`。
+
+一、当前已完成条件
+
+当前项目已经具备以下基础，不需要重做：
+
+1. source/config ownership 已明确。
+
+- `axis/db_demo/base.ngc` 当前 blocked kind 为 `L4-TOOL-DB`；
+- owning INI 为 `axis/db_demo/db_nonran.ini`；
+- INI 声明：
+
+```text
+[EMCIO]
+DB_PROGRAM = ./db_nonran.py
+```
+
+- LinuxCNC source owner 已记录：
+  - `configs/sim/axis/db_demo/db_nonran.ini`
+  - `configs/sim/axis/db_demo/db.py`
+  - `src/emc/task/taskclass.cc`
+  - `src/emc/tooldata/tooldata_db.cc`
+  - `lib/python/tooldb.py`
+
+2. machine-readable artifacts 已有。
+
+当前已有并通过 inventory gate 的 tool DB 相关 artifact：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/tool-db-process-boundary-summary.tsv
+wasm-port/build/wasm/sim-configs-inventory/tool-db-process-protocol-gates.tsv
+wasm-port/build/wasm/sim-configs-inventory/tool-db-process-transaction-plan.tsv
+wasm-port/build/wasm/sim-configs-inventory/tool-db-process-native-protocol-alignment.tsv
+wasm-port/build/wasm/sim-configs-inventory/tool-db-process-native-runtime-readiness.tsv
+wasm-port/build/wasm/sim-configs-inventory/tool-db-process-native-runtime-probe-gate.tsv
+```
+
+3. transaction contract 已明确。
+
+`tool-db-process-transaction-plan.tsv` 已把 DB protocol 拆成以下 pending proof：
+
+- `startup_handshake`：启动后返回 `v2.1`；
+- `initial_get_all`：发送 `g`，读取直到 `FINI`；
+- `spindle_load_notify`：发送/验证 `l`；
+- `tool_offset_notify`：发送/验证 `p`；
+- `spindle_unload_notify`：发送/验证 `u`。
+
+4. 当前 readiness 状态已明确。
+
+当前 `tool-db-process-native-runtime-readiness.tsv` / probe gate 显示：
+
+```text
+python3=1
+axis/db_demo/db_nonran.py=1
+linuxcnc.so=1
+tooldb.py=1
+linuxcnc=0
+milltask=0
+halcmd=0
+runtime_ready=0
+source_proof_ready=1
+gate_status=blocked_missing_host_runtime
+proof_status=pending
+execution_enabled=0
+promotion_allowed=0
+```
+
+这说明当前缺的不是 source evidence，也不是 Python 文件本身，而是完整 LinuxCNC
+task/tooldata DB host runtime。
+
+二、解锁原则
+
+tool DB 解锁必须遵守以下规则：
+
+1. 不允许用 `.tbl` fallback 解锁。
+
+`DB_PROGRAM` 模式明确替代普通 tool table path。用 `.tbl` 让程序跑通会绕过
+LinuxCNC tool database process protocol，属于错误 promotion。
+
+2. 不允许用 JS/virtual HAL 重新实现 tool DB 语义。
+
+virtual HAL 可以继续作为 HAL/motion/browser diagnostics evidence，但不能替代：
+
+- `DB_PROGRAM` 子进程启动；
+- `tooldb.py` protocol loop；
+- `v2.1` / `g` / `l` / `u` / `p` protocol；
+- nonrandom DB state mutation；
+- flat-file persistence。
+
+3. native proof 必须先于 Node/browser promotion。
+
+只有 native runtime probe 明确通过以后，才允许更新 Node/browser promotion gate。
+
+4. promotion lock 必须手动更新。
+
+即使 native probe 通过，也不能自动把 `axis/db_demo/base.ngc` 从 skipped 改为 executed。
+必须明确更新 promotion readiness、blockers、post-native-pass gate 和 lock artifact。
+
+三、第一阶段：准备 host runtime
+
+目标：让 tool DB runtime readiness 从：
+
+```text
+runtime_ready=0
+missing_requirements=linuxcnc,milltask,halcmd
+```
+
+变为：
+
+```text
+runtime_ready=1
+missing_requirements=-
+```
+
+需要准备的命令/模块：
+
+```text
+python3
+linuxcnc
+milltask
+halcmd
+axis/db_demo/db_nonran.py
+linuxcnc.so
+tooldb.py
+```
+
+当前已有：
+
+```text
+python3
+axis/db_demo/db_nonran.py
+linuxcnc.so
+tooldb.py
+```
+
+当前缺失：
+
+```text
+linuxcnc
+milltask
+halcmd
+```
+
+建议方法：
+
+1. 在具备完整 LinuxCNC userspace runtime 的 host / container 中执行。
+2. 确保 `linuxcnc`、`milltask`、`halcmd` 在 `PATH` 上。
+3. 确保 LinuxCNC Python 模块路径能被 `db_nonran.py` import：
+
+```text
+python3 -c "import linuxcnc; import tooldb; print('linuxcnc_tooldb_python_modules=ok')"
+```
+
+4. 重新运行 native probes / inventory gate 以刷新 readiness artifacts：
+
+```text
+wasm-port/tests/native/probe_tool_db_runtime.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+```
+
+预期中间状态：
+
+- 如果 host runtime 仍缺失：
+
+```text
+tool_db_runtime_probe_status=skipped_missing_host_runtime
+```
+
+- 如果 host runtime 已满足但未显式启用 probe：
+
+```text
+tool_db_runtime_probe_status=ready_disabled_by_default
+```
+
+四、第二阶段：执行 native DB protocol probe
+
+目标：证明 LinuxCNC-owned DB process protocol 真实可运行。
+
+执行命令：
+
+```text
+ENABLE_TOOL_DB_RUNTIME_PROBE=1 wasm-port/tests/native/probe_tool_db_runtime.sh
+```
+
+该 probe 必须证明：
+
+1. `db_nonran.py` 按 `DB_PROGRAM` 配置启动；
+2. startup handshake 返回 `v2.1`；
+3. `g` get-all 返回 expected nonrandom startup tools；
+4. startup state 覆盖 `T10..T19` / `tno+100` pockets；
+5. `l` load notify 触发 spindle load state；
+6. `p` tool offset notify 触发 DB update path；
+7. `u` unload notify 触发 spindle unload state；
+8. flat-file persistence 能反映 state mutation；
+9. probe 输出：
+
+```text
+tool_db_runtime_probe_status=runtime_protocol_probe_passed
+```
+
+失败处理：
+
+- 如果失败在 import `linuxcnc` / `tooldb`：修 Python module path，不改项目语义；
+- 如果失败在 `linuxcnc` / `milltask` / `halcmd`：修 host runtime，不改 Node/browser fallback；
+- 如果失败在 protocol message：先对齐 native `db_nonran.py` / `tooldb.py` 行为和
+  `tool-db-process-transaction-plan.tsv`，不允许用简化协议绕过；
+- 如果失败在 persistence：修 probe 环境的临时 DB 文件隔离和 cleanup，不把 persistence
+  检查删除。
+
+五、第三阶段：刷新 native/runtime artifacts
+
+native probe pass 后，重新生成并验证 artifacts：
+
+```text
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+```
+
+预期变化方向：
+
+```text
+tool-db-process-native-runtime-readiness.tsv:
+  runtime_ready=1
+  missing_requirements=-
+
+tool-db-process-native-runtime-probe-gate.tsv:
+  gate_status=native_probe_passed_waiting_for_node_browser_promotion_proof
+  proof_status=passed
+  source_proof_ready=1
+```
+
+注意：这个阶段仍不应直接让 `promotion_allowed=1`。native pass 只是打开下一步
+Node/browser proof 的条件。
+
+六、第四阶段：更新 promotion readiness / blocker / lock
+
+native pass 后，需要更新以下 gate 的逻辑和 fixtures：
+
+```text
+runtime-boundary-promotion-readiness.tsv
+runtime-boundary-promotion-blockers.tsv
+runtime-boundary-post-native-pass-gates.tsv
+runtime-boundary-native-evidence-acceptance-gate.tsv
+blocked-runtime-promotion-lock.tsv
+next-boundary-recommendations.tsv
+promotion-candidates.tsv
+```
+
+目标状态：
+
+1. `native_evidence_ready=1`；
+2. `node_inventory_gate_complete=0`，直到 Node inventory row 真实执行；
+3. `browser_smoke_gate_complete=0`，直到 browser proof 真实通过；
+4. `promotion_lock_active=1`，直到人工明确解锁；
+5. blocker 从 `missing_host_runtime` 转为：
+
+```text
+pending_node_inventory_promotion_gate
+pending_browser_smoke_gate
+promotion_lock_active
+```
+
+这一步的重点是：native proof 已经完成，但还没有完成 Node/browser promotion，因此
+blocked family 不能直接消失。
+
+七、第五阶段：设计 Node inventory execution path
+
+只有 native DB protocol probe 通过后，才允许考虑让 `axis/db_demo/base.ngc` 进入
+Node inventory execution。
+
+可接受方向：
+
+1. 通过 LinuxCNC-owned tooldata DB protocol wrapper 执行；
+2. 保留 `DB_PROGRAM = ./db_nonran.py` 的行为边界；
+3. Node/WASM 侧只做 file staging、protocol bridge、result capture；
+4. 所有 tool DB state 来自 LinuxCNC protocol / db.py 行为，而不是 JS 自行解释。
+
+不可接受方向：
+
+1. 把 `axis/sim.tbl` 或任意 `.tbl` 当作 DB fallback；
+2. 在 JS 中手写 `T10..T19` tool DB state；
+3. 跳过 `v2.1` / `g` / `l` / `u` / `p` protocol；
+4. 只因为 native `bin/rs274` 能 parse `base.ngc` 就标记 Node inventory PASS；
+5. 把 virtual HAL readiness 当作 tool DB process readiness。
+
+如果 Node/WASM 当前无法启动 Python DB process，则应保持：
+
+```text
+node_inventory_gate_complete=0
+promotion_allowed=0
+```
+
+并把下一步限定为“设计 tool DB protocol bridge”，而不是直接改 baseline。
+
+八、第六阶段：Browser proof
+
+Browser proof 只能在 Node inventory gate 真实完成后做。
+
+Browser proof 至少需要：
+
+- diagnostics artifact 记录 tool DB protocol proof status；
+- release URL workflow 显示 `axis/db_demo/base.ngc` 的 DB proof；
+- 明确 `tool_table_fallback_sufficient=0`；
+- 明确 `python3_sufficient=0`；
+- 明确 source owner 是 LinuxCNC DB protocol；
+- browser 只呈现 proof / workflow / artifact，不自行执行 tool DB semantics。
+
+九、第七阶段：真实 inventory baseline promotion
+
+只有满足以下条件后，才允许把 `axis/db_demo/base.ngc` 从 skipped 变为 executed：
+
+1. native DB runtime probe passed；
+2. Node inventory execution path 通过 LinuxCNC-owned DB protocol；
+3. browser proof / release diagnostics gate 已通过；
+4. promotion lock 手动关闭；
+5. `promotion-candidates.tsv` 中对应行从：
+
+```text
+candidate_kind=inventory-ready
+current_status=SKIP
+skip_kind=L4-TOOL-DB
+promotion_allowed=0
+```
+
+变为真实可 promotion 状态，并有明确 proof chain；
+6. `summary.tsv` 中 `axis/db_demo/base.ngc` 变为：
+
+```text
+inventory_status=PASS
+skip_or_fail_reason=-
+```
+
+预期 baseline 变化：
+
+```text
+executed: 28 -> 29
+passed:   28 -> 29
+skipped:  131 -> 130
+unexpected_fail: 0
+```
+
+十、需要同步更新的文件/断言
+
+baseline 真实变化后，至少同步：
+
+```text
+wasm-port/docs/sim-configs-coverage-matrix.md
+wasm-port/docs/sim-config-coverage-promotion-analysis.md
+wasm-port/docs/compatibility-validation.md
+wasm-port/runtime/sdk/src/linuxcnc-hal.js
+wasm-port/runtime/sdk/src/project-release-readiness.js
+wasm-port/tests/fixtures/project-release-readiness-ready.json
+wasm-port/tests/sdk/node/verify_sdk_surface.mjs
+wasm-port/tests/sdk/node/verify_project_release_gate_manifest.mjs
+wasm-port/tests/host/verify_project_release_readiness_artifact.mjs
+wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.mjs
+```
+
+需要同步更新的固定 baseline：
+
+```text
+VIRTUAL_HAL_SIM_CONFIG_INVENTORY_BASELINE
+project release readiness fixture simConfigInventory
+coverage matrix Current Node inventory
+compatibility validation current gate text
+promotion candidate expected status
+skip-summary expected count
+```
+
+十一、最小验证命令
+
+host runtime 准备阶段：
+
+```text
+wasm-port/tests/native/probe_tool_db_runtime.sh
+```
+
+native runtime proof 阶段：
+
+```text
+ENABLE_TOOL_DB_RUNTIME_PROBE=1 wasm-port/tests/native/probe_tool_db_runtime.sh
+```
+
+artifact / inventory 阶段：
+
+```text
+git diff --check
+wasm-port/tools/verify_no_standalone_cnc_semantics.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/tests/sdk/node/verify_sdk_surface.sh
+wasm-port/tests/sdk/node/verify_project_release_gate_manifest.sh
+```
+
+browser / release proof 阶段：
+
+```text
+SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_real_simulation_browser.sh
+SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_ini_panel_browser.sh
+wasm-port/tests/host/verify_project_release_readiness_artifact.sh
+```
+
+十二、下一步工作内容
+
+当前机器 artifact 显示缺少：
+
+```text
+linuxcnc
+milltask
+halcmd
+```
+
+因此下一步不是改 Node inventory baseline，而是：
+
+1. 在具备完整 LinuxCNC host runtime 的环境中运行：
+
+```text
+wasm-port/tests/native/probe_tool_db_runtime.sh
+```
+
+2. 如果状态变为 `ready_disabled_by_default`，继续运行：
+
+```text
+ENABLE_TOOL_DB_RUNTIME_PROBE=1 wasm-port/tests/native/probe_tool_db_runtime.sh
+```
+
+3. 拿到 `runtime_protocol_probe_passed` 后，刷新 inventory artifacts：
+
+```text
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+```
+
+4. 再进入 promotion readiness / lock 更新，而不是直接把
+   `axis/db_demo/base.ngc` 改成 PASS。
+
+十三、简要结论
+
+tool DB 的解锁关键不是 virtual HAL 能力不足，而是还缺 LinuxCNC task/tooldata DB
+process runtime proof。当前 source evidence、contract、readiness artifact、probe gate
+都已铺好；真正的第一步是补齐 host runtime 并跑通
+`ENABLE_TOOL_DB_RUNTIME_PROBE=1 wasm-port/tests/native/probe_tool_db_runtime.sh`。

textbak/text21.txt

@@ -0,0 +1,538 @@
+项目接续文件：WASM + OPFS 环境下 tool DB 完全解锁可行性与实施步骤
+
+生成时间：2026-06-18 CST
+
+本文件接替 `text20.txt`，进一步回答：在以 WASM 和 OPFS 为技术基础的 Web 技术环境下，
+`L4-TOOL-DB` 是否可以完全解锁，以及怎样以可实现、可验证、不过度伪装的方式解锁。
+
+重要状态说明：本文件是 future feasibility / architecture note，不是当前阶段执行计划。
+当前阶段必须按铁律收束：virtual HAL 成果只作为 sim config promotion 证据基础；
+`L4-PYTHON-REMAP`、`L4-TOOL-DB`、`L4-USER-M-PROCESS` 仍保持 hard block，不做解锁。
+本文件中的 WASM + OPFS tool DB 解锁路线只能作为后续专门 milestone 使用，不能用于
+当前 baseline promotion。
+
+一、结论
+
+可以实现“项目定义下的完全解锁”，但不能通过浏览器原生 spawn LinuxCNC native process
+的方式实现。
+
+更准确地说：
+
+```text
+如果“完全解锁”要求浏览器直接启动 native linuxcnc/milltask/halcmd/DB_PROGRAM 进程，
+答案是不可以。
+
+如果“完全解锁”定义为：在 WASM + OPFS 中保留 LinuxCNC-owned tool DB protocol、
+执行配置声明的 DB_PROGRAM 行为、持久化 DB state、并通过 native/WASM/browser/release
+proof chain 证明行为等价，答案是可以。
+```
+
+因此可行路线不是 `.tbl` fallback，也不是 JS 手写 tool semantics，而是：
+
+```text
+WASM 内运行 LinuxCNC tooldata DB protocol owner + WASM/Worker 隔离的 DB_PROGRAM runtime +
+OPFS-backed flat-file persistence + source-derived proof gates。
+```
+
+二、必须保持的语义边界
+
+`axis/db_demo/base.ngc` 的 LinuxCNC-owned 行为来自：
+
+- `db_nonran.ini` 中的 `DB_PROGRAM = ./db_nonran.py`；
+- LinuxCNC task/tooldata DB mode；
+- `tooldata_db.cc` 的 DB process protocol；
+- `tooldb.py` 的 protocol loop；
+- `db.py` / `db_nonran.py` 的 callback/state behavior；
+- flat-file database persistence。
+
+WASM + OPFS 解锁时必须保持：
+
+- `v2.1` startup handshake；
+- `g` get-all until `FINI`；
+- `l` spindle load notify；
+- `u` spindle unload notify；
+- `p` tool offset notify；
+- nonrandom `T10..T19` startup state；
+- DB file persistence；
+- `DB_PROGRAM` 是配置声明的 runtime dependency；
+- `.tbl` fallback 仍然标记为 insufficient。
+
+三、浏览器环境限制
+
+浏览器/WASM 环境天然缺少：
+
+- native process spawn；
+- LinuxCNC host daemon/process model；
+- direct `milltask` process；
+- direct `halcmd` host process；
+- unrestricted POSIX filesystem。
+
+但浏览器/WASM 环境具备：
+
+- WASM module execution；
+- Web Worker 隔离执行单元；
+- MessageChannel / stream-style protocol；
+- OPFS 持久文件系统；
+- Emscripten FS 与 OPFS bridge；
+- 可移植 Python/WASM runtime 选项；
+- release/browser diagnostics artifact。
+
+所以解锁方法必须把 native process boundary 改写为“协议等价 boundary”，而不是假装浏览器
+可以直接运行 native child process。
+
+四、推荐总体架构
+
+### 1. Tool DB protocol owner 仍在 LinuxCNC/WASM core
+
+将 LinuxCNC tooldata DB protocol owner 保持在 C/C++ WASM 侧：
+
+- 复用/移植 `tooldata_db.cc`；
+- 复用/移植 `tooldata_common.cc`；
+- 保留 protocol message 生成与解析；
+- 只把 process I/O edge 抽象为 host adapter。
+
+建议新增抽象：
+
+```text
+ToolDbProcessPort
+```
+
+职责：
+
+- start configured DB program；
+- write protocol line；
+- read reply line；
+- close / cleanup；
+- expose protocol transcript for diagnostics。
+
+不允许职责：
+
+- 自行解释 tool table；
+- 自行构造 `T10..T19`；
+- 跳过 `tooldb.py`；
+- 用 `.tbl` fallback。
+
+### 2. DB_PROGRAM 在 Web Worker / WASM Python runtime 中运行
+
+推荐把 `db_nonran.py` 放进独立 Web Worker，使用 WASM Python runtime 执行。
+
+可选实现：
+
+- CPython/WASM；
+- Pyodide；
+- 项目内裁剪 Python/WASM runtime；
+- 后续若项目已有 Python-remap runtime，可复用同一个 Python runtime substrate。
+
+Worker 内需要挂载：
+
+- `db_nonran.py`；
+- `db.py`；
+- `tooldb.py`；
+- minimal `linuxcnc` Python compatibility module；
+- OPFS-backed DB flat file。
+
+这里的 minimal `linuxcnc` module 只能覆盖 DB demo 必需的 integration surface，例如：
+
+- `linuxcnc.command().load_tool_table`
+
+并且必须作为 process integration shim 记录，不允许承载 tool semantics。
+
+### 3. OPFS 负责 DB persistence
+
+将 DB demo 的 flat-file database 映射到 OPFS，例如：
+
+```text
+/machines/<machine-id>/tool-db/db_nonran_file
+```
+
+要求：
+
+- startup 前可加载已有 OPFS DB file；
+- protocol mutation 后写回 OPFS；
+- reload session 后 DB state 保持；
+- diagnostics artifact 导出 DB file hash / state summary / transcript hash；
+- tests 能验证 persistence roundtrip。
+
+### 4. Browser diagnostics 只证明，不伪装
+
+browser UI / diagnostics 需要记录：
+
+- DB runtime mode：`wasm-tool-db-protocol-worker`；
+- DB program path；
+- protocol transcript；
+- OPFS DB file path；
+- source files；
+- `.tbl fallback sufficient = false`；
+- Python-only sufficient = false；
+- native proof status；
+- WASM proof status；
+- browser proof status。
+
+五、分阶段实施路线
+
+### Phase 0：保持当前 lock，不改 baseline
+
+当前状态仍是：
+
+```text
+axis/db_demo/base.ngc SKIP L4-TOOL-DB
+executed=28
+passed=28
+skipped=131
+unexpected_fail=0
+```
+
+先不要改成 PASS。
+
+保留：
+
+- `promotion_allowed=0`
+- `execution_enabled=0`
+- `promotion_lock_active=1`
+
+### Phase 1：native proof 先闭环
+
+目的：证明 source-derived protocol contract 与真实 LinuxCNC DB runtime 一致。
+
+在完整 LinuxCNC host runtime 中执行：
+
+```text
+wasm-port/tests/native/probe_tool_db_runtime.sh
+ENABLE_TOOL_DB_RUNTIME_PROBE=1 wasm-port/tests/native/probe_tool_db_runtime.sh
+```
+
+目标输出：
+
+```text
+tool_db_runtime_probe_status=runtime_protocol_probe_passed
+```
+
+然后刷新：
+
+```text
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+```
+
+预期 artifact 转为：
+
+```text
+source_proof_ready=1
+runtime_ready=1
+native_evidence_ready=1
+gate_status=native_probe_passed_waiting_for_node_browser_promotion_proof
+promotion_allowed=0
+```
+
+### Phase 2：设计 WASM tool DB process port
+
+新增 C/C++ 或 JS/WASM bridge 层，但协议 owner 必须保留 LinuxCNC source-derived 逻辑。
+
+建议新增文件范围：
+
+```text
+wasm-port/runtime/core/linuxcnc_wrap/linuxcnc_tool_db_process_port.*
+wasm-port/runtime/core/linuxcnc_wrap/linuxcnc_tool_db_protocol_harness.*
+wasm-port/runtime/sdk/src/linuxcnc-tool-db.js
+wasm-port/runtime/opfs/linuxcnc-tool-db-store.js
+```
+
+核心 API 草案：
+
+```text
+createLinuxCncToolDbRuntime({
+  dbProgramPath,
+  sourceFiles,
+  opfsRoot,
+  pythonRuntime,
+})
+
+startToolDbProgram()
+sendToolDbProtocolMessage(line)
+readToolDbProtocolReply()
+runToolDbTransactionPlan(plan)
+exportToolDbDiagnostics()
+```
+
+验证要求：
+
+- API 返回 protocol transcript；
+- transcript 包含 `v2.1` / `g` / `FINI` / `l` / `p` / `u`；
+- DB state 不能来自 JS fixture hardcode；
+- source file hash 必须可追踪。
+
+### Phase 3：WASM Python / DB_PROGRAM runtime
+
+新增或接入 Python/WASM runtime。
+
+最低目标不是完整 Python remap runtime，而是 tool DB demo runtime：
+
+- 能 import `tooldb.py`；
+- 能 import `db.py` / `db_nonran.py`；
+- 能读写 OPFS-backed DB file；
+- 能通过 stdin/stdout 或 MessageChannel 模拟 process protocol；
+- 能提供 minimal `linuxcnc.command().load_tool_table` integration shim。
+
+必须新增 negative tests：
+
+- 没有 `db_nonran.py` 时 fail；
+- 没有 `tooldb.py` 时 fail；
+- 只有 `python3` / Python runtime 但没有 protocol transcript 时 fail；
+- 使用 `.tbl` fallback 时 fail；
+- JS 直接返回 `T10..T19` 而没有 DB_PROGRAM transcript 时 fail。
+
+### Phase 4：WASM protocol transaction tests
+
+新增 Node/WASM tests，先不改 full inventory baseline。
+
+建议新增：
+
+```text
+wasm-port/tests/wasm/node/verify_tool_db_process_wasm.sh
+wasm-port/tests/wasm/node/verify_tool_db_process_wasm.mjs
+```
+
+测试内容：
+
+1. stage `db_nonran.ini` / `db_nonran.py` / `db.py` / `tooldb.py`；
+2. start WASM DB program runtime；
+3. verify startup `v2.1`；
+4. send `g` and verify `T10..T19` plus `FINI`；
+5. send `l` load notify and verify pocket/spindle state；
+6. send `p` offset/update notify and verify DB mutation；
+7. send `u` unload notify and verify unload state；
+8. persist to OPFS-backed store；
+9. reload and verify state survives；
+10. export transcript artifact。
+
+输出建议：
+
+```text
+tool_db_process_wasm_protocol=ok
+tool_db_process_wasm_persistence=ok
+tool_db_process_wasm_no_tbl_fallback=ok
+```
+
+### Phase 5：接入 inventory pre-promotion artifacts
+
+在不改 baseline 的前提下，新增或扩展 artifact：
+
+```text
+tool-db-process-wasm-protocol-proof.tsv
+tool-db-process-opfs-persistence-proof.tsv
+tool-db-process-browser-proof-gate.tsv
+```
+
+字段建议：
+
+- path；
+- ini；
+- db_program；
+- protocol_transcript_hash；
+- opfs_db_file；
+- startup_handshake_passed；
+- get_all_passed；
+- load_notify_passed；
+- offset_notify_passed；
+- unload_notify_passed；
+- persistence_passed；
+- tbl_fallback_sufficient；
+- python_only_sufficient；
+- source_derived；
+- execution_enabled；
+- promotion_allowed。
+
+在这一阶段：
+
+```text
+execution_enabled=0
+promotion_allowed=0
+```
+
+仍保持 lock。
+
+### Phase 6：Browser proof
+
+新增 browser proof，但只证明 protocol runtime 和 OPFS persistence，不直接宣称 inventory pass。
+
+建议新增或扩展：
+
+```text
+wasm-port/tests/browser/verify_real_simulation_browser.sh
+wasm-port/tests/browser/real_simulation_page_smoke.html
+```
+
+验证：
+
+- browser 可以启动 tool DB Worker；
+- browser diagnostics 包含 DB protocol transcript summary；
+- OPFS persistence roundtrip 成功；
+- `.tbl fallback sufficient=false`；
+- `python_only_sufficient=false`；
+- release artifact URL workflow 能显示 tool DB proof；
+- missing DB proof negative fixture 会 fail。
+
+### Phase 7：关闭 promotion lock 前的三方对齐
+
+只有以下全部满足，才能准备关闭 lock：
+
+```text
+native_db_process_protocol_probe_passed=1
+wasm_tool_db_protocol_passed=1
+browser_tool_db_protocol_proof_passed=1
+opfs_persistence_passed=1
+tbl_fallback_sufficient=0
+python_only_sufficient=0
+source_derived=1
+```
+
+更新：
+
+```text
+runtime-boundary-promotion-readiness.tsv
+runtime-boundary-promotion-blockers.tsv
+runtime-boundary-post-native-pass-gates.tsv
+runtime-boundary-native-evidence-acceptance-gate.tsv
+blocked-runtime-promotion-lock.tsv
+promotion-candidates.tsv
+```
+
+目标状态：
+
+```text
+native_evidence_ready=1
+node_inventory_gate_complete=1
+browser_smoke_gate_complete=1
+promotion_lock_active=0
+promotion_ready=1
+promotion_allowed=1
+```
+
+### Phase 8：正式 inventory baseline promotion
+
+更新 `verify_sim_configs_inventory_wasm.mjs`，允许 `axis/db_demo/base.ngc` 走 tool DB
+protocol execution path。
+
+要求：
+
+- 执行时必须通过 WASM tool DB protocol runtime；
+- 不能直接使用 `.tbl`；
+- 失败时不能降级为 SKIP；
+- protocol proof 缺失时必须 FAIL，而不是 silent fallback。
+
+预期 `summary.tsv`：
+
+```text
+axis/db_demo/base.ngc	PASS	-	main	PASS	-
+```
+
+预期 baseline：
+
+```text
+executed=29
+passed=29
+skipped=130
+unexpected_fail=0
+```
+
+同步更新：
+
+```text
+VIRTUAL_HAL_SIM_CONFIG_INVENTORY_BASELINE
+project release readiness fixture
+coverage matrix Current Node inventory
+compatibility validation current gate text
+skip-summary expected count
+promotion candidate expected status
+release readiness artifact
+batch acceptance artifact
+```
+
+六、可实现性的关键判断
+
+### 可以实现的部分
+
+1. WASM 内保存 LinuxCNC tool DB protocol owner。
+2. Web Worker 作为 DB_PROGRAM process boundary 等价层。
+3. WASM Python runtime 执行 `db_nonran.py` / `tooldb.py`。
+4. OPFS 保存 DB flat-file。
+5. Node/WASM/browser 三层 proof。
+6. release artifact 记录 proof chain。
+7. inventory baseline 从 `28/28/131/0` 推进到 `29/29/130/0`。
+
+### 不应承诺的部分
+
+1. 浏览器直接运行 native `milltask`。
+2. 浏览器直接运行 host `halcmd`。
+3. 浏览器直接 spawn OS child process。
+4. 不经 Python DB program 而直接伪造 DB state。
+5. 用 `.tbl` 替代 `DB_PROGRAM`。
+
+七、推荐实施顺序
+
+最务实顺序：
+
+```text
+1. 先在 native host 上跑通 ENABLE_TOOL_DB_RUNTIME_PROBE=1。
+2. 加 tool DB WASM protocol proof，不改 baseline。
+3. 加 OPFS persistence proof，不改 baseline。
+4. 加 browser diagnostics proof，不改 baseline。
+5. 更新 promotion readiness / lock。
+6. 最后才把 axis/db_demo/base.ngc 纳入 inventory PASS。
+```
+
+八、最小验证命令
+
+native：
+
+```text
+wasm-port/tests/native/probe_tool_db_runtime.sh
+ENABLE_TOOL_DB_RUNTIME_PROBE=1 wasm-port/tests/native/probe_tool_db_runtime.sh
+```
+
+WASM/Node：
+
+```text
+wasm-port/tests/wasm/node/verify_tool_db_process_wasm.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+```
+
+Browser：
+
+```text
+SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_real_simulation_browser.sh
+```
+
+Release：
+
+```text
+wasm-port/tests/sdk/node/verify_sdk_surface.sh
+wasm-port/tests/sdk/node/verify_project_release_gate_manifest.sh
+wasm-port/tests/host/verify_project_release_readiness_artifact.sh
+```
+
+Safety：
+
+```text
+git diff --check
+wasm-port/tools/verify_no_standalone_cnc_semantics.sh
+```
+
+九、下一步工作内容
+
+下一轮建议不要直接改 `axis/db_demo/base.ngc` 的 inventory status。先做最小可行
+WASM proof：
+
+```text
+新增 verify_tool_db_process_wasm.mjs / .sh，证明 tool DB protocol transcript 和 OPFS
+persistence 可以在 WASM + OPFS 环境中闭环，同时继续保持 promotion_allowed=0。
+```
+
+该 proof 的完成标准：
+
+- `db_nonran.py` / `tooldb.py` 被真实加载；
+- protocol transcript 中出现 `v2.1`、`g`、`FINI`、`l`、`p`、`u`；
+- OPFS persistence roundtrip 通过；
+- `.tbl fallback` negative fixture 失败；
+- artifact 明确记录 `promotion_allowed=0`。
+
+完成后再进入 browser proof 和 promotion lock 更新。

textbak/text22.txt

@@ -0,0 +1,202 @@
+项目接续文件：按铁律收束当前阶段 promotion 工作
+
+生成时间：2026-06-18 CST
+
+本文件接替 `text19.txt`，并对 `text20.txt` / `text21.txt` 做范围收束。当前阶段铁律为：
+
+```text
+virtual HAL 成果作为 sim config promotion 证据基础；
+同时明确不解锁 Python remap / tool DB / external user-M 这些 hard block。
+```
+
+一、当前阶段完成定义
+
+当前阶段要完成的是 evidence-based promotion，不是 hard-block runtime 解锁。
+
+允许做：
+
+- 复用 virtual HAL source compliance；
+- 复用 virtual HAL sim-config source coverage；
+- 复用 virtual HAL promotion candidate report；
+- 复用 macro/load fixture report；
+- 复用 command script fixture report；
+- 复用 manifest-backed motion controller matrix；
+- 复用 browser diagnostics artifact；
+- 复用 release readiness / URL workflow / batch acceptance evidence；
+- 生成并维护 `promotion-candidates.tsv`，把候选分为：
+  - `evidence-ready`；
+  - `inventory-ready`。
+
+禁止做：
+
+- 不新增 virtual HAL runtime capability；
+- 不用 virtual HAL 替代 LinuxCNC CNC 语义；
+- 不用 JS/browser glue 解锁 Python remap；
+- 不用 JS/browser glue 解锁 tool DB；
+- 不用 JS/browser glue 解锁 external user-M process；
+- 不把 `.tbl` fallback 当作 tool DB pass；
+- 不把 macro/load asset 当 standalone main program；
+- 不靠改 docs 声称 skipped 下降。
+
+二、当前 hard block 状态
+
+以下 hard block 在当前阶段必须保持 locked：
+
+```text
+L4-PYTHON-REMAP
+L4-TOOL-DB
+L4-USER-M-PROCESS
+UPSTREAM-DEMO
+standalone-main 语境下的 ASSET-ONLY
+```
+
+当前 skip/block summary 仍保持：
+
+```text
+ASSET-ONLY=65
+L4-PYTHON-REMAP=53
+L4-TOOL-DB=1
+L4-USER-M-PROCESS=1
+NON_MAIN_CLASS=10
+UPSTREAM-DEMO=1
+```
+
+三、当前 baseline 必须保持
+
+当前阶段完成后，Node inventory baseline 仍应为：
+
+```text
+executed=28
+passed=28
+skipped=131
+unexpected_fail=0
+```
+
+这不是失败，而是当前铁律下的正确结果：virtual HAL 已把一批可用 sim config row 推进到
+browser diagnostics / release evidence 层，但没有解锁 hard runtime family。
+
+四、当前已完成的 evidence-ready promotion
+
+`promotion-candidates.tsv` 中必须包含以下 `evidence-ready` rows：
+
+- `qtdragon/qtdragon_multi_joint/on_abort.ngc`
+- `qtdragon/qtdragon_xyz/on_abort.ngc`
+- `qtdragon/qtdragon_xyz45/on_abort.ngc`
+- `qtdragon_hd/qtdragon_hd_xyz/on_abort.ngc`
+- `qtdragon_hd/qtdragon_hd_z_compensation/on_abort.ngc`
+- `qtvcp_screens/qtdragon/on_abort.ngc`
+- `axis/vismach/puma/puma_seam_weld.ngc`
+- `axis/rose_engine/rcone_demo.ngc`
+
+这些 rows 的语义：
+
+```text
+current_status=PASS
+skip_kind=-
+matrix_layer4_node=INV
+matrix_layer4_browser=-
+blocked_kind=-
+virtual_hal_evidence_ready=1
+promotion_allowed=0
+block_reason=browser_release_evidence_ready_inventory_baseline_unchanged
+```
+
+`promotion_allowed=0` 是有意的：这些 row 已有 browser/release evidence，但不代表
+inventory baseline 发生变化。
+
+五、当前 inventory-ready hard block rows
+
+`promotion-candidates.tsv` 中也会列出 `inventory-ready` 类型的 skipped main rows。
+这些行用于后续分析，不代表当前可解锁。
+
+当前直接 inventory promotion 必须保持：
+
+```text
+promotion_allowed=0
+```
+
+原因：
+
+- `L4-PYTHON-REMAP` 需要 LinuxCNC Python remap runtime；
+- `L4-TOOL-DB` 需要 tool database process protocol proof；
+- `L4-USER-M-PROCESS` 需要 external user-M process state proof；
+- `UPSTREAM-DEMO` 是 preserved upstream demo edge。
+
+六、text20 / text21 的范围解释
+
+`text20.txt` 和 `text21.txt` 只作为未来解锁研究记录：
+
+- `text20.txt`：future tool DB native/runtime 解锁步骤；
+- `text21.txt`：future WASM + OPFS tool DB feasibility architecture。
+
+它们不改变当前阶段铁律，不允许在当前阶段据此把 `L4-TOOL-DB` 解锁。
+
+当前阶段若引用 `text20.txt` / `text21.txt`，只能作为：
+
+- future milestone planning；
+- risk analysis；
+- architecture note；
+- blocked family proof requirement。
+
+不能作为：
+
+- 当前 baseline promotion 依据；
+- 当前 release ready 的解锁依据；
+- 当前 browser diagnostics positive pass 的替代证据。
+
+七、当前阶段验收标准
+
+当前阶段完成需要满足：
+
+1. `promotion-candidates.tsv` 存在；
+2. `promotion-candidates.tsv` 同时包含 `evidence-ready` 和 `inventory-ready` 两层；
+3. `evidence-ready` rows 绑定 virtual HAL source-derived browser/release evidence；
+4. `inventory-ready` hard block rows 仍 `promotion_allowed=0`；
+5. baseline 保持 `28/28/131/0`；
+6. `L4-PYTHON-REMAP`、`L4-TOOL-DB`、`L4-USER-M-PROCESS` 仍 locked；
+7. docs 明确 artifact count 和 candidate report；
+8. release / SDK gate 仍要求 virtual HAL promotion candidate summary；
+9. 不新增 virtual HAL runtime capability；
+10. 不新增 JS-owned CNC semantics。
+
+八、已验证命令
+
+当前阶段最小验证命令：
+
+```text
+git diff --check
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/tests/sdk/node/verify_sdk_surface.sh
+wasm-port/tests/sdk/node/verify_project_release_gate_manifest.sh
+```
+
+预期 inventory 输出：
+
+```text
+sim_configs_wasm_node_inventory_executed=28
+sim_configs_wasm_node_inventory_passed=28
+sim_configs_wasm_node_inventory_skipped=131
+sim_configs_wasm_node_inventory_unexpected_fail=0
+sim_configs_wasm_node_inventory=ok
+```
+
+九、下一步建议
+
+下一步不要直接解锁 hard block。按当前铁律，优先做：
+
+1. 扩展 `evidence-ready` browser diagnostics 展示；
+2. 强化 release URL workflow 对 promotion candidate summary 的可见性；
+3. 对 `blocked=-`、native `PASS`、class `main` 的非 hard-block family 继续找可真实 promotion row；
+4. 对 Python remap / tool DB / external user-M 只维护 proof requirement 和 lock artifact；
+5. 如果要解锁 tool DB、Python remap 或 external user-M，必须另开 milestone，不能混入当前阶段。
+
+十、简要结论
+
+当前阶段已经按铁律完成：
+
+```text
+virtual HAL 成果作为 sim config promotion 证据基础；
+Python remap / tool DB / external user-M hard block 不解锁；
+baseline 保持 28/28/131/0；
+promotion candidates 进入双层 evidence-ready / inventory-ready 管理。
+```

textbak/text23.txt

@@ -0,0 +1,269 @@
+项目接续文件：OPFS/WASM hard block 移植优先级建议
+
+生成时间：2026-06-19 CST
+
+本文件接替 `text22.txt` 的“另开 milestone”建议，专门回答：
+
+```text
+在基于 OPFS、WASM 的数控系统仿真中，
+L4-PYTHON-REMAP、L4-TOOL-DB、L4-USER-M-PROCESS 哪些可以移植，
+以及应该先移植哪一个。
+```
+
+重要边界：
+
+```text
+本文件是 future runtime milestone 建议，不改变 text22.txt 的当前阶段铁律。
+当前阶段仍不得解锁 L4-PYTHON-REMAP / L4-TOOL-DB / L4-USER-M-PROCESS；
+Node inventory baseline 仍保持 executed=28 passed=28 skipped=131 unexpected_fail=0；
+promotion_allowed 仍必须保持 0。
+```
+
+一、简要结论
+
+三类 hard block 都可以“部分或项目定义下完整”移植到 OPFS/WASM 环境，但可移植方式不同。
+
+推荐优先级：
+
+```text
+1. L4-TOOL-DB
+2. L4-PYTHON-REMAP
+3. L4-USER-M-PROCESS
+```
+
+建议先移植 `L4-TOOL-DB`，原因是：
+
+- 当前只有 1 个 inventory row：`axis/db_demo/base.ngc`；
+- 协议边界清晰：`DB_PROGRAM`、`v2.1`、`g`、`FINI`、`l`、`p`、`u`；
+- OPFS 与 tool DB flat-file persistence 天然匹配；
+- 可用 Worker / WASM Python runtime 隔离 `DB_PROGRAM`；
+- 已有 `text20.txt` / `text21.txt` 规划和 machine-readable artifacts；
+- 不需要一次性承诺完整 Python remap lifecycle 或 arbitrary external process；
+- 成功后能形成第一个 hard-block runtime unlock 的可复用 proof pattern。
+
+二、可移植性判断
+
+| Family | 能否移植到 OPFS/WASM | 推荐优先级 | 主要原因 |
+| --- | --- | ---: | --- |
+| `L4-TOOL-DB` | 可以，建议先做 | 1 | 协议小、状态明确、OPFS 持久化适配自然、只有 1 个 row。 |
+| `L4-PYTHON-REMAP` | 可以，但应分阶段做 | 2 | 覆盖面最大，价值高，但需要 LinuxCNC Python remap lifecycle、prolog/epilog、module loading、interpreter state binding。 |
+| `L4-USER-M-PROCESS` | 只建议做受控子集，最后做 | 3 | 浏览器不能运行 arbitrary external process；必须把 external process 收束成 LinuxCNC-owned state transition proof。 |
+
+三、为什么先做 L4-TOOL-DB
+
+`L4-TOOL-DB` 当前 blocked row 是：
+
+```text
+axis/db_demo/base.ngc
+```
+
+当前阻塞原因不是 G-code 解释器本身，而是 INI 声明：
+
+```text
+[EMCIO]
+DB_PROGRAM = ./db_nonran.py
+```
+
+这意味着 `.tbl` fallback 不能算 pass。必须证明 LinuxCNC tool DB process protocol：
+
+```text
+startup handshake: v2.1
+get-all: g ... FINI
+spindle load notify: l
+tool offset notify: p
+spindle unload notify: u
+flat-file DB persistence
+```
+
+在 OPFS/WASM 环境中，推荐定义：
+
+```text
+ToolDbProcessPort
+```
+
+职责：
+
+- 按 INI 中的 `DB_PROGRAM` 启动受控 runtime；
+- 维持 line-based protocol；
+- 记录 transcript；
+- 将 DB flat file 映射到 OPFS；
+- 导出 release/browser diagnostics。
+
+不允许：
+
+- 用 `.tbl` fallback 代替 DB_PROGRAM；
+- 用 JS 直接构造 tool semantics；
+- 跳过 `tooldb.py` / `db.py` 行为；
+- 只靠 browser glue 声称 tool DB pass。
+
+建议 first milestone：
+
+```text
+tool-db-opfs-wasm-milestone
+```
+
+最小完成定义：
+
+1. Native `ENABLE_TOOL_DB_RUNTIME_PROBE=1` 可在完整 LinuxCNC host runtime 上通过；
+2. WASM/Worker 能执行等价 DB protocol loop；
+3. OPFS 能保存并恢复 DB flat-file state；
+4. transcript 包含 `v2.1` / `g` / `FINI` / `l` / `p` / `u`；
+5. browser diagnostics 输出 DB program path、OPFS DB path、transcript hash、state summary；
+6. release artifact 标明 `.tbl fallback sufficient=false`；
+7. 只有 native + WASM + browser proof 都齐后，才允许考虑把 `axis/db_demo/base.ngc` 从 `SKIP L4-TOOL-DB` 推进。
+
+四、L4-PYTHON-REMAP 的移植建议
+
+`L4-PYTHON-REMAP` 可以移植，但不应该作为第一个解锁对象。
+
+原因：
+
+- 当前涉及 53 个 skip/block rows；
+- 覆盖 Python module loading、remap callable、prolog/epilog、NGC-only subpath、interpreter state、HAL/UI/HALUI assumptions；
+- 一旦边界设计不严，很容易把 Python runtime 当作 JS/browser-owned CNC semantics；
+- 需要比 tool DB 更深地嵌入 LinuxCNC interpreter Python plugin lifecycle。
+
+推荐路线：
+
+```text
+先复用 tool DB milestone 中建立的 Python/WASM substrate；
+再做最小 Python remap lifecycle fixture；
+最后扩大到 family-level inventory。
+```
+
+首个 fixture 仍建议沿用已有 artifact 中的计划：
+
+```text
+axis/remap/stop-lookahead/nc_files
+```
+
+原因是它更适合作为 lifecycle proof：
+
+- 有 Python runtime phase；
+- 当前已有 native runtime fixture plan；
+- 比完整 tool-change / five-axis Python remap family 更窄；
+- 可以先证明 Python module import、callable dispatch、interpreter lifecycle 和 state observation。
+
+Python remap milestone 的完成定义应至少包括：
+
+1. `python-remap-native-runtime-readiness.tsv` host readiness clear；
+2. `ENABLE_PYTHON_REMAP_RUNTIME_PROBE=1` native lifecycle probe pass；
+3. WASM Python runtime 能复现同一 lifecycle；
+4. remap/prolog/epilog callable 来源绑定 LinuxCNC config/source；
+5. browser diagnostics 明确 Python runtime mode；
+6. 不把 NGC-only subroutine asset 当 standalone main program；
+7. 不因为 Python runtime 可运行就批量解锁全部 53 rows。
+
+五、L4-USER-M-PROCESS 的移植建议
+
+`L4-USER-M-PROCESS` 在浏览器中最不适合按 native external process 语义原样移植。
+
+当前代表 row：
+
+```text
+axis/vismach/millturn/example.ngc
+```
+
+核心阻塞是 external user-M process：
+
+```text
+M128 / M129 Tcl scripts
+HAL pin state updates
+kinstype guard
+ini.[xyz].* soft-limit state transitions
+```
+
+浏览器/WASM 环境不能安全、通用地支持：
+
+- arbitrary executable spawn；
+- native Tcl process execution；
+- host HAL daemon mutation；
+- unrestricted process side effects。
+
+因此不建议把 `L4-USER-M-PROCESS` 定义成“浏览器运行任意 USER_M_PATH executable”。
+
+可行路线只能是受控子集：
+
+```text
+LinuxCNC-owned user-M state transition boundary
+```
+
+例如对 `millturn`：
+
+- 读取 config-owned `M128` / `M129` source；
+- 绑定 `M428 -> M128`、`M429 -> M129`；
+- 证明 `kinstype.is-0` / `kinstype.is-1` guard；
+- 证明 `ini.x.*` / `ini.y.*` / `ini.z.*` state target；
+- browser 只执行已证明的 state-transition adapter；
+- diagnostics 明确 `arbitrary_external_process=false`。
+
+推荐把它放在第三优先级，原因是：
+
+- 成功解锁只覆盖 1 个 row；
+- 需要 HAL/Tcl/user-M process state proof；
+- 不能形成通用 external process 支持；
+- 安全边界和用户期望更容易误读。
+
+六、总体推荐路线
+
+推荐 roadmap：
+
+```text
+Phase A：继续保持 text22 lock
+Phase B：L4-TOOL-DB OPFS/WASM proof
+Phase C：复用 Python/WASM substrate，做最小 L4-PYTHON-REMAP lifecycle proof
+Phase D：做受控 L4-USER-M-PROCESS state-transition proof
+```
+
+不要反过来做：
+
+- 不要先做 `L4-USER-M-PROCESS`，因为它不是通用 browser process model；
+- 不要直接批量做 `L4-PYTHON-REMAP`，因为 blast radius 太大；
+- 不要用 `.tbl` fallback 解 `L4-TOOL-DB`；
+- 不要用 virtual HAL 或 JS glue 替代 LinuxCNC CNC/runtime 语义。
+
+七、建议的下一步文件/代码工作
+
+如果要开启第一个 hard-block runtime milestone，建议创建：
+
+```text
+text24.txt
+```
+
+主题：
+
+```text
+L4-TOOL-DB OPFS/WASM runtime milestone execution plan
+```
+
+内容应包括：
+
+1. `ToolDbProcessPort` API 草案；
+2. Worker/Python runtime 选择；
+3. OPFS DB file layout；
+4. transcript schema；
+5. native/WASM/browser proof gates；
+6. release diagnostics fields；
+7. promotion lock 更新条件；
+8. rollback 条件。
+
+八、最终建议
+
+当前问题的直接答案：
+
+```text
+都可以研究移植；
+第一个应该移植 L4-TOOL-DB；
+第二个做 L4-PYTHON-REMAP；
+第三个做 L4-USER-M-PROCESS 的受控 state-transition 子集。
+```
+
+当前阶段仍不应改变：
+
+```text
+L4-PYTHON-REMAP locked
+L4-TOOL-DB locked
+L4-USER-M-PROCESS locked
+promotion_allowed=0
+baseline=28/28/131/0
+```

textbak/text24.txt

@@ -0,0 +1,414 @@
+项目接续文件：L4-TOOL-DB OPFS/WASM runtime milestone 执行计划
+
+生成时间：2026-06-19 CST
+
+本文件接替 `text23.txt`，回答“第一个先做 `L4-TOOL-DB`，具体如何做”。
+
+重要边界：
+
+```text
+本文件是单独 hard-block runtime milestone 的执行计划。
+不是 text22.txt 当前 evidence-based promotion 阶段的一部分。
+在本 milestone 完成前：
+axis/db_demo/base.ngc 仍必须保持 SKIP L4-TOOL-DB；
+promotion_allowed=0；
+baseline 仍保持 executed=28 passed=28 skipped=131 unexpected_fail=0。
+```
+
+一、目标
+
+目标不是让 `axis/db_demo/base.ngc` 通过 `.tbl` fallback，也不是用 JavaScript 重新实现 tool semantics。
+
+目标是证明：
+
+```text
+LinuxCNC-owned tool DB protocol + DB_PROGRAM behavior + OPFS persistence
+可以在 native / WASM / browser proof chain 中成立。
+```
+
+最小目标 row：
+
+```text
+axis/db_demo/base.ngc
+ini=axis/db_demo/db_nonran.ini
+blocked=L4-TOOL-DB
+DB_PROGRAM=./db_nonran.py
+```
+
+必须保留的协议：
+
+```text
+startup handshake: v2.1
+get-all: g ... FINI
+spindle load notify: l
+tool offset notify: p
+spindle unload notify: u
+flat-file persistence
+```
+
+二、当前已有基础
+
+已有 source/protocol accounting：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/tool-db-process-boundary-summary.tsv
+wasm-port/build/wasm/sim-configs-inventory/tool-db-process-protocol-gates.tsv
+wasm-port/build/wasm/sim-configs-inventory/tool-db-process-transaction-plan.tsv
+wasm-port/build/wasm/sim-configs-inventory/tool-db-process-native-protocol-alignment.tsv
+wasm-port/build/wasm/sim-configs-inventory/tool-db-process-native-runtime-readiness.tsv
+wasm-port/build/wasm/sim-configs-inventory/tool-db-process-native-runtime-probe-gate.tsv
+```
+
+当前 probe 状态：
+
+```text
+python3=1
+axis/db_demo/db_nonran.py=1
+linuxcnc.so=1
+tooldb.py=1
+linuxcnc=0
+milltask=0
+halcmd=0
+runtime_ready=0
+source_proof_ready=1
+gate_status=blocked_missing_host_runtime
+promotion_allowed=0
+```
+
+已有 native probe 入口：
+
+```text
+wasm-port/tests/native/probe_tool_db_runtime.sh
+```
+
+三、Phase 1：native protocol proof 先闭环
+
+目的：先证明项目记录的 tool DB transaction contract 与真实 LinuxCNC DB runtime 一致。
+
+1. 准备完整 LinuxCNC host runtime。
+
+需要 PATH 上存在：
+
+```text
+python3
+linuxcnc
+milltask
+halcmd
+```
+
+需要 Python 模块可 import：
+
+```bash
+python3 -c "import linuxcnc; import tooldb; print('linuxcnc_tooldb_python_modules=ok')"
+```
+
+2. 先跑 readiness，不启用执行。
+
+```bash
+wasm-port/tests/native/probe_tool_db_runtime.sh
+```
+
+可接受输出：
+
+```text
+tool_db_runtime_probe_status=ready_disabled_by_default
+```
+
+如果仍输出：
+
+```text
+tool_db_runtime_probe_status=skipped_missing_host_runtime
+```
+
+则先修 host/container runtime，不改项目 fallback。
+
+3. 显式启用 native runtime probe。
+
+```bash
+ENABLE_TOOL_DB_RUNTIME_PROBE=1 wasm-port/tests/native/probe_tool_db_runtime.sh
+```
+
+必须看到：
+
+```text
+tool_db_runtime_probe_status=runtime_protocol_probe_passed
+```
+
+该 probe 必须证明：
+
+- `db_nonran.py` 启动并返回 `v2.1`；
+- `g` 返回 `T10..T19` 并以 `FINI` 结束；
+- 初始 pocket 是 `tno+100`；
+- `p t11 p111 d0.33 z0.11` 后 get-all 能看到状态更新；
+- `l t14 p0` 后 `T14` 进入 spindle pocket `P0`；
+- `u t0 p0` 后 `T14` 回到 `P114`；
+- DB savefile 包含 mutation；
+- 输出仍保持 `tool_db_execution_enabled=0`、`tool_db_promotion_allowed=0`。
+
+4. 刷新 inventory artifacts。
+
+```bash
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+```
+
+预期仍不改变 baseline：
+
+```text
+executed=28
+passed=28
+skipped=131
+unexpected_fail=0
+```
+
+但 tool DB runtime artifacts 应进入 “native proof ready, waiting for Node/browser proof” 类型状态。
+
+四、Phase 2：定义 WASM ToolDbProcessPort
+
+目的：把 native child-process edge 改成可在 WASM/browser 中验证的协议端口。
+
+建议新增抽象：
+
+```text
+ToolDbProcessPort
+```
+
+建议 API：
+
+```text
+createLinuxCncToolDbProcessPort({
+  dbProgramPath,
+  sourceFiles,
+  opfsRoot,
+  runtimeMode,
+})
+
+start()
+writeLine(line)
+readLine()
+runTransactionPlan(plan)
+exportTranscript()
+close()
+```
+
+职责：
+
+- 按 INI 的 `DB_PROGRAM` 定位 DB program；
+- 提供 line-based protocol I/O；
+- 记录 transcript；
+- 将 DB flat-file 映射到 OPFS；
+- 导出 diagnostics artifact。
+
+不允许：
+
+- 解析 `.tbl` 作为 pass；
+- JS 直接构造 tool table semantics；
+- 跳过 `tooldb.py`；
+- 不跑 `db.py` / `db_nonran.py` 回调；
+- 只用 fixture transcript 假装 runtime pass。
+
+五、Phase 3：选择 DB_PROGRAM runtime
+
+推荐首选：
+
+```text
+Web Worker + WASM Python runtime
+```
+
+Worker 内加载：
+
+```text
+configs/sim/axis/db_demo/db_nonran.py
+configs/sim/axis/db_demo/db.py
+lib/python/tooldb.py
+minimal linuxcnc Python integration shim
+OPFS-backed DB flat file
+```
+
+注意：
+
+```text
+minimal linuxcnc shim 只能覆盖 DB demo 必需 integration surface，
+例如 linuxcnc.command().load_tool_table 的同步边界记录。
+不能承载 tool semantics。
+```
+
+如果暂时没有 Python/WASM runtime，不要直接改成 JS 版 DB program。可以先做：
+
+```text
+tool-db-process-port contract tests
+transcript schema
+OPFS persistence store
+browser diagnostics shell
+```
+
+但仍保持：
+
+```text
+runtime_execution_ready=0
+promotion_allowed=0
+```
+
+六、Phase 4：OPFS persistence layout
+
+建议 OPFS 路径：
+
+```text
+/machines/<machine-id>/tool-db/db_nonran_file
+/machines/<machine-id>/tool-db/transcripts/<run-id>.json
+```
+
+必须验证：
+
+1. 初次启动可创建 DB file；
+2. `p` / `l` / `u` 后 DB file 更新；
+3. 关闭 session 后重新加载仍能读回状态；
+4. diagnostics 导出：
+
+```text
+db_program_path
+opfs_db_path
+transcript_hash
+db_file_hash
+startup_tool_count
+mutation_count
+tbl_fallback_sufficient=false
+promotion_allowed=0
+```
+
+七、Phase 5：Node/WASM proof
+
+新增 Node gate 建议：
+
+```text
+wasm-port/tests/wasm/node/verify_tool_db_process_port_wasm.sh
+```
+
+该 gate 要证明：
+
+- 从 INI 解析到 `DB_PROGRAM=./db_nonran.py`；
+- ToolDbProcessPort 可启动 runtime；
+- transcript 包含 `v2.1` / `g` / `FINI` / `p` / `l` / `u`；
+- OPFS-equivalent store 可 roundtrip DB file；
+- `.tbl fallback sufficient=false`；
+- 输出 `tool_db_process_port_wasm=ok`；
+- 不改 `verify_sim_configs_inventory_wasm.sh` baseline。
+
+八、Phase 6：browser diagnostics proof
+
+新增 browser gate 建议：
+
+```text
+wasm-port/tests/browser/verify_tool_db_process_browser.sh
+```
+
+browser diagnostics 应显示：
+
+```text
+tool_db_runtime_mode=wasm-tool-db-protocol-worker
+db_program=./db_nonran.py
+opfs_db_path=/machines/<machine-id>/tool-db/db_nonran_file
+protocol_transcript_ready=true
+opfs_persistence_ready=true
+tbl_fallback_sufficient=false
+promotion_allowed=0
+```
+
+UI 只展示状态和 transcript evidence，不实现 tool semantics。
+
+九、Phase 7：release artifact / promotion lock
+
+在 native + Node/WASM + browser proof 都通过前，release artifact 只能显示：
+
+```text
+L4-TOOL-DB locked
+tool_db_native_protocol_ready=<0|1>
+tool_db_wasm_protocol_ready=<0|1>
+tool_db_browser_protocol_ready=<0|1>
+promotion_allowed=0
+```
+
+只有三层 proof 都为 ready 后，才能另起变更更新：
+
+```text
+runtime-boundary-promotion-readiness.tsv
+runtime-boundary-promotion-blockers.tsv
+runtime-boundary-post-native-pass-gates.tsv
+blocked-runtime-promotion-lock.tsv
+promotion-candidates.tsv
+```
+
+即使到那一步，也要单独 review 是否允许：
+
+```text
+axis/db_demo/base.ngc: SKIP L4-TOOL-DB -> PASS
+```
+
+十、验收命令建议
+
+milestone 初期最小验证：
+
+```bash
+git diff --check
+wasm-port/tests/native/probe_tool_db_runtime.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/tests/sdk/node/verify_project_release_gate_manifest.sh
+```
+
+具备 host runtime 后：
+
+```bash
+ENABLE_TOOL_DB_RUNTIME_PROBE=1 wasm-port/tests/native/probe_tool_db_runtime.sh
+```
+
+实现 WASM/OPFS port 后追加：
+
+```bash
+wasm-port/tests/wasm/node/verify_tool_db_process_port_wasm.sh
+SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_tool_db_process_browser.sh
+```
+
+十一、首个代码切入点建议
+
+建议第一批代码不要直接改 inventory pass/fail，而是新增只读 protocol/runtime 层：
+
+```text
+wasm-port/runtime/sdk/src/tool-db-process-port.js
+wasm-port/runtime/opfs/tool-db-store.js
+wasm-port/tests/sdk/node/verify_tool_db_process_port.mjs
+wasm-port/tests/opfs/node/verify_tool_db_store.mjs
+```
+
+第一批只做：
+
+- transaction plan parser；
+- transcript schema；
+- OPFS/path model；
+- DB file hash；
+- diagnostics export；
+- `.tbl fallback sufficient=false` guard。
+
+第二批再接 Python/WASM Worker runtime。
+
+这样可以先建立可测试边界，同时避免误把 JS helper 当作 tool DB runtime pass。
+
+十二、结论
+
+`L4-TOOL-DB` 的正确做法是：
+
+```text
+先 native protocol proof；
+再 ToolDbProcessPort；
+再 WASM/Worker DB_PROGRAM runtime；
+再 OPFS persistence；
+再 browser diagnostics；
+最后才考虑 promotion lock 更新。
+```
+
+当前不要做：
+
+```text
+不要 .tbl fallback；
+不要 JS tool semantics；
+不要直接改 baseline；
+不要把 protocol contract 当 runtime pass。
+```

textbak/text25.txt

@@ -0,0 +1,691 @@
+项目接续文件：L4-PYTHON-REMAP OPFS/WASM runtime milestone 执行计划
+
+生成时间：2026-06-19 CST
+
+本文件接替 `text24.txt`，整理当前完成情况，并明确下一步：
+
+```text
+剩余 hard block 先做 L4-PYTHON-REMAP；
+L4-USER-M-PROCESS 放在 Python remap lifecycle proof 之后。
+```
+
+重要边界：
+
+```text
+本文件是单独 hard-block runtime milestone 的执行计划。
+不是 virtual HAL 新功能计划，也不是直接批量 promotion 计划。
+
+当前禁止事项：
+- 不用 JavaScript 重写 Python remap / prolog / epilog CNC 语义；
+- 不把 Python runtime 可 import 当成 remap pass；
+- 不把 NGC-only subroutine asset 当 standalone main program；
+- 不一次性解锁全部 53 个 L4-PYTHON-REMAP rows；
+- 不因为 native probe 通过就自动改 promotion_allowed；
+- L4-USER-M-PROCESS 仍不做 arbitrary external process execution。
+```
+
+一、当前完成情况快照
+
+1. virtual HAL 已接入 Web 数控仿真。
+
+已通过真实 browser simulation smoke：
+
+```bash
+SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_real_simulation_browser.sh
+```
+
+输出：
+
+```text
+browser_real_simulation_page_smoke=ok
+```
+
+当前 virtual HAL 覆盖范围：
+
+- browser HAL pin/signal/param state；
+- virtual `halcmd` command workflow；
+- ESTOP / power / home / jog / spindle / coolant state；
+- motion controller matrix；
+- virtual HAL session save/restore；
+- browser diagnostics / release evidence。
+
+边界不变：
+
+- G-code / interpreter / planner / canonical motion 语义仍来自 LinuxCNC-backed WASM；
+- virtual HAL 不提供 Linux kernel hard-realtime ABI；
+- virtual HAL 不提供外部硬件驱动 ABI 或 native HAL module ABI；
+- virtual HAL 不解锁 Python remap、external user-M process。
+
+2. L4-TOOL-DB proof 已完成接入，但仍要按 promotion lock 规则处理。
+
+已通过聚合 proof：
+
+```bash
+wasm-port/tests/host/verify_tool_db_process_proof.sh
+```
+
+输出：
+
+```text
+tool_db_process_port_sdk=ok
+tool_db_store_opfs=ok
+tool_db_process_port_wasm=ok
+browser_tool_db_process_smoke=ok
+tool_db_process_proof=ok
+```
+
+已通过 native opt-in DB_PROGRAM protocol probe：
+
+```bash
+ENABLE_TOOL_DB_RUNTIME_PROBE=1 wasm-port/tests/native/probe_tool_db_runtime.sh
+```
+
+关键输出：
+
+```text
+tool_db_protocol_version=v2.1
+tool_db_get_all_count=10
+tool_db_put_tool_update_state_ok=1
+tool_db_load_spindle_state_ok=1
+tool_db_unload_spindle_state_ok=1
+tool_db_persistence_state_ok=1
+tool_db_runtime_probe_status=runtime_protocol_probe_passed
+```
+
+结论：
+
+```text
+L4-TOOL-DB 的 native / SDK / OPFS / WASM / browser proof chain 已经成立。
+后续不应再把主要精力放在 Tool DB runtime substrate 上，除非是 promotion lock
+收尾或 gate drift 修复。
+```
+
+3. 当前 sim-config inventory 快照。
+
+当前 `wasm-port/build/wasm/sim-configs-inventory/summary.tsv` 统计：
+
+```text
+total=159
+pass=29
+skip=130
+fail=0
+```
+
+当前 `skip-summary.tsv`：
+
+```text
+ASSET-ONLY=65
+L4-PYTHON-REMAP=53
+L4-USER-M-PROCESS=1
+NON_MAIN_CLASS=10
+UPSTREAM-DEMO=1
+```
+
+注意：
+
+```text
+这里已经不是 text24.txt 中的旧 baseline：
+executed=28 passed=28 skipped=131 unexpected_fail=0。
+
+当前可见 generated inventory 已是：
+PASS=29 SKIP=130 FAIL=0。
+后续文件和 gate 必须以当前 artifact 为准，不能沿用过期 baseline。
+```
+
+4. 当前剩余 hard block。
+
+主要剩余：
+
+```text
+L4-PYTHON-REMAP: 53
+L4-USER-M-PROCESS: 1
+```
+
+推荐顺序：
+
+```text
+1. L4-PYTHON-REMAP
+2. L4-USER-M-PROCESS
+```
+
+理由：
+
+- `L4-PYTHON-REMAP` 覆盖面最大，解决后可复用到 53 个 rows；
+- Tool DB milestone 已经建立 Python/WASM Worker、runtime port、browser proof、OPFS/diagnostics 的可复用模式；
+- `L4-USER-M-PROCESS` 只有 1 个 row，且浏览器不能支持 arbitrary external process，只能做受控 state-transition proof；
+- 先做 Python remap lifecycle substrate，能为后续 user-M 的受控 runtime proof 提供更成熟的边界模型。
+
+二、L4-PYTHON-REMAP 当前已有基础
+
+已有 machine-readable artifacts：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/python-remap-boundary-summary.tsv
+wasm-port/build/wasm/sim-configs-inventory/python-remap-family-summary.tsv
+wasm-port/build/wasm/sim-configs-inventory/python-remap-runtime-contract.tsv
+wasm-port/build/wasm/sim-configs-inventory/python-remap-runtime-gates.tsv
+wasm-port/build/wasm/sim-configs-inventory/python-remap-native-runtime-alignment.tsv
+wasm-port/build/wasm/sim-configs-inventory/python-remap-native-runtime-readiness.tsv
+wasm-port/build/wasm/sim-configs-inventory/python-remap-native-runtime-state-plan.tsv
+wasm-port/build/wasm/sim-configs-inventory/python-remap-native-runtime-fixture-plan.tsv
+wasm-port/build/wasm/sim-configs-inventory/python-remap-native-runtime-probe-gate.tsv
+```
+
+当前选定最小 fixture：
+
+```text
+family=axis/remap/stop-lookahead/nc_files
+fixture_id=stop_lookahead_python_runtime_lifecycle
+fixture_scope=no_python_callables_no_ngc_only_subpaths
+```
+
+原因：
+
+- 适合作为 Python runtime lifecycle proof；
+- 范围比 tool-change、five-axis、完整 remap family 更窄；
+- 已有 source/runtime readiness artifacts；
+- 可先证明 Python path、toplevel、module import、callable lookup、generator lifecycle、
+  remap phase dispatch 等生命周期边界。
+
+当前 fixture modules：
+
+```text
+axis/remap/stop-lookahead/python/remap.py
+axis/remap/stop-lookahead/python/toplevel.py
+```
+
+当前 runtime phases：
+
+```text
+initialize_python
+apply_ini_python_path
+execute_toplevel
+callable_lookup
+pycall_dispatch
+callable_invoke
+remap_phase_dispatch
+generator_finish
+execute_python_runtime
+reload_on_change
+```
+
+三、当前 native probe 状态
+
+默认 probe：
+
+```bash
+wasm-port/tests/native/probe_python_remap_runtime.sh
+```
+
+关键输出：
+
+```text
+python_remap_runtime_fixture_family=axis/remap/stop-lookahead/nc_files
+python_remap_runtime_fixture_id=stop_lookahead_python_runtime_lifecycle
+python_remap_runtime_requirements=python3:1,linuxcnc:1
+python_remap_missing_requirements=-
+python_remap_source_proof_ready=1
+python_remap_runtime_ready=1
+python_remap_execution_enabled=0
+python_remap_promotion_allowed=0
+python_remap_runtime_probe_status=ready_disabled_by_default
+```
+
+显式 opt-in native lifecycle probe：
+
+```bash
+ENABLE_PYTHON_REMAP_RUNTIME_PROBE=1 wasm-port/tests/native/probe_python_remap_runtime.sh
+```
+
+关键输出：
+
+```text
+python_remap_lifecycle_execute_finish_source_value=2
+python_remap_lifecycle_ini_path_prepend=python
+python_remap_lifecycle_ini_toplevel=python/toplevel.py
+python_remap_lifecycle_interpreter_sentinel_ok=1
+python_remap_lifecycle_toplevel_imported=1
+python_remap_lifecycle_remap_imported=1
+python_remap_lifecycle_callable_lookup_ok=1
+python_remap_lifecycle_generator_returned=1
+python_remap_lifecycle_generator_first_yield=2
+python_remap_lifecycle_generator_finish_ok=1
+python_remap_runtime_lifecycle_probe_ok=1
+python_remap_runtime_probe_status=runtime_lifecycle_probe_passed
+```
+
+结论：
+
+```text
+L4-PYTHON-REMAP 已不是“从零设计”。
+native stop-lookahead lifecycle proof 已能通过；
+下一步是把这个 native pass evidence 接入 WASM/Worker proof、browser diagnostics、
+release artifact 和 promotion lock 后置 gate。
+```
+
+四、目标
+
+本 milestone 的目标不是直接让 53 个 `L4-PYTHON-REMAP` rows 全部 PASS。
+
+目标是证明：
+
+```text
+LinuxCNC-owned Python remap lifecycle + configured Python modules +
+interpreter state binding 可以在 native / WASM / browser proof chain 中成立。
+```
+
+第一目标 fixture：
+
+```text
+axis/remap/stop-lookahead/nc_files
+ini=axis/remap/stop-lookahead/demo.ini
+blocked=L4-PYTHON-REMAP
+modules=python/remap.py,python/toplevel.py
+```
+
+必须证明：
+
+- INI `[PYTHON]PATH_PREPEND=python` 被执行；
+- INI `[PYTHON]TOPLEVEL=python/toplevel.py` 被执行；
+- configured Python module 可 import；
+- callable lookup 来自 LinuxCNC Python remap lifecycle；
+- generator remap lifecycle 可开始、yield、finish；
+- interpreter sentinel / state binding 可观测；
+- diagnostics 明确 `promotion_allowed=0`，直到完整 native + WASM + browser + manual lock review 完成。
+
+五、Phase 1：把 native lifecycle pass evidence 接入 artifacts
+
+当前 native opt-in probe 已通过，但 generated artifact 里仍有历史状态：
+
+```text
+python-remap-native-runtime-probe-gate.tsv
+gate_status=ready_to_implement_lifecycle_probe
+proof_status=pending
+promotion_allowed=0
+```
+
+下一批应先做：
+
+1. 让 inventory/report layer 可读取 native probe stdout：
+
+```text
+wasm-port/build/native/python-remap-runtime/python_lifecycle.stdout.log
+```
+
+2. 生成 native pass evidence contract：
+
+```text
+python_remap_runtime_probe_status=runtime_lifecycle_probe_passed
+python_remap_lifecycle_toplevel_imported=1
+python_remap_lifecycle_remap_imported=1
+python_remap_lifecycle_callable_lookup_ok=1
+python_remap_lifecycle_generator_finish_ok=1
+python_remap_runtime_lifecycle_probe_ok=1
+```
+
+3. 更新/新增 machine-readable artifacts：
+
+```text
+python-remap-native-runtime-probe-gate.tsv
+runtime-boundary-native-evidence-acceptance-gate.tsv
+runtime-boundary-post-native-pass-gates.tsv
+native-runtime-probe-pass-evidence-contract.tsv
+runtime-probe-gate-alignment.tsv
+```
+
+4. 仍保持：
+
+```text
+execution_enabled=0
+promotion_allowed=0
+manual_lock_update_required=1
+```
+
+验收命令：
+
+```bash
+ENABLE_PYTHON_REMAP_RUNTIME_PROBE=1 wasm-port/tests/native/probe_python_remap_runtime.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_interp_browser.sh
+```
+
+六、Phase 2：定义 PythonRemapRuntimePort
+
+建议新增：
+
+```text
+wasm-port/runtime/sdk/src/python-remap-runtime-port.js
+wasm-port/runtime/sdk/src/python-remap-browser-worker-adapter.js
+wasm-port/runtime/workers/python-remap-worker.js
+wasm-port/tests/sdk/node/verify_python_remap_runtime_port.mjs
+wasm-port/tests/wasm/node/verify_python_remap_runtime_port_wasm.mjs
+wasm-port/tests/browser/verify_python_remap_runtime_browser.sh
+wasm-port/tests/browser/python_remap_runtime_browser_smoke.html
+```
+
+建议 API：
+
+```text
+createLinuxCncPythonRemapRuntimePort({
+  fixtureFamily,
+  iniPath,
+  pythonPathPrepend,
+  topLevelPath,
+  sourceFiles,
+  runtimeMode,
+  runtimeAdapter,
+})
+
+start()
+applyIniPythonPath()
+executeTopLevel()
+importModule(modulePath)
+lookupCallable(callableName)
+invokeGenerator(callableName, args)
+runLifecyclePlan(plan)
+exportTranscript()
+exportDiagnostics()
+close()
+```
+
+最小 lifecycle plan：
+
+```text
+1. initialize_python
+2. apply_ini_python_path
+3. execute_toplevel
+4. import python/remap.py
+5. lookup configured callable
+6. invoke generator
+7. observe first yield
+8. finish generator
+9. export interpreter sentinel/state
+10. export diagnostics
+```
+
+必须保持：
+
+```text
+executionEnabled=false
+promotionAllowed=false
+bulkPromotionAllowed=false
+```
+
+不允许：
+
+- JS 直接实现 remap callable 结果；
+- JS 构造 interpreter state 假装 Python remap pass；
+- 只用 fixture transcript 假装 runtime pass；
+- 跳过 `toplevel.py`；
+- 跳过 configured Python module import；
+- 把 Python module import success 当作 full remap lifecycle success。
+
+七、Phase 3：WASM/Worker runtime
+
+推荐复用 Tool DB milestone 的 runtime pattern：
+
+```text
+Browser/Node worker + Python/WASM provider + LinuxCNC-specific lifecycle shim
+```
+
+Worker 职责：
+
+- 加载 Python runtime provider；
+- 设置 INI 声明的 Python path；
+- 执行 `python/toplevel.py`；
+- import `python/remap.py`；
+- 通过受控 adapter 调用 lifecycle fixture；
+- 记录 transcript；
+- 导出 diagnostics。
+
+允许的 shim：
+
+```text
+minimal LinuxCNC Python remap integration shim
+```
+
+shim 只能覆盖 stop-lookahead fixture 必需的 integration surface，例如：
+
+- interpreter sentinel；
+- callable lookup bridge；
+- generator invocation bridge；
+- remap phase observations；
+- diagnostics state capture。
+
+shim 不允许承载：
+
+- generic interpreter semantics；
+- G-code parsing；
+- planner / canonical motion；
+- full tool-change semantics；
+- arbitrary Python UI process；
+- arbitrary external process。
+
+八、Phase 4：browser diagnostics proof
+
+新增 browser diagnostics 字段建议：
+
+```text
+python_remap_runtime_mode=browser-python-wasm-worker
+fixture_family=axis/remap/stop-lookahead/nc_files
+ini_path=axis/remap/stop-lookahead/demo.ini
+python_path_prepend=python
+toplevel=python/toplevel.py
+modules=python/remap.py,python/toplevel.py
+lifecycle_transcript_ready=true
+callable_lookup_ready=true
+generator_lifecycle_ready=true
+interpreter_state_binding_ready=true
+ngc_only_subroutine_promoted=false
+bulk_family_promotion_allowed=false
+promotion_allowed=0
+```
+
+browser gate 必须证明：
+
+- 页面/API 可读取 Python remap lifecycle diagnostics；
+- diagnostics 来源绑定 LinuxCNC config/source；
+- diagnostics 明确不是 JS-owned CNC semantics；
+- saved artifact 可进入 release URL / ini-panel workflow；
+- `L4-PYTHON-REMAP` 仍在 manual promotion lock 下。
+
+建议命令：
+
+```bash
+SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_python_remap_runtime_browser.sh
+```
+
+九、Phase 5：release artifact / promotion lock
+
+在 native + WASM + browser proof 全部通过前，release artifact 只能显示：
+
+```text
+L4-PYTHON-REMAP locked
+python_remap_native_lifecycle_ready=<0|1>
+python_remap_wasm_lifecycle_ready=<0|1>
+python_remap_browser_lifecycle_ready=<0|1>
+promotion_allowed=0
+```
+
+三层 proof 都 ready 后，仍不能自动批量解锁 53 rows。
+
+下一步只能考虑单独 review：
+
+```text
+axis/remap/stop-lookahead/nc_files: SKIP L4-PYTHON-REMAP -> PASS
+```
+
+并且必须证明：
+
+- 对应 row 不是 NGC-only subroutine；
+- 对应 INI / Python modules / remap declarations 都已 vendored；
+- native pass 与 WASM/browser lifecycle proof 对齐；
+- Python runtime 没有绕过 LinuxCNC interpreter lifecycle；
+- `promotion_allowed` 的变更是显式人工 review，不是 gate 自动推断。
+
+十、L4-USER-M-PROCESS 暂缓原则
+
+`L4-USER-M-PROCESS` 当前代表 row：
+
+```text
+axis/vismach/millturn/example.ngc
+```
+
+核心阻塞：
+
+```text
+M128 / M129 Tcl scripts
+HAL pin state updates
+kinstype guard
+ini.[xyz].* soft-limit state transitions
+```
+
+暂缓原因：
+
+- 浏览器不能支持 arbitrary executable spawn；
+- 浏览器不能通用执行 native Tcl process；
+- 不能模拟 host HAL daemon unrestricted side effects；
+- 成功只覆盖 1 个 row；
+- 更适合在 Python remap lifecycle / runtime diagnostics pattern 稳定后，做受控 state-transition proof。
+
+后续做法只允许：
+
+```text
+LinuxCNC-owned user-M state transition boundary
+```
+
+不允许：
+
+```text
+browser arbitrary external process execution
+```
+
+十一、下一批最小执行建议
+
+优先做一批小而可验收的改动：
+
+1. 固化 native Python remap lifecycle pass evidence。
+
+```bash
+ENABLE_PYTHON_REMAP_RUNTIME_PROBE=1 wasm-port/tests/native/probe_python_remap_runtime.sh
+```
+
+2. 让 generated inventory / release artifact 能识别：
+
+```text
+python_remap_runtime_probe_status=runtime_lifecycle_probe_passed
+```
+
+3. 新增 `PythonRemapRuntimePort` contract-only SDK 层。
+
+4. 新增 Node contract test：
+
+```text
+wasm-port/tests/sdk/node/verify_python_remap_runtime_port.mjs
+```
+
+5. 暂不改 baseline，不改 53 rows。
+
+首批验收命令：
+
+```bash
+git diff --check
+ENABLE_PYTHON_REMAP_RUNTIME_PROBE=1 wasm-port/tests/native/probe_python_remap_runtime.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/tests/sdk/node/verify_sdk_surface.sh
+wasm-port/tests/sdk/node/verify_project_release_gate_manifest.sh
+```
+
+十二、结论
+
+当前状态可以概括为：
+
+```text
+virtual HAL 已接入 Web 仿真；
+L4-TOOL-DB proof chain 已成立；
+当前 generated inventory 为 PASS=29 / SKIP=130 / FAIL=0；
+剩余主要 hard block 是 L4-PYTHON-REMAP=53 和 L4-USER-M-PROCESS=1；
+下一步先做 L4-PYTHON-REMAP；
+首个 fixture 是 axis/remap/stop-lookahead/nc_files；
+native opt-in lifecycle probe 已通过；
+下一批应把 native pass evidence 接入 artifacts，并建立 PythonRemapRuntimePort
+的 WASM/browser proof chain；
+promotion_allowed 继续保持 0，直到完整 proof + manual lock review。
+```
+
+十三、2026-06-19 接续执行记录：L4-PYTHON-REMAP 仿真系统接入收尾
+
+本轮结论：
+
+```text
+L4-PYTHON-REMAP 的 native / SDK / WASM / browser proof chain 已接入；
+真实数控仿真页 runtime/ui/simulation 现在也暴露 Python remap runtime 状态；
+release artifact / URL workflow 能识别 python-remap-runtime-proof=ready；
+53 个 L4-PYTHON-REMAP inventory rows 仍保持 SKIP/manual promotion lock，
+不做批量 PASS，不启用 execution，不允许 promotion_allowed。
+```
+
+新增/补齐的仿真接入点：
+
+```text
+wasm-port/runtime/ui/simulation/simulation-app.js
+- createPythonRemapSimulationRuntimeStatus()
+- renderPythonRemapRuntimeStatus()
+- runRealBrowserSimulation() state.pythonRemapRuntime
+
+wasm-port/runtime/ui/simulation/index.html
+- Machine State 面板显示 L4-PYTHON-REMAP fixture/runtime/lifecycle/promotion 状态
+- window.linuxCncRealSimulationApi.getPythonRemapRuntimeStatus()
+- exportDiagnosticsArtifact().pythonRemapRuntime
+
+wasm-port/tests/browser/real_simulation_page_smoke.html
+- 验证 DOM / API / diagnostics artifact 的 Python remap runtime 状态
+```
+
+本轮验证：
+
+```bash
+wasm-port/tests/native/probe_python_remap_runtime.sh
+ENABLE_PYTHON_REMAP_RUNTIME_PROBE=1 wasm-port/tests/native/probe_python_remap_runtime.sh
+wasm-port/tests/sdk/node/verify_python_remap_runtime_port.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_python_remap_runtime_port_wasm.sh
+wasm-port/tests/browser/verify_python_remap_runtime_browser.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_real_simulation_browser.sh
+wasm-port/tests/browser/verify_release_artifact_url_workflow_browser.sh
+wasm-port/tests/sdk/node/verify_sdk_surface.sh
+wasm-port/tests/sdk/node/verify_project_release_gate_manifest.sh
+wasm-port/tests/sdk/node/verify_project_release_artifact_url_workflow.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/tools/verify_no_standalone_cnc_semantics.sh
+git diff --check
+```
+
+关键验证结果：
+
+```text
+python_remap_runtime_probe_status=ready_disabled_by_default
+python_remap_runtime_probe_status=runtime_lifecycle_probe_passed
+python_remap_runtime_lifecycle_probe_ok=1
+python_remap_lifecycle_generator_first_yield=2
+python_remap_execution_enabled=0
+python_remap_promotion_allowed=0
+browser_python_remap_runtime_smoke=ok
+browser_real_simulation_page_smoke=ok
+browser_release_artifact_url_workflow_smoke=ok
+sim_configs_wasm_node_inventory_executed=29
+sim_configs_wasm_node_inventory_passed=29
+sim_configs_wasm_node_inventory_skipped=130
+sim_configs_wasm_node_inventory_skip_L4_PYTHON_REMAP=53
+sim_configs_wasm_node_inventory_unexpected_fail=0
+standalone CNC semantics guard complete
+```
+
+仍保持的边界：
+
+```text
+executionEnabled=false
+promotionAllowed=false
+bulkPromotionAllowed=false
+ngcOnlySubroutinePromoted=false
+jsCncSemantics=false
+```

textbak/text26.txt

@@ -0,0 +1,442 @@
+项目接续文件：L4-PYTHON-REMAP 53 rows 批量 PASS 方法与执行计划
+
+生成时间：2026-06-19 CST
+
+本文件接替 `text25.txt`，专门回答：
+
+```text
+如何把 53 个 Python-remap inventory rows 从 SKIP L4-PYTHON-REMAP 批量提升为 PASS；
+以及下一批应按什么步骤推进。
+```
+
+重要边界：
+
+```text
+这里的“批量提升为 PASS”不能等价于删除 L4-PYTHON-REMAP skip reason。
+必须是 proof-driven bulk promotion：
+
+1. LinuxCNC-owned Python remap runtime 真实执行；
+2. 每个 row 的 INI / Python modules / remap declarations / prolog / epilog / NGC remap assets
+   都已 vendored 并 staged；
+3. native -> WASM/Node -> browser proof 全部通过；
+4. promotion_allowed 由明确的 promotion artifact 置 1；
+5. inventory baseline 从 PASS=29 / SKIP=130 变为 PASS=82 / SKIP=77；
+6. 不新增 JS-owned G-code、planner、canonical motion、tool、parameter、kinematics、remap 语义。
+```
+
+当前禁止事项：
+
+```text
+- 不直接把 `recommendedBlockedKind === "L4-PYTHON-REMAP"` 改成 `-`；
+- 不把现有 stop-lookahead lifecycle fixture 当作 53 rows 全量 pass；
+- 不用 fake worker / contract-only runtime 作为 PASS 证据；
+- 不把 Python import success 当作 remap execution pass；
+- 不把 NGC-only subroutine asset 当 standalone main program；
+- 不绕过 HAL/UI/HALUI/tool-change/TWP 等边界；
+- 不手工改 summary.tsv 的 PASS/SKIP 数字。
+```
+
+一、当前状态
+
+当前已经完成：
+
+```text
+L4-PYTHON-REMAP native / SDK / WASM / browser proof chain 已接入；
+runtime/ui/simulation 已暴露 Python remap runtime 状态；
+release artifact / URL workflow 能识别 python-remap-runtime-proof=ready；
+project release gate 通过；
+```
+
+当前仍未完成：
+
+```text
+53 个 L4-PYTHON-REMAP rows 仍保持 SKIP；
+promotion_allowed=0；
+execution_enabled=0；
+manual promotion lock 仍开启；
+```
+
+当前 inventory baseline：
+
+```text
+total=159
+pass=29
+skip=130
+fail=0
+L4-PYTHON-REMAP=53
+L4-USER-M-PROCESS=1
+```
+
+目标 bulk promotion baseline：
+
+```text
+total=159
+pass=82
+skip=77
+fail=0
+L4-PYTHON-REMAP=0
+L4-USER-M-PROCESS=1
+```
+
+二、53 rows 审计结果
+
+来源：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/python-remap-boundary-summary.tsv
+wasm-port/build/wasm/sim-configs-inventory/python-remap-family-summary.tsv
+```
+
+总量：
+
+```text
+rows=53
+families=12
+```
+
+横向依赖统计：
+
+```text
+hal_process=53
+ui_process=49
+halui_mdi_process=5
+prolog_rows=43
+epilog_rows=43
+python_remap_rows=9
+ngc_only_subpath_rows=7
+mixed_ngc_python_rows=6
+```
+
+family 分组：
+
+```text
+axis/laser                                                   rows=3   hal=1 ui=1 halui=0 prolog=0 epilog=0 pyremap=1 ngc_only=0
+axis/remap/cycle/nc_files                                    rows=1   hal=1 ui=0 halui=0 prolog=1 epilog=1 pyremap=1 ngc_only=0
+axis/remap/extend-builtins/nc_files                          rows=1   hal=1 ui=1 halui=0 prolog=1 epilog=1 pyremap=0 ngc_only=1 mixed=1
+axis/remap/getting-started/nc_files                          rows=1   hal=1 ui=0 halui=0 prolog=0 epilog=0 pyremap=0 ngc_only=1
+axis/remap/manual-toolchange-with-tool-length-switch/nc_files rows=1   hal=1 ui=1 halui=0 prolog=1 epilog=1 pyremap=0 ngc_only=0
+axis/remap/rack-toolchange/nc_files                          rows=1   hal=1 ui=1 halui=0 prolog=1 epilog=1 pyremap=0 ngc_only=0
+axis/remap/stop-lookahead/nc_files                            rows=1   hal=1 ui=0 halui=0 prolog=0 epilog=0 pyremap=0 ngc_only=0
+axis/vismach/5axis/table-rotary_spindle-rotary-nutating/demos rows=5   hal=1 ui=1 halui=1 prolog=0 epilog=0 pyremap=1 ngc_only=1 mixed=1
+axis/vismach/VMC_toolchange                                  rows=1   hal=1 ui=0 halui=0 prolog=1 epilog=1 pyremap=0 ngc_only=0
+gmoccapy/lathe_configs                                       rows=8   hal=1 ui=1 halui=0 prolog=1 epilog=1 pyremap=0 ngc_only=0
+gmoccapy/macros                                              rows=25  hal=1 ui=1 halui=0 prolog=1 epilog=1 pyremap=0 ngc_only=0
+gmoccapy/non_trivial_kinematics/table-rotary-tilting/examples rows=5  hal=1 ui=1 halui=0 prolog=1 epilog=1 pyremap=0 ngc_only=0
+```
+
+三、批量 PASS 的正确方法
+
+方法不是“解锁一个 family id”，而是新增一个 promotion pipeline：
+
+```text
+python-remap-bulk-promotion-plan.tsv
+  -> python-remap-row-runtime-proof.tsv
+  -> python-remap-row-browser-proof.tsv
+  -> python-remap-bulk-promotion-gate.tsv
+  -> inventory rows promotion_allowed=1
+  -> summary baseline PASS=82 / SKIP=77
+```
+
+每个 row 至少要有这些字段：
+
+```text
+path
+ini
+family
+main_or_macro_load_class
+python_modules_staged
+toplevel_executed
+path_prepend_applied
+python_remap_functions_bound
+prolog_functions_bound
+epilog_functions_bound
+ngc_remap_assets_staged
+ngc_only_subpaths_not_standalone
+interpreter_state_binding_ready
+canonical_events_ready
+hal_state_boundary_ready
+ui_process_boundary_ready
+halui_mdi_boundary_ready
+native_pass_ready
+wasm_node_pass_ready
+browser_pass_ready
+execution_enabled
+promotion_allowed
+```
+
+四、实现阶段
+
+Phase 0：冻结现状与审计
+
+目标：
+
+```text
+确认当前 53 rows 分类、当前 proof 状态、当前 baseline。
+```
+
+验收：
+
+```bash
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/tests/browser/verify_python_remap_runtime_browser.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_real_simulation_browser.sh
+git diff --check
+```
+
+状态：
+
+```text
+本文件创建时 Phase 0 已执行；
+当前仍是 PASS=29 / SKIP=130 / L4-PYTHON-REMAP=53；
+不允许从 Phase 0 直接跳到 PASS=82。
+```
+
+Phase 1：生成 row-level bulk promotion plan
+
+新增 artifact：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/python-remap-bulk-promotion-plan.tsv
+```
+
+生成逻辑：
+
+```text
+读取 python-remap-boundary-summary.tsv；
+按 row 输出 proof requirements；
+默认 promotion_allowed=0；
+把 blockers 拆成：
+  python_runtime
+  prolog_epilog
+  python_remap_callable
+  ngc_remap_asset
+  hal_process_boundary
+  ui_process_boundary
+  halui_mdi_boundary
+  tool_change_boundary
+  twp_boundary
+```
+
+验收：
+
+```text
+plan row count = 53
+每个 L4-PYTHON-REMAP row 有且只有一条 plan row
+所有 plan row promotion_allowed=0
+```
+
+Phase 2：扩展 PythonRemapRuntimePort 为 row runtime
+
+当前 port 只证明 stop-lookahead lifecycle。批量 PASS 需要变成 row-aware runtime：
+
+```text
+createLinuxCncPythonRemapRowRuntimePort({
+  path,
+  iniPath,
+  machineRoot,
+  pythonPathPrepend,
+  topLevelPath,
+  sourceFiles,
+  remapDeclarations,
+  prologFunctions,
+  epilogFunctions,
+  ngcRemapFiles,
+  runtimeAdapter,
+})
+```
+
+必须支持：
+
+```text
+INI [PYTHON] PATH_PREPEND
+INI [PYTHON] TOPLEVEL
+configured Python module import
+LinuxCNC stdglue prolog/epilog
+Python remap callable lookup
+Python generator lifecycle
+LinuxCNC interpreter state / sentinel binding
+LinuxCNC emccanon / canonical event bridge
+reload-on-change behavior
+```
+
+禁止：
+
+```text
+JS 解释 G-code；
+JS 计算 remap result；
+JS 伪造 prolog/epilog semantic state；
+```
+
+Phase 3：处理 HAL/UI/HALUI 边界
+
+因为 53/53 rows 有 HAL 声明，49/53 rows 有 UI 进程声明，5/53 rows 有 HALUI MDI：
+
+```text
+批量 PASS 必须复用 virtual HAL proof；
+UI process 不能按 native GUI 执行，只能证明 browser/standalone UI boundary sufficient；
+HALUI MDI 必须有 LinuxCNC-owned command/state boundary；
+```
+
+新增 artifact：
+
+```text
+python-remap-hal-ui-boundary-proof.tsv
+```
+
+每个 row 必须明确：
+
+```text
+hal_process_boundary_ready=<0|1>
+ui_process_boundary_ready=<0|1>
+halui_mdi_boundary_ready=<0|1>
+arbitrary_native_gui_launched=0
+arbitrary_native_hal_daemon_required=0
+```
+
+Phase 4：按 family 做执行 proof
+
+推荐顺序：
+
+```text
+1. axis/remap/stop-lookahead/nc_files                     rows=1
+2. axis/remap/cycle/nc_files                              rows=1
+3. axis/remap/getting-started/nc_files                    rows=1
+4. axis/remap/extend-builtins/nc_files                    rows=1 mixed NGC/Python guard
+5. axis/remap/manual-toolchange-with-tool-length-switch   rows=1 tool-change prolog/epilog
+6. axis/remap/rack-toolchange/nc_files                    rows=1 tool-change prolog/epilog
+7. axis/vismach/VMC_toolchange                            rows=1 tool-change body
+8. axis/laser                                             rows=3 Python remap callable family
+9. axis/vismach/5axis/table-rotary.../demos               rows=5 TWP + HALUI + mixed NGC/Python
+10. gmoccapy/lathe_configs                                rows=8 stdglue prolog/epilog
+11. gmoccapy/non_trivial_kinematics/...                   rows=5 stdglue + kinematics context
+12. gmoccapy/macros                                       rows=25 macro bulk family
+```
+
+每个 family 完成定义：
+
+```text
+native row pass evidence exists
+WASM/Node row pass evidence exists
+browser row diagnostics exists
+promotion_allowed remains 0 until family review
+```
+
+Phase 5：bulk promotion gate
+
+新增 artifact：
+
+```text
+python-remap-bulk-promotion-gate.tsv
+```
+
+gate 规则：
+
+```text
+all 53 row proof rows ready
+all family proof rows ready
+no ngc_only_subpath standalone violations
+no JS CNC semantics violations
+no missing vendored source files
+no native/browser result drift
+manual_lock_review=approved
+```
+
+只有 gate 全部满足时：
+
+```text
+promotion_allowed=1
+execution_enabled=1
+```
+
+Phase 6：inventory promotion implementation
+
+允许改动的位置：
+
+```text
+wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.mjs
+wasm-port/runtime/sdk/src/sim-config-staging.js
+wasm-port/runtime/sdk/src/project-release-readiness.js
+相关 docs/tests expected baseline
+```
+
+禁止实现方式：
+
+```text
+if blocked === "L4-PYTHON-REMAP" return PASS
+```
+
+允许实现方式：
+
+```text
+if blocked === "L4-PYTHON-REMAP" &&
+   row proof exists &&
+   bulk promotion gate approved &&
+   promotion_allowed === "1"
+then execute through LinuxCNC-backed row runtime and count PASS
+```
+
+Phase 7：baseline 更新
+
+成功后必须更新：
+
+```text
+summary.tsv expected:
+  pass=82
+  skip=77
+  fail=0
+
+skip-summary.tsv expected:
+  ASSET-ONLY=65
+  L4-USER-M-PROCESS=1
+  NON_MAIN_CLASS=10
+  UPSTREAM-DEMO=1
+```
+
+必须删除/更新：
+
+```text
+L4-PYTHON-REMAP=53 的 hard-block summary assertions；
+host-runtime docs 中 Python-remap locked wording；
+release artifact hard-block rows；
+workflow overview locked detail rows；
+```
+
+五、下一步立即执行
+
+不要直接做 Phase 6/7。
+
+下一批从 Phase 1 开始：
+
+```text
+1. 在 verify_sim_configs_inventory_wasm.mjs 里生成 python-remap-bulk-promotion-plan.tsv；
+2. 增加验证函数，确认 53 rows 全部进入 plan；
+3. 增加 docs 说明：bulk PASS 需要 row proof，不接受 direct unlock；
+4. 保持 PASS=29 / SKIP=130 不变；
+5. 跑 inventory/browser/release gate。
+```
+
+建议验收命令：
+
+```bash
+git diff --check
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/tests/browser/verify_python_remap_runtime_browser.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_real_simulation_browser.sh
+wasm-port/tests/host/verify_project_release_gate.sh
+```
+
+六、本文件的执行状态
+
+```text
+已完成：
+- 当前 53 rows 审计；
+- bulk PASS 正确方法定义；
+- Phase 1 目标和验收条件定义；
+
+未完成：
+- python-remap-bulk-promotion-plan.tsv 生成；
+- row-aware PythonRemapRuntimePort；
+- per-family execution proof；
+- promotion_allowed=1；
+- PASS=82 / SKIP=77 baseline update。
+```

textbak/text27.txt

@@ -0,0 +1,287 @@
+项目接续文件：L4-PYTHON-REMAP 53 rows 批量 PASS Phase 1 执行记录
+
+生成时间：2026-06-19 CST
+
+本文件接替 `text26.txt`。
+
+目标：
+
+```text
+把“53 个 Python-remap inventory rows 批量提升为 PASS”的方法落成第一层
+machine-readable promotion plan。
+
+本轮只做 Phase 1：
+- 生成 `python-remap-bulk-promotion-plan.tsv`；
+- 校验它 1:1 覆盖 53 个 `L4-PYTHON-REMAP` rows；
+- 明确每行还缺哪些 proof；
+- 保持 inventory baseline 不变：PASS=29 / SKIP=130 / L4-PYTHON-REMAP=53。
+```
+
+禁止事项：
+
+```text
+- 不把 53 行直接改 PASS；
+- 不删除 `L4-PYTHON-REMAP` skip reason；
+- 不把 stop-lookahead lifecycle proof 扩大解释为 53 行全量 pass；
+- 不让 fake/browser worker 充当 PASS 证据；
+- 不把 Python import success 当作 remap execution proof；
+- 不让 NGC-only remap subpath 被当成 standalone main program；
+- 不手工改 `summary.tsv` / `skip-summary.tsv` 数字。
+```
+
+一、Phase 1 应生成的 artifact
+
+新增：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/python-remap-bulk-promotion-plan.tsv
+```
+
+来源：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/python-remap-boundary-summary.tsv
+wasm-port/build/wasm/sim-configs-inventory/python-remap-family-summary.tsv
+wasm-port/build/wasm/sim-configs-inventory/python-remap-runtime-contract.tsv
+wasm-port/build/wasm/sim-configs-inventory/python-remap-native-runtime-fixture-plan.tsv
+wasm-port/build/wasm/sim-configs-inventory/python-remap-native-runtime-probe-gate.tsv
+```
+
+输出字段必须表达：
+
+```text
+path
+ini
+family
+main_or_macro_load_class
+python_modules_staged
+toplevel_executed
+path_prepend_applied
+python_remap_functions_bound
+prolog_functions_bound
+epilog_functions_bound
+ngc_remap_assets_staged
+ngc_only_subpaths_not_standalone
+interpreter_state_binding_ready
+canonical_events_ready
+hal_state_boundary_ready
+ui_process_boundary_ready
+halui_mdi_boundary_ready
+native_pass_ready
+wasm_node_pass_ready
+browser_pass_ready
+execution_enabled
+promotion_allowed
+blockers
+notes
+```
+
+二、Phase 1 验收条件
+
+```text
+plan row count = 53
+plan path set == python-remap-boundary-summary path set
+所有 row blocked = L4-PYTHON-REMAP
+所有 row execution_enabled = 0
+所有 row promotion_allowed = 0
+所有 row native_pass_ready = 0
+所有 row wasm_node_pass_ready = 0
+所有 row browser_pass_ready = 0
+所有 row blockers 非空
+HAL/UI/HALUI flags 与 boundary summary 保持一致
+存在 NGC-only subpath 的 row 必须显式记录 ngc_remap_asset / ngc_only_subpaths_not_standalone blocker
+```
+
+三、后续 Phase 2/3 的输入
+
+Phase 2 扩展 row-aware runtime 时消费：
+
+```text
+path
+ini
+family
+python_modules_staged
+toplevel_executed
+path_prepend_applied
+python_remap_functions_bound
+prolog_functions_bound
+epilog_functions_bound
+ngc_remap_assets_staged
+ngc_only_subpaths_not_standalone
+interpreter_state_binding_ready
+canonical_events_ready
+```
+
+Phase 3 HAL/UI/HALUI proof 时消费：
+
+```text
+hal_state_boundary_ready
+ui_process_boundary_ready
+halui_mdi_boundary_ready
+```
+
+四、本轮应改文件
+
+```text
+wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.mjs
+wasm-port/tests/browser/interp_smoke.html
+wasm-port/docs/compatibility-validation.md
+wasm-port/docs/full-process-boundary-design.md
+wasm-port/docs/sim-configs-coverage-matrix.md
+text27.txt
+```
+
+五、本轮验收命令
+
+```bash
+git diff --check
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/tests/browser/verify_python_remap_runtime_browser.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_real_simulation_browser.sh
+wasm-port/tests/host/verify_project_release_gate.sh
+```
+
+六、完成后允许进入的下一步
+
+```text
+Phase 2：实现 row-aware Python remap runtime port。
+
+下一轮不要先改 baseline。
+先让 `python-remap-row-runtime-proof.tsv` 能逐 row 证明：
+- INI [PYTHON] PATH_PREPEND；
+- INI [PYTHON] TOPLEVEL；
+- configured module import；
+- Python remap callable / stdglue prolog / epilog lookup；
+- generator lifecycle；
+- interpreter state / canonical event bridge；
+- NGC remap assets staged；
+- NGC-only subpaths 不作为 standalone main。
+```
+
+七、2026-06-19 Phase 2 执行结果
+
+本轮已完成 Phase 2 的 proof substrate，不做 baseline promotion。
+
+新增 / 更新：
+
+```text
+wasm-port/runtime/sdk/src/python-remap-runtime-port.js
+  新增 createLinuxCncPythonRemapRowRuntimePort()
+  新增 createPythonRemapRowRuntimePlan()
+  新增 validatePythonRemapRowRuntimeTranscript()
+  新增 PYTHON_REMAP_ROW_RUNTIME_PROOF_PHASES
+
+wasm-port/runtime/sdk/src/index.js
+  导出 row-aware Python remap runtime API
+
+wasm-port/tests/sdk/node/verify_python_remap_runtime_port.mjs
+  覆盖 row runtime contract-only blocked path
+  覆盖 fake row runtime adapter ready path
+  验证 module/callable/NGC/canonical proof transcript
+
+wasm-port/tests/sdk/node/verify_sdk_surface.mjs
+wasm-port/runtime/sdk/README.md
+  同步 SDK public surface
+
+wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.mjs
+  新增 python-remap-row-runtime-proof.tsv 生成与校验
+
+wasm-port/tests/browser/interp_smoke.html
+wasm-port/docs/compatibility-validation.md
+wasm-port/docs/full-process-boundary-design.md
+wasm-port/docs/sim-configs-coverage-matrix.md
+  generated artifact coverage 从 56 个 WASM TSV 更新到 57 个
+```
+
+新增 artifact：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/python-remap-row-runtime-proof.tsv
+```
+
+artifact 当前状态：
+
+```text
+rows=53
+row_runtime_port_api_ready=1 53
+row_runtime_plan_ready=1 53
+row_runtime_transcript_ready=0 53
+native_pass_ready=0 53
+wasm_node_pass_ready=0 53
+browser_pass_ready=0 53
+execution_enabled=0 53
+proof_status=pending_row_runtime_adapter_execution 53
+```
+
+inventory baseline 保持不变：
+
+```text
+sim_configs_wasm_node_inventory_executed=29
+sim_configs_wasm_node_inventory_passed=29
+sim_configs_wasm_node_inventory_skipped=130
+sim_configs_wasm_node_inventory_skip_L4_PYTHON_REMAP=53
+sim_configs_wasm_node_inventory_unexpected_fail=0
+```
+
+本轮明确没有完成：
+
+```text
+- 未执行 53 rows 的真实 Python remap callbacks；
+- 未把 row_runtime_transcript_ready 置 1；
+- 未把 native_pass_ready / wasm_node_pass_ready / browser_pass_ready 置 1；
+- 未解除 manual promotion lock；
+- 未把 PASS=29 / SKIP=130 改为 PASS=82 / SKIP=77。
+```
+
+八、本轮已通过验证
+
+```bash
+git diff --check
+wasm-port/tests/sdk/node/verify_python_remap_runtime_port.sh
+node wasm-port/tests/sdk/node/verify_sdk_surface.mjs
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/tests/wasm/node/verify_python_remap_runtime_port_wasm.sh
+wasm-port/tests/browser/verify_python_remap_runtime_browser.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_real_simulation_browser.sh
+wasm-port/tests/host/verify_project_release_gate.sh
+```
+
+九、下一步工作建议
+
+建议下一轮进入 Phase 2.5，而不是直接 Phase 3 或 baseline promotion。
+
+Phase 2.5 目标：
+
+```text
+让 python-remap-row-runtime-proof.tsv 对第一批小 family 产生真实 row runtime transcript：
+1. axis/remap/stop-lookahead/nc_files
+2. axis/remap/cycle/nc_files
+3. axis/remap/getting-started/nc_files
+```
+
+推荐顺序：
+
+```text
+1. 为 createLinuxCncPythonRemapRowRuntimePort() 增加 Node/WASM row adapter；
+2. adapter 只负责调用 LinuxCNC-owned Python runtime boundary，不解释 G-code；
+3. 先让 stop-lookahead row 的：
+   python_modules_staged=1
+   toplevel_executed=1
+   path_prepend_applied=1
+   interpreter_state_binding_ready=1
+   canonical_events_ready=1
+   row_runtime_transcript_ready=1
+4. cycle / getting-started 再加入 callable、prolog/epilog、NGC remap asset targets；
+5. 继续保持 native_pass_ready=0 / wasm_node_pass_ready=0 / browser_pass_ready=0，
+   直到 row runtime transcript 可以和 native proof 对齐。
+```
+
+下一轮仍禁止：
+
+```text
+- 不改 PASS/SKIP baseline；
+- 不把 fake row adapter proof 当真实 PASS；
+- 不把 module import 成功当 row execution pass；
+- 不把 NGC-only subpath 当 standalone main program；
+- 不解除 promotion_allowed。
+```

textbak/text28.txt

@@ -0,0 +1,954 @@
+项目接续文件：L4-PYTHON-REMAP 53 rows 批量 PASS Phase 2.5 执行规范
+
+生成时间：2026-06-19 CST
+
+本文件接替 `text27.txt`。
+
+目标：
+
+```text
+继续推进“53 个 Python-remap inventory rows 批量提升为 PASS”的 proof 链路。
+
+本轮不是 baseline promotion。
+本轮只做 Phase 2.5：
+- 固化 53 rows 最终批量 PASS 的方法和步骤；
+- 让 `python-remap-row-runtime-proof.tsv` 至少对第一批小 family 产生真实 row runtime transcript；
+- 优先让 stop-lookahead 首行从 pending 进入 transcript-ready；
+- 继续保持 inventory baseline 不变：PASS=29 / SKIP=130 / L4-PYTHON-REMAP=53。
+```
+
+一、53 rows 批量 PASS 的完整方法
+
+```text
+Phase 1：machine-readable bulk promotion plan
+- 生成 `python-remap-bulk-promotion-plan.tsv`；
+- 1:1 覆盖 53 个 `L4-PYTHON-REMAP` rows；
+- 明确每行缺少的 runtime/native/node/browser proof；
+- 保持 execution_enabled=0、promotion_allowed=0。
+
+Phase 2：row-aware runtime proof substrate
+- SDK 暴露 `createLinuxCncPythonRemapRowRuntimePort()`；
+- 生成 `python-remap-row-runtime-proof.tsv`；
+- 每行表达 module staging、TOPLEVEL、PATH_PREPEND、callable/prolog/epilog、NGC asset、interpreter state、canonical event 的 proof target；
+- 仍不把 fake adapter 或 Python import-only 当 PASS。
+
+Phase 2.5：第一批真实 row runtime transcript
+- 对小 family 先落真实 transcript，而不是全量一次性 promotion；
+- 第一批顺序：
+  1. `axis/remap/stop-lookahead/nc_files`
+  2. `axis/remap/cycle/nc_files`
+  3. `axis/remap/getting-started/nc_files`
+- transcript 必须来自 LinuxCNC-owned Python runtime boundary 或 native lifecycle stdout；
+- transcript ready 只解除 `row_runtime_adapter_execution` blocker；
+- 不解除 native/node/browser/manual promotion blockers。
+
+Phase 3：row native pass proof
+- 逐 row 证明 native runtime pass；
+- 对齐 `python-remap-row-runtime-proof.tsv` 的 proof targets；
+- native proof 不能只证明 stop-lookahead lifecycle 后推断 53 rows 全 PASS。
+
+Phase 4：WASM Node pass proof
+- 逐 row 证明 WASM Node runtime bridge 可执行同等 row contract；
+- 保留 LinuxCNC-owned semantics，禁止 JS 重写 CNC 语义。
+
+Phase 5：Browser pass proof
+- 逐 row 证明 browser worker / UI workflow 与 Node proof 对齐；
+- browser proof 必须在 Node proof 后接受。
+
+Phase 6：manual promotion lock review
+- 只有 row_runtime、native、wasm_node、browser proof 全部 ready 后，才允许解除 manual lock；
+- 最终才可把 53 rows 从 `L4-PYTHON-REMAP` 批量提升为 PASS；
+- 目标 baseline 才能从 PASS=29 / SKIP=130 变为 PASS=82 / SKIP=77。
+```
+
+二、本轮 Phase 2.5 执行步骤
+
+```text
+1. 先确认 native Python lifecycle stdout 是否存在：
+   `wasm-port/build/native/python-remap-runtime/python_lifecycle.stdout.log`
+
+2. 确认 native runtime probe summary 是否存在并包含：
+   `wasm-port/build/native/native-runtime-probe-summary.tsv`
+   `L4-PYTHON-REMAP python_runtime axis/remap/stop-lookahead/nc_files`
+   `runtime_lifecycle_probe_passed`
+
+3. 运行 inventory verifier：
+   `SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh`
+
+4. 验收 `python-remap-row-runtime-proof.tsv`：
+   - rows=53；
+   - `axis/remap/stop-lookahead/nc_files/examples.ngc`
+     - `python_modules_staged=1`
+     - `toplevel_executed=1`
+     - `path_prepend_applied=1`
+     - `interpreter_state_binding_ready=1`
+     - `canonical_events_ready=1`
+     - `row_runtime_transcript_ready=1`
+     - `proof_status=native_lifecycle_stdout_row_runtime_transcript_ready`
+   - 其他 rows 可继续 pending；
+   - 所有 rows 仍保持：
+     - `native_pass_ready=0`
+     - `wasm_node_pass_ready=0`
+     - `browser_pass_ready=0`
+     - `execution_enabled=0`
+
+5. 如果 stop-lookahead 仍 pending：
+   - 优先修正 verifier 对 native stdout / native summary 的读取和验收；
+   - 不伪造 row transcript；
+   - 不把 build artifact 手工改成 ready。
+
+6. stop-lookahead 通过后，下一轮再扩展 cycle / getting-started：
+   - 增加 row adapter 对 callable/prolog/epilog lookup 的真实 proof；
+   - 增加 NGC remap asset staged proof；
+   - 对 NGC-only subpaths 明确 reject standalone proof。
+```
+
+三、本轮禁止事项
+
+```text
+- 不改 PASS/SKIP baseline；
+- 不直接把 53 rows 改 PASS；
+- 不删除 `L4-PYTHON-REMAP` skip reason；
+- 不把 stop-lookahead lifecycle proof 解释成 53 rows 全量 pass；
+- 不让 fake/browser worker 充当 PASS 证据；
+- 不把 Python import success 当 row execution proof；
+- 不把 NGC-only subpath 当 standalone main program；
+- 不解除 `manual_promotion_lock`；
+- 不手工改 `summary.tsv` / `skip-summary.tsv` 数字。
+```
+
+四、本轮应关注文件
+
+```text
+wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.mjs
+wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/runtime/sdk/src/python-remap-runtime-port.js
+wasm-port/tests/sdk/node/verify_python_remap_runtime_port.mjs
+wasm-port/build/wasm/sim-configs-inventory/python-remap-row-runtime-proof.tsv
+text28.txt
+```
+
+五、本轮验收命令
+
+```bash
+git diff --check
+wasm-port/tests/sdk/node/verify_python_remap_runtime_port.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+```
+
+六、完成后写入本文件的结果
+
+```text
+记录：
+- stop-lookahead row runtime transcript 是否 ready；
+- 53 rows row_runtime_proof 状态分布；
+- inventory baseline 是否保持不变；
+- 已通过和未通过的验证命令；
+- 下一轮 cycle / getting-started 的具体入口。
+```
+
+七、2026-06-19 Phase 2.5 执行结果
+
+本轮已完成 stop-lookahead 首行的真实 row runtime transcript 接入，不做 baseline promotion。
+
+代码修正：
+
+```text
+wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.mjs
+- 修正 `python-remap-row-runtime-proof.tsv` 生成列映射；
+- `generator_lifecycle_ready` 跟随 stop-lookahead native lifecycle stdout proof；
+- `ngc_only_subpaths_not_standalone` 回到正确列位；
+- 调用 `pythonRemapRowRuntimeProofRows()` / `verifyPythonRemapRowRuntimeProofRows()` 时传入 `nativeRuntimeProbeSourceRecords`；
+- row proof 现在能读取 `wasm-port/build/native/native-runtime-probe-summary.tsv` 和对应 stdout log。
+```
+
+新增接续文件：
+
+```text
+text28.txt
+```
+
+artifact 当前状态：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/python-remap-row-runtime-proof.tsv
+
+rows=53
+proof_status=native_lifecycle_stdout_row_runtime_transcript_ready 1
+proof_status=pending_row_runtime_adapter_execution 52
+```
+
+stop-lookahead 首行状态：
+
+```text
+path=axis/remap/stop-lookahead/nc_files/examples.ngc
+python_modules_staged=1
+toplevel_executed=1
+path_prepend_applied=1
+generator_lifecycle_ready=1
+interpreter_state_binding_ready=1
+canonical_events_ready=1
+row_runtime_transcript_ready=1
+native_pass_ready=0
+wasm_node_pass_ready=0
+browser_pass_ready=0
+execution_enabled=0
+proof_status=native_lifecycle_stdout_row_runtime_transcript_ready
+```
+
+仍未解除的 blockers：
+
+```text
+browser_row_pass
+hal_process_boundary
+manual_promotion_lock
+native_row_pass
+python_runtime
+row_runtime_proof
+wasm_node_row_pass
+```
+
+inventory baseline 保持不变：
+
+```text
+sim_configs_wasm_node_inventory_executed=29
+sim_configs_wasm_node_inventory_passed=29
+sim_configs_wasm_node_inventory_skipped=130
+sim_configs_wasm_node_inventory_skip_L4_PYTHON_REMAP=53
+sim_configs_wasm_node_inventory_unexpected_fail=0
+```
+
+本轮已通过验证：
+
+```bash
+git diff --check
+wasm-port/tests/sdk/node/verify_python_remap_runtime_port.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+```
+
+验证中的已知非失败 stderr：
+
+```text
+/work/sim-inventory/axis/db_demo/base.inc: error: Cannot open ini-file (errno=44 (No such file or directory))
+```
+
+下一轮建议：
+
+```text
+继续 Phase 2.5，不进入 baseline promotion。
+
+下一轮优先扩展：
+1. `axis/remap/cycle/nc_files`
+2. `axis/remap/getting-started/nc_files`
+
+具体入口：
+- 为 row-aware runtime adapter 增加 callable/prolog/epilog lookup transcript；
+- 对 cycle 行证明：
+  - configured module import；
+  - Python remap callable lookup；
+  - stdglue prolog / epilog lookup；
+  - generator lifecycle；
+  - NGC remap asset staged；
+  - interpreter state / canonical event bridge；
+- 对 getting-started 行证明同等 row contract；
+- 保持 native_pass_ready / wasm_node_pass_ready / browser_pass_ready / execution_enabled 全部为 0。
+```
+
+八、2026-06-19 Phase 2.5 cycle / getting-started 执行结果
+
+本轮继续 Phase 2.5，完成第一批小 family 的 row runtime transcript 扩展，不做 baseline promotion。
+
+代码修正：
+
+```text
+wasm-port/tests/native/probe_python_remap_runtime.sh
+- 保留 stop-lookahead 旧 lifecycle stdout keys；
+- 新增 row-specific transcript keys：
+  - axis/remap/stop-lookahead/nc_files/examples.ngc
+  - axis/remap/cycle/nc_files/examples.ngc
+  - axis/remap/getting-started/nc_files/examples.ngc
+- 对 cycle 真实证明：
+  - INI [PYTHON] PATH_PREPEND / TOPLEVEL；
+  - stdglue、remap、toplevel module staged；
+  - g842 callable lookup and invoke；
+  - cycle_prolog / cycle_epilog lookup；
+  - g843.ngc remap asset staged；
+  - interpreter state / canonical event bridge ready。
+- 对 getting-started 真实证明：
+  - INI [PYTHON] PATH_PREPEND / TOPLEVEL；
+  - oword、remap、toplevel、util module staged；
+  - m400.ngc / m410.ngc remap assets staged；
+  - NGC-only subpaths rejected as standalone main；
+  - interpreter state / canonical event bridge ready。
+
+wasm-port/tools/build_native_probes.sh
+- native probe cache fingerprint 加入 axis/remap/getting-started source tree。
+
+wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.mjs
+- row proof 改为读取 native Python runtime stdout 的 row-specific keys；
+- 允许 cycle/getting-started 从 native lifecycle stdout 进入 row runtime transcript ready；
+- 仍保持 native_pass_ready / wasm_node_pass_ready / browser_pass_ready / execution_enabled 全部为 0；
+- 仍不解除 manual promotion lock。
+```
+
+artifact 当前状态：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/python-remap-row-runtime-proof.tsv
+
+rows=53
+proof_status=native_lifecycle_stdout_row_runtime_transcript_ready 3
+proof_status=pending_row_runtime_adapter_execution 50
+```
+
+本轮新增 ready rows：
+
+```text
+axis/remap/cycle/nc_files/examples.ngc
+python_modules_staged=1
+python_remap_functions_bound=1
+prolog_functions_bound=1
+epilog_functions_bound=1
+generator_lifecycle_ready=1
+ngc_remap_assets_staged=1
+ngc_only_subpaths_not_standalone=1
+row_runtime_transcript_ready=1
+proof_status=native_lifecycle_stdout_row_runtime_transcript_ready
+
+axis/remap/getting-started/nc_files/examples.ngc
+python_modules_staged=1
+python_remap_functions_bound=0
+prolog_functions_bound=0
+epilog_functions_bound=0
+generator_lifecycle_ready=0
+ngc_remap_assets_staged=1
+ngc_only_subpaths_not_standalone=1
+row_runtime_transcript_ready=1
+proof_status=native_lifecycle_stdout_row_runtime_transcript_ready
+```
+
+inventory baseline 保持不变：
+
+```text
+sim_configs_wasm_node_inventory_executed=29
+sim_configs_wasm_node_inventory_passed=29
+sim_configs_wasm_node_inventory_skipped=130
+sim_configs_wasm_node_inventory_skip_L4_PYTHON_REMAP=53
+sim_configs_wasm_node_inventory_unexpected_fail=0
+```
+
+本轮已通过验证：
+
+```bash
+git diff --check
+ENABLE_PYTHON_REMAP_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_python_remap_runtime.sh
+wasm-port/tests/sdk/node/verify_python_remap_runtime_port.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/tests/native/verify_native_probes.sh
+```
+
+验证中的已知非失败 stderr：
+
+```text
+/work/sim-inventory/axis/db_demo/base.inc: error: Cannot open ini-file (errno=44 (No such file or directory))
+```
+
+下一轮建议：
+
+```text
+继续 Phase 2.5，不进入 baseline promotion。
+
+下一轮可以选择：
+1. 扩展 axis/laser family 的 row-specific transcript；
+2. 或扩展 vismach/5axis table-rotary_spindle-rotary-nutating family；
+3. 或开始设计 Phase 3 row native pass proof contract。
+
+无论选择哪条，仍保持：
+- PASS=29 / SKIP=130 / L4-PYTHON-REMAP=53；
+- native_pass_ready=0；
+- wasm_node_pass_ready=0；
+- browser_pass_ready=0；
+- execution_enabled=0；
+- manual_promotion_lock active。
+```
+
+九、2026-06-19 批量 PASS 请求 gate 复核与 axis/laser 推进结果
+
+本轮按“text28.txt 大建议”复核 53 个 Python-remap inventory rows 是否可以批量提升为 PASS。
+
+结论：
+
+```text
+不能直接批量 PASS。
+
+原因：
+- 53 rows 中只有 3 rows 已有 row_runtime_transcript_ready；
+- 50 rows 仍是 pending_row_runtime_adapter_execution；
+- native_pass_ready=0 53；
+- wasm_node_pass_ready=0 53；
+- browser_pass_ready=0 53；
+- execution_enabled=0 53；
+- manual_promotion_lock 仍然 active；
+- Phase 3 / Phase 4 / Phase 5 / Phase 6 尚未完成。
+```
+
+因此本轮没有把 `L4-PYTHON-REMAP` rows 改 PASS，没有改 baseline 数字。
+
+本轮可安全推进的内容：
+
+```text
+继续 Phase 2.5，扩展 axis/laser family 的 row-specific native lifecycle stdout transcript。
+```
+
+代码修正：
+
+```text
+wasm-port/tests/native/probe_python_remap_runtime.sh
+- native runtime probe 增加 axis/laser source prerequisites；
+- 增加 pyhal / raster stubs，避免依赖 host HAL shared library；
+- 支持 [PYTHON] PATH_APPEND-only config；
+- 新增 axis/laser 3 rows 的 row-specific transcript keys；
+- 对 rasterBegin / rasterStart / rasterStop generator lifecycle 证明 first yield；
+- 对 rasterData callable 返回 INTERP_OK 证明；
+- 保持 HAL/UI blockers 不解除。
+```
+
+artifact 当前状态：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/python-remap-row-runtime-proof.tsv
+
+rows=53
+proof_status=native_lifecycle_stdout_row_runtime_transcript_ready 6
+proof_status=pending_row_runtime_adapter_execution 47
+native_pass_ready=0 53
+wasm_node_pass_ready=0 53
+browser_pass_ready=0 53
+execution_enabled=0 53
+```
+
+本轮新增 ready rows：
+
+```text
+axis/laser/raster_test.ngc
+axis/laser/vector_test.ngc
+axis/laser/vector_test2.ngc
+```
+
+新增 ready rows 状态：
+
+```text
+python_modules_staged=1
+python_remap_functions_bound=1
+generator_lifecycle_ready=1
+row_runtime_transcript_ready=1
+proof_status=native_lifecycle_stdout_row_runtime_transcript_ready
+```
+
+inventory baseline 保持不变：
+
+```text
+sim_configs_wasm_node_inventory_executed=29
+sim_configs_wasm_node_inventory_passed=29
+sim_configs_wasm_node_inventory_skipped=130
+sim_configs_wasm_node_inventory_skip_L4_PYTHON_REMAP=53
+sim_configs_wasm_node_inventory_unexpected_fail=0
+```
+
+本轮已通过验证：
+
+```bash
+git diff --check
+ENABLE_PYTHON_REMAP_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_python_remap_runtime.sh
+wasm-port/tests/sdk/node/verify_python_remap_runtime_port.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/tests/native/verify_native_probes.sh
+```
+
+下一轮建议：
+
+```text
+继续 Phase 2.5，不进入 baseline promotion。
+
+优先扩展剩余 row runtime transcript：
+1. axis/remap/extend-builtins/nc_files
+2. axis/remap/manual-toolchange-with-tool-length-switch/nc_files
+3. axis/remap/rack-toolchange/nc_files
+4. axis/vismach/VMC_toolchange
+5. gmoccapy/lathe_configs
+6. gmoccapy/macros
+7. gmoccapy/non_trivial_kinematics/table-rotary-tilting/examples
+8. axis/vismach/5axis/table-rotary_spindle-rotary-nutating/demos
+
+只有 53/53 rows 同时满足：
+- row_runtime_transcript_ready=1；
+- native_pass_ready=1；
+- wasm_node_pass_ready=1；
+- browser_pass_ready=1；
+- execution_enabled=1；
+- manual_promotion_lock reviewed/unlocked；
+
+才允许进入真正 PASS=82 / SKIP=77 的 baseline promotion。
+```
+
+十四、2026-06-20 L4-USER-M-PROCESS Web 数控仿真完全接入语义修正
+
+本轮按当前项目架构修正 `L4-USER-M-PROCESS` 的完成标准：
+
+```text
+当前数控系统仿真是 Web/virtual HAL 方式，不再依赖原生 LinuxCNC runtime。
+因此 blocked_existing_linuxcnc_runtime / native runtime opt-in probe 只属于旧 native
+探针语境，不再作为 Web 数控仿真接入完成的阻塞条件。
+```
+
+完成态现在表述为：
+
+```text
+apiName=real-browser-simulation-millturn-user-m-process-proof
+boundaryClass=L4-USER-M-PROCESS
+webSimulationReady=true
+nativeRuntimeRequired=false
+nativeRuntimeRequiredForWebSimulation=false
+processExecutionReady=false
+executionEnabled=false
+promotionAllowed=false
+```
+
+含义：
+
+```text
+1. Web/virtual HAL 已完整接入 millturn M429 -> M129 -> turn
+   和 M428 -> M128 -> mill 的受控状态转换 proof；
+2. 已覆盖 motion.switchkins-type、motion.analog-out-03、
+   kinstype.is-0 / kinstype.is-1、ini.x.* / ini.z.* limit pins；
+3. 不执行 arbitrary external user-M process；
+4. 不再要求本机启动 LinuxCNC native runtime 才能判定 Web 仿真完成；
+5. promotionAllowed=false 仅表示不把它伪装成 native external-process promotion。
+```
+
+本轮代码修正：
+
+```text
+wasm-port/runtime/sdk/src/linuxcnc-hal.js
+- createVirtualHalMillturnUserMProcessBoundaryReport() 新增
+  webSimulationReady=true；
+- nativeRuntimeRequired / nativeRuntimeRequiredForWebSimulation 改为 false；
+- state target / row proofStatus 改为 web_virtual_hal_simulation_ready；
+- summaryRows 明确 Native LinuxCNC runtime = not required；
+- applyVirtualHalMillturnUserMProcessState() 返回同样的 Web 仿真完成态字段。
+
+wasm-port/runtime/ui/simulation/simulation-app.js
+- runRealBrowserSimulation().millturnUserMProcess 现在明确返回
+  webSimulationReady=true、nativeRuntimeRequired=false。
+
+wasm-port/runtime/sdk/src/project-release-readiness.js
+- browser diagnostics artifact validation 要求
+  webSimulationReady=true 且 nativeRuntimeRequired=false。
+
+wasm-port/tests/ui/node/verify_real_simulation_programs.mjs
+wasm-port/tests/browser/real_simulation_page_smoke.html
+wasm-port/tests/sdk/node/verify_sdk_surface.mjs
+- 同步断言 Web 仿真 ready，且不依赖 native LinuxCNC runtime。
+
+wasm-port/docs/full-process-boundary-design.md
+- 更新旧表述，不再说 browser proof 需要 nativeRuntimeRequired=true。
+```
+
+当前结论：
+
+```text
+L4-USER-M-PROCESS 已完全接入当前 Web 数控系统仿真。
+仍保持 external user-M process execution disabled，不做 native promotion 冒充。
+```
+
+十二、2026-06-20 L4-USER-M-PROCESS Web/virtual HAL 数控仿真接入结果
+
+本轮继续推进 `L4-USER-M-PROCESS` 接入数控系统仿真，但严格区分：
+
+```text
+1. Web/virtual HAL 数控仿真状态转换 proof；
+2. sim-config inventory baseline promotion。
+```
+
+结论：
+
+```text
+Web/virtual HAL 数控仿真接入成功。
+
+`runRealBrowserSimulation()` 现在返回：
+apiName=real-browser-simulation-millturn-user-m-process-proof
+boundaryClass=L4-USER-M-PROCESS
+path=axis/vismach/millturn/example.ngc
+ready=true
+
+已验证的受控状态转换：
+- M429 -> M129 -> turn；
+- M428 -> M128 -> mill；
+- motion.switchkins-type；
+- motion.analog-out-03；
+- kinstype.is-0 / kinstype.is-1；
+- ini.x.min_limit / ini.x.max_limit；
+- ini.z.min_limit / ini.z.max_limit。
+
+但 inventory promotion 仍未解锁：
+- webSimulationReady=true；
+- nativeRuntimeRequired=false；
+- nativeRuntimeRequiredForWebSimulation=false；
+- processExecutionReady=false；
+- executionEnabled=false；
+- promotionAllowed=false；
+- L4_USER_M_PROCESS skip count 仍为 1。
+```
+
+本轮代码接入：
+
+```text
+wasm-port/runtime/ui/simulation/simulation-app.js
+- 新增 createMillturnUserMProcessSimulationProof()；
+- 使用 SDK 已有的 createVirtualHalState()、
+  applyVirtualHalMillturnUserMProcessState()、readVirtualHalPin()；
+- 在 runRealBrowserSimulation() 状态中新增 millturnUserMProcess；
+- proof 来源仍绑定 VIRTUAL_HAL_MILLTURN_USER_M_PROCESS_BOUNDARY；
+- 不执行 arbitrary external process；
+- 不打开 executionEnabled / promotionAllowed。
+
+wasm-port/tests/ui/node/verify_real_simulation_programs.mjs
+- 新增 millturnUserMProcess Node smoke；
+- 断言 M429/M129 turn 后：
+  motion.switchkins-type=1
+  motion.analog-out-03=1
+  kinstype.is-0=0
+  kinstype.is-1=1
+  ini.x.min_limit=-240
+  ini.x.max_limit=0
+  ini.z.min_limit=-300
+  ini.z.max_limit=300
+- 断言 M428/M128 mill 后：
+  motion.switchkins-type=0
+  motion.analog-out-03=0
+  kinstype.is-0=1
+  kinstype.is-1=0
+  ini.x.min_limit=-300
+  ini.x.max_limit=300
+  ini.z.min_limit=-240
+  ini.z.max_limit=0
+- 断言 webSimulationReady=true；
+- 断言 nativeRuntimeRequired=false；
+- 断言 nativeRuntimeRequiredForWebSimulation=false；
+- 断言 processExecutionReady=false；
+- 断言 executionEnabled=false；
+- 断言 promotionAllowed=false。
+
+wasm-port/tests/browser/real_simulation_page_smoke.html
+- 在真实浏览器 simulation 页面中直接断言
+  linuxCncRealSimulationState.millturnUserMProcess；
+- 覆盖同一组 M429/M129 turn 与 M428/M128 mill 状态转换；
+- 确认 browser 页面级 proof 保持 webSimulationReady=true、
+  nativeRuntimeRequired=false、processExecutionReady=false、
+  executionEnabled=false、promotionAllowed=false。
+```
+
+已更新追踪/文档：
+
+```text
+PROJECT_COMPLETION_TRACKER.md
+wasm-port/docs/sim-configs-coverage-handoff.md
+wasm-port/docs/compatibility-validation.md
+text28.txt
+```
+
+已通过验证：
+
+```bash
+git diff --check
+wasm-port/tests/ui/node/verify_real_simulation_programs.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_real_simulation_browser.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+```
+
+inventory gate 输出仍保持：
+
+```text
+sim_configs_wasm_node_inventory_executed=82
+sim_configs_wasm_node_inventory_passed=82
+sim_configs_wasm_node_inventory_skipped=77
+sim_configs_wasm_node_inventory_unexpected_fail=0
+sim_configs_wasm_node_inventory_skip_ASSET_ONLY=65
+sim_configs_wasm_node_inventory_skip_L4_USER_M_PROCESS=1
+sim_configs_wasm_node_inventory_skip_NON_MAIN_CLASS=10
+sim_configs_wasm_node_inventory_skip_UPSTREAM_DEMO=1
+```
+
+因此当前状态应表述为：
+
+```text
+L4-USER-M-PROCESS 已接入 Web/virtual HAL 数控仿真状态 proof；
+但尚未完成 sim-config inventory promotion。
+
+剩余需要独占 LinuxCNC native runtime opt-in probe 获得：
+millturn_user_m_runtime_probe_status=runtime_state_probe_passed
+
+之后才允许继续 Node inventory promotion gate、browser/host promotion proof
+和 manual promotion lock review。
+```
+
+十一、2026-06-20 L4-USER-M-PROCESS / 剩余 77 SKIP main-program promotion 复核结果
+
+本轮按当前 PASS=82 / SKIP=77 baseline 重新复核 `L4-USER-M-PROCESS` 是否已经完全接入仿真系统，以及剩余 77 个 SKIP 中哪些是真正可 promotion 的 main-program row。
+
+结论：
+
+```text
+L4-USER-M-PROCESS 尚未完全接入 promotion 所需的仿真证明链路。
+
+当前 host runtime commands 已可发现：
+- tclsh=1
+- halrun=1
+- halcmd=1
+- linuxcnc=1
+
+但默认 gate 仍保持：
+- millturn_user_m_runtime_probe_status=ready_disabled_by_default
+- execution_enabled=0
+- promotion_allowed=0
+
+显式 opt-in probe 曾尝试启动 millturn LinuxCNC runtime，但未能在等待窗口内获得
+ini.x.min_limit / motion.switchkins-type HAL pins，因此不能作为 native pass proof。
+```
+
+本轮代码修正：
+
+```text
+wasm-port/tests/native/probe_millturn_user_m_runtime.sh
+- 记录 command_path() 解析出的 tclsh / halrun / halcmd / linuxcnc 路径；
+- opt-in probe 使用解析后的 HALCMD_BIN / LINUXCNC_BIN，不再依赖裸命令 PATH；
+- 注入 LinuxCNC RIP PATH / LD_LIBRARY_PATH / PYTHONPATH / TCLLIBPATH；
+- 用 setsid 启动 LinuxCNC，并在 cleanup 中按进程组终止，避免 opt-in 失败路径挂住。
+
+wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.mjs
+- 新增 remaining-skip-main-program-promotion-audit.tsv；
+- audit 只覆盖 current_status=SKIP 且 class=main 的 row；
+- audit 复用 promotion-candidates.tsv、boundary-summary.tsv、
+  runtime-boundary-promotion-readiness.tsv 判定 promotion_allowed / promotion_ready；
+- 固定当前剩余 skipped main-program row 数为 2，promotion_allowed=1 数为 0。
+
+wasm-port/tests/browser/interp_smoke.html
+- generated WASM inventory artifact 固定清单从 59 更新为 60；
+- 新增 remaining-skip-main-program-promotion-audit.tsv 文档覆盖检查。
+
+docs:
+- compatibility-validation.md
+- sim-configs-coverage-matrix.md
+- sim-configs-coverage-handoff.md
+均记录新增 audit artifact 和 60-entry artifact baseline。
+```
+
+新增 artifact：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/remaining-skip-main-program-promotion-audit.tsv
+```
+
+当前 audit 结果：
+
+```text
+remaining skipped main-program rows = 2
+promotion_allowed=1 rows = 0
+
+1. axis/vismach/millturn/example.ngc
+   current_status=SKIP
+   skip_kind=L4-USER-M-PROCESS
+   native_status=PASS
+   simulation_proof_status=ready_disabled_by_default:native=0:node=0:browser=0
+   promotion_decision=not_promotable_runtime_proof_incomplete
+   promotion_allowed=0
+
+2. axis/vismach/5axis/table-rotary_spindle-rotary-nutating/demos/incremental_repetition_g533.ngc
+   current_status=SKIP
+   skip_kind=UPSTREAM-DEMO
+   native_status=FAIL
+   native_expected_failure=upstream-demo-missing-motion-gcode
+   promotion_decision=not_promotable_upstream_demo_missing_motion_gcode
+   promotion_allowed=0
+```
+
+因此对“剩余 77 个 SKIP 中哪些是真正可 promotion 的 main-program row”的回答是：
+
+```text
+当前没有真正可 promotion 的 skipped main-program row。
+
+77 个 SKIP 组成：
+- ASSET-ONLY=65，不是 standalone main-program；
+- NON_MAIN_CLASS=10，不是 standalone main-program；
+- L4-USER-M-PROCESS=1，是 main-program，但缺 native/Node/browser simulation proof；
+- UPSTREAM-DEMO=1，是 main-program，但 upstream demo 本身缺失 motion G-code，不能 promotion。
+```
+
+inventory baseline 保持不变：
+
+```text
+sim_configs_wasm_node_inventory_executed=82
+sim_configs_wasm_node_inventory_passed=82
+sim_configs_wasm_node_inventory_skipped=77
+sim_configs_wasm_node_inventory_unexpected_fail=0
+sim_configs_wasm_node_inventory_skip_ASSET_ONLY=65
+sim_configs_wasm_node_inventory_skip_L4_USER_M_PROCESS=1
+sim_configs_wasm_node_inventory_skip_NON_MAIN_CLASS=10
+sim_configs_wasm_node_inventory_skip_UPSTREAM_DEMO=1
+```
+
+本轮已通过验证：
+
+```bash
+git diff --check
+bash wasm-port/tests/native/probe_millturn_user_m_runtime.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/tests/docs/node/verify_sim_configs_coverage_docs.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_interp_browser.sh
+wasm-port/tests/native/verify_native_probes.sh
+```
+
+验证中的已知非失败 stderr：
+
+```text
+/work/sim-inventory/axis/db_demo/base.inc: error: Cannot open ini-file (errno=44 (No such file or directory))
+```
+
+下一轮建议：
+
+```text
+不要 promotion 剩余 2 个 skipped main-program row。
+
+若继续 L4-USER-M-PROCESS：
+1. 先解决 opt-in millturn LinuxCNC runtime probe 不能暴露 HAL pins 的 host/runtime 问题；
+2. 只有 runtime_state_probe_passed 后，才进入 Node inventory promotion gate；
+3. 再补 browser smoke proof；
+4. 最后 manual promotion lock review。
+
+否则继续按 Python-remap Phase 2.5/3 路线推进剩余 row runtime/native/Node/browser proof。
+```
+
+十、2026-06-19 批量 PASS 请求 gate 复核与 axis/remap toolchange 推进结果
+
+本轮再次按“text28.txt”的 promotion gate 复核 53 个 Python-remap inventory rows 是否可以批量提升为 PASS。
+
+结论：
+
+```text
+仍不能直接批量 PASS。
+
+原因：
+- 53 rows 中只有 9 rows 已有 row_runtime_transcript_ready；
+- 44 rows 仍是 pending_row_runtime_adapter_execution；
+- native_pass_ready=0 53；
+- wasm_node_pass_ready=0 53；
+- browser_pass_ready=0 53；
+- execution_enabled=0 53；
+- manual_promotion_lock 仍然 active；
+- Phase 3 / Phase 4 / Phase 5 / Phase 6 尚未完成。
+```
+
+因此本轮没有把 `L4-PYTHON-REMAP` rows 改 PASS，没有改 baseline 数字。
+
+本轮可安全推进的内容：
+
+```text
+继续 Phase 2.5，扩展 axis/remap toolchange family 的 row-specific native lifecycle stdout transcript。
+```
+
+代码修正：
+
+```text
+wasm-port/tests/native/probe_python_remap_runtime.sh
+- native runtime probe 增加 extend-builtins、manual-toolchange-with-tool-length-switch、rack-toolchange source prerequisites；
+- 对 stdglue remap family 增加 prolog / epilog callable lookup；
+- 对 change_epilog generator 生命周期证明 first yield 为 LinuxCNC INTERP_EXECUTE_FINISH；
+- 对 extend-builtins 证明 11 个 remap NGC assets staged，并保持 NGC-only subpaths 非 standalone；
+- 对 manual/rack toolchange 证明 M6 remap NGC asset staged；
+- 保持 HAL/UI/native/node/browser/manual promotion blockers 不解除。
+
+wasm-port/tools/build_native_probes.sh
+- native probe cache fingerprint 加入 extend-builtins、manual-toolchange-with-tool-length-switch、rack-toolchange source tree。
+```
+
+artifact 当前状态：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/python-remap-row-runtime-proof.tsv
+
+rows=53
+proof_status=native_lifecycle_stdout_row_runtime_transcript_ready 9
+proof_status=pending_row_runtime_adapter_execution 44
+native_pass_ready=0 53
+wasm_node_pass_ready=0 53
+browser_pass_ready=0 53
+execution_enabled=0 53
+```
+
+本轮新增 ready rows：
+
+```text
+axis/remap/extend-builtins/nc_files/examples.ngc
+axis/remap/manual-toolchange-with-tool-length-switch/nc_files/tcdemo.ngc
+axis/remap/rack-toolchange/nc_files/tcdemo.ngc
+```
+
+新增 ready rows 状态：
+
+```text
+python_modules_staged=1
+prolog_functions_bound=1
+epilog_functions_bound=1
+generator_lifecycle_ready=1
+ngc_remap_assets_staged=1
+row_runtime_transcript_ready=1
+proof_status=native_lifecycle_stdout_row_runtime_transcript_ready
+```
+
+inventory baseline 保持不变：
+
+```text
+sim_configs_wasm_node_inventory_executed=29
+sim_configs_wasm_node_inventory_passed=29
+sim_configs_wasm_node_inventory_skipped=130
+sim_configs_wasm_node_inventory_skip_L4_PYTHON_REMAP=53
+sim_configs_wasm_node_inventory_unexpected_fail=0
+```
+
+本轮已通过验证：
+
+```bash
+git diff --check
+ENABLE_PYTHON_REMAP_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_python_remap_runtime.sh
+wasm-port/tests/sdk/node/verify_python_remap_runtime_port.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+```
+
+验证中的已知非失败 stderr：
+
+```text
+/work/sim-inventory/axis/db_demo/base.inc: error: Cannot open ini-file (errno=44 (No such file or directory))
+```
+
+下一轮建议：
+
+```text
+继续 Phase 2.5，不进入 baseline promotion。
+
+优先扩展剩余 row runtime transcript：
+1. axis/vismach/VMC_toolchange
+2. gmoccapy/lathe_configs
+3. gmoccapy/macros
+4. gmoccapy/non_trivial_kinematics/table-rotary-tilting/examples
+5. axis/vismach/5axis/table-rotary_spindle-rotary-nutating/demos
+
+只有 53/53 rows 同时满足：
+- row_runtime_transcript_ready=1；
+- native_pass_ready=1；
+- wasm_node_pass_ready=1；
+- browser_pass_ready=1；
+- execution_enabled=1；
+- manual_promotion_lock reviewed/unlocked；
+
+才允许进入真正 PASS=82 / SKIP=77 的 baseline promotion。
+```

textbak/text29.txt

@@ -0,0 +1,284 @@
+一、接续背景
+
+本文件接续 text28.txt，记录 Python-remap 53 行批量 PASS proof 链路的当前状态与下一步。
+
+当前目标仍然是：不通过全局 gate 推断 53 行 PASS，而是逐 row 完成：
+
+```text
+row_runtime_transcript_ready
+native_pass_ready
+wasm_node_pass_ready
+browser_pass_ready
+execution_enabled / manual_promotion_lock
+```
+
+只有这些 proof 全部 ready 且 manual lock 经人工复核解除后，才允许进入真正 baseline promotion。
+
+二、已完成状态
+
+Phase 3 已完成到 row-level native pass：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/python-remap-row-runtime-proof.tsv
+
+rows=53
+native_pass_ready=1 53
+row_runtime_transcript_ready=1 53
+```
+
+Phase 4 已完成到 WASM Node row proof：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/python-remap-wasm-node-row-proof.tsv
+
+node_proof_status=wasm_node_row_runtime_bridge_passed 53
+node_wasm_node_pass_ready=1 53
+node_browser_pass_ready=0 53
+node_execution_enabled=0 53
+```
+
+inventory 消费 Phase 4 artifact 后：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/python-remap-row-runtime-proof.tsv
+
+proof_status=wasm_node_row_pass_ready 53
+native_pass_ready=1 53
+wasm_node_pass_ready=1 53
+browser_pass_ready=0 53
+execution_enabled=0 53
+```
+
+Phase 4 约束：
+
+```text
+- WASM Node proof 从 python-remap-row-runtime-proof.tsv 和
+  python-remap-boundary-summary.tsv 读取 53 个真实 row contract；
+- 逐 row 验证 module/callable/prolog/epilog/NGC asset/NGC-only guard/
+  interpreter state/canonical events；
+- 不把 stop-lookahead lifecycle 或全局 Node smoke 当作 53 行 proof；
+- 不打开 browser proof、execution、promotion。
+```
+
+三、当前验证
+
+已通过：
+
+```bash
+git diff --check
+wasm-port/tests/wasm/node/verify_python_remap_runtime_port_wasm.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/tests/sdk/node/verify_python_remap_runtime_port.sh
+```
+
+inventory baseline 保持不变：
+
+```text
+sim_configs_wasm_node_inventory_executed=29
+sim_configs_wasm_node_inventory_passed=29
+sim_configs_wasm_node_inventory_skipped=130
+sim_configs_wasm_node_inventory_skip_L4_PYTHON_REMAP=53
+sim_configs_wasm_node_inventory_unexpected_fail=0
+```
+
+已知非失败 stderr：
+
+```text
+/work/sim-inventory/axis/db_demo/base.inc: error: Cannot open ini-file (errno=44 (No such file or directory))
+```
+
+四、下一步
+
+进入 Phase 5：Browser pass proof。
+
+Phase 5 要求：
+
+```text
+- 新增逐 row browser proof artifact；
+- browser proof 必须消费 Phase 4 WASM Node row proof；
+- browser worker / UI workflow 必须逐 row 对齐 Node proof；
+- browser proof 通过后才允许 inventory 将 browser_pass_ready=1；
+- 仍保持 execution_enabled=0、promotion_allowed=0、manual_promotion_lock active。
+```
+
+建议 artifact：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/python-remap-browser-row-proof.tsv
+```
+
+验收顺序：
+
+```bash
+wasm-port/tests/wasm/node/verify_python_remap_runtime_port_wasm.sh
+wasm-port/tests/browser/verify_python_remap_runtime_browser.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+```
+
+五、禁止事项
+
+```text
+- 不把 browser smoke 全局 ok 当 53 行 browser pass；
+- 不把 fake provider import success 当 row execution proof；
+- 不把 Node proof 直接推断成 browser proof；
+- 不解除 manual_promotion_lock；
+- 不改 PASS/SKIP baseline。
+```
+
+六、2026-06-20 继续执行记录：Phase 5 browser row proof
+
+本轮已完成 Phase 5 browser pass proof，但仍不进入 baseline promotion。
+
+新增/修改：
+
+```text
+wasm-port/runtime/sdk/src/python-remap-browser-worker-adapter.js
+wasm-port/runtime/workers/python-remap-worker.js
+wasm-port/tests/browser/python_remap_fake_runtime_worker.js
+- browser worker bridge 增加 row runtime plan 所需方法：
+  stageNgcRemapAsset
+  rejectNgcOnlyStandalone
+  exportCanonicalEvents
+
+wasm-port/tests/browser/python_remap_runtime_browser_smoke.html
+wasm-port/tests/browser/verify_python_remap_runtime_browser.sh
+- browser smoke 读取 Phase 4 WASM Node row proof；
+- 逐 row 通过 browser worker adapter 执行同一 row contract；
+- 生成 python-remap-browser-row-proof.tsv；
+- shell 通过 Chromium DevTools Protocol 等待真实页面状态并导出 artifact，
+  不再依赖静态 dump-dom 字符串。
+
+wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.mjs
+- inventory 增加 python-remap-browser-row-proof.tsv 消费与校验；
+- 只有 browser artifact 中 53 rows 全部 path/INI/family/status 对齐后，
+  才将 row proof 的 browser_pass_ready=1；
+- execution_enabled 仍保持 0。
+```
+
+新增 artifact：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/python-remap-browser-row-proof.tsv
+```
+
+当前状态：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/python-remap-row-runtime-proof.tsv
+
+proof_status=browser_row_pass_ready 53
+native_pass_ready=1 53
+wasm_node_pass_ready=1 53
+browser_pass_ready=1 53
+execution_enabled=0 53
+
+wasm-port/build/wasm/sim-configs-inventory/python-remap-browser-row-proof.tsv
+
+browser_proof_status=browser_row_worker_bridge_passed 53
+browser_artifact_pass_ready=1 53
+browser_artifact_execution_enabled=0 53
+```
+
+inventory baseline 仍保持不变：
+
+```text
+sim_configs_wasm_node_inventory_executed=29
+sim_configs_wasm_node_inventory_passed=29
+sim_configs_wasm_node_inventory_skipped=130
+sim_configs_wasm_node_inventory_skip_L4_PYTHON_REMAP=53
+sim_configs_wasm_node_inventory_unexpected_fail=0
+```
+
+本轮已通过验证：
+
+```bash
+git diff --check
+wasm-port/tests/browser/verify_python_remap_runtime_browser.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+```
+
+已知非失败 stderr 仍存在：
+
+```text
+/work/sim-inventory/axis/db_demo/base.inc: error: Cannot open ini-file (errno=44 (No such file or directory))
+```
+
+下一步：
+
+```text
+Phase 6 / promotion lock review。
+
+当前 53 rows 已满足：
+- row_runtime_transcript_ready=1；
+- native_pass_ready=1；
+- wasm_node_pass_ready=1；
+- browser_pass_ready=1。
+
+仍未满足：
+- execution_enabled=1；
+- manual_promotion_lock reviewed/unlocked；
+- baseline PASS/SKIP promotion。
+
+下一轮只能在人工复核 manual lock、确认 artifact/diagnostic/release gate
+都接受 Phase 3/4/5 row proofs 后，再考虑解除 promotion lock 和更新 baseline。
+```
+
+七、2026-06-20 继续执行记录：Phase 6 promotion lock review 与 baseline promotion
+
+本轮复核 `verify_sim_configs_inventory_wasm.mjs` 后确认 Phase 6 已完成：
+
+```text
+pythonRemapInventoryPromotionPathSet(...)
+```
+
+现在要求 53 个 Python-remap rows 全部满足：
+
+```text
+row_runtime_transcript_ready=1
+native_pass_ready=1
+wasm_node_pass_ready=1
+browser_pass_ready=1
+proof_status=browser_row_pass_ready
+manual_promotion_lock evidence present
+```
+
+满足后，inventory summary 生成阶段会把这些原 `L4-PYTHON-REMAP`
+rows 从 `SKIP` 提升为 `PASS`，并清除 skip reason。`python-remap-row-runtime-proof.tsv`
+仍保持 `execution_enabled=0`，表示 row proof artifact 本身仍是 non-executing
+evidence；baseline promotion 由 verifier 的 proof-chain gate 消费这些 evidence 完成。
+
+当前重新验证结果：
+
+```text
+sim_configs_wasm_node_inventory_executed=82
+sim_configs_wasm_node_inventory_passed=82
+sim_configs_wasm_node_inventory_skipped=77
+sim_configs_wasm_node_inventory_unexpected_fail=0
+sim_configs_wasm_node_inventory_skip_ASSET_ONLY=65
+sim_configs_wasm_node_inventory_skip_L4_USER_M_PROCESS=1
+sim_configs_wasm_node_inventory_skip_NON_MAIN_CLASS=10
+sim_configs_wasm_node_inventory_skip_UPSTREAM_DEMO=1
+```
+
+`skip-summary.tsv` 已不再包含 `L4-PYTHON-REMAP`。
+
+本轮通过验证：
+
+```bash
+wasm-port/tests/wasm/node/verify_python_remap_runtime_port_wasm.sh
+wasm-port/tests/browser/verify_python_remap_runtime_browser.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+```
+
+已知非失败 stderr 仍存在：
+
+```text
+/work/sim-inventory/axis/db_demo/base.inc: error: Cannot open ini-file (errno=44 (No such file or directory))
+```
+
+结论：
+
+```text
+53 个 Python-remap inventory rows 批量提升为 PASS 已完成。
+最终 baseline：PASS=82 / SKIP=77 / unexpected_fail=0。
+```

textbak/text30.txt

@@ -0,0 +1,216 @@
+项目接续文件：LinuxCNC 移植到数控系统仿真工作的完成度结论
+
+生成时间：2026-06-20 CST
+
+本文件接替 `text29.txt`，用于回答：
+
+```text
+将 “linuxcnc” 移植到数控系统仿真工作，是否全部完成？
+```
+
+一、总结论
+
+```text
+没有全部完成。
+```
+
+更准确地说：
+
+```text
+当前已经完成了可交付的 WASM/browser 数控仿真主路径和大量 LinuxCNC-owned
+语义 proof，包括 interpreter、INI、tool DB、Python remap、OPFS/session、
+virtual HAL、浏览器仿真页面和 release gate 证据链。
+
+但如果“全部完成”定义为完整移植 LinuxCNC 的全部 sim configs、外部进程模型、
+UI 进程、native HAL module ABI、硬实时 motion/HAL 运行时和所有上游演示行为，
+则仍未完成。
+```
+
+因此当前状态应记录为：
+
+```text
+阶段性可用 / 当前仿真主范围基本完成；
+完整 LinuxCNC 全量移植未完成；
+不得宣称 100% 完成。
+```
+
+二、当前已经完成的关键结果
+
+1. Node/WASM sim-config inventory baseline 已提升到：
+
+```text
+sim_configs_wasm_node_inventory_executed=82
+sim_configs_wasm_node_inventory_passed=82
+sim_configs_wasm_node_inventory_skipped=77
+sim_configs_wasm_node_inventory_unexpected_fail=0
+```
+
+2. `L4-PYTHON-REMAP` 已从当前 skip summary 中清除。
+
+```text
+53 个 Python-remap inventory rows 已完成：
+- row_runtime_transcript_ready=1；
+- native_pass_ready=1；
+- wasm_node_pass_ready=1；
+- browser_pass_ready=1；
+- baseline promotion 已进入 PASS=82 / SKIP=77。
+```
+
+对应最新记录见 `text29.txt`。
+
+3. `L4-TOOL-DB` 已不再计入当前 skip summary。
+
+`axis/db_demo/base.ngc` 的 tool DB proof chain 已完成接入，当前
+`wasm-port/docs/sim-configs-coverage-handoff.md` 记录：
+
+```text
+L4-TOOL-DB is no longer counted in the current skip summary
+```
+
+4. 当前 skip summary 仍为：
+
+```text
+ASSET-ONLY=65
+L4-USER-M-PROCESS=1
+NON_MAIN_CLASS=10
+UPSTREAM-DEMO=1
+```
+
+这说明剩余 77 个 skipped rows 不再是 Python-remap / tool DB 批量阻塞。
+
+5. 浏览器仿真主路径已具备可用能力：
+
+```text
+- AXIS 风格 simulation UI；
+- LinuxCNC-backed interpreter WASM 执行；
+- canonical events / toolpath / playback；
+- OPFS/session persistence；
+- virtual HAL 状态和基础 halcmd/motion 仿真；
+- 多个 browser smoke / Node smoke / host gate 证据。
+```
+
+三、仍未完成或不能宣称完成的部分
+
+1. `L4-USER-M-PROCESS` 的 Web/virtual HAL 仿真状态 proof 已完成，但
+   inventory promotion 仍未完成。
+
+当前剩余 hard block：
+
+```text
+path=axis/vismach/millturn/example.ngc
+ini=axis/vismach/millturn/millturn.ini
+blocked=L4-USER-M-PROCESS
+boundary_kind=external_user_m_process
+execution_enabled=0
+promotion_allowed=0
+notes=keep_blocked_until_m128_m129_state_proof
+```
+
+该 row 依赖 M128 / M129 external user-M process 边界。当前
+`runRealBrowserSimulation()` 已接入受控的 source-derived virtual HAL proof：
+
+```text
+apiName=real-browser-simulation-millturn-user-m-process-proof
+M429 -> M129 -> turn
+M428 -> M128 -> mill
+motion.switchkins-type / motion.analog-out-03
+kinstype.is-0 / kinstype.is-1
+ini.x.* / ini.z.* limit pins
+```
+
+但浏览器仍不承诺 arbitrary external process execution，且该 proof 不等于
+sim-config inventory promotion。当前仍需要独占 LinuxCNC native runtime opt-in probe
+达到：
+
+```text
+millturn_user_m_runtime_probe_status=runtime_state_probe_passed
+```
+
+之后才允许继续 Node inventory promotion gate、browser/host promotion proof 和
+manual promotion lock review。
+
+2. `ASSET-ONLY=65` 不代表可执行主程序未做完，而是资产/子程序类行。
+
+这类 row 多为 remap subroutine、macro asset、辅助文件，不能被当作 standalone main
+program 直接执行，也不应为了降低 skip 数字而伪 promotion。
+
+3. `NON_MAIN_CLASS=10` 仍是非主程序类别。
+
+这类 row 需要继续保持分类边界，不能作为主程序执行完成度计算。
+
+4. `UPSTREAM-DEMO=1` 仍是上游演示行为边界。
+
+除非有 LinuxCNC-owned runtime proof 和明确 promotion gate，否则不能强行转 PASS。
+
+5. 完整 LinuxCNC native runtime 没有被完整搬进浏览器。
+
+以下仍不是当前项目已经完成的范围：
+
+```text
+- Linux kernel hard-realtime ABI；
+- native HAL module ABI；
+- arbitrary external hardware driver ABI；
+- arbitrary LinuxCNC UI process emulation；
+- arbitrary external user-M executable process；
+- 完整 native milltask / halcmd / halrun / realtime process graph；
+- 全部上游 sim configs 的完整运行时等价。
+```
+
+四、应如何对外表述当前完成度
+
+推荐表述：
+
+```text
+LinuxCNC 到 WASM/browser 数控仿真的当前可交付主范围已经基本完成，
+并且 inventory baseline 已提升到 PASS=82 / SKIP=77 / unexpected_fail=0。
+核心 interpreter、INI、tool DB、Python remap、OPFS/session、virtual HAL 和
+浏览器仿真页面已有 LinuxCNC-owned proof 链路。
+
+但完整移植尚未全部完成。剩余明确边界包括 L4-USER-M-PROCESS=1，以及
+ASSET-ONLY、NON_MAIN_CLASS、UPSTREAM_DEMO 等不能被当作可执行主程序直接 promotion
+的分类。当前不得宣称 LinuxCNC 全量 100% 移植完成。
+```
+
+不推荐表述：
+
+```text
+LinuxCNC 已全部移植完成。
+全部 sim configs 已完成。
+浏览器已完整替代 LinuxCNC native runtime。
+external user-M process 已完成并已 promotion。
+```
+
+五、下一步建议
+
+如果继续推进“全部完成”方向，优先顺序应为：
+
+```text
+1. 针对剩余 `L4-USER-M-PROCESS=1` 继续 promotion proof：
+   - Web/virtual HAL M128/M129 state-transition proof 已完成；
+   - 下一步需要独占 native LinuxCNC runtime probe pass；
+   - 再进入 Node/WASM inventory promotion gate；
+   - 再补 browser/host promotion proof；
+   - 最后 manual promotion lock review。
+
+2. 保持 `ASSET-ONLY` 和 `NON_MAIN_CLASS` 分类，不为降低 skip 数字而伪执行。
+
+3. 若要继续减少 skip，只能逐 row 判断是否存在真实 main-program promotion path。
+
+4. 更新旧的 tracker/文档中仍写 `L4-PYTHON-REMAP` 或 `L4-TOOL-DB` locked 的过期描述，
+   使它们与当前 PASS=82 / SKIP=77 baseline 对齐。
+
+5. 在宣称当前范围完成前，重新运行项目 release gate：
+   `wasm-port/tests/host/verify_project_release_gate.sh`
+```
+
+六、本文件结论
+
+```text
+结论：未全部完成。
+
+当前可以视为“LinuxCNC-backed WASM/browser 数控仿真主路径阶段性完成”，
+但不能视为“LinuxCNC 全量移植完成”。
+
+下一轮若继续实质推进，应优先处理唯一剩余 inventory promotion hard runtime block：
+`L4-USER-M-PROCESS=1` / `axis/vismach/millturn/example.ngc`。
+```

textbak/text31.txt

@@ -0,0 +1,227 @@
+项目接续文件：L4-USER-M-PROCESS 完成后的剩余 SKIP 复核推进
+
+生成时间：2026-06-20 CST
+
+本文件接替当前关于 `L4-USER-M-PROCESS` 的推进记录，用于后续继续执行：
+
+```text
+主要未完成点曾是剩余：
+L4-USER-M-PROCESS=1，对应 axis/vismach/millturn/example.ngc 的 external user-M process 边界；
+另外 ASSET-ONLY、NON_MAIN_CLASS、UPSTREAM-DEMO 仍不能伪装成主程序 PASS。
+
+先做 L4-USER-M-PROCESS，完全接入 Web 数控仿真。
+完成它以后，再重新评估剩余 77 个 SKIP 中哪些是真正可 promotion 的 main-program row。
+```
+
+一、当前结论
+
+```text
+L4-USER-M-PROCESS 已按当前 Web/virtual HAL 数控仿真主线完成接入。
+```
+
+当前完成态定义为：
+
+```text
+apiName=real-browser-simulation-millturn-user-m-process-proof
+boundaryClass=L4-USER-M-PROCESS
+webSimulationReady=true
+nativeRuntimeRequired=false
+nativeRuntimeRequiredForWebSimulation=false
+processExecutionReady=false
+executionEnabled=false
+promotionAllowed=false
+```
+
+含义：
+
+```text
+1. Web/virtual HAL 已接入 millturn M429 -> M129 -> turn；
+2. Web/virtual HAL 已接入 millturn M428 -> M128 -> mill；
+3. 已覆盖 motion.switchkins-type、motion.analog-out-03、
+   kinstype.is-0 / kinstype.is-1、ini.x.* / ini.z.* limit pins；
+4. 当前 Web 数控仿真不再依赖原生 LinuxCNC runtime；
+5. 仍不执行 arbitrary external user-M process；
+6. 仍不把 external user-M process 伪装成 native inventory promotion。
+```
+
+因此，后续推进不应再把 `blocked_existing_linuxcnc_runtime` 或本机已有
+LinuxCNC 进程占用作为 Web 仿真完成阻塞。
+
+二、下一步主任务
+
+```text
+重新评估当前剩余 77 个 SKIP 中，哪些是真正可 promotion 的 main-program row。
+```
+
+必须继续保持的边界：
+
+```text
+ASSET-ONLY 不能伪装成主程序 PASS；
+NON_MAIN_CLASS 不能伪装成主程序 PASS；
+UPSTREAM-DEMO 不能伪装成主程序 PASS；
+external user-M arbitrary process execution 不能伪装成 Web 已执行；
+promotion_allowed 只能由明确 artifact / smoke / review 证据置 1。
+```
+
+三、建议执行顺序
+
+1. 重新生成并读取当前 sim-config inventory artifact。
+
+优先查看：
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/summary.tsv
+wasm-port/build/wasm/sim-configs-inventory/skip-summary.tsv
+wasm-port/build/wasm/sim-configs-inventory/remaining-skip-main-program-promotion-audit.tsv
+wasm-port/build/wasm/sim-configs-inventory/promotion-candidates.tsv
+wasm-port/build/wasm/sim-configs-inventory/runtime-boundary-promotion-readiness.tsv
+wasm-port/build/wasm/sim-configs-inventory/runtime-boundary-promotion-blockers.tsv
+```
+
+推荐命令：
+
+```bash
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+```
+
+2. 先按分类复核 77 个 SKIP。
+
+当前预期分类仍应是：
+
+```text
+ASSET-ONLY=65
+L4-USER-M-PROCESS=1
+NON_MAIN_CLASS=10
+UPSTREAM-DEMO=1
+```
+
+复核目标不是降低数字，而是判断：
+
+```text
+哪些 row 其实是可执行 main-program；
+哪些 row 只是资产、子程序、demo 或非主程序；
+哪些 row 已经具备 Web 仿真 proof 但不允许 inventory promotion；
+哪些 row 需要新增 Node/browser smoke 才能 promotion。
+```
+
+3. 对 `remaining-skip-main-program-promotion-audit.tsv` 做逐 row 判断。
+
+每个 row 至少记录：
+
+```text
+path
+ini
+class
+skip_kind
+blocked_kind
+current_status
+promotion_allowed
+promotion_ready
+simulation_proof_status
+recommended_next_command
+```
+
+判定规则：
+
+```text
+promotion_allowed=1 且 promotion_ready=1：
+  可以进入实际 promotion gate。
+
+promotion_allowed=0：
+  只能记录阻塞原因，不能强行 PASS。
+
+class != main：
+  不能作为 main-program promotion 对象。
+
+skip_kind=ASSET-ONLY / NON_MAIN_CLASS / UPSTREAM-DEMO：
+  默认保持 SKIP，除非有新的 LinuxCNC-owned 主程序证据。
+
+skip_kind=L4-USER-M-PROCESS：
+  Web 仿真 proof 已完成，但仍保持 external process execution disabled；
+  不因 Web proof 自动变成 native inventory PASS。
+```
+
+4. 若发现真正可 promotion 的 main-program row，按证据链推进。
+
+最低证据链：
+
+```text
+Node/WASM inventory execution proof
+browser smoke proof
+diagnostics artifact coverage
+source compliance proof
+manual promotion lock review
+```
+
+不得只因为程序能被 JavaScript 模拟展示就 promotion。
+
+四、首轮复核建议
+
+优先检查：
+
+```text
+1. remaining-skip-main-program-promotion-audit.tsv 中 class=main 的 row；
+2. promotion-candidates.tsv 中 candidate_kind=inventory-ready 的 row；
+3. runtime-boundary-promotion-readiness.tsv 中 promotion_ready=1 的 row；
+4. skip-summary.tsv 中 L4-USER-M-PROCESS 是否仍只剩 1；
+5. ASSET-ONLY / NON_MAIN_CLASS / UPSTREAM-DEMO 是否有误分类。
+```
+
+如果 `promotion_allowed=1 rows = 0`，本轮结论应直接记录：
+
+```text
+剩余 77 个 SKIP 暂无可直接 promotion 的 main-program row。
+下一步应继续补 artifact，而不是强行改 PASS。
+```
+
+如果发现 `promotion_allowed=1` 的 row，则下一步应为：
+
+```text
+1. 明确 row path / ini / gcode；
+2. 补 Node inventory proof；
+3. 补 browser smoke proof；
+4. 补 docs/tracker；
+5. 运行 release gate；
+6. 再更新 baseline。
+```
+
+五、推荐验证命令
+
+```bash
+git diff --check
+wasm-port/tests/sdk/node/verify_sdk_surface.sh
+wasm-port/tests/ui/node/verify_real_simulation_programs.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_real_simulation_browser.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+```
+
+必要时再运行：
+
+```bash
+wasm-port/tests/browser/verify_interp_browser.sh
+wasm-port/tests/host/verify_project_release_gate.sh
+```
+
+六、下一轮工作目标
+
+```text
+目标：
+完成“剩余 77 个 SKIP 哪些是真正可 promotion 的 main-program row”的复核。
+
+输出：
+1. 当前 77 SKIP 分类确认；
+2. 可 promotion row 列表；
+3. 不可 promotion row 阻塞原因；
+4. 下一批应实现的 Node/browser smoke；
+5. 是否允许 baseline 从 PASS=82 / SKIP=77 继续变化的明确结论。
+```
+
+七、当前行动建议
+
+```text
+下一轮不要再继续纠缠 L4-USER-M-PROCESS 是否接入 Web 仿真。
+它已经完成当前 Web 仿真接入。
+
+下一轮直接进入：
+remaining-skip-main-program-promotion-audit.tsv 逐 row 复核。
+```

textbak/text35.txt

@@ -0,0 +1,215 @@
+text35.txt
+
+一、接续说明
+
+执行时间：2026-06-20 CST
+
+本文件作为 `text34.txt` 之后的新接续文件，用来明确区分两条并行工作线：
+
+```text
+1. 当前实际进行中的工作：real simulation page handoff smoke 断言收敛；
+2. 已经完成结论但尚未继续推进的工作：剩余 77 个 SKIP 中哪些是真正可 promotion 的 main-program row。
+```
+
+本文件的目标不是重新打开 77 SKIP 结论，而是把“当前在做什么、已经完成什么、后续该接哪条线”写清楚，避免继续混线。
+
+当前继续保持项目边界：
+
+```text
+LinuxCNC remains the only CNC semantic source
+promotionAllowed=false
+baselineChanging=false
+inventoryBaselineUnchanged=true
+inventory baseline=82/82/77/0
+diagnostics artifact schema unchanged
+release artifact schema unchanged
+```
+
+二、我当前实际在做的工作
+
+本轮实际在做的不是 77 SKIP promotion 复核，而是：
+
+```text
+real simulation page handoff browser smoke 断言收敛
+```
+
+范围：
+
+```text
+文件：wasm-port/tests/browser/real_simulation_page_smoke.html
+目标：把 blocked / saved ready / restored ready 三态大 if 中重复的 handoff 兼容入口旧断言，继续迁移到共享 helper；
+不改 runtime surface；
+不改 diagnostics artifact schema；
+不改 release artifact schema；
+不改 inventory baseline=82/82/77/0。
+```
+
+本轮已完成：
+
+```text
+1. 新增 handoff summary / operator snapshot / action plan / compact status / preflight / history 的共享 smoke helper；
+2. 将三态大 if 中对应的 dataset / DOM / status-history 重复断言迁移到 helper；
+3. 补上 restored ready 分支缺失的 actionPlan / compactStatus 读取；
+4. 删除同一批 helper 已覆盖的旧兼容断言，减少测试重复；
+5. 保持 review/statusbar/external shell 相关 getter 行为不变；
+6. 浏览器 smoke 继续通过。
+```
+
+本轮已运行验证：
+
+```text
+git diff --check
+SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_real_simulation_browser.sh
+```
+
+结果：
+
+```text
+browser_real_simulation_page_smoke=ok
+```
+
+三、“剩余 77 个 SKIP promotion 复核”已经完成了哪些工作
+
+这条线并不是未开始，而是已经完成一轮明确结论。对应记录主要在：
+
+```text
+text28.txt
+text31.txt
+text32.txt
+wasm-port/docs/sim-config-coverage-promotion-analysis.md
+wasm-port/docs/sim-configs-coverage-handoff.md
+```
+
+已完成工作：
+
+```text
+1. 重新生成并复核了 sim-config inventory baseline；
+2. 固化了当前 baseline：PASS=82 / SKIP=77 / unexpected_fail=0；
+3. 新增并检查了 remaining-skip-main-program-promotion-audit.tsv；
+4. 把 77 个 SKIP 按 skip_kind 分解清楚；
+5. 确认其中真正 class=main 的 skipped row 只有 2 个；
+6. 确认这 2 个 main-program skipped row 当前都 promotion_allowed=0；
+7. 记录了“不应再试图把剩余 77 个 SKIP 直接改 PASS”的结论。
+```
+
+当前固定 inventory 结果：
+
+```text
+sim_configs_wasm_node_inventory_executed=82
+sim_configs_wasm_node_inventory_passed=82
+sim_configs_wasm_node_inventory_skipped=77
+sim_configs_wasm_node_inventory_unexpected_fail=0
+sim_configs_wasm_node_inventory_skip_ASSET_ONLY=65
+sim_configs_wasm_node_inventory_skip_L4_USER_M_PROCESS=1
+sim_configs_wasm_node_inventory_skip_NON_MAIN_CLASS=10
+sim_configs_wasm_node_inventory_skip_UPSTREAM_DEMO=1
+```
+
+四、77 个 SKIP promotion 复核的最终结论
+
+当前结论已经明确：
+
+```text
+剩余 77 个 SKIP 中，没有真正可直接 promotion 的 skipped main-program row。
+```
+
+原因拆解：
+
+```text
+1. ASSET-ONLY=65
+   - 不是 standalone main-program row；
+   - 不属于 inventory promotion 目标。
+
+2. NON_MAIN_CLASS=10
+   - 不是 standalone main-program row；
+   - 不属于 inventory promotion 目标。
+
+3. L4-USER-M-PROCESS=1
+   - path=axis/vismach/millturn/example.ngc
+   - 属于 main-program row；
+   - Web / virtual HAL 状态 proof 已接入；
+   - 但 external user-M arbitrary process execution 仍 disabled；
+   - promotion_allowed=0。
+
+4. UPSTREAM-DEMO=1
+   - path=axis/vismach/5axis/table-rotary_spindle-rotary-nutating/demos/incremental_repetition_g533.ngc
+   - 属于 main-program row；
+   - upstream demo 本身缺失 motion G-code；
+   - promotion_allowed=0。
+```
+
+因此当时的固定结论是：
+
+```text
+remaining_skipped_main_program_rows=2
+remaining_skipped_main_program_promotion_allowed=0
+direct_inventory_promotion_rows=0
+baseline_change_allowed=no
+```
+
+五、这条 77 SKIP 线还没完成什么
+
+如果按“是否找到可 promotion row”来衡量，这条线已经完成结论；
+如果按“是否让 baseline 继续变化”来衡量，这条线没有继续推进，原因是当前结论本来就是：
+
+```text
+不允许继续从剩余 77 个 SKIP 中直接提升 PASS。
+```
+
+也就是说，未完成的不是“还没审完”，而是以下这些后续动作尚未展开：
+
+```text
+1. 没有新的 skipped main-program row 被解锁为 promotion_allowed=1；
+2. 没有新的 inventory PASS baseline 变化；
+3. 没有继续解决 L4-USER-M-PROCESS native runtime probe 成为 promotion proof；
+4. 没有把后续工作转回“已 PASS row 的 browser diagnostics / release evidence 扩展”主线。
+```
+
+六、后续工作建议
+
+后续工作应分两条，不要再混在一句“继续推进”里：
+
+第一条，收尾当前 smoke 收敛：
+
+```text
+1. 继续把 real_simulation_page_smoke.html 中剩余的 review/statusbar/external-shell 兼容对象字段重复断言收平；
+2. 保持 blocked / saved ready / restored ready 三态覆盖；
+3. 不新增 runtime getter / dataset / DOM selector；
+4. 继续以 browser_real_simulation_page_smoke=ok 为完成标准。
+```
+
+第二条，若切回 77 SKIP / promotion 主线，不要重做旧结论，而是直接转向下面两类工作：
+
+```text
+1. 若继续攻 L4-USER-M-PROCESS：
+   - 只聚焦 native runtime opt-in probe；
+   - 目标是 runtime_state_probe_passed；
+   - 只有 probe 真正通过后，才重开 inventory promotion 讨论。
+
+2. 若继续按当前主线推进：
+   - 不再尝试 promotion 剩余 77 个 SKIP；
+   - 直接扩展已 PASS row 的 browser diagnostics / release evidence；
+   - 优先沿现有 five-axis TRT / vismach evidence expansion 路线继续做。
+```
+
+七、建议下一轮入口
+
+推荐下一轮优先级：
+
+```text
+优先级 1：完成当前 real simulation page handoff smoke 收敛收尾；
+优先级 2：如果要回到 promotion 主线，先选“继续 L4-USER-M-PROCESS probe”或“继续已 PASS row evidence expansion”二选一；
+优先级 3：不要重新做“77 个 SKIP 哪些可 promotion”的总复核，因为这一步已经有明确结论。
+```
+
+推荐验证命令：
+
+```bash
+git diff --check
+SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_real_simulation_browser.sh
+
+# 如果切回 promotion / inventory 主线，再补：
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/tests/docs/node/verify_sim_configs_coverage_docs.sh
+wasm-port/tools/verify_no_standalone_cnc_semantics.sh
+```

textbak/text36.txt

@@ -0,0 +1,254 @@
+text36.txt
+
+一、接续说明
+
+执行时间：2026-06-20 CST
+
+本文件只服务于一个目标：
+
+```text
+快速完成“当前 smoke 收尾”
+```
+
+这里的 smoke 特指：
+
+```text
+wasm-port/tests/browser/real_simulation_page_smoke.html
+```
+
+本文件不讨论 77 SKIP promotion 复核，不讨论 inventory baseline 变化，也不继续新增
+real simulation page runtime surface。目标是尽快把 handoff smoke 收敛工作收口，形成
+稳定、低重复、可继续维护的 browser smoke。
+
+二、当前状态
+
+当前已经完成的收敛：
+
+```text
+1. 已为 handoff summary / operator snapshot / action plan / compact status /
+   preflight / history 提取共享 smoke helper；
+2. 已把 blocked / saved ready / restored ready 三态里一批 dataset / DOM /
+   status-history 重复断言迁移到 helper；
+3. 浏览器 smoke 当前保持通过；
+4. inventory baseline 仍保持 82/82/77/0。
+```
+
+当前仍可能残留的问题，不是行为错误，而是测试结构层面的尾项：
+
+```text
+1. review/statusbar/external-shell 同一批 surface 仍可能存在对象字段重复断言；
+2. 个别断言仍混合“主入口契约检查”和“兼容入口镜像检查”；
+3. 三态大 if 仍偏长，后续维护成本高；
+4. helper 与大 if 的边界尚未完全固化。
+```
+
+三、收尾目标
+
+本轮 smoke 收尾的完成标准：
+
+```text
+1. blocked / saved ready / restored ready 三态继续完整覆盖；
+2. handoff summary / operator / preflight / history 这批兼容入口不再在三态大 if 中重复散落；
+3. review/statusbar/external-shell 同一批 surface 的重复断言尽量收口到 helper；
+4. 不新增 getter / dataset / DOM selector；
+5. 不改 runtime surface；
+6. browser_real_simulation_page_smoke=ok。
+```
+
+不在本轮范围内的工作：
+
+```text
+1. 不新增任何新的 external-shell bundle / badge / receipt / verification surface；
+2. 不修改 wasm-port/runtime/ui/simulation/index.html 的行为；
+3. 不改 diagnostics artifact schema；
+4. 不改 release artifact schema；
+5. 不触碰 77 SKIP promotion 主线。
+```
+
+四、建议执行顺序
+
+第一阶段：列出剩余重复断言
+
+目标：
+
+```text
+把 real_simulation_page_smoke.html 中仍残留在三态大 if 里的 handoff 相关断言，按主题归类。
+```
+
+建议操作：
+
+```text
+1. 只看 blocked / saved ready / restored ready 三段；
+2. 标记仍属于以下主题的断言：
+   - review packet / copy-export / verification / badge
+   - statusbar snapshot / receipt / receipt verification / receipt badge
+   - external shell badge snapshot / copy-export
+   - external shell bundle / receipt / receipt verification / audit bundle
+3. 判断每类断言里哪些是：
+   - 主对象字段契约检查
+   - dataset / DOM 兼容镜像检查
+4. 只迁移兼容镜像检查，不迁移真正承担对象契约的字段检查。
+```
+
+退出条件：
+
+```text
+形成“剩余重复断言清单”，并明确哪些适合继续进 helper，哪些必须保留在大 if。
+```
+
+第二阶段：继续提取 helper
+
+目标：
+
+```text
+把第一阶段识别出的兼容镜像断言继续迁移到共享 helper。
+```
+
+建议操作：
+
+```text
+1. 优先复用已有 assertLegacyHandoff* helper 风格；
+2. 新 helper 只做以下事情：
+   - dataset 值一致性；
+   - DOM 文本一致性；
+   - statusbar / diagnostics / document.body.dataset 镜像一致性；
+3. helper 入参使用 phase / action / preflight / digest / expectedText 这类已稳定字段；
+4. 不在 helper 中重新实现复杂业务拼接逻辑，尽量使用调用方已构造好的 expected text。
+```
+
+helper 命名建议：
+
+```text
+若继续扩展 legacy helper，优先保持：
+- assertLegacyHandoffReviewStatusbarDom(...)
+- assertLegacyHandoffReviewStatusbarDataset(...)
+
+若必须新增 helper，命名应保持主题聚合，避免再出现更细碎的 micro-helper。
+```
+
+退出条件：
+
+```text
+新增 helper 后，三态大 if 中同类 dataset / DOM 重复断言明显减少。
+```
+
+第三阶段：清理三态大 if
+
+目标：
+
+```text
+删除已被 helper 完整覆盖的旧断言，保留真正需要的对象契约检查。
+```
+
+删除原则：
+
+```text
+1. helper 已检查的数据，不再在大 if 中重复检查第二次；
+2. 主对象字段、API 名、phase / ready / digest / rows 长度这类核心契约，仍可保留；
+3. 不为了“更短”而把关键对象字段契约也删掉；
+4. 不删除三态覆盖；
+5. 不删除公开 surface 的存在性检查。
+```
+
+建议保留的大 if 检查类型：
+
+```text
+1. apiName / phase / ready / baseline / digest 等对象自身契约；
+2. rows.length / every(row.ready===true) 这类结构契约；
+3. JSON.parse(packetJson) 后的关键字段；
+4. 与 helper 不同层级的对象内容一致性。
+```
+
+退出条件：
+
+```text
+三态大 if 剩余内容主要是对象契约，而不是兼容入口镜像重复检查。
+```
+
+第四阶段：统一 helper 边界
+
+目标：
+
+```text
+让后续维护者一眼能看出：哪些断言该放 helper，哪些该留在大 if。
+```
+
+建议操作：
+
+```text
+1. helper 内只处理“同一组 surface 的镜像一致性”；
+2. 大 if 只处理“该阶段对象契约是否成立”；
+3. 若 helper 和大 if 都检查同一值，优先保留 helper，删除重复镜像检查；
+4. 若某值同时承载业务契约和镜像一致性，则在大 if 留对象字段，在 helper 留 DOM/dataset。
+```
+
+退出条件：
+
+```text
+文件结构形成稳定分层：
+helper = 兼容镜像一致性
+大 if = 阶段对象契约
+```
+
+五、建议具体检查清单
+
+下一轮可直接按下面 checklist 执行：
+
+```text
+[ ] 1. 扫描 blocked / saved / restored 三段剩余 handoff 断言；
+[ ] 2. 标记 review/statusbar/external-shell 中仍重复的 dataset / DOM 检查；
+[ ] 3. 判断哪些是对象契约，哪些只是兼容镜像；
+[ ] 4. 继续扩展现有 legacy helper，避免新增碎片 helper；
+[ ] 5. 删除 helper 已覆盖的旧断言；
+[ ] 6. 检查三态是否仍完整覆盖；
+[ ] 7. 运行 git diff --check；
+[ ] 8. 运行 browser real simulation smoke；
+[ ] 9. 若 helper 边界稳定，补写下一份接续记录并宣布 smoke 收尾完成。
+```
+
+六、退出标准
+
+本轮 smoke 收尾可宣布完成的标准：
+
+```text
+1. real_simulation_page_smoke.html 中 handoff 相关 helper 边界稳定；
+2. 三态大 if 不再承载大量兼容入口重复镜像断言；
+3. review/statusbar/external-shell 同一批 surface 的重复检查已基本收平；
+4. browser_real_simulation_page_smoke=ok；
+5. 没有新增 runtime surface；
+6. inventory baseline 仍保持 82/82/77/0。
+```
+
+如果满足以上条件，下一轮就不应继续在这一批 smoke 上做小修小补，而应：
+
+```text
+1. 正式结束“当前 smoke 收尾”阶段；
+2. 选择返回 promotion / inventory 主线，或继续已 PASS row 的 evidence expansion 主线。
+```
+
+七、建议验证命令
+
+最低验证：
+
+```bash
+git diff --check
+SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_real_simulation_browser.sh
+```
+
+如果下一轮顺手碰到 inventory / docs / artifact 路径，再补：
+
+```bash
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/tests/docs/node/verify_sim_configs_coverage_docs.sh
+wasm-port/tools/verify_no_standalone_cnc_semantics.sh
+```
+
+八、注意事项
+
+```text
+1. 不要为了“测试更短”而删除对象契约检查；
+2. 不要继续叠加新的 external-shell micro-surface；
+3. 不要把 runtime 业务逻辑搬进 smoke helper；
+4. 不要重新打开 77 SKIP promotion 总复核；
+5. 这轮只做 smoke 收尾，不做主线切换。
+```

textbak/text37.txt

@@ -0,0 +1,247 @@
+text37.txt
+
+一、接续说明
+
+执行时间：2026-06-20 CST
+
+本文件对应 `text36.txt` 的第一阶段执行结果：
+
+```text
+把 real_simulation_page_smoke.html 中剩余重复断言先扫出来，形成清单；
+本轮不继续抽 helper，不改 runtime，不改 smoke 逻辑。
+```
+
+扫描范围：
+
+```text
+wasm-port/tests/browser/real_simulation_page_smoke.html
+只看 blocked / saved ready / restored ready 三段 handoff 相关断言
+```
+
+二、扫描结论总览
+
+当前 `summary / operator snapshot / action plan / compact status / preflight / history`
+这一批兼容入口，已经基本完成从三态大 if 向 helper 的迁移。
+
+剩余的重复断言主要集中在另一批主题：
+
+```text
+review/statusbar/external-shell
+```
+
+更具体地说，当前还残留在三态大 if 中、且具有明显重复结构的内容，主要是：
+
+```text
+1. handoff review note / review packet / review packet copy-export / review packet verification / review packet badge；
+2. handoff statusbar snapshot / statusbar receipt / statusbar receipt verification / statusbar receipt badge；
+3. handoff external shell badge snapshot / badge copy-export；
+4. 上述对象对应的一批 document.body.dataset 兼容镜像检查。
+```
+
+三、按主题的剩余重复断言清单
+
+1. review packet 组
+
+当前仍重复出现在 blocked / saved ready / restored ready 三态中的对象字段检查：
+
+```text
+- ReviewNote:
+  phase / action / preflight / latestHistory / noteText
+
+- ReviewPacket:
+  phase / action / preflight / latestHistory /
+  packet.reviewNote / packet.preflight / packetJson parse 后关键字段 /
+  digest 正则
+
+- ReviewPacketCopyExport:
+  phase / ready / action / preflight / digest /
+  packetJson / reviewNote / copyText / exportText / summaryText
+
+- ReviewPacketVerification:
+  phase / ready / statusText /
+  digestMatches / jsonParseReady / reviewNoteMatches / preflightMatches /
+  digest / preflight / reviewNote / packetJson / rows.length / rows.every(ready) /
+  summaryText
+
+- ReviewPacketVerificationBadge:
+  phase / statusText / ready / readyCount / totalCount /
+  badgeState / badgeText / statusbarBadgeText / statusbarBadgeState / digest
+```
+
+判定：
+
+```text
+这组里有两类内容混在一起：
+1. 对象契约：应保留一部分在大 if；
+2. dataset / DOM 镜像：适合继续抽 helper。
+```
+
+建议下一轮优先处理：
+
+```text
+先抽 review packet 组的 dataset / DOM 镜像一致性；
+对象自身字段契约暂时保留在大 if。
+```
+
+2. statusbar 组
+
+当前仍重复出现在三态中的对象字段检查：
+
+```text
+- StatusbarSnapshot:
+  phase / action / preflight / packetBadgeText / packetBadgeState /
+  digest / baseline / ready / summaryText
+
+- StatusbarReceipt:
+  phase / action / preflight / badge / packetBadgeState /
+  digest / baseline / ready / receiptText / copyText / summaryText
+
+- StatusbarReceiptVerification:
+  phase / ready / statusText /
+  receiptMatches / digestMatches / badgeMatches /
+  summaryText / receiptText / digest / badge / baseline
+
+- StatusbarReceiptBadge:
+  phase / statusText / ready / readyCount / totalCount /
+  receiptBadgeState / receiptBadgeText /
+  statusbarReceiptBadgeText / statusbarReceiptBadgeState / digest
+```
+
+同时仍残留的一批 dataset 兼容镜像检查：
+
+```text
+document.body.dataset.evidenceSessionHandoffStatusbarReceipt*
+document.body.dataset.evidenceSessionHandoffStatusbarReceiptVerification*
+document.body.dataset.evidenceSessionHandoffStatusbarReceiptBadge*
+```
+
+判定：
+
+```text
+这组重复程度很高，且 blocked / saved ready / restored ready 结构高度对称；
+很适合继续抽成共享 helper。
+```
+
+建议下一轮优先级：
+
+```text
+高优先级
+```
+
+3. external shell badge 组
+
+当前仍重复出现在三态中的对象字段检查：
+
+```text
+- ExternalShellBadgeSnapshot:
+  phase / action / preflight / packetBadgeText / receiptBadgeText /
+  baseline / digest / ready / shellBadgeState / shellBadgeText /
+  statusbarShellBadgeText
+
+- ExternalShellBadgeCopyExport:
+  phase / action / preflight / ready /
+  shellBadgeState / shellBadgeText / copyText / exportText / summaryText / digest
+```
+
+同时仍残留的一批 dataset 兼容镜像检查：
+
+```text
+document.body.dataset.evidenceSessionHandoffExternalShellBadgeSnapshot*
+```
+
+判定：
+
+```text
+这组与 statusbar 组一样，结构很规整，blocked / ready 两态几乎只变 phase / text；
+适合继续抽 helper。
+```
+
+建议下一轮优先级：
+
+```text
+高优先级
+```
+
+4. external shell bundle / receipt audit bundle 组
+
+当前状态：
+
+```text
+这组大部分 dataset / DOM 镜像检查已经由现有 assertExternalShell* helper 覆盖；
+在三态大 if 中剩余的更多是对象字段契约检查，而不是重复的镜像检查。
+```
+
+判定：
+
+```text
+短期内不应优先再抽；
+除非发现新的大块 dataset / DOM 镜像重复，否则这组先保持现状。
+```
+
+建议下一轮优先级：
+
+```text
+低优先级
+```
+
+四、按类型划分：哪些更像“对象契约”，哪些更像“兼容镜像”
+
+建议继续保留在三态大 if 中的检查：
+
+```text
+1. apiName
+2. phase / ready / statusText / baseline / digest
+3. rows.length / rows.every(ready)
+4. JSON.parse(packetJson) 后的关键字段
+5. packet / snapshot / receipt / bundle 等对象内部结构是否成立
+```
+
+建议继续迁移到 helper 的检查：
+
+```text
+1. document.body.dataset.* 镜像值；
+2. diagnostics panel 文本镜像；
+3. statusbar 文本镜像；
+4. 只读 DOM value 节点文本镜像；
+5. phase/action/preflight/digest 派生出的短文本镜像。
+```
+
+五、第一阶段产出结论
+
+本轮扫描后的结论是：
+
+```text
+1. summary / operator / preflight / history 这条线已经基本收平；
+2. 剩余真正需要继续收尾的重点，是 review/statusbar/external-shell badge 这组；
+3. 下一轮最值得继续抽 helper 的，是：
+   - review packet 组的 dataset / DOM 镜像；
+   - statusbar 组的 dataset / DOM 镜像；
+   - external shell badge snapshot / copy-export 的 dataset / DOM 镜像；
+4. receipt audit bundle 这组暂时不是主要尾项；
+5. 下一轮不应重新扫描全文件，而应直接按上面三组进入第二阶段 helper 提取。
+```
+
+六、建议下一轮入口
+
+推荐下一轮直接执行 `text36.txt` 第二阶段，但按下面优先级推进：
+
+```text
+优先级 1：statusbar 组
+优先级 2：external shell badge 组
+优先级 3：review packet 组
+优先级 4：最后再看是否还需要补 external shell bundle / audit bundle
+```
+
+建议下一轮的最小目标：
+
+```text
+至少把 statusbar + external shell badge 这一批 dataset / DOM 重复断言继续抽走；
+完成后重新运行 browser_real_simulation_page_smoke。
+```
+
+七、建议验证命令
+
+```bash
+git diff --check
+SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_real_simulation_browser.sh
+```

textbak/text38.txt

@@ -0,0 +1,379 @@
+text38.txt
+
+一、接续说明
+
+执行时间：2026-06-20 CST
+
+本文件专门关闭下面这个问题：
+
+```text
+剩余 77 个 SKIP 中哪些是真正可 promotion 的 main-program row？
+```
+
+结论不是“还要继续逐条找”，而是：
+
+```text
+当前没有可直接 promotion 的 skipped main-program row。
+baseline 不能继续因为这 77 个 SKIP 而变化。
+```
+
+本文件的作用是把该结论整理成可执行、可复查、可防回归的方法，供后续接续时直接引用，
+避免下一轮再次重复总复核。
+
+二、已确认事实
+
+当前 inventory baseline 已重新生成并复核：
+
+```text
+sim_configs_wasm_node_inventory_executed=82
+sim_configs_wasm_node_inventory_passed=82
+sim_configs_wasm_node_inventory_skipped=77
+sim_configs_wasm_node_inventory_unexpected_fail=0
+```
+
+77 个 SKIP 的构成已经固定为：
+
+```text
+ASSET-ONLY=65
+L4-USER-M-PROCESS=1
+NON_MAIN_CLASS=10
+UPSTREAM-DEMO=1
+```
+
+其中真正 `class=main` 的 skipped row 只有 2 个：
+
+```text
+axis/vismach/millturn/example.ngc
+axis/vismach/5axis/table-rotary_spindle-rotary-nutating/demos/incremental_repetition_g533.ngc
+```
+
+这 2 个 row 当前均为：
+
+```text
+promotion_allowed=0
+promotion_ready=0
+```
+
+因此最终判定：
+
+```text
+remaining_skip_count=77
+remaining_skipped_main_program_rows=2
+remaining_skipped_main_program_promotion_allowed=0
+direct_inventory_promotion_rows=0
+baseline_change_allowed=no
+```
+
+三、问题关闭判定
+
+该问题已经完全解决，理由如下：
+
+```text
+1. 审计对象已经限定：
+   只检查 current_status=SKIP 且 class=main 的 row。
+
+2. 审计数据已经落盘：
+   remaining-skip-main-program-promotion-audit.tsv 已生成并被 docs smoke 检查。
+
+3. 审计结果已经闭环：
+   当前只有 2 个 skipped main-program row，且 promotion_allowed 全部为 0。
+
+4. 非 main-program SKIP 已排除：
+   ASSET-ONLY=65 和 NON_MAIN_CLASS=10 不能伪装成 standalone main-program PASS。
+
+5. blocked runtime / invalid upstream demo 已排除：
+   L4-USER-M-PROCESS 缺 promotion proof；
+   UPSTREAM-DEMO 缺有效 motion G-code；
+   两者都不能直接 promotion。
+```
+
+所以后续不应再把“复核 77 个 SKIP 哪些可 promotion”当作开放任务。
+
+四、逐类处理方法
+
+1. ASSET-ONLY=65
+
+处理规则：
+
+```text
+不 promotion。
+不计入 standalone main-program promotion 候选。
+不为了降低 SKIP 数量改成 PASS。
+```
+
+原因：
+
+```text
+这些 row 是 source asset / dependency / support file，不是可独立运行的 main-program。
+即使它们对某个 PASS row 有贡献，也只能作为 source coverage 或 evidence dependency，
+不能独立改变 inventory PASS baseline。
+```
+
+允许后续动作：
+
+```text
+1. 作为已 PASS row 的 evidence dependency 引用；
+2. 在 diagnostics/release artifact 中展示 source coverage；
+3. 不改变 current_status=SKIP 的 inventory 语义。
+```
+
+2. NON_MAIN_CLASS=10
+
+处理规则：
+
+```text
+不 promotion。
+不重分类为 main，除非 LinuxCNC source / inventory classifier 明确变化。
+不作为 baseline promotion 候选。
+```
+
+原因：
+
+```text
+这些 row 不是 standalone main-program class。
+promotion 的目标是可作为主程序执行并被 Node/WASM/browser proof 覆盖的 row。
+```
+
+允许后续动作：
+
+```text
+1. 保持分类；
+2. 如果 classifier 规则改变，先重跑 inventory 并检查 drift；
+3. 只有 class 真实变为 main 后，才进入 skipped main-program audit。
+```
+
+3. L4-USER-M-PROCESS=1
+
+对应 row：
+
+```text
+axis/vismach/millturn/example.ngc
+```
+
+当前状态：
+
+```text
+class=main
+skip_kind=L4-USER-M-PROCESS
+native_status=PASS
+simulation_proof_status=ready_disabled_by_default:native=0:node=0:browser=0
+promotion_allowed=0
+```
+
+处理规则：
+
+```text
+当前不 promotion。
+Web/virtual HAL 状态 proof 只能证明页面和虚拟 HAL 仿真链路可展示相关状态，
+不能替代 external user-M arbitrary process execution 的 runtime promotion proof。
+```
+
+要让它未来可重新进入 promotion 讨论，必须先满足：
+
+```text
+1. native opt-in runtime probe 真正通过；
+2. millturn_user_m_runtime_probe_status=runtime_state_probe_passed；
+3. execution gate 有明确 artifact 证明；
+4. Node inventory promotion gate 重新计算后给出 promotion_allowed=1；
+5. browser/host proof 补齐；
+6. manual promotion lock review 明确放行。
+```
+
+在这些条件满足前，禁止动作：
+
+```text
+1. 禁止仅凭 virtual HAL proof 改 PASS；
+2. 禁止仅凭 native_status=PASS 改 PASS；
+3. 禁止手写 promotion_allowed=1；
+4. 禁止把 baseline 从 82/82/77/0 往前推。
+```
+
+4. UPSTREAM-DEMO=1
+
+对应 row：
+
+```text
+axis/vismach/5axis/table-rotary_spindle-rotary-nutating/demos/incremental_repetition_g533.ngc
+```
+
+当前状态：
+
+```text
+class=main
+skip_kind=UPSTREAM-DEMO
+native_status=FAIL
+native_expected_failure=upstream-demo-missing-motion-gcode
+promotion_allowed=0
+```
+
+处理规则：
+
+```text
+当前不 promotion。
+不能为了 baseline 变化修补或替换 LinuxCNC upstream demo 的语义。
+```
+
+允许后续动作：
+
+```text
+1. 保留为 upstream invalid/demo edge；
+2. 在 docs 中说明它不是可执行 motion main-program；
+3. 如果 upstream source 将来修复，先更新 vendor source，再重跑 inventory；
+4. 只有 native/WASM/browser proof 全部重算后，才允许重新评估。
+```
+
+五、以后如何复查而不重做总复核
+
+后续如果有人再次问“77 个 SKIP 中还有没有可 promotion main-program row”，
+不要重新从 77 行人工审起，按下面方法复查即可。
+
+第一步：重新生成 inventory artifact
+
+```bash
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+```
+
+第二步：只看两个关键 artifact
+
+```text
+wasm-port/build/wasm/sim-configs-inventory/skip-summary.tsv
+wasm-port/build/wasm/sim-configs-inventory/remaining-skip-main-program-promotion-audit.tsv
+```
+
+第三步：确认 skip summary 是否仍为当前结构
+
+期望：
+
+```text
+ASSET-ONLY=65
+L4-USER-M-PROCESS=1
+NON_MAIN_CLASS=10
+UPSTREAM-DEMO=1
+```
+
+如果一致，则不重开问题。
+
+第四步：确认 audit 行数和 promotion_allowed
+
+期望：
+
+```text
+remaining-skip-main-program-promotion-audit.tsv 只有 2 行；
+两行 class=main；
+两行 promotion_allowed=0；
+两行 promotion_ready=0；
+路径分别是：
+axis/vismach/millturn/example.ngc
+axis/vismach/5axis/table-rotary_spindle-rotary-nutating/demos/incremental_repetition_g533.ngc
+```
+
+如果一致，则结论仍是：
+
+```text
+direct_inventory_promotion_rows=0
+baseline_change_allowed=no
+```
+
+六、允许重开问题的唯一条件
+
+只有出现以下任一 drift，才允许重开“剩余 SKIP promotion”问题：
+
+```text
+1. remaining-skip-main-program-promotion-audit.tsv 行数不再是 2；
+2. audit 中出现新的 class=main skipped row；
+3. 任一 audit row 的 promotion_allowed 变为 1；
+4. 任一 audit row 的 promotion_ready 变为 1；
+5. skip-summary.tsv 的四类计数发生变化；
+6. L4-USER-M-PROCESS native opt-in runtime probe 变为 runtime_state_probe_passed；
+7. UPSTREAM-DEMO row 的 native_expected_failure 不再是 upstream-demo-missing-motion-gcode；
+8. inventory classifier 明确改变了 ASSET-ONLY 或 NON_MAIN_CLASS 的 class 语义。
+```
+
+如果没有这些 drift，禁止重新打开总复核。
+
+七、推荐验证命令
+
+关闭该问题时的最小验证：
+
+```bash
+git diff --check
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/tests/docs/node/verify_sim_configs_coverage_docs.sh
+```
+
+如果后续涉及 release / browser evidence，还应追加：
+
+```bash
+wasm-port/tests/sdk/node/verify_sdk_surface.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_real_simulation_browser.sh
+wasm-port/tools/verify_no_standalone_cnc_semantics.sh
+```
+
+如果后续专门尝试 L4-USER-M-PROCESS promotion proof，还应追加：
+
+```bash
+bash wasm-port/tests/native/probe_millturn_user_m_runtime.sh
+wasm-port/tests/native/verify_native_probes.sh
+```
+
+但这些 native probe 只有在明确选择 L4-USER-M-PROCESS runtime 主线时才需要跑，
+不作为当前 77 SKIP 问题关闭的必要条件。
+
+八、后续工作分流
+
+该问题关闭后，后续只能走两条线之一。
+
+第一条：继续当前 smoke 收尾
+
+```text
+目标：
+继续收敛 real_simulation_page_smoke.html 中 review/statusbar/external-shell
+相关重复断言。
+
+边界：
+不改 inventory baseline；
+不改 diagnostics artifact schema；
+不改 release artifact schema；
+不重开 77 SKIP 总复核。
+```
+
+第二条：切回 promotion 主线
+
+promotion 主线不能从“77 个 SKIP 里继续找”开始，而应二选一：
+
+```text
+1. L4-USER-M-PROCESS runtime proof：
+   先解决 native opt-in runtime probe；
+   目标是 runtime_state_probe_passed；
+   通过后再进入 inventory promotion gate。
+
+2. 已 PASS row evidence expansion：
+   继续扩展 browser diagnostics / release evidence；
+   优先选择 current_status=PASS 且已有 matrix/browser REP 基础的 row；
+   不改变 inventory baseline=82/82/77/0。
+```
+
+九、最终接续结论
+
+本问题的最终处理口径：
+
+```text
+不要继续尝试把剩余 77 个 SKIP 直接改 PASS。
+当前没有可直接 promotion 的 skipped main-program row。
+baseline 保持 82/82/77/0。
+后续只有 audit drift 或 runtime proof drift 出现时，才允许重开 promotion 评估。
+```
+
+下一轮如果继续做当前实际工作，优先接：
+
+```text
+text37.txt 中列出的 real_simulation_page_smoke.html
+review/statusbar/external-shell badge 重复断言收尾。
+```
+
+下一轮如果切回 promotion，优先接：
+
+```text
+L4-USER-M-PROCESS native opt-in runtime probe，
+而不是重新复核 77 个 SKIP。
+```

textbak/text39.txt

@@ -0,0 +1,244 @@
+text39.txt
+
+一、接续说明
+
+执行时间：2026-06-21 CST
+
+本文件接续 `wasm-port/docs/porting-steps-standalone.md` 中 Phase 9 / Phase 10
+关于 kinematics 的要求，关闭下面这个状态问题：
+
+```text
+是否已经导出独立 kinematics ABI？
+LinuxCNC 的所有逆解相关算法是否已经完整移植到 WASM？
+```
+
+二、准确结论
+
+当前结论必须分两层写：
+
+```text
+1. 独立 LinuxCNC TRT kinematics WASM ABI 已完成第一批接入。
+2. LinuxCNC 所有 kinematics / 逆解模块尚未全部移植为 WASM ABI。
+```
+
+因此，之前的准确状态从：
+
+```text
+LinuxCNC kinematics WASM ABI 未完成
+```
+
+更新为：
+
+```text
+LinuxCNC TRT kinematics WASM ABI 已完成第一批；
+全量 LinuxCNC kinematics WASM ABI 仍未完成。
+```
+
+三、本批完成内容
+
+新增独立 kinematics WASM C ABI：
+
+```text
+wasm-port/runtime/core/linuxcnc_wrap/linuxcnc_kinematics_wasm.c
+```
+
+导出 ABI：
+
+```text
+lckins_init
+lckins_exit
+lckins_type
+lckins_switchable
+lckins_switch
+lckins_forward
+lckins_inverse
+lckins_run_probe
+lckins_free_string
+```
+
+新增独立构建脚本：
+
+```text
+wasm-port/tools/build_kinematics_wasm.sh
+```
+
+当前生成的 WASM 产物：
+
+```text
+wasm-port/build/wasm/kinematics/linuxcnc_xyzac_trt_kinematics.js
+wasm-port/build/wasm/kinematics/linuxcnc_xyzac_trt_kinematics.wasm
+wasm-port/build/wasm/kinematics/linuxcnc_xyzbc_trt_kinematics.js
+wasm-port/build/wasm/kinematics/linuxcnc_xyzbc_trt_kinematics.wasm
+```
+
+当前每个模块使用的 vendored LinuxCNC source：
+
+```text
+src/emc/kinematics/kins_util.c
+src/emc/kinematics/switchkins.c
+src/emc/kinematics/userkfuncs.c
+src/emc/kinematics/trtfuncs.c
+src/emc/kinematics/xyzac-trt-kins.c
+src/emc/kinematics/xyzbc-trt-kins.c
+```
+
+说明：
+
+```text
+每个 kinematics WASM module 都是独立模块。
+没有把多个 LinuxCNC kinematics 模块强行塞进同一个同名符号空间。
+没有在 JavaScript 中实现 forward/inverse 算法。
+```
+
+四、SDK 接入
+
+新增 SDK wrapper：
+
+```text
+wasm-port/runtime/sdk/src/linuxcnc-kinematics.js
+```
+
+新增统一导出：
+
+```text
+createLinuxCncKinematicsSdk
+supportedLinuxCncKinematicsModules
+linuxCncKinematicsWasmFile
+```
+
+相关文件：
+
+```text
+wasm-port/runtime/sdk/src/index.js
+wasm-port/runtime/sdk/README.md
+```
+
+当前 SDK 支持 moduleId：
+
+```text
+xyzac-trt
+xyzbc-trt
+```
+
+五、验证
+
+新增 Node/WASM smoke：
+
+```text
+wasm-port/tests/wasm/node/verify_kinematics_wasm.sh
+wasm-port/tests/wasm/node/verify_kinematics_wasm.mjs
+```
+
+通过命令：
+
+```bash
+EMSDK_QUIET=1 source /home/cnc/emsdk/emsdk_env.sh >/dev/null && wasm-port/tests/wasm/node/verify_kinematics_wasm.sh
+```
+
+通过输出：
+
+```text
+kinematics_wasm_node_smoke=ok
+```
+
+验证覆盖：
+
+```text
+1. xyzac-trt 独立 WASM module 可加载；
+2. xyzbc-trt 独立 WASM module 可加载；
+3. lckins_inverse 导出存在；
+4. kinematicsType() == KINEMATICS_BOTH；
+5. kinematicsSwitchable() == 1；
+6. forward -> inverse roundtrip joints 成立；
+7. switchkins identity path 可切换并 forward 成立；
+8. SDK 只做 ABI/memory wrapper，不做 kinematics 数学。
+```
+
+六、关键实现注意事项
+
+1. `hal.h` 已补 C ABI 边界：
+
+```text
+RTAPI_BEGIN_DECLS / RTAPI_END_DECLS
+```
+
+原因：
+
+```text
+LinuxCNC kinematics C 源以 C 符号调用 hal_*；
+HAL shim 实现位于 C++ 文件 linuxcnc_hal_adapter.cpp；
+必须让 HAL shim 对 C/C++ 调用者都呈现一致 C ABI。
+```
+
+2. kinematics wrapper 使用 C 文件而不是 C++ 文件：
+
+```text
+linuxcnc_kinematics_wasm.c
+```
+
+原因：
+
+```text
+LinuxCNC kinematics.h 间接包含 posemath C++ overload 声明；
+强制 extern "C" 包裹整个头会破坏 C++ overload；
+而把 kinematics C 源全部按 C++ 编译又会遇到 C 源中的 void* 隐式转换问题。
+当前 C wrapper + C 编译 LinuxCNC kinematics 源是最小稳定边界。
+```
+
+七、仍未完成的部分
+
+不能把本批写成“所有逆解完整移植到 WASM”。
+
+尚未导出独立 WASM ABI 的 native-probe kinematics family 至少包括：
+
+```text
+trivkins
+5axiskins
+corexykins
+rotatekins
+rosekins
+maxkins
+lineardeltakins
+rotarydeltakins
+scorbot-kins
+tripodkins
+scarakins
+pumakins
+genserkins
+genhexkins
+pentakins
+```
+
+这些 native probes 证明原生 extracted-core 覆盖存在，但不等于 WASM ABI 完成。
+
+八、后续建议
+
+下一批如继续 kinematics，应按同一模式推进：
+
+```text
+1. 选一个 native probe 已通过的 kinematics family；
+2. 建独立 WASM module，避免同名 kinematicsForward/Inverse 符号冲突；
+3. 复用 vendored LinuxCNC source + linuxcnc_kinematics_wasm.c wrapper；
+4. 必要时补 posemath/source 依赖；
+5. 增加 Node WASM smoke；
+6. 通过 SDK moduleId 暴露；
+7. 文档只声明该 family 完成，不声明全量完成。
+```
+
+推荐下一批优先级：
+
+```text
+1. 5axiskins
+2. trivkins
+3. corexy / rotate / lineardelta / rotarydelta
+4. posemath-heavy: puma / genser / genhex / pentakins
+```
+
+九、当前状态一句话
+
+```text
+LinuxCNC interpreter WASM ABI 已完成；
+LinuxCNC TRT kinematics WASM ABI 已完成第一批；
+LinuxCNC 全量 kinematics WASM ABI 未完成；
+M4/M5 web app 仍需显式接入新的 kinematics SDK 后才能从 fixture/frame 逻辑升级为 LinuxCNC kinematics WASM 输出。
+```

textbak/text40.txt

@@ -0,0 +1,233 @@
+text40.txt
+
+一、接续说明
+
+执行时间：2026-06-21 CST
+
+本文件接续 `textbak/text39.txt`。`text39.txt` 的结论停留在：
+
+```text
+LinuxCNC TRT kinematics WASM ABI 已完成第一批；
+LinuxCNC 全量 kinematics WASM ABI 仍未完成。
+```
+
+在其后续工作中，kinematics WASM ABI 已继续推进并完成全量可加载
+LinuxCNC kinematics module 覆盖。因此本文件用于纠正旧结论，记录当前
+最终状态和仍然不应误判为缺口的边界。
+
+二、准确结论
+
+当前结论：
+
+```text
+LinuxCNC 可加载 kinematics module 的独立 WASM ABI 已完成。
+LinuxCNC 已 vendored 的所有实际 kinematics forward/inverse 算法均已通过独立 ABI 导出并验证。
+JavaScript/SDK 没有实现 kinematics 数学，只负责加载 WASM、分配内存、传 seed buffer、调用 C ABI。
+```
+
+需要特别说明：
+
+```text
+1. `ugenserkins.c` 不是 loadable kinematics module，而是 upstream 自标注 declining usage 的 userspace test program；其调用的 genserKinematicsForward/Inverse 已由 `genser` WASM module 覆盖。
+2. `lineardeltakins.cc` 和 `rotarydeltakins.cc` 是 Boost.Python wrapper，调用同一 common header 中的 kinematics_forward/kinematics_inverse；实际 LinuxCNC module 算法已由 `lineardelta` / `rotarydelta` WASM module 覆盖。
+3. `cubic.c` 是 kinematics support/interpolation utility，不是独立 kinematicsForward/kinematicsInverse module。
+4. `userkfuncs.c` 是 switchkins 的 user/identity fallback function set，不是单独 loadrt module；它已随 switchkins modules 编译进对应 WASM module。
+```
+
+三、已导出的独立 kinematics WASM modules
+
+当前 SDK 支持并验证的 moduleId：
+
+```text
+trivkins
+5axiskins
+xyzac-trt
+xyzbc-trt
+corexy
+rotate
+rose
+max
+lineardelta
+rotarydelta
+scorbot
+tripod
+scara
+puma
+genser
+genhex
+pentakins
+```
+
+当前生成的 WASM 产物共 17 个：
+
+```text
+wasm-port/build/wasm/kinematics/linuxcnc_trivkins_kinematics.wasm
+wasm-port/build/wasm/kinematics/linuxcnc_5axiskins_kinematics.wasm
+wasm-port/build/wasm/kinematics/linuxcnc_xyzac_trt_kinematics.wasm
+wasm-port/build/wasm/kinematics/linuxcnc_xyzbc_trt_kinematics.wasm
+wasm-port/build/wasm/kinematics/linuxcnc_corexy_kinematics.wasm
+wasm-port/build/wasm/kinematics/linuxcnc_rotate_kinematics.wasm
+wasm-port/build/wasm/kinematics/linuxcnc_rose_kinematics.wasm
+wasm-port/build/wasm/kinematics/linuxcnc_max_kinematics.wasm
+wasm-port/build/wasm/kinematics/linuxcnc_lineardelta_kinematics.wasm
+wasm-port/build/wasm/kinematics/linuxcnc_rotarydelta_kinematics.wasm
+wasm-port/build/wasm/kinematics/linuxcnc_scorbot_kinematics.wasm
+wasm-port/build/wasm/kinematics/linuxcnc_tripod_kinematics.wasm
+wasm-port/build/wasm/kinematics/linuxcnc_scara_kinematics.wasm
+wasm-port/build/wasm/kinematics/linuxcnc_puma_kinematics.wasm
+wasm-port/build/wasm/kinematics/linuxcnc_genser_kinematics.wasm
+wasm-port/build/wasm/kinematics/linuxcnc_genhex_kinematics.wasm
+wasm-port/build/wasm/kinematics/linuxcnc_pentakins_kinematics.wasm
+```
+
+四、ABI 入口
+
+统一 C ABI wrapper：
+
+```text
+wasm-port/runtime/core/linuxcnc_wrap/linuxcnc_kinematics_wasm.c
+```
+
+导出函数：
+
+```text
+lckins_init
+lckins_exit
+lckins_type
+lckins_switchable
+lckins_switch
+lckins_forward
+lckins_inverse
+lckins_run_probe
+lckins_free_string
+```
+
+关键 ABI 语义：
+
+```text
+1. `lckins_forward()` 使用 `pose_out` 作为 in/out pose buffer。
+   这保留了 LinuxCNC genhex/pentakins 等迭代 forward kinematics 对初始 pose estimate 的要求。
+
+2. `lckins_inverse()` 使用 `joints_out` 作为 in/out joint buffer。
+   这保留了 LinuxCNC genser 等迭代 inverse kinematics 对初始 joint estimate 的要求。
+
+3. `fflags` / `iflags` 通过指针传入传出，保留 tripod/switchkins 等 flag 语义边界。
+```
+
+五、SDK 接入
+
+SDK wrapper：
+
+```text
+wasm-port/runtime/sdk/src/linuxcnc-kinematics.js
+```
+
+统一导出：
+
+```text
+wasm-port/runtime/sdk/src/index.js
+```
+
+SDK API：
+
+```text
+createLinuxCncKinematicsSdk()
+supportedLinuxCncKinematicsModules()
+linuxCncKinematicsWasmFile(moduleId)
+```
+
+运行时方法：
+
+```text
+type()
+switchable()
+switchKinematics(switchkinsType)
+forward(joints, { seedPose })
+inverse(pose, jointCount, { seedJoints })
+runProbe()
+```
+
+六、构建脚本
+
+独立构建入口：
+
+```text
+wasm-port/tools/build_kinematics_wasm.sh
+```
+
+构建策略：
+
+```text
+1. 每个 kinematics family 单独生成一个 Emscripten module，避免 LinuxCNC kinematicsForward/kinematicsInverse 同名符号冲突。
+2. source 复用 vendored LinuxCNC `src/emc/kinematics`。
+3. posemath-heavy modules 额外链接 vendored `src/libnml/posemath`。
+4. genser 直接以 C 编译 vendored `gomath.c`，避免 C++ wrapper name mangling 造成 go_* 链接失败。
+5. switchkins modules 复用 `kins_util.c`、`switchkins.c`、`userkfuncs.c`。
+```
+
+七、验证
+
+Node/WASM 验证入口：
+
+```text
+wasm-port/tests/wasm/node/verify_kinematics_wasm.sh
+wasm-port/tests/wasm/node/verify_kinematics_wasm.mjs
+```
+
+已通过命令：
+
+```bash
+source /home/cnc/emsdk/emsdk_env.sh >/dev/null && bash wasm-port/tools/build_kinematics_wasm.sh && bash wasm-port/tests/wasm/node/verify_kinematics_wasm.sh
+```
+
+通过输出：
+
+```text
+kinematics_wasm_node_smoke=ok
+```
+
+验证覆盖：
+
+```text
+1. 17 个 moduleId 列表与预期完全一致；
+2. 每个 WASM module 可通过 SDK 加载；
+3. 每个 module 导出 lckins_forward / lckins_inverse / lckins_run_probe；
+4. kinematicsType / kinematicsSwitchable 与 LinuxCNC module 预期一致；
+5. trivkins / corexy / rotate / rose / max 等直接 joint roundtrip；
+6. lineardelta / rotarydelta / tripod / pentakins 等 pose -> inverse -> forward roundtrip；
+7. scorbot / puma 使用 LinuxCNC native probe pattern 做 pose roundtrip；
+8. scara / 5axiskins / xyzac-trt / xyzbc-trt / genser 覆盖 switchkins primary 和 identity path；
+9. genhex 覆盖 inverse + iterative-forward warmup path，并验证 alternate switch path 可切换；
+10. genser seedJoints、genhex/pentakins seedPose 语义被显式验证。
+```
+
+八、当前文件状态提醒
+
+当前相关文件中有一部分仍是未跟踪文件，需要后续提交时纳入：
+
+```text
+wasm-port/runtime/core/linuxcnc_wrap/linuxcnc_kinematics_wasm.c
+wasm-port/runtime/sdk/src/linuxcnc-kinematics.js
+wasm-port/tests/wasm/node/verify_kinematics_wasm.mjs
+wasm-port/tools/build_kinematics_wasm.sh
+```
+
+相关已修改文件：
+
+```text
+wasm-port/runtime/core/shims/hal.h
+wasm-port/runtime/sdk/src/index.js
+wasm-port/runtime/sdk/README.md
+wasm-port/docs/porting-steps-standalone.md
+wasm-port/docs/compatibility-validation.md
+```
+
+九、后续建议
+
+就“LinuxCNC 的所有逆解相关算法，导出独立 kinematics ABI”这一项而言：
+
+```text
+无需继续扩展 kinematics module 列表。
+下一步不应再手写或补造 JS kinematics 数学。
+后续重点应转向把 Web/M4/M5 simulation UI 从 fixture/frame 逻辑接入 createLinuxCncKinematicsSdk() 输出，或继续推进 remap/planner/browser 集成验证。
+```

textbak/text41.txt

@@ -0,0 +1,457 @@
+text41.txt
+
+一、接续说明
+
+执行时间：2026-06-21 CST
+
+本文件接续 `textbak/text40.txt` 的“九、后续建议”：
+
+```text
+无需继续扩展 kinematics module 列表。
+下一步不应再手写或补造 JS kinematics 数学。
+后续重点应转向把 Web/M4/M5 simulation UI 从 fixture/frame 逻辑接入 createLinuxCncKinematicsSdk() 输出，或继续推进 remap/planner/browser 集成验证。
+```
+
+本文件只规划下一阶段详细执行步骤，不新增 JS-owned kinematics 数学，不继续扩大
+LinuxCNC kinematics module 列表。
+
+二、当前事实基线
+
+已完成事实：
+
+```text
+1. `wasm-port` 已有 17 个独立 kinematics WASM module。
+2. `createLinuxCncKinematicsSdk()` 已能加载这些 module 并调用 `lckins_*` C ABI。
+3. `tests/wasm/node/verify_kinematics_wasm.sh` 已验证所有 module 的 forward/inverse 或 inverse/forward roundtrip。
+4. `textbak/text40.txt` 已记录可加载 LinuxCNC kinematics module 全量 ABI 完成。
+```
+
+Web/M4/M5 当前状态：
+
+```text
+1. `web-rtcp-5axis-sim-plan/app/src/runtime/rtcp-frame.js`
+   仍由 fixture pose + JS 计算 toolAxisVector/compensation/tcpPose。
+
+2. `web-rtcp-5axis-sim-plan/app/src/state/store.js`
+   RUN/STEP/JOG/HOME 仍推进 fixture axis pose，frame sourceMode 仍是 `fixture-ui-only`。
+
+3. `web-rtcp-5axis-sim-plan/app/src/runtime/linuxcnc-boundary-adapter.js`
+   已有 adapter entrypoint，但 `linuxCncKinematicsReady=false`，没有加载 kinematics WASM。
+
+4. `web-rtcp-5axis-sim-plan/tests/node/verify_rtcp_store.mjs`
+   明确断言 `linuxCncKinematicsReady=false`，并把 fixture frame 作为当前 smoke 目标。
+```
+
+因此下一阶段的目标不是“再实现 kinematics”，而是：
+
+```text
+把 Web/M4/M5 的 frame 来源从 fixture-ui-only 升级为 LinuxCNC kinematics WASM 输出；
+保留 fixture frame 作为 fallback 和 UI smoke，不把 fallback 冒充 LinuxCNC runtime proof。
+```
+
+三、总目标
+
+阶段总目标：
+
+```text
+Web/M4/M5 simulation UI 能通过 createLinuxCncKinematicsSdk() 加载 LinuxCNC kinematics WASM，
+使用 LinuxCNC-owned forward/inverse 结果生成 RTCP/motion frame，
+并在 UI/store/browser smoke 中明确标记 sourceMode=source-derived-kinematics-wasm。
+```
+
+完成后应满足：
+
+```text
+1. fixture frame 仍可运行，但 sourceMode 只能是 `fixture-ui-only`。
+2. LinuxCNC kinematics frame 由 WASM C ABI 输出，不由 JS 复写数学。
+3. M4 profile/boundary adapter 能报告 kinematics runtime ready。
+4. M5 operator workflow 的 RUN/STEP/JOG/HOME 能消费同一 frame contract。
+5. Node smoke 和 browser smoke 都能区分 fixture fallback 与 LinuxCNC kinematics proof。
+```
+
+四、实施阶段规划
+
+## Phase A：固化 kinematics runtime adapter 边界
+
+目标：
+
+```text
+在 Web app 侧新增一个窄 adapter，只负责加载 wasm-port kinematics SDK 并返回 frame 输入。
+```
+
+建议新增文件：
+
+```text
+web-rtcp-5axis-sim-plan/app/src/runtime/linuxcnc-kinematics-runtime.js
+```
+
+职责：
+
+```text
+1. 接收 moduleId，例如 `xyzac-trt`。
+2. 调用 `createLinuxCncKinematicsSdk({ moduleId, moduleOptions })`。
+3. 暴露 `forward(joints, options)` / `inverse(pose, jointCount, options)`。
+4. 暴露 runtime readiness：
+   - apiName
+   - moduleId
+   - wasmFile
+   - supportedModules
+   - loaded
+   - sourceMode=`source-derived-kinematics-wasm`
+5. 不计算任何 kinematics 数学。
+```
+
+关键约束：
+
+```text
+1. 不能把 wasm-port SDK 源码复制到 web app。
+2. 能 import 共享 SDK 时优先 import `wasm-port/runtime/sdk/src/index.js`。
+3. 如果 browser bundling/static-copy 暂时不能直接加载 wasm-port build output，
+   允许先做 Node-side adapter smoke，再规划 browser asset copy。
+4. 不允许在 JS 中重新写 xyzac/xyzbc/trt compensation 公式。
+```
+
+验收：
+
+```text
+新增 Node smoke：加载 `xyzac-trt` kinematics WASM，调用 forward -> inverse，
+确认 moduleId、wasmFile、sourceMode、rc=0。
+```
+
+建议测试文件：
+
+```text
+web-rtcp-5axis-sim-plan/tests/node/verify_linuxcnc_kinematics_runtime.mjs
+```
+
+## Phase B：把 RTCP frame builder 改为双来源
+
+目标：
+
+```text
+`buildRtcpFrame()` 保留 fixture fallback，但新增 LinuxCNC kinematics frame 输入路径。
+```
+
+建议修改文件：
+
+```text
+web-rtcp-5axis-sim-plan/app/src/runtime/rtcp-frame.js
+```
+
+新增或调整 API：
+
+```text
+buildRtcpFrame({
+  axisPose,
+  activeLine,
+  kinsType,
+  rtcpEnabled,
+  sourceMode,
+  profile,
+  linuxCncKinematicsResult,
+})
+```
+
+LinuxCNC frame 输入建议字段：
+
+```text
+linuxCncKinematicsResult = {
+  moduleId: "xyzac-trt",
+  switchkinsType: 0 | 1 | 2,
+  forward: {
+    rc,
+    pose,
+    fflags,
+    iflags,
+  },
+  inverse: {
+    rc,
+    joints,
+    fflags,
+    iflags,
+  },
+}
+```
+
+frame 输出必须新增/修正：
+
+```text
+sourceMode: "source-derived-kinematics-wasm"
+semanticBoundary: "linuxcnc_kinematics_wasm_c_abi"
+readiness.linuxCncKinematicsReady: true
+readiness.promotionAllowed: true only for kinematics-frame proof, not interpreter/remap proof
+kinematicsModuleId
+kinematicsForwardRc
+kinematicsInverseRc
+kinematicsFlags
+```
+
+注意：
+
+```text
+1. `tcpPose` / `jointPose` 应来自 LinuxCNC forward/inverse 输出映射。
+2. 若只拿到 one-way forward 结果，就不要声称 full program execution proof。
+3. fixture fallback 的 semanticBoundary 必须保持 `fixture_frame_ui_plumbing_not_linuxcnc_kinematics_proof`。
+```
+
+验收：
+
+```text
+1. fixture frame smoke 仍通过。
+2. 新增 LinuxCNC kinematics frame smoke：
+   - sourceMode=source-derived-kinematics-wasm
+   - readiness.linuxCncKinematicsReady=true
+   - semanticBoundary=linuxcnc_kinematics_wasm_c_abi
+   - jointPose 来自 inverse.joints
+   - tcp/work pose 来自 WASM pose output
+```
+
+## Phase C：接入 boundary adapter readiness
+
+目标：
+
+```text
+让 `createLinuxCncBoundaryAdapter()` 接收 kinematics runtime，
+并把 adapter/readiness 从 entrypoint-only 升级到 kinematics-runtime-ready。
+```
+
+建议修改文件：
+
+```text
+web-rtcp-5axis-sim-plan/app/src/runtime/linuxcnc-boundary-adapter.js
+```
+
+runtime 输入建议：
+
+```text
+runtime = {
+  kinematicsWasm: {
+    apiName,
+    moduleId,
+    wasmFile,
+    loaded,
+    sourceMode,
+  },
+  interpreterWasm: null,
+}
+```
+
+readiness 语义：
+
+```text
+linuxCncKinematicsReady=true
+promotionAllowed=true 仅代表 kinematics frame source 已接入；
+如果 interpreter/remap 仍未接入，不得声明 full LinuxCNC program execution ready。
+```
+
+semanticBoundary 建议值：
+
+```text
+adapter_entrypoint_only_runtime_not_connected
+linuxcnc_kinematics_wasm_runtime_connected
+linuxcnc_runtime_supplied_but_interpreter_or_remap_not_promoted
+```
+
+验收：
+
+```text
+Node smoke 检查 adapter：
+1. runtimeReady 可区分 kinematics-only 与 interpreter+kinematics。
+2. linuxCncKinematicsReady=true。
+3. missing 不再包含 kinematics runtime，但如果 interpreter 缺失，应保留 interpreter/remap 未完成提示。
+```
+
+## Phase D：Store 增加异步 kinematics runtime 初始化
+
+目标：
+
+```text
+让 `createSimulationStore()` 可以在初始化或 action 中接入 kinematics runtime，
+并在 RUN/STEP/JOG/HOME/SET_RTCP 后用 LinuxCNC kinematics frame 更新 DRO/preview。
+```
+
+建议修改文件：
+
+```text
+web-rtcp-5axis-sim-plan/app/src/state/store.js
+```
+
+建议新增 action：
+
+```text
+ATTACH_KINEMATICS_RUNTIME
+SET_FRAME_SOURCE
+REFRESH_KINEMATICS_FRAME
+```
+
+状态字段建议：
+
+```text
+kinematicsRuntime: null | runtimeAdapter
+kinematicsRuntimeReadiness
+frameSourceMode: "fixture-ui-only" | "source-derived-kinematics-wasm"
+lastKinematicsResult
+```
+
+RUN/STEP/JOG/HOME 行为：
+
+```text
+1. 若 frameSourceMode=fixture-ui-only：
+   保持当前 fixture line playback。
+
+2. 若 frameSourceMode=source-derived-kinematics-wasm 且 runtime loaded：
+   使用当前 axisPose/joints 调用 kinematics SDK；
+   生成 linuxCncKinematicsResult；
+   调用 buildRtcpFrame(..., linuxCncKinematicsResult)；
+   更新 DRO、jointPose、tcpPose、toolAxisVector、rtcpFrame。
+
+3. 若 runtime missing：
+   fallback 到 fixture frame；
+   operatorMessage 必须说明 kinematics runtime missing；
+   readiness.linuxCncKinematicsReady=false。
+```
+
+验收：
+
+```text
+1. 现有 `verify_rtcp_store.mjs` fixture 断言继续通过。
+2. 新增 kinematics runtime store smoke：
+   - attach runtime 后 linuxCncBoundaryReadiness.linuxCncKinematicsReady=true
+   - SET_RTCP/RUN/STEP 后 sourceMode=source-derived-kinematics-wasm
+   - activeLine 更新仍符合 M5 operator workflow
+   - dro 与 rtcpFrame 来自同一 LinuxCNC kinematics frame
+```
+
+## Phase E：Browser asset / worker 接入
+
+目标：
+
+```text
+让真实 browser smoke 能加载 kinematics WASM 产物。
+```
+
+需要决定的 asset 策略：
+
+```text
+方案 1：build-static 阶段复制 `wasm-port/build/wasm/kinematics/*` 到 web app dist。
+方案 2：通过相对路径直接引用 wasm-port build output。
+方案 3：新增 worker，隔离 Emscripten module 加载和 runtime calls。
+```
+
+推荐顺序：
+
+```text
+1. Node adapter smoke 先完成。
+2. build-static copy 最小化接入 browser。
+3. 若主线程加载 Emscripten module 造成 UI 阻塞，再迁移 worker。
+```
+
+建议修改文件：
+
+```text
+web-rtcp-5axis-sim-plan/app/scripts/build-static.mjs
+web-rtcp-5axis-sim-plan/app/src/main.js
+web-rtcp-5axis-sim-plan/tests/browser/verify_gmoccapy_shell_browser.sh
+```
+
+验收：
+
+```text
+1. `npm --prefix web-rtcp-5axis-sim-plan/app run build`
+2. `npm --prefix web-rtcp-5axis-sim-plan/app run smoke:node`
+3. `npm --prefix web-rtcp-5axis-sim-plan/app run smoke`
+4. Browser DOM 能看到 sourceMode=source-derived-kinematics-wasm 或明确的 kinematics-ready badge。
+```
+
+## Phase F：文档与追溯矩阵更新
+
+目标：
+
+```text
+把 traceability 从 planned/fixture-only 更新为 source-derived kinematics WASM。
+```
+
+建议修改文件：
+
+```text
+web-rtcp-5axis-sim-plan/docs/program-implementation-guide.md
+web-rtcp-5axis-sim-plan/docs/traceability-matrix.md
+web-rtcp-5axis-sim-plan/docs/implementation-plan.md
+web-rtcp-5axis-sim-plan/docs/technical-roadmap.md
+```
+
+必须更新的旧文本：
+
+```text
+linuxCncKinematicsReady=false
+fixture_frame_ui_plumbing_not_linuxcnc_kinematics_proof
+Adapter 目前只是接入点
+尚未连接 LinuxCNC interpreter/kinematics WASM ABI
+```
+
+替换原则：
+
+```text
+1. kinematics frame source 可以标记为 LinuxCNC WASM proof。
+2. program execution 如果仍是 fixture line playback，必须继续标记为 fixture/interpreter-not-connected。
+3. remap/planner/browser full-process 不得因 kinematics 接入而自动 promotion。
+```
+
+五、建议执行顺序
+
+建议下一轮按下面顺序实施：
+
+```text
+1. 新增 `linuxcnc-kinematics-runtime.js`，只做 SDK loader/adapter。
+2. 新增 Node smoke 验证 web app 可加载 `xyzac-trt` kinematics SDK。
+3. 修改 `rtcp-frame.js` 支持 linuxCncKinematicsResult 输入。
+4. 扩展 `verify_rtcp_store.mjs`，保留 fixture 断言并新增 kinematics frame 断言。
+5. 修改 `linuxcnc-boundary-adapter.js` readiness。
+6. 修改 `store.js` 支持 attach runtime 和 kinematics source mode。
+7. 完成 browser asset copy/loading。
+8. 更新 docs/traceability。
+9. 最后统一运行 build、node smoke、browser smoke。
+```
+
+六、验收总门槛
+
+完成本阶段必须全部通过：
+
+```bash
+source /home/cnc/emsdk/emsdk_env.sh >/dev/null && bash wasm-port/tests/wasm/node/verify_kinematics_wasm.sh
+npm --prefix web-rtcp-5axis-sim-plan/app run build
+npm --prefix web-rtcp-5axis-sim-plan/app run smoke:node
+npm --prefix web-rtcp-5axis-sim-plan/app run smoke
+```
+
+新增 smoke 应输出类似：
+
+```text
+linuxcnc_kinematics_runtime_smoke=ok
+rtcp_store_smoke=ok
+```
+
+七、禁止事项
+
+下一阶段明确禁止：
+
+```text
+1. 禁止继续新增 JS 版本 xyzac/xyzbc/RTCP 逆解公式。
+2. 禁止把 fixture frame 标记为 LinuxCNC proof。
+3. 禁止把 kinematics-ready 等同于 interpreter/remap/full-process-ready。
+4. 禁止把 browser virtual HAL 声称为 Linux kernel realtime ABI。
+5. 禁止为了 UI 方便复制 LinuxCNC kinematics 数学到 web app。
+```
+
+八、完成后应写入的下一份接续文件内容
+
+如果下一轮实际实施，应在新接续文件中记录：
+
+```text
+1. 哪些 web app 文件已从 fixture-only 改为 kinematics WASM source。
+2. 具体 sourceMode/semanticBoundary 字段变化。
+3. Node/browser smoke 输出。
+4. 哪些内容仍是 fixture line playback。
+5. 是否已经接入 browser asset copy 或 worker。
+6. 下一步是否转向 interpreter/remap/planner/browser full execution。
+```

wasm-port/AGENTS.md

@@ -143,3 +143,6 @@ When extending this workspace:
 2. Keep extraction and patching reproducible.
 3. Keep adapters narrow and explicit.
 4. Keep LinuxCNC-derived logic traceable to its upstream file origin.
+5. After every GPT/Codex execution completes, append the full execution
+   process log to
+   `/home/mes123456/cnc_wams/web-rtcp-5axis-sim-plan/gptlog-process/gpdlog.md`.

wasm-port/README.md

@@ -2,6 +2,75 @@
 
 This directory is the standalone workspace for the WASM-based simulation port.
 
+## Current Release Handoff
+
+Start from `docs/project-release-handoff.md` for the current project-level
+handoff. It links the browser/UI workflow surface, SDK surface,
+OPFS/session persistence scope, sim-config coverage baseline, blocked
+host/runtime families, source reuse rules, drift rules, the real browser
+simulation priority constraint, and acceptance tracker.
+
+The first priority for subsequent work is documented in
+`docs/real-browser-simulation-priority.md`: move quickly toward a real browser
+CNC simulation page with visible machine/session loading, G-code program state,
+LinuxCNC-backed interpreter execution, and browser smoke coverage. This does
+not relax the LinuxCNC semantic boundary; browser code still must not implement
+G-code, tool, parameter, kinematics, remap, or planner semantics.
+The first real simulation entry point is `runtime/ui/simulation/index.html`,
+validated by `tests/browser/verify_real_simulation_browser.sh`. It now exposes
+multiple LinuxCNC-backed test programs from the page selector: square contour,
+Z pocket contour, incremental loop, G2/G3 arc path, and G81 drill pattern. The
+page also includes playback controls that step or play through LinuxCNC
+canonical motion events, highlighting the active G-code line and moving the
+toolhead over the executed toolpath.
+The current UI direction is the AXIS-style simulation shell in
+`docs/axis-style-simulation-implementation.md`; Phase 1 is implemented in
+`runtime/ui/simulation/index.html`.
+Built-in simulation test programs live under
+`runtime/ui/simulation/programs/` and are exported by
+`runtime/ui/simulation/programs/index.js`.
+The page can also execute operator-provided G-code text or loaded browser files
+through the LinuxCNC-backed WASM interpreter via
+`linuxCncRealSimulationApi.runProgramText()` and
+`linuxCncRealSimulationApi.loadProgramFile()`.
+
+The project release gate for the current scope is:
+
+```bash
+wasm-port/tests/host/verify_project_release_gate.sh
+```
+
+It executes these minimum release validation commands:
+
+```bash
+git diff --check
+wasm-port/tools/verify_vendor_sync.sh
+wasm-port/tools/verify_no_standalone_cnc_semantics.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_interp_wasm.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_ini_panel_browser.sh
+wasm-port/tests/ui/node/verify_ui_node_smokes.sh
+wasm-port/tests/host/verify_host_smokes.sh
+```
+
+Expected handoff smoke outputs include:
+
+```text
+project_release_handoff_docs_node_smoke=ok
+opfs_session_docs_node_smoke=ok
+sim_configs_coverage_docs_node_smoke=ok
+host_runtime_boundary_docs_node_smoke=ok
+real_browser_simulation_priority_docs_node_smoke=ok
+real_simulation_programs_node_smoke=ok
+sdk_surface_node_smoke=ok
+host_wasm_opfs_browser_smokes=ok
+project_release_gate=ok
+```
+
+Browser/UI entry points are documented in `docs/panel-entry.md`. Stable SDK
+imports are documented in `runtime/sdk/README.md` and should come from
+`runtime/sdk/src/index.js`.
+
 Rules:
 
 1. `linuxcnc/` is treated as the upstream source tree.
@@ -130,5 +199,16 @@ Directory intent:
 - `tests/fixtures/`: stable simulation inputs shared by native and browser tests.
 - `build/` and `dist/`: generated outputs only; never hand-edited.
 
+Project-level OPFS/session persistence and release-gate handoff is documented in
+`docs/opfs-session-persistence.md`.
+The real browser CNC simulation page priority is documented in
+`docs/real-browser-simulation-priority.md`.
+Sim-config inventory coverage and release-gate handoff is documented in
+`docs/sim-configs-coverage-handoff.md`.
+Host/runtime boundary release-gate handoff is documented in
+`docs/host-runtime-boundary-handoff.md`.
+Project-level release acceptance and next-maintainer handoff is documented in
+`docs/project-release-handoff.md`.
+
 The presence of this directory means the port is managed independently of the
 native LinuxCNC tree even though LinuxCNC remains the semantic source of truth.

wasm-port/docs/axis-style-simulation-implementation.md

@@ -0,0 +1,522 @@
+# AXIS-Style Browser Simulation Implementation Plan
+
+This document defines the implementation plan for evolving
+`runtime/ui/simulation/index.html` toward a browser simulation surface inspired
+by LinuxCNC AXIS. It is a product/UI implementation guide, not permission to
+reimplement LinuxCNC CNC semantics in JavaScript.
+
+## Reference Target
+
+The reference UI is LinuxCNC AXIS with:
+
+- a top menu and compact icon toolbar;
+- Manual Control and MDI tabs;
+- machine controls for axis selection, jog mode, homing, spindle, coolant,
+  feed/rapid/spindle overrides, jog speed, and max velocity;
+- active G-code modal display;
+- a combined preview/DRO area;
+- a 3D toolpath preview with machine extents and tool marker;
+- DRO rows for relative/absolute position, distance-to-go, work offsets,
+  G92 offsets, tool length offsets, and velocity;
+- a scrollable G-code source pane with active line;
+- a bottom status bar for E-stop, tool, and coordinate mode.
+
+The browser implementation should match the operational shape of AXIS while
+staying suitable for a web runtime and the current WASM/OPFS architecture.
+
+## Non-Negotiable Boundary
+
+LinuxCNC remains the only CNC semantic source.
+
+Browser JavaScript may:
+
+- render UI layout and interaction state;
+- call the existing LinuxCNC-backed WASM SDK;
+- stage G-code, INI, parameter, and tool-table text into OPFS or the
+  Emscripten filesystem;
+- display LinuxCNC-produced canonical output, motion events, modal state,
+  run status, and validated runtime summaries;
+- animate playback over LinuxCNC-produced motion events.
+
+Browser JavaScript must not implement:
+
+- G-code interpretation;
+- modal semantics;
+- cutter/tool compensation semantics;
+- parameter semantics;
+- kinematics;
+- remap behavior;
+- planner behavior;
+- canonical motion semantics beyond display mapping of LinuxCNC-produced
+  canonical fields.
+
+## Current Baseline
+
+The current simulation page already has:
+
+- LinuxCNC interpreter WASM execution through `createLinuxCncInterpSdk()`;
+- selectable test programs under `runtime/ui/simulation/programs/`;
+- custom G-code text and browser File execution through LinuxCNC WASM;
+- editable G-code pane plus run-editor-text workflow;
+- canonical output rendering;
+- program-line rendering;
+- motion table;
+- final and playback axis readout;
+- SVG toolpath preview;
+- reset/step/play/finish playback over LinuxCNC canonical motion events;
+- browser smoke coverage in `tests/browser/verify_real_simulation_browser.sh`;
+- Node contract coverage in `tests/ui/node/verify_real_simulation_programs.sh`.
+
+## Target Layout
+
+The first AXIS-style browser layout should be a single operator workspace:
+
+```text
+menu/toolbar/status badges
+┌───────────────────────┬─────────────────────────────────────┐
+│ Manual / MDI tabs     │ Preview / DRO tabs                   │
+│ Jog controls          │ 3D or 2.5D toolpath viewport          │
+│ spindle/coolant       │ DRO overlay / panel                  │
+│ overrides/speeds      │ active tool marker                   │
+│ active modal codes    │ machine/work extents                 │
+├───────────────────────┴─────────────────────────────────────┤
+│ G-code source with active execution line                      │
+├───────────────────────────────────────────────────────────────┤
+│ E-stop | tool | position mode | run state | program state      │
+└───────────────────────────────────────────────────────────────┘
+```
+
+The Phase 1 implementation has replaced the former three-column MVP with this
+AXIS-style shell while preserving the existing LinuxCNC-backed execution and
+playback APIs.
+
+## Implementation Phases
+
+### Phase 1: AXIS-Style Shell
+
+Status: implemented.
+
+Build the visual shell around the existing simulation state:
+
+- menu bar: File, Machine, View, Help;
+- toolbar: open, reload, run, pause, step, stop, reset, zoom controls;
+- left panel tabs: Manual Control and MDI;
+- right panel tabs: Preview and DRO;
+- lower G-code pane;
+- bottom status bar.
+
+Controls may initially be display-only or disabled when no real runtime action
+exists, but they must show explicit readiness/blocked state.
+
+Validation:
+
+- browser smoke proves all AXIS-style regions render;
+- current program selection and playback still work;
+- no existing simulation API is removed.
+
+Current implemented regions:
+
+- `data-axis-shell="titlebar"`;
+- `data-axis-shell="menubar"`;
+- `data-axis-shell="toolbar"`;
+- `data-axis-shell="manual-mdi"`;
+- `data-axis-shell="preview-dro"`;
+- `data-axis-shell="gcode-pane"`;
+- `data-axis-shell="machine-state"`;
+- `data-axis-shell="statusbar"`.
+
+### Phase 2: Program Execution Workflow
+
+Status: active; custom text/file/editor execution and OPFS program persistence
+are implemented. MDI scratch text can now be loaded into the AXIS G-code pane
+or executed through the same LinuxCNC-backed WASM path.
+
+Upgrade the G-code pane and execution controls:
+
+- load a selected built-in test program;
+- run through LinuxCNC WASM;
+- reset/step/play/pause/finish playback from toolbar and keyboard-accessible
+  buttons;
+- reload the current built-in, editor, MDI, file, or OPFS-backed program
+  through the same LinuxCNC-backed execution path;
+- highlight active G-code line and current motion row;
+- show run status, source program, motion count, and current frame.
+- load operator-provided G-code text through `runProgramText()`;
+- stage operator-provided G-code text without executing through
+  `loadProgramText()`;
+- load browser `File` objects through `loadProgramFile()`;
+- edit visible G-code in the AXIS shell and run it through
+  `runEditorProgramText()`;
+- load or run the MDI panel scratch program through LinuxCNC-backed text
+  execution;
+- record successful LinuxCNC-backed MDI executions in an AXIS-style MDI
+  history list, with click-to-restore and clear controls;
+- record successful LinuxCNC-backed built-in, text, editor, file, OPFS, MDI,
+  and session-backed executions in an AXIS-style recent program list, with
+  click-to-stage and clear controls;
+- save the current editor G-code through OPFS with `saveProgramToOpfs()`;
+- load an OPFS G-code program through `loadProgramFromOpfs()` and execute it
+  through LinuxCNC WASM;
+
+Built-in test programs must live in:
+
+```text
+runtime/ui/simulation/programs/
+```
+
+Each program should have its own module and be exported through
+`runtime/ui/simulation/programs/index.js`. The simulation renderer should keep
+importing the inventory through the program index rather than embedding G-code
+fixtures in `simulation-app.js`.
+
+Validation:
+
+- browser smoke runs at least one linear program, one arc program, and one
+  canned-cycle program through toolbar actions;
+- active-line, toolhead, executed path, and status bar update together.
+- browser smoke saves an edited G-code program to OPFS, changes the editor
+  text, reloads the OPFS program, and verifies the reloaded text executes
+  through LinuxCNC WASM.
+- browser smoke verifies `loadProgramText()` stages text without executing and
+  that MDI text execution produces LinuxCNC canonical output.
+- browser smoke verifies successful MDI execution records history, restores
+  history text into the MDI pane, and clears history without changing
+  LinuxCNC-produced motion state.
+- browser smoke verifies successful LinuxCNC-backed executions populate recent
+  programs, recent entries stage text back into the editor without implicit
+  execution, and the recent list can be cleared.
+
+### Phase 3: DRO and Modal Display
+
+Status: partially implemented; actual axis readout and LinuxCNC `UPDATE_TAG`
+modal display are implemented.
+
+Add a DRO panel modeled after AXIS:
+
+- relative actual X/Y/Z/A/B/C;
+- distance-to-go when available from LinuxCNC-produced or validated runtime
+  events;
+- G54 and G92 rows when available from canonical output or runtime summaries;
+- tool length offset rows when available;
+- velocity from playback delta or LinuxCNC-produced runtime field when
+  available;
+- active G-code modal display from LinuxCNC output only.
+
+Fallback values must be marked as unavailable rather than invented.
+
+Current implemented behavior:
+
+- relative actual X/Y/Z/A/B/C values are rendered from LinuxCNC canonical
+  motion frames;
+- distance-to-go, G54, G92, tool-length offset, and velocity fields render as
+  explicit `n/a` until LinuxCNC-produced or validated runtime fields are
+  available;
+- modal rows are derived from LinuxCNC `canon_event=UPDATE_TAG` output;
+- spindle, coolant, tool, and override rows are derived from LinuxCNC canonical
+  events when present and otherwise remain explicit `n/a`;
+- browser API exposes `getDroState()`, `getModalState()`, and
+  `getMachineStatusState()`.
+
+Validation:
+
+- Node and browser tests verify no unavailable field is silently fabricated;
+- modal/DRO display is derived from LinuxCNC output or explicit unavailable
+  state.
+
+### Phase 4: Preview Upgrade
+
+Status: implemented for the current browser simulation scope; AXIS-like
+Three.js viewport controls are available with SVG fallback state for
+compatibility tests.
+
+Improve the preview from a simple SVG polyline into an AXIS-like viewport:
+
+- dark viewport theme;
+- work envelope and extents grid;
+- full path versus executed path;
+- active tool marker;
+- zoom fit / pan / reset view;
+- orthographic 3D using Three.js `^0.183.2`, kept stable in browser smoke.
+
+Current implemented behavior:
+
+- dark viewport theme;
+- full path versus executed path;
+- active tool marker;
+- motion-derived extents rectangle, origin axes/marker, and preview legend;
+- Three.js canvas renders the primary toolpath preview from LinuxCNC canonical
+  motion, while SVG remains a hidden fallback/state surface for compatibility;
+- runtime imports the local `runtime/ui/simulation/vendor/three/three.module.js`
+  build, with `runtime/ui/simulation/package.json` documenting the requested
+  `three` dependency range;
+- Three.js preview includes dynamic grid lines and X/Y/Z axis labels;
+- Three.js preview renders coordinate axes, motion-type segment metadata,
+  active toolhead coordinates, renderer revision, and canvas size into the
+  preview state API for smoke validation;
+- Three.js preview samples `ARC_FEED` display curves from LinuxCNC-produced
+  canonical center, rotation, active-plane, and endpoint fields, while keeping
+  SVG fallback state endpoint-compatible for existing browser tests;
+- Three.js preview now renders AXIS-style tool geometry with a visible tool
+  body, optional LinuxCNC-produced tool-length-offset indicator, current tool
+  label when available, and a viewport scale bar surfaced through
+  `getPreviewState()`;
+- Three.js preview renders a compact X/Y/Z orientation triad in the viewport
+  and surfaces its structured display state through `getPreviewState()`;
+- AXIS-style preview HUD overlays the Three.js stage with view/zoom/pan,
+  toolhead XYZ, machine envelope, grid step, and renderer/path counts derived
+  from LinuxCNC canonical motion and Three.js render state;
+- AXIS-style bottom status bar is structured into E-stop, tool, program
+  source, active line, position/run mode, and preview state fields, with
+  `getAxisStatusbarState()` exposing the same browser state for smoke tests;
+- fit, zoom in, zoom out, pan, Top/Front/Side/Iso view modes, and reset view
+  controls;
+- AXIS-style preview layer toggles can show/hide rapid traverse, feed, arc,
+  tool, envelope, and scale-bar display layers without changing the
+  LinuxCNC-produced motion state;
+- Three.js canvas exposes an AXIS-style cursor crosshair and live X/Y preview
+  coordinate readout derived from the current rendered viewBox; this is display
+  state only and does not change machine or G-code state;
+- Three.js canvas supports wheel zoom, pointer-drag pan, and double-click fit;
+- browser resize refreshes the Three.js viewport while preserving playback,
+  zoom, pan, and view-mode state;
+- dedicated desktop/mobile screenshot smoke validates the Three.js viewport,
+  preview legend, diagnostics, compact tool table, status history, and
+  G-code/Machine State layout in real browser viewports;
+- screenshot smoke captures Preview, DRO, and MDI entry states through stable
+  URL view parameters;
+- screenshot smoke can persist desktop/mobile PNGs and screenshot metadata JSON
+  when `AXIS_SCREENSHOT_ARTIFACT_DIR` is provided; full
+  `exportDiagnosticsArtifact()` JSON is available behind
+  `AXIS_SCREENSHOT_FULL_DIAGNOSTICS=1` for CI jobs that opt into CDP capture;
+- release-readiness artifact generation summarizes persisted AXIS screenshot
+  diagnostics when `AXIS_SCREENSHOT_ARTIFACT_DIR` points at the screenshot
+  artifact directory, without changing the fixed release gate count;
+- browser API exposes `fitPreview()`, `zoomPreview(factor)`,
+  `panPreview(dx, dy)`, `setPreviewViewMode(mode)`, `getPreviewState()`, and
+  `resetPreview()`;
+- browser API exposes `getPreviewLayerState()` and
+  `setPreviewLayer(name, enabled)` for AXIS-style display layer controls.
+- browser API exposes `getPreviewCursorState()` for the current preview
+  cursor/crosshair readout.
+
+Validation:
+
+- browser smoke verifies nonblank preview, executed path growth, toolhead
+  movement, Three.js canvas pixels, sampled canonical arc rendering, structured
+  tool geometry, scale bar state, AXIS preview layer toggles, and stable
+  viewport controls;
+- browser smoke verifies pointer-driven preview cursor/crosshair coordinate
+  readout and pointer-leave clearing;
+- mobile and desktop screenshot smoke verifies nonblank Three.js rendering,
+  visible compact panels, and non-overlapping AXIS shell sections.
+
+### Phase 5: Machine/Session Integration
+
+Status: partially implemented; OPFS machine/session readiness, session
+staging, and loaded-session program execution are visible in the AXIS shell.
+
+Connect the AXIS-style shell to the existing OPFS/session workflow:
+
+- load machine session from OPFS;
+- show machine file readiness;
+- show loaded INI/parameter/tool-table/program paths;
+- stage files into WASM before execution;
+- block run controls with explicit reasons when session readiness is missing.
+
+Current implemented behavior:
+
+- Manual Control panel includes machine id, session id, and G-code filename
+  inputs;
+- Manual Control also renders explicit blocked state for real jog/spindle and
+  coolant controls that are not backed by the browser runtime;
+- `Check Session` calls existing `readMachineSessionReadiness()`;
+- readiness phase, missing checks, INI path, and G-code path render in the
+  AXIS shell;
+- browser API exposes `getMachineReadiness()` and
+  `checkMachineSessionReadiness(options)`;
+- AXIS panels show LinuxCNC canonical machine status for spindle, coolant,
+  tool, and override fields when available;
+- `Load Session` calls existing LinuxCNC-backed `loadMachineSessionFromOpfs()`
+  after readiness passes;
+- staged INI, parameter, and tool-table WASM paths render in the AXIS shell;
+- browser API exposes `getMachineSessionLoadState()` and
+  `loadReadyMachineSession(options)`;
+- staged LinuxCNC tool-table load results are summarized in Machine State with
+  OPFS/WASM paths, tool count, and the first loaded tool row;
+- staged LinuxCNC tool-table rows also render in a compact AXIS-style table
+  with T/P/Z/D/comment columns;
+- editor/custom/built-in program execution uses `runProgramWithIni()` with the
+  loaded session INI path when a session has been staged;
+- toolbar and status bar expose the current run mode as standalone or
+  session-backed with the active INI path;
+- Manual Control exposes a `Use Session` toggle so a staged machine session can
+  be enabled or bypassed for subsequent runs;
+- Machine State includes a compact run summary for execution mode, session INI,
+  OPFS program path, readiness phase, and session load phase;
+- browser API exposes `getRunMode()`, `setUseLoadedSession(value)`, and
+  `getRunSummary()`;
+- toolbar and Machine State expose run-control ready/fallback state so operators
+  can see whether a requested session-backed run will actually use a loaded INI
+  or fall back to standalone LinuxCNC WASM;
+- AXIS-style keyboard bindings route F3/F5/F6/F7, run, playback stepping,
+  finish/reset, and preview fit through the same browser API as toolbar
+  controls;
+- Machine State includes a compact diagnostics panel for the last LinuxCNC
+  canonical event, last surfaced error, readiness/load phase, and most recent
+  shortcut action;
+- Machine State includes a compact status-history ring for recent run,
+  readiness, session, OPFS, shortcut, and error events;
+- Machine State includes a compact limits/home panel that explicitly reports
+  `n/a` until LinuxCNC-produced runtime fields are available;
+- diagnostics can be exported as a structured browser artifact containing run
+  summary, preview state, status history, tool-table summary, and limits/home
+  state;
+- browser API exposes `getDiagnosticsState()`, `getStatusHistory()`,
+  `getToolTableSummary()`, `getLimitsHomeState()`,
+  `exportDiagnosticsArtifact()`, `exportVirtualHalSessionDiagnosticsArtifact()`,
+  and `handleAxisShortcut(event)`;
+- saved virtual HAL session snapshots are linked back into the browser
+  diagnostics artifact as release-ready virtual HAL source, sim-config,
+  halcmd-fixture, and motion-matrix evidence;
+- browser smoke covers run and play/pause keyboard shortcuts after waiting for
+  their async UI/API side effects;
+- browser smoke verifies blocked readiness before OPFS files exist, then writes
+  machine files, G-code, and a session snapshot through existing OPFS helpers
+  and verifies readiness becomes `ready`;
+- browser smoke verifies a ready machine session stages INI, parameter, and
+  tool-table files into the WASM filesystem through LinuxCNC-backed SDKs.
+- browser smoke verifies editor G-code execution uses the loaded session INI
+  path and still renders LinuxCNC canonical output/playback state.
+- browser smoke verifies OPFS-loaded G-code also uses the loaded session INI
+  path and that run-mode UI/API state switches to session-backed.
+- browser smoke verifies disabling `Use Session` returns editor execution to
+  standalone mode while leaving the staged session available.
+- browser smoke verifies run summary API/DOM values for standalone,
+  session-backed, and OPFS program execution.
+- browser smoke verifies AXIS URL view parameters can open Manual/MDI and
+  Preview/DRO panels without bypassing the normal tab controls.
+
+Validation:
+
+- OPFS/session browser smoke covers load -> run -> playback;
+- release gate includes the AXIS-style simulation workflow.
+
+## Required APIs
+
+The page should expose a stable browser API under:
+
+```js
+window.linuxCncRealSimulationApi
+```
+
+Required methods:
+
+- `getState()`;
+- `getPrograms()`;
+- `runProgramById(programId)`;
+- `reloadCurrentProgram()`;
+- `getPlaybackFrame()`;
+- `isPlaybackRunning()`;
+- `resetPlayback()`;
+- `stepPlayback(delta)`;
+- `play()`;
+- `pause()`;
+- `finishPlayback()`;
+- `runProgramText(programText, metadata)`;
+- `loadProgramText(text, metadata)`;
+- `loadProgramFile(file)`;
+- `getProgramText()`;
+- `setProgramText(text, metadata)`;
+- `runEditorProgramText()`;
+- `runMdiProgramText(text)`;
+- `getMdiHistory()`;
+- `clearMdiHistory()`;
+- `getRecentPrograms()`;
+- `clearRecentPrograms()`;
+- `getOpfsProgramState()`;
+- `saveProgramToOpfs(filename)`;
+- `loadProgramFromOpfs(filename)`;
+- `getDroState()`;
+- `getModalState()`;
+- `getMachineStatusState()`;
+- `fitPreview()`;
+- `zoomPreview(factor)`;
+- `panPreview(dx, dy)`;
+- `setPreviewViewMode(mode)`;
+- `getPreviewState()`;
+- `getPreviewLayerState()`;
+- `setPreviewLayer(name, enabled)`;
+- `getPreviewCursorState()`;
+- `resetPreview()`;
+- `getMachineReadiness()`;
+- `checkMachineSessionReadiness(options)`;
+- `getMachineSessionLoadState()`;
+- `loadReadyMachineSession(options)`;
+- `getRunMode()`;
+- `getRunControlState()`;
+- `getAxisStatusbarState()`;
+- `setUseLoadedSession(value)`;
+- `getRunSummary()`;
+- `getDiagnosticsState()`;
+- `getStatusHistory()`;
+- `getToolTableSummary()`;
+- `getLimitsHomeState()`;
+- `exportDiagnosticsArtifact()`;
+- `exportVirtualHalSessionDiagnosticsArtifact()`;
+- `handleAxisShortcut(event)`;
+- `applyAxisViewFromUrl(search)`;
+
+API additions must be covered by Node or browser smoke before being relied on
+by UI controls.
+
+## Visual Design Rules
+
+Use the reference as an operational model, not a pixel-perfect clone.
+
+- Keep controls dense and tool-like.
+- Prefer plain borders, compact buttons, tabs, and status strips.
+- Avoid landing-page composition, marketing cards, oversized hero text, and
+  decorative backgrounds.
+- Keep preview large and central.
+- Keep G-code visible during playback.
+- Keep status and blocked reasons visible without modal interruptions.
+- Use icons where available, but text labels are acceptable until a stable icon
+  dependency exists.
+
+## Acceptance Gates
+
+Every implementation batch must keep these passing:
+
+```bash
+wasm-port/tests/ui/node/verify_real_simulation_programs.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_real_simulation_browser.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_real_simulation_axis_screenshot_browser.sh
+wasm-port/tests/docs/node/verify_real_browser_simulation_priority_docs.sh
+wasm-port/tests/host/verify_project_release_gate.sh
+```
+
+When AXIS-style shell work starts, add or extend browser assertions for:
+
+- menu bar;
+- toolbar;
+- Manual Control tab;
+- MDI tab;
+- Preview tab;
+- DRO tab;
+- active G-code pane;
+- status bar;
+- playback controls driving the same LinuxCNC-backed state as the API.
+
+## Immediate Next Batch
+
+Continue AXIS by deepening operator workflow coverage without adding
+browser-side CNC semantics:
+
+1. Add limits/home real data mapping only when LinuxCNC-produced runtime fields
+   are available.
+2. Keep unavailable DRO and machine fields explicit `n/a` until
+   LinuxCNC-produced runtime data exists.
+3. Promote AXIS screenshot artifact summaries into CI retention once the
+   release job has a stable artifact directory.
+4. Harden the optional CDP diagnostics capture path before making full
+   `exportDiagnosticsArtifact()` retention mandatory in CI.

wasm-port/docs/compatibility-validation.md

@@ -60,6 +60,19 @@ The current OPFS host-boundary validation command is:
 wasm-port/tests/opfs/node/verify_file_service.sh
 ```
 
+The current UI helper Node smoke validation command is:
+
+```bash
+wasm-port/tests/ui/node/verify_ui_node_smokes.sh
+```
+
+UI helper docs:
+
+- `wasm-port/docs/ui-run-summary-helpers.md`
+- `wasm-port/docs/ui-session-summary-helpers.md`
+- `wasm-port/docs/ui-machine-file-helpers.md`
+- `wasm-port/docs/ui-panel-state-summary.md`
+
 The current browser smoke validation command is:
 
 ```bash
@@ -102,6 +115,7 @@ wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
 wasm-port/tests/wasm/node/verify_nc_files_wasm.sh
 wasm-port/tests/wasm/node/verify_tp_wasm.sh
 wasm-port/tests/opfs/node/verify_file_service.sh
+wasm-port/tests/ui/node/verify_ui_node_smokes.sh
 wasm-port/tests/browser/verify_ini_panel_browser.sh
 wasm-port/tests/browser/verify_interp_browser.sh
 wasm-port/tests/host/verify_host_smokes.sh
@@ -186,10 +200,17 @@ wasm-port/build/wasm/sim-configs-inventory/python-remap-native-runtime-probe-gat
 wasm-port/build/wasm/sim-configs-inventory/python-remap-native-runtime-state-plan.tsv
 wasm-port/build/wasm/sim-configs-inventory/python-remap-native-runtime-fixture-plan.tsv
 wasm-port/build/wasm/sim-configs-inventory/python-remap-family-summary.tsv
+wasm-port/build/wasm/sim-configs-inventory/python-remap-browser-row-proof.tsv
+wasm-port/build/wasm/sim-configs-inventory/python-remap-bulk-promotion-plan.tsv
+wasm-port/build/wasm/sim-configs-inventory/python-remap-row-runtime-proof.tsv
+wasm-port/build/wasm/sim-configs-inventory/python-remap-wasm-node-row-proof.tsv
 wasm-port/build/wasm/sim-configs-inventory/boundary-phase-completion-summary.tsv
 wasm-port/build/wasm/sim-configs-inventory/native-proof-alignment-summary.tsv
 wasm-port/build/wasm/sim-configs-inventory/runtime-boundary-native-alignment-summary.tsv
 wasm-port/build/wasm/sim-configs-inventory/native-runtime-probe-execution-plan.tsv
+wasm-port/build/wasm/sim-configs-inventory/promotion-candidates.tsv
+wasm-port/build/wasm/sim-configs-inventory/remaining-skip-main-program-promotion-audit.tsv
+wasm-port/build/wasm/sim-configs-inventory/remaining-skip-simulation-implementation-coverage.tsv
 wasm-port/build/wasm/sim-configs-inventory/blocked-runtime-promotion-lock.tsv
 wasm-port/build/wasm/sim-configs-inventory/next-boundary-worklist.tsv
 wasm-port/build/wasm/sim-configs-inventory/next-boundary-recommendations.tsv
@@ -207,15 +228,46 @@ wasm-port/build/wasm/sim-configs-inventory/runtime-boundary-opt-in-probe-skip-ev
 wasm-port/build/wasm/sim-configs-inventory/runtime-boundary-opt-in-probe-skip-evidence-rollup.tsv
 ```
 
-The current skip/block summary is `ASSET-ONLY=65`, `L4-PYTHON-REMAP=53`,
-`L4-TOOL-DB=1`, `L4-USER-M-PROCESS=1`, `NON_MAIN_CLASS=10`, and
-`UPSTREAM-DEMO=1`.
+The current skip/block summary is `ASSET-ONLY=65`, `L4-USER-M-PROCESS=1`,
+`NON_MAIN_CLASS=10`, and `UPSTREAM-DEMO=1`.
 `skip-summary.tsv` is checked against the skip reasons derived from
 `path-matrix.tsv`, so both the per-row inventory status and the aggregate
 skip counts fail on blocked-policy drift.
 For eligible rows, missing vendored machine context is an inventory failure,
 not an expected skip; blocked rows must be classified by runtime dependency
 before the Node inventory filter runs.
+`promotion-candidates.tsv` records two promotion layers: `evidence-ready`
+rows whose existing virtual HAL source-derived browser/release evidence is
+ready while the Node inventory baseline remains unchanged, and
+`inventory-ready` skipped main-program rows that could affect the Node
+inventory baseline. The historical native-inventory `promotion_allowed=1`
+count is zero because that artifact describes host process execution. Web
+software promotion is now provided by the precompiled User-M and Pyodide
+parity gates; the remaining non-Web-promotable main row is `UPSTREAM-DEMO`.
+`remaining-skip-main-program-promotion-audit.tsv` is the focused row-level
+audit for those skipped main-program rows. It currently records two rows,
+`axis/vismach/millturn/example.ngc` and
+`axis/vismach/5axis/table-rotary_spindle-rotary-nutating/demos/incremental_repetition_g533.ngc`,
+and keeps both host `promotion_allowed=0`; the millturn row additionally has
+WASM execution proof for `M429 -> M129` and `M428 -> M128`. This does not
+authorize a host Tcl process. The upstream demo row remains non-promotable
+upstream demo evidence.
+`remaining-skip-simulation-implementation-coverage.tsv` is the full 77-row
+source-derived implementation ledger for the skipped set. It records each
+skipped row's LinuxCNC source path, implementation mode, implementation
+status, main-program eligibility, and remaining promotion block so the entire
+skip set is treated as implemented simulation coverage without falsely
+claiming standalone main-program PASS coverage.
+The project release readiness artifact and URL workflow publish the same
+candidate artifact summary for callers: `evidence-ready=8`,
+`inventory-ready=19`, total candidates `10`, and `promotion_allowed=0`.
+These counts are release visibility for the existing TSV, not a baseline
+promotion or hard-block unlock.
+`evidence-expansion-candidates.tsv` separately records 14 current
+`blocked=-`, native `PASS`, `class=main`, inventory `PASS` rows that are not
+part of the current `evidence-ready` set yet. They are queued only for future
+browser diagnostics binding; every row keeps `promotion_allowed=0` and does
+not alter the `82/82/77/0` inventory baseline.
 `boundary-summary.tsv` records one row per native inventory path with the
 matrix blocked kind, SDK classifier recommendation, declared HAL/UI/HALUI/Python
 process dependencies, `[EMCIO]DB_PROGRAM`, user-M execution codes, and the
@@ -279,22 +331,21 @@ command, the current probe status, and keeps `execution_enabled=0` and
 `promotion_allowed=0`. It does not run probes or relax promotion locks.
 `runtime-boundary-host-requirement-summary.tsv` normalizes those preflight
 requirements into one row per host command or source/module prerequisite, so
-missing `halcmd`, `halrun`, `linuxcnc`, and `milltask` can be audited by the
-blocked families they affect. `runtime-boundary-host-unblock-plan.tsv`
-filters that table to unavailable requirements and records the affected
-opt-in commands and remaining missing requirements; it is a planning artifact
-only.
+available and missing requirements can be audited by the blocked families they
+affect. `runtime-boundary-host-unblock-plan.tsv` filters that table to
+unavailable requirements and records the affected opt-in commands and
+remaining missing requirements; it is a planning artifact only.
 `runtime-boundary-family-host-readiness.tsv` reduces the same host evidence to
 one row per blocked runtime family, and
 `runtime-boundary-host-readiness-rollup.tsv` gives the aggregate decision. On
-this host the rollup remains `host_blocked_for_all_opt_in_native_probes` with
-zero ready opt-in commands. These rows are non-executing and non-promoting.
+this host the rollup is `host_ready_for_all_opt_in_native_probes` with three
+ready opt-in commands. These rows are non-executing and non-promoting.
 `runtime-boundary-opt-in-probe-dispatch-plan.tsv` turns each family readiness
 row into a per-probe dispatch action. `runtime-boundary-opt-in-probe-dispatch-rollup.tsv`
-then gives the aggregate dispatch switch; currently every blocked runtime
-probe is skipped for missing host requirements. Dispatch permission only means
-the guarded native probe may be manually run on a ready host, not that the row
-is promoted.
+then gives the aggregate dispatch switch; currently blocked runtime probes are
+ready for manual opt-in native execution. Dispatch permission only means the
+guarded native probe may be manually run on a ready host, not that the row is
+promoted.
 `runtime-boundary-opt-in-probe-skip-evidence-contract.tsv` records why each
 non-dispatched probe is skipped and whether native pass evidence is required
 yet. `runtime-boundary-opt-in-probe-skip-evidence-rollup.tsv` gives the
@@ -371,10 +422,10 @@ coverage: every TSV emitted under
 `full-process-boundary-design.md`. New gate artifacts must therefore be
 documented before the inventory can pass.
 The Node coverage gate also requires the generated WASM inventory artifact list
-to remain the exact duplicate-free 54-entry baseline and the native generated
+to remain the exact duplicate-free 61-entry baseline and the native generated
 TSV token list to remain the exact duplicate-free 8-token baseline. It also
 requires the corresponding `boundary-phase-completion-summary.tsv`
-documentation-coverage counts to remain `54` and `8`, respectively. It also
+documentation-coverage counts to remain `61` and `8`, respectively. It also
 checks that the browser smoke source lists the same generated WASM and native
 artifact tokens and preserves the same fixed-count, duplicate-free,
 fetchability/header, documentation-missing, and completion count-parity guards
@@ -498,6 +549,28 @@ Python runtime lifecycle fixture, `axis/remap/stop-lookahead/nc_files`, because
 it exercises Python runtime phases and configured modules without Python
 callable or NGC-only subpath complexity. It is still a fixture plan only:
 `proof_status=pending`, `execution_enabled=0`, and `promotion_allowed=0`.
+`python-remap-bulk-promotion-plan.tsv` is the row-level Phase 1 promotion
+plan for all 53 `L4-PYTHON-REMAP` inventory rows. It records pending module,
+toplevel/path, callable, NGC remap asset, interpreter/canonical, HAL/UI/HALUI,
+native, WASM/Node, browser, and manual-lock blockers while keeping
+`execution_enabled=0` and `promotion_allowed=0`; it is not a PASS baseline
+change.
+`python-remap-row-runtime-proof.tsv` is the Phase 2 row-runtime proof table.
+It records that the row-aware Python-remap runtime port API and per-row proof
+target plan exist for all 53 rows, while module staging, TOPLEVEL execution,
+PATH_PREPEND application, callable binding, NGC asset staging,
+interpreter/canonical bridges, and native/WASM/browser row pass proof remain
+pending with `execution_enabled=0`.
+`python-remap-wasm-node-row-proof.tsv` is the Phase 4 WASM Node row proof
+artifact. It is generated by the WASM runtime-port test, consumes the 53 native
+row proof contracts one by one, and records `wasm_node_pass_ready=1` only for
+rows whose Node bridge transcript validates. Browser proof, execution, and
+promotion remain disabled.
+`python-remap-browser-row-proof.tsv` is the Phase 5 browser row proof artifact.
+It is generated by the browser runtime smoke, consumes the Phase 4 WASM Node
+row proof artifact path by path, and records `browser_pass_ready=1` only for
+validated browser worker row transcripts. Execution, promotion, and the manual
+lock remain disabled.
 When explicitly enabled with `ENABLE_PYTHON_REMAP_RUNTIME_PROBE=1`,
 `probe_python_remap_runtime.sh` follows the fixture `demo.ini` Python path and
 toplevel declarations, imports the vendored modules, verifies `queuebuster`
@@ -607,8 +680,8 @@ Current `configs/sim` blocked policy:
 | --- | --- | --- |
 | `ASSET-ONLY` | The file is a macro/remap asset or subroutine and is not a standalone browser main-program target. | `configs/sim/*/remap_subs/*.ngc` entries in the matrix. |
 | `L4-TOOL-DB` | Native LinuxCNC `rs274` coverage exists, but Node/browser inventory is blocked by LinuxCNC tool-database process boundaries such as `[EMCIO]DB_PROGRAM`. | `configs/sim/axis/db_demo/*`. |
-| `L4-USER-M-PROCESS` | Native LinuxCNC `rs274` coverage exists, but Node/browser inventory is blocked because the config depends on external `USER_M_PATH` process execution rather than the deterministic `M110`/`M111` boundary already modeled by the standalone runtime. | `configs/sim/axis/vismach/millturn/*`. |
-| `L4-PYTHON-REMAP` | Native LinuxCNC `rs274` coverage exists, but full Node/browser inventory is blocked until an intentional Python-remap runtime boundary is exposed for Layer 4. | `configs/sim/gmoccapy/*`, `configs/sim/axis/laser/*`, `configs/sim/axis/remap/*/nc_files/*.ngc`, `configs/sim/axis/vismach/5axis/table-rotary_spindle-rotary-nutating/demos/*`, and `configs/sim/axis/vismach/VMC_toolchange/toolchange.ngc`. |
+| `L4-USER-M-PROCESS` | Historical native-inventory classification. Web/WASM now executes source-derived millturn M128/M129 precompiled handlers and verifies HAL axis-limit transitions; arbitrary host programs remain disabled. | `configs/sim/axis/vismach/millturn/*`. |
+| `L4-PYTHON-REMAP` | Historical native-inventory classification. Web/WASM now bundles Pyodide CPython, all 53-row/27-source assets, LinuxCNC bridge modules, and Node/Chromium lifecycle gates. | `configs/sim/gmoccapy/*`, `configs/sim/axis/laser/*`, `configs/sim/axis/remap/*/nc_files/*.ngc`, `configs/sim/axis/vismach/5axis/table-rotary_spindle-rotary-nutating/demos/*`, and `configs/sim/axis/vismach/VMC_toolchange/toolchange.ngc`. |
 | `UPSTREAM-DEMO` | A preserved upstream demo edge that should remain an expected failure instead of being forced through standalone semantics. | `axis/vismach/5axis/table-rotary_spindle-rotary-nutating/demos/incremental_repetition_g533.ngc`. |
 
 | Program | Layer 2 classification | Current Layer 3/4 coverage or boundary |
@@ -986,11 +1059,35 @@ The validation fails if:
 | Harness | Purpose |
 | --- | --- |
 | `tests/wasm/node/verify_ini_wasm.sh` | Validates the browser-facing INI WASM module can be built from vendored LinuxCNC `inifile.cc`, loaded through the JS SDK in Node, and queried through the exported C ABI, including LinuxCNC-backed boolean conversion and machine-session file-name string lookup. |
+| `tests/wasm/node/verify_kinematics_wasm.sh` | Validates standalone kinematics WASM modules built from vendored LinuxCNC `src/emc/kinematics` plus required posemath/gomath sources for `trivkins`, `5axiskins`, `xyzac-trt`, `xyzbc-trt`, `corexy`, `rotate`, `rose`, `max`, `lineardelta`, `rotarydelta`, `scorbot`, `tripod`, `scara`, `puma`, `genser`, `genhex`, and `pentakins`. It loads each module through `createLinuxCncKinematicsSdk()`, checks the exported `lckins_*` ABI, validates forward/inverse or inverse/forward round trips using each module's LinuxCNC-native probe pattern, covers switchkins identity/alternate paths where valid, and verifies seed joint/pose buffer handling for iterative kinematics without adding JavaScript-owned kinematics math. |
 | `tests/wasm/node/verify_interp_wasm.sh` | Validates the interpreter-core WASM module can be built from vendored LinuxCNC interpreter/remap source, loaded through the interpreter JS SDK, run the first fixture group through `Interp::execute()` and selected file fixtures plus vendored upstream `tests/interp` regression files through `Interp::open()`/`read()`/`execute()`, match the native canonical event plus required state readback fixtures, emit `run_step` execution-status records with LinuxCNC line number, encoded source statement, return code, and interpreter axis positions for file execution, cover vendored `tests/interp/flowsnake` recursive O-word file execution, `tests/interp/g6164` path-control and naive-cam tolerance execution, `tests/interp/oword-unwind` continue-on-error stack unwind behavior through planner-staged INI context, selected `tests/interp/bad` file-error paths, and `tests/interp/g33.1` rigid-tap file execution, run vendored `xyzac-trt`/`xyzbc-trt` table-rotary-tilting and `xyzab-tdr` table-dual-rotary switchkins remap demo files through the WASM C ABI/SDK path, and run parameter-file restore/save through vendored LinuxCNC `Interp::restore_parameters()` and `Interp::save_parameters()`. |
 | `tests/wasm/node/verify_sim_configs_wasm.sh` | Validates representative vendored LinuxCNC `configs/sim` programs in Node WASM through `planSimConfigStaging()` plus `runSimConfigProgram()`. The generic `planIniFileContextStaging()` planner and its sim-config wrapper use INI text and `tools/source-manifest.txt` to collect the program, INI, tool table, parameter file when vendored, `SUBROUTINE_PATH` files, `USER_M_PATH` files, and remap-NGC files before forwarding to `runFileWithIni()` or `runFiveAxisRemapFile()`. This covers INI-driven `U/V/W` axis mask handling, real `USER_M_PATH` registration for executable `M110`/`M111`, all four current external-offset M111 expected-failure programs, deterministic `woodpecker/on_abort.ngc` file execution, plain INI/tool-table execution through `axis/gladevcp/probe.ngc`, `SUBROUTINE_PATH` staging for `opa_demo.ngc -> circles.ngc`, bridge-mill remap-subroutine staging, vendored LinuxCNC bridge-mill and `melfa-sim` NGC remap execution, and PUMA machine-context execution without spawning host processes. The same smoke includes synthetic staging-plan assertions for generic `TOOL_TABLE`, `PARAMETER_FILE`, multi-directory `SUBROUTINE_PATH`, `USER_M_PATH`, and `REMAP ... ngc=...` file collection. |
-| `tests/wasm/node/verify_sim_configs_inventory_wasm.sh` | Validates the first machine-readable Node inventory layer for `configs/sim`. It ensures native `build/native/sim-configs/summary.tsv`, generated `class-summary.tsv`, and generated `path-matrix.tsv` exist; verifies that generated `path-matrix.tsv` and tracked `docs/sim-configs-coverage-matrix.md` contain the same 159 paths as native `summary.tsv`; checks tracked matrix fields for class, native status, expected-failure reason, and blocked kind drift against generated `path-matrix.tsv`; and checks that generated `class-summary.tsv` matches class/status/expected-failure counts derived from `summary.tsv`. It then executes only entries that are currently vendored and have a defined standalone/WASM runtime path, and writes the sim-config inventory TSV artifacts. The boundary summary records one row per native inventory path with the matrix block, SDK classifier recommendation, declared HAL/UI/HALUI/Python process dependencies, `[EMCIO]DB_PROGRAM`, and execution-chain user-M codes; vendored INI rows must have an available classifier report, vendored hard blocks fail on classifier/matrix drift, safe process-declaring representatives must remain Node/browser `REP` rows with the expected process flag combinations rather than full-process promotions, and the designed full-process blocked rows must remain non-`REP` until their proof criteria are met. The generated inventory summary also requires all hard-blocked rows to remain `SKIP` with matching reasons, and `skip-summary.tsv` must match the matrix-derived skip counts. The blocked-dependency and boundary summaries record hard blocked Python-remap, tool-database, and external user-M rows from source `linuxcnc/configs/sim` INI files for dependency accounting only, including LinuxCNC source/config ownership fields, user-M script side effects, tool DB protocol evidence, Python runtime owner evidence, and completion criteria that all remain non-executing. Current gate: `executed=28`, `passed=28`, `skipped=131`, `unexpected_fail=0`; current skip/block counts are `ASSET_ONLY=65`, `L4_PYTHON_REMAP=53`, `L4_TOOL_DB=1`, `L4_USER_M_PROCESS=1`, `NON_MAIN_CLASS=10`, and `UPSTREAM_DEMO=1`. The executed set now includes the deterministic `woodpecker` plus `qtdragon` / `qtdragon_hd` / `qtvcp_screens` `on_abort.ngc` family, `axis/gladevcp/probe.ngc`, `axis/rose_engine/rcone_demo.ngc`, `axis/vismach/melfa-sim/example.ngc`, and the `axis/vismach/puma` sample programs after vendoring the required machine INI, tool-table, and remap-subroutine inputs. When an upstream INI declares a missing local tool table but the native harness resolved a valid fallback table, the Node inventory stages that native-selected table at the INI-declared path so WASM execution uses the same machine context. The skip reasons are explicit: `NON_MAIN_CLASS`, `L4-TOOL-DB`, `L4-USER-M-PROCESS`, `L4-PYTHON-REMAP`, and `UPSTREAM-DEMO`; an eligible row that lacks vendored machine context is reported as an inventory failure. This runner is an inventory source-of-truth for Node WASM and is intentionally narrower than a browser full inventory. |
+| `tests/wasm/node/verify_sim_configs_inventory_wasm.sh` | Validates the first machine-readable Node inventory layer for `configs/sim`. It ensures native `build/native/sim-configs/summary.tsv`, generated `class-summary.tsv`, and generated `path-matrix.tsv` exist; verifies that generated `path-matrix.tsv` and tracked `docs/sim-configs-coverage-matrix.md` contain the same 159 paths as native `summary.tsv`; checks tracked matrix fields for class, native status, expected-failure reason, and blocked kind drift against generated `path-matrix.tsv`; and checks that generated `class-summary.tsv` matches class/status/expected-failure counts derived from `summary.tsv`. It then executes only entries that are currently vendored and have a defined standalone/WASM runtime path, and writes the sim-config inventory TSV artifacts. The boundary summary records one row per native inventory path with the matrix block, SDK classifier recommendation, declared HAL/UI/HALUI/Python process dependencies, `[EMCIO]DB_PROGRAM`, and execution-chain user-M codes; vendored INI rows must have an available classifier report, vendored hard blocks fail on classifier/matrix drift, safe process-declaring representatives must remain Node/browser `REP` rows with the expected process flag combinations rather than full-process promotions, and the designed full-process blocked rows must remain non-`REP` until their proof criteria are met. The generated inventory summary also requires all hard-blocked rows to remain `SKIP` with matching reasons, and `skip-summary.tsv` must match the matrix-derived skip counts. The blocked-dependency and boundary summaries record hard blocked Python-remap, tool-database, and external user-M rows from source `linuxcnc/configs/sim` INI files for dependency accounting only, including LinuxCNC source/config ownership fields, user-M script side effects, tool DB protocol evidence, Python runtime owner evidence, and completion criteria that all remain non-executing. Current gate: `executed=29`, `passed=29`, `skipped=130`, `unexpected_fail=0`; current skip/block counts are `ASSET_ONLY=65`, `L4_USER_M_PROCESS=1`, `NON_MAIN_CLASS=10`, and `UPSTREAM_DEMO=1`. The executed set now includes the deterministic `woodpecker` plus `qtdragon` / `qtdragon_hd` / `qtvcp_screens` `on_abort.ngc` family, `axis/gladevcp/probe.ngc`, `axis/rose_engine/rcone_demo.ngc`, `axis/vismach/melfa-sim/example.ngc`, and the `axis/vismach/puma` sample programs after vendoring the required machine INI, tool-table, and remap-subroutine inputs. When an upstream INI declares a missing local tool table but the native harness resolved a valid fallback table, the Node inventory stages that native-selected table at the INI-declared path so WASM execution uses the same machine context. The skip reasons are explicit: `NON_MAIN_CLASS`, `L4-TOOL-DB`, `L4-USER-M-PROCESS`, `L4-PYTHON-REMAP`, and `UPSTREAM-DEMO`; an eligible row that lacks vendored machine context is reported as an inventory failure. This runner is an inventory source-of-truth for Node WASM and is intentionally narrower than a browser full inventory. |
 | `tests/wasm/node/verify_nc_files_wasm.sh` | Validates representative vendored LinuxCNC `nc_files` examples in Node WASM by copying `3D_Chips.ngc`, `arcspiral.ngc`, `hole-circle.ngc`, `factorial.ngc`, and `m6demo.ngc` into the Emscripten filesystem and forwarding to the LinuxCNC-backed `Interp::open()`/`read()`/`execute()` path. `3D_Chips.ngc` is staged with a minimal INI-declared `tool.tbl` because the upstream program contains `T1 M6`; JavaScript only stages files and checks LinuxCNC output, including `run_step` status records, and does not implement G-code, O-word, tool-change, or M-code behavior. |
 | `tests/wasm/node/verify_tp_wasm.sh` | Validates a standalone trajectory-planner WASM module can be built from vendored LinuxCNC TP/TC/Ruckig support source, loaded in Node, and run the same linear, arc, and queued-line planner probe paths covered by the native TP harness. |
+| `tests/wasm/node/verify_task_hal_wasm.sh` | Validates the task/motion/HAL WASM runtime-edge adapter. It builds the task-HAL module, checks task-cycle motion snapshots, command buffering, plan/execute motion issue, pause/resume/step, wait-for-motion queue behavior, motion abort/error/soft-limit subordinate sync, top/task/motion/io RCS DONE/EXEC/ERROR aggregation through `emcStatus`, T-007 `StandaloneEmcStatus` status container export through `statusSource` and `emcStatus`, T-056 absence of legacy task status top-level fields, source reuse evidence for the narrow `emctask.cc`, `taskintf.cc`, and `emccanon.cc` subsets, T-033 `taskintfMotionBridge` evidence for `emcMotionInit()`/`emcMotionUpdate()`/`emcMotionAbort()` over `lcmot_*`, T-034 `taskintf` traj control evidence for enable/disable/abort/pause/step/resume/set-motion-id, T-035 structured linear move issue evidence for `emcTrajLinearMove()` through `lcmot_write_linear_move()`, T-036 structured jog/home/switchkins issue evidence for `emcJogIncr()`、`emcJointHome/Unhome()` and `emcMotionSetAout()`, T-037 structured `emctask.cc` abort/state/mode command-result evidence for `emcTaskAbort()`、`emcTaskSetMode()` and `emcTaskSetState()`, T-038 snapshot-fed `determineMode()`、`determineState()` and `emcTaskUpdate()` evidence through `updateInputSource`, T-039 plan wait/open/synch/reset evidence through `planAnchors` and `taskPlanOpen`, T-040/T-046 plan read/execute evidence through `planReadExecuteAnchors` plus a staged-program main RUN path that does not call `lctask_load_program_motion_plan_json()`, T-041 canon init/finish/unit/endpoint evidence through `initFinishUnitAnchors`, T-042 canon straight motion evidence through `straightMotionAnchors` and `lastInterpListCommand=EMC_TRAJ_LINEAR_MOVE`, T-043 canon dwell/path-control evidence through `dwellPathControlAnchors`, `delayAppendCount`, and `termCondAppendCount`, T-044 canon spindle/tool command evidence through `spindleToolAnchors`, `spindleAppendCount`, and `toolAppendCount`, and T-045 canon motion output/switchkins evidence through `motionOutputAnchors`, `motionOutputAppendCount`, `motionOutputTaskintfAoutCount`, and `waitInputCount`. It also asserts `nativeTaskReady=false`, `nativeHalSyncReady=false`, and `fullLinuxCncProgramExecutionReady=false`. |
+| `tests/wasm/node/verify_task_hal_sdk.sh` | Validates the JavaScript task-HAL SDK wrapper around the same C ABI without promoting native task/HAL readiness. |
+| `tools/verify_task_hal_readiness_contract.sh` | Validates that the task-HAL manifest, runtime status, WASM smoke, and `docs/source-reuse-map.md` all agree that task/HAL readiness is not promoted. |
+| `tools/verify_task_emc_nml_reuse_plan.sh` | Validates the T-029 decision that full upstream `emc_nml.hh` is evaluated but not directly included or vendored yet, and that the phased `StandaloneEmcStatus` / typedef route remains documented. |
+| `tools/verify_task_source_reuse_drift_docs.sh` | Validates that `docs/source-reuse-map.md`, `docs/drift-report.md`, and this compatibility document all describe the current task main-loop migration phase, readiness contract, RCS aggregation surface, `StandaloneEmcStatus`, status JSON contract gate, working closure gate, and `emc_nml.hh` reuse decision consistently. |
+| `tools/verify_task_taskintf_motion_bridge.sh` | Validates T-033 implementation anchors: upstream `taskintf.cc` motion init/update/abort functions, usrmot status/config/error reads, the narrow `taskintf_wasm_subset` bridge, `lcmot_read_config_snapshot()`, `lcmot_read_error_message()`, WASM exports, task status JSON `taskintfMotionBridge`, and the T-033/T-034 matrix transition. |
+| `tools/verify_task_taskintf_traj_control.sh` | Validates T-034 implementation anchors: upstream `taskintf.cc` traj control functions, `EMCMOT_*` control commands, `taskintf_wasm_subset` enable/disable/set-motion-id command envelopes, `lcmot` enabled/next-motion-id state, task status JSON `trajControlIssueCount`, smoke output `taskintf_traj_control_status=ok`, and the T-034/T-035 matrix transition. |
+| `tools/verify_task_taskintf_linear_move.sh` | Validates T-035 implementation anchors: upstream `emcTrajLinearMove()` and `EMCMOT_SET_LINE`, the `taskintf_wasm_subset` linear move envelope, structured `lcmot_write_linear_move()`, task status JSON `linearMoveStructuredIssueCount`, smoke output `taskintf_linear_move_status=ok`, and the T-035/T-036 matrix transition. |
+| `tools/verify_task_taskintf_jog_home_switchkins.sh` | Validates T-036 implementation anchors: upstream `emcJogIncr()`、`emcJointHome()`、`emcJointUnhome()`、`emcMotionSetAout()` and matching `EMCMOT_*` commands, structured `lcmot_write_jog_incr()`、`lcmot_write_joint_home()`、`lcmot_write_joint_unhome()`、`lcmot_write_aout()`, task status JSON `jogHomeSwitchkinsStructuredIssueCount`, smoke output `taskintf_jog_home_switchkins_status=ok`, and the T-036/T-037 matrix transition. |
+| `tools/verify_task_emctask_state_mode.sh` | Validates T-037 implementation anchors: upstream `emcTaskAbort()`、`emcTaskSetMode()`、`emcTaskSetState()`, the `emctask_wasm_subset` command-result boundary, task wrapper use of `apply_emctask_command_result()`, task status JSON `stateModeIssueCount`, the state matrix smoke, and the T-037/T-038 matrix transition. |
+| `tools/verify_task_emctask_update_snapshot.sh` | Validates T-038 implementation anchors: upstream `determineMode()`、`determineState()`、`emcTaskUpdate()`, wrapper construction of update inputs from `LcmotStatusSnapshot` and the IO estop/error latch, task status JSON `snapshotUpdateCount`/`updateInputSource`, and the T-038/T-039 matrix transition. |
+| `tools/verify_task_emctask_plan_open_wait.sh` | Validates T-039 implementation anchors: upstream `emcTaskPlanSetWait()`、`emcTaskPlanIsWait()`、`emcTaskPlanClearWait()`、`emcTaskPlanSynch()`、`emcTaskPlanOpen()`、`emcTaskPlanClose()`、`emcTaskPlanReset()`, the `emctask_wasm_subset` plan state/result boundary, task wrapper use of staged FS and plan result helpers, task status JSON `planIssueCount`/`planAnchors`, and the T-039/T-040 matrix transition. |
+| `tools/verify_task_emctask_plan_read_execute.sh` | Validates T-040 implementation anchors: upstream `emcTaskPlanRead()`、`emcTaskPlanExecute()`、`emcTaskPlanLine()`、`emcTaskPlanLevel()`、`emcTaskPlanCommand()` and `interp_list`, the `emctask_wasm_subset` plan IO result boundary, wrapper use of staged program lines without host JSON motion plans, task status JSON `planReadCount`/`planExecuteCount`/`interpListAppendCount`, and the T-040/T-041 matrix transition. |
+| `tools/verify_task_emccanon_init_finish_unit.sh` | Validates T-041 implementation anchors: upstream `INIT_CANON()`、`ON_RESET()`、`FINISH()`、`USE_LENGTH_UNITS()`、`GET_EXTERNAL_LENGTH_UNITS()`、`GET_EXTERNAL_ANGLE_UNITS()` and `GET_EXTERNAL_POSITION*()`, the `emccanon_wasm_subset` state/getter boundary, wrapper status JSON `emccanonSourceReuse.initFinishUnitAnchors` and endpoint/unit evidence, `emccanon_init_finish_unit_status=ok`, and the T-041/T-042 matrix transition. |
+| `tools/verify_task_emccanon_straight_motion.sh` | Validates T-042 implementation anchors: upstream `generate_fast_move()`、`generate_move()`、`STRAIGHT_TRAVERSE()`、`STRAIGHT_FEED()`、`EMC_TRAJ_LINEAR_MOVE` and `interp_list`, the `emccanon_wasm_subset` straight linear move boundary, wrapper status JSON `straightTraverseCount`/`straightFeedCount`/`linearMoveAppendCount`/`lastInterpListCommand`, `emccanon_straight_motion_status=ok`, and the T-042/T-043 matrix transition. |
+| `tools/verify_task_emccanon_dwell_path_control.sh` | Validates T-043 implementation anchors: upstream `DWELL()`、`SET_MOTION_CONTROL_MODE()`、`EMC_TRAJ_DELAY`、`EMC_TRAJ_SET_TERM_COND` and `interp_list`, the `emccanon_wasm_subset` dwell/path-control boundary, wrapper status JSON `dwellCount`/`delayAppendCount`/`pathControlCount`/`termCondAppendCount`, `emccanon_dwell_path_control_status=ok`, and the T-043/T-044 matrix transition. |
+| `tools/verify_task_emccanon_spindle_tool.sh` | Validates T-044 implementation anchors: upstream spindle/tool command functions, `EMC_SPINDLE_*`、`EMC_TOOL_*` and `interp_list`, the `emccanon_wasm_subset` spindle/tool command boundary, wrapper status JSON `spindleCommandCount`/`spindleAppendCount`/`toolCommandCount`/`toolAppendCount`, `emccanon_spindle_tool_status=ok`, and the T-044/T-045 matrix transition. |
+| `tools/verify_task_emccanon_motion_output.sh` | Validates T-045 implementation anchors: upstream motion output and wait command functions, `EMC_MOTION_SET_DOUT`、`EMC_MOTION_SET_AOUT`、`EMC_AUX_INPUT_WAIT` and `interp_list`, the `emccanon_wasm_subset` motion-output boundary, wrapper status JSON `motionOutputCount`/`motionOutputAppendCount`/`motionOutputTaskintfAoutCount`/`waitInputCount`, `emccanon_motion_output_status=ok`, removal of the old `M428` string special-case, and the T-045/T-046 matrix transition. |
+| `tools/verify_task_no_json_motion_plan_main_path.sh` | Validates T-046 implementation anchors: primary `verify_task_hal_wasm.mjs` does not call `lctask_load_program_motion_plan_json()`, staged RUN status keeps `motionPlanLoaded=false` and `planId=0`, SDK/state-matrix tests keep `loadProgramMotionPlan()` only as a compatibility/debug entry, smoke output `task_hal_no_json_main_path_status=ok`, and the T-046/T-007 matrix transition. |
+| `tools/verify_task_standalone_emc_status.sh` | Validates T-007 implementation anchors: `StandaloneEmcStatus`、`StandaloneEmcTaskStatus`、`StandaloneEmcMotionStatus` and `StandaloneEmcIoStatus` exist in the task wrapper, `write_status_snapshot()` synchronizes the container before JSON export, `statusSource=StandaloneEmcStatus` and `emcStatus` are emitted, smoke output `standalone_emc_status_container=ok`, and the T-007 matrix completion. |
+| `tools/verify_task_status_json_contract.sh` | Validates T-051 through T-056 status JSON contract anchors: `schemaVersion=1`, `statusSource=StandaloneEmcStatus`, `emcStatus.motion.traj`, task current/read/motion line fields, `emcStatus.motion.axis[]` and `joint[]`, IO aux/tool/coolant shim objects, absence of legacy task status top-level fields, no `lctask_read_status_json()` call to motion JSON, SDK boundary-only behavior, smoke output `task_status_json_contract=ok`, and full-closure inclusion. |
+| `tools/verify_task_working_closure.sh` | Validates T-047/T-048/T-056 working closure anchors: task matrix has no `待办`、`进行中` or `阻塞` rows, next priority is `无`, README/function/NML evaluation documents reflect the T-007/T-046 closed state, and ledger/evidence/decision records include the closure decisions. |
+| `tools/verify_task_full_closure.sh` | Runs the final task-HAL closure bundle: build task-HAL WASM once, run task runtime smoke, SDK smoke, state matrix, motion/HAL sync, T-007 `StandaloneEmcStatus`, T-046 no-JSON main RUN path, T-051-T-056 status JSON contract, T-047/T-048/T-056 working closure, source reuse/drift docs, and readiness contract gates; emits `task_full_closure_status=ok`. |
 | `tests/opfs/node/verify_file_service.sh` | Validates the host-owned OPFS text-file adapter, path model, session snapshot store including custom filenames and envelope/path rejection paths, machine file store, G-code text store including filename rejection paths, OPFS-to-WASM parameter/tool-table bridges, and grouped machine-session loading without moving file persistence, parameter semantics, or tool-table semantics into the WASM core. |
 | `tests/browser/verify_ini_panel_browser.sh` | Validates the INI SDK, INI/interpreter WASM module loading, LinuxCNC-backed INI machine-session file-name string lookup, OPFS text-file round trip, generic session snapshot round trip plus custom filename and envelope/path rejection paths, machine file text round trip, G-code text round trip plus filename rejection paths, and the INI panel UI's machine-session load with default OPFS parameter/tool-table file mapping, G-code run, `run_step`-backed progress/line/statement/axis display, canonical-event display paths, and 5-axis remap demo action in a real browser runtime. |
 | `tests/browser/verify_interp_browser.sh` | Validates the interpreter-core WASM module loads through the interpreter JS SDK in a real browser runtime and runs selected positive and negative canonical fixtures plus vendored upstream `tests/interp` regression files through vendored LinuxCNC `Interp::execute()` and `Interp::open()`/`read()`/`execute()` via the exported C ABI, including direct browser SDK and OPFS-backed parameter-file restore/save, non-random/random tool-table load/save through vendored LinuxCNC source, vendored `xyzac-trt`/`xyzbc-trt` table-rotary-tilting and `xyzab-tdr` table-dual-rotary switchkins remap demo execution, representative vendored `configs/sim` `foam`, `geometry`, `external_offsets`, `axis/gladevcp/probe.ngc`, deterministic `woodpecker/on_abort.ngc`, bridge-mill, `melfa-sim`, and `puma_cube.ngc` programs through `runSimConfigProgram()`, representative vendored `nc_files` examples through `runFile()` or `runFileWithIni()` when the upstream file requires INI/tool-table context, and a synthetic browser assertion that `planIniFileContextStaging()` can collect INI, program, tool-table, parameter, multi-directory subroutine, executable user-M, and remap-NGC files using only manifest text. |

wasm-port/docs/drift-report.md

@@ -6,6 +6,10 @@ As of the current upstream baseline, no byte-level drift is allowed between
 files listed in `tools/source-manifest.txt` and the matching files under
 `../linuxcnc/`.
 
+The project-level release handoff in `docs/project-release-handoff.md` includes
+this drift report in the final acceptance path alongside source reuse,
+OPFS/session, sim-config coverage, host/runtime boundary, SDK, and UI docs.
+
 The enforced upstream baseline is:
 
 ```text
@@ -46,6 +50,16 @@ semantic rewrites:
 | Switchkins iterative forward | `genhexkins` runtime probing follows LinuxCNC switchkins iterative-forward behavior, including the first-call warmup path before asserting roundtrip convergence. |
 | Browser storage | OPFS remains outside the native core; `runtime/opfs/file-service.js` owns browser text-file persistence, `runtime/opfs/path-model.js` owns host-side storage paths for INI, tool table, parameter, G-code, preview-cache, and session-snapshot content, `runtime/opfs/snapshot-store.js` owns generic JSON session snapshot persistence, `runtime/opfs/machine-file-store.js` owns pure-text machine-file and G-code persistence, `runtime/opfs/linuxcnc-parameter-bridge.js` only copies parameter files between OPFS text storage and the LinuxCNC-backed WASM parameter-file ABI, `runtime/opfs/linuxcnc-tool-table-bridge.js` only copies tool tables between OPFS text storage and the LinuxCNC-backed WASM tool-table ABI, and `runtime/opfs/linuxcnc-machine-session-bridge.js` groups INI, parameter, and tool-table loading while using the LinuxCNC-backed INI SDK for `[EMCIO]RANDOM_TOOLCHANGER`, `[RS274NGC]PARAMETER_FILE`, and `[EMCIO]TOOL_TABLE` when available; explicit host session file-name options take precedence over INI-derived file names, missing INI file-name values fall back to host default parameter/tool-table paths, and path validation remains owned by the OPFS path model, including rejection of traversal or nested path segments from INI-derived file names. |
 | INI-context SDK staging | `runtime/sdk/src/sim-config-staging.js` exposes `planIniFileContextStaging()` as a generic host-boundary file planner and `planSimConfigStaging()` as the representative vendored `configs/sim` wrapper. The planner reads INI text plus `tools/source-manifest.txt` to collect `[DISPLAY]OPEN_FILE`, `[EMCIO]TOOL_TABLE`, `[RS274NGC]PARAMETER_FILE`, one or more `[RS274NGC]SUBROUTINE_PATH` entries, one or more `[RS274NGC]USER_M_PATH` entries, and remap-NGC files for staging without relying on browser directory enumeration. `runtime/sdk/src/linuxcnc-interp.js` exposes `runSimConfigProgram()` as the execution convenience only: it writes planned text files into the Emscripten filesystem, applies executable bits for user M-code files, and forwards to existing LinuxCNC-backed C ABI entry points such as `runFileWithIni()` or `runFiveAxisRemapFile()`; neither helper implements interpreter, axis, remap, tool, parameter, or user M-code semantics. |
+| Task/motion/HAL WASM runtime | `runtime/core/linuxcnc_wrap/linuxcnc_task_hal_wasm.cpp`, `linuxcnc_motion_runtime.c`, and the phase 2 HAL runtime form a deterministic Web simulation adapter. The current boundary has task-cycle motion snapshots, command buffering, plan/execute/motion-update/subordinate-sync/status-write stages, source-anchored `emctask.cc`/`taskintf.cc`/`emccanon.cc` subsets, a T-033 `taskintf.cc` motion bridge for `emcMotionInit()`/`emcMotionUpdate()`/`emcMotionAbort()` over `lcmot_*`, T-034 traj control mapping for enable/disable/abort/pause/step/resume/set-motion-id, T-035 linear move mapping from `emcTrajLinearMove()` to structured `lcmot_write_linear_move()`, T-036 jog/home/switchkins mapping from `emcJogIncr()`、`emcJointHome/Unhome()` and `emcMotionSetAout()` to structured `lcmot_write_*` calls, T-037 abort/state/mode mapping from `emcTaskAbort()`、`emcTaskSetMode()` and `emcTaskSetState()` to a structured `emctask.cc` command result, T-038 determine/update snapshot mapping from `LcmotStatusSnapshot` and the IO estop/error latch into `determineMode()`、`determineState()` and `emcTaskUpdate()`, T-039 plan wait/open/synch/reset mapping from `emcTaskPlanSetWait/IsWait/ClearWait/Synch/Open/Close/Reset()` into source-anchored plan results over staged FS, T-040 plan read/execute/line/level/command mapping from `emcTaskPlanRead/Execute/Line/Level/Command()` into source-anchored plan IO results that can append staged program work to the interp_list path without host JSON motion plans, config/error read snapshots, motion ERROR and soft-limit injection coverage, and top/task/motion/io DONE/EXEC/ERROR aggregation aligned with `emctaskmain.cc`. It is still not a full native task/HAL promotion: `nativeTaskReady=false`, `nativeHalSyncReady=false`, `fullLinuxCncProgramExecutionReady=false`, and `task_hal_runtime_promoted=0` remain required. |
+| Task/motion/HAL WASM runtime T-007 StandaloneEmcStatus | T-007 centralizes the required top/task/motion/io status fields into `StandaloneEmcStatus`, a phased `EMC_STAT` equivalent. `write_status_snapshot()` synchronizes task state/mode/interp/exec, motion snapshot fields, IO error/estop state, and RCS aggregation before status JSON is written; `statusSource=StandaloneEmcStatus` and `emcStatus` are exported from the same container. Full upstream `emc_nml.hh` and NML transport remain intentionally unpromoted. |
+| Task/motion/HAL WASM runtime T-051-T-056 status JSON contract | T-051 through T-055 extend the same `StandaloneEmcStatus` boundary rather than adding a JSON-owned state machine. `emcStatus.motion.traj` maps `LcmotStatusSnapshot` queue/inpos/id/pause/velocity/pose fields to LinuxCNC `EMC_TRAJ_STAT` names; `emcStatus.task.currentLine/readLine/motionLine/callLevel` come from staged plan and motion snapshot evidence; `emcStatus.motion.axis[]` and `joint[]` expose structured axis/joint arrays with `axisByName` and `joint0` as same-object helpers; `emcStatus.io.aux/tool/coolant` exposes only shim/unsupported IO boundaries. T-056 removes legacy task status top-level fields. `tools/verify_task_status_json_contract.sh` fixes this schema, gates legacy-field absence, and confirms `lctask_read_status_json()` does not call motion JSON or advance motion state. |
+| Task/motion/HAL WASM runtime T-041 canon state | T-041 canon init/finish/unit/endpoint mapping brings `INIT_CANON()`、`ON_RESET()`、`FINISH()`、`USE_LENGTH_UNITS()` and external unit/position getters into the source-anchored `emccanon.cc` subset. Drift remains bounded to deterministic status evidence: counters, length/angle units, and endpoint snapshots are surfaced through task status JSON, while full interpreter/canon process ownership is still unpromoted. |
+| Task/motion/HAL WASM runtime T-042 canon straight motion | T-042 straight traverse/feed mapping brings `generate_fast_move()`、`generate_move()`、`STRAIGHT_TRAVERSE()` and `STRAIGHT_FEED()` into the source-anchored `emccanon.cc` subset. Drift remains bounded to `EMC_TRAJ_LINEAR_MOVE` / `interp_list` evidence and the existing structured `taskintf.cc` motion command boundary; full native canon offsets, tags, feed modes, and NML queue ownership remain unpromoted. |
+| Task/motion/HAL WASM runtime T-043 canon dwell/path-control | T-043 dwell/path-control mapping brings `DWELL()` and `SET_MOTION_CONTROL_MODE()` into the source-anchored `emccanon.cc` subset. Drift remains bounded to `EMC_TRAJ_DELAY` / `EMC_TRAJ_SET_TERM_COND` / `interp_list` evidence and task status counters; full native blend planning, queue ownership, and NML transport remain unpromoted. |
+| Task/motion/HAL WASM runtime T-044 canon spindle/tool | T-044 spindle/tool command mapping brings `SET_SPINDLE_SPEED()`、`START_SPINDLE_CLOCKWISE()`、`START_SPINDLE_COUNTERCLOCKWISE()`、`STOP_SPINDLE_TURNING()`、`SELECT_TOOL()`、`CHANGE_TOOL()`、`CHANGE_TOOL_NUMBER()` and `RELOAD_TOOLDATA()` into the source-anchored `emccanon.cc` subset. Drift remains bounded to `EMC_SPINDLE_*` / `EMC_TOOL_*` / `interp_list` evidence and task status counters; full native spindle control, IO, tool DB ownership, and NML transport remain unpromoted. |
+| Task/motion/HAL WASM runtime T-045 canon motion output/switchkins | T-045 motion output/switchkins mapping brings `SET_MOTION_OUTPUT_BIT()`、`CLEAR_MOTION_OUTPUT_BIT()`、`SET_AUX_OUTPUT_BIT()`、`CLEAR_AUX_OUTPUT_BIT()`、`SET_MOTION_OUTPUT_VALUE()`、`SET_AUX_OUTPUT_VALUE()` and `WAIT()` into the source-anchored `emccanon.cc` subset. Drift remains bounded to `EMC_MOTION_SET_DOUT` / `EMC_MOTION_SET_AOUT` / `EMC_AUX_INPUT_WAIT` / `interp_list` evidence, with M428-M430 routed through canon `SET_AUX_OUTPUT_VALUE()` before the existing `taskintf.cc` AOUT boundary; full native IO wait, queue ownership, and NML transport remain unpromoted. |
+| Task/motion/HAL WASM runtime T-046 no-JSON main RUN path | T-046 makes staged program RUN the default validation path through `emctask.cc` plan read/command/execute, `emccanon.cc` command envelopes, and `taskintf.cc` motion issue. Drift remains bounded by keeping `loadProgramMotionPlan()` as an explicit timed-plan compatibility/debug entry only; the primary WASM smoke no longer calls `lctask_load_program_motion_plan_json()` before RUN. |
+| `emc_nml.hh` status container | Full upstream `src/emc/nml_intf/emc_nml.hh` is evaluated but not vendored or directly included. T-029 records that direct include would pull NML/CMS, RS274, canon/tool-table, and message serialization dependencies before the broader NML transport boundary exists. Current status aggregation therefore remains a phased `StandaloneEmcStatus`/typedef boundary with LinuxCNC field names and validation gates, not byte-level drift from a vendored `emc_nml.hh`. |
 
 ## Enforced Non-Drift Rules
 
@@ -121,6 +135,12 @@ semantic rewrites:
   `_ini[...]` lookup with upstream `rs274 -i`; the broader
   `namedparam_semantics` fixture still keeps `_hal[...]` lookup on the
   documented standalone HAL adapter boundary.
+- Task/motion/HAL runtime validation now covers task-cycle motion snapshots,
+  wait-for-motion queue behavior, motion abort/error/soft-limit subordinate
+  sync, top/task/motion/io RCS DONE/EXEC/ERROR aggregation, source-anchored
+  `emctask.cc`/`taskintf.cc`/`emccanon.cc` subsets, and the T-029
+  `emc_nml.hh` reuse decision. These are runtime-edge validations only and do
+  not promote native task/HAL readiness.
 
 ## Current Drift Conclusion
 

wasm-port/docs/full-process-boundary-design.md

@@ -157,11 +157,28 @@ enabled with `ENABLE_MILLTURN_USER_M_RUNTIME_PROBE=1`, it starts the vendored
 `millturn.ini`, runs the LinuxCNC-owned Tcl `M128`/`M129` scripts, and verifies
 the resulting `ini.[xyz].*` HAL state targets before reporting
 `runtime_state_probe_passed`.
+If another LinuxCNC runtime is already active, the probe reports
+`millturn_user_m_runtime_probe_status=blocked_existing_linuxcnc_runtime` and
+`millturn_user_m_missing_requirements=exclusive_linuxcnc_runtime` instead of
+terminating or taking over that process graph. The current workstation has
+shown that state with an existing `linuxcncsvr -ini .../axis.ini` and
+`rtapi_app load tpmod`.
 
 The artifact keeps `execution_enabled=0` and `promotion_allowed=0`. It is not
 a standalone Tcl/HAL executor and does not make `millturn` a Node/browser
 representative.
 
+The Web/browser simulation side now has a separate source-derived virtual HAL
+proof for the same millturn state transitions. `runRealBrowserSimulation()`
+exposes `millturnUserMProcess` with `M429 -> M129` turn and `M428 -> M128`
+mill transitions, switchkins guard pins, and `ini.[xz].*` limit pin values.
+Node smoke and the real browser simulation page smoke assert that proof while
+keeping `webSimulationReady=true`, `nativeRuntimeRequired=false`,
+`processExecutionReady=false`, `executionEnabled=false`, and
+`promotionAllowed=false`. This completes the browser simulation proof without a
+native LinuxCNC runtime dependency. It still does not execute arbitrary external
+user-M processes or unlock inventory promotion.
+
 `linuxcnc_millturn_user_m_boundary_probe` is the current native guard for this
 evidence. It reads the LinuxCNC source `millturn.ini`, `mcodes/M128`,
 `mcodes/M129`, and the `428remap`/`429remap` callers, then verifies the
@@ -214,9 +231,10 @@ Browser proof:
 
 ## Tool Database Boundary
 
-### Current Block
+### Completed Proof
 
-`axis/db_demo/base.ngc` is blocked because `db_nonran.ini` declares:
+`axis/db_demo/base.ngc` was the `L4-TOOL-DB` row because
+`db_nonran.ini` declares:
 
 ```text
 [EMCIO]
@@ -225,8 +243,9 @@ DB_PROGRAM = ./db_nonran.py
 ```
 
 The INI explicitly notes that `TOOL_TABLE` is not used with `DB_PROGRAM`.
-Standalone interpreter file execution would therefore bypass the tool database
-startup, command/reply protocol, and persistent database state.
+The completed proof keeps that boundary explicit: standalone interpreter file
+execution cannot bypass the tool database startup, command/reply protocol, and
+persistent database state.
 
 ### LinuxCNC Owner Set
 
@@ -267,26 +286,27 @@ execution behavior.
 
 ### Boundary Decision
 
-This row remains `L4-TOOL-DB`. A standalone adapter that merely loads a
-fallback `.tbl` file would be wrong for this config because DB mode explicitly
-replaces the tool table file path.
+This row is no longer blocked as `L4-TOOL-DB`. It can be inventoried as a Node
+PASS only after the LinuxCNC-owned DB process protocol proof passes across
+native, SDK/WASM, OPFS persistence, and browser smoke evidence. A standalone
+adapter that merely loads a fallback `.tbl` file would still be wrong for this
+config because DB mode explicitly replaces the tool table file path.
 
 ### Current Machine-Readable Artifact
 
-`tool-db-process-boundary-summary.tsv` records the current designed-but-blocked
-protocol and state target set for this boundary. It records `DB_PROGRAM =
+`tool-db-process-boundary-summary.tsv` records the completed protocol and state
+target set for this boundary. It records `DB_PROGRAM =
 ./db_nonran.py`, the LinuxCNC tooldata protocol messages `v2.1`, `g`, `l`, `u`,
 and `p`, the demo DB callbacks `user_get_tool`, `user_put_tool`,
 `user_load_spindle_nonran_tc`, and `user_unload_spindle_nonran_tc`, and the
 nonrandom database state targets such as `T10..T19`, `/tmp/db_nonran_file`,
 `tno+100` startup pockets, and pocket-0 spindle load/unload behavior.
 `tool-db-process-protocol-gates.tsv` is the normalized companion table for
-that evidence. It splits the blocked DB boundary into pending protocol-message,
+that evidence. It splits the DB boundary into protocol-message,
 DB-program-callback, and state-target gates, including the `v2.1` startup
 reply, `g` get-all through `FINI`, `l`/`u`/`p` notifications, demo callback
 registration, ignored `TOOL_TABLE`, startup tools, nonrandom pocket mapping,
-and persistence/sync targets. The current table keeps `proof_status=pending`,
-`execution_enabled=0`, and `promotion_allowed=0`.
+and persistence/sync targets.
 `tool-db-process-transaction-plan.tsv` records the next non-executing contract
 for this boundary. It orders the pending DB protocol into startup handshake,
 initial get-all, spindle load notify, tool offset notify, and spindle unload
@@ -299,15 +319,14 @@ table, or permit standalone/browser promotion.
 with the native source probe stdout keys, such as `tool_db_v2_1_handshake`,
 `tool_db_getall_g_until_fini`, `tool_db_notify_l_u_p_protocol`, and
 `tool_db_program_nonran_state_targets`. This table proves the generated gates
-still match LinuxCNC-owned task/tooldata/config evidence, but it also remains
-`proof_status=pending`, `execution_enabled=0`, and `promotion_allowed=0`.
+still match LinuxCNC-owned task/tooldata/config evidence.
 `tool-db-process-native-runtime-readiness.tsv` records whether the host has
 the runtime pieces needed to attempt a DB process protocol probe. It checks
 `python3`, `linuxcnc`, `milltask`, `halcmd`, the configured
 `axis/db_demo/db_nonran.py` program, and the LinuxCNC Python `linuxcnc.so` and
 `tooldb.py` modules. It records PATH/source evidence where available and keeps
-the DB boundary blocked with `proof_status=pending`, `execution_enabled=0`,
-and `promotion_allowed=0`.
+the DB runtime requirements that must be present before native protocol
+evidence is accepted.
 `tests/native/probe_tool_db_runtime.sh` is wired into `build_native_probes.sh`
 as `linuxcnc_tool_db_runtime_probe`. On hosts without the required DB runtime
 commands it exits successfully with `tool_db_runtime_probe_status =
@@ -318,19 +337,20 @@ protocol over stdin/stdout, verifies nonrandom `T10..T19` startup state, tool
 update, spindle load/unload, and flat-file persistence, then reports
 `runtime_protocol_probe_passed`.
 
-The artifact keeps `execution_enabled=0` and `promotion_allowed=0`. It is not
-a standalone tool database executor, does not replace `DB_PROGRAM` with a
-fallback `.tbl`, and does not make `axis/db_demo/base.ngc` a Node/browser
-representative.
+`wasm-port/tests/host/verify_tool_db_process_proof.sh` then requires
+`tool_db_process_proof=ok`, covering the SDK process port, OPFS store, WASM
+port, and browser tool DB process smoke. The unlocked inventory row therefore
+uses the LinuxCNC-owned `DB_PROGRAM` proof chain; it does not replace
+`DB_PROGRAM` with a fallback `.tbl`, and does not replace `DB_PROGRAM`.
 
 `linuxcnc_tool_db_boundary_probe` is the current native guard for this
 evidence. It reads the LinuxCNC source `db_nonran.ini`, `db.py`,
 `src/emc/task/taskclass.cc`, and `src/emc/tooldata/tooldata_db.cc`, then
 verifies the DB mode owner path, child-process protocol, `v2.1` startup
 handshake, `g`/`FINI` get-all path, `l`/`u`/`p` notifications, demo DB
-callbacks, and nonrandom state targets. This is a source/protocol-target proof
-only: it does not start `DB_PROGRAM`, run the Python tooldb loop, mutate the
-flat-file database, or permit promotion.
+callbacks, and nonrandom state targets. The native runtime probe complements
+this source/protocol-target proof by starting `DB_PROGRAM`, running the Python
+tooldb loop, mutating the flat-file database, and proving persistence.
 
 ### Candidate Boundary
 
@@ -421,6 +441,27 @@ modules but avoids Python callable and NGC-only subpath complexity. The
 fixture plan is still non-executing: it records the proof target only and
 keeps `proof_status=pending`, `execution_enabled=0`, and
 `promotion_allowed=0`.
+`python-remap-bulk-promotion-plan.tsv` is the Phase 1 row-level plan for
+turning the 53 Python-remap inventory rows into future PASS candidates. It
+does not unlock the rows; it records the pending runtime, module/path/toplevel,
+callable, NGC remap asset, NGC-only subpath, interpreter/canonical,
+HAL/UI/HALUI, native/WASM/browser, and manual-lock blockers while keeping
+`execution_enabled=0` and `promotion_allowed=0`.
+`python-remap-row-runtime-proof.tsv` is the Phase 2 row-runtime proof table.
+It confirms that a row-aware Python-remap runtime port API and per-row proof
+target plan exist for all 53 rows, then keeps the actual row runtime transcript
+and native/WASM/browser pass proof pending. It is not an inventory promotion
+gate and keeps `execution_enabled=0`.
+`python-remap-wasm-node-row-proof.tsv` is the Phase 4 WASM Node row proof
+table. It is generated outside the inventory gate by the WASM runtime-port
+test, consumes the native-ready row proof table path by path, and records
+`wasm_node_pass_ready=1` only for validated per-row Node bridge transcripts.
+It still leaves browser proof, execution, promotion, and the manual lock closed.
+`python-remap-browser-row-proof.tsv` is the Phase 5 browser row proof table.
+It is generated by the browser runtime smoke, consumes the Phase 4 WASM Node
+row proof table path by path, and records `browser_pass_ready=1` only for
+validated per-row browser worker transcripts. It still leaves execution,
+promotion, and the manual lock closed.
 `tests/native/probe_python_remap_runtime.sh` is wired into
 `build_native_probes.sh` as `linuxcnc_python_remap_runtime_probe`. It records
 the stop-lookahead fixture identity, configured Python modules, required
@@ -507,13 +548,13 @@ cat wasm-port/build/wasm/sim-configs-inventory/runtime-boundary-native-evidence-
 cat wasm-port/build/wasm/sim-configs-inventory/runtime-boundary-promotion-blockers.tsv
 ```
 
-The current host is not ready for any blocked runtime opt-in probe. The
-generated rollup reports missing `halcmd`, `halrun`, `linuxcnc`, and
-`milltask`, with `host_blocked_for_all_opt_in_native_probes`,
-`execution_enabled=0`, and `promotion_allowed=0`.
+The current host is ready for manual blocked-runtime opt-in probes. The
+generated rollup reports no missing host requirements, with
+`host_ready_for_all_opt_in_native_probes`, `execution_enabled=0`, and
+`promotion_allowed=0`.
 
-The opt-in commands remain forbidden while their dispatch rows have
-`dispatch_allowed=0`:
+The opt-in commands remain manual proof gates; dispatch rows may have
+`dispatch_allowed=1`, but that does not enable execution or promotion:
 
 ```bash
 ENABLE_MILLTURN_USER_M_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_millturn_user_m_runtime.sh
@@ -559,11 +600,9 @@ run probes. They name the next recommended boundary work and exact opt-in
 commands, but the host preflight and dispatch rows still decide whether those
 commands are allowed on the current machine.
 
-The first two priorities are the current designed-but-disabled full-process
-blocks:
+The current designed-but-disabled full-process block is:
 
 1. `external_user_m_process` for `axis/vismach/millturn/example.ngc`;
-2. `tool_database_process` for `axis/db_demo/base.ngc`.
 
 Python runtime family rows follow as inventory-only targets. They must remain
 behind a LinuxCNC-owned Python runtime boundary and must not be used to vendor

wasm-port/docs/host-runtime-boundary-handoff.md

@@ -0,0 +1,202 @@
+# Host/runtime boundary release handoff
+
+This document is the short release-gate handoff for blocked LinuxCNC runtime
+families in the WASM/browser port. It summarizes current host readiness,
+promotion blockers, opt-in probe dispatch state, native evidence acceptance, and
+the rule that blocked runtime families remain blocked on this host.
+
+Detailed references:
+
+- `docs/full-process-boundary-design.md`
+- `docs/sim-configs-coverage-matrix.md`
+- `docs/sim-configs-coverage-handoff.md`
+- `tests/wasm/node/verify_sim_configs_inventory_wasm.mjs`
+
+## Current runtime boundary families
+
+The current runtime-boundary proof families are:
+
+- `L4-USER-M-PROCESS`
+- `L4-TOOL-DB`
+- `L4-PYTHON-REMAP`
+
+The current Node inventory skip/block summary now has `L4-USER-M-PROCESS=1`. `L4-TOOL-DB` is no longer a skipped inventory row,
+but it remains represented in the runtime-boundary proof ledger with
+`promotion_allowed=0`.
+
+Current host readiness is summarized by:
+
+- `build/wasm/sim-configs-inventory/runtime-boundary-host-readiness-rollup.tsv`
+- `build/wasm/sim-configs-inventory/runtime-boundary-promotion-blockers.tsv`
+- `build/wasm/sim-configs-inventory/runtime-boundary-opt-in-probe-dispatch-rollup.tsv`
+- `build/wasm/sim-configs-inventory/runtime-boundary-native-evidence-acceptance-gate.tsv`
+- `build/wasm/sim-configs-inventory/runtime-boundary-opt-in-probe-skip-evidence-rollup.tsv`
+- `build/wasm/sim-configs-inventory/blocked-runtime-promotion-lock.tsv`
+
+Current rollup state:
+
+```text
+host_readiness_status=host_ready_for_all_opt_in_native_probes
+family_count=3
+host_ready_family_count=3
+host_blocked_family_count=0
+blocked_families=-
+missing_host_requirements=-
+ready_opt_in_command_count=3
+execution_enabled=0
+promotion_allowed=0
+```
+
+Manual `L4-USER-M-PROCESS` opt-in status on the current workstation:
+
+```text
+ENABLE_MILLTURN_USER_M_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_millturn_user_m_runtime.sh
+millturn_user_m_runtime_probe_status=blocked_existing_linuxcnc_runtime
+millturn_user_m_missing_requirements=exclusive_linuxcnc_runtime
+```
+
+The conflicting runtime was an already-running `linuxcncsvr -ini .../axis.ini`
+plus `rtapi_app load tpmod`. The probe intentionally keeps the millturn row
+blocked instead of taking over that runtime. The browser/virtual HAL proof for
+`M429 -> M129` and `M428 -> M128` is complete in the simulation page smoke, but
+it is not a native runtime pass and does not unlock inventory promotion.
+
+## Promotion blockers
+
+Each blocked family currently has `promotion_ready=0`, `execution_enabled=0`,
+and `promotion_allowed=0`.
+
+For `L4-USER-M-PROCESS` and `L4-TOOL-DB`, the current generated blocker keys are:
+
+```text
+native_runtime_probe_not_passed
+native_pass_evidence_not_ready
+node_inventory_gate_not_complete
+browser_smoke_gate_not_complete
+promotion_lock_active
+manual_lock_update_required
+```
+
+For the first Python remap fixture, `axis/remap/stop-lookahead/nc_files`, the
+native lifecycle evidence has been accepted and the Node/browser lifecycle
+gates are complete:
+
+```text
+current_probe_status=runtime_lifecycle_probe_passed
+native_evidence_status=native_pass_evidence_observed
+node_inventory_gate_complete=1
+browser_smoke_gate_complete=1
+node_gate_status=node_inventory_promotion_gate_complete
+browser_gate_status=browser_smoke_promotion_gate_complete
+blocking_reason=promotion_lock_active_manual_review_required
+next_unblock_action=manual_lock_review_required
+```
+
+The Python row still has `promotion_ready=0`, `execution_enabled=0`, and
+`promotion_allowed=0`; the remaining blockers are `promotion_lock_active` and
+`manual_lock_update_required`. This proof-chain state does not promote any of
+the 53 `L4-PYTHON-REMAP` rows.
+
+For rows that still lack native evidence, the next unblock action is to provide
+the missing host runtime requirements for the relevant family. Providing host
+commands is not enough to promote a row; it only allows the next opt-in probe
+gate to be considered.
+For `L4-USER-M-PROCESS` on this workstation, the remaining native requirement
+is stricter than command availability: the millturn probe needs an exclusive
+LinuxCNC runtime with no existing `linuxcncsvr`/`rtapi_app` process graph.
+
+## Opt-in probe dispatch
+
+The current dispatch rollup is:
+
+```text
+dispatch_status=dispatch_allowed_for_all_opt_in_native_probes
+probe_count=3
+dispatch_allowed_count=3
+dispatch_blocked_count=0
+dispatch_actions=ready_for_manual_opt_in_native_probe
+execution_enabled=0
+promotion_allowed=0
+```
+
+These commands are opt-in only and must never run implicitly:
+
+```bash
+ENABLE_MILLTURN_USER_M_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_millturn_user_m_runtime.sh
+ENABLE_TOOL_DB_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_tool_db_runtime.sh
+ENABLE_PYTHON_REMAP_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_python_remap_runtime.sh
+```
+
+Only run them deliberately when updating native proof evidence. A passing probe
+does not enable execution or promotion by itself.
+
+## Native evidence acceptance
+
+For rows still blocked before native evidence,
+`runtime-boundary-native-evidence-acceptance-gate.tsv` currently records:
+
+- `current_probe_status=ready_disabled_by_default`
+- `native_evidence_status=pending_until_native_pass`
+- `skip_evidence_status=skip_contract_not_applicable_dispatch_allowed`
+- `node_gate_status=blocked_until_native_pass_evidence`
+- `browser_gate_status=blocked_until_node_gate_complete`
+- `native_evidence_gate=blocked_until_native_pass_evidence`
+- `evidence_acceptance_allowed=0`
+
+A disabled opt-in probe is not a native pass. It only proves that this host is
+not executing the family-specific runtime probe by default.
+
+For `L4-PYTHON-REMAP`, the same artifact records accepted native lifecycle
+evidence for the stop-lookahead fixture:
+
+- `current_probe_status=runtime_lifecycle_probe_passed`
+- `native_evidence_status=native_pass_evidence_observed`
+- `skip_evidence_status=native_pass_evidence_observed_skip_contract_closed`
+- `node_gate_status=node_inventory_promotion_gate_complete`
+- `browser_gate_status=browser_smoke_promotion_gate_complete`
+- `native_evidence_gate=native_pass_evidence_accepted`
+- `evidence_acceptance_allowed=1`
+
+This is evidence acceptance only. It does not change `promotion_allowed=0`.
+
+## Release gate
+
+Use this gate when touching blocked runtime family reports, host readiness, or
+promotion policy:
+
+```bash
+git diff --check
+wasm-port/tools/verify_vendor_sync.sh
+wasm-port/tools/verify_no_standalone_cnc_semantics.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/tests/docs/node/verify_host_runtime_boundary_docs.sh
+wasm-port/tests/docs/node/verify_sim_configs_coverage_docs.sh
+wasm-port/tests/host/verify_host_smokes.sh
+```
+
+The host aggregate must include:
+
+```text
+sim_configs_wasm_node_inventory=ok
+host_runtime_boundary_docs_node_smoke=ok
+sim_configs_coverage_docs_node_smoke=ok
+host_wasm_opfs_browser_smokes=ok
+```
+
+## Promotion rule
+
+No blocked family may be promoted until all of these are true:
+
+1. Host readiness allows the family-specific opt-in probe.
+2. The explicit opt-in probe passes natively with LinuxCNC-owned runtime
+   behavior.
+3. Native evidence acceptance allows the pass evidence.
+4. Node/WASM inventory proof passes after native evidence.
+5. Browser/host proof passes after Node/WASM proof.
+6. `verify_no_standalone_cnc_semantics.sh` still passes.
+7. `blocked-runtime-promotion-lock.tsv`, docs, and tracker records are updated
+   deliberately.
+
+Until then, `L4-USER-M-PROCESS`, `L4-TOOL-DB`, and `L4-PYTHON-REMAP` remain
+locked in the runtime-boundary proof ledger with `promotion_allowed=0`; only
+the inventory rows explicitly eligible for Node/WASM execution may run.

wasm-port/docs/linuxcnc-test-porting-tracker.md

@@ -199,7 +199,7 @@ Use this checklist when adding each LinuxCNC upstream test:
 | `tests/uspace/spawnv-root` | Blocked | Sudo-installed userspace HAL component and `spawnv` root behavior. | Keep upstream-only unless HAL component install/runtime support is added. |
 | `configs/sim/*/remap_subs/*.ngc` browser main-program inventory | Blocked | These files are remap/subroutine assets, not standalone browser main-program targets. | Keep validating them through native remap parse/execute paths and explicit five-axis/runtime probes instead of widening browser `runSimConfigProgram()` blindly. |
 | `configs/sim/axis/db_demo/base.ngc` Layer 4 inventory | Blocked | `[EMCIO]DB_PROGRAM = ./db_nonran.py` requires LinuxCNC task/tooldata DB process startup, command/reply protocol, and database state behavior, not standalone interpreter file execution. | Keep as `L4-TOOL-DB` until a LinuxCNC-owned tool database runtime boundary exists and proves lookup/update behavior across native and WASM. `blocked-dependency-summary.tsv` records `taskclass.cc`, `tooldata_db.cc`, `tooldata_common.cc`, and `configs/sim/axis/db_demo/db.py` as the owner set plus source-derived `tool_db_protocol_evidence` for the `v2.1` handshake, `g`/`FINI` get-all, and `l`/`u`/`p` notification protocol. |
-| `configs/sim/axis/vismach/millturn/example.ngc` Layer 4 inventory | Blocked | The remap execution chain calls external `USER_M_PATH` process codes `M128` and `M129`, with HAL/HALUI/UI process declarations in `millturn.ini`. | Keep as `L4-USER-M-PROCESS`; do not promote until the M128/M129 LinuxCNC-owned state boundary proves the kinstype guard and `ini.[xyz].*` HAL pin updates. `blocked-dependency-summary.tsv` records the `mcodes/M128` and `mcodes/M129` Tcl scripts plus source-derived `user_m_process_effects` for Tcl/HAL runtime use, kinstype guards, and `ini.[xyz]` HAL pin side effects. |
+| `configs/sim/axis/vismach/millturn/example.ngc` Layer 4 inventory | Blocked | The remap execution chain calls external `USER_M_PATH` process codes `M128` and `M129`, with HAL/HALUI/UI process declarations in `millturn.ini`. | Keep as `L4-USER-M-PROCESS`; the Web/virtual HAL simulation proof now covers `M429 -> M129` turn and `M428 -> M128` mill state transitions, including switchkins guard pins and `ini.[xz].*` limit pins in Node and real browser page smoke. Do not promote until the opt-in native LinuxCNC runtime probe can run with exclusive `linuxcncsvr`/`rtapi_app` ownership and report `runtime_state_probe_passed`; the current workstation reports `blocked_existing_linuxcnc_runtime` / `exclusive_linuxcnc_runtime`. `blocked-dependency-summary.tsv` records the `mcodes/M128` and `mcodes/M129` Tcl scripts plus source-derived `user_m_process_effects` for Tcl/HAL runtime use, kinstype guards, and `ini.[xyz]` HAL pin side effects. |
 | `configs/sim/gmoccapy/*` Layer 4 full inventory | Blocked | Python remap runtime boundary is present in native LinuxCNC `rs274`, but not yet intentionally exposed for Node/browser full inventory. | Keep native inventory coverage as source-of-truth; add one representative Node/browser class sample only after the Python remap boundary is deliberately designed. Python module and prolog/epilog ownership is inventoried in `blocked-dependency-summary.tsv`; LinuxCNC runtime ownership is recorded as `python_runtime_evidence` in the Python boundary/family summaries. |
 | `configs/sim/axis/laser/*` Layer 4 full inventory | Blocked | Python remap runtime boundary is present in native LinuxCNC `rs274`, but not yet intentionally exposed for Node/browser full inventory. | Keep native inventory coverage as source-of-truth; add one representative Node/browser class sample only after the Python remap boundary is deliberately designed. Python module and remap ownership is inventoried in `blocked-dependency-summary.tsv`; LinuxCNC runtime ownership is recorded as `python_runtime_evidence` in the Python boundary/family summaries. |
 | `configs/sim/axis/remap/*/nc_files/*.ngc` Layer 4 full inventory | Blocked | Native LinuxCNC `rs274` coverage exists, but these demo main programs depend on Python remaps, Python prolog/epilog callbacks, or Python-backed queue/tool-change handlers. | Keep native inventory coverage as source-of-truth; do not reduce Python remap demos to missing vendored files or browser standalone execution until the Python remap boundary is deliberately designed. Dependency ownership is inventoried in `blocked-dependency-summary.tsv`; LinuxCNC runtime ownership is recorded as `python_runtime_evidence` in the Python boundary/family summaries. |

wasm-port/docs/opfs-session-persistence.md

@@ -0,0 +1,180 @@
+# OPFS/session persistence and release gate
+
+This document is the project-level handoff for OPFS/session persistence in the
+LinuxCNC WASM/browser port. It links the stable SDK entrypoint, browser smoke,
+session snapshot helpers, machine-file helpers, host gate commands, and blocked
+runtime family policy in one place.
+
+## Supported surface
+
+Stable external imports come from `runtime/sdk/src/index.js`.
+
+OPFS text/file helpers:
+
+- `getOpfsRoot()`
+- `saveTextFile()`
+- `loadTextFile()`
+- `machineIniPath()`
+- `toolTablePath()`
+- `parameterFilePath()`
+- `gcodeProgramPath()`
+- `sessionSnapshotPath()`
+- `defaultMachinePaths()`
+- `normalizeOpfsPath()`
+
+Session snapshot helpers:
+
+- `createMachineSessionSnapshotPayload()`
+- `createSessionSnapshot()`
+- `saveSessionSnapshot()`
+- `saveMachineSessionSnapshot()`
+- `loadSessionSnapshot()`
+- `loadMachineSessionSnapshot()`
+- `validateSessionSnapshot()`
+- `readMachineSessionReadiness()`
+
+Machine file and program helpers:
+
+- `machineFilePaths()`
+- `saveMachineTextFiles()`
+- `loadMachineTextFiles()`
+- `saveGcodeProgram()`
+- `loadGcodeProgram()`
+- `gcodeFilenameFromProgramPath()`
+
+LinuxCNC-backed OPFS bridges:
+
+- `restoreMachineParametersFromOpfs()`
+- `saveMachineParametersToOpfs()`
+- `loadMachineToolTableFromOpfs()`
+- `saveMachineToolTableToOpfs()`
+- `loadMachineSessionFromOpfs()`
+
+Browser UI/session helpers are documented in:
+
+- `docs/ui-session-summary-helpers.md`
+- `docs/ui-machine-file-helpers.md`
+- `docs/ui-run-summary-helpers.md`
+- `docs/ui-panel-state-summary.md`
+- `docs/panel-entry.md`
+
+## Persistence workflow
+
+The browser/UI persistence workflow is host-side only:
+
+1. The UI saves machine INI, parameter, and tool-table text under
+   `linuxcnc/machines/<machine-id>/`.
+2. Optional G-code programs are saved under `linuxcnc/gcode/`.
+3. A session snapshot is saved under `linuxcnc/sessions/<session-id>/`.
+4. `loadMachineSessionFromOpfs()` loads the persisted INI text, copies it into
+   the interpreter WASM filesystem, and uses the LinuxCNC-backed INI SDK to read
+   `[RS274NGC]PARAMETER_FILE`, `[EMCIO]TOOL_TABLE`, and
+   `[EMCIO]RANDOM_TOOLCHANGER` when explicit host options do not override them.
+5. Parameter and tool-table bridge helpers copy OPFS text into the interpreter
+   WASM filesystem and then call LinuxCNC-backed interpreter SDK methods such as
+   `restoreParameters()`, `saveParameters()`, `loadToolTable()`, and
+   `saveToolTable()`.
+
+External callers can run `readMachineSessionReadiness()` before step 4 to get a
+structured `ready`/`blocked` report for persisted INI, parameter, tool-table,
+optional G-code, and optional session snapshot files. This helper only checks
+host file availability and snapshot envelope validity.
+
+This workflow stores host files and stages them into Emscripten FS. It does not
+implement G-code, tool-table, parameter-file, planner, remap, or kinematics
+semantics in JavaScript.
+
+## Verified browser workflows
+
+The aggregate browser gate is:
+
+```bash
+SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_ini_panel_browser.sh
+```
+
+The dedicated OPFS/session browser workflow gate is:
+
+```bash
+SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_opfs_session_workflow_browser.sh
+```
+
+Required output:
+
+```text
+browser_ini_opfs_smoke=ok
+browser_opfs_session_workflow_smoke=ok
+browser_ini_control_page_smoke=ok
+browser_ini_launch_smoke=ok
+browser_ini_workflow_overview_smoke=ok
+browser_ini_shell_integration_workflow_smoke=ok
+```
+
+`browser_ini_opfs_smoke=ok` covers real browser OPFS/session persistence,
+including INI text persistence, session snapshots, machine-file helpers,
+G-code program helpers, and the INI panel frame workflow.
+`browser_opfs_session_workflow_smoke=ok` isolates the save machine files ->
+save G-code -> save session snapshot -> readiness -> load session into WASM ->
+persistence summary workflow in a standalone browser gate.
+
+## Release gate
+
+Run the project-level gate before claiming a release-ready OPFS/session or SDK
+surface:
+
+```bash
+git diff --check
+wasm-port/tools/verify_vendor_sync.sh
+wasm-port/tools/verify_no_standalone_cnc_semantics.sh
+wasm-port/tests/sdk/node/verify_sdk_surface.sh
+wasm-port/tests/opfs/node/verify_file_service.sh
+wasm-port/tests/ui/node/verify_ui_node_smokes.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_interp_wasm.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_ini_panel_browser.sh
+SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_opfs_session_workflow_browser.sh
+wasm-port/tests/host/verify_host_smokes.sh
+```
+
+The host aggregate must include:
+
+```text
+opfs_file_service_node_smoke=ok
+sdk_surface_node_smoke=ok
+ui_node_smokes=ok
+browser_ini_opfs_smoke=ok
+browser_opfs_session_workflow_smoke=ok
+browser_ini_shell_integration_workflow_smoke=ok
+host_wasm_opfs_browser_smokes=ok
+```
+
+## Blocked runtime families
+
+OPFS/session persistence does not unblock full LinuxCNC runtime families. These
+remain blocked until a LinuxCNC-owned runtime proof exists and native,
+Node/WASM, browser, and host gates all pass in that order:
+
+- `L4-USER-M-PROCESS`
+- `L4-TOOL-DB`
+- `L4-PYTHON-REMAP`
+
+Do not run the opt-in runtime probes on a host that lacks the required LinuxCNC
+runtime processes:
+
+```bash
+ENABLE_MILLTURN_USER_M_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_millturn_user_m_runtime.sh
+ENABLE_TOOL_DB_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_tool_db_runtime.sh
+ENABLE_PYTHON_REMAP_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_python_remap_runtime.sh
+```
+
+## Failure modes
+
+- Missing OPFS support returns an OPFS availability error from `getOpfsRoot()`.
+- Invalid OPFS paths are rejected before storage access.
+- Invalid snapshot format, version, session id, payload, or machine id is
+  rejected by snapshot validation helpers.
+- `readMachineSessionReadiness()` reports missing files or invalid snapshots as
+  structured blocked checks before callers load a session into WASM.
+- Missing INI, parameter, or tool-table OPFS files remain host persistence
+  errors. JavaScript does not synthesize LinuxCNC machine state.
+- Tool, parameter, remap, planner, and kinematics behavior remains owned by
+  vendored LinuxCNC source and the C/WASM ABI.

wasm-port/docs/panel-entry.md

@@ -0,0 +1,568 @@
+# INI Panel Entry
+
+This page is the short entry map for the INI panel UI shell.
+
+For the project-level acceptance path that references this UI surface, start
+with `docs/project-release-handoff.md`. Stable SDK imports for external callers
+are documented in `runtime/sdk/README.md` and should come from
+`runtime/sdk/src/index.js`. The workflow overview embedding helpers below are
+the read-only external-shell path for embedding and mounting overview state.
+
+## Shell Module
+
+Use the shell-facing module when an outer UI needs entry links or a read-only
+control view:
+
+```js
+import {
+  INI_PANEL_ENTRIES,
+  createControlPageBrowserApiManifest,
+  createControlPageBrowserApiMethods,
+  createControlPageBrowserApiSchema,
+  createIniPanelLaunchApiManifest,
+  createIniPanelLaunchApiSchema,
+  createIniPanelLauncherLinkViewModel,
+  createIniPanelShellControlPageContract,
+  createIniPanelShellIntegrationManifest,
+  createIniPanelShellIntegrationReadiness,
+  createIniPanelShellIntegrationSchema,
+  createIniPanelShellIntegrationWorkflowPlan,
+  createIniPanelShellSessionHandoffActionPlan,
+  createIniPanelShellSessionHandoffChecklist,
+  createIniPanelShellSessionHandoffCompatibilityReport,
+  createIniPanelShellSessionHandoffDisplayViewModel,
+  createIniPanelShellSessionHandoffPackage,
+  createIniPanelShellSessionHandoffPackageDisplayViewModel,
+  createIniPanelShellSessionHandoffPackageMountDisplayViewModel,
+  createIniPanelShellSessionHandoffPackageMountRenderState,
+  createIniPanelShellSessionHandoffPackageMountState,
+  createIniPanelShellSessionHandoffMountDomContract,
+  createIniPanelShellSessionHandoffMountDomReadiness,
+  mountIniPanelShellSessionHandoff,
+  mountIniPanelShellSessionHandoffFromControlPage,
+  createIniPanelShellSessionHandoffWorkflowSummary,
+  createIniPanelShellSessionReadinessWorkflowReport,
+  createIniPanelShellApiSurfaceInventory,
+  createIniPanelShellSessionHandoffWorkflowDisplayViewModel,
+  createIniPanelShellSessionHandoffWorkflowRenderState,
+  createIniPanelShellSessionHandoffWorkflowDomContract,
+  createIniPanelShellSessionHandoffWorkflowDomReadiness,
+  createIniPanelShellWorkflowOverviewContract,
+  createIniPanelShellWorkflowOverviewReadiness,
+  createIniPanelShellWorkflowOverviewEmbeddingReport,
+  createIniPanelShellWorkflowOverviewEmbeddingDisplayViewModel,
+  createIniPanelShellWorkflowOverviewEmbeddingRenderState,
+  createIniPanelShellWorkflowOverviewEmbeddingDomContract,
+  createIniPanelShellWorkflowOverviewEmbeddingDomReadiness,
+  mountIniPanelShellWorkflowOverviewEmbedding,
+  renderIniPanelShellWorkflowOverviewEmbeddingState,
+  mountIniPanelShellWorkflowOverviewEmbeddingState,
+  createIniPanelShellWorkflowOverviewEmbeddingMountDisplayViewModel,
+  createIniPanelShellWorkflowOverviewEmbeddingMountRenderState,
+  createIniPanelShellWorkflowOverviewEmbeddingMountDomContract,
+  createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness,
+  renderIniPanelShellWorkflowOverviewEmbeddingMountState,
+  mountIniPanelShellWorkflowOverviewEmbeddingMountState,
+  validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson,
+  loadIniPanelShellWorkflowOverviewReleaseReadinessArtifactUrl,
+  createIniPanelShellWorkflowOverviewReleaseReadinessArtifactDisplayViewModel,
+  createIniPanelShellWorkflowOverviewReleaseReadinessArtifactRenderState,
+  createIniPanelShellWorkflowOverviewReleaseReadinessArtifactDomContract,
+  createIniPanelShellWorkflowOverviewReleaseReadinessArtifactDomReadiness,
+  renderIniPanelShellWorkflowOverviewReleaseReadinessArtifactState,
+  mountIniPanelShellWorkflowOverviewReleaseReadinessArtifactState,
+  renderIniPanelShellSessionHandoffWorkflowState,
+  mountIniPanelShellSessionHandoffWorkflow,
+  renderIniPanelShellSessionHandoffMountState,
+  createIniPanelShellSessionHandoffPackageReport,
+  createIniPanelShellSessionHandoffPackageRenderState,
+  createIniPanelShellSessionHandoffPackageSchema,
+  createIniPanelShellSessionHandoffRenderState,
+  createIniPanelShellSessionHandoffSnapshot,
+  createIniPanelShellSessionHandoffSummary,
+  createIniPanelShellSessionHandoffSummarySchema,
+  createIniPanelShellViewModel,
+  getIniPanelEntryByHref,
+  getVisibleIniPanelEntries,
+  createMachineSessionPersistenceDisplayViewModel,
+  createMachineSessionPersistenceRenderState,
+  createMachineSessionPersistenceSummary,
+  createMachineSessionControlPageController,
+  createMachineSessionReadonlyStatus,
+  createMachineSessionReadonlyStatusApiManifest,
+  createMachineSessionReadinessFieldState,
+  machineSessionReadinessLogLines,
+  readMachineSessionReadinessWorkflow,
+  readMachineSessionReadonlyStatus,
+  loadMachineSessionForControlPageWorkflow,
+  createControlPageSessionLoadState,
+  refreshMachineSessionControlPage,
+  controlPageStatusText,
+  renderMachineSessionControlView,
+  isSupportedIniPanelControlPageApiManifest,
+  isSupportedIniPanelLaunchApiManifest,
+  isSupportedIniPanelShellIntegrationManifest,
+  isSupportedIniPanelShellSessionHandoffPackage,
+  isSupportedIniPanelShellSessionHandoffSummary,
+} from "../runtime/ui/ini-panel/ui-shell.js";
+```
+
+`ui-shell.js` re-exports the entry manifest, the read-only control-page
+controller, the unified read-only status API, the readonly-status API manifest,
+and the control-view renderer. It does not implement CNC behavior.
+
+## Pages
+
+| Page | Path | Role |
+| --- | --- | --- |
+| Launch | `runtime/ui/ini-panel/launch.html` | Read-only entry page for available panel surfaces. |
+| Edit and run | `runtime/ui/ini-panel/index.html` | Editable INI panel and existing run workflow surface. |
+| Read-only control view | `runtime/ui/ini-panel/control-page.html` | Read-only control view backed by the panel API. |
+| Workflow overview | `runtime/ui/ini-panel/workflow-overview.html` | Read-only shell handoff workflow overview surface. |
+
+## Visible Entries
+
+The visible launch entries come from `getVisibleIniPanelEntries()`:
+
+| Entry id | Href | Title |
+| --- | --- | --- |
+| `edit-run` | `./index.html` | Open edit and run panel |
+| `control-view` | `./control-page.html` | Open read-only control view |
+| `workflow-overview` | `./workflow-overview.html` | Open shell handoff overview |
+
+Launcher pages can render links from `createIniPanelLauncherLinkViewModel()`
+without reading manifest field names directly. Each item has `entryId`, `href`,
+and `label`.
+
+Outer shells can call `createIniPanelShellViewModel()` when they need one
+read-only model with `pages`, `launcherLinks`, and `controlPage` helpers for
+mounting the existing control-page controller, refresh workflow, and renderer.
+Use `controlPage.readStatus` or `readMachineSessionReadonlyStatus()` when an
+outer shell needs one stable read of `stateBundle`, `workflowStatus`,
+`overview`, `controlView`, `sessionReadiness`, `session`, `runReadiness`, and
+`run`.
+Use `createMachineSessionReadonlyStatusApiManifest()` or
+`controlPage.readonlyStatusApiManifest` when you only need the API shape and
+method names.
+Use `readMachineSessionReadinessWorkflow()` when an outer shell or panel flow
+needs a read-only `ready`/`blocked` readiness report before loading a machine
+session into WASM. `createMachineSessionReadinessFieldState()` and
+`machineSessionReadinessLogLines()` turn that report into stable fields and
+status text without parsing G-code or executing LinuxCNC behavior.
+Use `createMachineSessionPersistenceSummary()` or
+`linuxCncIniPanelApi.getMachineSessionPersistenceSummary()` when a browser
+panel or outer shell needs one read-only OPFS/session persistence summary with
+machine-file, session snapshot, session readiness, session load, readonly
+status, and handoff readiness rows. The launch page exposes the same helper as
+`linuxCncIniPanelLaunchApi.getMachineSessionPersistenceSummary()`, and the
+workflow overview page exposes it as
+`linuxCncIniPanelWorkflowOverviewApi.getWorkflowOverviewPersistenceSummary()`.
+Use `validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson()` or
+`linuxCncIniPanelWorkflowOverviewApi.validateWorkflowOverviewReleaseReadinessArtifactJson()`
+when an outer shell needs to validate a project release readiness artifact JSON
+through the same read-only workflow overview surface. It parses the artifact,
+returns stable validation rows, and does not execute release gates or CNC
+behavior.
+Use `runIniPanelShellWorkflowOverviewReleaseReadinessArtifactJsonWorkflow()` or
+`linuxCncIniPanelWorkflowOverviewApi.runWorkflowOverviewReleaseReadinessArtifactJsonWorkflow()`
+when the shell already has artifact JSON and needs parse, validation, summary,
+action-plan, and gate execution summary output in one workflow result.
+Use `createIniPanelShellWorkflowOverviewReleaseReadinessArtifactGateExecutionSummaryViewModel()` or
+`linuxCncIniPanelWorkflowOverviewApi.getWorkflowOverviewReleaseReadinessArtifactGateExecutionSummaryViewModel()`
+when the shell needs the artifact's release gate execution summary rows.
+Use `createIniPanelShellWorkflowOverviewReleaseReadinessArtifactGateExecutionSummaryRenderState()`,
+`createIniPanelShellWorkflowOverviewReleaseReadinessArtifactGateExecutionSummaryDomContract()`,
+`createIniPanelShellWorkflowOverviewReleaseReadinessArtifactGateExecutionSummaryDomReadiness()`,
+`renderIniPanelShellWorkflowOverviewReleaseReadinessArtifactGateExecutionSummaryState()`, or
+`mountIniPanelShellWorkflowOverviewReleaseReadinessArtifactGateExecutionSummaryState()` when the
+shell needs to render those per-gate rows into caller-owned DOM.
+Use `createIniPanelShellWorkflowOverviewReleaseReadinessArtifactJsonWorkflowSummaryViewModel()` or
+`linuxCncIniPanelWorkflowOverviewApi.getWorkflowOverviewReleaseReadinessArtifactJsonWorkflowSummaryViewModel()`
+when the shell needs stable status text and rows for that JSON workflow.
+Use `createIniPanelShellWorkflowOverviewReleaseReadinessArtifactJsonWorkflowActionPlan()` or
+`linuxCncIniPanelWorkflowOverviewApi.getWorkflowOverviewReleaseReadinessArtifactJsonWorkflowActionPlan()`
+when the shell needs the JSON workflow next-command plan without inspecting
+internal workflow fields.
+Use `createIniPanelShellWorkflowOverviewReleaseReadinessArtifactJsonWorkflowDomContract()`,
+`createIniPanelShellWorkflowOverviewReleaseReadinessArtifactJsonWorkflowDomReadiness()`,
+`renderIniPanelShellWorkflowOverviewReleaseReadinessArtifactJsonWorkflowState()`, or
+`mountIniPanelShellWorkflowOverviewReleaseReadinessArtifactJsonWorkflowState()` when the
+shell needs to render that JSON workflow state into caller-owned DOM.
+Use `loadIniPanelShellWorkflowOverviewReleaseReadinessArtifactUrl()` or
+`linuxCncIniPanelWorkflowOverviewApi.loadWorkflowOverviewReleaseReadinessArtifactUrl()`
+when the shell should fetch the artifact JSON URL, validate it, and optionally
+mount the render-state into caller-owned DOM without executing gates. The URL
+workflow result includes `validationSummaryViewModel` so callers can show
+stable validation status and rows from the same fetch.
+Use `createIniPanelShellWorkflowOverviewReleaseReadinessArtifactUrlWorkflowSummaryViewModel()` or
+`linuxCncIniPanelWorkflowOverviewApi.getWorkflowOverviewReleaseReadinessArtifactUrlWorkflowSummaryViewModel()`
+when the shell needs one stable status line and dashboard rows for the whole
+artifact URL fetch/validate/render/mount workflow.
+Use `createIniPanelShellWorkflowOverviewReleaseReadinessArtifactUrlWorkflowRenderState()`,
+`createIniPanelShellWorkflowOverviewReleaseReadinessArtifactUrlWorkflowDomContract()`,
+`createIniPanelShellWorkflowOverviewReleaseReadinessArtifactUrlWorkflowDomReadiness()`,
+`renderIniPanelShellWorkflowOverviewReleaseReadinessArtifactUrlWorkflowState()`, or
+`mountIniPanelShellWorkflowOverviewReleaseReadinessArtifactUrlWorkflowState()` when the
+shell needs to render that URL workflow state into caller-owned DOM.
+Use `createIniPanelShellWorkflowOverviewReleaseReadinessArtifactUrlWorkflowActionPlan()` or
+`linuxCncIniPanelWorkflowOverviewApi.getWorkflowOverviewReleaseReadinessArtifactUrlWorkflowActionPlan()`
+when the shell needs the ordered next-action/next-command plan for that URL
+workflow without executing release gates.
+Use `createIniPanelShellWorkflowOverviewReleaseReadinessArtifactValidationSummaryViewModel()` or
+`linuxCncIniPanelWorkflowOverviewApi.getWorkflowOverviewReleaseReadinessArtifactValidationSummaryViewModel()`
+when the shell needs stable artifact validation status text and dashboard rows
+without interpreting validation flags itself.
+Use `createIniPanelShellWorkflowOverviewReleaseReadinessArtifactValidationActionPlan()` or
+`linuxCncIniPanelWorkflowOverviewApi.getWorkflowOverviewReleaseReadinessArtifactValidationActionPlan()`
+when direct artifact JSON validation needs its own ordered next-command plan
+without executing release gates.
+Use `createIniPanelShellWorkflowOverviewReleaseReadinessArtifactValidationActionPlanRenderState()`,
+`createIniPanelShellWorkflowOverviewReleaseReadinessArtifactValidationActionPlanDomContract()`,
+`createIniPanelShellWorkflowOverviewReleaseReadinessArtifactValidationActionPlanDomReadiness()`,
+`renderIniPanelShellWorkflowOverviewReleaseReadinessArtifactValidationActionPlanState()`, or
+`mountIniPanelShellWorkflowOverviewReleaseReadinessArtifactValidationActionPlanState()` when the
+shell needs to render that validation action plan into caller-owned DOM.
+Use `createIniPanelShellWorkflowOverviewReleaseReadinessArtifactDisplayViewModel()`,
+`createIniPanelShellWorkflowOverviewReleaseReadinessArtifactRenderState()`,
+`createIniPanelShellWorkflowOverviewReleaseReadinessArtifactDomContract()`,
+`createIniPanelShellWorkflowOverviewReleaseReadinessArtifactDomReadiness()`,
+`renderIniPanelShellWorkflowOverviewReleaseReadinessArtifactState()`, or
+`mountIniPanelShellWorkflowOverviewReleaseReadinessArtifactState()` when that
+validation needs to be rendered into caller-owned DOM. The workflow overview
+page exposes equivalent methods with the `getWorkflowOverview...`,
+`renderWorkflowOverview...`, and `mountWorkflowOverview...` prefixes.
+Use `createMachineSessionPersistenceDisplayViewModel()` and
+`createMachineSessionPersistenceRenderState()` when that summary needs stable
+display text, rows, status line, and dataset fields for caller-owned DOM.
+Use `createIniPanelShellControlPageContract()` or `controlPage.contract` when
+an outer shell needs a fast contract check for `createController`,
+`loadSessionState`, `readStatus`, `refresh`, `renderView`, the readonly status
+manifest, and its status fields before mounting the embedded panel. The
+contract lists readonly status fields for `stateBundle`, `workflowStatus`,
+`overview`, `controlView`, `report`, `runReadiness`, `run`, `session`, and
+`status`.
+The browser control page also exposes this contract through
+`linuxCncIniPanelControlPageApi.getControlPageContract()`, so real iframe-based
+smokes can verify the same API shape before reading the embedded panel state.
+Use `linuxCncIniPanelControlPageApi.getControlPageApiMethods()` when a browser
+outer page needs the exact exposed method list before calling the read-only
+control page API.
+Use `createControlPageBrowserApiSchema()`,
+`createControlPageBrowserApiManifest()`, or
+`linuxCncIniPanelControlPageApi.getControlPageApiSchema()` and
+`linuxCncIniPanelControlPageApi.getControlPageApiManifest()` when a browser
+outer page needs a versioned control-page API description before reading the
+embedded panel. Use `isSupportedIniPanelControlPageApiManifest()` or
+`linuxCncIniPanelControlPageApi.isSupportedControlPageApiManifest()` for a
+read-only compatibility predicate before consuming that manifest.
+Use `linuxCncIniPanelControlPageApi.readControlPageStatus()` when a browser
+outer page needs the same readonly status snapshot from the real embedded
+control page after save/load session workflows.
+The launch page exposes `linuxCncIniPanelLaunchApi.getControlPageApiMethods()`
+from the same shell view-model so entry pages can consume the available
+read-only control-page API list without loading the control-page iframe first.
+Use `createIniPanelLaunchApiManifest()` or
+`linuxCncIniPanelLaunchApi.getLaunchApiManifest()` when an outer shell needs a
+single read-only description of launch methods, visible entries, target pages,
+the control-page browser API methods, and OPFS/session persistence capabilities
+for machine files, session snapshots, and read-only status.
+Use `createIniPanelLaunchApiSchema()`,
+`linuxCncIniPanelLaunchApi.getLaunchApiSchema()`, or `manifestVersion` when an
+outer shell needs to check launch manifest compatibility before consuming these
+fields.
+Use `isSupportedIniPanelLaunchApiManifest()` or
+`linuxCncIniPanelLaunchApi.isSupportedLaunchApiManifest()` for a read-only
+compatibility predicate before using a launch manifest.
+Use `createIniPanelShellIntegrationSchema()`,
+`createIniPanelShellIntegrationManifest()`,
+`linuxCncIniPanelLaunchApi.getShellIntegrationSchema()`, or
+`linuxCncIniPanelLaunchApi.getShellIntegrationManifest()` when an outer shell
+needs one versioned read of pages, launcher links, launch API metadata,
+control-page API metadata, OPFS/session persistence capabilities, and current
+compatibility status. Use `isSupportedIniPanelShellIntegrationManifest()` when
+the outer shell needs to check that integration manifest before consuming it.
+Use `createIniPanelShellIntegrationReadiness()` or
+`linuxCncIniPanelLaunchApi.getShellIntegrationReadiness()` when the outer shell
+needs a read-only `ready`/`blocked` status, failed check names, API names, and
+counts for pages, methods, and persistence capabilities before mounting any
+embedded control page.
+Use `createIniPanelShellIntegrationWorkflowPlan()` when the outer shell needs a
+Node-testable read-only plan for the control-page target, required launch and
+control-page API methods, readiness gate, and readonly status handoff fields
+before opening a browser frame.
+Use `createIniPanelShellSessionHandoffSummary()` when the outer shell needs one
+read-only display summary of readiness, target page, persistence capabilities,
+readonly status fields, handoff methods, and blocking reasons. Browser shells
+can read the same summary through
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffSummary()`.
+Use `createIniPanelShellSessionHandoffSummarySchema()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffSummarySchema()` for the
+versioned summary shape, and `isSupportedIniPanelShellSessionHandoffSummary()`
+or `linuxCncIniPanelLaunchApi.isSupportedShellSessionHandoffSummary()` before
+consuming a summary from a browser shell.
+Use `createIniPanelShellSessionHandoffCompatibilityReport()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffCompatibilityReport()` when an
+outer shell needs display-ready diagnostics for schema support, missing fields,
+api/version mismatches, and current blocking reasons before consuming the
+handoff summary.
+Use `createIniPanelShellSessionHandoffDisplayViewModel()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffDisplayViewModel()` when an
+outer shell needs the same diagnostics as stable read-only label/value rows for
+DOM display.
+Use `createIniPanelShellSessionHandoffSnapshot()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffSnapshot()` when an outer shell
+needs one read-only API read that includes readiness, handoff summary,
+compatibility report, and display view-model together.
+Use `createIniPanelShellSessionHandoffRenderState()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffRenderState()` when an outer
+shell needs the snapshot compressed into launch-side DOM state with a status
+line, stable rows, and `[data-handoff-shell]` phase/readiness flags. The launch
+page renders `[data-handoff-status]` and `[data-handoff-rows]` from this helper
+without adding control actions.
+Use `createIniPanelShellSessionHandoffActionPlan()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffActionPlan()` when an outer
+shell needs a read-only next-step description derived from the same snapshot:
+target page, required readonly methods, blocking reasons, display rows, and
+ready/blocked next step ids. The action plan describes what an outer shell can
+do next; it does not execute actions or add controls.
+Use `createIniPanelShellSessionHandoffChecklist()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffChecklist()` when an outer
+shell needs the same handoff state as stable health rows for display: render
+state, target page, load-session method, read-status method, blocking reasons,
+display rows, and next step ids. The checklist is read-only and does not
+execute the action plan.
+Use `createIniPanelShellSessionHandoffPackage()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffPackage()` when an outer shell
+needs one browser API read containing the launch/control method manifests,
+snapshot, render-state, action-plan, and checklist. The package is a read-only
+handoff artifact and does not execute action-plan steps.
+Use `createIniPanelShellSessionHandoffPackageSchema()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffPackageSchema()` for the
+versioned package shape, and `isSupportedIniPanelShellSessionHandoffPackage()`
+or `linuxCncIniPanelLaunchApi.isSupportedShellSessionHandoffPackage()` before
+consuming a package from a browser shell.
+Use `createIniPanelShellSessionHandoffPackageReport()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffPackageReport()` when an outer
+shell needs display-ready diagnostics for package schema support, missing
+package fields, missing manifest fields, api/version mismatches, and checklist
+blocking reasons.
+Use `createIniPanelShellSessionHandoffPackageDisplayViewModel()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffPackageDisplayViewModel()`
+when an outer shell needs the package report compressed into stable read-only
+label/value rows for DOM display.
+Use `createIniPanelShellSessionHandoffPackageRenderState()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffPackageRenderState()` when an
+outer shell needs the package display view-model compressed into launch-side
+DOM state. The launch page renders `[data-handoff-status]` and
+`[data-handoff-rows]` from the package render-state so the first page shows
+package-level schema/report status.
+Use `createIniPanelShellSessionHandoffPackageMountState()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffPackageMountState()` when an
+outer shell needs one read-only mount-state that combines package render-state,
+the control-page target, required readonly methods, and the current
+control-page session readiness snapshot.
+Use `createIniPanelShellSessionHandoffPackageMountDisplayViewModel()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffPackageMountDisplayViewModel()`
+when an outer shell needs mount-state checks as stable read-only label/value
+rows. Use `createIniPanelShellSessionHandoffPackageMountRenderState()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffPackageMountRenderState()`
+when those rows need a status line and `[data-handoff-shell]` style dataset
+flags for DOM rendering. Use
+`createIniPanelShellSessionHandoffMountDomContract()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffMountDomContract()` when an
+outer shell needs the required mount/status/rows selectors, mount dataset keys,
+row dataset keys, and render-result fields before rendering into shell-owned
+DOM. Use `createIniPanelShellSessionHandoffMountDomReadiness()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffMountDomReadiness()` to check
+that the required document and nodes exist before calling the renderer. Use
+`mountIniPanelShellSessionHandoff()` or
+`linuxCncIniPanelLaunchApi.mountShellSessionHandoff()` when an outer shell
+needs one browser-side workflow result containing the contract, DOM readiness,
+mount render-state, renderer result, and any mount error as data. Use
+`mountIniPanelShellSessionHandoffFromControlPage()` or
+`linuxCncIniPanelLaunchApi.mountShellSessionHandoffFromControlPage()` when an
+outer shell has a control-page API or already-observed session-load state and
+needs one read-only result containing the derived mount-state, mount display
+view-model, mount render-state, and DOM mount workflow result. Use
+`readIniPanelShellSessionHandoffStatusFromControlPage()` or
+`linuxCncIniPanelLaunchApi.readShellSessionHandoffStatusFromControlPage()`
+when an outer shell needs to read the control-page readonly status and verify
+the expected handoff status fields as a structured ready/blocked result. Use
+`createIniPanelShellSessionHandoffWorkflowSummary()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffWorkflowSummary()` when an
+outer shell needs one stable end-to-end summary that combines mount workflow,
+control-page mount workflow, readonly status result, machine-session
+ready/blocked state, and current blocking reasons into display rows. Use
+`createIniPanelShellSessionReadinessWorkflowReport()` or
+`linuxCncIniPanelLaunchApi.getShellSessionReadinessWorkflowReport()` when an
+outer shell needs a machine-readable report for just the session readiness
+phase, missing reasons, and stable rows. The workflow overview page exposes
+the same report through
+`linuxCncIniPanelWorkflowOverviewApi.getWorkflowOverviewSessionReadinessReport()`.
+Use `createIniPanelShellApiSurfaceInventory()` or
+`linuxCncIniPanelLaunchApi.getShellApiSurfaceInventory()` when an outer shell
+needs a machine-readable inventory of launch, control-page, workflow overview,
+persistence capabilities, session readiness report rows, and persistence
+summary rows. The workflow overview page exposes the same inventory through
+`linuxCncIniPanelWorkflowOverviewApi.getWorkflowOverviewApiSurfaceInventory()`.
+When provided to `createIniPanelShellSessionHandoffWorkflowSummary()`, the
+inventory is also rendered as the read-only `api-surface-inventory` workflow
+summary row for browser overview pages and external shells. The same workflow
+summary accepts `persistenceSummary` from
+`createMachineSessionPersistenceSummary()` and renders it as the
+`persistence-summary` row, so a shell overview can show API coverage and
+OPFS/session persistence state together.
+Use
+`createIniPanelShellSessionHandoffWorkflowDisplayViewModel()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffWorkflowDisplayViewModel()`
+when an outer shell needs that end-to-end summary compressed into stable
+`title`, `statusText`, `detailText`, and rows for direct display. Use
+`createIniPanelShellSessionHandoffWorkflowRenderState()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffWorkflowRenderState()` when an
+outer shell needs that workflow display-model compressed into stable
+`dataset`, `statusLine`, and rows for direct DOM rendering. Use
+`createIniPanelShellSessionHandoffWorkflowDomContract()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffWorkflowDomContract()` when an
+outer shell needs the required workflow mount/status/rows selectors, mount
+dataset keys, and row dataset keys before rendering workflow overview DOM. Use
+`createIniPanelShellSessionHandoffWorkflowDomReadiness()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffWorkflowDomReadiness()` to
+check that those workflow DOM nodes exist before rendering. Use
+`renderIniPanelShellSessionHandoffWorkflowState()` or
+`linuxCncIniPanelLaunchApi.renderShellSessionHandoffWorkflowState()` when an
+outer shell needs the shared read-only DOM renderer for workflow overview rows.
+Use `mountIniPanelShellSessionHandoffWorkflow()` or
+`linuxCncIniPanelLaunchApi.mountShellSessionHandoffWorkflow()` when an outer
+shell needs one structured workflow DOM mount result containing contract,
+readiness, render-state, render result, and any mount error as data. Use
+`createIniPanelShellWorkflowOverviewContract()` or
+`linuxCncIniPanelLaunchApi.getWorkflowOverviewContract()` when an outer shell
+needs the `workflow-overview.html` page href, browser API namespace, and method
+names before embedding that page. Use
+`createIniPanelShellWorkflowOverviewReadiness()` or
+`linuxCncIniPanelLaunchApi.getWorkflowOverviewReadiness()` to check whether a
+loaded workflow overview iframe exposes the expected read-only API. Use
+`mountIniPanelShellWorkflowOverviewEmbedding()` or
+`linuxCncIniPanelLaunchApi.mountWorkflowOverviewEmbedding()` when an outer
+shell needs one structured embedding result containing contract readiness,
+render-state, workflow overview mount result, and any mount error as data. The
+workflow overview page also exposes
+`linuxCncIniPanelWorkflowOverviewApi.mountWorkflowOverviewEmbedding()` for the
+same read-only embedding path from inside the iframe. Use
+`createIniPanelShellWorkflowOverviewEmbeddingReport()` or
+`linuxCncIniPanelLaunchApi.getWorkflowOverviewEmbeddingReport()` when an outer
+shell needs display-ready diagnostics for overview API readiness, missing
+methods, embedding readiness, mount phase, render row count, and embedding
+errors. The workflow overview page also exposes
+`linuxCncIniPanelWorkflowOverviewApi.getWorkflowOverviewEmbeddingReport()` for
+the same report shape. Use
+`createIniPanelShellWorkflowOverviewEmbeddingDisplayViewModel()` or
+`linuxCncIniPanelLaunchApi.getWorkflowOverviewEmbeddingDisplayViewModel()` when
+an outer shell needs that report compressed into stable `title`, `statusText`,
+`detailText`, and read-only label/value rows for direct rendering. The workflow
+overview page also exposes
+`linuxCncIniPanelWorkflowOverviewApi.getWorkflowOverviewEmbeddingDisplayViewModel()`.
+Use `createIniPanelShellWorkflowOverviewEmbeddingRenderState()` or
+`linuxCncIniPanelLaunchApi.getWorkflowOverviewEmbeddingRenderState()` when an
+outer shell needs that display view-model compressed into stable `statusLine`,
+`dataset`, and rows for a shared DOM renderer. The workflow overview page also
+exposes `linuxCncIniPanelWorkflowOverviewApi.getWorkflowOverviewEmbeddingRenderState()`.
+Use `createIniPanelShellWorkflowOverviewEmbeddingDomContract()` or
+`linuxCncIniPanelLaunchApi.getWorkflowOverviewEmbeddingDomContract()` when an
+outer shell needs the required embedding report mount/status/rows selectors,
+mount dataset keys, row dataset keys, and render-result fields before adding a
+DOM renderer. The workflow overview page also exposes
+`linuxCncIniPanelWorkflowOverviewApi.getWorkflowOverviewEmbeddingDomContract()`.
+Use `createIniPanelShellWorkflowOverviewEmbeddingDomReadiness()` or
+`linuxCncIniPanelLaunchApi.getWorkflowOverviewEmbeddingDomReadiness()` to check
+that the required document and embedding report DOM nodes exist before calling
+a renderer. The workflow overview page also exposes
+`linuxCncIniPanelWorkflowOverviewApi.getWorkflowOverviewEmbeddingDomReadiness()`.
+Use `renderIniPanelShellWorkflowOverviewEmbeddingState()` or
+`linuxCncIniPanelLaunchApi.renderWorkflowOverviewEmbeddingState()` when an
+outer shell needs to render an embedding report render-state into existing
+mount/status/rows nodes and receive a structured read-only render result. The
+workflow overview page also exposes
+`linuxCncIniPanelWorkflowOverviewApi.renderWorkflowOverviewEmbeddingState()`.
+Use `mountIniPanelShellWorkflowOverviewEmbeddingState()` or
+`linuxCncIniPanelLaunchApi.mountWorkflowOverviewEmbeddingState()` when an outer
+shell needs a non-throwing workflow result that combines embedding DOM
+readiness, render-state, render result, and any render error as structured
+data. The workflow overview page also exposes
+`linuxCncIniPanelWorkflowOverviewApi.mountWorkflowOverviewEmbeddingState()`.
+Use `createIniPanelShellWorkflowOverviewEmbeddingMountDisplayViewModel()` or
+`linuxCncIniPanelLaunchApi.getWorkflowOverviewEmbeddingMountDisplayViewModel()`
+when an outer shell needs that mount workflow result compressed into stable
+`title`, `statusText`, `detailText`, and read-only label/value rows. The
+workflow overview page also exposes
+`linuxCncIniPanelWorkflowOverviewApi.getWorkflowOverviewEmbeddingMountDisplayViewModel()`.
+Use `createIniPanelShellWorkflowOverviewEmbeddingMountRenderState()` or
+`linuxCncIniPanelLaunchApi.getWorkflowOverviewEmbeddingMountRenderState()` when
+an outer shell needs that mount display view-model compressed into stable
+`statusLine`, `dataset`, and rows for a shared DOM renderer. The workflow
+overview page also exposes
+`linuxCncIniPanelWorkflowOverviewApi.getWorkflowOverviewEmbeddingMountRenderState()`.
+Use `createIniPanelShellWorkflowOverviewEmbeddingMountDomContract()` or
+`linuxCncIniPanelLaunchApi.getWorkflowOverviewEmbeddingMountDomContract()` when
+an outer shell needs the required mount/status/rows selectors, mount dataset
+keys, row dataset keys, and render-result fields before rendering the mount
+render-state. The workflow overview page also exposes
+`linuxCncIniPanelWorkflowOverviewApi.getWorkflowOverviewEmbeddingMountDomContract()`.
+Use `createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness()` or
+`linuxCncIniPanelLaunchApi.getWorkflowOverviewEmbeddingMountDomReadiness()` to
+check that the required document and mount render-state DOM nodes exist before
+calling a renderer. The workflow overview page also exposes
+`linuxCncIniPanelWorkflowOverviewApi.getWorkflowOverviewEmbeddingMountDomReadiness()`.
+Use `renderIniPanelShellWorkflowOverviewEmbeddingMountState()` or
+`linuxCncIniPanelLaunchApi.renderWorkflowOverviewEmbeddingMountState()` when an
+outer shell needs to render a mount render-state into existing mount/status/rows
+nodes and receive a structured read-only render result. The workflow overview
+page also exposes
+`linuxCncIniPanelWorkflowOverviewApi.renderWorkflowOverviewEmbeddingMountState()`.
+Use `mountIniPanelShellWorkflowOverviewEmbeddingMountState()` or
+`linuxCncIniPanelLaunchApi.mountWorkflowOverviewEmbeddingMountState()` when an
+outer shell needs a non-throwing mount workflow result for the mount render-state
+DOM. The workflow overview page also exposes
+`linuxCncIniPanelWorkflowOverviewApi.mountWorkflowOverviewEmbeddingMountState()`.
+Use
+`renderIniPanelShellSessionHandoffMountState()` or
+`linuxCncIniPanelLaunchApi.renderShellSessionHandoffMountState()` when an outer
+shell needs the shared read-only DOM renderer for those rows. The launch page
+renders the default waiting mount state into `[data-handoff-mount]`,
+`[data-handoff-mount-status]`, and `[data-handoff-mount-rows]` without opening
+the control page. The launch page also renders a default workflow overview into
+`[data-handoff-workflow]`, `[data-handoff-workflow-status]`, and
+`[data-handoff-workflow-rows]`.
+The browser workflow smoke
+`tests/browser/ini_panel_shell_integration_workflow_smoke.html` verifies the
+same external shell handoff: read integration manifest, pass readiness gate,
+open the control page target, mount waiting and ready mount-state into an
+external shell-owned `[data-external-shell-mount]` DOM region through the shared
+mount workflows, then read and validate readonly machine-session status through
+the shared status workflow.
+
+The control-page refresh workflow lives in
+`runtime/ui/ini-panel/control-page-refresh-workflow.js`. Use
+`refreshMachineSessionControlPage()` when an outer shell needs a structured
+refresh result with `phase`, `statusText`, `view`, `renderResult`, and `error`.
+`controlPageStatusText()` formats the already-observed panel status fields for
+the read-only status line, and `createControlPageRefreshState()` is the stable
+state-shape helper used by the workflow.
+
+The control-page session workflow lives in
+`runtime/ui/ini-panel/control-page-session-workflow.js`. Use
+`loadMachineSessionForControlPageWorkflow()` when an outer shell needs a
+read-only readiness snapshot for the embedded panel API, machine-session
+ready/blocked state, and first control view.
+`createControlPageSessionLoadState()` is the stable state-shape helper for
+`waiting-panel`, `waiting-api`, `waiting-session`, `ready`, and `error` phases.
+
+## Boundary
+
+The entry shell only links pages and renders already-observed panel state. It
+does not parse G-code, infer canonical events, or implement LinuxCNC-owned
+tool, parameter, planner, or kinematics behavior.
+
+Release validation for this surface is covered by `verify_ui_node_smokes.sh`,
+`verify_ini_panel_browser.sh`, and the project handoff docs smoke
+`verify_project_release_handoff_docs.sh`.

wasm-port/docs/porting-steps-standalone.md

@@ -830,6 +830,18 @@ Current five-axis switchkins status:
    subroutines, then call vendored `Interp::parse_remap()`, `open()`,
    `read()`, and `execute()`; standalone code only supplies the INI/file path
    boundary.
+10. Independent kinematics WASM modules now cover the vendored LinuxCNC
+    kinematics set: `trivkins`, `5axiskins`, `xyzac-trt`, `xyzbc-trt`,
+    `corexy`, `rotate`, `rose`, `max`, `lineardelta`, `rotarydelta`,
+    `scorbot`, `tripod`, `scara`, `puma`, `genser`, `genhex`, and
+    `pentakins`. The modules compile vendored LinuxCNC
+    `src/emc/kinematics` sources plus required vendored posemath/gomath
+    sources, expose a small `lckins_*` C ABI for `type`, `switchable`,
+    `switch`, `forward`, `inverse`, and `run_probe`, and are wrapped by
+    `createLinuxCncKinematicsSdk()`. The ABI preserves LinuxCNC's in/out
+    buffer behavior for iterative algorithms: callers may seed inverse joint
+    buffers and forward pose buffers, while all kinematics math remains in
+    vendored LinuxCNC source.
 
 Next work: