暴露 workflow overview 发布 artifact 校验 API

2026-06-16 09:46:29 +08:00
parent 7177a29fc6
commit 23f337834b
15 changed files with 300 additions and 2 deletions
--- a/PROJECT_COMPLETION_TRACKER.md
+++ b/PROJECT_COMPLETION_TRACKER.md
@@ -9,7 +9,7 @@ turn-by-turn continuation notes and next-batch execution records.
 ## Current Status

 - Active continuation file: `text14.txt`
- Latest completed batch: project release readiness artifact validation workflow
+- Latest completed batch: workflow overview release readiness artifact browser API
 - Latest relevant commit: use `git log -1 --oneline` after each committed batch
 - Working tree at tracker creation: clean
 - Required policy: LinuxCNC remains the only CNC semantic source
@@ -44,7 +44,7 @@ The project is complete for the current scope when all of the following are true
 | Native sim configs baseline | Stable | Last recorded Layer 2: `total 159`, `pass 151`, `expected_fail 8`, `unexpected_fail 0`. |
 | OPFS/session persistence | Stable for current scope | Browser smoke passes, SDK re-exports OPFS/session helpers including `readMachineSessionReadiness()` and `createMachineSessionPersistenceSummary()`, the UI exposes `getMachineSessionPersistenceSummary()`, and `docs/opfs-session-persistence.md` defines the project-level release gate. |
 | SDK/API surface | Stable for current scope | SDK re-exports core, OPFS/session readiness/load helpers, sim-config staging, project release readiness report/artifact validation, INI panel entry/launcher/control-page/shell/workflow overview helpers, the session readiness workflow report, and the shell API surface inventory with a Node surface smoke. |
-| Browser/UI workflow | Stable for current scope | Workflow overview embedding mount DOM closure is complete, and INI panel session workflows plus read-only control/shell handoff expose, render, and report OPFS/session readiness, OPFS/session persistence summary, and API surface inventory before loading or reading WASM session state. |
+| Browser/UI workflow | Stable for current scope | Workflow overview embedding mount DOM closure is complete, and INI panel session workflows plus read-only control/shell handoff expose, render, and report OPFS/session readiness, OPFS/session persistence summary, release readiness artifact validation, and API surface inventory before loading or reading WASM session state. |
 | Workflow overview embedding | Stable for current scope | Report/display/render, DOM contract/readiness/renderer, mount result/display/render, mount DOM contract/readiness/renderer/wrapper exist. |
 | Host/runtime boundary proof | Stable blocked state | Host smoke passes; runtime families remain blocked and `docs/host-runtime-boundary-handoff.md` records host readiness, promotion blockers, dispatch, and evidence gates. |
 | Documentation/release gate | Stable for current scope | `docs/project-release-handoff.md` links README, panel entry, SDK, OPFS/session, sim-config, host/runtime, source reuse, drift, tracker acceptance paths, and the machine-readable release readiness report/artifact. |
--- a/text14.txt
+++ b/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。
--- a/wasm-port/docs/panel-entry.md
+++ b/wasm-port/docs/panel-entry.md
@@ -63,6 +63,7 @@ import {
  createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness,
  renderIniPanelShellWorkflowOverviewEmbeddingMountState,
  mountIniPanelShellWorkflowOverviewEmbeddingMountState,
+  validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson,
  renderIniPanelShellSessionHandoffWorkflowState,
  mountIniPanelShellSessionHandoffWorkflow,
  renderIniPanelShellSessionHandoffMountState,
@@ -149,6 +150,12 @@ status, and handoff readiness rows. The launch page exposes the same helper as
 `linuxCncIniPanelLaunchApi.getMachineSessionPersistenceSummary()`, and the
 workflow overview page exposes it as
 `linuxCncIniPanelWorkflowOverviewApi.getWorkflowOverviewPersistenceSummary()`.
+Use `validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson()` or
+`linuxCncIniPanelWorkflowOverviewApi.validateWorkflowOverviewReleaseReadinessArtifactJson()`
+when an outer shell needs to validate a project release readiness artifact JSON
+through the same read-only workflow overview surface. It parses the artifact,
+returns stable validation rows, and does not execute release gates or CNC
+behavior.
 Use `createMachineSessionPersistenceDisplayViewModel()` and
 `createMachineSessionPersistenceRenderState()` when that summary needs stable
 display text, rows, status line, and dataset fields for caller-owned DOM.
--- a/wasm-port/docs/project-release-handoff.md
+++ b/wasm-port/docs/project-release-handoff.md
@@ -44,6 +44,9 @@ continuation records are in `../text14.txt`.
  validates it with `verify_project_release_readiness_artifact.sh`. External
  tools can load that artifact with `parseProjectReleaseReadinessArtifactJson()`
  and validate it with `createProjectReleaseReadinessArtifactValidation()`.
+  Browser shells can also pass the JSON to
+  `linuxCncIniPanelWorkflowOverviewApi.validateWorkflowOverviewReleaseReadinessArtifactJson()`
+  through the workflow overview iframe and receive stable validation rows.
 - OPFS/session callers can use `createMachineSessionPersistenceSummary()` or
  `linuxCncIniPanelApi.getMachineSessionPersistenceSummary()` to inspect
  machine files, session snapshot, session readiness, session load, readonly
--- a/wasm-port/runtime/sdk/README.md
+++ b/wasm-port/runtime/sdk/README.md
@@ -82,6 +82,7 @@ import {
  saveTextFile,
  sessionSnapshotPath,
  toolTablePath,
+  validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson,
  validateSessionSnapshot,
 } from "./src/index.js";
 ```
@@ -263,6 +264,9 @@ for external browser shells:
  read-only `persistence-summary` row.
 - `createIniPanelShellWorkflowOverviewContract()` for discovering the workflow
  overview iframe API contract.
+- `validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson()` for the
+  read-only workflow overview artifact validation wrapper exposed by
+  `workflow-overview.html`.
 - `createIniPanelShellApiSurfaceInventory()` for a machine-readable inventory
  of launch, control-page, workflow overview, persistence, and session
  readiness report API counts, including persistence summary row counts.
--- a/wasm-port/runtime/sdk/src/index.js
+++ b/wasm-port/runtime/sdk/src/index.js
@@ -113,4 +113,5 @@ export {
  renderIniPanelShellSessionHandoffMountState,
  renderIniPanelShellWorkflowOverviewEmbeddingMountState,
  renderIniPanelShellWorkflowOverviewEmbeddingState,
+  validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson,
 } from "../../ui/ini-panel/ui-shell.js";
--- a/wasm-port/runtime/ui/ini-panel/ui-shell.js
+++ b/wasm-port/runtime/ui/ini-panel/ui-shell.js
@@ -31,6 +31,10 @@ import {
 import {
  createMachineSessionPersistenceSummary,
 } from "./panel-state-summary.js";
+import {
+  createProjectReleaseReadinessArtifactValidation,
+  parseProjectReleaseReadinessArtifactJson,
+} from "../../sdk/src/project-release-readiness.js";
 export {
  controlPageStatusText,
  createControlPageRefreshState,
@@ -72,6 +76,10 @@ export {
  createMachineSessionWorkflowOverview,
  createMachineSessionWorkflowStatus,
 } from "./panel-state-summary.js";
+export {
+  createProjectReleaseReadinessArtifactValidation,
+  parseProjectReleaseReadinessArtifactJson,
+} from "../../sdk/src/project-release-readiness.js";

 export function getVisibleIniPanelEntries() {
  return getIniPanelEntryManifest();
@@ -1865,6 +1873,7 @@ export function createIniPanelShellWorkflowOverviewContract() {
      "getWorkflowOverviewSessionReadinessReport",
      "getWorkflowOverviewApiSurfaceInventory",
      "getWorkflowOverviewPersistenceSummary",
+      "validateWorkflowOverviewReleaseReadinessArtifactJson",
      "getWorkflowOverviewDomContract",
      "getWorkflowOverviewDomReadiness",
      "renderWorkflowOverview",
@@ -1874,6 +1883,46 @@ export function createIniPanelShellWorkflowOverviewContract() {
  };
 }

+export function validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson(artifactJson) {
+  try {
+    const artifact = parseProjectReleaseReadinessArtifactJson(artifactJson);
+    const validation = createProjectReleaseReadinessArtifactValidation(artifact);
+    return {
+      apiName: "ini-panel-shell-workflow-overview-release-readiness-artifact-validation",
+      validationVersion: 1,
+      phase: validation.ready ? "ready" : "blocked",
+      ready: validation.ready,
+      missing: [...validation.missing],
+      error: null,
+      artifactApiName: validation.artifactApiName,
+      artifactVersion: validation.artifactVersion,
+      gateCount: validation.gateCount,
+      validation,
+      rows: [...validation.rows],
+    };
+  } catch (error) {
+    return {
+      apiName: "ini-panel-shell-workflow-overview-release-readiness-artifact-validation",
+      validationVersion: 1,
+      phase: "blocked",
+      ready: false,
+      missing: ["artifact-json"],
+      error: error?.message ?? "Unable to parse release readiness artifact JSON",
+      artifactApiName: null,
+      artifactVersion: null,
+      gateCount: 0,
+      validation: null,
+      rows: [
+        {
+          id: "artifact-json",
+          label: "Readiness artifact JSON",
+          value: "blocked",
+        },
+      ],
+    };
+  }
+}
+
 export function createIniPanelShellWorkflowOverviewReadiness({
  overviewApi = null,
  contract = createIniPanelShellWorkflowOverviewContract(),
--- a/wasm-port/runtime/ui/ini-panel/workflow-overview.html
+++ b/wasm-port/runtime/ui/ini-panel/workflow-overview.html
@@ -105,6 +105,7 @@
      createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness,
      renderIniPanelShellWorkflowOverviewEmbeddingMountState,
      mountIniPanelShellWorkflowOverviewEmbeddingMountState,
+      validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson,
      renderIniPanelShellSessionHandoffWorkflowState,
      mountIniPanelShellSessionHandoffWorkflow,
    } from "./ui-shell.js";
@@ -133,6 +134,9 @@
      getWorkflowOverviewPersistenceSummary: (options) => (
        createMachineSessionPersistenceSummary(options)
      ),
+      validateWorkflowOverviewReleaseReadinessArtifactJson: (artifactJson) => (
+        validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson(artifactJson)
+      ),
      getWorkflowOverviewDomContract: (options) => (
        createIniPanelShellSessionHandoffWorkflowDomContract(options)
      ),
--- a/wasm-port/tests/browser/ini_panel_shell_integration_workflow_smoke.html
+++ b/wasm-port/tests/browser/ini_panel_shell_integration_workflow_smoke.html
@@ -309,6 +309,39 @@ TOOL_TABLE = browser-shell-tool.tbl
      const workflowOverviewReadiness = launchApi.getWorkflowOverviewReadiness({
        overviewApi: workflowOverviewApi,
      });
+      const workflowOverviewReleaseArtifactValidation = workflowOverviewApi
+        .validateWorkflowOverviewReleaseReadinessArtifactJson(JSON.stringify({
+          apiName: "project-release-readiness-report",
+          reportVersion: 1,
+          phase: "ready",
+          ready: true,
+          missing: [],
+          releaseGate: {
+            command: "wasm-port/tests/host/verify_project_release_gate.sh",
+            passed: true,
+            expectedOutput: "project_release_gate=ok",
+          },
+          simConfigInventory: {
+            executed: 28,
+            passed: 28,
+            skipped: 131,
+            unexpectedFail: 0,
+          },
+          blockedRuntimeFamilies: [
+            "L4-USER-M-PROCESS",
+            "L4-TOOL-DB",
+            "L4-PYTHON-REMAP",
+          ],
+          promotedBlockedFamilies: [],
+          gates: Array.from({ length: 9 }, (_, index) => ({ id: `gate-${index}`, passed: true })),
+          rows: [
+            {
+              id: "project-release-gate",
+              label: "Project release gate",
+              value: "passed",
+            },
+          ],
+        }));
      const workflowOverviewEmbedding = launchApi.mountWorkflowOverviewEmbedding({
        overviewApi: workflowOverviewApi,
      });
@@ -370,6 +403,16 @@ TOOL_TABLE = browser-shell-tool.tbl
      });
      assertEqual(workflowOverviewReadiness.ready, true, "shell workflow overview iframe readiness");
      assertEqual(workflowOverviewReadiness.missing.join(","), "", "shell workflow overview iframe missing methods");
+      assertEqual(
+        workflowOverviewReleaseArtifactValidation.apiName,
+        "ini-panel-shell-workflow-overview-release-readiness-artifact-validation",
+        "shell workflow overview release artifact validation API",
+      );
+      assertEqual(
+        workflowOverviewReleaseArtifactValidation.ready,
+        true,
+        "shell workflow overview release artifact validation readiness",
+      );
      assertEqual(workflowOverviewEmbedding.apiName, "ini-panel-shell-workflow-overview-embedding", "shell workflow overview embedding API");
      assertEqual(workflowOverviewEmbedding.renderState.dataset.handoffScope, "workflow", "shell workflow overview embedding scope");
      assertEqual(workflowOverviewEmbedding.mountResult.renderResult.rowCount, 8, "shell workflow overview embedding rows");
--- a/wasm-port/tests/browser/ini_panel_workflow_overview_smoke.html
+++ b/wasm-port/tests/browser/ini_panel_workflow_overview_smoke.html
@@ -34,6 +34,7 @@
        !workflowApi?.getWorkflowOverviewSessionReadinessReport ||
        !workflowApi?.getWorkflowOverviewApiSurfaceInventory ||
        !workflowApi?.getWorkflowOverviewPersistenceSummary ||
+        !workflowApi?.validateWorkflowOverviewReleaseReadinessArtifactJson ||
        !workflowApi?.getWorkflowOverviewDomContract ||
        !workflowApi?.getWorkflowOverviewDomReadiness ||
        !workflowApi?.renderWorkflowOverview ||
@@ -62,6 +63,38 @@
      const sessionReadinessReport = workflowApi.getWorkflowOverviewSessionReadinessReport();
      const apiSurfaceInventory = workflowApi.getWorkflowOverviewApiSurfaceInventory();
      const persistenceSummary = workflowApi.getWorkflowOverviewPersistenceSummary();
+      const releaseArtifactValidation = workflowApi.validateWorkflowOverviewReleaseReadinessArtifactJson(JSON.stringify({
+        apiName: "project-release-readiness-report",
+        reportVersion: 1,
+        phase: "ready",
+        ready: true,
+        missing: [],
+        releaseGate: {
+          command: "wasm-port/tests/host/verify_project_release_gate.sh",
+          passed: true,
+          expectedOutput: "project_release_gate=ok",
+        },
+        simConfigInventory: {
+          executed: 28,
+          passed: 28,
+          skipped: 131,
+          unexpectedFail: 0,
+        },
+        blockedRuntimeFamilies: [
+          "L4-USER-M-PROCESS",
+          "L4-TOOL-DB",
+          "L4-PYTHON-REMAP",
+        ],
+        promotedBlockedFamilies: [],
+        gates: Array.from({ length: 9 }, (_, index) => ({ id: `gate-${index}`, passed: true })),
+        rows: [
+          {
+            id: "project-release-gate",
+            label: "Project release gate",
+            value: "passed",
+          },
+        ],
+      }));
      const domContract = workflowApi.getWorkflowOverviewDomContract();
      const domReadiness = workflowApi.getWorkflowOverviewDomReadiness();
      const renderResult = workflowApi.renderWorkflowOverview();
@@ -107,6 +140,13 @@
        "workflow overview persistence summary API name",
      );
      assertEqual(persistenceSummary.rows.length, 7, "workflow overview persistence summary rows");
+      assertEqual(
+        releaseArtifactValidation.apiName,
+        "ini-panel-shell-workflow-overview-release-readiness-artifact-validation",
+        "workflow overview release artifact validation API name",
+      );
+      assertEqual(releaseArtifactValidation.ready, true, "workflow overview release artifact validation readiness");
+      assertEqual(releaseArtifactValidation.gateCount, 9, "workflow overview release artifact validation gates");
      assertEqual(displayViewModel.title, "Shell handoff workflow", "workflow overview display title");
      assertEqual(renderState.renderStateVersion, 1, "workflow overview render-state version");
      assertEqual(renderState.dataset.handoffScope, "workflow", "workflow overview render-state scope");
--- a/wasm-port/tests/docs/node/verify_project_release_handoff_docs.mjs
+++ b/wasm-port/tests/docs/node/verify_project_release_handoff_docs.mjs
@@ -34,6 +34,7 @@ for (const phrase of [
  "createProjectReleaseReadinessReport()",
  "parseProjectReleaseReadinessArtifactJson()",
  "createProjectReleaseReadinessArtifactValidation()",
+  "validateWorkflowOverviewReleaseReadinessArtifactJson()",
  "createIniPanelShellApiSurfaceInventory()",
  "createIniPanelShellSessionReadinessWorkflowReport()",
  "workflow overview embedding mount DOM",
--- a/wasm-port/tests/sdk/node/verify_sdk_surface.mjs
+++ b/wasm-port/tests/sdk/node/verify_sdk_surface.mjs
@@ -63,6 +63,7 @@ import {
  saveTextFile,
  sessionSnapshotPath,
  toolTablePath,
+  validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson,
  validateSessionSnapshot,
 } from "../../../runtime/sdk/src/index.js";

@@ -78,6 +79,10 @@ const requiredExports = [
  ["createProjectReleaseReadinessArtifactValidation", createProjectReleaseReadinessArtifactValidation],
  ["createProjectReleaseReadinessReport", createProjectReleaseReadinessReport],
  ["parseProjectReleaseReadinessArtifactJson", parseProjectReleaseReadinessArtifactJson],
+  [
+    "validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson",
+    validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson,
+  ],
  ["planIniFileContextStaging", planIniFileContextStaging],
  ["planSimConfigStaging", planSimConfigStaging],
  ["analyzeIniRuntimeBoundaries", analyzeIniRuntimeBoundaries],
@@ -241,6 +246,10 @@ assert.deepEqual(
    "rows.project-release-gate",
  ],
 );
+assert.equal(
+  validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson(JSON.stringify(releaseReadinessArtifact)).ready,
+  true,
+);
 assert.equal(
  createProjectReleaseReadinessReport({
    observedOutputs: ["project_release_gate=ok"],
--- a/wasm-port/tests/ui/node/verify_ini_panel_entry_docs.mjs
+++ b/wasm-port/tests/ui/node/verify_ini_panel_entry_docs.mjs
@@ -53,6 +53,7 @@ import {
  createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness,
  renderIniPanelShellWorkflowOverviewEmbeddingMountState,
  mountIniPanelShellWorkflowOverviewEmbeddingMountState,
+  validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson,
  renderIniPanelShellSessionHandoffWorkflowState,
  mountIniPanelShellSessionHandoffWorkflow,
  renderIniPanelShellSessionHandoffMountState,
@@ -154,6 +155,7 @@ const requiredShellExports = [
  "createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness",
  "renderIniPanelShellWorkflowOverviewEmbeddingMountState",
  "mountIniPanelShellWorkflowOverviewEmbeddingMountState",
+  "validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson",
  "renderIniPanelShellSessionHandoffWorkflowState",
  "mountIniPanelShellSessionHandoffWorkflow",
  "renderIniPanelShellSessionHandoffMountState",
--- a/wasm-port/tests/ui/node/verify_ini_panel_shell_integration_manifest.mjs
+++ b/wasm-port/tests/ui/node/verify_ini_panel_shell_integration_manifest.mjs
@@ -51,6 +51,7 @@ import {
  createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness,
  renderIniPanelShellWorkflowOverviewEmbeddingMountState,
  mountIniPanelShellWorkflowOverviewEmbeddingMountState,
+  validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson,
  renderIniPanelShellSessionHandoffWorkflowState,
  mountIniPanelShellSessionHandoffWorkflow,
  createIniPanelShellSessionHandoffPackageReport,
@@ -780,6 +781,7 @@ assert.deepEqual(createIniPanelShellWorkflowOverviewContract(), {
    "getWorkflowOverviewSessionReadinessReport",
    "getWorkflowOverviewApiSurfaceInventory",
    "getWorkflowOverviewPersistenceSummary",
+    "validateWorkflowOverviewReleaseReadinessArtifactJson",
    "getWorkflowOverviewDomContract",
    "getWorkflowOverviewDomReadiness",
    "renderWorkflowOverview",
@@ -817,6 +819,11 @@ assert.equal(typeof createIniPanelShellWorkflowOverviewEmbeddingMountDomContract
 assert.equal(typeof createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness, "function");
 assert.equal(typeof renderIniPanelShellWorkflowOverviewEmbeddingMountState, "function");
 assert.equal(typeof mountIniPanelShellWorkflowOverviewEmbeddingMountState, "function");
+assert.equal(typeof validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson, "function");
+assert.equal(
+  validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson("{}").apiName,
+  "ini-panel-shell-workflow-overview-release-readiness-artifact-validation",
+);
 assert.deepEqual(
  createIniPanelShellWorkflowOverviewReadiness({
    overviewApi: {
@@ -829,6 +836,7 @@ assert.deepEqual(
    "getWorkflowOverviewDisplayViewModel",
    "getWorkflowOverviewSummary",
    "getWorkflowOverviewPersistenceSummary",
+    "validateWorkflowOverviewReleaseReadinessArtifactJson",
    "getWorkflowOverviewDomContract",
    "getWorkflowOverviewDomReadiness",
    "renderWorkflowOverview",
--- a/wasm-port/tests/ui/node/verify_ini_panel_ui_shell.mjs
+++ b/wasm-port/tests/ui/node/verify_ini_panel_ui_shell.mjs
@@ -51,6 +51,7 @@ import {
  createIniPanelShellWorkflowOverviewEmbeddingMountDomReadiness,
  renderIniPanelShellWorkflowOverviewEmbeddingMountState,
  mountIniPanelShellWorkflowOverviewEmbeddingMountState,
+  validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson,
  renderIniPanelShellSessionHandoffWorkflowState,
  mountIniPanelShellSessionHandoffWorkflow,
  renderIniPanelShellSessionHandoffMountState,
@@ -674,6 +675,7 @@ assert.deepEqual(shellViewModel.shellWorkflowOverviewContract, {
    "getWorkflowOverviewSessionReadinessReport",
    "getWorkflowOverviewApiSurfaceInventory",
    "getWorkflowOverviewPersistenceSummary",
+    "validateWorkflowOverviewReleaseReadinessArtifactJson",
    "getWorkflowOverviewDomContract",
    "getWorkflowOverviewDomReadiness",
    "renderWorkflowOverview",
@@ -1269,6 +1271,52 @@ assert.equal(workflowDomMountResult.ready, false);
 assert.equal(workflowDomMountResult.renderResult.rowCount, 8);
 assert.equal(workflowDomMountResult.renderResult.dataset.handoffScope, "workflow");
 assert.deepEqual(createIniPanelShellWorkflowOverviewContract(), shellViewModel.shellWorkflowOverviewContract);
+const releaseReadinessArtifactJson = JSON.stringify({
+  apiName: "project-release-readiness-report",
+  reportVersion: 1,
+  phase: "ready",
+  ready: true,
+  missing: [],
+  releaseGate: {
+    command: "wasm-port/tests/host/verify_project_release_gate.sh",
+    passed: true,
+    expectedOutput: "project_release_gate=ok",
+  },
+  simConfigInventory: {
+    executed: 28,
+    passed: 28,
+    skipped: 131,
+    unexpectedFail: 0,
+  },
+  blockedRuntimeFamilies: [
+    "L4-USER-M-PROCESS",
+    "L4-TOOL-DB",
+    "L4-PYTHON-REMAP",
+  ],
+  promotedBlockedFamilies: [],
+  gates: Array.from({ length: 9 }, (_, index) => ({ id: `gate-${index}`, passed: true })),
+  rows: [
+    {
+      id: "project-release-gate",
+      label: "Project release gate",
+      value: "passed",
+    },
+  ],
+});
+const releaseArtifactValidation = validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson(
+  releaseReadinessArtifactJson,
+);
+assert.equal(
+  releaseArtifactValidation.apiName,
+  "ini-panel-shell-workflow-overview-release-readiness-artifact-validation",
+);
+assert.equal(releaseArtifactValidation.ready, true);
+assert.equal(releaseArtifactValidation.validation.ready, true);
+assert.equal(releaseArtifactValidation.gateCount, 9);
+assert.deepEqual(
+  validateIniPanelShellWorkflowOverviewReleaseReadinessArtifactJson("{").missing,
+  ["artifact-json"],
+);
 assert.deepEqual(createIniPanelShellWorkflowOverviewReadiness(), {
  apiName: "ini-panel-shell-workflow-overview-readiness",
  readinessVersion: 1,
@@ -1284,6 +1332,7 @@ const workflowOverviewApi = {
  getWorkflowOverviewSessionReadinessReport: () => sessionReadinessWorkflowReport,
  getWorkflowOverviewApiSurfaceInventory: () => shellViewModel.shellApiSurfaceInventory,
  getWorkflowOverviewPersistenceSummary: () => shellViewModel.shellPersistenceSummary,
+  validateWorkflowOverviewReleaseReadinessArtifactJson: () => ({ ready: true }),
  getWorkflowOverviewDomContract: createIniPanelShellSessionHandoffWorkflowDomContract,
  getWorkflowOverviewDomReadiness: createIniPanelShellSessionHandoffWorkflowDomReadiness,
  renderWorkflowOverview: renderIniPanelShellSessionHandoffWorkflowState,