Skip to content

🌱 review backlog: file only β‰₯P2 as issues, per-PR cap, collapse same-family findingsΒ #17065

Closed

Description

@clubanderson

Evidence (read-only audit 2026-10-27 β†’ 2026-11-07)

[reviewer] Review backlog issues are now the single largest issue family in this repo:

Code: src/pkg/github/review_backlog.go (DefaultReviewBacklogIssueCap = 3; the routed cap review.backlog.max_per_pr_per_day defaults to 10 and resets every UTC day) and src/pkg/config/review_severity.go (review.severity.backlog_below defaults to true, so every P3 nit below block_at becomes an issue).

Proposal

  1. review.backlog.min_severity (default P2): findings below it are not filed as issues. They are appended to one upserted hive:review-followups marker comment on the PR (via EditIssueMarkerComment, like the claim ledger) so nothing is lost. Docs-currency findings are P3 by default β†’ follow-ups comment. min_severity: P3 restores today's file-everything behaviour.
  2. Cap per PR lifetime, not per day: new review.backlog.max_per_pr (default 3), persisted in the review-backlog ledger; max_per_pr_per_day is read as its alias when set.
  3. Collapse same-family findings: several new findings from one PR sharing a perspective (e.g. docs-currency) become one issue with a checklist β€” [reviewer] Review backlog (docs-currency): <repo>#<pr> β€” N follow-ups β€” instead of N issues.
  4. Operator docs (operator-reference, review-swarm.md, work-sources.md).

Expected effect

~28/week docs-currency issues β†’ 0 (all P3). Remaining P3 nits from other perspectives β†’ follow-ups comment. Per-PR-lifetime cap of 3 plus same-family collapse bounds the P2 remainder. Expected β‰ˆ βˆ’70–80% backlog issues/week (160 β†’ ~30–50).

Activity

  1. added
    help wantedDenotes an issue that needs help from a contributor. Must meet "help wanted" guidelines.
    on Nov 7, 2026
  2. hivecommons-hive commented on Nov 7, 2026

    @hivecommons-hive
    Contributor

    πŸ”’ Claimed by agent scanner (agent on hive hosted-available-oke-11-placeholder-r05x). The claim lasts 2h0m0s without activity and renews while the work continues. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

    Claim history
    • 2026-11-07 19:28 UTC β€” claimed by scanner (agent on hive hosted-available-oke-11-placeholder-r05x)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    has-open-prhelp wantedDenotes an issue that needs help from a contributor. Must meet "help wanted" guidelines.hive/likely-doneHive verified that a merged PR references or claims this issue; pending confirmation

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions