stathead 0.3.2__tar.gz → 0.3.3__tar.gz

{stathead-0.3.2 → stathead-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stathead
-Version: 0.3.2
+Version: 0.3.3
 Summary: Python client for the StatHead fantasy football model — rookie career predictions, historical ADP, and flattened feature matrices.
 Project-URL: Homepage, https://github.com/dachhack/stathead
 Project-URL: Source, https://github.com/dachhack/stathead
@@ -154,7 +154,7 @@ available here as a pandas DataFrame.
 | Function | Returns | Shape |
 |---|---|---|
 | `load_redraft_projections()` | Seasonal redraft PPG (PPR) + receptions/game | ~250 × 7 |
-| `load_weekly_projections()` | Per-week matchup-adjusted projections, one row per player-game (opp, home, matchup mult, PPR pts; `df.attrs['def_vs_pos']`) | ~445 × 17 rows/player |
+| `load_weekly_projections()` | Per-week matchup-adjusted projections incl. kickers + team DST, one row per player-game (opp, home, matchup mult, PPR pts, gsis/sleeper ids; `df.attrs['def_vs_pos']`) | ~509 × 17 rows/player |
 | `load_ppg_projections()` | Model-predicted PPG for established players | ~250 × 4 |
 | `load_adp_value_model()` | VOR vs ADP, hit probability, confidence interval | ~153 × 10 |
 | `load_volume_projections()` | Team pass/rush/target volumes with low/high bands | ~153 × ~14 |

{stathead-0.3.2 → stathead-0.3.3}/README.md

@@ -126,7 +126,7 @@ available here as a pandas DataFrame.
 | Function | Returns | Shape |
 |---|---|---|
 | `load_redraft_projections()` | Seasonal redraft PPG (PPR) + receptions/game | ~250 × 7 |
-| `load_weekly_projections()` | Per-week matchup-adjusted projections, one row per player-game (opp, home, matchup mult, PPR pts; `df.attrs['def_vs_pos']`) | ~445 × 17 rows/player |
+| `load_weekly_projections()` | Per-week matchup-adjusted projections incl. kickers + team DST, one row per player-game (opp, home, matchup mult, PPR pts, gsis/sleeper ids; `df.attrs['def_vs_pos']`) | ~509 × 17 rows/player |
 | `load_ppg_projections()` | Model-predicted PPG for established players | ~250 × 4 |
 | `load_adp_value_model()` | VOR vs ADP, hit probability, confidence interval | ~153 × 10 |
 | `load_volume_projections()` | Team pass/rush/target volumes with low/high bands | ~153 × ~14 |

{stathead-0.3.2 → stathead-0.3.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "stathead"
-version = "0.3.2"
+version = "0.3.3"
 description = "Python client for the StatHead fantasy football model — rookie career predictions, historical ADP, and flattened feature matrices."
 readme = "README.md"
 license = { text = "MIT" }

{stathead-0.3.2 → stathead-0.3.3}/src/stathead/__init__.py

@@ -42,7 +42,7 @@ from .prospects import load_prospect_grades
 from .sql import list_tables, query, register
 from .stats import load_player_stats
 
-__version__ = "0.3.2"
+__version__ = "0.3.3"
 
 __all__ = [
     "__version__",

{stathead-0.3.2 → stathead-0.3.3}/src/stathead/projections.py

@@ -48,7 +48,9 @@ def load_redraft_projections() -> pd.DataFrame:
 def load_weekly_projections() -> pd.DataFrame:
     """Per-week 2026 projections — the season projection split across the
     schedule, one row per player per scheduled game (17 rows/player; byes
-    omitted).
+    omitted). Covers QB/RB/WR/TE plus kickers (position ``K``, the current
+    depth-chart PK1 per team) and team defenses (position ``DST``, name
+    ``"<TEAM> DST"``, ``sleeper_id`` = team code).
 
     Weekly points = season PPG x opponent defense-vs-position multiplier
     (prior-season PPR allowed per game vs league average, heavily regressed)
@@ -57,9 +59,11 @@ def load_weekly_projections() -> pd.DataFrame:
     games (health) discount. Half/Std conversion: weekly receptions scale
     with the same multiplier, so ``rec_w = recPG * proj_ppr / ppg``.
 
-    Columns: ``player_key``, ``name``, ``position``, ``team``, ``week``,
-    ``opp``, ``home``, ``matchup_mult``, ``proj_ppr``, ``ppg``, ``recPG``,
-    ``gp``, ``season``.
+    Columns: ``player_key``, ``name``, ``position``, ``team``, ``gsis_id``,
+    ``sleeper_id``, ``week``, ``opp``, ``home``, ``matchup_mult``,
+    ``proj_ppr``, ``ppg``, ``recPG``, ``gp``, ``season``. The gsis/sleeper
+    ids are stamped at build time from the player crosswalk (None for
+    pre-NFL rookies).
 
     Metadata on ``df.attrs``: ``meta`` (generatedAt + method note) and
     ``def_vs_pos`` (per-team defense-vs-position multiplier table).
@@ -82,6 +86,8 @@ def load_weekly_projections() -> pd.DataFrame:
                 "name": p["name"],
                 "position": p["pos"],
                 "team": p["team"],
+                "gsis_id": p.get("gsis"),
+                "sleeper_id": p.get("sleeper"),
                 "week": week,
                 "opp": game["opp"],
                 "home": game["home"],

{stathead-0.3.2 → stathead-0.3.3}/tests/test_smoke.py

@@ -143,6 +143,11 @@ def test_weekly_projections():
     sums = df.groupby("name").agg(total=("proj_ppr", "sum"), ppg=("ppg", "first"))
     assert ((sums["total"] - sums["ppg"] * 17).abs() < 1.0).all()
     assert isinstance(df.attrs.get("def_vs_pos"), dict)
+    # K + DST: one per team, 32 each.
+    assert (df[df["position"] == "K"]["team"].nunique()) == 32
+    dst = df[df["position"] == "DST"]
+    assert dst["team"].nunique() == 32
+    assert (dst["sleeper_id"] == dst["team"]).all()
 
 
 def test_ppg_and_adp_value_model():