feat(@angular/cli): make documentation search tool version-aware #31514
Conversation
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
Implements version-aware search mechanism for the `search_documentation` MCP tool. The tool is now forward-compatible and provides more accurate, context-aware results to the AI assistant. Key features and improvements: - **Dynamic Versioning**: The tool now dynamically constructs the Algolia index name based on the user's project version (`angular_vXX`). - **Unbounded Max Version**: The tool can query for documentation versions newer than the CLI itself, making it forward-compatible. - **Robust Fallback**: If a search for a new or unknown version index fails, the tool automatically falls back to the latest known stable documentation index (`v20`) to ensure a result is always returned. - **Contextual Output**: The tool's output now includes the `searchedVersion`, informing the AI of the exact documentation version that was queried. - **Enhanced AI Guidance**: The tool's description has been updated to instruct the AI on the new versioning logic and how to use the `searchedVersion` field to provide more transparent and accurate answers.
angular-robot
bot
added
detected: feature
clydin
added
the
action: review
alan-agius4
approved these changes
Oct 20, 2025
alan-agius4
added
action: merge
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
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.
Implements version-aware search mechanism for the
search_documentationMCP tool. The tool is now forward-compatible and provides more accurate, context-aware results to the AI assistant.Key features and improvements:
angular_vXX).v20) to ensure a result is always returned.searchedVersion, informing the AI of the exact documentation version that was queried.searchedVersionfield to provide more transparent and accurate answers.