Operations
Troubleshooting common failures
| Symptom | Check | Next action |
|---|---|---|
| Cannot reach admin pages | Session and OAuth login state | Open `/login`, sign in again, then retry `/admin`. |
| Repository missing from admin list | Provider permission cache and installation scope | Refresh permissions or resync the installation. Confirm the provider user has write, maintain, or admin access. |
| Repository cannot be enabled | Subscription entitlement and provider edit access | Subscribe, free paid repository capacity, or ask the teammate payer to manage the subscription. |
| Policy blocks unexpectedly | Evaluation detail page rule results | Open `/admin/evaluations`, inspect the specific rule message and remediation, then update the PR or `.mergepreflight.yml`. |
| Integration-backed rule cannot check state | Integration health and connection settings | Open `/admin/integrations`, reconnect the provider account or fix non-secret connection settings, then rerun the provider event or update the pull request. |
| Provider status or comment is stale | Webhook delivery, background job, and latest evaluation | Confirm webhook URLs are configured, trigger a pull request update, and check `/admin/evaluations` for the latest result. |
| Billing status is unknown | Provider sync status | Reconnect provider configuration or wait for a successful sync before enabling new repositories. |