@riddledc/riddle-proof 0.4.0 → 0.4.2

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-3XJJ4JOB.js}

@@ -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-US63AYQU.js → chunk-7DED7LM3.js}

@@ -5,7 +5,7 @@ import {
   createRunStatusSnapshot,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-5FHUOSNO.js";
+} from "./chunk-3XJJ4JOB.js";
 import {
   applyTerminalMetadata,
   compactRecord,
@@ -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;
@@ -591,9 +593,12 @@ async function runRiddleProofEngineHarness(input) {
       message
     });
   }
-  let nextParams = initialRunParams(request, input, state);
+  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/{chunk-F65YYXVO.js → chunk-CL2FOOXX.js}

@@ -3,7 +3,7 @@ import {
   appendStageHeartbeat,
   createRunState,
   setRunStatus
-} from "./chunk-5FHUOSNO.js";
+} from "./chunk-3XJJ4JOB.js";
 import {
   createRunResult
 } from "./chunk-5DC6YXN4.js";

package/dist/engine-harness.cjs

@@ -171,6 +171,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 +416,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 +819,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;
@@ -831,9 +834,12 @@ async function runRiddleProofEngineHarness(input) {
       message
     });
   }
-  let nextParams = initialRunParams(request, input, state);
+  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;
@@ -57,6 +58,7 @@ interface RunRiddleProofEngineHarnessInput {
     config?: RiddleProofEngineHarnessConfig;
     state?: RiddleProofRunState;
     state_path?: string;
+    resume_params?: RiddleProofWorkflowParams;
     max_iterations?: number;
     dry_run?: boolean;
     auto_approve?: 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;
@@ -57,6 +58,7 @@ interface RunRiddleProofEngineHarnessInput {
     config?: RiddleProofEngineHarnessConfig;
     state?: RiddleProofRunState;
     state_path?: string;
+    resume_params?: RiddleProofWorkflowParams;
     max_iterations?: number;
     dry_run?: boolean;
     auto_approve?: boolean;

package/dist/engine-harness.js

@@ -2,8 +2,8 @@ import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
   runRiddleProofEngineHarness
-} from "./chunk-US63AYQU.js";
-import "./chunk-5FHUOSNO.js";
+} from "./chunk-7DED7LM3.js";
+import "./chunk-3XJJ4JOB.js";
 import "./chunk-5DC6YXN4.js";
 export {
   createDisabledRiddleProofAgentAdapter,

package/dist/index.cjs

@@ -187,6 +187,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 +918,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 +1321,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;
@@ -1333,9 +1336,12 @@ async function runRiddleProofEngineHarness(input) {
       message
     });
   }
-  let nextParams = initialRunParams(request, input, state);
+  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-US63AYQU.js";
+} from "./chunk-7DED7LM3.js";
 import {
   runRiddleProof
-} from "./chunk-F65YYXVO.js";
+} from "./chunk-CL2FOOXX.js";
 import {
   RIDDLE_PROOF_RUN_STATE_VERSION,
   appendRunEvent,
@@ -15,7 +15,7 @@ import {
   normalizeIntegrationContext,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-5FHUOSNO.js";
+} from "./chunk-3XJJ4JOB.js";
 import {
   applyTerminalMetadata,
   compactRecord,

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,7 +1,7 @@
 import {
   normalizeIntegrationContext,
   normalizeRunParams
-} from "./chunk-5FHUOSNO.js";
+} from "./chunk-3XJJ4JOB.js";
 import {
   compactRecord
 } from "./chunk-5DC6YXN4.js";
@@ -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/runner.cjs

@@ -139,6 +139,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,7 +1,7 @@
 import {
   runRiddleProof
-} from "./chunk-F65YYXVO.js";
-import "./chunk-5FHUOSNO.js";
+} from "./chunk-CL2FOOXX.js";
+import "./chunk-3XJJ4JOB.js";
 import "./chunk-5DC6YXN4.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,7 +7,7 @@ import {
   normalizeIntegrationContext,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-5FHUOSNO.js";
+} from "./chunk-3XJJ4JOB.js";
 import "./chunk-5DC6YXN4.js";
 export {
   RIDDLE_PROOF_RUN_STATE_VERSION,

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;

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;

package/package.json

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