thth 4.2.1__tar.gz → 4.2.2__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: thth
-Version: 4.2.1
+Version: 4.2.2
 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)）。
+- **1 件の断りでまとめを止めない**（4.2.2）: はてなに 1 件だけ断られた札は token を確かめてその札だけ外し、まとめを進めます。断られそうな札（半角の「%」・タグとコメントの長いもの）は 1 段目と lint で予告します（断りません）。止まったまとめは 60 分ごとにしか打たず、`thth bookmark batch-resume` で今すぐ見直せます。sparse-checkout の定義の外には記録を書かず、直し方を言います（[リリースノート 4.2.2](docs/リリースノート_4.2.2_2026-10-18.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)）。

{thth-4.2.1 → thth-4.2.2}/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)）。
+- **1 件の断りでまとめを止めない**（4.2.2）: はてなに 1 件だけ断られた札は token を確かめてその札だけ外し、まとめを進めます。断られそうな札（半角の「%」・タグとコメントの長いもの）は 1 段目と lint で予告します（断りません）。止まったまとめは 60 分ごとにしか打たず、`thth bookmark batch-resume` で今すぐ見直せます。sparse-checkout の定義の外には記録を書かず、直し方を言います（[リリースノート 4.2.2](docs/リリースノート_4.2.2_2026-10-18.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)）。

{thth-4.2.1 → thth-4.2.2}/tests/test_v210_json_contract.py

@@ -85,6 +85,8 @@ COMMANDS = '''lint|preview|approve|account|revoke|posts|replies|measured|threads
 COMMANDS += ['bookmark edit']
 # 上限と連投の柵 段 4（§9.2）: 媒体の観測を数える・人が足す。
 COMMANDS += ['media observations', 'media observe']
+# 4.2.2（S4 §24）: 止まったまとめを今すぐ見直させる（1 段）。
+COMMANDS += ['bookmark batch-resume']
 
 
 def test_json_table_covers_every_parser():

{thth-4.2.1 → thth-4.2.2}/tests/test_v400_s4_bookmark.py

@@ -317,6 +317,10 @@ def test_T_S4_7a_書くもの(bm, answer, result, error):
                                           (429, "provider_rate_limited"), (409, "hatena_http_409")])
 def test_T_S4_7a_書かないもの(bm, status, error):
     bm.bookmarks.post = _post((status, b"no"))
+    if status in (401, 403):
+        # 4.2.2（S4 §24）: 401/403 は `/rest/1/my` で token を確かめる。ここは token も断られる場合
+        # （GET が通る＝その札だけの断りは tests/test_v422_bookmark_rejections.py）。
+        bm.bookmarks.me = (status, b"no")
     assert failed(ACCOUNT, url=EXTERNAL, comment="c") == error
     assert rows(bm, ACCOUNT) == []
     assert principals.stopped("hatena-main") is None     # 429 でも主体は止めない

thth-4.2.2/tests/test_v422_bookmark_rejections.py

@@ -0,0 +1,285 @@
+"""4.2.2（設計 S4 §24・kopicha の本番 10/18）: はてなブックマークの 1 件の断りでまとめ全体を止めない。
+
+見るもの:
+  B（主）. POST が 401/403 なら同じ run の中で `/rest/1/my` を GET して token を確かめる。通ればその札だけ
+     `hatena_rejected_item`（詳細に HTTP の番号）でまとめは進む。GET も断られたら `hatena_auth_rejected`。
+     1 件ずつの `add`・`edit` でも同じ見分けで、人向けの文を分ける。原因が何であれ、打ち直さない。
+  A. 本文の予告（**断らない**・原因が未確定）: 半角「%」（`bookmark_percent_maybe_rejected`）と、
+     `[tag]…comment` の形で 135 字か 343 バイトを超える長さ（`bookmark_length_maybe_rejected`）を、
+     `add`・`edit`・`batch` の 1 段目と `thth lint <札のファイル>` で予告する（lint は `warning:`）。
+     承認の指紋は変えない。台帳に観測の項目（確かさ low・数は台帳とコードで同じ）。
+  C. はてなに打って止まった（blocked）ら `BLOCKED_HOLD_MINUTES`（60 分）は次の run も HTTP を打たない。
+     `thth bookmark batch-resume <口座> --by` で今すぐ見直させる。打たずに止まる止め（主体の止めなど）は今どおり。
+
+HTTP は偽物（`hatena_s4_helpers.Bookmarks`）。はてなには出ない。秘密の値は偽物だけ。
+"""
+from __future__ import annotations
+
+import datetime
+import json
+
+from tests.hatena_s1_flow_helpers import call, lane  # noqa: F401
+from tests.hatena_s4_helpers import ACCOUNT, EXTERNAL, EXTERNAL_2, bm, bookmark, calls, cfg, fake_http, world  # noqa: F401
+from tests.test_v410_bookmark_batch import (URL_A1, URL_B1, approve, batch_file, bb, item, later, run,  # noqa: F401
+                                            states, write)
+from thth import bookmark_batch, hatena_bookmark, lint, media_traits, sent
+
+ME = "https://bookmark.hatenaapis.com/rest/1/my"
+# `[tag]…comment` の形で 138 字・398 バイト（予告の長さを超える）。コメントは 100 字以内・タグは 31 バイト以内。
+LONG_TAGS = ["一次資料いろはにほへ", "二次資料いろはにほへ", "三次資料いろはにほへ", "四次資料いろはにほへ"]
+LONG_COMMENT = "あ" * 90
+
+
+def hatena_bookmark_api(target):
+    import urllib.parse
+    return "https://bookmark.hatenaapis.com/rest/1/my/bookmark?" + urllib.parse.urlencode([("url", target)])
+
+
+def me_calls(world):
+    return [u for m, u in calls(world, "GET") if u == ME]
+
+
+def codes(warnings):
+    return [w["code"] for w in warnings]
+
+
+# ================================================================ A. 本文の予告（断らない）
+
+def test_A_予告の境目は135字と343バイト_半角パーセントは全角なら出ない():
+    assert hatena_bookmark.body_form("c", ["a", "b"]) == "[a][b]c"
+    assert codes(hatena_bookmark.body_warnings("x" * 135, [])) == []
+    assert codes(hatena_bookmark.body_warnings("x" * 136, [])) == ["bookmark_length_maybe_rejected"]
+    assert codes(hatena_bookmark.body_warnings("あ" * 114 + "x", [])) == []                 # 115 字・343 バイト
+    assert codes(hatena_bookmark.body_warnings("あ" * 114 + "xy", [])) == ["bookmark_length_maybe_rejected"]  # 344 バイト
+    assert codes(hatena_bookmark.body_warnings("約 85％", [])) == []
+    got = hatena_bookmark.body_warnings("約 85%", ["割合%"])
+    assert codes(got) == ["bookmark_percent_maybe_rejected"]
+    assert "コメント 1 個" in got[0]["text"] and "タグ「割合%」 1 個" in got[0]["text"]
+    assert len(hatena_bookmark.body_form(LONG_COMMENT, LONG_TAGS)) == 138
+
+
+def test_A_addの1段目は予告して断らず_2段目も打つ_指紋は変わらない(bm):
+    """柵: `body_warnings` を 1 段目に出さないと赤。断る形に戻すと赤（rc 2）。"""
+    args = ["bookmark", "add", ACCOUNT, "--url", EXTERNAL, "--comment", "約 85% が一次資料", "--tags", "割合%,統計"]
+    rc, out, _ = call(args + ["--json"])
+    body = json.loads(out)
+    assert rc == 1 and body["stage"] == 1
+    assert codes(body["preview"]["warnings"]) == ["bookmark_percent_maybe_rejected"]
+    rc, text, _ = call(args)
+    assert "予告（断りません）: bookmark_percent_maybe_rejected" in text and "原因は未確定" in text
+    p = hatena_bookmark.prepare(ACCOUNT, cfg(ACCOUNT), url=EXTERNAL, comment="約 85% が一次資料", tags="割合%,統計",
+                                check_remote=False)
+    from thth import approval
+    assert p["approved_sha"] == approval.compute_hatena_bookmark_sha(
+        account=ACCOUNT, principal="hatena-main", op="add", url=EXTERNAL, delivery="", comment="約 85% が一次資料",
+        tags=["割合%", "統計"])
+    rc, out, err = call(args + ["--confirm", body["digest"], "--by", "masaru", "--production", "--json"])
+    assert rc == 0, (out, err)
+    assert len(calls(bm, "POST")) == 1
+
+
+def test_A_長い札も予告する_editは直したあとの値(bm):
+    rc, out, _ = call(["bookmark", "add", ACCOUNT, "--url", EXTERNAL, "--comment", LONG_COMMENT, "--tags",
+                       ",".join(LONG_TAGS), "--json"])
+    body = json.loads(out)
+    assert rc == 1 and codes(body["preview"]["warnings"]) == ["bookmark_length_maybe_rejected"]
+    assert "138 字・398 バイト" in body["preview"]["warnings"][0]["text"]
+    assert "135 字・343 バイト" in body["preview"]["warnings"][0]["text"]
+    bookmark(ACCOUNT, url=EXTERNAL_2, comment="旧", tags=["旧名"])
+    rc, out, _ = call(["bookmark", "edit", ACCOUNT, "--url", EXTERNAL_2, "--comment", "100%", "--json"])
+    assert rc == 1 and codes(json.loads(out)["preview"]["warnings"]) == ["bookmark_percent_maybe_rejected"]
+    rc, out, _ = call(["bookmark", "edit", ACCOUNT, "--url", EXTERNAL_2, "--comment", "100％", "--json"])
+    assert rc == 1 and json.loads(out)["preview"]["warnings"] == []
+
+
+def test_A_batchは札を除かず予告を添える_指紋は今と同じ(bb):
+    path = write(bb, [item(URL_A1, comment="約 85%"), {"url": URL_B1, "comment": LONG_COMMENT, "tags": LONG_TAGS},
+                      item("https://c.example.net/y", comment="約 85％")])
+    first = json.loads(call(["bookmark", "batch", ACCOUNT, path, "--json"])[1])
+    items = first["preview"]["items"]
+    assert [r["include"] for r in items] == [True, True, True]
+    assert [r.get("warnings") for r in items] == [["bookmark_percent_maybe_rejected"],
+                                                  ["bookmark_length_maybe_rejected"], None]
+    shas = [hatena_bookmark.prepare(ACCOUNT, cfg(ACCOUNT), url=r["url"], comment=r["comment"], tags=r["tags"],
+                                    check_remote=False)["approved_sha"] for r in items]
+    assert first["preview"]["approved_sha"] == bookmark_batch.compute_sha(ACCOUNT, "hatena-main", shas)
+    rc, out, _ = call(["bookmark", "batch", ACCOUNT, path])
+    assert "予告（断りません）: bookmark_percent_maybe_rejected" in out
+    approve(path)
+    assert all("warnings" not in it for it in batch_file(bb)["items"])     # 札の形は変えない
+
+
+def test_A_lintは札のファイルの予告をwarningで言いrcは0(tmp_path):
+    path = tmp_path / "day.jsonl"
+    path.write_text("\n".join([
+        json.dumps({"url": EXTERNAL, "comment": "約 85%", "tags": "a%b"}, ensure_ascii=False),
+        json.dumps({"url": EXTERNAL_2, "comment": LONG_COMMENT, "tags": LONG_TAGS}, ensure_ascii=False),
+        json.dumps({"url": "https://c.example.net/y", "comment": "約 85％"}, ensure_ascii=False)]) + "\n",
+        encoding="utf-8")
+    problems = lint.lint_file(str(path))
+    assert [p.split(": 札")[0] for p in problems] == ["warning: bookmark_percent_maybe_rejected",
+                                                    "warning: bookmark_length_maybe_rejected"]
+    assert "札 1（1 行目）" in problems[0] and "タグ「a%b」 1 個" in problems[0]
+    assert all(lint.is_warning(p) for p in problems)
+    rc, out, err = call(["lint", str(path)])
+    assert rc == 0 and "bookmark_length_maybe_rejected" in out + err
+
+
+def test_A_予告の札が断られてもその札だけ外してまとめは進む(bb):
+    """本番の形: 14 件目「約 85%」・26 件目（長い札）が 401。token は生きている → その札だけ refused。"""
+    bb.bookmarks.post = lambda target, form: ((401, b"no") if target in (URL_A1, URL_B1)
+                                              else _place_default(bb, target, form))
+    approve(write(bb, [item(URL_A1, comment="約 85%"), {"url": URL_B1, "comment": LONG_COMMENT, "tags": LONG_TAGS},
+                       item("https://c.example.net/y")]))
+    out, _ = run(bb)
+    b = batch_file(bb)
+    assert [(i["state"], i["reason"]) for i in b["items"]] == [
+        ("refused", "hatena_rejected_item"), ("refused", "hatena_rejected_item"), ("placed", None)]
+    assert out["status"] == "placed" and not out.get("blocked")
+
+
+def test_A_媒体の台帳に観測の項目があり_数はコードと同じ():
+    doc = media_traits.load("hatenabookmark")
+    found = next(t for t in doc["traits"] if t["id"] == "hatenabookmark.body_rejected_observed")
+    assert found["kind"] == "observation" and found["confidence"] == "low" and found["signals"] == []
+    assert found["evidence"]["type"] == "observed" and found["evidence"]["observed_at"] == "2026-10-18"
+    assert "kopicha" in found["evidence"]["record"]
+    assert "半角 %" in found["statement"] and "未確定" in found["statement"] and "401" in found["statement"]
+    assert f"{hatena_bookmark.BODY_OK_MAX_CHARS} 字・{hatena_bookmark.BODY_OK_MAX_BYTES} バイト" in found["statement"]
+    assert not any(t["id"] == "hatenabookmark.percent_in_body_rejected_observed" for t in doc["traits"])
+
+
+# ================================================================ B. 1 件だけの 401/403
+
+def test_B_addでPOSTが401でもtokenが生きていればその札だけの断り(bm):
+    """柵: `_rejection` の GET を外すと赤（token の生きている 401 を認可の問題と言う）。"""
+    bm.bookmarks.post = (401, b"Unauthorized")
+    rc, out, _ = call(["bookmark", "add", ACCOUNT, "--url", EXTERNAL, "--comment", "c", "--json"])
+    digest = json.loads(out)["digest"]
+    rc, out, err = call(["bookmark", "add", ACCOUNT, "--url", EXTERNAL, "--comment", "c", "--confirm", digest,
+                         "--by", "masaru", "--production", "--json"])
+    body = json.loads(out)
+    assert rc == 2 and body["error"] == "hatena_rejected_item", (out, err)
+    assert "この札だけはてなに断られました" in body["message"] and "token は生きています" in body["message"]
+    assert "HTTP 401" in body["message"] and "principal auth" not in body["message"]
+    assert len(me_calls(bm)) == 1           # POST のあとに 1 回だけ確かめる
+    assert [r for r in sent.records(bm.state(ACCOUNT)) if r.get("kind") == "bookmark_add"] == []
+
+
+def test_B_addでtokenも断られたら認可の問題(bm):
+    bm.bookmarks.post = (403, b"Forbidden")
+    bm.bookmarks.me = (401, b"Unauthorized")
+    rc, out, _ = call(["bookmark", "add", ACCOUNT, "--url", EXTERNAL, "--comment", "c", "--json"])
+    digest = json.loads(out)["digest"]
+    rc, out, _ = call(["bookmark", "add", ACCOUNT, "--url", EXTERNAL, "--comment", "c", "--confirm", digest,
+                       "--by", "masaru", "--production", "--json"])
+    body = json.loads(out)
+    assert rc == 2 and body["error"] == "hatena_auth_rejected"
+    assert "thth principal auth" in body["message"] and "--force" in body["message"]
+
+
+def test_B_editでも同じ見分け(bm):
+    bookmark(ACCOUNT, url=EXTERNAL, comment="旧", tags=["旧名"])
+    bm.bookmarks.post = (401, b"Unauthorized")
+    rc, out, _ = call(["bookmark", "edit", ACCOUNT, "--url", EXTERNAL, "--comment", "新", "--json"])
+    digest = json.loads(out)["digest"]
+    args = ["bookmark", "edit", ACCOUNT, "--url", EXTERNAL, "--comment", "新", "--confirm", digest, "--by", "masaru",
+            "--production", "--json"]
+    rc, out, _ = call(args)
+    assert rc == 2 and json.loads(out)["error"] == "hatena_rejected_item"
+    bm.bookmarks.me = (401, b"Unauthorized")
+    rc, out, _ = call(args)
+    assert rc == 2 and json.loads(out)["error"] == "hatena_auth_rejected"
+    row = sent.read(bm.state(ACCOUNT), sent.bookmark_post_id(EXTERNAL))
+    assert row["text"] == "旧" and not row.get("attempts")
+
+
+def test_B_まとめは断られた札だけrefusedにして進む(bb):
+    """柵: `hatena_rejected_item` を `_FINAL_BOOKMARK` から外すと赤（まとめ全体が止まる）。"""
+    bb.bookmarks.post = lambda target, form: (401, b"no") if target == URL_A1 else _place_default(bb, target, form)
+    approve(write(bb, [item(URL_A1), item(URL_B1)]))
+    out, _ = run(bb)
+    b = batch_file(bb)
+    assert [(i["state"], i["reason"], i["detail"]) for i in b["items"]] == [
+        ("refused", "hatena_rejected_item", "HTTP 401"), ("placed", None, None)]
+    assert out["status"] == "placed" and not out.get("blocked")
+    assert bookmark_batch.status(ACCOUNT)["blocked"] is None
+
+
+def test_B_まとめでtokenも断られたら止まる(bb):
+    bb.bookmarks.post = (401, b"no")
+    bb.bookmarks.me = (401, b"no")
+    approve(write(bb, [item(URL_A1), item(URL_B1)]))
+    out, _ = run(bb)
+    assert out["status"] == "blocked" and out["blocked"]["code"] == "hatena_auth_rejected"
+    assert states(bb) == ["pending", "pending"]
+
+
+def _place_default(world, target, form):
+    """偽物のはてなの既定の POST（付ける）。"""
+    from tests.hatena_s4_helpers import bookmark_object
+    mark = bookmark_object(target, comment=form.get("comment", [""])[0], tags=form.get("tags", []))
+    world.bookmarks.marks[("lane-owner", target)] = mark
+    return 200, json.dumps(mark).encode()
+
+
+# ================================================================ C. 止まったら打ち直し続けない
+
+def _blocked(bb):
+    bb.bookmarks.post = (401, b"no")
+    bb.bookmarks.me = (401, b"no")
+    approve(write(bb, [item(URL_A1), item(URL_B1)]))
+    now = later(0)
+    out, _ = run(bb, now=now)
+    assert out["status"] == "blocked" and out["blocked"]["code"] == "hatena_auth_rejected"
+    return now
+
+
+def test_C_はてなに打って止まったら次のrunはHTTPを打たない_60分あとに試す(bb):
+    """柵: blocked に `next_at` を置かないと赤（10 分ごとに同じ札を打ち直す・kopicha 10/18 に 57 回）。"""
+    now = _blocked(bb)
+    before = len(bb.http.calls)
+    for minutes in (10, 20, 30, 59):
+        out, _ = run(bb, now=now + datetime.timedelta(minutes=minutes))
+        assert out["status"] == "waiting" and out["blocked"]["code"] == "hatena_auth_rejected"
+    assert len(bb.http.calls) == before
+    s = bookmark_batch.status(ACCOUNT)
+    assert s["blocked"]["until"] == s["next_at"]
+    assert bookmark_batch.jst.parse(s["next_at"]) - now == datetime.timedelta(
+        minutes=bookmark_batch.BLOCKED_HOLD_MINUTES)
+    rc, text, _ = call(["bookmark", "batch-status", ACCOUNT])
+    assert "まではてなに打ちません" in text and f"thth bookmark batch-resume {ACCOUNT} --by" in text
+    # 60 分あとは今の柵で見直す（直っていなければまた止まる）
+    run(bb, now=now + datetime.timedelta(minutes=61))
+    assert len(bb.http.calls) > before
+
+
+def test_C_batch_resumeで今すぐ見直させ_札と指紋は変えない(bb):
+    now = _blocked(bb)
+    before_items = batch_file(bb)["items"]
+    rc, out, _ = call(["bookmark", "batch-resume", ACCOUNT, "--json"])
+    assert rc == 1 and json.loads(out)["error"] == "by_required"
+    bb.bookmarks.post = None
+    bb.bookmarks.me = None
+    rc, out, err = call(["bookmark", "batch-resume", ACCOUNT, "--by", "masaru", "--json"])
+    body = json.loads(out)
+    assert rc == 0 and body["was_blocked"]["code"] == "hatena_auth_rejected" and body["pending"] == 2, (out, err)
+    s = bookmark_batch.status(ACCOUNT)
+    assert s["blocked"] is None and s["next_at"] is None
+    assert [i["approved_sha"] for i in batch_file(bb)["items"]] == [i["approved_sha"] for i in before_items]
+    out, _ = run(bb, now=now + datetime.timedelta(minutes=5))
+    assert out["status"] == "placed" and states(bb)[0] == "placed"
+    from thth import admin_log
+    assert any(r["event"] == "bookmark_batch_resumed" and r["by"] == "masaru" for r in admin_log.read()[0])
+
+
+def test_C_打たずに止まる止めは今どおり次の刻みで見直す(bb):
+    """主体の止め（HTTP を打たない）は 60 分待たせない（止めを解けば次の刻みで付く）。"""
+    from thth import principals
+    approve(write(bb, [item(URL_A1)]))
+    principals.stop("hatena-main", "owner", actor="tester")
+    out, _ = run(bb)
+    assert out["blocked"]["code"] == "principal_stopped" and "until" not in out["blocked"]
+    principals.resume("hatena-main", by="tester")
+    run(bb, now=later(10))
+    assert states(bb) == ["placed"]

thth-4.2.2/tests/test_v422_sparse_checkout.py

@@ -0,0 +1,148 @@
+"""4.2.2（設計 S6 §17・kopicha の本番 10/18）: sparse-checkout の repo に THTH が記録を書くとき。
+
+本番で起きたこと: レーンの repo の sparse-checkout の定義の外（`data/hatena/reactions/`）に反応の台帳を書き、
+`git add` が断られ続けた（「次で送り直す」が毎回失敗）。
+
+決めたこと（推しと理由は設計 S6 §17）: **`git add --sparse` では載せない。** 定義の外なら読まない・書かず、
+理由と直し方（`git -C <repo> sparse-checkout add <dir>`）を言う。`--sparse` で載せると、次の同期（rebase・
+merge）で git がそのファイルを作業ツリーから消し（skip-worktree）、追記の台帳を次の回が空から書き直して
+履歴を上書きする——その git の振る舞いもここで本物の git で縛る。
+
+repo は `tmp_path` の本物の git（bare の origin つき）。はてなには出ない（公開の読む口は偽物）。
+"""
+from __future__ import annotations
+
+import os
+import subprocess
+
+import pytest
+
+from tests.conftest import init_git_pair, make_queue_text, run_git
+from tests.hatena_s1_flow_helpers import call, lane  # noqa: F401
+from tests.hatena_s2_http import fake_http  # noqa: F401
+from tests.hatena_s6_helpers import NOW, URL1, bm, collect, ledger_file, ledger_rows, put_delivery, s6, world  # noqa: F401
+from tests.test_collect import NOW as SNS_NOW, FakeAdapter
+from thth import collect as collect_mod, hatena_reactions, writeback
+
+
+def git(repo, *args, check=True):
+    result = subprocess.run(["git", "-c", "user.name=t", "-c", "user.email=t@t", "-C", str(repo), *args],
+                            capture_output=True, text=True)
+    if check:
+        assert result.returncode == 0, (args, result.stderr)
+    return result
+
+
+def _queue_rel(lane):  # noqa: F811
+    return os.path.relpath(lane.queue_dir, lane.repo)
+
+
+def _sparse(repo, *dirs, cone=True):
+    if cone:
+        git(repo, "sparse-checkout", "set", "--cone", *dirs)
+    else:
+        git(repo, "sparse-checkout", "set", "--no-cone", *[f"/{d}/" for d in dirs])
+
+
+# ---------------------------------------------------------------- 判定（cone とそうでない形）
+
+@pytest.mark.parametrize("cone", [True, False])
+def test_定義の外を判定する_ファイルが無くても(tmp_path, cone):
+    pair = init_git_pair(tmp_path, seed_content="x")
+    work = pair["work"]
+    assert writeback.sparse_excluded(work, ["data/hatena/reactions/dl_1.ndjson"]) == []   # sparse でない
+    _sparse(work, "data/sns", "docs/sns/queue", cone=cone)
+    got = writeback.sparse_excluded(work, ["data/hatena/reactions/dl_1.ndjson", "data/sns/insights/posts/P.ndjson",
+                                           "docs/sns/queue/a.md"])
+    assert got == ["data/hatena/reactions/dl_1.ndjson"]
+
+
+def test_commit_localは定義の外を載せず理由と直し方を言い_indexに触らない(tmp_path):
+    """柵: `commit_local` の判定を外すと赤（git の断りのまま・直し方を言わない）。"""
+    pair = init_git_pair(tmp_path, seed_content="x")
+    work = pair["work"]
+    _sparse(work, "data/sns")
+    path = os.path.join(work, "data", "hatena", "reactions", "dl_1.ndjson")
+    os.makedirs(os.path.dirname(path))
+    with open(path, "w", encoding="utf-8") as f:
+        f.write("{}\n")
+    inside = os.path.join(work, "data", "sns", "inbox", "x.ndjson")
+    os.makedirs(os.path.dirname(inside))
+    with open(inside, "w", encoding="utf-8") as f:
+        f.write("{}\n")
+    head = git(work, "rev-parse", "HEAD").stdout
+    ok, err = writeback.commit_local(work, rel_path=["data/sns/inbox/x.ndjson", "data/hatena/reactions/dl_1.ndjson"],
+                                     message="m")
+    assert not ok and err.startswith("sparse_checkout_outside: ")
+    assert "data/hatena/reactions" in err and f"git -C {work} sparse-checkout add data/hatena/reactions" in err
+    assert "data/sns" not in err          # 外のものだけを名指す（中のものは git add も呼ばない）
+    assert git(work, "rev-parse", "HEAD").stdout == head
+    assert git(work, "diff", "--cached", "--name-only").stdout == ""
+
+
+def test_git_add_sparseで載せると次の同期で作業ツリーから消える_だから使わない(tmp_path):
+    """設計の根拠（本物の git の振る舞い）。これが変われば設計 S6 §17 の推しを見直す。"""
+    pair = init_git_pair(tmp_path, seed_content="x")
+    work, seed = pair["work"], pair["seed"]
+    _sparse(work, "data/sns")
+    path = os.path.join(work, "data", "hatena", "reactions", "dl_1.ndjson")
+    os.makedirs(os.path.dirname(path))
+    with open(path, "w", encoding="utf-8") as f:
+        f.write("row1\n")
+    git(work, "add", "--sparse", "--", "data/hatena/reactions/dl_1.ndjson")
+    git(work, "commit", "--only", "-m", "r", "--", "data/hatena/reactions/dl_1.ndjson")
+    with open(os.path.join(seed, "b.md"), "w", encoding="utf-8") as f:
+        f.write("b\n")
+    git(seed, "add", "b.md")
+    git(seed, "commit", "-m", "b")
+    git(seed, "push", "origin", "HEAD:main")
+    git(work, "fetch", "origin")
+    git(work, "rebase", "--autostash", "@{u}")
+    assert not os.path.exists(path)                      # 作業ツリーから消えた
+    assert git(work, "ls-files", "-t", "--", "data/hatena").stdout.startswith("S ")   # skip-worktree
+
+
+# ---------------------------------------------------------------- はてなの反応の採取
+
+def test_反応の台帳が定義の外なら読まず書かず理由を言い_足せば載る(s6):
+    """柵: `hatena_reactions._entry` の確かめを外すと赤（書いた台帳を載せられず、毎回「次で送り直す」）。"""
+    _sparse(s6.repo, "articles", "images", _queue_rel(s6), "data/sns")
+    dl = put_delivery(URL1, hours_ago=25)
+    s6.hatena.counts[URL1] = 2
+    s6.hatena.entries[URL1] = [bm("alice"), bm("bob")]
+    logs = []
+    rc = hatena_reactions.run_collect("lane-a-hatenablog", now=NOW, log=logs.append)
+    assert rc == 1
+    assert any("sparse-checkout の定義の外" in line and "sparse-checkout add data/hatena/reactions" in line
+               for line in logs), logs
+    assert s6.hatena.calls == [] and not os.path.exists(ledger_file(dl))
+    from thth import accounts, runs
+    [row] = [r for r in runs.read_runs(accounts.state_dir_for("lane-a-hatenablog")) if r.get("action") == "hatena_collect"]
+    assert row["status"] == "error" and row["error"] == "sparse_outside"
+    # 人が定義に足せば、次の run で読み、載せる（作業ツリーにも残る）
+    git(s6.repo, "sparse-checkout", "add", "data/hatena/reactions")
+    assert collect() == 0
+    assert len(ledger_rows(dl)) == 1 and os.path.exists(ledger_file(dl))
+    assert "data/hatena/reactions/" in run_git(s6.repo, ["ls-tree", "-r", "--name-only", "origin/main"]).stdout
+    assert "data/hatena" not in run_git(s6.repo, ["status", "--porcelain"]).stdout
+
+
+# ---------------------------------------------------------------- SNS の採取（同じ形）
+
+def test_SNSの採取も置き場が定義の外なら採らず書かず理由を言う(tmp_path, isolated_account_factory):
+    """柵: `collect._collect_entry` の確かめを外すと赤（書いた台帳を載せられない）。"""
+    pair = init_git_pair(tmp_path, seed_content=make_queue_text({
+        "status": "posted", "post_id": "POST1", "posted_at": "2026-09-10T10:00:00+09:00"}))
+    account = isolated_account_factory(repo_dir=pair["work"], production=True)
+    _sparse(pair["work"], "docs/sns/queue")
+    adapter = FakeAdapter()
+    logs = []
+    rc = collect_mod.run_collect(account["name"], adapter=adapter, now=SNS_NOW, log=logs.append)
+    assert rc == 1 and adapter.insight_calls == []
+    assert any("sparse-checkout add data/sns" in line for line in logs), logs
+    assert not os.path.exists(os.path.join(pair["work"], "data", "sns"))
+    # 定義に足せば今までどおり（push まで）
+    git(pair["work"], "sparse-checkout", "add", "data/sns")
+    assert collect_mod.run_collect(account["name"], adapter=FakeAdapter(), now=SNS_NOW, log=lambda _l: None) == 0
+    in_origin = git(pair["bare"], "ls-tree", "-r", "--name-only", "main").stdout
+    assert "data/sns/insights/posts/POST1.ndjson" in in_origin

thth-4.2.2/thth/VERSION

@@ -0,0 +1 @@
+4.2.2

{thth-4.2.1 → thth-4.2.2}/thth/admin_log.py

@@ -65,6 +65,8 @@ EVENTS = frozenset(('account_added', 'account_updated', 'deletion_requested', 'a
                    # 4.1（S4 §20）: ブックマークの札をまとめて承認した（札の数だけ）。運用通知は送らない
                    # （`admin_notifications.SELECTED` に無い・下の transaction の通知の道でも飛ばす）。
                    'bookmark_batch_approved',
+                   # 4.2.2（S4 §24）: 止まったブックマークのまとめを人が解いた（止まっていた符丁だけ）。通知は送らない。
+                   'bookmark_batch_resumed',
                    # 上限と連投の柵 段 4（§9.2）: 人が媒体の観測を足した（媒体と kind の語だけ）。通知は送らない。
                    'media_observed'))
 SECRET = re.compile(r'token|secret|client_id|password|jwt|env|email|notification|smtp|ping|verifier|private_key', re.I)
@@ -275,7 +277,7 @@ def transaction(*, rollback=None):
                                       'credential_rotated', 'credential_revoked', 'settings_set',
                                       'schedule_cancelled', 'guard_stopped', 'guard_resumed',
                                       'publish_held', 'publish_resumed',
-                                      'bookmark_batch_approved', 'media_observed'):
+                                      'bookmark_batch_approved', 'bookmark_batch_resumed', 'media_observed'):
                     continue
                 cfg = accounts.load_account(event['account'])
                 admin_notifications.notify(event, cfg)