@riddledc/riddle-proof 0.7.67 → 0.7.69

package/README.md

@@ -272,6 +272,10 @@ stable enough for Playwright's default click actionability checks. Use `press`
 with a Playwright key name, such as `Enter`, `Space`, or `ArrowLeft`,
 when a route's intended browser control is keyboard-driven; omit `selector` for
 a page-level key press, or provide `selector` to press against a focused element.
+Use `click_count` / `clickCount` / `clicks` from 1 to 10 on a single `click`
+action for atomic double-click or double-submit contracts where modeling the
+interaction as repeated setup actions would incorrectly require the target to
+remain in the DOM after the first click.
 Use `drag` for pointer-driven controls such as canvas launch areas, sliders, or
 drag-to-aim games. Provide `selector`, `from_x`, `from_y`, `to_x`, and `to_y`;
 coordinates are element-relative pixels by default. Set `coordinate_mode:
@@ -468,8 +472,11 @@ from weak proof and environment blockers:
 `--output` writes `profile-result.json`, `summary.md`, and local copies of the
 structured `proof.json`, `console.json`, and `dom-summary.json` when they are
 available. Riddle screenshot URLs remain referenced in the result's artifact
-list. The profile/result schema is runner-agnostic; Riddle is the first hosted
-adapter.
+list. When setup actions or network mocks are present, `summary.md` includes
+compact setup and network mock sections so reviewers can see action counts,
+setup screenshots, hit counts, required hits, max-hit caps, and failed mocks
+without opening the full JSON artifact. The profile/result schema is
+runner-agnostic; Riddle is the first hosted adapter.
 
 ## Runner Harness
 

package/dist/{chunk-376FPGFA.js → chunk-ZQPC7PYM.js}

@@ -329,6 +329,18 @@ function normalizeSetupActionRepeat(input, index) {
   }
   return repeat;
 }
+function normalizeSetupActionClickCount(input, type, index) {
+  const clickCountInput = valueFromOwn(input, "click_count", "clickCount", "clicks");
+  if (clickCountInput === void 0) return void 0;
+  if (type !== "click") {
+    throw new Error(`target.setup_actions[${index}].click_count is only supported for click actions.`);
+  }
+  const clickCount = numberValue(clickCountInput);
+  if (clickCount === void 0 || !Number.isInteger(clickCount) || clickCount < 1 || clickCount > 10) {
+    throw new Error(`target.setup_actions[${index}].click_count must be an integer from 1 to 10.`);
+  }
+  return clickCount;
+}
 function normalizeSetupActionCoordinateMode(value, index) {
   if (value === void 0 || value === null || value === "") return void 0;
   const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
@@ -420,6 +432,7 @@ function normalizeSetupAction(input, index) {
     frame_selector: frameSelector,
     frame_index: frameIndex,
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
     from_x: fromX,
     from_y: fromY,
@@ -3118,8 +3131,10 @@ async function executeSetupAction(action, ordinal, viewport) {
       const clickOptions = action.force === true
         ? { timeout, noWaitAfter: true, force: true }
         : { timeout, noWaitAfter: true };
+      const clickCount = setupNumber(action.click_count, 1);
+      if (Number.isInteger(clickCount) && clickCount > 1) clickOptions.clickCount = clickCount;
       await locator.nth(targetIndex).click(clickOptions);
-      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
+      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined, click_count: clickCount > 1 ? clickCount : undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const scope = await setupActionScope(action, timeout);

package/dist/cli.cjs

@@ -7202,6 +7202,18 @@ function normalizeSetupActionRepeat(input, index) {
   }
   return repeat;
 }
+function normalizeSetupActionClickCount(input, type, index) {
+  const clickCountInput = valueFromOwn(input, "click_count", "clickCount", "clicks");
+  if (clickCountInput === void 0) return void 0;
+  if (type !== "click") {
+    throw new Error(`target.setup_actions[${index}].click_count is only supported for click actions.`);
+  }
+  const clickCount = numberValue(clickCountInput);
+  if (clickCount === void 0 || !Number.isInteger(clickCount) || clickCount < 1 || clickCount > 10) {
+    throw new Error(`target.setup_actions[${index}].click_count must be an integer from 1 to 10.`);
+  }
+  return clickCount;
+}
 function normalizeSetupActionCoordinateMode(value, index) {
   if (value === void 0 || value === null || value === "") return void 0;
   const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
@@ -7293,6 +7305,7 @@ function normalizeSetupAction(input, index) {
     frame_selector: frameSelector,
     frame_index: frameIndex,
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
     from_x: fromX,
     from_y: fromY,
@@ -9975,8 +9988,10 @@ async function executeSetupAction(action, ordinal, viewport) {
       const clickOptions = action.force === true
         ? { timeout, noWaitAfter: true, force: true }
         : { timeout, noWaitAfter: true };
+      const clickCount = setupNumber(action.click_count, 1);
+      if (Number.isInteger(clickCount) && clickCount > 1) clickOptions.clickCount = clickCount;
       await locator.nth(targetIndex).click(clickOptions);
-      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
+      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined, click_count: clickCount > 1 ? clickCount : undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const scope = await setupActionScope(action, timeout);
@@ -11194,6 +11209,10 @@ function profileResultMarkdown(result) {
   if (setupSummaryLines.length) {
     lines.push("", "## Setup Summary", "", ...setupSummaryLines);
   }
+  const networkMockSummaryLines = profileNetworkMockSummaryMarkdown(result);
+  if (networkMockSummaryLines.length) {
+    lines.push("", "## Network Mocks", "", ...networkMockSummaryLines);
+  }
   if (result.artifacts.riddle_artifacts?.length) {
     lines.push("", "## Riddle Artifacts", "");
     for (const artifact of result.artifacts.riddle_artifacts.slice(0, 40)) {
@@ -11243,6 +11262,41 @@ function profileSetupSummaryMarkdown(result) {
   if (viewports.length > 8) lines.push(`- ${viewports.length - 8} additional viewport(s) omitted from setup summary.`);
   return lines;
 }
+function cliRecordNumber(value, key) {
+  return cliFiniteNumber(value[key]);
+}
+function profileNetworkMockSummaryMarkdown(result) {
+  const networkCheck = result.checks.find((check) => check.type === "network_mocks_succeeded");
+  const evidence = cliRecord(networkCheck?.evidence);
+  if (!evidence) return [];
+  const hitsByLabel = cliRecord(evidence.hits_by_label) || {};
+  const requiredHitsByLabel = cliRecord(evidence.required_hits_by_label) || {};
+  const maxHitsByLabel = cliRecord(evidence.max_hits_by_label) || {};
+  const labels = Array.from(/* @__PURE__ */ new Set([
+    ...Object.keys(hitsByLabel),
+    ...Object.keys(requiredHitsByLabel),
+    ...Object.keys(maxHitsByLabel)
+  ])).sort();
+  const mockCount = cliFiniteNumber(evidence.mock_count);
+  const requiredCount = cliFiniteNumber(evidence.required_count);
+  const hitCount = cliFiniteNumber(evidence.hit_count);
+  const failed = Array.isArray(evidence.failed) ? evidence.failed : [];
+  if (!labels.length && mockCount === void 0 && hitCount === void 0 && !failed.length) return [];
+  const lines = [
+    `- mocks: ${mockCount === void 0 ? labels.length : mockCount}; total hits: ${hitCount === void 0 ? "unknown" : hitCount}${requiredCount === void 0 ? "" : `; required mocks: ${requiredCount}`}`,
+    `- failed mocks: ${failed.length}`
+  ];
+  for (const label of labels.slice(0, 16)) {
+    const parts = [`hits ${cliRecordNumber(hitsByLabel, label) ?? 0}`];
+    const requiredHits = cliRecordNumber(requiredHitsByLabel, label);
+    const maxHits = cliRecordNumber(maxHitsByLabel, label);
+    if (requiredHits !== void 0) parts.push(`required ${requiredHits}`);
+    if (maxHits !== void 0) parts.push(`max ${maxHits}`);
+    lines.push(`- ${label}: ${parts.join(", ")}`);
+  }
+  if (labels.length > 16) lines.push(`- ${labels.length - 16} additional network mock label(s) omitted from summary.`);
+  return lines;
+}
 function writeProfileOutput(outputDir, result) {
   if (!outputDir) return;
   (0, import_node_fs6.mkdirSync)(outputDir, { recursive: true });

package/dist/cli.js

@@ -10,7 +10,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-376FPGFA.js";
+} from "./chunk-ZQPC7PYM.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport
@@ -316,6 +316,10 @@ function profileResultMarkdown(result) {
   if (setupSummaryLines.length) {
     lines.push("", "## Setup Summary", "", ...setupSummaryLines);
   }
+  const networkMockSummaryLines = profileNetworkMockSummaryMarkdown(result);
+  if (networkMockSummaryLines.length) {
+    lines.push("", "## Network Mocks", "", ...networkMockSummaryLines);
+  }
   if (result.artifacts.riddle_artifacts?.length) {
     lines.push("", "## Riddle Artifacts", "");
     for (const artifact of result.artifacts.riddle_artifacts.slice(0, 40)) {
@@ -365,6 +369,41 @@ function profileSetupSummaryMarkdown(result) {
   if (viewports.length > 8) lines.push(`- ${viewports.length - 8} additional viewport(s) omitted from setup summary.`);
   return lines;
 }
+function cliRecordNumber(value, key) {
+  return cliFiniteNumber(value[key]);
+}
+function profileNetworkMockSummaryMarkdown(result) {
+  const networkCheck = result.checks.find((check) => check.type === "network_mocks_succeeded");
+  const evidence = cliRecord(networkCheck?.evidence);
+  if (!evidence) return [];
+  const hitsByLabel = cliRecord(evidence.hits_by_label) || {};
+  const requiredHitsByLabel = cliRecord(evidence.required_hits_by_label) || {};
+  const maxHitsByLabel = cliRecord(evidence.max_hits_by_label) || {};
+  const labels = Array.from(/* @__PURE__ */ new Set([
+    ...Object.keys(hitsByLabel),
+    ...Object.keys(requiredHitsByLabel),
+    ...Object.keys(maxHitsByLabel)
+  ])).sort();
+  const mockCount = cliFiniteNumber(evidence.mock_count);
+  const requiredCount = cliFiniteNumber(evidence.required_count);
+  const hitCount = cliFiniteNumber(evidence.hit_count);
+  const failed = Array.isArray(evidence.failed) ? evidence.failed : [];
+  if (!labels.length && mockCount === void 0 && hitCount === void 0 && !failed.length) return [];
+  const lines = [
+    `- mocks: ${mockCount === void 0 ? labels.length : mockCount}; total hits: ${hitCount === void 0 ? "unknown" : hitCount}${requiredCount === void 0 ? "" : `; required mocks: ${requiredCount}`}`,
+    `- failed mocks: ${failed.length}`
+  ];
+  for (const label of labels.slice(0, 16)) {
+    const parts = [`hits ${cliRecordNumber(hitsByLabel, label) ?? 0}`];
+    const requiredHits = cliRecordNumber(requiredHitsByLabel, label);
+    const maxHits = cliRecordNumber(maxHitsByLabel, label);
+    if (requiredHits !== void 0) parts.push(`required ${requiredHits}`);
+    if (maxHits !== void 0) parts.push(`max ${maxHits}`);
+    lines.push(`- ${label}: ${parts.join(", ")}`);
+  }
+  if (labels.length > 16) lines.push(`- ${labels.length - 16} additional network mock label(s) omitted from summary.`);
+  return lines;
+}
 function writeProfileOutput(outputDir, result) {
   if (!outputDir) return;
   mkdirSync(outputDir, { recursive: true });

package/dist/index.cjs

@@ -9043,6 +9043,18 @@ function normalizeSetupActionRepeat(input, index) {
   }
   return repeat;
 }
+function normalizeSetupActionClickCount(input, type, index) {
+  const clickCountInput = valueFromOwn(input, "click_count", "clickCount", "clicks");
+  if (clickCountInput === void 0) return void 0;
+  if (type !== "click") {
+    throw new Error(`target.setup_actions[${index}].click_count is only supported for click actions.`);
+  }
+  const clickCount = numberValue3(clickCountInput);
+  if (clickCount === void 0 || !Number.isInteger(clickCount) || clickCount < 1 || clickCount > 10) {
+    throw new Error(`target.setup_actions[${index}].click_count must be an integer from 1 to 10.`);
+  }
+  return clickCount;
+}
 function normalizeSetupActionCoordinateMode(value, index) {
   if (value === void 0 || value === null || value === "") return void 0;
   const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
@@ -9134,6 +9146,7 @@ function normalizeSetupAction(input, index) {
     frame_selector: frameSelector,
     frame_index: frameIndex,
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
     from_x: fromX,
     from_y: fromY,
@@ -11832,8 +11845,10 @@ async function executeSetupAction(action, ordinal, viewport) {
       const clickOptions = action.force === true
         ? { timeout, noWaitAfter: true, force: true }
         : { timeout, noWaitAfter: true };
+      const clickCount = setupNumber(action.click_count, 1);
+      if (Number.isInteger(clickCount) && clickCount > 1) clickOptions.clickCount = clickCount;
       await locator.nth(targetIndex).click(clickOptions);
-      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
+      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined, click_count: clickCount > 1 ? clickCount : undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const scope = await setupActionScope(action, timeout);

package/dist/index.js

@@ -58,7 +58,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-376FPGFA.js";
+} from "./chunk-ZQPC7PYM.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -372,6 +372,18 @@ function normalizeSetupActionRepeat(input, index) {
   }
   return repeat;
 }
+function normalizeSetupActionClickCount(input, type, index) {
+  const clickCountInput = valueFromOwn(input, "click_count", "clickCount", "clicks");
+  if (clickCountInput === void 0) return void 0;
+  if (type !== "click") {
+    throw new Error(`target.setup_actions[${index}].click_count is only supported for click actions.`);
+  }
+  const clickCount = numberValue(clickCountInput);
+  if (clickCount === void 0 || !Number.isInteger(clickCount) || clickCount < 1 || clickCount > 10) {
+    throw new Error(`target.setup_actions[${index}].click_count must be an integer from 1 to 10.`);
+  }
+  return clickCount;
+}
 function normalizeSetupActionCoordinateMode(value, index) {
   if (value === void 0 || value === null || value === "") return void 0;
   const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
@@ -463,6 +475,7 @@ function normalizeSetupAction(input, index) {
     frame_selector: frameSelector,
     frame_index: frameIndex,
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
     from_x: fromX,
     from_y: fromY,
@@ -3161,8 +3174,10 @@ async function executeSetupAction(action, ordinal, viewport) {
       const clickOptions = action.force === true
         ? { timeout, noWaitAfter: true, force: true }
         : { timeout, noWaitAfter: true };
+      const clickCount = setupNumber(action.click_count, 1);
+      if (Number.isInteger(clickCount) && clickCount > 1) clickOptions.clickCount = clickCount;
       await locator.nth(targetIndex).click(clickOptions);
-      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
+      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined, click_count: clickCount > 1 ? clickCount : undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const scope = await setupActionScope(action, timeout);

package/dist/profile.d.cts

@@ -23,6 +23,7 @@ interface RiddleProofProfileSetupAction {
     frame_selector?: string;
     frame_index?: number;
     force?: boolean;
+    click_count?: number;
     coordinate_mode?: "pixels" | "ratio";
     from_x?: number;
     from_y?: number;

package/dist/profile.d.ts

@@ -23,6 +23,7 @@ interface RiddleProofProfileSetupAction {
     frame_selector?: string;
     frame_index?: number;
     force?: boolean;
+    click_count?: number;
     coordinate_mode?: "pixels" | "ratio";
     from_x?: number;
     from_y?: number;

package/dist/profile.js

@@ -19,7 +19,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-376FPGFA.js";
+} from "./chunk-ZQPC7PYM.js";
 export {
   RIDDLE_PROOF_PROFILE_CHECK_TYPES,
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,

package/dist/proof-run-engine.d.cts

@@ -292,7 +292,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     blocking?: boolean;
     details?: Record<string, unknown>;
     ok: boolean;
-    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     summary: string;
@@ -382,7 +382,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     continueWithStage?: WorkflowStage | null;
     blocking?: boolean;
     details?: Record<string, unknown>;
-    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     checkpoint: string;
@@ -659,7 +659,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     error?: undefined;
 } | {
     ok: boolean;
-    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     summary: string;

package/dist/proof-run-engine.d.ts

@@ -292,7 +292,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     blocking?: boolean;
     details?: Record<string, unknown>;
     ok: boolean;
-    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     summary: string;
@@ -382,7 +382,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     continueWithStage?: WorkflowStage | null;
     blocking?: boolean;
     details?: Record<string, unknown>;
-    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     checkpoint: string;
@@ -659,7 +659,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     error?: undefined;
 } | {
     ok: boolean;
-    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     summary: string;

package/package.json

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