diff --git a/bitchat/Utils/PeopleNameFilter.swift b/bitchat/Utils/PeopleNameFilter.swift
index 3e3fafdd..0a10fe7d 100644
--- a/bitchat/Utils/PeopleNameFilter.swift
+++ b/bitchat/Utils/PeopleNameFilter.swift
@@ -9,6 +9,9 @@
 import Foundation
 
 /// Case-insensitive nickname / display-name match for the people sheet search field.
+///
+/// Filtering is display-only: callers never mutate `PeerListModel` row order.
+/// Clearing the query restores the full list with existing sticky ordering.
 enum PeopleNameFilter {
     /// Empty / whitespace-only queries match everything (no filter active).
     static func matches(_ displayName: String, query: String) -> Bool {