pr-preflight

# PR Preflight One-command merge-readiness check that combines local gates, CI status, and PR policy checks. Mirrors what reviewers look for so issues are caught before review, not during. ## Check an existing PR ```bash scripts/check_pr.sh <pr_number> ``` This runs: 1. **PR metadata** — fetches title, state, draft status, merge state, branch info 2. **CI checks** — counts pass/fail/pending GitHub Actions checks 3. **Local gates** — runs lint, format, and tests locally: - `uv run ruff check .` - `uv run ruff format --check .` - `uv run pytest tests/ -x --timeout=60` 4. **PR body policy** — validates required sections, evidence links, and blocked artifacts 5. **Verdict** — `READY` or `NOT_READY` with specific reasons ### Options | Flag | Purpose | |------|---------| | `--repo OWNER/REPO` | Override repository (default: auto-detect via `gh`) | | `--no-tests` | Skip local test gates (useful when you just want CI + metadata check) | ### Exit codes | Code | Meaning | |------|---------| | 0 | All checks passed — ready to merge | | 1 | Script error (missing tool, network failure) | | 2 | Not ready — at least one check failed | ## Run local gates only (no PR needed) If you haven't opened a PR yet and just want to validate locally: ```bash uv run ruff check . && uv run ruff format --check . && uv run pytest tests/ -x --timeout=60 ``` Or use the pre-commit hook (auto-runs lint on commit): ```bash git config core.hooksPath .githooks ``` ## What blocks merge The s...