release

name	release
description	Tag release, update PKGBUILD checksums, and push to AUR.
disable-model-invocation	true
allowed-tools	Read, Edit, Bash, Glob, Grep, AskUserQuestion
argument-hint	[version]

release

Creates a git tag, updates PKGBUILD checksums, and pushes to AUR.

Critical Rules

• NEVER run on non-master/main branch without user confirmation
• NEVER force push tags
• ALWAYS verify tag doesn't already exist before creating
• ALWAYS use annotated tags for releases (not lightweight tags)
• AUR requires an orphan branch (aur-pkg) containing ONLY PKGBUILD and .SRCINFO

Dependencies

• pacman-contrib — Provides updpkgsums for automatic checksum updates

Workflow

1. Verify Environment

Run these commands in parallel to check current state:

git branch --show-current
git remote show origin | grep 'HEAD branch'

If not on master/main → Use AskUserQuestion to confirm proceeding.

2. Determine Version

$ARGUMENTS — If provided, use as version (e.g., 1.1.1 or v1.1.1).

If not provided, extract from workspace Cargo.toml:

grep -A1 '^\[workspace\.package\]' Cargo.toml | grep 'version' | sed 's/.*"\(.*\)".*/\1/'

Normalize version: ensure tag format is vX.Y.Z (add v prefix if missing).

3. Update PKGBUILD Version

Update pkgver in PKGBUILD to match the release version (without v prefix):

sed -i "s/^pkgver=.*/pkgver=X.Y.Z/" PKGBUILD

Reset pkgrel to 1 if version changed:

sed -i "s/^pkgrel=.*/pkgrel=1/" PKGBUILD

4. Check Tag Status

Run these commands in parallel:

git tag -l "vX.Y.Z"
git ls-remote --tags origin | grep "vX.Y.Z"

• Tag exists locally or remotely → Error: "Tag vX.Y.Z already exists."
• No tag → Proceed

5. Create and Push Tag

git pull origin main
git tag -a vX.Y.Z -m "Release vX.Y.Z"
git push origin vX.Y.Z

Output: Created and pushed tag: vX.Y.Z

6. Update Checksum

Wait briefly for GitHub to generate the tarball, then use updpkgsums:

sleep 5  # Wait for GitHub to process the tag
updpkgsums

If checksum generation fails → Use AskUserQuestion: "Checksum generation failed. Retry or skip?"

7. Regenerate .SRCINFO

makepkg --printsrcinfo > .SRCINFO

8. Commit Checksum Update on Main

git add PKGBUILD .SRCINFO
git commit -m "$(cat <<'EOF'
chore: update sha256sums for vX.Y.Z
EOF
)"
git push origin main

9. Setup AUR Remote (if needed)

Check if AUR remote exists:

git remote get-url aur 2>/dev/null || echo "not configured"

If not configured → Use AskUserQuestion: "AUR remote not configured. Add it now?"

If user confirms:

git remote add aur ssh://[e-mail]/mpvpaper-rs.git

10. Push to AUR

AUR requires a repository containing ONLY PKGBUILD and .SRCINFO. Use the aur-pkg orphan branch.

Check if aur-pkg branch exists:

git branch --list aur-pkg

If aur-pkg branch does NOT exist (first-time setup):

# Create orphan branch with only packaging files
git checkout --orphan aur-pkg
git rm -rf --cached . >/dev/null 2>&1 || true
git add PKGBUILD .SRCINFO
git commit -m "Initial AUR package for mpvpaper-rs vX.Y.Z"
git push aur aur-pkg:master
git checkout main

If aur-pkg branch EXISTS (subsequent releases):

git checkout aur-pkg
git checkout main -- PKGBUILD .SRCINFO
git commit -m "Update to vX.Y.Z"
git push aur aur-pkg:master
git checkout main

Important: If checkout fails due to untracked files, use git checkout main -f to force switch back.

11. Output

Release vX.Y.Z completed!

Tag: vX.Y.Z (pushed to origin)
Checksum: updated
AUR: pushed

GitHub: https://github.com/bityoungjae/mpvpaper-rs/releases/tag/vX.Y.Z
AUR: https://aur.archlinux.org/packages/mpvpaper-rs

Error Handling

Situation	Action
Not on master/main	Ask user to confirm or abort
Tag already exists	Error and abort
updpkgsums not installed	Error: "updpkgsums is required. Install with: sudo pacman -S pacman-contrib"
Checksum generation fails	Retry or skip with user confirmation
Push fails	Show error, suggest manual resolution
AUR remote not configured	Ask user to add it or skip AUR push
AUR push fails	Show SSH key setup instructions if auth error
Checkout to main fails	Use git checkout main -f to force switch

AUR Architecture

AUR repositories require:

• Only PKGBUILD and .SRCINFO files (no source code)
• Push to master branch only
• Clean git history without unrelated files

This skill uses an orphan branch (aur-pkg) that:

1. Has separate git history from main project
2. Contains only packaging files
3. Pushes to AUR's required master branch via git push aur aur-pkg:master

Rust-Specific Notes

• Version is extracted from workspace Cargo.toml ([workspace.package].version)
• Two binaries are installed: mpvpaper-rs and mpvpaper-rs-holder
• PKGBUILD uses cargo build --frozen --release --all-features