Normalize matchup team aliases

src/matchups.js

@@ -8,6 +8,38 @@ const DEFAULT_WEIGHTED_MODE = 'weighted';
 const DEFAULT_FALLBACK_DAYS = 7;
 const COCKROACH_RETRY_CODES = new Set(['40001']);
 const PROFILE_CANDIDATE_LIMIT = 5;
+const MLB_TEAM_ALIASES = new Map([
+  ['ARI', ['ari', 'arizona', 'diamondbacks', 'arizona diamondbacks']],
+  ['ATL', ['atl', 'atlanta', 'braves', 'atlanta braves']],
+  ['BAL', ['bal', 'baltimore', 'orioles', 'baltimore orioles']],
+  ['BOS', ['bos', 'boston', 'red sox', 'boston red sox']],
+  ['CHC', ['chc', 'chicago cubs', 'cubs']],
+  ['CWS', ['cws', 'chw', 'chicago white sox', 'white sox']],
+  ['CIN', ['cin', 'cincinnati', 'reds', 'cincinnati reds']],
+  ['CLE', ['cle', 'cleveland', 'guardians', 'cleveland guardians']],
+  ['COL', ['col', 'colorado', 'rockies', 'colorado rockies']],
+  ['DET', ['det', 'detroit', 'tigers', 'detroit tigers']],
+  ['HOU', ['hou', 'houston', 'astros', 'houston astros']],
+  ['KC', ['kc', 'kcr', 'kansas city', 'royals', 'kansas city royals']],
+  ['LAA', ['laa', 'los angeles angels', 'angels', 'anaheim angels']],
+  ['LAD', ['lad', 'los angeles dodgers', 'dodgers']],
+  ['MIA', ['mia', 'miami', 'marlins', 'miami marlins', 'florida marlins']],
+  ['MIL', ['mil', 'milwaukee', 'brewers', 'milwaukee brewers']],
+  ['MIN', ['min', 'minnesota', 'twins', 'minnesota twins']],
+  ['NYM', ['nym', 'mets', 'new york mets']],
+  ['NYY', ['nyy', 'yankees', 'new york yankees']],
+  ['ATH', ['ath', 'athletics', 'a\'s', 'as', 'oakland', 'oakland athletics']],
+  ['PHI', ['phi', 'philadelphia', 'phillies', 'philadelphia phillies']],
+  ['PIT', ['pit', 'pittsburgh', 'pirates', 'pittsburgh pirates']],
+  ['SD', ['sd', 'sdp', 'san diego', 'padres', 'san diego padres']],
+  ['SEA', ['sea', 'seattle', 'mariners', 'seattle mariners']],
+  ['SF', ['sf', 'sfg', 'san francisco', 'giants', 'san francisco giants']],
+  ['STL', ['stl', 'cardinals', 'st louis', 'st. louis', 'st louis cardinals', 'st. louis cardinals']],
+  ['TB', ['tb', 'tbr', 'tampa bay', 'rays', 'tampa bay rays']],
+  ['TEX', ['tex', 'texas', 'rangers', 'texas rangers']],
+  ['TOR', ['tor', 'toronto', 'blue jays', 'toronto blue jays']],
+  ['WSH', ['wsh', 'was', 'washington', 'nationals', 'washington nationals']],
+]);
 
 const HITTER_COLUMNS = [
   'game_pk',
@@ -234,6 +266,36 @@ function normalizeTeam(value) {
   return String(value ?? '').trim().toUpperCase();
 }
 
+function resolveTeamAliases(value) {
+  const normalized = normalizeText(value);
+  if (!normalized) {
+    return [];
+  }
+
+  const matches = [];
+  for (const [canonical, aliases] of MLB_TEAM_ALIASES.entries()) {
+    if (aliases.includes(normalized) || canonical.toLowerCase() === normalized) {
+      matches.push(canonical);
+    }
+  }
+
+  if (matches.length > 0) {
+    return matches;
+  }
+
+  return [normalizeTeam(value)];
+}
+
+function rowMatchesTeamFilter(rowTeam, teamFilter) {
+  if (!teamFilter) {
+    return true;
+  }
+
+  const candidates = resolveTeamAliases(teamFilter);
+  const normalizedRowTeam = normalizeTeam(rowTeam);
+  return candidates.includes(normalizedRowTeam);
+}
+
 function numberOrNull(value) {
   const numeric = Number(value);
   return Number.isFinite(numeric) ? numeric : null;
@@ -493,7 +555,7 @@ export class HostedArtifactSource {
     const filteredRows = hitterRows
       .filter(keepRowForDefaults)
       .map((row) => withDefaults(row, slateLookup))
-      .filter((row) => !options.team || normalizeTeam(row.team) === normalizeTeam(options.team))
+      .filter((row) => rowMatchesTeamFilter(row.team, options.team))
       .filter((row) => {
         const playerId = row.batter ?? row.player_id;
         return !exclusionSet.has(String(playerId ?? ''));
@@ -522,7 +584,7 @@ export class HostedArtifactSource {
     const filteredRows = pitcherRows
       .filter(keepRowForDefaults)
       .map((row) => withDefaults(row, slateLookup))
-      .filter((row) => !options.team || normalizeTeam(row.team) === normalizeTeam(options.team));
+      .filter((row) => rowMatchesTeamFilter(row.team, options.team));
 
     return {
       source: 'hosted',

test/matchups.test.js

@@ -65,6 +65,62 @@ test('hosted artifact source resolves latest available daily slate and caches pa
   assert.equal(calls.filter((url) => url.includes('daily_hitter_metrics.parquet')).length, 1);
 });
 
+test('hosted artifact source matches common team aliases against team abbreviations', async () => {
+  const responses = new Map([
+    ['https://example.test/daily/2026-04-07/slate.parquet', [
+      {
+        game_pk: 20,
+        away_team: 'ATH',
+        home_team: 'NYY',
+        away_probable_pitcher: 'JP Sears',
+        home_probable_pitcher: 'Carlos Rodon',
+        away_probable_hand: 'L',
+        home_probable_hand: 'L',
+      },
+    ]],
+    ['https://example.test/daily/2026-04-07/daily_hitter_metrics.parquet', [
+      {
+        team: 'NYY',
+        hitter_name: 'Aaron Judge',
+        batter: 99,
+        split_key: 'overall',
+        recent_window: 'season',
+        weighted_mode: 'weighted',
+        matchup_score: 88.6,
+        ceiling_score: 91.1,
+        zone_fit_score: 74.2,
+        likely_starter_score: 99.9,
+        xwoba: 0.455,
+        hard_hit_pct: 61.0,
+      },
+    ]],
+    ['https://example.test/daily/2026-04-07/hitter_pitcher_exclusions.parquet', []],
+  ]);
+
+  const source = new HostedArtifactSource(
+    {
+      baseUrl: 'https://example.test',
+      cacheTtlMs: 60_000,
+      fallbackDays: 0,
+    },
+    {
+      readParquetImpl: async (url) => {
+        if (!responses.has(url)) {
+          throw new Error(`Missing ${url}`);
+        }
+        return responses.get(url);
+      },
+      logger: { debug() {}, warn() {} },
+    }
+  );
+
+  const result = await source.getBestMatchups({ date: '2026-04-07', team: 'Yankees' });
+
+  assert.equal(result.rows.length, 1);
+  assert.equal(result.rows[0].team, 'NYY');
+  assert.equal(result.rows[0].hitter_name, 'Aaron Judge');
+});
+
 test('matchup service falls back to Cockroach when hosted source fails', async () => {
   const service = new MatchupService(
     { databaseUrl: 'postgresql://test', hosted: { baseUrl: 'https://example.test' } },