推进 INI 面板 workflow overview embedding mount result

2026-06-15 20:35:39 +08:00
parent 75f71c2563
commit 83df80d00f
12 changed files with 245 additions and 5 deletions
--- a/text13.txt
+++ b/text13.txt
@@ -1763,3 +1763,97 @@ host_wasm_opfs_browser_smokes=ok
 `mountIniPanelShellWorkflowOverviewEmbeddingState()` 或等价 helper，把 embedding render-state、DOM
 readiness、renderer result 与错误捕获合并成不抛异常的结构化 mount workflow result；仍保持只读，
 不新增控制按钮，不解析 G-code。
+
+十七、2026-06-15 继续执行记录：INI panel workflow overview embedding mount workflow result
+
+本轮先处理 `text12.txt` 遗留问题：删除未提交的重复/错序“四十三”记录块，使 `text12.txt`
+回到归档干净状态；随后按 `text13.txt` 继续推进 browser/UI workflow。新增只读
+workflow-overview embedding mount workflow result，把 embedding render-state、DOM readiness、
+renderer result 与错误捕获合并成不抛异常的结构化 mount result。
+
+完成内容：
+
+- 清理 `text12.txt` 遗留重复记录：
+  - 删除复制“四十二”内容的错序“四十三”块；
+  - `git diff -- text12.txt` 为空；
+  - `text12.txt` 标题重复检查无输出；
+- `ui-shell.js` 新增 `mountIniPanelShellWorkflowOverviewEmbeddingState()`；
+- mount workflow result 输出：
+  - `apiName: "ini-panel-shell-workflow-overview-embedding-dom-mount"`；
+  - `workflowVersion: 1`；
+  - `phase: "ready" | "blocked"`；
+  - `ready`；
+  - `statusLine`；
+  - `contract`；
+  - `domReadiness`；
+  - `renderState`；
+  - `renderResult`；
+  - `error`；
+- DOM 不 ready 时返回 blocked 结果，不抛异常；
+- renderer 异常时捕获到 `error` 字段并返回 blocked 结果；
+- `createIniPanelLaunchApiManifest().methods` 新增
+  `mountWorkflowOverviewEmbeddingState`；
+- `createIniPanelShellViewModel()` 暴露
+  `mountWorkflowOverviewEmbeddingState`；
+- `launch.html` 的 `window.linuxCncIniPanelLaunchApi` 新增真实 browser 入口
+  `mountWorkflowOverviewEmbeddingState()`；
+- `workflow-overview.html` 的 `window.linuxCncIniPanelWorkflowOverviewApi` 新增真实 browser
+  入口 `mountWorkflowOverviewEmbeddingState()`；
+- `verify_ini_panel_ui_shell.mjs` 覆盖 fake DOM mount workflow result 与 missing DOM blocked result；
+- `verify_ini_panel_launch_api_manifest.mjs` 覆盖 launch manifest 与 launch 页面真实 API；
+- `verify_ini_panel_shell_integration_manifest.mjs` 覆盖 helper export、launch method count 与文档记录；
+- `verify_ini_panel_entry_docs.mjs` 与 `docs/panel-entry.md` 同步记录新 helper/API；
+- `ini_panel_workflow_overview_smoke.html` 校验 workflow overview iframe 自身 mount workflow result；
+- `ini_panel_shell_integration_workflow_smoke.html` 校验外部 shell 使用自定义 embedding DOM
+  contract 调用 mount workflow result；
+- `ini_panel_launch_smoke.html` 校验 launch API 与 workflow overview iframe API 暴露新 mount helper；
+- 未新增控制按钮；
+- 未执行 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_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。下一批建议新增只读
+`createIniPanelShellWorkflowOverviewEmbeddingMountDisplayViewModel()` 或等价 helper，把 embedding
+mount workflow result 压缩成 stable `title`、`statusText`、`detailText` 与 rows，便于外部 shell
+直接显示 mount 结果；仍保持只读，不新增控制按钮，不解析 G-code。
--- a/wasm-port/docs/panel-entry.md
+++ b/wasm-port/docs/panel-entry.md
@@ -48,6 +48,7 @@ import {
  createIniPanelShellWorkflowOverviewEmbeddingDomReadiness,
  mountIniPanelShellWorkflowOverviewEmbedding,
  renderIniPanelShellWorkflowOverviewEmbeddingState,
+  mountIniPanelShellWorkflowOverviewEmbeddingState,
  renderIniPanelShellSessionHandoffWorkflowState,
  mountIniPanelShellSessionHandoffWorkflow,
  renderIniPanelShellSessionHandoffMountState,
@@ -344,6 +345,12 @@ outer shell needs to render an embedding report render-state into existing
 mount/status/rows nodes and receive a structured read-only render result. The
 workflow overview page also exposes
 `linuxCncIniPanelWorkflowOverviewApi.renderWorkflowOverviewEmbeddingState()`.
+Use `mountIniPanelShellWorkflowOverviewEmbeddingState()` or
+`linuxCncIniPanelLaunchApi.mountWorkflowOverviewEmbeddingState()` when an outer
+shell needs a non-throwing workflow result that combines embedding DOM
+readiness, render-state, render result, and any render error as structured
+data. The workflow overview page also exposes
+`linuxCncIniPanelWorkflowOverviewApi.mountWorkflowOverviewEmbeddingState()`.
 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
@@ -297,6 +297,11 @@
      renderWorkflowOverviewEmbeddingState: (renderState, options) => (
        shellViewModel.renderWorkflowOverviewEmbeddingState(renderState, options ?? { documentRef: document })
      ),
+      mountWorkflowOverviewEmbeddingState: (options) => (
+        shellViewModel.mountWorkflowOverviewEmbeddingState(options ?? {
+          documentRef: document,
+        })
+      ),
      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
@@ -165,6 +165,7 @@ export function createIniPanelLaunchApiManifest(entries = getVisibleIniPanelEntr
      "getWorkflowOverviewEmbeddingDomContract",
      "getWorkflowOverviewEmbeddingDomReadiness",
      "renderWorkflowOverviewEmbeddingState",
+      "mountWorkflowOverviewEmbeddingState",
      "isSupportedShellSessionHandoffPackage",
      "getLauncherLinks",
      "getControlPageApiMethods",
@@ -2059,6 +2060,73 @@ export function renderIniPanelShellWorkflowOverviewEmbeddingState(
  };
 }

+export function mountIniPanelShellWorkflowOverviewEmbeddingState({
+  renderState = createIniPanelShellWorkflowOverviewEmbeddingRenderState(),
+  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 domReadiness = createIniPanelShellWorkflowOverviewEmbeddingDomReadiness({
+    contract,
+    documentRef,
+    mountNode,
+    statusNode,
+    rowsNode,
+  });
+  if (!domReadiness.ready) {
+    return {
+      apiName: "ini-panel-shell-workflow-overview-embedding-dom-mount",
+      workflowVersion: 1,
+      phase: "blocked",
+      ready: false,
+      statusLine: `Blocked: ${domReadiness.missing.join(", ")}`,
+      contract,
+      domReadiness,
+      renderState,
+      renderResult: null,
+      error: null,
+    };
+  }
+
+  try {
+    const renderResult = renderIniPanelShellWorkflowOverviewEmbeddingState(renderState, {
+      contract,
+      documentRef,
+      mountNode,
+      statusNode,
+      rowsNode,
+    });
+    return {
+      apiName: "ini-panel-shell-workflow-overview-embedding-dom-mount",
+      workflowVersion: 1,
+      phase: renderState?.phase === "ready" ? "ready" : "blocked",
+      ready: renderState?.ready === true,
+      statusLine: renderResult.statusLine,
+      contract,
+      domReadiness,
+      renderState,
+      renderResult,
+      error: null,
+    };
+  } catch (error) {
+    return {
+      apiName: "ini-panel-shell-workflow-overview-embedding-dom-mount",
+      workflowVersion: 1,
+      phase: "blocked",
+      ready: false,
+      statusLine: `Blocked: ${error?.message ?? "workflow overview embedding DOM mount error"}`,
+      contract,
+      domReadiness,
+      renderState,
+      renderResult: null,
+      error: error?.message ?? String(error),
+    };
+  }
+}
+
 export function createIniPanelShellViewModel(entries = getVisibleIniPanelEntries()) {
  const shellIntegrationManifest = createIniPanelShellIntegrationManifest(entries);
  const shellIntegrationReadiness = createIniPanelShellIntegrationReadiness(shellIntegrationManifest);
@@ -2223,6 +2291,7 @@ export function createIniPanelShellViewModel(entries = getVisibleIniPanelEntries
    createWorkflowOverviewEmbeddingDomContract: createIniPanelShellWorkflowOverviewEmbeddingDomContract,
    createWorkflowOverviewEmbeddingDomReadiness: createIniPanelShellWorkflowOverviewEmbeddingDomReadiness,
    renderWorkflowOverviewEmbeddingState: renderIniPanelShellWorkflowOverviewEmbeddingState,
+    mountWorkflowOverviewEmbeddingState: mountIniPanelShellWorkflowOverviewEmbeddingState,
    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
@@ -96,6 +96,7 @@
      createIniPanelShellWorkflowOverviewEmbeddingDomReadiness,
      mountIniPanelShellWorkflowOverviewEmbedding,
      renderIniPanelShellWorkflowOverviewEmbeddingState,
+      mountIniPanelShellWorkflowOverviewEmbeddingState,
      renderIniPanelShellSessionHandoffWorkflowState,
      mountIniPanelShellSessionHandoffWorkflow,
    } from "./ui-shell.js";
@@ -155,6 +156,11 @@
      renderWorkflowOverviewEmbeddingState: (renderState, options) => (
        renderIniPanelShellWorkflowOverviewEmbeddingState(renderState, options ?? { documentRef: document })
      ),
+      mountWorkflowOverviewEmbeddingState: (options) => (
+        mountIniPanelShellWorkflowOverviewEmbeddingState(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
@@ -109,6 +109,7 @@
        !launchApi?.getWorkflowOverviewEmbeddingDomContract ||
        !launchApi?.getWorkflowOverviewEmbeddingDomReadiness ||
        !launchApi?.renderWorkflowOverviewEmbeddingState ||
+        !launchApi?.mountWorkflowOverviewEmbeddingState ||
        !launchApi?.isSupportedShellSessionHandoffPackage ||
        !launchApi?.getLauncherLinks ||
        !launchApi?.getControlPageApiMethods
@@ -639,7 +640,8 @@
        !workflowOverviewApi?.getWorkflowOverviewEmbeddingRenderState ||
        !workflowOverviewApi?.getWorkflowOverviewEmbeddingDomContract ||
        !workflowOverviewApi?.getWorkflowOverviewEmbeddingDomReadiness ||
-        !workflowOverviewApi?.renderWorkflowOverviewEmbeddingState
+        !workflowOverviewApi?.renderWorkflowOverviewEmbeddingState ||
+        !workflowOverviewApi?.mountWorkflowOverviewEmbeddingState
      ) {
        throw new Error("workflow overview API namespace did not expose shell helpers");
      }
--- a/wasm-port/tests/browser/ini_panel_shell_integration_workflow_smoke.html
+++ b/wasm-port/tests/browser/ini_panel_shell_integration_workflow_smoke.html
@@ -115,6 +115,7 @@ TOOL_TABLE = browser-shell-tool.tbl
        !launchApi?.getWorkflowOverviewEmbeddingDomContract ||
        !launchApi?.getWorkflowOverviewEmbeddingDomReadiness ||
        !launchApi?.renderWorkflowOverviewEmbeddingState ||
+        !launchApi?.mountWorkflowOverviewEmbeddingState ||
        !launchApi?.isSupportedShellSessionHandoffPackage
      ) {
        throw new Error("launch API namespace did not expose shell integration helpers");
@@ -326,6 +327,11 @@ TOOL_TABLE = browser-shell-tool.tbl
          documentRef: document,
        },
      );
+      const workflowOverviewEmbeddingMountState = launchApi.mountWorkflowOverviewEmbeddingState({
+        renderState: workflowOverviewEmbeddingRenderState,
+        contract: workflowOverviewEmbeddingDomContract,
+        documentRef: document,
+      });
      assertEqual(workflowOverviewReadiness.ready, true, "shell workflow overview iframe readiness");
      assertEqual(workflowOverviewReadiness.missing.join(","), "", "shell workflow overview iframe missing methods");
      assertEqual(workflowOverviewEmbedding.apiName, "ini-panel-shell-workflow-overview-embedding", "shell workflow overview embedding API");
@@ -352,6 +358,9 @@ TOOL_TABLE = browser-shell-tool.tbl
        workflowOverviewEmbeddingRenderState.statusLine,
        "shell workflow overview embedding rendered status",
      );
+      assertEqual(workflowOverviewEmbeddingMountState.apiName, "ini-panel-shell-workflow-overview-embedding-dom-mount", "shell workflow overview embedding mount API");
+      assertEqual(workflowOverviewEmbeddingMountState.ready, false, "shell workflow overview embedding mount readiness");
+      assertEqual(workflowOverviewEmbeddingMountState.renderResult.rowCount, 6, "shell workflow overview embedding mount rows");

      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
@@ -41,7 +41,8 @@
        !workflowApi?.getWorkflowOverviewEmbeddingRenderState ||
        !workflowApi?.getWorkflowOverviewEmbeddingDomContract ||
        !workflowApi?.getWorkflowOverviewEmbeddingDomReadiness ||
-        !workflowApi?.renderWorkflowOverviewEmbeddingState
+        !workflowApi?.renderWorkflowOverviewEmbeddingState ||
+        !workflowApi?.mountWorkflowOverviewEmbeddingState
      ) {
        throw new Error("workflow overview API namespace did not expose overview helpers");
      }
@@ -102,10 +103,16 @@
      embeddingMount.append(embeddingStatus, embeddingRows);
      workflowDoc.body.append(embeddingMount);
      const embeddingRenderResult = workflowApi.renderWorkflowOverviewEmbeddingState(embeddingRenderState);
+      const embeddingMountState = workflowApi.mountWorkflowOverviewEmbeddingState({
+        renderState: embeddingRenderState,
+      });
      assertEqual(embeddingRenderResult.rendered, true, "workflow overview embedding render result");
      assertEqual(embeddingRenderResult.rowCount, 6, "workflow overview embedding render row count");
      assertEqual(embeddingRenderResult.dataset.handoffScope, "workflow-overview-embedding", "workflow overview embedding render scope");
      assertEqual(embeddingStatus.textContent, embeddingRenderState.statusLine, "workflow overview embedding rendered status");
+      assertEqual(embeddingMountState.apiName, "ini-panel-shell-workflow-overview-embedding-dom-mount", "workflow overview embedding mount API");
+      assertEqual(embeddingMountState.ready, false, "workflow overview embedding mount readiness");
+      assertEqual(embeddingMountState.renderResult.rowCount, 6, "workflow overview embedding mount row count");
      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
@@ -46,6 +46,7 @@ import {
  createIniPanelShellWorkflowOverviewEmbeddingDomReadiness,
  mountIniPanelShellWorkflowOverviewEmbedding,
  renderIniPanelShellWorkflowOverviewEmbeddingState,
+  mountIniPanelShellWorkflowOverviewEmbeddingState,
  renderIniPanelShellSessionHandoffWorkflowState,
  mountIniPanelShellSessionHandoffWorkflow,
  renderIniPanelShellSessionHandoffMountState,
@@ -133,6 +134,7 @@ const requiredShellExports = [
  "createIniPanelShellWorkflowOverviewEmbeddingDomReadiness",
  "mountIniPanelShellWorkflowOverviewEmbedding",
  "renderIniPanelShellWorkflowOverviewEmbeddingState",
+  "mountIniPanelShellWorkflowOverviewEmbeddingState",
  "renderIniPanelShellSessionHandoffWorkflowState",
  "mountIniPanelShellSessionHandoffWorkflow",
  "renderIniPanelShellSessionHandoffMountState",
@@ -438,6 +440,7 @@ assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEm
 assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEmbeddingDomContract\b/);
 assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEmbeddingDomReadiness\b/);
 assert.match(shellText, /\bexport function renderIniPanelShellWorkflowOverviewEmbeddingState\b/);
+assert.match(shellText, /\bexport function mountIniPanelShellWorkflowOverviewEmbeddingState\b/);
 assert.match(shellText, /\bexport function isSupportedIniPanelControlPageApiManifest\b/);
 assert.match(shellText, /\bexport function isSupportedIniPanelLaunchApiManifest\b/);
 assert.match(shellText, /\bexport function isSupportedIniPanelShellIntegrationManifest\b/);
@@ -472,6 +475,7 @@ assert.match(launchText, /\bgetWorkflowOverviewEmbeddingRenderState\b/);
 assert.match(launchText, /\bgetWorkflowOverviewEmbeddingDomContract\b/);
 assert.match(launchText, /\bgetWorkflowOverviewEmbeddingDomReadiness\b/);
 assert.match(launchText, /\brenderWorkflowOverviewEmbeddingState\b/);
+assert.match(launchText, /\bmountWorkflowOverviewEmbeddingState\b/);
 assert.match(launchText, /\bisSupportedShellSessionHandoffPackage\b/);
 assert.match(launchText, /\bdata-handoff-shell\b/);
 assert.match(launchText, /\bdata-handoff-status\b/);
@@ -511,6 +515,7 @@ assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingRenderState
 assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingDomContract\b/);
 assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingDomReadiness\b/);
 assert.match(docText, /\brenderIniPanelShellWorkflowOverviewEmbeddingState\b/);
+assert.match(docText, /\bmountIniPanelShellWorkflowOverviewEmbeddingState\b/);
 assert.match(docText, /\bisSupportedIniPanelControlPageApiManifest\b/);
 assert.match(docText, /\bisSupportedIniPanelLaunchApiManifest\b/);
 assert.match(docText, /\bisSupportedIniPanelShellIntegrationManifest\b/);
@@ -540,6 +545,7 @@ assert.match(docText, /\blinuxCncIniPanelLaunchApi\.getWorkflowOverviewEmbedding
 assert.match(docText, /\blinuxCncIniPanelLaunchApi\.getWorkflowOverviewEmbeddingDomContract\b/);
 assert.match(docText, /\blinuxCncIniPanelLaunchApi\.getWorkflowOverviewEmbeddingDomReadiness\b/);
 assert.match(docText, /\blinuxCncIniPanelLaunchApi\.renderWorkflowOverviewEmbeddingState\b/);
+assert.match(docText, /\blinuxCncIniPanelLaunchApi\.mountWorkflowOverviewEmbeddingState\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
@@ -85,6 +85,7 @@ assert.deepEqual(manifest, {
    "getWorkflowOverviewEmbeddingDomContract",
    "getWorkflowOverviewEmbeddingDomReadiness",
    "renderWorkflowOverviewEmbeddingState",
+    "mountWorkflowOverviewEmbeddingState",
    "isSupportedShellSessionHandoffPackage",
    "getLauncherLinks",
    "getControlPageApiMethods",
@@ -234,6 +235,7 @@ assert.match(launchText, /\bgetWorkflowOverviewEmbeddingRenderState\b/);
 assert.match(launchText, /\bgetWorkflowOverviewEmbeddingDomContract\b/);
 assert.match(launchText, /\bgetWorkflowOverviewEmbeddingDomReadiness\b/);
 assert.match(launchText, /\brenderWorkflowOverviewEmbeddingState\b/);
+assert.match(launchText, /\bmountWorkflowOverviewEmbeddingState\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
@@ -42,6 +42,7 @@ import {
  createIniPanelShellWorkflowOverviewEmbeddingDomReadiness,
  mountIniPanelShellWorkflowOverviewEmbedding,
  renderIniPanelShellWorkflowOverviewEmbeddingState,
+  mountIniPanelShellWorkflowOverviewEmbeddingState,
  renderIniPanelShellSessionHandoffWorkflowState,
  mountIniPanelShellSessionHandoffWorkflow,
  createIniPanelShellSessionHandoffPackageReport,
@@ -170,7 +171,7 @@ assert.deepEqual(readiness, {
  counts: {
    pages: 3,
    launcherLinks: 3,
-    launchMethods: 48,
+    launchMethods: 49,
    controlPageMethods: 11,
    persistenceCapabilities: 3,
  },
@@ -232,7 +233,7 @@ assert.deepEqual(handoffSummary, {
    counts: {
      pages: 3,
      launcherLinks: 3,
-      launchMethods: 48,
+      launchMethods: 49,
      controlPageMethods: 11,
      persistenceCapabilities: 3,
    },
@@ -794,6 +795,7 @@ assert.equal(
 );
 assert.equal(createIniPanelShellWorkflowOverviewEmbeddingDomReadiness().ready, false);
 assert.equal(typeof renderIniPanelShellWorkflowOverviewEmbeddingState, "function");
+assert.equal(typeof mountIniPanelShellWorkflowOverviewEmbeddingState, "function");
 assert.deepEqual(
  createIniPanelShellWorkflowOverviewReadiness({
    overviewApi: {
@@ -1222,7 +1224,7 @@ assert.deepEqual(createIniPanelShellIntegrationReadiness(blockedManifest), {
  counts: {
    pages: 3,
    launcherLinks: 3,
-    launchMethods: 48,
+    launchMethods: 49,
    controlPageMethods: 11,
    persistenceCapabilities: 3,
  },
@@ -1410,6 +1412,7 @@ assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEm
 assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEmbeddingDomContract\b/);
 assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEmbeddingDomReadiness\b/);
 assert.match(shellText, /\bexport function renderIniPanelShellWorkflowOverviewEmbeddingState\b/);
+assert.match(shellText, /\bexport function mountIniPanelShellWorkflowOverviewEmbeddingState\b/);
 assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffPackageRenderState\b/);
 assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffPackageSchema\b/);
 assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffRenderState\b/);
@@ -1453,6 +1456,7 @@ assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingRenderState
 assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingDomContract\b/);
 assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingDomReadiness\b/);
 assert.match(docText, /\brenderIniPanelShellWorkflowOverviewEmbeddingState\b/);
+assert.match(docText, /\bmountIniPanelShellWorkflowOverviewEmbeddingState\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
@@ -42,6 +42,7 @@ import {
  createIniPanelShellWorkflowOverviewEmbeddingDomReadiness,
  mountIniPanelShellWorkflowOverviewEmbedding,
  renderIniPanelShellWorkflowOverviewEmbeddingState,
+  mountIniPanelShellWorkflowOverviewEmbeddingState,
  renderIniPanelShellSessionHandoffWorkflowState,
  mountIniPanelShellSessionHandoffWorkflow,
  renderIniPanelShellSessionHandoffMountState,
@@ -134,6 +135,7 @@ assert.equal(typeof createIniPanelShellWorkflowOverviewEmbeddingDomContract, "fu
 assert.equal(typeof createIniPanelShellWorkflowOverviewEmbeddingDomReadiness, "function");
 assert.equal(typeof mountIniPanelShellWorkflowOverviewEmbedding, "function");
 assert.equal(typeof renderIniPanelShellWorkflowOverviewEmbeddingState, "function");
+assert.equal(typeof mountIniPanelShellWorkflowOverviewEmbeddingState, "function");
 assert.equal(typeof renderIniPanelShellSessionHandoffWorkflowState, "function");
 assert.equal(typeof mountIniPanelShellSessionHandoffWorkflow, "function");
 assert.equal(typeof renderIniPanelShellSessionHandoffMountState, "function");
@@ -823,6 +825,10 @@ assert.equal(
  shellViewModel.renderWorkflowOverviewEmbeddingState,
  renderIniPanelShellWorkflowOverviewEmbeddingState,
 );
+assert.equal(
+  shellViewModel.mountWorkflowOverviewEmbeddingState,
+  mountIniPanelShellWorkflowOverviewEmbeddingState,
+);
 assert.equal(shellViewModel.createShellSessionHandoffPackageReport, createIniPanelShellSessionHandoffPackageReport);
 assert.equal(shellViewModel.createShellSessionHandoffPackageSchema, createIniPanelShellSessionHandoffPackageSchema);
 assert.equal(shellViewModel.isSupportedShellSessionHandoffPackage, isSupportedIniPanelShellSessionHandoffPackage);
@@ -1393,6 +1399,29 @@ assert.deepEqual(
 assert.equal(mountRowsNode.children[0].dataset.workflowOverviewEmbeddingRow, "overview-api");
 assert.equal(mountRowsNode.children[1].dataset.workflowOverviewEmbeddingValue, "overview-api");
 assert.equal(mountRowsNode.children[1].dataset.workflowOverviewEmbeddingStatus, "blocked");
+const workflowOverviewEmbeddingMountResult = mountIniPanelShellWorkflowOverviewEmbeddingState({
+  renderState: createIniPanelShellWorkflowOverviewEmbeddingRenderState(
+    createIniPanelShellWorkflowOverviewEmbeddingDisplayViewModel(workflowOverviewEmbeddingReport),
+  ),
+  documentRef: mountDocument,
+  mountNode,
+  statusNode: mountStatusNode,
+  rowsNode: mountRowsNode,
+});
+assert.equal(workflowOverviewEmbeddingMountResult.apiName, "ini-panel-shell-workflow-overview-embedding-dom-mount");
+assert.equal(workflowOverviewEmbeddingMountResult.workflowVersion, 1);
+assert.equal(workflowOverviewEmbeddingMountResult.phase, "blocked");
+assert.equal(workflowOverviewEmbeddingMountResult.ready, false);
+assert.equal(workflowOverviewEmbeddingMountResult.renderResult.rowCount, 6);
+assert.equal(
+  workflowOverviewEmbeddingMountResult.renderResult.dataset.handoffScope,
+  "workflow-overview-embedding",
+);
+assert.equal(workflowOverviewEmbeddingMountResult.error, null);
+assert.deepEqual(
+  mountIniPanelShellWorkflowOverviewEmbeddingState({ documentRef: null }).domReadiness.missing,
+  ["document", "mount", "status", "rows"],
+);
 assert.deepEqual(
  mountIniPanelShellWorkflowOverviewEmbedding({ overviewApi: null }).readiness.missing,
  shellViewModel.shellWorkflowOverviewContract.methodNames,