You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CLAUDE.md
+21-21Lines changed: 21 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,17 +1,17 @@
1
-
# CLAUDE.md — LsiGitCheckout
1
+
# CLAUDE.md — RepoHerd
2
2
3
3
## Project Overview
4
4
5
-
PowerShell-based dependency management tool that checks out multiple Git repositories to specified versions. Module architecture: `LsiGitCheckout.psm1` (functions) + `LsiGitCheckout.ps1` (entry point). Version 8.0.1, by LS Instruments AG.
5
+
PowerShell-based dependency management tool that checks out multiple Git repositories to specified versions. Module architecture: `RepoHerd.psm1` (functions) + `RepoHerd.ps1` (entry point). Version 8.0.1, by LS Instruments AG.
6
6
7
7
## Running the Tool
8
8
9
9
```powershell
10
-
.\LsiGitCheckout.ps1 # defaults to dependencies.json
There are 17 test cases across 16 test configs covering SemVer, Agnostic, API incompatibility (Permissive + Strict), custom paths, post-checkout scripts, and recursive dependencies. See `docs/testing_infrastructure.md` for the full test architecture.
@@ -47,9 +47,9 @@ There are 17 test cases across 16 test configs covering SemVer, Agnostic, API in
47
47
48
48
## Architecture
49
49
50
-
-**Module**: `LsiGitCheckout.psm1` — all function definitions (~35 functions)
Copy file name to clipboardExpand all lines: README.md
+25-25Lines changed: 25 additions & 25 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,8 @@
1
-
# LsiGitCheckout
1
+
# RepoHerd
2
2
3
3
A cross-platform Git dependency management tool that automates cloning, checking out, and version-pinning of multiple repositories from a single JSON configuration. Designed for multi-repo projects where teams need reproducible builds without the complexity of git submodules or monorepo tooling.
4
4
5
-
LsiGitCheckout resolves recursive dependencies across repository trees, supports both Semantic Versioning (SemVer) and tag-based version pinning, and handles SSH authentication (PuTTY on Windows, OpenSSH on macOS/Linux), Git LFS, and post-checkout script execution.
5
+
RepoHerd resolves recursive dependencies across repository trees, supports both Semantic Versioning (SemVer) and tag-based version pinning, and handles SSH authentication (PuTTY on Windows, OpenSSH on macOS/Linux), Git LFS, and post-checkout script execution.
# Set default API compatibility mode (applies only to Agnostic mode repositories)
197
-
.\LsiGitCheckout.ps1 -ApiCompatibility Strict
197
+
.\RepoHerd.ps1 -ApiCompatibility Strict
198
198
199
199
# Disable recursive mode (non-recursive mode)
200
-
.\LsiGitCheckout.ps1 -DisableRecursion
200
+
.\RepoHerd.ps1 -DisableRecursion
201
201
202
202
# Disable post-checkout script execution
203
-
.\LsiGitCheckout.ps1 -DisablePostCheckoutScripts
203
+
.\RepoHerd.ps1 -DisablePostCheckoutScripts
204
204
205
205
# Enable detailed error context for debugging
206
-
.\LsiGitCheckout.ps1 -EnableErrorContext
206
+
.\RepoHerd.ps1 -EnableErrorContext
207
207
208
208
# Export structured JSON results for CI/CD pipelines
209
-
.\LsiGitCheckout.ps1 -OutputFile result.json
209
+
.\RepoHerd.ps1 -OutputFile result.json
210
210
```
211
211
212
212
### Parameters
@@ -227,7 +227,7 @@ In non-recursive mode, the script processes only the repositories listed in your
227
227
When `-OutputFile` is specified, a JSON file is written with the results of the checkout operation. The output is guaranteed to be written even on failure, making it safe for CI/CD pipelines. Schema version: **1.0.0**.
@@ -261,7 +261,7 @@ When `-OutputFile` is specified, a JSON file is written with the results of the
261
261
262
262
### Understanding Dependency Resolution Modes
263
263
264
-
LsiGitCheckout provides two approaches for determining which git tag to checkout for each repository. Both modes examine the available git tags in each repository to make their selection decisions.
264
+
RepoHerd provides two approaches for determining which git tag to checkout for each repository. Both modes examine the available git tags in each repository to make their selection decisions.
265
265
266
266
#### SemVer Mode (Recommended)
267
267
@@ -469,19 +469,19 @@ Maps hostnames to SSH key file paths. The key format depends on your platform:
469
469
470
470
```powershell
471
471
# Default behavior (recursive mode enabled with intelligent tag sorting)
472
-
.\LsiGitCheckout.ps1
472
+
.\RepoHerd.ps1
473
473
474
474
# Disable recursive mode for simple single-file processing
475
-
.\LsiGitCheckout.ps1 -DisableRecursion
475
+
.\RepoHerd.ps1 -DisableRecursion
476
476
477
477
# Customize recursive behavior
478
-
.\LsiGitCheckout.ps1 -MaxDepth 10
478
+
.\RepoHerd.ps1 -MaxDepth 10
479
479
480
480
# Use strict compatibility mode for Agnostic mode repositories
481
-
.\LsiGitCheckout.ps1 -ApiCompatibility Strict
481
+
.\RepoHerd.ps1 -ApiCompatibility Strict
482
482
483
483
# Disable post-checkout scripts
484
-
.\LsiGitCheckout.ps1 -DisablePostCheckoutScripts
484
+
.\RepoHerd.ps1 -DisablePostCheckoutScripts
485
485
```
486
486
487
487
### Recursion and Discovering Common Dependencies
@@ -519,7 +519,7 @@ At this point, the script must determine:
519
519
520
520
## Dependency Resolution Modes
521
521
522
-
LsiGitCheckout provides two powerful approaches to solve the dependency resolution problem:
522
+
RepoHerd provides two powerful approaches to solve the dependency resolution problem:
523
523
524
524
1.**SemVer Mode**: Automatically resolves compatible versions based on Semantic Versioning 2.0.0 rules with floating version support
@@ -555,11 +555,11 @@ Common issues and solutions, debug mode instructions, and enhanced error context
555
555
556
556
## Version Migration Guide
557
557
558
-
Step-by-step instructions for upgrading between LsiGitCheckout versions (6.2.x to 7.0.0, 7.0.0 to 7.1.0). For details, see [Version Migration Guide](docs/version_migration.md).
558
+
Step-by-step instructions for upgrading between RepoHerd versions (6.2.x to 7.0.0, 7.0.0 to 7.1.0). For details, see [Version Migration Guide](docs/version_migration.md).
559
559
560
560
## Advanced Topics
561
561
562
-
Links to in-depth guides on migrating dependency trees to LsiGitCheckout and tool comparisons. For details, see [Advanced Topics](docs/advanced_topics.md).
562
+
Links to in-depth guides on migrating dependency trees to RepoHerd and tool comparisons. For details, see [Advanced Topics](docs/advanced_topics.md).
0 commit comments