Skip to content

docs: fix stale Algolia description and wrong tool-name reference - #44

Merged
mattpodwysocki merged 2 commits into
mainfrom
fix/stale-docs-tool-descriptions
Sep 9, 2026
Merged

mattpodwysocki merged 2 commits into
mainfrom
fix/stale-docs-tool-descriptions

Conversation

@mattpodwysocki

Copy link
Copy Markdown
Contributor

Summary

Two stale references left over from the Algolia-to-llms.txt search migration:

  • search_mapbox_docs_tool's README entry still said "Searches Mapbox documentation using Algolia full-text search." That dependency was removed a while back (see the "Replace Algolia search with self-contained llms.txt search" CHANGELOG entry) — it now searches a self-hosted keyword index built from llms.txt files, no Algolia involved.
  • get_document_tool's own description field — the text shown to the LLM, not just docs — referenced a tool named get_latest_mapbox_docs_tool, which doesn't exist anywhere in the codebase. Fixed to reference the real search_mapbox_docs_tool, since the wrong name was actively misdirecting tool-chaining behavior.

Test plan

  • npm run build
  • npx vitest run — 85 tests passing
  • npx eslint --fix — clean
  • CHANGELOG.md updated under Unreleased

🤖 Generated with Claude Code

search_mapbox_docs_tool's README entry still said it used Algolia
full-text search, left over from before that dependency was replaced
with the self-contained llms.txt index (throttling under the hosted
server's shared free-tier quota was the reason for the migration).

Separately, get_document_tool's own description - the text shown to
the LLM, not just docs - referenced a tool named
get_latest_mapbox_docs_tool, which doesn't exist and was actively
misdirecting tool-chaining behavior. Fixed to reference the real
search_mapbox_docs_tool.
@mattpodwysocki
mattpodwysocki requested a review from a team as a code owner September 9, 2026 14:04
@ox-security

ox-security Bot commented Sep 9, 2026 •

Copy link
Copy Markdown

OX Security Logo

OX Security reviewed this pull request — nothing to fix.

✔ No issues found

Branch fix/stale-docs-tool-descriptions → main

View scan in OX Security →

Spellcheck has been failing on main since PR #43 merged (client
identification) - it uses server.server.oninitialized, which isn't a
real word and was never added to the dictionary. Unrelated to this
PR's changes but fixing here since it's currently the only thing
blocking CI.
@mattpodwysocki
mattpodwysocki merged commit d1f32cc into main Sep 9, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants