pr-shepherd 0.41.0 → 0.43.0

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

@@ -18,10 +18,45 @@ query BatchPr($owner: String!, $repo: String!, $pr: Int!) {
       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
@@ -289,3 +324,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/{commit-suggestion-thread.gql → suggestion-threads.gql}

@@ -1,4 +1,4 @@
-query CommitSuggestionThread($owner: String!, $repo: String!, $pr: Int!, $threadId: ID!) {
+query SuggestionThreads($owner: String!, $repo: String!, $pr: Int!, $threadIds: [ID!]!) {
   repository(owner: $owner, name: $repo) {
     pullRequest(number: $pr) {
       headRefOid
@@ -8,7 +8,7 @@ query CommitSuggestionThread($owner: String!, $repo: String!, $pr: Int!, $thread
       }
     }
   }
-  node(id: $threadId) {
+  nodes(ids: $threadIds) {
     ... on PullRequestReviewThread {
       id
       isResolved

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

@@ -11,11 +11,13 @@ export declare const BATCH_PR_QUERY: string;
 /** Slim @include follow-up for outstanding batch-query connections. */
 export declare const BATCH_PR_PAGE_QUERY: string;
 /** PR head fields plus a single review thread for `commit-suggestion`. */
-export declare const COMMIT_SUGGESTION_THREAD_QUERY: string;
+export declare const SUGGESTION_THREADS_QUERY: string;
 /** Fetches additional comments for a single review thread when its nested connection paginates. */
 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

@@ -14,11 +14,13 @@ export const BATCH_PR_QUERY = gql("batch-pr.gql");
 /** Slim @include follow-up for outstanding batch-query connections. */
 export const BATCH_PR_PAGE_QUERY = gql("batch-pr-page.gql");
 /** PR head fields plus a single review thread for `commit-suggestion`. */
-export const COMMIT_SUGGESTION_THREAD_QUERY = gql("commit-suggestion-thread.gql");
+export const SUGGESTION_THREADS_QUERY = gql("suggestion-threads.gql");
 /** Fetches additional comments for a single review thread when its nested connection paginates. */
 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.d.mts

@@ -1,9 +1,9 @@
 import type { ReviewThread } from "../types.mts";
 import type { RepoInfo } from "./client.mts";
-export interface SuggestionThreadResult {
+export interface SuggestionThreadsResult {
     headRefOid: string;
     headRefName: string;
     headRepoWithOwner: string | null;
-    thread: ReviewThread | null;
+    threads: (ReviewThread | null)[];
 }
-export declare function fetchSuggestionThread(pr: number, repo: RepoInfo, threadId: string): Promise<SuggestionThreadResult>;
+export declare function fetchSuggestionThreads(pr: number, repo: RepoInfo, threadIds: readonly string[]): Promise<SuggestionThreadsResult>;

package/bin/github/suggestion-thread.mjs

@@ -1,12 +1,12 @@
 import { graphql } from "./client.mjs";
-import { COMMIT_SUGGESTION_THREAD_QUERY } from "./queries.mjs";
+import { SUGGESTION_THREADS_QUERY } from "./queries.mjs";
 import { mapAuthorType, parseCreatedAt } from "./batch-parser-helpers.mjs";
-export async function fetchSuggestionThread(pr, repo, threadId) {
-    const result = await graphql(COMMIT_SUGGESTION_THREAD_QUERY, {
+export async function fetchSuggestionThreads(pr, repo, threadIds) {
+    const result = await graphql(SUGGESTION_THREADS_QUERY, {
         owner: repo.owner,
         repo: repo.name,
         pr,
-        threadId,
+        threadIds,
     });
     const pull = result.data.repository.pullRequest;
     if (!pull) {
@@ -16,7 +16,10 @@ export async function fetchSuggestionThread(pr, repo, threadId) {
         headRefOid: pull.headRefOid,
         headRefName: pull.headRefName,
         headRepoWithOwner: pull.headRepository?.nameWithOwner ?? null,
-        thread: parseThread(result.data.node, pr, threadId),
+        threads: threadIds.map((threadId) => {
+            const raw = result.data.nodes.find((candidate) => candidate?.id === threadId) ?? null;
+            return parseThread(raw, pr, threadId);
+        }),
     };
 }
 function parseThread(raw, pr, threadId) {

package/bin/mcp/server.d.mts

@@ -4,5 +4,5 @@ export interface CreatePrShepherdMcpServerOptions extends CreatePrShepherdOption
     /** Optional injection point for embedding hosts and focused tests. */
     shepherd?: PrShepherd;
 }
-/** Creates a local-only MCP server with the three public Shepherd operations. */
+/** Creates a local-only MCP server with Shepherd's public operations. */
 export declare function createPrShepherdMcpServer(options?: CreatePrShepherdMcpServerOptions): McpServer;

package/bin/mcp/server.mjs

@@ -5,7 +5,7 @@ import { z } from "zod";
 import { createPrShepherd, PartialApplyError, PrShepherdValidationError, } from "../api.mjs";
 import { isRepositoryQualifiedPrReference } from "../pr-reference.mjs";
 import { formatJournalResult } from "../cli/journal-formatter.mjs";
-import { formatCommitSuggestionResult, formatIterateResult, formatMarkFilesAsViewedResult, formatMutateResult, } from "../cli/formatters.mjs";
+import { formatCommitSuggestionResult, formatSuggestionPatchesResult, formatIterateResult, formatMarkFilesAsViewedResult, formatMutateResult, } from "../cli/formatters.mjs";
 import { errorToExitCode, EXIT } from "../exit-codes.mjs";
 const QUALIFIED_PR_ERROR = "pr must be a GitHub pull-request URL or an owner/repo#number reference";
 const pr = z
@@ -18,6 +18,7 @@ const iterateInputSchema = z.object({
     readyDelaySeconds: z.number().nonnegative().optional(),
     stallTimeoutSeconds: z.number().nonnegative().optional(),
     noAutoMarkReady: z.boolean().optional(),
+    merge: z.boolean().optional(),
     noAutoCancelActionable: z.boolean().optional(),
     neverCancelRuns: z.array(z.string()).optional(),
 });
@@ -57,7 +58,17 @@ const suggestionPatchInputSchema = z.object({
     message: z.string().min(1),
     description: z.string().optional(),
 });
-/** Creates a local-only MCP server with the three public Shepherd operations. */
+const suggestionPatchesInputSchema = z.object({
+    pr,
+    suggestions: z
+        .array(z.object({
+        threadId: z.string().min(1),
+        message: z.string().min(1),
+        description: z.string().optional(),
+    }))
+        .min(1),
+});
+/** Creates a local-only MCP server with Shepherd's public operations. */
 export function createPrShepherdMcpServer(options = {}) {
     const shepherd = options.shepherd ?? createPrShepherd({ cwd: options.cwd });
     const server = new McpServer({ name: "pr-shepherd", version: readPackageVersion() });
@@ -81,8 +92,18 @@ export function createPrShepherdMcpServer(options = {}) {
             openWorldHint: true,
         },
     }, async (input) => runTool(() => shepherd.apply(requireRepositoryQualifiedPr(input)), formatApplyResult));
+    server.registerTool("build_suggestion_patches", {
+        description: "Build, but never apply, an ordered list of eligible review suggestion patches.",
+        inputSchema: suggestionPatchesInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async (input) => runTool(() => shepherd.buildSuggestionPatches(requireRepositoryQualifiedPr(input)), formatSuggestionPatchesResult));
     server.registerTool("build_suggestion_patch", {
-        description: "Build, but never apply, a patch from an eligible review suggestion.",
+        description: "Deprecated: use build_suggestion_patches with a one-item suggestions array.",
         inputSchema: suggestionPatchInputSchema,
         annotations: {
             readOnlyHint: true,

package/bin/reporters/agent.mjs

@@ -61,6 +61,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 +87,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/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/escalate.d.mts

@@ -0,0 +1,30 @@
+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" | "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;
+}

package/bin/types/escalate.mjs

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

package/bin/types/github.d.mts

@@ -19,6 +19,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;
@@ -133,6 +137,10 @@ export interface BatchPrData extends BatchPrMergeFields {
     reviewSummaries: Review[];
     approvedReviews: Review[];
     checks: CheckRun[];
+    mergeQueueChecks?: CheckRun[];
+    mergeQueueChecksIncomplete?: true;
+    removedMergeQueueChecks?: CheckRun[];
+    removedMergeQueueChecksIncomplete?: true;
     branchProtection: BranchProtection | null;
     activity?: PrActivitySummary;
 }

package/bin/types/github.mjs

@@ -1,4 +1 @@
-// GitHub primitives, check runs, review threads, and batch PR data types.
-// Check classification types (CheckCategory/ClassifiedCheck/TriagedCheck) live in
-// check-classification.mts to stay under the file-length cap.
 export {};

package/bin/types/iterate.d.mts

@@ -1,37 +1,11 @@
 import type { AgentThread, AgentComment, AgentCheck, GlobalOptions, RelevantCheck, ShepherdStatus, FirstLookThread, FirstLookComment } from "./report.mts";
 import type { ActiveCheck, PrActivitySummary } from "./activity.mts";
-import type { BranchProtection, CheckStatus, MergeStateStatus, Review, ReviewDecision, ReviewThread, ShepherdMergeStatus } from "./github.mts";
+import type { BranchProtection, MergeStateStatus, Review, ReviewDecision, ReviewThread, ShepherdMergeStatus } from "./github.mts";
 import type { MergeRequirements } from "./merge-requirements.mts";
+import type { EscalateDetails } from "./escalate.mts";
+import type { MergeCommandPlan } from "./merge-action.mts";
 import type { ProtectedRun } from "./protected-run.mts";
-export type ShepherdAction = "wait" | "fix_code" | "mark_ready" | "cancel" | "escalate";
-export type EscalateTrigger = "fix-thrash" | "base-branch-unknown" | "stall-timeout" | "thread-missing-location" | "bot-cr-not-dismissed";
-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[];
-    /** Pending/unstarted CI checks that exceeded the stall timeout. */
-    stalledChecks?: AgentStalledCheck[];
-    /** Populated when fix-thrash triggered — threads that have been attempted too many times. */
-    thrashHistory?: Array<{
-        threadId: string;
-        attempts: number;
-    }>;
-    suggestion: string;
-    humanMessage: string;
-}
+export type ShepherdAction = "wait" | "fix_code" | "mark_ready" | "merge" | "cancel" | "escalate";
 export interface IterateResultSummary {
     passing: number;
     skipped: number;
@@ -66,6 +40,7 @@ export interface IterateResultBase {
     ignoredNames?: string[];
     supersededNames?: string[];
     activity?: PrActivitySummary;
+    mergeQueue?: import("./merge-queue.mts").MergeQueueReport;
 }
 interface IterateResultWait extends IterateResultBase {
     action: "wait";
@@ -123,6 +98,8 @@ interface FixRebaseAndPush {
     inProgressRunIds: string[];
     /** Workflow runs deliberately excluded from cancellation by actions.neverCancelRuns. */
     protectedRuns: ProtectedRun[];
+    /** Requeue command emitted after merge-group remediation. */
+    requeue?: MergeCommandPlan;
     /** First-look threads — previously hidden, surfaced for acknowledgment only. */
     firstLookThreads: FirstLookThread[];
     /** First-look comments — previously hidden, surfaced for acknowledgment only. */
@@ -138,11 +115,15 @@ interface IterateResultMarkReady extends IterateResultBase {
     markedReady: boolean;
     log: string;
 }
+export interface IterateResultMerge extends IterateResultBase {
+    action: "merge";
+    merge: MergeCommandPlan;
+}
 interface IterateResultEscalate extends IterateResultBase {
     action: "escalate";
     escalate: EscalateDetails;
 }
-export type IterateResult = IterateResultWait | IterateResultCancel | IterateResultFixCode | IterateResultMarkReady | IterateResultEscalate;
+export type IterateResult = IterateResultWait | IterateResultCancel | IterateResultFixCode | IterateResultMarkReady | IterateResultMerge | IterateResultEscalate;
 export interface IterateCommandOptions extends GlobalOptions {
     readyDelaySeconds?: number;
     noAutoMarkReady?: boolean;
@@ -152,5 +133,7 @@ export interface IterateCommandOptions extends GlobalOptions {
     /** Case-insensitive workflow/check glob patterns Shepherd must not cancel. */
     neverCancelRuns?: string[];
     persistSeen?: boolean;
+    /** Shepherd through readiness and emit the exact merge/queue command when ready. */
+    merge?: boolean;
 }
 export {};

package/bin/types/merge-action.d.mts

@@ -0,0 +1,12 @@
+interface ShellCommand {
+    argv: string[];
+}
+export interface MergeCommandPlan {
+    mode: "auto" | "queue";
+    command: ShellCommand;
+    /** Ordinary merge retry without `--auto`, used only when auto-merge is unavailable. */
+    fallbackCommand?: ShellCommand;
+    /** Direct enqueuePullRequest fallback for the known gh CLI queue limitation. */
+    queueApiFallbackCommand?: ShellCommand;
+}
+export {};

package/bin/types/merge-action.mjs

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

package/bin/types/merge-queue.d.mts

@@ -0,0 +1,13 @@
+import type { AutoMergeRequestStatus, MergeQueueEntryStatus, MergeQueueRemovalStatus } from "./merge-requirements.mts";
+export interface MergeQueueReport {
+    enabled: boolean;
+    inQueue: boolean;
+    autoMergeRequest?: AutoMergeRequestStatus;
+    entry?: MergeQueueEntryStatus;
+    latestRemoval?: MergeQueueRemovalStatus;
+    checkCommitOid?: string;
+    /** GitHub reported more than the first 100 contexts on the queue commit. */
+    checksIncomplete?: true;
+    /** The current PR head is not a parent of the removed synthetic queue commit. */
+    headUpdatedAfterRemoval?: true;
+}

package/bin/types/merge-queue.mjs

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

package/bin/types/merge-requirements.d.mts

@@ -17,6 +17,21 @@ export interface MergeQueueEntryStatus {
     position: number;
     state: string;
     estimatedTimeToMerge: number | null;
+    headCommitOid?: string;
+    enqueuedAtUnix?: number;
+    enqueuer?: string;
+}
+export interface AutoMergeRequestStatus {
+    enabledAtUnix: number;
+    mergeMethod: string;
+    enabledBy?: string;
+}
+export interface MergeQueueRemovalStatus {
+    reason: string | null;
+    actor?: string;
+    createdAtUnix: number;
+    beforeCommitOid?: string;
+    beforeCommitParentOids?: string[];
 }
 export interface StackStatus {
     number: number;
@@ -30,6 +45,8 @@ export interface BatchPrMergeFields {
     isInMergeQueue?: boolean;
     isMergeQueueEnabled?: boolean;
     mergeQueueEntry?: MergeQueueEntryStatus | null;
+    autoMergeRequest?: AutoMergeRequestStatus | null;
+    latestMergeQueueRemoval?: MergeQueueRemovalStatus | null;
     stack?: StackStatus | null;
 }
 /** Snapshot of "why can't I merge" requirements vs current PR state. */