Merge feature/approved-verbs: v8.0.1 release

Rename functions to use approved PowerShell verbs, eliminating
the Import-Module warning. Fixes #17.

Author: AndreaV-Lsi

CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to LsiGitCheckout 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).
 
+## [8.0.1] - Unreleased
+
+### Changed
+
+- Renamed functions to use approved PowerShell verbs: `Parse-VersionPattern` → `ConvertTo-VersionPattern`, `Parse-RepositoryVersions` → `Get-RepositoryVersions`, `Validate-DependencyConfiguration` → `Test-DependencyConfiguration`, `Sort-TagsByDate` → `Resolve-TagsByDate`, `Process-DependencyFile` → `Invoke-DependencyFile`, `Process-RecursiveDependencies` → `Invoke-RecursiveDependencies`
+
 ## [8.0.0] - 2026-03-21
 
 ### Changed

CLAUDE.md

@@ -66,7 +66,7 @@ There are 17 test cases across 16 test configs covering SemVer, Agnostic, API in
 ## Coding Conventions
 
 - **PowerShell 7.6 LTS** required (`#Requires -Version 7.6`)
-- **Function names**: PascalCase Verb-Noun (e.g., `Test-GitInstalled`, `Parse-VersionPattern`, `Get-SemVersionIntersection`)
+- **Function names**: PascalCase Verb-Noun using approved PowerShell verbs (e.g., `Test-GitInstalled`, `ConvertTo-VersionPattern`, `Get-SemVersionIntersection`)
 - **Documentation**: comment-based help blocks (`.SYNOPSIS`, `.DESCRIPTION`, `.PARAMETER`) on all functions
 - **Logging**: use `Write-Log` with levels: Info, Warning, Error, Debug, Verbose
 - **Error handling**: wrap operations in `Invoke-WithErrorContext -Context "description" -ScriptBlock { ... }`

LsiGitCheckout.ps1

@@ -46,7 +46,7 @@
     .\LsiGitCheckout.ps1 -Verbose -DisablePostCheckoutScripts
     .\LsiGitCheckout.ps1 -EnableDebug -EnableErrorContext
 .NOTES
-    Version: 8.0.0
+    Version: 8.0.1
     Last Modified: 2026-03-20
 
     Requires PowerShell 7.6 LTS or later (installs side-by-side with Windows PowerShell 5.1).
@@ -92,7 +92,7 @@ param(
 
 # Import module from same directory as this script
 $scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-Import-Module (Join-Path $scriptDir 'LsiGitCheckout.psm1') -Force -DisableNameChecking
+Import-Module (Join-Path $scriptDir 'LsiGitCheckout.psm1') -Force
 
 # Initialize module state from script parameters
 Initialize-LsiGitCheckout `
@@ -109,7 +109,7 @@ Initialize-LsiGitCheckout `
 # Main execution
 $exitCode = 0
 try {
-    Write-Log "LsiGitCheckout started - Version 8.0.0" -Level Info
+    Write-Log "LsiGitCheckout started - Version 8.0.1" -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
@@ -191,15 +191,15 @@ try {
     Write-Log "Starting dependency processing at depth 0" -Level Info
 
     $checkedOutRepos = Invoke-WithErrorContext -Context "Processing root dependency file" -ScriptBlock {
-        Process-DependencyFile -DependencyFilePath $InputFile -Depth 0
+        Invoke-DependencyFile -DependencyFilePath $InputFile -Depth 0
     }
 
     # Handle null return
     if ($null -eq $checkedOutRepos) {
-        Write-Log "WARNING: Process-DependencyFile returned null, initializing as empty array" -Level Warning
+        Write-Log "WARNING: Invoke-DependencyFile returned null, initializing as empty array" -Level Warning
         $checkedOutRepos = @()
     } else {
-        Write-Log "Process-DependencyFile returned type: $($checkedOutRepos.GetType().FullName)" -Level Debug
+        Write-Log "Invoke-DependencyFile returned type: $($checkedOutRepos.GetType().FullName)" -Level Debug
     }
     if ($null -eq $checkedOutRepos) {
         Write-Log "WARNING: checkedOutRepos is null!" -Level Warning
@@ -229,7 +229,7 @@ try {
         Write-Log "Entering recursive processing with $($checkedOutRepos.Count) repositories" -Level Info
         $defaultDepFileName = Split-Path -Leaf $InputFile
         Invoke-WithErrorContext -Context "Processing recursive dependencies" -ScriptBlock {
-            Process-RecursiveDependencies -CheckedOutRepos $checkedOutRepos -DefaultDependencyFileName $defaultDepFileName -CurrentDepth 0
+            Invoke-RecursiveDependencies -CheckedOutRepos $checkedOutRepos -DefaultDependencyFileName $defaultDepFileName -CurrentDepth 0
         }
     } else {
         if ($DisableRecursion) {

LsiGitCheckout.psd1

@@ -1,7 +1,7 @@
 @{
     # Module manifest for LsiGitCheckout
     RootModule        = 'LsiGitCheckout.psm1'
-    ModuleVersion     = '8.0.0'
+    ModuleVersion     = '8.0.1'
     GUID              = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
     Author            = 'LS Instruments AG'
     CompanyName       = 'LS Instruments AG'
@@ -14,14 +14,14 @@
         'Write-ErrorWithContext',
         'Invoke-WithErrorContext',
         'Write-Log',
-        'Parse-VersionPattern',
+        'ConvertTo-VersionPattern',
         'Test-SemVerCompatibility',
         'Get-CompatibleVersionsForPattern',
         'Select-VersionFromIntersection',
-        'Parse-RepositoryVersions',
+        'Get-RepositoryVersions',
         'Get-SemVersionIntersection',
         'Format-SemVersion',
-        'Validate-DependencyConfiguration',
+        'Test-DependencyConfiguration',
         'Show-ErrorDialog',
         'Show-ConfirmDialog',
         'Test-GitInstalled',
@@ -32,7 +32,7 @@
         'Get-SshKeyForUrl',
         'Set-GitSshKey',
         'Get-GitTagDates',
-        'Sort-TagsByDate',
+        'Resolve-TagsByDate',
         'Reset-GitRepository',
         'Get-AbsoluteBasePath',
         'Get-TagIntersection',
@@ -42,8 +42,8 @@
         'Update-RepositoryDictionary',
         'Update-SemVerRepository',
         'Invoke-GitCheckout',
-        'Process-DependencyFile',
-        'Process-RecursiveDependencies',
+        'Invoke-DependencyFile',
+        'Invoke-RecursiveDependencies',
         'Read-CredentialsFile',
         'Set-PostCheckoutScriptResult',
         'Export-CheckoutResults',

LsiGitCheckout.psm1

@@ -1,11 +1,11 @@
 # LsiGitCheckout Module
 # Contains all function definitions for LsiGitCheckout tool
-# Version 8.0.0
+# Version 8.0.1
 
 #Requires -Version 7.6
 
 # Module-scoped state variables
-$script:Version = "8.0.0"
+$script:Version = "8.0.1"
 $script:ScriptPath = ""
 $script:ErrorFile = ""
 $script:DebugLogFile = ""
@@ -226,7 +226,7 @@ function Write-Log {
     }
 }
 
-function Parse-VersionPattern {
+function ConvertTo-VersionPattern {
     <#
     .SYNOPSIS
         Parses a version pattern and determines its type and constraints
@@ -410,7 +410,7 @@ function Select-VersionFromIntersection {
     return $selected
 }
 
-function Parse-RepositoryVersions {
+function Get-RepositoryVersions {
     <#
     .SYNOPSIS
         Parses all repository tags using the specified regex pattern to extract SemVer versions
@@ -539,7 +539,7 @@ function Format-SemVersion {
     return "$($Version.Major).$($Version.Minor).$($Version.Build)"
 }
 
-function Validate-DependencyConfiguration {
+function Test-DependencyConfiguration {
     <#
     .SYNOPSIS
         Validates that repository configuration hasn't changed in incompatible ways
@@ -981,7 +981,7 @@ function Get-GitTagDates {
     }
 }
 
-function Sort-TagsByDate {
+function Resolve-TagsByDate {
     param(
         [array]$Tags,
         [hashtable]$TagDates,
@@ -1183,7 +1183,7 @@ function Get-TagUnion {
     }
 
     $allTags = @($unionSet.Keys)
-    $sortedUnion = Sort-TagsByDate -Tags $allTags -TagDates $TagDates -RepositoryUrl $RepositoryUrl -Context "union calculation"
+    $sortedUnion = Resolve-TagsByDate -Tags $allTags -TagDates $TagDates -RepositoryUrl $RepositoryUrl -Context "union calculation"
 
     Write-Log "Temporal union result: $($sortedUnion -join ', ')" -Level Debug
     return $sortedUnion
@@ -1436,7 +1436,7 @@ function Update-RepositoryDictionary {
         # If repository exists, validate configuration hasn't changed
         if ($script:RepositoryDictionary.ContainsKey($repoUrl)) {
             Invoke-WithErrorContext -Context "Validating configuration for existing repository: $repoUrl" -ScriptBlock {
-                Validate-DependencyConfiguration -NewRepo $Repository -ExistingRepo $script:RepositoryDictionary[$repoUrl]
+                Test-DependencyConfiguration -NewRepo $Repository -ExistingRepo $script:RepositoryDictionary[$repoUrl]
             }
         }
 
@@ -1514,7 +1514,7 @@ function Update-RepositoryDictionary {
                         $union
                     } elseif ($apiCompatibleTags) {
                         # Use temporal sorting for API compatible tags
-                        $sorted = Sort-TagsByDate -Tags $apiCompatibleTags -TagDates $tagDates -RepositoryUrl $repoUrl
+                        $sorted = Resolve-TagsByDate -Tags $apiCompatibleTags -TagDates $tagDates -RepositoryUrl $repoUrl
                         $sorted
                     } else {
                         @($existingTag, $tag) | Select-Object -Unique
@@ -1599,7 +1599,7 @@ function Update-SemVerRepository {
     }
 
     try {
-        $parsedPattern = Parse-VersionPattern -VersionPattern $versionPattern
+        $parsedPattern = ConvertTo-VersionPattern -VersionPattern $versionPattern
         Write-Log "Parsed version pattern '$versionPattern' as type: $($parsedPattern.Type)" -Level Debug
     }
     catch {
@@ -1987,7 +1987,7 @@ function Invoke-GitCheckout {
                 $repoDict = $script:RepositoryDictionary[$repoUrl]
 
                 # Parse all versions from tags
-                $parseResult = Parse-RepositoryVersions -RepoPath $absoluteBasePath `
+                $parseResult = Get-RepositoryVersions -RepoPath $absoluteBasePath `
                                                        -VersionRegex $repoDict.VersionRegex
 
                 $repoDict.ParsedVersions = $parseResult.ParsedVersions
@@ -2250,7 +2250,7 @@ function Invoke-GitCheckout {
     }
 }
 
-function Process-DependencyFile {
+function Invoke-DependencyFile {
     param(
         [string]$DependencyFilePath,
         [int]$Depth,
@@ -2458,7 +2458,7 @@ function Process-DependencyFile {
             $checkedOutRepos = @()
         }
 
-        Write-Log "Process-DependencyFile returning $($checkedOutRepos.Count) repositories for recursive processing" -Level Debug
+        Write-Log "Invoke-DependencyFile returning $($checkedOutRepos.Count) repositories for recursive processing" -Level Debug
         return ,$checkedOutRepos  # The comma ensures we return an array
     }
     catch {
@@ -2467,7 +2467,7 @@ function Process-DependencyFile {
     }
 }
 
-function Process-RecursiveDependencies {
+function Invoke-RecursiveDependencies {
     param(
         [array]$CheckedOutRepos,
         [string]$DefaultDependencyFileName,
@@ -2516,7 +2516,7 @@ function Process-RecursiveDependencies {
             # Process nested dependencies using the DEFAULT dependency file name
             # Custom dependency file settings are isolated to the current repository only
             # Pass the repository root path for correct relative path resolution
-            $newRepos = Process-DependencyFile -DependencyFilePath $customDependencyFilePath -Depth $targetDepth -CallingRepositoryRootPath $repoPath
+            $newRepos = Invoke-DependencyFile -DependencyFilePath $customDependencyFilePath -Depth $targetDepth -CallingRepositoryRootPath $repoPath
             $newlyCheckedOutRepos += $newRepos
         } else {
             Write-Log "No dependency file found at: $customDependencyFilePath" -Level Debug
@@ -2528,7 +2528,7 @@ function Process-RecursiveDependencies {
     # Recursively process newly checked out repositories
     # Use the default dependency file name for all recursive processing
     if ($newlyCheckedOutRepos.Count -gt 0) {
-        Process-RecursiveDependencies -CheckedOutRepos $newlyCheckedOutRepos -DefaultDependencyFileName $DefaultDependencyFileName -CurrentDepth $targetDepth
+        Invoke-RecursiveDependencies -CheckedOutRepos $newlyCheckedOutRepos -DefaultDependencyFileName $DefaultDependencyFileName -CurrentDepth $targetDepth
     } else {
         Write-Log "Recursive processing complete - no more nested dependencies found" -Level Info
     }
@@ -2810,14 +2810,14 @@ Export-ModuleMember -Function @(
     'Write-ErrorWithContext',
     'Invoke-WithErrorContext',
     'Write-Log',
-    'Parse-VersionPattern',
+    'ConvertTo-VersionPattern',
     'Test-SemVerCompatibility',
     'Get-CompatibleVersionsForPattern',
     'Select-VersionFromIntersection',
-    'Parse-RepositoryVersions',
+    'Get-RepositoryVersions',
     'Get-SemVersionIntersection',
     'Format-SemVersion',
-    'Validate-DependencyConfiguration',
+    'Test-DependencyConfiguration',
     'Show-ErrorDialog',
     'Show-ConfirmDialog',
     'Test-GitInstalled',
@@ -2828,7 +2828,7 @@ Export-ModuleMember -Function @(
     'Get-SshKeyForUrl',
     'Set-GitSshKey',
     'Get-GitTagDates',
-    'Sort-TagsByDate',
+    'Resolve-TagsByDate',
     'Reset-GitRepository',
     'Get-AbsoluteBasePath',
     'Get-TagIntersection',
@@ -2838,8 +2838,8 @@ Export-ModuleMember -Function @(
     'Update-RepositoryDictionary',
     'Update-SemVerRepository',
     'Invoke-GitCheckout',
-    'Process-DependencyFile',
-    'Process-RecursiveDependencies',
+    'Invoke-DependencyFile',
+    'Invoke-RecursiveDependencies',
     'Read-CredentialsFile',
     'Set-PostCheckoutScriptResult',
     'Export-CheckoutResults',

docs/developer_guide.md

@@ -204,7 +204,7 @@ Fast tests covering pure and near-pure functions. No network or git operations r
 pwsh -Command "Invoke-Pester ./tests/LsiGitCheckout.Unit.Tests.ps1 -Output Detailed"
 ```
 
-Covers: `Parse-VersionPattern`, `Test-SemVerCompatibility`, `Get-CompatibleVersionsForPattern`, `Select-VersionFromIntersection`, `Get-SemVersionIntersection`, `Format-SemVersion`, `Get-TagIntersection`, `Get-HostnameFromUrl`, `Validate-DependencyConfiguration`, `Get-AbsoluteBasePath`, `Export-CheckoutResults`.
+Covers: `ConvertTo-VersionPattern`, `Test-SemVerCompatibility`, `Get-CompatibleVersionsForPattern`, `Select-VersionFromIntersection`, `Get-SemVersionIntersection`, `Format-SemVersion`, `Get-TagIntersection`, `Get-HostnameFromUrl`, `Test-DependencyConfiguration`, `Get-AbsoluteBasePath`, `Export-CheckoutResults`.
 
 ### Integration Tests
 
@@ -277,7 +277,7 @@ pwsh -File ./LsiGitCheckout.ps1 -InputFile tests/semver-basic/dependencies.json
 
 ```powershell
 pwsh
-Set-PSBreakpoint -Script ./LsiGitCheckout.psm1 -Command Process-DependencyFile
+Set-PSBreakpoint -Script ./LsiGitCheckout.psm1 -Command Invoke-DependencyFile
 ./LsiGitCheckout.ps1 -InputFile tests/semver-basic/dependencies.json
 ```
 
@@ -309,7 +309,7 @@ See [testing_infrastructure.md](testing_infrastructure.md) for the full test arc
 See [CLAUDE.md](../CLAUDE.md) for the full coding conventions. Key points:
 
 - **PowerShell 7.6 LTS** — use `??` null-coalescing, `-AsHashtable` for JSON, etc.
-- **Function names**: `Verb-Noun` PascalCase (e.g., `Test-GitInstalled`, `Parse-VersionPattern`)
+- **Function names**: `Verb-Noun` PascalCase using approved PowerShell verbs (e.g., `Test-GitInstalled`, `ConvertTo-VersionPattern`)
 - **Logging**: always use `Write-Log` with appropriate level, never raw `Write-Host`
 - **Error handling**: wrap operations in `Invoke-WithErrorContext -Context "description" -ScriptBlock { ... }`
 - **Module state**: use `$script:` prefix for shared variables, initialize via `Initialize-LsiGitCheckout`

tests/LsiGitCheckout.Integration.Tests.ps1

@@ -145,7 +145,7 @@ Describe 'LsiGitCheckout Integration Tests' -Tag 'Integration' {
         $result.schemaVersion | Should -Be '1.0.0'
 
         # Metadata
-        $result.metadata.toolVersion | Should -Be '8.0.0'
+        $result.metadata.toolVersion | Should -Be '8.0.1'
         $result.metadata.recursiveMode | Should -Be $true
         $result.metadata.apiCompatibility | Should -BeIn @('Strict', 'Permissive')
         $result.metadata.powershellVersion | Should -Not -BeNullOrEmpty