scripts: add install_compiler_binaries.sh

New script to install Sierra compiler binaries (starknet-sierra-compile,
starknet-native-compile). Reads versions from .txt files, handles LLVM
env vars for native compile, and skips gracefully when LLVM 19 is missing.

Includes compiler_versions.sh helper that reads version .txt files.

Not yet called from install_cargo_tools.sh — wired up in a follow-up.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: avi-starkware

scripts/compiler_versions.sh

@@ -0,0 +1,9 @@
+#!/bin/env bash
+# Reads compiler binary versions from version files (the single source of truth).
+# Source this script to get $SIERRA_COMPILE_VERSION and $NATIVE_COMPILE_VERSION.
+
+COMPILER_VERSIONS_SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
+REPO_ROOT="$(cd "${COMPILER_VERSIONS_SCRIPT_DIR}/.." && pwd)"
+
+SIERRA_COMPILE_VERSION=$(cat "$REPO_ROOT/crates/apollo_infra_utils/src/cairo_compiler_version.txt")
+NATIVE_COMPILE_VERSION=$(cat "$REPO_ROOT/crates/apollo_compile_to_native/src/native_compiler_version.txt")

scripts/install_compiler_binaries.sh

@@ -0,0 +1,115 @@
+#!/bin/env bash
+# Installs Sierra compiler binaries (starknet-sierra-compile, starknet-native-compile).
+# Versions are read from plain text files that are the single source of truth for both
+# Rust code and this script.
+#
+# Usage:
+#   scripts/install_compiler_binaries.sh                          # Install both
+#   scripts/install_compiler_binaries.sh --sierra                  # Sierra only
+#   scripts/install_compiler_binaries.sh --native                  # Native only
+#   scripts/install_compiler_binaries.sh --dest /usr/local/bin     # Copy binaries to dest
+#
+# --dest copies each installed binary into the given directory (useful in Docker
+# so the final stage can COPY from a known path regardless of CARGO_HOME).
+#
+# Can be run standalone (requires LLVM 19 for native; run scripts/dependencies.sh first).
+
+set -e
+
+# Source common apt utilities.
+# Handle both cases: script in subdirectory or current directory.
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
+if [ -f "${SCRIPT_DIR}/apt_utils.sh" ]; then
+    source "${SCRIPT_DIR}/apt_utils.sh"
+elif [ -f "./apt_utils.sh" ]; then
+    source "./apt_utils.sh"
+else
+    echo "Error: apt_utils.sh not found in ${SCRIPT_DIR} or current directory" >&2
+    exit 1
+fi
+
+# Source version files.
+source "${SCRIPT_DIR}/compiler_versions.sh"
+
+# Parse arguments.
+INSTALL_SIERRA=false
+INSTALL_NATIVE=false
+DEST_DIR=""
+explicit_selection=false
+while [ $# -gt 0 ]; do
+    case "$1" in
+        --sierra) INSTALL_SIERRA=true; explicit_selection=true ;;
+        --native) INSTALL_NATIVE=true; explicit_selection=true ;;
+        --dest) DEST_DIR="$2"; shift ;;
+        *) echo "Unknown argument: $1" >&2; exit 1 ;;
+    esac
+    shift
+done
+if ! $explicit_selection; then
+    INSTALL_SIERRA=true
+    INSTALL_NATIVE=true
+fi
+
+# LLVM/MLIR env vars are normally set by .cargo/config.toml, but cargo install runs
+# outside the workspace so they must be set explicitly.
+function export_llvm_env_vars() {
+    local config_file="$REPO_ROOT/.cargo/config.toml"
+    if [ ! -f "$config_file" ]; then
+        return
+    fi
+    local line var_name var_value
+    while IFS= read -r line; do
+        var_name=$(echo "$line" | sed -n 's/^\([A-Z0-9_]*\) = .*/\1/p')
+        var_value=$(echo "$line" | sed -n 's/^[A-Z0-9_]* = "\(.*\)"/\1/p')
+        if [ -n "$var_name" ] && [ -n "$var_value" ]; then
+            export "$var_name=$var_value"
+        fi
+    done < <(grep -E '^(LLVM_SYS|MLIR_SYS|TABLEGEN)' "$config_file")
+}
+
+# Install a compiler binary with multi-version support.
+# Installs as <binary_name>-<version> and symlinks <binary_name> to the active version.
+# Skips installation if the versioned binary already exists.
+# If DEST_DIR is set, copies the binary there.
+function install_compiler_if_needed() {
+    local binary_name=$1
+    local version=$2
+    local versioned_name="${binary_name}-${version}"
+
+    if command -v "$versioned_name" &>/dev/null; then
+        log_step "install_build_tools" "$versioned_name already installed, skipping"
+    else
+        log_step "install_build_tools" "Installing $versioned_name..."
+        cargo install "$binary_name" --version "$version" --force
+        # Rename to versioned path so multiple versions can coexist.
+        mv "$(which "$binary_name")" "$(dirname "$(which "$binary_name")")/$versioned_name"
+        log_step "install_build_tools" "$versioned_name installed successfully"
+    fi
+
+    # Symlink the active version.
+    local bin_dir
+    bin_dir="$(dirname "$(which "$versioned_name")")"
+    ln -sf "$bin_dir/$versioned_name" "$bin_dir/$binary_name"
+
+    # Copy to destination directory if requested.
+    if [ -n "$DEST_DIR" ]; then
+        mkdir -p "$DEST_DIR"
+        cp "$bin_dir/$binary_name" "$DEST_DIR/"
+    fi
+}
+
+if $INSTALL_SIERRA; then
+    install_compiler_if_needed "starknet-sierra-compile" "$SIERRA_COMPILE_VERSION"
+fi
+
+if $INSTALL_NATIVE; then
+    # starknet-native-compile requires LLVM 19. If LLVM is not installed, print instructions
+    # instead of failing with a cryptic tblgen build error.
+    if command -v llvm-config-19 &>/dev/null; then
+        export_llvm_env_vars
+        install_compiler_if_needed "starknet-native-compile" "$NATIVE_COMPILE_VERSION"
+    else
+        log_step "install_build_tools" "Skipping starknet-native-compile (LLVM 19 not found)."
+        log_step "install_build_tools" "To install it: run 'scripts/dependencies.sh' first, then re-run this script."
+    fi
+fi