v0.3.0 - Server operation, evidence archive, and discovery metrics

Fantasy Football Manager 0.3.0 adds server operation, durable evidence collection, and GitHub discovery measurement. A Linux coordinator can visit configured ESPN teams and run the season workflow after the control connection closes.

Changes

• Added a coordinator with a shared browser profile lease, exact league and team checks, weekly lineup checks, and cooperative shutdown. Each eligible step can submit one qualifying lineup swap under the configured policy.
• Added a durable SQLite evidence outbox and a PostgreSQL archive. Imports preserve immutable records, labels, content hashes, and source context. Repeat imports do not create duplicate records.
• Added consistent SQLite backups, PostgreSQL backup and restore tools, and generic systemd templates.
• Added a weekly GitHub metrics collector for views, clones, referrers, and star counts. It preserves overlapping daily observations without adding overlapping unique counts. Endpoint failures remain explicit.
• Clarified archive provenance. The collection runtime does not identify the executor of historical events. An authorization or a confirmed platform result alone does not establish who clicked.

Verified

• All seven CI jobs passed for the release commit.
• The local Chrome-enabled suite passed 608 tests, with 2 skips. Linux validation passed 23 PostgreSQL tests and 28 metrics tests.
• Two configured teams completed server observations. Neither team required a lineup change. This check made zero live lineup writes and left zero pending actions.
• The initial archive import added 2,128 records, 4,186 labels, and 2 runs. An identical repeat import added zero records.
• Backup restoration matched all four archive table counts. Both restored SQLite databases passed integrity checks. Service restart and browser profile lease recovery passed.
• The four distribution artifacts match the release commit. The privacy scan found no prohibited private data. SHA256SUMS.txt contains their hashes.

Limits

The server observations did not validate a live lineup submission. Automatic week rollover, live waiver claims, acquisitions, drops, and trades remain outside this release's verified workflow. An expired ESPN session requires sign-in. A full server reboot and a physical shutdown of the control computer were not tested.

The archive is a private operational dataset. It can retain private league and team identifiers. GitHub traffic and stars do not measure installations or active users. This is a prerelease; projections and simulations do not guarantee draft or season results.

v0.2.2 — ESPN draft compatibility and recovery

Version 0.2.2 adds draft-room compatibility, complete-history recovery, and separate league state with a shared browser profile.

The local regression suite passed 509 tests, including 15 isolated Chrome cases: 5 draft and 10 season cases.
All six jobs passed in the CI run for this release commit.
The installed wheel passed STDIO checks for 17 manager tools and 13 ESPN tools.
The installed ESPN command also passed an authenticated Week 1 sync and a five-second advisory monitor check, then stopped.
The local Codex plugin was installed at version 0.2.2.

The live development run verified all 160 draft picks and a 16-player roster.
The manager confirmed 13 selections. ESPN Autopick made 3 selections during failures.
The run required manual recovery, source changes, and restarts. One manager proposal reconciled as not_selected.
No duplicate submissions were observed. This was not an unattended draft.
Read the live acceptance record for the failure log and receipt measurements.

That live run used installed v0.2.1 dependencies with changing working-tree patches, including this release candidate.
It does not establish live write acceptance for the installed v0.2.2 wheel.
The separate Week 1 read and lineup analysis found no required change. No season action was submitted.

Each league can use its own database while controllers share one browser profile in sequence through FFM_BROWSER_DATA_DIR.
Only one controller can hold that profile lease. A multi-league scheduler and automatic week rollover are not implemented.
Three additional drafts and a five-team season evaluation are planned, not verified outcomes.
Read the multi-team acceptance plan.

The assets contain the Python wheel, source distribution, Codex plugin ZIP, plugin manifest, and SHA-256 checksums.
This is a GitHub prerelease. PyPI and MCP Registry publication remain incomplete.

v0.2.1 ? Verified ESPN connection preview

The patch fixes live ESPN response handling after authenticated account verification. It recognizes the weekly column header, binds player-only responses to the exact verified request URL, refreshes ownership after roster changes, and waits for page navigation.

League rankings now remain incomplete when lock evidence covers only the selected team.

Verified: 400 local tests passed, including 14 isolated Chrome cases. Authenticated reads loaded 14 teams and a 14-player selected roster. The advisory monitor refreshed state and calculated a legal nine-slot lineup. Both installed MCP commands passed STDIO checks; the installed ESPN command also passed authenticated read verification. No live team action was submitted.

The plugin includes 17 manager tools and 13 ESPN tools. Draft and lineup automation support saved modes, limits, strategies, durable verification, and a standalone local worker.

Live draft and lineup write acceptance remains untested. Live acquisitions, drops, trades, and automatic week rollover remain planned. PyPI and MCP Registry publication remain pending.

Install the wheel before the Codex plugin. v0.2.0 remains available as an unchanged historical preview.

GitHub CI passed on Windows and Ubuntu, including Chrome fixtures and packaging.

v0.2.0 ? ESPN MCP automation preview

The preview adds an ESPN MCP companion to the existing manager. Automatic modes can submit draft picks and weekly lineup swaps under saved user limits.

• 17 manager tools and 13 ESPN tools.
• Continuous draft simulations and weekly lineup analysis.
• Durable action claims, browser verification, crash recovery, and a standalone local worker.
• Configurable automation modes, strategies, freshness limits, and roster limits.

Verified locally: 364 tests passed, including 13 isolated Chrome integration cases. Both installed commands passed STDIO checks. Browser tests use fictional data and local HTML.

Live account acceptance remains untested. An ESPN sign-in and a live mock draft are required for that check. Live acquisitions, drops, trades, and automatic week rollover remain planned. PyPI and MCP Registry publication remain pending.

Install the wheel before the Codex plugin. The plugin ZIP registers both installed commands.

GitHub CI passed on Windows and Ubuntu, including isolated Chrome fixtures and packaging.

v0.1.0 ? local fantasy manager preview

This preview provides 17 local MCP tools for imported fantasy league snapshots and fictional demonstrations.

• Draft simulation with five strategies and repeated Monte Carlo batches.
• Weekly lineup, waiver, and projected power ranking tools.
• Per-action automation modes, protected players, spending limits, and atomic action proposals.
• Local Codex plugin with draft and season skills, JSON schemas, and Mermaid diagrams.

Execution changes synthetic data only. Live ESPN/Sleeper writes and trades are unsupported. PyPI and MCP Registry publication remain pending publisher setup.

Validation: 105 tests passed locally. The initial GitHub test matrix passed on Windows and Ubuntu with Python 3.11 and 3.14. The installed wheel passed STDIO tool calls, proposal confirmation, and idempotence checks.

Install the wheel with uv tool install <downloaded-wheel-path>. See the repository plugin installation guide for Codex setup. SHA256SUMS.txt records the artifact hashes.