thth 4.2.1__tar.gz → 4.3.0__tar.gz

{thth-4.2.1 → thth-4.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: thth
-Version: 4.2.1
+Version: 4.3.0
 Summary: 承認済みの投稿だけを投げる門（Threads・Bluesky・Mastodon）。人が承認し、記録は利用者の git に残る。
 Project-URL: Homepage, https://thth.me
 Project-URL: Source, https://github.com/aokings/thth
@@ -44,6 +44,8 @@ English: [README.en.md](README.en.md) · サイト: https://thth.me · 文書の
 - **調べる**: `thth topics <アカウント> --search <語>` で、その語の件数・投稿者の数・最新の投稿を見ます。`thth where` は「次にどこで話すか」を、自分がすでに絡んだ相手を重ねて探します。X の行には投稿者のフォロワー数（「フォロワー 1.2 万」）と投稿数も付きます（`--json` は `author_followers`・`author_posts`。保存しません）。
 - **出す**: `thth send` で今すぐ、`thth schedule` で予約、`--reply-to` で返信です。
 - **ブックマークの連投は記事と別に数える**（4.0.1）: はてなブックマークは主体の別の窓（既定 10 分に 10 件）で数え、超えても主体を止めずにその 1 件だけ断ります。1 日 30 件・同じホストへ 1 日 3 件（自分の記事は 1 日 1 件のまま）。記事の連投で止める作りは変わりません（[リリースノート 4.0.1](docs/リリースノート_4.0.1_2026-10-17.md)）。
+- **返信はまとめて出す**（4.3.0）: 時刻の過ぎた返信は承認したその場で、timer では 1 回でまとめて出します（返信の窓は返信だけで 10 分に 10 件・投稿の窓に数えない・投稿の間隔を掛けない）。使い方は「`publish_at` を今か過去にしてまとめて承認する」だけです（[リリースノート 4.3.0](docs/リリースノート_4.3.0_2026-10-19.md)）。
+- **1 件の断りでまとめを止めない**（4.2.2）: はてなに 1 件だけ断られた札は token を確かめてその札だけ外し、まとめを進めます。断られそうな札（半角の「%」・タグとコメントの長いもの）は 1 段目と lint で予告します（断りません）。止まったまとめは 60 分ごとにしか打たず、`thth bookmark batch-resume` で今すぐ見直せます。sparse-checkout の定義の外には記録を書かず、直し方を言います（[リリースノート 4.2.2](docs/リリースノート_4.2.2_2026-10-18.md)）。
 - **ブックマークの直しとタグの長さの柵**（4.2.0）: `thth bookmark edit` で THTH が付けたブックマークのコメントとタグを 2 段の承認で直す。31 バイトを超えるタグは予告して断る。上限の設定は台帳の `limits` と別名で書け、断りに根拠と通し方が付きます（[リリースノート 4.2.0](docs/リリースノート_4.2.0_2026-10-18.md)）。
 - **ブックマークを 1 日分まとめて承認する**（4.1.0）: 札を JSON Lines に並べ、`thth bookmark batch` の 1 段目で全件の一覧と digest を見て 2 段目で確定。timer が上限の中で時刻を散らして付けます（口座ごと）。あわせて、上限と連投の柵の土台（媒体の特性の台帳）を入れました（[リリースノート 4.1.0](docs/リリースノート_4.1.0_2026-10-17.md)）。
 - **記事をはてなへ届けて、直したら反映**（4.0.0）: repo の記事を承認してはてなブログへ公開・予約し（画像はフォトライフへ）、SNS の告知（`announces`・`{article_url}`）とはてなブックマークを記事に結びます。記事を直せば `thth article diff` で差分を見て、承認して更新します。はてなの画面で手直しされていれば上書きせず `thth conflict` で止まります。反応は `thth article reactions` で記事ごとに。SNS だけの口座の動きと承認の指紋は変わりません（[リリースノート 4.0.0](docs/リリースノート_4.0.0_2026-10-17.md)）。

{thth-4.2.1 → thth-4.3.0}/README.md

@@ -20,6 +20,8 @@ English: [README.en.md](README.en.md) · サイト: https://thth.me · 文書の
 - **調べる**: `thth topics <アカウント> --search <語>` で、その語の件数・投稿者の数・最新の投稿を見ます。`thth where` は「次にどこで話すか」を、自分がすでに絡んだ相手を重ねて探します。X の行には投稿者のフォロワー数（「フォロワー 1.2 万」）と投稿数も付きます（`--json` は `author_followers`・`author_posts`。保存しません）。
 - **出す**: `thth send` で今すぐ、`thth schedule` で予約、`--reply-to` で返信です。
 - **ブックマークの連投は記事と別に数える**（4.0.1）: はてなブックマークは主体の別の窓（既定 10 分に 10 件）で数え、超えても主体を止めずにその 1 件だけ断ります。1 日 30 件・同じホストへ 1 日 3 件（自分の記事は 1 日 1 件のまま）。記事の連投で止める作りは変わりません（[リリースノート 4.0.1](docs/リリースノート_4.0.1_2026-10-17.md)）。
+- **返信はまとめて出す**（4.3.0）: 時刻の過ぎた返信は承認したその場で、timer では 1 回でまとめて出します（返信の窓は返信だけで 10 分に 10 件・投稿の窓に数えない・投稿の間隔を掛けない）。使い方は「`publish_at` を今か過去にしてまとめて承認する」だけです（[リリースノート 4.3.0](docs/リリースノート_4.3.0_2026-10-19.md)）。
+- **1 件の断りでまとめを止めない**（4.2.2）: はてなに 1 件だけ断られた札は token を確かめてその札だけ外し、まとめを進めます。断られそうな札（半角の「%」・タグとコメントの長いもの）は 1 段目と lint で予告します（断りません）。止まったまとめは 60 分ごとにしか打たず、`thth bookmark batch-resume` で今すぐ見直せます。sparse-checkout の定義の外には記録を書かず、直し方を言います（[リリースノート 4.2.2](docs/リリースノート_4.2.2_2026-10-18.md)）。
 - **ブックマークの直しとタグの長さの柵**（4.2.0）: `thth bookmark edit` で THTH が付けたブックマークのコメントとタグを 2 段の承認で直す。31 バイトを超えるタグは予告して断る。上限の設定は台帳の `limits` と別名で書け、断りに根拠と通し方が付きます（[リリースノート 4.2.0](docs/リリースノート_4.2.0_2026-10-18.md)）。
 - **ブックマークを 1 日分まとめて承認する**（4.1.0）: 札を JSON Lines に並べ、`thth bookmark batch` の 1 段目で全件の一覧と digest を見て 2 段目で確定。timer が上限の中で時刻を散らして付けます（口座ごと）。あわせて、上限と連投の柵の土台（媒体の特性の台帳）を入れました（[リリースノート 4.1.0](docs/リリースノート_4.1.0_2026-10-17.md)）。
 - **記事をはてなへ届けて、直したら反映**（4.0.0）: repo の記事を承認してはてなブログへ公開・予約し（画像はフォトライフへ）、SNS の告知（`announces`・`{article_url}`）とはてなブックマークを記事に結びます。記事を直せば `thth article diff` で差分を見て、承認して更新します。はてなの画面で手直しされていれば上書きせず `thth conflict` で止まります。反応は `thth article reactions` で記事ごとに。SNS だけの口座の動きと承認の指紋は変わりません（[リリースノート 4.0.0](docs/リリースノート_4.0.0_2026-10-17.md)）。

{thth-4.2.1 → thth-4.3.0}/tests/test_assess.py

@@ -59,10 +59,10 @@ def hatena_loose(world):
                          daily_max_self_bookmarks=100, bookmark_same_host_daily=100)
 
 
-def sns_post(world, account, at, *, retract=False):
+def sns_post(world, account, at, *, retract=False, reply_to=None):
     state = world.state(account)
     post_id = str(1000000 + seq())
-    sent.write(state, post_id=post_id, text="本文", body_hash="0" * 64, sent_at=jst.iso(at))
+    sent.write(state, post_id=post_id, text="本文", body_hash="0" * 64, sent_at=jst.iso(at), reply_to=reply_to)
     if retract:
         sent.mark_retracted(state, post_id, retracted_at=jst.iso(at), retracted_by="t", retract_reason="t")
 
@@ -105,16 +105,19 @@ def scenario(rid, world):
     """行ごとの試し方（`count` 2 に締め、ほかの行は緩める）。"""
     hatena_loose(world)
     hcheck = lambda kind, **kw: guard.check(ACCOUNT, accounts.load_account(ACCOUNT), kind, now=NOW, **kw)
-    if rid in ("post.daily", "retract.daily", "reply.burst", "post.burst"):
+    if rid in ("post.daily", "retract.daily", "reply.burst", "post.burst", "reply.daily"):
         values = {"post.daily": {"daily_max_posts": 2}, "retract.daily": {"daily_max_retracts": 2},
                   "reply.burst": {"burst": {"count": 2, "minutes": 10}},
+                  "reply.daily": {"limits": {"reply.daily": 2}},
                   "post.burst": {"burst": {"count": 2, "minutes": 10}}}[rid]
         cfg = sns_cfg(**values)
         when = minutes_ago if rid.endswith("burst") else hours_ago
         kind = "retract" if rid == "retract.daily" else "publish"
         return Scenario(
-            place=lambda i, inside: sns_post(world, SNS if inside else SNS_OTHER, when(i), retract=rid == "retract.daily"),
-            ask=lambda: guard.check(SNS, cfg, kind, now=NOW, reply=rid == "reply.burst"),
+            # 4.3: 返信の窓（reply.burst）は返信だけを数える → 返信の行は返信の記録を置く。
+            place=lambda i, inside: sns_post(world, SNS if inside else SNS_OTHER, when(i), retract=rid == "retract.daily",
+                                             reply_to="1799" if rid.startswith("reply.") else None),
+            ask=lambda: guard.check(SNS, cfg, kind, now=NOW, reply=rid.startswith("reply.")),
             next_at=(lambda: jst.iso(minutes_ago(0) + datetime.timedelta(minutes=11))) if rid == "reply.burst"
             else (None if rid == "post.burst" else lambda: MIDNIGHT),
             stop_target=("account", SNS) if rid == "post.burst" else None)
@@ -183,7 +186,8 @@ def scenario(rid, world):
 
 
 # 数のある行（`count` 2 に締めて試す）。数の無い行は下の個別の試験。
-COUNTED = ("post.daily", "retract.daily", "reply.burst", "post.burst", "reaction.daily",
+# 4.3（監査 中-1）: 返信だけの日の上限 `reply.daily` を足した。
+COUNTED = ("post.daily", "retract.daily", "reply.burst", "reply.daily", "post.burst", "reaction.daily",
            "entry.daily", "entry.blog_daily", "entry.principal_daily",
            "entry_delete.daily", "entry_delete.blog_daily", "entry_delete.principal_daily",
            "entry.burst", "entry.principal_burst",

{thth-4.2.1 → thth-4.3.0}/tests/test_limits_policy.py

@@ -59,7 +59,8 @@ def test_信号は7つ():
 @pytest.mark.parametrize("family,action,expected", [
     # 段 2: 各道の最後に共通の最低線 `write.floor`（予約と反応には当てない）。
     ("sns", "post", ["post.quiet", "post.interval", "post.daily", "post.burst", "write.floor"]),
-    ("sns", "reply", ["post.quiet", "post.daily", "reply.burst"]),   # 夜の監査 低-1: 最低線は返信で止めない
+    # 夜の監査 低-1: 最低線は返信で止めない。4.3（監査 中-1）: 返信は投稿の日の上限でなく `reply.daily`。
+    ("sns", "reply", ["post.quiet", "reply.daily", "reply.burst"]),
     ("sns", "retract", ["retract.daily", "post.burst", "write.floor"]),
     ("sns", "schedule", ["post.daily"]),
     ("hatenablog", "entry_create", ["entry.platform_refusal", "entry.quiet", "entry.interval", "entry.daily",

{thth-4.2.1 → thth-4.3.0}/tests/test_limits_stage2.py

@@ -364,8 +364,10 @@ def test_T_P_10_同じ配信の2回目はtargetの行で1件_opの行で2件():
 
 
 def test_分の窓は行の動作だけを数える():
-    """記録の出来事のうち行の `actions` に入るものだけ（SNS の記録の `post` は投稿・返信・記事の行に入る）。"""
-    assert assess.counts_as("post", ("reply",)) and assess.counts_as("post", ("entry_create",))
+    """記録の出来事のうち行の `actions` に入るものだけ（SNS の記録の `post` は投稿・記事の行に入る。4.3 から返信の
+    記録は `reply` の出来事で、`post` は返信の行に入らない）。"""
+    assert not assess.counts_as("post", ("reply",)) and assess.counts_as("post", ("entry_create",))
+    assert assess.counts_as("reply", ("reply",)) and not assess.counts_as("reply", ("post", "retract"))
     assert assess.counts_as("retract", ("entry_delete",))
     assert not assess.counts_as("bookmark_add", ("entry_create", "entry_update", "entry_delete"))
     assert not assess.counts_as("post", ("bookmark_add",))

{thth-4.2.1 → thth-4.3.0}/tests/test_limits_stage3.py

@@ -228,7 +228,8 @@ def test_返信の窓はreply_burstで別に締められる(world):
     cfg = {"account": SNS, "media": "threads", "daily_max_posts": 100, "daily_max_retracts": 100,
            "burst": {"count": 1, "minutes": 10}, "limits": {"reply.burst": {"count": 5, "minutes": 10}}}
     for i in range(3):
-        sns_post(world, SNS, minutes_before(5 - i))
+        # 4.3: 返信の窓は返信だけを数える → 返信の記録を置く。
+        sns_post(world, SNS, minutes_before(5 - i), reply_to="1799")
     guard.check(SNS, cfg, "publish", now=NOW, reply=True)          # 3 件のあとの返信は通る（5 まで）
     cfg["limits"] = {"reply.burst": {"count": 3, "minutes": 10}}
     e = refused(lambda: guard.check(SNS, cfg, "publish", now=NOW, reply=True))
@@ -366,6 +367,14 @@ def test_T_P_6_account_setの新しい名前と媒体(world):
     assert raw["burst"] == {"count": 4, "minutes": 10} and raw["limits"] == {"post.daily": 12}
 
 
+def test_返信の日の上限はaccount_setで書ける(world):
+    """4.3.0（監査 中-1）: 断りの文が案内する `thth account set <口座> reply.daily <数>` が通る。"""
+    name = sns_account(world)
+    rc, out, err = call(["account", "set", name, "reply.daily", "20", "--by", "masaru", "--json"])
+    assert rc == 0, err
+    assert json.loads(out)["after"] == 20 and world.account(name)["limits"] == {"reply.daily": 20}
+
+
 def test_T_P_6_締める向きだけの口(world):
     """柵: `tightens` の向きを逆にすると赤（LLM の口から緩められる）。"""
     world.edit_principal("hatena-main", limits={"bookmark.burst": {"count": 10, "minutes": 10}})
@@ -505,8 +514,9 @@ EXPECTED_4_1_0 = {
                                   "bookmark.burst": (10, 10), "bookmark.stop": (30, 10), "upload.daily": 30},
     ("account", "vm-kopicha-hatenablog"): {"entry.daily": 3, "entry_delete.daily": 2, "entry.burst": (3, 10),
                                            "write.floor": (20, 10)},
+    # 4.3: 返信の窓の既定は媒体の台帳の 10 分に 10（`burst` を書いていない口座）。
     ("account", "vm-music-threads"): {"post.daily": 8, "retract.daily": 5, "post.burst": (3, 10),
-                                      "reply.burst": (3, 10), "reaction.daily": 50, "write.floor": (20, 10)},
+                                      "reply.burst": (10, 10), "reaction.daily": 50, "write.floor": (20, 10)},
     ("account", "vm-kopicha-x"): {"post.daily": 4, "retract.daily": 5, "post.burst": (2, 30),
                                   "reply.burst": (2, 30), "reaction.daily": 20, "write.floor": (20, 10)},
 }

{thth-4.2.1 → thth-4.3.0}/tests/test_v210_json_contract.py

@@ -85,6 +85,8 @@ COMMANDS = '''lint|preview|approve|account|revoke|posts|replies|measured|threads
 COMMANDS += ['bookmark edit']
 # 上限と連投の柵 段 4（§9.2）: 媒体の観測を数える・人が足す。
 COMMANDS += ['media observations', 'media observe']
+# 4.2.2（S4 §24）: 止まったまとめを今すぐ見直させる（1 段）。
+COMMANDS += ['bookmark batch-resume']
 
 
 def test_json_table_covers_every_parser():

{thth-4.2.1 → thth-4.3.0}/tests/test_v3120_activity.py

@@ -191,7 +191,7 @@ def test_止まった口座はmcpから戻せず_成功の答えにも理由が
 # 裁定 (a)・(b)
 # --------------------------------------------------------------------------
 
-def test_返信には最短間隔を掛けない_上限には数える(env, publisher, monkeypatch):
+def test_返信には最短間隔を掛けない_返信の日の上限に数える(env, publisher, monkeypatch):
     from thth import adapters
     made = adapters.make_adapter
 
@@ -200,13 +200,16 @@ def test_返信には最短間隔を掛けない_上限には数える(env, publ
         type(adapter).fetch_post = lambda self, post_id: {"id": post_id}
         return adapter
     monkeypatch.setattr(adapters, "make_adapter", with_fetch)
-    ledger(env, min_interval_hours=6, daily_max_posts=2)
+    # 4.3.0（監査 中-1）: 返信は投稿の日の上限（`daily_max_posts`）でなく、返信だけの日の上限
+    # （`reply.daily`）に数える。投稿の上限を 1 にしても返信は通り、返信の上限 1 で 2 本目を断る。
+    ledger(env, min_interval_hours=6, daily_max_posts=1, limits={"reply.daily": 1})
     call(env, operation="send_request", body="一本目")
     assert str(refused(env, operation="send_request", body="二本目")) == "too_soon"
     replied = call(env, operation="send_request", body="返信の本文", reply_to="123456")
     assert replied["status"] == "published"
-    # 1 日の上限（2）には返信も数える。
-    assert str(refused(env, operation="send_request", body="三本目", reply_to="123456")) == "daily_limit"
+    gone = refused(env, operation="send_request", body="三本目", reply_to="123456")
+    assert str(gone) == "daily_limit"
+    assert "reply_daily" in json.dumps(gone.__dict__, ensure_ascii=False, default=str)
 
 
 @pytest.mark.parametrize("mode", [None, "publish", "all"])

{thth-4.2.1 → thth-4.3.0}/tests/test_v3250_burst_reply_queue.py

@@ -93,8 +93,9 @@ def test_続く5件目は4件目より後ろに並ぶ(isolated_account_factory):
 def test_返信でない投稿は今までどおり口座を止める(isolated_account_factory):
     account = isolated_account_factory(production=True, min_interval_hours=0, burst=BURST)
     spy = _Spy()
+    # 4.3: 投稿の窓は返信を数えない → 投稿 3 本のあとの投稿で止まる（返信 3 本のあとでは止まらない）。
     for i in range(3):
-        assert _send(account, spy, f"お返事{i}", minute=i, reply_to=f"1799{i}").exit_code == 0
+        assert _send(account, spy, f"ふつうの投稿{i}", minute=i).exit_code == 0
     r = _send(account, spy, "ふつうの投稿", minute=3)
     assert r.action == "guard" and r.error == "account_stopped"
     assert guard.stopped(account["name"])["reason"] == "burst"
@@ -102,7 +103,8 @@ def test_返信でない投稿は今までどおり口座を止める(isolated_a
 
 
 def test_1日の上限は返信でも並べずに断る(isolated_account_factory):
-    account = isolated_account_factory(production=True, min_interval_hours=0, daily_max_posts=3,
+    # 4.3（監査 中-1）: 返信の日の上限は投稿の `daily_max_posts` でなく返信だけの `reply.daily`。
+    account = isolated_account_factory(production=True, min_interval_hours=0, limits={"reply.daily": 3},
                                        burst={"count": 2, "minutes": 10})
     spy = _Spy()
     for i in range(2):
@@ -166,13 +168,18 @@ def test_guardの柵_返信のburstは止めずに窓が空く時刻を添える
     cfg = accounts.load_account(account["name"])
     sdir = accounts.state_dir_for(account["name"])
     for i in range(3):
+        # 4.3: 返信の窓は返信だけを数える → 前の 3 件は返信の記録。
         sent.write(sdir, post_id=f"90{i}", text=f"前{i}", body_hash="x",
-                   sent_at=jst.iso(NOW + datetime.timedelta(minutes=i)))
+                   sent_at=jst.iso(NOW + datetime.timedelta(minutes=i)), reply_to=f"1799{i}")
     with pytest.raises(guard.GuardRefused) as caught:
         guard.check(account["name"], cfg, "publish", now=NOW + datetime.timedelta(minutes=3), reply=True)
     assert str(caught.value) == "burst_limit" and caught.value.reason == "burst"
     assert caught.value.next_at == "2026-10-15T17:41:00+09:00"
     assert guard.stopped(account["name"]) is None
+    # 4.3: 投稿の窓は返信を数えない → 投稿の記録 3 件を足してから、投稿で止まる。
+    for i in range(3):
+        sent.write(sdir, post_id=f"91{i}", text=f"投稿{i}", body_hash="x",
+                   sent_at=jst.iso(NOW + datetime.timedelta(minutes=i)))
     with pytest.raises(guard.GuardRefused) as stopped:
         guard.check(account["name"], cfg, "publish", now=NOW + datetime.timedelta(minutes=3))
     assert str(stopped.value) == "account_stopped" and guard.stopped(account["name"])["reason"] == "burst"
@@ -183,18 +190,19 @@ def test_burst_slotの計算():
     cfg = {"burst": {"count": 3, "minutes": 10}}
     at = lambda m: NOW + datetime.timedelta(minutes=m)  # noqa: E731
     import thth.guard as g
-    orig = g._events
+    # 4.3: 材料は返信の時刻だけ（`reply_times`）。
+    orig = g.reply_times
     try:
-        g._events = lambda account: ([at(0), at(1), at(2)], [])
+        g.reply_times = lambda account: [at(0), at(1), at(2)]
         assert g.burst_slot("x", cfg, now=at(3)) == at(11)
         assert g.burst_slot("x", cfg, now=at(3), pending=[at(11)]) == at(12)
         assert g.burst_slot("x", cfg, now=at(3), pending=[at(11), at(12)]) == at(13)
         # 3 件目で窓が詰まる（11・12・13）→ 次は 11 + 11 分。
         assert g.burst_slot("x", cfg, now=at(3), pending=[at(11), at(12), at(13)]) == at(22)
-        g._events = lambda account: ([], [])
+        g.reply_times = lambda account: []
         assert g.burst_slot("x", cfg, now=at(3)) == at(3)
     finally:
-        g._events = orig
+        g.reply_times = orig
 
 
 # --------------------------------------------------------------------------
@@ -223,10 +231,11 @@ def _call(env, **request):
     return writes.execute(env['context'], dict(account='alpha', **request), via='mcp')
 
 
-def _write_recent(env, n):
+def _write_recent(env, n, reply_to=None):
     state = env['root'] / 'state/alpha'
     for i in range(n):
-        sent.write(str(state), post_id=f'90{i}', text=f'前の返信{i}', body_hash='x', sent_at=jst.iso())
+        sent.write(str(state), post_id=f'90{i}', text=f'前の返信{i}', body_hash='x', sent_at=jst.iso(),
+                   reply_to=reply_to)
 
 
 def test_thth_meの道でも返信は順番待ちに並び_口座は止まらない(env, remote, publisher):
@@ -259,7 +268,7 @@ def test_thth_meの道でも返信でない投稿は止める(env, remote, publi
 
 def test_thth_meの道でscheduled_falseは止めずにburst_limit(env, remote, publisher):
     ledger(env, burst={'count': 2, 'minutes': 10}, scheduled=False)
-    _write_recent(env, 2)
+    _write_recent(env, 2, reply_to='17980')   # 4.3: 返信の窓は返信だけを数える
     with pytest.raises(ReportServiceError) as caught:
         _call(env, operation='send_request', body='お返事', reply_to='17990')
     assert str(caught.value) == 'burst_limit' and caught.value.reason == 'burst' and caught.value.next_at
@@ -267,6 +276,21 @@ def test_thth_meの道でscheduled_falseは止めずにburst_limit(env, remote,
     assert 'burst_limit' in writes.SAFE_ERRORS
 
 
+def test_thth_meの道で並べる返信は返信の日の上限で数え_投稿の上限は使わない(env, remote, publisher):
+    # 4.3.0（監査 中-1）: 窓に当たった返信を並べる道（`burst_queued_send` → `schedule`）も、投稿の日の上限
+    # （`daily_max_posts`）でなく返信だけの日の上限（`reply.daily`）で数える。投稿の上限は今日の投稿 1 本で
+    # 埋まっているが、返信は並ぶ。返信の上限 4 = 出した 2 + 並べた 2 で、5 本目は並べずに断る。
+    ledger(env, burst={'count': 2, 'minutes': 10}, min_interval_hours=0, daily_max_posts=1,
+           limits={'reply.daily': 4})
+    _write_recent(env, 1)
+    results = [_call(env, operation='send_request', body=f'お返事{i}', reply_to=f'1799{i}') for i in range(4)]
+    assert [r['status'] for r in results] == ['published'] * 2 + ['queued'] * 2
+    with pytest.raises(ReportServiceError) as caught:
+        _call(env, operation='send_request', body='お返事4', reply_to='17994')
+    assert str(caught.value) == 'daily_limit' and caught.value.reason == 'reply_daily'
+    assert guard.stopped('alpha') is None
+
+
 def test_順番待ちの印はqueued_forだけで指紋は変えない():
     assert burst_queue.is_queued({'queued_for': 'burst'})
     assert not burst_queue.is_queued({'held_minutes': '5'}) and not burst_queue.is_queued(None)

{thth-4.2.1 → thth-4.3.0}/tests/test_v400_s4_bookmark.py

@@ -317,6 +317,10 @@ def test_T_S4_7a_書くもの(bm, answer, result, error):
                                           (429, "provider_rate_limited"), (409, "hatena_http_409")])
 def test_T_S4_7a_書かないもの(bm, status, error):
     bm.bookmarks.post = _post((status, b"no"))
+    if status in (401, 403):
+        # 4.2.2（S4 §24）: 401/403 は `/rest/1/my` で token を確かめる。ここは token も断られる場合
+        # （GET が通る＝その札だけの断りは tests/test_v422_bookmark_rejections.py）。
+        bm.bookmarks.me = (status, b"no")
     assert failed(ACCOUNT, url=EXTERNAL, comment="c") == error
     assert rows(bm, ACCOUNT) == []
     assert principals.stopped("hatena-main") is None     # 429 でも主体は止めない

thth-4.3.0/tests/test_v422_bookmark_rejections.py

@@ -0,0 +1,285 @@
+"""4.2.2（設計 S4 §24・kopicha の本番 10/18）: はてなブックマークの 1 件の断りでまとめ全体を止めない。
+
+見るもの:
+  B（主）. POST が 401/403 なら同じ run の中で `/rest/1/my` を GET して token を確かめる。通ればその札だけ
+     `hatena_rejected_item`（詳細に HTTP の番号）でまとめは進む。GET も断られたら `hatena_auth_rejected`。
+     1 件ずつの `add`・`edit` でも同じ見分けで、人向けの文を分ける。原因が何であれ、打ち直さない。
+  A. 本文の予告（**断らない**・原因が未確定）: 半角「%」（`bookmark_percent_maybe_rejected`）と、
+     `[tag]…comment` の形で 135 字か 343 バイトを超える長さ（`bookmark_length_maybe_rejected`）を、
+     `add`・`edit`・`batch` の 1 段目と `thth lint <札のファイル>` で予告する（lint は `warning:`）。
+     承認の指紋は変えない。台帳に観測の項目（確かさ low・数は台帳とコードで同じ）。
+  C. はてなに打って止まった（blocked）ら `BLOCKED_HOLD_MINUTES`（60 分）は次の run も HTTP を打たない。
+     `thth bookmark batch-resume <口座> --by` で今すぐ見直させる。打たずに止まる止め（主体の止めなど）は今どおり。
+
+HTTP は偽物（`hatena_s4_helpers.Bookmarks`）。はてなには出ない。秘密の値は偽物だけ。
+"""
+from __future__ import annotations
+
+import datetime
+import json
+
+from tests.hatena_s1_flow_helpers import call, lane  # noqa: F401
+from tests.hatena_s4_helpers import ACCOUNT, EXTERNAL, EXTERNAL_2, bm, bookmark, calls, cfg, fake_http, world  # noqa: F401
+from tests.test_v410_bookmark_batch import (URL_A1, URL_B1, approve, batch_file, bb, item, later, run,  # noqa: F401
+                                            states, write)
+from thth import bookmark_batch, hatena_bookmark, lint, media_traits, sent
+
+ME = "https://bookmark.hatenaapis.com/rest/1/my"
+# `[tag]…comment` の形で 138 字・398 バイト（予告の長さを超える）。コメントは 100 字以内・タグは 31 バイト以内。
+LONG_TAGS = ["一次資料いろはにほへ", "二次資料いろはにほへ", "三次資料いろはにほへ", "四次資料いろはにほへ"]
+LONG_COMMENT = "あ" * 90
+
+
+def hatena_bookmark_api(target):
+    import urllib.parse
+    return "https://bookmark.hatenaapis.com/rest/1/my/bookmark?" + urllib.parse.urlencode([("url", target)])
+
+
+def me_calls(world):
+    return [u for m, u in calls(world, "GET") if u == ME]
+
+
+def codes(warnings):
+    return [w["code"] for w in warnings]
+
+
+# ================================================================ A. 本文の予告（断らない）
+
+def test_A_予告の境目は135字と343バイト_半角パーセントは全角なら出ない():
+    assert hatena_bookmark.body_form("c", ["a", "b"]) == "[a][b]c"
+    assert codes(hatena_bookmark.body_warnings("x" * 135, [])) == []
+    assert codes(hatena_bookmark.body_warnings("x" * 136, [])) == ["bookmark_length_maybe_rejected"]
+    assert codes(hatena_bookmark.body_warnings("あ" * 114 + "x", [])) == []                 # 115 字・343 バイト
+    assert codes(hatena_bookmark.body_warnings("あ" * 114 + "xy", [])) == ["bookmark_length_maybe_rejected"]  # 344 バイト
+    assert codes(hatena_bookmark.body_warnings("約 85％", [])) == []
+    got = hatena_bookmark.body_warnings("約 85%", ["割合%"])
+    assert codes(got) == ["bookmark_percent_maybe_rejected"]
+    assert "コメント 1 個" in got[0]["text"] and "タグ「割合%」 1 個" in got[0]["text"]
+    assert len(hatena_bookmark.body_form(LONG_COMMENT, LONG_TAGS)) == 138
+
+
+def test_A_addの1段目は予告して断らず_2段目も打つ_指紋は変わらない(bm):
+    """柵: `body_warnings` を 1 段目に出さないと赤。断る形に戻すと赤（rc 2）。"""
+    args = ["bookmark", "add", ACCOUNT, "--url", EXTERNAL, "--comment", "約 85% が一次資料", "--tags", "割合%,統計"]
+    rc, out, _ = call(args + ["--json"])
+    body = json.loads(out)
+    assert rc == 1 and body["stage"] == 1
+    assert codes(body["preview"]["warnings"]) == ["bookmark_percent_maybe_rejected"]
+    rc, text, _ = call(args)
+    assert "予告（断りません）: bookmark_percent_maybe_rejected" in text and "原因は未確定" in text
+    p = hatena_bookmark.prepare(ACCOUNT, cfg(ACCOUNT), url=EXTERNAL, comment="約 85% が一次資料", tags="割合%,統計",
+                                check_remote=False)
+    from thth import approval
+    assert p["approved_sha"] == approval.compute_hatena_bookmark_sha(
+        account=ACCOUNT, principal="hatena-main", op="add", url=EXTERNAL, delivery="", comment="約 85% が一次資料",
+        tags=["割合%", "統計"])
+    rc, out, err = call(args + ["--confirm", body["digest"], "--by", "masaru", "--production", "--json"])
+    assert rc == 0, (out, err)
+    assert len(calls(bm, "POST")) == 1
+
+
+def test_A_長い札も予告する_editは直したあとの値(bm):
+    rc, out, _ = call(["bookmark", "add", ACCOUNT, "--url", EXTERNAL, "--comment", LONG_COMMENT, "--tags",
+                       ",".join(LONG_TAGS), "--json"])
+    body = json.loads(out)
+    assert rc == 1 and codes(body["preview"]["warnings"]) == ["bookmark_length_maybe_rejected"]
+    assert "138 字・398 バイト" in body["preview"]["warnings"][0]["text"]
+    assert "135 字・343 バイト" in body["preview"]["warnings"][0]["text"]
+    bookmark(ACCOUNT, url=EXTERNAL_2, comment="旧", tags=["旧名"])
+    rc, out, _ = call(["bookmark", "edit", ACCOUNT, "--url", EXTERNAL_2, "--comment", "100%", "--json"])
+    assert rc == 1 and codes(json.loads(out)["preview"]["warnings"]) == ["bookmark_percent_maybe_rejected"]
+    rc, out, _ = call(["bookmark", "edit", ACCOUNT, "--url", EXTERNAL_2, "--comment", "100％", "--json"])
+    assert rc == 1 and json.loads(out)["preview"]["warnings"] == []
+
+
+def test_A_batchは札を除かず予告を添える_指紋は今と同じ(bb):
+    path = write(bb, [item(URL_A1, comment="約 85%"), {"url": URL_B1, "comment": LONG_COMMENT, "tags": LONG_TAGS},
+                      item("https://c.example.net/y", comment="約 85％")])
+    first = json.loads(call(["bookmark", "batch", ACCOUNT, path, "--json"])[1])
+    items = first["preview"]["items"]
+    assert [r["include"] for r in items] == [True, True, True]
+    assert [r.get("warnings") for r in items] == [["bookmark_percent_maybe_rejected"],
+                                                  ["bookmark_length_maybe_rejected"], None]
+    shas = [hatena_bookmark.prepare(ACCOUNT, cfg(ACCOUNT), url=r["url"], comment=r["comment"], tags=r["tags"],
+                                    check_remote=False)["approved_sha"] for r in items]
+    assert first["preview"]["approved_sha"] == bookmark_batch.compute_sha(ACCOUNT, "hatena-main", shas)
+    rc, out, _ = call(["bookmark", "batch", ACCOUNT, path])
+    assert "予告（断りません）: bookmark_percent_maybe_rejected" in out
+    approve(path)
+    assert all("warnings" not in it for it in batch_file(bb)["items"])     # 札の形は変えない
+
+
+def test_A_lintは札のファイルの予告をwarningで言いrcは0(tmp_path):
+    path = tmp_path / "day.jsonl"
+    path.write_text("\n".join([
+        json.dumps({"url": EXTERNAL, "comment": "約 85%", "tags": "a%b"}, ensure_ascii=False),
+        json.dumps({"url": EXTERNAL_2, "comment": LONG_COMMENT, "tags": LONG_TAGS}, ensure_ascii=False),
+        json.dumps({"url": "https://c.example.net/y", "comment": "約 85％"}, ensure_ascii=False)]) + "\n",
+        encoding="utf-8")
+    problems = lint.lint_file(str(path))
+    assert [p.split(": 札")[0] for p in problems] == ["warning: bookmark_percent_maybe_rejected",
+                                                    "warning: bookmark_length_maybe_rejected"]
+    assert "札 1（1 行目）" in problems[0] and "タグ「a%b」 1 個" in problems[0]
+    assert all(lint.is_warning(p) for p in problems)
+    rc, out, err = call(["lint", str(path)])
+    assert rc == 0 and "bookmark_length_maybe_rejected" in out + err
+
+
+def test_A_予告の札が断られてもその札だけ外してまとめは進む(bb):
+    """本番の形: 14 件目「約 85%」・26 件目（長い札）が 401。token は生きている → その札だけ refused。"""
+    bb.bookmarks.post = lambda target, form: ((401, b"no") if target in (URL_A1, URL_B1)
+                                              else _place_default(bb, target, form))
+    approve(write(bb, [item(URL_A1, comment="約 85%"), {"url": URL_B1, "comment": LONG_COMMENT, "tags": LONG_TAGS},
+                       item("https://c.example.net/y")]))
+    out, _ = run(bb)
+    b = batch_file(bb)
+    assert [(i["state"], i["reason"]) for i in b["items"]] == [
+        ("refused", "hatena_rejected_item"), ("refused", "hatena_rejected_item"), ("placed", None)]
+    assert out["status"] == "placed" and not out.get("blocked")
+
+
+def test_A_媒体の台帳に観測の項目があり_数はコードと同じ():
+    doc = media_traits.load("hatenabookmark")
+    found = next(t for t in doc["traits"] if t["id"] == "hatenabookmark.body_rejected_observed")
+    assert found["kind"] == "observation" and found["confidence"] == "low" and found["signals"] == []
+    assert found["evidence"]["type"] == "observed" and found["evidence"]["observed_at"] == "2026-10-18"
+    assert "kopicha" in found["evidence"]["record"]
+    assert "半角 %" in found["statement"] and "未確定" in found["statement"] and "401" in found["statement"]
+    assert f"{hatena_bookmark.BODY_OK_MAX_CHARS} 字・{hatena_bookmark.BODY_OK_MAX_BYTES} バイト" in found["statement"]
+    assert not any(t["id"] == "hatenabookmark.percent_in_body_rejected_observed" for t in doc["traits"])
+
+
+# ================================================================ B. 1 件だけの 401/403
+
+def test_B_addでPOSTが401でもtokenが生きていればその札だけの断り(bm):
+    """柵: `_rejection` の GET を外すと赤（token の生きている 401 を認可の問題と言う）。"""
+    bm.bookmarks.post = (401, b"Unauthorized")
+    rc, out, _ = call(["bookmark", "add", ACCOUNT, "--url", EXTERNAL, "--comment", "c", "--json"])
+    digest = json.loads(out)["digest"]
+    rc, out, err = call(["bookmark", "add", ACCOUNT, "--url", EXTERNAL, "--comment", "c", "--confirm", digest,
+                         "--by", "masaru", "--production", "--json"])
+    body = json.loads(out)
+    assert rc == 2 and body["error"] == "hatena_rejected_item", (out, err)
+    assert "この札だけはてなに断られました" in body["message"] and "token は生きています" in body["message"]
+    assert "HTTP 401" in body["message"] and "principal auth" not in body["message"]
+    assert len(me_calls(bm)) == 1           # POST のあとに 1 回だけ確かめる
+    assert [r for r in sent.records(bm.state(ACCOUNT)) if r.get("kind") == "bookmark_add"] == []
+
+
+def test_B_addでtokenも断られたら認可の問題(bm):
+    bm.bookmarks.post = (403, b"Forbidden")
+    bm.bookmarks.me = (401, b"Unauthorized")
+    rc, out, _ = call(["bookmark", "add", ACCOUNT, "--url", EXTERNAL, "--comment", "c", "--json"])
+    digest = json.loads(out)["digest"]
+    rc, out, _ = call(["bookmark", "add", ACCOUNT, "--url", EXTERNAL, "--comment", "c", "--confirm", digest,
+                       "--by", "masaru", "--production", "--json"])
+    body = json.loads(out)
+    assert rc == 2 and body["error"] == "hatena_auth_rejected"
+    assert "thth principal auth" in body["message"] and "--force" in body["message"]
+
+
+def test_B_editでも同じ見分け(bm):
+    bookmark(ACCOUNT, url=EXTERNAL, comment="旧", tags=["旧名"])
+    bm.bookmarks.post = (401, b"Unauthorized")
+    rc, out, _ = call(["bookmark", "edit", ACCOUNT, "--url", EXTERNAL, "--comment", "新", "--json"])
+    digest = json.loads(out)["digest"]
+    args = ["bookmark", "edit", ACCOUNT, "--url", EXTERNAL, "--comment", "新", "--confirm", digest, "--by", "masaru",
+            "--production", "--json"]
+    rc, out, _ = call(args)
+    assert rc == 2 and json.loads(out)["error"] == "hatena_rejected_item"
+    bm.bookmarks.me = (401, b"Unauthorized")
+    rc, out, _ = call(args)
+    assert rc == 2 and json.loads(out)["error"] == "hatena_auth_rejected"
+    row = sent.read(bm.state(ACCOUNT), sent.bookmark_post_id(EXTERNAL))
+    assert row["text"] == "旧" and not row.get("attempts")
+
+
+def test_B_まとめは断られた札だけrefusedにして進む(bb):
+    """柵: `hatena_rejected_item` を `_FINAL_BOOKMARK` から外すと赤（まとめ全体が止まる）。"""
+    bb.bookmarks.post = lambda target, form: (401, b"no") if target == URL_A1 else _place_default(bb, target, form)
+    approve(write(bb, [item(URL_A1), item(URL_B1)]))
+    out, _ = run(bb)
+    b = batch_file(bb)
+    assert [(i["state"], i["reason"], i["detail"]) for i in b["items"]] == [
+        ("refused", "hatena_rejected_item", "HTTP 401"), ("placed", None, None)]
+    assert out["status"] == "placed" and not out.get("blocked")
+    assert bookmark_batch.status(ACCOUNT)["blocked"] is None
+
+
+def test_B_まとめでtokenも断られたら止まる(bb):
+    bb.bookmarks.post = (401, b"no")
+    bb.bookmarks.me = (401, b"no")
+    approve(write(bb, [item(URL_A1), item(URL_B1)]))
+    out, _ = run(bb)
+    assert out["status"] == "blocked" and out["blocked"]["code"] == "hatena_auth_rejected"
+    assert states(bb) == ["pending", "pending"]
+
+
+def _place_default(world, target, form):
+    """偽物のはてなの既定の POST（付ける）。"""
+    from tests.hatena_s4_helpers import bookmark_object
+    mark = bookmark_object(target, comment=form.get("comment", [""])[0], tags=form.get("tags", []))
+    world.bookmarks.marks[("lane-owner", target)] = mark
+    return 200, json.dumps(mark).encode()
+
+
+# ================================================================ C. 止まったら打ち直し続けない
+
+def _blocked(bb):
+    bb.bookmarks.post = (401, b"no")
+    bb.bookmarks.me = (401, b"no")
+    approve(write(bb, [item(URL_A1), item(URL_B1)]))
+    now = later(0)
+    out, _ = run(bb, now=now)
+    assert out["status"] == "blocked" and out["blocked"]["code"] == "hatena_auth_rejected"
+    return now
+
+
+def test_C_はてなに打って止まったら次のrunはHTTPを打たない_60分あとに試す(bb):
+    """柵: blocked に `next_at` を置かないと赤（10 分ごとに同じ札を打ち直す・kopicha 10/18 に 57 回）。"""
+    now = _blocked(bb)
+    before = len(bb.http.calls)
+    for minutes in (10, 20, 30, 59):
+        out, _ = run(bb, now=now + datetime.timedelta(minutes=minutes))
+        assert out["status"] == "waiting" and out["blocked"]["code"] == "hatena_auth_rejected"
+    assert len(bb.http.calls) == before
+    s = bookmark_batch.status(ACCOUNT)
+    assert s["blocked"]["until"] == s["next_at"]
+    assert bookmark_batch.jst.parse(s["next_at"]) - now == datetime.timedelta(
+        minutes=bookmark_batch.BLOCKED_HOLD_MINUTES)
+    rc, text, _ = call(["bookmark", "batch-status", ACCOUNT])
+    assert "まではてなに打ちません" in text and f"thth bookmark batch-resume {ACCOUNT} --by" in text
+    # 60 分あとは今の柵で見直す（直っていなければまた止まる）
+    run(bb, now=now + datetime.timedelta(minutes=61))
+    assert len(bb.http.calls) > before
+
+
+def test_C_batch_resumeで今すぐ見直させ_札と指紋は変えない(bb):
+    now = _blocked(bb)
+    before_items = batch_file(bb)["items"]
+    rc, out, _ = call(["bookmark", "batch-resume", ACCOUNT, "--json"])
+    assert rc == 1 and json.loads(out)["error"] == "by_required"
+    bb.bookmarks.post = None
+    bb.bookmarks.me = None
+    rc, out, err = call(["bookmark", "batch-resume", ACCOUNT, "--by", "masaru", "--json"])
+    body = json.loads(out)
+    assert rc == 0 and body["was_blocked"]["code"] == "hatena_auth_rejected" and body["pending"] == 2, (out, err)
+    s = bookmark_batch.status(ACCOUNT)
+    assert s["blocked"] is None and s["next_at"] is None
+    assert [i["approved_sha"] for i in batch_file(bb)["items"]] == [i["approved_sha"] for i in before_items]
+    out, _ = run(bb, now=now + datetime.timedelta(minutes=5))
+    assert out["status"] == "placed" and states(bb)[0] == "placed"
+    from thth import admin_log
+    assert any(r["event"] == "bookmark_batch_resumed" and r["by"] == "masaru" for r in admin_log.read()[0])
+
+
+def test_C_打たずに止まる止めは今どおり次の刻みで見直す(bb):
+    """主体の止め（HTTP を打たない）は 60 分待たせない（止めを解けば次の刻みで付く）。"""
+    from thth import principals
+    approve(write(bb, [item(URL_A1)]))
+    principals.stop("hatena-main", "owner", actor="tester")
+    out, _ = run(bb)
+    assert out["blocked"]["code"] == "principal_stopped" and "until" not in out["blocked"]
+    principals.resume("hatena-main", by="tester")
+    run(bb, now=later(10))
+    assert states(bb) == ["placed"]