fix(cli): support -g for vp toolchain --global

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_toolchain/snapshots.toml

@@ -24,6 +24,7 @@ name = "toolchain_json"
 vp = "global"
 steps = [
   { argv = ["vp", "toolchain", "vite", "--json", "--global"], tty = false, comment = "JSON contains one node per ID and no CLI header" },
+  { argv = ["vp", "toolchain", "vite", "--json", "-g"], tty = false, comment = "the short global flag supports filters and JSON output" },
 ]
 
 [[case]]

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_toolchain/snapshots/toolchain_json.md

@@ -106,3 +106,110 @@ JSON contains one node per ID and no CLI header
   ]
 }
 ```
+
+## `vp toolchain vite --json -g`
+
+the short global flag supports filters and JSON output
+
+```
+{
+  "schemaVersion": 1,
+  "source": {
+    "scope": "global",
+    "path": "<home>/.vite-plus/current/node_modules/vite-plus",
+    "vitePlusVersion": "<version>"
+  },
+  "nodes": [
+    {
+      "id": "vite-plus",
+      "name": "vite-plus",
+      "version": "<version>",
+      "kind": "package",
+      "delivery": [
+        "dependency"
+      ],
+      "aliases": []
+    },
+    {
+      "id": "vite-plus-core",
+      "name": "@voidzero-dev/vite-plus-core",
+      "version": "<version>",
+      "kind": "package",
+      "delivery": [
+        "dependency"
+      ],
+      "aliases": [
+        "vite-plus-core"
+      ]
+    },
+    {
+      "id": "vite",
+      "name": "vite",
+      "version": "<version>",
+      "kind": "tool",
+      "delivery": [
+        "bundled"
+      ],
+      "aliases": []
+    },
+    {
+      "id": "rolldown",
+      "name": "rolldown",
+      "version": "<version>",
+      "kind": "tool",
+      "delivery": [
+        "bundled",
+        "compiled"
+      ],
+      "aliases": []
+    },
+    {
+      "id": "oxc",
+      "name": "oxc",
+      "version": "<version>",
+      "kind": "engine",
+      "delivery": [
+        "compiled"
+      ],
+      "aliases": []
+    },
+    {
+      "id": "oxc-resolver",
+      "name": "oxc-resolver",
+      "version": "<version>",
+      "kind": "engine",
+      "delivery": [
+        "compiled"
+      ],
+      "aliases": []
+    }
+  ],
+  "edges": [
+    {
+      "from": "vite-plus",
+      "to": "vite-plus-core",
+      "relationship": "depends-on"
+    },
+    {
+      "from": "vite-plus-core",
+      "to": "vite",
+      "relationship": "bundles"
+    },
+    {
+      "from": "vite",
+      "to": "rolldown",
+      "relationship": "uses"
+    },
+    {
+      "from": "rolldown",
+      "to": "oxc",
+      "relationship": "compiles"
+    },
+    {
+      "from": "rolldown",
+      "to": "oxc-resolver",
+      "relationship": "compiles"
+    }
+  ]
+}
+```

crates/vp_global_cli/src/cli.rs

@@ -220,7 +220,7 @@ pub enum Commands {
         json: bool,
 
         /// Use the global Vite+ toolchain
-        #[arg(long)]
+        #[arg(short = 'g', long)]
         global: bool,
     },
 
@@ -1344,6 +1344,20 @@ mod tests {
         assert_eq!(raw_subcommand(&argv(&["vp", "--version"])), None);
     }
 
+    #[test]
+    fn parses_toolchain_global_flags() {
+        for flag in ["--global", "-g"] {
+            let parsed = try_parse_args_from(argv(&["vp", "toolchain", "vite", "--json", flag]))
+                .expect("toolchain global flag should parse");
+            let Some(Commands::Toolchain { tools, json, global }) = parsed.command else {
+                panic!("expected toolchain command");
+            };
+            assert_eq!(tools, vec!["vite"]);
+            assert!(json);
+            assert!(global);
+        }
+    }
+
     #[test]
     fn parses_sync_versions_as_machine_readable_global_command() {
         let parsed = try_parse_args_from(argv(&["vp", "sync-versions", "--json"]))

docs/guide/upgrade.md

@@ -22,7 +22,7 @@ vp toolchain vite rolldown oxc
 vp toolchain --json
 ```
 
-The command uses the local `vite-plus` package when the project has one. Use `--global` to show the release for the global `vp` command:
+The command uses the local `vite-plus` package when the project has one. Use `--global` or `-g` to show the release for the global `vp` command:
 
 ```bash
 vp toolchain --global

packages/cli/binding/src/cli/types.rs

@@ -118,7 +118,7 @@ pub struct ToolchainArgs {
     pub json: bool,
 
     /// Use the global Vite+ toolchain
-    #[arg(long)]
+    #[arg(short = 'g', long)]
     pub global: bool,
 }
 

rfcs/toolchain-command.md

@@ -108,7 +108,7 @@ Arguments:
 
 Options:
       --json    Print the graph as JSON
-      --global  Use the global Vite+ toolchain
+  -g, --global  Use the global Vite+ toolchain
   -h, --help    Print help
 ```