Update analytics/recommendation_logger.py

analytics/recommendation_logger.py

@@ -56,4 +56,46 @@ def build_recommendation_log_rows(
             }
         )
 
+    return pd.DataFrame(rows)
+
+def build_recommendation_outcome_rows(
+    game_row: dict[str, Any],
+    graded_at: str,
+) -> pd.DataFrame:
+    """
+    Placeholder outcome scaffold.
+    Realized fields are left null until a later grading source is connected.
+    """
+    away_team = str(game_row.get("away_team", "") or "").strip()
+    home_team = str(game_row.get("home_team", "") or "").strip()
+    game_pk = str(game_row.get("game_pk", "") or "").strip()
+
+    rows = []
+
+    for slot_key, slot_label in [
+        ("on_deck_name", "On Deck"),
+        ("in_hole_name", "In Hole"),
+        ("three_away_name", "3 Away"),
+    ]:
+        batter_name = str(game_row.get(slot_key, "") or "").strip()
+        if not batter_name:
+            continue
+
+        rows.append(
+            {
+                "created_at": None,
+                "game_pk": game_pk,
+                "away_team": away_team,
+                "home_team": home_team,
+                "batter_name": batter_name,
+                "slot": slot_label,
+                "market": "hr",
+                "realized_hit": None,
+                "realized_hr": None,
+                "realized_tb2p": None,
+                "graded_at": graded_at,
+                "outcome_source": "placeholder",
+            }
+        )
+
     return pd.DataFrame(rows)