gnomonlearn
Docs/RFC-0027/Reference catalog

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.

← Read the authored RFC

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

CodeSeverityDescription
M27710WarningGraphQL partial result: both data and errors are present in the response. The operation succeeded, but some fields may be missing or null.
M27711ErroroperationType: 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 {}).
M27712Errorselection: slot missing from a GraphQL operation.
M27713ErrorA $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

  1. An operation declared with operationType: subscription MUST have a returns type of Stream. (enforced by: compile-time)
  2. Authors requiring strict semantics MUST declare a wildcard errors selector that classifies any non-null errors array as terminal. (enforced by: runtime)
  3. Every $variableName referenced in the selection string MUST be present in the effective variables set. (enforced by: compile-time)
  4. GraphQL mutation and subscription operations MUST NOT be cached by the runtime; only query operations may be cached. (enforced by: runtime)
  5. 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

  1. MUST — Authors requiring strict all-or-nothing semantics MUST declare a wildcard errors selector classifying partial results as terminal.

Operation Type Semantics

  1. MUST — A subscription operation’s returns type MUST be Stream where T is the per-event type.
  2. MUST_NOT — Mutation and subscription operations MUST NOT be cached.
  3. MAY — Query operations MAY be cached by the runtime. (proof citation: rfc0027_b3_grounded; verification pending)
  4. MUST_NOT — The runtime MUST NOT retry a mutation automatically unless errors {} classifies the relevant error as transient.

Slot Extensions

  1. MUST — operation {} blocks within a client using gnomon.io.graphql MUST declare operationType: and selection: slots.

Variable Binding

  1. 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

DirectionTarget
Depends onRFC-0001
Depends onRFC-0006
Depends onRFC-0008
Depends onRFC-0024
Depends onRFC-0025
Extended byRFC-0031
Extended byRFC-0034