@tyhld/conductor 0.12.88 → 0.12.90

package/scripts/hooks/test_finish_gate.py

@@ -0,0 +1,323 @@
+#!/usr/bin/env python3
+"""便の終わりの関門の検査（便 7aa63a97）。
+
+  実行: python3 scripts/hooks/test_finish_gate.py
+  1件でも期待と違えば exit 1。
+
+【直したこと】職人が「合流・公開・本番の確かめ・報告」の前に手番を閉じるのを、仕組みで止める。
+  実地 2026-10-02〜03 に3回起きた（915694ac・47bdfe00・dc1c9ed2）。どの便の本文にも
+  「待ちを背景に残したまま手番を閉じない」と書いてあった＝★指示の文では止まらない。
+
+【ここで固定すること】
+  (A) 報告の判定 … 無い・空・囲みが無い・欄が足りない・outcome が変・evidence 0件・
+      本文が空・下書きの印が残っている → 残り。最終版 → 残り無し
+  (B) 背景の待ちの数え方 … 始まった印（backgroundTaskId）と知らせ（task-notification）の差。
+      ★実地 915694ac・47bdfe00 と同じ形の記録で確かめる
+  (C) PR の判定 … 開いたまま／合流の予約中 → 残り。空・合流済み → 残り無し。
+      便の本文が「合流は人が行う」なら見ない
+  (D) 回数の上限 … 同じ理由で止めるのは上限まで。上限に達したら止めずに終わらせる
+  (E) 返す文 … 「何が残っているか」と「次にやること」が入る
+  (F) ★止めない便 … 便の印が無い／画面なし方式でない／人への問いかけで終わった
+  (G) ★実地の3件の再現 … 当時の実物を置くと、関門がそれぞれ止める
+
+★空振り確認（隔離した worktree の中だけ）:
+  ・finish_gate.decide の上限の判定（`counts[k] < cap`）を外す → (D) が落ちる
+  ・report_residue の下書きの印の判定を外す → (A) が落ちる
+  ・stop_hook.main から関門の呼び出しを外す → (G) の「止める」が落ちる
+"""
+import json
+import os
+import sys
+import tempfile
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+import finish_gate  # noqa: E402
+import stop_hook  # noqa: E402
+
+failures = []
+
+
+def check(label, got, want):
+    ok = got == want
+    if not ok:
+        failures.append(f'{label}: got={got!r} want={want!r}')
+    print(f'{"OK " if ok else "NG "} {label:66} {str(got)[:46]}')
+
+
+def truthy(label, got):
+    ok = bool(got)
+    if not ok:
+        failures.append(f'{label}: got={got!r} want=真')
+    print(f'{"OK " if ok else "NG "} {label:66} {str(got)[:46]}')
+
+
+SANDBOX = tempfile.mkdtemp(prefix='finish-gate-test-')
+ENV = {'HOME': SANDBOX, 'XDG_STATE_HOME': os.path.join(SANDBOX, 'state'),
+       'CONDUCTOR_RUNNER_MODE': 'headless', 'CONDUCTOR_SITE': 'demo'}
+JOB = '7aa63a97-57e7-4c42-8b95-f3da87d88829'
+
+
+def report_text(outcome='pushed', body='やりました。', header=True, evidence=True):
+    head = ['---', f'instruction_id: {JOB}', 'site: demo', f'outcome: {outcome}',
+            'created_at: 2026-10-03T09:00:00+09:00', 'evidence:']
+    if evidence:
+        head.append('  - PR https://github.com/tyhld/conductor/pull/999')
+    head.append('---')
+    return ('\n'.join(head) + '\n\n' + body) if header else body
+
+
+def put_report(text, command_id=JOB):
+    d = os.path.join(ENV['XDG_STATE_HOME'], 'conductor', 'reports')
+    os.makedirs(d, exist_ok=True)
+    with open(os.path.join(d, f'{command_id}.md'), 'w', encoding='utf-8') as f:
+        f.write(text)
+
+
+def drop_report(command_id=JOB):
+    for f in finish_gate.report_files(command_id, ENV):
+        if os.path.isfile(f):
+            os.remove(f)
+
+
+def put_job_body(body, site='demo'):
+    d = os.path.join(ENV['XDG_STATE_HOME'], 'conductor')
+    os.makedirs(d, exist_ok=True)
+    with open(os.path.join(d, f'active-job-{site}.json'), 'w', encoding='utf-8') as f:
+        json.dump({'commandId': JOB, 'body': body, 'site': site}, f)
+
+
+def transcript(lines, name='t.jsonl'):
+    p = os.path.join(SANDBOX, name)
+    with open(p, 'w', encoding='utf-8') as f:
+        f.write('\n'.join(lines) + '\n')
+    return p
+
+
+def clear_counts(command_id=JOB):
+    for p in (finish_gate.counts_path(command_id, ENV), finish_gate.residue_path(command_id, ENV)):
+        if os.path.isfile(p):
+            os.remove(p)
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('=== (A) 報告の判定（★実物の形だけを見る） ===')
+# ─────────────────────────────────────────────────────────────────────────────
+check('無い → 残り', bool(finish_gate.report_residue(None)), True)
+check('空 → 残り', bool(finish_gate.report_residue('   \n ')), True)
+check('囲みが無い → 残り', bool(finish_gate.report_residue('やりました。')), True)
+check('囲みが閉じていない → 残り',
+      bool(finish_gate.report_residue('---\ninstruction_id: x\n\n本文')), True)
+check('欄が足りない → 残り',
+      bool(finish_gate.report_residue('---\ninstruction_id: x\nsite: demo\n---\n\n本文')), True)
+check('outcome が変 → 残り', bool(finish_gate.report_residue(report_text(outcome='やった'))), True)
+check('outcome が空 → 残り', bool(finish_gate.report_residue(report_text(outcome=''))), True)
+check('evidence 0件 → 残り', bool(finish_gate.report_residue(report_text(evidence=False))), True)
+check('本文が空 → 残り', bool(finish_gate.report_residue(report_text(body=''))), True)
+check('★最終版 → 残り無し', finish_gate.report_residue(report_text()), None)
+check('no_change も通る', finish_gate.report_residue(report_text(outcome='no_change')), None)
+check('blocked も通る', finish_gate.report_residue(report_text(outcome='blocked')), None)
+
+print('--- ★下書きの印（実地 915694ac の本文そのまま） ---')
+REAL_DRAFT = '# 便 915694ac 報告（作成中）\n\nこの見出しは最終版で差し替える。'
+truthy('実地の下書き → 残り', finish_gate.report_residue(report_text(body=REAL_DRAFT)))
+for m in ('作成中', '下書き', '差し替える', 'あとで書く', '（未記入）', 'TODO', 'TBD'):
+    truthy(f'下書きの印「{m}」→ 残り', finish_gate.report_residue(report_text(body=f'あ{m}い')))
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (B) 背景の待ちの数え方（★実地と同じ形の記録） ===')
+# ─────────────────────────────────────────────────────────────────────────────
+START = '{"toolUseResult":{"stdout":"","backgroundTaskId":"%s"}}'
+NOTIFY = ('{"message":{"content":[{"type":"text","text":"<task-notification>\\n'
+          '<task-id>%s</task-id>\\n<status>%s</status>\\n</task-notification>"}]}}')
+
+check('何も無い → 残り0', finish_gate.outstanding_background_tasks(transcript(['{}'])), [])
+check('始まって知らせが来た → 残り0',
+      finish_gate.outstanding_background_tasks(
+          transcript([START % 'b1', NOTIFY % ('b1', 'completed')], 'a.jsonl')), [])
+check('★始まったのに知らせが無い → 残る（915694ac の形）',
+      finish_gate.outstanding_background_tasks(
+          transcript([START % 'b4s4rn5ee', NOTIFY % ('b4s4rn5ee', 'completed'),
+                      START % 'b32iul78k'], 'b.jsonl')), ['b32iul78k'])
+check('★複数残る（47bdfe00 の形）',
+      finish_gate.outstanding_background_tasks(
+          transcript([START % 'b445wfjet', START % 'be6b727fc', START % 'buu5zuhgd',
+                      NOTIFY % ('buu5zuhgd', 'completed')], 'c.jsonl')),
+      ['b445wfjet', 'be6b727fc'])
+check('知らせが killed でも「知らせは来た」＝残らない',
+      finish_gate.outstanding_background_tasks(
+          transcript([START % 'b1', NOTIFY % ('b1', 'killed')], 'd.jsonl')), [])
+check('★道具の説明文の中の字面は知らせと読まない',
+      finish_gate.outstanding_background_tasks(
+          transcript([START % 'b1',
+                      '{"text":"<task-notification> arrives when the workflow completes"}'],
+                     'e.jsonl')), ['b1'])
+check('記録が無い → 残り0（読めないものは無い側へ倒す）',
+      finish_gate.outstanding_background_tasks('/nope/nothing.jsonl'), [])
+check('残りが在れば理由になる', bool(finish_gate.background_residue(['b1'])), True)
+check('残りが無ければ理由にならない', finish_gate.background_residue([]), None)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (C) PR の判定 ===')
+# ─────────────────────────────────────────────────────────────────────────────
+check('開いた PR 無し → 残り無し', finish_gate.open_pr_residue([]), None)
+check('聞けなかった（None）→ 残り無し（分からないものは止めない側）',
+      finish_gate.open_pr_residue(None), None)
+truthy('★開いたまま → 残り（915694ac の PR #252 の形）',
+       finish_gate.open_pr_residue([{'number': 252, 'state': 'OPEN', 'autoMergeRequest': None}]))
+r = finish_gate.open_pr_residue([{'number': 397, 'state': 'OPEN',
+                                  'autoMergeRequest': {'enabledAt': 'x'}}])
+truthy('★合流の予約中のまま → 残り（47bdfe00 の形）', r)
+check('予約中だと分かる文になっている', '予約' in (r or ''), True)
+check('合流済み（MERGED）→ 残り無し',
+      finish_gate.open_pr_residue([{'number': 1, 'state': 'MERGED', 'autoMergeRequest': None}]), None)
+
+print('--- 便の本文に「合流は人が行う」と書いてある便は見ない（ADR-007） ---')
+for b in ['この便のマージは人間が行う', '合流は人が行う', 'マージは人間が行います',
+          '★この便では合流しない', '人がマージする']:
+    check(f'「{b}」', finish_gate.human_merge_requested(b), True)
+for b in ['合流まで進めてください', '鉄則7のとおり合流する', '']:
+    check(f'ふつうの便「{b[:20]}」', finish_gate.human_merge_requested(b), False)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (D) 回数の上限（★止め続けて便が終わらなくなる形にしない） ===')
+# ─────────────────────────────────────────────────────────────────────────────
+R1 = {'report': '報告が無い'}
+d = finish_gate.decide(R1, {}, cap=3)
+check('1回目は止める', d['block'], True)
+check('回数が1になる', d['counts']['report'], 1)
+d = finish_gate.decide(R1, {'report': 2}, cap=3)
+check('3回目は止める', d['block'], True)
+check('3回目は「最後の差し戻し」と分かる', d['last'], True)
+d = finish_gate.decide(R1, {'report': 3}, cap=3)
+check('★上限に達したら止めない（便が終わる）', d['block'], False)
+check('★ただし「途中で終わった」と分かる（種類が残る）', d['kinds'], ['report'])
+truthy('控えの文に理由が入る', '途中で終わった' in finish_gate.build_residue_text(d))
+
+print('--- ★控えは「管制が機械で読める形」でも残す（便 461be339） ---')
+rec = finish_gate.build_residue_record(d)
+truthy('人向けの1行は今までどおり', '途中で終わった' in rec['text'])
+check('★残っていた種類が入る', rec['reasons'], ['report'])
+check('★止めた回数が3種類ぶん入る', rec['counts'], {'report': 3, 'pr': 0, 'background': 0})
+rec3 = finish_gate.build_residue_record(
+    finish_gate.decide({'report': 'a', 'pr': 'b', 'background': 'c'},
+                       {'report': 3, 'pr': 3, 'background': 3}, cap=3))
+check('3つ残ったまま終わったら3つとも入る', rec3['reasons'], ['report', 'pr', 'background'])
+
+check('残りが無ければ止めない', finish_gate.decide({}, {}, cap=3)['block'], False)
+check('残りが無ければ種類も空', finish_gate.decide({}, {'report': 1}, cap=3)['kinds'], [])
+
+d = finish_gate.decide({'report': 'a', 'pr': 'b', 'background': 'c'}, {}, cap=3)
+check('3つ同時でも1回で止める', d['block'], True)
+check('3つぶん数える', sorted(d['kinds']), ['background', 'pr', 'report'])
+d = finish_gate.decide({'report': 'a', 'pr': 'b'}, {'report': 2, 'pr': 2, 'background': 2}, cap=3)
+check('★合計の上限（本体の連続上限 8 の内側）で止めなくなる', d['block'], False)
+check('cap=0 なら1回も止めない', finish_gate.decide(R1, {}, cap=0)['block'], False)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (E) 職人へ返す文 ===')
+# ─────────────────────────────────────────────────────────────────────────────
+d = finish_gate.decide({'report': '報告が下書きのまま', 'pr': 'PR #252 が開いたまま',
+                        'background': '背景に回した待ちが 1 件残っている'}, {}, cap=3)
+msg = finish_gate.build_reason(d)
+truthy('何が残っているかが入る', '残っているもの' in msg)
+truthy('次にやることが入る', '次にやること' in msg)
+truthy('残りの理由がそのまま入る', 'PR #252 が開いたまま' in msg)
+truthy('★手番を閉じないでと書いてある', '閉じない' in msg)
+truthy('★画面なし方式では手番の終わり＝処理の終わりと書いてある', '手番の終わり' in msg)
+truthy('鉄則7の4段を指している', '合流後' in msg or '鉄則7' in msg)
+last = finish_gate.build_reason(finish_gate.decide(R1, {'report': 2}, cap=3))
+truthy('最後の差し戻しだと伝える', '最後の差し戻し' in last)
+truthy('終わらせ方（blocked）を示す', 'blocked' in last)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (F) ★止めない便 ===')
+# ─────────────────────────────────────────────────────────────────────────────
+check('画面なし方式の印が在る → 効く', stop_hook.gate_enabled(ENV), True)
+for mode in ('tmux', '', 'TMUX'):
+    e = dict(ENV, CONDUCTOR_RUNNER_MODE=mode)
+    check(f'画面の方式（{mode or "印なし"}）→ 効かない', stop_hook.gate_enabled(e), False)
+check('印そのものが無い → 効かない', stop_hook.gate_enabled({}), False)
+
+clear_counts()
+drop_report()
+check('★便の印が無い記録 → 止めない（便ではない）',
+      stop_hook.finish_gate_block(
+          {'transcript_path': transcript(['{"text":"ふつうの作業"}'], 'nojob.jsonl')}, ENV), None)
+check('★人が答えるべき問いかけは関門より先（確認カードの経路へ）',
+      stop_hook.needs_human_answer('どちらにしますか？'), True)
+check('進捗の報告は問いかけではない',
+      stop_hook.needs_human_answer('CI の完走を待っています。'), False)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (G) ★実地の3件の再現（実物を置いて、関門が止めるか） ===')
+# ─────────────────────────────────────────────────────────────────────────────
+JOB_LINE = f'{{"text":"CONDUCTOR_JOB:{JOB}"}}'
+put_job_body('鉄則7のとおり合流まで進めてください')
+
+# 915694ac … 報告が下書きのまま ＋ 背景の待ちが残っている
+clear_counts()
+put_report(report_text(body=REAL_DRAFT))
+t = transcript([JOB_LINE, START % 'b32iul78k'], 'g1.jsonl')
+msg = stop_hook.finish_gate_block({'transcript_path': t, 'cwd': SANDBOX}, ENV)
+truthy('★915694ac の形 → 止める', msg)
+truthy('  下書きだと言う', '下書き' in (msg or ''))
+truthy('  背景の待ちが残っていると言う', '背景' in (msg or ''))
+
+# 47bdfe00 … 報告本文が1文字も無い
+clear_counts()
+put_report(report_text(body=''))
+t = transcript([JOB_LINE, START % 'be6b727fc'], 'g2.jsonl')
+msg = stop_hook.finish_gate_block({'transcript_path': t, 'cwd': SANDBOX}, ENV)
+truthy('★47bdfe00 の形 → 止める', msg)
+
+# dc1c9ed2 … 報告が1つも無い
+clear_counts()
+drop_report()
+t = transcript([JOB_LINE], 'g3.jsonl')
+msg = stop_hook.finish_gate_block({'transcript_path': t, 'cwd': SANDBOX}, ENV)
+truthy('★dc1c9ed2 の形（報告が無い）→ 止める', msg)
+
+print('--- ★きちんと終わった便は止めない ---')
+clear_counts()
+put_report(report_text())
+t = transcript([JOB_LINE, START % 'b1', NOTIFY % ('b1', 'completed')], 'g4.jsonl')
+check('最終版の報告＋待ち無し → 止めない',
+      stop_hook.finish_gate_block({'transcript_path': t, 'cwd': SANDBOX}, ENV), None)
+
+print('--- ★上限に達したら終わらせ、理由の控えを残す ---')
+clear_counts()
+drop_report()
+t = transcript([JOB_LINE], 'g5.jsonl')
+stops = 0
+for _ in range(8):
+    if stop_hook.finish_gate_block({'transcript_path': t, 'cwd': SANDBOX}, ENV):
+        stops += 1
+    else:
+        break
+check('止めた回数は上限まで', stops, finish_gate.CAP_PER_KIND)
+check('その後は止めない',
+      stop_hook.finish_gate_block({'transcript_path': t, 'cwd': SANDBOX}, ENV), None)
+rp = finish_gate.residue_path(JOB, ENV)
+truthy('理由の控えが残る', os.path.isfile(rp))
+with open(rp, encoding='utf-8') as f:
+    got = json.load(f)
+truthy('控えに「途中で終わった」と入っている', '途中で終わった' in got['text'])
+check('★控えの種類を中継が機械で読める', got.get('reasons'), ['report'])
+check('★控えの回数は上限ちょうど', (got.get('counts') or {}).get('report'), finish_gate.CAP_PER_KIND)
+
+print('--- ★便の本文が「合流は人が行う」なら PR を見ない ---')
+clear_counts()
+put_report(report_text())
+put_job_body('★この便のマージは人間が行う')
+t = transcript([JOB_LINE, START % 'b1', NOTIFY % ('b1', 'completed')], 'g6.jsonl')
+check('合流を人に任せた便は止めない',
+      stop_hook.finish_gate_block({'transcript_path': t, 'cwd': SANDBOX}, ENV), None)
+
+print('\n' + '=' * 72)
+if failures:
+    print(f'NG {len(failures)} 件')
+    for f in failures:
+        print('  ' + f)
+    sys.exit(1)
+print('すべて期待どおり')

package/scripts/hooks/test_guard_tyhld_whole_tree.py

@@ -0,0 +1,165 @@
+#!/usr/bin/env python3
+"""番人の守る場所を ~/.tyhld まるごとに広げたことの検査（便 7aa63a97・発見は便 b7bd5e43）。
+
+  実行: python3 scripts/hooks/test_guard_tyhld_whole_tree.py
+  1件でも期待と違えば exit 1。
+
+【直した穴（2026-10-03 に実物で再現）】
+  Write・Edit は前から ~/.tyhld のどこでも止めていた。ところが Bash は hooks と bin の下しか
+  止めず、~/.tyhld の直下（kc の実体・ブラウザの道具・控え・notify の置き場）は職人の
+  touch・rm・リダイレクト・cp・mv・sed -i から書けた。
+  実測（直す前）: `touch ~/.tyhld/kc.sh` → allow / `touch ~/.tyhld/hooks/x` → deny
+  ＝道具によって結果が違う穴。
+
+【ここで固定すること】
+  (A) ★~/.tyhld の【どこへ】【どの書き方で】書こうとしても止まる（直下もぜんぶ）
+  (B) 前から止まっていた hooks・bin の下は1件も通らない（守りを弱めない）
+  (C) 読むのは今までどおり通る（cat・grep・ls・jq・cp で外へ写す）
+  (D) 使い捨ての作業場（/tmp の下）に作った同じ名前は止めない
+  (E) Write・Edit も今までどおり止まる（道具をまたいで結果が同じ）
+  (F) ★守る場所の一覧に ~/.tyhld が入っている（hooks・bin の2行も残っている＝OR で広がる）
+
+★空振り確認：policy.GUARD_PLACES から ('home-tree', '.tyhld') を外すと (A) の直下の件が落ちる。
+"""
+import os
+import sys
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+import policy  # noqa: E402
+
+failures = []
+
+
+def check(label, got, want):
+    ok = got == want
+    if not ok:
+        failures.append(f'{label}: got={got!r} want={want!r}')
+    print(f'{"OK " if ok else "NG "} {label:72} {str(got)[:40]}')
+
+
+def bash(cmd):
+    return policy.decide_bash(cmd)['decision']
+
+
+HOME = os.path.expanduser('~')
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('=== (F) 守る場所の一覧 ===')
+# ─────────────────────────────────────────────────────────────────────────────
+_home_trees = tuple(p for k, p in policy.GUARD_PLACES if k == 'home-tree')
+check('一覧に .tyhld まるごとが入っている', '.tyhld' in _home_trees, True)
+check('★hooks の行は消していない（弱めない）', '.tyhld/hooks' in _home_trees, True)
+check('★bin の行は消していない（弱めない）', '.tyhld/bin' in _home_trees, True)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (A) ~/.tyhld の直下への書き込みは、どの書き方でも止まる ===')
+# ─────────────────────────────────────────────────────────────────────────────
+#: 直下の実在の物（kc の実体・ブラウザの道具・控え・notify の置き場）。
+DIRECT = [
+    'touch ~/.tyhld/kc.sh',
+    'touch $HOME/.tyhld/kc.sh',
+    'touch ${HOME}/.tyhld/kc.sh',
+    f'touch {HOME}/.tyhld/kc.sh',
+    'rm -f ~/.tyhld/kc.sh',
+    'rm -rf ~/.tyhld',
+    'echo x > ~/.tyhld/kc.sh',
+    'echo x >> ~/.tyhld/kc.sh',
+    'printf x > $HOME/.tyhld/kc.sh',
+    'tee ~/.tyhld/kc.sh',
+    'cp /tmp/claude-1000/a ~/.tyhld/kc.sh',
+    'cp -r /tmp/claude-1000/d ~/.tyhld/',
+    'mv /tmp/claude-1000/a ~/.tyhld/kc.sh',
+    'mv ~/.tyhld /tmp/claude-1000/moved',
+    'sed -i s/a/b/ ~/.tyhld/kc.sh',
+    'chmod 777 ~/.tyhld/kc.sh',
+    'ln -s /tmp/claude-1000/a ~/.tyhld/kc.sh',
+    'install -m 755 /tmp/claude-1000/a ~/.tyhld/kc.sh',
+    'truncate -s 0 ~/.tyhld/kc.sh',
+    'tar -xzf /tmp/claude-1000/a.tgz -C ~/.tyhld',
+    'unzip /tmp/claude-1000/a.zip -d ~/.tyhld',
+    'curl -o ~/.tyhld/kc.sh https://example.invalid/x',
+    'wget -O ~/.tyhld/kc.sh https://example.invalid/x',
+    'touch ~/.tyhld/pw-venv/x',
+    'touch ~/.tyhld/pw-browsers/x',
+    'touch ~/.tyhld/skill-backups/x',
+    'touch ~/.tyhld/codex-notify/x',
+    'touch ~/.tyhld/hookset/x',
+    'bash -c "touch ~/.tyhld/kc.sh"',
+    'env X=1 touch ~/.tyhld/kc.sh',
+    'nohup touch ~/.tyhld/kc.sh',
+    '( touch ~/.tyhld/kc.sh )',
+    'echo ok; touch ~/.tyhld/kc.sh',
+    'D=~/.tyhld; touch $D/kc.sh',
+    'xargs touch ~/.tyhld/kc.sh',
+    'find ~/.tyhld -type f -exec rm -f {} +',
+    'python3 -c "import pathlib; (pathlib.Path.home() / \'.tyhld\' / \'kc.sh\').write_text(\'x\')"',
+    # ★この機体の本物のホームで書く（CI の機体では HOME が違うので、字面を焼き付けない）。
+    f'python3 -c "open(\'{HOME}/.tyhld/kc.sh\', \'w\').write(\'x\')"',
+    'node -e "require(\'fs\').writeFileSync(process.env.HOME + \'/.tyhld/kc.sh\', \'x\')"',
+]
+for c in DIRECT:
+    check(c, bash(c), policy.DENY)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (B) 前から止まっていた hooks・bin の下は1件も通らない ===')
+# ─────────────────────────────────────────────────────────────────────────────
+OLD = [
+    'touch ~/.tyhld/hooks/x',
+    'touch ~/.tyhld/bin/x',
+    'echo x > ~/.tyhld/hooks/cc2_guard.py',
+    'cp /tmp/claude-1000/a ~/.tyhld/bin/conductor-run',
+    'rm -rf ~/.tyhld/hooks',
+    'rm -f ~/.tyhld/bin/autoupdate/drain',
+    'touch ~/.tyhld/bin/autoupdate/enabled',
+    'sed -i s/a/b/ ~/.tyhld/hooks/policy.py',
+]
+for c in OLD:
+    check(c, bash(c), policy.DENY)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (C) 読むのは今までどおり通る ===')
+# ─────────────────────────────────────────────────────────────────────────────
+READS = [
+    'cat ~/.tyhld/kc.sh',
+    'ls -la ~/.tyhld',
+    'ls ~/.tyhld/bin',
+    'grep -n conductor ~/.tyhld/kc.sh',
+    'head -5 ~/.tyhld/bin/conductor-run',
+    'diff ~/.tyhld/kc.sh scripts/kc.sh',
+    'cp ~/.tyhld/kc.sh /tmp/claude-1000/copy.sh',
+    'wc -l ~/.tyhld/kc.sh',
+]
+for c in READS:
+    check(c, bash(c), policy.ALLOW)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (D) 使い捨ての作業場の同じ名前は止めない ===')
+# ─────────────────────────────────────────────────────────────────────────────
+for c in [
+    'touch /tmp/claude-1000/.tyhld/x',
+    'echo x > /tmp/claude-1000/sagyou/.tyhld/kc.sh',
+]:
+    check(c, bash(c), policy.ALLOW)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (E) Write・Edit も今までどおり止まる（道具をまたいで同じ結果） ===')
+# ─────────────────────────────────────────────────────────────────────────────
+for p in [
+    f'{HOME}/.tyhld/kc.sh',
+    f'{HOME}/.tyhld/hooks/policy.py',
+    f'{HOME}/.tyhld/bin/conductor-run',
+    f'{HOME}/.tyhld/codex-notify/x',
+]:
+    check(f'decide_write {p}', policy.decide_write(p)['decision'], policy.DENY)
+    for tool in ('Write', 'Edit', 'MultiEdit', 'NotebookEdit'):
+        d = policy.decide_event({'tool_name': tool, 'tool_input': {'file_path': p}})
+        check(f'{tool} {p}', d['decision'], policy.DENY)
+
+print('\n' + '=' * 72)
+if failures:
+    print(f'NG {len(failures)} 件')
+    for f in failures:
+        print('  ' + f)
+    sys.exit(1)
+print('すべて期待どおり')

package/scripts/hooks/test_report_shape.py

@@ -0,0 +1,122 @@
+#!/usr/bin/env python3
+"""報告の「形」の判定が、決まりの正本どおりであることの検査（便 461be339）。
+
+  実行: python3 scripts/hooks/test_report_shape.py
+  1件でも期待と違えば exit 1。
+
+【なぜ要るか】形の決まりは2か所から読まれる。
+  ① 中継（`src/relay.ts`）… 報告を「届いた」と数える条件
+  ② 便の終わりの関門（`finish_gate.py`）… 手番を閉じさせるかの判定
+  同じ決まりを2か所に書くと、片方だけ直して食い違う（＝関門は差し戻すのに中継は届いたと数える、
+  またはその逆）。だから決まりは `report-shape.json` の1か所だけに置き、
+  **同じ字面に同じ答えを出すこと**を両方の試験で固定する。
+  ★中継の側は `test/report-shape-gate.test.ts` が、この同じ `cases` を流して突き合わせる。
+
+【ここで固定すること】
+  (A) 正本が読めること（配り忘れ・壊れた JSON に気づける）
+  (B) 正本の `cases` の答えと、関門の判定が1件も違わないこと
+  (C) 正本が読めないときは形の判定をしない（fail open＝関門が足される前と同じ動き）
+  (D) ★下書きの印（本文の言葉）は正本に載せない
+      ＝中継からは言葉の決まりに手が届かない（えふさん確定 2026-09-23）
+  (E) 形と下書きの印は別の理由として返る
+
+★空振り確認（隔離した worktree の中だけ）:
+  ・`report-shape.json` の `requiredFields` から1つ消す → (B) が落ちる
+  ・`report_shape_missing` の outcome の確かめを外す → (B) が落ちる
+"""
+import json
+import os
+import sys
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+import finish_gate  # noqa: E402
+
+failures = []
+
+
+def check(label, got, want):
+    ok = got == want
+    if not ok:
+        failures.append(f'{label}: got={got!r} want={want!r}')
+    print(f'{"OK " if ok else "NG "} {label:70} {str(got)[:40]}')
+
+
+def truthy(label, got):
+    ok = bool(got)
+    if not ok:
+        failures.append(f'{label}: got={got!r} want=真')
+    print(f'{"OK " if ok else "NG "} {label:70} {str(got)[:40]}')
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('=== (A) 形の決まりの正本が読めるか ===')
+# ─────────────────────────────────────────────────────────────────────────────
+path = finish_gate.shape_spec_path()
+check('正本の置き場は自分と同じフォルダ', os.path.basename(path), 'report-shape.json')
+truthy('正本が在る', os.path.isfile(path))
+spec = finish_gate.load_shape_spec()
+truthy('正本が読める', spec)
+check('★関門は読み込み済みの正本を使う', finish_gate.SHAPE_SPEC is not None, True)
+check('足りない物の並び順まで決まっている',
+      spec['requiredFields'],
+      ['instruction_id', 'site', 'outcome', 'created_at', 'evidence', 'body'])
+check('outcome に書ける語', spec['validOutcomes'], ['pushed', 'no_change', 'blocked'])
+truthy('答え合わせの cases が在る', isinstance(spec.get('cases'), list) and spec['cases'])
+
+# ─────────────────────────────────────────────────────────────────────────────
+print(f'\n=== (B) 正本の cases（{len(spec["cases"])}件）の答えと1件も違わない ===')
+# ─────────────────────────────────────────────────────────────────────────────
+for case in spec['cases']:
+    check(case['name'][:68], finish_gate.report_shape_missing(case['text']), case['missing'])
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (C) 正本が読めないときは形の判定をしない（退行しない） ===')
+# ─────────────────────────────────────────────────────────────────────────────
+check('正本が無い → 足りない物は並べない', finish_gate.report_shape_missing('やりました。', {}), [])
+check('正本が壊れていても落ちない', finish_gate.load_shape_spec('/nope/report-shape.json'), None)
+check('requiredFields が無い正本は使わない',
+      finish_gate.load_shape_spec(os.path.join(os.path.dirname(path), 'safe_verbs.json')), None)
+good = spec['cases'][0]['text']
+check('★正本が読めなくても「報告が無い」は今までどおり止める',
+      bool(finish_gate.report_residue(None, {})), True)
+check('★正本が読めないときは形で止めない（fail open）',
+      finish_gate.report_residue(good, {}), None)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (D) ★下書きの印（本文の言葉）は正本に載せない ===')
+# ─────────────────────────────────────────────────────────────────────────────
+raw = open(path, encoding='utf-8').read()
+body_rules = json.loads(raw)
+for marker in ('作成中', '下書き', '差し替える', 'あとで書く', 'TODO', 'TBD'):
+    check(f'正本の決まりに「{marker}」が入っていない',
+          any(marker in json.dumps(body_rules.get(k), ensure_ascii=False)
+              for k in ('requiredFields', 'validOutcomes')),
+          False)
+truthy('下書きの印の正本は関門の側にある', finish_gate.DRAFT_MARKERS)
+
+# ─────────────────────────────────────────────────────────────────────────────
+print('\n=== (E) 形と下書きの印は別の理由として返る ===')
+# ─────────────────────────────────────────────────────────────────────────────
+draft = next(c for c in spec['cases'] if '下書きの言葉' in c['name'])
+check('★下書きの言葉が残った報告は、形としては整っている',
+      finish_gate.report_shape_missing(draft['text']), [])
+r = finish_gate.report_residue(draft['text'])
+truthy('それでも関門は下書きとして差し戻す', r)
+truthy('  理由は「下書き」だと分かる', '下書き' in (r or ''))
+broken = next(c for c in spec['cases'] if c['missing'] == ['body'])
+r2 = finish_gate.report_residue(broken['text'])
+truthy('形が整っていない報告は「形」の理由で差し戻す', r2)
+truthy('  理由は「形が整っていない」だと分かる', '形が整っていない' in (r2 or ''))
+truthy('  足りない物の名前が入る', '本文' in (r2 or ''))
+check('★最終版は差し戻さない', finish_gate.report_residue(good), None)
+check('本文の取り出しは囲みの下だけ', finish_gate.report_body(good).startswith('やりました'), True)
+check('囲みが無ければ全文が本文', finish_gate.report_body('ただの文'), 'ただの文')
+
+print('\n' + '=' * 72)
+if failures:
+    print(f'NG {len(failures)} 件')
+    for f in failures:
+        print('  ' + f)
+    sys.exit(1)
+print('すべて期待どおり')

package/scripts/update-guard.sh

@@ -436,8 +436,13 @@ INSTALL_FILES=(
   policy.py                   # cc2_guard / permission_request_hook が使う判定本体
   summary_ja.py               # permission_request_hook / stop_hook が使う日本語の文言
   hook_datalink.py            # 各フックが使う管制との連絡線
+  finish_gate.py              # stop_hook が使う「便の終わりの関門」の判定（便 7aa63a97）
 )
-INSTALL_CONFIGS=(safe_verbs.json network_allow.json)
+# ★番人と同居させる設定（任意・あれば一緒に置く）。この一覧は sales-template/setup.sh の
+#   GUARD_CONFIGS と【同じ集合】にすること（test/setup-installer.test.ts が同一を固定する）。
+#   report-shape.json … 報告の「形」の決まりの正本（finish_gate.py が実行時に読む・便 461be339）。
+#     配り忘れると関門が形を見られない（fail open＝書きかけを差し戻せない）。
+INSTALL_CONFIGS=(safe_verbs.json network_allow.json report-shape.json)
 ENTRYPOINTS=(cc2_guard.py permission_request_hook.py stop_hook.py notification_hook.py)
 
 # ①-0 見本と「配る中身」がズレていないか機械照合する（今回と同じ欠落事故の再発防止＝根治）。