feat(#206): mirror public command tests

 Add focused, dot-source-first Pester tests under tests/public/ for every
 public command (Invoke-NovaBuild, Test-NovaBuild, New-NovaModulePackage,
 Initialize-NovaModule, Get-NovaProjectInfo, Get-/Set-NovaUpdateNotificationPreference,
 Install-NovaCli, Invoke-NovaCli, Update-NovaModuleTool, Update-NovaModuleVersion,
 Deploy-NovaPackage, Publish-NovaModule, Invoke-NovaRelease). Tests stay
 command-focused: parameter forwarding, delegation to context/workflow
 helpers, and ShouldProcess / -WhatIf behavior, without duplicating
 private helper coverage.

 Closes Migrate public command tests (7)
 Fixes #206

Author: stiwicourage

CHANGELOG.md

@@ -27,6 +27,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 - Added mirrored, dot-source-first Pester test files for CLI private helpers (`src/private/cli/*.ps1`), so most CLI argument parsers, prompt helpers, and per-command CLI wrappers now have a focused test file under `tests/private/cli/`. Large cross-cutting CLI orchestrators (`InvokeNovaCliCommandRoute.ps1`, `GetNovaCliArgumentRoutingState.ps1`, `FormatNovaCliCommandHelp.ps1`, `ConfirmNovaCliAction.ps1`, `GetNovaCliInvocationContext.ps1`) stay covered by the existing cross-cutting CLI tests.
 - Added mirrored, dot-source-first Pester test files for release private helpers (`src/private/release/*.ps1`), so most release, publish, and version-update helpers (local publish path resolution, publish parameter mapping, version label inference, version part calculation, prerelease label handling, release request shaping, and per-step write/import helpers) now have a focused test file under `tests/private/release/`. Multi-step release/publish/version-update workflow orchestrators (`InvokeNovaReleaseWorkflow.ps1`, `InvokeNovaPublishWorkflow.ps1`, `GetNovaVersionUpdateWorkflowContext.ps1`) stay covered by the existing cross-cutting release tests.
 - Added mirrored, dot-source-first Pester test files for package private helpers (`src/private/package/*.ps1`), so most package metadata, archive-content, NuGet/Zip artifact, upload option, upload target, upload header/auth, upload file-resolution, upload request, and per-type upload helpers now have a focused test file under `tests/private/package/`. Multi-step package workflow orchestrators (`InvokeNovaPackageWorkflow.ps1`, `InvokeNovaPackageUploadWorkflow.ps1`, `GetNovaPackageWorkflowContext.ps1`, `GetNovaPackageUploadWorkflowContext.ps1`, `InvokeNovaPackageArtifactCreation.ps1`, `NewNovaPackageArtifacts.ps1`) stay covered by the existing cross-cutting package tests.
+- Added mirrored, dot-source-first Pester test files for every public command (`src/public/*.ps1`), so each command (`Invoke-NovaBuild`, `Test-NovaBuild`, `New-NovaModulePackage`, `Initialize-NovaModule`, `Get-NovaProjectInfo`, `Get-/Set-NovaUpdateNotificationPreference`, `Install-NovaCli`, `Invoke-NovaCli`, `Update-NovaModuleTool`, `Update-NovaModuleVersion`, `Deploy-NovaPackage`, `Publish-NovaModule`, `Invoke-NovaRelease`) now has a focused command-surface test under `tests/public/` covering parameter forwarding, delegation to its workflow context/workflow helpers, and `ShouldProcess` / `-WhatIf` behavior without duplicating private helper coverage.
 
 
 ### Changed

tests/public/DeployNovaPackage.Tests.ps1

@@ -0,0 +1,32 @@
+BeforeAll {
+    $projectRoot = Split-Path -Parent (Split-Path -Parent $PSScriptRoot)
+    . (Join-Path $projectRoot 'src/public/DeployNovaPackage.ps1')
+
+    function New-NovaPackageUploadDynamicParameterDictionary {return New-Object 'System.Management.Automation.RuntimeDefinedParameterDictionary'}
+    function Get-NovaProjectInfo {return [pscustomobject]@{Name='X'}}
+    function New-NovaPackageUploadOption {param($BoundParameters) return [pscustomobject]@{BoundCount=$BoundParameters.Count}}
+    function Get-NovaPackageUploadWorkflowContext {param($BoundParameters, $ProjectInfo, $UploadOption)
+        return [pscustomobject]@{Target='https://x/repo'; Operation='Upload'; UploadArtifactList=@([pscustomobject]@{Name='a.nupkg'})}
+    }
+    function Invoke-NovaPackageUploadWorkflow {param($WorkflowContext, $UploadArtifactList)
+        $script:invoked = $true
+        return @([pscustomobject]@{StatusCode=201})
+    }
+}
+
+Describe 'Deploy-NovaPackage' {
+    BeforeEach {$script:invoked = $false}
+
+    It 'invokes the upload workflow and returns its results' {
+        $result = Deploy-NovaPackage -PackagePath '/o/a.nupkg' -Url 'https://x' -Repository 'Nexus'
+        $script:invoked | Should -BeTrue
+        @($result).Count | Should -Be 1
+        $result[0].StatusCode | Should -Be 201
+    }
+
+    It 'returns an empty array and does not invoke the workflow when -WhatIf is set' {
+        $result = Deploy-NovaPackage -PackagePath '/o/a.nupkg' -WhatIf
+        $script:invoked | Should -BeFalse
+        @($result).Count | Should -Be 0
+    }
+}

tests/public/GetNovaProjectInfo.Tests.ps1

@@ -0,0 +1,27 @@
+BeforeAll {
+    $projectRoot = Split-Path -Parent (Split-Path -Parent $PSScriptRoot)
+    . (Join-Path $projectRoot 'src/public/GetNovaProjectInfo.ps1')
+
+    function Get-NovaCliInstalledVersion {param($Module) return '1.2.3'}
+    function Format-NovaCliVersionString {param($Name, $Version) return "$Name $Version"}
+    function Get-NovaProjectInfoContext {param($Path) return [pscustomobject]@{Path=$Path}}
+    function Get-NovaProjectInfoResult {param($WorkflowContext, [switch]$Version)
+        if ($Version) {return '9.9.9'}
+        return [pscustomobject]@{Name='X'; Path=$WorkflowContext.Path}
+    }
+}
+
+Describe 'Get-NovaProjectInfo' {
+    It 'returns a formatted installed version when -Installed is set' {
+        Get-NovaProjectInfo -Installed | Should -Match 'NovaModuleTools 1\.2\.3|.+1\.2\.3'
+    }
+
+    It 'returns the project info result when -Version is not set' {
+        $result = Get-NovaProjectInfo -Path '/proj'
+        $result.Path | Should -Be '/proj'
+    }
+
+    It 'returns the version string when -Version is set' {
+        Get-NovaProjectInfo -Path '/proj' -Version | Should -Be '9.9.9'
+    }
+}

tests/public/GetNovaUpdateNotificationPreference.Tests.ps1

@@ -0,0 +1,12 @@
+BeforeAll {
+    $projectRoot = Split-Path -Parent (Split-Path -Parent $PSScriptRoot)
+    . (Join-Path $projectRoot 'src/public/GetNovaUpdateNotificationPreference.ps1')
+
+    function Get-NovaUpdateNotificationPreferenceStatus {return [pscustomobject]@{PrereleaseNotificationsEnabled=$true}}
+}
+
+Describe 'Get-NovaUpdateNotificationPreference' {
+    It 'returns the status from Get-NovaUpdateNotificationPreferenceStatus' {
+        (Get-NovaUpdateNotificationPreference).PrereleaseNotificationsEnabled | Should -BeTrue
+    }
+}

tests/public/InitializeNovaModule.Tests.ps1

@@ -0,0 +1,26 @@
+BeforeAll {
+    $projectRoot = Split-Path -Parent (Split-Path -Parent $PSScriptRoot)
+    . (Join-Path $projectRoot 'src/public/InitializeNovaModule.ps1')
+
+    function Get-NovaModuleInitializationWorkflowContext {param($Path, [switch]$Example)
+        $script:ctxArgs = @{Path=$Path; Example=[bool]$Example}
+        return [pscustomobject]@{Target=$Path; Action='Initialize'}
+    }
+    function Invoke-NovaModuleInitializationWorkflow {param($WorkflowContext) $script:workflowCalled = $true}
+}
+
+Describe 'Initialize-NovaModule' {
+    BeforeEach {$script:ctxArgs = $null; $script:workflowCalled = $false}
+
+    It 'forwards Path and Example to the workflow context' {
+        Initialize-NovaModule -Path '/tmp/x' -Example
+        $script:ctxArgs.Path | Should -Be '/tmp/x'
+        $script:ctxArgs.Example | Should -BeTrue
+        $script:workflowCalled | Should -BeTrue
+    }
+
+    It 'returns without invoking the workflow when -WhatIf is set' {
+        Initialize-NovaModule -Path '/tmp/x' -WhatIf
+        $script:workflowCalled | Should -BeFalse
+    }
+}

tests/public/InstallNovaCli.Tests.ps1

@@ -0,0 +1,32 @@
+BeforeAll {
+    $projectRoot = Split-Path -Parent (Split-Path -Parent $PSScriptRoot)
+    . (Join-Path $projectRoot 'src/public/InstallNovaCli.ps1')
+
+    function Get-NovaCliInstallWorkflowContext {param($DestinationDirectory, [switch]$Force)
+        $script:ctxArgs = @{Destination=$DestinationDirectory; Force=[bool]$Force}
+        return [pscustomobject]@{TargetPath='/usr/local/bin/nova'; Action='Install'}
+    }
+    function Invoke-NovaCliInstallWorkflow {param($WorkflowContext)
+        $script:invoked = $true
+        return [pscustomobject]@{ReleaseNotesUri='https://x/rel'}
+    }
+    function Write-NovaModuleReleaseNotesLink {param($ReleaseNotesUri) $script:notesUri = $ReleaseNotesUri}
+}
+
+Describe 'Install-NovaCli' {
+    BeforeEach {$script:ctxArgs = $null; $script:invoked = $false; $script:notesUri = $null}
+
+    It 'forwards parameters and writes the release notes link' {
+        $result = Install-NovaCli -DestinationDirectory '/dest' -Force
+        $script:ctxArgs.Destination | Should -Be '/dest'
+        $script:ctxArgs.Force | Should -BeTrue
+        $script:invoked | Should -BeTrue
+        $script:notesUri | Should -Be 'https://x/rel'
+        $result.ReleaseNotesUri | Should -Be 'https://x/rel'
+    }
+
+    It 'returns without invoking the workflow when -WhatIf is set' {
+        Install-NovaCli -WhatIf
+        $script:invoked | Should -BeFalse
+    }
+}

tests/public/InvokeNovaBuild.Tests.ps1

@@ -0,0 +1,29 @@
+BeforeAll {
+    $projectRoot = Split-Path -Parent (Split-Path -Parent $PSScriptRoot)
+    . (Join-Path $projectRoot 'src/public/InvokeNovaBuild.ps1')
+
+    function Get-NovaBuildWorkflowContext {param([switch]$ContinuousIntegrationRequested, [switch]$OverrideWarningRequested)
+        $script:contextArgs = @{CI=[bool]$ContinuousIntegrationRequested; Override=[bool]$OverrideWarningRequested}
+        return [pscustomobject]@{Target='/proj'; Operation='Build'}
+    }
+    function Invoke-NovaBuildWorkflow {param($WorkflowContext) $script:workflowCalled = $true}
+}
+
+Describe 'Invoke-NovaBuild' {
+    BeforeEach {
+        $script:contextArgs = $null
+        $script:workflowCalled = $false
+    }
+
+    It 'forwards switch parameters to the workflow context' {
+        Invoke-NovaBuild -ContinuousIntegration -OverrideWarning
+        $script:contextArgs.CI | Should -BeTrue
+        $script:contextArgs.Override | Should -BeTrue
+        $script:workflowCalled | Should -BeTrue
+    }
+
+    It 'skips the workflow when -WhatIf is set' {
+        Invoke-NovaBuild -WhatIf
+        $script:workflowCalled | Should -BeFalse
+    }
+}

tests/public/InvokeNovaCli.Tests.ps1

@@ -0,0 +1,22 @@
+BeforeAll {
+    $projectRoot = Split-Path -Parent (Split-Path -Parent $PSScriptRoot)
+    . (Join-Path $projectRoot 'src/public/InvokeNovaCli.ps1')
+
+    function Get-NovaCliInvocationContext {param($InvocationRequest, [switch]$WhatIfEnabled)
+        $script:request = $InvocationRequest
+        return [pscustomobject]@{Request=$InvocationRequest; WhatIf=[bool]$WhatIfEnabled}
+    }
+    function Invoke-NovaCliCommandRoute {param($InvocationContext) return [pscustomobject]@{Routed=$true; Command=$InvocationContext.Request.Command}}
+}
+
+Describe 'Invoke-NovaCli' {
+    It 'defaults to --help when no command is provided' {
+        (Invoke-NovaCli).Command | Should -Be '--help'
+    }
+
+    It 'forwards command and remaining arguments to the invocation context' {
+        Invoke-NovaCli 'build' '--ci' '--override-warning' | Out-Null
+        $script:request.Command | Should -Be 'build'
+        $script:request.Arguments | Should -Be @('--ci','--override-warning')
+    }
+}

tests/public/InvokeNovaRelease.Tests.ps1

@@ -0,0 +1,45 @@
+BeforeAll {
+    $projectRoot = Split-Path -Parent (Split-Path -Parent $PSScriptRoot)
+    . (Join-Path $projectRoot 'src/public/InvokeNovaRelease.ps1')
+
+    function Get-NovaDynamicReleaseParameterDictionary {return New-Object 'System.Management.Automation.RuntimeDefinedParameterDictionary'}
+    function Get-NovaReleaseRequestedPath {param($BoundParameters) return (Get-Location).Path}
+    function Get-NovaReleaseRequest {param($BoundParameters, $ParameterSetName)
+        $script:parameterSet = $ParameterSetName
+        return [pscustomobject]@{ParameterSetName=$ParameterSetName}
+    }
+    function Get-NovaReleasePublishOption {param($ReleaseParameters) return [pscustomobject]@{Local=$true}}
+    function Get-NovaProjectInfo {return [pscustomobject]@{Name='X'}}
+    function Get-NovaShouldProcessForwardingParameter {param([switch]$WhatIfEnabled) return @{WhatIf=[bool]$WhatIfEnabled}}
+    function Get-NovaPublishWorkflowContext {param($ProjectInfo, $PublishOption, $WorkflowParams, $WorkflowSettings)
+        $script:settings = $WorkflowSettings
+        return [pscustomobject]@{Target='nuget.org'; Operation='Release'}
+    }
+    function Write-NovaPublishWorkflowContext {param($WorkflowContext) $script:wrote = $true}
+    function Invoke-NovaReleaseWorkflow {param($WorkflowContext)
+        $script:invoked = $true
+        return [pscustomobject]@{Released=$true}
+    }
+}
+
+Describe 'Invoke-NovaRelease' {
+    BeforeEach {
+        $script:parameterSet = $null; $script:settings = $null
+        $script:wrote = $false; $script:invoked = $false
+    }
+
+    It 'runs the release workflow with release-flavored settings' {
+        $result = Invoke-NovaRelease -Local
+        $script:parameterSet | Should -Be 'Local'
+        $script:settings.WorkflowName | Should -Be 'release'
+        $script:settings.Release | Should -BeTrue
+        $script:wrote | Should -BeTrue
+        $script:invoked | Should -BeTrue
+        $result.Released | Should -BeTrue
+    }
+
+    It 'still invokes the release workflow when -WhatIf is set so it can render its plan' {
+        Invoke-NovaRelease -Local -WhatIf | Out-Null
+        $script:invoked | Should -BeTrue
+    }
+}

tests/public/NewNovaModulePackage.Tests.ps1

@@ -0,0 +1,31 @@
+BeforeAll {
+    $projectRoot = Split-Path -Parent (Split-Path -Parent $PSScriptRoot)
+    . (Join-Path $projectRoot 'src/public/NewNovaModulePackage.ps1')
+
+    function Get-NovaShouldProcessForwardingParameter {param([switch]$WhatIfEnabled) return @{WhatIf=[bool]$WhatIfEnabled}}
+    function Get-NovaPackageWorkflowContext {param($WorkflowParams, [switch]$SkipTestsRequested, [switch]$OverrideWarningRequested)
+        $script:ctxArgs = @{SkipTests=[bool]$SkipTestsRequested; Override=[bool]$OverrideWarningRequested}
+        return [pscustomobject]@{Target='/proj'; Operation='Package'}
+    }
+    function Invoke-NovaPackageWorkflow {param($WorkflowContext, [switch]$ShouldRun)
+        $script:shouldRun = [bool]$ShouldRun
+        return 'packaged'
+    }
+}
+
+Describe 'New-NovaModulePackage' {
+    BeforeEach {$script:ctxArgs = $null; $script:shouldRun = $null}
+
+    It 'forwards switch parameters to the workflow context and returns the workflow result' {
+        $result = New-NovaModulePackage -SkipTests -OverrideWarning
+        $script:ctxArgs.SkipTests | Should -BeTrue
+        $script:ctxArgs.Override | Should -BeTrue
+        $script:shouldRun | Should -BeTrue
+        $result | Should -Be 'packaged'
+    }
+
+    It 'passes ShouldRun=$false when -WhatIf is set' {
+        New-NovaModulePackage -WhatIf | Out-Null
+        $script:shouldRun | Should -BeFalse
+    }
+}