buds Phase 2: top-3 username|email autocomplete on #id_recipient (post share + my_buds add); implicit symmetric auto-add on share_post (sharer ↔ recipient buds graph); recipient field accepts username OR email — TDD

- billboard.views.search_buds(GET /billboard/buds/search?q=...) — top-3 prefix match against request.user.buds via Q(username__istartswith) | Q(email__istartswith). Returns {buds: [{id, username, email}]}. Privacy: only the user's own buds are searched, no leak of strangers.
  - _resolve_recipient(raw) helper resolves a free-form recipient (email if "@" present, else username, both case-insensitive). Wired into add_bud + share_post so #id_recipient accepts either form.
  - share_post implicit auto-add (per-spec): when recipient is registered + first-time-shared, both directions of buds M2M get the link — request.user.buds.add(recipient) AND recipient.buds.add(request.user). Idempotent, no auto-add on reshare/self/unregistered.
  - new bud-autocomplete.js shared module (apps/billboard/static/apps/billboard/) — bindBudAutocomplete(input, suggestionsEl, {searchUrl}). Mirrors sky.html birth-place picker: 250ms debounced fetch from MIN_CHARS=1, click-to-fill, Escape closes, click-outside closes, late-response drop. e.stopPropagation on suggestion-click so the bud-panel's outside-click handler doesn't fire and clear the input.
  - SCSS .bud-suggestions / .bud-suggestion-item mirrors .sky-suggestions but position:fixed bottom:4rem (aligned above the bud panel, with overflow:hidden on the panel forcing the dropdown to live as a sibling rather than a child). Landscape breakpoints clear the navbar/footer 4rem sidebars, 8rem at min-width 1800px.
  - both _bud_panel.html (post share) + _bud_add_panel.html (my_buds add) get the suggestions div sibling + script tags. Each panel's existing document click-outside handler now skips the suggestions container so a click inside doesn't close+clear. type="email" → type="text" since usernames are accepted; placeholder "friend@example.com or username".
  - new test classes in test_buds.py: SearchBudsViewTest (6 — prefix match, cap-3, email prefix, non-bud leakproof, empty-q, anon redirect) + SharePostImplicitAutoAddTest (4 — sharer.buds += recipient, recipient.buds += sharer, username-typed share, unregistered no-add) + AddBudViewTest.test_add_resolves_username_too. test_my_buds.py FT adds test_autocomplete_suggests_buds_by_username_prefix. test_sharing.py placeholder assertion updated to "friend@example.com or username".
  - 852 ITs (+11) + 5 my_buds FTs green.

Code architected by Disco DeDisco <discodedisco@outlook.com>
Git commit message Co-Authored-By:
Claude Opus 4.7 (1M context) <noreply@anthropic.com>

src/functional_tests/test_my_buds.py

@@ -57,6 +57,31 @@ class MyBudsPageTest(FunctionalTest):
             self.alice, list(self.gamer.buds.all())
         ))
 
+    def test_autocomplete_suggests_buds_by_username_prefix(self):
+        """Phase 2: typing in #id_recipient pulls top-3 prefix matches from
+        request.user.buds and renders them as .bud-suggestion-item buttons.
+        Click → input.value fills with the bud's username (or email if the
+        user typed an `@` already)."""
+        self.gamer.buds.add(self.alice)
+        bob = User.objects.create(email="bob@test.io", username="bob")
+        self.gamer.buds.add(bob)
+
+        self.browser.get(self.live_server_url + "/billboard/my-buds/")
+        btn = self.wait_for(lambda: self.browser.find_element(By.ID, "id_bud_btn"))
+        btn.click()
+        recipient = self.wait_for(lambda: self.browser.find_element(By.ID, "id_recipient"))
+        recipient.send_keys("al")
+
+        suggestions = self.wait_for(lambda: self.browser.find_element(
+            By.CSS_SELECTOR, "#id_bud_suggestions .bud-suggestion-item"
+        ))
+        self.assertEqual(suggestions.text.strip(), "alice")
+
+        suggestions.click()
+        self.wait_for(lambda: self.assertEqual(
+            recipient.get_attribute("value"), "alice"
+        ))
+
     def test_add_unregistered_email_is_silent_noop(self):
         self.browser.get(self.live_server_url + "/billboard/my-buds/")
         btn = self.wait_for(lambda: self.browser.find_element(By.ID, "id_bud_btn"))

src/functional_tests/test_sharing.py

@@ -41,7 +41,7 @@ class SharingTest(FunctionalTest):
         share_box = post_page.get_share_box()
         self.assertEqual(
             share_box.get_attribute("placeholder"),
-            "friend@example.com",
+            "friend@example.com or username",
         )
 
         post_page.share_post_with("alice@test.io")