@rathnasgala2/schemas 2.12.0 → 2.13.0

package/README.md

@@ -59,36 +59,36 @@ removed it as unconsumed -- see "Package layout"). The schema inventory adds the
 separately owned OpenAPI contract as the twenty-first identity and carries
 DEC-091's domain-separated `sourceDesignRevision`. S0-T07 materializes the
 reviewed OpenAPI 3.1 source fragments, deterministic bundle, and digest-bound
-HTTP catalog for exactly 75 MVP operations plus `/internal/health` (76 catalog
-rows; 71 at S0-T07, plus the two SCHEMA-2.8.0 reads and the two SCHEMA-2.10.0
-publication-destination reads/writes). The bundle includes the accepted DEC-097
-receipt-exchange and deployment-receipt amendments and serializes the fixed
-OpenAPI Generator 7.25.0 option sets. Every operation also declares its tenant
-scope, lifecycle and activation guards, maps every reachable problem, and
-carries schema-validated nominal and problem examples. S0-T08 projects the exact
-19 admitted transition families into 77 independently identified event actions
-(SCHEMA-2.11.0 adds the `github_installation` family so the worker-only
-compare-and-set writer can retire into the sole aggregate gateway). Each action
-binds its aggregate and organization or publication scope, exact
-predecessor/target states, the closed DEC-101 payload, the transactional outbox
-producer, and a non-empty registered consumer set. S5-T00 materializes document
-07's closed 15-component App semantic catalog and document 14's 20-entry MVP App
-route registry (S5 brief section 4) as `docs/catalogs/app-components.json` and
-`docs/catalogs/app-routes.json`, with every `apiOperationIds` entry validated
-against `openapi/openapi.yaml`, every `componentIds`/`contentKeyIds` entry
-validated against the component catalog, and `capabilityKeys` projected from
-`openapi/http-catalog.json`. S4-T01 adds the separately generated `fixtures/s4/`
-deployment/certification consumer-fixture family (deployment-intent,
-deployment-observation, deployment-receipt, public-generation-marker, and
-adapter-capability rows for `local-directory`, `github-pages`, and `do-spaces`)
-alongside the existing `fixtures/s2/` family, each with its own manifest.
-LOCAL-21 admits a 21st App route, `/invitations/accept` (`routeId`
-`invitations.accept`), an ordinary `SESSION_REQUIRED` `APP` route (not
-`TRANSACTIONAL_LINK`: it is served by the App origin after sign-in, unlike the
-deferred `/t/**` template family) that calls
-`postMembershipInvitationsByTokenAccept`; its non-enumerating failure states
-collapse onto that operation's single declared `INVALID_SOURCE_STATE` problem,
-which covers an expired, already-used or unknown token alike.
+HTTP catalog for exactly 76 MVP operations plus `/internal/health` (77 catalog
+rows; 71 at S0-T07, plus the two SCHEMA-2.8.0 reads, the two SCHEMA-2.10.0
+publication-destination reads/writes, and the SCHEMA-2.13.0 repository create).
+The bundle includes the accepted DEC-097 receipt-exchange and deployment-receipt
+amendments and serializes the fixed OpenAPI Generator 7.25.0 option sets. Every
+operation also declares its tenant scope, lifecycle and activation guards, maps
+every reachable problem, and carries schema-validated nominal and problem
+examples. S0-T08 projects the exact 19 admitted transition families into 77
+independently identified event actions (SCHEMA-2.11.0 adds the
+`github_installation` family so the worker-only compare-and-set writer can
+retire into the sole aggregate gateway). Each action binds its aggregate and
+organization or publication scope, exact predecessor/target states, the closed
+DEC-101 payload, the transactional outbox producer, and a non-empty registered
+consumer set. S5-T00 materializes document 07's closed 15-component App semantic
+catalog and document 14's 20-entry MVP App route registry (S5 brief section 4)
+as `docs/catalogs/app-components.json` and `docs/catalogs/app-routes.json`, with
+every `apiOperationIds` entry validated against `openapi/openapi.yaml`, every
+`componentIds`/`contentKeyIds` entry validated against the component catalog,
+and `capabilityKeys` projected from `openapi/http-catalog.json`. S4-T01 adds the
+separately generated `fixtures/s4/` deployment/certification consumer-fixture
+family (deployment-intent, deployment-observation, deployment-receipt,
+public-generation-marker, and adapter-capability rows for `local-directory`,
+`github-pages`, and `do-spaces`) alongside the existing `fixtures/s2/` family,
+each with its own manifest. LOCAL-21 admits a 21st App route,
+`/invitations/accept` (`routeId` `invitations.accept`), an ordinary
+`SESSION_REQUIRED` `APP` route (not `TRANSACTIONAL_LINK`: it is served by the
+App origin after sign-in, unlike the deferred `/t/**` template family) that
+calls `postMembershipInvitationsByTokenAccept`; its non-enumerating failure
+states collapse onto that operation's single declared `INVALID_SOURCE_STATE`
+problem, which covers an expired, already-used or unknown token alike.
 
 SCHEMA-2.7.1 (LOCAL-50) adds the optional operation-level vendor extension
 `x-gala-conditional-capability-keys`: an array of `{capabilityKey, condition}`
@@ -535,7 +535,7 @@ remediation, and documentation URL fields without including authored values.
   fragments grouped by the first literal resource token. A build input, not part
   of the npm payload (SCH-H7: `!openapi/source/` in `package.json`'s `files`) --
   a consumer reads the materialized `openapi/openapi.yaml` instead.
-- `openapi/openapi.yaml` — deterministic OpenAPI 3.1 bundle for the exact 75 MVP
+- `openapi/openapi.yaml` — deterministic OpenAPI 3.1 bundle for the exact 76 MVP
   operations plus health.
 - `openapi/http-catalog.json` — generated digest-bound method/path/purpose and
   capability inventory, including `conditionalCapabilityKeys` (SCHEMA-2.7.1) and

package/THIRD_PARTY_LICENSES.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "package": "@rathnasgala2/schemas@2.12.0",
+  "package": "@rathnasgala2/schemas@2.13.0",
   "source": "package-lock.json",
   "dependencies": [
     {

package/docs/catalogs/app-routes.json

@@ -1306,6 +1306,7 @@
         "getGithubInstallations",
         "getGithubInstallationsByInstallationIdRepositories",
         "getOrganizationsByOrganizationIdPublicationsByPublicationIdRepositoryBindingsCurrent",
+        "postGithubInstallationsByInstallationIdRepositories",
         "postOrganizationsByOrganizationIdPublicationsByPublicationIdConfigurationChangesPlan",
         "postOrganizationsByOrganizationIdPublicationsByPublicationIdPublishes",
         "postOrganizationsByOrganizationIdPublicationsByPublicationIdPublishesByPublishIdCancel",
@@ -1591,5 +1592,5 @@
       ]
     }
   ],
-  "digest": "sha256:32e5dd41da10ffc018ad79467d80624e614a0276d5bff2c2a5c26a107d0d31b6"
+  "digest": "sha256:d2eccb738dcd301d9e83a6ce0ef7dd8ed4e71f6f6f4fa7e67126c2ef0a99e84b"
 }

package/docs/catalogs/schema-inventory.json

@@ -209,9 +209,9 @@
       "version": "2.0.0",
       "path": "openapi/openapi.yaml",
       "materialized": true,
-      "sourceDigest": "sha256:548e213c59e1b9bfa105d2cbc9ccde89162293f8337831c97992fd012a8cbe62",
+      "sourceDigest": "sha256:5d997a363085652fa2d78b6ffd7f3e307edabecbcb18cc56ed785353bcf33896",
       "typescriptRootType": null
     }
   ],
-  "digest": "sha256:dc42ec24f4d3e807e75fbd1eed275131434a09c6d7e6940a7f17c1f3b1a3c77d"
+  "digest": "sha256:c98e1d350d67018d609def3606d02049bb6acc5b5bb165912606d5215fdd3623"
 }

package/openapi/http-catalog.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "2.0.0",
   "sourceDesignRevision": "a53052955ceb6c1aa10c886289dc832eedfe6de0a00004df07d353ac19c4403a",
-  "openApiDigest": "sha256:548e213c59e1b9bfa105d2cbc9ccde89162293f8337831c97992fd012a8cbe62",
+  "openApiDigest": "sha256:5d997a363085652fa2d78b6ffd7f3e307edabecbcb18cc56ed785353bcf33896",
   "operations": [
     {
       "operationId": "getInternalHealth",
@@ -123,6 +123,18 @@
       "actionGrant": "none",
       "sourceFragment": "github"
     },
+    {
+      "operationId": "postGithubInstallationsByInstallationIdRepositories",
+      "method": "POST",
+      "path": "/v2/github/installations/{installationId}/repositories",
+      "purpose": "create a repository on this installation's account",
+      "capabilityKey": null,
+      "conditionalCapabilityKeys": [],
+      "activationGate": "MVP",
+      "assuranceClass": "SESSION",
+      "actionGrant": "none",
+      "sourceFragment": "github"
+    },
     {
       "operationId": "postMembershipInvitationsByTokenAccept",
       "method": "POST",
@@ -929,5 +941,5 @@
       "sourceFragment": "workloads"
     }
   ],
-  "digest": "sha256:c49369a752150235b9334fa2495e32302daab7afc81d65cc3d58e6b5fb116bdd"
+  "digest": "sha256:002edc7aa9c72f1b459d3d534af24c1f00fb4a6fd1d94bbcec5f611eb58eca77"
 }

package/openapi/openapi.yaml

@@ -1452,6 +1452,11 @@ components:
         - organizations
         - capabilities
       type: object
+    GithubInstallationAccess:
+      enum:
+        - GRANTED
+        - NOT_GRANTED
+      type: string
     GithubInstallationObservation:
       additionalProperties: false
       description: Whether this installation has been durably observed as a provider fact that a repository binding may reference (LOCAL-24, LOCAL-36 G-11).
@@ -1528,6 +1533,11 @@ components:
         - defaultBranch
         - private
       type: object
+    GithubRepositoryVisibility:
+      enum:
+        - PRIVATE
+        - PUBLIC
+      type: string
     KernelAttemptSubmission:
       additionalProperties: false
       allOf:
@@ -8589,6 +8599,68 @@ components:
       required:
         - accepted
       type: object
+    PostGithubInstallationsByInstallationIdRepositoriesRequest:
+      additionalProperties: false
+      properties:
+        description:
+          description: Single-line repository description, GitHub-side free text.
+          maxLength: 350
+          minLength: 1
+          pattern: ^[^\n\r]*$
+          type: string
+        name:
+          description: GitHub repository-name rules.
+          maxLength: 100
+          minLength: 1
+          pattern: ^(?!\.\.?$)(?!.*\.git$)[A-Za-z0-9._-]{1,100}$
+          type: string
+        visibility:
+          $ref: "#/components/schemas/GithubRepositoryVisibility"
+      required:
+        - name
+      type: object
+    PostGithubInstallationsByInstallationIdRepositoriesResponse:
+      additionalProperties: false
+      description: The created repository, in exactly the shape `GET .../installations/{installationId}/repositories` returns, plus whether this installation can already see it.
+      properties:
+        defaultBranch:
+          maxLength: 80
+          minLength: 1
+          type: string
+        fullName:
+          description: GitHub's `owner/name` identity, for display.
+          maxLength: 140
+          minLength: 3
+          pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,38}/[A-Za-z0-9._-]{1,100}$
+          type: string
+        installationAccess:
+          $ref: "#/components/schemas/GithubInstallationAccess"
+        name:
+          maxLength: 100
+          minLength: 1
+          type: string
+        ownerId:
+          pattern: ^[1-9][0-9]{0,19}$
+          type: string
+        ownerLogin:
+          maxLength: 80
+          minLength: 1
+          type: string
+        private:
+          type: boolean
+        repositoryId:
+          pattern: ^[1-9][0-9]{0,19}$
+          type: string
+      required:
+        - repositoryId
+        - ownerId
+        - ownerLogin
+        - name
+        - fullName
+        - defaultBranch
+        - private
+        - installationAccess
+      type: object
     PostMembershipInvitationsByTokenAcceptRequest:
       additionalProperties: false
       properties:
@@ -12213,6 +12285,33 @@ paths:
           x-gala-problem-codes:
             - AUTHENTICATION_REQUIRED
             - REAUTH_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
       security:
         - browserSession: []
       summary: installations visible through user and GitHub App intersection
@@ -12220,7 +12319,7 @@ paths:
         - github
       x-gala-activation-gate: MVP
       x-gala-activation-guards:
-        - NONE
+        - Configured GitHub App identity for this deployment
       x-gala-capability-key: null
       x-gala-concurrency: installation-epoch
       x-gala-conditional-capabilities: []
@@ -12229,6 +12328,7 @@ paths:
       x-gala-purpose: installations visible through user and GitHub App intersection
       x-gala-reachable-problems:
         - AUTHENTICATION_REQUIRED
+        - CAPABILITY_UNAVAILABLE
         - REAUTH_REQUIRED
         - VALIDATION_FAILED
       x-gala-replay-identity: safe-query
@@ -12348,6 +12448,33 @@ paths:
               $ref: "#/components/headers/XCorrelationId"
           x-gala-problem-codes:
             - RESOURCE_NOT_FOUND
+        "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
       security:
         - browserSession: []
       summary: repositories this installation grants to the signed-in user
@@ -12355,7 +12482,7 @@ paths:
         - github
       x-gala-activation-gate: MVP
       x-gala-activation-guards:
-        - NONE
+        - Configured GitHub App identity for this deployment
       x-gala-capability-key: null
       x-gala-concurrency: installation-epoch
       x-gala-conditional-capabilities: []
@@ -12364,6 +12491,7 @@ paths:
       x-gala-purpose: repositories this installation grants to the signed-in user
       x-gala-reachable-problems:
         - AUTHENTICATION_REQUIRED
+        - CAPABILITY_UNAVAILABLE
         - REAUTH_REQUIRED
         - RESOURCE_NOT_FOUND
         - VALIDATION_FAILED
@@ -12372,6 +12500,369 @@ paths:
         - NONE
       x-gala-success-category: query
       x-gala-tenant-scope: NONE
+    post:
+      operationId: postGithubInstallationsByInstallationIdRepositories
+      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/IdempotencyKey"
+        - $ref: "#/components/parameters/XCsrfToken"
+      requestBody:
+        content:
+          application/json:
+            examples:
+              nominal:
+                summary: Nominal valid request
+                value:
+                  description: example description
+                  name: example
+                  visibility: PRIVATE
+            schema:
+              $ref: "#/components/schemas/PostGithubInstallationsByInstallationIdRepositoriesRequest"
+        required: true
+      responses:
+        "201":
+          content:
+            application/json:
+              examples:
+                nominal:
+                  summary: Nominal successful response
+                  value:
+                    defaultBranch: main
+                    fullName: example/example
+                    installationAccess: GRANTED
+                    name: example
+                    ownerId: "1"
+                    ownerLogin: example
+                    private: true
+                    repositoryId: "1"
+              schema:
+                $ref: "#/components/schemas/PostGithubInstallationsByInstallationIdRepositoriesResponse"
+          description: create a repository on this installation's account succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            Location:
+              $ref: "#/components/headers/Location"
+            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
+                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
+        "403":
+          content:
+            application/problem+json:
+              examples:
+                AUTHORIZATION_DENIED:
+                  summary: AUTHORIZATION_DENIED
+                  value:
+                    code: AUTHORIZATION_DENIED
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: GitHub refused the create. See the operation contract for the closed `errors[].code` extension distinguishing CREATION_NOT_PERMITTED (the person may not create repositories on this account) from PERMISSION_NOT_ACCEPTED (the installation has not accepted the app's Administration permission yet).
+                    errors:
+                      - code: CREATION_NOT_PERMITTED
+                        pointer: /reason
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 403
+                    title: AUTHORIZATION_DENIED
+                    type: urn:gala:problem:authorization-denied
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: AUTHORIZATION_DENIED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - AUTHORIZATION_DENIED
+        "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
+        "409":
+          content:
+            application/problem+json:
+              examples:
+                COMMAND_REPLAY_CONFLICT:
+                  summary: COMMAND_REPLAY_CONFLICT
+                  value:
+                    code: COMMAND_REPLAY_CONFLICT
+                    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: COMMAND_REPLAY_CONFLICT
+                    type: urn:gala:problem:command-replay-conflict
+                INVALID_SOURCE_STATE:
+                  summary: INVALID_SOURCE_STATE
+                  value:
+                    code: INVALID_SOURCE_STATE
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: A repository with this name already exists on the resolved account. See the operation contract.
+                    errors:
+                      - code: INVALID_SOURCE_STATE
+                        pointer: /name
+                    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: COMMAND_REPLAY_CONFLICT, INVALID_SOURCE_STATE
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - COMMAND_REPLAY_CONFLICT
+            - 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:
+                      - code: VALIDATION_FAILED
+                        pointer: /name
+                    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
+        "429":
+          content:
+            application/problem+json:
+              examples:
+                RATE_LIMITED:
+                  summary: RATE_LIMITED
+                  value:
+                    code: RATE_LIMITED
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: true
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 429
+                    title: RATE_LIMITED
+                    type: urn:gala:problem:rate-limited
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: RATE_LIMITED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            Retry-After:
+              $ref: "#/components/headers/RetryAfter"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - RATE_LIMITED
+        "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
+                DEPENDENCY_UNAVAILABLE:
+                  summary: DEPENDENCY_UNAVAILABLE
+                  value:
+                    code: DEPENDENCY_UNAVAILABLE
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: true
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 503
+                    title: DEPENDENCY_UNAVAILABLE
+                    type: urn:gala:problem:dependency-unavailable
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: CAPABILITY_UNAVAILABLE, DEPENDENCY_UNAVAILABLE
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - CAPABILITY_UNAVAILABLE
+            - DEPENDENCY_UNAVAILABLE
+      security:
+        - browserSession: []
+      summary: create a repository on this installation's account
+      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: 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: create a repository on this installation's account
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - CAPABILITY_UNAVAILABLE
+        - COMMAND_REPLAY_CONFLICT
+        - DEPENDENCY_UNAVAILABLE
+        - INVALID_SOURCE_STATE
+        - RATE_LIMITED
+        - REAUTH_REQUIRED
+        - REQUEST_FIELD_UNKNOWN
+        - RESOURCE_NOT_FOUND
+        - VALIDATION_FAILED
+      x-gala-replay-identity: idempotency-key
+      x-gala-state-guards:
+        - GithubRepository:name unclaimed on the resolved account
+      x-gala-success-category: create
+      x-gala-tenant-scope: NONE
   /v2/membership-invitations/{token}:accept:
     post:
       description: |
@@ -21203,9 +21694,22 @@ paths:
                     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
+          description: AUTHENTICATION_REQUIRED, REAUTH_REQUIRED
           headers:
             Cache-Control:
               $ref: "#/components/headers/CacheControlNoStore"
@@ -21213,6 +21717,7 @@ paths:
               $ref: "#/components/headers/XCorrelationId"
           x-gala-problem-codes:
             - AUTHENTICATION_REQUIRED
+            - REAUTH_REQUIRED
         "403":
           content:
             application/problem+json:
@@ -21382,6 +21887,7 @@ paths:
         - CAPABILITY_UNAVAILABLE
         - COMMAND_REPLAY_CONFLICT
         - INVALID_SOURCE_STATE
+        - REAUTH_REQUIRED
         - REQUEST_FIELD_UNKNOWN
         - RESOURCE_NOT_FOUND
         - VALIDATION_FAILED

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rathnasgala2/schemas",
-  "version": "2.12.0",
+  "version": "2.13.0",
   "description": "Executable JSON Schema and OpenAPI contracts for Galascribe",
   "type": "module",
   "license": "Apache-2.0",

package/sbom.cdx.json

@@ -97,8 +97,8 @@
       "type": "library",
       "name": "schemas",
       "group": "@rathnasgala2",
-      "version": "2.12.0",
-      "bom-ref": "@rathnasgala2/schemas@2.12.0",
+      "version": "2.13.0",
+      "bom-ref": "@rathnasgala2/schemas@2.13.0",
       "description": "Executable JSON Schema and OpenAPI contracts for Galascribe",
       "licenses": [
         {
@@ -108,7 +108,7 @@
           }
         }
       ],
-      "purl": "pkg:npm/%40rathnasgala2/schemas@2.12.0?vcs_url=git%2Bhttps%3A%2F%2Fgithub.com%2Frathnasgala2%2Fschema.git",
+      "purl": "pkg:npm/%40rathnasgala2/schemas@2.13.0?vcs_url=git%2Bhttps%3A%2F%2Fgithub.com%2Frathnasgala2%2Fschema.git",
       "externalReferences": [
         {
           "url": "https://github.com/rathnasgala2/schema/issues",
@@ -153,7 +153,7 @@
       "type": "library",
       "name": "ajv-formats",
       "version": "3.0.1",
-      "bom-ref": "@rathnasgala2/schemas@2.12.0|ajv-formats@3.0.1",
+      "bom-ref": "@rathnasgala2/schemas@2.13.0|ajv-formats@3.0.1",
       "licenses": [
         {
           "license": {
@@ -187,7 +187,7 @@
       "type": "library",
       "name": "ajv",
       "version": "8.20.0",
-      "bom-ref": "@rathnasgala2/schemas@2.12.0|ajv@8.20.0",
+      "bom-ref": "@rathnasgala2/schemas@2.13.0|ajv@8.20.0",
       "licenses": [
         {
           "license": {
@@ -221,7 +221,7 @@
       "type": "library",
       "name": "fast-deep-equal",
       "version": "3.1.3",
-      "bom-ref": "@rathnasgala2/schemas@2.12.0|fast-deep-equal@3.1.3",
+      "bom-ref": "@rathnasgala2/schemas@2.13.0|fast-deep-equal@3.1.3",
       "licenses": [
         {
           "license": {
@@ -255,7 +255,7 @@
       "type": "library",
       "name": "fast-uri",
       "version": "3.1.7",
-      "bom-ref": "@rathnasgala2/schemas@2.12.0|fast-uri@3.1.7",
+      "bom-ref": "@rathnasgala2/schemas@2.13.0|fast-uri@3.1.7",
       "licenses": [
         {
           "license": {
@@ -289,7 +289,7 @@
       "type": "library",
       "name": "json-schema-traverse",
       "version": "1.0.0",
-      "bom-ref": "@rathnasgala2/schemas@2.12.0|json-schema-traverse@1.0.0",
+      "bom-ref": "@rathnasgala2/schemas@2.13.0|json-schema-traverse@1.0.0",
       "licenses": [
         {
           "license": {
@@ -323,7 +323,7 @@
       "type": "library",
       "name": "require-from-string",
       "version": "2.0.2",
-      "bom-ref": "@rathnasgala2/schemas@2.12.0|require-from-string@2.0.2",
+      "bom-ref": "@rathnasgala2/schemas@2.13.0|require-from-string@2.0.2",
       "licenses": [
         {
           "license": {
@@ -1064,10 +1064,10 @@
   ],
   "dependencies": [
     {
-      "ref": "@rathnasgala2/schemas@2.12.0",
+      "ref": "@rathnasgala2/schemas@2.13.0",
       "dependsOn": [
-        "@rathnasgala2/schemas@2.12.0|ajv-formats@3.0.1",
-        "@rathnasgala2/schemas@2.12.0|ajv@8.20.0",
+        "@rathnasgala2/schemas@2.13.0|ajv-formats@3.0.1",
+        "@rathnasgala2/schemas@2.13.0|ajv@8.20.0",
         "pkg:npm/semver@7.8.5",
         "urn:gala:source-data:iana-ipv4-special-registry",
         "urn:gala:source-data:iana-ipv6-special-registry",
@@ -1089,31 +1089,31 @@
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@2.12.0|ajv-formats@3.0.1",
+      "ref": "@rathnasgala2/schemas@2.13.0|ajv-formats@3.0.1",
       "dependsOn": [
-        "@rathnasgala2/schemas@2.12.0|ajv@8.20.0"
+        "@rathnasgala2/schemas@2.13.0|ajv@8.20.0"
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@2.12.0|ajv@8.20.0",
+      "ref": "@rathnasgala2/schemas@2.13.0|ajv@8.20.0",
       "dependsOn": [
-        "@rathnasgala2/schemas@2.12.0|fast-deep-equal@3.1.3",
-        "@rathnasgala2/schemas@2.12.0|fast-uri@3.1.7",
-        "@rathnasgala2/schemas@2.12.0|json-schema-traverse@1.0.0",
-        "@rathnasgala2/schemas@2.12.0|require-from-string@2.0.2"
+        "@rathnasgala2/schemas@2.13.0|fast-deep-equal@3.1.3",
+        "@rathnasgala2/schemas@2.13.0|fast-uri@3.1.7",
+        "@rathnasgala2/schemas@2.13.0|json-schema-traverse@1.0.0",
+        "@rathnasgala2/schemas@2.13.0|require-from-string@2.0.2"
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@2.12.0|fast-deep-equal@3.1.3"
+      "ref": "@rathnasgala2/schemas@2.13.0|fast-deep-equal@3.1.3"
     },
     {
-      "ref": "@rathnasgala2/schemas@2.12.0|fast-uri@3.1.7"
+      "ref": "@rathnasgala2/schemas@2.13.0|fast-uri@3.1.7"
     },
     {
-      "ref": "@rathnasgala2/schemas@2.12.0|json-schema-traverse@1.0.0"
+      "ref": "@rathnasgala2/schemas@2.13.0|json-schema-traverse@1.0.0"
     },
     {
-      "ref": "@rathnasgala2/schemas@2.12.0|require-from-string@2.0.2"
+      "ref": "@rathnasgala2/schemas@2.13.0|require-from-string@2.0.2"
     },
     {
       "ref": "pkg:npm/semver@7.8.5"