release: v3.1.0 — Legible to machines

[MarkusNeusinger]

Cuts v3.1.0, the first release since v3.0.0 on 2026-06-10 — 84 changelog entries over two months.

Version choice

Minor, by the repo's own rule. agentic/commands/release.md reserves major for "new language/library waves, rebrands, breaking URL/schema changes". This window has none: no new language, no new library, no rebrand. It is a large feature batch, not a milestone in that sense — the owner confirmed the reading.

Codename: Legible to machines

The theme is that an assistant asked about a plot can now find it, open one library's page, read the runnable source, fetch the rendered image and cite the URL. That path was broken at four separate points, every one of them invisible to anyone browsing the site by hand:

• Googlebot walked an infinite redirect on /{spec}/{language}
• a trailing slash sent crawlers to a host whose robots.txt forbids crawling
• unknown library names produced an unbounded supply of indexable near-duplicates
• seven AI fetchers were served the empty SPA shell

Plus the crawler policy opening to every operator that follows the rules — the only way Gemini can ever cite the catalogue — and two Plausible sites separating what people read from what machines do.

The three files

File	Change
CHANGELOG.md	[Unreleased] → [3.1.0] — 2026-08-18 — Legible to machines, fresh empty [Unreleased], both compare links, intro paragraph, two aggregate lines
pyproject.toml	3.0.0 → 3.1.0
uv.lock	the project's own pin, one line

Aggregates

• Dependencies bullet now covers all 32 Dependabot bumps of the window; it listed nine. It also points at the one that took the site down (the vite 8.1.5 bump in deps(npm): Bump the npm-minor group across 1 directory with 13 updates #9657), which is written up under Fixed.
• Catalog line records 1,607 implementation merges across 15 libraries, 10 new plot types, and the catalogue at 324 specifications.

On the lock file

uv lock also normalised platform markers on secretstorage and statsmodels — drift between the committed lock and a newer uv. Unrelated to the release and it would have made this diff harder to audit, so uv.lock carries only the version line here. uv lock --check passes as committed. Worth a separate housekeeping change.

Completeness check

Every non-exempt commit since v3.0.0 was matched against the changelog. Eleven appeared unreferenced; ten are spec: add … (spec-create output, exempt) and the eleventh — the white-screen outage fix — is documented, under the Dependabot PR number that caused it rather than the fix PR's. No gaps.

pytest tests/unit 1648 passed; ruff check clean.

After merge

Tag and publish per agentic/commands/release.md:

git tag -a v3.1.0 -m "Legible to machines (2026-08-18)" && git push origin v3.1.0
gh release create v3.1.0 --title "v3.1.0 — Legible to machines" --notes-file <tmp>

The site masthead picks the tag up on its own — nothing to deploy.

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Prepares the v3.1.0 (“Legible to machines”) release by finalizing the changelog for the release window and bumping the project version so packaging and lock metadata reflect the new release.

Changes:

• Promote [Unreleased] content to a new ## [3.1.0] — 2026-08-18 — Legible to machines section, refresh [Unreleased], and update compare links.
• Bump the project version from 3.0.0 → 3.1.0 in pyproject.toml.
• Update the anyplot package version pin in uv.lock to 3.1.0.

Reviewed changes

Copilot reviewed 2 out of 3 changed files in this pull request and generated no comments.

File	Description
CHANGELOG.md	Adds the v3.1.0 release section, keeps an empty [Unreleased], updates aggregate bullets and compare links.
pyproject.toml	Bumps [project].version to 3.1.0.
uv.lock	Updates the editable anyplot package’s version to 3.1.0 to match the release.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[Copilot]

Pull request overview

Copilot reviewed 2 out of 3 changed files in this pull request and generated no new comments.