Repository navigation
Move the Python floor to 3.14 - #147
Merged
Merged
Conversation
Owner decision 2026-11-19: Python 3.14 is the only supported runtime. - pyproject: requires-python >=3.14, 3.14-only classifier, black py314, mypy 3.14; drop the dead tomli python_version<3.11 marker. tox.ini envlist/mypy follow. - uv.lock relocked for >=3.14: no version changes, only cp312/cp313 wheels and <3.13/<3.14 markers dropped. - CI: the required agent gate is a single Python 3.14 job (no matrix) named exactly "Protected Evidence - Agent Gate"; release, container and artifact workflows use 3.14. - Dockerfiles: python:3.14-slim; devcontainer image moves to devcontainers/python:3-3.14-bookworm (image major 1 has no 3.14). - release smoke's unconstrained install and the PMCP pilot script run on 3.14; tests updated. - black py314 rewrites parenthesized multi-exception except clauses to the PEP 758 form in 32 files. - Remove trivially dead sys.version_info and tomllib fallbacks; update README, GETTING_STARTED, SUPPORT_MATRIX, AGENTS, CONTRIBUTING, TROUBLESHOOTING and the changelog. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Drop the CHANGELOG [Unreleased] entry (release-only policy), point the MCP scaffold's devcontainer and generated pyproject at 3.14, fix dev.sh's stated container Python, and apply the remaining PEP 758 black rewrite in scripts/v13_pmcp_pilot.py. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Owner decision (2026-11-19): move to Python 3.14. This PR prepares that move. It does not merge, release, publish, or change repository settings.
What changed
pyproject.toml:requires-python = ">=3.14", and the 3.14 classifier is now the only version classifier. blacktarget-version = ["py314"](installed black 26.3.1 supports it), and mypypython_version = "3.14". Removed the deadtomli; python_version<"3.11"marker. No ruff config exists, and isort has no target.tox.inienvlist and its[mypy]follow.uv.lock: relocked for>=3.14. No package versions changed (310 packages before and after). The only changes are dropped cp312/cp313 wheel entries, the dropped< 3.13/< 3.14markers (typing-extensions, andvoyageai's conditionalnumpy, which is a direct dependency anyway), andunicodedata2's marker, which no longer selects it on CPython 3.14.ci-cd-pipeline.ymlnow runs the agent gate as a single Python 3.14 job with no matrix, named literallyProtected Evidence - Agent Gate. A matrix would append its values to the job name.Protected Evidence - Agent Gate Passedis unchanged. Branch protection requiresAlpha Gate - Docker Build And Smoke,Protected Evidence - Agent GateandProtected Evidence - Agent Gate Passed, and all three names are still emitted.PYTHON_VERSIONis now 3.14, andrelease-automation.yml,container-registry.ymlandindex-artifact-management.ymluse 3.14.python:3.12-slimbase underdocker/dockerfiles/is nowpython:3.14-slim..devcontainer/Dockerfilemoves tomcr.microsoft.com/devcontainers/python:3-3.14-bookworm, because image major1publishes no 3.14 tag.scripts/release_smoke.pyUNCONSTRAINED_PYTHONis now 3.14.scripts/v13_pmcp_pilot.pynow requires 3.14 through aPILOT_PYTHONconstant; its refusal code is nowpython_314_required. Deadsys.version_info < (3, 8)branches are removed frompreflight_validator.pyandmcp_health_check.py, and dead tomllib fallbacks and a< (3, 11)skip are removed from tests.codex-setup.shand themcp-index-kitworkflow templates now name 3.14.mcp_server/andtests/, black rewrote parenthesized multi-exceptionexcept (A, B):clauses to the PEP 758 formexcept A, B:. That is the only reformatting change, and the result parses only on Python 3.14 or later.test_requirements_consolidation.py(asserts>=3.14and a 3.14-only classifier, with no dead markers),test_localci_workflow_posture.py,test_p25_release_gates.py,smoke/test_release_smoke_contract.pyandtest_v13_pmcp_pilot.py.docs/status,docs/validation, recorded runs inv13-release.md,plans/,specs/) is left as is.Dependencies without cp314 wheels
On Linux x86_64, all 307 installed distributions (
uv sync --locked --python 3.14 --all-extras) came from cp314, abi3 or pure-Python wheels. None was built from an sdist and none failed to install. Key packages:Across the whole lock:
unicodedata216.0.0 has only an sdist, but its marker no longer selects it on CPython 3.14.watchdog6.0.0 has no cp314 macOS wheel. A macOS 3.14 install builds it from sdist. Linux is unaffected (py3 manylinux wheel), and this was not tested here.pywin32/pywinptyare Windows-only and have cp314 wheels.Flagged: digests, pins, fixtures and published artifacts (not changed outside this repo)
py3-none-any, but its metadata now declaresRequires-Python: >=3.14and only the 3.14 classifier. The next release can't be installed on 3.12 or 3.13. Published1.6.0(>=3.12) is unchanged.python:3.14-slimis a tag, not a digest. No Python base image is digest-pinned anywhere, including compose files. The only digest pins areqdrant/qdrant:v1.17.0@sha256:f1c7…, which is unrelated and unchanged.python:3.14-slimis Debian trixie (glibc 2.41), which meets the language-pack glibc ≥ 2.34 floor. Any published GHCR image digest changes on its next build.1to3, because1-3.14-*does not exist.baml_sdk/output,baml.toml, the generator pin (0.23.0) and the CI toolchain sha256 are unchanged. baml-bridge 0.23.0 is abi3 and installs on 3.14.test_v13_release_candidate.pykeeps its syntheticFROM python:3.12fixture, which is a change-detection input, not a version pin.installed_identity_changedorruntime_command_changed. Changes to pyproject,uv.lockand the pilot script also meanv13_release_candidatewill refuse to reuse earlier live pilot proof. The next release needs fresh 3.14 acceptance for the wheel, the container and the pilot.uv tool install --python 3.12. The next pilot install must use--python 3.14. It was not touched.Local checks (dev0, narrow only)
uv lockanduv sync --locked --python 3.14 --all-extraspassed.import mcp_server, mcp_server.cli, baml_sdkandmcp-index --helpwork on CPython 3.14.10.uv build --wheelproducesindex_it_mcp-1.6.0-py3-none-any.whlwithRequires-Python: >=3.14.make alpha-format-lintpassed (black, isort, flake8, pylint 8.95/10).make alpha-mypy-ratchetfails with 21 violations, and they are pre-existing. The same 21 violations appear, byte-identical, onorigin/mainee42cc4, both with this 3.14 venv and with an existing 3.13 venv. The total is 1,380 errors on main withpython_version3.12, on main with--python-version 3.14, and on this branch, so 3.14 typeshed changes nothing. The enumerated baseline is 1,562. The baseline was not changed.origin/main(checked on main):test_v13_pmcp_pilot.py::…prefetched_cache[cold](grammar error message wording after Per-language degradation when a tree-sitter grammar is unavailable #117),test_release_notes.py::test_changelog_unreleased_empty(Unreleased already had### Changedfrom Per-language degradation when a tree-sitter grammar is unavailable #117) andtest_gasupport_support_contract.py::test_support_matrix_grounds_language_claims….Needs the owner
Release (version bump, PyPI, GHCR) and the dev0 pilot reinstall on Python 3.14 need the owner. Neither was done here.
Review follow-up (6605073)
An independent review on Codex found three issues, now fixed:
[Unreleased]entry, which the release-only policy forbids.test_changelog_unreleased_emptystill fails, but on content that was already onmain.scripts/development/scaffold_mcp.shnow generates a3-3.14-bookwormdevcontainer andrequires-python = ">=3.14", anddev.shnow says the container provides Python 3.14.scripts/v13_pmcp_pilot.py.The review also confirmed:
🤖 Generated with Claude Code
Open in [code]smith · Need help on this PR? Tag
@codesmith-botwith what you need.