Skip to content

ndf の起動が UV_PROJECT_ENVIRONMENT・VIRTUAL_ENV を子孫へ漏らし、利用先の uv run がプラグインの共有の venv を同期し直して並列のレーンの NDF が import で落ちる #4029

Open

Description

@takemi-ohama

例: 計画 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

  1. takemi-ohama commented on Nov 21, 2026

    @takemi-ohama
    ContributorAuthor

    受け入れ条件 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 である。

    版 前(ファイル数・sha256) 後(ファイル数・sha256) NDF の venv の six
    直す前(ba525ea56) 6280・d6020fc89dcb95e0 6288・a453e69cd1af1447 入った(six.py と dist-info の 7 件が増えた)
    直した版 6280・2b49a3a922bed431 6280・2b49a3a922bed431 入らない(six は利用先の .venv へ入った)

    子のステップの環境:

    • 直す前: UV_PROJECT_ENVIRONMENT・VIRTUAL_ENV が NDF の venv、UV_RUN_RECURSION_DEPTH=1、PYTHONPATH が NDF の src、CLAUDE_PLUGIN_ROOT が NDF の根、PATH の先頭が NDF の venv の bin
    • 直した版: 5 つとも無く(呼び出し元が持っていなかったため)、PATH の先頭は呼び出し元の先頭のまま

    書き換えられた venv を戻す

    直す前の版で書き換えた一時の venv は、start.py が示す入れ直しの手順で、書き換えの前と同じ中身(6280・d6020fc89dcb95e0)へ戻った。

    UV_PROJECT_ENVIRONMENT=~/.cache/ndf/venv/<版> uv sync --frozen --no-dev --reinstall --project <導入した NDF の根>
    

    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 など)で入れ直されていた。直した版が出るまでは同じことが続く。

  2. added 6 commits that reference this issue on Nov 22, 2026
    20c7ea4
    c130e0b
    88fe59d
    47911e4
    5e991b4
    68d8879
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions