This updates MaintainModule to be leaner and more predictable while improving command UX. It tightens parameter metadata and validation, makes -Verbose / -WhatIf behavior flow through nested operations, and removes a few cross-platform rough edges.

• Performance and structure

  • Reduced unnecessary allocations during installed-module discovery and version processing.
  • Replaced repeated lookups with focused helpers for:
    • caller preference propagation
    • module name normalization/deduplication
    • latest repository version lookup
  • Simplified internal data flow so update/install/uninstall paths share less duplicated logic.

• Command surface improvements

  • Added missing HelpMessage metadata across parameters.
  • Strengthened validation on user-facing inputs such as module names and version collections.
  • Kept SupportsShouldProcess behavior consistent so nested actions respect -WhatIf and -Verbose.

• Compatibility

  • Updated the manifest to declare both Desktop and Core editions.
  • Stopped exporting variables from the module manifest.
  • Switched the publish script to Join-Path for path handling that works cleanly on Windows and macOS.

• Robustness

  • Added explicit version parsing error handling for installed module metadata.
  • Documented the repository lookup behavior where only the newest version is required.

• Documentation

  • Added README notes for -Verbose and -WhatIf usage.

Example:

Update-rsModule -Module 'Pester' -UninstallOldVersion -WhatIf -Verbose

This now previews both update and cleanup actions while surfacing the internal decision flow through verbose output.