dependabot-nuget 0.277.0 → 0.278.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 492a5ffafd58adff4054fe829df3b316905a6c8bcfad5f291f9caa7653118a43
-  data.tar.gz: 75fbd529bc36ec77ae4b849c62a612272586803cc7792af3b5ce1bdd76bd592c
+  metadata.gz: d29298584fd13989b51d63574bc462c199b1db8144a2a28b6c893ae90bf41dec
+  data.tar.gz: f2fc3a71de6471f5cca05fe294ce492bb4dbb1837ce2feb03bf40cfcec9ff4cb
 SHA512:
-  metadata.gz: d4ebd69a7d512170e67677cc9a92bb1a791d92fc8591cf05d405da86449d523796cb0074afeb856ead16a074926ebca38d0173b7265cdc0941f271ecb1e8a575
-  data.tar.gz: 1fe2bb3b9f317dfd931ec36efb5b0faa6689860c40595cec827c5f3a3666789a793a2350ed1f0f72612539fa9d1641858b693d115579166fd9c5f36c698976ce
+  metadata.gz: 80ad942cbaf12ad2bec0eacf04124a26cb37b4a8f54cda4f3290f9a4b8c776f16a907cd963099634be43d925c64f0bef54ef5247632360954e9e28064bcda676
+  data.tar.gz: f413dfafd425032365e31d9c0969a94c6c8ac8195efe0de8b922ab464575fac246276012a6ceca8b1f9f55b10e3d8fb49d9cd5c4390f281674782a04a91b15ca

data/helpers/lib/NuGetUpdater/NuGetUpdater.Cli/Commands/RunCommand.cs

@@ -0,0 +1,42 @@
+using System.CommandLine;
+
+using NuGetUpdater.Core;
+using NuGetUpdater.Core.Run;
+
+namespace NuGetUpdater.Cli.Commands;
+
+internal static class RunCommand
+{
+    internal static readonly Option<FileInfo> JobPathOption = new("--job-path") { IsRequired = true };
+    internal static readonly Option<DirectoryInfo> RepoContentsPathOption = new("--repo-contents-path") { IsRequired = true };
+    internal static readonly Option<Uri> ApiUrlOption = new("--api-url") { IsRequired = true };
+    internal static readonly Option<string> JobIdOption = new("--job-id") { IsRequired = true };
+    internal static readonly Option<FileInfo> OutputPathOption = new("--output-path") { IsRequired = true };
+    internal static readonly Option<string> BaseCommitShaOption = new("--base-commit-sha") { IsRequired = true };
+    internal static readonly Option<bool> VerboseOption = new("--verbose", getDefaultValue: () => false);
+
+    internal static Command GetCommand(Action<int> setExitCode)
+    {
+        Command command = new("run", "Runs a full dependabot job.")
+        {
+            JobPathOption,
+            RepoContentsPathOption,
+            ApiUrlOption,
+            JobIdOption,
+            OutputPathOption,
+            BaseCommitShaOption,
+            VerboseOption
+        };
+
+        command.TreatUnmatchedTokensAsErrors = true;
+
+        command.SetHandler(async (jobPath, repoContentsPath, apiUrl, jobId, outputPath, baseCommitSha, verbose) =>
+        {
+            var apiHandler = new HttpApiHandler(apiUrl.ToString(), jobId);
+            var worker = new RunWorker(apiHandler, new Logger(verbose));
+            await worker.RunAsync(jobPath, repoContentsPath, baseCommitSha, outputPath);
+        }, JobPathOption, RepoContentsPathOption, ApiUrlOption, JobIdOption, OutputPathOption, BaseCommitShaOption, VerboseOption);
+
+        return command;
+    }
+}

data/helpers/lib/NuGetUpdater/NuGetUpdater.Cli/Program.cs

@@ -17,6 +17,7 @@ internal sealed class Program
             DiscoverCommand.GetCommand(setExitCode),
             AnalyzeCommand.GetCommand(setExitCode),
             UpdateCommand.GetCommand(setExitCode),
+            RunCommand.GetCommand(setExitCode),
         };
         command.TreatUnmatchedTokensAsErrors = true;
 

data/helpers/lib/NuGetUpdater/NuGetUpdater.Cli.Test/EntryPointTests.Run.cs

@@ -0,0 +1,132 @@
+using System.Text;
+using System.Text.Json;
+
+using NuGetUpdater.Core.Run;
+using NuGetUpdater.Core.Run.ApiModel;
+using NuGetUpdater.Core.Test;
+using NuGetUpdater.Core.Test.Update;
+
+using Xunit;
+
+namespace NuGetUpdater.Cli.Test;
+
+using TestFile = (string Path, string Content);
+
+public partial class EntryPointTests
+{
+    public class Run
+    {
+        [Fact]
+        public async Task Run_Simple()
+        {
+            // verify we can pass command line arguments and hit the appropriate URLs
+            await RunAsync(
+                packages:
+                [
+                    MockNuGetPackage.CreateSimplePackage("Some.Package", "1.0.0", "net8.0"),
+                    MockNuGetPackage.CreateSimplePackage("Some.Package", "1.0.1", "net8.0"),
+                ],
+                files:
+                [
+                    ("src/project.csproj", """
+                        <Project Sdk="Microsoft.NET.Sdk">
+                          <PropertyGroup>
+                            <TargetFramework>net8.0</TargetFramework>
+                          </PropertyGroup>
+                          <ItemGroup>
+                            <PackageReference Include="Some.Package" Version="1.0.0" />
+                          </ItemGroup>
+                        </Project>
+                        """)
+                ],
+                job: new Job()
+                {
+                    PackageManager = "nuget",
+                    AllowedUpdates = [
+                        new()
+                        {
+                            UpdateType = "all"
+                        }
+                    ],
+                    Source = new()
+                    {
+                        Provider = "github",
+                        Repo = "test",
+                        Directory = "src",
+                    }
+                },
+                expectedUrls:
+                [
+                    "/update_jobs/TEST-ID/update_dependency_list",
+                    "/update_jobs/TEST-ID/increment_metric",
+                    "/update_jobs/TEST-ID/create_pull_request",
+                    "/update_jobs/TEST-ID/mark_as_processed",
+                ]
+            );
+        }
+
+        private static async Task RunAsync(TestFile[] files, Job job, string[] expectedUrls, MockNuGetPackage[]? packages = null)
+        {
+            using var tempDirectory = new TemporaryDirectory();
+
+            // write test files
+            foreach (var testFile in files)
+            {
+                var fullPath = Path.Join(tempDirectory.DirectoryPath, testFile.Path);
+                var directory = Path.GetDirectoryName(fullPath)!;
+                Directory.CreateDirectory(directory);
+                await File.WriteAllTextAsync(fullPath, testFile.Content);
+            }
+
+            // write job file
+            var jobPath = Path.Combine(tempDirectory.DirectoryPath, "job.json");
+            await File.WriteAllTextAsync(jobPath, JsonSerializer.Serialize(new { Job = job }, RunWorker.SerializerOptions));
+
+            // save packages
+            await UpdateWorkerTestBase.MockNuGetPackagesInDirectory(packages, tempDirectory.DirectoryPath);
+
+            var actualUrls = new List<string>();
+            using var http = TestHttpServer.CreateTestStringServer(url =>
+            {
+                actualUrls.Add(new Uri(url).PathAndQuery);
+                return (200, "ok");
+            });
+            var args = new List<string>()
+            {
+                "run",
+                "--job-path",
+                jobPath,
+                "--repo-contents-path",
+                tempDirectory.DirectoryPath,
+                "--api-url",
+                http.BaseUrl,
+                "--job-id",
+                "TEST-ID",
+                "--output-path",
+                Path.Combine(tempDirectory.DirectoryPath, "output.json"),
+                "--base-commit-sha",
+                "BASE-COMMIT-SHA",
+                "--verbose"
+            };
+
+            var output = new StringBuilder();
+            // redirect stdout
+            var originalOut = Console.Out;
+            Console.SetOut(new StringWriter(output));
+            int result = -1;
+            try
+            {
+                result = await Program.Main(args.ToArray());
+            }
+            catch
+            {
+                // restore stdout
+                Console.SetOut(originalOut);
+                throw;
+            }
+
+            Assert.True(result == 0, output.ToString());
+            Assert.Equal(expectedUrls, actualUrls);
+        }
+    }
+}

data/helpers/lib/NuGetUpdater/NuGetUpdater.Core/Analyze/AnalyzeWorker.cs

@@ -33,6 +33,12 @@ public partial class AnalyzeWorker
     {
         var discovery = await DeserializeJsonFileAsync<WorkspaceDiscoveryResult>(discoveryPath, nameof(WorkspaceDiscoveryResult));
         var dependencyInfo = await DeserializeJsonFileAsync<DependencyInfo>(dependencyPath, nameof(DependencyInfo));
+        var analysisResult = await RunAsync(repoRoot, discovery, dependencyInfo);
+        await WriteResultsAsync(analysisDirectory, dependencyInfo.Name, analysisResult, _logger);
+    }
+
+    public async Task<AnalysisResult> RunAsync(string repoRoot, WorkspaceDiscoveryResult discovery, DependencyInfo dependencyInfo)
+    {
         var startingDirectory = PathHelper.JoinPath(repoRoot, discovery.Path);
 
         _logger.Log($"Starting analysis of {dependencyInfo.Name}...");
@@ -61,7 +67,7 @@ public partial class AnalyzeWorker
         bool isProjectUpdateNecessary = IsUpdateNecessary(dependencyInfo, projectsWithDependency);
         var isUpdateNecessary = isProjectUpdateNecessary || dotnetToolsHasDependency || globalJsonHasDependency;
         using var nugetContext = new NuGetContext(startingDirectory);
-        AnalysisResult result;
+        AnalysisResult analysisResult;
         try
         {
             if (isUpdateNecessary)
@@ -134,7 +140,7 @@ public partial class AnalyzeWorker
                 // should track the dependenciesToUpdate as they have already been analyzed.
             }
 
-            result = new AnalysisResult
+            analysisResult = new AnalysisResult
             {
                 UpdatedVersion = updatedVersion?.ToNormalizedString() ?? dependencyInfo.Version,
                 CanUpdate = updatedVersion is not null,
@@ -146,7 +152,7 @@ public partial class AnalyzeWorker
         when (ex.StatusCode == HttpStatusCode.Unauthorized || ex.StatusCode == HttpStatusCode.Forbidden)
         {
             // TODO: consolidate this error handling between AnalyzeWorker, DiscoveryWorker, and UpdateWorker
-            result = new AnalysisResult
+            analysisResult = new AnalysisResult
             {
                 ErrorType = ErrorType.AuthenticationFailure,
                 ErrorDetails = "(" + string.Join("|", nugetContext.PackageSources.Select(s => s.Source)) + ")",
@@ -156,9 +162,8 @@ public partial class AnalyzeWorker
             };
         }
 
-        await WriteResultsAsync(analysisDirectory, dependencyInfo.Name, result, _logger);
-
         _logger.Log($"Analysis complete.");
+        return analysisResult;
     }
 
     private static bool IsUpdateNecessary(DependencyInfo dependencyInfo, ImmutableArray<ProjectDiscoveryResult> projectsWithDependency)
@@ -393,7 +398,7 @@ public partial class AnalyzeWorker
 
         // Create distinct list of dependencies taking the highest version of each
         var dependencyResult = await DependencyFinder.GetDependenciesAsync(
-            workspacePath,
+            repoRoot,
             projectPath,
             projectFrameworks,
             packageIds,

data/helpers/lib/NuGetUpdater/NuGetUpdater.Core/Analyze/DependencyFinder.cs

@@ -8,7 +8,7 @@ namespace NuGetUpdater.Core.Analyze;
 internal static class DependencyFinder
 {
     public static async Task<ImmutableDictionary<NuGetFramework, ImmutableArray<Dependency>>> GetDependenciesAsync(
-        string workspacePath,
+        string repoRoot,
         string projectPath,
         IEnumerable<NuGetFramework> frameworks,
         ImmutableHashSet<string> packageIds,
@@ -26,7 +26,7 @@ internal static class DependencyFinder
         foreach (var framework in frameworks)
         {
             var dependencies = await MSBuildHelper.GetAllPackageDependenciesAsync(
-                workspacePath,
+                repoRoot,
                 projectPath,
                 framework.ToString(),
                 packages,

data/helpers/lib/NuGetUpdater/NuGetUpdater.Core/Discover/DiscoveryWorker.cs

@@ -30,7 +30,7 @@ public partial class DiscoveryWorker
         _logger = logger;
     }
 
-    public async Task RunAsync(string repoRootPath, string workspacePath, string outputPath)
+    public async Task<WorkspaceDiscoveryResult> RunAsync(string repoRootPath, string workspacePath)
     {
         MSBuildHelper.RegisterMSBuild(Environment.CurrentDirectory, repoRootPath);
 
@@ -102,11 +102,16 @@ public partial class DiscoveryWorker
             };
         }
 
-        await WriteResultsAsync(repoRootPath, outputPath, result);
-
         _logger.Log("Discovery complete.");
-
         _processedProjectPaths.Clear();
+
+        return result;
+    }
+
+    public async Task RunAsync(string repoRootPath, string workspacePath, string outputPath)
+    {
+        var result = await RunAsync(repoRootPath, workspacePath);
+        await WriteResultsAsync(repoRootPath, outputPath, result);
     }
 
     /// <summary>

data/helpers/lib/NuGetUpdater/NuGetUpdater.Core/NuGetUpdater.Core.csproj

@@ -21,7 +21,8 @@
   </ItemGroup>
 
   <ItemGroup>
-    <InternalsVisibleTo Include="NuGetUpdater.Core.Test"/>
+    <InternalsVisibleTo Include="NuGetUpdater.Cli.Test" />
+    <InternalsVisibleTo Include="NuGetUpdater.Core.Test" />
   </ItemGroup>
 
 </Project>

data/helpers/lib/NuGetUpdater/NuGetUpdater.Core/Run/ApiModel/AllowedUpdate.cs

@@ -0,0 +1,6 @@
+namespace NuGetUpdater.Core.Run.ApiModel;
+
+public sealed record AllowedUpdate
+{
+    public string UpdateType { get; init; } = "all";
+}

data/helpers/lib/NuGetUpdater/NuGetUpdater.Core/Run/ApiModel/CreatePullRequest.cs

@@ -0,0 +1,18 @@
+using System.Text.Json.Serialization;
+
+namespace NuGetUpdater.Core.Run.ApiModel;
+
+public sealed record CreatePullRequest
+{
+    public required ReportedDependency[] Dependencies { get; init; }
+    [JsonPropertyName("updated-dependency-files")]
+    public required DependencyFile[] UpdatedDependencyFiles { get; init; }
+    [JsonPropertyName("base-commit-sha")]
+    public required string BaseCommitSha { get; init; }
+    [JsonPropertyName("commit-message")]
+    public required string CommitMessage { get; init; }
+    [JsonPropertyName("pr-title")]
+    public required string PrTitle { get; init; }
+    [JsonPropertyName("pr-body")]
+    public required string PrBody { get; init; }
+}

data/helpers/lib/NuGetUpdater/NuGetUpdater.Core/Run/ApiModel/DependencyFile.cs

@@ -0,0 +1,18 @@
+using System.Text.Json.Serialization;
+
+namespace NuGetUpdater.Core.Run.ApiModel;
+
+public sealed record DependencyFile
+{
+    public required string Name { get; init; }
+    public required string Content { get; init; }
+    public required string Directory { get; init; }
+    public string Type { get; init; } = "file"; // TODO: enum
+    [JsonPropertyName("support_file")]
+    public bool SupportFile { get; init; } = false;
+    [JsonPropertyName("content_encoding")]
+    public string ContentEncoding { get; init; } = "utf-8";
+    public bool Deleted { get; init; } = false;
+    public string Operation { get; init; } = "update"; // TODO: enum
+    public string? Mode { get; init; } = null; // TODO: what is this?
+}

data/helpers/lib/NuGetUpdater/NuGetUpdater.Core/Run/ApiModel/IncrementMetric.cs

@@ -0,0 +1,7 @@
+namespace NuGetUpdater.Core.Run.ApiModel;
+
+public sealed record IncrementMetric
+{
+    public required string Metric { get; init; }
+    public Dictionary<string, string> Tags { get; init; } = new();
+}

data/helpers/lib/NuGetUpdater/NuGetUpdater.Core/Run/ApiModel/Job.cs

@@ -0,0 +1,49 @@
+namespace NuGetUpdater.Core.Run.ApiModel;
+
+public sealed record Job
+{
+    public required string PackageManager { get; init; }
+    public AllowedUpdate[]? AllowedUpdates { get; init; } = null;
+    public bool Debug { get; init; } = false;
+    public object[]? DependencyGroups { get; init; } = null;
+    public object[]? Dependencies { get; init; } = null;
+    public string? DependencyGroupToRefresh { get; init; } = null;
+    public object[]? ExistingPullRequests { get; init; } = null;
+    public object[]? ExistingGroupPullRequests { get; init; } = null;
+    public Dictionary<string, object>? Experiments { get; init; } = null;
+    public object[]? IgnoreConditions { get; init; } = null;
+    public bool LockfileOnly { get; init; } = false;
+    public string? RequirementsUpdateStrategy { get; init; } = null;
+    public object[]? SecurityAdvisories { get; init; } = null;
+    public bool SecurityUpdatesOnly { get; init; } = false;
+    public required JobSource Source { get; init; }
+    public bool UpdateSubdependencies { get; init; } = false;
+    public bool UpdatingAPullRequest { get; init; } = false;
+    public bool VendorDependencies { get; init; } = false;
+    public bool RejectExternalCode { get; init; } = false;
+    public bool RepoPrivate { get; init; } = false;
+    public object? CommitMessageOptions { get; init; } = null;
+    public object[]? CredentialsMetadata { get; init; } = null;
+    public int MaxUpdaterRunTime { get; init; } = 0;
+
+    public IEnumerable<string> GetAllDirectories()
+    {
+        var returnedADirectory = false;
+        if (Source.Directory is not null)
+        {
+            returnedADirectory = true;
+            yield return Source.Directory;
+        }
+
+        foreach (var directory in Source.Directories ?? [])
+        {
+            returnedADirectory = true;
+            yield return directory;
+        }
+
+        if (!returnedADirectory)
+        {
+            yield return "/";
+        }
+    }
+}

data/helpers/lib/NuGetUpdater/NuGetUpdater.Core/Run/ApiModel/JobFile.cs

@@ -0,0 +1,6 @@
+namespace NuGetUpdater.Core.Run.ApiModel;
+
+public sealed record JobFile
+{
+    public required Job Job { get; init; }
+}

data/helpers/lib/NuGetUpdater/NuGetUpdater.Core/Run/ApiModel/JobSource.cs

@@ -0,0 +1,11 @@
+namespace NuGetUpdater.Core.Run.ApiModel;
+
+public sealed class JobSource
+{
+    public required string Provider { get; init; }
+    public required string Repo { get; init; }
+    public string? Directory { get; init; } = null;
+    public string[]? Directories { get; init; } = null;
+    public string? Hostname { get; init; } = null;
+    public string? ApiEndpoint { get; init; } = null;
+}

data/helpers/lib/NuGetUpdater/NuGetUpdater.Core/Run/ApiModel/MarkAsProcessed.cs

@@ -0,0 +1,9 @@
+using System.Text.Json.Serialization;
+
+namespace NuGetUpdater.Core.Run.ApiModel;
+
+public sealed record MarkAsProcessed
+{
+    [JsonPropertyName("base-commit-sha")]
+    public required string BaseCommitSha { get; init; }
+}

data/helpers/lib/NuGetUpdater/NuGetUpdater.Core/Run/ApiModel/ReportedDependency.cs

@@ -0,0 +1,16 @@
+using System.Text.Json.Serialization;
+
+namespace NuGetUpdater.Core.Run.ApiModel;
+
+public sealed record ReportedDependency
+{
+    public required string Name { get; init; }
+    public required string? Version { get; init; }
+    public required ReportedRequirement[] Requirements { get; init; }
+    [JsonPropertyName("previous-version")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public string? PreviousVersion { get; init; } = null;
+    [JsonPropertyName("previous-requirements")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public ReportedRequirement[]? PreviousRequirements { get; init; } = null;
+}

data/helpers/lib/NuGetUpdater/NuGetUpdater.Core/Run/ApiModel/ReportedRequirement.cs

@@ -0,0 +1,9 @@
+namespace NuGetUpdater.Core.Run.ApiModel;
+
+public sealed record ReportedRequirement
+{
+    public required string Requirement { get; init; }
+    public required string File { get; init; }
+    public string[] Groups { get; init; } = Array.Empty<string>();
+    public RequirementSource? Source { get; init; } = null;
+}

data/helpers/lib/NuGetUpdater/NuGetUpdater.Core/Run/ApiModel/RequirementSource.cs

@@ -0,0 +1,7 @@
+namespace NuGetUpdater.Core.Run.ApiModel;
+
+public sealed record RequirementSource
+{
+    public required string? SourceUrl { get; init; }
+    public string Type { get; init; } = "nuget_repo";
+}

data/helpers/lib/NuGetUpdater/NuGetUpdater.Core/Run/ApiModel/UpdatedDependencyList.cs

@@ -0,0 +1,7 @@
+namespace NuGetUpdater.Core.Run.ApiModel;
+
+public sealed record UpdatedDependencyList
+{
+    public required ReportedDependency[] Dependencies { get; init; }
+    public required string[] DependencyFiles { get; init; }
+}

data/helpers/lib/NuGetUpdater/NuGetUpdater.Core/Run/HttpApiHandler.cs

@@ -0,0 +1,59 @@
+using System.Text;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+using NuGetUpdater.Core.Run.ApiModel;
+
+namespace NuGetUpdater.Core.Run;
+
+public class HttpApiHandler : IApiHandler
+{
+    private static readonly HttpClient HttpClient = new();
+
+    public static readonly JsonSerializerOptions SerializerOptions = new()
+    {
+        PropertyNamingPolicy = JsonNamingPolicy.SnakeCaseLower,
+        Converters = { new JsonStringEnumConverter() },
+    };
+
+    private readonly string _apiUrl;
+    private readonly string _jobId;
+
+    public HttpApiHandler(string apiUrl, string jobId)
+    {
+        _apiUrl = apiUrl.TrimEnd('/');
+        _jobId = jobId;
+    }
+
+    public async Task UpdateDependencyList(UpdatedDependencyList updatedDependencyList)
+    {
+        await PostAsJson("update_dependency_list", updatedDependencyList);
+    }
+
+    public async Task IncrementMetric(IncrementMetric incrementMetric)
+    {
+        await PostAsJson("increment_metric", incrementMetric);
+    }
+
+    public async Task CreatePullRequest(CreatePullRequest createPullRequest)
+    {
+        await PostAsJson("create_pull_request", createPullRequest);
+    }
+
+    public async Task MarkAsProcessed(MarkAsProcessed markAsProcessed)
+    {
+        await PostAsJson("mark_as_processed", markAsProcessed);
+    }
+
+    private async Task PostAsJson(string endpoint, object body)
+    {
+        var wrappedBody = new
+        {
+            Data = body,
+        };
+        var payload = JsonSerializer.Serialize(wrappedBody, SerializerOptions);
+        var content = new StringContent(payload, Encoding.UTF8, "application/json");
+        var response = await HttpClient.PostAsync($"{_apiUrl}/update_jobs/{_jobId}/{endpoint}", content);
+        var _ = response.EnsureSuccessStatusCode();
+    }
+}

data/helpers/lib/NuGetUpdater/NuGetUpdater.Core/Run/IApiHandler.cs

@@ -0,0 +1,11 @@
+using NuGetUpdater.Core.Run.ApiModel;
+
+namespace NuGetUpdater.Core.Run;
+
+public interface IApiHandler
+{
+    Task UpdateDependencyList(UpdatedDependencyList updatedDependencyList);
+    Task IncrementMetric(IncrementMetric incrementMetric);
+    Task CreatePullRequest(CreatePullRequest createPullRequest);
+    Task MarkAsProcessed(MarkAsProcessed markAsProcessed);
+}

data/helpers/lib/NuGetUpdater/NuGetUpdater.Core/Run/RunResult.cs

@@ -0,0 +1,13 @@
+using System.Text.Json.Serialization;
+
+using NuGetUpdater.Core.Run.ApiModel;
+
+namespace NuGetUpdater.Core.Run;
+
+public sealed record RunResult
+{
+    [JsonPropertyName("base64_dependency_files")]
+    public required DependencyFile[] Base64DependencyFiles { get; init; }
+    [JsonPropertyName("base_commit_sha")]
+    public required string BaseCommitSha { get; init; }
+}