thth 4.1.0__tar.gz → 4.2.1__tar.gz

{thth-4.1.0 → thth-4.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: thth
-Version: 4.1.0
+Version: 4.2.1
 Summary: 承認済みの投稿だけを投げる門（Threads・Bluesky・Mastodon）。人が承認し、記録は利用者の git に残る。
 Project-URL: Homepage, https://thth.me
 Project-URL: Source, https://github.com/aokings/thth
@@ -44,6 +44,7 @@ English: [README.en.md](README.en.md) · サイト: https://thth.me · 文書の
 - **調べる**: `thth topics <アカウント> --search <語>` で、その語の件数・投稿者の数・最新の投稿を見ます。`thth where` は「次にどこで話すか」を、自分がすでに絡んだ相手を重ねて探します。X の行には投稿者のフォロワー数（「フォロワー 1.2 万」）と投稿数も付きます（`--json` は `author_followers`・`author_posts`。保存しません）。
 - **出す**: `thth send` で今すぐ、`thth schedule` で予約、`--reply-to` で返信です。
 - **ブックマークの連投は記事と別に数える**（4.0.1）: はてなブックマークは主体の別の窓（既定 10 分に 10 件）で数え、超えても主体を止めずにその 1 件だけ断ります。1 日 30 件・同じホストへ 1 日 3 件（自分の記事は 1 日 1 件のまま）。記事の連投で止める作りは変わりません（[リリースノート 4.0.1](docs/リリースノート_4.0.1_2026-10-17.md)）。
+- **ブックマークの直しとタグの長さの柵**（4.2.0）: `thth bookmark edit` で THTH が付けたブックマークのコメントとタグを 2 段の承認で直す。31 バイトを超えるタグは予告して断る。上限の設定は台帳の `limits` と別名で書け、断りに根拠と通し方が付きます（[リリースノート 4.2.0](docs/リリースノート_4.2.0_2026-10-18.md)）。
 - **ブックマークを 1 日分まとめて承認する**（4.1.0）: 札を JSON Lines に並べ、`thth bookmark batch` の 1 段目で全件の一覧と digest を見て 2 段目で確定。timer が上限の中で時刻を散らして付けます（口座ごと）。あわせて、上限と連投の柵の土台（媒体の特性の台帳）を入れました（[リリースノート 4.1.0](docs/リリースノート_4.1.0_2026-10-17.md)）。
 - **記事をはてなへ届けて、直したら反映**（4.0.0）: repo の記事を承認してはてなブログへ公開・予約し（画像はフォトライフへ）、SNS の告知（`announces`・`{article_url}`）とはてなブックマークを記事に結びます。記事を直せば `thth article diff` で差分を見て、承認して更新します。はてなの画面で手直しされていれば上書きせず `thth conflict` で止まります。反応は `thth article reactions` で記事ごとに。SNS だけの口座の動きと承認の指紋は変わりません（[リリースノート 4.0.0](docs/リリースノート_4.0.0_2026-10-17.md)）。
 - **返信の連投は止めずに順番待ち**（3.25.0）: `thth send --reply-to`（thth.me の `send_request` も）が急な連投（burst）を超えるとき、口座を止めずにその 1 件を窓が空く時刻の順番待ちに並べ、timer が出します。止めるのは返信でない投稿の連投だけです（[リリースノート 3.25.0](docs/リリースノート_3.25.0_2026-10-16.md)）。

{thth-4.1.0 → thth-4.2.1}/README.md

@@ -20,6 +20,7 @@ English: [README.en.md](README.en.md) · サイト: https://thth.me · 文書の
 - **調べる**: `thth topics <アカウント> --search <語>` で、その語の件数・投稿者の数・最新の投稿を見ます。`thth where` は「次にどこで話すか」を、自分がすでに絡んだ相手を重ねて探します。X の行には投稿者のフォロワー数（「フォロワー 1.2 万」）と投稿数も付きます（`--json` は `author_followers`・`author_posts`。保存しません）。
 - **出す**: `thth send` で今すぐ、`thth schedule` で予約、`--reply-to` で返信です。
 - **ブックマークの連投は記事と別に数える**（4.0.1）: はてなブックマークは主体の別の窓（既定 10 分に 10 件）で数え、超えても主体を止めずにその 1 件だけ断ります。1 日 30 件・同じホストへ 1 日 3 件（自分の記事は 1 日 1 件のまま）。記事の連投で止める作りは変わりません（[リリースノート 4.0.1](docs/リリースノート_4.0.1_2026-10-17.md)）。
+- **ブックマークの直しとタグの長さの柵**（4.2.0）: `thth bookmark edit` で THTH が付けたブックマークのコメントとタグを 2 段の承認で直す。31 バイトを超えるタグは予告して断る。上限の設定は台帳の `limits` と別名で書け、断りに根拠と通し方が付きます（[リリースノート 4.2.0](docs/リリースノート_4.2.0_2026-10-18.md)）。
 - **ブックマークを 1 日分まとめて承認する**（4.1.0）: 札を JSON Lines に並べ、`thth bookmark batch` の 1 段目で全件の一覧と digest を見て 2 段目で確定。timer が上限の中で時刻を散らして付けます（口座ごと）。あわせて、上限と連投の柵の土台（媒体の特性の台帳）を入れました（[リリースノート 4.1.0](docs/リリースノート_4.1.0_2026-10-17.md)）。
 - **記事をはてなへ届けて、直したら反映**（4.0.0）: repo の記事を承認してはてなブログへ公開・予約し（画像はフォトライフへ）、SNS の告知（`announces`・`{article_url}`）とはてなブックマークを記事に結びます。記事を直せば `thth article diff` で差分を見て、承認して更新します。はてなの画面で手直しされていれば上書きせず `thth conflict` で止まります。反応は `thth article reactions` で記事ごとに。SNS だけの口座の動きと承認の指紋は変わりません（[リリースノート 4.0.0](docs/リリースノート_4.0.0_2026-10-17.md)）。
 - **返信の連投は止めずに順番待ち**（3.25.0）: `thth send --reply-to`（thth.me の `send_request` も）が急な連投（burst）を超えるとき、口座を止めずにその 1 件を窓が空く時刻の順番待ちに並べ、timer が出します。止めるのは返信でない投稿の連投だけです（[リリースノート 3.25.0](docs/リリースノート_3.25.0_2026-10-16.md)）。

{thth-4.1.0 → thth-4.2.1}/mcp/server.py

@@ -836,7 +836,8 @@ _PUBLISHING_DESCRIPTIONS = {
 _BOOKMARK_DESCRIPTION = ("自分の記事（配信の台帳で published の配信・delivery）か、レーンが参照している他人のページ（url）に、"
                          "主体のはてな ID でブックマークを付ける（delivery と url はどちらか 1 つ）。同じ owner の別の主体が付けた"
                          "ページは断る。2 段: confirm が無ければ stage 1 と digest と表示を返す。同じ digest を confirm に付けると打つ。"
-                         "op: delete で THTH が付けたものを消す。主体の止め・1 日の上限（全体・自分の記事・同じホスト）・"
+                         "op: delete で THTH が付けたものを消す。op: edit で THTH が付けたもの（confirmed）のコメントとタグを直す"
+                         "（comment・tags は省けば今のまま・はてなに無ければ直さない・件数の枠は使わず連投の窓だけ数える）。主体の止め・1 日の上限（全体・自分の記事・同じホスト）・"
                          "急な連投・1 ページに 1 回で断る。結果が分からなければ status: unknown（打ち直さない）")
 for _tool in SERVER_TOOLS:
     if _tool["name"] == "thth_bookmark_request":
@@ -1180,9 +1181,13 @@ REMOTE_CLI = {
     "thth_schedule_request": (lambda a: ["schedule", a["account"], "--draft=" + a["draft_id"], "--production", "--json",
                                          *_opt("--confirm", a.get("confirm"))],
                               None),
-    "thth_bookmark_request": (lambda a: ["bookmark", "delete" if a.get("op") == "delete" else "add", a["account"],
+    # 4.2（S4 §21.7）: op が edit なら `thth bookmark edit`（comment・tags は省けば今のまま）。
+    "thth_bookmark_request": (lambda a: ["bookmark", {"delete": "delete", "edit": "edit"}.get(a.get("op"), "add"),
+                                         a["account"],
                                          *(["--url=" + a["url"]] if a.get("url") else ["--delivery=" + a.get("delivery", "")]),
-                                         *(["--comment=" + a.get("comment", "")] if a.get("op") != "delete" else []),
+                                         *(["--comment=" + a.get("comment", "")]
+                                           if a.get("op") not in ("delete", "edit") or
+                                           (a.get("op") == "edit" and a.get("comment") is not None) else []),
                                          *_opt("--tags", a.get("tags")),
                                          *_opt("--confirm", a.get("confirm")), "--production", "--json"], None),
     # 4.1: 札のファイルの中身は標準入力で（`thth bookmark batch <口座> -`）。

thth-4.2.1/tests/fixtures/limits_stage3/README.txt

@@ -0,0 +1,2 @@
+段 3 の T-P-7（tests/test_limits_stage3.py）の台帳の写し。VM の台帳の「形」を写した作りもの（秘密の値・本物の名前は入れない）。
+10/17 に段 2 の書き手が ssh wt で読んだ形（主体: daily_max_bookmarks 50・bookmark_same_host_daily 5・burst 3/30 分・bookmark_burst の明示なし、はてなの口座: 雛形の daily_max_posts 3・daily_max_retracts 2）に、SNS の口座の今の鍵の例を足した。段 3 の書き手は網に出ていない（VM は読んでいない）。

thth-4.2.1/tests/fixtures/limits_stage3/ledgers/vm-kopicha-hatenablog.json

@@ -0,0 +1,29 @@
+{
+  "repo_dir": "$THTH_ROOT/repos/x",
+  "queue_dir": "docs/sns/queue",
+  "replies_dir": "data/sns/replies",
+  "quiet_hours": [
+    "23:00",
+    "06:00"
+  ],
+  "min_interval_hours": 0,
+  "collect_days": 14,
+  "hashtags": false,
+  "stale_days": 7,
+  "env": "~/.config/thth/x.env",
+  "token": "~/.config/thth/x.token",
+  "ping": "wrapper",
+  "timeout": 300,
+  "dry_run_env": "THTH_DRY_RUN",
+  "production": true,
+  "scheduled": true,
+  "account": "vm-kopicha-hatenablog",
+  "project": "vm-kopicha",
+  "media": "hatenablog",
+  "principal": "vm-kopicha",
+  "blog_id": "vm-kopicha.hatenablog.com",
+  "handle": "vm-kopicha-id",
+  "link_base": "https://example.invalid/",
+  "daily_max_posts": 3,
+  "daily_max_retracts": 2
+}

thth-4.2.1/tests/fixtures/limits_stage3/ledgers/vm-kopicha-x.json

@@ -0,0 +1,32 @@
+{
+  "repo_dir": "$THTH_ROOT/repos/x",
+  "queue_dir": "docs/sns/queue",
+  "replies_dir": "data/sns/replies",
+  "quiet_hours": [
+    "23:00",
+    "06:00"
+  ],
+  "min_interval_hours": 0,
+  "collect_days": 14,
+  "hashtags": false,
+  "stale_days": 7,
+  "env": "~/.config/thth/x.env",
+  "token": "~/.config/thth/x.token",
+  "ping": "wrapper",
+  "timeout": 300,
+  "dry_run_env": "THTH_DRY_RUN",
+  "production": true,
+  "scheduled": true,
+  "account": "vm-kopicha-x",
+  "project": "vm-kopicha",
+  "media": "x",
+  "handle": "vm-kopicha",
+  "daily_max_posts": 4,
+  "burst": {
+    "count": 2,
+    "minutes": 30
+  },
+  "daily_max_reactions": 20,
+  "x_daily_reads": 60,
+  "hold_minutes": 0
+}

thth-4.2.1/tests/fixtures/limits_stage3/ledgers/vm-music-threads.json

@@ -0,0 +1,25 @@
+{
+  "repo_dir": "$THTH_ROOT/repos/x",
+  "queue_dir": "docs/sns/queue",
+  "replies_dir": "data/sns/replies",
+  "quiet_hours": [
+    "23:00",
+    "06:00"
+  ],
+  "min_interval_hours": 0,
+  "collect_days": 14,
+  "hashtags": false,
+  "stale_days": 7,
+  "env": "~/.config/thth/x.env",
+  "token": "~/.config/thth/x.token",
+  "ping": "wrapper",
+  "timeout": 300,
+  "dry_run_env": "THTH_DRY_RUN",
+  "production": true,
+  "scheduled": true,
+  "account": "vm-music-threads",
+  "project": "vm-music",
+  "media": "threads",
+  "handle": "vm-music",
+  "redirect_uri": "https://thth.me/callback/threads"
+}

thth-4.2.1/tests/fixtures/limits_stage3/principals/vm-kopicha.json

@@ -0,0 +1,40 @@
+{
+  "principal": "vm-kopicha",
+  "kind": "hatena",
+  "hatena_id": "vm-kopicha-id",
+  "owner": "vm-owner",
+  "token": "~/.config/thth/vm-kopicha.token",
+  "consumer": "~/.config/thth/vm-kopicha.consumer",
+  "auth": "oauth",
+  "blogs": [
+    {
+      "blog_id": "vm-kopicha.hatenablog.com",
+      "lanes": [
+        "vm-kopicha"
+      ],
+      "syntax": "markdown"
+    }
+  ],
+  "bookmark": {
+    "lanes": [
+      "vm-kopicha"
+    ]
+  },
+  "daily_max_posts": 6,
+  "daily_max_retracts": 3,
+  "daily_max_bookmarks": 50,
+  "burst": {
+    "count": 3,
+    "minutes": 30
+  },
+  "daily_max_self_bookmarks": 1,
+  "bookmark_same_host_daily": 5,
+  "fotolife": {
+    "max_image_bytes": 8388608,
+    "max_images_per_entry": 20,
+    "max_total_bytes": 67108864,
+    "daily_max_uploads": 30,
+    "feed_pages": 1
+  },
+  "user_agent_contact": "https://thth.me/"
+}