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

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

@@ -732,6 +732,7 @@ async function complyImpl(agentUrl, options) {
     storyboards: explicitStoryboards,
     tracks: trackFilter,
     timeout_ms,
+    storyboard_start_offset,
     signal: externalSignal,
     webhook_receiver,
     webhook_replay_receiver,
@@ -758,6 +759,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}`);
+    }
+  }
   validateTestKit(testOptions.test_kit);
   const signal = externalSignal;
   return await withExternalSchemaRoot(complianceIndex.adcp_version, scopedSchemaRoot, async () => {
@@ -892,6 +898,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 = {
@@ -921,7 +930,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]) {
@@ -1028,7 +1042,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",
@@ -1037,7 +1057,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" }
   };
@@ -1532,6 +1555,7 @@ export {
   extractFailures,
   formatComplianceResults,
   formatComplianceResultsJSON,
-  partitionStoryboardsByRequiredTools
+  partitionStoryboardsByRequiredTools,
+  rotateStoryboardsForOffset
 };
 //# sourceMappingURL=comply.mjs.map