@adcp/sdk 5.23.0 → 5.25.0

package/compliance/cache/3.0.1.previous/specialisms/sales-broadcast-tv/index.yaml

@@ -1,689 +0,0 @@
-id: sales_broadcast_tv
-version: "1.0.0"
-title: "Broadcast linear TV seller agent"
-protocol: media-buy
-category: sales_broadcast_tv
-summary: "Seller agent for broadcast linear TV inventory — primetime and fringe spots with measurement windows, agency estimate numbers, Ad-ID-based creative sync, and delayed delivery reporting."
-track: media_buy
-required_tools:
-  - get_products
-  - create_media_buy
-requires_scenarios:
-  - media_buy_seller/refine_products
-  - media_buy_seller/delivery_reporting
-  - media_buy_seller/measurement_terms_rejected
-  - media_buy_seller/pending_creatives_to_start
-  - media_buy_seller/inventory_list_targeting
-  - media_buy_seller/inventory_list_no_match
-  - media_buy_seller/invalid_transitions
-
-# Cross-step assertion (adcp#2664). status.monotonic rejects resource
-# status transitions observed across steps that aren't on the spec
-# lifecycle graph — e.g. active → pending_creatives on a media_buy.
-invariants:
-  - status.monotonic
-
-narrative: |
-  You run a broadcast television platform — a local TV station group, network affiliate,
-  or television rep firm that sells linear advertising inventory. A buyer agent connects
-  to discover your dayparts and programs, negotiate guaranteed buys, sync broadcast spot
-  files, and monitor delivery against measurement windows.
-
-  Broadcast buying differs from digital in several ways. Products are organized by daypart
-  and program rather than audience segment. Pricing is unit-based (cost per spot) rather
-  than impression-based. Measurement accumulates over time through Live, C3, and C7
-  windows as DVR playback is counted. Creative assets are broadcast-grade video files
-  identified by Ad-ID — no VAST wrappers, no impression trackers, no click URLs.
-
-  Delivery data arrives on a delay. Live ratings are available within a day, but C3 and
-  C7 data take 4 and 8 days respectively after broadcast. Final reconciliation happens
-  against C7 numbers, which means billing data is not complete until ~15 days after the
-  last air date.
-
-  This storyboard walks through the broadcast buying cycle from product discovery through
-  reconciliation, exercising the protocol fields that distinguish linear TV from digital.
-
-agent:
-  interaction_model: media_buy_seller
-  capabilities:
-    - sells_media
-    - accepts_briefs
-    - supports_guaranteed
-  examples:
-    - "Local TV station groups"
-    - "Broadcast network affiliates"
-    - "Television rep firms"
-
-caller:
-  role: buyer_agent
-  example: "Pinnacle Agency"
-
-prerequisites:
-  description: |
-    The caller needs an established account relationship with the seller. The test
-    kit provides the Nova Motors Volta EV launch campaign — an automotive brand with
-    national broadcast reach goals and budget appropriate for primetime linear TV.
-  test_kit: "test-kits/nova-motors.yaml"
-  controller_seeding: true
-
-fixtures:
-  products:
-    - product_id: "primetime_30s_mf"
-      delivery_type: "guaranteed"
-      channels: ["video"]
-      format_ids:
-        - id: "broadcast_spot_30s"
-    - product_id: "late_fringe_15s_mf"
-      delivery_type: "guaranteed"
-      channels: ["video"]
-      format_ids:
-        - id: "broadcast_spot_15s"
-  pricing_options:
-    - product_id: "primetime_30s_mf"
-      pricing_option_id: "unit_primetime_30"
-      pricing_model: "flat_rate"
-      currency: "USD"
-      fixed_price: 4500.0
-    - product_id: "late_fringe_15s_mf"
-      pricing_option_id: "unit_fringe_15"
-      pricing_model: "flat_rate"
-      currency: "USD"
-      fixed_price: 1200.0
-
-phases:
-  - id: capability_discovery
-    title: "Capability discovery"
-    narrative: |
-      The buyer calls get_adcp_capabilities to confirm the agent supports media buying before sending briefs or creating buys.
-
-    steps:
-      - id: get_capabilities
-        title: "Check agent capabilities"
-        narrative: |
-          Verify that the agent declares the expected protocol support before
-          proceeding with domain-specific operations.
-        task: get_adcp_capabilities
-        schema_ref: "protocol/get-adcp-capabilities-request.json"
-        response_schema_ref: "protocol/get-adcp-capabilities-response.json"
-        doc_ref: "/protocol/get_adcp_capabilities"
-        comply_scenario: capability_discovery
-        stateful: false
-        expected: |
-          Return capabilities declaring media_buy in supported_protocols, confirming the agent sells media.
-        sample_request:
-          context:
-            correlation_id: "sales_broadcast_tv--get_capabilities"
-        validations:
-          - check: response_schema
-            description: "Response matches get-adcp-capabilities-response.json schema"
-          - check: field_present
-            path: "supported_protocols"
-            description: "Agent declares supported protocols"
-
-          - check: field_present
-            path: "context"
-            description: "Response echoes back the context object"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "sales_broadcast_tv--get_capabilities"
-            description: "Context correlation_id returned unchanged"
-  - id: product_discovery
-    title: "Product discovery"
-    narrative: |
-      The buyer sends a brief describing what they want to buy on linear TV. The seller
-      interprets the brief against their program schedule, ratings estimates, and
-      available inventory to return products organized by daypart.
-
-      Broadcast products include measurement windows — Live, C3, and C7 — that describe
-      how ratings data accumulates over time. The buyer uses these windows to understand
-      when delivery data will be available and which window will serve as the guarantee
-      basis for reconciliation.
-
-    steps:
-      - id: get_products_brief
-        title: "Send a broadcast brief"
-        narrative: |
-          The buyer describes their linear TV goals in natural language. The seller
-          returns products representing available dayparts and programs, each with
-          unit-based pricing, audience delivery estimates, creative format requirements,
-          and measurement windows.
-
-          Measurement windows on each product tell the buyer: "Here is when data
-          becomes available and how it accumulates." Live ratings arrive within a day.
-          C3 (live + 3 days of DVR) arrives ~4 days after broadcast. C7 (live + 7 days
-          of DVR) arrives ~8 days after broadcast. The buyer decides which window to
-          use as the guarantee basis when creating the media buy.
-        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"
-        comply_scenario: full_sales_flow
-        stateful: false
-        expected: |
-          Return products matching the brief. Each product should include:
-          - product_id: unique identifier for the daypart or program package
-          - name: descriptive name (e.g., "Primetime :30 — M-F 8-11pm")
-          - delivery_type: guaranteed (standard for broadcast upfront and scatter)
-          - pricing_models: unit-based pricing (cost per spot or cost per unit)
-          - forecast: estimated impressions by demo, GRPs, reach
-          - creative_format_ids: broadcast spot formats (:15, :30, :60)
-          - reporting_capabilities with measurement_windows:
-            - live: real-time linear viewing, available within 24 hours
-            - c3: live + 3 days DVR playback, available ~4 days after air
-            - c7: live + 7 days DVR playback, available ~8 days after air
-
-        sample_request:
-          buying_mode: "brief"
-          brief: "Primetime and late fringe broadcast spots for an automotive EV launch. Q4 flight, $400K budget. Adults 25-54, national footprint. Need :30 and :15 spot lengths."
-          account:
-            brand:
-              domain: "novamotors.example"
-            operator: "pinnacle-agency.example"
-
-          context:
-            correlation_id: "sales_broadcast_tv--get_products_brief"
-        validations:
-          - check: response_schema
-            description: "Response matches get-products-response.json schema"
-          - check: field_present
-            path: "products"
-            description: "Response contains a products array"
-          - check: field_present
-            path: "products[0].product_id"
-            description: "Each product has a product_id"
-          - check: field_present
-            path: "products[0].delivery_type"
-            description: "Each product declares guaranteed delivery"
-
-          - check: field_present
-            path: "context"
-            description: "Response echoes back the context object"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "sales_broadcast_tv--get_products_brief"
-            description: "Context correlation_id returned unchanged"
-          - check: field_present
-            path: "products[0].format_ids"
-            description: "Products include format_ids for creative requirements"
-          - check: field_present
-            path: "products[0].format_ids[0].agent_url"
-            description: "Format IDs include agent_url — must match this agent's URL"
-          - check: field_present
-            path: "products[0].format_ids[0].id"
-            description: "Format IDs include id — must be accepted back in sync_creatives"
-  - id: create_buy
-    title: "Create the media buy"
-    narrative: |
-      The buyer commits to specific daypart packages with unit counts and flight dates.
-      Broadcast buys carry an agency estimate number — the financial reference that links
-      the order to the agency's media plan and billing system. This number travels with
-      the order through traffic, delivery, and invoicing.
-
-      The buyer also specifies measurement terms, declaring which measurement window
-      (typically C7) serves as the guarantee basis. This tells the seller: "Bill me
-      based on C7 ratings, not live."
-
-    steps:
-      - id: create_media_buy
-        title: "Create a broadcast media buy"
-        narrative: |
-          The buyer places the order with an agency estimate number at the buy level.
-          Each package references a product from discovery. The measurement_terms
-          specify C7 as the guarantee window — the seller will reconcile delivery
-          and billing against C7 ratings.
-
-          The response may be synchronous (buy confirmed) or — when traffic-manager
-          review is needed — the A2A task returns submitted with a task_id, and the
-          buyer waits on a webhook or tasks/get poll until the order is scheduled.
-        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"
-        comply_scenario: create_media_buy
-        stateful: true
-        expected: |
-          Process the broadcast media buy and return:
-          - media_buy_id: the seller's order identifier
-          - agency_estimate_number: echoed from the request
-          - status: pending_creatives (awaiting spot files) or active
-          - packages: line items with confirmed units, rates, and flight dates
-          - measurement_terms: confirmed guarantee window (c7)
-          - valid_actions: sync_creatives as the next step
-
-          If traffic-manager review is needed, return an A2A task envelope instead:
-          - status: submitted (task-level — not a MediaBuy status)
-          - task_id / taskId: handle the buyer polls or receives webhooks on
-          - message (optional): explanation that the traffic manager is reviewing
-
-          Do NOT use a "pending_approval" media buy status — that value is not in the
-          MediaBuy.status enum. IO / traffic-manager review is modelled at the task layer.
-
-        sample_request:
-          brand:
-            domain: "novamotors.example"
-          account:
-            brand:
-              domain: "novamotors.example"
-            operator: "pinnacle-agency.example"
-          agency_estimate_number: "PNNL-NM-2026-Q4-0847"
-          start_time: "2026-10-01T00:00:00Z"
-          end_time: "2026-12-31T23:59:59Z"
-          packages:
-            - product_id: "primetime_30s_mf"
-              budget: 280000
-              pricing_option_id: "unit_primetime_30"
-              creative_assignments:
-                - creative_id: "volta_ev_launch_30s"
-              measurement_terms:
-                billing_measurement:
-                  vendor:
-                    domain: "videoamp.example"
-                  measurement_window: "c7"
-                  max_variance_percent: 10
-            - product_id: "late_fringe_15s_mf"
-              budget: 120000
-              pricing_option_id: "unit_fringe_15"
-              creative_assignments:
-                - creative_id: "volta_ev_launch_15s"
-              measurement_terms:
-                billing_measurement:
-                  vendor:
-                    domain: "videoamp.example"
-                  measurement_window: "c7"
-                  max_variance_percent: 10
-          push_notification_config:
-            url: "{{runner.webhook_url:create_media_buy}}"
-            authentication:
-              schemes:
-                - "HMAC-SHA256"
-              credentials: "pinnacle-broadcast-tv-webhook-secret-token"
-
-          idempotency_key: "$generate:uuid_v4#sales_broadcast_tv_create_buy_create_media_buy"
-          context:
-            correlation_id: "sales_broadcast_tv--create_media_buy"
-        context_outputs:
-          - name: media_buy_id
-            path: "media_buy_id"
-        validations:
-          - check: response_schema
-            description: "Response matches create-media-buy-response.json schema"
-
-          - check: field_present
-            path: "context"
-            description: "Response echoes back the context object"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "sales_broadcast_tv--create_media_buy"
-            description: "Context correlation_id returned unchanged"
-      - id: check_buy_status
-        title: "Check media buy status"
-        narrative: |
-          If create_media_buy returned working or submitted, the buyer polls for status
-          updates. For broadcast, the seller's traffic department may need to confirm
-          scheduling availability before the buy is active.
-        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"
-        comply_scenario: media_buy_lifecycle
-        stateful: true
-        expected: |
-          Return the current state of the media buy:
-          - media_buy_id: matches what was returned from create_media_buy
-          - status: pending_creatives, pending_start, active, paused, completed
-          - packages: line items with scheduling confirmation
-          - valid_actions: what operations are available in this state
-
-          If pending_creatives:
-          - Include message explaining that broadcast spot files are needed
-          - valid_actions should include sync_creatives
-
-        sample_request:
-          account:
-            brand:
-              domain: "novamotors.example"
-            operator: "pinnacle-agency.example"
-          media_buy_ids:
-            - "$context.media_buy_id"
-
-          context:
-            correlation_id: "sales_broadcast_tv--check_buy_status"
-        validations:
-          - check: response_schema
-            description: "Response matches get-media-buys-response.json schema"
-          - check: field_present
-            path: "media_buys[0].status"
-            description: "Each media buy has a status"
-
-          - check: field_present
-            path: "context"
-            description: "Response echoes back the context object"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "sales_broadcast_tv--check_buy_status"
-            description: "Context correlation_id returned unchanged"
-  - id: creative_sync
-    title: "Creative sync"
-    narrative: |
-      Broadcast creative sync differs from digital in three ways. First, assets are
-      broadcast-grade video files — no VAST wrappers, no impression trackers, no click
-      URLs. The seller ingests the video file directly into their traffic and playout
-      system. Second, each creative carries an Ad-ID in industry_identifiers, which ties
-      the spot to rotation instructions and downstream traffic systems. Third, format
-      requirements are defined by spot length (:15, :30, :60) rather than pixel dimensions.
-
-    steps:
-      - id: list_formats
-        title: "Check broadcast format requirements"
-        narrative: |
-          The buyer confirms what broadcast spot formats the seller accepts. The seller
-          returns format specs defined by spot length, codec requirements, and file
-          delivery specifications. No VAST or tracker-related formats appear.
-        task: list_creative_formats
-        schema_ref: "creative/list-creative-formats-request.json"
-        response_schema_ref: "creative/list-creative-formats-response.json"
-        doc_ref: "/creative/task-reference/list_creative_formats"
-        comply_scenario: creative_lifecycle
-        stateful: false
-        expected: |
-          Return broadcast spot formats the platform accepts. Each format should define:
-          - format_id with your agent_url and unique id (e.g., "broadcast_30s", "broadcast_15s")
-          - Asset requirements: video codec, container format, bitrate, frame rate
-          - Duration constraints matching the spot length
-          - No VAST, VPAID, or tracker-related asset slots
-
-        sample_request:
-          context:
-            correlation_id: "sales_broadcast_tv--list_formats"
-
-        validations:
-          - check: response_schema
-            description: "Response matches list-creative-formats-response.json schema"
-          - check: field_present
-            path: "formats"
-            description: "Response contains formats array"
-
-          - check: field_present
-            path: "context"
-            description: "Response echoes back the context object"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "sales_broadcast_tv--list_formats"
-            description: "Context correlation_id returned unchanged"
-          - check: field_present
-            path: "formats[0].format_id.agent_url"
-            description: "Format IDs include agent_url"
-          - check: field_present
-            path: "formats[0].format_id.id"
-            description: "Format IDs include id — must match those in get_products"
-      - id: sync_creatives
-        title: "Push broadcast spot files"
-        narrative: |
-          The buyer uploads broadcast spot files with Ad-ID identifiers. Each creative
-          has a single video asset and one or more industry_identifiers with type ad_id.
-          There are no impression_tracker or click_url assets — broadcast spots are
-          self-contained video files that the seller loads into playout.
-
-          The Ad-ID is the critical link. It connects the creative asset to rotation
-          instructions, traffic logs, and post-log reconciliation. Without a valid
-          Ad-ID, the spot cannot be scheduled.
-        task: sync_creatives
-        schema_ref: "creative/sync-creatives-request.json"
-        response_schema_ref: "creative/sync-creatives-response.json"
-        doc_ref: "/creative/task-reference/sync_creatives"
-        comply_scenario: creative_sync
-        stateful: true
-        expected: |
-          Accept and validate broadcast spot files:
-          - Per-creative action: created or updated
-          - Per-creative status: accepted, pending_review, or rejected
-          - Validation of video technical specs (codec, bitrate, duration)
-          - Confirmation that Ad-ID is recognized and valid
-          - Rejection if Ad-ID is missing or malformed
-
-        sample_request:
-          account:
-            brand:
-              domain: "novamotors.example"
-            operator: "pinnacle-agency.example"
-          creatives:
-            - creative_id: "volta_ev_launch_30s"
-              name: "Nova Volta EV Launch - :30"
-              format_id:
-                agent_url: "https://your-station.example.com"
-                id: "broadcast_30s"
-              industry_identifiers:
-                - type: "ad_id"
-                  value: "NOVA0042000H"
-              assets:
-                video_file:
-                  asset_type: "video"
-                  url: "https://cdn.pinnacle-agency.example/nova-volta-30s.mp4"
-                  width: 1920
-                  height: 1080
-                  duration_ms: 30000
-                  container_format: "mp4"
-                  video_codec: "h264"
-            - creative_id: "volta_ev_launch_15s"
-              name: "Nova Volta EV Launch - :15"
-              format_id:
-                agent_url: "https://your-station.example.com"
-                id: "broadcast_15s"
-              industry_identifiers:
-                - type: "ad_id"
-                  value: "NOVA0042001H"
-              assets:
-                video_file:
-                  asset_type: "video"
-                  url: "https://cdn.pinnacle-agency.example/nova-volta-15s.mp4"
-                  width: 1920
-                  height: 1080
-                  duration_ms: 15000
-                  container_format: "mp4"
-                  video_codec: "h264"
-
-          idempotency_key: "$generate:uuid_v4#sales_broadcast_tv_creative_sync_sync_creatives"
-          context:
-            correlation_id: "sales_broadcast_tv--sync_creatives"
-        validations:
-          - check: response_schema
-            description: "Response matches sync-creatives-response.json schema"
-          - check: field_present
-            path: "creatives[0].action"
-            description: "Each creative has an action (created/updated)"
-
-          - check: field_present
-            path: "context"
-            description: "Response echoes back the context object"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "sales_broadcast_tv--sync_creatives"
-            description: "Context correlation_id returned unchanged"
-  - id: delivery_monitoring
-    title: "Delivery and reporting"
-    narrative: |
-      Broadcast delivery reporting operates on a fundamentally different timeline than
-      digital. Live ratings are available within 24 hours, but the numbers that matter
-      for billing — C7 — are not final until 8 days after each air date. A buyer
-      checking delivery mid-flight will see data at different maturation stages: recent
-      airings show only live numbers, while airings from two weeks ago have full C7.
-
-      The seller sends delivery data with measurement window context so the buyer
-      understands which numbers are preliminary and which are final. As windows mature,
-      the seller sends window_update notifications with supersedes_window indicating
-      which prior data is being replaced. The buyer should not make pacing decisions
-      based on live-only data for a C7-guaranteed buy.
-
-      Window maturation is graded by observing the webhooks the seller emits to the
-      push_notification_config registered on create_media_buy. An agent that emits
-      no webhooks at all scores identically to one that emits the correct C3 and C7
-      progression — closing that gap requires the webhook_receiver_runner test-kit
-      contract (so the runner has somewhere to observe deliveries); without it, the
-      grading step below grades as not_applicable rather than failing.
-
-    steps:
-      - id: expect_window_update_webhook
-        title: "Seller emits at least one window_update delivery webhook"
-        narrative: |
-          After create_media_buy, the seller emits delivery-notification webhooks
-          as each measurement window matures (C3 superseding live with is_final:
-          false, then C7 superseding C3 with is_final: true). The envelope payload
-          MUST carry a valid idempotency_key and validate against the canonical
-          MCP webhook payload schema; the nested delivery result SHOULD carry
-          notification_type: window_update with the supersedes_window progression
-          appropriate to the window that has matured.
-
-          The filter currently matches on operation_id only — runner extensions
-          for nested payload matching (e.g. result.notification_type) will allow
-          separating the C3 and C7 deliveries into distinct assertions in a
-          follow-up. Runs only when the webhook_receiver_runner contract is in
-          scope.
-        task: expect_webhook
-        triggered_by: create_media_buy
-        filter:
-          operation_id: "{{prior_step.create_media_buy.operation_id}}"
-        timeout_seconds: 30
-        expect_idempotency_key: true
-        webhook_payload_schema_ref: "core/mcp-webhook-payload.json"
-        requires_contract: webhook_receiver_runner
-        stateful: true
-        expected: |
-          A webhook arrives within 30 seconds whose envelope validates against
-          mcp-webhook-payload.json and carries an idempotency_key matching
-          ^[A-Za-z0-9_.:-]{16,255}$. The nested delivery result (per
-          get-media-buy-delivery-response.json) SHOULD carry notification_type:
-          window_update with supersedes_window reflecting window progression
-          (e.g. "live" for C3, "c3" for C7). Sellers that emit no delivery
-          webhooks at all fail with no_webhook_received.
-
-      - id: get_delivery
-        title: "Check delivery metrics"
-        narrative: |
-          The buyer requests delivery data for the active broadcast buy. The seller
-          returns ratings-based metrics broken down by package, with each data point
-          tagged by measurement window.
-
-          Data arrives on a delay. For a spot that aired on October 15:
-          - Live data: available October 16
-          - C3 data: available ~October 19
-          - C7 data: available ~October 23
-
-          The buyer should expect that the most recent 8 days of the flight will not
-          have final C7 numbers. The response should make this clear through the
-          measurement window tagging on each data point.
-        task: get_media_buy_delivery
-        schema_ref: "media-buy/get-media-buy-delivery-request.json"
-        response_schema_ref: "media-buy/get-media-buy-delivery-response.json"
-        doc_ref: "/media-buy/task-reference/get_media_buy_delivery"
-        comply_scenario: reporting_flow
-        stateful: true
-        expected: |
-          Return delivery metrics for the broadcast buy:
-          - Per-package: impressions, GRPs, spots aired, spend
-          - measurement_window on each package (live, c3, or c7)
-          - is_final: false for packages with data still maturing
-          - Pacing information relative to the guaranteed unit count
-
-          For webhook delivery, use notification_type: window_update when
-          sending updated data for a period with a wider window. Include
-          supersedes_window to indicate which prior data is being replaced
-          (e.g., supersedes_window: "live" when sending C3 data).
-
-          The buyer uses this to understand:
-          - How many spots have aired vs. the guaranteed count
-          - What the preliminary (live) and final (C7) audience delivery looks like
-          - Whether makegoods may be needed if C7 delivery is under-performing
-
-        sample_request:
-          account:
-            brand:
-              domain: "novamotors.example"
-            operator: "pinnacle-agency.example"
-          media_buy_ids:
-            - "$context.media_buy_id"
-          include_package_daily_breakdown: true
-
-          context:
-            correlation_id: "sales_broadcast_tv--get_delivery"
-        validations:
-          - check: response_schema
-            description: "Response matches get-media-buy-delivery-response.json schema"
-          - check: field_present
-            path: "media_buy_deliveries"
-            description: "Response contains media buy delivery data"
-
-          - check: field_present
-            path: "context"
-            description: "Response echoes back the context object"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "sales_broadcast_tv--get_delivery"
-            description: "Context correlation_id returned unchanged"
-  - id: reconciliation
-    title: "Post-flight reconciliation"
-    narrative: |
-      Broadcast reconciliation cannot happen until C7 data has matured for every air
-      date in the flight. For a flight ending December 31, final C7 data for the last
-      air dates arrives around January 8. The seller then has approximately one week to
-      compile final delivery numbers and issue a post-log.
-
-      The buyer pulls final delivery data ~15 days after the last air date. This is the
-      authoritative data set for billing reconciliation. If C7 delivery fell short of
-      the guaranteed audience levels, the buyer requests makegoods — additional spots
-      to close the delivery gap.
-
-    steps:
-      - id: get_final_delivery
-        title: "Pull final reconciliation data"
-        narrative: |
-          The buyer requests delivery data after C7 has fully matured for all air dates.
-          This is the same get_media_buy_delivery task used during monitoring, but now
-          all data points reflect final C7 measurement.
-
-          The buyer compares final C7 delivery against the guaranteed audience levels
-          from the media buy. If delivery is short, the buyer contacts the seller to
-          negotiate makegoods.
-        task: get_media_buy_delivery
-        schema_ref: "media-buy/get-media-buy-delivery-request.json"
-        response_schema_ref: "media-buy/get-media-buy-delivery-response.json"
-        doc_ref: "/media-buy/task-reference/get_media_buy_delivery"
-        comply_scenario: reporting_flow
-        stateful: true
-        expected: |
-          Return final delivery metrics with all data points at C7 maturation:
-          - Per-package: final impressions, GRPs, spots aired, spend
-          - measurement_window: "c7" on all packages
-          - is_final: true on all packages (all windows fully matured)
-          - supersedes_window: "c3" (this C7 data replaced the prior C3 data)
-          - Final pacing: delivered vs. guaranteed audience levels
-          - Budget reconciliation: actual spend vs. committed
-
-          If delivery fell short of guaranteed levels:
-          - Shortfall amount by package
-          - The buyer uses this data to negotiate makegoods with the seller
-
-        sample_request:
-          account:
-            brand:
-              domain: "novamotors.example"
-            operator: "pinnacle-agency.example"
-          media_buy_ids:
-            - "$context.media_buy_id"
-          include_package_daily_breakdown: true
-
-          context:
-            correlation_id: "sales_broadcast_tv--get_final_delivery"
-        validations:
-          - check: response_schema
-            description: "Response matches get-media-buy-delivery-response.json schema"
-          - check: field_present
-            path: "media_buy_deliveries"
-            description: "Response contains final delivery data"
-
-          - check: field_present
-            path: "context"
-            description: "Response echoes back the context object"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "sales_broadcast_tv--get_final_delivery"
-            description: "Context correlation_id returned unchanged"