新增 release artifact validation action plan API

wasm-port/tests/docs/node/verify_project_release_handoff_docs.mjs

@@ -38,6 +38,7 @@ for (const phrase of [
   "createProjectReleaseReadinessSummaryViewModel()",
   "parseProjectReleaseReadinessArtifactJson()",
   "createProjectReleaseReadinessArtifactValidation()",
+  "createProjectReleaseReadinessArtifactValidationActionPlan()",
   "createProjectReleaseReadinessArtifactValidationSummaryViewModel()",
   "embedded gate manifest, result matrix, and action plan",
   "validateWorkflowOverviewReleaseReadinessArtifactJson()",
@@ -110,6 +111,7 @@ for (const phrase of [
   "createProjectReleaseReadinessSummaryViewModel()",
   "parseProjectReleaseReadinessArtifactJson()",
   "createProjectReleaseReadinessArtifactValidation()",
+  "createProjectReleaseReadinessArtifactValidationActionPlan()",
   "createProjectReleaseReadinessArtifactValidationSummaryViewModel()",
   "gateManifestReady",
   "gateResultMatrixReady",

wasm-port/tests/sdk/node/verify_project_release_gate_manifest.mjs

@@ -5,6 +5,7 @@ import {
   createProjectReleaseGateManifest,
   createProjectReleaseGateResultMatrix,
   createProjectReleaseReadinessArtifactValidation,
+  createProjectReleaseReadinessArtifactValidationActionPlan,
   createProjectReleaseReadinessArtifactValidationSummaryViewModel,
   createProjectReleaseReadinessReport,
   createProjectReleaseReadinessSummaryViewModel,
@@ -176,6 +177,9 @@ assert.equal(
 const artifactValidationSummary = createProjectReleaseReadinessArtifactValidationSummaryViewModel(
   createProjectReleaseReadinessArtifactValidation(report),
 );
+const artifactValidationActionPlan = createProjectReleaseReadinessArtifactValidationActionPlan(
+  createProjectReleaseReadinessArtifactValidation(report),
+);
 assert.equal(
   artifactValidationSummary.apiName,
   "project-release-readiness-artifact-validation-summary-view-model",
@@ -193,11 +197,62 @@ assert.deepEqual(
     ["missing", "none"],
   ],
 );
+assert.deepEqual(artifactValidationActionPlan, {
+  apiName: "project-release-readiness-artifact-validation-action-plan",
+  planVersion: 1,
+  phase: "ready",
+  ready: true,
+  missing: [],
+  missingCount: 0,
+  commandCount: 0,
+  nextActionId: null,
+  nextCommand: null,
+  commands: [],
+  shellScript: "# Project release readiness artifact validation is already ready.\n",
+  rows: [
+    {
+      id: "artifact-validation",
+      label: "Artifact validation",
+      value: "ready",
+    },
+    {
+      id: "missing",
+      label: "Missing artifact evidence",
+      value: "none",
+    },
+    {
+      id: "next-command",
+      label: "Next command",
+      value: "none",
+    },
+  ],
+});
 const staleArtifactValidationSummary = createProjectReleaseReadinessArtifactValidationSummaryViewModel(
   createProjectReleaseReadinessArtifactValidation({}),
 );
+const staleArtifactValidation = createProjectReleaseReadinessArtifactValidation({});
+const staleArtifactValidationActionPlan = createProjectReleaseReadinessArtifactValidationActionPlan(staleArtifactValidation);
 assert.equal(staleArtifactValidationSummary.phase, "blocked");
 assert.match(staleArtifactValidationSummary.statusLine, /^Blocked: apiName, reportVersion/);
 assert.equal(staleArtifactValidationSummary.rows.find(({ id }) => id === "gate-action-plan")?.value, "missing");
+assert.equal(staleArtifactValidationActionPlan.phase, "blocked");
+assert.equal(staleArtifactValidationActionPlan.ready, false);
+assert.equal(staleArtifactValidationActionPlan.missingCount, staleArtifactValidation.missing.length);
+assert.equal(staleArtifactValidationActionPlan.commandCount, 2);
+assert.equal(staleArtifactValidationActionPlan.nextActionId, "project-release-gate");
+assert.equal(
+  staleArtifactValidationActionPlan.nextCommand,
+  "wasm-port/tests/host/verify_project_release_gate.sh",
+);
+assert.equal(
+  staleArtifactValidationActionPlan.commands[1].command,
+  "wasm-port/tests/host/verify_project_release_readiness_artifact.sh build/project-release-readiness.json",
+);
+assert.match(staleArtifactValidationActionPlan.shellScript, /^#!\/usr\/bin\/env bash\nset -euo pipefail\n/);
+assert.match(staleArtifactValidationActionPlan.shellScript, /verify_project_release_readiness_artifact\.sh/);
+assert.equal(
+  staleArtifactValidationActionPlan.rows.find(({ id }) => id === "missing")?.value,
+  staleArtifactValidation.missing.join(", "),
+);
 
 console.log("project_release_gate_manifest_node_smoke=ok");

wasm-port/tests/sdk/node/verify_sdk_surface.mjs

@@ -38,6 +38,7 @@ import {
   createProjectReleaseGateManifest,
   createProjectReleaseGateResultMatrix,
   createProjectReleaseReadinessArtifactValidation,
+  createProjectReleaseReadinessArtifactValidationActionPlan,
   createProjectReleaseReadinessArtifactValidationSummaryViewModel,
   createProjectReleaseReadinessReport,
   createProjectReleaseReadinessSummaryViewModel,
@@ -94,6 +95,10 @@ const requiredExports = [
   ["createProjectReleaseGateManifest", createProjectReleaseGateManifest],
   ["createProjectReleaseGateResultMatrix", createProjectReleaseGateResultMatrix],
   ["createProjectReleaseReadinessArtifactValidation", createProjectReleaseReadinessArtifactValidation],
+  [
+    "createProjectReleaseReadinessArtifactValidationActionPlan",
+    createProjectReleaseReadinessArtifactValidationActionPlan,
+  ],
   [
     "createProjectReleaseReadinessArtifactValidationSummaryViewModel",
     createProjectReleaseReadinessArtifactValidationSummaryViewModel,
@@ -329,6 +334,15 @@ assert.equal(
   ).statusLine,
   "Ready: Artifact evidence complete",
 );
+assert.equal(
+  createProjectReleaseReadinessArtifactValidationActionPlan(releaseReadinessArtifactValidation).shellScript,
+  "# Project release readiness artifact validation is already ready.\n",
+);
+assert.equal(
+  createProjectReleaseReadinessArtifactValidationActionPlan(createProjectReleaseReadinessArtifactValidation({}))
+    .nextCommand,
+  "wasm-port/tests/host/verify_project_release_gate.sh",
+);
 assert.deepEqual(
   createProjectReleaseReadinessArtifactValidation({}).missing,
   [