feat(#140): enhance release automation and CI support

- Update `Update-NovaModuleVersion -ContinuousIntegration` to fallback to a patch bump when `HEAD` matches the latest tag
- Fix PSGallery publishing on fresh CI runners by bootstrapping the PSResourceGet repository store
- Add `Get-PSResourceRepositoryStoreDirectory` and `Initialize-PSGalleryRepository` functions

Author: stiwicourage

CHANGELOG.md

@@ -89,6 +89,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
     - CI bump now reuses the already activated built-module command when the current session is already running from
       `dist/`, so publish-then-bump prerelease automation can continue in the same session without losing private helper
       bindings.
+  - `Update-NovaModuleVersion -ContinuousIntegration` now also falls back to a patch bump when `HEAD` already matches
+    the latest tag, so release automation can prepare the next prerelease version without requiring an extra commit.
 - Keep standalone `nova bump` output stable by formatting version-update results in the CLI layer instead of relying on
   PowerShell's default object rendering.
     - `nova bump --what-if` and `% run.ps1` now surface a predictable summary for previous version, new version, label,
@@ -104,6 +106,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
       failing during parameter binding.
 - Fix configuration and validation errors so empty `project.json` files and unsupported `Manifest` keys fail fast with
   clear messages.
+- Fix semantic-release PSGallery publishing on fresh CI runners by bootstrapping the PSResourceGet repository store
+  before
+  `Publish-PSResource` runs.
 
 ### Changed
 

README.md

@@ -209,6 +209,9 @@ These switches keep the behavior explicit and opt-in:
 
 - `Invoke-NovaBuild -ContinuousIntegration` re-imports the freshly built module after the build succeeds
 - `Update-NovaModuleVersion -ContinuousIntegration` re-imports the built module before the bump workflow starts
+- `Update-NovaModuleVersion -ContinuousIntegration` also falls back to a patch bump when the current `HEAD` already
+  matches the latest tag, so release automation can seed the next prerelease line without requiring an extra commit
+  first
 - `Publish-NovaModule -ContinuousIntegration` restores the built module after publish completes
 - `Invoke-NovaRelease -ContinuousIntegration` forwards that CI intent through the nested build/bump boundaries and then
   restores the built module again after publish
@@ -595,6 +598,11 @@ Responsibilities currently covered by the release pipeline include:
 - creating GitHub releases
 - publishing to PowerShell Gallery
 
+The semantic-release publish script also bootstraps the local PSResourceGet repository store before calling
+`Publish-PSResource`, which keeps fresh GitHub Actions runners from failing when the PSGallery repository registration
+file
+does not exist yet.
+
 ### Where NovaModuleTools cmdlets fit
 
 NovaModuleTools already provides strong release building blocks:

scripts/release/Publish-ToPSGallery.ps1

@@ -4,6 +4,10 @@ param(
 )
 
 Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+$scriptRoot = Split-Path -Parent $MyInvocation.MyCommand.Path
+. (Join-Path $scriptRoot 'SemanticReleaseSupport.ps1')
 
 if ([string]::IsNullOrWhiteSpace($ApiKey)) {
     throw 'PSGALLERY_API environment variable is required.'
@@ -13,4 +17,5 @@ if (-not (Test-Path -LiteralPath $ModulePath)) {
     throw "Module path not found: $ModulePath"
 }
 
-Publish-PSResource -Path $ModulePath -Repository PSGallery -ApiKey $ApiKey -Verbose
+Initialize-PSGalleryRepository
+Publish-PSResource -Path $ModulePath -Repository PSGallery -ApiKey $ApiKey -Verbose -ErrorAction Stop

scripts/release/SemanticReleaseSupport.ps1

@@ -4,6 +4,8 @@ $script:supportRoot = Join-Path (Split-Path -Parent $MyInvocation.MyCommand.Path
 $script:supportFileList = @(
     'Get-ReleaseDateString.ps1'
     'Get-ReleaseRepositoryUrl.ps1'
+    'Get-PSResourceRepositoryStoreDirectory.ps1'
+    'Initialize-PSGalleryRepository.ps1'
     'ConvertTo-ReleaseTagName.ps1'
     'Read-JsonFile.ps1'
     'Write-JsonFile.ps1'

scripts/release/support/Get-PSResourceRepositoryStoreDirectory.ps1

@@ -0,0 +1,7 @@
+function Get-PSResourceRepositoryStoreDirectory {
+    [CmdletBinding()]
+    param()
+
+    return Join-Path $HOME '.local/share/PSResourceGet'
+}
+

scripts/release/support/Initialize-PSGalleryRepository.ps1

@@ -0,0 +1,14 @@
+function Initialize-PSGalleryRepository {
+    [CmdletBinding()]
+    param()
+
+    $storeDirectory = Get-PSResourceRepositoryStoreDirectory
+    if (-not (Test-Path -LiteralPath $storeDirectory)) {
+        New-Item -ItemType Directory -Path $storeDirectory -Force | Out-Null
+    }
+
+    if ($null -eq (Get-PSResourceRepository -Name PSGallery -ErrorAction SilentlyContinue)) {
+        Register-PSResourceRepository -PSGallery
+    }
+}
+

src/private/release/GetNovaVersionLabelForBump.ps1

@@ -2,7 +2,8 @@ function Get-NovaVersionLabelForBump {
     [CmdletBinding()]
     param(
         [Parameter(Mandatory)][string]$ProjectRoot,
-        [string[]]$CommitMessages = @()
+        [string[]]$CommitMessages = @(),
+        [switch]$ContinuousIntegrationRequested
     )
 
     if ($CommitMessages.Count -gt 0) {
@@ -18,6 +19,10 @@ function Get-NovaVersionLabelForBump {
     }
 
     if (-not (Test-GitRepositoryHasCommitsSinceLatestTag -ProjectRoot $ProjectRoot)) {
+        if ($ContinuousIntegrationRequested) {
+            return 'Patch'
+        }
+
         Stop-NovaOperation -Message 'Cannot bump version because there are no commits since the latest tag.' -ErrorId 'Nova.Workflow.NoCommitsSinceLatestTag' -Category InvalidOperation -TargetObject $ProjectRoot
     }
 

src/private/release/GetNovaVersionUpdateWorkflowContext.ps1

@@ -8,7 +8,7 @@ function Get-NovaVersionUpdateWorkflowContext {
 
     $projectInfo = Get-NovaProjectInfo -Path $ProjectRoot
     $commitMessages = @(Get-GitCommitMessageForVersionBump -ProjectRoot $ProjectRoot)
-    $label = Get-NovaVersionLabelForBump -ProjectRoot $ProjectRoot -CommitMessages $commitMessages
+    $label = Get-NovaVersionLabelForBump -ProjectRoot $ProjectRoot -CommitMessages $commitMessages -ContinuousIntegrationRequested:$ContinuousIntegrationRequested
     $versionUpdatePlan = Get-NovaVersionUpdatePlan -ProjectInfo $projectInfo -Label $label -PreviewRelease:$PreviewRelease
 
     return Get-NovaVersionUpdateWorkflowContextObject -ProjectRoot $ProjectRoot -ProjectInfo $projectInfo -CommitMessages $commitMessages -Label $label -VersionUpdatePlan $versionUpdatePlan -PreviewRelease:$PreviewRelease -ContinuousIntegrationRequested:$ContinuousIntegrationRequested

tests/CoverageGaps.ReleaseInternals.Tests.ps1

@@ -620,6 +620,33 @@ Describe 'Coverage gaps for release and git internals' {
         }
     }
 
+    It 'Get-NovaVersionLabelForBump returns Patch in CI mode when the current head already matches the latest tag' {
+        InModuleScope $script:moduleName {
+            $projectRoot = Join-Path $TestDrive 'mocked-ci-git-state'
+            New-Item -ItemType Directory -Path (Join-Path $projectRoot '.git') -Force | Out-Null
+
+            Mock Invoke-NovaGitCommand {
+                switch ($Arguments[0]) {
+                    'rev-parse' {
+                        return [pscustomobject]@{ExitCode = 0; Output = @('.git')}
+                    }
+                    'describe' {
+                        return [pscustomobject]@{ExitCode = 0; Output = @('v1.0.0')}
+                    }
+                    'rev-list' {
+                        return [pscustomobject]@{ExitCode = 0; Output = @('0')}
+                    }
+                    default {
+                        throw "Unexpected git args: $( $Arguments -join ' ' )"
+                    }
+                }
+            }
+
+            Get-NovaVersionLabelForBump -ProjectRoot $projectRoot -ContinuousIntegrationRequested | Should -Be 'Patch'
+            Assert-MockCalled Invoke-NovaGitCommand -Times 1 -ParameterFilter {$Arguments[0] -eq 'rev-list' -and $Arguments[2] -eq 'v1.0.0..HEAD'}
+        }
+    }
+
     It 'Get-NovaVersionLabelForBump returns Patch when the repository has commits but no tags yet' {
         InModuleScope $script:moduleName {
             $projectRoot = Join-Path $TestDrive 'mocked-git-without-tags'

tests/NovaCommandModel.BumpAndCli.Tests.ps1

@@ -133,6 +133,10 @@ Describe 'Nova command model - bump and CLI confirmation behavior' {
             $result = Get-NovaVersionUpdateWorkflowContext -ProjectRoot '/tmp/project' -ContinuousIntegrationRequested
 
             $result.'ContinuousIntegrationRequested' | Should -BeTrue
+            Assert-MockCalled Get-NovaVersionLabelForBump -Times 1 -ParameterFilter {
+                $ProjectRoot -eq '/tmp/project' -and
+                        $ContinuousIntegrationRequested
+            }
         }
     }
 
@@ -524,6 +528,36 @@ Describe 'Nova command model - bump and CLI confirmation behavior' {
         }
     }
 
+    It 'Update-NovaModuleVersion -Preview -ContinuousIntegration -WhatIf still bumps from a tagged head with no new commits' -Skip:(-not [bool](Get-Command git -ErrorAction SilentlyContinue)) {
+        InModuleScope $script:moduleName {
+            $projectRoot = Join-Path $TestDrive 'tagged-head-ci-bump-project'
+            New-Item -ItemType Directory -Path $projectRoot -Force | Out-Null
+            & git -C $projectRoot init --quiet | Out-Null
+            & git -C $projectRoot config user.name 'NovaModuleTools Tests' | Out-Null
+            & git -C $projectRoot config user.email 'tests@example.invalid' | Out-Null
+            Set-Content -LiteralPath (Join-Path $projectRoot 'first.txt') -Value 'first' -Encoding utf8
+            & git -C $projectRoot add first.txt | Out-Null
+            & git -C $projectRoot commit --quiet -m 'feat: initial release' | Out-Null
+            & git -C $projectRoot tag v2.0.0 | Out-Null
+
+            Mock Get-NovaProjectInfo {
+                [pscustomobject]@{
+                    Version = '2.0.0'
+                    ProjectJSON = (Join-Path $projectRoot 'project.json')
+                }
+            }
+            Mock Set-NovaModuleVersion {throw 'WhatIf should not write project.json'}
+
+            $result = Update-NovaModuleVersion -Path $projectRoot -Preview -ContinuousIntegration -WhatIf
+
+            $result.PreviousVersion | Should -Be '2.0.0'
+            $result.NewVersion | Should -Be '2.0.1-preview'
+            $result.Label | Should -Be 'Patch'
+            $result.CommitCount | Should -Be 0
+            Assert-MockCalled Set-NovaModuleVersion -Times 0
+        }
+    }
+
     It 'Update-NovaModuleVersion keeps native PowerShell Confirm support for direct cmdlet usage and does not route through the CLI helper' {
         InModuleScope $script:moduleName {
             $command = Get-Command -Name 'Update-NovaModuleVersion' -CommandType Function -ErrorAction Stop