thth 2.3.3__tar.gz → 2.5.0__tar.gz

{thth-2.3.3 → thth-2.5.0}/.gitignore

@@ -9,3 +9,7 @@ dist/
 .claude/worktrees/
 callback/.wrangler/
 callback/node_modules/
+
+# Defense in depth: notification credentials must use a repo-external THTH_ROOT.
+/notifications.json
+/notifications.json.*

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: thth
-Version: 2.3.3
+Version: 2.5.0
 Summary: 承認済みの投稿だけを投げる門（Threads・Bluesky・Mastodon）。人が承認し、記録は利用者の git に残る。
 Project-URL: Homepage, https://thth.me
 Project-URL: Source, https://github.com/aokings/thth
@@ -33,9 +33,9 @@ watchtower（`~/Developer/watchtower`）の隣に同じ流儀で並べる。watc
 
 ## 版
 
-**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)。
+このソースの版は **2.5.0**。現在の設計は [自分の泉](docs/設計_自分の泉_2026-09-16.md)、導入は [自分の Meta アプリで動かす](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`）。
+版の正本は `thth/VERSION`（`server.json` はテストで一致を強制）。開発中の `main` には未配布の変更も含まれます。インストール済みの版は `thth --version`、VM の版と revision は `thth board` で確認してください。
 
 **`main` への push は保存だけ。`release` を進める操作が配布**（VM は `release` だけを追う。設計 §3.2.1）。
 
@@ -43,14 +43,14 @@ watchtower（`~/Developer/watchtower`）の隣に同じ流儀で並べる。watc
 
 各プロジェクトのセッションが読むのは [docs/使い方_プロジェクトのセッション向け_2026-09-09.md](docs/使い方_プロジェクトのセッション向け_2026-09-09.md) **だけ**。設計書は作った側の記録なので読まなくてよい。
 
-## いまの状態（2026-09-13）
+## 実装と運用の状態（2026-09-18）
 
-版 **2.3.3**。全件テスト **2320 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。
+2.5.0 の実装 revision の全件テストは **2690 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。開発中の変更の検証は対象 revision の CI を参照してください。
 
 **媒体**: Threads（稼働）・Bluesky・Mastodon（同席用の台帳あり・未稼働）。
 
-**本番稼働中**: Threads の 4 アカウント（nigamilab・asmon 関東・kopicha・masaru の同席用）。
-timer（systemd・`thth systemd` で生成）で毎時投稿、返信の採集（`thth replies`）と数の採集
+**定期実行中**: 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`・読み取りと
@@ -59,6 +59,21 @@ timer（systemd・`thth systemd` で生成）で毎時投稿、返信の採集
 
 **トピックの棚**（`thth topics`）: 観測者ごとに並ぶ・打ち消し `retract-note`・`history`。
 
+### v2.5.0 の変更
+
+- 読み取り専用のレポート 3 本: `analytics-report`（活動のスナップショット・`--compare-previous` で隣接期間の比較）・`handoff-report`（ローカル運用記録の引継ぎ）・`study-report`（施策の宣言と本人の観測の結合）。MCP に `analytics_report`・`operations_handoff`・`study_report`。数値は期間・母数・欠測・根拠を連れて歩き、因果や推奨は出しません。
+- `serve-reports`: 専用環境向けの非公開レポート HTTP（Unix socket 既定・service credential・読むだけ）。**開発版**で、人の認証・TLS・一般提供は含みません。[限界](docs/非公開レポートHTTP_v1.md)。
+- X の本人公開指標の純粋な変換関数（API・投稿・台帳には未接続）。
+- 独立監査（P2 4・P3 7）とその直し: Unix socket 既定・要求全体の 10 秒 deadline・分離検査の走査を読取 dir に限定・期間比較の母集団から時刻不一致の返信を除外・git 無しでも import 可。
+
+### v2.4.0 の変更
+
+- 利用者・管理者への停止／復旧メールと、元原稿の運用記録。設定・秘密は repo 外に保存します。導入時は [共通通知手順](docs/停止通知と運用記録.md) を実施します。
+- 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` があればそちら）。
@@ -74,16 +89,16 @@ timer（systemd・`thth systemd` で生成）で毎時投稿、返信の採集
   は `local`。泉のサーバはまだ無い）。原稿本文は渡さないし、答えにも出ない。
   **n が閾値（既定 20）に満たない群は中央値を返さず `cannot_say` に理由を出す**——
   手元の水ではほとんどが `cannot_say` になる。それが正しい答えで、rc は 0。MCP からは `before_you_post`。
-- **読む口（`thth where`・`thth thread`・`thth who`）は何も保存しない**（裁定
-  2026-09-16「横断の泉はやめる」）。残るのは絡みの台帳（自分の行為と反応）だけ。
+- **読む口（`thth where`・`thth thread`・`thth who`）は取得した投稿本文を保存しません**（裁定
+  2026-09-16「横断の泉はやめる」）。検索語・投稿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` の全 35 サブコマンド）: `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`。
+- **動くもの**（`thth --help` の全 40 サブコマンド）: `lint`・`preview`・`approve`・`account`・`revoke`・`posts`・`replies`・`measured`・`threads`・`after`・`analytics-report`・`study-report`・`handoff-report`・`serve-reports`・`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 つ。削除はできない。
-- **masaru の手が要るもの**: repo を public にする切替と `LICENSE`、tag と `release` を進める操作（PyPI と MCP registry は 2.0.1 まで公開済み）。
+- **配布**: `release` への反映と version tag の push を分けます。tag の CI が全件テスト後に PyPI と MCP registry へ OIDC で公開します。
 
 ## MCP registry
 
@@ -91,3 +106,11 @@ registry は「この PyPI の名前を名乗ってよいのは誰か」を、**
 
 mcp-name: io.github.aokings/thth
 
+## v3 基盤（2.5.0 から）
+
+`study-report` は明示した施策の宣言と本人の投稿観測を結ぶ読み取り専用レポートです。採用者の本人確認や因果効果は主張しません。[使い方と契約](docs/施策レポート_v1.md)。
+
+`analytics-report` はローカル台帳から期間・母数・欠測・根拠を揃えたスナップショットを返します。
+[形式と使い方](docs/分析レポート_v1.md)。
+
+`handoff-report` / MCP `operations_handoff` はローカル運用状態・通知未処理を鮮度の制約付きで返します。[形式と使い方](docs/運用引継ぎレポート_v1.md)。

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

@@ -9,9 +9,9 @@ watchtower（`~/Developer/watchtower`）の隣に同じ流儀で並べる。watc
 
 ## 版
 
-**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)。
+このソースの版は **2.5.0**。現在の設計は [自分の泉](docs/設計_自分の泉_2026-09-16.md)、導入は [自分の Meta アプリで動かす](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`）。
+版の正本は `thth/VERSION`（`server.json` はテストで一致を強制）。開発中の `main` には未配布の変更も含まれます。インストール済みの版は `thth --version`、VM の版と revision は `thth board` で確認してください。
 
 **`main` への push は保存だけ。`release` を進める操作が配布**（VM は `release` だけを追う。設計 §3.2.1）。
 
@@ -19,14 +19,14 @@ watchtower（`~/Developer/watchtower`）の隣に同じ流儀で並べる。watc
 
 各プロジェクトのセッションが読むのは [docs/使い方_プロジェクトのセッション向け_2026-09-09.md](docs/使い方_プロジェクトのセッション向け_2026-09-09.md) **だけ**。設計書は作った側の記録なので読まなくてよい。
 
-## いまの状態（2026-09-13）
+## 実装と運用の状態（2026-09-18）
 
-版 **2.3.3**。全件テスト **2320 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。
+2.5.0 の実装 revision の全件テストは **2690 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。開発中の変更の検証は対象 revision の CI を参照してください。
 
 **媒体**: Threads（稼働）・Bluesky・Mastodon（同席用の台帳あり・未稼働）。
 
-**本番稼働中**: Threads の 4 アカウント（nigamilab・asmon 関東・kopicha・masaru の同席用）。
-timer（systemd・`thth systemd` で生成）で毎時投稿、返信の採集（`thth replies`）と数の採集
+**定期実行中**: 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`・読み取りと
@@ -35,6 +35,21 @@ timer（systemd・`thth systemd` で生成）で毎時投稿、返信の採集
 
 **トピックの棚**（`thth topics`）: 観測者ごとに並ぶ・打ち消し `retract-note`・`history`。
 
+### v2.5.0 の変更
+
+- 読み取り専用のレポート 3 本: `analytics-report`（活動のスナップショット・`--compare-previous` で隣接期間の比較）・`handoff-report`（ローカル運用記録の引継ぎ）・`study-report`（施策の宣言と本人の観測の結合）。MCP に `analytics_report`・`operations_handoff`・`study_report`。数値は期間・母数・欠測・根拠を連れて歩き、因果や推奨は出しません。
+- `serve-reports`: 専用環境向けの非公開レポート HTTP（Unix socket 既定・service credential・読むだけ）。**開発版**で、人の認証・TLS・一般提供は含みません。[限界](docs/非公開レポートHTTP_v1.md)。
+- X の本人公開指標の純粋な変換関数（API・投稿・台帳には未接続）。
+- 独立監査（P2 4・P3 7）とその直し: Unix socket 既定・要求全体の 10 秒 deadline・分離検査の走査を読取 dir に限定・期間比較の母集団から時刻不一致の返信を除外・git 無しでも import 可。
+
+### v2.4.0 の変更
+
+- 利用者・管理者への停止／復旧メールと、元原稿の運用記録。設定・秘密は repo 外に保存します。導入時は [共通通知手順](docs/停止通知と運用記録.md) を実施します。
+- 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` があればそちら）。
@@ -50,16 +65,16 @@ timer（systemd・`thth systemd` で生成）で毎時投稿、返信の採集
   は `local`。泉のサーバはまだ無い）。原稿本文は渡さないし、答えにも出ない。
   **n が閾値（既定 20）に満たない群は中央値を返さず `cannot_say` に理由を出す**——
   手元の水ではほとんどが `cannot_say` になる。それが正しい答えで、rc は 0。MCP からは `before_you_post`。
-- **読む口（`thth where`・`thth thread`・`thth who`）は何も保存しない**（裁定
-  2026-09-16「横断の泉はやめる」）。残るのは絡みの台帳（自分の行為と反応）だけ。
+- **読む口（`thth where`・`thth thread`・`thth who`）は取得した投稿本文を保存しません**（裁定
+  2026-09-16「横断の泉はやめる」）。検索語・投稿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` の全 35 サブコマンド）: `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`。
+- **動くもの**（`thth --help` の全 40 サブコマンド）: `lint`・`preview`・`approve`・`account`・`revoke`・`posts`・`replies`・`measured`・`threads`・`after`・`analytics-report`・`study-report`・`handoff-report`・`serve-reports`・`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 つ。削除はできない。
-- **masaru の手が要るもの**: repo を public にする切替と `LICENSE`、tag と `release` を進める操作（PyPI と MCP registry は 2.0.1 まで公開済み）。
+- **配布**: `release` への反映と version tag の push を分けます。tag の CI が全件テスト後に PyPI と MCP registry へ OIDC で公開します。
 
 ## MCP registry
 
@@ -67,3 +82,11 @@ registry は「この PyPI の名前を名乗ってよいのは誰か」を、**
 
 mcp-name: io.github.aokings/thth
 
+## v3 基盤（2.5.0 から）
+
+`study-report` は明示した施策の宣言と本人の投稿観測を結ぶ読み取り専用レポートです。採用者の本人確認や因果効果は主張しません。[使い方と契約](docs/施策レポート_v1.md)。
+
+`analytics-report` はローカル台帳から期間・母数・欠測・根拠を揃えたスナップショットを返します。
+[形式と使い方](docs/分析レポート_v1.md)。
+
+`handoff-report` / MCP `operations_handoff` はローカル運用状態・通知未処理を鮮度の制約付きで返します。[形式と使い方](docs/運用引継ぎレポート_v1.md)。

{thth-2.3.3 → thth-2.5.0}/mcp/server.py

@@ -139,6 +139,34 @@ TOOLS = [
             "required": ["account", "topic"],
         },
     },
+    {
+        "name": "operations_handoff",
+        "description": "ローカル運用記録の状態・承認待ち・inflight・通知未処理を根拠と鮮度の制約付きで返す。同期・承認・再送はしない",
+        "inputSchema": {"type": "object", "properties": {
+            "account": {"type": "string"}, "project": {"type": "string"}}},
+    },
+    {
+        "name": "study_report",
+        "description": "ローカル施策JSONの未検証の採用宣言と本人の観測を結ぶ。proposedは集計せず、adoptedも因果効果や投稿承認を証明しない。読むだけ",
+        "inputSchema": {
+            "type": "object", "required": ["file"],
+            "properties": {"file": {"type": "string"}, "min_n": {"type": "integer"}},
+        },
+    },
+    {
+        "name": "analytics_report",
+        "description": "自分の活動のスナップショットを期間・母数・欠測・根拠つきで返す。ローカル台帳を読むだけ。compare_previous=trueで前期間比較。推奨は含まない",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "compare_previous": {"type": "boolean", "description": "直前の同じ日数との比較（既定false）"},
+                "account": {"type": "string"},
+                "project": {"type": "string"},
+                "window_days": {"type": "integer", "description": "直近何日（既定7）"},
+                "min_n": {"type": "integer", "description": "中央値の最小母数（既定5）"},
+            },
+        },
+    },
     {
         # **名前と説明文がそのまま売り文句**（設計「自分の泉」§2.2）。
         # 実装が 1 語でも足したら設計書でなく実装を戻す（§2 の頭書きそのまま）。
@@ -151,7 +179,10 @@ TOOLS = [
         "inputSchema": {
             "type": "object",
             "properties": {
-                "account": {"type": "string", "description": "account 名"},
+                "account": {"type": "string",
+                            "description": "account 名（project の代わり）"},
+                "project": {"type": "string",
+                            "description": "この project の account 全部（account の代わり）"},
                 "topic": {"type": "string", "description": "語（トピック）"},
                 "kind": {"type": "string", "description": "型（行動・年度付き 等）"},
                 "hour_band": {"type": "string",
@@ -164,7 +195,7 @@ TOOLS = [
                 "min_n": {"type": "integer",
                            "description": "中央値を返す下限（既定 5）"},
             },
-            "required": ["account"],
+            # account / project の排他的 OR は validate_arguments() で見る。
         },
     },
     {
@@ -409,12 +440,17 @@ def validate_arguments(name: str, arguments) -> dict:
                         f"CLI の旗と区別できないので受け取りません")
         if key == "file":
             check_file_argument(name, value)
-    if name in ("where_to_appear", "who_is_this") and not arguments.get("account") \
+    if name in ("operations_handoff", "analytics_report", "after_you_posted", "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 in ("operations_handoff", "analytics_report", "after_you_posted") and arguments.get("account") \
+            and arguments.get("project"):
+        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 を
@@ -495,9 +531,43 @@ def call_tool(name: str, arguments: dict | None) -> dict:
         args.append("--json")
         proc = run_cli(args)
         text = proc.stdout
+    elif name == "operations_handoff":
+        args = ["handoff-report"]
+        if arguments.get("project"):
+            args += ["--project", arguments["project"]]
+        else:
+            args.append(arguments["account"])
+        args.append("--json")
+        proc = run_cli(args)
+        text = proc.stdout
+    elif name == "study_report":
+        args = ["study-report", arguments["file"]]
+        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 == "analytics_report":
+        args = ["analytics-report"]
+        if arguments.get("project"):
+            args += ["--project", arguments["project"]]
+        else:
+            args.append(arguments["account"])
+        for key in ("window_days", "min_n"):
+            if arguments.get(key) is not None:
+                args += ["--" + key.replace("_", "-"), str(arguments[key])]
+        if arguments.get("compare_previous"):
+            args.append("--compare-previous")
+        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"]]
+        args = ["after"]
+        if arguments.get("project"):
+            args += ["--project", arguments["project"]]
+        else:
+            args.append(arguments["account"])
         if arguments.get("topic"):
             args += ["--topic", arguments["topic"]]
         if arguments.get("kind"):
@@ -567,7 +637,7 @@ def call_tool(name: str, arguments: dict | None) -> dict:
         return {"content": [{"type": "text", "text": f"unknown tool: {name}"}], "isError": True}
 
     if name.startswith("thth_topic_") or name in (
-            "before_you_post", "after_you_posted", "thread_read", "where_to_appear",
+            "before_you_post", "after_you_posted", "analytics_report", "operations_handoff", "study_report", "thread_read", "where_to_appear",
             "who_is_this"):
         # **新しい道具は exit 1 も isError**（設計 §7）。lint の exit 1（検査結果）
         # とは意味が違う——こちらは stale_context・不正な候補比較で、

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

@@ -106,15 +106,18 @@ thth approve <同じ> --confirm <digest> --by "<承認した人>"     # 二段
 ### 6. 測る——出したあとの反応
 
 ```bash
-thth after <account> [--reply-to <post_id>] [--topic …]
+thth after (<account>|--project <project>) [--reply-to <post_id>] [--topic …] [--kind …]
 ```
 
 MCP `after_you_posted`。**24h の刻みが無ければ `null`**（0 と混ぜない・
 `covered: false` を付ける）。`one_thing_to_change` は 1 個か `null`。
+`posts` は所有を確認できた実測台帳の根投稿だけ（`n` と 24h views の中央値・
+分母）、`engagements` は絡みに行った返信。`kind` は現在の topic shelf の分類で、
+投稿構成の `form` や投稿時点の分類ではない。
 **残すもの: なし**（この口は読むだけ。絡みの台帳は**公開の瞬間**に 1 行書かれる——
 自分の行為と反応だけで、相手の本文・名前・自分の判断は入らない）。
-**媒体をまたぐ数は無い**——project 単位で並べるだけで、足さない・割らない・
-順位も付けない。
+**媒体・account をまたぐ数は無い**——`--project` は `by_account` に並べるだけで、
+足さない・割らない・順位も付けない。
 
 ---
 
@@ -123,3 +126,19 @@ MCP `after_you_posted`。**24h の刻みが無ければ `null`**（0 と混ぜ
 - `thth --help` / `thth <subcommand> --help` が正本。
 - `thth doctor <account>` が「いま投稿できる状態か」を最初から最後まで言う。
 - 使い方の全文: `docs/使い方_プロジェクトのセッション向け_2026-09-09.md`。
+
+## 運用と分析のレポート（v3系・2.5.0 から）
+
+2.4.0 以前には無い入口を含む。接続先のhelp/tools一覧にある場合だけ使う。
+
+- 再開時は `handoff-report` / MCP `operations_handoff`。ローカルの停止・要確認・通知記録を読む。`waiting`をtimer正常や投稿成功と解釈しない。
+- `analytics-report` / MCP `analytics_report` は期間・母数・欠測・根拠付きsnapshot。生成時刻とデータ更新時刻を混同しない。
+- 前期間比較は `--compare-previous` / `compare_previous: true`。投稿後24〜30時間未満の実観測で比較し、欠測をゼロにしない。
+- 施策メモの振り返りは `study-report` / `study_report`。採用宣言と観測を分け、提案を自動で採用済みにしない。投稿の承認には使えない。
+- 観測差を因果効果と断定しない。accountをまたいだ合算・順位を作らない。詳しい読み順は `docs/手順_LLM_分析と運用の引継ぎ.md`。
+
+## 停止通知と運用状況（開発版 main）
+
+新規 account は利用者メール・管理者メール・TLS SMTP を `thth notifications config` で設定し、`status` → `test` を実行する。両宛先の受信箱で到達、account 専用 HEALTHCHECK_URL の missed-ping 通知を確認してから production/scheduled を有効にする。既存 account にも同じ設定を追加する。詳細は `docs/停止通知と運用記録.md`。
+
+プロジェクトの作業開始・再開時は `git fetch` 後にリモート `docs/sns/queue/` の `thth_run_state`・`thth_run_detail`・`thth_run_next` を確認する。dirty worktree へ無条件に pull しない。リモートの確認は `git show origin/main:docs/sns/queue/FILE.md` 等で行える。停止・成否不明なら inflight を消して再投稿せず、示された確認を行う。復旧状態は投稿成功の保証ではなく、公開結果は status/post_id/posted_at を見る。