fix: derive MCP navigation from current Base docs config - #20
Open
huklaa wants to merge 10 commits into
Open
Conversation
huklaa
force-pushed
the
fix-16-current-docs-repo
branch
from
August 22, 2026 22:08
e8e056d to
d5379e4
Compare
huklaa
force-pushed
the
fix-16-current-docs-repo
branch
from
August 24, 2026 18:11
7735fb8 to
9285a9e
Compare
huklaa
force-pushed
the
fix-16-current-docs-repo
branch
from
August 27, 2026 08:14
af19db2 to
055bb00
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Addresses #16
This PR keeps the MCP navigation/sidebar in sync with the active Base docs source.
What changes
base/docs/docs/docs.json(replacing the archivedbase/websidebar fetch).navigationtree, supporting tabs, groups, pages, global, and anchors.global.anchorsso onlydocs.base.orgURLs are exposed asguideLinkoptions. Mintlify global anchors also include external destinations (e.g. Status, Blog, Explorer, GitHub); advertising those as guide choices could make the model pick aguideLinkthatgetGuide/getStepsListcannot resolve, since that tool only accepts Base documentation URLs.docs.base.orgwhen the remote config cannot be fetched or parsed.stderr.npm testscript that compiles TypeScript and runs the sidebar tests with Node's built-in test runner.Tests
Existing tests cover navigation and global anchors (including nested tabs/groups/pages, malformed nodes, and missing navigation), and now assert that unsupported external anchors are excluded while
docs.base.organchors are kept as guide choices.Why this is distinct from #12
#12 handles guide file retrieval and candidate path resolution from
base/docs.This PR intentionally leaves that resolver alone and covers the separate navigation-sync part of #16.
Verification
npx tsc --noEmitnpm testgit diff --check