暴露 workflow overview 发布 artifact 校验 API

text14.txt

@@ -3000,3 +3000,81 @@ project_release_gate=ok
 
 继续只做实质能力推进。优先选择真实 browser/UI workflow 或外部 shell 可消费能力；
 如果继续 release 路径，必须继续产出可调用 API、可验证 workflow、可执行 gate 或可消费 artifact。
+
+三十八、2026-06-16 继续执行记录：workflow overview release readiness artifact browser API
+
+本轮继续按“每批必须产出可调用 API、可验证 workflow、可执行 gate、或真实 UI/browser 能力”推进，
+把 project release readiness artifact validation 从 SDK/host workflow 推进到真实 browser workflow overview
+iframe API。外部 shell 现在可以向 workflow overview iframe 传入 readiness artifact JSON，并获得稳定的
+只读 validation report。
+
+完成内容：
+
+- `ui-shell.js` 新增：
+  - `validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson()`；
+- `createIniPanelShellWorkflowOverviewContract().methodNames` 新增：
+  - `validateWorkflowOverviewReleaseReadinessArtifactJson`；
+- `workflow-overview.html` 的 `linuxCncIniPanelWorkflowOverviewApi` 暴露：
+  - `validateWorkflowOverviewReleaseReadinessArtifactJson()`；
+- 该 API：
+  - 解析 project release readiness artifact JSON；
+  - 复用 SDK `createProjectReleaseReadinessArtifactValidation()`；
+  - 返回 `ini-panel-shell-workflow-overview-release-readiness-artifact-validation`；
+  - 返回 `phase/ready/missing/error/artifactApiName/artifactVersion/gateCount/rows/validation`；
+  - 对 malformed JSON 返回结构化 blocked result；
+- `runtime/sdk/src/index.js` re-export workflow overview artifact validation wrapper；
+- `verify_ini_panel_ui_shell.mjs` 覆盖 ready artifact 和 malformed JSON；
+- `verify_ini_panel_shell_integration_manifest.mjs` 覆盖 contract/readiness 新 method；
+- `ini_panel_workflow_overview_smoke.html` 在真实 iframe 中调用新 API；
+- `ini_panel_shell_integration_workflow_smoke.html` 从外部 shell iframe 调用新 API；
+- `docs/panel-entry.md`、`docs/project-release-handoff.md`、`runtime/sdk/README.md` 记录外部调用方式；
+- `verify_ini_panel_entry_docs.mjs`、`verify_project_release_handoff_docs.mjs`、`verify_sdk_surface.mjs`
+  覆盖新 API；
+- `PROJECT_COMPLETION_TRACKER.md` 同步 latest completed batch 和 Browser/UI workflow 状态；
+- 未新增控制按钮；
+- 未执行 release gate/action-plan；
+- 未解析 G-code；
+- 未解释 canonical events；
+- 未新增 JS CNC 语义；
+- 未运行 opt-in runtime probes；
+- 未 promotion blocked runtime family；
+- 未改变 LinuxCNC interpreter、tool、parameter、planner、kinematics、remap 或 LinuxCNC-owned
+  runtime semantics。
+
+验证已通过：
+
+```bash
+git diff --check
+wasm-port/tests/sdk/node/verify_sdk_surface.sh
+wasm-port/tests/ui/node/verify_ini_panel_ui_shell.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/tests/docs/node/verify_project_release_handoff_docs.sh
+wasm-port/tools/verify_vendor_sync.sh
+wasm-port/tools/verify_no_standalone_cnc_semantics.sh
+wasm-port/tests/host/verify_project_release_gate.sh
+```
+
+关键输出：
+
+```text
+sdk_surface_node_smoke=ok
+ini_panel_ui_shell_node_smoke=ok
+ini_panel_shell_integration_manifest_node_smoke=ok
+ini_panel_entry_docs_node_smoke=ok
+ui_node_smokes=ok
+browser_ini_workflow_overview_smoke=ok
+browser_ini_shell_integration_workflow_smoke=ok
+project_release_handoff_docs_node_smoke=ok
+vendor sync up to date
+standalone CNC semantics guard complete
+project_release_readiness_artifact_node_smoke=ok
+project_release_gate=ok
+```
+
+下一步工作计划：
+
+继续只做实质能力推进。优先选择真实 browser/UI workflow 或外部 shell 可消费能力；
+如果继续 release 路径，必须继续产出可调用 API、可验证 workflow、可执行 gate 或可消费 artifact。