@riddledc/riddle-proof 0.6.0 → 0.7.1

package/dist/profile.d.cts

@@ -0,0 +1,175 @@
+import { JsonValue } from './types.cjs';
+
+declare const RIDDLE_PROOF_PROFILE_VERSION: "riddle-proof.profile.v1";
+declare const RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION: "riddle-proof.profile-evidence.v1";
+declare const RIDDLE_PROOF_PROFILE_RESULT_VERSION: "riddle-proof.profile-result.v1";
+declare const RIDDLE_PROOF_PROFILE_STATUSES: readonly ["passed", "product_regression", "proof_insufficient", "environment_blocked", "configuration_error", "needs_human_review"];
+declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "selector_visible", "selector_count_at_least", "text_visible", "text_absent", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors"];
+type RiddleProofProfileStatus = typeof RIDDLE_PROOF_PROFILE_STATUSES[number];
+type RiddleProofProfileCheckType = typeof RIDDLE_PROOF_PROFILE_CHECK_TYPES[number];
+type RiddleProofProfileRunner = "riddle" | "local-playwright" | "browserless" | "github-actions" | (string & {});
+type RiddleProofProfileFailureAction = "fail" | "neutral" | "review";
+type RiddleProofProfileBaselinePolicy = "invariant_only" | "production_comparison" | "last_accepted_artifact" | "golden_reference_artifact" | (string & {});
+interface RiddleProofProfileViewport {
+    name: string;
+    width: number;
+    height: number;
+}
+interface RiddleProofProfileTarget {
+    url?: string;
+    route?: string;
+    viewports: RiddleProofProfileViewport[];
+    auth?: "none" | (string & {});
+    wait_for_selector?: string;
+    wait_ms?: number;
+}
+interface RiddleProofProfileCheck {
+    type: RiddleProofProfileCheckType;
+    label?: string;
+    expected_path?: string;
+    selector?: string;
+    text?: string;
+    pattern?: string;
+    flags?: string;
+    min_count?: number;
+    max_overflow_px?: number;
+}
+interface RiddleProofProfile {
+    version: typeof RIDDLE_PROOF_PROFILE_VERSION;
+    name: string;
+    target: RiddleProofProfileTarget;
+    checks: RiddleProofProfileCheck[];
+    artifacts: string[];
+    baseline_policy: RiddleProofProfileBaselinePolicy;
+    failure_policy: Partial<Record<RiddleProofProfileStatus, RiddleProofProfileFailureAction>>;
+    metadata?: Record<string, JsonValue>;
+}
+interface RiddleProofProfileRouteEvidence {
+    requested: string;
+    observed: string;
+    expected_path?: string;
+    matched: boolean;
+    http_status?: number | null;
+    error?: string;
+}
+interface RiddleProofProfileViewportEvidence {
+    name: string;
+    width: number;
+    height: number;
+    url?: string;
+    route: RiddleProofProfileRouteEvidence;
+    title?: string;
+    body_text_length?: number;
+    body_text_sample?: string;
+    scroll_width?: number;
+    client_width?: number;
+    overflow_px?: number;
+    selectors?: Record<string, {
+        count: number;
+        visible_count: number;
+    }>;
+    text_matches?: Record<string, boolean>;
+    screenshot_label?: string;
+    navigation_error?: string;
+    wait_error?: string;
+}
+interface RiddleProofProfileEvidence {
+    version: typeof RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION;
+    profile_name: string;
+    target_url: string;
+    baseline_policy: RiddleProofProfileBaselinePolicy;
+    captured_at: string;
+    viewports: RiddleProofProfileViewportEvidence[];
+    console: {
+        events: Array<{
+            type: string;
+            text: string;
+            location?: JsonValue;
+        }>;
+        fatal_count: number;
+    };
+    page_errors: Array<{
+        message: string;
+    }>;
+    dom_summary?: Record<string, JsonValue>;
+}
+interface RiddleProofProfileCheckResult {
+    type: RiddleProofProfileCheckType | (string & {});
+    label?: string;
+    status: "passed" | "failed" | "skipped" | "needs_human_review";
+    evidence: Record<string, JsonValue>;
+    message?: string;
+}
+interface RiddleProofProfileResult {
+    version: typeof RIDDLE_PROOF_PROFILE_RESULT_VERSION;
+    profile_name: string;
+    runner: RiddleProofProfileRunner;
+    status: RiddleProofProfileStatus;
+    baseline_policy: RiddleProofProfileBaselinePolicy;
+    route: RiddleProofProfileRouteEvidence;
+    artifacts: {
+        screenshots: string[];
+        console?: string;
+        proof_json?: string;
+        dom_summary?: string;
+        riddle_artifacts?: RiddleProofProfileArtifactRef[];
+    };
+    checks: RiddleProofProfileCheckResult[];
+    summary: string;
+    captured_at: string;
+    evidence?: RiddleProofProfileEvidence;
+    riddle?: {
+        job_id?: string;
+        status?: string | null;
+        terminal?: boolean;
+    };
+    error?: string;
+}
+interface RiddleProofProfileArtifactRef {
+    name: string;
+    url?: string;
+    path?: string;
+    kind?: string;
+    content_type?: string;
+    source?: string;
+}
+interface NormalizeRiddleProofProfileOptions {
+    url?: string;
+    route?: string;
+    viewports?: RiddleProofProfileViewport[];
+}
+declare function slugifyRiddleProofProfileName(value: string): string;
+declare function normalizeRiddleProofProfile(input: unknown, options?: NormalizeRiddleProofProfileOptions): RiddleProofProfile;
+declare function resolveRiddleProofProfileTargetUrl(profile: RiddleProofProfile): string;
+declare function assessRiddleProofProfileEvidence(profile: RiddleProofProfile, evidence: RiddleProofProfileEvidence | undefined, options?: {
+    runner?: RiddleProofProfileRunner;
+    riddle?: RiddleProofProfileResult["riddle"];
+    artifacts?: RiddleProofProfileArtifactRef[];
+}): RiddleProofProfileResult;
+declare function summarizeRiddleProofProfileResult(input: {
+    profile_name: string;
+    status: RiddleProofProfileStatus;
+    checks: RiddleProofProfileCheckResult[];
+    viewports: RiddleProofProfileViewportEvidence[];
+}): string;
+declare function profileStatusExitCode(profile: RiddleProofProfile, status: RiddleProofProfileStatus): 0 | 1;
+declare function createRiddleProofProfileConfigurationError(name: string, error: unknown, runner?: RiddleProofProfileRunner): RiddleProofProfileResult;
+declare function createRiddleProofProfileEnvironmentBlockedResult(input: {
+    profile: RiddleProofProfile;
+    runner?: RiddleProofProfileRunner;
+    error?: unknown;
+    riddle?: RiddleProofProfileResult["riddle"];
+    artifacts?: RiddleProofProfileArtifactRef[];
+}): RiddleProofProfileResult;
+declare function createRiddleProofProfileInsufficientResult(input: {
+    profile: RiddleProofProfile;
+    runner?: RiddleProofProfileRunner;
+    error?: unknown;
+    riddle?: RiddleProofProfileResult["riddle"];
+    artifacts?: RiddleProofProfileArtifactRef[];
+}): RiddleProofProfileResult;
+declare function buildRiddleProofProfileScript(profile: RiddleProofProfile): string;
+declare function collectRiddleProfileArtifactRefs(input: unknown): RiddleProofProfileArtifactRef[];
+declare function extractRiddleProofProfileResult(input: unknown): RiddleProofProfileResult | undefined;
+
+export { type NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, type RiddleProofProfile, type RiddleProofProfileArtifactRef, type RiddleProofProfileBaselinePolicy, type RiddleProofProfileCheck, type RiddleProofProfileCheckResult, type RiddleProofProfileCheckType, type RiddleProofProfileEvidence, type RiddleProofProfileFailureAction, type RiddleProofProfileResult, type RiddleProofProfileRouteEvidence, type RiddleProofProfileRunner, type RiddleProofProfileStatus, type RiddleProofProfileTarget, type RiddleProofProfileViewport, type RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileTargetUrl, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult };

package/dist/profile.d.ts

@@ -0,0 +1,175 @@
+import { JsonValue } from './types.js';
+
+declare const RIDDLE_PROOF_PROFILE_VERSION: "riddle-proof.profile.v1";
+declare const RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION: "riddle-proof.profile-evidence.v1";
+declare const RIDDLE_PROOF_PROFILE_RESULT_VERSION: "riddle-proof.profile-result.v1";
+declare const RIDDLE_PROOF_PROFILE_STATUSES: readonly ["passed", "product_regression", "proof_insufficient", "environment_blocked", "configuration_error", "needs_human_review"];
+declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "selector_visible", "selector_count_at_least", "text_visible", "text_absent", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors"];
+type RiddleProofProfileStatus = typeof RIDDLE_PROOF_PROFILE_STATUSES[number];
+type RiddleProofProfileCheckType = typeof RIDDLE_PROOF_PROFILE_CHECK_TYPES[number];
+type RiddleProofProfileRunner = "riddle" | "local-playwright" | "browserless" | "github-actions" | (string & {});
+type RiddleProofProfileFailureAction = "fail" | "neutral" | "review";
+type RiddleProofProfileBaselinePolicy = "invariant_only" | "production_comparison" | "last_accepted_artifact" | "golden_reference_artifact" | (string & {});
+interface RiddleProofProfileViewport {
+    name: string;
+    width: number;
+    height: number;
+}
+interface RiddleProofProfileTarget {
+    url?: string;
+    route?: string;
+    viewports: RiddleProofProfileViewport[];
+    auth?: "none" | (string & {});
+    wait_for_selector?: string;
+    wait_ms?: number;
+}
+interface RiddleProofProfileCheck {
+    type: RiddleProofProfileCheckType;
+    label?: string;
+    expected_path?: string;
+    selector?: string;
+    text?: string;
+    pattern?: string;
+    flags?: string;
+    min_count?: number;
+    max_overflow_px?: number;
+}
+interface RiddleProofProfile {
+    version: typeof RIDDLE_PROOF_PROFILE_VERSION;
+    name: string;
+    target: RiddleProofProfileTarget;
+    checks: RiddleProofProfileCheck[];
+    artifacts: string[];
+    baseline_policy: RiddleProofProfileBaselinePolicy;
+    failure_policy: Partial<Record<RiddleProofProfileStatus, RiddleProofProfileFailureAction>>;
+    metadata?: Record<string, JsonValue>;
+}
+interface RiddleProofProfileRouteEvidence {
+    requested: string;
+    observed: string;
+    expected_path?: string;
+    matched: boolean;
+    http_status?: number | null;
+    error?: string;
+}
+interface RiddleProofProfileViewportEvidence {
+    name: string;
+    width: number;
+    height: number;
+    url?: string;
+    route: RiddleProofProfileRouteEvidence;
+    title?: string;
+    body_text_length?: number;
+    body_text_sample?: string;
+    scroll_width?: number;
+    client_width?: number;
+    overflow_px?: number;
+    selectors?: Record<string, {
+        count: number;
+        visible_count: number;
+    }>;
+    text_matches?: Record<string, boolean>;
+    screenshot_label?: string;
+    navigation_error?: string;
+    wait_error?: string;
+}
+interface RiddleProofProfileEvidence {
+    version: typeof RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION;
+    profile_name: string;
+    target_url: string;
+    baseline_policy: RiddleProofProfileBaselinePolicy;
+    captured_at: string;
+    viewports: RiddleProofProfileViewportEvidence[];
+    console: {
+        events: Array<{
+            type: string;
+            text: string;
+            location?: JsonValue;
+        }>;
+        fatal_count: number;
+    };
+    page_errors: Array<{
+        message: string;
+    }>;
+    dom_summary?: Record<string, JsonValue>;
+}
+interface RiddleProofProfileCheckResult {
+    type: RiddleProofProfileCheckType | (string & {});
+    label?: string;
+    status: "passed" | "failed" | "skipped" | "needs_human_review";
+    evidence: Record<string, JsonValue>;
+    message?: string;
+}
+interface RiddleProofProfileResult {
+    version: typeof RIDDLE_PROOF_PROFILE_RESULT_VERSION;
+    profile_name: string;
+    runner: RiddleProofProfileRunner;
+    status: RiddleProofProfileStatus;
+    baseline_policy: RiddleProofProfileBaselinePolicy;
+    route: RiddleProofProfileRouteEvidence;
+    artifacts: {
+        screenshots: string[];
+        console?: string;
+        proof_json?: string;
+        dom_summary?: string;
+        riddle_artifacts?: RiddleProofProfileArtifactRef[];
+    };
+    checks: RiddleProofProfileCheckResult[];
+    summary: string;
+    captured_at: string;
+    evidence?: RiddleProofProfileEvidence;
+    riddle?: {
+        job_id?: string;
+        status?: string | null;
+        terminal?: boolean;
+    };
+    error?: string;
+}
+interface RiddleProofProfileArtifactRef {
+    name: string;
+    url?: string;
+    path?: string;
+    kind?: string;
+    content_type?: string;
+    source?: string;
+}
+interface NormalizeRiddleProofProfileOptions {
+    url?: string;
+    route?: string;
+    viewports?: RiddleProofProfileViewport[];
+}
+declare function slugifyRiddleProofProfileName(value: string): string;
+declare function normalizeRiddleProofProfile(input: unknown, options?: NormalizeRiddleProofProfileOptions): RiddleProofProfile;
+declare function resolveRiddleProofProfileTargetUrl(profile: RiddleProofProfile): string;
+declare function assessRiddleProofProfileEvidence(profile: RiddleProofProfile, evidence: RiddleProofProfileEvidence | undefined, options?: {
+    runner?: RiddleProofProfileRunner;
+    riddle?: RiddleProofProfileResult["riddle"];
+    artifacts?: RiddleProofProfileArtifactRef[];
+}): RiddleProofProfileResult;
+declare function summarizeRiddleProofProfileResult(input: {
+    profile_name: string;
+    status: RiddleProofProfileStatus;
+    checks: RiddleProofProfileCheckResult[];
+    viewports: RiddleProofProfileViewportEvidence[];
+}): string;
+declare function profileStatusExitCode(profile: RiddleProofProfile, status: RiddleProofProfileStatus): 0 | 1;
+declare function createRiddleProofProfileConfigurationError(name: string, error: unknown, runner?: RiddleProofProfileRunner): RiddleProofProfileResult;
+declare function createRiddleProofProfileEnvironmentBlockedResult(input: {
+    profile: RiddleProofProfile;
+    runner?: RiddleProofProfileRunner;
+    error?: unknown;
+    riddle?: RiddleProofProfileResult["riddle"];
+    artifacts?: RiddleProofProfileArtifactRef[];
+}): RiddleProofProfileResult;
+declare function createRiddleProofProfileInsufficientResult(input: {
+    profile: RiddleProofProfile;
+    runner?: RiddleProofProfileRunner;
+    error?: unknown;
+    riddle?: RiddleProofProfileResult["riddle"];
+    artifacts?: RiddleProofProfileArtifactRef[];
+}): RiddleProofProfileResult;
+declare function buildRiddleProofProfileScript(profile: RiddleProofProfile): string;
+declare function collectRiddleProfileArtifactRefs(input: unknown): RiddleProofProfileArtifactRef[];
+declare function extractRiddleProofProfileResult(input: unknown): RiddleProofProfileResult | undefined;
+
+export { type NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, type RiddleProofProfile, type RiddleProofProfileArtifactRef, type RiddleProofProfileBaselinePolicy, type RiddleProofProfileCheck, type RiddleProofProfileCheckResult, type RiddleProofProfileCheckType, type RiddleProofProfileEvidence, type RiddleProofProfileFailureAction, type RiddleProofProfileResult, type RiddleProofProfileRouteEvidence, type RiddleProofProfileRunner, type RiddleProofProfileStatus, type RiddleProofProfileTarget, type RiddleProofProfileViewport, type RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileTargetUrl, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult };

package/dist/profile.js

@@ -0,0 +1,38 @@
+import {
+  RIDDLE_PROOF_PROFILE_CHECK_TYPES,
+  RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,
+  RIDDLE_PROOF_PROFILE_RESULT_VERSION,
+  RIDDLE_PROOF_PROFILE_STATUSES,
+  RIDDLE_PROOF_PROFILE_VERSION,
+  assessRiddleProofProfileEvidence,
+  buildRiddleProofProfileScript,
+  collectRiddleProfileArtifactRefs,
+  createRiddleProofProfileConfigurationError,
+  createRiddleProofProfileEnvironmentBlockedResult,
+  createRiddleProofProfileInsufficientResult,
+  extractRiddleProofProfileResult,
+  normalizeRiddleProofProfile,
+  profileStatusExitCode,
+  resolveRiddleProofProfileTargetUrl,
+  slugifyRiddleProofProfileName,
+  summarizeRiddleProofProfileResult
+} from "./chunk-7NMAU4DP.js";
+export {
+  RIDDLE_PROOF_PROFILE_CHECK_TYPES,
+  RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,
+  RIDDLE_PROOF_PROFILE_RESULT_VERSION,
+  RIDDLE_PROOF_PROFILE_STATUSES,
+  RIDDLE_PROOF_PROFILE_VERSION,
+  assessRiddleProofProfileEvidence,
+  buildRiddleProofProfileScript,
+  collectRiddleProfileArtifactRefs,
+  createRiddleProofProfileConfigurationError,
+  createRiddleProofProfileEnvironmentBlockedResult,
+  createRiddleProofProfileInsufficientResult,
+  extractRiddleProofProfileResult,
+  normalizeRiddleProofProfile,
+  profileStatusExitCode,
+  resolveRiddleProofProfileTargetUrl,
+  slugifyRiddleProofProfileName,
+  summarizeRiddleProofProfileResult
+};

package/dist/proof-run-core.cjs

@@ -42,6 +42,8 @@ __export(proof_run_core_exports, {
   ensureStageLoopState: () => ensureStageLoopState,
   invalidateVerifyEvidence: () => invalidateVerifyEvidence,
   mergeStateFromParams: () => mergeStateFromParams,
+  noImplementationModeFor: () => noImplementationModeFor,
+  previewModeFromWorkflowMode: () => previewModeFromWorkflowMode,
   readState: () => readState,
   recordStageAttempt: () => recordStageAttempt,
   requiredBaselineLabelsForState: () => requiredBaselineLabelsForState,
@@ -63,6 +65,25 @@ var import_node_path = __toESM(require("path"), 1);
 var import_node_url = require("url");
 var import_meta = {};
 var WORKFLOW_STAGE_ORDER = ["setup", "recon", "author", "implement", "verify", "ship"];
+function normalizedMode(value) {
+  return typeof value === "string" ? value.trim().toLowerCase() : "";
+}
+function previewModeFromWorkflowMode(value) {
+  const mode = normalizedMode(value);
+  return mode === "server" || mode === "static" ? mode : void 0;
+}
+function noImplementationModeInput(value) {
+  return value && typeof value === "object" ? value : {};
+}
+function noImplementationModeFor(params, state) {
+  const input = noImplementationModeInput(params);
+  const stateInput = noImplementationModeInput(state);
+  const mode = normalizedMode(input.mode ?? input.workflow_mode ?? stateInput.mode ?? stateInput.workflow_mode);
+  const implementationMode = normalizedMode(input.implementation_mode ?? stateInput.implementation_mode);
+  const requireDiff = input.require_diff ?? stateInput.require_diff;
+  const allowCodeChanges = input.allow_code_changes ?? stateInput.allow_code_changes;
+  return mode === "audit" || mode === "profile" || implementationMode === "none" || requireDiff === false || allowCodeChanges === false;
+}
 var CHECKPOINT_CONTRACT_VERSION = "riddle-proof-run.checkpoint.v1";
 function currentDistDir() {
   const meta = typeof import_meta === "object" ? import_meta : {};
@@ -155,7 +176,7 @@ function buildSetupArgs(params, config) {
     allow_static_preview_fallback: params.allow_static_preview_fallback ? "true" : "",
     context: params.context || "",
     reviewer: params.reviewer || config.defaultReviewer,
-    mode: params.mode || "",
+    mode: previewModeFromWorkflowMode(params.mode) || "",
     build_command: params.build_command || "npm run build",
     build_output: params.build_output || "build",
     server_image: params.server_image || "node:20-slim",
@@ -758,7 +779,8 @@ function mergeStateFromParams(statePath, params) {
     "auth_cookies_json",
     "auth_headers_json",
     "proof_plan",
-    "implementation_notes"
+    "implementation_notes",
+    "implementation_mode"
   ];
   for (const field of stringFields) {
     if (params[field] !== void 0) {
@@ -773,7 +795,17 @@ function mergeStateFromParams(statePath, params) {
     if (issues.length) state.implementation_environment_issues = issues;
   }
   if (params.reference !== void 0) state.reference = params.reference;
-  if (params.mode !== void 0) state.mode = params.mode;
+  if (params.mode !== void 0) {
+    const previewMode = previewModeFromWorkflowMode(params.mode);
+    if (previewMode) {
+      state.mode = previewMode;
+    } else {
+      state.workflow_mode = normalizeOptionalString(params.mode);
+    }
+  }
+  if (params.implementation_mode !== void 0) state.implementation_mode = normalizeOptionalString(params.implementation_mode);
+  if (params.require_diff !== void 0) state.require_diff = params.require_diff;
+  if (params.allow_code_changes !== void 0) state.allow_code_changes = params.allow_code_changes;
   if (params.allow_static_preview_fallback !== void 0) {
     state.allow_static_preview_fallback = params.allow_static_preview_fallback;
   }
@@ -918,6 +950,11 @@ function summarizeState(state) {
     repo: state.repo || null,
     branch: state.branch || null,
     mode: state.mode || null,
+    workflow_mode: state.workflow_mode || null,
+    implementation_mode: state.implementation_mode || null,
+    require_diff: state.require_diff ?? null,
+    allow_code_changes: state.allow_code_changes ?? null,
+    no_implementation_mode: noImplementationModeFor(state),
     reference: state.reference || null,
     before_ref: state.before_ref || null,
     allow_static_preview_fallback: Boolean(state.allow_static_preview_fallback),
@@ -1015,6 +1052,8 @@ function summarizeState(state) {
   ensureStageLoopState,
   invalidateVerifyEvidence,
   mergeStateFromParams,
+  noImplementationModeFor,
+  previewModeFromWorkflowMode,
   readState,
   recordStageAttempt,
   requiredBaselineLabelsForState,

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

@@ -26,7 +26,10 @@ interface WorkflowParams {
     allow_static_preview_fallback?: boolean;
     context?: string;
     reviewer?: string;
-    mode?: "server" | "static";
+    mode?: "server" | "static" | "audit" | (string & {});
+    implementation_mode?: "change" | "none" | (string & {});
+    require_diff?: boolean;
+    allow_code_changes?: boolean;
     build_command?: string;
     build_output?: string;
     server_image?: string;
@@ -58,6 +61,8 @@ interface WorkflowParams {
     update_base_checkout?: boolean;
     advance_stage?: WorkflowStage;
 }
+declare function previewModeFromWorkflowMode(value: unknown): "server" | "static" | undefined;
+declare function noImplementationModeFor(params?: unknown, state?: unknown): boolean;
 interface PluginConfig {
     riddleProofDir?: string;
     statePath?: string;
@@ -115,7 +120,7 @@ declare function buildSetupArgs(params: WorkflowParams, config: ReturnType<typeo
     target_image_hash: string;
     viewport_matrix_json: string;
     deterministic_setup_json: string;
-    reference: "before" | "prod" | "both";
+    reference: "prod" | "before" | "both";
     base_branch: string;
     before_ref: string;
     allow_static_preview_fallback: string;
@@ -238,6 +243,11 @@ declare function summarizeState(state: any): {
         repo: any;
         branch: any;
         mode: any;
+        workflow_mode: any;
+        implementation_mode: any;
+        require_diff: any;
+        allow_code_changes: any;
+        no_implementation_mode: boolean;
         reference: any;
         before_ref: any;
         allow_static_preview_fallback: boolean;
@@ -306,4 +316,4 @@ declare function summarizeState(state: any): {
     };
 };
 
-export { BUNDLED_RIDDLE_PROOF_DIR, CHECKPOINT_CONTRACT_VERSION, type CheckpointInputContract, type PluginConfig, RIDDLE_PROOF_DIR_CANDIDATES, type ShipGateValidation, WORKFLOW_STAGE_ORDER, type WorkflowAction, type WorkflowParams, type WorkflowStage, buildCheckpointContract, buildSetupArgs, checkpointContinueStage, clearStageDecisionRequest, ensureAction, ensureStageLoopState, invalidateVerifyEvidence, mergeStateFromParams, readState, recordStageAttempt, requiredBaselineLabelsForState, resolveConfig, resolveRiddleProofDir, setStageDecisionRequest, summarizeState, validateShipGate, visualDeltaForState, visualDeltaRequiredForState, visualDeltaShipGateReason, workflowFile, writeState };
+export { BUNDLED_RIDDLE_PROOF_DIR, CHECKPOINT_CONTRACT_VERSION, type CheckpointInputContract, type PluginConfig, RIDDLE_PROOF_DIR_CANDIDATES, type ShipGateValidation, WORKFLOW_STAGE_ORDER, type WorkflowAction, type WorkflowParams, type WorkflowStage, buildCheckpointContract, buildSetupArgs, checkpointContinueStage, clearStageDecisionRequest, ensureAction, ensureStageLoopState, invalidateVerifyEvidence, mergeStateFromParams, noImplementationModeFor, previewModeFromWorkflowMode, readState, recordStageAttempt, requiredBaselineLabelsForState, resolveConfig, resolveRiddleProofDir, setStageDecisionRequest, summarizeState, validateShipGate, visualDeltaForState, visualDeltaRequiredForState, visualDeltaShipGateReason, workflowFile, writeState };

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

@@ -26,7 +26,10 @@ interface WorkflowParams {
     allow_static_preview_fallback?: boolean;
     context?: string;
     reviewer?: string;
-    mode?: "server" | "static";
+    mode?: "server" | "static" | "audit" | (string & {});
+    implementation_mode?: "change" | "none" | (string & {});
+    require_diff?: boolean;
+    allow_code_changes?: boolean;
     build_command?: string;
     build_output?: string;
     server_image?: string;
@@ -58,6 +61,8 @@ interface WorkflowParams {
     update_base_checkout?: boolean;
     advance_stage?: WorkflowStage;
 }
+declare function previewModeFromWorkflowMode(value: unknown): "server" | "static" | undefined;
+declare function noImplementationModeFor(params?: unknown, state?: unknown): boolean;
 interface PluginConfig {
     riddleProofDir?: string;
     statePath?: string;
@@ -115,7 +120,7 @@ declare function buildSetupArgs(params: WorkflowParams, config: ReturnType<typeo
     target_image_hash: string;
     viewport_matrix_json: string;
     deterministic_setup_json: string;
-    reference: "before" | "prod" | "both";
+    reference: "prod" | "before" | "both";
     base_branch: string;
     before_ref: string;
     allow_static_preview_fallback: string;
@@ -238,6 +243,11 @@ declare function summarizeState(state: any): {
         repo: any;
         branch: any;
         mode: any;
+        workflow_mode: any;
+        implementation_mode: any;
+        require_diff: any;
+        allow_code_changes: any;
+        no_implementation_mode: boolean;
         reference: any;
         before_ref: any;
         allow_static_preview_fallback: boolean;
@@ -306,4 +316,4 @@ declare function summarizeState(state: any): {
     };
 };
 
-export { BUNDLED_RIDDLE_PROOF_DIR, CHECKPOINT_CONTRACT_VERSION, type CheckpointInputContract, type PluginConfig, RIDDLE_PROOF_DIR_CANDIDATES, type ShipGateValidation, WORKFLOW_STAGE_ORDER, type WorkflowAction, type WorkflowParams, type WorkflowStage, buildCheckpointContract, buildSetupArgs, checkpointContinueStage, clearStageDecisionRequest, ensureAction, ensureStageLoopState, invalidateVerifyEvidence, mergeStateFromParams, readState, recordStageAttempt, requiredBaselineLabelsForState, resolveConfig, resolveRiddleProofDir, setStageDecisionRequest, summarizeState, validateShipGate, visualDeltaForState, visualDeltaRequiredForState, visualDeltaShipGateReason, workflowFile, writeState };
+export { BUNDLED_RIDDLE_PROOF_DIR, CHECKPOINT_CONTRACT_VERSION, type CheckpointInputContract, type PluginConfig, RIDDLE_PROOF_DIR_CANDIDATES, type ShipGateValidation, WORKFLOW_STAGE_ORDER, type WorkflowAction, type WorkflowParams, type WorkflowStage, buildCheckpointContract, buildSetupArgs, checkpointContinueStage, clearStageDecisionRequest, ensureAction, ensureStageLoopState, invalidateVerifyEvidence, mergeStateFromParams, noImplementationModeFor, previewModeFromWorkflowMode, readState, recordStageAttempt, requiredBaselineLabelsForState, resolveConfig, resolveRiddleProofDir, setStageDecisionRequest, summarizeState, validateShipGate, visualDeltaForState, visualDeltaRequiredForState, visualDeltaShipGateReason, workflowFile, writeState };

package/dist/proof-run-core.js

@@ -11,6 +11,8 @@ import {
   ensureStageLoopState,
   invalidateVerifyEvidence,
   mergeStateFromParams,
+  noImplementationModeFor,
+  previewModeFromWorkflowMode,
   readState,
   recordStageAttempt,
   requiredBaselineLabelsForState,
@@ -24,7 +26,7 @@ import {
   visualDeltaShipGateReason,
   workflowFile,
   writeState
-} from "./chunk-RFJ5BQF6.js";
+} from "./chunk-FPD2RF3Q.js";
 export {
   BUNDLED_RIDDLE_PROOF_DIR,
   CHECKPOINT_CONTRACT_VERSION,
@@ -38,6 +40,8 @@ export {
   ensureStageLoopState,
   invalidateVerifyEvidence,
   mergeStateFromParams,
+  noImplementationModeFor,
+  previewModeFromWorkflowMode,
   readState,
   recordStageAttempt,
   requiredBaselineLabelsForState,