Reflect renaming GitAliases.Extra submodule

Author: PhysShell

.gitmodules

@@ -1,4 +1,4 @@
-[submodule "modules/GitAliases.Extras"]
-	path = modules/GitAliases.Extras
-	url = git@github.com:PhysShell/GitAliases.Extras.git
+[submodule "modules/git-aliases-extra"]
+	path = modules/git-aliases-extra
+	url = git@github.com:PhysShell/git-aliases-extra.git
 	branch = main

README.md

@@ -1,5 +1,19 @@
 # dotfiles
 
+## Breaking Changes (2026-02-19)
+
+- Renamed submodule path: `modules/GitAliases.Extras` -> `modules/git-aliases-extra`
+- Renamed migration script: `tools/migrate-gitaliases-extras.ps1` -> `tools/migrate-git-aliases-extra.ps1`
+- Existing local git hooks may still point to the old path and fail
+
+Migration steps:
+
+```powershell
+git submodule sync --recursive
+git submodule update --init --recursive
+.\tools\install-hooks.ps1
+```
+
 ## Profile installation
 
 Put this in `$PROFILE.CurrentUserAllHosts`:
@@ -41,28 +55,28 @@ Install local git hooks:
 Installed hooks:
 - `pre-commit` (lightweight no-op)
 - `commit-msg` (runs `tools/ci.ps1`)
-- hook logic is sourced from `modules/GitAliases.Extras/tools/hooks/*` to avoid duplication
+- hook logic is sourced from `modules/git-aliases-extra/tools/hooks/*` to avoid duplication
 
 Checks are skipped when:
 - commit message contains `[skip precommit hook]` or `[skip pch]`
 - there are no working tree changes (for example, `git commit --allow-empty ...`)
 
-## Extract GitAliases.Extras
+## Extract git-aliases-extra
 
-Recommended approach: keep this as dotfiles repo and move `modules/GitAliases.Extras` to its own repository, then consume it via git submodule at the same path.
+Recommended approach: keep this as dotfiles repo and move `modules/git-aliases-extra` to its own repository, then consume it via git submodule at the same path.
 
 Safe migration flow:
 
 1. Run a dry run:
 
 ```powershell
-.\tools\migrate-gitaliases-extras.ps1 -SubmoduleUrl 'git@github.com:<you>/GitAliases.Extras.git' -SubmoduleBranch main -PushSplit
+.\tools\migrate-git-aliases-extra.ps1 -SubmoduleUrl 'git@github.com:<you>/git-aliases-extra.git' -SubmoduleBranch main -PushSplit
 ```
 
 2. Apply the migration:
 
 ```powershell
-.\tools\migrate-gitaliases-extras.ps1 -SubmoduleUrl 'git@github.com:<you>/GitAliases.Extras.git' -SubmoduleBranch main -PushSplit -Apply
+.\tools\migrate-git-aliases-extra.ps1 -SubmoduleUrl 'git@github.com:<you>/git-aliases-extra.git' -SubmoduleBranch main -PushSplit -Apply
 ```
 
 3. Commit resulting changes in this repo (`.gitmodules` + submodule pointer).
@@ -71,12 +85,12 @@ Notes:
 - `bootstrap.ps1` now initializes submodules automatically if `.gitmodules` exists.
 - `profile.ps1` warns with the exact `git submodule update --init --recursive` command if submodules were not initialized.
 
-P.S. You can also install just [GitAliases.Extras](https://github.com/PhysShell/GitAliases.Extras) without dotfiles as standalone powershell package
+P.S. You can also install just [git-aliases-extra](https://github.com/PhysShell/git-aliases-extra) without dotfiles as standalone powershell package
 
 ## What CI checks
 
 - `PSScriptAnalyzer` linting with `PSScriptAnalyzerSettings.psd1`
-- `Pester` tests in `tests\` plus `modules\GitAliases.Extras\tests\`
+- `Pester` tests in `tests\` plus `modules\git-aliases-extra\tests\`
 - GitHub Actions matrix on:
   - Windows PowerShell 5.1
   - PowerShell 7

modules/GitAliases.Extras

@@ -41,7 +41,7 @@ if (Get-Module -ListAvailable -Name PSReadLine) {
 }
 
 # --- Add your custom modules directory to the PSModulePath ---
-# This ensures PowerShell can find your 'GitAliases.Extras' module.
+# This ensures PowerShell can find your 'git-aliases-extra' module.
 $dotFilesRoot = Split-Path -Parent $MyInvocation.MyCommand.Path
 $dotModules = Join-Path $dotFilesRoot 'modules'
 $sep = [IO.Path]::PathSeparator
@@ -64,16 +64,16 @@ if (Get-Command g -CommandType Function -ErrorAction SilentlyContinue) {
 }
 Set-Alias -Name g -Value git -Force
 
-# 3. GitAliases.Extras: Your custom module that DEPENDS on posh-git.
+# 3. git-aliases-extra: Your custom module that DEPENDS on posh-git.
 # It finds all aliases and registers the proxy completer.
-$extrasManifest = Join-Path $dotFilesRoot 'modules\GitAliases.Extras\GitAliases.Extras.psd1'
-if (-not (Get-Module -Name GitAliases.Extras -ErrorAction SilentlyContinue)) {
+$extrasManifest = Join-Path $dotFilesRoot 'modules\git-aliases-extra\git-aliases-extra.psd1'
+if (-not (Get-Module -Name git-aliases-extra -ErrorAction SilentlyContinue)) {
   if (Test-Path -LiteralPath $extrasManifest) {
-    Import-Module $extrasManifest -ErrorAction Stop
+    Import-Module $extrasManifest -DisableNameChecking -ErrorAction Stop
   } elseif (Test-Path -LiteralPath (Join-Path $dotFilesRoot '.gitmodules')) {
-    Write-Warning "GitAliases.Extras is missing. Initialize submodules: git -C '$dotFilesRoot' submodule update --init --recursive"
+    Write-Warning "git-aliases-extra is missing. Initialize submodules: git -C '$dotFilesRoot' submodule update --init --recursive"
   } else {
-    Write-Warning "GitAliases.Extras module not found at '$extrasManifest'."
+    Write-Warning "git-aliases-extra module not found at '$extrasManifest'."
   }
 }
 

modules/git-aliases-extra

@@ -56,7 +56,7 @@ BeforeAll {
 Set-Content -Path '.git/ci-ran' -Value 'ran' -NoNewline -Encoding ascii
 '@ | Set-Content -Path $ciScriptPath -Encoding ascii
 
-        $moduleHooksPath = Join-Path $repoPath 'modules\GitAliases.Extras\tools\hooks'
+        $moduleHooksPath = Join-Path $repoPath 'modules\git-aliases-extra\tools\hooks'
         New-Item -ItemType Directory -Path $moduleHooksPath -Force | Out-Null
         Copy-Item -Path $script:ModulePreCommitHookSource -Destination (Join-Path $moduleHooksPath 'pre-commit') -Force
         Copy-Item -Path $script:ModuleCommitMsgHookSource -Destination (Join-Path $moduleHooksPath 'commit-msg') -Force
@@ -80,8 +80,8 @@ Set-Content -Path '.git/ci-ran' -Value 'ran' -NoNewline -Encoding ascii
         Select-Object -ExpandProperty Path -First 1
     $script:PreCommitHookSource = Join-Path $script:RepoRoot 'tools\hooks\pre-commit'
     $script:CommitMsgHookSource = Join-Path $script:RepoRoot 'tools\hooks\commit-msg'
-    $script:ModulePreCommitHookSource = Join-Path $script:RepoRoot 'modules\GitAliases.Extras\tools\hooks\pre-commit'
-    $script:ModuleCommitMsgHookSource = Join-Path $script:RepoRoot 'modules\GitAliases.Extras\tools\hooks\commit-msg'
+    $script:ModulePreCommitHookSource = Join-Path $script:RepoRoot 'modules\git-aliases-extra\tools\hooks\pre-commit'
+    $script:ModuleCommitMsgHookSource = Join-Path $script:RepoRoot 'modules\git-aliases-extra\tools\hooks\commit-msg'
 }
 
 Describe 'commit hooks integration' {

profile.ps1

@@ -42,19 +42,19 @@ BeforeAll {
         $tempRoot = Join-Path ([IO.Path]::GetTempPath()) ($Prefix + '-' + [guid]::NewGuid().Guid)
         $repoPath = Join-Path $tempRoot 'repo'
         $toolsPath = Join-Path $repoPath 'tools'
-        $modulePath = Join-Path $repoPath 'modules\GitAliases.Extras'
+        $modulePath = Join-Path $repoPath 'modules\git-aliases-extra'
 
         New-Item -ItemType Directory -Path $toolsPath -Force | Out-Null
         New-Item -ItemType Directory -Path $modulePath -Force | Out-Null
 
-        Copy-Item -Path $script:MigrationScriptSource -Destination (Join-Path $toolsPath 'migrate-gitaliases-extras.ps1') -Force
+        Copy-Item -Path $script:MigrationScriptSource -Destination (Join-Path $toolsPath 'migrate-git-aliases-extra.ps1') -Force
 
         Invoke-GitForMigrationTests -RepoPath $repoPath -Arguments @('init') | Out-Null
         Invoke-GitForMigrationTests -RepoPath $repoPath -Arguments @('config', 'user.email', 'test@example.com') | Out-Null
         Invoke-GitForMigrationTests -RepoPath $repoPath -Arguments @('config', 'user.name', 'Test User') | Out-Null
         Invoke-GitForMigrationTests -RepoPath $repoPath -Arguments @('config', 'commit.gpgsign', 'false') | Out-Null
 
-        Set-Content -Path (Join-Path $modulePath 'GitAliases.Extras.psm1') -Value "function gsw { 'ok' }" -NoNewline -Encoding ascii
+        Set-Content -Path (Join-Path $modulePath 'git-aliases-extra.psm1') -Value "function gsw { 'ok' }" -NoNewline -Encoding ascii
         Invoke-GitForMigrationTests -RepoPath $repoPath -Arguments @('add', '.') | Out-Null
         Invoke-GitForMigrationTests -RepoPath $repoPath -Arguments @('commit', '-m', 'init module') | Out-Null
 
@@ -66,24 +66,24 @@ BeforeAll {
 
     [string]$script:RepoRoot = Resolve-Path -LiteralPath (Join-Path $PSScriptRoot '..') |
         Select-Object -ExpandProperty Path -First 1
-    $script:MigrationScriptSource = Join-Path $script:RepoRoot 'tools\migrate-gitaliases-extras.ps1'
+    $script:MigrationScriptSource = Join-Path $script:RepoRoot 'tools\migrate-git-aliases-extra.ps1'
 }
 
-Describe 'migrate-gitaliases-extras script' {
+Describe 'migrate-git-aliases-extra script' {
     It 'dry run succeeds and does not modify repository layout' -Skip:(-not (Get-Command git -ErrorAction SilentlyContinue)) {
         $context = New-MigrationTestRepository -Prefix 'migration-dry-run'
         try {
             Push-Location $context.RepoPath
             try {
-                $output = & pwsh -NoProfile -File '.\tools\migrate-gitaliases-extras.ps1' -SubmoduleUrl 'git@github.com:example/GitAliases.Extras.git' 2>&1
+                $output = & pwsh -NoProfile -File '.\tools\migrate-git-aliases-extra.ps1' -SubmoduleUrl 'git@github.com:example/git-aliases-extra.git' 2>&1
                 $exitCode = $LASTEXITCODE
             } finally {
                 Pop-Location
             }
 
             $exitCode | Should -Be 0
             (($output | Out-String) -match 'Dry run complete') | Should -BeTrue
-            (Test-Path -LiteralPath (Join-Path $context.RepoPath 'modules\GitAliases.Extras\GitAliases.Extras.psm1')) | Should -BeTrue
+            (Test-Path -LiteralPath (Join-Path $context.RepoPath 'modules\git-aliases-extra\git-aliases-extra.psm1')) | Should -BeTrue
             (Test-Path -LiteralPath (Join-Path $context.RepoPath '.gitmodules')) | Should -BeFalse
         } finally {
             if (Test-Path -LiteralPath $context.TempRoot) {
@@ -99,7 +99,7 @@ Describe 'migrate-gitaliases-extras script' {
 
             Push-Location $context.RepoPath
             try {
-                $output = & pwsh -NoProfile -File '.\tools\migrate-gitaliases-extras.ps1' -SubmoduleUrl 'git@github.com:example/GitAliases.Extras.git' 2>&1
+                $output = & pwsh -NoProfile -File '.\tools\migrate-git-aliases-extra.ps1' -SubmoduleUrl 'git@github.com:example/git-aliases-extra.git' 2>&1
                 $exitCode = $LASTEXITCODE
             } finally {
                 Pop-Location

tests/GitHooks.Tests.ps1

@@ -1,7 +1,7 @@
 #!/bin/sh
 set -e
 
-module_hook="modules/GitAliases.Extras/tools/hooks/commit-msg"
+module_hook="modules/git-aliases-extra/tools/hooks/commit-msg"
 if [ ! -f "$module_hook" ]; then
   echo "commit-msg: missing '$module_hook'"
   echo "Initialize submodules: git submodule update --init --recursive"

tests/MigrationScript.Tests.ps1

@@ -1,7 +1,7 @@
 #!/bin/sh
 set -e
 
-module_hook="modules/GitAliases.Extras/tools/hooks/pre-commit"
+module_hook="modules/git-aliases-extra/tools/hooks/pre-commit"
 if [ ! -f "$module_hook" ]; then
   echo "pre-commit: missing '$module_hook'"
   echo "Initialize submodules: git submodule update --init --recursive"

tools/hooks/commit-msg

@@ -3,7 +3,7 @@ param(
     [Parameter(Mandatory = $true)]
     [string]$SubmoduleUrl,
     [string]$SubmoduleBranch = 'main',
-    [string]$ModulePath = 'modules/GitAliases.Extras',
+    [string]$ModulePath = 'modules/git-aliases-extra',
     [switch]$PushSplit,
     [switch]$Apply,
     [switch]$AllowDirty
@@ -72,7 +72,7 @@ if ($PushSplit) {
 if (-not $Apply) {
     Write-Host ''
     Write-Host 'Dry run complete. Next command:'
-    Write-Host ("  .\tools\migrate-gitaliases-extras.ps1 -SubmoduleUrl '{0}' -SubmoduleBranch '{1}' -PushSplit -Apply" -f $SubmoduleUrl, $SubmoduleBranch)
+    Write-Host ("  .\tools\migrate-git-aliases-extra.ps1 -SubmoduleUrl '{0}' -SubmoduleBranch '{1}' -PushSplit -Apply" -f $SubmoduleUrl, $SubmoduleBranch)
     Write-Host ''
     Write-Host 'This will:'
     Write-Host ("  1) keep history via subtree split for {0}" -f $ModulePath)
@@ -94,4 +94,4 @@ Write-Host ''
 Write-Host 'Migration completed.'
 Write-Host 'Review and commit:'
 Write-Host '  git status'
-Write-Host "  git commit -m 'Extract GitAliases.Extras to submodule'"
+Write-Host "  git commit -m 'Extract git-aliases-extra to submodule'"