fix(#138): resolve information source mismatch in update reporting

- Update `% nova update` to accurately report the current `PSGallery` lookup candidate.
- Modify self-update plan functions to preserve lookup candidate and repository information.
- Enhance no-update output to reflect the latest update candidate instead of falsely claiming the installed version is the newest.

Author: stiwicourage

CHANGELOG.md

@@ -34,6 +34,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
     usage.
   - Uses the stored prerelease update preference to decide whether prerelease self-updates are eligible.
   - Requires explicit confirmation before a prerelease self-update proceeds.
+  - `% nova update` now reports the current `PSGallery` lookup candidate in no-update output instead of claiming the
+    installed version is universally the newest available.
 - Add `% nova version --installed` / `% nova version -i` so users can compare the locally installed version of the
   current project/module with the current project version from `project.json`, while keeping `% nova --version` /
   `% nova -v` dedicated to the installed NovaModuleTools version.

README.md

@@ -107,6 +107,10 @@ preference to decide whether prerelease self-updates are eligible. When prerelea
 self-update stays on stable releases. When they are enabled, self-update may target a prerelease, but it asks for
 explicit confirmation before proceeding.
 
+`% nova update` checks PowerShell Gallery (`PSGallery`) for its current update candidate. When no update is applied,
+the CLI reports the installed version together with the candidate returned from that lookup instead of claiming the
+installed version is universally the newest available.
+
 Successful `Update-NovaModuleTool`, CLI:`% nova update`, and `Install-NovaCli` runs print the release notes link from
 the
 installed module manifest. When `Invoke-NovaBuild` detects a newer `NovaModuleTools` version after a build, the update

scripts/build/ci/Install-CiPowerShellModules.ps1

@@ -11,8 +11,9 @@ function Install-CiModule {
         [Parameter(Mandatory)][string]$Name
     )
 
+    $repositoryName = 'PSGallery'
     Write-Host "Installing PowerShell module '$Name'..."
-    Install-Module -Name $Name -AllowPrerelease -Scope CurrentUser -Force -ErrorAction Stop | Out-Null
+    Install-Module -Name $Name -Repository $repositoryName -AllowPrerelease -Scope CurrentUser -Force -ErrorAction Stop | Out-Null
 
     $installedModule = Get-InstalledModule -Name $Name -ErrorAction Stop |
             Sort-Object Version -Descending |

src/private/cli/FormatNovaCliCommandResult.ps1

@@ -50,6 +50,21 @@ function Format-NovaCliVersionUpdateResult {
     return "$summaryPrefix $( $Result.PreviousVersion ) -> $( $Result.NewVersion ) | Label: $( $Result.Label ) | Commits: $( $Result.CommitCount )"
 }
 
+function Get-NovaCliNoUpdateDetail {
+    [CmdletBinding()]
+    param([Parameter(Mandatory)][object]$Result)
+
+    if (-not [string]::IsNullOrWhiteSpace($Result.LookupCandidateVersion) -and -not [string]::IsNullOrWhiteSpace($Result.LookupRepository)) {
+        return "Installed: $( $Result.ModuleName ) $( $Result.CurrentVersion ). $( $Result.LookupRepository ) currently reports $( $Result.LookupCandidateVersion ) as the latest update candidate checked."
+    }
+
+    if (-not [string]::IsNullOrWhiteSpace($Result.LookupCandidateVersion)) {
+        return "Installed: $( $Result.ModuleName ) $( $Result.CurrentVersion ). The current update lookup reports $( $Result.LookupCandidateVersion ) as the latest candidate checked."
+    }
+
+    return "Installed: $( $Result.ModuleName ) $( $Result.CurrentVersion ). No update candidate is currently available from the configured update source."
+}
+
 function Format-NovaCliCommandResult {
     [CmdletBinding()]
     param(
@@ -59,8 +74,8 @@ function Format-NovaCliCommandResult {
 
     if (Test-NovaCliNoUpdateResult -Command $Command -Result $Result) {
         return @(
-            "You're up to date!"
-            "$( $Result.ModuleName ) $( $Result.CurrentVersion ) is currently the newest version available."
+            'No update was applied.'
+            (Get-NovaCliNoUpdateDetail -Result $Result)
         )
     }
 

src/private/update/ConvertToNovaModuleSelfUpdatePlan.ps1

@@ -1,8 +1,77 @@
+function Get-NovaModuleSelfUpdateLookupCandidate {
+    [CmdletBinding()]
+    param(
+        [pscustomobject]$LookupResult,
+        [Parameter(Mandatory)][bool]$PrereleaseNotificationsEnabled
+    )
+
+    if ($null -eq $LookupResult) {
+        return $null
+    }
+
+    if ($PrereleaseNotificationsEnabled -and $null -ne $LookupResult.Prerelease) {
+        return $LookupResult.Prerelease
+    }
+
+    if ($null -ne $LookupResult.Stable) {
+        return $LookupResult.Stable
+    }
+
+    return $LookupResult.Prerelease
+}
+
+function Get-NovaModuleSelfUpdateLookupRepository {
+    [CmdletBinding()]
+    param(
+        [pscustomobject]$LookupResult,
+        [object]$LookupCandidate
+    )
+
+    if ($null -ne $LookupCandidate -and $LookupCandidate.PSObject.Properties.Name -contains 'Repository') {
+        return $LookupCandidate.Repository
+    }
+
+    if ($null -ne $LookupResult -and $LookupResult.PSObject.Properties.Name -contains 'SourceRepository') {
+        return $LookupResult.SourceRepository
+    }
+
+    return $null
+}
+
+function Get-NovaModuleSelfUpdatePlanContext {
+    [CmdletBinding()]
+    param(
+        [pscustomobject]$LookupResult,
+        [Parameter(Mandatory)][bool]$PrereleaseNotificationsEnabled
+    )
+
+    $lookupCandidate = Get-NovaModuleSelfUpdateLookupCandidate -LookupResult $LookupResult -PrereleaseNotificationsEnabled:$PrereleaseNotificationsEnabled
+    $lookupCandidateVersion = if ($null -ne $lookupCandidate -and $lookupCandidate.PSObject.Properties.Name -contains 'Version') {
+        $lookupCandidate.Version
+    }
+    else {
+        $null
+    }
+    $lookupCandidateChannel = if ($null -ne $lookupCandidate -and $lookupCandidate.PSObject.Properties.Name -contains 'Channel') {
+        $lookupCandidate.Channel
+    }
+    else {
+        $null
+    }
+
+    return [pscustomobject]@{
+        LookupCandidateVersion = $lookupCandidateVersion
+        LookupCandidateChannel = $lookupCandidateChannel
+        LookupRepository = Get-NovaModuleSelfUpdateLookupRepository -LookupResult $LookupResult -LookupCandidate $lookupCandidate
+        PrereleaseNotificationsEnabled = $PrereleaseNotificationsEnabled
+    }
+}
+
 function ConvertTo-NovaModuleSelfUpdatePlan {
     [CmdletBinding()]
     param(
         [Parameter(Mandatory)][pscustomobject]$InstalledModule,
-        [Parameter(Mandatory)][bool]$PrereleaseNotificationsEnabled,
+        [Parameter(Mandatory)][pscustomobject]$PlanContext,
         [string]$TargetVersion,
         [switch]$PrereleaseTarget
     )
@@ -11,7 +80,10 @@ function ConvertTo-NovaModuleSelfUpdatePlan {
         ModuleName = $InstalledModule.ModuleName
         CurrentVersion = $InstalledModule.Version
         TargetVersion = $TargetVersion
-        PrereleaseNotificationsEnabled = $PrereleaseNotificationsEnabled
+        LookupCandidateVersion = $PlanContext.LookupCandidateVersion
+        LookupCandidateChannel = $PlanContext.LookupCandidateChannel
+        LookupRepository = $PlanContext.LookupRepository
+        PrereleaseNotificationsEnabled = $PlanContext.PrereleaseNotificationsEnabled
         UpdateAvailable = -not [string]::IsNullOrWhiteSpace($TargetVersion)
         Updated = $false
         Cancelled = $false

src/private/update/GetNovaModuleSelfUpdatePlan.ps1

@@ -6,14 +6,15 @@ function Get-NovaModuleSelfUpdatePlan {
         [Parameter(Mandatory)][bool]$PrereleaseNotificationsEnabled
     )
 
+    $planContext = Get-NovaModuleSelfUpdatePlanContext -LookupResult $LookupResult -PrereleaseNotificationsEnabled:$PrereleaseNotificationsEnabled
     $stableVersion = Get-NovaAvailableSemanticVersion -VersionInfo $LookupResult.Stable
     if (Test-NovaPrereleaseUpdateAvailable -LookupResult $LookupResult -InstalledVersion $InstalledModule.SemanticVersion -StableVersion $stableVersion -PrereleaseNotificationsEnabled $PrereleaseNotificationsEnabled) {
-        return ConvertTo-NovaModuleSelfUpdatePlan -InstalledModule $InstalledModule -PrereleaseNotificationsEnabled:$PrereleaseNotificationsEnabled -TargetVersion $LookupResult.Prerelease.Version -PrereleaseTarget
+        return ConvertTo-NovaModuleSelfUpdatePlan -InstalledModule $InstalledModule -PlanContext $planContext -TargetVersion $LookupResult.Prerelease.Version -PrereleaseTarget
     }
 
     if (Test-NovaStableUpdateAvailable -StableVersion $stableVersion -InstalledVersion $InstalledModule.SemanticVersion) {
-        return ConvertTo-NovaModuleSelfUpdatePlan -InstalledModule $InstalledModule -PrereleaseNotificationsEnabled:$PrereleaseNotificationsEnabled -TargetVersion $LookupResult.Stable.Version
+        return ConvertTo-NovaModuleSelfUpdatePlan -InstalledModule $InstalledModule -PlanContext $planContext -TargetVersion $LookupResult.Stable.Version
     }
 
-    return ConvertTo-NovaModuleSelfUpdatePlan -InstalledModule $InstalledModule -PrereleaseNotificationsEnabled:$PrereleaseNotificationsEnabled
+    return ConvertTo-NovaModuleSelfUpdatePlan -InstalledModule $InstalledModule -PlanContext $planContext
 }

src/resources/update/ModuleUpdateLookup.ps1.txt

@@ -4,6 +4,7 @@ $WarningPreference = 'SilentlyContinue'
 $InformationPreference = 'SilentlyContinue'
 $VerbosePreference = 'SilentlyContinue'
 $ErrorActionPreference = 'Stop'
+$repositoryName = 'PSGallery'
 
 function Get-PrereleaseLabel {
     param([object]$Item)
@@ -47,19 +48,21 @@ function ConvertTo-VersionInfo {
     return [pscustomobject]@{
         ModuleName = $ResolvedModuleName
         Channel = $Channel
+        Repository = $repositoryName
         Version = $versionText
     }
 }
 
-$stableItem = Find-Module $ResolvedModuleName -ErrorAction Stop -WarningAction SilentlyContinue
+$stableItem = Find-Module $ResolvedModuleName -Repository $repositoryName -ErrorAction Stop -WarningAction SilentlyContinue
 $prereleaseItem = if ($IncludePrerelease) {
-    Find-Module $ResolvedModuleName -AllowPrerelease -ErrorAction Stop -WarningAction SilentlyContinue
+    Find-Module $ResolvedModuleName -Repository $repositoryName -AllowPrerelease -ErrorAction Stop -WarningAction SilentlyContinue
 }
 else {
     $null
 }
 
 [pscustomobject]@{
+    SourceRepository = $repositoryName
     Stable = ConvertTo-VersionInfo -Item $stableItem -Channel 'Stable'
     Prerelease = ConvertTo-VersionInfo -Item $prereleaseItem -Channel 'Prerelease'
 }

tests/UpdateNotification.Tests.ps1

@@ -243,6 +243,38 @@ Describe 'Update notification behavior' {
         }
     }
 
+    It 'Get-NovaModuleSelfUpdatePlan preserves the lookup candidate and repository for no-update results' {
+        InModuleScope $script:moduleName {
+            $installedModule = [pscustomobject]@{
+                ModuleName = 'NovaModuleTools'
+                Version = '2.0.0-preview9920'
+                SemanticVersion = [semver]'2.0.0-preview9920'
+                IsPrerelease = $true
+            }
+            $lookupResult = [pscustomobject]@{
+                SourceRepository = 'PSGallery'
+                Stable = [pscustomobject]@{
+                    Version = '1.9.1'
+                    Channel = 'Stable'
+                    Repository = 'PSGallery'
+                }
+                Prerelease = [pscustomobject]@{
+                    Version = '2.0.0-beta'
+                    Channel = 'Prerelease'
+                    Repository = 'PSGallery'
+                }
+            }
+
+            $result = Get-NovaModuleSelfUpdatePlan -InstalledModule $installedModule -LookupResult $lookupResult -PrereleaseNotificationsEnabled:$true
+
+            $result.UpdateAvailable | Should -BeFalse
+            $result.TargetVersion | Should -BeNullOrEmpty
+            $result.LookupCandidateVersion | Should -Be '2.0.0-beta'
+            $result.LookupCandidateChannel | Should -Be 'Prerelease'
+            $result.LookupRepository | Should -Be 'PSGallery'
+        }
+    }
+
     It 'Get-NovaModuleSelfUpdateWorkflowContext throws when update lookup cannot resolve a candidate' {
         InModuleScope $script:moduleName {
             Mock Read-NovaUpdateNotificationPreference {[pscustomobject]@{PrereleaseNotificationsEnabled = $true}}
@@ -549,6 +581,9 @@ Describe 'Update notification behavior' {
                     ModuleName = 'NovaModuleTools'
                     CurrentVersion = '2.0.0-prerelease3'
                     TargetVersion = $null
+                    LookupCandidateVersion = '2.0.0-beta'
+                    LookupCandidateChannel = 'Prerelease'
+                    LookupRepository = 'PSGallery'
                     PrereleaseNotificationsEnabled = $true
                     UpdateAvailable = $false
                     Updated = $false
@@ -561,12 +596,23 @@ Describe 'Update notification behavior' {
             $result = @(Invoke-NovaCli update)
 
             $result | Should -HaveCount 2
-            $result[0] | Should -Be "You're up to date!"
-            $result[1] | Should -Be 'NovaModuleTools 2.0.0-prerelease3 is currently the newest version available.'
+            $result[0] | Should -Be 'No update was applied.'
+            $result[1] | Should -Be 'Installed: NovaModuleTools 2.0.0-prerelease3. PSGallery currently reports 2.0.0-beta as the latest update candidate checked.'
             Assert-MockCalled Update-NovaModuleTool -Times 1
         }
     }
 
+    It 'Get-NovaModuleUpdateLookupScript pins lookups to PSGallery and returns repository metadata' {
+        InModuleScope $script:moduleName {
+            $scriptText = Get-NovaModuleUpdateLookupScript
+
+            $scriptText | Should -Match 'Find-Module \$ResolvedModuleName -Repository \$repositoryName'
+            $scriptText | Should -Match 'Find-Module \$ResolvedModuleName -Repository \$repositoryName -AllowPrerelease'
+            $scriptText | Should -Match 'SourceRepository = \$repositoryName'
+            $scriptText | Should -Match 'Repository = \$repositoryName'
+        }
+    }
+
     It 'ConvertFrom-NovaUpdateCliArgument allows no arguments and rejects unsupported usage' {
         InModuleScope $script:moduleName {
             (ConvertFrom-NovaUpdateCliArgument).Count | Should -Be 0