fix: timer precision and test sensitivity

Author: AndreRatzenberger

src/flock/components/orchestrator/scheduling/timer.py

@@ -283,10 +283,10 @@ def _calculate_next_fire_time(
                 target = now.replace(
                     hour=spec.at.hour,
                     minute=spec.at.minute,
-                    second=spec.at.second if spec.at.second else 0,
+                    second=spec.at.second,
                     microsecond=0,
                 )
-                if target <= now:
+                if target < now.replace(microsecond=0):
                     # Time passed today, schedule for tomorrow
                     target += timedelta(days=1)
                 return target
@@ -343,14 +343,15 @@ async def _wait_for_next_fire(self, spec: ScheduleSpec) -> None:
                 target = now.replace(
                     hour=spec.at.hour,
                     minute=spec.at.minute,
-                    second=spec.at.second if spec.at.second else 0,
+                    second=spec.at.second,
                     microsecond=0,
                 )
-                if target <= now:
+                if target < now.replace(microsecond=0):
                     # Time passed today, schedule for tomorrow
                     target += timedelta(days=1)
                 seconds_until = (target - now).total_seconds()
-                await asyncio.sleep(seconds_until)
+                if seconds_until > 0:
+                    await asyncio.sleep(seconds_until)
 
             elif isinstance(spec.at, datetime):
                 # One-time scheduling: wait until specific datetime

tests/test_timer_component.py

@@ -582,8 +582,8 @@ async def test_wait_for_next_fire_time_future_today(self):
         elapsed = (datetime.now(UTC) - start).total_seconds()
 
         # Assert - Should sleep for approximately the expected wait time
-        # Allow 0.1s tolerance for execution overhead
-        assert elapsed >= expected_wait - 0.1
+        # Allow 0.5s tolerance for execution overhead and timing variance in CI
+        assert elapsed >= expected_wait - 0.5
         assert elapsed < expected_wait + 0.5
 
     @pytest.mark.asyncio