@rathnasgala2/schemas 2.20.2 → 2.20.3

package/README.md

@@ -59,10 +59,11 @@ 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 85 MVP operations plus `/internal/health` (86 catalog
+HTTP catalog for exactly 86 MVP operations plus `/internal/health` (87 catalog
 rows; 71 at S0-T07, plus the two SCHEMA-2.8.0 reads, the two SCHEMA-2.10.0
 publication-destination reads/writes, the SCHEMA-2.13.0 repository create, and
-the nine SCHEMA-2.14.0 write/preview/publish operations). The bundle includes
+the nine SCHEMA-2.14.0 write/preview/publish operations, and the SCHEMA-2.20.3
+review event stream). 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
@@ -683,7 +684,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 85 MVP
+- `openapi/openapi.yaml` — deterministic OpenAPI 3.1 bundle for the exact 86 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/docs/catalogs/app-components.json

@@ -2762,7 +2762,7 @@
     },
     {
       "contentKey": "organizations.by-organization-id.publications.by-publication-id.reviews.screen.ready.summary",
-      "defaultMessage": "Open the exact GitHub pull request for a proposed change, use GitHub for discussion and review, then verify its exact merge before publishing.",
+      "defaultMessage": "Open the exact GitHub pull request for a proposed change, use GitHub for discussion and review, then Galascribe observes its exact merge automatically 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:19224c64ecee26f8f00ae1cd2fa8fb767311e21ab5b139e799f66b0bbec5936a"
+  "digest": "sha256:b9b5cc6edc51da258b085a082a796c56f521acfe984ea7cbaf177c3e0ede8a95"
 }

package/docs/catalogs/app-routes.json

@@ -1172,6 +1172,7 @@
         "getOrganizationsByOrganizationIdPublicationsByPublicationIdRepositoryChangesByChangeId",
         "getOrganizationsByOrganizationIdPublicationsByPublicationIdReviews",
         "getOrganizationsByOrganizationIdPublicationsByPublicationIdReviewsByReviewId",
+        "getOrganizationsByOrganizationIdPublicationsByPublicationIdReviewsEvents",
         "postOrganizationsByOrganizationIdPublicationsByPublicationIdRepositoryChangesByChangeIdConfirm",
         "postOrganizationsByOrganizationIdPublicationsByPublicationIdReviews",
         "postOrganizationsByOrganizationIdPublicationsByPublicationIdReviewsByReviewIdDecide"
@@ -1628,5 +1629,5 @@
       ]
     }
   ],
-  "digest": "sha256:d642c9a2b300245d8f9fac1218786a63e114a3ec2863ef1605085d57ca015bde"
+  "digest": "sha256:3b40da038e0767af4ed81d78a6d4d2bde15c131bf12fb7961788793916de4800"
 }

package/openapi/http-catalog.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "2.0.0",
   "sourceDesignRevision": "a53052955ceb6c1aa10c886289dc832eedfe6de0a00004df07d353ac19c4403a",
-  "openApiDigest": "sha256:d2f0fca368b85337ab0960bea3ac7519e99bc5d201e8b73a9c26ba18a796e198",
+  "openApiDigest": "sha256:320edbae50adcda721d7d41acda313522fe09d1f9d702859808b09a30d1e24f1",
   "operations": [
     {
       "operationId": "getInternalHealth",
@@ -808,6 +808,20 @@
       "actionGrant": "none",
       "sourceFragment": "organizations"
     },
+    {
+      "operationId": "getOrganizationsByOrganizationIdPublicationsByPublicationIdReviewsEvents",
+      "method": "GET",
+      "path": "/v2/organizations/{organizationId}/publications/{publicationId}/reviews/events",
+      "purpose": "stream review state-change notifications",
+      "capabilityKey": "publication.review",
+      "conditionalCapabilityKeys": [
+        "publication.view"
+      ],
+      "activationGate": "MVP",
+      "assuranceClass": "SESSION",
+      "actionGrant": "none",
+      "sourceFragment": "organizations"
+    },
     {
       "operationId": "getOrganizationsByOrganizationIdRoles",
       "method": "GET",
@@ -1049,5 +1063,5 @@
       "sourceFragment": "workloads"
     }
   ],
-  "digest": "sha256:efee512ea3eeef5c1ff9be78e6a037e2d174f88bdedb7255cda3d7444d7a0509"
+  "digest": "sha256:757a72ddda9194481b1208e98b9cdd6cbe15fbffbb8222ee09fe6e4b3d01e96b"
 }

package/openapi/openapi.yaml

@@ -1598,6 +1598,9 @@ components:
     GetOrganizationsByOrganizationIdPublicationsByPublicationIdReviewsByReviewIdResponse:
       allOf:
         - $ref: "#/components/schemas/ReviewSummary"
+    GetOrganizationsByOrganizationIdPublicationsByPublicationIdReviewsEventsResponse:
+      description: Server-sent review state-change notifications.
+      type: string
     GetOrganizationsByOrganizationIdPublicationsByPublicationIdReviewsResponse:
       additionalProperties: false
       allOf:
@@ -27124,6 +27127,161 @@ paths:
         - Review:REQUESTED
       x-gala-success-category: async
       x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
+  /v2/organizations/{organizationId}/publications/{publicationId}/reviews/events:
+    get:
+      description: |
+        Authenticated server-sent notification stream for review state changes.
+        Events carry no authority or canonical state; a client re-reads the
+        ordinary review and repository-change resources after each signal.
+      operationId: getOrganizationsByOrganizationIdPublicationsByPublicationIdReviewsEvents
+      parameters:
+        - $ref: "#/components/parameters/XCorrelationId"
+        - example: 018f0000-0000-7000-8000-000000000001
+          in: path
+          name: organizationId
+          required: true
+          schema:
+            format: uuid
+            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
+            type: string
+        - example: 018f0000-0000-7000-8000-000000000001
+          in: path
+          name: publicationId
+          required: true
+          schema:
+            format: uuid
+            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
+            type: string
+      responses:
+        "200":
+          content:
+            text/event-stream:
+              examples:
+                nominal:
+                  summary: Stream opened
+                  value: |-
+                    event: ready
+                    data: ready
+              schema:
+                $ref: "#/components/schemas/GetOrganizationsByOrganizationIdPublicationsByPublicationIdReviewsEventsResponse"
+          description: review event stream opened
+          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
+              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
+        "403":
+          content:
+            application/problem+json:
+              examples:
+                AUTHORIZATION_DENIED:
+                  summary: AUTHORIZATION_DENIED
+                  value:
+                    code: AUTHORIZATION_DENIED
+                    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: 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
+      security:
+        - browserSession: []
+      summary: stream review state-change notifications
+      tags:
+        - organizations
+      x-gala-action-grant: none
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - NONE
+      x-gala-assurance-class: SESSION
+      x-gala-capability-key: publication.review
+      x-gala-concurrency: none
+      x-gala-conditional-capabilities: []
+      x-gala-conditional-capability-keys:
+        - capabilityKey: publication.view
+          condition: read-only
+      x-gala-example-profile: NOMINAL_SUCCESS_AND_EACH_REACHABLE_PROBLEM
+      x-gala-nullability: required-and-nullable-are-explicit
+      x-gala-purpose: stream review state-change notifications
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - 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: ORGANIZATION_AND_PUBLICATION_PATH
   /v2/organizations/{organizationId}/publications/{publicationId}/reviews/{reviewId}:
     get:
       operationId: getOrganizationsByOrganizationIdPublicationsByPublicationIdReviewsByReviewId

package/package.json

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