add fixes to claims and seasons

AGENTS.md

@@ -60,13 +60,24 @@
 
 ## Data Flow
 
+### Reads (both roles)
+- **Parent (admin):** `famStore.init()` fetches all collections via PB SDK (authenticated via `pb_token` cookie).
+- **Child (member):** `famStore.init()` fetches all collections via PB SDK — **unauthenticated/anonymous**. All family-scoped collections have public `listRule` / `viewRule` (empty string = allow all), so reads work without any auth. PB SDK `.subscribe()` also works anonymously for public collections.
+- **TopNav season pills:** Read from `famStore.seasons` — reactive, no extra fetches needed.
+
+### Writes (both roles go through Hono proxy)
 - **Chore toggle:** Browser → Hono proxy → PB (auth via device token or admin JWT)
-- **Admin CRUD:** Browser → Hono proxy → PB (admin JWT)
+- **Admin CRUD:** Form actions → Hono proxy → PB (admin JWT via `sessionHeaders`)
+- **Member updates:** Browser → Hono proxy → PB (auth via `x-device-token` + `x-device-famid`)
 - **Reward creation:** After completion toggle, Hono proxy creates reward if threshold met
 - **Weekly CRON:** Coolify → `GET /api/weekly-cron` on Hono → Hono queries PB, computes summaries, upserts weekly_history
 - **Stripe donate:** Browser → Hono `/api/stripe/create-checkout` → Stripe → Hono webhook → update fam
 - **WhatsApp:** Deferred — Hono CRON handler has pluggable notification interface
-- **UI reactivity:** Svelte `$state` / `$derived` / `$effect` — no PB SDK `.subscribe()` / SSE
+
+### UI reactivity
+- Svelte `$state` / `$derived` / `$effect`
+- PB SDK `.subscribe()` for realtime multi-user sync (public reads → works for both roles)
+- `famStore.applyRecord()` for instant optimistic UI feedback from form actions
 
 ## Env Vars (SvelteKit 3.0.0-next.4)