Skip to content

Fix: #4029 NDF の起動が足す uv と venv の変数を子孫へ漏らさない - #4034

Open
takemi-ohama wants to merge 5 commits into
sprint/p12-lcrfast-r1from
impl/4029-env-leak
Open

takemi-ohama wants to merge 5 commits into
sprint/p12-lcrfast-r1from
impl/4029-env-leak

Conversation

@takemi-ohama

@takemi-ohama takemi-ohama commented Nov 21, 2026 •

Copy link
Copy Markdown
Contributor

概要

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 を同期し直していた。

直し方

  1. bin/ndf が export の前に、呼び出し元の UV_PROJECT_ENVIRONMENT・VIRTUAL_ENV・UV_RUN_RECURSION_DEPTH・PATH・PYTHONPATH を NDF_CALLER_<名前> へ写す(あれば空でも写し、無ければ写しを消す)。CLAUDE_PLUGIN_ROOT は既存の NDF_CALLER_PLUGIN_ROOT
  2. bin/start.py が python -m ndf の前に os.environ を写しの値へ戻し、写しを消す(名前の並びは CALLER_ENV のデータ)。sys.path は起動時に決まるので自分の import は変わらない。identity._foreign_root の結果も変わらない
  3. 自分のサブコマンドを子で打つ 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)
  4. 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 で閉じる)。

テスト

  • 手元(範囲を絞った): 直す前に追加したテストの 10 件が落ち、直した後 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/checks 150 passed
  • 静的解析: script-structure・ndf-contracts・check-lint(ruff)・ndf check --write-spec は違反なし
  • 合否は PR の CI で決める(test.ci.only)

🤖 Generated with Claude Code

https://claude.ai/code/session_01KYHP7yJUneZaRepeUkJPWD

- 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
Comment thread plugins/ndf/src/ndf/cli.py Outdated
"""子プロセスの環境変数。このパッケージの保存先(`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)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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 が保たれることを検証してください。

Comment thread plugins/ndf/bin/start.py

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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 経由にして、テストを足すこと。

@takemi-ohama

takemi-ohama commented Nov 22, 2026 •

Copy link
Copy Markdown
Contributor Author

cross-review の記録(PR #4034)

終わり方: 誤りで止まった。ラウンド 3・指摘 4(直した 2・見送った 1・未解決 1)

ラウンドと修正

ラウンド レビューした head 範囲 判定 修正のコミット 送った 直した指摘
1 5b2d42cbb full errored — — —
2 20c7ea466 since changes_required c130e0bce 送った r1-1・r2-1
3 c130e0bce since errored — — —

指摘

番号 担当 重要度 場所 指摘 終わり方 見送った理由
r1-1 codex major plugins/ndf/src/ndf/cli.py:181 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 が保たれることを検証してください。 直した 既存のコミット 20c7ea4 で ndf_env を廃止した。ndf_command が src を argv で子へ渡し、子の sys.path にだけ入れる。test_queue_run の test_a_queue_step_keeps_the_callers_pythonpath が、ndf plan queue から起動した実際のステップに、呼び出し元の PYTHONPATH(無い場合と有る場合)がそのまま届くことを確かめる。c130e0bce ではこのテストの親の起動を ndf_command に揃えた。
r1-2 kiro major plugins/ndf/bin/start.py 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 経由にして、テストを足すこと。 見送った 基準 1 に当たらない。src を sys.executable・-m・PACKAGE で検索した。bin/start.py を通るプロセスから ndf を Python の子で起動する箇所は 5 つで、queue_run._child_args、invoke.plan_argv、invoke の script の作業、gate/entry の worker、run.launch_worker のすべてが既に ndf_command を通っている。ほかに -m で起動するのは hooks の outbox.kick と env.kick_prepare の 2 か所だけで、どちらも hooks/claude.json から venv の python で hooks/entry.py を直接起動した hook のプロセスの中で動き、start.py を通らない。outbox.kick は PYTHONPATH に src を明示し、kick_prepare は cwd を src にしているので import できる。レーン・relay・cross-review は ndf を名前で打つので、毎回 bin/ndf が src を入れ直す。落ちる起動箇所が残っていないため、対象のファイルは変えない。
r2-1 codex major plugins/ndf/src/ndf/cli.py:177 子の Python は _BOOT を実行する前に sitecustomize を読みます。呼び出し元の PYTHONPATH 上にある起動フックが ndf を import すると、旧実装では先頭の NDF の src から解決されましたが、この変更後は呼び出し元側の同名パッケージが sys.modules に残ります。その後で src を先頭に挿しても runpy.run_module は先に読み込まれたパッケージを使うため、キューやワーカーが別のコードを起動時の認証情報で実行し得ます。呼び出し元の環境変数は子孫に引き継ぎつつ、内部 CLI の Python 起動時の import 探索には呼び出し元の PYTHONPATH を使わせないようにしてください。 直した ndf_command の子の起動を -P から -I に替えた。PYTHON* の環境変数を起動時の import の探索に使わないので、呼び出し元の PYTHONPATH 上の sitecustomize は読まれない。環境変数そのものは os.environ に残り、子孫へ引き継がれる。test_cli に、呼び出し元の sitecustomize が偽の ndf を import する場合を加えた(-P に戻すと落ちることを確認済み)。全体テスト 1847 件が通った。
r3-1 codex major plugins/ndf/src/ndf/cli.py:180 -I は PYTHONUTF8 と PYTHONIOENCODING も無視するため、親子で出力の文字コードが食い違い、ndf plan queue が結果 JSON を回収できず停止します。LC_ALL=C PYTHONUTF8=0 PYTHONIOENCODING=ascii:backslashreplace の環境で日本語を出す子を text=True で読むと、従来の -P ではエスケープ済みの出力を読めますが、-I では子が UTF-8 を出して親が UnicodeDecodeError になります。内部 CLI の結果パイプは送受信側とも文字コードを明示し、この環境で日本語を含む結果を回収できることを検証してください。 未解決 —

注意

takemi-ohama and others added 4 commits November 22, 2026 00:05
…残さない

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>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant