feat(cli): interactive package picker for bare app commands at the workspace root

fengmk2 · fengmk2 · commit 6bdf47c0110c · 2026-07-08T23:13:43.000+08:00
Replaces the interim TTY listing with the fuzzy vite_select picker (the vp run selector component): typing filters packages, Enter runs the selection as an implicit -C, Ctrl+C cancels with exit 130. Single-runnable auto-select and the non-interactive listing are unchanged. Every picker render emits a package-select:<query>:<index> milestone so PTY snapshot tests synchronize on real keystrokes (picker_select / picker_cancel / non-TTY listing cases, both flavors). Requires the configurable prompt from voidzero-dev/vite-task#510; the vite-task pin points at that PR's commit and needs a re-bump to vite-task main after it merges.
diff --git a/Cargo.toml b/Cargo.toml
@@ -194,7 +194,7 @@ dunce = "1.0.5"
 fast-glob = "1.0.0"
 flate2 = { version = "=1.1.9", features = ["zlib-rs"] }
 form_urlencoded = "1.2.1"
-fspy = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "417b6aae5fca92b128c586c8ff3421e43911b553" }
+fspy = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "ca55bb232aa8" }
 futures = "0.3.31"
 futures-util = "0.3.31"
 glob = "0.3.2"
@@ -251,8 +251,8 @@ pretty_assertions = "1.4.1"
 phf = "0.13.0"
 prettyplease = "0.2.32"
 proc-macro2 = "1"
-pty_terminal_test = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "417b6aae5fca92b128c586c8ff3421e43911b553" }
-pty_terminal_test_client = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "417b6aae5fca92b128c586c8ff3421e43911b553" }
+pty_terminal_test = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "ca55bb232aa8" }
+pty_terminal_test_client = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "ca55bb232aa8" }
 quote = "1"
 rayon = "1.10.0"
 regex = "1.11.1"
@@ -276,7 +276,7 @@ sha2 = "0.10.9"
 shell-escape = "0.1.5"
 simdutf8 = "0.1.5"
 smallvec = { version = "1.15.1", features = ["union"] }
-snapshot_test = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "417b6aae5fca92b128c586c8ff3421e43911b553" }
+snapshot_test = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "ca55bb232aa8" }
 string_cache = "0.9.0"
 sugar_path = { version = "2.0.1", features = ["cached_current_dir"] }
 supports-color = "3"
@@ -313,11 +313,12 @@ vite_pm_cli = { path = "crates/vite_pm_cli" }
 vite_setup = { path = "crates/vite_setup" }
 vite_shared = { path = "crates/vite_shared" }
 vite_static_config = { path = "crates/vite_static_config" }
-vite_path = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "417b6aae5fca92b128c586c8ff3421e43911b553" }
-vite_powershell = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "417b6aae5fca92b128c586c8ff3421e43911b553" }
-vite_str = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "417b6aae5fca92b128c586c8ff3421e43911b553" }
-vite_task = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "417b6aae5fca92b128c586c8ff3421e43911b553" }
-vite_workspace = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "417b6aae5fca92b128c586c8ff3421e43911b553" }
+vite_path = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "ca55bb232aa8" }
+vite_powershell = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "ca55bb232aa8" }
+vite_select = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "ca55bb232aa8" }
+vite_str = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "ca55bb232aa8" }
+vite_task = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "ca55bb232aa8" }
+vite_workspace = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "ca55bb232aa8" }
 walkdir = "2.5.0"
 wax = "0.6.0"
 which = "8.0.0"
diff --git a/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_listing/snapshots.toml b/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_listing/snapshots.toml
@@ -2,8 +2,36 @@
 name = "listing"
 vp = ["local", "global"]
 comment = """
-A bare app command at a workspace root with several candidate packages prints
+A bare app command at a workspace root without an interactive terminal prints
 the ranked package listing with -C hints and exits 1 instead of building the
-root, even in an interactive terminal (rfcs/cwd-flag.md).
+root (rfcs/cwd-flag.md).
 """
-steps = [["vp", "build"]]
+steps = [{ argv = ["vp", "build"], tty = false }]
+
+[[case]]
+name = "picker_select"
+vp = ["local", "global"]
+comment = """
+A bare app command at a workspace root with several candidates opens the
+fuzzy package picker (the vp run selector component); typing filters, Enter
+runs the selection as an implicit -C (rfcs/cwd-flag.md).
+"""
+steps = [
+  { argv = ["vp", "build"], interactions = [
+    { "expect-milestone" = "package-select::0" },
+    { "write" = "web" },
+    { "expect-milestone" = "package-select:web:0" },
+    { "write-key" = "enter" },
+  ] },
+]
+
+[[case]]
+name = "picker_cancel"
+vp = ["local", "global"]
+comment = "Ctrl+C in the package picker cancels with exit 130 and runs nothing."
+steps = [
+  { argv = ["vp", "build"], interactions = [
+    { "expect-milestone" = "package-select::0" },
+    { "write-key" = "ctrl-c" },
+  ] },
+]
diff --git a/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_listing/snapshots/listing.global.md b/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_listing/snapshots/listing.global.md
@@ -1,17 +1,15 @@
 # listing
 
-A bare app command at a workspace root with several candidate packages prints
+A bare app command at a workspace root without an interactive terminal prints
 the ranked package listing with -C hints and exits 1 instead of building the
-root, even in an interactive terminal (rfcs/cwd-flag.md).
+root (rfcs/cwd-flag.md).
 
 ## `vp build`
 
 **Exit code:** 1
 
 ```
-VITE+ - The Unified Toolchain for the Web
-
-error: `vp build` at the workspace root needs a target package.
+[1m[31merror:[39m[0m `vp build` at the workspace root needs a target package.
 
   Packages in this workspace:
     admin  apps/admin
diff --git a/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_listing/snapshots/listing.local.md b/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_listing/snapshots/listing.local.md
@@ -1,15 +1,15 @@
 # listing
 
-A bare app command at a workspace root with several candidate packages prints
+A bare app command at a workspace root without an interactive terminal prints
 the ranked package listing with -C hints and exits 1 instead of building the
-root, even in an interactive terminal (rfcs/cwd-flag.md).
+root (rfcs/cwd-flag.md).
 
 ## `vp build`
 
 **Exit code:** 1
 
 ```
-error: `vp build` at the workspace root needs a target package.
+[1m[31merror:[39m[0m `vp build` at the workspace root needs a target package.
 
   Packages in this workspace:
     admin  apps/admin
diff --git a/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_listing/snapshots/picker_cancel.global.md b/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_listing/snapshots/picker_cancel.global.md
@@ -0,0 +1,25 @@
+# picker_cancel
+
+Ctrl+C in the package picker cancels with exit 130 and runs nothing.
+
+## `vp build`
+
+**Exit code:** 130
+
+**→ expect-milestone:** `package-select::0`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Select a package to build (↑/↓, Enter to run, type to search):
+
+  › admin apps/admin
+    web   apps/web
+    ui    packages/ui
+```
+
+**← write-key:** `ctrl-c`
+
+```
+VITE+ - The Unified Toolchain for the Web
+```
diff --git a/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_listing/snapshots/picker_cancel.local.md b/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_listing/snapshots/picker_cancel.local.md
@@ -0,0 +1,22 @@
+# picker_cancel
+
+Ctrl+C in the package picker cancels with exit 130 and runs nothing.
+
+## `vp build`
+
+**Exit code:** 130
+
+**→ expect-milestone:** `package-select::0`
+
+```
+Select a package to build (↑/↓, Enter to run, type to search):
+
+  › admin apps/admin
+    web   apps/web
+    ui    packages/ui
+```
+
+**← write-key:** `ctrl-c`
+
+```
+```
diff --git a/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_listing/snapshots/picker_select.global.md b/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_listing/snapshots/picker_select.global.md
@@ -0,0 +1,46 @@
+# picker_select
+
+A bare app command at a workspace root with several candidates opens the
+fuzzy package picker (the vp run selector component); typing filters, Enter
+runs the selection as an implicit -C (rfcs/cwd-flag.md).
+
+## `vp build`
+
+**→ expect-milestone:** `package-select::0`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Select a package to build (↑/↓, Enter to run, type to search):
+
+  › admin apps/admin
+    web   apps/web
+    ui    packages/ui
+```
+
+**← write:** `web`
+
+**→ expect-milestone:** `package-select:web:0`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Select a package to build (↑/↓, Enter to run, type to search): web
+
+  › web apps/web
+```
+
+**← write-key:** `enter`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Selected package: web (apps/web)
+Tip: run this directly with `vp -C apps/web build`
+vite <version> building client environment for production...
+✓ 2 modules transformed.
+computing gzip size...
+dist/index.html  0.06 kB │ gzip: 0.06 kB
+
+✓ built in <duration>
+```
diff --git a/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_listing/snapshots/picker_select.local.md b/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_listing/snapshots/picker_select.local.md
@@ -0,0 +1,40 @@
+# picker_select
+
+A bare app command at a workspace root with several candidates opens the
+fuzzy package picker (the vp run selector component); typing filters, Enter
+runs the selection as an implicit -C (rfcs/cwd-flag.md).
+
+## `vp build`
+
+**→ expect-milestone:** `package-select::0`
+
+```
+Select a package to build (↑/↓, Enter to run, type to search):
+
+  › admin apps/admin
+    web   apps/web
+    ui    packages/ui
+```
+
+**← write:** `web`
+
+**→ expect-milestone:** `package-select:web:0`
+
+```
+Select a package to build (↑/↓, Enter to run, type to search): web
+
+  › web apps/web
+```
+
+**← write-key:** `enter`
+
+```
+Selected package: web (apps/web)
+Tip: run this directly with `vp -C apps/web build`
+vite <version> building client environment for production...
+✓ 2 modules transformed.
+computing gzip size...
+dist/index.html  0.06 kB │ gzip: 0.06 kB
+
+✓ built in <duration>
+```
diff --git a/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/vp_help/snapshots/help.global.md b/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/vp_help/snapshots/help.global.md
@@ -58,5 +58,6 @@ Documentation: https://viteplus.dev/guide/
 
 Options:
   -V, --version  Print version
+  -C <DIR>       Run as if vp was started in <DIR> instead of the current working directory
   -h, --help     Print help
 ```
diff --git a/docs/guide/monorepo.md b/docs/guide/monorepo.md
@@ -164,10 +164,28 @@ Tip: run this directly with `vp -C apps/web dev`
   ➜  Network: use --host to expose
 ```
 
-When several packages could be the target, vp lists them with ready-to-copy commands instead of guessing:
+When several packages could be the target, vp opens a fuzzy package picker (the same selector as `vp run`). Typing filters, Enter runs the selection, and vp prints the direct command for next time:
 
 ```
 $ vp build
+Select a package to build (↑/↓, Enter to run, type to search):
+
+  › admin apps/admin
+    web   apps/web
+    ui    packages/ui
+```
+
+```
+Selected package: web (apps/web)
+Tip: run this directly with `vp -C apps/web build`
+
+  ✓ built in 187ms
+```
+
+In non-interactive shells (CI, pipes, redirection), vp prints the same packages as a plain listing with ready-to-copy commands and exits 1:
+
+```
+$ vp build | cat
 error: `vp build` at the workspace root needs a target package.
 
   Packages in this workspace:
@@ -179,7 +197,7 @@ error: `vp build` at the workspace root needs a target package.
   Or run every package's build script:  vp run -r build
 ```
 
-Packages that look runnable for the command (an `index.html` or `vite.config.*` for `dev` / `build` / `preview`, a library entry for `pack`) are listed first.
+Packages that look runnable for the command (an `index.html` or `vite.config.*` for `dev` / `build` / `preview`, a library entry for `pack`) are ranked first in both the picker and the listing.
 
 ### Targeting a package with `-C`
 
diff --git a/packages/cli/binding/Cargo.toml b/packages/cli/binding/Cargo.toml
@@ -21,6 +21,7 @@ napi = { workspace = true }
 napi-derive = { workspace = true }
 petgraph = { workspace = true }
 owo-colors = { workspace = true }
+pty_terminal_test_client = { workspace = true }
 serde = { workspace = true, features = ["derive"] }
 serde_json = { workspace = true }
 tokio = { workspace = true, features = ["fs"] }
@@ -31,6 +32,7 @@ vite_install = { workspace = true }
 vite_migration = { workspace = true }
 vite_pm_cli = { workspace = true }
 vite_path = { workspace = true }
+vite_select = { workspace = true }
 vite_shared = { workspace = true }
 vite_static_config = { workspace = true }
 vite_str = { workspace = true }
diff --git a/packages/cli/binding/src/cli/app_target.rs b/packages/cli/binding/src/cli/app_target.rs
