@forge-glance/sdk 0.1.1 → 0.2.1

package/dist/GitHubProvider.d.ts

@@ -11,9 +11,9 @@
  * Base URL: "https://api.github.com" for github.com; for GHES, the user
  * provides the instance URL and we append "/api/v3".
  */
-import type { GitProvider } from "./GitProvider.ts";
-import type { BranchProtectionRule, CreatePullRequestInput, MRDetail, PullRequest, UpdatePullRequestInput, UserRef } from "./types.ts";
-import { type ForgeLogger } from "./logger.ts";
+import type { GitProvider } from './GitProvider.ts';
+import type { BranchProtectionRule, CreatePullRequestInput, MergePullRequestInput, MRDetail, ProviderCapabilities, PullRequest, UpdatePullRequestInput, UserRef } from './types.ts';
+import { type ForgeLogger } from './logger.ts';
 export declare class GitHubProvider implements GitProvider {
     readonly providerName: "github";
     readonly baseURL: string;
@@ -29,6 +29,7 @@ export declare class GitHubProvider implements GitProvider {
     constructor(baseURL: string, token: string, options?: {
         logger?: ForgeLogger;
     });
+    readonly capabilities: ProviderCapabilities;
     validateToken(): Promise<UserRef>;
     fetchPullRequests(): Promise<PullRequest[]>;
     fetchSingleMR(projectPath: string, mrIid: number, _currentUserNumericId: number | null): Promise<PullRequest | null>;
@@ -39,6 +40,16 @@ export declare class GitHubProvider implements GitProvider {
     createPullRequest(input: CreatePullRequestInput): Promise<PullRequest>;
     updatePullRequest(projectPath: string, mrIid: number, input: UpdatePullRequestInput): Promise<PullRequest>;
     restRequest(method: string, path: string, body?: unknown): Promise<Response>;
+    mergePullRequest(projectPath: string, mrIid: number, input?: MergePullRequestInput): Promise<PullRequest>;
+    approvePullRequest(projectPath: string, mrIid: number): Promise<void>;
+    unapprovePullRequest(_projectPath: string, _mrIid: number): Promise<void>;
+    rebasePullRequest(_projectPath: string, _mrIid: number): Promise<void>;
+    setAutoMerge(_projectPath: string, _mrIid: number): Promise<void>;
+    cancelAutoMerge(_projectPath: string, _mrIid: number): Promise<void>;
+    resolveDiscussion(_projectPath: string, _mrIid: number, _discussionId: string): Promise<void>;
+    unresolveDiscussion(_projectPath: string, _mrIid: number, _discussionId: string): Promise<void>;
+    retryPipeline(projectPath: string, pipelineId: number): Promise<void>;
+    requestReReview(projectPath: string, mrIid: number, reviewerUsernames?: string[]): Promise<void>;
     private api;
     /**
      * Search for PRs using the GitHub search API.

package/dist/GitHubProvider.js

@@ -95,6 +95,16 @@ class GitHubProvider {
       this.apiBase = `${this.baseURL}/api/v3`;
     }
   }
+  capabilities = {
+    canMerge: true,
+    canApprove: true,
+    canUnapprove: false,
+    canRebase: false,
+    canAutoMerge: false,
+    canResolveDiscussions: false,
+    canRetryPipeline: true,
+    canRequestReReview: true
+  };
   async validateToken() {
     const res = await this.api("GET", "/user");
     if (!res.ok) {
@@ -136,7 +146,9 @@ class GitHubProvider {
       ]);
       return this.toPullRequest(pr, prRoles, reviews, checkRuns);
     }));
-    this.log.debug("GitHubProvider.fetchPullRequests", { count: results.length });
+    this.log.debug("GitHubProvider.fetchPullRequests", {
+      count: results.length
+    });
     return results;
   }
   async fetchSingleMR(projectPath, mrIid, _currentUserNumericId) {
@@ -249,7 +261,11 @@ class GitHubProvider {
   async fetchPullRequestByBranch(projectPath, sourceBranch) {
     const res = await this.api("GET", `/repos/${projectPath}/pulls?head=${projectPath.split("/")[0]}:${encodeURIComponent(sourceBranch)}&state=open&per_page=1`);
     if (!res.ok) {
-      this.log.warn("fetchPullRequestByBranch failed", { projectPath, sourceBranch, status: res.status });
+      this.log.warn("fetchPullRequestByBranch failed", {
+        projectPath,
+        sourceBranch,
+        status: res.status
+      });
       return null;
     }
     const prs = await res.json();
@@ -333,6 +349,83 @@ class GitHubProvider {
   async restRequest(method, path, body) {
     return this.api(method, path, body);
   }
+  async mergePullRequest(projectPath, mrIid, input) {
+    const body = {};
+    if (input?.commitMessage != null)
+      body.commit_title = input.commitMessage;
+    if (input?.squashCommitMessage != null)
+      body.commit_title = input.squashCommitMessage;
+    if (input?.shouldRemoveSourceBranch != null)
+      body.delete_branch = input.shouldRemoveSourceBranch;
+    if (input?.sha != null)
+      body.sha = input.sha;
+    if (input?.mergeMethod) {
+      body.merge_method = input.mergeMethod;
+    } else if (input?.squash) {
+      body.merge_method = "squash";
+    }
+    const res = await this.api("PUT", `/repos/${projectPath}/pulls/${mrIid}/merge`, body);
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`mergePullRequest failed: ${res.status} ${text}`);
+    }
+    const pr = await this.fetchSingleMR(projectPath, mrIid, null);
+    if (!pr)
+      throw new Error("Merged PR but failed to fetch it back");
+    return pr;
+  }
+  async approvePullRequest(projectPath, mrIid) {
+    const res = await this.api("POST", `/repos/${projectPath}/pulls/${mrIid}/reviews`, {
+      event: "APPROVE"
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(`approvePullRequest failed: ${res.status} ${res.statusText}${text ? ` — ${text}` : ""}`);
+    }
+  }
+  async unapprovePullRequest(_projectPath, _mrIid) {
+    throw new Error("unapprovePullRequest is not supported by GitHub. " + "Check provider.capabilities.canUnapprove before calling.");
+  }
+  async rebasePullRequest(_projectPath, _mrIid) {
+    throw new Error("rebasePullRequest is not supported by GitHub. " + "Check provider.capabilities.canRebase before calling.");
+  }
+  async setAutoMerge(_projectPath, _mrIid) {
+    throw new Error("setAutoMerge is not supported by the GitHub REST API. " + "Check provider.capabilities.canAutoMerge before calling.");
+  }
+  async cancelAutoMerge(_projectPath, _mrIid) {
+    throw new Error("cancelAutoMerge is not supported by the GitHub REST API. " + "Check provider.capabilities.canAutoMerge before calling.");
+  }
+  async resolveDiscussion(_projectPath, _mrIid, _discussionId) {
+    throw new Error("resolveDiscussion is not supported by the GitHub REST API. " + "Check provider.capabilities.canResolveDiscussions before calling.");
+  }
+  async unresolveDiscussion(_projectPath, _mrIid, _discussionId) {
+    throw new Error("unresolveDiscussion is not supported by the GitHub REST API. " + "Check provider.capabilities.canResolveDiscussions before calling.");
+  }
+  async retryPipeline(projectPath, pipelineId) {
+    const res = await this.api("POST", `/repos/${projectPath}/actions/runs/${pipelineId}/rerun`);
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(`retryPipeline failed: ${res.status} ${res.statusText}${text ? ` — ${text}` : ""}`);
+    }
+  }
+  async requestReReview(projectPath, mrIid, reviewerUsernames) {
+    if (!reviewerUsernames?.length) {
+      const prRes = await this.api("GET", `/repos/${projectPath}/pulls/${mrIid}`);
+      if (!prRes.ok) {
+        throw new Error(`requestReReview: failed to fetch PR: ${prRes.status}`);
+      }
+      const pr = await prRes.json();
+      reviewerUsernames = pr.requested_reviewers.map((r) => r.login);
+      if (!reviewerUsernames.length) {
+        return;
+      }
+    }
+    const res = await this.api("POST", `/repos/${projectPath}/pulls/${mrIid}/requested_reviewers`, { reviewers: reviewerUsernames });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(`requestReReview failed: ${res.status} ${res.statusText}${text ? ` — ${text}` : ""}`);
+    }
+  }
   async api(method, path, body) {
     const url = `${this.apiBase}${path}`;
     const headers = {
@@ -447,7 +540,11 @@ class GitHubProvider {
       approved: approvedBy.length > 0 && changesRequested === 0,
       approvedBy,
       diffStats,
-      detailedMergeStatus: null
+      detailedMergeStatus: null,
+      autoMergeEnabled: pr.auto_merge != null,
+      autoMergeStrategy: pr.auto_merge?.merge_method ?? null,
+      mergeUser: pr.auto_merge ? toUserRef(pr.auto_merge.enabled_by) : null,
+      mergeAfter: null
     };
   }
 }

package/dist/GitLabProvider.d.ts

@@ -1,13 +1,13 @@
-import type { GitProvider } from "./GitProvider.ts";
-import type { BranchProtectionRule, CreatePullRequestInput, MRDetail, PullRequest, UpdatePullRequestInput, UserRef } from "./types.ts";
-import { type ForgeLogger } from "./logger.ts";
+import type { GitProvider } from './GitProvider.ts';
+import type { BranchProtectionRule, CreatePullRequestInput, MergePullRequestInput, MRDetail, ProviderCapabilities, PullRequest, UpdatePullRequestInput, UserRef } from './types.ts';
+import { type ForgeLogger } from './logger.ts';
 /**
  * Strips the provider prefix from a scoped repositoryId and returns the
  * numeric GitLab project ID needed for REST API calls.
  * e.g. "gitlab:42" → 42
  */
 export declare function parseGitLabRepoId(repositoryId: string): number;
-export declare const MR_DASHBOARD_FRAGMENT = "\n  fragment MRDashboardFields on MergeRequest {\n    id iid projectId title description state draft\n    sourceBranch targetBranch webUrl\n    diffHeadSha\n    updatedAt createdAt\n    conflicts\n    detailedMergeStatus\n    approved\n    diffStatsSummary { additions deletions fileCount }\n    author { id username name avatarUrl }\n    assignees(first: 20) { nodes { id username name avatarUrl } }\n    reviewers(first: 20) { nodes { id username name avatarUrl } }\n    approvedBy(first: 20) { nodes { id username name avatarUrl } }\n    approvalsLeft\n    resolvableDiscussionsCount\n    resolvedDiscussionsCount\n    headPipeline {\n      id iid status\n      createdAt\n      path\n      stages(first: 20) { nodes {\n        name\n        jobs(first: 50) { nodes {\n          id name status\n          allowFailure\n          webPath\n          stage { name }\n        }}\n      }}\n    }\n  }\n";
+export declare const MR_DASHBOARD_FRAGMENT = "\n  fragment MRDashboardFields on MergeRequest {\n    id iid projectId title description state draft\n    sourceBranch targetBranch webUrl\n    diffHeadSha\n    updatedAt createdAt\n    conflicts\n    detailedMergeStatus\n    approved\n    diffStatsSummary { additions deletions fileCount }\n    author { id username name avatarUrl }\n    assignees(first: 20) { nodes { id username name avatarUrl } }\n    reviewers(first: 20) { nodes { id username name avatarUrl } }\n    approvedBy(first: 20) { nodes { id username name avatarUrl } }\n    approvalsLeft\n    resolvableDiscussionsCount\n    resolvedDiscussionsCount\n    autoMergeEnabled\n    autoMergeStrategy\n    mergeUser { id username name avatarUrl }\n    mergeAfter\n    headPipeline {\n      id iid status\n      createdAt\n      path\n      stages(first: 20) { nodes {\n        name\n        jobs(first: 50) { nodes {\n          id name status\n          allowFailure\n          webPath\n          stage { name }\n        }}\n      }}\n    }\n  }\n";
 export declare class GitLabProvider implements GitProvider {
     readonly providerName: "gitlab";
     readonly baseURL: string;
@@ -17,6 +17,7 @@ export declare class GitLabProvider implements GitProvider {
     constructor(baseURL: string, token: string, options?: {
         logger?: ForgeLogger;
     });
+    readonly capabilities: ProviderCapabilities;
     validateToken(): Promise<UserRef>;
     /**
      * Fetch a single MR by project path and IID.
@@ -35,5 +36,21 @@ export declare class GitLabProvider implements GitProvider {
     createPullRequest(input: CreatePullRequestInput): Promise<PullRequest>;
     updatePullRequest(projectPath: string, mrIid: number, input: UpdatePullRequestInput): Promise<PullRequest>;
     restRequest(method: string, path: string, body?: unknown): Promise<Response>;
+    mergePullRequest(projectPath: string, mrIid: number, input?: MergePullRequestInput): Promise<PullRequest>;
+    approvePullRequest(projectPath: string, mrIid: number): Promise<void>;
+    unapprovePullRequest(projectPath: string, mrIid: number): Promise<void>;
+    rebasePullRequest(projectPath: string, mrIid: number): Promise<void>;
+    setAutoMerge(projectPath: string, mrIid: number): Promise<void>;
+    cancelAutoMerge(projectPath: string, mrIid: number): Promise<void>;
+    resolveDiscussion(projectPath: string, mrIid: number, discussionId: string): Promise<void>;
+    unresolveDiscussion(projectPath: string, mrIid: number, discussionId: string): Promise<void>;
+    retryPipeline(projectPath: string, pipelineId: number): Promise<void>;
+    requestReReview(projectPath: string, mrIid: number, _reviewerUsernames?: string[]): Promise<void>;
+    /**
+     * Retry `fetchSingleMR` with exponential backoff to handle REST→GraphQL
+     * eventual consistency. GitLab's GraphQL may not immediately reflect
+     * changes made via REST. 3 attempts: 0ms, 300ms, 600ms delay.
+     */
+    private fetchSingleMRWithRetry;
     private runQuery;
 }

package/dist/GitLabProvider.js

@@ -92,6 +92,10 @@ var MR_DASHBOARD_FRAGMENT = `
     approvalsLeft
     resolvableDiscussionsCount
     resolvedDiscussionsCount
+    autoMergeEnabled
+    autoMergeStrategy
+    mergeUser { id username name avatarUrl }
+    mergeAfter
     headPipeline {
       id iid status
       createdAt
@@ -212,7 +216,11 @@ function toMR(gql, role, baseURL) {
     approved: gql.approved ?? false,
     approvedBy: gql.approvedBy.nodes.map(toUserRef),
     diffStats,
-    detailedMergeStatus: gql.detailedMergeStatus ?? null
+    detailedMergeStatus: gql.detailedMergeStatus ?? null,
+    autoMergeEnabled: gql.autoMergeEnabled ?? false,
+    autoMergeStrategy: gql.autoMergeStrategy ?? null,
+    mergeUser: gql.mergeUser ? toUserRef(gql.mergeUser) : null,
+    mergeAfter: gql.mergeAfter ?? null
   };
 }
 var MR_DETAIL_QUERY = `
@@ -236,8 +244,20 @@ class GitLabProvider {
     this.baseURL = baseURL.replace(/\/$/, "");
     this.token = token;
     this.log = options.logger ?? noopLogger;
-    this.mrDetailFetcher = new MRDetailFetcher(this.baseURL, token, { logger: this.log });
+    this.mrDetailFetcher = new MRDetailFetcher(this.baseURL, token, {
+      logger: this.log
+    });
   }
+  capabilities = {
+    canMerge: true,
+    canApprove: true,
+    canUnapprove: true,
+    canRebase: true,
+    canAutoMerge: true,
+    canResolveDiscussions: true,
+    canRetryPipeline: true,
+    canRequestReReview: true
+  };
   async validateToken() {
     const url = `${this.baseURL}/api/v4/user`;
     const res = await fetch(url, {
@@ -343,7 +363,11 @@ class GitLabProvider {
       headers: { "PRIVATE-TOKEN": this.token }
     });
     if (!res.ok) {
-      this.log.warn("fetchPullRequestByBranch failed", { projectPath, sourceBranch, status: res.status });
+      this.log.warn("fetchPullRequestByBranch failed", {
+        projectPath,
+        sourceBranch,
+        status: res.status
+      });
       return null;
     }
     const mrs = await res.json();
@@ -381,10 +405,7 @@ class GitLabProvider {
       throw new Error(`createPullRequest failed: ${res.status} ${text}`);
     }
     const created = await res.json();
-    const pr = await this.fetchSingleMR(input.projectPath, created.iid, null);
-    if (!pr)
-      throw new Error("Created MR but failed to fetch it back");
-    return pr;
+    return this.fetchSingleMRWithRetry(input.projectPath, created.iid, "Created MR but failed to fetch it back");
   }
   async updatePullRequest(projectPath, mrIid, input) {
     const encoded = encodeURIComponent(projectPath);
@@ -417,10 +438,7 @@ class GitLabProvider {
       const text = await res.text();
       throw new Error(`updatePullRequest failed: ${res.status} ${text}`);
     }
-    const pr = await this.fetchSingleMR(projectPath, mrIid, null);
-    if (!pr)
-      throw new Error("Updated MR but failed to fetch it back");
-    return pr;
+    return this.fetchSingleMRWithRetry(projectPath, mrIid, "Updated MR but failed to fetch it back");
   }
   async restRequest(method, path, body) {
     const url = `${this.baseURL}${path}`;
@@ -436,6 +454,171 @@ class GitLabProvider {
       body: body !== undefined ? JSON.stringify(body) : undefined
     });
   }
+  async mergePullRequest(projectPath, mrIid, input) {
+    const encoded = encodeURIComponent(projectPath);
+    const body = {};
+    if (input?.commitMessage != null)
+      body.merge_commit_message = input.commitMessage;
+    if (input?.squashCommitMessage != null)
+      body.squash_commit_message = input.squashCommitMessage;
+    if (input?.squash != null)
+      body.squash = input.squash;
+    if (input?.shouldRemoveSourceBranch != null)
+      body.should_remove_source_branch = input.shouldRemoveSourceBranch;
+    if (input?.sha != null)
+      body.sha = input.sha;
+    if (input?.mergeMethod === "squash" && input?.squash == null)
+      body.squash = true;
+    const res = await fetch(`${this.baseURL}/api/v4/projects/${encoded}/merge_requests/${mrIid}/merge`, {
+      method: "PUT",
+      headers: {
+        "PRIVATE-TOKEN": this.token,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body)
+    });
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`mergePullRequest failed: ${res.status} ${text}`);
+    }
+    return this.fetchSingleMRWithRetry(projectPath, mrIid, "Merged MR but failed to fetch it back");
+  }
+  async approvePullRequest(projectPath, mrIid) {
+    const encoded = encodeURIComponent(projectPath);
+    const res = await fetch(`${this.baseURL}/api/v4/projects/${encoded}/merge_requests/${mrIid}/approve`, {
+      method: "POST",
+      headers: { "PRIVATE-TOKEN": this.token }
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(`approvePullRequest failed: ${res.status} ${res.statusText}${text ? ` — ${text}` : ""}`);
+    }
+  }
+  async unapprovePullRequest(projectPath, mrIid) {
+    const encoded = encodeURIComponent(projectPath);
+    const res = await fetch(`${this.baseURL}/api/v4/projects/${encoded}/merge_requests/${mrIid}/unapprove`, {
+      method: "POST",
+      headers: { "PRIVATE-TOKEN": this.token }
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(`unapprovePullRequest failed: ${res.status} ${res.statusText}${text ? ` — ${text}` : ""}`);
+    }
+  }
+  async rebasePullRequest(projectPath, mrIid) {
+    const encoded = encodeURIComponent(projectPath);
+    const res = await fetch(`${this.baseURL}/api/v4/projects/${encoded}/merge_requests/${mrIid}/rebase`, {
+      method: "PUT",
+      headers: { "PRIVATE-TOKEN": this.token }
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(`rebasePullRequest failed: ${res.status} ${res.statusText}${text ? ` — ${text}` : ""}`);
+    }
+  }
+  async setAutoMerge(projectPath, mrIid) {
+    const encoded = encodeURIComponent(projectPath);
+    const res = await fetch(`${this.baseURL}/api/v4/projects/${encoded}/merge_requests/${mrIid}/merge`, {
+      method: "PUT",
+      headers: {
+        "PRIVATE-TOKEN": this.token,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ merge_when_pipeline_succeeds: true })
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(`setAutoMerge failed: ${res.status} ${res.statusText}${text ? ` — ${text}` : ""}`);
+    }
+  }
+  async cancelAutoMerge(projectPath, mrIid) {
+    const encoded = encodeURIComponent(projectPath);
+    const res = await fetch(`${this.baseURL}/api/v4/projects/${encoded}/merge_requests/${mrIid}/cancel_merge_when_pipeline_succeeds`, {
+      method: "POST",
+      headers: { "PRIVATE-TOKEN": this.token }
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(`cancelAutoMerge failed: ${res.status} ${res.statusText}${text ? ` — ${text}` : ""}`);
+    }
+  }
+  async resolveDiscussion(projectPath, mrIid, discussionId) {
+    const encoded = encodeURIComponent(projectPath);
+    const res = await fetch(`${this.baseURL}/api/v4/projects/${encoded}/merge_requests/${mrIid}/discussions/${discussionId}`, {
+      method: "PUT",
+      headers: {
+        "PRIVATE-TOKEN": this.token,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ resolved: true })
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(`resolveDiscussion failed: ${res.status} ${res.statusText}${text ? ` — ${text}` : ""}`);
+    }
+  }
+  async unresolveDiscussion(projectPath, mrIid, discussionId) {
+    const encoded = encodeURIComponent(projectPath);
+    const res = await fetch(`${this.baseURL}/api/v4/projects/${encoded}/merge_requests/${mrIid}/discussions/${discussionId}`, {
+      method: "PUT",
+      headers: {
+        "PRIVATE-TOKEN": this.token,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ resolved: false })
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(`unresolveDiscussion failed: ${res.status} ${res.statusText}${text ? ` — ${text}` : ""}`);
+    }
+  }
+  async retryPipeline(projectPath, pipelineId) {
+    const encoded = encodeURIComponent(projectPath);
+    const res = await fetch(`${this.baseURL}/api/v4/projects/${encoded}/pipelines/${pipelineId}/retry`, {
+      method: "POST",
+      headers: { "PRIVATE-TOKEN": this.token }
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(`retryPipeline failed: ${res.status} ${res.statusText}${text ? ` — ${text}` : ""}`);
+    }
+  }
+  async requestReReview(projectPath, mrIid, _reviewerUsernames) {
+    const encoded = encodeURIComponent(projectPath);
+    const mrRes = await fetch(`${this.baseURL}/api/v4/projects/${encoded}/merge_requests/${mrIid}`, { headers: { "PRIVATE-TOKEN": this.token } });
+    if (!mrRes.ok) {
+      const text = await mrRes.text().catch(() => "");
+      throw new Error(`requestReReview: failed to fetch MR: ${mrRes.status}${text ? ` — ${text}` : ""}`);
+    }
+    const mr = await mrRes.json();
+    const reviewerIds = mr.reviewers?.map((r) => r.id) ?? [];
+    if (reviewerIds.length === 0) {
+      return;
+    }
+    const res = await fetch(`${this.baseURL}/api/v4/projects/${encoded}/merge_requests/${mrIid}`, {
+      method: "PUT",
+      headers: {
+        "PRIVATE-TOKEN": this.token,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ reviewer_ids: reviewerIds })
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(`requestReReview failed: ${res.status} ${res.statusText}${text ? ` — ${text}` : ""}`);
+    }
+  }
+  async fetchSingleMRWithRetry(projectPath, mrIid, errorMessage) {
+    for (let attempt = 0;attempt < 3; attempt++) {
+      if (attempt > 0) {
+        await new Promise((r) => setTimeout(r, attempt * 300));
+      }
+      const pr = await this.fetchSingleMR(projectPath, mrIid, null);
+      if (pr)
+        return pr;
+    }
+    throw new Error(errorMessage);
+  }
   async runQuery(query, variables) {
     const url = `${this.baseURL}/api/graphql`;
     const body = JSON.stringify({ query, variables: variables ?? {} });

package/dist/GitProvider.d.ts

@@ -1,4 +1,4 @@
-import type { BranchProtectionRule, CreatePullRequestInput, MRDetail, PullRequest, UpdatePullRequestInput, UserRef } from "./types.ts";
+import type { BranchProtectionRule, CreatePullRequestInput, MergePullRequestInput, MRDetail, ProviderCapabilities, PullRequest, UpdatePullRequestInput, UserRef } from './types.ts';
 /**
  * Provider-agnostic interface for a Git hosting service.
  *
@@ -54,6 +54,69 @@ export interface GitProvider {
      * Returns the MRDetail with discussions populated.
      */
     fetchMRDiscussions(repositoryId: string, mrIid: number): Promise<MRDetail>;
+    /**
+     * Reports which mutation operations this provider supports.
+     * Callers should check these flags to conditionally show/hide UI
+     * affordances without knowing which provider they're talking to.
+     */
+    readonly capabilities: ProviderCapabilities;
+    /**
+     * Merge (accept) a pull request / merge request.
+     * All input fields are optional — omitting them defers to the project's
+     * configured defaults (merge method, squash policy, delete-source-branch).
+     */
+    mergePullRequest(projectPath: string, mrIid: number, input?: MergePullRequestInput): Promise<PullRequest>;
+    /**
+     * Approve a pull request / merge request.
+     * On GitLab: POST /merge_requests/:iid/approve
+     * On GitHub: POST /pulls/:number/reviews with event "APPROVE"
+     */
+    approvePullRequest(projectPath: string, mrIid: number): Promise<void>;
+    /**
+     * Revoke an existing approval.
+     * GitLab-only — GitHub does not support unapproving via API.
+     * Check `capabilities.canUnapprove` before calling.
+     */
+    unapprovePullRequest(projectPath: string, mrIid: number): Promise<void>;
+    /**
+     * Rebase the MR source branch onto the target branch.
+     * GitLab-only — GitHub does not have a native rebase API.
+     * Check `capabilities.canRebase` before calling.
+     */
+    rebasePullRequest(projectPath: string, mrIid: number): Promise<void>;
+    /**
+     * Enable auto-merge: the MR will be merged automatically when the
+     * pipeline succeeds and all approval rules are met.
+     * GitLab-only — check `capabilities.canAutoMerge` before calling.
+     */
+    setAutoMerge(projectPath: string, mrIid: number): Promise<void>;
+    /**
+     * Cancel a previously enabled auto-merge.
+     * GitLab-only — check `capabilities.canAutoMerge` before calling.
+     */
+    cancelAutoMerge(projectPath: string, mrIid: number): Promise<void>;
+    /**
+     * Resolve a discussion thread on an MR.
+     * GitLab-only — check `capabilities.canResolveDiscussions` before calling.
+     */
+    resolveDiscussion(projectPath: string, mrIid: number, discussionId: string): Promise<void>;
+    /**
+     * Unresolve a previously resolved discussion thread.
+     * GitLab-only — check `capabilities.canResolveDiscussions` before calling.
+     */
+    unresolveDiscussion(projectPath: string, mrIid: number, discussionId: string): Promise<void>;
+    /**
+     * Retry a failed or canceled pipeline.
+     * On GitLab: POST /pipelines/:id/retry
+     * On GitHub: POST re-run for the workflow run.
+     */
+    retryPipeline(projectPath: string, pipelineId: number): Promise<void>;
+    /**
+     * Re-request review attention on an MR from its reviewers.
+     * If `reviewerUsernames` is provided, only those reviewers are pinged;
+     * otherwise all current reviewers are re-requested.
+     */
+    requestReReview(projectPath: string, mrIid: number, reviewerUsernames?: string[]): Promise<void>;
     /**
      * Make an authenticated REST API request to the provider.
      * Used for operations that don't have a typed method yet (job traces,

package/dist/index.d.ts

@@ -11,17 +11,17 @@
  * const provider = new GitLabProvider('https://gitlab.com', token, { logger: console });
  * const prs = await provider.fetchPullRequests();
  */
-export type { PullRequest, PullRequestsSnapshot, CreatePullRequestInput, UpdatePullRequestInput, BranchProtectionRule, Pipeline, PipelineJob, UserRef, DiffStats, Discussion, Note, NoteAuthor, NotePosition, MRDetail, FeedEvent, FeedSnapshot, ServerNotification, } from "./types.ts";
-export type { GitProvider } from "./GitProvider.ts";
-export { parseRepoId, repoIdProvider } from "./GitProvider.ts";
-export type { ForgeLogger } from "./logger.ts";
-export { noopLogger } from "./logger.ts";
-export { GitLabProvider, parseGitLabRepoId, MR_DASHBOARD_FRAGMENT } from "./GitLabProvider.ts";
-export { GitHubProvider } from "./GitHubProvider.ts";
-export { createProvider, SUPPORTED_PROVIDERS } from "./providers.ts";
-export type { ProviderSlug } from "./providers.ts";
-export { ActionCableClient } from "./ActionCableClient.ts";
-export type { ActionCableCallbacks } from "./ActionCableClient.ts";
-export { MRDetailFetcher } from "./MRDetailFetcher.ts";
-export { NoteMutator } from "./NoteMutator.ts";
-export type { CreatedNote } from "./NoteMutator.ts";
+export type { PullRequest, PullRequestsSnapshot, CreatePullRequestInput, UpdatePullRequestInput, MergePullRequestInput, MergeMethod, ProviderCapabilities, BranchProtectionRule, Pipeline, PipelineJob, UserRef, DiffStats, Discussion, Note, NoteAuthor, NotePosition, MRDetail, FeedEvent, FeedSnapshot, ServerNotification } from './types.ts';
+export type { GitProvider } from './GitProvider.ts';
+export { parseRepoId, repoIdProvider } from './GitProvider.ts';
+export type { ForgeLogger } from './logger.ts';
+export { noopLogger } from './logger.ts';
+export { GitLabProvider, parseGitLabRepoId, MR_DASHBOARD_FRAGMENT } from './GitLabProvider.ts';
+export { GitHubProvider } from './GitHubProvider.ts';
+export { createProvider, SUPPORTED_PROVIDERS } from './providers.ts';
+export type { ProviderSlug } from './providers.ts';
+export { ActionCableClient } from './ActionCableClient.ts';
+export type { ActionCableCallbacks } from './ActionCableClient.ts';
+export { MRDetailFetcher } from './MRDetailFetcher.ts';
+export { NoteMutator } from './NoteMutator.ts';
+export type { CreatedNote } from './NoteMutator.ts';