@riddledc/riddle-proof 0.5.37 → 0.5.39

package/dist/index.js

@@ -1,6 +1,15 @@
+import {
+  RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION,
+  RIDDLE_PROOF_VISUAL_SESSION_VERSION,
+  buildVisualProofSession,
+  compareVisualProofSessionFingerprint,
+  parseVisualProofSession,
+  visualSessionFingerprint,
+  visualSessionFingerprintBasis
+} from "./chunk-ODORKNSO.js";
 import {
   runRiddleProof
-} from "./chunk-MQ2BHHLX.js";
+} from "./chunk-RDTMR7XR.js";
 import "./chunk-6F4PWJZI.js";
 import {
   DEFAULT_DIAGNOSTIC_ARRAY_LIMIT,
@@ -16,7 +25,14 @@ import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
   runRiddleProofEngineHarness
-} from "./chunk-GN7HSZ6G.js";
+} from "./chunk-ORRP7CXT.js";
+import {
+  RIDDLE_PROOF_CHECKPOINT_PACKET_VERSION,
+  RIDDLE_PROOF_CHECKPOINT_RESPONSE_VERSION,
+  authorPacketPayloadFromCheckpointResponse,
+  buildAuthorCheckpointPacket,
+  normalizeCheckpointResponse
+} from "./chunk-UQPTCP4D.js";
 import {
   RIDDLE_PROOF_RUN_STATE_VERSION,
   appendRunEvent,
@@ -28,7 +44,7 @@ import {
   normalizePrLifecycleState,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-OASB3CYU.js";
+} from "./chunk-Z3BWCHFV.js";
 import {
   applyTerminalMetadata,
   compactRecord,
@@ -38,7 +54,7 @@ import {
   nonEmptyString,
   normalizeTerminalMetadata,
   recordValue
-} from "./chunk-J2MERROF.js";
+} from "./chunk-Z7QUCDPT.js";
 import {
   RIDDLE_PROOF_PLAYABILITY_ASSESSMENT_VERSION,
   RIDDLE_PROOF_PLAYABILITY_VERSION,
@@ -47,20 +63,13 @@ import {
   isRiddleProofPlayabilityMode
 } from "./chunk-NSWT3VSV.js";
 import "./chunk-4YCWZVBN.js";
-import {
-  RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION,
-  RIDDLE_PROOF_VISUAL_SESSION_VERSION,
-  buildVisualProofSession,
-  compareVisualProofSessionFingerprint,
-  parseVisualProofSession,
-  visualSessionFingerprint,
-  visualSessionFingerprintBasis
-} from "./chunk-ODORKNSO.js";
 export {
   DEFAULT_DIAGNOSTIC_ARRAY_LIMIT,
   DEFAULT_DIAGNOSTIC_HISTORY_LIMIT,
   DEFAULT_DIAGNOSTIC_STRING_LIMIT,
   RIDDLE_PROOF_CAPTURE_DIAGNOSTIC_VERSION,
+  RIDDLE_PROOF_CHECKPOINT_PACKET_VERSION,
+  RIDDLE_PROOF_CHECKPOINT_RESPONSE_VERSION,
   RIDDLE_PROOF_PLAYABILITY_ASSESSMENT_VERSION,
   RIDDLE_PROOF_PLAYABILITY_VERSION,
   RIDDLE_PROOF_RUN_STATE_VERSION,
@@ -72,6 +81,8 @@ export {
   applyPrLifecycleState,
   applyTerminalMetadata,
   assessPlayabilityEvidence,
+  authorPacketPayloadFromCheckpointResponse,
+  buildAuthorCheckpointPacket,
   buildVisualProofSession,
   compactRecord,
   compareVisualProofSessionFingerprint,
@@ -85,6 +96,7 @@ export {
   isSuccessfulStatus,
   isTerminalStatus,
   nonEmptyString,
+  normalizeCheckpointResponse,
   normalizeIntegrationContext,
   normalizePrLifecycleState,
   normalizeRunParams,

package/dist/openclaw.js

@@ -1,10 +1,10 @@
 import {
   normalizeIntegrationContext,
   normalizeRunParams
-} from "./chunk-OASB3CYU.js";
+} from "./chunk-Z3BWCHFV.js";
 import {
   compactRecord
-} from "./chunk-J2MERROF.js";
+} from "./chunk-Z7QUCDPT.js";
 
 // src/openclaw.ts
 function parseOpenClawAssertions(value) {

package/dist/proof-run-engine.d.cts

@@ -277,7 +277,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     blocking?: boolean;
     details?: Record<string, unknown>;
     ok: boolean;
-    action: "ship" | "setup" | "recon" | "author" | "implement" | "verify" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     summary: string;
@@ -362,7 +362,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     continueWithStage?: WorkflowStage | null;
     blocking?: boolean;
     details?: Record<string, unknown>;
-    action: "ship" | "setup" | "recon" | "author" | "implement" | "verify" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     checkpoint: string;
@@ -624,7 +624,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     error?: undefined;
 } | {
     ok: boolean;
-    action: "ship" | "setup" | "recon" | "author" | "implement" | "verify" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     summary: string;

package/dist/proof-run-engine.d.ts

@@ -277,7 +277,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     blocking?: boolean;
     details?: Record<string, unknown>;
     ok: boolean;
-    action: "ship" | "setup" | "recon" | "author" | "implement" | "verify" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     summary: string;
@@ -362,7 +362,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     continueWithStage?: WorkflowStage | null;
     blocking?: boolean;
     details?: Record<string, unknown>;
-    action: "ship" | "setup" | "recon" | "author" | "implement" | "verify" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     checkpoint: string;
@@ -624,7 +624,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     error?: undefined;
 } | {
     ok: boolean;
-    action: "ship" | "setup" | "recon" | "author" | "implement" | "verify" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     summary: string;

package/dist/result.cjs

@@ -233,6 +233,7 @@ function createRunResult(input) {
     merge_recommendation: state.merge_recommendation,
     finalized: state.finalized,
     blocker: state.blocker,
+    checkpoint_packet: state.checkpoint_packet,
     proof_session: state.proof_session,
     evidence_bundle: input.evidence_bundle,
     raw: input.raw

package/dist/result.js

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

package/dist/runner.cjs

@@ -123,6 +123,7 @@ function createRunResult(input) {
     merge_recommendation: state.merge_recommendation,
     finalized: state.finalized,
     blocker: state.blocker,
+    checkpoint_packet: state.checkpoint_packet,
     proof_session: state.proof_session,
     evidence_bundle: input.evidence_bundle,
     raw: input.raw
@@ -221,6 +222,8 @@ function createRunState(input) {
     request: normalizeRunParams(input.request),
     iterations: input.iterations ?? 0,
     last_checkpoint: input.last_checkpoint ?? null,
+    checkpoint_packet: input.checkpoint_packet,
+    checkpoint_history: input.checkpoint_history,
     events: input.events ? [...input.events] : []
   });
 }

package/dist/runner.js

@@ -1,8 +1,8 @@
 import {
   runRiddleProof
-} from "./chunk-MQ2BHHLX.js";
-import "./chunk-OASB3CYU.js";
-import "./chunk-J2MERROF.js";
+} from "./chunk-RDTMR7XR.js";
+import "./chunk-Z3BWCHFV.js";
+import "./chunk-Z7QUCDPT.js";
 export {
   runRiddleProof
 };

package/dist/state.cjs

@@ -169,6 +169,8 @@ function createRunState(input) {
     request: normalizeRunParams(input.request),
     iterations: input.iterations ?? 0,
     last_checkpoint: input.last_checkpoint ?? null,
+    checkpoint_packet: input.checkpoint_packet,
+    checkpoint_history: input.checkpoint_history,
     events: input.events ? [...input.events] : []
   });
 }
@@ -242,6 +244,7 @@ function createRunStatusSnapshot(state, at = timestamp()) {
     elapsed_ms: elapsedMs(state.created_at, at),
     stage_elapsed_ms: elapsedMs(state.stage_started_at, at),
     blocker: state.blocker,
+    checkpoint_packet: state.checkpoint_packet,
     latest_event: latestEvent
   });
 }

package/dist/state.d.cts

@@ -1,4 +1,4 @@
-import { RiddleProofRunParams, RiddleProofStatus, RiddleProofStage, RiddleProofEvent, RiddleProofRunState, RiddleProofPrLifecycleState, RiddleProofRunStatusSnapshot, IntegrationContext } from './types.cjs';
+import { RiddleProofRunParams, RiddleProofStatus, RiddleProofStage, RiddleProofCheckpointPacket, RiddleProofCheckpointResponse, RiddleProofEvent, RiddleProofRunState, RiddleProofPrLifecycleState, RiddleProofRunStatusSnapshot, IntegrationContext } from './types.cjs';
 
 declare const RIDDLE_PROOF_RUN_STATE_VERSION: "riddle-proof.run-state.v1";
 interface CreateRunStateInput {
@@ -14,6 +14,12 @@ interface CreateRunStateInput {
     updated_at?: string;
     iterations?: number;
     last_checkpoint?: string | null;
+    checkpoint_packet?: RiddleProofCheckpointPacket;
+    checkpoint_history?: Array<{
+        ts: string;
+        packet?: RiddleProofCheckpointPacket;
+        response?: RiddleProofCheckpointResponse;
+    }>;
     events?: RiddleProofEvent[];
 }
 type RunEventInput = Omit<RiddleProofEvent, "ts"> & {

package/dist/state.d.ts

@@ -1,4 +1,4 @@
-import { RiddleProofRunParams, RiddleProofStatus, RiddleProofStage, RiddleProofEvent, RiddleProofRunState, RiddleProofPrLifecycleState, RiddleProofRunStatusSnapshot, IntegrationContext } from './types.js';
+import { RiddleProofRunParams, RiddleProofStatus, RiddleProofStage, RiddleProofCheckpointPacket, RiddleProofCheckpointResponse, RiddleProofEvent, RiddleProofRunState, RiddleProofPrLifecycleState, RiddleProofRunStatusSnapshot, IntegrationContext } from './types.js';
 
 declare const RIDDLE_PROOF_RUN_STATE_VERSION: "riddle-proof.run-state.v1";
 interface CreateRunStateInput {
@@ -14,6 +14,12 @@ interface CreateRunStateInput {
     updated_at?: string;
     iterations?: number;
     last_checkpoint?: string | null;
+    checkpoint_packet?: RiddleProofCheckpointPacket;
+    checkpoint_history?: Array<{
+        ts: string;
+        packet?: RiddleProofCheckpointPacket;
+        response?: RiddleProofCheckpointResponse;
+    }>;
     events?: RiddleProofEvent[];
 }
 type RunEventInput = Omit<RiddleProofEvent, "ts"> & {

package/dist/state.js

@@ -9,8 +9,8 @@ import {
   normalizePrLifecycleState,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-OASB3CYU.js";
-import "./chunk-J2MERROF.js";
+} from "./chunk-Z3BWCHFV.js";
+import "./chunk-Z7QUCDPT.js";
 export {
   RIDDLE_PROOF_RUN_STATE_VERSION,
   appendRunEvent,

package/dist/types.d.cts

@@ -3,7 +3,7 @@ type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
 type JsonObject = {
     [key: string]: JsonValue;
 };
-type RiddleProofStatus = "running" | "blocked" | "failed" | "ready_to_ship" | "shipped" | "completed";
+type RiddleProofStatus = "running" | "awaiting_checkpoint" | "blocked" | "failed" | "ready_to_ship" | "shipped" | "completed";
 type RiddleProofPrLifecycleStatus = "unknown" | "open" | "merged" | "closed" | "not_found" | "unavailable" | (string & {});
 type RiddleProofVerificationMode = "proof" | "visual" | "interaction" | "playable" | "gameplay" | "render" | "data" | "json" | "audio" | "log" | "logs" | "metric" | "metrics" | (string & {});
 type RiddleProofDecision = "ready_to_ship" | "needs_richer_proof" | "revise_capture" | "needs_recon" | "needs_implementation" | (string & {});
@@ -52,6 +52,59 @@ interface RiddleProofRunParams {
     dry_run?: boolean;
     integration_context?: IntegrationContext;
 }
+type RiddleProofCheckpointVisibility = "liveblog" | "quiet" | "terminal_only" | "manual" | (string & {});
+type RiddleProofCheckpointRole = "main_agent" | "builder_agent" | "proof_author" | "proof_judge" | "human" | "mechanical" | (string & {});
+interface RiddleProofCheckpointArtifact {
+    role: "before" | "prod" | "after" | "diff" | "log" | "json" | "har" | "video" | (string & {});
+    url?: string;
+    path?: string;
+    name?: string;
+    mime_type?: string;
+    summary?: string;
+}
+interface RiddleProofCheckpointRoutingHint {
+    suggested_role?: RiddleProofCheckpointRole;
+    visibility?: RiddleProofCheckpointVisibility;
+    urgency?: "low" | "normal" | "high" | (string & {});
+    can_auto_answer?: boolean;
+}
+interface RiddleProofCheckpointPacket {
+    version: "riddle-proof.checkpoint.v1";
+    run_id: string;
+    state_path?: string;
+    stage: RiddleProofStage;
+    checkpoint: string;
+    kind: "assess_recon" | "author_proof" | "implement_change" | "assess_proof" | "human_review" | "advance_decision" | (string & {});
+    summary: string;
+    question: string;
+    change_request: string;
+    context?: string;
+    artifacts?: RiddleProofCheckpointArtifact[];
+    state_excerpt?: Record<string, unknown>;
+    evidence_excerpt?: Record<string, unknown>;
+    allowed_decisions: string[];
+    response_schema: Record<string, unknown>;
+    routing_hint?: RiddleProofCheckpointRoutingHint;
+    resume_token?: string;
+    created_at: string;
+}
+interface RiddleProofCheckpointResponse {
+    version: "riddle-proof.checkpoint_response.v1";
+    run_id: string;
+    checkpoint: string;
+    resume_token?: string;
+    decision: string;
+    summary: string;
+    payload?: Record<string, unknown>;
+    reasons?: string[];
+    continue_with_stage?: RiddleProofStage;
+    source?: {
+        kind: "openclaw-main" | "openclaw-subagent" | "codex" | "claude-code" | "human" | "ci" | (string & {});
+        session_id?: string;
+        user_id?: string;
+    };
+    created_at: string;
+}
 interface IntegrationContext {
     source?: "openclaw" | "discord" | "github" | "cli" | "riddle" | (string & {});
     channel_id?: string;
@@ -113,6 +166,12 @@ interface RiddleProofRunState {
     proof_session?: RiddleProofVisualSession;
     finalized?: boolean;
     blocker?: RiddleProofBlocker;
+    checkpoint_packet?: RiddleProofCheckpointPacket;
+    checkpoint_history?: Array<{
+        ts: string;
+        packet?: RiddleProofCheckpointPacket;
+        response?: RiddleProofCheckpointResponse;
+    }>;
     events: RiddleProofEvent[];
 }
 interface RiddleProofRunResult {
@@ -148,6 +207,7 @@ interface RiddleProofRunResult {
     merge_recommendation?: string;
     finalized?: boolean;
     blocker?: RiddleProofBlocker;
+    checkpoint_packet?: RiddleProofCheckpointPacket;
     proof_session?: RiddleProofVisualSession;
     evidence_bundle?: RiddleProofEvidenceBundle;
     raw?: Record<string, unknown>;
@@ -179,6 +239,7 @@ interface RiddleProofRunStatusSnapshot {
     elapsed_ms?: number;
     stage_elapsed_ms?: number;
     blocker?: RiddleProofBlocker;
+    checkpoint_packet?: RiddleProofCheckpointPacket;
     latest_event?: RiddleProofEvent;
 }
 interface RiddleProofEvidenceBundle {
@@ -399,4 +460,4 @@ interface RiddleProofVisualSessionFingerprintBasis {
     capture_script_hash?: string;
 }
 
-export type { EvidenceArtifact, EvidenceReference, ImplementationAdapter, ImplementationAdapterInput, ImplementationAdapterResult, IntegrationContext, JsonObject, JsonPrimitive, JsonValue, JudgeAdapter, NotificationAdapter, PreflightAdapter, PreflightAdapterInput, PreflightAdapterResult, ProofAdapter, ProofAdapterInput, ProofAdapterResult, RiddleProofArtifactRole, RiddleProofAssessment, RiddleProofBlocker, RiddleProofDecision, RiddleProofEvent, RiddleProofEvidenceBundle, RiddleProofPrLifecycleState, RiddleProofPrLifecycleStatus, RiddleProofRunParams, RiddleProofRunResult, RiddleProofRunState, RiddleProofRunStatusSnapshot, RiddleProofStage, RiddleProofStatus, RiddleProofTerminalMetadata, RiddleProofVerificationMode, RiddleProofVisualSession, RiddleProofVisualSessionFingerprintBasis, SetupAdapter, SetupAdapterInput, SetupAdapterResult, ShipAdapter };
+export type { EvidenceArtifact, EvidenceReference, ImplementationAdapter, ImplementationAdapterInput, ImplementationAdapterResult, IntegrationContext, JsonObject, JsonPrimitive, JsonValue, JudgeAdapter, NotificationAdapter, PreflightAdapter, PreflightAdapterInput, PreflightAdapterResult, ProofAdapter, ProofAdapterInput, ProofAdapterResult, RiddleProofArtifactRole, RiddleProofAssessment, RiddleProofBlocker, RiddleProofCheckpointArtifact, RiddleProofCheckpointPacket, RiddleProofCheckpointResponse, RiddleProofCheckpointRole, RiddleProofCheckpointRoutingHint, RiddleProofCheckpointVisibility, RiddleProofDecision, RiddleProofEvent, RiddleProofEvidenceBundle, RiddleProofPrLifecycleState, RiddleProofPrLifecycleStatus, RiddleProofRunParams, RiddleProofRunResult, RiddleProofRunState, RiddleProofRunStatusSnapshot, RiddleProofStage, RiddleProofStatus, RiddleProofTerminalMetadata, RiddleProofVerificationMode, RiddleProofVisualSession, RiddleProofVisualSessionFingerprintBasis, SetupAdapter, SetupAdapterInput, SetupAdapterResult, ShipAdapter };

package/dist/types.d.ts

@@ -3,7 +3,7 @@ type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
 type JsonObject = {
     [key: string]: JsonValue;
 };
-type RiddleProofStatus = "running" | "blocked" | "failed" | "ready_to_ship" | "shipped" | "completed";
+type RiddleProofStatus = "running" | "awaiting_checkpoint" | "blocked" | "failed" | "ready_to_ship" | "shipped" | "completed";
 type RiddleProofPrLifecycleStatus = "unknown" | "open" | "merged" | "closed" | "not_found" | "unavailable" | (string & {});
 type RiddleProofVerificationMode = "proof" | "visual" | "interaction" | "playable" | "gameplay" | "render" | "data" | "json" | "audio" | "log" | "logs" | "metric" | "metrics" | (string & {});
 type RiddleProofDecision = "ready_to_ship" | "needs_richer_proof" | "revise_capture" | "needs_recon" | "needs_implementation" | (string & {});
@@ -52,6 +52,59 @@ interface RiddleProofRunParams {
     dry_run?: boolean;
     integration_context?: IntegrationContext;
 }
+type RiddleProofCheckpointVisibility = "liveblog" | "quiet" | "terminal_only" | "manual" | (string & {});
+type RiddleProofCheckpointRole = "main_agent" | "builder_agent" | "proof_author" | "proof_judge" | "human" | "mechanical" | (string & {});
+interface RiddleProofCheckpointArtifact {
+    role: "before" | "prod" | "after" | "diff" | "log" | "json" | "har" | "video" | (string & {});
+    url?: string;
+    path?: string;
+    name?: string;
+    mime_type?: string;
+    summary?: string;
+}
+interface RiddleProofCheckpointRoutingHint {
+    suggested_role?: RiddleProofCheckpointRole;
+    visibility?: RiddleProofCheckpointVisibility;
+    urgency?: "low" | "normal" | "high" | (string & {});
+    can_auto_answer?: boolean;
+}
+interface RiddleProofCheckpointPacket {
+    version: "riddle-proof.checkpoint.v1";
+    run_id: string;
+    state_path?: string;
+    stage: RiddleProofStage;
+    checkpoint: string;
+    kind: "assess_recon" | "author_proof" | "implement_change" | "assess_proof" | "human_review" | "advance_decision" | (string & {});
+    summary: string;
+    question: string;
+    change_request: string;
+    context?: string;
+    artifacts?: RiddleProofCheckpointArtifact[];
+    state_excerpt?: Record<string, unknown>;
+    evidence_excerpt?: Record<string, unknown>;
+    allowed_decisions: string[];
+    response_schema: Record<string, unknown>;
+    routing_hint?: RiddleProofCheckpointRoutingHint;
+    resume_token?: string;
+    created_at: string;
+}
+interface RiddleProofCheckpointResponse {
+    version: "riddle-proof.checkpoint_response.v1";
+    run_id: string;
+    checkpoint: string;
+    resume_token?: string;
+    decision: string;
+    summary: string;
+    payload?: Record<string, unknown>;
+    reasons?: string[];
+    continue_with_stage?: RiddleProofStage;
+    source?: {
+        kind: "openclaw-main" | "openclaw-subagent" | "codex" | "claude-code" | "human" | "ci" | (string & {});
+        session_id?: string;
+        user_id?: string;
+    };
+    created_at: string;
+}
 interface IntegrationContext {
     source?: "openclaw" | "discord" | "github" | "cli" | "riddle" | (string & {});
     channel_id?: string;
@@ -113,6 +166,12 @@ interface RiddleProofRunState {
     proof_session?: RiddleProofVisualSession;
     finalized?: boolean;
     blocker?: RiddleProofBlocker;
+    checkpoint_packet?: RiddleProofCheckpointPacket;
+    checkpoint_history?: Array<{
+        ts: string;
+        packet?: RiddleProofCheckpointPacket;
+        response?: RiddleProofCheckpointResponse;
+    }>;
     events: RiddleProofEvent[];
 }
 interface RiddleProofRunResult {
@@ -148,6 +207,7 @@ interface RiddleProofRunResult {
     merge_recommendation?: string;
     finalized?: boolean;
     blocker?: RiddleProofBlocker;
+    checkpoint_packet?: RiddleProofCheckpointPacket;
     proof_session?: RiddleProofVisualSession;
     evidence_bundle?: RiddleProofEvidenceBundle;
     raw?: Record<string, unknown>;
@@ -179,6 +239,7 @@ interface RiddleProofRunStatusSnapshot {
     elapsed_ms?: number;
     stage_elapsed_ms?: number;
     blocker?: RiddleProofBlocker;
+    checkpoint_packet?: RiddleProofCheckpointPacket;
     latest_event?: RiddleProofEvent;
 }
 interface RiddleProofEvidenceBundle {
@@ -399,4 +460,4 @@ interface RiddleProofVisualSessionFingerprintBasis {
     capture_script_hash?: string;
 }
 
-export type { EvidenceArtifact, EvidenceReference, ImplementationAdapter, ImplementationAdapterInput, ImplementationAdapterResult, IntegrationContext, JsonObject, JsonPrimitive, JsonValue, JudgeAdapter, NotificationAdapter, PreflightAdapter, PreflightAdapterInput, PreflightAdapterResult, ProofAdapter, ProofAdapterInput, ProofAdapterResult, RiddleProofArtifactRole, RiddleProofAssessment, RiddleProofBlocker, RiddleProofDecision, RiddleProofEvent, RiddleProofEvidenceBundle, RiddleProofPrLifecycleState, RiddleProofPrLifecycleStatus, RiddleProofRunParams, RiddleProofRunResult, RiddleProofRunState, RiddleProofRunStatusSnapshot, RiddleProofStage, RiddleProofStatus, RiddleProofTerminalMetadata, RiddleProofVerificationMode, RiddleProofVisualSession, RiddleProofVisualSessionFingerprintBasis, SetupAdapter, SetupAdapterInput, SetupAdapterResult, ShipAdapter };
+export type { EvidenceArtifact, EvidenceReference, ImplementationAdapter, ImplementationAdapterInput, ImplementationAdapterResult, IntegrationContext, JsonObject, JsonPrimitive, JsonValue, JudgeAdapter, NotificationAdapter, PreflightAdapter, PreflightAdapterInput, PreflightAdapterResult, ProofAdapter, ProofAdapterInput, ProofAdapterResult, RiddleProofArtifactRole, RiddleProofAssessment, RiddleProofBlocker, RiddleProofCheckpointArtifact, RiddleProofCheckpointPacket, RiddleProofCheckpointResponse, RiddleProofCheckpointRole, RiddleProofCheckpointRoutingHint, RiddleProofCheckpointVisibility, RiddleProofDecision, RiddleProofEvent, RiddleProofEvidenceBundle, RiddleProofPrLifecycleState, RiddleProofPrLifecycleStatus, RiddleProofRunParams, RiddleProofRunResult, RiddleProofRunState, RiddleProofRunStatusSnapshot, RiddleProofStage, RiddleProofStatus, RiddleProofTerminalMetadata, RiddleProofVerificationMode, RiddleProofVisualSession, RiddleProofVisualSessionFingerprintBasis, SetupAdapter, SetupAdapterInput, SetupAdapterResult, ShipAdapter };

package/lib/workspace-core.mjs

@@ -15,6 +15,8 @@ import {
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 
+const DEFAULT_RIDDLE_PROOF_SCRATCH_ROOT = "/var/tmp/riddle-proof";
+
 function commandEnv() {
   return { ...process.env, HOME: "/root" };
 }
@@ -58,6 +60,26 @@ export function uniqueToken(now = new Date()) {
   return `${stamp}-${randomUUID().slice(0, 8)}`;
 }
 
+function envFlag(name, defaultValue = false) {
+  const raw = String(process.env[name] || "").trim().toLowerCase();
+  if (["1", "true", "yes", "on"].includes(raw)) return true;
+  if (["0", "false", "no", "off"].includes(raw)) return false;
+  return defaultValue;
+}
+
+export function riddleProofScratchRoot() {
+  const configured = (process.env.RIDDLE_PROOF_SCRATCH_ROOT || "").trim();
+  if (configured) return path.resolve(configured);
+  if (envFlag("RIDDLE_PROOF_USE_TMP_SCRATCH", false)) {
+    return path.join("/tmp", "riddle-proof");
+  }
+  return DEFAULT_RIDDLE_PROOF_SCRATCH_ROOT;
+}
+
+export function defaultRiddleProofWorktreeRoot() {
+  return path.join(riddleProofScratchRoot(), ".riddle-proof-worktrees");
+}
+
 export function workspaceRoots({ workspaceRoot = "", currentRepoDir = "" } = {}) {
   const roots = [];
   for (const candidate of [
@@ -332,7 +354,7 @@ function dependencyCacheRoot(projectDir) {
   if (worktreeIndex >= 0) {
     return path.join(resolved.slice(0, worktreeIndex), ".riddle-proof-deps-cache");
   }
-  return path.join(path.dirname(resolved), ".riddle-proof-deps-cache");
+  return path.join(riddleProofScratchRoot(), ".riddle-proof-deps-cache");
 }
 
 function dependencyCacheKey(fingerprint, installCmd) {
@@ -497,6 +519,15 @@ async function main() {
     case "dependency-fingerprint":
       ok({ fingerprint: computeDependencyFingerprint(payload.projectDir) });
       return;
+    case "scratch-root":
+      ok({
+        scratchRoot: riddleProofScratchRoot(),
+        worktreeRoot: defaultRiddleProofWorktreeRoot(),
+      });
+      return;
+    case "dependency-cache-root":
+      ok({ cacheRoot: dependencyCacheRoot(payload.projectDir || process.cwd()) });
+      return;
     default:
       throw new Error(`Unsupported command: ${command}`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riddledc/riddle-proof",
-  "version": "0.5.37",
+  "version": "0.5.39",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",
@@ -34,6 +34,11 @@
       "import": "./dist/state.js",
       "require": "./dist/state.cjs"
     },
+    "./checkpoint": {
+      "types": "./dist/checkpoint.d.ts",
+      "import": "./dist/checkpoint.js",
+      "require": "./dist/checkpoint.cjs"
+    },
     "./runner": {
       "types": "./dist/runner.d.ts",
       "import": "./dist/runner.js",
@@ -92,7 +97,7 @@
     "typescript": "^5.4.5"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/types.ts src/result.ts src/state.ts src/runner.ts src/engine-harness.ts src/diagnostics.ts src/proof-session.ts src/playability.ts src/openclaw.ts src/proof-run-core.ts src/proof-run-engine.ts --format cjs,esm --dts --out-dir dist --clean",
+    "build": "tsup src/index.ts src/types.ts src/result.ts src/state.ts src/checkpoint.ts src/runner.ts src/engine-harness.ts src/diagnostics.ts src/proof-session.ts src/playability.ts src/openclaw.ts src/proof-run-core.ts src/proof-run-engine.ts --format cjs,esm --dts --out-dir dist --clean",
     "clean": "rm -rf dist",
     "lint": "echo 'lint: (not configured)'",
     "test": "npm run build && node test.js && node proof-run.test.js"