@rathnasgala2/schemas 2.11.0 → 2.13.0

package/openapi/source/github.yaml

@@ -1,351 +0,0 @@
-paths:
-  /v2/github/app:
-    get:
-      operationId: getGithubApp
-      parameters:
-        - $ref: '#/components/parameters/XCorrelationId'
-      responses:
-        '200':
-          content:
-            application/json:
-              examples:
-                nominal:
-                  summary: Nominal successful response
-                  value:
-                    installUrl: https://github.com/apps/galascribe/installations/new
-                    slug: galascribe
-              schema:
-                $ref: '#/components/schemas/GetGithubAppResponse'
-          description: public identity of the Galascribe GitHub App succeeded
-          headers:
-            Cache-Control:
-              $ref: '#/components/headers/CacheControlNoStore'
-            X-Correlation-Id:
-              $ref: '#/components/headers/XCorrelationId'
-        '401':
-          content:
-            application/problem+json:
-              examples:
-                AUTHENTICATION_REQUIRED:
-                  summary: AUTHENTICATION_REQUIRED
-                  value:
-                    code: AUTHENTICATION_REQUIRED
-                    correlationId: 018f0000-0000-7000-8000-000000000001
-                    detail: See the operation contract.
-                    errors: []
-                    retryable: false
-                    schemaId: urn:gala:schema:problem:2.0.0
-                    schemaVersion: 2.0.0
-                    status: 401
-                    title: AUTHENTICATION_REQUIRED
-                    type: urn:gala:problem:authentication-required
-              schema:
-                $ref: '#/components/schemas/Problem'
-          description: AUTHENTICATION_REQUIRED
-          headers:
-            Cache-Control:
-              $ref: '#/components/headers/CacheControlNoStore'
-            X-Correlation-Id:
-              $ref: '#/components/headers/XCorrelationId'
-          x-gala-problem-codes:
-            - AUTHENTICATION_REQUIRED
-        '503':
-          content:
-            application/problem+json:
-              examples:
-                CAPABILITY_UNAVAILABLE:
-                  summary: CAPABILITY_UNAVAILABLE
-                  value:
-                    code: CAPABILITY_UNAVAILABLE
-                    correlationId: 018f0000-0000-7000-8000-000000000001
-                    detail: See the operation contract.
-                    errors: []
-                    retryable: false
-                    schemaId: urn:gala:schema:problem:2.0.0
-                    schemaVersion: 2.0.0
-                    status: 503
-                    title: CAPABILITY_UNAVAILABLE
-                    type: urn:gala:problem:capability-unavailable
-              schema:
-                $ref: '#/components/schemas/Problem'
-          description: CAPABILITY_UNAVAILABLE
-          headers:
-            Cache-Control:
-              $ref: '#/components/headers/CacheControlNoStore'
-            X-Correlation-Id:
-              $ref: '#/components/headers/XCorrelationId'
-          x-gala-problem-codes:
-            - CAPABILITY_UNAVAILABLE
-      description: |
-        The App's Connections screen and the unbound Source state need somewhere
-        to send an owner who has not installed the GitHub App yet. The slug and
-        installation URL are deployment configuration, not a person's data, so
-        this is a safe, replayable read; the client links to `installUrl`
-        verbatim rather than assembling a GitHub URL of its own (LOCAL-36 G-05).
-        A deployment that has not been told which GitHub App it fronts answers
-        `503 CAPABILITY_UNAVAILABLE` rather than inventing a slug, so a client
-        must treat the install link as an optionally available affordance.
-      security:
-        - browserSession: []
-      summary: public identity of the Galascribe GitHub App
-      tags:
-        - github
-      x-gala-activation-gate: MVP
-      x-gala-activation-guards:
-        - Configured GitHub App identity for this deployment
-      x-gala-capability-key: null
-      x-gala-concurrency: github-app-identity
-      x-gala-conditional-capabilities: []
-      x-gala-example-profile: NOMINAL_SUCCESS_AND_EACH_REACHABLE_PROBLEM
-      x-gala-nullability: required-and-nullable-are-explicit
-      x-gala-purpose: public identity of the Galascribe GitHub App
-      x-gala-reachable-problems:
-        - AUTHENTICATION_REQUIRED
-        - CAPABILITY_UNAVAILABLE
-      x-gala-replay-identity: safe-query
-      x-gala-state-guards:
-        - NONE
-      x-gala-success-category: query
-      x-gala-tenant-scope: NONE
-  /v2/github/installations:
-    get:
-      operationId: getGithubInstallations
-      parameters:
-        - $ref: '#/components/parameters/XCorrelationId'
-        - $ref: '#/components/parameters/Cursor'
-        - $ref: '#/components/parameters/Limit'
-      responses:
-        '200':
-          content:
-            application/json:
-              examples:
-                nominal:
-                  summary: Nominal successful response
-                  value:
-                    hasMore: false
-                    items: []
-              schema:
-                $ref: '#/components/schemas/GetGithubInstallationsResponse'
-          description:
-            installations visible through user and GitHub App intersection
-            succeeded
-          headers:
-            Cache-Control:
-              $ref: '#/components/headers/CacheControlNoStore'
-            X-Correlation-Id:
-              $ref: '#/components/headers/XCorrelationId'
-        '400':
-          $ref: '#/components/responses/ValidationFailed'
-        '401':
-          content:
-            application/problem+json:
-              examples:
-                AUTHENTICATION_REQUIRED:
-                  summary: AUTHENTICATION_REQUIRED
-                  value:
-                    code: AUTHENTICATION_REQUIRED
-                    correlationId: 018f0000-0000-7000-8000-000000000001
-                    detail: See the operation contract.
-                    errors: []
-                    retryable: false
-                    schemaId: urn:gala:schema:problem:2.0.0
-                    schemaVersion: 2.0.0
-                    status: 401
-                    title: AUTHENTICATION_REQUIRED
-                    type: urn:gala:problem:authentication-required
-                REAUTH_REQUIRED:
-                  summary: REAUTH_REQUIRED
-                  value:
-                    code: REAUTH_REQUIRED
-                    correlationId: 018f0000-0000-7000-8000-000000000001
-                    detail: See the operation contract.
-                    errors: []
-                    retryable: false
-                    schemaId: urn:gala:schema:problem:2.0.0
-                    schemaVersion: 2.0.0
-                    status: 401
-                    title: REAUTH_REQUIRED
-                    type: urn:gala:problem:reauth-required
-              schema:
-                $ref: '#/components/schemas/Problem'
-          description: AUTHENTICATION_REQUIRED, REAUTH_REQUIRED
-          headers:
-            Cache-Control:
-              $ref: '#/components/headers/CacheControlNoStore'
-            X-Correlation-Id:
-              $ref: '#/components/headers/XCorrelationId'
-          x-gala-problem-codes:
-            - AUTHENTICATION_REQUIRED
-            - REAUTH_REQUIRED
-      description: |
-        Listing installations is a safe, replayable query that also records a
-        first observation of each reported installation as a global provider fact
-        (App-JWT re-verified, never trusting the user token or any callback), so
-        that a subsequent repository binding can reference it; provider
-        unavailability during that observation never fails the listing (LOCAL-24).
-        A session whose stored GitHub user access token no longer satisfies this
-        read is answered `401 REAUTH_REQUIRED`, not `AUTHENTICATION_REQUIRED`:
-        the Gala session is intact and only the provider grant must be renewed.
-      security:
-        - browserSession: []
-      summary: installations visible through user and GitHub App intersection
-      tags:
-        - github
-      x-gala-activation-gate: MVP
-      x-gala-activation-guards:
-        - NONE
-      x-gala-capability-key: null
-      x-gala-concurrency: installation-epoch
-      x-gala-conditional-capabilities: []
-      x-gala-example-profile: NOMINAL_SUCCESS_AND_EACH_REACHABLE_PROBLEM
-      x-gala-nullability: required-and-nullable-are-explicit
-      x-gala-purpose:
-        installations visible through user and GitHub App intersection
-      x-gala-reachable-problems:
-        - AUTHENTICATION_REQUIRED
-        - REAUTH_REQUIRED
-        - VALIDATION_FAILED
-      x-gala-replay-identity: safe-query
-      x-gala-state-guards:
-        - NONE
-      x-gala-success-category: query
-      x-gala-tenant-scope: NONE
-  /v2/github/installations/{installationId}/repositories:
-    get:
-      operationId: getGithubInstallationsByInstallationIdRepositories
-      parameters:
-        - $ref: '#/components/parameters/XCorrelationId'
-        - example: '1'
-          in: path
-          name: installationId
-          required: true
-          schema:
-            pattern: ^[1-9][0-9]{0,19}$
-            type: string
-        - $ref: '#/components/parameters/Cursor'
-        - $ref: '#/components/parameters/Limit'
-      responses:
-        '200':
-          content:
-            application/json:
-              examples:
-                nominal:
-                  summary: Nominal successful response
-                  value:
-                    hasMore: false
-                    items: []
-              schema:
-                $ref: '#/components/schemas/GetGithubInstallationsByInstallationIdRepositoriesResponse'
-          description:
-            repositories this installation grants to the signed-in user
-            succeeded
-          headers:
-            Cache-Control:
-              $ref: '#/components/headers/CacheControlNoStore'
-            X-Correlation-Id:
-              $ref: '#/components/headers/XCorrelationId'
-        '400':
-          $ref: '#/components/responses/ValidationFailed'
-        '401':
-          content:
-            application/problem+json:
-              examples:
-                AUTHENTICATION_REQUIRED:
-                  summary: AUTHENTICATION_REQUIRED
-                  value:
-                    code: AUTHENTICATION_REQUIRED
-                    correlationId: 018f0000-0000-7000-8000-000000000001
-                    detail: See the operation contract.
-                    errors: []
-                    retryable: false
-                    schemaId: urn:gala:schema:problem:2.0.0
-                    schemaVersion: 2.0.0
-                    status: 401
-                    title: AUTHENTICATION_REQUIRED
-                    type: urn:gala:problem:authentication-required
-                REAUTH_REQUIRED:
-                  summary: REAUTH_REQUIRED
-                  value:
-                    code: REAUTH_REQUIRED
-                    correlationId: 018f0000-0000-7000-8000-000000000001
-                    detail: See the operation contract.
-                    errors: []
-                    retryable: false
-                    schemaId: urn:gala:schema:problem:2.0.0
-                    schemaVersion: 2.0.0
-                    status: 401
-                    title: REAUTH_REQUIRED
-                    type: urn:gala:problem:reauth-required
-              schema:
-                $ref: '#/components/schemas/Problem'
-          description: AUTHENTICATION_REQUIRED, REAUTH_REQUIRED
-          headers:
-            Cache-Control:
-              $ref: '#/components/headers/CacheControlNoStore'
-            X-Correlation-Id:
-              $ref: '#/components/headers/XCorrelationId'
-          x-gala-problem-codes:
-            - AUTHENTICATION_REQUIRED
-            - REAUTH_REQUIRED
-        '404':
-          content:
-            application/problem+json:
-              examples:
-                RESOURCE_NOT_FOUND:
-                  summary: RESOURCE_NOT_FOUND
-                  value:
-                    code: RESOURCE_NOT_FOUND
-                    correlationId: 018f0000-0000-7000-8000-000000000001
-                    detail: See the operation contract.
-                    errors: []
-                    retryable: false
-                    schemaId: urn:gala:schema:problem:2.0.0
-                    schemaVersion: 2.0.0
-                    status: 404
-                    title: RESOURCE_NOT_FOUND
-                    type: urn:gala:problem:resource-not-found
-              schema:
-                $ref: '#/components/schemas/Problem'
-          description: RESOURCE_NOT_FOUND
-          headers:
-            Cache-Control:
-              $ref: '#/components/headers/CacheControlNoStore'
-            X-Correlation-Id:
-              $ref: '#/components/headers/XCorrelationId'
-          x-gala-problem-codes:
-            - RESOURCE_NOT_FOUND
-      description: |
-        The intersection of what the signed-in user can see and what this
-        installation grants, so that a client can offer a repository picker and
-        derive the owner id, repository id and default branch from the chosen
-        row. Nobody is ever asked to type a numeric GitHub identifier
-        (LOCAL-33). An installation the caller cannot see is reported as
-        RESOURCE_NOT_FOUND, exactly as an unknown one is, so the read never
-        discloses the existence of installations belonging to other people. As
-        with the installations list, a stale or revoked GitHub user access token
-        is answered `401 REAUTH_REQUIRED` while the Gala session stays valid.
-      security:
-        - browserSession: []
-      summary: repositories this installation grants to the signed-in user
-      tags:
-        - github
-      x-gala-activation-gate: MVP
-      x-gala-activation-guards:
-        - NONE
-      x-gala-capability-key: null
-      x-gala-concurrency: installation-epoch
-      x-gala-conditional-capabilities: []
-      x-gala-example-profile: NOMINAL_SUCCESS_AND_EACH_REACHABLE_PROBLEM
-      x-gala-nullability: required-and-nullable-are-explicit
-      x-gala-purpose:
-        repositories this installation grants to the signed-in user
-      x-gala-reachable-problems:
-        - AUTHENTICATION_REQUIRED
-        - REAUTH_REQUIRED
-        - RESOURCE_NOT_FOUND
-        - VALIDATION_FAILED
-      x-gala-replay-identity: safe-query
-      x-gala-state-guards:
-        - NONE
-      x-gala-success-category: query
-      x-gala-tenant-scope: NONE

package/openapi/source/internal.yaml

@@ -1,71 +0,0 @@
-paths:
-  /internal/health:
-    get:
-      operationId: getInternalHealth
-      parameters:
-        - $ref: '#/components/parameters/XCorrelationId'
-      responses:
-        '200':
-          content:
-            application/json:
-              examples:
-                nominal:
-                  summary: Nominal successful response
-                  value:
-                    status: UP
-              schema:
-                $ref: '#/components/schemas/GetInternalHealthResponse'
-          description: authenticated process health probe succeeded
-          headers:
-            Cache-Control:
-              $ref: '#/components/headers/CacheControlNoStore'
-            X-Correlation-Id:
-              $ref: '#/components/headers/XCorrelationId'
-        '401':
-          content:
-            application/problem+json:
-              examples:
-                AUTHENTICATION_REQUIRED:
-                  summary: AUTHENTICATION_REQUIRED
-                  value:
-                    code: AUTHENTICATION_REQUIRED
-                    correlationId: 018f0000-0000-7000-8000-000000000001
-                    detail: See the operation contract.
-                    errors: []
-                    retryable: false
-                    schemaId: urn:gala:schema:problem:2.0.0
-                    schemaVersion: 2.0.0
-                    status: 401
-                    title: AUTHENTICATION_REQUIRED
-                    type: urn:gala:problem:authentication-required
-              schema:
-                $ref: '#/components/schemas/Problem'
-          description: AUTHENTICATION_REQUIRED
-          headers:
-            Cache-Control:
-              $ref: '#/components/headers/CacheControlNoStore'
-            X-Correlation-Id:
-              $ref: '#/components/headers/XCorrelationId'
-          x-gala-problem-codes:
-            - AUTHENTICATION_REQUIRED
-      security:
-        - internalHealth: []
-      summary: authenticated process health probe
-      tags:
-        - internal
-      x-gala-activation-gate: MVP
-      x-gala-activation-guards:
-        - NONE
-      x-gala-capability-key: null
-      x-gala-concurrency: process-observation
-      x-gala-conditional-capabilities: []
-      x-gala-example-profile: NOMINAL_SUCCESS_AND_EACH_REACHABLE_PROBLEM
-      x-gala-nullability: required-and-nullable-are-explicit
-      x-gala-purpose: authenticated process health probe
-      x-gala-reachable-problems:
-        - AUTHENTICATION_REQUIRED
-      x-gala-replay-identity: safe-query
-      x-gala-state-guards:
-        - NONE
-      x-gala-success-category: query
-      x-gala-tenant-scope: INTERNAL

package/openapi/source/membership-invitations.yaml

@@ -1,203 +0,0 @@
-paths:
-  /v2/membership-invitations/{token}:accept:
-    post:
-      operationId: postMembershipInvitationsByTokenAccept
-      parameters:
-        - $ref: '#/components/parameters/XCorrelationId'
-        - example: examplexxxxxxxxxxxxxxxxxxxxxxxxx
-          in: path
-          name: token
-          required: true
-          schema:
-            maxLength: 256
-            minLength: 32
-            type: string
-        - $ref: '#/components/parameters/XCsrfToken'
-      requestBody:
-        content:
-          application/json:
-            examples:
-              nominal:
-                summary: Nominal valid request
-                value: {}
-            schema:
-              $ref: '#/components/schemas/PostMembershipInvitationsByTokenAcceptRequest'
-        required: true
-      responses:
-        '200':
-          content:
-            application/json:
-              examples:
-                nominal:
-                  summary: Nominal successful response
-                  value:
-                    membershipId: 018f0000-0000-7000-8000-000000000001
-                    principalId: 018f0000-0000-7000-8000-000000000001
-                    roleId: 018f0000-0000-7000-8000-000000000001
-                    state: ACTIVE
-                    version: 0
-              schema:
-                $ref: '#/components/schemas/PostMembershipInvitationsByTokenAcceptResponse'
-          description:
-            single-use non-enumerating invitation acceptance succeeded
-          headers:
-            Cache-Control:
-              $ref: '#/components/headers/CacheControlNoStore'
-            X-Correlation-Id:
-              $ref: '#/components/headers/XCorrelationId'
-        '400':
-          content:
-            application/problem+json:
-              examples:
-                REQUEST_FIELD_UNKNOWN:
-                  summary: REQUEST_FIELD_UNKNOWN
-                  value:
-                    code: REQUEST_FIELD_UNKNOWN
-                    correlationId: 018f0000-0000-7000-8000-000000000001
-                    detail: See the operation contract.
-                    errors: []
-                    retryable: false
-                    schemaId: urn:gala:schema:problem:2.0.0
-                    schemaVersion: 2.0.0
-                    status: 400
-                    title: REQUEST_FIELD_UNKNOWN
-                    type: urn:gala:problem:request-field-unknown
-                VALIDATION_FAILED:
-                  summary: VALIDATION_FAILED
-                  value:
-                    code: VALIDATION_FAILED
-                    correlationId: 018f0000-0000-7000-8000-000000000001
-                    detail: See the operation contract.
-                    errors: []
-                    retryable: false
-                    schemaId: urn:gala:schema:problem:2.0.0
-                    schemaVersion: 2.0.0
-                    status: 400
-                    title: VALIDATION_FAILED
-                    type: urn:gala:problem:validation-failed
-              schema:
-                $ref: '#/components/schemas/Problem'
-          description: REQUEST_FIELD_UNKNOWN, VALIDATION_FAILED
-          headers:
-            Cache-Control:
-              $ref: '#/components/headers/CacheControlNoStore'
-            X-Correlation-Id:
-              $ref: '#/components/headers/XCorrelationId'
-          x-gala-problem-codes:
-            - REQUEST_FIELD_UNKNOWN
-            - VALIDATION_FAILED
-        '401':
-          content:
-            application/problem+json:
-              examples:
-                AUTHENTICATION_REQUIRED:
-                  summary: AUTHENTICATION_REQUIRED
-                  value:
-                    code: AUTHENTICATION_REQUIRED
-                    correlationId: 018f0000-0000-7000-8000-000000000001
-                    detail: See the operation contract.
-                    errors: []
-                    retryable: false
-                    schemaId: urn:gala:schema:problem:2.0.0
-                    schemaVersion: 2.0.0
-                    status: 401
-                    title: AUTHENTICATION_REQUIRED
-                    type: urn:gala:problem:authentication-required
-              schema:
-                $ref: '#/components/schemas/Problem'
-          description: AUTHENTICATION_REQUIRED
-          headers:
-            Cache-Control:
-              $ref: '#/components/headers/CacheControlNoStore'
-            X-Correlation-Id:
-              $ref: '#/components/headers/XCorrelationId'
-          x-gala-problem-codes:
-            - AUTHENTICATION_REQUIRED
-        '409':
-          content:
-            application/problem+json:
-              examples:
-                INVALID_SOURCE_STATE:
-                  summary: INVALID_SOURCE_STATE
-                  value:
-                    code: INVALID_SOURCE_STATE
-                    correlationId: 018f0000-0000-7000-8000-000000000001
-                    detail: See the operation contract.
-                    errors: []
-                    retryable: false
-                    schemaId: urn:gala:schema:problem:2.0.0
-                    schemaVersion: 2.0.0
-                    status: 409
-                    title: INVALID_SOURCE_STATE
-                    type: urn:gala:problem:invalid-source-state
-              schema:
-                $ref: '#/components/schemas/Problem'
-          description: INVALID_SOURCE_STATE
-          headers:
-            Cache-Control:
-              $ref: '#/components/headers/CacheControlNoStore'
-            X-Correlation-Id:
-              $ref: '#/components/headers/XCorrelationId'
-          x-gala-problem-codes:
-            - INVALID_SOURCE_STATE
-        '422':
-          content:
-            application/problem+json:
-              examples:
-                VALIDATION_FAILED:
-                  summary: VALIDATION_FAILED
-                  value:
-                    code: VALIDATION_FAILED
-                    correlationId: 018f0000-0000-7000-8000-000000000001
-                    detail: See the operation contract.
-                    errors: []
-                    retryable: false
-                    schemaId: urn:gala:schema:problem:2.0.0
-                    schemaVersion: 2.0.0
-                    status: 422
-                    title: VALIDATION_FAILED
-                    type: urn:gala:problem:validation-failed
-              schema:
-                $ref: '#/components/schemas/Problem'
-          description: VALIDATION_FAILED
-          headers:
-            Cache-Control:
-              $ref: '#/components/headers/CacheControlNoStore'
-            X-Correlation-Id:
-              $ref: '#/components/headers/XCorrelationId'
-          x-gala-problem-codes:
-            - VALIDATION_FAILED
-      description: |
-        Acceptance is possession-based. The token is the whole credential: the
-        principal who presents it joins the organization with the invited role,
-        whoever they are. The `recipient` recorded on the invitation is a label
-        for the inviter's benefit and is never compared with the accepting
-        principal's verified identity (LOCAL-34 G6). The token is single-use and
-        non-enumerating; recipient binding is revisited when verified email
-        exists.
-      security:
-        - {}
-        - browserSession: []
-      summary: single-use non-enumerating invitation acceptance
-      tags:
-        - membership-invitations
-      x-gala-activation-gate: MVP
-      x-gala-activation-guards:
-        - NONE
-      x-gala-capability-key: null
-      x-gala-concurrency: single-use-capability
-      x-gala-conditional-capabilities: []
-      x-gala-example-profile: NOMINAL_SUCCESS_AND_EACH_REACHABLE_PROBLEM
-      x-gala-nullability: required-and-nullable-are-explicit
-      x-gala-purpose: single-use non-enumerating invitation acceptance
-      x-gala-reachable-problems:
-        - AUTHENTICATION_REQUIRED
-        - INVALID_SOURCE_STATE
-        - REQUEST_FIELD_UNKNOWN
-        - VALIDATION_FAILED
-      x-gala-replay-identity: invitation-capability
-      x-gala-state-guards:
-        - MembershipInvitation:PENDING -> ACCEPTED
-        - Organization:ACTIVE
-      x-gala-success-category: protocol
-      x-gala-tenant-scope: TOKEN_BOUND_ORGANIZATION