From 55676a35757bcbf2fa40cc3fd144ba412c65b658 Mon Sep 17 00:00:00 2001
From: Runxi Yu
Date: Tue, 9 Jun 2026 05:15:58 +0000
Subject: internal/cache: add (and move clock to internal/cache/clock)

---
 internal/cache/clock/doc.go | 9 +++++++++
 1 file changed, 9 insertions(+)
 create mode 100644 internal/cache/clock/doc.go

(limited to 'internal/cache/clock/doc.go')

diff --git a/internal/cache/clock/doc.go b/internal/cache/clock/doc.go
new file mode 100644
index 00000000..6f28805b
--- /dev/null
+++ b/internal/cache/clock/doc.go
@@ -0,0 +1,9 @@
+// Package clock provides a concurrent, weight-bounded object cache.
+//
+// The cache is sharded by key,
+// and each shard owns an independent fraction of the total budget.
+// An entry heavier than that per-shard fraction is never admitted,
+// so callers should keep the total budget well above the largest value.
+//
+// Labels: MT-Safe.
+package clock
-- 
cgit v1.3.1-10-gc9f91