Session 56: Full audit — PropLine + boxscore + pipeline + sport coverage (2289 tests)

Research (verified against live MLB Stats / ESPN / The Odds APIs): - specs/propline-audit.md — every stat_type mapped against our 4-layer pipeline; real MLB boxscore fields; sport coverage status; pipeline gap analysis. - specs/vyndr-roadmap.md — priority-ordered Sessions 57–64 + coverage targets. - scripts/propline-audit.js + specs/audit-data/ (raw capture). Headline bug: oddsNormalizer mapped batter_rbis → 'rbis' while the whole grade/feature/outcome chain keys on 'rbi' — every PropLine RBI prop silently failed to grade AND settle. Fixed (+ regression test). Phase 4 — wired missing MLB stats end-to-end: - PropLine MLB markets 6 → 12 (+runs, walks, doubles, earned_runs, hits_allowed, outs — same request, no extra quota). - doubles/outs/triples added to featureCache + outcomeService MLB_LOG_FIELD and all three grade whitelists (analyze/scan/validation.py). Phase 6 — pipeline resilience: - opsNotify.js: ntfy alerts (never throws, test-disabled). Snapshot success/ stale/failure alerts; retry-once on hard odds error (not on empty slate). - Missed-cron watchdog (mostRecentExpectedSlot/isSnapshotOverdue); status probe now returns `overdue`. Coverage truth: MLB is the only end-to-end-live sport; outcome settlement is MLB-only (WNBA/NBA/soccer never settle) — documented as the #1 roadmap gap. Backend 2276 → 2289 tests (+13). Web build exit 0. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-10 17:00:29 -04:00
parent d09a06c054
commit 2ae8a5697e
21 changed files with 1607 additions and 11 deletions
@@ -0,0 +1,875 @@
+{
+  "generatedAt": "2026-07-10T20:48:09.307Z",
+  "sections": {
+    "proplineInventory": {
+      "nba": {
+        "sportKey": "basketball_nba",
+        "requested": [
+          {
+            "market": "player_points",
+            "stat_type": "points"
+          },
+          {
+            "market": "player_rebounds",
+            "stat_type": "rebounds"
+          },
+          {
+            "market": "player_assists",
+            "stat_type": "assists"
+          },
+          {
+            "market": "player_threes",
+            "stat_type": "threes"
+          },
+          {
+            "market": "player_blocks",
+            "stat_type": "blocks"
+          },
+          {
+            "market": "player_steals",
+            "stat_type": "steals"
+          }
+        ]
+      },
+      "wnba": {
+        "sportKey": "basketball_wnba",
+        "requested": [
+          {
+            "market": "player_points",
+            "stat_type": "points"
+          },
+          {
+            "market": "player_rebounds",
+            "stat_type": "rebounds"
+          },
+          {
+            "market": "player_assists",
+            "stat_type": "assists"
+          },
+          {
+            "market": "player_threes",
+            "stat_type": "threes"
+          }
+        ]
+      },
+      "mlb": {
+        "sportKey": "baseball_mlb",
+        "requested": [
+          {
+            "market": "batter_hits",
+            "stat_type": "hits"
+          },
+          {
+            "market": "batter_home_runs",
+            "stat_type": "home_runs"
+          },
+          {
+            "market": "batter_total_bases",
+            "stat_type": "total_bases"
+          },
+          {
+            "market": "batter_rbis",
+            "stat_type": "rbis"
+          },
+          {
+            "market": "batter_stolen_bases",
+            "stat_type": "stolen_bases"
+          },
+          {
+            "market": "pitcher_strikeouts",
+            "stat_type": "strikeouts"
+          }
+        ]
+      },
+      "nfl": {
+        "sportKey": "football_nfl",
+        "requested": [
+          {
+            "market": "player_pass_yds",
+            "stat_type": "passing_yards"
+          },
+          {
+            "market": "player_rush_yds",
+            "stat_type": "rushing_yards"
+          },
+          {
+            "market": "player_reception_yds",
+            "stat_type": "receiving_yards"
+          },
+          {
+            "market": "player_receptions",
+            "stat_type": "receptions"
+          },
+          {
+            "market": "player_anytime_td",
+            "stat_type": "anytime_td"
+          },
+          {
+            "market": "player_pass_tds",
+            "stat_type": "pass_tds"
+          }
+        ]
+      },
+      "nhl": {
+        "sportKey": "hockey_nhl",
+        "requested": [
+          {
+            "market": "player_goals",
+            "stat_type": "goals"
+          },
+          {
+            "market": "player_shots_on_goal",
+            "stat_type": "shots_on_goal"
+          },
+          {
+            "market": "goalie_saves",
+            "stat_type": "saves"
+          }
+        ]
+      },
+      "ncaab": {
+        "sportKey": "basketball_ncaab",
+        "requested": [
+          {
+            "market": "player_points",
+            "stat_type": "points"
+          },
+          {
+            "market": "player_rebounds",
+            "stat_type": "rebounds"
+          },
+          {
+            "market": "player_assists",
+            "stat_type": "assists"
+          }
+        ]
+      },
+      "_allMappedMarkets": [
+        {
+          "market": "player_points",
+          "stat_type": "points"
+        },
+        {
+          "market": "player_rebounds",
+          "stat_type": "rebounds"
+        },
+        {
+          "market": "player_assists",
+          "stat_type": "assists"
+        },
+        {
+          "market": "player_threes",
+          "stat_type": "threes"
+        },
+        {
+          "market": "player_blocks",
+          "stat_type": "blocks"
+        },
+        {
+          "market": "player_steals",
+          "stat_type": "steals"
+        },
+        {
+          "market": "player_points_rebounds_assists",
+          "stat_type": "pra"
+        },
+        {
+          "market": "player_turnovers",
+          "stat_type": "turnovers"
+        },
+        {
+          "market": "batter_hits",
+          "stat_type": "hits"
+        },
+        {
+          "market": "batter_home_runs",
+          "stat_type": "home_runs"
+        },
+        {
+          "market": "batter_total_bases",
+          "stat_type": "total_bases"
+        },
+        {
+          "market": "batter_rbis",
+          "stat_type": "rbis"
+        },
+        {
+          "market": "batter_runs",
+          "stat_type": "runs"
+        },
+        {
+          "market": "batter_stolen_bases",
+          "stat_type": "stolen_bases"
+        },
+        {
+          "market": "batter_singles",
+          "stat_type": "singles"
+        },
+        {
+          "market": "batter_doubles",
+          "stat_type": "doubles"
+        },
+        {
+          "market": "batter_walks",
+          "stat_type": "walks"
+        },
+        {
+          "market": "batter_strikeouts",
+          "stat_type": "batter_strikeouts"
+        },
+        {
+          "market": "pitcher_strikeouts",
+          "stat_type": "strikeouts"
+        },
+        {
+          "market": "pitcher_earned_runs",
+          "stat_type": "earned_runs"
+        },
+        {
+          "market": "pitcher_hits_allowed",
+          "stat_type": "hits_allowed"
+        },
+        {
+          "market": "pitcher_outs",
+          "stat_type": "outs"
+        },
+        {
+          "market": "player_pass_yds",
+          "stat_type": "passing_yards"
+        },
+        {
+          "market": "player_pass_yards",
+          "stat_type": "passing_yards"
+        },
+        {
+          "market": "player_pass_tds",
+          "stat_type": "pass_tds"
+        },
+        {
+          "market": "player_pass_completions",
+          "stat_type": "pass_completions"
+        },
+        {
+          "market": "player_pass_attempts",
+          "stat_type": "pass_attempts"
+        },
+        {
+          "market": "player_pass_interceptions",
+          "stat_type": "interceptions"
+        },
+        {
+          "market": "player_rush_yds",
+          "stat_type": "rushing_yards"
+        },
+        {
+          "market": "player_rush_yards",
+          "stat_type": "rushing_yards"
+        },
+        {
+          "market": "player_rush_attempts",
+          "stat_type": "rush_attempts"
+        },
+        {
+          "market": "player_rush_tds",
+          "stat_type": "rush_tds"
+        },
+        {
+          "market": "player_receptions",
+          "stat_type": "receptions"
+        },
+        {
+          "market": "player_reception_yds",
+          "stat_type": "receiving_yards"
+        },
+        {
+          "market": "player_receiving_yards",
+          "stat_type": "receiving_yards"
+        },
+        {
+          "market": "player_reception_tds",
+          "stat_type": "reception_tds"
+        },
+        {
+          "market": "player_anytime_td",
+          "stat_type": "anytime_td"
+        },
+        {
+          "market": "player_kicking_points",
+          "stat_type": "kicking_points"
+        },
+        {
+          "market": "player_goals",
+          "stat_type": "goals"
+        },
+        {
+          "market": "player_shots_on_target",
+          "stat_type": "shots_on_target"
+        },
+        {
+          "market": "player_shots",
+          "stat_type": "shots"
+        },
+        {
+          "market": "player_tackles",
+          "stat_type": "tackles"
+        },
+        {
+          "market": "player_cards",
+          "stat_type": "cards"
+        },
+        {
+          "market": "player_corners",
+          "stat_type": "corners"
+        },
+        {
+          "market": "player_saves",
+          "stat_type": "saves"
+        },
+        {
+          "market": "player_goals_conceded",
+          "stat_type": "goals_conceded"
+        },
+        {
+          "market": "player_passes",
+          "stat_type": "passes"
+        },
+        {
+          "market": "team_clean_sheet",
+          "stat_type": "clean_sheet"
+        },
+        {
+          "market": "player_shots_on_goal",
+          "stat_type": "shots_on_goal"
+        },
+        {
+          "market": "goalie_saves",
+          "stat_type": "saves"
+        }
+      ],
+      "_hasKeys": false
+    },
+    "oddsApiActiveSports": [
+      {
+        "key": "americanfootball_cfl",
+        "group": "American Football",
+        "title": "CFL"
+      },
+      {
+        "key": "americanfootball_ncaaf",
+        "group": "American Football",
+        "title": "NCAAF"
+      },
+      {
+        "key": "americanfootball_ncaaf_championship_winner",
+        "group": "American Football",
+        "title": "NCAAF Championship Winner"
+      },
+      {
+        "key": "americanfootball_nfl",
+        "group": "American Football",
+        "title": "NFL"
+      },
+      {
+        "key": "americanfootball_nfl_preseason",
+        "group": "American Football",
+        "title": "NFL Preseason"
+      },
+      {
+        "key": "americanfootball_nfl_super_bowl_winner",
+        "group": "American Football",
+        "title": "NFL Super Bowl Winner"
+      },
+      {
+        "key": "aussierules_afl",
+        "group": "Aussie Rules",
+        "title": "AFL"
+      },
+      {
+        "key": "baseball_milb",
+        "group": "Baseball",
+        "title": "MiLB"
+      },
+      {
+        "key": "baseball_mlb",
+        "group": "Baseball",
+        "title": "MLB"
+      },
+      {
+        "key": "baseball_mlb_world_series_winner",
+        "group": "Baseball",
+        "title": "MLB World Series Winner"
+      },
+      {
+        "key": "baseball_npb",
+        "group": "Baseball",
+        "title": "NPB"
+      },
+      {
+        "key": "basketball_nba_summer_league",
+        "group": "Basketball",
+        "title": "NBA Summer League"
+      },
+      {
+        "key": "basketball_wnba",
+        "group": "Basketball",
+        "title": "WNBA"
+      },
+      {
+        "key": "boxing_boxing",
+        "group": "Boxing",
+        "title": "Boxing"
+      },
+      {
+        "key": "cricket_international_t20",
+        "group": "Cricket",
+        "title": "International Twenty20"
+      },
+      {
+        "key": "cricket_odi",
+        "group": "Cricket",
+        "title": "One Day Internationals"
+      },
+      {
+        "key": "cricket_t20_blast",
+        "group": "Cricket",
+        "title": "T20 Blast"
+      },
+      {
+        "key": "golf_the_open_championship_winner",
+        "group": "Golf",
+        "title": "The Open Winner"
+      },
+      {
+        "key": "lacrosse_pll",
+        "group": "Lacrosse",
+        "title": "PLL"
+      },
+      {
+        "key": "mma_mixed_martial_arts",
+        "group": "Mixed Martial Arts",
+        "title": "MMA"
+      },
+      {
+        "key": "politics_us_presidential_election_winner",
+        "group": "Politics",
+        "title": "US Presidential Elections Winner"
+      },
+      {
+        "key": "rugbyleague_nrl",
+        "group": "Rugby League",
+        "title": "NRL"
+      },
+      {
+        "key": "soccer_argentina_primera_division",
+        "group": "Soccer",
+        "title": "Primera División - Argentina"
+      },
+      {
+        "key": "soccer_austria_bundesliga",
+        "group": "Soccer",
+        "title": "Austrian Football Bundesliga"
+      },
+      {
+        "key": "soccer_brazil_campeonato",
+        "group": "Soccer",
+        "title": "Brazil Série A"
+      },
+      {
+        "key": "soccer_brazil_serie_b",
+        "group": "Soccer",
+        "title": "Brazil Série B"
+      },
+      {
+        "key": "soccer_china_superleague",
+        "group": "Soccer",
+        "title": "Super League - China"
+      },
+      {
+        "key": "soccer_conmebol_copa_libertadores",
+        "group": "Soccer",
+        "title": "Copa Libertadores"
+      },
+      {
+        "key": "soccer_conmebol_copa_sudamericana",
+        "group": "Soccer",
+        "title": "Copa Sudamericana"
+      },
+      {
+        "key": "soccer_denmark_superliga",
+        "group": "Soccer",
+        "title": "Denmark Superliga"
+      },
+      {
+        "key": "soccer_efl_champ",
+        "group": "Soccer",
+        "title": "Championship"
+      },
+      {
+        "key": "soccer_england_efl_cup",
+        "group": "Soccer",
+        "title": "EFL Cup"
+      },
+      {
+        "key": "soccer_england_league1",
+        "group": "Soccer",
+        "title": "League 1"
+      },
+      {
+        "key": "soccer_england_league2",
+        "group": "Soccer",
+        "title": "League 2"
+      },
+      {
+        "key": "soccer_epl",
+        "group": "Soccer",
+        "title": "EPL"
+      },
+      {
+        "key": "soccer_fifa_world_cup",
+        "group": "Soccer",
+        "title": "FIFA World Cup"
+      },
+      {
+        "key": "soccer_fifa_world_cup_winner",
+        "group": "Soccer",
+        "title": "FIFA World Cup Winner"
+      },
+      {
+        "key": "soccer_finland_veikkausliiga",
+        "group": "Soccer",
+        "title": "Veikkausliiga - Finland"
+      },
+      {
+        "key": "soccer_france_ligue_one",
+        "group": "Soccer",
+        "title": "Ligue 1 - France"
+      },
+      {
+        "key": "soccer_germany_bundesliga",
+        "group": "Soccer",
+        "title": "Bundesliga - Germany"
+      },
+      {
+        "key": "soccer_germany_bundesliga2",
+        "group": "Soccer",
+        "title": "Bundesliga 2 - Germany"
+      },
+      {
+        "key": "soccer_germany_dfb_pokal",
+        "group": "Soccer",
+        "title": "DFB-Pokal"
+      },
+      {
+        "key": "soccer_germany_liga3",
+        "group": "Soccer",
+        "title": "3. Liga - Germany"
+      },
+      {
+        "key": "soccer_italy_serie_a",
+        "group": "Soccer",
+        "title": "Serie A - Italy"
+      },
+      {
+        "key": "soccer_korea_kleague1",
+        "group": "Soccer",
+        "title": "K League 1"
+      },
+      {
+        "key": "soccer_league_of_ireland",
+        "group": "Soccer",
+        "title": "League of Ireland"
+      },
+      {
+        "key": "soccer_mexico_ligamx",
+        "group": "Soccer",
+        "title": "Liga MX"
+      },
+      {
+        "key": "soccer_netherlands_eredivisie",
+        "group": "Soccer",
+        "title": "Dutch Eredivisie"
+      },
+      {
+        "key": "soccer_norway_eliteserien",
+        "group": "Soccer",
+        "title": "Eliteserien - Norway"
+      },
+      {
+        "key": "soccer_russia_premier_league",
+        "group": "Soccer",
+        "title": "Premier League - Russia"
+      },
+      {
+        "key": "soccer_spain_la_liga",
+        "group": "Soccer",
+        "title": "La Liga - Spain"
+      },
+      {
+        "key": "soccer_spl",
+        "group": "Soccer",
+        "title": "Premiership - Scotland"
+      },
+      {
+        "key": "soccer_sweden_allsvenskan",
+        "group": "Soccer",
+        "title": "Allsvenskan - Sweden"
+      },
+      {
+        "key": "soccer_sweden_superettan",
+        "group": "Soccer",
+        "title": "Superettan - Sweden"
+      },
+      {
+        "key": "soccer_switzerland_superleague",
+        "group": "Soccer",
+        "title": "Swiss Superleague"
+      },
+      {
+        "key": "soccer_uefa_champs_league_qualification",
+        "group": "Soccer",
+        "title": "UEFA Champions League Qualification"
+      },
+      {
+        "key": "soccer_usa_mls",
+        "group": "Soccer",
+        "title": "MLS"
+      },
+      {
+        "key": "tennis_atp_wimbledon",
+        "group": "Tennis",
+        "title": "ATP Wimbledon"
+      },
+      {
+        "key": "tennis_wta_wimbledon",
+        "group": "Tennis",
+        "title": "WTA Wimbledon"
+      }
+    ],
+    "mlbBoxscore": {
+      "date": "2026-07-09",
+      "gamePk": 823359,
+      "matchup": "Atlanta Braves @ Pittsburgh Pirates",
+      "battingFields": [
+        "summary",
+        "gamesPlayed",
+        "flyOuts",
+        "groundOuts",
+        "airOuts",
+        "runs",
+        "doubles",
+        "triples",
+        "homeRuns",
+        "strikeOuts",
+        "baseOnBalls",
+        "intentionalWalks",
+        "hits",
+        "hitByPitch",
+        "atBats",
+        "caughtStealing",
+        "stolenBases",
+        "stolenBasePercentage",
+        "groundIntoDoublePlay",
+        "groundIntoTriplePlay",
+        "plateAppearances",
+        "totalBases",
+        "rbi",
+        "leftOnBase",
+        "sacBunts",
+        "sacFlies",
+        "catchersInterference",
+        "pickoffs",
+        "atBatsPerHomeRun",
+        "popOuts",
+        "lineOuts"
+      ],
+      "pitchingFields": [
+        "note",
+        "summary",
+        "gamesPlayed",
+        "gamesStarted",
+        "flyOuts",
+        "groundOuts",
+        "airOuts",
+        "runs",
+        "doubles",
+        "triples",
+        "homeRuns",
+        "strikeOuts",
+        "baseOnBalls",
+        "intentionalWalks",
+        "hits",
+        "hitByPitch",
+        "atBats",
+        "caughtStealing",
+        "stolenBases",
+        "stolenBasePercentage",
+        "numberOfPitches",
+        "inningsPitched",
+        "wins",
+        "losses",
+        "saves",
+        "saveOpportunities",
+        "holds",
+        "blownSaves",
+        "earnedRuns",
+        "battersFaced",
+        "outs",
+        "gamesPitched",
+        "completeGames",
+        "shutouts",
+        "pitchesThrown",
+        "balls",
+        "strikes",
+        "strikePercentage",
+        "hitBatsmen",
+        "balks",
+        "wildPitches",
+        "pickoffs",
+        "rbi",
+        "gamesFinished",
+        "runsScoredPer9",
+        "homeRunsPer9",
+        "inheritedRunners",
+        "inheritedRunnersScored",
+        "catchersInterference",
+        "sacBunts",
+        "sacFlies",
+        "passedBall",
+        "popOuts",
+        "lineOuts"
+      ],
+      "sampleBatting": {
+        "summary": "1-6 | K, R, SB",
+        "gamesPlayed": 1,
+        "flyOuts": 1,
+        "groundOuts": 1,
+        "airOuts": 3,
+        "runs": 1,
+        "doubles": 0,
+        "triples": 0,
+        "homeRuns": 0,
+        "strikeOuts": 1,
+        "baseOnBalls": 0,
+        "intentionalWalks": 0,
+        "hits": 1,
+        "hitByPitch": 0,
+        "atBats": 6,
+        "caughtStealing": 0,
+        "stolenBases": 1,
+        "stolenBasePercentage": "1.000",
+        "groundIntoDoublePlay": 0,
+        "groundIntoTriplePlay": 0,
+        "plateAppearances": 6,
+        "totalBases": 1,
+        "rbi": 0,
+        "leftOnBase": 3,
+        "sacBunts": 0,
+        "sacFlies": 0,
+        "catchersInterference": 0,
+        "pickoffs": 0,
+        "atBatsPerHomeRun": "-.--",
+        "popOuts": 0,
+        "lineOuts": 2
+      },
+      "samplePitching": {
+        "note": "(W, 2-0)",
+        "summary": "1.0 IP, 0 ER, 0 K, 0 BB",
+        "gamesPlayed": 1,
+        "gamesStarted": 0,
+        "flyOuts": 1,
+        "groundOuts": 1,
+        "airOuts": 2,
+        "runs": 0,
+        "doubles": 0,
+        "triples": 0,
+        "homeRuns": 0,
+        "strikeOuts": 0,
+        "baseOnBalls": 0,
+        "intentionalWalks": 0,
+        "hits": 0,
+        "hitByPitch": 0,
+        "atBats": 3,
+        "caughtStealing": 0,
+        "stolenBases": 0,
+        "stolenBasePercentage": ".---",
+        "numberOfPitches": 15,
+        "inningsPitched": "1.0",
+        "wins": 1,
+        "losses": 0,
+        "saves": 0,
+        "saveOpportunities": 0,
+        "holds": 0,
+        "blownSaves": 0,
+        "earnedRuns": 0,
+        "battersFaced": 3,
+        "outs": 3,
+        "gamesPitched": 1,
+        "completeGames": 0,
+        "shutouts": 0,
+        "pitchesThrown": 15,
+        "balls": 6,
+        "strikes": 9,
+        "strikePercentage": ".600",
+        "hitBatsmen": 0,
+        "balks": 0,
+        "wildPitches": 0,
+        "pickoffs": 0,
+        "rbi": 0,
+        "gamesFinished": 0,
+        "runsScoredPer9": "0.00",
+        "homeRunsPer9": "0.00",
+        "inheritedRunners": 0,
+        "inheritedRunnersScored": 0,
+        "catchersInterference": 0,
+        "sacBunts": 0,
+        "sacFlies": 0,
+        "passedBall": 0,
+        "popOuts": 1,
+        "lineOuts": 0
+      }
+    },
+    "espnWnba": {
+      "count": 3,
+      "events": [
+        {
+          "name": "Golden State Valkyries at Connecticut Sun",
+          "status": "Scheduled",
+          "date": "2026-07-10T23:30Z"
+        },
+        {
+          "name": "Dallas Wings at Toronto Tempo",
+          "status": "Scheduled",
+          "date": "2026-07-10T23:30Z"
+        },
+        {
+          "name": "Chicago Sky at Los Angeles Sparks",
+          "status": "Scheduled",
+          "date": "2026-07-11T02:00Z"
+        }
+      ],
+      "completedBoxLabels": null
+    },
+    "espnSoccer": {
+      "league": "usa.1 (MLS)",
+      "count": 4,
+      "events": [
+        {
+          "name": "Toronto FC at CF Montréal",
+          "status": "Scheduled"
+        },
+        {
+          "name": "Vancouver Whitecaps at Chicago Fire FC",
+          "status": "Scheduled"
+        },
+        {
+          "name": "Sporting Kansas City at St. Louis CITY SC",
+          "status": "Scheduled"
+        },
+        {
+          "name": "Portland Timbers at Seattle Sounders FC",
+          "status": "Scheduled"
+        }
+      ]
+    }
+  }
+}
@@ -0,0 +1,145 @@
+# PropLine + Box Score + Pipeline Audit — 2026-07-10 (Session 56)
+
+Ground-truth inventory of what data we can access, what our pipeline handles, and
+the gaps. Live sections were fetched against real APIs (MLB Stats, ESPN, The Odds
+API `/v4/sports`). PropLine has no dev keys, so its inventory is derived from the
+authoritative code (`proplineAdapter.MARKETS` × `oddsNormalizer.MARKET_MAP`) —
+that IS the set our pipeline requests + normalizes. Raw capture:
+`specs/audit-data/propline-audit-raw.json`.
+
+Baseline: **2276 tests** passing at session start.
+
+---
+
+## 0. What is in-season RIGHT NOW (The Odds API `/v4/sports`, live 2026-07-10)
+
+| Sport | Active key(s) | Notes |
+|-------|---------------|-------|
+| MLB | `baseball_mlb` | ✅ full season — the live product |
+| WNBA | `basketball_wnba` | ✅ in-season (3 games tonight per ESPN) |
+| NBA | `basketball_nba_summer_league` only | ⚠️ regular NBA off until Oct; summer league live |
+| NFL | `americanfootball_nfl`, `_nfl_preseason` | ⚠️ preseason lines starting |
+| Soccer | 40+ leagues (`soccer_epl`, `soccer_usa_mls`, `soccer_fifa_world_cup`, La Liga, Serie A, …) | ✅ year-round via odds-api |
+| NHL | (absent) | off-season — no lines |
+
+Takeaway: **MLB + WNBA + soccer are the live opportunity today.** NBA/NFL are
+pre-season shells; NHL is dark.
+
+---
+
+## 1. PropLine / odds inventory — what we REQUEST vs what we CAN normalize
+
+`proplineAdapter.MARKETS` = the markets we actually ask for. `MARKET_MAP` = every
+market we can normalize (superset). A market we request but don't map → **silent
+zero**; a market we map but don't request → **unused capacity** (free to add — same
+call).
+
+### MLB
+| Requested market | → stat_type | Grade whitelist? | Features (l5/l20)? | Outcome settle? |
+|---|---|---|---|---|
+| batter_hits | hits | ✅ | ✅ hits | ✅ hits |
+| batter_home_runs | home_runs | ✅ | ✅ homeRuns | ✅ homeRuns |
+| batter_total_bases | total_bases | ✅ | ✅ totalBases | ✅ totalBases |
+| batter_rbis | **rbis** ❌ | ✅ (`rbi`) | ✅ (`rbi`) | ✅ (`rbi`) | ← **BUG: normalizes to `rbis`, whole chain keys on `rbi` → never grades/settles** |
+| batter_stolen_bases | stolen_bases | ✅ | ✅ stolenBases | ✅ stolenBases |
+| pitcher_strikeouts | strikeouts | ✅ | ✅ strikeOuts | ✅ strikeOuts |
+
+**Mapped but NOT requested (free capacity — all supported downstream already):**
+`batter_runs`→runs, `batter_walks`→walks, `pitcher_earned_runs`→earned_runs,
+`pitcher_hits_allowed`→hits_allowed. **Mapped, not requested, and needs feature/
+settle wiring:** `batter_doubles`→doubles, `pitcher_outs`→outs. Confirmed present
+in the real boxscore (§2).
+
+### WNBA / NBA
+Requested: `player_points`, `player_rebounds`, `player_assists`, `player_threes`
+(+ NBA adds `player_blocks`, `player_steals`). All grade-whitelisted. **Features:
+NBA/WNBA game logs come from the Python nba_api service (usually OFFLINE in prod)
+→ l5/l20 often empty; ESPN fallback exists for season avgs only. Outcomes: NOT
+settled at all (outcomeService is MLB-only).** `player_turnovers`/`player_pra` are
+mapped but not requested.
+
+### Soccer
+**PropLine has NO soccer entry** (`SPORT_KEYS`/`MARKETS` omit it) — soccer props
+can only come from the odds-api backup. `MARKET_MAP` maps goals/shots/shots_on_
+target/tackles/cards/corners/saves/passes/clean_sheet. Features: soccer extractor
+exists; outcomes: NOT settled.
+
+### NFL / NHL
+NFL markets mapped + requested (pass/rush/rec yds, receptions, TDs) but the flow
+isn't graded end-to-end yet. NHL mapped/requested but off-season.
+
+---
+
+## 2. MLB box score field map (REAL — Braves @ Pirates, 2026-07-09)
+
+Batting fields present: `runs, doubles, triples, homeRuns, strikeOuts,
+baseOnBalls, hits, atBats, stolenBases, totalBases, rbi, sacFlies, …`
+Pitching fields present: `strikeOuts, baseOnBalls, hits, inningsPitched,
+earnedRuns, outs, battersFaced, …`
+
+**OUTCOME_MAP (MLB) — stat_type → game-log/boxscore field:**
+```
+hits           → hits            total_bases → totalBases    home_runs → homeRuns
+rbi            → rbi             runs        → runs           walks     → baseOnBalls
+stolen_bases   → stolenBases     strikeouts  → strikeOuts     earned_runs → earnedRuns
+hits_allowed   → hits (pitching) innings_pitched → inningsPitched
+doubles        → doubles  ⟵ NEW  triples → triples ⟵ NEW      outs → outs ⟵ NEW
+batter_strikeouts → strikeOuts ⟵ (batter Ks — roadmap)
+```
+Every field above is real in the boxscore/game log → all are settleable today.
+
+## 2b. ESPN box score (WNBA/soccer — the non-MLB settle path)
+WNBA settlement source = ESPN summary `boxscore.players[].statistics[]`
+(`labels`/`names` arrays: PTS/REB/AST/3PM/STL/BLK/TO). No completed game at fetch
+time (all 3 tonight were Scheduled), so labels weren't captured — wiring the ESPN
+settle path is a roadmap item (`espnStatsAdapter` already parses this shape for
+season avgs).
+
+---
+
+## 3. Pipeline flow + gaps
+
+**Current flow:** cron (`SNAPSHOT_CRON=1`, UTC 14,19,22,1,3) → per sport:
+`settleAllOutcomes()` (S55, MLB only) → `snapshotService.runSnapshot` → PropLine
+(3-key rotation) / odds-api backup → `gradeAndCacheSlate` → per-player archetype +
+features → Redis (`snapshot:{sport}:latest`, `grades:{sport}`) → ticker.
+
+**Gaps found:**
+1. **RBI silent failure** — `batter_rbis → rbis` mismatch (§1). FIX this session.
+2. **Under-requesting MLB markets** — only 6 of ~12 supported; runs/walks/doubles/
+   earned_runs/hits_allowed/outs are free in the same call. EXPAND this session.
+3. **Outcome settlement is MLB-only** — WNBA/NBA/soccer grades NEVER settle, so
+   `accuracy` is MLB-only. Biggest roadmap item (needs the ESPN settle path).
+4. **No pipeline alerting** — a failed/empty/missed cron run is silent. ADD ntfy
+   this session.
+5. **No retry** — one PropLine blip marks a sport unavailable for the whole cycle.
+   ADD retry-once this session.
+6. **No missed-cron detector** — nothing notices if a slot didn't fire. ADD.
+7. **NBA/WNBA features depend on an offline Python service** — l5/l20 often empty;
+   ESPN gives season avgs only. Roadmap: an ESPN game-log feature path.
+8. **Soccer has no PropLine source** — odds-api backup only; document + monitor.
+
+---
+
+## 4. Sport coverage status (verified 2026-07-10)
+
+| Sport | Odds props | Grade pipeline | Features | Outcomes | Status |
+|-------|-----------|----------------|----------|----------|--------|
+| MLB | ✅ PropLine + odds-api | ✅ | ✅ real (statsapi) | ✅ (S55) | **LIVE** |
+| WNBA | ✅ odds-api/PropLine | ✅ | ⚠️ Python offline → thin | ❌ not settled | **PARTIAL** |
+| NBA | ⚠️ summer league only | ✅ | ⚠️ offline | ❌ | **OFF-SEASON** |
+| Soccer | ✅ odds-api (no PropLine) | ⚠️ extractor exists | ⚠️ | ❌ | **PARTIAL** |
+| NFL | ⚠️ preseason | ⚠️ mapped, not e2e | ❌ | ❌ | **PRE-SEASON** |
+| NHL | ❌ off-season | ⚠️ mapped | ❌ | ❌ | **DARK** |
+
+---
+
+## 5. Fixes shipped this session (Phase 4/6)
+- `batter_rbis → rbi` (unblocks a market we already request).
+- PropLine MLB MARKETS expanded: +batter_runs, +batter_walks, +batter_doubles,
+  +pitcher_earned_runs, +pitcher_hits_allowed, +pitcher_outs.
+- `doubles` + `outs` wired into featureCache + outcomeService + all three grade
+  whitelists (analyze.js / scan.js / validation.py).
+- Pipeline alerting (ntfy) + PropLine retry-once + missed-cron detector.
+
+See `specs/vyndr-roadmap.md` for the priority-ordered plan that follows from this.
@@ -0,0 +1,96 @@
+# VYNDR Master Roadmap — Generated 2026-07-10 (Session 56)
+
+The foundation document. Derived from the Session-56 data audit
+(`specs/propline-audit.md`, verified against live MLB Stats / ESPN / Odds APIs).
+Every session after this references it. Update it as sessions ship.
+
+---
+
+## Current coverage (verified 2026-07-10)
+
+| Sport | Odds props | Grading | Features (l5/l20) | Outcomes settled | Status |
+|-------|-----------|---------|-------------------|------------------|--------|
+| MLB | ✅ PropLine + odds-api | ✅ | ✅ real (statsapi) | ✅ (S55, expanded S56) | **LIVE** |
+| WNBA | ✅ odds-api/PropLine | ✅ | ⚠️ Python offline → thin | ❌ | **PARTIAL** |
+| Soccer | ✅ odds-api only (no PropLine) | ⚠️ extractor only | ⚠️ | ❌ | **PARTIAL** |
+| NBA | ⚠️ summer league only | ✅ | ⚠️ offline | ❌ | **OFF-SEASON (Oct)** |
+| NFL | ⚠️ preseason | ⚠️ mapped, not e2e | ❌ | ❌ | **PRE-SEASON (Sep)** |
+| NHL | ❌ off-season | ⚠️ mapped | ❌ | ❌ | **DARK (Oct)** |
+
+**The core product is MLB.** It is the only sport that is live end-to-end
+(odds → grade → real features → settled accuracy). Everything else is a
+build-out target.
+
+---
+
+## Gap analysis (from the audit)
+
+1. **Outcome settlement is MLB-only** — WNBA/NBA/soccer grades never settle, so
+   the accuracy record (the S55 trust engine) only reflects MLB. **Highest-value
+   gap.** Needs the ESPN box-score settle path (`espnStatsAdapter` already parses
+   the shape for season avgs).
+2. **NBA/WNBA features depend on an offline Python nba_api service** — l5/l20 are
+   often empty; only season avgs survive (ESPN fallback). Needs an ESPN game-log
+   feature path so intel populates without the Python service.
+3. **Soccer has no PropLine source** — odds-api backup only; no `SPORT_KEYS` entry.
+   Soccer grading isn't wired into the snapshot pipeline end-to-end.
+4. **NFL mapped but not graded end-to-end** — markets normalize, but no feature/
+   outcome path. Wire before September.
+5. ~~RBI silent-failure (rbis/rbi)~~ — **FIXED S56.**
+6. ~~Under-requesting MLB markets~~ — **FIXED S56** (6 → 12 markets).
+7. ~~No pipeline alerting / retry / missed-cron~~ — **FIXED S56.**
+8. **No live calibration** — the accuracy record exists but doesn't yet feed back
+   into grade confidence (spec 2.3 from S55).
+9. **`batter_strikeouts` (batter Ks)** mapped but not feature/settle-wired.
+
+---
+
+## Session plan (priority-ordered)
+
+| Session | Focus | Ships | Scope |
+|---------|-------|-------|-------|
+| 57 | **WNBA/NBA outcome settlement** | ESPN box-score settle path in outcomeService → accuracy for basketball; WNBA goes fully live | M |
+| 58 | **ESPN game-log features** | l5/l10/l20 for NBA/WNBA without the Python service → real intel on basketball grade cards | M |
+| 59 | **Soccer end-to-end** | soccer into the snapshot pipeline (odds-api source), feature extractor wired, ESPN settle | L |
+| 60 | **Live calibration** | accuracy record feeds grade-confidence adjustment (under/over-confident tiers nudge); "Model health: Calibrated/Learning" indicator | M |
+| 61 | **NFL pre-season prep** | NFL feature + settle path (ESPN NFL boxscore) so Week 1 (Sep) is live | L |
+| 62 | **Prop breadth** | `batter_strikeouts`, `triples`, pitcher `walks`; NBA `pra`/`turnovers` requested; WNBA extra markets | S |
+| 63 | **Accuracy depth** | per-archetype hit rates, per-stat hit rates, player-level record ("VYNDR on Judge: 12-5"); ledger UI | M |
+| 64 | **NBA regular-season readiness** | verify NBA pipeline for the Oct tip-off; depth-chart/cascade live | M |
+
+Scope key: S ≈ ½ session, M ≈ 1 session, L ≈ 1–2 sessions.
+
+---
+
+## Stat-type coverage target (fully built)
+
+- **MLB (batters):** hits, total_bases, home_runs, rbi, runs, doubles, triples,
+  walks, stolen_bases, batter_strikeouts. **(pitchers):** strikeouts, earned_runs,
+  hits_allowed, innings_pitched, outs, walks. *(Bold-new this session: doubles,
+  triples, outs, runs, walks requested + settleable.)*
+- **NBA/WNBA:** points, rebounds, assists, threes, steals, blocks, turnovers, pra.
+- **Soccer:** goals, shots, shots_on_target, tackles, cards, corners, saves,
+  passes, clean_sheet.
+- **NFL:** passing/rushing/receiving yards, receptions, pass/rush/rec TDs,
+  anytime_td, interceptions, kicking_points.
+
+## Sport coverage target
+
+- **MLB** ✅ live now (settled accuracy).
+- **WNBA** → live after S57 (settlement) + S58 (features).
+- **Soccer** → live after S59.
+- **NFL** → ready for September (S61).
+- **NBA** → ready for October (S64).
+- **NHL** → ready for October (fast-follow once NBA path exists; shares ESPN pattern).
+
+---
+
+## Operating invariants (do not regress)
+- Three stat_type whitelists stay in sync: `routes/analyze.js`, `routes/scan.js`,
+  `python/utils/validation.py`.
+- A requested market MUST have a `MARKET_MAP` entry (else silent zero) AND, if
+  MLB, a `MLB_LOG_FIELD` entry in BOTH `featureCache` and `outcomeService` (else
+  no features / no settlement).
+- The accuracy pill stays HONEST — "LEARNING" below MIN_SAMPLE, never a faked %.
+- Pipeline alerts (ntfy) fire on success/failure/stale/overdue; the status probe
+  (`GET /api/internal/snapshot/status`) exposes `overdue`.