@riddledc/riddle-proof 0.5.53 → 0.5.55

package/dist/basic-gameplay.cjs

@@ -0,0 +1,255 @@
+"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/basic-gameplay.ts
+var basic_gameplay_exports = {};
+__export(basic_gameplay_exports, {
+  RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION: () => RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION,
+  RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION: () => RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION,
+  assessBasicGameplayEvidence: () => assessBasicGameplayEvidence,
+  assessBasicGameplayRoute: () => assessBasicGameplayRoute,
+  extractBasicGameplayEvidence: () => extractBasicGameplayEvidence
+});
+module.exports = __toCommonJS(basic_gameplay_exports);
+var RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION = "riddle-proof.basic-gameplay.v1";
+var RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION = "riddle-proof.basic-gameplay.assessment.v1";
+var BASIC_GAMEPLAY_CONTAINER_KEYS = [
+  "basic_gameplay",
+  "basicGameplay",
+  "basic_gameplay_evidence",
+  "basicGameplayEvidence",
+  "gameplay_proof",
+  "gameplayProof"
+];
+function assessBasicGameplayEvidence(evidence, options = {}) {
+  const run = extractBasicGameplayEvidence(evidence);
+  if (!run) {
+    return {
+      version: RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION,
+      evidence_present: false,
+      passed: false,
+      checked_routes: 0,
+      passing_routes: 0,
+      failing_routes: [],
+      failure_counts: {},
+      warning_counts: {},
+      route_results: []
+    };
+  }
+  const routeResults = (run.results || []).map((route) => assessBasicGameplayRoute(route, options));
+  const failingRoutes = routeResults.filter((result) => !result.ok).map((result) => ({
+    name: result.name,
+    path: result.path,
+    failures: result.failures,
+    warnings: result.warnings
+  }));
+  return {
+    version: RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION,
+    evidence_present: true,
+    passed: failingRoutes.length === 0,
+    checked_routes: routeResults.length,
+    passing_routes: routeResults.filter((result) => result.ok).length,
+    failing_routes: failingRoutes,
+    failure_counts: countCodes(routeResults.flatMap((result) => result.failures)),
+    warning_counts: countCodes(routeResults.flatMap((result) => result.warnings)),
+    route_results: routeResults
+  };
+}
+function assessBasicGameplayRoute(route, options = {}) {
+  const maxMobileOverflowPx = options.maxMobileOverflowPx ?? 4;
+  const minBodyTextLength = options.minBodyTextLength ?? 20;
+  const minVisibleLargeNodes = options.minVisibleLargeNodes ?? 3;
+  const minSurfaceLargeNodes = options.minSurfaceLargeNodes ?? 8;
+  const warnOnMissingResetPath = options.warnOnMissingResetPath ?? true;
+  const warnOnConsoleError = options.warnOnConsoleError ?? true;
+  const failOnConsoleError = options.failOnConsoleError ?? false;
+  const failures = [];
+  const warnings = [];
+  const initial = route.initial || {};
+  const timed = route.timed || {};
+  const afterAction = route.after_action || route.afterAction || {};
+  const mobile = route.mobile || {};
+  const timedChange = changed(initial, timed);
+  const actionChange = changed(timed, afterAction);
+  const surfaceVisible = numberValue(initial.visible_canvas_count) > 0 || numberValue(initial.enabled_clickable_count) > 0 || numberValue(initial.visible_large_node_count) >= minSurfaceLargeNodes;
+  const actionResults = listValue(route.action_results || route.actionResults);
+  const actionAttempted = actionResults.some((result) => result.ok === true && result.action !== "wait");
+  const actionFailed = actionResults.some((result) => result.ok === false && result.action !== "wait");
+  const stateChangeObserved = actionChange.changed || timedChange.changed;
+  const resetPathPresent = numberValue(initial.reset_control_count) > 0 || numberValue(timed.reset_control_count) > 0 || numberValue(afterAction.reset_control_count) > 0;
+  const responseStatus = firstNumber(route.http_status, route.response_status, route.status);
+  const pageErrorCount = numberValue(route.page_error_count);
+  const consoleErrorCount = numberValue(route.console_error_count);
+  const mobileOverflowPx = numberValue(mobile.overflow_px);
+  if (responseStatus !== null && responseStatus >= 400) failures.push("route_http_error");
+  if (pageErrorCount > 0) failures.push("fatal_page_error");
+  if (numberValue(initial.body_text_length) < minBodyTextLength && numberValue(initial.visible_large_node_count) < minVisibleLargeNodes) {
+    failures.push("route_blank_or_thin");
+  }
+  if (!surfaceVisible) failures.push("no_game_surface");
+  if (mobileOverflowPx > maxMobileOverflowPx) failures.push("mobile_horizontal_overflow");
+  if (!actionAttempted && !timedChange.changed) failures.push("primary_control_missing");
+  if (actionAttempted && !stateChangeObserved) failures.push("primary_control_inert");
+  if (failOnConsoleError && consoleErrorCount > 0) failures.push("fatal_page_error");
+  if (numberValue(initial.visible_canvas_count) > 0 && actionAttempted && !timedChange.canvas_changed && !actionChange.canvas_changed && !actionChange.screenshot_changed) {
+    warnings.push("canvas_inert");
+  }
+  if (actionFailed) warnings.push("some_actions_failed");
+  if (warnOnMissingResetPath && !resetPathPresent && route.requires_reset !== false && actionAttempted && stateChangeObserved) {
+    warnings.push("missing_reset_path");
+  }
+  if (warnOnConsoleError && consoleErrorCount > 0) warnings.push("critical_console_error");
+  return {
+    name: route.name,
+    path: route.path,
+    ok: failures.length === 0,
+    failures,
+    warnings,
+    signals: {
+      route_loaded: !failures.includes("route_http_error") && !failures.includes("route_blank_or_thin"),
+      surface_visible: surfaceVisible,
+      action_attempted: actionAttempted,
+      timed_progression_observed: timedChange.changed,
+      first_interaction_observed: actionChange.changed,
+      state_change_observed: stateChangeObserved,
+      mobile_overflow_absent: mobileOverflowPx <= maxMobileOverflowPx,
+      reset_path_present: resetPathPresent,
+      fatal_errors_absent: pageErrorCount === 0
+    },
+    diffs: {
+      timed: timedChange,
+      after_action: actionChange
+    }
+  };
+}
+function extractBasicGameplayEvidence(...sources) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const source of sources) {
+    const found = findBasicGameplayEvidence(source, seen);
+    if (found) return found;
+  }
+  return null;
+}
+function findBasicGameplayEvidence(value, seen, depth = 0) {
+  if (depth > 6 || value === null || value === void 0) return null;
+  if (typeof value === "string") {
+    const parsed = parseJson(value);
+    return parsed === null ? null : findBasicGameplayEvidence(parsed, seen, depth + 1);
+  }
+  if (Array.isArray(value)) {
+    if (seen.has(value)) return null;
+    seen.add(value);
+    if (value.some((item) => hasRouteShape(recordValue(item)))) {
+      return { results: value.filter((item) => hasRouteShape(recordValue(item))) };
+    }
+    for (const item of value) {
+      const found = findBasicGameplayEvidence(item, seen, depth + 1);
+      if (found) return found;
+    }
+    return null;
+  }
+  const record = recordValue(value);
+  if (!record || seen.has(record)) return null;
+  seen.add(record);
+  if (record.version === RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION || Array.isArray(record.results)) {
+    return {
+      ...record,
+      results: listValue(record.results).filter((item) => Boolean(recordValue(item)))
+    };
+  }
+  if (hasRouteShape(record)) {
+    return { results: [record] };
+  }
+  for (const key of BASIC_GAMEPLAY_CONTAINER_KEYS) {
+    if (Object.prototype.hasOwnProperty.call(record, key)) {
+      const nested = findBasicGameplayEvidence(record[key], seen, depth + 1);
+      if (nested) return nested;
+    }
+  }
+  for (const item of Object.values(record)) {
+    const found = findBasicGameplayEvidence(item, seen, depth + 1);
+    if (found) return found;
+  }
+  return null;
+}
+function hasRouteShape(record) {
+  return Boolean(record && (record.initial || record.after_action || record.afterAction || record.action_results || record.actionResults) && (record.path || record.name));
+}
+function changed(before, after) {
+  const bodyTextChanged = Boolean(before.body_text_hash && after.body_text_hash && before.body_text_hash !== after.body_text_hash);
+  const screenshotChanged = Boolean(before.screenshot_hash && after.screenshot_hash && before.screenshot_hash !== after.screenshot_hash);
+  const beforeCanvasHashes = canvasHashes(before.canvases);
+  const afterCanvasHashes = canvasHashes(after.canvases);
+  const canvasChanged = Boolean(beforeCanvasHashes && afterCanvasHashes && beforeCanvasHashes !== afterCanvasHashes);
+  return {
+    body_text_changed: bodyTextChanged,
+    screenshot_changed: screenshotChanged,
+    canvas_changed: canvasChanged,
+    changed: bodyTextChanged || screenshotChanged || canvasChanged
+  };
+}
+function canvasHashes(canvases) {
+  return (canvases || []).map((canvas) => canvas.hash).filter(Boolean).join("|");
+}
+function countCodes(codes) {
+  const counts = {};
+  for (const code of codes) counts[code] = (counts[code] || 0) + 1;
+  return counts;
+}
+function firstNumber(...values) {
+  for (const value of values) {
+    const number = numericValue(value);
+    if (number !== null) return number;
+  }
+  return null;
+}
+function numberValue(value) {
+  return numericValue(value) ?? 0;
+}
+function numericValue(value) {
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  if (typeof value === "string" && value.trim()) {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : null;
+  }
+  return null;
+}
+function recordValue(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function listValue(value) {
+  return Array.isArray(value) ? value : [];
+}
+function parseJson(value) {
+  const trimmed = value.trim();
+  if (!trimmed || !/^[{[]/.test(trimmed)) return null;
+  try {
+    return JSON.parse(trimmed);
+  } catch {
+    return null;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION,
+  RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION,
+  assessBasicGameplayEvidence,
+  assessBasicGameplayRoute,
+  extractBasicGameplayEvidence
+});

package/dist/basic-gameplay.d.cts

@@ -0,0 +1,117 @@
+declare const RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION = "riddle-proof.basic-gameplay.v1";
+declare const RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION = "riddle-proof.basic-gameplay.assessment.v1";
+type BasicGameplayFailureCode = "route_http_error" | "fatal_page_error" | "route_blank_or_thin" | "no_game_surface" | "mobile_horizontal_overflow" | "primary_control_missing" | "primary_control_inert";
+type BasicGameplayWarningCode = "canvas_inert" | "some_actions_failed" | "missing_reset_path" | "critical_console_error";
+interface BasicGameplayCanvasState {
+    index?: number;
+    width?: number;
+    height?: number;
+    css_width?: number;
+    css_height?: number;
+    visible?: boolean;
+    readable?: boolean;
+    hash?: string | null;
+}
+interface BasicGameplaySnapshot {
+    screenshot_hash?: string | null;
+    body_text_hash?: string | null;
+    body_text_length?: number;
+    visible_large_node_count?: number;
+    enabled_clickable_count?: number;
+    reset_control_count?: number;
+    visible_canvas_count?: number;
+    canvases?: BasicGameplayCanvasState[];
+    [key: string]: unknown;
+}
+interface BasicGameplayActionResult {
+    ok?: boolean;
+    action?: string;
+    [key: string]: unknown;
+}
+interface BasicGameplayMobileEvidence {
+    overflow_px?: number;
+    [key: string]: unknown;
+}
+interface RiddleProofBasicGameplayRouteEvidence {
+    name?: string;
+    path?: string;
+    http_status?: number | null;
+    response_status?: number | null;
+    status?: number | null;
+    console_error_count?: number;
+    page_error_count?: number;
+    initial?: BasicGameplaySnapshot;
+    timed?: BasicGameplaySnapshot;
+    after_action?: BasicGameplaySnapshot;
+    afterAction?: BasicGameplaySnapshot;
+    mobile?: BasicGameplayMobileEvidence;
+    action_results?: BasicGameplayActionResult[];
+    actionResults?: BasicGameplayActionResult[];
+    requires_reset?: boolean;
+    [key: string]: unknown;
+}
+interface RiddleProofBasicGameplayEvidence {
+    version?: typeof RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION | string;
+    site?: string | null;
+    base_url?: string;
+    results?: RiddleProofBasicGameplayRouteEvidence[];
+    [key: string]: unknown;
+}
+interface AssessBasicGameplayOptions {
+    maxMobileOverflowPx?: number;
+    minBodyTextLength?: number;
+    minVisibleLargeNodes?: number;
+    minSurfaceLargeNodes?: number;
+    warnOnMissingResetPath?: boolean;
+    warnOnConsoleError?: boolean;
+    failOnConsoleError?: boolean;
+}
+interface BasicGameplayChangeSummary {
+    body_text_changed: boolean;
+    screenshot_changed: boolean;
+    canvas_changed: boolean;
+    changed: boolean;
+}
+interface RiddleProofBasicGameplayRouteAssessment {
+    name?: string;
+    path?: string;
+    ok: boolean;
+    failures: BasicGameplayFailureCode[];
+    warnings: BasicGameplayWarningCode[];
+    signals: {
+        route_loaded: boolean;
+        surface_visible: boolean;
+        action_attempted: boolean;
+        timed_progression_observed: boolean;
+        first_interaction_observed: boolean;
+        state_change_observed: boolean;
+        mobile_overflow_absent: boolean;
+        reset_path_present: boolean;
+        fatal_errors_absent: boolean;
+    };
+    diffs: {
+        timed: BasicGameplayChangeSummary;
+        after_action: BasicGameplayChangeSummary;
+    };
+}
+interface RiddleProofBasicGameplayAssessment {
+    version: typeof RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION;
+    evidence_present: boolean;
+    passed: boolean;
+    checked_routes: number;
+    passing_routes: number;
+    failing_routes: Array<{
+        name?: string;
+        path?: string;
+        failures: BasicGameplayFailureCode[];
+        warnings: BasicGameplayWarningCode[];
+    }>;
+    failure_counts: Record<string, number>;
+    warning_counts: Record<string, number>;
+    route_results: RiddleProofBasicGameplayRouteAssessment[];
+}
+declare function assessBasicGameplayEvidence(evidence: unknown, options?: AssessBasicGameplayOptions): RiddleProofBasicGameplayAssessment;
+declare function assessBasicGameplayRoute(route: RiddleProofBasicGameplayRouteEvidence, options?: AssessBasicGameplayOptions): RiddleProofBasicGameplayRouteAssessment;
+declare function extractBasicGameplayEvidence(...sources: unknown[]): RiddleProofBasicGameplayEvidence | null;
+
+export { type AssessBasicGameplayOptions, type BasicGameplayActionResult, type BasicGameplayCanvasState, type BasicGameplayChangeSummary, type BasicGameplayFailureCode, type BasicGameplayMobileEvidence, type BasicGameplaySnapshot, type BasicGameplayWarningCode, RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION, type RiddleProofBasicGameplayAssessment, type RiddleProofBasicGameplayEvidence, type RiddleProofBasicGameplayRouteAssessment, type RiddleProofBasicGameplayRouteEvidence, assessBasicGameplayEvidence, assessBasicGameplayRoute, extractBasicGameplayEvidence };

package/dist/basic-gameplay.d.ts

@@ -0,0 +1,117 @@
+declare const RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION = "riddle-proof.basic-gameplay.v1";
+declare const RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION = "riddle-proof.basic-gameplay.assessment.v1";
+type BasicGameplayFailureCode = "route_http_error" | "fatal_page_error" | "route_blank_or_thin" | "no_game_surface" | "mobile_horizontal_overflow" | "primary_control_missing" | "primary_control_inert";
+type BasicGameplayWarningCode = "canvas_inert" | "some_actions_failed" | "missing_reset_path" | "critical_console_error";
+interface BasicGameplayCanvasState {
+    index?: number;
+    width?: number;
+    height?: number;
+    css_width?: number;
+    css_height?: number;
+    visible?: boolean;
+    readable?: boolean;
+    hash?: string | null;
+}
+interface BasicGameplaySnapshot {
+    screenshot_hash?: string | null;
+    body_text_hash?: string | null;
+    body_text_length?: number;
+    visible_large_node_count?: number;
+    enabled_clickable_count?: number;
+    reset_control_count?: number;
+    visible_canvas_count?: number;
+    canvases?: BasicGameplayCanvasState[];
+    [key: string]: unknown;
+}
+interface BasicGameplayActionResult {
+    ok?: boolean;
+    action?: string;
+    [key: string]: unknown;
+}
+interface BasicGameplayMobileEvidence {
+    overflow_px?: number;
+    [key: string]: unknown;
+}
+interface RiddleProofBasicGameplayRouteEvidence {
+    name?: string;
+    path?: string;
+    http_status?: number | null;
+    response_status?: number | null;
+    status?: number | null;
+    console_error_count?: number;
+    page_error_count?: number;
+    initial?: BasicGameplaySnapshot;
+    timed?: BasicGameplaySnapshot;
+    after_action?: BasicGameplaySnapshot;
+    afterAction?: BasicGameplaySnapshot;
+    mobile?: BasicGameplayMobileEvidence;
+    action_results?: BasicGameplayActionResult[];
+    actionResults?: BasicGameplayActionResult[];
+    requires_reset?: boolean;
+    [key: string]: unknown;
+}
+interface RiddleProofBasicGameplayEvidence {
+    version?: typeof RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION | string;
+    site?: string | null;
+    base_url?: string;
+    results?: RiddleProofBasicGameplayRouteEvidence[];
+    [key: string]: unknown;
+}
+interface AssessBasicGameplayOptions {
+    maxMobileOverflowPx?: number;
+    minBodyTextLength?: number;
+    minVisibleLargeNodes?: number;
+    minSurfaceLargeNodes?: number;
+    warnOnMissingResetPath?: boolean;
+    warnOnConsoleError?: boolean;
+    failOnConsoleError?: boolean;
+}
+interface BasicGameplayChangeSummary {
+    body_text_changed: boolean;
+    screenshot_changed: boolean;
+    canvas_changed: boolean;
+    changed: boolean;
+}
+interface RiddleProofBasicGameplayRouteAssessment {
+    name?: string;
+    path?: string;
+    ok: boolean;
+    failures: BasicGameplayFailureCode[];
+    warnings: BasicGameplayWarningCode[];
+    signals: {
+        route_loaded: boolean;
+        surface_visible: boolean;
+        action_attempted: boolean;
+        timed_progression_observed: boolean;
+        first_interaction_observed: boolean;
+        state_change_observed: boolean;
+        mobile_overflow_absent: boolean;
+        reset_path_present: boolean;
+        fatal_errors_absent: boolean;
+    };
+    diffs: {
+        timed: BasicGameplayChangeSummary;
+        after_action: BasicGameplayChangeSummary;
+    };
+}
+interface RiddleProofBasicGameplayAssessment {
+    version: typeof RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION;
+    evidence_present: boolean;
+    passed: boolean;
+    checked_routes: number;
+    passing_routes: number;
+    failing_routes: Array<{
+        name?: string;
+        path?: string;
+        failures: BasicGameplayFailureCode[];
+        warnings: BasicGameplayWarningCode[];
+    }>;
+    failure_counts: Record<string, number>;
+    warning_counts: Record<string, number>;
+    route_results: RiddleProofBasicGameplayRouteAssessment[];
+}
+declare function assessBasicGameplayEvidence(evidence: unknown, options?: AssessBasicGameplayOptions): RiddleProofBasicGameplayAssessment;
+declare function assessBasicGameplayRoute(route: RiddleProofBasicGameplayRouteEvidence, options?: AssessBasicGameplayOptions): RiddleProofBasicGameplayRouteAssessment;
+declare function extractBasicGameplayEvidence(...sources: unknown[]): RiddleProofBasicGameplayEvidence | null;
+
+export { type AssessBasicGameplayOptions, type BasicGameplayActionResult, type BasicGameplayCanvasState, type BasicGameplayChangeSummary, type BasicGameplayFailureCode, type BasicGameplayMobileEvidence, type BasicGameplaySnapshot, type BasicGameplayWarningCode, RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION, type RiddleProofBasicGameplayAssessment, type RiddleProofBasicGameplayEvidence, type RiddleProofBasicGameplayRouteAssessment, type RiddleProofBasicGameplayRouteEvidence, assessBasicGameplayEvidence, assessBasicGameplayRoute, extractBasicGameplayEvidence };

package/dist/basic-gameplay.js

@@ -0,0 +1,14 @@
+import {
+  RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION,
+  RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION,
+  assessBasicGameplayEvidence,
+  assessBasicGameplayRoute,
+  extractBasicGameplayEvidence
+} from "./chunk-RNGJX62B.js";
+export {
+  RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION,
+  RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION,
+  assessBasicGameplayEvidence,
+  assessBasicGameplayRoute,
+  extractBasicGameplayEvidence
+};

package/dist/checkpoint.cjs

@@ -499,8 +499,8 @@ function buildProofAssessmentCheckpointPacket(input) {
   const artifactContract = recordValue(proofAssessmentRequest.artifact_contract) || recordValue(bundle?.artifact_contract);
   const requiredSignals = recordValue(recordValue(artifactContract)?.required);
   const visualDelta = visualDeltaFromState(fullState);
-  const verificationMode = nonEmptyString(input.request.verification_mode) || nonEmptyString(fullState.verification_mode) || nonEmptyString(bundle?.verification_mode) || "proof";
-  const visualDeltaRequired = requiredSignals?.visual_delta === true || verificationModeRequiresVisualDelta(verificationMode);
+  const verificationMode = nonEmptyString(bundle?.verification_mode) || nonEmptyString(fullState.verification_mode) || nonEmptyString(input.request.verification_mode) || "proof";
+  const visualDeltaRequired = requiredSignals?.visual_delta !== false && (requiredSignals?.visual_delta === true || verificationModeRequiresVisualDelta(verificationMode));
   const evidenceIssueCode = visualDeltaIssueCode(visualDelta, visualDeltaRequired);
   const summary = nonEmptyString(input.engineResult.summary) || nonEmptyString(fullState.verify_summary) || "Verify captured evidence and needs a supervising proof assessment.";
   const recoveryHint = evidenceIssueCode ? "Required visual_delta evidence is incomplete. Keep this same run in verify/evidence recovery with decision=revise_capture and continue_with_stage=verify unless the evidence proves an implementation or recon problem." : "Assess whether the current artifacts prove the requested change, then choose the next stage.";

package/dist/checkpoint.js

@@ -13,7 +13,7 @@ import {
   normalizeCheckpointResponse,
   proofContractFromAuthorCheckpointResponse,
   statePathsForRunState
-} from "./chunk-T5RHGGQ2.js";
+} from "./chunk-33XO42CY.js";
 import "./chunk-DUFDZJOF.js";
 export {
   RIDDLE_PROOF_CHECKPOINT_PACKET_VERSION,

package/dist/{chunk-KYGWIA7A.js → chunk-2FBF2UDZ.js}

@@ -1,8 +1,3 @@
-import {
-  visualDeltaForState,
-  visualDeltaRequiredForState,
-  visualDeltaShipGateReason
-} from "./chunk-4ASMX4R6.js";
 import {
   appendRunEvent,
   appendStageHeartbeat,
@@ -10,10 +5,15 @@ import {
   createRunStatusSnapshot,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-PVUZZ2P6.js";
+} from "./chunk-MO24D3PY.js";
+import {
+  visualDeltaForState,
+  visualDeltaRequiredForState,
+  visualDeltaShipGateReason
+} from "./chunk-RFJ5BQF6.js";
 import {
   createRiddleProofRunCard
-} from "./chunk-53UPEUVU.js";
+} from "./chunk-3UHWI3FO.js";
 import {
   authorPacketPayloadFromCheckpointResponse,
   buildCheckpointPacketForEngineResult,
@@ -23,7 +23,7 @@ import {
   normalizeCheckpointResponse,
   proofContractFromAuthorCheckpointResponse,
   statePathsForRunState
-} from "./chunk-T5RHGGQ2.js";
+} from "./chunk-33XO42CY.js";
 import {
   applyTerminalMetadata,
   compactRecord,

package/dist/{chunk-T5RHGGQ2.js → chunk-33XO42CY.js}

@@ -445,8 +445,8 @@ function buildProofAssessmentCheckpointPacket(input) {
   const artifactContract = recordValue(proofAssessmentRequest.artifact_contract) || recordValue(bundle?.artifact_contract);
   const requiredSignals = recordValue(recordValue(artifactContract)?.required);
   const visualDelta = visualDeltaFromState(fullState);
-  const verificationMode = nonEmptyString(input.request.verification_mode) || nonEmptyString(fullState.verification_mode) || nonEmptyString(bundle?.verification_mode) || "proof";
-  const visualDeltaRequired = requiredSignals?.visual_delta === true || verificationModeRequiresVisualDelta(verificationMode);
+  const verificationMode = nonEmptyString(bundle?.verification_mode) || nonEmptyString(fullState.verification_mode) || nonEmptyString(input.request.verification_mode) || "proof";
+  const visualDeltaRequired = requiredSignals?.visual_delta !== false && (requiredSignals?.visual_delta === true || verificationModeRequiresVisualDelta(verificationMode));
   const evidenceIssueCode = visualDeltaIssueCode(visualDelta, visualDeltaRequired);
   const summary = nonEmptyString(input.engineResult.summary) || nonEmptyString(fullState.verify_summary) || "Verify captured evidence and needs a supervising proof assessment.";
   const recoveryHint = evidenceIssueCode ? "Required visual_delta evidence is incomplete. Keep this same run in verify/evidence recovery with decision=revise_capture and continue_with_stage=verify unless the evidence proves an implementation or recon problem." : "Assess whether the current artifacts prove the requested change, then choose the next stage.";

package/dist/{chunk-53UPEUVU.js → chunk-3UHWI3FO.js}

@@ -1,6 +1,6 @@
 import {
   statePathsForRunState
-} from "./chunk-T5RHGGQ2.js";
+} from "./chunk-33XO42CY.js";
 import {
   compactRecord,
   isTerminalStatus,

package/dist/{chunk-PVUZZ2P6.js → chunk-MO24D3PY.js}

@@ -1,6 +1,6 @@
 import {
   createRiddleProofRunCard
-} from "./chunk-53UPEUVU.js";
+} from "./chunk-3UHWI3FO.js";
 import {
   compactRecord,
   isTerminalStatus,
@@ -108,6 +108,7 @@ function normalizeRunParams(input) {
     leave_draft: input.leave_draft,
     engine_state_path: input.engine_state_path,
     harness_state_path: input.harness_state_path,
+    riddle_engine_module_url: input.riddle_engine_module_url,
     max_iterations: input.max_iterations,
     auto_approve: input.auto_approve,
     dry_run: input.dry_run,

package/dist/{chunk-4ASMX4R6.js → chunk-RFJ5BQF6.js}

@@ -355,6 +355,7 @@ function visualDeltaRequiredForState(state = {}) {
   const bundle = objectValue(state?.evidence_bundle);
   const contract = objectValue(bundle.artifact_contract);
   const required = objectValue(contract.required);
+  if (required.visual_delta === false) return false;
   return required.visual_delta === true || VISUAL_FIRST_MODES.has(normalizedVerificationMode(state));
 }
 function visualDeltaForState(state = {}) {