aaronpowell · Oct 21, 2026 · Oct 21, 2026
@@ -51,9 +51,10 @@ authenticated `gh` CLI.
 
 The [`gh` CLI](https://cli.github.com) must be installed and authenticated with access
 to the repository. Everything the board reads — listing, detail, checks — goes through
-`gh`. Confirmed drawer actions use the same authenticated account to submit reviews,
-close pull requests, and enable auto-merge. Your GitHub permissions and repository
-branch-protection rules still apply.
+`gh`; the bulk PR list uses paginated REST, while per-PR checks and review metadata are
+fetched separately. Confirmed drawer actions use the same authenticated account to
+submit reviews, close pull requests, and enable auto-merge. Your GitHub permissions and
+repository branch-protection rules still apply.
 
 ## State
 

@@ -172,26 +172,7 @@ function normalizePullRequest(raw) {
     };
 }
 
-const LIST_FIELDS = [
-    "number",
-    "title",
-    "url",
-    "author",
-    "createdAt",
-    "updatedAt",
-    "isDraft",
-    "labels",
-    "baseRefName",
-    "headRefName",
-    "headRefOid",
-    "additions",
-    "deletions",
-    "changedFiles",
-    "reviewDecision",
-    "mergeStateStatus",
-].join(",");
-
-const CHECK_FETCH_CONCURRENCY = 6;
+const PR_ENRICHMENT_CONCURRENCY = 6;
 
 async function mapWithConcurrency(items, limit, fn) {
     const results = new Array(items.length);
@@ -206,15 +187,36 @@ async function mapWithConcurrency(items, limit, fn) {
     return results;
 }
 
-// statusCheckRollup is fetched per PR because requesting it in the bulk list query
-// makes GitHub's GraphQL API time out (HTTP 504) on repos with many open PRs.
+// Use REST for the bulk listing: a large `gh pr list` GraphQL query can fail at
+// GitHub's gateway on repositories with many open PRs. Keep GraphQL enrichment
+// per PR and bounded, and let a failed enrichment leave the REST listing usable.
 export async function listOpenPullRequests(repo, runner = runGh) {
-    const out = await runner(["pr", "list", "-R", repo, "--state", "open", "--limit", "200", "--json", LIST_FIELDS]);
-    const pullRequests = JSON.parse(out);
-    await mapWithConcurrency(pullRequests, CHECK_FETCH_CONCURRENCY, async (pr) => {
+    const out = await runner(["api", "--paginate", "--slurp", `repos/${repo}/pulls?state=open&per_page=100`]);
+    const pullRequests = JSON.parse(out).flat().map((raw) => ({
+        number: raw.number,
+        title: raw.title,
+        url: raw.html_url,
+        author: raw.user,
+        createdAt: raw.created_at,
+        updatedAt: raw.updated_at,
+        isDraft: raw.draft,
+        labels: raw.labels,
+        baseRefName: raw.base?.ref,
+        headRefName: raw.head?.ref,
+        headRefOid: raw.head?.sha,
+    }));
+    await mapWithConcurrency(pullRequests, PR_ENRICHMENT_CONCURRENCY, async (pr) => {
         try {
-            const raw = await runner(["pr", "view", String(pr.number), "-R", repo, "--json", "statusCheckRollup"]);
-            pr.statusCheckRollup = JSON.parse(raw).statusCheckRollup;
+            const raw = await runner([
+                "pr",
+                "view",
+                String(pr.number),
+                "-R",
+                repo,
+                "--json",
+                "additions,deletions,changedFiles,reviewDecision,mergeStateStatus,statusCheckRollup",
+            ]);
+            Object.assign(pr, JSON.parse(raw));
         } catch {
             pr.statusCheckRollup = [];
         }

@@ -64,9 +64,22 @@ test("open pull requests fetch checks with bounded concurrency, preserve order,
   let active = 0;
   let peak = 0;
   const requested = [];
+  const restPullRequests = numbers.map((number) => ({
+    number,
+    title: `PR ${number}`,
+    html_url: `https://github.com/example/repo/pull/${number}`,
+    user: { login: `author-${number}` },
+    created_at: "2026-10-01T00:00:00Z",
+    updated_at: "2026-10-02T00:00:00Z",
+    draft: false,
+    labels: [],
+    base: { ref: "main" },
+    head: { ref: `branch-${number}`, sha: `sha-${number}` },
+  }));
   const runner = async (args) => {
-    if (args[1] === "list") {
-      return JSON.stringify(numbers.map((number) => ({ number, title: `PR ${number}`, labels: [] })));
+    if (args[0] === "api") {
+      assert.deepEqual(args, ["api", "--paginate", "--slurp", "repos/example/repo/pulls?state=open&per_page=100"]);
+      return JSON.stringify([restPullRequests.slice(0, 4), restPullRequests.slice(4)]);
     }
     if (args[1] === "view") {
       const number = Number(args[2]);
@@ -77,6 +90,11 @@ test("open pull requests fetch checks with bounded concurrency, preserve order,
         await new Promise((resolve) => setTimeout(resolve, 10));
         if (number === 23) throw new Error("check request failed");
         return JSON.stringify({
+          additions: 3,
+          deletions: 1,
+          changedFiles: 2,
+          reviewDecision: "REVIEW_REQUIRED",
+          mergeStateStatus: "CLEAN",
           statusCheckRollup: [{ name: `check-${number}`, status: "COMPLETED", conclusion: "SUCCESS" }],
         });
       } finally {
@@ -93,12 +111,19 @@ test("open pull requests fetch checks with bounded concurrency, preserve order,
   assert.deepEqual(pullRequests.map(({ number }) => number), numbers, "results should preserve list order");
   assert.deepEqual(requested.sort((a, b) => a - b), [...numbers].sort((a, b) => a - b), "every PR should request checks");
   for (const pullRequest of pullRequests) {
+    assert.equal(pullRequest.url, `https://github.com/example/repo/pull/${pullRequest.number}`);
+    assert.equal(pullRequest.author, `author-${pullRequest.number}`);
+    assert.equal(pullRequest.headRefOid, `sha-${pullRequest.number}`);
     if (pullRequest.number === 23) {
       assert.deepEqual(pullRequest.checks, []);
       assert.equal(pullRequest.checksState, "none");
+      assert.equal(pullRequest.reviewDecision, "NONE");
+      assert.equal(pullRequest.additions, 0);
     } else {
       assert.deepEqual(pullRequest.checks.map(({ name }) => name), [`check-${pullRequest.number}`]);
       assert.equal(pullRequest.checksState, "success");
+      assert.equal(pullRequest.reviewDecision, "REVIEW_REQUIRED");
+      assert.equal(pullRequest.additions, 3);
     }
   }
 });