From d38efc04211ff148f8b3cbb3cf38bf57f5f763d6 Mon Sep 17 00:00:00 2001
From: Jack Kingsman <jack.kingsman@gmail.com>
Date: Wed, 11 Mar 2026 18:45:03 -0700
Subject: [PATCH] Add warning on search for user-key linkage unreliability

---
 frontend/src/components/SearchView.tsx | 5 +++++
 frontend/src/test/searchView.test.tsx  | 3 +++
 2 files changed, 8 insertions(+)

diff --git a/frontend/src/components/SearchView.tsx b/frontend/src/components/SearchView.tsx
index 20e8538..72c108a 100644
--- a/frontend/src/components/SearchView.tsx
+++ b/frontend/src/components/SearchView.tsx
@@ -243,6 +243,11 @@ export function SearchView({
               Tip: use <code>user:</code> or <code>channel:</code> for keys or names, and wrap names
               with spaces in them in quotes.
             </p>
+            <p className="mt-2 text-xs">
+              Warning: User-key linkage for group messages is best-effort and based on correlation
+              at advertise time. It does not account for multiple users with the same name, and
+              should be considered unreliable.
+            </p>
           </div>
         )}
 
diff --git a/frontend/src/test/searchView.test.tsx b/frontend/src/test/searchView.test.tsx
index e29e8bb..b11f345 100644
--- a/frontend/src/test/searchView.test.tsx
+++ b/frontend/src/test/searchView.test.tsx
@@ -71,6 +71,9 @@ describe('SearchView', () => {
     render(<SearchView {...defaultProps} />);
     expect(screen.getByText('Type to search across all messages')).toBeInTheDocument();
     expect(screen.getByText(/Tip: use/i)).toBeInTheDocument();
+    expect(
+      screen.getByText(/User-key linkage for group messages is best-effort/i)
+    ).toBeInTheDocument();
   });
 
   it('focuses input on mount', () => {