thth 4.2.2__tar.gz → 4.3.1__tar.gz

{thth-4.2.2 → thth-4.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: thth
-Version: 4.2.2
+Version: 4.3.1
 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)）。
+- **止めた口座では timer は何も出さない**（4.3.1）: 安全装置か持ち主が止めた口座では、予約の投稿・返信を queue に残し、`thth account resume` で戻せば次の timer で出ます（[リリースノート 4.3.1](docs/リリースノート_4.3.1_2026-10-20.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)）。

{thth-4.2.2 → thth-4.3.1}/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)）。
+- **止めた口座では timer は何も出さない**（4.3.1）: 安全装置か持ち主が止めた口座では、予約の投稿・返信を queue に残し、`thth account resume` で戻せば次の timer で出ます（[リリースノート 4.3.1](docs/リリースノート_4.3.1_2026-10-20.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)）。

{thth-4.2.2 → thth-4.3.1}/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.2 → thth-4.3.1}/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.2 → thth-4.3.1}/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.2 → thth-4.3.1}/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.2 → thth-4.3.1}/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.2 → thth-4.3.1}/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)