推进 INI 面板 workflow overview embedding mount DOM wrapper

2026-06-15 22:15:25 +08:00
parent 7a5aa23dbc
commit b771ee4141
13 changed files with 269 additions and 11 deletions
--- a/PROJECT_COMPLETION_TRACKER.md
+++ b/PROJECT_COMPLETION_TRACKER.md
@@ -9,7 +9,7 @@ turn-by-turn continuation notes and next-batch execution records.
 ## Current Status

 - Active continuation file: `text14.txt`
- Latest completed batch: workflow overview embedding mount DOM renderer
+- Latest completed batch: workflow overview embedding mount DOM mount wrapper
 - Latest relevant commit: use `git log -1 --oneline` after each committed batch
 - Working tree at tracker creation: clean
 - Required policy: LinuxCNC remains the only CNC semantic source
@@ -43,8 +43,8 @@ The project is complete for the current scope when all of the following are true
 | Native sim configs baseline | Stable | Last recorded Layer 2: `total 159`, `pass 151`, `expected_fail 8`, `unexpected_fail 0`. |
 | OPFS/session persistence | In progress | Browser smoke passes; final project needs explicit project-level summary/report. |
 | SDK/API surface | In progress | Many UI helpers exist; final project needs SDK export/readme consolidation. |
-| Browser/UI workflow | In progress | Current focus: workflow overview embedding mount DOM readiness/renderer/mount closure. |
-| Workflow overview embedding | In progress | Report/display/render, DOM contract/readiness/renderer, mount result/display/render, mount DOM contract/readiness/renderer exist. |
+| Browser/UI workflow | In progress | Current focus: workflow overview embedding mount DOM closure and SDK/API handoff. |
+| Workflow overview embedding | In progress | Report/display/render, DOM contract/readiness/renderer, mount result/display/render, mount DOM contract/readiness/renderer/wrapper exist. |
 | Host/runtime boundary proof | In progress | Host smoke passes; runtime families below remain blocked. |
 | Documentation/release gate | In progress | `text14.txt` has roadmap; README/docs final pass still pending. |

@@ -74,12 +74,12 @@ Execute these in order unless a later user request explicitly changes priority.

 Current next task:

- Add non-throwing mount workflow wrapper for mount render-state DOM rendering.
+- Audit and consolidate SDK/API exports for stable external callers.

 Then complete the closure:

- Add mount render-state DOM renderer.
- Add non-throwing mount workflow wrapper.
+- Mount render-state DOM renderer is complete.
+- Non-throwing mount workflow wrapper is complete.
 - Expose each helper through:
  - `createIniPanelLaunchApiManifest().methods`
  - `createIniPanelShellViewModel()`
--- a/text14.txt
+++ b/text14.txt
@@ -799,3 +799,98 @@ host_wasm_opfs_browser_smokes=ok
 `mountIniPanelShellWorkflowOverviewEmbeddingMountState()` 或等价非抛错 wrapper，将 mount DOM
 readiness、render-state、renderer 与 render-result 聚合成稳定 mount workflow result，供外部 shell
 直接调用；仍保持只读，不新增控制按钮，不解析 G-code。
+
+十一、2026-06-15 继续执行记录：INI panel workflow overview embedding mount DOM wrapper
+
+本轮按 `text14.txt` 执行，继续推进 Browser/UI workflow 收口批次。新增只读
+workflow-overview embedding mount DOM wrapper，将 mount DOM readiness、mount render-state、
+renderer 与 render-result 聚合为非抛错 mount workflow result，供外部 shell 直接调用。
+
+完成内容：
+
+- `ui-shell.js` 新增
+  `mountIniPanelShellWorkflowOverviewEmbeddingMountState()`；
+- wrapper 输出稳定 workflow result：
+  - `apiName: "ini-panel-shell-workflow-overview-embedding-mount-dom-mount"`；
+  - `workflowVersion: 1`；
+  - `phase: "ready" | "blocked"`；
+  - `ready`；
+  - `statusLine`；
+  - `contract`；
+  - `domReadiness`；
+  - `renderState`；
+  - `renderResult`；
+  - `error`；
+- DOM readiness blocked 时返回 structured blocked result，不抛错；
+- renderer 抛错时捕获为 structured blocked result；
+- DOM ready 时调用
+  `renderIniPanelShellWorkflowOverviewEmbeddingMountState()` 并回填 `renderResult`；
+- `createIniPanelLaunchApiManifest().methods` 新增
+  `mountWorkflowOverviewEmbeddingMountState`；
+- `createIniPanelShellViewModel()` 暴露
+  `mountWorkflowOverviewEmbeddingMountState`；
+- `launch.html` 的 `window.linuxCncIniPanelLaunchApi` 新增真实 browser 入口
+  `mountWorkflowOverviewEmbeddingMountState()`；
+- `workflow-overview.html` 的 `window.linuxCncIniPanelWorkflowOverviewApi` 新增真实 browser
+  入口 `mountWorkflowOverviewEmbeddingMountState()`；
+- `verify_ini_panel_ui_shell.mjs` 覆盖 ready DOM wrapper result 与 missing document/nodes
+  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 browser 页面中执行 wrapper，
+  校验 API、render row count、error 与 readiness；
+- `ini_panel_shell_integration_workflow_smoke.html` 校验外部 shell 自定义 mount DOM contract 的
+  missing DOM blocked wrapper result；
+- `ini_panel_launch_smoke.html` 校验 launch API 与 workflow overview iframe API 暴露新 wrapper；
+- `PROJECT_COMPLETION_TRACKER.md` 同步当前完成批次与下一步 SDK/API surface consolidation；
+- 未新增控制按钮；
+- 未执行 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
+```
+
+下一步工作计划：
+
+进入 SDK/API surface consolidation。下一批建议审计 `wasm-port/runtime/sdk/src/index.js` 与
+`wasm-port/runtime/sdk/README.md`，确认外部调用方可复用的稳定 API 是否覆盖 INI panel shell
+handoff、workflow overview embedding、OPFS/session persistence 与 sim-config staging；优先补
+SDK export/README 说明和 Node smoke，不扩大 CNC 语义边界，不新增解释器语义。
--- a/wasm-port/docs/panel-entry.md
+++ b/wasm-port/docs/panel-entry.md
@@ -54,6 +54,7 @@ import {
  createIniPanelShellWorkflowOverviewEmbeddingMountDomContract,
  createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness,
  renderIniPanelShellWorkflowOverviewEmbeddingMountState,
+  mountIniPanelShellWorkflowOverviewEmbeddingMountState,
  renderIniPanelShellSessionHandoffWorkflowState,
  mountIniPanelShellSessionHandoffWorkflow,
  renderIniPanelShellSessionHandoffMountState,
@@ -385,6 +386,11 @@ outer shell needs to render a mount render-state into existing mount/status/rows
 nodes and receive a structured read-only render result. The workflow overview
 page also exposes
 `linuxCncIniPanelWorkflowOverviewApi.renderWorkflowOverviewEmbeddingMountState()`.
+Use `mountIniPanelShellWorkflowOverviewEmbeddingMountState()` or
+`linuxCncIniPanelLaunchApi.mountWorkflowOverviewEmbeddingMountState()` when an
+outer shell needs a non-throwing mount workflow result for the mount render-state
+DOM. The workflow overview page also exposes
+`linuxCncIniPanelWorkflowOverviewApi.mountWorkflowOverviewEmbeddingMountState()`.
 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
@@ -317,6 +317,11 @@
      renderWorkflowOverviewEmbeddingMountState: (renderState, options) => (
        shellViewModel.renderWorkflowOverviewEmbeddingMountState(renderState, options ?? { documentRef: document })
      ),
+      mountWorkflowOverviewEmbeddingMountState: (options) => (
+        shellViewModel.mountWorkflowOverviewEmbeddingMountState(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
@@ -171,6 +171,7 @@ export function createIniPanelLaunchApiManifest(entries = getVisibleIniPanelEntr
      "getWorkflowOverviewEmbeddingMountDomContract",
      "getWorkflowOverviewEmbeddingMountDomReadiness",
      "renderWorkflowOverviewEmbeddingMountState",
+      "mountWorkflowOverviewEmbeddingMountState",
      "isSupportedShellSessionHandoffPackage",
      "getLauncherLinks",
      "getControlPageApiMethods",
@@ -2343,6 +2344,73 @@ export function renderIniPanelShellWorkflowOverviewEmbeddingMountState(
  };
 }

+export function mountIniPanelShellWorkflowOverviewEmbeddingMountState({
+  renderState = createIniPanelShellWorkflowOverviewEmbeddingMountRenderState(),
+  rowDatasetPrefix = "workflowOverviewEmbeddingMount",
+  contract = createIniPanelShellWorkflowOverviewEmbeddingMountDomContract({ rowDatasetPrefix }),
+  documentRef = globalThis.document,
+  mountNode = documentRef?.querySelector?.(contract.selectors.mount),
+  statusNode = documentRef?.querySelector?.(contract.selectors.status),
+  rowsNode = documentRef?.querySelector?.(contract.selectors.rows),
+} = {}) {
+  const domReadiness = createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness({
+    contract,
+    documentRef,
+    mountNode,
+    statusNode,
+    rowsNode,
+  });
+  if (!domReadiness.ready) {
+    return {
+      apiName: "ini-panel-shell-workflow-overview-embedding-mount-dom-mount",
+      workflowVersion: 1,
+      phase: "blocked",
+      ready: false,
+      statusLine: `Blocked: ${domReadiness.missing.join(", ")}`,
+      contract,
+      domReadiness,
+      renderState,
+      renderResult: null,
+      error: null,
+    };
+  }
+
+  try {
+    const renderResult = renderIniPanelShellWorkflowOverviewEmbeddingMountState(renderState, {
+      contract,
+      documentRef,
+      mountNode,
+      statusNode,
+      rowsNode,
+    });
+    return {
+      apiName: "ini-panel-shell-workflow-overview-embedding-mount-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-mount-dom-mount",
+      workflowVersion: 1,
+      phase: "blocked",
+      ready: false,
+      statusLine: `Blocked: ${error?.message ?? "workflow overview embedding mount 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);
@@ -2518,6 +2586,8 @@ export function createIniPanelShellViewModel(entries = getVisibleIniPanelEntries
      createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness,
    renderWorkflowOverviewEmbeddingMountState:
      renderIniPanelShellWorkflowOverviewEmbeddingMountState,
+    mountWorkflowOverviewEmbeddingMountState:
+      mountIniPanelShellWorkflowOverviewEmbeddingMountState,
    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
@@ -102,6 +102,7 @@
      createIniPanelShellWorkflowOverviewEmbeddingMountDomContract,
      createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness,
      renderIniPanelShellWorkflowOverviewEmbeddingMountState,
+      mountIniPanelShellWorkflowOverviewEmbeddingMountState,
      renderIniPanelShellSessionHandoffWorkflowState,
      mountIniPanelShellSessionHandoffWorkflow,
    } from "./ui-shell.js";
@@ -181,6 +182,11 @@
      renderWorkflowOverviewEmbeddingMountState: (renderState, options) => (
        renderIniPanelShellWorkflowOverviewEmbeddingMountState(renderState, options ?? { documentRef: document })
      ),
+      mountWorkflowOverviewEmbeddingMountState: (options) => (
+        mountIniPanelShellWorkflowOverviewEmbeddingMountState(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
@@ -115,6 +115,7 @@
        !launchApi?.getWorkflowOverviewEmbeddingMountDomContract ||
        !launchApi?.getWorkflowOverviewEmbeddingMountDomReadiness ||
        !launchApi?.renderWorkflowOverviewEmbeddingMountState ||
+        !launchApi?.mountWorkflowOverviewEmbeddingMountState ||
        !launchApi?.isSupportedShellSessionHandoffPackage ||
        !launchApi?.getLauncherLinks ||
        !launchApi?.getControlPageApiMethods
@@ -651,7 +652,8 @@
        !workflowOverviewApi?.getWorkflowOverviewEmbeddingMountRenderState ||
        !workflowOverviewApi?.getWorkflowOverviewEmbeddingMountDomContract ||
        !workflowOverviewApi?.getWorkflowOverviewEmbeddingMountDomReadiness ||
-        !workflowOverviewApi?.renderWorkflowOverviewEmbeddingMountState
+        !workflowOverviewApi?.renderWorkflowOverviewEmbeddingMountState ||
+        !workflowOverviewApi?.mountWorkflowOverviewEmbeddingMountState
      ) {
        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
@@ -121,6 +121,7 @@ TOOL_TABLE = browser-shell-tool.tbl
        !launchApi?.getWorkflowOverviewEmbeddingMountDomContract ||
        !launchApi?.getWorkflowOverviewEmbeddingMountDomReadiness ||
        !launchApi?.renderWorkflowOverviewEmbeddingMountState ||
+        !launchApi?.mountWorkflowOverviewEmbeddingMountState ||
        !launchApi?.isSupportedShellSessionHandoffPackage
      ) {
        throw new Error("launch API namespace did not expose shell integration helpers");
@@ -355,6 +356,11 @@ TOOL_TABLE = browser-shell-tool.tbl
        contract: workflowOverviewEmbeddingMountDomContract,
        documentRef: document,
      });
+      const workflowOverviewEmbeddingMountDomMount = launchApi.mountWorkflowOverviewEmbeddingMountState({
+        renderState: workflowOverviewEmbeddingMountRenderState,
+        contract: workflowOverviewEmbeddingMountDomContract,
+        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");
@@ -393,6 +399,10 @@ TOOL_TABLE = browser-shell-tool.tbl
      assertEqual(workflowOverviewEmbeddingMountDomContract.rowDatasetKeys.detail[0], "externalOverviewEmbeddingMountValue", "shell workflow overview embedding mount DOM detail key");
      assertEqual(workflowOverviewEmbeddingMountDomReadiness.ready, false, "shell workflow overview embedding mount DOM readiness");
      assertEqual(workflowOverviewEmbeddingMountDomReadiness.missing.join(","), "mount,status,rows", "shell workflow overview embedding mount DOM missing");
+      assertEqual(workflowOverviewEmbeddingMountDomMount.apiName, "ini-panel-shell-workflow-overview-embedding-mount-dom-mount", "shell workflow overview embedding mount DOM mount API");
+      assertEqual(workflowOverviewEmbeddingMountDomMount.ready, false, "shell workflow overview embedding mount DOM mount readiness");
+      assertEqual(workflowOverviewEmbeddingMountDomMount.renderResult, null, "shell workflow overview embedding mount DOM mount render result");
+      assertEqual(workflowOverviewEmbeddingMountDomMount.statusLine, "Blocked: mount, status, rows", "shell workflow overview embedding mount DOM mount status");

      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
@@ -47,7 +47,8 @@
        !workflowApi?.getWorkflowOverviewEmbeddingMountRenderState ||
        !workflowApi?.getWorkflowOverviewEmbeddingMountDomContract ||
        !workflowApi?.getWorkflowOverviewEmbeddingMountDomReadiness ||
-        !workflowApi?.renderWorkflowOverviewEmbeddingMountState
+        !workflowApi?.renderWorkflowOverviewEmbeddingMountState ||
+        !workflowApi?.mountWorkflowOverviewEmbeddingMountState
      ) {
        throw new Error("workflow overview API namespace did not expose overview helpers");
      }
@@ -146,11 +147,18 @@
      const embeddingMountRenderResult = workflowApi.renderWorkflowOverviewEmbeddingMountState(
        embeddingMountRenderState,
      );
+      const embeddingMountDomMount = workflowApi.mountWorkflowOverviewEmbeddingMountState({
+        renderState: embeddingMountRenderState,
+      });
      assertEqual(embeddingMountDomReadinessReady.ready, true, "workflow overview embedding mount ready DOM readiness");
      assertEqual(embeddingMountDomReadinessReady.missing.join(","), "", "workflow overview embedding mount ready DOM missing");
      assertEqual(embeddingMountRenderResult.rendered, true, "workflow overview embedding mount render result");
      assertEqual(embeddingMountRenderResult.rowCount, 7, "workflow overview embedding mount render row count");
      assertEqual(embeddingMountRenderResult.dataset.handoffScope, "workflow-overview-embedding-mount", "workflow overview embedding mount render scope");
+      assertEqual(embeddingMountDomMount.apiName, "ini-panel-shell-workflow-overview-embedding-mount-dom-mount", "workflow overview embedding mount DOM mount API");
+      assertEqual(embeddingMountDomMount.ready, false, "workflow overview embedding mount DOM mount readiness");
+      assertEqual(embeddingMountDomMount.renderResult.rowCount, 7, "workflow overview embedding mount DOM mount row count");
+      assertEqual(embeddingMountDomMount.error, null, "workflow overview embedding mount DOM mount error");
      assertEqual(embeddingMountStatus.textContent, embeddingMountRenderState.statusLine, "workflow overview embedding mount rendered status");
      assertEqual(
        workflowDoc.querySelector("[data-handoff-workflow]").dataset.handoffScope,
--- a/wasm-port/tests/ui/node/verify_ini_panel_entry_docs.mjs
+++ b/wasm-port/tests/ui/node/verify_ini_panel_entry_docs.mjs
@@ -52,6 +52,7 @@ import {
  createIniPanelShellWorkflowOverviewEmbeddingMountDomContract,
  createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness,
  renderIniPanelShellWorkflowOverviewEmbeddingMountState,
+  mountIniPanelShellWorkflowOverviewEmbeddingMountState,
  renderIniPanelShellSessionHandoffWorkflowState,
  mountIniPanelShellSessionHandoffWorkflow,
  renderIniPanelShellSessionHandoffMountState,
@@ -145,6 +146,7 @@ const requiredShellExports = [
  "createIniPanelShellWorkflowOverviewEmbeddingMountDomContract",
  "createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness",
  "renderIniPanelShellWorkflowOverviewEmbeddingMountState",
+  "mountIniPanelShellWorkflowOverviewEmbeddingMountState",
  "renderIniPanelShellSessionHandoffWorkflowState",
  "mountIniPanelShellSessionHandoffWorkflow",
  "renderIniPanelShellSessionHandoffMountState",
@@ -456,6 +458,7 @@ assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEm
 assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEmbeddingMountDomContract\b/);
 assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness\b/);
 assert.match(shellText, /\bexport function renderIniPanelShellWorkflowOverviewEmbeddingMountState\b/);
+assert.match(shellText, /\bexport function mountIniPanelShellWorkflowOverviewEmbeddingMountState\b/);
 assert.match(shellText, /\bexport function isSupportedIniPanelControlPageApiManifest\b/);
 assert.match(shellText, /\bexport function isSupportedIniPanelLaunchApiManifest\b/);
 assert.match(shellText, /\bexport function isSupportedIniPanelShellIntegrationManifest\b/);
@@ -496,6 +499,7 @@ assert.match(launchText, /\bgetWorkflowOverviewEmbeddingMountRenderState\b/);
 assert.match(launchText, /\bgetWorkflowOverviewEmbeddingMountDomContract\b/);
 assert.match(launchText, /\bgetWorkflowOverviewEmbeddingMountDomReadiness\b/);
 assert.match(launchText, /\brenderWorkflowOverviewEmbeddingMountState\b/);
+assert.match(launchText, /\bmountWorkflowOverviewEmbeddingMountState\b/);
 assert.match(launchText, /\bisSupportedShellSessionHandoffPackage\b/);
 assert.match(launchText, /\bdata-handoff-shell\b/);
 assert.match(launchText, /\bdata-handoff-status\b/);
@@ -541,6 +545,7 @@ assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingMountRender
 assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingMountDomContract\b/);
 assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness\b/);
 assert.match(docText, /\brenderIniPanelShellWorkflowOverviewEmbeddingMountState\b/);
+assert.match(docText, /\bmountIniPanelShellWorkflowOverviewEmbeddingMountState\b/);
 assert.match(docText, /\bisSupportedIniPanelControlPageApiManifest\b/);
 assert.match(docText, /\bisSupportedIniPanelLaunchApiManifest\b/);
 assert.match(docText, /\bisSupportedIniPanelShellIntegrationManifest\b/);
@@ -576,6 +581,7 @@ assert.match(docText, /\blinuxCncIniPanelLaunchApi\.getWorkflowOverviewEmbedding
 assert.match(docText, /\blinuxCncIniPanelLaunchApi\.getWorkflowOverviewEmbeddingMountDomContract\b/);
 assert.match(docText, /\blinuxCncIniPanelLaunchApi\.getWorkflowOverviewEmbeddingMountDomReadiness\b/);
 assert.match(docText, /\blinuxCncIniPanelLaunchApi\.renderWorkflowOverviewEmbeddingMountState\b/);
+assert.match(docText, /\blinuxCncIniPanelLaunchApi\.mountWorkflowOverviewEmbeddingMountState\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
@@ -91,6 +91,7 @@ assert.deepEqual(manifest, {
    "getWorkflowOverviewEmbeddingMountDomContract",
    "getWorkflowOverviewEmbeddingMountDomReadiness",
    "renderWorkflowOverviewEmbeddingMountState",
+    "mountWorkflowOverviewEmbeddingMountState",
    "isSupportedShellSessionHandoffPackage",
    "getLauncherLinks",
    "getControlPageApiMethods",
@@ -246,6 +247,7 @@ assert.match(launchText, /\bgetWorkflowOverviewEmbeddingMountRenderState\b/);
 assert.match(launchText, /\bgetWorkflowOverviewEmbeddingMountDomContract\b/);
 assert.match(launchText, /\bgetWorkflowOverviewEmbeddingMountDomReadiness\b/);
 assert.match(launchText, /\brenderWorkflowOverviewEmbeddingMountState\b/);
+assert.match(launchText, /\bmountWorkflowOverviewEmbeddingMountState\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
@@ -48,6 +48,7 @@ import {
  createIniPanelShellWorkflowOverviewEmbeddingMountDomContract,
  createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness,
  renderIniPanelShellWorkflowOverviewEmbeddingMountState,
+  mountIniPanelShellWorkflowOverviewEmbeddingMountState,
  renderIniPanelShellSessionHandoffWorkflowState,
  mountIniPanelShellSessionHandoffWorkflow,
  createIniPanelShellSessionHandoffPackageReport,
@@ -176,7 +177,7 @@ assert.deepEqual(readiness, {
  counts: {
    pages: 3,
    launcherLinks: 3,
-    launchMethods: 54,
+    launchMethods: 55,
    controlPageMethods: 11,
    persistenceCapabilities: 3,
  },
@@ -238,7 +239,7 @@ assert.deepEqual(handoffSummary, {
    counts: {
      pages: 3,
      launcherLinks: 3,
-      launchMethods: 54,
+      launchMethods: 55,
      controlPageMethods: 11,
      persistenceCapabilities: 3,
    },
@@ -806,6 +807,7 @@ assert.equal(typeof createIniPanelShellWorkflowOverviewEmbeddingMountRenderState
 assert.equal(typeof createIniPanelShellWorkflowOverviewEmbeddingMountDomContract, "function");
 assert.equal(typeof createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness, "function");
 assert.equal(typeof renderIniPanelShellWorkflowOverviewEmbeddingMountState, "function");
+assert.equal(typeof mountIniPanelShellWorkflowOverviewEmbeddingMountState, "function");
 assert.deepEqual(
  createIniPanelShellWorkflowOverviewReadiness({
    overviewApi: {
@@ -1234,7 +1236,7 @@ assert.deepEqual(createIniPanelShellIntegrationReadiness(blockedManifest), {
  counts: {
    pages: 3,
    launcherLinks: 3,
-    launchMethods: 54,
+    launchMethods: 55,
    controlPageMethods: 11,
    persistenceCapabilities: 3,
  },
@@ -1428,6 +1430,7 @@ assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEm
 assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEmbeddingMountDomContract\b/);
 assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness\b/);
 assert.match(shellText, /\bexport function renderIniPanelShellWorkflowOverviewEmbeddingMountState\b/);
+assert.match(shellText, /\bexport function mountIniPanelShellWorkflowOverviewEmbeddingMountState\b/);
 assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffPackageRenderState\b/);
 assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffPackageSchema\b/);
 assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffRenderState\b/);
@@ -1477,6 +1480,7 @@ assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingMountRender
 assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingMountDomContract\b/);
 assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness\b/);
 assert.match(docText, /\brenderIniPanelShellWorkflowOverviewEmbeddingMountState\b/);
+assert.match(docText, /\bmountIniPanelShellWorkflowOverviewEmbeddingMountState\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
@@ -48,6 +48,7 @@ import {
  createIniPanelShellWorkflowOverviewEmbeddingMountDomContract,
  createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness,
  renderIniPanelShellWorkflowOverviewEmbeddingMountState,
+  mountIniPanelShellWorkflowOverviewEmbeddingMountState,
  renderIniPanelShellSessionHandoffWorkflowState,
  mountIniPanelShellSessionHandoffWorkflow,
  renderIniPanelShellSessionHandoffMountState,
@@ -146,6 +147,7 @@ assert.equal(typeof createIniPanelShellWorkflowOverviewEmbeddingMountRenderState
 assert.equal(typeof createIniPanelShellWorkflowOverviewEmbeddingMountDomContract, "function");
 assert.equal(typeof createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness, "function");
 assert.equal(typeof renderIniPanelShellWorkflowOverviewEmbeddingMountState, "function");
+assert.equal(typeof mountIniPanelShellWorkflowOverviewEmbeddingMountState, "function");
 assert.equal(typeof renderIniPanelShellSessionHandoffWorkflowState, "function");
 assert.equal(typeof mountIniPanelShellSessionHandoffWorkflow, "function");
 assert.equal(typeof renderIniPanelShellSessionHandoffMountState, "function");
@@ -859,6 +861,10 @@ assert.equal(
  shellViewModel.renderWorkflowOverviewEmbeddingMountState,
  renderIniPanelShellWorkflowOverviewEmbeddingMountState,
 );
+assert.equal(
+  shellViewModel.mountWorkflowOverviewEmbeddingMountState,
+  mountIniPanelShellWorkflowOverviewEmbeddingMountState,
+);
 assert.equal(shellViewModel.createShellSessionHandoffPackageReport, createIniPanelShellSessionHandoffPackageReport);
 assert.equal(shellViewModel.createShellSessionHandoffPackageSchema, createIniPanelShellSessionHandoffPackageSchema);
 assert.equal(shellViewModel.isSupportedShellSessionHandoffPackage, isSupportedIniPanelShellSessionHandoffPackage);
@@ -1669,6 +1675,44 @@ assert.deepEqual(
 assert.equal(mountRowsNode.children[0].dataset.workflowOverviewEmbeddingMountRow, "mount-ready");
 assert.equal(mountRowsNode.children[1].dataset.workflowOverviewEmbeddingMountValue, "mount-ready");
 assert.equal(mountRowsNode.children[1].dataset.workflowOverviewEmbeddingMountStatus, "blocked");
+const workflowOverviewEmbeddingMountDomMount = mountIniPanelShellWorkflowOverviewEmbeddingMountState({
+  renderState: createIniPanelShellWorkflowOverviewEmbeddingMountRenderState(
+    createIniPanelShellWorkflowOverviewEmbeddingMountDisplayViewModel(workflowOverviewEmbeddingMountResult),
+  ),
+  documentRef: mountDocument,
+  mountNode,
+  statusNode: mountStatusNode,
+  rowsNode: mountRowsNode,
+});
+assert.equal(
+  workflowOverviewEmbeddingMountDomMount.apiName,
+  "ini-panel-shell-workflow-overview-embedding-mount-dom-mount",
+);
+assert.equal(workflowOverviewEmbeddingMountDomMount.workflowVersion, 1);
+assert.equal(workflowOverviewEmbeddingMountDomMount.phase, "blocked");
+assert.equal(workflowOverviewEmbeddingMountDomMount.ready, false);
+assert.equal(workflowOverviewEmbeddingMountDomMount.statusLine, "Blocked: mount:blocked");
+assert.equal(workflowOverviewEmbeddingMountDomMount.renderResult.rowCount, 7);
+assert.equal(
+  workflowOverviewEmbeddingMountDomMount.renderResult.dataset.handoffScope,
+  "workflow-overview-embedding-mount",
+);
+assert.equal(workflowOverviewEmbeddingMountDomMount.error, null);
+assert.deepEqual(
+  mountIniPanelShellWorkflowOverviewEmbeddingMountState({ documentRef: null }),
+  {
+    apiName: "ini-panel-shell-workflow-overview-embedding-mount-dom-mount",
+    workflowVersion: 1,
+    phase: "blocked",
+    ready: false,
+    statusLine: "Blocked: document, mount, status, rows",
+    contract: createIniPanelShellWorkflowOverviewEmbeddingMountDomContract(),
+    domReadiness: createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness({ documentRef: null }),
+    renderState: createIniPanelShellWorkflowOverviewEmbeddingMountRenderState(),
+    renderResult: null,
+    error: null,
+  },
+);
 assert.deepEqual(
  mountIniPanelShellWorkflowOverviewEmbedding({ overviewApi: null }).readiness.missing,
  shellViewModel.shellWorkflowOverviewContract.methodNames,