@riddledc/riddle-proof 0.7.158 → 0.7.160

package/dist/cli.cjs

@@ -7006,6 +7006,7 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "fill",
   "set_input_value",
   "set_range_value",
+  "canvas_signature",
   "assert_text_visible",
   "assert_text_absent",
   "assert_selector_count",
@@ -7507,6 +7508,26 @@ function profileSetupRangeValueReceipts(results) {
     reason: result.reason ?? result.error ?? null
   }));
 }
+function profileSetupCanvasSignatureReceipts(results) {
+  return results.filter((result) => profileSetupResultAction(result) === "canvas_signature").map((result) => ({
+    ordinal: result.ordinal ?? null,
+    ok: result.ok !== false,
+    selector: result.selector ?? null,
+    frame_selector: result.frame_selector ?? null,
+    label: result.label ?? null,
+    hash: result.hash ?? null,
+    data_length: result.data_length ?? null,
+    width: result.width ?? null,
+    height: result.height ?? null,
+    css_width: result.css_width ?? null,
+    css_height: result.css_height ?? null,
+    compare_to: result.compare_to ?? null,
+    previous_hash: result.previous_hash ?? null,
+    changed: result.changed ?? null,
+    return_stored_to: result.return_stored_to ?? null,
+    reason: result.reason ?? result.error ?? null
+  }));
+}
 function sampleProfileSetupSummaryItems(items, limit) {
   if (items.length <= limit) return items;
   const firstCount = Math.floor(limit / 2);
@@ -7551,6 +7572,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
       const sampledWindowEvalReceipts = sampleProfileSetupSummaryItems(windowEvalReceipts, 8);
       const rangeValueReceipts = profileSetupRangeValueReceipts(results);
       const sampledRangeValueReceipts = sampleProfileSetupSummaryItems(rangeValueReceipts, 8);
+      const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
+      const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
         const clickCount = typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : void 0;
         return {
@@ -7602,6 +7625,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         set_range_value_total: rangeValueReceipts.length,
         set_range_value_truncated: rangeValueReceipts.length > sampledRangeValueReceipts.length,
         set_range_value: sampledRangeValueReceipts,
+        canvas_signature_total: canvasSignatureReceipts.length,
+        canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
+        canvas_signature: sampledCanvasSignatureReceipts,
         clicked,
         text_samples,
         failed: failed.map((result) => ({
@@ -7654,7 +7680,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -7783,7 +7809,7 @@ function normalizeSetupAction(input, index) {
   if (frameIndex !== void 0 && (!Number.isInteger(frameIndex) || frameIndex < 0)) {
     throw new Error(`target.setup_actions[${index}].frame_index must be a non-negative integer.`);
   }
-  if ((type === "click" || type === "drag" || type === "fill" || type === "set_input_value" || type === "set_range_value" || type === "wait_for_selector" || type === "wait_for_text" || type === "assert_text_visible" || type === "assert_text_absent" || type === "assert_selector_count") && !selector) {
+  if ((type === "click" || type === "drag" || type === "fill" || type === "set_input_value" || type === "set_range_value" || type === "canvas_signature" || type === "wait_for_selector" || type === "wait_for_text" || type === "assert_text_visible" || type === "assert_text_absent" || type === "assert_selector_count") && !selector) {
     throw new Error(`target.setup_actions[${index}] ${type} requires selector.`);
   }
   const fromX = numberValue(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
@@ -7877,7 +7903,11 @@ function normalizeSetupAction(input, index) {
     "assign_return_to",
     "assignReturnTo",
     "return_state_path",
-    "returnStatePath"
+    "returnStatePath",
+    "store_signature_to",
+    "storeSignatureTo",
+    "signature_path",
+    "signaturePath"
   );
   const captureReturn = input.capture_return === false || input.captureReturn === false || input.include_return === false || input.includeReturn === false || input.omit_return === true || input.omitReturn === true ? false : void 0;
   const untilPath = stringFromOwn(input, "until_path", "untilPath", "until_state_path", "untilStatePath", "until_window_path", "untilWindowPath", "until");
@@ -7929,6 +7959,8 @@ function normalizeSetupAction(input, index) {
     store_return_to: storeReturnTo,
     capture_return: captureReturn,
     return_summary_fields: normalizeReturnSummaryFields(input, index),
+    compare_to: stringFromOwn(input, "compare_to", "compareTo", "previous_signature_path", "previousSignaturePath", "previous_path", "previousPath", "changed_from", "changedFrom"),
+    expect_changed: booleanValue(valueFromOwn(input, "expect_changed", "expectChanged", "should_change", "shouldChange", "changed")),
     until_path: untilPath,
     until_expected_value: hasUntilExpectedValue ? toJsonValue(valueFromOwn(input, "until_expected_value", "untilExpectedValue", "until_expected", "untilExpected", "until_value", "untilValue", "expected_value", "expectedValue", "expected")) : void 0,
     max_calls: maxCalls,
@@ -9051,7 +9083,14 @@ function textSequenceForCheck(viewport, check) {
     const matchTexts = Array.isArray(sequence.match_texts) ? sequence.match_texts : [];
     const visibleTexts = Array.isArray(sequence.visible_texts) ? sequence.visible_texts : [];
     const texts = Array.isArray(sequence.texts) ? sequence.texts : [];
-    const candidates = visibleMatchTexts.length ? visibleMatchTexts : matchTexts.length ? matchTexts : visibleTexts.length ? visibleTexts : texts;
+    let candidates;
+    if (check.type === "selector_text_visible") {
+      candidates = visibleMatchTexts.length ? visibleMatchTexts : visibleTexts;
+    } else if (check.type === "selector_text_absent") {
+      candidates = matchTexts.length ? matchTexts : texts;
+    } else {
+      candidates = visibleMatchTexts.length ? visibleMatchTexts : matchTexts.length ? matchTexts : visibleTexts.length ? visibleTexts : texts;
+    }
     return candidates.map((text) => String(text).replace(/\s+/g, " ").trim()).filter(Boolean);
   }
   return [];
@@ -10415,7 +10454,14 @@ function textSequenceForCheck(viewport, check) {
     const matchTexts = Array.isArray(sequence.match_texts) ? sequence.match_texts : [];
     const visibleTexts = Array.isArray(sequence.visible_texts) ? sequence.visible_texts : [];
     const texts = Array.isArray(sequence.texts) ? sequence.texts : [];
-    const candidates = visibleMatchTexts.length ? visibleMatchTexts : matchTexts.length ? matchTexts : visibleTexts.length ? visibleTexts : texts;
+    let candidates;
+    if (check.type === "selector_text_visible") {
+      candidates = visibleMatchTexts.length ? visibleMatchTexts : visibleTexts;
+    } else if (check.type === "selector_text_absent") {
+      candidates = matchTexts.length ? matchTexts : texts;
+    } else {
+      candidates = visibleMatchTexts.length ? visibleMatchTexts : matchTexts.length ? matchTexts : visibleTexts.length ? visibleTexts : texts;
+    }
     return candidates.map((text) => String(text || "").replace(/\s+/g, " ").trim()).filter(Boolean);
   }
   return [];
@@ -11025,6 +11071,28 @@ function profileSetupRangeValueReceipts(results) {
       reason: result.reason || result.error || null,
     }));
 }
+function profileSetupCanvasSignatureReceipts(results) {
+  return (results || [])
+    .filter((result) => result && profileSetupResultAction(result) === "canvas_signature")
+    .map((result) => ({
+      ordinal: result.ordinal ?? null,
+      ok: result.ok !== false,
+      selector: result.selector ?? null,
+      frame_selector: result.frame_selector ?? null,
+      label: result.label ?? null,
+      hash: result.hash ?? null,
+      data_length: result.data_length ?? null,
+      width: result.width ?? null,
+      height: result.height ?? null,
+      css_width: result.css_width ?? null,
+      css_height: result.css_height ?? null,
+      compare_to: result.compare_to ?? null,
+      previous_hash: result.previous_hash ?? null,
+      changed: result.changed ?? null,
+      return_stored_to: result.return_stored_to ?? null,
+      reason: result.reason || result.error || null,
+    }));
+}
 function sampleProfileSetupSummaryItems(items, limit) {
   if ((items || []).length <= limit) return items || [];
   const firstCount = Math.floor(limit / 2);
@@ -11083,6 +11151,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
       const sampledWindowEvalReceipts = sampleProfileSetupSummaryItems(windowEvalReceipts, 8);
       const rangeValueReceipts = profileSetupRangeValueReceipts(results);
       const sampledRangeValueReceipts = sampleProfileSetupSummaryItems(rangeValueReceipts, 8);
+      const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
+      const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results
         .filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false)
         .map((result) => {
@@ -11144,6 +11214,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         set_range_value_total: rangeValueReceipts.length,
         set_range_value_truncated: rangeValueReceipts.length > sampledRangeValueReceipts.length,
         set_range_value: sampledRangeValueReceipts,
+        canvas_signature_total: canvasSignatureReceipts.length,
+        canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
+        canvas_signature: sampledCanvasSignatureReceipts,
         clicked,
         text_samples: textSamples,
         failed: failed.map((result) => ({
@@ -13159,6 +13232,156 @@ async function executeSetupAction(action, ordinal, viewport) {
         reason: rangeResult && rangeResult.ok === true ? undefined : rangeResult?.reason || "range_value_not_set",
       };
     }
+    if (type === "canvas_signature") {
+      const scope = await setupActionScope(action, timeout);
+      if (!scope.ok) return setupScopeFailure(base, scope);
+      const locator = scope.context.locator(action.selector);
+      const count = await locator.count();
+      if (!count) return { ...base, ...setupScopeEvidence(scope), reason: "selector_not_found", count };
+      const targetIndex = Number.isInteger(action.index) ? action.index : 0;
+      if (targetIndex < 0 || targetIndex >= count) return { ...base, ...setupScopeEvidence(scope), reason: "index_out_of_range", count, target_index: targetIndex };
+      const target = locator.nth(targetIndex);
+      await target.waitFor({ state: "visible", timeout });
+      const storeReturnTo = String(action.store_return_to || action.storeReturnTo || action.save_return_to || action.saveReturnTo || action.store_signature_to || action.storeSignatureTo || action.signature_path || action.signaturePath || "").trim();
+      const compareTo = String(action.compare_to || action.compareTo || action.previous_signature_path || action.previousSignaturePath || action.previous_path || action.previousPath || action.changed_from || action.changedFrom || "").trim();
+      const expectChanged = action.expect_changed === true || action.expectChanged === true || action.should_change === true || action.shouldChange === true || action.changed === true
+        ? true
+        : action.expect_changed === false || action.expectChanged === false || action.should_change === false || action.shouldChange === false || action.changed === false
+          ? false
+          : undefined;
+      const signatureResult = await target.evaluate((element, payload) => {
+        const toJsonValue = (value) => {
+          if (value === null || value === undefined) return null;
+          if (typeof value === "string" || typeof value === "boolean") return value;
+          if (typeof value === "number") return Number.isFinite(value) ? value : null;
+          if (Array.isArray(value)) return value.map(toJsonValue);
+          if (typeof value === "object") {
+            return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, toJsonValue(child)]));
+          }
+          return String(value);
+        };
+        const pathParts = (path) => String(path || "").split(".").map((part) => part.trim()).filter(Boolean);
+        const readWindowPath = (path) => {
+          const parts = pathParts(path);
+          if (parts[0] === "window") parts.shift();
+          if (!parts.length) return { ok: false, reason: "missing_path" };
+          let current = window;
+          for (const part of parts) {
+            if (current === null || current === undefined) return { ok: false, reason: "path_not_found", missing_part: part };
+            current = current[part];
+            if (current === undefined) return { ok: false, reason: "path_not_found", missing_part: part };
+          }
+          return { ok: true, value: toJsonValue(current) };
+        };
+        const storeWindowValue = (path, value) => {
+          const parts = pathParts(path);
+          if (parts[0] === "window") parts.shift();
+          if (!parts.length) return { ok: false, reason: "missing_store_path" };
+          let target = window;
+          for (let index = 0; index < parts.length - 1; index += 1) {
+            const part = parts[index];
+            if (target[part] === null || typeof target[part] !== "object") target[part] = {};
+            target = target[part];
+          }
+          target[parts[parts.length - 1]] = value;
+          return { ok: true, path: parts.join(".") };
+        };
+        const hashText = (text) => {
+          let hash = 2166136261;
+          const step = Math.max(1, Math.floor((text.length || 1) / 4000));
+          for (let index = 0; index < text.length; index += step) {
+            hash ^= text.charCodeAt(index);
+            hash = Math.imul(hash, 16777619) >>> 0;
+          }
+          return String(hash);
+        };
+        const tag = String(element && element.tagName ? element.tagName : "").toLowerCase();
+        if (tag !== "canvas") return { ok: false, reason: "not_canvas_element", tag };
+        const rect = element.getBoundingClientRect();
+        let data = "";
+        try {
+          data = element.toDataURL("image/png");
+        } catch (error) {
+          return {
+            ok: false,
+            reason: "canvas_read_failed",
+            error: String(error && error.message ? error.message : error).slice(0, 1000),
+            width: element.width || 0,
+            height: element.height || 0,
+            css_width: Math.round(rect.width || 0),
+            css_height: Math.round(rect.height || 0),
+          };
+        }
+        const result = {
+          ok: Boolean(element.width > 0 && element.height > 0 && data.length > 0),
+          reason: element.width > 0 && element.height > 0 && data.length > 0 ? undefined : "empty_canvas_signature",
+          hash: hashText(data),
+          data_length: data.length,
+          width: element.width || 0,
+          height: element.height || 0,
+          css_width: Math.round(rect.width || 0),
+          css_height: Math.round(rect.height || 0),
+          compare_to: payload.compareTo || undefined,
+          previous_hash: null,
+          changed: null,
+        };
+        if (payload.compareTo) {
+          const previous = readWindowPath(payload.compareTo);
+          if (!previous.ok) {
+            result.ok = false;
+            result.reason = previous.reason || "compare_path_not_found";
+            result.missing_part = previous.missing_part || undefined;
+          } else {
+            const previousValue = previous.value;
+            const previousHash = previousValue && typeof previousValue === "object" && !Array.isArray(previousValue)
+              ? previousValue.hash || previousValue.signature || previousValue.canvas_hash || null
+              : typeof previousValue === "string"
+                ? previousValue
+                : null;
+            result.previous_hash = previousHash === null || previousHash === undefined ? null : String(previousHash);
+            result.changed = result.previous_hash === null ? null : result.previous_hash !== result.hash;
+            if (payload.expectChanged === true && result.changed !== true) {
+              result.ok = false;
+              result.reason = "canvas_signature_unchanged";
+            } else if (payload.expectChanged === false && result.changed !== false) {
+              result.ok = false;
+              result.reason = "canvas_signature_changed";
+            }
+          }
+        }
+        if (payload.storeReturnTo) {
+          const stored = storeWindowValue(payload.storeReturnTo, result);
+          if (!stored.ok) {
+            return { ...result, ok: false, reason: "signature_store_failed", store_reason: stored.reason };
+          }
+          return { ...result, return_stored_to: stored.path };
+        }
+        return result;
+      }, { compareTo, expectChanged, storeReturnTo });
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: signatureResult && signatureResult.ok === true,
+        count,
+        target_index: targetIndex,
+        label: action.label || action.name || undefined,
+        hash: signatureResult?.hash,
+        data_length: signatureResult?.data_length,
+        width: signatureResult?.width,
+        height: signatureResult?.height,
+        css_width: signatureResult?.css_width,
+        css_height: signatureResult?.css_height,
+        compare_to: signatureResult?.compare_to || compareTo || undefined,
+        previous_hash: signatureResult?.previous_hash,
+        changed: signatureResult?.changed,
+        return_stored_to: signatureResult?.return_stored_to || storeReturnTo || undefined,
+        missing_part: signatureResult?.missing_part || undefined,
+        store_reason: signatureResult?.store_reason || undefined,
+        tag: signatureResult?.tag,
+        reason: signatureResult && signatureResult.ok === true ? undefined : signatureResult?.reason || "canvas_signature_failed",
+        error: signatureResult?.error || undefined,
+      };
+    }
     if (type === "assert_selector_count") {
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
@@ -15398,22 +15621,34 @@ function balancedSetupReceiptDetails(groups, limit) {
   const total = groups.reduce((sum, group) => sum + group.length, 0);
   if (total <= limit) return groups.flat();
   const selected = [];
+  const selectedKeys = /* @__PURE__ */ new Set();
   const indexes = new Array(groups.length).fill(0);
   const nonEmptyIndexes = groups.map((group, index) => group.length ? index : -1).filter((index) => index >= 0);
+  const pushReceipt = (groupIndex, itemIndex, advance = true) => {
+    const receipt = groups[groupIndex][itemIndex];
+    if (!receipt) return false;
+    const key = `${groupIndex}:${itemIndex}`;
+    if (selectedKeys.has(key)) return false;
+    selected.push(receipt);
+    selectedKeys.add(key);
+    if (advance) indexes[groupIndex] = Math.max(indexes[groupIndex], itemIndex + 1);
+    return true;
+  };
+  for (const index of nonEmptyIndexes) {
+    if (selected.length >= limit) return selected;
+    pushReceipt(index, 0);
+  }
   for (const index of nonEmptyIndexes) {
     if (selected.length >= limit) return selected;
-    selected.push(groups[index][0]);
-    indexes[index] = 1;
+    const lastIndex = groups[index].length - 1;
+    if (lastIndex > 0) pushReceipt(index, lastIndex, false);
   }
   while (selected.length < limit) {
     let progressed = false;
     for (const index of nonEmptyIndexes) {
       const nextIndex = indexes[index];
-      const next = groups[index][nextIndex];
-      if (!next) continue;
-      selected.push(next);
-      indexes[index] = nextIndex + 1;
-      progressed = true;
+      if (nextIndex >= groups[index].length) continue;
+      progressed = pushReceipt(index, nextIndex) || progressed;
       if (selected.length >= limit) break;
     }
     if (!progressed) break;
@@ -15524,6 +15759,7 @@ function profileSetupSummaryMarkdown(result) {
   const windowCallUntilTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.window_call_until_total) || 0), 0);
   const windowCallUntilCallTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.window_call_until_call_total) || 0), 0);
   const rangeValueTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.set_range_value_total) || 0), 0);
+  const canvasSignatureTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.canvas_signature_total) || 0), 0);
   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)`,
@@ -15546,6 +15782,9 @@ function profileSetupSummaryMarkdown(result) {
   if (rangeValueTotal) {
     lines.push(`- set_range_value: ${rangeValueTotal} action(s)`);
   }
+  if (canvasSignatureTotal) {
+    lines.push(`- canvas_signature: ${canvasSignatureTotal} action(s)`);
+  }
   for (const viewport of viewports.slice(0, 8)) {
     const name = cliString(viewport.name) || "viewport";
     const ok = viewport.ok === false ? "failed" : "ok";
@@ -15562,9 +15801,37 @@ function profileSetupSummaryMarkdown(result) {
     const windowCallUntilActions = cliFiniteNumber(viewport.window_call_until_total) || 0;
     const windowCallUntilCalls = cliFiniteNumber(viewport.window_call_until_call_total) || 0;
     const rangeValueActions = cliFiniteNumber(viewport.set_range_value_total) || 0;
+    const canvasSignatureActions = cliFiniteNumber(viewport.canvas_signature_total) || 0;
     const observedPath = cliString(viewport.observed_path);
-    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${rangeValueActions ? `, ${rangeValueActions} set_range_value action(s)` : ""}${windowCallActions ? `, ${windowCallActions} window_call action(s), ${windowCallStored} stored return(s), ${windowCallCaptured} captured return(s)` : ""}${windowEvalActions ? `, ${windowEvalActions} window_eval action(s), ${windowEvalStored} stored return(s), ${windowEvalCaptured} captured return(s)` : ""}${windowCallUntilActions ? `, ${windowCallUntilActions} window_call_until action(s), ${windowCallUntilCalls} call(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
+    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${rangeValueActions ? `, ${rangeValueActions} set_range_value action(s)` : ""}${canvasSignatureActions ? `, ${canvasSignatureActions} canvas_signature action(s)` : ""}${windowCallActions ? `, ${windowCallActions} window_call action(s), ${windowCallStored} stored return(s), ${windowCallCaptured} captured return(s)` : ""}${windowEvalActions ? `, ${windowEvalActions} window_eval action(s), ${windowEvalStored} stored return(s), ${windowEvalCaptured} captured return(s)` : ""}${windowCallUntilActions ? `, ${windowCallUntilActions} window_call_until action(s), ${windowCallUntilCalls} call(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
+  }
+  const canvasSignatureGroups = viewports.map((viewport) => {
+    const name = cliString(viewport.name) || "viewport";
+    const receipts = Array.isArray(viewport.canvas_signature) ? viewport.canvas_signature.map(cliRecord).filter((item) => Boolean(item)) : [];
+    return receipts.map((receipt) => ({ name, receipt }));
+  });
+  const canvasSignatureDetails = canvasSignatureGroups.flat();
+  const sampledCanvasSignatureDetails = balancedSetupReceiptDetails(canvasSignatureGroups, 12);
+  for (const { name, receipt } of sampledCanvasSignatureDetails) {
+    const selector = cliString(receipt.selector) || "canvas";
+    const label = cliString(receipt.label);
+    const hash = cliString(receipt.hash);
+    const dataLength = cliFiniteNumber(receipt.data_length);
+    const width = cliFiniteNumber(receipt.width);
+    const height = cliFiniteNumber(receipt.height);
+    const cssWidth = cliFiniteNumber(receipt.css_width);
+    const cssHeight = cliFiniteNumber(receipt.css_height);
+    const compareTo = cliString(receipt.compare_to);
+    const previousHash = cliString(receipt.previous_hash);
+    const changed = typeof receipt.changed === "boolean" ? receipt.changed : void 0;
+    const storedTo = cliString(receipt.return_stored_to);
+    const ok = receipt.ok === false ? "failed" : "ok";
+    const reason = cliString(receipt.reason);
+    const sizeText = width === void 0 || height === void 0 ? "" : `, ${width}x${height}`;
+    const cssSizeText = cssWidth === void 0 || cssHeight === void 0 ? "" : `, css ${cssWidth}x${cssHeight}`;
+    lines.push(`- ${name} canvas_signature: ${ok}, ${markdownInlineCode(selector)}${label ? ` ${markdownInlineCode(label, 80)}` : ""}${hash ? ` hash ${markdownInlineCode(hash, 80)}` : ""}${sizeText}${cssSizeText}${dataLength === void 0 ? "" : `, data chars ${dataLength}`}${compareTo ? `, compared ${markdownInlineCode(compareTo)}` : ""}${previousHash ? ` previous ${markdownInlineCode(previousHash, 80)}` : ""}${changed === void 0 ? "" : `, changed ${changed}`}${storedTo ? `, stored ${markdownInlineCode(storedTo)}` : ""}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
+  if (canvasSignatureDetails.length > sampledCanvasSignatureDetails.length) lines.push(`- ${canvasSignatureDetails.length - sampledCanvasSignatureDetails.length} additional canvas_signature receipt(s) omitted.`);
   const rangeValueGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
     const receipts = Array.isArray(viewport.set_range_value) ? viewport.set_range_value.map(cliRecord).filter((item) => Boolean(item)) : [];

package/dist/cli.js

@@ -13,7 +13,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-YB3LNLZB.js";
+} from "./chunk-MV7UM4EV.js";
 import {
   createRiddleApiClient,
   isTerminalRiddleJobStatus,
@@ -649,22 +649,34 @@ function balancedSetupReceiptDetails(groups, limit) {
   const total = groups.reduce((sum, group) => sum + group.length, 0);
   if (total <= limit) return groups.flat();
   const selected = [];
+  const selectedKeys = /* @__PURE__ */ new Set();
   const indexes = new Array(groups.length).fill(0);
   const nonEmptyIndexes = groups.map((group, index) => group.length ? index : -1).filter((index) => index >= 0);
+  const pushReceipt = (groupIndex, itemIndex, advance = true) => {
+    const receipt = groups[groupIndex][itemIndex];
+    if (!receipt) return false;
+    const key = `${groupIndex}:${itemIndex}`;
+    if (selectedKeys.has(key)) return false;
+    selected.push(receipt);
+    selectedKeys.add(key);
+    if (advance) indexes[groupIndex] = Math.max(indexes[groupIndex], itemIndex + 1);
+    return true;
+  };
+  for (const index of nonEmptyIndexes) {
+    if (selected.length >= limit) return selected;
+    pushReceipt(index, 0);
+  }
   for (const index of nonEmptyIndexes) {
     if (selected.length >= limit) return selected;
-    selected.push(groups[index][0]);
-    indexes[index] = 1;
+    const lastIndex = groups[index].length - 1;
+    if (lastIndex > 0) pushReceipt(index, lastIndex, false);
   }
   while (selected.length < limit) {
     let progressed = false;
     for (const index of nonEmptyIndexes) {
       const nextIndex = indexes[index];
-      const next = groups[index][nextIndex];
-      if (!next) continue;
-      selected.push(next);
-      indexes[index] = nextIndex + 1;
-      progressed = true;
+      if (nextIndex >= groups[index].length) continue;
+      progressed = pushReceipt(index, nextIndex) || progressed;
       if (selected.length >= limit) break;
     }
     if (!progressed) break;
@@ -775,6 +787,7 @@ function profileSetupSummaryMarkdown(result) {
   const windowCallUntilTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.window_call_until_total) || 0), 0);
   const windowCallUntilCallTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.window_call_until_call_total) || 0), 0);
   const rangeValueTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.set_range_value_total) || 0), 0);
+  const canvasSignatureTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.canvas_signature_total) || 0), 0);
   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)`,
@@ -797,6 +810,9 @@ function profileSetupSummaryMarkdown(result) {
   if (rangeValueTotal) {
     lines.push(`- set_range_value: ${rangeValueTotal} action(s)`);
   }
+  if (canvasSignatureTotal) {
+    lines.push(`- canvas_signature: ${canvasSignatureTotal} action(s)`);
+  }
   for (const viewport of viewports.slice(0, 8)) {
     const name = cliString(viewport.name) || "viewport";
     const ok = viewport.ok === false ? "failed" : "ok";
@@ -813,9 +829,37 @@ function profileSetupSummaryMarkdown(result) {
     const windowCallUntilActions = cliFiniteNumber(viewport.window_call_until_total) || 0;
     const windowCallUntilCalls = cliFiniteNumber(viewport.window_call_until_call_total) || 0;
     const rangeValueActions = cliFiniteNumber(viewport.set_range_value_total) || 0;
+    const canvasSignatureActions = cliFiniteNumber(viewport.canvas_signature_total) || 0;
     const observedPath = cliString(viewport.observed_path);
-    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${rangeValueActions ? `, ${rangeValueActions} set_range_value action(s)` : ""}${windowCallActions ? `, ${windowCallActions} window_call action(s), ${windowCallStored} stored return(s), ${windowCallCaptured} captured return(s)` : ""}${windowEvalActions ? `, ${windowEvalActions} window_eval action(s), ${windowEvalStored} stored return(s), ${windowEvalCaptured} captured return(s)` : ""}${windowCallUntilActions ? `, ${windowCallUntilActions} window_call_until action(s), ${windowCallUntilCalls} call(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
+    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${rangeValueActions ? `, ${rangeValueActions} set_range_value action(s)` : ""}${canvasSignatureActions ? `, ${canvasSignatureActions} canvas_signature action(s)` : ""}${windowCallActions ? `, ${windowCallActions} window_call action(s), ${windowCallStored} stored return(s), ${windowCallCaptured} captured return(s)` : ""}${windowEvalActions ? `, ${windowEvalActions} window_eval action(s), ${windowEvalStored} stored return(s), ${windowEvalCaptured} captured return(s)` : ""}${windowCallUntilActions ? `, ${windowCallUntilActions} window_call_until action(s), ${windowCallUntilCalls} call(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
+  }
+  const canvasSignatureGroups = viewports.map((viewport) => {
+    const name = cliString(viewport.name) || "viewport";
+    const receipts = Array.isArray(viewport.canvas_signature) ? viewport.canvas_signature.map(cliRecord).filter((item) => Boolean(item)) : [];
+    return receipts.map((receipt) => ({ name, receipt }));
+  });
+  const canvasSignatureDetails = canvasSignatureGroups.flat();
+  const sampledCanvasSignatureDetails = balancedSetupReceiptDetails(canvasSignatureGroups, 12);
+  for (const { name, receipt } of sampledCanvasSignatureDetails) {
+    const selector = cliString(receipt.selector) || "canvas";
+    const label = cliString(receipt.label);
+    const hash = cliString(receipt.hash);
+    const dataLength = cliFiniteNumber(receipt.data_length);
+    const width = cliFiniteNumber(receipt.width);
+    const height = cliFiniteNumber(receipt.height);
+    const cssWidth = cliFiniteNumber(receipt.css_width);
+    const cssHeight = cliFiniteNumber(receipt.css_height);
+    const compareTo = cliString(receipt.compare_to);
+    const previousHash = cliString(receipt.previous_hash);
+    const changed = typeof receipt.changed === "boolean" ? receipt.changed : void 0;
+    const storedTo = cliString(receipt.return_stored_to);
+    const ok = receipt.ok === false ? "failed" : "ok";
+    const reason = cliString(receipt.reason);
+    const sizeText = width === void 0 || height === void 0 ? "" : `, ${width}x${height}`;
+    const cssSizeText = cssWidth === void 0 || cssHeight === void 0 ? "" : `, css ${cssWidth}x${cssHeight}`;
+    lines.push(`- ${name} canvas_signature: ${ok}, ${markdownInlineCode(selector)}${label ? ` ${markdownInlineCode(label, 80)}` : ""}${hash ? ` hash ${markdownInlineCode(hash, 80)}` : ""}${sizeText}${cssSizeText}${dataLength === void 0 ? "" : `, data chars ${dataLength}`}${compareTo ? `, compared ${markdownInlineCode(compareTo)}` : ""}${previousHash ? ` previous ${markdownInlineCode(previousHash, 80)}` : ""}${changed === void 0 ? "" : `, changed ${changed}`}${storedTo ? `, stored ${markdownInlineCode(storedTo)}` : ""}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
+  if (canvasSignatureDetails.length > sampledCanvasSignatureDetails.length) lines.push(`- ${canvasSignatureDetails.length - sampledCanvasSignatureDetails.length} additional canvas_signature receipt(s) omitted.`);
   const rangeValueGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
     const receipts = Array.isArray(viewport.set_range_value) ? viewport.set_range_value.map(cliRecord).filter((item) => Boolean(item)) : [];