@riddledc/riddle-proof 0.5.32 → 0.5.34

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

@@ -83,6 +83,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     pr_state: {
         status: string;
@@ -172,6 +175,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     pr_state: {
         status: string;
@@ -259,6 +265,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     pr_state: any;
     cleanup: Record<string, unknown> | null;
@@ -339,6 +348,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     approval: any;
     error: any;
@@ -422,6 +434,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     decisionRequest: any;
     checkpointContract: any;
@@ -509,6 +524,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     };
     state_path: string;
     ok?: undefined;
@@ -594,6 +612,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     shipReport: any;
     checkpointContract: Record<string, unknown>;
@@ -674,6 +695,9 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
         last_requested_advance_stage: any;
         recon_results: any;
         verify_results: any;
+        proof_session: any;
+        parent_proof_session: any;
+        proof_session_artifact_url: any;
     } | null;
     approval: null;
     autoApproved: any;

package/dist/proof-run-engine.js

@@ -14,7 +14,7 @@ import {
   validateShipGate,
   workflowFile,
   writeState
-} from "./chunk-R4BPJNAM.js";
+} from "./chunk-4YCWZVBN.js";
 
 // src/proof-run-engine.ts
 import { execFileSync } from "child_process";
@@ -770,6 +770,9 @@ async function executeWorkflow(params, pluginConfig, resolvedConfig) {
     if (reasons.some((reason) => reason.includes("proof_assessment"))) {
       return "resume with riddle_proof_review using decision=ready_to_ship only after the screenshots and semantic evidence visibly prove the request; otherwise choose needs_implementation or needs_richer_proof";
     }
+    if (reasons.some((reason) => reason.includes("visual_delta"))) {
+      return "rerun verify with a measured before/after visual delta, or choose needs_richer_proof instead of ready_to_ship for this visual proof";
+    }
     if (reasons.some((reason) => reason.includes("after_cdn") || reason.includes("verify_status"))) {
       return "rerun verify with stronger proof framing so after evidence is captured before shipping";
     }

package/dist/proof-session.cjs

@@ -0,0 +1,151 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/proof-session.ts
+var proof_session_exports = {};
+__export(proof_session_exports, {
+  RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION: () => RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION,
+  RIDDLE_PROOF_VISUAL_SESSION_VERSION: () => RIDDLE_PROOF_VISUAL_SESSION_VERSION,
+  buildVisualProofSession: () => buildVisualProofSession,
+  compareVisualProofSessionFingerprint: () => compareVisualProofSessionFingerprint,
+  parseVisualProofSession: () => parseVisualProofSession,
+  visualSessionFingerprint: () => visualSessionFingerprint,
+  visualSessionFingerprintBasis: () => visualSessionFingerprintBasis
+});
+module.exports = __toCommonJS(proof_session_exports);
+var import_node_crypto = require("crypto");
+var RIDDLE_PROOF_VISUAL_SESSION_VERSION = "riddle-proof.visual-session.v1";
+var RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION = "riddle-proof.visual-session.fingerprint.v1";
+function trim(value) {
+  const text = String(value ?? "").trim();
+  return text || void 0;
+}
+function hashString(value) {
+  const text = trim(value);
+  if (!text) return void 0;
+  return (0, import_node_crypto.createHash)("sha256").update(text).digest("hex");
+}
+function stableJson(value) {
+  if (value === void 0) return "null";
+  if (value === null || typeof value !== "object") return JSON.stringify(value);
+  if (Array.isArray(value)) return `[${value.map((item) => stableJson(item)).join(",")}]`;
+  const record = value;
+  return `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${stableJson(record[key])}`).join(",")}}`;
+}
+function withoutUndefined(record) {
+  for (const key of Object.keys(record)) {
+    if (record[key] === void 0) delete record[key];
+  }
+  return record;
+}
+function visualSessionFingerprintBasis(input) {
+  return withoutUndefined({
+    version: RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION,
+    repo: trim(input.repo),
+    route: trim(input.route),
+    wait_for_selector: trim(input.wait_for_selector),
+    reference: trim(input.reference),
+    verification_mode: trim(input.verification_mode)?.toLowerCase(),
+    target_image_url: trim(input.target_image_url),
+    target_image_hash: trim(input.target_image_hash),
+    viewport_matrix: input.viewport_matrix,
+    deterministic_setup: input.deterministic_setup,
+    assertions: input.assertions,
+    capture_script_hash: hashString(input.capture_script)
+  });
+}
+function visualSessionFingerprint(input) {
+  const basis = input.version === RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION ? input : visualSessionFingerprintBasis(input);
+  return (0, import_node_crypto.createHash)("sha256").update(stableJson(basis)).digest("hex");
+}
+function buildVisualProofSession(input) {
+  const basis = visualSessionFingerprintBasis(input);
+  const fingerprint = visualSessionFingerprint(basis);
+  const session = {
+    version: RIDDLE_PROOF_VISUAL_SESSION_VERSION,
+    session_id: `rps_${(/* @__PURE__ */ new Date()).toISOString().replace(/[-:.TZ]/g, "").slice(0, 14)}_${(0, import_node_crypto.randomUUID)().slice(0, 8)}`,
+    run_id: trim(input.run_id),
+    parent_session_id: input.parent?.session_id || null,
+    parent_fingerprint: input.parent?.fingerprint || null,
+    created_at: (/* @__PURE__ */ new Date()).toISOString(),
+    fingerprint,
+    fingerprint_basis: basis,
+    repo: trim(input.repo),
+    branch: trim(input.branch),
+    route: withoutUndefined({
+      path: trim(input.route),
+      observed_after_path: trim(input.observed_after_path)
+    }),
+    reference: trim(input.reference),
+    verification_mode: trim(input.verification_mode),
+    target_image: withoutUndefined({
+      url: trim(input.target_image_url),
+      hash: trim(input.target_image_hash)
+    }),
+    viewport_matrix: input.viewport_matrix,
+    deterministic_setup: input.deterministic_setup,
+    capture: withoutUndefined({
+      proof_plan: trim(input.proof_plan),
+      capture_script: trim(input.capture_script),
+      wait_for_selector: trim(input.wait_for_selector)
+    }),
+    assertions: input.assertions,
+    artifacts: input.artifacts,
+    evidence: input.evidence,
+    status: trim(input.status)
+  };
+  return JSON.parse(JSON.stringify(session));
+}
+function parseVisualProofSession(value) {
+  const parsed = typeof value === "string" ? JSON.parse(value) : value;
+  if (!parsed || typeof parsed !== "object") throw new Error("proof session must be a JSON object");
+  const session = parsed;
+  if (session.version !== RIDDLE_PROOF_VISUAL_SESSION_VERSION) {
+    throw new Error(`unsupported proof session version: ${String(session.version || "")}`);
+  }
+  if (!session.session_id) throw new Error("proof session missing session_id");
+  if (!session.fingerprint) throw new Error("proof session missing fingerprint");
+  return session;
+}
+function compareVisualProofSessionFingerprint(parent, input) {
+  const actual = visualSessionFingerprintBasis(input);
+  const expected = parent.fingerprint_basis || {};
+  const keys = /* @__PURE__ */ new Set([...Object.keys(expected), ...Object.keys(actual)]);
+  const expectedRecord = expected;
+  const actualRecord = actual;
+  const mismatches = [];
+  for (const key of keys) {
+    const expectedValue = expectedRecord[key];
+    const actualValue = actualRecord[key];
+    if (stableJson(expectedValue) !== stableJson(actualValue)) {
+      mismatches.push({ key, expected: expectedValue, actual: actualValue });
+    }
+  }
+  return mismatches;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION,
+  RIDDLE_PROOF_VISUAL_SESSION_VERSION,
+  buildVisualProofSession,
+  compareVisualProofSessionFingerprint,
+  parseVisualProofSession,
+  visualSessionFingerprint,
+  visualSessionFingerprintBasis
+});

package/dist/proof-session.d.cts

@@ -0,0 +1,37 @@
+import { RiddleProofVisualSession, JsonValue, RiddleProofVisualSessionFingerprintBasis } from './types.cjs';
+
+declare const RIDDLE_PROOF_VISUAL_SESSION_VERSION: "riddle-proof.visual-session.v1";
+declare const RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION: "riddle-proof.visual-session.fingerprint.v1";
+interface BuildVisualProofSessionInput {
+    run_id?: string;
+    parent?: RiddleProofVisualSession | null;
+    repo?: string;
+    branch?: string;
+    route?: string;
+    observed_after_path?: string;
+    reference?: string;
+    verification_mode?: string;
+    target_image_url?: string;
+    target_image_hash?: string;
+    viewport_matrix?: JsonValue;
+    deterministic_setup?: JsonValue;
+    proof_plan?: string;
+    capture_script?: string;
+    wait_for_selector?: string;
+    assertions?: JsonValue;
+    artifacts?: RiddleProofVisualSession["artifacts"];
+    evidence?: RiddleProofVisualSession["evidence"];
+    status?: string;
+}
+interface VisualProofSessionMismatch {
+    key: string;
+    expected: JsonValue | undefined;
+    actual: JsonValue | undefined;
+}
+declare function visualSessionFingerprintBasis(input: BuildVisualProofSessionInput): RiddleProofVisualSessionFingerprintBasis;
+declare function visualSessionFingerprint(input: BuildVisualProofSessionInput | RiddleProofVisualSessionFingerprintBasis): string;
+declare function buildVisualProofSession(input: BuildVisualProofSessionInput): RiddleProofVisualSession;
+declare function parseVisualProofSession(value: unknown): RiddleProofVisualSession;
+declare function compareVisualProofSessionFingerprint(parent: RiddleProofVisualSession, input: BuildVisualProofSessionInput): VisualProofSessionMismatch[];
+
+export { type BuildVisualProofSessionInput, RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION, RIDDLE_PROOF_VISUAL_SESSION_VERSION, type VisualProofSessionMismatch, buildVisualProofSession, compareVisualProofSessionFingerprint, parseVisualProofSession, visualSessionFingerprint, visualSessionFingerprintBasis };

package/dist/proof-session.d.ts

@@ -0,0 +1,37 @@
+import { RiddleProofVisualSession, JsonValue, RiddleProofVisualSessionFingerprintBasis } from './types.js';
+
+declare const RIDDLE_PROOF_VISUAL_SESSION_VERSION: "riddle-proof.visual-session.v1";
+declare const RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION: "riddle-proof.visual-session.fingerprint.v1";
+interface BuildVisualProofSessionInput {
+    run_id?: string;
+    parent?: RiddleProofVisualSession | null;
+    repo?: string;
+    branch?: string;
+    route?: string;
+    observed_after_path?: string;
+    reference?: string;
+    verification_mode?: string;
+    target_image_url?: string;
+    target_image_hash?: string;
+    viewport_matrix?: JsonValue;
+    deterministic_setup?: JsonValue;
+    proof_plan?: string;
+    capture_script?: string;
+    wait_for_selector?: string;
+    assertions?: JsonValue;
+    artifacts?: RiddleProofVisualSession["artifacts"];
+    evidence?: RiddleProofVisualSession["evidence"];
+    status?: string;
+}
+interface VisualProofSessionMismatch {
+    key: string;
+    expected: JsonValue | undefined;
+    actual: JsonValue | undefined;
+}
+declare function visualSessionFingerprintBasis(input: BuildVisualProofSessionInput): RiddleProofVisualSessionFingerprintBasis;
+declare function visualSessionFingerprint(input: BuildVisualProofSessionInput | RiddleProofVisualSessionFingerprintBasis): string;
+declare function buildVisualProofSession(input: BuildVisualProofSessionInput): RiddleProofVisualSession;
+declare function parseVisualProofSession(value: unknown): RiddleProofVisualSession;
+declare function compareVisualProofSessionFingerprint(parent: RiddleProofVisualSession, input: BuildVisualProofSessionInput): VisualProofSessionMismatch[];
+
+export { type BuildVisualProofSessionInput, RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION, RIDDLE_PROOF_VISUAL_SESSION_VERSION, type VisualProofSessionMismatch, buildVisualProofSession, compareVisualProofSessionFingerprint, parseVisualProofSession, visualSessionFingerprint, visualSessionFingerprintBasis };

package/dist/proof-session.js

@@ -0,0 +1,18 @@
+import {
+  RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION,
+  RIDDLE_PROOF_VISUAL_SESSION_VERSION,
+  buildVisualProofSession,
+  compareVisualProofSessionFingerprint,
+  parseVisualProofSession,
+  visualSessionFingerprint,
+  visualSessionFingerprintBasis
+} from "./chunk-ODORKNSO.js";
+export {
+  RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION,
+  RIDDLE_PROOF_VISUAL_SESSION_VERSION,
+  buildVisualProofSession,
+  compareVisualProofSessionFingerprint,
+  parseVisualProofSession,
+  visualSessionFingerprint,
+  visualSessionFingerprintBasis
+};

package/dist/result.cjs

@@ -233,6 +233,7 @@ function createRunResult(input) {
     merge_recommendation: state.merge_recommendation,
     finalized: state.finalized,
     blocker: state.blocker,
+    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-TMMKRKY5.js";
+} from "./chunk-J2MERROF.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,
+    proof_session: state.proof_session,
     evidence_bundle: input.evidence_bundle,
     raw: input.raw
   });
@@ -170,6 +171,11 @@ function normalizeRunParams(input) {
     success_criteria: input.success_criteria,
     assertions: input.assertions,
     verification_mode: input.verification_mode,
+    resume_session: input.resume_session,
+    target_image_url: input.target_image_url,
+    target_image_hash: input.target_image_hash,
+    viewport_matrix: input.viewport_matrix,
+    deterministic_setup: input.deterministic_setup,
     reference: input.reference,
     base_branch: input.base_branch,
     before_ref: input.before_ref,

package/dist/runner.js

@@ -1,8 +1,8 @@
 import {
   runRiddleProof
-} from "./chunk-F6VFKS7K.js";
-import "./chunk-7ZJAUEUN.js";
-import "./chunk-TMMKRKY5.js";
+} from "./chunk-MQ2BHHLX.js";
+import "./chunk-OASB3CYU.js";
+import "./chunk-J2MERROF.js";
 export {
   runRiddleProof
 };

package/dist/state.cjs

@@ -119,6 +119,11 @@ function normalizeRunParams(input) {
     success_criteria: input.success_criteria,
     assertions: input.assertions,
     verification_mode: input.verification_mode,
+    resume_session: input.resume_session,
+    target_image_url: input.target_image_url,
+    target_image_hash: input.target_image_hash,
+    viewport_matrix: input.viewport_matrix,
+    deterministic_setup: input.deterministic_setup,
     reference: input.reference,
     base_branch: input.base_branch,
     before_ref: input.before_ref,

package/dist/state.js

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

package/dist/types.d.cts

@@ -19,6 +19,11 @@ interface RiddleProofRunParams {
     success_criteria?: string;
     assertions?: JsonValue;
     verification_mode?: RiddleProofVerificationMode;
+    resume_session?: string;
+    target_image_url?: string;
+    target_image_hash?: string;
+    viewport_matrix?: JsonValue;
+    deterministic_setup?: JsonValue;
     reference?: "prod" | "before" | "both";
     base_branch?: string;
     before_ref?: string;
@@ -105,6 +110,7 @@ interface RiddleProofRunState {
     merge_recommendation?: string;
     implementation_detection_summary?: string | null;
     implementation_detection?: Record<string, unknown> | null;
+    proof_session?: RiddleProofVisualSession;
     finalized?: boolean;
     blocker?: RiddleProofBlocker;
     events: RiddleProofEvent[];
@@ -142,6 +148,7 @@ interface RiddleProofRunResult {
     merge_recommendation?: string;
     finalized?: boolean;
     blocker?: RiddleProofBlocker;
+    proof_session?: RiddleProofVisualSession;
     evidence_bundle?: RiddleProofEvidenceBundle;
     raw?: Record<string, unknown>;
 }
@@ -179,6 +186,7 @@ interface RiddleProofEvidenceBundle {
     baselines?: EvidenceReference[];
     after?: EvidenceReference;
     artifacts?: EvidenceArtifact[];
+    proof_session?: RiddleProofVisualSession;
     proof_evidence?: unknown;
     proof_evidence_sample?: unknown;
     assertions?: JsonValue;
@@ -331,5 +339,63 @@ interface RiddleProofPrLifecycleState {
     next_action?: string;
     cleanup?: Record<string, unknown>;
 }
+interface RiddleProofVisualSession {
+    version: "riddle-proof.visual-session.v1";
+    session_id: string;
+    run_id?: string;
+    parent_session_id?: string | null;
+    parent_fingerprint?: string | null;
+    created_at: string;
+    fingerprint: string;
+    fingerprint_basis: RiddleProofVisualSessionFingerprintBasis;
+    repo?: string;
+    branch?: string;
+    route?: {
+        path?: string;
+        observed_after_path?: string;
+    };
+    reference?: string;
+    verification_mode?: string;
+    target_image?: {
+        url?: string;
+        hash?: string;
+    };
+    viewport_matrix?: JsonValue;
+    deterministic_setup?: JsonValue;
+    capture?: {
+        proof_plan?: string;
+        capture_script?: string;
+        wait_for_selector?: string;
+    };
+    assertions?: JsonValue;
+    artifacts?: {
+        before?: string;
+        prod?: string;
+        after?: string;
+        session?: string;
+        outputs?: EvidenceArtifact[];
+    };
+    evidence?: {
+        visual_delta?: JsonValue;
+        semantic_context?: JsonValue;
+        artifact_contract?: JsonValue;
+        artifact_usage?: JsonValue;
+    };
+    status?: string;
+}
+interface RiddleProofVisualSessionFingerprintBasis {
+    version: "riddle-proof.visual-session.fingerprint.v1";
+    repo?: string;
+    route?: string;
+    wait_for_selector?: string;
+    reference?: string;
+    verification_mode?: string;
+    target_image_url?: string;
+    target_image_hash?: string;
+    viewport_matrix?: JsonValue;
+    deterministic_setup?: JsonValue;
+    assertions?: JsonValue;
+    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, 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, RiddleProofDecision, RiddleProofEvent, RiddleProofEvidenceBundle, RiddleProofPrLifecycleState, RiddleProofPrLifecycleStatus, RiddleProofRunParams, RiddleProofRunResult, RiddleProofRunState, RiddleProofRunStatusSnapshot, RiddleProofStage, RiddleProofStatus, RiddleProofTerminalMetadata, RiddleProofVerificationMode, RiddleProofVisualSession, RiddleProofVisualSessionFingerprintBasis, SetupAdapter, SetupAdapterInput, SetupAdapterResult, ShipAdapter };

package/dist/types.d.ts

@@ -19,6 +19,11 @@ interface RiddleProofRunParams {
     success_criteria?: string;
     assertions?: JsonValue;
     verification_mode?: RiddleProofVerificationMode;
+    resume_session?: string;
+    target_image_url?: string;
+    target_image_hash?: string;
+    viewport_matrix?: JsonValue;
+    deterministic_setup?: JsonValue;
     reference?: "prod" | "before" | "both";
     base_branch?: string;
     before_ref?: string;
@@ -105,6 +110,7 @@ interface RiddleProofRunState {
     merge_recommendation?: string;
     implementation_detection_summary?: string | null;
     implementation_detection?: Record<string, unknown> | null;
+    proof_session?: RiddleProofVisualSession;
     finalized?: boolean;
     blocker?: RiddleProofBlocker;
     events: RiddleProofEvent[];
@@ -142,6 +148,7 @@ interface RiddleProofRunResult {
     merge_recommendation?: string;
     finalized?: boolean;
     blocker?: RiddleProofBlocker;
+    proof_session?: RiddleProofVisualSession;
     evidence_bundle?: RiddleProofEvidenceBundle;
     raw?: Record<string, unknown>;
 }
@@ -179,6 +186,7 @@ interface RiddleProofEvidenceBundle {
     baselines?: EvidenceReference[];
     after?: EvidenceReference;
     artifacts?: EvidenceArtifact[];
+    proof_session?: RiddleProofVisualSession;
     proof_evidence?: unknown;
     proof_evidence_sample?: unknown;
     assertions?: JsonValue;
@@ -331,5 +339,63 @@ interface RiddleProofPrLifecycleState {
     next_action?: string;
     cleanup?: Record<string, unknown>;
 }
+interface RiddleProofVisualSession {
+    version: "riddle-proof.visual-session.v1";
+    session_id: string;
+    run_id?: string;
+    parent_session_id?: string | null;
+    parent_fingerprint?: string | null;
+    created_at: string;
+    fingerprint: string;
+    fingerprint_basis: RiddleProofVisualSessionFingerprintBasis;
+    repo?: string;
+    branch?: string;
+    route?: {
+        path?: string;
+        observed_after_path?: string;
+    };
+    reference?: string;
+    verification_mode?: string;
+    target_image?: {
+        url?: string;
+        hash?: string;
+    };
+    viewport_matrix?: JsonValue;
+    deterministic_setup?: JsonValue;
+    capture?: {
+        proof_plan?: string;
+        capture_script?: string;
+        wait_for_selector?: string;
+    };
+    assertions?: JsonValue;
+    artifacts?: {
+        before?: string;
+        prod?: string;
+        after?: string;
+        session?: string;
+        outputs?: EvidenceArtifact[];
+    };
+    evidence?: {
+        visual_delta?: JsonValue;
+        semantic_context?: JsonValue;
+        artifact_contract?: JsonValue;
+        artifact_usage?: JsonValue;
+    };
+    status?: string;
+}
+interface RiddleProofVisualSessionFingerprintBasis {
+    version: "riddle-proof.visual-session.fingerprint.v1";
+    repo?: string;
+    route?: string;
+    wait_for_selector?: string;
+    reference?: string;
+    verification_mode?: string;
+    target_image_url?: string;
+    target_image_hash?: string;
+    viewport_matrix?: JsonValue;
+    deterministic_setup?: JsonValue;
+    assertions?: JsonValue;
+    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, 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, RiddleProofDecision, RiddleProofEvent, RiddleProofEvidenceBundle, RiddleProofPrLifecycleState, RiddleProofPrLifecycleStatus, RiddleProofRunParams, RiddleProofRunResult, RiddleProofRunState, RiddleProofRunStatusSnapshot, RiddleProofStage, RiddleProofStatus, RiddleProofTerminalMetadata, RiddleProofVerificationMode, RiddleProofVisualSession, RiddleProofVisualSessionFingerprintBasis, SetupAdapter, SetupAdapterInput, SetupAdapterResult, ShipAdapter };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riddledc/riddle-proof",
-  "version": "0.5.32",
+  "version": "0.5.34",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",
@@ -49,6 +49,11 @@
       "import": "./dist/diagnostics.js",
       "require": "./dist/diagnostics.cjs"
     },
+    "./proof-session": {
+      "types": "./dist/proof-session.d.ts",
+      "import": "./dist/proof-session.js",
+      "require": "./dist/proof-session.cjs"
+    },
     "./openclaw": {
       "types": "./dist/openclaw.d.ts",
       "import": "./dist/openclaw.js",
@@ -82,7 +87,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/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/runner.ts src/engine-harness.ts src/diagnostics.ts src/proof-session.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"