Struct QueryExplanation 

pub struct QueryExplanation {

    pub supports: Vec<ExplanationSupport>,
    pub order: EvidenceOrder,
    pub counts: EvidenceCounts,
    pub schema: ExplanationSchema,
    pub query: ExplanationQuery,
    pub label: String,
    pub address: Option<DocumentAddress>,
    pub producer: Option<Producer>,
    pub outcome: ExplanationOutcome,
    pub total: u32,
    pub returned: u32,
    pub next_offset: Option<u32>,
    pub truncation: ExplanationTruncation,
    pub semantics_complete: bool,
    pub diagnostics: Vec<Diagnostic>,
    pub evidence: Vec<ExplanationEvidence>,
}

One readable document’s independently collected explanation evidence.

Fields

supports: Vec<ExplanationSupport>

Source-qualified context shared by the direct owners on this page.

order: EvidenceOrder

Normative category-first ordering, before result pagination.

counts: EvidenceCounts

Per-class collected and returned owners; zero categories remain present.

schema: ExplanationSchema

Exact result family.

query: ExplanationQuery

Normalized request and applied bounds.

label: String

Selected document label.

address: Option<DocumentAddress>

Logical identity, absent for explicit local input.

producer: Option<Producer>

Parser/process provenance, when available.

outcome: ExplanationOutcome

Evidence versus no-evidence before page slicing.

total: u32

Number of collected matching owners before pagination; a lower bound when candidate or relationship traversal is truncated.

returned: u32

Matching owners returned on this page.

next_offset: Option<u32>

More already-collected owners remain after this page.

truncation: ExplanationTruncation

Independent collection, relation traversal and body-copy bounds.

semantics_complete: bool

Semantic validation coverage, never a recall-completeness claim.

diagnostics: Vec<Diagnostic>

Original recoverable validation/parser findings.

evidence: Vec<ExplanationEvidence>

Records in class-then-source order, with independent owners never merged.

Implementations

impl QueryExplanation

pub fn validate_references(&self) -> Result<(), &'static str>

Validate page-local source references and returned position domains. Deserialization runs this check; in-memory producers can call it too.

Errors

Returns an error for dangling, wrong-owner or out-of-bounds references.

Trait Implementations

impl Clone for QueryExplanation

fn clone(&self) -> QueryExplanation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QueryExplanation

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for QueryExplanation

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Eq for QueryExplanation

impl JsonSchema for QueryExplanation

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for QueryExplanation

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for QueryExplanation

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 QueryExplanation