#!/bin/bash
# Binary management — download old releases, build candidate.
# Extracted from cross-version-smoke-test.sh for reuse.
CACHE_DIR="${HOME}/.cache/beads-regression"
mkdir -p "$CACHE_DIR"
DOWNLOAD_TIMEOUT="${DOWNLOAD_TIMEOUT:-60}"
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
ARCH=$(uname -m)
case "$ARCH" in
x86_64) ARCH="amd64" ;;
aarch64|arm64) ARCH="arm64" ;;
esac
resolve_existing_path() {
# GNU realpath needs -e to require the target exist; BSD realpath (macOS)
# has no -e flag and rejects it outright, but already requires existence
# unconditionally by default — verified empirically to error + exit
# nonzero on a missing path, same as GNU's -e. Linux keeps the exact
# existing invocation; only Darwin takes the flagless path.
#
# That "Darwin" branch is really "not Linux", not "BSD realpath" — with
# Homebrew coreutils on PATH, `realpath` resolves to GNU realpath there
# too, and GNU's default (no -e) accepts a missing *final* component
# (rc 0), silently dropping the existence guarantee this function
# promises callers. Don't trust either realpath's default behavior for
# that guarantee; check it ourselves so it holds on both branches.
[ -e "$1" ] || return 1
if [ "$OS" = linux ]; then
realpath -e -- "$1"
else
realpath -- "$1"
fi
}
sha256_file() {
if command -v sha256sum >/dev/null 2>&1; then
sha256sum "$1" | awk '{print $1}'
return
fi
if command -v shasum >/dev/null 2>&1; then
shasum -a 256 "$1" | awk '{print $1}'
return
fi
echo "ERROR: no SHA-256 utility is available" >&2
return 1
}
verify_release_archive() {
local version="$1"
local archive="$2"
local expected actual
expected=$(strict_release_sha256 "$version" "$OS" "$ARCH") || {
echo "ERROR: no pinned release checksum for $version ($OS/$ARCH)" >&2
return 1
}
actual=$(sha256_file "$archive") || return 1
if [ "$actual" != "$expected" ]; then
echo "ERROR: checksum mismatch for $version: got $actual, want $expected" >&2
return 1
fi
}
verify_release_binary_version() (
local version="$1"
local binary="$2"
local bare="${version#v}"
local output probe_root probe_timeout
probe_timeout="${RELEASE_BINARY_VERSION_TIMEOUT:-15}"
if ! [[ "$probe_timeout" =~ ^[1-9][0-9]*$ ]]; then
echo "ERROR: RELEASE_BINARY_VERSION_TIMEOUT must be a positive number of seconds" >&2
return 1
fi
local timeout_bin
if ! timeout_bin=$(command -v timeout); then
echo "ERROR: timeout is required to verify historical release binaries safely" >&2
return 1
fi
binary=$(resolve_existing_path "$binary") || {
echo "ERROR: verified $version binary cannot be resolved" >&2
return 1
}
if [ ! -x "$binary" ]; then
echo "ERROR: verified $version binary is not executable" >&2
return 1
fi
probe_root=$(mktemp -d "${TMPDIR:-/tmp}/bd-release-version-probe.XXXXXX") || {
echo "ERROR: could not create isolated release binary probe" >&2
return 1
}
trap 'rm -rf -- "${probe_root:-}"' EXIT
mkdir -p "$probe_root/run" "$probe_root/home" "$probe_root/xdg-config" \
"$probe_root/xdg-cache" "$probe_root/xdg-data" "$probe_root/xdg-state" "$probe_root/tmp" || return 1
# PATH stays the deliberately minimal /usr/bin:/bin below — invoke
# timeout by the absolute path resolved above instead of relying on it
# being found on that sandboxed PATH. On Linux it lives in /usr/bin
# anyway (no behavior change); macOS has no timeout(1) at all outside a
# package manager prefix (e.g. Homebrew's /opt/homebrew/bin), which the
# sandboxed PATH intentionally excludes.
if ! output=$(cd "$probe_root/run" && env -i \
PATH=/usr/bin:/bin \
HOME="$probe_root/home" \
XDG_CONFIG_HOME="$probe_root/xdg-config" \
XDG_CACHE_HOME="$probe_root/xdg-cache" \
XDG_DATA_HOME="$probe_root/xdg-data" \
XDG_STATE_HOME="$probe_root/xdg-state" \
TMPDIR="$probe_root/tmp" \
GIT_CONFIG_NOSYSTEM=1 \
GIT_CONFIG_GLOBAL=/dev/null \
GIT_CONFIG_SYSTEM=/dev/null \
GIT_TERMINAL_PROMPT=0 \
BD_DISABLE_METRICS=1 \
BD_DISABLE_EVENT_FLUSH=1 \
BD_NON_INTERACTIVE=1 \
"$timeout_bin" --kill-after=5s "$probe_timeout" "$binary" version 2>&1); then
echo "ERROR: verified $version binary does not run" >&2
return 1
fi
if [[ " $output " != *" $bare "* ]]; then
echo "ERROR: release binary reports unexpected version: $output" >&2
return 1
fi
)
# HISTORICAL_RELEASE_DIR (set by the Bazel targets in tests/migration) holds
# the pinned release binaries as
/, each already verified
# against the release catalog's sha256 when Bazel fetched it, so nothing is
# downloaded. A version the directory lacks is an error, never a download.
prepinned_release_binary() {
local version="$1" binary
binary="$HISTORICAL_RELEASE_DIR/$version"
if [ ! -f "$binary" ]; then
echo "ERROR: HISTORICAL_RELEASE_DIR has no pinned $version binary (declare it in the target's releases)" >&2
return 1
fi
verify_release_binary_version "$version" "$binary" || return 1
resolve_existing_path "$binary"
}
download_verified_release_binary() {
local version="$1"
local asset expected release_dir archive binary
if [ -n "${HISTORICAL_RELEASE_DIR:-}" ]; then
prepinned_release_binary "$version"
return
fi
asset=$(strict_release_asset "$version" "$OS" "$ARCH") || {
echo "ERROR: no strict release manifest for $version ($OS/$ARCH)" >&2
return 1
}
expected=$(strict_release_sha256 "$version" "$OS" "$ARCH") || return 1
release_dir="$CACHE_DIR/verified/${version}-${OS}-${ARCH}-${expected}"
archive="$release_dir/$asset"
binary="$release_dir/bd"
mkdir -p "$release_dir"
if [ ! -f "$archive" ]; then
local url tmp
url="https://github.com/gastownhall/beads/releases/download/${version}/${asset}"
tmp="$archive.tmp.$$"
echo -e " ${YELLOW:-}downloading verified ${version}...${NC:-}" >&2
if ! curl -fsSL --max-time "$DOWNLOAD_TIMEOUT" --retry 3 --retry-all-errors --retry-delay 2 "$url" -o "$tmp"; then
rm -f "$tmp"
echo "ERROR: could not download pinned release asset for $version" >&2
return 1
fi
if ! verify_release_archive "$version" "$tmp"; then
rm -f "$tmp"
return 1
fi
mv -f "$tmp" "$archive"
fi
verify_release_archive "$version" "$archive" || return 1
local extract_dir extracted
extract_dir=$(mktemp -d)
if ! tar -xzf "$archive" -C "$extract_dir"; then
rm -rf "$extract_dir"
echo "ERROR: could not extract pinned release asset for $version" >&2
return 1
fi
extracted=$(find "$extract_dir" -name bd -type f | head -1)
if [ -z "$extracted" ]; then
rm -rf "$extract_dir"
echo "ERROR: pinned release asset for $version contains no bd binary" >&2
return 1
fi
cp -f "$extracted" "$binary"
chmod +x "$binary"
rm -rf "$extract_dir"
verify_release_binary_version "$version" "$binary" || return 1
printf '%s\n' "$binary"
}
# v0.9.1 has no release asset. Its historical CLI reports 0.9.0 (dev), so
# qualification is the module checksum and VCS origin, never self-reporting.
build_verified_v091_source_binary() (
# SOURCE_TAG_SQLITE_BIN (set by //tests/migration's v0.9.1 target) is
# this same build, done offline by Bazel from the sha256-pinned module
# files with the same toolchain (//tests/migration:bd_source_tag).
if [ -n "${SOURCE_TAG_SQLITE_BIN:-}" ]; then
resolve_existing_path "$SOURCE_TAG_SQLITE_BIN"
return
fi
local scratch module_json source_dir build_dir binary temporary toolchain_root toolchain_go toolchain
scratch=$(mktemp -d) || return 1
# Canonicalize immediately: macOS's default TMPDIR (/var/folders/...) is
# itself reached through a symlink to /private/var/folders/..., so a
# later realpath'd descendant (source_dir below) would never prefix-match
# this raw, non-canonical form even though both name the same directory.
scratch=$(resolve_existing_path "$scratch") || return 1
temporary=""
trap 'rm -rf -- "$scratch"; [ -z "$temporary" ] || rm -f -- "$temporary"' EXIT
toolchain_root=$(env GOTOOLCHAIN="$SOURCE_TAG_SQLITE_GO_TOOLCHAIN" go env GOROOT) || return 1
toolchain_go=$(resolve_existing_path "$toolchain_root/bin/go") || return 1
[ -x "$toolchain_go" ] || return 1
toolchain=$(cd "$scratch" && env GOTOOLCHAIN=local "$toolchain_go" env GOVERSION) || return 1
[ "$toolchain" = "$SOURCE_TAG_SQLITE_GO_TOOLCHAIN" ] || {
echo "ERROR: v0.9.1 source build requires $SOURCE_TAG_SQLITE_GO_TOOLCHAIN, got $toolchain" >&2
return 1
}
module_json=$(cd "$scratch" && env GO111MODULE=on GOFLAGS=-modcacherw GOWORK=off \
GOTOOLCHAIN=local GOMODCACHE="$scratch/mod" \
GOSUMDB=sum.golang.org GONOSUMDB= GOPRIVATE= \
"$toolchain_go" mod download -json "$SOURCE_TAG_SQLITE_MODULE@$SOURCE_TAG_SQLITE_VERSION") || {
echo 'ERROR: could not download v0.9.1 through sum.golang.org' >&2
return 1
}
jq -e --arg path "$SOURCE_TAG_SQLITE_MODULE" --arg version "$SOURCE_TAG_SQLITE_VERSION" \
--arg sum "$SOURCE_TAG_SQLITE_MODULE_SUM" --arg gomod_sum "$SOURCE_TAG_SQLITE_GOMOD_SUM" \
--arg commit "$SOURCE_TAG_SQLITE_COMMIT" --arg ref "$SOURCE_TAG_SQLITE_REF" '
.Path == $path and
.Version == $version and
.Sum == $sum and
.GoModSum == $gomod_sum and
.Origin.VCS == "git" and
.Origin.Hash == $commit and
.Origin.Ref == $ref and
(.Dir | type == "string" and length > 0)
' <<< "$module_json" >/dev/null || {
echo 'ERROR: v0.9.1 module provenance did not match the reviewed source tag' >&2
return 1
}
source_dir=$(resolve_existing_path "$(jq -r .Dir <<< "$module_json")") || return 1
[ -d "$source_dir" ] && [ ! -L "$source_dir" ] &&
[[ "$source_dir/" == "$scratch/mod/"* ]] || {
echo 'ERROR: verified v0.9.1 module has no safe source directory' >&2
return 1
}
build_dir="$CACHE_DIR/verified-source/${SOURCE_TAG_SQLITE_VERSION}-${SOURCE_TAG_SQLITE_COMMIT}-${SOURCE_TAG_SQLITE_GO_TOOLCHAIN}-${OS}-${ARCH}-cgo1"
binary="$build_dir/bd"
mkdir -p "$build_dir"
cp -f "$source_dir/go.mod" "$scratch/source.mod" &&
cp -f "$source_dir/go.sum" "$scratch/source.sum" &&
chmod u+w "$scratch/source.mod" "$scratch/source.sum" || return 1
temporary="$binary.tmp.$$"
if ! (cd "$source_dir" && env GOFLAGS=-modcacherw GOWORK=off GOTOOLCHAIN=local \
GOMODCACHE="$scratch/mod" GOSUMDB=sum.golang.org GONOSUMDB= GOPRIVATE= \
GOOS="$OS" GOARCH="$ARCH" CGO_ENABLED=1 \
"$toolchain_go" build -trimpath -modfile="$scratch/source.mod" -o "$temporary" ./cmd/bd); then
echo "ERROR: could not build verified v0.9.1 source for $OS/$ARCH with CGO" >&2
return 1
fi
chmod +x "$temporary" && mv -f "$temporary" "$binary" || return 1
temporary=""
printf '%s\n' "$binary"
)
build_candidate() {
if [ -n "${CANDIDATE_BIN:-}" ] && [ -x "${CANDIDATE_BIN}" ]; then
echo "$(cd "$(dirname "$CANDIDATE_BIN")" && pwd)/$(basename "$CANDIDATE_BIN")"
return
fi
local candidate="$CACHE_DIR/bd-candidate-$$"
echo -e "${YELLOW:-}Building candidate binary...${NC:-}" >&2
(cd "$PROJECT_ROOT" && go build -tags gms_pure_go -o "$candidate" ./cmd/bd) >&2
echo "$candidate"
}