thth 3.3.0__tar.gz → 3.4.0__tar.gz

{thth-3.3.0 → thth-3.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: thth
-Version: 3.3.0
+Version: 3.4.0
 Summary: 承認済みの投稿だけを投げる門（Threads・Bluesky・Mastodon）。人が承認し、記録は利用者の git に残る。
 Project-URL: Homepage, https://thth.me
 Project-URL: Source, https://github.com/aokings/thth
@@ -125,7 +125,7 @@ timer（systemd・`thth systemd` で生成）は10分ごとに実行し、投稿
 - **英語の文書**: [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` の全サブコマンド）: `lint`・`preview`・`approve`・`account`・`revoke`・`posts`・`replies`・`measured`・`threads`・`after`・`analytics-report`・`study-report`・`study`・`unanswered`・`handoff-report`・`observe`・`morning`・`serve-reports`・`approval-worker`・`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`・`report`・`admin`。
+- **動くもの**（`thth --help` の全サブコマンド）: `lint`・`preview`・`approve`・`account`・`revoke`・`posts`・`replies`・`measured`・`threads`・`after`・`analytics-report`・`study-report`・`study`・`unanswered`・`handoff-report`・`observe`・`morning`・`serve-reports`・`approval-worker`・`topics`・`forms`・`queue`・`schedule`・`throw`・`run`・`systemd`・`board`・`collect`・`pull`・`auth`・`refresh`・`maintain`・`send`・`doctor`・`app`・`token`・`ask`・`mentions`・`profile`・`thread`・`where`・`who`・`retract`・`inflight`・`location`・`notifications`・`report`・`plaza`・`admin`。
 - **最初の本番投稿の記録**: 2026-09-09、@aoking に疎通確認を 1 本（`17916074118445631`）。
 - **未着手**: X・Facebook ページ・Instagram の各アダプタ。トピック検索の権限（tester には降りない）。泉のサーバ（v2-5）。
 - **権限の制約**: tester に降りる scope は 5 つ。削除はできない。

{thth-3.3.0 → thth-3.4.0}/README.md

@@ -101,7 +101,7 @@ timer（systemd・`thth systemd` で生成）は10分ごとに実行し、投稿
 - **英語の文書**: [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` の全サブコマンド）: `lint`・`preview`・`approve`・`account`・`revoke`・`posts`・`replies`・`measured`・`threads`・`after`・`analytics-report`・`study-report`・`study`・`unanswered`・`handoff-report`・`observe`・`morning`・`serve-reports`・`approval-worker`・`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`・`report`・`admin`。
+- **動くもの**（`thth --help` の全サブコマンド）: `lint`・`preview`・`approve`・`account`・`revoke`・`posts`・`replies`・`measured`・`threads`・`after`・`analytics-report`・`study-report`・`study`・`unanswered`・`handoff-report`・`observe`・`morning`・`serve-reports`・`approval-worker`・`topics`・`forms`・`queue`・`schedule`・`throw`・`run`・`systemd`・`board`・`collect`・`pull`・`auth`・`refresh`・`maintain`・`send`・`doctor`・`app`・`token`・`ask`・`mentions`・`profile`・`thread`・`where`・`who`・`retract`・`inflight`・`location`・`notifications`・`report`・`plaza`・`admin`。
 - **最初の本番投稿の記録**: 2026-09-09、@aoking に疎通確認を 1 本（`17916074118445631`）。
 - **未着手**: X・Facebook ページ・Instagram の各アダプタ。トピック検索の権限（tester には降りない）。泉のサーバ（v2-5）。
 - **権限の制約**: tester に降りる scope は 5 つ。削除はできない。

{thth-3.3.0 → thth-3.4.0}/mcp/server.py

@@ -568,6 +568,25 @@ ADMIN_TOOLS += [
                     'required':['report_id','reason','version','by'],'additionalProperties':False}},
 ]
 
+# 施策の広場の管理者側（設計 3.4.0 §4）。参加・退出・非表示は `by` 必須・変更ログに
+# presence-only で残る。
+ADMIN_TOOLS += [
+    {'name':'thth_admin_plaza_list','description':'List every plaza post (measures, findings, questions) including hidden ones, and the joined projects; administrator only; read-only',
+     'inputSchema':{'type':'object','properties':{},'required':[],'additionalProperties':False}},
+    {'name':'thth_admin_plaza_show','description':'Read one plaza post as stored (original text, observations, replies); administrator only; read-only',
+     'inputSchema':{'type':'object','properties':{'plaza_id':{'type':'string'}},
+                    'required':['plaza_id'],'additionalProperties':False}},
+    {'name':'thth_admin_plaza_join','description':'Let one project (owner) read and post open plaza entries; administrator only, by required; default is not joined',
+     'inputSchema':{'type':'object','properties':{'project':{'type':'string'},'by':{'type':'string'}},
+                    'required':['project','by'],'additionalProperties':False}},
+    {'name':'thth_admin_plaza_leave','description':'Remove one project (owner) from the open plaza; its open entries stop being visible to others; administrator only, by required',
+     'inputSchema':{'type':'object','properties':{'project':{'type':'string'},'by':{'type':'string'}},
+                    'required':['project','by'],'additionalProperties':False}},
+    {'name':'thth_admin_plaza_hide','description':'Hide one plaza post with a reason (the owner still sees it with the reason); administrator only, by required',
+     'inputSchema':{'type':'object','properties':{'plaza_id':{'type':'string'},'reason':{'type':'string'},'by':{'type':'string'}},
+                    'required':['plaza_id','reason','by'],'additionalProperties':False}},
+]
+
 SERVER_TOOLS = [
     {"name":"thth_"+name,"description":"Scoped server "+name,
      "inputSchema":{"type":"object","properties":{key:{"type":"string"} for key in ("account",*keys)},
@@ -644,6 +663,68 @@ REPORT_TOOLS = [
 ]
 
 
+# 施策の広場の利用者側（設計 3.4.0 §4）。**サーバ型だけに出す**（報告の口と同じ——
+# 置き場は VM の私有）。誰が書いたかは credential の `actor`。読めるのは credential が
+# 許した account の持ち主（project）の書き込みと、参加していれば open の写しだけ。
+PLAZA_WELCOME = ("施策を試したら広場に置き、次を決める前に他の媒体の施策を読む——"
+                 "どちらも利用者の作業の一部です")
+PLAZA_TOOLS = [
+    {"name": "thth_plaza_post",
+     "description": PLAZA_WELCOME + "。施策（measure: 観測は道具が study-report と同じ計算で付ける・"
+                    "how〔数字を出し直せる thth の命令〕が必須）・気づき（finding）・問い（question）を"
+                    "置く。scope（媒体・企画の範囲）は必須。置いたものは同じ持ち主の全 account だけに"
+                    "見える（他の持ち主に見せる open は人が CLI の二段確認で行う・この口には無い）。"
+                    "evidence_level の observed は道具だけが付ける",
+     "inputSchema": {"type": "object", "properties": {
+         "account": {"type": "string"},
+         "kind": {"type": "string", "enum": ["measure", "finding", "question"]},
+         "title": {"type": "string", "description": "1 行・120 字まで"},
+         "body": {"type": "string", "description": "8,000 字まで"},
+         "scope": {"type": "string", "description": "媒体・企画の範囲（1 行・120 字・必須）"},
+         "kind_detail": {"type": "string", "enum": ["pattern", "rule", "pitfall", "tool_tip"],
+                         "description": "finding の細目（任意）"},
+         "how": {"type": "string", "description": "数字を出し直せる thth の命令 1 行（measure は必須・実行しない）"},
+         "evidence_level": {"type": "string", "enum": ["stated", "hypothesis"]},
+         "declarations": {"type": "array", "description": "measure の宣言（study-report の形・媒体ごとに 1 つ）"},
+         "hypothesis": {"type": "string"}, "change": {"type": "string"},
+         "until": {"type": "string", "description": "期間の終わり（timezone 付きの時刻）"},
+         "min_n": {"type": "integer"}},
+         "required": ["account", "kind", "title", "body", "scope"], "additionalProperties": False}},
+    {"name": "thth_plaza_list",
+     "description": "広場の一覧（既定は自分の持ち主の書き込み・open: true は open の広場）。次を決める前に"
+                    "他の媒体の施策を読む（読むだけ）",
+     "inputSchema": {"type": "object", "properties": {
+         "project": {"type": "string"}, "open": {"type": "boolean"}},
+         "additionalProperties": False}},
+    {"name": "thth_plaza_show",
+     "description": "広場の 1 件（本文・道具が付けた観測・媒体をまたぐ比較の表・追試の数・返信）を読む（読むだけ）",
+     "inputSchema": {"type": "object", "properties": {"plaza_id": {"type": "string"}},
+                     "required": ["plaza_id"], "additionalProperties": False}},
+    {"name": "thth_plaza_reply",
+     "description": "返信を 1 つ足す（comment・agree・disagree〔理由必須〕・tried〔自分の measure の id 必須〕・"
+                    "trial〔追試: result に reproduced・not_reproduced・not_tried。再現しなかった報告も"
+                    "同じ重さで数える〕）",
+     "inputSchema": {"type": "object", "properties": {
+         "plaza_id": {"type": "string"}, "account": {"type": "string"},
+         "kind": {"type": "string", "enum": ["comment", "tried", "agree", "disagree", "trial"]},
+         "text": {"type": "string", "description": "4,000 字まで"},
+         "measure_id": {"type": "string"},
+         "result": {"type": "string", "enum": ["reproduced", "not_reproduced", "not_tried"]}},
+         "required": ["plaza_id", "account", "kind"], "additionalProperties": False}},
+    {"name": "thth_plaza_update",
+     "description": "自分の持ち主の施策の結果を取り直す（refresh）・判定（verdict: adopted・dropped・"
+                    "inconclusive と reason）・project の範囲に戻す（visibility: project。open への切り替えは"
+                    "人の CLI の二段確認だけ）",
+     "inputSchema": {"type": "object", "properties": {
+         "plaza_id": {"type": "string"}, "account": {"type": "string"},
+         "refresh": {"type": "boolean"},
+         "verdict": {"type": "string", "enum": ["adopted", "dropped", "inconclusive"]},
+         "reason": {"type": "string"},
+         "visibility": {"type": "string", "enum": ["project"]}},
+         "required": ["plaza_id", "account"], "additionalProperties": False}},
+]
+
+
 # **うまくいかなければ報告の口へ**（設計 3.1.2 §3.5）。利用者の道具の説明文の
 # 末尾に 1 句。定数（TOOLS 等）は書き換えず、並べるときに足す——「売り文句」の
 # 正本（設計 v2 §1・「自分の泉」§2）はそのまま残る。
@@ -681,7 +762,8 @@ def server_tools(context):
     reports = reports + [tool for tool in TOOLS if tool['name'] in ('thth_observe', 'thth_morning')]
     from thth.server_writes import WRITE_OPERATIONS
     return _with_report_hint(reports + [tool for tool in SERVER_TOOLS
-                      if context.writes or tool['name'][5:] not in WRITE_OPERATIONS]) + REPORT_TOOLS
+                      if context.writes or tool['name'][5:] not in WRITE_OPERATIONS]
+                      + PLAZA_TOOLS) + REPORT_TOOLS
 
 
 def server_call(name, arguments):
@@ -721,6 +803,12 @@ def server_call(name, arguments):
         elif operation.startswith('admin_reports_'):
             from thth.report_service import execute_admin_reports
             result=execute_admin_reports(context,request)
+        elif operation.startswith('admin_plaza_'):
+            from thth.report_service import execute_admin_plaza
+            result=execute_admin_plaza(context,request)
+        elif operation.startswith('plaza_'):
+            from thth.report_service import execute_user_plaza
+            result=execute_user_plaza(context,request)
         elif operation in ('report_file','report_list','report_show','report_add'):
             from thth.report_service import execute_user_reports
             result=execute_user_reports(context,request)
@@ -742,6 +830,12 @@ def server_call(name, arguments):
         if str(exc)=='duplicate_report' and getattr(exc,'report_id',None):
             # 既存の id は同じ account の報告だけ（重複の検査がそう絞っている）。
             return failure('duplicate_report: '+exc.report_id)
+        from thth.plaza import REASONS as PLAZA_REASONS
+        if str(exc)=='duplicate_post' and getattr(exc,'plaza_id',None):
+            # 既存の id は同じ account の書き込みだけ（重複の検査がそう絞っている）。
+            return failure('duplicate_post: '+exc.plaza_id)
+        if str(exc) in PLAZA_REASONS:
+            return failure(str(exc))
         return failure(str(exc) if str(exc) in SAFE_ERRORS or str(exc) in REPORT_REASONS or str(exc) in ('budget_change_durability_unconfirmed','budget_change_partially_recorded','budget_change_refused','watch_change_refused') else 'request_unavailable')
     except Exception:
         return failure('request_unavailable')

{thth-3.3.0 → thth-3.4.0}/skills/thth/SKILL.md

@@ -1,12 +1,14 @@
 ---
 name: thth
-description: 投稿する前・返信を書く前・出したあと・絡みに行く先を選ぶときに呼ぶ道具。Threads・Bluesky・Mastodon への下書きを人の承認を通してから出し、枝を読み、相手を知り、伸びを測る。
+description: 投稿する前・返信を書く前・出したあと・絡みに行く先を選ぶときに呼ぶ道具。Threads・Bluesky・Mastodon への下書きを人の承認を通してから出し、枝を読み、相手を知り、伸びを測る。施策を試したら広場に置き、他の媒体の施策を読んでから次を決める。
 ---
 
 **セッションの始めと区切りごとに `thth_observe`（CLI は `thth observe <project|account> --json`）。** 前回の観測から何があって、いまなにをすればよいかが 6 段（道具・返していないもの・前回の観測から・世間・予定・次の一手）で返る（3.3.0。`thth_morning`／`thth morning` は同じものの別名で、JSON の `invoked_as` だけが違う。第 2 段は前回の栞の時刻から今まで・栞が無い／7 日より古いときは前日 JST で、`window.basis` が `since_last_observe` か `yesterday_jst`）。`handoff-report --since-last-read` を包含するので、版の確認もこれ 1 回で済む。呼ぶと栞（前回読んだ時点）が進む——進めたくないときだけ `mark: false`（CLI は `--no-mark`）。取れなかった段は `{"value": null, "cannot_say": "<理由>"}`（`provider_timeout`・`budget_exhausted`・`scope_missing`・`no_watch_words`・`not_supported`・`unavailable`）で、**0 件とは別**。第 3 段の監視語は**管理者が入れる**（`thth admin watch set <account> 語 … --by <名前>`）——語が無い account は `no_watch_words` で飛ぶので、**代わりに語を選ばない**。第 5 段は候補の列挙だけで、**本文は返らない**（書くのはあなたと人の会話の側）。詳しくは `docs/使い方_毎朝の一枚_3.1.md`。
 
 **断られたら・違和感があれば報告の口へ**: `thth_report_file`（CLI は `thth report file <account> --kind bug|request|friction --title … --body-file … --by <名前>`）。つまずき・迷い・期待との違いの報告は、利用者の作業の一部として歓迎します。小さいものも。重複は道具が束ねます。例: 「止まったのに気づかなかった」「断られた理由が分からなかった」「同じ操作を 3 回繰り返した」。道具が断った・結果が期待と違った・欲しい形がある・迷った（`friction`）、のどれかなら 1 回で置ける。**断られた直後なら、断りの最後の `report_channel:` の行をそのまま打てばよい**（`--from-last-refusal` が、道具が控えた直前の断り——時刻・版・命令・理由の符丁だけで、本文と引数の値は控えていない——を再現手順に添える。MCP は `thth_report_file {"account": …, "title": …, "from_last_refusal": true}`）。置いた報告がこの版で閉じたかは `thth_observe` の 0 段 `project_reports` に出る。返事は `thth_report_show` と `handoff-report --since-last-read` の `tool.reports` に出る。秘密らしき値が含まれていたら置かれない（伏せてから置き直す）。
 
+**施策を試したら広場に置き、次を決める前に他の媒体の施策を読む**（3.4.0・施策の広場）。どちらも利用者の作業の一部です。小さな気づきも。`thth_plaza_post`（CLI は `thth plaza post <account> --kind measure|finding|question --title … --body-file … --scope "<媒体・企画の範囲>" --by <名前>`）。置いたものは**同じ持ち主の全 account（媒体をまたぐ）**だけに見える。施策（`measure`）は `--declaration <study-report の宣言>` を媒体ごとに並べると**観測は道具が付ける**（study-report と同じ計算・両群の分母・欠測は null と理由）。`--how` に数字を出し直せる thth の命令を 1 行（measure は必須・道具は実行しない）。本文に書いた数字は「本文」として分けて表示され、観測とは呼ばれない。`evidence_level` の `observed` は道具だけが付ける（名乗ると断られる）。読むのは `thth_plaza_list`・`thth_plaza_show`（CLI は `thth plaza list <project>`・`thth plaza show <id> --as <account>`）——媒体をまたぐ比較の表と追試の数（再現した・しなかった・試していないを同じ重さで）が出る。他の媒体の施策を自分の媒体で試したら `thth_plaza_reply` の `trial`（結果は reproduced・not_reproduced・not_tried）で返す。判定は `thth_plaza_update`（adopted・dropped・inconclusive・理由必須）。新着と「まだ試していない媒体」は `thth_observe` の 0 段と次の一手に出る。
+
 段だけを読み直したいときは `thth handoff-report <account> --since-last-read --json` を読む。`tool.changed_since_last_read` が真なら、手元の `tool.notes_root_local_hint` を手掛かりに `tool.release_notes` の相対名を読んでから作業する。既読の記録は `--mark-read --by <名前>` の明示時だけ。`tool.notes_reason` が `notes_directory_unavailable` なら、このインストールには読める docs がない。空の `release_notes` を「変更なし」と解釈しない。
 
 添付を付ける前に `tool.capabilities` を読む（媒体ごとの「出せるもの」表。`thth doctor` にも同じ表が出る。`unverified` は「非対応」ではない）。
@@ -152,6 +154,7 @@ MCP `after_you_posted`。**24h の刻みが無ければ `null`**（0 と混ぜ
 - 道具の不具合・欲しい形・迷ったことは `thth report file`（MCP `thth_report_file`）で実装側に届ける（小さいものも歓迎・重複は道具が束ねる）。
 - 承認済みなのに出ない原稿は `thth_observe` の予定の段 `held_items`（file・理由・予定・経過）と `thth board` の要確認（先頭 5 本）に名前が出る。`approval_stale` は再承認（`thth approve` の二段）で直る。時刻を過ぎて出られないものがあると `thth run` は `held` として死活通知と運用通知に知らせる。
 - 自分の開いている報告に書き足すなら `thth report add <report_id> --body-file <path|-> --by <名前>`（MCP `thth_report_add`）。
+- 他の媒体で試した施策と結果は `thth plaza list <project>`（MCP `thth_plaza_list`）で読める。試したら `thth plaza post`（MCP `thth_plaza_post`）で置く。
 - 使い方の全文: `docs/使い方_プロジェクトのセッション向け_2026-09-09.md`。
 
 ## 運用と分析のレポート（v3系・2.5.0 から）
@@ -168,7 +171,7 @@ MCP `after_you_posted`。**24h の刻みが無ければ `null`**（0 と混ぜ
 
 新規 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 を見る。
+プロジェクトの作業開始・再開時は `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 を手で消して再投稿しない（3.3.1 から道具が毎 run の最初に媒体へ 1 回だけ問い合わせ、決まれば自分で解く）。止まり続けるなら `thth inflight <account> show` で中身を見て、媒体で確かめた人が `thth inflight <account> resolve --not-published|--published <post_id> --by <名前>` で解く（二段確認・MCP には無い）。復旧状態は投稿成功の保証ではなく、公開結果は status/post_id/posted_at を見る。
 
 `mentions <account> --json` は 3 媒体の言及を同じ項目で読む。返信前に `replied` の object／false／null を区別する。`unanswered <account> --since 7d --json` は自分の根投稿の未回答候補を台帳で読む。`cannot_say` と採集の古さを確認し、`--refresh` は明示されたときだけ使う。件数は account ごとに扱い、送信は既存の承認・digest・production の門を通す。
 

{thth-3.3.0 → thth-3.4.0}/tests/conftest.py

@@ -67,6 +67,16 @@ def local_http_test_transport(monkeypatch):
                 opener.open('http://'+host,timeout=0.01)
 
 
+@pytest.fixture(autouse=True)
+def no_threads_status_poll_wait(monkeypatch):
+    """公開の結果が分からないときの container の問い合わせ（設計 3.3.1 §2）を
+    試験では待たない。本番の既定は 20 秒おき・最大 3 回。偽サーバは status の
+    GET に答えない（`query_failed`）ので、従前の試験の結果（inflight を残す）は
+    変わらない——変わるのは待つ時間だけ。subprocess の `bin/thth` にも env で届く。
+    """
+    monkeypatch.setenv('THTH_THREADS_STATUS_POLL_SECONDS', '0')
+
+
 @pytest.fixture(autouse=True)
 def frozen_now_jst(monkeypatch):
     """`thth.jst.now_jst()` を既定で静かな時間帯の外（2026-09-09 10:00 JST）に固定する。

thth-3.4.0/tests/helpers/fake_threads_status.py

@@ -0,0 +1,123 @@
+"""container の status を答える偽 Threads（設計 3.3.1 §6・**tests の中だけ**）。
+
+本物の Threads API には触らない。`http.server` で次の 4 つの口だけを真似る:
+
+- `POST /<user>/threads`         → container を作る（id は `CONTAINER_ID`）
+- `POST /<user>/threads_publish` → `script.publish` の先頭から 1 つずつ答える
+- `GET  /<container>`            → `script.status` の先頭から 1 つずつ（最後の 1 つは繰り返す）
+- `GET  /v1.0/<user>/threads`    → `script.posts`（自分の最近の投稿）
+
+何回呼ばれたかを数える（`publish_calls`・`status_calls`・`list_calls`）——
+「2 度出していない」を回数で確かめるため。
+"""
+from __future__ import annotations
+
+import contextlib
+import dataclasses
+import http.server
+import json
+import threading
+import urllib.parse
+
+from thth.adapters import threads as threads_mod
+
+USER_ID = "12345"
+CONTAINER_ID = "900"
+
+
+@dataclasses.dataclass
+class Script:
+    # 公開の答え: ("ok", id) / (500, None) / (400, None) / ("drop", None)（接続断）
+    publish: list = dataclasses.field(default_factory=lambda: [("ok", "777")])
+    # container の status の答え: "FINISHED" などの語 / 数字（HTTP の失敗）
+    status: list = dataclasses.field(default_factory=lambda: ["FINISHED"])
+    # 自分の最近の投稿（`GET /v1.0/<user>/threads` の data）
+    posts: list = dataclasses.field(default_factory=list)
+    list_status: int = 200
+    publish_calls: int = 0
+    status_calls: int = 0
+    list_calls: int = 0
+    create_calls: int = 0
+    # 公開の要求に載っていた creation_id（どの container を公開したか）。
+    publish_ids: list = dataclasses.field(default_factory=list)
+
+
+def _handler(script: Script):
+    class Handler(http.server.BaseHTTPRequestHandler):
+        def _json(self, code, payload):
+            body = json.dumps(payload).encode("utf-8")
+            self.send_response(code)
+            self.send_header("Content-Type", "application/json")
+            self.send_header("Content-Length", str(len(body)))
+            self.end_headers()
+            self.wfile.write(body)
+
+        def do_POST(self):  # noqa: N802
+            length = int(self.headers.get("Content-Length") or 0)
+            raw = self.rfile.read(length) if length else b""
+            if self.path.endswith("/threads_publish"):
+                script.publish_calls += 1
+                params = urllib.parse.parse_qs(raw.decode("utf-8"))
+                script.publish_ids.append((params.get("creation_id") or [None])[0])
+                kind, value = (script.publish.pop(0) if script.publish else (500, None))
+                if kind == "ok":
+                    self._json(200, {"id": value})
+                elif kind == "drop":
+                    # 応答を返さずに切る（接続断）。
+                    self.close_connection = True
+                    self.connection.close()
+                else:
+                    self._json(kind, {"error": {"message": "fake", "code": 1,
+                                                "is_transient": True}})
+                return
+            script.create_calls += 1
+            self._json(200, {"id": CONTAINER_ID})
+
+        def do_GET(self):  # noqa: N802
+            path = urllib.parse.urlsplit(self.path).path
+            if path == f"/v1.0/{USER_ID}/threads":
+                script.list_calls += 1
+                if script.list_status != 200:
+                    self._json(script.list_status, {"error": {"message": "fake"}})
+                    return
+                self._json(200, {"data": list(script.posts)})
+                return
+            if path == f"/{CONTAINER_ID}":
+                script.status_calls += 1
+                answer = script.status.pop(0) if len(script.status) > 1 else script.status[0]
+                if isinstance(answer, int):
+                    self._json(answer, {"error": {"message": "fake"}})
+                else:
+                    self._json(200, {"status": answer, "id": CONTAINER_ID})
+                return
+            self._json(404, {"error": {"message": "not found"}})
+
+        def log_message(self, format, *args):  # noqa: A002
+            pass
+
+    return Handler
+
+
+@contextlib.contextmanager
+def serve(script: Script):
+    server = http.server.HTTPServer(("127.0.0.1", 0), _handler(script))
+    thread = threading.Thread(target=server.serve_forever, daemon=True)
+    thread.start()
+    try:
+        yield f"http://127.0.0.1:{server.server_port}"
+    finally:
+        server.shutdown()
+        thread.join(timeout=5)
+
+
+def adapter(base_url: str, **kwargs) -> threads_mod.ThreadsAdapter:
+    kwargs.setdefault("wait_seconds", 0)
+    kwargs.setdefault("timeout", 2.0)
+    kwargs.setdefault("status_poll_seconds", 0)
+    return threads_mod.ThreadsAdapter(base_url=base_url, access_token="fake-token",
+                                       user_id=USER_ID, **kwargs)
+
+
+def post_row(post_id: str, text: str, timestamp: str) -> dict:
+    return {"id": post_id, "text": text, "timestamp": timestamp,
+            "permalink": f"https://www.threads.net/@x/post/{post_id}"}

{thth-3.3.0 → thth-3.4.0}/tests/test_admin_http_mcp.py

@@ -41,7 +41,10 @@ def test_admin_all_registry_and_mcp_auth_rechecked(credentials,monkeypatch):
         'thth_admin_inventory','thth_admin_account','thth_admin_diff','thth_admin_log',
         'thth_admin_tokens','thth_admin_release','thth_admin_budget_set','thth_admin_watch_set',
         # 報告の口の実装側（設計 3.1.2 §1）。
-        'thth_admin_reports_list','thth_admin_reports_show','thth_admin_reports_reply','thth_admin_reports_close'}
+        'thth_admin_reports_list','thth_admin_reports_show','thth_admin_reports_reply','thth_admin_reports_close',
+        # 施策の広場の管理者側（設計 3.4.0 §4）。
+        'thth_admin_plaza_list','thth_admin_plaza_show','thth_admin_plaza_join','thth_admin_plaza_leave',
+        'thth_admin_plaza_hide'}
     result=server.call_tool('thth_admin_inventory',{})
     assert set(json.loads(result['content'][0]['text'])['by_account'])=={'first','second'}
     assert server.call_tool('thth_admin_diff',{'mark_read':True})['isError']

{thth-3.3.0 → thth-3.4.0}/tests/test_incident_notifications.py

@@ -76,7 +76,8 @@ def test_git_roundtrip_preserves_original_and_deduplicates(setup):
     assert "thth_run_state: recovered" in s.path.read_text()
     assert len(s.captured) == 4
     assert incident._fingerprint(s.path) == before
-    assert len(row(s)["events"]) == 1
+    # 3.3.1 §5: 送り終えた事象も 30 日は残す（以前は 1 件に畳んでいた）。
+    assert len(row(s)["events"]) == 2
 
 
 def test_initial_success_is_quiet(setup):
@@ -99,7 +100,8 @@ def test_role_failure_retries_only_unfinished_and_other_role_gets_recovery(setup
     monkeypatch.setattr(incident, "_send", lambda c, r, e, a: calls.append((r, e["state"])) or True)
     notify(s, "success", result=False)
     assert calls[-2:] == [("user@example.org", "blocked"), ("user@example.org", "recovered")]
-    assert len(row(s)["events"]) == 1
+    # 3.3.1 §5: 送り終えた事象も 30 日は残す（以前は 1 件に畳んでいた）。
+    assert len(row(s)["events"]) == 2
 
 
 def test_same_address_single_message(setup):

{thth-3.3.0 → thth-3.4.0}/tests/test_site.py

@@ -251,8 +251,23 @@ def test_プライバシーポリシーは正本から生成され_外へ出る
                  "https://github.com/aokings/thth/issues"):
         assert must in page, must
     for obsolete in ("does not store, log, or transmit the code", "your own computer or server",
-                     "どこにも保存・記録・送信せず", "2026-09-15 施行"):
+                     "どこにも保存・記録・送信せず", "2026-09-15 施行",
+                     # 2026-09-23: 退出（thth account leave）と削除依頼の照合は実装済み。
+                     # 「後の版で実装」の文は実態と合わない（Platform Terms §7(a)）。
+                     "belong to a later implementation", "別の版で実装・検証する予定",
+                     "600,000"):
         assert obsolete not in page
+    # 2026-09-23 の書き直し（照合 論点 D）で書いた事実。どれもコードで裏を取った:
+    # 返信・言及は相手の username と本文ごと保存（collect.py）・検索結果は保存しない
+    # （where_cli.py・threads_read_cli.py）・退出（leave.py）・削除依頼（deletion.py）・
+    # 添付（media-object.js）・LLM への受け渡し（mcp/server.py）。英語と日本語の両方。
+    for must in ("the other person's username, the text", "相手のユーザー名・本文",
+                 "The text and authors of search results are not saved", "検索結果の本文と投稿者は保存しません",
+                 "thth account leave", "30 days", "24 hours after it was created",
+                 "THTH itself does not send data to an AI model provider",
+                 "THTH 自身は AI モデルの提供者へデータを送りません",
+                 "unverified, verified or completed", "未照合・照合済み・完了"):
+        assert must in page, must
     # 紹介ページから辿れる・robots は開いている
     index = (PUBLIC / "index.html").read_text(encoding="utf-8")
     assert 'href="/privacy/"' in index

{thth-3.3.0 → thth-3.4.0}/tests/test_v210_json_contract.py

@@ -30,7 +30,13 @@ COMMANDS = '''lint|preview|approve|account|revoke|posts|replies|measured|threads
      'observe',
      # 3.1.2: 報告の口（設計 3.1.2 §1）。
      'report file', 'report list', 'report show', 'report add', 'admin reports list', 'admin reports show',
-     'admin reports reply', 'admin reports close', 'admin reports export']
+     'admin reports reply', 'admin reports close', 'admin reports export',
+     # 3.3.1 §4: 人の口 thth inflight（show|resolve・--json）。
+     'inflight',
+     # 3.4.0 §4: 施策の広場（利用者と管理者の口・--json）。
+     'plaza post', 'plaza list', 'plaza show', 'plaza reply', 'plaza update',
+     'admin plaza join', 'admin plaza leave', 'admin plaza hide', 'admin plaza list',
+     'admin plaza show']
 
 
 def test_json_table_covers_every_parser():

{thth-3.3.0 → thth-3.4.0}/tests/test_v212_approval_relay.py

@@ -185,8 +185,11 @@ def test_provision_network_does_not_hold_global_admin_flock(isolated,monkeypatch
 def test_privacy_logical_ttl_and_no_physical_erase_claim():
     from tests.test_site import build_site
     page=build_site.build_privacy()
-    for phrase in ('600 seconds','600秒','600,000','PITR','30 days','30日','not a promise of immediate physical erasure','即時物理消去とは約束しません'):
+    # 100,000: the Worker's WebCrypto caps PBKDF2 at 100,000 (callback/src/approval.js ITERATIONS,
+    # thth/approval_relay.py ITERATIONS). The page said 600,000 until the 2026-09-23 rewrite.
+    for phrase in ('600 seconds','600秒','100,000','PITR','30 days','30日','not a promise of immediate physical erasure','即時物理消去とは約束しません'):
         assert phrase in page
+    assert '600,000' not in page
 
 
 def test_project_key_store_refused_without_traceback(isolated,monkeypatch,capsys):

thth-3.4.0/tests/test_v331_inflight_cli.py

@@ -0,0 +1,156 @@
+"""3.3.1 §4: `thth inflight <account> [show|resolve] --by <名前>`（人の口）。
+
+09-23 に masaru が `inflight.json` を手で消した操作の代わり。二段確認・控え
+（`inflight.resolved-<日時>.json`）・変更ログ `inflight_resolved`。MCP には出さない。
+"""
+from __future__ import annotations
+
+import datetime
+import importlib.util
+import json
+import os
+import pathlib
+
+from tests.conftest import init_git_pair, make_queue_text, write_queue_file
+from tests.helpers import fake_threads_status as fake
+from thth import accounts as accounts_mod
+from thth import admin_log
+from thth import cli
+from thth import core
+from thth import inflight as inflight_mod
+from thth import inflight_cli
+from thth import queuefile
+from thth import runs as runs_mod
+
+NOW = datetime.datetime.fromisoformat("2026-09-09T10:00:00+09:00")
+REPO = pathlib.Path(__file__).resolve().parent.parent
+
+
+def _stuck(isolated_account_factory, tmp_path, *, git=True):
+    if git:
+        pair = init_git_pair(tmp_path, seed_content=make_queue_text(), seed_name="a.md")
+        account = isolated_account_factory(repo_dir=pair["work"], production=True)
+    else:
+        account = isolated_account_factory(production=True)
+        write_queue_file(account["queue_dir"], "a.md")
+    script = fake.Script(publish=[(500, None)], status=[503])
+    with fake.serve(script) as base_url:
+        result = core.throw_once(account["name"], production_flag=True,
+                                 adapter_factory=lambda c, t: fake.adapter(base_url), now=NOW)
+    assert result.action == "inflight"
+    return account, accounts_mod.state_dir_for(account["name"])
+
+
+def _cli(capsys, *argv):
+    rc = cli.main(["inflight", *argv])
+    out = capsys.readouterr()
+    return rc, out.out, out.err
+
+
+def _digest_from(out):
+    return next(line.split(": ", 1)[1] for line in out.splitlines() if line.startswith("digest: "))
+
+
+def test_showは中身を出すが本文とtokenとcontainer_idは出さない(isolated_account_factory, tmp_path, capsys):
+    account, state_dir = _stuck(isolated_account_factory, tmp_path)
+    rc, out, _ = _cli(capsys, account["name"], "show")
+    assert rc == 0
+    assert "a.md" in out and "container_id: あり" in out and "query_failed" in out
+    assert "本文です" not in out and "fake-token" not in out and fake.CONTAINER_ID not in out
+    rc, out, _ = _cli(capsys, account["name"], "show", "--json")
+    info = json.loads(out)["inflight"]
+    assert info["container_id_present"] is True and info["remote_state"] == "query_failed"
+    assert info["post_id_present"] is False and info["self_resolvable"] is True
+
+
+def test_showはinflightが無ければそう言う(isolated_account_factory, capsys):
+    account = isolated_account_factory()
+    rc, out, _ = _cli(capsys, account["name"])
+    assert rc == 0 and "inflight はありません" in out
+
+
+def test_resolve_not_publishedの往復_二段確認と控えと変更ログ(isolated_account_factory, tmp_path, capsys):
+    account, state_dir = _stuck(isolated_account_factory, tmp_path, git=False)
+    before = inflight_mod.read(state_dir)
+    # 一段目: 何もしない。
+    rc, out, _ = _cli(capsys, account["name"], "resolve", "--not-published", "--by", "masaru")
+    assert rc == 1 and "解きません" in out
+    assert inflight_mod.read(state_dir) == before
+    code = _digest_from(out)
+    # 二段目。
+    rc, out, _ = _cli(capsys, account["name"], "resolve", "--not-published", "--by", "masaru",
+                      "--confirm", code)
+    assert rc == 0, out
+    assert inflight_mod.read(state_dir) is None
+    archives = inflight_mod.archives(state_dir)
+    assert len(archives) == 1
+    saved = json.loads(open(archives[0], encoding="utf-8").read())
+    assert saved["resolved_by"] == "masaru" and saved["resolution"] == "human_not_published"
+    assert saved["inflight"]["started"] == before["started"]
+    assert os.stat(archives[0]).st_mode & 0o777 == 0o600
+    rows, broken = admin_log.read(account=account["name"], event="inflight_resolved")
+    assert len(rows) == 1 and rows[0]["by"] == "masaru" and not broken
+    runs = [r for r in runs_mod.read_runs(state_dir) if r.get("inflight_resolution")]
+    assert runs[-1]["inflight_resolution"] == "human_not_published"
+    # 原稿は approved のまま（次の run が出し直す）。
+    qf = queuefile.parse(os.path.join(account["queue_dir"], "a.md"))
+    assert qf.get("status") == "approved"
+
+
+def test_resolve_publishedは書き戻して解く(isolated_account_factory, tmp_path, capsys):
+    account, state_dir = _stuck(isolated_account_factory, tmp_path)
+    rc, out, _ = _cli(capsys, account["name"], "resolve", "--published", "8001", "--by", "masaru")
+    assert rc == 1
+    rc, out, err = _cli(capsys, account["name"], "resolve", "--published", "8001", "--by", "masaru",
+                        "--confirm", _digest_from(out))
+    assert rc == 0, err
+    assert inflight_mod.read(state_dir) is None
+    qf = queuefile.parse(os.path.join(account["queue_dir"], "a.md"))
+    assert qf.get("status") == "posted" and str(qf.get("post_id")) == "8001"
+    assert len(inflight_mod.archives(state_dir)) == 1
+    rows, _ = admin_log.read(account=account["name"], event="inflight_resolved")
+    assert rows[-1]["diff"]["resolution"] == [None, "human_published"]
+
+
+def test_digestが違えば解かない_別のinflightには流用できない(isolated_account_factory, tmp_path, capsys):
+    account, state_dir = _stuck(isolated_account_factory, tmp_path, git=False)
+    rc, out, _ = _cli(capsys, account["name"], "resolve", "--not-published", "--by", "masaru")
+    code = _digest_from(out)
+    inflight_mod.update(state_dir, started="2026-09-09T11:00:00+09:00")
+    rc, _, err = _cli(capsys, account["name"], "resolve", "--not-published", "--by", "masaru",
+                      "--confirm", code)
+    assert rc == 1 and "confirm_mismatch" in err
+    assert inflight_mod.read(state_dir) is not None and inflight_mod.archives(state_dir) == []
+
+
+def test_byと決めることが無ければ断る(isolated_account_factory, tmp_path, capsys, monkeypatch):
+    monkeypatch.delenv("THTH_ACTOR", raising=False)
+    account, state_dir = _stuck(isolated_account_factory, tmp_path, git=False)
+    rc, _, err = _cli(capsys, account["name"], "resolve", "--not-published")
+    assert rc == 1 and err.startswith("by_required")
+    rc, _, err = _cli(capsys, account["name"], "resolve", "--by", "masaru")
+    assert rc == 1 and err.startswith("decision_required")
+    assert inflight_mod.read(state_dir) is not None
+
+
+def test_出たと分かっているinflightはnot_publishedで解かない(isolated_account_factory, tmp_path, capsys):
+    account, state_dir = _stuck(isolated_account_factory, tmp_path, git=False)
+    inflight_mod.update(state_dir, post_id="8002")
+    rc, _, err = _cli(capsys, account["name"], "resolve", "--not-published", "--by", "masaru")
+    assert rc == 1 and err.startswith("published_known")
+    rc, _, err = _cli(capsys, account["name"], "resolve", "--published", "9999", "--by", "masaru")
+    assert rc == 1 and err.startswith("post_id_differs")
+
+
+def test_添付のinflightはこの口では解かない(isolated_account_factory, tmp_path, capsys):
+    account, state_dir = _stuck(isolated_account_factory, tmp_path, git=False)
+    record = inflight_mod.read(state_dir)
+    info = inflight_cli.summary({**record, "media": {"account": account["name"]}})
+    assert info["media"] is True and info["self_resolvable"] is False
+
+
+def test_mcpにはinflightの口が無い():
+    spec = importlib.util.spec_from_file_location("thth_mcp_server", REPO / "mcp" / "server.py")
+    server = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(server)
+    assert not any("inflight" in tool["name"] for tool in server.TOOLS)