Skip to content

U5b 取得の手順と排他・トークンの更新(#3604 #3864) - #4038

Draft
takemi-ohama wants to merge 7 commits into
sprint/3604-3864-relay-accountsfrom
impl/3604-u5b-usage-fetch
Draft

takemi-ohama wants to merge 7 commits into
sprint/3604-3864-relay-accountsfrom
impl/3604-u5b-usage-fetch

Conversation

@takemi-ohama

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

Copy link
Copy Markdown
Contributor

概要

実装の単位 U5b「取得の手順と排他・トークンの更新」(実装計画の Task 9)。

満たす受け入れ条件: 決定 4(取得)・決定 4・I16(トークンの更新)

この PR は U5b の前半である。 取得の手順の本体(fetch_usage・_refresh・_read_auth・_refresh_lock)は、詳細設計書の「取得の手順と排他」のとおり起動の前の確かめと同期の部品(U2 の check_local・Local・mark_relogin、U3 の pin_dir・apply_pending・replace_auth・write_pending・in_use・refresh_lock)を使う。それらはスプリントブランチにまだ無く、実装計画の依存の表(U5b は U4・U5a の後)と食い違うため、入れていない。続け方は supervisor の判断を待つ。

  • accounts.py: fetch_path・fetch_lock_path・fetch_lock・fetch_wait・read_windows・write_fetch・due・FetchGate。usages が取得の記録の窓と spend_limit_reached を読み、forget が取得の記録を消す
  • cli_account.py: account add・account remove が、同じ名前の取得の排他を待って取ってから世代を変え、forget をその中で打つ
  • 契約: locations.json の relay-account-store、ndf-files.json の relay-usage-fetch、limits.json の relay.usage-fetch・relay.usage-http・relay.oauth-refresh・relay.token-margin

実装の中で決めたこと

  • forget の 4 つ目の引数は U4 の前例どおり drop(消す世代)のまま。 取得の記録も drop の世代のファイルだけを消し、ほかの世代のファイルが残らなければ .usage-fetch/<名前>/ を消す。取得の排他の錠(.fetch-locks/<名前>.lock)は消さない
  • 登録・削除が取得の排他を待つ上限は accounts.fetch_wait()(relay.usage-http × 2 + relay.oauth-refresh + claude-accounts.lock × 4 = 143 秒)。取れなければ AccountLockTimeout(store_in_use)で 使用率の取得が終わらない。少し待ってから打ち直す と止まり、何も変えない。形の違う名前は排他を取らずに通し、名前の検査は今の操作に任せる
  • write_fetch は at を前の値のまま残す。 at を書くのは fetch_usage(後半)だけ
  • relay.usage-fetch・relay.token-margin は今のコードからまだ読まない(fetch_usage と U9 の _queue_fetch が読む)。単位の範囲として足した
  • limits.json の 2 つの summary は設計の文の「宛先」を「API」に替えた。 ndf check の禁止語(「宛先」は「マージ先」の意味で廃止)に当たるため
  • 新しいテストは tests/domains/relay/test_relay_usage_fetch.py に置いた(test_relay_parts.py は 811 行で、足すと 1,000 行の上限に近づく。U4 の前例と同じ並び)。CLI の排他のテストは test_relay_cli.py に足した
  • 差分の行数(git diff --shortstat origin/sprint/3604-3864-relay-accounts...HEAD -- . ':(exclude)**/uv.lock' ':(exclude)plugins/ndf/docs/contracts/env.md'): 9 files changed, 414 insertions(+), 23 deletions(-)

テスト

テストは CI で走らせる(.ndf/project.json の test.ci.only)。先に push したテストだけのコミット: f6ee587

関連: #3604 #3864

🤖 Generated with Claude Code

https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP

takemi-ohama and others added 7 commits November 22, 2026 00:40
fetch_path・fetch_lock_path・fetch_lock・read_windows・write_fetch・due・FetchGate を足し、usages が
取得の記録を読み、forget が取得の記録を消すようにした。契約に relay-usage-fetch・relay-account-store と
上限の値 4 つを足した。fetch_usage・_refresh・_read_auth・_refresh_lock は起動の前の確かめ(U2・U3)の部品を
使うため、この PR には入れていない。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP
経路の判定で removing を見た結果を捨てて読み直すと、間に別の端末が残りを片付けて
同じ名前で登録し直したとき、打ち直しの削除が新しい登録をログアウトして外していた。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
最初の確認で登録も残りも見えず、排他の下の見直しで登録だけが見えたときは、
待つ間にほかの端末の account add が登録したものとして store_in_use で止まり、
打ち直しを案内する。OAuth の削除へ回すのは残りが見えたときだけ(r4-1)。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@takemi-ohama

Copy link
Copy Markdown
Contributor Author

cross-review の記録(PR #4038)

終わり方: ラウンドの上限で止まった。ラウンド 4・指摘 6(直した 5・見送った 1・未解決 0)

ラウンドと修正

ラウンド レビューした head 範囲 判定 修正のコミット 送った 直した指摘
1 723d8176f full changes_required 763c93c4e 送った r1-1・r1-2
2 763c93c4e since changes_required 5072ce448 送った r2-1
3 5072ce448 since changes_required 54469563e 送った r3-1
4 54469563e since changes_required 593b0bcd0 送った r4-1

指摘

番号 担当 重要度 場所 指摘 終わり方 見送った理由
r1-1 codex critical plugins/ndf/src/ndf/domains/relay/cli_account.py:185 削除の再試行が、同じ名前で再登録された現在の認証情報を消すことがあります。前回の削除の残りがある状態で _fetching を待っている間に、先行コマンドが残りを片付けると、remove_account が初めて removing を読む時点では偽になります。その結果、残りの掃除を意図した再試行が、現在の登録のログアウトと削除に進みます。取得の排他を待つ前に残りを観測し、その呼び出しは排他取得後も残りの掃除だけを行うようにしてください。 直した —
r1-2 codex major plugins/ndf/src/ndf/domains/relay/accounts.py:238 usages は同じ取得記録をアカウントごとに二度開いて JSON を解析します。書き手がその間に記録を置き換えると、差し替え前の使用率と差し替え後の spend_limit_reached を組み合わせ、上限に達したアカウントを利用可能と判定する場合があります。取得記録を一度だけ読み、同じ内容から窓と上限フラグを取り出してください。 直した —
r1-3 codex major plugins/ndf/tests/domains/relay/test_relay_usage_fetch.py:3 計画の Task 9(U5b)は使用率の取得とトークン更新を受け入れ条件に含めていますが、この差分には fetch_usage と _refresh がなく、取得を試す前の at の保存も、資格情報の照合と更新も実行できません。テストの冒頭には後続実装とありますが、計画では U9 がこの処理を使う構成です。Task 9 で取得・更新の経路を実装するか、分割する場合は後続 PR の担当範囲と受け入れ条件、U9 の依存先を計画に明記してください。 見送った 基準 4(計画と実装の食い違い)には当たるが、この起動では直せないため見送る。(1) 実装の側: fetch_usage・_refresh・_refresh_lock・_read_auth は、詳細設計書の「取得の手順と排他」のとおり U2 の check_local・Local・mark_relogin と U3 の pin_dir・apply_pending・replace_auth・write_pending・in_use・refresh_lock を使う。これらはスプリントブランチ sprint/3604-3864-relay-accounts に無い(2026-11-22 に git grep で確認。U2 は PR 4027 #4027 が未マージ、U3 は未着手)ので、この PR では実装できない。(2) 計画の側: issues/issue-3604-3864-plan.md は承認済みの設計の文書として読み取り専用(-r--r--r--)にされており、この起動では書き換えない。計画の変更は supervisor の判断を受けて入れる。supervisor への計画の修正案(書き先: issues/issue-3604-3864-plan.md): [修正対象の表 accounts.py の行] 「取得の記録・取得の排他・取り直しの判定は U5b、取得の手順とトークンの更新(fetch_usage・_refresh・_refresh_lock・_read_auth)は U5c」、単位の列を U4・U5b・U5c にする。[Task 9] 題を「(U5b・U5c)」にし、2 つに分ける。U5b(U4・U5a の後): fetch_path・fetch_lock_path・fetch_lock・fetch_wait・read_windows・write_fetch・due・FetchGate、usages による取得の記録の読み、forget による取得の記録の削除、cli_account の登録・削除を取得の排他の中で行うこと。at は書かない。受け入れ条件は決定 4(記録の場所・窓の合わせ方・spend_limit_reached・取り直しの判定)と I16(取得の排他)。U5c(U3・U5b の後): fetch_usage・_refresh・_refresh_lock・_read_auth、取得を試す前の at の保存、資格情報の照合と更新、relay.usage-fetch・relay.token-margin を読み始めること。受け入れ条件は決定 4(取得)と決定 4・I16(トークンの更新)。[レビューの単位の表] 「U5c 取得の手順とトークンの更新 | Task 9 | (決定 4・I16) | 約 300」の行を足し、番号を持たない単位の列挙に U5c を加える。[依存の図] 「U5b --> U9」を「U3 --> U5c」「U5b --> U5c --> U9」に替える。[順序の表] U9 の前に「U5c | U3・U5b | 取得の手順は U2・U3 の部品と U5b の記録・排他を使う」を足し、U9 の先に要る単位を「U8・U5c」にして、以降の番号を 1 つずつ繰り下げる。PR の本文にはすでに「この PR は U5b の前半」と書かれている。
r2-1 codex major plugins/ndf/src/ndf/domains/relay/cli_account.py:186 _acc_remove は OAuth の削除経路を選ぶときに removing を確認し、その結果を捨てて seen を読み直します。登録がなく削除の残りだけがある状態で最初の確認が True を返し、別端末が残りを片付けて同名で再登録した後に読み直すと、seen=False になり、打ち直した削除が新しい登録をログアウトして消します。経路の判定前に removing を一度確認し、その結果を判定と remove_account の両方で使ってください。 直した —
r3-1 codex major plugins/ndf/src/ndf/domains/relay/cli_account.py:176 同じ OAuth 名を別端末でも削除していると、removing() が偽を返した直後に別端末が登録ディレクトリを .removing に移し、続く names() にも対象が出ない場合があります。この順序では、別端末の削除が失敗して残りがある場合でも、API キーの削除へ進み「登録されていない」と返ります。最初に seen=True を観測した場合はその値を保持し、OAuth の登録と残りの両方が見つからなかった場合は、取得の排他と登録の排他の下で再確認してから削除対象を振り分けてください。 直した —
r4-1 codex major plugins/ndf/src/ndf/domains/relay/cli_account.py:182 最初の確認で OAuth 登録も削除の残りも見えなかった場合に、排他待ちの間に作られた同名の OAuth 登録をログアウトして削除します。例えば、別端末が account add work1 --code ... で認証中に account remove work1 を実行すると、追加が確定して排他が解かれた直後に再確認が oauth=True、seen=False となり、新しい資格情報を消します。この分岐で OAuth に切り替える条件は削除の残りを確認できた場合に限り、待機中に同名登録が現れた場合は削除せず再実行を案内してください。 直した —

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