Struct Chunk 

pub struct Chunk {
    pub id: Ulid,
    pub scope: Scope,
    pub episode_id: Ulid,
    pub text: String,
    pub tokens: u32,
    pub offset: u32,
    pub heading_path: Vec<String>,
    pub overlap_tail: String,
    pub embedding: Option<Vec<f32>>,
    pub parent_id: Option<Ulid>,
    pub bt: BiTemporal,
}

Fields

id: Ulid

scope: Scope

RFC 0001 — partition key, inherited from the parent Episode.

episode_id: Ulid

text: String

tokens: u32

offset: u32

heading_path: Vec<String>

overlap_tail: String

embedding: Option<Vec<f32>>

The 768-d embedding vector.

W3 embedding double-store fix (moon-v051-perf-exploit)

skip_serializing is deliberate: the KV KvPut JSON payload used to carry this as a raw JSON float array — ~80% of the document’s bytes and a straight duplicate of the binary vector Moon’s FT index already stores. Nothing on the read path (lunaris-retrieve::hydrate, the tree.rs RAPTOR descent, the detail.rs inspector route) reads .embedding back off a KV-deserialized primitive — verified via find_referencing_symbols before this cut.

#[serde(default)] keeps deserialization tolerant of BOTH shapes: legacy payloads written before this fix (field present) still populate Some(..); payloads written after it (field absent) deserialize to None. This is a one-way, additive-compatible serialize-side change — never a breaking wire format change.

parent_id: Option<Ulid>

Optional link to the nearest parent TocNode in the document tree.

None in Phase 27 (field + migration + serde-compat delivered here; full parent wiring — setting a non-None value — lands in Phase 29). Pre-existing rows serialised without this field deserialise to None via #[serde(default)] (STRUCT-03 serde back-compat contract).

Travels in the existing JSONB KvPut payload — no DDL, no index change. (Through 0.6.x the Postgres backend carried it as chunks.parent_id BYTEA NULL; that backend was removed in 0.7.0.)

bt: BiTemporal

Implementations

impl Chunk

pub fn new( scope: Scope, episode_id: Ulid, text: impl Into<String>, tokens: u32, offset: u32, heading_path: Vec<String>, clock: &HlcClock, ) -> Chunk

Construct a new Chunk.

scope must match the parent Episode::scope (RFC 0001 §3.2).

Trait Implementations

impl Clone for Chunk

fn clone(&self) -> Chunk

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Chunk

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Chunk

fn deserialize<__D>( __deserializer: __D, ) -> Result<Chunk, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Chunk

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Chunk

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Chunk