Struct NoteListing 

#[non_exhaustive]
pub struct NoteListing {
    pub path: String,
    pub size_bytes: u64,
    pub modified_ms: Option<u64>,
}

A note’s identity and change-detection metadata, without its content.

This is what makes reconciliation affordable. A consumer maintaining derived state stores (size_bytes, modified_ms) alongside each entry and re-reads only the notes whose values moved — one stat per note instead of one full read per note, which is the difference between a few milliseconds and a full corpus scan on a large vault.

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.

path: String

Vault-relative path using / separators.

size_bytes: u64

Size in bytes when the vault was scanned.

modified_ms: Option<u64>

Last-modified time as Unix epoch milliseconds, when the platform reports one.

Treat this as a change hint, not a clock: filesystems vary in resolution and a restored file can carry an older timestamp than the content it replaced. Pair it with size_bytes, and fall back to a version comparison when correctness matters more than the extra read.

Implementations

impl NoteListing

pub fn new( path: impl Into<String>, size_bytes: u64, modified_ms: Option<u64>, ) -> Self

Construct a listing entry.

pub fn looks_unchanged_from(&self, previous: &Self) -> bool

Whether this entry looks unchanged from a previously recorded one.

A cheap pre-filter, not proof: equal size and timestamp are strong evidence nothing happened, but a same-size edit within one timestamp tick is invisible here. Consumers that cannot tolerate a missed change should combine this with the event feed, which reports the write regardless.

Trait Implementations

impl Clone for NoteListing

fn clone(&self) -> NoteListing

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NoteListing

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for NoteListing

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for NoteListing

impl PartialEq for NoteListing

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for NoteListing

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for NoteListing