Promote the v2 README to README.md ahead of the first v2 beta

The repo front page still showed the v1 README while every release cut
from main is a v2 pre-release. Make the v2 README (README.v2.md) the
root README, with a banner that makes the status unmissable: alpha/beta
pre-release line, breaking changes between pre-releases, not for
production, v1.x is the stable line.

Retire the freeze machinery that kept README.md pinned at v1:

- the readme-v1-frozen pre-commit hook and the CI freeze check with its
  override-readme-freeze label gate
- the --readme indirection in scripts/update_readme_snippets.py (the
  script now reads README.md, its only remaining purpose)
- dead config that existed only for the split: the ruff hook exclude,
  the pyproject ruff extend-exclude entries, the SKIP env in shared.yml,
  and the examples/ trigger on the readme-snippets hook

Point pyproject's readme at README.md so PyPI keeps publishing the v2
long description, and add a release-checklist step to bump the version
examples in README.md and the docs when cutting a pre-release - the
tagged commit's README is what PyPI shows.

Author: maxisbey

.github/workflows/shared.yml

@@ -27,8 +27,6 @@ jobs:
       - uses: pre-commit/action@2c7b3805fd2a0fd8c1884dcaebf91fc102a13ecd # v3.0.1
         with:
           extra_args: --all-files --verbose
-        env:
-          SKIP: no-commit-to-branch,readme-v1-frozen
 
       - name: Surface types match vendored schema
         run: |
@@ -42,19 +40,6 @@ jobs:
           uv run --isolated --no-project --with ./src/mcp-types python -c \
             "import mcp_types, mcp_types.jsonrpc, mcp_types.methods, mcp_types.version, mcp_types.v2025_11_25, mcp_types.v2026_07_28"
 
-      # TODO(Max): Drop this in v2. Deliberate updates (e.g. the v2 status
-      # banner) go through the 'override-readme-freeze' label.
-      - name: Check README.md is not modified
-        if: github.event_name == 'pull_request' && !contains(github.event.pull_request.labels.*.name, 'override-readme-freeze')
-        run: |
-          git fetch --no-tags --depth=1 origin "$BASE_SHA"
-          if git diff --name-only "$BASE_SHA" -- README.md | grep -q .; then
-            echo "::error::README.md is frozen at v1. Edit README.v2.md instead."
-            exit 1
-          fi
-        env:
-          BASE_SHA: ${{ github.event.pull_request.base.sha }}
-
   test:
     name: test (${{ matrix.python-version }}, ${{ matrix.dep-resolution.name }}, ${{ matrix.os }})
     runs-on: ${{ matrix.os }}
@@ -116,7 +101,7 @@ jobs:
         run: uv sync --frozen --all-extras --python 3.10
 
       - name: Check README snippets are up to date
-        run: uv run --frozen scripts/update_readme_snippets.py --check --readme README.v2.md
+        run: uv run --frozen scripts/update_readme_snippets.py --check
 
   # `mkdocs.yml` sets `strict: true` and `pymdownx.snippets: check_paths: true`,
   # but until this job existed the docs were only ever built post-merge by

.pre-commit-config.yaml

@@ -42,7 +42,6 @@ repos:
         types: [python]
         language: system
         pass_filenames: false
-        exclude: ^README(\.v2)?\.md$
       - id: pyright
         name: pyright
         entry: uv run --frozen pyright
@@ -55,15 +54,9 @@ repos:
         language: system
         files: ^(pyproject\.toml|uv\.lock)$
         pass_filenames: false
-      # TODO(Max): Drop this in v2.
-      - id: readme-v1-frozen
-        name: README.md is frozen (v1 docs)
-        entry: README.md is frozen at v1. Edit README.v2.md instead.
-        language: fail
-        files: ^README\.md$
       - id: readme-snippets
         name: Check README snippets are up to date
         entry: uv run --frozen python scripts/update_readme_snippets.py --check
         language: system
-        files: ^(README\.v2\.md|docs_src/.*\.py|examples/.*\.py|scripts/update_readme_snippets\.py)$
+        files: ^(README\.md|docs_src/.*\.py|scripts/update_readme_snippets\.py)$
         pass_filenames: false

AGENTS.md

@@ -12,8 +12,7 @@
   shim) must be documented in `docs/migration.md`.
 - `v1.x` is the release branch for the current stable line. Backport PRs target
   this branch and use a `[v1.x]` title prefix.
-- `README.md` is frozen at v1 (a pre-commit hook rejects edits). Edit
-  `README.v2.md` instead.
+- `README.md` documents v2. The v1 README lives on the `v1.x` branch.
 
 ## Package Management
 

CONTRIBUTING.md

@@ -105,7 +105,7 @@ uv run ruff check .
 uv run ruff format .
 ```
 
-7. Update README snippets if you modified example code:
+7. Update README snippets if you modified `docs_src/` code embedded in the README:
 
 ```bash
 uv run scripts/update_readme_snippets.py