thth 3.18.2__tar.gz → 3.19.0__tar.gz

{thth-3.18.2 → thth-3.19.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: thth
-Version: 3.18.2
+Version: 3.19.0
 Summary: 承認済みの投稿だけを投げる門（Threads・Bluesky・Mastodon）。人が承認し、記録は利用者の git に残る。
 Project-URL: Homepage, https://thth.me
 Project-URL: Source, https://github.com/aokings/thth
@@ -47,6 +47,8 @@ English: [README.en.md](README.en.md) · サイト: https://thth.me · 文書の
 - **再投稿といいね**: `thth repost`・`unrepost`・`like`・`unlike`（3.15.0 から）。Threads は再投稿だけ（Threads の API にいいねが無い）。Bluesky は両方。Mastodon と X のいいねは、そのアカウントを認可し直してから（[リリースノート 3.15.0](docs/リリースノート_3.15.0_2026-10-09.md)）。
 - **検索の語ごとの数を残す・絞る**（3.18.0）: `thth where … --also|--aggregate --keep` で語ごとの数だけを日付つきで残し（5 未満は欠測・本文や名前は残さない）、`thth where-log <project> [--budget N --medium x]` で当たり率と翌日の配り直しを見ます。`--ja`・`--question`・`--no-replies` で表示を絞ります（X の `--ja` は検索に `lang:ja` を足して読む本数を減らす）（[リリースノート 3.18.0](docs/リリースノート_3.18.0_2026-10-12.md)）。
 - **X の非公開リスト**: `thth list create|add|remove|show`（3.17.0 から・X だけ）。公開のリストは作らない。足す・外すは人が選んだ少数だけ（1 回 10 人まで）。アカウントを認可し直してから（[リリースノート 3.17.0](docs/リリースノート_3.17.0_2026-10-12.md)）。
+- **X のコミュニティ**: `thth community search <account> <語…>` で探し、`thth send <account> --community <id>` か queue の front-matter `community_id:` で出す（3.19.0 から・X だけ）。参加は X の画面で先に（API に参加の口は無い）。返信とは同時に使えない。各コミュニティの規則は人が読んで守る（[リリースノート 3.19.0](docs/リリースノート_3.19.0_2026-10-13.md)）。
+- **X のトレンドと語ごとの投稿数**: `thth trends <account> [--woeid N] [--max N]`（既定は日本）と `thth counts <account> <語> [--granularity hour|day]`（直近 7 日）（3.19.0 から・X だけ・1 回の有償の読み取り・保存しない）。
 
 ## はじめ方
 
@@ -107,7 +109,7 @@ MCP の道具は CLI の写しで、同じ `thth` コマンドを呼ぶだけで
 
 `thth --help` で各コマンドの説明が出ます。
 
-動くもの（`thth --help` の全サブコマンド）: `lint`・`preview`・`approve`・`account`・`revoke`・`posts`・`replies`・`measured`・`threads`・`after`・`analytics-report`・`study-report`・`study`・`unanswered`・`handoff-report`・`observe`・`morning`・`serve-reports`・`worker`・`topics`・`forms`・`queue`・`schedule`・`throw`・`run`・`systemd`・`board`・`collect`・`pull`・`auth`・`refresh`・`maintain`・`send`・`doctor`・`app`・`token`・`ask`・`mentions`・`profile`・`thread`・`where`・`where-log`・`who`・`retract`・`repost`・`unrepost`・`like`・`unlike`・`list`・`inflight`・`location`・`notifications`・`report`・`plaza`・`map`・`admin`・`login`・`logout`。
+動くもの（`thth --help` の全サブコマンド）: `lint`・`preview`・`approve`・`account`・`revoke`・`posts`・`replies`・`measured`・`threads`・`after`・`analytics-report`・`study-report`・`study`・`unanswered`・`handoff-report`・`observe`・`morning`・`serve-reports`・`worker`・`topics`・`forms`・`queue`・`schedule`・`throw`・`run`・`systemd`・`board`・`collect`・`pull`・`auth`・`refresh`・`maintain`・`send`・`doctor`・`app`・`token`・`ask`・`mentions`・`profile`・`thread`・`where`・`where-log`・`who`・`retract`・`repost`・`unrepost`・`like`・`unlike`・`list`・`community`・`trends`・`counts`・`inflight`・`location`・`notifications`・`report`・`plaza`・`map`・`admin`・`login`・`logout`。
 
 ## 版と配布
 

{thth-3.18.2 → thth-3.19.0}/README.md

@@ -23,6 +23,8 @@ English: [README.en.md](README.en.md) · サイト: https://thth.me · 文書の
 - **再投稿といいね**: `thth repost`・`unrepost`・`like`・`unlike`（3.15.0 から）。Threads は再投稿だけ（Threads の API にいいねが無い）。Bluesky は両方。Mastodon と X のいいねは、そのアカウントを認可し直してから（[リリースノート 3.15.0](docs/リリースノート_3.15.0_2026-10-09.md)）。
 - **検索の語ごとの数を残す・絞る**（3.18.0）: `thth where … --also|--aggregate --keep` で語ごとの数だけを日付つきで残し（5 未満は欠測・本文や名前は残さない）、`thth where-log <project> [--budget N --medium x]` で当たり率と翌日の配り直しを見ます。`--ja`・`--question`・`--no-replies` で表示を絞ります（X の `--ja` は検索に `lang:ja` を足して読む本数を減らす）（[リリースノート 3.18.0](docs/リリースノート_3.18.0_2026-10-12.md)）。
 - **X の非公開リスト**: `thth list create|add|remove|show`（3.17.0 から・X だけ）。公開のリストは作らない。足す・外すは人が選んだ少数だけ（1 回 10 人まで）。アカウントを認可し直してから（[リリースノート 3.17.0](docs/リリースノート_3.17.0_2026-10-12.md)）。
+- **X のコミュニティ**: `thth community search <account> <語…>` で探し、`thth send <account> --community <id>` か queue の front-matter `community_id:` で出す（3.19.0 から・X だけ）。参加は X の画面で先に（API に参加の口は無い）。返信とは同時に使えない。各コミュニティの規則は人が読んで守る（[リリースノート 3.19.0](docs/リリースノート_3.19.0_2026-10-13.md)）。
+- **X のトレンドと語ごとの投稿数**: `thth trends <account> [--woeid N] [--max N]`（既定は日本）と `thth counts <account> <語> [--granularity hour|day]`（直近 7 日）（3.19.0 から・X だけ・1 回の有償の読み取り・保存しない）。
 
 ## はじめ方
 
@@ -83,7 +85,7 @@ MCP の道具は CLI の写しで、同じ `thth` コマンドを呼ぶだけで
 
 `thth --help` で各コマンドの説明が出ます。
 
-動くもの（`thth --help` の全サブコマンド）: `lint`・`preview`・`approve`・`account`・`revoke`・`posts`・`replies`・`measured`・`threads`・`after`・`analytics-report`・`study-report`・`study`・`unanswered`・`handoff-report`・`observe`・`morning`・`serve-reports`・`worker`・`topics`・`forms`・`queue`・`schedule`・`throw`・`run`・`systemd`・`board`・`collect`・`pull`・`auth`・`refresh`・`maintain`・`send`・`doctor`・`app`・`token`・`ask`・`mentions`・`profile`・`thread`・`where`・`where-log`・`who`・`retract`・`repost`・`unrepost`・`like`・`unlike`・`list`・`inflight`・`location`・`notifications`・`report`・`plaza`・`map`・`admin`・`login`・`logout`。
+動くもの（`thth --help` の全サブコマンド）: `lint`・`preview`・`approve`・`account`・`revoke`・`posts`・`replies`・`measured`・`threads`・`after`・`analytics-report`・`study-report`・`study`・`unanswered`・`handoff-report`・`observe`・`morning`・`serve-reports`・`worker`・`topics`・`forms`・`queue`・`schedule`・`throw`・`run`・`systemd`・`board`・`collect`・`pull`・`auth`・`refresh`・`maintain`・`send`・`doctor`・`app`・`token`・`ask`・`mentions`・`profile`・`thread`・`where`・`where-log`・`who`・`retract`・`repost`・`unrepost`・`like`・`unlike`・`list`・`community`・`trends`・`counts`・`inflight`・`location`・`notifications`・`report`・`plaza`・`map`・`admin`・`login`・`logout`。
 
 ## 版と配布
 

{thth-3.18.2 → thth-3.19.0}/skills/thth/SKILL.md

@@ -62,6 +62,14 @@ THTH は CLI ツール。あなた（エージェント）が使う MCP の道
 
 `thth list create <account> <名前> [--description …] --by <名前>`・`thth list add|remove <account> <list_id> <id か @handle…> --by <名前>`・`thth list show <account> <list_id> [--limit N]`（MCP には無い）。X のアカウントならどれでも（今は asmon-kanto-x と kopicha-x）・**使う前に各アカウントで `thth auth <account> --by <名前>` を打ち直す**。**非公開リストだけ**（公開は作れない）。足すのは**人が選んだ少数だけ**——1 回 10 人まで、検索結果から機械的に足さない（X の決まりで bulk・無差別の追加は不可）。足された相手に X が通知するかは未確認。書き込みは production: true の口座だけ・費用は月の X 予算（作る 0.010・足す／外す 0.005 USD、@handle の id 引き 0.010）。`show` は `where` と同じ有償の読み取り（1 本 0.005・1 日 60 本に数える・既定 10 本・最大 25）で、本文は返すだけで保存しない。断り: `scope_missing`（`thth auth <account> --by <名前>` で認可し直す）・`too_many_members`・`unsupported_on_platform`（X 以外）。
 
+## X のコミュニティ（3.19.0）
+
+`thth community search <account> <語…> [--limit N] [--json]`（MCP には無い）で探し、`thth send <account> --community <id>` か queue の front-matter `community_id: <id>` で出す。X だけ・認可のやり直しは不要。探すのは有償の読み取り（1 件 0.005 USD・月の X 予算・1 日 60 本には数えない・既定 10 件・最大 25・保存しない）。`community_id` は digest／承認の指紋に入る。返信（reply_to・reply_to_file）と同時には使えない・連投には書けない。**参加は X の画面で先に**（API に参加の口も「参加しているか」の欄も無い）——参加していなければ X の断りが `x_unknown_refusal（…）` で残る。**各コミュニティの規則（宣伝の禁止など）は人が読んで守る**。所有者に頼まれたコミュニティへ、人が選んだ本文を 1 本ずつ出すだけ——検索の結果へ機械的に出さない・同じ本文を複数のコミュニティへ流さない（X の自動化の決まりで bulk・無差別は不可）。断り: `unsupported_on_platform`（X 以外）・`community_id_invalid`・lint の `invalid_publish_option`。
+
+## X のトレンドと語ごとの投稿数（3.19.0）
+
+`thth trends <account> [--woeid N] [--max N]`（既定は日本・20 件・1 回 0.010 USD）・`thth counts <account> <語> [--granularity hour|day]`（直近 7 日・1 回 0.005 USD）（MCP には無い）。X だけ・要求は 1 回・返すだけで保存しない・月の X 予算に入り 1 日 60 本には数えない。話題選びの材料に使う——トレンドの語へ機械的に投稿しない。いまのトークンで通るかは未確認（断りは X の文面が短く残る）。
+
 ## 何を拒むか
 
 - **手元の台帳を使う実行の、`--confirm` の無い本番。** digest の食い違う本番。承認後に本文が変わった下書き

{thth-3.18.2 → thth-3.19.0}/tests/test_v210_json_contract.py

@@ -58,7 +58,9 @@ COMMANDS = '''lint|preview|approve|account|revoke|posts|replies|measured|threads
      # 3.17.0: X の非公開リスト。
      'list create', 'list add', 'list remove', 'list show',
      # 3.18.0: where … --keep で残した数を読む口。
-     'where-log']
+     'where-log',
+     # 3.19.0: X のコミュニティを探す。
+     'community search', 'trends', 'counts']
 
 
 def test_json_table_covers_every_parser():

{thth-3.18.2 → thth-3.19.0}/tests/test_v214_x_adapter.py

@@ -223,6 +223,8 @@ def test_after_an_unknown_the_next_send_refuses_without_touching_the_provider(
 # ----- 403 の本文から静的な符丁（10/13 関東の返信の 403） --------------------
 
 @pytest.mark.parametrize('body,expected', [
+    (b'{"type":"https://api.twitter.com/2/problems/not-authorized-for-resource","title":"Authorization Error","detail":"You can only reply to or quote posts where you are mentioned or are the author."}',
+     'x_publish_http_403: x_reply_not_engaged'),
     (b'{"detail":"Reply to this conversation is not allowed because you have not been mentioned or otherwise engaged by the author of the post you are replying to.","title":"Forbidden","status":403}',
      'x_publish_http_403: x_reply_not_engaged'),
     (b'{"detail":"You are not permitted to perform this action.","title":"Forbidden","status":403}',

thth-3.19.0/tests/test_x_community.py

@@ -0,0 +1,398 @@
+"""3.19.0: X のコミュニティ（`thth community search`・`send --community`・front-matter `community_id:`）。
+
+**本物の api.x.com は叩かない**——`thth.adapters.x.request` を偽物に差し替えるか、loopback の偽の X
+（`tests/helpers/fake_x`）に向ける。確かめること:
+- search は `GET /2/communities/search` を 1 回・community.fields の 7 つ・下限 10 で押さえる・
+  別の台帳（Community: Read 0.005）で月の予算に入る・1 日の本数には数えない・保存しない。
+- X 以外は unsupported_on_platform・範囲外の --limit・予算が無いときは叩かない。
+- 投稿の本体に community_id・返信との同時指定は断る・形の違う id は断る。
+- send の digest と queue の承認の指紋に入る（値があるときだけ・無ければ今までと同じ）。
+- lint・select・bundle が X 以外・形違い・返信との同時指定を断る。
+- sent の記録に community_id が残る。断り（403）は publish_refusal の流儀で文面が残る。
+"""
+from __future__ import annotations
+
+import argparse
+import io
+import json
+import os
+import urllib.error
+
+import pytest
+
+from thth import accounts as accounts_mod
+from thth import approval
+from thth import budget_x as b
+from thth import community_cli
+from thth import lint as lint_mod
+from thth.adapters import base
+from thth.adapters import x as x_adapter
+from tests.test_v214_x_media import env, wire  # noqa: F401
+
+ACCOUNT = "kanto-x"
+TOKEN = "SYNTHETIC-X-TOKEN-0123456789"
+COMMUNITY = "1493446837214187523"
+
+
+def _account(tmp_path, factory, *, name=ACCOUNT, media="x"):
+    data = {"access_token": TOKEN, "user_id": "123", "username": "kanto",
+            "scopes": ["tweet.read", "tweet.write", "users.read", "offline.access"],
+            "scopes_source": "response"}
+    token = tmp_path / f"{name}.token"
+    token.write_text(json.dumps(data), encoding="utf-8")
+    os.chmod(token, 0o600)
+    factory(name, media=media, handle="kanto", project="kanto", token=str(token), production=True)
+    return name
+
+
+@pytest.fixture
+def x_account(tmp_path, isolated_account_factory):
+    _account(tmp_path, isolated_account_factory)
+    b.configure("15", by="operator")
+    return ACCOUNT
+
+
+@pytest.fixture
+def fake(monkeypatch):
+    state = {"calls": [], "routes": {}}
+
+    def request(adapter, method, path, *, query=None, json_body=None, **kwargs):
+        state["calls"].append({"method": method, "path": path, "query": dict(query or {}),
+                               "body": json_body})
+        answer = state["routes"].get((method, path))
+        if isinstance(answer, BaseException):
+            raise answer
+        if answer is None:
+            raise urllib.error.HTTPError(path, 404, "nf", {}, None)
+        return 200, answer
+    monkeypatch.setattr(x_adapter, "request", request)
+    return state
+
+
+def _communities(n, *, more=False):
+    data = [{"id": str(1493446837214187523 + i), "name": f"コーヒー部{i}",
+             "description": f"説明{i}\n二行目", "member_count": 1200 + i,
+             "join_policy": "Open", "access": "Public", "created_at": "2024-01-02T03:04:05.000Z"}
+            for i in range(n)]
+    out = {"data": data, "meta": {"result_count": n}}
+    if more:
+        out["meta"]["next_token"] = "t"
+    return out
+
+
+def run(capsys, *words, account=ACCOUNT, limit=None, as_json=True):
+    args = argparse.Namespace(account=account, words=list(words), limit=limit, json=as_json)
+    rc = community_cli.cmd_community_search(args)
+    out = capsys.readouterr()
+    payload = json.loads(out.out) if as_json and out.out.strip() else None
+    return rc, payload, out
+
+
+def community_rows():
+    return list(b.read_posts(b.COMMUNITIES)["reservations"].values())
+
+
+# ----- 探す ---------------------------------------------------------------------
+
+def test_search_calls_once_with_all_fields_and_charges_the_returned_count(x_account, fake, capsys):
+    fake["routes"][("GET", "/2/communities/search")] = _communities(3, more=True)
+    rc, payload, _ = run(capsys, "コーヒー", "豆", limit=5)
+    assert rc == 0
+    [call] = fake["calls"]
+    assert call["path"] == "/2/communities/search"
+    assert call["query"] == {"query": "コーヒー 豆", "max_results": 10,
+                             "community.fields": "access,created_at,description,id,join_policy,member_count,name"}
+    assert payload["n"] == 3 and payload["storage"] == "display_only"
+    row = payload["communities"][0]
+    assert row == {"community_id": "1493446837214187523", "name": "コーヒー部0",
+                   "description": "説明0 二行目", "member_count": 1200, "join_policy": "Open",
+                   "access": "Public", "created_at": "2024-01-02T03:04:05.000Z",
+                   "url": "https://x.com/i/communities/1493446837214187523"}
+    assert any("続きがあります" in line for line in payload["cannot_say"])
+    assert any("参加しているかは分かりません" in line for line in payload["cannot_say"])
+    # 別の台帳（Community: Read・押さえは下限 10・確定は返ってきた 3 件）。
+    [ledger] = community_rows()
+    assert ledger["state"] == "settled" and ledger["limit"] == 10 and ledger["count"] == 3
+    assert ledger["usd"] == "0.015"
+    cost = payload["x_read_cost"]
+    assert cost["communities"] == 3 and cost["usd_estimate"] == "0.015" and cost["requests"] == 1
+    assert cost["daily_read_cap"] == "not_counted"
+    report = b.report()
+    assert report["spent_estimate_usd"] == "0.015"
+    assert report["community_read"]["month"]["communities"] == 3
+    assert any("コミュニティの検索" in line for line in b.cost_lines(report))
+    # 1 日の本数（他人の投稿の読み取り）には数えない。
+    assert b.posts_status(ACCOUNT)["today"] == 0
+    # 保存しない（runs にも名前・語を書かない）。
+    root = accounts_mod.state_dir_for(ACCOUNT)
+    for folder, _dirs, files in os.walk(root):
+        for name in files:
+            with open(os.path.join(folder, name), encoding="utf-8", errors="ignore") as fh:
+                body = fh.read()
+            assert "コーヒー部0" not in body and "コーヒー 豆" not in body
+
+
+def test_search_human_output_names_the_send_route(x_account, fake, capsys):
+    fake["routes"][("GET", "/2/communities/search")] = _communities(1)
+    rc, _payload, out = run(capsys, "coffee", as_json=False)
+    assert rc == 0
+    assert "1493446837214187523" in out.out and "人数=1200" in out.out and "join_policy=Open" in out.out
+    assert "--community <id>" in out.out and "community_id:" in out.out
+    assert "1 日の本数には数えない" in out.out
+
+
+def test_search_zero_is_not_called_absence(x_account, fake, capsys):
+    fake["routes"][("GET", "/2/communities/search")] = {"meta": {"result_count": 0}}
+    rc, payload, _ = run(capsys, "nothing")
+    assert rc == 0 and payload["n"] == 0
+    assert any("区別できません" in line for line in payload["cannot_say"])
+    [ledger] = community_rows()
+    assert ledger["state"] == "settled" and ledger["count"] == 0
+
+
+def test_search_refuses_other_media(tmp_path, isolated_account_factory, fake, capsys):
+    _account(tmp_path, isolated_account_factory, name="kanto-threads", media="threads")
+    rc, payload, _ = run(capsys, "coffee", account="kanto-threads")
+    assert rc == 2 and payload["error"] == "unsupported_on_platform"
+    assert payload["cannot_say"] and fake["calls"] == []
+
+
+@pytest.mark.parametrize("limit", [0, 26])
+def test_search_limit_out_of_range_never_calls(x_account, fake, capsys, limit):
+    rc, payload, _ = run(capsys, "coffee", limit=limit)
+    assert rc == 2 and payload["error"] == "invalid_request" and fake["calls"] == []
+
+
+def test_search_limit_above_ten_reserves_that_many(x_account, fake, capsys):
+    fake["routes"][("GET", "/2/communities/search")] = _communities(2)
+    rc, _payload, _ = run(capsys, "coffee", limit=25)
+    assert rc == 0 and fake["calls"][0]["query"]["max_results"] == 25
+    assert community_rows()[0]["limit"] == 25
+
+
+def test_search_without_budget_never_calls(tmp_path, isolated_account_factory, fake, capsys):
+    _account(tmp_path, isolated_account_factory)
+    rc, payload, _ = run(capsys, "coffee")
+    assert rc == 1 and payload["error"] == "budget_exhausted" and fake["calls"] == []
+
+
+def test_search_refusal_keeps_a_short_reason_and_charges_nothing(x_account, fake, capsys):
+    body = b'{"title":"Forbidden","detail":"You are not permitted to access this feature.","status":403}'
+    fake["routes"][("GET", "/2/communities/search")] = urllib.error.HTTPError(
+        "u", 403, "Forbidden", {}, io.BytesIO(body))
+    rc, payload, _ = run(capsys, "coffee")
+    assert rc == 1 and payload["error"] == "upstream_refused"
+    assert "x_community_search_http_403: x_not_permitted" in payload["message"]
+    [ledger] = community_rows()
+    assert ledger["state"] == "settled" and ledger["count"] == 0 and ledger["usd"] == "0.000"
+
+
+def test_search_parser_is_registered():
+    from thth import cli
+    args = cli.build_parser().parse_args(["community", "search", ACCOUNT, "a", "b", "--limit", "3", "--json"])
+    assert args.func is community_cli.cmd_community_search and args.words == ["a", "b"] and args.limit == 3
+
+
+# ----- 出す: 投稿の本体 ----------------------------------------------------------
+
+def test_tweet_body_carries_the_community():
+    assert x_adapter.tweet_body(base.Post("本文", community_id=COMMUNITY)) == {
+        "text": "本文", "community_id": COMMUNITY}
+    assert "community_id" not in x_adapter.tweet_body(base.Post("本文"))
+
+
+def test_tweet_body_refuses_reply_with_community():
+    with pytest.raises(x_adapter.AdapterError):
+        x_adapter.tweet_body(base.Post("本文", reply_to="1900000000000000000", community_id=COMMUNITY))
+
+
+def test_adapter_publish_posts_into_the_community(env, wire):
+    result = env[1].publish(base.Post("コミュニティへ", community_id=COMMUNITY), dry_run=False)
+    assert result.post_id and result.failure == "none"
+    assert wire["tweets"] == [{"text": "コミュニティへ", "community_id": COMMUNITY}]
+
+
+@pytest.mark.parametrize("post", [
+    base.Post("x", community_id="12ab"),
+    base.Post("x", community_id=COMMUNITY, reply_to="1900000000000000000"),
+])
+def test_adapter_refuses_bad_community_before_any_request(env, wire, post):
+    result = env[1].publish(post, dry_run=False)
+    assert result.error == "x_community_id_invalid" and result.failure == "publish_vetoed"
+    assert wire["calls"] == []
+
+
+def test_a_community_refusal_keeps_the_short_x_text(env, wire, monkeypatch):
+    original = x_adapter.request
+    body = (b'{"type":"https://api.twitter.com/2/problems/not-authorized-for-resource",'
+            b'"title":"Forbidden","detail":"You are not a member of this community."}')
+
+    def request(adapter, method, path, **kwargs):
+        if path == "/2/tweets":
+            raise urllib.error.HTTPError(adapter.base_url + path, 403, "Forbidden", {}, io.BytesIO(body))
+        return original(adapter, method, path, **kwargs)
+    monkeypatch.setattr(x_adapter, "request", request)
+    result = env[1].publish(base.Post("本文", community_id=COMMUNITY), dry_run=False)
+    assert result.failure == "publish_definite"
+    assert result.error == ("x_publish_http_403: x_unknown_refusal（type=not-authorized-for-resource"
+                            " / title=Forbidden / detail=You are not a member of this community.）")
+
+
+# ----- 出す: thth send --community ----------------------------------------------
+
+def _send(env, monkeypatch, **kw):
+    from thth import core
+    monkeypatch.setattr(core, "_append_run", lambda *a, **k: None)
+    lines = []
+    result = core.send_once("alpha", log=lines.append,
+                            adapter_factory=lambda cfg, token: env[1], **kw)
+    return result, lines
+
+
+def test_send_digest_includes_the_community_only_when_given(env, wire, monkeypatch):
+    plain, _ = _send(env, monkeypatch, text="本文")
+    into, lines = _send(env, monkeypatch, text="本文", community_id=COMMUNITY)
+    assert plain.exit_code == into.exit_code == 0
+    assert plain.digest != into.digest
+    assert plain.digest == approval.compute_send_digest(text="本文", account="alpha", reply_to=None, topic=None)
+    assert any("コミュニティ: " + COMMUNITY in line for line in lines)
+    assert wire["calls"] == []
+
+
+def test_send_production_posts_into_the_community_and_records_it(env, wire, monkeypatch):
+    from thth import sent as sent_mod
+    dry, _ = _send(env, monkeypatch, text="本文", community_id=COMMUNITY)
+    result, _ = _send(env, monkeypatch, text="本文", community_id=COMMUNITY,
+                      production_flag=True, confirm=dry.digest)
+    assert result.exit_code == 0 and result.post_id
+    assert wire["tweets"] == [{"text": "本文", "community_id": COMMUNITY}]
+    record = json.load(open(sent_mod.path_for(accounts_mod.state_dir_for("alpha"), result.post_id),
+                            encoding="utf-8"))
+    assert record["community_id"] == COMMUNITY
+
+
+def test_send_confirm_without_community_does_not_post_into_it(env, wire, monkeypatch):
+    plain, _ = _send(env, monkeypatch, text="本文")
+    result, _ = _send(env, monkeypatch, text="本文", community_id=COMMUNITY,
+                      production_flag=True, confirm=plain.digest)
+    assert result.exit_code == 1 and wire["calls"] == []
+
+
+@pytest.mark.parametrize("kw,needle", [
+    ({"community_id": "12ab"}, "19 桁までの数字"),
+    ({"community_id": COMMUNITY, "reply_to": "1900000000000000000"}, "返信"),
+])
+def test_send_refuses_bad_community_even_on_dry_run(env, wire, monkeypatch, kw, needle):
+    result, lines = _send(env, monkeypatch, text="本文", **kw)
+    assert result.exit_code == 2 and result.error == "community_id_invalid" and result.digest is None
+    assert any(needle in line for line in lines) and wire["calls"] == []
+
+
+def test_send_refuses_community_on_other_media(env, wire, monkeypatch):
+    env[0]["media"] = "threads"
+    result, lines = _send(env, monkeypatch, text="本文", community_id=COMMUNITY)
+    assert result.exit_code == 2 and result.error == "community_id_invalid"
+    assert any("X だけ" in line for line in lines)
+
+
+def test_send_cli_flag_reaches_core(monkeypatch):
+    from thth import cli, core, read_coordination
+    seen = {}
+
+    def fake_send_once(account, **kw):
+        seen.update(kw)
+        return core.ThrowResult(exit_code=0, mode="rehearsal", action="skip", message="")
+    monkeypatch.setattr(core, "send_once", fake_send_once)
+    monkeypatch.setattr(read_coordination, "invoke", lambda args, name, fn=None: fn() if fn else args.func(args))
+    assert cli.main(["send", "alpha", "--text", "本文", "--community", COMMUNITY]) == 0
+    assert seen["community_id"] == COMMUNITY
+
+
+# ----- queue の front-matter（承認の指紋・lint・select・束） ----------------------
+
+def _sha(fm):
+    return approval.compute_approved_sha(
+        section="本文", account="alpha", reply_to=approval.reply_to_for_fingerprint(fm),
+        topic=None, publish_at="2026-10-14T08:00:00+09:00", **approval.publish_options(fm))
+
+
+def test_fingerprint_is_unchanged_without_community_and_changes_with_it():
+    from thth import fingerprint_golden
+    assert fingerprint_golden.drift() == []
+    assert _sha({}) == _sha({"community_id": ""})
+    assert _sha({}) != _sha({"community_id": COMMUNITY})
+    assert _sha({"community_id": COMMUNITY}) != _sha({"community_id": "1493446837214187524"})
+    parts = approval.compute_approved_components(
+        section="本文", account="alpha", reply_to=None, topic=None,
+        publish_at="2026-10-14T08:00:00+09:00", community_id=COMMUNITY)
+    assert parts["community_id"] == COMMUNITY and "community_id" in approval.COMPARED_KEYS
+
+
+@pytest.mark.parametrize("fm,cfg,expected", [
+    ({"community_id": COMMUNITY}, {"media": "x"}, []),
+    ({}, {"media": "threads"}, []),
+    ({"community_id": COMMUNITY}, {"media": "threads"}, ["X だけ"]),
+    ({"community_id": COMMUNITY}, None, ["X だけ"]),
+    ({"community_id": "abc"}, {"media": "x"}, ["19 桁までの数字"]),
+    ({"community_id": "12345678901234567890"}, {"media": "x"}, ["19 桁までの数字"]),
+    ({"community_id": COMMUNITY, "reply_to": "1900000000000000000"}, {"media": "x"}, ["返信"]),
+    ({"community_id": COMMUNITY, "reply_to_file": "q.md"}, {"media": "x"}, ["返信"]),
+])
+def test_lint_community_rules(fm, cfg, expected):
+    problems = lint_mod.community_id_errors(fm, cfg)
+    assert len(problems) == len(expected)
+    for problem, needle in zip(problems, expected):
+        assert problem.startswith("community_id: ") and needle in problem
+    if problems:
+        assert lint_mod.reason_code(problems) == "invalid_publish_option"
+        assert problems == [p for p in lint_mod.publish_option_errors(fm, cfg) if p.startswith("community_id")]
+
+
+def test_bundle_refuses_community():
+    from thth import bundle as bundle_mod
+    text = ("---\nthth: 2\naccount: alpha\npublish_at: 2026-10-14T08:00:00+09:00\n"
+            "continue_until: 2026-10-14T12:00:00+09:00\ncommunity_id: " + COMMUNITY + "\n---\n"
+            "## x\n一段目。\n\n---\n\n二段目。\n")
+    parsed = bundle_mod.parse_text(text, "b.md")
+    assert any(p.startswith("community_id: 連投") for p in bundle_mod.check(parsed, account_cfg={"media": "x"}))
+
+
+def _queue_file(isolated_account_factory, tmp_path, *, media, community, approve=True):
+    import datetime
+    from thth import jst, queuefile, select
+    info = isolated_account_factory("alpha", media=media, production=True)
+    queue = info["queue_dir"]
+    os.makedirs(queue, exist_ok=True)
+    publish_at = (jst.now_jst() - datetime.timedelta(minutes=5)).replace(microsecond=0).isoformat()
+    cfg = accounts_mod.load_account("alpha")
+    fm = {"community_id": community} if community else {}
+    section = "コミュニティへの本文"
+    sha = approval.compute_approved_sha(
+        section=approval.effective_section(section, cfg, None), account="alpha", reply_to=None,
+        topic=None, publish_at=publish_at, **approval.publish_options(fm))
+    lines = ["---", "thth: 1", "account: alpha", f"publish_at: {publish_at}"]
+    if community:
+        lines.append(f"community_id: {community}")
+    if approve:
+        lines += ["status: approved", f"approved_sha: {sha}"]
+    lines += ["---", f"## {media}", section, ""]
+    path = os.path.join(queue, "c.md")
+    with open(path, "w", encoding="utf-8") as fh:
+        fh.write("\n".join(lines))
+    return path, cfg, select, queuefile
+
+
+def test_select_rejects_community_on_a_non_x_account(isolated_account_factory, tmp_path):
+    path, cfg, select, queuefile = _queue_file(isolated_account_factory, tmp_path, media="threads",
+                                       community=COMMUNITY)
+    from thth import jst
+    result = select.select_one([queuefile.parse(path)], account_name="alpha", account_cfg=cfg, now=jst.now_jst(),
+                               last_post_at=None, recent_texts=set())
+    assert [r.reason for r in result.rejections if r.file == path] == ["community_id_invalid"]
+
+
+def test_lint_file_refuses_community_on_a_non_x_account(isolated_account_factory, tmp_path):
+    path, *_ = _queue_file(isolated_account_factory, tmp_path, media="threads",
+                           community=COMMUNITY, approve=False)
+    problems = [p for p in lint_mod.lint_file(path) if not lint_mod.is_warning(p)]
+    assert any(p.startswith("community_id: ") for p in problems)