fix: Revert pnpm from 10.27.0 to 10.26.2 (#3022)

Author: KATO-Hiro

docs/dev-notes/2026-01-02/pnpm-10.27-regression/report.md

@@ -0,0 +1,132 @@
+# pnpm v10.27 メモリリーク問題の調査と解決
+
+**日付:** 2026-01-02
+**根本原因:** pnpm v10.27.0 のグローバルストア構造変更
+**状態:** ✅ 解決
+
+## 問題の症状
+
+`pnpm dev` でローカル開発サーバが起動しない。
+
+**エラーメッセージ:**
+
+```text
+FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory
+```
+
+**プロセス終了コード:** 134 (SIGABRT)
+
+**発生タイミング:** 最近の pnpm アップデート後（10.26.2 → 10.27.0）
+
+## 調査プロセス
+
+### 消費したリソース確認（メモリ分析）
+
+**Node メモリ上限の増加が効果なし:**
+
+```bash
+NODE_OPTIONS=--max-old-space-size=8192 pnpm dev  # 失敗（4096 でも失敗）
+```
+
+### 初期の仮説と検証結果
+
+| 仮説                          | 検証                                                         | 結果                          |
+| ----------------------------- | ------------------------------------------------------------ | ----------------------------- |
+| Playwright の自動起動         | [playwright.config.ts](../../../playwright.config.ts) を確認 | ✅ 否定（dev モードで無効化） |
+| vitest の watch モード暴走    | `pnpm dev` では vitest は実行されない                        | ✅ 否定                       |
+| .svelte-kit キャッシュ肥大化  | `du -sh .svelte-kit/` = 4.2M                                 | ✅ 否定（正常範囲）           |
+| Prisma 生成コード巨大化       | `postinstall` 実行時間 = 188ms                               | ✅ 否定（小さい）             |
+| Node.js 22 での V8 メモリ管理 | 1年前から同じバージョン                                      | ✅ 否定（可能性低い）         |
+| OrbStack のメモリ上限削減     | 公式ドキュメント確認                                         | ✅ 否定（設定変更なし）       |
+
+### 根本原因の特定
+
+**pnpm v10.27.0 の semi-breaking change**
+
+[GitHub Release - pnpm v10.27.0](https://github.com/pnpm/pnpm/releases/tag/v10.27.0) より：
+
+> **Semi-breaking.** Changed the location of unscoped packages in the virtual global store. They will now be stored under a directory named `@` to maintain a uniform 4-level directory depth.
+
+**影響分析:**
+
+- グローバル仮想ストアの内部ディレクトリ構造が変更
+- ローカルの `node_modules` キャッシュが古い構造を参照して不整合
+- Vite + SvelteKit の開発サーバ起動時に、watch モード初期化でメモリを過剰消費
+
+## 解決方法
+
+**pnpm をダウングレード：v10.27.0 → v10.26.2**
+
+[package.json](../../../package.json) の devDependencies を変更：
+
+```json
+{
+  "devDependencies": {
+    "pnpm": "10.26.2"
+  }
+}
+```
+
+実行コマンド：
+
+```bash
+pnpm install --no-frozen-lockfile
+```
+
+## 結果
+
+✅ `pnpm dev` が正常に起動
+
+**ローカル開発サーバの状態:**
+
+- メモリリークなし
+- watch モード正常動作
+- ブラウザ自動オープン機能も動作
+
+## 補足
+
+### pnpm 10.27.0 の他の変更
+
+同バージョンには以下の変更も含まれている：
+
+- **グローバルストアのガベージコレクション追加** (`pnpm store prune` の改善)
+- **プロジェクト登録メカニズムの変更** (symlinks in `{storeDir}/v10/projects/`)
+
+これらが相互作用して、ローカル環境でメモリ問題を引き起こした可能性がある。
+
+### 根本原因の確実性と環境固有性
+
+**確実な事実:**
+
+- pnpm v10.27.0 へのアップデート直後に問題が発生
+- v10.26.2 へのダウングレードで即座に解決
+- v10.27.0 は 2025年12月末リリース
+
+**推測される部分（高確度だが確定ではない）:**
+
+- Vite の Pre-bundling キャッシュ無効化メカニズムが影響
+- Watch モード中の累積メモリ消費
+- **環境固有の問題である可能性が高い** ⚠️
+
+**環境固有である理由:**
+
+- GitHub issues に同様の報告がない（pnpm 10.27.0 は pnpm の最新版）
+- このプロジェクト特有の設定の可能性：
+  - Docker コンテナ環境 + OrbStack での実行
+  - `compose.yaml` での `volumes: cached` 設定
+  - ホスト macOS との ファイルシステム監視の相互作用
+- **「pnpm 10.27.0 + Docker/OrbStack + Vite watch」の組み合わせに限定される可能性**
+
+つまり、pnpm 10.27.0 自体が不具合をもたらしたというより、**このプロジェクトの開発環境における相互作用が問題を引き起こした**可能性が高い。
+
+### 将来への対応
+
+- pnpm 10.27.1 以降で修正される可能性は低い（報告がないため）
+- 次のメジャーアップデートまで v10.26.2 を維持することを推奨
+- または、Docker 内での watch 設定やボリュームマウント設定を最適化してから検証する
+
+### 参考リンク
+
+- [pnpm v10.27.0 Release Notes](https://github.com/pnpm/pnpm/releases/tag/v10.27.0)
+- [pnpm Global Store Documentation](https://pnpm.io/pnpm-7-8-migration#store-changes)
+- [Vite Dependency Pre-Bundling](https://vite.dev/guide/dep-pre-bundling.html)

package.json

@@ -45,7 +45,7 @@
     "lefthook": "2.0.13",
     "jsdom": "27.4.0",
     "nock": "14.0.10",
-    "pnpm": "10.27.0",
+    "pnpm": "10.26.2",
     "prettier": "3.7.4",
     "prettier-plugin-svelte": "3.4.1",
     "prettier-plugin-tailwindcss": "0.6.14",
@@ -88,7 +88,7 @@
     "vercel": "50.1.3",
     "xss": "1.0.15"
   },
-  "packageManager": "pnpm@10.27.0",
+  "packageManager": "pnpm@10.26.2",
   "engines": {
     "node": ">=20.0.0"
   }