Products: upgrade preview
products.upgradePreview is a CLI native declaration.
Access
products.upgradePreview is included in the public @merulan/cli 0.1.0 artifact. Production use remains Preview until the linked live behavior is qualified.
Public acquisition: Available. Coordinate: @merulan/cli. Version: 0.1.0. Live operation: Preview. Production calls and readback are not yet qualified. Evidence: 2026-09-17.
Native syntax
products.upgradePreview uses this native callable form.
merulan products upgradePreview --installation-id <value> --target-version <value> [--expected-current-plan <json>] [--expected-target-plan <json>] --expected-install-updated-at <value> --expected-manifest-digest <value> --expected-configuration-revision <value> [--bindings <json>] [--product-config <json>]Arguments
products.upgradePreview accepts the native arguments below.
| Argument | Native type |
|---|---|
| --installation-id | required option <value> |
| --target-version | required option <value> |
| --expected-current-plan | optional option <json> |
| --expected-target-plan | optional option <json> |
| --expected-install-updated-at | required option <value> |
| --expected-manifest-digest | required option <value> |
| --expected-configuration-revision | required option <value> |
| --bindings | optional option <json> |
| --product-config | optional option <json> |
Response
products.upgradePreview has no result shape in its native authority.
Shared operation meaning
products.upgradePreview delegates operation meaning to products.upgradePreview. That operation owns authorization, failures, and readback. products.upgradePreview preserves native adapter syntax without translating it into HTTP syntax.
Availability
products.upgradePreview is included in the public @merulan/cli 0.1.0 artifact. Production use remains Preview until the linked live behavior is qualified.
Public acquisition: Available. Coordinate: @merulan/cli. Version: 0.1.0. Live operation: Preview. Production calls and readback are not yet qualified. Evidence: 2026-09-17.
Readback
products.upgradePreview uses the shared operation readback when one is linked above. Otherwise, products.upgradePreview has no separate native readback contract.