Wave 2A: real player headshots — sport-agnostic id threaded from ingestion

Threads a REAL athlete id from the snapshot's per-player stats resolve (zero
new I/O) → enriched grade → grades:{sport} → slate strip → PlayerAvatar. Real
photo where an id resolves; team-colored monogram (never a gray silhouette,
never a broken image) where it can't. Ids are never fabricated.

Ingestion (Addition 1):
- espnStatsAdapter.getSeasonAverages now RETURNS the resolved ESPN athlete id
  (was discarded) as espnId; non-numeric uid degrades to null.
- playerIntelService surfaces MLBAM playerId (MLB) / ESPN espnId (NBA/WNBA).
- snapshotService captures both per player and stores them on the enriched
  grade beside archetype/team (null when unresolved → monogram path).

Thread → component:
- slateAdapter.buildPlayerStripsFromProps carries playerId/espnId onto each
  strip; StatStrip → PlayerAvatar (accepts both ids; getHeadshotUrl routes by
  sport: MLB→mlbstatic, NBA/WNBA→a.espncdn).
- Silhouette surfaces rewired to PlayerAvatar (branded monogram on null):
  scan search dropdown (guarded MLBAM p.id) + tonight chips, SearchModal,
  HotListPanel, GradeResultCard header. Scan grade card feeds the picked
  MLBAM id through gradeAdapter.
- playerHeadshot pure URL logic extracted to CommonJS playerHeadshotUrl.js
  (unit-testable; the .ts re-exports it). nfl/nhl added to ESPN_SPORT_PATH.

Tests: tests/unit/headshotThread.test.js (per-league URL + id thread + monogram
null path) + extended snapshotService/espnStatsAdapter suites. Full suite
241 suites / 2915 green; next build exit 0.

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

src/services/adapters/espnStatsAdapter.js

@@ -89,6 +89,13 @@ async function getSeasonAverages(name, sport, opts = {}) {
     const id = athlete && (athlete.id || athlete.uid || (athlete.athlete && athlete.athlete.id));
     if (!id) return { found: false };
 
+    // Wave 2A — the REAL ESPN athlete id for the headshot CDN
+    // (a.espncdn.com/i/headshots/{league}/players/full/{espnId}.png). Prefer the
+    // pure numeric id; a `uid` string ("s:40~l:46~a:…") is NOT a valid headshot
+    // id, so it degrades to null → monogram. Never fabricate.
+    const numericId = (athlete && (athlete.id ?? (athlete.athlete && athlete.athlete.id))) ?? null;
+    const espnId = numericId != null && /^\d+$/.test(String(numericId)) ? String(numericId) : null;
+
     // 2. Fetch that athlete's stats overview.
     const stats = await fetchJson(`https://site.web.api.espn.com/apis/common/v3/sports/${path}/athletes/${id}/stats`, opts.http);
     const classifierInput = parseAthleteStats(stats);
@@ -99,6 +106,9 @@ async function getSeasonAverages(name, sport, opts = {}) {
       team: (athlete.team && (athlete.team.abbreviation || athlete.team.displayName)) || '',
       position: (athlete.position && athlete.position.abbreviation) || '',
       classifierInput,
+      // Wave 2A — surfaced so resolvePlayerStats can thread it to the grade →
+      // slate strip → headshot. Absent → monogram (doctrine).
+      espnId,
     };
     try { await cacheSet(cacheKey, result, TTL); } catch { /* ignore */ }
     return result;