@adcp/sdk 7.4.0 → 7.6.0

package/dist/lib/server/wire-spec-fields.generated.js

@@ -1,7 +1,7 @@
 "use strict";
 // AUTO-GENERATED by scripts/generate-wire-spec-fields.ts. DO NOT EDIT.
-// Source: schemas/cache/3.0.11/**/*-request.json
-// Generated at: 2026-05-11T17:34:00.730Z
+// Source: schemas/cache/3.0.12/**/*-request.json
+// Generated at: 2026-05-17T08:43:49.535Z
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WIRE_SPEC_FIELDS = void 0;
 /**
@@ -23,147 +23,147 @@ exports.WIRE_SPEC_FIELDS = void 0;
  * pollution or shared-state mutation of the allowlist.
  */
 exports.WIRE_SPEC_FIELDS = Object.freeze({
-    /** schemas/cache/3.0.11/brand/acquire-rights-request.json */
+    /** schemas/cache/3.0.12/brand/acquire-rights-request.json */
     AcquireRightsRequest: Object.freeze({
         fields: Object.freeze(["adcp_major_version", "buyer", "campaign", "context", "ext", "idempotency_key", "pricing_option_id", "push_notification_config", "revocation_webhook", "rights_id"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/signals/activate-signal-request.json */
+    /** schemas/cache/3.0.12/signals/activate-signal-request.json */
     ActivateSignalRequest: Object.freeze({
         fields: Object.freeze(["account", "action", "adcp_major_version", "context", "destinations", "ext", "idempotency_key", "pricing_option_id", "signal_agent_segment_id"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/media-buy/build-creative-request.json */
+    /** schemas/cache/3.0.12/media-buy/build-creative-request.json */
     BuildCreativeRequest: Object.freeze({
         fields: Object.freeze(["account", "adcp_major_version", "brand", "concept_id", "context", "creative_id", "creative_manifest", "ext", "idempotency_key", "include_preview", "item_limit", "macro_values", "media_buy_id", "message", "package_id", "preview_inputs", "preview_output_format", "preview_quality", "quality", "target_format_id", "target_format_ids"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/content-standards/calibrate-content-request.json */
+    /** schemas/cache/3.0.12/content-standards/calibrate-content-request.json */
     CalibrateContentRequest: Object.freeze({
         fields: Object.freeze(["adcp_major_version", "artifact", "context", "ext", "idempotency_key", "standards_id"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/collection/create-collection-list-request.json */
+    /** schemas/cache/3.0.12/collection/create-collection-list-request.json */
     CreateCollectionListRequest: Object.freeze({
         fields: Object.freeze(["account", "adcp_major_version", "base_collections", "brand", "context", "description", "ext", "filters", "idempotency_key", "name"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/content-standards/create-content-standards-request.json */
+    /** schemas/cache/3.0.12/content-standards/create-content-standards-request.json */
     CreateContentStandardsRequest: Object.freeze({
         fields: Object.freeze(["adcp_major_version", "calibration_exemplars", "context", "ext", "idempotency_key", "policies", "registry_policy_ids", "scope"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/media-buy/create-media-buy-request.json */
+    /** schemas/cache/3.0.12/media-buy/create-media-buy-request.json */
     CreateMediaBuyRequest: Object.freeze({
         fields: Object.freeze(["account", "adcp_major_version", "advertiser_industry", "agency_estimate_number", "artifact_webhook", "brand", "context", "end_time", "ext", "idempotency_key", "invoice_recipient", "io_acceptance", "packages", "plan_id", "po_number", "proposal_id", "push_notification_config", "reporting_webhook", "start_time", "total_budget"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/property/create-property-list-request.json */
+    /** schemas/cache/3.0.12/property/create-property-list-request.json */
     CreatePropertyListRequest: Object.freeze({
         fields: Object.freeze(["account", "adcp_major_version", "base_properties", "brand", "context", "description", "ext", "filters", "idempotency_key", "name"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/collection/delete-collection-list-request.json */
+    /** schemas/cache/3.0.12/collection/delete-collection-list-request.json */
     DeleteCollectionListRequest: Object.freeze({
         fields: Object.freeze(["account", "adcp_major_version", "context", "ext", "idempotency_key", "list_id"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/property/delete-property-list-request.json */
+    /** schemas/cache/3.0.12/property/delete-property-list-request.json */
     DeletePropertyListRequest: Object.freeze({
         fields: Object.freeze(["account", "adcp_major_version", "context", "ext", "idempotency_key", "list_id"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/media-buy/get-media-buy-delivery-request.json */
+    /** schemas/cache/3.0.12/media-buy/get-media-buy-delivery-request.json */
     GetMediaBuyDeliveryRequest: Object.freeze({
         fields: Object.freeze(["account", "adcp_major_version", "attribution_window", "context", "end_date", "ext", "include_package_daily_breakdown", "media_buy_ids", "reporting_dimensions", "start_date", "status_filter"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/media-buy/log-event-request.json */
+    /** schemas/cache/3.0.12/media-buy/log-event-request.json */
     LogEventRequest: Object.freeze({
         fields: Object.freeze(["adcp_major_version", "context", "event_source_id", "events", "ext", "idempotency_key", "test_event_code"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/media-buy/provide-performance-feedback-request.json */
+    /** schemas/cache/3.0.12/media-buy/provide-performance-feedback-request.json */
     ProvidePerformanceFeedbackRequest: Object.freeze({
         fields: Object.freeze(["adcp_major_version", "context", "creative_id", "ext", "feedback_source", "idempotency_key", "measurement_period", "media_buy_id", "metric_type", "package_id", "performance_index"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/governance/report-plan-outcome-request.json */
+    /** schemas/cache/3.0.12/governance/report-plan-outcome-request.json */
     ReportPlanOutcomeRequest: Object.freeze({
         fields: Object.freeze(["adcp_major_version", "check_id", "context", "delivery", "error", "ext", "governance_context", "idempotency_key", "outcome", "plan_id", "purchase_type", "seller_response"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/account/report-usage-request.json */
+    /** schemas/cache/3.0.12/account/report-usage-request.json */
     ReportUsageRequest: Object.freeze({
         fields: Object.freeze(["adcp_major_version", "context", "ext", "idempotency_key", "reporting_period", "usage"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/sponsored-intelligence/si-initiate-session-request.json */
+    /** schemas/cache/3.0.12/sponsored-intelligence/si-initiate-session-request.json */
     SIInitiateSessionRequest: Object.freeze({
         fields: Object.freeze(["adcp_major_version", "context", "ext", "idempotency_key", "identity", "intent", "media_buy_id", "offering_id", "offering_token", "placement", "supported_capabilities"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/sponsored-intelligence/si-send-message-request.json */
+    /** schemas/cache/3.0.12/sponsored-intelligence/si-send-message-request.json */
     SISendMessageRequest: Object.freeze({
         fields: Object.freeze(["action_response", "adcp_major_version", "context", "ext", "idempotency_key", "message", "session_id"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/account/sync-accounts-request.json */
+    /** schemas/cache/3.0.12/account/sync-accounts-request.json */
     SyncAccountsRequest: Object.freeze({
         fields: Object.freeze(["accounts", "adcp_major_version", "context", "delete_missing", "dry_run", "ext", "idempotency_key", "push_notification_config"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/media-buy/sync-audiences-request.json */
+    /** schemas/cache/3.0.12/media-buy/sync-audiences-request.json */
     SyncAudiencesRequest: Object.freeze({
         fields: Object.freeze(["account", "adcp_major_version", "audiences", "context", "delete_missing", "ext", "idempotency_key"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/media-buy/sync-catalogs-request.json */
+    /** schemas/cache/3.0.12/media-buy/sync-catalogs-request.json */
     SyncCatalogsRequest: Object.freeze({
         fields: Object.freeze(["account", "adcp_major_version", "catalog_ids", "catalogs", "context", "delete_missing", "dry_run", "ext", "idempotency_key", "push_notification_config", "validation_mode"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/creative/sync-creatives-request.json */
+    /** schemas/cache/3.0.12/creative/sync-creatives-request.json */
     SyncCreativesRequest: Object.freeze({
         fields: Object.freeze(["account", "adcp_major_version", "assignments", "context", "creative_ids", "creatives", "delete_missing", "dry_run", "ext", "idempotency_key", "push_notification_config", "validation_mode"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/media-buy/sync-event-sources-request.json */
+    /** schemas/cache/3.0.12/media-buy/sync-event-sources-request.json */
     SyncEventSourcesRequest: Object.freeze({
         fields: Object.freeze(["account", "adcp_major_version", "context", "delete_missing", "event_sources", "ext", "idempotency_key"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/account/sync-governance-request.json */
+    /** schemas/cache/3.0.12/account/sync-governance-request.json */
     SyncGovernanceRequest: Object.freeze({
         fields: Object.freeze(["accounts", "adcp_major_version", "context", "ext", "idempotency_key"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/governance/sync-plans-request.json */
+    /** schemas/cache/3.0.12/governance/sync-plans-request.json */
     SyncPlansRequest: Object.freeze({
         fields: Object.freeze(["adcp_major_version", "context", "ext", "idempotency_key", "plans"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/collection/update-collection-list-request.json */
+    /** schemas/cache/3.0.12/collection/update-collection-list-request.json */
     UpdateCollectionListRequest: Object.freeze({
         fields: Object.freeze(["account", "adcp_major_version", "base_collections", "brand", "context", "description", "ext", "filters", "idempotency_key", "list_id", "name", "webhook_url"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/content-standards/update-content-standards-request.json */
+    /** schemas/cache/3.0.12/content-standards/update-content-standards-request.json */
     UpdateContentStandardsRequest: Object.freeze({
         fields: Object.freeze(["adcp_major_version", "calibration_exemplars", "context", "ext", "idempotency_key", "policies", "registry_policy_ids", "scope", "standards_id"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/media-buy/update-media-buy-request.json */
+    /** schemas/cache/3.0.12/media-buy/update-media-buy-request.json */
     UpdateMediaBuyRequest: Object.freeze({
         fields: Object.freeze(["account", "adcp_major_version", "canceled", "cancellation_reason", "context", "end_time", "ext", "idempotency_key", "invoice_recipient", "media_buy_id", "new_packages", "packages", "paused", "push_notification_config", "reporting_webhook", "revision", "start_time"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/property/update-property-list-request.json */
+    /** schemas/cache/3.0.12/property/update-property-list-request.json */
     UpdatePropertyListRequest: Object.freeze({
         fields: Object.freeze(["account", "adcp_major_version", "base_properties", "brand", "context", "description", "ext", "filters", "idempotency_key", "list_id", "name", "webhook_url"]),
         __type: null,
     }),
-    /** schemas/cache/3.0.11/brand/update-rights-request.json */
+    /** schemas/cache/3.0.12/brand/update-rights-request.json */
     UpdateRightsRequest: Object.freeze({
         fields: Object.freeze(["adcp_major_version", "context", "end_date", "ext", "idempotency_key", "impression_cap", "paused", "pricing_option_id", "push_notification_config", "rights_id"]),
         __type: null,

package/dist/lib/testing/compliance/comply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"comply.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/compliance/comply.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAWtE,OAAO,kCAAkC,CAAC;AAO1C,OAAO,KAAK,EAAgB,UAAU,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC5G,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAEjB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACd,MAAM,SAAS,CAAC;AAwBjB;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,YAAY,GACpB,mBAAmB,EAAE,CA2SvB;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;IAC5D;;;OAGG;IACH,SAAS,CAAC,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAC;CAC/C;AAED;;;;;;;;;GASG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwBrG;AAuOD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,EAAE,EAC3B,WAAW,EAAE,UAAU,EAAE,EACzB,QAAQ,EAAE,MAAM,GACf,iBAAiB,EAAE,CA4DrB;AAoWD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAAC,CAmFnE;AA2HD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAe9E;AA6DD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAoIxE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAE5E"}
+{"version":3,"file":"comply.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/compliance/comply.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAWtE,OAAO,kCAAkC,CAAC;AAO1C,OAAO,KAAK,EAAgB,UAAU,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC5G,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAEjB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACd,MAAM,SAAS,CAAC;AAwBjB;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,YAAY,GACpB,mBAAmB,EAAE,CAoYvB;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;IAC5D;;;OAGG;IACH,SAAS,CAAC,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAC;CAC/C;AAED;;;;;;;;;GASG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwBrG;AAuOD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,EAAE,EAC3B,WAAW,EAAE,UAAU,EAAE,EACzB,QAAQ,EAAE,MAAM,GACf,iBAAiB,EAAE,CA4DrB;AA8WD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAAC,CAqFnE;AA+HD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAe9E;AA6DD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAkJxE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAE5E"}

package/dist/lib/testing/compliance/comply.js

@@ -100,6 +100,7 @@ function collectObservations(track, results, profile) {
                 track,
                 message: 'Agent does not declare v3 protocol support. V3 provides richer capabilities and is recommended.',
                 evidence: { detected_version: profile.adcp_version || 'unknown' },
+                source: { kind: 'profile', code: 'v3-not-declared' },
             });
         }
         if (profile.tools.length < 3) {
@@ -109,6 +110,7 @@ function collectObservations(track, results, profile) {
                 track,
                 message: `Agent exposes ${profile.tools.length} tool(s). Most production agents expose 5+.`,
                 evidence: { tool_count: profile.tools.length, tools: profile.tools },
+                source: { kind: 'profile', code: 'low-tool-count' },
             });
         }
     }
@@ -126,6 +128,12 @@ function collectObservations(track, results, profile) {
                                 track,
                                 message: 'Agent returned 0 products. Buyers cannot transact without product inventory.',
                                 evidence: { products_count: 0 },
+                                source: {
+                                    kind: 'storyboard_step',
+                                    code: 'zero-products',
+                                    storyboard_id: result.scenario,
+                                    step_id: step.step,
+                                },
                             });
                         }
                         else if (obs.products_count > 50) {
@@ -135,6 +143,12 @@ function collectObservations(track, results, profile) {
                                 track,
                                 message: `Agent returned ${obs.products_count} products for a single brief. Consider curating to 5-15 most relevant products.`,
                                 evidence: { products_count: obs.products_count },
+                                source: {
+                                    kind: 'storyboard_step',
+                                    code: 'too-many-products',
+                                    storyboard_id: result.scenario,
+                                    step_id: step.step,
+                                },
                             });
                         }
                     }
@@ -145,6 +159,12 @@ function collectObservations(track, results, profile) {
                             track,
                             message: `Agent only serves ${obs.channels[0]} channel. Multi-channel inventory broadens demand.`,
                             evidence: { channels: obs.channels },
+                            source: {
+                                kind: 'storyboard_step',
+                                code: 'single-channel',
+                                storyboard_id: result.scenario,
+                                step_id: step.step,
+                            },
                         });
                     }
                 }
@@ -168,6 +188,12 @@ function collectObservations(track, results, profile) {
                             track,
                             message: 'Agent does not return valid_actions in get_media_buys response. ' +
                                 'Without valid_actions, buyer agents must hardcode the state machine to know what operations are permitted.',
+                            source: {
+                                kind: 'storyboard_step',
+                                code: 'missing-valid-actions',
+                                storyboard_id: result.scenario,
+                                step_id: step.step,
+                            },
                         });
                     }
                     if (obs.has_creative_deadline === false) {
@@ -177,6 +203,12 @@ function collectObservations(track, results, profile) {
                             track,
                             message: 'Agent does not return creative_deadline on media buys or packages. ' +
                                 'Buyers need to know when creative uploads must be finalized to avoid rejected submissions.',
+                            source: {
+                                kind: 'storyboard_step',
+                                code: 'missing-creative-deadline',
+                                storyboard_id: result.scenario,
+                                step_id: step.step,
+                            },
                         });
                     }
                     if (obs.history_entries && obs.history_entries > 0 && obs.history_valid === false) {
@@ -186,6 +218,12 @@ function collectObservations(track, results, profile) {
                             track,
                             message: 'Agent returns history entries but some lack required fields (timestamp, action). ' +
                                 'History entries must include at least timestamp and action to be useful for audit.',
+                            source: {
+                                kind: 'storyboard_step',
+                                code: 'invalid-history-entries',
+                                storyboard_id: result.scenario,
+                                step_id: step.step,
+                            },
                         });
                     }
                     if (obs.sandbox === undefined || obs.sandbox === null) {
@@ -195,6 +233,12 @@ function collectObservations(track, results, profile) {
                             track,
                             message: 'Agent does not confirm sandbox mode in get_media_buys response. ' +
                                 'Include sandbox: true so buyers can verify the agent honored sandbox mode.',
+                            source: {
+                                kind: 'storyboard_step',
+                                code: 'missing-sandbox-echo',
+                                storyboard_id: result.scenario,
+                                step_id: step.step,
+                            },
                         });
                     }
                     checkedValidActions = true;
@@ -223,6 +267,12 @@ function collectObservations(track, results, profile) {
                             track,
                             message: 'Agent does not return revision history when include_history is requested. ' +
                                 'History enables audit trails and helps buyers understand what changed.',
+                            source: {
+                                kind: 'storyboard_step',
+                                code: 'no-revision-history',
+                                storyboard_id: result.scenario,
+                                step_id: step.step,
+                            },
                         });
                     }
                     checkedHistory = true;
@@ -246,6 +296,12 @@ function collectObservations(track, results, profile) {
                                 track,
                                 message: 'Agent transitions to canceled status but does not include canceled_by field. ' +
                                     'Buyers need to distinguish buyer-initiated from seller-initiated cancellations.',
+                                source: {
+                                    kind: 'storyboard_step',
+                                    code: 'missing-canceled-by',
+                                    storyboard_id: result.scenario,
+                                    step_id: step.step,
+                                },
                             });
                         }
                         if (!obs.canceled_at) {
@@ -255,6 +311,12 @@ function collectObservations(track, results, profile) {
                                 track,
                                 message: 'Agent transitions to canceled status but does not include canceled_at timestamp. ' +
                                     'A cancellation timestamp is required for audit and reconciliation.',
+                                source: {
+                                    kind: 'storyboard_step',
+                                    code: 'missing-canceled-at',
+                                    storyboard_id: result.scenario,
+                                    step_id: step.step,
+                                },
                             });
                         }
                         checkedCancellation = true;
@@ -273,6 +335,12 @@ function collectObservations(track, results, profile) {
                     track,
                     message: 'Agent does not support pause/resume operations on media buys.',
                     evidence: { error: pauseFailed.error },
+                    source: {
+                        kind: 'storyboard_step',
+                        code: 'pause-resume-unsupported',
+                        storyboard_id: lifecycleResult.scenario,
+                        step_id: pauseFailed.step,
+                    },
                 });
             }
         }
@@ -288,6 +356,7 @@ function collectObservations(track, results, profile) {
                 track,
                 message: 'Agent supports sync_creatives but not list_creative_formats. ' +
                     'Buyers need to know what formats you accept before sending creatives.',
+                source: { kind: 'profile', code: 'sync-creatives-without-formats' },
             });
         }
     }
@@ -307,6 +376,12 @@ function collectObservations(track, results, profile) {
                                 message: `Error compliance at L${level}. L3 (structuredContent.adcp_error) is recommended. ` +
                                     `Use adcpError() from @adcp/sdk for automatic L3 compliance.`,
                                 evidence: { compliance_level: level, step: step.step },
+                                source: {
+                                    kind: 'storyboard_step',
+                                    code: 'low-error-compliance-level',
+                                    storyboard_id: result.scenario,
+                                    step_id: step.step,
+                                },
                             });
                         }
                     }
@@ -316,23 +391,31 @@ function collectObservations(track, results, profile) {
     }
     // Campaign governance track observations
     if (track === 'campaign_governance') {
-        let anyCheckMissingContext = false;
+        // Capture the first step that produced the gap so the rollup
+        // observation can point a triager back at a concrete coordinate.
+        let firstMissing;
         for (const result of results) {
             for (const step of result.steps ?? []) {
                 if (step.task === 'check_governance' && step.passed && !step.skipped && step.observation_data) {
-                    if (!step.observation_data.governance_context) {
-                        anyCheckMissingContext = true;
+                    if (!step.observation_data.governance_context && !firstMissing) {
+                        firstMissing = { storyboard_id: result.scenario, step_id: step.step };
                     }
                 }
             }
         }
-        if (anyCheckMissingContext) {
+        if (firstMissing) {
             observations.push({
                 category: 'best_practice',
                 severity: 'warning',
                 track,
                 message: 'Governance agent did not return governance_context on check_governance response. ' +
                     'Without it, sellers cannot maintain governance continuity across the media buy lifecycle.',
+                source: {
+                    kind: 'storyboard_step',
+                    code: 'missing-governance-context',
+                    storyboard_id: firstMissing.storyboard_id,
+                    step_id: firstMissing.step_id,
+                },
             });
         }
     }
@@ -351,6 +434,12 @@ function collectObservations(track, results, profile) {
                     track,
                     message: `Step "${step.step}" took ${(step.duration_ms / 1000).toFixed(1)}s. Buyers expect sub-5s responses.`,
                     evidence: { step: step.step, duration_ms: step.duration_ms },
+                    source: {
+                        kind: 'storyboard_step',
+                        code: 'slow-response',
+                        storyboard_id: result.scenario,
+                        step_id: step.step,
+                    },
                 });
             }
         }
@@ -724,6 +813,7 @@ async function complyImpl(agentUrl, options) {
                 severity: 'info',
                 message: `Discovered ${profile.tools.length} tools: [${profile.tools.join(', ')}]`,
                 evidence: { tools: profile.tools },
+                source: { kind: 'profile', code: 'tools-discovered' },
             });
         }
         // Warn loudly when the runner can't make a capability-driven decision — either
@@ -744,6 +834,7 @@ async function complyImpl(agentUrl, options) {
                         `Only universal storyboards ran — domain and specialism bundles were skipped. ` +
                         `Agent-reported error: ${fenceAgentText(profile.capabilities_probe_error)}`,
                     evidence: { agent_reported_error: profile.capabilities_probe_error },
+                    source: { kind: 'profile', code: 'capabilities-probe-failed' },
                 });
             }
             else if (!profile.tools.includes('get_adcp_capabilities')) {
@@ -752,6 +843,7 @@ async function complyImpl(agentUrl, options) {
                     severity: 'warning',
                     message: 'Agent does not implement get_adcp_capabilities — ran universal storyboards only. ' +
                         'Domain baselines and specialisms cannot be tested without a capabilities response.',
+                    source: { kind: 'profile', code: 'capabilities-missing' },
                 });
             }
             else if (!profile.supported_protocols?.length) {
@@ -760,6 +852,7 @@ async function complyImpl(agentUrl, options) {
                     severity: 'warning',
                     message: 'get_adcp_capabilities returned no supported_protocols — ran universal storyboards only. ' +
                         'Agent must declare at least one domain protocol to be fully tested.',
+                    source: { kind: 'profile', code: 'no-supported-protocols' },
                 });
             }
         }
@@ -916,7 +1009,16 @@ async function complyImpl(agentUrl, options) {
             }
         }
         const summary = buildSummary(trackResults, storyboardResults);
-        const testedTracks = trackResults.filter(t => t.status === 'pass' || t.status === 'fail' || t.status === 'partial' || t.status === 'silent');
+        // Tag `_view` so grep-style triage can distinguish the canonical
+        // `tracks` entry from its appearance under the `tested_tracks` filter
+        // (adcp-client#1674). Shallow-copy on the `tested_tracks` side keeps
+        // the shared nested `scenarios` references intact while preventing
+        // the marker from colliding on the same object.
+        for (const t of trackResults)
+            t._view = 'canonical';
+        const testedTracks = trackResults
+            .filter(t => t.status === 'pass' || t.status === 'fail' || t.status === 'partial' || t.status === 'silent')
+            .map(t => ({ ...t, _view: 'reference' }));
         const skippedTracks = trackResults
             .filter(t => t.status === 'skip')
             .map(t => ({
@@ -1057,6 +1159,7 @@ async function detectAuthRejection(agentUrl, errorMsg, signal) {
                     `Inline: adcp storyboard run ${agentUrl} --oauth (requires a saved alias). ` +
                     `Save once: adcp --save-auth <alias> ${agentUrl} --oauth.`,
                 ...(oauthMeta?.issuer && { evidence: { oauth_issuer: oauthMeta.issuer } }),
+                source: { kind: 'probe', code: 'auth-oauth-required' },
             });
         }
         else {
@@ -1064,6 +1167,7 @@ async function detectAuthRejection(agentUrl, errorMsg, signal) {
                 category: 'auth',
                 severity: 'error',
                 message: 'Agent returned 401. Check your --auth token.',
+                source: { kind: 'probe', code: 'auth-401' },
             });
         }
     }
@@ -1119,12 +1223,19 @@ async function runWithDegradedProfile(agentUrl, profile, storyboards, options, e
     const overallStatus = computeOverallStatus(summary);
     const agentRef = options.agent_alias || agentUrl;
     const failures = extractFailures(storyboardResults, storyboards, agentRef);
+    // Tag canonical vs reference views to disambiguate the same
+    // TrackResult appearing in both `tracks` and `tested_tracks`
+    // (adcp-client#1674).
+    for (const t of trackResults)
+        t._view = 'canonical';
     return {
         agent_url: agentUrl,
         agent_profile: profile,
         overall_status: overallStatus,
         tracks: trackResults,
-        tested_tracks: trackResults.filter(t => t.status === 'pass' || t.status === 'fail' || t.status === 'partial' || t.status === 'silent'),
+        tested_tracks: trackResults
+            .filter(t => t.status === 'pass' || t.status === 'fail' || t.status === 'partial' || t.status === 'silent')
+            .map(t => ({ ...t, _view: 'reference' })),
         skipped_tracks: [],
         summary,
         observations: allObservations,
@@ -1378,6 +1489,19 @@ function formatComplianceResults(result) {
                             ? '💡'
                             : 'ℹ️';
                 output += `${icon}  ${obs.message}\n`;
+                // Source coordinates: greppable rule code + storyboard/step
+                // pointers when applicable. Keeps the text surface scannable
+                // while making triage one keystroke away from the storyboard
+                // YAML that produced the finding (#1746).
+                if (obs.source) {
+                    const src = obs.source;
+                    const coord = src.kind === 'storyboard_step'
+                        ? ` (${src.code} · ${src.storyboard_id}/${src.step_id})`
+                        : src.kind === 'storyboard'
+                            ? ` (${src.code} · ${src.storyboard_id})`
+                            : ` (${src.code})`;
+                    output += `   ↳ source:${coord}\n`;
+                }
             }
         }
     }