@riddledc/riddle-proof 0.7.202 → 0.7.204

package/README.md

@@ -227,6 +227,25 @@ 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. Aggregate summaries label summed hosted timing as
+child poll totals and also show the maximum child latency, so a matrix report
+does not make sequential child wait time look like a single job duration.
+
 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]",
@@ -16703,6 +16704,7 @@ function profileRiddleJobMarkdown(result) {
   const artifactRecovery = riddle.artifact_recovery === true;
   const retryCount = cliFiniteNumber(riddle.retry_count);
   const staleJobIds = Array.isArray(riddle.stale_job_ids) ? riddle.stale_job_ids.map((value) => cliString(value)).filter((value) => Boolean(value)) : [];
+  const splitJobs = Array.isArray(riddle.split_jobs) ? riddle.split_jobs.map(cliRecord).filter((job) => Boolean(job)) : [];
   const parts = [
     mode ? `mode ${markdownInlineCode(mode)}` : "",
     jobCount === void 0 ? "" : `jobs ${jobCount}`,
@@ -16712,9 +16714,18 @@ function profileRiddleJobMarkdown(result) {
   ].filter(Boolean);
   const lines = parts.length ? [`- ${parts.join(", ")}`] : [];
   if (queueElapsedMs !== void 0 || elapsedMs3 !== void 0 || attempt !== void 0 || attempts !== void 0) {
-    lines.push(
-      `- poll: queue ${formatPollDuration(queueElapsedMs)}, elapsed ${formatPollDuration(elapsedMs3)}${preSubmissionElapsedMs === void 0 || preSubmissionElapsedMs < 1e3 ? "" : `, pre-submit ${formatPollDuration(preSubmissionElapsedMs)}`}${attempt === void 0 ? "" : `, attempt ${attempt}${attempts === void 0 ? "" : `/${attempts}`}`}`
-    );
+    if (splitJobs.length) {
+      const maxChildQueueElapsedMs = maxDefinedNumbers(splitJobs.map((job) => cliFiniteNumber(job.queue_elapsed_ms)));
+      const maxChildElapsedMs = maxDefinedNumbers(splitJobs.map((job) => cliFiniteNumber(job.elapsed_ms)));
+      const maxChildPreSubmissionElapsedMs = maxDefinedNumbers(splitJobs.map((job) => cliFiniteNumber(job.pre_submission_elapsed_ms)));
+      lines.push(
+        `- child poll totals: queue ${formatPollDuration(queueElapsedMs)}, elapsed ${formatPollDuration(elapsedMs3)}${preSubmissionElapsedMs === void 0 || preSubmissionElapsedMs < 1e3 ? "" : `, pre-submit ${formatPollDuration(preSubmissionElapsedMs)}`}; max child queue ${formatPollDuration(maxChildQueueElapsedMs)}, max child elapsed ${formatPollDuration(maxChildElapsedMs)}${maxChildPreSubmissionElapsedMs === void 0 || maxChildPreSubmissionElapsedMs < 1e3 ? "" : `, max child pre-submit ${formatPollDuration(maxChildPreSubmissionElapsedMs)}`}`
+      );
+    } else {
+      lines.push(
+        `- poll: queue ${formatPollDuration(queueElapsedMs)}, elapsed ${formatPollDuration(elapsedMs3)}${preSubmissionElapsedMs === void 0 || preSubmissionElapsedMs < 1e3 ? "" : `, pre-submit ${formatPollDuration(preSubmissionElapsedMs)}`}${attempt === void 0 ? "" : `, attempt ${attempt}${attempts === void 0 ? "" : `/${attempts}`}`}`
+      );
+    }
   }
   if (submittedAt || completedAt) {
     lines.push(`- timing:${submittedAt ? ` submitted ${markdownInlineCode(submittedAt)}` : ""}${completedAt ? ` completed ${markdownInlineCode(completedAt)}` : ""}`);
@@ -16725,7 +16736,6 @@ function profileRiddleJobMarkdown(result) {
   if (retryCount !== void 0 && retryCount > 0) {
     lines.push(`- retry recovery: replaced ${retryCount} unsubmitted job${retryCount === 1 ? "" : "s"}${staleJobIds.length ? ` (${staleJobIds.map((value) => markdownInlineCode(value)).join(", ")})` : ""}`);
   }
-  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);
@@ -16750,6 +16760,10 @@ function profileRiddleJobMarkdown(result) {
   if (splitJobs.length > 12) lines.push(`- ${splitJobs.length - 12} additional split job(s) omitted.`);
   return lines;
 }
+function maxDefinedNumbers(values) {
+  const numbers = values.filter((value) => typeof value === "number" && Number.isFinite(value));
+  return numbers.length ? Math.max(...numbers) : void 0;
+}
 function profileMetadataStringArray(value) {
   return Array.isArray(value) ? value.map((item) => typeof item === "string" ? item.trim() : "").filter((item) => Boolean(item)) : [];
 }
@@ -16838,32 +16852,64 @@ function profileIsCleanupInventoryReceipt(receipt) {
   const haystack = profileCleanupInventoryHaystack(receipt);
   return haystack.includes("cleanup") || haystack.includes("post-cleanup") || haystack.includes("stale") || haystack.includes("statehygiene") || haystack.includes("state hygiene") || haystack.includes("remained after") || haystack.includes("still present");
 }
-function profileFailedCleanupInventoryReason(setupViewports) {
-  const receipts = setupViewports.flatMap((viewport) => [
+function profileIsCleanupPhaseInventoryReceipt(receipt) {
+  const storedTo = (cliString(receipt.return_stored_to) || "").toLowerCase();
+  const storedSegments = storedTo.split(/[.[\]/]/).filter(Boolean);
+  const storedSegment = storedSegments[storedSegments.length - 1] || storedTo;
+  const state = (cliString(setupReturnSummaryValue(receipt, ["state", "phase"])) || "").toLowerCase();
+  const summary = (cliReturnSummaryLabel(receipt.return_summary) || "").toLowerCase();
+  const markers = [storedSegment, state, summary];
+  return markers.some((marker) => marker === "cleanup" || marker === "postcleanup" || marker === "post-cleanup" || marker === "aftercleanup" || marker === "after-cleanup" || marker.includes("post-cleanup") || marker.includes("after-cleanup") || marker.includes("after-clear") || marker.includes("after-reset") || marker.includes("after-undo") || marker.includes("after-discard") || marker.includes("after-new"));
+}
+function profileCleanupPhaseInventoryReceipts(setupViewports) {
+  return setupViewports.flatMap((viewport) => [
     ...setupReceiptArray(viewport, "window_eval"),
     ...setupReceiptArray(viewport, "window_call")
-  ]);
-  for (const receipt of receipts) {
-    if (receipt.ok !== false) continue;
-    if (!profileIsCleanupInventoryReceipt(receipt)) continue;
+  ]).filter((receipt) => profileIsCleanupInventoryReceipt(receipt) && profileIsCleanupPhaseInventoryReceipt(receipt));
+}
+function profileFailedCleanupInventoryReceiptReason(receipt) {
+  if (receipt.ok === false) {
     const error = cliString(receipt.error);
     const reason = cliString(receipt.reason);
     return compactProfileReceiptReason(error) || compactProfileReceiptReason(reason) || "cleanup inventory failed";
   }
+  const parts = [];
+  if (setupReturnedSummaryValue(receipt, ["ok"]) === false) parts.push("ok=false");
+  if (setupReturnedSummaryValue(receipt, ["success"]) === false) parts.push("success=false");
+  const staleCount = cliFiniteNumber(setupReturnSummaryValue(receipt, ["staleCount"]));
+  if (staleCount !== void 0 && staleCount > 0) parts.push(`staleCount=${staleCount}`);
+  const staleNames = setupReturnSummaryValue(receipt, ["staleNames"]);
+  if (Array.isArray(staleNames) && staleNames.length > 0) {
+    const staleNamesLabel = cliValueLabel(staleNames);
+    if (staleNamesLabel) parts.push(`staleNames=${compactProfileReceiptReason(staleNamesLabel, 120) ?? staleNamesLabel}`);
+  }
+  const productIssue = setupReturnedSummaryValue(receipt, ["productIssue", "issue"]);
+  const productIssueLabel = typeof productIssue === "string" ? compactProfileReceiptReason(productIssue, 120) : void 0;
+  if (parts.length && productIssueLabel) parts.push(productIssueLabel);
+  return parts.length ? parts.join(", ") : void 0;
+}
+function profileFailedCleanupInventoryReason(setupViewports) {
+  const receipts = profileCleanupPhaseInventoryReceipts(setupViewports);
+  for (const receipt of [...receipts].reverse()) {
+    const reason = profileFailedCleanupInventoryReceiptReason(receipt);
+    if (reason) return reason;
+  }
   return void 0;
 }
+function profilePassedCleanupInventoryReceiptReason(receipt) {
+  if (receipt.ok === false) return void 0;
+  if (setupReturnedSummaryValue(receipt, ["ok"]) === false) return void 0;
+  if (setupReturnedSummaryValue(receipt, ["success"]) === false) return void 0;
+  const staleCount = cliFiniteNumber(setupReturnSummaryValue(receipt, ["staleCount"]));
+  const staleNames = setupReturnSummaryValue(receipt, ["staleNames"]);
+  if (staleCount !== 0 || !Array.isArray(staleNames) || staleNames.length !== 0) return void 0;
+  return "staleCount=0, staleNames=[]";
+}
 function profilePassedCleanupInventoryReason(setupViewports) {
-  const receipts = setupViewports.flatMap((viewport) => [
-    ...setupReceiptArray(viewport, "window_eval"),
-    ...setupReceiptArray(viewport, "window_call")
-  ]);
-  for (const receipt of receipts) {
-    if (receipt.ok === false || !profileIsCleanupInventoryReceipt(receipt)) continue;
-    if (setupReturnSummaryValue(receipt, ["ok"]) === false) continue;
-    const staleCount = cliFiniteNumber(setupReturnSummaryValue(receipt, ["staleCount"]));
-    const staleNames = setupReturnSummaryValue(receipt, ["staleNames"]);
-    if (staleCount !== 0 || !Array.isArray(staleNames) || staleNames.length !== 0) continue;
-    return "staleCount=0, staleNames=[]";
+  const receipts = profileCleanupPhaseInventoryReceipts(setupViewports);
+  for (const receipt of [...receipts].reverse()) {
+    const reason = profilePassedCleanupInventoryReceiptReason(receipt);
+    if (reason) return reason;
   }
   return void 0;
 }
@@ -17045,15 +17091,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) {
@@ -17606,6 +17654,9 @@ function setupReturnSummaryValue(receipt, names) {
   for (const name of names) {
     if (receipt[name] !== void 0) return receipt[name];
   }
+  return setupReturnedSummaryValue(receipt, names);
+}
+function setupReturnedSummaryValue(receipt, names) {
   const returned = cliRecord(receipt.returned);
   for (const name of names) {
     if (returned?.[name] !== void 0) return returned[name];
@@ -18911,6 +18962,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 +19044,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 +19061,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 +19319,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 +19457,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]",
@@ -528,6 +529,7 @@ function profileRiddleJobMarkdown(result) {
   const artifactRecovery = riddle.artifact_recovery === true;
   const retryCount = cliFiniteNumber(riddle.retry_count);
   const staleJobIds = Array.isArray(riddle.stale_job_ids) ? riddle.stale_job_ids.map((value) => cliString(value)).filter((value) => Boolean(value)) : [];
+  const splitJobs = Array.isArray(riddle.split_jobs) ? riddle.split_jobs.map(cliRecord).filter((job) => Boolean(job)) : [];
   const parts = [
     mode ? `mode ${markdownInlineCode(mode)}` : "",
     jobCount === void 0 ? "" : `jobs ${jobCount}`,
@@ -537,9 +539,18 @@ function profileRiddleJobMarkdown(result) {
   ].filter(Boolean);
   const lines = parts.length ? [`- ${parts.join(", ")}`] : [];
   if (queueElapsedMs !== void 0 || elapsedMs !== void 0 || attempt !== void 0 || attempts !== void 0) {
-    lines.push(
-      `- poll: queue ${formatPollDuration(queueElapsedMs)}, elapsed ${formatPollDuration(elapsedMs)}${preSubmissionElapsedMs === void 0 || preSubmissionElapsedMs < 1e3 ? "" : `, pre-submit ${formatPollDuration(preSubmissionElapsedMs)}`}${attempt === void 0 ? "" : `, attempt ${attempt}${attempts === void 0 ? "" : `/${attempts}`}`}`
-    );
+    if (splitJobs.length) {
+      const maxChildQueueElapsedMs = maxDefinedNumbers(splitJobs.map((job) => cliFiniteNumber(job.queue_elapsed_ms)));
+      const maxChildElapsedMs = maxDefinedNumbers(splitJobs.map((job) => cliFiniteNumber(job.elapsed_ms)));
+      const maxChildPreSubmissionElapsedMs = maxDefinedNumbers(splitJobs.map((job) => cliFiniteNumber(job.pre_submission_elapsed_ms)));
+      lines.push(
+        `- child poll totals: queue ${formatPollDuration(queueElapsedMs)}, elapsed ${formatPollDuration(elapsedMs)}${preSubmissionElapsedMs === void 0 || preSubmissionElapsedMs < 1e3 ? "" : `, pre-submit ${formatPollDuration(preSubmissionElapsedMs)}`}; max child queue ${formatPollDuration(maxChildQueueElapsedMs)}, max child elapsed ${formatPollDuration(maxChildElapsedMs)}${maxChildPreSubmissionElapsedMs === void 0 || maxChildPreSubmissionElapsedMs < 1e3 ? "" : `, max child pre-submit ${formatPollDuration(maxChildPreSubmissionElapsedMs)}`}`
+      );
+    } else {
+      lines.push(
+        `- poll: queue ${formatPollDuration(queueElapsedMs)}, elapsed ${formatPollDuration(elapsedMs)}${preSubmissionElapsedMs === void 0 || preSubmissionElapsedMs < 1e3 ? "" : `, pre-submit ${formatPollDuration(preSubmissionElapsedMs)}`}${attempt === void 0 ? "" : `, attempt ${attempt}${attempts === void 0 ? "" : `/${attempts}`}`}`
+      );
+    }
   }
   if (submittedAt || completedAt) {
     lines.push(`- timing:${submittedAt ? ` submitted ${markdownInlineCode(submittedAt)}` : ""}${completedAt ? ` completed ${markdownInlineCode(completedAt)}` : ""}`);
@@ -550,7 +561,6 @@ function profileRiddleJobMarkdown(result) {
   if (retryCount !== void 0 && retryCount > 0) {
     lines.push(`- retry recovery: replaced ${retryCount} unsubmitted job${retryCount === 1 ? "" : "s"}${staleJobIds.length ? ` (${staleJobIds.map((value) => markdownInlineCode(value)).join(", ")})` : ""}`);
   }
-  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);
@@ -575,6 +585,10 @@ function profileRiddleJobMarkdown(result) {
   if (splitJobs.length > 12) lines.push(`- ${splitJobs.length - 12} additional split job(s) omitted.`);
   return lines;
 }
+function maxDefinedNumbers(values) {
+  const numbers = values.filter((value) => typeof value === "number" && Number.isFinite(value));
+  return numbers.length ? Math.max(...numbers) : void 0;
+}
 function profileMetadataStringArray(value) {
   return Array.isArray(value) ? value.map((item) => typeof item === "string" ? item.trim() : "").filter((item) => Boolean(item)) : [];
 }
@@ -663,32 +677,64 @@ function profileIsCleanupInventoryReceipt(receipt) {
   const haystack = profileCleanupInventoryHaystack(receipt);
   return haystack.includes("cleanup") || haystack.includes("post-cleanup") || haystack.includes("stale") || haystack.includes("statehygiene") || haystack.includes("state hygiene") || haystack.includes("remained after") || haystack.includes("still present");
 }
-function profileFailedCleanupInventoryReason(setupViewports) {
-  const receipts = setupViewports.flatMap((viewport) => [
+function profileIsCleanupPhaseInventoryReceipt(receipt) {
+  const storedTo = (cliString(receipt.return_stored_to) || "").toLowerCase();
+  const storedSegments = storedTo.split(/[.[\]/]/).filter(Boolean);
+  const storedSegment = storedSegments[storedSegments.length - 1] || storedTo;
+  const state = (cliString(setupReturnSummaryValue(receipt, ["state", "phase"])) || "").toLowerCase();
+  const summary = (cliReturnSummaryLabel(receipt.return_summary) || "").toLowerCase();
+  const markers = [storedSegment, state, summary];
+  return markers.some((marker) => marker === "cleanup" || marker === "postcleanup" || marker === "post-cleanup" || marker === "aftercleanup" || marker === "after-cleanup" || marker.includes("post-cleanup") || marker.includes("after-cleanup") || marker.includes("after-clear") || marker.includes("after-reset") || marker.includes("after-undo") || marker.includes("after-discard") || marker.includes("after-new"));
+}
+function profileCleanupPhaseInventoryReceipts(setupViewports) {
+  return setupViewports.flatMap((viewport) => [
     ...setupReceiptArray(viewport, "window_eval"),
     ...setupReceiptArray(viewport, "window_call")
-  ]);
-  for (const receipt of receipts) {
-    if (receipt.ok !== false) continue;
-    if (!profileIsCleanupInventoryReceipt(receipt)) continue;
+  ]).filter((receipt) => profileIsCleanupInventoryReceipt(receipt) && profileIsCleanupPhaseInventoryReceipt(receipt));
+}
+function profileFailedCleanupInventoryReceiptReason(receipt) {
+  if (receipt.ok === false) {
     const error = cliString(receipt.error);
     const reason = cliString(receipt.reason);
     return compactProfileReceiptReason(error) || compactProfileReceiptReason(reason) || "cleanup inventory failed";
   }
+  const parts = [];
+  if (setupReturnedSummaryValue(receipt, ["ok"]) === false) parts.push("ok=false");
+  if (setupReturnedSummaryValue(receipt, ["success"]) === false) parts.push("success=false");
+  const staleCount = cliFiniteNumber(setupReturnSummaryValue(receipt, ["staleCount"]));
+  if (staleCount !== void 0 && staleCount > 0) parts.push(`staleCount=${staleCount}`);
+  const staleNames = setupReturnSummaryValue(receipt, ["staleNames"]);
+  if (Array.isArray(staleNames) && staleNames.length > 0) {
+    const staleNamesLabel = cliValueLabel(staleNames);
+    if (staleNamesLabel) parts.push(`staleNames=${compactProfileReceiptReason(staleNamesLabel, 120) ?? staleNamesLabel}`);
+  }
+  const productIssue = setupReturnedSummaryValue(receipt, ["productIssue", "issue"]);
+  const productIssueLabel = typeof productIssue === "string" ? compactProfileReceiptReason(productIssue, 120) : void 0;
+  if (parts.length && productIssueLabel) parts.push(productIssueLabel);
+  return parts.length ? parts.join(", ") : void 0;
+}
+function profileFailedCleanupInventoryReason(setupViewports) {
+  const receipts = profileCleanupPhaseInventoryReceipts(setupViewports);
+  for (const receipt of [...receipts].reverse()) {
+    const reason = profileFailedCleanupInventoryReceiptReason(receipt);
+    if (reason) return reason;
+  }
   return void 0;
 }
+function profilePassedCleanupInventoryReceiptReason(receipt) {
+  if (receipt.ok === false) return void 0;
+  if (setupReturnedSummaryValue(receipt, ["ok"]) === false) return void 0;
+  if (setupReturnedSummaryValue(receipt, ["success"]) === false) return void 0;
+  const staleCount = cliFiniteNumber(setupReturnSummaryValue(receipt, ["staleCount"]));
+  const staleNames = setupReturnSummaryValue(receipt, ["staleNames"]);
+  if (staleCount !== 0 || !Array.isArray(staleNames) || staleNames.length !== 0) return void 0;
+  return "staleCount=0, staleNames=[]";
+}
 function profilePassedCleanupInventoryReason(setupViewports) {
-  const receipts = setupViewports.flatMap((viewport) => [
-    ...setupReceiptArray(viewport, "window_eval"),
-    ...setupReceiptArray(viewport, "window_call")
-  ]);
-  for (const receipt of receipts) {
-    if (receipt.ok === false || !profileIsCleanupInventoryReceipt(receipt)) continue;
-    if (setupReturnSummaryValue(receipt, ["ok"]) === false) continue;
-    const staleCount = cliFiniteNumber(setupReturnSummaryValue(receipt, ["staleCount"]));
-    const staleNames = setupReturnSummaryValue(receipt, ["staleNames"]);
-    if (staleCount !== 0 || !Array.isArray(staleNames) || staleNames.length !== 0) continue;
-    return "staleCount=0, staleNames=[]";
+  const receipts = profileCleanupPhaseInventoryReceipts(setupViewports);
+  for (const receipt of [...receipts].reverse()) {
+    const reason = profilePassedCleanupInventoryReceiptReason(receipt);
+    if (reason) return reason;
   }
   return void 0;
 }
@@ -870,15 +916,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) {
@@ -1431,6 +1479,9 @@ function setupReturnSummaryValue(receipt, names) {
   for (const name of names) {
     if (receipt[name] !== void 0) return receipt[name];
   }
+  return setupReturnedSummaryValue(receipt, names);
+}
+function setupReturnedSummaryValue(receipt, names) {
   const returned = cliRecord(receipt.returned);
   for (const name of names) {
     if (returned?.[name] !== void 0) return returned[name];
@@ -2736,6 +2787,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 +2869,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 +2886,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 +3144,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 +3282,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.204",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",