From 779b4f100d2a02b3d135aad24b9ad4ec9f80e60d Mon Sep 17 00:00:00 2001
From: Runxi Yu
Date: Sat, 21 Feb 2026 11:37:45 +0800
Subject: ref: Note that the Peeled field is optional

---
 ref/ref.go | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/ref/ref.go b/ref/ref.go
index 9d1fbfc2..28b90ae6 100644
--- a/ref/ref.go
+++ b/ref/ref.go
@@ -17,6 +17,9 @@ type Detached struct {
 	ID      objectid.ObjectID
 
 	// Peeled is the peeled target when available (for annotated tags).
+	//
+	// This field is optional backend-provided metadata. Backends that do not
+	// have peel metadata available may leave it nil.
 	Peeled *objectid.ObjectID
 }
 
-- 
cgit v1.3.1-10-gc9f91