@riddledc/riddle-proof 0.7.71 → 0.7.73

package/dist/cli.cjs

@@ -10980,7 +10980,7 @@ function usage() {
     "  riddle-proof-loop respond --state-path <path> --response-json <file|json|->",
     "  riddle-proof-loop respond --state-path <path> --decision <decision> --summary <text> [--payload-json <file|json|->]",
     "  riddle-proof-loop status --state-path <path>",
-    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--strict true|false] [--output <dir>] [--quiet]",
+    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--strict true|false] [--poll-attempts n] [--output <dir>] [--quiet]",
     "  riddle-proof-loop riddle-preview-deploy <build-dir> <label>",
     "  riddle-proof-loop riddle-server-preview <directory> --script-file <file> [--path /route] [--wait-for-selector selector]",
     "  riddle-proof-loop riddle-run-script --url <url> --script-file <file> [--viewport 1280x720] [--strict true|false]",
@@ -11032,6 +11032,13 @@ function optionBoolean(options, key) {
   const flag = key.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
   throw new Error(`--${flag} must be true or false.`);
 }
+function optionNumber(options, ...keys) {
+  for (const key of keys) {
+    const value = optionString(options, key);
+    if (value !== void 0) return Number(value);
+  }
+  return void 0;
+}
 function readStdin() {
   return (0, import_node_fs6.readFileSync)(0, "utf-8");
 }
@@ -11256,6 +11263,10 @@ function profileResultMarkdown(result) {
   if (networkMockSummaryLines.length) {
     lines.push("", "## Network Mocks", "", ...networkMockSummaryLines);
   }
+  const routeInventorySummaryLines = profileRouteInventorySummaryMarkdown(result);
+  if (routeInventorySummaryLines.length) {
+    lines.push("", "## Route Inventory", "", ...routeInventorySummaryLines);
+  }
   if (result.artifacts.riddle_artifacts?.length) {
     lines.push("", "## Riddle Artifacts", "");
     for (const artifact of result.artifacts.riddle_artifacts.slice(0, 40)) {
@@ -11274,6 +11285,9 @@ function cliFiniteNumber(value) {
 function cliString(value) {
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
+function cliStringArray(value) {
+  return Array.isArray(value) ? value.filter((entry) => typeof entry === "string" && Boolean(entry.trim())) : [];
+}
 function profileSetupSummaryMarkdown(result) {
   const setupCheck = result.checks.find((check) => check.type === "setup_actions_succeeded");
   const setupSummary = cliRecord(setupCheck?.evidence?.setup_summary);
@@ -11355,6 +11369,46 @@ function profileNetworkMockSummaryMarkdown(result) {
   if (labels.length > 16) lines.push(`- ${labels.length - 16} additional network mock label(s) omitted from summary.`);
   return lines;
 }
+function profileRouteInventorySummaryMarkdown(result) {
+  const routeInventoryChecks = result.checks.filter((check) => check.type === "route_inventory");
+  const lines = [];
+  for (const check of routeInventoryChecks) {
+    const evidence = cliRecord(check.evidence);
+    if (!evidence) continue;
+    const label = check.label || check.type;
+    const expectedCount = cliFiniteNumber(evidence.expected_count);
+    const sourceLinkCount = cliFiniteNumber(evidence.source_link_count);
+    const sourceUniqueLinkCount = cliFiniteNumber(evidence.source_unique_link_count);
+    const directRouteCount = cliFiniteNumber(evidence.direct_route_count);
+    const clickthroughCount = cliFiniteNumber(evidence.clickthrough_count);
+    const topLevelFailures = Array.isArray(evidence.failures) ? evidence.failures.length : void 0;
+    const viewports = Array.isArray(evidence.viewports) ? evidence.viewports.map(cliRecord).filter((viewport) => Boolean(viewport)) : [];
+    const viewportFailureTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.failure_count) || 0), 0);
+    const failureCount = topLevelFailures === void 0 ? viewportFailureTotal : topLevelFailures;
+    lines.push(
+      `- ${label}: expected ${expectedCount ?? "unknown"}, source links ${sourceLinkCount ?? "unknown"}${sourceUniqueLinkCount === void 0 ? "" : ` (${sourceUniqueLinkCount} unique)`}, direct ${directRouteCount ?? "unknown"}, clickthrough ${clickthroughCount ?? "unknown"}, failures ${failureCount}`
+    );
+    const duplicateCount = cliFiniteNumber(evidence.duplicate_source_link_count) || 0;
+    const duplicateLinks = cliStringArray(evidence.duplicate_source_links);
+    if (duplicateCount || duplicateLinks.length) {
+      const duplicateText = duplicateLinks.length ? `: ${duplicateLinks.slice(0, 8).join(", ")}${duplicateLinks.length > 8 ? `, ${duplicateLinks.length - 8} more` : ""}` : "";
+      lines.push(`- ${label} duplicate source links: ${duplicateCount}${evidence.duplicates_allowed === true ? " allowed" : ""}${duplicateText}`);
+    }
+    for (const viewport of viewports.slice(0, 8)) {
+      const viewportName = cliString(viewport.viewport) || cliString(viewport.name) || "viewport";
+      const viewportSourceLinkCount = cliFiniteNumber(viewport.source_link_count);
+      const viewportSourceUniqueLinkCount = cliFiniteNumber(viewport.source_unique_link_count);
+      const viewportDirectRouteCount = cliFiniteNumber(viewport.direct_route_count);
+      const viewportClickthroughCount = cliFiniteNumber(viewport.clickthrough_count);
+      const viewportFailureCount = cliFiniteNumber(viewport.failure_count) || 0;
+      lines.push(
+        `- ${label} ${viewportName}: source ${viewportSourceLinkCount ?? "unknown"}${viewportSourceUniqueLinkCount === void 0 ? "" : ` (${viewportSourceUniqueLinkCount} unique)`}, direct ${viewportDirectRouteCount ?? "unknown"}, clickthrough ${viewportClickthroughCount ?? "unknown"}, failures ${viewportFailureCount}`
+      );
+    }
+    if (viewports.length > 8) lines.push(`- ${label}: ${viewports.length - 8} additional viewport(s) omitted from route inventory summary.`);
+  }
+  return lines;
+}
 function writeProfileOutput(outputDir, result) {
   if (!outputDir) return;
   (0, import_node_fs6.mkdirSync)(outputDir, { recursive: true });
@@ -11449,9 +11503,9 @@ async function runProfileForCli(profile, options) {
   }
   const poll = await client.pollJob(jobId, {
     wait: true,
-    attempts: optionString(options, "attempts") ? Number(optionString(options, "attempts")) : void 0,
-    intervalMs: optionString(options, "intervalMs") ? Number(optionString(options, "intervalMs")) : void 0,
-    progressEveryMs: optionString(options, "progressEveryMs") ? Number(optionString(options, "progressEveryMs")) : void 0,
+    attempts: optionNumber(options, "pollAttempts", "attempts"),
+    intervalMs: optionNumber(options, "intervalMs"),
+    progressEveryMs: optionNumber(options, "progressEveryMs"),
     onProgress: options.quiet !== true ? (snapshot) => {
       process.stderr.write(`${riddlePollProgressLine(snapshot)}
 `);

package/dist/cli.js

@@ -44,7 +44,7 @@ function usage() {
     "  riddle-proof-loop respond --state-path <path> --response-json <file|json|->",
     "  riddle-proof-loop respond --state-path <path> --decision <decision> --summary <text> [--payload-json <file|json|->]",
     "  riddle-proof-loop status --state-path <path>",
-    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--strict true|false] [--output <dir>] [--quiet]",
+    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--strict true|false] [--poll-attempts n] [--output <dir>] [--quiet]",
     "  riddle-proof-loop riddle-preview-deploy <build-dir> <label>",
     "  riddle-proof-loop riddle-server-preview <directory> --script-file <file> [--path /route] [--wait-for-selector selector]",
     "  riddle-proof-loop riddle-run-script --url <url> --script-file <file> [--viewport 1280x720] [--strict true|false]",
@@ -96,6 +96,13 @@ function optionBoolean(options, key) {
   const flag = key.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
   throw new Error(`--${flag} must be true or false.`);
 }
+function optionNumber(options, ...keys) {
+  for (const key of keys) {
+    const value = optionString(options, key);
+    if (value !== void 0) return Number(value);
+  }
+  return void 0;
+}
 function readStdin() {
   return readFileSync(0, "utf-8");
 }
@@ -320,6 +327,10 @@ function profileResultMarkdown(result) {
   if (networkMockSummaryLines.length) {
     lines.push("", "## Network Mocks", "", ...networkMockSummaryLines);
   }
+  const routeInventorySummaryLines = profileRouteInventorySummaryMarkdown(result);
+  if (routeInventorySummaryLines.length) {
+    lines.push("", "## Route Inventory", "", ...routeInventorySummaryLines);
+  }
   if (result.artifacts.riddle_artifacts?.length) {
     lines.push("", "## Riddle Artifacts", "");
     for (const artifact of result.artifacts.riddle_artifacts.slice(0, 40)) {
@@ -338,6 +349,9 @@ function cliFiniteNumber(value) {
 function cliString(value) {
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
+function cliStringArray(value) {
+  return Array.isArray(value) ? value.filter((entry) => typeof entry === "string" && Boolean(entry.trim())) : [];
+}
 function profileSetupSummaryMarkdown(result) {
   const setupCheck = result.checks.find((check) => check.type === "setup_actions_succeeded");
   const setupSummary = cliRecord(setupCheck?.evidence?.setup_summary);
@@ -419,6 +433,46 @@ function profileNetworkMockSummaryMarkdown(result) {
   if (labels.length > 16) lines.push(`- ${labels.length - 16} additional network mock label(s) omitted from summary.`);
   return lines;
 }
+function profileRouteInventorySummaryMarkdown(result) {
+  const routeInventoryChecks = result.checks.filter((check) => check.type === "route_inventory");
+  const lines = [];
+  for (const check of routeInventoryChecks) {
+    const evidence = cliRecord(check.evidence);
+    if (!evidence) continue;
+    const label = check.label || check.type;
+    const expectedCount = cliFiniteNumber(evidence.expected_count);
+    const sourceLinkCount = cliFiniteNumber(evidence.source_link_count);
+    const sourceUniqueLinkCount = cliFiniteNumber(evidence.source_unique_link_count);
+    const directRouteCount = cliFiniteNumber(evidence.direct_route_count);
+    const clickthroughCount = cliFiniteNumber(evidence.clickthrough_count);
+    const topLevelFailures = Array.isArray(evidence.failures) ? evidence.failures.length : void 0;
+    const viewports = Array.isArray(evidence.viewports) ? evidence.viewports.map(cliRecord).filter((viewport) => Boolean(viewport)) : [];
+    const viewportFailureTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.failure_count) || 0), 0);
+    const failureCount = topLevelFailures === void 0 ? viewportFailureTotal : topLevelFailures;
+    lines.push(
+      `- ${label}: expected ${expectedCount ?? "unknown"}, source links ${sourceLinkCount ?? "unknown"}${sourceUniqueLinkCount === void 0 ? "" : ` (${sourceUniqueLinkCount} unique)`}, direct ${directRouteCount ?? "unknown"}, clickthrough ${clickthroughCount ?? "unknown"}, failures ${failureCount}`
+    );
+    const duplicateCount = cliFiniteNumber(evidence.duplicate_source_link_count) || 0;
+    const duplicateLinks = cliStringArray(evidence.duplicate_source_links);
+    if (duplicateCount || duplicateLinks.length) {
+      const duplicateText = duplicateLinks.length ? `: ${duplicateLinks.slice(0, 8).join(", ")}${duplicateLinks.length > 8 ? `, ${duplicateLinks.length - 8} more` : ""}` : "";
+      lines.push(`- ${label} duplicate source links: ${duplicateCount}${evidence.duplicates_allowed === true ? " allowed" : ""}${duplicateText}`);
+    }
+    for (const viewport of viewports.slice(0, 8)) {
+      const viewportName = cliString(viewport.viewport) || cliString(viewport.name) || "viewport";
+      const viewportSourceLinkCount = cliFiniteNumber(viewport.source_link_count);
+      const viewportSourceUniqueLinkCount = cliFiniteNumber(viewport.source_unique_link_count);
+      const viewportDirectRouteCount = cliFiniteNumber(viewport.direct_route_count);
+      const viewportClickthroughCount = cliFiniteNumber(viewport.clickthrough_count);
+      const viewportFailureCount = cliFiniteNumber(viewport.failure_count) || 0;
+      lines.push(
+        `- ${label} ${viewportName}: source ${viewportSourceLinkCount ?? "unknown"}${viewportSourceUniqueLinkCount === void 0 ? "" : ` (${viewportSourceUniqueLinkCount} unique)`}, direct ${viewportDirectRouteCount ?? "unknown"}, clickthrough ${viewportClickthroughCount ?? "unknown"}, failures ${viewportFailureCount}`
+      );
+    }
+    if (viewports.length > 8) lines.push(`- ${label}: ${viewports.length - 8} additional viewport(s) omitted from route inventory summary.`);
+  }
+  return lines;
+}
 function writeProfileOutput(outputDir, result) {
   if (!outputDir) return;
   mkdirSync(outputDir, { recursive: true });
@@ -513,9 +567,9 @@ async function runProfileForCli(profile, options) {
   }
   const poll = await client.pollJob(jobId, {
     wait: true,
-    attempts: optionString(options, "attempts") ? Number(optionString(options, "attempts")) : void 0,
-    intervalMs: optionString(options, "intervalMs") ? Number(optionString(options, "intervalMs")) : void 0,
-    progressEveryMs: optionString(options, "progressEveryMs") ? Number(optionString(options, "progressEveryMs")) : void 0,
+    attempts: optionNumber(options, "pollAttempts", "attempts"),
+    intervalMs: optionNumber(options, "intervalMs"),
+    progressEveryMs: optionNumber(options, "progressEveryMs"),
     onProgress: options.quiet !== true ? (snapshot) => {
       process.stderr.write(`${riddlePollProgressLine(snapshot)}
 `);

package/package.json

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