@riddledc/riddle-proof 0.7.145 → 0.7.146

package/dist/cli.cjs

@@ -6938,6 +6938,7 @@ function createRiddleApiClient(config = {}) {
 
 // src/profile.ts
 var RIDDLE_PROOF_PROFILE_VERSION = "riddle-proof.profile.v1";
+var RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION = "riddle-proof.profile-evidence.v1";
 var RIDDLE_PROOF_PROFILE_RESULT_VERSION = "riddle-proof.profile-result.v1";
 var RIDDLE_PROOF_PROFILE_STATUSES = [
   "passed",
@@ -14380,7 +14381,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; default false] [--poll-attempts n] [--output <dir>|--output-dir <dir>] [--quiet]",
+    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--strict true|false; default false] [--split-viewports true|false; default false] [--poll-attempts n] [--output <dir>|--output-dir <dir>] [--quiet]",
     "  riddle-proof-loop profile-body-assertions --artifact <file|url|-> --candidates-json <file|json|-> [--required-json <file|json|->] [--format json|body-contains]",
     "  riddle-proof-loop profile-http-status-preflight --profile <file|json|-> --url <base-url> [--format json|summary]",
     "  riddle-proof-loop riddle-preview-deploy <build-dir> <label> [--framework spa|static]",
@@ -14437,6 +14438,9 @@ function optionBoolean(options, key) {
 function runProfileStrictOption(options) {
   return optionBoolean(options, "strict") ?? false;
 }
+function runProfileSplitViewportsOption(options) {
+  return optionBoolean(options, "splitViewports") ?? false;
+}
 function optionNumber(options, ...keys) {
   for (const key of keys) {
     const value = optionString(options, key);
@@ -14749,6 +14753,8 @@ function profileRiddleJobMarkdown(result) {
   const riddle = cliRecord(result.riddle);
   if (!riddle) return [];
   const jobId = cliString(riddle.job_id);
+  const mode = cliString(riddle.mode);
+  const jobCount = cliFiniteNumber(riddle.job_count);
   const status = cliString(riddle.status);
   const terminal = typeof riddle.terminal === "boolean" ? riddle.terminal : void 0;
   const queueElapsedMs = cliFiniteNumber(riddle.queue_elapsed_ms);
@@ -14758,6 +14764,8 @@ function profileRiddleJobMarkdown(result) {
   const submittedAt = cliString(riddle.submitted_at);
   const completedAt = cliString(riddle.completed_at);
   const parts = [
+    mode ? `mode ${markdownInlineCode(mode)}` : "",
+    jobCount === void 0 ? "" : `jobs ${jobCount}`,
     jobId ? `job ${markdownInlineCode(jobId)}` : "",
     status ? `status ${markdownInlineCode(status)}` : "",
     terminal === void 0 ? "" : `terminal ${terminal ? "true" : "false"}`
@@ -14771,6 +14779,21 @@ function profileRiddleJobMarkdown(result) {
   if (submittedAt || completedAt) {
     lines.push(`- timing:${submittedAt ? ` submitted ${markdownInlineCode(submittedAt)}` : ""}${completedAt ? ` completed ${markdownInlineCode(completedAt)}` : ""}`);
   }
+  const splitJobs = Array.isArray(riddle.split_jobs) ? riddle.split_jobs.map(cliRecord).filter((job) => Boolean(job)) : [];
+  for (const job of splitJobs.slice(0, 12)) {
+    const viewport = cliString(job.viewport) || "viewport";
+    const splitJobId = cliString(job.job_id);
+    const splitStatus = cliString(job.status);
+    const splitTerminal = typeof job.terminal === "boolean" ? job.terminal : void 0;
+    lines.push(
+      `- ${viewport}: ${[
+        splitJobId ? `job ${markdownInlineCode(splitJobId)}` : "",
+        splitStatus ? `status ${markdownInlineCode(splitStatus)}` : "",
+        splitTerminal === void 0 ? "" : `terminal ${splitTerminal ? "true" : "false"}`
+      ].filter(Boolean).join(", ") || "job metadata unavailable"}`
+    );
+  }
+  if (splitJobs.length > 12) lines.push(`- ${splitJobs.length - 12} additional split job(s) omitted.`);
   return lines;
 }
 function markdownInlineCode(value, maxLength = 80) {
@@ -15396,13 +15419,146 @@ function riddleMetadataFromPoll(jobId, poll) {
     timed_out: poll.poll?.timed_out
   };
 }
-async function runProfileForCli(profile, options) {
-  const runner = optionString(options, "runner") || "riddle";
-  if (runner !== "riddle") {
-    throw new Error(`Unsupported --runner ${runner}. The current CLI supports --runner riddle.`);
+function profileForSplitViewport(profile, viewport) {
+  return {
+    ...profile,
+    name: `${profile.name}-${viewport.name || `${viewport.width}x${viewport.height}`}`,
+    target: {
+      ...profile.target,
+      viewports: [viewport]
+    },
+    metadata: {
+      ...profile.metadata || {},
+      split_parent_profile: profile.name,
+      split_viewport: viewport.name
+    }
+  };
+}
+function safeProfileOutputSegment(value) {
+  const safe = value.replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
+  return safe || "viewport";
+}
+function splitViewportOutputDir(outputDir, viewportName, seen) {
+  const base = safeProfileOutputSegment(viewportName);
+  const count = seen.get(base) || 0;
+  seen.set(base, count + 1);
+  return import_node_path6.default.join(outputDir, count ? `${base}-${count + 1}` : base);
+}
+function splitViewportArtifactRefs(input) {
+  return (input.result.artifacts.riddle_artifacts || []).map((artifact) => ({
+    ...artifact,
+    name: `${safeProfileOutputSegment(input.viewport.name)}/${artifact.name || artifact.kind || "artifact"}`
+  }));
+}
+function sumDefinedNumbers(values) {
+  const numbers = values.filter((value) => typeof value === "number" && Number.isFinite(value));
+  return numbers.length ? numbers.reduce((sum, value) => sum + value, 0) : void 0;
+}
+function splitViewportRiddleMetadata(childRuns) {
+  const splitJobs = childRuns.map(({ viewport, result }) => ({
+    viewport: viewport.name,
+    job_id: result.riddle?.job_id,
+    status: result.riddle?.status,
+    terminal: result.riddle?.terminal,
+    queue_elapsed_ms: result.riddle?.queue_elapsed_ms,
+    elapsed_ms: result.riddle?.elapsed_ms,
+    attempt: result.riddle?.attempt,
+    attempts: result.riddle?.attempts,
+    timed_out: result.riddle?.timed_out
+  }));
+  return {
+    mode: "split-viewports",
+    job_count: childRuns.length,
+    status: "split-viewports",
+    terminal: childRuns.every(({ result }) => result.riddle?.terminal !== false),
+    queue_elapsed_ms: sumDefinedNumbers(splitJobs.map((job) => job.queue_elapsed_ms)),
+    elapsed_ms: sumDefinedNumbers(splitJobs.map((job) => job.elapsed_ms)),
+    split_jobs: splitJobs
+  };
+}
+function latestCapturedAt(evidences) {
+  let latest = "";
+  let latestMs = Number.NEGATIVE_INFINITY;
+  for (const evidence of evidences) {
+    const parsed = Date.parse(evidence.captured_at);
+    if (Number.isFinite(parsed) && parsed >= latestMs) {
+      latest = evidence.captured_at;
+      latestMs = parsed;
+    }
   }
+  return latest || (/* @__PURE__ */ new Date()).toISOString();
+}
+function splitViewportDomSummary(profile, childRuns, evidence) {
+  return {
+    split_viewports: true,
+    expected_viewport_count: profile.target.viewports.length,
+    viewport_count: evidence.viewports.length,
+    child_result_count: childRuns.length,
+    child_statuses: childRuns.map(({ viewport, result }) => ({
+      viewport: viewport.name,
+      profile_name: result.profile_name,
+      status: result.status,
+      job_id: result.riddle?.job_id || null
+    })),
+    routes: evidence.viewports.map((viewport) => ({
+      viewport: viewport.name,
+      requested: viewport.route.requested,
+      observed: viewport.route.observed,
+      matched: viewport.route.matched,
+      http_status: viewport.route.http_status ?? null
+    })),
+    titles: evidence.viewports.map((viewport) => viewport.title).filter((title) => Boolean(title)),
+    overflow_px: evidence.viewports.map((viewport) => viewport.overflow_px ?? null),
+    bounds_overflow_px: evidence.viewports.map((viewport) => viewport.bounds_overflow_px ?? null),
+    overflow_offender_counts: evidence.viewports.map((viewport) => (viewport.overflow_offenders || []).length),
+    console_event_count: evidence.console.events.length,
+    console_fatal_count: evidence.console.fatal_count,
+    page_error_count: evidence.page_errors.length,
+    network_mock_count: (profile.target.network_mocks || []).length,
+    network_mock_hit_count: (evidence.network_mocks || []).filter((event) => event.ok !== false).length
+  };
+}
+function aggregateSplitViewportEvidence(profile, childRuns) {
+  const evidences = childRuns.map(({ result }) => result.evidence).filter((evidence2) => Boolean(evidence2));
+  const viewports = evidences.flatMap((evidence2) => evidence2.viewports || []);
+  const consoleEvents = evidences.flatMap((evidence2) => evidence2.console?.events || []);
+  const pageErrors = evidences.flatMap((evidence2) => evidence2.page_errors || []);
+  const networkMocks = evidences.flatMap((evidence2) => evidence2.network_mocks || []);
+  const evidence = {
+    version: RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,
+    profile_name: profile.name,
+    target_url: resolveRiddleProofProfileTargetUrl(profile),
+    baseline_policy: profile.baseline_policy,
+    captured_at: latestCapturedAt(evidences),
+    viewports,
+    console: {
+      events: consoleEvents,
+      fatal_count: evidences.reduce((sum, item) => sum + (item.console?.fatal_count || 0), 0)
+    },
+    page_errors: pageErrors,
+    network_mocks: networkMocks.length ? networkMocks : void 0
+  };
+  evidence.dom_summary = splitViewportDomSummary(profile, childRuns, evidence);
+  return evidence;
+}
+function splitViewportBlockedMessage(childRuns) {
+  const blocked = childRuns.filter(({ result }) => !result.evidence || result.status === "environment_blocked" || result.status === "configuration_error").map(({ viewport, result }) => `${viewport.name}: ${result.status}${result.error ? ` (${result.error})` : ""}`);
+  return `Split viewport run did not produce reliable evidence for ${blocked.join("; ")}.`;
+}
+function withSplitViewportWarnings(profile, result) {
+  const warnings = [];
+  if (profile.target.network_mocks?.length) {
+    warnings.push("Split viewport mode runs each viewport in a separate Riddle job; global network mock sequencing is assessed from aggregated events.");
+  }
+  if (!warnings.length) return result;
+  return {
+    ...result,
+    warnings: [.../* @__PURE__ */ new Set([...result.warnings || [], ...warnings])]
+  };
+}
+async function runSingleRiddleProfileForCli(profile, options, input) {
+  const { client, runner } = input;
   const targetUrl = resolveRiddleProofProfileTargetUrl(profile);
-  const client = createRiddleApiClient(riddleClientConfig(options));
   let created;
   try {
     created = await client.runScript({
@@ -15461,6 +15617,48 @@ async function runProfileForCli(profile, options) {
     artifacts
   });
 }
+async function runSplitViewportProfileForCli(profile, options, input) {
+  const outputDir = profileOutputDirOption(options);
+  const seenOutputNames = /* @__PURE__ */ new Map();
+  const childRuns = [];
+  for (const viewport of profile.target.viewports) {
+    const childProfile = profileForSplitViewport(profile, viewport);
+    const result2 = await runSingleRiddleProfileForCli(childProfile, options, input);
+    if (outputDir) {
+      writeProfileOutput(splitViewportOutputDir(outputDir, viewport.name, seenOutputNames), result2);
+    }
+    childRuns.push({ viewport, profile: childProfile, result: result2 });
+  }
+  const artifacts = childRuns.flatMap(splitViewportArtifactRefs);
+  const blocked = childRuns.filter(({ result: result2 }) => !result2.evidence || result2.status === "environment_blocked" || result2.status === "configuration_error");
+  if (blocked.length) {
+    return createRiddleProofProfileEnvironmentBlockedResult({
+      profile,
+      runner: input.runner,
+      error: splitViewportBlockedMessage(childRuns),
+      riddle: splitViewportRiddleMetadata(childRuns),
+      artifacts
+    });
+  }
+  const evidence = aggregateSplitViewportEvidence(profile, childRuns);
+  const result = assessRiddleProofProfileEvidence(profile, evidence, {
+    runner: input.runner,
+    riddle: splitViewportRiddleMetadata(childRuns),
+    artifacts
+  });
+  return withSplitViewportWarnings(profile, result);
+}
+async function runProfileForCli(profile, options) {
+  const runner = optionString(options, "runner") || "riddle";
+  if (runner !== "riddle") {
+    throw new Error(`Unsupported --runner ${runner}. The current CLI supports --runner riddle.`);
+  }
+  const client = createRiddleApiClient(riddleClientConfig(options));
+  if (runProfileSplitViewportsOption(options) && profile.target.viewports.length > 1) {
+    return runSplitViewportProfileForCli(profile, options, { client, runner });
+  }
+  return runSingleRiddleProfileForCli(profile, options, { client, runner });
+}
 function requestForRun(options) {
   const statePath = optionString(options, "statePath");
   const withEngineModuleUrl = (request) => {

package/dist/cli.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import {
+  RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,
   assessRiddleProofProfileEvidence,
   buildRiddleProofProfileScript,
   collectRiddleProfileArtifactRefs,
@@ -46,7 +47,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; default false] [--poll-attempts n] [--output <dir>|--output-dir <dir>] [--quiet]",
+    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--strict true|false; default false] [--split-viewports true|false; default false] [--poll-attempts n] [--output <dir>|--output-dir <dir>] [--quiet]",
     "  riddle-proof-loop profile-body-assertions --artifact <file|url|-> --candidates-json <file|json|-> [--required-json <file|json|->] [--format json|body-contains]",
     "  riddle-proof-loop profile-http-status-preflight --profile <file|json|-> --url <base-url> [--format json|summary]",
     "  riddle-proof-loop riddle-preview-deploy <build-dir> <label> [--framework spa|static]",
@@ -103,6 +104,9 @@ function optionBoolean(options, key) {
 function runProfileStrictOption(options) {
   return optionBoolean(options, "strict") ?? false;
 }
+function runProfileSplitViewportsOption(options) {
+  return optionBoolean(options, "splitViewports") ?? false;
+}
 function optionNumber(options, ...keys) {
   for (const key of keys) {
     const value = optionString(options, key);
@@ -415,6 +419,8 @@ function profileRiddleJobMarkdown(result) {
   const riddle = cliRecord(result.riddle);
   if (!riddle) return [];
   const jobId = cliString(riddle.job_id);
+  const mode = cliString(riddle.mode);
+  const jobCount = cliFiniteNumber(riddle.job_count);
   const status = cliString(riddle.status);
   const terminal = typeof riddle.terminal === "boolean" ? riddle.terminal : void 0;
   const queueElapsedMs = cliFiniteNumber(riddle.queue_elapsed_ms);
@@ -424,6 +430,8 @@ function profileRiddleJobMarkdown(result) {
   const submittedAt = cliString(riddle.submitted_at);
   const completedAt = cliString(riddle.completed_at);
   const parts = [
+    mode ? `mode ${markdownInlineCode(mode)}` : "",
+    jobCount === void 0 ? "" : `jobs ${jobCount}`,
     jobId ? `job ${markdownInlineCode(jobId)}` : "",
     status ? `status ${markdownInlineCode(status)}` : "",
     terminal === void 0 ? "" : `terminal ${terminal ? "true" : "false"}`
@@ -437,6 +445,21 @@ function profileRiddleJobMarkdown(result) {
   if (submittedAt || completedAt) {
     lines.push(`- timing:${submittedAt ? ` submitted ${markdownInlineCode(submittedAt)}` : ""}${completedAt ? ` completed ${markdownInlineCode(completedAt)}` : ""}`);
   }
+  const splitJobs = Array.isArray(riddle.split_jobs) ? riddle.split_jobs.map(cliRecord).filter((job) => Boolean(job)) : [];
+  for (const job of splitJobs.slice(0, 12)) {
+    const viewport = cliString(job.viewport) || "viewport";
+    const splitJobId = cliString(job.job_id);
+    const splitStatus = cliString(job.status);
+    const splitTerminal = typeof job.terminal === "boolean" ? job.terminal : void 0;
+    lines.push(
+      `- ${viewport}: ${[
+        splitJobId ? `job ${markdownInlineCode(splitJobId)}` : "",
+        splitStatus ? `status ${markdownInlineCode(splitStatus)}` : "",
+        splitTerminal === void 0 ? "" : `terminal ${splitTerminal ? "true" : "false"}`
+      ].filter(Boolean).join(", ") || "job metadata unavailable"}`
+    );
+  }
+  if (splitJobs.length > 12) lines.push(`- ${splitJobs.length - 12} additional split job(s) omitted.`);
   return lines;
 }
 function markdownInlineCode(value, maxLength = 80) {
@@ -1062,13 +1085,146 @@ function riddleMetadataFromPoll(jobId, poll) {
     timed_out: poll.poll?.timed_out
   };
 }
-async function runProfileForCli(profile, options) {
-  const runner = optionString(options, "runner") || "riddle";
-  if (runner !== "riddle") {
-    throw new Error(`Unsupported --runner ${runner}. The current CLI supports --runner riddle.`);
+function profileForSplitViewport(profile, viewport) {
+  return {
+    ...profile,
+    name: `${profile.name}-${viewport.name || `${viewport.width}x${viewport.height}`}`,
+    target: {
+      ...profile.target,
+      viewports: [viewport]
+    },
+    metadata: {
+      ...profile.metadata || {},
+      split_parent_profile: profile.name,
+      split_viewport: viewport.name
+    }
+  };
+}
+function safeProfileOutputSegment(value) {
+  const safe = value.replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
+  return safe || "viewport";
+}
+function splitViewportOutputDir(outputDir, viewportName, seen) {
+  const base = safeProfileOutputSegment(viewportName);
+  const count = seen.get(base) || 0;
+  seen.set(base, count + 1);
+  return path.join(outputDir, count ? `${base}-${count + 1}` : base);
+}
+function splitViewportArtifactRefs(input) {
+  return (input.result.artifacts.riddle_artifacts || []).map((artifact) => ({
+    ...artifact,
+    name: `${safeProfileOutputSegment(input.viewport.name)}/${artifact.name || artifact.kind || "artifact"}`
+  }));
+}
+function sumDefinedNumbers(values) {
+  const numbers = values.filter((value) => typeof value === "number" && Number.isFinite(value));
+  return numbers.length ? numbers.reduce((sum, value) => sum + value, 0) : void 0;
+}
+function splitViewportRiddleMetadata(childRuns) {
+  const splitJobs = childRuns.map(({ viewport, result }) => ({
+    viewport: viewport.name,
+    job_id: result.riddle?.job_id,
+    status: result.riddle?.status,
+    terminal: result.riddle?.terminal,
+    queue_elapsed_ms: result.riddle?.queue_elapsed_ms,
+    elapsed_ms: result.riddle?.elapsed_ms,
+    attempt: result.riddle?.attempt,
+    attempts: result.riddle?.attempts,
+    timed_out: result.riddle?.timed_out
+  }));
+  return {
+    mode: "split-viewports",
+    job_count: childRuns.length,
+    status: "split-viewports",
+    terminal: childRuns.every(({ result }) => result.riddle?.terminal !== false),
+    queue_elapsed_ms: sumDefinedNumbers(splitJobs.map((job) => job.queue_elapsed_ms)),
+    elapsed_ms: sumDefinedNumbers(splitJobs.map((job) => job.elapsed_ms)),
+    split_jobs: splitJobs
+  };
+}
+function latestCapturedAt(evidences) {
+  let latest = "";
+  let latestMs = Number.NEGATIVE_INFINITY;
+  for (const evidence of evidences) {
+    const parsed = Date.parse(evidence.captured_at);
+    if (Number.isFinite(parsed) && parsed >= latestMs) {
+      latest = evidence.captured_at;
+      latestMs = parsed;
+    }
   }
+  return latest || (/* @__PURE__ */ new Date()).toISOString();
+}
+function splitViewportDomSummary(profile, childRuns, evidence) {
+  return {
+    split_viewports: true,
+    expected_viewport_count: profile.target.viewports.length,
+    viewport_count: evidence.viewports.length,
+    child_result_count: childRuns.length,
+    child_statuses: childRuns.map(({ viewport, result }) => ({
+      viewport: viewport.name,
+      profile_name: result.profile_name,
+      status: result.status,
+      job_id: result.riddle?.job_id || null
+    })),
+    routes: evidence.viewports.map((viewport) => ({
+      viewport: viewport.name,
+      requested: viewport.route.requested,
+      observed: viewport.route.observed,
+      matched: viewport.route.matched,
+      http_status: viewport.route.http_status ?? null
+    })),
+    titles: evidence.viewports.map((viewport) => viewport.title).filter((title) => Boolean(title)),
+    overflow_px: evidence.viewports.map((viewport) => viewport.overflow_px ?? null),
+    bounds_overflow_px: evidence.viewports.map((viewport) => viewport.bounds_overflow_px ?? null),
+    overflow_offender_counts: evidence.viewports.map((viewport) => (viewport.overflow_offenders || []).length),
+    console_event_count: evidence.console.events.length,
+    console_fatal_count: evidence.console.fatal_count,
+    page_error_count: evidence.page_errors.length,
+    network_mock_count: (profile.target.network_mocks || []).length,
+    network_mock_hit_count: (evidence.network_mocks || []).filter((event) => event.ok !== false).length
+  };
+}
+function aggregateSplitViewportEvidence(profile, childRuns) {
+  const evidences = childRuns.map(({ result }) => result.evidence).filter((evidence2) => Boolean(evidence2));
+  const viewports = evidences.flatMap((evidence2) => evidence2.viewports || []);
+  const consoleEvents = evidences.flatMap((evidence2) => evidence2.console?.events || []);
+  const pageErrors = evidences.flatMap((evidence2) => evidence2.page_errors || []);
+  const networkMocks = evidences.flatMap((evidence2) => evidence2.network_mocks || []);
+  const evidence = {
+    version: RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,
+    profile_name: profile.name,
+    target_url: resolveRiddleProofProfileTargetUrl(profile),
+    baseline_policy: profile.baseline_policy,
+    captured_at: latestCapturedAt(evidences),
+    viewports,
+    console: {
+      events: consoleEvents,
+      fatal_count: evidences.reduce((sum, item) => sum + (item.console?.fatal_count || 0), 0)
+    },
+    page_errors: pageErrors,
+    network_mocks: networkMocks.length ? networkMocks : void 0
+  };
+  evidence.dom_summary = splitViewportDomSummary(profile, childRuns, evidence);
+  return evidence;
+}
+function splitViewportBlockedMessage(childRuns) {
+  const blocked = childRuns.filter(({ result }) => !result.evidence || result.status === "environment_blocked" || result.status === "configuration_error").map(({ viewport, result }) => `${viewport.name}: ${result.status}${result.error ? ` (${result.error})` : ""}`);
+  return `Split viewport run did not produce reliable evidence for ${blocked.join("; ")}.`;
+}
+function withSplitViewportWarnings(profile, result) {
+  const warnings = [];
+  if (profile.target.network_mocks?.length) {
+    warnings.push("Split viewport mode runs each viewport in a separate Riddle job; global network mock sequencing is assessed from aggregated events.");
+  }
+  if (!warnings.length) return result;
+  return {
+    ...result,
+    warnings: [.../* @__PURE__ */ new Set([...result.warnings || [], ...warnings])]
+  };
+}
+async function runSingleRiddleProfileForCli(profile, options, input) {
+  const { client, runner } = input;
   const targetUrl = resolveRiddleProofProfileTargetUrl(profile);
-  const client = createRiddleApiClient(riddleClientConfig(options));
   let created;
   try {
     created = await client.runScript({
@@ -1127,6 +1283,48 @@ async function runProfileForCli(profile, options) {
     artifacts
   });
 }
+async function runSplitViewportProfileForCli(profile, options, input) {
+  const outputDir = profileOutputDirOption(options);
+  const seenOutputNames = /* @__PURE__ */ new Map();
+  const childRuns = [];
+  for (const viewport of profile.target.viewports) {
+    const childProfile = profileForSplitViewport(profile, viewport);
+    const result2 = await runSingleRiddleProfileForCli(childProfile, options, input);
+    if (outputDir) {
+      writeProfileOutput(splitViewportOutputDir(outputDir, viewport.name, seenOutputNames), result2);
+    }
+    childRuns.push({ viewport, profile: childProfile, result: result2 });
+  }
+  const artifacts = childRuns.flatMap(splitViewportArtifactRefs);
+  const blocked = childRuns.filter(({ result: result2 }) => !result2.evidence || result2.status === "environment_blocked" || result2.status === "configuration_error");
+  if (blocked.length) {
+    return createRiddleProofProfileEnvironmentBlockedResult({
+      profile,
+      runner: input.runner,
+      error: splitViewportBlockedMessage(childRuns),
+      riddle: splitViewportRiddleMetadata(childRuns),
+      artifacts
+    });
+  }
+  const evidence = aggregateSplitViewportEvidence(profile, childRuns);
+  const result = assessRiddleProofProfileEvidence(profile, evidence, {
+    runner: input.runner,
+    riddle: splitViewportRiddleMetadata(childRuns),
+    artifacts
+  });
+  return withSplitViewportWarnings(profile, result);
+}
+async function runProfileForCli(profile, options) {
+  const runner = optionString(options, "runner") || "riddle";
+  if (runner !== "riddle") {
+    throw new Error(`Unsupported --runner ${runner}. The current CLI supports --runner riddle.`);
+  }
+  const client = createRiddleApiClient(riddleClientConfig(options));
+  if (runProfileSplitViewportsOption(options) && profile.target.viewports.length > 1) {
+    return runSplitViewportProfileForCli(profile, options, { client, runner });
+  }
+  return runSingleRiddleProfileForCli(profile, options, { client, runner });
+}
 function requestForRun(options) {
   const statePath = optionString(options, "statePath");
   const withEngineModuleUrl = (request) => {

package/dist/profile.d.cts

@@ -376,7 +376,9 @@ interface RiddleProofProfileResult {
     warnings?: string[];
     evidence?: RiddleProofProfileEvidence;
     riddle?: {
+        mode?: "split-viewports" | (string & {});
         job_id?: string;
+        job_count?: number;
         status?: string | null;
         terminal?: boolean;
         created_at?: string | null;
@@ -387,6 +389,17 @@ interface RiddleProofProfileResult {
         attempt?: number;
         attempts?: number;
         timed_out?: boolean;
+        split_jobs?: Array<{
+            viewport: string;
+            job_id?: string;
+            status?: string | null;
+            terminal?: boolean;
+            queue_elapsed_ms?: number | null;
+            elapsed_ms?: number;
+            attempt?: number;
+            attempts?: number;
+            timed_out?: boolean;
+        }>;
     };
     environment_blocker?: Record<string, JsonValue>;
     error?: string;

package/dist/profile.d.ts

@@ -376,7 +376,9 @@ interface RiddleProofProfileResult {
     warnings?: string[];
     evidence?: RiddleProofProfileEvidence;
     riddle?: {
+        mode?: "split-viewports" | (string & {});
         job_id?: string;
+        job_count?: number;
         status?: string | null;
         terminal?: boolean;
         created_at?: string | null;
@@ -387,6 +389,17 @@ interface RiddleProofProfileResult {
         attempt?: number;
         attempts?: number;
         timed_out?: boolean;
+        split_jobs?: Array<{
+            viewport: string;
+            job_id?: string;
+            status?: string | null;
+            terminal?: boolean;
+            queue_elapsed_ms?: number | null;
+            elapsed_ms?: number;
+            attempt?: number;
+            attempts?: number;
+            timed_out?: boolean;
+        }>;
     };
     environment_blocker?: Record<string, JsonValue>;
     error?: string;

package/package.json

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