From 607bcd7a105864a7a4b92af213ffcf3cbf3a5810 Mon Sep 17 00:00:00 2001
From: Runxi Yu
Date: Sat, 21 Feb 2026 11:37:55 +0800
Subject: refstore: ResolveFully doesn't inherently peel annotated tags

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

(limited to 'refstore')

diff --git a/refstore/refstore.go b/refstore/refstore.go
index 5653d4ca..1de039f4 100644
--- a/refstore/refstore.go
+++ b/refstore/refstore.go
@@ -24,6 +24,9 @@ type Store interface {
 	// Implementations may use backend-local lookup semantics for symbolic hops.
 	// Callers that need cross-backend symbolic resolution (for example in a
 	// chain of stores) should prefer repeatedly calling Resolve.
+	//
+	// ResolveFully resolves symbolic references only. It does not imply peeling
+	// annotated tag objects.
 	ResolveFully(name string) (ref.Detached, error)
 	// List returns references matching pattern.
 	//
-- 
cgit v1.3.1-10-gc9f91