thth 2.3.2__tar.gz → 2.3.3__tar.gz

{thth-2.3.2 → thth-2.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: thth
-Version: 2.3.2
+Version: 2.3.3
 Summary: 承認済みの投稿だけを投げる門（Threads・Bluesky・Mastodon）。人が承認し、記録は利用者の git に残る。
 Project-URL: Homepage, https://thth.me
 Project-URL: Source, https://github.com/aokings/thth
@@ -45,7 +45,7 @@ watchtower（`~/Developer/watchtower`）の隣に同じ流儀で並べる。watc
 
 ## いまの状態（2026-09-13）
 
-版 **2.3.2**。全件テスト **2310 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。
+版 **2.3.3**。全件テスト **2320 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。
 
 **媒体**: Threads（稼働）・Bluesky・Mastodon（同席用の台帳あり・未稼働）。
 

{thth-2.3.2 → thth-2.3.3}/README.md

@@ -21,7 +21,7 @@ watchtower（`~/Developer/watchtower`）の隣に同じ流儀で並べる。watc
 
 ## いまの状態（2026-09-13）
 
-版 **2.3.2**。全件テスト **2310 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。
+版 **2.3.3**。全件テスト **2320 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。
 
 **媒体**: Threads（稼働）・Bluesky・Mastodon（同席用の台帳あり・未稼働）。
 

{thth-2.3.2 → thth-2.3.3}/skills/thth/SKILL.md

@@ -12,7 +12,8 @@ description: 投稿する前・返信を書く前・出したあと・絡みに
 - **`--production` を付けるまで出ない。** 付けない実行は、投げるはずの本文と digest を
   表示して終わる。
 - **記録は利用者の git に残る。** post_id・承認者・承認時刻・返信・実測は、あなたの repo の
-  commit として残る。THTH のサーバには何も無い。
+  commit として残る。THTH のサーバには何も無い。絡みの台帳（`data/sns/engagements/`）は
+  公開の commit とは別で、**次の採取（`thth collect`・最大 10 分の遅れ）**で commit される。
 - **数値には分母が付く。** 件数・期間・揃えた条件が無い数字は返さない。取れていない刻みは
   `null` であって `0` ではない。
 - **黙って間違えない。** 拒むときは理由と次の一手を言って非ゼロで終わる（loud reject）。
@@ -30,8 +31,11 @@ description: 投稿する前・返信を書く前・出したあと・絡みに
 - **何を書くかを決めない。** 文体・頻度・時刻・語の選び方はあなたのプロジェクトのもの。
   渡された本文を**整形も切り詰めもせず**そのまま出す。
 - **読む口は何も保存しない。** `thread_read`・`where_to_appear`・`who_is_this` はどれも、
-  読んで見せるだけで**台帳に 1 バイトも書かない**。残るのは**自分の行為と反応**
-  （絡みの台帳）だけで、**相手の本文・相手の名前・あなたの判断は台帳に入らない**。
+  読んで見せるだけで**台帳に 1 バイトも書かない**。この 3 つと絡みの台帳
+  （`data/sns/engagements/`）だけを見れば、残るのは**自分の行為と反応**だけで、
+  **相手の本文・相手の名前・あなたの判断は入らない**。**別の台帳**——自分の投稿への
+  返信の台帳（`thth collect` が採り、`thth replies` で読む）——は、この規律の外で
+  相手の `username` と本文をそのまま残す（読む口でもなく、絡みの台帳でもない）。
 - **人の代わりに承認しない。** あなた（エージェント）は下書きと digest を人に見せ、
   人が `--confirm` を打つ。
 

{thth-2.3.2 → thth-2.3.3}/tests/test_behind_remote.py

@@ -46,6 +46,11 @@ def test_behind_remoteはfetchできないとNoneとreason(tmp_path):
         ["git", "init", "-b", "main", str(broken)], capture_output=True, text=True)
     assert run_git_init.returncode == 0
     run_git(str(broken), ["remote", "add", "origin", "/does/not/exist/repo.git"])
+    # **git の名前とメールを repo に持たせる**（`conftest.init_git_pair()` と同じ）。
+    # 開発機（macOS）は全体の設定があるので通っていたが、GitHub Actions の
+    # Linux には無く、`commit` が "Author identity unknown" で落ちた（2026-09-16）。
+    run_git(str(broken), ["config", "user.email", "thth-test@example.invalid"])
+    run_git(str(broken), ["config", "user.name", "thth-test"])
     run_git(str(broken), ["commit", "--allow-empty", "-m", "x"])
 
     info = writeback.behind_remote(str(broken))

thth-2.3.3/tests/test_collect_engagements.py

@@ -0,0 +1,175 @@
+"""絡みの台帳（`data/sns/engagements/`）を採取の commit に含める（T9-1・
+照合「X Developer Agreement と自分の泉」検収 1）。
+
+**事実**: 投稿の commit（`core.py` の `writeback.commit_and_push(rel_path=原稿)`）は
+原稿ファイルだけ、採取の commit（`collect.py` の `result["touched"]`）は採取で
+触ったファイルだけを add する。同席送信（`core._send_locked`）は commit しない。
+`thth/engagements.py::append()` が書く `data/sns/engagements/<YYYY-MM>.ndjson` は
+どこからも add されず、VM の repo に未追跡のまま溜まっていた。
+
+固定するのは 4 つ（発注 T9-1 の (a)〜(d)）:
+
+  (a) `engagements.append` で 1 行書いた repo で `collect` を 1 回 → origin に
+      `data/sns/engagements/<月>.ndjson` が push されている。
+  (b) 採取で触るものが 0 でも (a) と同じ。
+  (c) repo が無い account では git を呼ばない。
+  (d) 何も変わっていなければ空の commit を作らない。
+"""
+from __future__ import annotations
+
+import datetime
+import json
+import os
+import subprocess
+
+from tests.conftest import init_git_pair, make_queue_text
+from tests.test_collect import FakeAdapter
+from thth import accounts as accounts_mod
+from thth import collect as collect_mod
+from thth import engagements as engagements_mod
+from thth import jst
+
+NOW = datetime.datetime(2026, 9, 16, 12, 0, tzinfo=jst.JST)
+
+
+class NoOpAdapter:
+    """能力を何も名乗らない偽アダプタ（`collect_once()` に何も触らせない）。
+
+    `tests/test_collect_sent.py` の `FakeAdapter` と違い `views` すら持たない
+    ——**採取が触るものを 0 にする**ためだけの道具。
+    """
+
+    CAPABILITIES = frozenset()
+
+    @classmethod
+    def capabilities(cls):
+        return set(cls.CAPABILITIES)
+
+    def insights(self, post_id):
+        raise AssertionError("能力を名乗っていないのに insights を呼んだ")
+
+    def conversation(self, post_id, *, since=None):
+        raise AssertionError("能力を名乗っていないのに conversation を呼んだ")
+
+    def account_insights(self, user_id, *, since, until):
+        raise AssertionError("能力を名乗っていないのに account_insights を呼んだ")
+
+
+def _engagement_row(**over):
+    row = {
+        "schema": engagements_mod.SCHEMA,
+        "post_id": "111",
+        "reply_to": "222",
+        "root_post": None,
+        "author_key": None,
+        "account": None,  # append() 側の既定に任せる
+        "medium": "threads",
+        "topic": None,
+        "form": None,
+        "hour_band": "朝",
+        "posted_at": "2026-09-16T08:00:00+09:00",
+        "found_by": None,
+    }
+    row.update(over)
+    return row
+
+
+def _in_origin(bare: str) -> str:
+    return subprocess.run(
+        ["git", "-C", bare, "ls-tree", "-r", "--name-only", "main"],
+        capture_output=True, text=True,
+    ).stdout
+
+
+def test_a_絡みの台帳が採取のcommitでpushされる(tmp_path, isolated_account_factory):
+    """採取が投稿本体も触る、ふつうの回。絡みの台帳も同じ commit に乗って
+    origin まで届く。"""
+    pair = init_git_pair(tmp_path, seed_content=make_queue_text({
+        "status": "posted", "post_id": "POST1",
+        "posted_at": "2026-09-16T10:00:00+09:00"}))  # 2 時間前・1h の刻みを跨ぐ
+    account = isolated_account_factory(repo_dir=pair["work"], production=True)
+
+    cfg = accounts_mod.load_account(account["name"])
+    engagements_mod.append(cfg, account["name"],
+                            _engagement_row(account=account["name"]), now=NOW)
+
+    rc = collect_mod.run_collect(account["name"], adapter=FakeAdapter(), now=NOW,
+                                  log=lambda _l: None)
+
+    assert rc == 0
+    in_origin = _in_origin(pair["bare"])
+    assert "data/sns/engagements/2026-09.ndjson" in in_origin, in_origin
+    # ついでに、投稿の実測も同じ commit の対象として届いていること
+    # （足した処理が既存の touched を壊していないこと）。
+    assert "data/sns/insights/posts/POST1.ndjson" in in_origin, in_origin
+
+
+def test_b_採取で触るものが0でも絡みの台帳はpushされる(tmp_path, isolated_account_factory):
+    """`collect_once()` の `touched` が空でも、絡みの台帳の未追跡・変更だけで
+    commit する。"""
+    pair = init_git_pair(tmp_path, seed_content=make_queue_text({
+        "status": "posted", "post_id": "POST1",
+        # collect_days（既定 14 日）をとうに過ぎている → posts_seen は 0、
+        # touched も空のまま（NoOpAdapter は何も能力を名乗らないので
+        # アカウント日次も呼ばれない）。
+        "posted_at": "2026-08-01T10:00:00+09:00"}))
+    account = isolated_account_factory(repo_dir=pair["work"], production=True)
+
+    cfg = accounts_mod.load_account(account["name"])
+    engagements_mod.append(cfg, account["name"],
+                            _engagement_row(account=account["name"]), now=NOW)
+
+    rc = collect_mod.run_collect(account["name"], adapter=NoOpAdapter(), now=NOW,
+                                  log=lambda _l: None)
+
+    assert rc == 0
+    in_origin = _in_origin(pair["bare"])
+    assert "data/sns/engagements/2026-09.ndjson" in in_origin, in_origin
+    # 投稿側は本当に何も触っていないこと（この test が (a) の焼き直しに
+    # なっていないことの確認）。
+    assert "data/sns/insights/posts/POST1.ndjson" not in in_origin, in_origin
+
+
+def test_c_repoが無いaccountでは絡みの台帳も含めてgitを呼ばない(
+        tmp_path, isolated_account_factory, monkeypatch):
+    """`repo_dir` が実在しない台帳（`repos/_none` 相当）では、絡みの台帳の
+    判定そのもの（`_pending_engagement_paths`）を呼ばない——呼べば
+    `git status` を repo の外で走らせる危険がある。"""
+    account = isolated_account_factory(
+        repo_dir=str(tmp_path / "repos" / "_none"), production=True, scheduled=False)
+
+    def 呼ぶな(*a, **k):
+        raise AssertionError("repo が無いのに絡みの台帳の git 判定を呼んだ")
+
+    monkeypatch.setattr(collect_mod, "_pending_engagement_paths", 呼ぶな)
+    monkeypatch.setattr(collect_mod, "_git", 呼ぶな)
+    monkeypatch.setattr(collect_mod.writeback, "sync_repo", 呼ぶな)
+    monkeypatch.setattr(collect_mod.writeback, "commit_and_push", 呼ぶな)
+
+    rc = collect_mod.run_collect(account["name"], adapter=NoOpAdapter(), now=NOW,
+                                  log=lambda _l: None)
+    assert rc == 0
+
+
+def test_d_変わっていなければ空のcommitを作らない(tmp_path, isolated_account_factory,
+                                                    monkeypatch):
+    """絡みの台帳に変更が無い回は、`commit_and_push` を一切呼ばない。"""
+    pair = init_git_pair(tmp_path, seed_content=make_queue_text({
+        "status": "posted", "post_id": "POST1",
+        "posted_at": "2026-08-01T10:00:00+09:00"}))  # collect_days を過ぎている
+    account = isolated_account_factory(repo_dir=pair["work"], production=True)
+
+    calls = []
+    real_commit_and_push = collect_mod.writeback.commit_and_push
+
+    def 数える(*a, **k):
+        calls.append((a, k))
+        return real_commit_and_push(*a, **k)
+
+    monkeypatch.setattr(collect_mod.writeback, "commit_and_push", 数える)
+
+    rc = collect_mod.run_collect(account["name"], adapter=NoOpAdapter(), now=NOW,
+                                  log=lambda _l: None)
+
+    assert rc == 0
+    assert calls == [], "変更が無いのに commit_and_push を呼んだ"

thth-2.3.3/tests/test_read_cli_bare_runtimeerror.py

@@ -0,0 +1,179 @@
+"""読む口 4 つ（`thread`・`where`・`who`・`threads_read_cli` の口）が、adapter の
+素の `RuntimeError` で traceback にならない（T9-2・照合「X Developer Agreement
+と自分の泉」検収 5）。
+
+**事実**: `thth/adapters/base.py` の `AdapterError` は `RuntimeError` の子。
+Bluesky（`bluesky.py` の `_request` 周り・`session()` の 367・374 行、`_xrpc()` の
+260・262 行）は素の `RuntimeError` を投げる箇所がある。`thth/thread_read.py`・
+`thth/where_cli.py`・`thth/who_cli.py`・`thth/threads_read_cli.py::_run` はどれも
+`AdapterError` と `PermissionMissing` だけを捕まえていたので、素の `RuntimeError`
+は traceback になっていた。
+
+ここでは実際の Bluesky・Threads の通信は起こさず、`adapters.make_adapter()` を
+差し替えた偽アダプタで「adapter が素の `RuntimeError` を投げたら」を作る——
+4 つの口それぞれの捕捉の**位置**（`thread_read.cmd_thread`・
+`where_cli._account_node` の語ごとの try・`who_cli._profile_for`・
+`threads_read_cli._run`）を直に確かめる。
+
+固定するのは:
+  - `thread`・`threads_read_cli`（`topics --search`）: rc=1・`--json` は
+    `{"error", "account"}`・**adapter の例外の型は変えていない**ので
+    `AdapterError` の枝はそのまま通る。
+  - `where`・`who`: その account（語・プロフィール）の `cannot_say` に入り、
+    他の語・他の account は続く（`AdapterError` と同じ既存の筋のまま）。
+"""
+from __future__ import annotations
+
+import argparse
+import json
+
+import pytest
+
+from thth import accounts as accounts_mod
+from thth import adapters as adapters_mod
+from thth import thread_read as thread_read_mod
+from thth import threads_read_cli as threads_read_cli_mod
+from thth import where_cli as where_cli_mod
+from thth import who_cli as who_cli_mod
+
+BARE_MESSAGE = "素の RuntimeError（fake・T9-2・bluesky._request 相当）"
+
+
+class _BareRuntimeErrorAdapter:
+    """能力だけ答え、実際に叩かれたら**`AdapterError` ではない**素の
+    `RuntimeError` を投げる偽アダプタ。Bluesky の `_request`／`session()` が
+    本番で投げる形を模す。"""
+
+    def capabilities(self):
+        return {"thread_read", "keyword_search", "profile_lookup", "mentions"}
+
+    def fetch_post(self, post_id):
+        raise RuntimeError(BARE_MESSAGE)
+
+    def conversation(self, post_id, *, since=None):
+        raise RuntimeError(BARE_MESSAGE)
+
+    def keyword_search(self, word, *, search_type, limit):
+        raise RuntimeError(BARE_MESSAGE)
+
+    def profile_lookup(self, username):
+        raise RuntimeError(BARE_MESSAGE)
+
+    def mentions(self, *, since=None):
+        raise RuntimeError(BARE_MESSAGE)
+
+    def granted_scopes(self):
+        return []
+
+
+def _write_token(path):
+    with open(path, "w", encoding="utf-8") as f:
+        json.dump({"access_token": "FAKE-SECRET", "user_id": "999999",
+                  "username": "nigamilab", "scopes": None,
+                  "obtained_at": "2026-09-16T09:00:00+09:00"}, f)
+
+
+@pytest.fixture
+def bare_runtimeerror_account(tmp_path, isolated_account_factory, monkeypatch):
+    """Threads 台帳（4 つの capability を全部持つ実クラスの検査は通す）だが、
+    `adapters.make_adapter()` を差し替えて、実際に返す adapter は素の
+    `RuntimeError` しか投げない偽物にする。"""
+    token_path = str(tmp_path / "a.token")
+    _write_token(token_path)
+    account = isolated_account_factory(token=token_path, handle="nigamilab")
+    monkeypatch.setattr(adapters_mod, "make_adapter",
+                        lambda cfg, token: _BareRuntimeErrorAdapter())
+    return account
+
+
+# ---------------------------------------------------------------- thread_read
+
+def test_thread読む口はrc1でtracebackにならない(bare_runtimeerror_account, capsys):
+    args = argparse.Namespace(account=bare_runtimeerror_account["name"], post_id="POST1",
+                              since=None, max_messages=thread_read_mod.DEFAULT_MAX_MESSAGES,
+                              json=True)
+    rc = thread_read_mod.cmd_thread(args)
+    out = capsys.readouterr()
+
+    assert rc == 1
+    assert "Traceback" not in out.err
+    payload = json.loads(out.out)
+    assert set(payload) == {"error", "account"}
+    assert payload["account"] == bare_runtimeerror_account["name"]
+    assert BARE_MESSAGE in payload["error"]
+
+
+# ------------------------------------------------------------ threads_read_cli
+
+def test_threads_read_cliの口はrc1でtracebackにならない(bare_runtimeerror_account, capsys):
+    args = argparse.Namespace(account=bare_runtimeerror_account["name"], search="語",
+                              recent=False, limit=25, json=True)
+    rc = threads_read_cli_mod.cmd_topics_search(args)
+    out = capsys.readouterr()
+
+    assert rc == 1
+    assert "Traceback" not in out.err
+    payload = json.loads(out.out)
+    assert set(payload) == {"error", "account"}
+    assert payload["account"] == bare_runtimeerror_account["name"]
+    assert BARE_MESSAGE in payload["error"]
+
+
+# --------------------------------------------------------------------- where
+
+def test_where読む口はcannot_sayに入り他の語は続く(bare_runtimeerror_account, capsys):
+    args = argparse.Namespace(project=None,
+                              targets=[bare_runtimeerror_account["name"], "苦い", "コーヒー"],
+                              recent=False, limit=where_cli_mod.DEFAULT_LIMIT, json=True)
+    rc = where_cli_mod.cmd_where(args)
+    out = capsys.readouterr()
+
+    assert rc == 0, out.err  # `AdapterError` と同じ筋（account 単位の失敗にしない）
+    assert "Traceback" not in out.err
+    result = json.loads(out.out)
+    node = result["by_account"][bare_runtimeerror_account["name"]]
+    # 2 語とも by_word には入らず、node の cannot_say に落ちる（PermissionMissing/
+    # AdapterError と同じ扱い・T9-2 で RuntimeError も同じ列に並んだ）。
+    assert node["by_word"] == {}
+    assert any("苦い" in line and BARE_MESSAGE in line for line in node["cannot_say"])
+    assert any("コーヒー" in line and BARE_MESSAGE in line for line in node["cannot_say"])
+
+
+# ---------------------------------------------------------------------- who
+
+def test_whoの読む口はcannot_sayに入る(bare_runtimeerror_account, capsys):
+    args = argparse.Namespace(project=None,
+                              targets=[bare_runtimeerror_account["name"], "@bob"],
+                              profile=True, json=True)
+    rc = who_cli_mod.cmd_who(args)
+    out = capsys.readouterr()
+
+    assert rc == 0, out.err
+    assert "Traceback" not in out.err
+    result = json.loads(out.out)
+    assert result["profile"] is None
+    assert any(BARE_MESSAGE in line for line in result["cannot_say"])
+
+
+# ----------------------------------------------------- adapter の例外の型は不変
+
+def test_AdapterErrorの枝は素のRuntimeErrorに食われない():
+    """`except AdapterError` が先・`except RuntimeError` が後——`AdapterError`
+    は `RuntimeError` の子なので、順序を間違えると `AdapterError` の枝が
+    死んでいてもテストは気づかない。ここは 4 箇所のソースを直に読んで、
+    `AdapterError` の except が `RuntimeError` の except より**前**にあることを
+    確かめる（読み違いで壊す変異にも強くする）。"""
+    import inspect
+
+    for mod, func_name in (
+        (thread_read_mod, "cmd_thread"),
+        (threads_read_cli_mod, "_run"),
+        (where_cli_mod, "_account_node"),
+        (who_cli_mod, "_profile_for"),
+    ):
+        src = inspect.getsource(getattr(mod, func_name))
+        adapter_error_at = src.index("except adapter_base.AdapterError")
+        runtime_error_at = src.index("except RuntimeError")
+        assert adapter_error_at < runtime_error_at, (
+            f"{mod.__name__}.{func_name}: AdapterError の except が "
+            f"RuntimeError より後にある——AdapterError の枝が死ぬ")

{thth-2.3.2 → thth-2.3.3}/tests/test_skill_doc.py

@@ -99,3 +99,29 @@ def test_泉に落とすかどうかの節が削られている():
     """T4-1「『泉に落とすかどうか（§4）』の節は削る」。"""
     text = _read()
     assert "泉に落とすかどうか" not in text
+
+
+def _bullets(text: str) -> list:
+    """トップレベルの `- ` 箇条書きを 1 項目 1 要素に割る。
+
+    続きの行（インデントされた行）は直前の項目にくっつく——1 つの箇条書き
+    項目が複数行にまたがっていても 1 ブロックとして見られるように。
+    """
+    return re.split(r"\n(?=- )", text)
+
+
+def test_replies台帳が相手のusernameと本文を残すと書かれている():
+    """T9-3: 自分の投稿への返信の台帳（`thth collect` が採り、`thth replies` で
+    読む）は相手の `username` と本文を残す——「何を絶対にしないか」の読む口の
+    項（`thread_read`・`where_to_appear`・`who_is_this` は何も保存しない・
+    絡みの台帳は自分の行為と反応だけ）と混同されないよう、この事実を書く
+    （照合「X Developer Agreement と自分の泉」検収 2）。
+
+    **言い方を固定しすぎない検査**: 特定の文言を assert するのではなく、
+    `replies` と `username` が**同じ箇条書き項目**に出てくることだけを見る。
+    """
+    text = _read()
+    bullets = _bullets(text)
+    hit = [b for b in bullets if "replies" in b and "username" in b]
+    assert hit, ("「replies」と「username」が同じ箇条書き項目に出てくる"
+                 "ブロックがありません")

thth-2.3.3/thth/VERSION

@@ -0,0 +1 @@
+2.3.3

{thth-2.3.2 → thth-2.3.3}/thth/collect.py

@@ -132,6 +132,54 @@ def pending_paths(repo_dir: str, account_cfg: dict) -> list:
     return sorted(out)
 
 
+def _pending_engagement_paths(repo_dir: str, account_cfg: dict, account_name: str) -> list:
+    """絡みの台帳（`data/sns/engagements/*.ndjson`）のうち、未追跡か変更が
+    あるものを絶対パスで返す（T9-1・照合「X Developer Agreement と自分の泉」
+    検収 1）。
+
+    `collect_once()` の `touched` は「今回の採取で触ったファイル」だけを
+    数える。絡みの台帳（`thth/engagements.py::append()`）は**公開が確定した
+    直後**に書かれ、それは `thth core.py` の queue 経由の投稿だけでなく
+    `_send_locked`（同席送信）でも起きる——だが `_send_locked` は commit しない
+    （`core.py:707,759-780`）。結果、絡みの行は VM の repo に未追跡のまま
+    溜まり、**同期（`sync_repo`）は未追跡を見ないので止まらないが、git には
+    一度も入らない**。
+
+    ここで `git status --porcelain` を見て、採取自身が何も触らなくても
+    絡みの台帳の変更を拾う（`writeback.pending_paths()` と同じ流儀だが、
+    見る先を `data/sns` 全体ではなく **engagements だけ**に絞る——他の
+    `data/sns` 配下の変更を二重に拾わないため）。
+    """
+    if not repo_dir or not os.path.isdir(repo_dir):
+        return []
+    dirs = accounts_mod.data_dirs(account_cfg, account_name)
+    engagements_dir = dirs["engagements"]
+    if not os.path.isdir(engagements_dir):
+        return []
+    rel_dir = os.path.relpath(os.path.realpath(engagements_dir), os.path.realpath(repo_dir))
+    if rel_dir == os.pardir or rel_dir.startswith(os.pardir + os.sep):
+        # engagements が repo の外を指す異常系（state 側の置き場と repo_dir が
+        # 食い違っている）。git には触らない。
+        return []
+    # **`--untracked-files=all` が要る。** 既定の `git status --porcelain` は
+    # 中身が丸ごと未追跡なディレクトリを `?? data/sns/engagements/`（末尾
+    # スラッシュ付きの 1 行）にまとめて返し、個々のファイル名を出さない。
+    # `engagements/` は採取が repo に初めて作る側なので、**最初の 1 回は
+    # ほぼ必ずこの「ディレクトリごと未追跡」の形**になる——`.ndjson` で
+    # 終わらない行として弾かれ、絶対に拾えなかった（この関数を書いた本人が
+    # 変異テストで踏んだ）。
+    status = _git(repo_dir, ["status", "--porcelain", "--untracked-files=all",
+                              "--", rel_dir])
+    if status.returncode != 0:
+        return []
+    out = []
+    for line in status.stdout.splitlines():
+        path = line[3:].strip()
+        if path and path.endswith(".ndjson"):
+            out.append(os.path.join(repo_dir, path))
+    return sorted(out)
+
+
 def _read_ndjson_strict(path: str) -> tuple:
     """`(行, 壊れているか)`。**壊れた行を黙って飛ばさない。**
 
@@ -1004,9 +1052,15 @@ def _collect_entry(account_name: str, *, adapter, now, log, info: dict) -> int:
         result = collect_once(account_name, adapter=adapter, now=now, log=log)
         _note(info, result)
 
-        if result["touched"]:
+        # T9-1: 絡みの台帳（`_send_locked` が書いた行も含む）は `collect_once()`
+        # の `touched` に一度も現れない。採取で他に何も触らなくても、絡みの
+        # 台帳に未追跡・変更があれば同じ commit に含める。
+        engagement_paths = _pending_engagement_paths(repo_dir, account_cfg, account_name)
+        all_touched = sorted(set(result["touched"]) | set(engagement_paths))
+
+        if all_touched:
             rel = [os.path.relpath(os.path.realpath(p), os.path.realpath(repo_dir))
-                   for p in result["touched"]]
+                   for p in all_touched]
             pushed, push_err = writeback.commit_and_push(
                 repo_dir, rel_path=rel,
                 message=f"収集: {len(rel)} ファイル（{account_name}）")

{thth-2.3.2 → thth-2.3.3}/thth/thread_read.py

@@ -474,6 +474,22 @@ def cmd_thread(args) -> int:
         else:
             print(message, file=sys.stderr)
         return 1
+    except RuntimeError as e:
+        # **`AdapterError` ではない素の `RuntimeError`**（Bluesky の `_request`
+        # 周りなど）を、`AdapterError` と同じ出し方で受ける（T9-2・照合
+        # 「X Developer Agreement と自分の泉」検収 5）。`AdapterError` は
+        # `RuntimeError` の子なので、この節は上の `except AdapterError` を
+        # すり抜けたものだけを拾う。**adapter が投げる例外の型は変えない**
+        # ——ここは受け口を増やすだけ。
+        message = f"{args.account}: {redact_mod.redact(str(e))}"
+        _record_run(args.account, media=media, post_id=args.post_id, messages=None,
+                   truncated=False, status="error", error=message)
+        if as_json:
+            print(json.dumps({"error": message, "account": args.account},
+                             ensure_ascii=False, indent=2))
+        else:
+            print(message, file=sys.stderr)
+        return 1
 
     _record_run(args.account, media=media, post_id=args.post_id,
                messages=result["counts"]["messages"],

{thth-2.3.2 → thth-2.3.3}/thth/threads_read_cli.py

@@ -246,6 +246,19 @@ def _run(account: str, *, capability: str, call, as_json: bool, render,
         else:
             print(message, file=sys.stderr)
         return 1
+    except RuntimeError as e:
+        # **`AdapterError` ではない素の `RuntimeError`**（Bluesky の `_request`
+        # 周りなど）を、`AdapterError` と同じ出し方で受ける（T9-2）。
+        # `AdapterError` は `RuntimeError` の子なので、上の
+        # `except AdapterError` をすり抜けたものだけがここに来る。**adapter が
+        # 投げる例外の型は変えない**——ここは受け口を増やすだけ。
+        message = f"{account}: {redact_mod.redact(str(e))}"
+        if as_json:
+            print(json.dumps({"error": message, "account": account},
+                             ensure_ascii=False, indent=2))
+        else:
+            print(message, file=sys.stderr)
+        return 1
     return render(result)
 
 

{thth-2.3.2 → thth-2.3.3}/thth/where_cli.py

@@ -163,6 +163,16 @@ def _account_node(account_name: str, words: list, *, search_type: str,
         except adapter_base.AdapterError as e:
             node_cannot_say.append(f"{word}: {redact_mod.redact(str(e))}")
             continue
+        except RuntimeError as e:
+            # **`AdapterError` ではない素の `RuntimeError`**（Bluesky の
+            # `_request` 周りなど）を、`AdapterError` と同じ出し方で受ける
+            # （T9-2）。`AdapterError` は `RuntimeError` の子なので、上の
+            # `except AdapterError` をすり抜けたものだけがここに来る。この
+            # account 全体を落とさず、その語だけ `cannot_say` に流して他の
+            # 語・他の account を続ける（`--project` で 1 account だけ落ちて
+            # も他が出る、という既存の筋と同じ）。
+            node_cannot_say.append(f"{word}: {redact_mod.redact(str(e))}")
+            continue
 
         material = threads_read_cli_mod.search_material(
             rows, q=word, search_type=search_type, limit=limit)

{thth-2.3.2 → thth-2.3.3}/thth/who_cli.py

@@ -95,6 +95,14 @@ def _profile_for(account_cfg: dict, account_name: str, *, username: str | None):
         return None, _permission_message(account_name, adapter, e)
     except adapter_base.AdapterError as e:
         return None, redact_mod.redact(str(e))
+    except RuntimeError as e:
+        # **`AdapterError` ではない素の `RuntimeError`**（Bluesky の
+        # `_request` 周りなど）を、`AdapterError` と同じ出し方で受ける
+        # （T9-2）。`AdapterError` は `RuntimeError` の子なので、上の
+        # `except AdapterError` をすり抜けたものだけがここに来る。呼び出し側
+        # （`_account_node`）はこれを `cannot_say` に足して account 全体は
+        # 落とさない。
+        return None, redact_mod.redact(str(e))
     return profile, None
 
 

thth-2.3.2/thth/VERSION

@@ -1 +0,0 @@
-2.3.2