RFC-0027 · Reference catalog
Versioned draft snapshot
RFCs, reference catalogs, and evidence reflect Spec 3b2e3e7a114fb826b1445d39a48756b8fff629cd. Counts and pending/status notes belong to that snapshot. Read the dated project update for later progress.
Source repositories are private during staging. Links marked “repository access required” need access to the linked repository.
Generated reference catalog. This page renders structured Lean data for RFC-0027: defined terms, diagnostics, dependencies, and invariants. It does not establish proof coverage or runtime conformance. The authored narrative lives in
RFC-0027.This page is generated from the
lean/Gnomon/Spec/module for RFC-0027. Edit that source and regenerate this catalog.
Title: GraphQL Protocol Binding
Status: draft
Diagnostic range: M27000-M27999
Depends on: RFC-0001, RFC-0006, RFC-0008, RFC-0024, RFC-0025
Extended by: RFC-0031, RFC-0034
Proof citations in source: 2 / 2. Standalone proof verification is pending.
Definitions
(none defined)
Diagnostics
| Code | Severity | Description |
|---|---|---|
M27710 | Warning | GraphQL partial result: both data and errors are present in the response. The operation succeeded, but some fields may be missing or null. |
M27711 | Error | operationType: slot missing from a GraphQL operation in a client that imports gnomon.io.graphql; or operationType: subscription declared with a non-streaming returns type; or unhandled GraphQL hard error (no matching selector in errors {}). |
M27712 | Error | selection: slot missing from a GraphQL operation. |
M27713 | Error | A $variableName token referenced in the selection: string is not declared in the effective variables: list (explicit or implicit). |
Dependency neighborhood
graph LR
nRFC_0027["RFC-0027"]
nRFC_0001["RFC-0001"]
nRFC_0027 --> nRFC_0001
nRFC_0006["RFC-0006"]
nRFC_0027 --> nRFC_0006
nRFC_0008["RFC-0008"]
nRFC_0027 --> nRFC_0008
nRFC_0024["RFC-0024"]
nRFC_0027 --> nRFC_0024
nRFC_0025["RFC-0025"]
nRFC_0027 --> nRFC_0025
nRFC_0031["RFC-0031"]
nRFC_0031 --> nRFC_0027
nRFC_0034["RFC-0034"]
nRFC_0034 --> nRFC_0027
Invariants
- An operation declared with operationType: subscription MUST have a returns type of Stream
. (enforced by: compile-time) - Authors requiring strict semantics MUST declare a wildcard errors selector that classifies any non-null errors array as terminal. (enforced by: runtime)
- Every $variableName referenced in the selection string MUST be present in the effective variables set. (enforced by: compile-time)
- GraphQL mutation and subscription operations MUST NOT be cached by the runtime; only query operations may be cached. (enforced by: runtime)
- The runtime MUST NOT automatically retry a GraphQL mutation unless its errors {} block classifies the relevant error as transient. (enforced by: runtime)
Normative Statements
Statements are structured source data. Proof citations, where present, have not passed a standalone Gnomon proof gate.
Error Shape Mapping
- MUST — Authors requiring strict all-or-nothing semantics MUST declare a wildcard errors selector classifying partial results as terminal.
Operation Type Semantics
- MUST — A subscription operation’s returns type MUST be Stream
where T is the per-event type. - MUST_NOT — Mutation and subscription operations MUST NOT be cached.
- MAY — Query operations MAY be cached by the runtime. (proof citation:
rfc0027_b3_grounded; verification pending) - MUST_NOT — The runtime MUST NOT retry a mutation automatically unless errors {} classifies the relevant error as transient.
Slot Extensions
- MUST — operation {} blocks within a client using gnomon.io.graphql MUST declare operationType: and selection: slots.
Variable Binding
- MUST — A $fieldName referenced in selection: but absent from the effective variable set MUST cause M27713 at compile time. (proof citation:
rfc0027_b0_grounded; verification pending)
Linked References
| Direction | Target |
|---|---|
| Depends on | RFC-0001 |
| Depends on | RFC-0006 |
| Depends on | RFC-0008 |
| Depends on | RFC-0024 |
| Depends on | RFC-0025 |
| Extended by | RFC-0031 |
| Extended by | RFC-0034 |