Commit
fc23c4e8ac43ec2816a6d93329dd9b84ddf22f6b
("extent-layer: stop dedupe from leaving refs that describe other extents")
added the counter without an entry in docs/event-counters.md.
Assisted-by: Claude-Code:claude-opus-5-5
* `readahead_skip`: Number of times a duplicate read was identified in the cache and skipped.
* `readahead_unread_ms`: Total time spent running `posix_fadvise(..., POSIX_FADV_DONTNEED)`.
+ref
+---
+
+The `ref` event group consists of events related to individual references in an extent node's reference list.
+
+ * `ref_foreign`: A reference's file offset now maps to a different extent than the one whose reference list contains it, typically because a dedupe redirected the range after the list was built. The reference's geometry is left undetermined, so callers treat it as absent.
+
refs
----