@riddledc/riddle-proof 0.7.182 → 0.7.184

package/dist/index.cjs

@@ -9346,7 +9346,7 @@ function profileSetupTapReceipts(results) {
     reason: result.reason ?? result.error ?? null
   }));
 }
-function profileSetupPressReceipts(results) {
+function profileSetupKeyboardReceipts(results) {
   return results.filter((result) => ["press", "key_down", "key_up"].includes(profileSetupResultAction(result))).map((result) => ({
     action: profileSetupResultAction(result),
     ordinal: result.ordinal ?? null,
@@ -9521,8 +9521,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
       const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const tapReceipts = profileSetupTapReceipts(results);
       const sampledTapReceipts = sampleProfileSetupSummaryItems(tapReceipts, 8);
-      const pressReceipts = profileSetupPressReceipts(results);
-      const sampledPressReceipts = sampleProfileSetupSummaryItems(pressReceipts, 8);
+      const keyboardReceipts = profileSetupKeyboardReceipts(results);
+      const sampledKeyboardReceipts = sampleProfileSetupSummaryItems(keyboardReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
@@ -9590,9 +9590,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         tap_total: tapReceipts.length,
         tap_truncated: tapReceipts.length > sampledTapReceipts.length,
         tap: sampledTapReceipts,
-        press_total: pressReceipts.length,
-        press_truncated: pressReceipts.length > sampledPressReceipts.length,
-        press: sampledPressReceipts,
+        keyboard_total: keyboardReceipts.length,
+        keyboard_truncated: keyboardReceipts.length > sampledKeyboardReceipts.length,
+        keyboard: sampledKeyboardReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -12193,6 +12193,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
@@ -12254,6 +12255,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,
@@ -12330,6 +12332,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
@@ -13230,7 +13233,7 @@ function profileSetupTapReceipts(results) {
       reason: result.reason || result.error || null,
     }));
 }
-function profileSetupPressReceipts(results) {
+function profileSetupKeyboardReceipts(results) {
   return (results || [])
     .filter((result) => result && ["press", "key_down", "key_up"].includes(profileSetupResultAction(result)))
     .map((result) => ({
@@ -13432,8 +13435,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
       const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const tapReceipts = profileSetupTapReceipts(results);
       const sampledTapReceipts = sampleProfileSetupSummaryItems(tapReceipts, 8);
-      const pressReceipts = profileSetupPressReceipts(results);
-      const sampledPressReceipts = sampleProfileSetupSummaryItems(pressReceipts, 8);
+      const keyboardReceipts = profileSetupKeyboardReceipts(results);
+      const sampledKeyboardReceipts = sampleProfileSetupSummaryItems(keyboardReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results
@@ -13511,9 +13514,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         tap_total: tapReceipts.length,
         tap_truncated: tapReceipts.length > sampledTapReceipts.length,
         tap: sampledTapReceipts,
-        press_total: pressReceipts.length,
-        press_truncated: pressReceipts.length > sampledPressReceipts.length,
-        press: sampledPressReceipts,
+        keyboard_total: keyboardReceipts.length,
+        keyboard_truncated: keyboardReceipts.length > sampledKeyboardReceipts.length,
+        keyboard: sampledKeyboardReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -14256,6 +14259,7 @@ function assessProfile(profile, evidence) {
     checks,
     summary,
     captured_at: evidence.captured_at,
+    metadata: profile.metadata,
     warnings: profileWarnings.length ? profileWarnings : undefined,
     evidence,
   };

package/dist/index.js

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

package/dist/profile.cjs

@@ -660,7 +660,7 @@ function profileSetupTapReceipts(results) {
     reason: result.reason ?? result.error ?? null
   }));
 }
-function profileSetupPressReceipts(results) {
+function profileSetupKeyboardReceipts(results) {
   return results.filter((result) => ["press", "key_down", "key_up"].includes(profileSetupResultAction(result))).map((result) => ({
     action: profileSetupResultAction(result),
     ordinal: result.ordinal ?? null,
@@ -835,8 +835,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
       const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const tapReceipts = profileSetupTapReceipts(results);
       const sampledTapReceipts = sampleProfileSetupSummaryItems(tapReceipts, 8);
-      const pressReceipts = profileSetupPressReceipts(results);
-      const sampledPressReceipts = sampleProfileSetupSummaryItems(pressReceipts, 8);
+      const keyboardReceipts = profileSetupKeyboardReceipts(results);
+      const sampledKeyboardReceipts = sampleProfileSetupSummaryItems(keyboardReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
@@ -904,9 +904,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         tap_total: tapReceipts.length,
         tap_truncated: tapReceipts.length > sampledTapReceipts.length,
         tap: sampledTapReceipts,
-        press_total: pressReceipts.length,
-        press_truncated: pressReceipts.length > sampledPressReceipts.length,
-        press: sampledPressReceipts,
+        keyboard_total: keyboardReceipts.length,
+        keyboard_truncated: keyboardReceipts.length > sampledKeyboardReceipts.length,
+        keyboard: sampledKeyboardReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -3507,6 +3507,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 +3569,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 +3646,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
@@ -4544,7 +4547,7 @@ function profileSetupTapReceipts(results) {
       reason: result.reason || result.error || null,
     }));
 }
-function profileSetupPressReceipts(results) {
+function profileSetupKeyboardReceipts(results) {
   return (results || [])
     .filter((result) => result && ["press", "key_down", "key_up"].includes(profileSetupResultAction(result)))
     .map((result) => ({
@@ -4746,8 +4749,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
       const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const tapReceipts = profileSetupTapReceipts(results);
       const sampledTapReceipts = sampleProfileSetupSummaryItems(tapReceipts, 8);
-      const pressReceipts = profileSetupPressReceipts(results);
-      const sampledPressReceipts = sampleProfileSetupSummaryItems(pressReceipts, 8);
+      const keyboardReceipts = profileSetupKeyboardReceipts(results);
+      const sampledKeyboardReceipts = sampleProfileSetupSummaryItems(keyboardReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results
@@ -4825,9 +4828,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         tap_total: tapReceipts.length,
         tap_truncated: tapReceipts.length > sampledTapReceipts.length,
         tap: sampledTapReceipts,
-        press_total: pressReceipts.length,
-        press_truncated: pressReceipts.length > sampledPressReceipts.length,
-        press: sampledPressReceipts,
+        keyboard_total: keyboardReceipts.length,
+        keyboard_truncated: keyboardReceipts.length > sampledKeyboardReceipts.length,
+        keyboard: sampledKeyboardReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -5570,6 +5573,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-XL7Q4M6D.js";
+} from "./chunk-5MBIRRA7.js";
 export {
   RIDDLE_PROOF_PROFILE_CHECK_TYPES,
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,

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.182",
+  "version": "0.7.184",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",