@reservine/dx 1.0.0

package/plugins/reservine-dx/scripts/setup-worktree-be.sh

@@ -0,0 +1,501 @@
+#!/usr/bin/env bash
+#
+# Reservine-DX — Laravel Backend Worktree Setup
+#
+# Sets up a git worktree for the ReservineBack Laravel backend:
+#   - Copies .env / .env.local from main repo
+#   - Symlinks (or copies) vendor/ from the main repo
+#   - Starts Sail containers (shared with main repo)
+#   - Optionally creates an isolated Docker stack (--isolated)
+#     with its own DB, Redis, Meilisearch, Soketi, and deterministic ports
+#   - Seeds the isolated DB from a snapshot
+#   - Generates FE proxy config for the sibling Angular worktree
+#
+# Usage:
+#   ./setup-worktree-be.sh [OPTIONS]
+#
+# Options:
+#   --plan=<name>       Search .claude/plans/ for matching file, extract branch name
+#   --branch=<name>     Create and checkout this branch
+#   --base=<branch>     Base branch for PR (default: dev)
+#   --no-vendor-link    Run composer install instead of symlinking vendor/
+#   --skip-sail         Skip Sail container startup
+#   --isolated          Create isolated Docker stack with unique ports
+#   --teardown          Stop and remove the isolated Docker stack (destroys data)
+#   --reseed            Re-import the DB snapshot (destroys existing data)
+#   --status            Show all running worktree Docker stacks
+#   -h, --help          Show this help message
+#
+
+set -euo pipefail
+
+# Source shared core
+SCRIPTS_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPTS_DIR/_core.sh"
+
+# ─── Defaults ───────────────────────────────────────────────────────────────────
+
+VENDOR_LINK=true
+SKIP_SAIL=false
+BRANCH_NAME=""
+BASE_BRANCH="dev"
+PLAN_PATTERN=""
+ISOLATED=false
+TEARDOWN=false
+SHOW_STATUS=false
+RESEED=false
+
+# ─── Help ───────────────────────────────────────────────────────────────────────
+
+show_help() {
+    cat << 'EOF'
+Reservine-DX — Laravel Backend Worktree Setup
+
+Usage: ./setup-worktree-be.sh [OPTIONS]
+
+Options:
+  --plan=<name>       Search .claude/plans/ for matching file, extract branch name
+  --branch=<name>     Create and checkout this branch
+  --base=<branch>     Base branch for PR validation (default: dev)
+  --no-vendor-link    Run composer install instead of symlinking vendor/
+  --skip-sail         Skip Sail container startup even in local environment
+  --isolated          Create isolated Docker stack with unique ports (no shared services)
+  --teardown          Stop and remove the isolated Docker stack (destroys data)
+  --reseed            Re-import the DB snapshot (destroys existing data)
+  --status            Show all running worktree Docker stacks
+  -h, --help          Show this help message
+
+Environment Variables:
+  ROOT_WORKTREE_PATH  Path to main repo (auto-detected from git worktree list)
+
+Examples:
+  # Simple setup — auto-detects everything
+  ./setup-worktree-be.sh
+
+  # Setup with explicit branch
+  ./setup-worktree-be.sh --branch=feat/my-feature
+
+  # Isolated Docker environment (own DB, Redis, ports)
+  ./setup-worktree-be.sh --isolated
+
+  # Tear down an isolated environment
+  ./setup-worktree-be.sh --teardown
+
+  # Re-seed the isolated DB from snapshot
+  ./setup-worktree-be.sh --reseed
+EOF
+}
+
+# ─── Parse arguments ────────────────────────────────────────────────────────────
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --plan=*)          PLAN_PATTERN="${1#*=}"; shift ;;
+        --branch=*)        BRANCH_NAME="${1#*=}"; shift ;;
+        --base=*)          BASE_BRANCH="${1#*=}"; shift ;;
+        --no-vendor-link)  VENDOR_LINK=false; shift ;;
+        --skip-sail)       SKIP_SAIL=true; shift ;;
+        --isolated)        ISOLATED=true; shift ;;
+        --teardown)        TEARDOWN=true; shift ;;
+        --status)          SHOW_STATUS=true; shift ;;
+        --reseed)          RESEED=true; shift ;;
+        --log)             LOG_FILE="$(pwd)/setup.log"; shift ;;
+        --log=*)           LOG_FILE="${1#*=}"; shift ;;
+        -h|--help)         show_help; exit 0 ;;
+        *)                 error "Unknown option: $1"; show_help; exit 1 ;;
+    esac
+done
+
+init_log "$@"
+
+# --isolated requires its own vendor (autoloader paths must match container paths)
+if [[ "$ISOLATED" == true ]]; then
+    VENDOR_LINK=false
+fi
+
+# ─── Plan resolution ────────────────────────────────────────────────────────────
+
+if [[ -n "$PLAN_PATTERN" ]]; then
+    resolve_plan_file "$PLAN_PATTERN"
+fi
+
+# ─── ROOT_WORKTREE_PATH ─────────────────────────────────────────────────────────
+
+resolve_root_worktree_path
+
+# ─── Quick commands (can run before full pre-flight) ─────────────────────────────
+
+if [[ "$SHOW_STATUS" == true ]]; then
+    echo ""
+    echo "📊  Worktree Docker Stacks"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    docker ps --filter "name=wt-" --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}" 2>/dev/null || echo "No worktree containers found"
+    echo ""
+    exit 0
+fi
+
+if [[ "$TEARDOWN" == true ]]; then
+    if [[ -f "docker-compose.isolated.yaml" ]]; then
+        echo "🗑️  Tearing down isolated stack..."
+        docker compose -f docker-compose.isolated.yaml down -v
+        rm -f docker-compose.isolated.yaml .env.isolated
+        success "Isolated stack removed (volumes destroyed)"
+    else
+        warn "No docker-compose.isolated.yaml found in current directory"
+    fi
+    exit 0
+fi
+
+if [[ "$RESEED" == true ]]; then
+    if [[ -z "${ROOT_WORKTREE_PATH:-}" ]]; then
+        DETECTED_ROOT=$(git worktree list 2>/dev/null | grep -v ".worktrees" | head -1 | awk '{print $1}')
+        ROOT_WORKTREE_PATH="${DETECTED_ROOT:-$(pwd)}"
+    fi
+    SNAPSHOT_PATH="${ROOT_WORKTREE_PATH}/snapshots/reservine.sql.gz"
+    SEED_SCRIPT="${DX_PLUGIN_DIR}/docker/worktree/seed-snapshot.sh"
+    # Fallback to main repo's copy if DX script not found
+    [[ ! -f "$SEED_SCRIPT" ]] && SEED_SCRIPT="${ROOT_WORKTREE_PATH}/docker/worktree/seed-snapshot.sh"
+    if [[ -f "docker-compose.isolated.yaml" ]]; then
+        echo "🌱  Re-seeding database..."
+        docker compose -f docker-compose.isolated.yaml down -v
+        docker compose -f docker-compose.isolated.yaml up -d
+        echo "Waiting for DB to be healthy..."
+        sleep 15
+        BRANCH_SLUG=$(get_branch_slug)
+        "$SEED_SCRIPT" \
+            docker-compose.isolated.yaml "$SNAPSHOT_PATH" "reservine_wt_pass" "wt-${BRANCH_SLUG}"
+        success "Database re-seeded"
+    else
+        warn "No docker-compose.isolated.yaml found — run --isolated first"
+    fi
+    exit 0
+fi
+
+# ─── Pre-flight ─────────────────────────────────────────────────────────────────
+
+preflight_check
+
+info "Stack: Laravel (composer)"
+
+# ─── Branch setup ────────────────────────────────────────────────────────────────
+
+if [[ -n "$BRANCH_NAME" ]]; then
+    setup_branch "$BRANCH_NAME" "$BASE_BRANCH"
+fi
+
+# ─── Environment setup (.env, vendor) ────────────────────────────────────────────
+
+if [[ "$IS_CLOUD" == true ]]; then
+    info "Cloud environment — skipping .env and vendor setup"
+    info "Use setupClaudeWeb.sh for cloud configuration"
+else
+    echo "⚙️  Laravel Environment Setup"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+    # ── .env ──
+
+    if [[ ! -f ".env" ]]; then
+        if [[ -f "${ROOT_WORKTREE_PATH}/.env" ]]; then
+            cp "${ROOT_WORKTREE_PATH}/.env" .env
+            success "Copied .env from main repo"
+        else
+            warn "No .env found in main repo — you may need to create one"
+        fi
+    else
+        info ".env already exists"
+    fi
+
+    if [[ ! -f ".env.local" ]] && [[ -f "${ROOT_WORKTREE_PATH}/.env.local" ]]; then
+        cp "${ROOT_WORKTREE_PATH}/.env.local" .env.local
+        success "Copied .env.local from main repo"
+    fi
+
+    # ── vendor ──
+
+    if [[ "$VENDOR_LINK" == true ]]; then
+        if [[ -d "vendor" ]] && [[ ! -L "vendor" ]]; then
+            warn "vendor/ is a directory — removing to create symlink"
+            rm -rf vendor
+        fi
+
+        if [[ -L "vendor" ]]; then
+            info "vendor/ symlink already exists → $(readlink vendor)"
+        elif [[ -d "${ROOT_WORKTREE_PATH}/vendor" ]]; then
+            ln -s "${ROOT_WORKTREE_PATH}/vendor" vendor
+            success "Symlinked vendor/ → main repo"
+        else
+            warn "Main repo has no vendor/ — running composer install"
+            composer install --no-interaction --prefer-dist
+            success "Installed vendor/"
+        fi
+    else
+        if [[ -d "vendor" ]] && [[ ! -L "vendor" ]]; then
+            info "vendor/ directory already exists (local copy)"
+        else
+            [[ -L "vendor" ]] && rm vendor
+            if [[ -d "${ROOT_WORKTREE_PATH}/vendor" ]]; then
+                info "Copying vendor/ from main repo (this takes ~10s)..."
+                cp -R "${ROOT_WORKTREE_PATH}/vendor" vendor
+                success "Copied vendor/ (local copy for isolated mode)"
+            elif command -v composer &>/dev/null; then
+                composer install --no-interaction --prefer-dist
+                success "Installed vendor/"
+            else
+                error "No vendor/ source and no composer available"
+                exit 1
+            fi
+        fi
+    fi
+    echo ""
+fi
+
+# ─── Sail containers (shared, local only) ────────────────────────────────────────
+
+if [[ "$IS_CLOUD" == true ]]; then
+    info "Cloud environment — skipping Sail"
+elif [[ "$SKIP_SAIL" == true ]]; then
+    info "Sail startup skipped (--skip-sail)"
+elif [[ "$ISOLATED" == false ]]; then
+    echo "🐳  Sail Containers"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+    if [[ -x "./vendor/bin/sail" ]] || [[ -L "vendor" && -x "$(readlink -f vendor)/bin/sail" ]]; then
+        if ./vendor/bin/sail ps 2>/dev/null | grep -q "Up"; then
+            info "Sail containers already running"
+        else
+            info "Starting Sail containers..."
+            ./vendor/bin/sail up -d
+            success "Sail started"
+        fi
+
+        if [[ -f ".env" ]] && ! grep -qE "^APP_KEY=base64:" .env 2>/dev/null; then
+            ./vendor/bin/sail artisan key:generate
+            success "Generated app key"
+        fi
+    else
+        warn "Sail not available — skipping container startup"
+    fi
+    echo ""
+fi
+
+# ─── Isolated Docker stack (--isolated) ──────────────────────────────────────────
+
+if [[ "$ISOLATED" == true ]] && [[ "$IS_CLOUD" == false ]]; then
+    echo "🔒  Isolated Environment Setup"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+    BRANCH_SLUG=$(get_branch_slug)
+    OFFSET=$(port_hash "$BRANCH_SLUG")
+
+    # Calculate ports
+    ISO_DB_PORT=$((4300 + OFFSET))
+    ISO_REDIS_PORT=$((7300 + OFFSET))
+    ISO_APP_PORT=$((8000 + OFFSET))
+    ISO_ADMINER_PORT=$((9000 + OFFSET))
+    ISO_MEILI_PORT=$((8700 + OFFSET))
+    ISO_SOKETI_PORT=$((7100 + OFFSET))
+
+    # Collision check
+    COLLISION_FOUND=true
+    ATTEMPTS=0
+    while [[ "$COLLISION_FOUND" == true ]] && [[ $ATTEMPTS -lt 10 ]]; do
+        COLLISION_FOUND=false
+        for port in $ISO_DB_PORT $ISO_REDIS_PORT $ISO_APP_PORT $ISO_ADMINER_PORT $ISO_MEILI_PORT $ISO_SOKETI_PORT; do
+            if port_in_use "$port"; then
+                if docker ps --filter "name=wt-${BRANCH_SLUG}" --format "{{.Ports}}" 2>/dev/null | grep -q ":${port}->"; then
+                    continue
+                fi
+                COLLISION_FOUND=true
+                OFFSET=$(( (OFFSET + 1) % 100 ))
+                ISO_DB_PORT=$((4300 + OFFSET))
+                ISO_REDIS_PORT=$((7300 + OFFSET))
+                ISO_APP_PORT=$((8000 + OFFSET))
+                ISO_ADMINER_PORT=$((9000 + OFFSET))
+                ISO_MEILI_PORT=$((8700 + OFFSET))
+                ISO_SOKETI_PORT=$((7100 + OFFSET))
+                break
+            fi
+        done
+        ATTEMPTS=$((ATTEMPTS + 1))
+    done
+
+    info "Branch: $BRANCH_SLUG → offset $OFFSET"
+    info "Ports: App=$ISO_APP_PORT DB=$ISO_DB_PORT Redis=$ISO_REDIS_PORT"
+
+    # Resolve template — try DX plugin first, then main repo fallback
+    TEMPLATE_PATH="${DX_PLUGIN_DIR}/docker/worktree/docker-compose.isolated.template.yaml"
+    [[ ! -f "$TEMPLATE_PATH" ]] && TEMPLATE_PATH="${ROOT_WORKTREE_PATH}/docker/worktree/docker-compose.isolated.template.yaml"
+    if [[ ! -f "$TEMPLATE_PATH" ]]; then
+        error "Docker template not found"
+        echo "   Expected at: ${DX_PLUGIN_DIR}/docker/worktree/docker-compose.isolated.template.yaml" >&2
+        exit 1
+    fi
+
+    export COMPOSE_PROJECT_NAME="wt-${BRANCH_SLUG}"
+    export DB_PORT="$ISO_DB_PORT"
+    export DB_PASSWORD="reservine_wt_pass"
+    export REDIS_PASSWORD="t8eGxQbCd6uYTEPrGN2Rgta9SULy6qar"
+    export REDIS_PORT="$ISO_REDIS_PORT"
+    export APP_PORT="$ISO_APP_PORT"
+    export ADMINER_PORT="$ISO_ADMINER_PORT"
+    export MEILI_PORT="$ISO_MEILI_PORT"
+    export SOKETI_PORT="$ISO_SOKETI_PORT"
+
+    # Resolve vendor path (follow symlink to real directory)
+    if [[ -L "vendor" ]]; then
+        export VENDOR_PATH="$(readlink -f vendor)"
+    else
+        export VENDOR_PATH="$(pwd)/vendor"
+    fi
+
+    # Mount main repo at its original path so Composer's absolute path references resolve
+    export ROOT_REPO_PATH="$ROOT_WORKTREE_PATH"
+
+    envsubst < "$TEMPLATE_PATH" > docker-compose.isolated.yaml
+    success "Generated docker-compose.isolated.yaml"
+
+    # Patch .env with isolated credentials
+    if [[ -f ".env" ]]; then
+        sed -i.bak \
+            -e "s|^DB_HOST=.*|DB_HOST=db|" \
+            -e "s|^DB_PORT=.*|DB_PORT=3306|" \
+            -e "s|^DB_PASSWORD=.*|DB_PASSWORD=${DB_PASSWORD}|" \
+            -e "s|^DB_USERNAME=.*|DB_USERNAME=reservine|" \
+            -e "s|^DB_DATABASE=.*|DB_DATABASE=reservine|" \
+            -e "s|^REDIS_HOST=.*|REDIS_HOST=redis|" \
+            -e "s|^REDIS_PORT=.*|REDIS_PORT=6379|" \
+            .env
+        rm -f .env.bak
+        success "Patched .env with isolated connection settings"
+    fi
+
+    # Start the stack
+    info "Starting isolated Docker stack..."
+    COMPOSE_PROJECT_NAME="wt-${BRANCH_SLUG}" \
+        docker compose -f docker-compose.isolated.yaml up -d 2>&1 | tail -5
+    success "Docker stack started"
+
+    # Regenerate Composer autoloader inside container
+    info "Regenerating autoloader..."
+    docker exec "wt-${BRANCH_SLUG}-app" composer dump-autoload -d /var/www/html --quiet 2>/dev/null || true
+    success "Autoloader regenerated"
+
+    # Wait for DB healthy
+    info "Waiting for DB to be healthy..."
+    for i in $(seq 1 30); do
+        if docker exec "wt-${BRANCH_SLUG}-db" mariadb-admin ping -h localhost -ureservine -preservine_wt_pass >/dev/null 2>&1; then
+            success "DB is healthy"
+            break
+        fi
+        if [[ $i -eq 30 ]]; then
+            error "DB failed to become healthy after 30 attempts"
+            exit 1
+        fi
+        sleep 2
+    done
+
+    # Auto-import snapshot
+    SNAPSHOT_PATH="${ROOT_WORKTREE_PATH}/snapshots/reservine.sql.gz"
+    SEED_SCRIPT="${DX_PLUGIN_DIR}/docker/worktree/seed-snapshot.sh"
+    [[ ! -f "$SEED_SCRIPT" ]] && SEED_SCRIPT="${ROOT_WORKTREE_PATH}/docker/worktree/seed-snapshot.sh"
+    "$SEED_SCRIPT" \
+        docker-compose.isolated.yaml "$SNAPSHOT_PATH" "$DB_PASSWORD" "$COMPOSE_PROJECT_NAME"
+
+    # Generate FE proxy config for sibling worktree
+    FE_WORKTREE=$(find_fe_worktree || echo "")
+    if [[ -n "$FE_WORKTREE" ]]; then
+        cat > "$FE_WORKTREE/proxy.conf.json" <<PROXY_EOF
+{
+  "/api": {
+    "target": "http://localhost:${ISO_APP_PORT}",
+    "secure": false,
+    "changeOrigin": true
+  },
+  "/sanctum": {
+    "target": "http://localhost:${ISO_APP_PORT}",
+    "secure": false,
+    "changeOrigin": true
+  }
+}
+PROXY_EOF
+        success "Generated FE proxy: $FE_WORKTREE/proxy.conf.json"
+
+        # Copy existing .claude/config.local from FE main repo (has developer's credentials)
+        # then append/override the isolated BE API URL
+        mkdir -p "$FE_WORKTREE/.claude"
+        FE_MAIN_CONFIG_LOCAL=""
+        if [[ -n "${ROOT_WORKTREE_PATH:-}" ]]; then
+            FE_MAIN_CONFIG_LOCAL="$(dirname "$ROOT_WORKTREE_PATH")/reservine/.claude/config.local"
+        fi
+        if [[ -f "$FE_MAIN_CONFIG_LOCAL" ]]; then
+            cp "$FE_MAIN_CONFIG_LOCAL" "$FE_WORKTREE/.claude/config.local"
+            # Append/override the isolated BE API URL
+            sed -i.bak \
+                -e "s|^MCP_LOCALBE_API_URL=.*|MCP_LOCALBE_API_URL=http://localhost:${ISO_APP_PORT}/api|" \
+                "$FE_WORKTREE/.claude/config.local"
+            # If the key didn't exist, append it
+            grep -q "^MCP_LOCALBE_API_URL=" "$FE_WORKTREE/.claude/config.local" || \
+                echo "MCP_LOCALBE_API_URL=http://localhost:${ISO_APP_PORT}/api" >> "$FE_WORKTREE/.claude/config.local"
+            rm -f "$FE_WORKTREE/.claude/config.local.bak"
+        else
+            # No main config.local found — create minimal one with just the API URL
+            cat > "$FE_WORKTREE/.claude/config.local" <<CONFIG_EOF
+# Generated by setup-worktree-be.sh --isolated
+# Add your MCP_DEV_EMAIL and MCP_DEV_PASSWORD here
+MCP_LOCALBE_BASE_URL=http://localhost:1112
+MCP_LOCALBE_API_URL=http://localhost:${ISO_APP_PORT}/api
+CONFIG_EOF
+            warn "No .claude/config.local found in FE main repo — created minimal config"
+            info "Add your MCP_DEV_EMAIL/PASSWORD to: $FE_WORKTREE/.claude/config.local"
+        fi
+        success "Generated FE config: $FE_WORKTREE/.claude/config.local"
+    else
+        warn "No FE worktree found — skipping proxy config generation"
+        info "To generate manually, create proxy.conf.json targeting http://localhost:${ISO_APP_PORT}"
+    fi
+
+    echo ""
+    echo "🎉  Isolated environment ready!"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+    echo "   BE API:     http://localhost:${ISO_APP_PORT}/api"
+    echo "   Adminer:    http://localhost:${ISO_ADMINER_PORT}"
+    echo "   DB Port:    ${ISO_DB_PORT}"
+    echo "   Redis Port: ${ISO_REDIS_PORT}"
+    echo ""
+    if [[ -n "$FE_WORKTREE" ]]; then
+        echo "   FE serve command:"
+        echo "   cd $FE_WORKTREE"
+        echo "   nx serve reservine --port 1112 --configuration=isolatedBE --proxy-config=proxy.conf.json"
+        echo ""
+    fi
+    echo "   Teardown:  ./setup-worktree-be.sh --teardown"
+    echo "   Re-seed:   ./setup-worktree-be.sh --reseed"
+    echo ""
+
+    SKIP_SAIL=true
+fi
+
+# ─── Final output ───────────────────────────────────────────────────────────────
+
+echo "✨  Worktree setup complete!"
+echo ""
+
+if [[ "$IS_CLOUD" == false ]] && [[ "$ISOLATED" == false ]]; then
+    echo "⚠️  IMPORTANT: Service Locality Warning"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo "These commands use SHARED local services (database, redis, meilisearch):"
+    echo "  • sail artisan / php artisan"
+    echo "  • sail test"
+    echo ""
+    echo "PHPStan can safely use main repo's vendor:"
+    echo "  vendor/bin/phpstan analyze <files>"
+    echo ""
+    echo "Services available at:"
+    echo "  Laravel: http://localhost:80"
+    echo "  Vite:    http://localhost:5173"
+    echo "  Adminer: http://localhost:8080"
+    echo ""
+fi
+
+print_state "vendor" "$BRANCH_NAME"