namespace TeamUp.SharedKernel.Git;

/// <summary>A file read from a Git source.</summary>
public sealed record GitFile(string Path, string Content);

/// <summary>
/// Provider-agnostic read access to a Git source (Gitea in V1; GitHub/GitLab/Azure DevOps later).
/// Implemented by the Integrations module; consumed by Skills to sync SKILL.md files. Read-only in
/// V1 — write-back (PR comments, branches) is Phase 2.
/// </summary>
public interface IGitProvider
{
    /// <summary>A short identifier for the configured source (used as the skill's provenance).</summary>
    string Name { get; }

    /// <summary>Returns every <c>SKILL.md</c> in the source, with its repo-relative path and content.</summary>
    Task<IReadOnlyList<GitFile>> ListSkillFilesAsync(CancellationToken cancellationToken = default);
}