@adcp/sdk 15.8.1 → 16.0.0-beta.1

package/compliance/cache/3.2.3/protocols/media-buy/scenarios/targeting_aware_discovery.yaml

@@ -1,1698 +0,0 @@
-id: media_buy_seller/targeting_aware_discovery
-version: "1.1.0"
-title: "Seller resolves targeting during discovery and persists inventory selection"
-category: media_buy_seller
-summary: "Verifies targeting-scoped discovery forecasts, future overlay support, sparse configured-product modifications, opaque product acceptance, and inventory targeting across create/update/readback."
-track: media_buy
-introduced_in: "3.2"
-
-required_tools:
-  - get_products
-  - create_media_buy
-  - update_media_buy
-  - get_media_buys
-  - comply_test_controller
-
-invariants:
-  - status.monotonic
-
-narrative: |
-  Buyers provide concrete targeting during get_products so returned products,
-  pricing, and forecasts already describe the inventory they can buy. Exact
-  acceptance of a structured overlay produces no targeting echo. Explicit hard
-  targeting in a brief remains binding. When a structured predicate inferred
-  from prose materially affects eligibility, pricing, or forecasting, sellers
-  must confirm it once through response-level
-  targeting_resolution.brief_targeting; otherwise confirmation remains a best
-  practice.
-  A seller may offer a different executable predicate only as a sparse
-  modification on a distinct, expiring configured product; purchasing that
-  product accepts the change.
-
-  required_overlay_support is capability discovery, not a breakout request.
-  It filters to products that permit later package-level selection. Placement,
-  property, and collection selection are inventory targeting. Creative
-  placement_refs remain routing instructions within the purchased set.
-
-agent:
-  interaction_model: media_buy_seller
-  capabilities:
-    - sells_media
-    - targeting_aware_discovery
-    - placement_targeting
-  examples:
-    - "National video products targetable by DMA and social surface"
-    - "Local inventory products whose inherent scope satisfies geo targeting"
-    - "Products backed by seller-defined demographic intervals"
-
-caller:
-  role: buyer_agent
-  example: "Pinnacle Agency (buyer)"
-
-prerequisites:
-  description: |
-    The controller seeds a non-guaranteed video product with US and Canadian inventory,
-    one-country package targeting, one-entry radius proximity targeting,
-    Nielsen DMA support, two targetable publisher-scoped placements, list
-    targeting support, enumerated age intervals, and deterministic browser
-    inventory. Chrome, Firefox, and unclassifiable browser traffic are
-    forecastable; Safari is recognized and targetable but has no inventory in
-    the seeded forecast window. Safari is compatible only with iOS and macOS,
-    so Safari plus Android is unenforceable. The seller can return request-scoped
-    configured products derived from this catalog product. The expired
-    configured fixture is a retained tombstone issued to this scenario's
-    authenticated account and discovery lineage; inaccessible lineages are not
-    exposed.
-  test_kit: "test-kits/acme-outdoor.yaml"
-  controller_seeding: true
-
-fixtures:
-  accounts:
-    - account_id: "acct_acmeoutdoor_example_sandbox_0d55bbc3b1e5"
-      fixture:
-        brand:
-          domain: "acmeoutdoor.example"
-        operator: "pinnacle-agency.example"
-        operator_unit:
-          id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-        billing: "operator"
-        status: "active"
-        sandbox: true
-  products:
-    - product_id: "targeting_aware_video_catalog"
-      ext:
-        training:
-          coverage:
-            countries: ["US", "CA"]
-      delivery_type: "non_guaranteed"
-      channels: ["olv"]
-      format_ids:
-        - id: "video_30s"
-      placements:
-        - kind: "publisher_ref"
-          publisher_domain: "pinnacle-media.example"
-          placement_id: "feed"
-          mode: "targetable"
-        - kind: "publisher_ref"
-          publisher_domain: "pinnacle-media.example"
-          placement_id: "short_video"
-          mode: "targetable"
-      property_targeting_allowed: true
-      collection_targeting_allowed: true
-      allowed_actions:
-        - action: "update_targeting"
-          modes: ["self_serve"]
-      overlay_support:
-        geo_countries:
-          max_values_per_package: 1
-        geo_countries_exclude:
-          max_values_per_package: 1
-        geo_proximity:
-          radius: true
-          max_values_per_package: 1
-        geo_metros:
-          systems: ["nielsen_dma"]
-        placement_selection:
-          max_values_per_package: 2
-        property_list: true
-        collection_list: true
-        device_platform: true
-        device_platform_exclude: true
-        browser:
-          families: ["chrome", "safari", "firefox", "unknown"]
-        browser_exclude:
-          families: ["chrome", "safari", "firefox", "unknown"]
-        keyword_targets: true
-        demographics:
-          age: true
-      demographic_targeting:
-        age:
-          execution_modes: ["enumerated_intervals"]
-          unknown_handling: "always_excluded"
-          intervals:
-            - interval_id: "age_18_24"
-              age: { min: 18, max: 24, include_unknown: false }
-            - interval_id: "age_25_34"
-              age: { min: 25, max: 34, include_unknown: false }
-            - interval_id: "age_35_44"
-              age: { min: 35, max: 44, include_unknown: false }
-      browser_inventory:
-        forecastable_families: ["chrome", "firefox", "unknown"]
-        unavailable_families: ["safari"]
-        platform_compatibility:
-          safari: ["ios", "macos"]
-    - product_id: "targeting_aware_fixed_placement"
-      ext:
-        training:
-          coverage:
-            countries: ["US", "CA"]
-      delivery_type: "non_guaranteed"
-      channels: ["ctv"]
-      format_ids:
-        - id: "video_30s"
-      placements:
-        - kind: "publisher_ref"
-          publisher_domain: "pinnacle-media.example"
-          placement_id: "feed"
-          mode: "included"
-        - kind: "publisher_ref"
-          publisher_domain: "pinnacle-media.example"
-          placement_id: "short_video"
-          mode: "included"
-      allowed_actions:
-        - action: "update_targeting"
-          modes: ["self_serve"]
-    - product_id: "targeting_aware_expired_configured"
-      ext:
-        training:
-          coverage:
-            countries: ["US", "CA"]
-      is_custom: true
-      expires_at: "2020-01-01T00:00:00Z"
-      delivery_type: "non_guaranteed"
-      channels: ["olv"]
-      format_ids:
-        - id: "video_30s"
-      placements:
-        - kind: "publisher_ref"
-          publisher_domain: "pinnacle-media.example"
-          placement_id: "feed"
-          mode: "targetable"
-  pricing_options:
-    - product_id: "targeting_aware_video_catalog"
-      pricing_option_id: "targeting_aware_video_cpm"
-      pricing_model: "cpm"
-      currency: "USD"
-      floor_price: 12.0
-    - product_id: "targeting_aware_fixed_placement"
-      pricing_option_id: "targeting_aware_fixed_cpm"
-      pricing_model: "cpm"
-      currency: "USD"
-      floor_price: 12.0
-    - product_id: "targeting_aware_expired_configured"
-      pricing_option_id: "targeting_aware_expired_cpm"
-      pricing_model: "cpm"
-      currency: "USD"
-      floor_price: 12.0
-
-phases:
-  - id: compatibility_window
-    title: "Apply coverage and delivery targeting independently"
-    steps:
-      - id: accept_same_country_coverage_and_targeting
-        title: "Accept coverage and delivery targeting for the same country"
-        task: get_products
-        schema_ref: "media-buy/get-products-request.json"
-        response_schema_ref: "media-buy/get-products-response.json"
-        doc_ref: "/media-buy/task-reference/get_products"
-        stateful: false
-        sample_request:
-          buying_mode: "brief"
-          brief: "Premium outdoor video"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          filters:
-            channels: ["olv"]
-            countries: ["US"]
-          targeting_overlay:
-            geo_countries: ["US"]
-          context:
-            correlation_id: "targeting_aware_discovery--equivalent_legacy"
-        expected: |
-          Apply US inventory coverage and US delivery targeting independently.
-          Return a configured product whose forecast is scoped by the explicit
-          delivery overlay, not by the coverage filter.
-        validations:
-          - check: response_schema
-            description: "Response matches get-products-response.json"
-          - check: field_present
-            path: "products[0]"
-            description: "Coverage and explicit delivery targeting are both satisfied"
-          - check: field_absent
-            path: "products[0].targeting_resolution"
-            description: "Exact delivery targeting does not manufacture a modification"
-
-      - id: accept_distinct_coverage_and_targeting
-        title: "Accept Canadian coverage with US delivery targeting"
-        task: get_products
-        schema_ref: "media-buy/get-products-request.json"
-        response_schema_ref: "media-buy/get-products-response.json"
-        doc_ref: "/media-buy/task-reference/get_products"
-        stateful: false
-        sample_request:
-          buying_mode: "brief"
-          brief: "Premium outdoor video"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          filters:
-            channels: ["olv"]
-            countries: ["CA"]
-          targeting_overlay:
-            geo_countries: ["US"]
-          context:
-            correlation_id: "targeting_aware_discovery--conflicting_legacy"
-        expected: |
-          The seeded product has inventory in both countries. Canadian coverage
-          selects it, while the explicit overlay configures US-only delivery.
-          The two fields express independent predicates and are not ambiguous.
-        validations:
-          - check: response_schema
-            description: "Response matches get-products-response.json"
-          - check: field_present
-            path: "products[0]"
-            description: "A product covering both countries can satisfy both predicates"
-          - check: field_absent
-            path: "products[0].targeting_resolution"
-            description: "Exact US delivery needs no targeting modification"
-
-  - id: release_downshift
-    title: "Serve the legacy shape to a 3.1-pinned buyer"
-    optional: true
-    requires_capability:
-      path: "adcp.supported_versions"
-      contains: "3.1"
-    narrative: |
-      This phase applies only when the 3.2 seller also advertises 3.1. It proves
-      that release negotiation shapes the payload, rather than merely echoing a
-      different version label around the latest response.
-    steps:
-      - id: get_products_at_3_1
-        title: "Downshift targeting-aware discovery to the 3.1 contract"
-        task: get_products
-        schema_ref: "media-buy/get-products-request.json"
-        response_schema_ref: "media-buy/get-products-response.json"
-        doc_ref: "/media-buy/task-reference/get_products"
-        stateful: false
-        sample_request:
-          adcp_version: "3.1"
-          adcp_major_version: 3
-          buying_mode: "brief"
-          brief: "Premium outdoor video in the US"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          filters:
-            channels: ["olv"]
-            countries: ["US"]
-          context:
-            correlation_id: "targeting_aware_discovery--downshift_3_1"
-        expected: |
-          Serve the request as AdCP 3.1, echo adcp_version 3.1, and omit the
-          targeting-aware response fields introduced in 3.2. If the seller did
-          not advertise 3.1 this phase would be not applicable rather than
-          requiring an unsafe downshift.
-        validations:
-          - check: response_schema
-            description: "Response remains valid against the shared result envelope"
-          - check: envelope_field_pattern
-            path: "adcp_version"
-            pattern: "^3\\.1$"
-            description: "Seller echoes the release it actually served"
-          - check: field_present
-            path: "products[0]"
-            description: "Legacy targeting filters remain functional on the 3.1 path"
-          - check: field_absent
-            path: "targeting_resolution"
-            description: "3.1 response omits request-level brief targeting resolution"
-          - check: field_absent
-            path: "products[0].overlay_support"
-            description: "3.1 product omits the 3.2 product support contract"
-          - check: field_absent
-            path: "products[0].targeting_resolution"
-            description: "3.1 product omits sparse 3.2 targeting modifications"
-
-  - id: brief_targeting_confirmation
-    title: "Confirm hard targeting inferred from a brief"
-    steps:
-      - id: get_brief_targeted_product
-        title: "State hard US and age requirements only in prose"
-        task: get_products
-        schema_ref: "media-buy/get-products-request.json"
-        response_schema_ref: "media-buy/get-products-response.json"
-        doc_ref: "/media-buy/task-reference/get_products"
-        stateful: false
-        sample_request:
-          buying_mode: "brief"
-          brief: "Premium outdoor video. Hard requirements: deliver only in the US and only to people ages 18 through 44."
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          filters:
-            channels: ["olv"]
-            pricing_currencies: ["USD"]
-          context:
-            correlation_id: "targeting_aware_discovery--brief_confirmation"
-        expected: |
-          Treat the explicit geography and age statements as hard requirements,
-          even though the buyer should normally have sent them in
-          targeting_overlay. Return only products whose forecast and pricing
-          reflect those constraints. Because the interpretation materially
-          affects eligibility, pricing, and forecasting, confirm it in
-          targeting_resolution.brief_targeting.
-        validations:
-          - check: response_schema
-            description: "Response matches get-products-response.json"
-          - check: field_present
-            path: "targeting_resolution.brief_targeting"
-            description: "Seller confirms material hard targeting inferred from prose"
-          - check: field_value
-            path: "products[0].is_custom"
-            value: true
-            description: "Hard brief targeting produces a request-specific configured product"
-          - check: field_present
-            path: "products[0].expires_at"
-            description: "Brief-targeted configured product is time-bound"
-          - check: field_value
-            path: "targeting_resolution.brief_targeting.geo_countries[0]"
-            value: "US"
-            description: "Brief confirmation preserves the hard US-only requirement"
-          - check: field_value
-            path: "targeting_resolution.brief_targeting.demographics.age.min"
-            value: 18
-            description: "Brief confirmation preserves the requested minimum age"
-          - check: field_value
-            path: "targeting_resolution.brief_targeting.demographics.age.max"
-            value: 44
-            description: "Brief confirmation preserves the requested maximum age"
-
-  - id: exact_targeting_discovery
-    title: "Discover an exact configured product without targeting echo"
-    steps:
-      - id: get_exact_targeted_product
-        title: "Provide real US and placement targeting plus future DMA support"
-        task: get_products
-        schema_ref: "media-buy/get-products-request.json"
-        response_schema_ref: "media-buy/get-products-response.json"
-        doc_ref: "/media-buy/task-reference/get_products"
-        stateful: true
-        sample_request:
-          buying_mode: "brief"
-          brief: "Premium video for outdoor enthusiasts"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          filters:
-            channels: ["olv"]
-            pricing_currencies: ["USD"]
-          targeting_overlay:
-            geo_countries: ["US"]
-            device_platform_exclude: ["fire_os"]
-            browser: ["chrome", "safari", "unknown"]
-            browser_exclude: ["safari"]
-            property_list:
-              agent_url: "https://governance.pinnacle-agency.example"
-              list_id: "acme_outdoor_allowlist_v1"
-            collection_list:
-              agent_url: "https://governance.pinnacle-agency.example"
-              list_id: "acme_outdoor_collections_v1"
-            placement_selection:
-              mode: "selected"
-              placement_refs:
-                - publisher_domain: "pinnacle-media.example"
-                  placement_id: "feed"
-          required_overlay_support:
-            geo_countries: true
-            geo_countries_exclude: true
-            geo_proximity:
-              radius: true
-            geo_metros:
-              systems: ["nielsen_dma"]
-            placement_selection: true
-            property_list: true
-            collection_list: true
-            device_platform_exclude: true
-            browser:
-              families: ["chrome", "firefox"]
-            browser_exclude:
-              families: ["unknown"]
-            keyword_targets:
-              supported_match_types: ["exact"]
-          context:
-            correlation_id: "targeting_aware_discovery--exact"
-        expected: |
-          Return one configured product whose price and availability forecast
-          are scoped to US feed inventory, the selected property and collection
-          lists, the Fire OS exclusion, and Chrome or unclassified browser
-          traffic with Safari excluded. Exact acceptance omits
-          targeting_resolution. overlay_support confirms later country,
-          radius-proximity, DMA, placement, property-list, collection-list,
-          platform, and independent browser inclusion/exclusion control without
-          returning one product per possible value. Country and proximity
-          cardinality limits are disclosed after capability matching.
-        context_outputs:
-          - key: "exact_product_id"
-            path: "products[0].product_id"
-          - key: "exact_pricing_option_id"
-            path: "products[0].pricing_options[0].pricing_option_id"
-        validations:
-          - check: response_schema
-            description: "Response matches get-products-response.json"
-          - check: field_absent
-            path: "products[0].targeting_resolution"
-            description: "Exact targeting acceptance has no echo"
-          - check: field_value
-            path: "products[0].is_custom"
-            value: true
-            description: "Exact request-bound targeting is a configured custom product"
-          - check: field_present
-            path: "products[0].expires_at"
-            description: "Exact configured product is time-bound even without a resolution echo"
-          - check: field_present
-            path: "products[0].forecast"
-            description: "Forecast is present for the effective targeting"
-          - check: field_present
-            path: "products[0].overlay_support.geo_metros"
-            description: "Product supports later Nielsen DMA targeting as requested"
-          - check: field_value
-            path: "products[0].overlay_support.geo_countries.max_values_per_package"
-            value: 1
-            description: "Country inclusion support discloses its per-package cardinality limit"
-          - check: field_value
-            path: "products[0].overlay_support.geo_countries_exclude.max_values_per_package"
-            value: 1
-            description: "Country exclusion support independently discloses its per-package cardinality limit"
-          - check: field_value
-            path: "products[0].overlay_support.geo_proximity.max_values_per_package"
-            value: 1
-            description: "Radius proximity support discloses its per-package entry limit"
-          - check: field_value
-            path: "products[0].overlay_support.placement_selection.max_values_per_package"
-            value: 2
-            description: "A true requirement matches constrained object support; seller limits are disclosed after matching"
-          - check: field_value
-            path: "products[0].overlay_support.keyword_targets"
-            value: true
-            description: "Unrestricted true support satisfies an object requirement for exact keyword matching"
-          - check: field_value
-            path: "products[0].overlay_support.property_list"
-            value: true
-            description: "Product supports later property-list selection"
-          - check: field_value
-            path: "products[0].overlay_support.device_platform_exclude"
-            value: true
-            description: "Platform exclusion support is declared independently"
-          - check: field_value
-            path: "products[0].overlay_support.browser"
-            value:
-              families: ["chrome", "safari", "firefox", "unknown"]
-            description: "Required later browser inclusion support is declared by family"
-          - check: field_value
-            path: "products[0].overlay_support.browser_exclude"
-            value:
-              families: ["chrome", "safari", "firefox", "unknown"]
-            description: "Required later browser exclusion support is declared independently"
-
-      - id: get_unsupported_future_targeting
-        title: "Exclude products that lack a required future dimension"
-        task: get_products
-        schema_ref: "media-buy/get-products-request.json"
-        response_schema_ref: "media-buy/get-products-response.json"
-        doc_ref: "/media-buy/task-reference/get_products"
-        stateful: true
-        sample_request:
-          buying_mode: "brief"
-          brief: "Premium video for outdoor enthusiasts"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          filters:
-            channels: ["olv"]
-          required_overlay_support:
-            geo_proximity:
-              travel_time: true
-          context:
-            correlation_id: "targeting_aware_discovery--unsupported_support"
-        expected: |
-          Return no products because the seeded product does not declare
-          selectable travel-time proximity targeting. Missing required support
-          is an exclusion, never a false-positive product match.
-        validations:
-          - check: response_schema
-            description: "Response matches get-products-response.json"
-          - check: field_value
-            path: "products"
-            value: []
-            description: "Unsupported future targeting excludes every product"
-
-  - id: inherent_fixed_placement_lifecycle
-    title: "Restate a fixed placement set exactly without selectable support"
-    steps:
-      - id: exclude_partial_fixed_placement_set
-        title: "Exclude a fixed product for a partial placement request"
-        task: get_products
-        schema_ref: "media-buy/get-products-request.json"
-        response_schema_ref: "media-buy/get-products-response.json"
-        doc_ref: "/media-buy/task-reference/get_products"
-        stateful: false
-        sample_request:
-          buying_mode: "wholesale"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          filters:
-            channels: ["ctv"]
-          targeting_overlay:
-            placement_selection:
-              mode: "selected"
-              placement_refs:
-                - publisher_domain: "pinnacle-media.example"
-                  placement_id: "feed"
-          context:
-            correlation_id: "targeting_aware_discovery--partial_fixed_placement"
-        expected: |
-          Return no products. One placement is not equal to the fixed product's
-          complete included set, and the product exposes no independently
-          selectable placement support.
-        validations:
-          - check: response_schema
-            description: "Response matches get-products-response.json"
-          - check: field_value
-            path: "products"
-            value: []
-            description: "Partial fixed placement selection is not an inherent match"
-
-      - id: discover_fixed_placement_set
-        title: "Discover a product by its complete included placement set"
-        task: get_products
-        schema_ref: "media-buy/get-products-request.json"
-        response_schema_ref: "media-buy/get-products-response.json"
-        doc_ref: "/media-buy/task-reference/get_products"
-        stateful: true
-        sample_request:
-          buying_mode: "wholesale"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          filters:
-            channels: ["ctv"]
-          targeting_overlay:
-            placement_selection:
-              mode: "selected"
-              placement_refs:
-                - publisher_domain: "pinnacle-media.example"
-                  placement_id: "feed"
-                - publisher_domain: "pinnacle-media.example"
-                  placement_id: "short_video"
-          context:
-            correlation_id: "targeting_aware_discovery--fixed_placement"
-        expected: |
-          Return the fixed CTV product because the requested placement set
-          exactly equals its complete mode: included set. This is inherent
-          equality, not independent placement selection, so the product does
-          not advertise overlay_support.placement_selection.
-        context_outputs:
-          - key: "fixed_product_id"
-            path: "products[0].product_id"
-          - key: "fixed_pricing_option_id"
-            path: "products[0].pricing_options[0].pricing_option_id"
-        validations:
-          - check: response_schema
-            description: "Response matches get-products-response.json"
-          - check: field_value
-            path: "products[0].product_id"
-            value: "targeting_aware_fixed_placement"
-            description: "The complete fixed placement set matches inherently"
-          - check: field_absent
-            path: "products[0].overlay_support.placement_selection"
-            description: "Exact inherent equality does not manufacture selectable support"
-
-      - id: create_fixed_placement_set
-        title: "Create with the same complete fixed placement set"
-        task: create_media_buy
-        schema_ref: "media-buy/create-media-buy-request.json"
-        response_schema_ref: "media-buy/create-media-buy-response.json"
-        doc_ref: "/media-buy/task-reference/create_media_buy"
-        stateful: true
-        sample_request:
-          brand:
-            domain: "acmeoutdoor.example"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          idempotency_key: "$generate:uuid_v4#targeting_aware_fixed_placement_create"
-          start_time: "asap"
-          end_time: "2099-09-30T23:59:59Z"
-          packages:
-            - product_id: "$context.fixed_product_id"
-              pricing_option_id: "$context.fixed_pricing_option_id"
-              bid_price: 14.0
-              budget: 5000
-              targeting_overlay:
-                placement_selection:
-                  mode: "selected"
-                  placement_refs:
-                    - publisher_domain: "pinnacle-media.example"
-                      placement_id: "feed"
-                    - publisher_domain: "pinnacle-media.example"
-                      placement_id: "short_video"
-        expected: |
-          Accept the exact fixed placement restatement without selectable
-          placement support and echo the complete committed set.
-        context_outputs:
-          - key: "fixed_media_buy_id"
-            path: "media_buy_id"
-          - key: "fixed_package_id"
-            path: "packages[0].package_id"
-        validations:
-          - check: response_schema
-            description: "Response matches create-media-buy-response.json"
-          - check: field_contains
-            path: "packages[0].targeting_overlay.placement_selection.placement_refs[*]"
-            value:
-              publisher_domain: "pinnacle-media.example"
-              placement_id: "feed"
-            description: "Create echoes the fixed feed placement without assuming order"
-          - check: field_contains
-            path: "packages[0].targeting_overlay.placement_selection.placement_refs[*]"
-            value:
-              publisher_domain: "pinnacle-media.example"
-              placement_id: "short_video"
-            description: "Create echoes the fixed short-video placement without assuming order"
-          - check: field_absent
-            path: "packages[0].targeting_overlay.placement_selection.placement_refs[2]"
-            description: "Create does not silently widen the complete two-placement set"
-
-      - id: reject_partial_fixed_placement_create
-        title: "Reject partial fixed placement selection on create"
-        task: create_media_buy
-        schema_ref: "media-buy/create-media-buy-request.json"
-        response_schema_ref: "media-buy/create-media-buy-response.json"
-        doc_ref: "/media-buy/task-reference/create_media_buy"
-        expect_error: true
-        negative_path: payload_well_formed
-        stateful: true
-        sample_request:
-          brand:
-            domain: "acmeoutdoor.example"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          idempotency_key: "$generate:uuid_v4#targeting_aware_fixed_placement_partial_create"
-          start_time: "asap"
-          end_time: "2099-09-30T23:59:59Z"
-          packages:
-            - product_id: "$context.fixed_product_id"
-              pricing_option_id: "$context.fixed_pricing_option_id"
-              bid_price: 14.0
-              budget: 5000
-              targeting_overlay:
-                placement_selection:
-                  mode: "selected"
-                  placement_refs:
-                    - publisher_domain: "pinnacle-media.example"
-                      placement_id: "feed"
-        expected: |
-          Reject with UNSUPPORTED_FEATURE. Partial selection requires a
-          separately selectable product; the fixed product cannot silently
-          widen the package to its complete set.
-        validations:
-          - check: error_code
-            value: "UNSUPPORTED_FEATURE"
-            description: "Create rejects partial selection on fixed inventory"
-
-      - id: reject_partial_fixed_placement_update
-        title: "Reject partial fixed placement selection on update"
-        task: update_media_buy
-        schema_ref: "media-buy/update-media-buy-request.json"
-        response_schema_ref: "media-buy/update-media-buy-response.json"
-        doc_ref: "/media-buy/task-reference/update_media_buy"
-        expect_error: true
-        negative_path: payload_well_formed
-        stateful: true
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          media_buy_id: "$context.fixed_media_buy_id"
-          idempotency_key: "$generate:uuid_v4#targeting_aware_fixed_placement_partial_update"
-          packages:
-            - package_id: "$context.fixed_package_id"
-              targeting_overlay:
-                placement_selection:
-                  mode: "selected"
-                  placement_refs:
-                    - publisher_domain: "pinnacle-media.example"
-                      placement_id: "feed"
-        expected: |
-          Reject atomically with UNSUPPORTED_FEATURE and retain the prior
-          complete fixed set. The fixed product has no placement-selection
-          capability.
-        validations:
-          - check: error_code
-            value: "UNSUPPORTED_FEATURE"
-            description: "Update rejects partial selection on fixed inventory"
-
-      - id: read_fixed_placement_after_rejected_update
-        title: "Verify rejected partial update was atomic"
-        task: get_media_buys
-        schema_ref: "media-buy/get-media-buys-request.json"
-        response_schema_ref: "media-buy/get-media-buys-response.json"
-        doc_ref: "/media-buy/task-reference/get_media_buys"
-        stateful: true
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          media_buy_ids: ["$context.fixed_media_buy_id"]
-        expected: |
-          Return the unchanged complete fixed placement set. The rejected
-          partial update must not remove one placement, append inventory, or
-          require a later successful update to repair state.
-        validations:
-          - check: response_schema
-            description: "Response matches get-media-buys-response.json"
-          - check: field_equals_context
-            path: "media_buys[0].media_buy_id"
-            context_key: "fixed_media_buy_id"
-            description: "Readback is grounded to the fixed media buy"
-          - check: field_equals_context
-            path: "media_buys[0].packages[0].package_id"
-            context_key: "fixed_package_id"
-            description: "Readback is grounded to the fixed package"
-          - check: field_contains
-            path: "media_buys[0].packages[0].targeting_overlay.placement_selection.placement_refs[*]"
-            value:
-              publisher_domain: "pinnacle-media.example"
-              placement_id: "feed"
-            description: "Rejected update retains the feed placement"
-          - check: field_contains
-            path: "media_buys[0].packages[0].targeting_overlay.placement_selection.placement_refs[*]"
-            value:
-              publisher_domain: "pinnacle-media.example"
-              placement_id: "short_video"
-            description: "Rejected update retains the short-video placement"
-          - check: field_absent
-            path: "media_buys[0].packages[0].targeting_overlay.placement_selection.placement_refs[2]"
-            description: "Rejected update does not widen the two-placement set"
-
-      - id: update_fixed_placement_set
-        title: "Restate the same fixed set on update"
-        task: update_media_buy
-        schema_ref: "media-buy/update-media-buy-request.json"
-        response_schema_ref: "media-buy/update-media-buy-response.json"
-        doc_ref: "/media-buy/task-reference/update_media_buy"
-        stateful: true
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          media_buy_id: "$context.fixed_media_buy_id"
-          idempotency_key: "$generate:uuid_v4#targeting_aware_fixed_placement_update"
-          packages:
-            - package_id: "$context.fixed_package_id"
-              targeting_overlay:
-                placement_selection:
-                  mode: "selected"
-                  placement_refs:
-                    - publisher_domain: "pinnacle-media.example"
-                      placement_id: "feed"
-                    - publisher_domain: "pinnacle-media.example"
-                      placement_id: "short_video"
-        expected: |
-          Accept the same inherent set under update_targeting. Partial selection
-          would require a separately selectable product and be rejected.
-        validations:
-          - check: response_schema
-            description: "Response matches update-media-buy-response.json"
-          - check: field_contains
-            path: "affected_packages[*]"
-            value:
-              package_id: "$context.fixed_package_id"
-              targeting_overlay:
-                placement_selection:
-                  mode: "selected"
-            description: "Update accepts the exact fixed placement restatement"
-          - check: field_contains
-            path: "affected_packages[*].targeting_overlay.placement_selection.placement_refs[*]"
-            value:
-              publisher_domain: "pinnacle-media.example"
-              placement_id: "feed"
-            description: "Update echoes the feed placement without assuming order"
-          - check: field_contains
-            path: "affected_packages[*].targeting_overlay.placement_selection.placement_refs[*]"
-            value:
-              publisher_domain: "pinnacle-media.example"
-              placement_id: "short_video"
-            description: "Update echoes the short-video placement without assuming order"
-          - check: field_absent
-            path: "affected_packages[0].targeting_overlay.placement_selection.placement_refs[2]"
-            description: "Update does not silently widen the complete two-placement set"
-
-  - id: expired_configured_product
-    title: "Reject a recognized expired configured product deterministically"
-    steps:
-      - id: create_expired_configured_product
-        title: "Attempt to buy an already-expired seeded configuration"
-        task: create_media_buy
-        schema_ref: "media-buy/create-media-buy-request.json"
-        response_schema_ref: "media-buy/create-media-buy-response.json"
-        doc_ref: "/media-buy/task-reference/create_media_buy"
-        expect_error: true
-        negative_path: payload_well_formed
-        stateful: true
-        sample_request:
-          brand:
-            domain: "acmeoutdoor.example"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          idempotency_key: "$generate:uuid_v4#targeting_aware_expired_create"
-          start_time: "asap"
-          end_time: "2099-09-30T23:59:59Z"
-          packages:
-            - product_id: "targeting_aware_expired_configured"
-              pricing_option_id: "targeting_aware_expired_cpm"
-              bid_price: 14.0
-              budget: 5000
-        expected: |
-          Reject with PRODUCT_EXPIRED because the controller retains a
-          tombstone for this issued configured ID. The test uses a fixed past
-          timestamp and does not depend on sleeps or wall-clock races.
-        validations:
-          - check: error_code
-            value: "PRODUCT_EXPIRED"
-            description: "A recognized expired configured product uses PRODUCT_EXPIRED"
-
-  - id: modified_targeting_discovery
-    title: "Accept sparse demographic and browser alternatives through product selection"
-    steps:
-      - id: get_modified_age_product
-        title: "Request an age range the product cannot execute exactly"
-        task: get_products
-        schema_ref: "media-buy/get-products-request.json"
-        response_schema_ref: "media-buy/get-products-response.json"
-        doc_ref: "/media-buy/task-reference/get_products"
-        stateful: true
-        sample_request:
-          buying_mode: "brief"
-          brief: "Premium video for adults"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          targeting_overlay:
-            demographics:
-              age: { min: 21, max: 35, include_unknown: false }
-            browser: ["chrome", "safari"]
-          context:
-            correlation_id: "targeting_aware_discovery--modified_age"
-        expected: |
-          Return a distinct configured product proposing ages 25–34 and
-          removing Safari because only Chrome has forecastable inventory for
-          the requested discovery scope. The ordered sparse resolution changes only
-          /demographics/age and /browser, expires_at bounds the offer, and the
-          forecast reflects the resulting effective targeting.
-        context_outputs:
-          - key: "modified_product_id"
-            path: "products[0].product_id"
-          - key: "modified_pricing_option_id"
-            path: "products[0].pricing_options[0].pricing_option_id"
-        validations:
-          - check: response_schema
-            description: "Response matches get-products-response.json"
-          - check: field_value
-            path: "products[0].targeting_resolution.modifications[0].operation"
-            value: "replace"
-            description: "Seller returns a sparse replacement"
-          - check: field_value
-            path: "products[0].targeting_resolution.modifications[0].path"
-            value: "/demographics/age"
-            description: "Modification points to the age predicate"
-          - check: field_value
-            path: "products[0].targeting_resolution.modifications[0].applied"
-            value: { min: 25, max: 34, include_unknown: false }
-            description: "Configured age predicate is 25–34 with unknown ages excluded"
-          - check: field_value
-            path: "products[0].targeting_resolution.modifications[1].operation"
-            value: "remove_values"
-            description: "Browser set changes use the sparse set operation"
-          - check: field_value
-            path: "products[0].targeting_resolution.modifications[1].path"
-            value: "/browser"
-            description: "Browser modification targets the complete browser-family set"
-          - check: field_contains
-            path: "products[0].targeting_resolution.modifications[1].values[*]"
-            value: "safari"
-            description: "The configured offer visibly removes Safari"
-          - check: field_present
-            path: "products[0].expires_at"
-            description: "Modified configured product is time-bound"
-      - id: create_from_modified_product
-        title: "Purchase the configured product without repeating discovery targeting"
-        task: create_media_buy
-        schema_ref: "media-buy/create-media-buy-request.json"
-        response_schema_ref: "media-buy/create-media-buy-response.json"
-        doc_ref: "/media-buy/task-reference/create_media_buy"
-        stateful: true
-        sample_request:
-          brand:
-            domain: "acmeoutdoor.example"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          idempotency_key: "$generate:uuid_v4#targeting_aware_discovery_modified_create"
-          start_time: "asap"
-          end_time: "2099-09-30T23:59:59Z"
-          packages:
-            - product_id: "$context.modified_product_id"
-              pricing_option_id: "$context.modified_pricing_option_id"
-              bid_price: 14.0
-              budget: 5000
-        expected: |
-          Selecting the configured product accepts ages 25–34 and Chrome-only
-          browser targeting. The response package echoes complete effective
-          targeting and never stores equivalent false.
-        context_outputs:
-          - key: "modified_media_buy_id"
-            path: "media_buy_id"
-        validations:
-          - check: response_schema
-            description: "Response matches create-media-buy-response.json"
-          - check: field_value
-            path: "packages[0].targeting_overlay.demographics.age.min"
-            value: 25
-            description: "Accepted effective lower bound is echoed"
-          - check: field_value
-            path: "packages[0].targeting_overlay.demographics.age.max"
-            value: 34
-            description: "Accepted effective upper bound is echoed"
-          - check: field_value
-            path: "packages[0].targeting_overlay.browser[0]"
-            value: "chrome"
-            description: "Accepted effective browser family is echoed"
-          - check: field_absent
-            path: "packages[0].targeting_overlay.browser[1]"
-            description: "Removed Safari is not booked"
-          - check: field_value
-            path: "packages[0].targeting_resolution.demographics.equivalent"
-            value: true
-            description: "Booked predicate remains exact"
-
-  - id: inventory_targeting_lifecycle
-    title: "Persist purchased inventory and platform targeting through create and update"
-    steps:
-      - id: reject_country_exclusion_cardinality_on_create
-        title: "Reject too many country exclusions on create"
-        task: create_media_buy
-        schema_ref: "media-buy/create-media-buy-request.json"
-        response_schema_ref: "media-buy/create-media-buy-response.json"
-        doc_ref: "/media-buy/task-reference/create_media_buy"
-        expect_error: true
-        negative_path: payload_well_formed
-        stateful: true
-        sample_request:
-          brand:
-            domain: "acmeoutdoor.example"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          idempotency_key: "$generate:uuid_v4#targeting_aware_discovery_country_exclusion_create"
-          start_time: "asap"
-          end_time: "2099-09-30T23:59:59Z"
-          packages:
-            - product_id: "$context.exact_product_id"
-              pricing_option_id: "$context.exact_pricing_option_id"
-              bid_price: 14.0
-              budget: 5000
-              targeting_overlay:
-                geo_countries: ["US"]
-                geo_countries_exclude: ["CA", "MX"]
-                device_platform_exclude: ["fire_os"]
-                browser: ["chrome", "safari", "unknown"]
-                browser_exclude: ["safari"]
-                property_list:
-                  agent_url: "https://governance.pinnacle-agency.example"
-                  list_id: "acme_outdoor_allowlist_v1"
-                collection_list:
-                  agent_url: "https://governance.pinnacle-agency.example"
-                  list_id: "acme_outdoor_collections_v1"
-                placement_selection:
-                  mode: "selected"
-                  placement_refs:
-                    - publisher_domain: "pinnacle-media.example"
-                      placement_id: "feed"
-        expected: |
-          Reject with UNSUPPORTED_FEATURE before creating a media buy because
-          two country exclusions exceed the advertised one-value package
-          limit.
-        validations:
-          - check: error_code
-            value: "UNSUPPORTED_FEATURE"
-            description: "Create enforces the product's country exclusion limit"
-          - check: field_value
-            path: "errors[0].field"
-            value: "packages[0].targeting_overlay.geo_countries_exclude"
-            description: "Error.field identifies the overflowing exclusion field"
-
-      - id: create_feed_package
-        title: "Create from exact discovery result"
-        task: create_media_buy
-        schema_ref: "media-buy/create-media-buy-request.json"
-        response_schema_ref: "media-buy/create-media-buy-response.json"
-        doc_ref: "/media-buy/task-reference/create_media_buy"
-        stateful: true
-        sample_request:
-          brand:
-            domain: "acmeoutdoor.example"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          idempotency_key: "$generate:uuid_v4#targeting_aware_discovery_placement_create"
-          start_time: "asap"
-          end_time: "2099-09-30T23:59:59Z"
-          packages:
-            - product_id: "$context.exact_product_id"
-              pricing_option_id: "$context.exact_pricing_option_id"
-              bid_price: 14.0
-              budget: 5000
-        expected: |
-          The configured product retains the US, Fire OS exclusion, browser
-          inclusion/exclusion, property, collection, and feed targeting
-          accepted at discovery even though the buyer does not repeat it.
-        context_outputs:
-          - key: "placement_media_buy_id"
-            path: "media_buy_id"
-          - key: "placement_package_id"
-            path: "packages[0].package_id"
-        validations:
-          - check: response_schema
-            description: "Response matches create-media-buy-response.json"
-          - check: field_value
-            path: "packages[0].targeting_overlay.placement_selection.mode"
-            value: "selected"
-            description: "Purchased placement selection is echoed"
-          - check: field_value
-            path: "packages[0].targeting_overlay.placement_selection.placement_refs[0].placement_id"
-            value: "feed"
-            description: "Feed is the purchased placement"
-          - check: field_value
-            path: "packages[0].targeting_overlay.device_platform_exclude[0]"
-            value: "fire_os"
-            description: "Configured-product platform exclusion is booked without repetition"
-          - check: field_contains
-            path: "packages[0].targeting_overlay.browser[*]"
-            value: "chrome"
-            description: "Named Chrome traffic remains in the booked inclusion set"
-          - check: field_contains
-            path: "packages[0].targeting_overlay.browser[*]"
-            value: "safari"
-            description: "Overlapping Safari remains explicit in the booked inclusion set"
-          - check: field_contains
-            path: "packages[0].targeting_overlay.browser[*]"
-            value: "unknown"
-            description: "Explicitly eligible unclassifiable browsers remain in the booked inclusion set"
-          - check: field_absent
-            path: "packages[0].targeting_overlay.browser[3]"
-            description: "Booked browser inclusion has exactly the three requested families"
-          - check: field_contains
-            path: "packages[0].targeting_overlay.browser_exclude[*]"
-            value: "safari"
-            description: "Overlapping Safari exclusion is booked and wins during delivery"
-          - check: field_absent
-            path: "packages[0].targeting_overlay.browser_exclude[1]"
-            description: "Booked browser exclusion has exactly the one requested family"
-          - check: field_value
-            path: "packages[0].targeting_overlay.property_list.list_id"
-            value: "acme_outdoor_allowlist_v1"
-            description: "Configured-product property selection is booked without repetition"
-          - check: field_value
-            path: "packages[0].targeting_overlay.collection_list.list_id"
-            value: "acme_outdoor_collections_v1"
-            description: "Configured-product collection selection is booked without repetition"
-          - check: field_contains
-            path: "available_actions[*]"
-            value:
-              action: "update_targeting"
-              mode: "self_serve"
-            description: "Placement changes use the existing update_targeting authorization"
-
-      - id: update_to_short_video
-        title: "Replace purchased placement targeting"
-        task: update_media_buy
-        schema_ref: "media-buy/update-media-buy-request.json"
-        response_schema_ref: "media-buy/update-media-buy-response.json"
-        doc_ref: "/media-buy/task-reference/update_media_buy"
-        stateful: true
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          media_buy_id: "$context.placement_media_buy_id"
-          idempotency_key: "$generate:uuid_v4#targeting_aware_discovery_placement_update"
-          packages:
-            - package_id: "$context.placement_package_id"
-              targeting_overlay:
-                geo_countries: ["US"]
-                device_platform_exclude: ["fire_os"]
-                browser: ["chrome", "firefox"]
-                browser_exclude: ["unknown"]
-                property_list:
-                  agent_url: "https://governance.pinnacle-agency.example"
-                  list_id: "acme_outdoor_allowlist_v1"
-                collection_list:
-                  agent_url: "https://governance.pinnacle-agency.example"
-                  list_id: "acme_outdoor_collections_v1"
-                placement_selection:
-                  mode: "selected"
-                  placement_refs:
-                    - publisher_domain: "pinnacle-media.example"
-                      placement_id: "short_video"
-        expected: |
-          Apply the full overlay replacement atomically under update_targeting.
-          The response echoes short_video plus the later-selected Chrome or
-          Firefox inclusion and unknown-browser exclusion. This exercises the
-          independently advertised future browser capabilities. The seller
-          rejects rather than partially applying an invalid selection.
-        validations:
-          - check: response_schema
-            description: "Response matches update-media-buy-response.json"
-          - check: field_contains
-            path: "affected_packages[*]"
-            value:
-              package_id: "$context.placement_package_id"
-              targeting_overlay:
-                geo_countries: ["US"]
-                device_platform_exclude: ["fire_os"]
-                property_list:
-                  agent_url: "https://governance.pinnacle-agency.example"
-                  list_id: "acme_outdoor_allowlist_v1"
-                collection_list:
-                  agent_url: "https://governance.pinnacle-agency.example"
-                  list_id: "acme_outdoor_collections_v1"
-                placement_selection:
-                  mode: "selected"
-                  placement_refs:
-                    - publisher_domain: "pinnacle-media.example"
-                      placement_id: "short_video"
-            description: "Update response returns complete post-update placement targeting state"
-          - check: field_contains
-            path: "affected_packages[*].targeting_overlay.browser[*]"
-            value: "chrome"
-            description: "Update applies later-selected Chrome inclusion"
-          - check: field_contains
-            path: "affected_packages[*].targeting_overlay.browser[*]"
-            value: "firefox"
-            description: "Update applies later-selected Firefox inclusion"
-          - check: field_absent
-            path: "affected_packages[0].targeting_overlay.browser[2]"
-            description: "Update returns exactly two selected browser families"
-          - check: field_contains
-            path: "affected_packages[*].targeting_overlay.browser_exclude[*]"
-            value: "unknown"
-            description: "Update applies the later-selected unknown-browser exclusion"
-          - check: field_absent
-            path: "affected_packages[0].targeting_overlay.browser_exclude[1]"
-            description: "Update returns exactly one browser exclusion"
-
-      - id: reject_country_cardinality_overflow
-        title: "Reject more country values than the product supports"
-        task: update_media_buy
-        schema_ref: "media-buy/update-media-buy-request.json"
-        response_schema_ref: "media-buy/update-media-buy-response.json"
-        doc_ref: "/media-buy/task-reference/update_media_buy"
-        expect_error: true
-        negative_path: payload_well_formed
-        stateful: true
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          media_buy_id: "$context.placement_media_buy_id"
-          idempotency_key: "$generate:uuid_v4#targeting_aware_discovery_country_cardinality"
-          packages:
-            - package_id: "$context.placement_package_id"
-              targeting_overlay:
-                geo_countries: ["US", "CA"]
-                device_platform_exclude: ["fire_os"]
-                browser: ["chrome", "firefox"]
-                browser_exclude: ["unknown"]
-                property_list:
-                  agent_url: "https://governance.pinnacle-agency.example"
-                  list_id: "acme_outdoor_allowlist_v1"
-                collection_list:
-                  agent_url: "https://governance.pinnacle-agency.example"
-                  list_id: "acme_outdoor_collections_v1"
-                placement_selection:
-                  mode: "selected"
-                  placement_refs:
-                    - publisher_domain: "pinnacle-media.example"
-                      placement_id: "short_video"
-        expected: |
-          Reject atomically with UNSUPPORTED_FEATURE because two country values
-          exceed the advertised one-value package limit. The prior US-only
-          package targeting remains committed.
-        validations:
-          - check: error_code
-            value: "UNSUPPORTED_FEATURE"
-            description: "A package cannot exceed the product's disclosed country limit"
-          - check: field_value
-            path: "errors[0].field"
-            value: "packages[0].targeting_overlay.geo_countries"
-            description: "Error.field identifies the targeting field that exceeded its limit"
-
-      - id: read_after_rejected_country_overflow
-        title: "Verify rejected country update was atomic"
-        task: get_media_buys
-        schema_ref: "media-buy/get-media-buys-request.json"
-        response_schema_ref: "media-buy/get-media-buys-response.json"
-        doc_ref: "/media-buy/task-reference/get_media_buys"
-        stateful: true
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          media_buy_ids: ["$context.placement_media_buy_id"]
-        expected: |
-          Return the prior US-only package state immediately after the rejected
-          update, before any later successful targeting replacement can mask an
-          invalid partial mutation.
-        validations:
-          - check: response_schema
-            description: "Response matches get-media-buys-response.json"
-          - check: field_equals_context
-            path: "media_buys[0].packages[0].package_id"
-            context_key: "placement_package_id"
-            description: "Readback targets the package whose update was rejected"
-          - check: field_value
-            path: "media_buys[0].packages[0].targeting_overlay.geo_countries[0]"
-            value: "US"
-            description: "Rejected overflow left the committed country unchanged"
-          - check: field_absent
-            path: "media_buys[0].packages[0].targeting_overlay.geo_countries[1]"
-            description: "Rejected overflow did not append a second country"
-
-      - id: reject_incompatible_browser_platform
-        title: "Reject an incompatible browser and device combination"
-        task: update_media_buy
-        schema_ref: "media-buy/update-media-buy-request.json"
-        response_schema_ref: "media-buy/update-media-buy-response.json"
-        doc_ref: "/media-buy/task-reference/update_media_buy"
-        expect_error: true
-        negative_path: payload_well_formed
-        stateful: true
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          media_buy_id: "$context.placement_media_buy_id"
-          idempotency_key: "$generate:uuid_v4#targeting_aware_discovery_incompatible_browser_platform"
-          packages:
-            - package_id: "$context.placement_package_id"
-              targeting_overlay:
-                geo_countries: ["US"]
-                device_platform: ["android"]
-                device_platform_exclude: ["fire_os"]
-                browser: ["safari"]
-                browser_exclude: ["unknown"]
-                property_list:
-                  agent_url: "https://governance.pinnacle-agency.example"
-                  list_id: "acme_outdoor_allowlist_v1"
-                collection_list:
-                  agent_url: "https://governance.pinnacle-agency.example"
-                  list_id: "acme_outdoor_collections_v1"
-                placement_selection:
-                  mode: "selected"
-                  placement_refs:
-                    - publisher_domain: "pinnacle-media.example"
-                      placement_id: "short_video"
-        expected: |
-          Reject atomically with UNSUPPORTED_FEATURE because the seeded product
-          can classify both dimensions but cannot execute Safari on Android.
-          The prior Chrome-or-Firefox targeting remains committed.
-        validations:
-          - check: error_code
-            value: "UNSUPPORTED_FEATURE"
-            description: "An unenforceable browser and platform intersection is rejected"
-
-      - id: reject_cross_publisher_placement
-        title: "Reject a placement outside the product publisher scope"
-        task: update_media_buy
-        schema_ref: "media-buy/update-media-buy-request.json"
-        response_schema_ref: "media-buy/update-media-buy-response.json"
-        doc_ref: "/media-buy/task-reference/update_media_buy"
-        expect_error: true
-        negative_path: payload_well_formed
-        stateful: true
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          media_buy_id: "$context.placement_media_buy_id"
-          idempotency_key: "$generate:uuid_v4#targeting_aware_discovery_cross_publisher_update"
-          packages:
-            - package_id: "$context.placement_package_id"
-              targeting_overlay:
-                geo_countries: ["US"]
-                placement_selection:
-                  mode: "selected"
-                  placement_refs:
-                    - publisher_domain: "unrelated-publisher.example"
-                      placement_id: "feed"
-        expected: |
-          Reject the schema-valid but cross-publisher placement reference with
-          INVALID_REQUEST. The prior short_video selection remains committed.
-        validations:
-          - check: error_code
-            allowed_values: ["INVALID_REQUEST"]
-            description: "Cross-publisher placement identity is rejected"
-          - check: field_value
-            path: "errors[0].field"
-            value: "packages[0].targeting_overlay.placement_selection.placement_refs[0]"
-            description: "Error.field identifies the invalid placement reference"
-
-      - id: reject_duplicate_placement
-        title: "Reject duplicate placement references"
-        task: update_media_buy
-        schema_ref: "media-buy/update-media-buy-request.json"
-        response_schema_ref: "media-buy/update-media-buy-response.json"
-        doc_ref: "/media-buy/task-reference/update_media_buy"
-        expect_error: true
-        negative_path: schema_invalid
-        stateful: true
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          media_buy_id: "$context.placement_media_buy_id"
-          idempotency_key: "$generate:uuid_v4#targeting_aware_discovery_duplicate_placement_update"
-          packages:
-            - package_id: "$context.placement_package_id"
-              targeting_overlay:
-                geo_countries: ["US"]
-                placement_selection:
-                  mode: "selected"
-                  placement_refs:
-                    - publisher_domain: "pinnacle-media.example"
-                      placement_id: "feed"
-                    - publisher_domain: "pinnacle-media.example"
-                      placement_id: "feed"
-        expected: |
-          Reject with INVALID_REQUEST because placement_selection is a set and
-          duplicate references violate its uniqueItems schema constraint. The
-          prior short_video selection remains committed.
-        validations:
-          - check: error_code
-            allowed_values: ["INVALID_REQUEST"]
-            description: "Duplicate placement references are rejected"
-
-      - id: update_to_single_proximity
-        title: "Add one supported radius target"
-        task: update_media_buy
-        schema_ref: "media-buy/update-media-buy-request.json"
-        response_schema_ref: "media-buy/update-media-buy-response.json"
-        doc_ref: "/media-buy/task-reference/update_media_buy"
-        stateful: true
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          media_buy_id: "$context.placement_media_buy_id"
-          idempotency_key: "$generate:uuid_v4#targeting_aware_discovery_single_proximity"
-          packages:
-            - package_id: "$context.placement_package_id"
-              targeting_overlay:
-                geo_countries: ["US"]
-                geo_proximity:
-                  - lat: 40.7128
-                    lng: -74.006
-                    label: "North venue"
-                    radius: { value: 5, unit: "km" }
-                device_platform_exclude: ["fire_os"]
-                browser: ["chrome", "firefox"]
-                browser_exclude: ["unknown"]
-                property_list:
-                  agent_url: "https://governance.pinnacle-agency.example"
-                  list_id: "acme_outdoor_allowlist_v1"
-                collection_list:
-                  agent_url: "https://governance.pinnacle-agency.example"
-                  list_id: "acme_outdoor_collections_v1"
-                placement_selection:
-                  mode: "selected"
-                  placement_refs:
-                    - publisher_domain: "pinnacle-media.example"
-                      placement_id: "short_video"
-        expected: |
-          Accept one radius entry because it is within the Product's
-          advertised one-entry package limit.
-        validations:
-          - check: response_schema
-            description: "Response matches update-media-buy-response.json"
-          - check: field_contains
-            path: "affected_packages[*]"
-            value:
-              package_id: "$context.placement_package_id"
-              targeting_overlay:
-                geo_proximity:
-                  - lat: 40.7128
-                    lng: -74.006
-                    label: "North venue"
-                    radius: { value: 5, unit: "km" }
-            description: "Update echoes the accepted one-entry proximity target"
-          - check: field_absent
-            path: "affected_packages[0].targeting_overlay.geo_proximity[1]"
-            description: "Accepted proximity targeting has exactly one entry"
-
-      - id: reject_proximity_cardinality_overflow
-        title: "Reject more proximity entries than the product supports"
-        task: update_media_buy
-        schema_ref: "media-buy/update-media-buy-request.json"
-        response_schema_ref: "media-buy/update-media-buy-response.json"
-        doc_ref: "/media-buy/task-reference/update_media_buy"
-        expect_error: true
-        negative_path: payload_well_formed
-        stateful: true
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          media_buy_id: "$context.placement_media_buy_id"
-          idempotency_key: "$generate:uuid_v4#targeting_aware_discovery_proximity_cardinality"
-          packages:
-            - package_id: "$context.placement_package_id"
-              targeting_overlay:
-                geo_countries: ["US"]
-                geo_proximity:
-                  - lat: 40.7128
-                    lng: -74.006
-                    label: "North venue"
-                    radius: { value: 5, unit: "km" }
-                  - lat: 34.0522
-                    lng: -118.2437
-                    label: "South venue"
-                    radius: { value: 5, unit: "km" }
-                device_platform_exclude: ["fire_os"]
-                browser: ["chrome", "firefox"]
-                browser_exclude: ["unknown"]
-                property_list:
-                  agent_url: "https://governance.pinnacle-agency.example"
-                  list_id: "acme_outdoor_allowlist_v1"
-                collection_list:
-                  agent_url: "https://governance.pinnacle-agency.example"
-                  list_id: "acme_outdoor_collections_v1"
-                placement_selection:
-                  mode: "selected"
-                  placement_refs:
-                    - publisher_domain: "pinnacle-media.example"
-                      placement_id: "short_video"
-        expected: |
-          Reject atomically with UNSUPPORTED_FEATURE because two proximity
-          entries exceed the advertised one-entry package limit. The accepted
-          North venue radius remains committed.
-        validations:
-          - check: error_code
-            value: "UNSUPPORTED_FEATURE"
-            description: "A package cannot exceed the product's disclosed proximity limit"
-          - check: field_value
-            path: "errors[0].field"
-            value: "packages[0].targeting_overlay.geo_proximity"
-            description: "Error.field identifies the overflowing proximity field"
-
-      - id: read_updated_placement
-        title: "Verify purchased placement state"
-        task: get_media_buys
-        schema_ref: "media-buy/get-media-buys-request.json"
-        response_schema_ref: "media-buy/get-media-buys-response.json"
-        doc_ref: "/media-buy/task-reference/get_media_buys"
-        stateful: true
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            operator_unit:
-              id: "compliance-media_buy_seller_targeting_aware_dis-5e7f1651"
-            sandbox: true
-          media_buy_ids: ["$context.placement_media_buy_id"]
-        expected: |
-          Return complete effective targeting with short_video selected. The
-          stored package does not expose a separate effective-placement source
-          of truth. All five rejected updates were atomic and left this state
-          unchanged.
-        validations:
-          - check: response_schema
-            description: "Response matches get-media-buys-response.json"
-          - check: field_equals_context
-            path: "media_buys[0].media_buy_id"
-            context_key: "placement_media_buy_id"
-            description: "Readback returns the media buy created from the configured product"
-          - check: field_equals_context
-            path: "media_buys[0].packages[0].package_id"
-            context_key: "placement_package_id"
-            description: "Readback targeting belongs to the package created earlier"
-          - check: field_value
-            path: "media_buys[0].packages[0].targeting_overlay.placement_selection.mode"
-            value: "selected"
-            description: "Readback uses committed selected mode"
-          - check: field_value
-            path: "media_buys[0].packages[0].targeting_overlay.placement_selection.placement_refs[0].placement_id"
-            value: "short_video"
-            description: "Readback preserves purchased placement identity"
-          - check: field_value
-            path: "media_buys[0].packages[0].targeting_overlay.device_platform_exclude[0]"
-            value: "fire_os"
-            description: "Readback preserves the purchased platform exclusion"
-          - check: field_value
-            path: "media_buys[0].packages[0].targeting_overlay.geo_countries[0]"
-            value: "US"
-            description: "Rejected country overflow left the committed country unchanged"
-          - check: field_absent
-            path: "media_buys[0].packages[0].targeting_overlay.geo_countries[1]"
-            description: "Rejected country overflow did not append a second country"
-          - check: field_value
-            path: "media_buys[0].packages[0].targeting_overlay.geo_proximity[0].radius.value"
-            value: 5
-            description: "Readback preserves the accepted one-entry radius target"
-          - check: field_absent
-            path: "media_buys[0].packages[0].targeting_overlay.geo_proximity[1]"
-            description: "Rejected proximity overflow did not append a second entry"
-          - check: field_contains
-            path: "media_buys[0].packages[0].targeting_overlay.browser[*]"
-            value: "chrome"
-            description: "Readback preserves later-selected Chrome inclusion"
-          - check: field_contains
-            path: "media_buys[0].packages[0].targeting_overlay.browser[*]"
-            value: "firefox"
-            description: "Readback preserves later-selected browser inclusion"
-          - check: field_absent
-            path: "media_buys[0].packages[0].targeting_overlay.browser[2]"
-            description: "Readback browser inclusion has exactly two families"
-          - check: field_contains
-            path: "media_buys[0].packages[0].targeting_overlay.browser_exclude[*]"
-            value: "unknown"
-            description: "Readback preserves later-selected browser exclusion"
-          - check: field_absent
-            path: "media_buys[0].packages[0].targeting_overlay.browser_exclude[1]"
-            description: "Readback browser exclusion has exactly one family"
-          - check: field_value
-            path: "media_buys[0].packages[0].targeting_overlay.property_list.list_id"
-            value: "acme_outdoor_allowlist_v1"
-            description: "Readback preserves the purchased property selection"
-          - check: field_value
-            path: "media_buys[0].packages[0].targeting_overlay.collection_list.list_id"
-            value: "acme_outdoor_collections_v1"
-            description: "Readback preserves the purchased collection selection"