npm - @adcp/sdk - Versions diffs - 13.0.0 → 13.0.2 - Mend

@adcp/sdk 13.0.0 → 13.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1419) hide show

package/dist/lib/testing/storyboard/compliance.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../../../src/lib/testing/storyboard/compliance.ts"],"sourcesContent":["import { fileURLToPath as __adcpFileURLToPath } from 'node:url';\nimport { dirname as __adcpDirname } from 'node:path';\nimport { createRequire as __adcpCreateRequire } from 'node:module';\nconst __dirname = __adcpDirname(__adcpFileURLToPath(import.meta.url));\nconst require = __adcpCreateRequire(import.meta.url);\n/*\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":["require"]}
1	+ {"version":3,"sources":["../../../../src/lib/testing/storyboard/compliance.ts"],"sourcesContent":["import { fileURLToPath as __adcpFileURLToPath } from 'node:url';\nimport { dirname as __adcpDirname } from 'node:path';\nimport { createRequire as __adcpCreateRequire } from 'node:module';\nconst __dirname = __adcpDirname(__adcpFileURLToPath(import.meta.url));\nconst require = __adcpCreateRequire(import.meta.url);\n/*\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":["require"]}

package/dist/lib/testing/storyboard/loader.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAK1C;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,qBAAsB,CAAC;AAKxD,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,~~CAuB~~/D;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAE/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAmBpE"}
1	+ {"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAK1C;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,qBAAsB,CAAC;AAKxD,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CA4B/D;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAE/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAmBpE"}

package/dist/lib/testing/storyboard/loader.js CHANGED Viewed

@@ -37,6 +37,11 @@ function parseStoryboard(yamlContent) {
   if (!parsed?.id || !parsed?.phases) {
     throw new Error("Invalid storyboard YAML: missing required fields (id, phases)");
   }
+  if (Object.prototype.hasOwnProperty.call(parsed, "compliance_dir")) {
+    throw new Error(
+      "Invalid storyboard YAML: compliance_dir is loader-owned runtime provenance; select an external cache with runner options instead."
+    );
+  }
   for (const phase of parsed.phases) {
     if (!phase.steps) phase.steps = [];
     for (const step of phase.steps) {

package/dist/lib/testing/storyboard/loader.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../../../src/lib/testing/storyboard/loader.ts"],"sourcesContent":["/*\n Storyboard YAML parser.\n \n Storyboards are pulled from the compliance cache populated by\n * `npm run sync-schemas`. See `./compliance.ts` for capability-driven\n * resolution and bundle loading.\n /\n\nimport { readFileSync } from 'fs';\nimport { parse } from 'yaml';\nimport type { Storyboard } from './types';\nimport { MUTATING_TASKS } from '../../utils/idempotency';\nimport { validateFixtureResolutionDeclarations } from './fixture-resolution';\nimport { valid as validSemver } from 'semver';\n\n/\n Supported `branch_set.semantics` values. Extend when AdCP adds `all_of`,\n * `at_least_n`, etc. Exported so the runner can enforce the same whitelist\n * on programmatically-constructed storyboards that bypass the YAML parser.\n /\nexport const BRANCH_SET_SEMANTICS = ['any_of'] as const;\n\nconst IDENTIFIER_PATH_SEGMENT = String.raw`[A-Za-z_][A-Za-z0-9_-](?:\\[\\\\])`;\nconst IDENTIFIER_PATH_PATTERN = new RegExp(`^${IDENTIFIER_PATH_SEGMENT}(?:\\\\.${IDENTIFIER_PATH_SEGMENT})$`);\n\n/* Parse a YAML string into a Storyboard. Throws if required fields are missing. /\nexport function parseStoryboard(yamlContent: string): Storyboard {\n const parsed = parse(yamlContent) as Storyboard;\n if (!parsed?.id \|\| !parsed?.phases) {\n throw new Error('Invalid storyboard YAML: missing required fields (id, phases)');\n }\n for (const phase of parsed.phases) {\n // Specialism YAMLs may declare a phase with no `steps:` — the steps are\n // synthesized at runtime from fixtures (see request-signing/synthesize.ts).\n // Treat missing steps as an empty list so the parser stays phase-agnostic.\n if (!phase.steps) phase.steps = [];\n // YAML uses `name:` for context outputs but our runtime expects `key:`.\n for (const step of phase.steps) {\n if (!step.context_outputs) continue;\n for (const output of step.context_outputs) {\n const raw = output as unknown as Record<string, unknown>;\n if (raw.name && !raw.key) {\n output.key = raw.name as string;\n }\n }\n }\n }\n validateStoryboardShape(parsed);\n return parsed;\n}\n\n/* Load and parse a single storyboard file. Useful for ad-hoc testing of in-development YAMLs. /\nexport function loadStoryboardFile(filePath: string): Storyboard {\n return parseStoryboard(readFileSync(filePath, 'utf-8'));\n}\n\n/\n Enforce authoring-time invariants on a Storyboard. Called by\n * `parseStoryboard`, and should also be called by any runner entry point\n * that accepts a programmatically-built `Storyboard` object so the same\n * loud-fail-on-drift guarantee holds regardless of how the storyboard was\n * constructed. Mutates only legacy shorthand fields (resolves\n * `contributes: true` to `contributes_to`) and is idempotent on\n * already-validated inputs.\n /\nexport function validateStoryboardShape(storyboard: Storyboard): void {\n validateRequires(storyboard);\n validateFixtureResolutionDeclarations(storyboard);\n validateRequiredAnyOfTools(storyboard);\n validatePhaseDependsOn(storyboard);\n for (const phase of storyboard.phases) {\n validateBranchSet(storyboard.id, phase);\n if (!phase.steps) continue;\n for (const step of phase.steps) {\n resolveContributesShorthand(storyboard.id, phase, step);\n validateFixtureForMutatingStep(storyboard.id, phase, step);\n validateOmitFlagCoherence(storyboard.id, phase, step);\n validateContextOutputs(storyboard.id, phase, step);\n validateUpstreamAttestationMode(storyboard.id, phase, step);\n validateUpstreamIdentifierPaths(storyboard.id, phase, step);\n validateAdvisoryDeclarations(storyboard.id, phase, step);\n validatePeerSubstitutesFor(storyboard.id, phase, step);\n }\n }\n}\n\nfunction validateAdvisoryDeclarations(\n storyboardId: string,\n phase: { id?: string },\n step: { id?: string; validations?: any[] }\n): void {\n for (let index = 0; index < (step.validations ?? []).length; index++) {\n const validation = step.validations![index];\n if (\n validation?.severity !== undefined &&\n validation.severity !== 'required' &&\n validation.severity !== 'advisory'\n ) {\n const prefix = `[${storyboardId}] ${phase.id ?? '?'}.${step.id ?? '?'}.validations[${index}]`;\n throw new Error(`${prefix}.severity: must be either \"required\" or \"advisory\"`);\n }\n if (validation?.severity !== 'advisory') continue;\n const prefix = `[${storyboardId}] ${phase.id ?? '?'}.${step.id ?? '?'}.validations[${index}]`;\n const hasExpiry = validation.expires_after_version !== undefined;\n const hasPermanent = validation.permanent_advisory !== undefined;\n if (hasExpiry === hasPermanent) {\n throw new Error(\n `${prefix}: severity \"advisory\" must declare exactly one of expires_after_version or permanent_advisory`\n );\n }\n if (\n hasExpiry &&\n (typeof validation.expires_after_version !== 'string' \|\| !validSemver(validation.expires_after_version))\n ) {\n throw new Error(`${prefix}.expires_after_version: must be a valid semver string`);\n }\n if (\n hasPermanent &&\n (typeof validation.permanent_advisory !== 'object' \|\|\n validation.permanent_advisory === null \|\|\n typeof validation.permanent_advisory.reason !== 'string' \|\|\n validation.permanent_advisory.reason.trim().length === 0)\n ) {\n throw new Error(`${prefix}.permanent_advisory.reason: must be a non-empty string`);\n }\n }\n}\n\nfunction validateUpstreamAttestationMode(\n storyboardId: string,\n phase: { id?: string },\n step: { id?: string; validations?: any[] }\n): void {\n const validations = step.validations ?? [];\n for (let validationIndex = 0; validationIndex < validations.length; validationIndex++) {\n const validation = validations[validationIndex];\n if (validation?.check !== 'upstream_traffic') continue;\n const mode = validation.preferred_attestation_mode;\n if (mode !== undefined && mode !== 'raw' && mode !== 'digest') {\n throw new Error(\n `[${storyboardId}] ${phase.id ?? '?'}.${step.id ?? '?'}.validations[${validationIndex}].preferred_attestation_mode: must be \"raw\" or \"digest\"`\n );\n }\n }\n}\n\nfunction validateUpstreamIdentifierPaths(\n storyboardId: string,\n phase: { id?: string },\n step: { id?: string; validations?: any[] }\n): void {\n const validations = step.validations ?? [];\n for (let validationIndex = 0; validationIndex < validations.length; validationIndex++) {\n const validation = validations[validationIndex];\n if (validation?.check !== 'upstream_traffic' \|\| validation.identifier_paths === undefined) continue;\n if (!Array.isArray(validation.identifier_paths)) {\n throw new Error(\n `[${storyboardId}] ${phase.id ?? '?'}.${\n step.id ?? '?'\n }.validations[${validationIndex}].identifier_paths: must be an array of request-payload paths`\n );\n }\n for (let pathIndex = 0; pathIndex < validation.identifier_paths.length; pathIndex++) {\n const path = validation.identifier_paths[pathIndex];\n if (typeof path !== 'string' \|\| path.length === 0) {\n throw new Error(\n `[${storyboardId}] ${phase.id ?? '?'}.${step.id ?? '?'}.validations[${validationIndex}].identifier_paths[${pathIndex}]: must be a non-empty string`\n );\n }\n const pathErrorPrefix = `[${storyboardId}] ${phase.id ?? '?'}.${step.id ?? '?'}.validations[${validationIndex}].identifier_paths[${pathIndex}]`;\n let firstSegment: string;\n try {\n const validated = validateIdentifierPathSyntax(path);\n firstSegment = validated.firstSegment;\n } catch {\n throw new Error(\n `${pathErrorPrefix}: \"${path}\" is unsupported; identifier_paths resolve only against the request payload or sample_request using dotted paths with [] array selectors`\n );\n }\n const root = firstSegment.toLowerCase();\n if (root === 'request' \|\| root === 'response' \|\| root === 'context') {\n throw new Error(\n `${pathErrorPrefix}: \"${path}\" is unsupported; identifier_paths resolve only against the request payload or sample_request`\n );\n }\n }\n }\n}\n\nfunction validateIdentifierPathSyntax(path: string): { normalized: string; firstSegment: string } {\n const trimmed = path.trim();\n const normalized = trimmed.startsWith('$.') ? trimmed.slice(2) : trimmed;\n if (!IDENTIFIER_PATH_PATTERN.test(normalized)) {\n throw new Error('unsupported identifier path syntax');\n }\n return { normalized, firstSegment: normalized.split(/[.[\\]]/, 1)[0] ?? '' };\n}\n\nfunction validateRequiredAnyOfTools(storyboard: Storyboard): void {\n if (storyboard.required_any_of_tools === undefined) return;\n if (!Array.isArray(storyboard.required_any_of_tools)) {\n throw new Error(`[${storyboard.id}] required_any_of_tools: must be an array of tool-family objects`);\n }\n if (storyboard.required_any_of_tools.length === 0) {\n throw new Error(`[${storyboard.id}] required_any_of_tools: [] is not allowed — omit the field to use no gate`);\n }\n for (let i = 0; i < storyboard.required_any_of_tools.length; i++) {\n const family = storyboard.required_any_of_tools[i] as unknown;\n if (family === null \|\| typeof family !== 'object' \|\| Array.isArray(family)) {\n throw new Error(`[${storyboard.id}] required_any_of_tools[${i}]: must be an object`);\n }\n const { tools, rationale } = family as { tools?: unknown; rationale?: unknown };\n if (!Array.isArray(tools) \|\| tools.length < 2) {\n throw new Error(`[${storyboard.id}] required_any_of_tools[${i}].tools: must list at least two tool names`);\n }\n for (const tool of tools) {\n if (typeof tool !== 'string' \|\| tool.length === 0) {\n throw new Error(`[${storyboard.id}] required_any_of_tools[${i}].tools: entries must be non-empty strings`);\n }\n }\n if (rationale !== undefined && typeof rationale !== 'string') {\n throw new Error(`[${storyboard.id}] required_any_of_tools[${i}].rationale: must be a string`);\n }\n }\n}\n\n/*\n Authoring-time validation for `phase.depends_on` (#1161). Each entry\n * must reference a phase declared earlier in the storyboard. Forward\n * references and self-references fail loud at parse time so authoring\n * mistakes (typos, reorderings) don't degrade silently into \"phase\n * always runs\" / \"phase always cascades.\"\n \n Rules:\n * - Empty list (`depends_on: []`) is legal — it declares an\n * independent phase. No further validation needed.\n * - Each non-empty entry must be a non-empty string.\n * - Each entry must reference a phase that appears EARLIER in the\n * `storyboard.phases[]` array (forward references are rejected).\n * - A phase cannot depend on itself.\n /\nfunction validatePhaseDependsOn(storyboard: Storyboard): void {\n const phaseIdsSeen = new Set<string>();\n for (const phase of storyboard.phases) {\n if (phase.depends_on !== undefined) {\n if (!Array.isArray(phase.depends_on)) {\n throw new Error(`[${storyboard.id}] phase '${phase.id}': depends_on must be an array of phase ids`);\n }\n for (const dep of phase.depends_on) {\n if (typeof dep !== 'string' \|\| dep.length === 0) {\n throw new Error(`[${storyboard.id}] phase '${phase.id}': depends_on entries must be non-empty strings`);\n }\n if (dep === phase.id) {\n throw new Error(`[${storyboard.id}] phase '${phase.id}': depends_on cannot reference itself`);\n }\n if (!phaseIdsSeen.has(dep)) {\n throw new Error(\n `[${storyboard.id}] phase '${phase.id}': depends_on '${dep}' is not a phase declared earlier in this storyboard (forward and unknown references are rejected)`\n );\n }\n }\n }\n phaseIdsSeen.add(phase.id);\n }\n}\n\n/\n Authoring-time validation for `Storyboard.requires` (#1626). The field is\n * an array of non-empty requirement names:\n \n - `requires: []` is rejected — an empty array reads as \"no\n * requirements,\" which is the same as omitting the field; failing\n * load forces the author to omit it explicitly.\n * - Each entry must be a non-empty string.\n \n Unknown string values are allowed for forward compatibility. Runners that\n * don't know how to satisfy a future requirement skip at runtime with\n * `skip_reason: 'requirement_unmet'` and the authored value in\n * `skip.requirement`.\n /\nfunction validateRequires(storyboard: Storyboard): void {\n if (storyboard.requires === undefined) return;\n if (!Array.isArray(storyboard.requires)) {\n throw new Error(\n `[${storyboard.id}] requires: must be an array of requirement names (got ${typeof storyboard.requires})`\n );\n }\n if (storyboard.requires.length === 0) {\n throw new Error(`[${storyboard.id}] requires: [] is not allowed — omit the field to use the default ([real_wire])`);\n }\n for (let i = 0; i < storyboard.requires.length; i++) {\n const name = storyboard.requires[i];\n if (typeof name !== 'string' \|\| name.length === 0) {\n throw new Error(`[${storyboard.id}] requires[${i}]: entries must be non-empty strings`);\n }\n }\n}\n\n/\n Issue #820: mutating tasks (per {@link MUTATING_TASKS}) must have a\n * `sample_request` authored. The fixture is authoritative at run time —\n * there's no sane default payload for a write, and silently fabricating\n * one was the bug factory that produced #780 / #792 / #793 / #802 / #805.\n \n Error messages point at the task name, the step id, the storyboard, and\n * suggest the concrete author action.\n \n Opt-out: steps with `expect_error: true` that deliberately exercise\n * missing-fixture / malformed-payload seller behavior skip this check —\n * the author is signaling the payload is the test condition.\n \n Synthesized phases (`request-signing/synthesize.ts`, controller seeding)\n * start with `phase.steps = []` in YAML and the loader doesn't see the\n * runtime-generated steps, so those paths are not affected.\n /\nfunction validateFixtureForMutatingStep(\n storyboardId: string,\n phase: Storyboard['phases'][number],\n step: Storyboard['phases'][number]['steps'][number]\n): void {\n if (!MUTATING_TASKS.has(step.task)) return;\n if (step.sample_request !== undefined) return;\n if (step.expect_error === true) return;\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}' (task=${step.task}): ` +\n `mutating tasks require a sample_request fixture — the runner no longer fabricates ` +\n `write payloads. Author sample_request in the step or, for intentionally malformed ` +\n `payloads, set expect_error: true.`\n );\n}\n\n/\n `omit_account: true` must be paired with `expect_error: true`.\n \n An accountless `create_media_buy` will always be rejected by a spec-compliant\n * seller; a step that sets `omit_account` without `expect_error` will be graded\n * as a failure (not a controlled negative test), producing a misleading\n * compliance result. Fail loud at parse time so the author sees the problem\n * during storyboard load, not at run time.\n /\nfunction validateOmitFlagCoherence(\n storyboardId: string,\n phase: Storyboard['phases'][number],\n step: Storyboard['phases'][number]['steps'][number]\n): void {\n if (step.omit_account && step.expect_error !== true) {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}': ` +\n `omit_account: true requires expect_error: true — an accountless ` +\n `create_media_buy will always be rejected by a spec-compliant seller.`\n );\n }\n}\n\n/\n Each `context_outputs` entry must declare exactly one source: either\n * `path` (extract from response) or `generate` (mint at run time). An entry\n * with neither is a silent no-op; one with both would silently pick `generate`\n * and ignore `path`. Both are authoring foot-guns that should fail loud.\n /\nfunction validateContextOutputs(\n storyboardId: string,\n phase: Storyboard['phases'][number],\n step: Storyboard['phases'][number]['steps'][number]\n): void {\n if (!step.context_outputs?.length) return;\n for (const output of step.context_outputs) {\n const hasPath = output.path !== undefined;\n const hasGenerate = output.generate !== undefined;\n if (!hasPath && !hasGenerate) {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}': context_outputs entry ` +\n `'${output.key}' must set exactly one of 'path' or 'generate'.`\n );\n }\n if (hasPath && hasGenerate) {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}': context_outputs entry ` +\n `'${output.key}' sets both 'path' and 'generate' — they are mutually exclusive.`\n );\n }\n // Validate generator name. The runtime resolver also checks but the loader\n // catches typos at storyboard-load time so authors see the failure on\n // build, not on the first run.\n if (hasGenerate && output.generate !== 'uuid_v4' && output.generate !== 'opaque_id') {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}': context_outputs entry ` +\n `'${output.key}' has unknown generate value '${output.generate}'. ` +\n `Supported: 'uuid_v4', 'opaque_id'.`\n );\n }\n }\n}\n\n/\n Authoring-time validation for `provides_state_for` (the AdCP 3.0.3 spec\n * field — adcp#3734) and the legacy `peer_substitutes_for` synonym. The\n * runner treats the field as same-phase-only and substitution-only-when-\n * stateful; surface those constraints at parse time so storyboard authors\n * see typos and cross-phase references on build, not as a silent no-rescue\n * at run time.\n \n Both field names parse to the same canonical normalized form on the step\n * object (the spec name `provides_state_for` is preferred when both are\n * declared). The deprecation alias is documented in `types.ts`.\n \n Rules:\n * - Each target must reference a step that exists in the same phase.\n * - A step cannot substitute for itself.\n * - The substitute step itself must be `stateful: true` — non-stateful\n * passes don't establish state per the cascade contract.\n * - The target step must be `stateful: true` — non-stateful targets\n * don't participate in cascade gating, so a substitution declaration\n * would be a no-op.\n * - When both fields are declared on the same step, they must match\n * element-for-element (the deprecation contract is \"synonym for\", not\n * \"additive with\").\n /\nfunction validatePeerSubstitutesFor(\n storyboardId: string,\n phase: Storyboard['phases'][number],\n step: Storyboard['phases'][number]['steps'][number]\n): void {\n const newField = step.provides_state_for;\n const legacyField = step.peer_substitutes_for;\n if (newField === undefined && legacyField === undefined) return;\n\n if (newField !== undefined && legacyField !== undefined) {\n // Order-sensitive equality: `[A, B]` vs `[B, A]` would throw despite being\n // semantically equivalent. Authors mid-migration should write the same list\n // in both fields; the deprecation alias is a literal synonym, not a\n // same-set restatement.\n const a = JSON.stringify(Array.isArray(newField) ? newField : [newField]);\n const b = JSON.stringify(Array.isArray(legacyField) ? legacyField : [legacyField]);\n if (a !== b) {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}': both provides_state_for and ` +\n `peer_substitutes_for declared with different values — pick one (provides_state_for is the ` +\n `spec field; peer_substitutes_for is a deprecated synonym)`\n );\n }\n }\n\n // Normalize onto provides_state_for so the runner can read a single field.\n // peer_substitutes_for stays for back-compat with any consumer code that\n // already reads it.\n if (newField === undefined && legacyField !== undefined) {\n step.provides_state_for = legacyField;\n } else if (newField !== undefined && legacyField === undefined) {\n step.peer_substitutes_for = newField;\n }\n\n const sourceFieldName = newField !== undefined ? 'provides_state_for' : 'peer_substitutes_for';\n const declared = step.provides_state_for!;\n const targets = Array.isArray(declared) ? declared : [declared];\n if (!step.stateful) {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}': ${sourceFieldName} is only legal on stateful steps`\n );\n }\n const phaseStepIds = new Map(phase.steps.map(s => [s.id, s]));\n for (const target of targets) {\n if (typeof target !== 'string' \|\| target.length === 0) {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}': ${sourceFieldName} entries must be non-empty strings`\n );\n }\n if (target === step.id) {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}': ${sourceFieldName} cannot reference itself`\n );\n }\n const targetStep = phaseStepIds.get(target);\n if (!targetStep) {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}': ${sourceFieldName} target '${target}' is not a step in this phase (same-phase only)`\n );\n }\n if (!targetStep.stateful) {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}': ${sourceFieldName} target '${target}' must be stateful`\n );\n }\n }\n}\n\nfunction validateBranchSet(storyboardId: string, phase: Storyboard['phases'][number]): void {\n if (phase.branch_set === undefined) return;\n const bs = phase.branch_set as unknown;\n if (!bs \|\| typeof bs !== 'object') {\n throw new Error(`[${storyboardId}] phase '${phase.id}': branch_set must be an object with { id, semantics }`);\n }\n const { id, semantics } = bs as Record<string, unknown>;\n if (typeof id !== 'string' \|\| id.length === 0) {\n throw new Error(`[${storyboardId}] phase '${phase.id}': branch_set.id must be a non-empty string`);\n }\n if (typeof semantics !== 'string' \|\| semantics.length === 0) {\n throw new Error(`[${storyboardId}] phase '${phase.id}': branch_set.semantics must be a non-empty string`);\n }\n // Only `any_of` is defined in AdCP today (adcp#2646 lint rule 2 —\n // `at_least_n` and `all_of` are reserved but not defined). Reject unknown\n // values at parse rather than silently skipping grading at runtime, so\n // spec-drift typos fail loud instead of degrading to raw `failed` peers.\n if (!(BRANCH_SET_SEMANTICS as readonly string[]).includes(semantics)) {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}': branch_set.semantics='${semantics}' is not supported (valid: ${BRANCH_SET_SEMANTICS.join(', ')})`\n );\n }\n // Schema constraint: every phase in a branch set MUST be optional. A\n // non-optional branch-set phase would fail the storyboard on any step\n // failure regardless of peer contribution, defeating the any_of gate.\n if (phase.optional !== true) {\n throw new Error(`[${storyboardId}] phase '${phase.id}': phases declaring branch_set must set 'optional: true'`);\n }\n}\n\n/\n Resolve the `contributes: true` boolean shorthand introduced alongside the\n * first-class `branch_set:` phase field (adcp-client#693, adcp#2646).\n \n Rules:\n * - `contributes: true` is legal only inside a phase that declares `branch_set:`.\n * - A step MUST NOT set both `contributes` and `contributes_to` (ambiguous).\n * - A string `contributes_to` inside a branch_set phase MUST equal `branch_set.id`\n * (otherwise the aggregation target drifts — same invariant the spec lint enforces).\n \n After resolution, `step.contributes_to` carries the flag name and `step.contributes`\n * is cleared, so the runner reads a single field regardless of authoring form.\n */\nfunction resolveContributesShorthand(\n storyboardId: string,\n phase: Storyboard['phases'][number],\n step: Storyboard['phases'][number]['steps'][number]\n): void {\n const hasBoolean = step.contributes !== undefined;\n const hasString = step.contributes_to !== undefined;\n\n if (hasBoolean && hasString) {\n throw new Error(`[${storyboardId}] step '${step.id}' declares both 'contributes' and 'contributes_to' — pick one`);\n }\n\n if (hasBoolean) {\n if (step.contributes === true) {\n if (!phase.branch_set) {\n throw new Error(\n `[${storyboardId}] step '${step.id}': 'contributes: true' is only legal inside a phase that declares branch_set`\n );\n }\n step.contributes_to = phase.branch_set.id;\n }\n delete step.contributes;\n return;\n }\n\n if (hasString && phase.branch_set && step.contributes_to !== phase.branch_set.id) {\n throw new Error(\n `[${storyboardId}] step '${step.id}': contributes_to='${step.contributes_to}' must equal enclosing phase's branch_set.id='${phase.branch_set.id}'`\n );\n }\n}\n"],"mappings":"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","names":["prefix","validSemver"]}
1	+ {"version":3,"sources":["../../../../src/lib/testing/storyboard/loader.ts"],"sourcesContent":["/*\n Storyboard YAML parser.\n \n Storyboards are pulled from the compliance cache populated by\n * `npm run sync-schemas`. See `./compliance.ts` for capability-driven\n * resolution and bundle loading.\n /\n\nimport { readFileSync } from 'fs';\nimport { parse } from 'yaml';\nimport type { Storyboard } from './types';\nimport { MUTATING_TASKS } from '../../utils/idempotency';\nimport { validateFixtureResolutionDeclarations } from './fixture-resolution';\nimport { valid as validSemver } from 'semver';\n\n/\n Supported `branch_set.semantics` values. Extend when AdCP adds `all_of`,\n * `at_least_n`, etc. Exported so the runner can enforce the same whitelist\n * on programmatically-constructed storyboards that bypass the YAML parser.\n /\nexport const BRANCH_SET_SEMANTICS = ['any_of'] as const;\n\nconst IDENTIFIER_PATH_SEGMENT = String.raw`[A-Za-z_][A-Za-z0-9_-](?:\\[\\\\])`;\nconst IDENTIFIER_PATH_PATTERN = new RegExp(`^${IDENTIFIER_PATH_SEGMENT}(?:\\\\.${IDENTIFIER_PATH_SEGMENT})$`);\n\n/* Parse a YAML string into a Storyboard. Throws if required fields are missing. /\nexport function parseStoryboard(yamlContent: string): Storyboard {\n const parsed = parse(yamlContent) as Storyboard;\n if (!parsed?.id \|\| !parsed?.phases) {\n throw new Error('Invalid storyboard YAML: missing required fields (id, phases)');\n }\n if (Object.prototype.hasOwnProperty.call(parsed, 'compliance_dir')) {\n throw new Error(\n 'Invalid storyboard YAML: compliance_dir is loader-owned runtime provenance; select an external cache with runner options instead.'\n );\n }\n for (const phase of parsed.phases) {\n // Specialism YAMLs may declare a phase with no `steps:` — the steps are\n // synthesized at runtime from fixtures (see request-signing/synthesize.ts).\n // Treat missing steps as an empty list so the parser stays phase-agnostic.\n if (!phase.steps) phase.steps = [];\n // YAML uses `name:` for context outputs but our runtime expects `key:`.\n for (const step of phase.steps) {\n if (!step.context_outputs) continue;\n for (const output of step.context_outputs) {\n const raw = output as unknown as Record<string, unknown>;\n if (raw.name && !raw.key) {\n output.key = raw.name as string;\n }\n }\n }\n }\n validateStoryboardShape(parsed);\n return parsed;\n}\n\n/* Load and parse a single storyboard file. Useful for ad-hoc testing of in-development YAMLs. /\nexport function loadStoryboardFile(filePath: string): Storyboard {\n return parseStoryboard(readFileSync(filePath, 'utf-8'));\n}\n\n/\n Enforce authoring-time invariants on a Storyboard. Called by\n * `parseStoryboard`, and should also be called by any runner entry point\n * that accepts a programmatically-built `Storyboard` object so the same\n * loud-fail-on-drift guarantee holds regardless of how the storyboard was\n * constructed. Mutates only legacy shorthand fields (resolves\n * `contributes: true` to `contributes_to`) and is idempotent on\n * already-validated inputs.\n /\nexport function validateStoryboardShape(storyboard: Storyboard): void {\n validateRequires(storyboard);\n validateFixtureResolutionDeclarations(storyboard);\n validateRequiredAnyOfTools(storyboard);\n validatePhaseDependsOn(storyboard);\n for (const phase of storyboard.phases) {\n validateBranchSet(storyboard.id, phase);\n if (!phase.steps) continue;\n for (const step of phase.steps) {\n resolveContributesShorthand(storyboard.id, phase, step);\n validateFixtureForMutatingStep(storyboard.id, phase, step);\n validateOmitFlagCoherence(storyboard.id, phase, step);\n validateContextOutputs(storyboard.id, phase, step);\n validateUpstreamAttestationMode(storyboard.id, phase, step);\n validateUpstreamIdentifierPaths(storyboard.id, phase, step);\n validateAdvisoryDeclarations(storyboard.id, phase, step);\n validatePeerSubstitutesFor(storyboard.id, phase, step);\n }\n }\n}\n\nfunction validateAdvisoryDeclarations(\n storyboardId: string,\n phase: { id?: string },\n step: { id?: string; validations?: any[] }\n): void {\n for (let index = 0; index < (step.validations ?? []).length; index++) {\n const validation = step.validations![index];\n if (\n validation?.severity !== undefined &&\n validation.severity !== 'required' &&\n validation.severity !== 'advisory'\n ) {\n const prefix = `[${storyboardId}] ${phase.id ?? '?'}.${step.id ?? '?'}.validations[${index}]`;\n throw new Error(`${prefix}.severity: must be either \"required\" or \"advisory\"`);\n }\n if (validation?.severity !== 'advisory') continue;\n const prefix = `[${storyboardId}] ${phase.id ?? '?'}.${step.id ?? '?'}.validations[${index}]`;\n const hasExpiry = validation.expires_after_version !== undefined;\n const hasPermanent = validation.permanent_advisory !== undefined;\n if (hasExpiry === hasPermanent) {\n throw new Error(\n `${prefix}: severity \"advisory\" must declare exactly one of expires_after_version or permanent_advisory`\n );\n }\n if (\n hasExpiry &&\n (typeof validation.expires_after_version !== 'string' \|\| !validSemver(validation.expires_after_version))\n ) {\n throw new Error(`${prefix}.expires_after_version: must be a valid semver string`);\n }\n if (\n hasPermanent &&\n (typeof validation.permanent_advisory !== 'object' \|\|\n validation.permanent_advisory === null \|\|\n typeof validation.permanent_advisory.reason !== 'string' \|\|\n validation.permanent_advisory.reason.trim().length === 0)\n ) {\n throw new Error(`${prefix}.permanent_advisory.reason: must be a non-empty string`);\n }\n }\n}\n\nfunction validateUpstreamAttestationMode(\n storyboardId: string,\n phase: { id?: string },\n step: { id?: string; validations?: any[] }\n): void {\n const validations = step.validations ?? [];\n for (let validationIndex = 0; validationIndex < validations.length; validationIndex++) {\n const validation = validations[validationIndex];\n if (validation?.check !== 'upstream_traffic') continue;\n const mode = validation.preferred_attestation_mode;\n if (mode !== undefined && mode !== 'raw' && mode !== 'digest') {\n throw new Error(\n `[${storyboardId}] ${phase.id ?? '?'}.${step.id ?? '?'}.validations[${validationIndex}].preferred_attestation_mode: must be \"raw\" or \"digest\"`\n );\n }\n }\n}\n\nfunction validateUpstreamIdentifierPaths(\n storyboardId: string,\n phase: { id?: string },\n step: { id?: string; validations?: any[] }\n): void {\n const validations = step.validations ?? [];\n for (let validationIndex = 0; validationIndex < validations.length; validationIndex++) {\n const validation = validations[validationIndex];\n if (validation?.check !== 'upstream_traffic' \|\| validation.identifier_paths === undefined) continue;\n if (!Array.isArray(validation.identifier_paths)) {\n throw new Error(\n `[${storyboardId}] ${phase.id ?? '?'}.${\n step.id ?? '?'\n }.validations[${validationIndex}].identifier_paths: must be an array of request-payload paths`\n );\n }\n for (let pathIndex = 0; pathIndex < validation.identifier_paths.length; pathIndex++) {\n const path = validation.identifier_paths[pathIndex];\n if (typeof path !== 'string' \|\| path.length === 0) {\n throw new Error(\n `[${storyboardId}] ${phase.id ?? '?'}.${step.id ?? '?'}.validations[${validationIndex}].identifier_paths[${pathIndex}]: must be a non-empty string`\n );\n }\n const pathErrorPrefix = `[${storyboardId}] ${phase.id ?? '?'}.${step.id ?? '?'}.validations[${validationIndex}].identifier_paths[${pathIndex}]`;\n let firstSegment: string;\n try {\n const validated = validateIdentifierPathSyntax(path);\n firstSegment = validated.firstSegment;\n } catch {\n throw new Error(\n `${pathErrorPrefix}: \"${path}\" is unsupported; identifier_paths resolve only against the request payload or sample_request using dotted paths with [] array selectors`\n );\n }\n const root = firstSegment.toLowerCase();\n if (root === 'request' \|\| root === 'response' \|\| root === 'context') {\n throw new Error(\n `${pathErrorPrefix}: \"${path}\" is unsupported; identifier_paths resolve only against the request payload or sample_request`\n );\n }\n }\n }\n}\n\nfunction validateIdentifierPathSyntax(path: string): { normalized: string; firstSegment: string } {\n const trimmed = path.trim();\n const normalized = trimmed.startsWith('$.') ? trimmed.slice(2) : trimmed;\n if (!IDENTIFIER_PATH_PATTERN.test(normalized)) {\n throw new Error('unsupported identifier path syntax');\n }\n return { normalized, firstSegment: normalized.split(/[.[\\]]/, 1)[0] ?? '' };\n}\n\nfunction validateRequiredAnyOfTools(storyboard: Storyboard): void {\n if (storyboard.required_any_of_tools === undefined) return;\n if (!Array.isArray(storyboard.required_any_of_tools)) {\n throw new Error(`[${storyboard.id}] required_any_of_tools: must be an array of tool-family objects`);\n }\n if (storyboard.required_any_of_tools.length === 0) {\n throw new Error(`[${storyboard.id}] required_any_of_tools: [] is not allowed — omit the field to use no gate`);\n }\n for (let i = 0; i < storyboard.required_any_of_tools.length; i++) {\n const family = storyboard.required_any_of_tools[i] as unknown;\n if (family === null \|\| typeof family !== 'object' \|\| Array.isArray(family)) {\n throw new Error(`[${storyboard.id}] required_any_of_tools[${i}]: must be an object`);\n }\n const { tools, rationale } = family as { tools?: unknown; rationale?: unknown };\n if (!Array.isArray(tools) \|\| tools.length < 2) {\n throw new Error(`[${storyboard.id}] required_any_of_tools[${i}].tools: must list at least two tool names`);\n }\n for (const tool of tools) {\n if (typeof tool !== 'string' \|\| tool.length === 0) {\n throw new Error(`[${storyboard.id}] required_any_of_tools[${i}].tools: entries must be non-empty strings`);\n }\n }\n if (rationale !== undefined && typeof rationale !== 'string') {\n throw new Error(`[${storyboard.id}] required_any_of_tools[${i}].rationale: must be a string`);\n }\n }\n}\n\n/*\n Authoring-time validation for `phase.depends_on` (#1161). Each entry\n * must reference a phase declared earlier in the storyboard. Forward\n * references and self-references fail loud at parse time so authoring\n * mistakes (typos, reorderings) don't degrade silently into \"phase\n * always runs\" / \"phase always cascades.\"\n \n Rules:\n * - Empty list (`depends_on: []`) is legal — it declares an\n * independent phase. No further validation needed.\n * - Each non-empty entry must be a non-empty string.\n * - Each entry must reference a phase that appears EARLIER in the\n * `storyboard.phases[]` array (forward references are rejected).\n * - A phase cannot depend on itself.\n /\nfunction validatePhaseDependsOn(storyboard: Storyboard): void {\n const phaseIdsSeen = new Set<string>();\n for (const phase of storyboard.phases) {\n if (phase.depends_on !== undefined) {\n if (!Array.isArray(phase.depends_on)) {\n throw new Error(`[${storyboard.id}] phase '${phase.id}': depends_on must be an array of phase ids`);\n }\n for (const dep of phase.depends_on) {\n if (typeof dep !== 'string' \|\| dep.length === 0) {\n throw new Error(`[${storyboard.id}] phase '${phase.id}': depends_on entries must be non-empty strings`);\n }\n if (dep === phase.id) {\n throw new Error(`[${storyboard.id}] phase '${phase.id}': depends_on cannot reference itself`);\n }\n if (!phaseIdsSeen.has(dep)) {\n throw new Error(\n `[${storyboard.id}] phase '${phase.id}': depends_on '${dep}' is not a phase declared earlier in this storyboard (forward and unknown references are rejected)`\n );\n }\n }\n }\n phaseIdsSeen.add(phase.id);\n }\n}\n\n/\n Authoring-time validation for `Storyboard.requires` (#1626). The field is\n * an array of non-empty requirement names:\n \n - `requires: []` is rejected — an empty array reads as \"no\n * requirements,\" which is the same as omitting the field; failing\n * load forces the author to omit it explicitly.\n * - Each entry must be a non-empty string.\n \n Unknown string values are allowed for forward compatibility. Runners that\n * don't know how to satisfy a future requirement skip at runtime with\n * `skip_reason: 'requirement_unmet'` and the authored value in\n * `skip.requirement`.\n /\nfunction validateRequires(storyboard: Storyboard): void {\n if (storyboard.requires === undefined) return;\n if (!Array.isArray(storyboard.requires)) {\n throw new Error(\n `[${storyboard.id}] requires: must be an array of requirement names (got ${typeof storyboard.requires})`\n );\n }\n if (storyboard.requires.length === 0) {\n throw new Error(`[${storyboard.id}] requires: [] is not allowed — omit the field to use the default ([real_wire])`);\n }\n for (let i = 0; i < storyboard.requires.length; i++) {\n const name = storyboard.requires[i];\n if (typeof name !== 'string' \|\| name.length === 0) {\n throw new Error(`[${storyboard.id}] requires[${i}]: entries must be non-empty strings`);\n }\n }\n}\n\n/\n Issue #820: mutating tasks (per {@link MUTATING_TASKS}) must have a\n * `sample_request` authored. The fixture is authoritative at run time —\n * there's no sane default payload for a write, and silently fabricating\n * one was the bug factory that produced #780 / #792 / #793 / #802 / #805.\n \n Error messages point at the task name, the step id, the storyboard, and\n * suggest the concrete author action.\n \n Opt-out: steps with `expect_error: true` that deliberately exercise\n * missing-fixture / malformed-payload seller behavior skip this check —\n * the author is signaling the payload is the test condition.\n \n Synthesized phases (`request-signing/synthesize.ts`, controller seeding)\n * start with `phase.steps = []` in YAML and the loader doesn't see the\n * runtime-generated steps, so those paths are not affected.\n /\nfunction validateFixtureForMutatingStep(\n storyboardId: string,\n phase: Storyboard['phases'][number],\n step: Storyboard['phases'][number]['steps'][number]\n): void {\n if (!MUTATING_TASKS.has(step.task)) return;\n if (step.sample_request !== undefined) return;\n if (step.expect_error === true) return;\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}' (task=${step.task}): ` +\n `mutating tasks require a sample_request fixture — the runner no longer fabricates ` +\n `write payloads. Author sample_request in the step or, for intentionally malformed ` +\n `payloads, set expect_error: true.`\n );\n}\n\n/\n `omit_account: true` must be paired with `expect_error: true`.\n \n An accountless `create_media_buy` will always be rejected by a spec-compliant\n * seller; a step that sets `omit_account` without `expect_error` will be graded\n * as a failure (not a controlled negative test), producing a misleading\n * compliance result. Fail loud at parse time so the author sees the problem\n * during storyboard load, not at run time.\n /\nfunction validateOmitFlagCoherence(\n storyboardId: string,\n phase: Storyboard['phases'][number],\n step: Storyboard['phases'][number]['steps'][number]\n): void {\n if (step.omit_account && step.expect_error !== true) {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}': ` +\n `omit_account: true requires expect_error: true — an accountless ` +\n `create_media_buy will always be rejected by a spec-compliant seller.`\n );\n }\n}\n\n/\n Each `context_outputs` entry must declare exactly one source: either\n * `path` (extract from response) or `generate` (mint at run time). An entry\n * with neither is a silent no-op; one with both would silently pick `generate`\n * and ignore `path`. Both are authoring foot-guns that should fail loud.\n /\nfunction validateContextOutputs(\n storyboardId: string,\n phase: Storyboard['phases'][number],\n step: Storyboard['phases'][number]['steps'][number]\n): void {\n if (!step.context_outputs?.length) return;\n for (const output of step.context_outputs) {\n const hasPath = output.path !== undefined;\n const hasGenerate = output.generate !== undefined;\n if (!hasPath && !hasGenerate) {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}': context_outputs entry ` +\n `'${output.key}' must set exactly one of 'path' or 'generate'.`\n );\n }\n if (hasPath && hasGenerate) {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}': context_outputs entry ` +\n `'${output.key}' sets both 'path' and 'generate' — they are mutually exclusive.`\n );\n }\n // Validate generator name. The runtime resolver also checks but the loader\n // catches typos at storyboard-load time so authors see the failure on\n // build, not on the first run.\n if (hasGenerate && output.generate !== 'uuid_v4' && output.generate !== 'opaque_id') {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}': context_outputs entry ` +\n `'${output.key}' has unknown generate value '${output.generate}'. ` +\n `Supported: 'uuid_v4', 'opaque_id'.`\n );\n }\n }\n}\n\n/\n Authoring-time validation for `provides_state_for` (the AdCP 3.0.3 spec\n * field — adcp#3734) and the legacy `peer_substitutes_for` synonym. The\n * runner treats the field as same-phase-only and substitution-only-when-\n * stateful; surface those constraints at parse time so storyboard authors\n * see typos and cross-phase references on build, not as a silent no-rescue\n * at run time.\n \n Both field names parse to the same canonical normalized form on the step\n * object (the spec name `provides_state_for` is preferred when both are\n * declared). The deprecation alias is documented in `types.ts`.\n \n Rules:\n * - Each target must reference a step that exists in the same phase.\n * - A step cannot substitute for itself.\n * - The substitute step itself must be `stateful: true` — non-stateful\n * passes don't establish state per the cascade contract.\n * - The target step must be `stateful: true` — non-stateful targets\n * don't participate in cascade gating, so a substitution declaration\n * would be a no-op.\n * - When both fields are declared on the same step, they must match\n * element-for-element (the deprecation contract is \"synonym for\", not\n * \"additive with\").\n /\nfunction validatePeerSubstitutesFor(\n storyboardId: string,\n phase: Storyboard['phases'][number],\n step: Storyboard['phases'][number]['steps'][number]\n): void {\n const newField = step.provides_state_for;\n const legacyField = step.peer_substitutes_for;\n if (newField === undefined && legacyField === undefined) return;\n\n if (newField !== undefined && legacyField !== undefined) {\n // Order-sensitive equality: `[A, B]` vs `[B, A]` would throw despite being\n // semantically equivalent. Authors mid-migration should write the same list\n // in both fields; the deprecation alias is a literal synonym, not a\n // same-set restatement.\n const a = JSON.stringify(Array.isArray(newField) ? newField : [newField]);\n const b = JSON.stringify(Array.isArray(legacyField) ? legacyField : [legacyField]);\n if (a !== b) {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}': both provides_state_for and ` +\n `peer_substitutes_for declared with different values — pick one (provides_state_for is the ` +\n `spec field; peer_substitutes_for is a deprecated synonym)`\n );\n }\n }\n\n // Normalize onto provides_state_for so the runner can read a single field.\n // peer_substitutes_for stays for back-compat with any consumer code that\n // already reads it.\n if (newField === undefined && legacyField !== undefined) {\n step.provides_state_for = legacyField;\n } else if (newField !== undefined && legacyField === undefined) {\n step.peer_substitutes_for = newField;\n }\n\n const sourceFieldName = newField !== undefined ? 'provides_state_for' : 'peer_substitutes_for';\n const declared = step.provides_state_for!;\n const targets = Array.isArray(declared) ? declared : [declared];\n if (!step.stateful) {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}': ${sourceFieldName} is only legal on stateful steps`\n );\n }\n const phaseStepIds = new Map(phase.steps.map(s => [s.id, s]));\n for (const target of targets) {\n if (typeof target !== 'string' \|\| target.length === 0) {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}': ${sourceFieldName} entries must be non-empty strings`\n );\n }\n if (target === step.id) {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}': ${sourceFieldName} cannot reference itself`\n );\n }\n const targetStep = phaseStepIds.get(target);\n if (!targetStep) {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}': ${sourceFieldName} target '${target}' is not a step in this phase (same-phase only)`\n );\n }\n if (!targetStep.stateful) {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}' step '${step.id}': ${sourceFieldName} target '${target}' must be stateful`\n );\n }\n }\n}\n\nfunction validateBranchSet(storyboardId: string, phase: Storyboard['phases'][number]): void {\n if (phase.branch_set === undefined) return;\n const bs = phase.branch_set as unknown;\n if (!bs \|\| typeof bs !== 'object') {\n throw new Error(`[${storyboardId}] phase '${phase.id}': branch_set must be an object with { id, semantics }`);\n }\n const { id, semantics } = bs as Record<string, unknown>;\n if (typeof id !== 'string' \|\| id.length === 0) {\n throw new Error(`[${storyboardId}] phase '${phase.id}': branch_set.id must be a non-empty string`);\n }\n if (typeof semantics !== 'string' \|\| semantics.length === 0) {\n throw new Error(`[${storyboardId}] phase '${phase.id}': branch_set.semantics must be a non-empty string`);\n }\n // Only `any_of` is defined in AdCP today (adcp#2646 lint rule 2 —\n // `at_least_n` and `all_of` are reserved but not defined). Reject unknown\n // values at parse rather than silently skipping grading at runtime, so\n // spec-drift typos fail loud instead of degrading to raw `failed` peers.\n if (!(BRANCH_SET_SEMANTICS as readonly string[]).includes(semantics)) {\n throw new Error(\n `[${storyboardId}] phase '${phase.id}': branch_set.semantics='${semantics}' is not supported (valid: ${BRANCH_SET_SEMANTICS.join(', ')})`\n );\n }\n // Schema constraint: every phase in a branch set MUST be optional. A\n // non-optional branch-set phase would fail the storyboard on any step\n // failure regardless of peer contribution, defeating the any_of gate.\n if (phase.optional !== true) {\n throw new Error(`[${storyboardId}] phase '${phase.id}': phases declaring branch_set must set 'optional: true'`);\n }\n}\n\n/\n Resolve the `contributes: true` boolean shorthand introduced alongside the\n * first-class `branch_set:` phase field (adcp-client#693, adcp#2646).\n \n Rules:\n * - `contributes: true` is legal only inside a phase that declares `branch_set:`.\n * - A step MUST NOT set both `contributes` and `contributes_to` (ambiguous).\n * - A string `contributes_to` inside a branch_set phase MUST equal `branch_set.id`\n * (otherwise the aggregation target drifts — same invariant the spec lint enforces).\n \n After resolution, `step.contributes_to` carries the flag name and `step.contributes`\n * is cleared, so the runner reads a single field regardless of authoring form.\n */\nfunction resolveContributesShorthand(\n storyboardId: string,\n phase: Storyboard['phases'][number],\n step: Storyboard['phases'][number]['steps'][number]\n): void {\n const hasBoolean = step.contributes !== undefined;\n const hasString = step.contributes_to !== undefined;\n\n if (hasBoolean && hasString) {\n throw new Error(`[${storyboardId}] step '${step.id}' declares both 'contributes' and 'contributes_to' — pick one`);\n }\n\n if (hasBoolean) {\n if (step.contributes === true) {\n if (!phase.branch_set) {\n throw new Error(\n `[${storyboardId}] step '${step.id}': 'contributes: true' is only legal inside a phase that declares branch_set`\n );\n }\n step.contributes_to = phase.branch_set.id;\n }\n delete step.contributes;\n return;\n }\n\n if (hasString && phase.branch_set && step.contributes_to !== phase.branch_set.id) {\n throw new Error(\n `[${storyboardId}] step '${step.id}': contributes_to='${step.contributes_to}' must equal enclosing phase's branch_set.id='${phase.branch_set.id}'`\n );\n }\n}\n"],"mappings":"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","names":["prefix","validSemver"]}

package/dist/lib/testing/storyboard/loader.mjs CHANGED Viewed

@@ -11,6 +11,11 @@ function parseStoryboard(yamlContent) {
   if (!parsed?.id || !parsed?.phases) {
     throw new Error("Invalid storyboard YAML: missing required fields (id, phases)");
   }
+  if (Object.prototype.hasOwnProperty.call(parsed, "compliance_dir")) {
+    throw new Error(
+      "Invalid storyboard YAML: compliance_dir is loader-owned runtime provenance; select an external cache with runner options instead."
+    );
+  }
   for (const phase of parsed.phases) {
     if (!phase.steps) phase.steps = [];
     for (const step of phase.steps) {