THTH（ThreadsThrower・承認済み投稿の投げ手）
設計: docs/設計_THTH_2026-09-08.md（§8 の裁定済み。現行の設計書）。
承認済み（status: approved）の投稿ファイルを読み、静かな時間帯と最短間隔を守って 1 件だけ投げ、
post_id を書き戻して push し、投稿済みの返信を拾って追記し、走った記録と鮮度を出し、
走らなかったことを外部に知らせるまでを持つ。意味（何を書くか・承認・返信の解釈・採集箱への昇格）は持たない。
watchtower（~/Developer/watchtower）の隣に同じ流儀で並べる。watchtower は POST しないので投稿は混ぜない。
版
このソースの版は 2.4.0。現在の設計は 自分の泉、導入は 自分の Meta アプリで動かす、文書の索引は docs/README.md。
版の正本は thth/VERSION（server.json はテストで一致を強制）。開発中の main には未配布の変更も含まれます。インストール済みの版は thth --version、VM の版と revision は thth board で確認してください。
main への push は保存だけ。release を進める操作が配布（VM は release だけを追う。設計 §3.2.1）。
使う人へ
各プロジェクトのセッションが読むのは docs/使い方_プロジェクトのセッション向け_2026-09-09.md だけ。設計書は作った側の記録なので読まなくてよい。
実装と運用の状態（2026-09-18）
2.4.0 の実装 revision の全件テストは 2452 件（python -m pytest tests/ -q -n auto -p no:cacheprovider・1 skip・rc=0）。開発中の変更の検証は対象 revision の CI を参照してください。
媒体: Threads（稼働）・Bluesky・Mastodon（同席用の台帳あり・未稼働）。
定期実行中: Threads の 3 アカウント（nigamilab・asmon 関東・kopicha）。masaru の Threads は同席用です。
timer（systemd・thth systemd で生成）は10分ごとに実行し、投稿間隔と静かな時間帯を尊重します。返信の採集（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 に公開済み・MCP registry に io.github.aokings/thth として登録済み）。
トピックの棚（thth topics）: 観測者ごとに並ぶ・打ち消し retract-note・history。
v2.4.0 の変更
- 利用者・管理者への停止／復旧メールと、元原稿の運用記録。設定・秘密は repo 外に保存します。導入時は 共通通知手順 を実施します。
- VM・プロセス停止を検知する外部 missed-ping 監視と、board の停止理由表示。
- Threads の投稿エラーに HTTP 番号・許可した API コード等を記録。本文や任意のエラーメッセージは保存しません。
afterの投稿集計、project 指定、topic kind 別集計。- self-update の署名検証と merge を同一 commit に固定し、媒体固有の秘密値を伏字対象へ追加。
v2.0.0 で増えた口
-
台帳を repo の外へ（設計 v2 §3・裁定 §7-1）。正は
$THTH_ROOT/accounts/（$THTH_ACCOUNTS_DIRがあればそちら）。 repo に台帳は入っていない（2026-09-14 に 6 本を削除）——clone しても他人の台帳は付いて来ないので、thth account addで自分の 1 本を作るところから始まる。配るのは雛形accounts.example/の 3 本だけ。 repo のaccounts/は1 版だけ互換で読む（stderr に警告 1 行・移行前の機械を止めないため）。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 where・thth thread・thth who）は取得した投稿本文を保存しません（裁定 2026-09-16「横断の泉はやめる」）。検索語・投稿ID・件数等の最小限の実行記録と、絡みの台帳（自分の行為と反応）は残ります。 -
英語の文書: README.en.md・docs/usage.en.md・llms.txt。
-
skill:
skills/thth/SKILL.md（wheel にも入る）。 -
動くもの（
thth --helpの全 36 サブコマンド）:lint・preview・approve・account・revoke・posts・replies・measured・threads・after・topics・forms・queue・schedule・throw・run・systemd・board・collect・pull・auth・refresh・maintain・send・doctor・app・token・ask・mentions・profile・thread・where・who・retract・location・notifications。 -
最初の本番投稿の記録: 2026-09-09、@aoking に疎通確認を 1 本（
17916074118445631）。 -
未着手: X・Facebook ページ・Instagram の各アダプタ。トピック検索の権限（tester には降りない）。泉のサーバ（v2-5）。
-
権限の制約: tester に降りる scope は 5 つ。削除はできない。
-
配布:
releaseへの反映と version tag の push を分けます。tag の CI が全件テスト後に PyPI と MCP registry へ OIDC で公開します。
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
1 maintainer
Release files for thth 2.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| thth-2.4.0.tar.gz | 1.1 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| thth-2.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.6 MB
Release files / thth-2.4.0.tar.gz
| Download URL | thth-2.4.0.tar.gz |
|---|---|
| Size | 1.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
633788749e302ed278a37856323b9d333316403c399c2e5cdac4a4c6bbaa5dd5
|
|
BLAKE2b-256 checksum How to use checksums |
5ec6f471f462b29658658a553dcff5f97f4b11e5137cfc1b0dd5dea691650e3f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 18, 2026.
Transparency logRelease files / thth-2.4.0-py3-none-any.whl
| Download URL | thth-2.4.0-py3-none-any.whl |
|---|---|
| Size | 566.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
122edb7fdbe7b6e7bb35012df4369f437157b93ed04ecbcc102610d97918cbbb
|
|
BLAKE2b-256 checksum How to use checksums |
d4cffa53aa71a10c46b210cb561d51c5e6df6060dd1c6ac171adcf79de106d07
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 18, 2026.
Transparency log
