CLAUDE: test_pose_corr_jna - the tol-0 verdict binary (NVRTC production...

CLAUDE: test_pose_corr_jna - the tol-0 verdict binary (NVRTC production module); direct test = stepping companion

RUNG 1 VALIDATED on the first real v013 case (scene 1773135467_917220,
4 LMA iterations, 150 tiles/set, 300 corr tiles/iter): test_pose_corr_jna
PASS BIT-EXACT @tol 0 - tasks (calculate_tiles_offsets) and raw TD
correlation (correlate2D_inter) both max|diff|=0, every iteration.

The offline-nvcc direct-launch binary (src/tests/test_pose_corr) cannot be
bit-exact vs the NVRTC JIT (FMA/codegen divergence), measured: -G -O0 ->
tasks off by 2^-13 px; RELEASE=1 -> tasks BIT-EXACT, corr within ~1 ULP at
operand scale (max|diff| 128..256 vs amplitudes ~2e9, float spacing 256).
Role split documented in both headers (same pairing as test_avg_td_oob /
test_proc_consolidate): direct binary for cuda-gdb stepping, _jna binary
for the production-equivalence verdict. Build line in the _jna header.
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>

src/tests/test_pose_corr.cu

@@ -33,6 +33,18 @@
  * in calculate_tiles_offsets / correlate2D_inter_inner and step in
  * NSight/cuda-gdb.
  *
+ * ROLE (measured 07/13/2026 on the first real case): this DIRECT-LAUNCH binary
+ * is the DEBUG/STEPPING companion; the TOL-0 verdict binary is
+ * jna/test_pose_corr_jna (same replay through the NVRTC-compiled production
+ * module - PASSed bit-exact). An offline nvcc build cannot be bit-exact vs the
+ * NVRTC JIT (FMA/codegen divergence): default -G -O0 build -> tasks off by
+ * ~2^-13 px (ULP of px-scale values) and corr off ~ULP-cascade; RELEASE=1
+ * build -> tasks BIT-EXACT, corr within ~1 ULP at operand scale (max|diff|
+ * 128..256 vs amplitudes ~2e9, spacing 256). Same two-tier situation as
+ * test_convert_direct's goldens. So: expect PASS here only with a nonzero
+ * --tol (~1 ULP at scale) or against goldens blessed from THIS binary;
+ * use test_pose_corr_jna for the production-equivalence check.
+ *
  * Usage: test_pose_corr --data <dir> [--tol X] [--list]
  *
  *  Created on: Jul 13, 2026