thth 2.0.0__tar.gz

thth-2.0.0/.gitignore

@@ -0,0 +1,11 @@
+.DS_Store
+__pycache__/
+*.pyc
+.venv/
+logs/
+state/
+.pytest_cache/
+dist/
+.claude/worktrees/
+callback/.wrangler/
+callback/node_modules/

thth-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 gotoq
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

thth-2.0.0/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.5
+Name: thth
+Version: 2.0.0
+Summary: 承認済みの投稿だけを投げる門（Threads・Bluesky・Mastodon）。人が承認し、記録は利用者の git に残る。
+Project-URL: Homepage, https://thth.me
+Project-URL: Source, https://github.com/aokings/thth
+Author: Masaru Aoki
+License: MIT
+License-File: LICENSE
+Keywords: approval,bluesky,cli,mastodon,mcp,social,threads
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Communications
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Provides-Extra: dev
+Requires-Dist: pytest-xdist>=3; extra == 'dev'
+Requires-Dist: pytest>=7; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# THTH（ThreadsThrower・承認済み投稿の投げ手）
+
+設計: [docs/設計_THTH_2026-09-08.md](docs/設計_THTH_2026-09-08.md)（§8 の裁定済み。現行の設計書）。
+
+承認済み（`status: approved`）の投稿ファイルを読み、静かな時間帯と最短間隔を守って 1 件だけ投げ、
+post_id を書き戻して push し、投稿済みの返信を拾って追記し、走った記録と鮮度を出し、
+走らなかったことを外部に知らせるまでを持つ。意味（何を書くか・承認・返信の解釈・採集箱への昇格）は持たない。
+watchtower（`~/Developer/watchtower`）の隣に同じ流儀で並べる。watchtower は POST しないので投稿は混ぜない。
+
+## 版
+
+**2.0.0**。門を無料で開ける版（`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)。
+
+`thth/VERSION` は `2.0.0`（版は `thth/VERSION` の 1 か所・`server.json` はテストで一致を強制）。`origin/release` は v1.3.0（`0bd8208`）のままで、**v2.0.0 はまだ配っていない**（配布は masaru の一言）。出口条件の試験は（運用日誌 thth-notes: `記録/試験_LLMに選ばせる_2026-09-13.md`）。
+
+**`main` への push は保存だけ。`release` を進める操作が配布**（VM は `release` だけを追う。設計 §3.2.1）。
+
+## 使う人へ
+
+各プロジェクトのセッションが読むのは [docs/使い方_プロジェクトのセッション向け_2026-09-09.md](docs/使い方_プロジェクトのセッション向け_2026-09-09.md) **だけ**。設計書は作った側の記録なので読まなくてよい。
+
+## いまの状態（2026-09-13）
+
+版 **2.0.0**。全件テスト **1828 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。
+
+**媒体**: Threads（稼働）・Bluesky・Mastodon（同席用の台帳あり・未稼働）。
+
+**本番稼働中**: Threads の 4 アカウント（nigamilab・asmon 関東・kopicha・masaru の同席用）。
+timer（systemd・`thth systemd` で生成）で毎時投稿、返信の採集（`thth replies`）と数の採集
+（`thth measured`）は稼働、トークン更新は `thth maintain` が毎日。
+
+**入口は 4 つ**: 厚い CLI（`bin/thth`・`python -m thth`）、薄い MCP（`mcp/server.py`・読み取りと
+同席の投稿・`before_you_post`）、timer、そして `pip install`（`thth`・`thth-mcp` の entry point・
+**依存 0**。ただし **PyPI への登録と upload は masaru の手で、まだしていない**）。
+
+**トピックの棚**（`thth topics`）: 観測者ごとに並ぶ・打ち消し `retract-note`・`history`。
+
+### v2.0.0 で増えた口
+
+- **台帳を repo の外へ**（設計 v2 §3・裁定 §7-1）。正は `$THTH_ROOT/accounts/`（`$THTH_ACCOUNTS_DIR` があればそちら）。
+  repo の `accounts/` は**1 版だけ互換で読む**（stderr に警告 1 行・VM を止めないため）。
+  `thth account migrate` が repo の中を外へ **copy**（移動しない・上書きしない・冪等）、
+  `thth account add <name> --media threads|bluesky|mastodon --project <p>` が
+  `accounts.example/<media>.json` の雛形から 1 本書く（**必ず `production: false`**）。
+  **書く先は互換に落ちていても常に外**。`doctor`・`board` が置き場を 1 行で言う。
+- **`thth ask before-you-post <account> --topic <語>`**（設計 v2 §1）。この語・この型・この時刻帯で
+  スレッドがどう伸びたかを、件数と期間つきで返す。**読むだけ・手元の台帳だけ**（`provenance.source`
+  は `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 は落ちない。
+- **英語の文書**: [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`。
+- **最初の本番投稿の記録**: 2026-09-09、@aoking に疎通確認を 1 本（`17916074118445631`）。
+- **未着手**: X・Facebook ページ・Instagram の各アダプタ。トピック検索の権限（tester には降りない）。泉のサーバ（v2-5）。
+- **権限の制約**: tester に降りる scope は 5 つ。削除はできない。
+- **masaru の手が要るもの**: PyPI の登録と upload、repo を public にする切替と `LICENSE`、MCP registry への登録、tag と `release` を進める操作。
+
+## MCP registry
+
+registry は「この PyPI の名前を名乗ってよいのは誰か」を、**配布物の README にこの 1 行があるか**で確かめる（設計 v2-4 §3・一次資料は quickstart・**L2**）。だから消さないこと——消すと登録（`mcp-publisher publish`）が通らなくなる。形（`server.json` と版の一致）は `tests/test_server_json.py` が見張る。
+
+mcp-name: io.github.aokings/thth
+

thth-2.0.0/README.md

@@ -0,0 +1,71 @@
+# THTH（ThreadsThrower・承認済み投稿の投げ手）
+
+設計: [docs/設計_THTH_2026-09-08.md](docs/設計_THTH_2026-09-08.md)（§8 の裁定済み。現行の設計書）。
+
+承認済み（`status: approved`）の投稿ファイルを読み、静かな時間帯と最短間隔を守って 1 件だけ投げ、
+post_id を書き戻して push し、投稿済みの返信を拾って追記し、走った記録と鮮度を出し、
+走らなかったことを外部に知らせるまでを持つ。意味（何を書くか・承認・返信の解釈・採集箱への昇格）は持たない。
+watchtower（`~/Developer/watchtower`）の隣に同じ流儀で並べる。watchtower は POST しないので投稿は混ぜない。
+
+## 版
+
+**2.0.0**。門を無料で開ける版（`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)。
+
+`thth/VERSION` は `2.0.0`（版は `thth/VERSION` の 1 か所・`server.json` はテストで一致を強制）。`origin/release` は v1.3.0（`0bd8208`）のままで、**v2.0.0 はまだ配っていない**（配布は masaru の一言）。出口条件の試験は（運用日誌 thth-notes: `記録/試験_LLMに選ばせる_2026-09-13.md`）。
+
+**`main` への push は保存だけ。`release` を進める操作が配布**（VM は `release` だけを追う。設計 §3.2.1）。
+
+## 使う人へ
+
+各プロジェクトのセッションが読むのは [docs/使い方_プロジェクトのセッション向け_2026-09-09.md](docs/使い方_プロジェクトのセッション向け_2026-09-09.md) **だけ**。設計書は作った側の記録なので読まなくてよい。
+
+## いまの状態（2026-09-13）
+
+版 **2.0.0**。全件テスト **1828 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。
+
+**媒体**: Threads（稼働）・Bluesky・Mastodon（同席用の台帳あり・未稼働）。
+
+**本番稼働中**: Threads の 4 アカウント（nigamilab・asmon 関東・kopicha・masaru の同席用）。
+timer（systemd・`thth systemd` で生成）で毎時投稿、返信の採集（`thth replies`）と数の採集
+（`thth measured`）は稼働、トークン更新は `thth maintain` が毎日。
+
+**入口は 4 つ**: 厚い CLI（`bin/thth`・`python -m thth`）、薄い MCP（`mcp/server.py`・読み取りと
+同席の投稿・`before_you_post`）、timer、そして `pip install`（`thth`・`thth-mcp` の entry point・
+**依存 0**。ただし **PyPI への登録と upload は masaru の手で、まだしていない**）。
+
+**トピックの棚**（`thth topics`）: 観測者ごとに並ぶ・打ち消し `retract-note`・`history`。
+
+### v2.0.0 で増えた口
+
+- **台帳を repo の外へ**（設計 v2 §3・裁定 §7-1）。正は `$THTH_ROOT/accounts/`（`$THTH_ACCOUNTS_DIR` があればそちら）。
+  repo の `accounts/` は**1 版だけ互換で読む**（stderr に警告 1 行・VM を止めないため）。
+  `thth account migrate` が repo の中を外へ **copy**（移動しない・上書きしない・冪等）、
+  `thth account add <name> --media threads|bluesky|mastodon --project <p>` が
+  `accounts.example/<media>.json` の雛形から 1 本書く（**必ず `production: false`**）。
+  **書く先は互換に落ちていても常に外**。`doctor`・`board` が置き場を 1 行で言う。
+- **`thth ask before-you-post <account> --topic <語>`**（設計 v2 §1）。この語・この型・この時刻帯で
+  スレッドがどう伸びたかを、件数と期間つきで返す。**読むだけ・手元の台帳だけ**（`provenance.source`
+  は `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 は落ちない。
+- **英語の文書**: [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`。
+- **最初の本番投稿の記録**: 2026-09-09、@aoking に疎通確認を 1 本（`17916074118445631`）。
+- **未着手**: X・Facebook ページ・Instagram の各アダプタ。トピック検索の権限（tester には降りない）。泉のサーバ（v2-5）。
+- **権限の制約**: tester に降りる scope は 5 つ。削除はできない。
+- **masaru の手が要るもの**: PyPI の登録と upload、repo を public にする切替と `LICENSE`、MCP registry への登録、tag と `release` を進める操作。
+
+## MCP registry
+
+registry は「この PyPI の名前を名乗ってよいのは誰か」を、**配布物の README にこの 1 行があるか**で確かめる（設計 v2-4 §3・一次資料は quickstart・**L2**）。だから消さないこと——消すと登録（`mcp-publisher publish`）が通らなくなる。形（`server.json` と版の一致）は `tests/test_server_json.py` が見張る。
+
+mcp-name: io.github.aokings/thth
+

thth-2.0.0/accounts.example/bluesky.json

@@ -0,0 +1,25 @@
+{
+  "account": "demo-bluesky",
+  "project": "demo",
+  "media": "bluesky",
+  "handle": "demo.bsky.social",
+  "service": "https://bsky.social",
+  "user_id": "",
+  "repo_dir": "$THTH_ROOT/repos/demo",
+  "queue_dir": "docs/sns/queue",
+  "replies_dir": "data/sns/replies",
+  "quiet_hours": ["22:00", "07:00"],
+  "min_interval_hours": 6,
+  "max_per_run": 1,
+  "tick_minutes": 10,
+  "collect_days": 14,
+  "hashtags": false,
+  "stale_days": 7,
+  "env": "~/.config/thth/demo-bluesky.env",
+  "token": "~/.config/thth/demo-bluesky.token",
+  "ping": "wrapper",
+  "timeout": 300,
+  "dry_run_env": "THTH_DRY_RUN",
+  "production": false,
+  "scheduled": false
+}

thth-2.0.0/accounts.example/mastodon.json

@@ -0,0 +1,25 @@
+{
+  "account": "demo-mastodon",
+  "project": "demo",
+  "media": "mastodon",
+  "handle": "demo",
+  "instance": "https://mastodon.example",
+  "user_id": "",
+  "repo_dir": "$THTH_ROOT/repos/demo",
+  "queue_dir": "docs/sns/queue",
+  "replies_dir": "data/sns/replies",
+  "quiet_hours": ["22:00", "07:00"],
+  "min_interval_hours": 6,
+  "max_per_run": 1,
+  "tick_minutes": 10,
+  "collect_days": 14,
+  "hashtags": false,
+  "stale_days": 7,
+  "env": "~/.config/thth/demo-mastodon.env",
+  "token": "~/.config/thth/demo-mastodon.token",
+  "ping": "wrapper",
+  "timeout": 300,
+  "dry_run_env": "THTH_DRY_RUN",
+  "production": false,
+  "scheduled": false
+}

thth-2.0.0/accounts.example/threads.json

@@ -0,0 +1,25 @@
+{
+  "account": "demo-threads",
+  "project": "demo",
+  "media": "threads",
+  "handle": "demo",
+  "user_id": "",
+  "redirect_uri": "https://example.invalid/",
+  "repo_dir": "$THTH_ROOT/repos/demo",
+  "queue_dir": "docs/sns/queue",
+  "replies_dir": "data/sns/replies",
+  "quiet_hours": ["22:00", "07:00"],
+  "min_interval_hours": 6,
+  "max_per_run": 1,
+  "tick_minutes": 10,
+  "collect_days": 14,
+  "hashtags": false,
+  "stale_days": 7,
+  "env": "~/.config/thth/demo-threads.env",
+  "token": "~/.config/thth/demo-threads.token",
+  "ping": "wrapper",
+  "timeout": 300,
+  "dry_run_env": "THTH_DRY_RUN",
+  "production": false,
+  "scheduled": false
+}

thth-2.0.0/bin/thth

@@ -0,0 +1,15 @@
+#!/usr/bin/env python3
+"""thth CLI の唯一の入口（発注 §2）。argparse でサブコマンドに振り分けるだけで、
+判断は `thth.cli`・`thth.core` 等に置く。"""
+import os
+import sys
+
+# realpath を通す: PATH に置くために symlink を張る（例 ~/.local/bin/thth →
+# /srv/thth/app/bin/thth）と、abspath では symlink 自身の場所を指してしまい
+# repo の親が見つからない（2026-09-09 VM 設置で実際に踏んだ）。
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.realpath(__file__))))
+
+from thth.cli import main  # noqa: E402
+
+if __name__ == "__main__":
+    sys.exit(main(sys.argv[1:]))

thth-2.0.0/bin/thth-remote

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+# 手元（Mac）から VM の `thth` を呼ぶ薄いラッパ（masaru 指摘 2026-09-10）。
+#
+# **なぜ要るか。** 各プロジェクトのセッションは `ssh wt 'PATH=...; thth ...'` と
+# 打っていた。安全で特定の作業をするために、いちばん鈍器な道具（生の ssh）を
+# 持たせていたことになる。実際、権限判定に何度も弾かれ、ループの形では止められた。
+# **道具を特定にすれば、許可も特定にできる**（`Bash(thth:*)` の 1 行で済む）。
+#
+# 引数はそのまま VM の `thth` に渡す。手元のシェルに展開させない
+# （VM 側のパスは手元に存在しないので、glob は使わずディレクトリを渡すこと）。
+# 秘密を対話で入れるもの（`token set`・`auth`）だけ tty を割り当てる——tty が
+# 無いと getpass がエコーを止められず、**手元の画面にトークンが出る**。
+set -euo pipefail
+
+HOST="${THTH_SSH_HOST:-wt}"
+REMOTE='PATH="$HOME/.local/bin:$PATH"; exec thth'
+for arg in "$@"; do
+  REMOTE+=" $(printf '%q' "$arg")"
+done
+
+# `set -u` の下で空配列を展開すると古い bash（macOS 既定の 3.2）で落ちるので、
+# 文字列で持つ（引数は 1 つだけなので分割の心配が無い）。
+TTY_FLAG=""
+case "${1:-} ${2:-}" in
+  "token set"|"auth "*) TTY_FLAG="-t" ;;
+esac
+
+if [ -n "$TTY_FLAG" ]; then
+  exec ssh -t "$HOST" "$REMOTE"
+fi
+exec ssh "$HOST" "$REMOTE"

thth-2.0.0/bin/thth-run

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+# systemd timer から呼ばれる薄いラッパ（発注 §2）。`thth run <account>` を呼ぶだけ。
+# flock・inflight の確認は core 側（thth/lock.py・thth/core.py）に置いてあるので、
+# ここには置かない（§3.7: 入口を増やしてもロックを踏まない経路を作らないため）。
+set -euo pipefail
+DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+exec "$DIR/thth" run "$@"

thth-2.0.0/mcp/server.py

@@ -0,0 +1,280 @@
+#!/usr/bin/env python3
+"""薄い MCP（stdio）。発注 §4・設計 §3.7。
+
+中身は CLI（`bin/thth`）を subprocess で呼んで `--json` の出力を返すだけ。
+判断・整形・条件分岐はここに書かない（MCP に業務論理を持たせない・§3.7）。
+
+T1 で出すのは読み取り 4 本だけ: thth_lint・thth_queue・thth_preview・thth_board。
+thth_throw・thth_approve・thth_auth・thth_refresh は T1 では作らない（§4）。
+
+MCP の stdio トランスポートは改行区切りの JSON-RPC 2.0（1 メッセージ 1 行、
+埋め込み改行なし）。追加の依存を持ち込まないため（標準ライブラリのみ・発注 §0-4）
+最小限のループを自前で書く。
+"""
+from __future__ import annotations
+
+import json
+import os
+import subprocess
+import sys
+
+APP_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+
+# **CLI の在り処は 2 通りある**（設計 v2 §3・`pip install thth`）。
+#
+#   - repo をそのまま使う運用: このファイルの 1 つ上に `bin/thth` がある（従来）。
+#   - `pip install thth`: wheel の中では**このファイル自身が `thth/mcp_server.py`**
+#     として入る（`pyproject.toml` の force-include）。隣に `bin/` は無い。
+#
+# **無いものを指したまま subprocess を起こさない。** `bin/thth` が実在するときだけ
+# それを使い、無ければ `python -m thth` に落とす（`thth/__main__.py`・同じ `main()`）。
+# `THTH_BIN` は従来どおり環境変数で上書きできる（テストはこの属性を差し替える）。
+_REPO_BIN = os.path.join(APP_DIR, "bin", "thth")
+THTH_BIN = os.environ.get("THTH_BIN") or (_REPO_BIN if os.path.exists(_REPO_BIN) else None)
+
+TOOLS = [
+    {
+        "name": "thth_lint",
+        "description": "docs/sns/queue の 1 ファイルを形式検査する（読むだけ・副作用なし）。",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"file": {"type": "string", "description": "queue ファイルのパス"}},
+            "required": ["file"],
+        },
+    },
+    {
+        "name": "thth_queue",
+        "description": "draft/approved/posted/型外 の一覧と、次に出るもの・いつかを返す（読むだけ）。",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"account": {"type": "string", "description": "省略時は全アカウント"}},
+        },
+    },
+    {
+        "name": "thth_preview",
+        "description": "実際に投げる本文そのもの（媒体の節。前後に何も足さない）を返す（読むだけ）。",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"file": {"type": "string", "description": "queue ファイルのパス"}},
+            "required": ["file"],
+        },
+    },
+    {
+        "name": "thth_topic_context",
+        "description": (
+            "原稿のトピックを決める前に**最初に**呼ぶ。原稿と（あれば）記事本文から、"
+            "判断の入力を固定して返す。記事がまだ無ければ、取りに行くべき URL と"
+            "必要な JSON の形を返す（読むだけ・副作用なし）。"
+            "使う順序: context → 足りない資料を取る → evaluate。"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "file": {"type": "string", "description": "queue ファイルのパス"},
+                "article": {"type": "object", "description": "記事証拠（ArticleEvidence）"},
+                "article_url": {"type": "string",
+                                 "description": "本文に URL が複数ある場合の主対象"},
+            },
+            "required": ["file"],
+        },
+    },
+    {
+        "name": "thth_topic_evaluate",
+        "description": (
+            "記事本文と候補比較を渡して、**引用が本文に在るか・参照が実在するか・"
+            "観測が新しいか・投稿者が偏っていないか**を検査させる。"
+            "THTH は候補を作らないし順位も付けない——足りないものを言うだけ。"
+            "候補が suitable でなければ別の候補に繰り上げず、比較し直しを求める。"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "file": {"type": "string"},
+                "article": {"type": "object"},
+                "proposal": {"type": "object", "description": "候補比較（TopicProposal）"},
+                "article_url": {"type": "string"},
+            },
+            "required": ["file", "article", "proposal"],
+        },
+    },
+    {
+        "name": "thth_topic_decision",
+        "description": "保存済みの判断を読む（読むだけ）。今の原稿と食い違っていれば freshness で言う。",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"id": {"type": "string", "description": "decision_id"}},
+            "required": ["id"],
+        },
+    },
+    {
+        "name": "thth_board",
+        "description": "アカウントごとの最終投稿・approved 待ち・inflight・型外の骨を返す（読むだけ）。",
+        "inputSchema": {"type": "object", "properties": {}},
+    },
+    {
+        # **名前と説明文がそのまま売り文句**（設計 v2 §1 規約 6）。LLM は説明文で
+        # 呼ぶかを決めるので、**この文言は設計 v2 §1 の正本から動かさない。**
+        "name": "before_you_post",
+        # **設計 v2 §1 規約 6 の文言そのまま。** 実装が 1 語でも足すと、
+        # 「正本はどっちだ」が始まる（監査 2・B7 で「。言えないことは
+        # cannot_say に出る」を足していたのを外した）。**設計書ではなく
+        # 実装を戻す。**
+        "description": (
+            "投稿する前に呼ぶ。この語とこの型で、スレッドがどう伸びたかの実績を、"
+            "件数と期間つきで返す"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "account": {"type": "string", "description": "account 名"},
+                "topic": {"type": "string", "description": "語（トピック）"},
+                "kind": {"type": "string", "description": "型（行動・年度付き 等）"},
+                "hour_band": {"type": "string",
+                               "description": "出す予定の時刻帯（朝・昼・夕・深夜）"},
+                "is_reply": {"type": "boolean", "description": "返信として出すか"},
+                "window_days": {"type": "integer", "description": "直近何日（既定 30）"},
+                "min_n": {"type": "integer",
+                           "description": "中央値を返す下限（既定 20）"},
+            },
+            "required": ["account", "topic"],
+        },
+    },
+]
+
+
+def cli_argv(args: list) -> list:
+    """CLI を起こす argv。`THTH_BIN` があればそれ、無ければ `python -m thth`。"""
+    head = [sys.executable, THTH_BIN] if THTH_BIN else [sys.executable, "-m", "thth"]
+    return [*head, *args]
+
+
+def run_cli(args: list, *, stdin_text: str | None = None) -> subprocess.CompletedProcess:
+    return subprocess.run(cli_argv(args), capture_output=True,
+                           text=True, input=stdin_text)
+
+
+def _topic_stdin(arguments: dict, *, with_proposal: bool) -> tuple:
+    """記事・候補比較は**標準入力に 1 つの JSON** で渡す（設計 §7）。
+
+    外部モデルが指定した任意のサーバファイルへ書いて受け渡さない。stdin は 1 本
+    しかないので、記事と候補比較を別々の口にせず 1 つの封筒にまとめる
+    （**設計からの変更・理由はここ**）。CLI 側はファイル入力と同じ検査関数へ
+    合流する。
+    """
+    args = ["topics", "suggest", arguments["file"], "--input-json-stdin"]
+    if arguments.get("article_url"):
+        args += ["--article-url", arguments["article_url"]]
+    payload = {"article": arguments.get("article")}
+    if with_proposal:
+        payload["proposal"] = arguments.get("proposal")
+    return args, json.dumps(payload, ensure_ascii=False)
+
+
+def call_tool(name: str, arguments: dict | None) -> dict:
+    """CLI を呼んで結果を返すだけ。判断（条件分岐・整形）をここに書かない。"""
+    arguments = arguments or {}
+    if name == "thth_lint":
+        proc = run_cli(["lint", arguments["file"], "--json"])
+        text = proc.stdout
+    elif name == "thth_queue":
+        args = ["queue"]
+        if arguments.get("account"):
+            args.append(arguments["account"])
+        args.append("--json")
+        proc = run_cli(args)
+        text = proc.stdout
+    elif name == "thth_preview":
+        proc = run_cli(["preview", arguments["file"]])
+        text = proc.stdout if proc.returncode == 0 else proc.stderr
+    elif name in ("thth_topic_context", "thth_topic_evaluate"):
+        args, payload = _topic_stdin(
+            arguments, with_proposal=(name == "thth_topic_evaluate"))
+        proc = run_cli(args, stdin_text=payload)
+        text = proc.stdout
+    elif name == "thth_topic_decision":
+        proc = run_cli(["topics", "decision", arguments["id"], "--json"])
+        text = proc.stdout
+    elif name == "thth_board":
+        proc = run_cli(["board", "--json"])
+        text = proc.stdout
+    elif name == "before_you_post":
+        args = ["ask", "before-you-post", arguments["account"],
+                "--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("is_reply"):
+            args.append("--reply")
+        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
+    else:
+        return {"content": [{"type": "text", "text": f"unknown tool: {name}"}], "isError": True}
+
+    if name.startswith("thth_topic_") or name == "before_you_post":
+        # **新しい道具は exit 1 も isError**（設計 §7）。lint の exit 1（検査結果）
+        # とは意味が違う——こちらは stale_context・不正な候補比較で、
+        # **そのまま使ってはいけない**応答。既存の扱いは変えない。
+        # `before_you_post` も同じ（設計 v2 §1）: exit 1 は台帳が無い、2 は問いが
+        # 受け取れない。**`cannot_say` だらけの答えは exit 0 で、error ではない。**
+        is_error = proc.returncode != 0
+    else:
+        is_error = proc.returncode not in (0, 1)  # lint は 1 も正常な「検査結果」
+    if not text:
+        text = proc.stderr
+    return {"content": [{"type": "text", "text": text}], "isError": is_error}
+
+
+def _send(obj: dict) -> None:
+    sys.stdout.write(json.dumps(obj, ensure_ascii=False) + "\n")
+    sys.stdout.flush()
+
+
+def _handle_request(req: dict):
+    method = req.get("method")
+    req_id = req.get("id")
+
+    if method == "initialize":
+        return {
+            "jsonrpc": "2.0", "id": req_id,
+            "result": {
+                "protocolVersion": "2024-11-05",
+                "capabilities": {"tools": {}},
+                "serverInfo": {"name": "thth", "version": "0.1.0"},
+            },
+        }
+    if method == "notifications/initialized":
+        return None
+    if method == "tools/list":
+        return {"jsonrpc": "2.0", "id": req_id, "result": {"tools": TOOLS}}
+    if method == "tools/call":
+        params = req.get("params") or {}
+        result = call_tool(params.get("name"), params.get("arguments"))
+        return {"jsonrpc": "2.0", "id": req_id, "result": result}
+    if req_id is not None:
+        return {"jsonrpc": "2.0", "id": req_id,
+                "error": {"code": -32601, "message": f"method not found: {method}"}}
+    return None
+
+
+def main() -> None:
+    for line in sys.stdin:
+        line = line.strip()
+        if not line:
+            continue
+        try:
+            req = json.loads(line)
+        except json.JSONDecodeError:
+            continue
+        resp = _handle_request(req)
+        if resp is not None:
+            _send(resp)
+
+
+if __name__ == "__main__":
+    main()