feat: aztec-up can be used to manage multiple aztec versions (#19261)

`aztec-up` can be used to manage multiple versions.

```
$ aztec-up
aztec-up - Aztec version manager

Usage: aztec-up [command] [options]

Commands:
  install <version>         Install a version and switch to it
  use [<version>]           Switch to an installed version (or read from .aztecrc)
  list                      List installed versions
  uninstall <version>       Remove an installed version
  self-update               Update aztec-up itself to the latest version

Options:
  -h, --help                Show this help message

Examples:
  aztec-up install          Install the latest version
  aztec-up install nightly  Install the latest nightly version
  aztec-up install 0.85.0   Install a specific version
  aztec-up use 0.85.0       Switch to version 0.85.0
  aztec-up use              Read version from .aztecrc and switch to it
  aztec-up list             Show all installed versions
  aztec-up self-update      Update aztec-up to latest
```

If a `.aztecrc` file is present in the cwd, `aztec` will automatically
switch to that version in that run context.

```
t % aztec --version
0.0.1-commit.1142ef1
t % cd fooproj
t % cat .aztecrc
0.0.1-commit.6d3c34e
t % aztec --version
0.0.1-commit.6d3c34e
t %
```

# Testing

You can install `aztec-up` with:
```
VERSION=0.0.1-commit.6d3c34e bash -i <(curl -s https://install.aztec.network/0.0.1-commit.6d3c34e/aztec-install)
```

At present you can't list available remote versions. The code does
currently support listing available remote aliases, but they're not
deployed yet. You can install another version with e.g.
```
aztec-up install 0.0.1-commit.1142ef1
```

Then list versions with:

```
t % aztec-up list
Installed versions:

* 0.0.1-commit.1142ef1 (current)
  0.0.1-commit.6d3c34e

Aliases:
  (could not fetch aliases)
```

Author: charlielye

.github/ci3.sh

@@ -77,6 +77,7 @@ function handle_release_pr {
   git tag "${tag_name}"
   git push origin "${tag_name}"
   echo "Created and pushed tag: ${tag_name}"
+  gh pr edit $PR_NUMBER --remove-label ci-release-pr || true
 }
 
 function main {

aztec-up/.gitignore

@@ -1,6 +1,6 @@
 .terraform
 .terraform*
 .DS_Store
-bin/versions
+bin/0.0.1/versions
 verdaccio-storage
 aztec-release-test-image

aztec-up/bin/0.0.1/install

@@ -0,0 +1,152 @@
+#!/usr/bin/env bash
+# Per-version installer script
+# This script is called by aztec-up to install a specific version of the Aztec toolchain.
+# It expects VERSION and INSTALL_URI to be set.
+set -euo pipefail
+shopt -s inherit_errexit
+
+# Colors
+g="\033[32m" # Green
+y="\033[33m" # Yellow
+b="\033[34m" # Blue
+r="\033[0m"  # Reset
+
+# Required environment variables
+VERSION="${VERSION:?VERSION must be set}"
+AZTEC_HOME="${AZTEC_HOME:-$HOME/.aztec}"
+INSTALL_URI="${INSTALL_URI:-https://install.aztec.network}"
+
+# Version-specific paths
+version_path="$AZTEC_HOME/versions/$VERSION"
+version_bin_path="$version_path/bin"
+
+function echo_green {
+  echo -e "${g}$1${r}"
+}
+
+function echo_yellow {
+  echo -e "${y}$1${r}"
+}
+
+function dump_fail {
+  output=$(mktemp)
+
+  set +e
+  ($1) &>$output
+  status=$?
+  set -e
+
+  # 0 or SIGTERM considered a success.
+  if [ "$status" -ne 0 ] && [ "$status" -ne 143 ]; then
+    {
+      echo
+      echo -e "${y}command failed${r}: $1 (exit: $status)"
+      echo -e "${b}--- output ---${r}"
+      cat $output
+    } >&2
+  fi
+
+  rm $output
+
+  return $status
+}
+
+function check_toolchains {
+  # Check Node.js version.
+  local node_min_version=$(cat "$version_path/versions" | grep node | cut -d' ' -f2)
+  local node_installed_version=$(node --version 2>/dev/null | cut -d 'v' -f 2 || echo "none")
+  if [[ "$(printf '%s\n' "$node_min_version" "$node_installed_version" | sort -V | head -n1)" != "$node_min_version" ]]; then
+    echo "Minimum Node.js version $node_min_version not found (got $node_installed_version)."
+    echo "Installation: nvm install --lts && nvm alias default lts/*"
+    exit 1
+  fi
+}
+
+function install_versions_file {
+  # Determine the correct URI for fetching the versions file
+  local versions_uri="$INSTALL_URI"
+  curl -fsSL "$versions_uri/$VERSION/versions" -o "$version_path/versions"
+}
+
+function install_noir {
+  local noir_version=$(cat "$version_path/versions" | grep noir | cut -d' ' -f2)
+
+  # Create a temp directory for noirup to install to
+  local temp_nargo_home=$(mktemp -d)
+  mkdir -p "$temp_nargo_home/bin"
+
+  # Install noirup if not already present
+  if [ ! -f "$HOME/.nargo/bin/noirup" ]; then
+    curl -Ls https://raw.githubusercontent.com/noir-lang/noirup/refs/heads/main/install | bash
+  fi
+
+  # Install noir to temp location and move to version directory
+  NARGO_HOME="$temp_nargo_home" "$HOME/.nargo/bin/noirup" -v "$noir_version"
+
+  # Move the nargo binary to our version bin directory
+  mv "$temp_nargo_home/bin/nargo" "$version_bin_path/nargo"
+
+  # Cleanup temp directory
+  rm -rf "$temp_nargo_home"
+}
+
+function install_foundry {
+  local foundry_version=$(cat "$version_path/versions" | grep foundry | cut -d' ' -f2)
+
+  # Create a temp directory for foundryup to install to
+  local temp_foundry_dir=$(mktemp -d)
+  mkdir -p "$temp_foundry_dir/bin"
+
+  # Install foundryup if not already present
+  if [ ! -f "$HOME/.foundry/bin/foundryup" ]; then
+    curl -L https://foundry.paradigm.xyz | bash
+  fi
+
+  # Install foundry to temp location and move to version directory
+  FOUNDRY_DIR="$temp_foundry_dir" "$HOME/.foundry/bin/foundryup" -i "$foundry_version"
+
+  # Move the foundry binaries to our version bin directory
+  for binary in forge cast anvil chisel; do
+    if [ -f "$temp_foundry_dir/bin/$binary" ]; then
+      mv "$temp_foundry_dir/bin/$binary" "$version_bin_path/$binary"
+    fi
+  done
+
+  # Cleanup temp directory
+  rm -rf "$temp_foundry_dir"
+}
+
+function install_aztec_packages {
+  # Install npm packages to the version directory using --prefix
+  npm install @aztec/aztec@$VERSION @aztec/cli-wallet@$VERSION @aztec/bb.js@$VERSION --prefix "$version_path"
+}
+
+function main {
+  # Create version directory
+  mkdir -p "$version_bin_path"
+
+  # Download versions manifest
+  echo -n "Installing version manifest... "
+  dump_fail install_versions_file
+  echo_green "done."
+
+  # Check Node.js version
+  check_toolchains
+
+  # Install noir
+  echo -n "Installing nargo... "
+  dump_fail install_noir
+  echo_green "done."
+
+  # Install foundry
+  echo -n "Installing foundry... "
+  dump_fail install_foundry
+  echo_green "done."
+
+  # Install aztec npm packages
+  echo -n "Installing aztec packages... "
+  dump_fail install_aztec_packages
+  echo_green "done."
+}
+
+main "$@"

aztec-up/bin/aliases/index

@@ -0,0 +1,2 @@
+latest
+nightly

aztec-up/bin/aliases/latest

@@ -0,0 +1 @@
+0.0.1

aztec-up/bin/aliases/nightly

@@ -0,0 +1 @@
+0.0.1