@reservine/dx 1.0.0

package/plugins/reservine-dx/docker/worktree/docker-compose.isolated.template.yaml

@@ -0,0 +1,144 @@
+# docker/worktree/docker-compose.isolated.template.yaml
+#
+# Template for isolated worktree Docker stacks.
+# Generated by: setup-worktree-be.sh --isolated
+# DO NOT EDIT the generated file — edit this template instead.
+#
+# All ports use deterministic offsets based on branch name hash.
+
+services:
+  db:
+    image: 'mariadb:latest'
+    container_name: '${COMPOSE_PROJECT_NAME}-db'
+    environment:
+      MYSQL_ROOT_PASSWORD: '${DB_PASSWORD}'
+      MYSQL_DATABASE: reservine
+      MYSQL_USER: reservine
+      MYSQL_PASSWORD: '${DB_PASSWORD}'
+    volumes:
+      - 'db_data:/var/lib/mysql'
+      - './docker/mysql/:/docker-entrypoint-initdb.d'
+      - './docker/mysql/conf.d/:/etc/mysql/conf.d'
+    ports:
+      - '${DB_PORT}:3306'
+    networks:
+      - sail
+    healthcheck:
+      test: ["CMD", "mariadb-admin", "ping", "-h", "localhost", "-ureservine", "-p${DB_PASSWORD}"]
+      interval: 5s
+      timeout: 5s
+      retries: 10
+      start_period: 10s
+
+  redis:
+    image: 'redis:latest'
+    container_name: '${COMPOSE_PROJECT_NAME}-redis'
+    ports:
+      - '${REDIS_PORT}:6379'
+    command: 'redis-server --save 10 1 --loglevel warning --requirepass ${REDIS_PASSWORD}'
+    environment:
+      - REDIS_PASSWORD=${REDIS_PASSWORD}
+    volumes:
+      - 'redis:/data'
+    networks:
+      - sail
+    healthcheck:
+      test: ["CMD", "redis-cli", "-a", "${REDIS_PASSWORD}", "ping"]
+      interval: 5s
+      timeout: 3s
+      retries: 5
+
+  adminer:
+    image: adminer
+    container_name: '${COMPOSE_PROJECT_NAME}-adminer'
+    environment:
+      ADMINER_DESIGN: nette
+      UPLOAD_LIMIT: 2G
+    networks:
+      - sail
+    depends_on:
+      - db
+    ports:
+      - '${ADMINER_PORT}:8080'
+
+  meilisearch:
+    image: 'getmeili/meilisearch:v1.5'
+    container_name: '${COMPOSE_PROJECT_NAME}-meili'
+    ports:
+      - '${MEILI_PORT}:7700'
+    environment:
+      MEILI_NO_ANALYTICS: 'true'
+      MEILI_MASTER_KEY: 'JCkBrarWPD_8Nj9KCRW32VJjigcZm6BPAttWg4g-OOw'
+    volumes:
+      - 'meili:/meili_data'
+    networks:
+      - sail
+    healthcheck:
+      test: ["CMD", "wget", "--no-verbose", "--spider", "--header=Authorization: Bearer JCkBrarWPD_8Nj9KCRW32VJjigcZm6BPAttWg4g-OOw", "http://127.0.0.1:7700/health"]
+      interval: 10s
+      retries: 5
+      timeout: 10s
+      start_period: 15s
+
+  soketi:
+    image: 'quay.io/soketi/soketi:latest-16-alpine'
+    container_name: '${COMPOSE_PROJECT_NAME}-soketi'
+    environment:
+      SOKETI_DEBUG: '1'
+      SOKETI_METRICS_SERVER_PORT: '9601'
+    ports:
+      - '${SOKETI_PORT}:6001'
+    networks:
+      - sail
+
+  laravel.test:
+    tty: true
+    init: true
+    container_name: '${COMPOSE_PROJECT_NAME}-app'
+    dns_opt:
+      - single-request-reopen
+    build:
+      context: ./docker/8.4
+      dockerfile: Dockerfile
+      args:
+        WWWGROUP: '1000'
+    image: sail-8.4/app
+    extra_hosts:
+      - 'host.docker.internal:host-gateway'
+    ports:
+      - '${APP_PORT}:80'
+    env_file:
+      - .env
+    environment:
+      WWWUSER: '1000'
+      LARAVEL_SAIL: 1
+      SUPERVISOR_PHP_COMMAND: "/usr/bin/php -d variables_order=EGPCS /var/www/html/artisan serve --host=0.0.0.0 --port=80"
+      DB_HOST: db
+      DB_PORT: 3306
+      DB_DATABASE: reservine
+      DB_USERNAME: reservine
+      DB_PASSWORD: '${DB_PASSWORD}'
+      REDIS_HOST: redis
+      REDIS_PASSWORD: '${REDIS_PASSWORD}'
+      REDIS_PORT: 6379
+    volumes:
+      - '.:/var/www/html'
+      - '/var/www/html/node_modules'
+    networks:
+      - sail
+    depends_on:
+      db:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+      meilisearch:
+        condition: service_healthy
+
+networks:
+  sail:
+    driver: bridge
+
+volumes:
+  db_data:
+  redis:
+  meili:

package/plugins/reservine-dx/docker/worktree/seed-snapshot.sh

@@ -0,0 +1,74 @@
+#!/usr/bin/env bash
+#
+# Seed a worktree's isolated DB from a snapshot file.
+# Called automatically by setup-worktree-be.sh --isolated on first run.
+#
+# Usage: ./seed-snapshot.sh <compose-file> <snapshot-path> [db-password] [project-name]
+#
+# Prerequisites:
+#   - Docker containers must be running
+#   - DB container must be healthy
+
+set -eo pipefail
+
+COMPOSE_FILE="${1:?Usage: seed-snapshot.sh <compose-file> <snapshot-path> [db-password] [project-name]}"
+SNAPSHOT="${2:?Usage: seed-snapshot.sh <compose-file> <snapshot-path> [db-password] [project-name]}"
+DB_PASS="${3:-reservine_wt_pass}"
+PROJECT_NAME="${4:-}"
+
+# Set compose project name if provided
+if [[ -n "$PROJECT_NAME" ]]; then
+    export COMPOSE_PROJECT_NAME="$PROJECT_NAME"
+fi
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+info() { echo -e "${BLUE}ℹ${NC} $1"; }
+success() { echo -e "${GREEN}✓${NC} $1"; }
+warn() { echo -e "${YELLOW}⚠️${NC} $1"; }
+
+if [[ ! -f "$SNAPSHOT" ]]; then
+    warn "Snapshot not found: $SNAPSHOT"
+    warn "Place your snapshot at: $(cd "$(dirname "$0")/../.." && pwd)/snapshots/reservine.sql.gz"
+    exit 0  # Non-fatal — worktree still usable, just empty DB
+fi
+
+DB_CONTAINER=$(docker compose -f "$COMPOSE_FILE" ps -q db)
+
+if [[ -z "$DB_CONTAINER" ]]; then
+    warn "DB container not found — skipping snapshot import"
+    exit 0
+fi
+
+# Check if DB already has data
+TABLE_COUNT=$(docker exec "$DB_CONTAINER" \
+    mariadb -ureservine -p${DB_PASS} reservine \
+    -sNe "SELECT COUNT(*) FROM information_schema.tables WHERE table_schema='reservine'" 2>/dev/null || echo "0")
+
+if [[ "$TABLE_COUNT" -gt 5 ]]; then
+    info "DB already has $TABLE_COUNT tables — skipping snapshot import"
+    info "To re-import, run: docker compose -f $COMPOSE_FILE down -v && re-run setup"
+    exit 0
+fi
+
+info "Importing snapshot ($SNAPSHOT)..."
+SECONDS=0
+
+if [[ "$SNAPSHOT" == *.gz ]]; then
+    gunzip -c "$SNAPSHOT" | docker exec -i "$DB_CONTAINER" \
+        mariadb -ureservine -p${DB_PASS} reservine
+else
+    docker exec -i "$DB_CONTAINER" \
+        mariadb -ureservine -p${DB_PASS} reservine < "$SNAPSHOT"
+fi
+
+success "Snapshot imported in ${SECONDS}s"
+
+# Run pending migrations
+info "Running pending migrations..."
+docker compose -f "$COMPOSE_FILE" exec -T laravel.test php artisan migrate --force 2>&1 | tail -5
+success "Migrations complete"

package/plugins/reservine-dx/scripts/_core.sh

@@ -0,0 +1,330 @@
+#!/usr/bin/env bash
+#
+# Shared core utilities for Reservine worktree setup scripts.
+#
+# This file is sourced by setup-worktree-fe.sh and setup-worktree-be.sh.
+# It provides: colors, logging, environment detection, ROOT_WORKTREE_PATH
+# resolution, plan file resolution, and branch setup.
+#
+# Do NOT execute this file directly.
+#
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Log file (set by --log flag or LOG_FILE env var)
+LOG_FILE="${LOG_FILE:-}"
+
+# Internal: write to log file if enabled
+_log() {
+    if [[ -n "$LOG_FILE" ]]; then
+        echo "[$(date '+%H:%M:%S')] $1" >> "$LOG_FILE"
+    fi
+}
+
+# Logging helpers
+info() { echo -e "${BLUE}ℹ${NC} $1"; _log "INFO  $1"; }
+success() {
+    echo -e "${GREEN}✓${NC} $1"
+    _log "OK    $1"
+    command -v sayy &>/dev/null && sayy 0.3 "$1" &>/dev/null &
+}
+warn() { echo -e "${YELLOW}⚠️${NC} $1"; _log "WARN  $1"; }
+error() { echo -e "${RED}❌${NC} $1" >&2; _log "ERROR $1"; }
+
+# Initialize log file (call from setup scripts after parsing --log)
+init_log() {
+    if [[ -n "$LOG_FILE" ]]; then
+        mkdir -p "$(dirname "$LOG_FILE")"
+        echo "# Reservine-DX setup log — $(date)" > "$LOG_FILE"
+        echo "# PWD: $(pwd)" >> "$LOG_FILE"
+        echo "# Args: $*" >> "$LOG_FILE"
+        echo "" >> "$LOG_FILE"
+        info "Logging to: $LOG_FILE"
+    fi
+}
+
+# Deterministic port offset from branch name (0-99)
+port_hash() {
+    local name="$1"
+    local hash=$(echo -n "$name" | cksum | awk '{print $1}')
+    echo $(( hash % 100 ))
+}
+
+# Check if a port is in use
+port_in_use() {
+    lsof -i ":$1" -P -n >/dev/null 2>&1
+}
+
+# Get the branch name sanitized for Docker
+get_branch_slug() {
+    local branch
+    branch=$(git branch --show-current 2>/dev/null || echo "unknown")
+    echo "$branch" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g' | sed 's/^-//;s/-$//'
+}
+
+# Sanitize branch name for use as directory name (strip # which breaks vite @fs URLs)
+sanitize_worktree_dir() {
+    echo "$1" | sed 's/#//g'
+}
+
+# Find the FE worktree sibling (used by Laravel for proxy config generation)
+find_fe_worktree() {
+    local branch_name
+    branch_name=$(git branch --show-current 2>/dev/null)
+    local safe_name
+    safe_name=$(sanitize_worktree_dir "$branch_name")
+
+    local fe_base
+    if [[ -n "${ROOT_WORKTREE_PATH:-}" ]]; then
+        fe_base="$(dirname "$ROOT_WORKTREE_PATH")/reservine"
+    else
+        fe_base="$(dirname "$(dirname "$PWD")")/reservine"
+    fi
+
+    # Try sanitized name first (no #), then exact branch name, then glob
+    for dir in \
+        "$fe_base/.worktrees/$safe_name" \
+        "$fe_base/.worktrees"/*/"$(basename "$safe_name")" \
+        "$fe_base/.worktrees/$branch_name" \
+        "$fe_base/.worktrees"/*/"$(basename "$branch_name")" \
+        "$fe_base/.worktrees"/*/*"${branch_name##*/}"*; do
+        if [[ -d "$dir" ]]; then
+            echo "$dir"
+            return 0
+        fi
+    done
+    return 1
+}
+
+# Find the BE worktree sibling (used by Angular for proxy config generation)
+find_be_worktree() {
+    local branch_name
+    branch_name=$(git branch --show-current 2>/dev/null)
+    local safe_name
+    safe_name=$(sanitize_worktree_dir "$branch_name")
+
+    local be_base
+    if [[ -n "${ROOT_WORKTREE_PATH:-}" ]]; then
+        be_base="$(dirname "$ROOT_WORKTREE_PATH")/ReservineBack"
+    else
+        be_base="$(dirname "$(dirname "$PWD")")/ReservineBack"
+    fi
+
+    for dir in \
+        "$be_base/.worktrees/$safe_name" \
+        "$be_base/.worktrees"/*/"$(basename "$safe_name")" \
+        "$be_base/.worktrees/$branch_name" \
+        "$be_base/.worktrees"/*/"$(basename "$branch_name")"; do
+        if [[ -d "$dir" ]]; then
+            echo "$dir"
+            return 0
+        fi
+    done
+    return 1
+}
+
+# ============================================================================
+# Resolve DX_SCRIPTS_DIR — directory containing these scripts
+# ============================================================================
+
+# If sourced from the marketplace install:
+#   ~/.claude/plugins/marketplaces/reservine-dx/plugins/reservine-dx/scripts/
+# If sourced from a local checkout:
+#   /path/to/Reservine-DX/plugins/reservine-dx/scripts/
+DX_SCRIPTS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+DX_PLUGIN_DIR="$(dirname "$DX_SCRIPTS_DIR")"
+
+# ============================================================================
+# Resolve ROOT_WORKTREE_PATH
+# ============================================================================
+
+resolve_root_worktree_path() {
+    if [[ -n "${ROOT_WORKTREE_PATH:-}" ]]; then
+        return 0
+    fi
+
+    # Try to auto-detect from git worktree list
+    DETECTED_ROOT=$(git worktree list 2>/dev/null \
+        | grep -v ".claude-worktrees" \
+        | grep -v ".cursor" \
+        | grep -v ".worktrees" \
+        | head -1 | awk '{print $1}')
+
+    if [[ -n "$DETECTED_ROOT" ]] && [[ -d "$DETECTED_ROOT" ]]; then
+        ROOT_WORKTREE_PATH="$DETECTED_ROOT"
+    fi
+}
+
+# ============================================================================
+# Detect environment (cloud / worktree / main repo)
+# ============================================================================
+
+detect_environment() {
+    IS_CLOUD=false
+    IS_WORKTREE=false
+
+    if echo "$PWD" | grep -q ".claude-worktrees"; then
+        IS_WORKTREE=true
+        info "Environment: Worktree (path contains .claude-worktrees)"
+    elif git worktree list 2>/dev/null | grep -q "^$(pwd) "; then
+        IS_WORKTREE=true
+        info "Environment: Worktree (git worktree list confirms)"
+    elif [[ "${CLAUDE_CODE_REMOTE_ENVIRONMENT_TYPE:-}" == "cloud_default" ]] || [[ -n "${CLAUDE_CODE_REMOTE:-}" ]]; then
+        IS_CLOUD=true
+        info "Environment: Cloud (CLAUDE_CODE_REMOTE or cloud_default detected)"
+    elif [[ -n "${CLAUDECODE:-}" ]] && [[ ! -d "$HOME" || -f "/.dockerenv" ]]; then
+        # CLAUDECODE set AND (no real home dir OR inside Docker container) = likely cloud
+        IS_CLOUD=true
+        info "Environment: Cloud (CLAUDECODE detected, non-local system)"
+    else
+        info "Environment: Main Repository"
+    fi
+}
+
+# ============================================================================
+# Plan file resolution
+# ============================================================================
+
+resolve_plan_file() {
+    local pattern="$1"
+    PLAN_FILE=$(find .claude/plans/ -name "*${pattern}*" -type f 2>/dev/null | head -1)
+
+    if [[ -z "$PLAN_FILE" ]]; then
+        error "No plan file matching '$pattern' found in .claude/plans/"
+        echo "   Available plans:" >&2
+        find .claude/plans/ -name "*.md" -type f 2>/dev/null | head -10 | sed 's/^/     /' >&2
+        exit 1
+    fi
+
+    BRANCH_NAME=$(basename "$PLAN_FILE" .md)
+    echo ""
+    echo "📋  Plan Resolution"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo "   Pattern: $pattern"
+    echo "   Found:   $PLAN_FILE"
+    echo "   Branch:  $BRANCH_NAME"
+    echo ""
+}
+
+# ============================================================================
+# Branch setup (creates or checks out branch)
+# ============================================================================
+
+setup_branch() {
+    local branch="$1"
+    local base="$2"
+
+    echo "📦  Branch Setup"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+    # Check if git is clean (ignore untracked files)
+    if [[ -n "$(git status --porcelain 2>/dev/null | grep -v '^??')" ]]; then
+        error "Working directory has uncommitted changes"
+        echo "   Please commit or stash changes before proceeding" >&2
+        exit 1
+    fi
+    success "Working directory is clean"
+
+    # Check if based on target branch (warning only)
+    if git rev-parse "$base" &>/dev/null; then
+        if git merge-base --is-ancestor "$(git rev-parse "$base")" HEAD 2>/dev/null; then
+            success "Current HEAD is based on $base"
+        else
+            warn "Not based on $base - consider rebasing before PR"
+        fi
+    else
+        warn "Base branch '$base' not found locally"
+    fi
+
+    # Check if branch already exists
+    if git show-ref --verify --quiet "refs/heads/$branch" 2>/dev/null; then
+        warn "Branch '$branch' already exists - checking out"
+        git checkout "$branch"
+    else
+        success "Creating branch: $branch"
+        git checkout -b "$branch"
+    fi
+    success "On branch: $(git branch --show-current)"
+    echo ""
+}
+
+# ============================================================================
+# Pre-flight: validate ROOT_WORKTREE_PATH (for non-cloud environments)
+# ============================================================================
+
+preflight_check() {
+    echo ""
+    echo "🚀  Setting up worktree..."
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+    detect_environment
+
+    if [[ "$IS_CLOUD" == false ]]; then
+        if [[ -z "${ROOT_WORKTREE_PATH:-}" ]]; then
+            error "ROOT_WORKTREE_PATH could not be auto-detected"
+            echo "   Set it manually:" >&2
+            echo "   ROOT_WORKTREE_PATH=~/projects/my-repo ./setup-worktree.sh" >&2
+            exit 1
+        fi
+
+        if [[ ! -d "${ROOT_WORKTREE_PATH}" ]]; then
+            error "ROOT_WORKTREE_PATH does not exist: ${ROOT_WORKTREE_PATH}"
+            exit 1
+        fi
+
+        # Safety: prevent running in the main repo root (would destroy node_modules/vendor)
+        RESOLVED_ROOT=$(cd "$ROOT_WORKTREE_PATH" && pwd -P)
+        RESOLVED_CWD=$(pwd -P)
+        if [[ "$RESOLVED_ROOT" == "$RESOLVED_CWD" ]]; then
+            error "You are running this from the main repo root, not a worktree"
+            echo "" >&2
+            echo "   This script is meant to run INSIDE a worktree, not in the main repo." >&2
+            echo "   Running here would destroy your node_modules/vendor directory." >&2
+            echo "" >&2
+            echo "   To create a worktree first:" >&2
+            echo "     git worktree add .worktrees/<branch> origin/<base> -b <branch>" >&2
+            echo "     cd .worktrees/<branch>" >&2
+            echo "     <then run this script>" >&2
+            echo "" >&2
+            echo "   Or use --branch to create one:" >&2
+            echo "     <this-script> --branch=feat/my-feature" >&2
+            exit 1
+        fi
+
+        if [[ -n "${DETECTED_ROOT:-}" ]]; then
+            info "Auto-detected main repo: ${ROOT_WORKTREE_PATH}"
+        else
+            echo "   Main repo: ${ROOT_WORKTREE_PATH}"
+        fi
+    fi
+    echo "   Worktree:  $(pwd)"
+    echo ""
+}
+
+# ============================================================================
+# Final state output
+# ============================================================================
+
+print_state() {
+    local dep_dir="$1"
+    local branch="$2"
+
+    if [[ -n "$branch" ]]; then
+        echo "📍  Current State:"
+        echo "   Branch:   $(git branch --show-current)"
+        echo "   Path:     $(pwd)"
+        if [[ -L "$dep_dir" ]]; then
+            echo "   ${dep_dir}:   symlinked → $(readlink "$dep_dir")"
+        else
+            echo "   ${dep_dir}:   installed locally"
+        fi
+    fi
+
+    # Final audio notification
+    command -v sayy &>/dev/null && sayy 0.5 "Worktree setup complete" &>/dev/null &
+}