新增 release artifact validation action plan API

wasm-port/docs/project-release-handoff.md

@@ -56,6 +56,9 @@ continuation records are in `../text14.txt`.
   ready, so stale release JSON cannot pass the executable artifact gate.
   `createProjectReleaseReadinessArtifactValidationSummaryViewModel()` turns the
   validation into stable dashboard rows without reinterpreting artifact fields.
+  `createProjectReleaseReadinessArtifactValidationActionPlan()` turns a blocked
+  artifact validation into the project release gate and artifact validation
+  commands to run next, plus the missing evidence rows.
   Browser shells can also pass the JSON to
   `linuxCncIniPanelWorkflowOverviewApi.validateWorkflowOverviewReleaseReadinessArtifactJson()`
   through the workflow overview iframe and receive stable validation rows. They

wasm-port/runtime/sdk/README.md

@@ -57,6 +57,7 @@ import {
   createProjectReleaseGateManifest,
   createProjectReleaseGateResultMatrix,
   createProjectReleaseReadinessArtifactValidation,
+  createProjectReleaseReadinessArtifactValidationActionPlan,
   createProjectReleaseReadinessArtifactValidationSummaryViewModel,
   createProjectReleaseReadinessReport,
   createProjectReleaseReadinessSummaryViewModel,
@@ -232,6 +233,10 @@ chain fail the same executable gate.
 `createProjectReleaseReadinessArtifactValidationSummaryViewModel()` turns that
 validation result into stable status text and display rows for dashboards or
 browser shells without reinterpreting the artifact fields.
+`createProjectReleaseReadinessArtifactValidationActionPlan()` turns a blocked
+artifact validation result into the exact project release gate and artifact
+validation commands to run next, plus the missing evidence list and shell
+script. Ready validations return no commands.
 
 ## OPFS/session persistence exports
 

wasm-port/runtime/sdk/src/index.js

@@ -5,6 +5,7 @@ export {
   createProjectReleaseGateManifest,
   createProjectReleaseGateResultMatrix,
   createProjectReleaseReadinessArtifactValidation,
+  createProjectReleaseReadinessArtifactValidationActionPlan,
   createProjectReleaseReadinessArtifactValidationSummaryViewModel,
   createProjectReleaseReadinessReport,
   createProjectReleaseReadinessSummaryViewModel,

wasm-port/runtime/sdk/src/project-release-readiness.js

@@ -377,6 +377,69 @@ export function createProjectReleaseReadinessArtifactValidationSummaryViewModel(
   };
 }
 
+export function createProjectReleaseReadinessArtifactValidationActionPlan(
+  validation = createProjectReleaseReadinessArtifactValidation(),
+) {
+  const missing = arrayOrEmpty(validation?.missing);
+  const ready = validation?.ready === true;
+  const commands = ready ? [] : [
+    {
+      step: 1,
+      id: "project-release-gate",
+      label: "Run project release gate",
+      command: "wasm-port/tests/host/verify_project_release_gate.sh",
+      expectedOutput: "project_release_gate=ok",
+    },
+    {
+      step: 2,
+      id: "artifact-validation",
+      label: "Validate project release readiness artifact",
+      command: "wasm-port/tests/host/verify_project_release_readiness_artifact.sh build/project-release-readiness.json",
+      expectedOutput: "project_release_readiness_artifact_node_smoke=ok",
+    },
+  ];
+  const shellScript = commands.length > 0
+    ? [
+      "#!/usr/bin/env bash",
+      "set -euo pipefail",
+      "",
+      ...commands.map(({ command }) => command),
+      "",
+    ].join("\n")
+    : "# Project release readiness artifact validation is already ready.\n";
+
+  return {
+    apiName: "project-release-readiness-artifact-validation-action-plan",
+    planVersion: 1,
+    phase: ready ? "ready" : "blocked",
+    ready,
+    missing,
+    missingCount: missing.length,
+    commandCount: commands.length,
+    nextActionId: commands[0]?.id ?? null,
+    nextCommand: commands[0]?.command ?? null,
+    commands,
+    shellScript,
+    rows: [
+      {
+        id: "artifact-validation",
+        label: "Artifact validation",
+        value: ready ? "ready" : "blocked",
+      },
+      {
+        id: "missing",
+        label: "Missing artifact evidence",
+        value: missing.length > 0 ? missing.join(", ") : "none",
+      },
+      {
+        id: "next-command",
+        label: "Next command",
+        value: commands[0]?.command ?? "none",
+      },
+    ],
+  };
+}
+
 export function parseProjectReleaseReadinessArtifactJson(text) {
   return JSON.parse(String(text));
 }

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,
   [