推进 INI 面板 workflow overview embedding DOM readiness

text13.txt

@@ -1585,3 +1585,97 @@ host_wasm_opfs_browser_smokes=ok
 `createIniPanelShellWorkflowOverviewEmbeddingDomReadiness()` 或等价 helper，检查 embedding
 report DOM contract 需要的 document/mount/status/rows 节点是否存在，输出 missing/checks，
 为真实 DOM renderer 做最后前置 gate；仍保持只读，不新增控制按钮，不解析 G-code。
+
+十五、2026-06-15 继续执行记录：INI panel workflow overview embedding DOM readiness
+
+本轮按 `text13.txt` 执行，不扩展 `text12.txt`。继续推进 browser/UI workflow，新增只读
+workflow-overview embedding DOM readiness，检查 embedding report DOM contract 所需的
+document/mount/status/rows 节点是否存在，输出 missing/checks，为真实 DOM renderer 做最后
+前置 gate。
+
+完成内容：
+
+- `ui-shell.js` 新增 `createIniPanelShellWorkflowOverviewEmbeddingDomReadiness()`；
+- DOM readiness 输出：
+  - `apiName: "ini-panel-shell-workflow-overview-embedding-dom-readiness"`；
+  - `readinessVersion: 1`；
+  - `phase: "ready" | "blocked"`；
+  - `ready`；
+  - `missing`；
+  - `checks.document`；
+  - `checks.mount`；
+  - `checks.status`；
+  - `checks.rows`；
+  - `checks.rowDatasetPrefix`；
+  - `contract`；
+- 支持传入自定义 contract、documentRef、mountNode、statusNode、rowsNode；
+- `createIniPanelLaunchApiManifest().methods` 新增
+  `getWorkflowOverviewEmbeddingDomReadiness`；
+- `launch.html` 的 `window.linuxCncIniPanelLaunchApi` 新增真实 browser 入口
+  `getWorkflowOverviewEmbeddingDomReadiness()`；
+- `workflow-overview.html` 的 `window.linuxCncIniPanelWorkflowOverviewApi` 新增
+  `getWorkflowOverviewEmbeddingDomReadiness()`；
+- `verify_ini_panel_ui_shell.mjs` 覆盖 missing document/nodes 与 ready nodes 两种 shape；
+- `verify_ini_panel_launch_api_manifest.mjs` 覆盖 launch manifest 与 launch 页面真实 API；
+- `verify_ini_panel_shell_integration_manifest.mjs` 覆盖 helper export、默认 readiness、
+  launch method count 与文档记录；
+- `verify_ini_panel_entry_docs.mjs` 与 `docs/panel-entry.md` 同步记录新 helper/API；
+- `ini_panel_workflow_overview_smoke.html` 校验 workflow overview iframe 自身 DOM readiness API；
+- `ini_panel_launch_smoke.html` 校验真实 launch iframe 读取真实 workflow overview iframe 的
+  embedding DOM readiness；
+- `ini_panel_shell_integration_workflow_smoke.html` 校验外部 shell workflow 使用自定义 DOM
+  contract 与已有外部节点得到 ready readiness；
+- 未新增控制按钮；
+- 未执行 action-plan；
+- 未解析 G-code；
+- 未解释 canonical events；
+- 未新增 JS CNC 语义；
+- 未改变 OPFS/session persistence、LinuxCNC interpreter、tool、parameter、planner 或
+  LinuxCNC-owned runtime semantics。
+
+验证已通过：
+
+```bash
+git diff --check
+wasm-port/tests/ui/node/verify_ini_panel_ui_shell.sh
+wasm-port/tests/ui/node/verify_ini_panel_launch_api_manifest.sh
+wasm-port/tests/ui/node/verify_ini_panel_shell_integration_manifest.sh
+wasm-port/tests/ui/node/verify_ini_panel_entry_docs.sh
+wasm-port/tests/ui/node/verify_ui_node_smokes.sh
+SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_ini_panel_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
+ini_panel_ui_shell_node_smoke=ok
+ini_panel_launch_api_manifest_node_smoke=ok
+ini_panel_shell_integration_manifest_node_smoke=ok
+ini_panel_entry_docs_node_smoke=ok
+ui_node_smokes=ok
+browser_ini_opfs_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
+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/UI workflow。下一批建议新增只读
+`renderIniPanelShellWorkflowOverviewEmbeddingState()` 或等价 helper，使用 embedding render-state
+与 DOM readiness/contract 渲染 status 与 rows，并返回结构化 render result；仍保持只读，
+不新增控制按钮，不解析 G-code。

wasm-port/docs/panel-entry.md

@@ -45,6 +45,7 @@ import {
   createIniPanelShellWorkflowOverviewEmbeddingDisplayViewModel,
   createIniPanelShellWorkflowOverviewEmbeddingRenderState,
   createIniPanelShellWorkflowOverviewEmbeddingDomContract,
+  createIniPanelShellWorkflowOverviewEmbeddingDomReadiness,
   mountIniPanelShellWorkflowOverviewEmbedding,
   renderIniPanelShellSessionHandoffWorkflowState,
   mountIniPanelShellSessionHandoffWorkflow,
@@ -331,6 +332,11 @@ 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
 `renderIniPanelShellSessionHandoffMountState()` or
 `linuxCncIniPanelLaunchApi.renderShellSessionHandoffMountState()` when an outer

wasm-port/runtime/ui/ini-panel/launch.html

@@ -291,6 +291,9 @@
       getWorkflowOverviewEmbeddingDomContract: (options) => (
         shellViewModel.createWorkflowOverviewEmbeddingDomContract(options)
       ),
+      getWorkflowOverviewEmbeddingDomReadiness: (options) => (
+        shellViewModel.createWorkflowOverviewEmbeddingDomReadiness(options)
+      ),
       isSupportedShellSessionHandoffPackage: shellViewModel.isSupportedShellSessionHandoffPackage,
       getLauncherLinks: () => shellViewModel.launcherLinks,
       getControlPageApiMethods: () => shellViewModel.controlPage.browserApiMethods,

wasm-port/runtime/ui/ini-panel/ui-shell.js

@@ -163,6 +163,7 @@ export function createIniPanelLaunchApiManifest(entries = getVisibleIniPanelEntr
       "getWorkflowOverviewEmbeddingDisplayViewModel",
       "getWorkflowOverviewEmbeddingRenderState",
       "getWorkflowOverviewEmbeddingDomContract",
+      "getWorkflowOverviewEmbeddingDomReadiness",
       "isSupportedShellSessionHandoffPackage",
       "getLauncherLinks",
       "getControlPageApiMethods",
@@ -1969,6 +1970,37 @@ export function createIniPanelShellWorkflowOverviewEmbeddingDomContract({
   };
 }
 
+export function createIniPanelShellWorkflowOverviewEmbeddingDomReadiness({
+  rowDatasetPrefix = "workflowOverviewEmbedding",
+  contract = createIniPanelShellWorkflowOverviewEmbeddingDomContract({ rowDatasetPrefix }),
+  documentRef = globalThis.document,
+  mountNode = documentRef?.querySelector?.(contract.selectors.mount),
+  statusNode = documentRef?.querySelector?.(contract.selectors.status),
+  rowsNode = documentRef?.querySelector?.(contract.selectors.rows),
+} = {}) {
+  const checks = {
+    document: Boolean(documentRef?.createElement),
+    mount: Boolean(mountNode),
+    status: Boolean(statusNode),
+    rows: Boolean(rowsNode),
+    rowDatasetPrefix: Boolean(contract.rowDatasetPrefix),
+  };
+  const missing = Object.entries(checks)
+    .filter(([, passed]) => !passed)
+    .map(([name]) => name);
+  const ready = missing.length === 0;
+
+  return {
+    apiName: "ini-panel-shell-workflow-overview-embedding-dom-readiness",
+    readinessVersion: 1,
+    phase: ready ? "ready" : "blocked",
+    ready,
+    missing,
+    checks,
+    contract,
+  };
+}
+
 export function createIniPanelShellViewModel(entries = getVisibleIniPanelEntries()) {
   const shellIntegrationManifest = createIniPanelShellIntegrationManifest(entries);
   const shellIntegrationReadiness = createIniPanelShellIntegrationReadiness(shellIntegrationManifest);
@@ -2131,6 +2163,7 @@ export function createIniPanelShellViewModel(entries = getVisibleIniPanelEntries
     createWorkflowOverviewEmbeddingDisplayViewModel: createIniPanelShellWorkflowOverviewEmbeddingDisplayViewModel,
     createWorkflowOverviewEmbeddingRenderState: createIniPanelShellWorkflowOverviewEmbeddingRenderState,
     createWorkflowOverviewEmbeddingDomContract: createIniPanelShellWorkflowOverviewEmbeddingDomContract,
+    createWorkflowOverviewEmbeddingDomReadiness: createIniPanelShellWorkflowOverviewEmbeddingDomReadiness,
     isSupportedShellSessionHandoffPackage: isSupportedIniPanelShellSessionHandoffPackage,
     controlPage: {
       browserApiSchema: createControlPageBrowserApiSchema(),

wasm-port/runtime/ui/ini-panel/workflow-overview.html

@@ -93,6 +93,7 @@
       createIniPanelShellWorkflowOverviewEmbeddingDisplayViewModel,
       createIniPanelShellWorkflowOverviewEmbeddingRenderState,
       createIniPanelShellWorkflowOverviewEmbeddingDomContract,
+      createIniPanelShellWorkflowOverviewEmbeddingDomReadiness,
       mountIniPanelShellWorkflowOverviewEmbedding,
       renderIniPanelShellSessionHandoffWorkflowState,
       mountIniPanelShellSessionHandoffWorkflow,
@@ -147,6 +148,9 @@
       getWorkflowOverviewEmbeddingDomContract: (options) => (
         createIniPanelShellWorkflowOverviewEmbeddingDomContract(options)
       ),
+      getWorkflowOverviewEmbeddingDomReadiness: (options) => (
+        createIniPanelShellWorkflowOverviewEmbeddingDomReadiness(options ?? { documentRef: document })
+      ),
     };
   </script>
 </body>

wasm-port/tests/browser/ini_panel_launch_smoke.html

@@ -107,6 +107,7 @@
         !launchApi?.getWorkflowOverviewEmbeddingDisplayViewModel ||
         !launchApi?.getWorkflowOverviewEmbeddingRenderState ||
         !launchApi?.getWorkflowOverviewEmbeddingDomContract ||
+        !launchApi?.getWorkflowOverviewEmbeddingDomReadiness ||
         !launchApi?.isSupportedShellSessionHandoffPackage ||
         !launchApi?.getLauncherLinks ||
         !launchApi?.getControlPageApiMethods
@@ -635,7 +636,8 @@
         !workflowOverviewApi?.getWorkflowOverviewEmbeddingReport ||
         !workflowOverviewApi?.getWorkflowOverviewEmbeddingDisplayViewModel ||
         !workflowOverviewApi?.getWorkflowOverviewEmbeddingRenderState ||
-        !workflowOverviewApi?.getWorkflowOverviewEmbeddingDomContract
+        !workflowOverviewApi?.getWorkflowOverviewEmbeddingDomContract ||
+        !workflowOverviewApi?.getWorkflowOverviewEmbeddingDomReadiness
       ) {
         throw new Error("workflow overview API namespace did not expose shell helpers");
       }
@@ -655,6 +657,10 @@
         workflowOverviewEmbeddingDisplay,
       );
       const workflowOverviewEmbeddingDomContract = launchApi.getWorkflowOverviewEmbeddingDomContract();
+      const workflowOverviewEmbeddingDomReadiness = launchApi.getWorkflowOverviewEmbeddingDomReadiness({
+        documentRef: workflowOverviewDoc,
+        contract: workflowOverviewEmbeddingDomContract,
+      });
       assertEqual(workflowOverviewApi.getWorkflowOverviewContract().pageHref, "./workflow-overview.html", "workflow overview page contract");
       assertEqual(workflowOverviewReadiness.ready, true, "workflow overview readiness");
       assertEqual(workflowOverviewReadiness.missing.join(","), "", "workflow overview readiness missing");
@@ -677,10 +683,12 @@
       assertEqual(workflowOverviewEmbeddingRenderState.dataset.handoffScope, "workflow-overview-embedding", "workflow overview embedding render-state scope");
       assertEqual(workflowOverviewEmbeddingDomContract.selectors.mount, "[data-workflow-overview-embedding]", "workflow overview embedding DOM contract mount");
       assertEqual(workflowOverviewEmbeddingDomContract.rowDatasetKeys.detail[0], "workflowOverviewEmbeddingValue", "workflow overview embedding DOM contract row key");
+      assertEqual(workflowOverviewEmbeddingDomReadiness.ready, false, "workflow overview embedding DOM readiness");
+      assertEqual(workflowOverviewEmbeddingDomReadiness.missing.join(","), "mount,status,rows", "workflow overview embedding DOM readiness missing");
       assertEqual(
-        workflowOverviewApi.getWorkflowOverviewEmbeddingDomContract().selectors.mount,
+        workflowOverviewApi.getWorkflowOverviewEmbeddingDomReadiness().ready,
-        workflowOverviewEmbeddingDomContract.selectors.mount,
+        false,
-        "workflow overview self embedding DOM contract",
+        "workflow overview self embedding DOM readiness",
       );
       status.textContent = "browser_ini_launch_smoke=ok";
       console.log("browser_ini_launch_smoke=ok");

wasm-port/tests/browser/ini_panel_shell_integration_workflow_smoke.html

@@ -14,6 +14,10 @@
     <p data-external-shell-workflow-status>waiting</p>
     <dl data-external-shell-workflow-rows></dl>
   </section>
+  <section data-external-overview-embedding>
+    <p data-external-overview-embedding-status>waiting</p>
+    <dl data-external-overview-embedding-rows></dl>
+  </section>
   <script type="module">
     function assertEqual(actual, expected, label) {
       if (actual !== expected) {
@@ -109,6 +113,7 @@ TOOL_TABLE = browser-shell-tool.tbl
         !launchApi?.getWorkflowOverviewEmbeddingDisplayViewModel ||
         !launchApi?.getWorkflowOverviewEmbeddingRenderState ||
         !launchApi?.getWorkflowOverviewEmbeddingDomContract ||
+        !launchApi?.getWorkflowOverviewEmbeddingDomReadiness ||
         !launchApi?.isSupportedShellSessionHandoffPackage
       ) {
         throw new Error("launch API namespace did not expose shell integration helpers");
@@ -303,6 +308,15 @@ TOOL_TABLE = browser-shell-tool.tbl
       );
       const workflowOverviewEmbeddingDomContract = launchApi.getWorkflowOverviewEmbeddingDomContract({
         rowDatasetPrefix: "externalOverviewEmbedding",
+        selectors: {
+          mount: "[data-external-overview-embedding]",
+          status: "[data-external-overview-embedding-status]",
+          rows: "[data-external-overview-embedding-rows]",
+        },
+      });
+      const workflowOverviewEmbeddingDomReadiness = launchApi.getWorkflowOverviewEmbeddingDomReadiness({
+        contract: workflowOverviewEmbeddingDomContract,
+        documentRef: document,
       });
       assertEqual(workflowOverviewReadiness.ready, true, "shell workflow overview iframe readiness");
       assertEqual(workflowOverviewReadiness.missing.join(","), "", "shell workflow overview iframe missing methods");
@@ -318,8 +332,10 @@ TOOL_TABLE = browser-shell-tool.tbl
       assertEqual(workflowOverviewEmbeddingDisplay.rows.length, 6, "shell workflow overview embedding display rows");
       assertEqual(workflowOverviewEmbeddingRenderState.dataset.handoffScope, "workflow-overview-embedding", "shell workflow overview embedding render-state scope");
       assertEqual(workflowOverviewEmbeddingRenderState.rows.length, 6, "shell workflow overview embedding render-state rows");
-      assertEqual(workflowOverviewEmbeddingDomContract.selectors.rows, "[data-workflow-overview-embedding-rows]", "shell workflow overview embedding DOM rows selector");
+      assertEqual(workflowOverviewEmbeddingDomContract.selectors.rows, "[data-external-overview-embedding-rows]", "shell workflow overview embedding DOM rows selector");
       assertEqual(workflowOverviewEmbeddingDomContract.rowDatasetKeys.term[0], "externalOverviewEmbeddingRow", "shell workflow overview embedding DOM row prefix");
+      assertEqual(workflowOverviewEmbeddingDomReadiness.ready, true, "shell workflow overview embedding DOM readiness");
+      assertEqual(workflowOverviewEmbeddingDomReadiness.missing.join(","), "", "shell workflow overview embedding DOM missing");
 
       const controlDoc = await loadFrame(`../../runtime/ui/ini-panel/${controlTarget.href.slice(2)}`);
       const controlPageApi = controlDoc.defaultView.linuxCncIniPanelControlPageApi;

wasm-port/tests/browser/ini_panel_workflow_overview_smoke.html

@@ -39,7 +39,8 @@
         !workflowApi?.getWorkflowOverviewEmbeddingReport ||
         !workflowApi?.getWorkflowOverviewEmbeddingDisplayViewModel ||
         !workflowApi?.getWorkflowOverviewEmbeddingRenderState ||
-        !workflowApi?.getWorkflowOverviewEmbeddingDomContract
+        !workflowApi?.getWorkflowOverviewEmbeddingDomContract ||
+        !workflowApi?.getWorkflowOverviewEmbeddingDomReadiness
       ) {
         throw new Error("workflow overview API namespace did not expose overview helpers");
       }
@@ -66,6 +67,7 @@
       const embeddingDisplay = workflowApi.getWorkflowOverviewEmbeddingDisplayViewModel(embeddingReport);
       const embeddingRenderState = workflowApi.getWorkflowOverviewEmbeddingRenderState(embeddingDisplay);
       const embeddingDomContract = workflowApi.getWorkflowOverviewEmbeddingDomContract();
+      const embeddingDomReadiness = workflowApi.getWorkflowOverviewEmbeddingDomReadiness();
 
       assertEqual(summary.summaryVersion, 1, "workflow overview summary version");
       assertEqual(displayViewModel.title, "Shell handoff workflow", "workflow overview display title");
@@ -88,6 +90,8 @@
       assertEqual(embeddingRenderState.dataset.handoffScope, "workflow-overview-embedding", "workflow overview embedding render-state scope");
       assertEqual(embeddingDomContract.selectors.status, "[data-workflow-overview-embedding-status]", "workflow overview embedding DOM contract status selector");
       assertEqual(embeddingDomContract.renderResultFields.includes("rowIds"), true, "workflow overview embedding DOM contract render fields");
+      assertEqual(embeddingDomReadiness.ready, false, "workflow overview embedding DOM readiness");
+      assertEqual(embeddingDomReadiness.missing.join(","), "mount,status,rows", "workflow overview embedding DOM readiness missing");
       assertEqual(
         workflowDoc.querySelector("[data-handoff-workflow]").dataset.handoffScope,
         "workflow",

wasm-port/tests/ui/node/verify_ini_panel_entry_docs.mjs

@@ -43,6 +43,7 @@ import {
   createIniPanelShellWorkflowOverviewEmbeddingDisplayViewModel,
   createIniPanelShellWorkflowOverviewEmbeddingRenderState,
   createIniPanelShellWorkflowOverviewEmbeddingDomContract,
+  createIniPanelShellWorkflowOverviewEmbeddingDomReadiness,
   mountIniPanelShellWorkflowOverviewEmbedding,
   renderIniPanelShellSessionHandoffWorkflowState,
   mountIniPanelShellSessionHandoffWorkflow,
@@ -128,6 +129,7 @@ const requiredShellExports = [
   "createIniPanelShellWorkflowOverviewEmbeddingDisplayViewModel",
   "createIniPanelShellWorkflowOverviewEmbeddingRenderState",
   "createIniPanelShellWorkflowOverviewEmbeddingDomContract",
+  "createIniPanelShellWorkflowOverviewEmbeddingDomReadiness",
   "mountIniPanelShellWorkflowOverviewEmbedding",
   "renderIniPanelShellSessionHandoffWorkflowState",
   "mountIniPanelShellSessionHandoffWorkflow",
@@ -432,6 +434,7 @@ assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEm
 assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEmbeddingDisplayViewModel\b/);
 assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEmbeddingRenderState\b/);
 assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEmbeddingDomContract\b/);
+assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEmbeddingDomReadiness\b/);
 assert.match(shellText, /\bexport function isSupportedIniPanelControlPageApiManifest\b/);
 assert.match(shellText, /\bexport function isSupportedIniPanelLaunchApiManifest\b/);
 assert.match(shellText, /\bexport function isSupportedIniPanelShellIntegrationManifest\b/);
@@ -464,6 +467,7 @@ assert.match(launchText, /\bgetWorkflowOverviewEmbeddingReport\b/);
 assert.match(launchText, /\bgetWorkflowOverviewEmbeddingDisplayViewModel\b/);
 assert.match(launchText, /\bgetWorkflowOverviewEmbeddingRenderState\b/);
 assert.match(launchText, /\bgetWorkflowOverviewEmbeddingDomContract\b/);
+assert.match(launchText, /\bgetWorkflowOverviewEmbeddingDomReadiness\b/);
 assert.match(launchText, /\bisSupportedShellSessionHandoffPackage\b/);
 assert.match(launchText, /\bdata-handoff-shell\b/);
 assert.match(launchText, /\bdata-handoff-status\b/);
@@ -501,6 +505,7 @@ assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingReport\b/);
 assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingDisplayViewModel\b/);
 assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingRenderState\b/);
 assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingDomContract\b/);
+assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingDomReadiness\b/);
 assert.match(docText, /\bisSupportedIniPanelControlPageApiManifest\b/);
 assert.match(docText, /\bisSupportedIniPanelLaunchApiManifest\b/);
 assert.match(docText, /\bisSupportedIniPanelShellIntegrationManifest\b/);
@@ -528,6 +533,7 @@ assert.match(docText, /\blinuxCncIniPanelLaunchApi\.getWorkflowOverviewEmbedding
 assert.match(docText, /\blinuxCncIniPanelLaunchApi\.getWorkflowOverviewEmbeddingDisplayViewModel\b/);
 assert.match(docText, /\blinuxCncIniPanelLaunchApi\.getWorkflowOverviewEmbeddingRenderState\b/);
 assert.match(docText, /\blinuxCncIniPanelLaunchApi\.getWorkflowOverviewEmbeddingDomContract\b/);
+assert.match(docText, /\blinuxCncIniPanelLaunchApi\.getWorkflowOverviewEmbeddingDomReadiness\b/);
 assert.match(docText, /\blinuxCncIniPanelLaunchApi\.isSupportedShellSessionHandoffPackage\b/);
 assert.match(docText, /\bdata-handoff-shell\b/);
 assert.match(docText, /\bdata-handoff-status\b/);

wasm-port/tests/ui/node/verify_ini_panel_launch_api_manifest.mjs

@@ -83,6 +83,7 @@ assert.deepEqual(manifest, {
     "getWorkflowOverviewEmbeddingDisplayViewModel",
     "getWorkflowOverviewEmbeddingRenderState",
     "getWorkflowOverviewEmbeddingDomContract",
+    "getWorkflowOverviewEmbeddingDomReadiness",
     "isSupportedShellSessionHandoffPackage",
     "getLauncherLinks",
     "getControlPageApiMethods",
@@ -230,6 +231,7 @@ assert.match(launchText, /\bgetWorkflowOverviewEmbeddingReport\b/);
 assert.match(launchText, /\bgetWorkflowOverviewEmbeddingDisplayViewModel\b/);
 assert.match(launchText, /\bgetWorkflowOverviewEmbeddingRenderState\b/);
 assert.match(launchText, /\bgetWorkflowOverviewEmbeddingDomContract\b/);
+assert.match(launchText, /\bgetWorkflowOverviewEmbeddingDomReadiness\b/);
 assert.match(launchText, /\bisSupportedShellSessionHandoffPackage\b/);
 assert.match(launchText, /\bdata-handoff-workflow\b/);
 assert.match(launchText, /\bdata-handoff-workflow-status\b/);

wasm-port/tests/ui/node/verify_ini_panel_shell_integration_manifest.mjs

@@ -39,6 +39,7 @@ import {
   createIniPanelShellWorkflowOverviewEmbeddingDisplayViewModel,
   createIniPanelShellWorkflowOverviewEmbeddingRenderState,
   createIniPanelShellWorkflowOverviewEmbeddingDomContract,
+  createIniPanelShellWorkflowOverviewEmbeddingDomReadiness,
   mountIniPanelShellWorkflowOverviewEmbedding,
   renderIniPanelShellSessionHandoffWorkflowState,
   mountIniPanelShellSessionHandoffWorkflow,
@@ -168,7 +169,7 @@ assert.deepEqual(readiness, {
   counts: {
     pages: 3,
     launcherLinks: 3,
-    launchMethods: 46,
+    launchMethods: 47,
     controlPageMethods: 11,
     persistenceCapabilities: 3,
   },
@@ -230,7 +231,7 @@ assert.deepEqual(handoffSummary, {
     counts: {
       pages: 3,
       launcherLinks: 3,
-      launchMethods: 46,
+      launchMethods: 47,
       controlPageMethods: 11,
       persistenceCapabilities: 3,
     },
@@ -790,6 +791,7 @@ assert.equal(
   createIniPanelShellWorkflowOverviewEmbeddingDomContract().selectors.mount,
   "[data-workflow-overview-embedding]",
 );
+assert.equal(createIniPanelShellWorkflowOverviewEmbeddingDomReadiness().ready, false);
 assert.deepEqual(
   createIniPanelShellWorkflowOverviewReadiness({
     overviewApi: {
@@ -1218,7 +1220,7 @@ assert.deepEqual(createIniPanelShellIntegrationReadiness(blockedManifest), {
   counts: {
     pages: 3,
     launcherLinks: 3,
-    launchMethods: 46,
+    launchMethods: 47,
     controlPageMethods: 11,
     persistenceCapabilities: 3,
   },
@@ -1404,6 +1406,7 @@ assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEm
 assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEmbeddingDisplayViewModel\b/);
 assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEmbeddingRenderState\b/);
 assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEmbeddingDomContract\b/);
+assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEmbeddingDomReadiness\b/);
 assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffPackageRenderState\b/);
 assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffPackageSchema\b/);
 assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffRenderState\b/);
@@ -1445,6 +1448,7 @@ assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingReport\b/);
 assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingDisplayViewModel\b/);
 assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingRenderState\b/);
 assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingDomContract\b/);
+assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingDomReadiness\b/);
 assert.match(docText, /\bcreateIniPanelShellSessionHandoffPackageRenderState\b/);
 assert.match(docText, /\bcreateIniPanelShellSessionHandoffPackageSchema\b/);
 assert.match(docText, /\bcreateIniPanelShellSessionHandoffRenderState\b/);

wasm-port/tests/ui/node/verify_ini_panel_ui_shell.mjs

@@ -39,6 +39,7 @@ import {
   createIniPanelShellWorkflowOverviewEmbeddingDisplayViewModel,
   createIniPanelShellWorkflowOverviewEmbeddingRenderState,
   createIniPanelShellWorkflowOverviewEmbeddingDomContract,
+  createIniPanelShellWorkflowOverviewEmbeddingDomReadiness,
   mountIniPanelShellWorkflowOverviewEmbedding,
   renderIniPanelShellSessionHandoffWorkflowState,
   mountIniPanelShellSessionHandoffWorkflow,
@@ -129,6 +130,7 @@ assert.equal(typeof createIniPanelShellWorkflowOverviewEmbeddingReport, "functio
 assert.equal(typeof createIniPanelShellWorkflowOverviewEmbeddingDisplayViewModel, "function");
 assert.equal(typeof createIniPanelShellWorkflowOverviewEmbeddingRenderState, "function");
 assert.equal(typeof createIniPanelShellWorkflowOverviewEmbeddingDomContract, "function");
+assert.equal(typeof createIniPanelShellWorkflowOverviewEmbeddingDomReadiness, "function");
 assert.equal(typeof mountIniPanelShellWorkflowOverviewEmbedding, "function");
 assert.equal(typeof renderIniPanelShellSessionHandoffWorkflowState, "function");
 assert.equal(typeof mountIniPanelShellSessionHandoffWorkflow, "function");
@@ -811,6 +813,10 @@ assert.equal(
   shellViewModel.createWorkflowOverviewEmbeddingDomContract,
   createIniPanelShellWorkflowOverviewEmbeddingDomContract,
 );
+assert.equal(
+  shellViewModel.createWorkflowOverviewEmbeddingDomReadiness,
+  createIniPanelShellWorkflowOverviewEmbeddingDomReadiness,
+);
 assert.equal(shellViewModel.createShellSessionHandoffPackageReport, createIniPanelShellSessionHandoffPackageReport);
 assert.equal(shellViewModel.createShellSessionHandoffPackageSchema, createIniPanelShellSessionHandoffPackageSchema);
 assert.equal(shellViewModel.isSupportedShellSessionHandoffPackage, isSupportedIniPanelShellSessionHandoffPackage);
@@ -1306,6 +1312,47 @@ assert.deepEqual(
   }).rowDatasetKeys.detail,
   ["externalEmbeddingValue", "externalEmbeddingStatus"],
 );
+assert.deepEqual(
+  createIniPanelShellWorkflowOverviewEmbeddingDomReadiness({ documentRef: null }),
+  {
+    apiName: "ini-panel-shell-workflow-overview-embedding-dom-readiness",
+    readinessVersion: 1,
+    phase: "blocked",
+    ready: false,
+    missing: ["document", "mount", "status", "rows"],
+    checks: {
+      document: false,
+      mount: false,
+      status: false,
+      rows: false,
+      rowDatasetPrefix: true,
+    },
+    contract: createIniPanelShellWorkflowOverviewEmbeddingDomContract(),
+  },
+);
+assert.deepEqual(
+  createIniPanelShellWorkflowOverviewEmbeddingDomReadiness({
+    documentRef: mountDocument,
+    mountNode,
+    statusNode: mountStatusNode,
+    rowsNode: mountRowsNode,
+  }),
+  {
+    apiName: "ini-panel-shell-workflow-overview-embedding-dom-readiness",
+    readinessVersion: 1,
+    phase: "ready",
+    ready: true,
+    missing: [],
+    checks: {
+      document: true,
+      mount: true,
+      status: true,
+      rows: true,
+      rowDatasetPrefix: true,
+    },
+    contract: createIniPanelShellWorkflowOverviewEmbeddingDomContract(),
+  },
+);
 assert.deepEqual(
   mountIniPanelShellWorkflowOverviewEmbedding({ overviewApi: null }).readiness.missing,
   shellViewModel.shellWorkflowOverviewContract.methodNames,