docs: update README and CLAUDE.md with all v0.9.0 features

README: add ARAM bench swap, win probability, overlay improvements
CLAUDE.md: full rewrite reflecting current architecture, commands,
patterns, data sources, and known issues

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: ishtartec

CLAUDE.md

@@ -6,58 +6,77 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ```bash
 # Start Tauri app in dev mode (Rust backend + Vite hot-reload frontend)
-npm run tauri dev
+pnpm tauri dev
 
 # Build production binary
-npm run tauri build
+pnpm tauri build
 
 # Frontend-only dev server (no Tauri shell, runs on localhost:1420)
-npm run dev
+pnpm dev
 
-# Type-check + build frontend only
-npm run build
+# Type-check frontend only
+npx tsc --noEmit
+
+# Rust type-check only
+cd src-tauri && cargo check
+
+# Release a new version (bumps version in 3 files, commits, tags, pushes)
+./scripts/release.sh 0.X.0
 ```
 
 There are no tests configured in this project.
 
 ## Architecture
 
-**QueryLoL Desktop** is a League of Legends companion app built with Tauri 2 (Rust backend) and React 19 (TypeScript frontend).
+**QueryLoL Desktop** is a League of Legends companion app built with Tauri 2 (Rust backend) and React 19 (TypeScript frontend). Supports Windows and macOS.
 
 ### Backend (src-tauri/src/)
 
-- **lib.rs** — Tauri app setup, command handlers, and the main `watcher_loop`/`poll_loop`. The watcher continuously detects the League client, and the poll loop (1s interval) tracks game phase transitions (lobby → champ select → in-game → post-game), triggering builds, recommendations, and auto-apply actions.
-- **lcu.rs** — League Client Update (LCU) API integration. Connects via lockfile (`riot:password` + port over HTTPS with self-signed cert). Handles all client interactions: reading game state, applying runes/spells/items, pick/ban actions, match history, post-game stats.
-- **opgg.rs** — OP.GG API integration (`https://lol-api-champion.op.gg/api`). Fetches builds, counters, ban suggestions, pick recommendations (scored 0-100), and game predictions with early/late phase analysis.
-- **models.rs** — All serde-serializable data structures shared between backend and frontend.
+- **lib.rs** — Tauri app setup, command handlers (~15 commands), `watcher_loop` (LCU connection), `poll_loop` (1s game phase polling), and `overlay_loop` (50ms TAB key polling via device_query). Manages phase transitions: lobby → champ select → in-game → post-game.
+- **lcu.rs** — League Client Update (LCU) API integration. Connects via lockfile (platform-specific paths for macOS/Windows). Handles: game state, applying runes/spells/items, pick/ban, match history, post-game stats, live game data, ARAM bench swap. Also contains `poll_live_game_data()` for the Live Client Data API (port 2999) and `compute_phase_stats()`/`compute_gold_timeline()` from snapshot data.
+- **opgg.rs** — OP.GG API integration. Fetches builds, counters, ban suggestions, pick recommendations, game predictions, ARAM win rates.
+- **models.rs** — All serde-serializable data structures. Key types: `AppState`, `LiveGameState`, `LivePlayerStats`, `PostGameStats`, `PlayerSnapshot`, `AramBenchChampion`.
 - **config.rs** — Persistent user config (region, toggles, LP history) saved to `{app_data_dir}/config.json`.
 
 ### Frontend (src/)
 
-- **App.tsx** — Single-file monolith containing all components (~1500 lines). No component splitting — everything from the LP chart to post-game scoreboard lives here.
-- **App.css** — Dark theme styled with CSS variables (no preprocessor). League of Legends aesthetic with gold/blue/red accents.
+- **main.tsx** — Entry point. Detects overlay vs main window via `getCurrentWebviewWindow().label` and renders the appropriate component.
+- **App.tsx** — Single-file containing all components (~2900 lines). Includes: champion select views, live game with spell tracking, post-game analysis, overlay, tooltips, ARAM bench, improvement panel, matchup analysis, damage composition, win probability model, and all static data (champion traits, power curves, elo benchmarks, spell cooldowns).
+- **App.css** — Dark theme with CSS variables. League of Legends aesthetic with gold/blue/red accents. Custom scrollbar, overlay styles, position icons.
 
 ### State Flow
 
 1. Rust backend detects game phase change via LCU polling
 2. Backend updates centralized `SharedState` (`Arc<Mutex<AppState>>`)
 3. Backend emits `app-state-changed` Tauri event with full `AppState` payload
 4. React listener receives event → `setState(e.payload)` → re-render
+5. Overlay window polls state via `invoke("get_state")` every 1s as fallback
 
-All HTTP requests happen in Rust only — the frontend never calls external APIs directly. Frontend communicates with backend via `invoke("command_name", { args })` for user-initiated actions (apply build, pick/ban, change settings).
+All HTTP requests happen in Rust only. Frontend communicates with backend via `invoke("command_name", { args })` for user-initiated actions.
 
 ### Key Patterns
 
 - **No Redux/state library** — pure React `useState` + Tauri event listener
-- **Draft change detection** — hashing of draft state to avoid redundant API calls in the poll loop
-- **Error handling** — `Result<T, String>` in Rust, try/catch on `invoke` in React with toast notifications (5s timeout)
+- **Draft change detection** — hashing of draft state to avoid redundant API calls
+- **Two windows** — main app + overlay (transparent, always-on-top, click-through)
+- **Snapshot collection** — during live game, player stats recorded every 30s for post-game phase analysis
+- **Win probability** — logistic model based on gold diff, game time, dragons, baron
+- **Platform-conditional code** — `#[cfg(target_os)]` for macOS/Windows lockfile paths, process detection, notifications
 - **TypeScript strict mode** enabled (`noUnusedLocals`, `noUnusedParameters`)
 
 ## Data Sources
 
 | Source | Purpose |
 |--------|---------|
-| Riot LCU (local HTTPS) | Game state, summoner info, apply builds, match history |
-| OP.GG API | Builds, counters, recommendations, predictions |
-| Data Dragon (Riot CDN) | Champion/item/rune/spell metadata and icons |
-| CommunityDragon | Rank emblems, stat shard icons |
+| Riot LCU (local HTTPS) | Game state, summoner info, apply builds, match history, ARAM bench |
+| Riot Live Client Data (port 2999) | Real-time in-game stats: KDA, CS, gold, items, events |
+| OP.GG API | Builds, counters, recommendations, predictions, ARAM win rates |
+| Data Dragon (Riot CDN) | Champion/item/rune/spell metadata, icons, descriptions |
+| CommunityDragon | Rank emblems, stat shard icons, position icons |
+
+## Known Issues
+
+- **macOS Accessibility**: Overlay (TAB hold) requires Accessibility permission. In dev mode, the binary changes on each compile, invalidating the permission. In production (DMG), it persists.
+- **LCU match details**: `timeline.lane` field is unreliable for position detection. We use Smite detection + role heuristics as fallback.
+- **LCU ranked stats**: The endpoint returns 0 losses for other players — we hide W/L when data is incomplete.
+- **OP.GG ARAM tier list**: Returns different JSON format than ranked — we fallback to the ranked tier list with ARAM position filter.

README.md

@@ -36,6 +36,7 @@ Built with **Tauri** (Rust) + **React** (TypeScript). Lightweight (~15MB), no Ov
 - **One-click pick/ban** — click any recommendation or ban suggestion to lock it in
 - **Auto-lock** — optionally auto-lock your champion selection
 - **Full draft visualization** — ally/enemy picks, bans, and positions with role icons displayed in a 3-column layout
+- **ARAM bench** — shows available bench champions sorted by ARAM win rate, click to swap
 
 ### Lobby
 - **Improvement priorities** — top 3 areas to improve based on your ranked history vs elo benchmarks, with visual bars and actionable advice
@@ -61,7 +62,8 @@ Built with **Tauri** (Rust) + **React** (TypeScript). Lightweight (~15MB), no Ov
 - **Power spike alerts** — "400g to [item]" for your next core item, and "Enemy completed [item]" when enemies buy key items
 - **Objective timers** — Baron buff (3:00), Elder Dragon buff (2:30), and Dragon Soul tracking with countdown and team indicator
 - **Objective feed** — dragons, baron, herald, turrets, inhibitors, and multikills with timestamps
-- **In-game overlay** — hold TAB to show a compact overlay with gold diff, enemy KDA/spells, and objective timers (Windows, borderless windowed mode)
+- **Win probability** — real-time win % estimate based on gold diff, game time, dragons, and baron (displayed in gold bar and overlay)
+- **In-game overlay** — hold TAB to show a compact overlay with win probability, lane gold diffs, and objective timers (borderless windowed mode, configurable position)
 - **Player profiles** — click any player to view their match history in an overlay
 
 ### Post-Game Analysis
@@ -75,7 +77,7 @@ Built with **Tauri** (Rust) + **React** (TypeScript). Lightweight (~15MB), no Ov
 - **MVP badge** — awarded to the top performer based on a composite score
 - **Multikill badges** — triple, quadra, and penta kill indicators
 - **Final items** — complete end-game item build for each player with tooltips
-- **Gold advantage timeline** — SVG chart showing gold diff over time with death markers
+- **Gold advantage timeline** — SVG chart showing gold diff over time with death markers and win probability curve overlay
 - **Elo comparison** — your CS/min, vision/min, KDA, damage share, KP, and gold/min compared against your rank's average with percentage deltas
 - **Performance by phase** — CS/min, gold/min, and KDA broken down by early (0-14m), mid (14-25m), and late (25m+) game phases
 - **Player profiles** — click any player name to view their ranked info and match history