From 2b0be41b3575f36cd9274a3e4482f5bfcd83a763 Mon Sep 17 00:00:00 2001
From: sebasnallar <sebastiansaidnallar@gmail.com>
Date: Tue, 1 Sep 2026 15:39:08 -0300
Subject: [PATCH] feat(release-publish-oci): publish tag, changelog and OCI
 annotations

The registered oci_image revision now carries the pushed image tag in its
meta and an annotations blob: the release-please notes as the curated
changelog plus org.opencontainers.image source/revision/version keys.
Annotations are last-write-wins full replacement, so every run sends the
complete set; the release body is truncated at its first '## Artifact'
section so backfill re-runs never feed our own appended metadata back in.
The CLI channel moves alpha-packages -> alpha, which carries the new
--tag/--changelog-file/--annotation flags.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 .github/workflows/release-publish-oci.yml | 26 +++++++++++++++++++++--
 1 file changed, 24 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/release-publish-oci.yml b/.github/workflows/release-publish-oci.yml
index 0ec79d7..5e01256 100644
--- a/.github/workflows/release-publish-oci.yml
+++ b/.github/workflows/release-publish-oci.yml
@@ -129,10 +129,10 @@ on:
         type: string
         default: 'organization=*'
       np_cli_version:
-        description: 'np CLI version/channel for artifact registration (alpha-packages until artifact create reaches stable)'
+        description: 'np CLI version/channel for artifact registration (alpha carries --tag/--changelog-file/--annotation)'
         required: false
         type: string
-        default: 'alpha-packages'
+        default: 'alpha'
     secrets:
       aws_role_arn:
         description: 'AWS IAM Role ARN for OIDC auth against ECR'
@@ -246,6 +246,24 @@ jobs:
             REPOSITORY="$REG_PATH/$IMAGE_NAME"
           fi
 
+          # Annotations are last-write-wins full replacement on the revision, so
+          # every run sends the complete set: the release-please notes as the
+          # curated changelog plus the OCI source/revision/version keys. The
+          # release body is truncated at its first '## Artifact' section so a
+          # backfill re-run never feeds our own appended metadata back in.
+          EXTRA_ARGS=()
+          RELEASE_BODY=$(gh api "repos/$GITHUB_REPOSITORY/releases/tags/$TAG" --jq '.body // ""' 2>/dev/null || true)
+          printf '%s' "$RELEASE_BODY" | sed '/^## Artifact/,$d' > changelog.md
+          if grep -q '[^[:space:]]' changelog.md; then
+            EXTRA_ARGS+=(--changelog-file changelog.md)
+          fi
+          # The image was built from the tag's commit, not the triggering sha
+          # (they differ on existing_tag backfills).
+          TAG_COMMIT=$(gh api "repos/$GITHUB_REPOSITORY/commits/$TAG" --jq '.sha' 2>/dev/null || true)
+          if [ -n "$TAG_COMMIT" ]; then
+            EXTRA_ARGS+=(--annotation "org.opencontainers.image.revision=$TAG_COMMIT")
+          fi
+
           # stdout only into the capture: stderr stays on the run log, so CLI
           # warnings can never corrupt the JSON parse.
           OUTPUT=$(np artifact create \
@@ -254,6 +272,10 @@ jobs:
             --registry "$REG_HOST" \
             --repository "$REPOSITORY" \
             --digest "$DIGEST" \
+            --tag "$IMAGE_TAG" \
+            --annotation "org.opencontainers.image.source=${{ github.server_url }}/$GITHUB_REPOSITORY" \
+            --annotation "org.opencontainers.image.version=$TAG" \
+            "${EXTRA_ARGS[@]}" \
             --visible-to "$VISIBLE_TO" \
             --format json)
           echo "$OUTPUT"