chore: improve release-tag workflow

[pantharshit007]

Description

extends #47 PR and #46 issue

Improve the release tagging workflow to:

• fetch tags from origin,
• check for the tag on the remote before creating it (avoids races),
• create an annotated tag (instead of lightweight),
• maintain the same release creation behavior.

Summary by CodeRabbit

• Chores
  • Version bumped to 0.1.7
  • Updated release tagging workflow and documentation formatting

What type of PR is this? (check all applicable)

• 🍕 New Component
• 🐛 Bug Fix
• 📝 Documentation Update
• 🎨 Style
• 🧑‍💻 Code Refactor
• 🔥 Performance Improvements

Mobile & Desktop Screenshots/Recordings

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
aether-ui	Ready	Preview	Comment	Oct 26, 2025 7:38am

[coderabbitai]

Walkthrough

This PR updates the release tagging workflow to verify tag existence on remote before local, switches from simple to annotated tags with descriptive messages, and bumps the package version from 0.1.6 to 0.1.7. The workflow now conditionally creates and pushes tags based on remote verification with local fallback.

Changes

Cohort / File(s)	Summary
Workflow Configuration .github/workflows/release-tag.yml	Adds remote tag fetch and verification; changes tag existence check to query origin first with local fallback; renames step and switches from simple tag to annotated tag creation with message; updates release body Markdown formatting.
Package Metadata package.json	Bumps version from 0.1.6 to 0.1.7.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

• Version bump is straightforward and requires minimal review
• Workflow changes involve simple configuration updates but should verify that remote tag checking logic works correctly and that annotated tags don't impact downstream processes
• Areas for attention: Remote tag verification behavior and annotated tag compatibility with existing tooling

Possibly related PRs

• feat: add release branch check and auto tagging workflows #47 — Related prior PR that introduced the auto-tagging workflow now being refined with remote tag checks and annotated tags.

Poem

🐰 A version hops from dot-one-six to seven,
Tags now annotated—a message to heaven,
Remote checks first, then local we see,
Release workflows flowing perfectly! ✨

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	You can run @coderabbitai generate docstrings to improve docstring coverage.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title Check	✅ Passed	The PR title "chore: improve release-tag workflow" is directly related to the main changes in the pull request. The changeset's primary modifications are in .github/workflows/release-tag.yml, where the workflow is enhanced to fetch remote tags, check for tag existence on origin with a local fallback, create annotated tags instead of lightweight tags, and fix formatting issues. The title clearly identifies the file/component being modified (release-tag workflow) and accurately characterizes the nature of the changes (improvements). While "improve" is somewhat general, it's sufficiently specific when combined with "release-tag workflow" to convey the primary intent of the changeset. The title avoids vague terms and would help a teammate understand the change when scanning commit history.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch update/release-tag-workflow

---

📜 Recent review details

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between ea568fb and e8b1862.

📒 Files selected for processing (2)

• .github/workflows/release-tag.yml (2 hunks)
• package.json (1 hunks)

🔇 Additional comments (5)

package.json (1)

3-3: Version bump aligns with workflow improvements.

.github/workflows/release-tag.yml (4)

29-31: Proactive tag fetching prevents stale local state. The fetch ensures remote tags are available for verification before proceeding with tag creation logic.

---

33-49: Race-condition-safe verification with intelligent fallback. Remote-first checking against origin prevents two concurrent workflows from creating duplicate tags. The local fallback at lines 42–48 provides an additional safety layer without compromising the remote-primary intent.

---

51-59: Annotated tags improve release metadata and auditability. Switching from lightweight to annotated tags (-a flag with message) aligns with best practices for release workflows and enables better tracking of who/when created each release.

---

67-71: Release body markdown formatting is clear and correct. The backtick syntax around prod improves readability without affecting release behavior.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}