@riddledc/riddle-proof 0.5.29 → 0.5.31

package/dist/{chunk-TV3XY7PG.js → chunk-R4BPJNAM.js}

@@ -69,7 +69,6 @@ function buildSetupArgs(params, config) {
   const commitMessage = (params.commit_message || params.change_request || "").trim();
   const captureScript = (params.capture_script || "").trim();
   const requestedReference = params.reference || (params.prod_url ? "both" : "before");
-  const reference = !params.prod_url && requestedReference !== "before" ? "before" : requestedReference;
   if (!commitMessage) throw new Error("commit_message is required for setup/run");
   return {
     repo: params.repo,
@@ -81,7 +80,7 @@ function buildSetupArgs(params, config) {
     success_criteria: params.success_criteria || "",
     assertions_json: params.assertions_json || "",
     verification_mode: params.verification_mode || "proof",
-    reference,
+    reference: requestedReference,
     base_branch: params.base_branch || "main",
     before_ref: params.before_ref || "",
     allow_static_preview_fallback: params.allow_static_preview_fallback ? "true" : "",

package/dist/engine-harness.cjs

@@ -87,7 +87,6 @@ function buildSetupArgs(params, config) {
   const commitMessage = (params.commit_message || params.change_request || "").trim();
   const captureScript = (params.capture_script || "").trim();
   const requestedReference = params.reference || (params.prod_url ? "both" : "before");
-  const reference = !params.prod_url && requestedReference !== "before" ? "before" : requestedReference;
   if (!commitMessage) throw new Error("commit_message is required for setup/run");
   return {
     repo: params.repo,
@@ -99,7 +98,7 @@ function buildSetupArgs(params, config) {
     success_criteria: params.success_criteria || "",
     assertions_json: params.assertions_json || "",
     verification_mode: params.verification_mode || "proof",
-    reference,
+    reference: requestedReference,
     base_branch: params.base_branch || "main",
     before_ref: params.before_ref || "",
     allow_static_preview_fallback: params.allow_static_preview_fallback ? "true" : "",

package/dist/engine-harness.js

@@ -2,7 +2,7 @@ import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
   runRiddleProofEngineHarness
-} from "./chunk-46355FJD.js";
+} from "./chunk-A3H7GU7H.js";
 import "./chunk-7ZJAUEUN.js";
 import "./chunk-TMMKRKY5.js";
 export {

package/dist/index.cjs

@@ -87,7 +87,6 @@ function buildSetupArgs(params, config) {
   const commitMessage = (params.commit_message || params.change_request || "").trim();
   const captureScript = (params.capture_script || "").trim();
   const requestedReference = params.reference || (params.prod_url ? "both" : "before");
-  const reference = !params.prod_url && requestedReference !== "before" ? "before" : requestedReference;
   if (!commitMessage) throw new Error("commit_message is required for setup/run");
   return {
     repo: params.repo,
@@ -99,7 +98,7 @@ function buildSetupArgs(params, config) {
     success_criteria: params.success_criteria || "",
     assertions_json: params.assertions_json || "",
     verification_mode: params.verification_mode || "proof",
-    reference,
+    reference: requestedReference,
     base_branch: params.base_branch || "main",
     before_ref: params.before_ref || "",
     allow_static_preview_fallback: params.allow_static_preview_fallback ? "true" : "",

package/dist/index.js

@@ -13,7 +13,7 @@ import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
   runRiddleProofEngineHarness
-} from "./chunk-46355FJD.js";
+} from "./chunk-A3H7GU7H.js";
 import {
   runRiddleProof
 } from "./chunk-F6VFKS7K.js";

package/dist/proof-run-core.cjs

@@ -125,7 +125,6 @@ function buildSetupArgs(params, config) {
   const commitMessage = (params.commit_message || params.change_request || "").trim();
   const captureScript = (params.capture_script || "").trim();
   const requestedReference = params.reference || (params.prod_url ? "both" : "before");
-  const reference = !params.prod_url && requestedReference !== "before" ? "before" : requestedReference;
   if (!commitMessage) throw new Error("commit_message is required for setup/run");
   return {
     repo: params.repo,
@@ -137,7 +136,7 @@ function buildSetupArgs(params, config) {
     success_criteria: params.success_criteria || "",
     assertions_json: params.assertions_json || "",
     verification_mode: params.verification_mode || "proof",
-    reference,
+    reference: requestedReference,
     base_branch: params.base_branch || "main",
     before_ref: params.before_ref || "",
     allow_static_preview_fallback: params.allow_static_preview_fallback ? "true" : "",

package/dist/proof-run-core.js

@@ -21,7 +21,7 @@ import {
   validateShipGate,
   workflowFile,
   writeState
-} from "./chunk-TV3XY7PG.js";
+} from "./chunk-R4BPJNAM.js";
 export {
   BUNDLED_RIDDLE_PROOF_DIR,
   CHECKPOINT_CONTRACT_VERSION,

package/dist/proof-run-engine.cjs

@@ -110,7 +110,6 @@ function buildSetupArgs(params, config) {
   const commitMessage = (params.commit_message || params.change_request || "").trim();
   const captureScript = (params.capture_script || "").trim();
   const requestedReference = params.reference || (params.prod_url ? "both" : "before");
-  const reference = !params.prod_url && requestedReference !== "before" ? "before" : requestedReference;
   if (!commitMessage) throw new Error("commit_message is required for setup/run");
   return {
     repo: params.repo,
@@ -122,7 +121,7 @@ function buildSetupArgs(params, config) {
     success_criteria: params.success_criteria || "",
     assertions_json: params.assertions_json || "",
     verification_mode: params.verification_mode || "proof",
-    reference,
+    reference: requestedReference,
     base_branch: params.base_branch || "main",
     before_ref: params.before_ref || "",
     allow_static_preview_fallback: params.allow_static_preview_fallback ? "true" : "",

package/dist/proof-run-engine.js

@@ -14,7 +14,7 @@ import {
   validateShipGate,
   workflowFile,
   writeState
-} from "./chunk-TV3XY7PG.js";
+} from "./chunk-R4BPJNAM.js";
 
 // src/proof-run-engine.ts
 import { execFileSync } from "child_process";

package/package.json

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

package/runtime/lib/util.py

@@ -67,6 +67,47 @@ def request_shape_tokens(state, limit=8):
     return tokens
 
 
+def normalize_browser_path(value):
+    value = str(value or '').strip()
+    if not value.startswith('/'):
+        return ''
+    value = value.split('#', 1)[0].split('?', 1)[0]
+    value = value.rstrip('.,;:)]}')
+    if not value.startswith('/'):
+        return ''
+    value = re.sub(r'/+', '/', value)
+    if len(value) > 1:
+        value = value.rstrip('/')
+    return value.lower() or '/'
+
+
+def extract_browser_paths(text):
+    paths = []
+    for match in re.findall(r'/(?:[A-Za-z0-9._~%!$&\'()*+,;=:@-]+/?)+(?:\?[A-Za-z0-9._~%!$&\'()*+,;=:@/?-]*)?', str(text or '')):
+        normalized = normalize_browser_path(match)
+        if normalized and normalized not in paths:
+            paths.append(normalized)
+    return paths
+
+
+def explicit_request_paths(state):
+    source_groups = [
+        [state.get('server_path'), state.get('expected_path'), state.get('target_path')],
+        [state.get('change_request')],
+        [state.get('context')],
+        [state.get('success_criteria')],
+    ]
+    for group in source_groups:
+        paths = []
+        for value in group:
+            for path in extract_browser_paths(value):
+                if path not in paths:
+                    paths.append(path)
+        if paths:
+            return paths
+    return []
+
+
 def capture_hint_cache_path(state):
     repo_key = str(state.get('repo') or state.get('repo_dir') or '').strip()
     if not repo_key:
@@ -96,6 +137,7 @@ def select_capture_hint(state):
     payload, cache_path = load_capture_hint_cache(state)
     hints = payload.get('hints') or []
     current_tokens = request_shape_tokens(state)
+    requested_paths = explicit_request_paths(state)
     current_mode = str(state.get('verification_mode') or '').strip().lower()
     scored = []
     for hint in hints:
@@ -105,6 +147,9 @@ def select_capture_hint(state):
         wait_for_selector = str(hint.get('wait_for_selector') or '').strip()
         if not server_path and not wait_for_selector:
             continue
+        hint_path = normalize_browser_path(server_path)
+        if requested_paths and hint_path and hint_path not in requested_paths:
+            continue
         hint_mode = str(hint.get('verification_mode') or '').strip().lower()
         hint_tokens = [
             str(item).strip().lower()

package/runtime/tests/recon_verify_smoke.py

@@ -1036,6 +1036,29 @@ def run_capture_hint_rejects_route_specific_mode_only_match():
         assert applied is None, applied
         assert 'server_path' not in state, state
 
+        cache_file.write_text(json.dumps({
+            'version': util.CAPTURE_HINT_CACHE_VERSION,
+            'hints': [
+                {
+                    'saved_at': '2026-04-25T00:00:00Z',
+                    'verification_mode': 'text',
+                    'request_tokens': ['games', 'reset', 'board'],
+                    'server_path': '/games/drum-sequencer',
+                    'wait_for_selector': '.drum-sequencer h1',
+                    'observed_path': '/games/drum-sequencer',
+                }
+            ],
+        }))
+
+        weak_token_state = dict(state)
+        weak_token_state['success_criteria'] = 'Stale profile text says Neon Step Sequencer on /games/drum-sequencer.'
+        weak_token_selected = util.select_capture_hint(weak_token_state)
+        weak_token_applied = util.apply_capture_hint(weak_token_state)
+
+        assert weak_token_selected is None, weak_token_selected
+        assert weak_token_applied is None, weak_token_applied
+        assert 'server_path' not in weak_token_state, weak_token_state
+
         cache_file.write_text(json.dumps({
             'version': util.CAPTURE_HINT_CACHE_VERSION,
             'hints': [