@getvitops/generator 8.1.0 → 8.2.0

package/config.schema.json

@@ -7,6 +7,11 @@
       "description": "URL of the published config JSON Schema (stamped by `vitops init --site`) so editors provide autocomplete + validation.",
       "type": "string"
     },
+    "configVersion": {
+      "description": "The config shape version (see `CONFIG_VERSION`) — absent reads as version 1, which is every config validated by this schema so far.",
+      "type": "number",
+      "const": 1
+    },
     "designSystem": {
       "type": "object",
       "properties": {
@@ -456,13 +461,9 @@
                         "type": "string"
                       },
                       "additionalProperties": {
-                        "anyOf": [
-                          {
-                            "type": "string"
-                          },
-                          {
-                            "type": "number"
-                          }
+                        "type": [
+                          "string",
+                          "number"
                         ]
                       },
                       "description": "A bag of CSS-ish keys, each mapped to a declaration plus a `--<role>-<sfx>` override hook. The recognised set is **closed**: `family`, `size`, `weight`, `style`, `line-height`, `tracking` (→ `letter-spacing`), `text-transform`, `text-decoration`, `text-wrap`, `color`. Note the last four are spelled with their full CSS property names — `transform` and `decoration` are NOT accepted. Anything unrecognised is **ignored**, not passed through, so the generator warns rather than emitting it: a silently-dropped `transform: uppercase` is how title-case navigation reaches production. Note also that `style`, `text-transform`, `text-decoration` and `text-wrap` are emitted on **every** role at their identity value (`normal`/`none`/`none`/`wrap`) whether declared or not, so applying one role class over another fully resets it — which means **omitting `text-wrap` is not \"inherit\"**: it emits `text-wrap: wrap` and cancels the `pretty` the role would otherwise inherit from a `pretty` ancestor such as a `body`-mapped role. Declare it on every role — `balance` for heading-like roles, `pretty` for copy, `wrap` for short single-line labels."
@@ -504,13 +505,9 @@
                             "type": "string"
                           },
                           "additionalProperties": {
-                            "anyOf": [
-                              {
-                                "type": "string"
-                              },
-                              {
-                                "type": "number"
-                              }
+                            "type": [
+                              "string",
+                              "number"
                             ]
                           },
                           "description": "Extra literal declarations merged into the effect class as-is."
@@ -521,13 +518,9 @@
                             "type": "string"
                           },
                           "additionalProperties": {
-                            "anyOf": [
-                              {
-                                "type": "string"
-                              },
-                              {
-                                "type": "number"
-                              }
+                            "type": [
+                              "string",
+                              "number"
                             ]
                           },
                           "description": "Effect endpoint variables (`--<key>: <value>`, e.g. opacity-from, translate-y-to) that override the keyframe defaults."
@@ -556,13 +549,9 @@
                             "type": "string"
                           },
                           "additionalProperties": {
-                            "anyOf": [
-                              {
-                                "type": "string"
-                              },
-                              {
-                                "type": "number"
-                              }
+                            "type": [
+                              "string",
+                              "number"
                             ]
                           }
                         }
@@ -694,7 +683,7 @@
           "description": "General contact address. Also the last fallback for privacy requests — see `contact`.",
           "type": "string",
           "format": "email",
-          "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
+          "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
         },
         "phone": {
           "description": "General contact telephone number.",
@@ -761,7 +750,7 @@
                 "email": {
                   "type": "string",
                   "format": "email",
-                  "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
+                  "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
                 },
                 "phone": {
                   "type": "string"
@@ -851,7 +840,7 @@
               "email": {
                 "type": "string",
                 "format": "email",
-                "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
+                "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
               },
               "phone": {
                 "type": "string"
@@ -1178,13 +1167,9 @@
                       "description": "A string, or a per-locale map of strings (`{ en: \"…\", fr: \"…\" }`)."
                     },
                     "price": {
-                      "anyOf": [
-                        {
-                          "type": "string"
-                        },
-                        {
-                          "type": "number"
-                        }
+                      "type": [
+                        "string",
+                        "number"
                       ]
                     },
                     "priceCurrency": {
@@ -1450,14 +1435,14 @@
                 "items": {
                   "type": "string",
                   "format": "email",
-                  "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
+                  "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
                 }
               },
               "fullUserGroup": {
                 "description": "A Google Group to grant Full-User access in Search Console. SURFACED AS A REMINDER only: Search Console exposes no user/permission API, so this step stays manual by design.",
                 "type": "string",
                 "format": "email",
-                "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
+                "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
               }
             },
             "additionalProperties": false
@@ -1505,6 +1490,27 @@
           },
           "description": "Deploy environments (production, dev, …): URL, API origin, analytics toggle, robots policy, active A/B variant."
         },
+        "plan": {
+          "description": "Commercial plan/add-on entitlement, gating which capability fields below may be turned on. Absence means unrestricted.",
+          "type": "object",
+          "properties": {
+            "key": {
+              "type": "string",
+              "description": "Commercial plan identifier (e.g. \"essentials\", \"growth\") — open string, not a closed enum."
+            },
+            "addons": {
+              "description": "Add-on keys this site is entitled to (e.g. \"ab_testing\", \"server_side_tracking\") — checked against PLAN_CAPABILITIES.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "required": [
+            "key"
+          ],
+          "additionalProperties": false
+        },
         "abTesting": {
           "description": "A/B testing: cookie-based split plus named variants whose `overrides` patch the config per environment.",
           "type": "object",
@@ -1562,6 +1568,65 @@
           ],
           "additionalProperties": false
         },
+        "experiments": {
+          "description": "Runtime, per-visitor content experiments — one config-schema-free page branches on a cookie the vitopsAbTesting() middleware assigns. Distinct from `abTesting`, which merges a whole build/environment variant at resolve time; this instead lets one page (e.g. a real, nav-linked /contact) run a copy test without a second URL or a second deploy. Keyed by an open experiment name so more than one can run at once.",
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "enabled": {
+                "type": "boolean"
+              },
+              "category": {
+                "description": "Consent category this experiment's assignment cookie waits on (default `analytics`) — independent of `site.tracking.category`, so an experiment never piggybacks on ad-attribution consent.",
+                "type": "string",
+                "enum": [
+                  "analytics",
+                  "marketing"
+                ]
+              },
+              "cookieName": {
+                "description": "Default `_ab_<experiment key>`.",
+                "type": "string"
+              },
+              "cookieMaxAge": {
+                "description": "Seconds.",
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
+              },
+              "splitRatio": {
+                "description": "Fraction of new visitors auto-assigned to `variants[1]` (default 0.5). 0 means nobody is auto-assigned — a manually or query-param-set cookie still pins a visitor to `variants[1]`, which is what makes 0 a real blue/green-preview mode rather than a no-op.",
+                "type": "number",
+                "minimum": 0,
+                "maximum": 1
+              },
+              "variants": {
+                "type": "array",
+                "prefixItems": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "string"
+                  }
+                ],
+                "items": false,
+                "minItems": 2,
+                "maxItems": 2,
+                "description": "Exactly two variant names, e.g. [\"control\", \"new-form\"]. `variants[0]` is the default a visitor with no assignment yet effectively sees."
+              }
+            },
+            "required": [
+              "enabled",
+              "variants"
+            ],
+            "additionalProperties": false
+          }
+        },
         "fonts": {
           "description": "Font LOADING (a serialisable projection of the Astro Fonts API: provider, weights, subsets, preload). Font TOKENS live in `designSystem.themes.<theme>.fonts` and reference the same `cssVariable`.",
           "type": "array",
@@ -1591,13 +1656,9 @@
               "weights": {
                 "type": "array",
                 "items": {
-                  "anyOf": [
-                    {
-                      "type": "number"
-                    },
-                    {
-                      "type": "string"
-                    }
+                  "type": [
+                    "number",
+                    "string"
                   ]
                 }
               },
@@ -1660,13 +1721,9 @@
                       }
                     },
                     "weight": {
-                      "anyOf": [
-                        {
-                          "type": "number"
-                        },
-                        {
-                          "type": "string"
-                        }
+                      "type": [
+                        "number",
+                        "string"
                       ]
                     },
                     "style": {
@@ -1711,13 +1768,9 @@
                       "type": "object",
                       "properties": {
                         "weight": {
-                          "anyOf": [
-                            {
-                              "type": "number"
-                            },
-                            {
-                              "type": "string"
-                            }
+                          "type": [
+                            "number",
+                            "string"
                           ]
                         },
                         "style": {
@@ -2079,16 +2132,10 @@
                             "type": "string"
                           },
                           "additionalProperties": {
-                            "anyOf": [
-                              {
-                                "type": "string"
-                              },
-                              {
-                                "type": "number"
-                              },
-                              {
-                                "type": "boolean"
-                              }
+                            "type": [
+                              "string",
+                              "number",
+                              "boolean"
                             ]
                           }
                         }
@@ -2106,16 +2153,10 @@
                       "type": "string"
                     },
                     "additionalProperties": {
-                      "anyOf": [
-                        {
-                          "type": "string"
-                        },
-                        {
-                          "type": "number"
-                        },
-                        {
-                          "type": "boolean"
-                        }
+                      "type": [
+                        "string",
+                        "number",
+                        "boolean"
                       ]
                     }
                   },
@@ -2185,70 +2226,115 @@
           "additionalProperties": false
         },
         "seo": {
-          "description": "SEO defaults: title/description templates, robots policy, verification tokens, Open Graph + Twitter cards, and post-deploy indexing notification.",
+          "description": "SEO defaults: site name, title/description defaults, robots policy, verification tokens, Open Graph + Twitter cards, and post-deploy indexing notification. Read by `<Seo />`, `vitops robots` and `vitops search notify`.",
           "type": "object",
           "properties": {
+            "siteName": {
+              "description": "`og:site_name`, and the `<title>` when a page passes none. Defaults to `organization.name`, so most sites never state it.",
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {
+                    "type": "string"
+                  }
+                }
+              ]
+            },
             "titleTemplate": {
-              "description": "Page-title pattern (e.g. \"%s · Acme\").",
-              "type": "string"
+              "description": "Page-title pattern; `%s` is the page title (e.g. \"%s · Acme\"). Applies to `<title>` only, never to `og:title`, and is skipped when the page title already equals the site name.",
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {
+                    "type": "string"
+                  }
+                }
+              ]
             },
-            "descriptionTemplate": {
-              "type": "string"
+            "defaultTitle": {
+              "description": "`<title>` for pages that pass none. Used verbatim — the template is not applied. Defaults to the site name.",
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {
+                    "type": "string"
+                  }
+                }
+              ]
+            },
+            "defaultDescription": {
+              "description": "`<meta name=\"description\">` for pages that pass none.",
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {
+                    "type": "string"
+                  }
+                }
+              ]
             },
             "robots": {
-              "description": "e.g. \"index,follow\" / \"noindex,nofollow\".",
+              "description": "Site-wide robots directive (e.g. \"index,follow\" / \"noindex,nofollow\"). `site.environments.<env>.robots` wins over it.",
               "type": "string"
             },
             "googleSiteVerification": {
+              "description": "Google Search Console verification token (`<meta name=\"google-site-verification\">`).",
               "type": "string"
             },
             "bingSiteVerification": {
+              "description": "Bing Webmaster Tools verification token (`<meta name=\"msvalidate.01\">`).",
               "type": "string"
             },
             "openGraph": {
+              "description": "Open Graph defaults. Per-page `<Seo />` props override them.",
               "type": "object",
               "properties": {
                 "type": {
-                  "type": "string"
+                  "description": "Default `og:type`. Default `website`.",
+                  "type": "string",
+                  "enum": [
+                    "website",
+                    "article",
+                    "profile"
+                  ]
                 },
-                "siteName": {
+                "locale": {
+                  "description": "`og:locale`. `en-CA` and `en_CA` both emit `en_CA`.",
                   "type": "string"
                 },
-                "title": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "object",
-                      "propertyNames": {
-                        "type": "string"
-                      },
-                      "additionalProperties": {
-                        "type": "string"
-                      }
-                    }
-                  ],
-                  "description": "A string, or a per-locale map of strings (`{ en: \"…\", fr: \"…\" }`)."
-                },
-                "description": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "object",
-                      "propertyNames": {
-                        "type": "string"
-                      },
-                      "additionalProperties": {
-                        "type": "string"
-                      }
-                    }
-                  ],
-                  "description": "A string, or a per-locale map of strings (`{ en: \"…\", fr: \"…\" }`)."
+                "localeAlternates": {
+                  "description": "Other locales the same content exists in → `og:locale:alternate`.",
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
                 },
                 "image": {
+                  "description": "Fallback share image for pages that bring none.",
                   "anyOf": [
                     {
                       "type": "string"
@@ -2257,7 +2343,8 @@
                       "type": "object",
                       "properties": {
                         "src": {
-                          "type": "string"
+                          "type": "string",
+                          "description": "Absolute, or relative to `site` (resolved at render time)."
                         },
                         "alt": {
                           "type": "string"
@@ -2267,26 +2354,28 @@
                         },
                         "height": {
                           "type": "number"
+                        },
+                        "type": {
+                          "description": "MIME type, e.g. `image/png`.",
+                          "type": "string"
                         }
                       },
                       "required": [
-                        "src",
-                        "alt"
+                        "src"
                       ],
                       "additionalProperties": false
                     }
                   ]
-                },
-                "locale": {
-                  "type": "string"
                 }
               },
               "additionalProperties": false
             },
             "twitter": {
+              "description": "Twitter/X card defaults.",
               "type": "object",
               "properties": {
                 "card": {
+                  "description": "Card type when no image resolves (default `summary`).",
                   "type": "string",
                   "enum": [
                     "summary",
@@ -2296,73 +2385,12 @@
                   ]
                 },
                 "site": {
+                  "description": "The site's own handle, e.g. \"@acme\".",
                   "type": "string"
                 },
                 "creator": {
+                  "description": "Default author handle, e.g. \"@ada\".",
                   "type": "string"
-                },
-                "title": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "object",
-                      "propertyNames": {
-                        "type": "string"
-                      },
-                      "additionalProperties": {
-                        "type": "string"
-                      }
-                    }
-                  ],
-                  "description": "A string, or a per-locale map of strings (`{ en: \"…\", fr: \"…\" }`)."
-                },
-                "description": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "object",
-                      "propertyNames": {
-                        "type": "string"
-                      },
-                      "additionalProperties": {
-                        "type": "string"
-                      }
-                    }
-                  ],
-                  "description": "A string, or a per-locale map of strings (`{ en: \"…\", fr: \"…\" }`)."
-                },
-                "image": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "object",
-                      "properties": {
-                        "src": {
-                          "type": "string"
-                        },
-                        "alt": {
-                          "type": "string"
-                        },
-                        "width": {
-                          "type": "number"
-                        },
-                        "height": {
-                          "type": "number"
-                        }
-                      },
-                      "required": [
-                        "src",
-                        "alt"
-                      ],
-                      "additionalProperties": false
-                    }
-                  ]
                 }
               },
               "additionalProperties": false
@@ -2465,6 +2493,16 @@
                 "cookies": {
                   "description": "Default false — Matomo runs cookieless (`disableCookies`), which is what lets the cookie notice state positively that it sets none.",
                   "type": "boolean"
+                },
+                "abVariantDimensions": {
+                  "description": "Pre-created Matomo custom-dimension index per `site.experiments` key — Matomo requires the dimension to exist in the instance before a value can be pushed for it.",
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {
+                    "type": "number"
+                  }
                 }
               },
               "required": [
@@ -2486,7 +2524,7 @@
                 {
                   "type": "string",
                   "format": "email",
-                  "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
+                  "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
                 },
                 {
                   "type": "object",
@@ -2500,13 +2538,13 @@
                       "description": "Recipient. Defaults to the primary location’s `email`, then the first location that has one.",
                       "type": "string",
                       "format": "email",
-                      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
+                      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
                     },
                     "from": {
                       "description": "Sender. Defaults to `noreply@<domains.canonical>`. Its domain must be onboarded (`wrangler email sending enable <domain>`) or every send fails.",
                       "type": "string",
                       "format": "email",
-                      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
+                      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
                     },
                     "fromName": {
                       "description": "Display name on the From header. Defaults to `organization.name`.",
@@ -2516,11 +2554,15 @@
                       "description": "Reply-To header.",
                       "type": "string",
                       "format": "email",
-                      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
+                      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
                     },
                     "binding": {
                       "description": "Workers `send_email` binding name (default `EMAIL`). Set it when using a restricted binding.",
                       "type": "string"
+                    },
+                    "verifySender": {
+                      "description": "Set false to skip `vitops email check`'s deploy-time onboarding warning for this site — for a `from` domain the scan cannot see is correct (e.g. built dynamically), which would otherwise be a false positive.",
+                      "type": "boolean"
                     }
                   },
                   "required": [
@@ -2529,6 +2571,10 @@
                   "additionalProperties": false
                 }
               ]
+            },
+            "actionUrl": {
+              "description": "Optional action-link template added to the conversion email (e.g. a link into your ad platform or your own CRM/portal). `{clickId}` is replaced with the ad click ID captured on `_ac` (gclid, fbclid, …). Omitted from the email when the event carries no click ID to interpolate, rather than rendering a broken link.",
+              "type": "string"
             }
           },
           "additionalProperties": false
@@ -2587,8 +2633,64 @@
                 "type": "string"
               },
               "conversionLabel": {
-                "description": "Google Ads only: the conversion action label paired with the `AW-…` conversion ID.",
-                "type": "string"
+                "description": "Google Ads only: the conversion action label(s) paired with the `AW-…` conversion ID — either one bare label (back-compat, treated as the `call` action) or a map of action → label, so a call, an email click and a form submission each fire their own Google Ads conversion action instead of all three reporting as the same one.",
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "call": {
+                        "description": "Fired on a tel: link click.",
+                        "type": "string"
+                      },
+                      "email": {
+                        "description": "Fired on a mailto: link click.",
+                        "type": "string"
+                      },
+                      "form": {
+                        "description": "Fired client-side by `vitopsFormConversion()` — the consumer's own submit handler calls it once a form POST succeeds.",
+                        "type": "string"
+                      }
+                    },
+                    "additionalProperties": false
+                  }
+                ]
+              },
+              "conversionActionId": {
+                "description": "Google Ads only: the conversion action **resource id(s)** (a numeric id, or a full `customers/…/conversionActions/…` resource name) used for server-side offline conversion upload — NOT the same value as `conversionLabel`, which is the opaque label the web tag uses and which the Ads API's upload endpoint does not accept. Only meaningful when `reporting: \"server\"`.",
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "call": {
+                        "description": "Fired on a tel: link click.",
+                        "type": "string"
+                      },
+                      "email": {
+                        "description": "Fired on a mailto: link click.",
+                        "type": "string"
+                      },
+                      "form": {
+                        "description": "Fired on a form submission.",
+                        "type": "string"
+                      }
+                    },
+                    "additionalProperties": false
+                  }
+                ]
+              },
+              "reporting": {
+                "description": "Google Ads only: `\"client\"` (default) fires the conversion via `gtag.js` in the browser at click/submit time; `\"server\"` uploads it via the Ads API from the conversion endpoint instead (see `conversionActionId`). An action with no matching `conversionActionId` keeps firing client-side regardless of this setting, so setting it before `conversionActionId` is filled in never silently drops a conversion.",
+                "type": "string",
+                "enum": [
+                  "client",
+                  "server"
+                ]
               },
               "domain": {
                 "description": "Bare hostname to verify with this platform. Defaults to the host of `domains.canonical` — set it only when the ad account is verified against a different domain.",
@@ -2683,6 +2785,150 @@
           ],
           "additionalProperties": false
         },
+        "crm": {
+          "description": "Push form submissions into a client CRM (HubSpot, Zoho Bigin, or Jobber) alongside the notification email. Read by `createConversionRoute()`'s `crm` option and `vitops crm check`/`vitops crm setup`. Credentials never live here.",
+          "type": "object",
+          "properties": {
+            "provider": {
+              "type": "string",
+              "enum": [
+                "hubspot",
+                "bigin",
+                "jobber"
+              ],
+              "description": "Which CRM this site pushes form submissions into."
+            },
+            "enabled": {
+              "description": "Set false to keep the block on record without writing to the CRM.",
+              "type": "boolean"
+            },
+            "hubspot": {
+              "description": "Required when `provider` is `hubspot`.",
+              "type": "object",
+              "properties": {
+                "portalId": {
+                  "type": "string",
+                  "description": "The HubSpot portal (hub) ID the form belongs to."
+                },
+                "formGuid": {
+                  "type": "string",
+                  "description": "The HubSpot form GUID to submit against."
+                },
+                "dataCenter": {
+                  "description": "Which regional submissions API to post to (default `na`).",
+                  "type": "string",
+                  "enum": [
+                    "na",
+                    "eu"
+                  ]
+                }
+              },
+              "required": [
+                "portalId",
+                "formGuid"
+              ],
+              "additionalProperties": false
+            },
+            "bigin": {
+              "description": "Required when `provider` is `bigin`.",
+              "type": "object",
+              "properties": {
+                "dataCenter": {
+                  "type": "string",
+                  "enum": [
+                    "com",
+                    "ca",
+                    "eu",
+                    "in",
+                    "com.au",
+                    "jp"
+                  ],
+                  "description": "The self-client's data centre — determines both the OAuth accounts host and the API host (`www.zohoapis.<dc>`)."
+                },
+                "duplicateCheckField": {
+                  "description": "Bigin field the upsert dedupes on (default `Email`, Bigin's own unique field).",
+                  "type": "string"
+                },
+                "pipeline": {
+                  "description": "Also open a Pipelines record alongside the Contact.",
+                  "type": "object",
+                  "properties": {
+                    "enabled": {
+                      "type": "boolean",
+                      "description": "Also open a Pipelines record for the new/updated contact."
+                    },
+                    "subPipeline": {
+                      "description": "Sub-pipeline to file the record under.",
+                      "type": "string"
+                    },
+                    "stage": {
+                      "description": "Starting stage for the pipeline record.",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "enabled"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "dataCenter"
+              ],
+              "additionalProperties": false
+            },
+            "jobber": {
+              "description": "Required when `provider` is `jobber`.",
+              "type": "object",
+              "properties": {
+                "apiVersion": {
+                  "description": "Override the pinned `X-JOBBER-GRAPHQL-VERSION` date this integration is tested against. An escape hatch for an app pinned to a different version — Jobber's schema can change field names between versions.",
+                  "type": "string"
+                },
+                "dedupe": {
+                  "description": "Look up an existing client by email before creating one (default false pending verification of Jobber's search API against a live schema — see AGENTS.md). Jobber's `clientCreate` has no upsert, so without this a resubmitting visitor creates a second client.",
+                  "type": "boolean"
+                },
+                "note": {
+                  "description": "Attach a best-effort note carrying the submitted message and any attribution/extra fields with no dedicated Jobber field.",
+                  "type": "object",
+                  "properties": {
+                    "enabled": {
+                      "description": "Attach a best-effort note carrying the message and unmapped attribution (default true). A failure here never loses the client record itself.",
+                      "type": "boolean"
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              },
+              "additionalProperties": false
+            },
+            "fieldMap": {
+              "description": "Submitted form field name → CRM property name. A field with no entry here is dropped, not guessed — an unmapped field never reaches the CRM.",
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {
+                "type": "string"
+              }
+            },
+            "trackingFields": {
+              "description": "`_ac` attribution key (a click-ID param, a UTM param, `landingPage`, `referrer`, or `ab_variant`) → CRM property name. Same drop-if-unmapped rule as `fieldMap`; a visitor with no `_ac` cookie maps to no attribution fields at all, never an error.",
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {
+                "type": "string"
+              }
+            }
+          },
+          "required": [
+            "provider"
+          ],
+          "additionalProperties": false
+        },
         "security": {
           "description": "Security integrations (bot protection).",
           "type": "object",
@@ -2740,7 +2986,7 @@
                         "email": {
                           "type": "string",
                           "format": "email",
-                          "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
+                          "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
                         },
                         "phone": {
                           "type": "string"
@@ -3045,6 +3291,14 @@
             },
             "type": {
               "type": "string"
+            },
+            "repo": {
+              "description": "`owner/name` of this site's GitHub repository. Read by the EmDash design-system-editor plugin route to auto-commit a client's admin edit back to `branch` — see AGENTS.md's \"EmDash plugin as the design-system editing surface\" section. Absent means that sync is skipped (the live override still applies); nothing else in this toolchain reads it today.",
+              "type": "string"
+            },
+            "branch": {
+              "description": "Branch the design-system-editor sync commits to. Default `\"dev\"` — never `main`/production directly; a commit here still needs this repo's own `promote` PR + admin approval to reach production, the same gate every other change goes through.",
+              "type": "string"
             }
           },
           "additionalProperties": false
@@ -3126,16 +3380,10 @@
             "type": "string"
           },
           "additionalProperties": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "number"
-              },
-              {
-                "type": "boolean"
-              }
+            "type": [
+              "string",
+              "number",
+              "boolean"
             ]
           }
         },
@@ -3145,16 +3393,10 @@
             "type": "string"
           },
           "additionalProperties": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "number"
-              },
-              {
-                "type": "boolean"
-              }
+            "type": [
+              "string",
+              "number",
+              "boolean"
             ]
           }
         },
@@ -3192,16 +3434,10 @@
             "type": "string"
           },
           "additionalProperties": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "number"
-              },
-              {
-                "type": "boolean"
-              }
+            "type": [
+              "string",
+              "number",
+              "boolean"
             ]
           }
         },