Repository navigation
U4 使用率のキャッシュと status line の記録(#3604 #3864) - #4028
Conversation
U4(実装計画の Task 6・7)。受け入れ条件 3864:1・2・3・6(外した間の解除)・11 と不変条件 I6・I7・I8・I11 を縛る。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP
U4(実装計画の Task 6・7)。accounts に世代ごとの使用率のキャッシュ(usage/<名前>/<世代>.json)の書き込みと読み取り、 held.json の外した間、limited.json の上限の観測、limit_until、forget を足す。一覧は今の世代のキャッシュを読み、 account use は外した間を解き、登録・削除は旧い世代の記録を消す。status line は NDF_ACCOUNT_USAGE_FILE へ 有効な 5 時間・7 日の窓だけを窓ごとに合わせて書く。ラッパーの今の呼び手のため、旧い 1 つのキャッシュの読み書きは 引数を省いた形で残す(U9 で消す)。新しいテストは行数の安全網のため test_relay_usage_cache.py へ移した。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP
「公開インタフェース」と「データ」の行の usage.json を、アカウントごと・世代ごとのキャッシュ usage/<名前>/<世代>.json と 登録簿の側の取得の記録 .usage-fetch/<名前>/<世代>.json にする(設計の「入出力のコントラクト」の「使用率のキャッシュ」)。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP
… cross-review) - 登録のたびに新しい世代(secrets.token_hex(16))を account.json へ書き、前の世代の記録の後始末(forget)を登録・削除と同じ登録の排他の中で打つ。forget は操作した登録簿の前の世代だけを消す - 世代と名前を 1 つの安全なパスの要素に限ってからキャッシュのパスを組む - 登録・削除・指定の後始末の失敗は、成功の結果の警告に分ける - キャッシュの錠を <ファイル>.lock の flock にし、status line と write_usage で共用する(残骸の取り直しを外す) - status line は 1 回の jq で入力の窓と前の記録を比べ、変わるときだけ錠を取って mktemp の一時ファイルから置き換える - 一覧は account.json を 1 回だけ読み、その世代で使用率を引く - 上限の観測は、until 以下の窓が遅れて届いても解かない Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
| now=${EPOCHSECONDS:-$(date +%s)} | ||
| # 錠の外で 1 回比べ、変わるときだけ錠を取って読み直す | ||
| [ -n "$(usage_merged "$f")" ] || return 0 | ||
| command -v flock >/dev/null 2>&1 || return 0 |
There was a problem hiding this comment.
cross-review の指摘 r2-1(codex・ラウンド 2・major)
標準の macOS には flock コマンドがなく、この分岐で status line の使用率記録が毎回スキップされます。変更前のディレクトリ錠は macOS でも使えました。シェルと Python が同じ錠を使える方式にそろえ、flock コマンドが無い環境でもキャッシュを更新できることを確認してください。
| 登録簿の側の取得の記録(`store` の `.usage-fetch/<名前>/`)を消すのは、取得の記録を足す単位(U5b)で入れる。 | ||
| 錠を取れなければ `TimeoutError`、消せなければ `OSError`。 | ||
| """ | ||
| key = _gen(drop) |
There was a problem hiding this comment.
cross-review の指摘 r2-2(codex・ラウンド 2・major)
状態の保存先を共有する別々の登録簿に、世代を持たない旧登録が同じ名前で残っていると、両方が _.json と同じ外し・上限の記録を使います。一方の再登録や削除で forget が走ると、もう一方の使用率や認証失敗による除外も消えます。旧登録にも登録簿ごとに区別できる識別子を割り当て、読み書きと削除の対象を分けてください。
| gone: Optional[str] = generation(store, name) | ||
| except AccountError: # 壊れた登録は世代が分からないので後始末をしない | ||
| gone = None | ||
| shutil.rmtree(account_dir(store, name), ignore_errors=True) |
There was a problem hiding this comment.
cross-review の指摘 r2-3(codex・ラウンド 2・major)
unregister は登録ディレクトリの削除エラーを握りつぶしたまま settle を呼びます。削除に失敗して登録が残っていても、その登録の使用率・外した間・上限の記録を消し、CLI は登録を外したと返します。登録が実際に消えたことを確認してから settle を呼び、削除できなかった場合は失敗を返してください。
cross-review の記録(PR #4028)終わり方: ラウンドの上限で止まった。ラウンド 7・指摘 25(直した 19・見送った 6・未解決 0) ラウンドと修正
指摘
注意
|
…8 の cross-review の 2 回目) - status line は flock のコマンドが無い環境(標準の macOS)で perl の flock を使い、Python の fcntl.flock と同じ <ファイル>.lock の flock(2) を取る - 前の形式(mkdir の空のディレクトリ)の錠が残っていれば、status line・write_usage・forget が外してから使う - 世代を持たない旧い登録に、登録簿の実パスと名前から作る legacy-<32 桁> の世代を割り当て、状態の保存先を共有する別の登録簿の記録と分ける - unregister は登録のディレクトリが消えたことを確かめてから後始末を呼び、残れば OSError で止める(CLI は失敗を返す) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
PR 4028 の cross-review の 4 回目) - 詳細設計: 世代を持たない旧い登録の世代は legacy_generation(登録簿の realpath と名前の sha256)で、読み書きはすべて account_registry.generation か load().generation で得ると明記する(空文字は登録の無いときだけ) - status line と write_usage: mkdir の錠はこの PR の途中のコミットにしか無く出していないので、移行の rmdir を外す。 錠の場所がディレクトリなら消さずにその回は書かない。status line の錠のエラーが表示へ漏れないようリダイレクトの順を直す - unregister: 登録のディレクトリを .removing/<名前>/<世代> へ移して一覧から外し、その世代の後始末の後に中身を消す。 消え残っても同じ account remove の打ち直しで、残った世代ごとの後始末と削除をやり直す Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… 回目) account remove の打ち直しは、排他の外で登録が無いと確かめた後に unregister を呼んでいた。 その間に別の端末が同じ名前で登録し直すと、新しい登録を .removing へ移して認証情報と設定を消していた。 残った世代の後始末と削除だけを登録の排他の中で行う finish_removal を分け、打ち直しはそれを呼ぶ。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…cross-review の 6 回目) - r6-1: 削除の残りと今の登録が共存するとき、打ち直しは残りだけを消し、今の登録は警告で知らせて残す。外すのは残りが無くなった後の削除 - r6-2: 世代の確認・symlink の切り離し・ログアウト・登録の取り外しを account_registry.remove_account の 1 つの排他の中で行い、 ログアウトの間の登録し直しを待たせる(新しい認証情報へのログアウトと新しい世代の削除を起こさない) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP
0848017
into
sprint/3604-3864-relay-accounts
概要
実装の単位 U4「使用率のキャッシュと status line の記録」(実装計画の Task 6・7)。
accounts.py: アカウントごと・登録の世代ごとの使用率のキャッシュ(usage/<名前>/<世代>.json)の書き込みと読み取り、認証の失敗で外した間(held.json)、上限の観測(limited.json)、登録・削除の後のforgetcli_account.py: 一覧が今の世代のキャッシュを読む・account useが外した間を解く・登録と削除が旧い世代の記録を消すstatusline.sh:record_usage(子の環境のNDF_ACCOUNT_USAGE_FILEへ有効な 5 時間・7 日の窓だけを書く)ndf-files.jsonのrelay-usage(変更)・relay-auth-held・relay-limit-seen、limits.jsonのrelay.auth-hold・relay.limit-unknown要求仕様の直し:
issues/issue-3864-requirements.mdの「影響」の表の「公開インタフェース」と「データ」の 2 行を、usage.jsonから設計で決めた形(<状態の保存先>/relay/accounts/の下のusage/<名前>/<世代>.json(書き手は status line)と、<アカウントの登録簿>/の下の取得の記録.usage-fetch/<名前>/<世代>.json(書き手は使用率の API の取得))へ直し、課題 #3864 の本文も同じ中身に直した(gh issue edit 3864 --body-file。読み戻した本文はコピーと末尾の改行 1 つだけが違う)。満たす受け入れ条件: 3864:1・3864:2・3864:3・3864:6(外した間の解除)・3864:11(読めないファイル・status line)・I6・I7・I8・I11
実装の中で決めたこと
wrapper.pyの_limit_pick・_on_switch)はaccounts.usages(state_dir)・accounts.usage_path(state_dir)を、ラッパーのテストはaccounts.write_usagesを呼ぶ。wrapper.pyはこの単位の範囲の外(U7a が並行で触る)なので、usagesのstore・now・generationsとusage_pathのnameを省けば旧いusage.jsonを読み書きする形にとどめ、write_usagesも残した。ラッパーが新しい形へ移る単位(U9)で消すusagesはaccount_decide.Usageの今の 3 つの項目(名前・使用率・上限)で返す。 5 時間・7 日の使用率と 7 日のリセットの時刻を足す型の変更は U6 のため。使用率の分からない上限の行はpercentを None にした(list_rowsは None を受ける)usagesはまだ取得の記録(fetch_path)を読まない。storeは引数に持ち、読むのは U5b。forgetも登録簿の側の.usage-fetch/<名前>/は消さず(U5b)、取得の排他(fetch_lock。U5b)の外で打つsee_limitは(state_dir, name, generation, seen_at, limit)にした。 設計のシグネチャは 7 つの引数で PLR0913 に当たるため、until・window・window_resets_atをlimit_untilの返りの組limit1 つで受けるhold・see_limit・unholdは錠を取れなければTimeoutError(OSError)を送出する。 呼び手(U10 の_auth_pick)が書けないときと同じ扱いで続けられるようにresets 3pm・resets 12:30pm (Asia/Tokyo)の形を読む。 括弧の時間帯が読めればそれを、無ければ引数のtzを使う。手元の上限の画面での形の確かめはしていない(形が違えば (2) 以降で決まる)tests/domains/relay/test_relay_usage_cache.pyに置いた。 計画はtest_relay_parts.pyだが、足すと 1,038 行になりndf checkの行数の安全網(1,000 行)に当たるためgit diff --shortstat origin/sprint/3604-3864-relay-accounts...HEAD -- . ':(exclude)**/uv.lock' ':(exclude)plugins/ndf/docs/contracts/env.md'): 11 files changed, 855 insertions(+), 21 deletions(-)(見込みの約 400 行を超えた。うちテストが約 470 行)テスト
テストは CI で走らせる(
.ndf/project.jsonのtest.ci.only)。先に push したテストだけのコミット: d8e688b関連: #3604 #3864
🤖 Generated with Claude Code
https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP