新增 release artifact validation action plan API

text14.txt

@@ -3308,6 +3308,67 @@ ui_node_smokes=ok
 继续只做实质能力推进。优先选择可执行 gate、SDK/API surface、或真实 browser workflow；
 不要做只整理断言或局部常量化的批次。
 
+五十一、2026-06-16 继续执行记录：project release readiness artifact validation action-plan API
+
+本轮继续按“每批必须产出可调用 API、可验证 workflow、可执行 gate、或真实 UI/browser 能力”推进，
+把 release readiness artifact validation 的 blocked 状态提升为外部可调用 action-plan API。外部
+CI/dashboard 现在可以在 artifact validation 不通过时直接拿到下一步命令、缺失 evidence 列表和可执行
+shell script，而不需要复制 host gate 或 artifact validator 的顺序。
+
+完成内容：
+
+- `runtime/sdk/src/project-release-readiness.js` 新增：
+  - `createProjectReleaseReadinessArtifactValidationActionPlan()`；
+- 新 action-plan 返回：
+  - `apiName: project-release-readiness-artifact-validation-action-plan`；
+  - `planVersion: 1`；
+  - `phase/ready`；
+  - `missing/missingCount`；
+  - `commandCount/nextActionId/nextCommand`；
+  - `commands[]`；
+  - `shellScript`；
+  - display `rows[]`；
+- ready validation 返回空 commands 和 ready shellScript；
+- blocked validation 返回：
+  - `wasm-port/tests/host/verify_project_release_gate.sh`；
+  - `wasm-port/tests/host/verify_project_release_readiness_artifact.sh build/project-release-readiness.json`；
+- `runtime/sdk/src/index.js` re-export 新 action-plan API；
+- `verify_project_release_gate_manifest.mjs` 覆盖 ready 和 stale/blocked artifact validation action-plan；
+- `verify_sdk_surface.mjs` 覆盖 SDK export、README 可发现性、ready shellScript 和 blocked nextCommand；
+- `runtime/sdk/README.md`、`docs/project-release-handoff.md`、`verify_project_release_handoff_docs.mjs`
+  记录 action-plan API；
+- `PROJECT_COMPLETION_TRACKER.md` 同步 latest completed batch 和 SDK/API surface 状态；
+- 未新增控制按钮；
+- 未执行 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。
+
+验证已通过（先行 targeted）：
+
+```bash
+wasm-port/tests/sdk/node/verify_project_release_gate_manifest.sh
+wasm-port/tests/sdk/node/verify_sdk_surface.sh
+wasm-port/tests/docs/node/verify_project_release_handoff_docs.sh
+```
+
+关键输出：
+
+```text
+project_release_gate_manifest_node_smoke=ok
+sdk_surface_node_smoke=ok
+project_release_handoff_docs_node_smoke=ok
+```
+
+下一步工作计划：
+
+继续只做实质能力推进。优先选择可执行 gate、SDK/API surface、或真实 browser workflow；
+不要做只整理断言或局部常量化的批次。
+
 五十、2026-06-16 继续执行记录：workflow overview release artifact URL workflow summary view-model API
 
 本轮继续按“每批必须产出可调用 API、可验证 workflow、可执行 gate、或真实 UI/browser 能力”推进，