thth 2.2.0__tar.gz → 2.3.0__tar.gz

{thth-2.2.0 → thth-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: thth
-Version: 2.2.0
+Version: 2.3.0
 Summary: 承認済みの投稿だけを投げる門（Threads・Bluesky・Mastodon）。人が承認し、記録は利用者の git に残る。
 Project-URL: Homepage, https://thth.me
 Project-URL: Source, https://github.com/aokings/thth
@@ -33,7 +33,7 @@ watchtower（`~/Developer/watchtower`）の隣に同じ流儀で並べる。watc
 
 ## 版
 
-**2.0.1**。門を無料で開ける版（2.0.1: 同席送信の採集・セキュリティ監査 2 回の直し）（`pip install`・`thth ask`・`thth share`・台帳を repo の外へ）。範囲と裁定は [docs/設計_v2_泉と門_2026-09-13.md](docs/設計_v2_泉と門_2026-09-13.md) §3・§7、その前の版は [docs/設計_v1.0.0_他人が導入できる版_2026-09-12.md](docs/設計_v1.0.0_他人が導入できる版_2026-09-12.md)、導入は [docs/導入_自分のMetaアプリで動かす.md](docs/導入_自分のMetaアプリで動かす.md)、文書の索引は [docs/README.md](docs/README.md)。
+**2.0.1**。門を無料で開ける版（2.0.1: 同席送信の採集・セキュリティ監査 2 回の直し）（`pip install`・`thth ask`・台帳を repo の外へ）。範囲と裁定は [docs/設計_v2_泉と門_2026-09-13.md](docs/設計_v2_泉と門_2026-09-13.md) §3・§7、その前の版は [docs/設計_v1.0.0_他人が導入できる版_2026-09-12.md](docs/設計_v1.0.0_他人が導入できる版_2026-09-12.md)、導入は [docs/導入_自分のMetaアプリで動かす.md](docs/導入_自分のMetaアプリで動かす.md)、文書の索引は [docs/README.md](docs/README.md)。
 
 `thth/VERSION` は `2.0.1`（版は `thth/VERSION` の 1 か所・`server.json` はテストで一致を強制）。`origin/release` は v2.0.0（`216af9f`）で、**v2.0.1 はまだ配っていない**（配布は masaru の一言）。出口条件の試験は（運用日誌 thth-notes: `記録/試験_LLMに選ばせる_2026-09-13.md`）。
 
@@ -45,7 +45,7 @@ watchtower（`~/Developer/watchtower`）の隣に同じ流儀で並べる。watc
 
 ## いまの状態（2026-09-13）
 
-版 **2.2.0**。全件テスト **2196 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。
+版 **2.3.0**。全件テスト **2274 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。
 
 **媒体**: Threads（稼働）・Bluesky・Mastodon（同席用の台帳あり・未稼働）。
 
@@ -74,16 +74,12 @@ timer（systemd・`thth systemd` で生成）で毎時投稿、返信の採集
   は `local`。泉のサーバはまだ無い）。原稿本文は渡さないし、答えにも出ない。
   **n が閾値（既定 20）に満たない群は中央値を返さず `cannot_say` に理由を出す**——
   手元の水ではほとんどが `cannot_say` になる。それが正しい答えで、rc は 0。MCP からは `before_you_post`。
-- **`thth share on|off|status|log|sync`**（設計 v2 §3・裁定 §7-3）。**既定 off**、設定が無い・壊れて
-  いるときも off。off のあいだは outbox が **0 バイト**。on にしても
-  `$THTH_ROOT/state/share/outbox/<YYYY-MM>.ndjson` に積むだけで、**送り先はまだ無い**（v2-5）。
-  積んだ全部は `thth share log` で読める。落ちるのは語・audience・型・件数・時刻帯・
-  post_id の**塩つき sha256**（塩は outbox に出ない）。本文・返信本文・返信者の username・
-  自分の判断・アカウント名・トークン・repo のパス・生の post_id は落ちない。
+- **読む口（`thth where`・`thth thread`・`thth who`）は何も保存しない**（裁定
+  2026-09-16「横断の泉はやめる」）。残るのは絡みの台帳（自分の行為と反応）だけ。
 - **英語の文書**: [README.en.md](README.en.md)・[docs/usage.en.md](docs/usage.en.md)・[llms.txt](llms.txt)。
 - **skill**: `skills/thth/SKILL.md`（wheel にも入る）。
 
-- **動くもの**（`thth --help` の全 27 サブコマンド）: `lint`・`preview`・`approve`・`account`・`revoke`・`posts`・`replies`・`measured`・`threads`・`topics`・`forms`・`queue`・`schedule`・`throw`・`run`・`systemd`・`share`・`board`・`collect`・`auth`・`refresh`・`maintain`・`send`・`doctor`・`app`・`token`・`ask`。
+- **動くもの**（`thth --help` の全 34 サブコマンド）: `lint`・`preview`・`approve`・`account`・`revoke`・`posts`・`replies`・`measured`・`threads`・`after`・`topics`・`forms`・`queue`・`schedule`・`throw`・`run`・`systemd`・`board`・`collect`・`auth`・`refresh`・`maintain`・`send`・`doctor`・`app`・`token`・`ask`・`mentions`・`profile`・`thread`・`where`・`who`・`retract`・`location`。
 - **最初の本番投稿の記録**: 2026-09-09、@aoking に疎通確認を 1 本（`17916074118445631`）。
 - **未着手**: X・Facebook ページ・Instagram の各アダプタ。トピック検索の権限（tester には降りない）。泉のサーバ（v2-5）。
 - **権限の制約**: tester に降りる scope は 5 つ。削除はできない。

{thth-2.2.0 → thth-2.3.0}/README.md

@@ -9,7 +9,7 @@ watchtower（`~/Developer/watchtower`）の隣に同じ流儀で並べる。watc
 
 ## 版
 
-**2.0.1**。門を無料で開ける版（2.0.1: 同席送信の採集・セキュリティ監査 2 回の直し）（`pip install`・`thth ask`・`thth share`・台帳を repo の外へ）。範囲と裁定は [docs/設計_v2_泉と門_2026-09-13.md](docs/設計_v2_泉と門_2026-09-13.md) §3・§7、その前の版は [docs/設計_v1.0.0_他人が導入できる版_2026-09-12.md](docs/設計_v1.0.0_他人が導入できる版_2026-09-12.md)、導入は [docs/導入_自分のMetaアプリで動かす.md](docs/導入_自分のMetaアプリで動かす.md)、文書の索引は [docs/README.md](docs/README.md)。
+**2.0.1**。門を無料で開ける版（2.0.1: 同席送信の採集・セキュリティ監査 2 回の直し）（`pip install`・`thth ask`・台帳を repo の外へ）。範囲と裁定は [docs/設計_v2_泉と門_2026-09-13.md](docs/設計_v2_泉と門_2026-09-13.md) §3・§7、その前の版は [docs/設計_v1.0.0_他人が導入できる版_2026-09-12.md](docs/設計_v1.0.0_他人が導入できる版_2026-09-12.md)、導入は [docs/導入_自分のMetaアプリで動かす.md](docs/導入_自分のMetaアプリで動かす.md)、文書の索引は [docs/README.md](docs/README.md)。
 
 `thth/VERSION` は `2.0.1`（版は `thth/VERSION` の 1 か所・`server.json` はテストで一致を強制）。`origin/release` は v2.0.0（`216af9f`）で、**v2.0.1 はまだ配っていない**（配布は masaru の一言）。出口条件の試験は（運用日誌 thth-notes: `記録/試験_LLMに選ばせる_2026-09-13.md`）。
 
@@ -21,7 +21,7 @@ watchtower（`~/Developer/watchtower`）の隣に同じ流儀で並べる。watc
 
 ## いまの状態（2026-09-13）
 
-版 **2.2.0**。全件テスト **2196 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。
+版 **2.3.0**。全件テスト **2274 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。
 
 **媒体**: Threads（稼働）・Bluesky・Mastodon（同席用の台帳あり・未稼働）。
 
@@ -50,16 +50,12 @@ timer（systemd・`thth systemd` で生成）で毎時投稿、返信の採集
   は `local`。泉のサーバはまだ無い）。原稿本文は渡さないし、答えにも出ない。
   **n が閾値（既定 20）に満たない群は中央値を返さず `cannot_say` に理由を出す**——
   手元の水ではほとんどが `cannot_say` になる。それが正しい答えで、rc は 0。MCP からは `before_you_post`。
-- **`thth share on|off|status|log|sync`**（設計 v2 §3・裁定 §7-3）。**既定 off**、設定が無い・壊れて
-  いるときも off。off のあいだは outbox が **0 バイト**。on にしても
-  `$THTH_ROOT/state/share/outbox/<YYYY-MM>.ndjson` に積むだけで、**送り先はまだ無い**（v2-5）。
-  積んだ全部は `thth share log` で読める。落ちるのは語・audience・型・件数・時刻帯・
-  post_id の**塩つき sha256**（塩は outbox に出ない）。本文・返信本文・返信者の username・
-  自分の判断・アカウント名・トークン・repo のパス・生の post_id は落ちない。
+- **読む口（`thth where`・`thth thread`・`thth who`）は何も保存しない**（裁定
+  2026-09-16「横断の泉はやめる」）。残るのは絡みの台帳（自分の行為と反応）だけ。
 - **英語の文書**: [README.en.md](README.en.md)・[docs/usage.en.md](docs/usage.en.md)・[llms.txt](llms.txt)。
 - **skill**: `skills/thth/SKILL.md`（wheel にも入る）。
 
-- **動くもの**（`thth --help` の全 27 サブコマンド）: `lint`・`preview`・`approve`・`account`・`revoke`・`posts`・`replies`・`measured`・`threads`・`topics`・`forms`・`queue`・`schedule`・`throw`・`run`・`systemd`・`share`・`board`・`collect`・`auth`・`refresh`・`maintain`・`send`・`doctor`・`app`・`token`・`ask`。
+- **動くもの**（`thth --help` の全 34 サブコマンド）: `lint`・`preview`・`approve`・`account`・`revoke`・`posts`・`replies`・`measured`・`threads`・`after`・`topics`・`forms`・`queue`・`schedule`・`throw`・`run`・`systemd`・`board`・`collect`・`auth`・`refresh`・`maintain`・`send`・`doctor`・`app`・`token`・`ask`・`mentions`・`profile`・`thread`・`where`・`who`・`retract`・`location`。
 - **最初の本番投稿の記録**: 2026-09-09、@aoking に疎通確認を 1 本（`17916074118445631`）。
 - **未着手**: X・Facebook ページ・Instagram の各アダプタ。トピック検索の権限（tester には降りない）。泉のサーバ（v2-5）。
 - **権限の制約**: tester に降りる scope は 5 つ。削除はできない。

{thth-2.2.0 → thth-2.3.0}/mcp/server.py

@@ -139,6 +139,118 @@ TOOLS = [
             "required": ["account", "topic"],
         },
     },
+    {
+        # **名前と説明文がそのまま売り文句**（設計「自分の泉」§2.2）。
+        # 実装が 1 語でも足したら設計書でなく実装を戻す（§2 の頭書きそのまま）。
+        "name": "after_you_posted",
+        # **設計「自分の泉」§2.2 の文言そのまま。**
+        "description": (
+            "出したあとに呼ぶ。この語・この型・この枝で、自分の投稿と返信が"
+            "どう受け取られたかを、件数と期間つきで返す"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "account": {"type": "string", "description": "account 名"},
+                "topic": {"type": "string", "description": "語（トピック）"},
+                "kind": {"type": "string", "description": "型（行動・年度付き 等）"},
+                "hour_band": {"type": "string",
+                               "description": "時刻帯（朝・昼・夕・深夜）で絞る"},
+                "reply_to": {"type": "string",
+                              "description": "この post_id への返信だけに絞る"},
+                "author_key": {"type": "string",
+                                "description": "この仮名（16 進 16 桁）への返信だけに絞る"},
+                "window_days": {"type": "integer", "description": "直近何日（既定 30）"},
+                "min_n": {"type": "integer",
+                           "description": "中央値を返す下限（既定 5）"},
+            },
+            "required": ["account"],
+        },
+    },
+    {
+        # **名前と説明文がそのまま売り文句**（設計「自分の泉」§2.1）。
+        # 実装が 1 語でも足したら設計書でなく実装を戻す（§2 の頭書きそのまま）。
+        "name": "thread_read",
+        # **設計「自分の泉」§2.1 の文言そのまま。**
+        "description": (
+            "返信を書く前に呼ぶ。この投稿の枝を、誰が・いつ・何を・誰に向けて"
+            "言ったかの順で返す。何も保存しない"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "account": {"type": "string", "description": "account 名"},
+                "post_id": {"type": "string", "description": "枝の根の post_id"},
+                "since": {"type": "string", "description": "この時刻以降だけ"},
+                "max_messages": {"type": "integer",
+                                   "description": "読む上限（既定 200・上限 1000）"},
+            },
+            "required": ["account", "post_id"],
+        },
+    },
+    {
+        # **名前と説明文がそのまま売り文句**（設計「自分の泉」§2.3）。
+        # 実装が 1 語でも足したら設計書でなく実装を戻す（§2 の頭書きそのまま）。
+        "name": "where_to_appear",
+        # **設計「自分の泉」§2.3 の文言そのまま。**
+        "description": (
+            "絡みに行く先を選ぶ前に呼ぶ。検索の一覧に、自分の履歴（この語・"
+            "この相手で何が起きたか）を重ねて返す。選ぶのは呼ぶ側"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "account": {"type": "string",
+                             "description": "account 名（project の代わり）"},
+                "project": {"type": "string",
+                             "description": "この project の account 全部"
+                                            "（account の代わり）"},
+                "words": {"type": "array", "items": {"type": "string"},
+                           "description": "検索の語（1〜5 個）"},
+                "recent": {"type": "boolean",
+                            "description": "TOP でなく RECENT（新しい順）で検索する"},
+                "limit": {"type": "integer",
+                           "description": "1 account・1 語あたりの上限（既定 25）"},
+            },
+            # **`account` か `project` のどちらか必須**（両方無ければ
+            # `validate_arguments()` が `-32602`）。`required` は AND
+            # （全部要る）の意味しか持てないので、ここには入れない——OR の
+            # 検査は `validate_arguments()` の `where_to_appear` 専用の分岐で行う。
+            "required": ["words"],
+        },
+    },
+    {
+        # **名前と説明文がそのまま売り文句**（設計「自分の泉」§2.4）。
+        # 実装が 1 語でも足したら設計書でなく実装を戻す（§2 の頭書きそのまま）。
+        "name": "who_is_this",
+        # **設計「自分の泉」§2.4 の文言そのまま。**
+        "description": (
+            "返信する相手を確かめる。この仮名と自分のアカウントの接触の"
+            "回数・時期・反応を返す。発言の内容は持たない"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "account": {"type": "string",
+                             "description": "account 名（project の代わり）"},
+                "project": {"type": "string",
+                             "description": "この project の account 全部"
+                                            "（account の代わり）"},
+                "author_key": {"type": "string",
+                                "description": "仮名（16 進 16 桁・username の代わり）"},
+                "username": {"type": "string",
+                              "description": "@ 無しでも可。その場で author_key に"
+                                             "写す（保存しない・author_key の代わり）"},
+                "profile": {"type": "boolean",
+                             "description": "その場で公開プロフィールを引く"
+                                            "（Threads だけ・保存しない・既定 false）"},
+            },
+            # **`account`/`project` と `author_key`/`username`、どちらも
+            # 「片方だけ必須」の OR**（`where_to_appear` と同じ理由で
+            # `required` には入れない——`validate_arguments()` の
+            # `who_is_this` 専用の分岐で見る）。
+        },
+    },
 ]
 
 
@@ -168,6 +280,10 @@ _TYPES = {
     "boolean": ((bool,), "真偽値"),
     "integer": ((int,), "整数"),
     "number": ((int, float), "数"),
+    # `where_to_appear` の `words`（T2-3）で初めて使う型。**配列だけを通す**
+    # ——足しておかないと `_TYPES.get(...)` の既定（`(object,)`）に落ちて、
+    # 文字列 1 個を渡しても素通りしてしまう。
+    "array": ((list,), "配列"),
 }
 
 
@@ -266,8 +382,35 @@ def validate_arguments(name: str, arguments) -> dict:
             raise ToolInputError(
                 f"{name}: {key} が `-` で始まっています（{value!r}）。"
                 f"CLI の旗と区別できないので受け取りません")
+        if (spec.get("type") == "array"
+                and (spec.get("items") or {}).get("type") == "string"):
+            # **`words` の各要素も同じ理由で縛る**（監査 2026-09-14・P3-2 と同じ筋・
+            # T2-3）。`call_tool()` は要素を argv にそのまま並べるので、ここで
+            # 文字列でないもの・`-` で始まるものを通すと `thth where` の別の旗と
+            # 区別できなくなる。
+            for item in value:
+                if not isinstance(item, str):
+                    raise ToolInputError(
+                        f"{name}: {key} の要素は文字列です"
+                        f"（受け取った: {type(item).__name__}）")
+                if item.startswith("-"):
+                    raise ToolInputError(
+                        f"{name}: {key} の要素が `-` で始まっています（{item!r}）。"
+                        f"CLI の旗と区別できないので受け取りません")
         if key == "file":
             check_file_argument(name, value)
+    if name in ("where_to_appear", "who_is_this") and not arguments.get("account") \
+            and not arguments.get("project"):
+        # **`account` か `project` のどちらか必須**（`required` は AND の意味しか
+        # 持てないので、ここで OR を見る・T2-3 発注書・T3-3 も同じ形）。
+        raise ToolInputError(
+            f"{name}: account か project のどちらかが要ります")
+    if name == "who_is_this" and not arguments.get("author_key") \
+            and not arguments.get("username"):
+        # **`author_key` か `username` のどちらか必須**（同じ理由で OR を
+        # ここで見る・T3-3 発注書）。
+        raise ToolInputError(
+            f"{name}: author_key か username のどちらかが要ります")
     return arguments
 
 
@@ -342,15 +485,86 @@ def call_tool(name: str, arguments: dict | None) -> dict:
         args.append("--json")
         proc = run_cli(args)
         text = proc.stdout
+    elif name == "after_you_posted":
+        # **`before_you_post` と同じ型**（発注 T0-2）: CLI を `--json` で呼ぶだけ。
+        args = ["after", arguments["account"]]
+        if arguments.get("topic"):
+            args += ["--topic", arguments["topic"]]
+        if arguments.get("kind"):
+            args += ["--kind", arguments["kind"]]
+        if arguments.get("hour_band"):
+            args += ["--hour-band", arguments["hour_band"]]
+        if arguments.get("reply_to"):
+            args += ["--reply-to", arguments["reply_to"]]
+        if arguments.get("author_key"):
+            args += ["--author-key", arguments["author_key"]]
+        if arguments.get("window_days") is not None:
+            args += ["--window-days", str(arguments["window_days"])]
+        if arguments.get("min_n") is not None:
+            args += ["--min-n", str(arguments["min_n"])]
+        args.append("--json")
+        proc = run_cli(args)
+        text = proc.stdout
+    elif name == "thread_read":
+        # **`after_you_posted` と同じ型**: CLI（`thth thread`）を `--json` で
+        # 呼ぶだけ（設計「自分の泉」§2.1・T1-3）。
+        args = ["thread", arguments["account"], arguments["post_id"]]
+        if arguments.get("since"):
+            args += ["--since", arguments["since"]]
+        if arguments.get("max_messages") is not None:
+            args += ["--max-messages", str(arguments["max_messages"])]
+        args.append("--json")
+        proc = run_cli(args)
+        text = proc.stdout
+    elif name == "where_to_appear":
+        # **`thread_read` と同じ型**: CLI（`thth where`）を `--json` で呼ぶ
+        # だけ（設計「自分の泉」§2.3・T2-3）。`account`／`project` のどちらか
+        # 必須は `validate_arguments()` が先に見ているので、ここでは
+        # `project` を優先するだけでよい。
+        args = ["where"]
+        if arguments.get("project"):
+            args += ["--project", arguments["project"]]
+        else:
+            args.append(arguments["account"])
+        args += list(arguments.get("words") or [])
+        if arguments.get("recent"):
+            args.append("--recent")
+        if arguments.get("limit") is not None:
+            args += ["--limit", str(arguments["limit"])]
+        args.append("--json")
+        proc = run_cli(args)
+        text = proc.stdout
+    elif name == "who_is_this":
+        # **`where_to_appear` と同じ型**: CLI（`thth who`）を `--json` で呼ぶ
+        # だけ（設計「自分の泉」§2.4・T3-3）。`account`／`project` と
+        # `author_key`／`username` のどちらかずつ必須は `validate_arguments()`
+        # が先に見ているので、ここでは組み立てるだけでよい。
+        args = ["who"]
+        if arguments.get("project"):
+            args += ["--project", arguments["project"]]
+        else:
+            args.append(arguments["account"])
+        if arguments.get("author_key"):
+            args.append(arguments["author_key"])
+        else:
+            args.append("@" + arguments["username"])
+        if arguments.get("profile"):
+            args.append("--profile")
+        args.append("--json")
+        proc = run_cli(args)
+        text = proc.stdout
     else:
         return {"content": [{"type": "text", "text": f"unknown tool: {name}"}], "isError": True}
 
-    if name.startswith("thth_topic_") or name == "before_you_post":
+    if name.startswith("thth_topic_") or name in (
+            "before_you_post", "after_you_posted", "thread_read", "where_to_appear",
+            "who_is_this"):
         # **新しい道具は exit 1 も isError**（設計 §7）。lint の exit 1（検査結果）
         # とは意味が違う——こちらは stale_context・不正な候補比較で、
         # **そのまま使ってはいけない**応答。既存の扱いは変えない。
-        # `before_you_post` も同じ（設計 v2 §1）: exit 1 は台帳が無い、2 は問いが
-        # 受け取れない。**`cannot_say` だらけの答えは exit 0 で、error ではない。**
+        # `before_you_post`／`after_you_posted` も同じ（設計 v2 §1・「自分の泉」§5）:
+        # exit 1 は台帳が無い、2 は問いが受け取れない。**`cannot_say` だらけの
+        # 答えは exit 0 で、error ではない。**
         is_error = proc.returncode != 0
     else:
         is_error = proc.returncode not in (0, 1)  # lint は 1 も正常な「検査結果」

thth-2.3.0/skills/thth/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: thth
+description: 投稿する前・返信を書く前・出したあと・絡みに行く先を選ぶときに呼ぶ道具。Threads・Bluesky・Mastodon への下書きを人の承認を通してから出し、枝を読み、相手を知り、伸びを測る。
+---
+
+# THTH — 投稿する前に呼ぶ道具
+
+## 何を保証するか
+
+- **人が承認していない本文は 1 文字も出ない。** 承認は 2 段（見せる → digest を渡す）。
+  digest が違えば拒否する。**「見せた本文」と「出す本文」が同じであることを機械が確かめる。**
+- **`--production` を付けるまで出ない。** 付けない実行は、投げるはずの本文と digest を
+  表示して終わる。
+- **記録は利用者の git に残る。** post_id・承認者・承認時刻・返信・実測は、あなたの repo の
+  commit として残る。THTH のサーバには何も無い。
+- **数値には分母が付く。** 件数・期間・揃えた条件が無い数字は返さない。取れていない刻みは
+  `null` であって `0` ではない。
+- **黙って間違えない。** 拒むときは理由と次の一手を言って非ゼロで終わる（loud reject）。
+
+## 何を拒むか
+
+- **`--confirm` の無い本番。** digest の食い違う本番。承認後に本文が変わった下書き
+  （`approval_stale`）。
+- **同期を確認していない commit の本文。** ディスクに置いただけのファイルは選ばれない。
+- **静かな時間帯・最短間隔に反する投稿。**
+- **語（トピック）の未確認。** 承認の一段目が「未確認です」と言う。
+
+## 何を絶対にしないか
+
+- **何を書くかを決めない。** 文体・頻度・時刻・語の選び方はあなたのプロジェクトのもの。
+  渡された本文を**整形も切り詰めもせず**そのまま出す。
+- **読む口は何も保存しない。** `thread_read`・`where_to_appear`・`who_is_this` はどれも、
+  読んで見せるだけで**台帳に 1 バイトも書かない**。残るのは**自分の行為と反応**
+  （絡みの台帳）だけで、**相手の本文・相手の名前・あなたの判断は台帳に入らない**。
+- **人の代わりに承認しない。** あなた（エージェント）は下書きと digest を人に見せ、
+  人が `--confirm` を打つ。
+
+---
+
+## 使う順番——場面で
+
+### 1. 探す——どこに絡みに行くか
+
+```bash
+thth where <account> <語…>          # 検索の一覧に自分の履歴を重ねて返す
+thth where --project <P> <語…>      # project 単位で全媒体を一度に
+```
+
+MCP `where_to_appear`。**順位は無い**——材料を並べるだけで、選ぶのは LLM。
+**残すもの: なし**（この口自身は何も書かない。材料は `after_you_posted` と
+絡みの台帳から来ている）。
+**呼ばなくてよいとき**: 返す先がもう決まっている・自分の投稿への返信。
+
+### 2. 読む——枝をその場で
+
+```bash
+thth thread <account> <post_id>
+```
+
+MCP `thread_read`。枝の会話を**生で**読み、誰がどんな立場かをその場で判断する。
+**`already_replied` を見落とさない**——もうこの枝に返しているかがここに乗る。
+**残すもの: なし**（読んで捨てる。runs には件数だけ）。
+**呼ばなくてよいとき**: 自分の根の枝は `thth threads` の形で足りるとき。
+
+### 3. 相手を知る——この仮名と何度
+
+```bash
+thth who <account> <author_key>
+```
+
+MCP `who_is_this`。この仮名と自分のアカウントが何度・いつ・どんな反応だったか
+だけを返す。**人物像ではない**——発言の内容は持たない。
+**残すもの: なし**（絡みの台帳・返信の台帳から導くだけで、この口自体は書かない）。
+
+### 4. 書く——下書きに宛先を乗せる
+
+下書きの front-matter に:
+
+```yaml
+reply_to: <post_id>
+reply_to_author_key: <一覧の --json の author_key をそのまま写す>
+found_by: where_to_appear|manual|mention
+```
+
+**残すもの**: この 3 つの欄（下書きファイルそのもの。承認まではあなたの repo の
+untracked/コミット前のファイル）。語を選ぶときだけ `before_you_post`
+（原稿本文は渡さない・件数と期間つきで返す）。
+
+### 5. 承認——二段（そのまま）
+
+```bash
+thth lint <ファイル…>          # front-matter と字数の検査
+thth preview <ファイル>        # 実際に投げる本文そのもの
+thth approve <ファイル or ディレクトリ>                       # 一段目: 本文と digest を見せる
+thth approve <同じ> --confirm <digest> --by "<承認した人>"     # 二段目: 承認して commit
+```
+
+**一段目は非ゼロで終わる。** それは失敗ではなく「まだ承認していない」。
+**`--by` に人の名前を書く。** 承認したのは人であって、あなたではない。
+**残すもの**: post_id・承認者・承認時刻（あなたの repo の commit）。
+
+### 6. 測る——出したあとの反応
+
+```bash
+thth after <account> [--reply-to <post_id>] [--topic …]
+```
+
+MCP `after_you_posted`。**24h の刻みが無ければ `null`**（0 と混ぜない・
+`covered: false` を付ける）。`one_thing_to_change` は 1 個か `null`。
+**残すもの: なし**（この口は読むだけ。絡みの台帳は**公開の瞬間**に 1 行書かれる——
+自分の行為と反応だけで、相手の本文・名前・自分の判断は入らない）。
+**媒体をまたぐ数は無い**——project 単位で並べるだけで、足さない・割らない・
+順位も付けない。
+
+---
+
+## 詰まったら
+
+- `thth --help` / `thth <subcommand> --help` が正本。
+- `thth doctor <account>` が「いま投稿できる状態か」を最初から最後まで言う。
+- 使い方の全文: `docs/使い方_プロジェクトのセッション向け_2026-09-09.md`。

{thth-2.2.0 → thth-2.3.0}/tests/test_adapter_boundary.py

@@ -95,9 +95,12 @@ def test_TB0_capabilitiesは実体を作らずに引ける():
     # `keyword_search`・`mentions`・`profile_lookup`・`inbox` は v2.1-A（設計 v2
     # §4.3・2026-09-14）で足した語。Threads の 11 権限を使う読み取りの口 3 つと、
     # 言及を `inbox` に流す配管（v2-3 の芽がそのまま受け皿）。
+    # `thread_read` は設計「自分の泉」T1-1（2026-09-16）で足した語。
+    # `fetch_post()` が根を 1 件引ける（3 媒体とも持つ）。
     assert threads_mod.ThreadsAdapter.capabilities() == {
         "topic", "link_preview", "views", "quota", "refresh", "recent_posts",
-        "account_insights", "keyword_search", "mentions", "profile_lookup", "inbox"}
+        "account_insights", "keyword_search", "mentions", "profile_lookup", "inbox",
+        "thread_read"}
 
 
 def test_F3_metrics_ofは新しい形だけを受ける():