naftiko: 1.0.0-alpha2 info: label: GitHub Repos API — References description: 'GitHub Repos API — References. 12 operations. Lead operation: Create An Autolink Reference For Repository. Self-contained Naftiko capability covering one Github business surface.' tags: - Github - References created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: GITHUB_API_KEY: GITHUB_API_KEY capability: consumes: - type: http namespace: temp-references baseUri: '' description: GitHub Repos API — References business capability. Self-contained, no shared references. resources: - name: repos-owner-repo-autolinks path: /repos/{owner}/{repo}/autolinks operations: - name: createanautolinkreferenceforrepository method: POST description: Create An Autolink Reference For Repository outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: body in: body type: object description: Request body (JSON). required: true - name: repos-owner-repo-autolinks-autolink_id path: /repos/{owner}/{repo}/autolinks/{autolink_id} operations: - name: getanautolinkreferenceofrepository method: GET description: Get An Autolink Reference Of Repository outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: deleteanautolinkreferencefromrepository method: DELETE description: Delete An Autolink Reference From Repository outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: repos-owner-repo-commits-ref-check-runs path: /repos/{owner}/{repo}/commits/{ref}/check-runs operations: - name: listcheckrunsforgitreference method: GET description: List Check Runs For Git Reference outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: filter in: query type: string description: Filters check runs by their `completed_at` timestamp. `latest` returns the most recent check runs. - name: app_id in: query type: integer - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: repos-owner-repo-commits-ref-check-suites path: /repos/{owner}/{repo}/commits/{ref}/check-suites operations: - name: listchecksuitesforgitreference method: GET description: List Check Suites For Git Reference outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: app_id in: query type: integer description: Filters check suites by GitHub App `id`. - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: repos-owner-repo-commits-ref-status path: /repos/{owner}/{repo}/commits/{ref}/status operations: - name: getthecombinedstatusforspecificreference method: GET description: Get The Combined Status For Specific Reference outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: repos-owner-repo-commits-ref-statuses path: /repos/{owner}/{repo}/commits/{ref}/statuses operations: - name: listcommitstatusesforreference method: GET description: List Commit Statuses For Reference outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: repos-owner-repo-git-matching-refs-ref path: /repos/{owner}/{repo}/git/matching-refs/{ref} operations: - name: listmatchingreferences method: GET description: List Matching References outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: repos-owner-repo-git-ref-ref path: /repos/{owner}/{repo}/git/ref/{ref} operations: - name: getreference method: GET description: Get Reference outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: repos-owner-repo-git-refs path: /repos/{owner}/{repo}/git/refs operations: - name: createreference method: POST description: Create Reference outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: body in: body type: object description: Request body (JSON). required: true - name: repos-owner-repo-git-refs-ref path: /repos/{owner}/{repo}/git/refs/{ref} operations: - name: updatereference method: PATCH description: Update Reference outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string - name: body in: body type: object description: Request body (JSON). required: true - name: deletereference method: DELETE description: Delete Reference outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Authorization in: header type: string - name: X-GitHub-Api-Version in: header type: string - name: Accept in: header type: string authentication: type: bearer token: '{{env.GITHUB_API_KEY}}' exposes: - type: rest namespace: temp-references-rest port: 8080 description: REST adapter for GitHub Repos API — References. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/repos/{owner}/{repo}/autolinks name: repos-owner-repo-autolinks description: REST surface for repos-owner-repo-autolinks. operations: - method: POST name: createanautolinkreferenceforrepository description: Create An Autolink Reference For Repository call: temp-references.createanautolinkreferenceforrepository with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept body: rest.body outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/autolinks/{autolink-id} name: repos-owner-repo-autolinks-autolink-id description: REST surface for repos-owner-repo-autolinks-autolink_id. operations: - method: GET name: getanautolinkreferenceofrepository description: Get An Autolink Reference Of Repository call: temp-references.getanautolinkreferenceofrepository with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - method: DELETE name: deleteanautolinkreferencefromrepository description: Delete An Autolink Reference From Repository call: temp-references.deleteanautolinkreferencefromrepository with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/commits/{ref}/check-runs name: repos-owner-repo-commits-ref-check-runs description: REST surface for repos-owner-repo-commits-ref-check-runs. operations: - method: GET name: listcheckrunsforgitreference description: List Check Runs For Git Reference call: temp-references.listcheckrunsforgitreference with: filter: rest.filter app_id: rest.app_id Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/commits/{ref}/check-suites name: repos-owner-repo-commits-ref-check-suites description: REST surface for repos-owner-repo-commits-ref-check-suites. operations: - method: GET name: listchecksuitesforgitreference description: List Check Suites For Git Reference call: temp-references.listchecksuitesforgitreference with: app_id: rest.app_id Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/commits/{ref}/status name: repos-owner-repo-commits-ref-status description: REST surface for repos-owner-repo-commits-ref-status. operations: - method: GET name: getthecombinedstatusforspecificreference description: Get The Combined Status For Specific Reference call: temp-references.getthecombinedstatusforspecificreference with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/commits/{ref}/statuses name: repos-owner-repo-commits-ref-statuses description: REST surface for repos-owner-repo-commits-ref-statuses. operations: - method: GET name: listcommitstatusesforreference description: List Commit Statuses For Reference call: temp-references.listcommitstatusesforreference with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/git/matching-refs/{ref} name: repos-owner-repo-git-matching-refs-ref description: REST surface for repos-owner-repo-git-matching-refs-ref. operations: - method: GET name: listmatchingreferences description: List Matching References call: temp-references.listmatchingreferences with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/git/ref/{ref} name: repos-owner-repo-git-ref-ref description: REST surface for repos-owner-repo-git-ref-ref. operations: - method: GET name: getreference description: Get Reference call: temp-references.getreference with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/git/refs name: repos-owner-repo-git-refs description: REST surface for repos-owner-repo-git-refs. operations: - method: POST name: createreference description: Create Reference call: temp-references.createreference with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept body: rest.body outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/git/refs/{ref} name: repos-owner-repo-git-refs-ref description: REST surface for repos-owner-repo-git-refs-ref. operations: - method: PATCH name: updatereference description: Update Reference call: temp-references.updatereference with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: deletereference description: Delete Reference call: temp-references.deletereference with: Authorization: rest.Authorization X-GitHub-Api-Version: rest.X-GitHub-Api-Version Accept: rest.Accept outputParameters: - type: object mapping: $. - type: mcp namespace: temp-references-mcp port: 9090 transport: http description: MCP adapter for GitHub Repos API — References. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: create-autolink-reference-repository description: Create An Autolink Reference For Repository hints: readOnly: false destructive: false idempotent: false call: temp-references.createanautolinkreferenceforrepository with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept body: tools.body outputParameters: - type: object mapping: $. - name: get-autolink-reference-repository description: Get An Autolink Reference Of Repository hints: readOnly: true destructive: false idempotent: true call: temp-references.getanautolinkreferenceofrepository with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: delete-autolink-reference-repository description: Delete An Autolink Reference From Repository hints: readOnly: false destructive: true idempotent: true call: temp-references.deleteanautolinkreferencefromrepository with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: list-check-runs-git-reference description: List Check Runs For Git Reference hints: readOnly: true destructive: false idempotent: true call: temp-references.listcheckrunsforgitreference with: filter: tools.filter app_id: tools.app_id Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: list-check-suites-git-reference description: List Check Suites For Git Reference hints: readOnly: true destructive: false idempotent: true call: temp-references.listchecksuitesforgitreference with: app_id: tools.app_id Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: get-combined-status-specific-reference description: Get The Combined Status For Specific Reference hints: readOnly: true destructive: false idempotent: true call: temp-references.getthecombinedstatusforspecificreference with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: list-commit-statuses-reference description: List Commit Statuses For Reference hints: readOnly: true destructive: false idempotent: true call: temp-references.listcommitstatusesforreference with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: list-matching-references description: List Matching References hints: readOnly: true destructive: false idempotent: true call: temp-references.listmatchingreferences with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: get-reference description: Get Reference hints: readOnly: true destructive: false idempotent: true call: temp-references.getreference with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $. - name: create-reference description: Create Reference hints: readOnly: false destructive: false idempotent: false call: temp-references.createreference with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept body: tools.body outputParameters: - type: object mapping: $. - name: update-reference description: Update Reference hints: readOnly: false destructive: false idempotent: true call: temp-references.updatereference with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept body: tools.body outputParameters: - type: object mapping: $. - name: delete-reference description: Delete Reference hints: readOnly: false destructive: true idempotent: true call: temp-references.deletereference with: Authorization: tools.Authorization X-GitHub-Api-Version: tools.X-GitHub-Api-Version Accept: tools.Accept outputParameters: - type: object mapping: $.