Skip to content

Commit 94ddac9

Browse files
committed
fix(docs[ext]): Log warnings when tool reference URI resolution fails
why: _resolve_tool_refs silently fell back to same-page anchors when get_relative_uri failed, masking broken cross-references. what: - Add logger.warning before fallback in _resolve_tool_refs
1 parent f3cec5f commit 94ddac9

1 file changed

Lines changed: 5 additions & 0 deletions

File tree

docs/_ext/fastmcp_autodoc.py

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -922,6 +922,11 @@ def _resolve_tool_refs(
922922
if labelid:
923923
newnode["refuri"] += "#" + labelid
924924
except Exception:
925+
logger.warning(
926+
"fastmcp_autodoc: failed to resolve URI for %s -> %s",
927+
fromdocname,
928+
todocname,
929+
)
925930
newnode["refuri"] = "#" + labelid
926931
newnode["classes"].append("reference")
927932
newnode["classes"].append("internal")

0 commit comments

Comments
 (0)