pr-shepherd 0.42.0 → 0.44.0

package/bin/github/gql/batch-pr.gql

@@ -2,11 +2,17 @@
 # re-select every connection (GraphQL points scale with possible nodes).
 query BatchPr($owner: String!, $repo: String!, $pr: Int!) {
   repository(owner: $owner, name: $repo) {
+    viewerPermission
+    viewerCanAdminister
     pullRequest(number: $pr) {
       id
       number
       state
       isDraft
+      viewerDidAuthor
+      viewerCanUpdate
+      viewerCanEnableAutoMerge
+      viewerCanEditFiles
       mergeable
       mergeStateStatus
       reviewDecision
@@ -14,14 +20,50 @@ query BatchPr($owner: String!, $repo: String!, $pr: Int!) {
       headRefName
       headRepository {
         nameWithOwner
+        viewerPermission
       }
       baseRefName
       isInMergeQueue
       isMergeQueueEnabled
+      autoMergeRequest {
+        enabledAt
+        mergeMethod
+        enabledBy {
+          login
+        }
+      }
       mergeQueueEntry {
         position
         state
         estimatedTimeToMerge
+        enqueuedAt
+        enqueuer {
+          login
+        }
+        headCommit {
+          ...QueueCheckCommit
+        }
+      }
+      mergeQueueAdditions: timelineItems(last: 1, itemTypes: [ADDED_TO_MERGE_QUEUE_EVENT]) {
+        nodes {
+          ... on AddedToMergeQueueEvent {
+            createdAt
+          }
+        }
+      }
+      mergeQueueRemovals: timelineItems(last: 1, itemTypes: [REMOVED_FROM_MERGE_QUEUE_EVENT]) {
+        nodes {
+          ... on RemovedFromMergeQueueEvent {
+            reason
+            createdAt
+            actor {
+              login
+            }
+            beforeCommit {
+              ...QueueCheckCommit
+            }
+          }
+        }
       }
       stack {
         number
@@ -111,6 +153,8 @@ query BatchPr($owner: String!, $repo: String!, $pr: Int!) {
           id
           isResolved
           isOutdated
+          viewerCanReply
+          viewerCanResolve
           path
           line
           startLine
@@ -124,6 +168,7 @@ query BatchPr($owner: String!, $repo: String!, $pr: Int!) {
               isMinimized
               url
               authorAssociation
+              viewerDidAuthor
               author {
                 __typename
                 login
@@ -148,6 +193,7 @@ query BatchPr($owner: String!, $repo: String!, $pr: Int!) {
         nodes {
           id
           isMinimized
+          viewerCanMinimize
           url
           authorAssociation
           author {
@@ -185,6 +231,7 @@ query BatchPr($owner: String!, $repo: String!, $pr: Int!) {
         nodes {
           id
           isMinimized
+          viewerCanMinimize
           authorAssociation
           author {
             __typename
@@ -205,6 +252,7 @@ query BatchPr($owner: String!, $repo: String!, $pr: Int!) {
         nodes {
           id
           isMinimized
+          viewerCanMinimize
           authorAssociation
           author {
             __typename
@@ -289,3 +337,60 @@ query BatchPr($owner: String!, $repo: String!, $pr: Int!) {
     }
   }
 }
+
+fragment QueueCheckCommit on Commit {
+  oid
+  committedDate
+  parents(first: 100) {
+    nodes {
+      oid
+    }
+  }
+  statusCheckRollup {
+    contexts(first: 100) {
+      pageInfo {
+        hasNextPage
+        endCursor
+      }
+      nodes {
+        __typename
+        ... on CheckRun {
+          id
+          name
+          status
+          conclusion
+          detailsUrl
+          completedAt
+          startedAt
+          title
+          summary
+          annotations(first: 1) {
+            nodes {
+              message
+            }
+          }
+          checkSuite {
+            createdAt
+            updatedAt
+            workflowRun {
+              event
+              createdAt
+              updatedAt
+              workflow {
+                name
+                databaseId
+              }
+            }
+          }
+        }
+        ... on StatusContext {
+          context
+          state
+          createdAt
+          targetUrl
+          description
+        }
+      }
+    }
+  }
+}

package/bin/github/gql/commit-check-contexts.gql

@@ -0,0 +1,58 @@
+query CommitCheckContexts($owner: String!, $repo: String!, $oid: String!, $cursor: String) {
+  repository(owner: $owner, name: $repo) {
+    object(expression: $oid) {
+      __typename
+      ... on Commit {
+        oid
+        statusCheckRollup {
+          contexts(first: 100, after: $cursor) {
+            pageInfo {
+              hasNextPage
+              endCursor
+            }
+            nodes {
+              __typename
+              ... on CheckRun {
+                id
+                name
+                status
+                conclusion
+                detailsUrl
+                completedAt
+                startedAt
+                title
+                summary
+                annotations(first: 1) {
+                  nodes {
+                    message
+                  }
+                }
+                checkSuite {
+                  createdAt
+                  updatedAt
+                  workflowRun {
+                    event
+                    createdAt
+                    updatedAt
+                    workflow {
+                      name
+                      databaseId
+                    }
+                    databaseId
+                  }
+                }
+              }
+              ... on StatusContext {
+                context
+                state
+                description
+                targetUrl
+                createdAt
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/bin/github/gql/get-pr-body.gql

@@ -3,6 +3,7 @@ query GetPrBody($owner: String!, $repo: String!, $pr: Int!) {
     pullRequest(number: $pr) {
       id
       body
+      viewerCanUpdate
     }
   }
 }

package/bin/github/gql/review-thread-comments.gql

@@ -12,6 +12,7 @@ query ReviewThreadComments($threadId: ID!, $commentsCursor: String) {
           isMinimized
           url
           authorAssociation
+          viewerDidAuthor
           author {
             __typename
             login

package/bin/github/gql/suggestion-threads.gql

@@ -24,6 +24,7 @@ query SuggestionThreads($owner: String!, $repo: String!, $pr: Int!, $threadIds:
           isMinimized
           url
           authorAssociation
+          viewerDidAuthor
           author {
             __typename
             login

package/bin/github/merge-queue-checks.d.mts

@@ -0,0 +1,4 @@
+import type { RepoInfo } from "./client.mts";
+import type { RawPr } from "./batch-raw-types.mts";
+/** Hydrate all status contexts for the active or most recently removed queue commit. */
+export declare function hydrateMergeQueueChecks(raw: RawPr, repo: RepoInfo): Promise<void>;

package/bin/github/merge-queue-checks.mjs

@@ -0,0 +1,48 @@
+import { graphql } from "./client.mjs";
+import { requireContextNodes } from "./batch-response.mjs";
+import { COMMIT_CHECK_CONTEXTS_QUERY } from "./queries.mjs";
+async function hydrateCommitContexts(commit, repo) {
+    const contexts = commit.statusCheckRollup?.contexts;
+    if (!contexts)
+        return;
+    contexts.nodes = requireContextNodes(contexts.nodes);
+    if (contexts.pageInfo.hasNextPage && !contexts.pageInfo.endCursor) {
+        throw new Error(`Merge queue check pagination interrupted: GitHub omitted the next cursor for ${commit.oid}. Retry.`);
+    }
+    let cursor = contexts.pageInfo.hasNextPage ? contexts.pageInfo.endCursor : null;
+    while (cursor) {
+        // eslint-disable-next-line no-await-in-loop
+        const result = await graphql(COMMIT_CHECK_CONTEXTS_QUERY, {
+            owner: repo.owner,
+            repo: repo.name,
+            oid: commit.oid,
+            cursor,
+        });
+        const object = result.data.repository?.object;
+        if (object?.__typename !== "Commit" || object.oid !== commit.oid) {
+            throw new Error(`Merge queue check pagination interrupted: commit ${commit.oid} disappeared or changed. Retry.`);
+        }
+        const next = object.statusCheckRollup?.contexts;
+        if (!next) {
+            throw new Error(`Merge queue check pagination interrupted: statusCheckRollup disappeared for ${commit.oid}. Retry.`);
+        }
+        contexts.nodes.push(...requireContextNodes(next.nodes));
+        contexts.pageInfo = next.pageInfo;
+        cursor = next.pageInfo.hasNextPage ? next.pageInfo.endCursor : null;
+        if (next.pageInfo.hasNextPage && !cursor) {
+            throw new Error(`Merge queue check pagination interrupted: GitHub omitted the next cursor for ${commit.oid}. Retry.`);
+        }
+    }
+}
+/** Hydrate all status contexts for the active or most recently removed queue commit. */
+export async function hydrateMergeQueueChecks(raw, repo) {
+    const active = raw.mergeQueueEntry?.headCommit;
+    const removal = raw.mergeQueueRemovals?.nodes[0];
+    const addition = raw.mergeQueueAdditions?.nodes[0];
+    const removalIsCurrent = Boolean(removal && (!addition || Date.parse(removal.createdAt) >= Date.parse(addition.createdAt)));
+    const removed = removalIsCurrent ? removal?.beforeCommit : undefined;
+    if (active)
+        await hydrateCommitContexts(active, repo);
+    if (removed && removed.oid !== active?.oid)
+        await hydrateCommitContexts(removed, repo);
+}

package/bin/github/queries.d.mts

@@ -16,6 +16,8 @@ export declare const SUGGESTION_THREADS_QUERY: string;
 export declare const REVIEW_THREAD_COMMENTS_QUERY: string;
 /** Fetch inline annotations for a single CheckRun by node ID. */
 export declare const CHECK_RUN_ANNOTATIONS_QUERY: string;
+/** Fetches additional status contexts for a merge queue synthetic commit. */
+export declare const COMMIT_CHECK_CONTEXTS_QUERY: string;
 /** Returns the current head commit SHA for a PR. Used by waitForSha polling. */
 export declare const GET_PR_HEAD_SHA_QUERY: string;
 /** Look up PR number by branch name (for getCurrentPrNumber). */

package/bin/github/queries.mjs

@@ -19,6 +19,8 @@ export const SUGGESTION_THREADS_QUERY = gql("suggestion-threads.gql");
 export const REVIEW_THREAD_COMMENTS_QUERY = gql("review-thread-comments.gql");
 /** Fetch inline annotations for a single CheckRun by node ID. */
 export const CHECK_RUN_ANNOTATIONS_QUERY = gql("check-run-annotations.gql");
+/** Fetches additional status contexts for a merge queue synthetic commit. */
+export const COMMIT_CHECK_CONTEXTS_QUERY = gql("commit-check-contexts.gql");
 /** Returns the current head commit SHA for a PR. Used by waitForSha polling. */
 export const GET_PR_HEAD_SHA_QUERY = gql("get-pr-head-sha.gql");
 /** Look up PR number by branch name (for getCurrentPrNumber). */

package/bin/github/suggestion-thread.mjs

@@ -41,6 +41,7 @@ function parseThread(raw, pr, threadId) {
         ...(comment?.authorAssociation !== undefined && {
             authorAssociation: comment.authorAssociation,
         }),
+        ...(comment?.viewerDidAuthor === true && { viewerDidAuthor: true }),
         body: comment?.body ?? "",
         url: comment?.url ?? "",
         createdAtUnix: comment?.createdAt ? parseCreatedAt(comment.createdAt) : 0,

package/bin/mcp/server.mjs

@@ -11,15 +11,22 @@ const QUALIFIED_PR_ERROR = "pr must be a GitHub pull-request URL or an owner/rep
 const pr = z
     .string()
     .refine(isRepositoryQualifiedPrReference, { message: QUALIFIED_PR_ERROR })
-    .describe("GitHub pull-request URL or owner/repo#number");
+    .describe("GitHub pull-request URL or owner/repo#number; the explicit repository may differ from the server working directory");
 const ids = z.array(z.string().min(1)).optional();
 const iterateInputSchema = z.object({
     pr,
     readyDelaySeconds: z.number().nonnegative().optional(),
     stallTimeoutSeconds: z.number().nonnegative().optional(),
     noAutoMarkReady: z.boolean().optional(),
-    noAutoCancelActionable: z.boolean().optional(),
-    neverCancelRuns: z.array(z.string()).optional(),
+    merge: z.boolean().optional(),
+    noAutoCancelActionable: z
+        .boolean()
+        .optional()
+        .describe("Deprecated no-op; Shepherd never cancels workflow runs."),
+    neverCancelRuns: z
+        .array(z.string())
+        .optional()
+        .describe("Deprecated per-call no-op retained for compatibility."),
 });
 const reviewMutationsOperationSchema = z.object({
     type: z.literal("review_mutations"),
@@ -33,7 +40,7 @@ const reviewMutationsOperationSchema = z.object({
 const markFilesViewedOperationSchema = z.object({
     type: z.literal("mark_files_viewed"),
     files: z.array(z.string().min(1)).optional(),
-    tests: z.boolean().optional(),
+    tests: z.boolean().optional().describe("Select changed test files; no mutation occurs."),
     matchPatterns: z.array(z.string().min(1)).optional(),
 });
 const appendJournalOperationSchema = z.object({
@@ -72,7 +79,7 @@ export function createPrShepherdMcpServer(options = {}) {
     const shepherd = options.shepherd ?? createPrShepherd({ cwd: options.cwd });
     const server = new McpServer({ name: "pr-shepherd", version: readPackageVersion() });
     server.registerTool("iterate", {
-        description: "Inspect the current pull request and return the next Shepherd state.",
+        description: "Inspect the specified pull request and return the next Shepherd state.",
         inputSchema: iterateInputSchema,
         annotations: {
             readOnlyHint: false,
@@ -82,7 +89,7 @@ export function createPrShepherdMcpServer(options = {}) {
         },
     }, async (input) => runTool(() => shepherd.iterate(requireRepositoryQualifiedPr(input)), formatIterateResult));
     server.registerTool("apply", {
-        description: "Apply ordered review, file-view, and journal operations after prevalidation.",
+        description: "Apply ordered authorized review and journal operations, or run selection-only file-view diagnostics, after prevalidation.",
         inputSchema: applyInputSchema,
         annotations: {
             readOnlyHint: false,

package/bin/pr-reference.d.mts

@@ -2,6 +2,19 @@ export interface ParsedPrReference {
     number?: number;
     repository?: string;
 }
+export interface ResolvedPrTarget {
+    prNumber?: number;
+    targetRepository?: {
+        owner: string;
+        name: string;
+    };
+}
 /** Parses API PR references without performing repository or GitHub I/O. */
 export declare function parsePrReference(pr: number | string | undefined): ParsedPrReference | null;
+/** Parses a positional CLI PR reference, including a bare numeric string. */
+export declare function parseCliPrReference(value: string): ParsedPrReference | null;
+/** Converts a validated parsed reference into the command-layer target shape. */
+export declare function resolveParsedPrTarget(parsed: ParsedPrReference): ResolvedPrTarget;
+/** Canonical collision-safe PR reference for generated commands and handoffs. */
+export declare function formatPrUrl(repository: string, prNumber: number): string;
 export declare function isRepositoryQualifiedPrReference(pr: unknown): pr is string;

package/bin/pr-reference.mjs

@@ -18,7 +18,7 @@ export function parsePrReference(pr) {
         const parts = url.pathname.split("/").filter(Boolean);
         if ((url.protocol === "https:" || url.protocol === "http:") &&
             (url.hostname === "github.com" || url.hostname === "www.github.com") &&
-            parts.length === 4 &&
+            parts.length >= 4 &&
             parts[2] === "pull" &&
             /^[1-9][0-9]*$/.test(parts[3])) {
             return { number: Number(parts[3]), repository: `${parts[0]}/${parts[1]}` };
@@ -29,6 +29,28 @@ export function parsePrReference(pr) {
     }
     return null;
 }
+/** Parses a positional CLI PR reference, including a bare numeric string. */
+export function parseCliPrReference(value) {
+    if (/^[0-9]+$/.test(value))
+        return { number: Number(value) };
+    return parsePrReference(value);
+}
+/** Converts a validated parsed reference into the command-layer target shape. */
+export function resolveParsedPrTarget(parsed) {
+    if (parsed.repository === undefined)
+        return { prNumber: parsed.number };
+    const [owner, name] = parsed.repository.split("/");
+    if (!owner || !name)
+        throw new Error(`Invalid repository reference: ${parsed.repository}`);
+    return {
+        prNumber: parsed.number,
+        targetRepository: { owner, name },
+    };
+}
+/** Canonical collision-safe PR reference for generated commands and handoffs. */
+export function formatPrUrl(repository, prNumber) {
+    return `https://github.com/${repository}/pull/${prNumber}`;
+}
 export function isRepositoryQualifiedPrReference(pr) {
     if (typeof pr !== "string")
         return false;

package/bin/reporters/agent.mjs

@@ -13,6 +13,8 @@ export function toAgentThread(t) {
     const suggestion = extractSuggestion(t) ?? undefined;
     return {
         id: t.id,
+        ...(t.viewerCanReply === false && { viewerCanReply: false }),
+        ...(t.viewerCanResolve === false && { viewerCanResolve: false }),
         ...(t.reviewId !== undefined && { reviewId: t.reviewId }),
         path: t.path,
         line: t.line,
@@ -22,6 +24,7 @@ export function toAgentThread(t) {
         author: t.author,
         ...(t.authorType !== undefined && { authorType: t.authorType }),
         ...(t.authorAssociation !== undefined && { authorAssociation: t.authorAssociation }),
+        ...(t.viewerDidAuthor === true && { viewerDidAuthor: true }),
         body: t.body,
         url: t.url,
         ...(t.edited === true && { edited: true }),
@@ -31,6 +34,7 @@ export function toAgentThread(t) {
                 author: c.author,
                 ...(c.authorType !== undefined && { authorType: c.authorType }),
                 ...(c.authorAssociation !== undefined && { authorAssociation: c.authorAssociation }),
+                ...(c.viewerDidAuthor === true && { viewerDidAuthor: true }),
                 body: c.body,
                 url: c.url,
             })),
@@ -41,6 +45,7 @@ export function toAgentThread(t) {
 export function toAgentComment(c) {
     return {
         id: c.id,
+        ...(c.viewerCanMinimize === false && { viewerCanMinimize: false }),
         author: c.author,
         ...(c.authorType !== undefined && { authorType: c.authorType }),
         ...(c.authorAssociation !== undefined && { authorAssociation: c.authorAssociation }),
@@ -61,6 +66,8 @@ export function toAgentCheck(c) {
         ...(c.summary !== undefined && { summary: c.summary }),
         ...(c.logExcerpt !== undefined && { logExcerpt: c.logExcerpt }),
         ...(c.annotations !== undefined && { annotations: c.annotations }),
+        ...(c.scope !== undefined && { scope: c.scope }),
+        ...(c.commitOid !== undefined && { commitOid: c.commitOid }),
     };
 }
 export function toAgentStalledCheck(c, nowSeconds) {
@@ -85,13 +92,14 @@ export function toAgentStalledCheck(c, nowSeconds) {
  * log tail, so they are all kept.
  */
 export function toAgentChecks(checks) {
-    const seenNames = new Set();
+    const seenKeys = new Set();
     const result = [];
     for (const c of checks) {
         if (c.runId === null) {
-            if (seenNames.has(c.name))
+            const key = `${c.scope ?? "pr"}:${c.commitOid ?? "head"}:${c.name}`;
+            if (seenKeys.has(key))
                 continue;
-            seenNames.add(c.name);
+            seenKeys.add(key);
         }
         result.push(toAgentCheck(c));
     }

package/bin/threads/transcript.d.mts

@@ -4,11 +4,13 @@ export declare function threadComments(thread: {
     author: string;
     authorType?: ReviewThreadComment["authorType"];
     authorAssociation?: ReviewThreadComment["authorAssociation"];
+    viewerDidAuthor?: true;
     url?: string;
     createdAtUnix?: number;
     comments?: Array<Pick<ReviewThreadComment, "id" | "author" | "body" | "url"> & {
         authorType?: ReviewThreadComment["authorType"];
         authorAssociation?: ReviewThreadComment["authorAssociation"];
+        viewerDidAuthor?: true;
     } & Partial<Pick<ReviewThreadComment, "isMinimized" | "createdAtUnix">>>;
 }): ReviewThreadComment[];
 export declare function threadTranscriptBody(thread: ReviewThread, appendedBodies?: string[]): string;

package/bin/threads/transcript.mjs

@@ -6,6 +6,7 @@ export function threadComments(thread) {
             author: c.author,
             authorType: c.authorType ?? "Unknown",
             ...(c.authorAssociation !== undefined && { authorAssociation: c.authorAssociation }),
+            ...(c.viewerDidAuthor === true && { viewerDidAuthor: true }),
             body: c.body,
             url: c.url,
             createdAtUnix: c.createdAtUnix ?? 0,
@@ -20,6 +21,7 @@ export function threadComments(thread) {
             ...(thread.authorAssociation !== undefined && {
                 authorAssociation: thread.authorAssociation,
             }),
+            ...(thread.viewerDidAuthor === true && { viewerDidAuthor: true }),
             body: thread.body,
             url: thread.url ?? "",
             createdAtUnix: thread.createdAtUnix ?? 0,

package/bin/types/activity.d.mts

@@ -26,5 +26,7 @@ export interface ActiveCheck {
     detailsUrl: string | null;
     workflowName?: string;
     summary?: string;
+    scope?: "merge_group";
+    commitOid?: string;
 }
 export {};

package/bin/types/agent-thread.d.mts

@@ -4,6 +4,7 @@ export interface AgentThreadComment {
     author: string;
     authorType?: AuthorType;
     authorAssociation?: CommentAuthorAssociation;
+    viewerDidAuthor?: true;
     body: string;
     url: string;
 }

package/bin/types/escalate.d.mts

@@ -0,0 +1,35 @@
+import type { AgentComment, AgentThread } from "./report.mts";
+import type { CheckStatus, Review } from "./github.mts";
+import type { MergeQueueRemovalStatus } from "./merge-requirements.mts";
+export type EscalateTrigger = "fix-thrash" | "base-branch-unknown" | "stall-timeout" | "thread-missing-location" | "authorization-required" | "bot-cr-not-dismissed" | "merge-queue-removed";
+export interface AgentStalledCheck {
+    name: string;
+    status: CheckStatus;
+    source: "check_run" | "status_context" | "startup_failure";
+    runId: string | null;
+    detailsUrl: string | null;
+    createdAtUnix?: number;
+    startedAtUnix?: number;
+    updatedAtUnix?: number;
+    ageSeconds: number;
+    summary?: string;
+}
+export interface EscalateDetails {
+    triggers: EscalateTrigger[];
+    unresolvedThreads: AgentThread[];
+    ambiguousComments: AgentComment[];
+    changesRequestedReviews: Review[];
+    stalledChecks?: AgentStalledCheck[];
+    thrashHistory?: Array<{
+        threadId: string;
+        attempts: number;
+    }>;
+    suggestion: string;
+    humanMessage: string;
+    mergeQueueRemoval?: MergeQueueRemovalStatus;
+    authorization?: Array<{
+        action: "reply-thread" | "resolve-thread" | "dismiss-review" | "mark-ready" | "merge-or-enqueue";
+        targetIds: string[];
+        reason: "denied-or-unverifiable";
+    }>;
+}

package/bin/types/escalate.mjs

@@ -0,0 +1 @@
+export {};

package/bin/types/github.d.mts

@@ -7,6 +7,17 @@ export type MergeableState = "CONFLICTING" | "MERGEABLE" | "UNKNOWN";
 export type MergeStateStatus = "BEHIND" | "BLOCKED" | "CLEAN" | "DIRTY" | "DRAFT" | "HAS_HOOKS" | "UNKNOWN" | "UNSTABLE";
 export type ReviewDecision = "APPROVED" | "CHANGES_REQUESTED" | "REVIEW_REQUIRED" | null;
 export type AuthorType = "User" | "Bot" | "Unknown";
+type RepositoryPermission = "NONE" | "READ" | "TRIAGE" | "WRITE" | "MAINTAIN" | "ADMIN";
+/** Raw GitHub viewer fields used to gate remote actions. */
+export interface ViewerAuthorization {
+    repositoryPermission: RepositoryPermission | null;
+    viewerCanAdminister: boolean;
+    viewerDidAuthor: boolean;
+    viewerCanUpdate: boolean;
+    viewerCanEnableAutoMerge: boolean;
+    viewerCanEditFiles: boolean;
+    headRepositoryPermission: RepositoryPermission | null;
+}
 /** Raw relationship between a comment author and the repository, as reported by GitHub. */
 export type CommentAuthorAssociation = "COLLABORATOR" | "CONTRIBUTOR" | "FIRST_TIMER" | "FIRST_TIME_CONTRIBUTOR" | "MANNEQUIN" | "MEMBER" | "NONE" | "OWNER";
 export interface CheckRun {
@@ -19,6 +30,10 @@ export interface CheckRun {
     detailsUrl: string;
     event: string | null;
     runId: string | null;
+    /** Commit scope that supplied this check. Omitted for ordinary PR-head checks. */
+    scope?: "merge_group";
+    /** Synthetic merge-group commit OID, when `scope` is `merge_group`. */
+    commitOid?: string;
     createdAtUnix?: number;
     startedAtUnix?: number;
     completedAtUnix?: number;
@@ -36,6 +51,8 @@ export interface ReviewThread {
     isResolved: boolean;
     isOutdated: boolean;
     isMinimized: boolean;
+    viewerCanReply?: boolean;
+    viewerCanResolve?: boolean;
     path: string | null;
     line: number | null;
     /** Start of the comment's line range. Null for single-line comments (use `line` for both). */
@@ -45,6 +62,7 @@ export interface ReviewThread {
     author: string;
     authorType: AuthorType;
     authorAssociation?: CommentAuthorAssociation;
+    viewerDidAuthor?: true;
     body: string;
     url: string;
     createdAtUnix?: number;
@@ -66,6 +84,7 @@ export interface SuggestionBlock {
 export interface PrComment {
     id: string;
     isMinimized: boolean;
+    viewerCanMinimize?: boolean;
     author: string;
     authorType: AuthorType;
     authorAssociation?: CommentAuthorAssociation;
@@ -78,6 +97,8 @@ export interface Review {
     author: string;
     authorType: AuthorType;
     authorAssociation?: CommentAuthorAssociation;
+    /** Present for minimizable COMMENTED/APPROVED reviews; false for non-minimizable review rows. */
+    viewerCanMinimize?: boolean;
     body: string;
     createdAtUnix?: number;
     edited?: boolean;
@@ -119,6 +140,7 @@ export interface BatchPrData extends BatchPrMergeFields {
     headRefName: string;
     /** `"owner/name"` of the head repository; null when the fork has been deleted. */
     headRepoWithOwner: string | null;
+    viewerAuthorization?: ViewerAuthorization;
     baseRefName: string;
     reviewRequests: Array<{
         login: string;
@@ -133,6 +155,11 @@ export interface BatchPrData extends BatchPrMergeFields {
     reviewSummaries: Review[];
     approvedReviews: Review[];
     checks: CheckRun[];
+    mergeQueueChecks?: CheckRun[];
+    mergeQueueChecksIncomplete?: true;
+    removedMergeQueueChecks?: CheckRun[];
+    removedMergeQueueChecksIncomplete?: true;
     branchProtection: BranchProtection | null;
     activity?: PrActivitySummary;
 }
+export {};