thth 3.2.0__tar.gz → 3.3.1__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: thth
-Version: 3.2.0
+Version: 3.3.1
 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`・`report`・`admin`。
+- **動くもの**（`thth --help` の全サブコマンド）: `lint`・`preview`・`approve`・`account`・`revoke`・`posts`・`replies`・`measured`・`threads`・`after`・`analytics-report`・`study-report`・`study`・`unanswered`・`handoff-report`・`observe`・`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`・`inflight`・`location`・`notifications`・`report`・`admin`。
 - **最初の本番投稿の記録**: 2026-09-09、@aoking に疎通確認を 1 本（`17916074118445631`）。
 - **未着手**: X・Facebook ページ・Instagram の各アダプタ。トピック検索の権限（tester には降りない）。泉のサーバ（v2-5）。
 - **権限の制約**: tester に降りる scope は 5 つ。削除はできない。

{thth-3.2.0 → thth-3.3.1}/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`・`report`・`admin`。
+- **動くもの**（`thth --help` の全サブコマンド）: `lint`・`preview`・`approve`・`account`・`revoke`・`posts`・`replies`・`measured`・`threads`・`after`・`analytics-report`・`study-report`・`study`・`unanswered`・`handoff-report`・`observe`・`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`・`inflight`・`location`・`notifications`・`report`・`admin`。
 - **最初の本番投稿の記録**: 2026-09-09、@aoking に疎通確認を 1 本（`17916074118445631`）。
 - **未着手**: X・Facebook ページ・Instagram の各アダプタ。トピック検索の権限（tester には降りない）。泉のサーバ（v2-5）。
 - **権限の制約**: tester に降りる scope は 5 つ。削除はできない。

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

@@ -295,12 +295,28 @@ TOOLS = [
         },
     },
     {
-        # **名前と説明文がそのまま売り文句**（設計 3.1.0 §1）。
+        # **名前と説明文がそのまま売り文句**（設計 3.1.0 §1・3.3.0 §F で観測に）。
+        "name": "thth_observe",
+        "description": (
+            "セッションの始めと区切りごとに呼ぶ。前回の観測から何があって、いまなにを"
+            "すればよいかを、道具が事実だけで 1 枚にする。本文は作らない"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "target": {"type": "string", "description": "project 名か account 名"},
+                "mark": {"type": "boolean",
+                          "description": "栞（前回読んだ時点）を進める（既定 true）"},
+            },
+            "required": ["target"],
+        },
+    },
+    {
+        # 別名（3.3.0 §F）。既存の skill・セッションを壊さないために残す。
         "name": "thth_morning",
-        # **設計 3.1.0 §0 の約束そのまま。**
         "description": (
-            "朝いちばんに呼ぶ。昨日から何があって、今日なにをすればよいかを、"
-            "道具が事実だけで 1 枚にする。本文は作らない"
+            "thth_observe の別名（同じ 1 枚を返す）。セッションの始めと区切りごとに呼ぶ。"
+            "前回の観測から何があって、いまなにをすればよいかを、道具が事実だけで 1 枚にする"
         ),
         "inputSchema": {
             "type": "object",
@@ -589,16 +605,25 @@ del _tool
 # credential の `actor` が決める（要求の欄からは作らない）。
 REPORT_TOOLS = [
     {"name": "thth_report_file",
-     "description": "道具が断った・結果が期待と違った・欲しい形がある、のどれかならこれで置く"
-                    "（kind は bug か request。実装側が読み、返事は thth_report_show と "
+     "description": "道具が断った・結果が期待と違った・欲しい形がある・迷った、のどれかならこれで置く。"
+                    "つまずき・迷い・期待との違いの報告は、利用者の作業の一部として歓迎します。"
+                    "小さいものも。重複は道具が束ねます。"
+                    "例: 「止まったのに気づかなかった」「断られた理由が分からなかった」"
+                    "「同じ操作を 3 回繰り返した」。断られた直後なら from_last_refusal: true で"
+                    "道具が控えた断りを再現手順に添えられる"
+                    "（kind は bug・request・friction〔迷った・分かりにくかった・同じ操作を繰り返した〕。"
+                    "実装側が読み、返事は thth_report_show と "
                     "operations_handoff の tool.reports に出る。秘密らしき値が含まれていたら置かない）",
      "inputSchema": {"type": "object", "properties": {
          "account": {"type": "string"},
-         "kind": {"type": "string", "enum": ["bug", "request"]},
+         "kind": {"type": "string", "enum": ["bug", "request", "friction"]},
          "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}},
+         "body": {"type": "string", "description": "8,000 字まで（from_last_refusal のときは省略可）"},
+         "repro": {"type": "string", "description": "再現手順（任意・4,000 字まで）"},
+         "from_last_refusal": {"type": "boolean",
+                               "description": "この account で直前に道具が断った記録（時刻・版・命令・"
+                                              "理由の符丁）を再現手順として添える。kind の既定は friction"}},
+         "required": ["account", "title"], "additionalProperties": False}},
     {"name": "thth_report_list",
      "description": "自分の project の報告と、実装側の返事の数を読む（読むだけ）",
      "inputSchema": {"type": "object", "properties": {
@@ -630,12 +655,16 @@ def _with_report_hint(tools):
             else dict(tool, description=tool["description"] + REPORT_HINT) for tool in tools]
 
 
-def _channel_note():
-    """断りの応答に添える 2 つ目の text（静的な 1 行・本文も account 名も入れない）。"""
+def _channel_note(account=None, reason=None):
+    """断りの応答に添える 2 つ目の text。本文は入れない。
+
+    account（credential が許した・台帳にある名前）と理由の符丁が分かれば、そのまま
+    呼べる `thth_report_file` の 1 行（設計 3.3.0 B3）。分からなければ静的な 1 行。
+    """
     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}
+    from thth.report_inbox import mcp_refusal_line
+    return {"type": "text", "text": mcp_refusal_line(account, reason)}
 
 
 def server_mode():
@@ -649,7 +678,7 @@ def server_tools(context):
     if context.scope=='admin': return reports + ADMIN_TOOLS
     # 毎朝の一枚は**利用者の scope だけ**（設計 3.1.0 §1）。credential が許した
     # account／project しか対象にできない（`report_service.execute_morning()`）。
-    reports = reports + [tool for tool in TOOLS if tool['name']=='thth_morning']
+    reports = reports + [tool for tool in TOOLS if tool['name'] in ('thth_observe', 'thth_morning')]
     from thth.server_writes import 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
@@ -659,8 +688,11 @@ 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()
-    # 断りは 1 つ目の text が静的な理由、2 つ目が受け口の案内（設計 3.1.2 §3.5）。
-    failure=lambda value:{'content':[{'type':'text','text':value},_channel_note()],'isError':True}
+
+    def failure(value):
+        # 断りは 1 つ目の text が静的な理由、2 つ目が受け口の案内（設計 3.1.2 §3.5）。
+        account, code = _remember_refusal(context, name, arguments, value)
+        return {'content':[{'type':'text','text':value},_channel_note(account, code)],'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')
@@ -692,9 +724,10 @@ def server_call(name, arguments):
         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':
+        elif operation in ('morning', 'observe'):
             from thth.report_service import execute_morning
-            result=execute_morning(context,request)
+            request={**request,'operation':'morning'}
+            result=execute_morning(context,request,invoked_as=operation)
         elif operation in ('analytics_report', 'operations_handoff', 'study_report'):
             result=execute_mcp_report(context,request)
         else:
@@ -714,6 +747,34 @@ def server_call(name, arguments):
         return failure('request_unavailable')
 
 
+def _remember_refusal(context, name, arguments, value):
+    """サーバ型の断りを account ごとに控える（設計 3.3.0 B2）。控えの失敗で断りを変えない。
+
+    戻り値は断りの 2 つ目の text に埋める `(account, 符丁)`（B3・分からなければ None）。
+
+    account は credential が許した名前のときだけ。残すのは道具の名前と、断りの
+    先頭の静的な符丁だけ（`thth/refusals.py`・引数の値は残さない）。報告の口の
+    断りは控えない（報告しようとしていた元の断りを押し出さないため）。
+    """
+    try:
+        if context is None or not isinstance(arguments, dict) or not isinstance(name, str):
+            return None, None
+        account = arguments.get('account')
+        if not isinstance(account, str) or account not in (context.allowed_accounts or {}):
+            return None, None
+        if not name.replace('_', '').isalnum():
+            return None, None
+        from thth import refusals
+        command = 'mcp ' + name
+        values = [v for v in arguments.values() if isinstance(v, str)]
+        code = refusals.reason_code(value, argv=values, command=command, rc=2)
+        if not name.startswith('thth_report_'):
+            refusals.record(account, command=command, reason_code=code)
+        return account, code
+    except Exception:
+        return None, None
+
+
 def admin_context():
     context=authenticated_context()
     return context if context is not None and context.scope=='admin' else None
@@ -892,10 +953,10 @@ def call_tool(name: str, arguments: dict | None) -> dict:
         args.append("--json")
         proc = run_cli(args)
         text = proc.stdout
-    elif name == "thth_morning":
+    elif name in ("thth_morning", "thth_observe"):
         # **`where_to_appear` と同じ型**: CLI（`thth morning`）を `--json` で
         # 呼ぶだけ（設計 3.1.0 §1・§5）。栞を進めないときだけ旗を足す。
-        args = ["morning", arguments["target"]]
+        args = [name[len("thth_"):], arguments["target"]]
         if arguments.get("mark") is False:
             args.append("--no-mark")
         args.append("--json")
@@ -925,7 +986,7 @@ def call_tool(name: str, arguments: dict | None) -> dict:
 
     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",
-            "who_is_this", "thth_morning"):
+            "who_is_this", "thth_morning", "thth_observe"):
         # **新しい道具は exit 1 も isError**（設計 §7）。lint の exit 1（検査結果）
         # とは意味が違う——こちらは stale_context・不正な候補比較で、
         # **そのまま使ってはいけない**応答。既存の扱いは変えない。

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

@@ -3,9 +3,9 @@ name: thth
 description: 投稿する前・返信を書く前・出したあと・絡みに行く先を選ぶときに呼ぶ道具。Threads・Bluesky・Mastodon への下書きを人の承認を通してから出し、枝を読み、相手を知り、伸びを測る。
 ---
 
-**開始時は、まず `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_observe`（CLI は `thth observe <project|account> --json`）。** 前回の観測から何があって、いまなにをすればよいかが 6 段（道具・返していないもの・前回の観測から・世間・予定・次の一手）で返る（3.3.0。`thth_morning`／`thth morning` は同じものの別名で、JSON の `invoked_as` だけが違う。第 2 段は前回の栞の時刻から今まで・栞が無い／7 日より古いときは前日 JST で、`window.basis` が `since_last_observe` か `yesterday_jst`）。`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_report_file`（CLI は `thth report file <account> --kind bug|request|friction --title … --body-file … --by <名前>`）。つまずき・迷い・期待との違いの報告は、利用者の作業の一部として歓迎します。小さいものも。重複は道具が束ねます。例: 「止まったのに気づかなかった」「断られた理由が分からなかった」「同じ操作を 3 回繰り返した」。道具が断った・結果が期待と違った・欲しい形がある・迷った（`friction`）、のどれかなら 1 回で置ける。**断られた直後なら、断りの最後の `report_channel:` の行をそのまま打てばよい**（`--from-last-refusal` が、道具が控えた直前の断り——時刻・版・命令・理由の符丁だけで、本文と引数の値は控えていない——を再現手順に添える。MCP は `thth_report_file {"account": …, "title": …, "from_last_refusal": true}`）。置いた報告がこの版で閉じたかは `thth_observe` の 0 段 `project_reports` に出る。返事は `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` を「変更なし」と解釈しない。
 
@@ -149,7 +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 file`（MCP `thth_report_file`）で実装側に届ける（小さいものも歓迎・重複は道具が束ねる）。
+- 承認済みなのに出ない原稿は `thth_observe` の予定の段 `held_items`（file・理由・予定・経過）と `thth board` の要確認（先頭 5 本）に名前が出る。`approval_stale` は再承認（`thth approve` の二段）で直る。時刻を過ぎて出られないものがあると `thth run` は `held` として死活通知と運用通知に知らせる。
 - 自分の開いている報告に書き足すなら `thth report add <report_id> --body-file <path|-> --by <名前>`（MCP `thth_report_add`）。
 - 使い方の全文: `docs/使い方_プロジェクトのセッション向け_2026-09-09.md`。
 
@@ -167,7 +168,7 @@ MCP `after_you_posted`。**24h の刻みが無ければ `null`**（0 と混ぜ
 
 新規 account は利用者メール・管理者メール・TLS SMTP を `thth notifications config` で設定し、`status` → `test` を実行する。両宛先の受信箱で到達、account 専用 HEALTHCHECK_URL の missed-ping 通知を確認してから production/scheduled を有効にする。既存 account にも同じ設定を追加する。詳細は `docs/停止通知と運用記録.md`。
 
-プロジェクトの作業開始・再開時は `git fetch` 後にリモート `docs/sns/queue/` の `thth_run_state`・`thth_run_detail`・`thth_run_next` を確認する。dirty worktree へ無条件に pull しない。リモートの確認は `git show origin/main:docs/sns/queue/FILE.md` 等で行える。停止・成否不明なら inflight を消して再投稿せず、示された確認を行う。復旧状態は投稿成功の保証ではなく、公開結果は status/post_id/posted_at を見る。
+プロジェクトの作業開始・再開時は `git fetch` 後にリモート `docs/sns/queue/` の `thth_run_state`・`thth_run_detail`・`thth_run_next` を確認する。dirty worktree へ無条件に pull しない。リモートの確認は `git show origin/main:docs/sns/queue/FILE.md` 等で行える。停止・成否不明なら inflight を手で消して再投稿しない（3.3.1 から道具が毎 run の最初に媒体へ 1 回だけ問い合わせ、決まれば自分で解く）。止まり続けるなら `thth inflight <account> show` で中身を見て、媒体で確かめた人が `thth inflight <account> resolve --not-published|--published <post_id> --by <名前>` で解く（二段確認・MCP には無い）。復旧状態は投稿成功の保証ではなく、公開結果は status/post_id/posted_at を見る。
 
 `mentions <account> --json` は 3 媒体の言及を同じ項目で読む。返信前に `replied` の object／false／null を区別する。`unanswered <account> --since 7d --json` は自分の根投稿の未回答候補を台帳で読む。`cannot_say` と採集の古さを確認し、`--refresh` は明示されたときだけ使う。件数は account ごとに扱い、送信は既存の承認・digest・production の門を通す。
 

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

@@ -67,6 +67,16 @@ def local_http_test_transport(monkeypatch):
                 opener.open('http://'+host,timeout=0.01)
 
 
+@pytest.fixture(autouse=True)
+def no_threads_status_poll_wait(monkeypatch):
+    """公開の結果が分からないときの container の問い合わせ（設計 3.3.1 §2）を
+    試験では待たない。本番の既定は 20 秒おき・最大 3 回。偽サーバは status の
+    GET に答えない（`query_failed`）ので、従前の試験の結果（inflight を残す）は
+    変わらない——変わるのは待つ時間だけ。subprocess の `bin/thth` にも env で届く。
+    """
+    monkeypatch.setenv('THTH_THREADS_STATUS_POLL_SECONDS', '0')
+
+
 @pytest.fixture(autouse=True)
 def frozen_now_jst(monkeypatch):
     """`thth.jst.now_jst()` を既定で静かな時間帯の外（2026-09-09 10:00 JST）に固定する。
@@ -429,3 +439,15 @@ def init_git_pair(tmp_path, *, seed_content: str, seed_name: str = "a.md"):
 
     return {"bare": bare, "seed": seed, "work": work,
             "queue_dir": os.path.join(work, "docs", "sns", "queue")}
+
+
+def is_refusal(err: str, code: str) -> bool:
+    """断りの stderr が「理由の符丁 1 行＋打てる報告の 1 行」か（3.1.2 §3.5・3.3.0 B3）。
+
+    3.3.0 から 2 行目は account と理由の符丁を埋めた `report_inbox.refusal_line()`。
+    account は命令と台帳しだいで `<account>` のままになるので、ここでは形と符丁だけ見る。
+    """
+    lines = err.strip().splitlines()
+    return (len(lines) == 2 and lines[0] == code
+            and lines[1].startswith("report_channel: thth report file ")
+            and f'--title "{code} で断られた"' in lines[1])

thth-3.3.1/tests/helpers/fake_threads_status.py

@@ -0,0 +1,123 @@
+"""container の status を答える偽 Threads（設計 3.3.1 §6・**tests の中だけ**）。
+
+本物の Threads API には触らない。`http.server` で次の 4 つの口だけを真似る:
+
+- `POST /<user>/threads`         → container を作る（id は `CONTAINER_ID`）
+- `POST /<user>/threads_publish` → `script.publish` の先頭から 1 つずつ答える
+- `GET  /<container>`            → `script.status` の先頭から 1 つずつ（最後の 1 つは繰り返す）
+- `GET  /v1.0/<user>/threads`    → `script.posts`（自分の最近の投稿）
+
+何回呼ばれたかを数える（`publish_calls`・`status_calls`・`list_calls`）——
+「2 度出していない」を回数で確かめるため。
+"""
+from __future__ import annotations
+
+import contextlib
+import dataclasses
+import http.server
+import json
+import threading
+import urllib.parse
+
+from thth.adapters import threads as threads_mod
+
+USER_ID = "12345"
+CONTAINER_ID = "900"
+
+
+@dataclasses.dataclass
+class Script:
+    # 公開の答え: ("ok", id) / (500, None) / (400, None) / ("drop", None)（接続断）
+    publish: list = dataclasses.field(default_factory=lambda: [("ok", "777")])
+    # container の status の答え: "FINISHED" などの語 / 数字（HTTP の失敗）
+    status: list = dataclasses.field(default_factory=lambda: ["FINISHED"])
+    # 自分の最近の投稿（`GET /v1.0/<user>/threads` の data）
+    posts: list = dataclasses.field(default_factory=list)
+    list_status: int = 200
+    publish_calls: int = 0
+    status_calls: int = 0
+    list_calls: int = 0
+    create_calls: int = 0
+    # 公開の要求に載っていた creation_id（どの container を公開したか）。
+    publish_ids: list = dataclasses.field(default_factory=list)
+
+
+def _handler(script: Script):
+    class Handler(http.server.BaseHTTPRequestHandler):
+        def _json(self, code, payload):
+            body = json.dumps(payload).encode("utf-8")
+            self.send_response(code)
+            self.send_header("Content-Type", "application/json")
+            self.send_header("Content-Length", str(len(body)))
+            self.end_headers()
+            self.wfile.write(body)
+
+        def do_POST(self):  # noqa: N802
+            length = int(self.headers.get("Content-Length") or 0)
+            raw = self.rfile.read(length) if length else b""
+            if self.path.endswith("/threads_publish"):
+                script.publish_calls += 1
+                params = urllib.parse.parse_qs(raw.decode("utf-8"))
+                script.publish_ids.append((params.get("creation_id") or [None])[0])
+                kind, value = (script.publish.pop(0) if script.publish else (500, None))
+                if kind == "ok":
+                    self._json(200, {"id": value})
+                elif kind == "drop":
+                    # 応答を返さずに切る（接続断）。
+                    self.close_connection = True
+                    self.connection.close()
+                else:
+                    self._json(kind, {"error": {"message": "fake", "code": 1,
+                                                "is_transient": True}})
+                return
+            script.create_calls += 1
+            self._json(200, {"id": CONTAINER_ID})
+
+        def do_GET(self):  # noqa: N802
+            path = urllib.parse.urlsplit(self.path).path
+            if path == f"/v1.0/{USER_ID}/threads":
+                script.list_calls += 1
+                if script.list_status != 200:
+                    self._json(script.list_status, {"error": {"message": "fake"}})
+                    return
+                self._json(200, {"data": list(script.posts)})
+                return
+            if path == f"/{CONTAINER_ID}":
+                script.status_calls += 1
+                answer = script.status.pop(0) if len(script.status) > 1 else script.status[0]
+                if isinstance(answer, int):
+                    self._json(answer, {"error": {"message": "fake"}})
+                else:
+                    self._json(200, {"status": answer, "id": CONTAINER_ID})
+                return
+            self._json(404, {"error": {"message": "not found"}})
+
+        def log_message(self, format, *args):  # noqa: A002
+            pass
+
+    return Handler
+
+
+@contextlib.contextmanager
+def serve(script: Script):
+    server = http.server.HTTPServer(("127.0.0.1", 0), _handler(script))
+    thread = threading.Thread(target=server.serve_forever, daemon=True)
+    thread.start()
+    try:
+        yield f"http://127.0.0.1:{server.server_port}"
+    finally:
+        server.shutdown()
+        thread.join(timeout=5)
+
+
+def adapter(base_url: str, **kwargs) -> threads_mod.ThreadsAdapter:
+    kwargs.setdefault("wait_seconds", 0)
+    kwargs.setdefault("timeout", 2.0)
+    kwargs.setdefault("status_poll_seconds", 0)
+    return threads_mod.ThreadsAdapter(base_url=base_url, access_token="fake-token",
+                                       user_id=USER_ID, **kwargs)
+
+
+def post_row(post_id: str, text: str, timestamp: str) -> dict:
+    return {"id": post_id, "text": text, "timestamp": timestamp,
+            "permalink": f"https://www.threads.net/@x/post/{post_id}"}

{thth-3.2.0 → thth-3.3.1}/tests/test_incident_notifications.py

@@ -76,7 +76,8 @@ def test_git_roundtrip_preserves_original_and_deduplicates(setup):
     assert "thth_run_state: recovered" in s.path.read_text()
     assert len(s.captured) == 4
     assert incident._fingerprint(s.path) == before
-    assert len(row(s)["events"]) == 1
+    # 3.3.1 §5: 送り終えた事象も 30 日は残す（以前は 1 件に畳んでいた）。
+    assert len(row(s)["events"]) == 2
 
 
 def test_initial_success_is_quiet(setup):
@@ -99,7 +100,8 @@ def test_role_failure_retries_only_unfinished_and_other_role_gets_recovery(setup
     monkeypatch.setattr(incident, "_send", lambda c, r, e, a: calls.append((r, e["state"])) or True)
     notify(s, "success", result=False)
     assert calls[-2:] == [("user@example.org", "blocked"), ("user@example.org", "recovered")]
-    assert len(row(s)["events"]) == 1
+    # 3.3.1 §5: 送り終えた事象も 30 日は残す（以前は 1 件に畳んでいた）。
+    assert len(row(s)["events"]) == 2
 
 
 def test_same_address_single_message(setup):

{thth-3.2.0 → thth-3.3.1}/tests/test_mcp.py

@@ -102,11 +102,12 @@ def test_mcp_stdioでtools_listとtools_callが通る(isolated_account):
     # 2026-09-16 に `where_to_appear` を足した（設計「自分の泉」§2.3・T2-3・読むだけ）。
     # 2026-09-16 に `who_is_this` を足した（設計「自分の泉」§2.4・T3-3・読むだけ）。
     # 2026-09-23 に `thth_morning` を足した（設計 3.1.0 §1・読むだけ・栞だけ進む）。
+    # 2026-09-23 に `thth_observe` を足した（設計 3.3.0 §F・thth_morning は別名）。
     assert tool_names == {"thth_lint", "thth_queue", "thth_preview", "thth_board",
                           "thth_topic_context", "thth_topic_evaluate",
                           "thth_topic_decision", "before_you_post", "after_you_posted",
                           "thread_read", "where_to_appear", "who_is_this", "analytics_report", "operations_handoff", "study_report",
-                          "thth_morning"}
+                          "thth_morning", "thth_observe"}
     # 副作用のあるものは 1 つも出ていない。
     assert not (tool_names & {"thth_approve", "thth_throw", "thth_token",
                                "thth_auth", "thth_refresh", "thth_revoke",

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

@@ -26,9 +26,13 @@ def json_parsers():
 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',
+     # 3.3.0 §F: 観測（observe）。morning は別名として残る。
+     'observe',
      # 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']
+     'admin reports reply', 'admin reports close', 'admin reports export',
+     # 3.3.1 §4: 人の口 thth inflight（show|resolve・--json）。
+     'inflight']
 
 
 def test_json_table_covers_every_parser():

{thth-3.2.0 → thth-3.3.1}/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\n'+__import__('thth.report_inbox').report_inbox.CHANNEL_LINE  # 3.1.2 §3.5: 断りの理由行の後ろに受け口の案内 1 行
+    assert __import__('tests.conftest').conftest.is_refusal(captured.err, 'account_leaving')  # 3.1.2 §3.5・3.3.0 B3: 断りの理由行の後ろに打てる報告の 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\n'+__import__('thth.report_inbox').report_inbox.CHANNEL_LINE  # 3.1.2 §3.5: 断りの理由行の後ろに受け口の案内 1 行
+    assert __import__('tests.conftest').conftest.is_refusal(capsys.readouterr().err, 'account_leaving')  # 3.1.2 §3.5・3.3.0 B3: 断りの理由行の後ろに打てる報告の 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\n'+__import__('thth.report_inbox').report_inbox.CHANNEL_LINE  # 3.1.2 §3.5: 断りの理由行の後ろに受け口の案内 1 行
+    assert __import__('tests.conftest').conftest.is_refusal(result.stderr, 'account_leaving')  # 3.1.2 §3.5・3.3.0 B3: 断りの理由行の後ろに打てる報告の 1 行
 
 
 def test_report_holds_lease_through_calculation_and_release(env,monkeypatch):

{thth-3.2.0 → thth-3.3.1}/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\n' + __import__('thth.report_inbox').report_inbox.CHANNEL_LINE  # 3.1.2 §3.5: 断りの理由行の後ろに受け口の案内 1 行
+    assert result.returncode == 2 and __import__('tests.conftest').conftest.is_refusal(result.stderr, 'account_leaving')  # 3.1.2 §3.5・3.3.0 B3: 断りの理由行の後ろに打てる報告の 1 行
     if operation == 'replies':
         assert json.loads(result.stdout) == {'error': 'account_leaving', 'cannot_say': ['account_leaving']}
     assert not marker.exists()

{thth-3.2.0 → thth-3.3.1}/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\n'+__import__('thth.report_inbox').report_inbox.CHANNEL_LINE  # 3.1.2 §3.5: 断りの理由行の後ろに受け口の案内 1 行
+    assert __import__('tests.conftest').conftest.is_refusal(captured.err, 'invalid_account_name')  # 3.1.2 §3.5・3.3.0 B3: 断りの理由行の後ろに打てる報告の 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.2.0 → thth-3.3.1}/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+'\n'+__import__('thth.report_inbox').report_inbox.CHANNEL_LINE  # 3.1.2 §3.5: 断りの理由行の後ろに受け口の案内 1 行
+    shown=capsys.readouterr();assert __import__('tests.conftest').conftest.is_refusal(shown.err, expected)  # 3.1.2 §3.5・3.3.0 B3: 断りの理由行の後ろに打てる報告の 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.2.0 → thth-3.3.1}/tests/test_v310_morning.py

@@ -285,9 +285,10 @@ def test_既定で栞が進み_no_markでは進まない(one, thth_root):
     assert morning.build(PROJECT, now=NOW, mark=False)["marked"] == []
     assert not path.exists(), "--no-mark なのに栞が進んだ"
     payload = morning.build(PROJECT, now=NOW)
-    assert payload["marked"] == [ACCOUNT] and payload["marked_by"] == "morning"
+    # 3.3.0 §F: 栞の名乗りは呼んだ名前（build の既定は observe）。
+    assert payload["marked"] == [ACCOUNT] and payload["marked_by"] == "observe"
     saved = json.loads(path.read_text(encoding="utf-8"))
-    assert saved["by"] == "morning" and saved["snapshot"]["tool_version"]
+    assert saved["by"] == "observe" and saved["snapshot"]["tool_version"]
 
 
 def test_栞を進めたあとは版の変化が読める(one, thth_root):
@@ -349,9 +350,10 @@ def test_MCPのthth_morningは設計の文言でCLIを呼ぶだけ(one, monkeypa
         monkeypatch.delenv(key, raising=False)
     server = _load_server_module()
     tool = next(item for item in server.TOOLS if item["name"] == "thth_morning")
+    # 3.3.0 §F: thth_morning は thth_observe の別名になった（説明文も観測の文言）。
     assert tool["description"] == (
-        "朝いちばんに呼ぶ。昨日から何があって、今日なにをすればよいかを、"
-        "道具が事実だけで 1 枚にする。本文は作らない")
+        "thth_observe の別名（同じ 1 枚を返す）。セッションの始めと区切りごとに呼ぶ。"
+        "前回の観測から何があって、いまなにをすればよいかを、道具が事実だけで 1 枚にする")
     seen = []
 
     class Done:

{thth-3.2.0 → thth-3.3.1}/tests/test_v312_report_channel.py

@@ -21,17 +21,26 @@ import pytest
 
 from thth import accounts, cli, jst, morning, operations_handoff, report_inbox
 
-# **文面は 1 種類・静的**（設計 §3.5）。ここが正本の写し——変えるなら設計と一緒に。
-CHANNEL_LINE = "report_channel: thth report file <account> --kind bug|request（MCP: thth_report_file）"
-LIMITATION = "不具合と要望は report の口へ（thth_report_file）"
+# **文面は静的**（設計 §3.5）。ここが正本の写し——変えるなら設計と一緒に。
+# 3.3.0 B1・B4: friction と「報告は依頼の範囲内」の 1 文を足した。断りの行は
+# account と理由の符丁を埋めた「打てる 1 行」になった（B3・`refusal_line()`）。
+WELCOME = ("つまずき・迷い・期待との違いの報告は、利用者の作業の一部として歓迎します。"
+           "小さいものも。重複は道具が束ねます")
+CHANNEL_LINE = ("report_channel: thth report file <account> --kind bug|request|friction"
+                "（MCP: thth_report_file）——" + WELCOME)
+LIMITATION = "不具合・要望・つまずきは report の口へ（thth_report_file）"
 HINT = "（うまくいかなければ thth_report_file）"
 
 
 def test_受け口の文面は1種類で設計のまま():
     assert report_inbox.CHANNEL_LINE == CHANNEL_LINE
     assert report_inbox.CHANNEL == {
-        "cli": "thth report file <account> --kind bug|request --title … --body-file … --by <名前>",
-        "mcp": "thth_report_file", "when": "unexpected_or_unsupported"}
+        "cli": "thth report file <account> --kind bug|request|friction --title … --body-file … --by <名前>",
+        "from_last_refusal": "thth report file <account> --from-last-refusal --title … --by <名前>",
+        "mcp": "thth_report_file", "when": "unexpected_or_unsupported",
+        "welcome": WELCOME,
+        "examples": ["止まったのに気づかなかった", "断られた理由が分からなかった",
+                     "同じ操作を 3 回繰り返した"]}
 
 
 @pytest.fixture
@@ -169,7 +178,10 @@ def test_サーバ型の利用者の一枚には件数を出さない(projects,
 def test_CLIの断りの後ろに受け口の1行_成功には載せない(projects, tmp_path, capsys):
     assert cli.main(["morning", "nobody", "--json"]) == 2
     err = capsys.readouterr().err.strip().splitlines()
-    assert err == ["target_unknown", CHANNEL_LINE]
+    # 3.3.0 B3: 理由の符丁を埋めた打てる 1 行（account を持たない命令は <account> のまま）。
+    assert err == ["target_unknown",
+                   'report_channel: thth report file <account> --kind friction --from-last-refusal'
+                   ' --title "target_unknown で断られた" --by <名前>（' + WELCOME + '）']
     assert cli.main(["report", "list", "kopicha", "--json"]) == 0
     assert CHANNEL_LINE not in capsys.readouterr().err
 
@@ -179,14 +191,14 @@ def test_lintの検査結果の1は断りではない(projects, tmp_path, capsys
     bad.write_text("---\nthth: 1\n---\n本文\n", encoding="utf-8")
     rc = cli.main(["lint", str(bad), "--json"])
     assert rc == 1
-    assert CHANNEL_LINE not in capsys.readouterr().err
+    assert "report_channel" not in capsys.readouterr().err
 
 
 def test_helpの末尾に1行(capsys):
     with pytest.raises(SystemExit):
         cli.main(["--help"])
     out = capsys.readouterr().out.rstrip().splitlines()
-    assert out[-1] == "不具合と要望は report の口へ: thth report file <account> --kind bug|request（MCP: thth_report_file）"
+    assert out[-1] == "不具合・要望・つまずきは report の口へ: thth report file <account> --kind bug|request|friction（MCP: thth_report_file）"
     with pytest.raises(SystemExit):
         cli.main(["report", "--help"])
     assert "道具が断った・結果が期待と違った・欲しい形がある" in capsys.readouterr().out
@@ -255,7 +267,7 @@ def test_利用者のtools_listの説明文の末尾に1句(user_server, monkeyp
         else:
             assert tool["description"].endswith(HINT), tool["name"]
     file_tool = next(tool for tool in listed if tool["name"] == "thth_report_file")
-    assert file_tool["description"].startswith("道具が断った・結果が期待と違った・欲しい形がある、のどれかならこれで置く")
+    assert file_tool["description"].startswith("道具が断った・結果が期待と違った・欲しい形がある・迷った、のどれかならこれで置く")
     # 定数（売り文句の正本）は書き換えない。
     assert not any(tool["description"].endswith(HINT) for tool in server.TOOLS)
     # 管理者の一覧には足さない（管理者は報告を置く側ではない）。