git_manager.rs

// Copyright (c) 2026 Analog Devices, Inc.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

use crate::git_operations;
use crate::messages;
use anyhow::Result;
use std::path::{Path, PathBuf};

/// Returns true if the repo at `repo_path` has pending/changed files (uncommitted or staged).
///
/// # Errors
///
/// Returns an error if the git repository cannot be opened or the status cannot be determined.
pub fn repo_has_pending_changes(repo_path: &Path) -> Result<bool> {
    git_operations::is_repo_dirty(repo_path)
}

/// Updates/checks out the workspace repo at `repo_path` to the specified commit/tag.
///
/// # Errors
///
/// Returns an error if:
/// - The git repository cannot be opened
/// - The specified commit/tag cannot be found
/// - The checkout operation fails
pub fn update_workspace_repo(repo_path: &Path, commit: &str) -> Result<()> {
    let result = git_operations::checkout(repo_path, commit)?;

    if !result.is_success() {
        return Err(anyhow::anyhow!(
            "Failed to checkout {}: {}",
            commit,
            result.stderr
        ));
    }

    Ok(())
}

/// Resolve the correct mirror directory for a repository, handling URL collisions.
///
/// When two targets define a repo with the same name but different upstream URLs
/// (e.g., `u-boot` pointing to `u-boot/u-boot.git` vs `analogdevicesinc/u-boot-xlnx.git`),
/// this function ensures each URL gets its own mirror directory.
///
/// Resolution order:
/// 1. `mirror/<name>` - if it doesn't exist yet, or its origin URL matches
/// 2. `mirror/<name>-<hash>` - where hash is first 8 chars of SHA-256 of the URL
pub fn get_mirror_repo_path(mirror_path: &Path, name: &str, url: &str) -> PathBuf {
    let default_path = mirror_path.join(name);

    // If the default mirror directory doesn't exist, use it
    if !default_path.exists() {
        return default_path;
    }

    // Check if the existing mirror's origin URL matches the requested URL
    if let Ok(existing_url) = git_operations::get_remote_url(&default_path, "origin") {
        if git_operations::normalize_git_url(&existing_url)
            == git_operations::normalize_git_url(url)
        {
            return default_path;
        }

        // URL mismatch: need a separate mirror directory
        messages::info(&format!(
            "Mirror '{}' exists with a different URL ({}), using separate mirror for {}",
            name, &existing_url, url
        ));
    }

    // Use hash-based suffix for disambiguation
    let hash = git_operations::hash_url(url);
    let collision_path = mirror_path.join(format!("{}-{}", name, hash));

    // If collision path doesn't exist, use it
    if !collision_path.exists() {
        return collision_path;
    }

    // Collision path exists - check if URL matches
    if let Ok(existing_url) = git_operations::get_remote_url(&collision_path, "origin") {
        if git_operations::normalize_git_url(&existing_url)
            == git_operations::normalize_git_url(url)
        {
            return collision_path;
        }
    }

    // If we still have a collision (very unlikely), fall back to org-repo format
    let org_repo = git_operations::extract_org_and_repo(url);
    mirror_path.join(format!("{}-{}", org_repo, hash))
}