/.claude/rules/timing.md

paths

paths
src/**/*.{cc,h}

• Excluding the Clock implementation and benchmarks, read the current time only through an injected ray::ClockInterface (src/ray/util/clock.h) so time can be faked and unit tested deterministically. Do not call absl::Now(), std::chrono::{system,steady,high_resolution}_clock::now(), or other similar functions.
• Inject ClockInterface &clock_ via the constructor. Pass a Clock from the production entrypoint (e.g. raylet/main.cc) and a FakeClock in tests. Declare the concrete clock member before any object that holds a ClockInterface & so it is constructed first and outlives the holder.
• Use clock_.Now() / clock_.NowUnixMillis() for wall-clock timestamps and deadlines, and clock_.SteadyNow() for elapsed/duration measurements
• In unit tests use FakeClock::AdvanceTime/SetTime instead of sleep or wall-clock time. Ensure that the tests are written to be fast and deterministic.