thth 2.0.0__tar.gz → 2.2.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: thth
-Version: 2.0.0
+Version: 2.2.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.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)。
+**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)。
 
-`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`）。
+`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`）。
 
 **`main` への push は保存だけ。`release` を進める操作が配布**（VM は `release` だけを追う。設計 §3.2.1）。
 
@@ -45,7 +45,7 @@ watchtower（`~/Developer/watchtower`）の隣に同じ流儀で並べる。watc
 
 ## いまの状態（2026-09-13）
 
-版 **2.0.0**。全件テスト **1828 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。
+版 **2.2.0**。全件テスト **2196 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。
 
 **媒体**: Threads（稼働）・Bluesky・Mastodon（同席用の台帳あり・未稼働）。
 
@@ -55,14 +55,16 @@ timer（systemd・`thth systemd` で生成）で毎時投稿、返信の採集
 
 **入口は 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 の手で、まだしていない**）。
+**依存 0**。PyPI に公開済み・MCP registry に `io.github.aokings/thth` として登録済み）。
 
 **トピックの棚**（`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 を止めないため）。
+  **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`**）。
@@ -85,7 +87,7 @@ timer（systemd・`thth systemd` で生成）で毎時投稿、返信の採集
 - **最初の本番投稿の記録**: 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` を進める操作。
+- **masaru の手が要るもの**: repo を public にする切替と `LICENSE`、tag と `release` を進める操作（PyPI と MCP registry は 2.0.1 まで公開済み）。
 
 ## MCP registry
 

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

@@ -9,9 +9,9 @@ watchtower（`~/Developer/watchtower`）の隣に同じ流儀で並べる。watc
 
 ## 版
 
-**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)。
+**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)。
 
-`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`）。
+`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`）。
 
 **`main` への push は保存だけ。`release` を進める操作が配布**（VM は `release` だけを追う。設計 §3.2.1）。
 
@@ -21,7 +21,7 @@ watchtower（`~/Developer/watchtower`）の隣に同じ流儀で並べる。watc
 
 ## いまの状態（2026-09-13）
 
-版 **2.0.0**。全件テスト **1828 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。
+版 **2.2.0**。全件テスト **2196 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。
 
 **媒体**: Threads（稼働）・Bluesky・Mastodon（同席用の台帳あり・未稼働）。
 
@@ -31,14 +31,16 @@ timer（systemd・`thth systemd` で生成）で毎時投稿、返信の採集
 
 **入口は 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 の手で、まだしていない**）。
+**依存 0**。PyPI に公開済み・MCP registry に `io.github.aokings/thth` として登録済み）。
 
 **トピックの棚**（`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 を止めないため）。
+  **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`**）。
@@ -61,7 +63,7 @@ timer（systemd・`thth systemd` で生成）で毎時投稿、返信の採集
 - **最初の本番投稿の記録**: 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` を進める操作。
+- **masaru の手が要るもの**: repo を public にする切替と `LICENSE`、tag と `release` を進める操作（PyPI と MCP registry は 2.0.1 まで公開済み）。
 
 ## MCP registry
 

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

@@ -142,6 +142,135 @@ TOOLS = [
 ]
 
 
+class ToolInputError(Exception):
+    """要求が受け取れない（JSON-RPC `-32602`・セキュリティ監査 2026-09-14・P2-1）。
+
+    **落ちない・黙らない。** 以前は `arguments["file"]` の `KeyError` や
+    `params` が list のときの `AttributeError` が `main()` のループの外まで抜けて、
+    **サーバが死んでいた**——クライアントから見ると応答が来ないまま接続が切れる
+    （どの要求が悪かったのかも判らない）。1 要求の失敗は 1 要求の error で返し、
+    ループは続ける。
+    """
+
+
+def _schema_for(name):
+    for tool in TOOLS:
+        if tool["name"] == name:
+            return tool.get("inputSchema") or {}
+    return None
+
+
+# `inputSchema` の `type` を Python の型に写す。**`bool` は `int` の子**なので、
+# 整数の検査から明示的に外す（`True` を `window_days` に通さない）。
+_TYPES = {
+    "string": ((str,), "文字列"),
+    "object": ((dict,), "object"),
+    "boolean": ((bool,), "真偽値"),
+    "integer": ((int,), "整数"),
+    "number": ((int, float), "数"),
+}
+
+
+def ledger_roots() -> list:
+    """台帳の `repo_dir` の realpath 一覧（`file` 引数の**唯一の行き先**）。
+
+    セキュリティ監査 2026-09-14・P2-3。`thth_preview`・`thth_lint`・
+    `thth_topic_context` の `file` は**どこでも指せた**——MCP を持つ LLM が
+    `/etc/passwd` や `~/.config/thth/*.token` を渡せば、`thth preview` は
+    front-matter が読めないと言うだけだが、**`thth lint` は中身の断片を返す**。
+    読むだけの道具でも、読む先は縛る。
+
+    `queue_dir` は台帳で `repo_dir` からの相対なので、`repo_dir` の下で足りる。
+    """
+    try:
+        if APP_DIR not in sys.path:
+            sys.path.insert(0, APP_DIR)
+        from thth import accounts as accounts_mod
+    except ImportError:
+        return []
+    try:
+        names = accounts_mod.list_account_names()
+    except Exception:                              # noqa: BLE001（台帳が読めない）
+        return []
+    roots = []
+    for account in names:
+        try:
+            cfg = accounts_mod.load_account(account)
+        except Exception:                          # noqa: BLE001（1 本壊れていても続ける）
+            continue
+        # **正規の函数を通す**（監査 2026-09-16）。ここが台帳の `repo_dir` を
+        # 生のまま `os.path.realpath()` していたので、相対パスは**この
+        # プロセスの cwd** 基準で畳まれていた。`thth/accounts.py::resolved_repo_dir()`
+        # は `$THTH_ROOT` 基準——**同じ台帳で許可する場所が MCP だけ食い違って
+        # いた**（cwd は systemd 経由なら `/`、手で打てば人それぞれ）。
+        repo_dir = accounts_mod.resolved_repo_dir(cfg)
+        if repo_dir:
+            roots.append(os.path.realpath(repo_dir))
+    return roots
+
+
+def check_file_argument(name: str, path: str) -> None:
+    """`file` は**台帳のどれかの `repo_dir` の下**だけ（外れれば `ToolInputError`）。
+
+    `realpath` してから比べる（symlink・`..`・相対パスを畳んでから見る）。
+    """
+    real = os.path.realpath(path)
+    roots = ledger_roots()
+    for root in roots:
+        if real == root or real.startswith(root + os.sep):
+            return
+    raise ToolInputError(
+        f"{name}: file は台帳の repo_dir の中のパスだけを渡してください"
+        f"（受け取ったものはどの repo_dir にも入っていません）")
+
+
+def validate_arguments(name: str, arguments) -> dict:
+    """道具の `inputSchema` どおりの引数か。違えば `ToolInputError`。
+
+    見るのは 3 つだけ: **object であること**・**必須が揃っていること**・
+    **型が合っていること**（知らない鍵も断る——綴りを間違えたまま既定値で
+    動いたことにしない）。判断はしない（中身の意味は CLI の仕事）。
+    """
+    schema = _schema_for(name)
+    if schema is None:
+        return {}                     # 知らない道具は `call_tool()` が断る
+    if arguments is None:
+        arguments = {}
+    if not isinstance(arguments, dict):
+        raise ToolInputError(
+            f"{name}: arguments は object で渡してください"
+            f"（受け取った: {type(arguments).__name__}）")
+    props = schema.get("properties") or {}
+    for key in schema.get("required") or []:
+        if arguments.get(key) is None:
+            raise ToolInputError(f"{name}: 必須の引数がありません: {key}")
+    for key, value in arguments.items():
+        spec = props.get(key)
+        if spec is None:
+            raise ToolInputError(f"{name}: 知らない引数です: {key}")
+        if value is None:
+            continue
+        types, 名 = _TYPES.get(spec.get("type"), ((object,), "値"))
+        if spec.get("type") == "integer" and isinstance(value, bool):
+            raise ToolInputError(f"{name}: {key} は{名}で渡してください（受け取った: bool）")
+        if not isinstance(value, types):
+            raise ToolInputError(
+                f"{name}: {key} は{名}で渡してください"
+                f"（受け取った: {type(value).__name__}）")
+        # **位置引数に渡る値が `-` で始まらない**（監査 2026-09-14・P3-2）。
+        # `run_cli()` は値を argv の位置に置く。`--json` のような綴りを渡されると
+        # **CLI の別の旗として読まれる**（`thth lint --help` のように無害な形も
+        # あるが、旗の意味は CLI 側の都合で増える）。`--` を足して黙って通すより、
+        # **受け取れないものとして断る**（作法 5）。
+        if isinstance(value, str) and value.startswith("-"):
+            raise ToolInputError(
+                f"{name}: {key} が `-` で始まっています（{value!r}）。"
+                f"CLI の旗と区別できないので受け取りません")
+        if key == "file":
+            check_file_argument(name, value)
+    return arguments
+
+
 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"]
@@ -235,10 +364,32 @@ def _send(obj: dict) -> None:
     sys.stdout.flush()
 
 
+def _error(req_id, code: int, message: str) -> dict:
+    return {"jsonrpc": "2.0", "id": req_id,
+            "error": {"code": code, "message": message}}
+
+
+def _is_notification(req: dict) -> bool:
+    """JSON-RPC の**通知**（`id` を持たない要求）か。
+
+    監査 2 回目・P3-6。**通知には応答を返してはいけない**（JSON-RPC 2.0 §4.1）。
+    `notifications/initialized` だけを名前で特定して黙っていたので、
+    **`id` の無い `tools/call` には結果を、`id` の無い未知の method には
+    エラーを返していた**——`"id": null` を付けた応答は仕様違反で、厳密な
+    クライアントは接続を切る。**名前ではなく形で決める。**
+    """
+    return "id" not in req
+
+
 def _handle_request(req: dict):
     method = req.get("method")
     req_id = req.get("id")
 
+    if _is_notification(req):
+        # **通知は黙って処理する**（応答を作らない）。いまのところ中身のある
+        # 通知は `notifications/initialized` だけで、それも何もしない。
+        return None
+
     if method == "initialize":
         return {
             "jsonrpc": "2.0", "id": req_id,
@@ -254,25 +405,69 @@ def _handle_request(req: dict):
         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"))
+        if not isinstance(params, dict):
+            raise ToolInputError(
+                f"params は object で渡してください（受け取った: {type(params).__name__}）")
+        name = params.get("name")
+        if not isinstance(name, str) or not name:
+            raise ToolInputError("params.name（道具の名前）が要ります")
+        arguments = validate_arguments(name, params.get("arguments"))
+        result = call_tool(name, 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 _error(req_id, -32601, f"method not found: {method}")
     return None
 
 
 def main() -> None:
+    """1 行 1 要求のループ。**1 件の失敗でループを降りない**（監査 2026-09-14・P2-1）。
+
+    以前は `_handle_request()` の中で上がった例外がここまで抜けてサーバが死んで
+    いた（`arguments` に `file` が無い `KeyError`・`params` が list のときの
+    `AttributeError`）。クライアントから見ると応答が来ないまま口が閉じる——
+    **どの要求が悪かったのかも判らない。** 1 要求の失敗は 1 要求の error にして、
+    次の要求は今までどおり受ける。
+    """
     for line in sys.stdin:
         line = line.strip()
         if not line:
             continue
         try:
             req = json.loads(line)
-        except json.JSONDecodeError:
+        except (ValueError, RecursionError):
+            # **`json.JSONDecodeError` だけでは足りない**（監査 2026-09-16）。
+            # `json.JSONDecodeError` は `ValueError` の子だが、Python 3.12 は
+            # 4300 桁を超える整数で別の `ValueError`
+            # （"Exceeds the limit (4300 digits) for integer string conversion"）
+            # を上げる——`except json.JSONDecodeError` だけではここが漏れて
+            # プロセスが死ぬ。深い入れ子（`[` の連続）の `RecursionError` も同じ
+            # 筋で、ここでしか捕まえられない。**id が判らないので返しようがない**
+            # （JSON-RPC も id:null を許すが、従来どおり黙って次の行へ・方針は
+            # 変えない）。
+            continue
+        if isinstance(req, list):
+            # **batch（配列）は受けない。** 受けたふりをして 1 件目だけ処理する
+            # と、残りが黙って消える（`-32600 Invalid Request`）。
+            _send(_error(None, -32600,
+                         "batch（配列）の要求は受け付けません。1 行 1 要求で送ってください"))
             continue
-        resp = _handle_request(req)
-        if resp is not None:
+        if not isinstance(req, dict):
+            _send(_error(None, -32600,
+                         f"要求は object で送ってください（受け取った: {type(req).__name__}）"))
+            continue
+        req_id = req.get("id")
+        try:
+            resp = _handle_request(req)
+        except ToolInputError as e:
+            resp = _error(req_id, -32602, str(e))
+        except Exception as e:                      # noqa: BLE001
+            # **死なない。** 想定していない失敗も 1 要求の error にして次へ。
+            resp = _error(req_id, -32602, f"{type(e).__name__}: {e}")
+        # **通知には何も返さない**（監査 2 回目・P3-6）。失敗しても同じ——
+        # 返す先の `id` が無いので、`"id": null` の error を送ることになる
+        # （JSON-RPC 2.0 §4.1 違反・厳密なクライアントは接続を切る）。
+        # **死なないことと、黙ることは両立する。**
+        if resp is not None and not _is_notification(req):
             _send(resp)
 
 

{thth-2.0.0 → thth-2.2.0}/tests/conftest.py

@@ -278,8 +278,10 @@ def make_account_json(accounts_dir: str, name: str, *, repo_dir: str, **override
 def isolated_account_factory(thth_root, nigamilab_repo, monkeypatch):
     """`isolated_account` の中身をテストごとの台帳上書きに対応させたファクトリ。
 
-    `thth.accounts.APP_DIR` を差し替えて、実物の `accounts/nigamilab-threads.json`
-    （repo_dir が `$THTH_ROOT/repos/nigamilab` の実運用値）を汚さずにテストする。
+    `thth.accounts.APP_DIR` を差し替えて、**打った人の実物の台帳**
+    （`$THTH_ROOT/accounts/*.json`・repo_dir が実クローンを指している）を
+    読みにも書きにも行かせない。repo に台帳は無い（2026-09-14 に 6 本を
+    `git rm`・設計 v2 §3）が、`THTH_ROOT` を向け損ねれば実物に届いてしまう。
     """
     import thth.accounts as accounts_mod
 

thth-2.2.0/tests/fixtures/callback/worker_responses.json

@@ -0,0 +1,109 @@
+[
+  {
+    "url": "https://thth.me/callback/",
+    "status": 200,
+    "headers": {
+      "cache-control": "no-store",
+      "content-type": "text/html; charset=utf-8",
+      "referrer-policy": "no-referrer",
+      "x-robots-tag": "noindex, nofollow"
+    },
+    "body": "<!doctype html>\n<html lang=\"ja\"><head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<meta name=\"robots\" content=\"noindex,nofollow,noarchive\">\n<title>THTH 認可の受け口</title>\n<style>\n  :root { color-scheme: light dark; }\n  body { margin:0; min-height:100vh; display:flex; align-items:center; justify-content:center;\n         font: 16px/1.7 -apple-system, BlinkMacSystemFont, \"Hiragino Sans\", \"Noto Sans JP\", sans-serif;\n         background:#faf9f7; color:#1a1a1a; padding:24px; }\n  @media (prefers-color-scheme: dark) { body { background:#16161a; color:#eee; } }\n  main { max-width: 640px; width:100%; }\n  h1 { font-size:1.15rem; font-weight:600; margin:0 0 4px; letter-spacing:.02em; }\n  .sub { font-size:.85rem; opacity:.65; margin:0 0 24px; }\n  .code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size:.95rem;\n          word-break:break-all; background:rgba(127,127,127,.12); border-radius:10px;\n          padding:16px; margin:0 0 12px; user-select:all; }\n  button { font:inherit; font-size:.9rem; padding:9px 18px; border-radius:8px; cursor:pointer;\n           border:1px solid rgba(127,127,127,.4); background:transparent; color:inherit; }\n  button:hover { background:rgba(127,127,127,.12); }\n  .note { font-size:.85rem; opacity:.7; margin-top:20px; }\n  .err { color:#b3261e; } @media (prefers-color-scheme: dark) { .err { color:#f2b8b5; } }\n</style></head><body><main><h1>THTH</h1>\n     <p class=\"sub\">Threads の認可の受け口です。ここを直接開いても何もありません。</p>\n     <p class=\"note\">ターミナルで <code>thth auth &lt;account&gt;</code> を実行すると、\n     認可 URL が表示されます。承認するとこのページに戻ってくるので、\n     表示された <strong>URL 全体</strong>をターミナルに貼ります。</p></main></body></html>"
+  },
+  {
+    "url": "https://thth.me/callback",
+    "status": 200,
+    "headers": {
+      "cache-control": "no-store",
+      "content-type": "text/html; charset=utf-8",
+      "referrer-policy": "no-referrer",
+      "x-robots-tag": "noindex, nofollow"
+    },
+    "body": "<!doctype html>\n<html lang=\"ja\"><head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<meta name=\"robots\" content=\"noindex,nofollow,noarchive\">\n<title>THTH 認可の受け口</title>\n<style>\n  :root { color-scheme: light dark; }\n  body { margin:0; min-height:100vh; display:flex; align-items:center; justify-content:center;\n         font: 16px/1.7 -apple-system, BlinkMacSystemFont, \"Hiragino Sans\", \"Noto Sans JP\", sans-serif;\n         background:#faf9f7; color:#1a1a1a; padding:24px; }\n  @media (prefers-color-scheme: dark) { body { background:#16161a; color:#eee; } }\n  main { max-width: 640px; width:100%; }\n  h1 { font-size:1.15rem; font-weight:600; margin:0 0 4px; letter-spacing:.02em; }\n  .sub { font-size:.85rem; opacity:.65; margin:0 0 24px; }\n  .code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size:.95rem;\n          word-break:break-all; background:rgba(127,127,127,.12); border-radius:10px;\n          padding:16px; margin:0 0 12px; user-select:all; }\n  button { font:inherit; font-size:.9rem; padding:9px 18px; border-radius:8px; cursor:pointer;\n           border:1px solid rgba(127,127,127,.4); background:transparent; color:inherit; }\n  button:hover { background:rgba(127,127,127,.12); }\n  .note { font-size:.85rem; opacity:.7; margin-top:20px; }\n  .err { color:#b3261e; } @media (prefers-color-scheme: dark) { .err { color:#f2b8b5; } }\n</style></head><body><main><h1>THTH</h1>\n     <p class=\"sub\">Threads の認可の受け口です。ここを直接開いても何もありません。</p>\n     <p class=\"note\">ターミナルで <code>thth auth &lt;account&gt;</code> を実行すると、\n     認可 URL が表示されます。承認するとこのページに戻ってくるので、\n     表示された <strong>URL 全体</strong>をターミナルに貼ります。</p></main></body></html>"
+  },
+  {
+    "url": "https://thth.me/callback/?code=FAKE-CODE-abc123&state=FAKE-STATE-xyz",
+    "status": 200,
+    "headers": {
+      "cache-control": "no-store",
+      "content-type": "text/html; charset=utf-8",
+      "referrer-policy": "no-referrer",
+      "x-robots-tag": "noindex, nofollow"
+    },
+    "body": "<!doctype html>\n<html lang=\"ja\"><head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<meta name=\"robots\" content=\"noindex,nofollow,noarchive\">\n<title>THTH 認可の受け口</title>\n<style>\n  :root { color-scheme: light dark; }\n  body { margin:0; min-height:100vh; display:flex; align-items:center; justify-content:center;\n         font: 16px/1.7 -apple-system, BlinkMacSystemFont, \"Hiragino Sans\", \"Noto Sans JP\", sans-serif;\n         background:#faf9f7; color:#1a1a1a; padding:24px; }\n  @media (prefers-color-scheme: dark) { body { background:#16161a; color:#eee; } }\n  main { max-width: 640px; width:100%; }\n  h1 { font-size:1.15rem; font-weight:600; margin:0 0 4px; letter-spacing:.02em; }\n  .sub { font-size:.85rem; opacity:.65; margin:0 0 24px; }\n  .code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size:.95rem;\n          word-break:break-all; background:rgba(127,127,127,.12); border-radius:10px;\n          padding:16px; margin:0 0 12px; user-select:all; }\n  button { font:inherit; font-size:.9rem; padding:9px 18px; border-radius:8px; cursor:pointer;\n           border:1px solid rgba(127,127,127,.4); background:transparent; color:inherit; }\n  button:hover { background:rgba(127,127,127,.12); }\n  .note { font-size:.85rem; opacity:.7; margin-top:20px; }\n  .err { color:#b3261e; } @media (prefers-color-scheme: dark) { .err { color:#f2b8b5; } }\n</style></head><body><main><h1>認可コードを受け取りました</h1>\n       <p class=\"sub\">下の <strong>URL 全体</strong>をターミナルに貼ってください\n       （<code>code</code> だけでは足りません）。1 時間で切れる使い捨てです。</p>\n       <p class=\"code\" id=\"c\">https://thth.me/callback/?code=FAKE-CODE-abc123&amp;state=FAKE-STATE-xyz</p>\n       <button id=\"b\">コピー</button>\n       \n       <p class=\"note\">この画面は撮らないでください。貼り終えたら閉じて構いません。</p>\n       <script>\n         // アドレスバーからコードを消す（撮影・肩越しの覗き見への備え）。\n         try { history.replaceState(null, \"\", location.pathname); } catch (e) {}\n         document.getElementById(\"b\").onclick = async () => {\n           try {\n             await navigator.clipboard.writeText(document.getElementById(\"c\").textContent);\n             document.getElementById(\"b\").textContent = \"コピーしました\";\n           } catch (e) { document.getElementById(\"b\").textContent = \"手で選んでコピーしてください\"; }\n         };\n       </script></main></body></html>"
+  },
+  {
+    "url": "https://thth.me/callback/?code=FAKE-CODE-abc123",
+    "status": 200,
+    "headers": {
+      "cache-control": "no-store",
+      "content-type": "text/html; charset=utf-8",
+      "referrer-policy": "no-referrer",
+      "x-robots-tag": "noindex, nofollow"
+    },
+    "body": "<!doctype html>\n<html lang=\"ja\"><head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<meta name=\"robots\" content=\"noindex,nofollow,noarchive\">\n<title>THTH 認可の受け口</title>\n<style>\n  :root { color-scheme: light dark; }\n  body { margin:0; min-height:100vh; display:flex; align-items:center; justify-content:center;\n         font: 16px/1.7 -apple-system, BlinkMacSystemFont, \"Hiragino Sans\", \"Noto Sans JP\", sans-serif;\n         background:#faf9f7; color:#1a1a1a; padding:24px; }\n  @media (prefers-color-scheme: dark) { body { background:#16161a; color:#eee; } }\n  main { max-width: 640px; width:100%; }\n  h1 { font-size:1.15rem; font-weight:600; margin:0 0 4px; letter-spacing:.02em; }\n  .sub { font-size:.85rem; opacity:.65; margin:0 0 24px; }\n  .code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size:.95rem;\n          word-break:break-all; background:rgba(127,127,127,.12); border-radius:10px;\n          padding:16px; margin:0 0 12px; user-select:all; }\n  button { font:inherit; font-size:.9rem; padding:9px 18px; border-radius:8px; cursor:pointer;\n           border:1px solid rgba(127,127,127,.4); background:transparent; color:inherit; }\n  button:hover { background:rgba(127,127,127,.12); }\n  .note { font-size:.85rem; opacity:.7; margin-top:20px; }\n  .err { color:#b3261e; } @media (prefers-color-scheme: dark) { .err { color:#f2b8b5; } }\n</style></head><body><main><h1>認可コードを受け取りました</h1>\n       <p class=\"sub\">下の <strong>URL 全体</strong>をターミナルに貼ってください\n       （<code>code</code> だけでは足りません）。1 時間で切れる使い捨てです。</p>\n       <p class=\"code\" id=\"c\">https://thth.me/callback/?code=FAKE-CODE-abc123</p>\n       <button id=\"b\">コピー</button>\n       <p class=\"note err\">state が付いていません。この戻りは <code>thth auth</code> に\n         受け付けられません（もう一度 <code>thth auth</code> から始めてください）。</p>\n       <p class=\"note\">この画面は撮らないでください。貼り終えたら閉じて構いません。</p>\n       <script>\n         // アドレスバーからコードを消す（撮影・肩越しの覗き見への備え）。\n         try { history.replaceState(null, \"\", location.pathname); } catch (e) {}\n         document.getElementById(\"b\").onclick = async () => {\n           try {\n             await navigator.clipboard.writeText(document.getElementById(\"c\").textContent);\n             document.getElementById(\"b\").textContent = \"コピーしました\";\n           } catch (e) { document.getElementById(\"b\").textContent = \"手で選んでコピーしてください\"; }\n         };\n       </script></main></body></html>"
+  },
+  {
+    "url": "https://thth.me/callback/?error=access_denied&error_description=The+user+denied+your+request",
+    "status": 200,
+    "headers": {
+      "cache-control": "no-store",
+      "content-type": "text/html; charset=utf-8",
+      "referrer-policy": "no-referrer",
+      "x-robots-tag": "noindex, nofollow"
+    },
+    "body": "<!doctype html>\n<html lang=\"ja\"><head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<meta name=\"robots\" content=\"noindex,nofollow,noarchive\">\n<title>THTH 認可の受け口</title>\n<style>\n  :root { color-scheme: light dark; }\n  body { margin:0; min-height:100vh; display:flex; align-items:center; justify-content:center;\n         font: 16px/1.7 -apple-system, BlinkMacSystemFont, \"Hiragino Sans\", \"Noto Sans JP\", sans-serif;\n         background:#faf9f7; color:#1a1a1a; padding:24px; }\n  @media (prefers-color-scheme: dark) { body { background:#16161a; color:#eee; } }\n  main { max-width: 640px; width:100%; }\n  h1 { font-size:1.15rem; font-weight:600; margin:0 0 4px; letter-spacing:.02em; }\n  .sub { font-size:.85rem; opacity:.65; margin:0 0 24px; }\n  .code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size:.95rem;\n          word-break:break-all; background:rgba(127,127,127,.12); border-radius:10px;\n          padding:16px; margin:0 0 12px; user-select:all; }\n  button { font:inherit; font-size:.9rem; padding:9px 18px; border-radius:8px; cursor:pointer;\n           border:1px solid rgba(127,127,127,.4); background:transparent; color:inherit; }\n  button:hover { background:rgba(127,127,127,.12); }\n  .note { font-size:.85rem; opacity:.7; margin-top:20px; }\n  .err { color:#b3261e; } @media (prefers-color-scheme: dark) { .err { color:#f2b8b5; } }\n</style></head><body><main><h1>認可されませんでした</h1>\n       <p class=\"sub\">Threads 側から次の理由が返りました。</p>\n       <p class=\"code err\">access_denied — The user denied your request</p>\n       <p class=\"note\">ターミナルに戻って <code>thth auth</code> をやり直してください。</p></main></body></html>"
+  },
+  {
+    "url": "https://thth.me/callback/?code=%3Cscript%3E&x=1",
+    "status": 200,
+    "headers": {
+      "cache-control": "no-store",
+      "content-type": "text/html; charset=utf-8",
+      "referrer-policy": "no-referrer",
+      "x-robots-tag": "noindex, nofollow"
+    },
+    "body": "<!doctype html>\n<html lang=\"ja\"><head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<meta name=\"robots\" content=\"noindex,nofollow,noarchive\">\n<title>THTH 認可の受け口</title>\n<style>\n  :root { color-scheme: light dark; }\n  body { margin:0; min-height:100vh; display:flex; align-items:center; justify-content:center;\n         font: 16px/1.7 -apple-system, BlinkMacSystemFont, \"Hiragino Sans\", \"Noto Sans JP\", sans-serif;\n         background:#faf9f7; color:#1a1a1a; padding:24px; }\n  @media (prefers-color-scheme: dark) { body { background:#16161a; color:#eee; } }\n  main { max-width: 640px; width:100%; }\n  h1 { font-size:1.15rem; font-weight:600; margin:0 0 4px; letter-spacing:.02em; }\n  .sub { font-size:.85rem; opacity:.65; margin:0 0 24px; }\n  .code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size:.95rem;\n          word-break:break-all; background:rgba(127,127,127,.12); border-radius:10px;\n          padding:16px; margin:0 0 12px; user-select:all; }\n  button { font:inherit; font-size:.9rem; padding:9px 18px; border-radius:8px; cursor:pointer;\n           border:1px solid rgba(127,127,127,.4); background:transparent; color:inherit; }\n  button:hover { background:rgba(127,127,127,.12); }\n  .note { font-size:.85rem; opacity:.7; margin-top:20px; }\n  .err { color:#b3261e; } @media (prefers-color-scheme: dark) { .err { color:#f2b8b5; } }\n</style></head><body><main><h1>認可コードを受け取りました</h1>\n       <p class=\"sub\">下の <strong>URL 全体</strong>をターミナルに貼ってください\n       （<code>code</code> だけでは足りません）。1 時間で切れる使い捨てです。</p>\n       <p class=\"code\" id=\"c\">https://thth.me/callback/?code=%3Cscript%3E</p>\n       <button id=\"b\">コピー</button>\n       <p class=\"note err\">state が付いていません。この戻りは <code>thth auth</code> に\n         受け付けられません（もう一度 <code>thth auth</code> から始めてください）。</p>\n       <p class=\"note\">この画面は撮らないでください。貼り終えたら閉じて構いません。</p>\n       <script>\n         // アドレスバーからコードを消す（撮影・肩越しの覗き見への備え）。\n         try { history.replaceState(null, \"\", location.pathname); } catch (e) {}\n         document.getElementById(\"b\").onclick = async () => {\n           try {\n             await navigator.clipboard.writeText(document.getElementById(\"c\").textContent);\n             document.getElementById(\"b\").textContent = \"コピーしました\";\n           } catch (e) { document.getElementById(\"b\").textContent = \"手で選んでコピーしてください\"; }\n         };\n       </script></main></body></html>"
+  },
+  {
+    "url": "https://thth.me/deauthorize",
+    "status": 200,
+    "headers": {},
+    "body": ""
+  },
+  {
+    "url": "https://thth.me/data-deletion-status",
+    "status": 200,
+    "headers": {
+      "cache-control": "no-store",
+      "content-type": "text/html; charset=utf-8",
+      "referrer-policy": "no-referrer",
+      "x-robots-tag": "noindex, nofollow"
+    },
+    "body": "<!doctype html>\n<html lang=\"ja\"><head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<meta name=\"robots\" content=\"noindex,nofollow,noarchive\">\n<title>THTH 認可の受け口</title>\n<style>\n  :root { color-scheme: light dark; }\n  body { margin:0; min-height:100vh; display:flex; align-items:center; justify-content:center;\n         font: 16px/1.7 -apple-system, BlinkMacSystemFont, \"Hiragino Sans\", \"Noto Sans JP\", sans-serif;\n         background:#faf9f7; color:#1a1a1a; padding:24px; }\n  @media (prefers-color-scheme: dark) { body { background:#16161a; color:#eee; } }\n  main { max-width: 640px; width:100%; }\n  h1 { font-size:1.15rem; font-weight:600; margin:0 0 4px; letter-spacing:.02em; }\n  .sub { font-size:.85rem; opacity:.65; margin:0 0 24px; }\n  .code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size:.95rem;\n          word-break:break-all; background:rgba(127,127,127,.12); border-radius:10px;\n          padding:16px; margin:0 0 12px; user-select:all; }\n  button { font:inherit; font-size:.9rem; padding:9px 18px; border-radius:8px; cursor:pointer;\n           border:1px solid rgba(127,127,127,.4); background:transparent; color:inherit; }\n  button:hover { background:rgba(127,127,127,.12); }\n  .note { font-size:.85rem; opacity:.7; margin-top:20px; }\n  .err { color:#b3261e; } @media (prefers-color-scheme: dark) { .err { color:#f2b8b5; } }\n</style></head><body><main><h1>データ削除について</h1>\n         <p class=\"sub\">THTH は masaru 個人の道具で、Threads から取得した内容は\n         本人の repository にのみ保存されます。</p>\n         <p class=\"note\">削除の依頼は repository の所有者へ直接どうぞ。</p></main></body></html>"
+  },
+  {
+    "url": "https://thth.me/",
+    "status": 598,
+    "headers": {
+      "content-type": "text/plain; charset=utf-8"
+    },
+    "body": "[ASSETS] /"
+  },
+  {
+    "url": "https://thth.me/llms.txt",
+    "status": 598,
+    "headers": {
+      "content-type": "text/plain; charset=utf-8"
+    },
+    "body": "[ASSETS] /llms.txt"
+  },
+  {
+    "url": "https://thth.me/robots.txt",
+    "status": 598,
+    "headers": {
+      "content-type": "text/plain; charset=utf-8"
+    },
+    "body": "[ASSETS] /robots.txt"
+  }
+]

{thth-2.0.0 → thth-2.2.0}/tests/helpers/fake_oauth_server.py

@@ -6,7 +6,9 @@
   - "long"（GET /access_token）
   - "me"（GET /v1.0/me）
   - "refresh"（GET /refresh_access_token）
-値は "ok" | "4xx" | "5xx" | "no_token"。
+  - "debug"（GET /v1.0/debug_token・既定は "absent"＝404。"ok" で `data.scopes` に
+    `debug_scopes` を返す。`thth auth` が scope の記録元を切り替える試験用）
+値は "ok" | "4xx" | "5xx" | "no_token"（"debug" だけ "absent" も）。
 """
 from __future__ import annotations
 
@@ -24,6 +26,7 @@ class _Handler(http.server.BaseHTTPRequestHandler):
     refreshed_token = "REFRESHED-SECRET-TOKEN"
     me_payload = {"id": "999999", "username": "nigamilab"}
     expires_in = 5184000
+    debug_scopes = ["threads_basic", "threads_content_publish"]
 
     def _respond_json(self, status: int, payload: dict) -> None:
         body = json.dumps(payload).encode("utf-8")
@@ -70,6 +73,14 @@ class _Handler(http.server.BaseHTTPRequestHandler):
             self._respond_for(self.behavior.get("refresh", "ok"),
                                {"access_token": self.refreshed_token, "token_type": "bearer",
                                 "expires_in": self.expires_in})
+        elif parsed.path == "/v1.0/debug_token":
+            mode = self.behavior.get("debug", "absent")
+            if mode == "absent":
+                self._respond_json(404, {"error": "not found"})
+            else:
+                self._respond_for(mode, {"data": {"is_valid": True,
+                                                  "scopes": list(self.debug_scopes),
+                                                  "user_id": "999999"}})
         else:
             self._respond_json(404, {"error": "not found"})
 

thth-2.2.0/tests/helpers/fake_redirect_server.py

@@ -0,0 +1,102 @@
+"""リダイレクトでトークンが別ホストへ漏れるかを試す偽サーバ 2 本（127.0.0.1）。
+
+セキュリティ監査 2026-09-14・P1-1 の再現（`redirect_leak.py`）と同じ型:
+
+  - **1 本目**（`origin`）はどの口に来ても `302 Location: <2 本目>` を返す。
+  - **2 本目**（`elsewhere`）は受け取った要求を `received` に積む
+    （`Authorization` ヘッダ・クエリ文字列を含む）。
+
+本物の媒体（graph.threads.net・mastodon の実インスタンス・bsky.social）には
+一切触らない。トークンは**偽の値**（`FAKE-TOKEN-…`）。
+"""
+from __future__ import annotations
+
+import contextlib
+import http.server
+import json
+import threading
+
+
+def _make_recorder(received: list):
+    class Recorder(http.server.BaseHTTPRequestHandler):
+        def _record_and_reply(self):
+            received.append({
+                "path": self.path,
+                "authorization": self.headers.get("Authorization"),
+                "headers": {k.lower(): v for k, v in self.headers.items()},
+            })
+            body = json.dumps({"id": "999999", "username": "leaked"}).encode("utf-8")
+            self.send_response(200)
+            self.send_header("Content-Type", "application/json")
+            self.send_header("Content-Length", str(len(body)))
+            self.end_headers()
+            self.wfile.write(body)
+
+        do_GET = _record_and_reply
+        do_POST = _record_and_reply
+
+        def log_message(self, format, *args):  # noqa: A002
+            pass
+
+    return Recorder
+
+
+def _make_redirector(target: dict, status: int, location=None):
+    class Redirector(http.server.BaseHTTPRequestHandler):
+        def _redirect(self):
+            where = location if location is not None else target["base"] + self.path
+            self.send_response(status)
+            self.send_header("Location", where)
+            self.send_header("Content-Length", "0")
+            self.end_headers()
+
+        do_GET = _redirect
+        do_POST = _redirect
+
+        def log_message(self, format, *args):  # noqa: A002
+            pass
+
+    return Redirector
+
+
+@contextlib.contextmanager
+def redirect_pair(*, status: int = 302, location=None):
+    """`(origin_base, elsewhere_base, received)` を返す。
+
+    `location` を渡すと 1 本目はその値をそのまま `Location` に入れる
+    （相対 `//host/...` や `http://` への格下げを試すため）。
+    """
+    received: list = []
+    target = {"base": ""}
+
+    elsewhere = http.server.HTTPServer(("127.0.0.1", 0), _make_recorder(received))
+    target["base"] = f"http://127.0.0.1:{elsewhere.server_port}"
+    origin = http.server.HTTPServer(("127.0.0.1", 0),
+                                     _make_redirector(target, status, location))
+
+    threads = []
+    for server in (elsewhere, origin):
+        t = threading.Thread(target=server.serve_forever, daemon=True)
+        t.start()
+        threads.append(t)
+    try:
+        yield (f"http://127.0.0.1:{origin.server_port}", target["base"], received)
+    finally:
+        for server in (elsewhere, origin):
+            server.shutdown()
+        for t in threads:
+            t.join(timeout=5)
+
+
+@contextlib.contextmanager
+def recording_server():
+    """記録だけする 1 本（リダイレクトしない口の対照実験用）。"""
+    received: list = []
+    server = http.server.HTTPServer(("127.0.0.1", 0), _make_recorder(received))
+    t = threading.Thread(target=server.serve_forever, daemon=True)
+    t.start()
+    try:
+        yield (f"http://127.0.0.1:{server.server_port}", received)
+    finally:
+        server.shutdown()
+        t.join(timeout=5)