diff --git a/.github/workflows/__test-action-helm-release-chart.yml b/.github/workflows/__test-action-helm-release-chart.yml index b5e4e19c..04bca793 100644 --- a/.github/workflows/__test-action-helm-release-chart.yml +++ b/.github/workflows/__test-action-helm-release-chart.yml @@ -78,15 +78,45 @@ jobs: helm-repositories: | valkey https://valkey.io/valkey-helm/ + - name: Arrange artifact input for the unsigned checksum rejection + id: artifact-name + if: ${{ !matrix.sign }} + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + env: + ARCHIVE: ${{ steps.prepare.outputs.archive }} + with: + script: | + core.setOutput('name', require('node:path').basename(process.env.ARCHIVE)); + + - name: Upload checksum rejection fixture + id: artifact + if: ${{ !matrix.sign }} + uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2 + with: + name: release-checksum-rejection-${{ github.run_id }}-${{ github.run_attempt }} + path: ${{ steps.prepare.outputs.archive }} + if-no-files-found: error + retention-days: 1 + - name: Act - Reject a mismatched archive before publication id: mismatch continue-on-error: true uses: $/actions/helm/release-chart with: - archive: ${{ steps.prepare.outputs.archive }} + archive: ${{ matrix.sign && steps.prepare.outputs.archive || '' }} + artifact-id: ${{ steps.artifact.outputs.artifact-id }} + archive-name: ${{ steps.artifact-name.outputs.name }} checksum: "0000000000000000000000000000000000000000000000000000000000000000" sign: false + - name: Assert failed publication cleans downloaded files + if: ${{ !matrix.sign }} + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + with: + script: | + const leftovers = require('node:fs').readdirSync(process.env.RUNNER_TEMP).filter(name => name.startsWith('helm-artifact-')); + if (leftovers.length) throw new Error(`Release action left downloaded archives: ${leftovers.join(', ')}`); + - name: Arrange - Remove source after preparation env: CHART_PATH: tests/charts/${{ matrix.chart.name }} diff --git a/.github/workflows/helm-chart-release.md b/.github/workflows/helm-chart-release.md index 8f8719a7..f1607198 100644 --- a/.github/workflows/helm-chart-release.md +++ b/.github/workflows/helm-chart-release.md @@ -24,8 +24,8 @@ Validate and publish the same prepared Helm chart archive. -This workflow reuses Helm chart CI, then downloads only its immutable artifact ID -in a separate publication job. The original checksum is checked before registry +This workflow reuses Helm chart CI, then passes its immutable artifact ID +to the release action in a separate publication job. The original checksum is checked before registry login; no source checkout, packaging or dependency rebuild occurs in publication. Validation uses read permissions and separate read-only image credentials. Only publication receives packages write and OIDC. A failed/skipped/cancelled diff --git a/.github/workflows/helm-chart-release.yml b/.github/workflows/helm-chart-release.yml index d4592d01..c9338ea1 100644 --- a/.github/workflows/helm-chart-release.yml +++ b/.github/workflows/helm-chart-release.yml @@ -1,7 +1,7 @@ # Validate and publish the same prepared Helm chart archive. # -# This workflow reuses Helm chart CI, then downloads only its immutable artifact ID -# in a separate publication job. The original checksum is checked before registry +# This workflow reuses Helm chart CI, then passes its immutable artifact ID +# to the release action in a separate publication job. The original checksum is checked before registry # login; no source checkout, packaging or dependency rebuild occurs in publication. # Validation uses read permissions and separate read-only image credentials. # Only publication receives packages write and OIDC. A failed/skipped/cancelled @@ -183,51 +183,15 @@ jobs: image-digest: ${{ job.status == 'success' && steps.release.outputs.image-digest || '' }} checksum: ${{ job.status == 'success' && needs.validate.outputs.checksum || '' }} steps: - - name: Require validated artifact identity - uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 - env: - ARTIFACT_ID: ${{ needs.validate.outputs.artifact-id }} - ARCHIVE_NAME: ${{ needs.validate.outputs.archive-name }} - CHECKSUM: ${{ needs.validate.outputs.checksum }} - with: - script: | - const path = require('node:path'); - const { ARTIFACT_ID, ARCHIVE_NAME, CHECKSUM } = process.env; - if (!/^[1-9][0-9]*$/.test(ARTIFACT_ID) || !/^[a-f0-9]{64}$/.test(CHECKSUM) - || !ARCHIVE_NAME.endsWith('.tgz') || path.basename(ARCHIVE_NAME) !== ARCHIVE_NAME) { - throw new Error('Successful validation must supply one artifact ID, archive basename and checksum.'); - } - - - name: Download exact validated archive - id: download - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2 - with: - artifact-ids: ${{ needs.validate.outputs.artifact-id }} - path: ${{ runner.temp }}/helm-publish-${{ needs.validate.outputs.artifact-id }} - digest-mismatch: error - - name: Publish and sign unchanged archive id: release uses: $/actions/helm/release-chart with: - archive: ${{ steps.download.outputs.download-path }}/${{ needs.validate.outputs.archive-name }} + artifact-id: ${{ needs.validate.outputs.artifact-id }} + archive-name: ${{ needs.validate.outputs.archive-name }} checksum: ${{ needs.validate.outputs.checksum }} oci-registry: ${{ inputs.oci-registry }} oci-registry-username: ${{ inputs.oci-registry-username || github.repository_owner }} oci-registry-password: ${{ secrets.oci-registry-password || github.token }} oci-repository: ${{ inputs.oci-repository || format('{0}/charts', github.repository) }} sign: ${{ inputs.sign }} - - - name: Clean downloaded archive - if: always() - uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 - env: - ARTIFACT_ID: ${{ needs.validate.outputs.artifact-id }} - with: - script: | - if (/^[1-9][0-9]*$/.test(process.env.ARTIFACT_ID)) { - const path = require('node:path'); - require('node:fs').rmSync(path.join(process.env.RUNNER_TEMP, `helm-publish-${process.env.ARTIFACT_ID}`), { - recursive: true, force: true, - }); - } diff --git a/actions/helm/release-chart/README.md b/actions/helm/release-chart/README.md index 6d6a6860..07b7d119 100644 --- a/actions/helm/release-chart/README.md +++ b/actions/helm/release-chart/README.md @@ -24,9 +24,14 @@ ## Overview Publish one prepared Helm chart archive to an OCI registry. -Requires the archive and its expected SHA-256 checksum. Lint and test those same -bytes before calling this action. The caller retains its archive; temporary -publication files and registry credentials are removed on success or failure. +Supply either a local archive or an immutable artifact-id and archive-name from +this workflow run, plus the archive's expected SHA-256 checksum. Lint and test +those same bytes before calling this action. Artifact input downloads only that +ID, fails on artifact digest mismatch, and verifies the archive checksum before +registry access. The caller retains local archives; downloaded archives, +temporary publication files and credentials are removed on success or failure. +Gate publication on successful validation. Publication-only retries reuse its +artifact ID and checksum; missing or expired artifacts require validation again. Signs the published chart digest with Cosign and GitHub Actions OIDC by default. Set `sign` to `false` to opt out and still consume the immutable digest output. Does not check out source, mutate values/metadata, rebuild dependencies or package. @@ -37,20 +42,22 @@ Push retries reuse a verified snapshot of the supplied archive. Ensures Helm is ## Inputs -| **Input** | **Description** | **Required** | **Default** | -| --------------------------- | ------------------------------------------------------------------------------------- | ------------ | --------------------------------- | -| **`oci-registry`** | OCI registry where to push chart. | **true** | `ghcr.io` | -| **`oci-registry-username`** | OCI registry username. | **true** | `${{ github.repository_owner }}` | -| **`oci-registry-password`** | OCI registry password. | **true** | `${{ github.token }}` | -| **`oci-repository`** | OCI namespace without the registry or final chart name. | **false** | `${{ github.repository }}/charts` | -| | Defaults to {owner}/{repository}/charts. The archive supplies its chart name/version. | | | -| | Set this explicitly to preserve a different publication namespace. | | | -| **`archive`** | Path to the prepared .tgz archive. Relative paths use the current working directory. | **true** | - | -| **`checksum`** | Expected SHA-256 of the archive bytes, as 64 lowercase hexadecimal characters. | **true** | - | -| **`sign`** | Sign the published OCI chart using Cosign and GitHub Actions OIDC. | **false** | `true` | -| | Enabled by default. Set to `false` to opt out. | | | -| | Requires `id-token: write` and write access to the OCI registry. | | | -| | Does not generate a Helm PGP provenance (.prov) file. | | | +| **Input** | **Description** | **Required** | **Default** | +| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | --------------------------------- | +| **`oci-registry`** | OCI registry where to push chart. | **true** | `ghcr.io` | +| **`oci-registry-username`** | OCI registry username. | **true** | `${{ github.repository_owner }}` | +| **`oci-registry-password`** | OCI registry password. | **true** | `${{ github.token }}` | +| **`oci-repository`** | OCI namespace without the registry or final chart name. | **false** | `${{ github.repository }}/charts` | +| | Defaults to {owner}/{repository}/charts. The archive supplies its chart name/version. | | | +| | Set this explicitly to preserve a different publication namespace. | | | +| **`archive`** | Path to the prepared .tgz archive. Relative paths use the current working directory. Mutually exclusive with artifact-id and archive-name. | **false** | - | +| **`artifact-id`** | One immutable artifact ID from this workflow run, such as helm-chart-ci's artifact-id output. Requires archive-name; mutually exclusive with archive. | **false** | - | +| **`archive-name`** | Prepared .tgz basename inside the artifact, such as helm-chart-ci's archive-name output. Required only with artifact-id. | **false** | - | +| **`checksum`** | Expected SHA-256 of the archive bytes, as 64 lowercase hexadecimal characters. | **true** | - | +| **`sign`** | Sign the published OCI chart using Cosign and GitHub Actions OIDC. | **false** | `true` | +| | Enabled by default. Set to `false` to opt out. | | | +| | Requires `id-token: write` and write access to the OCI registry. | | | +| | Does not generate a Helm PGP provenance (.prov) file. | | | @@ -102,7 +109,7 @@ This documentation was automatically generated by [CI Dokumentor](https://github ## Usage ```yaml -- uses: hoverkraft-tech/ci-github-container/actions/helm/release-chart@3feb56e45f82273a7eded46ac3b9364c08337cee # 3.0.0 +- uses: hoverkraft-tech/ci-github-container/actions/helm/release-chart@733a81feaab09ff9918cacc4f22f30c254e10527 # feat/helm-release-artifact-input with: # OCI registry where to push chart. # @@ -129,10 +136,15 @@ This documentation was automatically generated by [CI Dokumentor](https://github # Default: `${{ github.repository }}/charts` oci-repository: ${{ github.repository }}/charts - # Path to the prepared .tgz archive. Relative paths use the current working directory. - # This input is required. + # Path to the prepared .tgz archive. Relative paths use the current working directory. Mutually exclusive with artifact-id and archive-name. archive: "" + # One immutable artifact ID from this workflow run, such as helm-chart-ci's artifact-id output. Requires archive-name; mutually exclusive with archive. + artifact-id: "" + + # Prepared .tgz basename inside the artifact, such as helm-chart-ci's archive-name output. Required only with artifact-id. + archive-name: "" + # Expected SHA-256 of the archive bytes, as 64 lowercase hexadecimal characters. # This input is required. checksum: "" diff --git a/actions/helm/release-chart/action.yml b/actions/helm/release-chart/action.yml index 05518189..57bc0d12 100644 --- a/actions/helm/release-chart/action.yml +++ b/actions/helm/release-chart/action.yml @@ -2,9 +2,14 @@ name: "Release Helm Chart" description: | Publish one prepared Helm chart archive to an OCI registry. - Requires the archive and its expected SHA-256 checksum. Lint and test those same - bytes before calling this action. The caller retains its archive; temporary - publication files and registry credentials are removed on success or failure. + Supply either a local archive or an immutable artifact-id and archive-name from + this workflow run, plus the archive's expected SHA-256 checksum. Lint and test + those same bytes before calling this action. Artifact input downloads only that + ID, fails on artifact digest mismatch, and verifies the archive checksum before + registry access. The caller retains local archives; downloaded archives, + temporary publication files and credentials are removed on success or failure. + Gate publication on successful validation. Publication-only retries reuse its + artifact ID and checksum; missing or expired artifacts require validation again. Signs the published chart digest with Cosign and GitHub Actions OIDC by default. Set `sign` to `false` to opt out and still consume the immutable digest output. Does not check out source, mutate values/metadata, rebuild dependencies or package. @@ -37,8 +42,17 @@ inputs: Set this explicitly to preserve a different publication namespace. default: "${{ github.repository }}/charts" archive: - description: "Path to the prepared .tgz archive. Relative paths use the current working directory." - required: true + description: "Path to the prepared .tgz archive. Relative paths use the current working directory. Mutually exclusive with artifact-id and archive-name." + required: false + default: "" + artifact-id: + description: "One immutable artifact ID from this workflow run, such as helm-chart-ci's artifact-id output. Requires archive-name; mutually exclusive with archive." + required: false + default: "" + archive-name: + description: "Prepared .tgz basename inside the artifact, such as helm-chart-ci's archive-name output. Required only with artifact-id." + required: false + default: "" checksum: description: "Expected SHA-256 of the archive bytes, as 64 lowercase hexadecimal characters." required: true @@ -80,6 +94,38 @@ runs: throw new Error('Signing charts requires the workflow job to grant id-token: write.'); } + - name: Resolve archive input + id: archive + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + env: + ACTION_PATH: ${{ github.action_path }} + CHART_ARCHIVE: ${{ inputs.archive }} + ARTIFACT_ID: ${{ inputs.artifact-id }} + ARCHIVE_NAME: ${{ inputs.archive-name }} + CHART_CHECKSUM: ${{ inputs.checksum }} + with: + script: | + const { join } = require('node:path'); + const { pathToFileURL } = require('node:url'); + const { prepareArchiveInput } = await import(pathToFileURL(join(process.env.ACTION_PATH, 'src/archive.js'))); + const input = prepareArchiveInput({ + archive: process.env.CHART_ARCHIVE, + artifactId: process.env.ARTIFACT_ID, + archiveName: process.env.ARCHIVE_NAME, + expectedChecksum: process.env.CHART_CHECKSUM, + runnerTemp: process.env.RUNNER_TEMP, + }); + core.setOutput('archive', input.archive); + core.setOutput('directory', input.directory); + + - name: Download validated archive + if: inputs.artifact-id != '' + uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2 + with: + artifact-ids: ${{ inputs.artifact-id }} + path: ${{ steps.archive.outputs.directory }} + digest-mismatch: error + - name: Ensure Helm is available uses: $/actions/helm/setup @@ -88,7 +134,7 @@ runs: uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 env: ACTION_PATH: ${{ github.action_path }} - CHART_ARCHIVE: ${{ inputs.archive }} + CHART_ARCHIVE: ${{ steps.archive.outputs.archive }} CHART_CHECKSUM: ${{ inputs.checksum }} INPUT_REGISTRY: ${{ inputs.oci-registry }} INPUT_USERNAME: ${{ inputs.oci-registry-username }} @@ -118,3 +164,16 @@ runs: oci-registry-username: ${{ inputs.oci-registry-username }} oci-registry-password: ${{ inputs.oci-registry-password }} charts: ${{ steps.chart-releaser.outputs.image }}@${{ steps.chart-releaser.outputs.digest }} + + - name: Clean downloaded archive + if: always() && steps.archive.outputs.directory != '' + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + env: + ACTION_PATH: ${{ github.action_path }} + DOWNLOAD_DIRECTORY: ${{ steps.archive.outputs.directory }} + with: + script: | + const { join } = require('node:path'); + const { pathToFileURL } = require('node:url'); + const { cleanupArchiveInput } = await import(pathToFileURL(join(process.env.ACTION_PATH, 'src/archive.js'))); + cleanupArchiveInput(process.env.DOWNLOAD_DIRECTORY); diff --git a/actions/helm/release-chart/src/archive.js b/actions/helm/release-chart/src/archive.js new file mode 100644 index 00000000..26b46c30 --- /dev/null +++ b/actions/helm/release-chart/src/archive.js @@ -0,0 +1,44 @@ +import fs from "node:fs"; +import path from "node:path"; + +export function prepareArchiveInput({ + archive = "", + artifactId = "", + archiveName = "", + expectedChecksum, + runnerTemp, +}) { + if (!/^[a-f0-9]{64}$/.test(expectedChecksum ?? "")) { + throw new Error("A lowercase hexadecimal SHA-256 checksum is required."); + } + if (archive) { + if (artifactId || archiveName) { + throw new Error( + "Supply either archive or artifact-id with archive-name, not both.", + ); + } + return { archive, directory: "" }; + } + if ( + !/^[1-9][0-9]*$/.test(artifactId) || + !Number.isSafeInteger(Number(artifactId)) + ) { + throw new Error( + "Supply a local archive or one positive integer artifact-id.", + ); + } + if ( + !archiveName.endsWith(".tgz") || + path.posix.basename(archiveName) !== archiveName || + [...archiveName].some((character) => character.charCodeAt(0) < 32) || + path.win32.basename(archiveName) !== archiveName + ) { + throw new Error("Artifact input requires a .tgz archive-name basename."); + } + const directory = fs.mkdtempSync(path.join(runnerTemp, "helm-artifact-")); + return { archive: path.join(directory, archiveName), directory }; +} + +export function cleanupArchiveInput(directory) { + if (directory) fs.rmSync(directory, { recursive: true, force: true }); +} diff --git a/actions/helm/release-chart/src/archive.test.js b/actions/helm/release-chart/src/archive.test.js new file mode 100644 index 00000000..eff45715 --- /dev/null +++ b/actions/helm/release-chart/src/archive.test.js @@ -0,0 +1,79 @@ +import assert from "node:assert/strict"; +import fs from "node:fs"; +import os from "node:os"; +import path from "node:path"; +import { test } from "node:test"; +import { cleanupArchiveInput, prepareArchiveInput } from "./archive.js"; + +const checksum = "a".repeat(64); + +function fixture(t) { + const runnerTemp = fs.mkdtempSync(path.join(os.tmpdir(), "helm-input-test-")); + t.after(() => fs.rmSync(runnerTemp, { recursive: true, force: true })); + return { + artifactId: "123", + archiveName: "chart-1.0.0.tgz", + expectedChecksum: checksum, + runnerTemp, + }; +} + +test("local archive input preserves caller-owned files without allocating download storage", (t) => { + const input = fixture(t); + const archive = path.join(input.runnerTemp, "local.tgz"); + fs.writeFileSync(archive, "caller bytes"); + const resolved = prepareArchiveInput({ + archive, + expectedChecksum: checksum, + runnerTemp: input.runnerTemp, + }); + cleanupArchiveInput(resolved.directory); + assert.equal(resolved.archive, archive); + assert.deepEqual(fs.readdirSync(input.runnerTemp), ["local.tgz"]); + assert.equal(fs.readFileSync(archive, "utf8"), "caller bytes"); +}); + +test("artifact inputs isolate repeated downloads and clean only the owned directory", (t) => { + const input = fixture(t); + const first = prepareArchiveInput(input); + const second = prepareArchiveInput(input); + assert.notEqual(first.directory, second.directory); + assert.equal(path.dirname(first.archive), first.directory); + assert.equal(path.basename(first.archive), input.archiveName); + fs.writeFileSync(first.archive, "partial download"); + fs.writeFileSync(second.archive, "another invocation"); + cleanupArchiveInput(first.directory); + cleanupArchiveInput(first.directory); + assert.equal(fs.existsSync(first.directory), false); + assert.equal(fs.readFileSync(second.archive, "utf8"), "another invocation"); +}); + +for (const [name, overrides, message] of [ + [ + "missing source", + { artifactId: "", archiveName: "" }, + /local archive or one/, + ], + ["mixed sources", { archive: "local.tgz" }, /either archive or artifact-id/], + [ + "artifact name on local input", + { archive: "local.tgz", artifactId: "" }, + /either archive or artifact-id/, + ], + ["multiple IDs", { artifactId: "123,456" }, /positive integer/], + ["unsafe integer ID", { artifactId: "9007199254740993" }, /positive integer/], + ["missing filename", { archiveName: "" }, /basename/], + ["parent traversal", { archiveName: "../chart.tgz" }, /basename/], + ["Windows path", { archiveName: "C:\\chart.tgz" }, /basename/], + ["control character", { archiveName: "chart\n.tgz" }, /basename/], + ["missing checksum", { expectedChecksum: "" }, /SHA-256 checksum/], +]) { + test(`rejects ${name} before allocating download storage`, (t) => { + const input = fixture(t); + assert.throws( + () => prepareArchiveInput({ ...input, ...overrides }), + message, + ); + assert.deepEqual(fs.readdirSync(input.runnerTemp), []); + }); +} diff --git a/docs/README.md b/docs/README.md index eb3af9be..06d5acd8 100644 --- a/docs/README.md +++ b/docs/README.md @@ -14,3 +14,4 @@ - [Shared Helm validation and release workflows](adr/0009-compose-helm-validation-and-release-workflows.md) - [Concurrent PR-state lookup deduplication](adr/0010-deduplicate-concurrent-pr-state-lookups.md) - [Helm documentation generation and bundled formatting](adr/0011-skip-unchanged-helm-documentation.md) +- [Release action artifact ownership](adr/0012-release-chart-artifact-input.md) diff --git a/docs/adr/0009-compose-helm-validation-and-release-workflows.md b/docs/adr/0009-compose-helm-validation-and-release-workflows.md index 55c10031..687cf319 100644 --- a/docs/adr/0009-compose-helm-validation-and-release-workflows.md +++ b/docs/adr/0009-compose-helm-validation-and-release-workflows.md @@ -51,6 +51,10 @@ Publishing remains gated by successful validation. Callers own trusted release triggers, environment protection and non-cancelling release concurrency. An in-flight registry request cannot be undone by cancelling a workflow. +The [artifact input decision](0012-release-chart-artifact-input.md) later moves +artifact identity checks, download and cleanup from the composed workflow into +the release action, preserving this phase separation and integrity contract. + ## Validation and rollout Extend existing release tests for the public artifact boundary and input mutation; diff --git a/docs/adr/0012-release-chart-artifact-input.md b/docs/adr/0012-release-chart-artifact-input.md new file mode 100644 index 00000000..6161592f --- /dev/null +++ b/docs/adr/0012-release-chart-artifact-input.md @@ -0,0 +1,52 @@ +# Let the release action own validated artifact downloads + +Date: 2026-11-17 + +Status: Proposed for implementation review. + +## Context + +[Pleey PR #553](https://github.com/cloud-native-aixmarseille/pleey/pull/553) +separates chart validation from publication. Its review requests moving artifact +identity checks, download and cleanup into `helm/release-chart`. The composed +Helm release workflow duplicates the same steps. + +## Decision + +Extend the publication phase from [ADR 0009](0009-compose-helm-validation-and-release-workflows.md). +Accept exactly one archive source: a local `archive`, or one immutable +`artifact-id` with its `archive-name`. Both require the original archive +`checksum`. Reject missing, mixed or malformed inputs before download or registry +access. Local archive callers retain their files. + +For artifact input, the action downloads the exact ID from the current workflow +run into a fresh private runner directory using `actions/download-artifact`. +Artifact digest mismatch is fatal. The existing publication code verifies the +selected archive checksum before registry login, snapshots those bytes and +preserves its retry, digest and signing contracts. Downloaded files are removed +by an always-running final step, including after download, push or signing failure. +Hard runner termination can still prevent cleanup, as with other Actions steps. + +No artifact name search, latest-run lookup, cross-run credential API, source +checkout, packaging or chart validation is added. Callers retain responsibility +for successful validation, trusted release triggers, environment protection and +non-cancelling publication concurrency. An expired or deleted artifact fails; +rerun validation to produce a new artifact. Publication-only retries reuse the +original successful validation's ID and checksum. + +The composed release workflow and Pleey pass validation outputs directly to the +action. Test/lint configuration stays in their separate validation jobs. + +## Validation and rollout + +Reuse existing publication tests for local archive integrity, bounded retries, +registry cleanup, digest outputs and signing configuration. Add focused input +and temporary-file ownership coverage, and exercise artifact transfer through +the existing composed-workflow integration using its existing chart and image. +Use the existing action integration's checksum rejection to exercise cleanup +after a downloaded archive fails validation; do not add another cluster fixture. + +Regenerate action and workflow documentation through CI Dokumentor. Preview the +upstream change in Pleey #553 with an immutable commit; replace that preview with +a reviewed release before merging Pleey. Native test publication uses existing +isolated fixture tags and does not publish a Pleey release.