Skip to content

Move the Python floor to 3.14 - #147

Merged
ViperJuice merged 2 commits into
mainfrom
chore/python-3.14-floor
Nov 19, 2026
Merged

ViperJuice merged 2 commits into
mainfrom
chore/python-3.14-floor

Conversation

@ViperJuice

@ViperJuice ViperJuice commented Nov 19, 2026 •

Copy link
Copy Markdown
Collaborator

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. black target-version = ["py314"] (installed black 26.3.1 supports it), and mypy python_version = "3.14". Removed the dead tomli; python_version<"3.11" marker. No ruff config exists, and isort has no target. tox.ini envlist 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.14 markers (typing-extensions, and voyageai's conditional numpy, which is a direct dependency anyway), and unicodedata2's marker, which no longer selects it on CPython 3.14.
  • CI: ci-cd-pipeline.yml now runs the agent gate as a single Python 3.14 job with no matrix, named literally Protected Evidence - Agent Gate. A matrix would append its values to the job name. Protected Evidence - Agent Gate Passed is unchanged. Branch protection requires Alpha Gate - Docker Build And Smoke, Protected Evidence - Agent Gate and Protected Evidence - Agent Gate Passed, and all three names are still emitted. PYTHON_VERSION is now 3.14, and release-automation.yml, container-registry.yml and index-artifact-management.yml use 3.14.
  • Docker: every python:3.12-slim base under docker/dockerfiles/ is now python:3.14-slim. .devcontainer/Dockerfile moves to mcr.microsoft.com/devcontainers/python:3-3.14-bookworm, because image major 1 publishes no 3.14 tag.
  • Code and scripts: scripts/release_smoke.py UNCONSTRAINED_PYTHON is now 3.14. scripts/v13_pmcp_pilot.py now requires 3.14 through a PILOT_PYTHON constant; its refusal code is now python_314_required. Dead sys.version_info < (3, 8) branches are removed from preflight_validator.py and mcp_health_check.py, and dead tomllib fallbacks and a < (3, 11) skip are removed from tests. codex-setup.sh and the mcp-index-kit workflow templates now name 3.14.
  • black py314 reformatting: in 32 files under mcp_server/ and tests/, black rewrote parenthesized multi-exception except (A, B): clauses to the PEP 758 form except A, B:. That is the only reformatting change, and the result parses only on Python 3.14 or later.
  • Tests updated: test_requirements_consolidation.py (asserts >=3.14 and a 3.14-only classifier, with no dead markers), test_localci_workflow_posture.py, test_p25_release_gates.py, smoke/test_release_smoke_contract.py and test_v13_pmcp_pilot.py.
  • Docs: README, GETTING_STARTED, SUPPORT_MATRIX, AGENTS, CONTRIBUTING, TROUBLESHOOTING and the pilot runbook describe the new runtime. No CHANGELOG entry: under the release-only policy, the note goes into the next versioned release section. Dated evidence (docs/status, docs/validation, recorded runs in v13-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:

Package Version Wheel tag
tree-sitter 0.26.0 cp314-cp314 manylinux_2_17
tree-sitter-language-pack 1.20.0 cp310-abi3 manylinux_2_34
treesitter-chunker 6.0.0 py3-none-any
baml-bridge 0.23.0 cp310-abi3 manylinux_2_17
pydantic-core 2.46.2 cp314-cp314
numpy 2.4.4 cp314-cp314
qdrant-client / voyageai / openai 1.17.1 / 0.3.7 / 2.32.0 py3-none-any
torch (semantic) 2.11.0 cp314-cp314
grpcio / orjson / zstandard / xxhash / hiredis / asyncpg / psycopg2-binary — cp314-cp314
cryptography / bcrypt / argon2-cffi-bindings / psutil / tokenizers — abi3

Across the whole lock:

  • unicodedata2 16.0.0 has only an sdist, but its marker no longer selects it on CPython 3.14.
  • watchdog 6.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/pywinpty are Windows-only and have cp314 wheels.
  • CUDA and triton packages are Linux-only by marker.

Flagged: digests, pins, fixtures and published artifacts (not changed outside this repo)

  • PyPI wheel: still py3-none-any, but its metadata now declares Requires-Python: >=3.14 and only the 3.14 classifier. The next release can't be installed on 3.12 or 3.13. Published 1.6.0 (>=3.12) is unchanged.
  • Container bases: python:3.14-slim is a tag, not a digest. No Python base image is digest-pinned anywhere, including compose files. The only digest pins are qdrant/qdrant:v1.17.0@sha256:f1c7…, which is unrelated and unchanged. python:3.14-slim is Debian trixie (glibc 2.41), which meets the language-pack glibc ≥ 2.34 floor. Any published GHCR image digest changes on its next build.
  • Devcontainer: the image major changed from 1 to 3, because 1-3.14-* does not exist.
  • BAML: generated 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.
  • Fixtures: no committed fixtures or evidence JSON were changed. test_v13_release_candidate.py keeps its synthetic FROM python:3.12 fixture, which is a change-detection input, not a version pin.
  • Release gates: release smoke's unconstrained install now creates a 3.14 venv. The PMCP pilot script now requires 3.14, so manifests recorded on 3.12 fail installed_identity_changed or runtime_command_changed. Changes to pyproject, uv.lock and the pilot script also mean v13_release_candidate will refuse to reuse earlier live pilot proof. The next release needs fresh 3.14 acceptance for the wheel, the container and the pilot.
  • dev0 pilot: the pilot is installed with 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 lock and uv sync --locked --python 3.14 --all-extras passed. import mcp_server, mcp_server.cli, baml_sdk and mcp-index --help work on CPython 3.14.10. uv build --wheel produces index_it_mcp-1.6.0-py3-none-any.whl with Requires-Python: >=3.14.
  • make alpha-format-lint passed (black, isort, flake8, pylint 8.95/10).
  • make alpha-mypy-ratchet fails with 21 violations, and they are pre-existing. The same 21 violations appear, byte-identical, on origin/main ee42cc4, both with this 3.14 venv and with an existing 3.13 venv. The total is 1,380 errors on main with python_version 3.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.
  • Touched tests, run serially: test_requirements_consolidation, test_release_metadata, smoke/test_release_smoke_contract, test_localci_workflow_posture, test_p25_release_gates, test_v13_pmcp_pilot, test_v13_release_candidate, test_chunker_adapter and test_preflight_validation gave 343 passed and 1 failed. tests/docs and the release-note, readiness and audit tests gave 273 passed and 2 failed. All 3 failures also fail on 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 ### Changed from Per-language degradation when a tree-sitter grammar is unavailable #117) and test_gasupport_support_contract.py::test_support_matrix_grounds_language_claims….
  • The full suite was not run on dev0 (shared host). GitHub CI runs the full gates.

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:

  • Removed the CHANGELOG [Unreleased] entry, which the release-only policy forbids. test_changelog_unreleased_empty still fails, but on content that was already on main.
  • scripts/development/scaffold_mcp.sh now generates a 3-3.14-bookworm devcontainer and requires-python = ">=3.14", and dev.sh now says the container provides Python 3.14.
  • Applied the remaining PEP 758 black rewrite in scripts/v13_pmcp_pilot.py.

The review also confirmed:

  • The required check contexts are exact, and no rulesets apply.
  • The release, PyPI, GHCR and attestation paths have no stale version references.
  • All 310 lockfile identities and versions are unchanged.
  • The 32 black-only files have identical ASTs on 3.14.
  • The removed version checks were dead.
  • No action, Qdrant, signing or fixture digests changed.

🤖 Generated with Claude Code


Autofix with [code]smith
Open in [code]smith · Need help on this PR? Tag @codesmith-bot with what you need.

ViperJuice and others added 2 commits November 19, 2026 03:36
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>
@ViperJuice
ViperJuice marked this pull request as ready for review November 19, 2026 09:16
@ViperJuice
ViperJuice merged commit b368401 into main Nov 19, 2026
12 checks passed
@ViperJuice
ViperJuice deleted the chore/python-3.14-floor branch November 19, 2026 09:16
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 19, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-19T09:17:45.581995Z 6605073 Draft marked ready
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant