From 329e10218ae38413da04a733513103bc368d6a36 Mon Sep 17 00:00:00 2001
From: JongKyung Lee <jongkyung0413@gmail.com>
Date: Tue, 4 Aug 2026 21:48:25 +0900
Subject: [PATCH 1/5] chore(tools): remove unused json-sort and
 replace-file-content

Both subcommands have no callers in the repo. The replace-file-content
use case is already covered by the Rust vpt replace-file-content helper
in crates/vite_cli_snapshots. The snap-tests fixtures under
packages/tools/snap-tests had no runner wired to them.
---
 packages/tools/README.md                      |  1 -
 .../tools/snap-tests/json-sort/array.json     | 18 ------
 packages/tools/snap-tests/json-sort/snap.txt  | 59 -------------------
 .../tools/snap-tests/json-sort/steps.json     |  9 ---
 .../replace-file-content/foo/example.toml     | 14 -----
 .../snap-tests/replace-file-content/snap.txt  | 31 ----------
 .../replace-file-content/steps.json           |  7 ---
 packages/tools/src/index.ts                   | 10 +---
 packages/tools/src/json-sort.ts               | 40 -------------
 packages/tools/src/replace-file-content.ts    | 27 ---------
 10 files changed, 1 insertion(+), 215 deletions(-)
 delete mode 100644 packages/tools/snap-tests/json-sort/array.json
 delete mode 100644 packages/tools/snap-tests/json-sort/snap.txt
 delete mode 100644 packages/tools/snap-tests/json-sort/steps.json
 delete mode 100644 packages/tools/snap-tests/replace-file-content/foo/example.toml
 delete mode 100644 packages/tools/snap-tests/replace-file-content/snap.txt
 delete mode 100644 packages/tools/snap-tests/replace-file-content/steps.json
 delete mode 100755 packages/tools/src/json-sort.ts
 delete mode 100755 packages/tools/src/replace-file-content.ts

diff --git a/packages/tools/README.md b/packages/tools/README.md
index 1f5726d254..6ac9e0d67f 100644
--- a/packages/tools/README.md
+++ b/packages/tools/README.md
@@ -1,4 +1,3 @@
 # tools for internal development use
 
 - json-edit: A CLI tool to edit JSON files such as package.json in e2e tests
-- json-sort: A CLI tool to sort JSON keys in a file
diff --git a/packages/tools/snap-tests/json-sort/array.json b/packages/tools/snap-tests/json-sort/array.json
deleted file mode 100644
index c7522ca60d..0000000000
--- a/packages/tools/snap-tests/json-sort/array.json
+++ /dev/null
@@ -1,18 +0,0 @@
-[
-  {
-    "name": "test",
-    "age": 18
-  },
-  {
-    "name": "abc",
-    "age": 20
-  },
-  {
-    "name": "def",
-    "age": 15
-  },
-  {
-    "name": "ghi",
-    "age": 18
-  }
-]
diff --git a/packages/tools/snap-tests/json-sort/snap.txt b/packages/tools/snap-tests/json-sort/snap.txt
deleted file mode 100644
index e8913e1bb5..0000000000
--- a/packages/tools/snap-tests/json-sort/snap.txt
+++ /dev/null
@@ -1,59 +0,0 @@
-> cat array.json # should show original array.json file
-[
-  {
-    "name": "test",
-    "age": 18
-  },
-  {
-    "name": "abc",
-    "age": 20
-  },
-  {
-    "name": "def",
-    "age": 15
-  },
-  {
-    "name": "ghi",
-    "age": 18
-  }
-]
-
-> tool json-sort array.json '_.name' && cat array.json # should sort array.json file by name
-[
-  {
-    "name": "abc",
-    "age": 20
-  },
-  {
-    "name": "def",
-    "age": 15
-  },
-  {
-    "name": "ghi",
-    "age": 18
-  },
-  {
-    "name": "test",
-    "age": 18
-  }
-]
-
-> tool json-sort array.json '_.age' && cat array.json # should sort array.json file by age
-[
-  {
-    "name": "def",
-    "age": 15
-  },
-  {
-    "name": "ghi",
-    "age": 18
-  },
-  {
-    "name": "test",
-    "age": 18
-  },
-  {
-    "name": "abc",
-    "age": 20
-  }
-]
diff --git a/packages/tools/snap-tests/json-sort/steps.json b/packages/tools/snap-tests/json-sort/steps.json
deleted file mode 100644
index 56950a4ad1..0000000000
--- a/packages/tools/snap-tests/json-sort/steps.json
+++ /dev/null
@@ -1,9 +0,0 @@
-{
-  "ignoredPlatforms": ["win32"],
-  "env": {},
-  "commands": [
-    "cat array.json # should show original array.json file",
-    "tool json-sort array.json '_.name' && cat array.json # should sort array.json file by name",
-    "tool json-sort array.json '_.age' && cat array.json # should sort array.json file by age"
-  ]
-}
diff --git a/packages/tools/snap-tests/replace-file-content/foo/example.toml b/packages/tools/snap-tests/replace-file-content/foo/example.toml
deleted file mode 100644
index 08894361bc..0000000000
--- a/packages/tools/snap-tests/replace-file-content/foo/example.toml
+++ /dev/null
@@ -1,14 +0,0 @@
-[package]
-name = "foo"
-version = "0.0.0"
-edition = "2024"
-
-[[bin]]
-name = "vite"
-path = "src/main.rs"
-
-[dependencies]
-clap = { workspace = true, features = ["derive"] }
-crossterm = { workspace = true }
-napi = { workspace = true }
-napi-derive = { workspace = true }
diff --git a/packages/tools/snap-tests/replace-file-content/snap.txt b/packages/tools/snap-tests/replace-file-content/snap.txt
deleted file mode 100644
index 7575397ed7..0000000000
--- a/packages/tools/snap-tests/replace-file-content/snap.txt
+++ /dev/null
@@ -1,31 +0,0 @@
-> cat foo/example.toml # should show original toml file
-[package]
-name = "foo"
-version = "0.0.0"
-edition = "2024"
-
-[[bin]]
-name = "vite"
-path = "src/main.rs"
-
-[dependencies]
-clap = { workspace = true, features = ["derive"] }
-crossterm = { workspace = true }
-napi = { workspace = true }
-napi-derive = { workspace = true }
-
-> tool replace-file-content foo/example.toml 'version = "0.0.0"' 'version = "1.0.0"' && cat foo/example.toml # should edit toml file
-[package]
-name = "foo"
-version = "1.0.0"
-edition = "2024"
-
-[[bin]]
-name = "vite"
-path = "src/main.rs"
-
-[dependencies]
-clap = { workspace = true, features = ["derive"] }
-crossterm = { workspace = true }
-napi = { workspace = true }
-napi-derive = { workspace = true }
diff --git a/packages/tools/snap-tests/replace-file-content/steps.json b/packages/tools/snap-tests/replace-file-content/steps.json
deleted file mode 100644
index a08732cdd6..0000000000
--- a/packages/tools/snap-tests/replace-file-content/steps.json
+++ /dev/null
@@ -1,7 +0,0 @@
-{
-  "env": {},
-  "commands": [
-    "cat foo/example.toml # should show original toml file",
-    "tool replace-file-content foo/example.toml 'version = \"0.0.0\"' 'version = \"1.0.0\"' && cat foo/example.toml # should edit toml file"
-  ]
-}
diff --git a/packages/tools/src/index.ts b/packages/tools/src/index.ts
index cde286f144..2eb8f417b3 100644
--- a/packages/tools/src/index.ts
+++ b/packages/tools/src/index.ts
@@ -1,18 +1,10 @@
 const subcommand = process.argv[2];
 
 switch (subcommand) {
-  case 'replace-file-content':
-    const { replaceFileContent } = await import('./replace-file-content.ts');
-    replaceFileContent();
-    break;
   case 'sync-remote':
     const { syncRemote } = await import('./sync-remote-deps.ts');
     await syncRemote();
     break;
-  case 'json-sort':
-    const { jsonSort } = await import('./json-sort.ts');
-    jsonSort();
-    break;
   case 'install-global-cli':
     const { installGlobalCli } = await import('./install-global-cli.ts');
     installGlobalCli();
@@ -37,7 +29,7 @@ switch (subcommand) {
   default:
     console.error(`Unknown subcommand: ${subcommand}`);
     console.error(
-      'Available subcommands: replace-file-content, sync-remote, json-sort, install-global-cli, brand-vite, local-npm-registry',
+      'Available subcommands: sync-remote, install-global-cli, brand-vite, local-npm-registry',
     );
     process.exit(1);
 }
diff --git a/packages/tools/src/json-sort.ts b/packages/tools/src/json-sort.ts
deleted file mode 100755
index b96da2e098..0000000000
--- a/packages/tools/src/json-sort.ts
+++ /dev/null
@@ -1,40 +0,0 @@
-#!/usr/bin/env node
-
-import assert from 'node:assert';
-import { readFileSync, writeFileSync } from 'node:fs';
-import { parseArgs } from 'node:util';
-
-export function jsonSort() {
-  const { positionals } = parseArgs({
-    allowPositionals: true,
-    args: process.argv.slice(3),
-  });
-
-  const filename = positionals[0];
-  const script = positionals[1];
-
-  if (!filename || !script) {
-    console.error('Usage: tool json-sort <filename> <script>');
-    console.error("Example: tool json-sort array.json '_.name'");
-    process.exit(1);
-  }
-
-  const data = JSON.parse(readFileSync(filename, 'utf-8'));
-  assert(Array.isArray(data), 'json data must be an array');
-  // sort json by script
-  // oxlint-disable-next-line typescript/no-implied-eval
-  const func = new Function('_', `return ${script};`);
-  const sortedJson = data.toSorted((a: unknown, b: unknown) => {
-    const aValue = func(a);
-    const bValue = func(b);
-    if (aValue < bValue) {
-      return -1;
-    }
-    if (aValue > bValue) {
-      return 1;
-    }
-    return 0;
-  });
-
-  writeFileSync(filename, JSON.stringify(sortedJson, null, 2) + '\n', 'utf-8');
-}
diff --git a/packages/tools/src/replace-file-content.ts b/packages/tools/src/replace-file-content.ts
deleted file mode 100755
index f43e9ce582..0000000000
--- a/packages/tools/src/replace-file-content.ts
+++ /dev/null
@@ -1,27 +0,0 @@
-import { readFileSync, writeFileSync } from 'node:fs';
-import path from 'node:path';
-import { parseArgs } from 'node:util';
-
-export function replaceFileContent() {
-  const { positionals } = parseArgs({
-    allowPositionals: true,
-    args: process.argv.slice(3),
-  });
-
-  const filename = positionals[0];
-  const searchValue = positionals[1];
-  const newValue = positionals[2];
-
-  if (!filename || !searchValue || !newValue) {
-    console.error('Usage: tool replace-file-content <filename> <searchValue> <newValue>');
-    console.error(
-      'Example: tool replace-file-content example.toml \'version = "0.0.0"\' \'version = "0.0.1"\'',
-    );
-    process.exit(1);
-  }
-
-  const filepath = path.resolve(filename);
-  const content = readFileSync(filepath, 'utf-8');
-  const newContent = content.replace(searchValue, newValue);
-  writeFileSync(filepath, newContent, 'utf-8');
-}

From 4f24e6a0ccd685697a5570313bd6f0a649999388 Mon Sep 17 00:00:00 2001
From: JongKyung Lee <jongkyung0413@gmail.com>
Date: Tue, 4 Aug 2026 22:02:58 +0900
Subject: [PATCH 2/5] chore(tools): remove unused json-edit

Like json-sort and replace-file-content, the TS json-edit has no
callers; all live usage is the Rust vpt json-edit in
crates/vite_cli_snapshots, which the interactive-snapshot-tests RFC
introduced as its replacement.
---
 packages/tools/README.md        |  2 --
 packages/tools/package.json     |  1 -
 packages/tools/src/json-edit.ts | 24 ------------------------
 3 files changed, 27 deletions(-)
 delete mode 100755 packages/tools/src/json-edit.ts

diff --git a/packages/tools/README.md b/packages/tools/README.md
index 6ac9e0d67f..2270970db8 100644
--- a/packages/tools/README.md
+++ b/packages/tools/README.md
@@ -1,3 +1 @@
 # tools for internal development use
-
-- json-edit: A CLI tool to edit JSON files such as package.json in e2e tests
diff --git a/packages/tools/package.json b/packages/tools/package.json
index 0b5ce3ba5c..539a617b3e 100644
--- a/packages/tools/package.json
+++ b/packages/tools/package.json
@@ -3,7 +3,6 @@
   "version": "0.0.0",
   "private": true,
   "bin": {
-    "json-edit": "./src/json-edit.ts",
     "tool": "./src/bin.js"
   },
   "type": "module",
diff --git a/packages/tools/src/json-edit.ts b/packages/tools/src/json-edit.ts
deleted file mode 100755
index 59f620bf1b..0000000000
--- a/packages/tools/src/json-edit.ts
+++ /dev/null
@@ -1,24 +0,0 @@
-#!/usr/bin/env node
-
-import { readFileSync, writeFileSync } from 'node:fs';
-import { parseArgs } from 'node:util';
-
-const { positionals } = parseArgs({
-  allowPositionals: true,
-});
-
-const filename = positionals[0];
-const script = positionals[1];
-
-if (!filename || !script) {
-  console.error('Usage: json-edit <filename> <script>');
-  console.error('Example: json-edit package.json \'_.version = "1.2.3"\'');
-  process.exit(1);
-}
-
-const json = JSON.parse(readFileSync(filename, 'utf-8'));
-// oxlint-disable-next-line typescript/no-implied-eval
-const func = new Function('_', script + '; return _;');
-const result = func(json);
-
-writeFileSync(filename, JSON.stringify(result, null, 2) + '\n', 'utf-8');

From ad5752e5d9ad5f8c31f9a9509a4615143926fad7 Mon Sep 17 00:00:00 2001
From: JongKyung Lee <jongkyung0413@gmail.com>
Date: Tue, 4 Aug 2026 22:08:58 +0900
Subject: [PATCH 3/5] docs(tools): document remaining tool subcommands in
 README

---
 packages/tools/README.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/tools/README.md b/packages/tools/README.md
index 2270970db8..55b683f250 100644
--- a/packages/tools/README.md
+++ b/packages/tools/README.md
@@ -1 +1,8 @@
 # tools for internal development use
+
+Run subcommands with `tool <name>`:
+
+- sync-remote: Sync upstream dependency sources and catalog versions from `.upstream-versions.json`
+- install-global-cli: Install the locally built `vp` global CLI into `~/.vite-plus`
+- brand-vite: Apply Vite+ branding patches to the synced vite source (also runs at the end of sync-remote)
+- local-npm-registry: Serve locally packed checkout packages behind a real registry HTTP interface for snapshot tests, ecosystem e2e, and local `vp migrate`/`vp create` iteration

From 06f93303fdc54416f1ffc333ad7a9206092848c4 Mon Sep 17 00:00:00 2001
From: JongKyung Lee <jongkyung0413@gmail.com>
Date: Tue, 4 Aug 2026 22:19:38 +0900
Subject: [PATCH 4/5] chore(tools): restore json-edit used by the release
 workflow

reusable-release-build.yml runs 'pnpm exec json-edit' to stamp package
versions during release and preview builds, so the workspace bin must
stay until that workflow migrates to another helper.
---
 packages/tools/README.md        |  2 ++
 packages/tools/package.json     |  1 +
 packages/tools/src/json-edit.ts | 24 ++++++++++++++++++++++++
 3 files changed, 27 insertions(+)
 create mode 100755 packages/tools/src/json-edit.ts

diff --git a/packages/tools/README.md b/packages/tools/README.md
index 55b683f250..458addf223 100644
--- a/packages/tools/README.md
+++ b/packages/tools/README.md
@@ -1,5 +1,7 @@
 # tools for internal development use
 
+- json-edit: A CLI tool to edit JSON files such as package.json, used by the release workflow to stamp build versions
+
 Run subcommands with `tool <name>`:
 
 - sync-remote: Sync upstream dependency sources and catalog versions from `.upstream-versions.json`
diff --git a/packages/tools/package.json b/packages/tools/package.json
index 539a617b3e..0b5ce3ba5c 100644
--- a/packages/tools/package.json
+++ b/packages/tools/package.json
@@ -3,6 +3,7 @@
   "version": "0.0.0",
   "private": true,
   "bin": {
+    "json-edit": "./src/json-edit.ts",
     "tool": "./src/bin.js"
   },
   "type": "module",
diff --git a/packages/tools/src/json-edit.ts b/packages/tools/src/json-edit.ts
new file mode 100755
index 0000000000..59f620bf1b
--- /dev/null
+++ b/packages/tools/src/json-edit.ts
@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+import { readFileSync, writeFileSync } from 'node:fs';
+import { parseArgs } from 'node:util';
+
+const { positionals } = parseArgs({
+  allowPositionals: true,
+});
+
+const filename = positionals[0];
+const script = positionals[1];
+
+if (!filename || !script) {
+  console.error('Usage: json-edit <filename> <script>');
+  console.error('Example: json-edit package.json \'_.version = "1.2.3"\'');
+  process.exit(1);
+}
+
+const json = JSON.parse(readFileSync(filename, 'utf-8'));
+// oxlint-disable-next-line typescript/no-implied-eval
+const func = new Function('_', script + '; return _;');
+const result = func(json);
+
+writeFileSync(filename, JSON.stringify(result, null, 2) + '\n', 'utf-8');

From 38f7b34e06bf16f7ba6c5df9e9f01d9f6f2fd7a3 Mon Sep 17 00:00:00 2001
From: JongKyung Lee <jongkyung0413@gmail.com>
Date: Tue, 4 Aug 2026 22:20:08 +0900
Subject: [PATCH 5/5] docs(tools): split README into bins and tool subcommands

---
 packages/tools/README.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/tools/README.md b/packages/tools/README.md
index 458addf223..3b7f8ad36d 100644
--- a/packages/tools/README.md
+++ b/packages/tools/README.md
@@ -1,8 +1,12 @@
 # tools for internal development use
 
+## Bins
+
 - json-edit: A CLI tool to edit JSON files such as package.json, used by the release workflow to stamp build versions
 
-Run subcommands with `tool <name>`:
+## `tool` subcommands
+
+Run with `tool <name>`:
 
 - sync-remote: Sync upstream dependency sources and catalog versions from `.upstream-versions.json`
 - install-global-cli: Install the locally built `vp` global CLI into `~/.vite-plus`