`promote` command specifies `-v` in help, but option does not exist
Metadata
Current evaluation
The promote help/option mismatch was addressed by legacy-command work in #5423 and released in Snapcraft 8.11.1.
Resolution: closed resolved
Reason: Maintainer mr-cal linked the mismatch to the legacy-command migration in #5423 and confirmed on August 7, 2025, that the fix would be released in Snapcraft 8.11.1.
Evaluated by: mr-cal-bot
No scores available.
Issue body
### Bug Description
I was using `snapcraft promote` today, and noticed in `snapcraft promote --help` it mentions the `-v/--verbose` option, but if actually used, it throws an error:
```
Error: No such option: -v
```
### To Reproduce
```
❯ snapcraft promote -v jnsgruk-cloudflared --from-channel edge --to-channel stable
Starting snapcraft, version 8.6.3
Logging execution to '/home/jon/.local/state/snapcraft/log/snapcraft-20250304-080634.667466.log'
Usage: snapcraft promote [OPTIONS] <snap-name>
Try 'snapcraft promote -h' for help.
Error: No such option: -v
```
### Environment
Snapcraft 8.6.3 on 24.10
### snapcraft.yaml
```yaml
n/a
```
### Relevant log output
```shell
n/a
```
### Additional context
First seen [here](https://github.com/sxyazi/yazi/pull/2435#discussion_r1978734607)
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| stealth/space-bunny-alpha | — | closed resolved | The promote help/option mismatch was addressed by legacy-command work in #5423 and released in Snapcraft 8.11.1. | |
| stealth/space-bunny-alpha | — | closed resolved | Valid bug: `promcraft promote` help advertised -v/--verbose but the option was rejected. Fixed by PR #5680 (commit 4a7663069) adding verbosity args to snapcraft_legacy non-lifecycle commands, released in Snapcraft 8.11.1. | |
| stealth/space-bunny-alpha | — | closed resolved | Fixed legacy verbosity handling for promote via PR #5680 (4a7663069), which extended PR #5646 to non-lifecycle commands. Released in Snapcraft 8.11.1. | |
| qwen/qwen3.6-35b-a3b | — | — | The promote command help text incorrectly listed a non-existent -v flag. The bug was resolved as part of legacy command cleanup #5423 and will be released in Snapcraft 8.11.1. | |
| qwen/qwen3.6-35b-a3b | — | — | Help text for the promote command incorrectly listed a non-existent -v verbose flag. The discrepancy was resolved and scheduled for release in Snapcraft 8.11.1. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | The -v option discrepancy in the snapcraft promote help text was fixed and scheduled for release in Snapcraft 8.11.1. |
Update history
No update history recorded yet.
Related work
-
Likely Fixed By:
snapcraft#5423
(confidence 96%)
The maintainer identified #5423 as the planned work resolving help-text inconsistencies in legacy commands.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #6218 refactor: migrate promote command | snapcraft | merged | Merged the promote command migration from snapcraft_legacy into the main codebase in commit 4012735f6, preserving legacy behavior. |