HarperFast · dawsontoth · Jul 22, 2026 · Jul 13, 2026 · Jul 13, 2026 · Jul 14, 2026
@@ -17,6 +17,12 @@ set -e
 root="${CLAUDE_PROJECT_DIR:-$PWD}"
 cd "$root"
 
+# The main checkout is the source of the shared node_modules / .env.local. CLAUDE_PROJECT_DIR is
+# the *current* checkout, which is the worktree itself when we're launched from one — so derive
+# the main checkout from git rather than assuming $root is it. (Assuming $root pointed the
+# symlinks below at a worktree's own node_modules → a self-referential link → ELOOP on start.)
+main_checkout="$(cd "$(dirname "$(git rev-parse --git-common-dir)")" && pwd)"
+
 # Read the target worktree from .claude/preview-cwd (repo-relative). `read` trims surrounding
 # whitespace and tolerates a missing trailing newline; fall back to the main checkout when the
 # file is absent or empty.
@@ -35,13 +41,47 @@ fi
 # Guard with both -e and -L so an existing real dir/file AND a dangling symlink are left alone
 # (a broken symlink passes -e but `ln -s` over it would fail with "File exists").
 if [ ! -e node_modules ] && [ ! -L node_modules ]; then
-	ln -s "$root/node_modules" node_modules
+	ln -s "$main_checkout/node_modules" node_modules
 	echo "[preview] Symlinked node_modules from the main checkout." >&2
 fi
-if [ ! -e .env.local ] && [ ! -L .env.local ] && [ -f "$root/.env.local" ]; then
-	ln -s "$root/.env.local" .env.local
+if [ ! -e .env.local ] && [ ! -L .env.local ] && [ -f "$main_checkout/.env.local" ]; then
+	ln -s "$main_checkout/.env.local" .env.local
 	echo "[preview] Symlinked .env.local from the main checkout." >&2
 fi
 
+# The preview launcher may inherit an older default Node than pnpm 11 needs (>=22.13). Prefer the
+# repo's pinned .nvmrc version; otherwise fall back to the newest installed nvm node >=22.
+current_major="$(node -v 2>/dev/null | sed 's/^v//; s/\..*//')"
+if [ -z "$current_major" ] || [ "$current_major" -lt 22 ]; then
+	want=""
+	[ -f "$root/.nvmrc" ] && want="$(tr -d '[:space:]' < "$root/.nvmrc")"
+	want="${want#v}" # .nvmrc may write the version with or without a leading `v`.
+	adjusted=""
+	if [ -n "$want" ] && [ -d "$HOME/.nvm/versions/node/v${want}/bin" ]; then
+		PATH="$HOME/.nvm/versions/node/v${want}/bin:$PATH"
+		adjusted=1
+	elif [ -d "$HOME/.nvm/versions/node" ]; then
+		# Newest installed >=22. Portable numeric sort (descending) instead of `sort -V`, which is a
+		# GNU/newer-BSD extension missing from older `sort` (e.g. stock macOS).
+		for v in $(ls -1 "$HOME/.nvm/versions/node" | sed 's/^v//' | sort -t. -k1,1rn -k2,2rn -k3,3rn); do
+			if [ "${v%%.*}" -ge 22 ]; then
+				PATH="$HOME/.nvm/versions/node/v$v/bin:$PATH"
+				adjusted=1
+				break
+			fi
+		done
+	fi
+	# Only claim an adjustment when PATH actually changed; otherwise warn (pnpm will likely fail).
+	if [ -n "$adjusted" ]; then
+		export PATH
+		echo "[preview] Adjusted PATH to Node $(node -v 2>/dev/null) for pnpm." >&2
+	else
+		echo "[preview] Warning: Node $(node -v 2>/dev/null) is older than pnpm 11 needs (>=22.13) and no nvm Node >=22 was found — pnpm may fail." >&2
+	fi
+fi
+
 echo "[preview] Serving $(pwd) on port 5173" >&2
-exec pnpm run dev
+# node_modules is symlinked from the main checkout; skip pnpm's pre-run deps check so it can't
+# try to reinstall/purge it (the workspace state won't match, and a purge would mutate the
+# shared checkout). We just want to run the dev script against the already-installed modules.
+exec pnpm --config.verify-deps-before-run=false run dev
@@ -19,7 +19,7 @@ jobs:
       - name: Set up pnpm
         uses: pnpm/action-setup@0ebf47130e4866e96fce0953f49152a61190b271 # v6.0.9
       - name: Set up Node.js
-        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
         with:
           cache: 'pnpm'
           cache-dependency-path: 'pnpm-lock.yaml'

@@ -22,7 +22,7 @@ jobs:
       - name: Set up pnpm
         uses: pnpm/action-setup@0ebf47130e4866e96fce0953f49152a61190b271 # v6.0.9
       - name: Set up Node.js
-        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
         with:
           cache: 'pnpm'
           cache-dependency-path: 'pnpm-lock.yaml'

@@ -19,7 +19,7 @@ jobs:
       - name: Set up pnpm
         uses: pnpm/action-setup@0ebf47130e4866e96fce0953f49152a61190b271 # v6.0.9
       - name: Set up Node.js
-        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
         with:
           cache: 'pnpm'
           cache-dependency-path: 'pnpm-lock.yaml'

@@ -21,7 +21,7 @@ jobs:
       - name: Set up pnpm
         uses: pnpm/action-setup@0ebf47130e4866e96fce0953f49152a61190b271 # v6.0.9
       - name: Set up Node.js
-        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
         with:
           cache: 'pnpm'
           cache-dependency-path: 'pnpm-lock.yaml'

@@ -21,7 +21,7 @@ jobs:
       - name: Set up pnpm
         uses: pnpm/action-setup@0ebf47130e4866e96fce0953f49152a61190b271 # v6.0.9
       - name: Set up Node.js
-        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
         with:
           cache: 'pnpm'
           cache-dependency-path: 'pnpm-lock.yaml'

@@ -27,7 +27,7 @@ jobs:
       - name: Set up pnpm
         uses: pnpm/action-setup@0ebf47130e4866e96fce0953f49152a61190b271 # v6.0.9
       - name: Set up Node.js
-        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
         with:
           cache: 'pnpm'
           cache-dependency-path: 'pnpm-lock.yaml'

@@ -17,7 +17,7 @@ jobs:
       - name: Set up pnpm
         uses: pnpm/action-setup@0ebf47130e4866e96fce0953f49152a61190b271 # v6.0.9
       - name: Set up Node.js
-        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
         with:
           cache: 'pnpm'
           cache-dependency-path: 'pnpm-lock.yaml'
@@ -38,7 +38,7 @@ jobs:
         # Runs on test failure too — coverage is still written thanks to
         # reportOnFailure in vitest.config.ts.
         if: always()
-        uses: davelosert/vitest-coverage-report-action@3c054a2d2e2ca45446417ad5d6d5eb33092af8f1 # v2.12.1
+        uses: davelosert/vitest-coverage-report-action@8b157684c6a6b259b97d45e72b44242865c0f6a5 # v2.12.2
       - name: Run lint
         run: pnpm lint
       - name: Build

@@ -53,7 +53,7 @@
 		"@tailwindcss/vite": "^4.0.9",
 		"@tanstack/react-query": "^5.90.2",
 		"@tanstack/react-query-devtools": "^5.90.2",
-		"@tanstack/react-router": "1.170.17",
+		"@tanstack/react-router": "1.170.18",
 		"@tanstack/react-router-devtools": "1.167.0",
 		"@tanstack/react-table": "^8.21.2",
 		"@types/node": "^24.0.0",
@@ -73,7 +73,7 @@
 		"react": "^19.0.0",
 		"react-complex-tree": "^2.6.1",
 		"react-dom": "^19.0.0",
-		"react-dropzone": "^15.0.0",
+		"react-dropzone": "^17.0.0",
 		"react-hook-form": "^7.54.2",
 		"react-markdown": "^10.1.0",
 		"recharts": "^3.2.1",
@@ -103,7 +103,7 @@
 		"dotenv-cli": "^11.0.0",
 		"dprint": "^0.55.0",
 		"happy-dom": "^20.9.0",
-		"harper": "5.1.18",
+		"harper": "5.1.21",
 		"husky": "^9.1.7",
 		"jsdom": "^29.0.0",
 		"oxlint": "^1.32.0",
@@ -112,6 +112,6 @@
 		"vite": "^8.0.0",
 		"vitest": "^4.0.0"
 	},
-	"packageManager": "pnpm@11.11.0",
+	"packageManager": "pnpm@11.13.1",
 	"license": "Apache-2.0"
 }
@@ -1,5 +1,5 @@
 diff --git a/dist/cjs/load-matches.cjs b/dist/cjs/load-matches.cjs
-index c09976a80c2c112b7dac6f941e643c81eeaf8d52..9858f1f29c91f4e859ad4cf1e586722730c44754 100644
+index c09976a..9858f1f 100644
 --- a/dist/cjs/load-matches.cjs
 +++ b/dist/cjs/load-matches.cjs
 @@ -5,6 +5,31 @@ const require_root = require("./root.cjs");
@@ -148,10 +148,10 @@ index c09976a80c2c112b7dac6f941e643c81eeaf8d52..9858f1f29c91f4e859ad4cf1e5867227
  exports.loadRouteChunk = loadRouteChunk;
  exports.routeNeedsPreload = routeNeedsPreload;
 diff --git a/dist/cjs/router.cjs b/dist/cjs/router.cjs
-index b928d955ea81a572f2770baf30bfc9001e4a9011..c9f95fdc964f0bb03474c8b4c3914b73feb61395 100644
+index 69080aa..e63a3c7 100644
 --- a/dist/cjs/router.cjs
 +++ b/dist/cjs/router.cjs
-@@ -768,6 +768,7 @@ var RouterCore = class {
+@@ -766,6 +766,7 @@ var RouterCore = class {
  				});
  				return matches;
  			} catch (err) {
@@ -160,7 +160,7 @@ index b928d955ea81a572f2770baf30bfc9001e4a9011..c9f95fdc964f0bb03474c8b4c3914b73
  					if (err.options.reloadDocument) return;
  					return await this.preloadRoute({
 diff --git a/dist/esm/load-matches.js b/dist/esm/load-matches.js
-index bcea2e0d88d037a01b93bf36dd6e643f98028e83..f8253bec33e2b4aba3e412b1195c4cfbb9e68a70 100644
+index bcea2e0..f8253be 100644
 --- a/dist/esm/load-matches.js
 +++ b/dist/esm/load-matches.js
 @@ -5,6 +5,31 @@ import { rootRouteId } from "./root.js";
@@ -310,7 +310,7 @@ index bcea2e0d88d037a01b93bf36dd6e643f98028e83..f8253bec33e2b4aba3e412b1195c4cfb
  //# sourceMappingURL=load-matches.js.map
 \ No newline at end of file
 diff --git a/dist/esm/router.js b/dist/esm/router.js
-index 05cd2d21ab580df0956d03e2b4aabb29649edb40..ba24e4a0ef4e7008e3fec5651e6b85b156a01f47 100644
+index 7cd17f8..3be3ef9 100644
 --- a/dist/esm/router.js
 +++ b/dist/esm/router.js
 @@ -7,7 +7,7 @@ import { setupScrollRestoration } from "./scroll-restoration.js";
@@ -322,7 +322,7 @@ index 05cd2d21ab580df0956d03e2b4aabb29649edb40..ba24e4a0ef4e7008e3fec5651e6b85b1
  import { composeRewrites, executeRewriteInput, executeRewriteOutput, rewriteBasepath } from "./rewrite.js";
  import { createRouterStores } from "./stores.js";
  import { createBrowserHistory, parseHref } from "@tanstack/history";
-@@ -768,6 +768,7 @@ var RouterCore = class {
+@@ -766,6 +766,7 @@ var RouterCore = class {
  				});
  				return matches;
  			} catch (err) {