@tyhld/conductor 0.12.132 → 0.12.134

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -10,8 +10,14 @@
10
10
  (f) ★negative test =転送の行き先が手元以外/ポートが 5432・6543/行き先が読めない形は、
11
11
  単独のコマンドでも止まる(ssh -L・-R・-D・-W・-o・-F・autossh・その他の転送の道具)。
12
12
  (k) 転送の無い ssh・git の ssh・手元どうしの転送・手元の使い捨てへの psql は今までどおり通る。
13
- (w) 読むだけの待ちの繰り返し(gh run list / view・gh pr checks / view + sleep)は人に聞かずに通る。
14
- ★名前・題名に grant / revoke / create table の字が入っていても通る(便 6db73d94 の形)。
13
+ (w) 読むだけの待ちの繰り返し(gh run list / view・gh pr checks / view + sleep)は
14
+ ★**人に聞かない**(確認カードを出さない)。
15
+ ★名前・題名に grant / revoke / create table の字が入っていても人に聞かない(便 6db73d94 の形)。
16
+ ★2026-10-10(便 de82bc3a・けいさん確定)から、この形は【作法 discipline で止める】に変わった。
17
+ 便の禁止「CI や合流を待つ時は繰り返しを使わず、gh pr checks・gh pr view を1回ずつ打つ」が
18
+ 2便続けて破られた(812c68de の合流待ち・3c93bfc1 の CI 待ち)ため、番人で止める形にした。
19
+ ★この節が守る物(=人に聞かない)は1文字も変わらない:判定は gate ではなく deny で、
20
+ 理由は `discipline:`(書式上の理由と直し方つき)である。期待を緩めたのではなく強めた。
15
21
  (m) ★negative test =繰り返し・条件の中に、本番反映・DB の変更・保護の迂回・秘密の読み出し・
16
22
  本番ブランチへの push が1つでも混ざれば、今までどおり止まる/人に聞く。
17
23
  (n) 2026-09-21 の形(node でリポの中の読むだけの照合を呼ぶ)は通る。
@@ -124,10 +130,10 @@ for label, cmd in KEEP:
124
130
  check(label, decide(cmd), policy.ALLOW)
125
131
 
126
132
  # ─────────────────────────────────────────────────────────────────────────────
127
- # (w) 読むだけの待ちの繰り返しは人に聞かない
133
+ # (w) 読むだけの待ちの繰り返しは人に聞かない(★2026-10-10 から作法で止める・便 de82bc3a)
128
134
  # ─────────────────────────────────────────────────────────────────────────────
129
135
  BR = f'fix/{W_GRANT}-anon-select'
130
- WAIT_ALLOW = [
136
+ WAIT_NOT_ASKED = [
131
137
  ('w1 until gh run list | grep', 'until gh run list --branch fix/x --limit 1 --json status | grep -q in_progress; do sleep 15; done'),
132
138
  ('w2 until [ -n "$(gh run list …)" ]',
133
139
  "until [ -n \"$(gh run list --branch fix/x --limit 1 --json databaseId -q '.[0].databaseId')\" ]; do sleep 15; done"),
@@ -143,8 +149,19 @@ WAIT_ALLOW = [
143
149
  ('w10 if で gh pr view', f"if gh pr view 12 --json title -q .title | grep -q {W_GRANT}; then echo y; fi"),
144
150
  ('w11 until ! で gh run view', 'until ! gh run view 123 --json status -q .status | grep -q in_progress; do sleep 15; done'),
145
151
  ]
146
- for label, cmd in WAIT_ALLOW:
147
- check(label, decide(cmd), policy.ALLOW)
152
+ #: このうち「繰り返し + sleep」の形(★便 de82bc3a から作法で止める)。
153
+ # w10 だけは繰り返しではない(if で1回打つ形)ので、今までどおり通る。
154
+ WAIT_LOOPS = frozenset({'w1', 'w2', 'w3', 'w4', 'w5', 'w6', 'w7', 'w8', 'w9', 'w11'})
155
+ for label, cmd in WAIT_NOT_ASKED:
156
+ r = policy.decide_bash(cmd, CWD)
157
+ key = label.split()[0]
158
+ # ★この節が守る物(人に聞かない=確認カードを出さない)は1文字も変えない。
159
+ check(f'{label}(人に聞かない)', r['decision'] != policy.GATE, True)
160
+ if key in WAIT_LOOPS:
161
+ check(f'{label}(★繰り返しの待ちは作法で止まる)', r['decision'], policy.DENY)
162
+ check(f'{label}(理由は作法・直し方つき)', r['reason'].startswith('discipline:'), True)
163
+ else:
164
+ check(label, r['decision'], policy.ALLOW)
148
165
 
149
166
  # ─────────────────────────────────────────────────────────────────────────────
150
167
  # (m) negative test =混ざった繰り返し・条件は今までどおり止まる/人に聞く
@@ -185,10 +202,12 @@ check('★空振り①の戻し: いまの決まりでは止まる', decide(SIX[
185
202
 
186
203
  saved = policy._SHELL_KEYWORDS
187
204
  policy._SHELL_KEYWORDS = frozenset()
188
- check('★空振り②: 予約語を剥がさないと w9 を人に聞いてしまう', decide(WAIT_ALLOW[8][1]), policy.GATE)
205
+ check('★空振り②: 予約語を剥がさないと w9 を人に聞いてしまう', decide(WAIT_NOT_ASKED[8][1]), policy.GATE)
189
206
  check('★空振り②: 予約語を剥がさないと m1 が通ってしまう', decide(MIXED[0][1]), policy.ALLOW)
190
207
  policy._SHELL_KEYWORDS = saved
191
- check('★空振り②の戻し: w9 は通る', decide(WAIT_ALLOW[8][1]), policy.ALLOW)
208
+ # ★戻すと「人に聞く」ではなく「作法で止める」に戻る(便 de82bc3a・止める向きは変えていない)。
209
+ check('★空振り②の戻し: w9 は人に聞かない', decide(WAIT_NOT_ASKED[8][1]) != policy.GATE, True)
210
+ check('★空振り②の戻し: w9 は作法で止まる', decide(WAIT_NOT_ASKED[8][1]), policy.DENY)
192
211
  check('★空振り②の戻し: m1 は止まる', decide(MIXED[0][1]), policy.DENY)
193
212
 
194
213
  saved = policy._subst_payloads
@@ -0,0 +1,361 @@
1
+ #!/usr/bin/env python3
2
+ """① CI・合流の完了を繰り返しで待つ形を止める決まりと、② danger のあとは報告と便の終わりに
3
+ 要る操作だけを通す決まりの検査(便 de82bc3a)。
4
+
5
+ 実行: python3 scripts/hooks/test_wait_loop_and_danger_stop.py
6
+ 1件でも期待と違えば exit 1。
7
+
8
+ 【なぜ要るか(実地)】
9
+ ① 便の禁止「CI や合流を待つ時は繰り返しを使わず、gh pr checks・gh pr view を1回ずつ打つ」が
10
+ 2便続けて破られた(812c68de:合流待ちに until … sleep / 3c93bfc1:CI 待ちに
11
+ until grep -q 'exit=' …; do sleep 20; done)。番人はこの形を1度も止めていなかった。
12
+ ② 便 5d7e75fc(ai-saku・読むだけ)で、番人が danger
13
+ (secret file (.env.local) inside … read without naming it by grep)で止めたあと、
14
+ 職人が「止められたのは再帰の検索という手段だけだ」と自分で判断し、ls と名指しの読み取りに
15
+ 切り替えて作業を続けた。同じ日の便 9a9573b9 は同じ danger で正しく停止しており、
16
+ ★守るかどうかが職人の判断に任されていた。
17
+
18
+ 【ここで固定すること】
19
+ (w) 止める形 … until / while / for の繰り返しの中に sleep が在り、繰り返しの条件か中身で
20
+ CI・合流・配備・公開の状態(またはその記録ファイル)を見に行く形は discipline で止まる。
21
+ (k) 通す形 … 通常の待機は1つも巻き込まない(sleep の無い繰り返し・CI と関係の無い繰り返し・
22
+ 1回だけの sleep・gh run watch・gh pr checks --watch・状態を1回打つ形)。
23
+ (x) ほかの判定は1つも変わらない … 繰り返しの中に危険・関門が混ざれば、今までどおり
24
+ その理由で止まる/人に聞く(作法は decide_bash のいちばん最後なので後ろに回る)。
25
+ (b) 鉄則7 の4段の塊は通ったままである(上限つき・段の結果を出す決められた待ち)。
26
+ (d) danger のあと … 報告の置き場への書き・読み、置き場を作る mkdir -p、完了の知らせだけ通る。
27
+ ほかの命令・読み取り・書き込みは danger のまま止まる(関門も人に聞かずに止まる)。
28
+ (s) 範囲 … ほかの便・ほかの現場・別のセッションには効かない。作法(discipline)で止めた回は
29
+ 印を置かない(danger だけが印を置く)。
30
+ (v) ★空振り確認 … 直した所を外すと、上の期待が実際に崩れる(試験が飾りでないこと)。
31
+
32
+ ★本物のホーム・本物の秘密には1バイトも触れない。偽のホームと偽の状態の置き場を
33
+ 使い捨ての場所に作って判定する(印も TMPDIR をその中へ向ける)。
34
+ """
35
+ import json
36
+ import os
37
+ import shutil
38
+ import sys
39
+ import tempfile
40
+
41
+ sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
42
+
43
+ failures = []
44
+
45
+
46
+ def check(label, got, want):
47
+ ok = got == want
48
+ if not ok:
49
+ failures.append(f'{label}: got={got!r} want={want!r}')
50
+ print(f'{"OK " if ok else "NG "} {label:72} {str(got)[:40]}')
51
+
52
+
53
+ def truthy(label, got):
54
+ check(label, bool(got), True)
55
+
56
+
57
+ # ─────────────────────────────────────────────────────────────────────────────
58
+ # 作り物の置き場(★本物のホーム・本物の秘密には触れない)
59
+ # ─────────────────────────────────────────────────────────────────────────────
60
+ ROOT = tempfile.mkdtemp(prefix='guard-de82bc3a-',
61
+ dir='/tmp/claude-1000' if os.path.isdir('/tmp/claude-1000') else None)
62
+ HOME = os.path.join(ROOT, 'home', 'tester')
63
+ STATE = os.path.join(ROOT, 'state')
64
+ WORK = os.path.join(HOME, 'projects', 'demo')
65
+ LOG = os.path.join(ROOT, 'guard.log')
66
+ SITE = 'demo'
67
+ JOB = 'de82bc3a-84b8-44e1-9db6-11478e7ad6d9'
68
+ OTHER_JOB = '00000000-0000-0000-0000-000000000000'
69
+ SESSION = 'se-de82bc3a'
70
+
71
+
72
+ def mk(path, body=''):
73
+ os.makedirs(os.path.dirname(path), exist_ok=True)
74
+ with open(path, 'w', encoding='utf-8') as f:
75
+ f.write(body)
76
+ return path
77
+
78
+
79
+ os.makedirs(WORK, exist_ok=True)
80
+ os.makedirs(os.path.join(WORK, '.git'), exist_ok=True)
81
+ mk(os.path.join(HOME, '.npmrc'), 'dummy\n') # 偽の秘密(名前と場所だけで判定される)
82
+ os.environ['HOME'] = HOME
83
+ os.environ['TMPDIR'] = ROOT # 印の置き場も作り物の中に向ける
84
+ os.environ['XDG_STATE_HOME'] = STATE
85
+ os.environ['CONDUCTOR_SITE'] = SITE
86
+ os.environ['CONDUCTOR_GUARD_LOG'] = LOG
87
+ os.environ.pop('CONDUCTOR_REPORT_DIR', None)
88
+ os.environ.pop('CONDUCTOR_URL', None)
89
+ os.environ.pop('CONDUCTOR_TOKEN', None)
90
+ mk(os.path.join(STATE, 'conductor', f'active-job-{SITE}.json'),
91
+ json.dumps({'commandId': JOB, 'site': SITE, 'body': 'x'}))
92
+
93
+ import cc2_guard # noqa: E402
94
+ import hook_datalink # noqa: E402
95
+ import policy # noqa: E402
96
+
97
+ REPORT_DIR = os.path.join(STATE, 'conductor', 'reports')
98
+ REPORT = os.path.join(REPORT_DIR, f'{JOB}.md')
99
+ SECRET_CMD = f'cat {os.path.join(HOME, ".npmrc")}'
100
+
101
+
102
+ def decide(cmd, cwd=WORK):
103
+ return policy.decide_bash(cmd, cwd)['decision']
104
+
105
+
106
+ def reason(cmd, cwd=WORK):
107
+ return policy.decide_bash(cmd, cwd)['reason']
108
+
109
+
110
+ # ─────────────────────────────────────────────────────────────────────────────
111
+ # (w) 止める形 … 繰り返し + sleep + CI・合流・配備・公開の状態
112
+ # ─────────────────────────────────────────────────────────────────────────────
113
+ print('── (w) 止める形 ' + '─' * 54)
114
+ STOP = [
115
+ ('w1 until gh run list + sleep',
116
+ "until gh run list --branch fix/x --limit 1 --json status | grep -q in_progress; do sleep 15; done"),
117
+ ('w2 until [ -n "$(gh run list …)" ] + sleep',
118
+ "until [ -n \"$(gh run list --limit 1 --json databaseId -q '.[0].databaseId')\" ]; do sleep 15; done"),
119
+ ('w3 for i in $(seq) で gh run list + sleep',
120
+ 'for i in $(seq 1 40); do gh run list --limit 1; sleep 15; done'),
121
+ ('w4 while true で gh pr checks + sleep',
122
+ 'while true; do gh pr checks 12 && break; sleep 15; done'),
123
+ ('w5 until gh run view + sleep',
124
+ 'until gh run view 123 --json status -q .status | grep -q completed; do sleep 15; done'),
125
+ ('w6 ★実地 812c68de の形(合流の完了を待つ)',
126
+ 'until gh pr view 989 --json state -q .state | grep -q MERGED; do sleep 20; done'),
127
+ ('w7 ★実地 3c93bfc1 の形(CI の記録ファイルを待つ)',
128
+ "until grep -q 'exit=' /tmp/claude-1000/ci-pr301.log 2>/dev/null; do sleep 20; done"),
129
+ ('w8 公開の記録ファイルを待つ',
130
+ 'until grep -q success /tmp/claude-1000/release-main.log; do sleep 20; done'),
131
+ ('w9 while [ -f … の配備の記録 ] + sleep',
132
+ 'while [ ! -f /tmp/claude-1000/deploy.flag ]; do sleep 5; done'),
133
+ ('w10 until gh api で actions の状態 + sleep',
134
+ 'until gh api repos/o/r/actions/runs --jq ".workflow_runs[0].status" | grep -q completed; do sleep 10; done'),
135
+ ('w11 until git ls-remote(合流の確かめ)+ sleep',
136
+ 'until git ls-remote origin main | grep -q abc123; do sleep 10; done'),
137
+ ('w12 until npm view(公開の確かめ)+ sleep',
138
+ 'until npm view @tyhld/conductor version | grep -q 0.12.133; do sleep 20; done'),
139
+ ('w13 until ! gh run view + sleep',
140
+ 'until ! gh run view 123 --json status -q .status | grep -q in_progress; do sleep 15; done'),
141
+ ('w14 入れ子の繰り返しの中',
142
+ 'for i in 1 2; do until gh pr checks 12; do sleep 15; done; done'),
143
+ ('w15 待ちのあとに別の命令をつないでも当たる',
144
+ 'until gh pr checks 301; do sleep 20; done; echo owari'),
145
+ ]
146
+ for label, cmd in STOP:
147
+ check(label, decide(cmd), policy.DENY)
148
+ truthy('w★ 止めた文は作法(discipline)で、理由と直し方が1行で出る',
149
+ reason(STOP[0][1]).startswith('discipline:') and 'gh run watch' in reason(STOP[0][1]))
150
+ truthy('w★ 当たった形が文に出る', '当たった形:' in reason(STOP[6][1]))
151
+ truthy('w★ 文は1行(改行を含まない)', '\n' not in reason(STOP[0][1]))
152
+
153
+ # ─────────────────────────────────────────────────────────────────────────────
154
+ # (k) 通す形 … 通常の待機は1つも巻き込まない
155
+ # ─────────────────────────────────────────────────────────────────────────────
156
+ print('── (k) 通す形(通常の待機) ' + '─' * 44)
157
+ KEEP = [
158
+ ('k1 状態を1回打つ(CI)', 'gh pr checks 301'),
159
+ ('k2 状態を1回打つ(合流)', 'gh pr view 301 --json state,baseRefName,mergeCommit'),
160
+ ('k3 状態を1回打つ(実行)', 'gh run view 37985860734 --json status,conclusion'),
161
+ ('k4 道具自身が1回の命令で待つ', 'gh run watch 37985860734 --exit-status'),
162
+ ('k5 道具自身が1回の命令で待つ(checks)', 'gh pr checks 301 --watch'),
163
+ ('k6 1回だけの sleep(配信の読み置きを待つ)', 'sleep 60'),
164
+ ('k7 sleep のあとに状態を1回打つ', 'sleep 60; gh pr checks 301'),
165
+ ('k8 sleep の無い繰り返し(試験を順に流す)',
166
+ 'for f in scripts/hooks/test_a.py scripts/hooks/test_b.py; do python3 "$f"; done'),
167
+ ('k9 sleep の無い繰り返しで状態を見る', 'for n in 1 2 3; do gh pr view "$n" --json state; done'),
168
+ ('k10 CI と関係の無い待ち(目印のファイル)',
169
+ 'until [ -f /tmp/claude-1000/ready.flag ]; do sleep 2; done'),
170
+ ('k11 CI と関係の無い待ち(試験の記録)',
171
+ 'until grep -q owari /tmp/claude-1000/npm-test.log; do sleep 5; done'),
172
+ ('k12 CI と関係の無い待ち(組み立ての記録)',
173
+ 'until grep -q done /tmp/claude-1000/build-out.log; do sleep 5; done'),
174
+ ('k13 繰り返しで手元の試験を流す(sleep つきでも CI を見ない)',
175
+ 'for f in a b; do python3 run.py "$f"; sleep 1; done'),
176
+ ('k14 ふつうの開発', 'git status --porcelain'),
177
+ ('k15 名指しの検索', 'grep -rn relay src docs'),
178
+ ]
179
+ for label, cmd in KEEP:
180
+ check(label, decide(cmd), policy.ALLOW)
181
+
182
+ # ─────────────────────────────────────────────────────────────────────────────
183
+ # (x) ほかの判定は1つも変わらない(作法はいちばん最後に当たる)
184
+ # ─────────────────────────────────────────────────────────────────────────────
185
+ print('── (x) ほかの判定は先に当たる ' + '─' * 42)
186
+ MIXED = [
187
+ ('x1 繰り返しの中で秘密を読む → 今までどおり danger',
188
+ f'until gh pr checks 1; do {SECRET_CMD}; sleep 5; done', policy.DENY, 'danger:'),
189
+ ('x2 繰り返しの中で保護ブランチへ push → 今までどおり danger',
190
+ 'until gh pr checks 1; do git push origin main; sleep 5; done', policy.DENY, 'danger:'),
191
+ ('x3 繰り返しの中で保護を迂回する合流 → 今までどおり danger',
192
+ 'until gh pr merge 12 --admin --merge; do sleep 15; done', policy.DENY, 'danger:'),
193
+ ('x4 待ちのあとに本番反映 → 今までどおり人に聞く',
194
+ 'until gh run list --limit 1 | grep -q completed; do sleep 15; done; vercel --prod',
195
+ policy.GATE, 'gate('),
196
+ ('x5 繰り返しの中で本番反映 → 今までどおり人に聞く',
197
+ 'until vercel --prod; do sleep 15; done', policy.GATE, 'gate('),
198
+ ]
199
+ for label, cmd, want, prefix in MIXED:
200
+ r = policy.decide_bash(cmd, WORK)
201
+ check(label, r['decision'], want)
202
+ truthy(f'{label} の理由は {prefix}', r['reason'].startswith(prefix))
203
+
204
+ # ─────────────────────────────────────────────────────────────────────────────
205
+ # (b) 鉄則7 の4段の塊は通ったまま(★関数に寄せた呼び出しには当たらない=意図した線)
206
+ # ─────────────────────────────────────────────────────────────────────────────
207
+ print('── (b) 鉄則の塊 ' + '─' * 54)
208
+ BLOCK_LOOP = (
209
+ 'END=$(( $(date +%s) + ${WAIT:-600} ))\n'
210
+ 'while :; do\n'
211
+ ' ST="$(V state .state)"\n'
212
+ ' [ "$ST" = MERGED ] && break\n'
213
+ ' [ "$(date +%s)" -lt "$END" ] || ng verify "まだ MERGED でない"\n'
214
+ ' sleep 15\n'
215
+ 'done\n'
216
+ )
217
+ check('b1 鉄則7 ④ の待ち(関数に寄せた形)は通る', decide(BLOCK_LOOP), policy.ALLOW)
218
+
219
+ # ─────────────────────────────────────────────────────────────────────────────
220
+ # (d) danger のあとは、報告と便の終わりに要る操作だけを通す
221
+ # ─────────────────────────────────────────────────────────────────────────────
222
+ print('── (d) danger のあと ' + '─' * 49)
223
+ KEY = (SESSION, SITE, JOB)
224
+
225
+
226
+ def ev(tool, tin, session=SESSION, cwd=WORK):
227
+ return {'tool_name': tool, 'tool_input': tin, 'cwd': cwd, 'session_id': session}
228
+
229
+
230
+ def run(data):
231
+ out = cc2_guard.guard_output(data)
232
+ if not out:
233
+ return 'defer', ''
234
+ spec = out['hookSpecificOutput']
235
+ return spec['permissionDecision'], spec.get('permissionDecisionReason', '')
236
+
237
+
238
+ hook_datalink.clear_danger_stop(*KEY)
239
+ check('d0 印が無いうちは通る(ふつうの命令)', run(ev('Bash', {'command': 'git status'}))[0], 'allow')
240
+
241
+ dec, why = run(ev('Bash', {'command': SECRET_CMD}))
242
+ check('d1 秘密の読み取りは danger で止まる', dec, 'deny')
243
+ truthy('d1 理由は danger', why.startswith('danger:'))
244
+ truthy('d1 印が置かれた', hook_datalink.danger_stop_active(*KEY))
245
+
246
+ AFTER_DENY = [
247
+ ('d2 同じ目的を別の道具で続ける(実地 5d7e75fc の形)',
248
+ ev('Bash', {'command': f'ls {os.path.join(HOME, "projects", "demo", "src")}'})),
249
+ ('d3 ふつうの読み取り', ev('Read', {'file_path': os.path.join(WORK, 'README.md')})),
250
+ ('d4 ふつうの書き込み', ev('Write', {'file_path': os.path.join(WORK, 'a.ts'), 'content': 'x'})),
251
+ ('d5 名指しの検索', ev('Grep', {'pattern': 'relay', 'path': os.path.join(WORK, 'src')})),
252
+ ('d6 ふつうの命令', ev('Bash', {'command': 'git status --porcelain'})),
253
+ ('d7 報告の置き場の外への mkdir', ev('Bash', {'command': f'mkdir -p {os.path.join(ROOT, "x")}'})),
254
+ ('d8 報告の置き場の外のファイルへの Write',
255
+ ev('Write', {'file_path': os.path.join(ROOT, 'other.md'), 'content': 'x'})),
256
+ ('d9 関門の操作(★人に聞かずに止まる)', ev('Bash', {'command': 'npm publish'})),
257
+ ]
258
+ for label, data in AFTER_DENY:
259
+ dec, why = run(data)
260
+ check(label, dec, 'deny')
261
+ truthy(f'{label} の理由は「danger のあと」', 'danger で止めたあと' in why)
262
+ truthy('d★ 止めた文に印のパスが出る(人が解ける)',
263
+ hook_datalink.danger_stop_marker_path(*KEY) in run(AFTER_DENY[0][1])[1])
264
+ truthy('d★ 止めた文に、その命令そのものの判定も出る',
265
+ 'この命令そのものの判定' in run(AFTER_DENY[0][1])[1])
266
+
267
+ AFTER_ALLOW = [
268
+ ('d10 報告の置き場を作る mkdir -p', ev('Bash', {'command': f'mkdir -p {REPORT_DIR}'})),
269
+ ('d11 報告を書く(Write)', ev('Write', {'file_path': REPORT, 'content': '---\n'})),
270
+ ('d12 報告を直す(Edit)',
271
+ ev('Edit', {'file_path': REPORT, 'old_string': 'a', 'new_string': 'b'})),
272
+ ('d13 報告を読み返す(Read)', ev('Read', {'file_path': REPORT})),
273
+ ('d14 処理済みの控えも置き場の中', ev('Read', {'file_path': os.path.join(REPORT_DIR, 'processed',
274
+ f'{JOB}.md')})),
275
+ ('d15 完了の知らせ', ev('mcp__claude_ai_ai-kana__conductor_complete', {'commandId': JOB})),
276
+ ]
277
+ for label, data in AFTER_ALLOW:
278
+ dec, _ = run(data)
279
+ check(label, dec, 'allow')
280
+
281
+ # ─────────────────────────────────────────────────────────────────────────────
282
+ # (s) 範囲 … ほかの便・ほかの現場・別のセッションには効かない
283
+ # ─────────────────────────────────────────────────────────────────────────────
284
+ print('── (s) 効く範囲 ' + '─' * 54)
285
+ check('s1 別のセッションには効かない',
286
+ run(ev('Bash', {'command': 'git status'}, session='se-other'))[0], 'allow')
287
+ mk(os.path.join(STATE, 'conductor', f'active-job-{SITE}.json'),
288
+ json.dumps({'commandId': OTHER_JOB, 'site': SITE, 'body': 'x'}))
289
+ check('s2 ほかの便には効かない(便IDが変われば印も変わる)',
290
+ run(ev('Bash', {'command': 'git status'}))[0], 'allow')
291
+ mk(os.path.join(STATE, 'conductor', f'active-job-{SITE}.json'),
292
+ json.dumps({'commandId': JOB, 'site': SITE, 'body': 'x'}))
293
+ check('s3 同じ便に戻れば今までどおり止まる',
294
+ run(ev('Bash', {'command': 'git status'}))[0], 'deny')
295
+
296
+ os.environ['CONDUCTOR_SITE'] = 'other-site'
297
+ check('s4 ほかの現場には効かない', run(ev('Bash', {'command': 'git status'}))[0], 'allow')
298
+ os.environ['CONDUCTOR_SITE'] = SITE
299
+
300
+ check('s5 古い印は効かない(時間切れ)',
301
+ hook_datalink.danger_stop_active(*KEY,
302
+ now=os.path.getmtime(
303
+ hook_datalink.danger_stop_marker_path(*KEY))
304
+ + hook_datalink.DANGER_STOP_TTL_SEC + 1), False)
305
+
306
+ hook_datalink.clear_danger_stop(*KEY)
307
+ check('s6 印を消すと(人が解くと)通る', run(ev('Bash', {'command': 'git status'}))[0], 'allow')
308
+
309
+ dec, _ = run(ev('Bash', {'command': 'git add -A'}))
310
+ check('s7 作法(discipline)では止まる', dec, 'deny')
311
+ check('s7 ★作法では印を置かない(danger だけが置く)',
312
+ hook_datalink.danger_stop_active(*KEY), False)
313
+ dec, _ = run(ev('Bash', {'command': 'npm publish'}))
314
+ check('s8 関門(gate)でも印を置かない', hook_datalink.danger_stop_active(*KEY), False)
315
+ check('s8 関門は今までどおり(管制が無いので止まる)', dec, 'deny')
316
+
317
+ # ─────────────────────────────────────────────────────────────────────────────
318
+ # (v) ★空振り確認 … 直した所を外すと期待が崩れる
319
+ # ─────────────────────────────────────────────────────────────────────────────
320
+ print('── (v) 空振り確認 ' + '─' * 52)
321
+ saved = policy._disc_wait_loop
322
+ policy._disc_wait_loop = lambda command: None
323
+ check('v1 ①の判定を外すと w1 が通ってしまう', decide(STOP[0][1]), policy.ALLOW)
324
+ check('v1 ①の判定を外すと w7 が通ってしまう', decide(STOP[6][1]), policy.ALLOW)
325
+ policy._disc_wait_loop = saved
326
+ check('v1 戻すと w1 は止まる', decide(STOP[0][1]), policy.DENY)
327
+ check('v1 戻すと w7 は止まる', decide(STOP[6][1]), policy.DENY)
328
+
329
+ saved_sleep = policy._wait_has_sleep
330
+ policy._wait_has_sleep = lambda segments: True
331
+ check('v2 sleep の有無を見ないと、sleep の無い繰り返し(k9)まで止まる',
332
+ decide(KEEP[8][1]), policy.DENY)
333
+ policy._wait_has_sleep = saved_sleep
334
+ check('v2 戻すと k9 は通る', decide(KEEP[8][1]), policy.ALLOW)
335
+
336
+ hook_datalink.clear_danger_stop(*KEY)
337
+ run(ev('Bash', {'command': SECRET_CMD}))
338
+ truthy('v3 印が置かれた(②の空振りの前提)', hook_datalink.danger_stop_active(*KEY))
339
+ saved_active = hook_datalink.danger_stop_active
340
+ hook_datalink.danger_stop_active = lambda *a, **k: False
341
+ check('v3 ②の判定を外すと、danger のあとに別の道具で続けられてしまう',
342
+ run(AFTER_DENY[0][1])[0], 'allow')
343
+ hook_datalink.danger_stop_active = saved_active
344
+ check('v3 戻すと止まる', run(AFTER_DENY[0][1])[0], 'deny')
345
+
346
+ saved_allowed = cc2_guard.after_danger_allowed
347
+ cc2_guard.after_danger_allowed = lambda data, env=None: False
348
+ check('v4 通す物の一覧を外すと、報告が書けなくなる', run(AFTER_ALLOW[1][1])[0], 'deny')
349
+ cc2_guard.after_danger_allowed = saved_allowed
350
+ check('v4 戻すと報告は書ける', run(AFTER_ALLOW[1][1])[0], 'allow')
351
+
352
+ hook_datalink.clear_danger_stop(*KEY)
353
+ shutil.rmtree(ROOT, ignore_errors=True) # ★作り物は毎回片付ける(使い捨ての置き場に残骸を残さない)
354
+
355
+ print()
356
+ if failures:
357
+ print(f'NG {len(failures)} 件')
358
+ for f in failures:
359
+ print(' ', f)
360
+ sys.exit(1)
361
+ print('すべて期待どおり')
@@ -92,6 +92,9 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
92
92
  fi
93
93
 
94
94
  # ④ 合流後 … MERGED・base が意図どおり・変更が base に入っている(題名では判定しない)。
95
+ # ★この待ちは上限(WAIT・既定600秒)付きで、段の結果を出す【決められた待ち】。
96
+ # 合流の完了を1回で待てる命令は無いのでここだけ待つ。自分で待ちの繰り返しを書き起こさない
97
+ # (CI・合流・配備・公開の完了を繰り返しで待つ形は番人が discipline で止める=便 de82bc3a)。
95
98
  END=$(( $(date +%s) + ${WAIT:-600} ))
96
99
  while :; do
97
100
  ST="$(V state .state)"
@@ -167,7 +170,7 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
167
170
  ② **止められた理由が分からないときは、別の方法(別の命令・別の道具・別の置き場・別の写し)を試さない。**
168
171
  ③ そのときは、**止められた命令の全文と番人の文を報告して止まる**(鉄則4・人の手番)。
169
172
  ④ ★**書き方の決まりだけを指摘されて止められたときは、条件付きで書き直して続けてよい**(けいさん確定 2026-10-09 21:02)。続けてよいのは、次の4つが**すべて**そろうときだけ。
170
- - (ア) 番人が**書式上の理由と直し方を明示している**=番人の文が `discipline` で始まる種類(理由と直す形がその1行に書いてある。この種類は Bash の命令にだけ出る**6つ**=まとめて足す `git add`・まとめて記録に入れる `git commit`・`cd` を他の命令とつなぐ形・全体の再帰検索・**リポジトリの中の部品の置き場の下に使い捨ての写しを作る形**(便 99edd7bf)・**文句の捨て先を変数やコマンド置換の中に入れて文字列の途中へ差し込む形**(便 227aeebb))。
173
+ - (ア) 番人が**書式上の理由と直し方を明示している**=番人の文が `discipline` で始まる種類(理由と直す形がその1行に書いてある。この種類は Bash の命令にだけ出る**7つ**=まとめて足す `git add`・まとめて記録に入れる `git commit`・`cd` を他の命令とつなぐ形・全体の再帰検索・**リポジトリの中の部品の置き場の下に使い捨ての写しを作る形**(便 99edd7bf)・**文句の捨て先を変数やコマンド置換の中に入れて文字列の途中へ差し込む形**(便 227aeebb)・**CI・合流・配備・公開の完了を繰り返しで待つ形**(便 de82bc3a))。
171
174
  - (イ) 書き直しが、元の操作の**目的・対象・権限・副作用を広げない**(やることは同じで、書き方だけを直す)。
172
175
  - (ウ) 書き直しが、**便の禁止事項に触れない**。
173
176
  - (エ) **便に停止の指示が無い**(①が先に掛かる)。
@@ -175,6 +178,7 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
175
178
  ⑤-2 ★**`danger` と出たら書き直さずに止まって報告する。書き直してよいのは `discipline` だけ**(けいさん確定 2026-10-10・便 227aeebb)。
176
179
  - ★**別の道具に替えて同じ目的を果たすのも「書き直し」に当たる。** 探し方を `rg`・`git grep`・`Read` の道具へ替える/読み方を `cat` から別の道具へ替える/置き場や写し方を替える、はすべてこれに当たる。`danger` で止められた後にこれをしてはいけない(実地 便 623cfb85・833c280c・devlog 8975cfd6 がこの形だった)。
177
180
  - ★**この表(常連)と、職人向けの「代わりにこう書く」は、`danger` を書き直す根拠にならない。** 表は「最初から止まらない書き方を選ぶため」の物である(④の(ア)〜(エ)がそろう `discipline` のときだけ書き直せる)。
181
+ - ★**この決まりは、2026-10-10(便 de82bc3a)から番人が機械で守る。** `danger` で1件止まった後は、その便(同じセッション・同じ現場・同じ便ID)の残りの命令・読み取り・書き込みがすべて `danger` で止まり、**報告の置き場の中のファイルを書く・直す・読む/その置き場を作る `mkdir -p`/完了の知らせ(`conductor_complete`)だけ**が通る。=止まった後に別の道具へ替えても進めない。**報告(`outcome: blocked`)を書いて終えるのが正しい終わり方**。ほかの便・ほかの現場・別のセッションには効かない。誤って止まったときは人が自分のターミナルで印のファイルを消す(印のパスは番人の文に出る)。
178
182
  - ★**番人が `danger` の理由に出した場所の名前が、自分が名指しした場所と違っても、番人が間違っているとは判断しない。** 名前を書かずにフォルダを読む検索は、**探す場所を読み切れないと作業場所に倒す**(番人の文に `(探す場所を書いていないので作業場所として判定)`・`(書かれた場所を読み切れないので作業場所として判定)` と出る)。止まったら報告して止まる。
179
183
  ⑥ ★**書き直して続けた場合も、報告に3つを書く。** 止められた命令の全文・番人の文・書き直した命令。
180
184
  ⑦ ★**この決まりは、過去の違反をあとから承認する物ではない**(けいさん確定 2026-10-09 21:02)。番人の判定は1つも変わらない(弱めない)。
@@ -182,6 +186,8 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
182
186
  - **cd を `&&` でつなぐ**(`cd 先 && 何か`・cd とリダイレクトを同じ行に混ぜる)→ 止まる。**cd は作業のはじめに1回だけ単独で**打ち、以後は絶対パスか `git -C <実際のパス>`(鉄則2)。
183
187
  - **リポの根やホームを再帰で検索する**(`grep -rn 語 .`・`rg 語 .`・`grep -rn 語 ~`・`grep -rn 語 /home/…/リポ`)→ 止まる。★**実際に止まっているのはこの形**で、`cat .npmrc` のような直接読みではない(便 f6b9ddb6 の9回はすべて普通の再帰検索が秘密ファイルに当たった形)。**探す場所をフォルダ名で名指しする。**
184
188
  - 通る例: `grep -rn 'relay' src docs` / `rg 'relay' src docs` / 追跡済みだけ見るなら `git grep -n 'relay' -- src docs`
189
+ - ★**名指しの先が「ファイル1つ」なら通る**(`grep -rn 'relay' src/relay.ts`・2026-10-10 の便 3be099ba で直した)。前は再帰の旗が付いているだけで作業場所(リポの根)に倒れ、根の秘密ファイルに当たって止まっていた(実地 便 1ff7b915)。★**秘密の名前のファイルを名指しすれば今までどおり止まる。**
190
+ - ★**探す言葉に当て字の縦棒(`\|`)を入れた形も、名指しの場所で判定される**(`grep -rn "a\|b" services packages`・同じ便で直した)。前は引用符の中で命令が千切れて場所が別の切れ端へ移り、作業場所に倒れて止まっていた(実地 便 3bbde2e3)。★**場所を書かない形**(`grep -rn "a\|b"` だけ)は今までどおり止まる。
185
191
  - ★**記録の外まで読む旗を付けた形は止まる**(`git grep --untracked`・`--no-index`・`--no-exclude-standard`)。実測で、この旗を付けると追跡していない秘密のファイルまで中身が出る(便 227aeebb)。追跡済みだけを見る素の `git grep` は今までどおり通る。
186
192
  - ★**名前を並べて別の道具へ渡す形も止まる**(`find <場所> -type f -exec cat {} +`・`find <場所> | xargs rg`・包みの中に入れた同じ形)。探した場所の中に秘密のファイルが在るときだけ止まる(便 227aeebb)。
187
193
  - ★**除外指定では通らない**(実測 2026-09-27)。`grep -rn 語 . --exclude=.npmrc` は、`.` の再帰でまず止まり、さらに**秘密のファイル名を引数に書いた事自体**でも止まる。「除いて探す」ではなく「場所を名指しする」が正解。
@@ -200,6 +206,12 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
200
206
  - 止まる例: `rm -rf /tmp/claude-1000/作業名`(禁止の一覧)/ `rm -r "$DIR/x"`・`rm -r build/*`(番人)/ `rm -r .git`・`rm -r .claude/hooks`・`rm -r .tyhld`(番人=相対パスでも消せない)
201
207
  - ★**探すだけの道具の「探す言葉」に `rm …` と書いても、もう止まらない**(便 915694ac で直した)。鉄則や台本を調べるときの `grep -rn 'rm -rf .git' skills`・`git grep -n 'rm -r' -- skills`・`rg 'rm -rf /' docs` は通る。★囲みの外に書いた `rm` は今までどおり測るので、`grep -rn 'x' docs; rm -rf .git` のように**後ろで消す形は止まる**。
202
208
  - **まとめて全部を記録に入れる `git add`・`git commit`**(`git add -A`・`git add .`・`git commit -a`・`git commit -am 説明`・`git commit --all`)→ 止まる。着手前から変わっていたファイル(例 `.claude/settings.json`)まで入り、番人がそれを記録から外す操作も止めるので取り返せない(便 4cf71dde)。**ファイルを名指しで `git add <ファイル>` してから `git commit -m 説明`**(鉄則1-④)。
209
+ - **CI・合流・配備・公開の完了を繰り返しで待つ**(`until gh pr checks …; do sleep 20; done`・`while true; do gh run list …; sleep 15; done`・`until grep -q 'exit=' <CI の記録>; do sleep 20; done`)→ 止まる(便 de82bc3a)。実地2便で破られた形(812c68de の合流待ち・3c93bfc1 の CI 待ち)。**CI は `gh run watch <実行ID> --exit-status` を1回打って前面で待ち切り、状態は `gh pr checks`・`gh pr view`・`gh run view` を1回ずつ打つ**(どれも即返る)。合流の完了は鉄則7-★の4段の塊の ④ が上限付きで待ち切る。
210
+ - 通る例: `gh run watch 37985860734 --exit-status` / `gh pr checks 301` / `gh pr view 301 --json state,baseRefName,mergeCommit` / `sleep 60`(1回だけ)/`until [ -f /tmp/claude-1000/ready.flag ]; do sleep 2; done`(CI と関係の無い待ち)
211
+ - ★番人の文は `discipline`(書き方の注意・直し方つき)。止めるのは「繰り返しの中で sleep しながら CI・合流・配備・公開の状態(またはその記録ファイル)を見に行く形」だけで、**sleep の無い繰り返し・CI と関係の無い繰り返し・1回だけの sleep・状態を1回打つ形は1つも巻き込まない**。
212
+ - **`danger` で止められた後に、別の命令・別の道具で作業を続ける**(実地 便 5d7e75fc:再帰の検索が `danger` で止められた後、`ls` と名指しの読み取りに替えて続けた)→ **その便の残りが全部止まる**(便 de82bc3a)。`danger` の後に番人が通すのは、**報告の置き場の中のファイルを書く・直す・読む/その置き場を作る `mkdir -p`/完了の知らせ(`conductor_complete`)だけ**。**止められた命令の全文と番人の文を報告して停止する**(鉄則4・この節の⑤-2)。
213
+ - 通る例(`danger` の後にできること): 報告ファイルを書く / `mkdir -p ~/.local/state/conductor/reports` / `conductor_complete` を1回呼ぶ / `outcome: blocked` で終える
214
+ - ★ほかの便・ほかの現場・別のセッションには効かない(便が変われば解ける)。誤って止まったときは**人が自分のターミナルで印のファイルを消す**(印のパスは番人の文にそのまま出る)。
203
215
  - **行き先のブランチを確かめられない `git push`**(作業場所が変数のままの `git -C "$DIR" push`・`git push` とだけ打つ形・保護ブランチを狙う形)→ 止まる。**リポの中で、ブランチを名指しして** `git push origin <作業ブランチ名>`(★`-u` は付けない=鉄則7-⓪。上流の設定を書くと、囲いが `.git/config` を塞いでいるPCで止まる)。
204
216
  - ★**止まるのは「行き先が分からない形」と「保護ブランチを狙う形」**(実測 便 6e8d85e6)。場所を指す旗を付けても枝を名指しした形(`git -C <場所> push origin <作業ブランチ名>`)は止まらないので、「場所を指す旗が付いているか」で安全を判断しない。
205
217
  - ★**強い上書き(`--force`/`-f`/`--force-with-lease`/先頭が `+` の参照指定)は、旗の位置を問わず止まる。** 旗を末尾や中間に置く形・短い旗をまとめた形(`-fu`)・`git` と `push` の間に場所や設定を指す旗を挟む形・`+` を引用符で囲う形・つないだ行や包みの中に書いた形も、すべて止まる(便 e619bd86 で語の並びを見る判定に替えた。それまでは挟む形と引用符で囲う形が素通りしていた=実地 便 6e8d85e6)。**そもそも強い上書きは打たない**(便の本文の「force-push と reset はしない」)。
@@ -211,7 +223,9 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
211
223
  ⓪ **★報告を書く前に、「反映された」を実物で確かめる**(えふさん確定 2026-10-02 夜・便 7aa63a97)。**報告到着 ≠ 完了/職人終了 ≠ 受入完了。** 職人への指示は反映(合流・公開・本番反映)まで終わらせる。次の3つを、**自分の言葉ではなく実物の出力で**確かめてから①へ進む。
212
224
  - **(a) 合流したか** … 鉄則7-★の確かめ方(`gh pr view <番号> --json state,baseRefName,mergeCommit` が `MERGED` + `git merge-base --is-ancestor <合流コミット> origin/<合流先>`)。★**合流を予約しただけ(`--auto`)は「終わり」ではない。** 予約は GitHub が後から合流するので、**予約したまま手番を閉じると便が死ぬ**(実地 47bdfe00)。鉄則7-★の4段の塊を使えば ④ が最後まで待つ。
213
225
  - **(b) 公開版/本番が新しくなったか** … 配布物を変えた便なら `npm view <パッケージ> version` が上げた版になっていること。画面を変えた便なら配備先の版。★**変えていない便は「変えていない」と確かめる**(確かめを省くのではない)。
214
- - **(c) 背景に回した待ちが残っていないか** … ★**待ちを背景に残したまま手番を閉じない。** 画面なし方式(`claude -p`)では**手番の終わり=処理の終わり**で、背景の待ちはその瞬間に殺され、職人は二度と起きない(実地 915694ac:「まだ実行中です。終わり次第、結果を確かめます。」で手番を閉じ、報告は下書きのまま便が死んだ)。待つなら `Monitor` か `until <条件>; do sleep 2; done` で、**この手番の中で待ち切る**。
226
+ - **(c) 背景に回した待ちが残っていないか** … ★**待ちを背景に残したまま手番を閉じない。** 画面なし方式(`claude -p`)では**手番の終わり=処理の終わり**で、背景の待ちはその瞬間に殺され、職人は二度と起きない(実地 915694ac:「まだ実行中です。終わり次第、結果を確かめます。」で手番を閉じ、報告は下書きのまま便が死んだ)。**この手番の中で待ち切る。**
227
+ - ★**CI・合流・配備・公開の完了は、繰り返し(`until`・`while`・`for` + `sleep`)で待たない**(けいさん確定 2026-10-10・便 de82bc3a。番人が `discipline` で止める)。CI は `gh run watch <実行ID> --exit-status` を**1回**打って前面で待ち切る。状態を見るだけなら `gh pr checks <番号>`・`gh pr view <番号> --json state`・`gh run view <実行ID>` を**1回ずつ**(どれも即返る)。合流の完了は**鉄則7-★の4段の塊**の ④ が上限(`WAIT`・既定600秒)付きで待ち切るので、自分で待ちの繰り返しを書き起こさない。
228
+ - ★**それ以外の待ち**(目印のファイルが出るのを待つ・配信の読み置き60秒を待つ・背景に回した命令の完了を待つ)は今までどおり。`Monitor` を使うか、1回だけの `sleep`、または CI と関係の無い条件の待ちで、この手番の中で待ち切る。
215
229
  - ★(a)(b)(c) のどれかが終わらせられないときは、**終わったふりをしない**。報告の `outcome` を `blocked` にして、どこまで進んだか・何が残っているか・なぜ進められないかを書いて終える(それが正しい終わり方)。
216
230
  - ★ここを飛ばすと、**便の終わりの関門**(Stop フックの `finish_gate.py`)が実物を見て手番を閉じさせない(PR が開いたまま・報告が下書きのまま・背景の待ちが残っている のどれかなら差し戻す)。同じ理由で止まるのは回数の上限つきなので、**止められたら回避せず、残りを終わらせる**。
217
231
  ① **報告をファイルに書く。** 置き場は配達役の1行が指すファイル**だけ**(正本は `~/.local/state/conductor/reports/<指示ID>.md`)。★便の本文に別の置き場(`/tmp` など)が書かれていても、**配達役の1行の置き場を正とする**(置き場は1か所)。フォルダが無ければ作る。長さの制限は無い。画面に出す必要は無い。中身は変更ファイル・要点・チェック結果を簡潔に。