yunxiafei/openclaw-mission-control
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

ci(policy): enforce one migration per PR

Browse Source
This commit is contained in:
Abhimanyu Saharan
2026-02-14 19:09:09 +00:00
parent 313ce874f9
commit 1cad57f6b5
3 changed files with 79 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
docs/policy/one-migration-per-pr.md Normal file
View File

@@ -0,0 +1,23 @@
# Policy: one DB migration per PR
## Rule
If a pull request adds migration files under:
- `backend/migrations/versions/*.py`
…then it must add **no more than one** migration file.
## Why
- Makes review and rollback simpler.
- Reduces surprise Alembic multiple-head situations.
- Keeps CI/installer failures easier to debug.
## Common exceptions / guidance
- If you have multiple Alembic heads, prefer creating **one** merge migration.
- If changes are unrelated, split into multiple PRs.
## CI enforcement
CI runs `scripts/ci/one_migration_per_pr.sh` on PRs and fails if >1 migration file is added.
## Notes
This policy does not replace the existing migration integrity gate (`make backend-migration-check`). It is a lightweight guardrail to prevent multi-migration PRs.