feat(#97): enhance CLI output and result contracts for structured data

- Add tests for formatted CLI command results
- Implement tests for version update handling with WhatIf scenarios
- Ensure release notes URI is correctly resolved in update messages

Author: stiwicourage

tests/CoverageGaps.Cli.Tests.ps1

@@ -140,6 +140,22 @@ Describe 'Coverage gaps for CLI and installed-version internals' {
         }
     }
 
+    It 'Format-NovaCliCommandResult renders applied bump results as a completed CLI summary' {
+        InModuleScope $script:moduleName {
+            $versionUpdateResult = [pscustomobject]@{
+                PreviousVersion = '1.0.0'
+                NewVersion = '1.1.0'
+                Label = 'Minor'
+                CommitCount = 2
+                Applied = $true
+            }
+
+            $result = Format-NovaCliCommandResult -Command 'bump' -Result $versionUpdateResult
+
+            $result | Should -Be 'Version bump completed: 1.0.0 -> 1.1.0 | Label: Minor | Commits: 2'
+        }
+    }
+
     It 'Invoke-NovaCliCommandRoute formats bump results through the shared CLI formatter' {
         InModuleScope $script:moduleName {
             $invocationContext = [pscustomobject]@{

tests/CoverageGaps.ReleaseInternals.Tests.ps1

@@ -254,6 +254,32 @@ Describe 'Coverage gaps for release and git internals' {
         }
     }
 
+    It 'Set-NovaModuleVersion returns a non-applied write result when WhatIf declines project.json persistence' {
+        InModuleScope $script:moduleName {
+            Mock Get-NovaVersionUpdatePlan {
+                [pscustomobject]@{
+                    ProjectFile = '/tmp/project.json'
+                    NewVersion = [semver]'1.3.0-preview'
+                }
+            }
+            Mock Read-ProjectJsonData {
+                [ordered]@{
+                    Version = '1.2.3'
+                }
+            }
+            Mock Write-ProjectJsonData {throw 'should not persist during WhatIf'}
+
+            $result = Set-NovaModuleVersion -Label Minor -PreviewRelease -WhatIf
+
+            $result.ProjectFile | Should -Be '/tmp/project.json'
+            $result.PreviousVersion | Should -Be '1.2.3'
+            $result.NewVersion | Should -Be '1.3.0-preview'
+            $result.Applied | Should -BeFalse
+            Assert-MockCalled Read-ProjectJsonData -Times 1 -ParameterFilter {$ProjectJsonPath -eq '/tmp/project.json'}
+            Assert-MockCalled Write-ProjectJsonData -Times 0
+        }
+    }
+
     It 'Publish-NovaBuiltModuleToRepository uses the PSGallery fallback api key without forcing verbose output' {
         InModuleScope $script:moduleName {
             $originalApiKey = $env:PSGALLERY_API

tests/UpdateNotification.Tests.ps1

@@ -308,6 +308,21 @@ Describe 'Update notification behavior' {
         }
     }
 
+    It 'Complete-NovaModuleSelfUpdateResult overwrites an existing release-notes property in place' {
+        InModuleScope $script:moduleName {
+            $plan = [pscustomobject]@{
+                ModuleName = 'NovaModuleTools'
+                UpdateAvailable = $true
+                ReleaseNotesUri = 'https://old.example/release-notes'
+            }
+
+            $result = Complete-NovaModuleSelfUpdateResult -Plan $plan -ReleaseNotesUri 'https://www.novamoduletools.com/release-notes.html'
+
+            $result.ReleaseNotesUri | Should -Be 'https://www.novamoduletools.com/release-notes.html'
+            @($result.PSObject.Properties.Name | Where-Object {$_ -eq 'ReleaseNotesUri'}).Count | Should -Be 1
+        }
+    }
+
     It 'Update-NovaModuleTool delegates workflow context resolution and execution to private helpers' {
         InModuleScope $script:moduleName {
             Mock Get-NovaModuleSelfUpdateWorkflowContext {
@@ -348,6 +363,38 @@ Describe 'Update notification behavior' {
         }
     }
 
+    It 'Update-NovaModuleTool returns the unchanged plan and skips update execution when WhatIf declines the update action' {
+        InModuleScope $script:moduleName {
+            Mock Get-NovaModuleSelfUpdateWorkflowContext {
+                [pscustomobject]@{
+                    Plan = [pscustomobject]@{
+                        ModuleName = 'NovaModuleTools'
+                        CurrentVersion = '1.0.0'
+                        TargetVersion = '1.1.0'
+                        PrereleaseNotificationsEnabled = $true
+                        UpdateAvailable = $true
+                        Updated = $false
+                        Cancelled = $false
+                        IsPrereleaseTarget = $false
+                        UsedAllowPrerelease = $false
+                    }
+                    Action = 'Update NovaModuleTools to version 1.1.0'
+                }
+            }
+            Mock Invoke-NovaModuleSelfUpdateWorkflow {throw 'should not update during WhatIf'}
+            Mock Write-NovaModuleReleaseNotesLink {throw 'should not write release notes during WhatIf'}
+
+            $result = Update-NovaModuleTool -WhatIf
+
+            $result.UpdateAvailable | Should -BeTrue
+            $result.Updated | Should -BeFalse
+            $result.ReleaseNotesUri | Should -BeNullOrEmpty
+            Assert-MockCalled Get-NovaModuleSelfUpdateWorkflowContext -Times 1
+            Assert-MockCalled Invoke-NovaModuleSelfUpdateWorkflow -Times 0
+            Assert-MockCalled Write-NovaModuleReleaseNotesLink -Times 0
+        }
+    }
+
     It 'Get-NovaUpdateNotificationPreference defaults prerelease notifications to enabled when no settings file exists' {
         $configRoot = Join-Path $TestDrive 'config-default'
         $originalConfigHome = $env:XDG_CONFIG_HOME
@@ -625,6 +672,17 @@ throw 'offline'
         }
     }
 
+    It 'Get-NovaModuleReleaseNotesMessage resolves the URI from the module parameter set' {
+        InModuleScope $script:moduleName {
+            Mock Get-NovaModuleReleaseNotesUri {'https://www.novamoduletools.com/release-notes.html'}
+
+            $message = Get-NovaModuleReleaseNotesMessage -Module ([pscustomobject]@{Name = 'NovaModuleTools'})
+
+            $message | Should -Be 'Release notes: https://www.novamoduletools.com/release-notes.html'
+            Assert-MockCalled Get-NovaModuleReleaseNotesUri -Times 1
+        }
+    }
+
     It 'Update-NovaModuleTool applies a stable update without prerelease confirmation' {
         $result = Invoke-TestNovaSelfUpdate -Options ([pscustomobject]@{
             PrereleaseNotificationsEnabled = $true