feat: presence fix, voice ringing fix, user private notes + doc updates

- usePresenceUpdater: replace stale closure with readStatus() called at
  invocation time so changing custom status in Profile Settings is never
  silently overwritten by subsequent activity events
- CallEmbedProvider: fix m.space.parent state-key lookup by switching
  getStateEvent → getStateEvents (plural); space channel voice rooms no
  longer trigger the incoming-call ring/animation
- Add useUserNotes hook (io.lotus.user_notes account data, reactive via
  useAccountDataCallback, 500-char limit, cross-device sync)
- UserRoomProfile: add UserPrivateNotes textarea with 800ms debounced
  auto-save, saving indicator, char counter when <100 chars remain;
  shown only when viewing another user's profile
- LOTUS_FEATURES.md: add Private Notes section, Status Revert fix note,
  animation improvements subsection, Seasonal Themes section
- LOTUS_BUGS.md: mark presence revert + voice ringing bugs as resolved
- README.md + landing/index.html: document all new June 2026 features

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

LOTUS_FEATURES.md

@@ -10,20 +10,21 @@ Last updated: June 2026.
 1. [Branding & Identity](#branding--identity)
 2. [LotusGuild Terminal Design System (TDS) v1.2](#lotusguild-terminal-design-system-tds-v12)
 3. [Animated Chat Backgrounds (P5-4)](#animated-chat-backgrounds-p5-4)
-4. [Glassmorphism Sidebar (P5-3)](#glassmorphism-sidebar-p5-3)
-5. [Night Light / Blue Light Filter (P5-5)](#night-light--blue-light-filter-p5-5)
-6. [Voice / Video Call Improvements](#voice--video-call-improvements)
-7. [Per-Message Read Receipts](#per-message-read-receipts)
-8. [Delivery Status Indicators](#delivery-status-indicators)
-9. [Messaging Enhancements](#messaging-enhancements)
-10. [Presence](#presence)
-11. [UX & Composer](#ux--composer)
-12. [Room Customization](#room-customization)
-13. [Moderation](#moderation)
-14. [Notifications](#notifications)
-15. [Server Integration](#server-integration)
-16. [Infrastructure](#infrastructure)
-17. [Key Custom Files](#key-custom-files)
+4. [Seasonal Theme Overlays (P5-12)](#seasonal-theme-overlays-p5-12)
+5. [Glassmorphism Sidebar (P5-3)](#glassmorphism-sidebar-p5-3)
+6. [Night Light / Blue Light Filter (P5-5)](#night-light--blue-light-filter-p5-5)
+7. [Voice / Video Call Improvements](#voice--video-call-improvements)
+8. [Per-Message Read Receipts](#per-message-read-receipts)
+9. [Delivery Status Indicators](#delivery-status-indicators)
+10. [Messaging Enhancements](#messaging-enhancements)
+11. [Presence](#presence)
+12. [UX & Composer](#ux--composer)
+13. [Room Customization](#room-customization)
+14. [Moderation](#moderation)
+15. [Notifications](#notifications)
+16. [Server Integration](#server-integration)
+17. [Infrastructure](#infrastructure)
+18. [Key Custom Files](#key-custom-files)
 
 ---
 
@@ -148,6 +149,16 @@ Strips all `animation` properties from the returned style object when either `pa
 
 A "Pause Background Animations" toggle is exposed in **Settings → Appearance**. The preference is persisted and read by `getChatBg()` at render time.
 
+### Animation Improvements (June 2026)
+
+All five animated backgrounds were rewritten for smoother, more organic motion:
+
+- **Digital Rain** — added a phosphor glow flicker (`animRainGlowKeyframe`, 2.1 s) layered on top of the column scroll; stripe opacity increased for better visibility
+- **Star Drift** — each of the three dot layers now moves by exactly its own tile width/height per cycle (`−130 px`, `−190 px`, `−260 px`), eliminating the visible seam on loop
+- **Grid Pulse** — independent brightness oscillation (`animGridBrightnessKeyframe`, 3.3 s) runs alongside the size breathe (4 s) at a prime period ratio so they never synchronise
+- **Aurora Flow** — four gradient layers now have individual `backgroundSize` values (`200%`, `250%`, `300%`, `220%`); the keyframe drives each layer through a distinct 5-stop path, replacing the robotic single back-and-forth
+- **Fireflies** — glow pulse (`animFirefliesGlowKeyframe`, 2.3 s `filter: brightness`) and opacity blink (`animFirefliesBlinkKeyframe`, 1.7 s) added on top of the position drift; prime periods create unsynchronised bioluminescence
+
 ### Files
 
 - `src/app/styles/Animations.css.ts` — vanilla-extract keyframe definitions
@@ -155,6 +166,40 @@ A "Pause Background Animations" toggle is exposed in **Settings → Appearance**
 
 ---
 
+## Seasonal Theme Overlays (P5-12)
+
+Decorative CSS-only overlays that activate automatically on holidays and events. Manually overrideable in **Settings → Appearance → Seasonal Theme**.
+
+### Themes
+
+| Theme | Window | Effect |
+|---|---|---|
+| 🎆 New Year | Dec 31–Jan 2 | Radial firework bursts in gold, red, cyan, purple; gold shimmer sweep |
+| 🏮 Lunar New Year | Jan 22–Feb 5 | Floating paper lanterns bobbing; silk texture; gold shimmer accent |
+| 💖 Valentine's Day | Feb 10–15 | ♥ hearts floating upward; soft pink ambient glow |
+| 🍀 St. Patrick's Day | Mar 15–18 | ☘ clovers drifting down; gold metallic shimmer top border |
+| 🃏 April Fool's | Apr 1 | Glitch overlay: RGB channel separation, hue-rotate spikes, scanline sweep, "SIGNAL LOST" watermark |
+| 🌱 Earth Day | Apr 20–23 | 🌿🍃 leaf emoji drift; sage green ambient tint; vine accent on left edge |
+| 🍂 Autumn | Sep 21–Oct 31 | Warm orange/amber leaf shapes rotating and falling |
+| 👾 Arcade Day | Sep 12 | CRT scanlines; blinking pixel corner decorations; "INSERT COIN" prompt |
+| 🚀 Deep Space Week | Oct 4–10 | Warp-speed star streaks radiating from screen centre; nebula purple/blue ambient |
+| 🎃 Halloween | Oct 15–Nov 1 | Purple and orange glowing particles; SVG spider web in top-left corner; dark purple tint |
+| ❄️ Christmas | Dec 10–Jan 2 | White dot snowfall in multiple layers at varied speeds |
+
+### Implementation
+
+- `SeasonalEffect` component mounted in `App.tsx` at `z-index: 9997` (below night light, above content)
+- Auto-detection via `getActiveSeason(now: Date)` — themes checked in priority order (New Year > Valentine's > … > Autumn)
+- `seasonalThemeOverride` setting: `'auto' | 'off' | <theme-name>` — persisted in `settingsAtom`
+- All particle animations gated on `prefers-reduced-motion: reduce` — ambient overlays (tints, textures, shimmer) remain active
+
+### Files
+
+- `src/app/components/seasonal/SeasonalEffect.tsx` — theme detection, date ranges, all overlay components
+- `src/app/components/seasonal/Seasonal.css.ts` — vanilla-extract keyframes (fall, leaf, float-up, bob, glitch, burst, warp, scanline, shimmer, etc.)
+
+---
+
 ## Glassmorphism Sidebar (P5-3)
 
 An optional frosted-glass sidebar style toggled in **Settings → Appearance**.
@@ -538,6 +583,12 @@ Applied in:
 - `@mention` autocomplete dropdown
 - Inbox / notifications panel
 
+### Status Revert Bug Fix (June 2026)
+
+`usePresenceUpdater` previously captured the user's custom status message once via `localStorage.getItem` at effect initialization. When the user changed their status message in Profile Settings, subsequent automatic transitions back to `online` (e.g., returning from idle) would silently broadcast the old status message, reverting the custom status.
+
+Fixed by replacing the single read with a `readStatus()` function called inside every `setOnline` and `setUnavailable` invocation, so the current localStorage value is always used.
+
 ### Document Title Unread Count
 
 The browser tab title updates to reflect unread state:
@@ -565,6 +616,18 @@ When a user has `m.tz` set in their profile:
 
 Hook: `src/app/hooks/useLocalTime.ts`
 
+### User-to-User Private Notes (P5-34)
+
+A private text note on any user's profile, visible only to the logged-in user and synced across all their devices.
+
+- Textarea in the user profile popout (below device sessions), shown only when viewing another user — never on your own profile
+- Auto-saves 800 ms after the last keystroke with a "Saving…" indicator
+- Character counter appears when fewer than 100 characters remain (max 500)
+- Stored in `io.lotus.user_notes` account data as `{ [userId]: string }` — deletes the key when the note is cleared
+- Reactive: updates immediately if account data arrives from another device mid-session
+
+Hook: `src/app/hooks/useUserNotes.ts`
+
 ---
 
 ## UX & Composer