@bongos/core 1.24.76 → 1.24.78

package/scripts/bongos/autobongos-bootstrap.ps1

@@ -0,0 +1,169 @@
+# scripts/bongos/autobongos-bootstrap.ps1 -- the first lines of Autobongos setup
+# on a Windows PC (tasks 1005095, 1005094; goal 1000139).
+#
+#   autobongos-bootstrap.ps1 -Code abr_... -ApiBase https://... -Repo https://github.com/owner/name
+#
+# and, as the hall hands it out, with no file on the PC at all:
+#
+#   & ([scriptblock]::Create((irm 'https://<project>/api/bongos/autonomy/runner-setup.ps1'))) -Code '...' -ApiBase '...' -Repo '...'
+#
+# WHY THIS IS POWERSHELL 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. The hall serves this file and Settings puts the one-time code in
+# the command, so the person copies one line.
+#
+# NO ADMINISTRATOR SHELL. It runs as the person, in an ordinary PowerShell window.
+# winget may show Windows' own "allow this app to make changes" prompt while it
+# installs git or Node; that is the installer asking, not this script.
+#
+# EVERY STOP IS A SENTENCE. A failure it cannot fix itself ends with what
+# happened and what to do, never a stack trace. Safe to run again: each step
+# checks before it acts, and a copy that already exists is brought current
+# instead of cloned twice.
+#
+# IT NEVER CALLS exit WHEN IT WAS PASTED (task 1005094). Run as a script block --
+# which is how the pasted line runs it -- `exit` ends the PowerShell WINDOW, so
+# the person would see their window vanish instead of the sentence telling them
+# what to do. Every stop therefore unwinds to the bottom of this file, which
+# calls `exit` only when this is running as a file.
+
+[CmdletBinding()]
+param(
+  [string]$Code,
+  [string]$ApiBase,
+  [string]$Repo,
+  # Where the runner keeps its own files. One folder, so removing the runner is
+  # deleting it. $HOME, not $env:USERPROFILE: it is the same folder on Windows,
+  # and it also exists where this file is only ever tested (PowerShell on Linux
+  # has no USERPROFILE, and a null default stops the script before its first line).
+  [string]$RunnerHome = (Join-Path $HOME '.cloudbongos-runner'),
+  # Say what would be done and stop before changing anything.
+  [switch]$DryRun
+)
+
+$ErrorActionPreference = 'Stop'
+$StopMark = 'autobongos-setup-stopped'
+
+function Stop-Setup([string]$What, [string]$Fix) {
+  Write-Host ''
+  Write-Host "Autobongos setup stopped here: $What" -ForegroundColor Yellow
+  Write-Host "What to do: $Fix"
+  throw $StopMark
+}
+
+function Say([string]$Text) { Write-Host $Text }
+
+# A fresh install changes PATH in the registry, not in this window.
+function Update-PathFromRegistry {
+  $machine = [Environment]::GetEnvironmentVariable('Path', 'Machine')
+  $user = [Environment]::GetEnvironmentVariable('Path', 'User')
+  $env:Path = (@($machine, $user) | Where-Object { $_ }) -join ';'
+}
+
+function Test-Tool([string]$Name) { return [bool](Get-Command $Name -ErrorAction SilentlyContinue) }
+
+# Find a tool, or install it with winget and look again.
+function Assert-Tool([string]$Name, [string]$WingetId, [string]$Url) {
+  if (Test-Tool $Name) { Say "  found $Name"; return }
+  if ($DryRun) { Say "  would install $Name ($WingetId)"; return }
+  if (-not (Test-Tool 'winget')) {
+    Stop-Setup "$Name is not installed, and this PC has no winget to install it with." "Install $Name from $Url, open a new PowerShell window, and paste the setup command again."
+  }
+  Say "  installing $Name (Windows may ask you to allow it)..."
+  & winget install --id $WingetId -e --source winget --accept-package-agreements --accept-source-agreements --silent | Out-Null
+  Update-PathFromRegistry
+  if (-not (Test-Tool $Name)) {
+    Stop-Setup "$Name did not install." "Install $Name from $Url, open a new PowerShell window, and paste the setup command again."
+  }
+  Say "  installed $Name"
+}
+
+# The whole setup, in the open (not a function): what node and git print must
+# reach the person as it happens, and node must keep the keyboard for the Claude
+# sign-in. A stop it can explain throws $StopMark and lands in the catch below.
+$SetupExit = 1
+try {
+  if (-not $Code -or -not $ApiBase -or -not $Repo) {
+    Stop-Setup 'the setup command is incomplete.' 'Copy the whole command again from Settings > Your Autobongos runner.'
+  }
+  if ($Repo -notmatch '^https://[A-Za-z0-9.-]+/[A-Za-z0-9._/-]+$') {
+    Stop-Setup 'the project address in the command does not look right.' 'Copy the whole command again from Settings > Your Autobongos runner.'
+  }
+  # 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.
+  if ($ApiBase -notmatch '^https://[A-Za-z0-9.-]+(:\d+)?/?$' -and $ApiBase -notmatch '^http://(localhost|127\.0\.0\.1)(:\d+)?/?$') {
+    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.'
+  }
+
+  Say 'Setting this PC up as an Autobongos runner.'
+  Say 'It gets its own copy of the project and its own sign-in; your own work on this PC is not touched.'
+  Say ''
+  Say 'Checking the three programs it needs...'
+  Assert-Tool 'git' 'Git.Git' 'https://git-scm.com/download/win'
+  Assert-Tool 'node' 'OpenJS.NodeJS.LTS' 'https://nodejs.org'
+
+  if (Test-Tool 'claude') {
+    Say '  found claude'
+  } elseif ($DryRun) {
+    Say '  would install Claude Code'
+  } else {
+    Say '  installing Claude Code...'
+    # npm.cmd, not npm: PowerShell blocks npm.ps1 by default (task 1005033).
+    & npm.cmd install -g '@anthropic-ai/claude-code' | Out-Null
+    Update-PathFromRegistry
+    if (-not (Test-Tool 'claude')) {
+      Stop-Setup 'Claude Code did not install.' 'Install it from https://claude.com/claude-code, open a new PowerShell window, and paste the setup command again.'
+    }
+    Say '  installed Claude Code'
+  }
+
+  $RepoDir = Join-Path $RunnerHome 'repo'
+  Say ''
+  if ($DryRun) {
+    Say "Would make the runner's copy of the project in $RepoDir and hand over to autobongos-host.js."
+    $SetupExit = 0
+  } else {
+
+  New-Item -ItemType Directory -Force -Path $RunnerHome | Out-Null
+  if (Test-Path (Join-Path $RepoDir '.git')) {
+    Say "The runner's copy is already here; bringing it up to date..."
+    & git -C $RepoDir fetch --quiet origin main
+    if ($LASTEXITCODE -ne 0) {
+      Stop-Setup "this PC could not fetch the project's code from GitHub." 'Sign in to GitHub when Windows asks, then paste the setup command again.'
+    }
+    & git -C $RepoDir reset --quiet --hard origin/main
+  } else {
+    Say "Making the runner's own copy of the project (GitHub may ask you to sign in)..."
+    & git clone --quiet $Repo $RepoDir
+    if ($LASTEXITCODE -ne 0) {
+      Stop-Setup 'this PC could not copy the project from GitHub.' 'Sign in to GitHub in the window that opens (use an account that can see the project), then paste the setup command again.'
+    }
+  }
+
+  $HostJs = Join-Path $RepoDir 'scripts\bongos\autobongos-host.js'
+  if (-not (Test-Path $HostJs)) {
+    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.'
+  }
+
+  $env:AUTOBONGOS_HOME = $RunnerHome
+  & node $HostJs setup --code $Code --api-base $ApiBase --mark-runner-copy
+  $SetupExit = $LASTEXITCODE
+
+  }
+} catch {
+  if ("$($_.Exception.Message)" -ne $StopMark) {
+    Write-Host ''
+    Write-Host 'Autobongos setup stopped on something unexpected.' -ForegroundColor Yellow
+    Write-Host 'What to do: paste the setup command again. If it stops here twice, tell the project owner.'
+  }
+  $SetupExit = 1
+}
+
+# As a FILE, report the result the way a script does. PASTED (a script block has
+# no file of its own), leave the window open and only record the result.
+if ($MyInvocation.MyCommand.Path) { exit $SetupExit }
+$global:LASTEXITCODE = $SetupExit

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