.forgejo/workflows/ci.yml

@@ -1,15 +1,15 @@
 # CI runs first; build only proceeds if all checks pass.
 #
 # Push to dev:        typecheck + lint + test + build :dev + :<sha>
-# Push to main:       typecheck + lint + test + build :<sha>  (no moving tag)
+# Push to main:       typecheck + lint + test + build :latest + :<sha>
 # Tag v* (release):   typecheck + lint + test + build :latest + :<version> + :<sha>
 #
-# Both dev and main are gated AND built. dev pushes move the :dev tag; main
-# pushes publish only the immutable :<sha> image — no :main tag, because
-# :latest (release-only) is the single production pointer and a :main alias
-# would just duplicate it. Running CI on the main merge commit is intentional:
-# main is validated and its :<sha> image is the rollback point. The v* release
-# tag is the ONLY trigger that publishes :latest plus the immutable :<version>.
+# Both dev and main are gated AND built. dev pushes move :dev; main pushes move
+# :latest — main IS the production line, so :latest tracks main's tip and there
+# is no separate :main tag. Every push also gets an immutable :<sha> (the
+# rollback point). A v* release tag additionally publishes the dated :<version>;
+# since main already moved :latest, the release tag's distinct job is that
+# :<version> marker (it refreshes :latest too, harmlessly).
 #
 # Successive pushes to the SAME ref supersede each other (see concurrency
 # below), so rapid pushes don't stack identical work; dev and main runs are
@@ -142,7 +142,7 @@ jobs:
   build:
     name: Build & push image
     needs: [typecheck, lint, test]
-    # Build on dev, main, and v* tag pushes. dev → :dev, main → (sha only),
+    # Build on dev, main, and v* tag pushes. dev → :dev, main → :latest,
     # tag → :latest + :<version>; every build also gets an immutable :<sha>.
     if: github.ref == 'refs/heads/dev' || github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/v')
     runs-on: python-ci
@@ -171,8 +171,9 @@ jobs:
               TAGS="$TAGS,${{ env.IMAGE }}:dev"
               ;;
             refs/heads/main)
-              # main publishes only the immutable :<sha> image (set above) —
-              # no :main tag; :latest (release-only) is the production pointer.
+              # main IS the production line: publish :latest (plus the :<sha>
+              # set above). No separate :main tag.
+              TAGS="$TAGS,${{ env.IMAGE }}:latest"
               BUILD_VERSION="main"
               ;;
             refs/tags/*)