新增 OPFS session readiness SDK helper

wasm-port/tests/opfs/node/verify_file_service.mjs

@@ -43,6 +43,9 @@ import {
 import {
   loadMachineSessionFromOpfs,
 } from "../../../runtime/opfs/linuxcnc-machine-session-bridge.js";
+import {
+  readMachineSessionReadiness,
+} from "../../../runtime/opfs/machine-session-readiness.js";
 
 class MockFileHandle {
   constructor(name) {
@@ -420,6 +423,54 @@ assertGcodeProgramStoragePath(
 );
 assert.equal(await loadGcodeProgram("custom-fixture.ngc", { storage }), "G1 X1 F10\nM2\n");
 
+const readyMachineSession = await readMachineSessionReadiness("xyzab-tdr", {
+  storage,
+  sessionId: "machine-session-1",
+  snapshotFilename: "machine-session-snapshot.json",
+  gcodeFilename: "fixture.ngc",
+});
+assert.equal(readyMachineSession.ready, true);
+assert.equal(readyMachineSession.phase, "ready");
+assert.deepEqual(readyMachineSession.missing, []);
+assert.deepEqual(readyMachineSession.errors, []);
+assert.deepEqual(
+  readyMachineSession.checks.map((check) => [check.name, check.ok, check.path]),
+  [
+    ["ini", true, "linuxcnc/machines/xyzab-tdr/machine.ini"],
+    ["parameters", true, "linuxcnc/machines/xyzab-tdr/linuxcnc.var"],
+    ["toolTable", true, "linuxcnc/machines/xyzab-tdr/tool.tbl"],
+    ["gcode", true, "linuxcnc/gcode/fixture.ngc"],
+  ],
+);
+assert.deepEqual(readyMachineSession.snapshotCheck, {
+  name: "snapshot",
+  path: "linuxcnc/sessions/machine-session-1/machine-session-snapshot.json",
+  ok: true,
+  error: null,
+});
+assert.equal(readyMachineSession.snapshot.sessionId, "machine-session-1");
+
+const missingMachineSession = await readMachineSessionReadiness("missing-machine", {
+  storage,
+  sessionId: "missing-session",
+  gcodeRequired: true,
+  gcodeFilename: "missing.ngc",
+});
+assert.equal(missingMachineSession.ready, false);
+assert.equal(missingMachineSession.phase, "blocked");
+assert.deepEqual(missingMachineSession.missing, [
+  "ini",
+  "parameters",
+  "toolTable",
+  "gcode",
+  "snapshot",
+]);
+assert.deepEqual(
+  missingMachineSession.errors.map((error) => error.name),
+  ["ini", "parameters", "toolTable", "gcode", "snapshot"],
+);
+assert.match(missingMachineSession.errors[0].error, /missing directory|missing file/);
+
 const bridgeFiles = new Map();
 const bridgeInterp = {
   writeTextFile(path, text) {
@@ -897,6 +948,13 @@ await assert.rejects(
   () => loadGcodeProgram("../escape.ngc", { storage }),
   /Invalid G-code filename/,
 );
+await assert.rejects(
+  () => readMachineSessionReadiness("xyzab-tdr", {
+    storage,
+    gcodeOpfsPath: "../escape.ngc",
+  }),
+  /Invalid OPFS path/,
+);
 await assert.rejects(
   () => saveSessionSnapshot("session-1", {}, {
     storage,