[BUG] --host option documented for marketplace add does not exist in CLI

[kkadete]

Describe the bug
The documentation at https://microsoft.github.io/apm/guides/marketplaces/#register-a-marketplace shows the following example command:

apm marketplace add acme/plugin-marketplace --host ghes.corp.example.com

However, running this command results in an error stating --host is not a valid option.

To Reproduce
Steps to reproduce the behavior:

Run command apm marketplace add
With parameters acme/plugin-marketplace --host ghes.corp.example.com
See error

$ mx apm marketplace add acme/plugin-marketplace --host ghes.corp.example.com
Usage: apm.exe marketplace add [OPTIONS] REPO
Try 'apm.exe marketplace add --help' for help.

Error: No such option: --host

Expected behavior
The --host option should be accepted by apm marketplace add to allow specifying a GitHub Enterprise Server (GHES) host, as documented in the official guide.

Environment (please complete the following information):

OS: Windows
Python Version: 3.9.16
APM Version: 0.8.11
VSCode Version (if relevant): N/A

Logs

$ mx apm marketplace add acme/plugin-marketplace --host ghes.corp.example.com
Usage: apm.exe marketplace add [OPTIONS] REPO
Try 'apm.exe marketplace add --help' for help.

Error: No such option: --host

Additional context
Either the --host option is missing from the CLI implementation and needs to be added, or the documentation example needs to be corrected to reflect the actual supported options. Output of apm marketplace add --help:

apm marketplace add --help
Usage: apm.exe marketplace add [OPTIONS] REPO

  Register a plugin marketplace

Options:
  -n, --name TEXT    Display name (defaults to repo name)
  -b, --branch TEXT  Branch to use  [default: main]
  -v, --verbose      Show detailed output
  --help             Show this message and exit.

[sergio-sisternes-epam]

Hi @kkadete, thanks for reporting this!

The --host option for apm marketplace add was added after the v0.8.11 release. We've verified it works correctly on the current main branch -- the flag is accepted and correctly routes API calls to the specified GHES host.

The mismatch you encountered is because our documentation site is published on merge to main, not on release -- so the docs can reference features that aren't yet available in the latest published binary.

Until the next release is published, you can install from source to get this fix:

pip install git+https://github.com/microsoft/apm.git

We'll close this as resolved since the fix is already in main. It will be included in the next release.