gitaly 14.10.0.pre.rc1 → 15.1.0.pre.rc1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc86bd3f4b9d80f96d65e4e4696a9ac510f78aabc53f9ed28e97e5f902f1c6dd
-  data.tar.gz: 588fdc7901e9161509f05b5231b8417fdfcb84016dc6c67b132e0e131ba02bfd
+  metadata.gz: e33ca04571fc6455aad19ff895c6b2bc4324deae179ca578d091cd6ab4fcbac9
+  data.tar.gz: 6d7f95a725b2ce52e4d4e19efd5d1039c531e440600cf354b5a14a88a0da5bef
 SHA512:
-  metadata.gz: 5ced671c1ebf12507a6d6c09246e87a4e4362e5b1548495d2118030af6c64d37f089e542574d85f8edce04dd671a05797698ef7c3287cfd91cef264cc26643b4
-  data.tar.gz: 131a3bba6884a483842fb134d09d389d127ca075de0f3a7ff8e085e8afc8fb2301f11fc8db927bfbaf6abbfe4578e401ff637195f17936120276eccdda189601
+  metadata.gz: fb860a1a5f3dd8427608f7cbb6d027e7fb4c03db32498cd4c500a5230577990719a1479812353534a8d2768a93d9e65cdf1d9b7343e08dc9a9d3e0fe07c4592a
+  data.tar.gz: 71791da8a6b302e275755811d28ef7846fb57d2cd0de895fc98dc3c0c2099518e8aba91625f6edfe9f926bac2a26b69253608b1400318da6e474706b2d2c8523

data/ruby/proto/gitaly/blob_services_pb.rb

@@ -6,6 +6,8 @@ require 'blob_pb'
 
 module Gitaly
   module BlobService
+    # BlobService is a service which provides RPCs to retrieve Git blobs from a
+    # specific repository.
     class Service
 
       include ::GRPC::GenericService
@@ -18,6 +20,7 @@ module Gitaly
       # ID. We use a stream to return a chunked arbitrarily large binary
       # response
       rpc :GetBlob, ::Gitaly::GetBlobRequest, stream(::Gitaly::GetBlobResponse)
+      # This comment is left unintentionally blank.
       rpc :GetBlobs, ::Gitaly::GetBlobsRequest, stream(::Gitaly::GetBlobsResponse)
       # ListBlobs will list all blobs reachable from a given set of revisions by
       # doing a graph walk. It is not valid to pass revisions which do not resolve

data/ruby/proto/gitaly/cleanup_services_pb.rb

@@ -6,6 +6,7 @@ require 'cleanup_pb'
 
 module Gitaly
   module CleanupService
+    # CleanupService provides RPCs to clean up a repository's contents.
     class Service
 
       include ::GRPC::GenericService
@@ -14,6 +15,7 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.CleanupService'
 
+      # This comment is left unintentionally blank.
       rpc :ApplyBfgObjectMapStream, stream(::Gitaly::ApplyBfgObjectMapStreamRequest), stream(::Gitaly::ApplyBfgObjectMapStreamResponse)
     end
 

data/ruby/proto/gitaly/commit_pb.rb

@@ -1,9 +1,9 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: commit.proto
 
+require 'google/protobuf/timestamp_pb'
 require 'lint_pb'
 require 'shared_pb'
-require 'google/protobuf/timestamp_pb'
 require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
@@ -20,6 +20,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :after, :message, 8, "google.protobuf.Timestamp"
       optional :before, :message, 9, "google.protobuf.Timestamp"
       optional :author, :bytes, 10
+      optional :ignore_case, :bool, 12
+      repeated :commit_message_patterns, :bytes, 13
     end
     add_enum "gitaly.ListCommitsRequest.Order" do
       value :NONE, 0

data/ruby/proto/gitaly/commit_services_pb.rb

@@ -6,6 +6,8 @@ require 'commit_pb'
 
 module Gitaly
   module CommitService
+    # CommitService is a service which provides RPCs that interact with Git
+    # commits.
     class Service
 
       include ::GRPC::GenericService
@@ -21,26 +23,45 @@ module Gitaly
       # ListAllCommits lists all commits present in the repository, including
       # those not reachable by any reference.
       rpc :ListAllCommits, ::Gitaly::ListAllCommitsRequest, stream(::Gitaly::ListAllCommitsResponse)
+      # This comment is left unintentionally blank.
       rpc :CommitIsAncestor, ::Gitaly::CommitIsAncestorRequest, ::Gitaly::CommitIsAncestorResponse
+      # This comment is left unintentionally blank.
       rpc :TreeEntry, ::Gitaly::TreeEntryRequest, stream(::Gitaly::TreeEntryResponse)
+      # This comment is left unintentionally blank.
       rpc :CountCommits, ::Gitaly::CountCommitsRequest, ::Gitaly::CountCommitsResponse
+      # This comment is left unintentionally blank.
       rpc :CountDivergingCommits, ::Gitaly::CountDivergingCommitsRequest, ::Gitaly::CountDivergingCommitsResponse
+      # This comment is left unintentionally blank.
       rpc :GetTreeEntries, ::Gitaly::GetTreeEntriesRequest, stream(::Gitaly::GetTreeEntriesResponse)
+      # This comment is left unintentionally blank.
       rpc :ListFiles, ::Gitaly::ListFilesRequest, stream(::Gitaly::ListFilesResponse)
+      # This comment is left unintentionally blank.
       rpc :FindCommit, ::Gitaly::FindCommitRequest, ::Gitaly::FindCommitResponse
+      # This comment is left unintentionally blank.
       rpc :CommitStats, ::Gitaly::CommitStatsRequest, ::Gitaly::CommitStatsResponse
       # Use a stream to paginate the result set
       rpc :FindAllCommits, ::Gitaly::FindAllCommitsRequest, stream(::Gitaly::FindAllCommitsResponse)
+      # This comment is left unintentionally blank.
       rpc :FindCommits, ::Gitaly::FindCommitsRequest, stream(::Gitaly::FindCommitsResponse)
+      # This comment is left unintentionally blank.
       rpc :CommitLanguages, ::Gitaly::CommitLanguagesRequest, ::Gitaly::CommitLanguagesResponse
+      # This comment is left unintentionally blank.
       rpc :RawBlame, ::Gitaly::RawBlameRequest, stream(::Gitaly::RawBlameResponse)
+      # This comment is left unintentionally blank.
       rpc :LastCommitForPath, ::Gitaly::LastCommitForPathRequest, ::Gitaly::LastCommitForPathResponse
+      # This comment is left unintentionally blank.
       rpc :ListLastCommitsForTree, ::Gitaly::ListLastCommitsForTreeRequest, stream(::Gitaly::ListLastCommitsForTreeResponse)
+      # This comment is left unintentionally blank.
       rpc :CommitsByMessage, ::Gitaly::CommitsByMessageRequest, stream(::Gitaly::CommitsByMessageResponse)
+      # This comment is left unintentionally blank.
       rpc :ListCommitsByOid, ::Gitaly::ListCommitsByOidRequest, stream(::Gitaly::ListCommitsByOidResponse)
+      # This comment is left unintentionally blank.
       rpc :ListCommitsByRefName, ::Gitaly::ListCommitsByRefNameRequest, stream(::Gitaly::ListCommitsByRefNameResponse)
+      # This comment is left unintentionally blank.
       rpc :FilterShasWithSignatures, stream(::Gitaly::FilterShasWithSignaturesRequest), stream(::Gitaly::FilterShasWithSignaturesResponse)
+      # This comment is left unintentionally blank.
       rpc :GetCommitSignatures, ::Gitaly::GetCommitSignaturesRequest, stream(::Gitaly::GetCommitSignaturesResponse)
+      # This comment is left unintentionally blank.
       rpc :GetCommitMessages, ::Gitaly::GetCommitMessagesRequest, stream(::Gitaly::GetCommitMessagesResponse)
       # CheckObjectsExist will check for the existence of revisions against a
       # repository. It returns two sets of data. An array containing the revisions

data/ruby/proto/gitaly/conflicts_pb.rb

@@ -1,9 +1,9 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: conflicts.proto
 
+require 'google/protobuf/timestamp_pb'
 require 'lint_pb'
 require 'shared_pb'
-require 'google/protobuf/timestamp_pb'
 require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do

data/ruby/proto/gitaly/conflicts_services_pb.rb

@@ -6,6 +6,8 @@ require 'conflicts_pb'
 
 module Gitaly
   module ConflictsService
+    # ConflictsService is a service which provides RPCs to interact with conflicts
+    # resulting from a merge.
     class Service
 
       include ::GRPC::GenericService
@@ -14,6 +16,8 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.ConflictsService'
 
+      # ListConflictFiles returns all conflicting files which result from a merge
+      # of two specified commit objects.
       rpc :ListConflictFiles, ::Gitaly::ListConflictFilesRequest, stream(::Gitaly::ListConflictFilesResponse)
       # ResolveConflicts tries to resolve a conflicting merge with a set of
       # user-provided merge resolutions. If resolving the conflict succeeds, the

data/ruby/proto/gitaly/diff_services_pb.rb

@@ -6,6 +6,8 @@ require 'diff_pb'
 
 module Gitaly
   module DiffService
+    # DiffService is a service which provides RPCs to inspect differences
+    # introduced between a set of commits.
     class Service
 
       include ::GRPC::GenericService
@@ -18,8 +20,11 @@ module Gitaly
       rpc :CommitDiff, ::Gitaly::CommitDiffRequest, stream(::Gitaly::CommitDiffResponse)
       # Return a stream so we can divide the response in chunks of deltas
       rpc :CommitDelta, ::Gitaly::CommitDeltaRequest, stream(::Gitaly::CommitDeltaResponse)
+      # This comment is left unintentionally blank.
       rpc :RawDiff, ::Gitaly::RawDiffRequest, stream(::Gitaly::RawDiffResponse)
+      # This comment is left unintentionally blank.
       rpc :RawPatch, ::Gitaly::RawPatchRequest, stream(::Gitaly::RawPatchResponse)
+      # This comment is left unintentionally blank.
       rpc :DiffStats, ::Gitaly::DiffStatsRequest, stream(::Gitaly::DiffStatsResponse)
       # Return a list of files changed along with the status of each file
       rpc :FindChangedPaths, ::Gitaly::FindChangedPathsRequest, stream(::Gitaly::FindChangedPathsResponse)

data/ruby/proto/gitaly/errors_pb.rb

@@ -1,6 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: errors.proto
 
+require 'google/protobuf/duration_pb'
 require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
@@ -11,9 +12,20 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :user_id, :string, 3
       optional :changes, :bytes, 4
     end
+    add_message "gitaly.InvalidRefFormatError" do
+      repeated :refs, :bytes, 2
+    end
+    add_message "gitaly.NotAncestorError" do
+      optional :parent_revision, :bytes, 1
+      optional :child_revision, :bytes, 2
+    end
+    add_message "gitaly.ChangesAlreadyAppliedError" do
+    end
     add_message "gitaly.MergeConflictError" do
       repeated :conflicting_files, :bytes, 1
     end
+    add_message "gitaly.ReferencesLockedError" do
+    end
     add_message "gitaly.ReferenceUpdateError" do
       optional :reference_name, :bytes, 1
       optional :old_oid, :string, 2
@@ -22,12 +34,34 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "gitaly.ResolveRevisionError" do
       optional :revision, :bytes, 1
     end
+    add_message "gitaly.LimitError" do
+      optional :error_message, :string, 1
+      optional :retry_after, :message, 2, "google.protobuf.Duration"
+    end
+    add_message "gitaly.CustomHookError" do
+      optional :stdout, :bytes, 1
+      optional :stderr, :bytes, 2
+      optional :hook_type, :enum, 3, "gitaly.CustomHookError.HookType"
+    end
+    add_enum "gitaly.CustomHookError.HookType" do
+      value :HOOK_TYPE_UNSPECIFIED, 0
+      value :HOOK_TYPE_PRERECEIVE, 1
+      value :HOOK_TYPE_UPDATE, 2
+      value :HOOK_TYPE_POSTRECEIVE, 3
+    end
   end
 end
 
 module Gitaly
   AccessCheckError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.AccessCheckError").msgclass
+  InvalidRefFormatError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.InvalidRefFormatError").msgclass
+  NotAncestorError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.NotAncestorError").msgclass
+  ChangesAlreadyAppliedError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.ChangesAlreadyAppliedError").msgclass
   MergeConflictError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.MergeConflictError").msgclass
+  ReferencesLockedError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.ReferencesLockedError").msgclass
   ReferenceUpdateError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.ReferenceUpdateError").msgclass
   ResolveRevisionError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.ResolveRevisionError").msgclass
+  LimitError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.LimitError").msgclass
+  CustomHookError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.CustomHookError").msgclass
+  CustomHookError::HookType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.CustomHookError.HookType").enummodule
 end

data/ruby/proto/gitaly/hook_pb.rb

@@ -57,15 +57,6 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :stderr, :bytes, 2
       optional :exit_status, :message, 3, "gitaly.ExitStatus"
     end
-    add_message "gitaly.PackObjectsHookRequest" do
-      optional :repository, :message, 1, "gitaly.Repository"
-      repeated :args, :string, 2
-      optional :stdin, :bytes, 3
-    end
-    add_message "gitaly.PackObjectsHookResponse" do
-      optional :stdout, :bytes, 1
-      optional :stderr, :bytes, 2
-    end
     add_message "gitaly.PackObjectsHookWithSidechannelRequest" do
       optional :repository, :message, 1, "gitaly.Repository"
       repeated :args, :string, 2
@@ -85,8 +76,6 @@ module Gitaly
   ReferenceTransactionHookRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.ReferenceTransactionHookRequest").msgclass
   ReferenceTransactionHookRequest::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.ReferenceTransactionHookRequest.State").enummodule
   ReferenceTransactionHookResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.ReferenceTransactionHookResponse").msgclass
-  PackObjectsHookRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.PackObjectsHookRequest").msgclass
-  PackObjectsHookResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.PackObjectsHookResponse").msgclass
   PackObjectsHookWithSidechannelRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.PackObjectsHookWithSidechannelRequest").msgclass
   PackObjectsHookWithSidechannelResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.PackObjectsHookWithSidechannelResponse").msgclass
 end

data/ruby/proto/gitaly/hook_services_pb.rb

@@ -6,6 +6,9 @@ require 'hook_pb'
 
 module Gitaly
   module HookService
+    # HookService is a service which provides the implementation of a subset of
+    # Git hooks. These are typically invoked via the `gitaly-hooks` binary to
+    # ensure that the actual hook logic is executed in the context of the server.
     class Service
 
       include ::GRPC::GenericService
@@ -14,12 +17,14 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.HookService'
 
+      # This comment is left unintentionally blank.
       rpc :PreReceiveHook, stream(::Gitaly::PreReceiveHookRequest), stream(::Gitaly::PreReceiveHookResponse)
+      # This comment is left unintentionally blank.
       rpc :PostReceiveHook, stream(::Gitaly::PostReceiveHookRequest), stream(::Gitaly::PostReceiveHookResponse)
+      # This comment is left unintentionally blank.
       rpc :UpdateHook, ::Gitaly::UpdateHookRequest, stream(::Gitaly::UpdateHookResponse)
+      # This comment is left unintentionally blank.
       rpc :ReferenceTransactionHook, stream(::Gitaly::ReferenceTransactionHookRequest), stream(::Gitaly::ReferenceTransactionHookResponse)
-      # PackObjectsHook has been replaced by PackObjectsHookWithSidechannel. Remove in 15.0.
-      rpc :PackObjectsHook, stream(::Gitaly::PackObjectsHookRequest), stream(::Gitaly::PackObjectsHookResponse)
       # PackObjectsHookWithSidechannel is an optimized version of PackObjectsHook that uses
       # a unix socket side channel.
       rpc :PackObjectsHookWithSidechannel, ::Gitaly::PackObjectsHookWithSidechannelRequest, ::Gitaly::PackObjectsHookWithSidechannelResponse

data/ruby/proto/gitaly/internal_pb.rb

@@ -1,8 +1,8 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: internal.proto
 
-require 'lint_pb'
 require 'google/protobuf/timestamp_pb'
+require 'lint_pb'
 require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do

data/ruby/proto/gitaly/namespace_services_pb.rb

@@ -6,6 +6,9 @@ require 'namespace_pb'
 
 module Gitaly
   module NamespaceService
+    # NamespaceService is a service which provides RPCs to manage namespaces of a
+    # storage. Namespaces had been used before Gitaly migrated to hashed storages
+    # and shouldn't be used nowadays anymore.
     class Service
 
       include ::GRPC::GenericService
@@ -14,9 +17,13 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.NamespaceService'
 
+      # This comment is left unintentionally blank.
       rpc :AddNamespace, ::Gitaly::AddNamespaceRequest, ::Gitaly::AddNamespaceResponse
+      # This comment is left unintentionally blank.
       rpc :RemoveNamespace, ::Gitaly::RemoveNamespaceRequest, ::Gitaly::RemoveNamespaceResponse
+      # This comment is left unintentionally blank.
       rpc :RenameNamespace, ::Gitaly::RenameNamespaceRequest, ::Gitaly::RenameNamespaceResponse
+      # This comment is left unintentionally blank.
       rpc :NamespaceExists, ::Gitaly::NamespaceExistsRequest, ::Gitaly::NamespaceExistsResponse
     end
 

data/ruby/proto/gitaly/objectpool_services_pb.rb

@@ -6,6 +6,10 @@ require 'objectpool_pb'
 
 module Gitaly
   module ObjectPoolService
+    # ObjectPoolService is a service containing RPCs to manipulate object pools.
+    # An object pool is a separate repository that can be linked to from multiple
+    # satellite repositories in order to deduplicate common objects between them.
+    # This is mostly used in the contexet of repository forks.
     class Service
 
       include ::GRPC::GenericService
@@ -14,13 +18,19 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.ObjectPoolService'
 
+      # This comment is left unintentionally blank.
       rpc :CreateObjectPool, ::Gitaly::CreateObjectPoolRequest, ::Gitaly::CreateObjectPoolResponse
+      # This comment is left unintentionally blank.
       rpc :DeleteObjectPool, ::Gitaly::DeleteObjectPoolRequest, ::Gitaly::DeleteObjectPoolResponse
       # Repositories are assumed to be stored on the same disk
       rpc :LinkRepositoryToObjectPool, ::Gitaly::LinkRepositoryToObjectPoolRequest, ::Gitaly::LinkRepositoryToObjectPoolResponse
+      # This comment is left unintentionally blank.
       rpc :ReduplicateRepository, ::Gitaly::ReduplicateRepositoryRequest, ::Gitaly::ReduplicateRepositoryResponse
+      # This comment is left unintentionally blank.
       rpc :DisconnectGitAlternates, ::Gitaly::DisconnectGitAlternatesRequest, ::Gitaly::DisconnectGitAlternatesResponse
+      # This comment is left unintentionally blank.
       rpc :FetchIntoObjectPool, ::Gitaly::FetchIntoObjectPoolRequest, ::Gitaly::FetchIntoObjectPoolResponse
+      # This comment is left unintentionally blank.
       rpc :GetObjectPool, ::Gitaly::GetObjectPoolRequest, ::Gitaly::GetObjectPoolResponse
     end
 

data/ruby/proto/gitaly/operations_pb.rb

@@ -1,10 +1,10 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: operations.proto
 
-require 'lint_pb'
-require 'shared_pb'
 require 'errors_pb'
 require 'google/protobuf/timestamp_pb'
+require 'lint_pb'
+require 'shared_pb'
 require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
@@ -37,6 +37,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "gitaly.UserDeleteBranchResponse" do
       optional :pre_receive_error, :string, 1
     end
+    add_message "gitaly.UserDeleteBranchError" do
+      oneof :error do
+        optional :access_check, :message, 1, "gitaly.AccessCheckError"
+        optional :reference_update, :message, 2, "gitaly.ReferenceUpdateError"
+        optional :custom_hook, :message, 3, "gitaly.CustomHookError"
+      end
+    end
     add_message "gitaly.UserDeleteTagRequest" do
       optional :repository, :message, 1, "gitaly.Repository"
       optional :tag_name, :bytes, 2
@@ -76,6 +83,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       oneof :error do
         optional :access_check, :message, 1, "gitaly.AccessCheckError"
         optional :reference_update, :message, 2, "gitaly.ReferenceUpdateError"
+        optional :custom_hook, :message, 3, "gitaly.CustomHookError"
       end
     end
     add_message "gitaly.UserMergeToRefRequest" do
@@ -131,6 +139,14 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :EMPTY, 1
       value :CONFLICT, 2
     end
+    add_message "gitaly.UserCherryPickError" do
+      oneof :error do
+        optional :cherry_pick_conflict, :message, 1, "gitaly.MergeConflictError"
+        optional :target_branch_diverged, :message, 2, "gitaly.NotAncestorError"
+        optional :changes_already_applied, :message, 3, "gitaly.ChangesAlreadyAppliedError"
+        optional :access_check, :message, 4, "gitaly.AccessCheckError"
+      end
+    end
     add_message "gitaly.UserRevertRequest" do
       optional :repository, :message, 1, "gitaly.Repository"
       optional :user, :message, 2, "gitaly.User"
@@ -289,6 +305,7 @@ module Gitaly
   UserUpdateBranchResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.UserUpdateBranchResponse").msgclass
   UserDeleteBranchRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.UserDeleteBranchRequest").msgclass
   UserDeleteBranchResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.UserDeleteBranchResponse").msgclass
+  UserDeleteBranchError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.UserDeleteBranchError").msgclass
   UserDeleteTagRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.UserDeleteTagRequest").msgclass
   UserDeleteTagResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.UserDeleteTagResponse").msgclass
   UserCreateTagRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.UserCreateTagRequest").msgclass
@@ -304,6 +321,7 @@ module Gitaly
   UserCherryPickRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.UserCherryPickRequest").msgclass
   UserCherryPickResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.UserCherryPickResponse").msgclass
   UserCherryPickResponse::CreateTreeError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.UserCherryPickResponse.CreateTreeError").enummodule
+  UserCherryPickError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.UserCherryPickError").msgclass
   UserRevertRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.UserRevertRequest").msgclass
   UserRevertResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.UserRevertResponse").msgclass
   UserRevertResponse::CreateTreeError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.UserRevertResponse.CreateTreeError").enummodule

data/ruby/proto/gitaly/operations_services_pb.rb

@@ -18,11 +18,23 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.OperationService'
 
+      # This comment is left unintentionally blank.
       rpc :UserCreateBranch, ::Gitaly::UserCreateBranchRequest, ::Gitaly::UserCreateBranchResponse
+      # This comment is left unintentionally blank.
       rpc :UserUpdateBranch, ::Gitaly::UserUpdateBranchRequest, ::Gitaly::UserUpdateBranchResponse
+      # UserDeleteBranch force-deletes a single branch in the context of a specific user. It executes
+      # hooks and contacts Rails to verify that the user is indeed allowed to delete that branch. The
+      # following known error conditions may happen:
+      #
+      # - Returns `InvalidArgument` in case either the branch name or user are not set.
+      # - Returns `FailedPrecondition` in case the branch does not exist.
+      # - Returns `OK` with a `PreReceiveError` in case custom hooks refused the update.
+      # - Returns `FailedPrecondition` in case updating the reference fails because of a concurrent
+      #   write to the same reference.
       rpc :UserDeleteBranch, ::Gitaly::UserDeleteBranchRequest, ::Gitaly::UserDeleteBranchResponse
       # UserCreateTag creates a new tag.
       rpc :UserCreateTag, ::Gitaly::UserCreateTagRequest, ::Gitaly::UserCreateTagResponse
+      # This comment is left unintentionally blank.
       rpc :UserDeleteTag, ::Gitaly::UserDeleteTagRequest, ::Gitaly::UserDeleteTagResponse
       # UserMergeRef creates a merge commit and updates target_ref to point to that
       # new commit. The first parent of the merge commit (the main line) is taken

data/ruby/proto/gitaly/praefect_pb.rb

@@ -1,12 +1,27 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: praefect.proto
 
+require 'google/protobuf/timestamp_pb'
 require 'lint_pb'
 require 'shared_pb'
 require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("praefect.proto", :syntax => :proto3) do
+    add_message "gitaly.MarkUnverifiedRequest" do
+      oneof :selector do
+        optional :repository_id, :int64, 1
+        optional :virtual_storage, :string, 2
+        optional :storage, :message, 3, "gitaly.MarkUnverifiedRequest.Storage"
+      end
+    end
+    add_message "gitaly.MarkUnverifiedRequest.Storage" do
+      optional :virtual_storage, :string, 1
+      optional :storage, :string, 2
+    end
+    add_message "gitaly.MarkUnverifiedResponse" do
+      optional :replicas_marked, :int64, 1
+    end
     add_message "gitaly.GetRepositoryMetadataRequest" do
       oneof :query do
         optional :repository_id, :int64, 1
@@ -32,6 +47,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :generation, :int64, 4
       optional :healthy, :bool, 5
       optional :valid_primary, :bool, 6
+      optional :verified_at, :message, 7, "google.protobuf.Timestamp"
     end
     add_message "gitaly.SetReplicationFactorRequest" do
       optional :virtual_storage, :string, 1
@@ -83,6 +99,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
 end
 
 module Gitaly
+  MarkUnverifiedRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.MarkUnverifiedRequest").msgclass
+  MarkUnverifiedRequest::Storage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.MarkUnverifiedRequest.Storage").msgclass
+  MarkUnverifiedResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.MarkUnverifiedResponse").msgclass
   GetRepositoryMetadataRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.GetRepositoryMetadataRequest").msgclass
   GetRepositoryMetadataRequest::Path = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.GetRepositoryMetadataRequest.Path").msgclass
   GetRepositoryMetadataResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.GetRepositoryMetadataResponse").msgclass

data/ruby/proto/gitaly/praefect_services_pb.rb

@@ -6,6 +6,8 @@ require 'praefect_pb'
 
 module Gitaly
   module PraefectInfoService
+    # PraefectInfoService is a service which provides RPCs to query and modify
+    # Praefect-specific parameters.
     class Service
 
       include ::GRPC::GenericService
@@ -14,6 +16,7 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.PraefectInfoService'
 
+      # This comment is left unintentionally blank.
       rpc :RepositoryReplicas, ::Gitaly::RepositoryReplicasRequest, ::Gitaly::RepositoryReplicasResponse
       # DatalossCheck checks for unavailable repositories.
       rpc :DatalossCheck, ::Gitaly::DatalossCheckRequest, ::Gitaly::DatalossCheckResponse
@@ -21,6 +24,9 @@ module Gitaly
       # This causes the current version of the repository on the authoritative storage to be considered the
       # latest and overwrite any other version on the virtual storage.
       rpc :SetAuthoritativeStorage, ::Gitaly::SetAuthoritativeStorageRequest, ::Gitaly::SetAuthoritativeStorageResponse
+      # MarkUnverified marks replicas as unverified. This will trigger verification as Praefect's metadata
+      # verifier prioritizes unverified replicas.
+      rpc :MarkUnverified, ::Gitaly::MarkUnverifiedRequest, ::Gitaly::MarkUnverifiedResponse
       # SetReplicationFactor assigns or unassigns host nodes from the repository to meet the desired replication factor.
       # SetReplicationFactor returns an error when trying to set a replication factor that exceeds the storage node count
       # in the virtual storage. An error is also returned when trying to set a replication factor below one. The primary node

data/ruby/proto/gitaly/ref_pb.rb

@@ -1,9 +1,10 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: ref.proto
 
+require 'errors_pb'
+require 'google/protobuf/timestamp_pb'
 require 'lint_pb'
 require 'shared_pb'
-require 'google/protobuf/timestamp_pb'
 require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
@@ -131,6 +132,12 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "gitaly.DeleteRefsResponse" do
       optional :git_error, :string, 1
     end
+    add_message "gitaly.DeleteRefsError" do
+      oneof :error do
+        optional :invalid_format, :message, 1, "gitaly.InvalidRefFormatError"
+        optional :references_locked, :message, 2, "gitaly.ReferencesLockedError"
+      end
+    end
     add_message "gitaly.ListBranchNamesContainingCommitRequest" do
       optional :repository, :message, 1, "gitaly.Repository"
       optional :commit_id, :string, 2
@@ -247,6 +254,7 @@ module Gitaly
   FindBranchResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.FindBranchResponse").msgclass
   DeleteRefsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.DeleteRefsRequest").msgclass
   DeleteRefsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.DeleteRefsResponse").msgclass
+  DeleteRefsError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.DeleteRefsError").msgclass
   ListBranchNamesContainingCommitRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.ListBranchNamesContainingCommitRequest").msgclass
   ListBranchNamesContainingCommitResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.ListBranchNamesContainingCommitResponse").msgclass
   ListTagNamesContainingCommitRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.ListTagNamesContainingCommitRequest").msgclass

data/ruby/proto/gitaly/ref_services_pb.rb

@@ -6,6 +6,7 @@ require 'ref_pb'
 
 module Gitaly
   module RefService
+    # RefService is a service that provides RPCs to list and modify Git references.
     class Service
 
       include ::GRPC::GenericService
@@ -14,28 +15,39 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.RefService'
 
+      # This comment is left unintentionally blank.
       rpc :FindDefaultBranchName, ::Gitaly::FindDefaultBranchNameRequest, ::Gitaly::FindDefaultBranchNameResponse
+      # This comment is left unintentionally blank.
       rpc :FindAllBranchNames, ::Gitaly::FindAllBranchNamesRequest, stream(::Gitaly::FindAllBranchNamesResponse)
+      # This comment is left unintentionally blank.
       rpc :FindAllTagNames, ::Gitaly::FindAllTagNamesRequest, stream(::Gitaly::FindAllTagNamesResponse)
       # Return a stream so we can divide the response in chunks of branches
       rpc :FindLocalBranches, ::Gitaly::FindLocalBranchesRequest, stream(::Gitaly::FindLocalBranchesResponse)
+      # This comment is left unintentionally blank.
       rpc :FindAllBranches, ::Gitaly::FindAllBranchesRequest, stream(::Gitaly::FindAllBranchesResponse)
       # Returns a stream of tags repository has.
       rpc :FindAllTags, ::Gitaly::FindAllTagsRequest, stream(::Gitaly::FindAllTagsResponse)
+      # This comment is left unintentionally blank.
       rpc :FindTag, ::Gitaly::FindTagRequest, ::Gitaly::FindTagResponse
+      # This comment is left unintentionally blank.
       rpc :FindAllRemoteBranches, ::Gitaly::FindAllRemoteBranchesRequest, stream(::Gitaly::FindAllRemoteBranchesResponse)
+      # This comment is left unintentionally blank.
       rpc :RefExists, ::Gitaly::RefExistsRequest, ::Gitaly::RefExistsResponse
       # FindBranch finds a branch by its unqualified name (like "master") and
       # returns the commit it currently points to.
       rpc :FindBranch, ::Gitaly::FindBranchRequest, ::Gitaly::FindBranchResponse
+      # This comment is left unintentionally blank.
       rpc :DeleteRefs, ::Gitaly::DeleteRefsRequest, ::Gitaly::DeleteRefsResponse
+      # This comment is left unintentionally blank.
       rpc :ListBranchNamesContainingCommit, ::Gitaly::ListBranchNamesContainingCommitRequest, stream(::Gitaly::ListBranchNamesContainingCommitResponse)
+      # This comment is left unintentionally blank.
       rpc :ListTagNamesContainingCommit, ::Gitaly::ListTagNamesContainingCommitRequest, stream(::Gitaly::ListTagNamesContainingCommitResponse)
       # GetTagSignatures returns signatures for annotated tags resolved from a set of revisions. Revisions
       # which don't resolve to an annotated tag are silently discarded. Revisions which cannot be resolved
       # result in an error. Tags which are annotated but not signed will return a TagSignature response
       # which has no signature, but its unsigned contents will still be returned.
       rpc :GetTagSignatures, ::Gitaly::GetTagSignaturesRequest, stream(::Gitaly::GetTagSignaturesResponse)
+      # This comment is left unintentionally blank.
       rpc :GetTagMessages, ::Gitaly::GetTagMessagesRequest, stream(::Gitaly::GetTagMessagesResponse)
       # PackRefs is deprecated in favor of OptimizeRepository.
       rpc :PackRefs, ::Gitaly::PackRefsRequest, ::Gitaly::PackRefsResponse

data/ruby/proto/gitaly/remote_services_pb.rb

@@ -6,6 +6,8 @@ require 'remote_pb'
 
 module Gitaly
   module RemoteService
+    # RemoteService is a service providing RPCs to interact with a remote
+    # repository that is hosted on another Git server.
     class Service
 
       include ::GRPC::GenericService
@@ -20,6 +22,7 @@ module Gitaly
       # deleted from the mirror. UpdateRemoteMirror updates all tags. Branches are updated if they match
       # the patterns specified in the requests.
       rpc :UpdateRemoteMirror, stream(::Gitaly::UpdateRemoteMirrorRequest), ::Gitaly::UpdateRemoteMirrorResponse
+      # This comment is left unintentionally blank.
       rpc :FindRemoteRepository, ::Gitaly::FindRemoteRepositoryRequest, ::Gitaly::FindRemoteRepositoryResponse
       # FindRemoteRootRef tries to find the root reference of a remote
       # repository. The root reference is the default branch as pointed to by

data/ruby/proto/gitaly/{repository-service_pb.rb → repository_pb.rb}

@@ -1,12 +1,12 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
-# source: repository-service.proto
+# source: repository.proto
 
 require 'lint_pb'
 require 'shared_pb'
 require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("repository-service.proto", :syntax => :proto3) do
+  add_file("repository.proto", :syntax => :proto3) do
     add_message "gitaly.RepositoryExistsRequest" do
       optional :repository, :message, 1, "gitaly.Repository"
     end

data/ruby/proto/gitaly/{repository-service_services_pb.rb → repository_services_pb.rb}

@@ -1,11 +1,12 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
-# Source: repository-service.proto for package 'gitaly'
+# Source: repository.proto for package 'gitaly'
 
 require 'grpc'
-require 'repository-service_pb'
+require 'repository_pb'
 
 module Gitaly
   module RepositoryService
+    # RepositoryService is a service providing RPCs accessing repositories as a whole.
     class Service
 
       include ::GRPC::GenericService
@@ -14,6 +15,7 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.RepositoryService'
 
+      # This comment is left unintentionally blank.
       rpc :RepositoryExists, ::Gitaly::RepositoryExistsRequest, ::Gitaly::RepositoryExistsResponse
       # RepackIncremental is deprecated in favor of OptimizeRepository.
       rpc :RepackIncremental, ::Gitaly::RepackIncrementalRequest, ::Gitaly::RepackIncrementalResponse
@@ -25,21 +27,31 @@ module Gitaly
       rpc :GarbageCollect, ::Gitaly::GarbageCollectRequest, ::Gitaly::GarbageCollectResponse
       # WriteCommitGraph is deprecated in favor of OptimizeRepository.
       rpc :WriteCommitGraph, ::Gitaly::WriteCommitGraphRequest, ::Gitaly::WriteCommitGraphResponse
+      # This comment is left unintentionally blank.
       rpc :RepositorySize, ::Gitaly::RepositorySizeRequest, ::Gitaly::RepositorySizeResponse
+      # This comment is left unintentionally blank.
       rpc :ApplyGitattributes, ::Gitaly::ApplyGitattributesRequest, ::Gitaly::ApplyGitattributesResponse
       # FetchRemote fetches references from a remote repository into the local
       # repository.
       rpc :FetchRemote, ::Gitaly::FetchRemoteRequest, ::Gitaly::FetchRemoteResponse
+      # This comment is left unintentionally blank.
       rpc :CreateRepository, ::Gitaly::CreateRepositoryRequest, ::Gitaly::CreateRepositoryResponse
+      # This comment is left unintentionally blank.
       rpc :GetArchive, ::Gitaly::GetArchiveRequest, stream(::Gitaly::GetArchiveResponse)
+      # This comment is left unintentionally blank.
       rpc :HasLocalBranches, ::Gitaly::HasLocalBranchesRequest, ::Gitaly::HasLocalBranchesResponse
       # FetchSourceBranch fetches a branch from a second (potentially remote)
       # repository into the given repository.
       rpc :FetchSourceBranch, ::Gitaly::FetchSourceBranchRequest, ::Gitaly::FetchSourceBranchResponse
+      # This comment is left unintentionally blank.
       rpc :Fsck, ::Gitaly::FsckRequest, ::Gitaly::FsckResponse
+      # This comment is left unintentionally blank.
       rpc :WriteRef, ::Gitaly::WriteRefRequest, ::Gitaly::WriteRefResponse
+      # This comment is left unintentionally blank.
       rpc :FindMergeBase, ::Gitaly::FindMergeBaseRequest, ::Gitaly::FindMergeBaseResponse
+      # This comment is left unintentionally blank.
       rpc :CreateFork, ::Gitaly::CreateForkRequest, ::Gitaly::CreateForkResponse
+      # This comment is left unintentionally blank.
       rpc :CreateRepositoryFromURL, ::Gitaly::CreateRepositoryFromURLRequest, ::Gitaly::CreateRepositoryFromURLResponse
       # CreateBundle creates a bundle from all refs
       rpc :CreateBundle, ::Gitaly::CreateBundleRequest, stream(::Gitaly::CreateBundleResponse)
@@ -50,28 +62,42 @@ module Gitaly
       # Refs will be mirrored to the target repository with the refspec
       # "+refs/*:refs/*" and refs that do not exist in the bundle will be removed.
       rpc :FetchBundle, stream(::Gitaly::FetchBundleRequest), ::Gitaly::FetchBundleResponse
+      # This comment is left unintentionally blank.
       rpc :CreateRepositoryFromBundle, stream(::Gitaly::CreateRepositoryFromBundleRequest), ::Gitaly::CreateRepositoryFromBundleResponse
       # GetConfig reads the target repository's gitconfig and streams its contents
       # back. Returns a NotFound error in case no gitconfig was found.
       rpc :GetConfig, ::Gitaly::GetConfigRequest, stream(::Gitaly::GetConfigResponse)
+      # This comment is left unintentionally blank.
       rpc :FindLicense, ::Gitaly::FindLicenseRequest, ::Gitaly::FindLicenseResponse
+      # This comment is left unintentionally blank.
       rpc :GetInfoAttributes, ::Gitaly::GetInfoAttributesRequest, stream(::Gitaly::GetInfoAttributesResponse)
+      # This comment is left unintentionally blank.
       rpc :CalculateChecksum, ::Gitaly::CalculateChecksumRequest, ::Gitaly::CalculateChecksumResponse
       # Cleanup is deprecated in favor of OptimizeRepository.
       rpc :Cleanup, ::Gitaly::CleanupRequest, ::Gitaly::CleanupResponse
+      # This comment is left unintentionally blank.
       rpc :GetSnapshot, ::Gitaly::GetSnapshotRequest, stream(::Gitaly::GetSnapshotResponse)
+      # This comment is left unintentionally blank.
       rpc :CreateRepositoryFromSnapshot, ::Gitaly::CreateRepositoryFromSnapshotRequest, ::Gitaly::CreateRepositoryFromSnapshotResponse
+      # This comment is left unintentionally blank.
       rpc :GetRawChanges, ::Gitaly::GetRawChangesRequest, stream(::Gitaly::GetRawChangesResponse)
+      # This comment is left unintentionally blank.
       rpc :SearchFilesByContent, ::Gitaly::SearchFilesByContentRequest, stream(::Gitaly::SearchFilesByContentResponse)
+      # This comment is left unintentionally blank.
       rpc :SearchFilesByName, ::Gitaly::SearchFilesByNameRequest, stream(::Gitaly::SearchFilesByNameResponse)
+      # This comment is left unintentionally blank.
       rpc :RestoreCustomHooks, stream(::Gitaly::RestoreCustomHooksRequest), ::Gitaly::RestoreCustomHooksResponse
+      # This comment is left unintentionally blank.
       rpc :BackupCustomHooks, ::Gitaly::BackupCustomHooksRequest, stream(::Gitaly::BackupCustomHooksResponse)
+      # This comment is left unintentionally blank.
       rpc :GetObjectDirectorySize, ::Gitaly::GetObjectDirectorySizeRequest, ::Gitaly::GetObjectDirectorySizeResponse
       # RemoveRepository will move the repository to `+gitaly/tmp/<relative_path>_removed` and
       # eventually remove it. This ensures that even on networked filesystems the
       # data is actually removed even if there's someone still handling the data.
       rpc :RemoveRepository, ::Gitaly::RemoveRepositoryRequest, ::Gitaly::RemoveRepositoryResponse
+      # This comment is left unintentionally blank.
       rpc :RenameRepository, ::Gitaly::RenameRepositoryRequest, ::Gitaly::RenameRepositoryResponse
+      # This comment is left unintentionally blank.
       rpc :ReplicateRepository, ::Gitaly::ReplicateRepositoryRequest, ::Gitaly::ReplicateRepositoryResponse
       # OptimizeRepository performs all maintenance tasks in a repository to keep
       # it in an efficient state. It cleans up stale data, repacks objects,

data/ruby/proto/gitaly/server_services_pb.rb

@@ -6,6 +6,7 @@ require 'server_pb'
 
 module Gitaly
   module ServerService
+    # ServerService is a service that provides information about a Gitaly server.
     class Service
 
       include ::GRPC::GenericService
@@ -14,7 +15,9 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.ServerService'
 
+      # This comment is left unintentionally blank.
       rpc :ServerInfo, ::Gitaly::ServerInfoRequest, ::Gitaly::ServerInfoResponse
+      # This comment is left unintentionally blank.
       rpc :DiskStatistics, ::Gitaly::DiskStatisticsRequest, ::Gitaly::DiskStatisticsResponse
       # ClockSynced checks if machine clock is synced
       # (the offset is less that the one passed in the request).

data/ruby/proto/gitaly/smarthttp_services_pb.rb

@@ -6,6 +6,8 @@ require 'smarthttp_pb'
 
 module Gitaly
   module SmartHTTPService
+    # SmartHTTPService is a service that provides RPCs required for HTTP-based Git
+    # clones via the smart HTTP protocol.
     class Service
 
       include ::GRPC::GenericService

data/ruby/proto/gitaly/ssh_services_pb.rb

@@ -6,6 +6,7 @@ require 'ssh_pb'
 
 module Gitaly
   module SSHService
+    # SSHService is a service that provides RPCs required for SSH-based Git clones.
     class Service
 
       include ::GRPC::GenericService

data/ruby/proto/gitaly/transaction_services_pb.rb

@@ -6,6 +6,11 @@ require 'transaction_pb'
 
 module Gitaly
   module RefTransaction
+    # RefTransaction is a service which provides RPCs to interact with reference
+    # transactions. Reference transactions are used in the context of Gitaly
+    # Cluster to ensure that all nodes part of a single transaction perform the
+    # same change: given a set of changes, the changes are hashed and the hash is
+    # then voted on.
     class Service
 
       include ::GRPC::GenericService
@@ -14,7 +19,28 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.RefTransaction'
 
+      # VoteTransaction casts a vote on a transaction to establish whether the
+      # node is doing the same change as all the other nodes part of the
+      # transaction. This RPC blocks until quorum has been reached, which may be
+      # _before_ all nodes have cast a vote.
+      #
+      # This RPC may return one of the following error codes:
+      #
+      # - `NotFound` in case the transaction could not be found.
+      # - `Canceled` in case the transaction has been canceled before quorum was
+      #   reached.
       rpc :VoteTransaction, ::Gitaly::VoteTransactionRequest, ::Gitaly::VoteTransactionResponse
+      # StopTransaction gracefully stops a transaction. This RPC can be used if
+      # only a subset of nodes executes specific code which may cause the
+      # transaction to fail. One such example is Git hooks, which only execute on
+      # the primary Gitaly noded. Other nodes which vote on this transaction will
+      # get a response with the `STOP` state being set.
+      #
+      # This RPC may return one of the following error codes:
+      #
+      # - `NotFound` in case the transaction could not be found.
+      # - `Canceled` in case the transaction has been canceled before quorum was
+      #   reached.
       rpc :StopTransaction, ::Gitaly::StopTransactionRequest, ::Gitaly::StopTransactionResponse
     end
 

data/ruby/proto/gitaly/version.rb

@@ -2,5 +2,5 @@
 # (https://gitlab.com/gitlab-org/release-tools/), and should not be
 # modified.
 module Gitaly
-  VERSION = '14.10.0-rc1'
+  VERSION = '15.1.0-rc1'
 end

data/ruby/proto/gitaly/wiki_services_pb.rb

@@ -6,6 +6,9 @@ require 'wiki_pb'
 
 module Gitaly
   module WikiService
+    # WikiService is a service that provides Wiki-related functionality. This
+    # service is deprecated and should not be used anymore. Instead, all
+    # functionality to implement Wikis should use Git-based RPCS.
     class Service
 
       include ::GRPC::GenericService
@@ -14,11 +17,15 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.WikiService'
 
+      # This comment is left unintentionally blank.
       rpc :WikiWritePage, stream(::Gitaly::WikiWritePageRequest), ::Gitaly::WikiWritePageResponse
+      # This comment is left unintentionally blank.
       rpc :WikiUpdatePage, stream(::Gitaly::WikiUpdatePageRequest), ::Gitaly::WikiUpdatePageResponse
       # WikiFindPage returns a stream because the page's raw_data field may be arbitrarily large.
       rpc :WikiFindPage, ::Gitaly::WikiFindPageRequest, stream(::Gitaly::WikiFindPageResponse)
+      # This comment is left unintentionally blank.
       rpc :WikiGetAllPages, ::Gitaly::WikiGetAllPagesRequest, stream(::Gitaly::WikiGetAllPagesResponse)
+      # This comment is left unintentionally blank.
       rpc :WikiListPages, ::Gitaly::WikiListPagesRequest, stream(::Gitaly::WikiListPagesResponse)
     end
 

data/ruby/proto/gitaly.rb

@@ -29,7 +29,7 @@ require 'gitaly/ref_services_pb'
 
 require 'gitaly/remote_services_pb'
 
-require 'gitaly/repository-service_services_pb'
+require 'gitaly/repository_services_pb'
 
 require 'gitaly/server_services_pb'
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gitaly
 version: !ruby/object:Gem::Version
-  version: 14.10.0.pre.rc1
+  version: 15.1.0.pre.rc1
 platform: ruby
 authors:
 - Jacob Vosmaer
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-04-06 00:00:00.000000000 Z
+date: 2022-06-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: grpc
@@ -61,8 +61,8 @@ files:
 - ruby/proto/gitaly/ref_services_pb.rb
 - ruby/proto/gitaly/remote_pb.rb
 - ruby/proto/gitaly/remote_services_pb.rb
-- ruby/proto/gitaly/repository-service_pb.rb
-- ruby/proto/gitaly/repository-service_services_pb.rb
+- ruby/proto/gitaly/repository_pb.rb
+- ruby/proto/gitaly/repository_services_pb.rb
 - ruby/proto/gitaly/server_pb.rb
 - ruby/proto/gitaly/server_services_pb.rb
 - ruby/proto/gitaly/shared_pb.rb
@@ -79,7 +79,7 @@ homepage: https://gitlab.com/gitlab-org/gitaly
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - ruby/proto
@@ -95,7 +95,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 1.3.1
 requirements: []
 rubygems_version: 3.1.6
-signing_key: 
+signing_key:
 specification_version: 4
 summary: Auto-generated gRPC client for gitaly
 test_files: []