Skip to content

docs: record the branch ruleset and close UPD-002 - #39

Merged
yorkerhodes3 merged 1 commit into
mainfrom
docs/upd-002-branch-protection
Aug 16, 2026
Merged

docs: record the branch ruleset and close UPD-002#39
yorkerhodes3 merged 1 commit into
mainfrom
docs/upd-002-branch-protection

Conversation

@yorkerhodes3

Copy link
Copy Markdown
Contributor

Records the ruleset now active on \main\ and marks UPD-002 done.

What is enforced

Rule Effect
\
equired_status_checks\ \Lint, typecheck, build, snapshot\ must pass before merge
\
on_fast_forward\ \main\ cannot be force-pushed
\deletion\ \main\ cannot be deleted

Repository admins are bypass actors deliberately. This repository is maintained by a very small group, and a required approval rule would leave a sole maintainer unable to merge their own work. The status check carries the value; the approval requirement is a governance decision for when the reviewer roles in CONTRIBUTING.md section 5 are actually staffed.

This PR is the test

It is the first pull request that must pass the required check before it can merge, so it verifies the whole chain end to end: workflow triggers, check name matches the ruleset context, and the merge is gated on it.

Documentation only - no \src/\ change, so no snapshot regeneration.

The ruleset "main: require CI and protect history" is now active on the default
branch: the Lint, typecheck, build, snapshot check is required, and main cannot
be force-pushed or deleted.

Repository admins are bypass actors on purpose. A required approval rule would
leave a sole maintainer unable to merge their own work, so the status check is
enforced and the approval requirement is left as a governance decision for when
the reviewer roles in CONTRIBUTING.md section 5 are actually staffed.

This pull request is also the end-to-end test of the gate: it is the first one
that has to pass the required check before it can merge.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@yorkerhodes3
yorkerhodes3 merged commit 70b3348 into main Aug 16, 2026
1 check passed
@yorkerhodes3
yorkerhodes3 deleted the docs/upd-002-branch-protection branch August 16, 2026 02:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants