feat(upgrade): use installed_tool completer for mise upgrade

docs/cli/index.md

@@ -170,7 +170,7 @@ Can also use `MISE_NO_HOOKS=1`
 - [`mise uninstall [-a --all] [-n --dry-run] [INSTALLED_TOOL@VERSION]…`](/cli/uninstall.md)
 - [`mise unset [-f --file <FILE>] [-g --global] [ENV_KEY]…`](/cli/unset.md)
 - [`mise unuse [FLAGS] <INSTALLED_TOOL@VERSION>…`](/cli/unuse.md)
-- [`mise upgrade [FLAGS] [TOOL@VERSION]…`](/cli/upgrade.md)
+- [`mise upgrade [FLAGS] [INSTALLED_TOOL@VERSION]…`](/cli/upgrade.md)
 - [`mise use [FLAGS] [TOOL@VERSION]…`](/cli/use.md)
 - [`mise version [-J --json]`](/cli/version.md)
 - [`mise watch [FLAGS] [TASK] [ARGS]…`](/cli/watch.md)

docs/cli/upgrade.md

@@ -1,7 +1,7 @@
 <!-- @generated by usage-cli from usage spec -->
 # `mise upgrade`
 
-- **Usage**: `mise upgrade [FLAGS] [TOOL@VERSION]…`
+- **Usage**: `mise upgrade [FLAGS] [INSTALLED_TOOL@VERSION]…`
 - **Aliases**: `up`
 - **Source code**: [`src/cli/upgrade.rs`](https://github.com/jdx/mise/blob/main/src/cli/upgrade.rs)
 
@@ -15,7 +15,7 @@ This will update mise.lock if it is enabled, see <https://mise.jdx.dev/configura
 
 ## Arguments
 
-### `[TOOL@VERSION]…`
+### `[INSTALLED_TOOL@VERSION]…`
 
 Tool(s) to upgrade
 e.g.: node@20 python@3.10

man/man1/mise.1

@@ -2824,7 +2824,7 @@ and bump the version in mise.toml.
 
 This will update mise.lock if it is enabled, see https://mise.jdx.dev/configuration/settings.html#lockfile
 .PP
-\fBUsage:\fR mise upgrade [OPTIONS] [<TOOL@VERSION>] ...
+\fBUsage:\fR mise upgrade [OPTIONS] [<INSTALLED_TOOL@VERSION>] ...
 .PP
 \fBOptions:\fR
 .PP
@@ -2862,7 +2862,7 @@ Directly pipe stdin/stdout/stderr from plugin to user Sets \-\-jobs=1
 \fBArguments:\fR
 .PP
 .TP
-\fB<TOOL@VERSION>\fR
+\fB<INSTALLED_TOOL@VERSION>\fR
 Tool(s) to upgrade
 e.g.: node@20 python@3.10
 If not specified, all current tools will be upgraded

mise.usage.kdl

@@ -1129,7 +1129,7 @@ cmd upgrade help="Upgrades outdated tools" {
         arg <BEFORE>
     }
     flag --raw help="Directly pipe stdin/stdout/stderr from plugin to user Sets --jobs=1"
-    arg "[TOOL@VERSION]…" help="Tool(s) to upgrade\ne.g.: node@20 python@3.10\nIf not specified, all current tools will be upgraded" required=#false var=#true
+    arg "[INSTALLED_TOOL@VERSION]…" help="Tool(s) to upgrade\ne.g.: node@20 python@3.10\nIf not specified, all current tools will be upgraded" required=#false var=#true
 }
 cmd usage hide=#true help="Generate a usage CLI spec" {
     long_help "Generate a usage CLI spec\n\nSee https://usage.jdx.dev for more information on this specification."

src/cli/upgrade.rs

@@ -28,7 +28,7 @@ pub struct Upgrade {
     /// Tool(s) to upgrade
     /// e.g.: node@20 python@3.10
     /// If not specified, all current tools will be upgraded
-    #[clap(value_name = "TOOL@VERSION", verbatim_doc_comment)]
+    #[clap(value_name = "INSTALLED_TOOL@VERSION", verbatim_doc_comment)]
     tool: Vec<ToolArg>,
 
     /// Display multiselect menu to choose which tools to upgrade

xtasks/fig/src/mise.ts

@@ -3286,12 +3286,12 @@ const completionSpec: Fig.Spec = {
         },
       ],
       args: {
-        name: "tool@version",
+        name: "installed_tool@version",
         description:
           "Tool(s) to upgrade\ne.g.: node@20 python@3.10\nIf not specified, all current tools will be upgraded",
         isOptional: true,
         isVariadic: true,
-        generators: toolVersionGenerator,
+        generators: installedToolVersionGenerator,
         debounce: true,
       },
     },