Expand site-absolute spec links in generated docstrings to full URLs

The vendored schema descriptions link to spec pages with site-absolute
paths like (/specification/2025-11-25/basic/index#meta). Copied verbatim
into the generated per-version docstrings, those links don't resolve from
the rendered API reference, and mkdocs' link validation flags each one as
a warning, so the strict docs build on main aborts (54 warnings, all from
api/mcp/types/v2025_11_25/).

Rewrite site-absolute markdown link targets to full
https://modelcontextprotocol.io/... URLs in the generator's
post-processing and regenerate the 2025-11-25 package. The 2026-07-28
package has no such links and is unchanged.

Author: maxisbey

scripts/gen_surface_types.py

@@ -3,8 +3,9 @@
 Runs `datamodel-code-generator` over each `schema/PINNED.json` entry and
 writes the result to `src/mcp/types/v<version>/__init__.py` with only the
 fixes the raw output needs: a small JSON pre-patch for the known
-`number`-as-`integer` schema.json defect, a header, and per-version
-epilogue aliases. Run with `uv run --frozen --group codegen python scripts/gen_surface_types.py [--check]`.
+`number`-as-`integer` schema.json defect, a header, full URLs for the spec's
+site-absolute doc links, and per-version epilogue aliases. Run with
+`uv run --frozen --group codegen python scripts/gen_surface_types.py [--check]`.
 """
 
 from __future__ import annotations
@@ -198,6 +199,10 @@ def build(entry: dict[str, str]) -> str:
     # Codegen appends `| None` to forward refs of nullable models, which is a
     # runtime TypeError on a string ref and redundant since `JSONValue` includes None.
     source = source.replace('"JSONValue" | None', '"JSONValue"')
+    # Schema descriptions link to spec-site pages with site-absolute paths; expand
+    # them to full URLs so they resolve from the rendered API docs and pass the
+    # strict mkdocs link validation.
+    source = source.replace("](/", "](https://modelcontextprotocol.io/")
     source = allow_open_class_extras(source, OPEN_CLASSES[version])
     if epilogue := EPILOGUES.get(version, ""):
         # Insert before the trailing model_rebuild() block: pyright's evaluation