teqo-backup/docs/CUTOVER-MAIN-ONLY.md
Francisco Ignácio Fontoura Solla b7bb6f1479 style: prettier CUTOVER-MAIN-ONLY.md
2026-07-31 23:06:40 -03:00

20 lines
1.3 KiB
Markdown

# Cutover checklist (main-only + gated deploy) — human, once
Status after agent delivery (2026-07-31):
- [x] Code PR opened (main-only cutover) — see PR targeting `main`
- [x] `pnpm configure:branch-protection` applied on `main` (required: `checks` + `migration-lock`, `strict=false`, 0 reviews)
- [x] No open PRs targeting `stage` at cutover time
- [x] Repo secrets present (`VERCEL_*`, `POOL_GITHUB_TOKEN`)
- [x] `VERCEL_ORG_ID` / `VERCEL_PROJECT_ID` synced from local `.vercel/project.json` (`vercel link`)
- [ ] Confirm `ci.yml` deploy job green after token+IDs are correct
- Misleading CLI error _"Could not retrieve Project Settings"_ usually means **403** (bad/expired `VERCEL_TOKEN` or wrong IDs) — regenerate token at vercel.com/account/tokens if deploy still fails
After the cutover PR merges to `main`:
1. Validate Vercel Git skip: push to `main` must **not** start a Vercel Git build (`ignoreCommand` exit 0). Production comes only from `ci.yml` → deploy.
2. Confirm `ci.yml` runs full suite; deploy job runs or fails closed with a clear missing-secrets message until `VERCEL_*` are set.
3. `POOL_GITHUB_TOKEN=… pnpm agent:pool -- doctor` must read repo variables.
4. Optionally delete branch `stage` and its Environment/secrets when idle.
See [AGENT-OPS.md](AGENT-OPS.md).