From 14ef867b5ad30475cb547d1222225a202ff1df94 Mon Sep 17 00:00:00 2001
From: 0xFEEDC0DE64 <daniel@brunner.ninja>
Date: Mon, 19 Oct 2026 21:02:13 +0200
Subject: [PATCH] Tag ImmichFrame chart from upstream release

---
 README.md                | 12 +++++++-----
 scripts/chart-version.sh |  4 ++++
 2 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 560c2a2..b43f724 100644
--- a/README.md
+++ b/README.md
@@ -25,11 +25,13 @@ helm upgrade --install immichframe brunner.ninja/immichframe \
   --values values.yaml
 ```
 
-The chart version has no `latest` alias. Every successful main-branch workflow
-publishes a unique SemVer version, `0.<run-number>.<attempt>`, so GitOps can pin
-and roll back an exact package. The default upstream image is the chart's
-`appVersion`; `image.registry`, `image.repository`, and `image.tag` can all be
-overridden independently.
+The chart version has no `latest` alias. Git tags follow the upstream
+ImmichFrame release (for example `v1.0.39.0`). Because Helm chart versions
+must be SemVer, the fourth upstream component becomes a prerelease component:
+`v1.0.39.0` publishes chart `1.0.39-0`; a later chart-only commit publishes
+`1.0.39-0-1-g<commit>`. GitOps pins the exact package. The default upstream
+image is the chart's `appVersion`; `image.registry`, `image.repository`, and
+`image.tag` can all be overridden independently.
 
 Each configured Immich account references an existing Kubernetes Secret. The
 chart mounts its key as a file and writes only `ApiKeyFile` into
diff --git a/scripts/chart-version.sh b/scripts/chart-version.sh
index a20feb6..3bf32b7 100755
--- a/scripts/chart-version.sh
+++ b/scripts/chart-version.sh
@@ -9,4 +9,8 @@ version=${description#v}
 case "$version" in
   *-0-g*) version=${version%%-0-g*} ;;
 esac
+# Upstream uses four numeric components (for example v1.0.39.0), whereas
+# Helm chart versions must be SemVer. Keep the upstream Git tag verbatim and
+# encode its fourth component as a SemVer prerelease identifier.
+version=$(printf '%s\n' "$version" | sed -E 's/^([0-9]+)\.([0-9]+)\.([0-9]+)\.([0-9]+)(-.*)?$/\1.\2.\3-\4\5/')
 printf '%s\n' "$version"