git 4.4.1 → 5.0.0.beta.1

data/.github/workflows/continuous_integration.yml

@@ -33,11 +33,11 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Setup Java
         if: matrix.java_version != ''
-        uses: actions/setup-java@v4
+        uses: actions/setup-java@v5
         with:
           distribution: 'temurin'
           java-version: ${{ matrix.java_version }}
@@ -50,71 +50,7 @@ jobs:
 
       - name: Run Build
         run: bundle exec rake default
+        timeout-minutes: 15
 
       - name: Test Gem
         run: bundle exec rake test:gem
-
-  # The branch ruleset cannot require the matrix job above directly. A required status
-  # check is matched by name, and `build`'s name is a template -- GitHub only expands it
-  # into "Ruby 3.2 on ubuntu-latest" and friends when it evaluates the matrix. The
-  # job-level `if:` short-circuits before that happens, so a release PR reports one check
-  # named literally "Ruby ${{ matrix.ruby }} on ${{ matrix.operating-system }}" and the
-  # six expanded names never report at all. Required checks that never report block a PR
-  # indefinitely rather than passing, which is what stranded the v5.0.5 release PR on
-  # main and the v4.4.1 release PR here.
-  #
-  # So the ruleset requires this job instead: one stable name, no matrix, no template to
-  # expand. It also decouples the required-check list from the matrix, so adding or
-  # dropping a Ruby version no longer needs a matching ruleset edit.
-  #
-  # Unlike main, this branch has no separate lint job: `rake default` runs RuboCop and
-  # YARD inside every matrix leg, so this one check covers everything CI does here.
-  #
-  # This job carries the same release-PR guard as the matrix above, so that a release PR
-  # reports it as skipped rather than as a success for specs that never ran. Skipping is
-  # safe here and was not safe for `build`: this job's name is a literal string, so the
-  # check run exists and reports a skipped conclusion whether or not the job runs, and
-  # rulesets treat skipped as passing. A matrix job's name does not exist at all until the
-  # matrix is evaluated, which is the whole reason this job exists.
-  #
-  # `always()` is load-bearing and must stay. Without a status check function a job-level
-  # `if:` implies `success()`, so a failing matrix would skip this job -- and a skipped
-  # required check counts as passing, meaning a red build would merge. `always()` forces a
-  # real verdict on every run that is not a release PR. `!cancelled()` is not a substitute:
-  # a cancelled run would then skip the gate, and a skipped conclusion is one rulesets treat
-  # as passing -- so a build that never finished would stop blocking the merge.
-  #
-  # The case below accepts `success` only. `build` and this job now carry the same release-PR
-  # guard, so this job runs exactly when `build` ran; a `skipped` result would mean the two
-  # guards have drifted apart, and failing closed on it turns that into a loud failure rather
-  # than a silent pass.
-  #
-  # Note that a matrix leg marked `experimental: Yes` carries continue-on-error, and a
-  # continue-on-error failure does not fail the job as a whole -- so it does not fail this
-  # gate either. That is what `experimental` is for; no leg currently sets it.
-  build-complete:
-    name: All Specs Passed
-
-    needs: [build]
-
-    # Report a verdict on every non-release PR regardless of the matrix result, and skip
-    # on release PRs, where the matrix was never meant to run.
-    if: >-
-      always() &&
-      (github.event_name == 'workflow_dispatch' ||
-      (github.event_name == 'pull_request' && !startsWith(github.event.pull_request.head.ref, 'release-please--')))
-
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Check the result of the build job
-        run: |
-          case "${{ needs.build.result }}" in
-            success)
-              echo "build: ${{ needs.build.result }}"
-              ;;
-            *)
-              echo "::error::build: ${{ needs.build.result }}"
-              exit 1
-              ;;
-          esac

data/.github/workflows/enforce_conventional_commits.yml

@@ -21,7 +21,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with: { fetch-depth: 0 }
 
       - name: Check Commit Messages

data/.github/workflows/experimental_continuous_integration.yml

@@ -37,11 +37,11 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Setup Java
         if: matrix.java_version != ''
-        uses: actions/setup-java@v4
+        uses: actions/setup-java@v5
         with:
           distribution: 'temurin'
           java-version: ${{ matrix.java_version }}

data/.github/workflows/release.yml

@@ -30,16 +30,15 @@ jobs:
 
     steps:
       - name: Checkout project
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Create release
-        uses: googleapis/release-please-action@v4
+        uses: googleapis/release-please-action@v5
         id: release
         with:
           token: ${{ secrets.AUTO_RELEASE_TOKEN }}
-          config-file: release-please-config.json
+          config-file: .release-please-config.json
           manifest-file: .release-please-manifest.json
-          target-branch: ${{ github.ref_name }}
 
       - name: Setup ruby
         uses: ruby/setup-ruby@v1

data/.gitignore

@@ -2,6 +2,8 @@
 *.kpf
 *.sw?
 .DS_Store
+.bundle/
+vendor/bundle/
 coverage
 doc
 .yardoc
@@ -12,3 +14,9 @@ node_modules
 package-lock.json
 ai-prompt.erb
 rubocop-report.json
+
+# rspec failure tracking
+.rspec_status
+
+# generated git reference docs
+git-reference/

data/.husky/pre-commit

@@ -0,0 +1,13 @@
+#!/bin/sh
+
+branch=$(git branch --show-current)
+
+protected_branches="main 4.x"
+
+for protected in $protected_branches; do
+  if [ "$branch" = "$protected" ]; then
+    echo "ERROR: Direct commits to '$branch' are not allowed."
+    echo "       Create a topic branch first:  git switch -c <branch-name>"
+    exit 1
+  fi
+done

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "4.4.1"
+  ".": "4.1.2"
 }

data/.rspec

@@ -0,0 +1,3 @@
+--require spec_helper
+--format Fuubar
+--color

data/.rubocop.yml

@@ -3,6 +3,10 @@ inherit_from: .rubocop_todo.yml
 inherit_gem:
   main_branch_shared_rubocop_config: config/rubocop.yml
 
+inherit_mode:
+  merge:
+    - Exclude
+
 # Don't care about complexity offenses in the TestUnit tests This exclusions
 # will be removed when we switch to RSpec.
 Metrics/CyclomaticComplexity:
@@ -33,12 +37,13 @@ Layout/LineLength:
     - "tests/units/**/*"
     - "*.gemspec"
 
-# Testing and gemspec DSL results in large blocks
+# Testing, gemspec, and command DSL blocks are intentionally long
 Metrics/BlockLength:
   Exclude:
     - "tests/test_helper.rb"
     - "tests/units/**/*"
     - "*.gemspec"
+    - "lib/git/commands/**/*.rb"
 
 # Don't force every test class to be described
 Style/Documentation:
@@ -46,8 +51,7 @@ Style/Documentation:
     - "tests/units/**/*"
 
 Style/OneClassPerFile:
-  Exclude:
-    - "tests/units/**/*"
+  Enabled: false
 
 AllCops:
   # Pin this project to Ruby 3.1 in case the shared config above is upgraded to 3.2

data/.rubocop_todo.yml

@@ -1,12 +1,30 @@
 # This configuration was generated by
-# `rubocop --auto-gen-config`
-# on 2025-08-17 04:52:22 UTC using RuboCop version 1.79.2.
+# `rubocop --auto-gen-config --auto-gen-only-exclude --exclude-limit 999`
+# on 2026-01-28 20:48:52 UTC using RuboCop version 1.82.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 2
-# Configuration parameters: CountComments, CountAsOne.
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
+# URISchemes: http, https
+Layout/LineLength:
+  Exclude:
+    - 'spec/unit/git/commands/tag/list_spec.rb'
+
+# Offense count: 4
+# Configuration parameters: CountComments, Max, CountAsOne.
 Metrics/ClassLength:
-  Max: 1170
+  Exclude:
+    - 'lib/git/base.rb'
+    - 'lib/git/branch.rb'
+    - 'lib/git/commands/arguments.rb'
+    - 'lib/git/lib.rb'
+
+# Offense count: 1
+# Configuration parameters: CountComments, Max, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Exclude:
+    - 'lib/git/commands/tag/list.rb'

data/.yardopts

@@ -3,6 +3,7 @@
 --markup-provider=redcarpet
 --markup=markdown
 --fail-on-warning
+--plugin yard_example_test
 -
 README.md
 CHANGELOG.md

data/CHANGELOG.md

@@ -5,72 +5,6 @@
 
 # Change Log
 
-## [4.4.1](https://github.com/ruby-git/ruby-git/compare/v4.4.0...v4.4.1) (2026-08-09)
-
-
-### Bug Fixes
-
-* Pin LC_ALL to a locale that exists on the host platform ([690360e](https://github.com/ruby-git/ruby-git/commit/690360e386bac1dafb7b5bd0adbf10072e834f69)), closes [#1669](https://github.com/ruby-git/ruby-git/issues/1669)
-
-
-### Other Changes
-
-* Add a matrix-free All Specs Passed gate to 4.x ([5352d6d](https://github.com/ruby-git/ruby-git/commit/5352d6d4edfcb52c544139e265fb3636bc1937b7)), closes [#1675](https://github.com/ruby-git/ruby-git/issues/1675)
-* Skip the All Specs Passed gate on release PRs ([52473b2](https://github.com/ruby-git/ruby-git/commit/52473b21a733499eb274a7b03d53f1a0efbf5c86)), closes [#1675](https://github.com/ruby-git/ruby-git/issues/1675)
-
-## [4.4.0](https://github.com/ruby-git/ruby-git/compare/v4.3.2...v4.4.0) (2026-07-11)
-
-
-### Features
-
-* Allow deprecation behavior env var ([fd622be](https://github.com/ruby-git/ruby-git/commit/fd622bea6513d78f2dbed8dc19c110be80d07ec8))
-* Warn on first direct access to Git::Lib constant ([52059c6](https://github.com/ruby-git/ruby-git/commit/52059c63d5c23b4d80025b95332e946aba942f0c))
-
-
-### Other Changes
-
-* Improve YARD documentation for Git::Branch ([#1277](https://github.com/ruby-git/ruby-git/issues/1277)) ([0769bf9](https://github.com/ruby-git/ruby-git/commit/0769bf91a21ecb24d48a31439de073b689bc62b6))
-
-## [4.3.2](https://github.com/ruby-git/ruby-git/compare/v4.3.1...v4.3.2) (2026-03-31)
-
-
-### Bug Fixes
-
-* Return empty result from git log on repo with no commits ([d275b25](https://github.com/ruby-git/ruby-git/commit/d275b25b03201ebaca13a81a75e3295ed85c40c7)), closes [#1155](https://github.com/ruby-git/ruby-git/issues/1155)
-
-
-### Other Changes
-
-* Add docker-git script to test with specific git versions ([0cc0e80](https://github.com/ruby-git/ruby-git/commit/0cc0e804758e73520c124622a7ba49ff97f2deaf))
-* Address newly reported rubocop offenses ([a37412d](https://github.com/ruby-git/ruby-git/commit/a37412d6a1cf2b927a6173ea767a7ad9f1290af6))
-
-## [4.3.1](https://github.com/ruby-git/ruby-git/compare/v4.3.0...v4.3.1) (2026-02-20)
-
-
-### Bug Fixes
-
-* Resolve NoMethodError for Git::Base#cat_file ([#1058](https://github.com/ruby-git/ruby-git/issues/1058)) ([310bc73](https://github.com/ruby-git/ruby-git/commit/310bc73c1a62e7548eb43e5d3ef844af0b266fc7))
-
-## [4.3.0](https://github.com/ruby-git/ruby-git/compare/v4.2.0...v4.3.0) (2026-01-15)
-
-
-### Features
-
-* Add support for git fsck command ([c402003](https://github.com/ruby-git/ruby-git/commit/c402003ce0c626a5c4737838cddc4b932638c172)), closes [#218](https://github.com/ruby-git/ruby-git/issues/218)
-
-## [4.2.0](https://github.com/ruby-git/ruby-git/compare/v4.1.2...v4.2.0) (2026-01-11)
-
-
-### Features
-
-* Add deprecation warning for .path accessor ([8af4543](https://github.com/ruby-git/ruby-git/commit/8af4543a25a46bf40ed7a05b31cea1a5b17e3f0b))
-
-
-### Other Changes
-
-* Add target-branch to release-please action ([13e041e](https://github.com/ruby-git/ruby-git/commit/13e041ebb76587b90549896a4c9b9b872f60696a))
-* Set 4.x manifest to start from 4.1.1 ([1ccee62](https://github.com/ruby-git/ruby-git/commit/1ccee62cdd832a6de2307b0a61ceb593548e7fe1))
-
 ## [4.1.2](https://github.com/ruby-git/ruby-git/compare/v4.1.1...v4.1.2) (2026-01-10)