thth 3.1.2__tar.gz → 3.3.0__tar.gz

{thth-3.1.2 → thth-3.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: thth
-Version: 3.1.2
+Version: 3.3.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`・`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`・`location`・`notifications`・`report`・`admin`。
 - **最初の本番投稿の記録**: 2026-09-09、@aoking に疎通確認を 1 本（`17916074118445631`）。
 - **未着手**: X・Facebook ページ・Instagram の各アダプタ。トピック検索の権限（tester には降りない）。泉のサーバ（v2-5）。
 - **権限の制約**: tester に降りる scope は 5 つ。削除はできない。

{thth-3.1.2 → thth-3.3.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`・`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`・`location`・`notifications`・`report`・`admin`。
 - **最初の本番投稿の記録**: 2026-09-09、@aoking に疎通確認を 1 本（`17916074118445631`）。
 - **未着手**: X・Facebook ページ・Instagram の各アダプタ。トピック検索の権限（tester には降りない）。泉のサーバ（v2-5）。
 - **権限の制約**: tester に降りる scope は 5 つ。削除はできない。

{thth-3.1.2 → thth-3.3.0}/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": {
@@ -608,6 +633,14 @@ REPORT_TOOLS = [
      "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}},
 ]
 
 
@@ -622,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():
@@ -641,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
@@ -651,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')
@@ -681,12 +721,13 @@ def server_call(name, arguments):
         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'):
+        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:
@@ -706,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
@@ -884,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")
@@ -917,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.1.2 → thth-3.3.0}/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` を「変更なし」と解釈しない。
 
@@ -108,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
@@ -143,7 +149,9 @@ 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`。
 
 ## 運用と分析のレポート（v3系・2.5.0 から）

{thth-3.1.2 → thth-3.3.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 が壊れている型外テスト等: 計算できないので触らない
@@ -427,3 +429,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.1.2 → thth-3.3.0}/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.1.2 → thth-3.3.0}/tests/test_v210_json_contract.py

@@ -26,8 +26,10 @@ 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', 'admin reports list', 'admin reports show',
+     'report file', 'report list', 'report show', 'report add', 'admin reports list', 'admin reports show',
      'admin reports reply', 'admin reports close', 'admin reports export']
 
 

{thth-3.1.2 → thth-3.3.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\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.1.2 → thth-3.3.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\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.1.2 → thth-3.3.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\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.1.2 → thth-3.3.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+'\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.1.2 → thth-3.3.0}/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.1.2 → thth-3.3.0}/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)
     # 管理者の一覧には足さない（管理者は報告を置く側ではない）。