@rathnasgala2/schemas 2.19.0 → 2.20.2

package/THIRD_PARTY_LICENSES.json

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

package/docs/catalogs/app-components.json

@@ -2762,7 +2762,7 @@
     },
     {
       "contentKey": "organizations.by-organization-id.publications.by-publication-id.reviews.screen.ready.summary",
-      "defaultMessage": "Ask for a review of a confirmed change, see every review this publication has, and approve or reject the one in front of you. An approved review is what a publish is started from.",
+      "defaultMessage": "Open the exact GitHub pull request for a proposed change, use GitHub for discussion and review, then verify its exact merge before publishing.",
       "description": "Summary for the organizations.by-organization-id.publications.by-publication-id.reviews screen, copied verbatim from document 14's Screen/job cell.",
       "placeholders": {},
       "sensitivity": "AUTHENTICATED"
@@ -4707,5 +4707,5 @@
       "sensitivity": "PUBLIC"
     }
   ],
-  "digest": "sha256:3c8f46cb53c89980a26d8d4134d0f8bdd72d80cd96576a24baec31edf335ce2a"
+  "digest": "sha256:19224c64ecee26f8f00ae1cd2fa8fb767311e21ab5b139e799f66b0bbec5936a"
 }

package/docs/catalogs/app-routes.json

@@ -969,16 +969,29 @@
       "pathTemplate": "/organizations/{organizationId}/publications/{publicationId}/content",
       "screenId": "organizations.by-organization-id.publications.by-publication-id.content.screen",
       "authenticationClass": "SESSION_REQUIRED",
-      "capabilityKeys": ["publication.source.write", "publication.view"],
+      "capabilityKeys": [
+        "organization.view",
+        "publication.integrations.manage",
+        "publication.review",
+        "publication.source.write",
+        "publication.view"
+      ],
       "apiOperationIds": [
+        "getOrganizationsByOrganizationIdOperationsByOperationId",
         "getOrganizationsByOrganizationIdPublicationsByPublicationId",
         "getOrganizationsByOrganizationIdPublicationsByPublicationIdContent",
         "getOrganizationsByOrganizationIdPublicationsByPublicationIdContentAssets",
         "getOrganizationsByOrganizationIdPublicationsByPublicationIdContentDocuments",
+        "getOrganizationsByOrganizationIdPublicationsByPublicationIdDeployments",
         "getOrganizationsByOrganizationIdPublicationsByPublicationIdRepositoryChanges",
         "getOrganizationsByOrganizationIdPublicationsByPublicationIdRepositoryChangesByChangeId",
+        "getOrganizationsByOrganizationIdPublicationsByPublicationIdRepositorySetup",
+        "getOrganizationsByOrganizationIdPublicationsByPublicationIdReviewsByReviewId",
         "postOrganizationsByOrganizationIdPublicationsByPublicationIdContentChangesPlan",
-        "postOrganizationsByOrganizationIdPublicationsByPublicationIdRepositoryChangesByChangeIdBringUpToDate"
+        "postOrganizationsByOrganizationIdPublicationsByPublicationIdRepositoryChangesByChangeIdBringUpToDate",
+        "postOrganizationsByOrganizationIdPublicationsByPublicationIdRepositoryChangesByChangeIdConfirm",
+        "postOrganizationsByOrganizationIdPublicationsByPublicationIdRepositorySetUp",
+        "postOrganizationsByOrganizationIdPublicationsByPublicationIdReviews"
       ],
       "componentIds": [
         "AppShell",
@@ -1057,17 +1070,24 @@
         "organization.publications.admin",
         "organization.view",
         "publication.publish",
+        "publication.review",
         "publication.rollback",
+        "publication.source.write",
         "publication.view"
       ],
       "apiOperationIds": [
         "getOrganizationsByOrganizationIdOperationsByOperationId",
         "getOrganizationsByOrganizationIdPublicationsByPublicationIdDeployments",
         "getOrganizationsByOrganizationIdPublicationsByPublicationIdDeploymentsByGenerationId",
+        "getOrganizationsByOrganizationIdPublicationsByPublicationIdDestination",
+        "getOrganizationsByOrganizationIdPublicationsByPublicationIdRepositoryChangesByChangeId",
+        "getOrganizationsByOrganizationIdPublicationsByPublicationIdReviewsByReviewId",
         "postOrganizationsByOrganizationIdOperationsByOperationIdCancel",
         "postOrganizationsByOrganizationIdPublicationsByPublicationIdDeploymentsByGenerationIdReconcile",
         "postOrganizationsByOrganizationIdPublicationsByPublicationIdDeploymentsRollback",
-        "postOrganizationsByOrganizationIdPublicationsByPublicationIdPublishesByPublishIdUpdateDefaultBranch"
+        "postOrganizationsByOrganizationIdPublicationsByPublicationIdPublishes",
+        "postOrganizationsByOrganizationIdPublicationsByPublicationIdPublishesByPublishIdUpdateDefaultBranch",
+        "postOrganizationsByOrganizationIdPublicationsByPublicationIdRepositoryChangesByChangeIdBringUpToDate"
       ],
       "componentIds": [
         "AppShell",
@@ -1143,10 +1163,16 @@
       "pathTemplate": "/organizations/{organizationId}/publications/{publicationId}/reviews",
       "screenId": "organizations.by-organization-id.publications.by-publication-id.reviews.screen",
       "authenticationClass": "SESSION_REQUIRED",
-      "capabilityKeys": ["publication.review"],
+      "capabilityKeys": [
+        "publication.review",
+        "publication.source.write",
+        "publication.view"
+      ],
       "apiOperationIds": [
+        "getOrganizationsByOrganizationIdPublicationsByPublicationIdRepositoryChangesByChangeId",
         "getOrganizationsByOrganizationIdPublicationsByPublicationIdReviews",
         "getOrganizationsByOrganizationIdPublicationsByPublicationIdReviewsByReviewId",
+        "postOrganizationsByOrganizationIdPublicationsByPublicationIdRepositoryChangesByChangeIdConfirm",
         "postOrganizationsByOrganizationIdPublicationsByPublicationIdReviews",
         "postOrganizationsByOrganizationIdPublicationsByPublicationIdReviewsByReviewIdDecide"
       ],
@@ -1602,5 +1628,5 @@
       ]
     }
   ],
-  "digest": "sha256:80401d17e9366bb0c496db9c2fe7520a7f106b1fef24d3c1be11b4cace48581d"
+  "digest": "sha256:d642c9a2b300245d8f9fac1218786a63e114a3ec2863ef1605085d57ca015bde"
 }

package/docs/catalogs/schema-inventory.json

@@ -209,9 +209,9 @@
       "version": "2.0.0",
       "path": "openapi/openapi.yaml",
       "materialized": true,
-      "sourceDigest": "sha256:ac5d5e8eb1c802a25d00a3524b1361283f581fc7e24baa4046b7ef53adef6d03",
+      "sourceDigest": "sha256:d2f0fca368b85337ab0960bea3ac7519e99bc5d201e8b73a9c26ba18a796e198",
       "typescriptRootType": null
     }
   ],
-  "digest": "sha256:e130cecc6c05051ea4c813d6b1c61a3d9db8013301e63ca492240e6759596306"
+  "digest": "sha256:6dbafbec52e2caedfc3efd5f2ea56b27976aa4661f85d5424d3d24e3854c3bc5"
 }

package/openapi/http-catalog.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "2.0.0",
   "sourceDesignRevision": "a53052955ceb6c1aa10c886289dc832eedfe6de0a00004df07d353ac19c4403a",
-  "openApiDigest": "sha256:ac5d5e8eb1c802a25d00a3524b1361283f581fc7e24baa4046b7ef53adef6d03",
+  "openApiDigest": "sha256:d2f0fca368b85337ab0960bea3ac7519e99bc5d201e8b73a9c26ba18a796e198",
   "operations": [
     {
       "operationId": "getInternalHealth",
@@ -800,12 +800,12 @@
       "operationId": "postOrganizationsByOrganizationIdPublicationsByPublicationIdReviewsByReviewIdDecide",
       "method": "POST",
       "path": "/v2/organizations/{organizationId}/publications/{publicationId}/reviews/{reviewId}:decide",
-      "purpose": "approve or reject exact reviewed revision",
+      "purpose": "synchronize the exact reviewed revision with GitHub merge state",
       "capabilityKey": "publication.review",
       "conditionalCapabilityKeys": [],
       "activationGate": "MVP",
-      "assuranceClass": "RECENT_AUTHENTICATION",
-      "actionGrant": "required",
+      "assuranceClass": "SESSION",
+      "actionGrant": "none",
       "sourceFragment": "organizations"
     },
     {
@@ -1049,5 +1049,5 @@
       "sourceFragment": "workloads"
     }
   ],
-  "digest": "sha256:6ac934a579256838cec02cdb44a6f7009f6722bb2cb26213cc0d0297f17f4cef"
+  "digest": "sha256:efee512ea3eeef5c1ff9be78e6a037e2d174f88bdedb7255cda3d7444d7a0509"
 }

package/openapi/openapi.yaml

@@ -10181,16 +10181,26 @@ components:
       type: object
     PostOrganizationsByOrganizationIdPublicationsByPublicationIdRepositoryChangesByChangeIdConfirmRequest:
       additionalProperties: false
+      description: |
+        Optional compatibility assertions for the persisted plan. When a
+        member is omitted, the server uses the corresponding fact already
+        stored on `changeId`; when supplied, it must exactly match that fact.
+        An empty object therefore confirms the server-persisted plan without
+        requiring a client to echo opaque digests it just received.
       properties:
         diffDigest:
+          description: |
+            Optional assertion of the persisted planned-diff digest. Omit to
+            use the digest stored on `changeId`.
           pattern: ^sha256:[0-9a-f]{64}$
           type: string
         expectedHead:
+          description: |
+            Optional assertion of the persisted expected Git head. Omit to
+            use the head stored on `changeId`.
           pattern: ^(?:sha1:[0-9a-f]{40}|sha256:[0-9a-f]{64})$
           type: string
-      required:
-        - expectedHead
-        - diffDigest
+      required: []
       type: object
     PostOrganizationsByOrganizationIdPublicationsByPublicationIdRepositoryChangesByChangeIdConfirmResponse:
       allOf:
@@ -10276,7 +10286,7 @@ components:
       type: object
     PostOrganizationsByOrganizationIdPublicationsByPublicationIdRepositorySetUpResponse:
       allOf:
-        - $ref: "#/components/schemas/OperationResponse"
+        - $ref: "#/components/schemas/GetOrganizationsByOrganizationIdPublicationsByPublicationIdRepositorySetupResponse"
     PostOrganizationsByOrganizationIdPublicationsByPublicationIdReviewsByReviewIdDecideRequest:
       additionalProperties: false
       properties:
@@ -23151,22 +23161,9 @@ 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, REAUTH_REQUIRED
+          description: AUTHENTICATION_REQUIRED
           headers:
             Cache-Control:
               $ref: "#/components/headers/CacheControlNoStore"
@@ -23174,7 +23171,6 @@ paths:
               $ref: "#/components/headers/XCorrelationId"
           x-gala-problem-codes:
             - AUTHENTICATION_REQUIRED
-            - REAUTH_REQUIRED
         "403":
           content:
             application/problem+json:
@@ -23375,7 +23371,6 @@ paths:
         - CAPABILITY_UNAVAILABLE
         - COMMAND_REPLAY_CONFLICT
         - INVALID_SOURCE_STATE
-        - REAUTH_REQUIRED
         - REQUEST_FIELD_UNKNOWN
         - RESOURCE_NOT_FOUND
         - STALE_AGGREGATE_VERSION
@@ -25481,6 +25476,11 @@ paths:
       x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
   /v2/organizations/{organizationId}/publications/{publicationId}/repository-changes/{changeId}:confirm:
     post:
+      description: |
+        Confirm the persisted plan and enqueue creation of its candidate ref,
+        commit and GitHub pull request. `expectedHead` and `diffDigest` are
+        optional compatibility assertions: an omitted member is read from the
+        persisted plan, while a supplied member must match it exactly.
       operationId: postOrganizationsByOrganizationIdPublicationsByPublicationIdRepositoryChangesByChangeIdConfirm
       parameters:
         - $ref: "#/components/parameters/XCorrelationId"
@@ -25514,11 +25514,14 @@ paths:
         content:
           application/json:
             examples:
-              nominal:
-                summary: Nominal valid request
+              asserted:
+                summary: Confirm while asserting the echoed plan facts
                 value:
                   diffDigest: sha256:0000000000000000000000000000000000000000000000000000000000000000
                   expectedHead: sha1:0000000000000000000000000000000000000000
+              nominal:
+                summary: Confirm using the server-persisted plan facts
+                value: {}
             schema:
               $ref: "#/components/schemas/PostOrganizationsByOrganizationIdPublicationsByPublicationIdRepositoryChangesByChangeIdConfirmRequest"
         required: true
@@ -25537,7 +25540,7 @@ paths:
                     statusUrl: /v2/organizations/018f0000-0000-7000-8000-000000000001/operations/018f0000-0000-7000-8000-000000000002
               schema:
                 $ref: "#/components/schemas/PostOrganizationsByOrganizationIdPublicationsByPublicationIdRepositoryChangesByChangeIdConfirmResponse"
-          description: create candidate ref and commit after exact confirmation succeeded
+          description: candidate ref, commit and GitHub pull-request creation was accepted
           headers:
             Cache-Control:
               $ref: "#/components/headers/CacheControlNoStore"
@@ -25781,7 +25784,7 @@ paths:
         - organizations
       x-gala-activation-gate: MVP
       x-gala-activation-guards:
-        - Unchanged expected Git head, normalized reviewed diff, schema version, and actor confirmation
+        - Unchanged persisted expected Git head, normalized reviewed diff, schema version, and actor confirmation
       x-gala-capability-key: publication.source.write
       x-gala-concurrency: planned-change-digest-and-expected-git-head
       x-gala-conditional-capabilities: []
@@ -26346,21 +26349,19 @@ paths:
               $ref: "#/components/schemas/PostOrganizationsByOrganizationIdPublicationsByPublicationIdRepositorySetUpRequest"
         required: true
       responses:
-        "202":
+        "200":
           content:
             application/json:
               examples:
                 nominal:
                   summary: Nominal successful response
                   value:
-                    commandId: 018f0000-0000-7000-8000-000000000001
-                    operationId: 018f0000-0000-7000-8000-000000000002
-                    phase: accepted
-                    resourceVersion: 0
-                    statusUrl: /v2/organizations/018f0000-0000-7000-8000-000000000001/operations/018f0000-0000-7000-8000-000000000002
+                    conflicts: []
+                    missing: []
+                    state: SET_UP
               schema:
                 $ref: "#/components/schemas/PostOrganizationsByOrganizationIdPublicationsByPublicationIdRepositorySetUpResponse"
-          description: add the user template files to a linked repository that lacks them succeeded
+          description: The repository files, Pages configuration, and repository homepage were set up synchronously. No operation resource is created.
           headers:
             Cache-Control:
               $ref: "#/components/headers/CacheControlNoStore"
@@ -26641,8 +26642,8 @@ paths:
         - VALIDATION_FAILED
       x-gala-replay-identity: idempotency-key
       x-gala-state-guards:
-        - RepositorySetup:NOT_SET_UP|FAILED -> SETTING_UP
-      x-gala-success-category: async
+        - RepositorySetup:NOT_SET_UP|FAILED -> SET_UP
+      x-gala-success-category: protocol
       x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
   /v2/organizations/{organizationId}/publications/{publicationId}/reviews:
     get:
@@ -27596,20 +27597,20 @@ paths:
             - CAPABILITY_UNAVAILABLE
       security:
         - browserSession: []
-      summary: approve or reject exact reviewed revision
+      summary: synchronize the exact reviewed revision with GitHub merge state
       tags:
         - organizations
-      x-gala-action-grant: required
+      x-gala-action-grant: none
       x-gala-activation-gate: MVP
       x-gala-activation-guards:
         - Exact current review revision, reviewer-separation policy, and reviewer evidence
-      x-gala-assurance-class: RECENT_AUTHENTICATION
+      x-gala-assurance-class: SESSION
       x-gala-capability-key: publication.review
       x-gala-concurrency: review-version
       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: approve or reject exact reviewed revision
+      x-gala-purpose: synchronize the exact reviewed revision with GitHub merge state
       x-gala-reachable-problems:
         - AUTHENTICATION_REQUIRED
         - AUTHORIZATION_DENIED

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rathnasgala2/schemas",
-  "version": "2.19.0",
+  "version": "2.20.2",
   "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.19.0",
-      "bom-ref": "@rathnasgala2/schemas@2.19.0",
+      "version": "2.20.2",
+      "bom-ref": "@rathnasgala2/schemas@2.20.2",
       "description": "Executable JSON Schema and OpenAPI contracts for Galascribe",
       "licenses": [
         {
@@ -108,7 +108,7 @@
           }
         }
       ],
-      "purl": "pkg:npm/%40rathnasgala2/schemas@2.19.0?vcs_url=git%2Bhttps%3A%2F%2Fgithub.com%2Frathnasgala2%2Fschema.git",
+      "purl": "pkg:npm/%40rathnasgala2/schemas@2.20.2?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.19.0|ajv-formats@3.0.1",
+      "bom-ref": "@rathnasgala2/schemas@2.20.2|ajv-formats@3.0.1",
       "licenses": [
         {
           "license": {
@@ -187,7 +187,7 @@
       "type": "library",
       "name": "ajv",
       "version": "8.20.0",
-      "bom-ref": "@rathnasgala2/schemas@2.19.0|ajv@8.20.0",
+      "bom-ref": "@rathnasgala2/schemas@2.20.2|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.19.0|fast-deep-equal@3.1.3",
+      "bom-ref": "@rathnasgala2/schemas@2.20.2|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.19.0|fast-uri@3.1.7",
+      "bom-ref": "@rathnasgala2/schemas@2.20.2|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.19.0|json-schema-traverse@1.0.0",
+      "bom-ref": "@rathnasgala2/schemas@2.20.2|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.19.0|require-from-string@2.0.2",
+      "bom-ref": "@rathnasgala2/schemas@2.20.2|require-from-string@2.0.2",
       "licenses": [
         {
           "license": {
@@ -1064,10 +1064,10 @@
   ],
   "dependencies": [
     {
-      "ref": "@rathnasgala2/schemas@2.19.0",
+      "ref": "@rathnasgala2/schemas@2.20.2",
       "dependsOn": [
-        "@rathnasgala2/schemas@2.19.0|ajv-formats@3.0.1",
-        "@rathnasgala2/schemas@2.19.0|ajv@8.20.0",
+        "@rathnasgala2/schemas@2.20.2|ajv-formats@3.0.1",
+        "@rathnasgala2/schemas@2.20.2|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.19.0|ajv-formats@3.0.1",
+      "ref": "@rathnasgala2/schemas@2.20.2|ajv-formats@3.0.1",
       "dependsOn": [
-        "@rathnasgala2/schemas@2.19.0|ajv@8.20.0"
+        "@rathnasgala2/schemas@2.20.2|ajv@8.20.0"
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@2.19.0|ajv@8.20.0",
+      "ref": "@rathnasgala2/schemas@2.20.2|ajv@8.20.0",
       "dependsOn": [
-        "@rathnasgala2/schemas@2.19.0|fast-deep-equal@3.1.3",
-        "@rathnasgala2/schemas@2.19.0|fast-uri@3.1.7",
-        "@rathnasgala2/schemas@2.19.0|json-schema-traverse@1.0.0",
-        "@rathnasgala2/schemas@2.19.0|require-from-string@2.0.2"
+        "@rathnasgala2/schemas@2.20.2|fast-deep-equal@3.1.3",
+        "@rathnasgala2/schemas@2.20.2|fast-uri@3.1.7",
+        "@rathnasgala2/schemas@2.20.2|json-schema-traverse@1.0.0",
+        "@rathnasgala2/schemas@2.20.2|require-from-string@2.0.2"
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@2.19.0|fast-deep-equal@3.1.3"
+      "ref": "@rathnasgala2/schemas@2.20.2|fast-deep-equal@3.1.3"
     },
     {
-      "ref": "@rathnasgala2/schemas@2.19.0|fast-uri@3.1.7"
+      "ref": "@rathnasgala2/schemas@2.20.2|fast-uri@3.1.7"
     },
     {
-      "ref": "@rathnasgala2/schemas@2.19.0|json-schema-traverse@1.0.0"
+      "ref": "@rathnasgala2/schemas@2.20.2|json-schema-traverse@1.0.0"
     },
     {
-      "ref": "@rathnasgala2/schemas@2.19.0|require-from-string@2.0.2"
+      "ref": "@rathnasgala2/schemas@2.20.2|require-from-string@2.0.2"
     },
     {
       "ref": "pkg:npm/semver@7.8.5"