List the team's open pull requests grouped by author, with the signal that shows
what is blocking each one: whether it is awaiting a reviewer, has changes requested,
is approved and ready to merge, is still a draft, is failing CI checks, or is simply
too large for anyone to review. Optionally scope to specific "owner/name" repositories
(e.g. patchstack/hub). Use this to nudge people to merge — lead with the `headline`.
Human authors include their oldest open PRs with age; bot authors (dependabot etc.)
are collapsed into count-only summaries so a dependency backlog cannot drown out the
PRs a person should act on.
`total_oversized` and the per-PR `oversized` flag mark pull requests past the hard
review limits — over 100 files, over 5,000 added or deleted lines, or over 8,000
changed in total. These are the ones a reviewer cannot pick up at all, so they are
named in the headline and sorted to the front of their author's list. Report them as
blocked on being split, not as blocked on a reviewer. The threshold is deliberately
the hard limit rather than the team's line target: an open PR gives no file list, so
the test/docs discount `assess-change-fit` applies to a numstat cannot be applied
here, and judging against the target would flag changes that check would have passed.
`size.category` is `unknown` when the counts were never recorded — that is missing
data, not a small pull request; do not describe it as small.
Set `include_bot_details` when you are working the dependency queue itself — merging
dependabot PRs, chasing failing bumps — and each bot author gains the PR numbers,
repositories, titles and URLs you need to act, ordered by what can be closed out
first: ready to merge, then failing checks, then oldest.
Check `status_freshness` before quoting counts: it flags open PRs whose local status
may be stale, and repositories that have not synced pull requests recently — whose
PRs may be missing from these counts altogether. Archived (decommissioned) repositories are excluded — this is a review
queue, and their PRs are nobody's to review.