@riddledc/riddle-proof 0.5.25 → 0.5.27

package/package.json

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

package/runtime/lib/util.py

@@ -112,8 +112,12 @@ def select_capture_hint(state):
             if str(item).strip()
         ]
         matched_tokens = [token for token in current_tokens if token in hint_tokens]
+        mode_matches = bool(current_mode and hint_mode == current_mode)
+        root_hint = server_path == '/'
+        if not matched_tokens and mode_matches and not root_hint:
+            continue
         score = len(matched_tokens) * 3
-        if current_mode and hint_mode == current_mode:
+        if mode_matches:
             score += 2
         if score <= 0:
             continue

package/runtime/lib/verify.py

@@ -375,6 +375,7 @@ def extract_page_state(payload):
 
 
 def extract_proof_evidence(payload):
+    payload = enrich_capture_payload(payload)
     evidence = []
     for text in iter_console_messages(payload.get('console') or []):
         raw_evidence = proof_evidence_console_payload(text)

package/runtime/tests/recon_verify_smoke.py

@@ -154,11 +154,19 @@ class FakeRiddle:
                     'ok': True,
                     'outputs': [{'name': 'proof.json', 'url': 'https://cdn.example.com/proof.json'}],
                     'result': {'pageState': page_state},
-                    'console': [
-                        'RIDDLE_PROOF_STATE:' + json.dumps(page_state),
-                        'RIDDLE_PROOF_EVIDENCE:' + json.dumps(proof_evidence),
-                    ],
                     '_artifact_json': {
+                        'console.json': {
+                            'summary': {'total_entries': 3, 'log_count': 2, 'warn_count': 0, 'error_count': 1, 'info_count': 0},
+                            'entries': {
+                                'log': [
+                                    {'message': 'RIDDLE_PROOF_STATE:' + json.dumps(page_state)},
+                                    {'message': 'RIDDLE_PROOF_EVIDENCE:' + json.dumps(proof_evidence)},
+                                ],
+                                'warn': [],
+                                'error': [{'message': 'Uncaught exception: intentional capture script failure after evidence'}],
+                                'info': [],
+                            },
+                        },
                         'proof.json': {
                             'script_error': 'Error: intentional capture script failure after evidence',
                         },
@@ -949,6 +957,73 @@ def run_recon_prefers_hint_root_over_single_route_literal():
         shutil.rmtree(tempdir, ignore_errors=True)
 
 
+def run_capture_hint_rejects_route_specific_mode_only_match():
+    tempdir = Path(tempfile.mkdtemp(prefix='riddle-proof-hint-selection-'))
+    try:
+        util = load_module('util_hint_selection', UTIL_PATH)
+        repo_key = str(tempdir / 'repo')
+        state = {
+            'repo': repo_key,
+            'verification_mode': 'text',
+            'change_request': 'Change the Tic Tac Toe reset button label to Reset Board.',
+            'success_criteria': 'The Tic Tac Toe page shows Reset Board on /games/tic-tac-toe.',
+        }
+        _, cache_path = util.load_capture_hint_cache(state)
+        cache_file = Path(cache_path)
+        cache_file.parent.mkdir(parents=True, exist_ok=True)
+        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': ['sequencer', 'monkberry', 'drum'],
+                    'server_path': '/games/drum-sequencer',
+                    'wait_for_selector': '.drum-sequencer h1',
+                    'observed_path': '/games/drum-sequencer',
+                }
+            ],
+        }))
+
+        selected = util.select_capture_hint(state)
+        applied = util.apply_capture_hint(state)
+
+        assert selected is None, selected
+        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': ['homepage', 'hero'],
+                    'server_path': '/',
+                    'wait_for_selector': '',
+                    'observed_path': '/',
+                }
+            ],
+        }))
+
+        root_state = {
+            'repo': repo_key,
+            'verification_mode': 'text',
+            'change_request': 'Make a tiny harmless copy tweak.',
+            'success_criteria': 'The changed copy is visible.',
+        }
+        root_applied = util.apply_capture_hint(root_state)
+        assert root_applied is not None, root_applied
+        assert root_state['server_path'] == '/', root_state
+        assert root_state['server_path_source'] == 'hint_cache', root_state
+
+        return {'ok': True, 'route_specific_selected': selected, 'root_server_path': root_state['server_path']}
+    finally:
+        if 'cache_file' in locals():
+            cache_file.unlink(missing_ok=True)
+        shutil.rmtree(tempdir, ignore_errors=True)
+
+
 def run_author_applies_supervisor_packet():
     tempdir = Path(tempfile.mkdtemp(prefix='riddle-proof-supervisor-apply-'))
     state_path = tempdir / 'state.json'
@@ -1309,6 +1384,8 @@ def run_verify_preserves_proof_evidence_on_capture_script_error():
         assert supporting['has_structured_payload'] is True
         assert supporting['proof_evidence_present'] is True
         assert 'Captured structured audio evidence before the capture script threw' in supporting['proof_evidence_sample']
+        assert after_verify['evidence_bundle']['proof_evidence'] is not None
+        assert after_verify['evidence_bundle']['proof_evidence']['proof_evidence_present'] is False
         capture_quality = after_verify['verify_decision_request']['capture_quality']
         assert capture_quality['decision'] == 'failed_proof_evidence'
         assert capture_quality['recommended_stage'] == 'author'
@@ -1638,6 +1715,7 @@ if __name__ == '__main__':
         'recon_preserves_query_route': run_recon_preserves_query_route(),
         'recon_route_literal_preference': run_recon_prefers_route_literals_over_import_paths(),
         'recon_hint_root_preference': run_recon_prefers_hint_root_over_single_route_literal(),
+        'capture_hint_rejects_route_specific_mode_only_match': run_capture_hint_rejects_route_specific_mode_only_match(),
         'author_applies_supervisor_packet': run_author_applies_supervisor_packet(),
         'verify_requests_supervisor_assessment': run_verify_requests_supervisor_assessment(),
         'verify_structured_evidence_without_screenshot': run_verify_structured_evidence_without_screenshot(),