From afd58b4e5882402d606728e4f2ee8e5cb2354939 Mon Sep 17 00:00:00 2001
From: Runxi Yu
Date: Sun, 22 Mar 2026 23:24:18 +0000
Subject: refstore: Update invariants

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

(limited to 'refstore/reading.go')

diff --git a/refstore/reading.go b/refstore/reading.go
index 98a5bd51..3444f07f 100644
--- a/refstore/reading.go
+++ b/refstore/reading.go
@@ -7,7 +7,7 @@ type ReadingStore interface {
 	// Resolve resolves a reference name to either a symbolic or detached ref.
 	//
 	// Implementations should return value forms (ref.Detached or ref.Symbolic),
-	// not pointer forms.
+	// not pointer forms. Returned refs do not borrow the store.
 	// If the reference does not exist, implementations should return
 	// ErrReferenceNotFound.
 	Resolve(name string) (ref.Ref, error)
@@ -26,6 +26,8 @@ type ReadingStore interface {
 	List(pattern string) ([]ref.Ref, error)
 	// Close releases resources associated with the store.
 	//
+	// Transactions and batches borrowing the store are invalid after Close.
+	//
 	// Repeated calls to Close are undefined behavior unless the implementation
 	// explicitly documents otherwise.
 	Close() error
-- 
cgit v1.3.1-10-gc9f91