@riddledc/riddle-proof 0.4.1 → 0.4.3

package/README.md

@@ -71,15 +71,19 @@ events and return `createRunStatusSnapshot` for cheap observer status.
 
 The proof adapter is where a host wires Riddle server-backed capture. The ship
 adapter is where a host commits, pushes, opens or updates a PR, and waits for CI
-when configured. The notification adapter is where a host updates Discord,
-OpenClaw, GitHub, or another integration.
+when configured. `ship_mode: "ship"` is expected to drive the happy path all the
+way to a ready PR after proof and CI; `leave_draft: true` is only an explicit
+debug or user-request escape hatch. The notification adapter is where a host
+updates Discord, OpenClaw, GitHub, or another integration.
 
 ## OpenClaw Adapter Boundary
 
 `@riddledc/riddle-proof/openclaw` translates the current
 `proofed_change_run`-style tool params into generic `RiddleProofRunParams`.
 It preserves Discord routing metadata as `integration_context` and parses
-`assertions_json` into the shared assertions field.
+`assertions_json` into the shared assertions field. Compatibility params such as
+`ship_after_verify` and the explicit `leave_draft` escape hatch are preserved so
+the underlying runtime can distinguish "do not merge" from "keep this draft."
 
 The adapter does not invoke another OpenClaw plugin and does not supply a
 coding agent. It is the reusable mapping layer a future OpenClaw wrapper can

package/dist/{chunk-5FHUOSNO.js → chunk-AHQIV5QN.js}

@@ -2,7 +2,7 @@ import {
   compactRecord,
   nonEmptyString,
   recordValue
-} from "./chunk-5DC6YXN4.js";
+} from "./chunk-VFO5WY5X.js";
 
 // src/state.ts
 var RIDDLE_PROOF_RUN_STATE_VERSION = "riddle-proof.run-state.v1";
@@ -63,6 +63,7 @@ function normalizeRunParams(input) {
     color_scheme: input.color_scheme,
     wait_for_selector: input.wait_for_selector,
     ship_mode: input.ship_mode,
+    leave_draft: input.leave_draft,
     engine_state_path: input.engine_state_path,
     harness_state_path: input.harness_state_path,
     max_iterations: input.max_iterations,

package/dist/{chunk-F65YYXVO.js → chunk-RMY27ZEW.js}

@@ -3,10 +3,10 @@ import {
   appendStageHeartbeat,
   createRunState,
   setRunStatus
-} from "./chunk-5FHUOSNO.js";
+} from "./chunk-AHQIV5QN.js";
 import {
   createRunResult
-} from "./chunk-5DC6YXN4.js";
+} from "./chunk-VFO5WY5X.js";
 
 // src/runner.ts
 function errorDetails(error) {

package/dist/chunk-VFO5WY5X.js

@@ -0,0 +1,162 @@
+// src/result.ts
+function isTerminalStatus(status) {
+  return status === "blocked" || status === "failed" || status === "ready_to_ship" || status === "shipped" || status === "completed";
+}
+function isSuccessfulStatus(status) {
+  return status !== "blocked" && status !== "failed";
+}
+function compactRecord(input) {
+  return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== void 0 && value !== null && value !== ""));
+}
+function nonEmptyString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function recordValue(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function firstNonEmptyString(...values) {
+  for (const value of values) {
+    const normalized = nonEmptyString(value);
+    if (normalized) return normalized;
+  }
+  return void 0;
+}
+function firstBoolean(...values) {
+  for (const value of values) {
+    if (typeof value === "boolean") return value;
+  }
+  return void 0;
+}
+function normalizeTerminalMetadata(input) {
+  const riddleState = recordValue(input.riddleState) || {};
+  const result = recordValue(input.engineResult) || {};
+  const contract = recordValue(result.checkpointContract) || {};
+  const details = recordValue(input.checkpointDetails) || recordValue(contract.details) || {};
+  const shipReport = recordValue(riddleState.ship_report) || recordValue(result.ship_report) || recordValue(result.shipReport) || recordValue(details.ship_report) || recordValue(details.shipReport) || {};
+  const markedReady = firstBoolean(
+    riddleState.marked_ready,
+    result.marked_ready,
+    result.markedReady,
+    details.marked_ready,
+    details.markedReady,
+    shipReport.marked_ready
+  );
+  const leftDraft = firstBoolean(
+    riddleState.left_draft,
+    result.left_draft,
+    result.leftDraft,
+    details.left_draft,
+    details.leftDraft,
+    shipReport.left_draft
+  );
+  const finalized = firstBoolean(riddleState.finalized, result.finalized, details.finalized);
+  return compactRecord({
+    pr_url: firstNonEmptyString(riddleState.pr_url, result.pr_url, result.prUrl, details.pr_url, details.prUrl, shipReport.pr_url),
+    pr_branch: firstNonEmptyString(
+      riddleState.pr_branch,
+      riddleState.target_branch,
+      result.pr_branch,
+      result.prBranch,
+      details.pr_branch,
+      details.prBranch,
+      shipReport.pr_branch,
+      shipReport.branch
+    ),
+    marked_ready: markedReady,
+    left_draft: leftDraft,
+    ci_status: firstNonEmptyString(riddleState.ci_status, result.ci_status, result.ciStatus, details.ci_status, details.ciStatus, shipReport.ci_status),
+    ship_commit: firstNonEmptyString(riddleState.ship_commit, result.ship_commit, result.shipCommit, details.ship_commit, details.shipCommit, shipReport.shipped_commit, shipReport.ship_commit),
+    ship_remote_head: firstNonEmptyString(riddleState.ship_remote_head, result.ship_remote_head, result.shipRemoteHead, details.ship_remote_head, details.shipRemoteHead, shipReport.ship_remote_head),
+    proof_comment_url: firstNonEmptyString(riddleState.proof_comment_url, result.proof_comment_url, result.proofCommentUrl, details.proof_comment_url, details.proofCommentUrl, shipReport.proof_comment_url),
+    before_artifact_url: firstNonEmptyString(riddleState.before_artifact_url, riddleState.before_cdn, result.before_artifact_url, result.beforeArtifactUrl, details.before_artifact_url, details.beforeArtifactUrl, shipReport.before_artifact_url),
+    prod_artifact_url: firstNonEmptyString(riddleState.prod_artifact_url, riddleState.prod_cdn, result.prod_artifact_url, result.prodArtifactUrl, details.prod_artifact_url, details.prodArtifactUrl, shipReport.prod_artifact_url),
+    after_artifact_url: firstNonEmptyString(riddleState.after_artifact_url, riddleState.after_cdn, result.after_artifact_url, result.afterArtifactUrl, details.after_artifact_url, details.afterArtifactUrl, shipReport.after_artifact_url),
+    ship_report: Object.keys(shipReport).length ? shipReport : void 0,
+    notification: recordValue(riddleState.notification) || recordValue(riddleState.discord_notification) || recordValue(result.notification) || recordValue(result.discord_notification),
+    proof_decision: nonEmptyString(riddleState.proof_decision) || nonEmptyString(result.proof_decision),
+    merge_recommendation: nonEmptyString(riddleState.merge_recommendation) || nonEmptyString(result.merge_recommendation),
+    finalized: typeof finalized === "boolean" ? finalized : void 0
+  });
+}
+function applyTerminalMetadata(state, metadata) {
+  const prUrl = nonEmptyString(metadata.pr_url);
+  if (prUrl) state.pr_url = prUrl;
+  const prBranch = nonEmptyString(metadata.pr_branch);
+  if (prBranch) state.pr_branch = prBranch;
+  if (typeof metadata.marked_ready === "boolean") state.marked_ready = metadata.marked_ready;
+  if (typeof metadata.left_draft === "boolean") state.left_draft = metadata.left_draft;
+  const ciStatus = nonEmptyString(metadata.ci_status);
+  if (ciStatus) state.ci_status = ciStatus;
+  const shipCommit = nonEmptyString(metadata.ship_commit);
+  if (shipCommit) state.ship_commit = shipCommit;
+  const shipRemoteHead = nonEmptyString(metadata.ship_remote_head);
+  if (shipRemoteHead) state.ship_remote_head = shipRemoteHead;
+  const proofCommentUrl = nonEmptyString(metadata.proof_comment_url);
+  if (proofCommentUrl) state.proof_comment_url = proofCommentUrl;
+  const beforeArtifactUrl = nonEmptyString(metadata.before_artifact_url);
+  if (beforeArtifactUrl) state.before_artifact_url = beforeArtifactUrl;
+  const prodArtifactUrl = nonEmptyString(metadata.prod_artifact_url);
+  if (prodArtifactUrl) state.prod_artifact_url = prodArtifactUrl;
+  const afterArtifactUrl = nonEmptyString(metadata.after_artifact_url);
+  if (afterArtifactUrl) state.after_artifact_url = afterArtifactUrl;
+  const shipReport = recordValue(metadata.ship_report);
+  if (shipReport) state.ship_report = shipReport;
+  const notification = recordValue(metadata.notification);
+  if (notification) state.notification = notification;
+  const proofDecision = nonEmptyString(metadata.proof_decision);
+  if (proofDecision) state.proof_decision = proofDecision;
+  const mergeRecommendation = nonEmptyString(metadata.merge_recommendation);
+  if (mergeRecommendation) state.merge_recommendation = mergeRecommendation;
+  if (typeof metadata.finalized === "boolean") state.finalized = metadata.finalized;
+  return state;
+}
+function createRunResult(input) {
+  const status = input.status || input.state.status;
+  const ok = isSuccessfulStatus(status);
+  const state = input.metadata ? applyTerminalMetadata(input.state, input.metadata) : input.state;
+  state.status = status;
+  state.ok = ok;
+  return compactRecord({
+    ok,
+    status,
+    run_id: state.run_id,
+    state_path: input.state_path ?? state.state_path ?? null,
+    worktree_path: state.worktree_path ?? null,
+    branch: state.branch ?? null,
+    current_stage: state.current_stage ?? null,
+    iterations: state.iterations,
+    last_checkpoint: state.last_checkpoint ?? null,
+    last_summary: input.last_summary ?? null,
+    event_count: state.events.length,
+    pr_url: state.pr_url,
+    pr_branch: state.pr_branch,
+    marked_ready: state.marked_ready,
+    left_draft: state.left_draft,
+    ci_status: state.ci_status,
+    ship_commit: state.ship_commit,
+    ship_remote_head: state.ship_remote_head,
+    proof_comment_url: state.proof_comment_url,
+    before_artifact_url: state.before_artifact_url,
+    prod_artifact_url: state.prod_artifact_url,
+    after_artifact_url: state.after_artifact_url,
+    ship_report: state.ship_report,
+    notification: state.notification,
+    proof_decision: state.proof_decision,
+    merge_recommendation: state.merge_recommendation,
+    finalized: state.finalized,
+    blocker: state.blocker,
+    evidence_bundle: input.evidence_bundle,
+    raw: input.raw
+  });
+}
+
+export {
+  isTerminalStatus,
+  isSuccessfulStatus,
+  compactRecord,
+  nonEmptyString,
+  recordValue,
+  normalizeTerminalMetadata,
+  applyTerminalMetadata,
+  createRunResult
+};

package/dist/{chunk-UON7C6N4.js → chunk-YWJENUSI.js}

@@ -5,7 +5,7 @@ import {
   createRunStatusSnapshot,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-5FHUOSNO.js";
+} from "./chunk-AHQIV5QN.js";
 import {
   applyTerminalMetadata,
   compactRecord,
@@ -13,7 +13,7 @@ import {
   nonEmptyString,
   normalizeTerminalMetadata,
   recordValue
-} from "./chunk-5DC6YXN4.js";
+} from "./chunk-VFO5WY5X.js";
 
 // src/engine-harness.ts
 import { execFileSync } from "child_process";
@@ -175,6 +175,7 @@ function initialRunParams(request, input, state) {
     use_auth: request.use_auth,
     color_scheme: request.color_scheme,
     wait_for_selector: request.wait_for_selector,
+    leave_draft: request.leave_draft || void 0,
     discord_channel: request.integration_context?.channel_id,
     discord_thread_id: request.integration_context?.thread_id,
     discord_message_id: request.integration_context?.message_id,
@@ -577,7 +578,8 @@ async function runRiddleProofEngineHarness(input) {
       state_path: state.state_path,
       engine_state_path: request.engine_state_path || null,
       max_iterations: maxIterations,
-      ship_mode: effectiveShipMode(request, input.config)
+      ship_mode: effectiveShipMode(request, input.config),
+      leave_draft: request.leave_draft || false
     }
   });
   let engine;
@@ -594,6 +596,9 @@ async function runRiddleProofEngineHarness(input) {
   let nextParams = input.resume_params || initialRunParams(request, input, state);
   let lastResult = null;
   for (let index = 0; index < maxIterations; index += 1) {
+    if (request.leave_draft && nextParams.leave_draft === void 0) {
+      nextParams = { ...nextParams, leave_draft: true };
+    }
     state.iterations += 1;
     const stage = stageFromWorkflowParams(nextParams);
     heartbeat(state, {

package/dist/engine-harness.cjs

@@ -53,16 +53,64 @@ function nonEmptyString(value) {
 function recordValue(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
+function firstNonEmptyString(...values) {
+  for (const value of values) {
+    const normalized = nonEmptyString(value);
+    if (normalized) return normalized;
+  }
+  return void 0;
+}
+function firstBoolean(...values) {
+  for (const value of values) {
+    if (typeof value === "boolean") return value;
+  }
+  return void 0;
+}
 function normalizeTerminalMetadata(input) {
   const riddleState = recordValue(input.riddleState) || {};
   const result = recordValue(input.engineResult) || {};
   const contract = recordValue(result.checkpointContract) || {};
   const details = recordValue(input.checkpointDetails) || recordValue(contract.details) || {};
-  const markedReady = riddleState.marked_ready ?? result.marked_ready ?? result.markedReady ?? details.marked_ready ?? details.markedReady;
-  const finalized = riddleState.finalized ?? result.finalized ?? details.finalized;
+  const shipReport = recordValue(riddleState.ship_report) || recordValue(result.ship_report) || recordValue(result.shipReport) || recordValue(details.ship_report) || recordValue(details.shipReport) || {};
+  const markedReady = firstBoolean(
+    riddleState.marked_ready,
+    result.marked_ready,
+    result.markedReady,
+    details.marked_ready,
+    details.markedReady,
+    shipReport.marked_ready
+  );
+  const leftDraft = firstBoolean(
+    riddleState.left_draft,
+    result.left_draft,
+    result.leftDraft,
+    details.left_draft,
+    details.leftDraft,
+    shipReport.left_draft
+  );
+  const finalized = firstBoolean(riddleState.finalized, result.finalized, details.finalized);
   return compactRecord({
-    pr_url: nonEmptyString(riddleState.pr_url) || nonEmptyString(result.pr_url) || nonEmptyString(result.prUrl) || nonEmptyString(details.pr_url) || nonEmptyString(details.prUrl),
-    marked_ready: typeof markedReady === "boolean" ? markedReady : void 0,
+    pr_url: firstNonEmptyString(riddleState.pr_url, result.pr_url, result.prUrl, details.pr_url, details.prUrl, shipReport.pr_url),
+    pr_branch: firstNonEmptyString(
+      riddleState.pr_branch,
+      riddleState.target_branch,
+      result.pr_branch,
+      result.prBranch,
+      details.pr_branch,
+      details.prBranch,
+      shipReport.pr_branch,
+      shipReport.branch
+    ),
+    marked_ready: markedReady,
+    left_draft: leftDraft,
+    ci_status: firstNonEmptyString(riddleState.ci_status, result.ci_status, result.ciStatus, details.ci_status, details.ciStatus, shipReport.ci_status),
+    ship_commit: firstNonEmptyString(riddleState.ship_commit, result.ship_commit, result.shipCommit, details.ship_commit, details.shipCommit, shipReport.shipped_commit, shipReport.ship_commit),
+    ship_remote_head: firstNonEmptyString(riddleState.ship_remote_head, result.ship_remote_head, result.shipRemoteHead, details.ship_remote_head, details.shipRemoteHead, shipReport.ship_remote_head),
+    proof_comment_url: firstNonEmptyString(riddleState.proof_comment_url, result.proof_comment_url, result.proofCommentUrl, details.proof_comment_url, details.proofCommentUrl, shipReport.proof_comment_url),
+    before_artifact_url: firstNonEmptyString(riddleState.before_artifact_url, riddleState.before_cdn, result.before_artifact_url, result.beforeArtifactUrl, details.before_artifact_url, details.beforeArtifactUrl, shipReport.before_artifact_url),
+    prod_artifact_url: firstNonEmptyString(riddleState.prod_artifact_url, riddleState.prod_cdn, result.prod_artifact_url, result.prodArtifactUrl, details.prod_artifact_url, details.prodArtifactUrl, shipReport.prod_artifact_url),
+    after_artifact_url: firstNonEmptyString(riddleState.after_artifact_url, riddleState.after_cdn, result.after_artifact_url, result.afterArtifactUrl, details.after_artifact_url, details.afterArtifactUrl, shipReport.after_artifact_url),
+    ship_report: Object.keys(shipReport).length ? shipReport : void 0,
     notification: recordValue(riddleState.notification) || recordValue(riddleState.discord_notification) || recordValue(result.notification) || recordValue(result.discord_notification),
     proof_decision: nonEmptyString(riddleState.proof_decision) || nonEmptyString(result.proof_decision),
     merge_recommendation: nonEmptyString(riddleState.merge_recommendation) || nonEmptyString(result.merge_recommendation),
@@ -72,7 +120,26 @@ function normalizeTerminalMetadata(input) {
 function applyTerminalMetadata(state, metadata) {
   const prUrl = nonEmptyString(metadata.pr_url);
   if (prUrl) state.pr_url = prUrl;
+  const prBranch = nonEmptyString(metadata.pr_branch);
+  if (prBranch) state.pr_branch = prBranch;
   if (typeof metadata.marked_ready === "boolean") state.marked_ready = metadata.marked_ready;
+  if (typeof metadata.left_draft === "boolean") state.left_draft = metadata.left_draft;
+  const ciStatus = nonEmptyString(metadata.ci_status);
+  if (ciStatus) state.ci_status = ciStatus;
+  const shipCommit = nonEmptyString(metadata.ship_commit);
+  if (shipCommit) state.ship_commit = shipCommit;
+  const shipRemoteHead = nonEmptyString(metadata.ship_remote_head);
+  if (shipRemoteHead) state.ship_remote_head = shipRemoteHead;
+  const proofCommentUrl = nonEmptyString(metadata.proof_comment_url);
+  if (proofCommentUrl) state.proof_comment_url = proofCommentUrl;
+  const beforeArtifactUrl = nonEmptyString(metadata.before_artifact_url);
+  if (beforeArtifactUrl) state.before_artifact_url = beforeArtifactUrl;
+  const prodArtifactUrl = nonEmptyString(metadata.prod_artifact_url);
+  if (prodArtifactUrl) state.prod_artifact_url = prodArtifactUrl;
+  const afterArtifactUrl = nonEmptyString(metadata.after_artifact_url);
+  if (afterArtifactUrl) state.after_artifact_url = afterArtifactUrl;
+  const shipReport = recordValue(metadata.ship_report);
+  if (shipReport) state.ship_report = shipReport;
   const notification = recordValue(metadata.notification);
   if (notification) state.notification = notification;
   const proofDecision = nonEmptyString(metadata.proof_decision);
@@ -101,7 +168,17 @@ function createRunResult(input) {
     last_summary: input.last_summary ?? null,
     event_count: state.events.length,
     pr_url: state.pr_url,
+    pr_branch: state.pr_branch,
     marked_ready: state.marked_ready,
+    left_draft: state.left_draft,
+    ci_status: state.ci_status,
+    ship_commit: state.ship_commit,
+    ship_remote_head: state.ship_remote_head,
+    proof_comment_url: state.proof_comment_url,
+    before_artifact_url: state.before_artifact_url,
+    prod_artifact_url: state.prod_artifact_url,
+    after_artifact_url: state.after_artifact_url,
+    ship_report: state.ship_report,
     notification: state.notification,
     proof_decision: state.proof_decision,
     merge_recommendation: state.merge_recommendation,
@@ -171,6 +248,7 @@ function normalizeRunParams(input) {
     color_scheme: input.color_scheme,
     wait_for_selector: input.wait_for_selector,
     ship_mode: input.ship_mode,
+    leave_draft: input.leave_draft,
     engine_state_path: input.engine_state_path,
     harness_state_path: input.harness_state_path,
     max_iterations: input.max_iterations,
@@ -415,6 +493,7 @@ function initialRunParams(request, input, state) {
     use_auth: request.use_auth,
     color_scheme: request.color_scheme,
     wait_for_selector: request.wait_for_selector,
+    leave_draft: request.leave_draft || void 0,
     discord_channel: request.integration_context?.channel_id,
     discord_thread_id: request.integration_context?.thread_id,
     discord_message_id: request.integration_context?.message_id,
@@ -817,7 +896,8 @@ async function runRiddleProofEngineHarness(input) {
       state_path: state.state_path,
       engine_state_path: request.engine_state_path || null,
       max_iterations: maxIterations,
-      ship_mode: effectiveShipMode(request, input.config)
+      ship_mode: effectiveShipMode(request, input.config),
+      leave_draft: request.leave_draft || false
     }
   });
   let engine;
@@ -834,6 +914,9 @@ async function runRiddleProofEngineHarness(input) {
   let nextParams = input.resume_params || initialRunParams(request, input, state);
   let lastResult = null;
   for (let index = 0; index < maxIterations; index += 1) {
+    if (request.leave_draft && nextParams.leave_draft === void 0) {
+      nextParams = { ...nextParams, leave_draft: true };
+    }
     state.iterations += 1;
     const stage = stageFromWorkflowParams(nextParams);
     heartbeat(state, {

package/dist/engine-harness.d.cts

@@ -4,6 +4,7 @@ type RiddleProofShipMode = "none" | "ship";
 interface RiddleProofWorkflowParams extends Record<string, unknown> {
     action: string;
     state_path?: string;
+    leave_draft?: boolean;
 }
 interface RiddleProofEngineResult extends Record<string, unknown> {
     ok?: boolean;

package/dist/engine-harness.d.ts

@@ -4,6 +4,7 @@ type RiddleProofShipMode = "none" | "ship";
 interface RiddleProofWorkflowParams extends Record<string, unknown> {
     action: string;
     state_path?: string;
+    leave_draft?: boolean;
 }
 interface RiddleProofEngineResult extends Record<string, unknown> {
     ok?: boolean;

package/dist/engine-harness.js

@@ -2,9 +2,9 @@ import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
   runRiddleProofEngineHarness
-} from "./chunk-UON7C6N4.js";
-import "./chunk-5FHUOSNO.js";
-import "./chunk-5DC6YXN4.js";
+} from "./chunk-YWJENUSI.js";
+import "./chunk-AHQIV5QN.js";
+import "./chunk-VFO5WY5X.js";
 export {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,

package/dist/index.cjs

@@ -69,16 +69,64 @@ function nonEmptyString(value) {
 function recordValue(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
+function firstNonEmptyString(...values) {
+  for (const value of values) {
+    const normalized = nonEmptyString(value);
+    if (normalized) return normalized;
+  }
+  return void 0;
+}
+function firstBoolean(...values) {
+  for (const value of values) {
+    if (typeof value === "boolean") return value;
+  }
+  return void 0;
+}
 function normalizeTerminalMetadata(input) {
   const riddleState = recordValue(input.riddleState) || {};
   const result = recordValue(input.engineResult) || {};
   const contract = recordValue(result.checkpointContract) || {};
   const details = recordValue(input.checkpointDetails) || recordValue(contract.details) || {};
-  const markedReady = riddleState.marked_ready ?? result.marked_ready ?? result.markedReady ?? details.marked_ready ?? details.markedReady;
-  const finalized = riddleState.finalized ?? result.finalized ?? details.finalized;
+  const shipReport = recordValue(riddleState.ship_report) || recordValue(result.ship_report) || recordValue(result.shipReport) || recordValue(details.ship_report) || recordValue(details.shipReport) || {};
+  const markedReady = firstBoolean(
+    riddleState.marked_ready,
+    result.marked_ready,
+    result.markedReady,
+    details.marked_ready,
+    details.markedReady,
+    shipReport.marked_ready
+  );
+  const leftDraft = firstBoolean(
+    riddleState.left_draft,
+    result.left_draft,
+    result.leftDraft,
+    details.left_draft,
+    details.leftDraft,
+    shipReport.left_draft
+  );
+  const finalized = firstBoolean(riddleState.finalized, result.finalized, details.finalized);
   return compactRecord({
-    pr_url: nonEmptyString(riddleState.pr_url) || nonEmptyString(result.pr_url) || nonEmptyString(result.prUrl) || nonEmptyString(details.pr_url) || nonEmptyString(details.prUrl),
-    marked_ready: typeof markedReady === "boolean" ? markedReady : void 0,
+    pr_url: firstNonEmptyString(riddleState.pr_url, result.pr_url, result.prUrl, details.pr_url, details.prUrl, shipReport.pr_url),
+    pr_branch: firstNonEmptyString(
+      riddleState.pr_branch,
+      riddleState.target_branch,
+      result.pr_branch,
+      result.prBranch,
+      details.pr_branch,
+      details.prBranch,
+      shipReport.pr_branch,
+      shipReport.branch
+    ),
+    marked_ready: markedReady,
+    left_draft: leftDraft,
+    ci_status: firstNonEmptyString(riddleState.ci_status, result.ci_status, result.ciStatus, details.ci_status, details.ciStatus, shipReport.ci_status),
+    ship_commit: firstNonEmptyString(riddleState.ship_commit, result.ship_commit, result.shipCommit, details.ship_commit, details.shipCommit, shipReport.shipped_commit, shipReport.ship_commit),
+    ship_remote_head: firstNonEmptyString(riddleState.ship_remote_head, result.ship_remote_head, result.shipRemoteHead, details.ship_remote_head, details.shipRemoteHead, shipReport.ship_remote_head),
+    proof_comment_url: firstNonEmptyString(riddleState.proof_comment_url, result.proof_comment_url, result.proofCommentUrl, details.proof_comment_url, details.proofCommentUrl, shipReport.proof_comment_url),
+    before_artifact_url: firstNonEmptyString(riddleState.before_artifact_url, riddleState.before_cdn, result.before_artifact_url, result.beforeArtifactUrl, details.before_artifact_url, details.beforeArtifactUrl, shipReport.before_artifact_url),
+    prod_artifact_url: firstNonEmptyString(riddleState.prod_artifact_url, riddleState.prod_cdn, result.prod_artifact_url, result.prodArtifactUrl, details.prod_artifact_url, details.prodArtifactUrl, shipReport.prod_artifact_url),
+    after_artifact_url: firstNonEmptyString(riddleState.after_artifact_url, riddleState.after_cdn, result.after_artifact_url, result.afterArtifactUrl, details.after_artifact_url, details.afterArtifactUrl, shipReport.after_artifact_url),
+    ship_report: Object.keys(shipReport).length ? shipReport : void 0,
     notification: recordValue(riddleState.notification) || recordValue(riddleState.discord_notification) || recordValue(result.notification) || recordValue(result.discord_notification),
     proof_decision: nonEmptyString(riddleState.proof_decision) || nonEmptyString(result.proof_decision),
     merge_recommendation: nonEmptyString(riddleState.merge_recommendation) || nonEmptyString(result.merge_recommendation),
@@ -88,7 +136,26 @@ function normalizeTerminalMetadata(input) {
 function applyTerminalMetadata(state, metadata) {
   const prUrl = nonEmptyString(metadata.pr_url);
   if (prUrl) state.pr_url = prUrl;
+  const prBranch = nonEmptyString(metadata.pr_branch);
+  if (prBranch) state.pr_branch = prBranch;
   if (typeof metadata.marked_ready === "boolean") state.marked_ready = metadata.marked_ready;
+  if (typeof metadata.left_draft === "boolean") state.left_draft = metadata.left_draft;
+  const ciStatus = nonEmptyString(metadata.ci_status);
+  if (ciStatus) state.ci_status = ciStatus;
+  const shipCommit = nonEmptyString(metadata.ship_commit);
+  if (shipCommit) state.ship_commit = shipCommit;
+  const shipRemoteHead = nonEmptyString(metadata.ship_remote_head);
+  if (shipRemoteHead) state.ship_remote_head = shipRemoteHead;
+  const proofCommentUrl = nonEmptyString(metadata.proof_comment_url);
+  if (proofCommentUrl) state.proof_comment_url = proofCommentUrl;
+  const beforeArtifactUrl = nonEmptyString(metadata.before_artifact_url);
+  if (beforeArtifactUrl) state.before_artifact_url = beforeArtifactUrl;
+  const prodArtifactUrl = nonEmptyString(metadata.prod_artifact_url);
+  if (prodArtifactUrl) state.prod_artifact_url = prodArtifactUrl;
+  const afterArtifactUrl = nonEmptyString(metadata.after_artifact_url);
+  if (afterArtifactUrl) state.after_artifact_url = afterArtifactUrl;
+  const shipReport = recordValue(metadata.ship_report);
+  if (shipReport) state.ship_report = shipReport;
   const notification = recordValue(metadata.notification);
   if (notification) state.notification = notification;
   const proofDecision = nonEmptyString(metadata.proof_decision);
@@ -117,7 +184,17 @@ function createRunResult(input) {
     last_summary: input.last_summary ?? null,
     event_count: state.events.length,
     pr_url: state.pr_url,
+    pr_branch: state.pr_branch,
     marked_ready: state.marked_ready,
+    left_draft: state.left_draft,
+    ci_status: state.ci_status,
+    ship_commit: state.ship_commit,
+    ship_remote_head: state.ship_remote_head,
+    proof_comment_url: state.proof_comment_url,
+    before_artifact_url: state.before_artifact_url,
+    prod_artifact_url: state.prod_artifact_url,
+    after_artifact_url: state.after_artifact_url,
+    ship_report: state.ship_report,
     notification: state.notification,
     proof_decision: state.proof_decision,
     merge_recommendation: state.merge_recommendation,
@@ -187,6 +264,7 @@ function normalizeRunParams(input) {
     color_scheme: input.color_scheme,
     wait_for_selector: input.wait_for_selector,
     ship_mode: input.ship_mode,
+    leave_draft: input.leave_draft,
     engine_state_path: input.engine_state_path,
     harness_state_path: input.harness_state_path,
     max_iterations: input.max_iterations,
@@ -917,6 +995,7 @@ function initialRunParams(request, input, state) {
     use_auth: request.use_auth,
     color_scheme: request.color_scheme,
     wait_for_selector: request.wait_for_selector,
+    leave_draft: request.leave_draft || void 0,
     discord_channel: request.integration_context?.channel_id,
     discord_thread_id: request.integration_context?.thread_id,
     discord_message_id: request.integration_context?.message_id,
@@ -1319,7 +1398,8 @@ async function runRiddleProofEngineHarness(input) {
       state_path: state.state_path,
       engine_state_path: request.engine_state_path || null,
       max_iterations: maxIterations,
-      ship_mode: effectiveShipMode(request, input.config)
+      ship_mode: effectiveShipMode(request, input.config),
+      leave_draft: request.leave_draft || false
     }
   });
   let engine;
@@ -1336,6 +1416,9 @@ async function runRiddleProofEngineHarness(input) {
   let nextParams = input.resume_params || initialRunParams(request, input, state);
   let lastResult = null;
   for (let index = 0; index < maxIterations; index += 1) {
+    if (request.leave_draft && nextParams.leave_draft === void 0) {
+      nextParams = { ...nextParams, leave_draft: true };
+    }
     state.iterations += 1;
     const stage = stageFromWorkflowParams(nextParams);
     heartbeat(state, {

package/dist/index.js

@@ -2,10 +2,10 @@ import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
   runRiddleProofEngineHarness
-} from "./chunk-UON7C6N4.js";
+} from "./chunk-YWJENUSI.js";
 import {
   runRiddleProof
-} from "./chunk-F65YYXVO.js";
+} from "./chunk-RMY27ZEW.js";
 import {
   RIDDLE_PROOF_RUN_STATE_VERSION,
   appendRunEvent,
@@ -15,7 +15,7 @@ import {
   normalizeIntegrationContext,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-5FHUOSNO.js";
+} from "./chunk-AHQIV5QN.js";
 import {
   applyTerminalMetadata,
   compactRecord,
@@ -25,7 +25,7 @@ import {
   nonEmptyString,
   normalizeTerminalMetadata,
   recordValue
-} from "./chunk-5DC6YXN4.js";
+} from "./chunk-VFO5WY5X.js";
 import "./chunk-6F4PWJZI.js";
 export {
   RIDDLE_PROOF_RUN_STATE_VERSION,

package/dist/openclaw.cjs

@@ -81,6 +81,7 @@ function normalizeRunParams(input) {
     color_scheme: input.color_scheme,
     wait_for_selector: input.wait_for_selector,
     ship_mode: input.ship_mode,
+    leave_draft: input.leave_draft,
     engine_state_path: input.engine_state_path,
     harness_state_path: input.harness_state_path,
     max_iterations: input.max_iterations,
@@ -144,6 +145,7 @@ function toRiddleProofRunParams(params) {
     color_scheme: params.color_scheme,
     wait_for_selector: params.wait_for_selector,
     ship_mode: params.ship_mode || (params.ship_after_verify ? "ship" : void 0),
+    leave_draft: params.leave_draft,
     engine_state_path: params.state_path,
     harness_state_path: params.harness_state_path,
     max_iterations: params.max_iterations,

package/dist/openclaw.d.cts

@@ -28,6 +28,7 @@ interface OpenClawProofedChangeParams {
     wait_for_selector?: string;
     ship_after_verify?: boolean;
     ship_mode?: "none" | "ship";
+    leave_draft?: boolean;
     state_path?: string;
     harness_state_path?: string;
     max_iterations?: number;

package/dist/openclaw.d.ts

@@ -28,6 +28,7 @@ interface OpenClawProofedChangeParams {
     wait_for_selector?: string;
     ship_after_verify?: boolean;
     ship_mode?: "none" | "ship";
+    leave_draft?: boolean;
     state_path?: string;
     harness_state_path?: string;
     max_iterations?: number;

package/dist/openclaw.js

@@ -1,10 +1,10 @@
 import {
   normalizeIntegrationContext,
   normalizeRunParams
-} from "./chunk-5FHUOSNO.js";
+} from "./chunk-AHQIV5QN.js";
 import {
   compactRecord
-} from "./chunk-5DC6YXN4.js";
+} from "./chunk-VFO5WY5X.js";
 
 // src/openclaw.ts
 function parseOpenClawAssertions(value) {
@@ -60,6 +60,7 @@ function toRiddleProofRunParams(params) {
     color_scheme: params.color_scheme,
     wait_for_selector: params.wait_for_selector,
     ship_mode: params.ship_mode || (params.ship_after_verify ? "ship" : void 0),
+    leave_draft: params.leave_draft,
     engine_state_path: params.state_path,
     harness_state_path: params.harness_state_path,
     max_iterations: params.max_iterations,

package/dist/result.cjs

@@ -45,16 +45,64 @@ function nonEmptyString(value) {
 function recordValue(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
+function firstNonEmptyString(...values) {
+  for (const value of values) {
+    const normalized = nonEmptyString(value);
+    if (normalized) return normalized;
+  }
+  return void 0;
+}
+function firstBoolean(...values) {
+  for (const value of values) {
+    if (typeof value === "boolean") return value;
+  }
+  return void 0;
+}
 function normalizeTerminalMetadata(input) {
   const riddleState = recordValue(input.riddleState) || {};
   const result = recordValue(input.engineResult) || {};
   const contract = recordValue(result.checkpointContract) || {};
   const details = recordValue(input.checkpointDetails) || recordValue(contract.details) || {};
-  const markedReady = riddleState.marked_ready ?? result.marked_ready ?? result.markedReady ?? details.marked_ready ?? details.markedReady;
-  const finalized = riddleState.finalized ?? result.finalized ?? details.finalized;
+  const shipReport = recordValue(riddleState.ship_report) || recordValue(result.ship_report) || recordValue(result.shipReport) || recordValue(details.ship_report) || recordValue(details.shipReport) || {};
+  const markedReady = firstBoolean(
+    riddleState.marked_ready,
+    result.marked_ready,
+    result.markedReady,
+    details.marked_ready,
+    details.markedReady,
+    shipReport.marked_ready
+  );
+  const leftDraft = firstBoolean(
+    riddleState.left_draft,
+    result.left_draft,
+    result.leftDraft,
+    details.left_draft,
+    details.leftDraft,
+    shipReport.left_draft
+  );
+  const finalized = firstBoolean(riddleState.finalized, result.finalized, details.finalized);
   return compactRecord({
-    pr_url: nonEmptyString(riddleState.pr_url) || nonEmptyString(result.pr_url) || nonEmptyString(result.prUrl) || nonEmptyString(details.pr_url) || nonEmptyString(details.prUrl),
-    marked_ready: typeof markedReady === "boolean" ? markedReady : void 0,
+    pr_url: firstNonEmptyString(riddleState.pr_url, result.pr_url, result.prUrl, details.pr_url, details.prUrl, shipReport.pr_url),
+    pr_branch: firstNonEmptyString(
+      riddleState.pr_branch,
+      riddleState.target_branch,
+      result.pr_branch,
+      result.prBranch,
+      details.pr_branch,
+      details.prBranch,
+      shipReport.pr_branch,
+      shipReport.branch
+    ),
+    marked_ready: markedReady,
+    left_draft: leftDraft,
+    ci_status: firstNonEmptyString(riddleState.ci_status, result.ci_status, result.ciStatus, details.ci_status, details.ciStatus, shipReport.ci_status),
+    ship_commit: firstNonEmptyString(riddleState.ship_commit, result.ship_commit, result.shipCommit, details.ship_commit, details.shipCommit, shipReport.shipped_commit, shipReport.ship_commit),
+    ship_remote_head: firstNonEmptyString(riddleState.ship_remote_head, result.ship_remote_head, result.shipRemoteHead, details.ship_remote_head, details.shipRemoteHead, shipReport.ship_remote_head),
+    proof_comment_url: firstNonEmptyString(riddleState.proof_comment_url, result.proof_comment_url, result.proofCommentUrl, details.proof_comment_url, details.proofCommentUrl, shipReport.proof_comment_url),
+    before_artifact_url: firstNonEmptyString(riddleState.before_artifact_url, riddleState.before_cdn, result.before_artifact_url, result.beforeArtifactUrl, details.before_artifact_url, details.beforeArtifactUrl, shipReport.before_artifact_url),
+    prod_artifact_url: firstNonEmptyString(riddleState.prod_artifact_url, riddleState.prod_cdn, result.prod_artifact_url, result.prodArtifactUrl, details.prod_artifact_url, details.prodArtifactUrl, shipReport.prod_artifact_url),
+    after_artifact_url: firstNonEmptyString(riddleState.after_artifact_url, riddleState.after_cdn, result.after_artifact_url, result.afterArtifactUrl, details.after_artifact_url, details.afterArtifactUrl, shipReport.after_artifact_url),
+    ship_report: Object.keys(shipReport).length ? shipReport : void 0,
     notification: recordValue(riddleState.notification) || recordValue(riddleState.discord_notification) || recordValue(result.notification) || recordValue(result.discord_notification),
     proof_decision: nonEmptyString(riddleState.proof_decision) || nonEmptyString(result.proof_decision),
     merge_recommendation: nonEmptyString(riddleState.merge_recommendation) || nonEmptyString(result.merge_recommendation),
@@ -64,7 +112,26 @@ function normalizeTerminalMetadata(input) {
 function applyTerminalMetadata(state, metadata) {
   const prUrl = nonEmptyString(metadata.pr_url);
   if (prUrl) state.pr_url = prUrl;
+  const prBranch = nonEmptyString(metadata.pr_branch);
+  if (prBranch) state.pr_branch = prBranch;
   if (typeof metadata.marked_ready === "boolean") state.marked_ready = metadata.marked_ready;
+  if (typeof metadata.left_draft === "boolean") state.left_draft = metadata.left_draft;
+  const ciStatus = nonEmptyString(metadata.ci_status);
+  if (ciStatus) state.ci_status = ciStatus;
+  const shipCommit = nonEmptyString(metadata.ship_commit);
+  if (shipCommit) state.ship_commit = shipCommit;
+  const shipRemoteHead = nonEmptyString(metadata.ship_remote_head);
+  if (shipRemoteHead) state.ship_remote_head = shipRemoteHead;
+  const proofCommentUrl = nonEmptyString(metadata.proof_comment_url);
+  if (proofCommentUrl) state.proof_comment_url = proofCommentUrl;
+  const beforeArtifactUrl = nonEmptyString(metadata.before_artifact_url);
+  if (beforeArtifactUrl) state.before_artifact_url = beforeArtifactUrl;
+  const prodArtifactUrl = nonEmptyString(metadata.prod_artifact_url);
+  if (prodArtifactUrl) state.prod_artifact_url = prodArtifactUrl;
+  const afterArtifactUrl = nonEmptyString(metadata.after_artifact_url);
+  if (afterArtifactUrl) state.after_artifact_url = afterArtifactUrl;
+  const shipReport = recordValue(metadata.ship_report);
+  if (shipReport) state.ship_report = shipReport;
   const notification = recordValue(metadata.notification);
   if (notification) state.notification = notification;
   const proofDecision = nonEmptyString(metadata.proof_decision);
@@ -93,7 +160,17 @@ function createRunResult(input) {
     last_summary: input.last_summary ?? null,
     event_count: state.events.length,
     pr_url: state.pr_url,
+    pr_branch: state.pr_branch,
     marked_ready: state.marked_ready,
+    left_draft: state.left_draft,
+    ci_status: state.ci_status,
+    ship_commit: state.ship_commit,
+    ship_remote_head: state.ship_remote_head,
+    proof_comment_url: state.proof_comment_url,
+    before_artifact_url: state.before_artifact_url,
+    prod_artifact_url: state.prod_artifact_url,
+    after_artifact_url: state.after_artifact_url,
+    ship_report: state.ship_report,
     notification: state.notification,
     proof_decision: state.proof_decision,
     merge_recommendation: state.merge_recommendation,

package/dist/result.js

@@ -7,7 +7,7 @@ import {
   nonEmptyString,
   normalizeTerminalMetadata,
   recordValue
-} from "./chunk-5DC6YXN4.js";
+} from "./chunk-VFO5WY5X.js";
 export {
   applyTerminalMetadata,
   compactRecord,

package/dist/runner.cjs

@@ -40,7 +40,26 @@ function recordValue(value) {
 function applyTerminalMetadata(state, metadata) {
   const prUrl = nonEmptyString(metadata.pr_url);
   if (prUrl) state.pr_url = prUrl;
+  const prBranch = nonEmptyString(metadata.pr_branch);
+  if (prBranch) state.pr_branch = prBranch;
   if (typeof metadata.marked_ready === "boolean") state.marked_ready = metadata.marked_ready;
+  if (typeof metadata.left_draft === "boolean") state.left_draft = metadata.left_draft;
+  const ciStatus = nonEmptyString(metadata.ci_status);
+  if (ciStatus) state.ci_status = ciStatus;
+  const shipCommit = nonEmptyString(metadata.ship_commit);
+  if (shipCommit) state.ship_commit = shipCommit;
+  const shipRemoteHead = nonEmptyString(metadata.ship_remote_head);
+  if (shipRemoteHead) state.ship_remote_head = shipRemoteHead;
+  const proofCommentUrl = nonEmptyString(metadata.proof_comment_url);
+  if (proofCommentUrl) state.proof_comment_url = proofCommentUrl;
+  const beforeArtifactUrl = nonEmptyString(metadata.before_artifact_url);
+  if (beforeArtifactUrl) state.before_artifact_url = beforeArtifactUrl;
+  const prodArtifactUrl = nonEmptyString(metadata.prod_artifact_url);
+  if (prodArtifactUrl) state.prod_artifact_url = prodArtifactUrl;
+  const afterArtifactUrl = nonEmptyString(metadata.after_artifact_url);
+  if (afterArtifactUrl) state.after_artifact_url = afterArtifactUrl;
+  const shipReport = recordValue(metadata.ship_report);
+  if (shipReport) state.ship_report = shipReport;
   const notification = recordValue(metadata.notification);
   if (notification) state.notification = notification;
   const proofDecision = nonEmptyString(metadata.proof_decision);
@@ -69,7 +88,17 @@ function createRunResult(input) {
     last_summary: input.last_summary ?? null,
     event_count: state.events.length,
     pr_url: state.pr_url,
+    pr_branch: state.pr_branch,
     marked_ready: state.marked_ready,
+    left_draft: state.left_draft,
+    ci_status: state.ci_status,
+    ship_commit: state.ship_commit,
+    ship_remote_head: state.ship_remote_head,
+    proof_comment_url: state.proof_comment_url,
+    before_artifact_url: state.before_artifact_url,
+    prod_artifact_url: state.prod_artifact_url,
+    after_artifact_url: state.after_artifact_url,
+    ship_report: state.ship_report,
     notification: state.notification,
     proof_decision: state.proof_decision,
     merge_recommendation: state.merge_recommendation,
@@ -139,6 +168,7 @@ function normalizeRunParams(input) {
     color_scheme: input.color_scheme,
     wait_for_selector: input.wait_for_selector,
     ship_mode: input.ship_mode,
+    leave_draft: input.leave_draft,
     engine_state_path: input.engine_state_path,
     harness_state_path: input.harness_state_path,
     max_iterations: input.max_iterations,

package/dist/runner.js

@@ -1,8 +1,8 @@
 import {
   runRiddleProof
-} from "./chunk-F65YYXVO.js";
-import "./chunk-5FHUOSNO.js";
-import "./chunk-5DC6YXN4.js";
+} from "./chunk-RMY27ZEW.js";
+import "./chunk-AHQIV5QN.js";
+import "./chunk-VFO5WY5X.js";
 export {
   runRiddleProof
 };

package/dist/state.cjs

@@ -101,6 +101,7 @@ function normalizeRunParams(input) {
     color_scheme: input.color_scheme,
     wait_for_selector: input.wait_for_selector,
     ship_mode: input.ship_mode,
+    leave_draft: input.leave_draft,
     engine_state_path: input.engine_state_path,
     harness_state_path: input.harness_state_path,
     max_iterations: input.max_iterations,

package/dist/state.js

@@ -7,8 +7,8 @@ import {
   normalizeIntegrationContext,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-5FHUOSNO.js";
-import "./chunk-5DC6YXN4.js";
+} from "./chunk-AHQIV5QN.js";
+import "./chunk-VFO5WY5X.js";
 export {
   RIDDLE_PROOF_RUN_STATE_VERSION,
   appendRunEvent,

package/dist/types.d.cts

@@ -35,6 +35,7 @@ interface RiddleProofRunParams {
     color_scheme?: "dark" | "light" | (string & {});
     wait_for_selector?: string;
     ship_mode?: "none" | "ship";
+    leave_draft?: boolean;
     engine_state_path?: string;
     harness_state_path?: string;
     max_iterations?: number;
@@ -80,7 +81,17 @@ interface RiddleProofRunState {
     iterations: number;
     last_checkpoint?: string | null;
     pr_url?: string;
+    pr_branch?: string;
     marked_ready?: boolean;
+    left_draft?: boolean;
+    ci_status?: string;
+    ship_commit?: string;
+    ship_remote_head?: string;
+    proof_comment_url?: string;
+    before_artifact_url?: string;
+    prod_artifact_url?: string;
+    after_artifact_url?: string;
+    ship_report?: Record<string, unknown>;
     notification?: Record<string, unknown>;
     proof_decision?: RiddleProofDecision;
     merge_recommendation?: string;
@@ -101,7 +112,17 @@ interface RiddleProofRunResult {
     last_summary?: string | null;
     event_count?: number;
     pr_url?: string;
+    pr_branch?: string;
     marked_ready?: boolean;
+    left_draft?: boolean;
+    ci_status?: string;
+    ship_commit?: string;
+    ship_remote_head?: string;
+    proof_comment_url?: string;
+    before_artifact_url?: string;
+    prod_artifact_url?: string;
+    after_artifact_url?: string;
+    ship_report?: Record<string, unknown>;
     notification?: Record<string, unknown>;
     proof_decision?: RiddleProofDecision;
     merge_recommendation?: string;
@@ -133,6 +154,7 @@ interface RiddleProofEvidenceBundle {
     proof_evidence?: unknown;
     proof_evidence_sample?: unknown;
     assertions?: JsonValue;
+    semantic_context?: Record<string, unknown>;
     summary?: string;
     notes?: string[];
 }
@@ -246,7 +268,17 @@ interface NotificationAdapter {
 }
 interface RiddleProofTerminalMetadata {
     pr_url?: string;
+    pr_branch?: string;
     marked_ready?: boolean;
+    left_draft?: boolean;
+    ci_status?: string;
+    ship_commit?: string;
+    ship_remote_head?: string;
+    proof_comment_url?: string;
+    before_artifact_url?: string;
+    prod_artifact_url?: string;
+    after_artifact_url?: string;
+    ship_report?: Record<string, unknown>;
     notification?: Record<string, unknown>;
     proof_decision?: RiddleProofDecision;
     merge_recommendation?: string;

package/dist/types.d.ts

@@ -35,6 +35,7 @@ interface RiddleProofRunParams {
     color_scheme?: "dark" | "light" | (string & {});
     wait_for_selector?: string;
     ship_mode?: "none" | "ship";
+    leave_draft?: boolean;
     engine_state_path?: string;
     harness_state_path?: string;
     max_iterations?: number;
@@ -80,7 +81,17 @@ interface RiddleProofRunState {
     iterations: number;
     last_checkpoint?: string | null;
     pr_url?: string;
+    pr_branch?: string;
     marked_ready?: boolean;
+    left_draft?: boolean;
+    ci_status?: string;
+    ship_commit?: string;
+    ship_remote_head?: string;
+    proof_comment_url?: string;
+    before_artifact_url?: string;
+    prod_artifact_url?: string;
+    after_artifact_url?: string;
+    ship_report?: Record<string, unknown>;
     notification?: Record<string, unknown>;
     proof_decision?: RiddleProofDecision;
     merge_recommendation?: string;
@@ -101,7 +112,17 @@ interface RiddleProofRunResult {
     last_summary?: string | null;
     event_count?: number;
     pr_url?: string;
+    pr_branch?: string;
     marked_ready?: boolean;
+    left_draft?: boolean;
+    ci_status?: string;
+    ship_commit?: string;
+    ship_remote_head?: string;
+    proof_comment_url?: string;
+    before_artifact_url?: string;
+    prod_artifact_url?: string;
+    after_artifact_url?: string;
+    ship_report?: Record<string, unknown>;
     notification?: Record<string, unknown>;
     proof_decision?: RiddleProofDecision;
     merge_recommendation?: string;
@@ -133,6 +154,7 @@ interface RiddleProofEvidenceBundle {
     proof_evidence?: unknown;
     proof_evidence_sample?: unknown;
     assertions?: JsonValue;
+    semantic_context?: Record<string, unknown>;
     summary?: string;
     notes?: string[];
 }
@@ -246,7 +268,17 @@ interface NotificationAdapter {
 }
 interface RiddleProofTerminalMetadata {
     pr_url?: string;
+    pr_branch?: string;
     marked_ready?: boolean;
+    left_draft?: boolean;
+    ci_status?: string;
+    ship_commit?: string;
+    ship_remote_head?: string;
+    proof_comment_url?: string;
+    before_artifact_url?: string;
+    prod_artifact_url?: string;
+    after_artifact_url?: string;
+    ship_report?: Record<string, unknown>;
     notification?: Record<string, unknown>;
     proof_decision?: RiddleProofDecision;
     merge_recommendation?: string;

package/package.json

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

package/dist/chunk-5DC6YXN4.js

@@ -1,85 +0,0 @@
-// src/result.ts
-function isTerminalStatus(status) {
-  return status === "blocked" || status === "failed" || status === "ready_to_ship" || status === "shipped" || status === "completed";
-}
-function isSuccessfulStatus(status) {
-  return status !== "blocked" && status !== "failed";
-}
-function compactRecord(input) {
-  return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== void 0 && value !== null && value !== ""));
-}
-function nonEmptyString(value) {
-  return typeof value === "string" && value.trim() ? value.trim() : void 0;
-}
-function recordValue(value) {
-  return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
-}
-function normalizeTerminalMetadata(input) {
-  const riddleState = recordValue(input.riddleState) || {};
-  const result = recordValue(input.engineResult) || {};
-  const contract = recordValue(result.checkpointContract) || {};
-  const details = recordValue(input.checkpointDetails) || recordValue(contract.details) || {};
-  const markedReady = riddleState.marked_ready ?? result.marked_ready ?? result.markedReady ?? details.marked_ready ?? details.markedReady;
-  const finalized = riddleState.finalized ?? result.finalized ?? details.finalized;
-  return compactRecord({
-    pr_url: nonEmptyString(riddleState.pr_url) || nonEmptyString(result.pr_url) || nonEmptyString(result.prUrl) || nonEmptyString(details.pr_url) || nonEmptyString(details.prUrl),
-    marked_ready: typeof markedReady === "boolean" ? markedReady : void 0,
-    notification: recordValue(riddleState.notification) || recordValue(riddleState.discord_notification) || recordValue(result.notification) || recordValue(result.discord_notification),
-    proof_decision: nonEmptyString(riddleState.proof_decision) || nonEmptyString(result.proof_decision),
-    merge_recommendation: nonEmptyString(riddleState.merge_recommendation) || nonEmptyString(result.merge_recommendation),
-    finalized: typeof finalized === "boolean" ? finalized : void 0
-  });
-}
-function applyTerminalMetadata(state, metadata) {
-  const prUrl = nonEmptyString(metadata.pr_url);
-  if (prUrl) state.pr_url = prUrl;
-  if (typeof metadata.marked_ready === "boolean") state.marked_ready = metadata.marked_ready;
-  const notification = recordValue(metadata.notification);
-  if (notification) state.notification = notification;
-  const proofDecision = nonEmptyString(metadata.proof_decision);
-  if (proofDecision) state.proof_decision = proofDecision;
-  const mergeRecommendation = nonEmptyString(metadata.merge_recommendation);
-  if (mergeRecommendation) state.merge_recommendation = mergeRecommendation;
-  if (typeof metadata.finalized === "boolean") state.finalized = metadata.finalized;
-  return state;
-}
-function createRunResult(input) {
-  const status = input.status || input.state.status;
-  const ok = isSuccessfulStatus(status);
-  const state = input.metadata ? applyTerminalMetadata(input.state, input.metadata) : input.state;
-  state.status = status;
-  state.ok = ok;
-  return compactRecord({
-    ok,
-    status,
-    run_id: state.run_id,
-    state_path: input.state_path ?? state.state_path ?? null,
-    worktree_path: state.worktree_path ?? null,
-    branch: state.branch ?? null,
-    current_stage: state.current_stage ?? null,
-    iterations: state.iterations,
-    last_checkpoint: state.last_checkpoint ?? null,
-    last_summary: input.last_summary ?? null,
-    event_count: state.events.length,
-    pr_url: state.pr_url,
-    marked_ready: state.marked_ready,
-    notification: state.notification,
-    proof_decision: state.proof_decision,
-    merge_recommendation: state.merge_recommendation,
-    finalized: state.finalized,
-    blocker: state.blocker,
-    evidence_bundle: input.evidence_bundle,
-    raw: input.raw
-  });
-}
-
-export {
-  isTerminalStatus,
-  isSuccessfulStatus,
-  compactRecord,
-  nonEmptyString,
-  recordValue,
-  normalizeTerminalMetadata,
-  applyTerminalMetadata,
-  createRunResult
-};