Struct FurDocument 

pub struct FurDocument {
    pub schema: u32,
    pub conversation_id: String,
    pub title: String,
    pub created_at: String,
    pub updated_at: Option<String>,
    pub tags: Vec<String>,
    pub parents: Vec<String>,
    pub children: Vec<String>,
    pub messages: Vec<FurMessage>,
}

A whole conversation: front matter plus an ordered list of messages.

Messages are flat and their order is positional — the order they appear in the document is the sequence. Structure between conversations lives in parents / children; there is no structure within one.

Fields

schema: u32

conversation_id: String

title: String

created_at: String

updated_at: Option<String>

tags: Vec<String>

parents: Vec<String>

Conversations this one draws on, by conversation_id.

children: Vec<String>

Conversations that draw on this one, by conversation_id.

messages: Vec<FurMessage>

Implementations

impl FurDocument

pub fn new( conversation_id: impl Into<String>, title: impl Into<String>, created_at: impl Into<String>, ) -> Self

pub fn effective_schema(&self) -> u32

Version this document must be written as.

A schema-1 document with no lineage stays schema 1, so archives written before this change re-serialize byte-identically. The moment it gains an edge it becomes schema 2, because a schema-1 reader would reject the new keys as unknown rather than reporting a version it cannot handle.

pub fn validate(&self) -> Result<(), String>

Check the invariants parse enforces, for code that builds documents in memory rather than reading them.

serialize does not validate — it is infallible by design — so a command that mutates lineage should call this before writing.

Trait Implementations

impl Clone for FurDocument

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FurDocument

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

Formats the value using the given formatter.

impl Eq for FurDocument

impl PartialEq for FurDocument

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for FurDocument