@volter/twin-github 0.1.2 → 2.0.1

package/src/semantics/webhooks.ts

@@ -0,0 +1,101 @@
+// A repository's webhooks: create (pinged at once, as GitHub does), read, edit (the hook or its
+// config), delete, and the delivery doors (deliveries, a delivery, redelivery, ping), which the
+// delivery pipeline in ../github-events.ts serves. Two hooks may not deliver the same event to the
+// same URL, content type and secret.
+import type { Semantics, SemanticsContext } from '@volter/world-core';
+import { githubNotFound, hookConfigOverlaps, paginate, toGithubWebhook, toGithubWebhookConfig, validateGithubWebhook, type GithubResponse, type GithubWebhook } from '../github-twin.ts';
+import { handleGithubWebhookRequest, hookLastResponse, pingGithubHook } from '../github-events.ts';
+import { gh, nextSeq, put, send } from './shared.ts';
+
+const hookOf = (ctx: SemanticsContext) => {
+  const { repo, seg, state } = gh(ctx);
+  const id = Number(decodeURIComponent(seg[4]!));
+  return { id, hook: state().webhooks.find((h) => h.repository === repo && h.id === id) };
+};
+
+/** PATCH the hook (events, active, config; an omitted secret is removed) or only its config (a
+ *  secret is kept unless named), refused when the result would duplicate another hook. */
+const updateHook = (configOnly: boolean): Semantics => async (ctx) => {
+  const { id, hook } = hookOf(ctx);
+  if (!hook) return send(ctx, githubNotFound());
+  const { repo, body, occurredAt, state } = gh(ctx);
+  const error = validateGithubWebhook(body, configOnly, false);
+  if (error) return send(ctx, error);
+  const cfg = (configOnly ? body : (body.config ?? {})) as Record<string, any>;
+  const response = await ctx.atomically<GithubResponse>(() => {
+    const hooks = state().webhooks;
+    const current = hooks.find((h) => h.repository === repo && h.id === id);
+    if (!current) return { value: githubNotFound() };
+    const fields: Record<string, unknown> = { repository: repo, updated_at: occurredAt };
+    if (!configOnly) {
+      if (body.active !== undefined) fields.active = body.active;
+      if (body.events !== undefined || body.add_events !== undefined || body.remove_events !== undefined) {
+        const events: string[] = [...(body.events ?? current.events), ...(body.add_events ?? [])];
+        const removed = new Set<string>(body.remove_events ?? []);
+        fields.events = [...new Set(events)].filter((event) => !removed.has(event));
+      }
+      fields.secret = cfg.secret ?? '';
+    }
+    if (cfg.url !== undefined) fields.url = cfg.url;
+    if (cfg.content_type !== undefined) fields.content_type = cfg.content_type;
+    if (cfg.secret !== undefined) fields.secret = cfg.secret;
+    const next = { ...current, ...fields } as GithubWebhook;
+    if (hookConfigOverlaps(hooks, next, id)) return { value: { status: 422, body: { message: 'Hook already exists on this repository' } } };
+    return { value: { status: 200, body: configOnly ? toGithubWebhookConfig(next) : toGithubWebhook(next) }, write: { resource: 'webhook', id: `webhook:${id}`, fields, operation: 'webhook.update' } };
+  });
+  return send(ctx, response);
+};
+
+/** The delivery doors, answered by the delivery pipeline. */
+const deliveries: Semantics = async (ctx) => (await handleGithubWebhookRequest(ctx.call.request, { ...(ctx.root !== undefined ? { root: ctx.root } : {}) })) ?? send(ctx, githubNotFound());
+
+export function webhooksSemantics(): Record<string, Semantics> {
+  const reposListWebhooks: Semantics = async (ctx) => {
+    const { repo, query, state } = gh(ctx);
+    return ctx.reply(paginate(state().webhooks.filter((h) => h.repository === repo), query).map((h) => ({ ...toGithubWebhook(h), last_response: hookLastResponse(h.repository, h.id, ctx.root) })));
+  };
+  const reposGetWebhook: Semantics = async (ctx) => {
+    const { hook } = hookOf(ctx);
+    return send(ctx, hook ? { status: 200, body: { ...toGithubWebhook(hook), last_response: hookLastResponse(hook.repository, hook.id, ctx.root) } } : githubNotFound());
+  };
+  const reposGetWebhookConfigForRepo: Semantics = async (ctx) => {
+    const { hook } = hookOf(ctx);
+    return send(ctx, hook ? { status: 200, body: toGithubWebhookConfig(hook) } : githubNotFound());
+  };
+  const reposCreateWebhook: Semantics = async (ctx) => {
+    const { repo, body, occurredAt, root, state } = gh(ctx);
+    const error = validateGithubWebhook(body, false, true);
+    if (error) return send(ctx, error);
+    const cfg = (body.config ?? {}) as Record<string, any>;
+    const events = body.events ?? ['push'];
+    const fields = { repository: repo, active: body.active !== false, events, url: cfg.url, content_type: cfg.content_type ?? 'form', ...(cfg.secret !== undefined ? { secret: cfg.secret } : {}), created_at: occurredAt, updated_at: occurredAt };
+    const hook = await ctx.atomically<GithubWebhook | undefined>(() => {
+      if (hookConfigOverlaps(state().webhooks, fields)) return { value: undefined };
+      const id = nextSeq(ctx, 'webhook');
+      return { value: { id, name: 'web', ...fields }, write: { resource: 'webhook', id: `webhook:${id}`, fields, operation: 'webhook.create' } };
+    });
+    if (hook === undefined) return ctx.reply({ message: 'Hook already exists on this repository' }, 422);
+    // GitHub pings a hook it creates; a delivery failure does not undo the hook
+    try { await pingGithubHook(repo, hook.id, { occurredAt, ...(root !== undefined ? { root } : {}) }); } catch { /* fire-and-forget */ }
+    return ctx.reply(toGithubWebhook(hook), 201);
+  };
+  const reposDeleteWebhook: Semantics = async (ctx) => {
+    const { id, hook } = hookOf(ctx);
+    if (!hook) return send(ctx, githubNotFound());
+    await put(ctx, { operation: 'webhook.delete', subjectType: 'webhook', subjectId: `webhook:${id}`, fields: { deleted: true, repository: gh(ctx).repo } });
+    return send(ctx, { status: 204, body: undefined });
+  };
+  return {
+    'repos/list-webhooks': reposListWebhooks,
+    'repos/get-webhook': reposGetWebhook,
+    'repos/get-webhook-config-for-repo': reposGetWebhookConfigForRepo,
+    'repos/create-webhook': reposCreateWebhook,
+    'repos/update-webhook': updateHook(false),
+    'repos/update-webhook-config-for-repo': updateHook(true),
+    'repos/delete-webhook': reposDeleteWebhook,
+    'repos/list-webhook-deliveries': deliveries,
+    'repos/get-webhook-delivery': deliveries,
+    'repos/redeliver-webhook-delivery': deliveries,
+    'repos/ping-webhook': deliveries,
+  };
+}

package/test-fixtures/github-known-deviations.json

@@ -1,5 +1,5 @@
 {
-  "_doc": "Declared evidence-twin scope: GitHub fields the twin does NOT model, each with a reason. Applies to ALL GitHub objects the twin serves (pull_request, pull_request_review, review-comment, pull-file, pull-commit, label, assignee, issue, issue_comment, commit_status, check_run, milestone, requested_reviewer, issue cross-reference event) — the shared gaps (node_id, _links, author_association) are unmodeled identically across them. Object-specific gaps are namespaced (label.*, assignee.*, reviewComment.*, pullFile.*, pullCommit.*, status.*, checkRun.*, milestone.*, requestedReviewer.*, issueEvent.*). The spec-conformance gate (github-conformance.ts) treats a missing-required field as a BUG unless it is declared here, so 'what we don't serve' is explicit and reviewable, not silently absent. See github-twin.ts header: the `github` world is an EVIDENCE mirror (metadata), not a content mirror. A trailing `.*` covers a whole unmodeled sub-object. NOTE: issues, commit statuses, check runs, and milestones are LOCAL simulator/fork constructs (no observed evidence fold — observed PR evidence never carries CI/checks/milestones/review-requests) and have no vendored conformance schema yet, so those objects are not run through the spec gate; their simplifications below are recorded for honesty.",
+  "_doc": "Declared evidence-twin scope: GitHub fields the twin does NOT model, each with a reason. Applies to ALL GitHub objects the twin serves (pull_request, pull_request_review, review-comment, pull-file, pull-commit, label, assignee, issue, issue_comment, commit_status, check_run, milestone, requested_reviewer, issue cross-reference event) — PR node_id names the twin GraphQL node; other objects retain the declared node_id gaps. Object-specific gaps are namespaced (label.*, assignee.*, reviewComment.*, pullFile.*, pullCommit.*, status.*, checkRun.*, milestone.*, requestedReviewer.*, issueEvent.*). The spec-conformance gate (github-conformance.ts) treats a missing-required field as a BUG unless it is declared here, so 'what we don't serve' is explicit and reviewable, not silently absent. See github-twin.ts header: the `github` world is an EVIDENCE mirror (metadata), not a content mirror. A trailing `.*` covers a whole unmodeled sub-object. NOTE: issues, commit statuses, check runs, and milestones are LOCAL simulator/fork constructs (no observed evidence fold — observed PR evidence never carries CI/checks/milestones/review-requests) and have no vendored conformance schema yet, so those objects are not run through the spec gate; their simplifications below are recorded for honesty.",
   "deviations": [
     { "path": "issue.id", "kind": "missing-required", "reason": "issue object: no real GitHub integer id is observed on pull (the issue body carries number/title/body/state); a fabricated id would be invented" },
     { "path": "issue.node_id", "kind": "missing-required", "reason": "no real GraphQL node id for a local issue" },
@@ -7,12 +7,12 @@
     { "path": "issue.reactions", "kind": "missing-required", "reason": "reaction rollup not modeled by the local issue construct" },
     { "path": "issue.timeline_url", "kind": "missing-required", "reason": "timeline hypermedia not modeled" },
     { "path": "id", "kind": "missing-required", "reason": "PR object: evidence mirror has no real GitHub id (reviews/comments DO emit an integer id from the local sequence)" },
-    { "path": "node_id", "kind": "missing-required", "reason": "no real GraphQL node id observed (applies to PR, review, comment)" },
+    { "path": "node_id", "kind": "missing-required", "reason": "PRs emit the synthetic node ID accepted by the twin GraphQL API. Other objects do not yet model node IDs." },
     { "path": "created_at", "kind": "missing-required", "reason": "observed PR-evidence events do not carry PR creation timestamps" },
     { "path": "updated_at", "kind": "missing-required", "reason": "see created_at — no PR timestamps in evidence" },
     { "path": "title", "kind": "missing-required", "reason": "title IS folded on pull (content mirror) and on local writes; declared only for the edge case of a PR that surfaced solely via a review/comment reference (no PR-list entry), which has no title to emit" },
-    { "path": "user.*", "kind": "missing-required", "reason": "evidence does not identify the PR author; a synthetic simple-user would fabricate a login/id" },
-    { "path": "user", "kind": "missing-required", "reason": "PR author not modeled (see user.*)" },
+    { "path": "user.*", "kind": "missing-required", "reason": "PR author login/type are retained when known. Other simple-user subfields, including vendor numeric id and profile URLs, are not modeled." },
+    { "path": "user", "kind": "missing-required", "reason": "When PR author identity was never observed and no explicit local create proves the modeled caller, user is omitted rather than fabricated." },
     { "path": "_links.*", "kind": "missing-required", "reason": "hypermedia _links block not modeled by the evidence twin" },
     { "path": "_links", "kind": "missing-required", "reason": "see _links.*" },
     { "path": "author_association", "kind": "missing-required", "reason": "author relationship to repo not observed" },
@@ -21,16 +21,15 @@
     { "path": "maintainer_can_modify", "kind": "missing-required", "reason": "permission flag not observed" },
     { "path": "additions", "kind": "missing-required", "reason": "line-addition count is NOT in observed PR evidence (only file/commit counts are), so an observed PR omits it; a LOCAL write that carries a `files` list rolls additions up from the diff and emits a typed integer. Declared for the observed scope only." },
     { "path": "deletions", "kind": "missing-required", "reason": "line-deletion count is NOT in observed PR evidence; observed PRs omit it, while a LOCAL write with a `files` list rolls deletions up from the diff and emits a typed integer. Declared for the observed scope only." },
-    { "path": "comments", "kind": "missing-required", "reason": "issue-comment count surfaced under _twin.comment_count, not the GitHub-typed field" },
-    { "path": "review_comments", "kind": "missing-required", "reason": "review-comment count surfaced under _twin, not the GitHub-typed field" },
+    { "path": "comments", "kind": "missing-required", "reason": "the issue-comment count is not surfaced" },
+    { "path": "review_comments", "kind": "missing-required", "reason": "the review-comment count is not surfaced" },
     { "path": "commits", "kind": "missing-required", "reason": "emitted as a typed integer when observed; declared only for PRs whose evidence lacked a commit count" },
     { "path": "changed_files", "kind": "missing-required", "reason": "emitted as a typed integer when observed; declared only for PRs whose evidence lacked a changed-files count" },
     { "path": "base.label", "kind": "missing-required", "reason": "evidence tracks base ref only, not the owner:ref label" },
     { "path": "base.sha", "kind": "missing-required", "reason": "evidence tracks head sha only; base sha is not observed" },
     { "path": "base.user.*", "kind": "missing-required", "reason": "base repo owner not modeled (evidence twin)" },
     { "path": "base.user", "kind": "missing-required", "reason": "see base.user.*" },
-    { "path": "base.repo.*", "kind": "missing-required", "reason": "full base Repository object (30+ url templates, settings) not modeled by the evidence twin" },
-    { "path": "base.repo", "kind": "missing-required", "reason": "see base.repo.*" },
+    { "path": "base.repo.*", "kind": "missing-required", "reason": "full_name is served from the stored PR repository. Other Repository fields, including URL templates and settings, are not modeled here." },
     { "path": "head.label", "kind": "missing-required", "reason": "evidence tracks head sha only, not the owner:ref label" },
     { "path": "head.ref", "kind": "missing-required", "reason": "evidence tracks head sha; head branch ref is not observed" },
     { "path": "head.user.*", "kind": "missing-required", "reason": "head repo owner not modeled (evidence twin)" },

package/test-fixtures/github-openapi-operations.json

@@ -3,7 +3,7 @@
   "info": {
     "title": "GitHub REST API (spec-census pilot subset)",
     "version": "2026-06-14",
-    "description": "A curated, hand-vendored SUBSET of GitHub's published REST OpenAPI (github/rest-api-description, https://github.com/github/rest-api-description), used ONLY as the operation-inventory denominator for the TWIN-15 spec census (see ../github-spec-census.json). Domain covered: issues, pull requests, repos, git refs, and commit/review comments -- the surface the @volter/twin-github pack models -- PLUS a deliberate handful of adjacent real GitHub operations the pack does NOT model, so the census genuinely exercises its `unmapped` and `outOfScope` buckets instead of mapping 1:1. This is NOT a full GitHub OpenAPI document (GitHub's real spec is multi-megabyte); it is bounded to ~30-40 operations by design, offline and deterministic -- see github-openapi-operations.SOURCE.md for exactly how each path/method was curated."
+    "description": "A curated, hand-vendored SUBSET of GitHub's published REST OpenAPI (github/rest-api-description, https://github.com/github/rest-api-description), used ONLY as the operation-inventory denominator for the TWIN-15 spec census (see ../github-spec-census.json). Domain covered: issues, pull requests, repos, git refs, and commit/review comments -- the surface the @volter/twin-github pack models -- PLUS a deliberate handful of adjacent real GitHub operations the pack does NOT model, so the census genuinely exercises its `unmapped` and `$ruled` buckets instead of mapping 1:1. This is NOT a full GitHub OpenAPI document (GitHub's real spec is multi-megabyte); it is bounded to ~30-40 operations by design, offline and deterministic -- see github-openapi-operations.SOURCE.md for exactly how each path/method was curated. Method + path + operationId + summary ONLY: no schemas and NO STATUS CODES. It used to carry a response code or two per operation, which read as the operation's whole response set -- diff status codes against the freshly fetched spec, never against this file."
   },
   "x-source": {
     "vendor": "github",
@@ -11,33 +11,31 @@
     "upstreamFile": "descriptions/api.github.com/api.github.com.json",
     "vendored": "hand-authored from the operator's knowledge of GitHub's published REST API paths/methods -- NOT fetched over the network (offline/deterministic build requirement)",
     "curatedOn": "2026-07-04",
-    "scope": "issues, pulls, repos, git-data refs, commit/review comments -- the domain the github pack models -- plus adjacent real GitHub operations the pack intentionally leaves unmapped/out-of-scope"
+    "scope": "issues, pulls, repos, git-data refs, commit/review comments -- the domain the github pack models -- plus adjacent real GitHub operations the pack intentionally leaves unmapped/unmapped"
   },
   "paths": {
+    "/graphql": {
+      "post": {
+        "operationId": "graphql/api",
+        "summary": "Execute a GraphQL query or mutation",
+        "tags": ["graphql"],
+        "responses": { "200": { "description": "GraphQL response with data and/or errors" } }
+      }
+    },
     "/repos/{owner}/{repo}/issues": {
       "get": {
         "operationId": "issues/list-for-repo",
         "summary": "List repository issues",
         "tags": [
           "issues"
-        ],
-        "responses": {
-          "200": {
-            "description": "list of issues"
-          }
-        }
+        ]
       },
       "post": {
         "operationId": "issues/create",
         "summary": "Create an issue",
         "tags": [
           "issues"
-        ],
-        "responses": {
-          "201": {
-            "description": "issue created"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/issues/{issue_number}": {
@@ -46,12 +44,7 @@
         "summary": "Update an issue (title/body/state/labels/assignees/milestone)",
         "tags": [
           "issues"
-        ],
-        "responses": {
-          "200": {
-            "description": "issue updated"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/issues/{issue_number}/comments": {
@@ -60,24 +53,14 @@
         "summary": "List issue comments",
         "tags": [
           "issues"
-        ],
-        "responses": {
-          "200": {
-            "description": "list of comments"
-          }
-        }
+        ]
       },
       "post": {
         "operationId": "issues/create-comment",
         "summary": "Create an issue comment",
         "tags": [
           "issues"
-        ],
-        "responses": {
-          "201": {
-            "description": "comment created"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/issues/{issue_number}/labels": {
@@ -86,12 +69,7 @@
         "summary": "Add labels to an issue",
         "tags": [
           "issues"
-        ],
-        "responses": {
-          "200": {
-            "description": "labels added"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/issues/{issue_number}/lock": {
@@ -100,12 +78,7 @@
         "summary": "Lock an issue conversation",
         "tags": [
           "issues"
-        ],
-        "responses": {
-          "204": {
-            "description": "locked"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/issues/comments": {
@@ -114,12 +87,7 @@
         "summary": "List issue comments for a repository (repo-wide, across all issues)",
         "tags": [
           "issues"
-        ],
-        "responses": {
-          "200": {
-            "description": "list of comments"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/issues/events": {
@@ -128,12 +96,7 @@
         "summary": "List issue events for a repository (repo-wide, across all issues)",
         "tags": [
           "issues"
-        ],
-        "responses": {
-          "200": {
-            "description": "list of events"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/pulls": {
@@ -142,24 +105,14 @@
         "summary": "List pull requests",
         "tags": [
           "pulls"
-        ],
-        "responses": {
-          "200": {
-            "description": "list of pull requests"
-          }
-        }
+        ]
       },
       "post": {
         "operationId": "pulls/create",
         "summary": "Create a pull request",
         "tags": [
           "pulls"
-        ],
-        "responses": {
-          "201": {
-            "description": "pull request created"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/pulls/{pull_number}": {
@@ -168,24 +121,14 @@
         "summary": "Get a pull request",
         "tags": [
           "pulls"
-        ],
-        "responses": {
-          "200": {
-            "description": "pull request"
-          }
-        }
+        ]
       },
       "patch": {
         "operationId": "pulls/update",
         "summary": "Update a pull request",
         "tags": [
           "pulls"
-        ],
-        "responses": {
-          "200": {
-            "description": "pull request updated"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/pulls/{pull_number}/merge": {
@@ -194,12 +137,7 @@
         "summary": "Merge a pull request",
         "tags": [
           "pulls"
-        ],
-        "responses": {
-          "200": {
-            "description": "merged"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/pulls/{pull_number}/files": {
@@ -208,12 +146,7 @@
         "summary": "List pull request files",
         "tags": [
           "pulls"
-        ],
-        "responses": {
-          "200": {
-            "description": "list of changed files"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/pulls/{pull_number}/reviews": {
@@ -222,24 +155,14 @@
         "summary": "List reviews for a pull request",
         "tags": [
           "pulls"
-        ],
-        "responses": {
-          "200": {
-            "description": "list of reviews"
-          }
-        }
+        ]
       },
       "post": {
         "operationId": "pulls/create-review",
         "summary": "Create a review for a pull request",
         "tags": [
           "pulls"
-        ],
-        "responses": {
-          "200": {
-            "description": "review created"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/pulls/{pull_number}/comments": {
@@ -260,12 +183,7 @@
         "summary": "Create a diff-anchored review comment",
         "tags": [
           "pulls"
-        ],
-        "responses": {
-          "201": {
-            "description": "review comment created"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/pulls/{pull_number}/comments/{comment_id}/replies": {
@@ -288,12 +206,7 @@
         "summary": "Request reviewers for a pull request",
         "tags": [
           "pulls"
-        ],
-        "responses": {
-          "201": {
-            "description": "reviewers requested"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/pulls/comments": {
@@ -302,12 +215,7 @@
         "summary": "List review comments in a repository (repo-wide, across all pull requests)",
         "tags": [
           "pulls"
-        ],
-        "responses": {
-          "200": {
-            "description": "list of review comments"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}": {
@@ -316,12 +224,7 @@
         "summary": "Get a repository",
         "tags": [
           "repos"
-        ],
-        "responses": {
-          "200": {
-            "description": "repository"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/branches": {
@@ -330,12 +233,7 @@
         "summary": "List branches",
         "tags": [
           "repos"
-        ],
-        "responses": {
-          "200": {
-            "description": "list of branches"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/contents/{path}": {
@@ -344,36 +242,21 @@
         "summary": "Get repository content",
         "tags": [
           "repos"
-        ],
-        "responses": {
-          "200": {
-            "description": "file content"
-          }
-        }
+        ]
       },
       "put": {
         "operationId": "repos/create-or-update-file-contents",
         "summary": "Create or update file contents",
         "tags": [
           "repos"
-        ],
-        "responses": {
-          "200": {
-            "description": "file content"
-          }
-        }
+        ]
       },
       "delete": {
         "operationId": "repos/delete-file",
         "summary": "Delete a file",
         "tags": [
           "repos"
-        ],
-        "responses": {
-          "200": {
-            "description": "file content"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/community/profile": {
@@ -382,12 +265,7 @@
         "summary": "Get community profile metrics",
         "tags": [
           "repos"
-        ],
-        "responses": {
-          "200": {
-            "description": "community profile"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/merge-upstream": {
@@ -396,12 +274,7 @@
         "summary": "Sync a fork branch with the upstream repository",
         "tags": [
           "repos"
-        ],
-        "responses": {
-          "200": {
-            "description": "merge result"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/vulnerability-alerts": {
@@ -410,15 +283,7 @@
         "summary": "Check if Dependabot vulnerability alerts are enabled",
         "tags": [
           "repos"
-        ],
-        "responses": {
-          "204": {
-            "description": "enabled"
-          },
-          "404": {
-            "description": "disabled"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/git/refs": {
@@ -427,12 +292,7 @@
         "summary": "Create a reference",
         "tags": [
           "git"
-        ],
-        "responses": {
-          "201": {
-            "description": "ref created"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/git/ref/{ref}": {
@@ -441,12 +301,7 @@
         "summary": "Get a reference",
         "tags": [
           "git"
-        ],
-        "responses": {
-          "200": {
-            "description": "ref"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/git/matching-refs/{ref}": {
@@ -455,12 +310,7 @@
         "summary": "List matching references",
         "tags": [
           "git"
-        ],
-        "responses": {
-          "200": {
-            "description": "list of matching refs"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/commits/{commit_sha}/comments": {
@@ -469,12 +319,7 @@
         "summary": "List commit comments",
         "tags": [
           "repos"
-        ],
-        "responses": {
-          "200": {
-            "description": "list of commit comments"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/stats/contributors": {
@@ -483,15 +328,7 @@
         "summary": "Get all contributor commit activity (async-computed statistics)",
         "tags": [
           "repos"
-        ],
-        "responses": {
-          "200": {
-            "description": "contributor stats"
-          },
-          "202": {
-            "description": "stats being computed"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/stats/commit_activity": {
@@ -500,15 +337,7 @@
         "summary": "Get the last year of commit activity (async-computed statistics)",
         "tags": [
           "repos"
-        ],
-        "responses": {
-          "200": {
-            "description": "commit activity"
-          },
-          "202": {
-            "description": "stats being computed"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/transfer": {
@@ -517,12 +346,7 @@
         "summary": "Transfer a repository to another owner",
         "tags": [
           "repos"
-        ],
-        "responses": {
-          "202": {
-            "description": "transfer accepted"
-          }
-        }
+        ]
       }
     },
     "/repos/{owner}/{repo}/automated-security-fixes": {
@@ -531,12 +355,7 @@
         "summary": "Disable automated security fixes (Dependabot security updates toggle)",
         "tags": [
           "repos"
-        ],
-        "responses": {
-          "204": {
-            "description": "disabled"
-          }
-        }
+        ]
       }
     }
   }