thth 4.3.1__tar.gz → 4.4.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: thth
-Version: 4.3.1
+Version: 4.4.0
 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)）。
+- **会話の続く投稿は 20 分おきに返信を取り直す**（4.4.0）: 投稿から 48 時間以内か、直近 48 時間に返信が付いた投稿は、刻みとは別に timer が会話を取り直します（1 回 10 本まで・刻みと数の記録は変えない・X は既定で外す・台帳の `reply_follow` で変えられる）（[リリースノート 4.4.0](docs/リリースノート_4.4.0_2026-10-21.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)）。

{thth-4.3.1 → thth-4.4.0}/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)）。
+- **会話の続く投稿は 20 分おきに返信を取り直す**（4.4.0）: 投稿から 48 時間以内か、直近 48 時間に返信が付いた投稿は、刻みとは別に timer が会話を取り直します（1 回 10 本まで・刻みと数の記録は変えない・X は既定で外す・台帳の `reply_follow` で変えられる）（[リリースノート 4.4.0](docs/リリースノート_4.4.0_2026-10-21.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)）。

{thth-4.3.1 → thth-4.4.0}/tests/test_replies_refresh.py

@@ -39,9 +39,9 @@ class _口:
         raise AssertionError("**refresh が account_insights を呼んでいる**")
 
 
-def _仕立て(tmp_path, isolated_account_factory, *, posted_at=POSTED):
+def _仕立て(tmp_path, isolated_account_factory, *, posted_at=POSTED, **overrides):
     pair = init_git_pair(tmp_path, seed_content="x\n", seed_name="seed.md")
-    account = isolated_account_factory(repo_dir=pair["work"])
+    account = isolated_account_factory(repo_dir=pair["work"], **overrides)
     write_queue_file(account["queue_dir"], "a.md", fm_overrides={
         "status": "posted", "post_id": "POST1", "posted_at": posted_at})
     return pair, account
@@ -57,7 +57,9 @@ def _台帳(pair, post_id="POST1"):
 
 def test_刻みに当たらなくても取り直せる(tmp_path, isolated_account_factory):
     """**これが `--refresh` の目的。** 定期取得は 0.5h では何も取らない。"""
-    pair, account = _仕立て(tmp_path, isolated_account_factory)
+    # 刻みの取得だけを見る（4.4.0 の会話の続く投稿の取り直しは切る・`tests/test_v440_reply_follow.py`）。
+    pair, account = _仕立て(tmp_path, isolated_account_factory,
+                            reply_follow={"enabled": False})
     口 = _口([{"id": "R1", "text": "返信"}])
 
     定期 = collect_mod.collect_once(account["name"], adapter=口, now=NOW,

{thth-4.3.1 → thth-4.4.0}/tests/test_v31_collection.py

@@ -20,7 +20,8 @@ class Adapter:
         return []
 
 def setup_route(tmp_path,factory,monkeypatch,route,collect_days=14,medium='threads'):
-    a=factory(name='test-'+medium,media=medium,collect_days=collect_days)
+    # 刻みの時計だけを見る（4.4.0 の会話の続く投稿の取り直しは切る・tests/test_v440_reply_follow.py）。
+    a=factory(name='test-'+medium,media=medium,collect_days=collect_days,reply_follow={'enabled':False})
     monkeypatch.setattr(c.writeback,'upstream_sha',lambda repo:None)
     files=[]
     path=tmp_path/'queue.md'

thth-4.4.0/tests/test_v440_reply_follow.py

@@ -0,0 +1,299 @@
+"""4.4.0 会話の続く投稿の取り直し（`thth/reply_follow.py`・`collect._collect_follow`）。
+
+kopicha 10/21: 返信が刻み（1・6・24・72・168 時間）の間に付くと、次の刻みまで台帳に入らず、
+h2d の起こしが約 2 時間半遅れた。会話の続く投稿だけ、刻みとは別におおむね 20 分おきに
+取り直す。性質は `--refresh` と同じ（刻みを進めない・数を取らない）。
+"""
+from __future__ import annotations
+
+import datetime as dt
+import json
+import os
+
+import pytest
+
+from thth import accounts, collect as c, jst, sent
+
+POSTED = jst.parse("2026-10-20T00:00:00+09:00")
+H = dt.timedelta(hours=1)
+M = dt.timedelta(minutes=1)
+
+
+class Adapter:
+    def __init__(self, rows=None, fail=False):
+        self.rows = rows or {}
+        self.fail = fail
+        self.insight_calls, self.reply_calls = [], []
+
+    def capabilities(self):
+        return set()
+
+    def insights(self, pid):
+        self.insight_calls.append(pid)
+        return {"metrics": {"views": 1}, "available": ["views"]}
+
+    def conversation(self, pid, **kw):
+        self.reply_calls.append((pid, kw))
+        if self.fail:
+            raise RuntimeError("fixture fail")
+        return list(self.rows.get(pid, []))
+
+
+class XAdapter(Adapter):
+    PAID_READS = True
+    CONVERSATION_MIN = 10
+
+
+def _account(factory, monkeypatch, *, media="threads", **overrides):
+    a = factory(name="test-" + media, media=media, **overrides)
+    monkeypatch.setattr(c.writeback, "upstream_sha", lambda repo: None)
+    monkeypatch.setattr(c.core, "list_queue_files", lambda *x, **k: [])
+    return a
+
+
+def _post(a, pid, posted_at, reply_to=None):
+    sent.write(accounts.state_dir_for(a["name"]), post_id=pid, text="fixture",
+               body_hash="fixture", sent_at=jst.iso(posted_at), reply_to=reply_to)
+
+
+def _ledger(a, pid):
+    cfg = accounts.load_account(a["name"])
+    path = os.path.join(accounts.data_dirs(cfg, a["name"])["replies"], f"{pid}.ndjson")
+    if not os.path.exists(path):
+        return []
+    return [json.loads(line) for line in open(path, encoding="utf-8") if line.strip()]
+
+
+def _state_dir(a):
+    return accounts.state_dir_for(a["name"])
+
+
+def _state(a):
+    path = os.path.join(_state_dir(a), "reply_follow.json")
+    if not os.path.exists(path):
+        return {}
+    return json.load(open(path, encoding="utf-8"))["last"]
+
+
+def _ledger_bytes(a, pid):
+    cfg = accounts.load_account(a["name"])
+    path = os.path.join(accounts.data_dirs(cfg, a["name"])["replies"], f"{pid}.ndjson")
+    return path, (open(path, "rb").read() if os.path.exists(path) else None)
+
+
+def _run(a, adapter, now):
+    return c.collect_once(a["name"], adapter=adapter, now=now, log=lambda _l: None)
+
+
+def _called(adapter):
+    return [pid for pid, _kw in adapter.reply_calls]
+
+
+def test_会話の続く投稿だけ取り直す(tmp_path, isolated_account_factory, monkeypatch):
+    """48 時間以内の投稿は取り直す。古くて返信も無い投稿は取り直さない。"""
+    a = _account(isolated_account_factory, monkeypatch)
+    now = POSTED + 100 * H
+    _post(a, "NEW", now - 3 * H)
+    _post(a, "OLD", POSTED)          # 100 時間前・返信なし
+    adapter = Adapter()
+    _run(a, adapter, now)            # 初回: NEW は 1h の刻み・OLD は 72h の刻み
+    adapter.reply_calls.clear()
+    _run(a, adapter, now + 30 * M)   # 刻みに当たらない回
+    assert _called(adapter) == ["NEW"]
+    assert set(_state(a)) == {"NEW"}
+
+
+def test_古い投稿でも直近48時間に返信が付けば取り直す(tmp_path, isolated_account_factory, monkeypatch):
+    a = _account(isolated_account_factory, monkeypatch)
+    now = POSTED + 100 * H
+    _post(a, "OLD", POSTED)
+    adapter = Adapter(rows={"OLD": [{"id": "R1", "timestamp": jst.iso(now - 5 * H)}]})
+    _run(a, adapter, now)            # 72h の刻みで R1 が台帳に入る
+    adapter.reply_calls.clear()
+    _run(a, adapter, now + 30 * M)
+    assert _called(adapter) == ["OLD"]
+
+
+def test_古い投稿でも自分が返した枝は取り直す(tmp_path, isolated_account_factory, monkeypatch):
+    a = _account(isolated_account_factory, monkeypatch)
+    now = POSTED + 100 * H
+    _post(a, "OLD", POSTED)
+    _post(a, "MINE", now - 2 * H, reply_to="OLD")   # 自分の返信（2 時間前）
+    adapter = Adapter()
+    _run(a, adapter, now)
+    adapter.reply_calls.clear()
+    _run(a, adapter, now + 30 * M)
+    assert sorted(_called(adapter)) == ["MINE", "OLD"]
+
+
+def test_20分たたない投稿は飛ばす(tmp_path, isolated_account_factory, monkeypatch):
+    a = _account(isolated_account_factory, monkeypatch)
+    _post(a, "P", POSTED)
+    adapter = Adapter()
+    _run(a, adapter, POSTED + 2 * H)              # 1h の刻み
+    adapter.reply_calls.clear()
+    _run(a, adapter, POSTED + 2 * H + 10 * M)     # 10 分後: 飛ばす
+    assert _called(adapter) == []
+    _run(a, adapter, POSTED + 2 * H + 19 * M)     # 19 分後: まだ飛ばす
+    assert _called(adapter) == []
+    _run(a, adapter, POSTED + 2 * H + 20 * M)     # 20 分後: 取り直す
+    assert _called(adapter) == ["P"]
+    _run(a, adapter, POSTED + 2 * H + 30 * M)     # 取り直しから 10 分: 飛ばす
+    assert _called(adapter) == ["P"]
+
+
+def test_間隔と窓と本数は台帳で変えられる(tmp_path, isolated_account_factory, monkeypatch):
+    a = _account(isolated_account_factory, monkeypatch,
+                 reply_follow={"every_minutes": 60, "live_hours": 2, "max_posts": 1})
+    _post(a, "P", POSTED)
+    adapter = Adapter()
+    _run(a, adapter, POSTED + 1 * H)              # 1h の刻み
+    adapter.reply_calls.clear()
+    _run(a, adapter, POSTED + 1 * H + 30 * M)     # 60 分たっていない
+    assert _called(adapter) == []
+    _run(a, adapter, POSTED + 2 * H)              # 60 分・窓（2 時間）の内
+    assert _called(adapter) == ["P"]
+    _run(a, adapter, POSTED + 4 * H)              # 窓の外・返信なし
+    assert _called(adapter) == ["P"]
+
+
+def test_上限の本数を新しい動きの順に取る(tmp_path, isolated_account_factory, monkeypatch):
+    a = _account(isolated_account_factory, monkeypatch)
+    now = POSTED + 30 * H
+    # 12 本・投稿が新しいほど動きが新しい。P00 がいちばん古い。
+    for i in range(12):
+        _post(a, f"P{i:02d}", POSTED + i * H)
+    adapter = Adapter()
+    _run(a, adapter, now)                         # 刻み（24h・6h など）で全部 1 回取る
+    adapter.reply_calls.clear()
+    _run(a, adapter, now + 30 * M)
+    assert len(adapter.reply_calls) == 10
+    assert _called(adapter) == [f"P{i:02d}" for i in range(11, 1, -1)]
+
+
+def test_刻みと数の記録を進めない(tmp_path, isolated_account_factory, monkeypatch):
+    """取り直しは insights を読まず、`marks: []` で記録する。6h の刻みはそのまま 6h に取る。"""
+    a = _account(isolated_account_factory, monkeypatch)
+    _post(a, "P", POSTED)
+    adapter = Adapter(rows={"P": [{"id": "R1", "timestamp": jst.iso(POSTED + 30 * M)}]})
+    _run(a, adapter, POSTED + 1 * H)              # 1h の刻み（数と返信）
+    assert adapter.insight_calls == ["P"]
+    adapter.rows["P"].append({"id": "R2", "timestamp": jst.iso(POSTED + 2 * H)})
+    _run(a, adapter, POSTED + 3 * H)              # 取り直し（R2 が新しい）
+    assert adapter.insight_calls == ["P"], "取り直しが数を読んでいる"
+    fetches = [r for r in _ledger(a, "P") if r["kind"] == "fetch"]
+    assert [r["marks"] for r in fetches] == [[1], []]
+    assert [r["trigger"] for r in fetches] == ["marks", "follow"]
+    assert c.due_marks(3.0, fetches, marks=c.REPLY_MARKS_HOURS) == []
+    assert [r["id"] for r in _ledger(a, "P") if r["kind"] == "reply"] == ["R1", "R2"]
+    _run(a, adapter, POSTED + 6 * H)              # 6h の刻みは刻みとして取る
+    assert adapter.insight_calls == ["P", "P"]
+    fetches = [r for r in _ledger(a, "P") if r["kind"] == "fetch"]
+    assert fetches[-1]["marks"] == [6] and fetches[-1]["trigger"] == "marks"
+    assert len(fetches) == 3, "刻みで取った回に取り直しでも読んでいる"
+
+
+def test_Xは既定で外す(tmp_path, isolated_account_factory, monkeypatch):
+    a = _account(isolated_account_factory, monkeypatch, media="x")
+    _post(a, "123", POSTED)
+    adapter = XAdapter()
+    for minutes in (60, 90, 120):
+        _run(a, adapter, POSTED + minutes * M)
+    assert adapter.reply_calls == []
+
+
+def test_Xは台帳で明示したときだけ最小の本数で読む(tmp_path, isolated_account_factory, monkeypatch):
+    a = _account(isolated_account_factory, monkeypatch, media="x",
+                 reply_follow={"enabled": True})
+    _post(a, "123", POSTED)
+    adapter = XAdapter()
+    _run(a, adapter, POSTED + 60 * M)
+    assert adapter.reply_calls == [("123", {"limit": 10})]
+
+
+def test_取り直しの失敗で採取を失敗にしない(tmp_path, isolated_account_factory, monkeypatch):
+    a = _account(isolated_account_factory, monkeypatch)
+    _post(a, "P", POSTED)
+    _run(a, Adapter(), POSTED + 1 * H)            # 1h の刻み
+    adapter = Adapter(fail=True)
+    lines = []
+    result = c.collect_once(a["name"], adapter=adapter, now=POSTED + 2 * H, log=lines.append)
+    assert _called(adapter) == ["P"]
+    assert result["errors"] == [], "取り直しの失敗が採取の errors（終了コード）に入っている"
+    assert result["follow"]["failed"] == [{"post_id": "P", "reason": "fixture fail"}]
+    assert any("取り直し" in line for line in lines)
+    # 失敗した回は記録が残らないので、次の回で取り直す。
+    adapter.fail = False
+    _run(a, adapter, POSTED + 2 * H + 10 * M)
+    assert _called(adapter) == ["P", "P"]
+
+
+@pytest.mark.parametrize("value", [
+    {"every_minutes": 1}, {"live_hours": 0}, {"max_posts": 51}, {"enabled": "yes"},
+    {"unknown": 1}, [], {"every_minutes": 20.5}])
+def test_形の違う設定は台帳の読み込みで断る(tmp_path, isolated_account_factory, value):
+    a = isolated_account_factory(name="test-threads", reply_follow=value)
+    with pytest.raises(accounts.AccountError, match="invalid_reply_follow"):
+        accounts.load_account(a["name"])
+
+
+def test_max_posts0は切る():
+    assert c.reply_follow_mod.settings({"media": "threads", "reply_follow": {"max_posts": 0}})["enabled"] is False
+    assert c.reply_follow_mod.settings({"media": "bluesky"})["enabled"] is True
+    assert c.reply_follow_mod.settings({"media": "mastodon"})["enabled"] is True
+    assert c.reply_follow_mod.settings({"media": "x"})["enabled"] is False
+
+
+def test_新しい返信が無い取り直しでは利用者のrepoに書かない(tmp_path, isolated_account_factory, monkeypatch):
+    """masaru 10/21: THTH の記録は VM の state に持ち、利用者の repo には積まない。"""
+    a = _account(isolated_account_factory, monkeypatch)
+    _post(a, "P", POSTED)
+    adapter = Adapter(rows={"P": [{"id": "R1", "timestamp": jst.iso(POSTED + 30 * M)}]})
+    _run(a, adapter, POSTED + 1 * H)              # 1h の刻みで R1 が入る
+    path, before = _ledger_bytes(a, "P")
+    result = _run(a, adapter, POSTED + 2 * H)     # 取り直し・新しい返信なし
+    assert _called(adapter) == ["P", "P"]
+    assert result["follow"]["fetched"] == 1 and result["follow"]["new_replies"] == 0
+    assert _ledger_bytes(a, "P")[1] == before, "新しい返信が無いのに repo の台帳に書いた"
+    assert path not in result["touched"], "新しい返信が無いのに commit の対象にした"
+    assert set(_state(a)) == {"P"}
+    # 新しい返信が来た回だけ repo に書く。
+    adapter.rows["P"].append({"id": "R2", "timestamp": jst.iso(POSTED + 2 * H + 10 * M)})
+    result = _run(a, adapter, POSTED + 2 * H + 20 * M)
+    assert path in result["touched"]
+    assert [r["id"] for r in _ledger(a, "P") if r["kind"] == "reply"] == ["R1", "R2"]
+
+
+def test_20分の判定はstateの時刻で効く(tmp_path, isolated_account_factory, monkeypatch):
+    a = _account(isolated_account_factory, monkeypatch)
+    _post(a, "P", POSTED)
+    adapter = Adapter()
+    _run(a, adapter, POSTED + 1 * H)              # 1h の刻み（台帳の取得の行は 1h）
+    adapter.reply_calls.clear()
+    os.makedirs(_state_dir(a), exist_ok=True)
+    with open(os.path.join(_state_dir(a), "reply_follow.json"), "w", encoding="utf-8") as f:
+        json.dump({"last": {"P": jst.iso(POSTED + 3 * H - 10 * M)}}, f)
+    _run(a, adapter, POSTED + 3 * H)              # 台帳では 2 時間・state では 10 分
+    assert _called(adapter) == [], "state の時刻を見ずに取り直した"
+    _run(a, adapter, POSTED + 3 * H + 10 * M)     # state から 20 分
+    assert _called(adapter) == ["P"]
+    assert _state(a)["P"] == jst.iso(POSTED + 3 * H + 10 * M)
+    _run(a, adapter, POSTED + 3 * H + 20 * M)     # 取り直しから 10 分（記録は state だけ）
+    assert _called(adapter) == ["P"]
+
+
+@pytest.mark.parametrize("content", ["{壊れ", "[]", '{"last": 3}'])
+def test_stateが壊れても採取は止まらない(tmp_path, isolated_account_factory, monkeypatch, content):
+    a = _account(isolated_account_factory, monkeypatch)
+    _post(a, "P", POSTED)
+    _run(a, Adapter(), POSTED + 1 * H)
+    os.makedirs(_state_dir(a), exist_ok=True)
+    with open(os.path.join(_state_dir(a), "reply_follow.json"), "w", encoding="utf-8") as f:
+        f.write(content)
+    adapter = Adapter()
+    lines = []
+    result = c.collect_once(a["name"], adapter=adapter, now=POSTED + 2 * H, log=lines.append)
+    assert result["errors"] == []
+    assert _called(adapter) == ["P"]
+    assert any("空として扱います" in line for line in lines)
+    assert set(_state(a)) == {"P"}, "壊れた記録を書き直していない"

thth-4.4.0/thth/VERSION

@@ -0,0 +1 @@
+4.4.0

{thth-4.3.1 → thth-4.4.0}/thth/accounts.py

@@ -562,6 +562,12 @@ def load_account(name: str) -> dict:
         raise AccountError(
             f"{name}: 台帳の profile_links が受け取れません（invalid_profile_links・"
             f"http(s) の URL を最大 {PROFILE_LINKS_MAX} つ）")
+    # 会話の続く投稿の取り直し（4.4.0・`thth/reply_follow.py`）。形が違えば既定に倒さず断る。
+    from . import reply_follow
+    if "reply_follow" in data and not reply_follow.valid(data["reply_follow"]):
+        raise AccountError(
+            f"{name}: 台帳の reply_follow が受け取れません（invalid_reply_follow・鍵は "
+            f"enabled（true/false）・every_minutes（5〜1440）・live_hours（1〜720）・max_posts（0〜50））")
     # 安全装置（設計 3.12.0）。知らない値は黙って既定に倒さず断る。
     # `approval`（3.12.0）は読まない（IGNORED_FIELDS）。
     for key in GUARD_DEFAULTS:

{thth-4.3.1 → thth-4.4.0}/thth/collect.py

@@ -52,6 +52,7 @@ from . import measured as measured_mod
 from . import postid as postid_mod
 from . import queuefile
 from . import redact as redact_mod
+from . import reply_follow as reply_follow_mod
 from . import runs as runs_mod
 from . import writeback
 from .adapters import base as adapter_base
@@ -597,7 +598,8 @@ def collect_once(account_name: str, *, adapter, now=None, log=print) -> dict:
     # **X の自分の投稿の数字（Owned Reads）を読んでよい id**: THTH が出して `sent/` に
     # 記録があり、取り下げていないものだけ（masaru 10/12 決定 1・他人の投稿は読まない）。
     owned_sent_ids = set()
-    for row in sent_mod.records(accounts_mod.state_dir_for(account_name)):
+    sent_rows = sent_mod.records(accounts_mod.state_dir_for(account_name))
+    for row in sent_rows:
         if row.get('post_id') and not row.get('retracted_at'):
             owned_sent_ids.add(str(row['post_id']))
         if isinstance(row.get('attachment_kinds'), list):
@@ -610,6 +612,29 @@ def collect_once(account_name: str, *, adapter, now=None, log=print) -> dict:
     paid_reads = bool(getattr(adapter, "PAID_READS", False))
     # X の自分の投稿で刻みを跨いだもの（ループの後で 1 回にまとめて読む）。
     owned_due: list = []
+    # **会話の続く投稿の取り直し**（4.4.0・`thth/reply_follow.py`）。刻みとは別に、候補を
+    # ループで集めて、ループの後で新しい動きの順に上限の本数だけ取り直す。
+    follow_cfg = reply_follow_mod.settings(account_cfg)
+    follow_due: list = []
+    own_reply_at = reply_follow_mod.own_reply_times(sent_rows) if follow_cfg["enabled"] else {}
+    follow_state_dir = accounts_mod.state_dir_for(account_name)
+    follow_state = (reply_follow_mod.read_state(follow_state_dir, log=log)
+                    if follow_cfg["enabled"] else {})
+
+    def consider_follow(*, post_id, posted_at, age_hours, reply_path, source, reply_to):
+        if not follow_cfg["enabled"] or age_hours > collect_days * 24:
+            return
+        rows = _read_ndjson(reply_path)
+        key = reply_follow_mod.candidate(
+            now=now, posted_at=posted_at,
+            reply_rows=[r for r in rows if r.get("kind") != "fetch"],
+            fetch_rows=[r for r in rows if r.get("kind") == "fetch"],
+            own_reply_at=own_reply_at.get(str(post_id)), cfg=follow_cfg,
+            followed_at=follow_state.get(str(post_id)))
+        if key is not None:
+            follow_due.append((key, dict(post_id=post_id, age_hours=age_hours,
+                                         reply_path=reply_path, source=source,
+                                         reply_to=reply_to)))
 
     def write_insight(*, qf, fm, source, post_id, posted_at_raw, age_hours, marks,
                       insight_path, section, metrics):
@@ -727,6 +752,10 @@ def collect_once(account_name: str, *, adapter, now=None, log=print) -> dict:
             # 読むのは `sent/` に記録がある（THTH が出した・取り下げていない）id だけ。
             if str(post_id) not in owned_sent_ids:
                 continue
+            # X の取り直しは台帳で `reply_follow.enabled: true` を明示したときだけ（既定は外す）。
+            consider_follow(post_id=post_id, posted_at=posted_at, age_hours=age_hours,
+                            reply_path=reply_path, source=source,
+                            reply_to=fm.get("reply_to") or parents.get(str(post_id)))
             marks = due_marks(age_hours, _read_ndjson(insight_path)) if age_hours <= metric_window_days() * 24 else []
             if marks:
                 owned_due.append(dict(qf=qf, fm=fm, source=source, post_id=str(post_id),
@@ -741,6 +770,11 @@ def collect_once(account_name: str, *, adapter, now=None, log=print) -> dict:
         # 「部分的な成功は次の実行で埋まる」という約束に反していた。
         marks = due_marks(age_hours, _read_ndjson(insight_path)) if age_hours <= metric_window_days() * 24 else []
         reply_marks = due_marks(age_hours, _reply_fetches(reply_path), marks=REPLY_MARKS_HOURS) if age_hours <= collect_days * 24 else []
+        if not reply_marks:
+            # 刻みで取る回は取り直さない（同じ回に 2 度読まない）。
+            consider_follow(post_id=post_id, posted_at=posted_at, age_hours=age_hours,
+                            reply_path=reply_path, source=source,
+                            reply_to=fm.get("reply_to") or parents.get(str(post_id)))
         if not marks and not reply_marks:
             continue
 
@@ -789,6 +823,16 @@ def collect_once(account_name: str, *, adapter, now=None, log=print) -> dict:
                 if 新しい:
                     log(f"返信 {len(新しい)} 件: {post_id}")
 
+    # --- 会話の続く投稿の取り直し（4.4.0）。**失敗は `errors` に積まない**——採取の
+    # 終了コードも投稿の道も悪くしない。理由は log に残す（次の回が取り直す）。
+    follow = _collect_follow(adapter, account_cfg, reply_follow_mod.pick(follow_due, follow_cfg),
+                             now=now, owned=owned, paid_reads=paid_reads, log=log)
+    touched.extend(follow["touched"])
+    if follow["followed"]:
+        follow_state.update({pid: now for pid in follow["followed"]})
+        reply_follow_mod.write_state(follow_state_dir, follow_state, now=now,
+                                     live_hours=follow_cfg["live_hours"], log=log)
+
     # --- X の自分の投稿の数字（Owned Reads）: 刻みを跨いだものを 100 本ずつ 1 回で
     if owned_due:
         _collect_owned(adapter, owned_due, now=now, errors=errors, write=write_insight,
@@ -810,7 +854,54 @@ def collect_once(account_name: str, *, adapter, now=None, log=print) -> dict:
         touched.append(account_path)
 
     return {"touched": sorted(set(touched)), "posts": posts_seen, "errors": errors,
-            "inbox": inbox_state}
+            "inbox": inbox_state,
+            "follow": {k: follow[k] for k in ("requested", "fetched", "new_replies", "failed")}}
+
+
+def _collect_follow(adapter, account_cfg: dict, due: list, *, now, owned, paid_reads: bool,
+                    log) -> dict:
+    """会話の続く投稿を取り直す（4.4.0）。`--refresh` と同じ性質: `marks: []`・数は取らない。
+
+    戻り値の `failed` は `[{"post_id", "reason"}]`。**ここで起きた失敗は採取の `errors` に
+    入れない**（取り直しは刻みの補いで、取れなくても次の刻み・次の回で埋まる）。
+    """
+    out = {"requested": len(due), "fetched": 0, "new_replies": 0, "failed": [], "touched": [],
+           "followed": []}
+    for entry in due:
+        pid, reply_path = str(entry["post_id"]), entry["reply_path"]
+        try:
+            _rows, broken = _read_ndjson_strict(reply_path)
+            if broken:
+                raise ValueError("台帳が壊れています")
+            if paid_reads:
+                # 台帳で明示したときだけここに来る（X）。1 回の本数を最小にして代金を抑える。
+                limit = getattr(adapter, "CONVERSATION_MIN", None)
+                replies = (adapter.conversation(pid, limit=limit) if limit
+                           else adapter.conversation(pid))
+            else:
+                replies = _fetch_replies(adapter, account_cfg, pid, entry["reply_to"], owned)
+            # **新しい返信が無ければ利用者の repo に何も書かない**（masaru 10/21）。書けば
+            # 20 分おきに利用者の main へ「収集」の commit が積まれ、承認の target がずれる。
+            # 取り直した時刻は VM の state（`reply_follow.json`）にだけ持つ。
+            known = {reply_row_id(row) for row in _reply_rows(reply_path)}
+            if any(reply_row_id(row) and reply_row_id(row) not in known for row in replies):
+                新しい = _save_replies(reply_path, pid, replies, now=now,
+                                       age_hours=entry["age_hours"], marks=[],
+                                       trigger=reply_follow_mod.TRIGGER, source=entry["source"])
+            else:
+                新しい = []
+        except Exception as e:  # 取り直しの失敗で採取も投稿も止めない
+            reason = redact_mod.redact(str(e))
+            out["failed"].append({"post_id": pid, "reason": reason})
+            log(f"返信の取り直しができませんでした（次の回で取り直します）: {pid}: {reason}")
+            continue
+        out["fetched"] += 1
+        out["followed"].append(pid)
+        out["new_replies"] += len(新しい)
+        if 新しい:
+            out["touched"].append(reply_path)
+            log(f"返信 {len(新しい)} 件（取り直し）: {pid}")
+    return out
 
 
 def _collect_owned(adapter, due: list, *, now, errors: list, write, account_name: str) -> None: