Vendor OpenClaw source as Adolf fork baseline

Adolf is a fork/vendored clone of github.com/openclaw/openclaw (v2026.6.11),
free to diverge. Tree copied sans upstream .git; upstream remote added for
future syncs. Node pinned to 24 (.nvmrc); engines already require >=22.19.
Preserves docs/ARCHITECTURE.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LeqyaxJF2nbRXJtae2kNB2

scripts/build-and-run-mac.sh

@@ -0,0 +1,78 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+APP_DIR="$ROOT_DIR/apps/macos"
+
+usage() {
+  printf 'Usage: %s\n' "$(basename "$0")"
+  printf 'Build, stop, and relaunch the local debug OpenClaw macOS app.\n'
+}
+
+for arg in "$@"; do
+  case "$arg" in
+    --help|-h)
+      usage
+      exit 0
+      ;;
+    --) ;;
+    *) printf 'ERROR: Unknown build-and-run-mac option: %s\n' "$arg" >&2; exit 1 ;;
+  esac
+done
+
+cd "$APP_DIR"
+
+BUILD_PATH=".build-local"
+PRODUCT="OpenClaw"
+BIN="$BUILD_PATH/debug/$PRODUCT"
+BIN_ABS="$(pwd)/$BIN"
+APP_CWD="$(pwd -P)"
+LOG_PATH="${OPENCLAW_MAC_RUN_LOG:-$(mktemp "${TMPDIR:-/tmp}/openclaw-${PRODUCT}.XXXXXX.log")}"
+
+process_cwd_matches() {
+  local pid="$1"
+  local cwd=""
+  cwd="$(lsof -a -p "$pid" -d cwd -Fn 2>/dev/null | sed -n 's/^n//p' | head -n 1 || true)"
+  [[ "$cwd" == "$APP_CWD" ]]
+}
+
+local_debug_app_pids() {
+  {
+    pgrep -f "$BIN_ABS" 2>/dev/null || true
+    pgrep -f "$BIN" 2>/dev/null || true
+  } | while IFS= read -r pid; do
+    [[ "$pid" =~ ^[0-9]+$ ]] || continue
+    if process_cwd_matches "$pid"; then
+      printf '%s\n' "$pid"
+    fi
+  done | sort -u
+}
+
+stop_existing_local_app() {
+  for _ in {1..10}; do
+    local pids=""
+    pids="$(local_debug_app_pids)"
+    if [[ -z "$pids" ]]; then
+      return 0
+    fi
+    while IFS= read -r pid; do
+      kill "$pid" 2>/dev/null || true
+    done <<< "$pids"
+    sleep 0.3
+  done
+  return 1
+}
+
+printf "\n▶️  Building $PRODUCT (debug, build path: $BUILD_PATH)\n"
+swift build -c debug --product "$PRODUCT" --build-path "$BUILD_PATH"
+
+printf "\n⏹  Stopping existing $PRODUCT...\n"
+if ! stop_existing_local_app; then
+  printf "ERROR: existing local %s process did not exit: %s\n" "$PRODUCT" "$BIN_ABS" >&2
+  exit 1
+fi
+
+printf "\n🚀 Launching $BIN_ABS ...\n"
+nohup "$BIN_ABS" >"$LOG_PATH" 2>&1 &
+PID=$!
+printf "Started $PRODUCT (PID $PID). Logs: $LOG_PATH\n"