feat(mac-bridge): reboot auto-recover scripts (the unique value of #111)

#111 (Mac bridge M1) is otherwise already superseded by the bridge in main
(main's manifest.py is a 3.8x superset). Cherry-pick only its two standalone,
not-in-main artifacts: recover_runner_after_reboot.sh (self-heal the GitHub
Actions runner after a Mac reboot) + install_autorecover_launchagent.sh.

Co-authored-by: FluffyAIcode <FluffyAIcode@users.noreply.github.com>

Author: cursoragent

scripts/mac_bridge/install_autorecover_launchagent.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+# Install a user LaunchAgent that re-checks the mac-bridge runner
+# after reboot and periodically self-heals it.
+
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+RECOVER_SCRIPT="${REPO_ROOT}/scripts/mac_bridge/recover_runner_after_reboot.sh"
+PLIST_DIR="${HOME}/Library/LaunchAgents"
+PLIST_PATH="${PLIST_DIR}/com.kakeya.mac-bridge-runner-autorecover.plist"
+LABEL="com.kakeya.mac-bridge-runner-autorecover"
+UID_NUM="$(id -u)"
+
+mkdir -p "$PLIST_DIR"
+[ -x "$RECOVER_SCRIPT" ] || chmod +x "$RECOVER_SCRIPT"
+
+cat >"$PLIST_PATH" <<EOF
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${LABEL}</string>
+
+  <key>ProgramArguments</key>
+  <array>
+    <string>/bin/bash</string>
+    <string>${RECOVER_SCRIPT}</string>
+  </array>
+
+  <key>WorkingDirectory</key>
+  <string>${REPO_ROOT}</string>
+
+  <key>RunAtLoad</key>
+  <true/>
+  <key>StartInterval</key>
+  <integer>60</integer>
+
+  <key>StandardOutPath</key>
+  <string>${HOME}/actions-runner/_diag/launchagent-autorecover.out.log</string>
+  <key>StandardErrorPath</key>
+  <string>${HOME}/actions-runner/_diag/launchagent-autorecover.err.log</string>
+</dict>
+</plist>
+EOF
+
+launchctl bootout "gui/${UID_NUM}" "${PLIST_PATH}" >/dev/null 2>&1 || true
+launchctl bootstrap "gui/${UID_NUM}" "${PLIST_PATH}"
+launchctl enable "gui/${UID_NUM}/${LABEL}" || true
+launchctl kickstart -k "gui/${UID_NUM}/${LABEL}" || true
+
+echo "[mac-bridge-autorecover] installed: ${PLIST_PATH}"
+echo "[mac-bridge-autorecover] label: ${LABEL}"

scripts/mac_bridge/recover_runner_after_reboot.sh

@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+# Self-heal the GitHub Actions runner after Mac reboot.
+#
+# Idempotent:
+#  - if Runner.Listener is already alive: no-op
+#  - else try svc.sh start (when service is installed)
+#  - if service is not installed/usable, fall back to foreground run.sh
+#    via nohup so bridge jobs can still execute.
+
+set -euo pipefail
+
+RUNNER_DIR="${RUNNER_DIR:-$HOME/actions-runner}"
+LOG_DIR="${RUNNER_LOG_DIR:-$HOME/actions-runner/_diag}"
+mkdir -p "$LOG_DIR"
+
+log() { echo "[mac-bridge-recover] $*" >&2; }
+
+if pgrep -f "Runner.Listener.*${RUNNER_DIR}" >/dev/null 2>&1; then
+  log "Runner.Listener already running."
+  exit 0
+fi
+
+if [ ! -x "${RUNNER_DIR}/run.sh" ]; then
+  log "runner not found at ${RUNNER_DIR}; skipping."
+  exit 0
+fi
+
+if [ -x "${RUNNER_DIR}/svc.sh" ] && "${RUNNER_DIR}/svc.sh" status 2>/dev/null | grep -q "installed"; then
+  log "service installed; attempting svc.sh start"
+  if "${RUNNER_DIR}/svc.sh" start >/dev/null 2>&1; then
+    sleep 2
+    if pgrep -f "Runner.Listener.*${RUNNER_DIR}" >/dev/null 2>&1; then
+      log "runner started via service."
+      exit 0
+    fi
+  fi
+  log "service start did not bring up listener, falling back to run.sh"
+fi
+
+ts="$(date +%Y%m%d_%H%M%S)"
+nohup "${RUNNER_DIR}/run.sh" >"${LOG_DIR}/runner-nohup-${ts}.log" 2>&1 &
+sleep 2
+if pgrep -f "Runner.Listener.*${RUNNER_DIR}" >/dev/null 2>&1; then
+  log "runner started via nohup run.sh fallback."
+  exit 0
+fi
+
+log "failed to start runner listener."
+exit 1