@adcp/sdk 14.0.0-rc.38 → 14.0.0-rc.39

package/compliance/cache/3.1.0-beta.7/specialisms/content-standards/index.yaml

@@ -1,572 +0,0 @@
-id: content_standards
-version: "1.0.0"
-title: "Content standards"
-protocol: governance
-category: content_standards
-summary: "Define creative quality rules, calibrate content against them, and validate that delivered ads met the standards."
-track: governance
-required_tools:
-  - list_content_standards
-
-# Cross-step assertion (adcp#2664). status.monotonic rejects resource
-# status transitions observed across steps that aren't on the spec
-# lifecycle graph. Silent on content-standards-only runs (no tracked
-# lifecycle resource), but wired so phases that touch creative /
-# account status are automatically gated.
-invariants:
-  - status.monotonic
-
-narrative: |
-  You run a governance agent that manages content standards — rules that define what
-  creative content is acceptable for a brand or campaign. Buyers create standards that
-  specify quality requirements, safety constraints, and brand compliance rules. Your
-  agent stores these standards, calibrates sample content against them, and validates
-  that delivered creatives met the requirements.
-
-  Content standards complement property governance. Property lists control where ads appear;
-  content standards control what the ads look like. Together they form a complete brand
-  safety framework.
-
-  This storyboard covers the full content standards lifecycle: defining standards, querying
-  them, calibrating content before launch, and validating delivery after the fact.
-
-agent:
-  interaction_model: governance_agent
-  capabilities:
-    - content_standards
-    - creative_quality
-  examples:
-    - "Creative quality platforms"
-    - "Brand safety services"
-    - "Ad verification platforms"
-    - "GARM-aligned quality tools"
-
-caller:
-  role: buyer_agent
-  example: "Pinnacle Agency (buyer)"
-
-prerequisites:
-  description: |
-    The caller needs a brand identity and creative quality requirements. The test kit
-    provides a sample brand with visual assets for calibration.
-  test_kit: "test-kits/acme-outdoor.yaml"
-
-phases:
-  - id: capability_discovery
-    title: "Capability discovery"
-    narrative: |
-      The buyer calls get_adcp_capabilities to confirm the agent supports governance before registering plans or checking compliance.
-
-    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 governance in supported_protocols, confirming the agent provides governance services.
-        sample_request:
-          context:
-            correlation_id: "content_standards--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: "content_standards--get_capabilities"
-            description: "Context correlation_id returned unchanged"
-  - id: create_standards
-    title: "Define content standards"
-    narrative: |
-      The buyer creates content standards that define what creative content is acceptable.
-      Standards include quality requirements, safety constraints, and brand-specific rules.
-
-    steps:
-      - id: create_content_standards
-        title: "Create content standards"
-        narrative: |
-          The buyer defines a set of content standards. These rules will be used to
-          evaluate creatives before and after delivery.
-        task: create_content_standards
-        schema_ref: "content-standards/create-content-standards-request.json"
-        response_schema_ref: "content-standards/create-content-standards-response.json"
-        doc_ref: "/governance/content-standards/tasks/create_content_standards"
-        comply_scenario: governance_content_standards
-        stateful: true
-        expected: |
-          Return the created content standards:
-          - standards_id: platform-assigned identifier
-          - Rules registered with severity levels
-          - Status: active
-
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-          scope:
-            languages_any: ["en"]
-            description: "Acme Outdoor creative quality standards"
-          policies:
-            - policy_id: no_violent_imagery
-              policy_categories: [brand_safety]
-              enforcement: must
-              policy: "No violent or controversial imagery"
-            - policy_id: min_display_dpi
-              policy_categories: [imagery_quality]
-              enforcement: should
-              channels: [display]
-              policy: "Minimum 72 DPI for display assets"
-            - policy_id: brand_color_tolerance
-              policy_categories: [brand_compliance]
-              enforcement: must
-              policy: "Brand colors must match palette within 5% tolerance"
-
-          idempotency_key: "$generate:uuid_v4#content_standards_create_standards_create_content_standards"
-          context:
-            correlation_id: "content_standards--create_content_standards"
-        validations:
-          - check: response_schema
-            description: "Response matches create-content-standards-response.json schema"
-
-          - check: field_present
-            path: "context"
-            description: "Response echoes back the context object"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "content_standards--create_content_standards"
-            description: "Context correlation_id returned unchanged"
-  - id: list_and_get
-    title: "Query content standards"
-    narrative: |
-      The buyer lists all content standards for the account and retrieves a specific
-      standard to inspect its rules.
-
-    steps:
-      - id: list_content_standards
-        title: "List all content standards"
-        narrative: |
-          The buyer lists all content standards for the brand. The response includes
-          standard metadata without full rule details.
-        task: list_content_standards
-        schema_ref: "content-standards/list-content-standards-request.json"
-        response_schema_ref: "content-standards/list-content-standards-response.json"
-        doc_ref: "/governance/content-standards/tasks/list_content_standards"
-        comply_scenario: governance_content_standards
-        stateful: true
-        expected: |
-          Return content standard summaries:
-          - Array of standards with standards_id, name, rule_count
-          - Status of each standard set
-
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-
-          context:
-            correlation_id: "content_standards--list_content_standards"
-        validations:
-          - check: response_schema
-            description: "Response matches list-content-standards-response.json schema"
-
-          - check: field_present
-            path: "context"
-            description: "Response echoes back the context object"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "content_standards--list_content_standards"
-            description: "Context correlation_id returned unchanged"
-      - id: get_content_standards
-        title: "Get a specific content standard"
-        narrative: |
-          The buyer retrieves the full details of a specific content standard, including
-          all rules and their severity levels.
-        task: get_content_standards
-        schema_ref: "content-standards/get-content-standards-request.json"
-        response_schema_ref: "content-standards/get-content-standards-response.json"
-        doc_ref: "/governance/content-standards/tasks/get_content_standards"
-        comply_scenario: governance_content_standards
-        stateful: true
-        expected: |
-          Return the full content standard:
-          - standards_id, name
-          - All rules with categories, descriptions, and severity
-
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-          standards_id: "$context.content_standards_id"
-
-          context:
-            correlation_id: "content_standards--get_content_standards"
-        validations:
-          - check: response_schema
-            description: "Response matches get-content-standards-response.json schema"
-
-          - check: field_present
-            path: "context"
-            description: "Response echoes back the context object"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "content_standards--get_content_standards"
-            description: "Context correlation_id returned unchanged"
-  - id: update_standards
-    title: "Update content standards"
-    narrative: |
-      The buyer modifies existing content standards — adding rules, adjusting severity,
-      or removing obsolete constraints.
-
-    steps:
-      - id: update_content_standards
-        title: "Update content standards"
-        narrative: |
-          The buyer updates an existing content standard with new or modified rules.
-        task: update_content_standards
-        schema_ref: "content-standards/update-content-standards-request.json"
-        response_schema_ref: "content-standards/update-content-standards-response.json"
-        doc_ref: "/governance/content-standards/tasks/update_content_standards"
-        comply_scenario: governance_content_standards
-        stateful: true
-        expected: |
-          Return the updated content standard:
-          - Updated rule set
-          - Confirmation of changes applied
-
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-          standards_id: "$context.content_standards_id"
-          policies:
-            - policy_id: no_violent_imagery
-              policy_categories: [brand_safety]
-              enforcement: must
-              policy: "No violent or controversial imagery"
-            - policy_id: min_display_dpi
-              policy_categories: [imagery_quality]
-              enforcement: should
-              channels: [display]
-              policy: "Minimum 72 DPI for display assets"
-            - policy_id: brand_color_tolerance
-              policy_categories: [brand_compliance]
-              enforcement: must
-              policy: "Brand colors must match palette within 5% tolerance"
-            - policy_id: image_alt_text
-              policy_categories: [accessibility]
-              enforcement: should
-              policy: "All images must have alt text"
-
-          idempotency_key: "$generate:uuid_v4#content_standards_update_standards_update_content_standards"
-          context:
-            correlation_id: "content_standards--update_content_standards"
-        validations:
-          - check: response_schema
-            description: "Response matches update-content-standards-response.json schema"
-
-          - check: field_present
-            path: "context"
-            description: "Response echoes back the context object"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "content_standards--update_content_standards"
-            description: "Context correlation_id returned unchanged"
-  - id: calibration
-    title: "Calibrate content"
-    narrative: |
-      Before launching a campaign, the buyer calibrates sample creatives against the
-      content standards. This is a pre-flight check — does the creative meet the rules
-      before it goes live?
-
-    steps:
-      - id: calibrate_content
-        title: "Calibrate content against standards"
-        narrative: |
-          The buyer submits sample creative content for evaluation against the content
-          standards. The governance agent checks each rule and returns a calibration
-          report indicating pass/fail per rule.
-        task: calibrate_content
-        schema_ref: "content-standards/calibrate-content-request.json"
-        response_schema_ref: "content-standards/calibrate-content-response.json"
-        doc_ref: "/governance/content-standards/tasks/calibrate_content"
-        comply_scenario: governance_content_standards
-        stateful: true
-        expected: |
-          Return a calibration report:
-          - overall_pass: boolean
-          - Per-rule results with pass/fail and evidence
-          - Remediation guidance for failed rules
-
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-          standards_id: "$context.content_standards_id"
-          artifact:
-            property_rid: "test-publisher.example"
-            artifact_id: "display_trail_pro_300x250"
-            assets:
-              - type: "image"
-                url: "https://cdn.pinnacle-agency.example/trail-pro-300x250.png"
-                width: 300
-                height: 250
-
-          idempotency_key: "$generate:uuid_v4#content_standards_calibration_calibrate_content"
-          context:
-            correlation_id: "content_standards--calibrate_content"
-        validations:
-          - check: response_schema
-            description: "Response matches calibrate-content-response.json schema"
-          - check: field_present
-            path: "verdict"
-            description: "Response includes calibration verdict"
-
-  - id: must_rule_violation
-    title: "Must-rule violation"
-    narrative: |
-      The buyer submits content that violates a "must" severity rule in the content
-      standards. The governance agent must reject it — this tests that the agent
-      distinguishes between "must" (blocking) and "should" (advisory) severity levels.
-
-    steps:
-      - id: calibrate_must_violation
-        title: "Calibrate content that violates a must rule"
-        narrative: |
-          The buyer submits creative content containing violent imagery, which violates
-          the "No violent or controversial imagery (must)" rule. The agent must return
-          a failing verdict with a reference to the violated rule.
-        task: calibrate_content
-        schema_ref: "content-standards/calibrate-content-request.json"
-        response_schema_ref: "content-standards/calibrate-content-response.json"
-        doc_ref: "/governance/content-standards/tasks/calibrate_content"
-        comply_scenario: governance_content_standards
-        stateful: true
-        expected: |
-          Return a failing calibration:
-          - verdict: fail
-          - At least one rule failure referencing the violent imagery must-rule
-          - Remediation guidance explaining why the content was rejected
-
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-          standards_id: "$context.content_standards_id"
-          artifact:
-            property_rid: "test-publisher.example"
-            artifact_id: "display_violent_imagery_300x250"
-            description: "Display ad featuring graphic hunting scene with violent imagery"
-            assets:
-              - type: "image"
-                url: "https://cdn.pinnacle-agency.example/violent-hunting-scene-300x250.png"
-                width: 300
-                height: 250
-
-          idempotency_key: "$generate:uuid_v4#content_standards_must_rule_violation_calibrate_must_violation"
-        validations:
-          - check: response_schema
-            description: "Response matches calibrate-content-response.json schema"
-          - check: field_value
-            path: "verdict"
-            value: "fail"
-            description: "Content that violates a must-rule receives fail verdict"
-
-  - id: standards_version_change
-    title: "Policy version change"
-    narrative: |
-      The buyer updates the content standards to add a stricter rule, then re-calibrates
-      previously passing content. This tests that the agent applies the updated policy
-      rather than caching the old version.
-
-    steps:
-      - id: update_stricter_standards
-        title: "Add stricter must-rule to content standards"
-        narrative: |
-          The buyer updates the content standards to require alt text on all images
-          as a must-severity rule (previously "should"). Content that previously passed
-          calibration may now fail.
-        task: update_content_standards
-        schema_ref: "content-standards/update-content-standards-request.json"
-        response_schema_ref: "content-standards/update-content-standards-response.json"
-        doc_ref: "/governance/content-standards/tasks/update_content_standards"
-        comply_scenario: governance_content_standards
-        stateful: true
-        expected: |
-          Return the updated content standard:
-          - Updated policy with stricter alt text rule
-          - Confirmation of changes applied
-
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-          standards_id: "$context.content_standards_id"
-          policies:
-            - policy_id: no_violent_imagery
-              policy_categories: [brand_safety]
-              enforcement: must
-              policy: "No violent or controversial imagery"
-            - policy_id: min_display_dpi
-              policy_categories: [imagery_quality]
-              enforcement: should
-              channels: [display]
-              policy: "Minimum 72 DPI for display assets"
-            - policy_id: brand_color_tolerance
-              policy_categories: [brand_compliance]
-              enforcement: must
-              policy: "Brand colors must match palette within 5% tolerance"
-            - policy_id: image_alt_text
-              policy_categories: [accessibility]
-              enforcement: must
-              policy: "All images must have alt text"
-            - policy_id: no_stock_photography
-              policy_categories: [brand_compliance]
-              enforcement: must
-              policy: "No stock photography"
-
-          idempotency_key: "$generate:uuid_v4#content_standards_standards_version_change_update_stricter_standards"
-        validations:
-          - check: response_schema
-            description: "Response matches update-content-standards-response.json schema"
-
-      - id: calibrate_after_policy_change
-        title: "Re-calibrate content against updated standards"
-        narrative: |
-          The buyer re-calibrates the same sample content against the updated standards.
-          If the agent is properly applying the current policy version, content without
-          alt text or using stock photography should now fail.
-        task: calibrate_content
-        schema_ref: "content-standards/calibrate-content-request.json"
-        response_schema_ref: "content-standards/calibrate-content-response.json"
-        doc_ref: "/governance/content-standards/tasks/calibrate_content"
-        comply_scenario: governance_content_standards
-        stateful: true
-        expected: |
-          Return calibration results reflecting the updated policy:
-          - verdict reflects evaluation against current (not cached) standards
-          - Rule results reference the updated policy rules
-
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-          standards_id: "$context.content_standards_id"
-          artifact:
-            property_rid: "test-publisher.example"
-            artifact_id: "display_stock_photo_300x250"
-            description: "Display ad using stock photography without alt text"
-            assets:
-              - type: "image"
-                url: "https://cdn.pinnacle-agency.example/stock-photo-300x250.png"
-                width: 300
-                height: 250
-
-          idempotency_key: "$generate:uuid_v4#content_standards_standards_version_change_calibrate_after_policy_change"
-          context:
-            correlation_id: "content_standards--calibrate_after_policy_change"
-        validations:
-          - check: response_schema
-            description: "Response matches calibrate-content-response.json schema"
-          - check: field_value
-            path: "verdict"
-            value: "fail"
-            description: "Content violating updated must-rules receives fail verdict"
-
-          - check: field_present
-            path: "context"
-            description: "Response echoes back the context object"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "content_standards--calibrate_after_policy_change"
-            description: "Context correlation_id returned unchanged"
-  - id: delivery_validation
-    title: "Validate delivered content"
-    narrative: |
-      After the campaign runs, the buyer validates that the delivered creatives met the
-      content standards. The governance agent checks actual delivered content against
-      the rules and flags any violations.
-
-    steps:
-      - id: validate_content_delivery
-        title: "Validate content delivery compliance"
-        narrative: |
-          The buyer submits delivery data with creative references. The governance agent
-          evaluates the delivered content against the content standards and returns
-          a compliance report.
-        task: validate_content_delivery
-        schema_ref: "content-standards/validate-content-delivery-request.json"
-        response_schema_ref: "content-standards/validate-content-delivery-response.json"
-        doc_ref: "/governance/content-standards/tasks/validate_content_delivery"
-        comply_scenario: governance_content_standards
-        stateful: true
-        expected: |
-          Return validation results:
-          - compliant: boolean overall status
-          - Per-creative compliance status
-          - Violations with rule references and evidence
-
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-          standards_id: "$context.content_standards_id"
-          records:
-            - record_id: "delivery_display_001"
-              artifact:
-                property_rid: "test-publisher.example"
-                artifact_id: "display_trail_pro_300x250"
-                assets:
-                  - type: "image"
-                    url: "https://cdn.pinnacle-agency.example/trail-pro-300x250.png"
-                    width: 300
-                    height: 250
-            - record_id: "delivery_video_001"
-              artifact:
-                property_rid: "test-publisher.example"
-                artifact_id: "video_30s_trail_pro"
-                assets:
-                  - type: "video"
-                    url: "https://cdn.pinnacle-agency.example/trail-pro-30s.mp4"
-                    duration_ms: 30000
-
-          context:
-            correlation_id: "content_standards--validate_content_delivery"
-        validations:
-          - check: response_schema
-            description: "Response matches validate-content-delivery-response.json schema"
-          - check: field_present
-            path: "summary"
-            description: "Response includes validation summary with pass/fail counts"
-          - check: field_present
-            path: "results"
-            description: "Response includes per-record validation results"
-
-          - check: field_present
-            path: "context"
-            description: "Response echoes back the context object"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "content_standards--validate_content_delivery"
-            description: "Context correlation_id returned unchanged"