feat: add deprecated empty? wrapper on Git::Repository::StatusOperations

- Add empty? deprecated wrapper to Git::Repository::StatusOperations that
  delegates to no_commits? and emits Git::Deprecation.warn
- Add no_commits? delegator to Git::Base forwarding to facade_repository
- Add empty? deprecated delegator to Git::Base forwarding to facade_repository.empty?
- Add unit tests for empty? covering deprecation warning, delegation, and return value

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: jcouball

lib/git/base.rb

@@ -1402,6 +1402,23 @@ def stash_clear
 
     # @!group Bucket 6 delegators — Git::Repository::StatusOperations
 
+    # @return [Boolean] `true` when the repository has no commits, `false` otherwise
+    def no_commits?
+      facade_repository.no_commits?
+    end
+
+    # @deprecated Use {#no_commits?} instead.
+    #
+    # @return [Boolean] `true` when the repository has no commits, `false` otherwise
+    #
+    def empty?
+      Git::Deprecation.warn(
+        'Git::Base#empty? is deprecated and will be removed in a future version. ' \
+        'Use Git::Base#no_commits? instead.'
+      )
+      no_commits?
+    end
+
     # @return [Array<String>] list of untracked file paths
     def untracked_files
       facade_repository.untracked_files

lib/git/repository/status_operations.rb

@@ -43,6 +43,27 @@ def no_commits?
         true
       end
 
+      # Returns `true` if the repository has no commits yet
+      #
+      # @example Check whether a repository is empty
+      #   repo.empty? #=> true   # freshly initialized, no commits yet
+      #   repo.empty? #=> false  # at least one commit exists
+      #
+      # @return [Boolean] `true` when the repository has no commits, `false` otherwise
+      #
+      # @raise [Git::FailedError] if git exits with a non-zero exit status other
+      #   than when the repository has no commits
+      #
+      # @deprecated Use {#no_commits?} instead
+      #
+      def empty?
+        Git::Deprecation.warn(
+          'Git::Repository#empty? is deprecated and will be removed in a future version. ' \
+          'Use Git::Repository#no_commits? instead.'
+        )
+        no_commits?
+      end
+
       # List all files in the working tree that are not tracked by git
       #
       # Runs `git ls-files --others --exclude-standard` from the working tree

spec/unit/git/repository/status_operations_spec.rb

@@ -145,6 +145,30 @@
     end
   end
 
+  describe '#empty?' do
+    subject(:result) { described_instance.empty? }
+
+    before do
+      allow(described_instance).to receive(:no_commits?).and_return(true)
+      allow(Git::Deprecation).to receive(:warn)
+    end
+
+    it 'emits a deprecation warning matching /empty\? is deprecated/' do
+      expect(Git::Deprecation).to receive(:warn).with(/empty\? is deprecated/)
+      result
+    end
+
+    it 'delegates to no_commits?' do
+      expect(described_instance).to receive(:no_commits?).and_return(true)
+      result
+    end
+
+    it 'returns the return value of no_commits?' do
+      allow(described_instance).to receive(:no_commits?).and_return(false)
+      expect(result).to be(false)
+    end
+  end
+
   describe '#untracked_files' do
     subject(:result) { described_instance.untracked_files }