stathead 0.2.0__tar.gz → 0.2.1__tar.gz

{stathead-0.2.0 → stathead-0.2.1}/.gitignore

@@ -25,6 +25,8 @@ public/data/*
 !public/data/qb-beast-ablation.json
 !public/data/ktc-forecasts-*.json
 !public/data/redraft-projections.json
+!public/data/depth-chart-2026.json
+!public/data/career-2027.json
 !public/data/cfbd-college-stats.json
 !public/data/cfbd-sp-ratings.json
 !public/data/cfbd-recruiting.json

{stathead-0.2.0 → stathead-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stathead
-Version: 0.2.0
+Version: 0.2.1
 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
@@ -91,7 +91,7 @@ cache directory or call `clear_cache()` to force a refresh.
 | `load_career_backtest()` | Historical rookies with pred + actual PPG | ~1087 × ~100 cols |
 | `load_adp_historical()` | Model-training ADP 2010-2025 | 4507 × 10 |
 | `load_adp_ffc(season=None)` | FFC PPR raw ADP (per season as fetched) — data via [Fantasy Football Calculator](https://fantasyfootballcalculator.com/adp/ppr) | variable |
-| `load_prospect_grades(year=2026)` | Draft scouting grades | ~200 × 7 |
+| `load_prospect_grades(year=2026)` | Scouting-report grades | ~200 × 7 |
 | `load_feature_matrix()` | Raw `feature-matrix.json` (dict) | — |
 | `load_manual_overrides()` | Manual CFBD usage overrides (dict) | — |
 
@@ -100,7 +100,7 @@ cache directory or call `clear_cache()` to force a refresh.
 Career-prediction and backtest rows include flattened model features
 under names like `collegeDominatorRating`, `relativeAthleticScore`,
 `recruitRating`, `nflDraftPick`, plus two source-agnostic families
-aggregated from the project's scouting pipeline:
+aggregated from the project's scouting-report pipeline:
 
 - **`scout*`** — single-scout grade signals (e.g. `scoutGradeDraft`,
   `scoutTierOrdinal`, `scoutBreadthDraft`, `scoutNComps`).
@@ -109,9 +109,9 @@ aggregated from the project's scouting pipeline:
   `guideNWeaknesses`, `guideSentimentNet`, …).
 
 Both families are derived numeric features (counts, means, ordinals) —
-no verbatim scout text is shipped. `hasScoutGrade` / `hasGuideData`
-flag missing-data so models can distinguish "no scout coverage" from
-"low score".
+no verbatim scouting-report text is shipped. `hasScoutGrade` /
+`hasGuideData` flag missing-data so models can distinguish
+"no scout coverage" from "low score".
 
 ## Licensing & attribution
 
@@ -120,7 +120,7 @@ from the StatHead project's own modeling pipeline; upstream sources
 (nflverse, FFC, CFBD, etc.) retain their own terms — see each source's
 license before redistributing. Sources whose terms do not permit
 third-party redistribution (e.g. KeepTradeCut dynasty values, verbatim
-prose from paid scouting publications) are intentionally not exposed by
+prose from paid scouting reports) are intentionally not exposed by
 this client.
 
 ADP data exposed by `load_adp_ffc` is courtesy of

{stathead-0.2.0 → stathead-0.2.1}/README.md

@@ -63,7 +63,7 @@ cache directory or call `clear_cache()` to force a refresh.
 | `load_career_backtest()` | Historical rookies with pred + actual PPG | ~1087 × ~100 cols |
 | `load_adp_historical()` | Model-training ADP 2010-2025 | 4507 × 10 |
 | `load_adp_ffc(season=None)` | FFC PPR raw ADP (per season as fetched) — data via [Fantasy Football Calculator](https://fantasyfootballcalculator.com/adp/ppr) | variable |
-| `load_prospect_grades(year=2026)` | Draft scouting grades | ~200 × 7 |
+| `load_prospect_grades(year=2026)` | Scouting-report grades | ~200 × 7 |
 | `load_feature_matrix()` | Raw `feature-matrix.json` (dict) | — |
 | `load_manual_overrides()` | Manual CFBD usage overrides (dict) | — |
 
@@ -72,7 +72,7 @@ cache directory or call `clear_cache()` to force a refresh.
 Career-prediction and backtest rows include flattened model features
 under names like `collegeDominatorRating`, `relativeAthleticScore`,
 `recruitRating`, `nflDraftPick`, plus two source-agnostic families
-aggregated from the project's scouting pipeline:
+aggregated from the project's scouting-report pipeline:
 
 - **`scout*`** — single-scout grade signals (e.g. `scoutGradeDraft`,
   `scoutTierOrdinal`, `scoutBreadthDraft`, `scoutNComps`).
@@ -81,9 +81,9 @@ aggregated from the project's scouting pipeline:
   `guideNWeaknesses`, `guideSentimentNet`, …).
 
 Both families are derived numeric features (counts, means, ordinals) —
-no verbatim scout text is shipped. `hasScoutGrade` / `hasGuideData`
-flag missing-data so models can distinguish "no scout coverage" from
-"low score".
+no verbatim scouting-report text is shipped. `hasScoutGrade` /
+`hasGuideData` flag missing-data so models can distinguish
+"no scout coverage" from "low score".
 
 ## Licensing & attribution
 
@@ -92,7 +92,7 @@ from the StatHead project's own modeling pipeline; upstream sources
 (nflverse, FFC, CFBD, etc.) retain their own terms — see each source's
 license before redistributing. Sources whose terms do not permit
 third-party redistribution (e.g. KeepTradeCut dynasty values, verbatim
-prose from paid scouting publications) are intentionally not exposed by
+prose from paid scouting reports) are intentionally not exposed by
 this client.
 
 ADP data exposed by `load_adp_ffc` is courtesy of

{stathead-0.2.0 → stathead-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "stathead"
-version = "0.2.0"
+version = "0.2.1"
 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.2.0 → stathead-0.2.1}/src/stathead/__init__.py

@@ -28,7 +28,7 @@ from .features import load_feature_matrix, load_manual_overrides
 from .predictions import load_career_backtest, load_career_predictions_2026
 from .prospects import load_prospect_grades
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"
 
 __all__ = [
     "__version__",

{stathead-0.2.0 → stathead-0.2.1}/src/stathead/_fetch.py

@@ -18,7 +18,11 @@ from typing import Any
 from urllib.request import Request, urlopen
 
 _BASE_URL = "https://raw.githubusercontent.com/dachhack/stathead"
-_DEFAULT_REF = "main"
+# The repo's data + models live on its default branch (there is no `main`),
+# and the every-2h refresh workflow commits there, so this is the ref that
+# always has fresh feature-matrix / score-store / crosswalk files. Override
+# per-session with pin_version() or per-shell with STATHEAD_REF.
+_DEFAULT_REF = "claude/nfl-fantasy-workbench-6D1yd"
 _ref: str = os.environ.get("STATHEAD_REF", _DEFAULT_REF)