@riddledc/riddle-proof 0.7.183 → 0.7.185

package/dist/index.js

@@ -62,7 +62,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-X24EJSIU.js";
+} from "./chunk-Z42O55GB.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -536,8 +536,9 @@ function profileSetupWindowCallReceipts(results) {
       path: result.path ?? null,
       return_captured: result.return_captured ?? null,
       return_stored_to: result.return_stored_to ?? null,
-      reason: result.reason ?? result.error ?? result.store_reason ?? null
+      reason: result.reason ?? result.store_reason ?? null
     };
+    if (result.error !== void 0) receipt.error = result.error;
     if (result.returned !== void 0) receipt.returned = result.returned;
     if (result.expected_return !== void 0) receipt.expected_return = result.expected_return;
     const returnSummary = profileSetupReturnSummary(result);
@@ -553,8 +554,9 @@ function profileSetupWindowEvalReceipts(results) {
       script_length: result.script_length ?? null,
       return_captured: result.return_captured ?? null,
       return_stored_to: result.return_stored_to ?? null,
-      reason: result.reason ?? result.error ?? result.store_reason ?? null
+      reason: result.reason ?? result.store_reason ?? null
     };
+    if (result.error !== void 0) receipt.error = result.error;
     if (result.returned !== void 0) receipt.returned = result.returned;
     if (result.expected_return !== void 0) receipt.expected_return = result.expected_return;
     const returnSummary = profileSetupReturnSummary(result);
@@ -919,6 +921,7 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
           selector: result.selector ?? null,
           frame_selector: result.frame_selector ?? null,
           reason: result.reason ?? result.error ?? null,
+          error: result.error ?? null,
           case_insensitive_text: compactProfileSetupSummaryText(result.case_insensitive_text)
         })),
         optional_failed: optionalFailed.map((result) => ({
@@ -927,6 +930,7 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
           selector: result.selector ?? null,
           frame_selector: result.frame_selector ?? null,
           reason: result.reason ?? result.error ?? null,
+          error: result.error ?? null,
           case_insensitive_text: compactProfileSetupSummaryText(result.case_insensitive_text)
         }))
       };
@@ -3507,6 +3511,7 @@ function assessRiddleProofProfileEvidence(profile, evidence, options = {}) {
     checks,
     summary: summarizeRiddleProofProfileResult({ profile_name: profile.name, status, checks, viewports: evidence?.viewports || [] }),
     captured_at: capturedAt,
+    metadata: profile.metadata,
     warnings: warnings.length ? warnings : void 0,
     evidence,
     riddle: options.riddle
@@ -3568,6 +3573,7 @@ function createRiddleProofProfileEnvironmentBlockedResult(input) {
     checks: [],
     summary: summarizeEnvironmentBlockedRunner(input.profile.name, environmentBlocker),
     captured_at: (/* @__PURE__ */ new Date()).toISOString(),
+    metadata: input.profile.metadata,
     warnings: warnings.length ? warnings : void 0,
     riddle: input.riddle,
     environment_blocker: environmentBlocker,
@@ -3644,6 +3650,7 @@ function createRiddleProofProfileInsufficientResult(input) {
     checks: [],
     summary: `${input.profile.name} did not produce enough evidence for a profile judgment.`,
     captured_at: (/* @__PURE__ */ new Date()).toISOString(),
+    metadata: input.profile.metadata,
     warnings: warnings.length ? warnings : void 0,
     riddle: input.riddle,
     error: message
@@ -4410,8 +4417,9 @@ function profileSetupWindowCallReceipts(results) {
         path: result.path ?? null,
         return_captured: result.return_captured ?? null,
         return_stored_to: result.return_stored_to ?? null,
-        reason: result.reason || result.error || result.store_reason || null,
+        reason: result.reason || result.store_reason || null,
       };
+      if (result.error !== undefined) receipt.error = result.error;
       if (result.returned !== undefined) receipt.returned = result.returned;
       if (result.expected_return !== undefined) receipt.expected_return = result.expected_return;
       const returnSummary = profileSetupReturnSummary(result);
@@ -4429,8 +4437,9 @@ function profileSetupWindowEvalReceipts(results) {
         script_length: result.script_length ?? null,
         return_captured: result.return_captured ?? null,
         return_stored_to: result.return_stored_to ?? null,
-        reason: result.reason || result.error || result.store_reason || null,
+        reason: result.reason || result.store_reason || null,
       };
+      if (result.error !== undefined) receipt.error = result.error;
       if (result.returned !== undefined) receipt.returned = result.returned;
       if (result.expected_return !== undefined) receipt.expected_return = result.expected_return;
       const returnSummary = profileSetupReturnSummary(result);
@@ -4840,6 +4849,7 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
           selector: result.selector ?? null,
           frame_selector: result.frame_selector ?? null,
           reason: result.reason || result.error || null,
+          error: result.error || null,
           case_insensitive_text: compactProfileSetupSummaryText(result.case_insensitive_text),
         })),
         optional_failed: optionalFailed.map((result) => ({
@@ -4848,6 +4858,7 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
           selector: result.selector ?? null,
           frame_selector: result.frame_selector ?? null,
           reason: result.reason || result.error || null,
+          error: result.error || null,
           case_insensitive_text: compactProfileSetupSummaryText(result.case_insensitive_text),
         })),
       };
@@ -5570,6 +5581,7 @@ function assessProfile(profile, evidence) {
     checks,
     summary,
     captured_at: evidence.captured_at,
+    metadata: profile.metadata,
     warnings: profileWarnings.length ? profileWarnings : undefined,
     evidence,
   };

package/dist/profile.d.cts

@@ -387,6 +387,7 @@ interface RiddleProofProfileResult {
     checks: RiddleProofProfileCheckResult[];
     summary: string;
     captured_at: string;
+    metadata?: Record<string, JsonValue>;
     warnings?: string[];
     evidence?: RiddleProofProfileEvidence;
     riddle?: {

package/dist/profile.d.ts

@@ -387,6 +387,7 @@ interface RiddleProofProfileResult {
     checks: RiddleProofProfileCheckResult[];
     summary: string;
     captured_at: string;
+    metadata?: Record<string, JsonValue>;
     warnings?: string[];
     evidence?: RiddleProofProfileEvidence;
     riddle?: {

package/dist/profile.js

@@ -23,7 +23,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-X24EJSIU.js";
+} from "./chunk-Z42O55GB.js";
 export {
   RIDDLE_PROOF_PROFILE_CHECK_TYPES,
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,

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

@@ -120,7 +120,7 @@ declare function buildSetupArgs(params: WorkflowParams, config: ReturnType<typeo
     target_image_hash: string;
     viewport_matrix_json: string;
     deterministic_setup_json: string;
-    reference: "prod" | "before" | "both";
+    reference: "before" | "prod" | "both";
     base_branch: string;
     before_ref: string;
     allow_static_preview_fallback: string;

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

@@ -120,7 +120,7 @@ declare function buildSetupArgs(params: WorkflowParams, config: ReturnType<typeo
     target_image_hash: string;
     viewport_matrix_json: string;
     deterministic_setup_json: string;
-    reference: "prod" | "before" | "both";
+    reference: "before" | "prod" | "both";
     base_branch: string;
     before_ref: string;
     allow_static_preview_fallback: string;

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

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

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

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

package/examples/profiles/spa-route-exit-state-hygiene.json

@@ -0,0 +1,76 @@
+{
+  "version": "riddle-proof.profile.v1",
+  "name": "spa-route-exit-state-hygiene",
+  "target": {
+    "route": "/games/example?proof=1",
+    "viewports": [
+      { "name": "phone", "width": 390, "height": 844 },
+      { "name": "ipad-mini", "width": 768, "height": 1024 },
+      { "name": "ipad", "width": 820, "height": 1180 },
+      { "name": "desktop", "width": 1440, "height": 1000 }
+    ],
+    "timeout_sec": 300,
+    "wait_for_selector": "#game-root",
+    "screenshot_mode": "viewport",
+    "setup_actions": [
+      { "type": "clear_storage", "storage": "both", "reload": true },
+      { "type": "wait_for_selector", "selector": "#game-root", "timeout_ms": 20000 },
+      { "type": "wait_for_selector", "selector": "#game-root canvas, #game-root [data-proof-ready='true']", "timeout_ms": 20000 },
+      {
+        "type": "window_eval",
+        "label": "capture-route-active-state",
+        "timeout_ms": 10000,
+        "store_return_to": "__rpRouteExit.active",
+        "script": "const proof=window.__exampleRouteProof?.read?.()||{};const watched=['__exampleRouteProof','__exampleProofLastReceipt','exampleTouchState'];const activeGlobals=watched.filter((name)=>Object.prototype.hasOwnProperty.call(window,name)&&window[name]!==undefined);const out={ready:proof.ready===true,route:location.pathname,activeGlobals,activeGlobalCount:activeGlobals.length,receiptId:String(proof.receiptId||''),mode:String(proof.mode||'')};out.ok=out.ready===true&&out.activeGlobalCount>0;window.__rpRouteExit={...(window.__rpRouteExit||{}),active:out};return out;",
+        "return_summary_fields": [
+          { "path": "ok" },
+          { "path": "ready" },
+          { "path": "route" },
+          { "path": "activeGlobalCount" },
+          { "path": "activeGlobals" }
+        ]
+      },
+      { "type": "assert_window_value", "path": "__rpRouteExit.active.ok", "expected_value": true, "timeout_ms": 10000 },
+      { "type": "screenshot", "label": "route-active-state", "mode": "viewport" },
+      { "type": "click", "selector": "[data-testid='nav-home'], .nav-logo, a[href='/']", "timeout_ms": 10000 },
+      { "type": "wait_for_selector", "selector": "[data-testid='home-page'], main, [data-route='home']", "timeout_ms": 20000 },
+      {
+        "type": "window_eval",
+        "label": "capture-route-exit-cleanup",
+        "timeout_ms": 10000,
+        "store_return_to": "__rpRouteExit.cleanup",
+        "script": "const watched=['__exampleRouteProof','__exampleProofLastReceipt','exampleTouchState'];const staleNames=watched.filter((name)=>Object.prototype.hasOwnProperty.call(window,name)&&window[name]!==undefined);const out={ok:location.pathname==='/'&&staleNames.length===0,route:location.pathname,staleNames,staleCount:staleNames.length};window.__rpRouteExit={...(window.__rpRouteExit||{}),cleanup:out};return out;",
+        "return_summary_fields": [
+          { "path": "ok" },
+          { "path": "route" },
+          { "path": "staleCount" },
+          { "path": "staleNames" }
+        ]
+      },
+      { "type": "assert_window_value", "path": "__rpRouteExit.cleanup.ok", "expected_value": true, "timeout_ms": 10000 },
+      { "type": "assert_window_number", "path": "__rpRouteExit.cleanup.staleCount", "expected_value": 0, "timeout_ms": 10000 },
+      { "type": "screenshot", "label": "home-after-route-exit-cleanup", "mode": "viewport" }
+    ]
+  },
+  "checks": [
+    { "type": "route_loaded", "expected_path": "/" },
+    { "type": "selector_visible", "selector": "[data-testid='home-page'], main, [data-route='home']" },
+    { "type": "text_absent", "pattern": "\\bNaN\\b" },
+    { "type": "text_absent", "pattern": "undefined", "flags": "i" },
+    { "type": "text_absent", "pattern": "\\[object Object\\]" },
+    { "type": "no_horizontal_overflow", "max_overflow_px": 1 },
+    { "type": "no_mobile_horizontal_overflow", "max_overflow_px": 1 },
+    { "type": "no_fatal_console_errors" },
+    { "type": "no_console_warnings" }
+  ],
+  "artifacts": ["screenshot", "console", "dom_summary", "proof_json"],
+  "baseline_policy": "invariant_only",
+  "failure_policy": {
+    "environment_blocked": "neutral",
+    "proof_insufficient": "fail",
+    "product_regression": "fail"
+  },
+  "metadata": {
+    "purpose": "Template for SPA route-exit hygiene profiles. Replace the example route, selectors, and watched globals with route-local proof helpers, receipts, timers, input state, or touch state that must exist while the feature route is active and must be removed after visible UI navigation returns home."
+  }
+}

package/package.json

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