From d314d1f7e933ca83081eec289aa0cb6e75a7eeac Mon Sep 17 00:00:00 2001
From: Runxi Yu
Date: Sun, 22 Mar 2026 17:33:27 +0000
Subject: objectstore{,/packed}: Document lifetime and integrity behavior

---
 objectstore/packed/read_size.go | 4 ++++
 1 file changed, 4 insertions(+)

(limited to 'objectstore/packed/read_size.go')

diff --git a/objectstore/packed/read_size.go b/objectstore/packed/read_size.go
index 8581b01b..4afa6fed 100644
--- a/objectstore/packed/read_size.go
+++ b/objectstore/packed/read_size.go
@@ -9,6 +9,10 @@ import (
 )
 
 // ReadSize reads an object's declared content size.
+//
+// Like ReadHeader, it resolves header metadata only. It does not verify that
+// the full pack entry payload is readable and does not verify any zlib
+// Adler-32 trailer for compressed entry data.
 func (store *Store) ReadSize(id objectid.ObjectID) (int64, error) {
 	loc, err := store.lookup(id)
 	if err != nil {
-- 
cgit v1.3.1-10-gc9f91