Merge branch 'main' into fix/pre-parse-json-str-union

Author: adityuhkapoor

.github/workflows/shared.yml

@@ -26,7 +26,19 @@ jobs:
         with:
           extra_args: --all-files --verbose
         env:
-          SKIP: no-commit-to-branch
+          SKIP: no-commit-to-branch,readme-v1-frozen
+
+      # TODO(Max): Drop this in v2.
+      - name: Check README.md is not modified
+        if: github.event_name == 'pull_request'
+        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 }})

.pre-commit-config.yaml

@@ -55,6 +55,12 @@ 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

CLAUDE.md

@@ -28,6 +28,9 @@ This document contains critical information about working with this codebase. Fo
    - Bug fixes require regression tests
    - IMPORTANT: The `tests/client/test_client.py` is the most well designed test file. Follow its patterns.
    - IMPORTANT: Be minimal, and focus on E2E tests: Use the `mcp.client.Client` whenever possible.
+   - IMPORTANT: Before pushing, verify 100% branch coverage on changed files by running
+     `uv run --frozen pytest -x` (coverage is configured in `pyproject.toml` with `fail_under = 100`
+     and `branch = true`). If any branch is uncovered, add a test for it before pushing.
 
 Test files mirror the source tree: `src/mcp/client/streamable_http.py` → `tests/client/test_streamable_http.py`
 Add tests to the existing file for that module.