Release version 0.7.1

pkgmgr/actions/release/__init__.py

@@ -171,8 +171,15 @@ def _release_impl(
     run_git_command("git push origin --tags")
 
     # Move 'latest' to the new release tag so the newest SemVer is always
-    # marked as latest.
-    update_latest_tag(new_tag, preview=False)
+    # marked as latest. This is best-effort and must not break the release.
+    try:
+        update_latest_tag(new_tag, preview=False)
+    except GitError as exc:  # pragma: no cover
+        print(
+            f"[WARN] Failed to update floating 'latest' tag for {new_tag}: {exc}\n"
+            "[WARN] The release itself completed successfully; only the "
+            "'latest' tag was not updated."
+        )
 
     print(f"Release {new_ver_str} completed.")
 

pkgmgr/actions/release/git_ops.py

@@ -71,12 +71,25 @@ def sync_branch_with_remote(branch: str, preview: bool = False) -> None:
 def update_latest_tag(new_tag: str, preview: bool = False) -> None:
     """
     Move the floating 'latest' tag to the newly created release tag.
+
+    Implementation details:
+      - We explicitly dereference the tag object via `<tag>^{}` so that
+        'latest' always points at the underlying commit, not at another tag.
+      - We create/update 'latest' as an annotated tag with a short message so
+        Git configurations that enforce annotated/signed tags do not fail
+        with "no tag message".
     """
-    print(f"[INFO] Updating 'latest' tag to point at {new_tag}...")
+    target_ref = f"{new_tag}^{{}}"
+    print(f"[INFO] Updating 'latest' tag to point at {new_tag} (commit {target_ref})...")
+
     if preview:
-        print(f"[PREVIEW] Would run: git tag -f latest {new_tag}")
+        print(f"[PREVIEW] Would run: git tag -f -a latest {target_ref} "
+              f'-m "Floating latest tag for {new_tag}"')
         print("[PREVIEW] Would run: git push origin latest --force")
         return
 
-    run_git_command(f"git tag -f latest {new_tag}")
+    run_git_command(
+        f'git tag -f -a latest {target_ref} '
+        f'-m "Floating latest tag for {new_tag}"'
+    )
     run_git_command("git push origin latest --force")