推进 INI 面板 shell integration workflow plan

text12.txt

@@ -1840,3 +1840,89 @@ host_wasm_opfs_browser_smokes=ok
 helper（例如 `createIniPanelShellIntegrationWorkflowPlan()`），让外部 shell 在不开 browser 的情况下
 获得 target page、readiness、required methods 与 readonly status handoff plan；仍保持只读，不新增
 控制按钮，不解析 G-code。
+
+二十三、2026-06-15 继续执行记录：INI panel shell integration workflow plan helper
+
+本轮按“第一原则：加快实质性推进”继续推进 SDK/API surface，把 shell integration browser workflow
+的只读 handoff 抽成 Node 可测 helper，让外部 shell 在不开 browser 的情况下获得 control-page target、
+readiness、required methods 与 readonly status handoff plan。
+
+完成内容：
+
+- `wasm-port/runtime/ui/ini-panel/ui-shell.js` 新增
+  `createIniPanelShellIntegrationWorkflowPlan()`；
+- workflow plan 从 integration manifest 与 readiness 派生：
+  - `phase: "ready" | "blocked"`；
+  - `ready`；
+  - `controlEntryId`；
+  - `targetPage`；
+  - `readiness`；
+  - `requiredLaunchApiMethods`；
+  - `requiredControlPageApiMethods`；
+  - `missingLaunchApiMethods`；
+  - `missingControlPageApiMethods`；
+  - `missing`；
+  - `readonlyStatusHandoff.loadSessionStateMethod`；
+  - `readonlyStatusHandoff.readStatusMethod`；
+  - `readonlyStatusHandoff.expectedStatusFields`；
+- `createIniPanelShellViewModel()` 新增：
+  - `shellIntegrationWorkflowPlan`；
+  - `createShellIntegrationWorkflowPlan`；
+- `verify_ini_panel_shell_integration_manifest.mjs` 覆盖：
+  - ready workflow plan 完整 shape；
+  - blocked readiness 传递到 plan missing；
+  - control target 缺失；
+  - control-page required method 缺失；
+  - readonly status handoff fields；
+- `verify_ini_panel_ui_shell.mjs` 覆盖 shell view-model 的 workflow plan；
+- `verify_ini_panel_entry_docs.mjs` 与 `docs/panel-entry.md` 记录并校验 workflow plan helper；
+- 未新增控制按钮；
+- 未解析 G-code；
+- 未解释 canonical events；
+- 未访问 OPFS 或启动 browser/frame；
+- 未改变 OPFS/session persistence、LinuxCNC interpreter、tool、parameter、planner 或
+  LinuxCNC-owned runtime semantics。
+
+验证已通过：
+
+```bash
+git diff --check
+wasm-port/tests/ui/node/verify_ini_panel_shell_integration_manifest.sh
+wasm-port/tests/ui/node/verify_ini_panel_ui_shell.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_shell_integration_manifest_node_smoke=ok
+ini_panel_ui_shell_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_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
+```
+
+下一步建议：
+
+继续推进 OPFS/session persistence。下一批建议把 workflow plan 扩展为包含 session handoff summary
+helper（例如 `createIniPanelShellSessionHandoffSummary()`），把 readiness、target page、readonly
+status fields 与 persistence capabilities 压成外部 shell 可直接显示的一页摘要；仍保持只读，不新增
+控制按钮，不解析 G-code。