From 9f29a8382ef7e9a6e3b2b00edafe9e9699b28ce9 Mon Sep 17 00:00:00 2001
From: Kato Hiroki <k.hiro1818@gmail.com>
Date: Sun, 18 Jan 2026 06:41:36 +0000
Subject: [PATCH 1/2] chore: Bump pnpm from 10.27 to 10.28 in package.json
 (#3062)

---
 .../pnpm-10.27-regression/report.md           | 80 +++++++++++--------
 package.json                                  |  2 +-
 2 files changed, 48 insertions(+), 34 deletions(-)

diff --git a/docs/dev-notes/2026-01-02/pnpm-10.27-regression/report.md b/docs/dev-notes/2026-01-02/pnpm-10.27-regression/report.md
index a01883e9d..96e59136e 100644
--- a/docs/dev-notes/2026-01-02/pnpm-10.27-regression/report.md
+++ b/docs/dev-notes/2026-01-02/pnpm-10.27-regression/report.md
@@ -1,7 +1,9 @@
 # pnpm v10.27 メモリリーク問題の調査と解決
 
 **日付:** 2026-01-02
+
 **根本原因:** pnpm v10.27.0 のグローバルストア構造変更
+
 **状態:** ✅ 解決
 
 ## 問題の症状
@@ -53,7 +55,7 @@ NODE_OPTIONS=--max-old-space-size=8192 pnpm dev  # 失敗（4096 でも失敗）
 - ローカルの `node_modules` キャッシュが古い構造を参照して不整合
 - Vite + SvelteKit の開発サーバ起動時に、watch モード初期化でメモリを過剰消費
 
-## 解決方法
+## 解決方法（従来の方法）
 
 **pnpm をダウングレード：v10.27.0 → v10.26.2**
 
@@ -73,57 +75,69 @@ NODE_OPTIONS=--max-old-space-size=8192 pnpm dev  # 失敗（4096 でも失敗）
 pnpm install --no-frozen-lockfile
 ```
 
-## 結果
+### 結果
 
 ✅ `pnpm dev` が正常に起動
 
-**ローカル開発サーバの状態:**
+## 推奨解決方法（v10.28.0 へのアップグレード）
 
-- メモリリークなし
-- watch モード正常動作
-- ブラウザ自動オープン機能も動作
+**状態:** ✅ **2026-01-18 で検証完了 - 推奨**
 
-## 補足
+pnpm v10.28.0 で v10.27.0 の問題が修正されました。
 
-### pnpm 10.27.0 の他の変更
+### v10.28.0 での修正内容
 
-同バージョンには以下の変更も含まれている：
+[pnpm v10.28.0 Release Notes](https://github.com/pnpm/pnpm/releases/tag/v10.28.0) のパッチ `#10411` にて以下が修正されました：
 
-- **グローバルストアのガベージコレクション追加** (`pnpm store prune` の改善)
-- **プロジェクト登録メカニズムの変更** (symlinks in `{storeDir}/v10/projects/`)
+> Do not add a symlink to the project into the store's project registry if the store is in a subdirectory of the project
 
-これらが相互作用して、ローカル環境でメモリ問題を引き起こした可能性がある。
+**影響:** Docker + OrbStack 環境でのストア位置管理の問題を解決
 
-### 根本原因の確実性と環境固有性
+### アップグレード手順
 
-**確実な事実:**
+[package.json](../../../package.json) の devDependencies を変更：
 
-- pnpm v10.27.0 へのアップデート直後に問題が発生
-- v10.26.2 へのダウングレードで即座に解決
-- v10.27.0 は 2025年12月末リリース
+```json
+{
+  "devDependencies": {
+    "pnpm": "10.28.0"
+  },
+  "packageManager": "pnpm@10.28.0"
+}
+```
 
-**推測される部分（高確度だが確定ではない）:**
+実行コマンド：
 
-- Vite の Pre-bundling キャッシュ無効化メカニズムが影響
-- Watch モード中の累積メモリ消費
-- **環境固有の問題である可能性が高い** ⚠️
+```bash
+pnpm install --no-frozen-lockfile
+```
+
+### 動作確認結果
 
-**環境固有である理由:**
+- ✅ `pnpm dev` - 正常に起動、メモリリークなし
+- ✅ `pnpm test:unit` - 正常に実行、watch モード安定動作
+- ✅ `pnpm build` - 正常にビルド完了
 
-- GitHub issues に同様の報告がない（pnpm 10.27.0 は pnpm の最新版）
-- このプロジェクト特有の設定の可能性：
-  - Docker コンテナ環境 + OrbStack での実行
-  - `compose.yaml` での `volumes: cached` 設定
-  - ホスト macOS との ファイルシステム監視の相互作用
-- **「pnpm 10.27.0 + Docker/OrbStack + Vite watch」の組み合わせに限定される可能性**
+## 結果（従来の方法）
+
+✅ `pnpm dev` が正常に起動
 
-つまり、pnpm 10.27.0 自体が不具合をもたらしたというより、**このプロジェクトの開発環境における相互作用が問題を引き起こした**可能性が高い。
+**ローカル開発サーバの状態:**
 
-### 将来への対応
+- メモリリークなし
+- watch モード正常動作
+- ブラウザ自動オープン機能も動作
 
-- pnpm 10.27.1 以降で修正される可能性は低い（報告がないため）
-- 次のメジャーアップデートまで v10.26.2 を維持することを推奨
-- または、Docker 内での watch 設定やボリュームマウント設定を最適化してから検証する
+## 補足
+
+### pnpm 10.27.0 の他の変更
+
+同バージョンには以下の変更も含まれている：
+
+- **グローバルストアのガベージコレクション追加** (`pnpm store prune` の改善)
+- **プロジェクト登録メカニズムの変更** (symlinks in `{storeDir}/v10/projects/`)
+
+これらが相互作用して、ローカル環境でメモリ問題を引き起こした可能性がある。
 
 ### 参考リンク
 
diff --git a/package.json b/package.json
index 4f12a7e26..e6d2b2a8d 100644
--- a/package.json
+++ b/package.json
@@ -86,7 +86,7 @@
     "vercel": "50.4.5",
     "xss": "1.0.15"
   },
-  "packageManager": "pnpm@10.26.2",
+  "packageManager": "pnpm@10.28.0",
   "engines": {
     "node": ">=20.0.0"
   }

From 8baccc7b50e318626804cb9d8e9e95e3e4cf40bf Mon Sep 17 00:00:00 2001
From: Kato Hiroki <k.hiro1818@gmail.com>
Date: Sun, 18 Jan 2026 06:43:48 +0000
Subject: [PATCH 2/2] chore: Remove old descriptions (#3062)

---
 .../pnpm-10.27-regression/report.md           | 28 ++-----------------
 1 file changed, 2 insertions(+), 26 deletions(-)

diff --git a/docs/dev-notes/2026-01-02/pnpm-10.27-regression/report.md b/docs/dev-notes/2026-01-02/pnpm-10.27-regression/report.md
index 96e59136e..a4fd0c1a1 100644
--- a/docs/dev-notes/2026-01-02/pnpm-10.27-regression/report.md
+++ b/docs/dev-notes/2026-01-02/pnpm-10.27-regression/report.md
@@ -55,33 +55,9 @@ NODE_OPTIONS=--max-old-space-size=8192 pnpm dev  # 失敗（4096 でも失敗）
 - ローカルの `node_modules` キャッシュが古い構造を参照して不整合
 - Vite + SvelteKit の開発サーバ起動時に、watch モード初期化でメモリを過剰消費
 
-## 解決方法（従来の方法）
+## 解決方法（v10.28.0 へのアップグレード）
 
-**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` が正常に起動
-
-## 推奨解決方法（v10.28.0 へのアップグレード）
-
-**状態:** ✅ **2026-01-18 で検証完了 - 推奨**
+**状態:** ✅ 2026-01-18 に検証完了
 
 pnpm v10.28.0 で v10.27.0 の問題が修正されました。