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..1ce04a239 100644
--- a/plugins/ndf/skills/development-workflow/references/relay.md
+++ b/plugins/ndf/skills/development-workflow/references/relay.md
@@ -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 は動いて
@@ -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 したセッションで進めたとき
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 cf9e06381..bd598e28e 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_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 8891c7a7e..76588bfe9 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):