thth 3.1.1__tar.gz → 3.2.0__tar.gz

{thth-3.1.1 → thth-3.2.0}/PKG-INFO

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

{thth-3.1.1 → thth-3.2.0}/README.md

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

{thth-3.1.1 → thth-3.2.0}/mcp/server.py

@@ -534,6 +534,24 @@ ADMIN_TOOLS.append({'name':'thth_admin_watch_set','description':'Replace the wat
                    'words':{'type':'array','items':{'type':'string'}}},
                    'required':['account','words','by'],'additionalProperties':False}})
 
+# 報告の口の実装側（設計 3.1.2 §1）。返事と閉じるは `by` 必須・変更ログに
+# presence-only で残る。書き出し（export）は repo に書くので CLI だけ。
+ADMIN_TOOLS += [
+    {'name':'thth_admin_reports_list','description':'List bug reports and requests from every project (status open by default, or closed/all); administrator only; read-only',
+     'inputSchema':{'type':'object','properties':{'status':{'type':'string','enum':['open','closed','all']}},
+                    'required':[],'additionalProperties':False}},
+    {'name':'thth_admin_reports_show','description':'Read one report with its body, reproduction steps and replies; administrator only; read-only',
+     'inputSchema':{'type':'object','properties':{'report_id':{'type':'string'}},
+                    'required':['report_id'],'additionalProperties':False}},
+    {'name':'thth_admin_reports_reply','description':'Add a reply to one report (shown to the reporter in operations_handoff tool.reports); administrator only, by required; refused if the text looks like a secret',
+     'inputSchema':{'type':'object','properties':{'report_id':{'type':'string'},'text':{'type':'string'},'by':{'type':'string'}},
+                    'required':['report_id','text','by'],'additionalProperties':False}},
+    {'name':'thth_admin_reports_close','description':'Close one report with a reason (fixed, wontfix, duplicate, invalid) and the version that settled it; administrator only, by required',
+     'inputSchema':{'type':'object','properties':{'report_id':{'type':'string'},'by':{'type':'string'},
+                    'reason':{'type':'string','enum':['fixed','wontfix','duplicate','invalid']},'version':{'type':'string'}},
+                    'required':['report_id','reason','version','by'],'additionalProperties':False}},
+]
+
 SERVER_TOOLS = [
     {"name":"thth_"+name,"description":"Scoped server "+name,
      "inputSchema":{"type":"object","properties":{key:{"type":"string"} for key in ("account",*keys)},
@@ -566,6 +584,60 @@ del _tool
 
 
 
+# 報告の口の利用者側（設計 3.1.2 §1）。**サーバ型だけに出す**——手元の stdio
+# （pip 版）で置いても実装側には届かないので、届かない口は並べない。誰が置いたかは
+# credential の `actor` が決める（要求の欄からは作らない）。
+REPORT_TOOLS = [
+    {"name": "thth_report_file",
+     "description": "道具が断った・結果が期待と違った・欲しい形がある、のどれかならこれで置く"
+                    "（kind は bug か request。実装側が読み、返事は thth_report_show と "
+                    "operations_handoff の tool.reports に出る。秘密らしき値が含まれていたら置かない）",
+     "inputSchema": {"type": "object", "properties": {
+         "account": {"type": "string"},
+         "kind": {"type": "string", "enum": ["bug", "request"]},
+         "title": {"type": "string", "description": "1 行・120 字まで"},
+         "body": {"type": "string", "description": "8,000 字まで"},
+         "repro": {"type": "string", "description": "再現手順（任意・4,000 字まで）"}},
+         "required": ["account", "kind", "title", "body"], "additionalProperties": False}},
+    {"name": "thth_report_list",
+     "description": "自分の project の報告と、実装側の返事の数を読む（読むだけ）",
+     "inputSchema": {"type": "object", "properties": {
+         "status": {"type": "string", "enum": ["open", "closed", "all"]}},
+         "additionalProperties": False}},
+    {"name": "thth_report_show",
+     "description": "報告 1 件の本文と実装側の返事を読む（読むだけ）",
+     "inputSchema": {"type": "object", "properties": {"report_id": {"type": "string"}},
+                     "required": ["report_id"], "additionalProperties": False}},
+    # 報告した側の追記（設計 3.2.0 §4.5-1）。
+    {"name": "thth_report_add",
+     "description": "自分の project の開いている報告に書き足す（返事と同じ列に並ぶ・4,000 字まで・"
+                    "閉じた報告には足せない・秘密らしき値が含まれていたら足さない）",
+     "inputSchema": {"type": "object", "properties": {
+         "report_id": {"type": "string"},
+         "text": {"type": "string", "description": "4,000 字まで"}},
+         "required": ["report_id", "text"], "additionalProperties": False}},
+]
+
+
+# **うまくいかなければ報告の口へ**（設計 3.1.2 §3.5）。利用者の道具の説明文の
+# 末尾に 1 句。定数（TOOLS 等）は書き換えず、並べるときに足す——「売り文句」の
+# 正本（設計 v2 §1・「自分の泉」§2）はそのまま残る。
+REPORT_HINT = "（うまくいかなければ thth_report_file）"
+
+
+def _with_report_hint(tools):
+    return [tool if tool["name"].startswith("thth_report_")
+            else dict(tool, description=tool["description"] + REPORT_HINT) for tool in tools]
+
+
+def _channel_note():
+    """断りの応答に添える 2 つ目の text（静的な 1 行・本文も account 名も入れない）。"""
+    if APP_DIR not in sys.path:
+        sys.path.insert(0, APP_DIR)
+    from thth.report_inbox import CHANNEL_LINE
+    return {"type": "text", "text": CHANNEL_LINE}
+
+
 def server_mode():
     return 'THTH_REPORT_CREDENTIALS' in os.environ or 'THTH_REPORT_TOKEN' in os.environ
 
@@ -579,15 +651,16 @@ def server_tools(context):
     # account／project しか対象にできない（`report_service.execute_morning()`）。
     reports = reports + [tool for tool in TOOLS if tool['name']=='thth_morning']
     from thth.server_writes import WRITE_OPERATIONS
-    return reports + [tool for tool in SERVER_TOOLS
-                      if context.writes or tool['name'][5:] not in WRITE_OPERATIONS]
+    return _with_report_hint(reports + [tool for tool in SERVER_TOOLS
+                      if context.writes or tool['name'][5:] not in WRITE_OPERATIONS]) + REPORT_TOOLS
 
 
 def server_call(name, arguments):
     from thth.report_service import execute_report, execute_mcp_report, ReportServiceError
     from thth.server_writes import execute, WRITE_OPERATIONS, SAFE_ERRORS, DRAFT_REASONS
     context=authenticated_context()
-    failure=lambda value:{'content':[{'type':'text','text':value}],'isError':True}
+    # 断りは 1 つ目の text が静的な理由、2 つ目が受け口の案内（設計 3.1.2 §3.5）。
+    failure=lambda value:{'content':[{'type':'text','text':value},_channel_note()],'isError':True}
     if context is None: return failure('unauthorized')
     tool=next((tool for tool in server_tools(context) if tool['name']==name),None)
     if tool is None: return failure('unsupported_operation')
@@ -613,6 +686,12 @@ def server_call(name, arguments):
             result=execute_admin_write(context,request)
         elif operation in WRITE_OPERATIONS:
             result=execute(context,request,via='mcp')
+        elif operation.startswith('admin_reports_'):
+            from thth.report_service import execute_admin_reports
+            result=execute_admin_reports(context,request)
+        elif operation in ('report_file','report_list','report_show','report_add'):
+            from thth.report_service import execute_user_reports
+            result=execute_user_reports(context,request)
         elif operation=='morning':
             from thth.report_service import execute_morning
             result=execute_morning(context,request)
@@ -626,7 +705,11 @@ def server_call(name, arguments):
             # 理由は静的な符丁の表にあるものだけ。lint の自由文は通さない。
             detail=getattr(exc,'reason',None)
             return failure('invalid_draft: '+(detail if detail in DRAFT_REASONS else 'validation_failed'))
-        return failure(str(exc) if str(exc) in SAFE_ERRORS or str(exc) in ('budget_change_durability_unconfirmed','budget_change_partially_recorded','budget_change_refused','watch_change_refused') else 'request_unavailable')
+        from thth.report_inbox import REASONS as REPORT_REASONS
+        if str(exc)=='duplicate_report' and getattr(exc,'report_id',None):
+            # 既存の id は同じ account の報告だけ（重複の検査がそう絞っている）。
+            return failure('duplicate_report: '+exc.report_id)
+        return failure(str(exc) if str(exc) in SAFE_ERRORS or str(exc) in REPORT_REASONS or str(exc) in ('budget_change_durability_unconfirmed','budget_change_partially_recorded','budget_change_refused','watch_change_refused') else 'request_unavailable')
     except Exception:
         return failure('request_unavailable')
 
@@ -670,7 +753,7 @@ def call_tool(name: str, arguments: dict | None) -> dict:
     if isinstance(name, str) and name.startswith("thth_admin_"):
         context = admin_context()
         if context is None:
-            return {"content": [{"type": "text", "text": "unauthorized"}], "isError": True}
+            return {"content": [{"type": "text", "text": "unauthorized"}, _channel_note()], "isError": True}
         from thth.report_service import execute_report, ReportServiceError
         try:
             if "operation" in arguments: raise ReportServiceError("invalid_request")
@@ -679,7 +762,7 @@ def call_tool(name: str, arguments: dict | None) -> dict:
             return {"content": [{"type": "text", "text": json.dumps(result, ensure_ascii=False)}]}
         except (ValueError, TypeError, ReportServiceError) as error:
             reason = "invalid_options" if str(error) == "invalid_options" else "invalid_request"
-            return {"content": [{"type": "text", "text": reason}], "isError": True}
+            return {"content": [{"type": "text", "text": reason}, _channel_note()], "isError": True}
     if name == "thth_lint":
         proc = run_cli(["lint", arguments["file"], "--json"])
         text = proc.stdout
@@ -838,7 +921,7 @@ def call_tool(name: str, arguments: dict | None) -> dict:
         proc = run_cli(args)
         text = proc.stdout
     else:
-        return {"content": [{"type": "text", "text": f"unknown tool: {name}"}], "isError": True}
+        return {"content": [{"type": "text", "text": f"unknown tool: {name}"}, _channel_note()], "isError": True}
 
     if name.startswith("thth_topic_") or name in (
             "before_you_post", "after_you_posted", "analytics_report", "operations_handoff", "study_report", "thread_read", "where_to_appear",
@@ -854,7 +937,11 @@ def call_tool(name: str, arguments: dict | None) -> dict:
         is_error = proc.returncode not in (0, 1)  # lint は 1 も正常な「検査結果」
     if not text:
         text = proc.stderr
-    return {"content": [{"type": "text", "text": text}], "isError": is_error}
+    content = [{"type": "text", "text": text}]
+    # 断りなら受け口の案内を 2 つ目に（CLI の理由行に既に載っていれば重ねない）。
+    if is_error and _channel_note()["text"] not in text:
+        content.append(_channel_note())
+    return {"content": content, "isError": is_error}
 
 
 def _send(obj: dict) -> None:

{thth-3.1.1 → thth-3.2.0}/skills/thth/SKILL.md

@@ -5,6 +5,8 @@ description: 投稿する前・返信を書く前・出したあと・絡みに
 
 **開始時は、まず `thth_morning`（CLI は `thth morning <project|account> --json`）を 1 回。** 昨日から何があって今日なにをすればよいかが 6 段（道具・返していないもの・昨日の自分・世間・予定・次の一手）で返る。`handoff-report --since-last-read` を包含するので、版の確認もこれ 1 回で済む。呼ぶと栞（前回読んだ時点）が進む——進めたくないときだけ `mark: false`（CLI は `--no-mark`）。取れなかった段は `{"value": null, "cannot_say": "<理由>"}`（`provider_timeout`・`budget_exhausted`・`scope_missing`・`no_watch_words`・`not_supported`・`unavailable`）で、**0 件とは別**。第 3 段の監視語は**管理者が入れる**（`thth admin watch set <account> 語 … --by <名前>`）——語が無い account は `no_watch_words` で飛ぶので、**代わりに語を選ばない**。第 5 段は候補の列挙だけで、**本文は返らない**（書くのはあなたと人の会話の側）。詳しくは `docs/使い方_毎朝の一枚_3.1.md`。
 
+**断られたら・違和感があれば報告の口へ**: `thth_report_file`（CLI は `thth report file <account> --kind bug|request --title … --body-file … --by <名前>`）。道具が断った・結果が期待と違った・欲しい形がある、のどれかなら 1 回で置ける。返事は `thth_report_show` と `handoff-report --since-last-read` の `tool.reports` に出る。秘密らしき値が含まれていたら置かれない（伏せてから置き直す）。
+
 段だけを読み直したいときは `thth handoff-report <account> --since-last-read --json` を読む。`tool.changed_since_last_read` が真なら、手元の `tool.notes_root_local_hint` を手掛かりに `tool.release_notes` の相対名を読んでから作業する。既読の記録は `--mark-read --by <名前>` の明示時だけ。`tool.notes_reason` が `notes_directory_unavailable` なら、このインストールには読める docs がない。空の `release_notes` を「変更なし」と解釈しない。
 
 添付を付ける前に `tool.capabilities` を読む（媒体ごとの「出せるもの」表。`thth doctor` にも同じ表が出る。`unverified` は「非対応」ではない）。
@@ -106,6 +108,12 @@ found_by: where_to_appear|manual|mention
 untracked/コミット前のファイル）。語を選ぶときだけ `before_you_post`
 （原稿本文は渡さない・件数と期間つきで返す）。
 
+**まだ出ていない自分の原稿へ返すとき（3.2.0）**: `reply_to` の代わりに
+`reply_to_file: <同じ queue・同じ account の原稿のファイル名>` と書く（パスは書けない・
+`reply_to` との併用不可）。指した原稿が出るまで待ち、出たらその post_id に返す——
+**root には落とさない**。待っている間は `thth board`・`thth morning` に「返信待ち」として
+名前と待ち先が出る（時刻超過には数えない）。承認の指紋は `file:<名前>`。
+
 ### 5. 承認——二段（そのまま）
 
 ```bash
@@ -141,6 +149,8 @@ MCP `after_you_posted`。**24h の刻みが無ければ `null`**（0 と混ぜ
 
 - `thth --help` / `thth <subcommand> --help` が正本。
 - `thth doctor <account>` が「いま投稿できる状態か」を最初から最後まで言う。
+- 道具の不具合・欲しい形は `thth report file`（MCP `thth_report_file`）で実装側に届ける。
+- 自分の開いている報告に書き足すなら `thth report add <report_id> --body-file <path|-> --by <名前>`（MCP `thth_report_add`）。
 - 使い方の全文: `docs/使い方_プロジェクトのセッション向け_2026-09-09.md`。
 
 ## 運用と分析のレポート（v3系・2.5.0 から）

{thth-3.1.1 → thth-3.2.0}/skills/thth-admin/SKILL.md

@@ -3,7 +3,7 @@ name: thth-admin
 description: Read authenticated THTH administrator inventory, changes and token status; hand findings to a person.
 ---
 
-開始時は `thth admin diff --since-last-read --json` を読み、変化があった account を `thth admin account <name> --json` で確認する。週1回 `thth admin tokens --json` を確認する。
+開始時は `thth admin diff --since-last-read --json` を読み、変化があった account を `thth admin account <name> --json` で確認する。利用者からの不具合と要望は `thth admin reports list --json`（MCP `thth_admin_reports_list`・既定は開いているものだけ）で読み、`show <id>` で全文を見る。返事は `thth admin reports reply <id> --by <名前> --text-file <file>`、閉じるときは `close <id> --by <名前> --reason fixed|wontfix|duplicate|invalid --version <版>`。返事と閉じるは人（masaru）の判断を経てから打つ。写しを残すときは `thth admin reports export --to <私有の dir> --by <名前>`。**私有の置き場へ。公開 repo には置かない**（本文は利用者が書いた文。既定の行き先は無い）。週1回 `thth admin tokens --json` を確認する。
 
 読んだ結果から承認・投稿・設定変更をしない。必要な対処は根拠・欠測理由・観測時刻とともに人に渡す。記録が無い null は正常・停止・期限なしの証拠ではない。API probe は人が明示的に必要とした場合の CLI `--probe` のみ。
 

{thth-3.1.1 → thth-3.2.0}/tests/conftest.py

@@ -35,8 +35,10 @@ DEFAULT_FM = {
     "posted_at": None,
 }
 
+# `reply_to_file`（設計 3.2.0）・`retracted_at` は既定の front-matter に入れない
+# （`fm_overrides` で渡したときだけ書く）——既存の試験の原稿を 1 行も変えないため。
 FM_ORDER = ["thth", "account", "publish_at", "status", "approved_sha", "approved_at",
-            "topic", "reply_to", "post_id", "posted_at"]
+            "topic", "reply_to", "reply_to_file", "post_id", "posted_at", "retracted_at"]
 
 # quiet_hours の既定（22:00〜07:00）の外にある値。frozen_now_jst() の既定値に使う。
 FIXED_NOW_JST = datetime.datetime(2026, 9, 9, 10, 0, 0, tzinfo=jst.JST)
@@ -143,7 +145,7 @@ def make_queue_text(fm_overrides=None, body="## threads\n\n本文です。\n",
                 try:
                     fm["approved_sha"] = approval_mod.compute_approved_sha(
                         section=section, account=fm.get("account"),
-                        reply_to=fm.get("reply_to"), topic=fm.get("topic"),
+                        reply_to=approval_mod.reply_to_for_fingerprint(fm), topic=fm.get("topic"),
                         publish_at=publish_at)
                 except ValueError:
                     pass  # publish_at が壊れている型外テスト等: 計算できないので触らない

{thth-3.1.1 → thth-3.2.0}/tests/test_admin_http_mcp.py

@@ -39,7 +39,9 @@ def test_admin_all_registry_and_mcp_auth_rechecked(credentials,monkeypatch):
     assert server.admin_context().scope=='admin'
     assert {tool['name'] for tool in server.ADMIN_TOOLS}=={
         'thth_admin_inventory','thth_admin_account','thth_admin_diff','thth_admin_log',
-        'thth_admin_tokens','thth_admin_release','thth_admin_budget_set','thth_admin_watch_set'}
+        'thth_admin_tokens','thth_admin_release','thth_admin_budget_set','thth_admin_watch_set',
+        # 報告の口の実装側（設計 3.1.2 §1）。
+        'thth_admin_reports_list','thth_admin_reports_show','thth_admin_reports_reply','thth_admin_reports_close'}
     result=server.call_tool('thth_admin_inventory',{})
     assert set(json.loads(result['content'][0]['text'])['by_account'])=={'first','second'}
     assert server.call_tool('thth_admin_diff',{'mark_read':True})['isError']

{thth-3.1.1 → thth-3.2.0}/tests/test_v210_json_contract.py

@@ -25,7 +25,10 @@ def json_parsers():
 # must acquire a table row, rather than quietly escaping the contract.
 COMMANDS = '''lint|preview|approve|account|revoke|posts|replies|measured|threads|study-report|analytics-report|after|topics|forms|queue|schedule|throw|handoff-report|board|pull|maintain|doctor|app show|admin inventory|admin account|admin log|admin tokens|admin timers|admin release|admin diff|ask before-you-post|mentions|profile|thread|where|who|retract|location|topics suggest|topics observe|topics record-decision|topics decision|topics observation|topics retract|topics unretract|topics profile|topics adopt-reason|topics adoptions|topics record-vocabulary|topics vocabulary|topics record-review|topics review|topics record-form-spec|topics form-spec|topics form-check|topics improvements|topics impact|topics record-hypothesis|topics hypotheses'''.split('|') + ['account add', 'account migrate', 'unanswered', 'study add', 'admin deletion sync', 'admin budget', 'admin media cleanup-retry', 'admin media gc',
      # 3.1.0: 毎朝の一枚と監視語（設計 3.1.0 §1・§3）。
-     'morning', 'admin watch set', 'admin watch show']
+     'morning', 'admin watch set', 'admin watch show',
+     # 3.1.2: 報告の口（設計 3.1.2 §1）。
+     'report file', 'report list', 'report show', 'report add', 'admin reports list', 'admin reports show',
+     'admin reports reply', 'admin reports close', 'admin reports export']
 
 
 def test_json_table_covers_every_parser():

{thth-3.1.1 → thth-3.2.0}/tests/test_v212_leave.py

@@ -149,7 +149,8 @@ def test_shared_manual_grant_does_not_tell_person_to_revoke_other_account(env,wo
     a=env['root']/'secrets/alpha.json';b=env['root']/'secrets/beta.json';b.write_bytes(a.read_bytes())
     assert leave.command(SimpleNamespace(name='alpha',by='operator',json=False))==0
     result=leave.read('alpha')
-    assert result['remote']=='unconfirmed_shared' and a.exists() and b.exists()
+    # 3.1.2 件 6・裁定 09-23: 値だけの共有（別ファイル）なら自分の file は消し、相手の file は残す。
+    assert result['remote']=='unconfirmed_shared' and not a.exists() and b.exists()
     out=capsys.readouterr().out
     assert '切り分け' in out and '本人が解除' not in out
 

{thth-3.1.1 → thth-3.2.0}/tests/test_v212_leave_providers.py

@@ -84,8 +84,11 @@ def test_shared_mastodon_grant_refuses_remote_revoke_but_shared_client_alone_doe
     cfg,tokenpath=configure(env,provider,monkeypatch,'mastodon');old=tokenpath.read_bytes()
     other=env['root']/'accounts/beta.json';b=json.loads(other.read_text());b.update(media='mastodon',instance=provider['base']);other.write_text(json.dumps(b))
     (env['root']/'secrets/beta.json').write_bytes(old)
-    with pytest.raises(ValueError,match='shared_credential'):leave.run('alpha',by='operator')
-    assert provider['calls']==[] and tokenpath.read_bytes()==old
+    # 3.1.2 件 6: 共有の接続は遠隔で失効させず（calls==[]）、止まらずに退出を終える。
+    # 裁定 09-23: 値だけの共有（別ファイル）なら自分の token file は消す。相手の file は残る。
+    result=leave.run('alpha',by='operator')
+    assert result['phase']=='completed' and result['remote']=='unconfirmed_shared' and 'token_shared' not in result['preserved']
+    assert provider['calls']==[] and not tokenpath.exists() and (env['root']/'secrets/beta.json').read_bytes()==old
 
 
 def test_b_credential_commit_before_revoke_is_rechecked_after_inventory(env,provider,monkeypatch):
@@ -99,8 +102,11 @@ def test_b_credential_commit_before_revoke_is_rechecked_after_inventory(env,prov
         authflow.commit_manual('beta',cfg_b,token_a,snapshot=snapshot,session=None,by='operator')
         return {'status':'revoked'}
     monkeypatch.setattr(approval_relay,'signed_request',worker)
-    with pytest.raises(ValueError,match='shared_credential'):leave.run('alpha',by='operator')
-    assert provider['calls']==[] and tokenpath.exists()
+    # 3.1.2 件 6: 共有の接続は遠隔で失効させず（calls==[]）、止まらずに退出を終える。
+    # 裁定 09-23: 値だけの共有（別ファイル）なら自分の token file は消す。相手の file は残る。
+    result=leave.run('alpha',by='operator')
+    assert result['phase']=='completed' and result['remote']=='unconfirmed_shared' and 'token_shared' not in result['preserved']
+    assert provider['calls']==[] and not tokenpath.exists()
     assert json.loads((env['root']/'secrets/beta.json').read_text())==token_a
 
 
@@ -166,5 +172,7 @@ def test_b_exchange_to_commit_holds_registry_lease_and_late_shared_grant_vetoes_
     assert a.is_alive() and provider['calls']==[]
     release.set();a.join(4);b.join(4)
     assert not a.is_alive() and not b.is_alive() and results==[0]
-    assert leave_errors==['shared_credential_revoke_refused'] and provider['calls']==[]
+    # 3.1.2 件 6: 共有の接続は遠隔で失効させず（calls==[]）、止まらずに退出を終える。
+    assert leave_errors==[] and provider['calls']==[]
+    assert leave.read('alpha')['phase']=='completed' and leave.read('alpha')['remote']=='unconfirmed_shared'
     assert accounts.load_token(accounts.load_account('beta'))['access_token']==value['access_token']

{thth-3.1.1 → thth-3.2.0}/tests/test_v212_read_coordination.py

@@ -61,7 +61,7 @@ def test_cli_reads_do_not_wait_or_call_core_when_leave_holds_exclusive(env,conte
         start=time.monotonic();rc=cli.main(command);elapsed=time.monotonic()-start
     captured=capsys.readouterr();assert rc==2 and elapsed<1
     assert json.loads(captured.out)=={'error':'account_leaving','cannot_say':['account_leaving']}
-    assert captured.err.strip()=='account_leaving'
+    assert captured.err.strip()=='account_leaving\n'+__import__('thth.report_inbox').report_inbox.CHANNEL_LINE  # 3.1.2 §3.5: 断りの理由行の後ろに受け口の案内 1 行
 
 
 def test_dry_send_input_then_nonwaiting_lease(env,tmp_path,capsys):
@@ -69,7 +69,7 @@ def test_dry_send_input_then_nonwaiting_lease(env,tmp_path,capsys):
     with exclusive():
         start=time.monotonic();rc=cli.main(['send','alpha','--text-file',str(text)])
         assert time.monotonic()-start<1 and rc==2
-    assert capsys.readouterr().err.strip()=='account_leaving'
+    assert capsys.readouterr().err.strip()=='account_leaving\n'+__import__('thth.report_inbox').report_inbox.CHANNEL_LINE  # 3.1.2 §3.5: 断りの理由行の後ろに受け口の案内 1 行
     assert not (env['root']/'state/alpha/sent').exists()
 
 
@@ -145,7 +145,7 @@ def test_real_cli_child_rejects_ex_under_deadline(env,content):
             result=subprocess.run([sys.executable,'-c',"from thth.cli import main;raise SystemExit(main(['queue','alpha','--json']))"],capture_output=True,text=True,timeout=2)
         except subprocess.TimeoutExpired:pytest.fail('reader waited for the exit drain')
     assert result.returncode==2 and json.loads(result.stdout)['cannot_say']==['account_leaving']
-    assert result.stderr.strip()=='account_leaving'
+    assert result.stderr.strip()=='account_leaving\n'+__import__('thth.report_inbox').report_inbox.CHANNEL_LINE  # 3.1.2 §3.5: 断りの理由行の後ろに受け口の案内 1 行
 
 
 def test_report_holds_lease_through_calculation_and_release(env,monkeypatch):

{thth-3.1.1 → thth-3.2.0}/tests/test_v213_carryover_timeout.py

@@ -51,7 +51,7 @@ raise SystemExit(cli.main(json.loads(sys.argv[1])))
         # cannot trap this pytest process before an elapsed-time assertion.
         result = subprocess.run([sys.executable, '-c', code, json.dumps(command), str(marker)],
                                 capture_output=True, text=True, timeout=3)
-    assert result.returncode == 2 and result.stderr.strip() == 'account_leaving'
+    assert result.returncode == 2 and result.stderr.strip() == 'account_leaving\n' + __import__('thth.report_inbox').report_inbox.CHANNEL_LINE  # 3.1.2 §3.5: 断りの理由行の後ろに受け口の案内 1 行
     if operation == 'replies':
         assert json.loads(result.stdout) == {'error': 'account_leaving', 'cannot_say': ['account_leaving']}
     assert not marker.exists()

{thth-3.1.1 → thth-3.2.0}/tests/test_v213_review_followups.py

@@ -14,7 +14,7 @@ def test_run_invalid_name_before_any_storage_or_effect(monkeypatch,capsys,name):
     monkeypatch.setattr('thth.incident.notify',forbidden)
     assert cli.main(['run',name])==2
     captured=capsys.readouterr();value=json.loads(captured.out)
-    assert captured.err.strip()=='invalid_account_name'
+    assert captured.err.strip()=='invalid_account_name\n'+__import__('thth.report_inbox').report_inbox.CHANNEL_LINE  # 3.1.2 §3.5: 断りの理由行の後ろに受け口の案内 1 行
     assert value['error']==value['record_unavailable']=='invalid_account_name'
     assert value['account'] is None and value['runs_recorded'] is False
     assert '使えない字' in value['message'] and 'account_stopped' not in captured.out

{thth-3.1.1 → thth-3.2.0}/tests/test_v213_stop_observation.py

@@ -30,7 +30,7 @@ def test_run_reason_and_no_side_effect(env,monkeypatch,capsys,state,expected):
     monkeypatch.setattr('thth.healthcheck.notify',lambda *a,**kw:pytest.fail('healthcheck notification'))
     monkeypatch.setattr('thth.incident.notify',lambda *a,**kw:pytest.fail('incident notification'))
     assert cli.main(['run','alpha'])==2
-    shown=capsys.readouterr();assert shown.err.strip()==expected
+    shown=capsys.readouterr();assert shown.err.strip()==expected+'\n'+__import__('thth.report_inbox').report_inbox.CHANNEL_LINE  # 3.1.2 §3.5: 断りの理由行の後ろに受け口の案内 1 行
     value=json.loads(shown.out)
     assert value=={'account':'alpha','mode':'production','action':'skip','status':'error','error':expected,
                    'runs_recorded':False,'record_unavailable':expected}

{thth-3.1.1 → thth-3.2.0}/tests/test_v311_leave_same_user.py

@@ -45,14 +45,16 @@ def test_same_user_different_token_leave_completes_and_leaves_other_account_unto
     assert accounts.load_token(accounts.load_account('beta'))['access_token']==other_access
 
 
-def test_same_token_bytes_still_refuse_remote_revoke(env,provider,monkeypatch):
+def test_same_token_bytes_do_not_revoke_remotely(env,provider,monkeypatch):
     _,tokenpath=configure(env,provider,monkeypatch,'mastodon')
     beta_token,_=same_user_beta(env,provider,tokenpath,'mastodon',same_bytes=True)
     old=tokenpath.read_bytes()
-    with pytest.raises(ValueError,match='shared_credential_revoke_refused'):leave.run('alpha',by='operator')
-    # 失効は投げず、唯一の再試行資格（自分の token file）も消さない。停止は戻さない。
-    assert provider['calls']==[] and tokenpath.read_bytes()==old and beta_token.read_bytes()==old
-    assert leave_gate.stopped('alpha') and leave.read('alpha')['phase']=='worker_revoked'
+    # 3.1.2 件 6: 失効は投げない（他方も死ぬ）。止まらずに completed まで進む
+    # （完了までの形は tests/test_v312_leave_shared_token.py）。
+    result=leave.run('alpha',by='operator')
+    assert result['phase']=='completed' and result['remote']=='unconfirmed_shared'
+    # 裁定 09-23: 値だけの共有（別ファイル）なら自分の token file は消す。相手の file は残る。
+    assert provider['calls']==[] and not tokenpath.exists() and beta_token.read_bytes()==old
 
 
 def test_threads_same_user_is_still_token_shared_and_preserved(env,monkeypatch):

thth-3.2.0/tests/test_v312_leave_shared_token.py

@@ -0,0 +1,126 @@
+"""3.1.2 件 6: 退出で token が他の生きている account と共有なら、遠隔で失効させずに終える。
+
+実測（2026-09-23 12:50）: 同じ app で同じ利用者が認可すると Mastodon は既存の access token を
+返すので、kopicha-server-mastodon と kopicha-mastodon の token は値が同じだった。失効すると
+他方も死ぬので投げない（判定は正しい）——が、**退出が `worker_revoked` で止まるのは誤り**。
+
+masaru 裁定（09-23）: **値だけの共有（別ファイル・別 inode）なら、自分の token file と env は
+消して完了する**（退出した account の秘密を VM に残さない・消しても失効にはならず、相手は
+自分のファイルを持つ）。**同じファイル・同じ inode の共有**（path 一致・dev/ino 一致・app
+directory 配下）のときだけ従前どおり残す（`preserved: ['token_shared']`）。
+
+見るのは（fake Mastodon・loopback）:
+  (a) 値だけ共有 → completed・`remote: unconfirmed_shared`・`/oauth/revoke` は呼ばれない・
+      自分の token file は無い・他方の token file は byte 一致・他方は停止しない。
+  (a') ファイル共有（同じ path）→ 自分の token file は残る（相手のファイルでもあるので）。
+  (b) 値が違う 2 台帳 → 3.1.1 どおり自分の token だけ失効して completed。
+  (c) 3.1.1 の形で `worker_revoked` に止まった row（token を消す対象から外していた）からの
+      再実行が (a) で完了し、自分の token file も消える。
+"""
+import json
+
+import pytest
+
+from thth import accounts, leave, leave_gate
+from tests.test_v212_server_writes import env  # noqa: F401（fixture）
+from tests.test_v212_leave_providers import provider, configure  # noqa: F401（fixture）
+from tests.test_v311_leave_same_user import same_user_beta
+
+
+def _assert_other_untouched(beta_token, beta_ledger, token_bytes, ledger_bytes):
+    assert beta_token.read_bytes() == token_bytes and beta_ledger.read_bytes() == ledger_bytes
+    assert not leave_gate.stopped("beta") and leave.read("beta") is None
+    accounts.load_account("beta")
+
+
+def test_a_値だけ共有なら失効を投げず自分のtoken_fileは消して完了する(env, provider, monkeypatch, capsys):
+    _, tokenpath = configure(env, provider, monkeypatch, "mastodon")
+    beta_token, beta_ledger = same_user_beta(env, provider, tokenpath, "mastodon", same_bytes=True)
+    token_bytes, ledger_bytes = beta_token.read_bytes(), beta_ledger.read_bytes()
+    alpha_ledger = env["root"] / "accounts/alpha.json"
+    alpha_state = env["root"] / "state/alpha"
+
+    class Args:
+        name, by, json = "alpha", "operator", False
+    assert leave.command(Args()) == 0
+    out = capsys.readouterr().out
+    assert "remote_unconfirmed: 他 account と共有の接続です。" in out
+    row = leave.read("alpha")
+    assert row["phase"] == "completed" and row["remote"] == "unconfirmed_shared"
+    assert "token_shared" not in row["preserved"] and row["deleted"]["token"] == 1
+    assert provider["calls"] == []            # /oauth/revoke は呼ばれない
+    assert not tokenpath.exists()              # 退出した account の秘密は残さない
+    assert not alpha_ledger.exists() and not alpha_state.exists()
+    _assert_other_untouched(beta_token, beta_ledger, token_bytes, ledger_bytes)
+
+
+def test_a2_ファイルごとの共有なら自分のtoken_fileも残す(env, provider, monkeypatch):
+    _, tokenpath = configure(env, provider, monkeypatch, "mastodon")
+    beta_token, beta_ledger = same_user_beta(env, provider, tokenpath, "mastodon", same_bytes=True)
+    # beta の台帳が alpha と同じ token file を指す（path 一致）。
+    ledger = json.loads(beta_ledger.read_text())
+    ledger["token"] = str(tokenpath)
+    beta_ledger.write_text(json.dumps(ledger))
+    token_bytes, ledger_bytes = tokenpath.read_bytes(), beta_ledger.read_bytes()
+    result = leave.run("alpha", by="operator")
+    assert result["phase"] == "completed" and result["remote"] == "unconfirmed_shared"
+    assert result["preserved"] == ["token_shared"] and "token" not in result["deleted"]
+    assert provider["calls"] == []
+    _assert_other_untouched(tokenpath, beta_ledger, token_bytes, ledger_bytes)
+
+
+def test_b_値が違う2台帳は自分のtokenだけ失効して完了する(env, provider, monkeypatch):
+    _, tokenpath = configure(env, provider, monkeypatch, "mastodon")
+    beta_token, beta_ledger = same_user_beta(env, provider, tokenpath, "mastodon")
+    token_bytes, ledger_bytes = beta_token.read_bytes(), beta_ledger.read_bytes()
+    result = leave.run("alpha", by="operator")
+    assert result["phase"] == "completed" and result["remote"] == "confirmed"
+    sent = [form["token"][0] for path, form, _ in provider["calls"]]
+    assert [path for path, _, _ in provider["calls"]] == ["/oauth/revoke"]
+    assert sent == [provider["access"]] and not tokenpath.exists()
+    _assert_other_untouched(beta_token, beta_ledger, token_bytes, ledger_bytes)
+
+
+def _stuck_at_worker_revoked(monkeypatch):
+    """停止と worker の失効までは進み、遠隔の段の手前で落ちた row を作る。"""
+    original = leave_gate.credentials
+    monkeypatch.setattr(leave_gate, "credentials",
+                        lambda *a, **k: (_ for _ in ()).throw(ValueError("stop_here")))
+    with pytest.raises(ValueError):
+        leave.run("alpha", by="operator")
+    monkeypatch.setattr(leave_gate, "credentials", original)
+    row = leave.read("alpha")
+    assert row["phase"] == "worker_revoked" and leave_gate.stopped("alpha")
+    return row
+
+
+def test_c_31_1の形でworker_revokedに止まったrowから再実行して完了する(env, provider, monkeypatch):
+    _, tokenpath = configure(env, provider, monkeypatch, "mastodon")
+    beta_token, beta_ledger = same_user_beta(env, provider, tokenpath, "mastodon", same_bytes=True)
+    token_bytes, ledger_bytes = beta_token.read_bytes(), beta_ledger.read_bytes()
+    row = _stuck_at_worker_revoked(monkeypatch)
+    # 3.1.1 は値だけの共有でも token を消す対象から外し preserved に入れていた。その形に戻す。
+    row["targets"] = [target for target in row["targets"] if target["category"] != "token"]
+    row["inventory_sha256"] = leave._hash(row["targets"])
+    row["preserved"] = ["token_shared"]
+    assert row["token_shared"] is True
+    leave._save(row)
+    result = leave.run("alpha", by="operator")
+    assert result["phase"] == "completed" and result["remote"] == "unconfirmed_shared"
+    assert provider["calls"] == [] and not tokenpath.exists()
+    assert "token_shared" not in result["preserved"]
+    _assert_other_untouched(beta_token, beta_ledger, token_bytes, ledger_bytes)
+
+
+def test_ファイル共有なのに消す対象にtokenが残るrowは矛盾として止める(env, provider, monkeypatch):
+    _, tokenpath = configure(env, provider, monkeypatch, "mastodon")
+    row = _stuck_at_worker_revoked(monkeypatch)
+    assert any(target["category"] == "token" for target in row["targets"])
+    # ファイルごと共有と記録したのに token を消す対象に残した row。
+    row["token_shared"] = True
+    row["preserved"] = sorted(set(row["preserved"]) | {"token_shared"})
+    leave._save(row)
+    with pytest.raises(ValueError, match="^shared_credential_revoke_refused$"):
+        leave.run("alpha", by="operator")
+    assert provider["calls"] == [] and tokenpath.exists() and leave_gate.stopped("alpha")
+    assert leave.read("alpha")["phase"] == "worker_revoked"