desktop/src-tauri/crates/core/src/identity.rs

Comment 1, line 1

//! Identity and deduplication: event_id namespaces source instance/record key; content hashes

//! detect changes; revision/lifecycle comparisons select streamed, final or corrected records.

//!

//! Compare both source revisions when present; otherwise partial < final < corrected.

//! Unordered differing content retains the existing record with conflict diagnostics, never MAX.

/// event_id joins source instance and record key. The composite unique constraint

/// (source_instance_id, source_record_key) identifies the record; this string supports logs/references.

/// Observation time changes on rescanning without changing source content.

/// parse_basis records known_version/latest_fallback. Registry verification upgrades

/// do not change source content, so this field is also excluded from the content hash.

/// FNV-1a 64-bit content hash detects changes; it cannot identify an event independently.

/// Existing metadata used to compare incoming records.

/// Outcome of comparing a record with existing content.

/// No existing record: insert.

/// A higher revision/lifecycle replaces the old contribution with the new values.

/// Keep the higher existing revision/lifecycle or identical content without duplicate usage.

/// Unordered different content: retain the existing record, mark conflict and diagnose.

/// Compare source revisions before lifecycle; equal precedence with different content is conflict.

// Missing revision on either side uses lifecycle; equal lifecycle/content keeps, differing content conflicts.

// A higher source revision replaces even with a lower lifecycle.

// A lower source revision retains the existing record.

// Equal revision and content adds no usage.

// Equal revision with different content is conflict.