git 4.0.7 → 4.1.1

data/.github/pull_request_template.md

@@ -1,8 +1,17 @@
 Review our [guidelines for contributing](https://github.com/ruby-git/ruby-git/blob/main/CONTRIBUTING.md) to this repository. A good start is to:
 
-* Write tests for your changes
-* Run `rake` before pushing
-* Include / update docs in the README.md and in YARD documentation
+- Write tests for your changes
+- Run `rake` before pushing
+- Include / update docs in the README.md and in YARD documentation
 
 # Description
 
+\<your description here\>
+
+## Checklist
+
+- [ ] I reviewed and applied the project's [AI Policy](../AI_POLICY.md). I understand
+  and verify any AI-assisted changes included in this PR and ensured they meet
+  quality, security, and licensing standards.
+- [ ] Tests added/updated as needed and `rake` passes locally.
+- [ ] Documentation updated where applicable (README and/or YARD).

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "4.0.7"
+  ".": "4.1.1"
 }

data/.rubocop_todo.yml

@@ -9,4 +9,4 @@
 # Offense count: 2
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ClassLength:
-  Max: 1039
+  Max: 1150

data/.yardopts

@@ -6,5 +6,9 @@
 -
 README.md
 CHANGELOG.md
+CODE_OF_CONDUCT.md
 CONTRIBUTING.md
+AI_POLICY.md
+GOVERNANCE.md
 MAINTAINERS.md
+LICENSE

data/AI_POLICY.md

@@ -0,0 +1,24 @@
+<!--
+# @markup markdown
+# @title AI Policy
+-->
+
+# AI Policy
+
+AI assisted contributions are welcome in this project.
+
+Reviewing and maintaining code requires human insight. While AI tools can be helpful
+assistants, they are no substitute for human judgment and creativity.
+
+We value the unique perspectives and critical thinking that our contributors bring.
+If you use AI tools to assist your work:
+
+1. **You are responsible**: You must review and understand every line of code or text
+   you submit.
+2. **Focus on quality**: Ensure that AI-generated content meets our standards for
+   correctness, readability, and security, and respects all licensing requirements.
+3. **Be transparent**: We encourage you to disclose if significant portions of your
+   contribution were AI-generated.
+
+Ultimately, the quality of this project depends on *your* expertise. Use tools
+wisely, but lead with your own intelligence.

data/CHANGELOG.md

@@ -5,6 +5,41 @@
 
 # Change Log
 
+## [4.1.1](https://github.com/ruby-git/ruby-git/compare/v4.1.0...v4.1.1) (2026-01-09)
+
+
+### Other Changes
+
+* Add AI Policy and update documentation ([8616cdf](https://github.com/ruby-git/ruby-git/commit/8616cdf7c6cfd1a3f2ccb931f59367b0fdfa36d1))
+* Add code of conduct links ([0769c8e](https://github.com/ruby-git/ruby-git/commit/0769c8ede791a2578291fa301d74144bc7fb2bfb))
+* Add governance policy and update project policies ([8d8263c](https://github.com/ruby-git/ruby-git/commit/8d8263c8395ff4e127b7dc6eb25b0371c272593a))
+* Add Quick Start section and reorganize README for new users ([1811a75](https://github.com/ruby-git/ruby-git/commit/1811a75e4b0b8b8233988d38a411ba585f35c044))
+* Clarify JRuby on Windows support policy ([c37b3d6](https://github.com/ruby-git/ruby-git/commit/c37b3d6c256cdc925578c7ff198f6b351dcb5844))
+
+## [4.1.0](https://github.com/ruby-git/ruby-git/compare/v4.0.7...v4.1.0) (2026-01-02)
+
+
+### Features
+
+* Add per-instance git_ssh configuration support ([26c1199](https://github.com/ruby-git/ruby-git/commit/26c119969ec71c23c965f55f0570471f8ddf333a))
+* **clone:** Add single_branch option ([a6929bb](https://github.com/ruby-git/ruby-git/commit/a6929bb0bfd51cba3a595e47740897ca619da468))
+* **diff:** Allow multiple paths in diff path limiter ([c663b62](https://github.com/ruby-git/ruby-git/commit/c663b62a0c9075a18c112e2cda3744f88f42ab7e))
+* **remote:** Add remote set-branches helper ([a7dab2b](https://github.com/ruby-git/ruby-git/commit/a7dab2bdf9088f0610dfbf3e3b78677b90195f75))
+
+
+### Bug Fixes
+
+* Prevent GIT_INDEX_FILE from corrupting worktree indexes ([27c0f16](https://github.com/ruby-git/ruby-git/commit/27c0f1629927ae23a5bb8efc4df79756a9e4406b))
+* **test:** Use larger timeout values on JRuby to prevent flaky tests ([aa8fd8b](https://github.com/ruby-git/ruby-git/commit/aa8fd8b0435246f70579bfab3cde8d45bc23233a))
+
+
+### Other Changes
+
+* Add git version support policy ([fbb0c60](https://github.com/ruby-git/ruby-git/commit/fbb0c60c56a01222133b61eb5267148773b4239c))
+* **clone:** Simplify single_branch validator ([3900233](https://github.com/ruby-git/ruby-git/commit/39002330d42c4a2b3f0413ba920e6fd534880e03))
+* Expand AI instructions with comprehensive workflows ([04907ed](https://github.com/ruby-git/ruby-git/commit/04907edd89dd716d85f190d828cbf6a0c43d47f6))
+* Make env_overrides more flexible and idiomatic ([dc0b43b](https://github.com/ruby-git/ruby-git/commit/dc0b43bccbc9c57c445efc303a3e0f6a71cbd66f))
+
 ## [4.0.7](https://github.com/ruby-git/ruby-git/compare/v4.0.6...v4.0.7) (2025-12-29)
 
 

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,25 @@
+<!--
+# @markup markdown
+# @title Code of Conduct
+-->
+
+# Code of Conduct
+
+ℹ️ We have adopted the [Ruby code of conduct](https://www.ruby-lang.org/en/conduct/).
+
+This document provides community guidelines for a safe, respectful, productive, and
+collaborative place for any person who is willing to contribute to the Ruby
+community. It applies to all “collaborative space”, which is defined as community
+communications channels (such as mailing lists, submitted patches, commit comments,
+etc.).
+
+- Participants will be tolerant of opposing views.
+- Participants must ensure that their language and actions are free of personal
+  attacks and disparaging personal remarks.
+- When interpreting the words and actions of others, participants should always
+  assume good intentions.
+- Behavior which can be reasonably considered harassment will not be tolerated.
+
+Report violations to the maintainers by [opening an
+issue](https://github.com/ruby-git/ruby-git/issues/new) or contacting a
+[maintainer](MAINTAINERS.md) privately.

data/CONTRIBUTING.md

@@ -12,6 +12,7 @@
   - [Commit your changes to a fork of `ruby-git`](#commit-your-changes-to-a-fork-of-ruby-git)
   - [Create a pull request](#create-a-pull-request)
   - [Get your pull request reviewed](#get-your-pull-request-reviewed)
+- [AI-assisted contributions](#ai-assisted-contributions)
 - [Design philosophy](#design-philosophy)
   - [Direct mapping to git commands](#direct-mapping-to-git-commands)
   - [Parameter naming](#parameter-naming)
@@ -41,6 +42,11 @@ judgment when contributing.
 If you have suggestions for improving these guidelines, please propose changes via a
 pull request.
 
+Please also review and adhere to our [Code of Conduct](CODE_OF_CONDUCT.md) when
+participating in the project.
+Governance and maintainer expectations are described in
+[GOVERNANCE.md](GOVERNANCE.md).
+
 ## How to contribute
 
 You can contribute in the following ways:
@@ -98,6 +104,13 @@ At least one approval from a project maintainer is required before your pull req
 can be merged. The maintainer is responsible for ensuring that the pull request meets
 [the project's coding standards](#coding-standards).
 
+## AI-assisted contributions
+
+AI-assisted contributions are welcome. Please review and apply our [AI Policy](AI_POLICY.md)
+before submitting changes. You are responsible for understanding and verifying any
+AI-assisted work included in PRs and ensuring it meets our standards for quality,
+security, and licensing.
+
 ## Design philosophy
 
 *Note: As of v2.x of the `git` gem, this design philosophy is aspirational. Future

data/GOVERNANCE.md

@@ -0,0 +1,63 @@
+<!--
+# @markup markdown
+# @title Governance
+-->
+
+# Governance
+
+This document explains how we steward the project with a light, principles-first
+approach: enable trusted people, minimize dormant access, and keep decisions
+transparent.
+
+## Roles
+
+A **Maintainer** is a trusted leader with write access who stewards the project's
+health and direction. Responsibilities center on triage, review, merge, and
+helping the community stay unblocked.
+
+A **Project Lead** is a maintainer with additional administrative scope (repo
+Admin, org Owner). They handle settings, secrets, access, and tie-breaks when
+needed.
+
+## Becoming a Maintainer
+
+Maintainers invite contributors who consistently ship, review, and model our
+values to become maintainers. Anyone can nominate themselves or others in an
+issue or via a private note. Current maintainers discuss nominations (see
+[Decision Making](#decision-making)) with a focus on contribution quality,
+alignment with project goals, and communication style.
+
+## Access Principles
+
+- Stewardship: Maintainer access exists to keep the project healthy and responsive.
+- Least privilege: Elevated access is temporary and kept only while it’s needed.
+- Continuity: Dormant access is paused to protect the project and unblock
+  contributors.
+- Respect: Status changes are transparent, reversible, and acknowledge past
+  contributions.
+
+## How We Apply Them
+
+- Staying active: Maintainers keep elevated access while participating (shipping,
+  reviewing, triaging, or governance).
+- When access is paused: If there’s no project activity for about a year, we’ll
+  check in. If we don’t hear back after a short window, we move the maintainer to
+  Emeritus and pause Owner/Admin/Write/package access (including CODEOWNERS
+  entries).
+- Coming back: Emeritus maintainers can be re-added quickly after a brief period of
+  renewed participation to refresh context.
+- Recognition: Emeritus maintainers remain listed to honor prior contributions.
+
+Access changes are communicated openly (e.g., PRs or issues) and reflected in the
+Maintainers list.
+
+## Decision Making
+
+Decisions are usually made by consensus among the active maintainers. If consensus
+cannot be reached, the decision is made by a majority vote. If a vote results in a
+tie, the Project Lead has the final say.
+
+## Code of Conduct
+
+All maintainers and contributors must adhere to the project's [Code of
+Conduct](./CODE_OF_CONDUCT.md).

data/MAINTAINERS.md

@@ -5,8 +5,20 @@
 
 # Maintainers
 
-When making changes in this repository, one of the maintainers below must review and approve your pull request.
+See [GOVERNANCE.md](GOVERNANCE.md) for a definition of the Maintainer role.
 
-* [James Couball](https://github.com/jcouball)
-* [Frank Throckmorton](https://github.com/frankthrock)
-* [Per Lundberg](https://github.com/perlun)
+## Active Maintainers
+
+- [James Couball](https://github.com/jcouball) (Project Lead)
+- [Frank Throckmorton](https://github.com/frankthrock)
+- [Per Lundberg](https://github.com/perlun)
+
+## Maintainers Emeritus (Alumni)
+
+**Maintainers Emeritus** are former maintainers who are no longer active. We honor
+their past contributions.
+
+- [Vern Burton](https://github.com/tarcinil)
+- [Daniel Perez](https://github.com/dpmex4527)
+- [Richard Vodden](https://github.com/rvodden)
+- [Scott Chacon](https://github.com/schacon)