Change Log

6.0.0 (2026-10-28)

⚠ BREAKING CHANGES

Git::Repository no longer defines object_contents, object_size, object_type, commit_data, tag_data, revparse, namerev, or diff_name_status. Call cat_file_contents, cat_file_size, cat_file_type, cat_file_commit, cat_file_tag, rev_parse, name_rev, and diff_path_status instead.
errors: the minimum activesupport version is now 7.0.9 (was 5.0).
deprecation: Git::Deprecation.deprecation_horizon is now "in a future major release" (was "6.0.0"). Code that parses it as a version raises.
factories: raise ArgumentError when Git.init receives an unknown option key
factories: raise ArgumentError when Git.open or Git.bare receives an unknown option key
factories: Git.init and Git.clone expand a ~-prefixed directory and a ~-prefixed :repository option to the home directory instead of passing the literal ~ to git. Git.clone also expands a ~-prefixed :chdir option.
path_resolver: a relative :repository or :index option passed to a factory method is expanded against the process working directory instead of the working directory or git directory. Callers who relied on the old expansion pass the joined path explicitly.
repository: Git::Repository#archive raises Git::Error instead of a Zlib::Error subclass when gzip compression fails; the Zlib::Error is available through cause.
stash: Git::Repository#stash_store raises Git::UnexpectedResultError instead of returning nil when the stored commit is missing from the stash list.
tag: Git::Repository#tag_create raises Git::UnexpectedResultError instead of returning nil when the tag it created is missing from the tag list.
remote: Git::Remote is removed and referencing it raises NameError; Git::Repository no longer defines remote or config_remote. Use Git::Repository#remote_list, which returns ArrayGit::RemoteInfo, and the name-based remote operations; filter Git::Repository#config_list on the "remote.." key prefix for entries Git::RemoteInfo does not model.
branch: Git::Branch and Git::Branches are removed and referencing them raises NameError; Git::Repository no longer defines branch or branches, and Git::Remote no longer defines branch. Use Git::Repository#branch_list, which returns ArrayGit::BranchInfo, and the name-based branch operations.
worktree: Git::Worktree, Git::Worktrees, Git::Repository#worktree, Git::Repository#worktrees, and Git::Repository#worktrees_all are removed. Git::Repository#worktree_add returns a Git::WorktreeInfo instead of the git worktree add output String.
stash: Git::Stash, Git::Stashes, Git::Repository#stashes_all, and Git::Repository#stash_save are removed. Git::Repository#stash_list returns ArrayGit::StashInfo, newest first, instead of a String; stash_infos remains as an alias.
status: Git::Status and Git::Status::StatusFile are removed and referencing them raises NameError; Git::Repository no longer defines status. Use Git::Repository#status_info, which returns Git::StatusInfo holding one
author: Git::Author is removed; referencing it raises NameError. Use
Git::Repository no longer defines remotes; call remote_list (or remote_names) instead. Git::Branch no longer defines stashes; call Git::Repository#stash_infos instead. Git::Commands::CatFile::Raw no longer accepts the allow_unknown_type option and raises ArgumentError when it is passed; there is no replacement.
Git::Repository#config, Git::Repository#global_config, Git.global_config, and the config and global_config instance methods of the Git module no longer exist. Use config_get, config_set, and config_list (with
log: Git::Log no longer includes Enumerable or defines each, size, to_s, first, last, or []. Call Git::Log#execute and use the Git::Log::Result it returns. Git::Object::Commit no longer defines set_commit; call from_data instead.
repository: Git::Repository no longer defines empty?, reset_hard, conflicts, is_local_branch?, is_remote_branch?, is_branch?, or branches_all. Call no_commits?, reset(commitish, hard: true), each_conflict, local_branch?, remote_branch?, branch?, and branch_list instead.
repository: Git::Repository#clean no longer accepts :ff or :force_force, diff_path_status no longer accepts :path, and commit no longer accepts :add_all; each raises ArgumentError. set_working and set_index no longer take a positional check argument. Use force: 2, :path_limiter, :all, and must_exist: instead.
repository: with_index, with_temp_index, with_working, and with_temp_working raise ArgumentError when called without a block or with a block that declares no positional parameter. Declare the parameter and call methods on it. See UPGRADING.md.
repository: with_index, with_temp_index, with_working, and with_temp_working yield a separate Git::Repository bound to the temporary index or working tree instead of rebinding the receiver. Code that ignores the block parameter and calls the outer repository inside the block now runs against the original index or working tree; use the block parameter. See UPGRADING.md.
export: Git.export(url, dir, remote: name) raises ArgumentError instead of silently ignoring the option. Delete the option from the call; there is no replacement because the remote name was never observable in the exported tree.
Git.clone no longer accepts :path, :recursive, or :remote and raises ArgumentError when given one. Use :chdir, :recurse_submodules, and :origin instead.
Git.binary_version no longer exists; use Git.git_version (call .to_a for the legacy Array). Git.ls_remote(nil) raises ArgumentError; omit the argument or pass '.'.
The Git::Base constant no longer exists, so is_a?(Git::Base) checks and monkeypatches of Git::Base raise NameError. Include an application-owned module into Git::Repository instead.
Git::Repository#lib no longer exists. Call the facade method directly on the repository object.
Git::CommandLineResult no longer exists. Use
Git::Object::Tag no longer exists, Git::Repository no longer defines tag, tags, or tag_add, and Git::Object.new no longer accepts an is_tag argument. Use tag_list and tag_create on Git::Repository, which return
Git::Repository no longer defines add_remote, remove_remote, set_remote_url, add_tag, or delete_tag. Call remote_add, remote_remove, remote_set_url, tag_create, and tag_delete instead.
addressable 2.9.0 or later is required. Applications whose bundle caps addressable below 2.9.0 must update that dependency or stay on the latest v5.x release.
git 2.43.0 or later is required. Ubuntu 22.04 users must install a newer git or stay on v5.x.
Ruby 3.3.0 or later is required. Applications on Ruby 3.2 must upgrade Ruby or stay on the latest v5.x release.

Features

author: Remove Git::Author (315eec2), closes #1728
branch: Remove Git::Branch and Git::Branches (bbe3a83), closes #1723 #1631
export: Reject the :remote option to Git.export (6d46862), closes #1820
factories: Accept an :index option in Git.bare (333d609), closes #1868
factories: Raise ArgumentError when Git.init receives an unknown option key (0ffc8cd), closes #1913 #1869
factories: Raise ArgumentError when Git.open or Git.bare receives an unknown option key (3991893), closes #1869
log: Remove the Git::Log Enumerable interface and Commit#set_commit (a2d2934), closes #1775
Raise the minimum supported git version to 2.43.0 (103a8da), closes #1140
remote: Remove Git::Remote and Git::Repository#config_remote (39ee9c5), closes #1724
Remove Git::CommandLineResult (cff038a), closes #1770
Remove Git::Object::Tag (d826a0a), closes #1726
Remove Git::Repository#lib (5778196), closes #1769
Remove Git::Repository#remotes, Git::Branch#stashes, and allow_unknown_type (b3353d3), closes #1725
Remove Git.binary_version and the Git.ls_remote(nil) shim (a31e9db), closes #1773
Remove the eight renamed facade aliases (0fb37d7), closes #1924
Remove the five renamed facade methods (bde6f52), closes #1772
Remove the Git::Base compatibility shim (70d3e27), closes #1768
Remove the Git.clone legacy options (:path, :recursive, :remote) (bde02ee), closes #1774
Remove the v4.x-style configuration API (b5dd9ba), closes #1771
repository: Deprecate Git::Repository#set_index and #set_working (7f7511d), closes #1833
repository: Remove the seven renamed Git::Repository methods (ae1fecf), closes #1777
repository: Remove the v4.x option shims from clean, diff_path_status, commit, and set_* (65fed59), closes #1776
repository: Require a block parameter on the with_* context helpers (6f7776e)
stash: Remove the legacy stash API and return StashInfo from stash_list (f73c0bc), closes #1634
status: Remove Git::Status and Git::Status::StatusFile (51cb33f), closes #1727
worktree: Remove the legacy worktree API and return WorktreeInfo from worktree_add (a7a87b7), closes #1635

Bug Fixes

commands: Close the stdin pipe's write end when the writer thread cannot start (8667db2), closes #1860
commands: Raise Git::Error when the stdin writer thread cannot be started (a61eafc), closes #1860
commands: Raise Git::Error when with_stdin cannot create a pipe (e5d0c04), closes #1811
Declare logger as a runtime dependency (d38b4c1)
deprecation: Load what the log, notify, and report behaviors need (5cb1db3)
Detect a missing lychee without a shell probe (f3bf20f)
encoding: Scrub lines whose detected encoding has no Ruby converter (517cd99), closes #1810
errors: Make the Git::GitExecuteError warning follow the deprecation policy (e16a405), closes #1908
errors: Raise Git::Error instead of a bare SystemCallError from filesystem calls (c6aa107), closes #1804
export: Drop the redundant checkout that broke Git.export for tags (5b444b4), closes #1815
export: Say what the destination holds when removing .git fails (510713d)
factories: Make ~ mean the home directory in every factory path (b03cfcc), closes #1873
path_resolver: Expand relative :repository and :index against the process cwd (5196d8e), closes #1871
repository: Raise Git::Error when archive gzip compression fails (f21c895), closes #1812
stash: Raise UnexpectedResultError when stash_store cannot find the stored entry (64486c7), closes #1855
tag: Raise UnexpectedResultError when tag_create cannot find the new tag (de6c8d8), closes #1849

Other Changes

branch: Follow up on the review of the branch and remote removal (7aa2f18), closes #1851
Clarify v5.x option validation scope (0d15421)
commands: Drop version gates below the 2.43.0 floor (bd97b2f)
Comment the hooks that mutate ENV and the working directory (ea4c197)
deprecation: Retire the version horizon as a source of warning text (137e5b7), closes #1908
Describe the with_* helpers in ADR-0009 as yielding a derived repository (f99194c), closes #1830
export: Cover the state Git.export leaves when removing .git fails (8fe1fdd)
export: Describe what a failed .git removal leaves behind (7995d83)
fsck: Correct command integration spec (e550f72)
Make test:gem load the gem from an isolated install (4709a13), closes #1882
Name Git::CommandLine::Result in spec descriptions (406b396)
Name the 5.x maintenance branch alongside 4.x (f264747)
Name the removal horizon in every @deprecated YARD tag (9cfd7cf), closes #1917
Name the restore checkout in the failure-state notes (bec03f8)
path_resolver: Remove the unreachable git-binary-not-found rescue (3623f59)
Raise required_ruby_version to 3.3 and drop the Ruby 3.3 gates on yard-lint (a551fb4), closes #1722
readme: Announce the 5.x branch and the v6.0.0 line on main (4510e7d)
readme: Announce the deletion of the v1 and master branches (6c8251f), closes #1786
readme: Derive the JRuby and TruffleRuby floors from the MRI floor (16558cf)
readme: Replace the v5.0.0 release banner with a v6.0.0 development note (6bb4e80)
readme: Replace the v6.0.0 development note with the release banner (adf27e7)
readme: State that deprecation warnings fire on every call (f1426f4), closes #1909
Record ADR-0008 on converting errors from outside the gem at the boundary (64344da)
Record ADR-0009 on what a failed operation leaves behind (1cedde3)
Reject BREAKING CHANGE footers that release-please would truncate (84ca7ba)
Release v6.0.0 as the next version from main (dbee8b9)
Remove git version skips at or below 2.43.0 (61a87b1)
Remove the diff fixture's submodule setup, which always failed (8240b30)
Replace Ruby 3.2 with 3.3 in the CI and cache-warming matrices (6970c25)
Replace the release-as config pin with a Release-As commit footer (ebb7605)
repository: State the failure state of in_branch and merge_into in a note tag (a4a5059)
repository: Yield a derived repository from the with_* context helpers (56e7a35), closes #1830
Require addressable 2.9 or later (e790d13), closes #1221
Restructure the diff fixture so it needs no rubocop disables (85158af)
Review the prose in README.md and UPGRADING.md (be7f48c)
Rework ADR-0009 after review and link it from the facade skills (44c41f5)
skills: Add an rspec-integration-testing-standards override (bb97e0a), closes #1874
skills: Add the README banner swaps to the release checklists (54ed695)
skills: Add the sections every skill is required to have (8a0c878)
skills: Add the testing-guide override skill (54818b7)
skills: Check the failure-state note before flagging a missing restore (b18e1f1)
skills: Make rspec-unit-testing-standards a thin override of the plugin skill (aa41348)
skills: Make tdd-refactor-step a thin override of the plugin skill (8977ac8)
skills: Make test-debugging a thin override of the plugin skill (8323c10)
skills: Prefer not touching global state over restoring it (784d4d4)
skills: Record the Git::CommandLineResult removal in the skill references (070c73b)
skills: Record the Git::Object::Tag removal in the skill references (6503b7a)
skills: Record the Release-As pin and two-PR shape of a maintenance branch cut (4db3834)
skills: Update the tag example in the facade-implementation guardrail (3a9f1a0)
State the Ruby 3.3 floor in UPGRADING.md, CONTRIBUTING.md, and the agent skills (00ecc30)
State what a failure leaves behind for the operations ADR-0009 covers (a136d72), closes #1831
upgrading: Name the v5.x APIs that validate option names (acbe015)
upgrading: Name the v6 section by series (d3ad986)
upgrading: Organize the v6.x section around what the reader has to do (1f6eace)

5.4.1 (2026-09-04)

Other Changes

Document the Git.clone option renames in UPGRADING.md (0f8e5d8), closes #1763
upgrading: Document the Git::Log Enumerable and Commit#set_commit deprecations (1d1c9bc), closes #1764
upgrading: Document the Git::Repository method renames (e1bb6e6), closes #1765
upgrading: Document the Git::Repository option renames (0a2dfcb), closes #1766
upgrading: Document the module-level Git deprecations (cd3a2ae), closes #1762
upgrading: Remove two misplaced rows from the configuration methods table (61ad4c8), closes #1761

5.4.0 (2026-09-04)

Features

stash: Add the StashInfo facade surface and deprecate the legacy stash API (3cc4c6b), closes #1730
status: Add Git::StatusInfo and Git::StatusFileInfo and deprecate Git::Status (b0a376b), closes #1720
tag: Add tag_list and tag_create and deprecate the Git::Object::Tag returns (6f9c55c), closes #1719
worktree: Add WorktreeInfo, cover every subcommand, and deprecate the legacy API (581d6ad), closes #1731

Other Changes

release: Move the workflow description into comments (a5d90bd), closes #1734
tag: Add failing specs for TagInfo facade methods and Object::Tag deprecation (749c327), closes #1719

5.3.0 (2026-09-03)

Features

author: Add immutable Git::AuthorInfo and deprecate Git::Author (c08b04b), closes #1721
branch: Deprecate Git::Branch and Git::Branches in favor of Git::Repository#branch_list (1581aa0), closes #1639
branch: Deprecate Git::Branch#stashes in favor of Git::Repository#stashes_all (dcee889), closes #1637
cat-file: Deprecate the allow_unknown_type option of Git::Commands::CatFile::Raw (95769ea), closes #1709
info: Nest Git::AuthorInfo in Git::TagInfo and Git::StashInfo (2f44f96), closes #1745
remote: Deprecate Git::Remote and Git::Repository#remote in favor of #remote_list (1abb585), closes #1643
remote: Freeze Git::RemoteInfo array-valued members (4d44a3d)
repository: Add in_branch and merge_into facade methods (59b58d0), closes #1641
repository: Deprecate Git::Repository#remotes in favor of #remote_list (410095c), closes #1640

Bug Fixes

branching: Verify refs/heads when classifying the HEAD state (bfc4d8a), closes #1641

Other Changes

adr: Supersede ADR-0006 with a release-based deprecation period (b3b32e3)
author: Add failing tests for Git::AuthorInfo and Git::Author deprecation (e0d3123), closes #1721
branch: Add failing test for the Git::Branch#stashes deprecation (a806808)
contributing: Describe the release line and maintenance branch rules (fd78c9c)
info: Add failing tests for nested Git::AuthorInfo on TagInfo and StashInfo (a7f5e69), closes #1745
readme: Add the deprecation and release support policies (50ac2e2)
remote: Add failing tests for the Git::Remote and Git::Repository#remote deprecations (36af404)
skills: State the deprecation policy and the major release checklists (a246cf8)
upgrading: Add the v6.0.0 upgrade procedure (4d7c58c)

5.2.0 (2026-08-30)

Features

checkout: Support the :orphan option in Repository#checkout (265a997)

Bug Fixes

Exclude the .claude/skills symlink and other dev files from the gem (ae4ef0e)
Remove the cat-file raw constraint that duplicated a git check (ea52fc7)

Other Changes

Add a markdown link checker (8000810)
Address suppressed copilot comments in the resolve-feedback skill (9677f33)
Announce the v5.x deprecations and the v6.0.0 roadmap (68380f2)
Archive the v5.x redesign documents (4bed4ce)
Configure the mattpocock engineering skills for this repo (ff03315)
Copyedit CONTRIBUTING.md for plain, direct language (7756ad1)
deps: Update process_executer to ~> 4.1 (7f01af4)
Fix broken relative links and heading anchors (0bf31b8)
Fold the remaining plan documents into issues and adrs (74944d9)
fsck: Build the second root commit through the public API (3a7f083)
Make command-class policy self-contained in the skills (8158d2a)
Name maintainer and contributors in the LICENSE copyright notice (ddb33c0)
Point agents at the adr directory before they change covered areas (ad8a20d)
Port the roadmap-tickets conventions into a project skill (74a4e69)
Record any durable decision as an adr, not only architectural ones (455a28c)
Record the option surface rule as adr 0004 (d37beed)
Record the removal gate as adr 0006 (b76d54e)
Record the v4.x call-shape rule as adr 0005 (3cd68cd)
Record the validation delegation rationale as adr 0003 (8c224f5)
Reduce the resolve-feedback skill to a pointer plus ruby-git deltas (4a4c361)
Remove ai writing tells from the readme (e9c782e)
Remove the iteratively-address-copilot-reviews prompt and its command (fdaed6f)
Rename the resolve-pr-feedback skill to address-pr-feedback (d5e8700)
Require executed proof for safety claims in breaking-change-analysis (859ed31)
Require verifiable, reviewer-provable task sequencing in development-workflow (d4a7191)
Satisfy the new Style/DirectiveScope cop (354057e)
State each policy definition once and link everywhere else (0023d54), closes #1710
Stop restating gemspec version constraints in the project-context skill (595a53c)

5.1.0 (2026-08-18)

Features

grep: Expose perl_regexp on the Git::Repository#grep facade (759436f)
log: Expose perl_regexp on the log path (df8ea33)

Other Changes

Add fiddle as a Windows development dependency (1847989)
Bound the locale job's apt step so a stalled mirror fails fast (3a5d83b)
Cover the perl_regexp escape hatch for non-ASCII regex matching (55e2ded)
Document the Git for Windows byte-matching regex limitation (9aaedbd)
Document the windows symlink privilege requirement (696dff3)
Express development dependency conditions as named predicates (acca20a)
Fix a broken section link in the pre-review checklist (719f595)
Make integration fixtures independent of git and platform settings (c2a1592)
Pin rubocop to lf line endings (7f40413)
Pin test repository config from a single source (6e227b7)
Scope the symlink rescue to the symlink call (c2bed8f)
Skip the symlink specs when the host cannot create symlinks (8e9b667)

5.0.5 (2026-08-09)

Bug Fixes

Detect Darwin under JRuby when pinning LC_ALL (89bf625), closes #1669
Pin LC_ALL to a locale that exists on the host platform (5a4e0d6), closes #1669

Other Changes

Correct two imprecise claims in the build-complete comment (c4391cd), closes #1675
Gate merges on a matrix-free job instead of the per-matrix checks (47f2d17), closes #1675
Remove vestigial matrix dimensions (3a89886), closes #1676
Run RuboCop and YARD once instead of on every matrix job (0726964)
Run the suite once with en_US.UTF-8 unavailable (6e012c5), closes #1669
Run the test suite under a non-English locale (c65d402), closes #1670
Skip the All Specs Passed gate on release PRs (6dfeee0), closes #1675
Warm bundler caches at default-branch scope on push to main (2821477), closes #1674

5.0.4 (2026-08-07)

Bug Fixes

Return the full ref path in the ls_remote :ref value (34b0b06), closes #1416

Other Changes

Pin the locale for the CommandLine::Capturing integration spec (6040867)

5.0.3 (2026-08-07)

Bug Fixes

Drop unsupported -- separator from remote remove/rename commands (8ec466f)
Remove unreachable case branch in Patch#apply_file_mode (896fc49)
Remove unreachable nil check in Git::Parsers::Grep.parse (74e919a)

Other Changes

Add Claude Code support alongside GitHub Copilot (37f7d6a)
Add unit spec for Git::EncodingUtils (5f0f10e)
Consolidate parallel and serial spec rake tasks (49616b1)
Cover :index option in Git::Factories#worktree_open_options_after_init (efeba22)
Cover #path when both src and dst are nil (3a1a05a)
Cover edge-case branches in Git::Parsers::Diff (38d8b3f)
Cover Errno::ESRCH timeout-race rescue in run_process_executer (899bf36)
Cover Git::Branch#merge (71c0ea3)
Cover Git::Branch#stashes (27ba130)
Cover Git::Diff#name_status (fa2ee98)
Cover Git::Factories#parse_clone_stderr unparseable-output branch (65aa9b9)
Cover Git::Parsers::CatFile.each_header without trailing separator (b7a9ed9)
Cover Git::Parsers::LsTree.parse with no tab-separated filename (98b9ebf)
Cover Git::Parsers::Remote.apply_pair unrecognized-variable branch (03b10f6)
Cover Git::Stashes#save (7bca04c)
Cover Git.const_missing fallback branch for unrelated constants (05c3c43)
Cover Git.export (4bd7f58)
Cover normalize_fetch_keys with a String option key (47fb7fe)
Disable coverage for spec:integration, add SPEC filtering, fix formatters (cb53d03)
Document the project test coverage policy (d378c1e)
Enforce 100% unit test coverage on pull requests (a446098)
Guard checkout-index nonexistent-path spec for git < 2.30.0 (cf212a9)
Guard worktree repair spec for git < 2.29.0 (c527fb1)
merge: Fix incorrect version-gated failure expectation in quit_spec (24c5ba4)
Read the gem version without loading lib/git/version.rb (45c4b14)
Require git 2.39.0 for maintenance register/unregister --config-file specs (5b1fd52)
Skip get-urlmatch scope spec on git < 2.42.0 (e1ede7a)
Upgrade simplecov and simplecov-rspec to ~> 1.0 (65e92b9)

5.0.2 (2026-08-02)

Bug Fixes

Add bin/build-git-versions and bin/test-git-versions scripts (3314503)

Other Changes

Align CONTRIBUTING.md with current architecture and testing conventions (60ac8e9)
Allow disabling SimpleCov via COVERAGE=false env var (3788418)
Allow disabling SimpleCov via COVERAGE=false env var (3788418)
Avoid git-version-dependent all-zero SHA in stash store integration spec (82a15e5)
Make 5.0.0 release more prominent in README (2c8c42d)
Move Git::Repository::Factories and PathResolver to Git namespace (dd0ae7b)
Update README badges (079a121)

5.0.1 (2026-07-30)

Other Changes

Review and streamline AI agent instructions (536eb86)
Summarize v5.0.0 as architectural redesign in CHANGELOG (712c93e)

5.0.0 (2026-07-28)

v5.0.0 is a complete architectural redesign of the git gem. The monolithic Git::Base and Git::Lib classes have been replaced by a layered design: Git::Commands::* for git command execution, Git::Repository as the public API surface, and dedicated parser classes. Most v4.x code requires no changes — compatibility shims emit deprecation warnings pointing to the v5.x equivalents.

For a full migration guide, including deprecated method renames and code examples, see UPGRADING.md.

⚠ BREAKING CHANGES

Git::Base class removed; constant remains as a deprecated shim. Git::Base.new raises an error and require 'git/base' raises LoadError. The Git::Base constant still exists as a deprecated module included in Git::Repository, so is_a?(Git::Base) checks and monkeypatches continue to work but emit deprecation warnings. Update explicit Git::Base class references to use Git::Repository; the shim is removed in v6.0.0.
Git::Lib removed. Calling #lib on a repository object returns self with a deprecation warning (forwarding to Git::Repository methods where possible), but Git::Lib itself no longer exists. Methods unique to Git::Lib with no Git::Repository counterpart raise NoMethodError.
Git.open, Git.bare, Git.clone, and Git.init return Git::Repository instead of Git::Base. For most callers this is transparent. Code that explicitly checks is_a?(Git::Base) must be updated to is_a?(Git::Repository).
Unsupported options now raise ArgumentError. Unknown keyword options that were silently ignored in v4.x may now raise ArgumentError. Check option names against the documented API when upgrading.
Git::Log#object is not a path limiter. Use Git::Log#path to filter log results by file path.
Git::CommandLineResult is deprecated (removed in v6.0.0). Use Git::CommandLine::Result instead.

For the full list of commits included in this release, see the v5.0.0 commit history.

4.1.2 (2026-01-10)

Other Changes

Add Continuity section to Governance (a2f644c)
Add Roberto Decurnex to Maintainers Emeritus (5104537)
Enable releases from 4.x maintenance branch (5377de6)
Move inactive maintainers to Emeritus per governance policy (f09e4d1)

4.1.1 (2026-01-09)

Other Changes

Add AI Policy and update documentation (8616cdf)
Add code of conduct links (0769c8e)
Add governance policy and update project policies (8d8263c)
Add Quick Start section and reorganize README for new users (1811a75)
Clarify JRuby on Windows support policy (c37b3d6)

4.1.0 (2026-01-02)

Features

Add per-instance git_ssh configuration support (26c1199)
clone: Add single_branch option (a6929bb)
diff: Allow multiple paths in diff path limiter (c663b62)
remote: Add remote set-branches helper (a7dab2b)

Bug Fixes

Prevent GIT_INDEX_FILE from corrupting worktree indexes (27c0f16)
test: Use larger timeout values on JRuby to prevent flaky tests (aa8fd8b)

Other Changes

Add git version support policy (fbb0c60)
clone: Simplify single_branch validator (3900233)
Expand AI instructions with comprehensive workflows (04907ed)
Make env_overrides more flexible and idiomatic (dc0b43b)

4.0.7 (2025-12-29)

Other Changes

Add GitHub Copilot instructions (edf10ec)
Add redesign index page (3fdf9e2)
Add Ruby 4.0 to continuous integration test matrix (be3cb89)
Address PR review feedback (c82a3b4)

4.0.6 (2025-11-11)

Bug Fixes

Standardize deprecation handling and consolidate tests (fixes #842) (a731110)

Other Changes

Refactor Rakefile by splitting tasks into separate files (bd69f9b)
Remove redundant escape in BRANCH_LINE_REGEXP (Style/RedundantRegexpEscape) (4a03b5c)

4.0.5 (2025-08-20)

Bug Fixes

Properly parse UTF-8(multibyte) file paths in git output (8e6a11e)

Other Changes

Document and announce the proposed architectural redesign (e27255a)
Minor change to the architecture redesign document (b4634b5)
Rearrange README so that Summary is at the top (3d2c473)
Update ClassLength max in .rubocop_todo.yml for CI passing (4430478)

4.0.4 (2025-07-09)

Bug Fixes

Remove deprecation from Git::Path (ab1e207)
Remove deprecation from Git::Stash (9da1e91)

Other Changes

Add tests for Git::Base#set_index including deprecation (e6ccb11)
Add tests for Git::Base#set_working including deprecation (ee11137)
Add tests to verify Git::Object.new creates the right type of object (ab17621)
Verify deprecated Git::Log methods emit a deprecation warning (abb0efb)

4.0.3 (2025-07-08)

Bug Fixes

Correct the deprecation horizon for Git deprecations (b7b7f38)
Fix Rubocop Layout/EmptyLinesAroundClassBody offense (1de27da)
Internally create a Stash with non-deprecated initializer args (8b9b9e2)
Report correct line number in deprecation warnings (cca0deb)
Un-deprecate Git::Diff methods (761b6ff)

Other Changes

Make tests that emit a deprecation warning fail (7e211d7)
Update all tests to not use deprecated features (33ab0e2)

4.0.2 (2025-07-08)

Bug Fixes

Call Git::Index#new correctly from initialize_components (07dfab5)

Other Changes

Announce that the project has adopted RuboCop (3d6cac9)
Update comment to be accurate (3a87722)

4.0.1 (2025-07-06)

Bug Fixes

Fix Rubocop Layout/LineLength offense (52d80ac)
Fix Rubocop Lint/EmptyBlock offense (9081f0f)
Fix Rubocop Lint/MissingSuper offense (e9e91a8)
Fix Rubocop Lint/StructNewOverride offense (141c2cf)
Fix Rubocop Lint/SuppressedException offense (4372a20)
Fix Rubocop Lint/UselessConstantScoping offense (54c4a3b)
Fix Rubocop Metrics/AbcSize offense (256d860)
Fix Rubocop Metrics/BlockLength offense (9c856ba)
Fix Rubocop Metrics/ClassLength offense (exclude tests) (d70c800)
Fix Rubocop Metrics/ClassLength offense (refactor Git::Log) (1aae57a)
Fix Rubocop Metrics/ClassLength offense (refactor Git::Status) (e3a378b)
Fix Rubocop Metrics/CyclomaticComplexity offense (abfcf94)
Fix Rubocop Metrics/MethodLength offense (e708c36)
Fix Rubocop Metrics/ParameterLists offense (c7946b0)
Fix Rubocop Metrics/PerceivedComplexity offense (5dd5e0c)
Fix Rubocop Naming/AccessorMethodName offense (e9d9c4f)
Fix Rubocop Naming/HeredocDelimiterNaming offense (b4297a5)
Fix Rubocop Naming/PredicateMethod offense (d33f7a8)
Fix Rubocop Naming/PredicatePrefix offense (57edc79)
Fix Rubocop Naming/VariableNumber offense (3fba6fa)
Fix Rubocop Style/ClassVars offense (a2f651a)
Fix Rubocop Style/Documentation offense (e80c27d)
Fix Rubocop Style/IfUnlessModifier offense (c974832)
Fix Rubocop Style/MultilineBlockChain offense (dd4e4ec)
Fix Rubocop Style/OptionalBooleanParameter offense (c010a86)
Fix typo in status.rb (284fae7)
Remove duplicate methods found by rubocop (bd691c5)
Result of running rake rubocop:autocorrect (8f1e3bb)
Result of running rake rubocop:autocorrect_all (5c75783)

Other Changes

Add rubocop todo file to silence known offenses until they can be fixed (2c36f8c)
Avoid deprecated dsa for tests keys (1da8c28)
Fix yarddoc error caused by rubocop autocorrect (58c4af3)
Integrate Rubocop with the project (a04297d)
Rename Gem::Specification variable from s to spec (4d976c4)

4.0.0 (2025-07-02)

⚠ BREAKING CHANGES

Users will need to be on Ruby 3.2 or greater

Features

Add Log#execute to run the log and return an immutable result (ded54c4)
diff: Refactor Git::Diff to separate concerns and improve AP (e22eb10)
Upgrade minimally supported Ruby to 3.2 (fb93ef1)

Other Changes

Remove unneeded explicit return statements (28e07ae)
Upgrade to ProcessExecuter 4.x (5b00d3b)

3.1.1 (2025-07-02)

Bug Fixes

Raise a Git::FailedError if depth < 0 is passed to Git.clone (803253e), closes #805

Other Changes

Announce default branch change in README (e04f08e)
Update the project's default branch from 'master' to 'main' (a5aa75f)

3.1.0 (2025-05-18)

Features

Make Git::Log support the git log --merges option (df3b07d)

Other Changes

Announce and document guidelines for using Conventional Commits (a832259)
Skip continuous integration workflow for release PRs (f647a18)
Skip the experiemental build workflow if a release commit is pushed to master (3dab0b3)

3.0.2 (2025-05-15)

Bug Fixes

Trigger the release workflow on a change to 'master' insetad of 'main' (c8611f1)

Other Changes

Automate continuous delivery workflow (06480e6)
Enforce conventional commit messages with a GitHub action (1da4c44)
Enforce conventional commit messages with husky and commitlint (7ebe0f8)

FilesExpand file tree

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

Change Log

6.0.0 (2026-10-28)

⚠ BREAKING CHANGES

Features

Bug Fixes

Other Changes

5.4.1 (2026-09-04)

Other Changes

5.4.0 (2026-09-04)

Features

Other Changes

5.3.0 (2026-09-03)

Features

Bug Fixes

Other Changes

5.2.0 (2026-08-30)

Features

Bug Fixes

Other Changes

5.1.0 (2026-08-18)

Features

Other Changes

5.0.5 (2026-08-09)

Bug Fixes

Other Changes

5.0.4 (2026-08-07)

Bug Fixes

Other Changes

5.0.3 (2026-08-07)

Bug Fixes

Other Changes

5.0.2 (2026-08-02)

Bug Fixes

Other Changes

5.0.1 (2026-07-30)

Other Changes

5.0.0 (2026-07-28)

⚠ BREAKING CHANGES

4.1.2 (2026-01-10)

Other Changes

4.1.1 (2026-01-09)

Other Changes

4.1.0 (2026-01-02)

Features

Bug Fixes

Other Changes

4.0.7 (2025-12-29)

Other Changes

4.0.6 (2025-11-11)

Bug Fixes

Other Changes

4.0.5 (2025-08-20)

Bug Fixes

Other Changes

4.0.4 (2025-07-09)

Bug Fixes

Other Changes

4.0.3 (2025-07-08)

Bug Fixes

Other Changes

4.0.2 (2025-07-08)

Bug Fixes

Other Changes

4.0.1 (2025-07-06)

Bug Fixes

Other Changes

4.0.0 (2025-07-02)

⚠ BREAKING CHANGES

Features

Other Changes

3.1.1 (2025-07-02)

Bug Fixes

Other Changes

3.1.0 (2025-05-18)