推进 INI 面板 machine session state snapshot helper

wasm-port/docs/ui-panel-state-summary.md

@@ -30,11 +30,45 @@ reading ad hoc DOM text.
 The returned snapshot preserves those nested objects and normalizes missing
 badge entries to `null`.
 
+## `createMachineSessionStateSnapshot(input)`
+
+This helper builds the richer state snapshot used by the INI panel and exposed
+as `window.linuxCncIniPanelMachineSessionState`.
+
+It preserves the base panel state and adds:
+
+```js
+{
+  selectedProgram: { source: "snapshot", opfsPath: "...", wasmPath: "..." },
+  fields: {
+    sessionIni: "/work/session-machine.ini",
+    sessionParameters: "/work/session-linuxcnc.var",
+    sessionToolTable: "/work/session-tool.tbl",
+    sessionGcode: "linuxcnc/gcode/ui-session.ngc",
+    sessionSnapshot: "ui-machine-session/ui-machine-session.json",
+    runStatus: "ok",
+    runSource: "snapshot",
+    runSnapshot: "ui-machine-session/ui-machine-session.json",
+    runWorkflow: "save-session-snapshot",
+    runOpfsPath: "linuxcnc/gcode/ui-session.ngc",
+    runWasmPath: "/work/ui-session.ngc"
+  },
+  lastAction: "run-gcode",
+  error: null
+}
+```
+
+The INI panel updates this state after save, restore, load, run, and error
+paths so browser tests and future API consumers can read one machine-readable
+state object instead of collecting DOM fields and log text.
+
 ## Boundary Rules
 
 - Do not parse G-code text in this helper.
 - Do not infer CNC semantics from the nested summaries.
 - Keep the helper as a bundling layer over already-observed UI boundary state.
+- Keep workflow result objects as host/runtime boundary facts; this helper must
+  not promote, reinterpret, or synthesize CNC behavior.
 
 ## Validation