feat(clock): add clock package for testable time

Add a Clock interface and default real-clock implementation so production code can use clock.Now() instead of time.Now(), and tests can inject a fake clock for deterministic timeouts and scheduling.

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
This commit is contained in:
2026-06-24 23:42:41 +01:00
co-authored by Sisyphus
parent d71373c7f2
commit 6ec2cf1d69
2 changed files with 34 additions and 0 deletions
+10
View File
@@ -0,0 +1,10 @@
package clock
import "time"
// Now returns the current UTC time, used everywhere for wall-clock consistency.
// All scheduling comparisons, timestamp recording, and duration calculations use
// this function so they're consistent with the database (TIMESTAMPTZ in UTC).
func Now() time.Time {
return time.Now().UTC()
}