Method sync

src/linker.rs:362–444

Perform the sync operation

(&self, options: &SyncOptions)

    /// Perform the sync operation
    pub fn sync(&self, options: &SyncOptions) -> Result<SyncResult> {
        // Clear caches at the start of every sync run to prevent stale state.
        self.compression_cache.borrow_mut().clear();
        self.ensured_dirs.borrow_mut().clear();
        self.ensured_compressed.borrow_mut().clear();
        self.path_cache.borrow_mut().clear();
        self.invalidate_discovery_caches();

        let mut result = SyncResult::default();

        if options.dry_run {
            println!("{}", "Running in dry-run mode\n".cyan());
        }

        for (agent_name, agent_config) in &self.config.agents {
            // Skip disabled agents
            if !agent_config.enabled {
                if options.verbose {
                    println!("  {} Skipping disabled agent: {}", "○".yellow(), agent_name);
                }
                continue;
            }

            // Filter by agent name if specified
            // Priority: CLI --agents flag > default_agents config > all enabled agents
            if let Some(ref filter) = options.agents {
                if !filter
                    .iter()
                    .any(|f| crate::agent_ids::sync_filter_matches(agent_name, f))
                {
                    if options.verbose {
                        println!("  {} Skipping filtered agent: {}", "○".yellow(), agent_name);
                    }
                    continue;
                }
            } else if !self.config.default_agents.is_empty()
                && !self
                    .config
                    .default_agents
                    .iter()
                    .any(|f| crate::agent_ids::sync_filter_matches(agent_name, f))
            {
                if options.verbose {
                    println!(
                        "  {} Skipping agent (not in default_agents): {}",
                        "○".yellow(),
                        agent_name
                    );
                }
                continue;
            }
            // If neither --agents nor default_agents, process all enabled agents

            // Print agent header
            let desc = if agent_config.description.is_empty() {
                String::new()
            } else {
                format!(" - {}", agent_config.description)