fix: update CHANGELOG and improve CLI help consistency

- Refactor CHANGELOG for clarity and formatting consistency
- Enhance CLI help output to ensure consistent option spellings
- Add tests for default console reader behavior in Invoke-NovaCliNativeConsoleReadKey

Author: stiwicourage

CHANGELOG.md

@@ -59,20 +59,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Add `Deploy-NovaPackage` and `% nova deploy` for raw HTTP package uploads that stay separate from PowerShell
     repository publishing.
       - Package upload resolves `-Url`, `Package.RepositoryUrl`, or named `Package.Repositories` targets and can merge
-    generic headers/auth settings.
+        generic headers/auth settings.
   - Package upload now discovers all matching artifacts for the selected package types, including versioned and
     `latest` files in the configured package output directory.
 - Add opt-in skip-test support to the package, publish, and release workflows for CI/CD-oriented delivery paths where
   tests already ran earlier in the pipeline.
-
-### Fixed
-
-- Fix unsupported `nova` help invocations so they now return Nova's structured CLI validation error instead of a
-  PowerShell parameter-binding failure.
-- Keep manifest/package helper edge cases aligned with their intended behavior.
-    - Manifest settings resolution now accepts ordered dictionary metadata shapes in addition to plain hashtables.
-    - `New-NovaPackageArtifacts` now accepts an empty metadata list and returns an empty artifact result instead of
-      failing during parameter binding.
 - Centralize delivery configuration resolution so raw package upload, update notification settings, and PSGallery
   publishing now follow one explicit precedence model without surfacing configured secrets in error text.
     - Raw upload now resolves command overrides before named repository settings, then package defaults.
@@ -126,8 +117,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
     - `% nova --help <command>` and `% nova -h <command>` now show long CLI help.
   - Long command help now includes the matching public GitHub Pages guide URL for the selected command, while short help
     stays focused on command syntax and options.
-    - CLI help no longer delegates to PowerShell `Get-Help` and now consistently shows CLI option spellings such as
-      `--repository` and `-r`.
+      - CLI help no longer delegates to PowerShell `Get-Help` and now consistently shows CLI option spellings such as
+        `--repository` and `-r`.
 - **BREAKING CHANGE**: Rename the public Nova scaffold cmdlets.
     - `New-NovaModule` → `Initialize-NovaModule`
     - No compatibility aliases are exported for the retired cmdlet names or CLI subcommands.
@@ -191,11 +182,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - Project settings:
-  - `BuildRecursiveFolders` (default `true`): recursive discovery for `src/classes`, `src/private` and `tests`.
-  - `SetSourcePath` (default `true`): include `# Source: <relative path>` before each concatenated source file in generated `dist/<Project>/<Project>.psm1`.
-  - `FailOnDuplicateFunctionNames` (default `true`): fail build when duplicate top-level function names exist in generated `dist/<Project>/<Project>.psm1`.
-  - Missing values for these settings are now treated as `true`.
-  - The rebranded `NovaModuleTools` module now uses its own module `GUID`.
+    - `BuildRecursiveFolders` (default `true`): recursive discovery for `src/classes`, `src/private` and `tests`.
+    - `SetSourcePath` (default `true`): include `# Source: <relative path>` before each concatenated source file in
+      generated `dist/<Project>/<Project>.psm1`.
+    - `FailOnDuplicateFunctionNames` (default `true`): fail build when duplicate top-level function names exist in
+      generated `dist/<Project>/<Project>.psm1`.
+    - Missing values for these settings are now treated as `true`.
+    - The rebranded `NovaModuleTools` module now uses its own module `GUID`.
 
 ### Changed
 - Build determinism: files are processed in a deterministic order by relative path (case-insensitive), and load order is always `classes → public → private`.
@@ -224,13 +217,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Now supports preview tag in Update-NovaModuleVersion
 - Now supports semver naming in both project.json and modulemanifest
 - Module build supports `preview` or `prerelease` tag
-- Preview version looks like `1.2.3-preview` 
+- Preview version looks like `1.2.3-preview`
 
 ## [1.1.0] - 2025-08-28
 
 ## Added
 
-- Now Module manifest includes `AliasesToExport`. This helps loading aliases without explicitly importing modules to session. 
+- Now Module manifest includes `AliasesToExport`. This helps loading aliases without explicitly importing modules to
+  session.
 - thanks to @djs-zmtc for suggesting the feature
 
 ## [1.0.0] - 2025-03-11

src/private/cli/ConfirmNovaCliAction.ps1

@@ -42,8 +42,10 @@ function Invoke-NovaCliConsoleReadKey {
 }
 
 function Invoke-NovaCliNativeConsoleReadKey {
-    [CmdletBinding()]
-    param([scriptblock]$Reader = {[Console]::ReadKey($true)})
+    [CmdletBinding()] param([scriptblock]$Reader)
+    if ($null -eq $Reader) {
+        return [Console]::ReadKey($true)
+    }
 
     return & $Reader
 }

tests/CliHelperCoverage.Tests.ps1

@@ -146,4 +146,47 @@ Describe 'Targeted coverage for smaller CLI helper internals' {
             Assert-MockCalled Invoke-NovaCliNativeConsoleReadKey -Times 1
         }
     }
+
+    It 'Invoke-NovaCliNativeConsoleReadKey uses the default console reader when no override is provided' {
+        $runnerPath = Join-Path $TestDrive 'Invoke-NovaCliNativeConsoleReadKey.Runner.ps1'
+        $stdinPath = Join-Path $TestDrive 'Invoke-NovaCliNativeConsoleReadKey.stdin.txt'
+        $stdoutPath = Join-Path $TestDrive 'Invoke-NovaCliNativeConsoleReadKey.stdout.txt'
+        $stderrPath = Join-Path $TestDrive 'Invoke-NovaCliNativeConsoleReadKey.stderr.txt'
+        Set-Content -LiteralPath $stdinPath -Value '' -Encoding utf8 -NoNewline
+        Set-Content -LiteralPath $runnerPath -Encoding utf8 -Value @"
+`$module = Import-Module '$script:distModuleDir' -Force -PassThru
+
+try {
+    & `$module {
+        Invoke-NovaCliNativeConsoleReadKey | Out-Null
+    }
+
+    Write-Output 'NO_THROW'
+    exit 1
+}
+catch {
+    Write-Output `$_.FullyQualifiedErrorId
+    Write-Output `$_.Exception.Message
+    exit 0
+}
+"@
+
+        $process = Start-Process pwsh -ArgumentList @('-NoLogo', '-NoProfile', '-File', $runnerPath) `
+            -RedirectStandardInput $stdinPath `
+            -RedirectStandardOutput $stdoutPath `
+            -RedirectStandardError $stderrPath `
+            -Wait `
+            -PassThru
+        $output = @(
+        if (Test-Path -LiteralPath $stdoutPath) {
+            Get-Content -LiteralPath $stdoutPath
+        }
+        if (Test-Path -LiteralPath $stderrPath) {
+            Get-Content -LiteralPath $stderrPath
+        }
+        )
+
+        $process.ExitCode | Should -Be 0 -Because ($output -join [Environment]::NewLine)
+        ($output -join [Environment]::NewLine) | Should -Match 'Cannot read keys when either application does not have a console or when console input has been redirected'
+    }
 }