SurfaceDiagnostic

Type: Object

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

Fields

Name	Type	Args	Description	Deprecated
code	String!		Stable diagnostic code (e.g. "GQL_VALIDATION", "X_BAD_PATH"). See DiagnosticCode in SurfaceKit for the full catalogue.
hint	String		Fix advice from the diagnostic catalogue; null when unavailable.
message	String!		Human-readable description of the finding.
path	String!		definition-rooted path to the problematic location (e.g. "definition.steps[0].fetch.document").
severity	String!		Severity level: "error", "warning", or "info".