From 42b6be1f768a66a562fbd22a23cb4b8a412251ff Mon Sep 17 00:00:00 2001 From: "takemi.ohama" Date: Sat, 21 Nov 2026 23:12:14 +0000 Subject: [PATCH 01/12] =?UTF-8?q?Test:=20=E3=83=AA=E3=83=AC=E3=83=BC?= =?UTF-8?q?=E3=83=8F=E3=83=96=E3=81=AE=20restart=20=E3=82=92=E5=90=8D?= =?UTF-8?q?=E5=89=8D=E3=81=A4=E3=81=8D=E3=81=AE=E3=83=A9=E3=83=83=E3=83=91?= =?UTF-8?q?=E3=83=BC=E3=81=AE=E6=95=B0=E3=81=A0=E3=81=91=E3=81=A7=E6=96=AD?= =?UTF-8?q?=E3=82=8A=E3=80=81=E7=99=BB=E9=8C=B2=E7=B0=BF=E3=81=A8=20hub=20?= =?UTF-8?q?ls=20=E3=81=AB=20starts=20=E3=82=92=E6=8C=81=E3=81=9F=E3=81=AA?= =?UTF-8?q?=E3=81=84=E3=81=93=E3=81=A8=E3=82=92=E7=A2=BA=E3=81=8B=E3=82=81?= =?UTF-8?q?=E3=82=8B=EF=BC=88#3604=20#3864=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 決定 13・I15 のハブと登録簿の側のテスト。1 日に 30 回の restart・上限ちょうどの入れ替え・止まった対象の上限超え・ 前の版の starts の除去・spin_of の値の規則・hub_context が NDF_RELAY_MAX_STARTS を読まないこと。 Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP --- .../ndf/tests/domains/relay/test_relay_cli.py | 19 +++- .../ndf/tests/domains/relay/test_relay_hub.py | 107 +++++++++++------- 2 files changed, 86 insertions(+), 40 deletions(-) diff --git a/plugins/ndf/tests/domains/relay/test_relay_cli.py b/plugins/ndf/tests/domains/relay/test_relay_cli.py index cf9e06381..5250ae7ce 100644 --- a/plugins/ndf/tests/domains/relay/test_relay_cli.py +++ b/plugins/ndf/tests/domains/relay/test_relay_cli.py @@ -13,7 +13,7 @@ from ndf import cli as top from ndf import identity from ndf.contracts import causes, limits -from ndf.domains.relay import accounts, cli, cli_account, markers, pending, registry, switch_decide, wrapper +from ndf.domains.relay import accounts, cli, cli_account, hub, markers, pending, registry, switch_decide, wrapper def test_relay_is_a_subcommand_of_ndf(): @@ -105,6 +105,23 @@ def test_ls_with_nothing_registered(capsys, last_result): assert last_result(capsys.readouterr().out)["items"] == [] +def test_ls_of_an_older_registry_entry_has_no_starts(capsys, last_result): + # 決定 13: hub ls の項目は starts を持たない。前の版の登録簿に starts が残っていても、結果の形の誤りにしない + path = hub.hub_dir(identity.load().state_dir) / registry.REGISTRY_FILE + path.parent.mkdir(parents=True, exist_ok=True) + entry = {"cwd": None, "args": [], "role": None, "plan": None, "version": "1", "starts": {"date": "2026-11-21", "count": 3}} + path.write_text(json.dumps({"version": 1, "entries": {"t1": entry}}), encoding="utf-8") + assert cli.main(["ls"]) == 0 + rows = last_result(capsys.readouterr().out)["items"] + assert [r["name"] for r in rows] == ["t1"] and "starts" not in rows[0] + + +def test_hub_context_has_no_start_limit(): + # 決定 13: hub_context は NDF_RELAY_MAX_STARTS を読まず、設定されていても誤りにしない + ctx = cli.hub_context({"NDF_RELAY_MAX_STARTS": "abc"}) + assert not hasattr(ctx, "max_starts") + + def test_env_override_must_be_a_positive_number(monkeypatch, capsys, last_result): monkeypatch.setenv("NDF_RELAY_MAX_NAMED", "many") assert cli.main(["ls"]) != 0 diff --git a/plugins/ndf/tests/domains/relay/test_relay_hub.py b/plugins/ndf/tests/domains/relay/test_relay_hub.py index 8891c7a7e..24a559aca 100644 --- a/plugins/ndf/tests/domains/relay/test_relay_hub.py +++ b/plugins/ndf/tests/domains/relay/test_relay_hub.py @@ -1,5 +1,7 @@ """リレーハブ: 受付箱・起動の確かめ・再起動の順・バージョンの混ざり・待ちの一覧(#2563・#2583・#2753・3341-2・決定 86)。 +再起動は名前つきのラッパーの数だけで断り、1 日の起動の回数を持たない(#3864 の決定 13・I15)。 + tmux は偽物に差し替え、ラッパーの代わりに錠を持つ。時計は進めるだけの偽物で、眠らない。 """ @@ -8,12 +10,12 @@ import dataclasses import json import os -from datetime import date from pathlib import Path import pytest -from ndf.domains.relay import hub, registry +from ndf.contracts import limits +from ndf.domains.relay import hub, registry, switch_decide from ndf.domains.relay.tmux import Done, Tmux, new_session_args VERSION = "11.0.0-dev.4" @@ -79,7 +81,6 @@ def ctx(tmp_path, hold_lock): environ={"NDF_STATE_HOME": str(tmp_path / "old"), "GIT_ASKPASS": "/vscode"}, tmux=tmux, max_named=2, - max_starts=3, started=hub.Wait(1.0, 0.1), stop_wait=hub.Wait(1.0, 0.1), hub_wait=hub.Wait(5.0, 0.1), @@ -167,15 +168,41 @@ def test_restart_at_the_limit_goes_through_and_lists_pending_runs(ctx): assert hub.submit(ctx, {"kind": "spawn", "name": "t3"}).cause == "refused" got = hub.submit(ctx, {"kind": "restart", "name": "t1"}) assert got.ok and {"pending": [{"id": "r1"}]} in got.items and "1 件" in got.summary - assert registry.read_registry(hub.hub_dir(ctx.state_dir))["t1"]["starts"]["count"] == 1 + assert "starts" not in registry.read_registry(hub.hub_dir(ctx.state_dir))["t1"] -def test_restart_refused_by_the_limit_does_not_stop_the_target(ctx): - assert hub.submit(ctx, {"kind": "spawn", "name": "t1"}).ok - ctx.max_starts = 0 +def _fill(ctx, names): + for name in names: + assert hub.submit(ctx, {"kind": "spawn", "name": name}).ok + + +def test_i15_restart_of_a_running_target_at_the_named_limit_goes_through(ctx): + # 決定 13・I15: 上限 4 本で 4 本が動いているとき、動いている対象の restart は進める(対象を除いて 3 本、足して 4 本) + ctx.max_named = 4 + _fill(ctx, ("t1", "t2", "t3", "t4")) + got = hub.submit(ctx, {"kind": "restart", "name": "t1"}) + assert got.ok, got.summary + assert len(ctx.tmux.started) == 5 and ctx.tmux.has("t1") + + +def test_i15_restart_of_a_stopped_target_over_the_named_limit_is_refused(ctx): + # 決定 13・I15: 上限 4 本で対象を除く 4 本が動き、対象が止まっているとき、対象の restart は断る(足して 5 本) + ctx.max_named = 5 + _fill(ctx, ("t1", "t2", "t3", "t4", "t5")) + assert hub.submit(ctx, {"kind": "stop", "name": "t1"}).ok + ctx.max_named = 4 got = hub.submit(ctx, {"kind": "restart", "name": "t1"}) - assert got.cause == "refused" - assert ctx.tmux.has("t1") and [r.name for r in registry.running(ctx.state_dir)] == ["t1"] + assert (got.ok, got.cause) == (False, "refused") and "4 本" in got.summary + assert not ctx.tmux.has("t1") and len(ctx.tmux.started) == 5 + + +def test_i15_restart_30_times_a_day_never_hits_a_start_limit(ctx): + # 決定 13・I15: 同じ名前を 1 日に 30 回 restart しても、名前つきのラッパーの数の上限に当たらなければ進める + assert hub.submit(ctx, {"kind": "spawn", "name": "t1"}).ok + for _ in range(30): + got = hub.submit(ctx, {"kind": "restart", "name": "t1"}) + assert got.ok, got.summary + assert len(ctx.tmux.started) == 31 and ctx.tmux.has("t1") @pytest.mark.parametrize("raw", ["abc", "-1"]) @@ -186,7 +213,6 @@ def test_restart_with_an_invalid_spin_keeps_the_target_running(ctx, raw): got = hub.submit(ctx, {"kind": "restart", "name": "t1"}) assert (got.ok, got.cause) == (False, "precondition") and "NDF_RELAY_SPIN" in got.summary assert ctx.tmux.has("t1") and len(ctx.tmux.started) == 1 - assert registry.read_registry(hub.hub_dir(ctx.state_dir))["t1"]["starts"]["count"] == 0 assert hub.submit(ctx, {"kind": "spawn", "name": "t2"}).cause == "precondition" and len(ctx.tmux.started) == 1 @@ -255,45 +281,48 @@ def boom(*a, **k): assert not t.has("t1") -# 現状固定(I-004): 再起動の回数は登録簿の starts が今日の日付のときだけ数え、ほかは 0 回から数える -def _register(ctx, starts): +def _register(ctx, entry): path = hub.hub_dir(ctx.state_dir) / registry.REGISTRY_FILE path.parent.mkdir(parents=True, exist_ok=True) - path.write_text(json.dumps({"version": 1, "entries": {"t1": {"cwd": None, "args": [], "starts": starts}}}), encoding="utf-8") + path.write_text(json.dumps({"version": 1, "entries": {"t1": entry}}), encoding="utf-8") -@pytest.mark.parametrize( - ("starts", "count"), - [ - ({"date": "2000-01-01", "count": 9}, 1), - ("壊れた値", 1), - (None, 1), - ({"date": "TODAY"}, 1), - ({"date": "TODAY", "count": "2"}, 3), - ], -) -def test_restart_counts_only_todays_starts(ctx, starts, count): - today = date.today().isoformat() - if isinstance(starts, dict): - starts = {k: (today if v == "TODAY" else v) for k, v in starts.items()} - _register(ctx, starts) +def test_i15_restart_drops_the_starts_of_an_older_registry_entry(ctx): + # 決定 13: 前の版の starts を持つ登録簿の項目を restart すると、書き戻した項目に starts が無い(上限の回数でも断らない) + _register(ctx, {"cwd": None, "args": [], "starts": {"date": "2026-11-21", "count": 99}}) + assert [r["name"] for r in hub.listing(ctx)] == ["t1"] and "starts" not in hub.listing(ctx)[0] got = hub.submit(ctx, {"kind": "restart", "name": "t1"}) assert got.ok, got.summary - assert registry.read_registry(hub.hub_dir(ctx.state_dir))["t1"]["starts"] == {"date": today, "count": count} + assert "starts" not in registry.read_registry(hub.hub_dir(ctx.state_dir))["t1"] -def test_restart_refuses_when_todays_starts_reach_the_limit(ctx): - today = date.today().isoformat() - _register(ctx, {"date": today, "count": 3}) - got = hub.submit(ctx, {"kind": "restart", "name": "t1"}) - assert (got.ok, got.cause) == (False, "refused") and "3 回" in got.summary - assert registry.read_registry(hub.hub_dir(ctx.state_dir))["t1"]["starts"] == {"date": today, "count": 3} - assert ctx.tmux.started == [] +def test_spawn_registers_no_starts(ctx): + # 決定 13: spawn は登録簿の項目に starts を書かない(hub ls の項目にも出ない) + assert hub.submit(ctx, {"kind": "spawn", "name": "t1"}).ok + assert "starts" not in registry.read_registry(hub.hub_dir(ctx.state_dir))["t1"] + assert "starts" not in hub.listing(ctx)[0] -def test_spawn_registers_zero_starts_for_today(ctx): - assert hub.submit(ctx, {"kind": "spawn", "name": "t1"}).ok - assert registry.read_registry(hub.hub_dir(ctx.state_dir))["t1"]["starts"] == {"date": date.today().isoformat(), "count": 0} +def test_the_hub_context_has_no_start_limit_or_clock_for_the_day(): + # 決定 13: リレーハブは 1 日の起動の上限と日付を持たない + fields = {f.name for f in dataclasses.fields(hub.Context)} + assert not fields & {"max_starts", "today"} + assert not {f.name for f in dataclasses.fields(hub.hub_decide.Lanes)} & {"starts_today", "max_starts"} + assert not hasattr(registry, "Starts") + + +@pytest.mark.parametrize( + ("environ", "seconds"), [({}, 120.0), ({"NDF_RELAY_SPIN": ""}, 120.0), ({"NDF_RELAY_SPIN": "0"}, 0.0), ({"NDF_RELAY_SPIN": "30"}, 30.0)] +) +def test_spin_of_reads_the_seconds_from_the_env(environ, seconds): + # 決定 13: 秒は NDF_RELAY_SPIN(無いか空なら relay.spin の秒、0 は検出を切る)。NDF_RELAY_MAX_STARTS は読まない + assert hub.spin_of({**environ, "NDF_RELAY_MAX_STARTS": "abc"}) == switch_decide.Spin(3, seconds) + + +@pytest.mark.parametrize("raw", ["abc", "-1"]) +def test_spin_of_refuses_a_broken_value(raw): + with pytest.raises(limits.EnvError, match="NDF_RELAY_SPIN"): + hub.spin_of({"NDF_RELAY_SPIN": raw}) def test_a_broken_registry_answers_invalid_and_does_not_block_later_requests(ctx): From a3f9753a36184c88ee3fe601b1925cf26437fd8a Mon Sep 17 00:00:00 2001 From: "takemi.ohama" Date: Sat, 21 Nov 2026 23:16:06 +0000 Subject: [PATCH 02/12] =?UTF-8?q?Fix:=20=E3=83=AA=E3=83=AC=E3=83=BC?= =?UTF-8?q?=E3=83=8F=E3=83=96=E3=81=AE=20restart=20=E3=82=92=E5=90=8D?= =?UTF-8?q?=E5=89=8D=E3=81=A4=E3=81=8D=E3=81=AE=E3=83=A9=E3=83=83=E3=83=91?= =?UTF-8?q?=E3=83=BC=E3=81=AE=E6=95=B0=E3=81=A0=E3=81=91=E3=81=A7=E6=96=AD?= =?UTF-8?q?=E3=82=8A=E3=80=81=E7=99=BB=E9=8C=B2=E7=B0=BF=E3=81=A8=20hub=20?= =?UTF-8?q?ls=20=E3=81=8B=E3=82=89=201=20=E6=97=A5=E3=81=AE=E8=B5=B7?= =?UTF-8?q?=E5=8B=95=E3=81=AE=E5=9B=9E=E6=95=B0=E3=82=92=E6=B6=88=E3=81=99?= =?UTF-8?q?=EF=BC=88#3604=20#3864=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP --- .../schemas/io/relay.result.schema.json | 4 --- plugins/ndf/docs/contracts/commands.md | 2 +- .../development-workflow/references/relay.md | 15 ++++++---- plugins/ndf/src/ndf/domains/relay/cli.py | 2 -- plugins/ndf/src/ndf/domains/relay/hub.py | 25 +++++++++-------- .../ndf/src/ndf/domains/relay/hub_decide.py | 9 ++---- plugins/ndf/src/ndf/domains/relay/registry.py | 28 ++----------------- .../ndf/tests/domains/relay/test_relay_cli.py | 2 +- .../ndf/tests/domains/relay/test_relay_hub.py | 2 +- 9 files changed, 31 insertions(+), 58 deletions(-) diff --git a/plugins/ndf/contracts/schemas/io/relay.result.schema.json b/plugins/ndf/contracts/schemas/io/relay.result.schema.json index b3c580b79..73eb39ab9 100644 --- a/plugins/ndf/contracts/schemas/io/relay.result.schema.json +++ b/plugins/ndf/contracts/schemas/io/relay.result.schema.json @@ -138,10 +138,6 @@ ], "description": "ラッパーの計画(hub ls)" }, - "starts": { - "type": "object", - "description": "その日の起動の回数(hub ls)" - }, "version": { "type": "string", "description": "ラッパーを起動したプラグインのバージョン(hub ls)" diff --git a/plugins/ndf/docs/contracts/commands.md b/plugins/ndf/docs/contracts/commands.md index 74b3bc05e..32756525d 100644 --- a/plugins/ndf/docs/contracts/commands.md +++ b/plugins/ndf/docs/contracts/commands.md @@ -330,7 +330,7 @@ | `ndf relay stop` | `name`(string・任意・位置): 止めるラッパーの名前
`--all`(boolean・任意): 動いている名前つきのラッパーをすべて止める | | `ndf relay uninstall` | 引数を受けない | -結果の `metrics`: `accounts`(integer)・`inside`(boolean)・`keys`(integer)・`limit`(integer)・`no_policy_rows`(integer)・`policy`(string)・`samples`(integer)・`skipped`(integer)・`stopped`(integer)・`works`(integer)。`items` の要素: `account`(string か null)・`args`(array か null)・`at`(string)・`auto_compacts`(integer か string)・`band`(string か null)・`basis`(string か null)・`capacity_declared`(object)・`config_error`(string か null)・`context`(integer か null)・`cwd`(string か null)・`decide_from`(integer)・`details`(object)・`effective_limit`(integer か null)・`email`(string か null)・`estimate`(object か null)・`event`(string)・`expires_at`(string)・`handoff_calls`(number か null)・`handoff_output`(number か null)・`keys`(array)・`kind`(string)・`limit`(integer)・`margin`(integer)・`missing`(array)・`model`(string か null)・`monthly_usd`(number か null)・`name`(string)・`no_policy_rows`(integer)・`ok`(boolean)・`org_name`(string か null)・`parts`(object)・`passed_once`(boolean)・`path`(string)・`pending`(array か null)・`percent`(number か null)・`pinned`(boolean)・`plan`(string か null)・`policy`(string)・`position`(string)・`prompt`(string)・`provider`(string)・`quality`(object)・`reason`(string か null)・`relay`(boolean)・`replaced`(boolean)・`restart_count`(integer)・`restarts`(object)・`restore_calls`(number か null)・`restore_context`(number か null)・`restores`(array)・`role`(string か null)・`run`(string)・`running`(boolean)・`runtime`(string)・`samples`(object)・`schema`(integer)・`session_id`(string か null)・`sessions`(integer)・`source`(string)・`sources`(object)・`stage`(string か null)・`stage_calls`(object)・`stage_expiries`(object)・`starts`(object)・`state`(string か null)・`status`(string か null)・`summary`(string)・`text`(string)・`transcript`(string か null)・`unknown_parts`(object)・`updated_at`(string か null)・`url`(string)・`use`(string)・`verdict`(string か null)・`version`(string)・`weekly_at`(number)・`window`(integer か null)・`work`(string)・`workflow`(string) +結果の `metrics`: `accounts`(integer)・`inside`(boolean)・`keys`(integer)・`limit`(integer)・`no_policy_rows`(integer)・`policy`(string)・`samples`(integer)・`skipped`(integer)・`stopped`(integer)・`works`(integer)。`items` の要素: `account`(string か null)・`args`(array か null)・`at`(string)・`auto_compacts`(integer か string)・`band`(string か null)・`basis`(string か null)・`capacity_declared`(object)・`config_error`(string か null)・`context`(integer か null)・`cwd`(string か null)・`decide_from`(integer)・`details`(object)・`effective_limit`(integer か null)・`email`(string か null)・`estimate`(object か null)・`event`(string)・`expires_at`(string)・`handoff_calls`(number か null)・`handoff_output`(number か null)・`keys`(array)・`kind`(string)・`limit`(integer)・`margin`(integer)・`missing`(array)・`model`(string か null)・`monthly_usd`(number か null)・`name`(string)・`no_policy_rows`(integer)・`ok`(boolean)・`org_name`(string か null)・`parts`(object)・`passed_once`(boolean)・`path`(string)・`pending`(array か null)・`percent`(number か null)・`pinned`(boolean)・`plan`(string か null)・`policy`(string)・`position`(string)・`prompt`(string)・`provider`(string)・`quality`(object)・`reason`(string か null)・`relay`(boolean)・`replaced`(boolean)・`restart_count`(integer)・`restarts`(object)・`restore_calls`(number か null)・`restore_context`(number か null)・`restores`(array)・`role`(string か null)・`run`(string)・`running`(boolean)・`runtime`(string)・`samples`(object)・`schema`(integer)・`session_id`(string か null)・`sessions`(integer)・`source`(string)・`sources`(object)・`stage`(string か null)・`stage_calls`(object)・`stage_expiries`(object)・`state`(string か null)・`status`(string か null)・`summary`(string)・`text`(string)・`transcript`(string か null)・`unknown_parts`(object)・`updated_at`(string か null)・`url`(string)・`use`(string)・`verdict`(string か null)・`version`(string)・`weekly_at`(number)・`window`(integer か null)・`work`(string)・`workflow`(string) ## `ndf release-steps` diff --git a/plugins/ndf/skills/development-workflow/references/relay.md b/plugins/ndf/skills/development-workflow/references/relay.md index 588b126e5..02918d30c 100644 --- a/plugins/ndf/skills/development-workflow/references/relay.md +++ b/plugins/ndf/skills/development-workflow/references/relay.md @@ -349,13 +349,15 @@ hook が消せなかった質問は、次の閉じる事象か子の終わりま | 上限 | 既定 | 変え方 | 超えたとき | | --- | --- | --- | --- | -| 子を起動し直す回数(1 つのラッパーが 1 日に) | 20 | `contracts/limits.json` の `relay.max-starts`、環境変数 `NDF_RELAY_MAX_STARTS` | 子が 0 以外で終わった・出力が止まったときに起動し直さず、利用上限でアカウントを替えて続けもせず、ラッパーが終わる(`ndf-relay: <理由>。今日起動し直した回数が上限(<回数> 回)に当たった`)。`ndf relay restart` は対象を止めずに断る | +| 再起動ループの検出(起動から短い時間で次のセグメントへ移ったセグメントの続き) | 3 つ・120 秒 | `contracts/limits.json` の `relay.spin`(`count`・`seconds`)、環境変数 `NDF_RELAY_SPIN`(秒) | 起動から 120 秒未満で次のセグメントへ移ったセグメントが 3 つ続いたら、次のセグメントを起動しない。子が動いていれば今の会話のまま中継を続け(そのセグメントが起動から 120 秒に達するまで区切り・替えでも起動しない)、子が終わっていればラッパーが子の終了コードで終わる | | 静かな時間(子の出力も利用者の入力も無い秒数) | 5 | `contracts/limits.json` の `relay.quiet` | 子の出力と利用者の入力がこの秒数止まるか、次のセグメントのマーカーを書いてからこの秒数がたつまで、子を止めず次のセグメントを起動しない。利用者が子へ入力すると、出力が止まっていても静かな時間を数え直す。マーカーを書いてからの秒数は数え直さないので、待つのは長くてもマーカーを書いてから静かな時間まで | -**数えるのは、落ちた・止まった子やラッパーを起動し直した回数だけである。** 子が 0 以外で終わった・出力が `relay.stall`(30 分)止まった -ときの起動し直しと、利用上限でアカウントを替えた起動し直し、`ndf relay restart` の起動し直しを数える。カットポイントの -切り替え(`ndf-next` のブロック・`/ndf:restart`)と、文脈の上限で引継ぎを頼む起動し直しは数えない。回数は日付が変わると 0 に戻る。 -`NDF_RELAY_MAX_STARTS` は正の数で、数でない値と 0 以下の値は誤りになる。 +**数えるのは、起動から短い時間で終わったセグメントの続きである。** カットポイントの区切り(`ndf-next` のブロック・`/ndf:restart`)、 +子が 0 以外で終わった・出力が `relay.stall`(30 分)止まったときの起動し直し、文脈の上限で引継ぎを頼む起動し直し、続きの中で +既に起動した起動先へアカウントを替える起動を数える。続きの中で初めて使う起動先(アカウント・従量の接続)への替えは数えないので、 +上限で次々にアカウントを替えて続ける正しい替えでは当たらない。120 秒以上動いたセグメントの後は数え直す。1 日の起動の回数の +上限は持たない。`ndf relay restart` は名前つきのラッパーの数(`relay.max-named`)だけで断り、起動の回数では断らない。 +`NDF_RELAY_SPIN` は 0 以上の数で、0 で検出を切る。数でない値と負の値は誤りになる(ラッパーを起動せず、`ndf relay restart` は対象を止めずに断る)。 **文脈の上限(`NDF_CONTEXT_LIMIT`、既定 200,000)はラッパーの下で強くなる。** ラッパーの直接の子の conductor では、コンテキスト量の hook が工程へ入る起動を 1 度の通しなしに止め続ける。conductor は動いて @@ -389,7 +391,8 @@ claude のアカウントを 2 つ以上登録しておくと、利用上限で | `プラグインを更新できなかった(<理由>)。<バージョン> で次のセグメントを起動する` | 更新に失敗した。ラッパーは止まらず、そのバージョンで次のセグメントを起動した | 何もしなくてよい。ラッパーが次のカットポイントで更新を打ち直す | | `メジャーバージョンが <ラッパー> から <起動先> に変わった。次のセグメントを起動しない。…` | ラッパーは終わった(終了コード 3)。`relay.root` は起動先へ向け直してある | 1 行の案内どおり `claude` を打ち直し、conductor のブロックの中身を最初の入力にする | | `子の claude を起動できない(<理由>)` | ラッパーは終わった(終了コード 3)。子は起動していない | 理由(作業ディレクトリが無い・`claude` が PATH に無いなど)を直してから、conductor のブロックの中身で `claude` を打ち直す | -| 上の 4 つ以外(`ndf-relay: <理由>`) | ラッパーは終わった。終了コードは停止理由の種類(`contracts/causes.json`)のとおり。起動し直す回数の上限(「[上限](#上限)」)に当たったときもこの行になる | 理由を直してから、conductor のブロックの中身で `claude` を起動する | +| `起動から <秒> 秒未満で次のセグメントへ移ったセグメントが <数> つ続いた(再起動ループ)。次のセグメントを起動しない。…` | 再起動ループの検出(「[上限](#上限)」)に当たった。今のセッションは動いたまま | 原因を直してから `/exit` し、`ndf relay` で起動し直す | +| 上の 5 つ以外(`ndf-relay: <理由>`) | ラッパーは終わった。終了コードは停止理由の種類(`contracts/causes.json`)のとおり。再起動ループの検出で、子が終わった後に止まったときもこの行になる(終了コードは子の終了コード) | 理由を直してから、conductor のブロックの中身で `claude` を起動する | ## fork したセッションで進めたとき diff --git a/plugins/ndf/src/ndf/domains/relay/cli.py b/plugins/ndf/src/ndf/domains/relay/cli.py index 1a9473d3d..0b8d83dff 100644 --- a/plugins/ndf/src/ndf/domains/relay/cli.py +++ b/plugins/ndf/src/ndf/domains/relay/cli.py @@ -157,8 +157,6 @@ def hub_context(environ: Mapping[str, str]) -> hub.Context: environ=environ, tmux=Tmux(environ, limits.seconds("relay.tmux")), max_named=int(limits.from_env(environ, "NDF_RELAY_MAX_NAMED", "relay.max-named", "count")), - # 1 日の起動の上限は持たない(#3864 の決定 13)。登録簿の回数とこの値は #3604 の U7b で hub から消す - max_starts=sys.maxsize, started=hub.Wait(limits.seconds("relay.started"), limits.value("relay.started", "interval")), stop_wait=hub.Wait( limits.from_env(environ, "NDF_RELAY_STOP_WAIT", "relay.stop-wait", "seconds"), limits.value("relay.stop-wait", "interval") diff --git a/plugins/ndf/src/ndf/domains/relay/hub.py b/plugins/ndf/src/ndf/domains/relay/hub.py index a91afa098..09c1728e3 100644 --- a/plugins/ndf/src/ndf/domains/relay/hub.py +++ b/plugins/ndf/src/ndf/domains/relay/hub.py @@ -4,7 +4,8 @@ なって、溜まったリクエストを古い順に 1 本ずつ処理する(常駐のプロセスを持たない)。結果は `results/.json` へ書き、 頼んだ側が読んで消す。登録簿 `registry.json` を書くのは排他を持つリレーハブだけである。 -- 再起動は、止める前に上限を判定し、通ったときだけ止めてから起動する(#2753。`hub_decide.restart`) +- 再起動は、止める前に上限を判定し、通ったときだけ止めてから起動する(#2753。`hub_decide.restart`)。上限は名前つきの + ラッパーの数だけで、1 日の起動の回数を持たない(#3864 の決定 13。暴走止めはラッパーの再起動ループの検出が持つ) - 起動が「起動した」を返すのは、ラッパーの錠が取られ、tmux のセッションが残っているときだけ(#2563) - ラッパーの保存先(プラグインの `bin/ndf`)が無ければ、理由と打ち直しのコマンドを返す(#2583) - バージョンの違うラッパーが動いていれば起動しない(3341-2。`hub_decide.mixed`) @@ -22,7 +23,6 @@ import time import uuid from dataclasses import dataclass, field -from datetime import date from pathlib import Path from typing import Any, Callable, Mapping, NamedTuple, Optional @@ -34,6 +34,8 @@ LOCK_FILE = "hub.lock" STATE_FILE = "hub.json" LOG_FILE = "hub-log.jsonl" +# 前のバージョンが登録簿の項目に書いた 1 日の起動の回数。読まず、書き戻す項目と一覧から外す(#3864 の決定 13) +RETIRED_KEYS = ("starts",) # 受付箱。導入(plugin_root・version)を読まない旧版は `requests/` だけを読むので、別の名前にして旧版に処理させない(#3909)。 # 旧版の頼む側は自分の drain で `requests/` を処理する(排他は共通の hub.lock) REQUESTS_DIR = "requests-v2" @@ -73,7 +75,7 @@ def spin_of(environ: Mapping[str, str]) -> switch_decide.Spin: @dataclass class Context: - """リレーハブが読む事実と部品。時計・眠り・日付はテストで差し替える。""" + """リレーハブが読む事実と部品。時計と眠りはテストで差し替える。""" state_dir: Path plugin_root: Path @@ -81,14 +83,12 @@ class Context: environ: Mapping[str, str] tmux: Tmux max_named: int - max_starts: int started: Wait stop_wait: Wait hub_wait: Wait pending: Callable[[], Mapping[str, Any]] = field(default=lambda: {"runs": [], "note": ""}) sleep: Callable[[float], None] = time.sleep monotonic: Callable[[], float] = time.monotonic - today: Callable[[], date] = date.today def hub_dir(state_dir: Path) -> Path: @@ -210,12 +210,11 @@ def spawn(ctx: Context, req: Mapping[str, Any]) -> Outcome: registry.wrapper_dir(ctx.state_dir, name) # 名前の形を tmux を起動する前に確かめる(違えば RegistryError) if name in names or ctx.tmux.has(name): return Outcome(False, f"{name} は既に動いている", "refused") - lanes = hub_decide.Lanes(_own_count(running), ctx.max_named, False, 0, ctx.max_starts) + lanes = hub_decide.Lanes(_own_count(running), ctx.max_named, False) refused = _refused(hub_decide.spawn(lanes), "refused") if refused is not None: return refused entry = {k: req.get(k) for k in ("cwd", "args", "role", "plan")} - entry["starts"] = registry.Starts(ctx.today().isoformat(), 0).as_json() env = _checked_env(ctx, name, entry) if isinstance(env, Outcome): return env @@ -237,9 +236,8 @@ def restart(ctx: Context, name: str) -> Outcome: refused = _refused(hub_decide.mixed(ctx.version, others), "precondition") if refused is not None: return refused - starts = registry.Starts.today(entry.get("starts"), ctx.today) target = any(r.name == name for r in running) - lanes = hub_decide.Lanes(_own_count(running), ctx.max_named, target, starts.count, ctx.max_starts) + lanes = hub_decide.Lanes(_own_count(running), ctx.max_named, target) refused = _refused(hub_decide.restart(lanes), "refused") if refused is not None: return refused @@ -250,7 +248,7 @@ def restart(ctx: Context, name: str) -> Outcome: unstopped = _await_exit(ctx, name, target) if unstopped is not None: return unstopped - entry = {**entry, "starts": starts.bumped().as_json(), "version": ctx.version} + entry = {**_current(entry), "version": ctx.version} got = _launch(ctx, name, entry, env) entries[name] = entry registry.save_registry(hub_dir(ctx.state_dir), entries) @@ -271,6 +269,11 @@ def _checked_env(ctx: Context, name: str, entry: Mapping[str, Any]) -> "dict[str return env +def _current(entry: Mapping[str, Any]) -> dict[str, Any]: + """登録簿の項目から前のバージョンの項目(`RETIRED_KEYS`)を外したもの。""" + return {k: v for k, v in entry.items() if k not in RETIRED_KEYS} + + def _await_exit(ctx: Context, name: str, running: bool) -> Optional[Outcome]: """動いていれば止めて終わるまで待つ。止められなければその結果、止めた・動いていなければ None。""" if not running: @@ -355,7 +358,7 @@ def listing(ctx: Context) -> list[dict[str, Any]]: for name, entry in sorted(registry.read_registry(hub_dir(ctx.state_dir)).items()): state = registry.read_state(registry.wrapper_dir(ctx.state_dir, name)) status = (state or {}).get("state") if name in running else "stopped" # noqa: NDF501 ファイル: 状態が無ければ起動の途中 - out.append({"name": name, "running": name in running, "state": status, "reason": (state or {}).get("reason"), **entry}) # noqa: NDF501 ファイル: 状態が無ければ理由も無い + out.append({"name": name, "running": name in running, "state": status, "reason": (state or {}).get("reason"), **_current(entry)}) # noqa: NDF501 ファイル: 状態が無ければ理由も無い return out diff --git a/plugins/ndf/src/ndf/domains/relay/hub_decide.py b/plugins/ndf/src/ndf/domains/relay/hub_decide.py index 988a2b2c2..3fbee5601 100644 --- a/plugins/ndf/src/ndf/domains/relay/hub_decide.py +++ b/plugins/ndf/src/ndf/domains/relay/hub_decide.py @@ -1,7 +1,8 @@ """リレーハブの起動と再起動の判断(#2563・#2583・#2753)。時計とプロセスを読まない純粋な関数。 - 再起動(restart)は、止める前に上限を判定する。上限の数には再起動する対象を数えない(止めた後に上限で - 断ってレーンが止まったまま残ることが無い。#2753) + 断ってレーンが止まったまま残ることが無い。#2753)。上限は名前つきのラッパーの数だけで、1 日の起動の回数を持たない + (#3864 の決定 13) - 起動(spawn・restart)が「起動した」を返すのは、ラッパーのプロセスが生きていて、保存先の一覧に載ったときだけ (#2563) - ラッパーの保存先(プラグインのバージョンの保存先)が無ければ、何も出さずに失敗せず、理由と打ち直しの手を返す(#2583) @@ -22,8 +23,6 @@ class Lanes: running: int max_named: int target_running: bool - starts_today: int - max_starts: int GO = "go" @@ -42,12 +41,10 @@ def ok(self) -> bool: def restart(lanes: Lanes) -> Decision: - """再起動してよいか。止める前に判定する。""" + """再起動してよいか。止める前に、名前つきのラッパーの数だけで判定する(#3864 の決定 13)。""" others = lanes.running - (1 if lanes.target_running else 0) if others + 1 > lanes.max_named: return Decision(REFUSE, f"対象を除いて {others} 本が動いており、上限 {lanes.max_named} 本を超える。対象は止めない") - if lanes.starts_today >= lanes.max_starts: - return Decision(REFUSE, f"今日起動し直した回数が上限({lanes.max_starts} 回)に当たった。対象は止めない") return Decision(GO, "止めてから起動し直す") diff --git a/plugins/ndf/src/ndf/domains/relay/registry.py b/plugins/ndf/src/ndf/domains/relay/registry.py index 846c458cb..c77c28dde 100644 --- a/plugins/ndf/src/ndf/domains/relay/registry.py +++ b/plugins/ndf/src/ndf/domains/relay/registry.py @@ -5,7 +5,7 @@ | ファイル | 中身 | | --- | --- | | `relay.lock` | 動いている間ラッパーが排他で持つ。排他が取れなければ動いている(pid の生死では見ない) | -| `wrapper.json` | 名前・バージョン・状態(`running`・`stalled`・`waiting`・`stopped`)・理由・セグメント・アカウント・今日起動し直した回数 | +| `wrapper.json` | 名前・バージョン・状態(`running`・`stalled`・`waiting`・`stopped`)・理由・セグメント・アカウント | | `log.jsonl` | セグメントの切り替えと、切り替えない理由が変わったときの 1 行 | | `next.json`・`question.json` | hook が書くシグナルファイル(`signals`) | @@ -16,10 +16,8 @@ from __future__ import annotations import json -from dataclasses import dataclass -from datetime import date from pathlib import Path -from typing import Any, Callable, Mapping, Optional +from typing import Any, Mapping, Optional from ndf import identity from ndf.contracts import facts @@ -37,28 +35,6 @@ class RegistryError(ValueError): """ラッパーの名前の形が違う・状態のファイルが壊れている。""" -@dataclass(frozen=True) -class Starts: - """今日起動し直した回数。JSON では `{"date": ISO 日付, "count": 回数}` で持つ。""" - - date: str - count: int - - @classmethod - def today(cls, raw: Any, today: Callable[[], date] = date.today) -> "Starts": - """`raw` が今日(`today` が返す日付)の回数ならその回数、形が違うか日付が今日でなければ 0 回。""" - day = today().isoformat() - if isinstance(raw, dict) and raw.get("date") == day: - return cls(day, int(raw.get("count", 0))) # noqa: NDF502 ファイル: 回数が無ければ 0 回 - return cls(day, 0) - - def bumped(self) -> "Starts": - return Starts(self.date, self.count + 1) - - def as_json(self) -> dict[str, Any]: - return {"date": self.date, "count": self.count} - - def wrappers_dir(state_dir: Path) -> Path: return state_dir / facts.value("locations", "relay-wrappers", "path") diff --git a/plugins/ndf/tests/domains/relay/test_relay_cli.py b/plugins/ndf/tests/domains/relay/test_relay_cli.py index 5250ae7ce..bd598e28e 100644 --- a/plugins/ndf/tests/domains/relay/test_relay_cli.py +++ b/plugins/ndf/tests/domains/relay/test_relay_cli.py @@ -106,7 +106,7 @@ def test_ls_with_nothing_registered(capsys, last_result): def test_ls_of_an_older_registry_entry_has_no_starts(capsys, last_result): - # 決定 13: hub ls の項目は starts を持たない。前の版の登録簿に starts が残っていても、結果の形の誤りにしない + # 決定 13: hub ls の項目は starts を持たない。前のバージョンの登録簿に starts が残っていても、結果の形の誤りにしない path = hub.hub_dir(identity.load().state_dir) / registry.REGISTRY_FILE path.parent.mkdir(parents=True, exist_ok=True) entry = {"cwd": None, "args": [], "role": None, "plan": None, "version": "1", "starts": {"date": "2026-11-21", "count": 3}} diff --git a/plugins/ndf/tests/domains/relay/test_relay_hub.py b/plugins/ndf/tests/domains/relay/test_relay_hub.py index 24a559aca..76588bfe9 100644 --- a/plugins/ndf/tests/domains/relay/test_relay_hub.py +++ b/plugins/ndf/tests/domains/relay/test_relay_hub.py @@ -288,7 +288,7 @@ def _register(ctx, entry): def test_i15_restart_drops_the_starts_of_an_older_registry_entry(ctx): - # 決定 13: 前の版の starts を持つ登録簿の項目を restart すると、書き戻した項目に starts が無い(上限の回数でも断らない) + # 決定 13: 前のバージョンの starts を持つ登録簿の項目を restart すると、書き戻した項目に starts が無い(上限の回数でも断らない) _register(ctx, {"cwd": None, "args": [], "starts": {"date": "2026-11-21", "count": 99}}) assert [r["name"] for r in hub.listing(ctx)] == ["t1"] and "starts" not in hub.listing(ctx)[0] got = hub.submit(ctx, {"kind": "restart", "name": "t1"}) From 96a9bac85dfdfee7c9e4368f616e31aa98f29d48 Mon Sep 17 00:00:00 2001 From: "takemi.ohama" Date: Sat, 21 Nov 2026 23:19:52 +0000 Subject: [PATCH 03/12] =?UTF-8?q?Docs:=20=E5=86=8D=E8=B5=B7=E5=8B=95?= =?UTF-8?q?=E3=83=AB=E3=83=BC=E3=83=97=E3=81=AE=E6=A4=9C=E5=87=BA=E3=81=8C?= =?UTF-8?q?=E8=B5=B7=E5=8B=95=E5=89=8D=E3=81=AB=E4=BB=8A=E3=81=AE=E3=82=BB?= =?UTF-8?q?=E3=82=B0=E3=83=A1=E3=83=B3=E3=83=88=E3=82=92=E5=90=AB=E3=82=81?= =?UTF-8?q?=E3=81=A6=E6=95=B0=E3=81=88=E3=82=8B=E3=81=93=E3=81=A8=E3=81=A8?= =?UTF-8?q?=E3=80=81=E6=95=B0=E3=82=92=E6=AE=8B=E3=81=99=E3=83=BB=E6=88=BB?= =?UTF-8?q?=E3=81=99=E6=9D=A1=E4=BB=B6=E3=82=92=E6=9B=B8=E3=81=8F=EF=BC=88?= =?UTF-8?q?#3604=20#3864=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- plugins/ndf/skills/development-workflow/references/relay.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/plugins/ndf/skills/development-workflow/references/relay.md b/plugins/ndf/skills/development-workflow/references/relay.md index 02918d30c..854b2c64f 100644 --- a/plugins/ndf/skills/development-workflow/references/relay.md +++ b/plugins/ndf/skills/development-workflow/references/relay.md @@ -349,13 +349,14 @@ hook が消せなかった質問は、次の閉じる事象か子の終わりま | 上限 | 既定 | 変え方 | 超えたとき | | --- | --- | --- | --- | -| 再起動ループの検出(起動から短い時間で次のセグメントへ移ったセグメントの続き) | 3 つ・120 秒 | `contracts/limits.json` の `relay.spin`(`count`・`seconds`)、環境変数 `NDF_RELAY_SPIN`(秒) | 起動から 120 秒未満で次のセグメントへ移ったセグメントが 3 つ続いたら、次のセグメントを起動しない。子が動いていれば今の会話のまま中継を続け(そのセグメントが起動から 120 秒に達するまで区切り・替えでも起動しない)、子が終わっていればラッパーが子の終了コードで終わる | +| 再起動ループの検出(起動から短い時間で次のセグメントへ移ったセグメントの続き) | 3 つ・120 秒 | `contracts/limits.json` の `relay.spin`(`count`・`seconds`)、環境変数 `NDF_RELAY_SPIN`(秒) | 次のセグメントを起動する前に、今のセグメントを含めて起動から 120 秒未満のセグメントの続きを数え、3 つに達していれば起動しない(既定では、短いセグメントが 2 つ続いた後の 3 つ目から 4 つ目への起動を止める)。子が動いていれば今の会話のまま中継を続け(そのセグメントが起動から 120 秒に達するまで区切り・替えでも起動しない)、子が終わっていればラッパーが子の終了コードで終わる | | 静かな時間(子の出力も利用者の入力も無い秒数) | 5 | `contracts/limits.json` の `relay.quiet` | 子の出力と利用者の入力がこの秒数止まるか、次のセグメントのマーカーを書いてからこの秒数がたつまで、子を止めず次のセグメントを起動しない。利用者が子へ入力すると、出力が止まっていても静かな時間を数え直す。マーカーを書いてからの秒数は数え直さないので、待つのは長くてもマーカーを書いてから静かな時間まで | **数えるのは、起動から短い時間で終わったセグメントの続きである。** カットポイントの区切り(`ndf-next` のブロック・`/ndf:restart`)、 子が 0 以外で終わった・出力が `relay.stall`(30 分)止まったときの起動し直し、文脈の上限で引継ぎを頼む起動し直し、続きの中で 既に起動した起動先へアカウントを替える起動を数える。続きの中で初めて使う起動先(アカウント・従量の接続)への替えは数えないので、 -上限で次々にアカウントを替えて続ける正しい替えでは当たらない。120 秒以上動いたセグメントの後は数え直す。1 日の起動の回数の +上限で次々にアカウントを替えて続ける正しい替えでは当たらない(短くても数を足さず、それまでの数はそのまま残す)。 +起動から 120 秒以上動いたセグメントがあれば、数を 0 に戻す。1 日の起動の回数の 上限は持たない。`ndf relay restart` は名前つきのラッパーの数(`relay.max-named`)だけで断り、起動の回数では断らない。 `NDF_RELAY_SPIN` は 0 以上の数で、0 で検出を切る。数でない値と負の値は誤りになる(ラッパーを起動せず、`ndf relay restart` は対象を止めずに断る)。 From c69255d1e6b3cef4440382d88baa74adb44d9344 Mon Sep 17 00:00:00 2001 From: "takemi.ohama" Date: Sat, 21 Nov 2026 23:19:52 +0000 Subject: [PATCH 04/12] =?UTF-8?q?Fix:=20=E5=86=8D=E8=B5=B7=E5=8B=95?= =?UTF-8?q?=E3=83=AB=E3=83=BC=E3=83=97=E3=81=AE=E6=A1=88=E5=86=85=E3=82=92?= =?UTF-8?q?=E7=AB=AF=E6=9C=AB=E3=81=AE=E3=83=A9=E3=83=83=E3=83=91=E3=83=BC?= =?UTF-8?q?=E3=81=AF=20ndf=20relay=20run=20--resume=E3=80=81=E5=90=8D?= =?UTF-8?q?=E5=89=8D=E3=81=A4=E3=81=8D=E3=81=AF=20tmux=20=E3=81=AE?= =?UTF-8?q?=E5=A4=96=E3=81=AE=20ndf=20relay=20restart=20=E3=81=AB=E3=81=99?= =?UTF-8?q?=E3=82=8B=EF=BC=88#3604=20#3864=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- .../development-workflow/references/relay.md | 2 +- plugins/ndf/src/ndf/domains/relay/wrapper.py | 13 +++++++++++-- .../tests/domains/relay/test_relay_wrapper.py | 19 ++++++++++++++++--- 3 files changed, 28 insertions(+), 6 deletions(-) diff --git a/plugins/ndf/skills/development-workflow/references/relay.md b/plugins/ndf/skills/development-workflow/references/relay.md index 854b2c64f..5d822f20f 100644 --- a/plugins/ndf/skills/development-workflow/references/relay.md +++ b/plugins/ndf/skills/development-workflow/references/relay.md @@ -392,7 +392,7 @@ claude のアカウントを 2 つ以上登録しておくと、利用上限で | `プラグインを更新できなかった(<理由>)。<バージョン> で次のセグメントを起動する` | 更新に失敗した。ラッパーは止まらず、そのバージョンで次のセグメントを起動した | 何もしなくてよい。ラッパーが次のカットポイントで更新を打ち直す | | `メジャーバージョンが <ラッパー> から <起動先> に変わった。次のセグメントを起動しない。…` | ラッパーは終わった(終了コード 3)。`relay.root` は起動先へ向け直してある | 1 行の案内どおり `claude` を打ち直し、conductor のブロックの中身を最初の入力にする | | `子の claude を起動できない(<理由>)` | ラッパーは終わった(終了コード 3)。子は起動していない | 理由(作業ディレクトリが無い・`claude` が PATH に無いなど)を直してから、conductor のブロックの中身で `claude` を打ち直す | -| `起動から <秒> 秒未満で次のセグメントへ移ったセグメントが <数> つ続いた(再起動ループ)。次のセグメントを起動しない。…` | 再起動ループの検出(「[上限](#上限)」)に当たった。今のセッションは動いたまま | 原因を直してから `/exit` し、`ndf relay` で起動し直す | +| `起動から <秒> 秒未満で次のセグメントへ移ったセグメントが <数> つ続いた(再起動ループ)。次のセグメントを起動しない。…` | 再起動ループの検出(「[上限](#上限)」)に当たった。今のセッションは動いたまま | 原因を直してから起動し直す。端末で打ったラッパーは `/exit` し、1 行の案内どおり `ndf relay run --resume <セッション ID>` で同じ会話を続ける。`ndf relay spawn` で起動した名前つきのラッパーは、1 行の案内どおり tmux の外から `ndf relay restart <名前>` を打つ | | 上の 5 つ以外(`ndf-relay: <理由>`) | ラッパーは終わった。終了コードは停止理由の種類(`contracts/causes.json`)のとおり。再起動ループの検出で、子が終わった後に止まったときもこの行になる(終了コードは子の終了コード) | 理由を直してから、conductor のブロックの中身で `claude` を起動する | ## fork したセッションで進めたとき diff --git a/plugins/ndf/src/ndf/domains/relay/wrapper.py b/plugins/ndf/src/ndf/domains/relay/wrapper.py index 9f23759c5..ecb777e72 100644 --- a/plugins/ndf/src/ndf/domains/relay/wrapper.py +++ b/plugins/ndf/src/ndf/domains/relay/wrapper.py @@ -84,8 +84,11 @@ # 再起動ループの検出に当たり、子が動いている間に一度だけ端末へ出す 1 行(#3864 の決定 13) SPIN_LINE = ( "ndf-relay: 起動から {seconds:g} 秒未満で次のセグメントへ移ったセグメントが {count} つ続いた(再起動ループ)。" - "次のセグメントを起動しない。原因を直してから /exit し、ndf relay で起動し直す" + "次のセグメントを起動しない。{again}" ) +# SPIN_LINE の続け方。端末のラッパーは同じ会話を run で続け、名前つきのラッパー(spawn)は tmux の外から restart で起動し直す +SPIN_AGAIN_RUN = "原因を直してから /exit し、ndf relay run --resume {session} で同じ会話を続ける" +SPIN_AGAIN_NAMED = "原因を直してから、tmux の外で ndf relay restart {name} を打って起動し直す" # 次のセグメントを起動する手(セグメントの終わりの時刻を書く) LAUNCHES = frozenset({"switch", "account", "restart", "handover"}) @@ -490,6 +493,12 @@ def _on_handover(self, step: switch_decide.Step, sec: Section) -> Optional[Ended def _on_finish(self, step: switch_decide.Step, sec: Section) -> Optional[Ended]: return Ended("", step.reason) + def _spin_again(self, sec: Section) -> str: + """SPIN_LINE の続け方。spawn で起動した名前つきのラッパー(`NDF_RELAY_SPAWNED`)なら restart、端末のラッパーなら run を案内する。""" + if self.s.environ.get("NDF_RELAY_SPAWNED") == "1": + return SPIN_AGAIN_NAMED.format(name=self.s.name) + return SPIN_AGAIN_RUN.format(session=sec.session_id) + def _on_spin(self, step: switch_decide.Step, sec: Section) -> Optional[Ended]: """再起動ループの検出に当たった手。次のセグメントを起動しない(#3864 の決定 13)。 @@ -501,7 +510,7 @@ def _on_spin(self, step: switch_decide.Step, sec: Section) -> Optional[Ended]: self.spin_held = True if not self.spin_told: self.spin_told = True - self._say(SPIN_LINE.format(seconds=self.s.spin.seconds, count=self.s.spin.count)) + self._say(SPIN_LINE.format(seconds=self.s.spin.seconds, count=self.s.spin.count, again=self._spin_again(sec))) self._log({"kind": "stop", "cause": "spin", "reason": step.reason}) return None diff --git a/plugins/ndf/tests/domains/relay/test_relay_wrapper.py b/plugins/ndf/tests/domains/relay/test_relay_wrapper.py index 1db095169..d72369c9d 100644 --- a/plugins/ndf/tests/domains/relay/test_relay_wrapper.py +++ b/plugins/ndf/tests/domains/relay/test_relay_wrapper.py @@ -186,8 +186,9 @@ def test_i15_spin_off_with_zero_seconds_keeps_restarting(tmp_path): assert ended.cause == "" and len(spawn.calls) == 5 -def _spin_run(tmp_path, children, clock, markers=None, prepare=None): - s = make_settings(tmp_path, spin=switch_decide.Spin(3, 120.0)) +def _spin_run(tmp_path, children, clock, markers=None, prepare=None, environ=None): + extra = {"environ": {**make_settings(tmp_path).environ, **environ}} if environ else {} + s = make_settings(tmp_path, spin=switch_decide.Spin(3, 120.0), **extra) spawn = Spawner(children, markers) out = io.BytesIO() w = wrapper.Wrapper(s, spawn=spawn, clock=clock, out=out) @@ -201,7 +202,19 @@ def _spin_run(tmp_path, children, clock, markers=None, prepare=None): return ended, spawn, w, out.getvalue().decode() -SPIN_SHOWN = wrapper.SPIN_LINE.format(seconds=120.0, count=3) +SPIN_SHOWN = wrapper.SPIN_LINE.split("{again}")[0].format(seconds=120.0, count=3) + + +def test_i15_spin_line_tells_a_command_that_runs_for_the_wrapper_kind(tmp_path): + # 決定 13・I15(検出): 端末のラッパーには同じ会話を続ける ndf relay run --resume を、spawn で起動した名前つきの + # ラッパーには tmux の外から打つ ndf relay restart <名前> を案内する(必須のサブコマンドの無い ndf relay を出さない) + children = [FakeChild([], None), FakeChild([], None), FakeChild([b""] * 10, 0), FakeChild([], 0)] + _, spawn, _, shown = _spin_run(tmp_path, children, Clock(), markers={0: "/goal 2", 1: "/goal 3", 2: "/goal 4"}) + assert f"ndf relay run --resume {spawn.calls[2][0][2]} で同じ会話を続ける" in shown + children = [FakeChild([], None), FakeChild([], None), FakeChild([b""] * 10, 0), FakeChild([], 0)] + named = {"NDF_RELAY_SPAWNED": "1"} + _, _, _, shown = _spin_run(tmp_path / "n", children, Clock(), markers={0: "/goal 2", 1: "/goal 3", 2: "/goal 4"}, environ=named) + assert "tmux の外で ndf relay restart t1 を打って起動し直す" in shown and "ndf relay run" not in shown def test_i15_spin_keeps_relaying_a_live_child_and_writes_one_stop_row(tmp_path): From 5d3648b8d91b358f62ceb3157895ff66c35b33cc Mon Sep 17 00:00:00 2001 From: "takemi.ohama" Date: Sat, 21 Nov 2026 23:24:05 +0000 Subject: [PATCH 05/12] =?UTF-8?q?Fix:=20=E5=86=8D=E8=B5=B7=E5=8B=95?= =?UTF-8?q?=E3=83=AB=E3=83=BC=E3=83=97=E3=81=AE=E6=A1=88=E5=86=85=E3=82=92?= =?UTF-8?q?=E3=80=81=E8=B5=B7=E5=8B=95=E6=99=82=E3=81=AE=E5=BC=95=E6=95=B0?= =?UTF-8?q?=E3=82=92=E5=BC=95=E3=81=8D=E7=B6=99=E3=81=84=E3=81=A7=20quote?= =?UTF-8?q?=20=E3=81=97=E3=81=9F=20--resume=20=E3=81=AE=E3=82=B3=E3=83=9E?= =?UTF-8?q?=E3=83=B3=E3=83=89=E3=81=AB=E3=81=97=E3=80=81=E5=90=8D=E5=89=8D?= =?UTF-8?q?=E3=81=A4=E3=81=8D=E3=81=AF=20/exit=20=E5=BE=8C=E3=81=AE=20spaw?= =?UTF-8?q?n=20=E3=81=AB=E3=81=99=E3=82=8B=EF=BC=88#3604=20#3864=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 端末のラッパー: ndf relay run --resume に、すべてのセッションに付ける引数(権限の制約など)を足す - 名前つきのラッパー: restart(登録簿の最初の作業指示を流し直す)でなく、作業を保存して /exit した後に 同じ名前・作業ディレクトリ・役割・計画で ndf relay spawn -- --resume … を打つ - コマンドは shlex.join で語ごとに quote し、空白やシェルの構文を含む再開先も 1 語で渡す - 案内のコマンドを CLI のパーサーへ通し、制約と再開先がそのまま戻ることを確かめる Co-Authored-By: Claude Opus 5.5 --- .../development-workflow/references/relay.md | 2 +- plugins/ndf/src/ndf/domains/relay/wrapper.py | 24 ++++++--- .../tests/domains/relay/test_relay_wrapper.py | 49 +++++++++++++++---- 3 files changed, 59 insertions(+), 16 deletions(-) diff --git a/plugins/ndf/skills/development-workflow/references/relay.md b/plugins/ndf/skills/development-workflow/references/relay.md index 5d822f20f..a2f32ce84 100644 --- a/plugins/ndf/skills/development-workflow/references/relay.md +++ b/plugins/ndf/skills/development-workflow/references/relay.md @@ -392,7 +392,7 @@ claude のアカウントを 2 つ以上登録しておくと、利用上限で | `プラグインを更新できなかった(<理由>)。<バージョン> で次のセグメントを起動する` | 更新に失敗した。ラッパーは止まらず、そのバージョンで次のセグメントを起動した | 何もしなくてよい。ラッパーが次のカットポイントで更新を打ち直す | | `メジャーバージョンが <ラッパー> から <起動先> に変わった。次のセグメントを起動しない。…` | ラッパーは終わった(終了コード 3)。`relay.root` は起動先へ向け直してある | 1 行の案内どおり `claude` を打ち直し、conductor のブロックの中身を最初の入力にする | | `子の claude を起動できない(<理由>)` | ラッパーは終わった(終了コード 3)。子は起動していない | 理由(作業ディレクトリが無い・`claude` が PATH に無いなど)を直してから、conductor のブロックの中身で `claude` を打ち直す | -| `起動から <秒> 秒未満で次のセグメントへ移ったセグメントが <数> つ続いた(再起動ループ)。次のセグメントを起動しない。…` | 再起動ループの検出(「[上限](#上限)」)に当たった。今のセッションは動いたまま | 原因を直してから起動し直す。端末で打ったラッパーは `/exit` し、1 行の案内どおり `ndf relay run --resume <セッション ID>` で同じ会話を続ける。`ndf relay spawn` で起動した名前つきのラッパーは、1 行の案内どおり tmux の外から `ndf relay restart <名前>` を打つ | +| `起動から <秒> 秒未満で次のセグメントへ移ったセグメントが <数> つ続いた(再起動ループ)。次のセグメントを起動しない。…` | 再起動ループの検出(「[上限](#上限)」)に当たった。今のセッションは動いたまま | 原因を直してから起動し直す。案内のコマンドは今のセッションを `--resume` で続け、起動時に付けた引数(`--permission-mode`・`--disallowedTools`・`--settings` など)を引き継ぐ(語ごとにシェルで quote 済み)。端末で打ったラッパーは `/exit` し、1 行の案内どおり `ndf relay run --resume <セッション ID> …` で同じ会話を続ける。`ndf relay spawn` で起動した名前つきのラッパーは、作業を保存してから `/exit` し、tmux の外から 1 行の案内どおり `ndf relay spawn --name <名前> --cwd <作業ディレクトリ> … -- --resume <セッション ID> …` を打つ(`ndf relay restart` は登録簿の最初の作業指示で起動し直すので使わない) | | 上の 5 つ以外(`ndf-relay: <理由>`) | ラッパーは終わった。終了コードは停止理由の種類(`contracts/causes.json`)のとおり。再起動ループの検出で、子が終わった後に止まったときもこの行になる(終了コードは子の終了コード) | 理由を直してから、conductor のブロックの中身で `claude` を起動する | ## fork したセッションで進めたとき diff --git a/plugins/ndf/src/ndf/domains/relay/wrapper.py b/plugins/ndf/src/ndf/domains/relay/wrapper.py index ecb777e72..241eed68d 100644 --- a/plugins/ndf/src/ndf/domains/relay/wrapper.py +++ b/plugins/ndf/src/ndf/domains/relay/wrapper.py @@ -23,6 +23,7 @@ import functools import os import select +import shlex import sys import time import uuid @@ -86,9 +87,10 @@ "ndf-relay: 起動から {seconds:g} 秒未満で次のセグメントへ移ったセグメントが {count} つ続いた(再起動ループ)。" "次のセグメントを起動しない。{again}" ) -# SPIN_LINE の続け方。端末のラッパーは同じ会話を run で続け、名前つきのラッパー(spawn)は tmux の外から restart で起動し直す -SPIN_AGAIN_RUN = "原因を直してから /exit し、ndf relay run --resume {session} で同じ会話を続ける" -SPIN_AGAIN_NAMED = "原因を直してから、tmux の外で ndf relay restart {name} を打って起動し直す" +# SPIN_LINE の続け方。どちらも今の会話を `--resume` で続け、すべてのセッションに付ける引数(権限の制約など)を引き継ぐ。 +# 名前つきのラッパー(spawn)は restart(登録簿の最初の引数で起動し直す)でなく、/exit の後に同じ名前で spawn し直す +SPIN_AGAIN_RUN = "原因を直してから /exit し、{command} で同じ会話を続ける" +SPIN_AGAIN_NAMED = "原因を直し、作業を保存してから /exit し、tmux の外で {command} を打って同じ会話から起動し直す" # 次のセグメントを起動する手(セグメントの終わりの時刻を書く) LAUNCHES = frozenset({"switch", "account", "restart", "handover"}) @@ -494,10 +496,20 @@ def _on_finish(self, step: switch_decide.Step, sec: Section) -> Optional[Ended]: return Ended("", step.reason) def _spin_again(self, sec: Section) -> str: - """SPIN_LINE の続け方。spawn で起動した名前つきのラッパー(`NDF_RELAY_SPAWNED`)なら restart、端末のラッパーなら run を案内する。""" + """SPIN_LINE の続け方。spawn で起動した名前つきのラッパー(`NDF_RELAY_SPAWNED`)なら spawn、端末のラッパーなら run を案内する。 + + どちらも今のセッションを `--resume` で続け、すべてのセッションに付ける引数(`args`。`--permission-mode`・ + `--disallowedTools`・`--settings` など)を引き継ぐ。名前つきは同じ名前・作業ディレクトリ・役割・計画で起動する + (restart は登録簿の最初の引数で起動し直し、今の会話を使わない)。コマンドは語ごとにシェルで quote する。 + """ + claude = ["--resume", sec.session_id, *self.s.args] if self.s.environ.get("NDF_RELAY_SPAWNED") == "1": - return SPIN_AGAIN_NAMED.format(name=self.s.name) - return SPIN_AGAIN_RUN.format(session=sec.session_id) + own = ["--name", self.s.name, "--cwd", str(self.s.cwd)] + for opt, key in (("--role", "NDF_RELAY_ROLE"), ("--plan", "NDF_RELAY_PLAN")): + value = self.s.environ.get(key) + own += [opt, value] if value else [] + return SPIN_AGAIN_NAMED.format(command=shlex.join(["ndf", "relay", "spawn", *own, "--", *claude])) + return SPIN_AGAIN_RUN.format(command=shlex.join(["ndf", "relay", "run", *claude])) def _on_spin(self, step: switch_decide.Step, sec: Section) -> Optional[Ended]: """再起動ループの検出に当たった手。次のセグメントを起動しない(#3864 の決定 13)。 diff --git a/plugins/ndf/tests/domains/relay/test_relay_wrapper.py b/plugins/ndf/tests/domains/relay/test_relay_wrapper.py index d72369c9d..46469467b 100644 --- a/plugins/ndf/tests/domains/relay/test_relay_wrapper.py +++ b/plugins/ndf/tests/domains/relay/test_relay_wrapper.py @@ -9,13 +9,16 @@ import io import json import os +import re +import shlex import subprocess import sys import time from pathlib import Path import pytest -from ndf.domains.relay import accounts, install, markers, registry, signals, stop_signal, switch_decide, wrapper +from ndf.domains.relay import accounts, claude_args, install, markers, registry, signals, stop_signal, switch_decide, wrapper +from ndf.domains.relay import cli as relay_cli from ndf.domains.relay.account_decide import Usage from ndf.domains.relay.plugin_update import Target, Updated from relay_children import ( @@ -186,9 +189,9 @@ def test_i15_spin_off_with_zero_seconds_keeps_restarting(tmp_path): assert ended.cause == "" and len(spawn.calls) == 5 -def _spin_run(tmp_path, children, clock, markers=None, prepare=None, environ=None): +def _spin_run(tmp_path, children, clock, markers=None, prepare=None, environ=None, **changes): extra = {"environ": {**make_settings(tmp_path).environ, **environ}} if environ else {} - s = make_settings(tmp_path, spin=switch_decide.Spin(3, 120.0), **extra) + s = make_settings(tmp_path, spin=switch_decide.Spin(3, 120.0), **extra, **changes) spawn = Spawner(children, markers) out = io.BytesIO() w = wrapper.Wrapper(s, spawn=spawn, clock=clock, out=out) @@ -205,16 +208,44 @@ def _spin_run(tmp_path, children, clock, markers=None, prepare=None, environ=Non SPIN_SHOWN = wrapper.SPIN_LINE.split("{again}")[0].format(seconds=120.0, count=3) +LIMITED = ("--disallowedTools", "Bash", "--permission-mode", "plan", "--settings", "/tmp/a b.json") + + +def _resumed(command: str, action: str): + """案内のコマンドを貼り付けたときに `ndf relay ` が読む値(ndf の引数と、ラッパーの設定のうちセッションごとの引数)。""" + words = shlex.split(command) + assert words[:3] == ["ndf", "relay", action] + args = relay_cli._parse(words[2:]) + parsed = claude_args.parse(args.rest, {}, True) + assert parsed.passthrough is None # ラッパーを通して起動する + return args, relay_cli._session_args(args.rest, parsed) + + def test_i15_spin_line_tells_a_command_that_runs_for_the_wrapper_kind(tmp_path): # 決定 13・I15(検出): 端末のラッパーには同じ会話を続ける ndf relay run --resume を、spawn で起動した名前つきの - # ラッパーには tmux の外から打つ ndf relay restart <名前> を案内する(必須のサブコマンドの無い ndf relay を出さない) + # ラッパーには /exit の後に tmux の外から同じ名前で起動し直す ndf relay spawn -- --resume を案内する。どちらも起動時の + # 権限の制約(--disallowedTools など)を引き継ぎ、restart(登録簿の最初の作業指示を流し直す)を案内しない + marks = {0: "/goal 2", 1: "/goal 3", 2: "/goal 4"} children = [FakeChild([], None), FakeChild([], None), FakeChild([b""] * 10, 0), FakeChild([], 0)] - _, spawn, _, shown = _spin_run(tmp_path, children, Clock(), markers={0: "/goal 2", 1: "/goal 3", 2: "/goal 4"}) - assert f"ndf relay run --resume {spawn.calls[2][0][2]} で同じ会話を続ける" in shown + _, spawn, _, shown = _spin_run(tmp_path, children, Clock(), markers=marks, args=LIMITED) + _, got = _resumed(re.search(r"/exit し、(.+) で同じ会話を続ける", shown).group(1), "run") + assert got == {"args": LIMITED, "first_args": (), "first_session": spawn.calls[2][0][2], "first_resume": True} children = [FakeChild([], None), FakeChild([], None), FakeChild([b""] * 10, 0), FakeChild([], 0)] - named = {"NDF_RELAY_SPAWNED": "1"} - _, _, _, shown = _spin_run(tmp_path / "n", children, Clock(), markers={0: "/goal 2", 1: "/goal 3", 2: "/goal 4"}, environ=named) - assert "tmux の外で ndf relay restart t1 を打って起動し直す" in shown and "ndf relay run" not in shown + named = {"NDF_RELAY_SPAWNED": "1", "NDF_RELAY_ROLE": "worker", "NDF_RELAY_PLAN": "p1"} + _, spawn, _, shown = _spin_run(tmp_path / "n", children, Clock(), markers=marks, environ=named, args=LIMITED) + assert "作業を保存してから /exit し" in shown and "relay restart" not in shown + args, got = _resumed(re.search(r"tmux の外で (.+) を打って同じ会話から起動し直す", shown).group(1), "spawn") + assert (args.name, args.cwd, args.role, args.plan) == ("t1", str(tmp_path / "n"), "worker", "p1") + assert got == {"args": LIMITED, "first_args": (), "first_session": spawn.calls[2][0][2], "first_resume": True} + + +def test_i15_spin_command_keeps_a_resume_value_with_spaces_and_shell_syntax_as_one_word(tmp_path): + # 決定 13・I15(検出): --resume の値は UUID とは限らない。空白やシェルの構文を含む値も、貼り付けたときに 1 語のまま渡る + odd = "release prep today; touch $(pwd)/x `id`" + w = wrapper.Wrapper(make_settings(tmp_path, args=LIMITED)) + line = w._spin_again(wrapper.Section(1, odd, None, None, "l")) + _, got = _resumed(re.search(r"/exit し、(.+) で同じ会話を続ける", line).group(1), "run") + assert (got["first_session"], got["first_resume"], got["args"]) == (odd, True, LIMITED) def test_i15_spin_keeps_relaying_a_live_child_and_writes_one_stop_row(tmp_path): From d39e544eb66faffe1675f7d349e8c9807ae20438 Mon Sep 17 00:00:00 2001 From: "takemi.ohama" Date: Sat, 21 Nov 2026 23:34:58 +0000 Subject: [PATCH 06/12] =?UTF-8?q?Fix:=20=E5=86=8D=E8=B5=B7=E5=8B=95?= =?UTF-8?q?=E3=83=AB=E3=83=BC=E3=83=97=E3=81=AE=E6=A1=88=E5=86=85=E3=82=92?= =?UTF-8?q?=E3=80=810600=20=E3=81=AE=E5=86=8D=E9=96=8B=E3=81=AE=E5=80=A4?= =?UTF-8?q?=E3=82=92=E8=AA=AD=E3=82=80=201=20=E8=A1=8C=E3=81=AE=20--again?= =?UTF-8?q?=20=E3=81=AB=E3=81=97=E3=80=81=E7=A7=98=E5=AF=86=E3=82=92?= =?UTF-8?q?=E5=87=BA=E3=81=95=E3=81=9A=E7=99=BB=E9=8C=B2=E7=B0=BF=E3=81=A8?= =?UTF-8?q?=E3=82=A2=E3=82=AB=E3=82=A6=E3=83=B3=E3=83=88=E3=82=92=E4=BF=9D?= =?UTF-8?q?=E3=81=A4=EF=BC=88#3604=20#3864=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - ラッパーは再開の値(セッション 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 --- .../development-workflow/references/relay.md | 2 +- plugins/ndf/src/ndf/domains/relay/cli.py | 49 +++++++++-- plugins/ndf/src/ndf/domains/relay/hub.py | 33 ++++++-- plugins/ndf/src/ndf/domains/relay/registry.py | 30 +++++++ plugins/ndf/src/ndf/domains/relay/wrapper.py | 48 +++++++---- .../ndf/tests/domains/relay/test_relay_hub.py | 25 ++++++ .../tests/domains/relay/test_relay_wrapper.py | 83 ++++++++++++++----- 7 files changed, 222 insertions(+), 48 deletions(-) diff --git a/plugins/ndf/skills/development-workflow/references/relay.md b/plugins/ndf/skills/development-workflow/references/relay.md index a2f32ce84..b9f8802a1 100644 --- a/plugins/ndf/skills/development-workflow/references/relay.md +++ b/plugins/ndf/skills/development-workflow/references/relay.md @@ -392,7 +392,7 @@ claude のアカウントを 2 つ以上登録しておくと、利用上限で | `プラグインを更新できなかった(<理由>)。<バージョン> で次のセグメントを起動する` | 更新に失敗した。ラッパーは止まらず、そのバージョンで次のセグメントを起動した | 何もしなくてよい。ラッパーが次のカットポイントで更新を打ち直す | | `メジャーバージョンが <ラッパー> から <起動先> に変わった。次のセグメントを起動しない。…` | ラッパーは終わった(終了コード 3)。`relay.root` は起動先へ向け直してある | 1 行の案内どおり `claude` を打ち直し、conductor のブロックの中身を最初の入力にする | | `子の claude を起動できない(<理由>)` | ラッパーは終わった(終了コード 3)。子は起動していない | 理由(作業ディレクトリが無い・`claude` が PATH に無いなど)を直してから、conductor のブロックの中身で `claude` を打ち直す | -| `起動から <秒> 秒未満で次のセグメントへ移ったセグメントが <数> つ続いた(再起動ループ)。次のセグメントを起動しない。…` | 再起動ループの検出(「[上限](#上限)」)に当たった。今のセッションは動いたまま | 原因を直してから起動し直す。案内のコマンドは今のセッションを `--resume` で続け、起動時に付けた引数(`--permission-mode`・`--disallowedTools`・`--settings` など)を引き継ぐ(語ごとにシェルで quote 済み)。端末で打ったラッパーは `/exit` し、1 行の案内どおり `ndf relay run --resume <セッション ID> …` で同じ会話を続ける。`ndf relay spawn` で起動した名前つきのラッパーは、作業を保存してから `/exit` し、tmux の外から 1 行の案内どおり `ndf relay spawn --name <名前> --cwd <作業ディレクトリ> … -- --resume <セッション ID> …` を打つ(`ndf relay restart` は登録簿の最初の作業指示で起動し直すので使わない) | +| `起動から <秒> 秒未満で次のセグメントへ移ったセグメントが <数> つ続いた(再起動ループ)。次のセグメントを起動しない。…` | 再起動ループの検出(「[上限](#上限)」)に当たった。今のセッションは動いたまま | 原因を直してから起動し直す。ラッパーは再開の値(今のセッション ID・起動時に付けた引数(`--permission-mode`・`--disallowedTools`・`--settings` など)・今のアカウント・作業ディレクトリ・役割・計画)を `<状態の保存先>/relay/wrappers/<名前>/again.json` へ 0600 で書き、案内には名前と `--again` だけを出す(引数の秘密や複数行の値を画面に出さない)。端末で打ったラッパーは `/exit` し、1 行の案内どおり `ndf relay run --name <名前> --again` で同じ会話を続ける。`ndf relay spawn` で起動した名前つきのラッパーは、作業を保存してから `/exit` し、tmux の外から 1 行の案内どおり `ndf relay spawn --name <名前> --again` を打つ(`ndf relay restart` は登録簿の最初の作業指示で起動し直すので使わない。`--again` は登録簿の引数を書き換えないので、後の restart は元の作業指示で起動する)。どちらもアカウントを選び直さず、再開の値は起動できたら消える | | 上の 5 つ以外(`ndf-relay: <理由>`) | ラッパーは終わった。終了コードは停止理由の種類(`contracts/causes.json`)のとおり。再起動ループの検出で、子が終わった後に止まったときもこの行になる(終了コードは子の終了コード) | 理由を直してから、conductor のブロックの中身で `claude` を起動する | ## fork したセッションで進めたとき diff --git a/plugins/ndf/src/ndf/domains/relay/cli.py b/plugins/ndf/src/ndf/domains/relay/cli.py index 0b8d83dff..bc9ceebc0 100644 --- a/plugins/ndf/src/ndf/domains/relay/cli.py +++ b/plugins/ndf/src/ndf/domains/relay/cli.py @@ -179,7 +179,12 @@ def _hub(args: argparse.Namespace) -> int: if args.action == "ls": rows = hub.listing(ctx) return result.emit(result.result(TOOL, result.OK, f"名前つきのラッパー: {len(rows)} 本", items=rows)) - if args.action == "spawn": + if args.action == "spawn" and args.again: + refused = _again_refused(args, ("cwd", "role", "plan")) + if refused: + return result.emit(result.stopped(TOOL, "invalid", refused)) + req = {"kind": "spawn", "name": args.name, "again": True} + elif args.action == "spawn": cwd = str(Path(args.cwd).resolve()) if args.cwd else os.getcwd() req = {"kind": "spawn", "name": args.name, "cwd": cwd, "role": args.role, "plan": args.plan, "args": args.rest} elif args.action == "stop" and args.all: @@ -257,8 +262,27 @@ def _session_args(rest: list[str], parsed: Optional[claude_args.Parsed]) -> dict } -def wrapper_settings(name: str, rest: list[str], parsed: Optional[claude_args.Parsed] = None) -> wrapper.Settings: - """`parsed` があれば引数をセッションごとに分けて渡す(無ければ `rest` をすべてのセッションに付ける)。""" +def _again_refused(args: argparse.Namespace, others: tuple[str, ...]) -> str: + """`--again` と一緒に渡せない値があれば断る理由(再開の値がすべてを持つ)。無ければ空。""" + if not args.name: + return "--again には再起動ループの案内に出た --name を付ける" + given = [f"--{k}" for k in others if getattr(args, k, None)] + (["claude の引数"] if args.rest else []) + return f"--again には {'・'.join(given)} を付けない(再開の値を使う)" if given else "" + + +def _again_rest(name: str) -> tuple[list[str], Optional[str]]: + """再開の値(`registry.read_again`)から claude の引数(`--resume ` と引き継ぐ引数)とアカウントを組む。""" + saved = registry.read_again(registry.wrapper_dir(identity.load().state_dir, name)) + return ["--resume", saved["session_id"], *saved["args"]], saved["account"] + + +def wrapper_settings( + name: str, rest: list[str], parsed: Optional[claude_args.Parsed] = None, again: bool = False, account: Optional[str] = None +) -> wrapper.Settings: + """`parsed` があれば引数をセッションごとに分けて渡す(無ければ `rest` をすべてのセッションに付ける)。 + + `again`(`--again` の再開)なら最初のセグメントでアカウントを選び直さず `account`(None は既定のログイン)を使う。 + """ ident = identity.load() environ = dict(os.environ) cwd, cwd_lost = _cwd(environ) @@ -289,6 +313,8 @@ def wrapper_settings(name: str, rest: list[str], parsed: Optional[claude_args.Pa ask_plan=lane_question.plan_asker(environ, name, cwd, ident.root, limits.seconds("relay.lanes-ask")), update=updater, confirm=updater.confirm, + again=again, + first_account=account, ) @@ -305,6 +331,12 @@ def _passthrough(rest: list[str], parsed: claude_args.Parsed) -> int: def _run(args: argparse.Namespace) -> int: + account: Optional[str] = None + if args.again: + refused = _again_refused(args, ("prompt",)) + if refused: + return result.emit(result.stopped(TOOL, "invalid", refused)) + args.rest, account = _again_rest(args.name) name = args.name or os.environ.get("NDF_RELAY_NAME") or f"w{os.getpid()}" parsed = claude_args.parse(args.rest, os.environ, sys.stdin.isatty() and sys.stdout.isatty()) if parsed.passthrough: @@ -315,7 +347,9 @@ def _run(args: argparse.Namespace) -> int: tty.setraw(sys.stdin.fileno()) try: w = wrapper.Wrapper( - wrapper_settings(name, args.rest, parsed), out=sys.stdout.buffer, stdin_fd=sys.stdin.fileno() if tty_in else None + wrapper_settings(name, args.rest, parsed, args.again, account), + out=sys.stdout.buffer, + stdin_fd=sys.stdin.fileno() if tty_in else None, ) ended = w.run(args.prompt or parsed.prompt or "") # noqa: NDF501 利用者の入力: 最初の 1 行が無ければ空の入力欄で始める finally: @@ -346,6 +380,7 @@ def _parser() -> argparse.ArgumentParser: cli_account.parser(sub, COMMANDS["account"]) for name in ("run", "spawn"): p[name].add_argument("--name") + p[name].add_argument("--again", action="store_true", help="再起動ループの案内のとおり、書き置いた再開の値で同じ会話を続ける") p[name].add_argument("rest", nargs=argparse.REMAINDER) p["run"].add_argument("--prompt") for opt in ("--cwd", "--role", "--plan"): @@ -359,6 +394,8 @@ def _parser() -> argparse.ArgumentParser: OWN_OPTIONS = {"run": ("--name", "--prompt"), "spawn": ("--name", "--cwd", "--role", "--plan")} +# 値を取らない ndf のオプション(run・spawn の両方) +OWN_FLAGS = ("--again",) def _split_claude_args(argv: list[str]) -> list[str]: @@ -373,7 +410,9 @@ def _split_claude_args(argv: list[str]) -> list[str]: word = argv[i] if word in ("-h", "--help", "--"): return argv - if word in own: + if word in OWN_FLAGS: + i += 1 + elif word in own: i += 2 elif word.split("=", 1)[0] in own: i += 1 diff --git a/plugins/ndf/src/ndf/domains/relay/hub.py b/plugins/ndf/src/ndf/domains/relay/hub.py index 09c1728e3..68166f11e 100644 --- a/plugins/ndf/src/ndf/domains/relay/hub.py +++ b/plugins/ndf/src/ndf/domains/relay/hub.py @@ -214,17 +214,34 @@ def spawn(ctx: Context, req: Mapping[str, Any]) -> Outcome: refused = _refused(hub_decide.spawn(lanes), "refused") if refused is not None: return refused - entry = {k: req.get(k) for k in ("cwd", "args", "role", "plan")} + again = bool(req.get("again")) + if again: + entry, kept = _again_entries(ctx, name, entries.get(name)) + else: + entry = kept = {k: req.get(k) for k in ("cwd", "args", "role", "plan")} env = _checked_env(ctx, name, entry) if isinstance(env, Outcome): return env - got = _launch(ctx, name, entry, env) + got = _launch(ctx, name, entry, env, again=again) if got.ok: - entries[name] = {**entry, "version": ctx.version} + entries[name] = {**kept, "version": ctx.version} registry.save_registry(hub_dir(ctx.state_dir), entries) return got +def _again_entries(ctx: Context, name: str, registered: Optional[Mapping[str, Any]]) -> tuple[dict[str, Any], dict[str, Any]]: + """`--again` の spawn で(起動に使う項目, 登録簿に残す項目)。 + + 起動は再開の値(`registry.read_again`)の作業ディレクトリ・役割・計画で行い、引数は後継のラッパーが再開の値から読む。 + 登録簿には登録時の項目(最初の作業指示を含む引数)を残し、1 回だけの `--resume` で上書きしない(restart が元の指示で + 起動し直せる)。登録簿に無ければ、再開の値の引き継ぐ引数で登録する。 + """ + saved = registry.read_again(registry.wrapper_dir(ctx.state_dir, name)) + entry = {"cwd": saved["cwd"], "args": [], "role": saved["role"], "plan": saved["plan"]} + kept = _current(registered) if registered is not None else {**entry, "args": list(saved["args"])} + return entry, kept + + def restart(ctx: Context, name: str) -> Outcome: """止める前に上限とバージョンを判定し、通ったときだけ止めてから起動する。""" entries = registry.read_registry(hub_dir(ctx.state_dir)) @@ -328,15 +345,19 @@ def spawn_env(environ: Mapping[str, str], state_dir: Path, name: str, entry: Map return env -def _launch(ctx: Context, name: str, entry: Mapping[str, Any], env: Mapping[str, str]) -> Outcome: - """確かめ済みの環境 `env`(`_checked_env`)で tmux のセッションを作り、ラッパーが立つのを確かめる。""" +def _launch(ctx: Context, name: str, entry: Mapping[str, Any], env: Mapping[str, str], again: bool = False) -> Outcome: + """確かめ済みの環境 `env`(`_checked_env`)で tmux のセッションを作り、ラッパーが立つのを確かめる。 + + `again` なら claude の引数を渡さず `--again` で起動する(後継が 0600 の再開の値から読む。引数を tmux のコマンドに載せない)。 + """ ndf = identity.entrypoint(ctx.plugin_root) if not ndf.is_file(): facts = hub_decide.Started(False, False, False) return Outcome(False, hub_decide.started(facts, name).reason, "precondition") cwd = Path(str(entry.get("cwd") or ctx.state_dir)) args = [str(a) for a in entry.get("args") or []] # noqa: NDF501 利用者の入力: 引数が無ければ claude の既定 - started = ctx.tmux.start(name, cwd, [str(ndf), "relay", "run", "--name", name, "--", *args], env) + tail = ["--again"] if again else ["--", *args] + started = ctx.tmux.start(name, cwd, [str(ndf), "relay", "run", "--name", name, *tail], env) if not started.ok: return Outcome(False, f"{name} の tmux のセッションを作れない: {started.detail}", "precondition") return _confirm(ctx, name) diff --git a/plugins/ndf/src/ndf/domains/relay/registry.py b/plugins/ndf/src/ndf/domains/relay/registry.py index c77c28dde..26723aea8 100644 --- a/plugins/ndf/src/ndf/domains/relay/registry.py +++ b/plugins/ndf/src/ndf/domains/relay/registry.py @@ -8,6 +8,7 @@ | `wrapper.json` | 名前・バージョン・状態(`running`・`stalled`・`waiting`・`stopped`)・理由・セグメント・アカウント | | `log.jsonl` | セグメントの切り替えと、切り替えない理由が変わったときの 1 行 | | `next.json`・`question.json` | hook が書くシグナルファイル(`signals`) | +| `again.json` | 再起動ループの検出で止めたときに書く、1 回だけの再開の値(セッション ID・引数・アカウント・作業ディレクトリ・役割・計画)。引数に秘密を含みうるので 0600 で書き、案内のコマンドには載せない(`--again` が読む) | 旧い NDF(10.x)のラッパーは `<旧い状態の根>/relay/<作業ディレクトリ>/relay.lock` を持つ。旧い状態の根は `NDF_STATE_HOME` → `$XDG_STATE_HOME/ndf` → `~/.local/state/ndf` の順で決まる(旧い NDF と同じ規則)。 @@ -27,6 +28,8 @@ LOCK_FILE = "relay.lock" STATE_FILE = "wrapper.json" LOG_FILE = "log.jsonl" +AGAIN_FILE = "again.json" +AGAIN_MODE = 0o600 # リレーハブの保存先(`hub.hub_dir`)の下の登録簿 REGISTRY_FILE = "registry.json" @@ -67,6 +70,33 @@ def append_log(directory: Path, row: Mapping[str, Any]) -> None: signals.append_jsonl(directory / LOG_FILE, row) +def write_again(directory: Path, data: Mapping[str, Any]) -> None: + """1 回だけの再開の値を 0600 で書く(引数に認証のヘッダーや非公開の本文を含みうる)。""" + signals.replace_text(directory / AGAIN_FILE, json.dumps(dict(data), ensure_ascii=False), mode=AGAIN_MODE) + + +def read_again(directory: Path) -> dict[str, Any]: + """`write_again` が書いた再開の値。無い・読めない・形が違えば `RegistryError`。""" + path = directory / AGAIN_FILE + try: + data = json.loads(path.read_text(encoding="utf-8")) + except FileNotFoundError as exc: + raise RegistryError(f"再開の値が無い({path})。再起動ループの案内が出たラッパーの名前で打つ") from exc + except ValueError as exc: + raise RegistryError(f"再開の値を読めない({path}): {exc}") from exc + ok = ( + isinstance(data, dict) + and isinstance(data.get("session_id"), str) + and isinstance(data.get("args"), list) + and all(isinstance(a, str) for a in data["args"]) + and isinstance(data.get("cwd"), str) + and all(data.get(k) is None or isinstance(data.get(k), str) for k in ("account", "role", "plan")) + ) + if not ok: + raise RegistryError(f"再開の値の形が違う({path})") + return data + + def read_registry(hub: Path) -> dict[str, dict[str, Any]]: """リレーハブの保存先 `hub` の登録簿の行。無ければ空、読めない・形が違えば `RegistryError`。""" path = hub / REGISTRY_FILE diff --git a/plugins/ndf/src/ndf/domains/relay/wrapper.py b/plugins/ndf/src/ndf/domains/relay/wrapper.py index 241eed68d..1c3c7c7d6 100644 --- a/plugins/ndf/src/ndf/domains/relay/wrapper.py +++ b/plugins/ndf/src/ndf/domains/relay/wrapper.py @@ -87,10 +87,14 @@ "ndf-relay: 起動から {seconds:g} 秒未満で次のセグメントへ移ったセグメントが {count} つ続いた(再起動ループ)。" "次のセグメントを起動しない。{again}" ) -# SPIN_LINE の続け方。どちらも今の会話を `--resume` で続け、すべてのセッションに付ける引数(権限の制約など)を引き継ぐ。 +# SPIN_LINE の続け方。どちらも再開の値(`registry.AGAIN_FILE`)を読む `--again` で、今の会話を今のアカウントと +# すべてのセッションに付ける引数(権限の制約など)のまま続ける。引数は秘密や複数行の値を含みうるので画面に出さない。 # 名前つきのラッパー(spawn)は restart(登録簿の最初の引数で起動し直す)でなく、/exit の後に同じ名前で spawn し直す SPIN_AGAIN_RUN = "原因を直してから /exit し、{command} で同じ会話を続ける" SPIN_AGAIN_NAMED = "原因を直し、作業を保存してから /exit し、tmux の外で {command} を打って同じ会話から起動し直す" +# 案内のコマンド(名前は `registry.NAME_RE` の形だが、念のためシェルで quote する) +SPIN_AGAIN_COMMAND = "ndf relay {action} --name {name} --again" +SPIN_AGAIN_UNSAVED = "再開の値を書けない({why})。原因を直してから /exit し、起動時の引数に --resume {session} を足して起動し直す" # 次のセグメントを起動する手(セグメントの終わりの時刻を書く) LAUNCHES = frozenset({"switch", "account", "restart", "handover"}) @@ -106,6 +110,8 @@ class Settings: (`plugin_update.Updater`。None なら呼ばない。#3812)。 `cwd_lost` は設定を作るときに作業ディレクトリを読めなかったときの表示の文字列(None でなければ起動しない。#3842)。 `spin` は再起動ループの検出の閾値(`relay.spin`。#3864 の決定 13)。 + `again` が真なら最初のセグメントを再開の値(`--again`)で起動する。アカウントは選び直さず `first_account` + (None なら既定のログイン)を使い、起動できたら再開の値を消す(1 回だけ使う)。 """ state_dir: Path @@ -128,6 +134,8 @@ class Settings: update: Optional[Callable[[], plugin_update.Updated]] = None confirm: Optional[Callable[[], plugin_update.Target]] = None cwd_lost: Optional[str] = None + again: bool = False + first_account: Optional[str] = None @dataclass(frozen=True) @@ -135,6 +143,7 @@ class Launch: """セグメントを始める要求。`resume` が真なら `--resume` で同じ会話を続け、偽なら `--session-id` で新しく始める。 `kind` は前のセグメントを終えた手(`switch`・`account`・`restart`・`handover`。最初のセグメントは None)。 + `decided` が真なら `account` を選び直さない(None は既定のログイン。`session_env.child_env`)。 """ number: int @@ -143,6 +152,7 @@ class Launch: prompt: str resume: bool kind: Optional[str] = None + decided: bool = False @dataclass @@ -272,9 +282,12 @@ def _loop(self, prompt: str) -> Ended: # 利用者が --resume で続けた会話の途中では更新しない(I3) ended = self._before_start(update=not self.s.first_resume) if ended is None: - ended = self._start(Launch(1, first, accounts.chosen(self.s.environ, self.s.state_dir), prompt, resume=self.s.first_resume)) + account = self.s.first_account if self.s.again else accounts.chosen(self.s.environ, self.s.state_dir) + ended = self._start(Launch(1, first, account, prompt, resume=self.s.first_resume, decided=self.s.again)) if ended is not None: return self._end(ended) + if self.s.again: + (self.dir / registry.AGAIN_FILE).unlink(missing_ok=True) # 1 回だけの再開の値。起動できたら使い終わり while True: self._pump(self.s.tick) try: @@ -498,18 +511,25 @@ def _on_finish(self, step: switch_decide.Step, sec: Section) -> Optional[Ended]: def _spin_again(self, sec: Section) -> str: """SPIN_LINE の続け方。spawn で起動した名前つきのラッパー(`NDF_RELAY_SPAWNED`)なら spawn、端末のラッパーなら run を案内する。 - どちらも今のセッションを `--resume` で続け、すべてのセッションに付ける引数(`args`。`--permission-mode`・ - `--disallowedTools`・`--settings` など)を引き継ぐ。名前つきは同じ名前・作業ディレクトリ・役割・計画で起動する - (restart は登録簿の最初の引数で起動し直し、今の会話を使わない)。コマンドは語ごとにシェルで quote する。 + 再開の値(今のセッション・すべてのセッションに付ける引数 `args`・今のアカウント・作業ディレクトリ・役割・計画)を + 0600 のファイルへ書き、案内は名前と `--again` だけの 1 行にする(引数の秘密や複数行の値を画面に出さない)。 + 名前つきは同じ名前で spawn し直す(restart は登録簿の最初の引数で起動し直し、今の会話を使わない)。 """ - claude = ["--resume", sec.session_id, *self.s.args] - if self.s.environ.get("NDF_RELAY_SPAWNED") == "1": - own = ["--name", self.s.name, "--cwd", str(self.s.cwd)] - for opt, key in (("--role", "NDF_RELAY_ROLE"), ("--plan", "NDF_RELAY_PLAN")): - value = self.s.environ.get(key) - own += [opt, value] if value else [] - return SPIN_AGAIN_NAMED.format(command=shlex.join(["ndf", "relay", "spawn", *own, "--", *claude])) - return SPIN_AGAIN_RUN.format(command=shlex.join(["ndf", "relay", "run", *claude])) + again = { + "session_id": sec.session_id, + "args": list(self.s.args), + "account": sec.account, + "cwd": str(self.s.cwd), + "role": self.s.environ.get("NDF_RELAY_ROLE") or None, + "plan": self.s.environ.get("NDF_RELAY_PLAN") or None, + } + try: + registry.write_again(self.dir, again) + except OSError as exc: + return SPIN_AGAIN_UNSAVED.format(why=exc, session=shlex.quote(sec.session_id)) + named = self.s.environ.get("NDF_RELAY_SPAWNED") == "1" + command = SPIN_AGAIN_COMMAND.format(action="spawn" if named else "run", name=shlex.quote(self.s.name)) + return (SPIN_AGAIN_NAMED if named else SPIN_AGAIN_RUN).format(command=command) def _on_spin(self, step: switch_decide.Step, sec: Section) -> Optional[Ended]: """再起動ループの検出に当たった手。次のセグメントを起動しない(#3864 の決定 13)。 @@ -546,7 +566,7 @@ def _start(self, req: Launch) -> Optional[Ended]: 起動先の根が分かれば、子の `PATH` を `session_env.with_launched_ndf` で起動先のバージョンにそろえる(#3909)。 """ launch = uuid.uuid4().hex - env = session_env.child_env(self.s.environ, self.s.state_dir, req.account) + env = session_env.child_env(self.s.environ, self.s.state_dir, req.account, decided=req.decided) if self.launched_root is not None: env = session_env.with_launched_ndf(env, self.launched_root) env = {**env, **signals.launch_env(self.dir, launch)} diff --git a/plugins/ndf/tests/domains/relay/test_relay_hub.py b/plugins/ndf/tests/domains/relay/test_relay_hub.py index 76588bfe9..e605e6bae 100644 --- a/plugins/ndf/tests/domains/relay/test_relay_hub.py +++ b/plugins/ndf/tests/domains/relay/test_relay_hub.py @@ -370,3 +370,28 @@ def test_spawn_with_a_malformed_name_starts_no_tmux_session(ctx, name): # 名前の形を tmux を起動する前に確かめ、止める手段の無いセッションを残さない got = hub.submit(ctx, {"kind": "spawn", "name": name}) assert (got.ok, got.cause) == (False, "invalid") and ctx.tmux.started == [] + + +def test_i15_spawn_again_resumes_from_the_saved_values_and_keeps_the_registered_args(ctx): + # 決定 13・I15(検出): 再起動ループの案内の spawn --again は、再開の値の作業ディレクトリ・役割・計画で後継を --again で + # 起動し、引数を tmux のコマンドに載せない。登録簿の引数(最初の作業指示)は上書きせず、後の restart が元の指示で起動する + first = ["--model", "x", "/goal 最初の作業"] + _register(ctx, {"cwd": "/w", "args": first, "role": "worker", "plan": "p1", "version": VERSION}) + secret = ["--mcp-config", '{"headers":{"Authorization":"Bearer sk-secret"}}'] + saved = {"session_id": "s1", "args": secret, "account": "work2", "cwd": "/w2", "role": "worker", "plan": "p1"} + registry.write_again(registry.wrapper_dir(ctx.state_dir, "t1"), saved) + got = hub.submit(ctx, {"kind": "spawn", "name": "t1", "again": True}) + assert got.ok, got.summary + assert ctx.tmux.commands[0][-4:] == ["run", "--name", "t1", "--again"] + assert "sk-secret" not in " ".join(ctx.tmux.commands[0]) + _, env = ctx.tmux.started[0] + assert (env["NDF_RELAY_ROLE"], env["NDF_RELAY_PLAN"]) == ("worker", "p1") + assert registry.read_registry(hub.hub_dir(ctx.state_dir))["t1"]["args"] == first + assert hub.submit(ctx, {"kind": "restart", "name": "t1"}).ok + assert ctx.tmux.commands[1][-len(first) - 1 :] == ["--", *first] + + +def test_i15_spawn_again_without_saved_values_is_invalid(ctx): + # 決定 13: 再開の値が無い名前の spawn --again は起動せずに断る + got = hub.submit(ctx, {"kind": "spawn", "name": "t1", "again": True}) + assert (got.ok, got.cause) == (False, "invalid") and not ctx.tmux.started diff --git a/plugins/ndf/tests/domains/relay/test_relay_wrapper.py b/plugins/ndf/tests/domains/relay/test_relay_wrapper.py index 46469467b..bc6dcdd71 100644 --- a/plugins/ndf/tests/domains/relay/test_relay_wrapper.py +++ b/plugins/ndf/tests/domains/relay/test_relay_wrapper.py @@ -209,43 +209,82 @@ def _spin_run(tmp_path, children, clock, markers=None, prepare=None, environ=Non LIMITED = ("--disallowedTools", "Bash", "--permission-mode", "plan", "--settings", "/tmp/a b.json") +# 秘密(認証のヘッダー)と複数行の値を含む引数。案内のコマンドに出さず、再開の値には 1 語ずつ残す +SECRET = ("--mcp-config", '{"mcpServers":{"x":{"headers":{"Authorization":"Bearer sk-secret"}}}}', "--append-system-prompt", "非公開\n本文") -def _resumed(command: str, action: str): - """案内のコマンドを貼り付けたときに `ndf relay ` が読む値(ndf の引数と、ラッパーの設定のうちセッションごとの引数)。""" - words = shlex.split(command) +def _command(shown: str, pattern: str) -> list[str]: + """画面の案内からコマンドを取り出し、1 行のまま ndf の引数として読めることを確かめて語の並びを返す。""" + command = re.search(pattern, shown).group(1) + assert "\n" not in command + return shlex.split(command) + + +def _again(tmp_path, monkeypatch, words: list[str], action: str): + """案内の `ndf relay --name <名前> --again` を打ったときに読む ndf の引数と、再開の値から組む claude の引数・アカウント。""" assert words[:3] == ["ndf", "relay", action] args = relay_cli._parse(words[2:]) - parsed = claude_args.parse(args.rest, {}, True) - assert parsed.passthrough is None # ラッパーを通して起動する - return args, relay_cli._session_args(args.rest, parsed) + assert args.again and not args.rest + monkeypatch.setattr(relay_cli.identity, "load", lambda: type("I", (), {"state_dir": tmp_path / "state"})()) + rest, account = relay_cli._again_rest(args.name) + return args, rest, account -def test_i15_spin_line_tells_a_command_that_runs_for_the_wrapper_kind(tmp_path): - # 決定 13・I15(検出): 端末のラッパーには同じ会話を続ける ndf relay run --resume を、spawn で起動した名前つきの - # ラッパーには /exit の後に tmux の外から同じ名前で起動し直す ndf relay spawn -- --resume を案内する。どちらも起動時の - # 権限の制約(--disallowedTools など)を引き継ぎ、restart(登録簿の最初の作業指示を流し直す)を案内しない +def test_i15_spin_line_tells_a_one_line_again_command_without_the_args(tmp_path, monkeypatch): + # 決定 13・I15(検出): 案内は名前と --again だけの 1 行で、起動時の引数(秘密・複数行の値を含む)を画面に出さない。 + # 再開の値は 0600 で書き、今のセッション・引き継ぐ引数・今のアカウントをそのまま持つ marks = {0: "/goal 2", 1: "/goal 3", 2: "/goal 4"} children = [FakeChild([], None), FakeChild([], None), FakeChild([b""] * 10, 0), FakeChild([], 0)] - _, spawn, _, shown = _spin_run(tmp_path, children, Clock(), markers=marks, args=LIMITED) - _, got = _resumed(re.search(r"/exit し、(.+) で同じ会話を続ける", shown).group(1), "run") - assert got == {"args": LIMITED, "first_args": (), "first_session": spawn.calls[2][0][2], "first_resume": True} + _, spawn, w, shown = _spin_run(tmp_path, children, Clock(), markers=marks, args=LIMITED + SECRET) + assert "sk-secret" not in shown and "非公開" not in shown + words = _command(shown, r"/exit し、(.+) で同じ会話を続ける") + assert words == ["ndf", "relay", "run", "--name", "t1", "--again"] + assert (w.dir / registry.AGAIN_FILE).stat().st_mode & 0o777 == 0o600 + _, rest, account = _again(tmp_path, monkeypatch, words, "run") + assert rest == ["--resume", spawn.calls[2][0][2], *LIMITED, *SECRET] and account is None + parsed = claude_args.parse(rest, {}, True) + assert relay_cli._session_args(rest, parsed) == { + "args": LIMITED + SECRET, + "first_args": (), + "first_session": spawn.calls[2][0][2], + "first_resume": True, + } + + +def test_i15_named_spin_line_tells_spawn_again_and_keeps_role_and_plan(tmp_path, monkeypatch): + # 決定 13・I15(検出): spawn で起動した名前つきのラッパーには、/exit の後に tmux の外から同じ名前で spawn --again を + # 案内する(restart は登録簿の最初の作業指示を流し直すので案内しない)。作業ディレクトリ・役割・計画は再開の値が持つ + marks = {0: "/goal 2", 1: "/goal 3", 2: "/goal 4"} children = [FakeChild([], None), FakeChild([], None), FakeChild([b""] * 10, 0), FakeChild([], 0)] named = {"NDF_RELAY_SPAWNED": "1", "NDF_RELAY_ROLE": "worker", "NDF_RELAY_PLAN": "p1"} - _, spawn, _, shown = _spin_run(tmp_path / "n", children, Clock(), markers=marks, environ=named, args=LIMITED) + _, _, w, shown = _spin_run(tmp_path, children, Clock(), markers=marks, environ=named, args=LIMITED) assert "作業を保存してから /exit し" in shown and "relay restart" not in shown - args, got = _resumed(re.search(r"tmux の外で (.+) を打って同じ会話から起動し直す", shown).group(1), "spawn") - assert (args.name, args.cwd, args.role, args.plan) == ("t1", str(tmp_path / "n"), "worker", "p1") - assert got == {"args": LIMITED, "first_args": (), "first_session": spawn.calls[2][0][2], "first_resume": True} + words = _command(shown, r"tmux の外で (.+) を打って同じ会話から起動し直す") + assert words == ["ndf", "relay", "spawn", "--name", "t1", "--again"] + saved = registry.read_again(w.dir) + assert (saved["cwd"], saved["role"], saved["plan"], saved["args"]) == (str(tmp_path), "worker", "p1", list(LIMITED)) -def test_i15_spin_command_keeps_a_resume_value_with_spaces_and_shell_syntax_as_one_word(tmp_path): - # 決定 13・I15(検出): --resume の値は UUID とは限らない。空白やシェルの構文を含む値も、貼り付けたときに 1 語のまま渡る +def test_i15_spin_again_keeps_the_current_account_and_an_odd_resume_value(tmp_path, monkeypatch): + # 決定 13・I15(検出): 再開の値は今の子のアカウント(切り替えた後の値)と、空白やシェルの構文を含む --resume の値を 1 語で持つ odd = "release prep today; touch $(pwd)/x `id`" w = wrapper.Wrapper(make_settings(tmp_path, args=LIMITED)) - line = w._spin_again(wrapper.Section(1, odd, None, None, "l")) - _, got = _resumed(re.search(r"/exit し、(.+) で同じ会話を続ける", line).group(1), "run") - assert (got["first_session"], got["first_resume"], got["args"]) == (odd, True, LIMITED) + line = w._spin_again(wrapper.Section(1, odd, "work2", None, "l")) + _, rest, account = _again(tmp_path, monkeypatch, _command(line, r"/exit し、(.+) で同じ会話を続ける"), "run") + assert (rest[:2], account) == (["--resume", odd], "work2") + + +@pytest.mark.parametrize("account", ["work2", None]) +def test_i15_again_starts_on_the_saved_account_without_choosing_again(tmp_path, account): + # 決定 13・I15(検出): --again の最初のセグメントは環境変数・account use の指定から選び直さず、再開の値のアカウント + # (None は既定のログイン)で起動し、起動できたら再開の値を消す(1 回だけ使う) + s = make_settings(tmp_path) + registry.write_again(registry.wrapper_dir(s.state_dir, s.name), {"session_id": "s", "args": [], "account": account, "cwd": "/w"}) + env = {**s.environ, "NDF_CLAUDE_ACCOUNT": "limited"} + ended, spawn = run_wrapper(tmp_path, [FakeChild([], 0)], environ=env, again=True, first_account=account)[:2] + assert ended.cause == "" + assert spawn.calls[0][1].get("NDF_CLAUDE_ACCOUNT") == account + assert not (registry.wrapper_dir(s.state_dir, s.name) / registry.AGAIN_FILE).exists() def test_i15_spin_keeps_relaying_a_live_child_and_writes_one_stop_row(tmp_path): From 58a50f31cbd836a6d0ad9abe31b3ad36b7eafb13 Mon Sep 17 00:00:00 2001 From: "takemi.ohama" Date: Sat, 21 Nov 2026 23:45:15 +0000 Subject: [PATCH 07/12] =?UTF-8?q?Fix:=20--again=20=E3=81=AE=E5=86=8D?= =?UTF-8?q?=E9=96=8B=E3=81=AE=E5=80=A4=E3=82=92=E9=8C=A0=E3=81=AE=E5=BE=8C?= =?UTF-8?q?=E3=81=AB=E8=AA=AD=E3=81=BF=E3=80=81=E4=BF=9D=E5=AD=98=E3=81=97?= =?UTF-8?q?=E3=81=9F=E4=BD=9C=E6=A5=AD=E3=83=87=E3=82=A3=E3=83=AC=E3=82=AF?= =?UTF-8?q?=E3=83=88=E3=83=AA=E3=83=BB=E5=BD=B9=E5=89=B2=E3=83=BB=E8=A8=88?= =?UTF-8?q?=E7=94=BB=E3=81=A8=E3=82=A2=E3=82=AB=E3=82=A6=E3=83=B3=E3=83=88?= =?UTF-8?q?=E3=81=A7=E8=B5=B7=E5=8B=95=E3=81=97=E3=80=81=E7=9B=B4=E6=8E=A5?= =?UTF-8?q?=E8=B5=B7=E5=8B=95=E3=83=BB=E6=97=A7=E7=89=88=E3=83=BB=E5=B9=B3?= =?UTF-8?q?=E6=96=87=E3=81=AE=E7=99=BB=E9=8C=B2=E7=B0=BF=E3=81=B8=E8=90=BD?= =?UTF-8?q?=E3=81=A8=E3=81=95=E3=81=AA=E3=81=84=EF=BC=88#3604=20#3864?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- .../schemas/io/relay.args.schema.json | 8 ++ plugins/ndf/docs/contracts/commands.md | 4 +- .../development-workflow/references/relay.md | 2 +- plugins/ndf/src/ndf/domains/relay/cli.py | 84 +++++++++++---- plugins/ndf/src/ndf/domains/relay/hub.py | 45 +++++--- plugins/ndf/src/ndf/domains/relay/wrapper.py | 26 ++++- .../tests/domains/relay/test_relay_again.py | 100 ++++++++++++++++++ .../ndf/tests/domains/relay/test_relay_hub.py | 41 ++++++- .../tests/domains/relay/test_relay_wrapper.py | 18 +--- 9 files changed, 267 insertions(+), 61 deletions(-) create mode 100644 plugins/ndf/tests/domains/relay/test_relay_again.py diff --git a/plugins/ndf/contracts/schemas/io/relay.args.schema.json b/plugins/ndf/contracts/schemas/io/relay.args.schema.json index eaea2d301..b1cf0bec6 100644 --- a/plugins/ndf/contracts/schemas/io/relay.args.schema.json +++ b/plugins/ndf/contracts/schemas/io/relay.args.schema.json @@ -504,6 +504,10 @@ "--name": { "type": "string" }, + "--again": { + "type": "boolean", + "description": "再起動ループの案内のとおり、書き置いた再開の値で同じ会話を続ける" + }, "rest": { "type": "array", "items": { @@ -530,6 +534,10 @@ "--name": { "type": "string" }, + "--again": { + "type": "boolean", + "description": "再起動ループの案内のとおり、書き置いた再開の値で同じ会話を続ける" + }, "rest": { "type": "array", "items": { diff --git a/plugins/ndf/docs/contracts/commands.md b/plugins/ndf/docs/contracts/commands.md index 32756525d..28c8593d2 100644 --- a/plugins/ndf/docs/contracts/commands.md +++ b/plugins/ndf/docs/contracts/commands.md @@ -324,8 +324,8 @@ | `ndf relay notice` | 引数を受けない | | `ndf relay pending` | 引数を受けない | | `ndf relay restart` | `name`(string・必須・位置) | -| `ndf relay run` | `--name`(string・任意)
`rest`(array of string・任意・位置)
`--prompt`(string・任意) | -| `ndf relay spawn` | `--name`(string・任意)
`rest`(array of string・任意・位置)
`--cwd`(string・任意)
`--role`(string・任意)
`--plan`(string・任意) | +| `ndf relay run` | `--name`(string・任意)
`--again`(boolean・任意): 再起動ループの案内のとおり、書き置いた再開の値で同じ会話を続ける
`rest`(array of string・任意・位置)
`--prompt`(string・任意) | +| `ndf relay spawn` | `--name`(string・任意)
`--again`(boolean・任意): 再起動ループの案内のとおり、書き置いた再開の値で同じ会話を続ける
`rest`(array of string・任意・位置)
`--cwd`(string・任意)
`--role`(string・任意)
`--plan`(string・任意) | | `ndf relay status` | 引数を受けない | | `ndf relay stop` | `name`(string・任意・位置): 止めるラッパーの名前
`--all`(boolean・任意): 動いている名前つきのラッパーをすべて止める | | `ndf relay uninstall` | 引数を受けない | diff --git a/plugins/ndf/skills/development-workflow/references/relay.md b/plugins/ndf/skills/development-workflow/references/relay.md index b9f8802a1..0e6135327 100644 --- a/plugins/ndf/skills/development-workflow/references/relay.md +++ b/plugins/ndf/skills/development-workflow/references/relay.md @@ -392,7 +392,7 @@ claude のアカウントを 2 つ以上登録しておくと、利用上限で | `プラグインを更新できなかった(<理由>)。<バージョン> で次のセグメントを起動する` | 更新に失敗した。ラッパーは止まらず、そのバージョンで次のセグメントを起動した | 何もしなくてよい。ラッパーが次のカットポイントで更新を打ち直す | | `メジャーバージョンが <ラッパー> から <起動先> に変わった。次のセグメントを起動しない。…` | ラッパーは終わった(終了コード 3)。`relay.root` は起動先へ向け直してある | 1 行の案内どおり `claude` を打ち直し、conductor のブロックの中身を最初の入力にする | | `子の claude を起動できない(<理由>)` | ラッパーは終わった(終了コード 3)。子は起動していない | 理由(作業ディレクトリが無い・`claude` が PATH に無いなど)を直してから、conductor のブロックの中身で `claude` を打ち直す | -| `起動から <秒> 秒未満で次のセグメントへ移ったセグメントが <数> つ続いた(再起動ループ)。次のセグメントを起動しない。…` | 再起動ループの検出(「[上限](#上限)」)に当たった。今のセッションは動いたまま | 原因を直してから起動し直す。ラッパーは再開の値(今のセッション ID・起動時に付けた引数(`--permission-mode`・`--disallowedTools`・`--settings` など)・今のアカウント・作業ディレクトリ・役割・計画)を `<状態の保存先>/relay/wrappers/<名前>/again.json` へ 0600 で書き、案内には名前と `--again` だけを出す(引数の秘密や複数行の値を画面に出さない)。端末で打ったラッパーは `/exit` し、1 行の案内どおり `ndf relay run --name <名前> --again` で同じ会話を続ける。`ndf relay spawn` で起動した名前つきのラッパーは、作業を保存してから `/exit` し、tmux の外から 1 行の案内どおり `ndf relay spawn --name <名前> --again` を打つ(`ndf relay restart` は登録簿の最初の作業指示で起動し直すので使わない。`--again` は登録簿の引数を書き換えないので、後の restart は元の作業指示で起動する)。どちらもアカウントを選び直さず、再開の値は起動できたら消える | +| `起動から <秒> 秒未満で次のセグメントへ移ったセグメントが <数> つ続いた(再起動ループ)。次のセグメントを起動しない。…` | 再起動ループの検出(「[上限](#上限)」)に当たった。今のセッションは動いたまま | 原因を直してから起動し直す。ラッパーは再開の値(今のセッション ID・起動時に付けた引数(`--permission-mode`・`--disallowedTools`・`--settings` など)・今のアカウント・作業ディレクトリ・役割・計画)を `<状態の保存先>/relay/wrappers/<名前>/again.json` へ 0600 で書き、案内には名前と `--again` だけを出す(引数の秘密や複数行の値を画面に出さない)。端末で打ったラッパーは `/exit` し、1 行の案内どおり `ndf relay run --name <名前> --again` で同じ会話を続ける。`ndf relay spawn` で起動した名前つきのラッパーは、作業を保存してから `/exit` し、tmux の外から 1 行の案内どおり `ndf relay spawn --name <名前> --again` を打つ(`ndf relay restart` は登録簿の最初の作業指示で起動し直すので使わない。`--again` は登録簿の引数を書き換えないので、後の restart は元の作業指示で起動する)。どちらもアカウントを選び直さず、打った場所によらず再開の値の作業ディレクトリ・役割・計画で起動する。再開の値はラッパーの錠を取った後に読み、起動できたらその値だけを消す。`NDF_RELAY=0` や端末でない(標準出力のリダイレクトなど)ときの `run --again` は claude を直接起動せずに断る。登録簿に無い名前の `spawn --again` は引数を持たない項目で登録する(再開の値の引数を登録簿へ移さない) | | 上の 5 つ以外(`ndf-relay: <理由>`) | ラッパーは終わった。終了コードは停止理由の種類(`contracts/causes.json`)のとおり。再起動ループの検出で、子が終わった後に止まったときもこの行になる(終了コードは子の終了コード) | 理由を直してから、conductor のブロックの中身で `claude` を起動する | ## fork したセッションで進めたとき diff --git a/plugins/ndf/src/ndf/domains/relay/cli.py b/plugins/ndf/src/ndf/domains/relay/cli.py index bc9ceebc0..c18ed6ad2 100644 --- a/plugins/ndf/src/ndf/domains/relay/cli.py +++ b/plugins/ndf/src/ndf/domains/relay/cli.py @@ -20,6 +20,7 @@ import argparse import contextlib +import dataclasses import io import json import os @@ -183,7 +184,7 @@ def _hub(args: argparse.Namespace) -> int: refused = _again_refused(args, ("cwd", "role", "plan")) if refused: return result.emit(result.stopped(TOOL, "invalid", refused)) - req = {"kind": "spawn", "name": args.name, "again": True} + req = {"kind": hub.SPAWN_AGAIN, "name": args.name} elif args.action == "spawn": cwd = str(Path(args.cwd).resolve()) if args.cwd else os.getcwd() req = {"kind": "spawn", "name": args.name, "cwd": cwd, "role": args.role, "plan": args.plan, "args": args.rest} @@ -270,22 +271,44 @@ def _again_refused(args: argparse.Namespace, others: tuple[str, ...]) -> str: return f"--again には {'・'.join(given)} を付けない(再開の値を使う)" if given else "" -def _again_rest(name: str) -> tuple[list[str], Optional[str]]: - """再開の値(`registry.read_again`)から claude の引数(`--resume ` と引き継ぐ引数)とアカウントを組む。""" - saved = registry.read_again(registry.wrapper_dir(identity.load().state_dir, name)) - return ["--resume", saved["session_id"], *saved["args"]], saved["account"] +def again_rest(saved: Mapping[str, Any]) -> list[str]: + """再開の値(`registry.read_again`)から claude の引数(`--resume ` と引き継ぐ引数)を組む。""" + return ["--resume", saved["session_id"], *saved["args"]] + + +def again_settings(name: str, saved: Mapping[str, Any], on_tty: bool) -> wrapper.Settings: + """再開の値で組んだラッパーの設定(`wrapper.Settings.again_load`。錠を取った後に呼ばれる)。""" + rest = again_rest(saved) + return wrapper_settings(name, rest, claude_args.parse(rest, os.environ, on_tty), saved) + + +def _again_place(saved: Mapping[str, Any]) -> tuple[dict[str, str], Path, Optional[str]]: + """再開の値の(環境, 作業ディレクトリ, 読めなかったときの表示)。役割・計画は再開の値で置き換える(無ければ外す)。""" + environ = dict(os.environ) + for key, value in (("NDF_RELAY_ROLE", saved["role"]), ("NDF_RELAY_PLAN", saved["plan"])): + if value: + environ[key] = value + else: + environ.pop(key, None) + cwd = Path(saved["cwd"]) + return environ, cwd, None if cwd.is_dir() else saved["cwd"] def wrapper_settings( - name: str, rest: list[str], parsed: Optional[claude_args.Parsed] = None, again: bool = False, account: Optional[str] = None + name: str, rest: list[str], parsed: Optional[claude_args.Parsed] = None, saved: Optional[Mapping[str, Any]] = None ) -> wrapper.Settings: """`parsed` があれば引数をセッションごとに分けて渡す(無ければ `rest` をすべてのセッションに付ける)。 - `again`(`--again` の再開)なら最初のセグメントでアカウントを選び直さず `account`(None は既定のログイン)を使う。 + `saved`(`--again` の再開の値)があれば、打った場所の値でなく再開の値の作業ディレクトリ・役割・計画で組み + (別のディレクトリで打っても同じ worktree で続ける。計画への質問の経路と更新の確かめも同じ値で組む)、作業ディレクトリが + 無ければ `cwd_lost` にして起動しない。最初のセグメントはアカウントを選び直さず再開の値のもの(None は既定のログイン)を使う。 """ ident = identity.load() - environ = dict(os.environ) - cwd, cwd_lost = _cwd(environ) + if saved is None: + environ = dict(os.environ) + cwd, cwd_lost = _cwd(environ) + else: + environ, cwd, cwd_lost = _again_place(saved) raw = ident.manifest["version"] # identity.load() が name と同じ読み取りで得たバージョン。読み直さない(#3909) updater = plugin_update.Updater( root=ident.root, @@ -313,8 +336,8 @@ def wrapper_settings( ask_plan=lane_question.plan_asker(environ, name, cwd, ident.root, limits.seconds("relay.lanes-ask")), update=updater, confirm=updater.confirm, - again=again, - first_account=account, + again=saved is not None, + first_account=saved["account"] if saved is not None else None, ) @@ -331,27 +354,42 @@ def _passthrough(rest: list[str], parsed: claude_args.Parsed) -> int: def _run(args: argparse.Namespace) -> int: - account: Optional[str] = None + on_tty = sys.stdin.isatty() and sys.stdout.isatty() if args.again: - refused = _again_refused(args, ("prompt",)) - if refused: - return result.emit(result.stopped(TOOL, "invalid", refused)) - args.rest, account = _again_rest(args.name) + return _run_again(args, on_tty) name = args.name or os.environ.get("NDF_RELAY_NAME") or f"w{os.getpid()}" - parsed = claude_args.parse(args.rest, os.environ, sys.stdin.isatty() and sys.stdout.isatty()) + parsed = claude_args.parse(args.rest, os.environ, on_tty) if parsed.passthrough: return _passthrough(args.rest, parsed) + return _wrap(wrapper_settings(name, args.rest, parsed), args.prompt or parsed.prompt or "") # noqa: NDF501 利用者の入力: 最初の 1 行が無ければ空の入力欄で始める + + +def _run_again(args: argparse.Namespace, on_tty: bool) -> int: + """`run --again`。ラッパーを挟めない条件(`NDF_RELAY=0`・端末でない)なら claude を直接起動せず、起動前に断る。 + + 再開の値は錠を取った後にラッパーが読む(`wrapper.Settings.again_load`)。直接起動では保存したアカウントを使えず、 + 再開の値も使い終わらない。 + """ + refused = _again_refused(args, ("prompt",)) + if refused: + return result.emit(result.stopped(TOOL, "invalid", refused)) + gate = claude_args.parse([], os.environ, on_tty) + if gate.passthrough: + why = f"--again はラッパーを挟めるときだけ使える({gate.passthrough})。NDF_RELAY=0 を外し、端末で打つ" + return result.emit(result.stopped(TOOL, "precondition", why)) + base = dataclasses.replace(wrapper_settings(args.name, []), again_load=lambda saved: again_settings(args.name, saved, on_tty)) + return _wrap(base, "") + + +def _wrap(settings: wrapper.Settings, prompt: str) -> int: + """端末を raw にしてラッパーを回し、終わったら端末を戻す。""" tty_in = sys.stdin.isatty() saved = termios.tcgetattr(sys.stdin.fileno()) if tty_in else None if tty_in: tty.setraw(sys.stdin.fileno()) try: - w = wrapper.Wrapper( - wrapper_settings(name, args.rest, parsed, args.again, account), - out=sys.stdout.buffer, - stdin_fd=sys.stdin.fileno() if tty_in else None, - ) - ended = w.run(args.prompt or parsed.prompt or "") # noqa: NDF501 利用者の入力: 最初の 1 行が無ければ空の入力欄で始める + w = wrapper.Wrapper(settings, out=sys.stdout.buffer, stdin_fd=sys.stdin.fileno() if tty_in else None) + ended = w.run(prompt) finally: if saved is not None: termios.tcsetattr(sys.stdin.fileno(), termios.TCSADRAIN, saved) diff --git a/plugins/ndf/src/ndf/domains/relay/hub.py b/plugins/ndf/src/ndf/domains/relay/hub.py index 68166f11e..a8d05799a 100644 --- a/plugins/ndf/src/ndf/domains/relay/hub.py +++ b/plugins/ndf/src/ndf/domains/relay/hub.py @@ -39,6 +39,9 @@ # 受付箱。導入(plugin_root・version)を読まない旧版は `requests/` だけを読むので、別の名前にして旧版に処理させない(#3909)。 # 旧版の頼む側は自分の drain で `requests/` を処理する(排他は共通の hub.lock) REQUESTS_DIR = "requests-v2" +# `spawn --again` のリクエストの種類。`spawn` と分け、`again` を知らない同じメジャーの旧版が通常の spawn として起動せず +# 「知らないリクエスト」で断るようにする(保存した作業ディレクトリ・会話・権限の制約を落とした起動をしない) +SPAWN_AGAIN = "spawn-again" class Outcome(NamedTuple): @@ -172,7 +175,7 @@ def handle(ctx: Context, req: Mapping[str, Any]) -> Outcome: """リクエスト 1 本を処理する。起動・再起動は頼んだ側の導入で行う(`requester`)。""" kind = req.get("kind") try: - if kind == "spawn": + if kind in ("spawn", SPAWN_AGAIN): return spawn(requester(ctx, req), req) if kind == "restart": return restart(requester(ctx, req), str(req["name"])) @@ -214,12 +217,13 @@ def spawn(ctx: Context, req: Mapping[str, Any]) -> Outcome: refused = _refused(hub_decide.spawn(lanes), "refused") if refused is not None: return refused - again = bool(req.get("again")) + again = req.get("kind") == SPAWN_AGAIN + account: Optional[str] = None if again: - entry, kept = _again_entries(ctx, name, entries.get(name)) + entry, kept, account = _again_entries(ctx, name, entries.get(name)) else: entry = kept = {k: req.get(k) for k in ("cwd", "args", "role", "plan")} - env = _checked_env(ctx, name, entry) + env = _checked_env(ctx, name, entry, account, decided=again) if isinstance(env, Outcome): return env got = _launch(ctx, name, entry, env, again=again) @@ -229,17 +233,20 @@ def spawn(ctx: Context, req: Mapping[str, Any]) -> Outcome: return got -def _again_entries(ctx: Context, name: str, registered: Optional[Mapping[str, Any]]) -> tuple[dict[str, Any], dict[str, Any]]: - """`--again` の spawn で(起動に使う項目, 登録簿に残す項目)。 +def _again_entries( + ctx: Context, name: str, registered: Optional[Mapping[str, Any]] +) -> tuple[dict[str, Any], dict[str, Any], Optional[str]]: + """`--again` の spawn で(起動に使う項目, 登録簿に残す項目, 再開の値のアカウント)。 起動は再開の値(`registry.read_again`)の作業ディレクトリ・役割・計画で行い、引数は後継のラッパーが再開の値から読む。 登録簿には登録時の項目(最初の作業指示を含む引数)を残し、1 回だけの `--resume` で上書きしない(restart が元の指示で - 起動し直せる)。登録簿に無ければ、再開の値の引き継ぐ引数で登録する。 + 起動し直せる)。登録簿に無ければ引数を持たない項目で登録する(再開の値の引数は認証のヘッダーなどを含みうるので、 + 0600 でない登録簿にも、restart が組む tmux のコマンドにも移さない)。 """ saved = registry.read_again(registry.wrapper_dir(ctx.state_dir, name)) entry = {"cwd": saved["cwd"], "args": [], "role": saved["role"], "plan": saved["plan"]} - kept = _current(registered) if registered is not None else {**entry, "args": list(saved["args"])} - return entry, kept + kept = _current(registered) if registered is not None else dict(entry) + return entry, kept, saved["account"] def restart(ctx: Context, name: str) -> Outcome: @@ -272,13 +279,16 @@ def restart(ctx: Context, name: str) -> Outcome: return _with_pending(got, pending) -def _checked_env(ctx: Context, name: str, entry: Mapping[str, Any]) -> "dict[str, str] | Outcome": +def _checked_env( + ctx: Context, name: str, entry: Mapping[str, Any], account: Optional[str] = None, decided: bool = False +) -> "dict[str, str] | Outcome": """後継へ渡す環境。`NDF_RELAY_SPIN` が不正なら precondition の結果(#3864 の決定 13)。 ラッパーの設定(`wrapper_settings`)で落ちる値を、動いているレーンを止める前に断る。確かめた環境を そのまま `_launch` へ渡し、起動の時に作り直さない(アカウントの選び方を読み直さず、確かめた値と食い違わない)。 + `decided`(`--again`)なら今のアカウントの選び方を読まず、再開の値の `account` で組む(`spawn_env`)。 """ - env = spawn_env(ctx.environ, ctx.state_dir, name, entry) + env = spawn_env(ctx.environ, ctx.state_dir, name, entry, account, decided) try: spin_of(env) except limits.EnvError as exc: @@ -330,14 +340,23 @@ def stop(ctx: Context, name: str) -> Outcome: return Outcome(True, f"{name} を止めた") -def spawn_env(environ: Mapping[str, str], state_dir: Path, name: str, entry: Mapping[str, Any]) -> dict[str, str]: +def spawn_env( + environ: Mapping[str, str], + state_dir: Path, + name: str, + entry: Mapping[str, Any], + account: Optional[str] = None, + decided: bool = False, +) -> dict[str, str]: """名前つきのラッパーへ渡す環境(子のセッションの環境に、名前・役割・計画の名前を足す)。 + `decided` なら `account`(None は既定のログイン)で組み、今のアカウントの選び方を読まない(`session_env.child_env`)。 + 計画の名前(`NDF_RELAY_PLAN`)があれば、ラッパーは子の質問を計画のリクエストとして載せる(`lane_question`。#3035)。 `NDF_RELAY_SPIN` は無くても空文字で入れる。tmux の `new-session` は渡した名前だけを `-e` で上書きするので、 落とすと既存の tmux サーバーのグローバル環境に残る値を後継が読み、事前の確かめと食い違う(#3864 の決定 13)。 """ - env = session_env.child_env(environ, state_dir) + env = session_env.child_env(environ, state_dir, account, decided) extra = {"NDF_RELAY_NAME": name, "NDF_RELAY_SPAWNED": "1", "NDF_RELAY_ROLE": entry.get("role"), "NDF_RELAY_PLAN": entry.get("plan")} env.update({k: str(v) for k, v in extra.items() if v}) spin = environ.get("NDF_RELAY_SPIN") diff --git a/plugins/ndf/src/ndf/domains/relay/wrapper.py b/plugins/ndf/src/ndf/domains/relay/wrapper.py index 1c3c7c7d6..1e9802626 100644 --- a/plugins/ndf/src/ndf/domains/relay/wrapper.py +++ b/plugins/ndf/src/ndf/domains/relay/wrapper.py @@ -111,7 +111,9 @@ class Settings: `cwd_lost` は設定を作るときに作業ディレクトリを読めなかったときの表示の文字列(None でなければ起動しない。#3842)。 `spin` は再起動ループの検出の閾値(`relay.spin`。#3864 の決定 13)。 `again` が真なら最初のセグメントを再開の値(`--again`)で起動する。アカウントは選び直さず `first_account` - (None なら既定のログイン)を使い、起動できたら再開の値を消す(1 回だけ使う)。 + (None なら既定のログイン)を使う。 + `again_load` は `--again` の起動で、錠を取った後に読んだ再開の値から設定を組み直す手(`cli.again_settings`)。 + 錠の前に読まないので、同じ名前の `--again` が並んでも使い終わった再開の値で起動しない。起動できたら読んだ値を消す。 """ state_dir: Path @@ -136,6 +138,7 @@ class Settings: cwd_lost: Optional[str] = None again: bool = False first_account: Optional[str] = None + again_load: Optional[Callable[[Mapping[str, Any]], Settings]] = None @dataclass(frozen=True) @@ -262,6 +265,8 @@ def __init__( self.launched_root: Optional[Path] = None # 前の `plugin_update` の行までに知っていた起動先のバージョン。外で上がったかを比べる(#3909) self.known_version: Optional[str] = settings.version + # 錠を取った後に読んだ再開の値(`again_load`)。起動できたら、この値のままのときだけ消す + self.again_saved: Optional[dict[str, Any]] = None def run(self, prompt: str) -> Ended: """錠を取り、バージョンの混ざりを確かめてからセグメントを回す。""" @@ -269,6 +274,12 @@ def run(self, prompt: str) -> Ended: with signals.held(self.dir / registry.LOCK_FILE, 0) as got: if not got: return Ended("refused", f"{self.s.name} のラッパーは既に動いている") + if self.s.again_load is not None: + try: + saved = registry.read_again(self.dir) + except registry.RegistryError as exc: + return Ended("invalid", str(exc)) + self.s, self.again_saved = self.s.again_load(saved), saved others = [r for r in registry.all_running(self.s.state_dir, self.s.environ) if r.name != self.s.name] mix = hub_decide.mixed(self.s.version, others) if not mix.ok: @@ -286,8 +297,8 @@ def _loop(self, prompt: str) -> Ended: ended = self._start(Launch(1, first, account, prompt, resume=self.s.first_resume, decided=self.s.again)) if ended is not None: return self._end(ended) - if self.s.again: - (self.dir / registry.AGAIN_FILE).unlink(missing_ok=True) # 1 回だけの再開の値。起動できたら使い終わり + if self.again_saved is not None: + self._consume_again() while True: self._pump(self.s.tick) try: @@ -306,6 +317,15 @@ def _loop(self, prompt: str) -> Ended: if ended is not None: return self._end(ended) + def _consume_again(self) -> None: + """起動に使った再開の値を消す(1 回だけ使う)。読んだ後に書き直された値は、起動に使っていないので残す。""" + try: + current = registry.read_again(self.dir) + except registry.RegistryError: # noqa: NDF401 ファイル: 既に無い・読めない再開の値は起動に使った値ではないので消さない + return + if current == self.again_saved: + (self.dir / registry.AGAIN_FILE).unlink(missing_ok=True) + def _state(self) -> switch_decide.SectionState: sec = self._current() nxt = self._next_mark(sec) diff --git a/plugins/ndf/tests/domains/relay/test_relay_again.py b/plugins/ndf/tests/domains/relay/test_relay_again.py new file mode 100644 index 000000000..17e604cf7 --- /dev/null +++ b/plugins/ndf/tests/domains/relay/test_relay_again.py @@ -0,0 +1,100 @@ +"""`--again` の再開(#3604 #3864 の決定 13): 錠の後に読む再開の値・保存した作業ディレクトリ・役割・計画・断る条件。 + +再起動ループの案内(`--again` の 1 行)を出す側は `test_relay_wrapper.py` にある。 +""" + +from __future__ import annotations + +import json +from pathlib import Path + +import pytest +from ndf.domains.relay import cli as relay_cli +from ndf.domains.relay import registry, signals +from relay_children import FakeChild, make_settings, run_wrapper + +LIMITED = ("--disallowedTools", "Bash", "--permission-mode", "plan", "--settings", "/tmp/a b.json") + + +def _loader(loaded: list, **changes): + """錠を取った後に再開の値を受け取る手(`Settings.again_load`)。受け取った値を `loaded` に残す。""" + + def load(saved): + loaded.append(saved) + return make_settings(Path(saved["cwd"]), again=True, first_account=saved["account"], **changes) + + return load + + +@pytest.mark.parametrize("account", ["work2", None]) +def test_i15_again_starts_on_the_saved_account_without_choosing_again(tmp_path, account): + # 決定 13・I15(検出): --again の最初のセグメントは環境変数・account use の指定から選び直さず、再開の値のアカウント + # (None は既定のログイン)で起動し、起動できたら再開の値を消す(1 回だけ使う) + s = make_settings(tmp_path) + saved = {"session_id": "s", "args": [], "account": account, "cwd": str(tmp_path)} + registry.write_again(registry.wrapper_dir(s.state_dir, s.name), saved) + env = {**s.environ, "NDF_CLAUDE_ACCOUNT": "limited"} + loaded: list = [] + load = _loader(loaded, state_dir=s.state_dir, environ=env) + ended, spawn = run_wrapper(tmp_path, [FakeChild([], 0)], environ=env, again_load=load)[:2] + assert ended.cause == "" and loaded == [saved] + assert spawn.calls[0][1].get("NDF_CLAUDE_ACCOUNT") == account + assert not (registry.wrapper_dir(s.state_dir, s.name) / registry.AGAIN_FILE).exists() + + +def test_i15_again_reads_the_saved_values_only_after_taking_the_lock(tmp_path): + # 決定 13: 同じ名前のラッパーが動いていれば、再開の値を読まず・消さずに断る(錠の前に読んだ値で後から起動しない) + s = make_settings(tmp_path) + d = registry.wrapper_dir(s.state_dir, s.name) + registry.write_again(d, {"session_id": "s", "args": [], "account": None, "cwd": str(tmp_path)}) + loaded: list = [] + with signals.held(d / registry.LOCK_FILE, 0): + ended = run_wrapper(tmp_path, [FakeChild([], 0)], again_load=_loader(loaded, state_dir=s.state_dir))[0] + assert ended.cause == "refused" and loaded == [] and (d / registry.AGAIN_FILE).exists() + + +def test_i15_again_keeps_saved_values_written_after_it_read_them(tmp_path): + # 決定 13: 起動に使った再開の値だけを消し、読んだ後に書き直された値は残す + s = make_settings(tmp_path) + d = registry.wrapper_dir(s.state_dir, s.name) + registry.write_again(d, {"session_id": "s", "args": [], "account": None, "cwd": str(tmp_path)}) + newer = {"session_id": "s2", "args": [], "account": None, "cwd": str(tmp_path)} + loaded: list = [] + first = _loader(loaded, state_dir=s.state_dir) + + def load(saved): + got = first(saved) + registry.write_again(d, newer) + return got + + assert run_wrapper(tmp_path, [FakeChild([], 0)], again_load=load)[0].cause == "" + assert registry.read_again(d)["session_id"] == "s2" + + +def test_i15_again_settings_use_the_saved_cwd_role_and_plan(tmp_path, monkeypatch): + # 決定 13: run --again は打った場所でなく再開の値の作業ディレクトリ・役割・計画で起動し、計画への質問の経路も組む + work = tmp_path / "work" + work.mkdir() + monkeypatch.chdir(tmp_path) + monkeypatch.delenv("NDF_RELAY_ROLE", raising=False) + monkeypatch.setenv("NDF_RELAY_PLAN", "other") + saved = {"session_id": "s1", "args": list(LIMITED), "account": "work2", "cwd": str(work), "role": "lane", "plan": "p1"} + s = relay_cli.again_settings("t1", saved, True) + assert (s.cwd, s.cwd_lost, s.environ["NDF_RELAY_ROLE"], s.environ["NDF_RELAY_PLAN"]) == (work, None, "lane", "p1") + assert (s.again, s.first_account, s.first_session, s.first_resume, s.args) == (True, "work2", "s1", True, LIMITED) + assert s.ask_plan is not None + gone = relay_cli.again_settings("t1", {**saved, "cwd": str(tmp_path / "gone"), "plan": None}, True) + assert gone.cwd_lost == str(tmp_path / "gone") and "NDF_RELAY_PLAN" not in gone.environ + + +@pytest.mark.parametrize("relay, on_tty", [("0", True), (None, False)]) +def test_i15_run_again_refuses_where_the_wrapper_cannot_run(tmp_path, monkeypatch, capsys, relay, on_tty): + # 決定 13: NDF_RELAY=0 や端末でないときの run --again は claude を直接起動せず(保存したアカウントを使えない)、起動前に断る + if relay is None: + monkeypatch.delenv("NDF_RELAY", raising=False) + else: + monkeypatch.setenv("NDF_RELAY", relay) + monkeypatch.setattr(relay_cli.os, "execvp", lambda *a: pytest.fail("claude を直接起動した")) + args = relay_cli._parse(["run", "--name", "t1", "--again"]) + code = relay_cli._run_again(args, on_tty) + assert code != 0 and json.loads(capsys.readouterr().out)["cause"]["kind"] == "precondition" diff --git a/plugins/ndf/tests/domains/relay/test_relay_hub.py b/plugins/ndf/tests/domains/relay/test_relay_hub.py index e605e6bae..8f81bb50e 100644 --- a/plugins/ndf/tests/domains/relay/test_relay_hub.py +++ b/plugins/ndf/tests/domains/relay/test_relay_hub.py @@ -15,7 +15,8 @@ import pytest from ndf.contracts import limits -from ndf.domains.relay import hub, registry, switch_decide +from ndf.domains.relay import accounts, hub, registry, switch_decide +from ndf.domains.relay import cli as relay_cli from ndf.domains.relay.tmux import Done, Tmux, new_session_args VERSION = "11.0.0-dev.4" @@ -380,7 +381,7 @@ def test_i15_spawn_again_resumes_from_the_saved_values_and_keeps_the_registered_ secret = ["--mcp-config", '{"headers":{"Authorization":"Bearer sk-secret"}}'] saved = {"session_id": "s1", "args": secret, "account": "work2", "cwd": "/w2", "role": "worker", "plan": "p1"} registry.write_again(registry.wrapper_dir(ctx.state_dir, "t1"), saved) - got = hub.submit(ctx, {"kind": "spawn", "name": "t1", "again": True}) + got = hub.submit(ctx, {"kind": hub.SPAWN_AGAIN, "name": "t1"}) assert got.ok, got.summary assert ctx.tmux.commands[0][-4:] == ["run", "--name", "t1", "--again"] assert "sk-secret" not in " ".join(ctx.tmux.commands[0]) @@ -393,5 +394,39 @@ def test_i15_spawn_again_resumes_from_the_saved_values_and_keeps_the_registered_ def test_i15_spawn_again_without_saved_values_is_invalid(ctx): # 決定 13: 再開の値が無い名前の spawn --again は起動せずに断る - got = hub.submit(ctx, {"kind": "spawn", "name": "t1", "again": True}) + got = hub.submit(ctx, {"kind": hub.SPAWN_AGAIN, "name": "t1"}) assert (got.ok, got.cause) == (False, "invalid") and not ctx.tmux.started + + +def test_i15_spawn_again_without_a_registry_entry_keeps_the_saved_args_out_of_the_registry(ctx): + # 決定 13: 登録の無い名前の spawn --again は、再開の値の引数(認証のヘッダーを含みうる)を 0600 でない登録簿に移さず、 + # 後の restart の tmux のコマンドにも載せない + secret = ["--mcp-config", '{"headers":{"Authorization":"Bearer sk-secret"}}'] + saved = {"session_id": "s1", "args": secret, "account": None, "cwd": "/w2", "role": None, "plan": None} + registry.write_again(registry.wrapper_dir(ctx.state_dir, "t1"), saved) + assert hub.submit(ctx, {"kind": hub.SPAWN_AGAIN, "name": "t1"}).ok + assert "sk-secret" not in (hub.hub_dir(ctx.state_dir) / registry.REGISTRY_FILE).read_text(encoding="utf-8") + assert hub.submit(ctx, {"kind": "restart", "name": "t1"}).ok + assert "sk-secret" not in " ".join(ctx.tmux.commands[1]) + + +def test_i15_spawn_again_builds_the_env_from_the_saved_account_without_choosing(ctx, monkeypatch): + # 決定 13: spawn --again の環境は再開の値のアカウントで組み、今のアカウントの選び方(指定のファイル)を読まない + def unreadable(*_): + raise accounts.AccountError("指定のファイルを読めない") + + monkeypatch.setattr(accounts, "chosen", unreadable) + saved = {"session_id": "s1", "args": [], "account": "work2", "cwd": "/w2", "role": None, "plan": None} + registry.write_again(registry.wrapper_dir(ctx.state_dir, "t1"), saved) + got = hub.submit(ctx, {"kind": hub.SPAWN_AGAIN, "name": "t1"}) + assert got.ok, got.summary + assert ctx.tmux.started[0][1]["NDF_CLAUDE_ACCOUNT"] == "work2" + + +def test_i15_spawn_again_is_not_an_ordinary_spawn_for_an_older_hub(ctx, monkeypatch): + # 決定 13: spawn --again は spawn と別の種類で頼む。again を知らない旧版は通常の spawn として起動せず、知らない種類で断る + sent = [] + monkeypatch.setattr(relay_cli, "hub_context", lambda environ: ctx) + monkeypatch.setattr(relay_cli.hub, "submit", lambda c, req: sent.append(req) or hub.Outcome(True, "ok")) + relay_cli._hub(relay_cli._parse(["spawn", "--name", "t1", "--again"])) + assert sent == [{"kind": hub.SPAWN_AGAIN, "name": "t1"}] and hub.SPAWN_AGAIN != "spawn" diff --git a/plugins/ndf/tests/domains/relay/test_relay_wrapper.py b/plugins/ndf/tests/domains/relay/test_relay_wrapper.py index bc6dcdd71..fc381cf8b 100644 --- a/plugins/ndf/tests/domains/relay/test_relay_wrapper.py +++ b/plugins/ndf/tests/domains/relay/test_relay_wrapper.py @@ -225,9 +225,8 @@ def _again(tmp_path, monkeypatch, words: list[str], action: str): assert words[:3] == ["ndf", "relay", action] args = relay_cli._parse(words[2:]) assert args.again and not args.rest - monkeypatch.setattr(relay_cli.identity, "load", lambda: type("I", (), {"state_dir": tmp_path / "state"})()) - rest, account = relay_cli._again_rest(args.name) - return args, rest, account + saved = registry.read_again(registry.wrapper_dir(tmp_path / "state", args.name)) + return args, relay_cli.again_rest(saved), saved["account"] def test_i15_spin_line_tells_a_one_line_again_command_without_the_args(tmp_path, monkeypatch): @@ -274,19 +273,6 @@ def test_i15_spin_again_keeps_the_current_account_and_an_odd_resume_value(tmp_pa assert (rest[:2], account) == (["--resume", odd], "work2") -@pytest.mark.parametrize("account", ["work2", None]) -def test_i15_again_starts_on_the_saved_account_without_choosing_again(tmp_path, account): - # 決定 13・I15(検出): --again の最初のセグメントは環境変数・account use の指定から選び直さず、再開の値のアカウント - # (None は既定のログイン)で起動し、起動できたら再開の値を消す(1 回だけ使う) - s = make_settings(tmp_path) - registry.write_again(registry.wrapper_dir(s.state_dir, s.name), {"session_id": "s", "args": [], "account": account, "cwd": "/w"}) - env = {**s.environ, "NDF_CLAUDE_ACCOUNT": "limited"} - ended, spawn = run_wrapper(tmp_path, [FakeChild([], 0)], environ=env, again=True, first_account=account)[:2] - assert ended.cause == "" - assert spawn.calls[0][1].get("NDF_CLAUDE_ACCOUNT") == account - assert not (registry.wrapper_dir(s.state_dir, s.name) / registry.AGAIN_FILE).exists() - - def test_i15_spin_keeps_relaying_a_live_child_and_writes_one_stop_row(tmp_path): # 決定 13・I15(検出): 120 秒未満で区切ったセグメントが 3 つ続くと 3 つ目の後を起動せず、子が動いていれば止めずに中継を続け、 # stop(spin)の行と画面の 1 行を 1 回だけ出す。その後に子が終わると子の終了コードで end(spin) From 6641e287cb4a559acdbd998d010e9a2239028618 Mon Sep 17 00:00:00 2001 From: "takemi.ohama" Date: Sun, 22 Nov 2026 00:00:03 +0000 Subject: [PATCH 08/12] =?UTF-8?q?Fix:=20=E6=97=A7=E5=BD=A2=E5=BC=8F?= =?UTF-8?q?=E3=81=AE=20spawn=20--again=20=E3=82=92=E5=86=8D=E9=96=8B?= =?UTF-8?q?=E3=81=A8=E3=81=97=E3=81=A6=E6=89=B1=E3=81=84=E3=80=81=E5=85=83?= =?UTF-8?q?=E3=81=AE=E5=BC=95=E6=95=B0=E3=81=AE=E7=84=A1=E3=81=84=E7=99=BB?= =?UTF-8?q?=E9=8C=B2=E3=81=AE=20restart=20=E3=82=92=E6=AD=A2=E3=82=81?= =?UTF-8?q?=E3=82=8B=E5=89=8D=E3=81=AB=E6=96=AD=E3=82=8A=E3=80=81run=20--a?= =?UTF-8?q?gain=20=E3=81=AE=E8=A8=AD=E5=AE=9A=E3=82=92=E9=8C=A0=E3=81=AE?= =?UTF-8?q?=E5=BE=8C=E3=81=AB=201=20=E5=BA=A6=E3=81=A0=E3=81=91=E7=B5=84?= =?UTF-8?q?=E3=82=80=EF=BC=88#3604=20#3864=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - ハブは {"kind": "spawn", "again": true} も再開の要求として扱う(通常の spawn で新しい会話・制約の無い起動・登録簿の上書きをしない) - 登録簿に無い名前を --again で登録した項目に args_unknown を付け、restart は動いているラッパーを止める前に precondition で断る - run --again は錠の前に仮の設定(wrapper.again_pending)だけを渡し、プラグインの識別を 1 度読んで錠の後の設定に使い回す - a3f9753a3 で Lanes から起動の回数を外したのに残っていたテストの引数を直す Co-Authored-By: Claude Opus 5.5 --- plugins/ndf/src/ndf/domains/relay/cli.py | 26 ++++++++++++------ plugins/ndf/src/ndf/domains/relay/hub.py | 27 ++++++++++++++----- plugins/ndf/src/ndf/domains/relay/wrapper.py | 25 +++++++++++++++++ .../tests/domains/relay/test_relay_again.py | 19 +++++++++++++ .../tests/domains/relay/test_relay_decide.py | 7 +++-- .../ndf/tests/domains/relay/test_relay_hub.py | 24 +++++++++++++---- 6 files changed, 105 insertions(+), 23 deletions(-) diff --git a/plugins/ndf/src/ndf/domains/relay/cli.py b/plugins/ndf/src/ndf/domains/relay/cli.py index c18ed6ad2..48095165f 100644 --- a/plugins/ndf/src/ndf/domains/relay/cli.py +++ b/plugins/ndf/src/ndf/domains/relay/cli.py @@ -20,7 +20,6 @@ import argparse import contextlib -import dataclasses import io import json import os @@ -276,10 +275,13 @@ def again_rest(saved: Mapping[str, Any]) -> list[str]: return ["--resume", saved["session_id"], *saved["args"]] -def again_settings(name: str, saved: Mapping[str, Any], on_tty: bool) -> wrapper.Settings: - """再開の値で組んだラッパーの設定(`wrapper.Settings.again_load`。錠を取った後に呼ばれる)。""" +def again_settings(name: str, saved: Mapping[str, Any], on_tty: bool, ident: Optional[identity.PluginIdentity] = None) -> wrapper.Settings: + """再開の値で組んだラッパーの設定(`wrapper.Settings.again_load`。錠を取った後に呼ばれる)。 + + `ident` は錠の置き場を決めるときに読んだプラグインの識別(無ければ読む)。 + """ rest = again_rest(saved) - return wrapper_settings(name, rest, claude_args.parse(rest, os.environ, on_tty), saved) + return wrapper_settings(name, rest, claude_args.parse(rest, os.environ, on_tty), saved, ident) def _again_place(saved: Mapping[str, Any]) -> tuple[dict[str, str], Path, Optional[str]]: @@ -295,7 +297,11 @@ def _again_place(saved: Mapping[str, Any]) -> tuple[dict[str, str], Path, Option def wrapper_settings( - name: str, rest: list[str], parsed: Optional[claude_args.Parsed] = None, saved: Optional[Mapping[str, Any]] = None + name: str, + rest: list[str], + parsed: Optional[claude_args.Parsed] = None, + saved: Optional[Mapping[str, Any]] = None, + ident: Optional[identity.PluginIdentity] = None, ) -> wrapper.Settings: """`parsed` があれば引数をセッションごとに分けて渡す(無ければ `rest` をすべてのセッションに付ける)。 @@ -303,7 +309,7 @@ def wrapper_settings( (別のディレクトリで打っても同じ worktree で続ける。計画への質問の経路と更新の確かめも同じ値で組む)、作業ディレクトリが 無ければ `cwd_lost` にして起動しない。最初のセグメントはアカウントを選び直さず再開の値のもの(None は既定のログイン)を使う。 """ - ident = identity.load() + ident = ident or identity.load() if saved is None: environ = dict(os.environ) cwd, cwd_lost = _cwd(environ) @@ -377,8 +383,12 @@ def _run_again(args: argparse.Namespace, on_tty: bool) -> int: if gate.passthrough: why = f"--again はラッパーを挟めるときだけ使える({gate.passthrough})。NDF_RELAY=0 を外し、端末で打つ" return result.emit(result.stopped(TOOL, "precondition", why)) - base = dataclasses.replace(wrapper_settings(args.name, []), again_load=lambda saved: again_settings(args.name, saved, on_tty)) - return _wrap(base, "") + ident = identity.load() # 錠の置き場と、錠の後に組む設定の両方に使う。読み直さない + + def load(saved: Mapping[str, Any]) -> wrapper.Settings: + return again_settings(args.name, saved, on_tty, ident) + + return _wrap(wrapper.again_pending(ident.state_dir, str(ident.manifest["version"]), args.name, load), "") def _wrap(settings: wrapper.Settings, prompt: str) -> int: diff --git a/plugins/ndf/src/ndf/domains/relay/hub.py b/plugins/ndf/src/ndf/domains/relay/hub.py index a8d05799a..66b90b7f5 100644 --- a/plugins/ndf/src/ndf/domains/relay/hub.py +++ b/plugins/ndf/src/ndf/domains/relay/hub.py @@ -42,6 +42,9 @@ # `spawn --again` のリクエストの種類。`spawn` と分け、`again` を知らない同じメジャーの旧版が通常の spawn として起動せず # 「知らないリクエスト」で断るようにする(保存した作業ディレクトリ・会話・権限の制約を落とした起動をしない) SPAWN_AGAIN = "spawn-again" +# 登録簿の項目で、元の起動の引数を持たないことを表す印(登録簿に無い名前を `--again` で起動したとき)。restart は +# 権限の制約などを落として起動し直すことになるので、動いているラッパーを止める前に断る +ARGS_UNKNOWN = "args_unknown" class Outcome(NamedTuple): @@ -176,7 +179,7 @@ def handle(ctx: Context, req: Mapping[str, Any]) -> Outcome: kind = req.get("kind") try: if kind in ("spawn", SPAWN_AGAIN): - return spawn(requester(ctx, req), req) + return spawn(requester(ctx, req), req, again=is_again(req)) if kind == "restart": return restart(requester(ctx, req), str(req["name"])) if kind == "stop": @@ -186,6 +189,15 @@ def handle(ctx: Context, req: Mapping[str, Any]) -> Outcome: return Outcome(False, f"知らないリクエスト: {kind}", "invalid") +def is_again(req: Mapping[str, Any]) -> bool: + """`--again` の spawn か。同じメジャーの旧版の頼む側が送る `{"kind": "spawn", "again": true}` も含める。 + + 旧形式は作業ディレクトリも引数も持たないので、通常の spawn として扱うと状態の保存先で新しい会話を開き、 + 保存した権限の制約を落とし、登録簿の項目を上書きする。 + """ + return req.get("kind") == SPAWN_AGAIN or (req.get("kind") == "spawn" and req.get("again") is True) + + def requester(ctx: Context, req: Mapping[str, Any]) -> Context: """頼んだ側の導入(`plugin_root`・`version`)に差し替えた `ctx`。リクエストに無い・形が違えばリレーハブ自身の `ctx`。""" root, version = req.get("plugin_root"), req.get("version") @@ -201,8 +213,8 @@ def _next_name(taken: set[str]) -> str: return f"t{n}" -def spawn(ctx: Context, req: Mapping[str, Any]) -> Outcome: - """新しく起動する。""" +def spawn(ctx: Context, req: Mapping[str, Any], again: bool = False) -> Outcome: + """新しく起動する。`again`(`is_again`)なら再開の値で起動する。""" entries = registry.read_registry(hub_dir(ctx.state_dir)) running = registry.all_running(ctx.state_dir, ctx.environ) refused = _refused(hub_decide.mixed(ctx.version, running), "precondition") @@ -217,7 +229,6 @@ def spawn(ctx: Context, req: Mapping[str, Any]) -> Outcome: refused = _refused(hub_decide.spawn(lanes), "refused") if refused is not None: return refused - again = req.get("kind") == SPAWN_AGAIN account: Optional[str] = None if again: entry, kept, account = _again_entries(ctx, name, entries.get(name)) @@ -241,11 +252,12 @@ def _again_entries( 起動は再開の値(`registry.read_again`)の作業ディレクトリ・役割・計画で行い、引数は後継のラッパーが再開の値から読む。 登録簿には登録時の項目(最初の作業指示を含む引数)を残し、1 回だけの `--resume` で上書きしない(restart が元の指示で 起動し直せる)。登録簿に無ければ引数を持たない項目で登録する(再開の値の引数は認証のヘッダーなどを含みうるので、 - 0600 でない登録簿にも、restart が組む tmux のコマンドにも移さない)。 + 0600 でない登録簿にも、restart が組む tmux のコマンドにも移さない)。その項目には `ARGS_UNKNOWN` を付け、 + restart が元の引数(権限の制約など)を落として起動し直さないようにする。 """ saved = registry.read_again(registry.wrapper_dir(ctx.state_dir, name)) entry = {"cwd": saved["cwd"], "args": [], "role": saved["role"], "plan": saved["plan"]} - kept = _current(registered) if registered is not None else dict(entry) + kept = _current(registered) if registered is not None else {**entry, ARGS_UNKNOWN: True} return entry, kept, saved["account"] @@ -255,6 +267,9 @@ def restart(ctx: Context, name: str) -> Outcome: entry = entries.get(name) if entry is None: return Outcome(False, f"{name} は登録簿に無い。spawn で起動する", "invalid") + if entry.get(ARGS_UNKNOWN): + why = f"{name} は元の起動の引数が登録簿に無い(--again で登録した)。ndf relay stop の後、引数を付けて spawn で起動する" + return Outcome(False, why, "precondition") running = registry.all_running(ctx.state_dir, ctx.environ) others = [r for r in running if r.name != name] refused = _refused(hub_decide.mixed(ctx.version, others), "precondition") diff --git a/plugins/ndf/src/ndf/domains/relay/wrapper.py b/plugins/ndf/src/ndf/domains/relay/wrapper.py index 1e9802626..833644fb0 100644 --- a/plugins/ndf/src/ndf/domains/relay/wrapper.py +++ b/plugins/ndf/src/ndf/domains/relay/wrapper.py @@ -141,6 +141,31 @@ class Settings: again_load: Optional[Callable[[Mapping[str, Any]], Settings]] = None +def again_pending(state_dir: Path, version: str, name: str, load: Callable[[Mapping[str, Any]], Settings]) -> Settings: + """`--again` の錠を取る前の設定。錠の置き場(`state_dir`・`name`)と `again_load` だけが意味を持つ。 + + ほかの値は錠を取った後に `load` が組む設定で置き換わる(`Wrapper.run`)。プラグインの更新や計画への質問の手を + 錠の前に組まず、再開のたびに設定を 2 度組まない。 + """ + return Settings( + state_dir=state_dir, + version=version, + name=name, + cwd=state_dir, + environ={}, + args=(), + tick=0.0, + quiet=0.0, + stall=0.0, + spin=switch_decide.Spin(0, 0.0), + context_limit=0, + usage_threshold=0.0, + transcript_bytes=0, + again=True, + again_load=load, + ) + + @dataclass(frozen=True) class Launch: """セグメントを始める要求。`resume` が真なら `--resume` で同じ会話を続け、偽なら `--session-id` で新しく始める。 diff --git a/plugins/ndf/tests/domains/relay/test_relay_again.py b/plugins/ndf/tests/domains/relay/test_relay_again.py index 17e604cf7..5a2bae510 100644 --- a/plugins/ndf/tests/domains/relay/test_relay_again.py +++ b/plugins/ndf/tests/domains/relay/test_relay_again.py @@ -98,3 +98,22 @@ def test_i15_run_again_refuses_where_the_wrapper_cannot_run(tmp_path, monkeypatc args = relay_cli._parse(["run", "--name", "t1", "--again"]) code = relay_cli._run_again(args, on_tty) assert code != 0 and json.loads(capsys.readouterr().out)["cause"]["kind"] == "precondition" + + +def test_i15_run_again_builds_the_settings_once_after_the_lock(tmp_path, monkeypatch): + # 決定 13: run --again は錠の前に設定を組まず(プラグインの更新・計画への質問の手を作らない)、プラグインの識別は + # 1 度だけ読み、錠を取った後に再開の値で 1 度だけ組む + calls: list = [] + loads: list = [] + real_load, real_settings = relay_cli.identity.load, relay_cli.wrapper_settings + monkeypatch.setattr(relay_cli.identity, "load", lambda: loads.append(1) or real_load()) + monkeypatch.setattr(relay_cli, "wrapper_settings", lambda *a, **k: calls.append(a) or real_settings(*a, **k)) + monkeypatch.delenv("NDF_RELAY", raising=False) + seen: list = [] + monkeypatch.setattr(relay_cli, "_wrap", lambda settings, prompt: seen.append(settings) or 0) + assert relay_cli._run_again(relay_cli._parse(["run", "--name", "t1", "--again"]), True) == 0 + pending = seen[0] + assert calls == [] and loads == [1] and pending.again and pending.update is None and pending.ask_plan is None + saved = {"session_id": "s1", "args": [], "account": None, "cwd": str(tmp_path), "role": None, "plan": None} + built = pending.again_load(saved) + assert len(calls) == 1 and loads == [1] and built.state_dir == pending.state_dir and built.cwd == tmp_path diff --git a/plugins/ndf/tests/domains/relay/test_relay_decide.py b/plugins/ndf/tests/domains/relay/test_relay_decide.py index 11cbeebb4..0ca73bc73 100644 --- a/plugins/ndf/tests/domains/relay/test_relay_decide.py +++ b/plugins/ndf/tests/domains/relay/test_relay_decide.py @@ -270,11 +270,10 @@ def test_after_limit_switches_even_with_background_waits_and_resumes_after_reset def test_restart_judges_limits_before_stopping_and_excludes_the_target(): # 上限 3 で 3 本が動いているとき、そのうち 1 本の restart は通る(#2753) - assert hub_decide.restart(hub_decide.Lanes(3, 3, True, 0, 5)).kind == "go" + assert hub_decide.restart(hub_decide.Lanes(3, 3, True)).kind == "go" # 動いていない 1 本の restart は上限に数える - assert hub_decide.restart(hub_decide.Lanes(3, 3, False, 0, 5)).kind == "refuse" - assert hub_decide.restart(hub_decide.Lanes(1, 3, True, 5, 5)).kind == "refuse" - assert hub_decide.spawn(hub_decide.Lanes(3, 3, False, 0, 5)).kind == "refuse" + assert hub_decide.restart(hub_decide.Lanes(3, 3, False)).kind == "refuse" + assert hub_decide.spawn(hub_decide.Lanes(3, 3, False)).kind == "refuse" def test_started_needs_the_wrapper_location_a_live_process_and_registration(): diff --git a/plugins/ndf/tests/domains/relay/test_relay_hub.py b/plugins/ndf/tests/domains/relay/test_relay_hub.py index 8f81bb50e..bb95660d0 100644 --- a/plugins/ndf/tests/domains/relay/test_relay_hub.py +++ b/plugins/ndf/tests/domains/relay/test_relay_hub.py @@ -399,15 +399,29 @@ def test_i15_spawn_again_without_saved_values_is_invalid(ctx): def test_i15_spawn_again_without_a_registry_entry_keeps_the_saved_args_out_of_the_registry(ctx): - # 決定 13: 登録の無い名前の spawn --again は、再開の値の引数(認証のヘッダーを含みうる)を 0600 でない登録簿に移さず、 - # 後の restart の tmux のコマンドにも載せない - secret = ["--mcp-config", '{"headers":{"Authorization":"Bearer sk-secret"}}'] + # 決定 13: 登録の無い名前の spawn --again は、再開の値の引数(認証のヘッダー・権限の制約を含みうる)を 0600 でない + # 登録簿に移さない。元の引数を持たない項目の restart は、動いているラッパーを止める前に断る(制約を落として起動しない) + secret = ["--mcp-config", '{"headers":{"Authorization":"Bearer sk-secret"}}', "--permission-mode", "plan"] saved = {"session_id": "s1", "args": secret, "account": None, "cwd": "/w2", "role": None, "plan": None} registry.write_again(registry.wrapper_dir(ctx.state_dir, "t1"), saved) assert hub.submit(ctx, {"kind": hub.SPAWN_AGAIN, "name": "t1"}).ok assert "sk-secret" not in (hub.hub_dir(ctx.state_dir) / registry.REGISTRY_FILE).read_text(encoding="utf-8") - assert hub.submit(ctx, {"kind": "restart", "name": "t1"}).ok - assert "sk-secret" not in " ".join(ctx.tmux.commands[1]) + got = hub.submit(ctx, {"kind": "restart", "name": "t1"}) + assert (got.ok, got.cause) == (False, "precondition") + assert len(ctx.tmux.started) == 1 and ctx.tmux.has("t1") + + +def test_i15_spawn_again_in_the_older_form_resumes_and_keeps_the_registry_entry(ctx): + # 決定 13: 同じメジャーの旧版が送る {"kind": "spawn", "again": true} も再開として扱い、通常の spawn として状態の + # 保存先で新しい会話を開いたり、登録簿の引数(権限の制約)を上書きしたりしない + first = ["--permission-mode", "plan", "/goal 最初の作業"] + _register(ctx, {"cwd": "/w", "args": first, "role": None, "plan": None, "version": VERSION}) + saved = {"session_id": "s1", "args": [], "account": None, "cwd": "/w2", "role": None, "plan": None} + registry.write_again(registry.wrapper_dir(ctx.state_dir, "t1"), saved) + got = hub.submit(ctx, {"kind": "spawn", "name": "t1", "again": True}) + assert got.ok, got.summary + assert ctx.tmux.commands[0][-4:] == ["run", "--name", "t1", "--again"] + assert registry.read_registry(hub.hub_dir(ctx.state_dir))["t1"]["args"] == first def test_i15_spawn_again_builds_the_env_from_the_saved_account_without_choosing(ctx, monkeypatch): From f6162275c54071fcecac7567ab825bf2247cad2e Mon Sep 17 00:00:00 2001 From: "takemi.ohama" Date: Sun, 22 Nov 2026 00:02:37 +0000 Subject: [PATCH 09/12] =?UTF-8?q?Revert:=20=E5=86=8D=E8=B5=B7=E5=8B=95?= =?UTF-8?q?=E3=83=AB=E3=83=BC=E3=83=97=E3=81=AE=E6=A1=88=E5=86=85=E3=81=8B?= =?UTF-8?q?=E3=82=89=E5=85=83=E3=81=AE=E5=BC=95=E6=95=B0=E3=83=BB=E3=82=A2?= =?UTF-8?q?=E3=82=AB=E3=82=A6=E3=83=B3=E3=83=88=E3=83=BB=E6=A8=A9=E9=99=90?= =?UTF-8?q?=E3=82=92=E5=BC=95=E3=81=8D=E7=B6=99=E3=81=84=E3=81=A7=E5=86=8D?= =?UTF-8?q?=E9=96=8B=E3=81=99=E3=82=8B=E4=BB=95=E7=B5=84=E3=81=BF=EF=BC=88?= =?UTF-8?q?--again=E3=83=BB=E5=86=8D=E9=96=8B=E3=81=AE=E5=80=A4=EF=BC=89?= =?UTF-8?q?=E3=82=92=E6=88=BB=E3=81=99=EF=BC=88#3604=20#3864=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit cross-review の r2-1〜r5-3 の修正が足した仕組みで、承認済みの設計(SPIN_LINE は案内の 1 行)に無い起動引数と保存の形を足すため、設計への指摘として集める。戻すのは 5d3648b8d・d39e544eb・58a50f31c・6641e287c。r1-2 の案内のサブコマンドの直し(c69255d1e)は残す。 Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP --- .../schemas/io/relay.args.schema.json | 8 -- plugins/ndf/docs/contracts/commands.md | 4 +- .../development-workflow/references/relay.md | 2 +- plugins/ndf/src/ndf/domains/relay/cli.py | 109 ++-------------- plugins/ndf/src/ndf/domains/relay/hub.py | 85 +++---------- plugins/ndf/src/ndf/domains/relay/registry.py | 30 ----- plugins/ndf/src/ndf/domains/relay/wrapper.py | 95 ++------------ .../tests/domains/relay/test_relay_again.py | 119 ------------------ .../tests/domains/relay/test_relay_decide.py | 7 +- .../ndf/tests/domains/relay/test_relay_hub.py | 76 +---------- .../tests/domains/relay/test_relay_wrapper.py | 78 ++---------- 11 files changed, 54 insertions(+), 559 deletions(-) delete mode 100644 plugins/ndf/tests/domains/relay/test_relay_again.py diff --git a/plugins/ndf/contracts/schemas/io/relay.args.schema.json b/plugins/ndf/contracts/schemas/io/relay.args.schema.json index b1cf0bec6..eaea2d301 100644 --- a/plugins/ndf/contracts/schemas/io/relay.args.schema.json +++ b/plugins/ndf/contracts/schemas/io/relay.args.schema.json @@ -504,10 +504,6 @@ "--name": { "type": "string" }, - "--again": { - "type": "boolean", - "description": "再起動ループの案内のとおり、書き置いた再開の値で同じ会話を続ける" - }, "rest": { "type": "array", "items": { @@ -534,10 +530,6 @@ "--name": { "type": "string" }, - "--again": { - "type": "boolean", - "description": "再起動ループの案内のとおり、書き置いた再開の値で同じ会話を続ける" - }, "rest": { "type": "array", "items": { diff --git a/plugins/ndf/docs/contracts/commands.md b/plugins/ndf/docs/contracts/commands.md index 28c8593d2..32756525d 100644 --- a/plugins/ndf/docs/contracts/commands.md +++ b/plugins/ndf/docs/contracts/commands.md @@ -324,8 +324,8 @@ | `ndf relay notice` | 引数を受けない | | `ndf relay pending` | 引数を受けない | | `ndf relay restart` | `name`(string・必須・位置) | -| `ndf relay run` | `--name`(string・任意)
`--again`(boolean・任意): 再起動ループの案内のとおり、書き置いた再開の値で同じ会話を続ける
`rest`(array of string・任意・位置)
`--prompt`(string・任意) | -| `ndf relay spawn` | `--name`(string・任意)
`--again`(boolean・任意): 再起動ループの案内のとおり、書き置いた再開の値で同じ会話を続ける
`rest`(array of string・任意・位置)
`--cwd`(string・任意)
`--role`(string・任意)
`--plan`(string・任意) | +| `ndf relay run` | `--name`(string・任意)
`rest`(array of string・任意・位置)
`--prompt`(string・任意) | +| `ndf relay spawn` | `--name`(string・任意)
`rest`(array of string・任意・位置)
`--cwd`(string・任意)
`--role`(string・任意)
`--plan`(string・任意) | | `ndf relay status` | 引数を受けない | | `ndf relay stop` | `name`(string・任意・位置): 止めるラッパーの名前
`--all`(boolean・任意): 動いている名前つきのラッパーをすべて止める | | `ndf relay uninstall` | 引数を受けない | diff --git a/plugins/ndf/skills/development-workflow/references/relay.md b/plugins/ndf/skills/development-workflow/references/relay.md index 0e6135327..5d822f20f 100644 --- a/plugins/ndf/skills/development-workflow/references/relay.md +++ b/plugins/ndf/skills/development-workflow/references/relay.md @@ -392,7 +392,7 @@ claude のアカウントを 2 つ以上登録しておくと、利用上限で | `プラグインを更新できなかった(<理由>)。<バージョン> で次のセグメントを起動する` | 更新に失敗した。ラッパーは止まらず、そのバージョンで次のセグメントを起動した | 何もしなくてよい。ラッパーが次のカットポイントで更新を打ち直す | | `メジャーバージョンが <ラッパー> から <起動先> に変わった。次のセグメントを起動しない。…` | ラッパーは終わった(終了コード 3)。`relay.root` は起動先へ向け直してある | 1 行の案内どおり `claude` を打ち直し、conductor のブロックの中身を最初の入力にする | | `子の claude を起動できない(<理由>)` | ラッパーは終わった(終了コード 3)。子は起動していない | 理由(作業ディレクトリが無い・`claude` が PATH に無いなど)を直してから、conductor のブロックの中身で `claude` を打ち直す | -| `起動から <秒> 秒未満で次のセグメントへ移ったセグメントが <数> つ続いた(再起動ループ)。次のセグメントを起動しない。…` | 再起動ループの検出(「[上限](#上限)」)に当たった。今のセッションは動いたまま | 原因を直してから起動し直す。ラッパーは再開の値(今のセッション ID・起動時に付けた引数(`--permission-mode`・`--disallowedTools`・`--settings` など)・今のアカウント・作業ディレクトリ・役割・計画)を `<状態の保存先>/relay/wrappers/<名前>/again.json` へ 0600 で書き、案内には名前と `--again` だけを出す(引数の秘密や複数行の値を画面に出さない)。端末で打ったラッパーは `/exit` し、1 行の案内どおり `ndf relay run --name <名前> --again` で同じ会話を続ける。`ndf relay spawn` で起動した名前つきのラッパーは、作業を保存してから `/exit` し、tmux の外から 1 行の案内どおり `ndf relay spawn --name <名前> --again` を打つ(`ndf relay restart` は登録簿の最初の作業指示で起動し直すので使わない。`--again` は登録簿の引数を書き換えないので、後の restart は元の作業指示で起動する)。どちらもアカウントを選び直さず、打った場所によらず再開の値の作業ディレクトリ・役割・計画で起動する。再開の値はラッパーの錠を取った後に読み、起動できたらその値だけを消す。`NDF_RELAY=0` や端末でない(標準出力のリダイレクトなど)ときの `run --again` は claude を直接起動せずに断る。登録簿に無い名前の `spawn --again` は引数を持たない項目で登録する(再開の値の引数を登録簿へ移さない) | +| `起動から <秒> 秒未満で次のセグメントへ移ったセグメントが <数> つ続いた(再起動ループ)。次のセグメントを起動しない。…` | 再起動ループの検出(「[上限](#上限)」)に当たった。今のセッションは動いたまま | 原因を直してから起動し直す。端末で打ったラッパーは `/exit` し、1 行の案内どおり `ndf relay run --resume <セッション ID>` で同じ会話を続ける。`ndf relay spawn` で起動した名前つきのラッパーは、1 行の案内どおり tmux の外から `ndf relay restart <名前>` を打つ | | 上の 5 つ以外(`ndf-relay: <理由>`) | ラッパーは終わった。終了コードは停止理由の種類(`contracts/causes.json`)のとおり。再起動ループの検出で、子が終わった後に止まったときもこの行になる(終了コードは子の終了コード) | 理由を直してから、conductor のブロックの中身で `claude` を起動する | ## fork したセッションで進めたとき diff --git a/plugins/ndf/src/ndf/domains/relay/cli.py b/plugins/ndf/src/ndf/domains/relay/cli.py index 48095165f..0b8d83dff 100644 --- a/plugins/ndf/src/ndf/domains/relay/cli.py +++ b/plugins/ndf/src/ndf/domains/relay/cli.py @@ -179,12 +179,7 @@ def _hub(args: argparse.Namespace) -> int: if args.action == "ls": rows = hub.listing(ctx) return result.emit(result.result(TOOL, result.OK, f"名前つきのラッパー: {len(rows)} 本", items=rows)) - if args.action == "spawn" and args.again: - refused = _again_refused(args, ("cwd", "role", "plan")) - if refused: - return result.emit(result.stopped(TOOL, "invalid", refused)) - req = {"kind": hub.SPAWN_AGAIN, "name": args.name} - elif args.action == "spawn": + if args.action == "spawn": cwd = str(Path(args.cwd).resolve()) if args.cwd else os.getcwd() req = {"kind": "spawn", "name": args.name, "cwd": cwd, "role": args.role, "plan": args.plan, "args": args.rest} elif args.action == "stop" and args.all: @@ -262,59 +257,11 @@ def _session_args(rest: list[str], parsed: Optional[claude_args.Parsed]) -> dict } -def _again_refused(args: argparse.Namespace, others: tuple[str, ...]) -> str: - """`--again` と一緒に渡せない値があれば断る理由(再開の値がすべてを持つ)。無ければ空。""" - if not args.name: - return "--again には再起動ループの案内に出た --name を付ける" - given = [f"--{k}" for k in others if getattr(args, k, None)] + (["claude の引数"] if args.rest else []) - return f"--again には {'・'.join(given)} を付けない(再開の値を使う)" if given else "" - - -def again_rest(saved: Mapping[str, Any]) -> list[str]: - """再開の値(`registry.read_again`)から claude の引数(`--resume ` と引き継ぐ引数)を組む。""" - return ["--resume", saved["session_id"], *saved["args"]] - - -def again_settings(name: str, saved: Mapping[str, Any], on_tty: bool, ident: Optional[identity.PluginIdentity] = None) -> wrapper.Settings: - """再開の値で組んだラッパーの設定(`wrapper.Settings.again_load`。錠を取った後に呼ばれる)。 - - `ident` は錠の置き場を決めるときに読んだプラグインの識別(無ければ読む)。 - """ - rest = again_rest(saved) - return wrapper_settings(name, rest, claude_args.parse(rest, os.environ, on_tty), saved, ident) - - -def _again_place(saved: Mapping[str, Any]) -> tuple[dict[str, str], Path, Optional[str]]: - """再開の値の(環境, 作業ディレクトリ, 読めなかったときの表示)。役割・計画は再開の値で置き換える(無ければ外す)。""" +def wrapper_settings(name: str, rest: list[str], parsed: Optional[claude_args.Parsed] = None) -> wrapper.Settings: + """`parsed` があれば引数をセッションごとに分けて渡す(無ければ `rest` をすべてのセッションに付ける)。""" + ident = identity.load() environ = dict(os.environ) - for key, value in (("NDF_RELAY_ROLE", saved["role"]), ("NDF_RELAY_PLAN", saved["plan"])): - if value: - environ[key] = value - else: - environ.pop(key, None) - cwd = Path(saved["cwd"]) - return environ, cwd, None if cwd.is_dir() else saved["cwd"] - - -def wrapper_settings( - name: str, - rest: list[str], - parsed: Optional[claude_args.Parsed] = None, - saved: Optional[Mapping[str, Any]] = None, - ident: Optional[identity.PluginIdentity] = None, -) -> wrapper.Settings: - """`parsed` があれば引数をセッションごとに分けて渡す(無ければ `rest` をすべてのセッションに付ける)。 - - `saved`(`--again` の再開の値)があれば、打った場所の値でなく再開の値の作業ディレクトリ・役割・計画で組み - (別のディレクトリで打っても同じ worktree で続ける。計画への質問の経路と更新の確かめも同じ値で組む)、作業ディレクトリが - 無ければ `cwd_lost` にして起動しない。最初のセグメントはアカウントを選び直さず再開の値のもの(None は既定のログイン)を使う。 - """ - ident = ident or identity.load() - if saved is None: - environ = dict(os.environ) - cwd, cwd_lost = _cwd(environ) - else: - environ, cwd, cwd_lost = _again_place(saved) + cwd, cwd_lost = _cwd(environ) raw = ident.manifest["version"] # identity.load() が name と同じ読み取りで得たバージョン。読み直さない(#3909) updater = plugin_update.Updater( root=ident.root, @@ -342,8 +289,6 @@ def wrapper_settings( ask_plan=lane_question.plan_asker(environ, name, cwd, ident.root, limits.seconds("relay.lanes-ask")), update=updater, confirm=updater.confirm, - again=saved is not None, - first_account=saved["account"] if saved is not None else None, ) @@ -360,46 +305,19 @@ def _passthrough(rest: list[str], parsed: claude_args.Parsed) -> int: def _run(args: argparse.Namespace) -> int: - on_tty = sys.stdin.isatty() and sys.stdout.isatty() - if args.again: - return _run_again(args, on_tty) name = args.name or os.environ.get("NDF_RELAY_NAME") or f"w{os.getpid()}" - parsed = claude_args.parse(args.rest, os.environ, on_tty) + parsed = claude_args.parse(args.rest, os.environ, sys.stdin.isatty() and sys.stdout.isatty()) if parsed.passthrough: return _passthrough(args.rest, parsed) - return _wrap(wrapper_settings(name, args.rest, parsed), args.prompt or parsed.prompt or "") # noqa: NDF501 利用者の入力: 最初の 1 行が無ければ空の入力欄で始める - - -def _run_again(args: argparse.Namespace, on_tty: bool) -> int: - """`run --again`。ラッパーを挟めない条件(`NDF_RELAY=0`・端末でない)なら claude を直接起動せず、起動前に断る。 - - 再開の値は錠を取った後にラッパーが読む(`wrapper.Settings.again_load`)。直接起動では保存したアカウントを使えず、 - 再開の値も使い終わらない。 - """ - refused = _again_refused(args, ("prompt",)) - if refused: - return result.emit(result.stopped(TOOL, "invalid", refused)) - gate = claude_args.parse([], os.environ, on_tty) - if gate.passthrough: - why = f"--again はラッパーを挟めるときだけ使える({gate.passthrough})。NDF_RELAY=0 を外し、端末で打つ" - return result.emit(result.stopped(TOOL, "precondition", why)) - ident = identity.load() # 錠の置き場と、錠の後に組む設定の両方に使う。読み直さない - - def load(saved: Mapping[str, Any]) -> wrapper.Settings: - return again_settings(args.name, saved, on_tty, ident) - - return _wrap(wrapper.again_pending(ident.state_dir, str(ident.manifest["version"]), args.name, load), "") - - -def _wrap(settings: wrapper.Settings, prompt: str) -> int: - """端末を raw にしてラッパーを回し、終わったら端末を戻す。""" tty_in = sys.stdin.isatty() saved = termios.tcgetattr(sys.stdin.fileno()) if tty_in else None if tty_in: tty.setraw(sys.stdin.fileno()) try: - w = wrapper.Wrapper(settings, out=sys.stdout.buffer, stdin_fd=sys.stdin.fileno() if tty_in else None) - ended = w.run(prompt) + w = wrapper.Wrapper( + wrapper_settings(name, args.rest, parsed), out=sys.stdout.buffer, stdin_fd=sys.stdin.fileno() if tty_in else None + ) + ended = w.run(args.prompt or parsed.prompt or "") # noqa: NDF501 利用者の入力: 最初の 1 行が無ければ空の入力欄で始める finally: if saved is not None: termios.tcsetattr(sys.stdin.fileno(), termios.TCSADRAIN, saved) @@ -428,7 +346,6 @@ def _parser() -> argparse.ArgumentParser: cli_account.parser(sub, COMMANDS["account"]) for name in ("run", "spawn"): p[name].add_argument("--name") - p[name].add_argument("--again", action="store_true", help="再起動ループの案内のとおり、書き置いた再開の値で同じ会話を続ける") p[name].add_argument("rest", nargs=argparse.REMAINDER) p["run"].add_argument("--prompt") for opt in ("--cwd", "--role", "--plan"): @@ -442,8 +359,6 @@ def _parser() -> argparse.ArgumentParser: OWN_OPTIONS = {"run": ("--name", "--prompt"), "spawn": ("--name", "--cwd", "--role", "--plan")} -# 値を取らない ndf のオプション(run・spawn の両方) -OWN_FLAGS = ("--again",) def _split_claude_args(argv: list[str]) -> list[str]: @@ -458,9 +373,7 @@ def _split_claude_args(argv: list[str]) -> list[str]: word = argv[i] if word in ("-h", "--help", "--"): return argv - if word in OWN_FLAGS: - i += 1 - elif word in own: + if word in own: i += 2 elif word.split("=", 1)[0] in own: i += 1 diff --git a/plugins/ndf/src/ndf/domains/relay/hub.py b/plugins/ndf/src/ndf/domains/relay/hub.py index 66b90b7f5..09c1728e3 100644 --- a/plugins/ndf/src/ndf/domains/relay/hub.py +++ b/plugins/ndf/src/ndf/domains/relay/hub.py @@ -39,12 +39,6 @@ # 受付箱。導入(plugin_root・version)を読まない旧版は `requests/` だけを読むので、別の名前にして旧版に処理させない(#3909)。 # 旧版の頼む側は自分の drain で `requests/` を処理する(排他は共通の hub.lock) REQUESTS_DIR = "requests-v2" -# `spawn --again` のリクエストの種類。`spawn` と分け、`again` を知らない同じメジャーの旧版が通常の spawn として起動せず -# 「知らないリクエスト」で断るようにする(保存した作業ディレクトリ・会話・権限の制約を落とした起動をしない) -SPAWN_AGAIN = "spawn-again" -# 登録簿の項目で、元の起動の引数を持たないことを表す印(登録簿に無い名前を `--again` で起動したとき)。restart は -# 権限の制約などを落として起動し直すことになるので、動いているラッパーを止める前に断る -ARGS_UNKNOWN = "args_unknown" class Outcome(NamedTuple): @@ -178,8 +172,8 @@ def handle(ctx: Context, req: Mapping[str, Any]) -> Outcome: """リクエスト 1 本を処理する。起動・再起動は頼んだ側の導入で行う(`requester`)。""" kind = req.get("kind") try: - if kind in ("spawn", SPAWN_AGAIN): - return spawn(requester(ctx, req), req, again=is_again(req)) + if kind == "spawn": + return spawn(requester(ctx, req), req) if kind == "restart": return restart(requester(ctx, req), str(req["name"])) if kind == "stop": @@ -189,15 +183,6 @@ def handle(ctx: Context, req: Mapping[str, Any]) -> Outcome: return Outcome(False, f"知らないリクエスト: {kind}", "invalid") -def is_again(req: Mapping[str, Any]) -> bool: - """`--again` の spawn か。同じメジャーの旧版の頼む側が送る `{"kind": "spawn", "again": true}` も含める。 - - 旧形式は作業ディレクトリも引数も持たないので、通常の spawn として扱うと状態の保存先で新しい会話を開き、 - 保存した権限の制約を落とし、登録簿の項目を上書きする。 - """ - return req.get("kind") == SPAWN_AGAIN or (req.get("kind") == "spawn" and req.get("again") is True) - - def requester(ctx: Context, req: Mapping[str, Any]) -> Context: """頼んだ側の導入(`plugin_root`・`version`)に差し替えた `ctx`。リクエストに無い・形が違えばリレーハブ自身の `ctx`。""" root, version = req.get("plugin_root"), req.get("version") @@ -213,8 +198,8 @@ def _next_name(taken: set[str]) -> str: return f"t{n}" -def spawn(ctx: Context, req: Mapping[str, Any], again: bool = False) -> Outcome: - """新しく起動する。`again`(`is_again`)なら再開の値で起動する。""" +def spawn(ctx: Context, req: Mapping[str, Any]) -> Outcome: + """新しく起動する。""" entries = registry.read_registry(hub_dir(ctx.state_dir)) running = registry.all_running(ctx.state_dir, ctx.environ) refused = _refused(hub_decide.mixed(ctx.version, running), "precondition") @@ -229,47 +214,23 @@ def spawn(ctx: Context, req: Mapping[str, Any], again: bool = False) -> Outcome: refused = _refused(hub_decide.spawn(lanes), "refused") if refused is not None: return refused - account: Optional[str] = None - if again: - entry, kept, account = _again_entries(ctx, name, entries.get(name)) - else: - entry = kept = {k: req.get(k) for k in ("cwd", "args", "role", "plan")} - env = _checked_env(ctx, name, entry, account, decided=again) + entry = {k: req.get(k) for k in ("cwd", "args", "role", "plan")} + env = _checked_env(ctx, name, entry) if isinstance(env, Outcome): return env - got = _launch(ctx, name, entry, env, again=again) + got = _launch(ctx, name, entry, env) if got.ok: - entries[name] = {**kept, "version": ctx.version} + entries[name] = {**entry, "version": ctx.version} registry.save_registry(hub_dir(ctx.state_dir), entries) return got -def _again_entries( - ctx: Context, name: str, registered: Optional[Mapping[str, Any]] -) -> tuple[dict[str, Any], dict[str, Any], Optional[str]]: - """`--again` の spawn で(起動に使う項目, 登録簿に残す項目, 再開の値のアカウント)。 - - 起動は再開の値(`registry.read_again`)の作業ディレクトリ・役割・計画で行い、引数は後継のラッパーが再開の値から読む。 - 登録簿には登録時の項目(最初の作業指示を含む引数)を残し、1 回だけの `--resume` で上書きしない(restart が元の指示で - 起動し直せる)。登録簿に無ければ引数を持たない項目で登録する(再開の値の引数は認証のヘッダーなどを含みうるので、 - 0600 でない登録簿にも、restart が組む tmux のコマンドにも移さない)。その項目には `ARGS_UNKNOWN` を付け、 - restart が元の引数(権限の制約など)を落として起動し直さないようにする。 - """ - saved = registry.read_again(registry.wrapper_dir(ctx.state_dir, name)) - entry = {"cwd": saved["cwd"], "args": [], "role": saved["role"], "plan": saved["plan"]} - kept = _current(registered) if registered is not None else {**entry, ARGS_UNKNOWN: True} - return entry, kept, saved["account"] - - def restart(ctx: Context, name: str) -> Outcome: """止める前に上限とバージョンを判定し、通ったときだけ止めてから起動する。""" entries = registry.read_registry(hub_dir(ctx.state_dir)) entry = entries.get(name) if entry is None: return Outcome(False, f"{name} は登録簿に無い。spawn で起動する", "invalid") - if entry.get(ARGS_UNKNOWN): - why = f"{name} は元の起動の引数が登録簿に無い(--again で登録した)。ndf relay stop の後、引数を付けて spawn で起動する" - return Outcome(False, why, "precondition") running = registry.all_running(ctx.state_dir, ctx.environ) others = [r for r in running if r.name != name] refused = _refused(hub_decide.mixed(ctx.version, others), "precondition") @@ -294,16 +255,13 @@ def restart(ctx: Context, name: str) -> Outcome: return _with_pending(got, pending) -def _checked_env( - ctx: Context, name: str, entry: Mapping[str, Any], account: Optional[str] = None, decided: bool = False -) -> "dict[str, str] | Outcome": +def _checked_env(ctx: Context, name: str, entry: Mapping[str, Any]) -> "dict[str, str] | Outcome": """後継へ渡す環境。`NDF_RELAY_SPIN` が不正なら precondition の結果(#3864 の決定 13)。 ラッパーの設定(`wrapper_settings`)で落ちる値を、動いているレーンを止める前に断る。確かめた環境を そのまま `_launch` へ渡し、起動の時に作り直さない(アカウントの選び方を読み直さず、確かめた値と食い違わない)。 - `decided`(`--again`)なら今のアカウントの選び方を読まず、再開の値の `account` で組む(`spawn_env`)。 """ - env = spawn_env(ctx.environ, ctx.state_dir, name, entry, account, decided) + env = spawn_env(ctx.environ, ctx.state_dir, name, entry) try: spin_of(env) except limits.EnvError as exc: @@ -355,23 +313,14 @@ def stop(ctx: Context, name: str) -> Outcome: return Outcome(True, f"{name} を止めた") -def spawn_env( - environ: Mapping[str, str], - state_dir: Path, - name: str, - entry: Mapping[str, Any], - account: Optional[str] = None, - decided: bool = False, -) -> dict[str, str]: +def spawn_env(environ: Mapping[str, str], state_dir: Path, name: str, entry: Mapping[str, Any]) -> dict[str, str]: """名前つきのラッパーへ渡す環境(子のセッションの環境に、名前・役割・計画の名前を足す)。 - `decided` なら `account`(None は既定のログイン)で組み、今のアカウントの選び方を読まない(`session_env.child_env`)。 - 計画の名前(`NDF_RELAY_PLAN`)があれば、ラッパーは子の質問を計画のリクエストとして載せる(`lane_question`。#3035)。 `NDF_RELAY_SPIN` は無くても空文字で入れる。tmux の `new-session` は渡した名前だけを `-e` で上書きするので、 落とすと既存の tmux サーバーのグローバル環境に残る値を後継が読み、事前の確かめと食い違う(#3864 の決定 13)。 """ - env = session_env.child_env(environ, state_dir, account, decided) + env = session_env.child_env(environ, state_dir) extra = {"NDF_RELAY_NAME": name, "NDF_RELAY_SPAWNED": "1", "NDF_RELAY_ROLE": entry.get("role"), "NDF_RELAY_PLAN": entry.get("plan")} env.update({k: str(v) for k, v in extra.items() if v}) spin = environ.get("NDF_RELAY_SPIN") @@ -379,19 +328,15 @@ def spawn_env( return env -def _launch(ctx: Context, name: str, entry: Mapping[str, Any], env: Mapping[str, str], again: bool = False) -> Outcome: - """確かめ済みの環境 `env`(`_checked_env`)で tmux のセッションを作り、ラッパーが立つのを確かめる。 - - `again` なら claude の引数を渡さず `--again` で起動する(後継が 0600 の再開の値から読む。引数を tmux のコマンドに載せない)。 - """ +def _launch(ctx: Context, name: str, entry: Mapping[str, Any], env: Mapping[str, str]) -> Outcome: + """確かめ済みの環境 `env`(`_checked_env`)で tmux のセッションを作り、ラッパーが立つのを確かめる。""" ndf = identity.entrypoint(ctx.plugin_root) if not ndf.is_file(): facts = hub_decide.Started(False, False, False) return Outcome(False, hub_decide.started(facts, name).reason, "precondition") cwd = Path(str(entry.get("cwd") or ctx.state_dir)) args = [str(a) for a in entry.get("args") or []] # noqa: NDF501 利用者の入力: 引数が無ければ claude の既定 - tail = ["--again"] if again else ["--", *args] - started = ctx.tmux.start(name, cwd, [str(ndf), "relay", "run", "--name", name, *tail], env) + started = ctx.tmux.start(name, cwd, [str(ndf), "relay", "run", "--name", name, "--", *args], env) if not started.ok: return Outcome(False, f"{name} の tmux のセッションを作れない: {started.detail}", "precondition") return _confirm(ctx, name) diff --git a/plugins/ndf/src/ndf/domains/relay/registry.py b/plugins/ndf/src/ndf/domains/relay/registry.py index 26723aea8..c77c28dde 100644 --- a/plugins/ndf/src/ndf/domains/relay/registry.py +++ b/plugins/ndf/src/ndf/domains/relay/registry.py @@ -8,7 +8,6 @@ | `wrapper.json` | 名前・バージョン・状態(`running`・`stalled`・`waiting`・`stopped`)・理由・セグメント・アカウント | | `log.jsonl` | セグメントの切り替えと、切り替えない理由が変わったときの 1 行 | | `next.json`・`question.json` | hook が書くシグナルファイル(`signals`) | -| `again.json` | 再起動ループの検出で止めたときに書く、1 回だけの再開の値(セッション ID・引数・アカウント・作業ディレクトリ・役割・計画)。引数に秘密を含みうるので 0600 で書き、案内のコマンドには載せない(`--again` が読む) | 旧い NDF(10.x)のラッパーは `<旧い状態の根>/relay/<作業ディレクトリ>/relay.lock` を持つ。旧い状態の根は `NDF_STATE_HOME` → `$XDG_STATE_HOME/ndf` → `~/.local/state/ndf` の順で決まる(旧い NDF と同じ規則)。 @@ -28,8 +27,6 @@ LOCK_FILE = "relay.lock" STATE_FILE = "wrapper.json" LOG_FILE = "log.jsonl" -AGAIN_FILE = "again.json" -AGAIN_MODE = 0o600 # リレーハブの保存先(`hub.hub_dir`)の下の登録簿 REGISTRY_FILE = "registry.json" @@ -70,33 +67,6 @@ def append_log(directory: Path, row: Mapping[str, Any]) -> None: signals.append_jsonl(directory / LOG_FILE, row) -def write_again(directory: Path, data: Mapping[str, Any]) -> None: - """1 回だけの再開の値を 0600 で書く(引数に認証のヘッダーや非公開の本文を含みうる)。""" - signals.replace_text(directory / AGAIN_FILE, json.dumps(dict(data), ensure_ascii=False), mode=AGAIN_MODE) - - -def read_again(directory: Path) -> dict[str, Any]: - """`write_again` が書いた再開の値。無い・読めない・形が違えば `RegistryError`。""" - path = directory / AGAIN_FILE - try: - data = json.loads(path.read_text(encoding="utf-8")) - except FileNotFoundError as exc: - raise RegistryError(f"再開の値が無い({path})。再起動ループの案内が出たラッパーの名前で打つ") from exc - except ValueError as exc: - raise RegistryError(f"再開の値を読めない({path}): {exc}") from exc - ok = ( - isinstance(data, dict) - and isinstance(data.get("session_id"), str) - and isinstance(data.get("args"), list) - and all(isinstance(a, str) for a in data["args"]) - and isinstance(data.get("cwd"), str) - and all(data.get(k) is None or isinstance(data.get(k), str) for k in ("account", "role", "plan")) - ) - if not ok: - raise RegistryError(f"再開の値の形が違う({path})") - return data - - def read_registry(hub: Path) -> dict[str, dict[str, Any]]: """リレーハブの保存先 `hub` の登録簿の行。無ければ空、読めない・形が違えば `RegistryError`。""" path = hub / REGISTRY_FILE diff --git a/plugins/ndf/src/ndf/domains/relay/wrapper.py b/plugins/ndf/src/ndf/domains/relay/wrapper.py index 833644fb0..ecb777e72 100644 --- a/plugins/ndf/src/ndf/domains/relay/wrapper.py +++ b/plugins/ndf/src/ndf/domains/relay/wrapper.py @@ -23,7 +23,6 @@ import functools import os import select -import shlex import sys import time import uuid @@ -87,14 +86,9 @@ "ndf-relay: 起動から {seconds:g} 秒未満で次のセグメントへ移ったセグメントが {count} つ続いた(再起動ループ)。" "次のセグメントを起動しない。{again}" ) -# SPIN_LINE の続け方。どちらも再開の値(`registry.AGAIN_FILE`)を読む `--again` で、今の会話を今のアカウントと -# すべてのセッションに付ける引数(権限の制約など)のまま続ける。引数は秘密や複数行の値を含みうるので画面に出さない。 -# 名前つきのラッパー(spawn)は restart(登録簿の最初の引数で起動し直す)でなく、/exit の後に同じ名前で spawn し直す -SPIN_AGAIN_RUN = "原因を直してから /exit し、{command} で同じ会話を続ける" -SPIN_AGAIN_NAMED = "原因を直し、作業を保存してから /exit し、tmux の外で {command} を打って同じ会話から起動し直す" -# 案内のコマンド(名前は `registry.NAME_RE` の形だが、念のためシェルで quote する) -SPIN_AGAIN_COMMAND = "ndf relay {action} --name {name} --again" -SPIN_AGAIN_UNSAVED = "再開の値を書けない({why})。原因を直してから /exit し、起動時の引数に --resume {session} を足して起動し直す" +# SPIN_LINE の続け方。端末のラッパーは同じ会話を run で続け、名前つきのラッパー(spawn)は tmux の外から restart で起動し直す +SPIN_AGAIN_RUN = "原因を直してから /exit し、ndf relay run --resume {session} で同じ会話を続ける" +SPIN_AGAIN_NAMED = "原因を直してから、tmux の外で ndf relay restart {name} を打って起動し直す" # 次のセグメントを起動する手(セグメントの終わりの時刻を書く) LAUNCHES = frozenset({"switch", "account", "restart", "handover"}) @@ -110,10 +104,6 @@ class Settings: (`plugin_update.Updater`。None なら呼ばない。#3812)。 `cwd_lost` は設定を作るときに作業ディレクトリを読めなかったときの表示の文字列(None でなければ起動しない。#3842)。 `spin` は再起動ループの検出の閾値(`relay.spin`。#3864 の決定 13)。 - `again` が真なら最初のセグメントを再開の値(`--again`)で起動する。アカウントは選び直さず `first_account` - (None なら既定のログイン)を使う。 - `again_load` は `--again` の起動で、錠を取った後に読んだ再開の値から設定を組み直す手(`cli.again_settings`)。 - 錠の前に読まないので、同じ名前の `--again` が並んでも使い終わった再開の値で起動しない。起動できたら読んだ値を消す。 """ state_dir: Path @@ -136,34 +126,6 @@ class Settings: update: Optional[Callable[[], plugin_update.Updated]] = None confirm: Optional[Callable[[], plugin_update.Target]] = None cwd_lost: Optional[str] = None - again: bool = False - first_account: Optional[str] = None - again_load: Optional[Callable[[Mapping[str, Any]], Settings]] = None - - -def again_pending(state_dir: Path, version: str, name: str, load: Callable[[Mapping[str, Any]], Settings]) -> Settings: - """`--again` の錠を取る前の設定。錠の置き場(`state_dir`・`name`)と `again_load` だけが意味を持つ。 - - ほかの値は錠を取った後に `load` が組む設定で置き換わる(`Wrapper.run`)。プラグインの更新や計画への質問の手を - 錠の前に組まず、再開のたびに設定を 2 度組まない。 - """ - return Settings( - state_dir=state_dir, - version=version, - name=name, - cwd=state_dir, - environ={}, - args=(), - tick=0.0, - quiet=0.0, - stall=0.0, - spin=switch_decide.Spin(0, 0.0), - context_limit=0, - usage_threshold=0.0, - transcript_bytes=0, - again=True, - again_load=load, - ) @dataclass(frozen=True) @@ -171,7 +133,6 @@ class Launch: """セグメントを始める要求。`resume` が真なら `--resume` で同じ会話を続け、偽なら `--session-id` で新しく始める。 `kind` は前のセグメントを終えた手(`switch`・`account`・`restart`・`handover`。最初のセグメントは None)。 - `decided` が真なら `account` を選び直さない(None は既定のログイン。`session_env.child_env`)。 """ number: int @@ -180,7 +141,6 @@ class Launch: prompt: str resume: bool kind: Optional[str] = None - decided: bool = False @dataclass @@ -290,8 +250,6 @@ def __init__( self.launched_root: Optional[Path] = None # 前の `plugin_update` の行までに知っていた起動先のバージョン。外で上がったかを比べる(#3909) self.known_version: Optional[str] = settings.version - # 錠を取った後に読んだ再開の値(`again_load`)。起動できたら、この値のままのときだけ消す - self.again_saved: Optional[dict[str, Any]] = None def run(self, prompt: str) -> Ended: """錠を取り、バージョンの混ざりを確かめてからセグメントを回す。""" @@ -299,12 +257,6 @@ def run(self, prompt: str) -> Ended: with signals.held(self.dir / registry.LOCK_FILE, 0) as got: if not got: return Ended("refused", f"{self.s.name} のラッパーは既に動いている") - if self.s.again_load is not None: - try: - saved = registry.read_again(self.dir) - except registry.RegistryError as exc: - return Ended("invalid", str(exc)) - self.s, self.again_saved = self.s.again_load(saved), saved others = [r for r in registry.all_running(self.s.state_dir, self.s.environ) if r.name != self.s.name] mix = hub_decide.mixed(self.s.version, others) if not mix.ok: @@ -318,12 +270,9 @@ def _loop(self, prompt: str) -> Ended: # 利用者が --resume で続けた会話の途中では更新しない(I3) ended = self._before_start(update=not self.s.first_resume) if ended is None: - account = self.s.first_account if self.s.again else accounts.chosen(self.s.environ, self.s.state_dir) - ended = self._start(Launch(1, first, account, prompt, resume=self.s.first_resume, decided=self.s.again)) + ended = self._start(Launch(1, first, accounts.chosen(self.s.environ, self.s.state_dir), prompt, resume=self.s.first_resume)) if ended is not None: return self._end(ended) - if self.again_saved is not None: - self._consume_again() while True: self._pump(self.s.tick) try: @@ -342,15 +291,6 @@ def _loop(self, prompt: str) -> Ended: if ended is not None: return self._end(ended) - def _consume_again(self) -> None: - """起動に使った再開の値を消す(1 回だけ使う)。読んだ後に書き直された値は、起動に使っていないので残す。""" - try: - current = registry.read_again(self.dir) - except registry.RegistryError: # noqa: NDF401 ファイル: 既に無い・読めない再開の値は起動に使った値ではないので消さない - return - if current == self.again_saved: - (self.dir / registry.AGAIN_FILE).unlink(missing_ok=True) - def _state(self) -> switch_decide.SectionState: sec = self._current() nxt = self._next_mark(sec) @@ -554,27 +494,10 @@ def _on_finish(self, step: switch_decide.Step, sec: Section) -> Optional[Ended]: return Ended("", step.reason) def _spin_again(self, sec: Section) -> str: - """SPIN_LINE の続け方。spawn で起動した名前つきのラッパー(`NDF_RELAY_SPAWNED`)なら spawn、端末のラッパーなら run を案内する。 - - 再開の値(今のセッション・すべてのセッションに付ける引数 `args`・今のアカウント・作業ディレクトリ・役割・計画)を - 0600 のファイルへ書き、案内は名前と `--again` だけの 1 行にする(引数の秘密や複数行の値を画面に出さない)。 - 名前つきは同じ名前で spawn し直す(restart は登録簿の最初の引数で起動し直し、今の会話を使わない)。 - """ - again = { - "session_id": sec.session_id, - "args": list(self.s.args), - "account": sec.account, - "cwd": str(self.s.cwd), - "role": self.s.environ.get("NDF_RELAY_ROLE") or None, - "plan": self.s.environ.get("NDF_RELAY_PLAN") or None, - } - try: - registry.write_again(self.dir, again) - except OSError as exc: - return SPIN_AGAIN_UNSAVED.format(why=exc, session=shlex.quote(sec.session_id)) - named = self.s.environ.get("NDF_RELAY_SPAWNED") == "1" - command = SPIN_AGAIN_COMMAND.format(action="spawn" if named else "run", name=shlex.quote(self.s.name)) - return (SPIN_AGAIN_NAMED if named else SPIN_AGAIN_RUN).format(command=command) + """SPIN_LINE の続け方。spawn で起動した名前つきのラッパー(`NDF_RELAY_SPAWNED`)なら restart、端末のラッパーなら run を案内する。""" + if self.s.environ.get("NDF_RELAY_SPAWNED") == "1": + return SPIN_AGAIN_NAMED.format(name=self.s.name) + return SPIN_AGAIN_RUN.format(session=sec.session_id) def _on_spin(self, step: switch_decide.Step, sec: Section) -> Optional[Ended]: """再起動ループの検出に当たった手。次のセグメントを起動しない(#3864 の決定 13)。 @@ -611,7 +534,7 @@ def _start(self, req: Launch) -> Optional[Ended]: 起動先の根が分かれば、子の `PATH` を `session_env.with_launched_ndf` で起動先のバージョンにそろえる(#3909)。 """ launch = uuid.uuid4().hex - env = session_env.child_env(self.s.environ, self.s.state_dir, req.account, decided=req.decided) + env = session_env.child_env(self.s.environ, self.s.state_dir, req.account) if self.launched_root is not None: env = session_env.with_launched_ndf(env, self.launched_root) env = {**env, **signals.launch_env(self.dir, launch)} diff --git a/plugins/ndf/tests/domains/relay/test_relay_again.py b/plugins/ndf/tests/domains/relay/test_relay_again.py deleted file mode 100644 index 5a2bae510..000000000 --- a/plugins/ndf/tests/domains/relay/test_relay_again.py +++ /dev/null @@ -1,119 +0,0 @@ -"""`--again` の再開(#3604 #3864 の決定 13): 錠の後に読む再開の値・保存した作業ディレクトリ・役割・計画・断る条件。 - -再起動ループの案内(`--again` の 1 行)を出す側は `test_relay_wrapper.py` にある。 -""" - -from __future__ import annotations - -import json -from pathlib import Path - -import pytest -from ndf.domains.relay import cli as relay_cli -from ndf.domains.relay import registry, signals -from relay_children import FakeChild, make_settings, run_wrapper - -LIMITED = ("--disallowedTools", "Bash", "--permission-mode", "plan", "--settings", "/tmp/a b.json") - - -def _loader(loaded: list, **changes): - """錠を取った後に再開の値を受け取る手(`Settings.again_load`)。受け取った値を `loaded` に残す。""" - - def load(saved): - loaded.append(saved) - return make_settings(Path(saved["cwd"]), again=True, first_account=saved["account"], **changes) - - return load - - -@pytest.mark.parametrize("account", ["work2", None]) -def test_i15_again_starts_on_the_saved_account_without_choosing_again(tmp_path, account): - # 決定 13・I15(検出): --again の最初のセグメントは環境変数・account use の指定から選び直さず、再開の値のアカウント - # (None は既定のログイン)で起動し、起動できたら再開の値を消す(1 回だけ使う) - s = make_settings(tmp_path) - saved = {"session_id": "s", "args": [], "account": account, "cwd": str(tmp_path)} - registry.write_again(registry.wrapper_dir(s.state_dir, s.name), saved) - env = {**s.environ, "NDF_CLAUDE_ACCOUNT": "limited"} - loaded: list = [] - load = _loader(loaded, state_dir=s.state_dir, environ=env) - ended, spawn = run_wrapper(tmp_path, [FakeChild([], 0)], environ=env, again_load=load)[:2] - assert ended.cause == "" and loaded == [saved] - assert spawn.calls[0][1].get("NDF_CLAUDE_ACCOUNT") == account - assert not (registry.wrapper_dir(s.state_dir, s.name) / registry.AGAIN_FILE).exists() - - -def test_i15_again_reads_the_saved_values_only_after_taking_the_lock(tmp_path): - # 決定 13: 同じ名前のラッパーが動いていれば、再開の値を読まず・消さずに断る(錠の前に読んだ値で後から起動しない) - s = make_settings(tmp_path) - d = registry.wrapper_dir(s.state_dir, s.name) - registry.write_again(d, {"session_id": "s", "args": [], "account": None, "cwd": str(tmp_path)}) - loaded: list = [] - with signals.held(d / registry.LOCK_FILE, 0): - ended = run_wrapper(tmp_path, [FakeChild([], 0)], again_load=_loader(loaded, state_dir=s.state_dir))[0] - assert ended.cause == "refused" and loaded == [] and (d / registry.AGAIN_FILE).exists() - - -def test_i15_again_keeps_saved_values_written_after_it_read_them(tmp_path): - # 決定 13: 起動に使った再開の値だけを消し、読んだ後に書き直された値は残す - s = make_settings(tmp_path) - d = registry.wrapper_dir(s.state_dir, s.name) - registry.write_again(d, {"session_id": "s", "args": [], "account": None, "cwd": str(tmp_path)}) - newer = {"session_id": "s2", "args": [], "account": None, "cwd": str(tmp_path)} - loaded: list = [] - first = _loader(loaded, state_dir=s.state_dir) - - def load(saved): - got = first(saved) - registry.write_again(d, newer) - return got - - assert run_wrapper(tmp_path, [FakeChild([], 0)], again_load=load)[0].cause == "" - assert registry.read_again(d)["session_id"] == "s2" - - -def test_i15_again_settings_use_the_saved_cwd_role_and_plan(tmp_path, monkeypatch): - # 決定 13: run --again は打った場所でなく再開の値の作業ディレクトリ・役割・計画で起動し、計画への質問の経路も組む - work = tmp_path / "work" - work.mkdir() - monkeypatch.chdir(tmp_path) - monkeypatch.delenv("NDF_RELAY_ROLE", raising=False) - monkeypatch.setenv("NDF_RELAY_PLAN", "other") - saved = {"session_id": "s1", "args": list(LIMITED), "account": "work2", "cwd": str(work), "role": "lane", "plan": "p1"} - s = relay_cli.again_settings("t1", saved, True) - assert (s.cwd, s.cwd_lost, s.environ["NDF_RELAY_ROLE"], s.environ["NDF_RELAY_PLAN"]) == (work, None, "lane", "p1") - assert (s.again, s.first_account, s.first_session, s.first_resume, s.args) == (True, "work2", "s1", True, LIMITED) - assert s.ask_plan is not None - gone = relay_cli.again_settings("t1", {**saved, "cwd": str(tmp_path / "gone"), "plan": None}, True) - assert gone.cwd_lost == str(tmp_path / "gone") and "NDF_RELAY_PLAN" not in gone.environ - - -@pytest.mark.parametrize("relay, on_tty", [("0", True), (None, False)]) -def test_i15_run_again_refuses_where_the_wrapper_cannot_run(tmp_path, monkeypatch, capsys, relay, on_tty): - # 決定 13: NDF_RELAY=0 や端末でないときの run --again は claude を直接起動せず(保存したアカウントを使えない)、起動前に断る - if relay is None: - monkeypatch.delenv("NDF_RELAY", raising=False) - else: - monkeypatch.setenv("NDF_RELAY", relay) - monkeypatch.setattr(relay_cli.os, "execvp", lambda *a: pytest.fail("claude を直接起動した")) - args = relay_cli._parse(["run", "--name", "t1", "--again"]) - code = relay_cli._run_again(args, on_tty) - assert code != 0 and json.loads(capsys.readouterr().out)["cause"]["kind"] == "precondition" - - -def test_i15_run_again_builds_the_settings_once_after_the_lock(tmp_path, monkeypatch): - # 決定 13: run --again は錠の前に設定を組まず(プラグインの更新・計画への質問の手を作らない)、プラグインの識別は - # 1 度だけ読み、錠を取った後に再開の値で 1 度だけ組む - calls: list = [] - loads: list = [] - real_load, real_settings = relay_cli.identity.load, relay_cli.wrapper_settings - monkeypatch.setattr(relay_cli.identity, "load", lambda: loads.append(1) or real_load()) - monkeypatch.setattr(relay_cli, "wrapper_settings", lambda *a, **k: calls.append(a) or real_settings(*a, **k)) - monkeypatch.delenv("NDF_RELAY", raising=False) - seen: list = [] - monkeypatch.setattr(relay_cli, "_wrap", lambda settings, prompt: seen.append(settings) or 0) - assert relay_cli._run_again(relay_cli._parse(["run", "--name", "t1", "--again"]), True) == 0 - pending = seen[0] - assert calls == [] and loads == [1] and pending.again and pending.update is None and pending.ask_plan is None - saved = {"session_id": "s1", "args": [], "account": None, "cwd": str(tmp_path), "role": None, "plan": None} - built = pending.again_load(saved) - assert len(calls) == 1 and loads == [1] and built.state_dir == pending.state_dir and built.cwd == tmp_path diff --git a/plugins/ndf/tests/domains/relay/test_relay_decide.py b/plugins/ndf/tests/domains/relay/test_relay_decide.py index 0ca73bc73..11cbeebb4 100644 --- a/plugins/ndf/tests/domains/relay/test_relay_decide.py +++ b/plugins/ndf/tests/domains/relay/test_relay_decide.py @@ -270,10 +270,11 @@ def test_after_limit_switches_even_with_background_waits_and_resumes_after_reset def test_restart_judges_limits_before_stopping_and_excludes_the_target(): # 上限 3 で 3 本が動いているとき、そのうち 1 本の restart は通る(#2753) - assert hub_decide.restart(hub_decide.Lanes(3, 3, True)).kind == "go" + assert hub_decide.restart(hub_decide.Lanes(3, 3, True, 0, 5)).kind == "go" # 動いていない 1 本の restart は上限に数える - assert hub_decide.restart(hub_decide.Lanes(3, 3, False)).kind == "refuse" - assert hub_decide.spawn(hub_decide.Lanes(3, 3, False)).kind == "refuse" + assert hub_decide.restart(hub_decide.Lanes(3, 3, False, 0, 5)).kind == "refuse" + assert hub_decide.restart(hub_decide.Lanes(1, 3, True, 5, 5)).kind == "refuse" + assert hub_decide.spawn(hub_decide.Lanes(3, 3, False, 0, 5)).kind == "refuse" def test_started_needs_the_wrapper_location_a_live_process_and_registration(): diff --git a/plugins/ndf/tests/domains/relay/test_relay_hub.py b/plugins/ndf/tests/domains/relay/test_relay_hub.py index bb95660d0..76588bfe9 100644 --- a/plugins/ndf/tests/domains/relay/test_relay_hub.py +++ b/plugins/ndf/tests/domains/relay/test_relay_hub.py @@ -15,8 +15,7 @@ import pytest from ndf.contracts import limits -from ndf.domains.relay import accounts, hub, registry, switch_decide -from ndf.domains.relay import cli as relay_cli +from ndf.domains.relay import hub, registry, switch_decide from ndf.domains.relay.tmux import Done, Tmux, new_session_args VERSION = "11.0.0-dev.4" @@ -371,76 +370,3 @@ def test_spawn_with_a_malformed_name_starts_no_tmux_session(ctx, name): # 名前の形を tmux を起動する前に確かめ、止める手段の無いセッションを残さない got = hub.submit(ctx, {"kind": "spawn", "name": name}) assert (got.ok, got.cause) == (False, "invalid") and ctx.tmux.started == [] - - -def test_i15_spawn_again_resumes_from_the_saved_values_and_keeps_the_registered_args(ctx): - # 決定 13・I15(検出): 再起動ループの案内の spawn --again は、再開の値の作業ディレクトリ・役割・計画で後継を --again で - # 起動し、引数を tmux のコマンドに載せない。登録簿の引数(最初の作業指示)は上書きせず、後の restart が元の指示で起動する - first = ["--model", "x", "/goal 最初の作業"] - _register(ctx, {"cwd": "/w", "args": first, "role": "worker", "plan": "p1", "version": VERSION}) - secret = ["--mcp-config", '{"headers":{"Authorization":"Bearer sk-secret"}}'] - saved = {"session_id": "s1", "args": secret, "account": "work2", "cwd": "/w2", "role": "worker", "plan": "p1"} - registry.write_again(registry.wrapper_dir(ctx.state_dir, "t1"), saved) - got = hub.submit(ctx, {"kind": hub.SPAWN_AGAIN, "name": "t1"}) - assert got.ok, got.summary - assert ctx.tmux.commands[0][-4:] == ["run", "--name", "t1", "--again"] - assert "sk-secret" not in " ".join(ctx.tmux.commands[0]) - _, env = ctx.tmux.started[0] - assert (env["NDF_RELAY_ROLE"], env["NDF_RELAY_PLAN"]) == ("worker", "p1") - assert registry.read_registry(hub.hub_dir(ctx.state_dir))["t1"]["args"] == first - assert hub.submit(ctx, {"kind": "restart", "name": "t1"}).ok - assert ctx.tmux.commands[1][-len(first) - 1 :] == ["--", *first] - - -def test_i15_spawn_again_without_saved_values_is_invalid(ctx): - # 決定 13: 再開の値が無い名前の spawn --again は起動せずに断る - got = hub.submit(ctx, {"kind": hub.SPAWN_AGAIN, "name": "t1"}) - assert (got.ok, got.cause) == (False, "invalid") and not ctx.tmux.started - - -def test_i15_spawn_again_without_a_registry_entry_keeps_the_saved_args_out_of_the_registry(ctx): - # 決定 13: 登録の無い名前の spawn --again は、再開の値の引数(認証のヘッダー・権限の制約を含みうる)を 0600 でない - # 登録簿に移さない。元の引数を持たない項目の restart は、動いているラッパーを止める前に断る(制約を落として起動しない) - secret = ["--mcp-config", '{"headers":{"Authorization":"Bearer sk-secret"}}', "--permission-mode", "plan"] - saved = {"session_id": "s1", "args": secret, "account": None, "cwd": "/w2", "role": None, "plan": None} - registry.write_again(registry.wrapper_dir(ctx.state_dir, "t1"), saved) - assert hub.submit(ctx, {"kind": hub.SPAWN_AGAIN, "name": "t1"}).ok - assert "sk-secret" not in (hub.hub_dir(ctx.state_dir) / registry.REGISTRY_FILE).read_text(encoding="utf-8") - got = hub.submit(ctx, {"kind": "restart", "name": "t1"}) - assert (got.ok, got.cause) == (False, "precondition") - assert len(ctx.tmux.started) == 1 and ctx.tmux.has("t1") - - -def test_i15_spawn_again_in_the_older_form_resumes_and_keeps_the_registry_entry(ctx): - # 決定 13: 同じメジャーの旧版が送る {"kind": "spawn", "again": true} も再開として扱い、通常の spawn として状態の - # 保存先で新しい会話を開いたり、登録簿の引数(権限の制約)を上書きしたりしない - first = ["--permission-mode", "plan", "/goal 最初の作業"] - _register(ctx, {"cwd": "/w", "args": first, "role": None, "plan": None, "version": VERSION}) - saved = {"session_id": "s1", "args": [], "account": None, "cwd": "/w2", "role": None, "plan": None} - registry.write_again(registry.wrapper_dir(ctx.state_dir, "t1"), saved) - got = hub.submit(ctx, {"kind": "spawn", "name": "t1", "again": True}) - assert got.ok, got.summary - assert ctx.tmux.commands[0][-4:] == ["run", "--name", "t1", "--again"] - assert registry.read_registry(hub.hub_dir(ctx.state_dir))["t1"]["args"] == first - - -def test_i15_spawn_again_builds_the_env_from_the_saved_account_without_choosing(ctx, monkeypatch): - # 決定 13: spawn --again の環境は再開の値のアカウントで組み、今のアカウントの選び方(指定のファイル)を読まない - def unreadable(*_): - raise accounts.AccountError("指定のファイルを読めない") - - monkeypatch.setattr(accounts, "chosen", unreadable) - saved = {"session_id": "s1", "args": [], "account": "work2", "cwd": "/w2", "role": None, "plan": None} - registry.write_again(registry.wrapper_dir(ctx.state_dir, "t1"), saved) - got = hub.submit(ctx, {"kind": hub.SPAWN_AGAIN, "name": "t1"}) - assert got.ok, got.summary - assert ctx.tmux.started[0][1]["NDF_CLAUDE_ACCOUNT"] == "work2" - - -def test_i15_spawn_again_is_not_an_ordinary_spawn_for_an_older_hub(ctx, monkeypatch): - # 決定 13: spawn --again は spawn と別の種類で頼む。again を知らない旧版は通常の spawn として起動せず、知らない種類で断る - sent = [] - monkeypatch.setattr(relay_cli, "hub_context", lambda environ: ctx) - monkeypatch.setattr(relay_cli.hub, "submit", lambda c, req: sent.append(req) or hub.Outcome(True, "ok")) - relay_cli._hub(relay_cli._parse(["spawn", "--name", "t1", "--again"])) - assert sent == [{"kind": hub.SPAWN_AGAIN, "name": "t1"}] and hub.SPAWN_AGAIN != "spawn" diff --git a/plugins/ndf/tests/domains/relay/test_relay_wrapper.py b/plugins/ndf/tests/domains/relay/test_relay_wrapper.py index fc381cf8b..d72369c9d 100644 --- a/plugins/ndf/tests/domains/relay/test_relay_wrapper.py +++ b/plugins/ndf/tests/domains/relay/test_relay_wrapper.py @@ -9,16 +9,13 @@ import io import json import os -import re -import shlex import subprocess import sys import time from pathlib import Path import pytest -from ndf.domains.relay import accounts, claude_args, install, markers, registry, signals, stop_signal, switch_decide, wrapper -from ndf.domains.relay import cli as relay_cli +from ndf.domains.relay import accounts, install, markers, registry, signals, stop_signal, switch_decide, wrapper from ndf.domains.relay.account_decide import Usage from ndf.domains.relay.plugin_update import Target, Updated from relay_children import ( @@ -189,9 +186,9 @@ def test_i15_spin_off_with_zero_seconds_keeps_restarting(tmp_path): assert ended.cause == "" and len(spawn.calls) == 5 -def _spin_run(tmp_path, children, clock, markers=None, prepare=None, environ=None, **changes): +def _spin_run(tmp_path, children, clock, markers=None, prepare=None, environ=None): extra = {"environ": {**make_settings(tmp_path).environ, **environ}} if environ else {} - s = make_settings(tmp_path, spin=switch_decide.Spin(3, 120.0), **extra, **changes) + s = make_settings(tmp_path, spin=switch_decide.Spin(3, 120.0), **extra) spawn = Spawner(children, markers) out = io.BytesIO() w = wrapper.Wrapper(s, spawn=spawn, clock=clock, out=out) @@ -208,69 +205,16 @@ def _spin_run(tmp_path, children, clock, markers=None, prepare=None, environ=Non SPIN_SHOWN = wrapper.SPIN_LINE.split("{again}")[0].format(seconds=120.0, count=3) -LIMITED = ("--disallowedTools", "Bash", "--permission-mode", "plan", "--settings", "/tmp/a b.json") -# 秘密(認証のヘッダー)と複数行の値を含む引数。案内のコマンドに出さず、再開の値には 1 語ずつ残す -SECRET = ("--mcp-config", '{"mcpServers":{"x":{"headers":{"Authorization":"Bearer sk-secret"}}}}', "--append-system-prompt", "非公開\n本文") - - -def _command(shown: str, pattern: str) -> list[str]: - """画面の案内からコマンドを取り出し、1 行のまま ndf の引数として読めることを確かめて語の並びを返す。""" - command = re.search(pattern, shown).group(1) - assert "\n" not in command - return shlex.split(command) - - -def _again(tmp_path, monkeypatch, words: list[str], action: str): - """案内の `ndf relay --name <名前> --again` を打ったときに読む ndf の引数と、再開の値から組む claude の引数・アカウント。""" - assert words[:3] == ["ndf", "relay", action] - args = relay_cli._parse(words[2:]) - assert args.again and not args.rest - saved = registry.read_again(registry.wrapper_dir(tmp_path / "state", args.name)) - return args, relay_cli.again_rest(saved), saved["account"] - - -def test_i15_spin_line_tells_a_one_line_again_command_without_the_args(tmp_path, monkeypatch): - # 決定 13・I15(検出): 案内は名前と --again だけの 1 行で、起動時の引数(秘密・複数行の値を含む)を画面に出さない。 - # 再開の値は 0600 で書き、今のセッション・引き継ぐ引数・今のアカウントをそのまま持つ - marks = {0: "/goal 2", 1: "/goal 3", 2: "/goal 4"} +def test_i15_spin_line_tells_a_command_that_runs_for_the_wrapper_kind(tmp_path): + # 決定 13・I15(検出): 端末のラッパーには同じ会話を続ける ndf relay run --resume を、spawn で起動した名前つきの + # ラッパーには tmux の外から打つ ndf relay restart <名前> を案内する(必須のサブコマンドの無い ndf relay を出さない) children = [FakeChild([], None), FakeChild([], None), FakeChild([b""] * 10, 0), FakeChild([], 0)] - _, spawn, w, shown = _spin_run(tmp_path, children, Clock(), markers=marks, args=LIMITED + SECRET) - assert "sk-secret" not in shown and "非公開" not in shown - words = _command(shown, r"/exit し、(.+) で同じ会話を続ける") - assert words == ["ndf", "relay", "run", "--name", "t1", "--again"] - assert (w.dir / registry.AGAIN_FILE).stat().st_mode & 0o777 == 0o600 - _, rest, account = _again(tmp_path, monkeypatch, words, "run") - assert rest == ["--resume", spawn.calls[2][0][2], *LIMITED, *SECRET] and account is None - parsed = claude_args.parse(rest, {}, True) - assert relay_cli._session_args(rest, parsed) == { - "args": LIMITED + SECRET, - "first_args": (), - "first_session": spawn.calls[2][0][2], - "first_resume": True, - } - - -def test_i15_named_spin_line_tells_spawn_again_and_keeps_role_and_plan(tmp_path, monkeypatch): - # 決定 13・I15(検出): spawn で起動した名前つきのラッパーには、/exit の後に tmux の外から同じ名前で spawn --again を - # 案内する(restart は登録簿の最初の作業指示を流し直すので案内しない)。作業ディレクトリ・役割・計画は再開の値が持つ - marks = {0: "/goal 2", 1: "/goal 3", 2: "/goal 4"} + _, spawn, _, shown = _spin_run(tmp_path, children, Clock(), markers={0: "/goal 2", 1: "/goal 3", 2: "/goal 4"}) + assert f"ndf relay run --resume {spawn.calls[2][0][2]} で同じ会話を続ける" in shown children = [FakeChild([], None), FakeChild([], None), FakeChild([b""] * 10, 0), FakeChild([], 0)] - named = {"NDF_RELAY_SPAWNED": "1", "NDF_RELAY_ROLE": "worker", "NDF_RELAY_PLAN": "p1"} - _, _, w, shown = _spin_run(tmp_path, children, Clock(), markers=marks, environ=named, args=LIMITED) - assert "作業を保存してから /exit し" in shown and "relay restart" not in shown - words = _command(shown, r"tmux の外で (.+) を打って同じ会話から起動し直す") - assert words == ["ndf", "relay", "spawn", "--name", "t1", "--again"] - saved = registry.read_again(w.dir) - assert (saved["cwd"], saved["role"], saved["plan"], saved["args"]) == (str(tmp_path), "worker", "p1", list(LIMITED)) - - -def test_i15_spin_again_keeps_the_current_account_and_an_odd_resume_value(tmp_path, monkeypatch): - # 決定 13・I15(検出): 再開の値は今の子のアカウント(切り替えた後の値)と、空白やシェルの構文を含む --resume の値を 1 語で持つ - odd = "release prep today; touch $(pwd)/x `id`" - w = wrapper.Wrapper(make_settings(tmp_path, args=LIMITED)) - line = w._spin_again(wrapper.Section(1, odd, "work2", None, "l")) - _, rest, account = _again(tmp_path, monkeypatch, _command(line, r"/exit し、(.+) で同じ会話を続ける"), "run") - assert (rest[:2], account) == (["--resume", odd], "work2") + named = {"NDF_RELAY_SPAWNED": "1"} + _, _, _, shown = _spin_run(tmp_path / "n", children, Clock(), markers={0: "/goal 2", 1: "/goal 3", 2: "/goal 4"}, environ=named) + assert "tmux の外で ndf relay restart t1 を打って起動し直す" in shown and "ndf relay run" not in shown def test_i15_spin_keeps_relaying_a_live_child_and_writes_one_stop_row(tmp_path): From 6d5ceac9973dfadc3b244e49edc1003d8b5943f9 Mon Sep 17 00:00:00 2001 From: "takemi.ohama" Date: Sun, 22 Nov 2026 00:03:17 +0000 Subject: [PATCH 10/12] =?UTF-8?q?Revert:=20=E5=86=8D=E8=B5=B7=E5=8B=95?= =?UTF-8?q?=E3=83=AB=E3=83=BC=E3=83=97=E3=81=AE=E6=A1=88=E5=86=85=E3=81=AE?= =?UTF-8?q?=E3=82=B3=E3=83=9E=E3=83=B3=E3=83=89=E3=81=AE=E7=9B=B4=E3=81=97?= =?UTF-8?q?=EF=BC=88c69255d1e=EF=BC=89=E3=82=92=E6=88=BB=E3=81=97=E3=80=81?= =?UTF-8?q?=E8=A8=AD=E8=A8=88=E3=81=AE=20SPIN=5FLINE=20=E3=81=AE=E6=96=87?= =?UTF-8?q?=E8=A8=80=E3=81=AB=E6=88=BB=E3=81=99=EF=BC=88#3604=20#3864?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 案内に書いた ndf relay run --resume は今の起動引数に無く、ndf check(spec-skill)が落ちる。案内のコマンドの形は設計で決めるので、設計への指摘として集める。 Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP --- .../development-workflow/references/relay.md | 2 +- plugins/ndf/src/ndf/domains/relay/wrapper.py | 13 ++----------- .../tests/domains/relay/test_relay_wrapper.py | 19 +++---------------- 3 files changed, 6 insertions(+), 28 deletions(-) diff --git a/plugins/ndf/skills/development-workflow/references/relay.md b/plugins/ndf/skills/development-workflow/references/relay.md index 5d822f20f..854b2c64f 100644 --- a/plugins/ndf/skills/development-workflow/references/relay.md +++ b/plugins/ndf/skills/development-workflow/references/relay.md @@ -392,7 +392,7 @@ claude のアカウントを 2 つ以上登録しておくと、利用上限で | `プラグインを更新できなかった(<理由>)。<バージョン> で次のセグメントを起動する` | 更新に失敗した。ラッパーは止まらず、そのバージョンで次のセグメントを起動した | 何もしなくてよい。ラッパーが次のカットポイントで更新を打ち直す | | `メジャーバージョンが <ラッパー> から <起動先> に変わった。次のセグメントを起動しない。…` | ラッパーは終わった(終了コード 3)。`relay.root` は起動先へ向け直してある | 1 行の案内どおり `claude` を打ち直し、conductor のブロックの中身を最初の入力にする | | `子の claude を起動できない(<理由>)` | ラッパーは終わった(終了コード 3)。子は起動していない | 理由(作業ディレクトリが無い・`claude` が PATH に無いなど)を直してから、conductor のブロックの中身で `claude` を打ち直す | -| `起動から <秒> 秒未満で次のセグメントへ移ったセグメントが <数> つ続いた(再起動ループ)。次のセグメントを起動しない。…` | 再起動ループの検出(「[上限](#上限)」)に当たった。今のセッションは動いたまま | 原因を直してから起動し直す。端末で打ったラッパーは `/exit` し、1 行の案内どおり `ndf relay run --resume <セッション ID>` で同じ会話を続ける。`ndf relay spawn` で起動した名前つきのラッパーは、1 行の案内どおり tmux の外から `ndf relay restart <名前>` を打つ | +| `起動から <秒> 秒未満で次のセグメントへ移ったセグメントが <数> つ続いた(再起動ループ)。次のセグメントを起動しない。…` | 再起動ループの検出(「[上限](#上限)」)に当たった。今のセッションは動いたまま | 原因を直してから `/exit` し、`ndf relay` で起動し直す | | 上の 5 つ以外(`ndf-relay: <理由>`) | ラッパーは終わった。終了コードは停止理由の種類(`contracts/causes.json`)のとおり。再起動ループの検出で、子が終わった後に止まったときもこの行になる(終了コードは子の終了コード) | 理由を直してから、conductor のブロックの中身で `claude` を起動する | ## fork したセッションで進めたとき diff --git a/plugins/ndf/src/ndf/domains/relay/wrapper.py b/plugins/ndf/src/ndf/domains/relay/wrapper.py index ecb777e72..9f23759c5 100644 --- a/plugins/ndf/src/ndf/domains/relay/wrapper.py +++ b/plugins/ndf/src/ndf/domains/relay/wrapper.py @@ -84,11 +84,8 @@ # 再起動ループの検出に当たり、子が動いている間に一度だけ端末へ出す 1 行(#3864 の決定 13) SPIN_LINE = ( "ndf-relay: 起動から {seconds:g} 秒未満で次のセグメントへ移ったセグメントが {count} つ続いた(再起動ループ)。" - "次のセグメントを起動しない。{again}" + "次のセグメントを起動しない。原因を直してから /exit し、ndf relay で起動し直す" ) -# SPIN_LINE の続け方。端末のラッパーは同じ会話を run で続け、名前つきのラッパー(spawn)は tmux の外から restart で起動し直す -SPIN_AGAIN_RUN = "原因を直してから /exit し、ndf relay run --resume {session} で同じ会話を続ける" -SPIN_AGAIN_NAMED = "原因を直してから、tmux の外で ndf relay restart {name} を打って起動し直す" # 次のセグメントを起動する手(セグメントの終わりの時刻を書く) LAUNCHES = frozenset({"switch", "account", "restart", "handover"}) @@ -493,12 +490,6 @@ def _on_handover(self, step: switch_decide.Step, sec: Section) -> Optional[Ended def _on_finish(self, step: switch_decide.Step, sec: Section) -> Optional[Ended]: return Ended("", step.reason) - def _spin_again(self, sec: Section) -> str: - """SPIN_LINE の続け方。spawn で起動した名前つきのラッパー(`NDF_RELAY_SPAWNED`)なら restart、端末のラッパーなら run を案内する。""" - if self.s.environ.get("NDF_RELAY_SPAWNED") == "1": - return SPIN_AGAIN_NAMED.format(name=self.s.name) - return SPIN_AGAIN_RUN.format(session=sec.session_id) - def _on_spin(self, step: switch_decide.Step, sec: Section) -> Optional[Ended]: """再起動ループの検出に当たった手。次のセグメントを起動しない(#3864 の決定 13)。 @@ -510,7 +501,7 @@ def _on_spin(self, step: switch_decide.Step, sec: Section) -> Optional[Ended]: self.spin_held = True if not self.spin_told: self.spin_told = True - self._say(SPIN_LINE.format(seconds=self.s.spin.seconds, count=self.s.spin.count, again=self._spin_again(sec))) + self._say(SPIN_LINE.format(seconds=self.s.spin.seconds, count=self.s.spin.count)) self._log({"kind": "stop", "cause": "spin", "reason": step.reason}) return None diff --git a/plugins/ndf/tests/domains/relay/test_relay_wrapper.py b/plugins/ndf/tests/domains/relay/test_relay_wrapper.py index d72369c9d..1db095169 100644 --- a/plugins/ndf/tests/domains/relay/test_relay_wrapper.py +++ b/plugins/ndf/tests/domains/relay/test_relay_wrapper.py @@ -186,9 +186,8 @@ def test_i15_spin_off_with_zero_seconds_keeps_restarting(tmp_path): assert ended.cause == "" and len(spawn.calls) == 5 -def _spin_run(tmp_path, children, clock, markers=None, prepare=None, environ=None): - extra = {"environ": {**make_settings(tmp_path).environ, **environ}} if environ else {} - s = make_settings(tmp_path, spin=switch_decide.Spin(3, 120.0), **extra) +def _spin_run(tmp_path, children, clock, markers=None, prepare=None): + s = make_settings(tmp_path, spin=switch_decide.Spin(3, 120.0)) spawn = Spawner(children, markers) out = io.BytesIO() w = wrapper.Wrapper(s, spawn=spawn, clock=clock, out=out) @@ -202,19 +201,7 @@ def _spin_run(tmp_path, children, clock, markers=None, prepare=None, environ=Non return ended, spawn, w, out.getvalue().decode() -SPIN_SHOWN = wrapper.SPIN_LINE.split("{again}")[0].format(seconds=120.0, count=3) - - -def test_i15_spin_line_tells_a_command_that_runs_for_the_wrapper_kind(tmp_path): - # 決定 13・I15(検出): 端末のラッパーには同じ会話を続ける ndf relay run --resume を、spawn で起動した名前つきの - # ラッパーには tmux の外から打つ ndf relay restart <名前> を案内する(必須のサブコマンドの無い ndf relay を出さない) - children = [FakeChild([], None), FakeChild([], None), FakeChild([b""] * 10, 0), FakeChild([], 0)] - _, spawn, _, shown = _spin_run(tmp_path, children, Clock(), markers={0: "/goal 2", 1: "/goal 3", 2: "/goal 4"}) - assert f"ndf relay run --resume {spawn.calls[2][0][2]} で同じ会話を続ける" in shown - children = [FakeChild([], None), FakeChild([], None), FakeChild([b""] * 10, 0), FakeChild([], 0)] - named = {"NDF_RELAY_SPAWNED": "1"} - _, _, _, shown = _spin_run(tmp_path / "n", children, Clock(), markers={0: "/goal 2", 1: "/goal 3", 2: "/goal 4"}, environ=named) - assert "tmux の外で ndf relay restart t1 を打って起動し直す" in shown and "ndf relay run" not in shown +SPIN_SHOWN = wrapper.SPIN_LINE.format(seconds=120.0, count=3) def test_i15_spin_keeps_relaying_a_live_child_and_writes_one_stop_row(tmp_path): From a35485fe5ef699fd2dc50417ea7290f73a7ebdbc Mon Sep 17 00:00:00 2001 From: "takemi.ohama" Date: Sun, 22 Nov 2026 00:05:51 +0000 Subject: [PATCH 11/12] =?UTF-8?q?Fix:=20restart=20=E3=81=AE=E5=88=A4?= =?UTF-8?q?=E5=AE=9A=E3=81=AE=E3=83=86=E3=82=B9=E3=83=88=E3=82=92=20Lanes?= =?UTF-8?q?=20=E3=81=AE=203=20=E5=BC=95=E6=95=B0=E3=81=AB=E3=81=97?= =?UTF-8?q?=E3=80=81=E5=86=8D=E8=B5=B7=E5=8B=95=E3=83=AB=E3=83=BC=E3=83=97?= =?UTF-8?q?=E3=81=AE=E8=A6=8F=E5=89=87=E3=82=92=E8=A8=AD=E5=AE=9A=E5=BE=8C?= =?UTF-8?q?=E3=81=AE=E9=96=BE=E5=80=A4=E3=81=A7=E6=9B=B8=E3=81=8F=EF=BC=88?= =?UTF-8?q?#3604=20#3864=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- .../ndf/skills/development-workflow/references/relay.md | 4 ++-- plugins/ndf/tests/domains/relay/test_relay_decide.py | 7 +++---- 2 files changed, 5 insertions(+), 6 deletions(-) diff --git a/plugins/ndf/skills/development-workflow/references/relay.md b/plugins/ndf/skills/development-workflow/references/relay.md index 854b2c64f..d50959e9c 100644 --- a/plugins/ndf/skills/development-workflow/references/relay.md +++ b/plugins/ndf/skills/development-workflow/references/relay.md @@ -349,14 +349,14 @@ hook が消せなかった質問は、次の閉じる事象か子の終わりま | 上限 | 既定 | 変え方 | 超えたとき | | --- | --- | --- | --- | -| 再起動ループの検出(起動から短い時間で次のセグメントへ移ったセグメントの続き) | 3 つ・120 秒 | `contracts/limits.json` の `relay.spin`(`count`・`seconds`)、環境変数 `NDF_RELAY_SPIN`(秒) | 次のセグメントを起動する前に、今のセグメントを含めて起動から 120 秒未満のセグメントの続きを数え、3 つに達していれば起動しない(既定では、短いセグメントが 2 つ続いた後の 3 つ目から 4 つ目への起動を止める)。子が動いていれば今の会話のまま中継を続け(そのセグメントが起動から 120 秒に達するまで区切り・替えでも起動しない)、子が終わっていればラッパーが子の終了コードで終わる | +| 再起動ループの検出(起動から短い時間で次のセグメントへ移ったセグメントの続き) | 3 つ・120 秒 | `contracts/limits.json` の `relay.spin`(`count`・`seconds`)、環境変数 `NDF_RELAY_SPIN`(秒) | 次のセグメントを起動する前に、今のセグメントを含めて起動から設定後の `seconds` 秒(`NDF_RELAY_SPIN` があればその値)未満のセグメントの続きを数え、`count` に達していれば起動しない(既定の 3 つ・120 秒では、短いセグメントが 2 つ続いた後の 3 つ目から 4 つ目への起動を止める)。子が動いていれば今の会話のまま中継を続け(そのセグメントが起動から `seconds` 秒に達するまで区切り・替えでも起動しない)、子が終わっていればラッパーが子の終了コードで終わる | | 静かな時間(子の出力も利用者の入力も無い秒数) | 5 | `contracts/limits.json` の `relay.quiet` | 子の出力と利用者の入力がこの秒数止まるか、次のセグメントのマーカーを書いてからこの秒数がたつまで、子を止めず次のセグメントを起動しない。利用者が子へ入力すると、出力が止まっていても静かな時間を数え直す。マーカーを書いてからの秒数は数え直さないので、待つのは長くてもマーカーを書いてから静かな時間まで | **数えるのは、起動から短い時間で終わったセグメントの続きである。** カットポイントの区切り(`ndf-next` のブロック・`/ndf:restart`)、 子が 0 以外で終わった・出力が `relay.stall`(30 分)止まったときの起動し直し、文脈の上限で引継ぎを頼む起動し直し、続きの中で 既に起動した起動先へアカウントを替える起動を数える。続きの中で初めて使う起動先(アカウント・従量の接続)への替えは数えないので、 上限で次々にアカウントを替えて続ける正しい替えでは当たらない(短くても数を足さず、それまでの数はそのまま残す)。 -起動から 120 秒以上動いたセグメントがあれば、数を 0 に戻す。1 日の起動の回数の +起動から `seconds` 秒以上動いたセグメントがあれば、数を 0 に戻す。`seconds` と `count` はどれも設定後の値で、例えば `NDF_RELAY_SPIN=30` なら 30 秒以上動いたセグメントで数を 0 に戻し、保持も解く。1 日の起動の回数の 上限は持たない。`ndf relay restart` は名前つきのラッパーの数(`relay.max-named`)だけで断り、起動の回数では断らない。 `NDF_RELAY_SPIN` は 0 以上の数で、0 で検出を切る。数でない値と負の値は誤りになる(ラッパーを起動せず、`ndf relay restart` は対象を止めずに断る)。 diff --git a/plugins/ndf/tests/domains/relay/test_relay_decide.py b/plugins/ndf/tests/domains/relay/test_relay_decide.py index 11cbeebb4..0ca73bc73 100644 --- a/plugins/ndf/tests/domains/relay/test_relay_decide.py +++ b/plugins/ndf/tests/domains/relay/test_relay_decide.py @@ -270,11 +270,10 @@ def test_after_limit_switches_even_with_background_waits_and_resumes_after_reset def test_restart_judges_limits_before_stopping_and_excludes_the_target(): # 上限 3 で 3 本が動いているとき、そのうち 1 本の restart は通る(#2753) - assert hub_decide.restart(hub_decide.Lanes(3, 3, True, 0, 5)).kind == "go" + assert hub_decide.restart(hub_decide.Lanes(3, 3, True)).kind == "go" # 動いていない 1 本の restart は上限に数える - assert hub_decide.restart(hub_decide.Lanes(3, 3, False, 0, 5)).kind == "refuse" - assert hub_decide.restart(hub_decide.Lanes(1, 3, True, 5, 5)).kind == "refuse" - assert hub_decide.spawn(hub_decide.Lanes(3, 3, False, 0, 5)).kind == "refuse" + assert hub_decide.restart(hub_decide.Lanes(3, 3, False)).kind == "refuse" + assert hub_decide.spawn(hub_decide.Lanes(3, 3, False)).kind == "refuse" def test_started_needs_the_wrapper_location_a_live_process_and_registration(): From 456bbd195b61e8ee2510ad234b1f229e86104600 Mon Sep 17 00:00:00 2001 From: "takemi.ohama" Date: Sun, 22 Nov 2026 00:07:10 +0000 Subject: [PATCH 12/12] =?UTF-8?q?relay.md:=20NDF=5FRELAY=5FSPIN=20?= =?UTF-8?q?=E3=81=AE=E6=9C=AA=E8=A8=AD=E5=AE=9A=E3=83=BB=E7=A9=BA=E6=96=87?= =?UTF-8?q?=E5=AD=97=E3=81=AF=20relay.spin=20=E3=81=AE=E7=A7=92=E3=82=92?= =?UTF-8?q?=E4=BD=BF=E3=81=86=E3=81=A8=E6=98=8E=E8=A8=98=EF=BC=88r2-1?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- plugins/ndf/skills/development-workflow/references/relay.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/plugins/ndf/skills/development-workflow/references/relay.md b/plugins/ndf/skills/development-workflow/references/relay.md index d50959e9c..1ce04a239 100644 --- a/plugins/ndf/skills/development-workflow/references/relay.md +++ b/plugins/ndf/skills/development-workflow/references/relay.md @@ -349,7 +349,7 @@ hook が消せなかった質問は、次の閉じる事象か子の終わりま | 上限 | 既定 | 変え方 | 超えたとき | | --- | --- | --- | --- | -| 再起動ループの検出(起動から短い時間で次のセグメントへ移ったセグメントの続き) | 3 つ・120 秒 | `contracts/limits.json` の `relay.spin`(`count`・`seconds`)、環境変数 `NDF_RELAY_SPIN`(秒) | 次のセグメントを起動する前に、今のセグメントを含めて起動から設定後の `seconds` 秒(`NDF_RELAY_SPIN` があればその値)未満のセグメントの続きを数え、`count` に達していれば起動しない(既定の 3 つ・120 秒では、短いセグメントが 2 つ続いた後の 3 つ目から 4 つ目への起動を止める)。子が動いていれば今の会話のまま中継を続け(そのセグメントが起動から `seconds` 秒に達するまで区切り・替えでも起動しない)、子が終わっていればラッパーが子の終了コードで終わる | +| 再起動ループの検出(起動から短い時間で次のセグメントへ移ったセグメントの続き) | 3 つ・120 秒 | `contracts/limits.json` の `relay.spin`(`count`・`seconds`)、環境変数 `NDF_RELAY_SPIN`(秒) | 次のセグメントを起動する前に、今のセグメントを含めて起動から設定後の `seconds` 秒(`NDF_RELAY_SPIN` が空でなければその値)未満のセグメントの続きを数え、`count` に達していれば起動しない(既定の 3 つ・120 秒では、短いセグメントが 2 つ続いた後の 3 つ目から 4 つ目への起動を止める)。子が動いていれば今の会話のまま中継を続け(そのセグメントが起動から `seconds` 秒に達するまで区切り・替えでも起動しない)、子が終わっていればラッパーが子の終了コードで終わる | | 静かな時間(子の出力も利用者の入力も無い秒数) | 5 | `contracts/limits.json` の `relay.quiet` | 子の出力と利用者の入力がこの秒数止まるか、次のセグメントのマーカーを書いてからこの秒数がたつまで、子を止めず次のセグメントを起動しない。利用者が子へ入力すると、出力が止まっていても静かな時間を数え直す。マーカーを書いてからの秒数は数え直さないので、待つのは長くてもマーカーを書いてから静かな時間まで | **数えるのは、起動から短い時間で終わったセグメントの続きである。** カットポイントの区切り(`ndf-next` のブロック・`/ndf:restart`)、 @@ -358,7 +358,7 @@ hook が消せなかった質問は、次の閉じる事象か子の終わりま 上限で次々にアカウントを替えて続ける正しい替えでは当たらない(短くても数を足さず、それまでの数はそのまま残す)。 起動から `seconds` 秒以上動いたセグメントがあれば、数を 0 に戻す。`seconds` と `count` はどれも設定後の値で、例えば `NDF_RELAY_SPIN=30` なら 30 秒以上動いたセグメントで数を 0 に戻し、保持も解く。1 日の起動の回数の 上限は持たない。`ndf relay restart` は名前つきのラッパーの数(`relay.max-named`)だけで断り、起動の回数では断らない。 -`NDF_RELAY_SPIN` は 0 以上の数で、0 で検出を切る。数でない値と負の値は誤りになる(ラッパーを起動せず、`ndf relay restart` は対象を止めずに断る)。 +`NDF_RELAY_SPIN` が未設定か空文字なら `relay.spin` の `seconds` を使い、空でない値だけを検証する(名前つきレーンの起動は tmux に残った値を上書きするため、未設定でも空文字を渡す)。空でない値は 0 以上の数で、0 で検出を切る。数でない値と負の値は誤りになる(ラッパーを起動せず、`ndf relay restart` は対象を止めずに断る)。 **文脈の上限(`NDF_CONTEXT_LIMIT`、既定 200,000)はラッパーの下で強くなる。** ラッパーの直接の子の conductor では、コンテキスト量の hook が工程へ入る起動を 1 度の通しなしに止め続ける。conductor は動いて