feat(tools): humanize tap coordinates; default off in tests

tests/test_tap_humanize.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+from device.manager import DeviceManager
+from tests.fakes import FakeDriver
+
+
+def _connected(driver: FakeDriver) -> DeviceManager:
+    manager = DeviceManager()
+    manager.register_device("phone", lambda: driver)
+    manager.connect("phone", max_retries=1)
+    return manager
+
+
+def test_tap_default_off_in_tests_passes_exact(monkeypatch):
+    # Autouse conftest fixture sets APEX_HUMANIZE_ENABLED=false; reaffirm here.
+    monkeypatch.setenv("APEX_HUMANIZE_ENABLED", "false")
+    from tools.tap import tap
+
+    driver = FakeDriver()
+    tap(10, 20, manager=_connected(driver))
+    assert driver.calls[-1] == ("tap", (10, 20))
+
+
+def test_tap_enabled_jitters_within_radius(monkeypatch):
+    import random
+
+    monkeypatch.setenv("APEX_HUMANIZE_ENABLED", "true")
+    from tools.humanize import set_rng
+    from tools.tap import tap
+
+    set_rng(random.Random(11))
+    try:
+        driver = FakeDriver()
+        tap(10, 20, manager=_connected(driver))
+    finally:
+        set_rng(None)
+    px, py = driver.calls[-1][1]
+    assert abs(px - 10) <= 5.0 and abs(py - 20) <= 5.0