fix(devcontainer): resonite-share volume を dev 所有で先行作成し resoio launch ハングを解消

[Geson-anko]

概要

devcontainer 内で resoio launch が約 60 秒ハングしてタイムアウトする問題を修正する。

原因

engine の DataPath = /home/dev/.local/share/Yellow Dog Man Studios は named volume resonite-share のマウント先。空の named volume はマウント先がイメージ内に存在しないと Docker が root 所有で初期化するが、Dockerfile の pre-create リストはこの実マウント先 (.../Yellow Dog Man Studios) だけ漏れていた (/home/dev/.local/share までしか作っていなかった)。

結果、USER dev (uid 1000) で動く engine が root 所有ディレクトリ直下に Data/ を作れず、FrooxEngine.Engine.SetupExceptionHandler の Directory.CreateDirectory で UnauthorizedAccessException: ... Permission denied を投げて起動直後 (約1秒) にクラッシュ。renderer も gRPC socket も上がらず、launcher が renderer PID を 60s ポーリングしてタイムアウトしていた。

/opt/resonite (resonite-app) と /home/dev/prefix (resonite-prefix) が dev 所有で正常動作するのは、まさにこれらが pre-create 済みだから。1 ディレクトリだけ漏れていたのが本質。

修正

install -d -o dev -g dev のリストに実マウント先 "/home/dev/.local/share/Yellow Dog Man Studios" を追加し、fresh volume が dev 所有を継承するようにした。あわせて該当コメントを実パス + 理由に修正。

検証

• 失敗再現: resoio launch → error: timed out waiting for the Resonite renderer process to appear (EXIT=1, ちょうど 60s)、engine ログに上記例外。
• 修正の実証: resoio launch --data-path <dev書込可能パス> で engine が Initializing RenderSystem... → Renderer process started: Renderite.Renderer.exe → resonite_pid/renderer_pid 返却 まで完走 (EXIT=0)。root 所有が唯一のブロッカーであることを実機確認。

適用上の注意 (reviewer/利用者向け)

イメージ再ビルドが必要。既存の root 所有 volume はリビルドだけでは直らない (Docker は既存 volume を再初期化しない) ため、次のいずれかを併用する:

• 既存データ保持: コンテナ内で sudo chown -R dev:dev "/home/dev/.local/share/Yellow Dog Man Studios"
• volume リセット: docker compose down 後 docker volume rm resonite-io-resonite-share → リビルド (ユーザーデータは消える)

🤖 Generated with Claude Code