@riddledc/riddle-proof 0.7.139 → 0.7.140

package/README.md

@@ -486,7 +486,9 @@ Profile final viewport screenshots are full-page by default. Set
 `target.screenshot_full_page: false`, `target.screenshotFullPage: false`, or
 `target.screenshot_mode: "viewport"` when the automatic final screenshots
 should capture only the current viewport, for example when fixed or sticky
-headers make full-page captures misleading.
+headers make full-page captures misleading. Compact profile summaries include
+the final screenshot count and mode when a profile sets an explicit target
+screenshot mode.
 
 Use `allowed_console_patterns` / `allowed_console_texts` on
 `no_fatal_console_errors` when a negative-path profile intentionally triggers a

package/dist/{chunk-DB6J53V5.js → chunk-6VXZ6V5M.js}

@@ -494,12 +494,18 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount, expectedActionCountByViewport) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountByViewport, finalScreenshotFullPage) {
+  const normalizedFinalScreenshotFullPage = finalScreenshotFullPage === void 0 ? void 0 : finalScreenshotFullPage !== false;
+  const finalScreenshotCount = viewports.filter((viewport) => typeof viewport.screenshot_label === "string" && viewport.screenshot_label.trim()).length;
   return toJsonValue({
     viewport_count: viewports.length,
     action_count: actionCount ?? null,
+    final_screenshot_count: finalScreenshotCount,
+    final_screenshot_full_page: normalizedFinalScreenshotFullPage ?? null,
+    final_screenshot_mode: normalizedFinalScreenshotFullPage === void 0 ? null : normalizedFinalScreenshotFullPage ? "full_page" : "viewport",
     viewports: viewports.map((viewport) => {
       const expectedActionCount = expectedActionCountByViewport?.get(viewport.name) ?? actionCount;
+      const viewportFinalScreenshotFullPage = typeof viewport.screenshot_full_page === "boolean" ? viewport.screenshot_full_page : normalizedFinalScreenshotFullPage;
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result.ok === false && result.optional !== true);
       const optionalFailed = results.filter((result) => result.ok === false && result.optional === true);
@@ -539,6 +545,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         action_counts: profileSetupActionCounts(results),
         frame_action_count: results.filter((result) => result.frame_selector).length,
         frame_urls: profileSetupFrameUrls(viewport),
+        final_screenshot: viewport.screenshot_label ?? null,
+        final_screenshot_full_page: viewportFinalScreenshotFullPage ?? null,
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
@@ -2783,7 +2791,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
         ok: (viewport.setup_action_results || []).length >= (expectedActionCountByViewport.get(viewport.name) ?? actionCount) && (viewport.setup_action_results || []).every((result) => result.ok !== false || result.optional === true),
         result_count: (viewport.setup_action_results || []).length
       })),
-      setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport),
+      setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport, profile.target.screenshot_full_page),
       failed
     },
     message: failed.length ? `Setup actions failed in ${failed.length} viewport action(s).` : void 0
@@ -3803,14 +3811,28 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport, finalScreenshotFullPage) {
+  const normalizedFinalScreenshotFullPage = finalScreenshotFullPage === undefined
+    ? undefined
+    : finalScreenshotFullPage !== false;
+  const finalScreenshotCount = (viewports || []).filter((viewport) => viewport && typeof viewport.screenshot_label === "string" && viewport.screenshot_label.trim()).length;
   return {
     viewport_count: (viewports || []).length,
     action_count: actionCount ?? null,
+    final_screenshot_count: finalScreenshotCount,
+    final_screenshot_full_page: normalizedFinalScreenshotFullPage ?? null,
+    final_screenshot_mode: normalizedFinalScreenshotFullPage === undefined
+      ? null
+      : normalizedFinalScreenshotFullPage
+        ? "full_page"
+        : "viewport",
     viewports: (viewports || []).map((viewport) => {
       const expectedActionCount = expectedActionCountsByViewport && expectedActionCountsByViewport[viewport.name] !== undefined
         ? expectedActionCountsByViewport[viewport.name]
         : actionCount;
+      const viewportFinalScreenshotFullPage = typeof viewport.screenshot_full_page === "boolean"
+        ? viewport.screenshot_full_page
+        : normalizedFinalScreenshotFullPage;
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result && result.ok === false && result.optional !== true);
       const optionalFailed = results.filter((result) => result && result.ok === false && result.optional === true);
@@ -3864,6 +3886,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         action_counts: profileSetupActionCounts(results),
         frame_action_count: results.filter((result) => result && result.frame_selector).length,
         frame_urls: profileSetupFrameUrls(viewport),
+        final_screenshot: viewport.screenshot_label || null,
+        final_screenshot_full_page: viewportFinalScreenshotFullPage ?? null,
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
@@ -4048,7 +4072,7 @@ function assessProfile(profile, evidence) {
             && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false || result.optional === true),
           result_count: (viewport.setup_action_results || []).length,
         })),
-        setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport),
+        setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport, profile.target && profile.target.screenshot_full_page),
         failed,
       },
       message: failed.length ? "Setup actions failed in " + failed.length + " viewport action(s)." : undefined,
@@ -6926,9 +6950,13 @@ async function captureViewport(viewport) {
     }
   }
   const screenshotLabel = profileSlug + "-" + viewport.name;
+  let screenshotFullPage = null;
   try {
     const screenshotOptions = {};
-    if (profile.target && profile.target.screenshot_full_page !== undefined) screenshotOptions.fullPage = profile.target.screenshot_full_page !== false;
+    if (profile.target && profile.target.screenshot_full_page !== undefined) {
+      screenshotFullPage = profile.target.screenshot_full_page !== false;
+      screenshotOptions.fullPage = screenshotFullPage;
+    }
     if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel, screenshotOptions);
   } catch (error) {
     pageErrors.push({ message: "saveScreenshot failed: " + String(error && error.message ? error.message : error).slice(0, 500) });
@@ -6996,6 +7024,7 @@ async function captureViewport(viewport) {
     route_inventory: routeInventory,
     setup_action_results: setupActionResults,
     screenshot_label: screenshotLabel,
+    screenshot_full_page: screenshotFullPage,
     navigation_error: navigationError,
     wait_error: waitError,
   };

package/dist/cli.cjs

@@ -7431,12 +7431,18 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount, expectedActionCountByViewport) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountByViewport, finalScreenshotFullPage) {
+  const normalizedFinalScreenshotFullPage = finalScreenshotFullPage === void 0 ? void 0 : finalScreenshotFullPage !== false;
+  const finalScreenshotCount = viewports.filter((viewport) => typeof viewport.screenshot_label === "string" && viewport.screenshot_label.trim()).length;
   return toJsonValue({
     viewport_count: viewports.length,
     action_count: actionCount ?? null,
+    final_screenshot_count: finalScreenshotCount,
+    final_screenshot_full_page: normalizedFinalScreenshotFullPage ?? null,
+    final_screenshot_mode: normalizedFinalScreenshotFullPage === void 0 ? null : normalizedFinalScreenshotFullPage ? "full_page" : "viewport",
     viewports: viewports.map((viewport) => {
       const expectedActionCount = expectedActionCountByViewport?.get(viewport.name) ?? actionCount;
+      const viewportFinalScreenshotFullPage = typeof viewport.screenshot_full_page === "boolean" ? viewport.screenshot_full_page : normalizedFinalScreenshotFullPage;
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result.ok === false && result.optional !== true);
       const optionalFailed = results.filter((result) => result.ok === false && result.optional === true);
@@ -7476,6 +7482,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         action_counts: profileSetupActionCounts(results),
         frame_action_count: results.filter((result) => result.frame_selector).length,
         frame_urls: profileSetupFrameUrls(viewport),
+        final_screenshot: viewport.screenshot_label ?? null,
+        final_screenshot_full_page: viewportFinalScreenshotFullPage ?? null,
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
@@ -9720,7 +9728,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
         ok: (viewport.setup_action_results || []).length >= (expectedActionCountByViewport.get(viewport.name) ?? actionCount) && (viewport.setup_action_results || []).every((result) => result.ok !== false || result.optional === true),
         result_count: (viewport.setup_action_results || []).length
       })),
-      setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport),
+      setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport, profile.target.screenshot_full_page),
       failed
     },
     message: failed.length ? `Setup actions failed in ${failed.length} viewport action(s).` : void 0
@@ -10724,14 +10732,28 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport, finalScreenshotFullPage) {
+  const normalizedFinalScreenshotFullPage = finalScreenshotFullPage === undefined
+    ? undefined
+    : finalScreenshotFullPage !== false;
+  const finalScreenshotCount = (viewports || []).filter((viewport) => viewport && typeof viewport.screenshot_label === "string" && viewport.screenshot_label.trim()).length;
   return {
     viewport_count: (viewports || []).length,
     action_count: actionCount ?? null,
+    final_screenshot_count: finalScreenshotCount,
+    final_screenshot_full_page: normalizedFinalScreenshotFullPage ?? null,
+    final_screenshot_mode: normalizedFinalScreenshotFullPage === undefined
+      ? null
+      : normalizedFinalScreenshotFullPage
+        ? "full_page"
+        : "viewport",
     viewports: (viewports || []).map((viewport) => {
       const expectedActionCount = expectedActionCountsByViewport && expectedActionCountsByViewport[viewport.name] !== undefined
         ? expectedActionCountsByViewport[viewport.name]
         : actionCount;
+      const viewportFinalScreenshotFullPage = typeof viewport.screenshot_full_page === "boolean"
+        ? viewport.screenshot_full_page
+        : normalizedFinalScreenshotFullPage;
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result && result.ok === false && result.optional !== true);
       const optionalFailed = results.filter((result) => result && result.ok === false && result.optional === true);
@@ -10785,6 +10807,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         action_counts: profileSetupActionCounts(results),
         frame_action_count: results.filter((result) => result && result.frame_selector).length,
         frame_urls: profileSetupFrameUrls(viewport),
+        final_screenshot: viewport.screenshot_label || null,
+        final_screenshot_full_page: viewportFinalScreenshotFullPage ?? null,
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
@@ -10969,7 +10993,7 @@ function assessProfile(profile, evidence) {
             && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false || result.optional === true),
           result_count: (viewport.setup_action_results || []).length,
         })),
-        setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport),
+        setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport, profile.target && profile.target.screenshot_full_page),
         failed,
       },
       message: failed.length ? "Setup actions failed in " + failed.length + " viewport action(s)." : undefined,
@@ -13847,9 +13871,13 @@ async function captureViewport(viewport) {
     }
   }
   const screenshotLabel = profileSlug + "-" + viewport.name;
+  let screenshotFullPage = null;
   try {
     const screenshotOptions = {};
-    if (profile.target && profile.target.screenshot_full_page !== undefined) screenshotOptions.fullPage = profile.target.screenshot_full_page !== false;
+    if (profile.target && profile.target.screenshot_full_page !== undefined) {
+      screenshotFullPage = profile.target.screenshot_full_page !== false;
+      screenshotOptions.fullPage = screenshotFullPage;
+    }
     if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel, screenshotOptions);
   } catch (error) {
     pageErrors.push({ message: "saveScreenshot failed: " + String(error && error.message ? error.message : error).slice(0, 500) });
@@ -13917,6 +13945,7 @@ async function captureViewport(viewport) {
     route_inventory: routeInventory,
     setup_action_results: setupActionResults,
     screenshot_label: screenshotLabel,
+    screenshot_full_page: screenshotFullPage,
     navigation_error: navigationError,
     wait_error: waitError,
   };
@@ -14673,6 +14702,8 @@ function profileSetupSummaryMarkdown(result) {
   if (!viewports.length) return [];
   const declaredActions = cliFiniteNumber(setupSummary.action_count);
   const totalResults = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.result_count) || 0), 0);
+  const finalScreenshotCount = cliFiniteNumber(setupSummary.final_screenshot_count) ?? viewports.reduce((sum, viewport) => sum + (cliString(viewport.final_screenshot) || cliString(viewport.screenshot_label) ? 1 : 0), 0);
+  const finalScreenshotMode = cliString(setupSummary.final_screenshot_mode);
   const setupScreenshots = viewports.reduce((sum, viewport) => {
     const labels = Array.isArray(viewport.setup_screenshots) ? viewport.setup_screenshots : [];
     return sum + labels.filter((label) => typeof label === "string" && label.trim()).length;
@@ -14688,6 +14719,7 @@ function profileSetupSummaryMarkdown(result) {
   const failedTotal = viewports.reduce((sum, viewport) => sum + (Array.isArray(viewport.failed) ? viewport.failed.length : 0), 0);
   const lines = [
     `- setup actions: ${declaredActions === void 0 ? "unknown" : declaredActions} declared, ${totalResults} recorded result(s) across ${viewports.length} viewport(s)`,
+    ...finalScreenshotMode ? [`- final screenshots: ${finalScreenshotCount}, mode ${finalScreenshotMode}`] : [],
     `- setup screenshots: ${setupScreenshots}`,
     `- clicked targets: ${clickedTotal}${failedTotal ? `; failed setup actions: ${failedTotal}` : ""}`
   ];

package/dist/cli.js

@@ -12,7 +12,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-DB6J53V5.js";
+} from "./chunk-6VXZ6V5M.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport
@@ -589,6 +589,8 @@ function profileSetupSummaryMarkdown(result) {
   if (!viewports.length) return [];
   const declaredActions = cliFiniteNumber(setupSummary.action_count);
   const totalResults = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.result_count) || 0), 0);
+  const finalScreenshotCount = cliFiniteNumber(setupSummary.final_screenshot_count) ?? viewports.reduce((sum, viewport) => sum + (cliString(viewport.final_screenshot) || cliString(viewport.screenshot_label) ? 1 : 0), 0);
+  const finalScreenshotMode = cliString(setupSummary.final_screenshot_mode);
   const setupScreenshots = viewports.reduce((sum, viewport) => {
     const labels = Array.isArray(viewport.setup_screenshots) ? viewport.setup_screenshots : [];
     return sum + labels.filter((label) => typeof label === "string" && label.trim()).length;
@@ -604,6 +606,7 @@ function profileSetupSummaryMarkdown(result) {
   const failedTotal = viewports.reduce((sum, viewport) => sum + (Array.isArray(viewport.failed) ? viewport.failed.length : 0), 0);
   const lines = [
     `- setup actions: ${declaredActions === void 0 ? "unknown" : declaredActions} declared, ${totalResults} recorded result(s) across ${viewports.length} viewport(s)`,
+    ...finalScreenshotMode ? [`- final screenshots: ${finalScreenshotCount}, mode ${finalScreenshotMode}`] : [],
     `- setup screenshots: ${setupScreenshots}`,
     `- clicked targets: ${clickedTotal}${failedTotal ? `; failed setup actions: ${failedTotal}` : ""}`
   ];

package/dist/index.cjs

@@ -9227,12 +9227,18 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount, expectedActionCountByViewport) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountByViewport, finalScreenshotFullPage) {
+  const normalizedFinalScreenshotFullPage = finalScreenshotFullPage === void 0 ? void 0 : finalScreenshotFullPage !== false;
+  const finalScreenshotCount = viewports.filter((viewport) => typeof viewport.screenshot_label === "string" && viewport.screenshot_label.trim()).length;
   return toJsonValue({
     viewport_count: viewports.length,
     action_count: actionCount ?? null,
+    final_screenshot_count: finalScreenshotCount,
+    final_screenshot_full_page: normalizedFinalScreenshotFullPage ?? null,
+    final_screenshot_mode: normalizedFinalScreenshotFullPage === void 0 ? null : normalizedFinalScreenshotFullPage ? "full_page" : "viewport",
     viewports: viewports.map((viewport) => {
       const expectedActionCount = expectedActionCountByViewport?.get(viewport.name) ?? actionCount;
+      const viewportFinalScreenshotFullPage = typeof viewport.screenshot_full_page === "boolean" ? viewport.screenshot_full_page : normalizedFinalScreenshotFullPage;
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result.ok === false && result.optional !== true);
       const optionalFailed = results.filter((result) => result.ok === false && result.optional === true);
@@ -9272,6 +9278,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         action_counts: profileSetupActionCounts(results),
         frame_action_count: results.filter((result) => result.frame_selector).length,
         frame_urls: profileSetupFrameUrls(viewport),
+        final_screenshot: viewport.screenshot_label ?? null,
+        final_screenshot_full_page: viewportFinalScreenshotFullPage ?? null,
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
@@ -11516,7 +11524,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
         ok: (viewport.setup_action_results || []).length >= (expectedActionCountByViewport.get(viewport.name) ?? actionCount) && (viewport.setup_action_results || []).every((result) => result.ok !== false || result.optional === true),
         result_count: (viewport.setup_action_results || []).length
       })),
-      setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport),
+      setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport, profile.target.screenshot_full_page),
       failed
     },
     message: failed.length ? `Setup actions failed in ${failed.length} viewport action(s).` : void 0
@@ -12536,14 +12544,28 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport, finalScreenshotFullPage) {
+  const normalizedFinalScreenshotFullPage = finalScreenshotFullPage === undefined
+    ? undefined
+    : finalScreenshotFullPage !== false;
+  const finalScreenshotCount = (viewports || []).filter((viewport) => viewport && typeof viewport.screenshot_label === "string" && viewport.screenshot_label.trim()).length;
   return {
     viewport_count: (viewports || []).length,
     action_count: actionCount ?? null,
+    final_screenshot_count: finalScreenshotCount,
+    final_screenshot_full_page: normalizedFinalScreenshotFullPage ?? null,
+    final_screenshot_mode: normalizedFinalScreenshotFullPage === undefined
+      ? null
+      : normalizedFinalScreenshotFullPage
+        ? "full_page"
+        : "viewport",
     viewports: (viewports || []).map((viewport) => {
       const expectedActionCount = expectedActionCountsByViewport && expectedActionCountsByViewport[viewport.name] !== undefined
         ? expectedActionCountsByViewport[viewport.name]
         : actionCount;
+      const viewportFinalScreenshotFullPage = typeof viewport.screenshot_full_page === "boolean"
+        ? viewport.screenshot_full_page
+        : normalizedFinalScreenshotFullPage;
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result && result.ok === false && result.optional !== true);
       const optionalFailed = results.filter((result) => result && result.ok === false && result.optional === true);
@@ -12597,6 +12619,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         action_counts: profileSetupActionCounts(results),
         frame_action_count: results.filter((result) => result && result.frame_selector).length,
         frame_urls: profileSetupFrameUrls(viewport),
+        final_screenshot: viewport.screenshot_label || null,
+        final_screenshot_full_page: viewportFinalScreenshotFullPage ?? null,
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
@@ -12781,7 +12805,7 @@ function assessProfile(profile, evidence) {
             && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false || result.optional === true),
           result_count: (viewport.setup_action_results || []).length,
         })),
-        setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport),
+        setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport, profile.target && profile.target.screenshot_full_page),
         failed,
       },
       message: failed.length ? "Setup actions failed in " + failed.length + " viewport action(s)." : undefined,
@@ -15659,9 +15683,13 @@ async function captureViewport(viewport) {
     }
   }
   const screenshotLabel = profileSlug + "-" + viewport.name;
+  let screenshotFullPage = null;
   try {
     const screenshotOptions = {};
-    if (profile.target && profile.target.screenshot_full_page !== undefined) screenshotOptions.fullPage = profile.target.screenshot_full_page !== false;
+    if (profile.target && profile.target.screenshot_full_page !== undefined) {
+      screenshotFullPage = profile.target.screenshot_full_page !== false;
+      screenshotOptions.fullPage = screenshotFullPage;
+    }
     if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel, screenshotOptions);
   } catch (error) {
     pageErrors.push({ message: "saveScreenshot failed: " + String(error && error.message ? error.message : error).slice(0, 500) });
@@ -15729,6 +15757,7 @@ async function captureViewport(viewport) {
     route_inventory: routeInventory,
     setup_action_results: setupActionResults,
     screenshot_label: screenshotLabel,
+    screenshot_full_page: screenshotFullPage,
     navigation_error: navigationError,
     wait_error: waitError,
   };

package/dist/index.js

@@ -62,7 +62,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-DB6J53V5.js";
+} from "./chunk-6VXZ6V5M.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -541,12 +541,18 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount, expectedActionCountByViewport) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountByViewport, finalScreenshotFullPage) {
+  const normalizedFinalScreenshotFullPage = finalScreenshotFullPage === void 0 ? void 0 : finalScreenshotFullPage !== false;
+  const finalScreenshotCount = viewports.filter((viewport) => typeof viewport.screenshot_label === "string" && viewport.screenshot_label.trim()).length;
   return toJsonValue({
     viewport_count: viewports.length,
     action_count: actionCount ?? null,
+    final_screenshot_count: finalScreenshotCount,
+    final_screenshot_full_page: normalizedFinalScreenshotFullPage ?? null,
+    final_screenshot_mode: normalizedFinalScreenshotFullPage === void 0 ? null : normalizedFinalScreenshotFullPage ? "full_page" : "viewport",
     viewports: viewports.map((viewport) => {
       const expectedActionCount = expectedActionCountByViewport?.get(viewport.name) ?? actionCount;
+      const viewportFinalScreenshotFullPage = typeof viewport.screenshot_full_page === "boolean" ? viewport.screenshot_full_page : normalizedFinalScreenshotFullPage;
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result.ok === false && result.optional !== true);
       const optionalFailed = results.filter((result) => result.ok === false && result.optional === true);
@@ -586,6 +592,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         action_counts: profileSetupActionCounts(results),
         frame_action_count: results.filter((result) => result.frame_selector).length,
         frame_urls: profileSetupFrameUrls(viewport),
+        final_screenshot: viewport.screenshot_label ?? null,
+        final_screenshot_full_page: viewportFinalScreenshotFullPage ?? null,
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
@@ -2830,7 +2838,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
         ok: (viewport.setup_action_results || []).length >= (expectedActionCountByViewport.get(viewport.name) ?? actionCount) && (viewport.setup_action_results || []).every((result) => result.ok !== false || result.optional === true),
         result_count: (viewport.setup_action_results || []).length
       })),
-      setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport),
+      setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport, profile.target.screenshot_full_page),
       failed
     },
     message: failed.length ? `Setup actions failed in ${failed.length} viewport action(s).` : void 0
@@ -3850,14 +3858,28 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport, finalScreenshotFullPage) {
+  const normalizedFinalScreenshotFullPage = finalScreenshotFullPage === undefined
+    ? undefined
+    : finalScreenshotFullPage !== false;
+  const finalScreenshotCount = (viewports || []).filter((viewport) => viewport && typeof viewport.screenshot_label === "string" && viewport.screenshot_label.trim()).length;
   return {
     viewport_count: (viewports || []).length,
     action_count: actionCount ?? null,
+    final_screenshot_count: finalScreenshotCount,
+    final_screenshot_full_page: normalizedFinalScreenshotFullPage ?? null,
+    final_screenshot_mode: normalizedFinalScreenshotFullPage === undefined
+      ? null
+      : normalizedFinalScreenshotFullPage
+        ? "full_page"
+        : "viewport",
     viewports: (viewports || []).map((viewport) => {
       const expectedActionCount = expectedActionCountsByViewport && expectedActionCountsByViewport[viewport.name] !== undefined
         ? expectedActionCountsByViewport[viewport.name]
         : actionCount;
+      const viewportFinalScreenshotFullPage = typeof viewport.screenshot_full_page === "boolean"
+        ? viewport.screenshot_full_page
+        : normalizedFinalScreenshotFullPage;
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result && result.ok === false && result.optional !== true);
       const optionalFailed = results.filter((result) => result && result.ok === false && result.optional === true);
@@ -3911,6 +3933,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         action_counts: profileSetupActionCounts(results),
         frame_action_count: results.filter((result) => result && result.frame_selector).length,
         frame_urls: profileSetupFrameUrls(viewport),
+        final_screenshot: viewport.screenshot_label || null,
+        final_screenshot_full_page: viewportFinalScreenshotFullPage ?? null,
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
@@ -4095,7 +4119,7 @@ function assessProfile(profile, evidence) {
             && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false || result.optional === true),
           result_count: (viewport.setup_action_results || []).length,
         })),
-        setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport),
+        setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport, profile.target && profile.target.screenshot_full_page),
         failed,
       },
       message: failed.length ? "Setup actions failed in " + failed.length + " viewport action(s)." : undefined,
@@ -6973,9 +6997,13 @@ async function captureViewport(viewport) {
     }
   }
   const screenshotLabel = profileSlug + "-" + viewport.name;
+  let screenshotFullPage = null;
   try {
     const screenshotOptions = {};
-    if (profile.target && profile.target.screenshot_full_page !== undefined) screenshotOptions.fullPage = profile.target.screenshot_full_page !== false;
+    if (profile.target && profile.target.screenshot_full_page !== undefined) {
+      screenshotFullPage = profile.target.screenshot_full_page !== false;
+      screenshotOptions.fullPage = screenshotFullPage;
+    }
     if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel, screenshotOptions);
   } catch (error) {
     pageErrors.push({ message: "saveScreenshot failed: " + String(error && error.message ? error.message : error).slice(0, 500) });
@@ -7043,6 +7071,7 @@ async function captureViewport(viewport) {
     route_inventory: routeInventory,
     setup_action_results: setupActionResults,
     screenshot_label: screenshotLabel,
+    screenshot_full_page: screenshotFullPage,
     navigation_error: navigationError,
     wait_error: waitError,
   };

package/dist/profile.d.cts

@@ -323,6 +323,7 @@ interface RiddleProofProfileViewportEvidence {
     route_inventory?: Record<string, JsonValue>;
     setup_action_results?: Array<Record<string, JsonValue>>;
     screenshot_label?: string;
+    screenshot_full_page?: boolean | null;
     navigation_error?: string;
     wait_error?: string;
 }

package/dist/profile.d.ts

@@ -323,6 +323,7 @@ interface RiddleProofProfileViewportEvidence {
     route_inventory?: Record<string, JsonValue>;
     setup_action_results?: Array<Record<string, JsonValue>>;
     screenshot_label?: string;
+    screenshot_full_page?: boolean | null;
     navigation_error?: string;
     wait_error?: string;
 }

package/dist/profile.js

@@ -23,7 +23,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-DB6J53V5.js";
+} from "./chunk-6VXZ6V5M.js";
 export {
   RIDDLE_PROOF_PROFILE_CHECK_TYPES,
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riddledc/riddle-proof",
-  "version": "0.7.139",
+  "version": "0.7.140",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",