28 Maintainer Runbook

28. Maintainer Governance & Repository Operations

Operational runbook for repository maintainers, code owners, PR review SLAs, and automation tooling.

---

🛡️ Maintainer Responsibilities & PR Review SLA

1. 24-Hour PR Review Target: Respond to incoming community Pull Requests within 24 hours.
2. Quality Gate Verification: Confirm that all 8 CI quality gates (tsc, eslint, 56 test suites, link audit, secret scan, Next.js build, issue audit, protected migrations diff) pass before merging.
3. Protected Boundary Enforcement: Reject any PR that modifies frozen database migrations (supabase/migrations/*) or alters RLS policies without prior approval.

---

🛠️ Maintainer Tooling Cheatsheet

1. Issue Factory Provisioning (scratch/create-beginner-issues.mjs)

• Dry-Run Audit:

  node scratch/create-beginner-issues.mjs --dry-run

• Live Provisioning:

  GITHUB_TOKEN=<token> node scratch/create-beginner-issues.mjs

2. Issue Target Verification (scratch/check-issues-audit.mjs)

Verifies that all 20 canonical beginner issue target files exist and contain expected target markers:

node scratch/check-issues-audit.mjs

3. Release Readiness Audit (scratch/release-check.mjs)

Runs the full 7-step release readiness verification suite:

npm run release:check