Focus player records and add squad leaderboards

docs/guides/leaderboard.md

@@ -1,10 +1,14 @@
 # Leaderboard
 
 Open **Leaderboard** in the main navigation to compare players across the fleet,
-with one entry per GUID combining Black Ops I (T5) and Black Ops II (T6). Game
-and map filters limit which matches contribute to each player's statistics and
+with one entry per GUID combining Black Ops I (T5) and Black Ops II (T6). Game, map,
+and starting squad-size filters limit which matches contribute to each player's statistics and
 rank. Choose a ranking, search a name or GUID, and share the page URL with its
-filters intact. Results refresh while the page is visible.
+filters intact. Results refresh while the page is visible. The page opens on a
+recorded map by default; choose **All maps** for a fleet-wide comparison. A URL
+with `map=` explicitly selects all maps. **Players** selects Solo, Duo, Trio or
+Four players using the recorded starting roster; unknown starting counts appear
+only under All squad sizes. The JSON API still defaults to all maps.
 
 ## Qualifying matches
 
@@ -29,13 +33,13 @@ rounds per game, and completion rate. Each map has its own complete set of
 records; map records and match history identify their game. Match history shows
 individual counters, server, date and completion credit in pages of 25 matches
 across both games. Map names link back to that map's leaderboard in its game.
-Use **Refresh stats** to load the latest reports. Ratios with a zero denominator
+Profiles update every 30 seconds while visible; the freshness indicator offers Retry if an update fails. Ratios with a zero denominator
 display a dash. Lifetime statistics and per-map records always cover all recorded
 maps across both games.
 
-Opening a player from the leaderboard preserves the originating game, map,
+Opening a player from the leaderboard preserves the originating game, map, squad size,
 metric, search and page in the **Leaderboard** return link. The profile's
-**Selected leaderboard** controls initialize from that game/map/metric and show
+**Filters** controls initialize from that game/map/squad/metric and show
 the player's rank within that competition, independent of the original search.
 These controls also filter match history; lifetime totals stay unchanged.
 History pagination retains the selection and return link. Map links preserve
@@ -43,9 +47,9 @@ the selected ranking metric. A player without qualifying matches in a selection
 can still view their lifetime profile and choose another scope.
 
 On phones, per-map records and match history use compact cards with the map,
-game, highest round and kills up front. Expand **All stats and record runs**
-or **More match stats** for the remaining counters and source evidence. Desktop
-profiles retain the complete tables; both views use the same history filters
+game, record values and match identity up front. Record values link directly to
+their completed match, where the full evidence is available. Desktop profiles
+use compact tables; both views use the same history filters
 and pagination. History dates say **First observed**, since a missing start
 report can make the first recorded observation later than the actual game start.
 
@@ -53,9 +57,8 @@ report can make the first recorded observation later than the actual game start.
 
 Highest-round, best-game-kill and highest-score records link to the completed
 match that earned them on the leaderboard and in lifetime/per-map profile stats.
-Each source shows its map, game, completion time, server, and whether the match
-start was recorded. **Run details** shows when the player was first observed:
-at the recorded start, at a reported round, or unknown for older stored records.
+Each source names its match and map. Open the match to see completion time,
+server, whether its start was recorded, and player participation evidence.
 Presence is not proof of continuous survival. Equal personal bests link to the
 earliest recorded completion, then the lowest match ID when times tie.
 
@@ -206,6 +209,7 @@ Use URL encoding for map keys and search text.
 | --- | --- | --- |
 | `game` | Both games | Exactly `t5` or `t6`. An empty value is invalid. |
 | `map` | All maps | Opaque `maps[].key`, at most 1024 characters. Empty means no map filter. An unknown key or a game/map mismatch returns an empty selection, not an error. |
+| `players` | All squad sizes | Exactly `1`, `2`, `3`, or `4`, matching the recorded starting player count. Unknown counts contribute only when this filter is absent. |
 | `metric` | `highestRound` | One of the metric keys below. An empty or unknown value is invalid. |
 | `q` | No search | At most 100 characters before trimming. Matches a literal substring of the current name or GUID, ignoring ASCII letter case. Surrounding whitespace is trimmed; whitespace-only input means no search. `%` and `_` are literal characters, not wildcards. |
 | `limit` | `50` | Integer from 1 to 100. |