@bongos/core 1.24.76 → 1.24.77

package/scripts/bongos/autobongos-bootstrap.sh

@@ -0,0 +1,151 @@
+#!/usr/bin/env bash
+# scripts/bongos/autobongos-bootstrap.sh — the first lines of Autobongos setup on
+# a Mac (task 1005095, goal 1000139). The Windows twin is autobongos-bootstrap.ps1.
+#
+#   autobongos-bootstrap.sh --code abr_… --api-base https://… --repo https://github.com/owner/name
+#
+# WHY THIS IS SHELL AND SO SHORT. Everything that sets a runner up is one Node
+# program (autobongos-host.js), the same on Windows and Mac. But Node cannot
+# install Node, and the program lives in a copy of the project that does not exist
+# yet. So this does only what must happen before Node can take over: find or
+# install git, Node and Claude Code, make the runner ITS OWN copy of the project,
+# and hand over.
+#
+# NO sudo, ANYWHERE. git comes from Apple's own command-line tools (macOS asks
+# with its own window), Node is unpacked into the runner's folder when the Mac has
+# none, and Claude Code installs into the person's own account.
+#
+# EVERY STOP IS A SENTENCE: what happened and what to do, never raw tool output.
+# Safe to run again — each step checks before it acts.
+#
+# It also runs on Linux, where the runner then has no start-at-sign-in entry (the
+# goal covers Windows and Mac); that is what lets CI exercise this file.
+
+set -u
+
+CODE=""; API_BASE=""; REPO=""; DRY_RUN=0
+RUNNER_HOME="${AUTOBONGOS_HOME:-$HOME/.cloudbongos-runner}"
+
+stop_setup() {
+  printf '\nAutobongos setup stopped here: %s\nWhat to do: %s\n' "$1" "$2" >&2
+  exit 1
+}
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --code) CODE="${2:-}"; shift 2 ;;
+    --api-base) API_BASE="${2:-}"; shift 2 ;;
+    --repo) REPO="${2:-}"; shift 2 ;;
+    --home) RUNNER_HOME="${2:-}"; shift 2 ;;
+    --dry-run) DRY_RUN=1; shift ;;
+    *) shift ;;
+  esac
+done
+
+if [ -z "$CODE" ] || [ -z "$API_BASE" ] || [ -z "$REPO" ]; then
+  stop_setup "the setup command is incomplete." "Copy the whole command again from Settings > Your Autobongos runner."
+fi
+case "$REPO" in
+  https://*) : ;;
+  *) stop_setup "the project address in the command does not look right." "Copy the whole command again from Settings > Your Autobongos runner." ;;
+esac
+# The one-time code is sent to this address and the runner's login comes back
+# from it, so it must be https. Plain http is for this machine alone (a
+# developer's own instance); autobongos-host.js applies the same rule again.
+case "$API_BASE" in
+  https://*|http://localhost|http://localhost:*|http://127.0.0.1|http://127.0.0.1:*) : ;;
+  *) stop_setup "the project's address in the command is not a secure (https) address." "Copy the whole command again from Settings > Your Autobongos runner." ;;
+esac
+
+have() { command -v "$1" >/dev/null 2>&1; }
+
+# The setup command is piped into bash, so the keyboard is /dev/tty, not stdin.
+# OPENED, not just tested: with no terminal at all (CI, a remote command) the
+# device node still exists and reads as readable, and opening it is what fails.
+if { true </dev/tty; } 2>/dev/null; then HAVE_TTY=1; else HAVE_TTY=0; fi
+
+echo "Setting this device up as an Autobongos runner."
+echo "It gets its own copy of the project and its own sign-in; your own work here is not touched."
+echo
+echo "Checking the three programs it needs..."
+
+# --- git ---------------------------------------------------------------------
+# On a Mac /usr/bin/git exists even with no tools installed (it is a stub that
+# opens the installer), so ask xcode-select, not the PATH.
+if [ "$(uname -s)" = "Darwin" ] && ! xcode-select -p >/dev/null 2>&1; then
+  if [ "$DRY_RUN" = 1 ]; then echo "  would install Apple's command-line tools (git)"
+  else
+    xcode-select --install >/dev/null 2>&1 || true
+    stop_setup "this Mac needs Apple's command-line tools, which include git." "A window has opened asking to install them. Press Install, wait for it to finish, then paste the setup command again."
+  fi
+elif have git; then echo "  found git"
+elif [ "$DRY_RUN" = 1 ]; then echo "  would need git"
+else stop_setup "git is not installed." "Install git, open a new terminal window, and paste the setup command again."
+fi
+
+# --- node --------------------------------------------------------------------
+# Unpacked into the runner's own folder when the device has none: no installer,
+# no password, and removing the runner removes it.
+NODE_DIR="$RUNNER_HOME/node"
+if [ -x "$NODE_DIR/bin/node" ]; then PATH="$NODE_DIR/bin:$PATH"; fi
+if have node; then echo "  found node"
+elif [ "$DRY_RUN" = 1 ]; then echo "  would install Node into $NODE_DIR"
+else
+  echo "  installing Node into the runner's folder..."
+  case "$(uname -s)" in Darwin) NODE_OS=darwin ;; Linux) NODE_OS=linux ;; *) NODE_OS="" ;; esac
+  case "$(uname -m)" in arm64|aarch64) NODE_ARCH=arm64 ;; x86_64|amd64) NODE_ARCH=x64 ;; *) NODE_ARCH="" ;; esac
+  if [ -z "$NODE_OS" ] || [ -z "$NODE_ARCH" ]; then
+    stop_setup "Node is not installed, and this kind of device is not one this setup can install it on." "Install Node from https://nodejs.org, open a new terminal window, and paste the setup command again."
+  fi
+  NODE_BASE="https://nodejs.org/dist/latest-v22.x"
+  NODE_TAR="$(curl -fsSL "$NODE_BASE/SHASUMS256.txt" 2>/dev/null | awk '{print $2}' | grep -E "^node-v[0-9.]+-${NODE_OS}-${NODE_ARCH}\.tar\.gz$" | head -n 1)"
+  if [ -z "$NODE_TAR" ]; then
+    stop_setup "Node could not be downloaded." "Check this device is online, or install Node from https://nodejs.org, then paste the setup command again."
+  fi
+  mkdir -p "$NODE_DIR"
+  if ! curl -fsSL "$NODE_BASE/$NODE_TAR" | tar -xz -C "$NODE_DIR" --strip-components 1; then
+    stop_setup "Node could not be unpacked." "Install Node from https://nodejs.org, open a new terminal window, and paste the setup command again."
+  fi
+  PATH="$NODE_DIR/bin:$PATH"
+  have node || stop_setup "Node did not install." "Install Node from https://nodejs.org, open a new terminal window, and paste the setup command again."
+  echo "  installed node"
+fi
+
+# --- claude ------------------------------------------------------------------
+if [ -x "$HOME/.local/bin/claude" ]; then PATH="$HOME/.local/bin:$PATH"; fi
+if have claude; then echo "  found claude"
+elif [ "$DRY_RUN" = 1 ]; then echo "  would install Claude Code"
+else
+  echo "  installing Claude Code..."
+  npm install -g @anthropic-ai/claude-code >/dev/null 2>&1 || true
+  have claude || stop_setup "Claude Code did not install." "Install it from https://claude.com/claude-code, open a new terminal window, and paste the setup command again."
+  echo "  installed Claude Code"
+fi
+
+REPO_DIR="$RUNNER_HOME/repo"
+echo
+if [ "$DRY_RUN" = 1 ]; then
+  echo "Would make the runner's copy of the project in $REPO_DIR and hand over to autobongos-host.js."
+  exit 0
+fi
+
+mkdir -p "$RUNNER_HOME"
+if [ -d "$REPO_DIR/.git" ]; then
+  echo "The runner's copy is already here; bringing it up to date..."
+  if [ "$HAVE_TTY" = 1 ]; then git -C "$REPO_DIR" fetch --quiet origin main </dev/tty; else git -C "$REPO_DIR" fetch --quiet origin main; fi \
+    || stop_setup "this device could not fetch the project's code from GitHub." "Sign in to GitHub on this device (the GitHub CLI's  gh auth login  is the simplest way), then paste the setup command again."
+  git -C "$REPO_DIR" reset --quiet --hard origin/main
+else
+  echo "Making the runner's own copy of the project (GitHub may ask you to sign in)..."
+  if [ "$HAVE_TTY" = 1 ]; then git clone --quiet "$REPO" "$REPO_DIR" </dev/tty; else git clone --quiet "$REPO" "$REPO_DIR"; fi \
+    || stop_setup "this device could not copy the project from GitHub." "Sign in to GitHub on this device with an account that can see the project (the GitHub CLI's  gh auth login  is the simplest way), then paste the setup command again."
+fi
+
+HOST_JS="$REPO_DIR/scripts/bongos/autobongos-host.js"
+[ -f "$HOST_JS" ] || stop_setup "the project's copy has no runner program in it." "The project is on an older version. Ask the project owner to update it, then try again."
+
+export AUTOBONGOS_HOME="$RUNNER_HOME" PATH
+if [ "$HAVE_TTY" = 1 ]; then
+  exec node "$HOST_JS" setup --code "$CODE" --api-base "$API_BASE" --mark-runner-copy </dev/tty
+fi
+exec node "$HOST_JS" setup --code "$CODE" --api-base "$API_BASE" --mark-runner-copy