#215 feat: enhance Install-NovaCli output with installed path and next steps guidance

Author: stiwicourage

CHANGELOG.md

@@ -21,6 +21,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 - `Get-NovaProjectInfo` now fails with clearer recovery guidance when `-Path` does not exist, points to a file, or the target folder is missing `project.json`.
 - `Get-NovaUpdateNotificationPreference -Verbose` now explains whether Nova is reading a stored preference or the built-in default, and the command help now points read-only PowerShell users to the matching `% nova notification` workflow.
 - `Initialize-NovaModule` now shows scaffold progress, ends with the created project root plus the next suggested cmdlet, and fails with clearer guidance when the target project folder already exists.
+- `Install-NovaCli` now prints the installed launcher path, suggests the next command to run, and gives a clearer `PATH` warning when the destination directory is not yet available from the shell.
 
 ### Deprecated
 

RELEASE_NOTE.md

@@ -17,6 +17,7 @@ This file summarizes the release notes for NovaModuleTools. **UNRELEASED** chang
 - `Get-NovaProjectInfo` now explains how to recover when `-Path` is invalid or the target folder is not a Nova project root.
 - `Get-NovaUpdateNotificationPreference -Verbose` now tells you whether Nova is using a stored update-notification preference or the built-in default, and the help now points to the matching `% nova notification` workflow.
 - `Initialize-NovaModule` now shows scaffold progress, ends with the project root and the next suggested cmdlet, and gives clearer recovery guidance when the target project folder already exists.
+- `Install-NovaCli` now prints the installed launcher path, suggests the next command to run, and gives a clearer `PATH` warning when the launcher directory is not yet available from the shell.
 
 ### Deprecated
 

docs/NovaModuleTools/en-US/Install-NovaCli.md

@@ -30,7 +30,8 @@ PS> Install-NovaCli [[-DestinationDirectory] <string>] [-Force] [-WhatIf] [-Conf
 By default, the launcher is installed to `~/.local/bin/nova` on macOS and Linux. If that directory is not on your
 `PATH`, the command warns so you can update your shell profile.
 
-After a successful install, `Install-NovaCli` also prints the release notes link from the installed module manifest.
+After a successful install, `Install-NovaCli` prints the installed launcher path, suggests the next command to run,
+and also prints the release notes link from the installed module manifest.
 
 Use this command when you want `nova` to be available directly from your shell as the launcher-oriented CLI entrypoint.
 
@@ -168,8 +169,13 @@ Returns the installed command name, destination directory, installed path, and w
 
 ## NOTES
 
-After running `Install-NovaCli`, add the destination directory to your shell `PATH` if needed.
+`Install-NovaCli` currently supports macOS and Linux. On Windows, use `Invoke-NovaCli` from `pwsh` after importing
+NovaModuleTools.
+
+After running `Install-NovaCli`, add the destination directory to your shell `PATH` if needed, start a new shell,
+and then run `nova --help` to confirm the launcher is available.
 
 ## RELATED LINKS
 
+- [Update-NovaModuleTool](./Update-NovaModuleTools.md)
 - [Publish-NovaModule](./Publish-NovaModule.md)

src/private/cli/InvokeNovaCliInstallWorkflow.ps1

@@ -7,16 +7,52 @@ function Invoke-NovaCliInstallWorkflow {
     $installedPath = Copy-NovaCliLauncher -SourcePath $WorkflowContext.SourcePath -TargetPath $WorkflowContext.TargetPath -Force:$WorkflowContext.Force
     $directoryOnPath = Test-NovaCliDirectoryOnPath -Directory $WorkflowContext.TargetDirectory
     if (-not $directoryOnPath) {
-        Write-Warning "Installed nova to $( $WorkflowContext.TargetDirectory ), but that directory is not currently in PATH. Add it to your shell profile before using nova directly from zsh/bash."
+        Write-Warning "Installed nova to $( $WorkflowContext.TargetDirectory ), but that directory is not currently in PATH. Add it to your shell profile, start a new shell, and then run 'nova --help'."
     }
 
     $releaseNotesUri = Get-NovaModuleReleaseNotesUri
-
-    return [pscustomobject]@{
+    $result = [pscustomobject]@{
         CommandName = 'nova'
         InstalledPath = $installedPath
         DestinationDirectory = $WorkflowContext.TargetDirectory
         DirectoryOnPath = $directoryOnPath
         ReleaseNotesUri = $releaseNotesUri
     }
+
+    Write-NovaCliInstallResult -Result $result
+    return $result
+}
+
+function Write-NovaCliInstallResult {
+    [CmdletBinding()]
+    param(
+        [Parameter(Mandatory)][pscustomobject]$Result
+    )
+
+    Write-Host "Installed nova launcher: $( $Result.InstalledPath )"
+
+    foreach ($line in (Get-NovaCliInstallNextStepLine -Result $Result)) {
+        Write-Host $line
+    }
+}
+
+function Get-NovaCliInstallNextStepLine {
+    [CmdletBinding()]
+    param(
+        [Parameter(Mandatory)][pscustomobject]$Result
+    )
+
+    if ($Result.DirectoryOnPath) {
+        return @(
+            'Next step:'
+            'nova --help'
+        )
+    }
+
+    return @(
+        'Next steps:'
+        "Add $( $Result.DestinationDirectory ) to your PATH"
+        'Start a new shell'
+        'nova --help'
+    )
 }

tests/private/cli/InvokeNovaCliInstallWorkflow.Tests.ps1

@@ -9,6 +9,8 @@ BeforeAll {
 
 Describe 'Invoke-NovaCliInstallWorkflow' {
     It 'returns workflow result when directory is on PATH' {
+        Mock Write-Host {}
+
         $ctx = [pscustomobject]@{
             SourcePath = '/tmp/src/nova'
             TargetPath = '/usr/local/bin/nova'
@@ -20,12 +22,25 @@ Describe 'Invoke-NovaCliInstallWorkflow' {
         $result.InstalledPath | Should -Be '/usr/local/bin/nova'
         $result.DirectoryOnPath | Should -BeTrue
         $result.ReleaseNotesUri | Should -Be 'https://example.test/notes'
+        Assert-MockCalled Write-Host -Times 3
+        Assert-MockCalled Write-Host -Times 1 -ParameterFilter {
+            $Object -eq 'Installed nova launcher: /usr/local/bin/nova' -or $args -contains 'Installed nova launcher: /usr/local/bin/nova'
+        }
+        Assert-MockCalled Write-Host -Times 1 -ParameterFilter {
+            $Object -eq 'nova --help' -or $args -contains 'nova --help'
+        }
     }
 
     It 'warns when target directory is not on PATH' {
+        Mock Write-Host {}
         Mock Test-NovaCliDirectoryOnPath {return $false}
         $ctx = [pscustomobject]@{SourcePath = '/s'; TargetPath = '/t/nova'; TargetDirectory = '/t'; Force = $false}
         Invoke-NovaCliInstallWorkflow -WorkflowContext $ctx -WarningVariable warning -WarningAction SilentlyContinue | Out-Null
         $warning.Count | Should -BeGreaterThan 0
+        $warning[0].Message | Should -Be "Installed nova to /t, but that directory is not currently in PATH. Add it to your shell profile, start a new shell, and then run 'nova --help'."
+        Assert-MockCalled Write-Host -Times 4
+        Assert-MockCalled Write-Host -Times 1 -ParameterFilter {
+            $Object -eq 'Add /t to your PATH' -or $args -contains 'Add /t to your PATH'
+        }
     }
 }