Repository navigation
Fix: #4029 NDF の起動が足す uv と venv の変数を子孫へ漏らさない - #4034
takemi-ohama wants to merge 5 commits into
Conversation
- bin/ndf: UV_PROJECT_ENVIRONMENT・VIRTUAL_ENV・UV_RUN_RECURSION_DEPTH・PATH・PYTHONPATH の呼び出し元の値を NDF_CALLER_<名前> へ写す(あれば空でも写し、無ければ写しを消す) - bin/start.py: python -m ndf の前に、写しから呼び出し元の値へ戻し、写しを消す(CLAUDE_PLUGIN_ROOT は NDF_CALLER_PLUGIN_ROOT から。空なら消す)。写しが無ければ何もしない - 自分のパッケージを子で打つ ndf_command・ndf_env を ndf.cli へ移し、plan queue の子と ndf answer work の 置き換えが PYTHONPATH に src を受けるようにした(core の層は progress を読めないため) - 環境変数の表に写しの変数を足し(child: drop)、生成物 env.md を作り直した Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KYHP7yJUneZaRepeUkJPWD
| """子プロセスの環境変数。このパッケージの保存先(`src`)を `PYTHONPATH` の頭へ足す。""" | ||
| out = dict(env) | ||
| held = out["PYTHONPATH"] if "PYTHONPATH" in out else "" | ||
| out["PYTHONPATH"] = os.pathsep.join(p for p in (str(SRC), held) if p) |
There was a problem hiding this comment.
cross-review の指摘 r1-1(codex・ラウンド 1・major)
ndf_env が PYTHONPATH に NDF の src を足し、内部 CLI は bin/start.py を経由せずに起動します。そのため ndf plan queue から起動した plan next のステップは、呼び出し元に PYTHONPATH が無くても NDF の src を継承します。利用先の Python が同名パッケージを import すると NDF 側が先に見つかります。内部 CLI の import に使うパスは sys.path にだけ設定し、キュー配下の実際のステップで呼び出し元の PYTHONPATH が保たれることを検証してください。
There was a problem hiding this comment.
cross-review の指摘 r1-2(kiro・ラウンド 1・major)
bin/start.py が PYTHONPATH を呼び出し元の値へ戻すため、python -m ndf や sys.executable で ndf を子プロセスとして起動する箇所はすべて ndf_env で src を渡す必要がある。差分で直したのは queue_run._start・gate._cmd_work・invoke の3か所だけである。ほかの起動箇所(レーン・relay・worker・cross-review などで -m ndf を打つ所)が ndf_env を通っていなければ、利用先のリポジトリで ndf を import できず子が落ちる。src 全体を -m・sys.executable・PACKAGE で検索し、見つかった起動箇所をすべて ndf_command・ndf_env 経由にして、テストを足すこと。
cross-review の記録(PR #4034)終わり方: 誤りで止まった。ラウンド 3・指摘 4(直した 2・見送った 1・未解決 1) ラウンドと修正
指摘
注意
|
…残さない cross-review の指摘 r1-1・r1-2 への修正(修正担当が上限の時間で止まった後の変更を、範囲のテストを通してコミットした)。 - ndf_command は `python -P -c <起動の 1 行> <src> ...` で、src を子の sys.path の頭へだけ入れる - ndf_env を外し、queue_run・answer work・StageRun・launch_worker は呼び出し元の環境のまま子を起動する - 内側の経路(python -m ndf の子)の子孫にも PYTHONPATH の NDF の src が残らない(#4035) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KYHP7yJUneZaRepeUkJPWD
呼び出し元の PYTHONPATH にある sitecustomize が同じ名前のパッケージを先に sys.modules へ入れると、 src を sys.path の頭へ挿しても runpy はそちらを走らせる。-I で PYTHON* の環境変数を import の探索から外し、 環境変数そのものは子孫へ残す。キューのテストは ndf_command で親を起動する。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
cross-review の指摘 r3-1 への修正(修正担当が上限の時間で止まった後の変更を、範囲のテストを通して整形しコミットした)。 -I は PYTHONUTF8・PYTHONIOENCODING を無視するので、C ロケールでも親子の文字コードが食い違わないようにする。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KYHP7yJUneZaRepeUkJPWD
cross-review の指摘 r4-1・r4-2 への修正。 - `-X utf8` をやめ、子の起動の 1 行で stdout・stderr だけを UTF-8 へ決め直す。ロケールの文字コードは変えず、 `-I` が無視する `PYTHONUTF8` は `-X utf8=` で写す(プランの run・probe の出力は従来どおりロケールで読む) - `run_command` は `ndf_command` の子だけを UTF-8 で読み、script の外部スクリプトはロケールの文字コードで読む(`child_encoding`) - EUC-JP のロケールを localedef で作り、キュー経由の run・probe と外部スクリプトの結果 JSON を確かめるテストを足した Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
概要
Closes #4029 の受け入れ条件 1〜3(テスト)。Closes #4035。条件 4 は手元で 1 回確かめた結果を Issue にコメントした。
bin/ndfがUV_PROJECT_ENVIRONMENT・PYTHONPATH・CLAUDE_PLUGIN_ROOTを export し、uv runがVIRTUAL_ENV・UV_RUN_RECURSION_DEPTH・PATHの先頭の venv のbinを足すため、NDF のプロセスの子孫(cross-review の修正担当・プランの worker など)が利用先で打つuv run --project .が NDF の共有の venv を同期し直していた。直し方
bin/ndfが export の前に、呼び出し元のUV_PROJECT_ENVIRONMENT・VIRTUAL_ENV・UV_RUN_RECURSION_DEPTH・PATH・PYTHONPATHをNDF_CALLER_<名前>へ写す(あれば空でも写し、無ければ写しを消す)。CLAUDE_PLUGIN_ROOTは既存のNDF_CALLER_PLUGIN_ROOTbin/start.pyがpython -m ndfの前にos.environを写しの値へ戻し、写しを消す(名前の並びはCALLER_ENVのデータ)。sys.path は起動時に決まるので自分の import は変わらない。identity._foreign_rootの結果も変わらないndf_commandをndf.cliへ移し(層の規則で core からも読めるように)、python -P -c <起動の 1 行> <src> ...の形で src を子のsys.pathの頭へだけ入れる。ndf_env(PYTHONPATH に src を足す)は外し、plan queueの子・ndf answer work・工程の作業・progressの worker は呼び出し元の環境のまま起動する(cross-review の指摘 r1-1・r1-2)contracts/domains/env.jsonに写しの 5 行(child: drop)を足し、生成物のdocs/contracts/env.mdを作り直した子が
ndf ...を打てばbin/ndfが毎回 NDF の venv を指し直すので、今と同じく NDF の venv で動く(条件 3)。内側の経路
NDF が自分のサブコマンドを子で打つ経路(
plan queueの子・工程の作業など)も、src を環境変数でなく argv で渡すので、その子孫のPYTHONPATHに NDF のsrcが残らない(範囲外として起票した #4035 をこの PR で閉じる)。テスト
tests/bin・tests/cli・tests/core/plan/test_queue_run.py・test_queue.py・tests/progress/gate・tests/progress/test_invoke.py・test_run.py・tests/identity・relay の session_env のテスト・tests/domains/test_entrypoints.py・tests/checksで 715 passed・1 skipped。r1 の修正の後はtests/bin・tests/cli・tests/core/plan・tests/progress・tests/identity・relay の parts・entrypoints で 1233 passed・80 skipped、tests/checks150 passedndf check --write-specは違反なしtest.ci.only)🤖 Generated with Claude Code
https://claude.ai/code/session_01KYHP7yJUneZaRepeUkJPWD