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:

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

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.

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.

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

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:

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:

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:

for f in "$dir"/*.rb; do brew uninstall --formula "$tap/$(basename "$f" .rb)"; done
brew untap "$tap"

6. Put them into Formula/

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

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.