docs(deps[gp-sphinx]): Wire sphinx-autodoc-pytest-fixtures and dogfood --doctest-docutils-modules

CHANGES

@@ -72,10 +72,14 @@ The docs stack was refreshed through gp-sphinx 0.0.1a17. The visible path includ
 
 Docs deployment now authenticates to AWS through OIDC rather than long-lived static credentials, and the S3 sync no longer passes the removed `--acl public-read` option.
 
+The docs site also picks up `sphinx_autodoc_pytest_fixtures` from gp-sphinx 0.0.1a18 alongside the existing `sphinx_autodoc_api_style`. The new extension introspects pytest fixtures and renders them as first-class autodoc entries; gp-libs has no documentable fixtures today, so the wiring is inert at present and is in place to keep the project aligned with libvcs and libtmux.
+
 ### Development
 
 The project agent instructions gained stricter changelog conventions, doctest requirements, logging standards, functional-test guidance, and commit-message examples. These rules are development policy only; they do not change the gp-libs runtime package.
 
+The default pytest command now dogfoods gp-libs' own `--doctest-docutils-modules` flag in place of pytest's stdlib `--doctest-modules`, and explicitly disables the stdlib doctest plugin via `-p no:doctest`. The shape of `[tool.pytest.ini_options]` matches libvcs and libtmux verbatim. `--reruns=2` from `pytest-rerunfailures` is now part of the default test command, and `README.md` joins `testpaths` so future doctest blocks in it would run automatically.
+
 ## gp-libs 0.0.17 (2025-12-07)
 
 gp-libs 0.0.17 updates the release pipeline to publish through PyPI Trusted Publisher. The package release workflow no longer needs a stored PyPI API token, and publishing can attach package attestations for supply-chain verification.

docs/conf.py

@@ -29,7 +29,7 @@
     source_branch="master",
     light_logo="img/icons/logo.svg",
     dark_logo="img/icons/logo-dark.svg",
-    extra_extensions=["sphinx_autodoc_api_style"],
+    extra_extensions=["sphinx_autodoc_api_style", "sphinx_autodoc_pytest_fixtures"],
     intersphinx_mapping={
         "py": ("https://docs.python.org/", None),
         "pytest": ("https://docs.pytest.org/en/stable/", None),

pyproject.toml

@@ -50,6 +50,7 @@ dev = [
   # Docs
   "gp-sphinx==0.0.1a18",
   "sphinx-autodoc-api-style==0.0.1a18",
+  "sphinx-autodoc-pytest-fixtures==0.0.1a18",
   "gp-libs",
   "sphinx-autobuild",
   # Testing
@@ -72,6 +73,7 @@ dev = [
 docs = [
   "gp-sphinx==0.0.1a18",
   "sphinx-autodoc-api-style==0.0.1a18",
+  "sphinx-autodoc-pytest-fixtures==0.0.1a18",
   "gp-libs",
   "sphinx-autobuild",
 ]
@@ -199,12 +201,23 @@ convention = "numpy"
 "*/__init__.py" = ["F401"]
 
 [tool.pytest.ini_options]
-addopts = "--tb=short --no-header --showlocals --doctest-modules"
-doctest_optionflags = "ELLIPSIS NORMALIZE_WHITESPACE"
+addopts = [
+  "--tb=short",
+  "--no-header",
+  "--showlocals",
+  "--doctest-docutils-modules",
+  "-p no:doctest",
+  "--reruns=2",
+]
+doctest_optionflags = [
+  "ELLIPSIS",
+  "NORMALIZE_WHITESPACE",
+]
 testpaths = [
+  "src",
   "tests",
   "docs",
-  "src",
+  "README.md",
 ]
 filterwarnings = [
   "ignore:distutils Version classes are deprecated. Use packaging.version instead.",