gnomonlearn
Docs/RFC-0026/Reference catalog

RFC-0026 · 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-0026: defined terms, diagnostics, dependencies, and invariants. It does not establish proof coverage or runtime conformance. The authored narrative lives in RFC-0026.

This page is generated from the lean/Gnomon/Spec/ module for RFC-0026. Edit that source and regenerate this catalog.


Title: gRPC Protocol Binding
Status: draft

Depends on: RFC-0001, RFC-0006, RFC-0008, RFC-0024
Extended by: RFC-0030, RFC-0034

Proof citations in source: 4 / 4. Standalone proof verification is pending.


Definitions

(none defined)

Diagnostics

CodeSeverityDescription
M26610ErrorgRPC transient status code (UNAVAILABLE or DEADLINE_EXCEEDED) received with no matching transient selector in the errors {} block.
M26611ErrorgRPC auth error (UNAUTHENTICATED or PERMISSION_DENIED) received with no matching selector in the errors {} block.
M26612ErrorgRPC NOT_FOUND status received with no matching selector in the errors {} block.
M26613ErrorgRPC status code not covered by special cases received with no matching selector in the errors {} block.
M26614Errortls: none is set on a client in a production environment. Startup is aborted.
M26615Errorservice: or rpc: slot missing from a gRPC operation; or streaming mode constraints violated (incorrect input or returns shape for declared mode:).
M26616ErrorA gRPC call exceeded its deadline: and was cancelled by the runtime. Reported to the caller as DEADLINE_EXCEEDED.

Dependency neighborhood

graph LR
  nRFC_0026["RFC-0026"]
  nRFC_0001["RFC-0001"]
  nRFC_0026 --> nRFC_0001
  nRFC_0006["RFC-0006"]
  nRFC_0026 --> nRFC_0006
  nRFC_0008["RFC-0008"]
  nRFC_0026 --> nRFC_0008
  nRFC_0024["RFC-0024"]
  nRFC_0026 --> nRFC_0024
  nRFC_0030["RFC-0030"]
  nRFC_0030 --> nRFC_0026
  nRFC_0034["RFC-0034"]
  nRFC_0034 --> nRFC_0026

Invariants

  1. A gRPC call exceeding its deadline must be cancelled by the runtime immediately upon expiry and reported as DEADLINE_EXCEEDED via M26616. (enforced by: runtime)
  2. An operation with mode bidi-streaming must have exactly one Stream input field and a Stream returns type. (enforced by: compile-time)
  3. An operation with mode client-streaming must contain exactly one input field of type Stream, otherwise the compiler emits M26615. (enforced by: compile-time)
  4. An operation with mode server-streaming must declare a returns type of Stream, otherwise the compiler emits M26615. (enforced by: compile-time)
  5. Implementations must propagate the deadline as a gRPC deadline on the outgoing call so the server is also notified, not merely as a client-side timer. (enforced by: runtime)
  6. In a production environment the runtime must reject any client with tls: none and raise M26614 as a startup-time error, refusing to start. (enforced by: runtime)
  7. gRPC connections default to TLS using the system certificate store and require no explicit configuration. (enforced by: runtime)
  8. gRPC status codes outside the special cases and not matched by any errors selector must be treated as non-retryable and reported as M26613. (enforced by: runtime)

Normative Statements

Statements are structured source data. Proof citations, where present, have not passed a standalone Gnomon proof gate.

Auth

  1. MUST — Authors needing api-key or basic auth MUST use auth: none and inject credentials via custom interceptors.

Call Mode Semantics

  1. MUST — bidi-streaming operations MUST have one Stream input field and Stream returns.
  2. MUST — client-streaming operations MUST contain exactly one input field of type Stream.
  3. MUST — server-streaming operations MUST declare returns as Stream. (proof citation: rfc0026_b8_grounded; verification pending)

Slot Extensions

  1. MUST — A cancelled deadline-exceeded call MUST produce M26616 and be reported as DEADLINE_EXCEEDED. (proof citation: rfc0026_b5_grounded; verification pending)
  2. MUST — A gRPC call exceeding its deadline MUST be cancelled by the runtime immediately upon expiry.
  3. MUST — Implementations MUST propagate the deadline as a gRPC deadline on the outgoing call so the server is notified.

TLS Configuration

  1. MUST — In production environments the runtime MUST reject any client with tls: none and raise M26614, refusing to start. (proof citation: rfc0026_b3_grounded; verification pending)
  2. MUST — The runtime MUST detect the active environment at startup.

gRPC Status Code Taxonomy

  1. MUST — Unlisted unmatched gRPC status codes MUST be treated as non-retryable and reported as M26613. (proof citation: rfc0026_b12_grounded; verification pending)

Linked References

DirectionTarget
Depends onRFC-0001
Depends onRFC-0006
Depends onRFC-0008
Depends onRFC-0024
Extended byRFC-0030
Extended byRFC-0034