qvm: vector angle conversion

docs/ASSET_PIPELINE_TODO.md

@@ -658,3 +658,6 @@ Research progress: RE-659 [report](research/QVM_HISTORY_CALLERS.md); remaining n
 
 
 Research progress: RE-660 [report](research/QVM_POSE_CONTROLLERS.md); remaining native/content/runtime/platform scope stays open.
+
+
+Research progress: RE-661 [report](research/QVM_VECTOR_ANGLES.md); remaining native/content/runtime/platform scope stays open.

docs/FINDINGS.md

@@ -1004,3 +1004,6 @@ Bounded qagame paths recover bomb-plant/inactivity correction requests, direct f
 
 
 **RE-660 — Pose prefix with both actual swing controllers:** 32254 executes two33391 calls through caller-owned angle/flag pointers, then reloads both changed angles before animation branching. [Evidence](research/QVM_POSE_CONTROLLERS.md).
+
+
+**RE-661 — Complete vector-to-angle helper and alias behavior:** 62944 converts vectors through explicit quadrant/vertical branches and finite atan2/sqrt responses; the zero vector yields pitch−270 and yaw0. [Evidence](research/QVM_VECTOR_ANGLES.md).

docs/PROVISIONAL_TODO.md

@@ -981,3 +981,6 @@ Research progress: RE-659 [report](research/QVM_HISTORY_CALLERS.md); remaining n
 
 
 Research progress: RE-660 [report](research/QVM_POSE_CONTROLLERS.md); remaining native/content/runtime/platform scope stays open.
+
+
+Research progress: RE-661 [report](research/QVM_VECTOR_ANGLES.md); remaining native/content/runtime/platform scope stays open.

docs/RESEARCH_LEDGER.md

@@ -962,3 +962,8 @@ One direct append caller156173 and three direct reset callers174399/203011/21963
 ## 2026-10-20 — RE-660 Pose prefix with both actual swing controllers (separate task commit)
 
 32254 executes two33391 calls through caller-owned angle/flag pointers, then reloads both changed angles before animation branching. 36 fixtures independently compose float32 controllers, flag masks, pointer mutation, time forwarding and caller reloads. Full suite: 1105 tests pass. Report regenerates byte-identically (155837 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-20 — RE-661 Complete vector-to-angle helper and alias behavior (separate task commit)
+
+62944 converts vectors through explicit quadrant/vertical branches and finite atan2/sqrt responses; the zero vector yields pitch−270 and yaw0. 24 axis/quadrant/zero/general fixtures check independent source-order float32 outputs, exact input/output aliasing and reached native call order. Full suite: 1109 tests pass. Report regenerates byte-identically (42673 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

@@ -1024,3 +1024,6 @@ Purpose: turn the supplied installation into an evidence-backed specification of
 
 
 - [x] RE-660 Pose prefix with both actual swing controllers ([report](research/QVM_POSE_CONTROLLERS.md)).
+
+
+- [x] RE-661 Complete vector-to-angle helper and alias behavior ([report](research/QVM_VECTOR_ANGLES.md)).

docs/research/QVM_VECTOR_ANGLES.md

@@ -0,0 +1,7 @@
+# Complete vector-to-angle helper and alias behavior
+
+RE-661. Reproduce with `python3 scripts/analyze_qvm_vector_angles.py`; check with `python3 scripts/test_qvm_vector_angles.py`. The [machine report](qvm-vector-angles.json) retains source identity and bounded fixtures.
+
+Complete62945–63119 writes negative pitch, yaw and zero roll. Zero horizontal input bypasses all native math and selects pitch90 for positive z, otherwise270; thus the zero vector writes−270, not a normalized zero angle. General input uses yaw atan2(y,x), a rounded horizontal length and pitch atan2(z,length), with single positive-turn corrections before negating pitch. Exact input/output alias works because the source completes input reads before publication. Finite math.atan2/sqrt are supplied native models and do not establish original library bit parity; partial overlaps and nonfinite domains remain open.
+
+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

@@ -582,3 +582,6 @@ The extension collector adds five focused tests for native tail calls, command-r
 
 
 [RE-660: Pose prefix with both actual swing controllers](QVM_POSE_CONTROLLERS.md). Reproduce with `python3 scripts/analyze_qvm_pose_controllers.py`; check with `python3 scripts/test_qvm_pose_controllers.py`.
+
+
+[RE-661: Complete vector-to-angle helper and alias behavior](QVM_VECTOR_ANGLES.md). Reproduce with `python3 scripts/analyze_qvm_vector_angles.py`; check with `python3 scripts/test_qvm_vector_angles.py`.

docs/research/qvm-vector-angles.json

@@ -0,0 +1,1869 @@
+{
+  "limits": "Actual62945\u201363119, finite math.atan2/sqrt responses rounded tofloat32. Native library bit parity, partial overlaps and live domain remain unverified. Zero input follows the source vertical fallback.",
+  "probes": [
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318608
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [],
+        "children": [],
+        "return": null,
+        "trace": null,
+        "trace_length": 50,
+        "trace_sha256": "9bde076561def9cf7f5deb04f343c9c71d774f4488122a2ba2154b3b0655160b"
+      },
+      "input": [
+        0,
+        0,
+        0
+      ],
+      "output": [
+        3280404480,
+        0,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318592
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [],
+        "children": [],
+        "return": null,
+        "trace": null,
+        "trace_length": 50,
+        "trace_sha256": "9bde076561def9cf7f5deb04f343c9c71d774f4488122a2ba2154b3b0655160b"
+      },
+      "input": [
+        0,
+        0,
+        0
+      ],
+      "output": [
+        3280404480,
+        0,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318608
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [],
+        "children": [],
+        "return": null,
+        "trace": null,
+        "trace_length": 50,
+        "trace_sha256": "1f4a7358ee639a796640d99da2629c9eba18d7de20a056e656ba298a540f1e73"
+      },
+      "input": [
+        0,
+        0,
+        1065353216
+      ],
+      "output": [
+        3266576384,
+        0,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318592
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [],
+        "children": [],
+        "return": null,
+        "trace": null,
+        "trace_length": 50,
+        "trace_sha256": "1f4a7358ee639a796640d99da2629c9eba18d7de20a056e656ba298a540f1e73"
+      },
+      "input": [
+        0,
+        0,
+        1065353216
+      ],
+      "output": [
+        3266576384,
+        0,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318608
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [],
+        "children": [],
+        "return": null,
+        "trace": null,
+        "trace_length": 50,
+        "trace_sha256": "9bde076561def9cf7f5deb04f343c9c71d774f4488122a2ba2154b3b0655160b"
+      },
+      "input": [
+        0,
+        0,
+        3212836864
+      ],
+      "output": [
+        3280404480,
+        0,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318592
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [],
+        "children": [],
+        "return": null,
+        "trace": null,
+        "trace_length": 50,
+        "trace_sha256": "9bde076561def9cf7f5deb04f343c9c71d774f4488122a2ba2154b3b0655160b"
+      },
+      "input": [
+        0,
+        0,
+        3212836864
+      ],
+      "output": [
+        3280404480,
+        0,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318608
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 0,
+              "12": 1065353216
+            },
+            "instruction": 63002,
+            "target": -106
+          },
+          {
+            "args": {
+              "8": 1065353216
+            },
+            "instruction": 63066,
+            "target": -107
+          },
+          {
+            "args": {
+              "8": 0,
+              "12": 1065353216
+            },
+            "instruction": 63083,
+            "target": -106
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 0,
+                "12": 1065353216
+              },
+              "instruction": 63002,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 0,
+                "12": 1065353216
+              },
+              "original_native_executed": false,
+              "result": 0
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 1065353216
+              },
+              "instruction": 63066,
+              "target": -107
+            },
+            "effect": {
+              "input": 1065353216,
+              "root": 1065353216
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 0,
+                "12": 1065353216
+              },
+              "instruction": 63083,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 0,
+                "12": 1065353216
+              },
+              "original_native_executed": false,
+              "result": 0
+            }
+          }
+        ],
+        "return": null,
+        "trace": null,
+        "trace_length": 128,
+        "trace_sha256": "6b9b4949ad7f4aea3a4bfe284267c5980a010b55cafeef43c73e2702560c5f34"
+      },
+      "input": [
+        1065353216,
+        0,
+        0
+      ],
+      "output": [
+        2147483648,
+        0,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318592
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 0,
+              "12": 1065353216
+            },
+            "instruction": 63002,
+            "target": -106
+          },
+          {
+            "args": {
+              "8": 1065353216
+            },
+            "instruction": 63066,
+            "target": -107
+          },
+          {
+            "args": {
+              "8": 0,
+              "12": 1065353216
+            },
+            "instruction": 63083,
+            "target": -106
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 0,
+                "12": 1065353216
+              },
+              "instruction": 63002,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 0,
+                "12": 1065353216
+              },
+              "original_native_executed": false,
+              "result": 0
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 1065353216
+              },
+              "instruction": 63066,
+              "target": -107
+            },
+            "effect": {
+              "input": 1065353216,
+              "root": 1065353216
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 0,
+                "12": 1065353216
+              },
+              "instruction": 63083,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 0,
+                "12": 1065353216
+              },
+              "original_native_executed": false,
+              "result": 0
+            }
+          }
+        ],
+        "return": null,
+        "trace": null,
+        "trace_length": 128,
+        "trace_sha256": "6b9b4949ad7f4aea3a4bfe284267c5980a010b55cafeef43c73e2702560c5f34"
+      },
+      "input": [
+        1065353216,
+        0,
+        0
+      ],
+      "output": [
+        2147483648,
+        0,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318608
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 0,
+              "12": 3212836864
+            },
+            "instruction": 63002,
+            "target": -106
+          },
+          {
+            "args": {
+              "8": 1065353216
+            },
+            "instruction": 63066,
+            "target": -107
+          },
+          {
+            "args": {
+              "8": 0,
+              "12": 1065353216
+            },
+            "instruction": 63083,
+            "target": -106
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 0,
+                "12": 3212836864
+              },
+              "instruction": 63002,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 0,
+                "12": 3212836864
+              },
+              "original_native_executed": false,
+              "result": 1078530011
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 1065353216
+              },
+              "instruction": 63066,
+              "target": -107
+            },
+            "effect": {
+              "input": 1065353216,
+              "root": 1065353216
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 0,
+                "12": 1065353216
+              },
+              "instruction": 63083,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 0,
+                "12": 1065353216
+              },
+              "original_native_executed": false,
+              "result": 0
+            }
+          }
+        ],
+        "return": null,
+        "trace": null,
+        "trace_length": 128,
+        "trace_sha256": "6b9b4949ad7f4aea3a4bfe284267c5980a010b55cafeef43c73e2702560c5f34"
+      },
+      "input": [
+        3212836864,
+        0,
+        0
+      ],
+      "output": [
+        2147483648,
+        1127481344,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318592
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 0,
+              "12": 3212836864
+            },
+            "instruction": 63002,
+            "target": -106
+          },
+          {
+            "args": {
+              "8": 1065353216
+            },
+            "instruction": 63066,
+            "target": -107
+          },
+          {
+            "args": {
+              "8": 0,
+              "12": 1065353216
+            },
+            "instruction": 63083,
+            "target": -106
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 0,
+                "12": 3212836864
+              },
+              "instruction": 63002,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 0,
+                "12": 3212836864
+              },
+              "original_native_executed": false,
+              "result": 1078530011
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 1065353216
+              },
+              "instruction": 63066,
+              "target": -107
+            },
+            "effect": {
+              "input": 1065353216,
+              "root": 1065353216
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 0,
+                "12": 1065353216
+              },
+              "instruction": 63083,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 0,
+                "12": 1065353216
+              },
+              "original_native_executed": false,
+              "result": 0
+            }
+          }
+        ],
+        "return": null,
+        "trace": null,
+        "trace_length": 128,
+        "trace_sha256": "6b9b4949ad7f4aea3a4bfe284267c5980a010b55cafeef43c73e2702560c5f34"
+      },
+      "input": [
+        3212836864,
+        0,
+        0
+      ],
+      "output": [
+        2147483648,
+        1127481344,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318608
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 1065353216
+            },
+            "instruction": 63066,
+            "target": -107
+          },
+          {
+            "args": {
+              "8": 0,
+              "12": 1065353216
+            },
+            "instruction": 63083,
+            "target": -106
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 1065353216
+              },
+              "instruction": 63066,
+              "target": -107
+            },
+            "effect": {
+              "input": 1065353216,
+              "root": 1065353216
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 0,
+                "12": 1065353216
+              },
+              "instruction": 63083,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 0,
+                "12": 1065353216
+              },
+              "original_native_executed": false,
+              "result": 0
+            }
+          }
+        ],
+        "return": null,
+        "trace": null,
+        "trace_length": 109,
+        "trace_sha256": "680155eed18edbb90da902f29e2b467d36ea82e02312c01a4793b6d0b2e4b1d4"
+      },
+      "input": [
+        0,
+        1065353216,
+        0
+      ],
+      "output": [
+        2147483648,
+        1119092736,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318592
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 1065353216
+            },
+            "instruction": 63066,
+            "target": -107
+          },
+          {
+            "args": {
+              "8": 0,
+              "12": 1065353216
+            },
+            "instruction": 63083,
+            "target": -106
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 1065353216
+              },
+              "instruction": 63066,
+              "target": -107
+            },
+            "effect": {
+              "input": 1065353216,
+              "root": 1065353216
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 0,
+                "12": 1065353216
+              },
+              "instruction": 63083,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 0,
+                "12": 1065353216
+              },
+              "original_native_executed": false,
+              "result": 0
+            }
+          }
+        ],
+        "return": null,
+        "trace": null,
+        "trace_length": 109,
+        "trace_sha256": "680155eed18edbb90da902f29e2b467d36ea82e02312c01a4793b6d0b2e4b1d4"
+      },
+      "input": [
+        0,
+        1065353216,
+        0
+      ],
+      "output": [
+        2147483648,
+        1119092736,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318608
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 1065353216
+            },
+            "instruction": 63066,
+            "target": -107
+          },
+          {
+            "args": {
+              "8": 0,
+              "12": 1065353216
+            },
+            "instruction": 63083,
+            "target": -106
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 1065353216
+              },
+              "instruction": 63066,
+              "target": -107
+            },
+            "effect": {
+              "input": 1065353216,
+              "root": 1065353216
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 0,
+                "12": 1065353216
+              },
+              "instruction": 63083,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 0,
+                "12": 1065353216
+              },
+              "original_native_executed": false,
+              "result": 0
+            }
+          }
+        ],
+        "return": null,
+        "trace": null,
+        "trace_length": 107,
+        "trace_sha256": "93fceaaa85e0a5e4f28fbd9d0d49f15f1170b3c7cd5f4d9557e3160b84f957ce"
+      },
+      "input": [
+        0,
+        3212836864,
+        0
+      ],
+      "output": [
+        2147483648,
+        1132920832,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318592
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 1065353216
+            },
+            "instruction": 63066,
+            "target": -107
+          },
+          {
+            "args": {
+              "8": 0,
+              "12": 1065353216
+            },
+            "instruction": 63083,
+            "target": -106
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 1065353216
+              },
+              "instruction": 63066,
+              "target": -107
+            },
+            "effect": {
+              "input": 1065353216,
+              "root": 1065353216
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 0,
+                "12": 1065353216
+              },
+              "instruction": 63083,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 0,
+                "12": 1065353216
+              },
+              "original_native_executed": false,
+              "result": 0
+            }
+          }
+        ],
+        "return": null,
+        "trace": null,
+        "trace_length": 107,
+        "trace_sha256": "93fceaaa85e0a5e4f28fbd9d0d49f15f1170b3c7cd5f4d9557e3160b84f957ce"
+      },
+      "input": [
+        0,
+        3212836864,
+        0
+      ],
+      "output": [
+        2147483648,
+        1132920832,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318608
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 1065353216,
+              "12": 1065353216
+            },
+            "instruction": 63002,
+            "target": -106
+          },
+          {
+            "args": {
+              "8": 1073741824
+            },
+            "instruction": 63066,
+            "target": -107
+          },
+          {
+            "args": {
+              "8": 1065353216,
+              "12": 1068827891
+            },
+            "instruction": 63083,
+            "target": -106
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 1065353216,
+                "12": 1065353216
+              },
+              "instruction": 63002,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 1065353216,
+                "12": 1065353216
+              },
+              "original_native_executed": false,
+              "result": 1061752795
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 1073741824
+              },
+              "instruction": 63066,
+              "target": -107
+            },
+            "effect": {
+              "input": 1073741824,
+              "root": 1068827891
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 1065353216,
+                "12": 1068827891
+              },
+              "instruction": 63083,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 1065353216,
+                "12": 1068827891
+              },
+              "original_native_executed": false,
+              "result": 1058902036
+            }
+          }
+        ],
+        "return": null,
+        "trace": null,
+        "trace_length": 123,
+        "trace_sha256": "e698a0c54e63429542fb1913a069091e4914c61a17232ba8ea9988eb5c118c77"
+      },
+      "input": [
+        1065353216,
+        1065353216,
+        1065353216
+      ],
+      "output": [
+        3255635644,
+        1110704128,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318592
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 1065353216,
+              "12": 1065353216
+            },
+            "instruction": 63002,
+            "target": -106
+          },
+          {
+            "args": {
+              "8": 1073741824
+            },
+            "instruction": 63066,
+            "target": -107
+          },
+          {
+            "args": {
+              "8": 1065353216,
+              "12": 1068827891
+            },
+            "instruction": 63083,
+            "target": -106
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 1065353216,
+                "12": 1065353216
+              },
+              "instruction": 63002,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 1065353216,
+                "12": 1065353216
+              },
+              "original_native_executed": false,
+              "result": 1061752795
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 1073741824
+              },
+              "instruction": 63066,
+              "target": -107
+            },
+            "effect": {
+              "input": 1073741824,
+              "root": 1068827891
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 1065353216,
+                "12": 1068827891
+              },
+              "instruction": 63083,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 1065353216,
+                "12": 1068827891
+              },
+              "original_native_executed": false,
+              "result": 1058902036
+            }
+          }
+        ],
+        "return": null,
+        "trace": null,
+        "trace_length": 123,
+        "trace_sha256": "e698a0c54e63429542fb1913a069091e4914c61a17232ba8ea9988eb5c118c77"
+      },
+      "input": [
+        1065353216,
+        1065353216,
+        1065353216
+      ],
+      "output": [
+        3255635644,
+        1110704128,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318608
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 1065353216,
+              "12": 3212836864
+            },
+            "instruction": 63002,
+            "target": -106
+          },
+          {
+            "args": {
+              "8": 1073741824
+            },
+            "instruction": 63066,
+            "target": -107
+          },
+          {
+            "args": {
+              "8": 3212836864,
+              "12": 1068827891
+            },
+            "instruction": 63083,
+            "target": -106
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 1065353216,
+                "12": 3212836864
+              },
+              "instruction": 63002,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 1065353216,
+                "12": 3212836864
+              },
+              "original_native_executed": false,
+              "result": 1075235812
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 1073741824
+              },
+              "instruction": 63066,
+              "target": -107
+            },
+            "effect": {
+              "input": 1073741824,
+              "root": 1068827891
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 3212836864,
+                "12": 1068827891
+              },
+              "instruction": 63083,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 3212836864,
+                "12": 1068827891
+              },
+              "original_native_executed": false,
+              "result": 3206385684
+            }
+          }
+        ],
+        "return": null,
+        "trace": null,
+        "trace_length": 129,
+        "trace_sha256": "a853e8227dba270a8a4a0c892b820e29079a7b6fb7538e738a37f665ffbc28db"
+      },
+      "input": [
+        3212836864,
+        1065353216,
+        3212836864
+      ],
+      "output": [
+        3282198056,
+        1124532224,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318592
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 1065353216,
+              "12": 3212836864
+            },
+            "instruction": 63002,
+            "target": -106
+          },
+          {
+            "args": {
+              "8": 1073741824
+            },
+            "instruction": 63066,
+            "target": -107
+          },
+          {
+            "args": {
+              "8": 3212836864,
+              "12": 1068827891
+            },
+            "instruction": 63083,
+            "target": -106
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 1065353216,
+                "12": 3212836864
+              },
+              "instruction": 63002,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 1065353216,
+                "12": 3212836864
+              },
+              "original_native_executed": false,
+              "result": 1075235812
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 1073741824
+              },
+              "instruction": 63066,
+              "target": -107
+            },
+            "effect": {
+              "input": 1073741824,
+              "root": 1068827891
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 3212836864,
+                "12": 1068827891
+              },
+              "instruction": 63083,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 3212836864,
+                "12": 1068827891
+              },
+              "original_native_executed": false,
+              "result": 3206385684
+            }
+          }
+        ],
+        "return": null,
+        "trace": null,
+        "trace_length": 129,
+        "trace_sha256": "a853e8227dba270a8a4a0c892b820e29079a7b6fb7538e738a37f665ffbc28db"
+      },
+      "input": [
+        3212836864,
+        1065353216,
+        3212836864
+      ],
+      "output": [
+        3282198056,
+        1124532224,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318608
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 3212836864,
+              "12": 3212836864
+            },
+            "instruction": 63002,
+            "target": -106
+          },
+          {
+            "args": {
+              "8": 1073741824
+            },
+            "instruction": 63066,
+            "target": -107
+          },
+          {
+            "args": {
+              "8": 1073741824,
+              "12": 1068827891
+            },
+            "instruction": 63083,
+            "target": -106
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 3212836864,
+                "12": 3212836864
+              },
+              "instruction": 63002,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 3212836864,
+                "12": 3212836864
+              },
+              "original_native_executed": false,
+              "result": 3222719460
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 1073741824
+              },
+              "instruction": 63066,
+              "target": -107
+            },
+            "effect": {
+              "input": 1073741824,
+              "root": 1068827891
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 1073741824,
+                "12": 1068827891
+              },
+              "instruction": 63083,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 1073741824,
+                "12": 1068827891
+              },
+              "original_native_executed": false,
+              "result": 1064603553
+            }
+          }
+        ],
+        "return": null,
+        "trace": null,
+        "trace_length": 129,
+        "trace_sha256": "7bba4bda416e354950733aa6d938e9e9d59feefd18c9df0510c5922b018201da"
+      },
+      "input": [
+        3212836864,
+        3212836864,
+        1073741824
+      ],
+      "output": [
+        3260739908,
+        1130430464,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318592
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 3212836864,
+              "12": 3212836864
+            },
+            "instruction": 63002,
+            "target": -106
+          },
+          {
+            "args": {
+              "8": 1073741824
+            },
+            "instruction": 63066,
+            "target": -107
+          },
+          {
+            "args": {
+              "8": 1073741824,
+              "12": 1068827891
+            },
+            "instruction": 63083,
+            "target": -106
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 3212836864,
+                "12": 3212836864
+              },
+              "instruction": 63002,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 3212836864,
+                "12": 3212836864
+              },
+              "original_native_executed": false,
+              "result": 3222719460
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 1073741824
+              },
+              "instruction": 63066,
+              "target": -107
+            },
+            "effect": {
+              "input": 1073741824,
+              "root": 1068827891
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 1073741824,
+                "12": 1068827891
+              },
+              "instruction": 63083,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 1073741824,
+                "12": 1068827891
+              },
+              "original_native_executed": false,
+              "result": 1064603553
+            }
+          }
+        ],
+        "return": null,
+        "trace": null,
+        "trace_length": 129,
+        "trace_sha256": "7bba4bda416e354950733aa6d938e9e9d59feefd18c9df0510c5922b018201da"
+      },
+      "input": [
+        3212836864,
+        3212836864,
+        1073741824
+      ],
+      "output": [
+        3260739908,
+        1130430464,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318608
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 3212836864,
+              "12": 1065353216
+            },
+            "instruction": 63002,
+            "target": -106
+          },
+          {
+            "args": {
+              "8": 1073741824
+            },
+            "instruction": 63066,
+            "target": -107
+          },
+          {
+            "args": {
+              "8": 3221225472,
+              "12": 1068827891
+            },
+            "instruction": 63083,
+            "target": -106
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 3212836864,
+                "12": 1065353216
+              },
+              "instruction": 63002,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 3212836864,
+                "12": 1065353216
+              },
+              "original_native_executed": false,
+              "result": 3209236443
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 1073741824
+              },
+              "instruction": 63066,
+              "target": -107
+            },
+            "effect": {
+              "input": 1073741824,
+              "root": 1068827891
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 3221225472,
+                "12": 1068827891
+              },
+              "instruction": 63083,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 3221225472,
+                "12": 1068827891
+              },
+              "original_native_executed": false,
+              "result": 3212087201
+            }
+          }
+        ],
+        "return": null,
+        "trace": null,
+        "trace_length": 135,
+        "trace_sha256": "138a8d4de536e2c73f90689c0cb2d004394034b86f898451127d4181f450aae5"
+      },
+      "input": [
+        1065353216,
+        3212836864,
+        3221225472
+      ],
+      "output": [
+        3281560024,
+        1134395392,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318592
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 3212836864,
+              "12": 1065353216
+            },
+            "instruction": 63002,
+            "target": -106
+          },
+          {
+            "args": {
+              "8": 1073741824
+            },
+            "instruction": 63066,
+            "target": -107
+          },
+          {
+            "args": {
+              "8": 3221225472,
+              "12": 1068827891
+            },
+            "instruction": 63083,
+            "target": -106
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 3212836864,
+                "12": 1065353216
+              },
+              "instruction": 63002,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 3212836864,
+                "12": 1065353216
+              },
+              "original_native_executed": false,
+              "result": 3209236443
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 1073741824
+              },
+              "instruction": 63066,
+              "target": -107
+            },
+            "effect": {
+              "input": 1073741824,
+              "root": 1068827891
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 3221225472,
+                "12": 1068827891
+              },
+              "instruction": 63083,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 3221225472,
+                "12": 1068827891
+              },
+              "original_native_executed": false,
+              "result": 3212087201
+            }
+          }
+        ],
+        "return": null,
+        "trace": null,
+        "trace_length": 135,
+        "trace_sha256": "138a8d4de536e2c73f90689c0cb2d004394034b86f898451127d4181f450aae5"
+      },
+      "input": [
+        1065353216,
+        3212836864,
+        3221225472
+      ],
+      "output": [
+        3281560024,
+        1134395392,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318608
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 3204448256,
+              "12": 1048576000
+            },
+            "instruction": 63002,
+            "target": -106
+          },
+          {
+            "args": {
+              "8": 1050673152
+            },
+            "instruction": 63066,
+            "target": -107
+          },
+          {
+            "args": {
+              "8": 1092616192,
+              "12": 1057954749
+            },
+            "instruction": 63083,
+            "target": -106
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 3204448256,
+                "12": 1048576000
+              },
+              "instruction": 63002,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 3204448256,
+                "12": 1048576000
+              },
+              "original_native_executed": false,
+              "result": 3213735693
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 1050673152
+              },
+              "instruction": 63066,
+              "target": -107
+            },
+            "effect": {
+              "input": 1050673152,
+              "root": 1057954749
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 1092616192,
+                "12": 1057954749
+              },
+              "instruction": 63083,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 1092616192,
+                "12": 1057954749
+              },
+              "original_native_executed": false,
+              "result": 1069672953
+            }
+          }
+        ],
+        "return": null,
+        "trace": null,
+        "trace_length": 129,
+        "trace_sha256": "7bba4bda416e354950733aa6d938e9e9d59feefd18c9df0510c5922b018201da"
+      },
+      "input": [
+        1048576000,
+        3204448256,
+        1092616192
+      ],
+      "output": [
+        3266157006,
+        1133791316,
+        0
+      ]
+    },
+    {
+      "arguments": {
+        "8": 2014318592,
+        "12": 2014318592
+      },
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 3204448256,
+              "12": 1048576000
+            },
+            "instruction": 63002,
+            "target": -106
+          },
+          {
+            "args": {
+              "8": 1050673152
+            },
+            "instruction": 63066,
+            "target": -107
+          },
+          {
+            "args": {
+              "8": 1092616192,
+              "12": 1057954749
+            },
+            "instruction": 63083,
+            "target": -106
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 3204448256,
+                "12": 1048576000
+              },
+              "instruction": 63002,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 3204448256,
+                "12": 1048576000
+              },
+              "original_native_executed": false,
+              "result": 3213735693
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 1050673152
+              },
+              "instruction": 63066,
+              "target": -107
+            },
+            "effect": {
+              "input": 1050673152,
+              "root": 1057954749
+            }
+          },
+          {
+            "call": {
+              "args": {
+                "8": 1092616192,
+                "12": 1057954749
+              },
+              "instruction": 63083,
+              "target": -106
+            },
+            "effect": {
+              "modeled_atan2": {
+                "8": 1092616192,
+                "12": 1057954749
+              },
+              "original_native_executed": false,
+              "result": 1069672953
+            }
+          }
+        ],
+        "return": null,
+        "trace": null,
+        "trace_length": 129,
+        "trace_sha256": "7bba4bda416e354950733aa6d938e9e9d59feefd18c9df0510c5922b018201da"
+      },
+      "input": [
+        1048576000,
+        3204448256,
+        1092616192
+      ],
+      "output": [
+        3266157006,
+        1133791316,
+        0
+      ]
+    }
+  ],
+  "sha256": "a589351dfe517470a1b121dd2164714987d9e4577bf00c6486e1540035d7a79d",
+  "source": {
+    "archive": "zUrT43_qvm.pk3",
+    "archive_sha256": "b59bf0c5bedf11d50e0edd220da7eade96de40601e98ae14c54c819047df0796",
+    "member": {
+      "bytes": 983300,
+      "comment_hex": "",
+      "compressed_bytes": 246560,
+      "compression": 8,
+      "crc32": "98ea1768",
+      "create_system": 0,
+      "create_version": 63,
+      "date_time": [
+        2018,
+        6,
+        18,
+        22,
+        11,
+        50
+      ],
+      "directory": false,
+      "entry_index": 2,
+      "external_attr": 32,
+      "extra_hex": "0a0020000000000001001800d1e24e974007d40116dcbf962f1fd20116dcbf962f1fd201",
+      "extract_version": 20,
+      "flags": 0,
+      "header_offset": 221309,
+      "internal_attr": 0,
+      "occurrence": 0,
+      "output": "assets/extracted/zUrT43_qvm.pk3/members/000002/vm/qagame.qvm",
+      "path": "vm/qagame.qvm",
+      "sha256": "a589351dfe517470a1b121dd2164714987d9e4577bf00c6486e1540035d7a79d",
+      "type": "member",
+      "volume": 0
+    }
+  }
+}

scripts/analyze_qvm_vector_angles.py

@@ -0,0 +1,27 @@
+#!/usr/bin/env python3
+"""Complete62944 vector-to-angle helper with finite explicit atan2/sqrt models."""
+import math,itertools
+from pathlib import Path
+from qvm_research_support import source,execute
+from analyze_qvm_acceleration import word,number
+from analyze_qvm_slide_prefix import vec
+from analyze_qvm import write_json
+LOCAL=0x78100000
+INPUT=LOCAL+4096
+OUTPUT=INPUT+16
+
+def vector_angles(ins,m,args):
+    m=dict(m);before=vec(m,args[8])
+    for o,v in args.items():m[LOCAL+48+o]=v
+    def atan(i,m,a,c):
+        result=word(math.atan2(number(a[8]),number(a[12])));return m,c,result,{'modeled_atan2':a,'result':result,'original_native_executed':False}
+    m,_,e=execute(ins,62945,63120,m,(0,0,0),LOCAL,{-106:atan})
+    return m,{'arguments':args,'input':before,'output':vec(m,args[12]),'execution':e}
+
+def main():
+    q,raw,h,ins=source();rows=[]
+    inputs=[(0,0,0),(0,0,1),(0,0,-1),(1,0,0),(-1,0,0),(0,1,0),(0,-1,0),(1,1,1),(-1,1,-1),(-1,-1,2),(1,-1,-2),(.25,-.5,10)]
+    for values,alias in itertools.product(inputs,[False,True]):
+        m={INPUT+4*j:word(v) for j,v in enumerate(values)};rows.append(vector_angles(ins,m,{8:INPUT,12:INPUT if alias else OUTPUT})[1])
+    write_json(Path('docs/research/qvm-vector-angles.json'),{'source':q['source'],'sha256':q['sha256'],'probes':rows,'limits':'Actual62945–63119, finite math.atan2/sqrt responses rounded tofloat32. Native library bit parity, partial overlaps and live domain remain unverified. Zero input follows the source vertical fallback.'})
+if __name__=='__main__':main()

scripts/test_qvm_vector_angles.py

@@ -0,0 +1,28 @@
+import json,unittest,math
+from pathlib import Path
+from test_qvm_ground import word,n,f
+
+def expected(values):
+    x,y,z=map(n,values)
+    if x==0 and y==0:yaw=0;pitch=90 if z>0 else 270
+    else:
+        yaw=f(f(math.atan2(y,x))*n(1113927393)) if x else (90 if y>0 else 270)
+        if yaw<0:yaw=f(yaw+360)
+        length=f(math.sqrt(f(f(x*x)+f(y*y))));pitch=f(f(math.atan2(z,length))*n(1113927393))
+        if pitch<0:pitch=f(pitch+360)
+    return [word(-pitch),word(yaw),0]
+class VectorAngleTests(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):cls.rows=json.loads(Path('docs/research/qvm-vector-angles.json').read_text())['probes']
+    def test_independent_float32_outputs(self):
+        self.assertEqual(len(self.rows),24)
+        for p in self.rows:self.assertEqual(p['output'],expected(p['input']))
+    def test_exact_alias_matches_distinct_output(self):
+        for a,b in zip(self.rows[::2],self.rows[1::2]):self.assertEqual(a['input'],b['input']);self.assertEqual(a['output'],b['output'])
+    def test_zero_vector_vertical_fallback(self):
+        for p in self.rows:
+            if p['input']==[0,0,0]:self.assertEqual(p['output'],[word(-270),0,0]);self.assertEqual(p['execution']['calls'],[])
+    def test_reached_native_order(self):
+        for p in self.rows:
+            x,y,z=map(n,p['input']);expected_calls=[] if not x and not y else (([-106] if x else [])+[-107,-106]);self.assertEqual([c['target'] for c in p['execution']['calls']],expected_calls)
+if __name__=='__main__':unittest.main()