Struct Document 

pub struct Document {
    pub id: Uuid,
    pub path_id: Uuid,
    pub path: PathBuf,
    pub hash: [u8; 32],
    pub hierarchical_hash: [u8; 32],
    pub mtime: i64,
    pub size: u64,
    pub mime_type: String,
    pub arweave_tx: Option<String>,
}

A document node in the cognitive graph

Represents a single ingested file with its content hash for change detection and deduplication.

Fields

id: Uuid

Unique identifier for this document (BLAKE3-16 of content_hash)

path_id: Uuid

Path-based identifier for change detection (BLAKE3-16 of canonicalized path)

path: PathBuf

Original file path (relative to watched root)

hash: [u8; 32]

BLAKE3 hash of file contents (canonicalized)

hierarchical_hash: [u8; 32]

Merkle root of chunks (hierarchical hash)

mtime: i64

Last modification time (Unix timestamp)

size: u64

File size in bytes

mime_type: String

MIME type (e.g., “application/pdf”, “text/markdown”)

arweave_tx: Option<String>

Arweave transaction ID if this document was synced from Arweave

Implementations

impl Document

pub fn new(path: PathBuf, content: &[u8], mtime: i64) -> Self

pub fn set_hierarchical_hash(&mut self, hash: [u8; 32])

Update the hierarchical hash (Merkle root of chunks)

pub fn compute_hierarchical_hash(chunk_hashes: &[[u8; 32]]) -> [u8; 32]

Compute Merkle hash from chunks for provable correctness. Sorts chunk hashes before hashing so order doesn’t affect the result.

pub fn content_changed(&self, new_content: &[u8]) -> bool

Check if the document content has changed

pub fn hash_hex(&self) -> String

Get the document hash as a hex string

Trait Implementations

impl Clone for Document

fn clone(&self) -> Document

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Document

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Document

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Document

fn eq(&self, other: &Document) -> 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 Document

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 Document

impl StructuralPartialEq for Document