thth 2.3.1__tar.gz → 2.3.2__tar.gz

{thth-2.3.1 → thth-2.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: thth
-Version: 2.3.1
+Version: 2.3.2
 Summary: 承認済みの投稿だけを投げる門（Threads・Bluesky・Mastodon）。人が承認し、記録は利用者の git に残る。
 Project-URL: Homepage, https://thth.me
 Project-URL: Source, https://github.com/aokings/thth
@@ -45,7 +45,7 @@ watchtower（`~/Developer/watchtower`）の隣に同じ流儀で並べる。watc
 
 ## いまの状態（2026-09-13）
 
-版 **2.3.1**。全件テスト **2287 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。
+版 **2.3.2**。全件テスト **2310 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。
 
 **媒体**: Threads（稼働）・Bluesky・Mastodon（同席用の台帳あり・未稼働）。
 
@@ -79,7 +79,7 @@ timer（systemd・`thth systemd` で生成）で毎時投稿、返信の採集
 - **英語の文書**: [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` の全 34 サブコマンド）: `lint`・`preview`・`approve`・`account`・`revoke`・`posts`・`replies`・`measured`・`threads`・`after`・`topics`・`forms`・`queue`・`schedule`・`throw`・`run`・`systemd`・`board`・`collect`・`auth`・`refresh`・`maintain`・`send`・`doctor`・`app`・`token`・`ask`・`mentions`・`profile`・`thread`・`where`・`who`・`retract`・`location`。
+- **動くもの**（`thth --help` の全 35 サブコマンド）: `lint`・`preview`・`approve`・`account`・`revoke`・`posts`・`replies`・`measured`・`threads`・`after`・`topics`・`forms`・`queue`・`schedule`・`throw`・`run`・`systemd`・`board`・`collect`・`pull`・`auth`・`refresh`・`maintain`・`send`・`doctor`・`app`・`token`・`ask`・`mentions`・`profile`・`thread`・`where`・`who`・`retract`・`location`。
 - **最初の本番投稿の記録**: 2026-09-09、@aoking に疎通確認を 1 本（`17916074118445631`）。
 - **未着手**: X・Facebook ページ・Instagram の各アダプタ。トピック検索の権限（tester には降りない）。泉のサーバ（v2-5）。
 - **権限の制約**: tester に降りる scope は 5 つ。削除はできない。

{thth-2.3.1 → thth-2.3.2}/README.md

@@ -21,7 +21,7 @@ watchtower（`~/Developer/watchtower`）の隣に同じ流儀で並べる。watc
 
 ## いまの状態（2026-09-13）
 
-版 **2.3.1**。全件テスト **2287 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。
+版 **2.3.2**。全件テスト **2310 件**（`python -m pytest tests/ -q -n auto -p no:cacheprovider`・1 skip・rc=0）。
 
 **媒体**: Threads（稼働）・Bluesky・Mastodon（同席用の台帳あり・未稼働）。
 
@@ -55,7 +55,7 @@ timer（systemd・`thth systemd` で生成）で毎時投稿、返信の採集
 - **英語の文書**: [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` の全 34 サブコマンド）: `lint`・`preview`・`approve`・`account`・`revoke`・`posts`・`replies`・`measured`・`threads`・`after`・`topics`・`forms`・`queue`・`schedule`・`throw`・`run`・`systemd`・`board`・`collect`・`auth`・`refresh`・`maintain`・`send`・`doctor`・`app`・`token`・`ask`・`mentions`・`profile`・`thread`・`where`・`who`・`retract`・`location`。
+- **動くもの**（`thth --help` の全 35 サブコマンド）: `lint`・`preview`・`approve`・`account`・`revoke`・`posts`・`replies`・`measured`・`threads`・`after`・`topics`・`forms`・`queue`・`schedule`・`throw`・`run`・`systemd`・`board`・`collect`・`pull`・`auth`・`refresh`・`maintain`・`send`・`doctor`・`app`・`token`・`ask`・`mentions`・`profile`・`thread`・`where`・`who`・`retract`・`location`。
 - **最初の本番投稿の記録**: 2026-09-09、@aoking に疎通確認を 1 本（`17916074118445631`）。
 - **未着手**: X・Facebook ページ・Instagram の各アダプタ。トピック検索の権限（tester には降りない）。泉のサーバ（v2-5）。
 - **権限の制約**: tester に降りる scope は 5 つ。削除はできない。

thth-2.3.2/tests/test_behind_remote.py

@@ -0,0 +1,137 @@
+"""`writeback.behind_remote()` と `thth queue`/`schedule`/`board` の遅れ表示
+（発注 T8-2・kopicha 続報）。
+
+`thth approve`（と `revoke`・`throw`・`collect`・`retract`）は既に
+`writeback.sync_repo()` を通しているが、**読むだけの口**（`queue`・
+`schedule`・`board`）は通していない。push した直後に読むだけの口を見ると、
+timer の `collect` が pull するまでの間、まだ取り込み前の一覧が出る
+——**読むだけの口が勝手に pull するのは避ける**のが設計の芯なので、
+ここでは「遅れていることを言う」だけを確かめる（取り込みは T8-3 の
+`thth pull` か `thth approve` が行う）。
+"""
+from __future__ import annotations
+
+from tests.conftest import init_git_pair, run_git, run_thth, write_queue_file
+from thth import writeback
+
+
+def test_behind_remoteは追いついていれば0(tmp_path):
+    pair = init_git_pair(tmp_path / "a", seed_content="", seed_name=".gitkeep")
+    info = writeback.behind_remote(pair["work"])
+    assert info == {"behind": 0, "ahead": 0, "head": info["head"],
+                     "fetched_at": info["fetched_at"], "reason": None}
+    assert info["head"]
+    assert info["reason"] is None
+
+
+def test_behind_remoteはfetchだけでpullしない(tmp_path):
+    """**pull はしない**——fetch のあと、work の作業ツリー（HEAD）は動かない。"""
+    pair = init_git_pair(tmp_path / "a", seed_content="旧", seed_name="a.md")
+    head_before = run_git(pair["work"], ["rev-parse", "HEAD"]).stdout.strip()
+
+    run_git(pair["seed"], ["commit", "--allow-empty", "-m", "second"])
+    run_git(pair["seed"], ["push"])
+
+    info = writeback.behind_remote(pair["work"])
+    assert info["behind"] == 1
+    assert info["ahead"] == 0
+
+    head_after = run_git(pair["work"], ["rev-parse", "HEAD"]).stdout.strip()
+    assert head_after == head_before, "fetch だけのはずが HEAD が動いた（pull してしまった）"
+
+
+def test_behind_remoteはfetchできないとNoneとreason(tmp_path):
+    broken = tmp_path / "broken"
+    run_git_init = __import__("subprocess").run(
+        ["git", "init", "-b", "main", str(broken)], capture_output=True, text=True)
+    assert run_git_init.returncode == 0
+    run_git(str(broken), ["remote", "add", "origin", "/does/not/exist/repo.git"])
+    run_git(str(broken), ["commit", "--allow-empty", "-m", "x"])
+
+    info = writeback.behind_remote(str(broken))
+    assert info["behind"] is None
+    assert info["ahead"] is None
+    assert info["reason"]
+    assert "0" != info["reason"]  # **0 と混ぜない**: reason があるのに behind: 0 ではない
+
+
+def test_queueは遅れているときに先頭に1行(isolated_account_factory, tmp_path):
+    pair = init_git_pair(tmp_path / "acct", seed_content="", seed_name=".gitkeep")
+    account = isolated_account_factory(repo_dir=pair["work"])
+    write_queue_file(account["queue_dir"], "a.md",
+                      fm_overrides={"status": "draft", "account": account["name"]})
+
+    # **`seed` を origin の最新に合わせてから**新しい commit を積む（`work` の
+    # `write_queue_file()` push で origin が進んでいるため、合わせないと
+    # `seed` の push 自体が non-fast-forward で失敗する）。
+    run_git(pair["seed"], ["pull"])
+    run_git(pair["seed"], ["commit", "--allow-empty", "-m", "second"])
+    run_git(pair["seed"], ["push"])
+
+    result = run_thth(["queue", account["name"]])
+    assert result.returncode == 0, result.stderr
+    assert "remote に 1 commit 分の新しいものがあります" in result.stdout
+    assert f"thth pull {account['name']}" in result.stdout
+
+
+def test_queueは遅れていなければ何も出さない(isolated_account_factory, tmp_path):
+    pair = init_git_pair(tmp_path / "acct", seed_content="", seed_name=".gitkeep")
+    account = isolated_account_factory(repo_dir=pair["work"])
+    write_queue_file(account["queue_dir"], "a.md",
+                      fm_overrides={"status": "draft", "account": account["name"]})
+
+    result = run_thth(["queue", account["name"]])
+    assert result.returncode == 0, result.stderr
+    assert "remote に" not in result.stdout
+    assert "thth pull" not in result.stdout
+
+
+def test_queueのjsonにrepoが乗る(isolated_account_factory, tmp_path):
+    pair = init_git_pair(tmp_path / "acct", seed_content="", seed_name=".gitkeep")
+    account = isolated_account_factory(repo_dir=pair["work"])
+    write_queue_file(account["queue_dir"], "a.md",
+                      fm_overrides={"status": "draft", "account": account["name"]})
+
+    result = run_thth(["queue", account["name"], "--json"])
+    assert result.returncode == 0, result.stderr
+    import json
+    out = json.loads(result.stdout)
+    assert out[account["name"]]["repo"]["behind"] == 0
+
+
+def test_scheduleは遅れているときに先頭に1行(isolated_account_factory, tmp_path):
+    pair = init_git_pair(tmp_path / "acct", seed_content="", seed_name=".gitkeep")
+    account = isolated_account_factory(repo_dir=pair["work"])
+    write_queue_file(account["queue_dir"], "a.md",
+                      fm_overrides={"status": "draft", "account": account["name"],
+                                    "publish_at": "2026-09-20T08:00:00+09:00"})
+
+    run_git(pair["seed"], ["pull"])
+    run_git(pair["seed"], ["commit", "--allow-empty", "-m", "second"])
+    run_git(pair["seed"], ["push"])
+
+    result = run_thth(["schedule", account["name"]])
+    assert result.returncode == 0, result.stderr
+    assert "remote に 1 commit 分の新しいものがあります" in result.stdout
+
+
+def test_boardは遅れているaccountの行の下に1行(isolated_account_factory, tmp_path):
+    pair = init_git_pair(tmp_path / "acct", seed_content="", seed_name=".gitkeep")
+    account = isolated_account_factory(repo_dir=pair["work"])
+
+    run_git(pair["seed"], ["commit", "--allow-empty", "-m", "second"])
+    run_git(pair["seed"], ["push"])
+
+    result = run_thth(["board"])
+    assert result.returncode == 0, result.stderr
+    assert "repo が 1 commit 遅れています" in result.stdout
+    assert f"thth pull {account['name']}" in result.stdout
+
+
+def test_boardは遅れていなければ何も出さない(isolated_account_factory, tmp_path):
+    pair = init_git_pair(tmp_path / "acct", seed_content="", seed_name=".gitkeep")
+    isolated_account_factory(repo_dir=pair["work"])
+
+    result = run_thth(["board"])
+    assert result.returncode == 0, result.stderr
+    assert "repo が" not in result.stdout

thth-2.3.2/tests/test_cli_vm_path.py

@@ -0,0 +1,80 @@
+"""VM に無いパスを渡したときの断り方（発注 T8-1・kopicha 続報）。
+
+`~/.local/bin/thth` は Mac から VM へ ssh する薄いラッパで、引数はそのまま
+VM 側の `thth` に渡る。**Mac 側の相対パスも絶対パスも VM には無い**ので、
+いままでは `FileNotFoundError` の素の traceback が出ていた（`--article
+/tmp/x.json` で踏んだのと同じ根）。
+
+ファイルを受け取る全ての引数（`lint`・`approve`・`revoke`・`preview`・
+`send --text-file`・`topics suggest` の queue ファイル・`--article`・
+`--proposal`・`--input`・`--draft`・`--revised-draft`）が、共通の
+`cli._require_vm_path()` を通って rc=2・案内つきで断ることを確かめる。
+存在するパスは従来どおり動くことも確かめる（回帰）。
+"""
+from __future__ import annotations
+
+import os
+
+from tests.conftest import run_thth, write_queue_file
+
+MISSING = "/tmp/thth-t8-does-not-exist-まさかここには無い.md"
+MISSING_JSON = "/tmp/thth-t8-does-not-exist-まさかここには無い.json"
+
+
+def _assert_vm_refusal(result, *, rc=2):
+    combined = result.stdout + result.stderr
+    assert result.returncode == rc, f"rc={result.returncode}: {combined}"
+    assert "VM" in combined, combined
+    assert "thth queue" in combined, combined
+    assert "Traceback" not in result.stderr, result.stderr
+
+
+def test_lintにVMに無いパスを渡すとrc2で案内する():
+    result = run_thth(["lint", MISSING])
+    _assert_vm_refusal(result)
+
+
+def test_approveにVMに無いパスを渡すとrc2で案内する():
+    result = run_thth(["approve", MISSING])
+    _assert_vm_refusal(result)
+
+
+def test_sendのtext_fileにVMに無いパスを渡すとrc2で案内する(isolated_account):
+    result = run_thth(["send", isolated_account["name"], "--text-file", MISSING])
+    _assert_vm_refusal(result)
+
+
+def test_topics_suggestのarticleにVMに無いパスを渡すとrc2で案内する(isolated_account):
+    queue_path = write_queue_file(
+        isolated_account["queue_dir"], "q.md",
+        body="## threads\n\nhello https://example.test/x\n",
+        fm_overrides={"status": "draft", "account": isolated_account["name"]})
+    result = run_thth(["topics", "suggest", queue_path, "--article", MISSING_JSON])
+    _assert_vm_refusal(result)
+
+
+def test_revokeにVMに無いパスを渡すとrc2で案内する():
+    result = run_thth(["revoke", MISSING, "--by", "test"])
+    _assert_vm_refusal(result)
+
+
+def test_previewにVMに無いパスを渡すとrc2で案内する():
+    result = run_thth(["preview", MISSING])
+    _assert_vm_refusal(result)
+
+
+def test_存在するパスは従来どおり動く(isolated_account):
+    """回帰: 存在するパスには案内を出さない（発注書「存在するパスは従来どおり」）。"""
+    queue_path = write_queue_file(
+        isolated_account["queue_dir"], "ok.md",
+        body="## threads\n\nこんにちは https://example.test/x\n",
+        fm_overrides={"status": "draft", "account": isolated_account["name"]})
+    assert os.path.exists(queue_path)
+
+    result = run_thth(["lint", queue_path])
+    assert "VM" not in (result.stdout + result.stderr)
+    assert "thth queue" not in (result.stdout + result.stderr)
+
+    result = run_thth(["preview", queue_path])
+    assert result.returncode == 0, result.stderr
+    assert "こんにちは" in result.stdout

thth-2.3.2/tests/test_pull_cli.py

@@ -0,0 +1,96 @@
+"""`thth pull <account|--project P>`（発注 T8-3・kopicha 続報）。
+
+読むだけの口（`queue`・`schedule`・`board`。T8-2）は遅れを**言うだけ**で
+pull しない。この道具は、その案内から誘導される**明示の**取り込み口——
+`writeback.sync_repo()` を呼ぶだけで、`thth approve` が既に通しているのと
+同じ関数・同じ repo ロックを使う。
+"""
+from __future__ import annotations
+
+import json
+
+from tests.conftest import init_git_pair, run_git, run_thth
+
+
+def test_pullはffして取り込む(isolated_account_factory, tmp_path):
+    pair = init_git_pair(tmp_path / "acct", seed_content="旧", seed_name="a.md")
+    account = isolated_account_factory(repo_dir=pair["work"])
+    head_before = run_git(pair["work"], ["rev-parse", "--short", "HEAD"]).stdout.strip()
+
+    run_git(pair["seed"], ["commit", "--allow-empty", "-m", "second"])
+    run_git(pair["seed"], ["push"])
+    head_after_remote = run_git(pair["seed"], ["rev-parse", "--short", "HEAD"]).stdout.strip()
+
+    result = run_thth(["pull", account["name"]])
+    assert result.returncode == 0, result.stderr
+    assert f"取り込みました: {head_before} → {head_after_remote}（1 commit）" in result.stdout
+
+    # 本当に取り込まれている（work の HEAD が動いた）。
+    head_now = run_git(pair["work"], ["rev-parse", "--short", "HEAD"]).stdout.strip()
+    assert head_now == head_after_remote
+
+
+def test_pullはすでに最新なら何も変えない(isolated_account_factory, tmp_path):
+    pair = init_git_pair(tmp_path / "acct", seed_content="", seed_name=".gitkeep")
+    account = isolated_account_factory(repo_dir=pair["work"])
+    head_before = run_git(pair["work"], ["rev-parse", "--short", "HEAD"]).stdout.strip()
+
+    result = run_thth(["pull", account["name"]])
+    assert result.returncode == 0, result.stderr
+    assert "すでに最新です" in result.stdout
+
+    head_after = run_git(pair["work"], ["rev-parse", "--short", "HEAD"]).stdout.strip()
+    assert head_after == head_before
+
+
+def test_pullのjsonはbehind_remoteの形(isolated_account_factory, tmp_path):
+    pair = init_git_pair(tmp_path / "acct", seed_content="", seed_name=".gitkeep")
+    account = isolated_account_factory(repo_dir=pair["work"])
+
+    result = run_thth(["pull", account["name"], "--json"])
+    assert result.returncode == 0, result.stderr
+    out = json.loads(result.stdout)
+    assert len(out) == 1
+    row = out[0]
+    assert row["account"] == account["name"]
+    assert row["ok"] is True
+    assert set(row["repo"].keys()) == {"behind", "ahead", "head", "fetched_at", "reason"}
+    assert row["repo"]["behind"] == 0
+
+
+def test_pullのprojectは同じrepoを共有する2accountで1回だけ引く(
+        isolated_account_factory, tmp_path):
+    pair = init_git_pair(tmp_path / "acct", seed_content="旧", seed_name="a.md")
+    account_a = isolated_account_factory("a-threads", repo_dir=pair["work"], project="shared")
+    account_b = isolated_account_factory("b-threads", repo_dir=pair["work"], project="shared")
+    assert account_a["repo_dir"] == account_b["repo_dir"]
+
+    run_git(pair["seed"], ["commit", "--allow-empty", "-m", "second"])
+    run_git(pair["seed"], ["push"])
+
+    result = run_thth(["pull", "--project", "shared", "--json"])
+    assert result.returncode == 0, result.stderr
+    out = json.loads(result.stdout)
+    # **重複なく 1 回だけ**——2 account だが repo は 1 つ。
+    assert len(out) == 1
+    assert out[0]["repo"]["behind"] == 0
+
+
+def test_pullは失敗をsync_repoの理由のままrc1(isolated_account_factory, tmp_path):
+    account = isolated_account_factory(repo_dir=str(tmp_path / "no-such-repo-dir"))
+
+    result = run_thth(["pull", account["name"]])
+    assert result.returncode == 1, result.stdout
+    assert "取り込めませんでした" in result.stderr or "見当たりません" in result.stderr
+
+
+def test_pullはaccountもprojectも無ければ断る(isolated_account_factory):
+    result = run_thth(["pull"])
+    assert result.returncode == 2
+    assert "account" in result.stderr
+
+
+def test_pullは未知のprojectを断る(isolated_account_factory):
+    result = run_thth(["pull", "--project", "no-such-project"])
+    assert result.returncode == 2
+    assert "no-such-project" in result.stderr

thth-2.3.2/thth/VERSION

@@ -0,0 +1 @@
+2.3.2