Struct SyncService 

pub struct SyncService<'a> { /* private fields */ }

Synchronization service - bridges filesystem and database

Implementations

impl<'a> SyncService<'a>

pub fn new(db_service: &'a mut DatabaseService) -> Self

pub fn with_workspace_dir(self, workspace_dir: &'a Path) -> Self

Set the workspace directory for lineage extraction Note: We store the original path reference without canonicalizing here because canonicalization requires owned PathBuf. The caller should ensure paths are properly resolved when needed.

pub async fn import_from_file<P: AsRef<Path>>( &mut self, file_path: P, ) -> Result<Document>

Direction 1: File → DocumentObject → Database Load a document from filesystem and store in database

pub async fn export_to_file(&mut self, filepath: &str) -> Result<()>

Direction 2: Database → DocumentObject → File Export a document from database to filesystem

pub async fn sync_file<P: AsRef<Path>>( &mut self, file_path: P, ) -> Result<SyncResult>

Synchronize a single file between filesystem and database using directional methods

pub async fn sync_directory<P: AsRef<Path>>( &mut self, dir_path: P, ) -> Result<Vec<SyncResult>>

Sync all markdown files in a directory

pub fn verify_sync<P: AsRef<Path>>( &mut self, dir_path: P, ) -> Result<Vec<SyncIssue>>

Verify database and filesystem are in sync

pub fn recover_counters_from_filesystem<P: AsRef<Path>>( &self, dir_path: P, ) -> Result<HashMap<String, u32>>

Recover short code counters from filesystem by scanning all documents

This should only be called when:

• Database is missing or corrupt
• Explicit recovery is requested by user

Returns a map of document type to the highest counter found