## 例: 計画 p12 の lracct の cross-review(2026-11-22 08:06 JST) PR #4027 の cross-review の修正担当(`claude -p`)が、worktree `/work/ai-plugins/.worktrees/impl/3604-u2-account-dir` で `uv run --frozen --project . --all-extras pytest plugins/ndf/tests -q -n 4` を打った。そのプロセスの環境には `UV_PROJECT_ENVIRONMENT=/home/ubuntu/.cache/ndf/venv/11.0.13` と `VIRTUAL_ENV=/home/ubuntu/.cache/ndf/venv/11.0.13` があった(親を辿ると `ndf cross-review run` ← `uv run --project <プラグイン>`)。 uv はリポジトリの依存を、プラグインの共有の venv(`~/.cache/ndf/venv/11.0.13`)へ同期し直した。 | 時刻(JST) | 起きたこと | | --- | --- | | 07:56 | venv の `sqlalchemy` などが入れ直され、その最中に lcrfast の `ndf lanes wait` が `ImportError` で落ちた | | 08:06:31 | venv の `pydantic`・`sqlalchemy`・`dbos`・`slack_sdk` などが入れ直され、その最中にオーガナイザーの `ndf lanes wait p12` が `ModuleNotFoundError: No module named 'pydantic._internal._signature'` で落ちた | | 08:06 以後 | venv に `_editable_impl_playwright_kit.pth` が入り、lracct の worktree(`.worktrees/impl/3604-u4-usage-cache/plugins/playwright-kit/...`)を指している。worktree を消すと指す先を失う | 同じマシンの全レーン・耐久ワークフロー(`ndf lanes run`)・オーガナイザーは同じ venv の NDF を使うので、同期の間に import する NDF のコマンドが落ちる。 ## 原因 `plugins/ndf/bin/ndf` の 88 行目が `export UV_PROJECT_ENVIRONMENT="$cache_home/venv/$version"` を打ってから `uv run --project "$root" python -P bin/start.py` を exec する。`uv run` は `VIRTUAL_ENV` を足し、`PATH` の先頭に venv の `bin` を置く。どれも NDF のプロセスの子孫(中継が起動するレーンの claude・cross-review の修正担当・プランの worker・その下のシェル)へそのまま引き継がれる。子孫が利用先のリポジトリで `uv run --project .`(や `uv sync`)を打つと、uv は利用先のプロジェクトをプラグインの venv へ同期する(`--frozen` の完全な同期なので、入れ直しと editable の追加が起きる)。 同じ形で `CLAUDE_PLUGIN_ROOT`・`PYTHONPATH`(NDF の `src` が先頭)も子孫へ漏れている。 ## 目的 - **今どうなっているか**: NDF の環境の変数が子孫のすべてへ漏れ、利用先のリポジトリのコマンドが NDF の venv を書き換える。並列の計画では、同期の間に別のレーンの NDF が落ちる - **誰に効くか**: uv を使う利用先のリポジトリで NDF を動かす人すべて(並列の計画では全レーン) - **変えると何が成り立つか**: NDF の venv は NDF の起動と入れ直しの手順だけが書き、利用先のコマンドは自分の環境で動く ## 対象範囲 - 含む: NDF のプロセスが子を起動するとき(中継のレーンの起動・cross-review の相手役と修正担当・プランの worker・`subprocess` 全般)、`UV_PROJECT_ENVIRONMENT`・`VIRTUAL_ENV`・`PATH` の venv の先頭・`PYTHONPATH` の NDF の `src` を、NDF が足す前の値へ戻して渡す(どこで戻すかは設計で決める。`bin/start.py` で元の値を控えて外す・子の起動の 1 か所で外す、など) - 含む: 既に書き換えられた venv を戻す手順の案内(`start.py` の入れ直しの手順 `uv sync --frozen --no-dev --reinstall` で戻るかを確かめる) - 含まない: NDF の子が NDF のコマンドを打つ経路(`bin/ndf` が毎回立て直すので変えない) ## 受け入れ条件 - [ ] NDF が起動した子の環境に、NDF が足した `UV_PROJECT_ENVIRONMENT`・`VIRTUAL_ENV` が無い(呼び出し元が元から持っていた値は残る)(テスト) - [ ] NDF が起動した子の `PATH` の先頭が NDF の venv の `bin` でなく、`PYTHONPATH` に NDF の `src` が無い(テスト) - [ ] 子から NDF のコマンド(`ndf ...`)を打つと、今と同じく NDF の venv で動く(テスト) - [ ] 利用先のリポジトリの子で `uv run --project .` を打っても、NDF の venv のファイルが変わらない(手元で 1 回確かめた結果をこの Issue に残す) ## 関連 - 引き金になった修正担当の全体テストは、別の Issue(cross-review の修正担当が `test.ci.only` を守らない)に起票した
Activity
takemi-ohama commentedon Nov 21, 2026
受け入れ条件 4 を手元で確かめた結果(2026-11-22 JST)
修正の PR: #4034
利用先のリポジトリの代わりに、依存が
six==1.17.0だけの一時の uv プロジェクトを作り、ndf plan nextのステップからuv run --project <一時のプロジェクト> python -c "import six"を打った。NDF の venv は一時のXDG_CACHE_HOMEの下に作り、共有の~/.cache/ndf/venv/11.0.13は使っていない。venv の指紋は__pycache__を除く全ファイルの一覧と中身の sha256 である。d6020fc89dcb95e0a453e69cd1af1447six.pyと dist-info の 7 件が増えた)2b49a3a922bed4312b49a3a922bed431.venvへ入った)子のステップの環境:
UV_PROJECT_ENVIRONMENT・VIRTUAL_ENVが NDF の venv、UV_RUN_RECURSION_DEPTH=1、PYTHONPATHが NDF のsrc、CLAUDE_PLUGIN_ROOTが NDF の根、PATHの先頭が NDF の venv のbinPATHの先頭は呼び出し元の先頭のまま書き換えられた venv を戻す
直す前の版で書き換えた一時の venv は、
start.pyが示す入れ直しの手順で、書き換えの前と同じ中身(6280・d6020fc89dcb95e0)へ戻った。uv syncは lock に無いパッケージを外すので、利用先が入れたパッケージ(pytest・playwright・_editable_impl_playwright_kit.pthなど)も消える。並列のレーンが NDF を使っている間に打つと、同期の間に import が落ちるので、レーンが止まっている間に打つ。なお 2026-11-22 08:35〜08:37 JST にも、共有の
~/.cache/ndf/venv/11.0.13に lracct の worktree(.worktrees/impl/3604-u2-account-dir)を指すplaywright_kitの editable が入り、導入済みの 11.0.13 の lock の版(ruff 0.16.9 など)で入れ直されていた。直した版が出るまでは同じことが続く。Fix: #4029 自分のサブコマンドの子へ src を PYTHONPATH でなく argv で渡し、子孫へ NDF の src を…
Fix: #4029 内部 CLI の子を -I で起動し、呼び出し元の PYTHONPATH を起動時の import に使わない
Fix: #4029 内部 CLI の子の標準入出力を -X utf8 で UTF-8 に決め、親も UTF-8 で読む
Fix: #4029 内部 CLI の子は標準出力・標準エラーだけを UTF-8 に決め、ステップと外部スクリプトの出力はロケールで読む
Fix: #4029 ndf answer work の置き換え先は呼び出し元の標準出力・標準エラーの文字コードで書く
Merge pull request #4034 from devbasex/impl/4029-env-leak