qvm: original geometry numeric audit

docs/ASSET_PIPELINE_TODO.md

@@ -763,3 +763,6 @@ Research progress: RE-697 [report](research/MD3_ORIGINAL_HIERARCHY.md); remainin
 
 
 Research progress: RE-698 [report](research/MD3_ORIGINAL_MODEL_HIT.md); remaining native/content/runtime/platform scope stays open.
+
+
+Research progress: RE-699 [report](research/MD3_GEOMETRY_AUDIT.md); remaining native/content/runtime/platform scope stays open.

docs/FINDINGS.md

@@ -1109,3 +1109,6 @@ Bounded qagame paths recover bomb-plant/inactivity correction requests, direct f
 
 
 **RE-698 — Complete pose-driven model hits on original MD3 hierarchies:** Complete144766 now uses original Athena/Orion lower/upper/head/helmet buffers, actual tag attachment, pose, geometry and sorting to publish source-derived hits/misses. [Evidence](research/MD3_ORIGINAL_MODEL_HIT.md).
+
+
+**RE-699 — Original-asset numerical geometry comparison audit:** Original-asset runs retain measurable source-point differences from conventional ray points and localized fourth-row differences; native/reference validation remains necessary. [Evidence](research/MD3_GEOMETRY_AUDIT.md).

docs/PROVISIONAL_TODO.md

@@ -1095,3 +1095,6 @@ Research progress: RE-697 [report](research/MD3_ORIGINAL_HIERARCHY.md); remainin
 
 
 Research progress: RE-698 [report](research/MD3_ORIGINAL_MODEL_HIT.md); remaining native/content/runtime/platform scope stays open.
+
+
+Research progress: RE-699 [report](research/MD3_GEOMETRY_AUDIT.md); remaining native/content/runtime/platform scope stays open.

docs/RESEARCH_LEDGER.md

@@ -1137,3 +1137,8 @@ Actual21770 attaches original tag_torso/tag_head chains and25341 processes all f
 ## 2026-10-21 — RE-698 Complete pose-driven model hits on original MD3 hierarchies (separate task commit)
 
 Complete144766 now uses original Athena/Orion lower/upper/head/helmet buffers, actual tag attachment, pose, geometry and sorting to publish source-derived hits/misses. Six full compositions independently check complete pose, every original leaf context, final sorted context/trace words, both selector bindings and frame0/22. Full suite: 1247 tests pass. Report regenerates byte-identically (1675425 bytes). Storage/filter, links and whitespace checks pass. No assets/Rust runtime/shared VM evaluator changed; native/reference/legal/full platform scope remains open.
+
+
+## 2026-10-21 — RE-699 Original-asset numerical geometry comparison audit (separate task commit)
+
+Original-asset runs retain measurable source-point differences from conventional ray points and localized fourth-row differences; native/reference validation remains necessary. Four audit checks retain exact input report hashes, independently recompute all point distances, localize matrix differences and reconcile evidence totals. Full suite: 1251 tests pass. Report regenerates byte-identically (38388 bytes). Storage/filter, links and whitespace checks pass. No assets/Rust runtime/shared VM evaluator changed; native/reference/legal/full platform scope remains open.

docs/REVERSE_ENGINEERING_TODO.md

@@ -1138,3 +1138,6 @@ Purpose: turn the supplied installation into an evidence-backed specification of
 
 
 - [x] RE-698 Complete pose-driven model hits on original MD3 hierarchies ([report](research/MD3_ORIGINAL_MODEL_HIT.md)).
+
+
+- [x] RE-699 Original-asset numerical geometry comparison audit ([report](research/MD3_GEOMETRY_AUDIT.md)).

docs/research/MD3_GEOMETRY_AUDIT.md

@@ -0,0 +1,7 @@
+# Original-asset numerical geometry comparison audit
+
+RE-699. Reproduce with `python3 scripts/analyze_md3_geometry_audit.py`; check with `python3 scripts/test_md3_geometry_audit.py`. The [machine report](md3-geometry-audit.json) retains source identity and bounded fixtures.
+
+The audit compares recovered source points from original leaf/hierarchy/full-model runs with origin+parameter×direction in float32 order, and original tag-transform bases with conventional homogeneous composition. Every comparison retains source report hash, row, leaf/transform and record indices. Differences are quantified without altering the recovered outputs. The matrix comparison leaves the first three rows identical and localizes differences to row four. These are source-versus-conventional numerical comparisons, not original executable/native parity tests; no unverified formula is promoted into gameplay behavior.
+
+No original executable/full QVM/native collision/physics/rendering executes. Native responses and legal input domains are supplied or unverified where stated; full runtime/macOS/Linux Rust/Bevy/Solari gameplay remains open.

docs/research/README.md

@@ -696,3 +696,6 @@ The extension collector adds five focused tests for native tail calls, command-r
 
 
 [RE-698: Complete pose-driven model hits on original MD3 hierarchies](MD3_ORIGINAL_MODEL_HIT.md). Reproduce with `python3 scripts/analyze_md3_original_model_hit.py`; check with `python3 scripts/test_md3_original_model_hit.py`.
+
+
+[RE-699: Original-asset numerical geometry comparison audit](MD3_GEOMETRY_AUDIT.md). Reproduce with `python3 scripts/analyze_md3_geometry_audit.py`; check with `python3 scripts/test_md3_geometry_audit.py`.

docs/research/md3-geometry-audit.json

@@ -0,0 +1,1998 @@
+{
+  "limits": "Numeric comparison of recovered QVM outputs on original assets against conventional formulas. Neither formula is executed in the original game here. Differences are evidence requiring native/reference validation, not authorization to change source behavior.",
+  "matrices": [
+    {
+      "conventional_basis": [
+        1065353216,
+        0,
+        0,
+        0,
+        0,
+        1065353216,
+        0,
+        0,
+        0,
+        0,
+        1065353216,
+        0,
+        0,
+        0,
+        0,
+        1065353216
+      ],
+      "different_indices": [
+        14
+      ],
+      "row": 0,
+      "source": "md3-original-hierarchy",
+      "source_basis": [
+        1065353216,
+        0,
+        0,
+        0,
+        0,
+        1065353216,
+        0,
+        0,
+        0,
+        0,
+        1065353216,
+        0,
+        0,
+        0,
+        1065353216,
+        1065353216
+      ],
+      "transform": 0
+    },
+    {
+      "conventional_basis": [
+        1065353215,
+        868375125,
+        878752243,
+        0,
+        3015858075,
+        1065353214,
+        880927382,
+        0,
+        3027464284,
+        3028411141,
+        1065353217,
+        0,
+        0,
+        0,
+        0,
+        1065353216
+      ],
+      "different_indices": [
+        12,
+        14
+      ],
+      "row": 0,
+      "source": "md3-original-hierarchy",
+      "source_basis": [
+        1065353215,
+        868375125,
+        878752243,
+        0,
+        3015858075,
+        1065353214,
+        880927382,
+        0,
+        3027464284,
+        3028411141,
+        1065353217,
+        0,
+        3027464284,
+        0,
+        1065353217,
+        1065353216
+      ],
+      "transform": 1
+    },
+    {
+      "conventional_basis": [
+        1065353216,
+        665708483,
+        672553469,
+        0,
+        661952485,
+        1065353215,
+        2775383776,
+        0,
+        2795012376,
+        679487527,
+        1065353216,
+        0,
+        0,
+        0,
+        0,
+        1065353216
+      ],
+      "different_indices": [
+        12,
+        14
+      ],
+      "row": 0,
+      "source": "md3-original-hierarchy",
+      "source_basis": [
+        1065353216,
+        665708483,
+        672553469,
+        0,
+        661952485,
+        1065353215,
+        2775383776,
+        0,
+        2795012376,
+        679487527,
+        1065353216,
+        0,
+        2795012376,
+        0,
+        1065353216,
+        1065353216
+      ],
+      "transform": 2
+    },
+    {
+      "conventional_basis": [
+        1065353217,
+        682553164,
+        0,
+        0,
+        679477248,
+        1065353216,
+        0,
+        0,
+        0,
+        0,
+        1065353216,
+        0,
+        0,
+        0,
+        0,
+        1065353216
+      ],
+      "different_indices": [
+        14
+      ],
+      "row": 1,
+      "source": "md3-original-hierarchy",
+      "source_basis": [
+        1065353217,
+        682553164,
+        0,
+        0,
+        679477248,
+        1065353216,
+        0,
+        0,
+        0,
+        0,
+        1065353216,
+        0,
+        0,
+        0,
+        1065353216,
+        1065353216
+      ],
+      "transform": 0
+    },
+    {
+      "conventional_basis": [
+        1065133587,
+        1040420354,
+        1036495844,
+        0,
+        3188453561,
+        1065138011,
+        1034489334,
+        0,
+        3182388264,
+        3183616228,
+        1065215758,
+        0,
+        0,
+        0,
+        0,
+        1065353216
+      ],
+      "different_indices": [
+        12,
+        14
+      ],
+      "row": 1,
+      "source": "md3-original-hierarchy",
+      "source_basis": [
+        1065133587,
+        1040420354,
+        1036495844,
+        0,
+        3188453561,
+        1065138011,
+        1034489334,
+        0,
+        3182388264,
+        3183616228,
+        1065215758,
+        0,
+        3182388264,
+        0,
+        1065215758,
+        1065353216
+      ],
+      "transform": 1
+    },
+    {
+      "conventional_basis": [
+        1065353216,
+        665708483,
+        672553469,
+        0,
+        661952485,
+        1065353215,
+        2775383776,
+        0,
+        2795012376,
+        679487527,
+        1065353216,
+        0,
+        0,
+        0,
+        0,
+        1065353216
+      ],
+      "different_indices": [
+        12,
+        14
+      ],
+      "row": 1,
+      "source": "md3-original-hierarchy",
+      "source_basis": [
+        1065353216,
+        665708483,
+        672553469,
+        0,
+        661952485,
+        1065353215,
+        2775383776,
+        0,
+        2795012376,
+        679487527,
+        1065353216,
+        0,
+        2795012376,
+        0,
+        1065353216,
+        1065353216
+      ],
+      "transform": 2
+    },
+    {
+      "conventional_basis": [
+        1065353216,
+        3020563822,
+        879645046,
+        0,
+        873070715,
+        1065353214,
+        2929896410,
+        0,
+        3029487888,
+        847297866,
+        1065353215,
+        0,
+        0,
+        0,
+        0,
+        1065353216
+      ],
+      "different_indices": [
+        12,
+        14
+      ],
+      "row": 2,
+      "source": "md3-original-hierarchy",
+      "source_basis": [
+        1065353216,
+        3020563822,
+        879645046,
+        0,
+        873070715,
+        1065353214,
+        2929896410,
+        0,
+        3029487888,
+        847297866,
+        1065353215,
+        0,
+        3029487888,
+        0,
+        1065353215,
+        1065353216
+      ],
+      "transform": 0
+    },
+    {
+      "conventional_basis": [
+        1065353217,
+        877092910,
+        3029804078,
+        0,
+        3024588670,
+        1065353216,
+        859949557,
+        0,
+        885155506,
+        3011640782,
+        1065353215,
+        0,
+        0,
+        0,
+        0,
+        1065353216
+      ],
+      "different_indices": [
+        12,
+        14
+      ],
+      "row": 2,
+      "source": "md3-original-hierarchy",
+      "source_basis": [
+        1065353217,
+        877092910,
+        3029804078,
+        0,
+        3024588670,
+        1065353216,
+        859949557,
+        0,
+        885155506,
+        3011640782,
+        1065353215,
+        0,
+        885155506,
+        0,
+        1065353215,
+        1065353216
+      ],
+      "transform": 1
+    },
+    {
+      "conventional_basis": [
+        1065353216,
+        0,
+        0,
+        0,
+        0,
+        1065353216,
+        0,
+        0,
+        0,
+        0,
+        1065353216,
+        0,
+        0,
+        0,
+        0,
+        1065353216
+      ],
+      "different_indices": [
+        14
+      ],
+      "row": 2,
+      "source": "md3-original-hierarchy",
+      "source_basis": [
+        1065353216,
+        0,
+        0,
+        0,
+        0,
+        1065353216,
+        0,
+        0,
+        0,
+        0,
+        1065353216,
+        0,
+        0,
+        0,
+        1065353216,
+        1065353216
+      ],
+      "transform": 2
+    },
+    {
+      "conventional_basis": [
+        1065353216,
+        3020560834,
+        879697884,
+        0,
+        873070714,
+        1065353217,
+        2930221443,
+        0,
+        3029487888,
+        847306571,
+        1065353217,
+        0,
+        0,
+        0,
+        0,
+        1065353216
+      ],
+      "different_indices": [
+        12,
+        14
+      ],
+      "row": 3,
+      "source": "md3-original-hierarchy",
+      "source_basis": [
+        1065353216,
+        3020560834,
+        879697884,
+        0,
+        873070714,
+        1065353217,
+        2930221443,
+        0,
+        3029487888,
+        847306571,
+        1065353217,
+        0,
+        3029487888,
+        0,
+        1065353217,
+        1065353216
+      ],
+      "transform": 0
+    },
+    {
+      "conventional_basis": [
+        1065090686,
+        1040408375,
+        1039623177,
+        0,
+        3188554942,
+        1065141647,
+        1033781334,
+        0,
+        3185571834,
+        3183342872,
+        1065179831,
+        0,
+        0,
+        0,
+        0,
+        1065353216
+      ],
+      "different_indices": [
+        12,
+        14
+      ],
+      "row": 3,
+      "source": "md3-original-hierarchy",
+      "source_basis": [
+        1065090686,
+        1040408375,
+        1039623177,
+        0,
+        3188554942,
+        1065141647,
+        1033781334,
+        0,
+        3185571834,
+        3183342872,
+        1065179831,
+        0,
+        3185571834,
+        0,
+        1065179831,
+        1065353216
+      ],
+      "transform": 1
+    },
+    {
+      "conventional_basis": [
+        1065353216,
+        0,
+        0,
+        0,
+        0,
+        1065353216,
+        0,
+        0,
+        0,
+        0,
+        1065353216,
+        0,
+        0,
+        0,
+        0,
+        1065353216
+      ],
+      "different_indices": [
+        14
+      ],
+      "row": 3,
+      "source": "md3-original-hierarchy",
+      "source_basis": [
+        1065353216,
+        0,
+        0,
+        0,
+        0,
+        1065353216,
+        0,
+        0,
+        0,
+        0,
+        1065353216,
+        0,
+        0,
+        0,
+        1065353216,
+        1065353216
+      ],
+      "transform": 2
+    }
+  ],
+  "points": [
+    {
+      "category": 1,
+      "conventional_ray_point": [
+        1001039360,
+        3181379584,
+        1091611308
+      ],
+      "distance": 2.7128223192121528,
+      "leaf": 0,
+      "parameter": 1092616194,
+      "record": 0,
+      "row": 1,
+      "source": "md3-original-leaf",
+      "source_point": [
+        3208905347,
+        3224041727,
+        1091402010
+      ]
+    },
+    {
+      "category": 1,
+      "conventional_ray_point": [
+        1077155025,
+        3181379584,
+        3219591323
+      ],
+      "distance": 1.9233081793462976,
+      "leaf": 0,
+      "parameter": 3214552931,
+      "record": 1,
+      "row": 1,
+      "source": "md3-original-leaf",
+      "source_point": [
+        1082821770,
+        1060605759,
+        3211634010
+      ]
+    },
+    {
+      "category": 2,
+      "conventional_ray_point": [
+        1033895936,
+        3229843455,
+        1079028396
+      ],
+      "distance": 1.0996973643412071,
+      "leaf": 0,
+      "parameter": 1092616192,
+      "record": 0,
+      "row": 3,
+      "source": "md3-original-leaf",
+      "source_point": [
+        3210438981,
+        3230849181,
+        1077670904
+      ]
+    },
+    {
+      "category": 2,
+      "conventional_ray_point": [
+        1037990076,
+        3230981224,
+        1082030460
+      ],
+      "distance": 3.649194866432693,
+      "leaf": 0,
+      "parameter": 1091673893,
+      "record": 1,
+      "row": 3,
+      "source": "md3-original-leaf",
+      "source_point": [
+        1076661938,
+        3229793072,
+        1069263749
+      ]
+    },
+    {
+      "category": 7,
+      "conventional_ray_point": [
+        1078831791,
+        3232956420,
+        1099931648
+      ],
+      "distance": 6.151622726235417,
+      "leaf": 0,
+      "parameter": 1092616194,
+      "record": 0,
+      "row": 5,
+      "source": "md3-original-leaf",
+      "source_point": [
+        1083198655,
+        3237532322,
+        1095079659
+      ]
+    },
+    {
+      "category": 8,
+      "conventional_ray_point": [
+        3230990806,
+        1083521083,
+        1094859622
+      ],
+      "distance": 3.118112944361031,
+      "leaf": 0,
+      "parameter": 3229981673,
+      "record": 1,
+      "row": 5,
+      "source": "md3-original-leaf",
+      "source_point": [
+        3231135619,
+        1089867864,
+        1095643518
+      ]
+    },
+    {
+      "category": 7,
+      "conventional_ray_point": [
+        3209166840,
+        3245675862,
+        1098427051
+      ],
+      "distance": 5.107601304547586,
+      "leaf": 0,
+      "parameter": 1092616193,
+      "record": 0,
+      "row": 7,
+      "source": "md3-original-leaf",
+      "source_point": [
+        1059234576,
+        3247282060,
+        1093927885
+      ]
+    },
+    {
+      "category": 8,
+      "conventional_ray_point": [
+        3236421916,
+        3233848884,
+        1090777882
+      ],
+      "distance": 5.461164146545766,
+      "leaf": 0,
+      "parameter": 3227395703,
+      "record": 1,
+      "row": 7,
+      "source": "md3-original-leaf",
+      "source_point": [
+        3233290612,
+        3209865794,
+        1091584885
+      ]
+    },
+    {
+      "category": 6,
+      "conventional_ray_point": [
+        3227473234,
+        3244796586,
+        3230345899
+      ],
+      "distance": 4.0449364575571,
+      "leaf": 0,
+      "parameter": 1092616191,
+      "record": 0,
+      "row": 9,
+      "source": "md3-original-leaf",
+      "source_point": [
+        3229227168,
+        3246088555,
+        3238190289
+      ]
+    },
+    {
+      "category": 6,
+      "conventional_ray_point": [
+        1053151504,
+        3244914338,
+        3231157633
+      ],
+      "distance": 2.9389829826388554,
+      "leaf": 0,
+      "parameter": 1086541076,
+      "record": 1,
+      "row": 9,
+      "source": "md3-original-leaf",
+      "source_point": [
+        1040392216,
+        3242533256,
+        3224950831
+      ]
+    },
+    {
+      "category": 6,
+      "conventional_ray_point": [
+        1070028120,
+        3242054996,
+        3222689110
+      ],
+      "distance": 3.789710491351861,
+      "leaf": 0,
+      "parameter": 1092616192,
+      "record": 0,
+      "row": 11,
+      "source": "md3-original-leaf",
+      "source_point": [
+        1062288156,
+        3242651608,
+        3233854340
+      ]
+    },
+    {
+      "category": 6,
+      "conventional_ray_point": [
+        1083965011,
+        3243978897,
+        3224300348
+      ],
+      "distance": 3.443234552620962,
+      "leaf": 0,
+      "parameter": 1086722178,
+      "record": 1,
+      "row": 11,
+      "source": "md3-original-leaf",
+      "source_point": [
+        1085229272,
+        3241792706,
+        3178607888
+      ]
+    },
+    {
+      "category": 1,
+      "conventional_ray_point": [
+        3213666986,
+        3214497110,
+        1091742378
+      ],
+      "distance": 3.1382995411319863,
+      "leaf": 0,
+      "parameter": 1092616192,
+      "record": 0,
+      "row": 13,
+      "source": "md3-original-leaf",
+      "source_point": [
+        3229783543,
+        3198197228,
+        1091302881
+      ]
+    },
+    {
+      "category": 1,
+      "conventional_ray_point": [
+        1067369015,
+        1074231436,
+        3203872044
+      ],
+      "distance": 2.1010006496940887,
+      "leaf": 0,
+      "parameter": 3203362900,
+      "record": 1,
+      "row": 13,
+      "source": "md3-original-leaf",
+      "source_point": [
+        3209321483,
+        1070377300,
+        3198889602
+      ]
+    },
+    {
+      "category": 2,
+      "conventional_ray_point": [
+        3183476736,
+        3228347052,
+        1074178728
+      ],
+      "distance": 5.88281679908308,
+      "leaf": 0,
+      "parameter": 1092616192,
+      "record": 0,
+      "row": 15,
+      "source": "md3-original-leaf",
+      "source_point": [
+        1085540339,
+        3229697717,
+        1079767381
+      ]
+    },
+    {
+      "category": 2,
+      "conventional_ray_point": [
+        3213921415,
+        3231221786,
+        1086901701
+      ],
+      "distance": 2.2773904595753693,
+      "leaf": 0,
+      "parameter": 1085426182,
+      "record": 1,
+      "row": 15,
+      "source": "md3-original-leaf",
+      "source_point": [
+        3222738541,
+        3229754754,
+        1090580448
+      ]
+    },
+    {
+      "category": 7,
+      "conventional_ray_point": [
+        1078722559,
+        3232934571,
+        1099912533
+      ],
+      "distance": 6.229317707845925,
+      "leaf": 0,
+      "parameter": 1092616192,
+      "record": 0,
+      "row": 17,
+      "source": "md3-original-leaf",
+      "source_point": [
+        1083025879,
+        3237462671,
+        1094929867
+      ]
+    },
+    {
+      "category": 8,
+      "conventional_ray_point": [
+        3231172688,
+        1083803078,
+        1094996341
+      ],
+      "distance": 2.9556401256014686,
+      "leaf": 0,
+      "parameter": 3230100301,
+      "record": 1,
+      "row": 17,
+      "source": "md3-original-leaf",
+      "source_point": [
+        3231308720,
+        1089828882,
+        1095719472
+      ]
+    },
+    {
+      "category": 7,
+      "conventional_ray_point": [
+        3208205664,
+        3245692245,
+        1099011413
+      ],
+      "distance": 5.027624575399031,
+      "leaf": 0,
+      "parameter": 1092616191,
+      "record": 0,
+      "row": 19,
+      "source": "md3-original-leaf",
+      "source_point": [
+        1062260665,
+        3247298918,
+        1094771868
+      ]
+    },
+    {
+      "category": 8,
+      "conventional_ray_point": [
+        3236092904,
+        3234456380,
+        1091156363
+      ],
+      "distance": 5.785004112642115,
+      "leaf": 0,
+      "parameter": 3227098568,
+      "record": 1,
+      "row": 19,
+      "source": "md3-original-leaf",
+      "source_point": [
+        3232261629,
+        3210432932,
+        1091820731
+      ]
+    },
+    {
+      "category": 6,
+      "conventional_ray_point": [
+        3231798613,
+        3238608896,
+        1091900758
+      ],
+      "distance": 2.718568467112987,
+      "leaf": 0,
+      "parameter": 1092616191,
+      "record": 0,
+      "row": 21,
+      "source": "md3-original-leaf",
+      "source_point": [
+        3230228257,
+        3236958806,
+        1094398125
+      ]
+    },
+    {
+      "category": 6,
+      "conventional_ray_point": [
+        1059550128,
+        3241954677,
+        1091534412
+      ],
+      "distance": 5.703480891473487,
+      "leaf": 0,
+      "parameter": 1079874027,
+      "record": 1,
+      "row": 21,
+      "source": "md3-original-leaf",
+      "source_point": [
+        3222726228,
+        3244232031,
+        1083471005
+      ]
+    },
+    {
+      "category": 6,
+      "conventional_ray_point": [
+        3230040064,
+        3237292714,
+        1092752725
+      ],
+      "distance": 2.8271485335982627,
+      "leaf": 0,
+      "parameter": 1092616192,
+      "record": 0,
+      "row": 23,
+      "source": "md3-original-leaf",
+      "source_point": [
+        3223771725,
+        3235701840,
+        1095066715
+      ]
+    },
+    {
+      "category": 6,
+      "conventional_ray_point": [
+        1049382496,
+        3241952465,
+        1090837119
+      ],
+      "distance": 1.2198397604554607,
+      "leaf": 0,
+      "parameter": 1080690929,
+      "record": 1,
+      "row": 23,
+      "source": "md3-original-leaf",
+      "source_point": [
+        1066839402,
+        3241871431,
+        1091693100
+      ]
+    },
+    {
+      "category": 2,
+      "conventional_ray_point": [
+        0,
+        0,
+        1111093892
+      ],
+      "distance": 0.06785862264874869,
+      "leaf": 0,
+      "parameter": 1112935804,
+      "record": 0,
+      "row": 0,
+      "source": "md3-original-hierarchy",
+      "source_point": [
+        3178727557,
+        1017661082,
+        1111099931
+      ]
+    },
+    {
+      "category": 2,
+      "conventional_ray_point": [
+        0,
+        0,
+        1111989618
+      ],
+      "distance": 5.1922906773788755,
+      "leaf": 0,
+      "parameter": 1112040078,
+      "record": 1,
+      "row": 0,
+      "source": "md3-original-hierarchy",
+      "source_point": [
+        3231487557,
+        3213340669,
+        1111629101
+      ]
+    },
+    {
+      "category": 1,
+      "conventional_ray_point": [
+        0,
+        0,
+        1111891508
+      ],
+      "distance": 0.09513355601988464,
+      "leaf": 1,
+      "parameter": 1112138188,
+      "record": 2,
+      "row": 0,
+      "source": "md3-original-hierarchy",
+      "source_point": [
+        1010031876,
+        3182909535,
+        1111899439
+      ]
+    },
+    {
+      "category": 1,
+      "conventional_ray_point": [
+        0,
+        0,
+        1108986504
+      ],
+      "distance": 3.144350293091942,
+      "leaf": 1,
+      "parameter": 1115043192,
+      "record": 3,
+      "row": 0,
+      "source": "md3-original-hierarchy",
+      "source_point": [
+        3130737664,
+        1077813617,
+        1109256568
+      ]
+    },
+    {
+      "category": 3,
+      "conventional_ray_point": [
+        0,
+        0,
+        1109767727
+      ],
+      "distance": 3.3094512630148167,
+      "leaf": 2,
+      "parameter": 1114261969,
+      "record": 4,
+      "row": 0,
+      "source": "md3-original-hierarchy",
+      "source_point": [
+        3197207604,
+        3225524510,
+        1109423804
+      ]
+    },
+    {
+      "category": 3,
+      "conventional_ray_point": [
+        0,
+        0,
+        1097907888
+      ],
+      "distance": 4.96601590325572,
+      "leaf": 2,
+      "parameter": 1118431274,
+      "record": 5,
+      "row": 0,
+      "source": "md3-original-hierarchy",
+      "source_point": [
+        1083939766,
+        1039045186,
+        1098932405
+      ]
+    },
+    {
+      "category": 8,
+      "conventional_ray_point": [
+        0,
+        0,
+        1103060880
+      ],
+      "distance": 5.352117978677881,
+      "leaf": 3,
+      "parameter": 1117267996,
+      "record": 6,
+      "row": 0,
+      "source": "md3-original-hierarchy",
+      "source_point": [
+        3228921908,
+        3221357541,
+        1101418661
+      ]
+    },
+    {
+      "category": 10,
+      "conventional_ray_point": [
+        0,
+        0,
+        1093861288
+      ],
+      "distance": 5.1067075675779865,
+      "leaf": 3,
+      "parameter": 1118937099,
+      "record": 7,
+      "row": 0,
+      "source": "md3-original-hierarchy",
+      "source_point": [
+        3231934916,
+        3160159267,
+        1093843230
+      ]
+    },
+    {
+      "category": 9,
+      "conventional_ray_point": [
+        0,
+        0,
+        1093861264
+      ],
+      "distance": 5.1921694818357365,
+      "leaf": 3,
+      "parameter": 1118937102,
+      "record": 8,
+      "row": 0,
+      "source": "md3-original-hierarchy",
+      "source_point": [
+        3232008730,
+        1060669842,
+        1093843233
+      ]
+    },
+    {
+      "category": 5,
+      "conventional_ray_point": [
+        0,
+        0,
+        1100662964
+      ],
+      "distance": 5.562514143808757,
+      "leaf": 2,
+      "parameter": 1117867475,
+      "record": 0,
+      "row": 1,
+      "source": "md3-original-hierarchy",
+      "source_point": [
+        3227061370,
+        3222376927,
+        1102643259
+      ]
+    },
+    {
+      "category": 5,
+      "conventional_ray_point": [
+        0,
+        0,
+        1106855412
+      ],
+      "distance": 5.1751039282285545,
+      "leaf": 2,
+      "parameter": 1116319363,
+      "record": 1,
+      "row": 1,
+      "source": "md3-original-hierarchy",
+      "source_point": [
+        3221515532,
+        3224135267,
+        1108099338
+      ]
+    },
+    {
+      "category": 2,
+      "conventional_ray_point": [
+        0,
+        0,
+        1110696132
+      ],
+      "distance": 6.653578643765195,
+      "leaf": 0,
+      "parameter": 1113333564,
+      "record": 0,
+      "row": 2,
+      "source": "md3-original-hierarchy",
+      "source_point": [
+        1082138392,
+        1082809830,
+        1109886320
+      ]
+    },
+    {
+      "category": 2,
+      "conventional_ray_point": [
+        0,
+        0,
+        1111919557
+      ],
+      "distance": 0.6012717659811632,
+      "leaf": 0,
+      "parameter": 1112110139,
+      "record": 1,
+      "row": 2,
+      "source": "md3-original-hierarchy",
+      "source_point": [
+        3186350210,
+        3205416601,
+        1111970129
+      ]
+    },
+    {
+      "category": 1,
+      "conventional_ray_point": [
+        0,
+        0,
+        1111770904
+      ],
+      "distance": 6.284312778899397,
+      "leaf": 1,
+      "parameter": 1112258792,
+      "record": 2,
+      "row": 2,
+      "source": "md3-original-hierarchy",
+      "source_point": [
+        3234003964,
+        1017997776,
+        1111367822
+      ]
+    },
+    {
+      "category": 1,
+      "conventional_ray_point": [
+        0,
+        0,
+        1108823558
+      ],
+      "distance": 3.0764619760276184,
+      "leaf": 1,
+      "parameter": 1115206138,
+      "record": 3,
+      "row": 2,
+      "source": "md3-original-hierarchy",
+      "source_point": [
+        1066645736,
+        1076925787,
+        1109012592
+      ]
+    },
+    {
+      "category": 7,
+      "conventional_ray_point": [
+        0,
+        0,
+        1093868848
+      ],
+      "distance": 5.208102163208799,
+      "leaf": 3,
+      "parameter": 1118936154,
+      "record": 4,
+      "row": 2,
+      "source": "md3-original-hierarchy",
+      "source_point": [
+        3232102843,
+        1055866436,
+        1093933218
+      ]
+    },
+    {
+      "category": 8,
+      "conventional_ray_point": [
+        0,
+        0,
+        1103059572
+      ],
+      "distance": 5.338178484069742,
+      "leaf": 3,
+      "parameter": 1117268323,
+      "record": 5,
+      "row": 2,
+      "source": "md3-original-hierarchy",
+      "source_point": [
+        3228906142,
+        3221271879,
+        1101420506
+      ]
+    },
+    {
+      "category": 10,
+      "conventional_ray_point": [
+        0,
+        0,
+        1093868808
+      ],
+      "distance": 4.974160771560879,
+      "leaf": 3,
+      "parameter": 1118936159,
+      "record": 6,
+      "row": 2,
+      "source": "md3-original-hierarchy",
+      "source_point": [
+        1084170720,
+        1036284099,
+        1093806875
+      ]
+    },
+    {
+      "category": 5,
+      "conventional_ray_point": [
+        0,
+        0,
+        1099645840
+      ],
+      "distance": 3.640704763369119,
+      "leaf": 2,
+      "parameter": 1118121756,
+      "record": 0,
+      "row": 3,
+      "source": "md3-original-hierarchy",
+      "source_point": [
+        1078074508,
+        3206768139,
+        1098381199
+      ]
+    },
+    {
+      "category": 5,
+      "conventional_ray_point": [
+        0,
+        0,
+        1107184064
+      ],
+      "distance": 5.829222449725307,
+      "leaf": 2,
+      "parameter": 1116237200,
+      "record": 1,
+      "row": 3,
+      "source": "md3-original-hierarchy",
+      "source_point": [
+        1069788167,
+        1067937801,
+        1104315686
+      ]
+    },
+    {
+      "category": 2,
+      "conventional_ray_point": [
+        0,
+        0,
+        1110957486
+      ],
+      "distance": 1.4306539077902842,
+      "leaf": 0,
+      "parameter": 1113072210,
+      "record": 0,
+      "row": 1,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        1067609659,
+        1043579769,
+        1111124441
+      ]
+    },
+    {
+      "category": 2,
+      "conventional_ray_point": [
+        0,
+        0,
+        1111923681
+      ],
+      "distance": 4.147061950337395,
+      "leaf": 0,
+      "parameter": 1112106015,
+      "record": 1,
+      "row": 1,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3228301513,
+        3215611162,
+        1111568779
+      ]
+    },
+    {
+      "category": 1,
+      "conventional_ray_point": [
+        0,
+        0,
+        1111790244
+      ],
+      "distance": 2.93432471065848,
+      "leaf": 1,
+      "parameter": 1112239452,
+      "record": 2,
+      "row": 1,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        1024850115,
+        1077659668,
+        1111792198
+      ]
+    },
+    {
+      "category": 1,
+      "conventional_ray_point": [
+        0,
+        0,
+        1109086146
+      ],
+      "distance": 3.777820993870694,
+      "leaf": 1,
+      "parameter": 1114943550,
+      "record": 3,
+      "row": 1,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3225984875,
+        3183892558,
+        1109638270
+      ]
+    },
+    {
+      "category": 3,
+      "conventional_ray_point": [
+        0,
+        0,
+        1109845790
+      ],
+      "distance": 2.772093154963025,
+      "leaf": 2,
+      "parameter": 1114183906,
+      "record": 4,
+      "row": 1,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3207538734,
+        1076614624,
+        1109823060
+      ]
+    },
+    {
+      "category": 3,
+      "conventional_ray_point": [
+        0,
+        0,
+        1098006088
+      ],
+      "distance": 4.4466201478482414,
+      "leaf": 2,
+      "parameter": 1118418999,
+      "record": 5,
+      "row": 1,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        1083002024,
+        1039031644,
+        1098542089
+      ]
+    },
+    {
+      "category": 8,
+      "conventional_ray_point": [
+        0,
+        0,
+        1103060880
+      ],
+      "distance": 5.352117978677881,
+      "leaf": 3,
+      "parameter": 1117267996,
+      "record": 6,
+      "row": 1,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3228921908,
+        3221357541,
+        1101418661
+      ]
+    },
+    {
+      "category": 10,
+      "conventional_ray_point": [
+        0,
+        0,
+        1093861288
+      ],
+      "distance": 5.1067075675779865,
+      "leaf": 3,
+      "parameter": 1118937099,
+      "record": 7,
+      "row": 1,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3231934916,
+        3160159267,
+        1093843230
+      ]
+    },
+    {
+      "category": 9,
+      "conventional_ray_point": [
+        0,
+        0,
+        1093861264
+      ],
+      "distance": 5.1921694818357365,
+      "leaf": 3,
+      "parameter": 1118937102,
+      "record": 8,
+      "row": 1,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3232008730,
+        1060669842,
+        1093843233
+      ]
+    },
+    {
+      "category": 3,
+      "conventional_ray_point": [
+        3254081392,
+        1063450944,
+        3239637362
+      ],
+      "distance": 4.74071305341828,
+      "leaf": 2,
+      "parameter": 1091103651,
+      "record": 0,
+      "row": 2,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3255659855,
+        1062165711,
+        3240364803
+      ]
+    },
+    {
+      "category": 3,
+      "conventional_ray_point": [
+        3252753682,
+        1077927146,
+        3242161640
+      ],
+      "distance": 3.8845535124186075,
+      "leaf": 2,
+      "parameter": 1083126922,
+      "record": 1,
+      "row": 2,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3253737971,
+        1087006976,
+        3241425237
+      ]
+    },
+    {
+      "category": 7,
+      "conventional_ray_point": [
+        3254550528,
+        1041236000,
+        3238745430
+      ],
+      "distance": 3.8223878941426834,
+      "leaf": 3,
+      "parameter": 1092616191,
+      "record": 2,
+      "row": 2,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3253582975,
+        1069070019,
+        3233021410
+      ]
+    },
+    {
+      "category": 10,
+      "conventional_ray_point": [
+        3251253146,
+        1085032719,
+        3245014498
+      ],
+      "distance": 3.8093712650472145,
+      "leaf": 3,
+      "parameter": 3188583478,
+      "record": 3,
+      "row": 2,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3249756978,
+        1082705324,
+        3246891077
+      ]
+    },
+    {
+      "category": 9,
+      "conventional_ray_point": [
+        3251181607,
+        1085271284,
+        3245150510
+      ],
+      "distance": 3.553305456206072,
+      "leaf": 3,
+      "parameter": 3199702321,
+      "record": 4,
+      "row": 2,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3249764852,
+        1083284182,
+        3246873909
+      ]
+    },
+    {
+      "category": 9,
+      "conventional_ray_point": [
+        3248323879,
+        1092660084,
+        3248487497
+      ],
+      "distance": 7.087449842459512,
+      "leaf": 3,
+      "parameter": 3239203659,
+      "record": 5,
+      "row": 2,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3249841086,
+        1083340277,
+        3246671928
+      ]
+    },
+    {
+      "category": 9,
+      "conventional_ray_point": [
+        3251137557,
+        1085418180,
+        3245234259
+      ],
+      "distance": 19.679085038197925,
+      "leaf": 3,
+      "parameter": 3204246993,
+      "record": 6,
+      "row": 2,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3244212922,
+        1101532133,
+        3239986166
+      ]
+    },
+    {
+      "category": 2,
+      "conventional_ray_point": [
+        0,
+        0,
+        1110602589
+      ],
+      "distance": 6.51508506207071,
+      "leaf": 0,
+      "parameter": 1113427107,
+      "record": 0,
+      "row": 4,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        1083112116,
+        1082306364,
+        1109971033
+      ]
+    },
+    {
+      "category": 2,
+      "conventional_ray_point": [
+        0,
+        0,
+        1111925870
+      ],
+      "distance": 1.1198677870716387,
+      "leaf": 0,
+      "parameter": 1112103826,
+      "record": 1,
+      "row": 4,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        1063828324,
+        3205416600,
+        1112015374
+      ]
+    },
+    {
+      "category": 1,
+      "conventional_ray_point": [
+        0,
+        0,
+        1111675202
+      ],
+      "distance": 4.340427871663892,
+      "leaf": 1,
+      "parameter": 1112354494,
+      "record": 2,
+      "row": 4,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3230064740,
+        3190994242,
+        1111407411
+      ]
+    },
+    {
+      "category": 1,
+      "conventional_ray_point": [
+        0,
+        0,
+        1108857703
+      ],
+      "distance": 4.848247956544749,
+      "leaf": 1,
+      "parameter": 1115171993,
+      "record": 3,
+      "row": 4,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3230652655,
+        3204507499,
+        1109315132
+      ]
+    },
+    {
+      "category": 7,
+      "conventional_ray_point": [
+        0,
+        0,
+        1093868848
+      ],
+      "distance": 5.208102163208799,
+      "leaf": 3,
+      "parameter": 1118936154,
+      "record": 4,
+      "row": 4,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3232102843,
+        1055866436,
+        1093933218
+      ]
+    },
+    {
+      "category": 8,
+      "conventional_ray_point": [
+        0,
+        0,
+        1103059572
+      ],
+      "distance": 5.338178484069742,
+      "leaf": 3,
+      "parameter": 1117268323,
+      "record": 5,
+      "row": 4,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3228906142,
+        3221271879,
+        1101420506
+      ]
+    },
+    {
+      "category": 10,
+      "conventional_ray_point": [
+        0,
+        0,
+        1093868808
+      ],
+      "distance": 4.974160771560879,
+      "leaf": 3,
+      "parameter": 1118936159,
+      "record": 6,
+      "row": 4,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        1084170720,
+        1036284099,
+        1093806875
+      ]
+    },
+    {
+      "category": 6,
+      "conventional_ray_point": [
+        3257297592,
+        3234943608,
+        3222578520
+      ],
+      "distance": 11.168189502108536,
+      "leaf": 2,
+      "parameter": 1102402131,
+      "record": 0,
+      "row": 5,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3257485097,
+        1081996522,
+        1068609196
+      ]
+    },
+    {
+      "category": 6,
+      "conventional_ray_point": [
+        3256584330,
+        3230793974,
+        3230361646
+      ],
+      "distance": 10.969607051394398,
+      "leaf": 2,
+      "parameter": 1100341001,
+      "record": 1,
+      "row": 5,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3257809282,
+        1084929864,
+        3228036461
+      ]
+    },
+    {
+      "category": 3,
+      "conventional_ray_point": [
+        3254965243,
+        3180425344,
+        3239023286
+      ],
+      "distance": 5.320491028559933,
+      "leaf": 2,
+      "parameter": 1092416919,
+      "record": 2,
+      "row": 5,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3256013297,
+        3225951968,
+        3240834992
+      ]
+    },
+    {
+      "category": 7,
+      "conventional_ray_point": [
+        3254999723,
+        3190467200,
+        3238920192
+      ],
+      "distance": 3.751400448923048,
+      "leaf": 3,
+      "parameter": 1092616190,
+      "record": 3,
+      "row": 5,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3254417250,
+        1065591898,
+        3233106188
+      ]
+    },
+    {
+      "category": 7,
+      "conventional_ray_point": [
+        3251118523,
+        1085321812,
+        3245051276
+      ],
+      "distance": 3.611793921938553,
+      "leaf": 3,
+      "parameter": 3215368731,
+      "record": 4,
+      "row": 5,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3250159272,
+        1081410467,
+        3247091459
+      ]
+    },
+    {
+      "category": 9,
+      "conventional_ray_point": [
+        3251118523,
+        1085321812,
+        3245051276
+      ],
+      "distance": 3.611793921938553,
+      "leaf": 3,
+      "parameter": 3215368731,
+      "record": 5,
+      "row": 5,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3250159272,
+        1081410467,
+        3247091459
+      ]
+    },
+    {
+      "category": 9,
+      "conventional_ray_point": [
+        3248372406,
+        1091914536,
+        3247774029
+      ],
+      "distance": 6.633907171885594,
+      "leaf": 3,
+      "parameter": 3238914664,
+      "record": 6,
+      "row": 5,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3250307791,
+        1082600202,
+        3246686586
+      ]
+    },
+    {
+      "category": 9,
+      "conventional_ray_point": [
+        3250738093,
+        1086428450,
+        3245620024
+      ],
+      "distance": 19.8323823768747,
+      "leaf": 3,
+      "parameter": 3222694453,
+      "record": 7,
+      "row": 5,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3243458093,
+        1102039618,
+        3241323133
+      ]
+    },
+    {
+      "category": 10,
+      "conventional_ray_point": [
+        3251118830,
+        1085320921,
+        3245050818
+      ],
+      "distance": 8.669235950831293,
+      "leaf": 3,
+      "parameter": 3215361650,
+      "record": 8,
+      "row": 5,
+      "source": "md3-original-model-hit",
+      "source_point": [
+        3255029412,
+        1086809549,
+        3241465415
+      ]
+    }
+  ],
+  "source_report_hashes": {
+    "md3-original-hierarchy": "8d57f8202beb3a7d9db48e9d4fc3ad3c62b459005155cc0f8b0906b20fbacd23",
+    "md3-original-leaf": "f52847bf4a7ab7841a49d46eb00e244547e2c10180001b8f3ebc6684f5b931ef",
+    "md3-original-model-hit": "dd26b73b946f605003c1c5f86cf406a99f01d6cdab747c24f45b7c28ba6c8f28"
+  },
+  "summary": {
+    "fourth_row_differences": 12,
+    "largest_point_distance": 19.8323823768747,
+    "noncoincident_points": 76,
+    "point_comparisons": 76
+  }
+}

scripts/analyze_md3_geometry_audit.py

@@ -0,0 +1,32 @@
+#!/usr/bin/env python3
+"""Measure recovered original-asset outputs against conventional geometry formulas."""
+import hashlib,json,math,struct
+from pathlib import Path
+from analyze_qvm_acceleration import word,number
+from analyze_qvm import write_json
+
+def f(v):return struct.unpack('<f',struct.pack('<f',v))[0]
+def conventional_basis(t):
+    a=list(map(number,t['sample_words64_108']));left=[a[3:6]+[0],a[6:9]+[0],a[9:12]+[0],[0,0,0,1]];right=[[number(v) for v in t['initial_record'][3+4*r:7+4*r]] for r in range(4)];out=[]
+    for row in left:
+        for col in range(4):
+            value=f(row[0]*right[0][col])
+            for k in range(1,4):value=f(value+f(row[k]*right[k][col]))
+            out.append(word(value))
+    return out
+
+def main():
+    points=[];matrices=[];sources={}
+    for stem in ['md3-original-leaf','md3-original-hierarchy','md3-original-model-hit']:
+        path=Path('docs/research')/(stem+'.json');data=path.read_bytes();sources[stem]=hashlib.sha256(data).hexdigest();rows=json.loads(data)['probes']
+        for row_index,p in enumerate(rows):
+            leafs=[p] if stem=='md3-original-leaf' else [r['effect'] for r in (p['leaf_reports'] if stem=='md3-original-hierarchy' else p['hierarchies'][0]['leaf_reports'])]
+            for leaf_index,r in enumerate(leafs):
+                origin=list(map(number,r['input']['origin']));direction=list(map(number,r['input']['direction']))
+                for record in range(r['before'][16],r['after'][16]):
+                    values=r['after'][17+5*record:22+5*record];t=number(values[4]);expected=[word(f(x+f(t*y))) for x,y in zip(origin,direction)];distance=math.sqrt(sum((number(x)-number(y))**2 for x,y in zip(values[1:4],expected)));points.append({'source':stem,'row':row_index,'leaf':leaf_index,'record':record,'category':values[0],'parameter':values[4],'source_point':values[1:4],'conventional_ray_point':expected,'distance':distance})
+            if stem=='md3-original-hierarchy':
+                for index,t in enumerate(p['transforms']):
+                    actual=t['final_record'][3:19];expected=conventional_basis(t);matrices.append({'source':stem,'row':row_index,'transform':index,'source_basis':actual,'conventional_basis':expected,'different_indices':[j for j,(a,b) in enumerate(zip(actual,expected)) if a!=b]})
+    write_json(Path('docs/research/md3-geometry-audit.json'),{'source_report_hashes':sources,'points':points,'matrices':matrices,'summary':{'point_comparisons':len(points),'noncoincident_points':sum(p['distance']>1e-5 for p in points),'largest_point_distance':max(p['distance'] for p in points),'fourth_row_differences':sum(bool(p['different_indices']) for p in matrices)},'limits':'Numeric comparison of recovered QVM outputs on original assets against conventional formulas. Neither formula is executed in the original game here. Differences are evidence requiring native/reference validation, not authorization to change source behavior.'})
+if __name__=='__main__':main()

scripts/test_md3_geometry_audit.py

@@ -0,0 +1,17 @@
+import hashlib,json,math,unittest
+from pathlib import Path
+from test_qvm_ground import word,n,f
+class GeometryAuditTests(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):cls.r=json.loads(Path('docs/research/md3-geometry-audit.json').read_text())
+    def test_audit_inputs_retain_exact_source_report_identity(self):
+        for stem,digest in self.r['source_report_hashes'].items():self.assertEqual(hashlib.sha256((Path('docs/research')/(stem+'.json')).read_bytes()).hexdigest(),digest)
+    def test_point_distance_metrics_independently_recomputed(self):
+        points=self.r['points'];self.assertGreater(len(points),0)
+        for p in points:self.assertAlmostEqual(p['distance'],math.dist(list(map(n,p['source_point'])),list(map(n,p['conventional_ray_point']))),places=10)
+        self.assertEqual(self.r['summary']['noncoincident_points'],sum(p['distance']>1e-5 for p in points));self.assertGreater(self.r['summary']['noncoincident_points'],0)
+    def test_matrix_comparison_localizes_source_difference_to_fourth_row(self):
+        self.assertEqual(len(self.r['matrices']),12)
+        for p in self.r['matrices']:self.assertEqual(p['source_basis'][:12],p['conventional_basis'][:12]);self.assertTrue(set(p['different_indices'])<={12,13,14,15})
+    def test_summary_counts_match_all_retained_evidence(self):self.assertEqual(self.r['summary']['point_comparisons'],len(self.r['points']));self.assertEqual(self.r['summary']['fourth_row_differences'],sum(bool(p['different_indices']) for p in self.r['matrices']))
+if __name__=='__main__':unittest.main()