feat(#146): enhance Nova CLI bump command with warning message handling

- Implemented Invoke-NovaCliBumpCommand to manage version bump warnings
- Added Write-NovaCliCapturedWarning and Get-NovaCliReplayWarningMessage functions for warning message processing
- Updated tests to verify major-zero advisory message formatting

Author: stiwicourage

src/private/cli/InvokeNovaCliCommandRoute.ps1

@@ -39,6 +39,62 @@ function Invoke-NovaCliParsedCommand {
     return & $ActionCommand @options @mutatingCommonParameters
 }
 
+function Invoke-NovaCliBumpCommand {
+    [CmdletBinding()]
+    param(
+        [Parameter(Mandatory)][pscustomobject]$InvocationContext
+    )
+
+    $warningMessages = @()
+    $result = Invoke-NovaCliParsedCommand -InvocationContext $InvocationContext -ParserCommand 'ConvertFrom-NovaBumpCliArgument' -ActionCommand 'Update-NovaModuleVersion' -WarningAction SilentlyContinue -WarningVariable warningMessages
+    Write-NovaCliCapturedWarning -WarningMessages $warningMessages -SkippedMessage (Get-NovaCliVersionUpdateAdvisoryMessage -Result $result)
+    return $result
+}
+
+function Write-NovaCliCapturedWarning {
+    [CmdletBinding()]
+    param(
+        [object[]]$WarningMessages = @(),
+        [string]$SkippedMessage
+    )
+
+    foreach ($message in (Get-NovaCliReplayWarningMessage -WarningMessages $WarningMessages -SkippedMessage $SkippedMessage)) {
+        Write-Warning $message
+    }
+}
+
+function Get-NovaCliReplayWarningMessage {
+    [CmdletBinding()]
+    param(
+        [object[]]$WarningMessages = @(),
+        [string]$SkippedMessage
+    )
+
+    $messages = foreach ($warningMessage in @($WarningMessages)) {
+        $text = ConvertTo-NovaCliWarningMessageText -WarningMessage $warningMessage
+        if ([string]::IsNullOrWhiteSpace($text) -or $text -eq $SkippedMessage) {
+            continue
+        }
+
+        $text
+    }
+
+    return @($messages)
+}
+
+function ConvertTo-NovaCliWarningMessageText {
+    [CmdletBinding()]
+    param(
+        [Parameter(Mandatory)][object]$WarningMessage
+    )
+
+    if ($WarningMessage -is [System.Management.Automation.WarningRecord]) {
+        return $WarningMessage.Message
+    }
+
+    return [string]$WarningMessage
+}
+
 function Invoke-NovaCliUpdateRouteCommand {
     [CmdletBinding()]
     param(
@@ -55,7 +111,7 @@ function Invoke-NovaCliBumpRouteCommand {
         [Parameter(Mandatory)][pscustomobject]$InvocationContext
     )
 
-    $result = Invoke-NovaCliParsedCommand -InvocationContext $InvocationContext -ParserCommand 'ConvertFrom-NovaBumpCliArgument' -ActionCommand 'Update-NovaModuleVersion'
+    $result = Invoke-NovaCliBumpCommand -InvocationContext $InvocationContext
     return Format-NovaCliCommandResult -Command $InvocationContext.Command -Result $result
 }
 

tests/NovaCommandModel.BumpAndCli.Tests.ps1

@@ -707,6 +707,21 @@ Describe 'Nova command model - bump and CLI confirmation behavior' {
         }
     }
 
+    It 'Invoke-NovaCli bump formats the major-zero advisory once when the routed bump command returns the same advisory warning' {
+        InModuleScope $script:moduleName {
+            $advisoryMessage = 'Major version zero (0.y.z) is for initial development.'
+            Mock Update-NovaModuleVersion {
+                Write-Warning $advisoryMessage
+                [pscustomobject]@{PreviousVersion = '0.1.0'; NewVersion = '0.2.0'; Label = 'Major'; EffectiveLabel = 'Minor'; AdvisoryMessage = $advisoryMessage; CommitCount = 1; Applied = $false}
+            }
+
+            $result = Invoke-NovaCli bump -WhatIf
+
+            $result | Should -Be "Version plan: 0.1.0 -> 0.2.0 | Label: Major | Commits: 1$( [Environment]::NewLine )$advisoryMessage"
+            ([regex]::Matches($result,[regex]::Escape($advisoryMessage))).Count | Should -Be 1
+        }
+    }
+
     It 'Confirm-NovaCliCommandAction accepts Enter as the default confirmation response' {
         Invoke-ConfirmNovaCliCommandActionEnterAssertion -ModuleName $script:moduleName
     }

tests/NovaCommandModel.StandaloneCli.Tests.ps1

@@ -343,6 +343,7 @@ Describe '$projectName tests' {
             $bumpResult.Text | Should -Match 'Version plan: 0\.1\.0 -> 0\.2\.0 \| Label: Major \| Commits: 1'
             $bumpResult.Text | Should -Match 'Major version zero \(0\.y\.z\) is for initial development'
             $bumpResult.Text | Should -Match 'Set 1\.0\.0 manually once the software is stable'
+            ([regex]::Matches($bumpResult.Text, 'Major version zero \(0\.y\.z\) is for initial development')).Count | Should -Be 1
             $bumpResult.Text | Should -Not -Match 'Version bumped to :'
             $versionAfterBump | Should -Be '0.1.0'
         }

tests/UpdateNotification.Tests.ps1

@@ -825,7 +825,7 @@ Continue with the prerelease update?
         $result.Warnings[0] | Should -Match 'newer NovaModuleTools release is available'
         $result.Warnings[0] | Should -Match 'Release notes: https://www\.novamoduletools\.com/release-notes\.html'
         $result.Warnings[0] | Should -Match 'Update-Module NovaModuleTools'
-        $result.Warnings[0] | Should -Match 'nova update'
+        $result.Warnings[0] | Should -Match '% nova update'
     }
 
     It 'Invoke-NovaBuildUpdateNotification warns about a newer prerelease only when prerelease notifications are enabled' {
@@ -838,9 +838,9 @@ Continue with the prerelease update?
         $result.Warnings[0] | Should -Match 'newer NovaModuleTools prerelease is available'
         $result.Warnings[0] | Should -Match 'Release notes: https://www\.novamoduletools\.com/release-notes\.html'
         $result.Warnings[0] | Should -Match 'Update-Module NovaModuleTools -AllowPrerelease'
-        $result.Warnings[0] | Should -Match 'nova update'
+        $result.Warnings[0] | Should -Match '% nova update'
         $result.Warnings[0] | Should -Match 'Set-NovaUpdateNotificationPreference -DisablePrereleaseNotifications'
-        $result.Warnings[0] | Should -Match 'nova notification --disable'
+        $result.Warnings[0] | Should -Match '% nova notification --disable'
     }
 
     It 'Write-NovaAvailableModuleUpdateWarning preserves host rendering so warning text can stay colored' {
@@ -873,7 +873,7 @@ Continue with the prerelease update?
                 ''
                 'Update:'
                 'PS> Update-Module NovaModuleTools'
-                'nova update'
+                '% nova update'
             )
         }
     }