docs: record cutover checklist progress

This commit is contained in:
Francisco Ignácio Fontoura Solla 2026-07-31 20:57:50 -03:00
parent f021992de0
commit 2abcaeaaa5

View file

@ -1,23 +1,19 @@
# Cutover checklist (main-only + gated deploy) — human, once # Cutover checklist (main-only + gated deploy) — human, once
#
# After merging the CI cutover PR to main: Status after agent delivery (2026-07-31):
#
# 1. Repo secrets (Settings → Secrets and variables → Actions): - [x] Code PR opened (main-only cutover) — see PR targeting `main`
# - VERCEL_TOKEN, VERCEL_ORG_ID, VERCEL_PROJECT_ID - [x] `pnpm configure:branch-protection` applied on `main` (required: `checks` + `migration-lock`, `strict=false`, 0 reviews)
# - POOL_GITHUB_TOKEN (PAT: actions:write, issues:write, contents:read) - [x] No open PRs targeting `stage` at cutover time
# - [ ] Repo secrets still needed:
# 2. Branch protection: - `VERCEL_TOKEN`, `VERCEL_ORG_ID`, `VERCEL_PROJECT_ID` (deploy job fail-closed until set)
# pnpm configure:branch-protection - `POOL_GITHUB_TOKEN` (PAT: `actions:write` + `issues:write` + `contents:read`) — `PROMOTE_GITHUB_TOKEN` already exists; reuse/rename if scopes cover Actions variables, else mint a new PAT
# (main: required checks `checks` + `migration-lock`, strict=false, 0 reviews)
# Optionally remove protection from `stage` and delete the branch when idle. After the cutover PR merges to `main`:
#
# 3. Open PRs still targeting `stage`: 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.
# gh pr list --base stage 2. Confirm `ci.yml` runs full suite; deploy job runs or fails closed with a clear missing-secrets message until `VERCEL_*` are set.
# Retarget each to main (`gh pr edit <N> --base main`) or merge/close first. 3. `POOL_GITHUB_TOKEN=… pnpm agent:pool -- doctor` must read repo variables.
# 4. Optionally delete branch `stage` and its Environment/secrets when idle.
# 4. Validate:
# - Push/no-op on main → Vercel Git build SKIPPED (ignoreCommand exit 0) See [AGENT-OPS.md](AGENT-OPS.md).
# - ci.yml runs full suite; deploy job runs (or fail-closed if Vercel secrets missing)
# - agent-pool doctor: `POOL_GITHUB_TOKEN=… pnpm agent:pool -- doctor` reads variables
#
# See docs/AGENT-OPS.md.