Github/merge
@hivemq/github/mergev2026.06.01.70
01README
GitHub pull-request and file-commit operations. Octokit-backed PR creation, merging, and fan-out across repos, plus gh-CLI-backed commitFile (branch creation + single-file commit) and openPullRequest (PR opening from an existing head→base pair) for one-shot file updates without a local checkout or token. dryRun supported on commitFile and openPullRequest.
02Models
@hivemq/github/mergev2026.05.21.1github_merge.ts
fn createPullRequest(repo: string, title: string, head: string, base: string)
Create a pull request in a GitHub repository
| Argument | Type | Description |
|---|---|---|
| repo | string | Repository name |
| title | string | PR title |
| head | string | Branch to merge from (head) |
| base | string | Branch to merge into (base) |
fn mergePullRequest(repo: string, pullNumber: number)
Merge an existing pull request by number
| Argument | Type | Description |
|---|---|---|
| repo | string | Repository name |
| pullNumber | number | Pull request number |
fn mergeBranch(repo: string, base: string)
Merge a branch directly into another via GitHub's Merges API (no PR required)
| Argument | Type | Description |
|---|---|---|
| repo | string | Repository name |
| base | string | Target branch (merge into) |
fn commitFile(repo: string, commitMessage: string)
Create a feature branch from base and commit a single file change. Uses local gh CLI — no token required. Pass dryRun=true to resolve the base branch but skip the branch + file writes. Pair with openPullRequest to open a PR from the resulting branch.
| Argument | Type | Description |
|---|---|---|
| repo | string | Repository name |
| commitMessage | string | Commit message |
fn openPullRequest(repo: string, head: string, base: string, title: string, body?: string)
Open a pull request from an existing head branch into a base branch. Uses local gh CLI — no token required. Pass dryRun=true to skip the PR creation. Typically chained after commitFile (head = commitFile newBranch, base = commitFile baseBranch).
| Argument | Type | Description |
|---|---|---|
| repo | string | Repository name |
| head | string | Branch to merge from (head) |
| base | string | Branch to merge into (base) |
| title | string | Pull request title |
| body? | string | Pull request body (Markdown) |
fn createPullRequestsAcrossRepos(repo: string, base: string, title: string)
Fan-out: create pull requests across multiple repositories in a single operation
| Argument | Type | Description |
|---|---|---|
| repo | string | Repository name |
| base | string | Target branch to merge into |
| title | string | PR title (same across all repos) |
Resources
pullRequest(infinite)— A GitHub pull request created or managed by this model
fileCommit(infinite)— Branch + single-file commit produced by commitFile. Downstream openPullRequest reads newBranch/baseBranch from here via CEL.
merge(infinite)— A completed branch merge or PR merge operation
03Stats
D
50 / 100
Downloads
0
Archive size
41.4 KB
- Has README or module doc0/2missing
- README has a code example0/1missing
- README is substantive0/1pending
- Most symbols documented1/1earned
- No slow types1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared0/1missing
- Verified public repository0/2missing
04Platforms
05Labels