@adcp/sdk 6.9.0 → 6.11.0

package/compliance/cache/3.0.6.previous/specialisms/content-standards/index.yaml

@@ -0,0 +1,572 @@
+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"