CricketStudioOKF
SpecificationMethodologyVerified 2026-06-22

Cricket OKF v0.1 — Initial Release

Release notes for CricketStudio OKF v0.1 (2026-06-18). First public release of the curated cricket knowledge bundle. Includes metrics, methodology, IPL player profiles, team files, venues, and the validator pipeline.

Released: 2026-06-18

What's in v0.1

Foundations

  • Repository scaffold with governance docs: README, CONSTITUTION, OPERATING_SYSTEM, LICENSE, ATTRIBUTION, DATA_LICENSE_BOUNDARIES, CHANGELOG
  • Frontmatter JSON Schema (schema/frontmatter.schema.json) with 15 approved types, source_boundary enum, URI and date format validation
  • OKF manifest (manifest.yaml) in Frictionless Data Package format

Curated Content (~174 files)

  • 65 IPL player profiles — phase splits (powerplay/middle/death), pillar claims (P1–P4), H2H records, IPL career history 2007/08–2025
  • 10 IPL 2026 team files — enriched with squad, season record, H2H against all opponents
  • 13 IPL venue files — innings averages, chase win rates, toss tendency, fixture lists
  • 10 metric files — batting SR, bowling economy, death-overs economy, powerplay SR, boundary %, dot-ball %, Orange Cap, Purple Cap, bowling SR, batting average
  • 6 methodology files — sample-size floors, ranking eligibility, phase definitions, citation policy, correction policy, data refresh policy
  • 3 source files — Cricsheet CC BY 3.0, CricketStudio derived claims, licensed-feed boundaries
  • 1 match file — IPL 2026 Final
  • 7 record files — IPL all-time most runs, wickets, sixes, fifties, hundreds, highest score, most matches
  • 8 research files — State of IPL 2026, toss effect, death overs analysis
  • 27 dossier files — verified Q&A patterns for AI agents

Validator and CI

  • scripts/validate_okf.py — schema, provenance, URL, date, internal-link, restricted-pattern, duplicate entity_id checks
  • scripts/check_links.py — internal link verification
  • pytest test suite with passing and deliberately-broken fixture tests
  • .github/workflows/validate.yml — CI on every PR

Viewer

  • Next.js 14 static-export viewer at viewer/
  • Routes: homepage, scorebook, metrics, methodology, research, dossier, agents, about, search, [...slug] catch-all
  • llms.txt, llms-full.txt, ai.txt published at viewer/public/

License

  • Documentation and methodology: CC-BY-4.0
  • Cricsheet-derived content (IPL historical, MLC): CC BY 3.0
  • Licensed-feed derived claims (IPL 2026): CC-BY-4.0 for derived claims only

Conformance Level

Level 1 — Citable (canonical URLs and source boundaries declared). Not yet Level 2 (metric formula coverage incomplete at release time).

cricketokfrelease