thth 4.3.0__tar.gz → 4.3.1__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: thth
-Version: 4.3.0
+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,7 @@ 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)）。

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

@@ -20,6 +20,7 @@ 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)）。

thth-4.3.1/tests/test_v431_stopped_timer.py

@@ -0,0 +1,81 @@
+"""4.3.1: 止めた口座では timer は何も出さない（masaru 10/20「止めた口座では timer も返信を出さないように直して」・
+予約の投稿も止めることに「それでよいです」）。
+
+4.3.0 までは承認の場の送り（`send_due_replies`）と thth.me・CLI の道だけが止めの印（`guard.stopped`）を見て、
+timer の道（`throw_once`）は止めた口座でも予約の投稿と返信を出していた。
+"""
+from __future__ import annotations
+
+import pytest
+
+from tests.test_v430_reply_batch import NOW, _Media, _place, _status, _tick
+from thth import guard
+
+
+@pytest.fixture
+def account(isolated_account_factory):
+    return isolated_account_factory(production=True, min_interval_hours=0)
+
+
+def test_止めた口座ではtimerは返信も予約の投稿も出さない(account):
+    replies = [_place(account, f"r{i}.md", reply_to=f"1799{i}", minutes_ago=30 - i) for i in range(3)]
+    post = _place(account, "p.md", minutes_ago=40)
+    guard.stop(account["name"], "owner", now=NOW)
+    media = _Media()
+    result, lines = _tick(account, media)
+    assert result.exit_code == 0 and result.action == "stopped"
+    assert media.calls == []
+    assert _status(post) == "approved" and all(_status(p) == "approved" for p in replies)   # queue に残る
+    assert "止まっているので出しません" in result.message
+    assert f"thth account resume {account['name']}" in result.message
+
+
+def test_戻したら次のtimerで出す(account):
+    reply = _place(account, "r.md", reply_to="17990", minutes_ago=5)
+    post = _place(account, "p.md", minutes_ago=40)
+    guard.stop(account["name"], "owner", now=NOW)
+    media = _Media()
+    _tick(account, media)
+    assert media.calls == []
+    guard.resume(account["name"], by="masaru")
+    _tick(account, media, minutes=1)
+    assert sorted(c[1] or "" for c in media.calls) == ["", "17990"]
+    assert _status(reply) == "posted" and _status(post) == "posted"
+
+
+def test_止めた口座ではdry_runも出さないと言う(account):
+    _place(account, "p.md", minutes_ago=40)
+    guard.stop(account["name"], "burst", now=NOW)
+    from thth import core
+    result = core.throw_once(account["name"], production_flag=False, adapter_factory=lambda *_: _Media(), now=NOW)
+    assert result.action == "stopped" and result.mode == "rehearsal"
+
+
+def test_止めの印を置けない置き場では印を読まず出す(account, monkeypatch):
+    """運営者の CLI と同じ（`guard.check(cli=True)`）: 印を置けない置き場には印が無い。"""
+    reply = _place(account, "r.md", reply_to="17990", minutes_ago=5)
+    monkeypatch.setattr(guard, "stop_place_usable", lambda account: False)
+    monkeypatch.setattr(guard, "stopped", lambda account: pytest.fail("印を読んだ"))
+    media = _Media()
+    _tick(account, media)
+    assert [c[1] for c in media.calls] == ["17990"] and _status(reply) == "posted"
+
+
+def test_印が読めないときは止まっている側(account, monkeypatch):
+    from thth import server_files
+    _place(account, "r.md", reply_to="17990", minutes_ago=5)
+
+    def unreadable(account):
+        raise server_files.UnsafeFile("unsafe_server_directory")
+    monkeypatch.setattr(guard, "stopped", unreadable)
+    media = _Media()
+    result, _ = _tick(account, media)
+    assert result.action == "stopped" and media.calls == []
+
+
+def test_止めた口座ではスレッド連投にも入らない(account, monkeypatch):
+    from thth import threadthrow
+    monkeypatch.setattr(threadthrow, "run_for_account", lambda *a, **k: pytest.fail("スレッド連投に入った"))
+    guard.stop(account["name"], "owner", now=NOW)
+    result, _ = _tick(account, _Media())
+    assert result.action == "stopped"

thth-4.3.1/thth/VERSION

@@ -0,0 +1 @@
+4.3.1

{thth-4.3.0 → thth-4.3.1}/thth/core.py

@@ -299,6 +299,17 @@ def throw_once(account_name: str, *, production_flag: bool = False,
                                file=hold_row.get("file"),
                                error=hold_row.get("reason") or publish_hold_mod.UNREADABLE)
 
+    # **止めた口座では timer は何も出さない**（4.3.1・masaru 10/20）: 安全装置か持ち主が止めた口座（止めの印
+    # `guard.stopped`）では、予約の投稿・返信・スレッド連投のどれも出さない（原稿は queue に残り、指紋も変えない）。
+    # 4.3.0 までは承認の場の送りと thth.me・CLI の道だけが印を見て、timer は止めた口座でも出していた。
+    # 採取（読むだけ）は止めない。runs には書かない（止まっている間、毎回同じ行が積もるだけ）。
+    if _account_stopped(account_name):
+        msg = (f"{account_name} は止まっているので出しません（予約の投稿・返信は queue に残ります。"
+               f"戻すのは thth account resume {account_name} --by <名前>）")
+        log(msg)
+        mode = "production" if (bool(account_cfg.get("production")) and production_flag) else "rehearsal"
+        return ThrowResult(exit_code=0, mode=mode, action="stopped", message=msg)
+
     # **スレッド連投を先に見る**（独立検収 2026-09-11・P1-1）。
     # v2 は**段ごとにロックを取り直す**ので、ここで account+repo ロックを
     # 握ったまま入ることはできない。**握る前に**分岐する。
@@ -414,7 +425,7 @@ def send_due_replies(account_name: str, paths, *, adapter_factory=None, log=None
     elif publish_hold_mod.held(account_name) is not None:
         out["skipped"] = "publish_held"
     elif guard_mod.stopped(account_name) is not None:
-        # 安全装置か持ち主が止めた口座（監査 中-3）。timer の道も止めの印は見ないが、承認の場では送らない。
+        # 安全装置か持ち主が止めた口座（監査 中-3）。timer の道も 4.3.1 から送らない（`throw_once`）。
         out["skipped"] = "guard_stopped"
     elif not accounts_mod.token_exists(account_cfg):
         out["skipped"] = "missing_token"
@@ -638,6 +649,18 @@ class _ReplyWindow:
         return assess.window_slot(self.times, self.count, self.minutes, self.now)
 
 
+def _account_stopped(account_name) -> bool:
+    """timer が何も出さない口座か（止めの印 `guard.stopped`・4.3.1）。印を置けない置き場では印は無いので読まない
+    （運営者の CLI と同じ・`guard.check(cli=True)`）。印が読めないときは止まっている側に倒す。"""
+    from . import guard as guard_mod, server_files
+    if not guard_mod.stop_place_usable(account_name):
+        return False
+    try:
+        return guard_mod.stopped(account_name) is not None
+    except server_files.UnsafeFile:
+        return True
+
+
 def _reply_window_for(account_name, account_cfg, now):
     """返信の窓。はてなの口座・表が作れないときは None（返信も `max_per_run` に数える 4.2 までの形）。"""
     if account_cfg.get("media") == "hatenablog":
@@ -2029,7 +2052,7 @@ def _send_locked(account_name, account_cfg, state_dir, run_id, *, text, topic, r
         # **運営者の CLI（VM で打つ `thth send`）にも安全装置を掛ける**（10/15 masaru「推しで」）。
         # それまでは thth.me を通る道（`server_writes` の `before_execute`）にだけ掛かり、
         # music-research-threads が 5 分で 7 件出た。thth.me の道は `before_execute` の中で
-        # 見るので二重にしない。timer の予約（`throw_once`）は対象外のまま。
+        # 見るので二重にしない。timer の予約（`throw_once`）は数の柵の対象外のまま（止めの印は 4.3.1 から入口で見る）。
         if before_execute is None:
             from . import burst_queue as burst_queue_mod, guard as guard_mod
             try:

thth-4.3.0/thth/VERSION

@@ -1 +0,0 @@
-4.3.0