Skip to content

docs(review): Greptile is not a merge requirement — trial credits are exhausted - #43

Merged
qmarcelle merged 3 commits into
mainfrom
docs/greptile-not-a-merge-requirement
Aug 17, 2026
Merged

docs(review): Greptile is not a merge requirement — trial credits are exhausted#43
qmarcelle merged 3 commits into
mainfrom
docs/greptile-not-a-merge-requirement

Conversation

@qmarcelle

@qmarcelle qmarcelle commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

.github/REVIEW-MERGE-PROTOCOL.md still named Greptile the required automated status gate and instructed agents not to merge while its review was pending. That requirement cannot be satisfied, so as written it blocks every merge indefinitely.

The cause was also recorded wrong

The document said the Greptile app "is likely not installed on this repository. This is absence, not a failed review."

The app is installed on the organization and does respond. It posts:

qmarcelle has reached the 50-credit limit for trial accounts.

…and emits zero check runs. Observed on PR #37 (2026-08-13) and again on PR #42, which carries the notice twice.

The distinction matters. An uninstalled app is a setup gap you can close. An exhausted quota is a reviewer that answers and says nothing — and a quota notice must never be dispositioned as a pass.

Three claims corrected against measured state

Claim Measured
Greptile — "Planned (not yet required)" Withdrawn 2026-08-13. Branch protection requires exactly test (20), test (22), Four-path producer conformance
"Require code owner review — currently required" Disabled. require_code_owner_reviews: false
Remediation: add Greptile as required, then disable code-owner approval Both already executed. The outcome is that no reviewer requirement remains at all

Each verified against the API rather than assumed.

This was a document disagreeing with its sibling

docs/repository-settings.md already recorded all of it accurately on 2026-08-13 — the credit limit, the withdrawal, the zero check runs on PR #37, and the resulting "no reviewer requirement of any kind." The protocol document had drifted away from it. Two files in one repository disagreeing about whether a merge gate exists is the actual defect; this makes the protocol defer to the settings document, which stays authoritative.

What replaces the gate

Nothing is being invented to fill the hole. The document now states the real position: current-head required CI, conversation resolution, normative governance tests, and the release-boundary gates carry merge authorization; Sourcery and the other reviewers are defense-in-depth.

Sourcery does emit a Sourcery review check run bound to the current head — the mechanical half of the re-admission bar that repository-settings.md sets. Promoting it is deliberately not done here: that needs its own calibration evidence on the same terms Greptile was held to, and workspacejson/cli's REVIEW.md already rules the same way.

Kept

The .greptile/ rules stay. They are correct, they cost nothing while dormant, and credits are the only thing between them and running again.

Not changed

workspacejson/cli needs no equivalent fix — its REVIEW.md already records Greptile Review as not required "by measured decision."

Summary by Sourcery

Update the review and merge protocol to reflect the measured repository state and remove Greptile as an effective merge requirement.

Bug Fixes:

  • Correct the review protocol to reflect that Greptile is installed but unavailable because its trial credits are exhausted, preventing it from producing reviews or check runs.
  • Remove obsolete merge-blocking instructions and accurately document the current branch protection and reviewer requirements.

Enhancements:

  • Align the merge protocol with the authoritative repository settings and clarify that CI, conversation resolution, governance tests, and release-boundary gates authorize merges while automated reviewers remain defense-in-depth.
  • Update reviewer-handling guidance so findings are reconciled when available without treating reviewer output or quota notices as merge authorization.

Documentation:

  • Document Greptile's withdrawn status, the exhausted-credit state, and the conditions required for possible future re-admission.
  • Record the actual governance model, disabled code-owner enforcement, and verified branch-protection contexts.

… exhausted

The protocol document still named Greptile the required automated status gate
and told agents not to merge while its review was pending. That requirement
cannot be satisfied and would block every merge indefinitely.

It also recorded the wrong cause. It said the app was 'likely not installed';
the app IS installed and does respond, with a 50-credit trial-limit notice and
zero check runs. Observed on PR #37 on 2026-08-13, and again on PR #42, which
carries the notice twice. An uninstalled app is a setup gap; an exhausted quota
is a reviewer that answers and says nothing. A quota notice is never a pass.

Three claims corrected against measured state:

  * Greptile as required status check -> withdrawn 2026-08-13, verified against
    branch protection, which requires exactly test (20), test (22) and
    Four-path producer conformance
  * 'Require code owner review: currently required' -> disabled;
    require_code_owner_reviews is false
  * the Greptile-premised remediation sequence -> both of its first two steps
    have already executed, and the outcome is that no reviewer requirement
    remains at all

docs/repository-settings.md already recorded all of this accurately on
2026-08-13. This document had drifted away from its own sibling, which is the
defect: two files in one repository disagreeing about whether a merge gate
exists.

The .greptile/ rules are kept. They are correct and cost nothing while dormant,
and credits are the only thing standing between them and running again.
Copilot AI lite review requested due to automatic review settings August 17, 2026 22:15

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@greptile-apps greptile-apps Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

qmarcelle has reached the 50-credit limit for trial accounts. To continue receiving code reviews, upgrade your plan.

@sourcery-ai

sourcery-ai Bot commented Aug 17, 2026

Copy link
Copy Markdown

Reviewer's Guide

Updates the review/merge protocol documentation so that Greptile is correctly described as non-required, reconciles it with the authoritative repository-settings doc, and clarifies the actual governance and agent merge rules now that the Greptile gate has been withdrawn due to exhausted trial credits.

File-Level Changes

Change Details Files
Clarify Greptile’s actual role, state, and promotion path now that its trial credits are exhausted and its status check has been withdrawn.
  • Change Greptile’s role from a planned hard gate to explicitly "no merge requirement" and defense-in-depth only.
  • Replace the previous "app likely not installed" explanation with a measured description of exhausted trial credits, quota notices, and zero check runs.
  • Document that Greptile Review was briefly required and then removed on 2026-08-13, and that re-admission requires paid credits plus fresh calibration evidence.
  • Point reviewers to docs/repository-settings.md as authoritative for settings and the re-admission bar.
.github/REVIEW-MERGE-PROTOCOL.md
Align the listed required status checks and branch protection settings with the actual GitHub configuration, removing references to planned/incorrect gates.
  • Update the branch protection table to show only test (20), test (22), and Four-path producer conformance as required contexts, with Greptile marked as withdrawn.
  • Clarify that Sourcery is not a required gate and that promotion needs separate calibration evidence.
  • Explicitly state that require_code_owner_reviews is disabled and was turned off after Greptile was withdrawn.
  • Add a note that the required contexts were verified via the branch protection API rather than assumed.
.github/REVIEW-MERGE-PROTOCOL.md
Reframe the remediation and governance model sections to reflect the executed history and the current state of having no reviewer requirement, while defining how reviewer findings should be handled.
  • Replace the previous forward-looking remediation plan with a historical account of the steps already taken and their unintended outcome (no reviewer requirement).
  • Define the actual governance model for a sole-steward repository without a funded automated reviewer: merge authorization comes from required CI, conversation resolution, governance tests, and release-boundary gates.
  • Clarify the handling of reviewer findings when any reviewer does run, separating substantive vs advisory and emphasizing that reviewer output is discipline, not a merge gate.
  • Note that Sourcery emits a current-head check run but is intentionally not promoted to a required gate here.
.github/REVIEW-MERGE-PROTOCOL.md
Update the agent merge protocol and external configuration notes so agents do not wait on Greptile and understand the effect of exhausted credits.
  • Remove the "do not merge while Greptile review is pending" step and replace it with explicit guidance not to wait on Greptile because it cannot complete and emits no check run.
  • Require agents to read and reconcile whatever reviewer output exists (Sourcery, Copilot, etc.) while reiterating that none of these authorize the merge.
  • Clarify that a green test suite alone is not merge authorization; the steward’s judgment against the defined gates is.
  • Document that the Greptile organization connection is present but trial credits are exhausted, and that plan/credits are the only thing that would make the .greptile/ rules run again.
.github/REVIEW-MERGE-PROTOCOL.md

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Hey - I've left some high level feedback:

  • The Greptile section now mixes current-state guidance with a detailed historical narrative; consider trimming the historical timeline into a short “history” note or moving it elsewhere so the merge protocol stays easy to scan for agents.
  • There are multiple “authoritative” references to docs/repository-settings.md; to avoid future drift, you might explicitly state at the top of this document that it defers to repository-settings.md for all settings and only describes agent behavior, reducing repeated cross-check details in individual sections.
Prompt for AI Agents
Please address the comments from this code review:

## Overall Comments
- The Greptile section now mixes current-state guidance with a detailed historical narrative; consider trimming the historical timeline into a short “history” note or moving it elsewhere so the merge protocol stays easy to scan for agents.
- There are multiple “authoritative” references to `docs/repository-settings.md`; to avoid future drift, you might explicitly state at the top of this document that it defers to `repository-settings.md` for all settings and only describes agent behavior, reducing repeated cross-check details in individual sections.

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

@greptile-apps greptile-apps Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

qmarcelle has reached the 50-credit limit for trial accounts. To continue receiving code reviews, upgrade your plan.

@greptile-apps greptile-apps Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

qmarcelle has reached the 50-credit limit for trial accounts. To continue receiving code reviews, upgrade your plan.

@sonarqubecloud

Copy link
Copy Markdown

@qmarcelle
qmarcelle merged commit 72980f5 into main Aug 17, 2026
7 checks passed
@qmarcelle
qmarcelle deleted the docs/greptile-not-a-merge-requirement branch August 17, 2026 23:17
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