refactor(cli): replace clap with usage-rs

CLAUDE.md

@@ -160,4 +160,4 @@ When a change is user-facing (new feature, changed behavior, bug fix, removal, o
 
 - **Task Format**: `package#task` (e.g., `app#build`, `@test/utils#lint`)
 - **Config File**: `vite-task.json` in each package
-- **Rust Edition**: 2024, MSRV 1.88.0
+- **Rust Edition**: 2024, MSRV 1.91.0

Cargo.toml

@@ -7,7 +7,7 @@ authors = ["Vite+ Authors"]
 edition = "2024"
 license = "MIT"
 publish = false
-rust-version = "1.89.0"
+rust-version = "1.91.0"
 
 [workspace.lints.rust]
 absolute_paths_not_starting_with_crate = "warn"
@@ -56,7 +56,6 @@ bumpalo = "3.17.0"
 bytemuck = "1.23.0"
 cargo-platform = "=0.3.2"
 cc = "1.2.39"
-clap = "4.5.53"
 color-eyre = "0.6.5"
 compact_str = "0.9.0"
 constcat = "0.6.1"
@@ -159,6 +158,7 @@ tracing-subscriber = "0.3.19"
 ts-rs = { version = "12.0.0" }
 tui-term = "0.3.1"
 twox-hash = "2.1.1"
+usage = { package = "usage-rs", git = "https://github.com/fengmk2/usage", rev = "25e76738edda9b21c5b2268c1274a9fb63cb4aad", default-features = false }
 uuid = "1.18.1"
 vec1 = "1.12.1"
 vt_glob = { path = "crates/vt_glob" }

crates/vt/Cargo.toml

@@ -16,7 +16,6 @@ anstream = { workspace = true }
 anyhow = { workspace = true }
 async-trait = { workspace = true }
 wincode = { workspace = true, features = ["derive"] }
-clap = { workspace = true, features = ["derive"] }
 ctrlc = { workspace = true }
 derive_more = { workspace = true, features = ["debug", "from"] }
 futures-util = { workspace = true }
@@ -43,6 +42,7 @@ tokio = { workspace = true, features = [
 tokio-util = { workspace = true }
 tracing = { workspace = true }
 twox-hash = { workspace = true }
+usage = { workspace = true, features = ["completions", "diagnostics", "help", "spec"] }
 materialized_artifact = { workspace = true }
 uuid = { workspace = true, features = ["v4"] }
 vt_glob = { workspace = true }
@@ -65,6 +65,7 @@ zstd = { workspace = true }
 
 [dev-dependencies]
 tempfile = { workspace = true }
+usage = { workspace = true, features = ["completions", "test"] }
 
 [target.'cfg(any(target_os = "windows", target_os = "macos", target_os = "linux"))'.dependencies]
 fspy = { workspace = true }

crates/vt/docs/boolean-flags.md

@@ -51,4 +51,4 @@ vp run build --no-cache
 
 ## Implementation Details
 
-The flags use clap's argument parsing. The `--cache`/`--no-cache` pair uses clap's `conflicts_with` attribute to ensure they cannot be used together.
+The flags use `usage-rs` argument parsing. The `--cache` and `--no-cache` fields declare a conflict so that they cannot be used together.