Command help 'See also' should filter hidden commands
Metadata
Current evaluation
Fixed in merged PR #452 (commit 574d243): command help now excludes hidden commands from the "See also" list.
Resolution: closed resolved
Reason: PR #452 was merged and added a hidden-command check when building the "See also" recommendations, resolving the incorrect promotion of deprecated aliases.
Evaluated by: mr-cal-bot
No scores available.
Issue body
### What needs to get done
Craft cli should filter out hidden commands in the "See also" text [here](https://github.com/canonical/craft-cli/blob/bca0d663438c4a1e5818707c56da03460db8308f/craft_cli/helptexts.py#L477-L479).
### Why it needs to get done
Because we show hidden (deprecated or removed) commands in snapcraft:
```bash
> snapcraft extensions --help
Usage:
snapcraft extensions [options]
...
See also:
expand-extensions
list-extensions
> snapcraft list-extensions
The 'list-extensions' command was renamed to 'extensions'.
Recommended resolution: Use 'extensions' instead.
```
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| stealth/space-bunny-alpha | — | closed resolved | Fixed in merged PR #452 (commit 574d243): command help now excludes hidden commands from the "See also" list. | |
| stealth/space-bunny-alpha | — | closed resolved | Fixed hidden-command recommendations in command help: PR #452 (commit 574d243) filters hidden commands from the "See also" list. | |
| qwen/qwen3.6-35b-a3b | — | — | Closed and synced to Jira ticket CRAFT-5213. No fix or pull request was merged. The issue appears abandoned in this repository. | |
| qwen/qwen3.6-35b-a3b | — | — | Closed without a direct fix. The issue was synced to Jira (CRAFT-5213) for internal tracking, indicating it was deferred or resolved externally. No pull request or merge details were provided. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Closed without a documented fix or resolution. The report requested filtering hidden commands from the CLI help See also section, but contains no merge or implementation details. |
Update history
No update history recorded yet.
Related work
-
Likely Fixed By:
canonical/craft-cli#452
(confidence 100%)
Merged fix commit 574d243 filters hidden commands and directly resolves #449.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #452 fix: don't recommend hidden commands | craft-cli | merged | Merged PR #452 via commit 574d243 fixes CRAFT-5213 by excluding hidden commands from “See also” recommendations in command help, resolving issue #449. | |
| #72 Introduce the concept of hidden commands. | craft-cli | merged | Merged PR #72 as commit 377ec17, introducing hidden commands that remain usable but are excluded from help and cannot also be common. | |
| #297 Hidden commands are suggested as alternatives for command not found | craft-cli | closed | Hidden-command suggestions were fixed in merged PR #302 (commit 4be3f0c), filtering hidden commands out of command-not-found alternatives. |