@riddledc/riddle-proof 0.7.108 → 0.7.109

package/README.md

@@ -526,8 +526,13 @@ artifact links should fail the profile:
 ```
 
 The check defaults to `a[href]`, deduplicates URLs, probes up to 100 selected
-URLs, and treats HTTP `2xx` / `3xx` responses as healthy. Use
-`allowed_statuses` or `expected_status` when a narrower status contract is
+URLs, and treats HTTP `2xx` / `3xx` responses as healthy. `expected_count` and
+`min_count` apply to the probed URL set after same-origin filtering, URL
+deduplication, and the `max_links` limit. The run summary also reports
+`discovered_count` when it differs, which helps explain cases where a page has
+two DOM nodes pointing at the same artifact URL. Use `dedupe: false` when the
+contract should count duplicate DOM candidates instead of unique artifact URLs.
+Use `allowed_statuses` or `expected_status` when a narrower status contract is
 intentional, `min_count` for lower-bound audits, `min_bytes` when a one-byte
 range response is too weak, `allowed_content_types` for MIME checks, and
 `max_links` when the selected set is intentionally larger than 100.

package/dist/cli.cjs

@@ -12911,8 +12911,8 @@ function profileCheckMarkdownTarget(check) {
     const minCount = cliFiniteNumber(evidence.min_count);
     const minBytes = cliFiniteNumber(evidence.min_bytes);
     const parts = [];
-    if (expectedCount !== void 0) parts.push(`links = ${expectedCount}`);
-    else if (minCount !== void 0) parts.push(`links >= ${minCount}`);
+    if (expectedCount !== void 0) parts.push(`probed links = ${expectedCount}`);
+    else if (minCount !== void 0) parts.push(`probed links >= ${minCount}`);
     if (minBytes !== void 0) parts.push(`bytes >= ${minBytes}`);
     if (selector && parts.length) return `${markdownInlineCode(selector)} ${parts.join(", ")}`;
     return selector ? markdownInlineCode(selector) : parts.join(", ") || void 0;
@@ -13124,6 +13124,7 @@ function profileLinkStatusSummaryMarkdown(result) {
     const selector = cliString(evidence.selector);
     const viewports = Array.isArray(evidence.viewports) ? evidence.viewports.map(cliRecord).filter((viewport) => Boolean(viewport)) : [];
     const totals = viewports.map((viewport) => cliFiniteNumber(viewport.total_count)).filter((count) => count !== void 0);
+    const discoveredTotals = viewports.map((viewport) => cliFiniteNumber(viewport.discovered_count)).filter((count) => count !== void 0);
     const okTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.ok_count) || 0), 0);
     const failedTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.failed_count) || 0), 0);
     const truncatedTotal = viewports.filter((viewport) => viewport.truncated === true).length;
@@ -13131,8 +13132,9 @@ function profileLinkStatusSummaryMarkdown(result) {
     const minBytes = cliFiniteNumber(evidence.min_bytes);
     const allowedContentTypes = Array.isArray(evidence.allowed_content_types) ? evidence.allowed_content_types.map(cliString).filter((value) => Boolean(value)) : [];
     const countText = totals.length ? totals.join("/") : "unknown";
+    const discoveredText = discoveredTotals.length && discoveredTotals.some((count, index) => count !== totals[index]) ? `, discovered ${discoveredTotals.join("/")}` : "";
     lines.push(
-      `- ${label}${selector ? ` ${markdownInlineCode(selector)}` : ""}: links ${countText}, ok ${okTotal}, failures ${failedTotal}${omittedTotal ? `, compacted ${omittedTotal} result row(s)` : ""}${truncatedTotal ? `, truncated viewports ${truncatedTotal}` : ""}${minBytes !== void 0 ? `, min bytes ${minBytes}` : ""}${allowedContentTypes.length ? `, content types ${allowedContentTypes.map((value) => markdownInlineCode(value)).join(", ")}` : ""}`
+      `- ${label}${selector ? ` ${markdownInlineCode(selector)}` : ""}: probed links ${countText}${discoveredText}, ok ${okTotal}, failures ${failedTotal}${omittedTotal ? `, compacted ${omittedTotal} result row(s)` : ""}${truncatedTotal ? `, truncated viewports ${truncatedTotal}` : ""}${minBytes !== void 0 ? `, min bytes ${minBytes}` : ""}${allowedContentTypes.length ? `, content types ${allowedContentTypes.map((value) => markdownInlineCode(value)).join(", ")}` : ""}`
     );
   }
   return lines;

package/dist/cli.js

@@ -438,8 +438,8 @@ function profileCheckMarkdownTarget(check) {
     const minCount = cliFiniteNumber(evidence.min_count);
     const minBytes = cliFiniteNumber(evidence.min_bytes);
     const parts = [];
-    if (expectedCount !== void 0) parts.push(`links = ${expectedCount}`);
-    else if (minCount !== void 0) parts.push(`links >= ${minCount}`);
+    if (expectedCount !== void 0) parts.push(`probed links = ${expectedCount}`);
+    else if (minCount !== void 0) parts.push(`probed links >= ${minCount}`);
     if (minBytes !== void 0) parts.push(`bytes >= ${minBytes}`);
     if (selector && parts.length) return `${markdownInlineCode(selector)} ${parts.join(", ")}`;
     return selector ? markdownInlineCode(selector) : parts.join(", ") || void 0;
@@ -651,6 +651,7 @@ function profileLinkStatusSummaryMarkdown(result) {
     const selector = cliString(evidence.selector);
     const viewports = Array.isArray(evidence.viewports) ? evidence.viewports.map(cliRecord).filter((viewport) => Boolean(viewport)) : [];
     const totals = viewports.map((viewport) => cliFiniteNumber(viewport.total_count)).filter((count) => count !== void 0);
+    const discoveredTotals = viewports.map((viewport) => cliFiniteNumber(viewport.discovered_count)).filter((count) => count !== void 0);
     const okTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.ok_count) || 0), 0);
     const failedTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.failed_count) || 0), 0);
     const truncatedTotal = viewports.filter((viewport) => viewport.truncated === true).length;
@@ -658,8 +659,9 @@ function profileLinkStatusSummaryMarkdown(result) {
     const minBytes = cliFiniteNumber(evidence.min_bytes);
     const allowedContentTypes = Array.isArray(evidence.allowed_content_types) ? evidence.allowed_content_types.map(cliString).filter((value) => Boolean(value)) : [];
     const countText = totals.length ? totals.join("/") : "unknown";
+    const discoveredText = discoveredTotals.length && discoveredTotals.some((count, index) => count !== totals[index]) ? `, discovered ${discoveredTotals.join("/")}` : "";
     lines.push(
-      `- ${label}${selector ? ` ${markdownInlineCode(selector)}` : ""}: links ${countText}, ok ${okTotal}, failures ${failedTotal}${omittedTotal ? `, compacted ${omittedTotal} result row(s)` : ""}${truncatedTotal ? `, truncated viewports ${truncatedTotal}` : ""}${minBytes !== void 0 ? `, min bytes ${minBytes}` : ""}${allowedContentTypes.length ? `, content types ${allowedContentTypes.map((value) => markdownInlineCode(value)).join(", ")}` : ""}`
+      `- ${label}${selector ? ` ${markdownInlineCode(selector)}` : ""}: probed links ${countText}${discoveredText}, ok ${okTotal}, failures ${failedTotal}${omittedTotal ? `, compacted ${omittedTotal} result row(s)` : ""}${truncatedTotal ? `, truncated viewports ${truncatedTotal}` : ""}${minBytes !== void 0 ? `, min bytes ${minBytes}` : ""}${allowedContentTypes.length ? `, content types ${allowedContentTypes.map((value) => markdownInlineCode(value)).join(", ")}` : ""}`
     );
   }
   return lines;

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: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "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: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "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: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "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: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "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: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "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: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
     state_path: string;
     stage: any;
     summary: string;

package/package.json

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