resources/cli/NovaCliHelp.txt

usage: nova [--version] [--help] <command> [<args>]

These are common Nova commands used in various situations:

start a new module project
   init Create a new Nova module scaffold

work with the current project
   info Show project information
   version Show the current project version, or use -Installed for the locally installed project module version
   build Build the module into the dist folder
   test Run Pester tests for the project
   bump Update the module version in project.json
   update Update the installed NovaModuleTools module using the stored prerelease preference
   notification Show or change prerelease self-update eligibility

publish and release
   publish Build, test, and publish the module locally or to a repository
   release Run the full release flow (build, test, version bump, rebuild, publish)

global options
   --help Show this help message
   --version Show the installed NovaModuleTools module name and version, including prerelease label when present
   -Verbose Show verbose output for the routed PowerShell command
   -WhatIf Preview build, test, bump, update, notification, publish, and release without changing files
   -Confirm Request confirmation before mutating routed commands; nova bump cancels cleanly on No/No to All/Suspend

Examples:
   nova init
   nova init -Path ~/Work
   nova init -Example
   nova init -Example -Path ~/Work
   nova info
   nova version
   nova version -Installed
   nova build
   nova test
   nova bump -WhatIf
   nova update
   nova notification
   nova notification -disable
   nova notification -enable
   nova publish -local
   nova publish -repository PSGallery -apikey <key>
   nova bump
   nova release -repository PSGallery -apikey <key>

After installing the module on macOS/Linux, run Install-NovaCli once if you want
the standalone 'nova' command available from zsh/bash.

Use 'nova <command>' to run a command, or call the underlying PowerShell cmdlet directly
when you want a scriptable function interface.

Use 'nova notification' to show the current prerelease self-update preference,
'nova notification -disable' to keep 'nova update' on stable releases only,
and 'nova notification -enable' to allow prerelease self-update targets again.

Use 'nova version' for the current project version from project.json,
'nova version -Installed' for the locally installed version of the current project/module,
and 'nova --version' for the installed NovaModuleTools version.

Use 'nova update' to self-update NovaModuleTools. It uses the stored prerelease
preference to decide whether a prerelease target is eligible. Stable updates proceed
normally, while prerelease targets require explicit confirmation before the update runs.

Inside PowerShell, 'nova publish -local' also reloads the published module from the
local install path after a successful publish.

Note: 'nova init' is interactive. Use 'nova init -Path <path>' for an explicit destination,
'nova init -Example' for the packaged example scaffold, and do not use 'nova init -WhatIf'.