Repository navigation
U2 起動の前の確かめと symlink(#3604 #3864) - #4027
Draft
takemi-ohama wants to merge 11 commits into
Draft
takemi-ohama wants to merge 11 commits into
takemi-ohama wants to merge 11 commits into
Conversation
U2(実装計画の Task 4)。account_dir の is_local・link_shared・planned_links・config_file・ shared_config_file・effective_env・auth_overrides・check_local・check_account と、 account_registry の mark_relogin を縛る(3604:4・5・8・9・10・12、I1・I2・I3・I5)。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP
U2(実装計画の Task 4)。account_dir に is_local・link_shared・planned_links・config_file・ shared_config_file・effective_env・auth_overrides・check_local・check_config・check_account と 型 Links・Local・Resolved・Checked・Launch、理由の符号(REASONS・RELOGIN_REASONS)を置く。 account_registry に mark_relogin と、同期の途中の記録・保留の更新のファイル名を足す。 check_account は引数の上限(PLR0913、6 つ)に合わせ、子の環境・作業ディレクトリ・起動引数を Launch にまとめて受ける。サーバーから取った管理の設定の出所の名前は remote-settings.json にする (廃止した語を避ける)。テストはこの 2 点に合わせて直した。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP
- 起動引数を `--` で止め、値を取るオプションの値を読まない。区切りの解けない引数は auth_unresolved(r1-1) - 制御キーだけの管理の設定をポリシーなしとみなす(r1-2)。選ばれた policyHelper は auth_unresolved(r1-3) - managed-settings.d の隠しファイルを読まず、検査・列挙に失敗したら auth_unresolved(r1-4・r1-5) - サーバーから取った写しの保留される変数は下の源の値を打ち消さず、ANTHROPIC_CONFIG_DIR は重ねない(r1-6) - 相対パスの ANTHROPIC_CONFIG_DIR を子の作業ディレクトリから解く(r1-7) - 設定ファイルの primaryApiKey を auth_overridden にする(値は出さない。r1-8) - Resolved の repr から env と helper を外す(r1-9)。子が開く settings.json のパスの stat も持つ(r1-10) - 失敗の返りを str の Refused にし、項目名と stamps を持たせる(r1-11) - 共有側の作成の競合で先行の項目を使い、一時の名前を排他的に取り、認証ファイルを指す別名を張らない(r1-12〜14) - mark_relogin は実体のディレクトリと独立した account.json にだけ書く(r1-15) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…3864) - 短縮オプションの連結(-pc・-pnx)を commander と同じ規則で分けて読む(r2-1) - --bare と実効の CLAUDE_CODE_SIMPLE は OAuth を読まないので auth_overridden、--restricted は利用者・プロジェクト・ローカルの設定を読まない(r2-2) - サーバーから取った写しがポリシーを持っても、管理の設定のファイルの policyHelper は auth_unresolved(r2-3) - 起動の時点にだけ読む選択の変数(ANTHROPIC_PROFILE・フェデレーションの 2 つ・ANTHROPIC_CONFIG_DIR)を写しから重ねない(r2-4) - planned_links が link_shared と同じ拒否の判定を使い、拒んで起動の後に無い settings.json を不在として判定する(r2-5) - 共有の項目の symlink を参照ごとにたどって途中の名前と置き場を見て、ディレクトリの配下の symlink も見る(r2-6) - mark_relogin は account.json を非ブロッキングで開いて型とリンク数を確かめる(r2-7)。確かめたディレクトリを FD で固定し、排他的に作った一時ファイルから置き換える(r2-8) - _layer は 1 回の stat で印と在るか無いかを決める(r2-9) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…27 の r3。#3604 #3864) - 参照先を OS と同じ順に成分ごとに解き、symlink を経た後の途中の成分と行き着いた先で、保存先への進入とアカウント固有の名前を見る(`..` は解いた後の親へ上がる) - 共有側そのものかその祖先へ行き着く別名、認証・設定のファイルの名前の通常ファイル、保護する実体の別名のハードリンクを公開しない - 拒んだ項目でアカウント側に残す利用者の symlink も検査し、届くなら消さずに起動を not_account_local で拒む - 起動の前の確かめは settings.json だけを見て共有の履歴の木を歩かない。配下の走査は深さと列挙の数に上限を置き、保護する実体にハードリンクが無ければ配下の stat を省く - mark_relogin の一時ファイルを fchmod で 0600 に確定する(umask に左右されない) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…3864) - 見終えたディレクトリの判定を拒否も含めて持ち、後の項目で使い回す。循環は今たどっている経路だけで見て、循環か上限で見切った間の偽の判定は使い回さない(r4-1) - 保護する実体の一覧はアカウント固有の名前を lstat して作り(列挙できないアカウントの中も見る)、backups の配下の通常ファイルも含める。一覧を確定できなければ、別名を持つファイルを公開しない(r4-4) - 配下のファイルと symlink の名前にも is_local() を当てる(旧形式の .config.json・認証ファイルの名前の symlink)(r4-5) - 拒んだ項目でアカウント側に残す通常ファイルとディレクトリも、保護する実体の別名か・配下の参照先を見て、届けば起動を拒む(r4-6) - link_shared は残す項目が届くとき全項目の処理の後に Unsafe を上げ、起動を止める(r4-7) - 別名を持たないファイル(st_nlink が 1)は保護する実体の一覧を作らない。check_account の settings.json の確かめで登録の保存先を列挙しない(r4-8) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…027 の r5。#3604 #3864) - 保護する実体を is_local と同じ規則で集め、前方一致の名前を列挙で拾う。列挙できなければ一覧を未確定にする(r5-1) - 保護する名前が symlink なら参照先の inode を保護する(共有の .claude.json から dotfiles へ。r5-2) - アカウント側に残す項目(飛ばした実体・アカウント側にだけある実体)を、共有側の判定によらず検査する(r5-3) - アカウント側の走査で、自分の設定ディレクトリへ至る途中の成分は進入とみなさない(r5-4) - 保護一覧は別名を持つファイルに当たってから作り、共有側とアカウント側の走査で 1 つを使う(r5-5) - ディレクトリの列挙と symlink の解決を呼び出しの中で使い回し、見直しでも列挙し直さない(r5-6) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
takemi-ohama
commented
Nov 22, 2026
#3864) cross-review の修正(r1〜r5)のうち、承認済みの設計に根拠の無い防御を戻し、f7f528da3 の形へそろえる。 脅威の範囲は「うっかり」と「権限の無い人」だけで、同じ利用者の権限で設定ディレクトリに罠を置く攻撃は範囲の外。 戻したもの: - symlink・ハードリンクを親の成分・配下・inode までたどる拒否(保護する実体の一覧・backups の照合・Unsafe) - 共有のディレクトリを起動のたびに再帰で走査する処理(深さ・件数の上限) - policyHelper・控えの適用の保留・managedSourcesBehavior・起動時だけ読む変数の解釈、primaryApiKey - 起動引数の細かい解釈(-- 以降・-pc の連結・--bare・--restricted) - mark_relogin の FIFO・親の差し替え・予測できる一時名への備え(set_capacity と同じ形へ) - _relink の一時名の乱数化(設計の <項目>.<pid>.link へ) 残したもの(設計の文言に根拠のある直し): - managed-settings.d の隠しファイルを読まない・列挙できなければ auth_unresolved(r1-4・r1-5) - 相対の ANTHROPIC_CONFIG_DIR を子の作業ディレクトリで解く(r1-7) - Resolved の repr に env・helper を出さない(r1-9) - check_account の拒否が項目名と stamps を持つ Refused(r1-11。ready の Probe.stamps のため) - 共有側の作成の競合で落ちない(r1-12) - 1 回の stat で stamps と在るか無いかを取り、権限の失敗を解けないとする(r2-9) - umask に関わらず account.json が 0600(r3-5。write へ戻して満たす。テストを残す) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP
…3604 #3864) - _relink: 一時の名前 <項目>.<pid>.link に symlink でない実体があれば消さずに FileExistsError(I2)。残りの symlink だけ張り直す(r1-2) - _flag: claude_args の表で読み、-- より後の位置引数とほかのオプションの値を --settings・--setting-sources と読まない(r1-3)。claude_args.options を足した - _profile: active_config が UTF-8 でない・名前が configs/ の直下のファイルにならないときは例外を出さず auth_unresolved(r1-10) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… を解けないとする - r2-1: 固定の一時名を消さず、呼び出しごとに mkdtemp で作ったディレクトリの中で張って移す - r2-2: ANTHROPIC_CONFIG_DIR に NUL があればファイルに触れる前に auth_unresolved とする Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…を次に片付ける(PR 4027 の 3 回目の r3。#3604 #3864) - r3-1: os.replace をやめ、確保した一時の名前へ os.rename で退避してから中身を見る。symlink なら消して排他で張り直し、 実体なら os.link で元の名前へ戻して skipped に入れる。ディレクトリは ENOTDIR で移らずに残る - r3-2: mkdtemp・rmdir と成功時の空振りの unlink をなくし、`.ndf-relink.<項目>.<乱数>` を os.symlink の排他で作る。衝突したときだけ引き直す - r3-3(実装側): link_shared の最初に _sweep が中断した一時の名前を片付ける(symlink は消し、実体は元の名前が空いていれば戻す) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
概要
実装の単位 U2「起動の前の確かめと symlink」(実装計画
issues/issue-3604-3864-plan.mdの Task 4)。plugins/ndf/src/ndf/domains/relay/account_dir.py(新設):is_local・link_shared・planned_links・config_file・shared_config_file・effective_env・auth_overrides・check_local・check_config・check_accountと型Checked・Local・Links。飛ばす理由(REASONS)とRELOGIN_REASONSaccount_registry.py:mark_reloginsync_config・prepare・settleほか)は U3 の範囲で、ここでは作らない実装の中で決めたこと
check_accountの引数をLaunch(env・cwd・argv)にまとめた。 詳細設計のシグネチャは引数が 8 つで、このリポジトリのPLR0913(上限 6、抑制できない)に当たる。子が実際に受け取る 3 つは U3 のready・prepareも同じ組で渡すので、1 つの型にした(設計への指摘)Resolvedをこの単位で作った。effective_envの返りで、Checkedが持つため。起動指示は U3 の範囲に挙げていたが、計画の Task 4 のeffective_envに要る。pins(キーの子の照合した設定への固定)はキーの子の単位で使うので入れていない(設計への指摘)Resolved.profileを足した。 有効なプロファイルの認証の形(oidc_federationか)をauth_overridesがResolvedだけで判定するためで、設計の型には無い(設計への指摘)。プロファイルの置き場は WIF の文書のとおり<設定ディレクトリ>/active_config(無ければdefault)とconfigs/<名前>.jsonのauthentication.type管理の設定(remote-settings.json)にした。 設計の管理の設定(サーバーの控え)は、検査banned-wordが「控え」を廃止した語として落とすMANAGED_FILES・MANAGED_DIR)だけにし、effective_envの引数にしなかった。 テストは定数を差し替える(引数を足すとauth_overridesとの呼び方が分かれるため)account-dropの行のうちsecretが真のもの(ANTHROPIC_API_KEY・ANTHROPIC_AUTH_TOKEN・CLAUDE_CODE_OAUTH_TOKEN)にした。 表から引き、一覧を写さないenvで重ねない変数はCLAUDE_CONFIG_DIR・CLAUDE_CODE_OAUTH_TOKEN・CLAUDE_CODE_OAUTH_SCOPESの 3 つ。 設計の「ほか」の中身は確かめていないauth_unresolvedにした(設計の「解けない源の扱い」に行が無い)account_registryにBASE_NEXT_FILE・PENDING_FILE(ファイル名だけ)を足した。LOCAL_NAMESとcheck_localが使うbackupsの照合・Unsafe)、共有のディレクトリを起動のたびに再帰で走査する処理(深さ・件数の上限)、管理の設定の解釈のうち設計に無いもの(policyHelper・控えの適用の保留・managedSourcesBehavior・起動時だけ読む変数)、primaryApiKey、起動引数の細かい解釈(--以降・-pcの連結・--bare・--restricted)、mark_reloginの FIFO・親の差し替え・予測できる一時名への備え(set_capacityと同じ_read→ 書き換え →writeの形へ)、_relinkの一時名の乱数化(設計の<項目>.<pid>.linkへ)managed-settings.dの隠しファイルを読まない・在るのに列挙できなければauth_unresolved(r1-4・r1-5)、相対のANTHROPIC_CONFIG_DIRを子の作業ディレクトリで解く(r1-7)、Resolvedのreprにenv・helperを出さない(r1-9、I5)、check_accountの拒否を項目名とstampsを持つRefused(strの子)で返す(r1-11。readyのProbe.stampsが失敗でも判定に使った源を持つため)、共有側のprojects・settings.jsonの作成の競合で落ちない(r1-12)、1 回のstatでstampsと在るか無いかを取り権限の失敗を解けないとする(r2-9)、umask に関わらずaccount.jsonが 0600(r3-5。writeのfchmodで満たし、テストを残す)prepareのlink_sharedの失敗の扱い)はUnsafeを消して設計どおりOSErrorだけになった。r4-3(<共有>/ndfからndf/accounts/<別名>/の認証ファイルへ届く)は塞がず設計への指摘に残す(I1 の文言は共有側の.credentials.jsonで、ndfを外すと子のフックがrelay.current・relay.versionを読めない)ndf/accountsの扱い、/loginで保存した API キー(primaryApiKey)を「当たる条件」に入れるか、管理の設定のpolicyHelper・控えの適用の保留と--bare・--restrictedを実効値の作り方に入れるか、argvの読み方(今は名前の一致だけで、値として渡った--settingsも読む)テスト
テストは CI で走らせる(
.ndf/project.jsonのtest.ci.only)。先に push したテストだけのコミット: e7413eb。実装のコミット: f7f528d(Launchと出所の名前に合わせてテストも直した)実装の時点の差分の行数(
uv.lock・docs/contracts/env.mdを除く): 4 files changed, 1156 insertions(+)(src 575 行・tests 581 行)戻した後の差分の行数(
git diff --shortstat origin/sprint/3604-3864-relay-accounts...HEAD -- . ':(exclude)**/uv.lock'): 4 files changed, 1281 insertions(+)(src 620 行・tests 661 行)。cross-review の修正の後は 2,466 行だった関連: #3604 #3864
🤖 Generated with Claude Code
https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP