Struct AskSource 

pub struct AskSource {
    pub path: VaultPath,
    pub heading: String,
    pub date: Option<String>,
    pub score: f64,
    pub text: String,
    pub ordinal: usize,
}

A single retrieved chunk backing an answer — one row of a Turn’s sources, shown in CONTEXT.md’s Sources view / Source reader.

Fields

path: VaultPath

heading: String

date: Option<String>

The chunk’s journal date (YYYY-MM-DD), when the note is a dated journal entry — carried separately from heading so the two render as distinct, spaced elements. None for a non-journal note.

score: f64

text: String

ordinal: usize

The 1-based [n] citation number this source answers to — the explicit pairing every citation lookup keys on, never vec position. Normalized to be non-zero at construction (see AskSource::from_chunk), so no downstream lookup ever sees the wire’s 0 “absent” sentinel.

Implementations

impl AskSource

pub fn from_chunk(position: usize, c: ChunkResult) -> Self

Build from a wire chunk at 0-based position in its list. The ordinal is normalized ONCE, here: a server that sends it wins; a 0 (older server that omits the field) falls back to position + 1, which reproduces the old vec-order convention. Every consumer downstream sees a real ordinal.

For a journal chunk the wire title arrives date-prefixed (e.g. 2026-04-08Afternoon — the date stem glued to the section heading with no separator). We strip that prefix here, keeping date and heading separate, mirroring the prompt builder’s title handling (llmclients::build_prompt) so both surfaces agree.

A nested-section chunk’s title is core’s breadcrumb — the heading path joined with the control-char BREADCRUMB_SEP ("Chapter\x1fSection"). We split it and re-join with a readable HEADING_JOINER so the raw separator never reaches a Sources row or the reader title; the innermost segment (which drives section matching in locate) is recovered by AskSource::match_heading.

pub fn match_heading(&self) -> &str

The innermost heading segment — the one that identifies the retrieved section within its note, for locate::section_range. heading is the full breadcrumb rejoined with HEADING_JOINER for display, so section matching takes only the last segment ("Chapter › Section" → "Section").

pub fn display_heading(&self) -> String

The heading with its date rejoined for a single-line title (the source reader’s panel title): "2026-04-08 · Afternoon" for a journal entry, the bare heading otherwise.

Trait Implementations

impl Clone for AskSource

fn clone(&self) -> AskSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AskSource

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

Formats the value using the given formatter.