Document the serialised-writer invariant behind the repodata fingerprint

2026-10-25 20:27:27 +11:00
parent 5f33abba93
commit 9fb44c22d6
2 changed files with 4 additions and 1 deletions
@@ -42,6 +42,7 @@ func (db *DB) DeleteRPMMetadata(ctx context.Context, repoName, filePath string)

 // RPMMetadataFingerprint is a cheap change detector for a repo's rows: they are
 // only ever inserted or deleted, so (count, max id) moves whenever they change.
+// Sound only while a remote's writers are serialised (github_rpm sync lease), so ids commit in order.
 func (db *DB) RPMMetadataFingerprint(ctx context.Context, repoName string) (count, maxID int64, err error) {
 	err = db.Pool.QueryRow(ctx, `SELECT count(*), coalesce(max(id), 0) FROM rpm_metadata WHERE repo_name = $1`, repoName).Scan(&count, &maxID)
 	return count, maxID, err