@rathnasgala2/schemas 2.19.0 → 2.20.0

package/THIRD_PARTY_LICENSES.json

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

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:d7c302879abe45afa69b5c7fd889aec759c8182ec887f354a8c864094b8c50d0",
       "typescriptRootType": null
     }
   ],
-  "digest": "sha256:e130cecc6c05051ea4c813d6b1c61a3d9db8013301e63ca492240e6759596306"
+  "digest": "sha256:868ae1b9d4c5773da3e629b712104822985a2636eed634e37067c68286cdca2e"
 }

package/openapi/http-catalog.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "2.0.0",
   "sourceDesignRevision": "a53052955ceb6c1aa10c886289dc832eedfe6de0a00004df07d353ac19c4403a",
-  "openApiDigest": "sha256:ac5d5e8eb1c802a25d00a3524b1361283f581fc7e24baa4046b7ef53adef6d03",
+  "openApiDigest": "sha256:d7c302879abe45afa69b5c7fd889aec759c8182ec887f354a8c864094b8c50d0",
   "operations": [
     {
       "operationId": "getInternalHealth",
@@ -1049,5 +1049,5 @@
       "sourceFragment": "workloads"
     }
   ],
-  "digest": "sha256:6ac934a579256838cec02cdb44a6f7009f6722bb2cb26213cc0d0297f17f4cef"
+  "digest": "sha256:3ee96a2ed4fb6ac08153fc4d845956216910d2f2c641a4e2b32f8a97cead22d8"
 }

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:
@@ -25481,6 +25491,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 +25529,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 +25555,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 +25799,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: []

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rathnasgala2/schemas",
-  "version": "2.19.0",
+  "version": "2.20.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.19.0",
-      "bom-ref": "@rathnasgala2/schemas@2.19.0",
+      "version": "2.20.0",
+      "bom-ref": "@rathnasgala2/schemas@2.20.0",
       "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.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.19.0|ajv-formats@3.0.1",
+      "bom-ref": "@rathnasgala2/schemas@2.20.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.19.0|ajv@8.20.0",
+      "bom-ref": "@rathnasgala2/schemas@2.20.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.19.0|fast-deep-equal@3.1.3",
+      "bom-ref": "@rathnasgala2/schemas@2.20.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.19.0|fast-uri@3.1.7",
+      "bom-ref": "@rathnasgala2/schemas@2.20.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.19.0|json-schema-traverse@1.0.0",
+      "bom-ref": "@rathnasgala2/schemas@2.20.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.19.0|require-from-string@2.0.2",
+      "bom-ref": "@rathnasgala2/schemas@2.20.0|require-from-string@2.0.2",
       "licenses": [
         {
           "license": {
@@ -1064,10 +1064,10 @@
   ],
   "dependencies": [
     {
-      "ref": "@rathnasgala2/schemas@2.19.0",
+      "ref": "@rathnasgala2/schemas@2.20.0",
       "dependsOn": [
-        "@rathnasgala2/schemas@2.19.0|ajv-formats@3.0.1",
-        "@rathnasgala2/schemas@2.19.0|ajv@8.20.0",
+        "@rathnasgala2/schemas@2.20.0|ajv-formats@3.0.1",
+        "@rathnasgala2/schemas@2.20.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.19.0|ajv-formats@3.0.1",
+      "ref": "@rathnasgala2/schemas@2.20.0|ajv-formats@3.0.1",
       "dependsOn": [
-        "@rathnasgala2/schemas@2.19.0|ajv@8.20.0"
+        "@rathnasgala2/schemas@2.20.0|ajv@8.20.0"
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@2.19.0|ajv@8.20.0",
+      "ref": "@rathnasgala2/schemas@2.20.0|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.0|fast-deep-equal@3.1.3",
+        "@rathnasgala2/schemas@2.20.0|fast-uri@3.1.7",
+        "@rathnasgala2/schemas@2.20.0|json-schema-traverse@1.0.0",
+        "@rathnasgala2/schemas@2.20.0|require-from-string@2.0.2"
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@2.19.0|fast-deep-equal@3.1.3"
+      "ref": "@rathnasgala2/schemas@2.20.0|fast-deep-equal@3.1.3"
     },
     {
-      "ref": "@rathnasgala2/schemas@2.19.0|fast-uri@3.1.7"
+      "ref": "@rathnasgala2/schemas@2.20.0|fast-uri@3.1.7"
     },
     {
-      "ref": "@rathnasgala2/schemas@2.19.0|json-schema-traverse@1.0.0"
+      "ref": "@rathnasgala2/schemas@2.20.0|json-schema-traverse@1.0.0"
     },
     {
-      "ref": "@rathnasgala2/schemas@2.19.0|require-from-string@2.0.2"
+      "ref": "@rathnasgala2/schemas@2.20.0|require-from-string@2.0.2"
     },
     {
       "ref": "pkg:npm/semver@7.8.5"