feat(dev): reapply clean bootstrap workflow

Author: Salnika

CONTRIBUTING.md

@@ -17,10 +17,10 @@ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
 cargo install cargo-binstall
 ```
 
-Initial setup to install dependencies for Vite+:
+Initial setup to prepare the repo for local development:
 
 ```
-just init
+pnpm install:dev
 ```
 
 ### Windows
@@ -37,10 +37,10 @@ Install Rust & Cargo from [rustup.rs](https://rustup.rs/), then install `cargo-b
 cargo install cargo-binstall
 ```
 
-Initial setup to install dependencies for Vite+:
+Initial setup to prepare the repo for local development:
 
 ```powershell
-just init
+pnpm install:dev
 ```
 
 **Note:** Run commands in PowerShell or Windows Terminal. Some commands may require elevated permissions.
@@ -53,21 +53,38 @@ To create a release build of Vite+ and all upstream dependencies, run:
 just build
 ```
 
+## Local CLI workflow
+
+```
+pnpm bootstrap:dev
+pnpm test
+```
+
+This prepares the local `rolldown/` and `vite/` checkouts, installs dependencies, builds the repo-local CLI artifacts, and runs tests without reading `~/.vite-plus`.
+
+If you only want to prepare the repo after cloning it, run:
+
+```
+pnpm install:dev
+```
+
+If you prefer the existing Just-based setup, `just init` now delegates to the same repo-local install flow.
+
 ## Install the Vite+ Global CLI from source code
 
 ```
 pnpm bootstrap-cli
 vp --version
 ```
 
-This builds all packages, compiles the Rust `vp` binary, and installs the CLI to `~/.vite-plus`.
+Use this only when you specifically want to validate the install flow or the globally installed CLI.
 
 ## Workflow for build and test
 
 You can run this command to build, test and check if there are any snapshot changes:
 
 ```
-pnpm bootstrap-cli && pnpm test && git status
+pnpm build:cli && pnpm test && git status
 ```
 
 ## Running Snap Tests
@@ -87,6 +104,8 @@ pnpm -F vite-plus snap-test-global
 pnpm -F vite-plus snap-test-global <name-filter>
 ```
 
+Global CLI snap tests use the repo-local debug binary and `packages/cli/dist`; they do not require `~/.vite-plus/bin`.
+
 Snap tests auto-generate `snap.txt` files. Check `git diff` to verify output changes are correct.
 
 ## Verified Commits

justfile

@@ -18,8 +18,7 @@ _clean_dist:
 
 init: _clean_dist
   cargo binstall watchexec-cli cargo-insta typos-cli cargo-shear dprint taplo-cli -y
-  node packages/tools/src/index.ts sync-remote
-  pnpm install
+  pnpm install:dev
   pnpm -C docs install
 
 build:

package.json

@@ -5,14 +5,17 @@
   "type": "module",
   "scripts": {
     "build": "pnpm -F @voidzero-dev/* -F vite-plus build",
-    "bootstrap-cli": "pnpm build && cargo build -p vite_global_cli -p vite_trampoline --release && pnpm install-global-cli",
+    "install:dev": "node scripts/setup-local-dev.mjs",
+    "bootstrap:dev": "pnpm install:dev && pnpm build:cli",
+    "build:cli": "tool build-local-cli",
+    "bootstrap-cli": "pnpm install:dev && tool build-local-cli --release-rust && pnpm install-global-cli",
     "bootstrap-cli:ci": "pnpm install-global-cli",
     "install-global-cli": "tool install-global-cli",
     "tsgo": "tsgo -b tsconfig.json",
     "lint": "vp lint --type-aware --type-check --threads 4",
-    "test": "vp test run && pnpm -r snap-test",
+    "test": "pnpm build:cli && pnpm -F vite-plus test && pnpm -F vite-plus snap-test",
     "fmt": "vp fmt",
-    "test:unit": "vp test run",
+    "test:unit": "pnpm build:cli && pnpm -F vite-plus test",
     "docs:dev": "pnpm -C docs dev",
     "docs:build": "pnpm -C docs build",
     "prepare": "husky"

packages/cli/package.json

@@ -323,9 +323,9 @@
     "build-native": "oxnode -C dev ./build.ts --skip-ts",
     "snap-test": "pnpm snap-test-local && pnpm snap-test-global",
     "snap-test-local": "tool snap-test",
-    "snap-test-global": "tool snap-test --dir snap-tests-global --bin-dir ~/.vite-plus/bin",
+    "snap-test-global": "tool snap-test-global-local",
     "publish-native": "node ./publish-native-addons.ts",
-    "test": "vitest run"
+    "test": "tool local-cli test run"
   },
   "dependencies": {
     "@oxc-project/types": "catalog:",

packages/tools/src/index.ts

@@ -25,14 +25,26 @@ switch (subcommand) {
     const { installGlobalCli } = await import('./install-global-cli.ts');
     installGlobalCli();
     break;
+  case 'build-local-cli':
+    const { runBuildLocalCli } = await import('./local-cli.ts');
+    runBuildLocalCli(process.argv.slice(3));
+    break;
+  case 'local-cli':
+    const { runLocalCli } = await import('./local-cli.ts');
+    runLocalCli(process.argv.slice(3));
+    break;
+  case 'snap-test-global-local':
+    const { runLocalGlobalSnapTest } = await import('./local-cli.ts');
+    runLocalGlobalSnapTest(process.argv.slice(3));
+    break;
   case 'brand-vite':
     const { brandVite } = await import('./brand-vite.ts');
     brandVite();
     break;
   default:
     console.error(`Unknown subcommand: ${subcommand}`);
     console.error(
-      'Available subcommands: snap-test, replace-file-content, sync-remote, json-sort, merge-peer-deps, install-global-cli, brand-vite',
+      'Available subcommands: snap-test, replace-file-content, sync-remote, json-sort, merge-peer-deps, install-global-cli, build-local-cli, local-cli, snap-test-global-local, brand-vite',
     );
     process.exit(1);
 }