Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

0.15.1 - 2026-07-28

Compare with 0.15.0

Docs

amend the constitution to 2.4.0 for plain writing (f6fc2a2 by georgedouzas).
rewrite the documentation and examples in plain English (4f08106 by georgedouzas).

0.15.0 - 2026-07-27

Compare with 0.14.0

Features

execution as one pipeline, four steps, both modes (ee6d72d by georgedouzas).
execute the value bets one match at a time (2b96ceb by georgedouzas).
the tools reach what the commands reach (36a26a8 by georgedouzas).
follow the money, and drive a site an agent can place at (6249397 by georgedouzas).
place the bets a model found, at a venue with a betting API (4a33ac1 by georgedouzas).

Bug Fixes

make execution status work on a single bet's identity (98f7cef by georgedouzas).
read the football-data index against beautifulsoup 4.13 (2b693bc by georgedouzas).

Docs

give the odds-api example a placeholder key (19d2dc2 by georgedouzas).
amend the constitution to 2.3.0 and restructure for clarity (51f8c91 by georgedouzas).
show the single-event unit in the execution example and guide (31dd959 by georgedouzas).
amend the constitution to 2.2.0 with the sweep's lessons (1007cbe by georgedouzas).
restructure the constitution into a repo-agnostic body and a project profile (d1f19f3 by georgedouzas).
tighten source docstrings and extend the docstring rules (64bb490 by georgedouzas).
describe source content in docstrings and amend the constitution (021c69d by georgedouzas).
conform core docstrings to Principle VI (272d64b by georgedouzas).
single-line docstrings for the snapshot hooks (c2823df by georgedouzas).
name what dataloaders/_base is, not what its class does (843c60d by georgedouzas).
plainer package docstrings for dataloaders and sources (7a71903 by georgedouzas).
fold the conventions into the constitution, drop CONVENTIONS.md (a3f059a by georgedouzas).
complete the rename ledger for the conformance sweep (6ba4261 by georgedouzas).
rewrite the reconciliation docs to the current resolve_odds API (d987f6b by georgedouzas).
require plain English in docstrings, and apply it (c7f64ac by georgedouzas).
specify the conventions-conformance refactor (speckit 007) (a99366a by georgedouzas).
adopt the code conventions as constitution Principle VI (8a1dcbb by georgedouzas).
a runnable execution example, and two bugs it found (7748835 by georgedouzas).
show placement in the README, with real tool output (1c7be4d by georgedouzas).
the execution page, leading with what it costs (e96b53c by georgedouzas).
break bet execution into tasks (ea9f722 by georgedouzas).
specify and plan bet execution (06afaa7 by georgedouzas).
sync the constitution to the surfaces that exist (8aa8ac9 by georgedouzas).

Code Refactoring

keep the core helpers in one _utils module (9e20de8 by georgedouzas).
conform all of src to the constitution's code conventions (326b124 by georgedouzas).
conform sources to Principle VI (6804b0e by georgedouzas). BREAKING CHANGE: source methods index_items/catalogue/available_params/required_items/fixtures_items are now list_index_items/read_catalogue/list_available_params/list_required_items/list_fixtures_items; schema methods snapshot_cols/col_metadata/odds_cols are now list_snapshot_cols/get_col_metadata/list_odds_cols; and OddsApi(key=...) is now OddsApi(key_env=...).
conform dataloaders to Principle VI and sharpen the naming rule (e5aaf7d by georgedouzas). BREAKING CHANGE: the dataloader properties sources and sport are now sources_ and sport_.
privatize dataloaders/_base helpers, move event-time grammar to core (9331ee3 by georgedouzas).
make load_object a public core utility (7f11c83 by georgedouzas).
a core subpackage of shared leaves, builders with what they build (968e4ea by georgedouzas).
rework the factory, dataloader persistence and model selection (8fb4971 by georgedouzas).
drop the dead max_unmatched_rate parameter (38eb5e9 by georgedouzas).
conform the mcp package to Principle VI (59fad03 by georgedouzas).
conform the cli package to Principle VI (7c9615b by georgedouzas).
conform the selection and artifacts glue to Principle VI (d52144b by georgedouzas).
conform the execution package to Principle VI (b7668cf by georgedouzas).
conform the evaluation package to Principle VI (fee4516 by georgedouzas).
conform the dataloaders package to Principle VI (109583a by georgedouzas).
conform the sources package to Principle VI (4345af2 by georgedouzas).
restore the source reorganization to green (ed0c53a by georgedouzas). Full gate green: formatting, checks and tests on 3.11, 3.12 and 3.13.
ship no bookmaker, the venue is the user's (be18a8c by georgedouzas).

Chore

Release 0.15.0 (36ef644 by georgedouzas).
point speckit at the conventions-conformance feature (41dcc62 by georgedouzas).

0.14.0 - 2026-07-16

Compare with 0.13.1

Features

Show the results of a command as a table (03c870c by georgedouzas).
Add an MCP server, so an assistant can drive the library (2230389 by georgedouzas).
Add the NBA as a second basketball league (fd6997d by georgedouzas).
Add basketball, starting with the EuroLeague (71381d1 by georgedouzas).
Reconcile two sources, and refuse a dataset with holes in it (c35e3b6 by georgedouzas).
Add the odds source backed by The Odds API (a10fc83 by georgedouzas).
Make date the kick-off instant in UTC (d6c7e6a by georgedouzas).
Replace the mirrored dataset with pluggable data sources (b4e8ae0 by georgedouzas).

Bug Fixes

pass the test suite on Windows (bbff2a9 by georgedouzas).
Do not let the features run past the odds they are bet against (6f07100 by georgedouzas).
Read the catalogue once, and stop the manifest growing forever (affe495 by georgedouzas).
Drop the fake sport from the CLI, and stop the messages lecturing (774eb33 by georgedouzas).
Make the CLI reach the whole API, and fix four bugs it exposed (5fd6afa by georgedouzas).
Do not report a club that belongs to another competition (96d93ca by georgedouzas).
Derive the complementary markets from the data (e817c5d by georgedouzas).
Rebuild the derived data when the transform or the upstream changes (118988f by georgedouzas).

Docs

rewrite the user guide and README, concise and positive (e67d049 by georgedouzas).
rework the example gallery (cf2303c by georgedouzas).
give Interfaces its own landing page (66bba2b by georgedouzas).
rerun and expand the README chat; docstrings say what things do (116ec98 by georgedouzas).
simpler README example, and docstrings that say what things do (d3e244d by georgedouzas).
consolidate the practice guides into one section (2c0adf1 by georgedouzas).
an interfaces menu, a betting guide, and a lighter README (f6c9b4e by georgedouzas).
write the README the way it reads best (e9277a0 by georgedouzas).
fix the warnings the documentation build emits (16c5b3b by georgedouzas).
Make the assistant a first-class way into the library (4908b4a by georgedouzas).
Show what the examples print (7b3b3b8 by georgedouzas).
Give the CLI the same example as the Python API (1f77b06 by georgedouzas).
Say what the CLI does, not what it is not (9b9d97d by georgedouzas).
Rewrite the betting theory, with the mathematics written out (397a86d by georgedouzas).
Document the surfaces, and the two breaking changes (7a3c6df by georgedouzas).
Document the extension surface with runnable examples (2c27189 by georgedouzas).

Code Refactoring

scikit-learn init style, and remove dead code (2d4d879 by georgedouzas).
Pair the rosters of a league, rather than a name against every club (3d05d04 by georgedouzas).
Move parameter discovery from the dataloader to the source (9b78e1f by georgedouzas).

Chore

Release 0.14.0 (3ffbd6c by georgedouzas).

0.13.1 - 2026-07-10

Compare with 0.13.0

Bug Fixes

Drop nptyping so numpy can move to 2.x (20cc10a by georgedouzas).

Chore

Release 0.13.1 (bb63246 by georgedouzas).

0.13.0 - 2026-07-10

Compare with 0.12.1

Features

Add an input horizon and factory construction functions (a04a0c8 by georgedouzas).
Expose target moment in CLI and GUI (364d7b0 by georgedouzas).
Adapt bettors to moment-aware X/Y/O (d33d330 by georgedouzas).
Add soccer and offline dummy snapshot dataloaders (c4dda0b by georgedouzas).
Add moment-aware event-snapshot data model (d2237da by georgedouzas).
Validate pandas schema (05470ca by georgedouzas).
Modify base class (9fcdb3c by georgedouzas).

Bug Fixes

Pass the full odds data to bet when scoring (d92f245 by georgedouzas).
Discover feed parameters from a manifest (1631b4f by georgedouzas).
Make the soccer feed robust to empty fixtures (f4f59e6 by georgedouzas).

Docs

Fix stale betting_markets grammar in the README (7864397 by georgedouzas).
Document all bettor parameters and the grid search (82226c3 by georgedouzas).
Fix the ambiguous user-guide cross-reference (16737ed by georgedouzas).
Expand the dataloader guide and add an end-to-end guide (9ee55ea by georgedouzas).
Document long-format snapshots and consumption (6b1dbae by georgedouzas).
Use market_average provider in bettor examples (090ec29 by georgedouzas).
Align spec-kit gate docs with copier update (ef602ec by georgedouzas).
Update guides and changelog for in-play model (1cbc2b0 by georgedouzas).