@adcp/sdk 15.0.0 → 15.2.1

package/dist/lib/schemas-data/3.2/core/forecast-dimension-signal.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-dimension-signal.json",
+  "$id": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-dimension-signal.json",
   "title": "Signal Forecast Dimension",
   "description": "A signal value or signal-presence dimension for a ForecastPoint row. Variant of ForecastPoint dimensions; see forecast-point-dimensions.json for dispatch rules.",
   "type": "object",
@@ -11,7 +11,7 @@
       "description": "Dimension family discriminator."
     },
     "signal_ref": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/signal-ref.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/signal-ref.json",
       "description": "Canonical signal reference for this forecast row. Required when the row needs to disambiguate product-local, data-provider, or signal-source identity. Product-relative forecasts SHOULD use signal_ref."
     },
     "signal_id": {

package/dist/lib/schemas-data/3.2/core/forecast-dimension-time.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-dimension-time.json",
+  "$id": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-dimension-time.json",
   "title": "Time Forecast Dimension",
   "description": "A calendar-window dimension for a ForecastPoint row. Variant of ForecastPoint dimensions; see forecast-point-dimensions.json for dispatch rules. Windows are half-open intervals [start_time, end_time): the row covers instants at or after start_time and strictly before end_time, so adjacent windows share a boundary without overlapping. end_time MUST be after start_time; JSON Schema draft-07 cannot compare sibling values, so conformance tooling enforces the ordering. Within one forecast, sellers MUST emit non-overlapping windows and SHOULD coalesce adjacent windows whose availability_status and metrics do not materially differ. When the request scoped the forecast with offer_filters.availability_horizon, a complete forecast partitions the requested horizon; a seller that cannot cover the full horizon signals the gap through the response's incomplete[] mechanism rather than silently omitting windows.",
   "type": "object",

package/dist/lib/schemas-data/3.2/core/forecast-point-dimensions.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-point-dimensions.json",
+  "$id": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-point-dimensions.json",
   "title": "Forecast Point Dimensions",
   "description": "Dimension constraints represented by a ForecastPoint. Use this when one product, proposal, or signal coverage forecast needs to expose availability or forecasted delivery by country, region, placement, device, audience, signal value, time window, or intersections such as placement x country without creating separate products solely for each slice. Each item declares one dimension family via `kind`; when multiple items are present, the point represents their intersection. Sellers MUST NOT emit more than one item for each `kind` in a point. Consumers MUST NOT treat repeated kinds as OR semantics; repeated peer values such as two countries are a seller conformance issue. Dimension values are descriptors of the forecast row and are independent of pricing_options.",
   "x-adcp-validation": {
@@ -15,25 +15,25 @@
   "items": {
     "oneOf": [
       {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-dimension-geo.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-dimension-geo.json"
       },
       {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-dimension-placement.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-dimension-placement.json"
       },
       {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-dimension-device-type.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-dimension-device-type.json"
       },
       {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-dimension-device-platform.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-dimension-device-platform.json"
       },
       {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-dimension-audience.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-dimension-audience.json"
       },
       {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-dimension-signal.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-dimension-signal.json"
       },
       {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-dimension-time.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-dimension-time.json"
       }
     ]
   }

package/dist/lib/schemas-data/3.2/core/forecast-point.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-point.json",
+  "$id": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-point.json",
   "title": "Forecast Point",
   "description": "A forecast data point. When budget is present, the point pairs a spend level with expected delivery — multiple points at ascending budgets form a curve. When budget is omitted, the point represents total available inventory for the requested targeting and dates, independent of spend.",
   "type": "object",
@@ -26,11 +26,11 @@
       "x-entity": "product"
     },
     "dimensions": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-point-dimensions.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-point-dimensions.json",
       "description": "Dimension constraints represented by this forecast point, such as country, region, placement, device type, platform, audience, signal value, time window, or intersections such as placement x country or product x signal. Each item declares one dimension family; when multiple items are present, the point represents their intersection. Sellers MUST NOT emit more than one item for each `kind` on a point; consumers MUST NOT treat repeated kinds as OR semantics. Use multiple points with dimensions to expose country/placement/signal availability within one product, proposal, or signal coverage forecast without creating separate products solely for each dimension. Dimensions describe the forecast row and are independent of pricing_options."
     },
     "availability_status": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.1/enums/availability-status.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/enums/availability-status.json",
       "description": "Bookability of the inventory this row describes, as of the forecast's generated_at. Most meaningful on rows with a time dimension in an availability forecast (forecast_range_unit 'availability'). This is a snapshot, not a hold: valid_until bounds freshness, and proposal finalization or purchase remains the commitment boundary. When omitted, the row makes no bookability claim. 'unavailable' rows may carry empty metrics."
     },
     "metrics": {
@@ -38,57 +38,57 @@
       "description": "Forecasted metric values. Keys are forecastable-metric enum values for delivery/engagement or event-type enum values for outcomes. Values are ForecastRange objects (low/mid/high). Use { \"mid\": value } for point estimates. When budget is present, these are the expected metrics at that spend level. When budget is omitted, these represent total available inventory — use spend to express the estimated cost. Additional keys beyond the documented properties are allowed for event-type values (purchase, lead, app_install, etc.).",
       "properties": {
         "audience_size": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json"
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json"
         },
         "reach": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json"
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json"
         },
         "frequency": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json"
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json"
         },
         "impressions": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json"
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json"
         },
         "clicks": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json"
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json"
         },
         "spend": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json"
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json"
         },
         "views": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json"
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json"
         },
         "completed_views": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json"
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json"
         },
         "grps": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json"
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json"
         },
         "engagements": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json"
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json"
         },
         "follows": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json"
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json"
         },
         "saves": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json"
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json"
         },
         "profile_visits": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json"
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json"
         },
         "measured_impressions": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json"
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json"
         },
         "downloads": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json"
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json"
         },
         "plays": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json"
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json"
         },
         "coverage_rate": {
           "allOf": [
             {
-              "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json"
+              "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json"
             },
             {
               "properties": {
@@ -108,7 +108,7 @@
         }
       },
       "additionalProperties": {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json"
       }
     },
     "viewability": {
@@ -116,21 +116,21 @@
       "description": "Forecasted viewability metrics. Mirrors delivery-metrics.viewability, but numeric values are ForecastRange objects because forecast rows may provide low/mid/high bounds. Use this for pre-buy viewability expectations by forecast point without folding measurement metrics into pricing_options.",
       "properties": {
         "vendor": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/brand-ref.json",
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/brand-ref.json",
           "description": "Vendor expected to produce or verify these viewability values."
         },
         "measurable_impressions": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json",
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json",
           "description": "Forecasted impressions where viewability can be measured. Coverage denominator for viewable_rate and viewed_seconds."
         },
         "viewable_impressions": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json",
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json",
           "description": "Forecasted impressions expected to meet the viewability threshold defined by standard."
         },
         "viewable_rate": {
           "allOf": [
             {
-              "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json"
+              "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json"
             },
             {
               "properties": {
@@ -149,11 +149,11 @@
           "description": "Forecasted viewable impression rate (viewable_impressions / measurable_impressions). Range 0.0 to 1.0."
         },
         "viewed_seconds": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json",
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json",
           "description": "Forecasted average in-view duration per measurable impression, in seconds."
         },
         "standard": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.1/enums/viewability-standard.json",
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/enums/viewability-standard.json",
           "description": "Viewability measurement standard applied to these forecasted values."
         }
       },
@@ -196,7 +196,7 @@
       "type": "array",
       "description": "Forecasted values for vendor-defined metrics that the product's reporting_capabilities.vendor_metrics declared. Mirrors delivery-metrics.vendor_metric_values, but value and measurable_impressions use ForecastRange. These forecasted measurement values are independent of pricing_options.",
       "items": {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-vendor-metric-value.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-vendor-metric-value.json"
       }
     }
   },

package/dist/lib/schemas-data/3.2/core/forecast-range.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json",
+  "$id": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json",
   "title": "Forecast Range",
   "description": "A forecast value with optional confidence bounds. Either mid (point estimate) or both low and high (range) must be provided. mid represents the most likely outcome. low and high represent conservative and optimistic estimates. All three can be provided together.",
   "type": "object",

package/dist/lib/schemas-data/3.2/core/forecast-rate-range.json

@@ -1,11 +1,11 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-rate-range.json",
+  "$id": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-rate-range.json",
   "title": "Forecast Rate Range",
   "description": "A forecast range whose low, midpoint, and high values are rates in the inclusive interval from 0 to 1.",
   "allOf": [
     {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json"
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json"
     },
     {
       "properties": {

package/dist/lib/schemas-data/3.2/core/forecast-vendor-metric-value.json

@@ -1,20 +1,20 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-vendor-metric-value.json",
+  "$id": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-vendor-metric-value.json",
   "title": "Forecast Vendor Metric Value",
   "description": "A forecasted value for a vendor-defined metric, emitted on ForecastPoint.vendor_metric_values parallel to delivery-metrics vendor_metric_values. The envelope mirrors VendorMetricValue but uses ForecastRange for value and the coverage denominators (measurable_impressions, measurable_plays, measurable_play_seconds) because forecasts may carry low/mid/high bounds instead of actual delivered values.",
   "type": "object",
   "properties": {
     "vendor": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/brand-ref.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/brand-ref.json",
       "description": "Vendor that defines and forecasts this metric. Matches a reporting_capabilities.vendor_metrics declaration on the product."
     },
     "metric_id": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/vendor-metric-id.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/vendor-metric-id.json",
       "description": "Identifier for the metric within the vendor's vocabulary. Matches a vendor_metrics[].metric_id declaration on the product."
     },
     "value": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json",
       "description": "Forecasted vendor metric value. Unit semantics are vendor-defined; see unit and the vendor's measurement-agent metric definition."
     },
     "unit": {
@@ -31,15 +31,15 @@
       ]
     },
     "measurable_impressions": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json",
       "description": "Forecasted number of impressions the vendor expects to be able to measure. Coverage denominator for the vendor metric; buyers compute estimated coverage as measurable_impressions / impressions when both are present. For play-based channels (DOOH, cinema, place-based) forecast measurable_plays or measurable_play_seconds instead."
     },
     "measurable_plays": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json",
       "description": "Forecasted number of plays the vendor expects to be able to measure. Coverage denominator for channels where a play, not an impression, is the atomic observation unit; buyers compute estimated coverage as measurable_plays / plays when both are present."
     },
     "measurable_play_seconds": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.1/core/forecast-range.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json",
       "description": "Forecasted play-seconds (creative playout seconds summed across endpoints — screens, speakers, players) the vendor expects to be able to measure. Coverage denominator when the vendor meters exposure duration rather than discrete plays."
     },
     "breakdown": {

package/dist/lib/schemas-data/3.2/core/format-id.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://adcontextprotocol.org/schemas/3.2.1/core/format-id.json",
+  "$id": "https://adcontextprotocol.org/schemas/3.2.3/core/format-id.json",
   "title": "Format Reference (Structured Object)",
   "deprecated": true,
   "description": "**DEPRECATED in 3.2.** Legacy named-format reference retained for 3.x compatibility. This JSON object — never a plain string — identifies a format by its declaring agent and local slug, and may carry legacy logical dimensions, pixel ratio, or duration parameters. New products and manifests use canonical `format_options`, `format_kind`, and `format_option_ref`; creative-agent build routing uses `creative.supported_formats[].capability_id`.",

package/dist/lib/schemas-data/3.2/core/format-option-ref.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://adcontextprotocol.org/schemas/3.2.1/core/format-option-ref.json",
+  "$id": "https://adcontextprotocol.org/schemas/3.2.3/core/format-option-ref.json",
   "title": "Format Option Reference",
   "description": "Discriminated reference to a product format option. The global canonical shape is still named by `format_kind`; this reference selects one concrete product `format_options[]` entry. `scope: \"publisher\"` identifies a publisher-declared catalog option by `{ publisher_domain, format_option_id }`. `scope: \"product\"` identifies a product-local option by `format_option_id`; the enclosing package/product context supplies the namespace.",
   "type": "object",

package/dist/lib/schemas-data/3.2/core/format-shape-vocabulary.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://adcontextprotocol.org/schemas/3.2.1/core/format-shape-vocabulary.json",
+  "$id": "https://adcontextprotocol.org/schemas/3.2.3/core/format-shape-vocabulary.json",
   "title": "AdCP Format Shape Vocabulary Registry",
   "description": "Canonical registry of `format_shape` values used on `ProductFormatDeclaration` when `format_kind: \"custom\"`. Captures recognized creative-structure patterns that are NOT yet first-class canonical formats — composed/coordinated/sponsorship shapes that high-end publishers and broadcast networks sell as headline products. Each registry entry names a global shape; the seller's actual structure lives in `format_schema` (URI+digest reference to the seller-hosted or AAO-mirrored schema) so buyer agents can fetch and validate against a real schema rather than reasoning over an opaque ext blob.\n\n**Two-layer extensibility:**\n- **Canonical** (`format_kind: image`, `video_vast`, etc.): full spec coverage, stable contract.\n- **Custom + format_shape + format_schema** (`format_kind: \"custom\"`): recognized pattern, classified against this vocabulary, but the params/slots structure is supplied by a fetchable schema rather than baked into AdCP.\n\nNon-canonical `format_shape` values remain valid (validators MAY soft-warn) so adopters CAN ship a shape that isn't yet in the registry — adding entries is a vocabulary PR, not a major-version bump. Once a `format_shape` entry sees 2+ adopters with substantively similar `format_schema` content for 90+ days, the working group promotes it to a first-class canonical (creates `/schemas/formats/canonical/<name>.json`, adds the value to `canonical-format-kind.json`, retires the registry entry). See [adcp#3666](https://github.com/adcontextprotocol/adcp/issues/3666) for the promotion queue.\n\n**Promotion migration contract (normative).** Promotion is a wire-shape change for any consumer code branching on `format_kind == \"custom\"` — the same publisher's product now ships under `format_kind: \"<promoted_name>\"`. To avoid silent breakage:\n\n1. **Transition window.** When the working group promotes a `format_shape` to a first-class `format_kind`, sellers MAY ship a product under BOTH shapes during the transition window — two declarations on the same product's `format_options` array, one `format_kind: \"custom\"` + `format_shape: \"<name>\"` and one `format_kind: \"<promoted_name>\"`. Transition window is at minimum 90 days; the promotion PR sets the calendar.\n2. **Consumer-SDK deprecation warning.** SDKs encountering a `format_kind: \"custom\"` declaration whose `format_shape` matches an entry promoted to a first-class canonical SHOULD emit a structured deprecation warning via their lint channel (same pattern as `FORMAT_PROJECTION_FAILED` cross-boundary visibility) carrying `{ format_shape, promoted_to: format_kind, promotion_release, transition_end }`. Adopters branching on `format_kind == \"custom\"` past `transition_end` silently lose that publisher's inventory; the deprecation warning is the early signal.\n3. **`promotion_status` lifecycle.** When promotion is scheduled, the entry's `promotion_status` SHOULD update from `tracking — see adcp#3666` to `promoted to <format_kind> in <version>; transition ends <date>`. SDKs MAY read the registry at codegen / runtime to populate the deprecation warning's `transition_end`.\n4. **Producer-side hygiene.** After the transition window closes, sellers SHOULD drop the legacy `format_kind: \"custom\"` declaration and ship only the first-class canonical. Buyers MAY then assume `format_kind == \"custom\"` + `format_shape: \"<name>\"` is a long-tail / non-promoted shape, not a promoted-canonical-shipped-under-the-old-name.\n\nWithout this contract, every promotion event silently breaks adopter code branching on `format_kind == \"custom\"`. With it, the breakage surfaces as a structured warning during the transition window and adopters can update their branching ahead of the cutover.",
   "version": "1.1.0",