Reviewer queue selection must prove ordering before selecting next PR #321

Closed
opened 2026-07-07 01:30:23 -05:00 by jcwalker3 · 0 comments
Owner

Reviewer workflows list open PRs but do not always explain whether the API response is newest-first, oldest-first, or explicitly sorted before selecting the next PR.

Observed behavior

A reviewer report listed PR #291 first and PR #286 later, then selected PR #286 as the next actionable PR. This may be correct if the queue policy is oldest-first by PR number or creation date, but the report did not explicitly prove the ordering rule.

Required behavior

  1. Reviewer workflows must state the queue ordering policy:

    • oldest PR number first
    • oldest created date first
    • priority label
    • project-specific order
  2. If the API response order differs from the selection order, the workflow must explicitly sort or explain the selection.

  3. For every earlier actionable PR skipped by policy, report why.

  4. For newer PRs listed before the selected PR, clarify that they are newer and not earlier in the review queue if using oldest-first policy.

Acceptance criteria

  • Reports cannot claim next eligible PR without queue ordering proof.
  • Reports include the selection policy used.
  • Tests cover newest-first API response, oldest-first API response, blocked earlier PRs, and priority overrides.
Reviewer workflows list open PRs but do not always explain whether the API response is newest-first, oldest-first, or explicitly sorted before selecting the next PR. ## Observed behavior A reviewer report listed PR #291 first and PR #286 later, then selected PR #286 as the next actionable PR. This may be correct if the queue policy is oldest-first by PR number or creation date, but the report did not explicitly prove the ordering rule. ## Required behavior 1. Reviewer workflows must state the queue ordering policy: * oldest PR number first * oldest created date first * priority label * project-specific order 2. If the API response order differs from the selection order, the workflow must explicitly sort or explain the selection. 3. For every earlier actionable PR skipped by policy, report why. 4. For newer PRs listed before the selected PR, clarify that they are newer and not earlier in the review queue if using oldest-first policy. ## Acceptance criteria * Reports cannot claim `next eligible PR` without queue ordering proof. * Reports include the selection policy used. * Tests cover newest-first API response, oldest-first API response, blocked earlier PRs, and priority overrides.
jcwalker3 added the status:in-progress label 2026-07-07 04:05:37 -05:00
sysadmin removed the status:in-progress label 2026-07-07 04:31:16 -05:00
Sign in to join this conversation.
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Scaled-Tech-Consulting/Gitea-Tools#321