@riddledc/riddle-proof 0.8.60 → 0.8.62

package/dist/cli.cjs

@@ -5454,6 +5454,13 @@ function proofAssessmentHardBlockers(state, payload) {
   }
   return blockers;
 }
+function proofGateStateForCheckpointResponse(state) {
+  const fullState = readJson(state.request.engine_state_path) || {};
+  return compactRecord({
+    ...fullState,
+    verification_mode: nonEmptyString(fullState.verification_mode) || state.request.verification_mode
+  });
+}
 function proofAssessmentContinuation(result, payload) {
   const proof_assessment_json = jsonParam(payload);
   return { ...baseContinuation(result), proof_assessment_json };
@@ -6000,6 +6007,45 @@ function checkpointResponseContinuation(state, value) {
           blocker: sourceBlocker
         });
       }
+      const proofGateState = proofGateStateForCheckpointResponse(state);
+      const hardBlockers = proofAssessmentHardBlockers(proofGateState, assessment);
+      if (proofAssessmentRequestsShip(assessment) && hardBlockers.length) {
+        return checkpointResponseRejectedBlocker(state, {
+          packet,
+          response,
+          blocker: {
+            code: "checkpoint_response_proof_hard_blocker",
+            checkpoint: packet.checkpoint,
+            message: "Riddle Proof cannot mark ready_to_ship while the proof bundle contains a hard blocker: " + hardBlockers[0],
+            details: compactRecord({
+              stage: packet.stage,
+              hard_blockers: hardBlockers,
+              proofAssessment: assessment,
+              response
+            })
+          }
+        });
+      }
+      const visualBlocker = proofAssessmentVisualBlocker(proofGateState, assessment);
+      if (visualBlocker) {
+        const recoveryAssessment = visualDeltaEvidenceRecoveryAssessment(proofGateState, assessment, visualBlocker);
+        appendCheckpointResponse(state, response, { summary: visualBlocker });
+        recordEvent(state, {
+          kind: "checkpoint.response.evidence_recovery_required",
+          checkpoint: packet.checkpoint,
+          stage: "verify",
+          summary: visualBlocker,
+          details: compactRecord({
+            evidence_collection_incomplete: true,
+            recovery_stage: "verify",
+            evidence_issue_code: recoveryAssessment.evidence_issue_code || null,
+            visual_delta: recoveryAssessment.visual_delta || null,
+            proof_assessment: recoveryAssessment,
+            checkpoint_response_source: response.source || null
+          })
+        });
+        return { next: { ...base, proof_assessment_json: jsonParam(recoveryAssessment) } };
+      }
       appendCheckpointResponse(state, response);
       if (state.request.ship_mode !== "ship" && proofAssessmentRequestsShip(assessment)) {
         const result = {
@@ -18081,6 +18127,10 @@ function summarizeRiddleProofPrComment(input) {
     status: firstStringValue2(result.status, stopCondition.status),
     checkpoint_summary: checkpointSummary || result.checkpoint_summary
   });
+  const mergeRecommendation = riddleProofPublicStateMergeRecommendation(
+    publicState,
+    firstStringValue2(result.merge_recommendation, stopCondition.merge_recommendation, resultRaw.merge_recommendation)
+  );
   return {
     ok,
     status: stringValue4(proofResult.status),
@@ -18098,7 +18148,7 @@ function summarizeRiddleProofPrComment(input) {
     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),
+    merge_recommendation: mergeRecommendation,
     checkpoint_summary: checkpointSummary,
     public_state: publicState,
     passed_checks: nestedChecks.passed,

package/dist/cli.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
-import "./chunk-AWRBSVNW.js";
+import "./chunk-DDAV6D6K.js";
 import "./chunk-DI2XNGEZ.js";
-import "./chunk-HZOILEGF.js";
+import "./chunk-RZ3GXSXQ.js";
 import "./chunk-EX7TO4I5.js";
-import "./chunk-PCEDAQPG.js";
-import "./chunk-UEY5SJG5.js";
-import "./chunk-NXEAFQYZ.js";
+import "./chunk-P4BHU5NM.js";
+import "./chunk-NMQIWBSB.js";
+import "./chunk-2OTPBHSM.js";
 import "./chunk-EKZXU6MU.js";
-import "./chunk-FX2CB4MG.js";
+import "./chunk-ZB5XBHWD.js";
 import "./chunk-JFQXAJH2.js";
-import "./chunk-QPKY767W.js";
-import "./chunk-QGMSN34W.js";
-import "./chunk-WKIIJX3O.js";
+import "./chunk-OD6OKXL2.js";
+import "./chunk-UK7G4RKA.js";
+import "./chunk-6PSM6KB2.js";
 import "./chunk-MLKGABMK.js";

package/dist/codex-exec-agent.js

@@ -2,9 +2,9 @@ import {
   createCodexExecAgentAdapter,
   createCodexExecJsonRunner,
   runCodexExecAgentDoctor
-} from "./chunk-QPKY767W.js";
-import "./chunk-QGMSN34W.js";
-import "./chunk-WKIIJX3O.js";
+} from "./chunk-OD6OKXL2.js";
+import "./chunk-UK7G4RKA.js";
+import "./chunk-6PSM6KB2.js";
 import "./chunk-MLKGABMK.js";
 export {
   createCodexExecAgentAdapter,

package/dist/engine-harness.cjs

@@ -5366,6 +5366,13 @@ function proofAssessmentHardBlockers(state, payload) {
   }
   return blockers;
 }
+function proofGateStateForCheckpointResponse(state) {
+  const fullState = readJson(state.request.engine_state_path) || {};
+  return compactRecord({
+    ...fullState,
+    verification_mode: nonEmptyString(fullState.verification_mode) || state.request.verification_mode
+  });
+}
 function proofAssessmentContinuation(result, payload) {
   const proof_assessment_json = jsonParam(payload);
   return { ...baseContinuation(result), proof_assessment_json };
@@ -5912,6 +5919,45 @@ function checkpointResponseContinuation(state, value) {
           blocker: sourceBlocker
         });
       }
+      const proofGateState = proofGateStateForCheckpointResponse(state);
+      const hardBlockers = proofAssessmentHardBlockers(proofGateState, assessment);
+      if (proofAssessmentRequestsShip(assessment) && hardBlockers.length) {
+        return checkpointResponseRejectedBlocker(state, {
+          packet,
+          response,
+          blocker: {
+            code: "checkpoint_response_proof_hard_blocker",
+            checkpoint: packet.checkpoint,
+            message: "Riddle Proof cannot mark ready_to_ship while the proof bundle contains a hard blocker: " + hardBlockers[0],
+            details: compactRecord({
+              stage: packet.stage,
+              hard_blockers: hardBlockers,
+              proofAssessment: assessment,
+              response
+            })
+          }
+        });
+      }
+      const visualBlocker = proofAssessmentVisualBlocker(proofGateState, assessment);
+      if (visualBlocker) {
+        const recoveryAssessment = visualDeltaEvidenceRecoveryAssessment(proofGateState, assessment, visualBlocker);
+        appendCheckpointResponse(state, response, { summary: visualBlocker });
+        recordEvent(state, {
+          kind: "checkpoint.response.evidence_recovery_required",
+          checkpoint: packet.checkpoint,
+          stage: "verify",
+          summary: visualBlocker,
+          details: compactRecord({
+            evidence_collection_incomplete: true,
+            recovery_stage: "verify",
+            evidence_issue_code: recoveryAssessment.evidence_issue_code || null,
+            visual_delta: recoveryAssessment.visual_delta || null,
+            proof_assessment: recoveryAssessment,
+            checkpoint_response_source: response.source || null
+          })
+        });
+        return { next: { ...base, proof_assessment_json: jsonParam(recoveryAssessment) } };
+      }
       appendCheckpointResponse(state, response);
       if (state.request.ship_mode !== "ship" && proofAssessmentRequestsShip(assessment)) {
         const result = {

package/dist/engine-harness.js

@@ -2,13 +2,13 @@ import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
   runRiddleProofEngineHarness
-} from "./chunk-PCEDAQPG.js";
-import "./chunk-UEY5SJG5.js";
-import "./chunk-NXEAFQYZ.js";
+} from "./chunk-P4BHU5NM.js";
+import "./chunk-NMQIWBSB.js";
+import "./chunk-2OTPBHSM.js";
 import "./chunk-EKZXU6MU.js";
-import "./chunk-FX2CB4MG.js";
-import "./chunk-QGMSN34W.js";
-import "./chunk-WKIIJX3O.js";
+import "./chunk-ZB5XBHWD.js";
+import "./chunk-UK7G4RKA.js";
+import "./chunk-6PSM6KB2.js";
 import "./chunk-MLKGABMK.js";
 export {
   createDisabledRiddleProofAgentAdapter,

package/dist/index.cjs

@@ -3538,8 +3538,11 @@ __export(index_exports, {
   slugifyRiddleProofProfileName: () => slugifyRiddleProofProfileName,
   statePathsForRunState: () => statePathsForRunState,
   summarizeCaptureArtifacts: () => summarizeCaptureArtifacts,
+  summarizeRiddleProofAgentSummarySurface: () => summarizeRiddleProofAgentSummarySurface,
+  summarizeRiddleProofHostedProofViewSurface: () => summarizeRiddleProofHostedProofViewSurface,
   summarizeRiddleProofPrComment: () => summarizeRiddleProofPrComment,
   summarizeRiddleProofProfileResult: () => summarizeRiddleProofProfileResult,
+  summarizeRiddleProofPublicConsumerSurface: () => summarizeRiddleProofPublicConsumerSurface,
   summarizeRiddleProofPublicState: () => summarizeRiddleProofPublicState,
   visualSessionFingerprint: () => visualSessionFingerprint,
   visualSessionFingerprintBasis: () => visualSessionFingerprintBasis
@@ -3706,6 +3709,68 @@ function summarizeRiddleProofPublicState(input) {
     prohibited_claims: uniqueStrings(prohibitedClaims)
   };
 }
+function summarizeRiddleProofPublicConsumerSurface(input, options = {}) {
+  const record = asRecord(input);
+  const runCard = asRecord(record.run_card);
+  const stopCondition = asRecord(runCard.stop_condition);
+  const raw = asRecord(record.raw);
+  const publicState = summarizeRiddleProofPublicState(input);
+  const checkpointAudit = publicState.checkpoint_summary;
+  const mergeRecommendation = riddleProofPublicStateMergeRecommendation(
+    publicState,
+    firstStringValue(
+      options.merge_recommendation,
+      record.merge_recommendation,
+      stopCondition.merge_recommendation,
+      raw.merge_recommendation
+    )
+  );
+  const checkpointAuditRequired = publicState.required_disclosures.includes("checkpoint_audit_counters");
+  return {
+    kind: options.kind || "run_result",
+    status: publicState.status,
+    result_label: publicState.result_label,
+    policy_state: publicState.policy_state,
+    proof_complete: publicState.proof_complete,
+    claims: {
+      proof_passed: publicState.proof_passed,
+      ship_authorized: publicState.ship_authorized,
+      merge_ready: publicState.merge_ready,
+      sync_allowed: publicState.sync_allowed,
+      all_checkpoint_responses_accepted: checkpointAudit ? !checkpointAudit.audit_disclosure_required : false
+    },
+    ship_control: {
+      ship_held: publicState.ship_held,
+      shipping_disabled: publicState.shipping_disabled,
+      ship_authorized: publicState.ship_authorized
+    },
+    handoff: {
+      merge_ready: publicState.merge_ready,
+      sync_allowed: publicState.sync_allowed,
+      merge_recommendation: mergeRecommendation
+    },
+    checkpoint_audit: checkpointAudit,
+    disclosures: {
+      ship_control: true,
+      checkpoint_audit: !checkpointAuditRequired || Boolean(checkpointAudit),
+      required: [...publicState.required_disclosures],
+      prohibited_claims: [...publicState.prohibited_claims]
+    },
+    public_state: publicState
+  };
+}
+function summarizeRiddleProofHostedProofViewSurface(input, options = {}) {
+  return summarizeRiddleProofPublicConsumerSurface(input, {
+    ...options,
+    kind: "hosted_proof_view"
+  });
+}
+function summarizeRiddleProofAgentSummarySurface(input, options = {}) {
+  return summarizeRiddleProofPublicConsumerSurface(input, {
+    ...options,
+    kind: "agent_summary"
+  });
+}
 
 // src/result.ts
 function isTerminalStatus(status) {
@@ -6131,6 +6196,13 @@ function proofAssessmentHardBlockers(state, payload) {
   }
   return blockers;
 }
+function proofGateStateForCheckpointResponse(state) {
+  const fullState = readJson(state.request.engine_state_path) || {};
+  return compactRecord({
+    ...fullState,
+    verification_mode: nonEmptyString(fullState.verification_mode) || state.request.verification_mode
+  });
+}
 function proofAssessmentContinuation(result, payload) {
   const proof_assessment_json = jsonParam(payload);
   return { ...baseContinuation(result), proof_assessment_json };
@@ -6677,6 +6749,45 @@ function checkpointResponseContinuation(state, value) {
           blocker: sourceBlocker
         });
       }
+      const proofGateState = proofGateStateForCheckpointResponse(state);
+      const hardBlockers = proofAssessmentHardBlockers(proofGateState, assessment);
+      if (proofAssessmentRequestsShip(assessment) && hardBlockers.length) {
+        return checkpointResponseRejectedBlocker(state, {
+          packet,
+          response,
+          blocker: {
+            code: "checkpoint_response_proof_hard_blocker",
+            checkpoint: packet.checkpoint,
+            message: "Riddle Proof cannot mark ready_to_ship while the proof bundle contains a hard blocker: " + hardBlockers[0],
+            details: compactRecord({
+              stage: packet.stage,
+              hard_blockers: hardBlockers,
+              proofAssessment: assessment,
+              response
+            })
+          }
+        });
+      }
+      const visualBlocker = proofAssessmentVisualBlocker(proofGateState, assessment);
+      if (visualBlocker) {
+        const recoveryAssessment = visualDeltaEvidenceRecoveryAssessment(proofGateState, assessment, visualBlocker);
+        appendCheckpointResponse(state, response, { summary: visualBlocker });
+        recordEvent(state, {
+          kind: "checkpoint.response.evidence_recovery_required",
+          checkpoint: packet.checkpoint,
+          stage: "verify",
+          summary: visualBlocker,
+          details: compactRecord({
+            evidence_collection_incomplete: true,
+            recovery_stage: "verify",
+            evidence_issue_code: recoveryAssessment.evidence_issue_code || null,
+            visual_delta: recoveryAssessment.visual_delta || null,
+            proof_assessment: recoveryAssessment,
+            checkpoint_response_source: response.source || null
+          })
+        });
+        return { next: { ...base, proof_assessment_json: jsonParam(recoveryAssessment) } };
+      }
       appendCheckpointResponse(state, response);
       if (state.request.ship_mode !== "ship" && proofAssessmentRequestsShip(assessment)) {
         const result = {
@@ -20286,6 +20397,10 @@ function summarizeRiddleProofPrComment(input) {
     status: firstStringValue2(result.status, stopCondition.status),
     checkpoint_summary: checkpointSummary || result.checkpoint_summary
   });
+  const mergeRecommendation = riddleProofPublicStateMergeRecommendation(
+    publicState,
+    firstStringValue2(result.merge_recommendation, stopCondition.merge_recommendation, resultRaw.merge_recommendation)
+  );
   return {
     ok,
     status: stringValue7(proofResult.status),
@@ -20303,7 +20418,7 @@ function summarizeRiddleProofPrComment(input) {
     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),
+    merge_recommendation: mergeRecommendation,
     checkpoint_summary: checkpointSummary,
     public_state: publicState,
     passed_checks: nestedChecks.passed,
@@ -20571,8 +20686,11 @@ function buildRiddleProofPrCommentMarkdown(input) {
   slugifyRiddleProofProfileName,
   statePathsForRunState,
   summarizeCaptureArtifacts,
+  summarizeRiddleProofAgentSummarySurface,
+  summarizeRiddleProofHostedProofViewSurface,
   summarizeRiddleProofPrComment,
   summarizeRiddleProofProfileResult,
+  summarizeRiddleProofPublicConsumerSurface,
   summarizeRiddleProofPublicState,
   visualSessionFingerprint,
   visualSessionFingerprintBasis

package/dist/index.d.cts

@@ -3,7 +3,7 @@ export { RiddleProofShipControlState, TerminalMetadataInput, applyShipControlSta
 export { CreateRunStateInput, RIDDLE_PROOF_RUN_STATE_VERSION, RunEventInput, appendRunEvent, appendStageHeartbeat, applyPrLifecycleState, createRunState, createRunStatusSnapshot, normalizeIntegrationContext, normalizePrLifecycleState, normalizeRunParams, setRunStatus } from './state.cjs';
 export { RIDDLE_PROOF_CHECKPOINT_PACKET_VERSION, RIDDLE_PROOF_CHECKPOINT_RESPONSE_VERSION, authorPacketPayloadFromCheckpointResponse, buildAuthorCheckpointPacket, buildCheckpointPacketForEngineResult, buildProofAssessmentCheckpointPacket, buildStageCheckpointPacket, checkpointPacketIdentity, checkpointResponseIdentity, checkpointSummaryFromState, createCheckpointResponseTemplate, isDuplicateCheckpointResponse, normalizeCheckpointResponse, proofContractFromAuthorCheckpointResponse, statePathsForRunState } from './checkpoint.cjs';
 export { RIDDLE_PROOF_RUN_CARD_VERSION, createRiddleProofRunCard } from './run-card.cjs';
-export { RiddleProofPublicCheckpointSummary, RiddleProofPublicPolicyState, RiddleProofPublicStateSummary, riddleProofPublicStateAllowsClaim, riddleProofPublicStateAllowsMergeRecommendation, riddleProofPublicStateMergeRecommendation, summarizeRiddleProofPublicState } from './public-state.cjs';
+export { RiddleProofPublicCheckpointSummary, RiddleProofPublicConsumerSurface, RiddleProofPublicConsumerSurfaceKind, RiddleProofPublicConsumerSurfaceOptions, RiddleProofPublicPolicyState, RiddleProofPublicStateSummary, riddleProofPublicStateAllowsClaim, riddleProofPublicStateAllowsMergeRecommendation, riddleProofPublicStateMergeRecommendation, summarizeRiddleProofAgentSummarySurface, summarizeRiddleProofHostedProofViewSurface, summarizeRiddleProofPublicConsumerSurface, summarizeRiddleProofPublicState } from './public-state.cjs';
 export { R as RiddleProofRunnerAdapters, a as RunRiddleProofInput, r as runRiddleProof } from './runner-4LJ5z0D-.cjs';
 export { R as RiddleProofAgentAdapter, a as RiddleProofAgentPayload, b as RiddleProofCheckpointMode, c as RiddleProofEngine, d as RiddleProofEngineHarnessConfig, e as RiddleProofEngineHarnessContext, f as RiddleProofEngineResult, g as RiddleProofShipMode, h as RiddleProofWorkflowParams, i as RunRiddleProofEngineHarnessInput, j as createDisabledRiddleProofAgentAdapter, r as readRiddleProofRunStatus, k as runRiddleProofEngineHarness } from './engine-harness-LBfqbFSe.cjs';
 export { CodexExecAgentConfig, CodexJsonRequest, CodexJsonResult, CodexJsonRunner, CodexExecAgentConfig as LocalAgentConfig, CodexJsonRequest as LocalAgentJsonRequest, CodexJsonResult as LocalAgentJsonResult, CodexJsonRunner as LocalAgentJsonRunner, createCodexExecAgentAdapter, createCodexExecJsonRunner, createCodexExecAgentAdapter as createLocalAgentAdapter, createCodexExecJsonRunner as createLocalAgentJsonRunner, runCodexExecAgentDoctor, runCodexExecAgentDoctor as runLocalAgentDoctor } from './codex-exec-agent.cjs';

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { RiddleProofShipControlState, TerminalMetadataInput, applyShipControlSta
 export { CreateRunStateInput, RIDDLE_PROOF_RUN_STATE_VERSION, RunEventInput, appendRunEvent, appendStageHeartbeat, applyPrLifecycleState, createRunState, createRunStatusSnapshot, normalizeIntegrationContext, normalizePrLifecycleState, normalizeRunParams, setRunStatus } from './state.js';
 export { RIDDLE_PROOF_CHECKPOINT_PACKET_VERSION, RIDDLE_PROOF_CHECKPOINT_RESPONSE_VERSION, authorPacketPayloadFromCheckpointResponse, buildAuthorCheckpointPacket, buildCheckpointPacketForEngineResult, buildProofAssessmentCheckpointPacket, buildStageCheckpointPacket, checkpointPacketIdentity, checkpointResponseIdentity, checkpointSummaryFromState, createCheckpointResponseTemplate, isDuplicateCheckpointResponse, normalizeCheckpointResponse, proofContractFromAuthorCheckpointResponse, statePathsForRunState } from './checkpoint.js';
 export { RIDDLE_PROOF_RUN_CARD_VERSION, createRiddleProofRunCard } from './run-card.js';
-export { RiddleProofPublicCheckpointSummary, RiddleProofPublicPolicyState, RiddleProofPublicStateSummary, riddleProofPublicStateAllowsClaim, riddleProofPublicStateAllowsMergeRecommendation, riddleProofPublicStateMergeRecommendation, summarizeRiddleProofPublicState } from './public-state.js';
+export { RiddleProofPublicCheckpointSummary, RiddleProofPublicConsumerSurface, RiddleProofPublicConsumerSurfaceKind, RiddleProofPublicConsumerSurfaceOptions, RiddleProofPublicPolicyState, RiddleProofPublicStateSummary, riddleProofPublicStateAllowsClaim, riddleProofPublicStateAllowsMergeRecommendation, riddleProofPublicStateMergeRecommendation, summarizeRiddleProofAgentSummarySurface, summarizeRiddleProofHostedProofViewSurface, summarizeRiddleProofPublicConsumerSurface, summarizeRiddleProofPublicState } from './public-state.js';
 export { R as RiddleProofRunnerAdapters, a as RunRiddleProofInput, r as runRiddleProof } from './runner-BdQpOkZD.js';
 export { R as RiddleProofAgentAdapter, a as RiddleProofAgentPayload, b as RiddleProofCheckpointMode, c as RiddleProofEngine, d as RiddleProofEngineHarnessConfig, e as RiddleProofEngineHarnessContext, f as RiddleProofEngineResult, g as RiddleProofShipMode, h as RiddleProofWorkflowParams, i as RunRiddleProofEngineHarnessInput, j as createDisabledRiddleProofAgentAdapter, r as readRiddleProofRunStatus, k as runRiddleProofEngineHarness } from './engine-harness-CMACHP6A.js';
 export { CodexExecAgentConfig, CodexJsonRequest, CodexJsonResult, CodexJsonRunner, CodexExecAgentConfig as LocalAgentConfig, CodexJsonRequest as LocalAgentJsonRequest, CodexJsonResult as LocalAgentJsonResult, CodexJsonRunner as LocalAgentJsonRunner, createCodexExecAgentAdapter, createCodexExecJsonRunner, createCodexExecAgentAdapter as createLocalAgentAdapter, createCodexExecJsonRunner as createLocalAgentJsonRunner, runCodexExecAgentDoctor, runCodexExecAgentDoctor as runLocalAgentDoctor } from './codex-exec-agent.js';

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   runRiddleProof
-} from "./chunk-XKNJ5OE4.js";
+} from "./chunk-HRY2IHXM.js";
 import "./chunk-6F4PWJZI.js";
 import {
   RIDDLE_PROOF_PLAYABILITY_ASSESSMENT_VERSION,
@@ -59,7 +59,7 @@ import {
   RIDDLE_PROOF_PR_COMMENT_MARKER,
   buildRiddleProofPrCommentMarkdown,
   summarizeRiddleProofPrComment
-} from "./chunk-HZOILEGF.js";
+} from "./chunk-RZ3GXSXQ.js";
 import {
   RIDDLE_PROOF_PROFILE_CHECK_TYPES,
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,
@@ -102,7 +102,7 @@ import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
   runRiddleProofEngineHarness
-} from "./chunk-PCEDAQPG.js";
+} from "./chunk-P4BHU5NM.js";
 import {
   RIDDLE_PROOF_RUN_STATE_VERSION,
   appendRunEvent,
@@ -114,11 +114,11 @@ import {
   normalizePrLifecycleState,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-UEY5SJG5.js";
+} from "./chunk-NMQIWBSB.js";
 import {
   RIDDLE_PROOF_RUN_CARD_VERSION,
   createRiddleProofRunCard
-} from "./chunk-NXEAFQYZ.js";
+} from "./chunk-2OTPBHSM.js";
 import "./chunk-EKZXU6MU.js";
 import {
   RIDDLE_PROOF_CHECKPOINT_PACKET_VERSION,
@@ -136,13 +136,13 @@ import {
   normalizeCheckpointResponse,
   proofContractFromAuthorCheckpointResponse,
   statePathsForRunState
-} from "./chunk-FX2CB4MG.js";
+} from "./chunk-ZB5XBHWD.js";
 import "./chunk-JFQXAJH2.js";
 import {
   createCodexExecAgentAdapter,
   createCodexExecJsonRunner,
   runCodexExecAgentDoctor
-} from "./chunk-QPKY767W.js";
+} from "./chunk-OD6OKXL2.js";
 import {
   applyShipControlState,
   applyTerminalMetadata,
@@ -157,13 +157,16 @@ import {
   publicStateForRunState,
   recordValue,
   shipControlStateFor
-} from "./chunk-QGMSN34W.js";
+} from "./chunk-UK7G4RKA.js";
 import {
   riddleProofPublicStateAllowsClaim,
   riddleProofPublicStateAllowsMergeRecommendation,
   riddleProofPublicStateMergeRecommendation,
+  summarizeRiddleProofAgentSummarySurface,
+  summarizeRiddleProofHostedProofViewSurface,
+  summarizeRiddleProofPublicConsumerSurface,
   summarizeRiddleProofPublicState
-} from "./chunk-WKIIJX3O.js";
+} from "./chunk-6PSM6KB2.js";
 import "./chunk-MLKGABMK.js";
 export {
   BASIC_GAMEPLAY_ACTION_TYPES,
@@ -297,8 +300,11 @@ export {
   slugifyRiddleProofProfileName,
   statePathsForRunState,
   summarizeCaptureArtifacts,
+  summarizeRiddleProofAgentSummarySurface,
+  summarizeRiddleProofHostedProofViewSurface,
   summarizeRiddleProofPrComment,
   summarizeRiddleProofProfileResult,
+  summarizeRiddleProofPublicConsumerSurface,
   summarizeRiddleProofPublicState,
   visualSessionFingerprint,
   visualSessionFingerprintBasis

package/dist/local-agent.js

@@ -3,9 +3,9 @@ import {
   createCodexExecAgentAdapter,
   createCodexExecJsonRunner,
   runCodexExecAgentDoctor
-} from "./chunk-QPKY767W.js";
-import "./chunk-QGMSN34W.js";
-import "./chunk-WKIIJX3O.js";
+} from "./chunk-OD6OKXL2.js";
+import "./chunk-UK7G4RKA.js";
+import "./chunk-6PSM6KB2.js";
 import "./chunk-MLKGABMK.js";
 export {
   createCodexExecAgentAdapter as createLocalAgentAdapter,

package/dist/openclaw.js

@@ -3,12 +3,12 @@ import {
   parseOpenClawAssertions,
   parseOpenClawJsonObjectOrArray,
   toRiddleProofRunParams
-} from "./chunk-3FK5HZHK.js";
-import "./chunk-UEY5SJG5.js";
-import "./chunk-NXEAFQYZ.js";
-import "./chunk-FX2CB4MG.js";
-import "./chunk-QGMSN34W.js";
-import "./chunk-WKIIJX3O.js";
+} from "./chunk-WKNWMRDF.js";
+import "./chunk-NMQIWBSB.js";
+import "./chunk-2OTPBHSM.js";
+import "./chunk-ZB5XBHWD.js";
+import "./chunk-UK7G4RKA.js";
+import "./chunk-6PSM6KB2.js";
 import "./chunk-MLKGABMK.js";
 export {
   openClawIntegrationContext,

package/dist/pr-comment.cjs

@@ -33,6 +33,9 @@ function riddleProofPublicStateAllowsClaim(summary, claim) {
 function riddleProofPublicStateAllowsMergeRecommendation(summary) {
   return riddleProofPublicStateAllowsClaim(summary, "merge_ready") && riddleProofPublicStateAllowsClaim(summary, "sync_allowed");
 }
+function riddleProofPublicStateMergeRecommendation(summary, recommendation) {
+  return recommendation && riddleProofPublicStateAllowsMergeRecommendation(summary) ? recommendation : void 0;
+}
 function asRecord(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
@@ -334,6 +337,10 @@ function summarizeRiddleProofPrComment(input) {
     status: firstStringValue2(result.status, stopCondition.status),
     checkpoint_summary: checkpointSummary || result.checkpoint_summary
   });
+  const mergeRecommendation = riddleProofPublicStateMergeRecommendation(
+    publicState,
+    firstStringValue2(result.merge_recommendation, stopCondition.merge_recommendation, resultRaw.merge_recommendation)
+  );
   return {
     ok,
     status: stringValue2(proofResult.status),
@@ -351,7 +358,7 @@ function summarizeRiddleProofPrComment(input) {
     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),
+    merge_recommendation: mergeRecommendation,
     checkpoint_summary: checkpointSummary,
     public_state: publicState,
     passed_checks: nestedChecks.passed,

package/dist/pr-comment.js

@@ -2,8 +2,8 @@ import {
   RIDDLE_PROOF_PR_COMMENT_MARKER,
   buildRiddleProofPrCommentMarkdown,
   summarizeRiddleProofPrComment
-} from "./chunk-HZOILEGF.js";
-import "./chunk-WKIIJX3O.js";
+} from "./chunk-RZ3GXSXQ.js";
+import "./chunk-6PSM6KB2.js";
 import "./chunk-MLKGABMK.js";
 export {
   RIDDLE_PROOF_PR_COMMENT_MARKER,

package/dist/public-state.cjs

@@ -23,6 +23,9 @@ __export(public_state_exports, {
   riddleProofPublicStateAllowsClaim: () => riddleProofPublicStateAllowsClaim,
   riddleProofPublicStateAllowsMergeRecommendation: () => riddleProofPublicStateAllowsMergeRecommendation,
   riddleProofPublicStateMergeRecommendation: () => riddleProofPublicStateMergeRecommendation,
+  summarizeRiddleProofAgentSummarySurface: () => summarizeRiddleProofAgentSummarySurface,
+  summarizeRiddleProofHostedProofViewSurface: () => summarizeRiddleProofHostedProofViewSurface,
+  summarizeRiddleProofPublicConsumerSurface: () => summarizeRiddleProofPublicConsumerSurface,
   summarizeRiddleProofPublicState: () => summarizeRiddleProofPublicState
 });
 module.exports = __toCommonJS(public_state_exports);
@@ -185,10 +188,75 @@ function summarizeRiddleProofPublicState(input) {
     prohibited_claims: uniqueStrings(prohibitedClaims)
   };
 }
+function summarizeRiddleProofPublicConsumerSurface(input, options = {}) {
+  const record = asRecord(input);
+  const runCard = asRecord(record.run_card);
+  const stopCondition = asRecord(runCard.stop_condition);
+  const raw = asRecord(record.raw);
+  const publicState = summarizeRiddleProofPublicState(input);
+  const checkpointAudit = publicState.checkpoint_summary;
+  const mergeRecommendation = riddleProofPublicStateMergeRecommendation(
+    publicState,
+    firstStringValue(
+      options.merge_recommendation,
+      record.merge_recommendation,
+      stopCondition.merge_recommendation,
+      raw.merge_recommendation
+    )
+  );
+  const checkpointAuditRequired = publicState.required_disclosures.includes("checkpoint_audit_counters");
+  return {
+    kind: options.kind || "run_result",
+    status: publicState.status,
+    result_label: publicState.result_label,
+    policy_state: publicState.policy_state,
+    proof_complete: publicState.proof_complete,
+    claims: {
+      proof_passed: publicState.proof_passed,
+      ship_authorized: publicState.ship_authorized,
+      merge_ready: publicState.merge_ready,
+      sync_allowed: publicState.sync_allowed,
+      all_checkpoint_responses_accepted: checkpointAudit ? !checkpointAudit.audit_disclosure_required : false
+    },
+    ship_control: {
+      ship_held: publicState.ship_held,
+      shipping_disabled: publicState.shipping_disabled,
+      ship_authorized: publicState.ship_authorized
+    },
+    handoff: {
+      merge_ready: publicState.merge_ready,
+      sync_allowed: publicState.sync_allowed,
+      merge_recommendation: mergeRecommendation
+    },
+    checkpoint_audit: checkpointAudit,
+    disclosures: {
+      ship_control: true,
+      checkpoint_audit: !checkpointAuditRequired || Boolean(checkpointAudit),
+      required: [...publicState.required_disclosures],
+      prohibited_claims: [...publicState.prohibited_claims]
+    },
+    public_state: publicState
+  };
+}
+function summarizeRiddleProofHostedProofViewSurface(input, options = {}) {
+  return summarizeRiddleProofPublicConsumerSurface(input, {
+    ...options,
+    kind: "hosted_proof_view"
+  });
+}
+function summarizeRiddleProofAgentSummarySurface(input, options = {}) {
+  return summarizeRiddleProofPublicConsumerSurface(input, {
+    ...options,
+    kind: "agent_summary"
+  });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   riddleProofPublicStateAllowsClaim,
   riddleProofPublicStateAllowsMergeRecommendation,
   riddleProofPublicStateMergeRecommendation,
+  summarizeRiddleProofAgentSummarySurface,
+  summarizeRiddleProofHostedProofViewSurface,
+  summarizeRiddleProofPublicConsumerSurface,
   summarizeRiddleProofPublicState
 });