Function sync_integration_package

atomic-cli/src/commands/agent/enable.rs:446–477

Sync an agent's integration package into the CLI-managed cache (`~/.atomic/integrations/ /repo`) using Atomic's own remote protocol, and return the package directory (the cache's working copy). First run clones the package; later runs reuse the cache so enable works offline. `--force` discards the cache and re-clones.

(
    agent_name: &str,
    spec: &atomic_agent::integrations::IntegrationSpec,
    force: bool,
)

/// First run clones the package; later runs reuse the cache so enable works
/// offline. `--force` discards the cache and re-clones.
fn sync_integration_package(
    agent_name: &str,
    spec: &atomic_agent::integrations::IntegrationSpec,
    force: bool,
) -> CliResult<std::path::PathBuf> {
    let cache = atomic_agent::integrations::cache_repo_dir(agent_name)
        .map_err(|e| crate::error::CliError::Internal(anyhow::anyhow!(e.to_string())))?;

    if force && cache.exists() {
        std::fs::remove_dir_all(&cache).map_err(crate::error::CliError::Io)?;
    }

    if cache.exists() {
        println!(
            "Using cached package at {} (use --force to refresh).",
            cache.display()
        );
    } else {
        if let Some(ref tag) = spec.tag {
            print_warning(&format!(
                "Tag pinning ({tag}) is not yet implemented — installing the head of view '{}' instead.",
                spec.view
            ));
        }
        crate::commands::clone::Clone::new(spec.url.clone())
            .with_path(cache.display().to_string())
            .with_view(spec.view.clone())
            .run()?;
    }

    Ok(cache)
}

impl Enable {
    /// Install an externally-packaged integration for an agent.