feat(sdk): Add mergePullRequest command for GitHub PR merging

[joedanz]

Summary

Introduces a new mergePullRequest command to the VibeKit SDK, enabling programmatic merging of GitHub pull requests. This command completes the GitHub workflow capabilities alongside existing createPullRequest and pushToBranch commands.

Changes

• Added mergePullRequest method to VibeKit SDK
• Added TypeScript type definitions (MergePullRequestOptions, MergePullRequestResult)
• Created API reference documentation
• Updated GitHub integration documentation

Implementation

await vibekit.mergePullRequest({
  pullNumber: number,
  mergeMethod?: 'merge' | 'squash' | 'rebase',
  commitTitle?: string,
  commitMessage?: string
})

Key features:

• Direct GitHub API integration (no agent/sandbox required)
• Supports all three GitHub merge methods
• Compliant with GitHub REST API v3 (2022-11-28)
• Comprehensive error handling for common scenarios

Files Modified

• packages/sdk/src/types.ts - Type definitions
• packages/sdk/src/core/vibekit.ts - Core implementation
• packages/sdk/src/index.ts - Public API exports
• docs/api-reference/merge-pull-request.mdx - API documentation
• docs/docs.json - Documentation navigation
• docs/sdk/github-integration.mdx - Usage examples

Testing

• Type checking: ✅ Passed
• SDK build: ✅ Successful
• Documentation: ✅ Complete

Breaking Changes

None

[vercel]

@joedanz is attempting to deploy a commit to the Superagent Team on Vercel.

A member of the Team first needs to authorize it.

[homanp]

@joedanz this looks good, one comment, would be cool if we could generate the commit messages automatically? Similar to createPullRequest

[joedanz]

@joedanz this looks good, one comment, would be cool if we could generate the commit messages automatically? Similar to createPullRequest

Good call, will do!

[joedanz]

Actually, this will be easier to complete after you merge #216 , that way we can keep similar patterns for Claude Code oAuth. Thanks!

[homanp]

@joedanz thanks for this, merging!