@riddledc/riddle-proof 0.7.67 → 0.7.68

package/README.md

@@ -468,8 +468,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/cli.cjs

@@ -11194,6 +11194,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 +11247,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

@@ -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/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.68",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",