@rathnasgala2/schemas 3.23.0 → 3.24.0

package/THIRD_PARTY_LICENSES.json

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

package/docs/catalogs/app-routes.json

@@ -1803,7 +1803,8 @@
         "postOrganizationsByOrganizationIdPublicationsByPublicationIdRepositoryChangesByChangeIdDismiss",
         "postOrganizationsByOrganizationIdPublicationsByPublicationIdRepositorySetUp",
         "postOrganizationsByOrganizationIdPublicationsByPublicationIdReviews",
-        "postOrganizationsByOrganizationIdPublicationsByPublicationIdReviewsByReviewIdDecide"
+        "postOrganizationsByOrganizationIdPublicationsByPublicationIdReviewsByReviewIdDecide",
+        "postOrganizationsByOrganizationIdPublicationsByPublicationIdSitePublishUpdate"
       ],
       "componentIds": ["ValidationSummary"],
       "contentKeyIds": [
@@ -3409,5 +3410,5 @@
       ]
     }
   ],
-  "digest": "sha256:7a73811992f76729b79f218c6751fee909fd9a5641207299cf9e6cbbd23dd9dc"
+  "digest": "sha256:320fe24513084f6e5b9b899d365dd4d07b57ab1128806d6e9764373745a05e37"
 }

package/docs/catalogs/schema-inventory.json

@@ -229,9 +229,9 @@
       "version": "2.0.0",
       "path": "openapi/openapi.yaml",
       "materialized": true,
-      "sourceDigest": "sha256:a0c1baaa517f51014745dd3455da7376ff109de83a56d0bd76554a43900a9c45",
+      "sourceDigest": "sha256:84db429fb73a76449703c1e6e5b7cb28114966f245b5fd20a0a1f5e049a584f1",
       "typescriptRootType": null
     }
   ],
-  "digest": "sha256:1abecb4b6724cbb247b70590c10e74525e9c95612139f25f332a6c36be94e669"
+  "digest": "sha256:478d4200dd758fabe5cd1cd218b97e9712fc30bdb2013819c17d193a998251f5"
 }

package/openapi/http-catalog.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "2.0.0",
   "sourceDesignRevision": "a53052955ceb6c1aa10c886289dc832eedfe6de0a00004df07d353ac19c4403a",
-  "openApiDigest": "sha256:a0c1baaa517f51014745dd3455da7376ff109de83a56d0bd76554a43900a9c45",
+  "openApiDigest": "sha256:84db429fb73a76449703c1e6e5b7cb28114966f245b5fd20a0a1f5e049a584f1",
   "operations": [
     {
       "operationId": "getInternalHealth",
@@ -1827,6 +1827,19 @@
       "apiKeyScope": null,
       "sourceFragment": "organizations"
     },
+    {
+      "operationId": "postOrganizationsByOrganizationIdPublicationsByPublicationIdSitePublishUpdate",
+      "method": "POST",
+      "path": "/v2/organizations/{organizationId}/publications/{publicationId}/site:publish-update",
+      "purpose": "publish the repository head as the update to the live site",
+      "capabilityKey": "publication.publish",
+      "conditionalCapabilityKeys": [],
+      "activationGate": "MVP",
+      "assuranceClass": "RECENT_AUTHENTICATION",
+      "actionGrant": "none",
+      "apiKeyScope": null,
+      "sourceFragment": "organizations"
+    },
     {
       "operationId": "postOrganizationsByOrganizationIdPublicationsByPublicationIdTransfers",
       "method": "POST",
@@ -3193,5 +3206,5 @@
       "sourceFragment": "workloads"
     }
   ],
-  "digest": "sha256:c773ad19dc4c37f82a457753130560293ef54438d227c29149b1113a8c725c86"
+  "digest": "sha256:717a75c038a3380c6082a97d3c58f935187915c612228c35ae2fa64aaf5a1741"
 }

package/openapi/openapi.yaml

@@ -1210,6 +1210,22 @@ components:
         - createdAt
         - handledAt
       type: object
+    ContactMessageCounts:
+      additionalProperties: false
+      description: "SCHEMA-3.23.1: how many contact-form messages the site holds in each state, for every message of the site whatever the `state` filter of the list that carries it."
+      properties:
+        handled:
+          format: int64
+          minimum: 0
+          type: integer
+        new:
+          format: int64
+          minimum: 0
+          type: integer
+      required:
+        - new
+        - handled
+      type: object
     ContactMessageState:
       description: "SCHEMA-3.23.0: `new` until the site owner marks the message `handled`."
       enum:
@@ -3145,6 +3161,8 @@ components:
     GetOrganizationsByOrganizationIdPublicationsByPublicationIdContactMessagesResponse:
       additionalProperties: false
       properties:
+        counts:
+          $ref: "#/components/schemas/ContactMessageCounts"
         items:
           items:
             $ref: "#/components/schemas/ContactMessage"
@@ -3157,6 +3175,7 @@ components:
             - string
             - "null"
       required:
+        - counts
         - items
         - nextCursor
       type: object
@@ -4104,7 +4123,7 @@ components:
           then:
             required:
               - publishing
-      description: Everything a Home screen needs in one read. `url` is the live site address, `null` when nothing has been published. `lastPublished` is absent when `state` is `NEVER_PUBLISHED`. `publishing` is present exactly while `state` is `PUBLISHING`. `schedule` (SCHEMA-3.3.0, optional) is present while a scheduled publish is pending; a pending schedule never makes `state` `PUBLISHING` -- the site reads as it would without it until the schedule starts. `nextRelease` (SCHEMA-3.19.0, optional and nullable) is the scheduled draft that the staggered release will publish next, the one with the earliest `publishAfter` date; `null` or absent when there is none.
+      description: Everything a Home screen needs in one read. `url` is the live site address, `null` when nothing has been published. `lastPublished` is absent when `state` is `NEVER_PUBLISHED`. `publishing` is present exactly while `state` is `PUBLISHING`. `schedule` (SCHEMA-3.3.0, optional) is present while a scheduled publish is pending; a pending schedule never makes `state` `PUBLISHING` -- the site reads as it would without it until the schedule starts. `nextRelease` (SCHEMA-3.19.0, optional and nullable) is the scheduled draft that the staggered release will publish next, the one with the earliest `publishAfter` date; `null` or absent when there is none. `liveUpdate` (SCHEMA-3.24.0, required) says whether the live version has fallen behind the repository's default branch and what publishing the update would put live; see `SiteLiveUpdate` and `POST .../site:publish-update`.
       properties:
         attention:
           items:
@@ -4113,6 +4132,8 @@ components:
           type: array
         lastPublished:
           $ref: "#/components/schemas/SiteLastPublished"
+        liveUpdate:
+          $ref: "#/components/schemas/SiteLiveUpdate"
         nextRelease:
           oneOf:
             - $ref: "#/components/schemas/SiteNextRelease"
@@ -4146,6 +4167,7 @@ components:
         - state
         - pendingChanges
         - attention
+        - liveUpdate
       type: object
     GetOrganizationsByOrganizationIdPublicationsByPublicationIdTransfersByTransferIdResponse:
       allOf:
@@ -7327,7 +7349,7 @@ components:
       type: object
     NotificationTarget:
       additionalProperties: false
-      description: "SCHEMA-3.23.0: where a notification leads. `kind` names the kind of place in words a client may switch on and ignore when unknown (for example `comments`, `messages`, `publishing`, `audience`, `post`, `following`); `url` is an App route path (never an absolute address) that the row links to."
+      description: "`url` is an App route path, except for kind `site`, whose `url` is the absolute https address of a page on the published site (a post's live address, a comment's anchor on it). A client opens a `site` target as an external link."
       properties:
         kind:
           maxLength: 64
@@ -7337,7 +7359,7 @@ components:
         url:
           maxLength: 512
           minLength: 1
-          pattern: ^/(?!/)[^\s]*$
+          pattern: ^(?:/(?!/)[^\s]*|https://[^\s/?#]+[^\s]*)$
           type: string
       required:
         - kind
@@ -16648,6 +16670,21 @@ components:
         - statusUrl
         - reviewId
       type: object
+    PostOrganizationsByOrganizationIdPublicationsByPublicationIdSitePublishUpdateRequest:
+      additionalProperties: false
+      description: |
+        `headCommit` is the `liveUpdate.headCommit` the client read and the
+        person confirmed. The server publishes that head only while it is still
+        the repository's head.
+      properties:
+        headCommit:
+          $ref: "#/components/schemas/PortableDeploymentIntentGitObjectId"
+      required:
+        - headCommit
+      type: object
+    PostOrganizationsByOrganizationIdPublicationsByPublicationIdSitePublishUpdateResponse:
+      allOf:
+        - $ref: "#/components/schemas/PostOrganizationsByOrganizationIdPublicationsByPublicationIdPublishesResponse"
     PostOrganizationsByOrganizationIdPublicationsByPublicationIdTransfersByTransferIdCancelRequest:
       additionalProperties: false
       properties:
@@ -20444,6 +20481,85 @@ components:
         - at
         - actor
       type: object
+    SiteLiveUpdate:
+      additionalProperties: false
+      description: |
+        SCHEMA-3.24.0. Whether the live version has fallen behind the
+        repository's default branch, and what publishing the update would put
+        live. `state` is `CURRENT` when the live version is the head, `BEHIND`
+        when the head holds commits the live version lacks, and `UNKNOWN` when
+        nothing has been published yet, the site has no repository binding, or
+        GitHub could not be reached; a client shows nothing extra for `UNKNOWN`.
+        `servedCommit` is the source commit of the live version and
+        `headCommit` is the head the server compared it against, both `null`
+        when they are not known. A client sends `headCommit` back as the body of
+        `POST .../site:publish-update`. `waiting` counts the commits on the head
+        that are not in the live version. `unreviewed` is true when the site
+        requires review and `waiting.authorCommits` is above 0 or
+        `waiting.truncated` is true (a cut-short comparison cannot rule out such
+        commits): those commits never went through a Galascribe review, and a
+        person's press of the publish action counts as their approval. `restored` is true when the
+        live version is a restore of an older version rather than the newest
+        publish; publishing the update replaces it. `publishing` is true while a
+        publish of any kind is already in flight for the site, so a client shows
+        its progress instead of the action.
+      properties:
+        headCommit:
+          oneOf:
+            - $ref: "#/components/schemas/PortableDeploymentIntentGitObjectId"
+            - type: "null"
+        publishing:
+          type: boolean
+        restored:
+          type: boolean
+        servedCommit:
+          oneOf:
+            - $ref: "#/components/schemas/PortableDeploymentIntentGitObjectId"
+            - type: "null"
+        state:
+          enum:
+            - CURRENT
+            - BEHIND
+            - UNKNOWN
+          type: string
+        unreviewed:
+          type: boolean
+        waiting:
+          $ref: "#/components/schemas/SiteLiveUpdateWaiting"
+      required:
+        - state
+        - servedCommit
+        - headCommit
+        - waiting
+        - unreviewed
+        - restored
+        - publishing
+      type: object
+    SiteLiveUpdateWaiting:
+      additionalProperties: false
+      description: |
+        What the repository's default branch holds that the live version does
+        not: the commits on the head that are not in the live version, split by
+        who made them. `authorCommits` are commits a person made outside
+        Galascribe (a push, the GitHub web editor); `galascribeCommits` are
+        Galascribe's own system commits (set-up, Update now and toolchain
+        updates). Both are 0 when the state is `CURRENT` or `UNKNOWN`.
+        `truncated` is true when the comparison was cut short, in which case
+        the counts are lower bounds.
+      properties:
+        authorCommits:
+          minimum: 0
+          type: integer
+        galascribeCommits:
+          minimum: 0
+          type: integer
+        truncated:
+          type: boolean
+      required:
+        - authorCommits
+        - galascribeCommits
+        - truncated
+      type: object
     SiteNextRelease:
       additionalProperties: false
       description: "The next draft the staggered release will publish (SCHEMA-3.19.0): `slug` is the draft's slug and `publishAfter` its `YYYY-MM-DD` date, read in the publication's staggered-release timezone."
@@ -35697,7 +35813,7 @@ paths:
       x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
   /v2/organizations/{organizationId}/publications/{publicationId}/contact-messages:
     get:
-      description: Needs `publication.audience.read`. Newest first, one keyset page at a time; `state` keeps only `new` or only `handled` messages (all when absent).
+      description: Needs `publication.audience.read`. `counts` covers every message of the site whatever the `state` filter; `items` are the messages of the filtered state (all states when absent), newest first, one keyset page at a time.
       operationId: getOrganizationsByOrganizationIdPublicationsByPublicationIdContactMessages
       parameters:
         - $ref: "#/components/parameters/XCorrelationId"
@@ -35732,6 +35848,9 @@ paths:
                 nominal:
                   summary: Nominal successful response
                   value:
+                    counts:
+                      handled: 0
+                      new: 1
                     items:
                       - createdAt: "2026-10-27T12:00:00.000Z"
                         email: reader@example.com
@@ -53687,7 +53806,9 @@ paths:
       description: |
         The one read behind a Home screen: the live address, whether the site is live, publishing or has never been published, who published last, the unpublished changes in words, and what needs attention.
 
-        `pendingChanges` holds exactly one entry per path (and one for the look): the newest unpublished change for a path wins, older ones are superseded and omitted. `review` is `NOT_REQUIRED` unless the publication's `publishingPolicy.requireReview` is true. `attention[].code` is a closed vocabulary; `relatedChangeId` names the change that needs the action. `publishing.stage` follows `QUEUED`, `PREPARING`, `BUILDING`, `GOING_LIVE`, `CHECKING_LIVE`; `publishing.runUrl` links the GitHub run and `publishing.stageSince` says when the stage began. Read from the platform's own records; nothing is read from the person's repository.
+        `pendingChanges` holds exactly one entry per path (and one for the look): the newest unpublished change for a path wins, older ones are superseded and omitted. `review` is `NOT_REQUIRED` unless the publication's `publishingPolicy.requireReview` is true. `attention[].code` is a closed vocabulary; `relatedChangeId` names the change that needs the action. `publishing.stage` follows `QUEUED`, `PREPARING`, `BUILDING`, `GOING_LIVE`, `CHECKING_LIVE`; `publishing.runUrl` links the GitHub run and `publishing.stageSince` says when the stage began. Read from the platform's own records, except `liveUpdate`.
+
+        `liveUpdate` (SCHEMA-3.24.0) says whether the live version has fallen behind the repository's default branch, which is what should be live. `state` is `CURRENT`, `BEHIND` or `UNKNOWN` (never published, no repository binding, or GitHub could not be reached; a client shows nothing extra for `UNKNOWN`, and the rest of the read is unaffected). `servedCommit` is the source commit of the live version; `headCommit` is the head the server compared it against, read from GitHub and possibly a short-lived cached read; a client sends `headCommit` back to `POST .../site:publish-update`. `waiting` counts the commits on the head that are not in the live version, split into `authorCommits` (made outside Galascribe) and `galascribeCommits` (Galascribe's own system commits), with `truncated` true when the comparison was cut short. `unreviewed` is true when the site requires review and `waiting.authorCommits` is above 0 or `waiting.truncated` is true. `restored` is true when the live version is a restore of an older version rather than the newest publish. `publishing` is true while a publish of any kind is in flight for the site.
       operationId: getOrganizationsByOrganizationIdPublicationsByPublicationIdSite
       parameters:
         - $ref: "#/components/parameters/XCorrelationId"
@@ -53722,6 +53843,17 @@ paths:
                       actor:
                         displayName: Asha Rao
                       at: "2026-10-05T09:30:00Z"
+                    liveUpdate:
+                      headCommit: sha1:2222222222222222222222222222222222222222
+                      publishing: false
+                      restored: false
+                      servedCommit: sha1:1111111111111111111111111111111111111111
+                      state: BEHIND
+                      unreviewed: true
+                      waiting:
+                        authorCommits: 2
+                        galascribeCommits: 1
+                        truncated: false
                     pendingChanges:
                       - action: EDIT
                         author:
@@ -53899,6 +54031,420 @@ paths:
         - NONE
       x-gala-success-category: query
       x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
+  /v2/organizations/{organizationId}/publications/{publicationId}/site:publish-update:
+    post:
+      description: |
+        Publishes the repository's current default-branch head when the live version is behind it ("Publish the update"): the commits made outside Galascribe by a push or the GitHub web editor, Galascribe's own system commits that were held back, and the head after a failed publish. The body names the `headCommit` the client read from the site read's `liveUpdate`. Success is `202` with the accepted operation (kind `publish`; `publishId` names it, and the operation's `subject.generationId` names the generation once it exists), the same shape as `changes:publish`. No change is named and nothing is merged: the head is built as it stands. A post dated for later is a draft with `publishAfter` and a production build leaves drafts out, so publishing the update never releases one early.
+
+        The person pressing the action is the approval. When the publication's `publishingPolicy.requireReview` is true and `liveUpdate.unreviewed` is true, the commits counted in `liveUpdate.waiting.authorCommits` never went through a Galascribe review; a person's press of this action counts as approval of those commits, so no `REVIEW_REQUIRED` refusal applies here and the press is recorded against the person. A client shows what will go live and says so before it asks. The same press replaces a restored version: when `liveUpdate.restored` is true the live version is a restore of an older version (a rollback), and publishing the update puts the head live in its place. The automatic paths (self-heal and the set-up republish) never move a restored site; only this action does. After a publish that gave up or is backing off, a press starts a fresh attempt.
+
+        The person needs `publication.publish` and a recent authentication: a stale session gets `401 REAUTH_REQUIRED` and the client confirms the person again and resumes. `Idempotency-Key` is required; a replay with the same key and body returns the first result, the same key with a different body is `409 COMMAND_REPLAY_CONFLICT`. The server checks, in this order and with nothing written on a refusal: `409 HEAD_MOVED` when the repository head is no longer `headCommit` (the client reads the site again and asks again with the new head); `409 ALREADY_LIVE` when the live version is already that head; `409 PUBLISH_IN_PROGRESS` while a publish of any kind is in flight for the site; `409 NOT_SET_UP` when the repository has not been set up for the current Galascribe toolchain, and Update now (`POST .../repository:set-up`) comes first. This operation is not callable with an admin API key.
+      operationId: postOrganizationsByOrganizationIdPublicationsByPublicationIdSitePublishUpdate
+      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
+        - $ref: "#/components/parameters/IdempotencyKey"
+        - $ref: "#/components/parameters/XCsrfToken"
+      requestBody:
+        content:
+          application/json:
+            examples:
+              nominal:
+                summary: Nominal valid request
+                value:
+                  headCommit: sha1:2222222222222222222222222222222222222222
+            schema:
+              $ref: "#/components/schemas/PostOrganizationsByOrganizationIdPublicationsByPublicationIdSitePublishUpdateRequest"
+        required: true
+      responses:
+        "202":
+          content:
+            application/json:
+              examples:
+                nominal:
+                  summary: Nominal successful response
+                  value:
+                    commandId: 018f0000-0000-7000-8000-000000000001
+                    operationId: 018f0000-0000-7000-8000-000000000001
+                    phase: accepted
+                    publishId: 018f0000-0000-7000-8000-000000000003
+                    resourceVersion: 0
+                    statusUrl: /v2/organizations/018f0000-0000-7000-8000-000000000001/operations/018f0000-0000-7000-8000-000000000002
+              schema:
+                $ref: "#/components/schemas/PostOrganizationsByOrganizationIdPublicationsByPublicationIdSitePublishUpdateResponse"
+          description: publish the repository's current head as the update to the live site 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
+                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: 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
+        "409":
+          content:
+            application/problem+json:
+              examples:
+                ALREADY_LIVE:
+                  summary: ALREADY_LIVE
+                  value:
+                    code: ALREADY_LIVE
+                    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: ALREADY_LIVE
+                    type: urn:gala:problem:already-live
+                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
+                HEAD_MOVED:
+                  summary: HEAD_MOVED
+                  value:
+                    code: HEAD_MOVED
+                    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: HEAD_MOVED
+                    type: urn:gala:problem:head-moved
+                NOT_SET_UP:
+                  summary: NOT_SET_UP
+                  value:
+                    code: NOT_SET_UP
+                    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: NOT_SET_UP
+                    type: urn:gala:problem:not-set-up
+                PUBLISH_IN_PROGRESS:
+                  summary: PUBLISH_IN_PROGRESS
+                  value:
+                    code: PUBLISH_IN_PROGRESS
+                    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: PUBLISH_IN_PROGRESS
+                    type: urn:gala:problem:publish-in-progress
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: ALREADY_LIVE, COMMAND_REPLAY_CONFLICT, HEAD_MOVED, NOT_SET_UP, PUBLISH_IN_PROGRESS
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - ALREADY_LIVE
+            - COMMAND_REPLAY_CONFLICT
+            - HEAD_MOVED
+            - NOT_SET_UP
+            - PUBLISH_IN_PROGRESS
+        "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
+        "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: publish the repository head as the update to the live site
+      tags:
+        - organizations
+      x-gala-action-grant: none
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - Active binding epoch, admitted author-source contract, admitted destination, and no transfer or retirement fence
+      x-gala-assurance-class: RECENT_AUTHENTICATION
+      x-gala-capability-key: publication.publish
+      x-gala-concurrency: publication-and-destination-epochs
+      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: publish the repository head as the update to the live site
+      x-gala-reachable-problems:
+        - ALREADY_LIVE
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - CAPABILITY_UNAVAILABLE
+        - COMMAND_REPLAY_CONFLICT
+        - DEPENDENCY_UNAVAILABLE
+        - HEAD_MOVED
+        - NOT_SET_UP
+        - PUBLISH_IN_PROGRESS
+        - RATE_LIMITED
+        - REAUTH_REQUIRED
+        - REQUEST_FIELD_UNKNOWN
+        - RESOURCE_NOT_FOUND
+        - VALIDATION_FAILED
+      x-gala-replay-identity: idempotency-key
+      x-gala-state-guards:
+        - NONE
+      x-gala-success-category: async
+      x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
   /v2/organizations/{organizationId}/publications/{publicationId}/transfers:
     post:
       description: |
@@ -67249,8 +67795,21 @@ paths:
                           kind: comments
                           url: /sites/018f0000-0000-7000-8000-000000000001/018f0000-0000-7000-8000-000000000001/comments
                         title: New comment on Hello world
+                      - category: following
+                        createdAt: "2026-10-27T12:00:00.000Z"
+                        excerpt: null
+                        id: 018f0000-0000-7000-8000-000000000002
+                        kind: following-post
+                        publication:
+                          id: 018f0000-0000-7000-8000-000000000001
+                          title: Example Blog
+                        readAt: null
+                        target:
+                          kind: site
+                          url: https://blog.example.com/hello-world/
+                        title: New post - Hello world
                     nextCursor: null
-                    unreadCount: 1
+                    unreadCount: 2
               schema:
                 $ref: "#/components/schemas/GetSelfNotificationsResponse"
           description: list the signed-in person's notifications succeeded

package/package.json

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