Sources & licenses
Golavo’s code is Apache-2.0. Data has its own license and storage boundary. Every displayed source fact carries a source identity; derived context names its input sources and formula version.
Bundled and refreshable core data
Section titled “Bundled and refreshable core data”| Source | Scope | License | Runtime behavior |
|---|---|---|---|
| martj42/international_results | men’s senior full internationals, goalscorers, shootouts, former names | CC0-1.0 | bundled, refreshable, international seal→score source |
| openfootball/worldcup.json | World Cup fixtures, exact kickoff, round and venue context | CC0-1.0 | bundled co-source, refreshable; can corroborate settlement but conflicts fail closed |
| openfootball/football.json | top-five European leagues | CC0-1.0 | bundled and refreshable historical base; a domestic refresh preserves these completed seasons and replaces only the allowlisted current-season table |
| openfootball/england, deutschland, espana, italy, europe | current big-five league schedules and results (Football.TXT) | CC0-1.0 | bundled and refreshable through one exact current-season path per repository; supplies fixture identity, day-precision kickoff, and completed results with field-level provenance. It may extend training history but remains only one result source, so club settlement still requires independent agreement |
| footballcsv/england, deutschland | deep pre-2010 league history (Premier League from 1992-93, Bundesliga from 1963-64) | CC0-1.0 | bundled history packs, a CC0 mirror of openfootball; trimmed to end before football.json’s 2010-11 start so the two never overlap; keeps its own source so it never trains a forecast and cannot be sealed |
| openfootball/champions-league | Champions, Europa, and Conference League main competitions | CC0-1.0 | bundled historical browse/analytics packs; qualifiers excluded |
Each refresh first checks the upstream revision, then captures approved raw bytes under a content hash. Parsers and schemas must pass before a complete generation can activate. Activation is atomic and keeps the previous generation as last-known-good. A timeout, offline state, cancellation, partial download, malformed row, or source conflict never repoints the running index and never changes an existing seal.
Refresh is consent-gated. Golavo can check on launch and periodically while the app is open, or only when you ask. It installs no daemon, Login Item, or LaunchAgent and makes no closed-app monitoring claim. Golavo checks exactly eight repository identities; current club fixtures remain last-known-good or unavailable unless an allowlisted file is genuinely published and passes the schedule and result gates.
Display-only context
Section titled “Display-only context”| Source | Use | License / boundary |
|---|---|---|
| GeoNames | 1,571 unique-exact city-country resolutions with coordinates, timezone and elevation; ambiguous and unresolved pairs stay unavailable | CC-BY-4.0 compact extracted pack with attribution |
| Wikidata | revision-pinned entity IDs, selected aliases and venue metadata | CC0 structured data; no fuzzy automatic identity merge |
| Natural Earth | lightweight offline route basemap | public domain |
Distance, local kickoff, rest and travel are deterministic display context. Missing or conflicting coordinates remain visible as unavailable; none of these values is a model input.
Optional ODbL overlay
Section titled “Optional ODbL overlay”OpenLigaDB is an optional, keyless, per-user overlay under
ODbL-1.0. Golavo ships the adapter and license disclosure, not OpenLigaDB response bytes.
The user must accept the disclosure before fetching allowlisted current-season Bundesliga
1/2/3, DFB-Pokal, or Frauen-Bundesliga data. The women’s competition uses the live-verified
OpenLigaDB shortcut ffb1; the retired fbl1 identity is rejected rather than guessed.
Raw responses, receipts, the SQLite read model, manifests, attribution, and license notice
live under the separate overlays/openligadb Application Support root. The v1 overlay is
display-only. It cannot enter the CC0 match warehouse, source packs, model training,
calibration, forecasts, settlements, redistributable exports, or bundled artifacts. Teams
keep OpenLigaDB source identities; Golavo performs no fuzzy or automatic merge. Conflicts
fail closed. Disabling or deleting the overlay removes its local generations without
touching forecasts, packs, picks, follows, or corrections.
Isolated attributed research
Section titled “Isolated attributed research”The Fjelstul World Cup Database is pinned under CC-BY-SA-4.0 and read only by the facts and history-archive layers. It covers the women’s 1991–2019 and men’s 1930–2022 records; neither category enters the match index or forecast engine. The compact Pappalardo/Wyscout CC-BY-4.0 pack contains team-level summaries for seven competition/era slices; raw events and player identities do not ship. Both remain outside the core match index and model training. Golavo’s disclosed “research xT” is a 12×8 transition calculation, not observed xG.
Optional match research is source-selected, not an ingestion feed. Wikimedia discovery may suggest pages or entities; after explicit selection Golavo captures permitted source text, URL, retrieval time and hash, then routes extracted values into the untrusted local correction queue. DuckDuckGo HTML scraping is disabled. Search never makes a fact authoritative.
Optional BYOK provider context
Section titled “Optional BYOK provider context”Sportmonks Football API v3 is an optional paid per-user connector, not a bundled data dependency. It stays off until the user reviews the current terms disclosure and provides a token. One foreground match click can request an exactly matched provider fixture, external probabilities/odds, and—within the five supported domestic leagues—lineups with player match statistics. Predicted, confirmed, and unavailable lineup states stay distinct; missing statistics are never treated as zero.
The response remains in memory and is neither bundled nor exported. Provider fixture, team, player, lineup, and metric-type ids are preserved. No provider value can enter fitting, forecasts, verdicts, seals, settlement, scoring, calibration, AI evidence, or cross-league rankings. Logos and player photos are not requested. Top-five domestic and all day-precision matching requires exact competition/season scope and normalized teams with distinct numeric provider ids. Other supported matches retain exact-team and exact-kickoff matching and never receive Player Lens. A Football.TXT day-precision fixture can promote only one same-calendar- date candidate. Ambiguous candidates, remaps, and conflicts remain unavailable.
Source main (Unreleased) can expand one already-fetched, identity-safe player row into a
selected-match dossier. That interaction makes no additional provider request and adds no storage:
it groups only the supplied fixture metrics, shows their provider type ids, and clears with the
in-memory response. It does not turn one match into a persistent biography, form series, ranking,
forecast feature, AI evidence, or export.
Enforcement
Section titled “Enforcement”The registry records source ID, license class, attribution, approved hosts/paths, retention and correction rules. CI validates manifests and hashes, generates third-party notices, walks SQLite schemas and JSON artifacts, forbids cross-namespace source IDs, and runs contamination tests across core indexes, training rows, calibration, exports and packaging. The shell grep remains a fast lint; it is not the only isolation control.
Rejected dependencies
Section titled “Rejected dependencies”Golavo does not add adapters for Transfermarkt-derived Kaggle datasets, DataHub football
mirrors, Understat, FBref, Sofascore, FotMob, unofficial FPL endpoints, European Soccer DB,
or eatpizzanot. A downstream license label does not cure incompatible upstream scraping
or database-right terms. Paid APIs and required user keys are not product dependencies.
Weather stays blocked until a lawful historical source preserves what was forecast before
kickoff; observed weather is not an acceptable substitute.
Non-affiliation
Section titled “Non-affiliation”Golavo is not affiliated with, endorsed by, or sponsored by FIFA, UEFA, any league, club, or competition. Competition names are used factually to identify matches. See Legal & brand use.