diff --git a/README.md b/README.md
index 8c8bbc406..c253c4e06 100644
--- a/README.md
+++ b/README.md
@@ -7,7 +7,7 @@
One client, every forge.
-`forges` is a TypeScript library for working with issues, pull requests, notifications, checks and webhooks on twelve forges: GitHub, GitLab, Bitbucket, Forgejo, Gitea, Gitee, Azure DevOps, Cursor Origin, Tangled, Pushin.eu, Sourcehut and GitBucket. A forge is a service that hosts Git repositories and the collaboration around them. It also reads repositories and their contents from Git hosts without the collaboration, such as Cloudflare Artifacts. Each provider normalises the forge's responses into one data model and declares which operations it supports.
+`forges` is a TypeScript library for working with issues, pull requests, notifications, checks and webhooks on thirteen forges: GitHub, GitLab, Bitbucket, Forgejo, Gitea, Gitee, Azure DevOps, Cursor Origin, Tangled, Pushin.eu, Sourcehut, GitBucket and Upstream. A forge is a service that hosts Git repositories and the collaboration around them. It also reads repositories and their contents from Git hosts without the collaboration, such as Cloudflare Artifacts. Each provider normalises the forge's responses into one data model and declares which operations it supports.
Read the documentation at [forges.link](https://forges.link).
diff --git a/assets/providers/upstream.svg b/assets/providers/upstream.svg
new file mode 100644
index 000000000..a04114557
--- /dev/null
+++ b/assets/providers/upstream.svg
@@ -0,0 +1 @@
+
diff --git a/docs/app/assets/icons/upstream.svg b/docs/app/assets/icons/upstream.svg
new file mode 100644
index 000000000..1c2e7fd2b
--- /dev/null
+++ b/docs/app/assets/icons/upstream.svg
@@ -0,0 +1 @@
+
diff --git a/docs/content/1.getting-started/1.introduction.md b/docs/content/1.getting-started/1.introduction.md
index 180d01651..417262b59 100644
--- a/docs/content/1.getting-started/1.introduction.md
+++ b/docs/content/1.getting-started/1.introduction.md
@@ -10,7 +10,7 @@ Every forge has its own API, with its own endpoints, its own way of authenticati
## Supported forges
-`forges` supports GitHub, GitLab, Bitbucket Cloud, Forgejo, Gitea, Gitee, Azure DevOps, Cursor Origin, Tangled, Pushin.eu, Sourcehut and GitBucket. It also reads repositories and their contents from Git hosts with no issues or pull requests, such as Cloudflare Artifacts. Each of them has a [provider page](/providers) that explains how to authenticate and describes anything that behaves differently on that forge.
+`forges` supports GitHub, GitLab, Bitbucket Cloud, Forgejo, Gitea, Gitee, Azure DevOps, Cursor Origin, Tangled, Pushin.eu, Sourcehut, GitBucket and Upstream. It also reads repositories and their contents from Git hosts with no issues or pull requests, such as Cloudflare Artifacts. Each of them has a [provider page](/providers) that explains how to authenticate and describes anything that behaves differently on that forge.
## What you can build
diff --git a/docs/content/2.guides/3.environment.md b/docs/content/2.guides/3.environment.md
index f7fca4311..6655a3150 100644
--- a/docs/content/2.guides/3.environment.md
+++ b/docs/content/2.guides/3.environment.md
@@ -80,7 +80,7 @@ const forges = createForges(
## Variables
-In the variable names, `` is the name of the forge in upper case, with an underscore in place of a hyphen. That gives `GITHUB`, `GITLAB`, `BITBUCKET`, `FORGEJO`, `GITEA`, `GITEE`, `AZURE_DEVOPS`, `CURSOR_ORIGIN`, `TANGLED`, `PUSHIN`, `CLOUDFLARE_ARTIFACTS`, `SOURCEHUT` and `GITBUCKET`.
+In the variable names, `` is the name of the forge in upper case, with an underscore in place of a hyphen. That gives `GITHUB`, `GITLAB`, `BITBUCKET`, `FORGEJO`, `GITEA`, `GITEE`, `AZURE_DEVOPS`, `CURSOR_ORIGIN`, `TANGLED`, `PUSHIN`, `CLOUDFLARE_ARTIFACTS`, `SOURCEHUT`, `GITBUCKET` and `UPSTREAM`.
The following fields work for every forge. Most of them set the provider option of the same name, and the table describes what each one does:
diff --git a/docs/content/2.guides/7.pagination.md b/docs/content/2.guides/7.pagination.md
index a2c3aa1de..988f1c05e 100644
--- a/docs/content/2.guides/7.pagination.md
+++ b/docs/content/2.guides/7.pagination.md
@@ -87,46 +87,46 @@ Only the first page is conditional. A cursor with a `nextUrl` or a `token` reads
The table shows the listings whose first page carries an `etag` in a recording of the forge, and which the tests read again with it to get a page with `notModified`. Forges that aren't in the table send no ETag with their listings, or build each page from many requests, as Tangled does. GitLab's ETags are weak, and it responds `304` to them all the same.
-| Listing | GitHub | GitLab | Bitbucket | Gitee |
-| --- | --- | --- | --- | --- |
-| `ci.jobs` | ✅ | ✅ | ❌ | ❌ |
-| `ci.runs` | ✅ | ✅ | ❌ | ❌ |
-| `commits.comments` | ✅ | ✅ | ✅ | ❌ |
-| `commits.list` | ✅ | ✅ | ✅ | ✅ |
-| `contents.branches` | ✅ | ✅ | ✅ | ✅ |
-| `contents.tags` | ✅ | ✅ | ❌ | ✅ |
-| `contents.tree` | ❌ | ✅ | ✅ | ❌ |
-| `installations.list` | ✅ | ❌ | ❌ | ❌ |
-| `installations.repos` | ✅ | ❌ | ❌ | ❌ |
-| `notifications.list` | ✅ | ✅ | ❌ | ✅ |
-| `orgs.teamMembers` | ✅ | ✅ | ❌ | ❌ |
-| `orgs.teams` | ✅ | ✅ | ❌ | ❌ |
-| `releases.list` | ✅ | ✅ | ❌ | ✅ |
-| `repos.assignableUsers` | ✅ | ✅ | ❌ | ❌ |
-| `repos.byOwner` | ✅ | ✅ | ✅ | ✅ |
-| `repos.collaborators` | ✅ | ✅ | ❌ | ✅ |
-| `repos.contributors` | ✅ | ✅ | ❌ | ✅ |
-| `repos.events` | ✅ | ✅ | ❌ | ✅ |
-| `repos.labels` | ✅ | ✅ | ❌ | ✅ |
-| `repos.list` | ✅ | ✅ | ✅ | ✅ |
-| `repos.milestones` | ✅ | ✅ | ❌ | ❌ |
-| `repos.reviewerCandidates` | ✅ | ✅ | ❌ | ❌ |
-| `search.code` | ❌ | ✅ | ❌ | ❌ |
-| `search.commits` | ❌ | ✅ | ❌ | ❌ |
-| `search.repos` | ❌ | ✅ | ✅ | ✅ |
-| `search.threads` | ❌ | ❌ | ❌ | ✅ |
-| `securityAlerts.list` | ✅ | ❌ | ❌ | ❌ |
-| `threads.closingIssues` | ❌ | ✅ | ❌ | ❌ |
-| `threads.closingPullRequests` | ❌ | ✅ | ❌ | ❌ |
-| `threads.comments` | ✅ | ✅ | ✅ | ✅ |
-| `threads.commits` | ✅ | ✅ | ✅ | ✅ |
-| `threads.events` | ✅ | ✅ | ❌ | ❌ |
-| `threads.files` | ✅ | ✅ | ✅ | ✅ |
-| `threads.list` | ✅ | ✅ | ✅ | ✅ |
-| `threads.reactions` | ✅ | ✅ | ❌ | ❌ |
-| `users.events` | ✅ | ✅ | ❌ | ✅ |
-| `webhooks.deliveries` | ✅ | ❌ | ❌ | ❌ |
-| `webhooks.list` | ✅ | ✅ | ✅ | ❌ |
+| Listing | GitHub | GitLab | Bitbucket | Gitee | Upstream |
+| --- | --- | --- | --- | --- | --- |
+| `ci.jobs` | ✅ | ✅ | ❌ | ❌ | ❌ |
+| `ci.runs` | ✅ | ✅ | ❌ | ❌ | ✅ |
+| `commits.comments` | ✅ | ✅ | ✅ | ❌ | ❌ |
+| `commits.list` | ✅ | ✅ | ✅ | ✅ | ✅ |
+| `contents.branches` | ✅ | ✅ | ✅ | ✅ | ✅ |
+| `contents.tags` | ✅ | ✅ | ❌ | ✅ | ✅ |
+| `contents.tree` | ❌ | ✅ | ✅ | ❌ | ❌ |
+| `installations.list` | ✅ | ❌ | ❌ | ❌ | ❌ |
+| `installations.repos` | ✅ | ❌ | ❌ | ❌ | ❌ |
+| `notifications.list` | ✅ | ✅ | ❌ | ✅ | ✅ |
+| `orgs.teamMembers` | ✅ | ✅ | ❌ | ❌ | ❌ |
+| `orgs.teams` | ✅ | ✅ | ❌ | ❌ | ❌ |
+| `releases.list` | ✅ | ✅ | ❌ | ✅ | ✅ |
+| `repos.assignableUsers` | ✅ | ✅ | ❌ | ❌ | ✅ |
+| `repos.byOwner` | ✅ | ✅ | ✅ | ✅ | ✅ |
+| `repos.collaborators` | ✅ | ✅ | ❌ | ✅ | ❌ |
+| `repos.contributors` | ✅ | ✅ | ❌ | ✅ | ❌ |
+| `repos.events` | ✅ | ✅ | ❌ | ✅ | ✅ |
+| `repos.labels` | ✅ | ✅ | ❌ | ✅ | ✅ |
+| `repos.list` | ✅ | ✅ | ✅ | ✅ | ✅ |
+| `repos.milestones` | ✅ | ✅ | ❌ | ❌ | ❌ |
+| `repos.reviewerCandidates` | ✅ | ✅ | ❌ | ❌ | ❌ |
+| `search.code` | ❌ | ✅ | ❌ | ❌ | ✅ |
+| `search.commits` | ❌ | ✅ | ❌ | ❌ | ❌ |
+| `search.repos` | ❌ | ✅ | ✅ | ✅ | ✅ |
+| `search.threads` | ❌ | ❌ | ❌ | ✅ | ❌ |
+| `securityAlerts.list` | ✅ | ❌ | ❌ | ❌ | ❌ |
+| `threads.closingIssues` | ❌ | ✅ | ❌ | ❌ | ❌ |
+| `threads.closingPullRequests` | ❌ | ✅ | ❌ | ❌ | ❌ |
+| `threads.comments` | ✅ | ✅ | ✅ | ✅ | ✅ |
+| `threads.commits` | ✅ | ✅ | ✅ | ✅ | ✅ |
+| `threads.events` | ✅ | ✅ | ❌ | ❌ | ❌ |
+| `threads.files` | ✅ | ✅ | ✅ | ✅ | ✅ |
+| `threads.list` | ✅ | ✅ | ✅ | ✅ | ✅ |
+| `threads.reactions` | ✅ | ✅ | ❌ | ❌ | ✅ |
+| `users.events` | ✅ | ✅ | ❌ | ✅ | ❌ |
+| `webhooks.deliveries` | ✅ | ❌ | ❌ | ❌ | ❌ |
+| `webhooks.list` | ✅ | ✅ | ✅ | ❌ | ✅ |
The activity feeds of Tangled are conditional too, with an `etag` that the provider computes; see [Activity feeds](/providers/tangled#activity-feeds). A page has no `etag` in these cases, so every read of it is a full read:
diff --git a/docs/content/4.providers/index.md b/docs/content/4.providers/index.md
index 0163efad1..cb90a2a78 100644
--- a/docs/content/4.providers/index.md
+++ b/docs/content/4.providers/index.md
@@ -28,6 +28,7 @@ A provider is what connects `forges` to one particular forge. It translates the
| [Sourcehut](/providers/sourcehut) | `forges/sourcehut` | `sourcehut()` |
| [Entire](/providers/entire) | `forges/entire` | `entire()` |
| [GitBucket](/providers/gitbucket) | `forges/gitbucket` | `gitbucket()` |
+| [Upstream](/providers/upstream) | `forges/upstream` | `upstream()` |
::
diff --git a/docs/content/4.providers/upstream.md b/docs/content/4.providers/upstream.md
new file mode 100644
index 000000000..8fe95ede8
--- /dev/null
+++ b/docs/content/4.providers/upstream.md
@@ -0,0 +1,211 @@
+---
+title: Upstream
+description: "Use upstream.codes through the GitHub REST API it serves: issues, change requests, reviews, statuses, check runs, releases, notifications and webhooks."
+icon: i-custom-upstream
+---
+
+The Upstream provider works with [upstream.codes](https://upstream.codes). Upstream serves GitHub's REST API at `/api/v3`, so this provider runs the code of the [GitHub provider](/providers/github) against it and leaves out what Upstream doesn't serve. Upstream calls pull requests change requests, and they are `pull_request` threads here. Refs from this provider have `forge: 'upstream'`.
+
+
+
+::provider-header{provider="upstream"}
+| Detail | Value |
+| --- | --- |
+| Import | `forges/upstream` |
+| Factories | `upstream()` |
+| Auth | `token`, `anonymous` |
+::
+
+
+::note
+The capabilities on this page are verified against recordings of upstream.codes. To learn what the levels mean, see [Capabilities](/concepts/capabilities).
+::
+
+## Authentication
+
+The provider accepts a personal access token, which starts with `upt_`. Create one under [**Settings > API tokens**](https://upstream.codes/settings/tokens) and grant it the scopes for what you call, such as `issues:write` and `changes:write`:
+
+```ts
+import { upstream } from 'forges/upstream'
+
+const forge = upstream({
+ auth: { type: 'token', token: process.env.UPSTREAM_TOKEN! },
+})
+```
+
+If you leave out `auth`, the provider makes anonymous reads of public data. Upstream lists the users a thread can be assigned to only with a token.
+
+## Instance
+
+The provider talks to `https://upstream.codes/api/v3` by default. The same API is also served at `https://api.upstream.codes/api/v3`, and either host gives refs with `instance: 'upstream.codes'`, so links point at upstream.codes. To use another Upstream instance, set `baseUrl` to its root; the provider appends `/api/v3` itself.
+
+## Web URLs
+
+Upstream calls pull requests change requests and serves them at `/{owner}/{name}/changes/{number}`, which `urlFor()` builds and `parseUrl()` reads. Issues and change requests share one sequence of numbers. A release page is addressed by an id that the API doesn't return, so `urlFor()` has no link for a single release.
+
+## What Upstream leaves out
+
+Upstream has no GraphQL, so the operations that go through it on GitHub aren't supported: closing references, subscriptions, hiding comments, marking duplicates, review threads and committing files. Its REST API has no collaborators, contributors, teams, branch rules, timelines, commit comments, activity feeds of accounts, commit search or security alerts either. `support()` reports each of those as `false`, or as `'not_applicable'` for milestones and issue types, which Upstream doesn't have, and calling one rejects with `UnsupportedOperationError` before any request goes out. The [capability matrix](/reference/capability-matrix) has the full list.
+
+Discussions on Upstream aren't served through GitHub's API, so no operation takes a discussion.
+
+## Reviews
+
+Upstream stores approvals, change requests and comment reviews, but no pending reviews. `threads.approve()` works, and `threads.createReview()` works when you pass an `event`. Without one, it rejects with `UnsupportedOperationError`, and `threads.submitReview()` isn't supported. Upstream has no endpoint for the comments of one review or for replies to a review comment, so `threads.getReview()` reads the review from the list of the change request's reviews.
+
+## Updating a branch
+
+Upstream updates the branch of a change request only when the change request mirrors a GitHub pull request, so `threads.updateBranch()` isn't supported.
+
+## Releases
+
+Upstream creates no tag for a release, so push the tag, or create it with the git refs API, before `releases.create()`.
+
+## Notifications
+
+`notifications.markAllRead()` marks every notification read. Upstream can't mark only those of one repository, so passing `repo` rejects with `UnsupportedOperationError`. Upstream has no endpoint to unsubscribe from a notification thread.
+
+## Search
+
+Upstream searches code in one repository at a time, so `search.code()` needs a `repo` and rejects a search across an owner's repositories.
+
+## Webhooks
+
+Upstream signs its deliveries like GitHub, with `X-Hub-Signature-256`, and sends them under GitHub's event names, so `webhooks.verify()` and `webhooks.ingest()` work as they do on GitHub. Upstream keeps the deliveries of each hook, which `webhooks.deliveries()` lists.
+
+
+## Capabilities
+
+
+::provider-capabilities{provider="upstream"}
+| Capability | Support | Without credentials |
+| --- | --- | --- |
+| `experimental` | ❌ | ❌ |
+| `sources.stream` | ❌ | ❌ |
+| `repos.get` | ✅ | ✅ |
+| `users.get` | ✅ | ✅ |
+| `users.me` | ✅ | ❌ |
+| `users.sponsorable` | ∅ | ∅ |
+| `users.sponsorableMany` | ∅ | ∅ |
+| `users.events` | ❌ | ❌ |
+| `users.block` | ❌ | ❌ |
+| `repos.list` | ✅ | ❌ |
+| `repos.byOwner` | ✅ | ✅ |
+| `repos.labels` | ✅ | ✅ |
+| `repos.createLabel` | ✅ | ❌ |
+| `repos.milestones` | ∅ | ∅ |
+| `repos.issueTypes` | ∅ | ∅ |
+| `repos.collaborators` | ❌ | ❌ |
+| `repos.contributors` | ❌ | ❌ |
+| `repos.contributorStats` | ❌ | ❌ |
+| `repos.templates` | ✅ | ✅ |
+| `repos.permissionFor` | ❌ | ❌ |
+| `repos.branchRules` | ❌ | ❌ |
+| `repos.addCollaborator` | ❌ | ❌ |
+| `repos.assignableUsers` | ✅ | ❌ |
+| `repos.reviewerCandidates` | ❌ | ❌ |
+| `repos.events` | ✅ | ✅ |
+| `orgs.teams` | ❌ | ❌ |
+| `orgs.teamMembers` | ❌ | ❌ |
+| `orgs.block` | ❌ | ❌ |
+| `threads.get` | issue, PR | issue, PR |
+| `threads.list` | issue, PR | issue, PR |
+| `threads.getMany` | ✅ | ✅ |
+| `threads.closingIssues` | ❌ | ❌ |
+| `threads.closingPullRequests` | ❌ | ❌ |
+| `threads.events` | ❌ | ❌ |
+| `threads.comments` | issue, PR | issue, PR |
+| `threads.getComment` | issue, PR | issue (unverified), PR |
+| `threads.createComment` | issue, PR | ❌ |
+| `threads.updateComment` | issue, PR | ❌ |
+| `threads.deleteComment` | issue, PR | ❌ |
+| `threads.hideComment` | ❌ | ❌ |
+| `threads.reactions` | issue, PR | issue, PR |
+| `threads.react` | issue, PR | ❌ |
+| `threads.create` | issue, PR | ❌ |
+| `threads.update` | issue, PR | ❌ |
+| `threads.close` | issue, PR | ❌ |
+| `threads.reopen` | issue, PR | ❌ |
+| `threads.lock` | issue, PR | ❌ |
+| `threads.setLabels` | issue, PR | ❌ |
+| `threads.addLabels` | issue, PR | ❌ |
+| `threads.removeLabels` | issue, PR | ❌ |
+| `threads.setMilestone` | ∅ | ∅ |
+| `threads.setIssueType` | ∅ | ∅ |
+| `threads.setAssignees` | issue, PR | ❌ |
+| `threads.requestReview` | PR | ❌ |
+| `threads.merge` | ✅ | ❌ |
+| `threads.updateBranch` | ❌ | ❌ |
+| `threads.transfer` | ❌ | ❌ |
+| `threads.markDuplicate` | ❌ | ❌ |
+| `threads.subscription` | ❌ | ❌ |
+| `threads.subscribe` | ❌ | ❌ |
+| `threads.checks` | PR | PR |
+| `threads.files` | ✅ | ✅ |
+| `threads.commits` | ✅ | ✅ |
+| `threads.reviews` | ✅ | ✅ |
+| `threads.getReview` | emulated | emulated |
+| `threads.createReview` | ✅ | ❌ |
+| `threads.submitReview` | ❌ | ❌ |
+| `threads.approve` | ✅ | ❌ |
+| `threads.replyToReviewComment` | ❌ | ❌ |
+| `threads.reviewThreads` | ❌ | ❌ |
+| `threads.resolveReviewThread` | ❌ | ❌ |
+| `notifications.list` | ✅ | ❌ |
+| `notifications.markRead` | ✅ | ❌ |
+| `notifications.markDone` | ❌ | ❌ |
+| `notifications.unsubscribe` | ❌ | ❌ |
+| `notifications.markAllRead` | unverified | ❌ |
+| `notifications.markAllDone` | ❌ | ❌ |
+| `notifications.unreadCount` | ❌ | ❌ |
+| `installations.list` | ❌ | ❌ |
+| `checks.list` | ✅ | ✅ |
+| `checks.get` | unverified | unverified |
+| `checks.report` | ✅ | ❌ |
+| `checks.rerun` | unverified | ❌ |
+| `ci.runs` | ✅ | ✅ |
+| `ci.getRun` | unverified | unverified |
+| `ci.jobs` | unverified | unverified |
+| `ci.getJob` | unverified | unverified |
+| `ci.log` | ❌ | ❌ |
+| `ci.rerunFailed` | ❌ | ❌ |
+| `contents.getFile` | ✅ | ✅ |
+| `contents.tree` | ✅ | ✅ |
+| `contents.branches` | ✅ | ✅ |
+| `contents.tags` | ✅ | ✅ |
+| `contents.resolveRef` | ✅ | ✅ |
+| `contents.compare` | ✅ | ✅ |
+| `contents.commitFiles` | ❌ | ❌ |
+| `commits.list` | ✅ | ✅ |
+| `commits.get` | ✅ | ✅ |
+| `commits.comments` | ❌ | ❌ |
+| `commits.getComment` | ❌ | ❌ |
+| `commits.createComment` | ❌ | ❌ |
+| `commits.updateComment` | ❌ | ❌ |
+| `commits.deleteComment` | ❌ | ❌ |
+| `commits.hideComment` | ❌ | ❌ |
+| `releases.list` | ✅ | ✅ |
+| `releases.get` | ✅ | ✅ |
+| `releases.latest` | ✅ | ✅ |
+| `releases.getByTag` | ✅ | ✅ |
+| `releases.downloadAsset` | ✅ | ✅ |
+| `releases.create` | ✅ | ❌ |
+| `releases.update` | ✅ | ❌ |
+| `webhooks.ingest` | ✅ | ✅ |
+| `webhooks.list` | ✅ | ❌ |
+| `webhooks.create` | ✅ | ❌ |
+| `webhooks.update` | ✅ | ❌ |
+| `webhooks.delete` | ✅ | ❌ |
+| `webhooks.rotateSecret` | ✅ | ❌ |
+| `webhooks.deliveries` | ✅ | ❌ |
+| `webhooks.redeliver` | unverified | ❌ |
+| `search.threads` | ✅ | ✅ |
+| `search.repos` | ✅ | ✅ |
+| `search.commits` | ❌ | ❌ |
+| `search.code` | ✅ | ❌ |
+| `securityAlerts.list` | ❌ | ❌ |
+| `eventKinds` | native | native |
+| `authKinds` | `token`, `anonymous` | `token`, `anonymous` |
+| `limits` | body 65536, comment 65536, label 50 | body 65536, comment 65536, label 50 |
+::
+
diff --git a/docs/content/5.reference/11.capability-matrix.md b/docs/content/5.reference/11.capability-matrix.md
index 58eae505a..d4bb5dabd 100644
--- a/docs/content/5.reference/11.capability-matrix.md
+++ b/docs/content/5.reference/11.capability-matrix.md
@@ -11,135 +11,135 @@ To learn what each level of support means, see [Capabilities](/concepts/capabili
::capability-matrix
-| Capability | GitHub | GitLab | Bitbucket | Forgejo | Gitea | Gitee | Azure DevOps | Cursor Origin | Pushin.eu | Tangled | Cloudflare Artifacts | Sourcehut | Entire | GitBucket |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| `experimental` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ✅ | ✅ | ✅ | ❌ | ✅ | ❌ |
-| `sources.stream` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
-| `repos.get` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
-| `users.get` | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ✅ | ❌ | ✅ |
-| `users.me` | ✅ (only with `classic` or `fine-grained`) | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ |
-| `users.sponsorable` | ✅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ |
-| `users.sponsorableMany` | ✅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ |
-| `users.events` | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
-| `users.block` | ✅ (only with `classic` or `fine-grained`) | ❌ | ∅ | ✅ | ✅ | ❌ | ∅ | ∅ | ∅ | ∅ | ❌ | ❌ | ❌ | ∅ |
-| `repos.list` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
-| `repos.byOwner` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ |
-| `repos.labels` | ✅ | ✅ | ∅ | ✅ | ✅ | ✅ | ❌ | ❌ | ✅ | ✅ | ❌ | emulated | ∅ | ✅ |
-| `repos.createLabel` | ✅ | ✅ | ∅ | ✅ | ✅ | unverified | ❌ | experimental | ✅ | ✅ | ❌ | ❌ | ∅ | ✅ |
-| `repos.milestones` | ✅ | ✅ | ∅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ∅ | ✅ |
-| `repos.issueTypes` | ✅ | ❌ | ∅ | ∅ | ∅ | ❌ | ❌ | ∅ | ∅ | ∅ | ❌ | ❌ | ∅ | ∅ |
-| `repos.collaborators` | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ❌ | ❌ | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
-| `repos.contributors` | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `repos.contributorStats` | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `repos.templates` | ✅ | ✅ | ∅ | ✅ | ✅ | ❌ | ∅ | ∅ | ∅ | ∅ | ❌ | ❌ | ❌ | ✅ |
-| `repos.permissionFor` | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ | ❌ | emulated | ❌ | ❌ |
-| `repos.branchRules` | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `repos.addCollaborator` | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ | ❌ | ❌ | ✅ | ❌ |
-| `repos.assignableUsers` | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `repos.reviewerCandidates` | emulated | emulated | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ∅ |
-| `repos.events` | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `orgs.teams` | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ∅ |
-| `orgs.teamMembers` | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ∅ |
-| `orgs.block` | ✅ | ❌ | ∅ | ✅ | ✅ | ❌ | ∅ | ∅ | ∅ | ∅ | ❌ | ❌ | ❌ | ∅ |
-| `threads.get` | issue, PR, discussion | issue, PR | PR | issue, PR | issue, PR | issue, PR | issue, PR | PR (experimental) | issue, PR | issue, PR | ❌ | issue, PR | issue, PR | issue, PR |
-| `threads.list` | issue, PR, discussion | issue, PR | PR | issue, PR | issue, PR | issue, PR | issue, PR | PR (experimental) | issue, PR | issue, PR | ❌ | issue, PR | issue, PR | issue, PR |
-| `threads.getMany` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ |
-| `threads.closingIssues` | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `threads.closingPullRequests` | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `threads.events` | issue, PR, discussion | issue, PR | PR | issue, PR | issue, PR | issue, PR | issue, PR | PR (experimental) | issue (emulated), PR (emulated) | issue, PR | ❌ | issue, PR | issue, PR | ❌ |
-| `threads.comments` | issue, PR, discussion | issue, PR | PR | issue, PR | issue, PR | issue, PR | issue (experimental), PR | PR (experimental) | issue, PR | issue, PR | ❌ | issue, PR | issue, PR | issue, PR |
-| `threads.getComment` | issue, PR, discussion | issue, PR | PR (emulated) | issue, PR | issue, PR | issue (emulated), PR (emulated) | issue (experimental), PR | PR (unverified) | issue (emulated), PR (emulated) | issue (emulated), PR (emulated) | ❌ | issue (emulated), PR (emulated) | issue, PR | issue, PR |
-| `threads.createComment` | issue, PR, discussion | issue, PR | PR | issue, PR | issue, PR | issue (unverified), PR | issue (experimental), PR | PR (experimental) | issue, PR | issue, PR | ❌ | ❌ | issue, PR | issue, PR |
-| `threads.updateComment` | issue, PR, discussion | issue, PR | PR | issue, PR | issue, PR | issue (unverified), PR (unverified) | issue (experimental), PR | PR (experimental) | ∅ | issue, PR | ❌ | ❌ | issue, PR | issue, PR |
-| `threads.deleteComment` | issue, PR, discussion | issue, PR | PR | issue, PR | issue, PR | issue (unverified), PR (unverified) | issue (experimental), PR | PR (experimental) | ∅ | issue, PR | ❌ | ❌ | issue, PR | ❌ |
-| `threads.hideComment` | issue, PR, discussion | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ❌ | ❌ | ∅ | ∅ |
-| `threads.reactions` | issue, PR, discussion | issue, PR | ∅ | issue, PR | issue, PR | ❌ | ❌ | ❌ | ❌ | issue, PR | ❌ | ❌ | ∅ | ∅ |
-| `threads.react` | issue, PR, discussion | issue, PR | ∅ | issue, PR | issue, PR | ❌ | ❌ | ❌ | ∅ | issue, PR | ❌ | ❌ | ∅ | ∅ |
-| `threads.create` | issue, PR | issue, PR | PR | issue, PR | issue, PR | issue (unverified), PR (unverified) | issue, PR | PR (experimental) | issue, PR | issue, PR | ❌ | ❌ | issue, PR | issue, PR |
-| `threads.update` | issue, PR, discussion | issue, PR | PR | issue, PR | issue, PR | issue (unverified), PR | issue, PR | PR (experimental) | ∅ | issue, PR | ❌ | ❌ | issue, PR | PR |
-| `threads.close` | issue, PR, discussion | issue, PR | PR | issue, PR | issue, PR | issue (unverified), PR | issue, PR | PR (experimental) | ∅ | issue, PR | ❌ | ❌ | issue, PR | PR |
-| `threads.reopen` | issue, PR, discussion | issue, PR | ❌ | issue, PR | issue, PR | issue (unverified), PR | issue, PR | PR (experimental) | ∅ | issue, PR | ❌ | ❌ | issue, PR | PR |
-| `threads.lock` | issue, PR, discussion | issue, PR | ∅ | ∅ | issue, PR | ❌ | ∅ | ∅ | ∅ | ∅ | ❌ | ❌ | ∅ | ∅ |
-| `threads.setLabels` | issue, PR | issue, PR | ∅ | issue, PR | issue, PR | issue (unverified), PR (unverified) | issue, PR | PR (experimental) | ∅ | issue, PR | ❌ | ❌ | ∅ | issue, PR |
-| `threads.addLabels` | issue, PR | issue, PR | ∅ | issue, PR | issue, PR | issue (unverified), PR (unverified) | ❌ | ❌ | ∅ | issue, PR | ❌ | ❌ | ∅ | issue, PR |
-| `threads.removeLabels` | issue, PR | issue, PR | ∅ | issue, PR | issue, PR | issue (unverified), PR (unverified) | ❌ | ❌ | ∅ | issue, PR | ❌ | ❌ | ∅ | issue, PR |
-| `threads.setMilestone` | issue, PR | issue, PR | ∅ | issue, PR | issue, PR | ❌ | ❌ | ❌ | ∅ | ❌ | ❌ | ❌ | ∅ | ❌ |
-| `threads.setIssueType` | issue | ❌ | ∅ | ∅ | ∅ | ❌ | ❌ | ∅ | ∅ | ∅ | ❌ | ❌ | ∅ | ∅ |
-| `threads.setAssignees` | issue, PR | issue, PR | ❌ | issue, PR | issue, PR | issue (unverified) | issue | ❌ | ∅ | issue, PR | ❌ | ❌ | issue, PR | ❌ |
-| `threads.requestReview` | PR | PR | PR | PR | PR | PR (unverified) | PR | PR (experimental) | ∅ | ∅ | ❌ | ❌ | ❌ | ∅ |
-| `threads.merge` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ∅ | ✅ | ❌ | ❌ | ✅ | ✅ |
-| `threads.updateBranch` | ✅ | ✅ | ∅ | ✅ | ✅ | ❌ | ∅ | ∅ | ∅ | ∅ | ❌ | ❌ | ✅ | ❌ |
-| `threads.transfer` | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ∅ | ❌ | ❌ | ❌ | ∅ | ∅ |
-| `threads.markDuplicate` | ✅ | emulated | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ∅ | ❌ | ❌ | ❌ | ∅ | ∅ |
-| `threads.subscription` | issue, PR, discussion | issue, PR | ❌ | issue, PR | issue, PR | ❌ | ❌ | ❌ | ❌ | issue, PR | ❌ | issue | ❌ | ❌ |
-| `threads.subscribe` | issue, PR, discussion | issue, PR | ❌ | issue, PR | issue, PR | ❌ | ❌ | ❌ | ❌ | issue, PR | ❌ | ❌ | ❌ | ❌ |
-| `threads.checks` | PR | PR | PR | PR | PR | PR | PR (experimental) | PR (experimental) | ❌ | ∅ | ❌ | ❌ | ❌ | PR |
-| `threads.files` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | experimental | ❌ | ✅ | ❌ | ❌ | ✅ | ❌ |
-| `threads.commits` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ❌ | ✅ | ❌ | ❌ | ✅ | ✅ |
-| `threads.reviews` | ✅ | emulated | emulated | ✅ | ✅ | ∅ | emulated | experimental | ✅ | ∅ | ❌ | ❌ | ✅ | ❌ |
-| `threads.getReview` | ✅ | emulated | emulated | ✅ | ✅ | ∅ | emulated | emulated | ✅ | ∅ | ❌ | ❌ | ✅ | ❌ |
-| `threads.createReview` | ✅ | emulated | emulated | ✅ | ✅ | unverified | emulated | experimental | ❌ | ∅ | ❌ | ❌ | ✅ | ❌ |
-| `threads.submitReview` | ✅ | ❌ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ∅ | ❌ | ❌ | ❌ | ❌ |
-| `threads.approve` | ✅ | ✅ | emulated | ✅ | ✅ | unverified | emulated | experimental | ❌ | ∅ | ❌ | ❌ | ✅ | ❌ |
-| `threads.replyToReviewComment` | ✅ | ✅ | ❌ | ∅ | ✅ | ❌ | ❌ | ❌ | ✅ | ∅ | ❌ | ❌ | ✅ | ❌ |
-| `threads.reviewThreads` | ✅ | ✅ | ❌ | emulated | emulated | ❌ | ❌ | ❌ | ❌ | ∅ | ❌ | ❌ | ✅ | ❌ |
-| `threads.resolveReviewThread` | ✅ | ✅ | ❌ | ∅ | ∅ | ❌ | ✅ | unverified | ✅ | ∅ | ❌ | ❌ | ✅ | ❌ |
-| `notifications.list` | ✅ (only with `classic`) | ✅ | ∅ | ✅ | ✅ | ✅ | ❌ | ∅ | ✅ | experimental | ❌ | ❌ | ❌ | ❌ |
-| `notifications.markRead` | ✅ (only with `classic`) | ❌ | ∅ | ✅ | ✅ | ✅ | ❌ | ∅ | ∅ | experimental | ❌ | ❌ | ❌ | ❌ |
-| `notifications.markDone` | ✅ (only with `classic`) | ✅ | ∅ | emulated | emulated | ❌ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `notifications.unsubscribe` | ✅ (only with `classic`) | ✅ | ∅ | ✅ | ✅ | ❌ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `notifications.markAllRead` | ✅ (only with `classic`) | ❌ | ∅ | ✅ | ✅ | unverified | ❌ | ∅ | ∅ | unverified | ❌ | ❌ | ❌ | ❌ |
-| `notifications.markAllDone` | ❌ | ✅ | ∅ | ❌ | ❌ | ❌ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `notifications.unreadCount` | ❌ | ✅ | ∅ | ✅ | ✅ | ✅ | ❌ | ∅ | ❌ | unverified | ❌ | ❌ | ❌ | ❌ |
-| `installations.list` | ✅ (only with `installation` or `app`) | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | unverified (only with `app`) | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `checks.list` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ❌ | ∅ | ❌ | ❌ | ❌ | ✅ |
-| `checks.get` | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ∅ | ❌ | ❌ | ❌ | ∅ |
-| `checks.report` | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | ∅ | ❌ | ❌ | ❌ | ✅ |
-| `checks.rerun` | ✅ | ✅ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ❌ | ∅ | ❌ | ❌ | ❌ | ∅ |
-| `ci.runs` | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | emulated | ❌ | ∅ |
-| `ci.getRun` | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ∅ |
-| `ci.jobs` | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ∅ |
-| `ci.getJob` | ✅ | ✅ | ❌ | emulated | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | emulated | ❌ | ∅ |
-| `ci.log` | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ∅ |
-| `ci.rerunFailed` | ✅ | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ∅ |
-| `contents.getFile` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ |
-| `contents.tree` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ❌ | ✅ | ✅ | ✅ | ✅ | ❌ |
-| `contents.branches` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ❌ | ✅ | ❌ | ✅ | ✅ | ✅ |
-| `contents.tags` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ❌ | ✅ | ❌ | ✅ | ✅ | ✅ |
-| `contents.resolveRef` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ |
-| `contents.compare` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ❌ | ✅ | ❌ | ❌ | ✅ | ❌ |
-| `contents.commitFiles` | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `commits.list` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ |
-| `commits.get` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ |
-| `commits.comments` | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `commits.getComment` | ✅ | emulated | emulated | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `commits.createComment` | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `commits.updateComment` | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `commits.deleteComment` | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `commits.hideComment` | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ∅ |
-| `releases.list` | ✅ | ✅ | ∅ | ✅ | ✅ | ✅ | ❌ | ∅ | ✅ | ∅ | ❌ | emulated | ∅ | ✅ |
-| `releases.get` | ✅ | ✅ | ∅ | ✅ | ✅ | ✅ | ❌ | ∅ | ✅ | ∅ | ❌ | emulated | ∅ | ✅ |
-| `releases.latest` | ✅ | ✅ | ∅ | ✅ | ✅ | ✅ | ❌ | ∅ | ✅ | ∅ | ❌ | emulated | ∅ | ✅ |
-| `releases.getByTag` | ✅ | ✅ | ∅ | ✅ | ✅ | ✅ | ❌ | ∅ | ✅ | ∅ | ❌ | emulated | ∅ | ✅ |
-| `releases.downloadAsset` | ✅ | ❌ | ∅ | ✅ | ✅ | ❌ | ❌ | ∅ | ✅ | ∅ | ❌ | emulated | ∅ | ❌ |
-| `releases.create` | ✅ | ✅ | ∅ | ✅ | ✅ | ❌ | ❌ | ∅ | ✅ | ∅ | ❌ | ❌ | ∅ | ❌ |
-| `releases.update` | ✅ | ✅ | ∅ | ✅ | ✅ | ❌ | ❌ | ∅ | ✅ | ∅ | ❌ | ❌ | ∅ | ❌ |
-| `webhooks.ingest` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ∅ | ✅ | ❌ | ✅ | ❌ | ✅ |
-| `webhooks.list` | ✅ | ✅ | ✅ | ✅ | ✅ | unverified | ❌ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ✅ |
-| `webhooks.create` | ✅ | ✅ | ✅ | ✅ | ✅ | unverified | ❌ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ✅ |
-| `webhooks.update` | ✅ | ✅ | ✅ | ✅ | ✅ | unverified | ❌ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ❌ |
-| `webhooks.delete` | ✅ | ✅ | ✅ | ✅ | ✅ | unverified | ❌ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ✅ |
-| `webhooks.rotateSecret` | ✅ | ✅ | ✅ | ✅ | ✅ | unverified | ∅ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ❌ |
-| `webhooks.deliveries` | ✅ | ❌ | ∅ | ∅ | ∅ | ∅ | ∅ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ❌ |
-| `webhooks.redeliver` | ✅ | ❌ | ∅ | ∅ | ∅ | ∅ | ∅ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ❌ |
-| `search.threads` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `search.repos` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | emulated | ❌ | ❌ |
-| `search.commits` | ✅ | experimental | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `search.code` | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | experimental | ❌ | ❌ |
-| `securityAlerts.list` | dependency, code scanning, secret, advisory | dependency, code scanning, secret | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ∅ | ❌ | ❌ | ❌ | ∅ |
-| `eventKinds` | native | heuristic | native | native | native | native | native | native | native | native | native | native | native | native |
-| `authKinds` | `token`, `app`, `anonymous` | `token`, `anonymous` | `token`, `basic`, `anonymous` | `token`, `anonymous` | `token`, `anonymous` | `token`, `anonymous` | `token`, `basic`, `anonymous` | `token`, `app`, `anonymous` | `token`, `anonymous` | `anonymous`, `app_password`, `oauth` | `token` | `token` | `token` | `token`, `anonymous` |
-| `limits` | body 65536, comment 65536, label 50 | body 1048576, comment 1000000, label 255 | unknown | unknown | unknown | unknown | unknown | unknown | unknown | unknown | unknown | unknown | unknown | body 65536, comment 65536, label 50 |
+| Capability | GitHub | GitLab | Bitbucket | Forgejo | Gitea | Gitee | Azure DevOps | Cursor Origin | Pushin.eu | Tangled | Cloudflare Artifacts | Sourcehut | Entire | GitBucket | Upstream |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| `experimental` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ✅ | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ |
+| `sources.stream` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `repos.get` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| `users.get` | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ✅ | ❌ | ✅ | ✅ |
+| `users.me` | ✅ (only with `classic` or `fine-grained`) | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ |
+| `users.sponsorable` | ✅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ |
+| `users.sponsorableMany` | ✅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ |
+| `users.events` | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `users.block` | ✅ (only with `classic` or `fine-grained`) | ❌ | ∅ | ✅ | ✅ | ❌ | ∅ | ∅ | ∅ | ∅ | ❌ | ❌ | ❌ | ∅ | ❌ |
+| `repos.list` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ✅ |
+| `repos.byOwner` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| `repos.labels` | ✅ | ✅ | ∅ | ✅ | ✅ | ✅ | ❌ | ❌ | ✅ | ✅ | ❌ | emulated | ∅ | ✅ | ✅ |
+| `repos.createLabel` | ✅ | ✅ | ∅ | ✅ | ✅ | unverified | ❌ | experimental | ✅ | ✅ | ❌ | ❌ | ∅ | ✅ | ✅ |
+| `repos.milestones` | ✅ | ✅ | ∅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ∅ | ✅ | ∅ |
+| `repos.issueTypes` | ✅ | ❌ | ∅ | ∅ | ∅ | ❌ | ❌ | ∅ | ∅ | ∅ | ❌ | ❌ | ∅ | ∅ | ∅ |
+| `repos.collaborators` | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ❌ | ❌ | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ |
+| `repos.contributors` | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `repos.contributorStats` | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `repos.templates` | ✅ | ✅ | ∅ | ✅ | ✅ | ❌ | ∅ | ∅ | ∅ | ∅ | ❌ | ❌ | ❌ | ✅ | ✅ |
+| `repos.permissionFor` | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ | ❌ | emulated | ❌ | ❌ | ❌ |
+| `repos.branchRules` | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `repos.addCollaborator` | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ |
+| `repos.assignableUsers` | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |
+| `repos.reviewerCandidates` | emulated | emulated | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ∅ | ❌ |
+| `repos.events` | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |
+| `orgs.teams` | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ∅ | ❌ |
+| `orgs.teamMembers` | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ∅ | ❌ |
+| `orgs.block` | ✅ | ❌ | ∅ | ✅ | ✅ | ❌ | ∅ | ∅ | ∅ | ∅ | ❌ | ❌ | ❌ | ∅ | ❌ |
+| `threads.get` | issue, PR, discussion | issue, PR | PR | issue, PR | issue, PR | issue, PR | issue, PR | PR (experimental) | issue, PR | issue, PR | ❌ | issue, PR | issue, PR | issue, PR | issue, PR |
+| `threads.list` | issue, PR, discussion | issue, PR | PR | issue, PR | issue, PR | issue, PR | issue, PR | PR (experimental) | issue, PR | issue, PR | ❌ | issue, PR | issue, PR | issue, PR | issue, PR |
+| `threads.getMany` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ |
+| `threads.closingIssues` | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `threads.closingPullRequests` | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `threads.events` | issue, PR, discussion | issue, PR | PR | issue, PR | issue, PR | issue, PR | issue, PR | PR (experimental) | issue (emulated), PR (emulated) | issue, PR | ❌ | issue, PR | issue, PR | ❌ | ❌ |
+| `threads.comments` | issue, PR, discussion | issue, PR | PR | issue, PR | issue, PR | issue, PR | issue (experimental), PR | PR (experimental) | issue, PR | issue, PR | ❌ | issue, PR | issue, PR | issue, PR | issue, PR |
+| `threads.getComment` | issue, PR, discussion | issue, PR | PR (emulated) | issue, PR | issue, PR | issue (emulated), PR (emulated) | issue (experimental), PR | PR (unverified) | issue (emulated), PR (emulated) | issue (emulated), PR (emulated) | ❌ | issue (emulated), PR (emulated) | issue, PR | issue, PR | issue, PR |
+| `threads.createComment` | issue, PR, discussion | issue, PR | PR | issue, PR | issue, PR | issue (unverified), PR | issue (experimental), PR | PR (experimental) | issue, PR | issue, PR | ❌ | ❌ | issue, PR | issue, PR | issue, PR |
+| `threads.updateComment` | issue, PR, discussion | issue, PR | PR | issue, PR | issue, PR | issue (unverified), PR (unverified) | issue (experimental), PR | PR (experimental) | ∅ | issue, PR | ❌ | ❌ | issue, PR | issue, PR | issue, PR |
+| `threads.deleteComment` | issue, PR, discussion | issue, PR | PR | issue, PR | issue, PR | issue (unverified), PR (unverified) | issue (experimental), PR | PR (experimental) | ∅ | issue, PR | ❌ | ❌ | issue, PR | ❌ | issue, PR |
+| `threads.hideComment` | issue, PR, discussion | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ∅ | ❌ | ❌ | ∅ | ∅ | ❌ |
+| `threads.reactions` | issue, PR, discussion | issue, PR | ∅ | issue, PR | issue, PR | ❌ | ❌ | ❌ | ❌ | issue, PR | ❌ | ❌ | ∅ | ∅ | issue, PR |
+| `threads.react` | issue, PR, discussion | issue, PR | ∅ | issue, PR | issue, PR | ❌ | ❌ | ❌ | ∅ | issue, PR | ❌ | ❌ | ∅ | ∅ | issue, PR |
+| `threads.create` | issue, PR | issue, PR | PR | issue, PR | issue, PR | issue (unverified), PR (unverified) | issue, PR | PR (experimental) | issue, PR | issue, PR | ❌ | ❌ | issue, PR | issue, PR | issue, PR |
+| `threads.update` | issue, PR, discussion | issue, PR | PR | issue, PR | issue, PR | issue (unverified), PR | issue, PR | PR (experimental) | ∅ | issue, PR | ❌ | ❌ | issue, PR | PR | issue, PR |
+| `threads.close` | issue, PR, discussion | issue, PR | PR | issue, PR | issue, PR | issue (unverified), PR | issue, PR | PR (experimental) | ∅ | issue, PR | ❌ | ❌ | issue, PR | PR | issue, PR |
+| `threads.reopen` | issue, PR, discussion | issue, PR | ❌ | issue, PR | issue, PR | issue (unverified), PR | issue, PR | PR (experimental) | ∅ | issue, PR | ❌ | ❌ | issue, PR | PR | issue, PR |
+| `threads.lock` | issue, PR, discussion | issue, PR | ∅ | ∅ | issue, PR | ❌ | ∅ | ∅ | ∅ | ∅ | ❌ | ❌ | ∅ | ∅ | issue, PR |
+| `threads.setLabels` | issue, PR | issue, PR | ∅ | issue, PR | issue, PR | issue (unverified), PR (unverified) | issue, PR | PR (experimental) | ∅ | issue, PR | ❌ | ❌ | ∅ | issue, PR | issue, PR |
+| `threads.addLabels` | issue, PR | issue, PR | ∅ | issue, PR | issue, PR | issue (unverified), PR (unverified) | ❌ | ❌ | ∅ | issue, PR | ❌ | ❌ | ∅ | issue, PR | issue, PR |
+| `threads.removeLabels` | issue, PR | issue, PR | ∅ | issue, PR | issue, PR | issue (unverified), PR (unverified) | ❌ | ❌ | ∅ | issue, PR | ❌ | ❌ | ∅ | issue, PR | issue, PR |
+| `threads.setMilestone` | issue, PR | issue, PR | ∅ | issue, PR | issue, PR | ❌ | ❌ | ❌ | ∅ | ❌ | ❌ | ❌ | ∅ | ❌ | ∅ |
+| `threads.setIssueType` | issue | ❌ | ∅ | ∅ | ∅ | ❌ | ❌ | ∅ | ∅ | ∅ | ❌ | ❌ | ∅ | ∅ | ∅ |
+| `threads.setAssignees` | issue, PR | issue, PR | ❌ | issue, PR | issue, PR | issue (unverified) | issue | ❌ | ∅ | issue, PR | ❌ | ❌ | issue, PR | ❌ | issue, PR |
+| `threads.requestReview` | PR | PR | PR | PR | PR | PR (unverified) | PR | PR (experimental) | ∅ | ∅ | ❌ | ❌ | ❌ | ∅ | PR |
+| `threads.merge` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ∅ | ✅ | ❌ | ❌ | ✅ | ✅ | ✅ |
+| `threads.updateBranch` | ✅ | ✅ | ∅ | ✅ | ✅ | ❌ | ∅ | ∅ | ∅ | ∅ | ❌ | ❌ | ✅ | ❌ | ❌ |
+| `threads.transfer` | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ∅ | ❌ | ❌ | ❌ | ∅ | ∅ | ❌ |
+| `threads.markDuplicate` | ✅ | emulated | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ∅ | ❌ | ❌ | ❌ | ∅ | ∅ | ❌ |
+| `threads.subscription` | issue, PR, discussion | issue, PR | ❌ | issue, PR | issue, PR | ❌ | ❌ | ❌ | ❌ | issue, PR | ❌ | issue | ❌ | ❌ | ❌ |
+| `threads.subscribe` | issue, PR, discussion | issue, PR | ❌ | issue, PR | issue, PR | ❌ | ❌ | ❌ | ❌ | issue, PR | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `threads.checks` | PR | PR | PR | PR | PR | PR | PR (experimental) | PR (experimental) | ❌ | ∅ | ❌ | ❌ | ❌ | PR | PR |
+| `threads.files` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | experimental | ❌ | ✅ | ❌ | ❌ | ✅ | ❌ | ✅ |
+| `threads.commits` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ❌ | ✅ | ❌ | ❌ | ✅ | ✅ | ✅ |
+| `threads.reviews` | ✅ | emulated | emulated | ✅ | ✅ | ∅ | emulated | experimental | ✅ | ∅ | ❌ | ❌ | ✅ | ❌ | ✅ |
+| `threads.getReview` | ✅ | emulated | emulated | ✅ | ✅ | ∅ | emulated | emulated | ✅ | ∅ | ❌ | ❌ | ✅ | ❌ | emulated |
+| `threads.createReview` | ✅ | emulated | emulated | ✅ | ✅ | unverified | emulated | experimental | ❌ | ∅ | ❌ | ❌ | ✅ | ❌ | ✅ |
+| `threads.submitReview` | ✅ | ❌ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ∅ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `threads.approve` | ✅ | ✅ | emulated | ✅ | ✅ | unverified | emulated | experimental | ❌ | ∅ | ❌ | ❌ | ✅ | ❌ | ✅ |
+| `threads.replyToReviewComment` | ✅ | ✅ | ❌ | ∅ | ✅ | ❌ | ❌ | ❌ | ✅ | ∅ | ❌ | ❌ | ✅ | ❌ | ❌ |
+| `threads.reviewThreads` | ✅ | ✅ | ❌ | emulated | emulated | ❌ | ❌ | ❌ | ❌ | ∅ | ❌ | ❌ | ✅ | ❌ | ❌ |
+| `threads.resolveReviewThread` | ✅ | ✅ | ❌ | ∅ | ∅ | ❌ | ✅ | unverified | ✅ | ∅ | ❌ | ❌ | ✅ | ❌ | ❌ |
+| `notifications.list` | ✅ (only with `classic`) | ✅ | ∅ | ✅ | ✅ | ✅ | ❌ | ∅ | ✅ | experimental | ❌ | ❌ | ❌ | ❌ | ✅ |
+| `notifications.markRead` | ✅ (only with `classic`) | ❌ | ∅ | ✅ | ✅ | ✅ | ❌ | ∅ | ∅ | experimental | ❌ | ❌ | ❌ | ❌ | ✅ |
+| `notifications.markDone` | ✅ (only with `classic`) | ✅ | ∅ | emulated | emulated | ❌ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `notifications.unsubscribe` | ✅ (only with `classic`) | ✅ | ∅ | ✅ | ✅ | ❌ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `notifications.markAllRead` | ✅ (only with `classic`) | ❌ | ∅ | ✅ | ✅ | unverified | ❌ | ∅ | ∅ | unverified | ❌ | ❌ | ❌ | ❌ | unverified |
+| `notifications.markAllDone` | ❌ | ✅ | ∅ | ❌ | ❌ | ❌ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `notifications.unreadCount` | ❌ | ✅ | ∅ | ✅ | ✅ | ✅ | ❌ | ∅ | ❌ | unverified | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `installations.list` | ✅ (only with `installation` or `app`) | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | unverified (only with `app`) | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `checks.list` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ❌ | ∅ | ❌ | ❌ | ❌ | ✅ | ✅ |
+| `checks.get` | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ∅ | ❌ | ❌ | ❌ | ∅ | unverified |
+| `checks.report` | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | ∅ | ❌ | ❌ | ❌ | ✅ | ✅ |
+| `checks.rerun` | ✅ | ✅ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ❌ | ∅ | ❌ | ❌ | ❌ | ∅ | unverified |
+| `ci.runs` | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | emulated | ❌ | ∅ | ✅ |
+| `ci.getRun` | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ∅ | unverified |
+| `ci.jobs` | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ∅ | unverified |
+| `ci.getJob` | ✅ | ✅ | ❌ | emulated | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | emulated | ❌ | ∅ | unverified |
+| `ci.log` | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ∅ | ❌ |
+| `ci.rerunFailed` | ✅ | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ∅ | ❌ |
+| `contents.getFile` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| `contents.tree` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ❌ | ✅ | ✅ | ✅ | ✅ | ❌ | ✅ |
+| `contents.branches` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ❌ | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ |
+| `contents.tags` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ❌ | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ |
+| `contents.resolveRef` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| `contents.compare` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ❌ | ✅ | ❌ | ❌ | ✅ | ❌ | ✅ |
+| `contents.commitFiles` | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `commits.list` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| `commits.get` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | experimental | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| `commits.comments` | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `commits.getComment` | ✅ | emulated | emulated | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `commits.createComment` | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `commits.updateComment` | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `commits.deleteComment` | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `commits.hideComment` | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ∅ | ❌ |
+| `releases.list` | ✅ | ✅ | ∅ | ✅ | ✅ | ✅ | ❌ | ∅ | ✅ | ∅ | ❌ | emulated | ∅ | ✅ | ✅ |
+| `releases.get` | ✅ | ✅ | ∅ | ✅ | ✅ | ✅ | ❌ | ∅ | ✅ | ∅ | ❌ | emulated | ∅ | ✅ | ✅ |
+| `releases.latest` | ✅ | ✅ | ∅ | ✅ | ✅ | ✅ | ❌ | ∅ | ✅ | ∅ | ❌ | emulated | ∅ | ✅ | ✅ |
+| `releases.getByTag` | ✅ | ✅ | ∅ | ✅ | ✅ | ✅ | ❌ | ∅ | ✅ | ∅ | ❌ | emulated | ∅ | ✅ | ✅ |
+| `releases.downloadAsset` | ✅ | ❌ | ∅ | ✅ | ✅ | ❌ | ❌ | ∅ | ✅ | ∅ | ❌ | emulated | ∅ | ❌ | ✅ |
+| `releases.create` | ✅ | ✅ | ∅ | ✅ | ✅ | ❌ | ❌ | ∅ | ✅ | ∅ | ❌ | ❌ | ∅ | ❌ | ✅ |
+| `releases.update` | ✅ | ✅ | ∅ | ✅ | ✅ | ❌ | ❌ | ∅ | ✅ | ∅ | ❌ | ❌ | ∅ | ❌ | ✅ |
+| `webhooks.ingest` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ∅ | ✅ | ❌ | ✅ | ❌ | ✅ | ✅ |
+| `webhooks.list` | ✅ | ✅ | ✅ | ✅ | ✅ | unverified | ❌ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ✅ | ✅ |
+| `webhooks.create` | ✅ | ✅ | ✅ | ✅ | ✅ | unverified | ❌ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ✅ | ✅ |
+| `webhooks.update` | ✅ | ✅ | ✅ | ✅ | ✅ | unverified | ❌ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ❌ | ✅ |
+| `webhooks.delete` | ✅ | ✅ | ✅ | ✅ | ✅ | unverified | ❌ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ✅ | ✅ |
+| `webhooks.rotateSecret` | ✅ | ✅ | ✅ | ✅ | ✅ | unverified | ∅ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ❌ | ✅ |
+| `webhooks.deliveries` | ✅ | ❌ | ∅ | ∅ | ∅ | ∅ | ∅ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ❌ | ✅ |
+| `webhooks.redeliver` | ✅ | ❌ | ∅ | ∅ | ∅ | ∅ | ∅ | ❌ | ∅ | ∅ | ❌ | ❌ | ❌ | ❌ | unverified |
+| `search.threads` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |
+| `search.repos` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | emulated | ❌ | ❌ | ✅ |
+| `search.commits` | ✅ | experimental | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `search.code` | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | experimental | ❌ | ❌ | ✅ |
+| `securityAlerts.list` | dependency, code scanning, secret, advisory | dependency, code scanning, secret | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ∅ | ❌ | ❌ | ❌ | ∅ | ❌ |
+| `eventKinds` | native | heuristic | native | native | native | native | native | native | native | native | native | native | native | native | native |
+| `authKinds` | `token`, `app`, `anonymous` | `token`, `anonymous` | `token`, `basic`, `anonymous` | `token`, `anonymous` | `token`, `anonymous` | `token`, `anonymous` | `token`, `basic`, `anonymous` | `token`, `app`, `anonymous` | `token`, `anonymous` | `anonymous`, `app_password`, `oauth` | `token` | `token` | `token` | `token`, `anonymous` | `token`, `anonymous` |
+| `limits` | body 65536, comment 65536, label 50 | body 1048576, comment 1000000, label 255 | unknown | unknown | unknown | unknown | unknown | unknown | unknown | unknown | unknown | unknown | unknown | body 65536, comment 65536, label 50 | body 65536, comment 65536, label 50 |
Each cell shows the best support of any credential. Where support depends on the kind of credential, a cell names the credentials that have it, unless they are the forge's usual ones: `classic`, `fine-grained` or `installation` on GitHub and `token` or `installation` on Cursor Origin.
diff --git a/docs/content/5.reference/12.events.md b/docs/content/5.reference/12.events.md
index 83bbb545b..abbb706f7 100644
--- a/docs/content/5.reference/12.events.md
+++ b/docs/content/5.reference/12.events.md
@@ -17,29 +17,29 @@ const labels = provider.webhooks.events.some(
::event-matrix
-| Kind | GitHub | GitLab | Bitbucket | Forgejo | Gitea | Gitee | Azure DevOps | Cursor Origin | Tangled | Sourcehut | GitBucket |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| `comment` | `created`, `edited`, `deleted` | `created` | `created`, `edited`, `deleted` | `created`, `edited`, `deleted` | `created`, `edited`, `deleted` | `created` | `created` | `created` | `created` | ❌ | `created` |
-| `review` | `submitted` | `submitted` | `submitted` | `submitted` | `submitted` | ❌ | `submitted` | `submitted` | ❌ | ❌ | ❌ |
-| `review_comment` | `created`, `edited`, `deleted` | `created` | `created`, `edited`, `deleted` | `created` | `created` | ❌ | ❌ | ❌ | ❌ | ❌ | `created` |
-| `commit` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `label` | `labelled`, `unlabelled` | `labelled`, `unlabelled` | ❌ | `edited`, `unlabelled` | `edited`, `unlabelled` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `state_change` | `opened`, `closed`, `reopened`, `merged`, `ready_for_review`, `converted_to_draft` | `opened`, `closed`, `reopened`, `merged` | `opened`, `closed`, `merged` | `opened`, `closed`, `reopened`, `merged` | `opened`, `closed`, `reopened`, `merged` | `opened`, `closed`, `reopened`, `merged` | `opened`, `closed`, `merged` | `opened`, `closed`, `merged` | `opened`, `closed`, `merged` | ❌ | `opened`, `closed`, `reopened`, `merged` |
-| `assignment` | `assigned`, `unassigned`, `review_requested` | `assigned`, `unassigned`, `review_requested` | ❌ | `assigned`, `unassigned` | `assigned`, `unassigned` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `mention` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `referenced` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `reaction` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `push` | any | any | any | any | any | any | any | ❌ | any | any | any |
-| `ref` | `created`, `deleted` | `created`, `deleted` | `created`, `deleted` | `created`, `deleted` | `created`, `deleted` | `created`, `deleted` | ❌ | ❌ | ❌ | ❌ | `created` |
-| `repo` | `renamed`, `transferred`, `archived`, `unarchived`, `edited` | ❌ | `renamed`, `transferred` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | `created`, `edited`, `deleted` | ❌ |
-| `installation` | any | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | any | ❌ | ❌ | ❌ |
-| `membership` | any | any | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `release` | `created`, `published`, `edited`, `deleted`, `other` | `published`, `edited`, `deleted` | ❌ | `published`, `edited`, `deleted` | `published`, `edited`, `deleted` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `star` | `created`, `deleted` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `fork` | `created` | ❌ | `created` | `created` | `created` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `wiki` | `created`, `edited` | `created`, `edited`, `deleted` | ❌ | `created`, `edited`, `deleted`, `renamed` | `created`, `edited`, `deleted`, `renamed` | ❌ | ❌ | ❌ | ❌ | ❌ | `created`, `edited` |
-| `issue_type` | `typed`, `untyped` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `other` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| Kind | GitHub | GitLab | Bitbucket | Forgejo | Gitea | Gitee | Azure DevOps | Cursor Origin | Tangled | Sourcehut | GitBucket | Upstream |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| `comment` | `created`, `edited`, `deleted` | `created` | `created`, `edited`, `deleted` | `created`, `edited`, `deleted` | `created`, `edited`, `deleted` | `created` | `created` | `created` | `created` | ❌ | `created` | `created`, `edited`, `deleted` |
+| `review` | `submitted` | `submitted` | `submitted` | `submitted` | `submitted` | ❌ | `submitted` | `submitted` | ❌ | ❌ | ❌ | `submitted` |
+| `review_comment` | `created`, `edited`, `deleted` | `created` | `created`, `edited`, `deleted` | `created` | `created` | ❌ | ❌ | ❌ | ❌ | ❌ | `created` | `created` |
+| `commit` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `label` | `labelled`, `unlabelled` | `labelled`, `unlabelled` | ❌ | `edited`, `unlabelled` | `edited`, `unlabelled` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | `labelled`, `unlabelled` |
+| `state_change` | `opened`, `closed`, `reopened`, `merged`, `ready_for_review`, `converted_to_draft` | `opened`, `closed`, `reopened`, `merged` | `opened`, `closed`, `merged` | `opened`, `closed`, `reopened`, `merged` | `opened`, `closed`, `reopened`, `merged` | `opened`, `closed`, `reopened`, `merged` | `opened`, `closed`, `merged` | `opened`, `closed`, `merged` | `opened`, `closed`, `merged` | ❌ | `opened`, `closed`, `reopened`, `merged` | `opened`, `closed`, `reopened`, `merged` |
+| `assignment` | `assigned`, `unassigned`, `review_requested` | `assigned`, `unassigned`, `review_requested` | ❌ | `assigned`, `unassigned` | `assigned`, `unassigned` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | `assigned`, `unassigned` |
+| `mention` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `referenced` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `reaction` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `push` | any | any | any | any | any | any | any | ❌ | any | any | any | any |
+| `ref` | `created`, `deleted` | `created`, `deleted` | `created`, `deleted` | `created`, `deleted` | `created`, `deleted` | `created`, `deleted` | ❌ | ❌ | ❌ | ❌ | `created` | `created`, `deleted` |
+| `repo` | `renamed`, `transferred`, `archived`, `unarchived`, `edited` | ❌ | `renamed`, `transferred` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | `created`, `edited`, `deleted` | ❌ | `edited` |
+| `installation` | any | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | any | ❌ | ❌ | ❌ | ❌ |
+| `membership` | any | any | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | any |
+| `release` | `created`, `published`, `edited`, `deleted`, `other` | `published`, `edited`, `deleted` | ❌ | `published`, `edited`, `deleted` | `published`, `edited`, `deleted` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | `created`, `published`, `edited`, `deleted` |
+| `star` | `created`, `deleted` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `fork` | `created` | ❌ | `created` | `created` | `created` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | `created` |
+| `wiki` | `created`, `edited` | `created`, `edited`, `deleted` | ❌ | `created`, `edited`, `deleted`, `renamed` | `created`, `edited`, `deleted`, `renamed` | ❌ | ❌ | ❌ | ❌ | ❌ | `created`, `edited` | ❌ |
+| `issue_type` | `typed`, `untyped` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `other` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
Pushin.eu, Cloudflare Artifacts and Entire receive no webhooks.
@@ -103,23 +103,23 @@ When you register a webhook, `webhooks.create({ events })` translates each kind
| `issue_type` | `issue_type` | `issueType: IssueType` |
| `other` | none | none |
-| Kind | GitHub | GitLab | Bitbucket | Forgejo | Gitea | Gitee | GitBucket |
-| --- | --- | --- | --- | --- | --- | --- | --- |
-| `comment` | `issue_comment`, `commit_comment`, `discussion_comment` | `note_events`, `confidential_note_events` | `pullrequest:comment_created`, `pullrequest:comment_updated`, `pullrequest:comment_deleted` | `issue_comment`, `pull_request_comment` | `issue_comment`, `pull_request_comment` | `note_events` | `issue_comment` |
-| `review` | `pull_request_review` | `merge_requests_events` | `pullrequest:approved`, `pullrequest:unapproved`, `pullrequest:changes_request_created` | `pull_request_review_approved`, `pull_request_review_rejected`, `pull_request_review_comment` | `pull_request_review_approved`, `pull_request_review_rejected`, `pull_request_review_comment` | `merge_requests_events` | ❌ |
-| `review_comment` | `pull_request_review_comment` | `note_events` | `pullrequest:comment_created`, `pullrequest:comment_updated`, `pullrequest:comment_deleted` | `pull_request_review_comment` | `pull_request_review_comment` | ❌ | `pull_request_review_comment` |
-| `label` | `issues`, `pull_request`, `label` | `issues_events`, `merge_requests_events` | ❌ | `issue_label`, `pull_request_label` | `issue_label`, `pull_request_label` | `issues_events`, `merge_requests_events` | ❌ |
-| `state_change` | `issues`, `pull_request`, `discussion` | `issues_events`, `confidential_issues_events`, `merge_requests_events` | `pullrequest:created`, `pullrequest:updated`, `pullrequest:fulfilled`, `pullrequest:rejected` | `issues`, `pull_request`, `pull_request_sync` | `issues`, `pull_request`, `pull_request_sync` | `issues_events`, `merge_requests_events` | `issues`, `pull_request` |
-| `assignment` | `issues`, `pull_request` | `issues_events`, `merge_requests_events` | ❌ | `issue_assign`, `pull_request_assign` | `issue_assign`, `pull_request_assign` | `issues_events`, `merge_requests_events` | ❌ |
-| `push` | `push` | `push_events` | `repo:push` | `push` | `push` | `push_events` | `push` |
-| `ref` | `create`, `delete` | `tag_push_events`, `push_events` | `repo:push` | `create`, `delete` | `create`, `delete` | `tag_push_events` | `create` |
-| `repo` | `repository`, `public` | ❌ | `repo:updated`, `repo:transfer` | ❌ | ❌ | ❌ | ❌ |
-| `installation` | `installation`, `installation_repositories` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `membership` | `member`, `membership`, `organization`, `team` | `member_events` | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `release` | `release` | `releases_events` | ❌ | `release` | `release` | ❌ | ❌ |
-| `star` | `star` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| `fork` | `fork` | ❌ | `repo:fork` | `fork` | `fork` | ❌ | ❌ |
-| `wiki` | `gollum` | `wiki_page_events` | ❌ | `wiki` | `wiki` | ❌ | `gollum` |
-| `issue_type` | `issues` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| Kind | GitHub | GitLab | Bitbucket | Forgejo | Gitea | Gitee | GitBucket | Upstream |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| `comment` | `issue_comment`, `commit_comment`, `discussion_comment` | `note_events`, `confidential_note_events` | `pullrequest:comment_created`, `pullrequest:comment_updated`, `pullrequest:comment_deleted` | `issue_comment`, `pull_request_comment` | `issue_comment`, `pull_request_comment` | `note_events` | `issue_comment` | `issue_comment` |
+| `review` | `pull_request_review` | `merge_requests_events` | `pullrequest:approved`, `pullrequest:unapproved`, `pullrequest:changes_request_created` | `pull_request_review_approved`, `pull_request_review_rejected`, `pull_request_review_comment` | `pull_request_review_approved`, `pull_request_review_rejected`, `pull_request_review_comment` | `merge_requests_events` | ❌ | `pull_request_review` |
+| `review_comment` | `pull_request_review_comment` | `note_events` | `pullrequest:comment_created`, `pullrequest:comment_updated`, `pullrequest:comment_deleted` | `pull_request_review_comment` | `pull_request_review_comment` | ❌ | `pull_request_review_comment` | `pull_request_review_comment` |
+| `label` | `issues`, `pull_request`, `label` | `issues_events`, `merge_requests_events` | ❌ | `issue_label`, `pull_request_label` | `issue_label`, `pull_request_label` | `issues_events`, `merge_requests_events` | ❌ | `issues`, `pull_request` |
+| `state_change` | `issues`, `pull_request`, `discussion` | `issues_events`, `confidential_issues_events`, `merge_requests_events` | `pullrequest:created`, `pullrequest:updated`, `pullrequest:fulfilled`, `pullrequest:rejected` | `issues`, `pull_request`, `pull_request_sync` | `issues`, `pull_request`, `pull_request_sync` | `issues_events`, `merge_requests_events` | `issues`, `pull_request` | `issues`, `pull_request` |
+| `assignment` | `issues`, `pull_request` | `issues_events`, `merge_requests_events` | ❌ | `issue_assign`, `pull_request_assign` | `issue_assign`, `pull_request_assign` | `issues_events`, `merge_requests_events` | ❌ | `issues`, `pull_request` |
+| `push` | `push` | `push_events` | `repo:push` | `push` | `push` | `push_events` | `push` | `push` |
+| `ref` | `create`, `delete` | `tag_push_events`, `push_events` | `repo:push` | `create`, `delete` | `create`, `delete` | `tag_push_events` | `create` | `create`, `delete` |
+| `repo` | `repository`, `public` | ❌ | `repo:updated`, `repo:transfer` | ❌ | ❌ | ❌ | ❌ | `repository` |
+| `installation` | `installation`, `installation_repositories` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `membership` | `member`, `membership`, `organization`, `team` | `member_events` | ❌ | ❌ | ❌ | ❌ | ❌ | `member` |
+| `release` | `release` | `releases_events` | ❌ | `release` | `release` | ❌ | ❌ | `release` |
+| `star` | `star` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| `fork` | `fork` | ❌ | `repo:fork` | `fork` | `fork` | ❌ | ❌ | `fork` |
+| `wiki` | `gollum` | `wiki_page_events` | ❌ | `wiki` | `wiki` | ❌ | `gollum` | ❌ |
+| `issue_type` | `issues` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
::
diff --git a/docs/content/5.reference/13.environment-variables.md b/docs/content/5.reference/13.environment-variables.md
index c5660d5e5..941b0fccb 100644
--- a/docs/content/5.reference/13.environment-variables.md
+++ b/docs/content/5.reference/13.environment-variables.md
@@ -8,7 +8,7 @@ This page lists every variable that `providersFromEnv()` and `forgesFromEnv()` f
## Kinds
-`` is one of `GITHUB`, `GITLAB`, `BITBUCKET`, `FORGEJO`, `GITEA`, `GITEE`, `AZURE_DEVOPS`, `CURSOR_ORIGIN`, `TANGLED`, `PUSHIN`, `CLOUDFLARE_ARTIFACTS`, `SOURCEHUT`, `ENTIRE` and `GITBUCKET`.
+`` is one of `GITHUB`, `GITLAB`, `BITBUCKET`, `FORGEJO`, `GITEA`, `GITEE`, `AZURE_DEVOPS`, `CURSOR_ORIGIN`, `TANGLED`, `PUSHIN`, `CLOUDFLARE_ARTIFACTS`, `SOURCEHUT`, `ENTIRE`, `GITBUCKET` and `UPSTREAM`.
## Fields
@@ -41,7 +41,7 @@ A set of variables creates a provider when it contains one of the credentials th
| Forge | Credentials | Optional | Without a credential |
| --- | --- | --- | --- |
| GitHub | `TOKEN`, or `APP_ID` and `PRIVATE_KEY` | `INSTALLATION_ID` with `APP_ID` and `PRIVATE_KEY` | Anonymous reads with `ENABLED` or `DEMO_REPO`. Skipped otherwise |
-| GitLab, Forgejo, Gitea, Gitee, Pushin.eu | `TOKEN` | None | Anonymous reads with `ENABLED` or `DEMO_REPO`. Skipped otherwise |
+| GitLab, Forgejo, Gitea, Gitee, Pushin.eu, Upstream | `TOKEN` | None | Anonymous reads with `ENABLED` or `DEMO_REPO`. Skipped otherwise |
| Bitbucket | `TOKEN`, or `USERNAME` and `PASSWORD` | None | Anonymous reads with `ENABLED` or `DEMO_REPO`. Skipped otherwise |
| Azure DevOps | `ORGANIZATION`, and `TOKEN`, or `USERNAME` and `PASSWORD` | None | Anonymous reads with `ENABLED` or `DEMO_REPO`. Skipped otherwise |
| Cursor Origin | `TOKEN`, or `APP_ID` and `PRIVATE_KEY` | `INSTALLATION_ID` with `APP_ID` and `PRIVATE_KEY` | Webhooks only with `ENABLED`. Skipped otherwise |
diff --git a/docs/content/7.contributing/4.record-fixtures.md b/docs/content/7.contributing/4.record-fixtures.md
index ad9177826..86f65e7b5 100644
--- a/docs/content/7.contributing/4.record-fixtures.md
+++ b/docs/content/7.contributing/4.record-fixtures.md
@@ -109,7 +109,7 @@ A write recording needs:
- to record `orgs.block` and `users.block`, the login of an account outside the scratch repository's organization in `FIXTURE__BLOCKED_USER`. The bot blocks and unblocks it for the organization, which the bot must own, and for itself. On GitHub, the bot's token needs the `admin:org` and `user` scopes;
- on GitHub, [immutable releases](https://docs.github.com/en/code-security/supply-chain-security/understanding-your-software-supply-chain/immutable-releases) turned on in the scratch repository, so that the recorder can check that GitHub refuses to retag a release.
-Before the steps run, the recorder closes threads that an earlier run left open, and creates three branches with one commit each through the forge's own API. Afterwards it deletes the branches, the label and the webhook, and every release and tag whose name starts with `forges-fixture-`. On Codeberg, which refuses issues and pull requests whose titles are too similar to ones the account opened in the last hour, the title of each thread ends with a random suffix. The recorder can write to GitHub, GitLab, Bitbucket, Forgejo, Gitea, Gitee, Azure DevOps, Cursor Origin, Pushin.eu, Entire and Tangled.
+Before the steps run, the recorder closes threads that an earlier run left open, and creates three branches with one commit each through the forge's own API. Afterwards it deletes the branches, the label and the webhook, and every release and tag whose name starts with `forges-fixture-`. On Codeberg, which refuses issues and pull requests whose titles are too similar to ones the account opened in the last hour, the title of each thread ends with a random suffix. The recorder can write to GitHub, GitLab, Bitbucket, Forgejo, Gitea, Gitee, Azure DevOps, Cursor Origin, Pushin.eu, Entire, Tangled and Upstream.
Pushin.eu has no API for branches or tags, so the recorder pushes them over HTTPS as the bot. Its API can't close threads either, so the recorder closes those an earlier run left open by importing them again as closed.
@@ -407,6 +407,16 @@ Each run starts a new server from the `gitbucket/gitbucket` image on `127.0.0.1:
To record a server that you already run, set `GITBUCKET_BASE_URL` to its root. The server must be empty and keep the default `root` account with the password `root`.
+### Upstream
+
+```sh
+UPSTREAM_TOKEN=upt_... pnpm record-fixtures upstream
+```
+
+Upstream's public repositories have no issues or change requests yet, so the reads go to `upstream_forges_bot/forges-fixtures`, the scratch repository, and to the issue and change request seeded there, `4` and `5`. To record other targets, set `FIXTURE_UPSTREAM_REPO`, `FIXTURE_UPSTREAM_ISSUE` and `FIXTURE_UPSTREAM_PULL`. To record another instance, set `UPSTREAM_BASE_URL`. The recorder redacts `upt_` tokens, so the fixtures don't contain yours.
+
+Create the tokens under **Settings > API tokens** on upstream.codes, without an expiry, so the scheduled recordings keep working. Upstream has no API for collaborators, so invite the reviewer to the scratch repository with write access from its settings page once. Upstream creates no tag for a release, so before the release steps, the recorder creates the tag through the git refs API.
+
## Check the capabilities
We run `pnpm test:capabilities` on every commit to `forges`. During the unit tests, `test/setup/verbs.ts` records each verb that a test calls, along with where the forge data it used came from: a recording, a fixture hand-authored from the forge's documentation (marked `handAuthored: true`), or nowhere, for a call that sends no request. A response that a test overrides or builds inline counts for none of these. The check then fails in two cases:
diff --git a/docs/shared/explorer.ts b/docs/shared/explorer.ts
index b61384651..84dbf34f9 100644
--- a/docs/shared/explorer.ts
+++ b/docs/shared/explorer.ts
@@ -653,6 +653,29 @@ export const EXPLORER_FORGES: ExplorerForge[] = [
head: 'fix-empty-config',
}),
},
+ {
+ name: 'Upstream',
+ factory: 'upstream',
+ module: 'upstream',
+ load: () => import('forges/upstream'),
+ forge: 'upstream',
+ instance: 'upstream.codes',
+ credentials: [
+ token('UPSTREAM_TOKEN'),
+ ],
+ // The scratch repository the recordings read, as Upstream's public repositories have no change requests yet.
+ sample: sample({
+ owner: 'upstream_forges_bot',
+ name: 'forges-fixtures',
+ number: '2',
+ login: 'upstream_forges_bot',
+ tag: 'forges-seed-v1',
+ releaseId: '2624562683860212',
+ sha: '9fcb176dae722fffca2a17c8951296f6ac946856',
+ base: '5688494516e0dfcc4fb2ed031e0b84979326f0e1',
+ head: 'main',
+ }),
+ },
]
/** The refs a call takes, built from the form. */
diff --git a/package.json b/package.json
index 5144af45b..34a0472dd 100644
--- a/package.json
+++ b/package.json
@@ -32,6 +32,7 @@
"gitee",
"azure-devops",
"tangled",
+ "upstream",
"atproto",
"issues",
"pull-requests",
@@ -61,6 +62,7 @@
"./sourcehut": "./src/sourcehut/index.ts",
"./tangled": "./src/tangled/index.ts",
"./testing": "./src/testing/index.ts",
+ "./upstream": "./src/upstream/index.ts",
"./web": "./src/web/index.ts",
"./wire": "./src/wire.ts",
"./package.json": "./package.json",
@@ -90,6 +92,7 @@
"./sourcehut": "./dist/sourcehut/index.mjs",
"./tangled": "./dist/tangled/index.mjs",
"./testing": "./dist/testing/index.mjs",
+ "./upstream": "./dist/upstream/index.mjs",
"./web": "./dist/web/index.mjs",
"./wire": "./dist/wire.mjs",
"./package.json": "./package.json",
diff --git a/scripts/api-docs/config.ts b/scripts/api-docs/config.ts
index 662abc264..1be6b36af 100644
--- a/scripts/api-docs/config.ts
+++ b/scripts/api-docs/config.ts
@@ -199,6 +199,7 @@ export const PAGES: PageConfig[] = [
forge('Sourcehut', 'sourcehut'),
forge('Entire', 'entire'),
forge('GitBucket', 'gitbucket'),
+ forge('Upstream', 'upstream'),
{
title: 'Forges registry',
intro: 'A registry routes each ref to the provider it belongs to.',
diff --git a/scripts/capabilities.ts b/scripts/capabilities.ts
index 49453b4e1..66942969d 100644
--- a/scripts/capabilities.ts
+++ b/scripts/capabilities.ts
@@ -71,7 +71,7 @@ function withoutCredentials(provider: Forges.ForgeProvider): Forges.ForgeProvide
/** Providers as the matrix and provider pages show them, keyed by their `docs/content/4.providers/.md` page. */
export function matrixProviders(forges: typeof Forges): MatrixProvider[] {
- const { azureDevOps, bitbucket, cloudflareArtifacts, cursorOrigin, entire, forgejo, gitbucket, gitea, gitee, github, gitlab, pushin, sourcehut, tangled } = forges
+ const { azureDevOps, bitbucket, cloudflareArtifacts, cursorOrigin, entire, forgejo, gitbucket, gitea, gitee, github, gitlab, pushin, sourcehut, tangled, upstream } = forges
const auth = { type: 'token', token: 'token' } as const
const entry = (slug: string, name: string, factory: (options: O) => Forges.ForgeProvider, options: O, credentials?: CredentialOptions[]): MatrixProvider => {
const exported = Object.keys(forges).find(key => (forges as Record)[key] === factory)!
@@ -176,6 +176,7 @@ export function matrixProviders(forges: typeof Forges): MatrixProvider[] {
entry('sourcehut', 'Sourcehut', sourcehut, { auth }),
entry('entire', 'Entire', entire, { auth }),
entry('gitbucket', 'GitBucket', gitbucket, { auth, baseUrl: 'https://gitbucket.example.com' }),
+ entry('upstream', 'Upstream', upstream, { auth }),
]
}
diff --git a/scripts/credential-steps.ts b/scripts/credential-steps.ts
index ad7291f09..25048d2f4 100644
--- a/scripts/credential-steps.ts
+++ b/scripts/credential-steps.ts
@@ -228,6 +228,15 @@ export const credentialSteps: Record> =
},
],
},
+ 'upstream': {
+ TOKEN: [
+ {
+ text: 'Create a personal access token under [**Settings > API tokens**](https://upstream.codes/settings/tokens) on upstream.codes. Grant it the scopes for what you call, such as `issues:write` and `changes:write` to write issues and change requests.',
+ sources: ['https://upstream.codes/docs/api', 'docs/content/4.providers/upstream.md'],
+ verified: '2026-11-14',
+ },
+ ],
+ },
'sourcehut': {
TOKEN: [
{
diff --git a/scripts/events.ts b/scripts/events.ts
index 5f06e3652..7643f5fc8 100644
--- a/scripts/events.ts
+++ b/scripts/events.ts
@@ -8,6 +8,7 @@ import { GITHUB_NATIVE_EVENTS } from '../src/github/webhook-events.ts'
import { GITLAB_NATIVE_EVENTS } from '../src/gitlab/webhook-events.ts'
import { isUnsupported } from '../src/model.ts'
import { models } from '../src/schema/index.ts'
+import { UPSTREAM_NATIVE_EVENTS } from '../src/upstream/webhook-events.ts'
import { matrixProviders } from './capabilities.ts'
/** The native event map each provider's `webhooks.create()` translates `events` with, by docs slug. */
@@ -19,6 +20,7 @@ const SUBSCRIPTIONS: Record = {
gitea: FORGEJO_NATIVE_EVENTS,
gitee: GITEE_NATIVE_EVENTS,
gitbucket: GITBUCKET_NATIVE_EVENTS,
+ upstream: UPSTREAM_NATIVE_EVENTS,
}
export interface EventProvider {
diff --git a/scripts/exercised.ts b/scripts/exercised.ts
index cd360b918..e56ef7d24 100644
--- a/scripts/exercised.ts
+++ b/scripts/exercised.ts
@@ -1,7 +1,7 @@
import type { ForgeCapabilities, ForgeProvider } from '../src/index.ts'
import type { VerbRun } from '../test/setup/verbs-directory.ts'
import { existsSync, readdirSync, readFileSync } from 'node:fs'
-import { azureDevOps, bitbucket, cloudflareArtifacts, cursorOrigin, entire, forgejo, gitbucket, gitea, gitee, github, gitlab, pushin, sourcehut, tangled } from '../src/index.ts'
+import { azureDevOps, bitbucket, cloudflareArtifacts, cursorOrigin, entire, forgejo, gitbucket, gitea, gitee, github, gitlab, pushin, sourcehut, tangled, upstream } from '../src/index.ts'
import { VERB_RUN } from '../test/setup/verbs-directory.ts'
import { withDeclared } from './capabilities.ts'
@@ -123,6 +123,10 @@ const checked: Array<[string, ForgeProvider]> = [
'gitbucket',
gitbucket({ auth, baseUrl: 'https://gitbucket.example.com' }),
],
+ [
+ 'upstream',
+ upstream({ auth }),
+ ],
[
'github:anonymous',
github({}),
@@ -167,6 +171,10 @@ const checked: Array<[string, ForgeProvider]> = [
'gitbucket:anonymous',
gitbucket({ baseUrl: 'https://gitbucket.example.com' }),
],
+ [
+ 'upstream:anonymous',
+ upstream({}),
+ ],
]
/** Every provider whose declarations are checked, keyed like `readExercised()`, with each auth kind that changes them and the levels it declares as its capabilities. */
diff --git a/scripts/fixtures-environments.ts b/scripts/fixtures-environments.ts
index dd99138de..e879aa7f0 100644
--- a/scripts/fixtures-environments.ts
+++ b/scripts/fixtures-environments.ts
@@ -34,6 +34,7 @@ const PREFIXES: Record = {
'sourcehut': ['SOURCEHUT_', 'FIXTURE_SOURCEHUT_'],
'entire': ['ENTIRE_', 'FIXTURE_ENTIRE_'],
'cursor-origin': ['CURSOR_', 'FIXTURE_CURSOR_ORIGIN_'],
+ 'upstream': ['UPSTREAM_', 'FIXTURE_UPSTREAM_'],
}
/** Variables only write recordings and seeding use: the bot accounts and the Tangled reviewer. */
diff --git a/scripts/record-fixtures.ts b/scripts/record-fixtures.ts
index 9e2987ee3..ee4ae2008 100644
--- a/scripts/record-fixtures.ts
+++ b/scripts/record-fixtures.ts
@@ -15,7 +15,7 @@ import process, { env, exit } from 'node:process'
import { fileURLToPath } from 'node:url'
import { parseArgs } from 'node:util'
import { ForgeApiError } from '../src/errors.ts'
-import { azureDevOps, bitbucket, cloudflareArtifacts, cursorOrigin, entire, forgejo, gitbucket, gitea, gitee, github, gitlab, pushin, sourcehut, tangled } from '../src/index.ts'
+import { azureDevOps, bitbucket, cloudflareArtifacts, cursorOrigin, entire, forgejo, gitbucket, gitea, gitee, github, gitlab, pushin, sourcehut, tangled, upstream } from '../src/index.ts'
import { recordingFetch, signDelivery } from '../src/testing/index.ts'
import { recordedSteps, stepSlug } from '../test/recording/layout.ts'
import { redact } from '../test/recording/redact.ts'
@@ -57,10 +57,11 @@ const TOKEN_VARIABLES: Record = {
'sourcehut': 'SOURCEHUT_TOKEN',
'entire': 'ENTIRE_TOKEN',
'gitbucket': 'GITBUCKET_TOKEN',
+ 'upstream': 'UPSTREAM_TOKEN',
}
if (!target || !(target in TOKEN_VARIABLES)) {
- console.error('Usage: pnpm record-fixtures [--anonymous | --app | --writes [--allow-fewer] [--defer-splice] | --webhooks | --seed] [--only ]...')
+ console.error('Usage: pnpm record-fixtures [--anonymous | --app | --writes [--allow-fewer] [--defer-splice] | --webhooks | --seed] [--only ]...')
exit(1)
}
@@ -810,6 +811,26 @@ function targetFor(credentials: Credentials, fetch: FetchLike): Target {
},
}
}
+ case 'upstream': {
+ const provider = upstream({
+ baseUrl: env.UPSTREAM_BASE_URL,
+ auth: tokenAuth,
+ fetch,
+ timeout,
+ })
+ // Upstream's public repositories have no issues or change requests yet, so reads go to the threads seeded in the scratch repository.
+ const slug = env.FIXTURE_UPSTREAM_REPO ?? 'upstream_forges_bot/forges-fixtures'
+ return {
+ provider,
+ manifest: {
+ repo: repoRef('upstream', provider.instance, slug),
+ pull: ref('upstream', provider.instance, slug, 'pull_request', env.FIXTURE_UPSTREAM_PULL ?? '5'),
+ issue: ref('upstream', provider.instance, slug, 'issue', env.FIXTURE_UPSTREAM_ISSUE ?? '4'),
+ feedUser: env.FIXTURE_UPSTREAM_FEED_USER,
+ ...setupRepos('UPSTREAM', slug => repoRef('upstream', provider.instance, slug)),
+ },
+ }
+ }
case 'pushin': {
const provider = pushin({
baseUrl: env.PUSHIN_BASE_URL,
diff --git a/scripts/record-forge.ts b/scripts/record-forge.ts
index d997fcd3b..df99de9c4 100644
--- a/scripts/record-forge.ts
+++ b/scripts/record-forge.ts
@@ -242,6 +242,25 @@ export const PLANS: Record = [
['sourcehut', 'Sourcehut'],
['entire', 'Entire'],
['gitbucket', 'GitBucket'],
+ ['upstream', 'Upstream'],
]
const { values: flags } = parseArgs({
diff --git a/scripts/write-harness.ts b/scripts/write-harness.ts
index 67edf6692..d824511eb 100644
--- a/scripts/write-harness.ts
+++ b/scripts/write-harness.ts
@@ -218,6 +218,26 @@ function gitbucket(options: HarnessOptions): WriteHarness {
}
}
+/**
+ * Upstream serves GitHub's API, but creates no tag for a release, so the
+ * recorder creates the tag through the git refs API first.
+ */
+function upstream(options: HarnessOptions): WriteHarness {
+ const { baseUrl, authorization, scratch } = options
+ const call = client(baseUrl, authorization)
+ const repo = `/repos/${enc(scratch.owner)}/${enc(scratch.name)}`
+ return {
+ ...github({ ...options, transfer: undefined }),
+ async createTag(base, tag) {
+ const { object } = await call<{ object: { sha: string } }>(`${repo}/git/ref/heads/${enc(base)}`)
+ await call(`${repo}/git/refs`, {
+ method: 'POST',
+ json: { ref: `refs/tags/${tag}`, sha: object.sha },
+ })
+ },
+ }
+}
+
function forgejo({ baseUrl, authorization, scratch }: HarnessOptions): WriteHarness {
const call = client(baseUrl, authorization)
const repo = `/repos/${enc(scratch.owner)}/${enc(scratch.name)}`
@@ -1085,6 +1105,7 @@ const HARNESSES: Record WriteHarness> = {
'forgejo': forgejo,
'gitea': forgejo,
'gitbucket': gitbucket,
+ 'upstream': upstream,
'gitlab': gitlab,
'bitbucket': bitbucket,
'gitee': gitee,
diff --git a/src/env.ts b/src/env.ts
index 3c4efad45..74c4d9db1 100644
--- a/src/env.ts
+++ b/src/env.ts
@@ -15,6 +15,7 @@ import { createForges } from './provider.ts'
import { pushin } from './pushin/index.ts'
import { sourcehut } from './sourcehut/index.ts'
import { tangled } from './tangled/index.ts'
+import { upstream } from './upstream/index.ts'
const KINDS = [
'GITHUB',
@@ -31,6 +32,7 @@ const KINDS = [
'SOURCEHUT',
'ENTIRE',
'GITBUCKET',
+ 'UPSTREAM',
] as const
/** Field names, longest first so `INSTANCE_VERSION` is not read as `INSTANCE` with suffix `VERSION`. */
@@ -301,6 +303,20 @@ function fromFields(kind: typeof KINDS[number], suffix: string, fields: Partial<
}),
}
: { ...entry, skipped: 'needs TOKEN, or ENABLED for anonymous reads' }
+ case 'UPSTREAM':
+ return fields.TOKEN || anonymous
+ ? {
+ ...entry,
+ provider: upstream({
+ ...base,
+ ...fields.TOKEN
+ ? {
+ auth: { type: 'token', token: fields.TOKEN },
+ }
+ : {},
+ }),
+ }
+ : { ...entry, skipped: 'needs TOKEN, or ENABLED for anonymous reads' }
case 'SOURCEHUT':
return fields.TOKEN
? {
diff --git a/src/github/definition.ts b/src/github/definition.ts
index 504c19e3d..407b146e8 100644
--- a/src/github/definition.ts
+++ b/src/github/definition.ts
@@ -1215,7 +1215,7 @@ function setupGitHub(ctx: GitHubContext, profile: GitHubProfile): GitHubSpec {
/** Resolvable conversations, by the id of each comment in them; empty when GraphQL is unreachable. */
async function reviewThreadsByComment(ref: ResolvedThreadRef, options?: BaseOptions): Promise