推进 INI 面板 workflow overview embedding DOM readiness

2026-06-15 18:28:58 +08:00
parent 3cfd4b371e
commit 6856721695
12 changed files with 236 additions and 9 deletions
--- a/text13.txt
+++ b/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。
--- a/wasm-port/docs/panel-entry.md
+++ b/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
--- a/wasm-port/runtime/ui/ini-panel/launch.html
+++ b/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,
--- a/wasm-port/runtime/ui/ini-panel/ui-shell.js
+++ b/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(),
--- a/wasm-port/runtime/ui/ini-panel/workflow-overview.html
+++ b/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>
--- a/wasm-port/tests/browser/ini_panel_launch_smoke.html
+++ b/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,
-        workflowOverviewEmbeddingDomContract.selectors.mount,
-        "workflow overview self embedding DOM contract",
+        workflowOverviewApi.getWorkflowOverviewEmbeddingDomReadiness().ready,
+        false,
+        "workflow overview self embedding DOM readiness",
      );
      status.textContent = "browser_ini_launch_smoke=ok";
      console.log("browser_ini_launch_smoke=ok");
--- a/wasm-port/tests/browser/ini_panel_shell_integration_workflow_smoke.html
+++ b/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;
--- a/wasm-port/tests/browser/ini_panel_workflow_overview_smoke.html
+++ b/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",
--- a/wasm-port/tests/ui/node/verify_ini_panel_entry_docs.mjs
+++ b/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/);
--- a/wasm-port/tests/ui/node/verify_ini_panel_launch_api_manifest.mjs
+++ 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/);
--- a/wasm-port/tests/ui/node/verify_ini_panel_shell_integration_manifest.mjs
+++ 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/);
--- a/wasm-port/tests/ui/node/verify_ini_panel_ui_shell.mjs
+++ 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,