docs(packages): Add sphinx-autodoc-fastmcp package page and redirects

why: Publish package reference in docs; legacy extensions/* redirects;
CHANGES entry; doctest expectations for workspace discovery.
what:
- docs/packages/sphinx-autodoc-fastmcp.md and redirects.txt line
- package_reference doctest set; test_package_reference expected names
- CHANGES bullet for the new extension

Author: tony

CHANGES

@@ -20,6 +20,8 @@ $ uv add gp-sphinx --prerelease allow
 
 ### Features
 
+- `sphinx-autodoc-fastmcp`: new Sphinx extension for FastMCP tool docs (card-style
+  `desc` layouts, safety badges, MyST directives, cross-reference roles)
 - Initial release of `gp_sphinx` shared documentation platform
 - `merge_sphinx_config()` API for building complete Sphinx config from shared defaults
 - Shared extension list, theme options, MyST config, font config

docs/_ext/package_reference.py

@@ -41,6 +41,7 @@
 ...     "sphinx-gptheme",
 ...     "sphinx-argparse-neo",
 ...     "sphinx-autodoc-docutils",
+...     "sphinx-autodoc-fastmcp",
 ...     "sphinx-autodoc-pytest-fixtures",
 ...     "sphinx-autodoc-sphinx",
 ... }

docs/packages/sphinx-autodoc-fastmcp.md

@@ -0,0 +1,25 @@
+(sphinx-autodoc-fastmcp)=
+
+# sphinx-autodoc-fastmcp
+
+{bdg-warning-line}`Alpha` {bdg-link-secondary-line}`GitHub <https://github.com/git-pull/gp-sphinx/tree/main/packages/sphinx-autodoc-fastmcp>` {bdg-link-secondary-line}`PyPI <https://pypi.org/project/sphinx-autodoc-fastmcp/>`
+
+Sphinx extension for documenting **FastMCP** tools: card-style `desc` layouts
+(aligned with {doc}`sphinx-autodoc-api-style`), safety badges, parameter tables,
+and cross-reference roles (`:tool:`, `:toolref:`, `:badge:`, etc.).
+
+```console
+$ pip install sphinx-autodoc-fastmcp
+```
+
+## Features
+
+- **Tool cards**: `mcp` / `tool` domain `desc` nodes with toolbar badges
+- **Collectors**: `register(mcp)`-style modules or `introspect` mode for `@mcp.tool`
+- **Configuration**: module list, area map, model classes for type cross-refs
+- **MyST directives**: `fastmcp-tool`, `fastmcp-tool-input`, `fastmcp-toolsummary`
+
+## Package reference
+
+```{package-reference} sphinx-autodoc-fastmcp
+```

docs/redirects.txt

@@ -5,5 +5,6 @@ extensions/sphinx-autodoc-pytest-fixtures packages/sphinx-autodoc-pytest-fixture
 extensions/sphinx-autodoc-docutils packages/sphinx-autodoc-docutils
 extensions/sphinx-autodoc-sphinx packages/sphinx-autodoc-sphinx
 extensions/sphinx-autodoc-api-style packages/sphinx-autodoc-api-style
+extensions/sphinx-autodoc-fastmcp packages/sphinx-autodoc-fastmcp
 extensions/sphinx-fonts packages/sphinx-fonts
 extensions/sphinx-gptheme packages/sphinx-gptheme

tests/test_package_reference.py

@@ -23,6 +23,7 @@ def test_workspace_packages_lists_publishable_packages() -> None:
         "sphinx-argparse-neo",
         "sphinx-autodoc-api-style",
         "sphinx-autodoc-docutils",
+        "sphinx-autodoc-fastmcp",
         "sphinx-autodoc-pytest-fixtures",
         "sphinx-autodoc-sphinx",
         "sphinx-fonts",