Struct SchemaSourceDiagnostic 

pub struct SchemaSourceDiagnostic {
    pub source: &'static str,
    pub versions_found: Vec<String>,
    pub pinned_version_match: bool,
    pub status: Option<&'static str>,
}

One resolution-source line on EngineError::SchemaNotFound’s details.sources payload.

The schema registry consults sources in a fixed order — local storage (the mem’s own storage backend), built-in (compiled into the engine binary), remote (memstead.io, reserved) — and records what each held for the pinned name so an agent or operator can tell where a pin failed: missing from local authoring, absent from the shipped catalogue, or past the not-yet-wired remote. The local_storage/builtin lines report a wrong-version partial match (right name, wrong version) through pinned_version_match.

Fields

source: &'static str

Stable source label: "local_storage", "builtin", or "remote". Agents may branch on it.

versions_found: Vec<String>

Versions of the pinned name this source held, ascending. Empty when the source carried nothing for that name — or was not enumerated (today only remote, see status).

pinned_version_match: bool

true when the pinned exact version is among versions_found. Always false across every source on a genuine not-found (the fixed resolution order means a match on any source would have resolved); a lone true here signals right-name/wrong-version.

status: Option<&'static str>

Non-enumerable status for sources that do not list versions — today only remote, which reports "not_configured". None for the enumerable local_storage/builtin sources.

Implementations

impl SchemaSourceDiagnostic

pub fn for_failed_pin( name: &str, requested: &Version, consulted: &[Arc<Schema>], ) -> Vec<Self>

Build the fixed-order source diagnostics for a failed pin.

consulted is the resolution set the call site actually searched: at boot it is the workspace-authored schemas layered over the built-ins; at the create/migration sites it is the set that path consulted (built-in alone, or workspace + built-in for the migration resolver). The builtin line is recomputed from the static catalogue so it is honest regardless of what the caller passed; anything in consulted the built-in set does not carry is attributed to local_storage. remote is always the reserved not_configured slot.

Trait Implementations

impl Clone for SchemaSourceDiagnostic

fn clone(&self) -> SchemaSourceDiagnostic

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SchemaSourceDiagnostic

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for SchemaSourceDiagnostic

impl PartialEq for SchemaSourceDiagnostic

fn eq(&self, other: &SchemaSourceDiagnostic) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for SchemaSourceDiagnostic

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SchemaSourceDiagnostic