Session 59: Addendum + work-order 1.6 + Phase 2 + Phase 3 (2352 tests)

Overnight sprint for the Saturday 10 AM ET deploy gate — day one of the
public ledger record locks against freshly posted lines.

Task A — ledger team/opponent (migration 020, applied at 0 rows):
  populated in both write paths from the real feed; opponent only when the
  player's team matches a game participant (never guessed). Roadmap: Phase
  4.5 WNBA ESPN-boxscore settlement (due ~Jul 24) + Phase 5 per-tier
  calibration logged.

Task B — work-order 1.6 CLOSED (canonical player keys):
  - searchPlayer resolves via nameKey; the old matcher deleted accents
    ("Sanchez" with acute -> "snchez") and substring-guessed onto the WRONG
    player (the mismatched last-10 bug). Ambiguous -> null, never guess.
  - Slate JOIN INVARIANT: a graded prop whose player's real team isn't in
    the game is dropped (TB player can't render under MIL@PIT) — locked by
    tests that fail the suite on regression.
  - grades:{sport} TTL 2h -> 6h (expired between 5h cron gaps — the real
    cause of /team "No active props" for slate players).

Task C — Phase 2 slate UX: tabs are THE filter (URL ?sport=, deep-linkable,
  duplicate legacy tablist removed); cards cap at 6 graded props sorted
  A+->F with ALL N READS in-place expander; waiting states show the real
  next pipeline run ("Grades post ~6:00 PM ET").

Task D — Phase 3 mobile P0: root cause of vanished 390px nav was HIDE_ON
  including '/' (landing had zero navigation) — fixed; html/body overflow-x
  contained; GAME LINES collapses to best-line summary + "N BOOKS" expander
  below 640px; venue drops before time/pitchers ever truncate.

Live verification: raw ESPN today STILL returns the Jun 13 NYK@SA Finals
game without a date pin; the pinned fetch returns 0 games, 0 off-date.

Backend 2327 -> 2352 tests (202 suites), web build exit 0.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

src/services/adapters/mlbStatsAdapter.js

@@ -129,22 +129,40 @@ async function getBatterVsPitcher(batterId, pitcherId, group = 'hitting') {
   return splits.length > 0 ? (splits[0].stat || null) : null;
 }
 
-const normName = (n) => String(n == null ? '' : n).toLowerCase().replace(/[^a-z0-9]/g, '');
+const { nameKey } = require('../../utils/playerName');
 
 /**
- * Resolve a player name → MLB person record (Session 43). Pulls the season
- * player list (cached 24h — heavy but rarely changes) and matches by
- * normalized full name. Returns { id, fullName, team, teamId, position } or
- * null. Needed because every other adapter method keys on playerId.
+ * Resolve a player name → MLB person record (Session 43; rebuilt Session 59,
+ * work-order 1.6). Pulls the season player list (cached 24h) and matches on
+ * the CANONICAL nameKey — accent-folded, suffix/nickname-resolved — so
+ * "Sánchez" ≡ "Sanchez" and "Matt" ≡ "Matthew" resolve to ONE player.
+ *
+ * The old matcher lower-cased and stripped non-[a-z0-9], which DELETED
+ * accented letters ("Sánchez" → "snchez" ≠ "sanchez") and then fell back to
+ * a raw substring match that could silently return the WRONG player — the
+ * audit's "last-10 opponents don't match his team" bug. The fallback now
+ * requires a UNIQUE same-last-name + same-first-initial candidate; anything
+ * ambiguous returns null (a missing profile beats another player's log).
  */
 async function searchPlayer(name, season = DEFAULT_SEASON) {
-  const target = normName(name);
-  if (!target) return null;
+  const targetKey = nameKey(name);
+  if (!targetKey) return null;
   const url = `${BASE}/sports/1/players?season=${season}`;
   const data = await fetchWithCache(url, `mlbstats:players:${season}`, 24 * 3600);
   const people = (data && Array.isArray(data.people)) ? data.people : [];
-  const hit = people.find((p) => normName(p.fullName) === target)
-    || people.find((p) => normName(p.fullName).includes(target) && target.length >= 6);
+  let hit = people.find((p) => nameKey(p.fullName) === targetKey);
+  if (!hit) {
+    const parts = targetKey.split(' ');
+    const first = parts[0] || '';
+    const last = parts[parts.length - 1] || '';
+    if (first && last && first !== last) {
+      const cands = people.filter((p) => {
+        const k = nameKey(p.fullName).split(' ');
+        return k[k.length - 1] === last && k[0] && k[0][0] === first[0];
+      });
+      if (cands.length === 1) hit = cands[0]; // unique or nothing — never guess
+    }
+  }
   if (!hit) return null;
   return {
     id: hit.id,
@@ -234,5 +252,5 @@ module.exports = {
   getTeams,
   resolveTeam,
   getTeamRoster,
-  __internals: { BASE, TTL, extractSplits, ymd, DEFAULT_SEASON, normName },
+  __internals: { BASE, TTL, extractSplits, ymd, DEFAULT_SEASON },
 };