Struct Lineage 

#[non_exhaustive]
pub struct Lineage {
    pub parent_id: DocumentId,
    pub chunk_index: u32,
    pub total_chunks: u32,
    pub splitter: String,
    pub chunker_chain: Vec<String>,
}

Split-history — survives every transformation. A leaf chunk’s Lineage describes which parent it came from, which split produced it, and which chunkers ran over it. Audit / debug flows reconstruct the path from a retrieval hit back to the ingestion source by walking the lineage chain (parent_id → loader’s source URI).

None on the original Document produced by a DocumentLoader — only chunked descendants carry lineage.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

parent_id: DocumentId

Document id of the parent this chunk descends from. Walks up through every split layer to the original loaded document.

chunk_index: u32

Position of this chunk within the immediate parent’s split output. Zero-based.

total_chunks: u32

Total number of chunks the parent produced. Lets retrieval surfaces show “chunk 3 of 12” provenance.

splitter: String

Stable identifier of the splitter that produced this chunk. "recursive-character", "markdown-structure", etc. — surfaces in audit dashboards.

chunker_chain: Vec<String>

Stable identifiers of every chunker that processed this chunk after the split, in order. "contextual", "hyde", … — empty when no chunker ran.

Implementations

impl Lineage

pub fn from_split( parent_id: DocumentId, chunk_index: u32, total_chunks: u32, splitter: impl Into<String>, ) -> Self

Build the lineage entry a splitter stamps onto each child chunk. The chunker chain starts empty; downstream chunkers append themselves via Self::push_chunker.

pub fn push_chunker(&mut self, chunker: impl Into<String>)

Append a chunker identifier to this chunk’s chain — called by Chunker impls when they transform a chunk.

Trait Implementations

impl Clone for Lineage

fn clone(&self) -> Lineage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Lineage

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Lineage

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Lineage

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Lineage

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Lineage

impl StructuralPartialEq for Lineage