@riddledc/riddle-proof 0.5.15 → 0.5.16

package/package.json

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

package/runtime/lib/util.py

@@ -566,6 +566,41 @@ def git(cmd, cwd):
     return sp.run(cmd, shell=True, cwd=cwd, capture_output=True, text=True)
 
 
+def run_project_build(project_dir, build_cmd, timeout=600, clean_cache_dir='.next'):
+    """Build once with existing cache, then retry clean if the cached build fails."""
+    attempts = []
+    for clean_first in (False, True):
+        if clean_first and clean_cache_dir:
+            cache_path = os.path.join(project_dir, clean_cache_dir)
+            if os.path.exists(cache_path):
+                sp.run(
+                    'rm -rf ' + shell_quote(clean_cache_dir),
+                    shell=True,
+                    cwd=project_dir,
+                    capture_output=True,
+                    text=True,
+                )
+        result = sp.run(build_cmd, shell=True, cwd=project_dir, capture_output=True, text=True, timeout=timeout)
+        attempts.append({
+            'clean_first': clean_first,
+            'returncode': int(result.returncode),
+            'stderr': (result.stderr or '')[:500],
+        })
+        if result.returncode == 0:
+            return {
+                'result': result,
+                'clean_retry_used': clean_first,
+                'attempts': attempts,
+            }
+        if not clean_cache_dir or clean_first:
+            break
+    return {
+        'result': result,
+        'clean_retry_used': False,
+        'attempts': attempts,
+    }
+
+
 def load_package_json(project_dir):
     package_json = os.path.join(project_dir, 'package.json')
     if not os.path.exists(package_json):

package/runtime/lib/verify.py

@@ -20,6 +20,7 @@ from util import (
     load_state,
     prepare_server_preview,
     record_successful_capture_hint,
+    run_project_build,
     save_state,
     should_use_static_preview,
     summarize_capture_artifacts,
@@ -1028,14 +1029,17 @@ if existing_prod:
 
 # AFTER (always from after worktree)
 record_verify_phase('build', 'running', 'Building after worktree for verify capture.')
-print('Cleaning after .next cache...')
-sp.run('rm -rf .next', shell=True, cwd=after_dir, capture_output=True)
-
 print('Building after worktree...')
-br = sp.run(build_cmd, shell=True, cwd=after_dir, capture_output=True, text=True, timeout=600)
+build_attempt = run_project_build(after_dir, build_cmd, timeout=600, clean_cache_dir='.next')
+br = build_attempt.get('result')
+if build_attempt.get('clean_retry_used'):
+    print('Verify build recovered after cleaning .next cache.')
 if br.returncode != 0:
     record_verify_phase('build', 'failed', 'After build failed: ' + br.stderr[:300])
     raise SystemExit('After build failed: ' + br.stderr[:500])
+if build_attempt.get('attempts'):
+    s['verify_build_attempts'] = build_attempt['attempts']
+    s['verify_build_clean_retry_used'] = bool(build_attempt.get('clean_retry_used'))
 record_verify_phase('build', 'completed', 'After worktree build completed.')
 
 after_payload = {}

package/runtime/tests/recon_verify_smoke.py

@@ -508,6 +508,38 @@ def base_state(tempdir: Path, *, reference='before', prod_url=''):
     }
 
 
+def run_project_build_retries_after_clean_failure():
+    tempdir = Path(tempfile.mkdtemp(prefix='riddle-proof-build-retry-'))
+    cache_dir = tempdir / '.next'
+    cache_dir.mkdir(parents=True, exist_ok=True)
+    util = load_module('util_build_retry', UTIL_PATH)
+    original_run = util.sp.run
+    calls = []
+
+    def fake_run(cmd, *args, **kwargs):
+        calls.append(cmd)
+        if cmd == 'npm run build':
+            build_attempts = calls.count('npm run build')
+            if build_attempts == 1:
+                return sp.CompletedProcess(cmd, 1, '', 'stale cache')
+            return sp.CompletedProcess(cmd, 0, 'ok', '')
+        if cmd == 'rm -rf .next':
+            shutil.rmtree(cache_dir, ignore_errors=True)
+            return sp.CompletedProcess(cmd, 0, '', '')
+        raise AssertionError(f'unexpected command: {cmd}')
+
+    try:
+        util.sp.run = fake_run
+        result = util.run_project_build(str(tempdir), 'npm run build', timeout=30, clean_cache_dir='.next')
+        assert result['clean_retry_used'] is True
+        assert result['result'].returncode == 0
+        assert calls == ['npm run build', 'rm -rf .next', 'npm run build']
+        assert not cache_dir.exists()
+    finally:
+        util.sp.run = original_run
+        shutil.rmtree(tempdir)
+
+
 def run_recon_then_author_request():
     tempdir = Path(tempfile.mkdtemp(prefix='riddle-proof-supervisor-request-'))
     state_path = tempdir / 'state.json'
@@ -1257,6 +1289,7 @@ if __name__ == '__main__':
         'capture_artifact_enrichment': run_capture_artifact_enrichment(),
         'capture_diagnostics_redaction': run_capture_diagnostics_redact_sensitive_values(),
         'apply_auth_context': run_apply_auth_context_passes_supported_auth_payloads(),
+        'run_project_build_retries_after_clean_failure': run_project_build_retries_after_clean_failure(),
         'verify_quality_ignores_proof_telemetry_console_text': run_verify_quality_ignores_proof_telemetry_console_text(),
         'recon_then_author_request': run_recon_then_author_request(),
         'recon_route_literal_preference': run_recon_prefers_route_literals_over_import_paths(),