Context
#198 adds an important schema stability policy and names Cannot query field as stable validation/error text. Luis' latest review notes that downstream compatibility actually depends on three literal markers:
Cannot query field
Unknown argument
Unknown type
mina-explorer-api matches all three to classify UpstreamSchemaError, drive tier fallback, and poison its capability cache. mina-explorer keys mostly on Cannot query field.
Follow-up work
- Update the policy/docs so all three literal markers are named as stable downstream contract, not only
Cannot query field.
- Make it clear that changing any of the three messages, masking them, or replacing them with armor/cost-limit errors can be breaking.
- Consider explicit regression tests for
Unknown argument and Unknown type alongside the existing Cannot query field checks.
Acceptance criteria
Related
Context
#198 adds an important schema stability policy and names
Cannot query fieldas stable validation/error text. Luis' latest review notes that downstream compatibility actually depends on three literal markers:Cannot query fieldUnknown argumentUnknown typemina-explorer-apimatches all three to classifyUpstreamSchemaError, drive tier fallback, and poison its capability cache.mina-explorerkeys mostly onCannot query field.Follow-up work
Cannot query field.Unknown argumentandUnknown typealongside the existingCannot query fieldchecks.Acceptance criteria
docs/versioning.mdor the schema stability policy names all three stable markers.Related