justfile

# Aris Development Task Runner
# Set environment variables from .env
set dotenv-load

# Default recipe - show help
default:
    @just --list

# Development Commands
# ====================

# Start development containers (uses current directory name as project)
dev *args="":
    ./scripts/start-dev.sh {{args}}

# Run database migrations (both PROD and LOCAL)
migrate:
    cd backend && export ENV=PROD && alembic upgrade head && export ENV=LOCAL && alembic upgrade head

# Stop development containers
stop:
    @echo "Stopping containers for $(basename $(pwd))..."
    docker compose --env-file .env -p $(basename $(pwd)) -f docker/docker-compose.dev.yml down
    @echo "Cleaning up any orphaned containers on dev ports..."
    @docker ps --filter "publish=8001" --format "{{{{.ID}}" | xargs -r docker stop 2>/dev/null || true
    @docker ps --filter "publish=${BACKEND_PORT}" --format "{{{{.ID}}" | xargs -r docker stop 2>/dev/null || true
    @docker ps --filter "publish=${FRONTEND_PORT}" --format "{{{{.ID}}" | xargs -r docker stop 2>/dev/null || true
    @docker ps --filter "publish=${SITE_PORT}" --format "{{{{.ID}}" | xargs -r docker stop 2>/dev/null || true
    @docker ps --filter "publish=${STORYBOOK_PORT}" --format "{{{{.ID}}" | xargs -r docker stop 2>/dev/null || true
    @docker ps --filter "publish=${MULTIPLAYER_PORT}" --format "{{{{.ID}}" | xargs -r docker stop 2>/dev/null || true
    @docker ps --filter "publish=${DB_PORT}" --format "{{{{.ID}}" | xargs -r docker stop 2>/dev/null || true
    @echo "All containers stopped"

# View logs for development containers
logs:
    docker compose -p $(basename $(pwd)) -f docker/docker-compose.dev.yml logs

# Testing Commands
# ================

# Run all tests locally (Docker is for dev server only, not tests)
# Backend tests run on macOS with macOS binaries (no binary conflicts)
# CI runs tests on Linux separately
test:
    cd backend && uv run pytest -n8 -m "not slow"
    cd cli && uv run pytest -v
    cd site && npm run test:all
    cd frontend && npm run test:run

# Run Y.js collaboration E2E tests (requires 'just dev' running)
# Tests spawn multiple browsers and must run sequentially (--workers=1)
# Usage: just test-collab [browser] [reporter] (defaults: all browsers, line reporter)
test-collab browser="" reporter="line":
    #!/usr/bin/env bash
    cd frontend
    if [ -n "{{browser}}" ]; then
        npx playwright test --grep "@collab" --project={{browser}} --reporter={{reporter}} --workers=1
    else
        npx playwright test --grep "@collab" --reporter={{reporter}} --workers=1
    fi

# Run E2E content tests (files, versions, rendering)
test-e2e-content:
    cd frontend && npx playwright test src/tests/e2e/content/ --grep "@auth" --reporter=line

# Run E2E interface tests (account, navigation, settings)
test-e2e-interface:
    cd frontend && npx playwright test src/tests/e2e/interface/ --grep "@auth" --reporter=line

# Run all E2E auth tests (content + interface)
test-e2e:
    just test-e2e-content
    just test-e2e-interface

# Run all linters
lint:
    cd backend && uv run ruff check --fix
    cd backend && uv run mypy aris/
    cd cli && uv run ruff check --fix
    cd cli && uv run mypy .
    cd site && npm run lint
    cd frontend && npm run lint

# Run lint then test
check:
    just lint
    just test

# Development Setup
# =================

# Initial setup for new development environment
init:
    @echo "Setting up development environment..."
    @if [ ! -f .env ]; then echo "Copying .env.example to .env"; cp .env.example .env; echo "Please edit .env with your desired configuration"; else echo ".env already exists"; fi
    @if [ ! -f frontend/.env ]; then echo "Copying frontend/.env.example to frontend/.env"; cp frontend/.env.example frontend/.env; else echo "frontend/.env already exists"; fi
    @if [ ! -f site/.env ]; then echo "Copying site/.env.example to site/.env"; cp site/.env.example site/.env; else echo "site/.env already exists"; fi
    @if [ ! -f docker/backend/.env ]; then echo "Copying docker/backend/.env.example to docker/backend/.env"; cp docker/backend/.env.example docker/backend/.env; else echo "docker/backend/.env already exists"; fi
    cd backend && uv sync --all-groups
    cd backend && if [ -d "../../rsm" ]; then uv pip install -e ../../rsm; echo "Installed local RSM package"; else echo "No local RSM found, using PyPI version"; fi
    cd frontend && npm install
    cd site && npm install
    cd cli && uv sync
    @echo "Setup complete! Edit .env files if needed, then run 'just dev' to start"

# Deployment Commands
# ===================

# Deploy all services (backend to Fly.io, frontend/site via git push)
deploy:
    @echo "🚀 Deploying all services..."
    @echo ""
    just deploy-backend
    @echo ""
    just deploy-netlify
    @echo ""
    @echo "✅ Deployment complete!"

# Deploy only backend to Fly.io
deploy-backend:
    @echo "🚀 Deploying backend to Fly.io..."
    cd .. && fly deploy --config studio/backend/fly.toml --dockerfile studio/backend/Dockerfile
    @echo "✅ Backend deployed: https://aris-backend.fly.dev"

# Push to GitHub to trigger Netlify deployments
deploy-netlify:
    @echo "🚀 Pushing to GitHub to trigger Netlify deployments..."
    git push origin main
    @echo "✅ Pushed to GitHub"
    @echo "   - Frontend: https://app.rsm.studio"
    @echo "   - Site: https://rsm.studio"
    @echo "⏳ Netlify builds typically take 2-3 minutes"

# Utility Commands
# ================

# Check container status
status:
    docker compose -p $(basename $(pwd)) ps

# Show environment configuration
env:
    @echo "Current environment configuration:"
    @if [ -f .env ]; then cat .env; else echo "No .env file found"; fi

# Rebuild frontend-test with fresh environment variables
# Use this when environment variables change and aren't propagating
rebuild-frontend-test:
    @echo "🔄 Rebuilding frontend-test with fresh environment..."
    @echo "1. Stopping and removing container + volumes..."
    docker compose -p $(basename $(pwd)) -f docker/docker-compose.dev.yml down frontend-test -v
    @echo "2. Rebuilding image..."
    docker compose -p $(basename $(pwd)) -f docker/docker-compose.dev.yml build frontend-test
    @echo "3. Starting fresh container..."
    docker compose -p $(basename $(pwd)) -f docker/docker-compose.dev.yml up -d frontend-test
    @echo "4. Waiting for container to be ready..."
    sleep 3
    @echo "✅ Rebuild complete!"
    @echo ""
    @echo "⚠️  IMPORTANT: Hard refresh your browser (Cmd+Shift+R or Ctrl+Shift+R)"
    @echo "    Or open DevTools > Network tab > Check 'Disable cache' > Refresh"
    @echo ""
    @echo "🔍 Verify the new environment variable:"
    @echo "    docker exec docker-frontend-test-1 printenv | grep VITE"
    @osascript -e "display notification \"Frontend-test rebuilt. Hard refresh your browser!\" with title \"Claude Code\""