Skip to content

[Bug]: PowerShell surface lacks a nova --version equivalent for installed NovaModuleTools version #152

@stiwicourage

Description

@stiwicourage

Summary

Get-NovaProjectInfo only exposes -Version for the project version and does not provide a PowerShell equivalent to nova --version / an -Installed view for the installed NovaModuleTools version.

Steps to reproduce

  1. Open PowerShell in a NovaModuleTools project.
  2. Run:
Get-Help Get-NovaProjectInfo
  1. Observe the documented syntax and description.
  2. Compare that PowerShell surface with the CLI behavior from:
nova --version

Expected behavior

There should be a PowerShell equivalent to nova --version for the installed NovaModuleTools version, or Get-NovaProjectInfo should support/document an -Installed-style switch if that is the intended cmdlet surface.

At minimum, the PowerShell command surface should make it possible to retrieve the installed NovaModuleTools version in a way that matches the CLI capability.

Actual behavior

Get-Help Get-NovaProjectInfo only shows:

SYNTAX
    PS> [[-Path] <System.String>] [-Version <System.Management.Automation.SwitchParameter>] [<CommonParameters>]

and the help text says:

When you use `-Version`, the command returns only the project version string instead of the full project object.

So the PowerShell side exposes the project version, but not the installed NovaModuleTools version equivalent to nova --version.

NovaModuleTools version

2.1.1-preview04

Where did you hit the issue?

PowerShell cmdlet

Command or cmdlet

Get-Help Get-NovaProjectInfo

Relevant output or logs

PS /Users/stiwi.courage/workspace/couragedk/AzureDevOpsAgentInstaller> get-help Get-NovaProjectInfo

NAME
    Get-NovaProjectInfo

SYNOPSIS
    Reads `project.json` and returns resolved NovaModuleTools project metadata.


SYNTAX
    PS> [[-Path] <System.String>] [-Version <System.Management.Automation.SwitchParameter>] [<CommonParameters>]


DESCRIPTION
    `Get-NovaProjectInfo` reads the `project.json` file in a NovaModuleTools project and returns a project information object with:

    - the raw project metadata - normalized project paths such as `src/`, `tests/`, `docs/`, and `dist/` - defaulted build settings such as `BuildRecursiveFolders`, `SetSourcePath`, and `CopyResourcesToModuleRoot` - the resolved module output file paths for the generated `.psm1` and `.psd1`

    Use this command from scripts, tests, or troubleshooting when you want one object that describes the current project.

    When you use `-Version`, the command returns only the project version string instead of the full project object.


RELATED LINKS
    Online Version

REMARKS
    To see the examples, type: "Get-Help Get-NovaProjectInfo -Examples"
    For more information, type: "Get-Help Get-NovaProjectInfo -Detailed"
    For technical information, type: "Get-Help Get-NovaProjectInfo -Full"
    For online help, type: "Get-Help Get-NovaProjectInfo -Online"

Relevant project.json snippet

{}

Operating system

macOS 26.4.1

PowerShell version

7.5.4

Shell

zsh

Installation method

Installed nova launcher

Regression?

Not sure

Additional context

The CLI already has a clear installed-version view through nova --version, but the PowerShell cmdlet surface shown here does not expose an equivalent installed-module version lookup.

Pre-submit checklist

  • I searched existing issues to avoid creating a duplicate.
  • I included enough detail for someone else to reproduce the issue.
  • This is not a security vulnerability report.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Projects

    Status

    Done

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions