feat: Add Invoke-RepoHerd entry point for PowerShell Gallery users

- Add Invoke-RepoHerd function to RepoHerd.psm1 with full orchestration
  logic (defaults to dependencies.json in current working directory)
- Refactor RepoHerd.ps1 to a thin wrapper delegating to Invoke-RepoHerd
- Export Invoke-RepoHerd in module manifest
- Bump version to 9.1.0

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: AndreaV-Lsi

CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to RepoHerd will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [9.1.0] - 2026-04-05
+
+### Added
+
+- `Invoke-RepoHerd` function as the module entry point for PowerShell Gallery users
+  - After `Install-Module RepoHerd`, users can call `Invoke-RepoHerd` directly
+  - Defaults to `dependencies.json` in the current working directory
+  - Same parameters as `RepoHerd.ps1`
+
+### Changed
+
+- `RepoHerd.ps1` refactored to a thin wrapper that delegates to `Invoke-RepoHerd`
+
 ## [9.0.0] - 2026-03-31
 
 ### Changed

RepoHerd.ps1

@@ -46,7 +46,7 @@
     .\RepoHerd.ps1 -Verbose -DisablePostCheckoutScripts
     .\RepoHerd.ps1 -EnableDebug -EnableErrorContext
 .NOTES
-    Version: 9.0.0
+    Version: 9.1.0
     Last Modified: 2026-03-20
 
     Requires PowerShell 7.6 LTS or later (installs side-by-side with Windows PowerShell 5.1).
@@ -94,175 +94,13 @@ param(
 $scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
 Import-Module (Join-Path $scriptDir 'RepoHerd.psm1') -Force
 
-# Initialize module state from script parameters
-Initialize-RepoHerd `
-    -ScriptPath $scriptDir `
-    -DryRun:$DryRun `
-    -EnableDebug:$EnableDebug `
-    -DisableRecursion:$DisableRecursion `
-    -MaxDepth $MaxDepth `
-    -ApiCompatibility $ApiCompatibility `
-    -DisablePostCheckoutScripts:$DisablePostCheckoutScripts `
-    -EnableErrorContext:$EnableErrorContext `
-    -OutputFile $OutputFile
-
-# Main execution
-$exitCode = 0
-try {
-    Write-Log "RepoHerd started - Version 9.0.0" -Level Info
-    Write-Log "Script path: $scriptDir" -Level Debug
-    Write-Log "PowerShell version: $($PSVersionTable.PSVersion)" -Level Debug
-    Write-Log "Operating System: $([System.Environment]::OSVersion.VersionString)" -Level Debug
-    Write-Log "Default API Compatibility: $ApiCompatibility" -Level Info
-
-    if (-not $DisableRecursion) {
-        Write-Log "Recursive mode: ENABLED (default) with max depth: $MaxDepth" -Level Info
-    } else {
-        Write-Log "Recursive mode: DISABLED" -Level Info
-    }
-
-    if (-not $DisablePostCheckoutScripts) {
-        Write-Log "Post-checkout scripts: ENABLED (default)" -Level Info
-    } else {
-        Write-Log "Post-checkout scripts: DISABLED" -Level Info
-    }
-
-    if ($EnableErrorContext) {
-        Write-Log "Error context: ENABLED - Detailed error information will be shown" -Level Info
-    } else {
-        Write-Log "Error context: DISABLED - Use -EnableErrorContext for detailed error information" -Level Debug
-    }
-
-    if ($OutputFile) {
-        Write-Log "Structured output will be written to: $OutputFile" -Level Info
-    }
-
-    # Calculate and log script hash in debug mode
-    if ($EnableDebug) {
-        $scriptContent = Get-Content -Path $MyInvocation.MyCommand.Path -Raw
-        $scriptBytes = [System.Text.Encoding]::UTF8.GetBytes($scriptContent)
-        $sha256 = [System.Security.Cryptography.SHA256]::Create()
-        $hashBytes = $sha256.ComputeHash($scriptBytes)
-        $scriptHash = [System.BitConverter]::ToString($hashBytes).Replace('-', '')
-        Write-Log "Script SHA256 hash: $($scriptHash.Substring(0, 16))..." -Level Debug
-        Write-Log "Full script hash: $scriptHash" -Level Debug
-    }
-
-    if ($DryRun) {
-        Write-Log "DRY RUN MODE - No actual changes will be made" -Level Warning
-    }
-
-    if ($EnableDebug) {
-        Write-Log "Debug logging enabled" -Level Info
-    }
-
-    # Check Git installation
-    if (-not (Test-GitInstalled)) {
-        throw "Git is not installed or not accessible in PATH"
-    }
-
-    # Determine input file path
-    if ([string]::IsNullOrEmpty($InputFile)) {
-        $InputFile = Join-Path $scriptDir "dependencies.json"
-        Write-Log "Using default input file: $InputFile" -Level Verbose
-    }
-
-    # Store the dependency file name for recursive processing
-    # Access module internals for setting the default dependency file name
-    & (Get-Module RepoHerd) { $script:DefaultDependencyFileName = $args[0] } (Split-Path -Leaf $InputFile)
-    Write-Log "Default dependency file name for recursive processing: $(Split-Path -Leaf $InputFile)" -Level Debug
-
-    # Determine credentials file path
-    if ([string]::IsNullOrEmpty($CredentialsFile)) {
-        $CredentialsFile = Join-Path $scriptDir "git_credentials.json"
-        Write-Log "Using default credentials file: $CredentialsFile" -Level Verbose
-    }
-
-    # Read SSH credentials
-    $sshCreds = Read-CredentialsFile -FilePath $CredentialsFile
-    & (Get-Module RepoHerd) { $script:SshCredentials = $args[0] } $sshCreds
-
-    # Check if input file exists
-    if (-not (Test-Path $InputFile)) {
-        throw "Input file not found: $InputFile"
-    }
-
-    # Process the initial dependency file with enhanced error handling
-    Write-Log "Starting dependency processing at depth 0" -Level Info
-
-    $checkedOutRepos = Invoke-WithErrorContext -Context "Processing root dependency file" -ScriptBlock {
-        Invoke-DependencyFile -DependencyFilePath $InputFile -Depth 0
-    }
-
-    # Handle null return
-    if ($null -eq $checkedOutRepos) {
-        Write-Log "WARNING: Invoke-DependencyFile returned null, initializing as empty array" -Level Warning
-        $checkedOutRepos = @()
-    } else {
-        Write-Log "Invoke-DependencyFile returned type: $($checkedOutRepos.GetType().FullName)" -Level Debug
-    }
-    if ($null -eq $checkedOutRepos) {
-        Write-Log "WARNING: checkedOutRepos is null!" -Level Warning
-        $checkedOutRepos = @()
-    }
-
-    Write-Log "Completed depth 0 processing: 1 dependency file processed, $($checkedOutRepos.Count) repositories checked out" -Level Info
-
-    # Additional debug information
-    if ($EnableDebug) {
-        Write-Log "Detailed checkedOutRepos information:" -Level Debug
-        Write-Log "  Count: $($checkedOutRepos.Count)" -Level Debug
-        Write-Log "  IsArray: $($checkedOutRepos -is [Array])" -Level Debug
-        if ($checkedOutRepos.Count -gt 0) {
-            Write-Log "  Repository details:" -Level Debug
-            foreach ($repo in $checkedOutRepos) {
-                Write-Log "    - Repository: $($repo.Repository.'Repository URL'), Path: $($repo.AbsolutePath)" -Level Debug
-            }
-        }
-    }
-
-    # If recursive mode is enabled, process nested dependencies
-    $isRecursiveMode = -not $DisableRecursion
-    Write-Log "Checking recursive processing conditions - RecursiveMode: $isRecursiveMode, CheckedOutRepos.Count: $($checkedOutRepos.Count)" -Level Debug
-
-    if ($isRecursiveMode -and $checkedOutRepos.Count -gt 0) {
-        Write-Log "Entering recursive processing with $($checkedOutRepos.Count) repositories" -Level Info
-        $defaultDepFileName = Split-Path -Leaf $InputFile
-        Invoke-WithErrorContext -Context "Processing recursive dependencies" -ScriptBlock {
-            Invoke-RecursiveDependencies -CheckedOutRepos $checkedOutRepos -DefaultDependencyFileName $defaultDepFileName -CurrentDepth 0
-        }
-    } else {
-        if ($DisableRecursion) {
-            Write-Log "Recursive processing skipped - recursive mode is disabled" -Level Info
-        } elseif ($checkedOutRepos.Count -eq 0) {
-            Write-Log "Recursive processing skipped - no new repositories were checked out at depth 0" -Level Info
-        }
-    }
-
-    # Show summary
-    Show-Summary
-
-    # Determine exit code from failure count
-    $failureCount = & (Get-Module RepoHerd) { $script:FailureCount }
-    if ($failureCount -gt 0) {
-        $exitCode = 1
-    }
-}
-catch {
-    Write-ErrorWithContext -ErrorRecord $_ -AdditionalMessage "Unexpected error in main execution"
-    Show-ErrorDialog -Message $_.Exception.Message
-    $exitCode = 1
+# When run from the script, default InputFile and CredentialsFile to the script directory
+if (-not $PSBoundParameters.ContainsKey('InputFile')) {
+    $PSBoundParameters['InputFile'] = Join-Path $scriptDir "dependencies.json"
 }
-finally {
-    # Write structured output if requested — guaranteed even on failure
-    if (-not [string]::IsNullOrEmpty($OutputFile)) {
-        try {
-            Export-CheckoutResults -OutputFile $OutputFile
-        }
-        catch {
-            Write-Host "Failed to write output file: $_" -ForegroundColor Red
-        }
-    }
+if (-not $PSBoundParameters.ContainsKey('CredentialsFile')) {
+    $PSBoundParameters['CredentialsFile'] = Join-Path $scriptDir "git_credentials.json"
 }
 
-exit $exitCode
+# Delegate to module function and exit with its return code
+exit (Invoke-RepoHerd @PSBoundParameters)

RepoHerd.psd1

@@ -1,7 +1,7 @@
 @{
     # Module manifest for RepoHerd
     RootModule        = 'RepoHerd.psm1'
-    ModuleVersion     = '9.0.0'
+    ModuleVersion     = '9.1.0'
     GUID              = '55dbb622-24f8-4f70-b16e-5412d436f94f'
     Author            = 'LS Instruments AG'
     CompanyName       = 'LS Instruments AG'
@@ -47,7 +47,8 @@
         'Read-CredentialsFile',
         'Set-PostCheckoutScriptResult',
         'Export-CheckoutResults',
-        'Show-Summary'
+        'Show-Summary',
+        'Invoke-RepoHerd'
     )
 
     CmdletsToExport   = @()
@@ -59,7 +60,7 @@
             Tags         = @('Git', 'Dependency', 'SemVer', 'Checkout', 'MultiRepo', 'DevOps', 'Automation', 'SSH', 'CrossPlatform', 'DependencyManagement', 'VersionPinning', 'Repository', 'Submodules')
             LicenseUri   = 'https://github.com/LS-Instruments/RepoHerd/blob/main/LICENSE'
             ProjectUri   = 'https://github.com/LS-Instruments/RepoHerd'
-            ReleaseNotes = 'v9.0.0: Project renamed from LsiGitCheckout to RepoHerd. Breaking: module, entry point, and initialization function renamed. Added GitHub Pages landing page with SEO.'
+            ReleaseNotes = 'v9.1.0: Added Invoke-RepoHerd function for PowerShell Gallery users. Install-Module RepoHerd now provides a callable entry point.'
         }
     }
 }