@adcp/sdk 16.5.0 → 16.6.0

package/dist/lib/testing/storyboard/canonical-format-satisfaction.js

@@ -208,17 +208,41 @@ function evaluatePackage(pkg, pointer, index, products) {
       actual: productId ?? null
     };
   }
+  const routes = [];
   const formatOptionRefs = Array.isArray(pkg.format_option_refs) ? pkg.format_option_refs : [];
   if (formatOptionRefs.length > 0) {
-    return evaluateFormatOptionRefs(formatOptionRefs, product, pointer);
+    routes.push({ name: "format_option_refs", verdict: evaluateFormatOptionRefs(formatOptionRefs, product, pointer) });
   }
   const formatIds = Array.isArray(pkg.format_ids) ? pkg.format_ids : [];
   if (formatIds.length > 0) {
-    return evaluateLegacyFormatIds(formatIds, product, pointer, productId);
+    routes.push({ name: "format_ids", verdict: evaluateLegacyFormatIds(formatIds, product, pointer, productId) });
   }
   const canonicalSelectors = extractCanonicalSelectors(pkg, pointer);
   if (canonicalSelectors.length > 0) {
-    return evaluateCanonicalSelectors(canonicalSelectors, product);
+    routes.push({ name: "canonical selectors", verdict: evaluateCanonicalSelectors(canonicalSelectors, product) });
+  }
+  const failed = routes.find((route) => !route.verdict.satisfied);
+  if (failed) return failed.verdict;
+  const primary = routes[0];
+  if (primary) {
+    const selected = new Set(primary.verdict.selectedDeclarations);
+    const conflicting = routes.slice(1).find((route) => {
+      const other = new Set(route.verdict.selectedDeclarations);
+      return selected.size !== other.size || [...selected].some((index2) => !other.has(index2));
+    });
+    if (conflicting) {
+      return {
+        satisfied: false,
+        bug_class: "directionality",
+        detail: `Conflicting selector routes ${primary.name} and ${conflicting.name} select different product format_options[] sets`,
+        json_pointer: pointer,
+        observations: routes.map((route) => ({
+          route: route.name,
+          selected_declarations: route.verdict.selectedDeclarations
+        }))
+      };
+    }
+    return primary.verdict;
   }
   return {
     satisfied: true,
@@ -238,6 +262,7 @@ function evaluateFormatOptionRefs(refs, product, packagePointer) {
       actual: refs
     };
   }
+  const selected = /* @__PURE__ */ new Set();
   for (let i = 0; i < refs.length; i++) {
     const ref = refs[i];
     if (!isRecord(ref)) {
@@ -267,13 +292,13 @@ function evaluateFormatOptionRefs(refs, product, packagePointer) {
         actual: ref
       };
     }
-    const match = declarations.find((decl) => {
+    const match = declarations.findIndex((decl) => {
       if (ref.scope === "publisher") {
         return decl.publisher_domain === ref.publisher_domain && decl.format_option_id === ref.format_option_id && typeof ref.publisher_domain === "string";
       }
       return decl.format_option_id === ref.format_option_id && !decl.publisher_domain;
     });
-    if (!match) {
+    if (match < 0) {
       return {
         satisfied: false,
         bug_class: "closed_set",
@@ -283,16 +308,19 @@ function evaluateFormatOptionRefs(refs, product, packagePointer) {
         observations: [{ available_format_option_ids: declarations.map(declarationLabel).filter(Boolean) }]
       };
     }
+    selected.add(match);
   }
   return {
     satisfied: true,
     bug_class: "directionality",
     detail: "Every format_option_refs[] entry resolved to the target product format_options[] closed set",
-    json_pointer: `${packagePointer}/format_option_refs`
+    json_pointer: `${packagePointer}/format_option_refs`,
+    selectedDeclarations: [...selected]
   };
 }
 function evaluateLegacyFormatIds(refs, product, packagePointer, productId) {
   const declarations = productFormatOptions(product);
+  const selected = /* @__PURE__ */ new Set();
   for (let i = 0; i < refs.length; i++) {
     const ref = refs[i];
     if (!isFormatId(ref)) {
@@ -304,12 +332,22 @@ function evaluateLegacyFormatIds(refs, product, packagePointer, productId) {
         actual: ref
       };
     }
-    const direct = declarations.find((decl) => (decl.v1_format_ref ?? []).some((v1) => sameFormatId(v1, ref)));
-    if (direct) continue;
+    const direct = declarations.flatMap(
+      (decl, index) => (decl.v1_format_ref ?? []).some((v1) => sameFormatId(v1, ref)) ? [index] : []
+    );
+    if (direct.length > 0) {
+      for (const index of direct) selected.add(index);
+      continue;
+    }
     const projected = projectLegacyRef(ref, productId, `${packagePointer}/format_ids/${i}`);
     if (projected) {
-      const match = declarations.find((decl) => canonicalSelectorSatisfiesDeclaration(projected, decl).ok);
-      if (match) continue;
+      const matches = declarations.flatMap(
+        (decl, index) => canonicalSelectorSatisfiesDeclaration(projected, decl).ok ? [index] : []
+      );
+      if (matches.length > 0) {
+        for (const index of matches) selected.add(index);
+        continue;
+      }
     }
     if (declarations.length === 0 && Array.isArray(product.format_ids) && product.format_ids.some((fid) => isFormatId(fid) && sameFormatId(fid, ref))) {
       continue;
@@ -327,7 +365,8 @@ function evaluateLegacyFormatIds(refs, product, packagePointer, productId) {
     satisfied: true,
     bug_class: "normalization",
     detail: "Every legacy format_id normalized to a product canonical declaration or product legacy format_id",
-    json_pointer: `${packagePointer}/format_ids`
+    json_pointer: `${packagePointer}/format_ids`,
+    selectedDeclarations: [...selected]
   };
 }
 function evaluateCanonicalSelectors(selectors, product) {
@@ -341,6 +380,7 @@ function evaluateCanonicalSelectors(selectors, product) {
       actual: selectors
     };
   }
+  const selected = /* @__PURE__ */ new Set();
   for (const selector of selectors) {
     const candidates = declarations.filter((decl) => decl.format_kind === selector.format_kind);
     if (candidates.length === 0) {
@@ -353,7 +393,12 @@ function evaluateCanonicalSelectors(selectors, product) {
       };
     }
     const checks = candidates.map((decl) => canonicalSelectorSatisfiesDeclaration(selector, decl));
-    if (checks.some((c) => c.ok)) continue;
+    if (checks.some((c) => c.ok)) {
+      for (const [index, decl] of declarations.entries()) {
+        if (canonicalSelectorSatisfiesDeclaration(selector, decl).ok) selected.add(index);
+      }
+      continue;
+    }
     const primary = checks.find((c) => c.bug_class === "range_containment") ?? checks[0];
     return {
       satisfied: false,
@@ -368,7 +413,8 @@ function evaluateCanonicalSelectors(selectors, product) {
     satisfied: true,
     bug_class: "directionality",
     detail: "Every canonical selector satisfies at least one product format_options[] declaration",
-    json_pointer: selectors[0]?.pointer ?? null
+    json_pointer: selectors[0]?.pointer ?? null,
+    selectedDeclarations: [...selected]
   };
 }
 function canonicalSelectorSatisfiesDeclaration(selector, decl) {
@@ -737,7 +783,7 @@ function collectRejectionInfo(value, codes, fields, messages, depth = 0) {
 }
 function rejectionSupportsFormatFailure(rejection) {
   if (!rejection) return false;
-  if (rejection.codes.some((code) => code.startsWith("FORMAT_"))) return true;
+  if (rejection.codes.some((code) => code.startsWith("FORMAT_") || code === "CONFLICTING_SELECTORS")) return true;
   return [...rejection.fields, ...rejection.messages].some(
     (text) => /format|format_option|format_id|selector/i.test(text)
   );

package/dist/lib/testing/storyboard/canonical-format-satisfaction.mjs

@@ -184,17 +184,41 @@ function evaluatePackage(pkg, pointer, index, products) {
       actual: productId ?? null
     };
   }
+  const routes = [];
   const formatOptionRefs = Array.isArray(pkg.format_option_refs) ? pkg.format_option_refs : [];
   if (formatOptionRefs.length > 0) {
-    return evaluateFormatOptionRefs(formatOptionRefs, product, pointer);
+    routes.push({ name: "format_option_refs", verdict: evaluateFormatOptionRefs(formatOptionRefs, product, pointer) });
   }
   const formatIds = Array.isArray(pkg.format_ids) ? pkg.format_ids : [];
   if (formatIds.length > 0) {
-    return evaluateLegacyFormatIds(formatIds, product, pointer, productId);
+    routes.push({ name: "format_ids", verdict: evaluateLegacyFormatIds(formatIds, product, pointer, productId) });
   }
   const canonicalSelectors = extractCanonicalSelectors(pkg, pointer);
   if (canonicalSelectors.length > 0) {
-    return evaluateCanonicalSelectors(canonicalSelectors, product);
+    routes.push({ name: "canonical selectors", verdict: evaluateCanonicalSelectors(canonicalSelectors, product) });
+  }
+  const failed = routes.find((route) => !route.verdict.satisfied);
+  if (failed) return failed.verdict;
+  const primary = routes[0];
+  if (primary) {
+    const selected = new Set(primary.verdict.selectedDeclarations);
+    const conflicting = routes.slice(1).find((route) => {
+      const other = new Set(route.verdict.selectedDeclarations);
+      return selected.size !== other.size || [...selected].some((index2) => !other.has(index2));
+    });
+    if (conflicting) {
+      return {
+        satisfied: false,
+        bug_class: "directionality",
+        detail: `Conflicting selector routes ${primary.name} and ${conflicting.name} select different product format_options[] sets`,
+        json_pointer: pointer,
+        observations: routes.map((route) => ({
+          route: route.name,
+          selected_declarations: route.verdict.selectedDeclarations
+        }))
+      };
+    }
+    return primary.verdict;
   }
   return {
     satisfied: true,
@@ -214,6 +238,7 @@ function evaluateFormatOptionRefs(refs, product, packagePointer) {
       actual: refs
     };
   }
+  const selected = /* @__PURE__ */ new Set();
   for (let i = 0; i < refs.length; i++) {
     const ref = refs[i];
     if (!isRecord(ref)) {
@@ -243,13 +268,13 @@ function evaluateFormatOptionRefs(refs, product, packagePointer) {
         actual: ref
       };
     }
-    const match = declarations.find((decl) => {
+    const match = declarations.findIndex((decl) => {
       if (ref.scope === "publisher") {
         return decl.publisher_domain === ref.publisher_domain && decl.format_option_id === ref.format_option_id && typeof ref.publisher_domain === "string";
       }
       return decl.format_option_id === ref.format_option_id && !decl.publisher_domain;
     });
-    if (!match) {
+    if (match < 0) {
       return {
         satisfied: false,
         bug_class: "closed_set",
@@ -259,16 +284,19 @@ function evaluateFormatOptionRefs(refs, product, packagePointer) {
         observations: [{ available_format_option_ids: declarations.map(declarationLabel).filter(Boolean) }]
       };
     }
+    selected.add(match);
   }
   return {
     satisfied: true,
     bug_class: "directionality",
     detail: "Every format_option_refs[] entry resolved to the target product format_options[] closed set",
-    json_pointer: `${packagePointer}/format_option_refs`
+    json_pointer: `${packagePointer}/format_option_refs`,
+    selectedDeclarations: [...selected]
   };
 }
 function evaluateLegacyFormatIds(refs, product, packagePointer, productId) {
   const declarations = productFormatOptions(product);
+  const selected = /* @__PURE__ */ new Set();
   for (let i = 0; i < refs.length; i++) {
     const ref = refs[i];
     if (!isFormatId(ref)) {
@@ -280,12 +308,22 @@ function evaluateLegacyFormatIds(refs, product, packagePointer, productId) {
         actual: ref
       };
     }
-    const direct = declarations.find((decl) => (decl.v1_format_ref ?? []).some((v1) => sameFormatId(v1, ref)));
-    if (direct) continue;
+    const direct = declarations.flatMap(
+      (decl, index) => (decl.v1_format_ref ?? []).some((v1) => sameFormatId(v1, ref)) ? [index] : []
+    );
+    if (direct.length > 0) {
+      for (const index of direct) selected.add(index);
+      continue;
+    }
     const projected = projectLegacyRef(ref, productId, `${packagePointer}/format_ids/${i}`);
     if (projected) {
-      const match = declarations.find((decl) => canonicalSelectorSatisfiesDeclaration(projected, decl).ok);
-      if (match) continue;
+      const matches = declarations.flatMap(
+        (decl, index) => canonicalSelectorSatisfiesDeclaration(projected, decl).ok ? [index] : []
+      );
+      if (matches.length > 0) {
+        for (const index of matches) selected.add(index);
+        continue;
+      }
     }
     if (declarations.length === 0 && Array.isArray(product.format_ids) && product.format_ids.some((fid) => isFormatId(fid) && sameFormatId(fid, ref))) {
       continue;
@@ -303,7 +341,8 @@ function evaluateLegacyFormatIds(refs, product, packagePointer, productId) {
     satisfied: true,
     bug_class: "normalization",
     detail: "Every legacy format_id normalized to a product canonical declaration or product legacy format_id",
-    json_pointer: `${packagePointer}/format_ids`
+    json_pointer: `${packagePointer}/format_ids`,
+    selectedDeclarations: [...selected]
   };
 }
 function evaluateCanonicalSelectors(selectors, product) {
@@ -317,6 +356,7 @@ function evaluateCanonicalSelectors(selectors, product) {
       actual: selectors
     };
   }
+  const selected = /* @__PURE__ */ new Set();
   for (const selector of selectors) {
     const candidates = declarations.filter((decl) => decl.format_kind === selector.format_kind);
     if (candidates.length === 0) {
@@ -329,7 +369,12 @@ function evaluateCanonicalSelectors(selectors, product) {
       };
     }
     const checks = candidates.map((decl) => canonicalSelectorSatisfiesDeclaration(selector, decl));
-    if (checks.some((c) => c.ok)) continue;
+    if (checks.some((c) => c.ok)) {
+      for (const [index, decl] of declarations.entries()) {
+        if (canonicalSelectorSatisfiesDeclaration(selector, decl).ok) selected.add(index);
+      }
+      continue;
+    }
     const primary = checks.find((c) => c.bug_class === "range_containment") ?? checks[0];
     return {
       satisfied: false,
@@ -344,7 +389,8 @@ function evaluateCanonicalSelectors(selectors, product) {
     satisfied: true,
     bug_class: "directionality",
     detail: "Every canonical selector satisfies at least one product format_options[] declaration",
-    json_pointer: selectors[0]?.pointer ?? null
+    json_pointer: selectors[0]?.pointer ?? null,
+    selectedDeclarations: [...selected]
   };
 }
 function canonicalSelectorSatisfiesDeclaration(selector, decl) {
@@ -713,7 +759,7 @@ function collectRejectionInfo(value, codes, fields, messages, depth = 0) {
 }
 function rejectionSupportsFormatFailure(rejection) {
   if (!rejection) return false;
-  if (rejection.codes.some((code) => code.startsWith("FORMAT_"))) return true;
+  if (rejection.codes.some((code) => code.startsWith("FORMAT_") || code === "CONFLICTING_SELECTORS")) return true;
   return [...rejection.fields, ...rejection.messages].some(
     (text) => /format|format_option|format_id|selector/i.test(text)
   );

package/dist/lib/testing/storyboard/compliance.d.mts

@@ -181,12 +181,9 @@ export declare function getExternalSchemaRootForCompliance(options: ResolveOptio
 export declare function loadBundleStoryboards(ref: BundleRef): Storyboard[];
 /** Enumerate every bundle present in the cache (universal + protocols + specialisms). */
 export declare function listBundles(options?: ResolveOptions): BundleRef[];
-/** List every storyboard the cache can produce, across all bundles. */
+/** List every storyboard the selected immutable bundle can produce, as detached records. */
 export declare function listAllComplianceStoryboards(options?: ResolveOptions): Storyboard[];
-/**
- * Find a storyboard by its internal `id` (the YAML's `id:` field).
- * Scans every bundle in the cache. Returns undefined if no match.
- */
+/** Find a storyboard by its internal YAML id without reparsing a warm bundle. */
 export declare function getComplianceStoryboardById(id: string, options?: ResolveOptions): Storyboard | undefined;
 /** Find a bundle by its directory/file id (`media-buy`, `sales-guaranteed`, `capability-discovery`). */
 export declare function findBundleById(id: string, options?: ResolveOptions): BundleRef | undefined;

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

@@ -181,12 +181,9 @@ export declare function getExternalSchemaRootForCompliance(options: ResolveOptio
 export declare function loadBundleStoryboards(ref: BundleRef): Storyboard[];
 /** Enumerate every bundle present in the cache (universal + protocols + specialisms). */
 export declare function listBundles(options?: ResolveOptions): BundleRef[];
-/** List every storyboard the cache can produce, across all bundles. */
+/** List every storyboard the selected immutable bundle can produce, as detached records. */
 export declare function listAllComplianceStoryboards(options?: ResolveOptions): Storyboard[];
-/**
- * Find a storyboard by its internal `id` (the YAML's `id:` field).
- * Scans every bundle in the cache. Returns undefined if no match.
- */
+/** Find a storyboard by its internal YAML id without reparsing a warm bundle. */
 export declare function getComplianceStoryboardById(id: string, options?: ResolveOptions): Storyboard | undefined;
 /** Find a bundle by its directory/file id (`media-buy`, `sales-guaranteed`, `capability-discovery`). */
 export declare function findBundleById(id: string, options?: ResolveOptions): BundleRef | undefined;

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

@@ -47,6 +47,7 @@ var import_errors = require('../../errors/index.js');
 var import_adcp_version_config = require('../../utils/adcp-version-config.js');
 var import_schema_loader = require('../../validation/schema-loader.js');
 var import_synthesize = require('./request-signing/synthesize.js');
+var import_vector_loader = require('./request-signing/vector-loader.js');
 var import_provenance = require('./provenance.js');
 class CapabilityResolutionError extends import_errors.ADCPError {
   code;
@@ -434,23 +435,71 @@ function listBundles(options = {}) {
   }
   return bundles;
 }
-function listAllComplianceStoryboards(options = {}) {
-  const seen = /* @__PURE__ */ new Set();
-  const storyboards = [];
-  for (const ref of listBundles(options)) {
-    for (const sb of loadBundleStoryboards(ref)) {
-      if (seen.has(sb.id)) continue;
-      seen.add(sb.id);
-      storyboards.push(sb);
+const STORYBOARD_INDEX_CACHE_LIMIT = 8;
+const storyboardIndexes = /* @__PURE__ */ new Map();
+function customComplianceInventory(dir) {
+  if (!(0, import_fs.existsSync)(dir)) return "missing";
+  const entries = [];
+  const visitedDirectories = /* @__PURE__ */ new Set();
+  const visit = (file, relative) => {
+    const stat = (0, import_fs.statSync)(file, { bigint: true });
+    entries.push([relative, String(stat.mtimeNs), String(stat.ctimeNs), String(stat.size), String(stat.ino)]);
+    if (!stat.isDirectory()) return;
+    const identity = `${stat.dev}:${stat.ino}`;
+    if (visitedDirectories.has(identity)) return;
+    visitedDirectories.add(identity);
+    for (const child of (0, import_fs.readdirSync)(file).sort()) visit((0, import_path.join)(file, child), `${relative}/${child}`);
+  };
+  visit(dir, "");
+  return JSON.stringify(entries);
+}
+function complianceStoryboardIndex(options) {
+  const dir = (0, import_path.resolve)(getComplianceCacheDir(options));
+  const indexPath = (0, import_path.join)(dir, "index.json");
+  const stamp = (0, import_fs.existsSync)(indexPath) ? (0, import_fs.statSync)(indexPath) : void 0;
+  const schemaRoot = getConfiguredSchemaRoot(options);
+  const customRoot = Boolean(getConfiguredComplianceDir(options));
+  const inventory = customRoot ? customComplianceInventory(dir) : null;
+  const key = JSON.stringify([
+    dir,
+    options.version ?? import_version.ADCP_VERSION,
+    schemaRoot ? (0, import_path.resolve)(schemaRoot) : null,
+    options.hostedStableLineAlias ?? null,
+    stamp?.mtimeMs ?? null,
+    stamp?.size ?? null,
+    inventory
+  ]);
+  const cached = storyboardIndexes.get(key);
+  if (cached) {
+    storyboardIndexes.delete(key);
+    storyboardIndexes.set(key, cached);
+    return cached;
+  }
+  if (customRoot) (0, import_vector_loader.invalidateRequestSigningVectorCache)(dir);
+  const indexed = /* @__PURE__ */ new Map();
+  for (const ref of listBundles({ ...options, complianceDir: dir })) {
+    for (const storyboard of loadBundleStoryboards(ref)) {
+      if (!indexed.has(storyboard.id)) indexed.set(storyboard.id, storyboard);
     }
   }
-  return storyboards;
+  storyboardIndexes.set(key, indexed);
+  while (storyboardIndexes.size > STORYBOARD_INDEX_CACHE_LIMIT) {
+    const oldest = storyboardIndexes.keys().next().value;
+    if (oldest !== void 0) storyboardIndexes.delete(oldest);
+  }
+  return indexed;
+}
+function cloneComplianceStoryboard(storyboard) {
+  const copy = structuredClone(storyboard);
+  const trustedRoot = (0, import_provenance.trustedStoryboardComplianceRoot)(storyboard);
+  return trustedRoot ? (0, import_provenance.markStoryboardComplianceRoot)(copy, trustedRoot) : copy;
+}
+function listAllComplianceStoryboards(options = {}) {
+  return [...complianceStoryboardIndex(options).values()].map(cloneComplianceStoryboard);
 }
 function getComplianceStoryboardById(id, options = {}) {
-  for (const sb of listAllComplianceStoryboards(options)) {
-    if (sb.id === id) return sb;
-  }
-  return void 0;
+  const storyboard = complianceStoryboardIndex(options).get(id);
+  return storyboard ? cloneComplianceStoryboard(storyboard) : void 0;
 }
 function findBundleById(id, options = {}) {
   return listBundles(options).find((b) => b.id === id);

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

@@ -12,7 +12,8 @@ import { ADCPError } from "../../errors/index.mjs";
 import { isAdcpVersionSupported } from "../../utils/adcp-version-config.mjs";
 import { hasSchemaBundle, resolveBundleKey } from "../../validation/schema-loader.mjs";
 import { synthesizeRequestSigningSteps } from "./request-signing/synthesize.mjs";
-import { markStoryboardComplianceRoot } from "./provenance.mjs";
+import { invalidateRequestSigningVectorCache } from "./request-signing/vector-loader.mjs";
+import { markStoryboardComplianceRoot, trustedStoryboardComplianceRoot } from "./provenance.mjs";
 class CapabilityResolutionError extends ADCPError {
   code;
   specialism;
@@ -399,23 +400,71 @@ function listBundles(options = {}) {
   }
   return bundles;
 }
-function listAllComplianceStoryboards(options = {}) {
-  const seen = /* @__PURE__ */ new Set();
-  const storyboards = [];
-  for (const ref of listBundles(options)) {
-    for (const sb of loadBundleStoryboards(ref)) {
-      if (seen.has(sb.id)) continue;
-      seen.add(sb.id);
-      storyboards.push(sb);
+const STORYBOARD_INDEX_CACHE_LIMIT = 8;
+const storyboardIndexes = /* @__PURE__ */ new Map();
+function customComplianceInventory(dir) {
+  if (!existsSync(dir)) return "missing";
+  const entries = [];
+  const visitedDirectories = /* @__PURE__ */ new Set();
+  const visit = (file, relative) => {
+    const stat = statSync(file, { bigint: true });
+    entries.push([relative, String(stat.mtimeNs), String(stat.ctimeNs), String(stat.size), String(stat.ino)]);
+    if (!stat.isDirectory()) return;
+    const identity = `${stat.dev}:${stat.ino}`;
+    if (visitedDirectories.has(identity)) return;
+    visitedDirectories.add(identity);
+    for (const child of readdirSync(file).sort()) visit(join(file, child), `${relative}/${child}`);
+  };
+  visit(dir, "");
+  return JSON.stringify(entries);
+}
+function complianceStoryboardIndex(options) {
+  const dir = resolve(getComplianceCacheDir(options));
+  const indexPath = join(dir, "index.json");
+  const stamp = existsSync(indexPath) ? statSync(indexPath) : void 0;
+  const schemaRoot = getConfiguredSchemaRoot(options);
+  const customRoot = Boolean(getConfiguredComplianceDir(options));
+  const inventory = customRoot ? customComplianceInventory(dir) : null;
+  const key = JSON.stringify([
+    dir,
+    options.version ?? ADCP_VERSION,
+    schemaRoot ? resolve(schemaRoot) : null,
+    options.hostedStableLineAlias ?? null,
+    stamp?.mtimeMs ?? null,
+    stamp?.size ?? null,
+    inventory
+  ]);
+  const cached = storyboardIndexes.get(key);
+  if (cached) {
+    storyboardIndexes.delete(key);
+    storyboardIndexes.set(key, cached);
+    return cached;
+  }
+  if (customRoot) invalidateRequestSigningVectorCache(dir);
+  const indexed = /* @__PURE__ */ new Map();
+  for (const ref of listBundles({ ...options, complianceDir: dir })) {
+    for (const storyboard of loadBundleStoryboards(ref)) {
+      if (!indexed.has(storyboard.id)) indexed.set(storyboard.id, storyboard);
     }
   }
-  return storyboards;
+  storyboardIndexes.set(key, indexed);
+  while (storyboardIndexes.size > STORYBOARD_INDEX_CACHE_LIMIT) {
+    const oldest = storyboardIndexes.keys().next().value;
+    if (oldest !== void 0) storyboardIndexes.delete(oldest);
+  }
+  return indexed;
+}
+function cloneComplianceStoryboard(storyboard) {
+  const copy = structuredClone(storyboard);
+  const trustedRoot = trustedStoryboardComplianceRoot(storyboard);
+  return trustedRoot ? markStoryboardComplianceRoot(copy, trustedRoot) : copy;
+}
+function listAllComplianceStoryboards(options = {}) {
+  return [...complianceStoryboardIndex(options).values()].map(cloneComplianceStoryboard);
 }
 function getComplianceStoryboardById(id, options = {}) {
-  for (const sb of listAllComplianceStoryboards(options)) {
-    if (sb.id === id) return sb;
-  }
-  return void 0;
+  const storyboard = complianceStoryboardIndex(options).get(id);
+  return storyboard ? cloneComplianceStoryboard(storyboard) : void 0;
 }
 function findBundleById(id, options = {}) {
   return listBundles(options).find((b) => b.id === id);

package/dist/lib/testing/storyboard/context.d.mts

@@ -10,12 +10,22 @@
  * (context_outputs/context_inputs) while still enabling stateful flows.
  */
 import type { StoryboardContext, ContextOutput, ContextInput, ContextProvenanceEntry } from './types.mjs';
-type ContextExtractor = (data: unknown) => Record<string, unknown>;
+/**
+ * `adcpVersion` is the release the step was requested at. Media-buy mutation
+ * extractors use it to tell a 3.1+ task-envelope `status` from a 3.0
+ * lifecycle `status` when the response does not echo its version.
+ */
+type ContextExtractor = (data: unknown, adcpVersion?: string) => Record<string, unknown>;
 export declare const CONTEXT_EXTRACTORS: Record<string, ContextExtractor>;
 /**
  * Extract context values from a task response.
+ *
+ * @param adcpVersion - Optional AdCP release the request was sent at. Used
+ *   only when the response does not echo `adcp_version`, to read a
+ *   create/update top-level `status` as the 3.1+ task status rather than a
+ *   3.0 media-buy lifecycle.
  */
-export declare function extractContext(taskName: string, data: unknown): Record<string, unknown>;
+export declare function extractContext(taskName: string, data: unknown, adcpVersion?: string): Record<string, unknown>;
 /**
  * Propagate the alias cache from one context to another — call after
  * shallow-cloning context between storyboard steps so replay tests
@@ -132,7 +142,7 @@ export interface ContextWriteResult {
  * tagging it as a convention-based extraction. `response_path` is absent
  * for convention extractors — they're hardcoded functions, not YAML paths.
  */
-export declare function extractContextWithProvenance(taskName: string, data: unknown, stepId: string): ContextWriteResult;
+export declare function extractContextWithProvenance(taskName: string, data: unknown, stepId: string, adcpVersion?: string): ContextWriteResult;
 /**
  * Like `applyContextOutputs`, but also returns provenance for each written
  * key carrying the YAML `response_path` so diagnostics can cite it verbatim.

package/dist/lib/testing/storyboard/context.d.ts

@@ -10,12 +10,22 @@
  * (context_outputs/context_inputs) while still enabling stateful flows.
  */
 import type { StoryboardContext, ContextOutput, ContextInput, ContextProvenanceEntry } from './types';
-type ContextExtractor = (data: unknown) => Record<string, unknown>;
+/**
+ * `adcpVersion` is the release the step was requested at. Media-buy mutation
+ * extractors use it to tell a 3.1+ task-envelope `status` from a 3.0
+ * lifecycle `status` when the response does not echo its version.
+ */
+type ContextExtractor = (data: unknown, adcpVersion?: string) => Record<string, unknown>;
 export declare const CONTEXT_EXTRACTORS: Record<string, ContextExtractor>;
 /**
  * Extract context values from a task response.
+ *
+ * @param adcpVersion - Optional AdCP release the request was sent at. Used
+ *   only when the response does not echo `adcp_version`, to read a
+ *   create/update top-level `status` as the 3.1+ task status rather than a
+ *   3.0 media-buy lifecycle.
  */
-export declare function extractContext(taskName: string, data: unknown): Record<string, unknown>;
+export declare function extractContext(taskName: string, data: unknown, adcpVersion?: string): Record<string, unknown>;
 /**
  * Propagate the alias cache from one context to another — call after
  * shallow-cloning context between storyboard steps so replay tests
@@ -132,7 +142,7 @@ export interface ContextWriteResult {
  * tagging it as a convention-based extraction. `response_path` is absent
  * for convention extractors — they're hardcoded functions, not YAML paths.
  */
-export declare function extractContextWithProvenance(taskName: string, data: unknown, stepId: string): ContextWriteResult;
+export declare function extractContextWithProvenance(taskName: string, data: unknown, stepId: string, adcpVersion?: string): ContextWriteResult;
 /**
  * Like `applyContextOutputs`, but also returns provenance for each written
  * key carrying the YAML `response_path` so diagnostics can cite it verbatim.