sdv-toolkit

Use to audit Python docstring completeness/quality in sdv-py — flags public callables missing Google-style napoleon Args/Returns/Raises/Example or See-Also blocks, and any raw >>> doctest prompts.

Use after adding/editing an ESPN parser in sdv-py to verify the universal parser contract and ENDPOINT_PARSERS coverage.

Use when changing sdv-py network code (dl_utils.download, capture/crawl tooling) to verify the retry/pooling/backoff/bounding conventions.

Use after writing/editing polars code in sdv-py to catch 0.18-era API that must be 1.x. Flags groupby/with_row_count/apply/pl.count/cumsum/set_at_idx/how=outer/str.strip and lookaround regex.

Use to map a captured provider payload (ESPN/Fox/CBS/Yahoo) into documentation — produces a top-level-key table, a col_name|type|description returns table, and divergence-vs-sibling notes.

Add a CBS Sports (NAPI) league/resource — capture + catalog in sdv-internal-refs/cbs.

Register a new ESPN league family in sdv-py — leagues.yaml row, pre-create package dir + __init__, regenerate, gated live test, verify the drift gate.

Add a Fox Sports (Bifrost) league/sport — capture + catalog in sdv-internal-refs/fox.

Add a league/source for ANY SportsDataverse provider (ESPN, Fox Bifrost, CBS NAPI, Yahoo, 247Sports, Torvik) — capture bodies, generate the returns doc, extend the catalog, scaffold the wrapper.

Add sport-specific tidy parsers for an ESPN sport (soccer/cricket pattern) — parser module + per-sport codegen routing + fixtures + TDD.

6 hooks across 2 events