From 52c9f1b06b724c8cbfe81287bcd2ee2c060829cd Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Thu, 27 Aug 2026 18:58:53 +0000
Subject: [PATCH] Add Cloud Agent install/start scripts for Alice full stack.

Idempotent install bootstraps Python venv deps, pnpm web deps, and nested Docker.
Start brings up compose services, migrates, seeds the local user, then runs API+web.

Co-authored-by: Sam <samrusani@users.noreply.github.com>
---
 scripts/cloud_agent_install.sh | 43 ++++++++++++++++++++++++++
 scripts/cloud_agent_start.sh   | 56 ++++++++++++++++++++++++++++++++++
 2 files changed, 99 insertions(+)
 create mode 100755 scripts/cloud_agent_install.sh
 create mode 100755 scripts/cloud_agent_start.sh

diff --git a/scripts/cloud_agent_install.sh b/scripts/cloud_agent_install.sh
new file mode 100755
index 00000000..8502e035
--- /dev/null
+++ b/scripts/cloud_agent_install.sh
@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+# Idempotent Cloud Agent install for AliceMemory (full Postgres stack).
+set -euo pipefail
+
+REPO_ROOT="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "${REPO_ROOT}"
+
+export DEBIAN_FRONTEND=noninteractive
+
+need_cmd() {
+  command -v "$1" >/dev/null 2>&1
+}
+
+# python3-venv is required for make setup on Debian/Ubuntu base images.
+if ! python3 -c 'import ensurepip' >/dev/null 2>&1; then
+  sudo apt-get update -qq
+  sudo apt-get install -y -qq python3.12-venv python3-pip
+fi
+
+# Nested Docker for compose-backed Postgres/Redis/MinIO.
+if ! need_cmd docker; then
+  sudo apt-get update -qq
+  sudo apt-get install -y -qq ca-certificates curl fuse-overlayfs iptables
+  curl -fsSL https://get.docker.com | sudo sh
+fi
+
+if [ ! -f /etc/docker/daemon.json ]; then
+  sudo mkdir -p /etc/docker
+  cat <<'EOF' | sudo tee /etc/docker/daemon.json >/dev/null
+{
+  "storage-driver": "fuse-overlayfs",
+  "iptables": false,
+  "ip6tables": false
+}
+EOF
+fi
+
+sudo update-alternatives --set iptables /usr/sbin/iptables-legacy 2>/dev/null || true
+sudo update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy 2>/dev/null || true
+
+make setup
+
+echo "[cloud-agent-install] complete"
diff --git a/scripts/cloud_agent_start.sh b/scripts/cloud_agent_start.sh
new file mode 100755
index 00000000..79582a90
--- /dev/null
+++ b/scripts/cloud_agent_start.sh
@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+# Per-boot Cloud Agent start: Docker daemon, compose, migrate, seed, then API+web.
+set -euo pipefail
+
+REPO_ROOT="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "${REPO_ROOT}"
+
+ensure_dockerd() {
+  if docker info >/dev/null 2>&1; then
+    return 0
+  fi
+  if ! pgrep -x dockerd >/dev/null 2>&1; then
+    sudo dockerd >/tmp/dockerd.log 2>&1 &
+  fi
+  for _ in $(seq 1 60); do
+    if docker info >/dev/null 2>&1; then
+      sudo chmod 666 /var/run/docker.sock 2>/dev/null || true
+      return 0
+    fi
+    if sudo docker info >/dev/null 2>&1; then
+      sudo chmod 666 /var/run/docker.sock 2>/dev/null || true
+      if docker info >/dev/null 2>&1; then
+        return 0
+      fi
+    fi
+    sleep 1
+  done
+  echo "[cloud-agent-start] ERROR: dockerd failed to become ready" >&2
+  tail -50 /tmp/dockerd.log >&2 || true
+  exit 1
+}
+
+if [ ! -x "${REPO_ROOT}/.venv/bin/python" ]; then
+  echo "[cloud-agent-start] ERROR: missing .venv. Run install first." >&2
+  exit 1
+fi
+
+ensure_dockerd
+
+if [ -f "${REPO_ROOT}/.env" ]; then
+  set -a
+  # shellcheck disable=SC1091
+  . "${REPO_ROOT}/.env"
+  set +a
+fi
+
+"${REPO_ROOT}/scripts/dev_up.sh"
+"${REPO_ROOT}/.venv/bin/python" "${REPO_ROOT}/scripts/seed_local_user.py"
+
+echo "[cloud-agent-start] starting API (8000) and web (3000)"
+APP_RELOAD=false "${REPO_ROOT}/scripts/api_dev.sh" &
+api_pid=$!
+pnpm --dir apps/web dev --hostname 127.0.0.1 --port 3000 &
+web_pid=$!
+trap 'kill "$api_pid" "$web_pid" 2>/dev/null || true' INT TERM EXIT
+wait "$api_pid" "$web_pid"