@riddledc/riddle-proof 0.8.71 → 0.8.73

package/README.md

@@ -226,6 +226,12 @@ split viewport matrix, the preflight estimates the 30-second hosted minimum per
 viewport and returns an `environment_blocked` result without starting partial
 jobs when the account balance cannot cover the intended sweep. Use
 `--balance-preflight=false` to bypass this check.
+Hosted runs also preflight profile artifact requirements before spending a
+browser job. `artifact_manifest` / `artifact-manifest.json` are local runner
+receipts, so a hosted profile that requires them returns `configuration_error`
+with an explanation instead of submitting a job. Hosted profiles should require
+only artifacts the hosted browser run produces: `screenshot`, `console`,
+`dom_summary`, and `proof_json`.
 
 ## Regression Packs
 
@@ -539,6 +545,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.
+Target-level `wait_for_selector` runs immediately after navigation and before
+`setup_actions`. If setup creates the ready state, for example by seeding
+localStorage and reloading an authenticated fixture, put the readiness wait in
+`setup_actions` after the state change instead.
 For canvas games that read key state rather than keypress events, add `hold_ms`
 or `holdMs` to keep the key down before releasing it. When the profile needs
 to observe or wait on runtime evidence while a key remains held, use paired

package/dist/{chunk-EX7TO4I5.js → chunk-GG2D3MFZ.js}

@@ -3486,6 +3486,35 @@ function profileStatusFromEvidence(profile, evidence, checks) {
   if (checks.some((check) => check.status === "failed")) return "product_regression";
   return "passed";
 }
+var RIDDLE_PROOF_HOSTED_PROFILE_ARTIFACTS = [
+  "screenshot",
+  "console",
+  "dom_summary",
+  "proof_json"
+];
+function preflightRiddleProofProfileRunnerArtifacts(profile, runner) {
+  const requested = uniqueNonEmptyStrings(profile.artifacts || []);
+  if (runner !== "riddle") {
+    return {
+      ok: true,
+      runner,
+      requested,
+      local_only: [],
+      hosted_artifacts: [...RIDDLE_PROOF_HOSTED_PROFILE_ARTIFACTS]
+    };
+  }
+  const localOnly = requested.filter(profileArtifactIsHostedLocalOnly);
+  const subject = localOnly.join(", ");
+  const message = localOnly.length ? `${subject} ${localOnly.length === 1 ? "is" : "are"} local-runner output; hosted runs produce proof_json, console, dom_summary, and screenshots. Remove ${localOnly.length === 1 ? "it" : "them"} from profile.artifacts for --runner riddle.` : void 0;
+  return {
+    ok: localOnly.length === 0,
+    runner,
+    requested,
+    local_only: localOnly,
+    hosted_artifacts: [...RIDDLE_PROOF_HOSTED_PROFILE_ARTIFACTS],
+    message
+  };
+}
 function assessRiddleProofProfileArtifactCompleteness(profile, result, artifacts) {
   const required = profileRequiredArtifactKeys(profile, result);
   const missing = required.filter((key) => !profileArtifactKeyPresent(key, artifacts));
@@ -3550,6 +3579,16 @@ function normalizeProfileArtifactRole(input) {
   if (normalized === "proof" || normalized === "proof_json" || normalized === "proof.json") return "proof.json";
   return normalizeRiddleProfileArtifactName(input.trim()).toLowerCase();
 }
+function profileArtifactIsHostedLocalOnly(input) {
+  const raw = input.trim().toLowerCase();
+  const normalized = raw.replace(/[\s-]+/g, "_");
+  const role = normalizeProfileArtifactRole(input);
+  return [
+    raw,
+    normalized,
+    role
+  ].some((value) => value === "artifact_manifest" || value === "artifact_manifest.json" || value === "artifact-manifest" || value === "artifact-manifest.json");
+}
 function profileArtifactKeyPresent(key, artifacts) {
   if (key.startsWith("screenshot:")) {
     const label = key.slice("screenshot:".length);
@@ -3641,19 +3680,32 @@ function profileStatusExitCode(profile, status) {
   if (status === "passed") return 0;
   return profile.failure_policy[status] === "neutral" ? 0 : 1;
 }
-function createRiddleProofProfileConfigurationError(name, error, runner = "riddle") {
+function createRiddleProofProfileConfigurationError(profileOrName, error, runner = "riddle", options = {}) {
+  const profile = typeof profileOrName === "string" ? void 0 : profileOrName;
+  const name = profile ? profile.name : String(profileOrName);
   const message = error instanceof Error ? error.message : String(error);
+  let requested = "";
+  if (profile) {
+    try {
+      requested = resolveRiddleProofProfileTargetUrl(profile);
+    } catch {
+      requested = "";
+    }
+  }
   return {
     version: RIDDLE_PROOF_PROFILE_RESULT_VERSION,
     profile_name: name,
     runner,
     status: "configuration_error",
-    baseline_policy: "invariant_only",
-    route: { requested: "", observed: "", matched: false, error: message },
+    baseline_policy: profile?.baseline_policy || "invariant_only",
+    route: { requested, observed: "", matched: false, error: message },
     artifacts: { screenshots: [], proof_json: "proof.json" },
     checks: [],
     summary: `${name} has a profile configuration error.`,
     captured_at: (/* @__PURE__ */ new Date()).toISOString(),
+    metadata: profile?.metadata,
+    warnings: options.warnings?.length ? options.warnings : void 0,
+    configuration_blocker: options.configurationBlocker,
     error: message
   };
 }
@@ -9564,6 +9616,8 @@ export {
   resolveRiddleProofProfileTimeoutSec,
   preflightRiddleProofProfileHttpStatusChecks,
   resolveRiddleProofProfileRouteUrl,
+  RIDDLE_PROOF_HOSTED_PROFILE_ARTIFACTS,
+  preflightRiddleProofProfileRunnerArtifacts,
   assessRiddleProofProfileArtifactCompleteness,
   applyRiddleProofProfileArtifactCompleteness,
   assessRiddleProofProfileEvidence,

package/dist/{chunk-RJVA5KKM.js → chunk-ICIJTEHD.js}

@@ -11,23 +11,25 @@ import {
 } from "./chunk-CWRIXP5H.js";
 import {
   suggestRiddleProofProfileChecks
-} from "./chunk-5Y4V2IXI.js";
+} from "./chunk-UE4I7RTI.js";
 import {
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,
   applyRiddleProofProfileArtifactCompleteness,
   assessRiddleProofProfileEvidence,
   buildRiddleProofProfileScript,
   collectRiddleProfileArtifactRefs,
+  createRiddleProofProfileConfigurationError,
   createRiddleProofProfileEnvironmentBlockedResult,
   createRiddleProofProfileInsufficientResult,
   deriveRiddleProofArtifactBodyAssertions,
   extractRiddleProofProfileResult,
   normalizeRiddleProofProfile,
   preflightRiddleProofProfileHttpStatusChecks,
+  preflightRiddleProofProfileRunnerArtifacts,
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-EX7TO4I5.js";
+} from "./chunk-GG2D3MFZ.js";
 import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
@@ -321,6 +323,7 @@ function compactRunProfileResult(result, options) {
     checks: compactProfileChecks(result),
     warnings: result.warnings,
     environment_blocker: result.environment_blocker,
+    configuration_blocker: result.configuration_blocker,
     metadata: result.metadata,
     riddle: result.riddle,
     artifacts: result.artifacts,
@@ -1256,15 +1259,83 @@ function profileHttpStatusPreflightSummary(result) {
   return `${lines.join("\n")}
 `;
 }
+function profilePlainStatusLabel(status) {
+  if (status === "passed") return "passed";
+  if (status === "product_regression") return "product issue";
+  if (status === "proof_insufficient") return "missing evidence";
+  if (status === "environment_blocked") return "environment blocked";
+  if (status === "configuration_error") return "configuration issue";
+  return "needs review";
+}
+function profilePlainCheckSummary(result) {
+  const total = result.checks.length;
+  const passed = result.checks.filter((check) => check.status === "passed").length;
+  const failed = result.checks.filter((check) => check.status === "failed").length;
+  const review = result.checks.filter((check) => check.status === "needs_human_review").length;
+  const skipped = result.checks.filter((check) => check.status === "skipped").length;
+  const evidenceViewportNames = (result.evidence?.viewports || []).map((viewport) => cliString(viewport.name)).filter((name) => Boolean(name));
+  const setupViewportNames = evidenceViewportNames.length ? [] : profileSetupSummaryViewports(result).map((viewport) => cliString(viewport.name)).filter((name) => Boolean(name));
+  const viewportNames = evidenceViewportNames.length ? evidenceViewportNames : setupViewportNames;
+  const route = result.route?.requested || result.route?.observed;
+  const countText = total === 1 ? "1 check" : `${total} checks`;
+  const viewportText = viewportNames.length ? ` across ${viewportNames.length} viewport${viewportNames.length === 1 ? "" : "s"} (${viewportNames.join(", ")})` : "";
+  const routeText = route ? ` on ${markdownInlineCode(route, 120)}` : "";
+  const outcomes = [
+    passed ? `${passed} passed` : "",
+    failed ? `${failed} failed` : "",
+    review ? `${review} needs review` : "",
+    skipped ? `${skipped} skipped` : ""
+  ].filter(Boolean).join(", ");
+  if (!total) return route ? `No browser checks were recorded for ${markdownInlineCode(route, 120)}.` : "No browser checks were recorded.";
+  return `${countText}${viewportText}${routeText}; ${outcomes || "no completed checks"}.`;
+}
+function profileArtifactRefIsScreenshot(artifact) {
+  const kind = cliString(artifact.kind)?.toLowerCase() || "";
+  const contentType = cliString(artifact.content_type)?.toLowerCase() || "";
+  const text = [artifact.name, artifact.url, artifact.path].map((value) => cliString(value)).filter(Boolean).join(" ");
+  return kind === "screenshot" || contentType.startsWith("image/") || /\.(png|jpe?g|webp)(?:$|[?#])/i.test(text);
+}
+function profileArtifactDisplay(artifact) {
+  const name = artifact.name || artifact.kind || "artifact";
+  const location = artifact.url || artifact.path;
+  return location ? `${name}: ${location}` : name;
+}
+function profilePlainArtifactSummary(result) {
+  const hostedArtifacts = result.artifacts.riddle_artifacts || [];
+  const hostedScreenshot = hostedArtifacts.find(profileArtifactRefIsScreenshot);
+  if (hostedScreenshot) return `Hosted screenshot ${profileArtifactDisplay(hostedScreenshot)}`;
+  const hostedProof = hostedArtifacts.find((artifact) => {
+    const name = (artifact.name || artifact.url || artifact.path || "").toLowerCase();
+    return name.includes("proof.json");
+  });
+  if (hostedProof) return `Hosted proof JSON ${profileArtifactDisplay(hostedProof)}`;
+  if (result.artifacts.screenshots?.length) return `Screenshot ${markdownInlineCode(result.artifacts.screenshots[0])}`;
+  if (result.artifacts.proof_json) return `Proof JSON ${markdownInlineCode(result.artifacts.proof_json)}`;
+  return "profile-result.json and summary.md";
+}
+function profilePlainNextStep(result) {
+  if (result.status === "passed") return "Use this packet as scoped browser evidence, then review the linked artifacts before merge.";
+  if (result.status === "product_regression") return "Fix the failed product check(s), then rerun this profile.";
+  if (result.status === "proof_insufficient") return "Adjust the profile or runner so the required evidence artifacts are produced, then rerun.";
+  if (result.status === "environment_blocked") return "Fix the runner or environment blocker, then rerun.";
+  if (result.status === "configuration_error") return result.error ? `Fix the profile setup: ${result.error}` : "Fix the profile setup, then rerun.";
+  return "Review the artifacts manually, then refine the profile if the verdict should be automated.";
+}
 function profileResultMarkdown(result) {
   const lines = [
     `# Riddle Proof Profile: ${result.profile_name}`,
     "",
-    `Status: ${result.status}`,
-    `Runner: ${result.runner}`,
-    `Captured: ${result.captured_at}`,
+    `Result: ${profilePlainStatusLabel(result.status)}`,
+    `What was checked: ${profilePlainCheckSummary(result)}`,
+    `Artifact that proves it: ${profilePlainArtifactSummary(result)}`,
+    `What to do next: ${profilePlainNextStep(result)}`,
     "",
-    result.summary,
+    "## Details",
+    "",
+    `- Status: ${result.status}`,
+    `- Runner: ${result.runner}`,
+    `- Captured: ${result.captured_at}`,
+    `- Summary: ${result.summary}`,
     ""
   ];
   if (Array.isArray(result.warnings) && result.warnings.length) {
@@ -1316,6 +1387,10 @@ function profileResultMarkdown(result) {
   if (httpStatusSummaryLines.length) {
     lines.push("", "## HTTP Status", "", ...httpStatusSummaryLines);
   }
+  const configurationBlockerLines = profileConfigurationBlockerMarkdown(result);
+  if (configurationBlockerLines.length) {
+    lines.push("", "## Configuration Blocker", "", ...configurationBlockerLines);
+  }
   const environmentBlockerLines = profileEnvironmentBlockerMarkdown(result);
   if (environmentBlockerLines.length) {
     lines.push("", "## Environment Blocker", "", ...environmentBlockerLines);
@@ -3166,7 +3241,26 @@ function profileEnvironmentBlockerMarkdown(result) {
   if (apiKeySource) lines.push(`- auth: ${apiKeySource}${apiKeyFile ? ` ${apiKeyFile}` : ""}`);
   return lines;
 }
+function profileConfigurationBlockerMarkdown(result) {
+  const blocker = cliRecord(result.configuration_blocker);
+  if (!blocker) return [];
+  const lines = [];
+  const reason = cliString(blocker.reason);
+  const source = cliString(blocker.source);
+  const requestedArtifacts = cliStringArray(blocker.requested_artifacts);
+  const localOnlyArtifacts = cliStringArray(blocker.local_only_artifacts);
+  const hostedArtifacts = cliStringArray(blocker.hosted_artifacts);
+  if (reason) lines.push(`- reason: ${reason}`);
+  if (source) lines.push(`- source: ${source}`);
+  if (localOnlyArtifacts.length) lines.push(`- local-only artifact(s): ${localOnlyArtifacts.map((value) => markdownInlineCode(value)).join(", ")}`);
+  if (hostedArtifacts.length) lines.push(`- hosted artifact(s): ${hostedArtifacts.map((value) => markdownInlineCode(value)).join(", ")}`);
+  if (requestedArtifacts.length) lines.push(`- requested artifact(s): ${requestedArtifacts.map((value) => markdownInlineCode(value)).join(", ")}`);
+  return lines;
+}
 function profileCliDiagnosticLine(result) {
+  if (result.status === "configuration_error") {
+    return result.error ? `[riddle-profile] configuration_error: ${result.error}` : void 0;
+  }
   if (result.status !== "environment_blocked") return void 0;
   const blocker = cliRecord(result.environment_blocker);
   if (blocker?.reason === "insufficient_balance") {
@@ -4635,6 +4729,20 @@ async function runProfileForCli(profile, options) {
   if (runner !== "riddle") {
     throw new Error(`Unsupported --runner ${runner}. The current CLI supports --runner riddle.`);
   }
+  const artifactPreflight = preflightRiddleProofProfileRunnerArtifacts(profile, runner);
+  if (!artifactPreflight.ok) {
+    const message = artifactPreflight.message || "Profile artifacts are not supported by the selected runner.";
+    return createRiddleProofProfileConfigurationError(profile, message, runner, {
+      warnings: [message],
+      configurationBlocker: {
+        source: "profile_artifacts",
+        reason: "local_only_artifact_requested",
+        requested_artifacts: artifactPreflight.requested,
+        local_only_artifacts: artifactPreflight.local_only,
+        hosted_artifacts: artifactPreflight.hosted_artifacts
+      }
+    });
+  }
   const client = createRiddleApiClient(riddleClientConfig(options));
   const balanceBlocked = await preflightRiddleProfileBalanceForCli(profile, options, { client, runner });
   if (balanceBlocked) return balanceBlocked;

package/dist/{chunk-5Y4V2IXI.js → chunk-UE4I7RTI.js}

@@ -1,6 +1,6 @@
 import {
   RIDDLE_PROOF_PROFILE_VERSION
-} from "./chunk-EX7TO4I5.js";
+} from "./chunk-GG2D3MFZ.js";
 
 // src/profile-suggestions.ts
 var RIDDLE_PROOF_PROFILE_SUGGESTIONS_VERSION = "riddle-proof.profile-suggestions.v1";

package/dist/cli/index.js

@@ -1,8 +1,8 @@
-import "../chunk-RJVA5KKM.js";
+import "../chunk-ICIJTEHD.js";
 import "../chunk-B2DP2LET.js";
 import "../chunk-CWRIXP5H.js";
-import "../chunk-5Y4V2IXI.js";
-import "../chunk-EX7TO4I5.js";
+import "../chunk-UE4I7RTI.js";
+import "../chunk-GG2D3MFZ.js";
 import "../chunk-WLUMLHII.js";
 import "../chunk-CGJX7LJO.js";
 import "../chunk-UTCL7FEZ.js";

package/dist/cli.cjs

@@ -11948,6 +11948,35 @@ function profileStatusFromEvidence(profile, evidence, checks) {
   if (checks.some((check) => check.status === "failed")) return "product_regression";
   return "passed";
 }
+var RIDDLE_PROOF_HOSTED_PROFILE_ARTIFACTS = [
+  "screenshot",
+  "console",
+  "dom_summary",
+  "proof_json"
+];
+function preflightRiddleProofProfileRunnerArtifacts(profile, runner) {
+  const requested = uniqueNonEmptyStrings(profile.artifacts || []);
+  if (runner !== "riddle") {
+    return {
+      ok: true,
+      runner,
+      requested,
+      local_only: [],
+      hosted_artifacts: [...RIDDLE_PROOF_HOSTED_PROFILE_ARTIFACTS]
+    };
+  }
+  const localOnly = requested.filter(profileArtifactIsHostedLocalOnly);
+  const subject = localOnly.join(", ");
+  const message = localOnly.length ? `${subject} ${localOnly.length === 1 ? "is" : "are"} local-runner output; hosted runs produce proof_json, console, dom_summary, and screenshots. Remove ${localOnly.length === 1 ? "it" : "them"} from profile.artifacts for --runner riddle.` : void 0;
+  return {
+    ok: localOnly.length === 0,
+    runner,
+    requested,
+    local_only: localOnly,
+    hosted_artifacts: [...RIDDLE_PROOF_HOSTED_PROFILE_ARTIFACTS],
+    message
+  };
+}
 function assessRiddleProofProfileArtifactCompleteness(profile, result, artifacts) {
   const required = profileRequiredArtifactKeys(profile, result);
   const missing = required.filter((key) => !profileArtifactKeyPresent(key, artifacts));
@@ -12012,6 +12041,16 @@ function normalizeProfileArtifactRole(input) {
   if (normalized === "proof" || normalized === "proof_json" || normalized === "proof.json") return "proof.json";
   return normalizeRiddleProfileArtifactName(input.trim()).toLowerCase();
 }
+function profileArtifactIsHostedLocalOnly(input) {
+  const raw = input.trim().toLowerCase();
+  const normalized = raw.replace(/[\s-]+/g, "_");
+  const role = normalizeProfileArtifactRole(input);
+  return [
+    raw,
+    normalized,
+    role
+  ].some((value) => value === "artifact_manifest" || value === "artifact_manifest.json" || value === "artifact-manifest" || value === "artifact-manifest.json");
+}
 function profileArtifactKeyPresent(key, artifacts) {
   if (key.startsWith("screenshot:")) {
     const label = key.slice("screenshot:".length);
@@ -12103,6 +12142,35 @@ function profileStatusExitCode(profile, status) {
   if (status === "passed") return 0;
   return profile.failure_policy[status] === "neutral" ? 0 : 1;
 }
+function createRiddleProofProfileConfigurationError(profileOrName, error, runner = "riddle", options = {}) {
+  const profile = typeof profileOrName === "string" ? void 0 : profileOrName;
+  const name = profile ? profile.name : String(profileOrName);
+  const message = error instanceof Error ? error.message : String(error);
+  let requested = "";
+  if (profile) {
+    try {
+      requested = resolveRiddleProofProfileTargetUrl(profile);
+    } catch {
+      requested = "";
+    }
+  }
+  return {
+    version: RIDDLE_PROOF_PROFILE_RESULT_VERSION,
+    profile_name: name,
+    runner,
+    status: "configuration_error",
+    baseline_policy: profile?.baseline_policy || "invariant_only",
+    route: { requested, observed: "", matched: false, error: message },
+    artifacts: { screenshots: [], proof_json: "proof.json" },
+    checks: [],
+    summary: `${name} has a profile configuration error.`,
+    captured_at: (/* @__PURE__ */ new Date()).toISOString(),
+    metadata: profile?.metadata,
+    warnings: options.warnings?.length ? options.warnings : void 0,
+    configuration_blocker: options.configurationBlocker,
+    error: message
+  };
+}
 function createRiddleProofProfileEnvironmentBlockedResult(input) {
   const message = input.error instanceof Error ? input.error.message : input.error ? String(input.error) : "Riddle runner did not complete successfully.";
   const environmentBlocker = input.environmentBlocker || extractRiddleRunnerBlocker(message);
@@ -18817,6 +18885,7 @@ function compactRunProfileResult(result, options) {
     checks: compactProfileChecks(result),
     warnings: result.warnings,
     environment_blocker: result.environment_blocker,
+    configuration_blocker: result.configuration_blocker,
     metadata: result.metadata,
     riddle: result.riddle,
     artifacts: result.artifacts,
@@ -19752,15 +19821,83 @@ function profileHttpStatusPreflightSummary(result) {
   return `${lines.join("\n")}
 `;
 }
+function profilePlainStatusLabel(status) {
+  if (status === "passed") return "passed";
+  if (status === "product_regression") return "product issue";
+  if (status === "proof_insufficient") return "missing evidence";
+  if (status === "environment_blocked") return "environment blocked";
+  if (status === "configuration_error") return "configuration issue";
+  return "needs review";
+}
+function profilePlainCheckSummary(result) {
+  const total = result.checks.length;
+  const passed = result.checks.filter((check) => check.status === "passed").length;
+  const failed = result.checks.filter((check) => check.status === "failed").length;
+  const review = result.checks.filter((check) => check.status === "needs_human_review").length;
+  const skipped = result.checks.filter((check) => check.status === "skipped").length;
+  const evidenceViewportNames = (result.evidence?.viewports || []).map((viewport) => cliString(viewport.name)).filter((name) => Boolean(name));
+  const setupViewportNames = evidenceViewportNames.length ? [] : profileSetupSummaryViewports(result).map((viewport) => cliString(viewport.name)).filter((name) => Boolean(name));
+  const viewportNames = evidenceViewportNames.length ? evidenceViewportNames : setupViewportNames;
+  const route = result.route?.requested || result.route?.observed;
+  const countText = total === 1 ? "1 check" : `${total} checks`;
+  const viewportText = viewportNames.length ? ` across ${viewportNames.length} viewport${viewportNames.length === 1 ? "" : "s"} (${viewportNames.join(", ")})` : "";
+  const routeText = route ? ` on ${markdownInlineCode(route, 120)}` : "";
+  const outcomes = [
+    passed ? `${passed} passed` : "",
+    failed ? `${failed} failed` : "",
+    review ? `${review} needs review` : "",
+    skipped ? `${skipped} skipped` : ""
+  ].filter(Boolean).join(", ");
+  if (!total) return route ? `No browser checks were recorded for ${markdownInlineCode(route, 120)}.` : "No browser checks were recorded.";
+  return `${countText}${viewportText}${routeText}; ${outcomes || "no completed checks"}.`;
+}
+function profileArtifactRefIsScreenshot2(artifact) {
+  const kind = cliString(artifact.kind)?.toLowerCase() || "";
+  const contentType = cliString(artifact.content_type)?.toLowerCase() || "";
+  const text = [artifact.name, artifact.url, artifact.path].map((value) => cliString(value)).filter(Boolean).join(" ");
+  return kind === "screenshot" || contentType.startsWith("image/") || /\.(png|jpe?g|webp)(?:$|[?#])/i.test(text);
+}
+function profileArtifactDisplay(artifact) {
+  const name = artifact.name || artifact.kind || "artifact";
+  const location = artifact.url || artifact.path;
+  return location ? `${name}: ${location}` : name;
+}
+function profilePlainArtifactSummary(result) {
+  const hostedArtifacts = result.artifacts.riddle_artifacts || [];
+  const hostedScreenshot = hostedArtifacts.find(profileArtifactRefIsScreenshot2);
+  if (hostedScreenshot) return `Hosted screenshot ${profileArtifactDisplay(hostedScreenshot)}`;
+  const hostedProof = hostedArtifacts.find((artifact) => {
+    const name = (artifact.name || artifact.url || artifact.path || "").toLowerCase();
+    return name.includes("proof.json");
+  });
+  if (hostedProof) return `Hosted proof JSON ${profileArtifactDisplay(hostedProof)}`;
+  if (result.artifacts.screenshots?.length) return `Screenshot ${markdownInlineCode(result.artifacts.screenshots[0])}`;
+  if (result.artifacts.proof_json) return `Proof JSON ${markdownInlineCode(result.artifacts.proof_json)}`;
+  return "profile-result.json and summary.md";
+}
+function profilePlainNextStep(result) {
+  if (result.status === "passed") return "Use this packet as scoped browser evidence, then review the linked artifacts before merge.";
+  if (result.status === "product_regression") return "Fix the failed product check(s), then rerun this profile.";
+  if (result.status === "proof_insufficient") return "Adjust the profile or runner so the required evidence artifacts are produced, then rerun.";
+  if (result.status === "environment_blocked") return "Fix the runner or environment blocker, then rerun.";
+  if (result.status === "configuration_error") return result.error ? `Fix the profile setup: ${result.error}` : "Fix the profile setup, then rerun.";
+  return "Review the artifacts manually, then refine the profile if the verdict should be automated.";
+}
 function profileResultMarkdown(result) {
   const lines = [
     `# Riddle Proof Profile: ${result.profile_name}`,
     "",
-    `Status: ${result.status}`,
-    `Runner: ${result.runner}`,
-    `Captured: ${result.captured_at}`,
+    `Result: ${profilePlainStatusLabel(result.status)}`,
+    `What was checked: ${profilePlainCheckSummary(result)}`,
+    `Artifact that proves it: ${profilePlainArtifactSummary(result)}`,
+    `What to do next: ${profilePlainNextStep(result)}`,
     "",
-    result.summary,
+    "## Details",
+    "",
+    `- Status: ${result.status}`,
+    `- Runner: ${result.runner}`,
+    `- Captured: ${result.captured_at}`,
+    `- Summary: ${result.summary}`,
     ""
   ];
   if (Array.isArray(result.warnings) && result.warnings.length) {
@@ -19812,6 +19949,10 @@ function profileResultMarkdown(result) {
   if (httpStatusSummaryLines.length) {
     lines.push("", "## HTTP Status", "", ...httpStatusSummaryLines);
   }
+  const configurationBlockerLines = profileConfigurationBlockerMarkdown(result);
+  if (configurationBlockerLines.length) {
+    lines.push("", "## Configuration Blocker", "", ...configurationBlockerLines);
+  }
   const environmentBlockerLines = profileEnvironmentBlockerMarkdown(result);
   if (environmentBlockerLines.length) {
     lines.push("", "## Environment Blocker", "", ...environmentBlockerLines);
@@ -21662,7 +21803,26 @@ function profileEnvironmentBlockerMarkdown(result) {
   if (apiKeySource) lines.push(`- auth: ${apiKeySource}${apiKeyFile ? ` ${apiKeyFile}` : ""}`);
   return lines;
 }
+function profileConfigurationBlockerMarkdown(result) {
+  const blocker = cliRecord(result.configuration_blocker);
+  if (!blocker) return [];
+  const lines = [];
+  const reason = cliString(blocker.reason);
+  const source = cliString(blocker.source);
+  const requestedArtifacts = cliStringArray(blocker.requested_artifacts);
+  const localOnlyArtifacts = cliStringArray(blocker.local_only_artifacts);
+  const hostedArtifacts = cliStringArray(blocker.hosted_artifacts);
+  if (reason) lines.push(`- reason: ${reason}`);
+  if (source) lines.push(`- source: ${source}`);
+  if (localOnlyArtifacts.length) lines.push(`- local-only artifact(s): ${localOnlyArtifacts.map((value) => markdownInlineCode(value)).join(", ")}`);
+  if (hostedArtifacts.length) lines.push(`- hosted artifact(s): ${hostedArtifacts.map((value) => markdownInlineCode(value)).join(", ")}`);
+  if (requestedArtifacts.length) lines.push(`- requested artifact(s): ${requestedArtifacts.map((value) => markdownInlineCode(value)).join(", ")}`);
+  return lines;
+}
 function profileCliDiagnosticLine(result) {
+  if (result.status === "configuration_error") {
+    return result.error ? `[riddle-profile] configuration_error: ${result.error}` : void 0;
+  }
   if (result.status !== "environment_blocked") return void 0;
   const blocker = cliRecord(result.environment_blocker);
   if (blocker?.reason === "insufficient_balance") {
@@ -23131,6 +23291,20 @@ async function runProfileForCli(profile, options) {
   if (runner !== "riddle") {
     throw new Error(`Unsupported --runner ${runner}. The current CLI supports --runner riddle.`);
   }
+  const artifactPreflight = preflightRiddleProofProfileRunnerArtifacts(profile, runner);
+  if (!artifactPreflight.ok) {
+    const message = artifactPreflight.message || "Profile artifacts are not supported by the selected runner.";
+    return createRiddleProofProfileConfigurationError(profile, message, runner, {
+      warnings: [message],
+      configurationBlocker: {
+        source: "profile_artifacts",
+        reason: "local_only_artifact_requested",
+        requested_artifacts: artifactPreflight.requested,
+        local_only_artifacts: artifactPreflight.local_only,
+        hosted_artifacts: artifactPreflight.hosted_artifacts
+      }
+    });
+  }
   const client = createRiddleApiClient(riddleClientConfig(options));
   const balanceBlocked = await preflightRiddleProfileBalanceForCli(profile, options, { client, runner });
   if (balanceBlocked) return balanceBlocked;

package/dist/cli.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
-import "./chunk-RJVA5KKM.js";
+import "./chunk-ICIJTEHD.js";
 import "./chunk-B2DP2LET.js";
 import "./chunk-CWRIXP5H.js";
-import "./chunk-5Y4V2IXI.js";
-import "./chunk-EX7TO4I5.js";
+import "./chunk-UE4I7RTI.js";
+import "./chunk-GG2D3MFZ.js";
 import "./chunk-WLUMLHII.js";
 import "./chunk-CGJX7LJO.js";
 import "./chunk-UTCL7FEZ.js";