feat(python/launcher): データ分離した Resonite 多重起動と terminate-all を再実装

[Geson-anko]

背景

Resonite の多重起動は以前 PR #66 で実装したが commit b8f51c6 で撤回された。撤回理由は (1) data path (WINEPREFIX / DataPath) を分離し忘れて Resonite DB が競合、(2) renderer との Camera IPC queue 名が固定 (resonite-io-camera-frames) で多重起動時に衝突・クロストークする設計欠陥。撤回時は Python launcher のみ巻き戻し、C# 側の IPC 名分離は未着手だった。

本 PR はこの 2 つのブロッカーを正しく解消して多重起動を再実装する。

確定済みの方針 (ユーザー合意)

1. 一括停止は別コマンド: 単一 terminate (engine/renderer pid を返す pid-only) は不変。一括停止は新コマンド terminate-all で list を返す。
2. ラベルで自動データ分離: launch --name <label> で ~/.resonite-io/instances/<label>/ 配下に WINEPREFIX / DataPath / CachePath / LogsPath を自動採番・分離。--name 無しは単一起動挙動を温存。
3. renderer queue 名は engine 生成→子継承: engine mod が起動最早期に token を生成し env へ set、renderer は子プロセスとして継承。env 未設定時は従来固定名に fallback。

Summary

C# (mod/camera)

• IpcSocketPaths.QueueName を const から env-override (RESONITE_IO_CAMERA_QUEUE) 付き static プロパティ化 (GrpcHost.ResolveSocketPath と同じパターン)。受信側 RendererFrameInterprocessReceiver / 送信側 FrameSender は参照のみで自動分離。
• ResoniteIOPlugin.Load() で env 未設定時のみインスタンス固有 token を生成・set。renderer spawn より前の最早期 Load() で行う必要がある (decompiled で RenderSystem.StartRenderer が OnEngineReady より前と確認)。
• renderer prebuilt を再生成 (just renderer-prebuild)。

Python (launcher / CLI)

• launch(name=...): ラベル配下に 4 dir を自動採番、prefix/data_path/cache_path/logs_path を分離 (明示値 > ラベル自動 > 既定)、token env 注入。--name 無しは global already-running guard を温存、--name 時は per-label lock で同ラベル二重起動のみ拒否。
• _wait_for_single → _wait_for_new (PID 集合差分) に復元 (他インスタンス稼働中でも本 launch の個体だけ返す)。
• terminate_all() -> list[LaunchResult] を復元 (engine と子 renderer をペアリング、孤立 renderer も kill)。新コマンド resoio terminate-all (--format human|json)。
• CLI: resoio launch --name <label>。

docs

• docs/cli.md / CHANGELOG.md に多重起動・terminate-all を反映。

Test plan

• just run green (format → gen-proto → build → test → type → check-renderer-prebuilt)
• C# 単体: IpcSocketPaths.QueueName の env-override (real env)
• Python 単体 (real OS プロセス, mock 禁止): _wait_for_new / ラベル分離 / per-label lock guard / terminate_all / CLI 配線・出力
• e2e 多重起動 (@mark_e2e, tests/e2e/multi_instance.py): real 2 インスタンスを別 socket で ping/screenshot → Camera クロストーク無し → terminate-all で両方 gone ※実機 Resonite 環境で要実行

🤖 Generated with Claude Code

[Geson-anko]

✅ e2e 多重起動を実機で実行 (green)

mod を再デプロイ (engine + renderer plugin、token 変更込み) のうえ just e2e-test multi_instance を実機 Resonite で実走し PASSED。

検証できたこと:

• 別 WINEPREFIX / DataPath で 2 インスタンス同時起動: instances/a/prefix instances/b/prefix が各 ~677M で個別に Proton bootstrap、data も別 (2.7M / 1.7M)。4 PID すべて distinct。
• 別 socket で個別接続: resonite-{pid}.sock 2 つに ConnectionClient で ping 成功。
• Camera クロストーク無し (核心): 両インスタンスから独立に screenshot 取得。instance_a.png (mean=3.4 std=23.7) と instance_b.png (mean=0.5 std=6.6) は shape 同一だがピクセル非一致 = 各 engine が自分の renderer queue から別フレームを受信。固定 queue 名なら衝突して片方が starve するはずが、token 分離で正しく独立。
• terminate-all で全 gone: 実行後に socket / engine / renderer プロセスのリーク無し。

実行ログ抜粋:

tests/e2e/multi_instance.py::TestMultiInstance::test_two_named_instances_run_isolated_then_terminate_all PASSED
1 passed in 21.15s

[Geson-anko]

🔧 設計修正: 多重起動ガードを全廃

レビュー指摘を反映し、PID 検出による launch ガードを global / per-label とも全廃しました。--data-path を別々に渡せば多重起動できるため、稼働中インスタンスの存在で launch を拒否するのは誤りでした。

• launch は「既に起動中」で二度と拒否しない（global already-running guard 削除）。
• per-label lock (launch.lock + _reject_if_instance_running / _write_instance_lock) を削除。--name は データツリーの自動採番 + Camera queue token のみを担う純粋な便宜機能で、起動をゲートしない。同ラベル再起動も許可。
• docs / CHANGELOG を「多重起動は --data-path 分離が基本、--name は便宜」に更新。

just run 全 green。terminate-all と Camera token 分離 (本 PR の核心) は不変です。