fix(docs): qualify catalog error severity note for get_product#464
Open
dylanfarrell wants to merge 3 commits into
Open
fix(docs): qualify catalog error severity note for get_product#464dylanfarrell wants to merge 3 commits into
dylanfarrell wants to merge 3 commits into
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
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.
Description
Fixes a misleading guidance note in the Catalog capability spec (
docs/specification/catalog/index.mdL173). The note claims all catalog errors useseverity: "recoverable"and instructs agents to "retry, inform user, show alternatives", but the same spec tree showsget_productreturningseverity: "unrecoverable"for missing identifiers (rest.md:485,mcp.md:612), and the surrounding prose atrest.md:491–494explicitly tells agents not to retry. The rewrite softens "All" to "Most", names theget_productexception, and links the two concrete examples. Prose-only change to one file; no schemas, transports, or other docs touched.Category (Required)
Please select one or more categories that apply to this change.
ucp-schematool (resolver, linter, validator). (Requires Maintainer approval)Related Issues
None filed.
Checklist
!for breaking changes).Screenshots / Logs (if applicable)
uv run mkdocs build- built in 1.01s; the two new cross-links (rest.md#product-not-found,mcp.md#product-not-found) resolve to existing headings atrest.md:462andmcp.md:586.