Prepare publishing to PSGallery

Author: PhysShell

.github/workflows/publish.yml

@@ -12,6 +12,24 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
+      - name: Install Dependencies
+        shell: pwsh
+        run: |
+          if (-not (Get-PackageProvider -Name NuGet -ErrorAction SilentlyContinue)) {
+            Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Scope CurrentUser -Force
+          }
+          Set-PSRepository PSGallery -InstallationPolicy Trusted
+          Install-Module PSScriptAnalyzer -Scope CurrentUser -RequiredVersion 1.22.0 -Force
+          Install-Module Pester -Scope CurrentUser -RequiredVersion 5.7.1 -Force
+          Install-Module posh-git -Scope CurrentUser -Force
+          Install-Module git-aliases -Scope CurrentUser -Force
+          Install-Module PowerShellGet -Scope CurrentUser -RequiredVersion 2.2.5 -Force
+
+      - name: Run Lint and Tests
+        shell: pwsh
+        run: |
+          .\tools\ci.ps1
+
       - name: Validate Module Version Against Tag
         if: startsWith(github.ref, 'refs/tags/v')
         shell: pwsh
@@ -22,14 +40,21 @@ jobs:
             throw "Manifest version '$($manifest.Version)' does not match tag version '$tagVersion'."
           }
 
-      - name: Install PowerShellGet
+      - name: Validate and Stage Release Notes
         shell: pwsh
         run: |
-          if (-not (Get-PackageProvider -Name NuGet -ErrorAction SilentlyContinue)) {
-            Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Scope CurrentUser -Force
+          $manifestPath = Resolve-Path -LiteralPath .\git-aliases-extra.psd1 |
+            Select-Object -ExpandProperty Path -First 1
+          $manifest = Test-ModuleManifest -Path $manifestPath -ErrorAction Stop
+          $moduleVersion = $manifest.Version.ToString()
+
+          $releaseNotes = .\tools\get-release-notes.ps1 -Version $moduleVersion
+          if (-not $releaseNotes) {
+            throw "Release notes for version '$moduleVersion' are empty."
           }
-          Set-PSRepository PSGallery -InstallationPolicy Trusted
-          Install-Module PowerShellGet -Scope CurrentUser -Force
+
+          Update-ModuleManifest -Path $manifestPath -ReleaseNotes $releaseNotes
+          Write-Host "Release notes for version '$moduleVersion' loaded from CHANGELOG.md."
 
       - name: Publish to PSGallery
         shell: pwsh

CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on Keep a Changelog and the project uses Semantic Versioning.
+
+## [0.1.0] - 2026-02-19
+
+### Added
+
+- Standalone `git-aliases-extra` module extracted from dotfiles.
+- Extended git alias completion for custom aliases and long options.
+- `gsw` fallback logic for remote-only branch switching edge cases.
+- `gfp` helper for `git format-patch --cover-letter --stat --stdout`.
+- Worktree aliases with completion support for worktree paths.
+- Lint, test, CI workflows, and local hook installation scripts.
+
+### Changed
+
+- Renamed module from `GitAliases.Extras` to `git-aliases-extra`.

README.md

@@ -287,8 +287,9 @@ This repository includes:
 To publish from CI:
 
 1. Add repository secret `PSGALLERY_API_KEY`.
-2. Bump `ModuleVersion` in `git-aliases-extra.psd1`.
-3. Push a tag `v<ModuleVersion>` (for example, `v0.1.0`) or run the publish workflow manually.
+2. Add release notes to `CHANGELOG.md` under `## [<ModuleVersion>] - YYYY-MM-DD`.
+3. Bump `ModuleVersion` in `git-aliases-extra.psd1`.
+4. Push a tag `v<ModuleVersion>` (for example, `v0.1.0`) or run the publish workflow manually.
 
 ## What CI checks
 
@@ -300,4 +301,4 @@ To publish from CI:
 
 ## License
 
-WTFPL. See `LICENSE`.
+WTFPL. See `LICENSE`.

assets/icon.png

@@ -4,9 +4,10 @@
     GUID = 'a5c2859e-7dce-4853-9db5-8cb7927dbdda'
     Author = 'PhysShell'
     CompanyName = ''
-    Copyright = 'Copyright (c) PhysShell.'
+    Copyright = 'Copyright (c) PhysShell 2026.'
     Description = 'Custom git aliases and robust tab completion helpers for PowerShell.'
     PowerShellVersion = '5.1'
+    HelpInfoURI = 'https://github.com/PhysShell/git-aliases-extra'
     CompatiblePSEditions = @('Desktop', 'Core')
     FunctionsToExport = @(
         'Test-InGitRepo',
@@ -52,11 +53,14 @@
     RequiredModules = @('posh-git', 'git-aliases')
     PrivateData = @{
         PSData = @{
-            Tags = @('git', 'aliases', 'completion', 'posh-git', 'powershell')
+            Tags = @('git', 'aliases', 'completion', 'posh-git', 'powershell', 'worktree')
             ProjectUri = 'https://github.com/PhysShell/git-aliases-extra'
             LicenseUri = 'https://github.com/PhysShell/git-aliases-extra/blob/main/LICENSE'
+            IconUri = 'https://raw.githubusercontent.com/PhysShell/git-aliases-extra/main/assets/icon.png'
             RepositorySourceLocation = 'https://github.com/PhysShell/git-aliases-extra'
-            ReleaseNotes = 'Standalone module extracted from dotfiles.'
+            ReleaseNotes = 'See CHANGELOG.md for release notes.'
+            ExternalModuleDependencies = @('posh-git', 'git-aliases')
+            RequireLicenseAcceptance = $false
         }
     }
 }

git-aliases-extra.psd1

@@ -27,6 +27,9 @@ Describe 'git-aliases-extra manifest' {
         $manifest = Import-PowerShellDataFile -Path $script:ModuleManifest
         $manifest.PrivateData.PSData.ProjectUri | Should -Match '^https://github.com/PhysShell/git-aliases-extra'
         $manifest.PrivateData.PSData.LicenseUri | Should -Match '/LICENSE$'
+        $manifest.PrivateData.PSData.IconUri | Should -Match '/assets/icon\.png$'
+        $manifest.PrivateData.PSData.ReleaseNotes | Should -Not -BeNullOrEmpty
+        $manifest.Copyright | Should -Match '\b\d{4}\b'
 
         $requiredModuleNames = @($manifest.RequiredModules | ForEach-Object {
             if ($_ -is [string]) { $_ } else { $_.ModuleName }
@@ -56,4 +59,18 @@ Describe 'git-aliases-extra tooling' {
         (Test-Path -LiteralPath (Join-Path $script:RepoRoot 'tools\hooks\pre-commit')) | Should -BeTrue
         (Test-Path -LiteralPath (Join-Path $script:RepoRoot 'tools\hooks\commit-msg')) | Should -BeTrue
     }
+
+    It 'includes changelog, icon and release notes helper script' {
+        (Test-Path -LiteralPath (Join-Path $script:RepoRoot 'CHANGELOG.md')) | Should -BeTrue
+        (Test-Path -LiteralPath (Join-Path $script:RepoRoot 'assets\icon.png')) | Should -BeTrue
+        (Test-Path -LiteralPath (Join-Path $script:RepoRoot 'tools\get-release-notes.ps1')) | Should -BeTrue
+    }
+
+    It 'resolves release notes from changelog for manifest version' {
+        $manifest = Test-ModuleManifest -Path $script:ModuleManifest -ErrorAction Stop
+        $version = $manifest.Version.ToString()
+        $scriptPath = Join-Path $script:RepoRoot 'tools\get-release-notes.ps1'
+        $notes = & $scriptPath -Version $version
+        $notes | Should -Not -BeNullOrEmpty
+    }
 }

tests/git-aliases-extra.Module.Tests.ps1

@@ -0,0 +1,54 @@
+[CmdletBinding()]
+param(
+    [Parameter(Mandatory = $true)]
+    [string]$Version,
+
+    [string]$ChangelogPath = ''
+)
+
+$ErrorActionPreference = 'Stop'
+Set-StrictMode -Version Latest
+
+if (-not $ChangelogPath) {
+    $ChangelogPath = Resolve-Path -LiteralPath (Join-Path $PSScriptRoot '..\CHANGELOG.md') |
+        Select-Object -ExpandProperty Path -First 1
+}
+
+if (-not (Test-Path -LiteralPath $ChangelogPath)) {
+    throw "Changelog not found: $ChangelogPath"
+}
+
+[string[]]$lines = Get-Content -LiteralPath $ChangelogPath
+[string]$escapedVersion = [Regex]::Escape($Version)
+[string]$versionHeaderPattern = "^##\s+\[$escapedVersion\]\s+-\s+\d{4}-\d{2}-\d{2}\s*$"
+
+[int]$startIndex = -1
+for ($i = 0; $i -lt $lines.Count; $i++) {
+    if ($lines[$i] -match $versionHeaderPattern) {
+        $startIndex = $i
+        break
+    }
+}
+
+if ($startIndex -lt 0) {
+    throw "No changelog section found for version '$Version' in '$ChangelogPath'."
+}
+
+[int]$endIndex = $lines.Count
+for ($i = $startIndex + 1; $i -lt $lines.Count; $i++) {
+    if ($lines[$i] -match '^##\s+\[') {
+        $endIndex = $i
+        break
+    }
+}
+
+if ($endIndex -le ($startIndex + 1)) {
+    throw "Changelog section for version '$Version' is empty."
+}
+
+[string]$notes = ($lines[($startIndex + 1)..($endIndex - 1)] -join [Environment]::NewLine).Trim()
+if (-not $notes) {
+    throw "Changelog section for version '$Version' is empty."
+}
+
+$notes