git 4.4.6 → 6.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (275) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +1 -0
  3. data/CHANGELOG.md +348 -39
  4. data/CONTRIBUTING.md +1014 -144
  5. data/README.md +386 -504
  6. data/UPGRADING.md +1822 -0
  7. data/git.gemspec +102 -22
  8. data/lib/git/author_info.rb +65 -0
  9. data/lib/git/branch_delete_failure.rb +34 -0
  10. data/lib/git/branch_delete_result.rb +66 -0
  11. data/lib/git/branch_info.rb +237 -0
  12. data/lib/git/command_line/base.rb +247 -0
  13. data/lib/git/command_line/capturing.rb +308 -0
  14. data/lib/git/command_line/result.rb +88 -0
  15. data/lib/git/command_line/streaming.rb +236 -0
  16. data/lib/git/command_line.rb +45 -323
  17. data/lib/git/commands/add.rb +139 -0
  18. data/lib/git/commands/am/abort.rb +43 -0
  19. data/lib/git/commands/am/apply.rb +263 -0
  20. data/lib/git/commands/am/continue.rb +43 -0
  21. data/lib/git/commands/am/quit.rb +43 -0
  22. data/lib/git/commands/am/retry.rb +49 -0
  23. data/lib/git/commands/am/show_current_patch.rb +64 -0
  24. data/lib/git/commands/am/skip.rb +42 -0
  25. data/lib/git/commands/am.rb +33 -0
  26. data/lib/git/commands/apply.rb +242 -0
  27. data/lib/git/commands/archive/list_formats.rb +46 -0
  28. data/lib/git/commands/archive.rb +145 -0
  29. data/lib/git/commands/arguments.rb +4521 -0
  30. data/lib/git/commands/base.rb +522 -0
  31. data/lib/git/commands/branch/copy.rb +102 -0
  32. data/lib/git/commands/branch/create.rb +177 -0
  33. data/lib/git/commands/branch/delete.rb +88 -0
  34. data/lib/git/commands/branch/list.rb +178 -0
  35. data/lib/git/commands/branch/move.rb +102 -0
  36. data/lib/git/commands/branch/set_upstream.rb +86 -0
  37. data/lib/git/commands/branch/show_current.rb +49 -0
  38. data/lib/git/commands/branch/unset_upstream.rb +53 -0
  39. data/lib/git/commands/branch.rb +34 -0
  40. data/lib/git/commands/cat_file/batch.rb +385 -0
  41. data/lib/git/commands/cat_file/filtered.rb +105 -0
  42. data/lib/git/commands/cat_file/raw.rb +203 -0
  43. data/lib/git/commands/cat_file.rb +49 -0
  44. data/lib/git/commands/checkout/branch.rb +153 -0
  45. data/lib/git/commands/checkout/files.rb +116 -0
  46. data/lib/git/commands/checkout.rb +38 -0
  47. data/lib/git/commands/checkout_index.rb +106 -0
  48. data/lib/git/commands/clean.rb +102 -0
  49. data/lib/git/commands/clone.rb +241 -0
  50. data/lib/git/commands/commit.rb +273 -0
  51. data/lib/git/commands/commit_tree.rb +101 -0
  52. data/lib/git/commands/config_option_syntax/add.rb +86 -0
  53. data/lib/git/commands/config_option_syntax/get.rb +121 -0
  54. data/lib/git/commands/config_option_syntax/get_all.rb +118 -0
  55. data/lib/git/commands/config_option_syntax/get_color.rb +95 -0
  56. data/lib/git/commands/config_option_syntax/get_color_bool.rb +96 -0
  57. data/lib/git/commands/config_option_syntax/get_regexp.rb +119 -0
  58. data/lib/git/commands/config_option_syntax/get_urlmatch.rb +111 -0
  59. data/lib/git/commands/config_option_syntax/list.rb +111 -0
  60. data/lib/git/commands/config_option_syntax/remove_section.rb +79 -0
  61. data/lib/git/commands/config_option_syntax/rename_section.rb +83 -0
  62. data/lib/git/commands/config_option_syntax/replace_all.rb +109 -0
  63. data/lib/git/commands/config_option_syntax/set.rb +119 -0
  64. data/lib/git/commands/config_option_syntax/unset.rb +92 -0
  65. data/lib/git/commands/config_option_syntax/unset_all.rb +94 -0
  66. data/lib/git/commands/config_option_syntax.rb +56 -0
  67. data/lib/git/commands/describe.rb +156 -0
  68. data/lib/git/commands/diff.rb +657 -0
  69. data/lib/git/commands/diff_files.rb +519 -0
  70. data/lib/git/commands/diff_index.rb +499 -0
  71. data/lib/git/commands/fetch.rb +354 -0
  72. data/lib/git/commands/fsck.rb +138 -0
  73. data/lib/git/commands/gc.rb +134 -0
  74. data/lib/git/commands/grep.rb +339 -0
  75. data/lib/git/commands/init.rb +101 -0
  76. data/lib/git/commands/log.rb +634 -0
  77. data/lib/git/commands/ls_files.rb +195 -0
  78. data/lib/git/commands/ls_remote.rb +161 -0
  79. data/lib/git/commands/ls_tree.rb +135 -0
  80. data/lib/git/commands/maintenance/register.rb +73 -0
  81. data/lib/git/commands/maintenance/run.rb +105 -0
  82. data/lib/git/commands/maintenance/start.rb +67 -0
  83. data/lib/git/commands/maintenance/stop.rb +56 -0
  84. data/lib/git/commands/maintenance/unregister.rb +80 -0
  85. data/lib/git/commands/maintenance.rb +29 -0
  86. data/lib/git/commands/merge/abort.rb +44 -0
  87. data/lib/git/commands/merge/continue.rb +44 -0
  88. data/lib/git/commands/merge/quit.rb +46 -0
  89. data/lib/git/commands/merge/start.rb +250 -0
  90. data/lib/git/commands/merge.rb +28 -0
  91. data/lib/git/commands/merge_base.rb +91 -0
  92. data/lib/git/commands/mv.rb +82 -0
  93. data/lib/git/commands/name_rev.rb +119 -0
  94. data/lib/git/commands/pull.rb +382 -0
  95. data/lib/git/commands/push.rb +251 -0
  96. data/lib/git/commands/read_tree.rb +154 -0
  97. data/lib/git/commands/remote/add.rb +96 -0
  98. data/lib/git/commands/remote/get_url.rb +68 -0
  99. data/lib/git/commands/remote/list.rb +56 -0
  100. data/lib/git/commands/remote/prune.rb +63 -0
  101. data/lib/git/commands/remote/remove.rb +52 -0
  102. data/lib/git/commands/remote/rename.rb +76 -0
  103. data/lib/git/commands/remote/set_branches.rb +70 -0
  104. data/lib/git/commands/remote/set_head.rb +89 -0
  105. data/lib/git/commands/remote/set_url.rb +78 -0
  106. data/lib/git/commands/remote/set_url_add.rb +70 -0
  107. data/lib/git/commands/remote/set_url_delete.rb +71 -0
  108. data/lib/git/commands/remote/show.rb +77 -0
  109. data/lib/git/commands/remote/update.rb +79 -0
  110. data/lib/git/commands/remote.rb +42 -0
  111. data/lib/git/commands/repack.rb +281 -0
  112. data/lib/git/commands/reset.rb +154 -0
  113. data/lib/git/commands/rev_parse.rb +304 -0
  114. data/lib/git/commands/revert/abort.rb +45 -0
  115. data/lib/git/commands/revert/continue.rb +62 -0
  116. data/lib/git/commands/revert/quit.rb +47 -0
  117. data/lib/git/commands/revert/skip.rb +44 -0
  118. data/lib/git/commands/revert/start.rb +158 -0
  119. data/lib/git/commands/revert.rb +29 -0
  120. data/lib/git/commands/rm.rb +113 -0
  121. data/lib/git/commands/show.rb +632 -0
  122. data/lib/git/commands/show_ref/exclude_existing.rb +119 -0
  123. data/lib/git/commands/show_ref/exists.rb +75 -0
  124. data/lib/git/commands/show_ref/list.rb +149 -0
  125. data/lib/git/commands/show_ref/verify.rb +122 -0
  126. data/lib/git/commands/show_ref.rb +42 -0
  127. data/lib/git/commands/stash/apply.rb +81 -0
  128. data/lib/git/commands/stash/branch.rb +67 -0
  129. data/lib/git/commands/stash/clear.rb +43 -0
  130. data/lib/git/commands/stash/create.rb +60 -0
  131. data/lib/git/commands/stash/drop.rb +73 -0
  132. data/lib/git/commands/stash/list.rb +43 -0
  133. data/lib/git/commands/stash/pop.rb +87 -0
  134. data/lib/git/commands/stash/push.rb +112 -0
  135. data/lib/git/commands/stash/show.rb +158 -0
  136. data/lib/git/commands/stash/store.rb +72 -0
  137. data/lib/git/commands/stash.rb +38 -0
  138. data/lib/git/commands/status.rb +174 -0
  139. data/lib/git/commands/symbolic_ref/delete.rb +72 -0
  140. data/lib/git/commands/symbolic_ref/read.rb +99 -0
  141. data/lib/git/commands/symbolic_ref/update.rb +79 -0
  142. data/lib/git/commands/symbolic_ref.rb +38 -0
  143. data/lib/git/commands/tag/create.rb +142 -0
  144. data/lib/git/commands/tag/delete.rb +57 -0
  145. data/lib/git/commands/tag/list.rb +146 -0
  146. data/lib/git/commands/tag/verify.rb +71 -0
  147. data/lib/git/commands/tag.rb +26 -0
  148. data/lib/git/commands/update_ref/batch.rb +145 -0
  149. data/lib/git/commands/update_ref/delete.rb +90 -0
  150. data/lib/git/commands/update_ref/update.rb +103 -0
  151. data/lib/git/commands/update_ref.rb +42 -0
  152. data/lib/git/commands/version.rb +60 -0
  153. data/lib/git/commands/worktree/add.rb +139 -0
  154. data/lib/git/commands/worktree/list.rb +64 -0
  155. data/lib/git/commands/worktree/lock.rb +58 -0
  156. data/lib/git/commands/worktree/management_base.rb +51 -0
  157. data/lib/git/commands/worktree/move.rb +66 -0
  158. data/lib/git/commands/worktree/prune.rb +67 -0
  159. data/lib/git/commands/worktree/remove.rb +63 -0
  160. data/lib/git/commands/worktree/repair.rb +71 -0
  161. data/lib/git/commands/worktree/unlock.rb +47 -0
  162. data/lib/git/commands/worktree.rb +43 -0
  163. data/lib/git/commands/write_tree.rb +68 -0
  164. data/lib/git/commands.rb +88 -0
  165. data/lib/git/config.rb +64 -1
  166. data/lib/git/config_entry_info.rb +106 -0
  167. data/lib/git/configuring.rb +795 -0
  168. data/lib/git/detached_head_info.rb +57 -0
  169. data/lib/git/diff.rb +295 -12
  170. data/lib/git/diff_file_numstat_info.rb +31 -0
  171. data/lib/git/diff_file_patch_info.rb +136 -0
  172. data/lib/git/diff_file_raw_info.rb +129 -0
  173. data/lib/git/diff_info.rb +162 -0
  174. data/lib/git/diff_path_status.rb +80 -19
  175. data/lib/git/diff_result.rb +34 -0
  176. data/lib/git/diff_stats.rb +66 -14
  177. data/lib/git/dirstat_info.rb +102 -0
  178. data/lib/git/encoding_utils.rb +57 -1
  179. data/lib/git/errors.rb +107 -26
  180. data/lib/git/escaped_path.rb +55 -3
  181. data/lib/git/execution_context/global.rb +31 -0
  182. data/lib/git/execution_context/repository.rb +151 -0
  183. data/lib/git/execution_context.rb +559 -0
  184. data/lib/git/factories.rb +1049 -0
  185. data/lib/git/file_ref.rb +77 -0
  186. data/lib/git/fsck_object.rb +17 -9
  187. data/lib/git/fsck_result.rb +27 -16
  188. data/lib/git/log.rb +172 -65
  189. data/lib/git/object.rb +323 -108
  190. data/lib/git/parsers/branch.rb +240 -0
  191. data/lib/git/parsers/cat_file.rb +111 -0
  192. data/lib/git/parsers/config_entry.rb +110 -0
  193. data/lib/git/parsers/diff.rb +792 -0
  194. data/lib/git/parsers/fsck.rb +144 -0
  195. data/lib/git/parsers/grep.rb +42 -0
  196. data/lib/git/parsers/ls_remote.rb +79 -0
  197. data/lib/git/parsers/ls_tree.rb +58 -0
  198. data/lib/git/parsers/remote.rb +162 -0
  199. data/lib/git/parsers/stash.rb +292 -0
  200. data/lib/git/parsers/status.rb +251 -0
  201. data/lib/git/parsers/tag.rb +341 -0
  202. data/lib/git/parsers/worktree.rb +185 -0
  203. data/lib/git/path_resolver.rb +274 -0
  204. data/lib/git/remote_info.rb +203 -0
  205. data/lib/git/repository/branching.rb +796 -0
  206. data/lib/git/repository/committing.rb +221 -0
  207. data/lib/git/repository/context_helpers.rb +454 -0
  208. data/lib/git/repository/diffing.rb +743 -0
  209. data/lib/git/repository/inspecting.rb +252 -0
  210. data/lib/git/repository/logging.rb +410 -0
  211. data/lib/git/repository/maintenance.rb +65 -0
  212. data/lib/git/repository/merging.rb +429 -0
  213. data/lib/git/repository/object_operations.rb +1334 -0
  214. data/lib/git/repository/remote_operations.rb +772 -0
  215. data/lib/git/repository/shared_private.rb +120 -0
  216. data/lib/git/repository/staging.rb +409 -0
  217. data/lib/git/repository/stashing.rb +619 -0
  218. data/lib/git/repository/status_operations.rb +196 -0
  219. data/lib/git/repository/worktree_operations.rb +252 -0
  220. data/lib/git/repository.rb +204 -1
  221. data/lib/git/stash_info.rb +102 -0
  222. data/lib/git/status_file_info.rb +258 -0
  223. data/lib/git/status_info.rb +189 -0
  224. data/lib/git/system_call_guard.rb +95 -0
  225. data/lib/git/tag_delete_failure.rb +34 -0
  226. data/lib/git/tag_delete_result.rb +66 -0
  227. data/lib/git/tag_info.rb +99 -0
  228. data/lib/git/url.rb +12 -5
  229. data/lib/git/version.rb +111 -2
  230. data/lib/git/version_constraint.rb +85 -0
  231. data/lib/git/worktree_info.rb +128 -0
  232. data/lib/git.rb +319 -332
  233. metadata +318 -74
  234. data/.commitlintrc.yml +0 -38
  235. data/.github/copilot-instructions.md +0 -2733
  236. data/.github/issue_template.md +0 -15
  237. data/.github/pull_request_template.md +0 -17
  238. data/.github/workflows/continuous_integration.yml +0 -120
  239. data/.github/workflows/enforce_conventional_commits.yml +0 -29
  240. data/.github/workflows/experimental_continuous_integration.yml +0 -59
  241. data/.github/workflows/release.yml +0 -53
  242. data/.gitignore +0 -15
  243. data/.husky/commit-msg +0 -1
  244. data/.release-please-manifest.json +0 -3
  245. data/.rubocop.yml +0 -55
  246. data/.rubocop_todo.yml +0 -12
  247. data/Gemfile +0 -5
  248. data/Rakefile +0 -18
  249. data/lib/git/args_builder.rb +0 -111
  250. data/lib/git/author.rb +0 -16
  251. data/lib/git/base.rb +0 -1140
  252. data/lib/git/branch.rb +0 -423
  253. data/lib/git/branches.rb +0 -68
  254. data/lib/git/command_line_result.rb +0 -92
  255. data/lib/git/index.rb +0 -6
  256. data/lib/git/lib.rb +0 -2333
  257. data/lib/git/path.rb +0 -38
  258. data/lib/git/remote.rb +0 -39
  259. data/lib/git/stash.rb +0 -26
  260. data/lib/git/stashes.rb +0 -56
  261. data/lib/git/status.rb +0 -159
  262. data/lib/git/working_directory.rb +0 -6
  263. data/lib/git/worktree.rb +0 -39
  264. data/lib/git/worktrees.rb +0 -47
  265. data/package.json +0 -10
  266. data/redesign/1_architecture_existing.md +0 -66
  267. data/redesign/2_architecture_redesign.md +0 -130
  268. data/redesign/3_architecture_implementation.md +0 -138
  269. data/redesign/index.md +0 -34
  270. data/release-please-config.json +0 -36
  271. data/tasks/gem_tasks.rake +0 -10
  272. data/tasks/rubocop.rake +0 -12
  273. data/tasks/test.rake +0 -13
  274. data/tasks/test_gem.rake +0 -12
  275. data/tasks/yard.rake +0 -23
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 92cc763ef58f6b7edb58f8212de310dfd064d66572ccdabbdf24342b78c47401
4
- data.tar.gz: d3ae3f122e97723ad9ef1179314a155d3b3e3d22467c31f6fe7bef44e1fb9aaf
3
+ metadata.gz: 04c9988878153d94e7c7baa55e8cb8448481dce6e47e1d4543f939da6030f2d2
4
+ data.tar.gz: 825b4a86376dfc8edf269c96888378feab99a20267ffe79586c463a5ff3781cf
5
5
  SHA512:
6
- metadata.gz: 2eb8c6a72e815cae09980035295fb0fe5435f8406e4d4deb023ade5ee4e375cbafc286e262589546725a6b62e383def83c6e24a64e34573539bf7d21b621bbde
7
- data.tar.gz: 70e29c8086669ac54c92704f528d0e8220fcfe7a94596a4ff419bcf398a6ee7acb00fb7817f3e6d652940ade929e435e7ff438ce2ffc355b228b1e30a6e1b023
6
+ metadata.gz: 3c44791c9050523531380f79c32cced923090ec01fc6942979f914c898d35f35565a46ff1c54ca6b94ef6c6f0e42145296e268a5efb489bf198538c45ce9fbc9
7
+ data.tar.gz: 1ee7810b277015e405ec2832653af755f6f241d74cb67292b3cf4df6a25f9406755d60df48dc68665067982f6761a3553411e8a4ce2ac701bc0b9fd6c4b35658
data/.yardopts CHANGED
@@ -3,6 +3,7 @@
3
3
  --markup-provider=redcarpet
4
4
  --markup=markdown
5
5
  --fail-on-warning
6
+ --plugin yard_example_test
6
7
  -
7
8
  README.md
8
9
  CHANGELOG.md
data/CHANGELOG.md CHANGED
@@ -5,110 +5,419 @@
5
5
 
6
6
  # Change Log
7
7
 
8
- ## [4.4.6](https://github.com/ruby-git/ruby-git/compare/v4.4.5...v4.4.6) (2026-09-16)
8
+ ## [6.0.0](https://github.com/ruby-git/ruby-git/compare/v5.4.1...v6.0.0) (2026-10-28)
9
9
 
10
10
 
11
- ### Other Changes
11
+ ### ⚠ BREAKING CHANGES
12
+
13
+ * 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.
14
+ * **errors:** the minimum activesupport version is now 7.0.9 (was 5.0).
15
+ * **deprecation:** Git::Deprecation.deprecation_horizon is now "in a future major release" (was "6.0.0"). Code that parses it as a version raises.
16
+ * **factories:** raise ArgumentError when Git.init receives an unknown option key
17
+ * **factories:** raise ArgumentError when Git.open or Git.bare receives an unknown option key
18
+ * **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.
19
+ * **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.
20
+ * **repository:** Git::Repository#archive raises Git::Error instead of a Zlib::Error subclass when gzip compression fails; the Zlib::Error is available through cause.
21
+ * **stash:** Git::Repository#stash_store raises Git::UnexpectedResultError instead of returning nil when the stored commit is missing from the stash list.
22
+ * **tag:** Git::Repository#tag_create raises Git::UnexpectedResultError instead of returning nil when the tag it created is missing from the tag list.
23
+ * **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 Array<Git::RemoteInfo>, and the name-based remote operations; filter Git::Repository#config_list on the "remote.<name>." key prefix for entries Git::RemoteInfo does not model.
24
+ * **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 Array<Git::BranchInfo>, and the name-based branch operations.
25
+ * **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.
26
+ * **stash:** Git::Stash, Git::Stashes, Git::Repository#stashes_all, and Git::Repository#stash_save are removed. Git::Repository#stash_list returns Array<Git::StashInfo>, newest first, instead of a String; stash_infos remains as an alias.
27
+ * **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
28
+ * **author:** Git::Author is removed; referencing it raises NameError. Use
29
+ * 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.
30
+ * 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
31
+ * **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.
32
+ * **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.
33
+ * **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.
34
+ * **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.
35
+ * **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.
36
+ * **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.
37
+ * Git.clone no longer accepts :path, :recursive, or :remote and raises ArgumentError when given one. Use :chdir, :recurse_submodules, and :origin instead.
38
+ * 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 '.'.
39
+ * 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.
40
+ * Git::Repository#lib no longer exists. Call the facade method directly on the repository object.
41
+ * Git::CommandLineResult no longer exists. Use
42
+ * 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
43
+ * 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.
44
+ * 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.
45
+ * git 2.43.0 or later is required. Ubuntu 22.04 users must install a newer git or stay on v5.x.
46
+ * Ruby 3.3.0 or later is required. Applications on Ruby 3.2 must upgrade Ruby or stay on the latest v5.x release.
47
+
48
+ ### Features
49
+
50
+ * **author:** Remove Git::Author ([315eec2](https://github.com/ruby-git/ruby-git/commit/315eec2378066416756fdb5a8428c0480c8a9f41)), closes [#1728](https://github.com/ruby-git/ruby-git/issues/1728)
51
+ * **branch:** Remove Git::Branch and Git::Branches ([bbe3a83](https://github.com/ruby-git/ruby-git/commit/bbe3a833fc4b4aec8ea5b1c101b3effbf9bc8776)), closes [#1723](https://github.com/ruby-git/ruby-git/issues/1723) [#1631](https://github.com/ruby-git/ruby-git/issues/1631)
52
+ * **export:** Reject the :remote option to Git.export ([6d46862](https://github.com/ruby-git/ruby-git/commit/6d468624f5253b094a2aa0af545b6c77693fbe66)), closes [#1820](https://github.com/ruby-git/ruby-git/issues/1820)
53
+ * **factories:** Accept an :index option in Git.bare ([333d609](https://github.com/ruby-git/ruby-git/commit/333d6090bbd07cbd05a89e76ba5991327caeaf66)), closes [#1868](https://github.com/ruby-git/ruby-git/issues/1868)
54
+ * **factories:** Raise ArgumentError when Git.init receives an unknown option key ([0ffc8cd](https://github.com/ruby-git/ruby-git/commit/0ffc8cdd057a1466f76c3eb78af87a3cb9f60086)), closes [#1913](https://github.com/ruby-git/ruby-git/issues/1913) [#1869](https://github.com/ruby-git/ruby-git/issues/1869)
55
+ * **factories:** Raise ArgumentError when Git.open or Git.bare receives an unknown option key ([3991893](https://github.com/ruby-git/ruby-git/commit/39918933688eeeea2a00e5877adfac81cf809915)), closes [#1869](https://github.com/ruby-git/ruby-git/issues/1869)
56
+ * **log:** Remove the Git::Log Enumerable interface and Commit#set_commit ([a2d2934](https://github.com/ruby-git/ruby-git/commit/a2d29345b7dfb52a819f52eb1bfebba526806a02)), closes [#1775](https://github.com/ruby-git/ruby-git/issues/1775)
57
+ * Raise the minimum supported git version to 2.43.0 ([103a8da](https://github.com/ruby-git/ruby-git/commit/103a8da449c509ac801800a928b886f6efb5ffcf)), closes [#1140](https://github.com/ruby-git/ruby-git/issues/1140)
58
+ * **remote:** Remove Git::Remote and Git::Repository#config_remote ([39ee9c5](https://github.com/ruby-git/ruby-git/commit/39ee9c509927a7273fbaafc074dafe50d5f8e771)), closes [#1724](https://github.com/ruby-git/ruby-git/issues/1724)
59
+ * Remove Git::CommandLineResult ([cff038a](https://github.com/ruby-git/ruby-git/commit/cff038a17dbeb5d17dfdea9f6c0d7bb504141a8c)), closes [#1770](https://github.com/ruby-git/ruby-git/issues/1770)
60
+ * Remove Git::Object::Tag ([d826a0a](https://github.com/ruby-git/ruby-git/commit/d826a0a6fa2cbfc0759f186c564078052ca1d172)), closes [#1726](https://github.com/ruby-git/ruby-git/issues/1726)
61
+ * Remove Git::Repository#lib ([5778196](https://github.com/ruby-git/ruby-git/commit/5778196619ff05117c2a86e0366aa0375e05001e)), closes [#1769](https://github.com/ruby-git/ruby-git/issues/1769)
62
+ * Remove Git::Repository#remotes, Git::Branch#stashes, and allow_unknown_type ([b3353d3](https://github.com/ruby-git/ruby-git/commit/b3353d3d82928a02ba288a9efda17d4e70359ca1)), closes [#1725](https://github.com/ruby-git/ruby-git/issues/1725)
63
+ * Remove Git.binary_version and the Git.ls_remote(nil) shim ([a31e9db](https://github.com/ruby-git/ruby-git/commit/a31e9db2f9f27ee75f87ed4ead9672daab630b16)), closes [#1773](https://github.com/ruby-git/ruby-git/issues/1773)
64
+ * Remove the eight renamed facade aliases ([0fb37d7](https://github.com/ruby-git/ruby-git/commit/0fb37d71f13a1162aecaa909b3a233770fd1a22b)), closes [#1924](https://github.com/ruby-git/ruby-git/issues/1924)
65
+ * Remove the five renamed facade methods ([bde6f52](https://github.com/ruby-git/ruby-git/commit/bde6f52ab39d1704fdb35058b7072559ccdf91df)), closes [#1772](https://github.com/ruby-git/ruby-git/issues/1772)
66
+ * Remove the Git::Base compatibility shim ([70d3e27](https://github.com/ruby-git/ruby-git/commit/70d3e279bf26c34a6d24203b054c9418eeda3dbb)), closes [#1768](https://github.com/ruby-git/ruby-git/issues/1768)
67
+ * Remove the Git.clone legacy options (:path, :recursive, :remote) ([bde02ee](https://github.com/ruby-git/ruby-git/commit/bde02eee7cfc24a7a510d5a3fcb67fa9818b4cd6)), closes [#1774](https://github.com/ruby-git/ruby-git/issues/1774)
68
+ * Remove the v4.x-style configuration API ([b5dd9ba](https://github.com/ruby-git/ruby-git/commit/b5dd9ba7723d7cecd243ddeee2a65884a5612d94)), closes [#1771](https://github.com/ruby-git/ruby-git/issues/1771)
69
+ * **repository:** Deprecate Git::Repository#set_index and #set_working ([7f7511d](https://github.com/ruby-git/ruby-git/commit/7f7511d4470f0645669bb9b512b20fa885b27306)), closes [#1833](https://github.com/ruby-git/ruby-git/issues/1833)
70
+ * **repository:** Remove the seven renamed Git::Repository methods ([ae1fecf](https://github.com/ruby-git/ruby-git/commit/ae1fecf791d4962e2e354a3b30fd12ab9961108f)), closes [#1777](https://github.com/ruby-git/ruby-git/issues/1777)
71
+ * **repository:** Remove the v4.x option shims from clean, diff_path_status, commit, and set_* ([65fed59](https://github.com/ruby-git/ruby-git/commit/65fed59669e228d1480a3afe52768fba0bb4c756)), closes [#1776](https://github.com/ruby-git/ruby-git/issues/1776)
72
+ * **repository:** Require a block parameter on the with_* context helpers ([6f7776e](https://github.com/ruby-git/ruby-git/commit/6f7776e637fb84c8436e454cb561821a40c7d4cf))
73
+ * **stash:** Remove the legacy stash API and return StashInfo from stash_list ([f73c0bc](https://github.com/ruby-git/ruby-git/commit/f73c0bcab84dee56f13e8230a888c8da3552b380)), closes [#1634](https://github.com/ruby-git/ruby-git/issues/1634)
74
+ * **status:** Remove Git::Status and Git::Status::StatusFile ([51cb33f](https://github.com/ruby-git/ruby-git/commit/51cb33f9c511704952b0137ffe30d104eeeaa901)), closes [#1727](https://github.com/ruby-git/ruby-git/issues/1727)
75
+ * **worktree:** Remove the legacy worktree API and return WorktreeInfo from worktree_add ([a7a87b7](https://github.com/ruby-git/ruby-git/commit/a7a87b70d70be5f4d8086b76c4b470e6223a49bb)), closes [#1635](https://github.com/ruby-git/ruby-git/issues/1635)
12
76
 
13
- * **errors:** Document that filesystem and gzip errors can escape unconverted ([87d270f](https://github.com/ruby-git/ruby-git/commit/87d270f4f3a81c08c9727cc5106248d32b856c75)), closes [#1809](https://github.com/ruby-git/ruby-git/issues/1809)
14
77
 
15
- ## [4.4.5](https://github.com/ruby-git/ruby-git/compare/v4.4.4...v4.4.5) (2026-09-10)
78
+ ### Bug Fixes
79
+
80
+ * **commands:** Close the stdin pipe's write end when the writer thread cannot start ([8667db2](https://github.com/ruby-git/ruby-git/commit/8667db2f6a2fa16116264387fb78cd87fa8b763d)), closes [#1860](https://github.com/ruby-git/ruby-git/issues/1860)
81
+ * **commands:** Raise Git::Error when the stdin writer thread cannot be started ([a61eafc](https://github.com/ruby-git/ruby-git/commit/a61eafc54eaa72444b917fd890bc381716f7738b)), closes [#1860](https://github.com/ruby-git/ruby-git/issues/1860)
82
+ * **commands:** Raise Git::Error when with_stdin cannot create a pipe ([e5d0c04](https://github.com/ruby-git/ruby-git/commit/e5d0c0477ddbe7dc2b7b8fa2070e92eaea63877f)), closes [#1811](https://github.com/ruby-git/ruby-git/issues/1811)
83
+ * Declare logger as a runtime dependency ([d38b4c1](https://github.com/ruby-git/ruby-git/commit/d38b4c1cab06a9c5809e9b93fe078e87c5d98116))
84
+ * **deprecation:** Load what the log, notify, and report behaviors need ([5cb1db3](https://github.com/ruby-git/ruby-git/commit/5cb1db3a6e6ccbf340f3928bbe129ffb2894e2d7))
85
+ * Detect a missing lychee without a shell probe ([f3bf20f](https://github.com/ruby-git/ruby-git/commit/f3bf20fb2e14cfebb8c47dca08e32224f8d90c74))
86
+ * **encoding:** Scrub lines whose detected encoding has no Ruby converter ([517cd99](https://github.com/ruby-git/ruby-git/commit/517cd99f4a7087c2fa04a775f4daf3ee6cb6af99)), closes [#1810](https://github.com/ruby-git/ruby-git/issues/1810)
87
+ * **errors:** Make the Git::GitExecuteError warning follow the deprecation policy ([e16a405](https://github.com/ruby-git/ruby-git/commit/e16a405ceb3942ddbbfefee939f9c307866163c8)), closes [#1908](https://github.com/ruby-git/ruby-git/issues/1908)
88
+ * **errors:** Raise Git::Error instead of a bare SystemCallError from filesystem calls ([c6aa107](https://github.com/ruby-git/ruby-git/commit/c6aa107af294483e7f53ee0cf3095f61364ee089)), closes [#1804](https://github.com/ruby-git/ruby-git/issues/1804)
89
+ * **export:** Drop the redundant checkout that broke Git.export for tags ([5b444b4](https://github.com/ruby-git/ruby-git/commit/5b444b44ddc3a648d2f543ba56cf3472108a8647)), closes [#1815](https://github.com/ruby-git/ruby-git/issues/1815)
90
+ * **export:** Say what the destination holds when removing .git fails ([510713d](https://github.com/ruby-git/ruby-git/commit/510713d5bccd7d76b38ab4d3a2fcade57baafbcb))
91
+ * **factories:** Make ~ mean the home directory in every factory path ([b03cfcc](https://github.com/ruby-git/ruby-git/commit/b03cfccddddae1b8d65b16c1cd77203b9a56fc5b)), closes [#1873](https://github.com/ruby-git/ruby-git/issues/1873)
92
+ * **path_resolver:** Expand relative :repository and :index against the process cwd ([5196d8e](https://github.com/ruby-git/ruby-git/commit/5196d8e28a369302bfe855f43694eff43b5343ea)), closes [#1871](https://github.com/ruby-git/ruby-git/issues/1871)
93
+ * **repository:** Raise Git::Error when archive gzip compression fails ([f21c895](https://github.com/ruby-git/ruby-git/commit/f21c8958fed66fdfce4c66253342872f4695483e)), closes [#1812](https://github.com/ruby-git/ruby-git/issues/1812)
94
+ * **stash:** Raise UnexpectedResultError when stash_store cannot find the stored entry ([64486c7](https://github.com/ruby-git/ruby-git/commit/64486c7fa86ad88add3f5aaea8f9f6d0792e4615)), closes [#1855](https://github.com/ruby-git/ruby-git/issues/1855)
95
+ * **tag:** Raise UnexpectedResultError when tag_create cannot find the new tag ([de6c8d8](https://github.com/ruby-git/ruby-git/commit/de6c8d8adbe204ef66f3f6a201c945e4ac47b24b)), closes [#1849](https://github.com/ruby-git/ruby-git/issues/1849)
16
96
 
17
97
 
18
98
  ### Other Changes
19
99
 
20
- * **export:** Describe what a failed .git removal leaves behind ([8a596f0](https://github.com/ruby-git/ruby-git/commit/8a596f00e032170ad6a48af2337dad71b7418069)), closes [#1823](https://github.com/ruby-git/ruby-git/issues/1823)
100
+ * **branch:** Follow up on the review of the branch and remote removal ([7aa2f18](https://github.com/ruby-git/ruby-git/commit/7aa2f18ed58be1f1e906c83a060c3bad13a62c93)), closes [#1851](https://github.com/ruby-git/ruby-git/issues/1851)
101
+ * Clarify v5.x option validation scope ([0d15421](https://github.com/ruby-git/ruby-git/commit/0d1542121003b92a70eb25b4f45ee985cbcd69db))
102
+ * **commands:** Drop version gates below the 2.43.0 floor ([bd97b2f](https://github.com/ruby-git/ruby-git/commit/bd97b2f3240546fbe0d07ab6f7f303b4246a4c83))
103
+ * Comment the hooks that mutate ENV and the working directory ([ea4c197](https://github.com/ruby-git/ruby-git/commit/ea4c1975e5f3385d6c3f8c8937ceefa19a3ceffd))
104
+ * **deprecation:** Retire the version horizon as a source of warning text ([137e5b7](https://github.com/ruby-git/ruby-git/commit/137e5b7312038815a08a4e0b59feb9ec23b05da1)), closes [#1908](https://github.com/ruby-git/ruby-git/issues/1908)
105
+ * Describe the with_* helpers in ADR-0009 as yielding a derived repository ([f99194c](https://github.com/ruby-git/ruby-git/commit/f99194cd64bf812a2bbb90363afac48121df818e)), closes [#1830](https://github.com/ruby-git/ruby-git/issues/1830)
106
+ * **export:** Cover the state Git.export leaves when removing .git fails ([8fe1fdd](https://github.com/ruby-git/ruby-git/commit/8fe1fdddb3e178d953534e43799cb2a59ee99c4e))
107
+ * **export:** Describe what a failed .git removal leaves behind ([7995d83](https://github.com/ruby-git/ruby-git/commit/7995d83197b9664d51904aaa6c9be6c8db33ca85))
108
+ * **fsck:** Correct command integration spec ([e550f72](https://github.com/ruby-git/ruby-git/commit/e550f727c5b6e36430b8851b112d701ddd9b1382))
109
+ * Make test:gem load the gem from an isolated install ([4709a13](https://github.com/ruby-git/ruby-git/commit/4709a1370a9282a35eea699f45cc9ebc3fa65d30)), closes [#1882](https://github.com/ruby-git/ruby-git/issues/1882)
110
+ * Name Git::CommandLine::Result in spec descriptions ([406b396](https://github.com/ruby-git/ruby-git/commit/406b396537d1b9e0e93ab931c80f7b349505c34c))
111
+ * Name the 5.x maintenance branch alongside 4.x ([f264747](https://github.com/ruby-git/ruby-git/commit/f2647470ac064fc1ac8c48e974fe3bd1faf0ae99))
112
+ * Name the removal horizon in every [@deprecated](https://github.com/deprecated) YARD tag ([9cfd7cf](https://github.com/ruby-git/ruby-git/commit/9cfd7cf5933146a73ecb8825b0875576f14ca64c)), closes [#1917](https://github.com/ruby-git/ruby-git/issues/1917)
113
+ * Name the restore checkout in the failure-state notes ([bec03f8](https://github.com/ruby-git/ruby-git/commit/bec03f8e9f7b3f6bdaf46d665f1f4f6586ab7f2b))
114
+ * **path_resolver:** Remove the unreachable git-binary-not-found rescue ([3623f59](https://github.com/ruby-git/ruby-git/commit/3623f5954b2b68b38cd41f37d8fc9af4d34f3cf2))
115
+ * Raise required_ruby_version to 3.3 and drop the Ruby 3.3 gates on yard-lint ([a551fb4](https://github.com/ruby-git/ruby-git/commit/a551fb4231bca57db4964f3527ae344d91208aa7)), closes [#1722](https://github.com/ruby-git/ruby-git/issues/1722)
116
+ * **readme:** Announce the 5.x branch and the v6.0.0 line on main ([4510e7d](https://github.com/ruby-git/ruby-git/commit/4510e7dabf1952447a6a66883a14c627158dcb59))
117
+ * **readme:** Announce the deletion of the v1 and master branches ([6c8251f](https://github.com/ruby-git/ruby-git/commit/6c8251f617481a143206cb9f513336e3b442701c)), closes [#1786](https://github.com/ruby-git/ruby-git/issues/1786)
118
+ * **readme:** Derive the JRuby and TruffleRuby floors from the MRI floor ([16558cf](https://github.com/ruby-git/ruby-git/commit/16558cfedd153796cc18c5ddd190c26d39ceb556))
119
+ * **readme:** Replace the v5.0.0 release banner with a v6.0.0 development note ([6bb4e80](https://github.com/ruby-git/ruby-git/commit/6bb4e80cf3d7df1531b3ed919e5274174238c1cf))
120
+ * **readme:** Replace the v6.0.0 development note with the release banner ([adf27e7](https://github.com/ruby-git/ruby-git/commit/adf27e720bc0db20ccbfc2f5c5ec6b6e9436afe9))
121
+ * **readme:** State that deprecation warnings fire on every call ([f1426f4](https://github.com/ruby-git/ruby-git/commit/f1426f408f1de2ec29056b8f17be287d19ceac9f)), closes [#1909](https://github.com/ruby-git/ruby-git/issues/1909)
122
+ * Record ADR-0008 on converting errors from outside the gem at the boundary ([64344da](https://github.com/ruby-git/ruby-git/commit/64344daa40f22d2b26cd87b7139b27a81a7a8a4b))
123
+ * Record ADR-0009 on what a failed operation leaves behind ([1cedde3](https://github.com/ruby-git/ruby-git/commit/1cedde35421505f88dc9a62b5ecffaf9e0708be8))
124
+ * Reject BREAKING CHANGE footers that release-please would truncate ([84ca7ba](https://github.com/ruby-git/ruby-git/commit/84ca7ba8d511827c70b943d7d776f7a103cb9c2b))
125
+ * Release v6.0.0 as the next version from main ([dbee8b9](https://github.com/ruby-git/ruby-git/commit/dbee8b9abfdb224893b6ca26e7531f53c241c448))
126
+ * Remove git version skips at or below 2.43.0 ([61a87b1](https://github.com/ruby-git/ruby-git/commit/61a87b1d5e43e65b7735b5abd983cdd46f783bb0))
127
+ * Remove the diff fixture's submodule setup, which always failed ([8240b30](https://github.com/ruby-git/ruby-git/commit/8240b30dd20490a921c17b033edfd53b4380c80b))
128
+ * Replace Ruby 3.2 with 3.3 in the CI and cache-warming matrices ([6970c25](https://github.com/ruby-git/ruby-git/commit/6970c2532c79f5189b7b1454fc2287f90468d172))
129
+ * Replace the release-as config pin with a Release-As commit footer ([ebb7605](https://github.com/ruby-git/ruby-git/commit/ebb7605183b766759ef078ea48e41881f48ef5fb))
130
+ * **repository:** State the failure state of in_branch and merge_into in a note tag ([a4a5059](https://github.com/ruby-git/ruby-git/commit/a4a5059de5183662811cd1203f2c69956937395f))
131
+ * **repository:** Yield a derived repository from the with_* context helpers ([56e7a35](https://github.com/ruby-git/ruby-git/commit/56e7a356219d1c9abca1f3acc0c10775458d2286)), closes [#1830](https://github.com/ruby-git/ruby-git/issues/1830)
132
+ * Require addressable 2.9 or later ([e790d13](https://github.com/ruby-git/ruby-git/commit/e790d13a0ebfc877c003c874178faa55bd295600)), closes [#1221](https://github.com/ruby-git/ruby-git/issues/1221)
133
+ * Restructure the diff fixture so it needs no rubocop disables ([85158af](https://github.com/ruby-git/ruby-git/commit/85158af4813fa58e656779f91995a6c734fe6ec4))
134
+ * Review the prose in README.md and UPGRADING.md ([be7f48c](https://github.com/ruby-git/ruby-git/commit/be7f48c2355a58c35c8ef957908ff9670cd21852))
135
+ * Rework ADR-0009 after review and link it from the facade skills ([44c41f5](https://github.com/ruby-git/ruby-git/commit/44c41f5a905bbed594f203a44049a724eb807154))
136
+ * **skills:** Add an rspec-integration-testing-standards override ([bb97e0a](https://github.com/ruby-git/ruby-git/commit/bb97e0a9ffe14615bb85ee819ee6446ac78f3da2)), closes [#1874](https://github.com/ruby-git/ruby-git/issues/1874)
137
+ * **skills:** Add the README banner swaps to the release checklists ([54ed695](https://github.com/ruby-git/ruby-git/commit/54ed695f714b496ba4926f58df3b24be2bcf999d))
138
+ * **skills:** Add the sections every skill is required to have ([8a0c878](https://github.com/ruby-git/ruby-git/commit/8a0c878c64c389f6bfd0c6cf9b685cb3cf2106a4))
139
+ * **skills:** Add the testing-guide override skill ([54818b7](https://github.com/ruby-git/ruby-git/commit/54818b76502871b30824a0eeffab93d266c5c223))
140
+ * **skills:** Check the failure-state note before flagging a missing restore ([b18e1f1](https://github.com/ruby-git/ruby-git/commit/b18e1f1c6aa29a7f506c59f7f8d3ab4aaf70685a))
141
+ * **skills:** Make rspec-unit-testing-standards a thin override of the plugin skill ([aa41348](https://github.com/ruby-git/ruby-git/commit/aa41348b7a399d2f919da3d9cd94d1070bff9f6b))
142
+ * **skills:** Make tdd-refactor-step a thin override of the plugin skill ([8977ac8](https://github.com/ruby-git/ruby-git/commit/8977ac8b004b4f3c6cefbcd65e7e0568b572770f))
143
+ * **skills:** Make test-debugging a thin override of the plugin skill ([8323c10](https://github.com/ruby-git/ruby-git/commit/8323c1095053b7a63921a6ce29eb014304a1cdc1))
144
+ * **skills:** Prefer not touching global state over restoring it ([784d4d4](https://github.com/ruby-git/ruby-git/commit/784d4d42cc13046f09c6844332d559c520f96017))
145
+ * **skills:** Record the Git::CommandLineResult removal in the skill references ([070c73b](https://github.com/ruby-git/ruby-git/commit/070c73b7ab85257a1e613498c81f965cb7a45d8f))
146
+ * **skills:** Record the Git::Object::Tag removal in the skill references ([6503b7a](https://github.com/ruby-git/ruby-git/commit/6503b7a84ec5e69aa99e49798c69e227b2230e71))
147
+ * **skills:** Record the Release-As pin and two-PR shape of a maintenance branch cut ([4db3834](https://github.com/ruby-git/ruby-git/commit/4db383464f3e6ea73d2d41ac6e89311208ac94d8))
148
+ * **skills:** Update the tag example in the facade-implementation guardrail ([3a9f1a0](https://github.com/ruby-git/ruby-git/commit/3a9f1a028162f46a3c742a313286f46031b3a851))
149
+ * State the Ruby 3.3 floor in UPGRADING.md, CONTRIBUTING.md, and the agent skills ([00ecc30](https://github.com/ruby-git/ruby-git/commit/00ecc30b6f5de576089db8c9e70154119ff08b05))
150
+ * State what a failure leaves behind for the operations ADR-0009 covers ([a136d72](https://github.com/ruby-git/ruby-git/commit/a136d72aa8ab03a42c1504bd5ca8418fca28361d)), closes [#1831](https://github.com/ruby-git/ruby-git/issues/1831)
151
+ * **upgrading:** Name the v5.x APIs that validate option names ([acbe015](https://github.com/ruby-git/ruby-git/commit/acbe01537839c8de1b50ec0c9d8ae5b1db2422f2))
152
+ * **upgrading:** Name the v6 section by series ([d3ad986](https://github.com/ruby-git/ruby-git/commit/d3ad986e731159bdcef8e2342a52d0a7871fe5d0))
153
+ * **upgrading:** Organize the v6.x section around what the reader has to do ([1f6eace](https://github.com/ruby-git/ruby-git/commit/1f6eace1b21a926b2eb0a34029ac21d1c573550d))
154
+
155
+ ## [5.4.1](https://github.com/ruby-git/ruby-git/compare/v5.4.0...v5.4.1) (2026-09-04)
156
+
21
157
 
22
- ## [4.4.4](https://github.com/ruby-git/ruby-git/compare/v4.4.3...v4.4.4) (2026-09-10)
158
+ ### Other Changes
23
159
 
160
+ * Document the Git.clone option renames in UPGRADING.md ([0f8e5d8](https://github.com/ruby-git/ruby-git/commit/0f8e5d85eda89d2da802eebde5036c3f32b0f08e)), closes [#1763](https://github.com/ruby-git/ruby-git/issues/1763)
161
+ * **upgrading:** Document the Git::Log Enumerable and Commit#set_commit deprecations ([1d1c9bc](https://github.com/ruby-git/ruby-git/commit/1d1c9bcf33824ced13b13d61f7ce2f4cb1169e8d)), closes [#1764](https://github.com/ruby-git/ruby-git/issues/1764)
162
+ * **upgrading:** Document the Git::Repository method renames ([e1bb6e6](https://github.com/ruby-git/ruby-git/commit/e1bb6e6214340fed5b52acf0366488c860687f41)), closes [#1765](https://github.com/ruby-git/ruby-git/issues/1765)
163
+ * **upgrading:** Document the Git::Repository option renames ([0a2dfcb](https://github.com/ruby-git/ruby-git/commit/0a2dfcba94d9b5a0e89bdeaa9ec32de3ddc6dc59)), closes [#1766](https://github.com/ruby-git/ruby-git/issues/1766)
164
+ * **upgrading:** Document the module-level Git deprecations ([cd3a2ae](https://github.com/ruby-git/ruby-git/commit/cd3a2ae81af6f90bf9e65b3ac21bce722efd84fc)), closes [#1762](https://github.com/ruby-git/ruby-git/issues/1762)
165
+ * **upgrading:** Remove two misplaced rows from the configuration methods table ([61ad4c8](https://github.com/ruby-git/ruby-git/commit/61ad4c85763b1695618378b27d5f51e28bd0369d)), closes [#1761](https://github.com/ruby-git/ruby-git/issues/1761)
166
+
167
+ ## [5.4.0](https://github.com/ruby-git/ruby-git/compare/v5.3.0...v5.4.0) (2026-09-04)
24
168
 
25
- ### Bug Fixes
26
169
 
27
- * **export:** Drop the redundant checkout that broke Git.export for tags ([59bfe62](https://github.com/ruby-git/ruby-git/commit/59bfe62ac739030319cdfb83d601dd77e958205b)), closes [#1815](https://github.com/ruby-git/ruby-git/issues/1815)
170
+ ### Features
28
171
 
29
- ## [4.4.3](https://github.com/ruby-git/ruby-git/compare/v4.4.2...v4.4.3) (2026-08-30)
172
+ * **stash:** Add the StashInfo facade surface and deprecate the legacy stash API ([3cc4c6b](https://github.com/ruby-git/ruby-git/commit/3cc4c6bdc58203eedf7f3207f8b915e52ebc6eee)), closes [#1730](https://github.com/ruby-git/ruby-git/issues/1730)
173
+ * **status:** Add Git::StatusInfo and Git::StatusFileInfo and deprecate Git::Status ([b0a376b](https://github.com/ruby-git/ruby-git/commit/b0a376b19fb3ac100a11b8fa5f07b0700a6f4ce6)), closes [#1720](https://github.com/ruby-git/ruby-git/issues/1720)
174
+ * **tag:** Add tag_list and tag_create and deprecate the Git::Object::Tag returns ([6f9c55c](https://github.com/ruby-git/ruby-git/commit/6f9c55c7d2e845c7ec595b9db5ad8117b28e90f8)), closes [#1719](https://github.com/ruby-git/ruby-git/issues/1719)
175
+ * **worktree:** Add WorktreeInfo, cover every subcommand, and deprecate the legacy API ([581d6ad](https://github.com/ruby-git/ruby-git/commit/581d6ad908fb746a3b5e1726157da3d33a04bae4)), closes [#1731](https://github.com/ruby-git/ruby-git/issues/1731)
30
176
 
31
177
 
32
178
  ### Other Changes
33
179
 
34
- * **deps:** Update process_executer to ~&gt; 4.1 ([6f41964](https://github.com/ruby-git/ruby-git/commit/6f41964e400c7fa5a79ef9ec848144aaf56e8d06))
35
- * Fix rubocop offenses on the 4.x branch ([0361cf5](https://github.com/ruby-git/ruby-git/commit/0361cf521895fb722cd3e1fdb42006ce6d0a6d3c))
36
- * Ignore the git-versions directory ([2cc1bf5](https://github.com/ruby-git/ruby-git/commit/2cc1bf5f2cca6854d647634d2fef58e681fd90e3))
37
- * Name maintainer and contributors in the LICENSE copyright notice ([9d0ac3c](https://github.com/ruby-git/ruby-git/commit/9d0ac3ca56c49e1d78deb6e869aaddcb30362cb6))
38
- * Skip the rubocop rake task on JRuby and TruffleRuby ([da527c2](https://github.com/ruby-git/ruby-git/commit/da527c2314d5a81441b2590609cdadce9d394e17))
180
+ * **release:** Move the workflow description into comments ([a5d90bd](https://github.com/ruby-git/ruby-git/commit/a5d90bdd7b9e07859007942eb07f9b153e9c9e0a)), closes [#1734](https://github.com/ruby-git/ruby-git/issues/1734)
181
+ * **tag:** Add failing specs for TagInfo facade methods and Object::Tag deprecation ([749c327](https://github.com/ruby-git/ruby-git/commit/749c327bf793fd8f4b06b7a2dd1740aa977e9b57)), closes [#1719](https://github.com/ruby-git/ruby-git/issues/1719)
182
+
183
+ ## [5.3.0](https://github.com/ruby-git/ruby-git/compare/v5.2.0...v5.3.0) (2026-09-03)
184
+
39
185
 
40
- ## [4.4.2](https://github.com/ruby-git/ruby-git/compare/v4.4.1...v4.4.2) (2026-08-19)
186
+ ### Features
187
+
188
+ * **author:** Add immutable Git::AuthorInfo and deprecate Git::Author ([c08b04b](https://github.com/ruby-git/ruby-git/commit/c08b04bf25142140c626fd16354355aae26b4fba)), closes [#1721](https://github.com/ruby-git/ruby-git/issues/1721)
189
+ * **branch:** Deprecate Git::Branch and Git::Branches in favor of Git::Repository#branch_list ([1581aa0](https://github.com/ruby-git/ruby-git/commit/1581aa00b3fc7984a2024b290b83f6f6f5e97838)), closes [#1639](https://github.com/ruby-git/ruby-git/issues/1639)
190
+ * **branch:** Deprecate Git::Branch#stashes in favor of Git::Repository#stashes_all ([dcee889](https://github.com/ruby-git/ruby-git/commit/dcee889a63bfd38cc3073577b55e2112721c5e33)), closes [#1637](https://github.com/ruby-git/ruby-git/issues/1637)
191
+ * **cat-file:** Deprecate the allow_unknown_type option of Git::Commands::CatFile::Raw ([95769ea](https://github.com/ruby-git/ruby-git/commit/95769ea683349c445a7a7ea7b839fc990d2d8c4b)), closes [#1709](https://github.com/ruby-git/ruby-git/issues/1709)
192
+ * **info:** Nest Git::AuthorInfo in Git::TagInfo and Git::StashInfo ([2f44f96](https://github.com/ruby-git/ruby-git/commit/2f44f9617122c3719625cf3a56f4b263b0de4c3c)), closes [#1745](https://github.com/ruby-git/ruby-git/issues/1745)
193
+ * **remote:** Deprecate Git::Remote and Git::Repository#remote in favor of #remote_list ([1abb585](https://github.com/ruby-git/ruby-git/commit/1abb585339c0d003622719aa5930b5bde2262502)), closes [#1643](https://github.com/ruby-git/ruby-git/issues/1643)
194
+ * **remote:** Freeze Git::RemoteInfo array-valued members ([4d44a3d](https://github.com/ruby-git/ruby-git/commit/4d44a3dc8fed77b39c7146675eaa9d46eb12e34d))
195
+ * **repository:** Add in_branch and merge_into facade methods ([59b58d0](https://github.com/ruby-git/ruby-git/commit/59b58d0389656051e8cd61bd856dc116139c2507)), closes [#1641](https://github.com/ruby-git/ruby-git/issues/1641)
196
+ * **repository:** Deprecate Git::Repository#remotes in favor of #remote_list ([410095c](https://github.com/ruby-git/ruby-git/commit/410095c4d2a3065c222f9cc750a05143230801d7)), closes [#1640](https://github.com/ruby-git/ruby-git/issues/1640)
41
197
 
42
198
 
43
199
  ### Bug Fixes
44
200
 
45
- * Run the Git.open bootstrap commands without redirecting stdin ([65de0fe](https://github.com/ruby-git/ruby-git/commit/65de0fe88bca34ad3de366ee9a212653de37fc6d)), closes [#840](https://github.com/ruby-git/ruby-git/issues/840)
201
+ * **branching:** Verify refs/heads when classifying the HEAD state ([bfc4d8a](https://github.com/ruby-git/ruby-git/commit/bfc4d8a2b82000906d1a398c69125fcfdc22c276)), closes [#1641](https://github.com/ruby-git/ruby-git/issues/1641)
202
+
203
+
204
+ ### Other Changes
205
+
206
+ * **adr:** Supersede ADR-0006 with a release-based deprecation period ([b3b32e3](https://github.com/ruby-git/ruby-git/commit/b3b32e339f3804d022ea83cec03977039ecdcace))
207
+ * **author:** Add failing tests for Git::AuthorInfo and Git::Author deprecation ([e0d3123](https://github.com/ruby-git/ruby-git/commit/e0d3123fadd836e301160f492e0a1303f43267b8)), closes [#1721](https://github.com/ruby-git/ruby-git/issues/1721)
208
+ * **branch:** Add failing test for the Git::Branch#stashes deprecation ([a806808](https://github.com/ruby-git/ruby-git/commit/a806808f3e5a5a38a92646c1ab64c8906b3dc525))
209
+ * **contributing:** Describe the release line and maintenance branch rules ([fd78c9c](https://github.com/ruby-git/ruby-git/commit/fd78c9ccd262470c9e33166ba63dc095b2060a5d))
210
+ * **info:** Add failing tests for nested Git::AuthorInfo on TagInfo and StashInfo ([a7f5e69](https://github.com/ruby-git/ruby-git/commit/a7f5e6988beaa85bce68e6295ad23a2754338d5b)), closes [#1745](https://github.com/ruby-git/ruby-git/issues/1745)
211
+ * **readme:** Add the deprecation and release support policies ([50ac2e2](https://github.com/ruby-git/ruby-git/commit/50ac2e28bdd6ddb9349b8980e457441a0d39f6c9))
212
+ * **remote:** Add failing tests for the Git::Remote and Git::Repository#remote deprecations ([36af404](https://github.com/ruby-git/ruby-git/commit/36af40419603f9c0a03f424e3839a1d7337b517b))
213
+ * **skills:** State the deprecation policy and the major release checklists ([a246cf8](https://github.com/ruby-git/ruby-git/commit/a246cf8fee93a96132f2bd1b0796899204b830a1))
214
+ * **upgrading:** Add the v6.0.0 upgrade procedure ([4d7c58c](https://github.com/ruby-git/ruby-git/commit/4d7c58c7a0e963da6146608093e9373dade1efe4))
215
+
216
+ ## [5.2.0](https://github.com/ruby-git/ruby-git/compare/v5.1.0...v5.2.0) (2026-08-30)
217
+
218
+
219
+ ### Features
46
220
 
47
- ## [4.4.1](https://github.com/ruby-git/ruby-git/compare/v4.4.0...v4.4.1) (2026-08-09)
221
+ * **checkout:** Support the :orphan option in Repository#checkout ([265a997](https://github.com/ruby-git/ruby-git/commit/265a997ca972868a392ee71489b0e34e42ff70ec))
48
222
 
49
223
 
50
224
  ### Bug Fixes
51
225
 
52
- * 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)
226
+ * Exclude the .claude/skills symlink and other dev files from the gem ([ae4ef0e](https://github.com/ruby-git/ruby-git/commit/ae4ef0e6185285ee325fabdc9bc9214527a80ac5))
227
+ * Remove the cat-file raw constraint that duplicated a git check ([ea52fc7](https://github.com/ruby-git/ruby-git/commit/ea52fc7515b24669ab6f5371df2cabd2a08e357c))
53
228
 
54
229
 
55
230
  ### Other Changes
56
231
 
57
- * 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)
58
- * 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)
59
-
60
- ## [4.4.0](https://github.com/ruby-git/ruby-git/compare/v4.3.2...v4.4.0) (2026-07-11)
232
+ * Add a markdown link checker ([8000810](https://github.com/ruby-git/ruby-git/commit/80008103ea7c3ad71404b75f0c04f8e81fd226f9))
233
+ * Address suppressed copilot comments in the resolve-feedback skill ([9677f33](https://github.com/ruby-git/ruby-git/commit/9677f33103f926271be5da8f4406f532f47b3ef3))
234
+ * Announce the v5.x deprecations and the v6.0.0 roadmap ([68380f2](https://github.com/ruby-git/ruby-git/commit/68380f24f48e3bbe6b3983e6272a58e838c72b39))
235
+ * Archive the v5.x redesign documents ([4bed4ce](https://github.com/ruby-git/ruby-git/commit/4bed4ce1a520dda9cea9336ea4f8784f48cba306))
236
+ * Configure the mattpocock engineering skills for this repo ([ff03315](https://github.com/ruby-git/ruby-git/commit/ff033152209bf82e97073845de61f04ee3ecc47f))
237
+ * Copyedit CONTRIBUTING.md for plain, direct language ([7756ad1](https://github.com/ruby-git/ruby-git/commit/7756ad1b0615fd1a7dc40cbdbba52822f2329d5a))
238
+ * **deps:** Update process_executer to ~&gt; 4.1 ([7f01af4](https://github.com/ruby-git/ruby-git/commit/7f01af4ed0fdfc1894a10c01a7df34367559ac79))
239
+ * Fix broken relative links and heading anchors ([0bf31b8](https://github.com/ruby-git/ruby-git/commit/0bf31b85877f30746c51a6af765b4c707fcfe9ed))
240
+ * Fold the remaining plan documents into issues and adrs ([74944d9](https://github.com/ruby-git/ruby-git/commit/74944d9909e4a35f1fc7a88841e82b93e16a7e21))
241
+ * **fsck:** Build the second root commit through the public API ([3a7f083](https://github.com/ruby-git/ruby-git/commit/3a7f083b00498ace343622c8e7e20af6d498f247))
242
+ * Make command-class policy self-contained in the skills ([8158d2a](https://github.com/ruby-git/ruby-git/commit/8158d2ae8c1e0d108f2ad978056669dc95be6035))
243
+ * Name maintainer and contributors in the LICENSE copyright notice ([ddb33c0](https://github.com/ruby-git/ruby-git/commit/ddb33c004d82fdeaee90a36cea32e73e3b36211a))
244
+ * Point agents at the adr directory before they change covered areas ([ad8a20d](https://github.com/ruby-git/ruby-git/commit/ad8a20dc3cbddc81cb2e09a8b22e276ea6095907))
245
+ * Port the roadmap-tickets conventions into a project skill ([74a4e69](https://github.com/ruby-git/ruby-git/commit/74a4e696ba61595674501d02eaf49c7190fd4438))
246
+ * Record any durable decision as an adr, not only architectural ones ([455a28c](https://github.com/ruby-git/ruby-git/commit/455a28ca92d59eb83f448767547441701dbae3dc))
247
+ * Record the option surface rule as adr 0004 ([d37beed](https://github.com/ruby-git/ruby-git/commit/d37beeddb3f0b98dd71f6dd89a70cd5d4ef9cab0))
248
+ * Record the removal gate as adr 0006 ([b76d54e](https://github.com/ruby-git/ruby-git/commit/b76d54e8be59c07de848c944af7dc8e961e7c6f1))
249
+ * Record the v4.x call-shape rule as adr 0005 ([3cd68cd](https://github.com/ruby-git/ruby-git/commit/3cd68cde2d6e73b05425c6485619ca7fa92aa177))
250
+ * Record the validation delegation rationale as adr 0003 ([8c224f5](https://github.com/ruby-git/ruby-git/commit/8c224f561b0eebb77e8be1967df563ad977c7017))
251
+ * Reduce the resolve-feedback skill to a pointer plus ruby-git deltas ([4a4c361](https://github.com/ruby-git/ruby-git/commit/4a4c361715b585148a37115818d64a90b8088b5a))
252
+ * Remove ai writing tells from the readme ([e9c782e](https://github.com/ruby-git/ruby-git/commit/e9c782ea6aed6eb73265fcc3dea043fa916d2cc3))
253
+ * Remove the iteratively-address-copilot-reviews prompt and its command ([fdaed6f](https://github.com/ruby-git/ruby-git/commit/fdaed6f857dec93768c8f5be6e5cce0132a5103a))
254
+ * Rename the resolve-pr-feedback skill to address-pr-feedback ([d5e8700](https://github.com/ruby-git/ruby-git/commit/d5e8700736a4c6bd8899b558befb915056c5ff6d))
255
+ * Require executed proof for safety claims in breaking-change-analysis ([859ed31](https://github.com/ruby-git/ruby-git/commit/859ed31ecabc94f8cacd81ea5df8a273fa896fa9))
256
+ * Require verifiable, reviewer-provable task sequencing in development-workflow ([d4a7191](https://github.com/ruby-git/ruby-git/commit/d4a7191f49703f214748f19643242c9474bb8060))
257
+ * Satisfy the new Style/DirectiveScope cop ([354057e](https://github.com/ruby-git/ruby-git/commit/354057e32f9a0bec19bef50b07d037235bd73976))
258
+ * State each policy definition once and link everywhere else ([0023d54](https://github.com/ruby-git/ruby-git/commit/0023d54a252c567546b3097b5caf094a1a38b516)), closes [#1710](https://github.com/ruby-git/ruby-git/issues/1710)
259
+ * Stop restating gemspec version constraints in the project-context skill ([595a53c](https://github.com/ruby-git/ruby-git/commit/595a53c1b03919240d3997166b7606f9d1471345))
260
+
261
+ ## [5.1.0](https://github.com/ruby-git/ruby-git/compare/v5.0.5...v5.1.0) (2026-08-18)
61
262
 
62
263
 
63
264
  ### Features
64
265
 
65
- * Allow deprecation behavior env var ([fd622be](https://github.com/ruby-git/ruby-git/commit/fd622bea6513d78f2dbed8dc19c110be80d07ec8))
66
- * Warn on first direct access to Git::Lib constant ([52059c6](https://github.com/ruby-git/ruby-git/commit/52059c63d5c23b4d80025b95332e946aba942f0c))
266
+ * **grep:** Expose perl_regexp on the Git::Repository#grep facade ([759436f](https://github.com/ruby-git/ruby-git/commit/759436f7b59ac5028e38a2158a9a354720640415))
267
+ * **log:** Expose perl_regexp on the log path ([df8ea33](https://github.com/ruby-git/ruby-git/commit/df8ea33bb7d019d1a52fbb99370d9ffd67bf279f))
67
268
 
68
269
 
69
270
  ### Other Changes
70
271
 
71
- * 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))
272
+ * Add fiddle as a Windows development dependency ([1847989](https://github.com/ruby-git/ruby-git/commit/18479892529bd1f992596cbc055a9a42be326680))
273
+ * Bound the locale job's apt step so a stalled mirror fails fast ([3a5d83b](https://github.com/ruby-git/ruby-git/commit/3a5d83b7685091a4abbde2c84c0136214fa66e5d))
274
+ * Cover the perl_regexp escape hatch for non-ASCII regex matching ([55e2ded](https://github.com/ruby-git/ruby-git/commit/55e2ded4563a39a0389dbbd52f8425da9a1e3aea))
275
+ * Document the Git for Windows byte-matching regex limitation ([9aaedbd](https://github.com/ruby-git/ruby-git/commit/9aaedbd94488bcfeef05cc56dfce61ce69f529fc))
276
+ * Document the windows symlink privilege requirement ([696dff3](https://github.com/ruby-git/ruby-git/commit/696dff3cbf09647bbfa51279f7e35fc8a85eaab4))
277
+ * Express development dependency conditions as named predicates ([acca20a](https://github.com/ruby-git/ruby-git/commit/acca20a43a6fb79f6b36de900ac8aa8c2488d87f))
278
+ * Fix a broken section link in the pre-review checklist ([719f595](https://github.com/ruby-git/ruby-git/commit/719f595af69c1afcf6b025d1a2bb920963738f80))
279
+ * Make integration fixtures independent of git and platform settings ([c2a1592](https://github.com/ruby-git/ruby-git/commit/c2a159287ec007793c125929029303707669c8ad))
280
+ * Pin rubocop to lf line endings ([7f40413](https://github.com/ruby-git/ruby-git/commit/7f40413c3eded1af7a3dede02e1d94d7dc9c829b))
281
+ * Pin test repository config from a single source ([6e227b7](https://github.com/ruby-git/ruby-git/commit/6e227b70f59f4bbaf2bbc1d30a4b1b86ffbe6afc))
282
+ * Scope the symlink rescue to the symlink call ([c2bed8f](https://github.com/ruby-git/ruby-git/commit/c2bed8fefdd8bdf2efa84432c318b2b39ba223d2))
283
+ * Skip the symlink specs when the host cannot create symlinks ([8e9b667](https://github.com/ruby-git/ruby-git/commit/8e9b667daeb6a179a02df7c946a495c7b7e6fce5))
72
284
 
73
- ## [4.3.2](https://github.com/ruby-git/ruby-git/compare/v4.3.1...v4.3.2) (2026-03-31)
285
+ ## [5.0.5](https://github.com/ruby-git/ruby-git/compare/v5.0.4...v5.0.5) (2026-08-09)
74
286
 
75
287
 
76
288
  ### Bug Fixes
77
289
 
78
- * 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)
290
+ * Detect Darwin under JRuby when pinning LC_ALL ([89bf625](https://github.com/ruby-git/ruby-git/commit/89bf62579999bec27a9b0f1aab16d37e7d5af2b8)), closes [#1669](https://github.com/ruby-git/ruby-git/issues/1669)
291
+ * Pin LC_ALL to a locale that exists on the host platform ([5a4e0d6](https://github.com/ruby-git/ruby-git/commit/5a4e0d657b0e0828de0b38f283ae60dfbe2d4cc6)), closes [#1669](https://github.com/ruby-git/ruby-git/issues/1669)
79
292
 
80
293
 
81
294
  ### Other Changes
82
295
 
83
- * Add docker-git script to test with specific git versions ([0cc0e80](https://github.com/ruby-git/ruby-git/commit/0cc0e804758e73520c124622a7ba49ff97f2deaf))
84
- * Address newly reported rubocop offenses ([a37412d](https://github.com/ruby-git/ruby-git/commit/a37412d6a1cf2b927a6173ea767a7ad9f1290af6))
296
+ * Correct two imprecise claims in the build-complete comment ([c4391cd](https://github.com/ruby-git/ruby-git/commit/c4391cdf441a8379dee4cda59f800da41bf8e8b2)), closes [#1675](https://github.com/ruby-git/ruby-git/issues/1675)
297
+ * Gate merges on a matrix-free job instead of the per-matrix checks ([47f2d17](https://github.com/ruby-git/ruby-git/commit/47f2d17d16d1ea201bf9cc8f74aedffa7619eb0a)), closes [#1675](https://github.com/ruby-git/ruby-git/issues/1675)
298
+ * Remove vestigial matrix dimensions ([3a89886](https://github.com/ruby-git/ruby-git/commit/3a8988650a7d8f0a81c093c470fb9f524142c9b9)), closes [#1676](https://github.com/ruby-git/ruby-git/issues/1676)
299
+ * Run RuboCop and YARD once instead of on every matrix job ([0726964](https://github.com/ruby-git/ruby-git/commit/072696491662867cfbc0424febcf36542548f051))
300
+ * Run the suite once with en_US.UTF-8 unavailable ([6e012c5](https://github.com/ruby-git/ruby-git/commit/6e012c54d52c8b0c25bf629f07e310b6fcbac229)), closes [#1669](https://github.com/ruby-git/ruby-git/issues/1669)
301
+ * Run the test suite under a non-English locale ([c65d402](https://github.com/ruby-git/ruby-git/commit/c65d4022f358a4e4e676dbf2492427851205cdd6)), closes [#1670](https://github.com/ruby-git/ruby-git/issues/1670)
302
+ * Skip the All Specs Passed gate on release PRs ([6dfeee0](https://github.com/ruby-git/ruby-git/commit/6dfeee0ed508932393106c8887d9b7c9ef9dbbca)), closes [#1675](https://github.com/ruby-git/ruby-git/issues/1675)
303
+ * Warm bundler caches at default-branch scope on push to main ([2821477](https://github.com/ruby-git/ruby-git/commit/282147796f6b859fb9c7f8b5a614cab399cc9539)), closes [#1674](https://github.com/ruby-git/ruby-git/issues/1674)
85
304
 
86
- ## [4.3.1](https://github.com/ruby-git/ruby-git/compare/v4.3.0...v4.3.1) (2026-02-20)
305
+ ## [5.0.4](https://github.com/ruby-git/ruby-git/compare/v5.0.3...v5.0.4) (2026-08-07)
87
306
 
88
307
 
89
308
  ### Bug Fixes
90
309
 
91
- * 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))
310
+ * Return the full ref path in the ls_remote :ref value ([34b0b06](https://github.com/ruby-git/ruby-git/commit/34b0b0678c6ab47f77afaf7331fb6b41160def1a)), closes [#1416](https://github.com/ruby-git/ruby-git/issues/1416)
92
311
 
93
- ## [4.3.0](https://github.com/ruby-git/ruby-git/compare/v4.2.0...v4.3.0) (2026-01-15)
94
312
 
313
+ ### Other Changes
95
314
 
96
- ### Features
315
+ * Pin the locale for the CommandLine::Capturing integration spec ([6040867](https://github.com/ruby-git/ruby-git/commit/6040867ecfb44434a26006f9b79bebfb590d1ca8))
97
316
 
98
- * 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)
317
+ ## [5.0.3](https://github.com/ruby-git/ruby-git/compare/v5.0.2...v5.0.3) (2026-08-07)
99
318
 
100
- ## [4.2.0](https://github.com/ruby-git/ruby-git/compare/v4.1.2...v4.2.0) (2026-01-11)
101
319
 
320
+ ### Bug Fixes
102
321
 
103
- ### Features
322
+ * Drop unsupported -- separator from remote remove/rename commands ([8ec466f](https://github.com/ruby-git/ruby-git/commit/8ec466f8b282a5e94abd7d499bc26a92d94b2fc3))
323
+ * Remove unreachable case branch in Patch#apply_file_mode ([896fc49](https://github.com/ruby-git/ruby-git/commit/896fc49e3c2c03c401fe1b213c3f75bb40730521))
324
+ * Remove unreachable nil check in Git::Parsers::Grep.parse ([74e919a](https://github.com/ruby-git/ruby-git/commit/74e919a401126ad4415615f92cc9597e966239c6))
325
+
326
+
327
+ ### Other Changes
328
+
329
+ * Add Claude Code support alongside GitHub Copilot ([37f7d6a](https://github.com/ruby-git/ruby-git/commit/37f7d6a14c6d53bcf5b9644b8023d323290a5977))
330
+ * Add unit spec for Git::EncodingUtils ([5f0f10e](https://github.com/ruby-git/ruby-git/commit/5f0f10e4db78324bbe453de49598564a25f3428a))
331
+ * Consolidate parallel and serial spec rake tasks ([49616b1](https://github.com/ruby-git/ruby-git/commit/49616b12f52c6941a8617afbf7c56e7d7d5fe0f6))
332
+ * Cover :index option in Git::Factories#worktree_open_options_after_init ([efeba22](https://github.com/ruby-git/ruby-git/commit/efeba2294bb05327489a6523c46f26dc7392a84e))
333
+ * Cover #path when both src and dst are nil ([3a1a05a](https://github.com/ruby-git/ruby-git/commit/3a1a05a9be13057a1fc304df5008866634179124))
334
+ * Cover edge-case branches in Git::Parsers::Diff ([38d8b3f](https://github.com/ruby-git/ruby-git/commit/38d8b3f88f4f76a65776e9f6b8b87c6bb839e710))
335
+ * Cover Errno::ESRCH timeout-race rescue in run_process_executer ([899bf36](https://github.com/ruby-git/ruby-git/commit/899bf36399489038524cecf1d7ac2c606df03bde))
336
+ * Cover Git::Branch#merge ([71c0ea3](https://github.com/ruby-git/ruby-git/commit/71c0ea39d4c786a38245a8fb95fd93235ee03903))
337
+ * Cover Git::Branch#stashes ([27ba130](https://github.com/ruby-git/ruby-git/commit/27ba130a6cd3ef78171d1bb20230459c3f678a3a))
338
+ * Cover Git::Diff#name_status ([fa2ee98](https://github.com/ruby-git/ruby-git/commit/fa2ee98fd4613177843d285f7bc4a2ffb44ca79c))
339
+ * Cover Git::Factories#parse_clone_stderr unparseable-output branch ([65aa9b9](https://github.com/ruby-git/ruby-git/commit/65aa9b9318c7f8a8986c2aaae7dd0af0aeec4d69))
340
+ * Cover Git::Parsers::CatFile.each_header without trailing separator ([b7a9ed9](https://github.com/ruby-git/ruby-git/commit/b7a9ed93e03dcbd22a4fb25e9bb7b9c49647262d))
341
+ * Cover Git::Parsers::LsTree.parse with no tab-separated filename ([98b9ebf](https://github.com/ruby-git/ruby-git/commit/98b9ebf03c49f51c76b2e56dd670a9f68f220da8))
342
+ * Cover Git::Parsers::Remote.apply_pair unrecognized-variable branch ([03b10f6](https://github.com/ruby-git/ruby-git/commit/03b10f618a2f012b578ab995120cedbcd96ed8d1))
343
+ * Cover Git::Stashes#save ([7bca04c](https://github.com/ruby-git/ruby-git/commit/7bca04c53e64c747627784773d0c03ad0b9ff2e3))
344
+ * Cover Git.const_missing fallback branch for unrelated constants ([05c3c43](https://github.com/ruby-git/ruby-git/commit/05c3c4350e18bf1403fa314902708cfc40848c70))
345
+ * Cover Git.export ([4bd7f58](https://github.com/ruby-git/ruby-git/commit/4bd7f58432a19385ff55aecca9e89e2d9a96fa4a))
346
+ * Cover normalize_fetch_keys with a String option key ([47fb7fe](https://github.com/ruby-git/ruby-git/commit/47fb7fe061df9177a26ec7ada90b35b902ffc1df))
347
+ * Disable coverage for spec:integration, add SPEC filtering, fix formatters ([cb53d03](https://github.com/ruby-git/ruby-git/commit/cb53d03f8b671873f24368aadcafec638de32345))
348
+ * Document the project test coverage policy ([d378c1e](https://github.com/ruby-git/ruby-git/commit/d378c1e8b75e0c4209e17cc040ed36eb93053797))
349
+ * Enforce 100% unit test coverage on pull requests ([a446098](https://github.com/ruby-git/ruby-git/commit/a446098af548039b2c8b68bbb6562a53cb79fe40))
350
+ * Guard checkout-index nonexistent-path spec for git &lt; 2.30.0 ([cf212a9](https://github.com/ruby-git/ruby-git/commit/cf212a98b41218a7940ce54aa9b7c56a630412c3))
351
+ * Guard worktree repair spec for git &lt; 2.29.0 ([c527fb1](https://github.com/ruby-git/ruby-git/commit/c527fb15c2f21f9be5913192d43c847cf49681eb))
352
+ * **merge:** Fix incorrect version-gated failure expectation in quit_spec ([24c5ba4](https://github.com/ruby-git/ruby-git/commit/24c5ba4ce77b02413485d226a94b283f6af9d110))
353
+ * Read the gem version without loading lib/git/version.rb ([45c4b14](https://github.com/ruby-git/ruby-git/commit/45c4b14e944fcb43bda800823e377cf954ce2d3b))
354
+ * Require git 2.39.0 for maintenance register/unregister --config-file specs ([5b1fd52](https://github.com/ruby-git/ruby-git/commit/5b1fd527c39e4b3f1796851795a44694d94f4402))
355
+ * Skip get-urlmatch scope spec on git &lt; 2.42.0 ([e1ede7a](https://github.com/ruby-git/ruby-git/commit/e1ede7adddea28b654a183c618fc2336b5ffb83b))
356
+ * Upgrade simplecov and simplecov-rspec to ~&gt; 1.0 ([65e92b9](https://github.com/ruby-git/ruby-git/commit/65e92b9a9a621435efbf2a0855d48c47bb62425d))
357
+
358
+ ## [5.0.2](https://github.com/ruby-git/ruby-git/compare/v5.0.1...v5.0.2) (2026-08-02)
359
+
360
+
361
+ ### Bug Fixes
362
+
363
+ * Add bin/build-git-versions and bin/test-git-versions scripts ([3314503](https://github.com/ruby-git/ruby-git/commit/3314503708efcec2f386ca97bb6d96309a6c5c1a))
364
+
365
+
366
+ ### Other Changes
367
+
368
+ * Align CONTRIBUTING.md with current architecture and testing conventions ([60ac8e9](https://github.com/ruby-git/ruby-git/commit/60ac8e940776a3fb4efe46a98574ca5bbfcd718e))
369
+ * Allow disabling SimpleCov via COVERAGE=false env var ([3788418](https://github.com/ruby-git/ruby-git/commit/37884189eb646013628f78b6671e9876f0ebb925))
370
+ * Allow disabling SimpleCov via COVERAGE=false env var ([3788418](https://github.com/ruby-git/ruby-git/commit/37884189eb646013628f78b6671e9876f0ebb925))
371
+ * Avoid git-version-dependent all-zero SHA in stash store integration spec ([82a15e5](https://github.com/ruby-git/ruby-git/commit/82a15e57ebca03df3c3802f153c3545bc46920f4))
372
+ * Make 5.0.0 release more prominent in README ([2c8c42d](https://github.com/ruby-git/ruby-git/commit/2c8c42d30a7d7d35e03f1c4f8489fa49c866cded))
373
+ * Move Git::Repository::Factories and PathResolver to Git namespace ([dd0ae7b](https://github.com/ruby-git/ruby-git/commit/dd0ae7b34b912187f150d56b38f6eeb14b8882bf))
374
+ * Update README badges ([079a121](https://github.com/ruby-git/ruby-git/commit/079a1211216666f190583b2bfd3124ebb823ae58))
104
375
 
105
- * Add deprecation warning for .path accessor ([8af4543](https://github.com/ruby-git/ruby-git/commit/8af4543a25a46bf40ed7a05b31cea1a5b17e3f0b))
376
+ ## [5.0.1](https://github.com/ruby-git/ruby-git/compare/v5.0.0...v5.0.1) (2026-07-30)
106
377
 
107
378
 
108
379
  ### Other Changes
109
380
 
110
- * Add target-branch to release-please action ([13e041e](https://github.com/ruby-git/ruby-git/commit/13e041ebb76587b90549896a4c9b9b872f60696a))
111
- * Set 4.x manifest to start from 4.1.1 ([1ccee62](https://github.com/ruby-git/ruby-git/commit/1ccee62cdd832a6de2307b0a61ceb593548e7fe1))
381
+ * Review and streamline AI agent instructions ([536eb86](https://github.com/ruby-git/ruby-git/commit/536eb865440da8c0e74de0dfc32828b82fc675db))
382
+ * Summarize v5.0.0 as architectural redesign in CHANGELOG ([712c93e](https://github.com/ruby-git/ruby-git/commit/712c93ea237490be3b037250af44cd6633baf68f))
383
+
384
+ ## [5.0.0](https://github.com/ruby-git/ruby-git/compare/v4.1.2...v5.0.0) (2026-07-28)
385
+
386
+ v5.0.0 is a complete architectural redesign of the `git` gem. The monolithic
387
+ `Git::Base` and `Git::Lib` classes have been replaced by a layered design:
388
+ `Git::Commands::*` for git command execution, `Git::Repository` as the public
389
+ API surface, and dedicated parser classes. Most v4.x code requires **no
390
+ changes** — compatibility shims emit deprecation warnings pointing to the v5.x
391
+ equivalents.
392
+
393
+ For a full migration guide, including deprecated method renames and code
394
+ examples, see [UPGRADING.md](UPGRADING.md).
395
+
396
+ ### ⚠ BREAKING CHANGES
397
+
398
+ * **`Git::Base` class removed; constant remains as a deprecated shim.**
399
+ `Git::Base.new` raises an error and `require 'git/base'` raises `LoadError`.
400
+ The `Git::Base` constant still exists as a deprecated module included in
401
+ `Git::Repository`, so `is_a?(Git::Base)` checks and monkeypatches continue to
402
+ work but emit deprecation warnings. Update explicit `Git::Base` class
403
+ references to use `Git::Repository`; the shim is removed in v6.0.0.
404
+ * **`Git::Lib` removed.** Calling `#lib` on a repository object returns `self`
405
+ with a deprecation warning (forwarding to `Git::Repository` methods where
406
+ possible), but `Git::Lib` itself no longer exists. Methods unique to
407
+ `Git::Lib` with no `Git::Repository` counterpart raise `NoMethodError`.
408
+ * **`Git.open`, `Git.bare`, `Git.clone`, and `Git.init` return `Git::Repository`
409
+ instead of `Git::Base`.** For most callers this is transparent. Code that
410
+ explicitly checks `is_a?(Git::Base)` must be updated to `is_a?(Git::Repository)`.
411
+ * **Unsupported options now raise `ArgumentError`.** Unknown keyword options
412
+ that were silently ignored in v4.x may now raise `ArgumentError`. Check
413
+ option names against the documented API when upgrading.
414
+ * **`Git::Log#object` is not a path limiter.** Use `Git::Log#path` to filter
415
+ log results by file path.
416
+ * **`Git::CommandLineResult` is deprecated** (removed in v6.0.0). Use
417
+ `Git::CommandLine::Result` instead.
418
+
419
+ For the full list of commits included in this release, see the
420
+ [v5.0.0 commit history](https://github.com/ruby-git/ruby-git/compare/v4.1.2...v5.0.0).
112
421
 
113
422
  ## [4.1.2](https://github.com/ruby-git/ruby-git/compare/v4.1.1...v4.1.2) (2026-01-10)
114
423