Skip to content

U4 使用率のキャッシュと status line の記録(#3604 #3864) - #4028

Merged
takemi-ohama merged 11 commits into
sprint/3604-3864-relay-accountsfrom
impl/3604-u4-usage-cache
Nov 22, 2026
Merged

takemi-ohama merged 11 commits into
sprint/3604-3864-relay-accountsfrom
impl/3604-u4-usage-cache

Conversation

@takemi-ohama

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

Copy link
Copy Markdown
Contributor

概要

実装の単位 U4「使用率のキャッシュと status line の記録」(実装計画の Task 6・7)。

  • accounts.py: アカウントごと・登録の世代ごとの使用率のキャッシュ(usage/<名前>/<世代>.json)の書き込みと読み取り、認証の失敗で外した間(held.json)、上限の観測(limited.json)、登録・削除の後の forget
  • cli_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

実装の中で決めたこと

  • 旧い 1 つのキャッシュを引数を省いた形で残した。 ラッパー(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 の返りの組 limit 1 つで受ける
  • 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

takemi-ohama and others added 4 commits November 21, 2026 22:50
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

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 の指摘 r2-1(codex・ラウンド 2・major)

標準の macOS には flock コマンドがなく、この分岐で status line の使用率記録が毎回スキップされます。変更前のディレクトリ錠は macOS でも使えました。シェルと Python が同じ錠を使える方式にそろえ、flock コマンドが無い環境でもキャッシュを更新できることを確認してください。

登録簿の側の取得の記録(`store` の `.usage-fetch/<名前>/`)を消すのは、取得の記録を足す単位(U5b)で入れる。
錠を取れなければ `TimeoutError`、消せなければ `OSError`。
"""
key = _gen(drop)

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 の指摘 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)

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 の指摘 r2-3(codex・ラウンド 2・major)

unregister は登録ディレクトリの削除エラーを握りつぶしたまま settle を呼びます。削除に失敗して登録が残っていても、その登録の使用率・外した間・上限の記録を消し、CLI は登録を外したと返します。登録が実際に消えたことを確認してから settle を呼び、削除できなかった場合は失敗を返してください。

@takemi-ohama

takemi-ohama commented Nov 21, 2026 •

Copy link
Copy Markdown
Contributor Author

cross-review の記録(PR #4028)

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

ラウンドと修正

ラウンド レビューした head 範囲 判定 修正のコミット 送った 直した指摘
1 8b0537595 full changes_required 94e9cb6b4 送った r1-1・r1-3・r1-4・r1-5・r1-6・r1-7・r1-8・r1-9・r1-10
2 94e9cb6b4 since errored — — —
3 94e9cb6b4 since changes_required d1b8d7054 送った r2-1・r2-2・r2-3
4 d1b8d7054 since changes_required ff15acad1 送った r4-1・r4-2・r4-3
5 ff15acad1 since changes_required 29d136118 送った r5-1
6 29d136118 since changes_required b74accedf 送った r6-1・r6-2
7 b74accedf since changes_required 7db2b44a4 送った r7-1

指摘

番号 担当 重要度 場所 指摘 終わり方 見送った理由
r1-1 codex major plugins/ndf/src/ndf/domains/relay/cli_account.py:66 登録成功後に generation() を読み直していますが、実際の account_registry.register() は account.json に generation を書きません。初回登録と同名での再登録がともに _ になり、forget() は再登録前の使用率・認証保留・上限を現行の記録として残します。再登録前の子の遅延書き込みも現行の記録に入ります。登録処理の排他内で毎回新しい世代を発行して保存し、実際の登録処理を通す再登録テストで確認してください。 直した account_registry.register が登録の排他の中で毎回 secrets.token_hex(16) の世代を account.json へ書き、同じ排他の中で前の世代を forget する。実際の register を通す同名の再登録のテスト(test_i8_add_and_remove_forget_the_old_generation)で、世代が変わり、前の世代の遅れた書き込みが今の記録にならないことを確かめた
r1-2 codex major plugins/ndf/src/ndf/domains/statusline/statusline.sh:11 通常の起動経路に新しいキャッシュの書き先が配線されていません。session_env.account_env() は書き先を設定できますが、製品コードに呼び出し元がなく、現行の wrapper は child_env() だけを呼び、上限判定も旧 usage.json を読み続けます。この差分の account list が読む新しいファイルは通常の中継から生成されません。登録済みアカウントの子への書き先の受け渡しと、その子から一覧までの確認を含めてください。配線を後続単位に置くなら、利用可能になる受け入れ条件もその単位に移してください。 見送った 子へ書き先を渡す配線は wrapper.py の _launch_target(計画の U8・Task 13)の範囲で、wrapper.py は U4 の外(U7a が並行で触る)。この PR の目的の外なので、後続の単位で入る予定のまま起票しない。受け入れ条件の移し替えは承認済みの計画 issues/issue-3604-3864-plan.md(読み取り専用)の変更で、この起動では書けない。呼び出し元への案: (1) 計画の U4 の行と Task 7 の『満たす受け入れ条件』から 3864:1・3864:2 の通し(子への受け渡しから一覧まで)を外して U8 の行と Task 13 へ移す。(2) PR 4028 の本文の『満たす受け入れ条件』を『3864:1・3864:2 は書き手(status line)と読み手(usages・一覧)の部分。子への NDF_ACCOUNT_USAGE_FILE の受け渡しと通しの確かめは U8』に直す
r1-3 codex major plugins/ndf/src/ndf/domains/relay/accounts.py:61 キャッシュのパス構築に、account.json から読んだ任意の文字列の世代を直接使っています。絶対パスや ../ を含む世代で、一覧がキャッシュ領域外の JSON を読みます。また usage_path() の名前検査には .. も通ります。登録名の検査を再利用し、世代を単一の安全なパス要素に限定してから、読み取り・書き込み・削除のパスを組み立ててください。 直した usage_path の名前の検査を account_registry.valid_name(fullmatch)に替え、世代を GEN_RE(. と / を含まない 1 つの要素)に限る。account.json の世代がその形でなければ壊れた登録(AccountError)として扱う
r1-4 codex major plugins/ndf/src/ndf/domains/relay/accounts.py:406 forget() は登録簿の排他が解けた後に呼ばれ、アカウント名以下をまとめて削除します。削除直後に別プロセスが同名を登録して現行世代の記録を書いた場合、遅れて実行された forget(..., None) がその記録まで消します。また NDF_ACCOUNTS_DIR だけを変えて状態保存先を共有する二つの登録簿では、一方の登録・削除が他方の同名アカウントの記録を消します。登録の更新と後始末を同じ排他の範囲に置き、削除対象を操作した登録簿の世代に限定してください。 直した forget を register・unregister の settle として登録の排他の中で打ち、消すのは操作した登録簿の前の世代(削除なら外した世代)だけにした。承認済みの issues/issue-3604-3864-design-detail.md は読み取り専用(444)のため、この起動では設計を書き換えていない。呼び出し元への案: 詳細設計の『登録(account add)』『削除(account remove)』『forget』『世代ごとの項目』の行を、forget(state_dir, store, name, drop: str) と登録の排他の中で打つ形に直す
r1-5 codex major plugins/ndf/src/ndf/domains/relay/accounts.py:287 記録の排他や削除に失敗すると、account use は指定を保存した後に失敗し、account add と account remove は認証情報の登録・削除が完了した後に失敗結果を返します。利用者が失敗結果を見て再実行すると、すでに済んだ認証操作を繰り返すことになります。書き換え前に必要な排他を確保するか、確定した認証操作と後始末の失敗を結果で区別できるようにしてください。 直した add・remove・use は、確定した操作の後の後始末(forget・unhold)の錠の待ちきれない・消せない失敗を、成功の結果の warnings の 1 行に分ける(add・remove には『打ち直さない』を添える)。承認済みの issues/issue-3604-3864-design-detail.md は読み取り専用(444)のため、この起動では設計を書き換えていない。呼び出し元への案: 詳細設計の登録・削除の行にこの扱いを足す
r1-6 codex major plugins/ndf/src/ndf/domains/statusline/statusline.sh:13 status line は有効な窓があるたび、値が前回と同じでも date、jq 3 回、dirname、mkdir 2 回、rmdir を表示処理の前に起動します。更新がない通常の再描画にも外部コマンド 8 回が増え、同じアカウントで開いたセッション数に応じて積み上がります。既存の入力解析と窓の抽出をまとめ、更新が必要な場合だけ排他と書き込みへ進む構造にしてください。 直した record_usage は入力の解析・窓の取り出し・前の記録との比べを 1 回の jq にまとめた。値が同じ再描画は jq の 1 回だけで終え、変わるときだけ錠を取って読み直す(date は EPOCHSECONDS が無いときだけ)。起動するコマンドを数えるテスト(test_an_unchanged_redraw_starts_only_jq)を足した。承認済みの issues/issue-3604-3864-design-detail.md は読み取り専用(444)のため、この起動では設計を書き換えていない。
r1-7 codex major plugins/ndf/src/ndf/domains/statusline/statusline.sh:41 一時ファイル $f.$$ を予測可能な名前で開き、既存ファイルを切り詰めます。キャッシュの親が他のプロセスから書ける構成では、同名のシンボリックリンクを置かれると、ステータスラインの権限でリンク先の利用者ファイルを上書きします。同じディレクトリに排他的に作成した一時ファイルへ書き、置き換えてください。 直した 一時ファイルは同じディレクトリに mktemp で排他的に作ってから mv -f で置き換える。承認済みの issues/issue-3604-3864-design-detail.md は読み取り専用(444)のため、この起動では設計を書き換えていない。呼び出し元への案: 詳細設計の record_usage の行の『<ファイル>.$$ への書き込み』を mktemp に直す
r1-8 codex major plugins/ndf/src/ndf/domains/statusline/statusline.sh:25 古い錠を取り直す処理は、更新時刻を読んだディレクトリと削除するディレクトリが同じかを保証しません。同じ残骸を二つのセッションが見た場合、後から処理した側が先に取り直した側の新しい錠を削除でき、両者が同時に古い値を読んで、新しい使用率を低い値で上書きできます。シェルと Python で、保持中の錠を他の書き手が奪えない排他方式を共用してください。 直した 錠を <ファイル>.lock の flock にし、status line(flock -n)と write_usage(signals.held を待たずに)で共用した。残骸の取り直しは外したので、オーナーが生きている間はほかの書き手が奪えない。flock が無い環境では書かない。両側のテストを足した。承認済みの issues/issue-3604-3864-design-detail.md は読み取り専用(444)のため、この起動では設計を書き換えていない。呼び出し元への案: 詳細設計の『書き込みの規則』と排他の表の『<ファイル>.lock のディレクトリ・10 秒の残骸』を flock の形に直す
r1-9 codex major plugins/ndf/src/ndf/domains/relay/cli_account.py:116 account list は _generations() で登録簿を列挙して各 account.json を読み、list_rows() でも同じ列挙と読み込みを行います。処理回数が増えるうえ、二度の読み込みの間に再登録されると、新しいメールアドレスの行に古い世代の使用率を表示できます。一度読み込んだ登録情報から行と世代を組み立ててください。 直した list_rows は account.json を 1 回だけ読み、読めた登録の名前と世代で使用率を引く呼び出しを受ける。cli_account の _generations を外した
r1-10 codex major plugins/ndf/src/ndf/domains/relay/accounts.py:346 詳細設計の「解除」は、観測時の window_resets_at より新しい窓なら解除すると定めていますが、直後の「古い記録・遅れて届いた入力」は、resets_at が until 以下なら解除しないと読めます。観測時のキャッシュが古く、遅れて届いた 100% 未満の窓が観測時の値より新しく until 以下なら、現実装は解除し、後者に従う実装は保留します。この入力に対する判断を一つに決め、設計とテストに反映してください。 直した 『古い記録・遅れて届いた入力』の行に合わせた。観測の窓がキャッシュで window_resets_at と until のどちらよりも後の 100 未満の窓に替わったときだけ解く。観測時のキャッシュが古く、until 以下の窓が遅れて届く入力のテストを足した。承認済みの issues/issue-3604-3864-design-detail.md は読み取り専用(444)のため、この起動では設計を書き換えていない。呼び出し元への案: 詳細設計の『上限の観測』の『解除』の行を『キャッシュの同じ名前の窓の resets_at が window_resets_at と until のどちらよりも後で、その窓の使用率が 100 未満のときだけ』に直し、『推定の until とは比べない』を『窓を特定した (1)〜(3) の until は推定でないので比べる』に替える
r2-1 codex major plugins/ndf/src/ndf/domains/statusline/statusline.sh:36 標準の macOS には flock コマンドがなく、この分岐で status line の使用率記録が毎回スキップされます。変更前のディレクトリ錠は macOS でも使えました。シェルと Python が同じ錠を使える方式にそろえ、flock コマンドが無い環境でもキャッシュを更新できることを確認してください。 直した —
r2-2 codex major plugins/ndf/src/ndf/domains/relay/accounts.py:390 状態の保存先を共有する別々の登録簿に、世代を持たない旧登録が同じ名前で残っていると、両方が _.json と同じ外し・上限の記録を使います。一方の再登録や削除で forget が走ると、もう一方の使用率や認証失敗による除外も消えます。旧登録にも登録簿ごとに区別できる識別子を割り当て、読み書きと削除の対象を分けてください。 直した —
r2-3 codex major plugins/ndf/src/ndf/domains/relay/account_registry.py:406 unregister は登録ディレクトリの削除エラーを握りつぶしたまま settle を呼びます。削除に失敗して登録が残っていても、その登録の使用率・外した間・上限の記録を消し、CLI は登録を外したと返します。登録が実際に消えたことを確認してから settle を呼び、削除できなかった場合は失敗を返してください。 直した —
r2-4 codex major issues/issue-3604-3864-design-detail.md:522 詳細設計は同じ <ファイル>.lock を mkdir で作るディレクトリと定めていますが、この差分は flock 用のファイルに変えています。設計を見て後続の書き手を実装すると、同じ場所にファイルとディレクトリを要求するため、先にできた錠の形によって片方が書けなくなります。設計と実装で錠の形式をそろえ、旧形式の錠が残っている場合の移行手順も定めてください。 見送った 基準 4 に当たる。実装の側は d1b8d70 で直した(錠は <ファイル>.lock のファイルの flock(2) に統一し、status line は flock か perl、Python は fcntl.flock で同じ錠を取る。前の形式の mkdir の空のディレクトリは、status line・write_usage・forget が rmdir してから使う。前の形式は PR 4028 の途中の版だけが作り、配布していない)。issues/issue-3604-3864-design-detail.md はこの作業ツリーで読み取り専用(-r--r--r--。設計の文書 6 件だけがそうなっており、承認済みの設計の凍結と判断)なので、権限を外して書き換えず、呼び出し元へ返す。直す文案: /tmp/claude-1000/-work-ai-plugins/3e089ab0-c2d6-4982-9aff-d66726c73bcc/scratchpad/impl-3604/cr-u4/doc/design-detail.patch の差分(「書き込みの規則」の錠の段落を flock(2)・perl の代わり・前の形式の移行の手順へ、「並行と排他」の status line の行をファイルの flock へ、usage_path の行に旧い登録の legacy 世代を足す)。この差分を設計へ当てる承認を求める
r2-5 codex major issues/issue-3604-3864-design-detail.md:514 上限の解除規則が詳細設計の表の中で食い違っています。「解除」は until と比べないと明記していますが、直後の行と今回の実装では resets_at が until 以下なら解除しません。window_resets_at < resets_at <= until の 100% 未満の窓に対して、実装者が選ぶ行によって解除の結果が変わります。解除条件を一つに統一し、この境界での期待結果を明記してください。 見送った 基準 4 に当たる。実装(accounts.limits_seen の resets_at > max(window_resets_at, until) と test_relay_usage_cache.py の遅れた入力のテスト)は「古い記録・遅れて届いた入力」の行と同じで、変えない。食い違いは設計の「解除」の行にだけある。issues/issue-3604-3864-design-detail.md はこの作業ツリーで読み取り専用(-r--r--r--。設計の文書 6 件だけがそうなっており、承認済みの設計の凍結と判断)なので、権限を外して書き換えず、呼び出し元へ返す。直す文案: /tmp/claude-1000/-work-ai-plugins/3e089ab0-c2d6-4982-9aff-d66726c73bcc/scratchpad/impl-3604/cr-u4/doc/design-detail.patch の「解除」の行(比べを resets_at > max(window_resets_at, until) に統一し、境界 window_resets_at < resets_at ≤ until で 100% 未満の窓は解かない・resets_at > until で 100% 未満なら解く、と明記する)
r4-1 codex major issues/issue-3604-3864-design-detail.md:246 世代を持たない旧登録について、詳細設計は空文字を返すと定めていますが、実装は登録簿の実パスと名前から legacy-… を返します。後続の取得側が設計どおり空文字を使うと、同じ登録の取得記録が _.json と legacy-….json に分かれ、前回の取得を共有できず API を重複して呼び得ます。旧登録の世代の決め方と、読み書きに使う共通の関数を詳細設計に明記してください。 直した —
r4-2 codex major plugins/ndf/src/ndf/domains/statusline/statusline.sh:42 旧形式の空ディレクトリは、残骸と書き込み中の錠が同じ形です。この差分は見つけ次第 rmdir するため、更新時に旧 status line がまだ書き込み中でも新しい書き手が進み、旧側が後から置き換えて使用率を古い値に戻せます。Python 側の _drop_old_lock も同じ動作です。旧形式の書き手が終了したことを確認できる移行手順にし、両方の書き手から無条件の削除を外してください。 直した —
r4-3 codex major plugins/ndf/src/ndf/domains/relay/account_registry.py:422 account remove はログアウトと共有項目のリンク解除を済ませてから rmtree を実行します。rmtree が account.json を消した後で別の項目の削除に失敗すると、この分岐は「登録は残っている」と返して世代の後始末を飛ばします。実際には一覧から消えており、同じ削除コマンドを再実行しても OAuth 登録の後始末に戻れません。登録を外す操作と残存ファイルの削除を分け、部分削除が起きても対象の世代を保持して後始末を再試行できるようにしてください。 直した —
r5-1 codex major plugins/ndf/src/ndf/domains/relay/cli_account.py:169 削除の再試行では、登録が無いことを排他の外で確認した後、現在の登録も削除する unregister() を呼びます。その間に別の端末で同じ名前の再登録が完了すると、再試行が新しい登録を .removing に移し、認証情報と設定を削除します。再試行では残留ディレクトリだけを処理し、現在の登録に触れないようにしてください。 直した —
r5-2 codex major issues/issue-3604-3864-design-detail.md:410 登録の世代の表では generation の無い旧い登録に legacy-… を割り当てますが、関数仕様の generation() はフィールドが無ければ空文字を返すと定めています。後続の書き手が関数仕様に従うと _.json に書き、一覧は同じ登録の legacy-….json を読むため、使用率が反映されません。関数仕様でも旧い登録と未登録の戻り値を区別してください。 見送った 基準 4(設計の文書の食い違いで、実装する人が違うものを作る)に当たり、直す必要がある。ただし issues/issue-3604-3864-design-detail.md は、issues/ の issue-3604・3864 の文書 6 件とともに読み取り専用(-r--r--r--)になっていた。NDF のコードにはこの属性を付ける処理が無く、誰かが意図して保護した可能性があるため、保護を外さずに見送った。修正の差分は /tmp/claude-1000/-work-ai-plugins/3e089ab0-c2d6-4982-9aff-d66726c73bcc/scratchpad/impl-3604/cr-u4/design-detail-r5.patch に置いた(git apply --check は通る)。410 行目の generation の記述を「generation を返し、無い旧い登録には legacy_generation(legacy-…)を返す。空文字は登録が無いときだけ。形が違えば AccountError」に書き直す。実装の generation() は既にこの規則で動いている
r5-3 codex major issues/issue-3604-3864-design-detail.md:448 削除の仕様は残った登録の世代ごとに後始末を再試行しますが、同じ設計の forget は keep=None で名前配下の全世代を消す契約です。この契約で実装すると、状態の保存先を共有する別の登録簿に同名のアカウントがある場合や、削除を打ち直す前に同名で再登録した場合に、現役のキャッシュ・除外・上限の記録まで消えます。削除と再登録の呼び出し仕様を、外した世代だけを指定する実装にそろえてください。 見送った 基準 4 に当たる。r5-2 と同じく、設計の文書が読み取り専用のため見送った。同じ差分で次を直す。448 行目の forget を (state_dir, store, name, drop: str) にし、drop の世代だけを消す契約にする(実装と同じ)。411 行目の登録を keep=新しい世代 から drop=前の世代(前の登録があったときだけ)にする。412 行目の削除を keep=None から drop=外した世代 にし、打ち直しは finish_removal で残った世代だけを処理して今の登録に触れないと書く。451 行目と 576 行目の keep の記述も drop にそろえる。実装の accounts.forget は既に drop の形になっている
r5-4 kiro major issues/issue-3604-3864-design-detail.md:411 詳細設計の account_registry.generation の説明が、今回追加した規則と食い違っています。関数の表の shared_config_dir・store_dir・mark_relogin・generation の行は、generation を「account.json の generation(無ければ空文字)」と書いています。しかし「登録の世代」の行は、世代を持たない旧い登録の世代を legacy_generation で legacy-… と決め、空文字を旧い登録に使わないと定めています。実装の generation() も旧い登録に legacy-… を返します。表の行どおりに実装すると、旧い登録が空文字の世代になり、キャッシュが _.json と legacy-….json に分かれます。この行も「無い旧い登録は legacy_generation、登録が無いときだけ空文字」と書き直して、1 つの規則にそろえてください。 見送った r5-2 と同じ箇所(410 行目の generation の行)で、基準 4 に当たる。設計の文書が読み取り専用のため見送った。design-detail-r5.patch の 1 つ目の変更で、legacy_generation の規則と空文字の扱いを「登録の世代」の行と同じ 1 つの規則にそろえる
r6-1 codex major plugins/ndf/src/ndf/domains/relay/cli_account.py:154 削除の打ち直しを始める前に同名で再登録されていると、先に現役の登録を調べるため finish_removal() に進まず、新しい登録をログアウトして削除します。旧世代のファイルが消え残ったときに案内された account remove <名前> をそのまま打ち直すだけで、新しい認証情報と設定が失われます。現役の登録と削除残りが共存するときは、登録の排他の中で削除残りを優先して処理し、現役の登録を外す操作は別に識別できるようにしてください。 直した —
r6-2 codex major plugins/ndf/src/ndf/domains/relay/cli_account.py:159 現役の登録を外す経路では、names() の確認から detach()、logout()、unregister() まで対象を名前だけで引き直します。register() は同じ名前のディレクトリ内で認証ファイルを置き換えるため、削除の確認後に別の端末で再ログインが完了すると、新しい認証情報に対してログアウトが走ります。ログアウト後から unregister() が排他を取るまでに再登録された場合も、新しい世代のディレクトリが削除されます。削除対象の世代を固定し、認証情報や設定に触れる前の世代確認から登録を外すまでを、再登録と同じ排他で保護してください。 直した —
r7-1 codex major plugins/ndf/src/ndf/domains/relay/account_registry.py:467 削除の再試行が排他待ちの間に残りが片付くと、再登録した認証情報まで削除されます。旧世代の残りと同名の新しい登録がある状態で、2 端末から account remove を打ち直すと、先に排他を取った方が残りだけを消します。後から排他を取った方は removing() が偽になったため、残りの後始末から現役登録のログアウトと削除に進みます。残りの後始末として開始した呼び出しは、排他を取った時点で残りが消えていても現役登録の削除に切り替えずに返してください。 直した —

注意

takemi-ohama and others added 6 commits November 21, 2026 23:52
…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>
@takemi-ohama
takemi-ohama marked this pull request as ready for review November 22, 2026 00:23
@takemi-ohama
takemi-ohama merged commit 0848017 into sprint/3604-3864-relay-accounts Nov 22, 2026
33 checks passed
@takemi-ohama
takemi-ohama deleted the impl/3604-u4-usage-cache branch November 22, 2026 00:31
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