codeowners-git 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Hemand S
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,106 @@
+# codeowners-git
+
+Managing large-scale migrations in big monorepos with multiple codeowners can be overwhelming. Massive PRs touching thousands of files make it hard for teams to review changes efficiently.
+
+`codeowners-git` solves this by:
+
+- Identifying files owned by specific teams using the CODEOWNERS file.
+- Creating compact, team-specific branches with only their affected files.
+- Streamlining the review process with smaller, targeted PRs.
+
+## Installation
+
+### Using npx (recommended)
+
+Run commands directly without installation:
+
+```bash
+npx codeowners-git <command>
+```
+
+### Install globally via npm
+
+```bash
+npm install -g codeowners-git
+```
+
+Then run commands directly:
+
+```bash
+codeowners-git <command>
+```
+
+## Configuration
+
+The tool automatically detects CODEOWNERS files in:
+
+1. `.github/CODEOWNERS`
+2. `docs/CODEOWNERS`
+3. `CODEOWNERS` (root directory)
+
+## Commands
+
+### `list`
+
+List current CODEOWNERS entries.
+
+Usage:
+
+```bash
+codeowners-git list [options]
+```
+
+Options:
+
+- `--owner, -o` Filter by specific owner
+- `--include, -i` Include specific patterns
+
+Example:
+
+```bash
+codeowners-git list -o @myteam
+```
+
+### `branch`
+
+Manage branch permissions in CODEOWNERS file.
+
+Usage:
+
+```bash
+codeowners-git branch [options]
+```
+
+Options:
+
+- `--owner, -o` Specify owner(s) to add/remove
+- `--branch, -b` Specify branch pattern
+- `--message, -m` Commit message for changes
+
+Example:
+
+```bash
+codeowners-git branch -o @myteam -b "feature/*" -m "Add feature branch ownership"
+```
+
+## Contributing
+
+1. Clone the repository
+2. Install dependencies:
+
+```bash
+bun install
+```
+
+3. Make your changes
+4. Run tests:
+
+```bash
+bun test
+```
+
+5. Submit a pull request
+
+## License
+
+MIT ©