@riddledc/riddle-proof 0.8.57 → 0.8.59

package/dist/{chunk-JR7GFTLS.js → chunk-2PKBTYOA.js}

@@ -1,3 +1,7 @@
+import {
+  summarizeRiddleProofPublicState
+} from "./chunk-KG64Y5MC.js";
+
 // src/pr-comment.ts
 var RIDDLE_PROOF_PR_COMMENT_MARKER = "<!-- riddle-proof:pr-comment:v1 -->";
 function asRecord(value) {
@@ -22,13 +26,6 @@ function firstStringValue(...values) {
   }
   return void 0;
 }
-function firstBooleanValue(...values) {
-  for (const value of values) {
-    const bool = booleanValue(value);
-    if (typeof bool === "boolean") return bool;
-  }
-  return void 0;
-}
 function artifactKind(name, url) {
   const target = `${name} ${url}`.toLowerCase();
   if (/\.(png|jpe?g|gif|webp|avif|svg)(\?|#|$)/.test(target)) return "image";
@@ -150,10 +147,15 @@ function summarizeRiddleProofPrComment(input) {
     rawDetails.checkpoint_summary,
     proofResult.checkpoint_summary
   );
+  const publicState = summarizeRiddleProofPublicState({
+    ...result,
+    status: firstStringValue(result.status, stopCondition.status),
+    checkpoint_summary: checkpointSummary || result.checkpoint_summary
+  });
   return {
     ok,
     status: stringValue(proofResult.status),
-    result_status: firstStringValue(result.status, stopCondition.status),
+    result_status: publicState.status,
     job_id: stringValue(proofResult.job_id),
     duration_ms: numberValue(proofResult.duration_ms),
     proof_url: stringValue(runResponse.proofUrl),
@@ -161,12 +163,15 @@ function summarizeRiddleProofPrComment(input) {
     preview_url: stringValue(preview.preview_url) || stringValue(preview.url),
     preview_publish_recovered: booleanValue(preview.publish_recovered),
     preview_publish_error: stringValue(preview.publish_error),
-    ship_held: firstBooleanValue(result.ship_held, stopCondition.ship_held, resultRaw.ship_held),
-    shipping_disabled: firstBooleanValue(result.shipping_disabled, stopCondition.shipping_disabled, resultRaw.shipping_disabled),
-    ship_authorized: firstBooleanValue(result.ship_authorized, stopCondition.ship_authorized, resultRaw.ship_authorized),
+    ship_held: publicState.ship_held,
+    shipping_disabled: publicState.shipping_disabled,
+    ship_authorized: publicState.ship_authorized,
+    merge_ready: publicState.merge_ready,
+    sync_allowed: publicState.sync_allowed,
     proof_decision: firstStringValue(result.proof_decision, stopCondition.proof_decision, resultRaw.proof_decision),
     merge_recommendation: firstStringValue(result.merge_recommendation, stopCondition.merge_recommendation, resultRaw.merge_recommendation),
     checkpoint_summary: checkpointSummary,
+    public_state: publicState,
     passed_checks: nestedChecks.passed,
     failed_checks: nestedChecks.failed,
     pages,
@@ -185,6 +190,7 @@ function markdownLink(label, url) {
   return `[${label.replace(/\]/g, "\\]")}](${url})`;
 }
 function resultLabel(summary) {
+  if (summary.public_state?.result_label) return summary.public_state.result_label;
   if (summary.ok === true) {
     if (summary.result_status === "shipped") return "shipped";
     if (summary.result_status === "completed") return "completed";
@@ -211,6 +217,14 @@ function formatBool(value) {
 function hasShipControl(summary) {
   return typeof summary.ship_held === "boolean" || typeof summary.shipping_disabled === "boolean" || typeof summary.ship_authorized === "boolean";
 }
+function hasHandoffControl(summary) {
+  return typeof summary.merge_ready === "boolean" || typeof summary.sync_allowed === "boolean";
+}
+function shouldRenderMergeRecommendation(summary) {
+  if (!summary.merge_recommendation) return false;
+  const prohibited = summary.public_state?.prohibited_claims || [];
+  return !prohibited.includes("merge_ready") && !prohibited.includes("sync_allowed");
+}
 function checkpointSummaryLine(summary) {
   const accepted = summary.response_count ?? 0;
   const rejected = summary.rejected_response_count ?? 0;
@@ -242,8 +256,11 @@ function buildRiddleProofPrCommentMarkdown(input) {
   if (hasShipControl(summary)) {
     lines.push(`**Ship control:** held=${formatBool(summary.ship_held)}, shipping_disabled=${formatBool(summary.shipping_disabled)}, authorized=${formatBool(summary.ship_authorized)}`);
   }
+  if (hasHandoffControl(summary)) {
+    lines.push(`**Handoff:** merge_ready=${formatBool(summary.merge_ready)}, sync_allowed=${formatBool(summary.sync_allowed)}`);
+  }
   if (summary.proof_decision) lines.push(`**Proof decision:** \`${summary.proof_decision}\``);
-  if (summary.merge_recommendation) lines.push(`**Merge recommendation:** ${summary.merge_recommendation}`);
+  if (shouldRenderMergeRecommendation(summary)) lines.push(`**Merge recommendation:** ${summary.merge_recommendation}`);
   if (summary.checkpoint_summary) lines.push(`**Checkpoints:** ${checkpointSummaryLine(summary.checkpoint_summary)}`);
   if (summary.proof_url) lines.push(`**Proof URL:** ${markdownLink(summary.proof_url, summary.proof_url)}`);
   if (summary.preview_id || summary.preview_url) {

package/dist/chunk-KG64Y5MC.js

@@ -0,0 +1,155 @@
+// src/public-state.ts
+function asRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function stringValue(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function booleanValue(value) {
+  return typeof value === "boolean" ? value : void 0;
+}
+function numberValue(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function firstStringValue(...values) {
+  for (const value of values) {
+    const text = stringValue(value);
+    if (text) return text;
+  }
+  return void 0;
+}
+function firstBooleanValue(...values) {
+  for (const value of values) {
+    const bool = booleanValue(value);
+    if (typeof bool === "boolean") return bool;
+  }
+  return void 0;
+}
+function firstRecordValue(...values) {
+  for (const value of values) {
+    const record = asRecord(value);
+    if (Object.keys(record).length) return record;
+  }
+  return void 0;
+}
+function countValue(value) {
+  const number = numberValue(value);
+  return typeof number === "number" && number > 0 ? Math.trunc(number) : 0;
+}
+function checkpointSummaryFrom(...values) {
+  const record = firstRecordValue(...values);
+  if (!record) return void 0;
+  const accepted = countValue(record.response_count);
+  const rejected = countValue(record.rejected_response_count);
+  const ignored = countValue(record.ignored_response_count);
+  const duplicate = countValue(record.duplicate_response_count);
+  const summary = {
+    pending: booleanValue(record.pending),
+    accepted_response_count: accepted,
+    rejected_response_count: rejected,
+    ignored_response_count: ignored,
+    duplicate_response_count: duplicate,
+    latest_decision: stringValue(record.latest_decision),
+    audit_disclosure_required: rejected > 0 || ignored > 0 || duplicate > 0
+  };
+  return Object.values(summary).some((value) => typeof value !== "undefined") ? summary : void 0;
+}
+function uniqueStrings(values) {
+  return [...new Set(values.filter(Boolean))];
+}
+function summarizeRiddleProofPublicState(input) {
+  const record = asRecord(input);
+  const runCard = asRecord(record.run_card);
+  const stopCondition = asRecord(runCard.stop_condition);
+  const raw = asRecord(record.raw);
+  const request = asRecord(record.request);
+  const requestMetadata = asRecord(record.request_metadata);
+  const prState = asRecord(record.pr_state);
+  const handoff = asRecord(record.pr_handoff_policy);
+  const handoffState = stringValue(handoff.state);
+  const status = firstStringValue(record.status, stopCondition.status);
+  const ok = booleanValue(record.ok) ?? null;
+  const shipMode = firstStringValue(request.ship_mode, requestMetadata.ship_mode, record.ship_mode, handoff.ship_mode);
+  const explicitShippingDisabled = firstBooleanValue(
+    record.shipping_disabled,
+    stopCondition.shipping_disabled,
+    raw.shipping_disabled,
+    handoff.shipping_disabled
+  );
+  const shippingDisabled = explicitShippingDisabled === true || shipMode === "none" || handoffState === "proof_complete_ship_disabled";
+  const explicitShipAuthorized = firstBooleanValue(
+    record.ship_authorized,
+    stopCondition.ship_authorized,
+    raw.ship_authorized
+  );
+  const authorizationEvidence = Boolean(
+    status === "shipped" || record.marked_ready === true || stringValue(prState.status) === "merged" || record.merge_commit || record.merged_at
+  );
+  const shipAuthorizedBeforeHold = explicitShipAuthorized ?? authorizationEvidence;
+  const explicitShipHeld = firstBooleanValue(record.ship_held, stopCondition.ship_held, raw.ship_held);
+  const inferredHeld = status === "ready_to_ship" && shippingDisabled && !shipAuthorizedBeforeHold;
+  const shipHeld = explicitShipHeld === true || inferredHeld;
+  const shipAuthorized = shipHeld ? false : shipAuthorizedBeforeHold === true;
+  const proofComplete = Boolean(
+    status === "ready_to_ship" || status === "shipped" || status === "completed" || status === "passed" || ok === true || handoff.proof_complete === true
+  );
+  const checkpointSummary = checkpointSummaryFrom(
+    record.checkpoint_summary,
+    stopCondition.checkpoint_summary,
+    asRecord(record.details).checkpoint_summary,
+    asRecord(raw.details).checkpoint_summary
+  );
+  const blockedOrWaiting = status === "blocked" || status === "failed" || status === "awaiting_checkpoint" || handoffState === "proof_blocked" || handoffState === "proof_review_required" || handoffState === "proof_failed" || handoffState === "proof_checkpoint_required";
+  const proofPassed = Boolean(proofComplete && !blockedOrWaiting);
+  const explicitMergeReady = firstBooleanValue(record.merge_ready, stopCondition.merge_ready, raw.merge_ready, handoff.merge_ready);
+  const normalPrAllowed = firstBooleanValue(record.normal_pr_allowed, raw.normal_pr_allowed, handoff.normal_pr_allowed);
+  const baseHandoffAllowed = !blockedOrWaiting && !shipHeld && !shippingDisabled;
+  const mergeReady = baseHandoffAllowed && normalPrAllowed !== false && (explicitMergeReady ?? shipAuthorized);
+  const syncAllowed = mergeReady;
+  let policyState = "unknown";
+  if (status === "awaiting_checkpoint" || handoffState === "proof_checkpoint_required") policyState = "awaiting_checkpoint";
+  else if (status === "failed" || handoffState === "proof_failed") policyState = "proof_failed";
+  else if (status === "blocked" || handoffState === "proof_blocked" || handoffState === "proof_review_required") policyState = "proof_blocked";
+  else if (handoffState === "proof_complete_ship_disabled") policyState = "proof_complete_ship_disabled";
+  else if (proofComplete && shipHeld && !shipAuthorized) policyState = "proof_passed_ship_held";
+  else if (proofComplete && shippingDisabled && !shipAuthorized) policyState = "proof_complete_ship_disabled";
+  else if (shipAuthorized) policyState = "ship_authorized";
+  else if (proofPassed) policyState = "proof_passed";
+  else if (status === "running") policyState = "proof_in_progress";
+  const requiredDisclosures = [];
+  if (shipHeld) requiredDisclosures.push("ship_held");
+  if (shippingDisabled) requiredDisclosures.push("shipping_disabled");
+  if (checkpointSummary?.audit_disclosure_required) requiredDisclosures.push("checkpoint_audit_counters");
+  if (status === "awaiting_checkpoint" || handoffState === "proof_checkpoint_required") requiredDisclosures.push("checkpoint_required");
+  const prohibitedClaims = [];
+  if (!shipAuthorized || shipHeld || shippingDisabled) prohibitedClaims.push("ship_authorized", "shipped");
+  if (!mergeReady) prohibitedClaims.push("merge_ready");
+  if (!syncAllowed) prohibitedClaims.push("sync_allowed");
+  if (blockedOrWaiting) {
+    prohibitedClaims.push("proof_passed", "ready_to_ship");
+  }
+  if (checkpointSummary?.audit_disclosure_required) {
+    prohibitedClaims.push("all_checkpoint_responses_accepted");
+  }
+  const resultLabel = policyState === "awaiting_checkpoint" ? "checkpoint required" : policyState === "proof_blocked" ? "blocked" : policyState === "proof_failed" ? "failed" : policyState === "proof_complete_ship_disabled" ? "proof complete; shipping disabled" : policyState === "proof_passed_ship_held" ? "proof passed; ship held" : policyState === "ship_authorized" ? status === "shipped" ? "shipped" : "ship authorized" : policyState === "proof_passed" ? "passed" : policyState === "proof_in_progress" ? "running" : status || "recorded";
+  return {
+    status,
+    ok,
+    policy_state: policyState,
+    result_label: resultLabel,
+    proof_complete: proofComplete,
+    proof_passed: proofPassed,
+    ship_held: shipHeld,
+    shipping_disabled: shippingDisabled,
+    ship_authorized: shipAuthorized,
+    merge_ready: mergeReady,
+    sync_allowed: syncAllowed,
+    checkpoint_summary: checkpointSummary,
+    required_disclosures: uniqueStrings(requiredDisclosures),
+    prohibited_claims: uniqueStrings(prohibitedClaims)
+  };
+}
+
+export {
+  summarizeRiddleProofPublicState
+};

package/dist/{chunk-LUFT7AGY.js → chunk-XSNMMAPJ.js}

@@ -7,7 +7,7 @@ import {
   RIDDLE_PROOF_PR_COMMENT_MARKER,
   buildRiddleProofPrCommentMarkdown,
   summarizeRiddleProofPrComment
-} from "./chunk-JR7GFTLS.js";
+} from "./chunk-2PKBTYOA.js";
 import {
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,
   applyRiddleProofProfileArtifactCompleteness,

package/dist/cli/index.js

@@ -1,7 +1,8 @@
-import "../chunk-LUFT7AGY.js";
+import "../chunk-XSNMMAPJ.js";
 import "../chunk-DI2XNGEZ.js";
-import "../chunk-JR7GFTLS.js";
+import "../chunk-2PKBTYOA.js";
 import "../chunk-EX7TO4I5.js";
+import "../chunk-KG64Y5MC.js";
 import "../chunk-GHBNDHG7.js";
 import "../chunk-UZIX7M7D.js";
 import "../chunk-KNPCWWF3.js";

package/dist/cli.cjs

@@ -17721,23 +17721,19 @@ function extractRiddleProofProfileResult(input) {
   return void 0;
 }
 
-// src/pr-comment.ts
-var RIDDLE_PROOF_PR_COMMENT_MARKER = "<!-- riddle-proof:pr-comment:v1 -->";
+// src/public-state.ts
 function asRecord(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
-function asArray(value) {
-  return Array.isArray(value) ? value : [];
-}
 function stringValue3(value) {
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
-function numberValue2(value) {
-  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
-}
 function booleanValue2(value) {
   return typeof value === "boolean" ? value : void 0;
 }
+function numberValue2(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
 function firstStringValue(...values) {
   for (const value of values) {
     const text = stringValue3(value);
@@ -17752,6 +17748,155 @@ function firstBooleanValue(...values) {
   }
   return void 0;
 }
+function firstRecordValue(...values) {
+  for (const value of values) {
+    const record = asRecord(value);
+    if (Object.keys(record).length) return record;
+  }
+  return void 0;
+}
+function countValue(value) {
+  const number = numberValue2(value);
+  return typeof number === "number" && number > 0 ? Math.trunc(number) : 0;
+}
+function checkpointSummaryFrom(...values) {
+  const record = firstRecordValue(...values);
+  if (!record) return void 0;
+  const accepted = countValue(record.response_count);
+  const rejected = countValue(record.rejected_response_count);
+  const ignored = countValue(record.ignored_response_count);
+  const duplicate = countValue(record.duplicate_response_count);
+  const summary = {
+    pending: booleanValue2(record.pending),
+    accepted_response_count: accepted,
+    rejected_response_count: rejected,
+    ignored_response_count: ignored,
+    duplicate_response_count: duplicate,
+    latest_decision: stringValue3(record.latest_decision),
+    audit_disclosure_required: rejected > 0 || ignored > 0 || duplicate > 0
+  };
+  return Object.values(summary).some((value) => typeof value !== "undefined") ? summary : void 0;
+}
+function uniqueStrings(values) {
+  return [...new Set(values.filter(Boolean))];
+}
+function summarizeRiddleProofPublicState(input) {
+  const record = asRecord(input);
+  const runCard = asRecord(record.run_card);
+  const stopCondition = asRecord(runCard.stop_condition);
+  const raw = asRecord(record.raw);
+  const request = asRecord(record.request);
+  const requestMetadata = asRecord(record.request_metadata);
+  const prState = asRecord(record.pr_state);
+  const handoff = asRecord(record.pr_handoff_policy);
+  const handoffState = stringValue3(handoff.state);
+  const status = firstStringValue(record.status, stopCondition.status);
+  const ok = booleanValue2(record.ok) ?? null;
+  const shipMode = firstStringValue(request.ship_mode, requestMetadata.ship_mode, record.ship_mode, handoff.ship_mode);
+  const explicitShippingDisabled = firstBooleanValue(
+    record.shipping_disabled,
+    stopCondition.shipping_disabled,
+    raw.shipping_disabled,
+    handoff.shipping_disabled
+  );
+  const shippingDisabled = explicitShippingDisabled === true || shipMode === "none" || handoffState === "proof_complete_ship_disabled";
+  const explicitShipAuthorized = firstBooleanValue(
+    record.ship_authorized,
+    stopCondition.ship_authorized,
+    raw.ship_authorized
+  );
+  const authorizationEvidence = Boolean(
+    status === "shipped" || record.marked_ready === true || stringValue3(prState.status) === "merged" || record.merge_commit || record.merged_at
+  );
+  const shipAuthorizedBeforeHold = explicitShipAuthorized ?? authorizationEvidence;
+  const explicitShipHeld = firstBooleanValue(record.ship_held, stopCondition.ship_held, raw.ship_held);
+  const inferredHeld = status === "ready_to_ship" && shippingDisabled && !shipAuthorizedBeforeHold;
+  const shipHeld = explicitShipHeld === true || inferredHeld;
+  const shipAuthorized = shipHeld ? false : shipAuthorizedBeforeHold === true;
+  const proofComplete = Boolean(
+    status === "ready_to_ship" || status === "shipped" || status === "completed" || status === "passed" || ok === true || handoff.proof_complete === true
+  );
+  const checkpointSummary = checkpointSummaryFrom(
+    record.checkpoint_summary,
+    stopCondition.checkpoint_summary,
+    asRecord(record.details).checkpoint_summary,
+    asRecord(raw.details).checkpoint_summary
+  );
+  const blockedOrWaiting = status === "blocked" || status === "failed" || status === "awaiting_checkpoint" || handoffState === "proof_blocked" || handoffState === "proof_review_required" || handoffState === "proof_failed" || handoffState === "proof_checkpoint_required";
+  const proofPassed = Boolean(proofComplete && !blockedOrWaiting);
+  const explicitMergeReady = firstBooleanValue(record.merge_ready, stopCondition.merge_ready, raw.merge_ready, handoff.merge_ready);
+  const normalPrAllowed = firstBooleanValue(record.normal_pr_allowed, raw.normal_pr_allowed, handoff.normal_pr_allowed);
+  const baseHandoffAllowed = !blockedOrWaiting && !shipHeld && !shippingDisabled;
+  const mergeReady = baseHandoffAllowed && normalPrAllowed !== false && (explicitMergeReady ?? shipAuthorized);
+  const syncAllowed = mergeReady;
+  let policyState = "unknown";
+  if (status === "awaiting_checkpoint" || handoffState === "proof_checkpoint_required") policyState = "awaiting_checkpoint";
+  else if (status === "failed" || handoffState === "proof_failed") policyState = "proof_failed";
+  else if (status === "blocked" || handoffState === "proof_blocked" || handoffState === "proof_review_required") policyState = "proof_blocked";
+  else if (handoffState === "proof_complete_ship_disabled") policyState = "proof_complete_ship_disabled";
+  else if (proofComplete && shipHeld && !shipAuthorized) policyState = "proof_passed_ship_held";
+  else if (proofComplete && shippingDisabled && !shipAuthorized) policyState = "proof_complete_ship_disabled";
+  else if (shipAuthorized) policyState = "ship_authorized";
+  else if (proofPassed) policyState = "proof_passed";
+  else if (status === "running") policyState = "proof_in_progress";
+  const requiredDisclosures = [];
+  if (shipHeld) requiredDisclosures.push("ship_held");
+  if (shippingDisabled) requiredDisclosures.push("shipping_disabled");
+  if (checkpointSummary?.audit_disclosure_required) requiredDisclosures.push("checkpoint_audit_counters");
+  if (status === "awaiting_checkpoint" || handoffState === "proof_checkpoint_required") requiredDisclosures.push("checkpoint_required");
+  const prohibitedClaims = [];
+  if (!shipAuthorized || shipHeld || shippingDisabled) prohibitedClaims.push("ship_authorized", "shipped");
+  if (!mergeReady) prohibitedClaims.push("merge_ready");
+  if (!syncAllowed) prohibitedClaims.push("sync_allowed");
+  if (blockedOrWaiting) {
+    prohibitedClaims.push("proof_passed", "ready_to_ship");
+  }
+  if (checkpointSummary?.audit_disclosure_required) {
+    prohibitedClaims.push("all_checkpoint_responses_accepted");
+  }
+  const resultLabel2 = policyState === "awaiting_checkpoint" ? "checkpoint required" : policyState === "proof_blocked" ? "blocked" : policyState === "proof_failed" ? "failed" : policyState === "proof_complete_ship_disabled" ? "proof complete; shipping disabled" : policyState === "proof_passed_ship_held" ? "proof passed; ship held" : policyState === "ship_authorized" ? status === "shipped" ? "shipped" : "ship authorized" : policyState === "proof_passed" ? "passed" : policyState === "proof_in_progress" ? "running" : status || "recorded";
+  return {
+    status,
+    ok,
+    policy_state: policyState,
+    result_label: resultLabel2,
+    proof_complete: proofComplete,
+    proof_passed: proofPassed,
+    ship_held: shipHeld,
+    shipping_disabled: shippingDisabled,
+    ship_authorized: shipAuthorized,
+    merge_ready: mergeReady,
+    sync_allowed: syncAllowed,
+    checkpoint_summary: checkpointSummary,
+    required_disclosures: uniqueStrings(requiredDisclosures),
+    prohibited_claims: uniqueStrings(prohibitedClaims)
+  };
+}
+
+// src/pr-comment.ts
+var RIDDLE_PROOF_PR_COMMENT_MARKER = "<!-- riddle-proof:pr-comment:v1 -->";
+function asRecord2(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function asArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+function stringValue4(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function numberValue3(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function booleanValue3(value) {
+  return typeof value === "boolean" ? value : void 0;
+}
+function firstStringValue2(...values) {
+  for (const value of values) {
+    const text = stringValue4(value);
+    if (text) return text;
+  }
+  return void 0;
+}
 function artifactKind(name, url) {
   const target = `${name} ${url}`.toLowerCase();
   if (/\.(png|jpe?g|gif|webp|avif|svg)(\?|#|$)/.test(target)) return "image";
@@ -17759,18 +17904,18 @@ function artifactKind(name, url) {
   return "artifact";
 }
 function artifactDisplayName(value, fallback) {
-  const raw = stringValue3(value);
+  const raw = stringValue4(value);
   if (raw) return raw;
   return fallback;
 }
 function collectArtifacts(runResponse) {
-  const proofResult = asRecord(runResponse.proofResult);
+  const proofResult = asRecord2(runResponse.proofResult);
   const outputs = asArray(proofResult.outputs);
   const artifacts = [];
   const seen = /* @__PURE__ */ new Set();
   for (const [index, item] of outputs.entries()) {
-    const artifact = asRecord(item);
-    const url = stringValue3(artifact.url);
+    const artifact = asRecord2(item);
+    const url = stringValue4(artifact.url);
     if (!url || seen.has(url)) continue;
     seen.add(url);
     const name = artifactDisplayName(artifact.name, `artifact-${index + 1}`);
@@ -17778,7 +17923,7 @@ function collectArtifacts(runResponse) {
       name,
       url,
       kind: artifactKind(name, url),
-      size_bytes: numberValue2(artifact.size)
+      size_bytes: numberValue3(artifact.size)
     });
   }
   return artifacts;
@@ -17786,9 +17931,9 @@ function collectArtifacts(runResponse) {
 function pageSummaries(result) {
   const pages = [];
   for (const page of asArray(result.pages)) {
-    const record = asRecord(page);
-    const route = stringValue3(record.route) || stringValue3(record.url) || "page";
-    const checks = asRecord(record.checks);
+    const record = asRecord2(page);
+    const route = stringValue4(record.route) || stringValue4(record.url) || "page";
+    const checks = asRecord2(record.checks);
     let passed = 0;
     let failed = 0;
     for (const value of Object.values(checks)) {
@@ -17828,68 +17973,76 @@ function selectPrimaryImage(artifacts) {
   const images = artifacts.filter((artifact) => artifact.kind === "image");
   return images.find((artifact) => /after|proof|screenshot/i.test(artifact.name)) || images[0];
 }
-function firstRecordValue(...values) {
+function firstRecordValue2(...values) {
   for (const value of values) {
-    const record = asRecord(value);
+    const record = asRecord2(value);
     if (Object.keys(record).length) return record;
   }
   return void 0;
 }
-function checkpointSummaryFrom(...values) {
-  const record = firstRecordValue(...values);
+function checkpointSummaryFrom2(...values) {
+  const record = firstRecordValue2(...values);
   if (!record) return void 0;
   const summary = {
-    pending: booleanValue2(record.pending),
-    response_count: numberValue2(record.response_count),
-    rejected_response_count: numberValue2(record.rejected_response_count),
-    ignored_response_count: numberValue2(record.ignored_response_count),
-    duplicate_response_count: numberValue2(record.duplicate_response_count),
-    latest_decision: stringValue3(record.latest_decision),
-    latest_packet_id: stringValue3(record.latest_packet_id),
-    latest_resume_token: stringValue3(record.latest_resume_token)
+    pending: booleanValue3(record.pending),
+    response_count: numberValue3(record.response_count),
+    rejected_response_count: numberValue3(record.rejected_response_count),
+    ignored_response_count: numberValue3(record.ignored_response_count),
+    duplicate_response_count: numberValue3(record.duplicate_response_count),
+    latest_decision: stringValue4(record.latest_decision),
+    latest_packet_id: stringValue4(record.latest_packet_id),
+    latest_resume_token: stringValue4(record.latest_resume_token)
   };
   return Object.values(summary).some((value) => typeof value !== "undefined") ? summary : void 0;
 }
 function summarizeRiddleProofPrComment(input) {
-  const runResponse = asRecord(input.runResponse);
-  const result = asRecord(input.result);
-  const proofResult = asRecord(runResponse.proofResult);
-  const preview = asRecord(runResponse.preview);
-  const resultRunCard = asRecord(result.run_card);
-  const stopCondition = asRecord(resultRunCard.stop_condition);
-  const resultDetails = asRecord(result.details);
-  const resultRaw = asRecord(result.raw);
-  const rawDetails = asRecord(resultRaw.details);
+  const runResponse = asRecord2(input.runResponse);
+  const result = asRecord2(input.result);
+  const proofResult = asRecord2(runResponse.proofResult);
+  const preview = asRecord2(runResponse.preview);
+  const resultRunCard = asRecord2(result.run_card);
+  const stopCondition = asRecord2(resultRunCard.stop_condition);
+  const resultDetails = asRecord2(result.details);
+  const resultRaw = asRecord2(result.raw);
+  const rawDetails = asRecord2(resultRaw.details);
   const artifacts = collectArtifacts(runResponse);
   const pages = pageSummaries(result);
   const checkSource = { ...result };
   delete checkSource.ok;
   const nestedChecks = summarizeExplicitChecks(checkSource);
-  const ok = booleanValue2(result.ok) ?? booleanValue2(runResponse.ok) ?? null;
-  const checkpointSummary = checkpointSummaryFrom(
+  const ok = booleanValue3(result.ok) ?? booleanValue3(runResponse.ok) ?? null;
+  const checkpointSummary = checkpointSummaryFrom2(
     result.checkpoint_summary,
     stopCondition.checkpoint_summary,
     resultDetails.checkpoint_summary,
     rawDetails.checkpoint_summary,
     proofResult.checkpoint_summary
   );
+  const publicState = summarizeRiddleProofPublicState({
+    ...result,
+    status: firstStringValue2(result.status, stopCondition.status),
+    checkpoint_summary: checkpointSummary || result.checkpoint_summary
+  });
   return {
     ok,
-    status: stringValue3(proofResult.status),
-    result_status: firstStringValue(result.status, stopCondition.status),
-    job_id: stringValue3(proofResult.job_id),
-    duration_ms: numberValue2(proofResult.duration_ms),
-    proof_url: stringValue3(runResponse.proofUrl),
-    preview_id: stringValue3(preview.id),
-    preview_url: stringValue3(preview.preview_url) || stringValue3(preview.url),
-    preview_publish_recovered: booleanValue2(preview.publish_recovered),
-    preview_publish_error: stringValue3(preview.publish_error),
-    ship_held: firstBooleanValue(result.ship_held, stopCondition.ship_held, resultRaw.ship_held),
-    shipping_disabled: firstBooleanValue(result.shipping_disabled, stopCondition.shipping_disabled, resultRaw.shipping_disabled),
-    ship_authorized: firstBooleanValue(result.ship_authorized, stopCondition.ship_authorized, resultRaw.ship_authorized),
-    proof_decision: firstStringValue(result.proof_decision, stopCondition.proof_decision, resultRaw.proof_decision),
-    merge_recommendation: firstStringValue(result.merge_recommendation, stopCondition.merge_recommendation, resultRaw.merge_recommendation),
+    status: stringValue4(proofResult.status),
+    result_status: publicState.status,
+    job_id: stringValue4(proofResult.job_id),
+    duration_ms: numberValue3(proofResult.duration_ms),
+    proof_url: stringValue4(runResponse.proofUrl),
+    preview_id: stringValue4(preview.id),
+    preview_url: stringValue4(preview.preview_url) || stringValue4(preview.url),
+    preview_publish_recovered: booleanValue3(preview.publish_recovered),
+    preview_publish_error: stringValue4(preview.publish_error),
+    ship_held: publicState.ship_held,
+    shipping_disabled: publicState.shipping_disabled,
+    ship_authorized: publicState.ship_authorized,
+    merge_ready: publicState.merge_ready,
+    sync_allowed: publicState.sync_allowed,
+    proof_decision: firstStringValue2(result.proof_decision, stopCondition.proof_decision, resultRaw.proof_decision),
+    merge_recommendation: firstStringValue2(result.merge_recommendation, stopCondition.merge_recommendation, resultRaw.merge_recommendation),
     checkpoint_summary: checkpointSummary,
+    public_state: publicState,
     passed_checks: nestedChecks.passed,
     failed_checks: nestedChecks.failed,
     pages,
@@ -17908,6 +18061,7 @@ function markdownLink(label, url) {
   return `[${label.replace(/\]/g, "\\]")}](${url})`;
 }
 function resultLabel(summary) {
+  if (summary.public_state?.result_label) return summary.public_state.result_label;
   if (summary.ok === true) {
     if (summary.result_status === "shipped") return "shipped";
     if (summary.result_status === "completed") return "completed";
@@ -17934,6 +18088,14 @@ function formatBool(value) {
 function hasShipControl(summary) {
   return typeof summary.ship_held === "boolean" || typeof summary.shipping_disabled === "boolean" || typeof summary.ship_authorized === "boolean";
 }
+function hasHandoffControl(summary) {
+  return typeof summary.merge_ready === "boolean" || typeof summary.sync_allowed === "boolean";
+}
+function shouldRenderMergeRecommendation(summary) {
+  if (!summary.merge_recommendation) return false;
+  const prohibited = summary.public_state?.prohibited_claims || [];
+  return !prohibited.includes("merge_ready") && !prohibited.includes("sync_allowed");
+}
 function checkpointSummaryLine(summary) {
   const accepted = summary.response_count ?? 0;
   const rejected = summary.rejected_response_count ?? 0;
@@ -17965,8 +18127,11 @@ function buildRiddleProofPrCommentMarkdown(input) {
   if (hasShipControl(summary)) {
     lines.push(`**Ship control:** held=${formatBool(summary.ship_held)}, shipping_disabled=${formatBool(summary.shipping_disabled)}, authorized=${formatBool(summary.ship_authorized)}`);
   }
+  if (hasHandoffControl(summary)) {
+    lines.push(`**Handoff:** merge_ready=${formatBool(summary.merge_ready)}, sync_allowed=${formatBool(summary.sync_allowed)}`);
+  }
   if (summary.proof_decision) lines.push(`**Proof decision:** \`${summary.proof_decision}\``);
-  if (summary.merge_recommendation) lines.push(`**Merge recommendation:** ${summary.merge_recommendation}`);
+  if (shouldRenderMergeRecommendation(summary)) lines.push(`**Merge recommendation:** ${summary.merge_recommendation}`);
   if (summary.checkpoint_summary) lines.push(`**Checkpoints:** ${checkpointSummaryLine(summary.checkpoint_summary)}`);
   if (summary.proof_url) lines.push(`**Proof URL:** ${markdownLink(summary.proof_url, summary.proof_url)}`);
   if (summary.preview_id || summary.preview_url) {

package/dist/cli.js

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
-import "./chunk-LUFT7AGY.js";
+import "./chunk-XSNMMAPJ.js";
 import "./chunk-DI2XNGEZ.js";
-import "./chunk-JR7GFTLS.js";
+import "./chunk-2PKBTYOA.js";
 import "./chunk-EX7TO4I5.js";
+import "./chunk-KG64Y5MC.js";
 import "./chunk-GHBNDHG7.js";
 import "./chunk-UZIX7M7D.js";
 import "./chunk-KNPCWWF3.js";