Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
42b6be1
Test: リレーハブの restart を名前つきのラッパーの数だけで断り、登録簿と hub ls に starts を持たないことを確…
takemi-ohama Nov 21, 2026
a3f9753
Fix: リレーハブの restart を名前つきのラッパーの数だけで断り、登録簿と hub ls から 1 日の起動の回数を消す(#36…
takemi-ohama Nov 21, 2026
96a9bac
Docs: 再起動ループの検出が起動前に今のセグメントを含めて数えることと、数を残す・戻す条件を書く(#3604 #3864)
takemi-ohama Nov 21, 2026
c69255d
Fix: 再起動ループの案内を端末のラッパーは ndf relay run --resume、名前つきは tmux の外の ndf rel…
takemi-ohama Nov 21, 2026
5d3648b
Fix: 再起動ループの案内を、起動時の引数を引き継いで quote した --resume のコマンドにし、名前つきは /exit 後の…
takemi-ohama Nov 21, 2026
d39e544
Fix: 再起動ループの案内を、0600 の再開の値を読む 1 行の --again にし、秘密を出さず登録簿とアカウントを保つ(#360…
takemi-ohama Nov 21, 2026
58a50f3
Fix: --again の再開の値を錠の後に読み、保存した作業ディレクトリ・役割・計画とアカウントで起動し、直接起動・旧版・平文の登録簿…
takemi-ohama Nov 21, 2026
6641e28
Fix: 旧形式の spawn --again を再開として扱い、元の引数の無い登録の restart を止める前に断り、run --ag…
takemi-ohama Nov 22, 2026
f616227
Revert: 再起動ループの案内から元の引数・アカウント・権限を引き継いで再開する仕組み(--again・再開の値)を戻す(#3604 …
takemi-ohama Nov 22, 2026
6d5ceac
Revert: 再起動ループの案内のコマンドの直し(c69255d1e)を戻し、設計の SPIN_LINE の文言に戻す(#3604 #3…
takemi-ohama Nov 22, 2026
a35485f
Fix: restart の判定のテストを Lanes の 3 引数にし、再起動ループの規則を設定後の閾値で書く(#3604 #3864)
takemi-ohama Nov 22, 2026
456bbd1
relay.md: NDF_RELAY_SPIN の未設定・空文字は relay.spin の秒を使うと明記(r2-1)
takemi-ohama Nov 22, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 0 additions & 4 deletions plugins/ndf/contracts/schemas/io/relay.result.schema.json
Original file line number Diff line number Diff line change
Expand Up @@ -138,10 +138,6 @@
],
"description": "ラッパーの計画(hub ls)"
},
"starts": {
"type": "object",
"description": "その日の起動の回数(hub ls)"
},
"version": {
"type": "string",
"description": "ラッパーを起動したプラグインのバージョン(hub ls)"
Expand Down
2 changes: 1 addition & 1 deletion plugins/ndf/docs/contracts/commands.md
Original file line number Diff line number Diff line change
Expand Up @@ -330,7 +330,7 @@
| `ndf relay stop` | `name`(string・任意・位置): 止めるラッパーの名前<br>`--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`

Expand Down
16 changes: 10 additions & 6 deletions plugins/ndf/skills/development-workflow/references/relay.md
Original file line number Diff line number Diff line change
Expand Up @@ -349,13 +349,16 @@ 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`(秒) | 次のセグメントを起動する前に、今のセグメントを含めて起動から設定後の `seconds` 秒(`NDF_RELAY_SPIN` が空でなければその値)未満のセグメントの続きを数え、`count` に達していれば起動しない(既定の 3 つ・120 秒では、短いセグメントが 2 つ続いた後の 3 つ目から 4 つ目への起動を止める)。子が動いていれば今の会話のまま中継を続け(そのセグメントが起動から `seconds` 秒に達するまで区切り・替えでも起動しない)、子が終わっていればラッパーが子の終了コードで終わる |
| 静かな時間(子の出力も利用者の入力も無い秒数) | 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 分)止まったときの起動し直し、文脈の上限で引継ぎを頼む起動し直し、続きの中で
既に起動した起動先へアカウントを替える起動を数える。続きの中で初めて使う起動先(アカウント・従量の接続)への替えは数えないので、
上限で次々にアカウントを替えて続ける正しい替えでは当たらない(短くても数を足さず、それまでの数はそのまま残す)。
起動から `seconds` 秒以上動いたセグメントがあれば、数を 0 に戻す。`seconds` と `count` はどれも設定後の値で、例えば `NDF_RELAY_SPIN=30` なら 30 秒以上動いたセグメントで数を 0 に戻し、保持も解く。1 日の起動の回数の
上限は持たない。`ndf relay restart` は名前つきのラッパーの数(`relay.max-named`)だけで断り、起動の回数では断らない。
`NDF_RELAY_SPIN` が未設定か空文字なら `relay.spin` の `seconds` を使い、空でない値だけを検証する(名前つきレーンの起動は tmux に残った値を上書きするため、未設定でも空文字を渡す)。空でない値は 0 以上の数で、0 で検出を切る。数でない値と負の値は誤りになる(ラッパーを起動せず、`ndf relay restart` は対象を止めずに断る)。

**文脈の上限(`NDF_CONTEXT_LIMIT`、既定 200,000)はラッパーの下で強くなる。** ラッパーの直接の子の
conductor では、コンテキスト量の hook が工程へ入る起動を 1 度の通しなしに止め続ける。conductor は動いて
Expand Down Expand Up @@ -389,7 +392,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 したセッションで進めたとき

Expand Down
2 changes: 0 additions & 2 deletions plugins/ndf/src/ndf/domains/relay/cli.py
Original file line number Diff line number Diff line change
Expand Up @@ -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")
Expand Down
25 changes: 14 additions & 11 deletions plugins/ndf/src/ndf/domains/relay/hub.py
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,8 @@
なって、溜まったリクエストを古い順に 1 本ずつ処理する(常駐のプロセスを持たない)。結果は `results/<id>.json` へ書き、
頼んだ側が読んで消す。登録簿 `registry.json` を書くのは排他を持つリレーハブだけである。

- 再起動は、止める前に上限を判定し、通ったときだけ止めてから起動する(#2753。`hub_decide.restart`)
- 再起動は、止める前に上限を判定し、通ったときだけ止めてから起動する(#2753。`hub_decide.restart`)。上限は名前つきの
ラッパーの数だけで、1 日の起動の回数を持たない(#3864 の決定 13。暴走止めはラッパーの再起動ループの検出が持つ)
- 起動が「起動した」を返すのは、ラッパーの錠が取られ、tmux のセッションが残っているときだけ(#2563)
- ラッパーの保存先(プラグインの `bin/ndf`)が無ければ、理由と打ち直しのコマンドを返す(#2583)
- バージョンの違うラッパーが動いていれば起動しない(3341-2。`hub_decide.mixed`)
Expand All @@ -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

Expand All @@ -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"
Expand Down Expand Up @@ -73,22 +75,20 @@ def spin_of(environ: Mapping[str, str]) -> switch_decide.Spin:

@dataclass
class Context:
"""リレーハブが読む事実と部品。時計・眠り・日付はテストで差し替える。"""
"""リレーハブが読む事実と部品。時計と眠りはテストで差し替える。"""

state_dir: Path
plugin_root: Path
version: str
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:
Expand Down Expand Up @@ -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
Expand All @@ -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
Expand All @@ -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)
Expand All @@ -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:
Expand Down Expand Up @@ -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


Expand Down
Loading