@riddledc/riddle-proof 0.7.202 → 0.7.203

package/README.md

@@ -227,6 +227,23 @@ riddle-proof-loop run-profile recover \
   --output artifacts/riddle-proof/pricing-ipad-mini-recovered
 ```
 
+When a matrix run is executed as separate named-viewport jobs, aggregate the
+saved child outputs back into one profile judgment:
+
+```sh
+riddle-proof-loop run-profile aggregate \
+  --profile .riddle-proof/profiles/pricing.json \
+  --url https://example.com \
+  --input-dir artifacts/riddle-proof/pricing-matrix \
+  --output artifacts/riddle-proof/pricing-matrix
+```
+
+`--input-dir` reads child `*/profile-result.json` files such as
+`desktop/profile-result.json` and `ipad-mini/profile-result.json`, then writes
+the combined `profile-result.json` and `summary.md`. Use `--inputs` with a
+comma-separated list of files or directories when the child outputs do not
+share one parent directory.
+
 When promoting proof artifacts into a durable public profile, avoid guessing
 which backend or runner tokens are preserved inside `proof.json`. Derive the
 `body_contains` fragments from the artifact body first:

package/dist/cli.cjs

@@ -16224,6 +16224,7 @@ function usage() {
     "  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] [--viewport-name <name[,name...]>] [--strict true|false; default false] [--split-viewports true|false; default false] [--poll-attempts n] [--output <dir>|--output-dir <dir>] [--result-format json|compact-json|summary|none; default json] [--quiet]",
+    "  riddle-proof-loop run-profile aggregate --profile <file|json|-> --url <base-url> --input-dir <dir>|--inputs <path[,path...]> [--output <dir>|--output-dir <dir>] [--result-format json|compact-json|summary|none; default json]",
     "  riddle-proof-loop run-profile recover --profile <file|json|-> --url <base-url> --job <job-id> [--viewport-name <name[,name...]>] [--output <dir>|--output-dir <dir>] [--result-format json|compact-json|summary|none; default json]",
     "  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]",
@@ -17045,15 +17046,17 @@ function profileHasRecoveredStateReceipt(receipts) {
     const path7 = cliString(receipt.path) || cliString(receipt.function_name) || "";
     const summary = cliReturnSummaryLabel(receipt.return_summary) || "";
     const haystack = `${storedTo} ${label} ${path7} ${summary}`.toLowerCase();
-    const labelsRecovery = haystack.includes("recover") || haystack.includes("repaired") || haystack.includes("repair") || haystack.includes("restart") || haystack.includes("play again") || haystack.includes("playagain") || haystack.includes("play-again") || haystack.includes("try fix") || haystack.includes("tryfix") || haystack.includes("after-fix") || haystack.includes("fixed");
+    const labelsRecovery = haystack.includes("recover") || haystack.includes("repaired") || haystack.includes("repair") || haystack.includes("retry") || haystack.includes("restart") || haystack.includes("play again") || haystack.includes("playagain") || haystack.includes("play-again") || haystack.includes("try fix") || haystack.includes("tryfix") || haystack.includes("after-fix") || haystack.includes("fixed");
     if (!labelsRecovery) return false;
     const status = profileLowerSummaryValue(receipt, ["status", "state", "phase"]);
-    const outcome = profileLowerSummaryValue(receipt, ["lastOutcome", "outcome", "result"]);
-    const hasRecoveredState = ["valid", "success", "recovered", "fixed", "ready"].includes(status) || ["valid", "success", "recovered", "fixed", "ready"].includes(outcome);
+    const outcome = profileLowerSummaryValue(receipt, ["lastOutcome", "outcome", "result", "retryOutcome", "retry_outcome"]);
+    const hasRecoveredState = ["valid", "success", "recovered", "fixed", "ready"].includes(status) || ["valid", "success", "recovered", "fixed", "ready", "running_after_retry", "ready_after_retry"].includes(outcome);
     const hasValid = setupReturnSummaryValue(receipt, ["hasValid", "valid", "isValid"]) === true;
     const hasInvalid = setupReturnSummaryValue(receipt, ["hasInvalid", "invalid", "isInvalid"]);
     const success = setupReturnSummaryValue(receipt, ["success", "recovered", "fixed"]) === true;
-    return hasRecoveredState || success || hasValid && hasInvalid === false;
+    const leftTerminalState = setupReturnSummaryValue(receipt, ["leftTerminalState", "left_terminal_state"]) === true;
+    const retrySurfaceReady = setupReturnSummaryValue(receipt, ["retrySurfaceReady", "retry_surface_ready"]) === true;
+    return hasRecoveredState || success || hasValid && hasInvalid === false || leftTerminalState && retrySurfaceReady;
   });
 }
 function profileMetadataHasGeneratedOutputContract(metadata) {
@@ -18911,6 +18914,78 @@ function splitViewportOutputDir(outputDir, viewportName, seen) {
   seen.set(base, count + 1);
   return import_node_path6.default.join(outputDir, count ? `${base}-${count + 1}` : base);
 }
+function profileResultPathFromInput(inputPath) {
+  if (!(0, import_node_fs6.existsSync)(inputPath)) throw new Error(`Profile aggregate input path does not exist: ${inputPath}`);
+  const stat = (0, import_node_fs6.statSync)(inputPath);
+  if (stat.isFile()) return [inputPath];
+  if (!stat.isDirectory()) throw new Error(`Profile aggregate input path must be a file or directory: ${inputPath}`);
+  const childProfileResults = (0, import_node_fs6.readdirSync)(inputPath, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => import_node_path6.default.join(inputPath, entry.name, "profile-result.json")).filter((candidate) => (0, import_node_fs6.existsSync)(candidate));
+  if (childProfileResults.length) return childProfileResults;
+  const directProfileResult = import_node_path6.default.join(inputPath, "profile-result.json");
+  if ((0, import_node_fs6.existsSync)(directProfileResult)) return [directProfileResult];
+  throw new Error(`Profile aggregate input directory has no child profile-result.json files: ${inputPath}`);
+}
+function runProfileAggregateInputPathsOption(options) {
+  const rawInputs = [
+    optionString(options, "input"),
+    optionString(options, "inputs"),
+    optionString(options, "inputFile"),
+    optionString(options, "inputFiles")
+  ].filter((value) => Boolean(value));
+  const explicitInputs = rawInputs.flatMap((raw) => raw.split(",").map((part) => part.trim()).filter(Boolean));
+  const inputDir = optionString(options, "inputDir") ?? optionString(options, "resultsDir") ?? optionString(options, "runDir");
+  const discoveredInputs = inputDir ? profileResultPathFromInput(inputDir) : [];
+  const paths = [...explicitInputs.flatMap(profileResultPathFromInput), ...discoveredInputs];
+  const uniquePaths = [...new Set(paths.map((inputPath) => import_node_path6.default.resolve(inputPath)))];
+  if (!uniquePaths.length) {
+    throw new Error("run-profile aggregate requires --input-dir <dir> or --inputs <path[,path...]>.");
+  }
+  return uniquePaths;
+}
+function readProfileResultForAggregate(resultPath) {
+  const parsed = readJsonValue(resultPath, resultPath);
+  if (parsed.version !== "riddle-proof.profile-result.v1" || !Array.isArray(parsed.checks)) {
+    throw new Error(`Profile aggregate input is not a riddle-proof.profile-result.v1 result: ${resultPath}`);
+  }
+  return parsed;
+}
+function profileResultIsAggregateParent(result) {
+  const mode = cliString(cliRecord(result.riddle)?.mode);
+  return (mode === "split-viewports" || mode === "named-viewport-aggregate") && (result.evidence?.viewports?.length || 0) > 1;
+}
+function aggregateProfileResultViewportName(result) {
+  const evidenceViewports = result.evidence?.viewports || [];
+  if (evidenceViewports.length === 1) return evidenceViewports[0].name;
+  const metadata = cliRecord(result.metadata);
+  const splitViewport = cliString(metadata?.split_viewport);
+  if (splitViewport) return splitViewport;
+  const selectedViewports = Array.isArray(metadata?.selected_viewports) ? metadata.selected_viewports.map(cliString).filter((name) => Boolean(name)) : [];
+  if (selectedViewports.length === 1) return selectedViewports[0];
+  return void 0;
+}
+function aggregateProfileResultViewport(profile, result, resultPath) {
+  const viewportName = aggregateProfileResultViewportName(result);
+  const parentViewport = viewportName ? profile.target.viewports.find((viewport) => viewport.name === viewportName) : void 0;
+  if (parentViewport) return parentViewport;
+  const evidenceViewport = result.evidence?.viewports?.length === 1 ? result.evidence.viewports[0] : void 0;
+  if (evidenceViewport && typeof evidenceViewport.name === "string" && typeof evidenceViewport.width === "number" && Number.isFinite(evidenceViewport.width) && typeof evidenceViewport.height === "number" && Number.isFinite(evidenceViewport.height)) {
+    return {
+      name: evidenceViewport.name,
+      width: evidenceViewport.width,
+      height: evidenceViewport.height
+    };
+  }
+  throw new Error(`Profile aggregate input must be a single named viewport result or include selected viewport metadata: ${resultPath}`);
+}
+function sortAggregateChildRuns(profile, childRuns) {
+  const viewportOrder = new Map(profile.target.viewports.map((viewport, index) => [viewport.name, index]));
+  return [...childRuns].sort((a, b) => {
+    const aIndex = viewportOrder.get(a.viewport.name) ?? Number.MAX_SAFE_INTEGER;
+    const bIndex = viewportOrder.get(b.viewport.name) ?? Number.MAX_SAFE_INTEGER;
+    if (aIndex !== bIndex) return aIndex - bIndex;
+    return a.viewport.name.localeCompare(b.viewport.name);
+  });
+}
 function splitViewportArtifactRefs(input) {
   return (input.result.artifacts.riddle_artifacts || []).map((artifact) => ({
     ...artifact,
@@ -18921,7 +18996,7 @@ 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) {
+function splitViewportRiddleMetadata(childRuns, mode = "split-viewports") {
   const splitJobs = childRuns.map(({ viewport, result }) => ({
     viewport: viewport.name,
     job_id: result.riddle?.job_id,
@@ -18938,9 +19013,9 @@ function splitViewportRiddleMetadata(childRuns) {
     artifact_recovery: result.riddle?.artifact_recovery
   }));
   return {
-    mode: "split-viewports",
+    mode,
     job_count: childRuns.length,
-    status: "split-viewports",
+    status: mode,
     terminal: childRuns.every(({ result }) => result.riddle?.terminal !== false),
     artifact_recovery: childRuns.some(({ result }) => result.riddle?.artifact_recovery === true),
     queue_elapsed_ms: sumDefinedNumbers(splitJobs.map((job) => job.queue_elapsed_ms)),
@@ -19196,6 +19271,40 @@ async function runSplitViewportProfileForCli(profile, options, input) {
   });
   return withSplitViewportWarnings(profile, withSplitViewportChildStatusCheck(profile, result, childRuns));
 }
+async function aggregateProfileResultsForCli(profile, options) {
+  const resultPaths = runProfileAggregateInputPathsOption(options);
+  const seenViewports = /* @__PURE__ */ new Set();
+  const childInputs = resultPaths.map((resultPath) => ({ resultPath, result: readProfileResultForAggregate(resultPath) })).filter(({ result: result2 }) => !profileResultIsAggregateParent(result2));
+  if (!childInputs.length) {
+    throw new Error("run-profile aggregate found no single-viewport child profile results.");
+  }
+  const childRuns = sortAggregateChildRuns(profile, childInputs.map(({ resultPath, result: result2 }) => {
+    const viewport = aggregateProfileResultViewport(profile, result2, resultPath);
+    if (seenViewports.has(viewport.name)) {
+      throw new Error(`Profile aggregate received more than one result for viewport ${viewport.name}.`);
+    }
+    seenViewports.add(viewport.name);
+    return { viewport, profile: profileForSplitViewport(profile, viewport), 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: "riddle",
+      error: splitViewportBlockedMessage(childRuns),
+      riddle: splitViewportRiddleMetadata(childRuns, "named-viewport-aggregate"),
+      artifacts
+    });
+  }
+  const evidence = aggregateSplitViewportEvidence(profile, childRuns);
+  const result = assessRiddleProofProfileEvidence(profile, evidence, {
+    runner: "riddle",
+    riddle: splitViewportRiddleMetadata(childRuns, "named-viewport-aggregate"),
+    artifacts
+  });
+  return withSplitViewportWarnings(profile, withSplitViewportChildStatusCheck(profile, result, childRuns));
+}
 async function recoverProfileForCli(profile, options) {
   const runner = optionString(options, "runner") || "riddle";
   if (runner !== "riddle") {
@@ -19300,7 +19409,7 @@ async function main() {
   }
   if (command === "run-profile") {
     const profile = profileWithSelectedViewportNamesForCli(normalizeProfileForCli(options), options);
-    const result = positional[1] === "recover" ? await recoverProfileForCli(profile, options) : await runProfileForCli(profile, options);
+    const result = positional[1] === "recover" ? await recoverProfileForCli(profile, options) : positional[1] === "aggregate" ? await aggregateProfileResultsForCli(profile, options) : await runProfileForCli(profile, options);
     writeProfileOutput(profileOutputDirOption(options), result);
     const diagnosticLine = profileCliDiagnosticLine(result);
     if (diagnosticLine && optionBoolean(options, "quiet") !== true) {

package/dist/cli.js

@@ -38,7 +38,7 @@ import {
 import "./chunk-VY4Y5U57.js";
 
 // src/cli.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "fs";
 import path from "path";
 function usage() {
   return [
@@ -49,6 +49,7 @@ function usage() {
     "  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] [--viewport-name <name[,name...]>] [--strict true|false; default false] [--split-viewports true|false; default false] [--poll-attempts n] [--output <dir>|--output-dir <dir>] [--result-format json|compact-json|summary|none; default json] [--quiet]",
+    "  riddle-proof-loop run-profile aggregate --profile <file|json|-> --url <base-url> --input-dir <dir>|--inputs <path[,path...]> [--output <dir>|--output-dir <dir>] [--result-format json|compact-json|summary|none; default json]",
     "  riddle-proof-loop run-profile recover --profile <file|json|-> --url <base-url> --job <job-id> [--viewport-name <name[,name...]>] [--output <dir>|--output-dir <dir>] [--result-format json|compact-json|summary|none; default json]",
     "  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]",
@@ -870,15 +871,17 @@ function profileHasRecoveredStateReceipt(receipts) {
     const path2 = cliString(receipt.path) || cliString(receipt.function_name) || "";
     const summary = cliReturnSummaryLabel(receipt.return_summary) || "";
     const haystack = `${storedTo} ${label} ${path2} ${summary}`.toLowerCase();
-    const labelsRecovery = haystack.includes("recover") || haystack.includes("repaired") || haystack.includes("repair") || haystack.includes("restart") || haystack.includes("play again") || haystack.includes("playagain") || haystack.includes("play-again") || haystack.includes("try fix") || haystack.includes("tryfix") || haystack.includes("after-fix") || haystack.includes("fixed");
+    const labelsRecovery = haystack.includes("recover") || haystack.includes("repaired") || haystack.includes("repair") || haystack.includes("retry") || haystack.includes("restart") || haystack.includes("play again") || haystack.includes("playagain") || haystack.includes("play-again") || haystack.includes("try fix") || haystack.includes("tryfix") || haystack.includes("after-fix") || haystack.includes("fixed");
     if (!labelsRecovery) return false;
     const status = profileLowerSummaryValue(receipt, ["status", "state", "phase"]);
-    const outcome = profileLowerSummaryValue(receipt, ["lastOutcome", "outcome", "result"]);
-    const hasRecoveredState = ["valid", "success", "recovered", "fixed", "ready"].includes(status) || ["valid", "success", "recovered", "fixed", "ready"].includes(outcome);
+    const outcome = profileLowerSummaryValue(receipt, ["lastOutcome", "outcome", "result", "retryOutcome", "retry_outcome"]);
+    const hasRecoveredState = ["valid", "success", "recovered", "fixed", "ready"].includes(status) || ["valid", "success", "recovered", "fixed", "ready", "running_after_retry", "ready_after_retry"].includes(outcome);
     const hasValid = setupReturnSummaryValue(receipt, ["hasValid", "valid", "isValid"]) === true;
     const hasInvalid = setupReturnSummaryValue(receipt, ["hasInvalid", "invalid", "isInvalid"]);
     const success = setupReturnSummaryValue(receipt, ["success", "recovered", "fixed"]) === true;
-    return hasRecoveredState || success || hasValid && hasInvalid === false;
+    const leftTerminalState = setupReturnSummaryValue(receipt, ["leftTerminalState", "left_terminal_state"]) === true;
+    const retrySurfaceReady = setupReturnSummaryValue(receipt, ["retrySurfaceReady", "retry_surface_ready"]) === true;
+    return hasRecoveredState || success || hasValid && hasInvalid === false || leftTerminalState && retrySurfaceReady;
   });
 }
 function profileMetadataHasGeneratedOutputContract(metadata) {
@@ -2736,6 +2739,78 @@ function splitViewportOutputDir(outputDir, viewportName, seen) {
   seen.set(base, count + 1);
   return path.join(outputDir, count ? `${base}-${count + 1}` : base);
 }
+function profileResultPathFromInput(inputPath) {
+  if (!existsSync(inputPath)) throw new Error(`Profile aggregate input path does not exist: ${inputPath}`);
+  const stat = statSync(inputPath);
+  if (stat.isFile()) return [inputPath];
+  if (!stat.isDirectory()) throw new Error(`Profile aggregate input path must be a file or directory: ${inputPath}`);
+  const childProfileResults = readdirSync(inputPath, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => path.join(inputPath, entry.name, "profile-result.json")).filter((candidate) => existsSync(candidate));
+  if (childProfileResults.length) return childProfileResults;
+  const directProfileResult = path.join(inputPath, "profile-result.json");
+  if (existsSync(directProfileResult)) return [directProfileResult];
+  throw new Error(`Profile aggregate input directory has no child profile-result.json files: ${inputPath}`);
+}
+function runProfileAggregateInputPathsOption(options) {
+  const rawInputs = [
+    optionString(options, "input"),
+    optionString(options, "inputs"),
+    optionString(options, "inputFile"),
+    optionString(options, "inputFiles")
+  ].filter((value) => Boolean(value));
+  const explicitInputs = rawInputs.flatMap((raw) => raw.split(",").map((part) => part.trim()).filter(Boolean));
+  const inputDir = optionString(options, "inputDir") ?? optionString(options, "resultsDir") ?? optionString(options, "runDir");
+  const discoveredInputs = inputDir ? profileResultPathFromInput(inputDir) : [];
+  const paths = [...explicitInputs.flatMap(profileResultPathFromInput), ...discoveredInputs];
+  const uniquePaths = [...new Set(paths.map((inputPath) => path.resolve(inputPath)))];
+  if (!uniquePaths.length) {
+    throw new Error("run-profile aggregate requires --input-dir <dir> or --inputs <path[,path...]>.");
+  }
+  return uniquePaths;
+}
+function readProfileResultForAggregate(resultPath) {
+  const parsed = readJsonValue(resultPath, resultPath);
+  if (parsed.version !== "riddle-proof.profile-result.v1" || !Array.isArray(parsed.checks)) {
+    throw new Error(`Profile aggregate input is not a riddle-proof.profile-result.v1 result: ${resultPath}`);
+  }
+  return parsed;
+}
+function profileResultIsAggregateParent(result) {
+  const mode = cliString(cliRecord(result.riddle)?.mode);
+  return (mode === "split-viewports" || mode === "named-viewport-aggregate") && (result.evidence?.viewports?.length || 0) > 1;
+}
+function aggregateProfileResultViewportName(result) {
+  const evidenceViewports = result.evidence?.viewports || [];
+  if (evidenceViewports.length === 1) return evidenceViewports[0].name;
+  const metadata = cliRecord(result.metadata);
+  const splitViewport = cliString(metadata?.split_viewport);
+  if (splitViewport) return splitViewport;
+  const selectedViewports = Array.isArray(metadata?.selected_viewports) ? metadata.selected_viewports.map(cliString).filter((name) => Boolean(name)) : [];
+  if (selectedViewports.length === 1) return selectedViewports[0];
+  return void 0;
+}
+function aggregateProfileResultViewport(profile, result, resultPath) {
+  const viewportName = aggregateProfileResultViewportName(result);
+  const parentViewport = viewportName ? profile.target.viewports.find((viewport) => viewport.name === viewportName) : void 0;
+  if (parentViewport) return parentViewport;
+  const evidenceViewport = result.evidence?.viewports?.length === 1 ? result.evidence.viewports[0] : void 0;
+  if (evidenceViewport && typeof evidenceViewport.name === "string" && typeof evidenceViewport.width === "number" && Number.isFinite(evidenceViewport.width) && typeof evidenceViewport.height === "number" && Number.isFinite(evidenceViewport.height)) {
+    return {
+      name: evidenceViewport.name,
+      width: evidenceViewport.width,
+      height: evidenceViewport.height
+    };
+  }
+  throw new Error(`Profile aggregate input must be a single named viewport result or include selected viewport metadata: ${resultPath}`);
+}
+function sortAggregateChildRuns(profile, childRuns) {
+  const viewportOrder = new Map(profile.target.viewports.map((viewport, index) => [viewport.name, index]));
+  return [...childRuns].sort((a, b) => {
+    const aIndex = viewportOrder.get(a.viewport.name) ?? Number.MAX_SAFE_INTEGER;
+    const bIndex = viewportOrder.get(b.viewport.name) ?? Number.MAX_SAFE_INTEGER;
+    if (aIndex !== bIndex) return aIndex - bIndex;
+    return a.viewport.name.localeCompare(b.viewport.name);
+  });
+}
 function splitViewportArtifactRefs(input) {
   return (input.result.artifacts.riddle_artifacts || []).map((artifact) => ({
     ...artifact,
@@ -2746,7 +2821,7 @@ 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) {
+function splitViewportRiddleMetadata(childRuns, mode = "split-viewports") {
   const splitJobs = childRuns.map(({ viewport, result }) => ({
     viewport: viewport.name,
     job_id: result.riddle?.job_id,
@@ -2763,9 +2838,9 @@ function splitViewportRiddleMetadata(childRuns) {
     artifact_recovery: result.riddle?.artifact_recovery
   }));
   return {
-    mode: "split-viewports",
+    mode,
     job_count: childRuns.length,
-    status: "split-viewports",
+    status: mode,
     terminal: childRuns.every(({ result }) => result.riddle?.terminal !== false),
     artifact_recovery: childRuns.some(({ result }) => result.riddle?.artifact_recovery === true),
     queue_elapsed_ms: sumDefinedNumbers(splitJobs.map((job) => job.queue_elapsed_ms)),
@@ -3021,6 +3096,40 @@ async function runSplitViewportProfileForCli(profile, options, input) {
   });
   return withSplitViewportWarnings(profile, withSplitViewportChildStatusCheck(profile, result, childRuns));
 }
+async function aggregateProfileResultsForCli(profile, options) {
+  const resultPaths = runProfileAggregateInputPathsOption(options);
+  const seenViewports = /* @__PURE__ */ new Set();
+  const childInputs = resultPaths.map((resultPath) => ({ resultPath, result: readProfileResultForAggregate(resultPath) })).filter(({ result: result2 }) => !profileResultIsAggregateParent(result2));
+  if (!childInputs.length) {
+    throw new Error("run-profile aggregate found no single-viewport child profile results.");
+  }
+  const childRuns = sortAggregateChildRuns(profile, childInputs.map(({ resultPath, result: result2 }) => {
+    const viewport = aggregateProfileResultViewport(profile, result2, resultPath);
+    if (seenViewports.has(viewport.name)) {
+      throw new Error(`Profile aggregate received more than one result for viewport ${viewport.name}.`);
+    }
+    seenViewports.add(viewport.name);
+    return { viewport, profile: profileForSplitViewport(profile, viewport), 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: "riddle",
+      error: splitViewportBlockedMessage(childRuns),
+      riddle: splitViewportRiddleMetadata(childRuns, "named-viewport-aggregate"),
+      artifacts
+    });
+  }
+  const evidence = aggregateSplitViewportEvidence(profile, childRuns);
+  const result = assessRiddleProofProfileEvidence(profile, evidence, {
+    runner: "riddle",
+    riddle: splitViewportRiddleMetadata(childRuns, "named-viewport-aggregate"),
+    artifacts
+  });
+  return withSplitViewportWarnings(profile, withSplitViewportChildStatusCheck(profile, result, childRuns));
+}
 async function recoverProfileForCli(profile, options) {
   const runner = optionString(options, "runner") || "riddle";
   if (runner !== "riddle") {
@@ -3125,7 +3234,7 @@ async function main() {
   }
   if (command === "run-profile") {
     const profile = profileWithSelectedViewportNamesForCli(normalizeProfileForCli(options), options);
-    const result = positional[1] === "recover" ? await recoverProfileForCli(profile, options) : await runProfileForCli(profile, options);
+    const result = positional[1] === "recover" ? await recoverProfileForCli(profile, options) : positional[1] === "aggregate" ? await aggregateProfileResultsForCli(profile, options) : await runProfileForCli(profile, options);
     writeProfileOutput(profileOutputDirOption(options), result);
     const diagnosticLine = profileCliDiagnosticLine(result);
     if (diagnosticLine && optionBoolean(options, "quiet") !== 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: "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.202",
+  "version": "0.7.203",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",