run-services

# Run Services Start all local development services with pre-flight dependency checks and automatic error recovery. ## Overview This command automates the full startup workflow: 0. Smart port selection — auto-detects free port group or reuses current worktree's ports 1. Pre-flight dependency checks (uv sync, venv, npm, worktree editable packages) 2. Stops any existing services (only if needed) 3. Starts all services via `run_services.sh` 4. Health-checks each service 5. Diagnoses and fixes failures, then retries (up to 2 retries) ## Port Configuration Ports are allocated in groups of 3 with a +10 offset between groups: | Group | Frontend | Backend | Docs | |-------|----------|---------|------| | Default | 8080 | 8081 | 8082 | | +10 | 8090 | 8091 | 8092 | | +20 | 8100 | 8101 | 8102 | | +30 | 8110 | 8111 | 8112 | | +40 | 8120 | 8121 | 8122 | | Service | Env Var | Base Port | |---------|---------|-----------| | Frontend (Next.js) | `FRONTEND_PORT` | 8080 | | Backend (FastAPI) | `BACKEND_PORT` | 8081 | | Docs (Fumadocs) | `DOCS_PORT` | 8082 | Step 0 (Smart Port Selection) determines which group to use automatically, unless ports are already set via environment variables. ## Execution Steps ### Step 0: Smart Port Selection **Pre-check:** If `BACKEND_PORT`, `FRONTEND_PORT`, or `DOCS_PORT` are already set in the environment, skip auto-detection entirely and use those values directly. Report "Using pre-configured ports" and proceed to Step 1. **0.1** Get current worktree r...