Skip to content

feat: branch protection audit checkpoints (enforce_admins + conversation resolution)#49

Merged
CybotTM merged 4 commits intomainfrom
feat/branch-protection-audit-checkpoint
Mar 30, 2026
Merged

feat: branch protection audit checkpoints (enforce_admins + conversation resolution)#49
CybotTM merged 4 commits intomainfrom
feat/branch-protection-audit-checkpoint

Conversation

@CybotTM
Copy link
Copy Markdown
Member

@CybotTM CybotTM commented Mar 30, 2026

Summary

Why

Without enforce_admins: true, repository admins can bypass all branch protection rules -- required status checks, required reviews, and required conversation resolution. This means unresolved review threads can be bypassed by admins even when required_conversation_resolution is enabled. Both settings must be enabled together for effective protection.

Test plan

  • Run verify-github-project.sh against a repo with branch protection to confirm the new checks execute
  • Verify refactor: trim SKILL.md for token efficiency #30 checkpoint: gh api repos/{owner}/{repo}/branches/{branch}/protection --jq '.enforce_admins.enabled' returns true
  • Verify feat: add skill validation CI job #31 checkpoint: gh api repos/{owner}/{repo}/branches/{branch}/protection --jq '.required_conversation_resolution.enabled' returns true
  • Test against a repo without branch protection to confirm graceful degradation

…conversation resolution

Add mechanical checkpoints (GH-30, GH-31) that verify enforce_admins
and required_conversation_resolution via GitHub API, plus an LLM review
checkpoint (GH-32) for the combined audit. Without enforce_admins, admins
can bypass all branch protection rules including unresolved review threads.

Updates verify script to check these settings and security-config.md
reference to document the enforce_admins requirement.
Copilot AI review requested due to automatic review settings March 30, 2026 13:38
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the GitHub project skill to version 2.11.0, introducing new audits and documentation for branch protection enforcement. It adds mechanical and LLM-based checks to ensure that both 'enforce_admins' and 'required_conversation_resolution' are enabled on the default branch, ensuring that administrators cannot bypass review requirements. Additionally, the verification script has been enhanced to automate these security checks using the GitHub API. I have no feedback to provide as there were no review comments to evaluate.

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds branch-protection enforcement auditing to the github-project skill to ensure admins cannot bypass review/thread-resolution requirements, and documents the rationale and configuration steps.

Changes:

  • Extend verify-github-project.sh to query GitHub’s branch protection API and report on enforce_admins and required_conversation_resolution.
  • Add new mechanical checkpoints (GH-30, GH-31) and an LLM audit checkpoint (GH-32) for branch protection enforcement.
  • Update security documentation and bump skill version.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File Description
skills/github-project/scripts/verify-github-project.sh Adds gh api-based checks for enforce_admins and required_conversation_resolution on the default branch.
skills/github-project/references/security-config.md Documents enforce_admins requirement and clarifies interaction with required conversation resolution.
skills/github-project/checkpoints.yaml Introduces GH-30/GH-31 mechanical checks and GH-32 LLM audit prompt for combined enforcement.
skills/github-project/SKILL.md Version bump to 2.11.0.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

CybotTM added 3 commits March 30, 2026 15:49
…ecks

GH-30/GH-31 checkpoint commands and the verify script now guard for
gh CLI availability and valid REPO_SLUG before running. When classic
branch protection is not configured, they fall back to querying
GitHub rulesets for equivalent enforcement settings.
@CybotTM CybotTM merged commit be7c20d into main Mar 30, 2026
5 checks passed
@CybotTM CybotTM deleted the feat/branch-protection-audit-checkpoint branch March 30, 2026 14:07
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