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

•jq — JSON parsing for version extraction
•pacman-contrib — Provides updpkgsums for automatic checksum updates

Workflow

1. Verify Environment

Run these commands in parallel to check current state:

bash

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 package.json:

bash

jq -r '.version' package.json

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):

bash

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

Reset pkgrel to 1 if version changed:

bash

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

4. Check Tag Status

Run these commands in parallel:

bash

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

bash

git pull origin master
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:

bash

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

bash

makepkg --printsrcinfo > .SRCINFO

8. Commit Checksum Update on Main

bash

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

9. Setup AUR Remote (if needed)

Check if AUR remote exists:

bash

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:

bash

git remote add aur ssh://aur@aur.archlinux.org/garak.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:

bash

git branch --list aur-pkg

If aur-pkg branch does NOT exist locally:

First, check if AUR remote already has a master branch (existing package):

bash

git ls-remote aur refs/heads/master

If AUR has master (existing package, e.g., cloned on new machine):

bash

# Fetch AUR master to local aur-pkg branch
git fetch aur master:aur-pkg
git checkout aur-pkg
git checkout master -- PKGBUILD .SRCINFO
git commit -m "Update to vX.Y.Z"
git push aur aur-pkg:master
git checkout master

If AUR has no master (first-time AUR registration):

bash

# 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 garak vX.Y.Z"
git push aur aur-pkg:master
git checkout master

If aur-pkg branch EXISTS (subsequent releases):

bash

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

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

11. Output

code

Release vX.Y.Z completed!

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

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

Error Handling

Situation	Action
Not on master/main	Ask user to confirm or abort
Tag already exists	Error and abort
jq not installed	Error: "jq is required. Install with: sudo pacman -S jq"
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
AUR non-fast-forward	Fetch AUR master first, then update (existing package on new machine)
Checkout to master fails	Use `git checkout master -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:

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

TypeScript-Specific Notes

•Version is extracted from package.json using jq
•Binary is installed via bin/garak launcher script
•Runtime dependencies: gjs, gtk4, libadwaita, gtk4-layer-shell, playerctl