feat(cli): advertise VP_USER_AGENT to child processes

crates/vite_global_cli/src/main.rs

@@ -294,8 +294,29 @@ fn print_unknown_argument_error(error: &clap::Error) -> bool {
     true
 }
 
-#[tokio::main]
-async fn main() -> ExitCode {
+fn main() -> ExitCode {
+    // Advertise that this process tree is running under Vite+ so the tools we
+    // invoke (e.g. `vp dlx create-vite`) can detect vp as the package manager.
+    // The underlying package managers overwrite `npm_config_user_agent` with
+    // their own value, so we expose a dedicated variable that is passed through
+    // untouched and inherited by every child process (including the `npx`
+    // fallback used when there is no local `package.json`). Shim mode clears it
+    // again below, since there the user invokes the wrapped tool, not vp.
+    //
+    // SAFETY: `set_var` must run while the process is still single-threaded.
+    // This is the first statement in `main`, before the async runtime (and its
+    // worker threads) are created.
+    unsafe {
+        std::env::set_var(
+            vite_shared::env_vars::VP_USER_AGENT,
+            concat!("vp/", env!("CARGO_PKG_VERSION")),
+        );
+    }
+
+    tokio::runtime::Runtime::new().expect("failed to build tokio runtime").block_on(run())
+}
+
+async fn run() -> ExitCode {
     // Initialize tracing
     vite_shared::init_tracing();
 
@@ -317,6 +338,11 @@ async fn main() -> ExitCode {
     if let Some(tool) = shim::detect_shim_tool(argv0) {
         // Shim mode - dispatch to the appropriate tool. stdout belongs to the
         // wrapped tool; route vp's own output to stderr.
+        //
+        // The user is invoking the wrapped tool (e.g. `npm`/`npx`), not vp, so
+        // don't advertise vp to it or its children. Clear the marker set in
+        // `main` before dispatching. SAFETY: see the `set_var` in `main`.
+        unsafe { std::env::remove_var(vite_shared::env_vars::VP_USER_AGENT) };
         output::route_user_output_to_stderr();
         let exit_code = shim::dispatch(&tool, &args[1..]).await;
         return ExitCode::from(exit_code as u8);

crates/vite_shared/src/env_vars.rs

@@ -80,6 +80,13 @@ pub const VP_CLI_BIN: &str = "VP_CLI_BIN";
 /// Global CLI version, passed from Rust binary to JS for --version display.
 pub const VP_GLOBAL_VERSION: &str = "VP_GLOBAL_VERSION";
 
+/// Advertises that the process tree is running under Vite+ (value: `vp/<version>`).
+///
+/// Set once at startup and inherited by every child process. Tools we invoke
+/// (e.g. `vp dlx create-vite`) read it to detect vp as the package manager,
+/// since the underlying package manager overwrites `npm_config_user_agent`.
+pub const VP_USER_AGENT: &str = "VP_USER_AGENT";
+
 // ── HTTP client TLS / CA configuration ──────────────────────────────────
 
 /// Path to a PEM bundle of extra CA certificates to trust for HTTPS.