Skip to main content

Module sync

Module sync 

Source
Expand description

oxibrain sync <DIR> [--space s] — vault sync with occurrence identity.

Scans DIR recursively for .md/.html files (oxibrain-connectors), classifies each against the ledger’s event-path state for the vault source (oxibrain_core::classify_event), and ingests new/modified files via the event path with derived occurrence IDs (§4.2).

Occurrence chain: occurrence_id = H(source_id, locator, predecessor, content_hash). A → B → A creates three events because the predecessor differs. Unchanged files are skipped — re-syncing an unchanged tree is a no-op. Legacy episodes (pre-event-identity) participate in Unchanged classification but are never re-ingested.

Structs§

SyncReport
Per-run outcome, returned for programmatic use and printed by the CLI.

Functions§

run
sync
Scan, classify, ingest via event path. The locator convention is the file’s path relative to the sync root (forward slashes).