公开 INI 面板 session readiness report SDK surface

wasm-port/docs/project-release-handoff.md

@@ -29,7 +29,9 @@ continuation records are in `../text14.txt`.
 - External shells should use the read-only helpers documented in
   `docs/panel-entry.md`, including workflow overview embedding mount DOM
   contract/readiness/renderer/wrapper helpers.
-- SDK callers should import stable helpers from `runtime/sdk/src/index.js`.
+- SDK callers should import stable helpers from `runtime/sdk/src/index.js`,
+  including `createIniPanelShellSessionReadinessWorkflowReport()` when they
+  need machine-readable session readiness phase and missing reasons.
 - OPFS/session persistence is host-side storage glue. Parameter and tool-table
   behavior still comes from the LinuxCNC-backed interpreter SDK calls.
 - Sim-config inventory promotion remains evidence-driven and must keep

wasm-port/runtime/sdk/README.md

@@ -25,6 +25,7 @@ Use `src/index.js` for stable imports:
 import {
   analyzeIniRuntimeBoundaries,
   createIniPanelLaunchApiManifest,
+  createIniPanelShellSessionReadinessWorkflowReport,
   createIniPanelShellViewModel,
   createIniPanelShellWorkflowOverviewEmbeddingMountDomContract,
   createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness,
@@ -191,6 +192,9 @@ for external browser shells:
   `isSupportedIniPanelLaunchApiManifest()` for launch API negotiation.
 - `createIniPanelShellViewModel()` for a complete read-only shell integration
   bundle.
+- `createIniPanelShellSessionReadinessWorkflowReport()` for a machine-readable
+  session readiness workflow report with phase, missing reasons, status line,
+  and stable rows.
 - `createIniPanelShellWorkflowOverviewEmbeddingMountDomContract()` and
   `createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness()` for
   workflow overview embedding mount DOM checks.

wasm-port/runtime/sdk/src/index.js

@@ -68,6 +68,7 @@ export {
   createIniPanelShellSessionHandoffPackageReport,
   createIniPanelShellSessionHandoffPackageRenderState,
   createIniPanelShellSessionHandoffPackageSchema,
+  createIniPanelShellSessionReadinessWorkflowReport,
   createIniPanelShellSessionHandoffSummary,
   createIniPanelShellSessionHandoffSummarySchema,
   createIniPanelShellViewModel,

wasm-port/tests/docs/node/verify_project_release_handoff_docs.mjs

@@ -31,6 +31,7 @@ for (const phrase of [
   "docs/drift-report.md",
   "PROJECT_COMPLETION_TRACKER.md",
   "runtime/sdk/src/index.js",
+  "createIniPanelShellSessionReadinessWorkflowReport()",
   "workflow overview embedding mount DOM",
   "verify_no_standalone_cnc_semantics.sh",
   "verify_host_smokes.sh",
@@ -80,6 +81,7 @@ for (const phrase of [
 for (const phrase of [
   "OPFS/session persistence exports",
   "INI panel shell handoff exports",
+  "createIniPanelShellSessionReadinessWorkflowReport()",
 ]) {
   assert.match(sdkReadmeText, literalRegExp(phrase));
 }

wasm-port/tests/sdk/node/verify_sdk_surface.mjs

@@ -6,6 +6,7 @@ import { fileURLToPath } from "node:url";
 import {
   analyzeIniRuntimeBoundaries,
   createIniPanelLaunchApiManifest,
+  createIniPanelShellSessionReadinessWorkflowReport,
   createIniPanelShellViewModel,
   createIniPanelShellWorkflowOverviewEmbeddingMountDomContract,
   createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness,
@@ -81,6 +82,7 @@ const requiredExports = [
   ["createIniPanelLaunchApiManifest", createIniPanelLaunchApiManifest],
   ["isSupportedIniPanelLaunchApiManifest", isSupportedIniPanelLaunchApiManifest],
   ["createIniPanelShellViewModel", createIniPanelShellViewModel],
+  ["createIniPanelShellSessionReadinessWorkflowReport", createIniPanelShellSessionReadinessWorkflowReport],
   [
     "createIniPanelShellWorkflowOverviewEmbeddingMountDomContract",
     createIniPanelShellWorkflowOverviewEmbeddingMountDomContract,
@@ -124,6 +126,14 @@ assert.equal(
   shellViewModel.launchApiManifest.methods.includes("mountWorkflowOverviewEmbeddingMountState"),
   true,
 );
+assert.equal(
+  shellViewModel.launchApiManifest.methods.includes("getShellSessionReadinessWorkflowReport"),
+  true,
+);
+assert.equal(
+  createIniPanelShellSessionReadinessWorkflowReport().apiName,
+  "ini-panel-shell-session-readiness-workflow-report",
+);
 assert.equal(
   shellViewModel.mountWorkflowOverviewEmbeddingMountState,
   mountIniPanelShellWorkflowOverviewEmbeddingMountState,