git 5.0.1 → 5.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '08c43ba7ae36ad5b41333b4c5a4d1890ff32c32ad07074145ee75d71cde61b8d'
-  data.tar.gz: 1380d2019f14ec54339aec4d7fced236098072794747edd38de8559aee8a6b66
+  metadata.gz: 6dcf907e2c0ccb6d916a9aa1d43f6c768e49555465a484e0231d919cb889b889
+  data.tar.gz: 5cce608675a41031f79318065e8c11125f9f23a154ab2ae6f578192010b04367
 SHA512:
-  metadata.gz: fe650cffb57c334881cda31e8f5a2e062c090bb1028c423647d5a429504c8d3ad96a6cb58812a3373ca0733f9c325e8dda3392bcd5ef4e53e561e80a17c5fa9d
-  data.tar.gz: c66b6ccf6e4644c09550d035c0b90ad1eb7dfbf91fc7509f8461329e6a33ac55d7324653a1c7770101a20156b4297304f14098a4fb8f97d48e7b6409b751b6d7
+  metadata.gz: 42dbbce6613ecd406e64771bb03d85416a4eae0fe12183fee03640292f5f18700175788c35c55836ad2d572bde6857421ed6cae8f9d7520dcd8bd12b498ae809
+  data.tar.gz: d55dd4bd23e700aacd23d8b850adada2e0e3a8f90176515e5de3b5213e43282ac5e8e105d500243bc54a0655472368e00becf4b6c01e59e4baf842223f8f89a7

data/.claude/commands/address-copilot-reviews.md

@@ -0,0 +1,14 @@
+---
+description: Address all unresolved Copilot review threads on the active pull request
+argument-hint: "[PR number — defaults to the PR for the current branch]"
+---
+
+Follow the shared agent prompt in
+`.github/prompts/iteratively-address-copilot-reviews.prompt.md` exactly. That file
+is the canonical instructions for this task and is shared with other AI agents; read
+it before doing anything else.
+
+@.github/prompts/iteratively-address-copilot-reviews.prompt.md
+
+If `$ARGUMENTS` is non-empty, treat it as the pull request number to operate on
+instead of detecting the PR from the current branch.

data/.claude/settings.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR/.github/hooks/run-bin-setup-once.sh\"",
+            "timeout": 900
+          }
+        ]
+      }
+    ]
+  }
+}

data/.claude/skills

@@ -0,0 +1 @@
+../.github/skills

data/.github/copilot-instructions.md

@@ -22,18 +22,6 @@ fine to use `#` in footer values such as `Closes: #999` or `Refs: #999`.
 - **RuboCop:** Use `RuboCop` for prose and `rubocop` for CLI or gem names. Never use
   `Rubocop`.
 
-## Project Commands
-
-| Purpose | Command |
-| --- | --- |
-| First-time project or new worktree setup | `bin/setup` |
-| Run all tests and linters (CI-equivalent) | `bundle exec rake` |
-| Run all RSpec tests | `bundle exec rake spec` |
-| Run RSpec unit tests | `bundle exec rake spec:unit` |
-| Run RSpec integration tests | `bundle exec rake spec:integration` |
-| Run a specific RSpec spec | `bundle exec rspec <path>` |
-| Run linters | `bundle exec rake rubocop yard build` |
-
 ## Branch & PR Strategy
 
 | Target | When |

data/.github/hooks/run-bin-setup-once.sh

@@ -1,12 +1,18 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+# This hook is shared by every agent configured for this repo (GitHub Copilot via
+# .github/hooks/, Claude Code via .claude/settings.json), so do not assume the
+# caller's working directory.
+command -v git >/dev/null 2>&1 || exit 0
+cd "$(dirname "${BASH_SOURCE[0]}")/../.." || exit 0
+
 # Skip if this repo does not use bin/setup.
 [[ -x "./bin/setup" ]] || exit 0
 
-# Keep setup idempotent per-worktree.
-command -v git >/dev/null 2>&1 || exit 0
-marker="$(git rev-parse --git-path copilot-bin-setup.done 2>/dev/null)" || exit 0
+# Keep setup idempotent per-worktree. The marker is shared across agents so that
+# cloning and opening the repo in two different tools does not run setup twice.
+marker="$(git rev-parse --git-path agent-bin-setup.done 2>/dev/null)" || exit 0
 [[ -f "$marker" ]] && exit 0
 
 ./bin/setup

data/.github/pull_request_template.md

@@ -16,4 +16,6 @@ Review our [guidelines for contributing](https://github.com/ruby-git/ruby-git/bl
 - [ ] I ran `bundle exec rake` locally on this branch and it passed (see
   [Local development setup](../CONTRIBUTING.md#local-development-setup)).
 - [ ] Tests added/updated as needed.
+- [ ] `bundle exec rake spec:unit` reports 100% line and branch coverage (see
+  [Test coverage policy](../CONTRIBUTING.md#test-coverage-policy)).
 - [ ] Documentation updated where applicable (README and/or YARD).

data/.github/skills/command-implementation/REFERENCE.md

@@ -908,7 +908,7 @@ For migration PRs, verify process constraints:
 - each slice is independently revertible
 - refactor-only changes are not mixed with unrelated behavior changes
 - quality gates pass for the slice — discover tasks via
-  `bundle exec ruby -e "require 'rake'; load 'Rakefile'; puts Rake::Task['default:parallel'].prerequisites"`
+  `bundle exec ruby -e "require 'rake'; load 'Rakefile'; puts Rake::Task['default'].prerequisites"`
   and run each individually via `bundle exec rake <task>`, fixing failures before
   advancing
 

data/.github/skills/command-implementation/SKILL.md

@@ -188,11 +188,11 @@ This skill supports three modes. Determine which mode applies before starting:
      requirements](REFERENCE.md#phased-rollout-requirements).
 
 5. **Run quality gates** — discover the prerequisite tasks for
-   `default:parallel` and run them sequentially, fixing failures before
+   `default` and run them sequentially, fixing failures before
    advancing:
 
    ```bash
-   bundle exec ruby -e "require 'rake'; load 'Rakefile'; puts Rake::Task['default:parallel'].prerequisites"
+   bundle exec ruby -e "require 'rake'; load 'Rakefile'; puts Rake::Task['default'].prerequisites"
    ```
 
    Run each listed task **individually** in order via `bundle exec rake <task>`

data/.github/skills/facade-implementation/SKILL.md

@@ -224,11 +224,11 @@ This skill supports three modes. Determine which mode applies before starting:
    - has tests that verify call-shape compatibility when classification is
      `legacy-contract` (positional hash and/or keyword-arg / `**opts` forms where required)
 
-5. **Run quality gates** — discover the prerequisite tasks for `default:parallel`
+5. **Run quality gates** — discover the prerequisite tasks for `default`
    and run them sequentially, fixing failures before advancing:
 
    ```bash
-   bundle exec ruby -e "require 'rake'; load 'Rakefile'; puts Rake::Task['default:parallel'].prerequisites"
+   bundle exec ruby -e "require 'rake'; load 'Rakefile'; puts Rake::Task['default'].prerequisites"
    ```
 
    Run each listed task **individually** in order via `bundle exec rake <task>`

data/.github/skills/rspec-unit-testing-standards/SKILL.md

@@ -68,9 +68,13 @@ Adoption and enforcement notes:
 - Apply these rules as hard requirements for new and modified unit specs.
 - Legacy specs may violate some rules; treat those as incremental cleanup work.
 - Branch and line coverage are both reported by SimpleCov in this repository.
-- `coverage_threshold: 100` is configured, but `fail_on_low_coverage` is currently
-  `false`; enforce Rule 21 during review by checking the coverage report until
-  strict failure is enabled.
+- `minimum_coverage: { line: 100, branch: 100 }` is configured and enforced: a full
+  `rake spec:unit` run fails when either threshold is missed, and CI fails the pull
+  request with it. Rule 21 is a build gate, not just a review check. See the
+  [Test coverage policy](../../../CONTRIBUTING.md#test-coverage-policy) in
+  `CONTRIBUTING.md` for the full policy.
+- Focused runs (`SPEC=<glob> rake spec:unit`, or `rspec <file>`) report coverage but
+  do not fail on it, since they load all of `lib/` while exercising only a slice.
 
 ## Related skills
 
@@ -484,10 +488,50 @@ Every conditional path through the public interface must be exercised by at leas
 one example. If a branch cannot be reached through the public interface, that is a
 design smell.
 
+This is enforced by the build: a full `rake spec:unit` run fails below 100% line or
+branch coverage, and the failure output names each uncovered line and branch.
+
+When a branch is hard to cover, apply these in order:
+
+1. **Reach it through the public interface** — if it is reachable, test it.
+2. **Delete it** — a branch unreachable through the public interface is usually dead
+   code. Removing it is preferable to excluding it.
+3. **Exclude it with `# simplecov:disable`** — the last resort, per the exception below.
+
 > **Exception:** Defensive guards that require breaking OS-level invariants to reach
 > (e.g., `raise "unreachable"` that would require triggering out-of-memory) may be
-> excluded. Mark them explicitly with `# :nocov:` and a brief comment explaining why
-> — never leave branches silently uncovered.
+> excluded. Mark them explicitly with a `# simplecov:disable` directive carrying a
+> reason — never leave branches silently uncovered. Cover the smallest possible span,
+> and expect a reviewer to challenge it. `lib/` currently contains no coverage
+> directives.
+
+Prefer the inline form for a single line. It applies only to its own line and needs no
+matching `enable`, so a region can never be left open by accident:
+
+```ruby
+raise 'unreachable' # simplecov:disable defensive guard; only reachable on OOM
+```
+
+Use the block form only for a genuine span, and close it explicitly:
+
+```ruby
+# simplecov:disable branch platform-specific fallback; not reachable on MRI
+...
+# simplecov:enable branch
+```
+
+Always name the narrowest criterion that solves the problem — `line`, `branch`,
+`method`, or a comma-separated combination — and write the reason after it, so the
+required justification lives in the directive.
+
+> **Review check:** verify the criterion is spelled exactly. A word SimpleCov does not
+> recognize is parsed as free-form reason text, which silently widens the directive to
+> all three criteria rather than failing.
+
+> **Coverage is a floor on evidence, not a proof of correctness.** Never write an
+> example whose only purpose is to execute a line. Such a test turns the report green
+> while violating [Rule 24](#rule-24-must-assert-observable-behavior-not-implementation-details),
+> and must be rejected in review.
 
 ### Rule 22 (MUST): Error assertions must specify both the error class and a message pattern
 
@@ -614,7 +658,9 @@ After writing or modifying tests, verify compliance before finishing:
 
 1. **Run the specs:** `bundle exec rspec spec/unit/path/to_spec.rb`
 2. **Check branch coverage** meets 100% (Rule 21) — open `coverage/index.html` and
-   confirm no uncovered branches in the class under test.
+   confirm no uncovered lines or branches in the class under test. A focused run
+   reports coverage but does not fail on it; `bundle exec rake spec:unit` is the
+   authority and will fail below 100%, naming each uncovered line and branch.
 3. **Re-check MUST rules.** Scan the spec against every MUST rule. Fix violations.
 4. **Run in random order** (Rule 27): `bundle exec rspec spec/unit/path/to_spec.rb --order rand`
 

data/.github/workflows/continuous_integration.yml

@@ -53,5 +53,17 @@ jobs:
         run: bundle exec rake default
         timeout-minutes: 15
 
+      # The unit suite enforces 100% line and branch coverage (see the "Test coverage
+      # policy" section of CONTRIBUTING.md). The failure log names the uncovered lines
+      # and branches; this artifact adds the browsable HTML report for the same run.
+      - name: Upload Coverage Report
+        if: failure()
+        uses: actions/upload-artifact@v7
+        with:
+          name: coverage-ruby-${{ matrix.ruby }}-${{ matrix.operating-system }}
+          path: coverage/
+          if-no-files-found: ignore
+          retention-days: 7
+
       - name: Test Gem
         run: bundle exec rake test:gem

data/.gitignore

@@ -21,4 +21,10 @@ rubocop-report.json
 # generated git reference docs
 git-reference/
 
+# git versions built by bin/build-git-versions
+git-versions/
+
 tmp
+
+# per-developer Claude Code overrides (shared config is in .claude/settings.json)
+.claude/settings.local.json

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "5.0.1"
+  ".": "5.0.3"
 }

data/.rspec

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

data/CHANGELOG.md

@@ -5,6 +5,65 @@
 
 # Change Log
 
+## [5.0.3](https://github.com/ruby-git/ruby-git/compare/v5.0.2...v5.0.3) (2026-08-07)
+
+
+### Bug Fixes
+
+* Drop unsupported -- separator from remote remove/rename commands ([8ec466f](https://github.com/ruby-git/ruby-git/commit/8ec466f8b282a5e94abd7d499bc26a92d94b2fc3))
+* Remove unreachable case branch in Patch#apply_file_mode ([896fc49](https://github.com/ruby-git/ruby-git/commit/896fc49e3c2c03c401fe1b213c3f75bb40730521))
+* Remove unreachable nil check in Git::Parsers::Grep.parse ([74e919a](https://github.com/ruby-git/ruby-git/commit/74e919a401126ad4415615f92cc9597e966239c6))
+
+
+### Other Changes
+
+* Add Claude Code support alongside GitHub Copilot ([37f7d6a](https://github.com/ruby-git/ruby-git/commit/37f7d6a14c6d53bcf5b9644b8023d323290a5977))
+* Add unit spec for Git::EncodingUtils ([5f0f10e](https://github.com/ruby-git/ruby-git/commit/5f0f10e4db78324bbe453de49598564a25f3428a))
+* Consolidate parallel and serial spec rake tasks ([49616b1](https://github.com/ruby-git/ruby-git/commit/49616b12f52c6941a8617afbf7c56e7d7d5fe0f6))
+* Cover :index option in Git::Factories#worktree_open_options_after_init ([efeba22](https://github.com/ruby-git/ruby-git/commit/efeba2294bb05327489a6523c46f26dc7392a84e))
+* Cover #path when both src and dst are nil ([3a1a05a](https://github.com/ruby-git/ruby-git/commit/3a1a05a9be13057a1fc304df5008866634179124))
+* Cover edge-case branches in Git::Parsers::Diff ([38d8b3f](https://github.com/ruby-git/ruby-git/commit/38d8b3f88f4f76a65776e9f6b8b87c6bb839e710))
+* Cover Errno::ESRCH timeout-race rescue in run_process_executer ([899bf36](https://github.com/ruby-git/ruby-git/commit/899bf36399489038524cecf1d7ac2c606df03bde))
+* Cover Git::Branch#merge ([71c0ea3](https://github.com/ruby-git/ruby-git/commit/71c0ea39d4c786a38245a8fb95fd93235ee03903))
+* Cover Git::Branch#stashes ([27ba130](https://github.com/ruby-git/ruby-git/commit/27ba130a6cd3ef78171d1bb20230459c3f678a3a))
+* Cover Git::Diff#name_status ([fa2ee98](https://github.com/ruby-git/ruby-git/commit/fa2ee98fd4613177843d285f7bc4a2ffb44ca79c))
+* Cover Git::Factories#parse_clone_stderr unparseable-output branch ([65aa9b9](https://github.com/ruby-git/ruby-git/commit/65aa9b9318c7f8a8986c2aaae7dd0af0aeec4d69))
+* Cover Git::Parsers::CatFile.each_header without trailing separator ([b7a9ed9](https://github.com/ruby-git/ruby-git/commit/b7a9ed93e03dcbd22a4fb25e9bb7b9c49647262d))
+* Cover Git::Parsers::LsTree.parse with no tab-separated filename ([98b9ebf](https://github.com/ruby-git/ruby-git/commit/98b9ebf03c49f51c76b2e56dd670a9f68f220da8))
+* Cover Git::Parsers::Remote.apply_pair unrecognized-variable branch ([03b10f6](https://github.com/ruby-git/ruby-git/commit/03b10f618a2f012b578ab995120cedbcd96ed8d1))
+* Cover Git::Stashes#save ([7bca04c](https://github.com/ruby-git/ruby-git/commit/7bca04c53e64c747627784773d0c03ad0b9ff2e3))
+* Cover Git.const_missing fallback branch for unrelated constants ([05c3c43](https://github.com/ruby-git/ruby-git/commit/05c3c4350e18bf1403fa314902708cfc40848c70))
+* Cover Git.export ([4bd7f58](https://github.com/ruby-git/ruby-git/commit/4bd7f58432a19385ff55aecca9e89e2d9a96fa4a))
+* Cover normalize_fetch_keys with a String option key ([47fb7fe](https://github.com/ruby-git/ruby-git/commit/47fb7fe061df9177a26ec7ada90b35b902ffc1df))
+* Disable coverage for spec:integration, add SPEC filtering, fix formatters ([cb53d03](https://github.com/ruby-git/ruby-git/commit/cb53d03f8b671873f24368aadcafec638de32345))
+* Document the project test coverage policy ([d378c1e](https://github.com/ruby-git/ruby-git/commit/d378c1e8b75e0c4209e17cc040ed36eb93053797))
+* Enforce 100% unit test coverage on pull requests ([a446098](https://github.com/ruby-git/ruby-git/commit/a446098af548039b2c8b68bbb6562a53cb79fe40))
+* Guard checkout-index nonexistent-path spec for git < 2.30.0 ([cf212a9](https://github.com/ruby-git/ruby-git/commit/cf212a98b41218a7940ce54aa9b7c56a630412c3))
+* Guard worktree repair spec for git < 2.29.0 ([c527fb1](https://github.com/ruby-git/ruby-git/commit/c527fb15c2f21f9be5913192d43c847cf49681eb))
+* **merge:** Fix incorrect version-gated failure expectation in quit_spec ([24c5ba4](https://github.com/ruby-git/ruby-git/commit/24c5ba4ce77b02413485d226a94b283f6af9d110))
+* Read the gem version without loading lib/git/version.rb ([45c4b14](https://github.com/ruby-git/ruby-git/commit/45c4b14e944fcb43bda800823e377cf954ce2d3b))
+* Require git 2.39.0 for maintenance register/unregister --config-file specs ([5b1fd52](https://github.com/ruby-git/ruby-git/commit/5b1fd527c39e4b3f1796851795a44694d94f4402))
+* Skip get-urlmatch scope spec on git < 2.42.0 ([e1ede7a](https://github.com/ruby-git/ruby-git/commit/e1ede7adddea28b654a183c618fc2336b5ffb83b))
+* Upgrade simplecov and simplecov-rspec to ~> 1.0 ([65e92b9](https://github.com/ruby-git/ruby-git/commit/65e92b9a9a621435efbf2a0855d48c47bb62425d))
+
+## [5.0.2](https://github.com/ruby-git/ruby-git/compare/v5.0.1...v5.0.2) (2026-08-02)
+
+
+### Bug Fixes
+
+* Add bin/build-git-versions and bin/test-git-versions scripts ([3314503](https://github.com/ruby-git/ruby-git/commit/3314503708efcec2f386ca97bb6d96309a6c5c1a))
+
+
+### Other Changes
+
+* Align CONTRIBUTING.md with current architecture and testing conventions ([60ac8e9](https://github.com/ruby-git/ruby-git/commit/60ac8e940776a3fb4efe46a98574ca5bbfcd718e))
+* Allow disabling SimpleCov via COVERAGE=false env var ([3788418](https://github.com/ruby-git/ruby-git/commit/37884189eb646013628f78b6671e9876f0ebb925))
+* Allow disabling SimpleCov via COVERAGE=false env var ([3788418](https://github.com/ruby-git/ruby-git/commit/37884189eb646013628f78b6671e9876f0ebb925))
+* Avoid git-version-dependent all-zero SHA in stash store integration spec ([82a15e5](https://github.com/ruby-git/ruby-git/commit/82a15e57ebca03df3c3802f153c3545bc46920f4))
+* Make 5.0.0 release more prominent in README ([2c8c42d](https://github.com/ruby-git/ruby-git/commit/2c8c42d30a7d7d35e03f1c4f8489fa49c866cded))
+* Move Git::Repository::Factories and PathResolver to Git namespace ([dd0ae7b](https://github.com/ruby-git/ruby-git/commit/dd0ae7b34b912187f150d56b38f6eeb14b8882bf))
+* Update README badges ([079a121](https://github.com/ruby-git/ruby-git/commit/079a1211216666f190583b2bfd3124ebb823ae58))
+
 ## [5.0.1](https://github.com/ruby-git/ruby-git/compare/v5.0.0...v5.0.1) (2026-07-30)
 
 

data/CLAUDE.md

@@ -0,0 +1,11 @@
+# CLAUDE.md
+
+This file exists so Claude Code picks up the same project instructions as every
+other AI coding agent used in this repository.
+
+**Do not add project guidance here.** The canonical instructions live in
+[`.github/copilot-instructions.md`](.github/copilot-instructions.md) and are
+imported below. Edit that file so all agents stay in sync. Reserve this file for
+guidance that applies *only* to Claude Code.
+
+@.github/copilot-instructions.md