新增发布 readiness artifact SDK 校验 workflow

text14.txt

@@ -2918,3 +2918,85 @@ artifact 摘要：
 
 继续只做实质能力推进。下一批优先选择真实 browser/UI workflow 或外部 shell 可消费能力；
 如果继续 release 路径，必须产出可执行 gate 或可消费 artifact，不再只做文档/记录补强。
+
+三十七、2026-06-16 继续执行记录：project release readiness artifact validation workflow
+
+本轮继续按“每批必须产出可调用 API、可验证 workflow、可执行 gate、或真实 UI/browser 能力”推进，
+把 release readiness artifact 从 host 测试里的硬编码断言推进为 SDK 可调用的 artifact parse/validation
+workflow。外部工具现在可以直接复用 SDK 校验 `build/project-release-readiness.json`，host gate verifier
+也改为复用同一套 SDK workflow。
+
+完成内容：
+
+- `runtime/sdk/src/project-release-readiness.js` 新增：
+  - `parseProjectReleaseReadinessArtifactJson()`；
+  - `createProjectReleaseReadinessArtifactValidation()`；
+- artifact validation 输出：
+  - `apiName: "project-release-readiness-artifact-validation"`；
+  - `validationVersion`；
+  - `phase`；
+  - `ready`；
+  - `missing`；
+  - `artifactApiName`；
+  - `artifactVersion`；
+  - `gateCount`；
+  - `blockedRuntimeFamilies`；
+  - `rows`；
+- 修复 artifact validation 中空 `gates` 数组会因 `Array.every()` 空真值被误判为 passed 的问题；
+- `runtime/sdk/src/index.js` re-export 新 parse/validation API；
+- `tests/host/verify_project_release_readiness_artifact.mjs` 改为调用 SDK parse/validation workflow；
+- `verify_sdk_surface.mjs` 覆盖：
+  - artifact JSON parse；
+  - ready artifact validation；
+  - 空 artifact blocked/missing；
+  - blocked runtime family 不被误 promotion；
+- `runtime/sdk/README.md` 和 `docs/project-release-handoff.md` 记录外部工具如何复用 artifact validation API；
+- `verify_project_release_handoff_docs.mjs` 覆盖新 artifact validation API；
+- `PROJECT_COMPLETION_TRACKER.md` 同步 latest completed batch、SDK/API surface 与 release gate wrapper 状态；
+- 未新增控制按钮；
+- 未执行 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/host/verify_project_release_readiness_artifact.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
+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/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/host/verify_project_release_gate.sh
+```
+
+关键输出：
+
+```text
+sdk_surface_node_smoke=ok
+project_release_readiness_artifact_node_smoke=ok
+project_release_handoff_docs_node_smoke=ok
+vendor sync up to date
+standalone CNC semantics guard complete
+interp_wasm_node_smoke=ok
+sim_configs_wasm_node_inventory_unexpected_fail=0
+ui_node_smokes=ok
+browser_ini_shell_integration_workflow_smoke=ok
+project_release_readiness_artifact=/home/cnc/桌面/cnc_wams/wasm-port/build/project-release-readiness.json
+host_wasm_opfs_browser_smokes=ok
+project_release_gate=ok
+```
+
+下一步工作计划：
+
+继续只做实质能力推进。优先选择真实 browser/UI workflow 或外部 shell 可消费能力；
+如果继续 release 路径，必须继续产出可调用 API、可验证 workflow、可执行 gate 或可消费 artifact。