@adcp/sdk 14.0.0-beta.8 → 14.0.0-beta.9

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

@@ -36,7 +36,8 @@ __export(comply_exports, {
   extractFailures: () => extractFailures,
   formatComplianceResults: () => formatComplianceResults,
   formatComplianceResultsJSON: () => formatComplianceResultsJSON,
-  partitionStoryboardsByRequiredTools: () => partitionStoryboardsByRequiredTools
+  partitionStoryboardsByRequiredTools: () => partitionStoryboardsByRequiredTools,
+  rotateStoryboardsForOffset: () => rotateStoryboardsForOffset
 });
 module.exports = __toCommonJS(comply_exports);
 var import_client = require('../client.js');
@@ -766,6 +767,7 @@ async function complyImpl(agentUrl, options) {
     storyboards: explicitStoryboards,
     tracks: trackFilter,
     timeout_ms,
+    storyboard_start_offset,
     signal: externalSignal,
     webhook_receiver,
     webhook_replay_receiver,
@@ -792,6 +794,11 @@ async function complyImpl(agentUrl, options) {
       throw new TypeError(`timeout_ms must be a positive finite number, got: ${timeout_ms}`);
     }
   }
+  if (storyboard_start_offset !== void 0) {
+    if (typeof storyboard_start_offset !== "number" || !Number.isInteger(storyboard_start_offset) || storyboard_start_offset < 0) {
+      throw new TypeError(`storyboard_start_offset must be a non-negative integer, got: ${storyboard_start_offset}`);
+    }
+  }
   (0, import_test_kit.validateTestKit)(testOptions.test_kit);
   const signal = externalSignal;
   return await (0, import_schema_loader.withExternalSchemaRoot)(complianceIndex.adcp_version, scopedSchemaRoot, async () => {
@@ -926,6 +933,9 @@ async function complyImpl(agentUrl, options) {
       runnableStoryboards = applicability.runnable;
       missingToolStoryboards.push(...applicability.missing);
     }
+    if (storyboard_start_offset !== void 0 && storyboard_start_offset > 0) {
+      runnableStoryboards = rotateStoryboardsForOffset(runnableStoryboards, storyboard_start_offset);
+    }
     const storyboardResults = [];
     const executedStoryboards = [];
     const runOptions = {
@@ -955,7 +965,12 @@ async function complyImpl(agentUrl, options) {
     }
     if (stoppedForTimeoutBudget) {
       allObservations.push(
-        buildComplyTimeoutBudgetObservation(timeout_ms, storyboardResults.length, runnableStoryboards.length)
+        buildComplyTimeoutBudgetObservation(
+          timeout_ms,
+          storyboardResults.length,
+          runnableStoryboards.length,
+          runnableStoryboards.slice(storyboardResults.length).map((sb) => sb.id)
+        )
       );
     }
     for (const na of [...notApplicable, ...missingToolStoryboards]) {
@@ -1062,7 +1077,13 @@ async function complyImpl(agentUrl, options) {
 function hasComplyTimeoutBudgetExpired(start, timeout_ms, now = Date.now()) {
   return timeout_ms !== void 0 && now - start >= timeout_ms;
 }
-function buildComplyTimeoutBudgetObservation(timeout_ms, storyboardsExecuted, storyboardsSelected) {
+function rotateStoryboardsForOffset(items, offset) {
+  if (items.length === 0) return [...items];
+  const shift = offset % items.length;
+  if (shift === 0) return [...items];
+  return [...items.slice(shift), ...items.slice(0, shift)];
+}
+function buildComplyTimeoutBudgetObservation(timeout_ms, storyboardsExecuted, storyboardsSelected, storyboardsNotStarted = []) {
   return {
     category: "performance",
     severity: "warning",
@@ -1071,7 +1092,10 @@ function buildComplyTimeoutBudgetObservation(timeout_ms, storyboardsExecuted, st
       timeout_ms,
       storyboards_executed: storyboardsExecuted,
       storyboards_selected: storyboardsSelected,
-      storyboards_remaining: Math.max(0, storyboardsSelected - storyboardsExecuted)
+      storyboards_remaining: Math.max(0, storyboardsSelected - storyboardsExecuted),
+      // Which storyboards never started — so budget-limited coverage gaps
+      // are inspectable per-run instead of only countable (adcp#6632).
+      storyboards_not_started: [...storyboardsNotStarted]
     },
     source: { kind: "profile", code: "timeout-budget-exceeded" }
   };
@@ -1567,6 +1591,7 @@ function formatMachineValue(value) {
   extractFailures,
   formatComplianceResults,
   formatComplianceResultsJSON,
-  partitionStoryboardsByRequiredTools
+  partitionStoryboardsByRequiredTools,
+  rotateStoryboardsForOffset
 });
 //# sourceMappingURL=comply.js.map