@rathnasgala2/schemas 3.11.0 → 3.12.0

package/generated/typescript/contracts/build-input.d.ts

@@ -146,6 +146,7 @@ export type BuildInputContentFrontmatterNormalized = Readonly<{
   readonly publishedAt: BuildInputRfc3339;
   readonly redirects: ReadonlyArray<BuildInputCanonicalRoute>;
   readonly route?: BuildInputCanonicalRoute;
+  readonly seo?: BuildInputContentSeo;
   readonly series?: BuildInputPlainLabel;
   readonly seriesOrder?: number;
   readonly slug: BuildInputSlug;
@@ -157,6 +158,13 @@ export type BuildInputContentFrontmatterNormalized = Readonly<{
 }> &
   unknown;
 
+export type BuildInputContentSeo = Readonly<{
+  readonly canonicalUrl?: BuildInputUrlHttps;
+  readonly description?: BuildInputPlainText;
+  readonly noindex?: boolean;
+  readonly title?: BuildInputPlainText;
+}>;
+
 export type BuildInputDestinationCapabilityProfile = Readonly<{
   readonly adapter: BuildInputAuthoredAdapterIdentity;
   readonly baseUrl: BuildInputUrlHttps;

package/generated/typescript/contracts/content-frontmatter.d.ts

@@ -17,6 +17,13 @@ export type ContentFrontmatterContentEdition = Readonly<{
   readonly sourceDigest: ContentFrontmatterDigest;
 }>;
 
+export type ContentFrontmatterContentSeo = Readonly<{
+  readonly canonicalUrl?: ContentFrontmatterUrlHttps;
+  readonly description?: ContentFrontmatterPlainText;
+  readonly noindex?: boolean;
+  readonly title?: ContentFrontmatterPlainText;
+}>;
+
 export type ContentFrontmatterDigest = string;
 
 export type ContentFrontmatterExtensionKey = string;
@@ -78,6 +85,7 @@ export type ContentFrontmatterDocument = Readonly<{
   readonly route?: ContentFrontmatterCanonicalRoute;
   readonly schemaId: 'urn:gala:schema:content-frontmatter:2.0.0';
   readonly schemaVersion: '2.0.0';
+  readonly seo?: ContentFrontmatterContentSeo;
   readonly series?: ContentFrontmatterPlainLabel;
   readonly seriesOrder?: number;
   readonly slug: ContentFrontmatterSlug;

package/openapi/http-catalog.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "2.0.0",
   "sourceDesignRevision": "a53052955ceb6c1aa10c886289dc832eedfe6de0a00004df07d353ac19c4403a",
-  "openApiDigest": "sha256:b5ab8902d0a3d6990cd2c4bcdc51e6f007ceb33d65119fc2f5e526c0a2260bb1",
+  "openApiDigest": "sha256:ced018280539ba1489140480f22f9d4d559bfffc0fc383979d96ce6bdbd511db",
   "operations": [
     {
       "operationId": "getInternalHealth",
@@ -2157,5 +2157,5 @@
       "sourceFragment": "workloads"
     }
   ],
-  "digest": "sha256:e0e3e201cb7a5b7004e158e7bc48261f82817929bdadfde6d4aa0373e9174ecd"
+  "digest": "sha256:abdb9d0b55df0c670b75a6bb175ef2cf8bd0b6566ceffb54e2683037072ee0ea"
 }

package/openapi/openapi.yaml

@@ -1081,9 +1081,20 @@ components:
         optional: the author's publication palette, written as
         `gala/appearance.json`'s `tokens`; when absent the file's `tokens`
         are preserved unchanged, and `{}` resets to the theme's own colours.
+        `brandMark` (SCHEMA-3.12.0) is optional: a repository-relative path
+        under `assets/brand/`, written as `gala/appearance.json`'s
+        `brandMark` (the site icon); `null` clears it and an absent member
+        preserves the file's value. The App uploads the image file as an
+        ordinary `assets[]` entry in the same plan.
       properties:
         attribution:
           $ref: "#/components/schemas/PortableAppearanceAttribution"
+        brandMark:
+          oneOf:
+            - allOf:
+                - $ref: "#/components/schemas/PortableAppearanceRepoRelativePath"
+                - pattern: ^assets/brand/
+            - type: "null"
         colorModeDefault:
           $ref: "#/components/schemas/AppearanceColorMode"
         themeId:
@@ -1208,6 +1219,55 @@ components:
         - path
         - action
       type: object
+    ContentChangePublicationProfileEntry:
+      additionalProperties: false
+      description: |
+        SCHEMA-3.12.0: site-level settings inside a batch
+        `content-changes:plan` request, the same lifecycle and capability as
+        `appearance` (a pending change that goes live on Publish). The
+        server loads `gala/publication.json` at `baseRevision`, applies the
+        members that are present, validates the result against
+        `publication.schema.json`, and plans one `PUT` of
+        `gala/publication.json`. An absent member is preserved. `null`
+        resets `description` to the publication title (the file requires a
+        description); `null` clears `defaultImageRef` and `crawlers`.
+        `title`, `defaultLanguage` and `socialLinks` cannot be cleared.
+        `socialLinks` (max 32, the publication file's own limit) replaces
+        the whole list. `canonicalBase` is never client-settable: it changes
+        only through domain attach and detach. A profile that changes nothing is
+        `422 VALIDATION_FAILED` pointed at `/publicationProfile`; member
+        failures point at `/publicationProfile/<member>`.
+      properties:
+        crawlers:
+          oneOf:
+            - $ref: "#/components/schemas/PortablePublicationCrawlers"
+            - type: "null"
+        defaultImageRef:
+          oneOf:
+            - allOf:
+                - $ref: "#/components/schemas/PortablePublicationRepoRelativePath"
+                - pattern: ^assets/brand/
+            - type: "null"
+        defaultLanguage:
+          $ref: "#/components/schemas/PortablePublicationBcp47"
+        description:
+          oneOf:
+            - $ref: "#/components/schemas/PortablePublicationPlainText"
+              x-gala-graphemeLength:
+                maximum: 300
+                minimum: 1
+            - type: "null"
+        socialLinks:
+          items:
+            $ref: "#/components/schemas/PortablePublicationSocialLink"
+          maxItems: 32
+          type: array
+        title:
+          $ref: "#/components/schemas/PortablePublicationPlainText"
+          x-gala-graphemeLength:
+            maximum: 120
+            minimum: 1
+      type: object
     ContentFrontmatter:
       $ref: "#/components/schemas/PortableContentFrontmatterDocument"
     ContentInventoryItem:
@@ -1345,14 +1405,36 @@ components:
             $ref: "#/components/schemas/ContentPublicationAuthorSummary"
           maxItems: 200
           type: array
+        crawlers:
+          $ref: "#/components/schemas/PortablePublicationCrawlers"
+        defaultImageRef:
+          $ref: "#/components/schemas/PortablePublicationRepoRelativePath"
         defaultLanguage:
           $ref: "#/components/schemas/PortablePublicationBcp47"
+        description:
+          $ref: "#/components/schemas/PortablePublicationPlainText"
+          x-gala-graphemeLength:
+            maximum: 500
+            minimum: 1
+        socialLinks:
+          items:
+            $ref: "#/components/schemas/PortablePublicationSocialLink"
+          maxItems: 32
+          type: array
         theme:
           $ref: "#/components/schemas/PortableAppearancePackageRange"
+        title:
+          $ref: "#/components/schemas/PortablePublicationPlainText"
+          x-gala-graphemeLength:
+            maximum: 200
+            minimum: 1
       required:
         - defaultLanguage
         - theme
         - authors
+        - title
+        - description
+        - socialLinks
       type: object
     DefaultBranchUpdateState:
       description: |
@@ -7070,6 +7152,15 @@ components:
       minLength: 3
       pattern: ^(?:@[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?/[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?|[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?)@(?:\S+|\S+ \S+)$
       type: string
+    PortableAppearanceRepoRelativePath:
+      description: NFC UTF-8 repository-relative path using slash separators, with no leading slash, dot segment, NUL, backslash, or percent-decoded traversal.
+      format: gala-repository-relative-path
+      maxLength: 512
+      minLength: 1
+      pattern: ^(?!/)(?!.*\\)(?!.*\u0000).+$
+      type: string
+      x-gala-utf8ByteLength:
+        maximum: 512
     PortableAppearanceSemanticTokens:
       additionalProperties: false
       description: "SCHEMA-3.10.0: the author's publication palette. Each role (accent, canvas, text) is optional; when present it carries both light and dark as opaque lowercase #rrggbb. An absent role uses the theme's default; `{}` selects the theme's default palette entirely."
@@ -7172,6 +7263,26 @@ components:
         - generation
         - approvedAt
       type: object
+    PortableContentFrontmatterContentSeo:
+      additionalProperties: false
+      description: "SCHEMA-3.12.0: optional search overrides for one document. `title` replaces the page title in search results (the site suffix is still appended on non-home pages), `description` replaces the search description, `canonicalUrl` is an absolute HTTPS canonical for syndicated or moved content, and `noindex: true` keeps a listed document out of search engines. Every member is optional; absent members fall back to the document's own title and description."
+      properties:
+        canonicalUrl:
+          $ref: "#/components/schemas/PortableContentFrontmatterUrlHttps"
+        description:
+          $ref: "#/components/schemas/PortableContentFrontmatterPlainText"
+          x-gala-graphemeLength:
+            maximum: 300
+            minimum: 1
+        noindex:
+          type: boolean
+        title:
+          $ref: "#/components/schemas/PortableContentFrontmatterPlainText"
+          x-gala-graphemeLength:
+            maximum: 70
+            minimum: 1
+      required: []
+      type: object
     PortableContentFrontmatterDigest:
       pattern: ^sha256:[0-9a-f]{64}$
       type: string
@@ -7268,6 +7379,8 @@ components:
           pattern: ^2\.0\.0$
           type: string
           x-gala-const: 2.0.0
+        seo:
+          $ref: "#/components/schemas/PortableContentFrontmatterContentSeo"
         series:
           $ref: "#/components/schemas/PortableContentFrontmatterPlainLabel"
         seriesOrder:
@@ -7398,6 +7511,11 @@ components:
       description: Lowercase canonical UUIDv7. Once published, it is immutable; its time ordering conveys neither chronology nor authority.
       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
+    PortableContentFrontmatterUrlHttps:
+      description: Absolute HTTPS URL without embedded credentials.
+      format: uri
+      pattern: ^https://(?![^/?#]*@)
+      type: string
     PortableDeploymentIntentAdapterIdentity:
       additionalProperties: false
       properties:
@@ -12953,6 +13071,84 @@ components:
       x-gala-utf8ByteLength:
         maximum: 255
         minimum: 1
+    PortablePublicationCrawlers:
+      additionalProperties: false
+      properties:
+        ai:
+          enum:
+            - allow
+            - block
+      required:
+        - ai
+      type: object
+    PortablePublicationPlainLabel:
+      description: Normalized Unicode plain text without markup, controls, or bidi overrides.
+      format: gala-plain-label
+      type: string
+      x-gala-graphemeLength:
+        maximum: 80
+        minimum: 1
+    PortablePublicationPlainText:
+      description: NFC Unicode text without disallowed C0/C1 controls or bidi override/isolate controls.
+      format: gala-plain-text
+      type: string
+    PortablePublicationRepoRelativePath:
+      description: NFC UTF-8 repository-relative path using slash separators, with no leading slash, dot segment, NUL, backslash, or percent-decoded traversal.
+      format: gala-repository-relative-path
+      maxLength: 512
+      minLength: 1
+      pattern: ^(?!/)(?!.*\\)(?!.*\u0000).+$
+      type: string
+      x-gala-utf8ByteLength:
+        maximum: 512
+    PortablePublicationSocialLink:
+      additionalProperties: false
+      allOf:
+        - else:
+            properties:
+              uri:
+                $ref: "#/components/schemas/PortablePublicationUrlHttps"
+          if:
+            properties:
+              type:
+                pattern: ^email$
+                type: string
+                x-gala-const: email
+            required:
+              - type
+          then:
+            properties:
+              uri:
+                format: uri
+                pattern: "^mailto:"
+                type: string
+      properties:
+        label:
+          $ref: "#/components/schemas/PortablePublicationPlainLabel"
+        type:
+          enum:
+            - website
+            - email
+            - github
+            - linkedin
+            - mastodon
+            - bluesky
+            - x
+            - youtube
+            - other
+        uri:
+          maxLength: 2048
+          minLength: 1
+          type: string
+      required:
+        - type
+        - uri
+      type: object
+    PortablePublicationUrlHttps:
+      description: Absolute HTTPS URL without embedded credentials.
+      format: uri
+      pattern: ^https://(?![^/?#]*@)
+      type: string
     PostAuthenticationGithubTransactionsRequest:
       additionalProperties: false
       properties:
@@ -13731,13 +13927,15 @@ components:
         Two request shapes, both accepted. The 2.13.0 single-document shape
         (`path`, `contentDigest`, `expectedHead`) plans one document write
         against the exact expected head. The additive batch shape
-        (`baseRevision` and at least one of `documents`/`assets`/`appearance`)
+        (`baseRevision` and at least one of `documents`/`assets`/`appearance`/
+        `publicationProfile`)
         plans up to 20 documents and 20 assets -- each `PUT` with its own
         text or bytes and digest, each `DELETE` naming only its path -- and
         optionally one theme selection in one change, against the exact
         expected main-branch head asserted as `baseRevision`. A request
         mixing the two shapes, or a batch request naming none of
-        `documents`, `assets` and `appearance`, is `422 VALIDATION_FAILED`.
+        `documents`, `assets`, `appearance` and `publicationProfile`, is
+        `422 VALIDATION_FAILED`.
         `appearance` names a catalog theme and a default colour mode, and
         optionally the footer `attribution` (SCHEMA-3.3.0); the server
         writes `gala/appearance.json` (only `theme`, `colorMode.default` and,
@@ -13747,6 +13945,10 @@ components:
         selection (theme, default colour mode and, when sent, attribution)
         is `422 VALIDATION_FAILED` pointed at `/appearance`. Document paths
         under `gala/` and `gala.lock.json` remain forbidden.
+        `publicationProfile` (SCHEMA-3.12.0) is a further batch member beside
+        `appearance`, counting as one of the named members: it edits
+        `gala/publication.json` through one planned `PUT` (see
+        `ContentChangePublicationProfileEntry`).
         Assets are images only (PNG, JPEG, WebP, GIF, AVIF; SVG is refused):
         at most 20 per change, each at most 5 MiB and together at most
         20 MiB, measured on the decoded bytes -- `assets[].bytesBase64` is
@@ -13779,6 +13981,8 @@ components:
           maxLength: 512
           minLength: 1
           type: string
+        publicationProfile:
+          $ref: "#/components/schemas/ContentChangePublicationProfileEntry"
       required: []
       type: object
     PostOrganizationsByOrganizationIdPublicationsByPublicationIdContentChangesPlanResponse:
@@ -14606,7 +14810,16 @@ components:
         - $ref: "#/components/schemas/PublicationTransfer"
     PostOrganizationsByOrganizationIdPublicationsRequest:
       additionalProperties: false
+      description: |
+        `description` (SCHEMA-3.12.0) is the optional site tagline, written
+        as `gala/publication.json`'s `description`. When absent the server
+        keeps its fallback (the site name).
       properties:
+        description:
+          $ref: "#/components/schemas/PortablePublicationPlainText"
+          x-gala-graphemeLength:
+            maximum: 300
+            minimum: 1
         name:
           maxLength: 80
           minLength: 1
@@ -15812,10 +16025,19 @@ components:
         (SCHEMA-3.3.0, optional) is the file's footer attribution switch;
         absent means the file has none, which renders as shown. `tokens`
         (SCHEMA-3.10.0, optional) is the file's publication palette as read;
-        absent or `{}` means the theme's own colours.
+        absent or `{}` means the theme's own colours. `brandMark`
+        (SCHEMA-3.12.0, optional): the publication's brand mark as currently
+        committed, absent when none.
       properties:
         attribution:
           $ref: "#/components/schemas/PortableAppearanceAttribution"
+        brandMark:
+          description: "SCHEMA-3.12.0: the publication's brand mark as currently committed, absent when none"
+          oneOf:
+            - allOf:
+                - $ref: "#/components/schemas/PortableAppearanceRepoRelativePath"
+                - pattern: ^assets/brand/
+            - type: "null"
         colorModeDefault:
           $ref: "#/components/schemas/AppearanceColorMode"
         themeId:
@@ -30308,7 +30530,10 @@ paths:
                         - displayName: Example Author
                           id: 018f0000-0000-7000-8000-000000000001
                       defaultLanguage: en
+                      description: Example tagline
+                      socialLinks: []
                       theme: "@rathnasgala2/theme-default@^4.0.0"
+                      title: Example
                     setUp: true
               schema:
                 $ref: "#/components/schemas/GetOrganizationsByOrganizationIdPublicationsByPublicationIdContentResponse"

package/package.json

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

package/schemas/build-input.schema.json

@@ -867,7 +867,8 @@
           "maxItems": 32,
           "uniqueItems": true
         },
-        "edition": { "$ref": "#/$defs/contentEdition" }
+        "edition": { "$ref": "#/$defs/contentEdition" },
+        "seo": { "$ref": "#/$defs/contentSeo" }
       },
       "additionalProperties": false,
       "dependentRequired": { "seriesOrder": ["series"] },
@@ -905,6 +906,24 @@
       "additionalProperties": false,
       "description": "Prism edition of the article whose slug is `of`. `sourceDigest` is the digest of that article body the edition was generated from; an edition whose `sourceDigest` differs from the current article body digest is stale and is not rendered."
     },
+    "contentSeo": {
+      "type": "object",
+      "required": [],
+      "properties": {
+        "title": {
+          "$ref": "#/$defs/plainText",
+          "x-gala-graphemeLength": { "minimum": 1, "maximum": 70 }
+        },
+        "description": {
+          "$ref": "#/$defs/plainText",
+          "x-gala-graphemeLength": { "minimum": 1, "maximum": 300 }
+        },
+        "canonicalUrl": { "$ref": "#/$defs/urlHttps" },
+        "noindex": { "type": "boolean" }
+      },
+      "additionalProperties": false,
+      "description": "SCHEMA-3.12.0: optional search overrides for one document. `title` replaces the page title in search results (the site suffix is still appended on non-home pages), `description` replaces the search description, `canonicalUrl` is an absolute HTTPS canonical for syndicated or moved content, and `noindex: true` keeps a listed document out of search engines. Every member is optional; absent members fall back to the document's own title and description."
+    },
     "contentBuildMediaFile": {
       "type": "object",
       "required": ["path", "sourceDigest", "mediaType", "byteLength"],

package/schemas/content-frontmatter.schema.json

@@ -64,6 +64,7 @@
     },
     "newsletter": { "enum": ["ineligible", "eligible"] },
     "edition": { "$ref": "#/$defs/contentEdition" },
+    "seo": { "$ref": "#/$defs/contentSeo" },
     "extensions": { "$ref": "#/$defs/extensionMap" }
   },
   "additionalProperties": false,
@@ -233,6 +234,24 @@
       "additionalProperties": false,
       "description": "Prism edition of the article whose slug is `of`. `sourceDigest` is the digest of that article body the edition was generated from; an edition whose `sourceDigest` differs from the current article body digest is stale and is not rendered."
     },
+    "contentSeo": {
+      "type": "object",
+      "required": [],
+      "properties": {
+        "title": {
+          "$ref": "#/$defs/plainText",
+          "x-gala-graphemeLength": { "minimum": 1, "maximum": 70 }
+        },
+        "description": {
+          "$ref": "#/$defs/plainText",
+          "x-gala-graphemeLength": { "minimum": 1, "maximum": 300 }
+        },
+        "canonicalUrl": { "$ref": "#/$defs/urlHttps" },
+        "noindex": { "type": "boolean" }
+      },
+      "additionalProperties": false,
+      "description": "SCHEMA-3.12.0: optional search overrides for one document. `title` replaces the page title in search results (the site suffix is still appended on non-home pages), `description` replaces the search description, `canonicalUrl` is an absolute HTTPS canonical for syndicated or moved content, and `noindex: true` keeps a listed document out of search engines. Every member is optional; absent members fall back to the document's own title and description."
+    },
     "extensionMap": {
       "type": "object",
       "maxProperties": 32,