Repository navigation
v1.1.0 — Developer Experience and Open-Source Adoption
Developer experience and open-source adoption release. No breaking changes. Feature-complete for the v1.1 public API surface.
Added
Dataset Hub
midwicket.datasets.load_dataset(name)— single-call loader for 12 Cricsheet competitions (IPL, T20s, BBL, PSL, CPL, WBBL, SA20, MLC, ODIs, Tests, all_t20, all)list_datasets()— returns the full registry with match counts, format, and source URLs
Feature Store (10 builders)
build_pressure_index,build_bowler_quality_rating,build_batter_intent_score,build_match_context_scorebuild_venue_bias_rating,build_expected_runs,build_expected_wicketsbuild_batting_form,build_death_over_metrics,build_venue_adjusted_form- All builders support temporal scoping via
start_date/end_date
Scouting Reports
midwicket.scouting_report(player_name)— phase splits, venue performance, career batting/bowling, weakness detection, recent form- Case-insensitive name resolution with alias support (
"V Kohli"="Virat Kohli"="kohli")
Showcase Portfolio
- 25 showcase scripts in
examples/ - 10 executed showcases in
docs/showcases/with publication-quality charts (PNG, 150 DPI), SQL queries, walkthroughs, and key findings README_SHOWCASES.mdgallery landing page
Developer Documentation
README.mdcomplete overhaul — hero → insights → quick start → datasets → features → scouting → gallery → architecturedocs/getting_started.md— 5-minute tutorial from install to first scouting reportdocs/gallery.md— 10-showcase gallery with charts, queries, key findingsdocs/onboarding_audit.md— 4-persona first-time user audit with prioritised fixesFEATURES.md— complete feature store reference
Fixed (Data Reliability)
- Retirement classification:
RETIRED_HURT/RETIRED_NOT_OUTcorrectly markedis_wicket=False - int16 overflow prevention:
overupcasted to int16;runs_batter/runs_extrasupcasted to int32 - Temporal leakage: date filters in all feature builders verified leak-proof
- VBR stabilisation: venues with <5 matches default to VBR = 1.0
Full Changelog
See CHANGELOG.md for the complete change history.