Repository navigation
[Production] Release 2026-10-09 - #302
Merged
Merged
Conversation
* Bundle the docs pages into the web app for the MCP server
A script in the docs site writes every hand-written docs page as Markdown
into web/lib/mcp/docs/, using the same text the site serves at /docs/<page>.md.
make docs-catalogs runs it last, and docs-lint.yml fails when the committed
copy is stale.
The docs package becomes an ES module package so Node can load the Fumadocs
output, and gains tsx to run the script.
Co-authored-by: Wasim Amiri <wasimxyz@users.noreply.github.com>
* Answer questions about Data Hub through search_docs and read_doc
Adds two MCP tools and a datahub://docs/{page} resource template that serve
the bundled docs pages and the changelog. search_docs returns up to five
matching sections with excerpts and links, and lists every page when nothing
matches. read_doc returns one page or one section, so no call loads all the
docs. Analytics record result counts and page IDs, never the query text.
Co-authored-by: Wasim Amiri <wasimxyz@users.noreply.github.com>
* Rewrite the MCP server instructions to fit Claude Code's 2 KB limit
The old text was 2.2 KB, so Claude Code cut off the feedback guidance. The
new text says what Data Hub is, points how-to questions at search_docs, and
no longer sends agents to the glossary resource, which most clients cannot
read on their own.
Co-authored-by: Wasim Amiri <wasimxyz@users.noreply.github.com>
* Test docs search, the docs tools, and the instructions size
Adds 21 golden questions that each name the page that should answer them,
tests for the Markdown helpers and page references, protocol tests for the
two tools and the resource template, analytics tests, and a test that keeps
the server instructions under 2 KB. The integration test also calls both
tools against the production build, which proves the bundled docs and the
changelog ship with the app.
A test found that a card description ending in a period got a second one in
search excerpts, so that is fixed too.
Co-authored-by: Wasim Amiri <wasimxyz@users.noreply.github.com>
* Document answering questions about Data Hub over MCP
Adds a section to the MCP overview page, a changelog entry, a developer page
on how the docs bundle and search work, and notes in AGENTS.md and
docs/site/AGENTS.md that docs changes need make docs-catalogs. The bundled
docs are regenerated to include the new MCP section.
Co-authored-by: Wasim Amiri <wasimxyz@users.noreply.github.com>
* Keep angle brackets and drop table rules in docs excerpts
Excerpts lost the closing > of text such as <token_id> and showed rows of
table dashes. Docs resource names now add a page suffix only to the second
and later pages that share a title, so the first stays plain.
Co-authored-by: Wasim Amiri <wasimxyz@users.noreply.github.com>
* Rename the docs corpus files to docs bundle
Co-authored-by: Cursor <cursoragent@cursor.com>
* Flag docs searches that don't answer the question, and address review
search_docs now counts a section as an answer only when it holds two thirds of the question's words and every word appears in the docs. Otherwise it adds a hint that names missing words and offers send_feedback, and analytics counts it in the 0 bucket. Watcher bump instructions now regenerate the docs bundle, the code uses 'bundle' instead of 'corpus', and the MCP catalog carries the tool group labels the docs site reads.
Co-authored-by: Cursor <cursoragent@cursor.com>
---------
Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: Wasim Amiri <wasimxyz@users.noreply.github.com>
Contributor
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This branch was successfully deployed
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
1 participant
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.
No description provided.