← All types

SurfaceDiagnostic

A single finding from the two-tier surface-definition validator (Tier-1 SurfaceKit + Tier-2 live-schema GraphQL).

Fields

code

String!Non-null

Stable diagnostic code (e.g. "GQL_VALIDATION", "X_BAD_PATH"). See DiagnosticCode in SurfaceKit for the full catalogue.

Severity level: "error", "warning", or "info".

path

String!Non-null

definition-rooted path to the problematic location (e.g. "definition.steps[0].fetch.document").

message

String!Non-null

Human-readable description of the finding.

hint

StringNullable

Fix advice from the diagnostic catalogue; null when unavailable.

Referenced by (1)
Exact type SDL
"""
A single finding from the two-tier surface-definition validator (Tier-1 SurfaceKit + Tier-2 live-schema GraphQL).
"""
type SurfaceDiagnostic {
  """
  Stable diagnostic code (e.g. "GQL_VALIDATION", "X_BAD_PATH"). See DiagnosticCode in SurfaceKit for the full catalogue.
  """
  code: String!
  """Severity level: "error", "warning", or "info"."""
  severity: String!
  """
  definition-rooted path to the problematic location (e.g. "definition.steps[0].fetch.document").
  """
  path: String!
  """Human-readable description of the finding."""
  message: String!
  """Fix advice from the diagnostic catalogue; null when unavailable."""
  hint: String
}