Struct SyncSignature 

pub struct SyncSignature {
    pub size: u64,
    pub mtime_sec: i64,
    pub mtime_nsec: i64,
    pub hash: Option<String>,
    pub merkle_root: Option<String>,
    pub chunk_size: Option<u64>,
    pub leaf_count: Option<u32>,
    pub avg_entropy: Option<f32>,
    pub entropy_class: Option<String>,
    pub file_simhash: Option<i64>,
    pub version: u8,
}

File sync signature stored in xattr/sidecar for change detection

Fields

size: u64

File size in bytes

mtime_sec: i64

Modification time (seconds since epoch)

mtime_nsec: i64

Modification time nanosecond component

hash: Option<String>

Hex-encoded BLAKE3 lite hash (head+tail sampling)

merkle_root: Option<String>

Hex-encoded BLAKE3 full Merkle root

chunk_size: Option<u64>

Chunk size used for Merkle tree construction

leaf_count: Option<u32>

Number of Merkle leaves (v4+)

avg_entropy: Option<f32>

Average Shannon entropy across all chunks (v5+, 0.0-8.0 bits/byte)

entropy_class: Option<String>

Entropy classification label (v5+, e.g. “low”, “medium”, “high”, “encrypted”)

file_simhash: Option<i64>

SimHash-64 whole-file fingerprint stored as i64 for pgvector BIGINT compat (v5+)

version: u8

Signature schema version

Implementations

impl SyncSignature

pub const CURRENT_VERSION: u8 = 5

pub fn compute(path: &Path) -> Result<Self>

Compute a sync signature from a file’s current metadata and content hashes

pub fn compute_from_buffer(data: &[u8], mtime_sec: i64, mtime_nsec: i64) -> Self

Compute a signature from an in-memory buffer. Used by the NFS compound bypass path where file data is already in memory.

pub fn serialize(&self) -> Vec<u8>

Serialize to bincode bytes for xattr storage

pub fn deserialize(data: &[u8]) -> Option<Self>

Deserialize from bincode bytes (returns None on invalid data)

pub fn deserialize_versioned(data: &[u8]) -> Option<Self>

Version-aware deserialization. Handles v5 (current), v4 (missing entropy/simhash fields), v3 (missing leaf_count), and unknown/corrupt blobs (returns None with warn! log).

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

Check if two signatures represent the same file state (merkle_root takes priority over mtime)

pub fn hash_cid(&self) -> Option<String>

Return the lite hash as a CID string (computed on demand from hex).

pub fn merkle_root_cid(&self) -> Option<String>

Return the Merkle root as a CID string (computed on demand from hex).

Trait Implementations

impl Clone for SyncSignature

fn clone(&self) -> SyncSignature

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SyncSignature

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SyncSignature

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SyncSignature

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

where __S: Serializer,

Serialize this value into the given Serde serializer.