part #2

scripts/setup.sh

@@ -0,0 +1,294 @@
+#!/usr/bin/env bash
+# Automated developer environment setup for Stella Ops (Linux/macOS).
+#
+# Usage:
+#   ./scripts/setup.sh [--skip-build] [--infra-only] [--images-only] [--skip-images]
+set -euo pipefail
+
+# ─── Parse flags ────────────────────────────────────────────────────────────
+
+SKIP_BUILD=false
+INFRA_ONLY=false
+IMAGES_ONLY=false
+SKIP_IMAGES=false
+
+for arg in "$@"; do
+  case "$arg" in
+    --skip-build)  SKIP_BUILD=true ;;
+    --infra-only)  INFRA_ONLY=true ;;
+    --images-only) IMAGES_ONLY=true ;;
+    --skip-images) SKIP_IMAGES=true ;;
+    -h|--help)
+      echo "Usage: $0 [--skip-build] [--infra-only] [--images-only] [--skip-images]"
+      exit 0
+      ;;
+    *) echo "Unknown flag: $arg" >&2; exit 1 ;;
+  esac
+done
+
+ROOT=$(git rev-parse --show-toplevel 2>/dev/null || true)
+if [[ -z "$ROOT" ]]; then
+  echo "ERROR: Not inside a git repository." >&2
+  exit 1
+fi
+
+COMPOSE_DIR="${ROOT}/devops/compose"
+
+# ─── Helpers ────────────────────────────────────────────────────────────────
+
+step()  { printf '\n\033[1;36m>> %s\033[0m\n' "$1"; }
+ok()    { printf '   \033[0;32m[OK]\033[0m %s\n' "$1"; }
+warn()  { printf '   \033[0;33m[WARN]\033[0m %s\n' "$1"; }
+fail()  { printf '   \033[0;31m[FAIL]\033[0m %s\n' "$1"; }
+
+has_cmd() { command -v "$1" &>/dev/null; }
+
+# ─── 1. Check prerequisites ────────────────────────────────────────────────
+
+check_prerequisites() {
+  step 'Checking prerequisites'
+  local all_good=true
+
+  # dotnet
+  if has_cmd dotnet; then
+    local v; v=$(dotnet --version 2>/dev/null)
+    if [[ "$v" =~ ^10\. ]]; then
+      ok "dotnet $v"
+    else
+      fail "dotnet $v found, but 10.x is required"
+      all_good=false
+    fi
+  else
+    fail 'dotnet SDK not found. Install .NET 10 SDK.'
+    all_good=false
+  fi
+
+  # node
+  if has_cmd node; then
+    local v; v=$(node --version 2>/dev/null | sed 's/^v//')
+    local major; major=$(echo "$v" | cut -d. -f1)
+    if (( major >= 20 )); then
+      ok "node $v"
+    else
+      fail "node $v found, but 20+ is required"
+      all_good=false
+    fi
+  else
+    fail 'node not found. Install Node.js 20+.'
+    all_good=false
+  fi
+
+  # npm
+  if has_cmd npm; then
+    local v; v=$(npm --version 2>/dev/null)
+    local major; major=$(echo "$v" | cut -d. -f1)
+    if (( major >= 10 )); then
+      ok "npm $v"
+    else
+      fail "npm $v found, but 10+ is required"
+      all_good=false
+    fi
+  else
+    fail 'npm not found.'
+    all_good=false
+  fi
+
+  # docker
+  if has_cmd docker; then
+    ok "docker: $(docker --version 2>/dev/null)"
+  else
+    fail 'docker not found. Install Docker.'
+    all_good=false
+  fi
+
+  # docker compose
+  if docker compose version &>/dev/null; then
+    ok 'docker compose available'
+  else
+    fail 'docker compose not available. Install Compose V2.'
+    all_good=false
+  fi
+
+  # git
+  if has_cmd git; then
+    ok "$(git --version 2>/dev/null)"
+  else
+    fail 'git not found.'
+    all_good=false
+  fi
+
+  if [[ "$all_good" != "true" ]]; then
+    echo 'ERROR: Prerequisites not met. Install missing tools and re-run.' >&2
+    exit 1
+  fi
+}
+
+# ─── 2. Check hosts file ───────────────────────────────────────────────────
+
+check_hosts() {
+  step 'Checking hosts file for stella-ops.local entries'
+  if grep -q 'stella-ops\.local' /etc/hosts 2>/dev/null; then
+    ok 'stella-ops.local entries found in /etc/hosts'
+  else
+    warn 'stella-ops.local entries NOT found in /etc/hosts.'
+    echo '   Add the hosts block from docs/dev/DEV_ENVIRONMENT_SETUP.md section 2'
+    echo '   to /etc/hosts (use sudo).'
+  fi
+}
+
+# ─── 3. Ensure .env ────────────────────────────────────────────────────────
+
+ensure_env() {
+  step 'Ensuring .env file exists'
+  local env_file="${COMPOSE_DIR}/.env"
+  local env_example="${COMPOSE_DIR}/env/stellaops.env.example"
+
+  if [[ -f "$env_file" ]]; then
+    ok ".env already exists at $env_file"
+  elif [[ -f "$env_example" ]]; then
+    cp "$env_example" "$env_file"
+    ok "Copied $env_example -> $env_file"
+    warn 'Review .env and change POSTGRES_PASSWORD at minimum.'
+  else
+    fail "Neither .env nor env/stellaops.env.example found in $COMPOSE_DIR"
+    exit 1
+  fi
+}
+
+# ─── 4. Start infrastructure ───────────────────────────────────────────────
+
+start_infra() {
+  step 'Starting infrastructure containers (docker-compose.dev.yml)'
+  cd "$COMPOSE_DIR"
+
+  docker compose -f docker-compose.dev.yml up -d
+
+  echo '   Waiting for containers to become healthy...'
+  local max_wait=120
+  local elapsed=0
+  while (( elapsed < max_wait )); do
+    local all_healthy=true
+    while IFS= read -r line; do
+      [[ -z "$line" ]] && continue
+      local health; health=$(echo "$line" | python3 -c "import sys,json; print(json.load(sys.stdin).get('Health',''))" 2>/dev/null || true)
+      if [[ -n "$health" && "$health" != "healthy" ]]; then
+        all_healthy=false
+      fi
+    done < <(docker compose -f docker-compose.dev.yml ps --format json 2>/dev/null)
+
+    if [[ "$all_healthy" == "true" && $elapsed -gt 5 ]]; then
+      ok 'All infrastructure containers healthy'
+      cd "$ROOT"
+      return
+    fi
+    sleep 5
+    elapsed=$((elapsed + 5))
+  done
+  warn "Timed out waiting for healthy status after ${max_wait}s."
+  cd "$ROOT"
+}
+
+# ─── 5. Build .NET solutions ───────────────────────────────────────────────
+
+build_solutions() {
+  step 'Building all .NET solutions'
+  local script="${ROOT}/scripts/build-all-solutions.sh"
+  if [[ -x "$script" ]]; then
+    "$script"
+    ok '.NET solutions built successfully'
+  elif [[ -f "$script" ]]; then
+    bash "$script"
+    ok '.NET solutions built successfully'
+  else
+    warn "Build script not found at $script. Skipping .NET build."
+  fi
+}
+
+# ─── 6. Build Docker images ────────────────────────────────────────────────
+
+build_images() {
+  step 'Building Docker images'
+  local script="${ROOT}/devops/docker/build-all.sh"
+  if [[ -x "$script" ]]; then
+    "$script"
+    ok 'Docker images built successfully'
+  elif [[ -f "$script" ]]; then
+    bash "$script"
+    ok 'Docker images built successfully'
+  else
+    warn "Build script not found at $script. Skipping image build."
+  fi
+}
+
+# ─── 7. Start full platform ────────────────────────────────────────────────
+
+start_platform() {
+  step 'Starting full Stella Ops platform'
+  cd "$COMPOSE_DIR"
+  docker compose -f docker-compose.stella-ops.yml up -d
+  ok 'Platform services started'
+  cd "$ROOT"
+}
+
+# ─── 8. Smoke test ─────────────────────────────────────────────────────────
+
+smoke_test() {
+  step 'Running smoke tests'
+
+  if docker exec stellaops-dev-postgres pg_isready -U stellaops &>/dev/null; then
+    ok 'PostgreSQL'
+  else
+    warn 'PostgreSQL not responding'
+  fi
+
+  local pong; pong=$(docker exec stellaops-dev-valkey valkey-cli ping 2>/dev/null || true)
+  if [[ "$pong" == "PONG" ]]; then
+    ok 'Valkey'
+  else
+    warn 'Valkey not responding'
+  fi
+}
+
+# ─── Main ───────────────────────────────────────────────────────────────────
+
+echo '============================================='
+echo '  Stella Ops Developer Environment Setup'
+echo '============================================='
+
+check_prerequisites
+check_hosts
+
+if [[ "$IMAGES_ONLY" == "true" ]]; then
+  build_images
+  echo ''
+  echo 'Done (images only).'
+  exit 0
+fi
+
+ensure_env
+start_infra
+
+if [[ "$INFRA_ONLY" == "true" ]]; then
+  smoke_test
+  echo ''
+  echo 'Done (infra only). Infrastructure is running.'
+  exit 0
+fi
+
+if [[ "$SKIP_BUILD" != "true" ]]; then
+  build_solutions
+fi
+
+if [[ "$SKIP_IMAGES" != "true" ]]; then
+  build_images
+fi
+
+start_platform
+smoke_test
+
+echo ''
+echo '============================================='
+echo '  Setup complete!'
+echo '  Platform: https://stella-ops.local'
+echo '  Docs:     docs/dev/DEV_ENVIRONMENT_SETUP.md'
+echo '============================================='