From 7ce13ab4b23c99750d5af7fbd8a5707a60f58641 Mon Sep 17 00:00:00 2001
From: sjmiller609 <7516283+sjmiller609@users.noreply.github.com>
Date: Wed, 4 Nov 2026 20:14:29 +0000
Subject: [PATCH] Tag builder publications with the source revision

---
 lib/builds/images/README.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/lib/builds/images/README.md b/lib/builds/images/README.md
index 161fde772..9ab55b4de 100644
--- a/lib/builds/images/README.md
+++ b/lib/builds/images/README.md
@@ -58,15 +58,20 @@ to ensure compatibility.
 ### 1. Build and Push
 
 ```bash
-# From repository root - use buildx with OCI mediatypes
+# From a clean repository checkout - use buildx with OCI mediatypes
+VERSION=$(git rev-parse HEAD)
 docker buildx build \
   --platform linux/amd64 \
   --output type=image,oci-mediatypes=true,push=true \
   --tag onkernel/builder-generic:latest \
+  --tag "onkernel/builder-generic:$VERSION" \
   -f lib/builds/images/generic/Dockerfile \
   .
 ```
 
+Keep the version tag for rollback when moving `latest` to a newer build. To roll back,
+set `BUILDER_IMAGE` to the retained version tag instead of `latest`.
+
 ### 2. Import into Hypeman
 
 ```bash