After OAuth callback, engine.js calls profile.php?action=ensure which
creates or updates the profile using Google's user_metadata (full_name,
avatar_url). Existing profiles with default "Player" name or missing
avatars get updated on next login.

Also backfilled avatar_url and display_name for existing Google users.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Users who signed in via Google OAuth or edge cases had auth.users rows
but no profiles row, causing "Profile not found" 400 errors on daily
reward claims and profile fetches. Now profile.php, auth.php (login),
and daily-reward.php all auto-create the profile if missing.

Also backfilled 4 missing profiles directly in the database.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Ludo:
- Replace pure-random dice with weighted system (drama when stuck, catch-up boost, domination penalty)
- Enhanced VFX: screen flash on captures, bigger confetti on wins, panel pulse on finish
- Turbo mode after 12 min: 60% faster bots, doubled animation speed, fewer dice frames

Domino:
- Fix tile proportions from 40x70 (1.75:1) to 36x72 (correct 2:1 ratio)
- Increase chain layout GAP from 3 to 6 for better readability
- Add target score selection (50/100/150) in bot mode room picker
- Endgame tension alerts when opponent has 1-2 tiles remaining
- Last-tile confetti burst + enhanced result screen with crown
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Full end-to-end implementation with DB, API, frontend, and realtime sync:

- Block/Mute: player_blocks table, block checks in chat/matchmaking/invites,
  blocked-list UI in settings, block/mute buttons in opponent menu
- View Other Player's Profile: friendship_status, block_status, action buttons
  (add friend/challenge/message/block), spectate live indicator
- Groups: create/join/leave, group chat with realtime, game invites with
  accept flow, member management (add/remove), notifications
- Spectate: find-active-match API, chess spectate scene with live board
  updates, tournament spectate buttons, profile "watching live" indicator

DB migrations: groups + group_members tables, chat_messages columns added.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

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

Missing file caused blank screen after deploy.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Cache-Control no-store headers + version query strings to bust
existing cached files on user devices.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Guest mode: play vs bots without account, locked multiplayer/social tabs
- Google OAuth sign-in/sign-up via Supabase with auto-profile creation
- Delete account flow (password verify for email, confirm for OAuth)
- Privacy policy + Terms of Service pages (bilingual AR/EN)
- PWA manifest with app icons
- Age confirmation checkbox on registration
- Legal links in login, register, and settings
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

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

- friends.php: create domino invites in domino_matches table (not chess matches)
- friends.php: check-invites scans domino_matches + ludo_matches tables
- friends.php: accept/decline route to correct game table by game_key
- domino-match.php: merge hands on move (preserve other player's hand data)
- game.js: host deals and syncs both hands; guest waits for deal via polling
- game.js: new rounds in live mode dealt by host only
- lobby.js: pass playerIndex from accept response
- chat.js: add domino option to in-chat challenge dialog
- friends.js: pass game_key on accept/decline calls
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

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

- Snap radius 45→60 for easier endpoint tapping
- hitTestEndpoints only checks currently active (highlighted) endpoints
- Empty board returns hit on any canvas tap when endpoint is active
- Simplified pointerdown handler (no early endpoint intercept)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Layout engine:
- Non-doubles are landscape (w=48, h=24) in horizontal chains
- Doubles are portrait (w=24, h=48) perpendicular to horizontal chains
- Tiles positioned touching each other with GAP=3px between
- Properly computes half-extents for advance distance
- Endpoints positioned beyond last tile in chain direction

Tile renderer:
- Uses w>h to detect landscape orientation (no rotation param needed)
- Left/right pips in landscape, top/bottom pips in portrait
- Doubles get accent background

Board:
- Ghost and animate tiles compute orientation from layout dirIdx
- No rotation applied (dimensions are pre-computed correctly)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Empty board now returns hit on any board tap when active endpoint set
- Status text updates immediately when tile is selected/deselected
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Theme:
- Replace green felt table with dark navy (#0f1623) matching app identity
- Gold accent (#E4AC38) replaces green for highlights and UI elements
- Tiles have warm ivory (#F5F0E8) with subtle shadows on dark bg
- All UI bars/controls use app's #0f0f1e background

Layout engine rewrite:
- Chain starts from center, grows outward naturally
- Proper double placement (perpendicular to chain direction)
- Non-doubles align correctly with chain direction
- Snake path with smooth turns at virtual bounds

Interaction (tap-to-confirm):
- Tap tile → highlights valid endpoints on board
- Tap highlighted endpoint → confirms placement
- NEVER auto-places on tap — always requires explicit destination
- Tap same tile again → deselects it
- Status shows "اختر مكان الوضع" when tile is selected

Board improvements:
- Pan gesture: drag on empty board area to scroll
- Auto-zoom: smoothly zooms out as chain grows large
- Endpoint glow uses gold dashed-ring indicator
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

When touchend fires without updating pointer coordinates (common in
headless environments and some mobile browsers), the proxy position
is used to re-check endpoint hit test before deciding placement.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Previously, tapping a tile that could play on both ends would highlight
board endpoints and require a separate canvas tap. Now a second tap on
the same tile auto-places it on the right end, matching mobile UX
expectations.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Added touchend listener as fallback in DominoDrag for browsers/envs
  where pointerup doesn't fire after touch events
- Added auto-pass (1.5s timeout) when player is blocked and boneyard
  is empty — prevents game from stalling
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Styles were injected before hand/drag were instantiated, resulting in
zero-dimension tiles (CSS classes never added to page).
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Full mobile domino implementation with all 6 phases:
- Canvas board with snake-path layout, endpoint glow, ghost preview
- HTML fan hand with drag-and-snap + tap-to-play controls
- 3-level bot AI (beginner/intermediate/expert) with server records
- Live multiplayer via polling (match-live.js integration)
- Emote system, resign sync, disconnect handling
- Multi-round scoring (first to 100), round overlays
- Server API (domino-match.php) with Elo, coins, XP rewards
- Bot difficulty picker, friend challenge flow, lobby integration
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- match-live.js: always forward poll data to game (not only on move_count change)
  This was the root cause — resign/draw don't increment move_count, so the
  game never processed the status change or game_state update
- game.php: all match operations now use supabaseService() to bypass RLS
  (handleGameMove, handleResign, handleComplete all failed silently with user token)
- Add dedicated 'draw' action in game.php that atomically marks match completed
- Draw acceptance now calls action:'draw' instead of writing game_state only
- handleResign validates match isn't already completed (prevents double-resign)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Add friend_messages table + chat.php API (send, history, unread)
- Add chat scene with real-time polling, day dividers, invite from chat
- Add game lobby scene (waiting room before match starts)
- Add "Challenge Friend" button on play home screen
- Add challenge-friend scene with friend picker + game/time selector
- Remove ad banner from chess, polish layout for all screen sizes
- Fix Ludo layout (broken #ludo-wrap div, board now fills space properly)
- Route invite acceptance through lobby instead of direct game push
- Add 💬 chat button on friend cards in social scene
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Add friend button shows success/already-sent/already-friends status
- Profile button navigates to player profile view
- Report button shows confirmation before dismissing
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Friendship bugs fixed:
- Accept now uses service key (bypasses RLS that blocked updates)
- Duplicate request prevention (checks both directions)
- Reject uses proper POST action instead of broken DELETE call
- Cleaned up stale duplicate rows in DB

New features:
- Friend invite system: challenge dialog with game/time selection
- Match created as 'friendly' with status 'waiting'
- Opponent sees invite banner (polls every 5s), can accept/decline
- Accept starts the match, both players enter the game
- 2-minute invite expiry
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Daily rewards:
- Server now tracks streak, prevents double-claim, resets on missed day
- GET endpoint returns current state (streak, claimed status, today's reward)
- Updates profile daily_streak + last_daily_reward columns
- Frontend fetches state from server instead of relying on local store

Achievements:
- New scene with category filters, progress bars, tier badges
- POST check action recalculates all progress from player stats
- game.php now tracks win_streak and checks achievements on game end
- Rewards (coins/XP) auto-granted when achievement completes

Challenges:
- Claim tracking via economy_transactions prevents double-claims
- Fixed column name (reason, not description)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Players can now fill all profile fields (bio, country, city, FIDE info)
from their profile tab and apply for organizations with document proof.
Also fixes avatar.php to use SERVICE_KEY for storage uploads.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Eliminate double polling: removed game.js own poller, use match-session's
  single 2s poll via handleLivePollData callback (halves network requests)
- Send last_move (from/to/san/promotion) in game_state so opponent gets
  exact move data — fixes castling, en passant, promotion animations
- Opponent moves now animate (piece slides) instead of board snap
- Capture particles now fire on opponent's captures too
- Castling sound+haptic plays for opponent's castles
- Draw flow: sender sees "sent" confirmation, receiver sees accept/deny
  dialog (30s timeout), both sides see result via game_state merge
- Emote dedup: timestamp tracking prevents repeated display on same emote
- Emotes use correct emoji lookup (getEmojiForKey) instead of 3 hardcoded
- Polling runs even during player's turn (emotes + draws must arrive anytime)
- Game end detection covers draw result ('draw' + 'aborted')
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Draw offer now syncs: sender sees confirmation, receiver sees
  accept/deny dialog with 30s timeout
- Emotes now show the correct emoji (was hardcoded to 3 mappings,
  now uses actual emote key lookup)
- Emote dedup via timestamp tracking — no repeated display
- game_state is now MERGED server-side instead of overwritten,
  so emotes don't wipe draw offers and vice versa
- Polling runs regardless of whose turn it is (emotes/draws
  need to arrive during your own turn too)
- Draw accept/decline response properly detected by offerer
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

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

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

Apply radial-gradient mask for smooth vignette fade on all edges.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Replace shop tab with tournaments hub. Players can browse all tournaments,
filter by status, register, and launch pending matches directly from the hub.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Add chess piece upload UI to admin/branding.php (12 slots: white + black)
- Fix loadPieceImages race condition in board renderer
- Add tournament system module (Swiss, knockout, arena)
- Add promo banner (1m×3m display) and video assets
- Add 2-min display video script
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Fix: clicking friends tab now always shows friends scene (not
  notifications). Tab click resets to root when already active.
- Friends list: sorted online-first, shows count, retry on error
- Pending requests: fetches requester profiles (name, avatar, level)
  instead of showing raw UUIDs
- Search: searches both username and display_name, debounced input
- Online tab: auto-refreshes every 15s
- Activity feed: timeAgo formatting, action icons
- API: added 'profiles' action for batch profile lookups, search
  now matches display_name too
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

The matches table requires these NOT NULL columns. Set match_type
to 'tournament' and parse time_control string for clock values.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

PostgREST auto-decodes JSONB columns, so json_decode() fails when
the value is already an array. Added is_array() checks before decoding.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

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

- HUD badge on rank tab for pending tournament matches
- Bracket API + horizontal scrollable bracket visualization (RTL)
- Arena mode: join/seek/pair/play loop with live standings
- Tournament lobby with countdown timer + player grid
- Live tournament spectating with auto-refresh pairings
- Format-specific tabs in tournament detail (bracket/arena)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Players can now play tournament matches from the app. Adds create-or-join
API, realtime pairing notifications, auto-result reporting to Swiss API,
and tournament-aware chess result screen.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>