* feat(common): sports_rotation -- the reconciled other-games rotation (sports family 7)
New hardware-free module src/common/sports_rotation.py, copied from
ledmatrix-plugins claude/family7-reconcile once the nine scoreboards made
_by_importance, _other_games_window, _advance_other_games_if_due (two bodies
each), _rotate_other_games_on_display (two) and _attach_odds_to_rotated_games
(three; ufc had none) one body each. All of them live on the plugins'
SportsCore, so one mixin, SportsRotationMixin, carries exactly those five plus
the default _rankings_loaded, and no manager gains a method it lacks today.
- The window advances under _games_lock: update() and display() both advance
it, and interleaved, each added a width and skipped a window.
- The display path's due-check reads the pool _compose_selection will cut,
unfiltered fallback included.
- Rotated-in games get odds when show_odds is on (decided 2026-10-09: ufc
too), skipped without an odds manager.
- _rankings_loaded() is the seam _by_importance asks: the abbreviation table
by default; football overrides it to count its by-id rankings.
- test/test_sports_rotation.py: the plugins' pinned cases (importance order
per rankings table and the seam, the window over time, the display-path
rotation incl. the card on screen, redraws and recompose counts, update()
and display() in sequence and interleaved on two threads -- with and
without the lock -- and rotated-in odds), plus the host contract.
- test/test_sports_rotation_parity.py: with LEDMATRIX_PLUGINS, compares each
body with every plugin copy (drift-report normalisation plus decorators),
checks no other plugin class carries a copy, and that only football
overrides _rankings_loaded. Passes against claude/family7-reconcile; fails
against the pre-reconcile tree, as it should.
- mypy ratchet, src/common/README.md, CHANGELOG (Unreleased, New modules).
- sports_shared docstring: _by_importance and _other_games_window (and the
long-promoted _is_favorite_game) leave the "stay per-plugin" list.
- docs/SPORTS_UNIFICATION.md: family 7 status, decisions, the
_rankings_loaded seam; families 5 and 6 marked done and adopted (3.8.1 /
ledmatrix-plugins #631, 3.8.2 / #637) instead of "adoption waits".
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* docs(sports): stage 4 is adopted (core 3.8.0, ledmatrix-plugins #594)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* docs: cite ledmatrix-plugins #641 for the family 7 reconcile
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
