homebrew

# Homebrew tap `Formula/` on main in this repository is the tap. It holds: From 0.5.0 one formula installs both binaries. Before it there were two, fetching the identical archive and the identical checksum and installing one binary each, which only invited a machine to end up with `asz` of one version and the recorder of another. A version before 0.5.0 keeps the two-formula shape it was released with, and its formulae stay as they are. - `asz@VERSION.rb` for every released version from 0.5.0, and `asz@VERSION.rb` with `asz-claude-code@VERSION.rb` for the versions before it, which stay as they were released, keg-only, so an exact version stays installable; - `asz.rb` for the newest version. `asz.rb` beside this file is the template. A formula installs the voted binary package for the machine, macOS or Linux on arm64 or amd64, from the version's GitHub release, with archive.apache.org as its mirror. That URL keeps working after the version leaves the download site. Users run: ```sh brew trust https://github.com/apache/skywalking-ai-sessionizer brew tap apache/skywalking-ai-sessionizer https://github.com/apache/skywalking-ai-sessionizer brew install apache/skywalking-ai-sessionizer/asz brew install apache/skywalking-ai-sessionizer/asz@0.4.0 ``` Homebrew 7 loads a tap that is not its own only after `brew trust`, and this tap must be trusted by its URL, because the repository is not named `homebrew-skywalking-ai-sessionizer`. The check below needs no trust: it names each formula in full, which Homebrew takes as trusting that one. The user names one version or several. Each must be released: voted, on the download site or the archive, and its GitHub release promoted. 0.5.0 is the first version the template fits, because it installs `asz-changes`, which a package before 0.5.0 does not hold. A version before 0.5.0 is in `Formula/` already, with the formulae it was released with; never write it again. This runs on macOS with Homebrew. It changes nothing but a pull request to main in this repository. A local proxy can break HTTPS to Apache hosts, so the commands below go around it. ## 1. Check the versions are released ```sh for v in <versions>; do for u in "https://downloads.apache.org/skywalking/ai-sessionizer/$v/" "https://archive.apache.org/dist/skywalking/ai-sessionizer/$v/"; do curl --noproxy '*' -s -o /dev/null -w "$v $u %{http_code}\n" "$u" done gh release view "v$v" --repo apache/skywalking-ai-sessionizer --json isPrerelease --jq '"v'"$v"' prerelease=\(.isPrerelease)"' done ``` Each version must answer 200 on one of the two sites, and its GitHub release must not be a prerelease. Otherwise stop and tell the user. ## 2. Branch from main Work in a worktree, so changes in the main clone are left alone. `W` is a scratch directory. ```sh git fetch origin git worktree add -b homebrew-<versions> <scratch dir>/asz origin/main cd <scratch dir>/asz W=<scratch dir>/homebrew ``` ## 3. Download and check the packages A formula names the sha256 of each package, so each must be the voted file, and must hold what the formula installs. A package that fails here would fail for everyone on its platform. ```sh for v in <versions>; do mkdir -p "$W/$v" for p in darwin-arm64 darwin-amd64 linux-arm64 linux-amd64; do f=apache-skywalking-ai-sessionizer-$v-bin-$p.tgz for g in "$f" "$f.sha512"; do curl --noproxy '*' -fsSL -o "$W/$v/$g" "https://downloads.apache.org/skywalking/ai-sessionizer/$v/$g" || curl --noproxy '*' -fsSL -o "$W/$v/$g" "https://archive.apache.org/dist/skywalking/ai-sessionizer/$v/$g" done (cd "$W/$v" && shasum -a 512 -c "$f.sha512") tar -tvzf "$W/$v/$f" | awk '($NF == "asz" || $NF == "asz-changes") && $1 ~ /^-rwx/ {n++} $NF == "LICENSE" || $NF == "NOTICE" {m++} $NF ~ /^licenses\/./ {l = 1} END {if (n != 2 || m != 2 || !l) {print "missing a file the formula installs"; exit 1}}' done done ``` Stop at the first failure and tell the user. ## 4. Write the formulae ```sh T=.claude/skills/homebrew for v in <versions>; do sum() { shasum -a 256 "$W/$v/apache-skywalking-ai-sessionizer-$v-bin-$1.tgz" | cut -d ' ' -f 1; } mkdir -p "$W/formula-$v" for f in asz; do sed -e "s/@VERSION@/$v/g" \ -e "s/@DARWIN_ARM64_SHA256@/$(sum darwin-arm64)/" -e "s/@DARWIN_AMD64_SHA256@/$(sum darwin-amd64)/" \ -e "s/@LINUX_ARM64_SHA256@/$(sum linux-arm64)/" -e "s/@LINUX_AMD64_SHA256@/$(sum linux-amd64)/" \ "$T/$f.rb" > "$W/formula-$v/$f.rb" done # Homebrew names a versioned formula's class after its file: asz@0.4.0 is # AszAT040. keg_only keeps it from clashing with the current formula. for c in Asz:asz; do C=${c%%:*} V=${c%%:*}AT$(printf '%s' "$v" | tr -d .) perl -pe \ 's/^class \Q$ENV{C}\E < Formula$/class $ENV{V} < Formula/; s/^( license "Apache-2\.0"\n)/$1\n keg_only :versioned_formula\n/' \ "$W/formula-$v/${c#*:}.rb" > "$W/formula-$v/${c#*:}@$v.rb" done grep -n '@[A-Z0-9_]*@' "$W/formula-$v"/*.rb && echo "a placeholder is left" done current="" if [ -f Formula/asz.rb ]; then current=$(sed -nE 's#.*/releases/download/v([0-9.]+)/.*#\1#p' Formula/asz.rb | head -1); fi newest=$(printf '%s\n' $current <versions> | sort -V | tail -1) echo "current: ${current:-none}, newest: $newest" ``` `asz.rb` moves only forward: to `$newest`, when it is one of the given versions. Adding an older version never moves them back. ## 5. Check them with Homebrew The check installs every new formula from its real GitHub release URL, and removes it afterwards. It must not touch the user's own install. If any of these is installed, stop, tell the user, and do not uninstall it: ```sh for f in asz $(for v in <versions>; do printf 'asz@%s ' "$v"; done); do brew list --formula "$f" >/dev/null 2>&1 && echo "$f is installed" done ``` Then, in a local tap: ```sh export HOMEBREW_NO_AUTO_UPDATE=1 HOMEBREW_NO_INSTALL_CLEANUP=1 HOMEBREW_NO_ENV_HINTS=1 tap=aszcheck/formulae brew tap-new --no-git "$tap" dir=$(brew --repository "$tap")/Formula for v in <versions>; do cp "$W/formula-$v/asz@$v.rb" "$dir/"; done if [ "$newest" != "$current" ]; then cp "$W/formula-$newest/asz.rb" "$dir/"; fi env -u http_proxy -u https_proxy -u all_proxy brew style "$tap" for f in "$dir"/*.rb; do n=$tap/$(basename "$f" .rb) env -u http_proxy -u https_proxy -u all_proxy brew audit --strict --formula "$n" env -u http_proxy -u https_proxy -u all_proxy brew install --formula "$n" brew test "$n" done for v in <versions>; do "$(brew --prefix "asz@$v")/bin/asz" version "$(brew --prefix "asz@$v")/bin/asz-changes" version done ``` Every step must pass, and each binary must print its version. When `asz.rb` moved, the `asz` and `asz-changes` on `$(brew --prefix)/bin` must print `$newest`, and link into the `asz` keg, not a versioned one. Then remove everything the check installed, whether it passed or not: ```sh for f in "$dir"/*.rb; do brew uninstall --formula "$tap/$(basename "$f" .rb)"; done brew untap "$tap" ``` ## 6. Put them into Formula/ ```sh mkdir -p Formula for v in <versions>; do cp "$W/formula-$v/asz@$v.rb" Formula/; done if [ "$newest" != "$current" ]; then cp "$W/formula-$newest/asz.rb" Formula/; fi git status --short ``` Only files under `Formula/` may change. ## 7. Open the pull request to main ```sh git add Formula git commit -m "Homebrew formulae for <versions>" git push -u origin homebrew-<versions> gh pr create --repo apache/skywalking-ai-sessionizer --base main --title "Homebrew formulae for <versions>" ``` The commit message and the pull request carry no AI attribution: no Co-Authored-By line and no "Generated with" line. Say in the pull request which versions were added, which version the `asz` formula installs now, and that the check passed. ## 8. After the merge Anyone who tapped runs `brew update`, then `brew upgrade asz`. Tell the user the pull request link, and remove the worktree and `W` once it is merged.