Gap
Four `apps/api/scripts/*` operator-facing scripts exist with no doc entry in `docs/operations/` or the relevant spec:
| Script |
What it does |
Where it should be documented |
| `cutover-dry-run.ts` |
Walks the full cutover pipeline against a non-prod target — used during T-3 staging rehearsal |
`docs/operations/cutover.md` (T-3 section) |
| `cutover-mailout.ts` |
Sends T+90 unclaimed-account reminder emails |
`docs/operations/cutover.md` (T+90 section) or `specs/behaviors/account-migration.md` |
| `reconcile.ts` |
Walks Person records and flags private-store orphans (used at cutover + ongoing) |
`docs/operations/runbook.md` (maintenance) — referenced once in `specs/behaviors/private-storage.md:99` but no operator instructions |
| `setup-dev-data.ts` |
Seeds gitsheets with minimal sheet configs for local boot |
`specs/architecture.md` Build/dev section + `CLAUDE.md` local setup |
Why it matters
Pre-cutover, the staging rehearsal (#54) needs operators to know these exist + how to invoke them. Local-setup contributors hit `setup-dev-data.ts` on first run and may not know what they're running.
Identified during the 2026-05-30 post-cutover-blog spec-drift audit.
Gap
Four `apps/api/scripts/*` operator-facing scripts exist with no doc entry in `docs/operations/` or the relevant spec:
Why it matters
Pre-cutover, the staging rehearsal (#54) needs operators to know these exist + how to invoke them. Local-setup contributors hit `setup-dev-data.ts` on first run and may not know what they're running.
Identified during the 2026-05-30 post-cutover-blog spec-drift audit.