steerspec/PR Auto-Approve (Copilot)

Automatically approves pull requests when GitHub Copilot's review is clean or after a configurable number of review rounds.

Trust Signals

name	description	required	default
bot-login	GitHub login of the bot account that will post the APPROVE review. The bot-github-token must be a PAT for this account.	yes	—
bot-github-token	PAT for bot-login with repo scope (posts the approval review).	yes	—
base-branch	Base branch that PRs must target to be eligible for auto-approval (default: main).	no	main
sandbox-repos	Comma-separated list of repo full names (owner/repo) where bot-authored PRs are allowed through the self-approval guard. Used only by e2e test harnesses in sandbox/test repositories. Production repos must not appear here.	no	""
rounds-threshold	Number of Copilot review rounds after which the PR is approved regardless of inline comments (default: 3).	no	3
allow-no-checks	When true, skip the "all checks must pass" gate when no external check runs exist for the head SHA (e.g., docs-only PRs that trigger no CI). Defaults to false (safe default: require at least one passing check).	no	false
test-copilot-logins	Test-only: comma-separated GitHub logins to treat as "Copilot" reviewers in addition to the real Copilot bot. Used by the e2e harness in sandbox repos listed in sandbox-repos; production callers MUST NOT set this.	no	""
slack-channel	Slack channel name or ID for notifications (default: alert-pr-notifications). Used only when slack-bot-token is set.	no	alert-pr-notifications
slack-bot-token	Slack bot OAuth token (xoxb-...) with chat:write scope. When set, posts approve/skip/error notifications via chat.postMessage.	no	""

name	description
decision	Outcome of the evaluation: approved, skip, or error.
reason	Human-readable explanation of the decision.