fix: prevent false timeout failures and release 1.2.2

tests/unit/runtime/test_awake_lease.py

@@ -13,6 +13,8 @@
 # limitations under the License.
 
 import json
+from pathlib import Path
+import time
 
 import pytest
 
@@ -126,3 +128,30 @@ def test_migration_cleanup_never_drains_a_live_legacy_owner(monkeypatch):
     cleanup._drain_references = lambda: pytest.fail("must not drain a live owner")
 
     assert cleanup.cleanup_unowned_references() is False
+
+
+def test_optional_cleanup_skips_a_busy_mutex_without_delaying_task_start(monkeypatch):
+    owner = ScreenAwakeLease("device-123")
+    owner.mutex_path.write_text(json.dumps(owner._payload()), encoding="utf-8")
+    cleanup = ScreenAwakeLease("device-123")
+    monkeypatch.setattr(cleanup, "_drain_references", lambda: pytest.fail("must not drain"))
+
+    started_at = time.monotonic()
+    assert cleanup.cleanup_unowned_references() is False
+    assert time.monotonic() - started_at < 2.0
+
+
+def test_unremovable_stale_mutex_still_obeys_deadline(monkeypatch):
+    lease = ScreenAwakeLease("device-123")
+    lease.mutex_path.write_text(json.dumps({"pid": 999999}), encoding="utf-8")
+    original_unlink = Path.unlink
+
+    def refuse_mutex_unlink(path, *args, **kwargs):
+        if path == lease.mutex_path:
+            raise PermissionError("file is in use")
+        return original_unlink(path, *args, **kwargs)
+
+    monkeypatch.setattr(Path, "unlink", refuse_mutex_unlink)
+    with pytest.raises(TimeoutError, match="awake-lease mutex"):
+        with lease._mutex(wait_timeout_seconds=0.1):
+            pytest.fail("stale mutex must not be acquired")

tests/unit/runtime/test_awake_service.py

@@ -1,3 +1,4 @@
+import os
 from unittest.mock import MagicMock, patch
 
 from artemis.runtime.awake_service import (
@@ -37,6 +38,22 @@ def test_usb_policy_is_primary_when_android_reports_it_active(mock_run, lease_ty
     assert not any("KEYCODE_UNKNOWN" in command for command in commands)
 
 
+@patch.dict(os.environ, {"ARTEMIS_TASK_WORKER": "1"})
+@patch("artemis.runtime.awake_service.ScreenAwakeLease")
+@patch("artemis.runtime.awake_service.subprocess.run")
+def test_queued_worker_does_not_run_optional_legacy_cleanup(mock_run, lease_type):
+    mock_run.side_effect = [
+        completed(),
+        completed(),
+        completed(),
+        completed("2\n"),
+        completed("  mStayOn=true\n"),
+    ]
+
+    assert _configure_usb_stay_awake("device-123") == AWAKE_STRATEGY_USB
+    lease_type.assert_not_called()
+
+
 @patch("artemis.runtime.awake_service.ScreenAwakeLease")
 @patch("artemis.runtime.awake_service.subprocess.run")
 def test_inactive_usb_policy_falls_back_to_effective_host_heartbeat(mock_run, _lease_type):