Skip to content

U7b ハブと登録簿の起動の回数の撤廃(#3604 #3864) - #4031

Merged
takemi-ohama merged 12 commits into
sprint/3604-3864-relay-accountsfrom
impl/3604-u7b-hub-starts
Nov 22, 2026
Merged

takemi-ohama merged 12 commits into
sprint/3604-3864-relay-accountsfrom
impl/3604-u7b-hub-starts

Conversation

@takemi-ohama

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

Copy link
Copy Markdown
Contributor

概要

実装の単位 U7b「ハブと登録簿の起動の回数の撤廃」(実装計画の Task 12)。リレーハブの restart の可否を名前つきのラッパーの数だけで決め、1 日の起動の回数(Lanes.starts_today・max_starts・Context.max_starts・today・registry.Starts)を消す。

満たす受け入れ条件: 3864:13(relay.md の側)・決定 13・I15

実装の中で決めたこと

  • hub ls の項目からも前のバージョンの starts を外す(hub.RETIRED_KEYS・_current)。詳細設計は restart の書き戻しだけを挙げるが、relay.result のスキーマの項目は additionalProperties: false なので、前のバージョンの登録簿に starts が残ったまま ndf relay ls を打つと結果の形の誤りで落ちる。restart の書き戻しと一覧で同じ関数を使う
  • hub.spin_of・_checked_env・spawn_env の空文字の NDF_RELAY_SPIN は U7a(U7a 再起動ループの検出(#3604 #3864) #4026)で入っていたので作り直さず、詳細設計の単体テストの観点のうち無かった spin_of の値の規則(無い・空・0・30・abc・-1・NDF_RELAY_MAX_STARTS=abc)のテストだけを足した
  • tests/progress/test_plan_lane_question.py は U7a の時点で 1 日の起動の上限を参照していなかったので変えていない
  • plugins/ndf/docs/contracts/commands.md はスキーマの変更に合わせて ndf check --write-spec で生成し直した

テスト

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

差分: 9 files changed, 115 insertions(+), 96 deletions(-)(uv.lock・env.md を除く)

関連: #3604 #3864

🤖 Generated with Claude Code

https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP

takemi-ohama and others added 8 commits November 21, 2026 23:12
…かめる(#3604 #3864)

決定 13・I15 のハブと登録簿の側のテスト。1 日に 30 回の restart・上限ちょうどの入れ替え・止まった対象の上限超え・
前の版の starts の除去・spin_of の値の規則・hub_context が NDF_RELAY_MAX_STARTS を読まないこと。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP
#3864)

hub_decide.Lanes の starts_today・max_starts、hub.Context の max_starts・today、registry.Starts を消す。
spawn は starts を書かず、restart は読まず増やさず、書き戻す項目と hub ls の項目から前のバージョンの starts を外す。
cli.hub_context の仮の max_starts を外し、relay.result のスキーマから starts を消す(commands.md は生成し直した)。
relay.md の上限の表と止まる理由を再起動ループの検出に替える。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP
… spawn にする(#3604 #3864)

- 端末のラッパー: ndf relay run --resume <ID> に、すべてのセッションに付ける引数(権限の制約など)を足す
- 名前つきのラッパー: restart(登録簿の最初の作業指示を流し直す)でなく、作業を保存して /exit した後に
  同じ名前・作業ディレクトリ・役割・計画で ndf relay spawn -- --resume <ID> … を打つ
- コマンドは shlex.join で語ごとに quote し、空白やシェルの構文を含む再開先も 1 語で渡す
- 案内のコマンドを CLI のパーサーへ通し、制約と再開先がそのまま戻ることを確かめる

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…#3864)

- ラッパーは再開の値(セッション ID・引き継ぐ引数・今のアカウント・作業ディレクトリ・役割・計画)を
  relay/wrappers/<名前>/again.json へ 0600 で書き、案内は ndf relay run|spawn --name <名前> --again だけにする
  (--mcp-config の認証ヘッダーや --append-system-prompt の本文を画面・tmux の履歴に出さない。複数行の値も 1 行で再開できる)
- --again の最初のセグメントはアカウントを選び直さず、再開の値のアカウント(None は既定のログイン)で起動し、起動できたら値を消す
- spawn --again は後継を tmux で --again で起動し(引数をコマンドに載せない)、登録簿の引数(最初の作業指示)を上書きしない

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…へ落とさない(#3604 #3864)

- run --again はラッパーの錠を取った後に再開の値を読み(Settings.again_load)、作業ディレクトリ・役割・計画・計画への質問の経路をその値で組む。起動できたら読んだ値のままのときだけ消す
- NDF_RELAY=0 や端末でないときの run --again は claude を直接起動せず、起動前に precondition で断る
- spawn --again は別の種類(spawn-again)で頼み、again を知らない同じメジャーの旧版が通常の spawn として起動しない
- spawn --again の環境は再開の値のアカウントで組み、今のアカウントの選び方を読まない
- 登録の無い名前の spawn --again は引数を持たない項目で登録し、再開の値の引数を 0600 でない登録簿や restart の tmux のコマンドに移さない
- --again を足した引数の仕様(relay.args.schema.json・commands.md)を生成し直す

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ain の設定を錠の後に 1 度だけ組む(#3604 #3864)

- ハブは {"kind": "spawn", "again": true} も再開の要求として扱う(通常の spawn で新しい会話・制約の無い起動・登録簿の上書きをしない)
- 登録簿に無い名前を --again で登録した項目に args_unknown を付け、restart は動いているラッパーを止める前に precondition で断る
- run --again は錠の前に仮の設定(wrapper.again_pending)だけを渡し、プラグインの識別を 1 度読んで錠の後の設定に使い回す
- a3f9753 で Lanes から起動の回数を外したのに残っていたテストの引数を直す

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

Copy link
Copy Markdown
Contributor Author

cross-review の記録(PR #4031)

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

ラウンドと修正

ラウンド レビューした head 範囲 判定 修正のコミット 送った 直した指摘
1 a3f9753a3 full changes_required c69255d1e 送った r1-1・r1-2
2 c69255d1e since changes_required 5d3648b8d 送った r2-1・r2-2・r2-3
3 5d3648b8d since changes_required d39e544eb 送った r3-1・r3-2・r3-3・r3-4
4 d39e544eb since changes_required 58a50f31c 送った r4-1・r4-2・r4-3・r4-4・r4-5・r4-6
5 58a50f31c since changes_required 6641e287c 送った r5-1・r5-2・r5-3

指摘

番号 担当 重要度 場所 指摘 終わり方 見送った理由
r1-1 codex major plugins/ndf/skills/development-workflow/references/relay.md:352 検出条件を「次のセグメントへ移ったセグメントが3つ続いたら」と書くと、3回目の切り替えを実行してから止める実装になります。実装は今のセグメントを数えた結果が閾値に達するかを起動前に判定するため、既定では3つ目のセグメントから4つ目への起動を止めます。初めての起動先への短い切り替えではカウントを維持し、設定された秒数以上動いたときにリセットすることも明記してください。 直した —
r1-2 codex major plugins/ndf/skills/development-workflow/references/relay.md:394 再起動ループからの復旧案内にある ndf relay は必須のサブコマンドが無いため、引数エラーで止まります。端末のラッパーには ndf relay run と継続に必要な引数を、登録済みの名前つきラッパーには tmux の外から ndf relay restart <名前> を案内してください。同じコマンドを表示する wrapper.py の端末メッセージも合わせて修正してください。 直した —
r2-1 codex major plugins/ndf/src/ndf/domains/relay/wrapper.py:90 端末向けの再開コマンドはセッション ID だけを渡すため、元の --permission-mode、--disallowedTools、--settings などが落ちます。たとえば --disallowedTools Bash で始めた会話を案内どおりに再開すると、起動時に指定した Bash の禁止が引き継がれません。元の権限制約を保ったまま再開できるようにし、制約付きの起動から案内どおりに再開する経路を検証してください。 直した —
r2-2 codex major plugins/ndf/src/ndf/domains/relay/wrapper.py:500 --resume の値は UUID に限定されず、パーサーが受け取った文字列がそのまま sec.session_id に入ります。--resume 'release prep today' で始めた会話では、表示されたコマンドを貼り付けると値が分割され、ラッパーを通さない起動になります。シェルの構文を含む値も貼り付け時に解釈されるため、案内を組み立てる際に再開先をシェルで安全な一引数にしてください。 直した —
r2-3 codex major plugins/ndf/src/ndf/domains/relay/wrapper.py:91 名前つきラッパーの案内を稼働中に実行すると、ハブは tmux kill-session で現在の子を終了させ、登録簿にある最初の spawn の引数を再実行します。たとえば第3セグメントで止まったレーンでは、現在の会話や引継ぎ入力を使わず初回の作業指示が再投入されます。終了前に作業を保存できる手順と、現在のセッションや引継ぎから再開できる手順を案内してください。 直した —
r3-1 codex major plugins/ndf/src/ndf/domains/relay/wrapper.py:505 self.s.args をそのまま端末に出すため、--mcp-config のインライン JSON に含まれる認証ヘッダーやトークン、--append-system-prompt の非公開本文が、再起動ループを検出しただけで tmux の履歴や端末ログに残ります。引数を読み戻せるようにしたうえで、画面の復旧コマンドには秘密や利用者データを含む値を出さず、権限の制約も保持してください。 直した —
r3-2 codex major plugins/ndf/src/ndf/domains/relay/wrapper.py:511 shlex.join は引数に含まれる改行をそのまま出力します。複数行の --settings JSON や --append-system-prompt を渡して起動すると、案内されたコマンドが複数行に分かれ、案内どおりに1行を貼り付けても再開できません。複数行の値を保持しながら、物理的に1行で貼り付けられる復旧手段にしてください。 直した —
r3-3 codex major plugins/ndf/src/ndf/domains/relay/wrapper.py:511 案内どおり同じ名前で spawn すると、hub.spawn がその名前の登録簿を復旧用の --resume 引数で上書きします。以降の ndf relay restart <名前> は登録時の作業指示を失い、復旧した時点のセッションを開き続けます。一度きりの再開に使う引数を登録簿の起動引数と分け、復旧後も元の作業指示で restart できるようにしてください。 直した —
r3-4 codex major plugins/ndf/src/ndf/domains/relay/wrapper.py:505 再開コマンドは現在の子のアカウント sec.account を渡しません。利用上限や認証失敗で別のアカウントへ切り替えた後にループを検出すると、再開時に _loop が環境変数や account use の指定から選び直し、元の使えないアカウントに戻ることがあります。run と spawn の両方で、再開する子に現在のアカウント選択を引き継いでください。 直した —
r4-1 codex major plugins/ndf/src/ndf/domains/relay/cli.py:288 端末で案内どおり run --again を実行すると、保存した作業ディレクトリ・役割・計画が復元されません。別のディレクトリから実行すると、その場所で Claude が起動し、会話を見つけられない場合や別の作業ツリーを操作する場合があります。保存値をラッパーの起動設定と計画への質問経路に反映してください。 直した —
r4-2 codex major plugins/ndf/src/ndf/domains/relay/cli.py:342 --again でも通常のパススルー判定を通るため、NDF_RELAY=0 や標準出力のリダイレクトで Claude を直接実行します。この経路では保存したアカウントを適用せず、再開データも消費しません。--again は保存値を適用できる経路に限定し、必要な端末条件を満たさなければ起動前に断ってください。 直した —
r4-3 codex major plugins/ndf/src/ndf/domains/relay/wrapper.py:290 再開データをラッパーの排他取得前に読み、起動後に同じパスを無条件で削除します。同じ名前の --again が並行すると、後続が読み取り後に止まり、先行が再開して終了した後で排他を取った場合に、消費済みの会話を再開できます。その間に新しい再起動ループで書かれた再開データも削除し得ます。排他を取った後に読み取り、起動したデータだけを消費してください。 直した —
r4-4 codex major plugins/ndf/src/ndf/domains/relay/hub.py:241 既存の登録が無い spawn --again は、認証ヘッダーなどを含み得る again.json の引数を、0600 を指定しない registry.json に複製します。通常の umask では登録簿が 0644 になり、後の restart では秘密が tmux のコマンドにも載ります。登録が無い場合も、再開引数を平文の登録簿や tmux のコマンドへ移さないようにしてください。 直した —
r4-5 codex major plugins/ndf/src/ndf/domains/relay/cli.py:186 spawn --again を既存の requests-v2 に通常の spawn として送るため、同一メジャーの旧版の CLI がキューを処理すると again を無視します。新しい導入先で起動しても、保存した作業ディレクトリ・会話・権限制約を渡さない通常の起動になります。旧版が通常の spawn として処理できないリクエスト形式にしてください。 直した —
r4-6 codex major plugins/ndf/src/ndf/domains/relay/hub.py:222 spawn --again の _checked_env は保存済みのアカウントを使わず、通常の spawn_env で現在のアカウント選択を読みます。指定ファイルが読めない場合は、保存してあるアカウントで再開できる状況でも tmux の起動前に失敗します。再開用の環境は保存値から組み立て、通常起動のアカウント選択を呼ばないようにしてください。 直した —
r5-1 codex major plugins/ndf/src/ndf/domains/relay/hub.py:220 同じメジャーの旧版 CLI が送る {"kind":"spawn","again":true} を新版ハブが処理すると、通常の spawn に流れます。旧形式の要求には cwd や args がないため、状態ディレクトリで新規会話を開き、保存した権限制限も落としたうえで、既存の登録項目を上書きします。旧形式も再開要求として認識するか、起動や登録簿の更新より前に明示的に拒否してください。 直した —
r5-2 codex major plugins/ndf/src/ndf/domains/relay/hub.py:248 登録簿にない名前を spawn --again で復旧すると、空の args が restart 用の引数として登録されます。その後の ndf relay restart は稼働中のラッパーを停止し、--permission-mode や --disallowedTools などの制約を落として Claude を起動します。元の起動引数を復元できない登録項目は、稼働中のラッパーを止める前に restart を拒否してください。 直した —
r5-3 codex major plugins/ndf/src/ndf/domains/relay/cli.py:380 run --again は錠を取る前に wrapper_settings を一式組み立て、錠を取った後に同じ処理をもう一度実行します。spawn --again の後継もこの経路を通るため、再開のたびに plugin.json の読み込みと更新・質問転送の設定構築が重複します。排他に必要な識別情報を一度取得して再利用し、再開の設定は錠を取った後に一度だけ組み立ててください。 直した —

takemi-ohama and others added 3 commits November 22, 2026 00:02
…3864)

cross-review の r2-1〜r5-3 の修正が足した仕組みで、承認済みの設計(SPIN_LINE は案内の 1 行)に無い起動引数と保存の形を足すため、設計への指摘として集める。戻すのは 5d3648b・d39e544eb・58a50f31c・6641e287c。r1-2 の案内のサブコマンドの直し(c69255d1e)は残す。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP
)

案内に書いた ndf relay run --resume は今の起動引数に無く、ndf check(spec-skill)が落ちる。案内のコマンドの形は設計で決めるので、設計への指摘として集める。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP
@takemi-ohama
takemi-ohama marked this pull request as ready for review November 22, 2026 00:10
@takemi-ohama
takemi-ohama merged commit 3738476 into sprint/3604-3864-relay-accounts Nov 22, 2026
34 checks passed
@takemi-ohama
takemi-ohama deleted the impl/3604-u7b-hub-starts branch November 22, 2026 00:11
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