@adcp/sdk 13.0.0 → 13.0.2

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

@@ -1 +1 @@
-{"version":3,"file":"compliance.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/compliance.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compliance.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/compliance.ts"],"names":[],"mappings":"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"}

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

@@ -45,6 +45,7 @@ var import_errors = require('../../errors/index.js');
 var import_adcp_version_config = require('../../utils/adcp-version-config.js');
 var import_schema_loader = require('../../validation/schema-loader.js');
 var import_synthesize = require('./request-signing/synthesize.js');
+var import_provenance = require('./provenance.js');
 class CapabilityResolutionError extends import_errors.ADCPError {
   code;
   specialism;
@@ -313,10 +314,18 @@ function loadStoryboardsFromDir(dir) {
 }
 function loadBundleStoryboards(ref) {
   const raw = ref.kind === "universal" ? safeLoadUniversal(ref.path) : loadStoryboardsFromDir(ref.path);
-  return raw.map((sb) => annotateStoryboardVersion(postProcessStoryboard(sb), ref.adcp_version));
-}
-function annotateStoryboardVersion(storyboard, adcpVersion) {
-  return adcpVersion === void 0 ? storyboard : { ...storyboard, adcp_version: adcpVersion };
+  const complianceDir = (0, import_path.dirname)((0, import_path.dirname)(ref.path));
+  return raw.map((sb) => annotateStoryboardVersion(postProcessStoryboard(sb), ref.adcp_version, complianceDir));
+}
+function annotateStoryboardVersion(storyboard, adcpVersion, complianceDir) {
+  return (0, import_provenance.markStoryboardComplianceRoot)(
+    {
+      ...storyboard,
+      ...adcpVersion !== void 0 && { adcp_version: adcpVersion },
+      compliance_dir: complianceDir
+    },
+    complianceDir
+  );
 }
 function safeLoadUniversal(path) {
   try {

package/dist/lib/testing/storyboard/compliance.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/testing/storyboard/compliance.ts"],"sourcesContent":["/**\n * Compliance-cache loader.\n *\n * Storyboards live on disk under `compliance/cache/{version}/` after\n * `npm run sync-schemas` pulls the `/protocol/{version}.tgz` bundle.\n * This module reads that tree, resolves `get_adcp_capabilities` →\n * storyboards to run, and supports ad-hoc single-storyboard loads for\n * spec evolution.\n */\n\nimport { readFileSync, readdirSync, existsSync, statSync } from 'fs';\nimport { basename, dirname, join, resolve } from 'path';\nimport { loadStoryboardFile } from './loader';\nimport { ADCP_VERSION } from '../../version';\nimport { ADCPError } from '../../errors';\nimport { isAdcpVersionSupported } from '../../utils/adcp-version-config';\nimport { hasSchemaBundle, resolveBundleKey } from '../../validation/schema-loader';\nimport { synthesizeRequestSigningSteps } from './request-signing/synthesize';\nimport type { RunnerSelectionResult, Storyboard } from './types';\n\n/**\n * Discriminator for configuration faults `resolveStoryboardsForCapabilities`\n * surfaces. `unknown_protocol` is reserved for future use — today it emits a\n * `console.warn` rather than throwing.\n */\nexport type CapabilityResolutionCode =\n  | 'specialism_parent_protocol_missing'\n  | 'unknown_specialism'\n  | 'unknown_protocol'\n  | 'unsupported_adcp_version';\n\n/**\n * Thrown when the agent's declared capabilities cannot be mapped onto the\n * compliance cache. These are agent-configuration faults, not network or\n * cache-integrity problems — callers should branch on `code` to distinguish\n * them from runtime failures rather than regexing `message`.\n */\nexport class CapabilityResolutionError extends ADCPError {\n  readonly code: CapabilityResolutionCode;\n  readonly specialism?: string;\n  readonly parentProtocol?: string;\n  readonly protocol?: string;\n\n  constructor(params: {\n    code: CapabilityResolutionCode;\n    message: string;\n    specialism?: string;\n    parentProtocol?: string;\n    protocol?: string;\n  }) {\n    super(params.message);\n    this.code = params.code;\n    if (params.specialism !== undefined) this.specialism = params.specialism;\n    if (params.parentProtocol !== undefined) this.parentProtocol = params.parentProtocol;\n    if (params.protocol !== undefined) this.protocol = params.protocol;\n  }\n}\n\n/**\n * Maps `supported_protocols` enum values (snake_case) to compliance-cache\n * path segments (kebab-case).\n *\n * Exported so the drift-alarm test can assert every spec enum value has a mapping.\n */\nexport const PROTOCOL_TO_PATH: Readonly<Record<string, string>> = Object.freeze({\n  media_buy: 'media-buy',\n  creative: 'creative',\n  signals: 'signals',\n  governance: 'governance',\n  brand: 'brand',\n  sponsored_intelligence: 'sponsored-intelligence',\n  measurement: 'measurement',\n});\n\nexport const UNBASELINED_SUPPORTED_PROTOCOLS: ReadonlySet<string> = new Set([\n  // Declared in get_adcp_capabilities.supported_protocols, but 3.1.0-beta.3\n  // ships no standalone compliance/protocols/measurement baseline yet.\n  'measurement',\n]);\n\n/**\n * Specialism enum values that are deprecated aliases for universal-bundle\n * storyboards. When an agent declares one of these in\n * `get_adcp_capabilities.specialisms`, resolution MUST NOT throw\n * `unknown_specialism` — the bundle lives in `universal/<file>.yaml` and\n * runs unconditionally already. The deprecated claim is honored for\n * backward compatibility per the universal storyboard's\n * \"Backward-compatible specialism claims\" clause (currently\n * `signed-requests`; see `universal/signed-requests.yaml` and the\n * `signed_requests_specialism_deprecated` notice emitted from\n * `runner.ts:collectCapabilityNotices`).\n *\n * Map shape: deprecated specialism enum value → universal bundle base name\n * (file under `universal/<name>.yaml`, matched against `index.universal`).\n * Removed in AdCP 4.0 along with the enum value itself\n * (adcontextprotocol/adcp#3075).\n */\nexport const DEPRECATED_SPECIALISM_UNIVERSAL_ALIASES: Readonly<Record<string, string>> = Object.freeze({\n  'signed-requests': 'signed-requests',\n});\n\nexport interface ComplianceIndexProtocol {\n  id: string;\n  title: string | null;\n  has_baseline: boolean;\n  path: string;\n}\n\nexport interface ComplianceIndexSpecialism {\n  id: string;\n  protocol: string;\n  title: string | null;\n  status: string;\n  path: string;\n}\n\nexport interface ComplianceIndex {\n  published_version?: string;\n  adcp_version: string;\n  generated_at: string;\n  universal: string[];\n  protocols: ComplianceIndexProtocol[];\n  specialisms: ComplianceIndexSpecialism[];\n}\n\nexport type BundleKind = 'universal' | 'protocol' | 'specialism';\n\nexport interface BundleRef {\n  kind: BundleKind;\n  /** `capability-discovery` for universal, `media-buy` for protocol, `sales-guaranteed` for specialism. */\n  id: string;\n  /** Path to the bundle directory (or YAML file, for universal bundles). */\n  path: string;\n  /** AdCP cache version this bundle came from. */\n  adcp_version?: string;\n}\n\nexport interface AgentCapabilities {\n  /** AdCP protocols the agent implements. Snake_case per schema. */\n  supported_protocols?: string[];\n  /** Optional specialisms the agent claims. */\n  specialisms?: string[];\n  /**\n   * AdCP major versions the agent declared (from `get_adcp_capabilities.adcp.major_versions`).\n   * When set, storyboards carrying `introduced_in: <major.minor>` whose major\n   * isn't in this list are filtered into `not_applicable` instead of being\n   * run against an agent that predates them. Unset → no version gating.\n   */\n  major_versions?: number[];\n  /**\n   * Exact/release-precision AdCP versions the seller supports, from\n   * `get_adcp_capabilities.adcp.supported_versions`. When present, the\n   * runner treats it as more specific than `major_versions`.\n   */\n  supported_versions?: string[];\n}\n\n/** Reason a storyboard was not run against an agent. */\nexport interface NotApplicableStoryboard {\n  storyboard_id: string;\n  storyboard_title: string;\n  /** Track this storyboard would have contributed to, if known. */\n  track?: string;\n  reason: string;\n  /** Selection reason when the storyboard was excluded before execution. */\n  selection_result?: RunnerSelectionResult;\n}\n\nexport interface ResolveOptions {\n  /** Explicit version override; defaults to the client's pinned ADCP_VERSION. */\n  version?: string;\n  /** Override the compliance cache root (tests use this to point at fixtures). */\n  complianceDir?: string;\n  /**\n   * Explicit schema bundle root to use with the selected compliance cache.\n   * The path must point at the schema-data directory for the cache version,\n   * for example `.../dist/lib/schemas-data/3.0`.\n   */\n  schemaRoot?: string;\n  /**\n   * Hosted badge compatibility alias. When set, a prerelease compliance cache\n   * for this stable line (for example cache `3.1.0-beta.7` with alias `3.1`)\n   * may be selected for a seller that advertises the stable line in\n   * `adcp.supported_versions`.\n   *\n   * This is deliberately scoped to a single resolver call. Normal wire-version\n   * negotiation and explicit beta diagnostic targets stay strict unless the\n   * caller opts in here.\n   */\n  hostedStableLineAlias?: string;\n}\n\nexport interface ResolvedBundle {\n  ref: BundleRef;\n  storyboards: Storyboard[];\n}\n\nexport interface ResolvedStoryboards {\n  bundles: ResolvedBundle[];\n  storyboards: Storyboard[];\n  /**\n   * Storyboards the agent's declared `major_versions` predates. Surfaced so\n   * callers can render a `not_applicable` row — silently dropping them would\n   * mean an agent that hasn't certified against a later spec version passes\n   * vacuously.\n   */\n  not_applicable: NotApplicableStoryboard[];\n}\n\nfunction getRepoRoot(): string {\n  // Walks from src/lib/testing/storyboard/ (or dist/lib/testing/storyboard/) → package root.\n  return resolve(__dirname, '..', '..', '..', '..');\n}\n\n/**\n * Resolve the compliance cache directory.\n *\n * Priority:\n *   1. `options.complianceDir` (explicit override, used by tests)\n *   2. `ADCP_COMPLIANCE_DIR` env var (full path including version dir, for packaged consumers)\n *   3. `{package-root}/compliance/cache/{version}` (default, ships with the npm package)\n */\nexport function getComplianceCacheDir(options: ResolveOptions = {}): string {\n  const configured = getConfiguredComplianceDir(options);\n  if (configured) return configured;\n  const version = options.version || readAdcpVersion();\n  return join(getRepoRoot(), 'compliance', 'cache', version);\n}\n\nfunction readAdcpVersion(): string {\n  // Compile-time ADCP_VERSION from src/lib/version.ts is the single source of truth\n  // at runtime. scripts/sync-schemas.ts still reads the text file — sync-version.ts\n  // keeps them aligned so the cache directory the lib expects matches what sync wrote.\n  return ADCP_VERSION;\n}\n\nfunction complianceMissingMessage(what: string, path: string): string {\n  return (\n    `${what} not found at ${path}. ` +\n    `The compliance cache ships with @adcp/sdk — run \\`npm i @adcp/sdk@latest\\` (or \\`npx @adcp/sdk@latest …\\`) to pick up the current cache. ` +\n    `If developing locally, run \\`npm run sync-schemas\\` to populate the cache.`\n  );\n}\n\n/** Load and parse `index.json` from the compliance cache. */\nexport function loadComplianceIndex(options: ResolveOptions = {}): ComplianceIndex {\n  const dir = getComplianceCacheDir(options);\n  const indexPath = join(dir, 'index.json');\n  if (!existsSync(indexPath)) {\n    throw new Error(complianceMissingMessage('Compliance cache', dir));\n  }\n  const index = JSON.parse(readFileSync(indexPath, 'utf-8')) as ComplianceIndex;\n  return normalizeComplianceIndex(index, options, indexPath);\n}\n\nexport function getExternalSchemaRootForCompliance(options: ResolveOptions, adcpVersion: string): string | undefined {\n  const configuredSchemaRoot = getConfiguredSchemaRoot(options);\n  if (configuredSchemaRoot) return configuredSchemaRoot;\n  // An explicit version still resolves through the package's default compliance\n  // cache. Probe from that directory too so preflight capability discovery uses\n  // the selected release's exact schema tree rather than whatever bundle the SDK\n  // happened to compile as its default.\n  const complianceDir =\n    getConfiguredComplianceDir(options) ?? (options.version !== undefined ? getComplianceCacheDir(options) : undefined);\n  const siblingSchemaRoot = complianceDir ? findExternalSchemaRoot(complianceDir, adcpVersion) : undefined;\n  if (siblingSchemaRoot) return siblingSchemaRoot;\n  if (options.version !== undefined || complianceDir !== undefined) {\n    assertComplianceSchemaBundleAvailable(options, adcpVersion, complianceDir);\n  }\n  return undefined;\n}\n\nfunction assertComplianceSchemaBundleAvailable(\n  options: ResolveOptions,\n  adcpVersion: string,\n  complianceDir: string | undefined\n): void {\n  if (hasSchemaBundle(adcpVersion)) return;\n  const selector = options.version ? `--compliance-version ${options.version}` : `compliance cache ${complianceDir}`;\n  const bundleKey = resolveBundleKey(adcpVersion);\n  throw new Error(\n    `${selector} selected AdCP compliance version \"${adcpVersion}\", but no matching schema bundle was found. ` +\n      `Refusing to validate storyboard responses with the installed default schemas. ` +\n      `Pass --schema-root PATH or set ADCP_SCHEMA_ROOT to a schema-data root for \"${adcpVersion}\" ` +\n      `(for example dist/lib/schemas-data/${bundleKey} or schemas/cache/${adcpVersion}), ` +\n      `or install/sync an @adcp/sdk package that includes that schema bundle.`\n  );\n}\n\nfunction getConfiguredComplianceDir(options: Pick<ResolveOptions, 'complianceDir'>): string | undefined {\n  return options.complianceDir ?? process.env.ADCP_COMPLIANCE_DIR;\n}\n\nfunction getConfiguredSchemaRoot(options: Pick<ResolveOptions, 'schemaRoot'>): string | undefined {\n  return options.schemaRoot ?? process.env.ADCP_SCHEMA_ROOT;\n}\n\nfunction normalizeComplianceIndex(index: ComplianceIndex, options: ResolveOptions, indexPath: string): ComplianceIndex {\n  if (index.adcp_version === 'latest') {\n    const repairedVersion = findReplacementForLatestComplianceVersion(index, options);\n    if (repairedVersion) {\n      return { ...index, adcp_version: repairedVersion };\n    }\n  }\n\n  assertValidComplianceIndexVersion(index.adcp_version, indexPath);\n  return index;\n}\n\nfunction findReplacementForLatestComplianceVersion(\n  index: ComplianceIndex,\n  options: ResolveOptions\n): string | undefined {\n  if (isValidComplianceIndexVersion(index.published_version)) return index.published_version;\n\n  const schemaRoot = getConfiguredSchemaRoot(options);\n  const configuredVersion = schemaRoot ? readSchemaRootAdcpVersion(schemaRoot) : undefined;\n  if (configuredVersion) return configuredVersion;\n\n  if (!options.complianceDir) return undefined;\n  return readSiblingSchemaAdcpVersion(options.complianceDir);\n}\n\nfunction readSchemaRootAdcpVersion(schemaRoot: string): string | undefined {\n  const roots = [schemaRoot];\n  if (basename(schemaRoot) === 'bundled') roots.push(dirname(schemaRoot));\n\n  for (const root of roots) {\n    const indexPath = join(root, 'index.json');\n    if (!existsSync(indexPath)) continue;\n    try {\n      const parsed = JSON.parse(readFileSync(indexPath, 'utf-8')) as { adcp_version?: unknown };\n      if (isValidComplianceIndexVersion(parsed.adcp_version)) return parsed.adcp_version;\n    } catch {\n      // Schema-root discovery is best-effort; the final compliance-index\n      // validation below owns the actionable error when no replacement exists.\n    }\n  }\n  for (const root of roots) {\n    const version = readSchemaIdVersion(root);\n    if (version) return version;\n  }\n  return undefined;\n}\n\nfunction readSchemaIdVersion(root: string): string | undefined {\n  const versions = new Set<string>();\n  const scanRoot = existsSync(join(root, 'bundled')) ? join(root, 'bundled') : root;\n  for (const file of walkJsonFiles(scanRoot)) {\n    try {\n      const parsed = JSON.parse(readFileSync(file, 'utf-8')) as { $id?: unknown };\n      if (typeof parsed.$id !== 'string') continue;\n      const version = parsed.$id.match(/\\/schemas\\/([^/]+)\\//)?.[1];\n      if (isValidComplianceIndexVersion(version)) versions.add(version);\n    } catch {\n      // Best-effort discovery; malformed schemas are handled by validation.\n    }\n  }\n  return versions.size === 1 ? [...versions][0] : undefined;\n}\n\nfunction readSiblingSchemaAdcpVersion(complianceDir: string): string | undefined {\n  for (const schemaRoot of schemaRootCandidatesForComplianceDir(complianceDir)) {\n    const version = readSchemaRootAdcpVersion(schemaRoot);\n    if (version) return version;\n  }\n  return undefined;\n}\n\nfunction isValidComplianceIndexVersion(version: unknown): version is string {\n  if (typeof version !== 'string') return false;\n  try {\n    resolveBundleKey(version);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction assertValidComplianceIndexVersion(version: string, indexPath: string): void {\n  try {\n    resolveBundleKey(version);\n  } catch (err) {\n    const reason = err instanceof Error ? err.message : String(err);\n    throw new Error(\n      `Compliance cache ${indexPath} declares invalid adcp_version ${JSON.stringify(version)}. ` +\n        `adcp_version must be a real AdCP bundle version, not a selector alias such as \"latest\". ` +\n        `If this is a local development bundle, pass ADCP_SCHEMA_ROOT or --schema-root pointing at the matching schema bundle. ` +\n        reason\n    );\n  }\n}\n\nfunction findExternalSchemaRoot(complianceDir: string, adcpVersion: string): string | undefined {\n  const candidates = [complianceDir, ...schemaRootCandidatesForComplianceDir(complianceDir, adcpVersion)];\n  return candidates.find(hasSchemaRootShape);\n}\n\nfunction schemaRootCandidatesForComplianceDir(complianceDir: string, adcpVersion?: string): string[] {\n  const candidates = new Set<string>();\n  const packageRoots = packageRootCandidatesForComplianceDir(complianceDir);\n  const add = (candidate: string) => candidates.add(candidate);\n\n  for (const packageRoot of packageRoots) {\n    addVersionedSchemaRoots(packageRoot, adcpVersion ?? ADCP_VERSION, add);\n  }\n  if (adcpVersion === undefined) {\n    for (const packageRoot of packageRoots) {\n      addSchemaContainerChildren(join(packageRoot, 'dist', 'lib', 'schemas-data'), add);\n      addSchemaContainerChildren(join(packageRoot, 'dist', 'schemas'), add);\n      addSchemaContainerChildren(join(packageRoot, 'schemas', 'cache'), add);\n    }\n  }\n\n  return [...candidates];\n}\n\nfunction addVersionedSchemaRoots(packageRoot: string, adcpVersion: string, add: (candidate: string) => void): void {\n  const key = resolveBundleKey(adcpVersion);\n  // Prefer exact release roots before stable-minor aliases. Patch releases\n  // normally share wire shape, but an explicitly selected compliance kit is\n  // the authority for its own preflight validation and must not be shadowed\n  // by an older `3.1` bundle left in dist.\n  add(join(packageRoot, 'dist', 'lib', 'schemas-data', adcpVersion));\n  add(join(packageRoot, 'dist', 'schemas', adcpVersion));\n  add(join(packageRoot, 'schemas', 'cache', adcpVersion));\n  add(join(packageRoot, 'dist', 'lib', 'schemas-data', key));\n  add(join(packageRoot, 'dist', 'schemas', key));\n  add(join(packageRoot, 'schemas', 'cache', key));\n}\n\nfunction addSchemaContainerChildren(container: string, add: (candidate: string) => void): void {\n  if (!existsSync(container)) return;\n  for (const entry of readdirSync(container).sort().reverse()) {\n    const full = join(container, entry);\n    try {\n      if (statSync(full).isDirectory()) add(full);\n    } catch {\n      // Best-effort sibling discovery; ignore entries that disappear mid-scan.\n    }\n  }\n}\n\nfunction packageRootCandidatesForComplianceDir(complianceDir: string): string[] {\n  const roots = new Set<string>();\n  const resolved = resolve(complianceDir);\n  let current = resolved;\n\n  while (true) {\n    if (basename(current) === 'compliance') {\n      const parent = dirname(current);\n      if (basename(parent) === 'dist') roots.add(dirname(parent));\n      roots.add(parent);\n    }\n    const next = dirname(current);\n    if (next === current) break;\n    current = next;\n  }\n\n  roots.add(dirname(dirname(dirname(resolved))));\n  return [...roots];\n}\n\nfunction hasSchemaRootShape(root: string): boolean {\n  if (!existsSync(root)) return false;\n  const scanRoot = existsSync(join(root, 'bundled')) ? join(root, 'bundled') : root;\n  return walkJsonFiles(scanRoot).some(file => {\n    try {\n      const parsed = JSON.parse(readFileSync(file, 'utf-8')) as { $id?: unknown; $schema?: unknown };\n      return typeof parsed.$id === 'string' || typeof parsed.$schema === 'string';\n    } catch {\n      return false;\n    }\n  });\n}\n\nfunction walkJsonFiles(dir: string): string[] {\n  if (!existsSync(dir)) return [];\n  const out: string[] = [];\n  for (const entry of readdirSync(dir, { withFileTypes: true })) {\n    const full = join(dir, entry.name);\n    if (entry.isDirectory()) out.push(...walkJsonFiles(full));\n    else if (entry.isFile() && entry.name.endsWith('.json')) out.push(full);\n  }\n  return out;\n}\n\n/**\n * Load every storyboard YAML under a directory tree (non-recursive for files at the top\n * level of a bundle, recursive for nested `scenarios/`). YAMLs that don't have a top-level\n * `id:` (schema / fixture files) are skipped.\n */\nfunction loadStoryboardsFromDir(dir: string): Storyboard[] {\n  if (!existsSync(dir)) return [];\n  const storyboards: Storyboard[] = [];\n  const visit = (current: string) => {\n    // Sort entries so ordering is deterministic across filesystems.\n    const entries = readdirSync(current).sort();\n    // Prefer index.yaml first so bundle-as-id lookups resolve to the main storyboard.\n    entries.sort((a, b) => {\n      if (a === 'index.yaml') return -1;\n      if (b === 'index.yaml') return 1;\n      return 0;\n    });\n    for (const entry of entries) {\n      const full = join(current, entry);\n      const stat = statSync(full);\n      if (stat.isDirectory()) {\n        visit(full);\n      } else if (entry.endsWith('.yaml') || entry.endsWith('.yml')) {\n        try {\n          storyboards.push(loadStoryboardFile(full));\n        } catch (err) {\n          // Peek at the file — if it has an `id:` line it was meant to be a\n          // storyboard and the error is a real problem; otherwise it's a schema\n          // or fixture file (e.g., storyboard-schema.yaml) and silence is fine.\n          try {\n            const text = readFileSync(full, 'utf-8');\n            if (/^id:\\s*\\S/m.test(text)) {\n              console.warn(`[compliance] Failed to parse storyboard ${full}: ${(err as Error).message}`);\n            }\n          } catch {\n            /* unreadable file — treat as non-storyboard */\n          }\n        }\n      }\n    }\n  };\n  visit(dir);\n  return storyboards;\n}\n\n/** Load storyboards for a single bundle (universal YAML file, domain dir, or specialism dir). */\nexport function loadBundleStoryboards(ref: BundleRef): Storyboard[] {\n  const raw = ref.kind === 'universal' ? safeLoadUniversal(ref.path) : loadStoryboardsFromDir(ref.path);\n  return raw.map(sb => annotateStoryboardVersion(postProcessStoryboard(sb), ref.adcp_version));\n}\n\nfunction annotateStoryboardVersion(storyboard: Storyboard, adcpVersion: string | undefined): Storyboard {\n  return adcpVersion === undefined ? storyboard : { ...storyboard, adcp_version: adcpVersion };\n}\n\nfunction safeLoadUniversal(path: string): Storyboard[] {\n  try {\n    return [loadStoryboardFile(path)];\n  } catch {\n    return [];\n  }\n}\n\n/**\n * Post-process storyboards loaded from the cache. The signed-requests\n * specialism ships phases whose steps are generated at runtime from the\n * request-signing test vectors; synthesize them here so downstream callers\n * (the runner, CLI tooling, reporting) see a fully-populated storyboard.\n */\nfunction postProcessStoryboard(storyboard: Storyboard): Storyboard {\n  if (storyboard.id === 'signed_requests') {\n    try {\n      return synthesizeRequestSigningSteps(storyboard);\n    } catch (err) {\n      // Synthesis failure = infrastructural problem (cache missing vectors,\n      // schema drift, etc.). Emit a synthetic failing phase so the runner's\n      // existing reporting surfaces the cause — silent empty-phase fallback\n      // would render as a green pass with 0 steps, which is the worst\n      // possible outcome for CI pipelines.\n      return withSynthesisErrorPhase(storyboard, err);\n    }\n  }\n  return storyboard;\n}\n\nfunction withSynthesisErrorPhase(storyboard: Storyboard, err: unknown): Storyboard {\n  const message = err instanceof Error ? err.message : String(err);\n  const errorPhase = {\n    id: 'synthesis_error',\n    title: 'Request-signing vector synthesis failed',\n    narrative:\n      'The signed-requests specialism requires its phases to be synthesized at load time ' +\n      'from the compliance cache. Synthesis failed — the runner cannot grade against the ' +\n      'conformance vectors. Run `npm run sync-schemas` to refresh the cache.',\n    steps: [\n      {\n        id: 'synthesis_error',\n        title: 'Synthesize vector phases',\n        task: 'synthesis_error',\n        narrative: message,\n        expect_error: false,\n      },\n    ],\n  };\n  return { ...storyboard, phases: [errorPhase, ...storyboard.phases] };\n}\n\n/** Enumerate every bundle present in the cache (universal + protocols + specialisms). */\nexport function listBundles(options: ResolveOptions = {}): BundleRef[] {\n  const dir = getComplianceCacheDir(options);\n  const index = loadComplianceIndex(options);\n  const bundles: BundleRef[] = [];\n\n  for (const name of index.universal) {\n    bundles.push({\n      kind: 'universal',\n      id: name,\n      path: join(dir, 'universal', `${name}.yaml`),\n      adcp_version: index.adcp_version,\n    });\n  }\n  for (const protocol of index.protocols) {\n    if (!protocol.has_baseline) continue;\n    bundles.push({\n      kind: 'protocol',\n      id: protocol.id,\n      path: join(dir, 'protocols', protocol.id),\n      adcp_version: index.adcp_version,\n    });\n  }\n  for (const specialism of index.specialisms) {\n    bundles.push({\n      kind: 'specialism',\n      id: specialism.id,\n      path: join(dir, 'specialisms', specialism.id),\n      adcp_version: index.adcp_version,\n    });\n  }\n  return bundles;\n}\n\n/** List every storyboard the cache can produce, across all bundles. */\nexport function listAllComplianceStoryboards(options: ResolveOptions = {}): Storyboard[] {\n  const seen = new Set<string>();\n  const storyboards: Storyboard[] = [];\n  for (const ref of listBundles(options)) {\n    for (const sb of loadBundleStoryboards(ref)) {\n      if (seen.has(sb.id)) continue;\n      seen.add(sb.id);\n      storyboards.push(sb);\n    }\n  }\n  return storyboards;\n}\n\n/**\n * Find a storyboard by its internal `id` (the YAML's `id:` field).\n * Scans every bundle in the cache. Returns undefined if no match.\n */\nexport function getComplianceStoryboardById(id: string, options: ResolveOptions = {}): Storyboard | undefined {\n  for (const sb of listAllComplianceStoryboards(options)) {\n    if (sb.id === id) return sb;\n  }\n  return undefined;\n}\n\n/** Find a bundle by its directory/file id (`media-buy`, `sales-guaranteed`, `capability-discovery`). */\nexport function findBundleById(id: string, options: ResolveOptions = {}): BundleRef | undefined {\n  return listBundles(options).find(b => b.id === id);\n}\n\n/**\n * Resolved view of a specialism for the `adcp specialism show` CLI: the\n * specialism's own storyboard plus every protocol scenario it pulls in via\n * `requires_scenarios`. Useful as a pre-flight \"what will CI actually run\n * against my server?\" answer.\n */\nexport interface SpecialismDetail {\n  slug: string;\n  protocol: string;\n  status: string;\n  /** Title from index.json (kept separate from storyboard.title for fallback). */\n  index_title: string | null;\n  /** The specialism's own index.yaml parsed as a Storyboard. */\n  storyboard: Storyboard;\n  /**\n   * Required scenarios pulled in from protocol bundles via the index.yaml's\n   * `requires_scenarios` field. Each entry is a fully-resolved Storyboard;\n   * `unresolved` lists references that did not match a storyboard in the cache.\n   */\n  required_scenarios: Storyboard[];\n  unresolved_scenarios: string[];\n  /** Required tools declared by the specialism (from the index entry). */\n  required_tools: string[];\n}\n\nexport function loadSpecialismDetail(slug: string, options: ResolveOptions = {}): SpecialismDetail {\n  const index = loadComplianceIndex(options);\n  const entry = index.specialisms.find(s => s.id === slug);\n  if (!entry) {\n    const known = index.specialisms.map(s => s.id).join(', ');\n    throw new Error(`Unknown specialism \"${slug}\". Known specialisms: ${known}`);\n  }\n\n  const bundleStoryboards = loadBundleStoryboards({\n    kind: 'specialism',\n    id: slug,\n    path: join(getComplianceCacheDir(options), 'specialisms', slug),\n    adcp_version: index.adcp_version,\n  });\n  const storyboard = bundleStoryboards.find(sb => sb.category === entry.id.replace(/-/g, '_')) ?? bundleStoryboards[0];\n  if (!storyboard) {\n    throw new Error(\n      `Specialism \"${slug}\" loaded no storyboards from ${join(getComplianceCacheDir(options), 'specialisms', slug)}`\n    );\n  }\n\n  const required: Storyboard[] = [];\n  const unresolved: string[] = [];\n  for (const ref of storyboard.requires_scenarios ?? []) {\n    // Scenario YAMLs declare `id: <category>/<scenario_id>` — the slash\n    // form is the storyboard's own id and the only safe lookup. Bare-id\n    // fallbacks would silently match across categories once future caches\n    // ship scenarios with colliding tail segments — better to surface drift\n    // through `unresolved_scenarios` than mask it with a wrong-category hit.\n    const sb = getComplianceStoryboardById(ref, options);\n    if (sb) required.push(sb);\n    else unresolved.push(ref);\n  }\n\n  // index.json carries the canonical required_tools list — fall back to the\n  // storyboard's own field if the index entry is missing it.\n  const requiredTools =\n    (entry as ComplianceIndexSpecialism & { required_tools?: string[] }).required_tools ??\n    storyboard.required_tools ??\n    [];\n\n  return {\n    slug,\n    protocol: entry.protocol,\n    status: entry.status,\n    index_title: entry.title,\n    storyboard,\n    required_scenarios: required,\n    unresolved_scenarios: unresolved,\n    required_tools: requiredTools,\n  };\n}\n\nexport function listSpecialisms(options: ResolveOptions = {}): ComplianceIndexSpecialism[] {\n  return loadComplianceIndex(options).specialisms;\n}\n\n/**\n * Resolve either a bundle id or a storyboard id to a storyboard set.\n * Bundle ids expand to every storyboard in the bundle (index + scenarios).\n * Storyboard ids resolve to that single storyboard.\n *\n * Used for targeted `storyboard run <agent> <id>` invocations.\n */\nexport function resolveBundleOrStoryboard(id: string, options: ResolveOptions = {}): Storyboard[] {\n  const bundle = findBundleById(id, options);\n  if (bundle) return loadBundleStoryboards(bundle);\n  const sb = getComplianceStoryboardById(id, options);\n  return sb ? [sb] : [];\n}\n\n/**\n * Given the agent's `get_adcp_capabilities` response, resolve the set of\n * storyboards the compliance runner should execute:\n *\n *   universal   — every universal bundle (mandatory for every agent)\n *   protocols   — baseline for each declared `supported_protocols` entry\n *   specialisms — every declared specialism\n *\n * Throws `CapabilityResolutionError` (fail-closed) when the declared\n * capabilities cannot be mapped onto the cache:\n *\n *   - `unknown_specialism` — declared specialism has no bundle (usually stale\n *     cache — run `npm run sync-schemas`).\n *   - `specialism_parent_protocol_missing` — declared specialism rolls up to\n *     a protocol the agent didn't include in `supported_protocols`.\n *\n * Unknown `supported_protocols` entries are logged as warnings and skipped\n * rather than thrown (fail-open), so a single bad entry doesn't block the run.\n */\nexport function resolveStoryboardsForCapabilities(\n  caps: AgentCapabilities,\n  options: ResolveOptions = {}\n): ResolvedStoryboards {\n  const index = loadComplianceIndex(options);\n  assertSupportedComplianceVersion(index.adcp_version, caps.supported_versions, options);\n  const cacheDir = getComplianceCacheDir(options);\n  const bundles: ResolvedBundle[] = [];\n  const storyboards: Storyboard[] = [];\n  const notApplicable: NotApplicableStoryboard[] = [];\n  const seenStoryboards = new Set<string>();\n\n  const push = (ref: BundleRef) => {\n    const sbs = loadBundleStoryboards(ref);\n    bundles.push({ ref, storyboards: sbs });\n    for (const sb of sbs) {\n      if (seenStoryboards.has(sb.id)) continue;\n      seenStoryboards.add(sb.id);\n      const gate = checkVersionGate(sb, caps.major_versions);\n      if (gate) {\n        notApplicable.push({\n          storyboard_id: sb.id,\n          storyboard_title: sb.title,\n          track: sb.track,\n          reason: gate,\n          selection_result: { reason: 'version_excluded', detail: gate },\n        });\n        continue;\n      }\n      storyboards.push(sb);\n    }\n  };\n\n  for (const name of index.universal) {\n    push({\n      kind: 'universal',\n      id: name,\n      path: join(cacheDir, 'universal', `${name}.yaml`),\n      adcp_version: index.adcp_version,\n    });\n  }\n\n  const declaredProtocols = caps.supported_protocols ?? [];\n  const declaredProtocolIds = new Set<string>();\n  for (const protocol of declaredProtocols) {\n    // Legacy: older agents listed `compliance_testing` under supported_protocols.\n    // The current schema declares it via the top-level `compliance_testing`\n    // capability block instead, and it has no compliance baseline. Skip silently.\n    if (protocol === 'compliance_testing' || UNBASELINED_SUPPORTED_PROTOCOLS.has(protocol)) continue;\n\n    const protocolId = PROTOCOL_TO_PATH[protocol];\n    if (!protocolId) {\n      // Unknown protocol — likely a newer spec version or a typo. Mirror the\n      // fail-closed posture on specialisms: surface it loudly, but as a warning\n      // on stderr so a single bad entry doesn't block the full run.\n      console.warn(\n        `[resolveStoryboardsForCapabilities] Unknown supported_protocols entry \"${protocol}\". ` +\n          `This is ignored; compliance cache may be stale or the agent is on a newer AdCP version.`\n      );\n      continue;\n    }\n    const entry = index.protocols.find(d => d.id === protocolId);\n    if (!entry || !entry.has_baseline) continue;\n    declaredProtocolIds.add(protocolId);\n    push({\n      kind: 'protocol',\n      id: protocolId,\n      path: join(cacheDir, 'protocols', protocolId),\n      adcp_version: index.adcp_version,\n    });\n  }\n\n  const declaredSpecialisms = caps.specialisms ?? [];\n  for (const specialism of declaredSpecialisms) {\n    const entry = index.specialisms.find(s => s.id === specialism);\n    if (!entry) {\n      // Deprecated alias path: some 3.0-era specialism enum values now resolve\n      // to a `universal/` bundle (e.g. `signed-requests` → `universal/signed-requests.yaml`).\n      // The universal storyboard is pushed unconditionally above; the deprecated\n      // claim is graded there and the deprecation notice fires from runner.ts.\n      // Don't throw — that would block every other storyboard.\n      const universalAlias = DEPRECATED_SPECIALISM_UNIVERSAL_ALIASES[specialism];\n      if (universalAlias && index.universal.includes(universalAlias)) {\n        continue;\n      }\n      throw new CapabilityResolutionError({\n        code: 'unknown_specialism',\n        specialism,\n        message:\n          `Agent declared specialism \"${specialism}\" but no bundle exists at ` +\n          `${join(cacheDir, 'specialisms', specialism)}. ` +\n          `Known specialisms: ${index.specialisms.map(s => s.id).join(', ')}. ` +\n          `Compliance cache version: ${index.adcp_version}. ` +\n          `This usually means the cache is stale — run \\`npm run sync-schemas\\`.`,\n      });\n    }\n    // Each specialism rolls up to one parent protocol; the spec requires the parent\n    // to also be declared in supported_protocols. AAO enforces this server-side,\n    // but catching it client-side stops us from running orphan scenarios.\n    if (entry.protocol && !declaredProtocolIds.has(entry.protocol)) {\n      throw new CapabilityResolutionError({\n        code: 'specialism_parent_protocol_missing',\n        specialism,\n        parentProtocol: entry.protocol,\n        message:\n          `Agent declared specialism \"${specialism}\" (parent protocol: ${entry.protocol}) ` +\n          `but did not include \"${entry.protocol}\" in supported_protocols. ` +\n          `Every specialism must roll up to a declared protocol per the AdCP spec.`,\n      });\n    }\n    push({\n      kind: 'specialism',\n      id: specialism,\n      path: join(cacheDir, 'specialisms', specialism),\n      adcp_version: index.adcp_version,\n    });\n  }\n\n  return { bundles, storyboards, not_applicable: notApplicable };\n}\n\nexport function isComplianceVersionSupported(\n  cacheVersion: string,\n  supportedVersions: readonly string[],\n  options: Pick<ResolveOptions, 'hostedStableLineAlias'> = {}\n): boolean {\n  return (\n    isAdcpVersionSupported(cacheVersion, supportedVersions) ||\n    isHostedStableLineAliasSupported(cacheVersion, supportedVersions, options.hostedStableLineAlias)\n  );\n}\n\nfunction assertSupportedComplianceVersion(\n  cacheVersion: string,\n  supportedVersions: string[] | undefined,\n  options: Pick<ResolveOptions, 'hostedStableLineAlias'> = {}\n): void {\n  if (!supportedVersions || supportedVersions.length === 0) return;\n  if (isComplianceVersionSupported(cacheVersion, supportedVersions, options)) return;\n  throw new CapabilityResolutionError({\n    code: 'unsupported_adcp_version',\n    message:\n      `Compliance cache version ${cacheVersion} is not supported by this seller. ` +\n      `Seller advertises adcp.supported_versions [${supportedVersions.join(', ')}]. ` +\n      `Install or select a compatible compliance cache instead of relying on major_versions alone.`,\n  });\n}\n\nfunction isHostedStableLineAliasSupported(\n  cacheVersion: string,\n  supportedVersions: readonly string[],\n  hostedStableLineAlias: string | undefined\n): boolean {\n  if (!hostedStableLineAlias || supportedVersions.length === 0) return false;\n  const cacheLine = stableLineOf(cacheVersion);\n  const aliasLine = stableLineOf(hostedStableLineAlias);\n  if (!cacheLine || !aliasLine || cacheLine !== aliasLine) return false;\n  if (!isPrereleaseVersion(cacheVersion)) return false;\n  return isAdcpVersionSupported(hostedStableLineAlias, supportedVersions);\n}\n\nfunction stableLineOf(version: string): string | undefined {\n  const match = /^(?:v)?(\\d+)\\.(\\d+)(?:\\.|$|-)/.exec(version);\n  return match?.[1] && match?.[2] ? `${match[1]}.${match[2]}` : undefined;\n}\n\nfunction isPrereleaseVersion(version: string): boolean {\n  return /^\\d+\\.\\d+(?:\\.\\d+)?-/.test(version);\n}\n\n/**\n * Compare a storyboard's `introduced_in` (e.g., \"3.1\") against an agent's\n * declared `major_versions` (e.g., `[3]`). Returns a reason string when the\n * storyboard should be gated out; undefined when it applies.\n *\n * Grammar: `introduced_in` is `<major>` or `<major>.<minor>` — only the major\n * is consulted for filtering. Minor/patch components are kept on the storyboard\n * for reporting but don't drive the gate because the spec's `major_versions`\n * array only carries majors.\n *\n * When either side is absent the gate is a no-op: agents that don't declare\n * `major_versions` (v2 synthetic profiles, discovery failures) run every\n * storyboard, and storyboards without `introduced_in` always apply.\n */\nfunction checkVersionGate(sb: Storyboard, agentMajors: number[] | undefined): string | undefined {\n  if (!sb.introduced_in || !agentMajors || agentMajors.length === 0) return undefined;\n  const parsed = parseIntroducedIn(sb.introduced_in);\n  if (parsed === undefined) return undefined; // unparseable → don't block\n  if (agentMajors.includes(parsed)) return undefined;\n  const declared = agentMajors\n    .slice()\n    .sort((a, b) => a - b)\n    .join(', ');\n  return `Introduced in AdCP ${sb.introduced_in}; agent declares major_versions [${declared}].`;\n}\n\nfunction parseIntroducedIn(value: string): number | undefined {\n  const match = /^\\s*(\\d+)(?:\\.\\d+)*\\s*$/.exec(value);\n  if (!match?.[1]) return undefined;\n  const major = Number.parseInt(match[1], 10);\n  return Number.isFinite(major) ? major : undefined;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../src/lib/testing/storyboard/compliance.ts"],"sourcesContent":["/**\n * Compliance-cache loader.\n *\n * Storyboards live on disk under `compliance/cache/{version}/` after\n * `npm run sync-schemas` pulls the `/protocol/{version}.tgz` bundle.\n * This module reads that tree, resolves `get_adcp_capabilities` →\n * storyboards to run, and supports ad-hoc single-storyboard loads for\n * spec evolution.\n */\n\nimport { readFileSync, readdirSync, existsSync, statSync } from 'fs';\nimport { basename, dirname, join, resolve } from 'path';\nimport { loadStoryboardFile } from './loader';\nimport { ADCP_VERSION } from '../../version';\nimport { ADCPError } from '../../errors';\nimport { isAdcpVersionSupported } from '../../utils/adcp-version-config';\nimport { hasSchemaBundle, resolveBundleKey } from '../../validation/schema-loader';\nimport { synthesizeRequestSigningSteps } from './request-signing/synthesize';\nimport { markStoryboardComplianceRoot } from './provenance';\nimport type { RunnerSelectionResult, Storyboard } from './types';\n\n/**\n * Discriminator for configuration faults `resolveStoryboardsForCapabilities`\n * surfaces. `unknown_protocol` is reserved for future use — today it emits a\n * `console.warn` rather than throwing.\n */\nexport type CapabilityResolutionCode =\n  | 'specialism_parent_protocol_missing'\n  | 'unknown_specialism'\n  | 'unknown_protocol'\n  | 'unsupported_adcp_version';\n\n/**\n * Thrown when the agent's declared capabilities cannot be mapped onto the\n * compliance cache. These are agent-configuration faults, not network or\n * cache-integrity problems — callers should branch on `code` to distinguish\n * them from runtime failures rather than regexing `message`.\n */\nexport class CapabilityResolutionError extends ADCPError {\n  readonly code: CapabilityResolutionCode;\n  readonly specialism?: string;\n  readonly parentProtocol?: string;\n  readonly protocol?: string;\n\n  constructor(params: {\n    code: CapabilityResolutionCode;\n    message: string;\n    specialism?: string;\n    parentProtocol?: string;\n    protocol?: string;\n  }) {\n    super(params.message);\n    this.code = params.code;\n    if (params.specialism !== undefined) this.specialism = params.specialism;\n    if (params.parentProtocol !== undefined) this.parentProtocol = params.parentProtocol;\n    if (params.protocol !== undefined) this.protocol = params.protocol;\n  }\n}\n\n/**\n * Maps `supported_protocols` enum values (snake_case) to compliance-cache\n * path segments (kebab-case).\n *\n * Exported so the drift-alarm test can assert every spec enum value has a mapping.\n */\nexport const PROTOCOL_TO_PATH: Readonly<Record<string, string>> = Object.freeze({\n  media_buy: 'media-buy',\n  creative: 'creative',\n  signals: 'signals',\n  governance: 'governance',\n  brand: 'brand',\n  sponsored_intelligence: 'sponsored-intelligence',\n  measurement: 'measurement',\n});\n\nexport const UNBASELINED_SUPPORTED_PROTOCOLS: ReadonlySet<string> = new Set([\n  // Declared in get_adcp_capabilities.supported_protocols, but 3.1.0-beta.3\n  // ships no standalone compliance/protocols/measurement baseline yet.\n  'measurement',\n]);\n\n/**\n * Specialism enum values that are deprecated aliases for universal-bundle\n * storyboards. When an agent declares one of these in\n * `get_adcp_capabilities.specialisms`, resolution MUST NOT throw\n * `unknown_specialism` — the bundle lives in `universal/<file>.yaml` and\n * runs unconditionally already. The deprecated claim is honored for\n * backward compatibility per the universal storyboard's\n * \"Backward-compatible specialism claims\" clause (currently\n * `signed-requests`; see `universal/signed-requests.yaml` and the\n * `signed_requests_specialism_deprecated` notice emitted from\n * `runner.ts:collectCapabilityNotices`).\n *\n * Map shape: deprecated specialism enum value → universal bundle base name\n * (file under `universal/<name>.yaml`, matched against `index.universal`).\n * Removed in AdCP 4.0 along with the enum value itself\n * (adcontextprotocol/adcp#3075).\n */\nexport const DEPRECATED_SPECIALISM_UNIVERSAL_ALIASES: Readonly<Record<string, string>> = Object.freeze({\n  'signed-requests': 'signed-requests',\n});\n\nexport interface ComplianceIndexProtocol {\n  id: string;\n  title: string | null;\n  has_baseline: boolean;\n  path: string;\n}\n\nexport interface ComplianceIndexSpecialism {\n  id: string;\n  protocol: string;\n  title: string | null;\n  status: string;\n  path: string;\n}\n\nexport interface ComplianceIndex {\n  published_version?: string;\n  adcp_version: string;\n  generated_at: string;\n  universal: string[];\n  protocols: ComplianceIndexProtocol[];\n  specialisms: ComplianceIndexSpecialism[];\n}\n\nexport type BundleKind = 'universal' | 'protocol' | 'specialism';\n\nexport interface BundleRef {\n  kind: BundleKind;\n  /** `capability-discovery` for universal, `media-buy` for protocol, `sales-guaranteed` for specialism. */\n  id: string;\n  /** Path to the bundle directory (or YAML file, for universal bundles). */\n  path: string;\n  /** AdCP cache version this bundle came from. */\n  adcp_version?: string;\n}\n\nexport interface AgentCapabilities {\n  /** AdCP protocols the agent implements. Snake_case per schema. */\n  supported_protocols?: string[];\n  /** Optional specialisms the agent claims. */\n  specialisms?: string[];\n  /**\n   * AdCP major versions the agent declared (from `get_adcp_capabilities.adcp.major_versions`).\n   * When set, storyboards carrying `introduced_in: <major.minor>` whose major\n   * isn't in this list are filtered into `not_applicable` instead of being\n   * run against an agent that predates them. Unset → no version gating.\n   */\n  major_versions?: number[];\n  /**\n   * Exact/release-precision AdCP versions the seller supports, from\n   * `get_adcp_capabilities.adcp.supported_versions`. When present, the\n   * runner treats it as more specific than `major_versions`.\n   */\n  supported_versions?: string[];\n}\n\n/** Reason a storyboard was not run against an agent. */\nexport interface NotApplicableStoryboard {\n  storyboard_id: string;\n  storyboard_title: string;\n  /** Track this storyboard would have contributed to, if known. */\n  track?: string;\n  reason: string;\n  /** Selection reason when the storyboard was excluded before execution. */\n  selection_result?: RunnerSelectionResult;\n}\n\nexport interface ResolveOptions {\n  /** Explicit version override; defaults to the client's pinned ADCP_VERSION. */\n  version?: string;\n  /** Override the compliance cache root (tests use this to point at fixtures). */\n  complianceDir?: string;\n  /**\n   * Explicit schema bundle root to use with the selected compliance cache.\n   * The path must point at the schema-data directory for the cache version,\n   * for example `.../dist/lib/schemas-data/3.0`.\n   */\n  schemaRoot?: string;\n  /**\n   * Hosted badge compatibility alias. When set, a prerelease compliance cache\n   * for this stable line (for example cache `3.1.0-beta.7` with alias `3.1`)\n   * may be selected for a seller that advertises the stable line in\n   * `adcp.supported_versions`.\n   *\n   * This is deliberately scoped to a single resolver call. Normal wire-version\n   * negotiation and explicit beta diagnostic targets stay strict unless the\n   * caller opts in here.\n   */\n  hostedStableLineAlias?: string;\n}\n\nexport interface ResolvedBundle {\n  ref: BundleRef;\n  storyboards: Storyboard[];\n}\n\nexport interface ResolvedStoryboards {\n  bundles: ResolvedBundle[];\n  storyboards: Storyboard[];\n  /**\n   * Storyboards the agent's declared `major_versions` predates. Surfaced so\n   * callers can render a `not_applicable` row — silently dropping them would\n   * mean an agent that hasn't certified against a later spec version passes\n   * vacuously.\n   */\n  not_applicable: NotApplicableStoryboard[];\n}\n\nfunction getRepoRoot(): string {\n  // Walks from src/lib/testing/storyboard/ (or dist/lib/testing/storyboard/) → package root.\n  return resolve(__dirname, '..', '..', '..', '..');\n}\n\n/**\n * Resolve the compliance cache directory.\n *\n * Priority:\n *   1. `options.complianceDir` (explicit override, used by tests)\n *   2. `ADCP_COMPLIANCE_DIR` env var (full path including version dir, for packaged consumers)\n *   3. `{package-root}/compliance/cache/{version}` (default, ships with the npm package)\n */\nexport function getComplianceCacheDir(options: ResolveOptions = {}): string {\n  const configured = getConfiguredComplianceDir(options);\n  if (configured) return configured;\n  const version = options.version || readAdcpVersion();\n  return join(getRepoRoot(), 'compliance', 'cache', version);\n}\n\nfunction readAdcpVersion(): string {\n  // Compile-time ADCP_VERSION from src/lib/version.ts is the single source of truth\n  // at runtime. scripts/sync-schemas.ts still reads the text file — sync-version.ts\n  // keeps them aligned so the cache directory the lib expects matches what sync wrote.\n  return ADCP_VERSION;\n}\n\nfunction complianceMissingMessage(what: string, path: string): string {\n  return (\n    `${what} not found at ${path}. ` +\n    `The compliance cache ships with @adcp/sdk — run \\`npm i @adcp/sdk@latest\\` (or \\`npx @adcp/sdk@latest …\\`) to pick up the current cache. ` +\n    `If developing locally, run \\`npm run sync-schemas\\` to populate the cache.`\n  );\n}\n\n/** Load and parse `index.json` from the compliance cache. */\nexport function loadComplianceIndex(options: ResolveOptions = {}): ComplianceIndex {\n  const dir = getComplianceCacheDir(options);\n  const indexPath = join(dir, 'index.json');\n  if (!existsSync(indexPath)) {\n    throw new Error(complianceMissingMessage('Compliance cache', dir));\n  }\n  const index = JSON.parse(readFileSync(indexPath, 'utf-8')) as ComplianceIndex;\n  return normalizeComplianceIndex(index, options, indexPath);\n}\n\nexport function getExternalSchemaRootForCompliance(options: ResolveOptions, adcpVersion: string): string | undefined {\n  const configuredSchemaRoot = getConfiguredSchemaRoot(options);\n  if (configuredSchemaRoot) return configuredSchemaRoot;\n  // An explicit version still resolves through the package's default compliance\n  // cache. Probe from that directory too so preflight capability discovery uses\n  // the selected release's exact schema tree rather than whatever bundle the SDK\n  // happened to compile as its default.\n  const complianceDir =\n    getConfiguredComplianceDir(options) ?? (options.version !== undefined ? getComplianceCacheDir(options) : undefined);\n  const siblingSchemaRoot = complianceDir ? findExternalSchemaRoot(complianceDir, adcpVersion) : undefined;\n  if (siblingSchemaRoot) return siblingSchemaRoot;\n  if (options.version !== undefined || complianceDir !== undefined) {\n    assertComplianceSchemaBundleAvailable(options, adcpVersion, complianceDir);\n  }\n  return undefined;\n}\n\nfunction assertComplianceSchemaBundleAvailable(\n  options: ResolveOptions,\n  adcpVersion: string,\n  complianceDir: string | undefined\n): void {\n  if (hasSchemaBundle(adcpVersion)) return;\n  const selector = options.version ? `--compliance-version ${options.version}` : `compliance cache ${complianceDir}`;\n  const bundleKey = resolveBundleKey(adcpVersion);\n  throw new Error(\n    `${selector} selected AdCP compliance version \"${adcpVersion}\", but no matching schema bundle was found. ` +\n      `Refusing to validate storyboard responses with the installed default schemas. ` +\n      `Pass --schema-root PATH or set ADCP_SCHEMA_ROOT to a schema-data root for \"${adcpVersion}\" ` +\n      `(for example dist/lib/schemas-data/${bundleKey} or schemas/cache/${adcpVersion}), ` +\n      `or install/sync an @adcp/sdk package that includes that schema bundle.`\n  );\n}\n\nfunction getConfiguredComplianceDir(options: Pick<ResolveOptions, 'complianceDir'>): string | undefined {\n  return options.complianceDir ?? process.env.ADCP_COMPLIANCE_DIR;\n}\n\nfunction getConfiguredSchemaRoot(options: Pick<ResolveOptions, 'schemaRoot'>): string | undefined {\n  return options.schemaRoot ?? process.env.ADCP_SCHEMA_ROOT;\n}\n\nfunction normalizeComplianceIndex(index: ComplianceIndex, options: ResolveOptions, indexPath: string): ComplianceIndex {\n  if (index.adcp_version === 'latest') {\n    const repairedVersion = findReplacementForLatestComplianceVersion(index, options);\n    if (repairedVersion) {\n      return { ...index, adcp_version: repairedVersion };\n    }\n  }\n\n  assertValidComplianceIndexVersion(index.adcp_version, indexPath);\n  return index;\n}\n\nfunction findReplacementForLatestComplianceVersion(\n  index: ComplianceIndex,\n  options: ResolveOptions\n): string | undefined {\n  if (isValidComplianceIndexVersion(index.published_version)) return index.published_version;\n\n  const schemaRoot = getConfiguredSchemaRoot(options);\n  const configuredVersion = schemaRoot ? readSchemaRootAdcpVersion(schemaRoot) : undefined;\n  if (configuredVersion) return configuredVersion;\n\n  if (!options.complianceDir) return undefined;\n  return readSiblingSchemaAdcpVersion(options.complianceDir);\n}\n\nfunction readSchemaRootAdcpVersion(schemaRoot: string): string | undefined {\n  const roots = [schemaRoot];\n  if (basename(schemaRoot) === 'bundled') roots.push(dirname(schemaRoot));\n\n  for (const root of roots) {\n    const indexPath = join(root, 'index.json');\n    if (!existsSync(indexPath)) continue;\n    try {\n      const parsed = JSON.parse(readFileSync(indexPath, 'utf-8')) as { adcp_version?: unknown };\n      if (isValidComplianceIndexVersion(parsed.adcp_version)) return parsed.adcp_version;\n    } catch {\n      // Schema-root discovery is best-effort; the final compliance-index\n      // validation below owns the actionable error when no replacement exists.\n    }\n  }\n  for (const root of roots) {\n    const version = readSchemaIdVersion(root);\n    if (version) return version;\n  }\n  return undefined;\n}\n\nfunction readSchemaIdVersion(root: string): string | undefined {\n  const versions = new Set<string>();\n  const scanRoot = existsSync(join(root, 'bundled')) ? join(root, 'bundled') : root;\n  for (const file of walkJsonFiles(scanRoot)) {\n    try {\n      const parsed = JSON.parse(readFileSync(file, 'utf-8')) as { $id?: unknown };\n      if (typeof parsed.$id !== 'string') continue;\n      const version = parsed.$id.match(/\\/schemas\\/([^/]+)\\//)?.[1];\n      if (isValidComplianceIndexVersion(version)) versions.add(version);\n    } catch {\n      // Best-effort discovery; malformed schemas are handled by validation.\n    }\n  }\n  return versions.size === 1 ? [...versions][0] : undefined;\n}\n\nfunction readSiblingSchemaAdcpVersion(complianceDir: string): string | undefined {\n  for (const schemaRoot of schemaRootCandidatesForComplianceDir(complianceDir)) {\n    const version = readSchemaRootAdcpVersion(schemaRoot);\n    if (version) return version;\n  }\n  return undefined;\n}\n\nfunction isValidComplianceIndexVersion(version: unknown): version is string {\n  if (typeof version !== 'string') return false;\n  try {\n    resolveBundleKey(version);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction assertValidComplianceIndexVersion(version: string, indexPath: string): void {\n  try {\n    resolveBundleKey(version);\n  } catch (err) {\n    const reason = err instanceof Error ? err.message : String(err);\n    throw new Error(\n      `Compliance cache ${indexPath} declares invalid adcp_version ${JSON.stringify(version)}. ` +\n        `adcp_version must be a real AdCP bundle version, not a selector alias such as \"latest\". ` +\n        `If this is a local development bundle, pass ADCP_SCHEMA_ROOT or --schema-root pointing at the matching schema bundle. ` +\n        reason\n    );\n  }\n}\n\nfunction findExternalSchemaRoot(complianceDir: string, adcpVersion: string): string | undefined {\n  const candidates = [complianceDir, ...schemaRootCandidatesForComplianceDir(complianceDir, adcpVersion)];\n  return candidates.find(hasSchemaRootShape);\n}\n\nfunction schemaRootCandidatesForComplianceDir(complianceDir: string, adcpVersion?: string): string[] {\n  const candidates = new Set<string>();\n  const packageRoots = packageRootCandidatesForComplianceDir(complianceDir);\n  const add = (candidate: string) => candidates.add(candidate);\n\n  for (const packageRoot of packageRoots) {\n    addVersionedSchemaRoots(packageRoot, adcpVersion ?? ADCP_VERSION, add);\n  }\n  if (adcpVersion === undefined) {\n    for (const packageRoot of packageRoots) {\n      addSchemaContainerChildren(join(packageRoot, 'dist', 'lib', 'schemas-data'), add);\n      addSchemaContainerChildren(join(packageRoot, 'dist', 'schemas'), add);\n      addSchemaContainerChildren(join(packageRoot, 'schemas', 'cache'), add);\n    }\n  }\n\n  return [...candidates];\n}\n\nfunction addVersionedSchemaRoots(packageRoot: string, adcpVersion: string, add: (candidate: string) => void): void {\n  const key = resolveBundleKey(adcpVersion);\n  // Prefer exact release roots before stable-minor aliases. Patch releases\n  // normally share wire shape, but an explicitly selected compliance kit is\n  // the authority for its own preflight validation and must not be shadowed\n  // by an older `3.1` bundle left in dist.\n  add(join(packageRoot, 'dist', 'lib', 'schemas-data', adcpVersion));\n  add(join(packageRoot, 'dist', 'schemas', adcpVersion));\n  add(join(packageRoot, 'schemas', 'cache', adcpVersion));\n  add(join(packageRoot, 'dist', 'lib', 'schemas-data', key));\n  add(join(packageRoot, 'dist', 'schemas', key));\n  add(join(packageRoot, 'schemas', 'cache', key));\n}\n\nfunction addSchemaContainerChildren(container: string, add: (candidate: string) => void): void {\n  if (!existsSync(container)) return;\n  for (const entry of readdirSync(container).sort().reverse()) {\n    const full = join(container, entry);\n    try {\n      if (statSync(full).isDirectory()) add(full);\n    } catch {\n      // Best-effort sibling discovery; ignore entries that disappear mid-scan.\n    }\n  }\n}\n\nfunction packageRootCandidatesForComplianceDir(complianceDir: string): string[] {\n  const roots = new Set<string>();\n  const resolved = resolve(complianceDir);\n  let current = resolved;\n\n  while (true) {\n    if (basename(current) === 'compliance') {\n      const parent = dirname(current);\n      if (basename(parent) === 'dist') roots.add(dirname(parent));\n      roots.add(parent);\n    }\n    const next = dirname(current);\n    if (next === current) break;\n    current = next;\n  }\n\n  roots.add(dirname(dirname(dirname(resolved))));\n  return [...roots];\n}\n\nfunction hasSchemaRootShape(root: string): boolean {\n  if (!existsSync(root)) return false;\n  const scanRoot = existsSync(join(root, 'bundled')) ? join(root, 'bundled') : root;\n  return walkJsonFiles(scanRoot).some(file => {\n    try {\n      const parsed = JSON.parse(readFileSync(file, 'utf-8')) as { $id?: unknown; $schema?: unknown };\n      return typeof parsed.$id === 'string' || typeof parsed.$schema === 'string';\n    } catch {\n      return false;\n    }\n  });\n}\n\nfunction walkJsonFiles(dir: string): string[] {\n  if (!existsSync(dir)) return [];\n  const out: string[] = [];\n  for (const entry of readdirSync(dir, { withFileTypes: true })) {\n    const full = join(dir, entry.name);\n    if (entry.isDirectory()) out.push(...walkJsonFiles(full));\n    else if (entry.isFile() && entry.name.endsWith('.json')) out.push(full);\n  }\n  return out;\n}\n\n/**\n * Load every storyboard YAML under a directory tree (non-recursive for files at the top\n * level of a bundle, recursive for nested `scenarios/`). YAMLs that don't have a top-level\n * `id:` (schema / fixture files) are skipped.\n */\nfunction loadStoryboardsFromDir(dir: string): Storyboard[] {\n  if (!existsSync(dir)) return [];\n  const storyboards: Storyboard[] = [];\n  const visit = (current: string) => {\n    // Sort entries so ordering is deterministic across filesystems.\n    const entries = readdirSync(current).sort();\n    // Prefer index.yaml first so bundle-as-id lookups resolve to the main storyboard.\n    entries.sort((a, b) => {\n      if (a === 'index.yaml') return -1;\n      if (b === 'index.yaml') return 1;\n      return 0;\n    });\n    for (const entry of entries) {\n      const full = join(current, entry);\n      const stat = statSync(full);\n      if (stat.isDirectory()) {\n        visit(full);\n      } else if (entry.endsWith('.yaml') || entry.endsWith('.yml')) {\n        try {\n          storyboards.push(loadStoryboardFile(full));\n        } catch (err) {\n          // Peek at the file — if it has an `id:` line it was meant to be a\n          // storyboard and the error is a real problem; otherwise it's a schema\n          // or fixture file (e.g., storyboard-schema.yaml) and silence is fine.\n          try {\n            const text = readFileSync(full, 'utf-8');\n            if (/^id:\\s*\\S/m.test(text)) {\n              console.warn(`[compliance] Failed to parse storyboard ${full}: ${(err as Error).message}`);\n            }\n          } catch {\n            /* unreadable file — treat as non-storyboard */\n          }\n        }\n      }\n    }\n  };\n  visit(dir);\n  return storyboards;\n}\n\n/** Load storyboards for a single bundle (universal YAML file, domain dir, or specialism dir). */\nexport function loadBundleStoryboards(ref: BundleRef): Storyboard[] {\n  const raw = ref.kind === 'universal' ? safeLoadUniversal(ref.path) : loadStoryboardsFromDir(ref.path);\n  const complianceDir = dirname(dirname(ref.path));\n  return raw.map(sb => annotateStoryboardVersion(postProcessStoryboard(sb), ref.adcp_version, complianceDir));\n}\n\nfunction annotateStoryboardVersion(\n  storyboard: Storyboard,\n  adcpVersion: string | undefined,\n  complianceDir: string\n): Storyboard {\n  return markStoryboardComplianceRoot(\n    {\n      ...storyboard,\n      ...(adcpVersion !== undefined && { adcp_version: adcpVersion }),\n      compliance_dir: complianceDir,\n    },\n    complianceDir\n  );\n}\n\nfunction safeLoadUniversal(path: string): Storyboard[] {\n  try {\n    return [loadStoryboardFile(path)];\n  } catch {\n    return [];\n  }\n}\n\n/**\n * Post-process storyboards loaded from the cache. The signed-requests\n * specialism ships phases whose steps are generated at runtime from the\n * request-signing test vectors; synthesize them here so downstream callers\n * (the runner, CLI tooling, reporting) see a fully-populated storyboard.\n */\nfunction postProcessStoryboard(storyboard: Storyboard): Storyboard {\n  if (storyboard.id === 'signed_requests') {\n    try {\n      return synthesizeRequestSigningSteps(storyboard);\n    } catch (err) {\n      // Synthesis failure = infrastructural problem (cache missing vectors,\n      // schema drift, etc.). Emit a synthetic failing phase so the runner's\n      // existing reporting surfaces the cause — silent empty-phase fallback\n      // would render as a green pass with 0 steps, which is the worst\n      // possible outcome for CI pipelines.\n      return withSynthesisErrorPhase(storyboard, err);\n    }\n  }\n  return storyboard;\n}\n\nfunction withSynthesisErrorPhase(storyboard: Storyboard, err: unknown): Storyboard {\n  const message = err instanceof Error ? err.message : String(err);\n  const errorPhase = {\n    id: 'synthesis_error',\n    title: 'Request-signing vector synthesis failed',\n    narrative:\n      'The signed-requests specialism requires its phases to be synthesized at load time ' +\n      'from the compliance cache. Synthesis failed — the runner cannot grade against the ' +\n      'conformance vectors. Run `npm run sync-schemas` to refresh the cache.',\n    steps: [\n      {\n        id: 'synthesis_error',\n        title: 'Synthesize vector phases',\n        task: 'synthesis_error',\n        narrative: message,\n        expect_error: false,\n      },\n    ],\n  };\n  return { ...storyboard, phases: [errorPhase, ...storyboard.phases] };\n}\n\n/** Enumerate every bundle present in the cache (universal + protocols + specialisms). */\nexport function listBundles(options: ResolveOptions = {}): BundleRef[] {\n  const dir = getComplianceCacheDir(options);\n  const index = loadComplianceIndex(options);\n  const bundles: BundleRef[] = [];\n\n  for (const name of index.universal) {\n    bundles.push({\n      kind: 'universal',\n      id: name,\n      path: join(dir, 'universal', `${name}.yaml`),\n      adcp_version: index.adcp_version,\n    });\n  }\n  for (const protocol of index.protocols) {\n    if (!protocol.has_baseline) continue;\n    bundles.push({\n      kind: 'protocol',\n      id: protocol.id,\n      path: join(dir, 'protocols', protocol.id),\n      adcp_version: index.adcp_version,\n    });\n  }\n  for (const specialism of index.specialisms) {\n    bundles.push({\n      kind: 'specialism',\n      id: specialism.id,\n      path: join(dir, 'specialisms', specialism.id),\n      adcp_version: index.adcp_version,\n    });\n  }\n  return bundles;\n}\n\n/** List every storyboard the cache can produce, across all bundles. */\nexport function listAllComplianceStoryboards(options: ResolveOptions = {}): Storyboard[] {\n  const seen = new Set<string>();\n  const storyboards: Storyboard[] = [];\n  for (const ref of listBundles(options)) {\n    for (const sb of loadBundleStoryboards(ref)) {\n      if (seen.has(sb.id)) continue;\n      seen.add(sb.id);\n      storyboards.push(sb);\n    }\n  }\n  return storyboards;\n}\n\n/**\n * Find a storyboard by its internal `id` (the YAML's `id:` field).\n * Scans every bundle in the cache. Returns undefined if no match.\n */\nexport function getComplianceStoryboardById(id: string, options: ResolveOptions = {}): Storyboard | undefined {\n  for (const sb of listAllComplianceStoryboards(options)) {\n    if (sb.id === id) return sb;\n  }\n  return undefined;\n}\n\n/** Find a bundle by its directory/file id (`media-buy`, `sales-guaranteed`, `capability-discovery`). */\nexport function findBundleById(id: string, options: ResolveOptions = {}): BundleRef | undefined {\n  return listBundles(options).find(b => b.id === id);\n}\n\n/**\n * Resolved view of a specialism for the `adcp specialism show` CLI: the\n * specialism's own storyboard plus every protocol scenario it pulls in via\n * `requires_scenarios`. Useful as a pre-flight \"what will CI actually run\n * against my server?\" answer.\n */\nexport interface SpecialismDetail {\n  slug: string;\n  protocol: string;\n  status: string;\n  /** Title from index.json (kept separate from storyboard.title for fallback). */\n  index_title: string | null;\n  /** The specialism's own index.yaml parsed as a Storyboard. */\n  storyboard: Storyboard;\n  /**\n   * Required scenarios pulled in from protocol bundles via the index.yaml's\n   * `requires_scenarios` field. Each entry is a fully-resolved Storyboard;\n   * `unresolved` lists references that did not match a storyboard in the cache.\n   */\n  required_scenarios: Storyboard[];\n  unresolved_scenarios: string[];\n  /** Required tools declared by the specialism (from the index entry). */\n  required_tools: string[];\n}\n\nexport function loadSpecialismDetail(slug: string, options: ResolveOptions = {}): SpecialismDetail {\n  const index = loadComplianceIndex(options);\n  const entry = index.specialisms.find(s => s.id === slug);\n  if (!entry) {\n    const known = index.specialisms.map(s => s.id).join(', ');\n    throw new Error(`Unknown specialism \"${slug}\". Known specialisms: ${known}`);\n  }\n\n  const bundleStoryboards = loadBundleStoryboards({\n    kind: 'specialism',\n    id: slug,\n    path: join(getComplianceCacheDir(options), 'specialisms', slug),\n    adcp_version: index.adcp_version,\n  });\n  const storyboard = bundleStoryboards.find(sb => sb.category === entry.id.replace(/-/g, '_')) ?? bundleStoryboards[0];\n  if (!storyboard) {\n    throw new Error(\n      `Specialism \"${slug}\" loaded no storyboards from ${join(getComplianceCacheDir(options), 'specialisms', slug)}`\n    );\n  }\n\n  const required: Storyboard[] = [];\n  const unresolved: string[] = [];\n  for (const ref of storyboard.requires_scenarios ?? []) {\n    // Scenario YAMLs declare `id: <category>/<scenario_id>` — the slash\n    // form is the storyboard's own id and the only safe lookup. Bare-id\n    // fallbacks would silently match across categories once future caches\n    // ship scenarios with colliding tail segments — better to surface drift\n    // through `unresolved_scenarios` than mask it with a wrong-category hit.\n    const sb = getComplianceStoryboardById(ref, options);\n    if (sb) required.push(sb);\n    else unresolved.push(ref);\n  }\n\n  // index.json carries the canonical required_tools list — fall back to the\n  // storyboard's own field if the index entry is missing it.\n  const requiredTools =\n    (entry as ComplianceIndexSpecialism & { required_tools?: string[] }).required_tools ??\n    storyboard.required_tools ??\n    [];\n\n  return {\n    slug,\n    protocol: entry.protocol,\n    status: entry.status,\n    index_title: entry.title,\n    storyboard,\n    required_scenarios: required,\n    unresolved_scenarios: unresolved,\n    required_tools: requiredTools,\n  };\n}\n\nexport function listSpecialisms(options: ResolveOptions = {}): ComplianceIndexSpecialism[] {\n  return loadComplianceIndex(options).specialisms;\n}\n\n/**\n * Resolve either a bundle id or a storyboard id to a storyboard set.\n * Bundle ids expand to every storyboard in the bundle (index + scenarios).\n * Storyboard ids resolve to that single storyboard.\n *\n * Used for targeted `storyboard run <agent> <id>` invocations.\n */\nexport function resolveBundleOrStoryboard(id: string, options: ResolveOptions = {}): Storyboard[] {\n  const bundle = findBundleById(id, options);\n  if (bundle) return loadBundleStoryboards(bundle);\n  const sb = getComplianceStoryboardById(id, options);\n  return sb ? [sb] : [];\n}\n\n/**\n * Given the agent's `get_adcp_capabilities` response, resolve the set of\n * storyboards the compliance runner should execute:\n *\n *   universal   — every universal bundle (mandatory for every agent)\n *   protocols   — baseline for each declared `supported_protocols` entry\n *   specialisms — every declared specialism\n *\n * Throws `CapabilityResolutionError` (fail-closed) when the declared\n * capabilities cannot be mapped onto the cache:\n *\n *   - `unknown_specialism` — declared specialism has no bundle (usually stale\n *     cache — run `npm run sync-schemas`).\n *   - `specialism_parent_protocol_missing` — declared specialism rolls up to\n *     a protocol the agent didn't include in `supported_protocols`.\n *\n * Unknown `supported_protocols` entries are logged as warnings and skipped\n * rather than thrown (fail-open), so a single bad entry doesn't block the run.\n */\nexport function resolveStoryboardsForCapabilities(\n  caps: AgentCapabilities,\n  options: ResolveOptions = {}\n): ResolvedStoryboards {\n  const index = loadComplianceIndex(options);\n  assertSupportedComplianceVersion(index.adcp_version, caps.supported_versions, options);\n  const cacheDir = getComplianceCacheDir(options);\n  const bundles: ResolvedBundle[] = [];\n  const storyboards: Storyboard[] = [];\n  const notApplicable: NotApplicableStoryboard[] = [];\n  const seenStoryboards = new Set<string>();\n\n  const push = (ref: BundleRef) => {\n    const sbs = loadBundleStoryboards(ref);\n    bundles.push({ ref, storyboards: sbs });\n    for (const sb of sbs) {\n      if (seenStoryboards.has(sb.id)) continue;\n      seenStoryboards.add(sb.id);\n      const gate = checkVersionGate(sb, caps.major_versions);\n      if (gate) {\n        notApplicable.push({\n          storyboard_id: sb.id,\n          storyboard_title: sb.title,\n          track: sb.track,\n          reason: gate,\n          selection_result: { reason: 'version_excluded', detail: gate },\n        });\n        continue;\n      }\n      storyboards.push(sb);\n    }\n  };\n\n  for (const name of index.universal) {\n    push({\n      kind: 'universal',\n      id: name,\n      path: join(cacheDir, 'universal', `${name}.yaml`),\n      adcp_version: index.adcp_version,\n    });\n  }\n\n  const declaredProtocols = caps.supported_protocols ?? [];\n  const declaredProtocolIds = new Set<string>();\n  for (const protocol of declaredProtocols) {\n    // Legacy: older agents listed `compliance_testing` under supported_protocols.\n    // The current schema declares it via the top-level `compliance_testing`\n    // capability block instead, and it has no compliance baseline. Skip silently.\n    if (protocol === 'compliance_testing' || UNBASELINED_SUPPORTED_PROTOCOLS.has(protocol)) continue;\n\n    const protocolId = PROTOCOL_TO_PATH[protocol];\n    if (!protocolId) {\n      // Unknown protocol — likely a newer spec version or a typo. Mirror the\n      // fail-closed posture on specialisms: surface it loudly, but as a warning\n      // on stderr so a single bad entry doesn't block the full run.\n      console.warn(\n        `[resolveStoryboardsForCapabilities] Unknown supported_protocols entry \"${protocol}\". ` +\n          `This is ignored; compliance cache may be stale or the agent is on a newer AdCP version.`\n      );\n      continue;\n    }\n    const entry = index.protocols.find(d => d.id === protocolId);\n    if (!entry || !entry.has_baseline) continue;\n    declaredProtocolIds.add(protocolId);\n    push({\n      kind: 'protocol',\n      id: protocolId,\n      path: join(cacheDir, 'protocols', protocolId),\n      adcp_version: index.adcp_version,\n    });\n  }\n\n  const declaredSpecialisms = caps.specialisms ?? [];\n  for (const specialism of declaredSpecialisms) {\n    const entry = index.specialisms.find(s => s.id === specialism);\n    if (!entry) {\n      // Deprecated alias path: some 3.0-era specialism enum values now resolve\n      // to a `universal/` bundle (e.g. `signed-requests` → `universal/signed-requests.yaml`).\n      // The universal storyboard is pushed unconditionally above; the deprecated\n      // claim is graded there and the deprecation notice fires from runner.ts.\n      // Don't throw — that would block every other storyboard.\n      const universalAlias = DEPRECATED_SPECIALISM_UNIVERSAL_ALIASES[specialism];\n      if (universalAlias && index.universal.includes(universalAlias)) {\n        continue;\n      }\n      throw new CapabilityResolutionError({\n        code: 'unknown_specialism',\n        specialism,\n        message:\n          `Agent declared specialism \"${specialism}\" but no bundle exists at ` +\n          `${join(cacheDir, 'specialisms', specialism)}. ` +\n          `Known specialisms: ${index.specialisms.map(s => s.id).join(', ')}. ` +\n          `Compliance cache version: ${index.adcp_version}. ` +\n          `This usually means the cache is stale — run \\`npm run sync-schemas\\`.`,\n      });\n    }\n    // Each specialism rolls up to one parent protocol; the spec requires the parent\n    // to also be declared in supported_protocols. AAO enforces this server-side,\n    // but catching it client-side stops us from running orphan scenarios.\n    if (entry.protocol && !declaredProtocolIds.has(entry.protocol)) {\n      throw new CapabilityResolutionError({\n        code: 'specialism_parent_protocol_missing',\n        specialism,\n        parentProtocol: entry.protocol,\n        message:\n          `Agent declared specialism \"${specialism}\" (parent protocol: ${entry.protocol}) ` +\n          `but did not include \"${entry.protocol}\" in supported_protocols. ` +\n          `Every specialism must roll up to a declared protocol per the AdCP spec.`,\n      });\n    }\n    push({\n      kind: 'specialism',\n      id: specialism,\n      path: join(cacheDir, 'specialisms', specialism),\n      adcp_version: index.adcp_version,\n    });\n  }\n\n  return { bundles, storyboards, not_applicable: notApplicable };\n}\n\nexport function isComplianceVersionSupported(\n  cacheVersion: string,\n  supportedVersions: readonly string[],\n  options: Pick<ResolveOptions, 'hostedStableLineAlias'> = {}\n): boolean {\n  return (\n    isAdcpVersionSupported(cacheVersion, supportedVersions) ||\n    isHostedStableLineAliasSupported(cacheVersion, supportedVersions, options.hostedStableLineAlias)\n  );\n}\n\nfunction assertSupportedComplianceVersion(\n  cacheVersion: string,\n  supportedVersions: string[] | undefined,\n  options: Pick<ResolveOptions, 'hostedStableLineAlias'> = {}\n): void {\n  if (!supportedVersions || supportedVersions.length === 0) return;\n  if (isComplianceVersionSupported(cacheVersion, supportedVersions, options)) return;\n  throw new CapabilityResolutionError({\n    code: 'unsupported_adcp_version',\n    message:\n      `Compliance cache version ${cacheVersion} is not supported by this seller. ` +\n      `Seller advertises adcp.supported_versions [${supportedVersions.join(', ')}]. ` +\n      `Install or select a compatible compliance cache instead of relying on major_versions alone.`,\n  });\n}\n\nfunction isHostedStableLineAliasSupported(\n  cacheVersion: string,\n  supportedVersions: readonly string[],\n  hostedStableLineAlias: string | undefined\n): boolean {\n  if (!hostedStableLineAlias || supportedVersions.length === 0) return false;\n  const cacheLine = stableLineOf(cacheVersion);\n  const aliasLine = stableLineOf(hostedStableLineAlias);\n  if (!cacheLine || !aliasLine || cacheLine !== aliasLine) return false;\n  if (!isPrereleaseVersion(cacheVersion)) return false;\n  return isAdcpVersionSupported(hostedStableLineAlias, supportedVersions);\n}\n\nfunction stableLineOf(version: string): string | undefined {\n  const match = /^(?:v)?(\\d+)\\.(\\d+)(?:\\.|$|-)/.exec(version);\n  return match?.[1] && match?.[2] ? `${match[1]}.${match[2]}` : undefined;\n}\n\nfunction isPrereleaseVersion(version: string): boolean {\n  return /^\\d+\\.\\d+(?:\\.\\d+)?-/.test(version);\n}\n\n/**\n * Compare a storyboard's `introduced_in` (e.g., \"3.1\") against an agent's\n * declared `major_versions` (e.g., `[3]`). Returns a reason string when the\n * storyboard should be gated out; undefined when it applies.\n *\n * Grammar: `introduced_in` is `<major>` or `<major>.<minor>` — only the major\n * is consulted for filtering. Minor/patch components are kept on the storyboard\n * for reporting but don't drive the gate because the spec's `major_versions`\n * array only carries majors.\n *\n * When either side is absent the gate is a no-op: agents that don't declare\n * `major_versions` (v2 synthetic profiles, discovery failures) run every\n * storyboard, and storyboards without `introduced_in` always apply.\n */\nfunction checkVersionGate(sb: Storyboard, agentMajors: number[] | undefined): string | undefined {\n  if (!sb.introduced_in || !agentMajors || agentMajors.length === 0) return undefined;\n  const parsed = parseIntroducedIn(sb.introduced_in);\n  if (parsed === undefined) return undefined; // unparseable → don't block\n  if (agentMajors.includes(parsed)) return undefined;\n  const declared = agentMajors\n    .slice()\n    .sort((a, b) => a - b)\n    .join(', ');\n  return `Introduced in AdCP ${sb.introduced_in}; agent declares major_versions [${declared}].`;\n}\n\nfunction parseIntroducedIn(value: string): number | undefined {\n  const match = /^\\s*(\\d+)(?:\\.\\d+)*\\s*$/.exec(value);\n  if (!match?.[1]) return undefined;\n  const major = Number.parseInt(match[1], 10);\n  return Number.isFinite(major) ? major : undefined;\n}\n"],"mappings":"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","names":[]}

package/dist/lib/testing/storyboard/compliance.mjs

@@ -11,6 +11,7 @@ import { ADCPError } from "../../errors/index.mjs";
 import { isAdcpVersionSupported } from "../../utils/adcp-version-config.mjs";
 import { hasSchemaBundle, resolveBundleKey } from "../../validation/schema-loader.mjs";
 import { synthesizeRequestSigningSteps } from "./request-signing/synthesize.mjs";
+import { markStoryboardComplianceRoot } from "./provenance.mjs";
 class CapabilityResolutionError extends ADCPError {
   code;
   specialism;
@@ -279,10 +280,18 @@ function loadStoryboardsFromDir(dir) {
 }
 function loadBundleStoryboards(ref) {
   const raw = ref.kind === "universal" ? safeLoadUniversal(ref.path) : loadStoryboardsFromDir(ref.path);
-  return raw.map((sb) => annotateStoryboardVersion(postProcessStoryboard(sb), ref.adcp_version));
-}
-function annotateStoryboardVersion(storyboard, adcpVersion) {
-  return adcpVersion === void 0 ? storyboard : { ...storyboard, adcp_version: adcpVersion };
+  const complianceDir = dirname(dirname(ref.path));
+  return raw.map((sb) => annotateStoryboardVersion(postProcessStoryboard(sb), ref.adcp_version, complianceDir));
+}
+function annotateStoryboardVersion(storyboard, adcpVersion, complianceDir) {
+  return markStoryboardComplianceRoot(
+    {
+      ...storyboard,
+      ...adcpVersion !== void 0 && { adcp_version: adcpVersion },
+      compliance_dir: complianceDir
+    },
+    complianceDir
+  );
 }
 function safeLoadUniversal(path) {
   try {