forges 0.0.0 → 0.1.0

package/dist/schema/index.mjs

@@ -0,0 +1,3219 @@
+//#endregion
+//#region src/schema/index.ts
+/** A JSON Schema (draft-07) for each public model type, keyed by type name. References point at `#/components/schemas/<Type>`. */
+const schemas = {
+	Actor: {
+		"type": "object",
+		"properties": {
+			"forge": { "$ref": "#/components/schemas/ForgeKind" },
+			"instance": {
+				"$ref": "#/components/schemas/ForgeInstance",
+				"description": "The host of the instance, such as `github.com` or `git.example.com`."
+			},
+			"login": { "type": "string" },
+			"id": { "type": "string" },
+			"name": { "type": "string" },
+			"avatarUrl": { "type": "string" },
+			"url": { "type": "string" },
+			"typeRaw": {
+				"type": "string",
+				"description": "Forge-reported account type, retained verbatim for callers that classify further."
+			},
+			"isBotHint": {
+				"type": "boolean",
+				"description": "Hint derived from forge metadata that the actor is automation. Callers own the classification policy."
+			},
+			"app": {
+				"type": "object",
+				"properties": {
+					"slug": { "type": "string" },
+					"id": { "type": "string" }
+				},
+				"required": ["slug"],
+				"description": "The app behind a bot account, where the forge ties one to it (GitHub Apps' `slug[bot]` users)."
+			}
+		},
+		"required": [
+			"forge",
+			"id",
+			"instance",
+			"isBotHint",
+			"login"
+		],
+		"description": "An account: a user, an organisation or a bot.",
+		"x-forges-type": "Actor"
+	},
+	AlertSupport: {
+		"type": "object",
+		"properties": {
+			"dependency": { "$ref": "#/components/schemas/Support" },
+			"code_scanning": { "$ref": "#/components/schemas/Support" },
+			"secret": { "$ref": "#/components/schemas/Support" },
+			"advisory": { "$ref": "#/components/schemas/Support" }
+		},
+		"required": [
+			"dependency",
+			"code_scanning",
+			"secret",
+			"advisory"
+		],
+		"description": "Support per security alert kind.",
+		"x-forges-type": "AlertSupport"
+	},
+	AuthKind: {
+		"type": "string",
+		"enum": [
+			"token",
+			"basic",
+			"app",
+			"app_password",
+			"oauth",
+			"anonymous"
+		],
+		"description": "The credential types that a provider can accept.",
+		"x-forges-type": "AuthKind"
+	},
+	Branch: {
+		"type": "object",
+		"properties": {
+			"name": { "type": "string" },
+			"sha": {
+				"type": "string",
+				"description": "The commit that the branch points at."
+			},
+			"isDefault": { "type": "boolean" },
+			"isProtected": { "type": "boolean" },
+			"url": { "type": "string" },
+			"raw": {}
+		},
+		"required": [
+			"name",
+			"sha",
+			"raw"
+		],
+		"description": "A branch of a repository.",
+		"x-forges-type": "Branch"
+	},
+	ChangedFile: {
+		"type": "object",
+		"properties": {
+			"path": { "type": "string" },
+			"previousPath": {
+				"type": "string",
+				"description": "Path before a rename or copy."
+			},
+			"status": { "$ref": "#/components/schemas/FileStatus" },
+			"statusRaw": { "type": "string" },
+			"additions": { "type": "number" },
+			"deletions": { "type": "number" },
+			"patch": {
+				"type": "string",
+				"description": "Unified diff for the file, where the forge returns one inline."
+			},
+			"sha": {
+				"type": "string",
+				"description": "Blob sha after the change."
+			},
+			"isBinary": {
+				"type": "boolean",
+				"description": "The file is binary, so it has no patch."
+			}
+		},
+		"required": ["path", "status"],
+		"description": "A file that a commit or pull request changed.",
+		"x-forges-type": "ChangedFile"
+	},
+	Check: {
+		"type": "object",
+		"properties": {
+			"ref": { "$ref": "#/components/schemas/CheckRef" },
+			"name": { "type": "string" },
+			"state": { "$ref": "#/components/schemas/CheckState" },
+			"stateRaw": {
+				"type": "string",
+				"description": "Forge-native status, for example `in_progress` or `running`."
+			},
+			"conclusionRaw": {
+				"type": "string",
+				"description": "Forge-native conclusion, where the forge reports one apart from the status."
+			},
+			"url": { "type": "string" },
+			"startedAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"completedAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"raw": {}
+		},
+		"required": [
+			"ref",
+			"name",
+			"state",
+			"stateRaw",
+			"raw"
+		],
+		"description": "One check on a commit: a check run, a commit status, a job or a policy evaluation.",
+		"x-forges-type": "Check"
+	},
+	CheckRef: {
+		"type": "object",
+		"properties": {
+			"forge": { "$ref": "#/components/schemas/ForgeKind" },
+			"instance": {
+				"$ref": "#/components/schemas/ForgeInstance",
+				"description": "The host of the instance, such as `github.com` or `git.example.com`."
+			},
+			"repo": { "$ref": "#/components/schemas/RepoRef" },
+			"id": { "type": "string" },
+			"type": {
+				"type": "string",
+				"enum": [
+					"check_run",
+					"status",
+					"job",
+					"policy"
+				],
+				"description": "What the id addresses: a check run, a commit status, a CI job, or a branch policy evaluation."
+			}
+		},
+		"required": [
+			"forge",
+			"id",
+			"instance",
+			"repo",
+			"type"
+		],
+		"description": "One check run, commit status or CI job.",
+		"x-forges-type": "CheckRef"
+	},
+	CheckState: {
+		"type": "string",
+		"enum": [
+			"pending",
+			"success",
+			"failure",
+			"neutral",
+			"unknown"
+		],
+		"description": "`neutral` covers skipped and informational results, which neither pass nor fail.",
+		"x-forges-type": "CheckState"
+	},
+	ChecksSummary: {
+		"type": "object",
+		"properties": {
+			"state": {
+				"type": "string",
+				"enum": [
+					"pending",
+					"success",
+					"failure",
+					"unknown"
+				]
+			},
+			"stateRaw": { "type": "string" },
+			"total": {
+				"type": "number",
+				"description": "Absent when the forge reports only a combined state."
+			},
+			"failed": { "type": "number" },
+			"url": { "type": "string" }
+		},
+		"required": ["state"],
+		"description": "Combined state of the checks on a pull request's head commit. `failure` when any check failed, else `pending` while any runs, else `success`.",
+		"x-forges-type": "ChecksSummary"
+	},
+	CiJob: {
+		"type": "object",
+		"properties": {
+			"ref": { "$ref": "#/components/schemas/CiJobRef" },
+			"name": { "type": "string" },
+			"state": { "$ref": "#/components/schemas/CheckState" },
+			"stateRaw": { "type": "string" },
+			"stage": {
+				"type": "string",
+				"description": "Stage or group the job belongs to, where the forge has one."
+			},
+			"url": { "type": "string" },
+			"startedAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"completedAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"raw": {}
+		},
+		"required": [
+			"ref",
+			"name",
+			"state",
+			"stateRaw",
+			"raw"
+		],
+		"description": "One job of a CI run.",
+		"x-forges-type": "CiJob"
+	},
+	CiJobRef: {
+		"type": "object",
+		"properties": {
+			"forge": { "$ref": "#/components/schemas/ForgeKind" },
+			"instance": {
+				"$ref": "#/components/schemas/ForgeInstance",
+				"description": "The host of the instance, such as `github.com` or `git.example.com`."
+			},
+			"repo": { "$ref": "#/components/schemas/RepoRef" },
+			"id": { "type": "string" },
+			"run": { "$ref": "#/components/schemas/CiRunRef" }
+		},
+		"required": [
+			"forge",
+			"id",
+			"instance",
+			"repo"
+		],
+		"description": "One job inside a run. `run` is absent when the job was addressed on its own.",
+		"x-forges-type": "CiJobRef"
+	},
+	CiRun: {
+		"type": "object",
+		"properties": {
+			"ref": { "$ref": "#/components/schemas/CiRunRef" },
+			"name": { "type": "string" },
+			"state": { "$ref": "#/components/schemas/CheckState" },
+			"stateRaw": { "type": "string" },
+			"number": {
+				"type": "string",
+				"description": "Per-repo run number, where the forge has one."
+			},
+			"eventRaw": {
+				"type": "string",
+				"description": "What triggered the run, as the forge names it."
+			},
+			"branch": { "type": "string" },
+			"sha": {
+				"type": "string",
+				"description": "The commit that the run ran on."
+			},
+			"url": { "type": "string" },
+			"actor": { "$ref": "#/components/schemas/Actor" },
+			"createdAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"startedAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"completedAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"raw": {}
+		},
+		"required": [
+			"ref",
+			"name",
+			"state",
+			"stateRaw",
+			"raw"
+		],
+		"description": "A CI run, such as a workflow run or a pipeline.",
+		"x-forges-type": "CiRun"
+	},
+	CiRunRef: {
+		"type": "object",
+		"properties": {
+			"forge": { "$ref": "#/components/schemas/ForgeKind" },
+			"instance": {
+				"$ref": "#/components/schemas/ForgeInstance",
+				"description": "The host of the instance, such as `github.com` or `git.example.com`."
+			},
+			"repo": { "$ref": "#/components/schemas/RepoRef" },
+			"id": { "type": "string" }
+		},
+		"required": [
+			"forge",
+			"id",
+			"instance",
+			"repo"
+		],
+		"description": "A CI run: a workflow run, a pipeline, or a build.",
+		"x-forges-type": "CiRunRef"
+	},
+	CodeFragment: {
+		"type": "object",
+		"properties": {
+			"text": { "type": "string" },
+			"line": {
+				"type": "number",
+				"description": "The line the excerpt starts on, where the forge reports it."
+			}
+		},
+		"required": ["text"],
+		"description": "An excerpt of a file that matched a code search.",
+		"x-forges-type": "CodeFragment"
+	},
+	CodeMatch: {
+		"type": "object",
+		"properties": {
+			"repo": { "$ref": "#/components/schemas/RepoRef" },
+			"path": { "type": "string" },
+			"ref": {
+				"type": "string",
+				"description": "The branch, tag or sha the forge searched, where it reports one."
+			},
+			"fragments": {
+				"type": "array",
+				"items": { "$ref": "#/components/schemas/CodeFragment" },
+				"description": "The excerpts of the file that matched."
+			},
+			"url": { "type": "string" },
+			"raw": {}
+		},
+		"required": [
+			"repo",
+			"path",
+			"fragments",
+			"raw"
+		],
+		"description": "A file that a code search found. A file whose excerpts span two pages comes back on both.",
+		"x-forges-type": "CodeMatch"
+	},
+	Collaborator: {
+		"type": "object",
+		"properties": {
+			"actor": { "$ref": "#/components/schemas/Actor" },
+			"role": { "$ref": "#/components/schemas/RepoRole" },
+			"roleRaw": {
+				"type": "string",
+				"description": "Forge-native role name, for example `maintainer` or `reporter`."
+			},
+			"permissions": {
+				"$ref": "#/components/schemas/RepoPermissions",
+				"description": "What the role allows."
+			},
+			"raw": {}
+		},
+		"required": [
+			"actor",
+			"role",
+			"raw"
+		],
+		"description": "An account with a role on a repository.",
+		"x-forges-type": "Collaborator"
+	},
+	Comment: {
+		"type": "object",
+		"properties": {
+			"ref": { "$ref": "#/components/schemas/CommentRef" },
+			"body": { "type": "string" },
+			"author": { "$ref": "#/components/schemas/Actor" },
+			"createdAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"updatedAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"url": { "type": "string" },
+			"reactions": { "$ref": "#/components/schemas/ReactionSummary" },
+			"thread": {
+				"type": "object",
+				"properties": {
+					"id": { "type": "string" },
+					"resolved": { "type": "boolean" }
+				},
+				"required": ["id", "resolved"],
+				"description": "The resolvable conversation the comment belongs to, where the forge has one; `resolveReviewThread()` takes its id."
+			},
+			"raw": {}
+		},
+		"required": [
+			"ref",
+			"body",
+			"raw"
+		],
+		"description": "A comment on a thread.",
+		"x-forges-type": "Comment"
+	},
+	CommentRef: {
+		"type": "object",
+		"properties": {
+			"forge": { "$ref": "#/components/schemas/ForgeKind" },
+			"instance": {
+				"$ref": "#/components/schemas/ForgeInstance",
+				"description": "The host of the instance, such as `github.com` or `git.example.com`."
+			},
+			"thread": { "$ref": "#/components/schemas/ThreadRef" },
+			"id": {
+				"type": "string",
+				"description": "Forge-native comment id; an AT-URI on Tangled."
+			}
+		},
+		"required": [
+			"forge",
+			"id",
+			"instance",
+			"thread"
+		],
+		"description": "Reference to a comment on a thread.",
+		"x-forges-type": "CommentRef"
+	},
+	Commit: {
+		"type": "object",
+		"properties": {
+			"ref": { "$ref": "#/components/schemas/CommitRef" },
+			"sha": {
+				"type": "string",
+				"description": "The full sha."
+			},
+			"message": { "type": "string" },
+			"author": {
+				"$ref": "#/components/schemas/CommitSignature",
+				"description": "Who wrote the change."
+			},
+			"committer": {
+				"$ref": "#/components/schemas/CommitSignature",
+				"description": "Who recorded the change."
+			},
+			"parents": {
+				"type": "array",
+				"items": { "type": "string" }
+			},
+			"url": { "type": "string" },
+			"stats": {
+				"type": "object",
+				"properties": {
+					"additions": { "type": "number" },
+					"deletions": { "type": "number" },
+					"total": { "type": "number" }
+				},
+				"required": ["additions", "deletions"]
+			},
+			"files": {
+				"type": "array",
+				"items": { "$ref": "#/components/schemas/ChangedFile" },
+				"description": "Present on `contents.commit`; absent from listings."
+			},
+			"raw": {}
+		},
+		"required": [
+			"ref",
+			"sha",
+			"message",
+			"parents",
+			"raw"
+		],
+		"description": "A commit.",
+		"x-forges-type": "Commit"
+	},
+	CommitRef: {
+		"type": "object",
+		"properties": {
+			"forge": { "$ref": "#/components/schemas/ForgeKind" },
+			"instance": {
+				"$ref": "#/components/schemas/ForgeInstance",
+				"description": "The host of the instance, such as `github.com` or `git.example.com`."
+			},
+			"repo": { "$ref": "#/components/schemas/RepoRef" },
+			"sha": {
+				"type": "string",
+				"description": "The full sha of the commit."
+			}
+		},
+		"required": [
+			"forge",
+			"instance",
+			"repo",
+			"sha"
+		],
+		"description": "A commit addressed by its full sha.",
+		"x-forges-type": "CommitRef"
+	},
+	CommitSignature: {
+		"type": "object",
+		"properties": {
+			"actor": {
+				"$ref": "#/components/schemas/Actor",
+				"description": "The account, where the forge can match it."
+			},
+			"name": { "type": "string" },
+			"email": { "type": "string" },
+			"date": {
+				"type": "string",
+				"format": "date-time",
+				"description": "When the commit was authored or committed."
+			}
+		},
+		"description": "Git authorship, with the forge account behind it where the forge matched one.",
+		"x-forges-type": "CommitSignature"
+	},
+	Comparison: {
+		"type": "object",
+		"properties": {
+			"base": {
+				"type": "string",
+				"description": "The revision that the comparison starts from."
+			},
+			"head": {
+				"type": "string",
+				"description": "The revision that the comparison ends at."
+			},
+			"aheadBy": {
+				"type": "number",
+				"description": "The number of commits that `head` has and `base` lacks."
+			},
+			"behindBy": {
+				"type": "number",
+				"description": "The number of commits that `base` has and `head` lacks."
+			},
+			"commits": {
+				"type": "array",
+				"items": { "$ref": "#/components/schemas/Commit" },
+				"description": "The commits between the two revisions."
+			},
+			"files": {
+				"type": "array",
+				"items": { "$ref": "#/components/schemas/ChangedFile" }
+			},
+			"mergeBaseSha": {
+				"type": "string",
+				"description": "The merge base, where the forge reports it."
+			},
+			"raw": {}
+		},
+		"required": [
+			"base",
+			"head",
+			"commits",
+			"files",
+			"raw"
+		],
+		"description": "The difference between two revisions.",
+		"x-forges-type": "Comparison"
+	},
+	Cursor: {
+		"type": "object",
+		"properties": {
+			"nextUrl": {
+				"type": "string",
+				"description": "Absolute URL of the next page, from a `Link` header or the body, on the requested origin."
+			},
+			"etag": {
+				"type": "string",
+				"description": "A validator for a conditional request."
+			},
+			"token": {
+				"type": "string",
+				"description": "Opaque forge-native cursor, for example a GraphQL `endCursor`."
+			}
+		},
+		"description": "Opaque-ish resumption token. Fields are optional because forges differ in what they support; callers should persist the whole object and hand it back.",
+		"x-forges-type": "Cursor"
+	},
+	EventAction: {
+		"type": "string",
+		"enum": [
+			"opened",
+			"closed",
+			"reopened",
+			"merged",
+			"edited",
+			"created",
+			"deleted",
+			"submitted",
+			"labelled",
+			"unlabelled",
+			"assigned",
+			"unassigned",
+			"review_requested",
+			"synchronised",
+			"ready_for_review",
+			"converted_to_draft",
+			"published",
+			"renamed",
+			"transferred",
+			"archived",
+			"unarchived",
+			"added",
+			"removed",
+			"other"
+		],
+		"description": "What happened, independent of `kind`, so \"anything that closed\" is `action === 'closed'` whatever the subject.",
+		"x-forges-type": "EventAction"
+	},
+	EventDetail: {
+		"anyOf": [
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "comment"
+					},
+					"comment": { "$ref": "#/components/schemas/CommentRef" },
+					"body": { "type": "string" }
+				},
+				"required": ["type"]
+			},
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "review_comment"
+					},
+					"comment": { "$ref": "#/components/schemas/CommentRef" },
+					"body": { "type": "string" },
+					"path": { "type": "string" },
+					"line": { "type": "number" }
+				},
+				"required": ["type"]
+			},
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "review"
+					},
+					"state": { "$ref": "#/components/schemas/ReviewState" },
+					"stateRaw": { "type": "string" },
+					"body": { "type": "string" }
+				},
+				"required": ["type", "state"]
+			},
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "state_change"
+					},
+					"state": { "$ref": "#/components/schemas/ThreadState" },
+					"draft": { "type": "boolean" }
+				},
+				"required": ["type"]
+			},
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "label"
+					},
+					"label": { "type": "string" }
+				},
+				"required": ["type", "label"]
+			},
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "assignment"
+					},
+					"assignee": { "$ref": "#/components/schemas/Actor" }
+				},
+				"required": ["type"]
+			},
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "push"
+					},
+					"ref": { "type": "string" },
+					"before": { "type": "string" },
+					"after": { "type": "string" },
+					"commitCount": { "type": "number" },
+					"forced": { "type": "boolean" },
+					"commits": {
+						"type": "array",
+						"items": { "$ref": "#/components/schemas/PushCommit" }
+					}
+				},
+				"required": [
+					"type",
+					"ref",
+					"commitCount",
+					"forced",
+					"commits"
+				]
+			},
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "ref"
+					},
+					"ref": { "type": "string" },
+					"refType": { "type": "string" }
+				},
+				"required": [
+					"type",
+					"ref",
+					"refType"
+				]
+			},
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "repo_renamed"
+					},
+					"from": { "type": "string" },
+					"to": { "type": "string" }
+				},
+				"required": [
+					"type",
+					"from",
+					"to"
+				]
+			},
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "repo_transferred"
+					},
+					"fromOwner": { "type": "string" },
+					"toOwner": { "type": "string" }
+				},
+				"required": ["type"]
+			},
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "repo_archived"
+					},
+					"archived": { "type": "boolean" }
+				},
+				"required": ["type", "archived"]
+			},
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "installation"
+					},
+					"actionRaw": { "type": "string" },
+					"installationId": { "type": "string" },
+					"added": {
+						"type": "array",
+						"items": { "$ref": "#/components/schemas/RepoRef" }
+					},
+					"removed": {
+						"type": "array",
+						"items": { "$ref": "#/components/schemas/RepoRef" }
+					}
+				},
+				"required": [
+					"type",
+					"actionRaw",
+					"added",
+					"removed"
+				]
+			},
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "membership"
+					},
+					"actionRaw": { "type": "string" },
+					"member": { "$ref": "#/components/schemas/Actor" }
+				},
+				"required": ["type", "actionRaw"]
+			},
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "release"
+					},
+					"release": { "$ref": "#/components/schemas/ReleaseRef" },
+					"name": { "type": "string" }
+				},
+				"required": ["type", "release"]
+			},
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "referenced"
+					},
+					"from": { "anyOf": [{ "$ref": "#/components/schemas/ThreadRef" }, { "$ref": "#/components/schemas/CommitRef" }] },
+					"fromRepo": { "$ref": "#/components/schemas/RepoRef" },
+					"text": { "type": "string" }
+				},
+				"required": ["type"]
+			}
+		],
+		"description": "Typed detail for an event. Discriminated by `type`.",
+		"x-forges-type": "EventDetail"
+	},
+	EventKind: {
+		"type": "string",
+		"enum": [
+			"comment",
+			"review",
+			"review_comment",
+			"commit",
+			"label",
+			"state_change",
+			"assignment",
+			"mention",
+			"referenced",
+			"reaction",
+			"push",
+			"ref",
+			"repo",
+			"installation",
+			"membership",
+			"release",
+			"other"
+		],
+		"description": "What an event is about.",
+		"x-forges-type": "EventKind"
+	},
+	FileContent: {
+		"anyOf": [{
+			"type": "object",
+			"properties": {
+				"encoding": {
+					"type": "string",
+					"const": "utf-8"
+				},
+				"content": { "type": "string" },
+				"path": {
+					"type": "string",
+					"description": "The path from the repository root."
+				},
+				"sha": {
+					"type": "string",
+					"description": "Blob sha, where the forge reports one."
+				},
+				"size": { "type": "number" },
+				"url": {
+					"type": "string",
+					"description": "Web page for the file at this ref, where the forge has one."
+				}
+			},
+			"required": [
+				"content",
+				"encoding",
+				"path"
+			]
+		}, {
+			"type": "object",
+			"properties": {
+				"encoding": {
+					"type": "string",
+					"const": "binary"
+				},
+				"content": {
+					"description": "Bytes, as a `Uint8Array`. JSON cannot carry them.",
+					"x-forges-type": "Uint8Array"
+				},
+				"path": {
+					"type": "string",
+					"description": "The path from the repository root."
+				},
+				"sha": {
+					"type": "string",
+					"description": "Blob sha, where the forge reports one."
+				},
+				"size": { "type": "number" },
+				"url": {
+					"type": "string",
+					"description": "Web page for the file at this ref, where the forge has one."
+				}
+			},
+			"required": [
+				"content",
+				"encoding",
+				"path"
+			]
+		}],
+		"description": "A file's contents. Narrow on `encoding` to get text or bytes.",
+		"x-forges-type": "FileContent"
+	},
+	FileStatus: {
+		"type": "string",
+		"enum": [
+			"added",
+			"modified",
+			"removed",
+			"renamed",
+			"copied",
+			"changed"
+		],
+		"description": "How a commit or pull request changed a file.",
+		"x-forges-type": "FileStatus"
+	},
+	ForgeCapabilities: {
+		"type": "object",
+		"properties": {
+			"version": {
+				"type": "string",
+				"description": "Instance version the capabilities were computed for, when known."
+			},
+			"experimental": {
+				"type": "boolean",
+				"const": true,
+				"description": "The forge's API as a whole is unstable, so the provider can change with it."
+			},
+			"sources": {
+				"type": "object",
+				"properties": {
+					"poll": { "$ref": "#/components/schemas/Support" },
+					"webhook": { "$ref": "#/components/schemas/Support" },
+					"subscribe": { "$ref": "#/components/schemas/Support" }
+				},
+				"required": [
+					"poll",
+					"webhook",
+					"subscribe"
+				],
+				"description": "`subscribe` is a long-lived push stream; see {@link SourcesApi}."
+			},
+			"repos": {
+				"type": "object",
+				"properties": {
+					"get": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `repos.get()`."
+					},
+					"list": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `repos.list()` and `repos.listPage()`."
+					},
+					"labels": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `repos.labels()` and `repos.labelsPage()`."
+					},
+					"createLabel": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `repos.createLabel()`."
+					},
+					"milestones": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `repos.milestones()` and `repos.milestonesPage()`."
+					},
+					"collaborators": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `repos.collaborators()` and `repos.collaboratorsPage()`."
+					},
+					"permissionFor": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `repos.permissionFor()`."
+					},
+					"addCollaborator": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `repos.addCollaborator()`."
+					},
+					"assignableUsers": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `repos.assignableUsers()` and `repos.assignableUsersPage()`."
+					},
+					"reviewerCandidates": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `repos.reviewerCandidates()` and `repos.reviewerCandidatesPage()`."
+					}
+				},
+				"required": [
+					"get",
+					"list",
+					"labels",
+					"createLabel",
+					"milestones",
+					"collaborators",
+					"permissionFor",
+					"addCollaborator",
+					"assignableUsers",
+					"reviewerCandidates"
+				]
+			},
+			"users": {
+				"type": "object",
+				"properties": {
+					"get": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `users.get()`."
+					},
+					"me": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `users.me()`."
+					}
+				},
+				"required": ["get", "me"]
+			},
+			"threads": {
+				"type": "object",
+				"properties": {
+					"get": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.get()`, per thread kind."
+					},
+					"list": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.list()` and `threads.listPage()`, per thread kind."
+					},
+					"getMany": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `threads.getMany()`."
+					},
+					"events": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.events()` and `threads.eventsPage()`, per thread kind."
+					}
+				},
+				"required": [
+					"get",
+					"list",
+					"getMany",
+					"events"
+				]
+			},
+			"comments": {
+				"type": "object",
+				"properties": {
+					"list": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.comments()` and `threads.commentsPage()`, per thread kind."
+					},
+					"edit": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.editComment()`, per thread kind."
+					},
+					"delete": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.deleteComment()`, per thread kind."
+					}
+				},
+				"required": [
+					"list",
+					"edit",
+					"delete"
+				]
+			},
+			"reactions": {
+				"type": "object",
+				"properties": { "list": {
+					"$ref": "#/components/schemas/PerKind",
+					"description": "Support for `threads.reactions()` and `threads.reactionsPage()`, per thread kind."
+				} },
+				"required": ["list"],
+				"description": "Listing the reactions on a thread or one of its comments, per thread kind."
+			},
+			"notifications": {
+				"type": "object",
+				"properties": {
+					"list": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `notifications.list()` and `notifications.listPage()`."
+					},
+					"markRead": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `notifications.markRead()`."
+					},
+					"markDone": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `notifications.markDone()`."
+					},
+					"unsubscribe": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `notifications.unsubscribe()`."
+					},
+					"markAllRead": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `notifications.markAllRead()`."
+					},
+					"markAllDone": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `notifications.markAllDone()`."
+					},
+					"unreadCount": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `notifications.unreadCount()`."
+					}
+				},
+				"required": [
+					"list",
+					"markRead",
+					"markDone",
+					"unsubscribe",
+					"markAllRead",
+					"markAllDone",
+					"unreadCount"
+				]
+			},
+			"writes": {
+				"type": "object",
+				"properties": {
+					"comment": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.comment()`, per thread kind."
+					},
+					"upsertComment": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Composed from `comment`, `comments.list` and `comments.edit`, so `'emulated'` where it works at all, or `'unverified'` where a part is."
+					},
+					"close": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.close()`, per thread kind."
+					},
+					"reopen": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.reopen()`, per thread kind."
+					},
+					"create": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.create()`, per thread kind."
+					},
+					"update": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.update()`, per thread kind."
+					},
+					"setLabels": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.setLabels()`, per thread kind."
+					},
+					"addLabels": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.addLabels()`, per thread kind."
+					},
+					"removeLabels": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.removeLabels()`, per thread kind."
+					},
+					"setMilestone": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.setMilestone()`, per thread kind."
+					},
+					"react": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.react()` and `threads.unreact()`, per thread kind."
+					},
+					"setAssignees": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.setAssignees()`, per thread kind."
+					},
+					"requestReview": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.requestReview()`, per thread kind."
+					},
+					"merge": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `threads.merge()`."
+					},
+					"approveAndMerge": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Composed from `merge` and `reviews.approve`."
+					},
+					"transfer": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `threads.transfer()`."
+					},
+					"markDuplicate": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `threads.markDuplicate()`."
+					}
+				},
+				"required": [
+					"comment",
+					"upsertComment",
+					"close",
+					"reopen",
+					"create",
+					"update",
+					"setLabels",
+					"addLabels",
+					"removeLabels",
+					"setMilestone",
+					"react",
+					"setAssignees",
+					"requestReview",
+					"merge",
+					"approveAndMerge",
+					"transfer",
+					"markDuplicate"
+				],
+				"description": "Write verbs, per thread kind except `merge`, `approveAndMerge`, `transfer` and `markDuplicate`."
+			},
+			"subscriptions": {
+				"type": "object",
+				"properties": {
+					"get": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.subscription()`, per thread kind."
+					},
+					"set": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.subscribe()` and `threads.unsubscribe()`, per thread kind."
+					}
+				},
+				"required": ["get", "set"],
+				"description": "Reading a thread subscription (`get`) and changing it (`set`), per kind. Distinct from notification unsubscribe."
+			},
+			"checks": {
+				"type": "object",
+				"properties": {
+					"thread": {
+						"$ref": "#/components/schemas/PerKind",
+						"description": "Support for `threads.checks()`, per thread kind."
+					},
+					"list": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `checks.list()`."
+					},
+					"report": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `checks.report()`."
+					},
+					"rerun": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `checks.rerun()`."
+					}
+				},
+				"required": [
+					"thread",
+					"list",
+					"report",
+					"rerun"
+				],
+				"description": "`thread` covers `Thread.checks` and `threads.checks()` (pull requests only); the rest are the commit-level surface. `report` is a commit status unless the credential can write check runs."
+			},
+			"ci": {
+				"type": "object",
+				"properties": {
+					"runs": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `ci.runs()` and `ci.runsPage()`."
+					},
+					"run": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `ci.run()`."
+					},
+					"jobs": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `ci.jobs()` and `ci.jobsPage()`."
+					},
+					"log": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `ci.log()`."
+					}
+				},
+				"required": [
+					"runs",
+					"run",
+					"jobs",
+					"log"
+				],
+				"description": "Read-only CI surface. `log` is `false` where job logs are not reachable over the API."
+			},
+			"reviews": {
+				"type": "object",
+				"properties": {
+					"list": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `threads.reviews()` and `threads.reviewsPage()`."
+					},
+					"create": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `threads.createReview()`."
+					},
+					"submit": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `threads.submitReview()`."
+					},
+					"approve": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `threads.approve()`."
+					},
+					"resolveThread": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `threads.resolveReviewThread()` and `threads.unresolveReviewThread()`."
+					}
+				},
+				"required": [
+					"list",
+					"create",
+					"submit",
+					"approve",
+					"resolveThread"
+				],
+				"description": "Reviews on a pull request. `list` is `'emulated'` where reviews are synthesised from approvals or votes; `create` then covers only the events the forge's approval endpoint can express."
+			},
+			"contents": {
+				"type": "object",
+				"properties": {
+					"file": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `contents.file()`."
+					},
+					"tree": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `contents.tree()` and `contents.treePage()`."
+					},
+					"branches": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `contents.branches()` and `contents.branchesPage()`."
+					},
+					"tags": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `contents.tags()` and `contents.tagsPage()`."
+					},
+					"resolveRef": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `contents.resolveRef()`."
+					},
+					"commits": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `contents.commits()` and `contents.commitsPage()`."
+					},
+					"commit": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `contents.commit()`."
+					},
+					"compare": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `contents.compare()`."
+					},
+					"threadFiles": {
+						"$ref": "#/components/schemas/Support",
+						"description": "`threads.files` and `threads.commits` on a pull request."
+					},
+					"threadCommits": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `threads.commits()` and `threads.commitsPage()`."
+					}
+				},
+				"required": [
+					"file",
+					"tree",
+					"branches",
+					"tags",
+					"resolveRef",
+					"commits",
+					"commit",
+					"compare",
+					"threadFiles",
+					"threadCommits"
+				],
+				"description": "Repository contents. `tree` is `'emulated'` where recursion is walked level by level rather than by the forge."
+			},
+			"webhooks": {
+				"type": "object",
+				"properties": {
+					"list": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `webhooks.list()` and `webhooks.listPage()`."
+					},
+					"create": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `webhooks.create()`."
+					},
+					"update": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `webhooks.update()`."
+					},
+					"delete": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `webhooks.delete()`."
+					},
+					"rotateSecret": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `webhooks.rotateSecret()`."
+					},
+					"deliveries": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `webhooks.deliveries()` and `webhooks.deliveriesPage()`."
+					},
+					"redeliver": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `webhooks.redeliver()`."
+					}
+				},
+				"required": [
+					"list",
+					"create",
+					"update",
+					"delete",
+					"rotateSecret",
+					"deliveries",
+					"redeliver"
+				],
+				"description": "Managing registered webhooks, beside receiving deliveries."
+			},
+			"releases": {
+				"type": "object",
+				"properties": {
+					"list": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `releases.list()` and `releases.listPage()`."
+					},
+					"get": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `releases.get()`."
+					},
+					"latest": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `releases.latest()`."
+					},
+					"getByTag": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `releases.getByTag()`."
+					},
+					"downloadAsset": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `releases.downloadAsset()`."
+					},
+					"create": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `releases.create()`."
+					},
+					"update": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `releases.update()`."
+					}
+				},
+				"required": [
+					"list",
+					"get",
+					"latest",
+					"getByTag",
+					"downloadAsset",
+					"create",
+					"update"
+				]
+			},
+			"search": {
+				"type": "object",
+				"properties": {
+					"threads": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `search.threads()` and `search.threadsPage()`."
+					},
+					"repos": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `search.repos()` and `search.reposPage()`."
+					},
+					"commits": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `search.commits()` and `search.commitsPage()`."
+					},
+					"code": {
+						"$ref": "#/components/schemas/Support",
+						"description": "Support for `search.code()` and `search.codePage()`."
+					}
+				},
+				"required": [
+					"threads",
+					"repos",
+					"commits",
+					"code"
+				],
+				"description": "Cross-repository search of issues and pull requests, repositories, commits and code."
+			},
+			"securityAlerts": {
+				"$ref": "#/components/schemas/AlertSupport",
+				"description": "Per alert kind, since each needs its own token scope on GitHub."
+			},
+			"installations": {
+				"$ref": "#/components/schemas/Support",
+				"description": "Enumerating app installations and deriving one provider per installation."
+			},
+			"eventKinds": {
+				"type": "string",
+				"enum": ["native", "heuristic"],
+				"description": "`'heuristic'` when event kinds are inferred from free text (GitLab system notes) rather than reported by the forge, so `kind` may be `'other'` or wrong for unrecognised wording; `kindRaw` and `payload` stay exact."
+			},
+			"authKinds": {
+				"type": "array",
+				"items": { "$ref": "#/components/schemas/AuthKind" },
+				"description": "Auth types the provider accepts. The type this provider was created with is `ForgeProvider.authKind`."
+			},
+			"limits": {
+				"$ref": "#/components/schemas/TextLimits",
+				"description": "Maximum text lengths the forge accepts."
+			}
+		},
+		"required": [
+			"sources",
+			"repos",
+			"users",
+			"threads",
+			"comments",
+			"reactions",
+			"notifications",
+			"writes",
+			"subscriptions",
+			"checks",
+			"ci",
+			"reviews",
+			"contents",
+			"webhooks",
+			"releases",
+			"search",
+			"securityAlerts",
+			"installations",
+			"eventKinds",
+			"authKinds"
+		],
+		"description": "What a provider supports, operation by operation. It is computed without a request, and `refreshCapabilities()` refines it with the instance version. Each group holds one entry per capability, and the [capability matrix](/reference/capability-matrix) lists them for every forge.",
+		"x-forges-type": "ForgeCapabilities"
+	},
+	ForgeEvent: {
+		"type": "object",
+		"properties": {
+			"forge": { "$ref": "#/components/schemas/ForgeKind" },
+			"instance": {
+				"$ref": "#/components/schemas/ForgeInstance",
+				"description": "The host of the instance, such as `github.com` or `git.example.com`."
+			},
+			"id": { "type": "string" },
+			"kind": { "$ref": "#/components/schemas/EventKind" },
+			"kindRaw": {
+				"type": "string",
+				"description": "Forge-native event name the normalised `kind` was derived from."
+			},
+			"action": {
+				"$ref": "#/components/schemas/EventAction",
+				"description": "Normalised verb; `other` when the forge's wording has no equivalent."
+			},
+			"actionRaw": {
+				"type": "string",
+				"description": "Forge-native verb `action` was derived from."
+			},
+			"summary": {
+				"type": "string",
+				"description": "Single line describing the event, suitable for a list row."
+			},
+			"occurredAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"actor": { "$ref": "#/components/schemas/Actor" },
+			"repo": { "$ref": "#/components/schemas/RepoRef" },
+			"thread": { "$ref": "#/components/schemas/ThreadRef" },
+			"detail": {
+				"$ref": "#/components/schemas/EventDetail",
+				"description": "The details that belong to the kind of event."
+			},
+			"installationId": {
+				"type": "string",
+				"description": "App installation the delivery belongs to, for app webhooks."
+			},
+			"source": {
+				"$ref": "#/components/schemas/SourceKind",
+				"description": "Delivery mechanism the event arrived through."
+			},
+			"payload": { "description": "Unnormalised forge payload, retained for fidelity." }
+		},
+		"required": [
+			"action",
+			"forge",
+			"id",
+			"instance",
+			"kind",
+			"occurredAt",
+			"payload",
+			"source",
+			"summary"
+		],
+		"description": "An event on a forge, such as a comment, a state change or a push.",
+		"x-forges-type": "ForgeEvent"
+	},
+	ForgeInstance: {
+		"type": "string",
+		"description": "Host of a single forge deployment, for example `github.com` or `codeberg.org`.",
+		"x-forges-type": "ForgeInstance"
+	},
+	ForgeKind: {
+		"anyOf": [{ "$ref": "#/components/schemas/KnownForgeKind" }, { "type": "string" }],
+		"description": "Identifier of a forge implementation. Unknown forges are permitted so that third-party providers can be registered without a core release.",
+		"x-forges-type": "ForgeKind"
+	},
+	ForgeWarning: {
+		"type": "object",
+		"properties": {
+			"code": {
+				"$ref": "#/components/schemas/ForgeWarningCode",
+				"description": "Stable machine-readable code."
+			},
+			"message": {
+				"type": "string",
+				"description": "A description of the problem, for a person."
+			},
+			"subject": {
+				"type": "string",
+				"description": "Key or URI of the item the warning concerns, when it concerns one."
+			},
+			"cause": {
+				"type": "object",
+				"properties": {
+					"name": { "type": "string" },
+					"message": { "type": "string" },
+					"status": { "type": "number" }
+				},
+				"required": ["name", "message"]
+			}
+		},
+		"required": ["code", "message"],
+		"description": "A non-fatal problem encountered while producing a result.",
+		"x-forges-type": "ForgeWarning"
+	},
+	ForgeWarningCode: {
+		"type": "string",
+		"description": "The warning codes providers emit; providers may add codes in a minor release.",
+		"x-forges-type": "ForgeWarningCode"
+	},
+	GetManyResult: {
+		"anyOf": [{
+			"type": "object",
+			"properties": {
+				"ok": {
+					"type": "boolean",
+					"const": true
+				},
+				"ref": { "$ref": "#/components/schemas/ThreadRef" },
+				"thread": { "$ref": "#/components/schemas/Thread" }
+			},
+			"required": [
+				"ok",
+				"ref",
+				"thread"
+			]
+		}, {
+			"type": "object",
+			"properties": {
+				"ok": {
+					"type": "boolean",
+					"const": false
+				},
+				"ref": { "$ref": "#/components/schemas/ThreadRef" },
+				"warning": { "$ref": "#/components/schemas/ForgeWarning" }
+			},
+			"required": [
+				"ok",
+				"ref",
+				"warning"
+			]
+		}],
+		"description": "One `threads.getMany()` entry, in input order; narrow on `ok`.",
+		"x-forges-type": "GetManyResult"
+	},
+	Installation: {
+		"type": "object",
+		"properties": {
+			"forge": { "$ref": "#/components/schemas/ForgeKind" },
+			"instance": {
+				"$ref": "#/components/schemas/ForgeInstance",
+				"description": "The host of the instance, such as `github.com` or `git.example.com`."
+			},
+			"id": { "type": "string" },
+			"account": { "$ref": "#/components/schemas/Actor" },
+			"targetTypeRaw": {
+				"type": "string",
+				"description": "Forge-native target type, for example `Organization` or `User`."
+			},
+			"repositorySelectionRaw": {
+				"type": "string",
+				"description": "Forge-native repository selection, for example `all` or `selected`."
+			},
+			"raw": {}
+		},
+		"required": [
+			"forge",
+			"id",
+			"instance",
+			"raw"
+		],
+		"description": "An app installation on an account, with its own credential scope.",
+		"x-forges-type": "Installation"
+	},
+	InstallationToken: {
+		"type": "object",
+		"properties": {
+			"token": { "type": "string" },
+			"expiresAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"permissions": {
+				"type": "object",
+				"additionalProperties": { "type": "string" }
+			},
+			"repositorySelection": {
+				"type": "string",
+				"description": "Whether the token reaches all repositories or only selected ones."
+			}
+		},
+		"required": [
+			"token",
+			"expiresAt",
+			"permissions"
+		],
+		"description": "A short-lived token that acts as one app installation.",
+		"x-forges-type": "InstallationToken"
+	},
+	KnownForgeKind: {
+		"type": "string",
+		"enum": [
+			"github",
+			"gitlab",
+			"bitbucket",
+			"forgejo",
+			"gitea",
+			"tangled",
+			"gitee",
+			"azure-devops",
+			"cursor-origin",
+			"pushin"
+		],
+		"description": "The forges this package ships providers for.",
+		"x-forges-type": "KnownForgeKind"
+	},
+	Label: {
+		"type": "object",
+		"properties": {
+			"name": { "type": "string" },
+			"colour": {
+				"type": "string",
+				"description": "The colour as hex digits, without a leading `#`."
+			},
+			"description": { "type": "string" }
+		},
+		"required": ["name"],
+		"description": "A label that a repository defines.",
+		"x-forges-type": "Label"
+	},
+	MergeMethod: {
+		"type": "string",
+		"enum": [
+			"merge",
+			"squash",
+			"rebase",
+			"rebase_merge",
+			"fast_forward_only"
+		],
+		"description": "How a pull request is merged.",
+		"x-forges-type": "MergeMethod"
+	},
+	Milestone: {
+		"type": "object",
+		"properties": {
+			"id": {
+				"type": "string",
+				"description": "Forge-native milestone id, as `threads.setMilestone` takes it."
+			},
+			"title": { "type": "string" },
+			"state": {
+				"type": "string",
+				"enum": ["open", "closed"]
+			},
+			"description": { "type": "string" },
+			"dueOn": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"url": { "type": "string" },
+			"raw": {}
+		},
+		"required": [
+			"id",
+			"title",
+			"state",
+			"raw"
+		],
+		"description": "A milestone that groups threads.",
+		"x-forges-type": "Milestone"
+	},
+	Notification: {
+		"type": "object",
+		"properties": {
+			"ref": { "$ref": "#/components/schemas/NotificationRef" },
+			"subject": { "$ref": "#/components/schemas/NotificationSubject" },
+			"reason": {
+				"$ref": "#/components/schemas/NotificationReason",
+				"description": "Why the account got the notification."
+			},
+			"reasonRaw": {
+				"type": "string",
+				"description": "Forge-native reason string. Absent when the forge reports no reason at all."
+			},
+			"subjectTypeRaw": {
+				"type": "string",
+				"description": "Forge-native subject type, for example `PullRequest`, `Release` or `followed`."
+			},
+			"unread": { "type": "boolean" },
+			"title": { "type": "string" },
+			"subjectState": {
+				"$ref": "#/components/schemas/ThreadState",
+				"description": "State of a thread subject as reported by the notification payload."
+			},
+			"subjectStateRaw": { "type": "string" },
+			"updatedAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"lastReadAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"url": { "type": "string" },
+			"raw": { "description": "Unnormalised forge payload, retained for fidelity." }
+		},
+		"required": [
+			"ref",
+			"subject",
+			"reason",
+			"unread",
+			"title",
+			"subjectState",
+			"updatedAt",
+			"raw"
+		],
+		"description": "A notification of the authenticated account.",
+		"x-forges-type": "Notification"
+	},
+	NotificationReason: {
+		"type": "string",
+		"enum": [
+			"access_requested",
+			"approval_requested",
+			"assigned",
+			"author",
+			"ci_activity",
+			"comment",
+			"followed",
+			"invitation",
+			"manual",
+			"mention",
+			"merge_blocked",
+			"review_requested",
+			"review_submitted",
+			"security_alert",
+			"starred",
+			"state_change",
+			"subscribed",
+			"team_mention",
+			"unknown"
+		],
+		"description": "Why a notification was delivered. `'unknown'` covers forges that report no reason and native reasons with no normalised equivalent; `reasonRaw` keeps the original.",
+		"x-forges-type": "NotificationReason"
+	},
+	NotificationRef: {
+		"type": "object",
+		"properties": {
+			"forge": { "$ref": "#/components/schemas/ForgeKind" },
+			"instance": {
+				"$ref": "#/components/schemas/ForgeInstance",
+				"description": "The host of the instance, such as `github.com` or `git.example.com`."
+			},
+			"id": {
+				"type": "string",
+				"description": "Forge-native notification identifier, used for read/done/unsubscribe writes."
+			}
+		},
+		"required": [
+			"forge",
+			"id",
+			"instance"
+		],
+		"description": "Reference to a notification. Distinct from {@link ThreadRef}: a notification is a per-user delivery record whose lifetime and identity are independent of the thread it points at.",
+		"x-forges-type": "NotificationRef"
+	},
+	NotificationSubject: {
+		"anyOf": [
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "thread"
+					},
+					"thread": { "$ref": "#/components/schemas/ThreadRef" }
+				},
+				"required": ["type", "thread"]
+			},
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "repo"
+					},
+					"repo": { "$ref": "#/components/schemas/RepoRef" }
+				},
+				"required": ["type", "repo"]
+			},
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "actor"
+					},
+					"actor": { "$ref": "#/components/schemas/Actor" }
+				},
+				"required": ["type", "actor"]
+			},
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "release"
+					},
+					"release": { "$ref": "#/components/schemas/ReleaseRef" }
+				},
+				"required": ["type", "release"]
+			},
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "security_alert"
+					},
+					"alert": { "$ref": "#/components/schemas/SecurityAlertRef" }
+				},
+				"required": ["type", "alert"]
+			},
+			{
+				"type": "object",
+				"properties": {
+					"type": {
+						"type": "string",
+						"const": "other"
+					},
+					"typeRaw": { "type": "string" },
+					"repo": { "$ref": "#/components/schemas/RepoRef" },
+					"id": { "type": "string" },
+					"url": { "type": "string" }
+				},
+				"required": ["type", "typeRaw"]
+			}
+		],
+		"description": "What a notification is about. Not every notification concerns a thread.",
+		"x-forges-type": "NotificationSubject"
+	},
+	PerKind: {
+		"type": "object",
+		"properties": {
+			"issue": { "$ref": "#/components/schemas/Support" },
+			"pull_request": { "$ref": "#/components/schemas/Support" },
+			"discussion": { "$ref": "#/components/schemas/Support" },
+			"commit": { "$ref": "#/components/schemas/Support" }
+		},
+		"required": [
+			"issue",
+			"pull_request",
+			"discussion",
+			"commit"
+		],
+		"description": "Per-thread-kind support. `'other'` subjects have no verbs, so they have no entry.",
+		"x-forges-type": "PerKind"
+	},
+	PullBranches: {
+		"type": "object",
+		"properties": {
+			"head": {
+				"type": "object",
+				"properties": {
+					"ref": { "type": "string" },
+					"sha": { "type": "string" },
+					"repo": {
+						"$ref": "#/components/schemas/RepoRef",
+						"description": "The repository that holds the head branch, which differs for a fork."
+					}
+				},
+				"required": ["ref"],
+				"description": "`sha` is absent on forges where a pull is a patch rather than a branch (Tangled)."
+			},
+			"base": {
+				"type": "object",
+				"properties": {
+					"ref": { "type": "string" },
+					"sha": { "type": "string" }
+				},
+				"required": ["ref"]
+			},
+			"mergeCommitSha": {
+				"type": "string",
+				"description": "The merge commit, once the pull request is merged."
+			}
+		},
+		"required": ["head", "base"],
+		"description": "The branches of a pull request.",
+		"x-forges-type": "PullBranches"
+	},
+	PushCommit: {
+		"type": "object",
+		"properties": {
+			"sha": { "type": "string" },
+			"message": { "type": "string" },
+			"author": { "type": "string" },
+			"url": { "type": "string" }
+		},
+		"required": ["sha"],
+		"description": "A commit as a push delivery reports it.",
+		"x-forges-type": "PushCommit"
+	},
+	Reaction: {
+		"type": "object",
+		"properties": {
+			"content": {
+				"anyOf": [{ "$ref": "#/components/schemas/ReactionContent" }, {
+					"type": "string",
+					"const": "other"
+				}],
+				"description": "`'other'` where the forge's name has no entry in {@link ReactionContent}."
+			},
+			"contentRaw": {
+				"type": "string",
+				"description": "The forge's own name for the reaction, such as a GitLab award emoji or a Forgejo emoji."
+			},
+			"actor": { "$ref": "#/components/schemas/Actor" },
+			"createdAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"raw": {}
+		},
+		"required": [
+			"content",
+			"contentRaw",
+			"actor",
+			"raw"
+		],
+		"description": "One reaction left on a thread or a comment, as `threads.reactions()` lists them.",
+		"x-forges-type": "Reaction"
+	},
+	ReactionContent: {
+		"type": "string",
+		"enum": [
+			"+1",
+			"-1",
+			"laugh",
+			"confused",
+			"heart",
+			"hooray",
+			"rocket",
+			"eyes"
+		],
+		"description": "The reactions every forge with reactions has in common, named as GitHub names them. A {@link Reaction} whose forge-native name has no entry here has `content: 'other'`, with the forge-native name in `contentRaw`.",
+		"x-forges-type": "ReactionContent"
+	},
+	ReactionSummary: {
+		"type": "object",
+		"properties": {
+			"total": {
+				"type": "number",
+				"description": "The number of reactions of every kind."
+			},
+			"counts": {
+				"type": "object",
+				"properties": {
+					"+1": { "type": "number" },
+					"-1": { "type": "number" },
+					"laugh": { "type": "number" },
+					"confused": { "type": "number" },
+					"heart": { "type": "number" },
+					"hooray": { "type": "number" },
+					"rocket": { "type": "number" },
+					"eyes": { "type": "number" }
+				},
+				"description": "The number of reactions of each kind. A reaction with no {@link ReactionContent} entry has no key here."
+			},
+			"viewerReacted": {
+				"type": "array",
+				"items": { "$ref": "#/components/schemas/ReactionContent" },
+				"description": "Reactions the authenticated account has left. Absent when the forge does not report them."
+			}
+		},
+		"required": ["total", "counts"],
+		"description": "The reactions on a thread or comment, counted.",
+		"x-forges-type": "ReactionSummary"
+	},
+	Release: {
+		"type": "object",
+		"properties": {
+			"ref": { "$ref": "#/components/schemas/ReleaseRef" },
+			"name": { "type": "string" },
+			"tag": { "type": "string" },
+			"body": {
+				"type": "string",
+				"description": "The release notes."
+			},
+			"isDraft": { "type": "boolean" },
+			"isPrerelease": { "type": "boolean" },
+			"immutable": {
+				"type": "boolean",
+				"description": "The release is immutable: its tag and assets are locked. `true` where the forge supports immutable releases and this one is published as immutable (GitHub). The name, notes, prerelease and latest flags stay editable."
+			},
+			"author": { "$ref": "#/components/schemas/Actor" },
+			"publishedAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"createdAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"url": { "type": "string" },
+			"assets": {
+				"type": "array",
+				"items": { "$ref": "#/components/schemas/ReleaseAsset" }
+			},
+			"raw": {}
+		},
+		"required": [
+			"ref",
+			"tag",
+			"isDraft",
+			"isPrerelease",
+			"raw"
+		],
+		"description": "A release of a repository.",
+		"x-forges-type": "Release"
+	},
+	ReleaseAsset: {
+		"type": "object",
+		"properties": {
+			"ref": {
+				"$ref": "#/components/schemas/ReleaseAssetRef",
+				"description": "Absent where the forge publishes a download URL but nothing to address the asset by."
+			},
+			"name": { "type": "string" },
+			"url": { "type": "string" },
+			"size": { "type": "number" },
+			"downloadCount": { "type": "number" },
+			"contentType": {
+				"type": "string",
+				"description": "The media type."
+			}
+		},
+		"required": ["name", "url"],
+		"description": "A file attached to a release.",
+		"x-forges-type": "ReleaseAsset"
+	},
+	ReleaseAssetRef: {
+		"type": "object",
+		"properties": {
+			"forge": { "$ref": "#/components/schemas/ForgeKind" },
+			"instance": {
+				"$ref": "#/components/schemas/ForgeInstance",
+				"description": "The host of the instance, such as `github.com` or `git.example.com`."
+			},
+			"repo": { "$ref": "#/components/schemas/RepoRef" },
+			"release": { "$ref": "#/components/schemas/ReleaseRef" },
+			"id": {
+				"type": "string",
+				"description": "Forge-native asset id; the asset name, or the link id, on forges that have no asset id."
+			}
+		},
+		"required": [
+			"forge",
+			"id",
+			"instance",
+			"release",
+			"repo"
+		],
+		"description": "A release asset, addressable for download with `releases.downloadAsset`.",
+		"x-forges-type": "ReleaseAssetRef"
+	},
+	ReleaseRef: {
+		"type": "object",
+		"properties": {
+			"forge": { "$ref": "#/components/schemas/ForgeKind" },
+			"instance": {
+				"$ref": "#/components/schemas/ForgeInstance",
+				"description": "The host of the instance, such as `github.com` or `git.example.com`."
+			},
+			"repo": { "$ref": "#/components/schemas/RepoRef" },
+			"id": {
+				"type": "string",
+				"description": "Forge-native release id; the tag name on forges that key releases by tag."
+			},
+			"tag": { "type": "string" }
+		},
+		"required": [
+			"forge",
+			"id",
+			"instance",
+			"repo"
+		],
+		"description": "A release, as a notification subject or event target.",
+		"x-forges-type": "ReleaseRef"
+	},
+	Repo: {
+		"type": "object",
+		"properties": {
+			"ref": { "$ref": "#/components/schemas/RepoRef" },
+			"displayName": {
+				"type": "string",
+				"description": "The repository's name where `ref.name` is an identifier rather than the name (a Tangled record key)."
+			},
+			"description": { "type": "string" },
+			"defaultBranch": { "type": "string" },
+			"visibility": {
+				"$ref": "#/components/schemas/RepoVisibility",
+				"description": "Who can see the repository."
+			},
+			"visibilityRaw": { "type": "string" },
+			"isFork": { "type": "boolean" },
+			"isArchived": {
+				"type": "boolean",
+				"description": "The repository is archived and read-only."
+			},
+			"parent": {
+				"$ref": "#/components/schemas/RepoRef",
+				"description": "The repository that this one was forked from."
+			},
+			"topics": {
+				"type": "array",
+				"items": { "type": "string" },
+				"description": "Topics, also called tags, that describe the repository."
+			},
+			"url": { "type": "string" },
+			"cloneUrls": {
+				"type": "object",
+				"properties": {
+					"https": { "type": "string" },
+					"ssh": { "type": "string" }
+				},
+				"description": "Git remotes. Tangled maps the hosting knot to its SSH host."
+			},
+			"createdAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"updatedAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"pushedAt": {
+				"type": "string",
+				"format": "date-time",
+				"description": "Last push, where the listing endpoint reports it."
+			},
+			"openIssueCount": {
+				"type": "number",
+				"description": "Open issues only, never combined with pull requests. Absent where the forge reports only the combined count (GitHub)."
+			},
+			"openPullCount": {
+				"type": "number",
+				"description": "The number of open pull requests, where the forge reports it."
+			},
+			"owner": {
+				"$ref": "#/components/schemas/Actor",
+				"description": "The account or organisation that owns the repository, where the forge reports one."
+			},
+			"language": {
+				"type": "string",
+				"description": "Primary language, as the forge detects it."
+			},
+			"homepage": {
+				"type": "string",
+				"description": "Project website, apart from the repository's own `url`."
+			},
+			"licence": {
+				"type": "string",
+				"description": "SPDX identifier of the licence the forge detects, for example `MIT`. SPDX identifiers are case-insensitive, and GitLab reports them in lower case, such as `mit`."
+			},
+			"stars": { "type": "number" },
+			"forks": { "type": "number" },
+			"watchers": {
+				"type": "number",
+				"description": "Accounts watching the repository's activity, apart from stars."
+			},
+			"permissions": {
+				"$ref": "#/components/schemas/RepoPermissions",
+				"description": "What the authenticated account may do."
+			},
+			"mergeMethods": {
+				"type": "array",
+				"items": { "$ref": "#/components/schemas/MergeMethod" },
+				"description": "Merge methods the repository allows, where the forge reports them. Empty means the forge reported none."
+			},
+			"features": { "$ref": "#/components/schemas/RepoFeatures" },
+			"raw": {}
+		},
+		"required": [
+			"ref",
+			"visibility",
+			"isFork",
+			"isArchived",
+			"topics",
+			"raw"
+		],
+		"description": "A repository as every forge reports it. Fields that not every forge has, such as `openPullCount`, are optional.",
+		"x-forges-type": "Repo"
+	},
+	RepoFeatures: {
+		"type": "object",
+		"properties": {
+			"issues": { "type": "boolean" },
+			"pullRequests": { "type": "boolean" },
+			"discussions": { "type": "boolean" },
+			"wiki": { "type": "boolean" },
+			"projects": { "type": "boolean" },
+			"releases": { "type": "boolean" }
+		},
+		"required": [
+			"issues",
+			"pullRequests",
+			"discussions",
+			"wiki",
+			"projects",
+			"releases"
+		],
+		"description": "Which subjects a repository has switched on, where the forge makes them per repository.",
+		"x-forges-type": "RepoFeatures"
+	},
+	RepoPermissions: {
+		"type": "object",
+		"properties": {
+			"admin": {
+				"type": "boolean",
+				"description": "Full administrative access."
+			},
+			"maintain": {
+				"type": "boolean",
+				"description": "Manage the repository without access to sensitive or destructive settings."
+			},
+			"push": { "type": "boolean" },
+			"triage": {
+				"type": "boolean",
+				"description": "Manage issues and pull requests without write access."
+			},
+			"pull": {
+				"type": "boolean",
+				"description": "Read and clone the repository."
+			}
+		},
+		"required": [
+			"admin",
+			"maintain",
+			"push",
+			"triage",
+			"pull"
+		],
+		"description": "The authenticated account's access to a repository.",
+		"x-forges-type": "RepoPermissions"
+	},
+	RepoRef: {
+		"type": "object",
+		"properties": {
+			"forge": { "$ref": "#/components/schemas/ForgeKind" },
+			"instance": {
+				"$ref": "#/components/schemas/ForgeInstance",
+				"description": "The host of the instance, such as `github.com` or `git.example.com`."
+			},
+			"owner": {
+				"type": "string",
+				"description": "Full namespace path. On forges with nested groups (GitLab) this contains slashes, for example `acme/platform`; `name` never does."
+			},
+			"name": {
+				"type": "string",
+				"description": "Repository name. Empty for namespace-scoped refs."
+			},
+			"kind": {
+				"type": "string",
+				"enum": ["repo", "namespace"],
+				"description": "`'namespace'` for subjects that belong to a group rather than a repository (GitLab epics). Absent means a repository."
+			},
+			"externalId": {
+				"type": "string",
+				"description": "Stable forge-native identifier that survives renames and transfers: a GitHub, Forgejo or Gitea numeric id, a GitLab project or group id, a Bitbucket UUID or a Tangled repo DID. {@link repoKey} prefers it over `owner` and `name`."
+			}
+		},
+		"required": [
+			"forge",
+			"instance",
+			"name",
+			"owner"
+		],
+		"description": "Addresses a repository by its forge, instance, owner and name.",
+		"x-forges-type": "RepoRef"
+	},
+	RepoRole: {
+		"type": "string",
+		"enum": [
+			"admin",
+			"maintain",
+			"write",
+			"triage",
+			"read",
+			"none"
+		],
+		"description": "A collaborator's role, highest first. `'none'` is an explicit absence of access.",
+		"x-forges-type": "RepoRole"
+	},
+	RepoVisibility: {
+		"type": "string",
+		"enum": [
+			"public",
+			"private",
+			"internal"
+		],
+		"description": "Who can see a repository.",
+		"x-forges-type": "RepoVisibility"
+	},
+	Review: {
+		"type": "object",
+		"properties": {
+			"ref": { "$ref": "#/components/schemas/ReviewRef" },
+			"author": { "$ref": "#/components/schemas/Actor" },
+			"state": { "$ref": "#/components/schemas/ReviewState" },
+			"stateRaw": { "type": "string" },
+			"body": { "type": "string" },
+			"submittedAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"comments": {
+				"anyOf": [{
+					"type": "array",
+					"items": { "$ref": "#/components/schemas/ReviewComment" }
+				}, {
+					"type": "boolean",
+					"const": false
+				}],
+				"description": "Inline comments submitted with the review. `false` where the forge has approvals but no review objects to hang comments on."
+			},
+			"url": { "type": "string" },
+			"raw": {}
+		},
+		"required": [
+			"ref",
+			"state",
+			"comments",
+			"raw"
+		],
+		"description": "A review of a pull request.",
+		"x-forges-type": "Review"
+	},
+	ReviewComment: {
+		"type": "object",
+		"properties": {
+			"ref": { "$ref": "#/components/schemas/CommentRef" },
+			"body": { "type": "string" },
+			"author": { "$ref": "#/components/schemas/Actor" },
+			"path": { "type": "string" },
+			"line": {
+				"type": "number",
+				"description": "Line in the file the comment is anchored to, in the side it is anchored to."
+			},
+			"side": {
+				"type": "string",
+				"enum": ["left", "right"],
+				"description": "`'left'` is the base of the diff, `'right'` the head."
+			},
+			"inReplyTo": {
+				"type": "string",
+				"description": "Forge-native id of the comment this one replies to."
+			},
+			"thread": {
+				"type": "object",
+				"properties": {
+					"id": { "type": "string" },
+					"resolved": { "type": "boolean" }
+				},
+				"required": ["id", "resolved"],
+				"description": "The resolvable conversation the comment belongs to, where the forge has one."
+			},
+			"createdAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"url": { "type": "string" },
+			"raw": {}
+		},
+		"required": ["body", "raw"],
+		"description": "A comment left on a line of the diff as part of a review.",
+		"x-forges-type": "ReviewComment"
+	},
+	ReviewCommentInput: {
+		"type": "object",
+		"properties": {
+			"path": { "type": "string" },
+			"line": {
+				"type": "number",
+				"description": "Line in the diff, in `side`."
+			},
+			"side": {
+				"type": "string",
+				"enum": ["left", "right"]
+			},
+			"startLine": {
+				"type": "number",
+				"description": "First line of a multi-line comment."
+			},
+			"body": { "type": "string" }
+		},
+		"required": ["path", "body"],
+		"description": "An inline comment to send with a review.",
+		"x-forges-type": "ReviewCommentInput"
+	},
+	ReviewRef: {
+		"type": "object",
+		"properties": {
+			"forge": { "$ref": "#/components/schemas/ForgeKind" },
+			"instance": {
+				"$ref": "#/components/schemas/ForgeInstance",
+				"description": "The host of the instance, such as `github.com` or `git.example.com`."
+			},
+			"thread": { "$ref": "#/components/schemas/ThreadRef" },
+			"id": {
+				"type": "string",
+				"description": "Forge-native review id; a synthesised `approval:<login>` where the forge has approvals but no review objects."
+			}
+		},
+		"required": [
+			"forge",
+			"id",
+			"instance",
+			"thread"
+		],
+		"description": "Reference to a review on a pull request.",
+		"x-forges-type": "ReviewRef"
+	},
+	ReviewState: {
+		"type": "string",
+		"enum": [
+			"approved",
+			"changes_requested",
+			"commented",
+			"pending",
+			"dismissed",
+			"unknown"
+		],
+		"description": "What a review or a reviewer says about a pull request. `unknown` is a state that the model does not name.",
+		"x-forges-type": "ReviewState"
+	},
+	Reviewer: {
+		"type": "object",
+		"properties": {
+			"actor": { "$ref": "#/components/schemas/Actor" },
+			"state": { "$ref": "#/components/schemas/ReviewState" },
+			"stateRaw": { "type": "string" },
+			"isTeam": {
+				"type": "boolean",
+				"description": "True when the reviewer is a team rather than an account."
+			}
+		},
+		"required": ["actor", "state"],
+		"description": "A reviewer who was asked to review a pull request, and what they said.",
+		"x-forges-type": "Reviewer"
+	},
+	SecurityAlert: {
+		"type": "object",
+		"properties": {
+			"ref": { "$ref": "#/components/schemas/SecurityAlertRef" },
+			"kind": { "$ref": "#/components/schemas/SecurityAlertKind" },
+			"kindRaw": { "type": "string" },
+			"severity": { "$ref": "#/components/schemas/SecuritySeverity" },
+			"severityRaw": { "type": "string" },
+			"state": {
+				"type": "string",
+				"enum": [
+					"open",
+					"fixed",
+					"dismissed",
+					"unknown"
+				]
+			},
+			"stateRaw": { "type": "string" },
+			"title": {
+				"type": "string",
+				"description": "A short description of the problem."
+			},
+			"package": {
+				"type": "object",
+				"properties": {
+					"ecosystem": { "type": "string" },
+					"name": { "type": "string" },
+					"vulnerableRange": { "type": "string" },
+					"fixedIn": { "type": "string" }
+				},
+				"required": ["name"],
+				"description": "`ecosystem` is absent where the forge reports only the package name."
+			},
+			"url": { "type": "string" },
+			"createdAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"updatedAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"dismissedAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"raw": {}
+		},
+		"required": [
+			"ref",
+			"kind",
+			"kindRaw",
+			"severity",
+			"state",
+			"stateRaw",
+			"title",
+			"raw"
+		],
+		"description": "A security alert on a repository.",
+		"x-forges-type": "SecurityAlert"
+	},
+	SecurityAlertKind: {
+		"type": "string",
+		"enum": [
+			"dependency",
+			"code_scanning",
+			"secret",
+			"advisory",
+			"other"
+		],
+		"description": "What an alert is about. `other` is a kind that the model does not name.",
+		"x-forges-type": "SecurityAlertKind"
+	},
+	SecurityAlertRef: {
+		"type": "object",
+		"properties": {
+			"forge": { "$ref": "#/components/schemas/ForgeKind" },
+			"instance": {
+				"$ref": "#/components/schemas/ForgeInstance",
+				"description": "The host of the instance, such as `github.com` or `git.example.com`."
+			},
+			"repo": { "$ref": "#/components/schemas/RepoRef" },
+			"id": {
+				"type": "string",
+				"description": "Forge-native alert id. GitHub numbers each alert kind separately, so `kind` is needed to address one."
+			},
+			"kind": { "$ref": "#/components/schemas/SecurityAlertKind" },
+			"severityRaw": { "type": "string" }
+		},
+		"required": [
+			"forge",
+			"id",
+			"instance",
+			"repo"
+		],
+		"description": "A security alert: a vulnerable dependency, a code scanning result, a leaked secret or an advisory.",
+		"x-forges-type": "SecurityAlertRef"
+	},
+	SecuritySeverity: {
+		"type": "string",
+		"enum": [
+			"critical",
+			"high",
+			"medium",
+			"low",
+			"unknown"
+		],
+		"description": "How severe an alert is. `unknown` is a level that the model does not name.",
+		"x-forges-type": "SecuritySeverity"
+	},
+	SourceKind: {
+		"type": "string",
+		"enum": [
+			"poll",
+			"webhook",
+			"subscribe"
+		],
+		"description": "How an event reached the caller.",
+		"x-forges-type": "SourceKind"
+	},
+	SubscriptionState: {
+		"type": "string",
+		"enum": [
+			"subscribed",
+			"ignored",
+			"none"
+		],
+		"description": "Whether the account gets notifications for a thread.",
+		"x-forges-type": "SubscriptionState"
+	},
+	Support: {
+		"anyOf": [
+			{ "type": "boolean" },
+			{
+				"type": "string",
+				"const": "emulated"
+			},
+			{
+				"type": "string",
+				"const": "experimental"
+			},
+			{
+				"type": "string",
+				"const": "unverified"
+			}
+		],
+		"description": "Capability flag. Every value other than `false` means the operation is available:\n\n- `true`: native, and verified against the forge's responses.\n- `'experimental'`: native and verified, but built on an API the forge marks unstable, so it can change.\n- `'emulated'`: composed from other calls, so the result is approximate.\n- `'unverified'`: implemented, but not yet verified against the forge's responses, so it may not work.",
+		"x-forges-type": "Support"
+	},
+	Tag: {
+		"type": "object",
+		"properties": {
+			"name": { "type": "string" },
+			"sha": {
+				"type": "string",
+				"description": "Commit the tag points at, after dereferencing an annotated tag where the forge does so."
+			},
+			"url": { "type": "string" },
+			"raw": {}
+		},
+		"required": [
+			"name",
+			"sha",
+			"raw"
+		],
+		"description": "A tag of a repository.",
+		"x-forges-type": "Tag"
+	},
+	TextLimits: {
+		"type": "object",
+		"properties": {
+			"bodyLength": { "type": "number" },
+			"commentLength": { "type": "number" },
+			"labelLength": { "type": "number" }
+		},
+		"description": "Maximum lengths the forge accepts, in characters.",
+		"x-forges-type": "TextLimits"
+	},
+	Thread: {
+		"type": "object",
+		"properties": {
+			"ref": { "$ref": "#/components/schemas/ThreadRef" },
+			"kind": { "$ref": "#/components/schemas/ThreadKind" },
+			"title": { "type": "string" },
+			"body": { "type": "string" },
+			"state": { "$ref": "#/components/schemas/ThreadState" },
+			"stateRaw": {
+				"type": "string",
+				"description": "Forge-native state string the normalised `state` was derived from."
+			},
+			"stateReason": {
+				"type": "string",
+				"description": "Forge-native state qualifier, for example `completed` or `not_planned`."
+			},
+			"isDraft": { "type": "boolean" },
+			"author": { "$ref": "#/components/schemas/Actor" },
+			"assignees": {
+				"type": "array",
+				"items": { "$ref": "#/components/schemas/Actor" }
+			},
+			"reviewers": {
+				"type": "array",
+				"items": { "$ref": "#/components/schemas/Reviewer" },
+				"description": "Reviewers the thread read reports. Some forges report outstanding requests only, others each reviewer's verdict; `threads.reviews()` has every submitted review."
+			},
+			"labels": {
+				"type": "array",
+				"items": { "$ref": "#/components/schemas/Label" }
+			},
+			"url": { "type": "string" },
+			"createdAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"updatedAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"closedAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"lastActivityAt": {
+				"type": "string",
+				"format": "date-time",
+				"description": "Latest activity the forge reports for the thread."
+			},
+			"locked": { "type": "boolean" },
+			"commentCount": { "type": "number" },
+			"participants": {
+				"type": "array",
+				"items": { "$ref": "#/components/schemas/Actor" },
+				"description": "Everyone who authored or commented on the thread, where the forge reports them."
+			},
+			"readState": {
+				"type": "string",
+				"enum": ["read", "unread"],
+				"description": "Whether the authenticated account has read the thread, where the forge tracks it per thread."
+			},
+			"subscription": {
+				"$ref": "#/components/schemas/SubscriptionState",
+				"description": "The authenticated account's subscription, where the thread read already carries it."
+			},
+			"milestone": { "$ref": "#/components/schemas/Milestone" },
+			"reactions": { "$ref": "#/components/schemas/ReactionSummary" },
+			"branches": {
+				"$ref": "#/components/schemas/PullBranches",
+				"description": "Pull requests only."
+			},
+			"checks": {
+				"$ref": "#/components/schemas/ChecksSummary",
+				"description": "Pull requests only."
+			},
+			"stack": {
+				"$ref": "#/components/schemas/ThreadStack",
+				"description": "Pull requests in a stack: a chain of dependent pull requests, each based on the one before."
+			},
+			"warnings": {
+				"type": "array",
+				"items": { "$ref": "#/components/schemas/ForgeWarning" },
+				"description": "Non-fatal problems hit while reading the thread, for example an unreachable record."
+			},
+			"raw": { "description": "Unnormalised forge payload, retained for fidelity." }
+		},
+		"required": [
+			"ref",
+			"kind",
+			"title",
+			"state",
+			"isDraft",
+			"assignees",
+			"reviewers",
+			"labels",
+			"raw"
+		],
+		"description": "An issue, pull request, discussion or commit conversation.",
+		"x-forges-type": "Thread"
+	},
+	ThreadKind: {
+		"type": "string",
+		"enum": [
+			"issue",
+			"pull_request",
+			"discussion",
+			"commit",
+			"other"
+		],
+		"description": "Kind of thread. `'other'` holds forge-specific subjects with no shared kind (check suites, epics); `ThreadRef.typeRaw` names them.",
+		"x-forges-type": "ThreadKind"
+	},
+	ThreadRef: {
+		"type": "object",
+		"properties": {
+			"forge": { "$ref": "#/components/schemas/ForgeKind" },
+			"instance": {
+				"$ref": "#/components/schemas/ForgeInstance",
+				"description": "The host of the instance, such as `github.com` or `git.example.com`."
+			},
+			"repo": { "$ref": "#/components/schemas/RepoRef" },
+			"kind": { "$ref": "#/components/schemas/ThreadKind" },
+			"typeRaw": {
+				"type": "string",
+				"description": "Forge-native subject type, for example `PullRequest` or `MergeRequest`."
+			},
+			"number": {
+				"type": "string",
+				"description": "Per-repo thread number, the commit sha for `kind: 'commit'`, or the forge-native id for `kind: 'other'`. Absent when the forge did not identify the thread; such a ref cannot be fetched or keyed until enriched."
+			},
+			"displayNumber": {
+				"type": "string",
+				"description": "Human-facing per-repo number, when it differs from `number`. Tangled identifies threads by AT-URI but shows numbers in its UI and webhooks."
+			},
+			"externalId": {
+				"type": "string",
+				"description": "Globally unique forge-native identifier, where one exists: a GitHub `node_id`, a GitLab global id, or an atproto record URI."
+			}
+		},
+		"required": [
+			"forge",
+			"instance",
+			"kind",
+			"repo"
+		],
+		"description": "Reference to a thread. A thread `number` is unique only within its repo, so the repo is always carried alongside it.",
+		"x-forges-type": "ThreadRef"
+	},
+	ThreadStack: {
+		"type": "object",
+		"properties": {
+			"id": {
+				"type": "string",
+				"description": "Forge-native stack id, where the forge names stacks."
+			},
+			"parent": {
+				"$ref": "#/components/schemas/ThreadRef",
+				"description": "The pull request this one is stacked on. Absent for the root of the stack."
+			}
+		},
+		"description": "Where a pull request sits in a stack of pull requests.",
+		"x-forges-type": "ThreadStack"
+	},
+	ThreadState: {
+		"type": "string",
+		"enum": [
+			"open",
+			"closed",
+			"merged",
+			"unknown"
+		],
+		"description": "Thread state. `'unknown'` is distinct from any real state and signals that the value was not present in the payload, so the caller may enrich it with `threads.get()`. Draft status is orthogonal; see `Thread.isDraft`.",
+		"x-forges-type": "ThreadState"
+	},
+	TreeEntry: {
+		"type": "object",
+		"properties": {
+			"path": {
+				"type": "string",
+				"description": "Path from the repository root, without a leading slash."
+			},
+			"type": { "$ref": "#/components/schemas/TreeEntryType" },
+			"sha": { "type": "string" },
+			"size": {
+				"type": "number",
+				"description": "The size in bytes, for a file."
+			},
+			"mode": {
+				"type": "string",
+				"description": "POSIX mode as the forge reports it, for example `100644`."
+			},
+			"url": { "type": "string" }
+		},
+		"required": ["path", "type"],
+		"description": "One entry of a repository tree.",
+		"x-forges-type": "TreeEntry"
+	},
+	TreeEntryType: {
+		"type": "string",
+		"enum": [
+			"file",
+			"directory",
+			"symlink",
+			"submodule"
+		],
+		"description": "What a tree entry is.",
+		"x-forges-type": "TreeEntryType"
+	},
+	UpsertCommentResult: {
+		"type": "object",
+		"properties": {
+			"comment": {
+				"$ref": "#/components/schemas/Comment",
+				"description": "The comment that was created or edited."
+			},
+			"created": {
+				"type": "boolean",
+				"description": "`false` when an existing comment with the same key was edited."
+			}
+		},
+		"required": ["comment", "created"],
+		"description": "What `threads.upsertComment()` did.",
+		"x-forges-type": "UpsertCommentResult"
+	},
+	User: {
+		"type": "object",
+		"properties": {
+			"forge": { "$ref": "#/components/schemas/ForgeKind" },
+			"instance": {
+				"$ref": "#/components/schemas/ForgeInstance",
+				"description": "The host of the instance, such as `github.com` or `git.example.com`."
+			},
+			"login": { "type": "string" },
+			"id": { "type": "string" },
+			"name": { "type": "string" },
+			"avatarUrl": { "type": "string" },
+			"url": { "type": "string" },
+			"typeRaw": {
+				"type": "string",
+				"description": "Forge-reported account type, retained verbatim for callers that classify further."
+			},
+			"isBotHint": {
+				"type": "boolean",
+				"description": "Hint derived from forge metadata that the actor is automation. Callers own the classification policy."
+			},
+			"app": {
+				"type": "object",
+				"properties": {
+					"slug": { "type": "string" },
+					"id": { "type": "string" }
+				},
+				"required": ["slug"],
+				"description": "The app behind a bot account, where the forge ties one to it (GitHub Apps' `slug[bot]` users)."
+			},
+			"bio": { "type": "string" },
+			"company": { "type": "string" },
+			"location": { "type": "string" },
+			"websiteUrl": { "type": "string" },
+			"createdAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"followers": { "type": "number" },
+			"following": { "type": "number" },
+			"publicRepos": { "type": "number" },
+			"raw": {}
+		},
+		"required": [
+			"forge",
+			"id",
+			"instance",
+			"isBotHint",
+			"login",
+			"raw"
+		],
+		"description": "A user or organisation account, as `users.get()` reads it.",
+		"x-forges-type": "User"
+	},
+	Webhook: {
+		"type": "object",
+		"properties": {
+			"ref": { "$ref": "#/components/schemas/WebhookRef" },
+			"url": { "type": "string" },
+			"events": {
+				"type": "array",
+				"items": { "$ref": "#/components/schemas/EventKind" },
+				"description": "Normalised kinds the subscription covers, derived from `nativeEvents`."
+			},
+			"nativeEvents": {
+				"type": "array",
+				"items": { "type": "string" },
+				"description": "Forge-native event names exactly as the forge stores them."
+			},
+			"active": { "type": "boolean" },
+			"contentType": {
+				"type": "string",
+				"enum": ["json", "form"],
+				"description": "`'json'` or `'form'` where the forge offers a choice."
+			},
+			"createdAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"updatedAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"secret": {
+				"not": {},
+				"description": "Never returned: no forge reads a webhook secret back."
+			},
+			"raw": {}
+		},
+		"required": [
+			"ref",
+			"url",
+			"events",
+			"nativeEvents",
+			"active",
+			"raw"
+		],
+		"description": "A registered webhook. The secret is never readable, so it is never returned.",
+		"x-forges-type": "Webhook"
+	},
+	WebhookDeliveryRecord: {
+		"type": "object",
+		"properties": {
+			"ref": { "$ref": "#/components/schemas/WebhookDeliveryRef" },
+			"event": {
+				"type": "string",
+				"description": "Forge-native event name of the delivery."
+			},
+			"status": {
+				"type": "number",
+				"description": "The HTTP status that the receiver answered with."
+			},
+			"ok": {
+				"type": "boolean",
+				"description": "`true` when the forge considered the delivery successful."
+			},
+			"deliveredAt": {
+				"type": "string",
+				"format": "date-time"
+			},
+			"duration": {
+				"type": "number",
+				"description": "Round trip in milliseconds, where the forge reports it."
+			},
+			"raw": {}
+		},
+		"required": [
+			"ref",
+			"event",
+			"status",
+			"ok",
+			"raw"
+		],
+		"description": "One recorded delivery attempt.",
+		"x-forges-type": "WebhookDeliveryRecord"
+	},
+	WebhookDeliveryRef: {
+		"type": "object",
+		"properties": {
+			"forge": { "$ref": "#/components/schemas/ForgeKind" },
+			"instance": {
+				"$ref": "#/components/schemas/ForgeInstance",
+				"description": "The host of the instance, such as `github.com` or `git.example.com`."
+			},
+			"hook": { "$ref": "#/components/schemas/WebhookRef" },
+			"id": { "type": "string" },
+			"guid": {
+				"type": "string",
+				"description": "Delivery guid, where the forge needs it to redeliver."
+			}
+		},
+		"required": [
+			"forge",
+			"hook",
+			"id",
+			"instance"
+		],
+		"description": "Reference to one delivery of a webhook.",
+		"x-forges-type": "WebhookDeliveryRef"
+	},
+	WebhookRef: {
+		"type": "object",
+		"properties": {
+			"forge": { "$ref": "#/components/schemas/ForgeKind" },
+			"instance": {
+				"$ref": "#/components/schemas/ForgeInstance",
+				"description": "The host of the instance, such as `github.com` or `git.example.com`."
+			},
+			"target": {
+				"$ref": "#/components/schemas/RepoRef",
+				"description": "The repository or namespace that the hook is registered on."
+			},
+			"id": {
+				"type": "string",
+				"description": "Forge-native hook id."
+			}
+		},
+		"required": [
+			"forge",
+			"id",
+			"instance",
+			"target"
+		],
+		"description": "Reference to a registered webhook. `target` is the repository, or a namespace ref (`kind: 'namespace'`, empty `name`) for an organisation or workspace hook.",
+		"x-forges-type": "WebhookRef"
+	}
+};
+//#endregion
+export { schemas };