@tyhld/conductor 0.12.132 → 0.12.133

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tyhld/conductor",
3
- "version": "0.12.132",
3
+ "version": "0.12.133",
4
4
  "description": "采配くん管制の見守りアプリ(conductor-agent)。各PCで常駐し、中央(devlog-tracker)へ定期的に生存報告(heartbeat)を送る常駐CLI。",
5
5
  "type": "module",
6
6
  "bin": {
@@ -408,12 +408,119 @@ DENY** です。読み込み先は公式の説明と道具の実体で確かめ
408
408
  - **番人が古い機体では効きません。** 各PCで人が1回 `APPLY=1 bash scripts/update-guard.sh` を
409
409
  流すまで、その機では今までどおりです。
410
410
 
411
+ ## 1-8. ★CI・合流の完了を「繰り返し」で待つ形を止める(便 de82bc3a・けいさん確定 2026-10-10)
412
+
413
+ ### なぜ要るか(実地2便・どちらも devlog で未承認)
414
+
415
+ | 便 | 実地で打たれた形 | 何を待っていたか |
416
+ | --- | --- | --- |
417
+ | 812c68de | `until … ; do sleep …; done` | **合流**の完了 |
418
+ | 3c93bfc1 | `until grep -q 'exit=' <CI の記録>; do sleep 20; done` | **CI** の完了 |
419
+
420
+ 便の禁止「CI や合流を待つ時は繰り返しを使わず、`gh pr checks`・`gh pr view` を1回ずつ打つ」が
421
+ 2便続けて破られたのに、番人はこの形を**1度も止めていませんでした**(=職人の自制だけに任せていた)。
422
+
423
+ ### 止める/通す(判定の正本は `policy.py` の `_disc_wait_loop`)
424
+
425
+ | 形 | 判定 | 理由 |
426
+ | --- | --- | --- |
427
+ | `until gh pr checks 301; do sleep 20; done` | **discipline** | 繰り返し + sleep + 合流・CI の状態 |
428
+ | `while true; do gh run list --limit 1; sleep 15; done` | **discipline** | 同 |
429
+ | `for i in $(seq 1 40); do gh run list --limit 1; sleep 15; done` | **discipline** | 同(`for` も見る) |
430
+ | `until grep -q 'exit=' /tmp/claude-1000/ci-pr301.log; do sleep 20; done` | **discipline** | 記録ファイルの名前が CI の記録と読める |
431
+ | `until grep -q success /tmp/claude-1000/release-main.log; do sleep 20; done` | **discipline** | 同(公開の記録) |
432
+ | `until git ls-remote origin main \| grep -q <SHA>; do sleep 10; done` | **discipline** | 合流の確かめ |
433
+ | `until npm view <部品> version \| grep -q <版>; do sleep 20; done` | **discipline** | 公開の確かめ |
434
+ | `gh run watch <実行ID> --exit-status` | **通す** | 道具自身が1回の命令で待つ(★推奨の形) |
435
+ | `gh pr checks 301 --watch` | **通す** | 同(★推奨案として通す・要判断に載せた) |
436
+ | `gh pr checks 301` / `gh pr view 301 --json state` / `gh run view <実行ID>` | **通す** | 状態を1回打つ(即返る) |
437
+ | `sleep 60` | **通す** | 1回だけの sleep(配信の読み置きを待つ) |
438
+ | `until [ -f /tmp/claude-1000/ready.flag ]; do sleep 2; done` | **通す** | CI と関係の無い待ち |
439
+ | `until grep -q owari /tmp/claude-1000/npm-test.log; do sleep 5; done` | **通す** | 手元の試験の記録(CI ではない) |
440
+ | `for f in test_*.py; do python3 "$f"; done` | **通す** | sleep が無い |
441
+ | `for n in 1 2 3; do gh pr view "$n" --json state; done` | **通す** | sleep が無い |
442
+
443
+ **当たる条件は3つとも揃ったときだけ**です。① `until`/`while`/`for` の繰り返しである
444
+ ② その中で `sleep` を呼んでいる ③ 繰り返しの**条件か中身**で、CI・合流・配備・公開の状態
445
+ (`gh pr`/`gh run`/`gh workflow`/`gh release`/`gh api`、`git ls-remote`/`merge-base`/`fetch`、
446
+ `npm view`/`info`/`dist-tag`、配備の道具)か、**その記録だと読める名前のファイル**
447
+ (名前を `-_.` で割った1つが `ci`/`pr`/`merge`/`deploy`/`release`/`publish`/`workflow`/`actions`
448
+ と丸ごと一致する)を見に行っている。
449
+
450
+ ### ほかの判定は1件も変わりません
451
+
452
+ 作法(`discipline`)は `decide_bash` の**いちばん最後**に当たるので、繰り返しの中に危険・関門が
453
+ 混ざっていれば今までどおりその理由が先に出ます(`until psql -h <本番> …; do sleep 5; done` は
454
+ `danger`、`until <配備の道具> --prod; do sleep 15; done` は人に聞く)。
455
+
456
+ ### 分かっている限界
457
+
458
+ - **呼び出しを関数に寄せた形には当たりません。** 鉄則7-★の4段の塊の ④ は
459
+ `while :; do ST="$(V state .state)"; …; sleep 15; done` の形で、繰り返しの中に道具の名前が
460
+ 字面で出ません。★この塊は**上限(`WAIT`・既定600秒)付きで段の結果を出す決められた待ち**で、
461
+ 合流の完了を1回で待てる命令が無いため、**通したままにしています**(意図した線)。
462
+ - **見る先が変数で決まる形には当たりません**(`until grep -q x "$LOG"; do sleep 5; done`)。
463
+ - `for` の繰り返しで CI の記録を読みながら `sleep` を入れた形(待ちではなく繰り返し処理)も
464
+ 止まります。`sleep` を外せば通ります(止める向きなので、そのままにしています)。
465
+
466
+ ## 1-9. ★`danger` で止めた後は、報告と便の終わりに要る操作だけを通す(便 de82bc3a)
467
+
468
+ ### なぜ要るか(実地 便 5d7e75fc・ai-saku・読むだけ)
469
+
470
+ 番人が `danger: secret file (.env.local) inside … read without naming it by grep` で止めた後、
471
+ 職人が「止められたのは**再帰の検索という手段**だけだ」と自分で判断し、`ls` と名指しの読み取りに
472
+ 切り替えて作業を続けました。便の定め・鉄則⑤-2 の「`danger` のときは、書き直さず、別の方法・
473
+ 別の道具も試さず、報告して停止する」に反します。**同じ日の便 9a9573b9 は同じ `danger` で正しく
474
+ 停止**しており、守るかどうかが職人の判断に任されていました(根治=番人が機械で止める)。
475
+
476
+ ### どう止めるか(正本は `cc2_guard.py` の `guard_output`)
477
+
478
+ その便(**セッション・現場・便ID の3つ**)で `danger` の `deny` を1回出したら印を置き、以後は
479
+ 下の一覧だけを通します。ほかの命令・読み取り・書き込みは `danger:` のまま止めます(止め方は
480
+ `danger` のまま)。**関門(`gate`)の操作も、人に聞かずに止めます**(止めた後に本番操作の
481
+ カードを出さない)。
482
+
483
+ | # | `danger` の後でも通す物 | 何のため |
484
+ | --- | --- | --- |
485
+ | ① | 報告の置き場の中のファイルへの `Write`/`Edit`/`MultiEdit`/`NotebookEdit` | 報告を書く・直す |
486
+ | ② | 報告の置き場の中のファイルの `Read`/`NotebookRead` | `Edit` は先に読む必要がある |
487
+ | ③ | `mkdir -p <報告の置き場の中>` の1コマンドだけ(Bash) | 置き場のフォルダを作る |
488
+ | ④ | 道具の名前が `conductor_complete` で終わる物 | 完了の知らせ |
489
+
490
+ ★報告の置き場の決め方は **`finish_gate.report_dirs` が正本**です(字面を2か所に置きません)。
491
+ ★`build_output`(判定だけ)は1文字も変えていません。足したのは `guard_output` の1層だけで、
492
+ 印が読めない機体では今までどおり動きます(フェイルセーフ)。
493
+
494
+ ### 効く範囲と、人が解く方法
495
+
496
+ - **ほかの便・ほかの現場・別のセッションには効きません**(印の名前が3つで決まるので、便が
497
+ 変われば自然に解けます)。印は一時領域(`$TMPDIR`/`/tmp`)に置き、**12時間で古くなります**
498
+ (`hook_datalink.DANGER_STOP_TTL_SEC`)。設定ファイルには1バイトも触りません。
499
+ - **印を置くのは `danger` だけ**です。作法(`discipline`)・関門(`gate`)で止めた回は置きません
500
+ (書き方を直して続けてよい種類なので)。
501
+ - **誤って止まったときは、人が自分のターミナルで印のファイルを消します**
502
+ (`rm -r <印のパス>`。番人は人の端末には掛かりません)。★印のパスは**止めたときの番人の文に
503
+ そのまま出します**ので、職人の報告を読めばそのまま打てます。
504
+
505
+ ### 分かっている限界
506
+
507
+ - **PR を開いたまま `danger` で止まると、便の終わりの関門が「PR が開いたまま」で差し戻します。**
508
+ 職人は合流の操作を打てないので、関門は上限(同じ理由3回・合計6回)まで止めた後、
509
+ 「途中で終わった」の控えを残して手番を終わらせます。★**これは正しい姿**です(その便は実際に
510
+ 途中で終わっています)。
511
+ - 印は「`danger` が1件出た」ことだけを見ます。**その `danger` が正しかったかどうかは見ません**
512
+ (止めすぎの直しは、これまでどおり番人の判定の側で直します)。
513
+ - ★**試験で本物のフック(`cc2_guard.py`)を動かすときは、`TMPDIR` を使い捨ての場所へ向けます。**
514
+ 向けないと、試験が打った `danger` の印が**いま走っている本物の便**に付きます(実測:
515
+ `test/guard-for-codex.test.ts` が2回目の `npm test` で落ちた)。印の名前は現場と便IDで決まるので、
516
+ `CONDUCTOR_SITE` も使い捨ての名前にします。
517
+
411
518
  ## 2. ファイルの役割
412
519
 
413
520
  | ファイル | 役割 |
414
521
  | --- | --- |
415
522
  | `policy.py` | 判定そのもの(純粋関数だけ・標準ライブラリのみ)。**製品固有の名前を持たない=切り出し可能** |
416
- | `cc2_guard.py` | PreToolUse フックの入口。標準入力を読み、policy に聞き、決まった形で答えるだけ |
523
+ | `cc2_guard.py` | PreToolUse フックの入口。標準入力を読み、policy に聞き、決まった形で答える。★`danger` で止めた後は、報告と便の終わりに要る操作だけを通す(1-9・`guard_output`) |
417
524
  | `permission_request_hook.py` | PermissionRequest フック。管制へ確認を送り、人の答えを待って返す |
418
525
  | `stop_hook.py` | Stop フック。職人が人へ**問いかけて**止まったとき、管制へ知らせる(ADR-008) |
419
526
  | `hook_datalink.py` | フックと管制のやり取り(HTTP)。**製品固有の前提を持たない=切り出し可能** |
@@ -69,6 +69,7 @@ import sys
69
69
 
70
70
  sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
71
71
 
72
+ import finish_gate # noqa: E402 … 報告の置き場の正本(report_dirs)だけを借りる
72
73
  import hook_datalink # noqa: E402 … 起動記録 と 管制への問い合わせに使う
73
74
  import permission_request_hook # noqa: E402 … 関門の2択カード(ask_gate)
74
75
  import policy # noqa: E402
@@ -282,6 +283,182 @@ def build_output(data, datalink=hook_datalink, codex=False):
282
283
  return out
283
284
 
284
285
 
286
+ # ═════════════════════════════════════════════════════════════════════════════
287
+ # danger で止めたあとは、報告と便の終わりに要る操作だけを通す(便 de82bc3a)
288
+ #
289
+ # 【なぜ要るか(実地 便 5d7e75fc・ai-saku・読むだけ)】番人が
290
+ # danger: secret file (.env.local) inside … read without naming it by grep
291
+ # で止めたあと、職人が「止められたのは再帰の検索という手段だけだ」と自分で判断し、
292
+ # `ls` と名指しの読み取りに切り替えて作業を続けた。便の定め・鉄則⑤-2 の
293
+ # 「danger のときは、書き直さず、別の方法・別の道具も試さず、報告して停止する」に反する。
294
+ # 同じ日の便 9a9573b9 は同じ danger で正しく止まっており、★守るかどうかが職人の判断に
295
+ # 任されていた。番人が機械で止めれば、判断に任せない(根治=鉄則10)。
296
+ #
297
+ # 【どう止めるか】その便(セッション・現場・便ID の3つ)で danger の deny を1回出したら印を置き、
298
+ # 以後は「報告を書く・報告の置き場へ書く・便を終える」に要る操作だけを通す。
299
+ # ほかの命令・読み取り・書き込みは `danger:` のまま止める(止め方は danger のまま)。
300
+ #
301
+ # 【通す物の一覧(これだけ)】
302
+ # ① 報告の置き場の中のファイルへの Write / Edit / MultiEdit(=報告を書く・直す)
303
+ # ② 報告の置き場の中のファイルの Read(Edit は先に読む必要があるため)
304
+ # ③ 報告の置き場のフォルダを作る Bash(`mkdir -p <報告の置き場…>` の1コマンドだけ)
305
+ # ④ 完了の知らせ(道具の名前が `conductor_complete` で終わる物)
306
+ # ★報告の置き場の決め方は finish_gate.report_dirs が正本(字面を2か所に置かない)。
307
+ #
308
+ # 【効かない範囲】ほかの便・ほかの現場・別のセッションには効かない(印の名前が変わる)。
309
+ # 印は一時領域に置き、12時間で古くなる(hook_datalink.DANGER_STOP_TTL_SEC)。
310
+ # 【人が解く方法】人が自分のターミナルで印のファイルを消す(パスは止めたときの文に出る)。
311
+ # ═════════════════════════════════════════════════════════════════════════════
312
+
313
+ #: 報告を書く・直す道具。
314
+ _REPORT_WRITE_TOOLS = frozenset({'Write', 'Edit', 'MultiEdit', 'NotebookEdit'})
315
+ #: 報告を読み返す道具(Edit の前提)。
316
+ _REPORT_READ_TOOLS = frozenset({'Read', 'NotebookRead'})
317
+ #: 報告の置き場を作る形で許す道具(これ以外の Bash は通さない)。
318
+ _REPORT_MKDIR = 'mkdir'
319
+ _REPORT_MKDIR_FLAGS = frozenset({'-p', '--parents', '-pv', '-v', '--verbose'})
320
+
321
+
322
+ def _report_store_dirs(env=None):
323
+ """報告の置き場(★正本は finish_gate.report_dirs・ここでは絶対パスに直すだけ)。"""
324
+ try:
325
+ dirs = finish_gate.report_dirs(os.environ if env is None else env)
326
+ except Exception: # noqa: BLE001
327
+ return []
328
+ out = []
329
+ for d in dirs:
330
+ try:
331
+ out.append(os.path.realpath(os.path.abspath(os.path.expanduser(str(d)))))
332
+ except Exception: # noqa: BLE001
333
+ continue
334
+ return out
335
+
336
+
337
+ def inside_report_store(path, env=None):
338
+ """その道のりが報告の置き場の【中】なら True(置き場そのものも中に数える)。"""
339
+ if not path or not isinstance(path, str) or not path.strip():
340
+ return False
341
+ try:
342
+ p = os.path.realpath(os.path.abspath(os.path.expanduser(path.strip())))
343
+ except Exception: # noqa: BLE001
344
+ return False
345
+ for d in _report_store_dirs(env):
346
+ if p == d or p.startswith(d + os.sep):
347
+ return True
348
+ return False
349
+
350
+
351
+ def _is_report_mkdir(command, env=None):
352
+ """`mkdir -p <報告の置き場の中>` の1コマンドだけなら True。"""
353
+ try:
354
+ segments = policy.split_commands(command, bodies=False)
355
+ except Exception: # noqa: BLE001
356
+ return False
357
+ if len(segments) != 1:
358
+ return False
359
+ toks = policy.tokens_of(segments[0])
360
+ if not toks or os.path.basename(toks[0]) != _REPORT_MKDIR:
361
+ return False
362
+ targets = []
363
+ for t in toks[1:]:
364
+ if t.startswith('-'):
365
+ if t not in _REPORT_MKDIR_FLAGS:
366
+ return False
367
+ continue
368
+ targets.append(t)
369
+ return bool(targets) and all(inside_report_store(t, env) for t in targets)
370
+
371
+
372
+ def after_danger_allowed(data, env=None):
373
+ """danger で止めたあとでも通す操作(報告と便の終わりに要る物)なら True。"""
374
+ if not isinstance(data, dict):
375
+ return False
376
+ tool = str(data.get('tool_name') or '')
377
+ tin = data.get('tool_input')
378
+ if not isinstance(tin, dict):
379
+ tin = {}
380
+ if tool.rsplit('__', 1)[-1] == 'conductor_complete':
381
+ return True
382
+ if tool in _REPORT_WRITE_TOOLS or tool in _REPORT_READ_TOOLS:
383
+ return inside_report_store(tin.get('file_path') or tin.get('notebook_path') or '', env)
384
+ if tool == 'Bash':
385
+ return _is_report_mkdir(str(tin.get('command') or ''), env)
386
+ return False
387
+
388
+
389
+ def danger_stop_key(data, env=None):
390
+ """印の名前を決める3つ(セッション・現場・便ID)。"""
391
+ site = site_of(data if isinstance(data, dict) else {}, env)
392
+ session = ''
393
+ if isinstance(data, dict):
394
+ session = str(data.get('session_id') or '')
395
+ return session, site, job_id_of(site, env)
396
+
397
+
398
+ def danger_stop_reason(key, base, env=None):
399
+ """止めたときに職人へ返す1行(★印のパスも出す=人が解けるように)。"""
400
+ try:
401
+ marker = hook_datalink.danger_stop_marker_path(*key, env=os.environ if env is None else env)
402
+ except Exception: # noqa: BLE001
403
+ marker = '(印のパスを読めません)'
404
+ base_reason = ''
405
+ if isinstance(base, dict) and base.get('reason'):
406
+ base_reason = f"(この命令そのものの判定: {base['reason']})"
407
+ return (
408
+ 'danger: この便は番人が danger で止めたあとです。書き直さず・別の方法も別の道具も試さず、'
409
+ '止められた命令の全文と番人の文を報告して停止してください(鉄則4・鉄則の常連 ⑤-2)。'
410
+ 'いま通すのは、報告の置き場の中のファイルを書く・直す・読む/その置き場を作る mkdir -p/'
411
+ '完了の知らせ(conductor_complete)だけです。'
412
+ f'★誤って止まったときは、人が自分のターミナルで印を消します: rm -r {marker}'
413
+ f'{base_reason}'
414
+ )
415
+
416
+
417
+ def is_danger_reason(reason):
418
+ """番人の理由が「危険(danger)」の種類かどうか(作法 discipline・関門 gate は入らない)。"""
419
+ return str(reason or '').startswith('danger:')
420
+
421
+
422
+ def guard_output(data, datalink=hook_datalink, codex=False, env=None):
423
+ """入口の答え(build_output)に、便の状態の決まり(danger のあとは止める)を重ねる。
424
+
425
+ ★build_output(判定だけ)は1文字も変えない=今までの判定は1件も変わらない。
426
+ ここで足すのは「同じ便の中で danger を出したあとかどうか」の1つだけ。
427
+ """
428
+ key = danger_stop_key(data if isinstance(data, dict) else {}, env)
429
+ try:
430
+ latched = datalink.danger_stop_active(*key)
431
+ except Exception: # noqa: BLE001
432
+ latched = False # 印が読めない機体では今までどおり(番人を止めない)
433
+ if latched and not after_danger_allowed(data, env):
434
+ try:
435
+ base = policy.decide_event(data) # ★純粋な判定(人には聞かない)
436
+ except Exception: # noqa: BLE001
437
+ base = None
438
+ try:
439
+ datalink.record_decision(data.get('tool_name') if isinstance(data, dict) else None,
440
+ 'deny')
441
+ except Exception: # noqa: BLE001
442
+ pass
443
+ try:
444
+ datalink.mark_danger_stop(*key) # 便が続く間は印を新しく保つ
445
+ except Exception: # noqa: BLE001
446
+ pass
447
+ out = _deny_output(danger_stop_reason(key, base, env))
448
+ record_block(data, out['hookSpecificOutput']['permissionDecisionReason'], datalink)
449
+ return out
450
+
451
+ out = build_output(data, datalink=datalink, codex=codex)
452
+ if out and isinstance(out.get('hookSpecificOutput'), dict) \
453
+ and out['hookSpecificOutput'].get('permissionDecision') == 'deny' \
454
+ and is_danger_reason(out['hookSpecificOutput'].get('permissionDecisionReason')):
455
+ try:
456
+ datalink.mark_danger_stop(*key)
457
+ except Exception: # noqa: BLE001
458
+ pass
459
+ return out
460
+
461
+
285
462
  def main() -> int:
286
463
  # ★--codex … Codex から呼ばれた印(登録先 ~/.codex/hooks.json に付けてある)。
287
464
  # 知らない引数は無視する(増えても番人は落とさない)。
@@ -296,7 +473,7 @@ def main() -> int:
296
473
  # ふつうの操作は一瞬で終わるので、ここに達するのは関門で待っているときだけ。
297
474
  _arm_hard_limit()
298
475
  try:
299
- out = build_output(data, codex=codex)
476
+ out = guard_output(data, codex=codex)
300
477
  except Exception: # noqa: BLE001
301
478
  out = None
302
479
  if not codex and _is_gate(data):
@@ -409,6 +409,67 @@ def handoff_active(session_id='', env=None, now=None):
409
409
  return 0 <= age < HANDOFF_TTL_SEC
410
410
 
411
411
 
412
+ # ─── 「この便は danger で止めたあと」の印(便 de82bc3a) ──────────────────────
413
+ # 【なぜ要るか(実地 便 5d7e75fc)】番人が `danger` で止めたあと、職人が「止められたのは
414
+ # 手段だけだ」と自分で判断し、別の読み方へ切り替えて作業を続けた。同じ日の便 9a9573b9 は
415
+ # 同じ `danger` で正しく止まっており、守るかどうかが職人の判断に任されていた。
416
+ # 【印の決め方】セッション・現場・便ID の3つで1つの印にする=ほかの便・ほかの現場・
417
+ # 別のセッションには効かない(便が変われば印の名前も変わるので、自然に消える)。
418
+ # 【印の置き場】プロセス間の合図なので一時領域に置く(設定ファイルには一切触れない)。
419
+ # 【人が解く方法】人が自分のターミナルで印のファイルを消す(番人は人の端末に掛からない)。
420
+ # 印のパスは、止めたときの番人の文にそのまま出す。
421
+ DANGER_STOP_TTL_SEC = 12 * 60 * 60
422
+
423
+
424
+ def _marker_key(*parts):
425
+ """印の名前に使える形へ(英数と - _ だけ・各64字まで)。"""
426
+ out = []
427
+ for p in parts:
428
+ safe = ''.join(c for c in str(p or '') if c.isalnum() or c in '-_')[:64]
429
+ if safe:
430
+ out.append(safe)
431
+ return '-'.join(out) or 'default'
432
+
433
+
434
+ def danger_stop_marker_path(session_id='', site='', job='', env=None):
435
+ """『この便は danger で止めたあと』の印の置き場(一時領域)。"""
436
+ env = os.environ if env is None else env
437
+ base = (env.get('TMPDIR') or '/tmp').rstrip('/')
438
+ return os.path.join(base, f'.tyhld-hook-danger-stop-{_marker_key(session_id, site, job)}')
439
+
440
+
441
+ def mark_danger_stop(session_id='', site='', job='', env=None):
442
+ """印を置く/新しくする。失敗しても黙って進む(フックは止めない)。"""
443
+ path = danger_stop_marker_path(session_id, site, job, env)
444
+ try:
445
+ with open(path, 'w', encoding='utf-8') as f:
446
+ f.write(str(int(time.time())))
447
+ except Exception: # noqa: BLE001
448
+ return None
449
+ return path
450
+
451
+
452
+ def clear_danger_stop(session_id='', site='', job='', env=None):
453
+ """印を消す(人が解くとき・試験の後片付け)。"""
454
+ try:
455
+ os.unlink(danger_stop_marker_path(session_id, site, job, env))
456
+ except Exception: # noqa: BLE001
457
+ pass
458
+
459
+
460
+ def danger_stop_active(session_id='', site='', job='', env=None, now=None):
461
+ """印が新しければ True(=この便はもう danger で止めてある)。
462
+
463
+ ★古い印は無効にする。フックが強制終了して印が残っても、次の便が永久に止まらない。
464
+ """
465
+ path = danger_stop_marker_path(session_id, site, job, env)
466
+ try:
467
+ age = (time.time() if now is None else now) - os.path.getmtime(path)
468
+ except Exception: # noqa: BLE001
469
+ return False
470
+ return 0 <= age < DANGER_STOP_TTL_SEC
471
+
472
+
412
473
  def _request(cfg, method, path, body=None, timeout=HTTP_TIMEOUT_SEC):
413
474
  """管制へ1回だけ問い合わせる。失敗は None(例外を投げない=フックを止めない)。
414
475
 
@@ -4887,6 +4887,11 @@ _DISC_WORKCOPY = ('リポジトリの中の部品の置き場(node_modules な
4887
4887
  '(記録される場所の中に出来る・片付けも番人に止められる)。'
4888
4888
  '使い捨ての置き場は /tmp/claude-1000/ の下にする(鉄則13)。'
4889
4889
  '例: git clone --no-hardlinks <リポの実在のパス> /tmp/claude-1000/karaburi-<便IDの頭8文字>')
4890
+ _DISC_WAIT_LOOP = (
4891
+ 'CI・合流・配備・公開の完了を、繰り返し(until・while・for + sleep)で待たない。'
4892
+ 'CI は gh run watch --exit-status を1回打って前面で待ち切る。'
4893
+ '状態を見るだけなら gh pr checks・gh pr view・gh run view を1回ずつ打つ(どれも即返る)。'
4894
+ '背景で走らせたときは、その命令の完了の知らせをこの手番の中で待つ(鉄則の「便の終え方」⓪(c))')
4890
4895
 
4891
4896
 
4892
4897
  def _discipline_tokens(command: str):
@@ -5290,12 +5295,161 @@ def _workcopy_scan(command: str, cwd=None, depth: int = 0):
5290
5295
  return None
5291
5296
 
5292
5297
 
5298
+ # ═════════════════════════════════════════════════════════════════════════════
5299
+ # 待ちの繰り返し(作法・便 de82bc3a・けいさん確定 2026-10-10)
5300
+ #
5301
+ # 【なぜ要るか(実地2便・どちらも devlog の規則の例外として未承認)】
5302
+ # ・812c68de … 合流の完了待ちに `until … ; do sleep …; done` を使った。
5303
+ # ・3c93bfc1 … CI の完了待ちに `until grep -q 'exit=' <CI の記録>; do sleep 20; done` を使った。
5304
+ # 便の禁止「CI や合流を待つ時は繰り返しを使わず、gh pr checks・gh pr view を1回ずつ打つ」が
5305
+ # 2便続けて破られたのに、番人はこの形を1度も止めていなかった(=職人の自制だけに任せていた)。
5306
+ #
5307
+ # 【止める形】until / while / for の繰り返しの中に sleep が在り、かつ その繰り返しの
5308
+ # 【条件か中身】で CI・合流・配備・公開の状態(またはその記録ファイル)を見に行く形。
5309
+ # ・道具で直に見る形 … gh pr / gh run / gh workflow / gh release / gh api、
5310
+ # git ls-remote / merge-base / fetch、npm view / info / dist-tag、配備の道具
5311
+ # ・記録ファイルで見る形 … 読むだけの道具(grep・cat・tail・jq・[ など)の引数に、
5312
+ # CI・合流・配備・公開の記録だと読める名前(ci / pr / merge / deploy / release /
5313
+ # publish / workflow / actions)が入っている形
5314
+ #
5315
+ # 【止めない形(通常の待機は1つも巻き込まない)】
5316
+ # ・sleep の無い繰り返し(`for f in test_*.py; do python3 "$f"; done`)
5317
+ # ・CI と関係の無い繰り返し(`until [ -f /tmp/claude-1000/ready.flag ]; do sleep 2; done`)
5318
+ # ・1回だけの sleep(`sleep 60`=配信の読み置きを待つ)
5319
+ # ・道具自身が1回の命令で待つ形(`gh run watch --exit-status`・`gh pr checks --watch`)
5320
+ # ・状態を1回打つ形(`gh pr checks 301`・`gh pr view 301 --json state`・`gh run view 123`)
5321
+ #
5322
+ # 【★どこまで見えるか(限界・README にも書く)】番人は字面で測るので、
5323
+ # 繰り返しの中の呼び出しを【関数に寄せた形】(鉄則7 の4段の塊の `V state .state` など)には
5324
+ # 当たらない。塊は上限(WAIT)付きで段の結果を出す決められた待ちなので、通したままにする。
5325
+ # 見る先が変数で決まる形(`until grep -q x "$LOG"`)にも当たらない。
5326
+ # ═════════════════════════════════════════════════════════════════════════════
5327
+
5328
+ #: 繰り返しの頭に立つ語と、その終わりの語。
5329
+ _LOOP_HEADS = frozenset({'until', 'while', 'for'})
5330
+ _LOOP_END = 'done'
5331
+
5332
+ #: 繰り返しの中で「CI・合流・配備・公開の状態」を見に行く道具(頭の語 → 続く語の集合)。
5333
+ _WAIT_WATCH_SUBS = {
5334
+ 'gh': frozenset({'pr', 'run', 'workflow', 'release', 'api'}),
5335
+ 'git': frozenset({'ls-remote', 'merge-base', 'fetch'}),
5336
+ 'npm': frozenset({'view', 'info', 'dist-tag'}),
5337
+ }
5338
+ #: 続く語を問わず「配備の状態」を見に行く道具。
5339
+ _WAIT_WATCH_HEADS = frozenset({'vercel', 'wrangler'})
5340
+ #: 記録ファイルを読むだけの道具(繰り返しの条件によく使う形)。
5341
+ _WAIT_READ_HEADS = frozenset({'grep', 'egrep', 'fgrep', 'rg', 'ag', 'cat', 'tac', 'tail', 'head',
5342
+ 'wc', 'jq', 'test', '[', '[[', 'stat', 'awk', 'sed'})
5343
+ #: CI・合流・配備・公開の記録だと読める名前の部品(名前を `-_.` で割った1つと丸ごと一致する物)。
5344
+ _WAIT_RECORD_WORDS = frozenset({'ci', 'pr', 'merge', 'deploy', 'release', 'publish',
5345
+ 'workflow', 'workflows', 'actions'})
5346
+ _WAIT_NAME_SPLIT_RE = re.compile(r'[-_.]+')
5347
+ _WAIT_TRAILING_DIGITS_RE = re.compile(r'\d+$')
5348
+
5349
+
5350
+ def _wait_record_arg(words):
5351
+ """引数に「CI・合流・配備・公開の記録」と読める名前が在れば True。"""
5352
+ for a in words[1:]:
5353
+ name = str(a).rstrip('/').rsplit('/', 1)[-1]
5354
+ if not name:
5355
+ continue
5356
+ for part in _WAIT_NAME_SPLIT_RE.split(name):
5357
+ if _WAIT_TRAILING_DIGITS_RE.sub('', part) in _WAIT_RECORD_WORDS:
5358
+ return True
5359
+ return False
5360
+
5361
+
5362
+ def _wait_watch_words(words):
5363
+ """この道具が「CI・合流・配備・公開の状態」を見る形なら、その名前を返す。"""
5364
+ if not words:
5365
+ return None
5366
+ head = words[0]
5367
+ subs = _WAIT_WATCH_SUBS.get(head)
5368
+ if subs is not None:
5369
+ nxt = words[1] if len(words) > 1 else ''
5370
+ return f'{head} {nxt}' if nxt in subs else None
5371
+ if head in _WAIT_WATCH_HEADS:
5372
+ return head
5373
+ if head in _WAIT_READ_HEADS and _wait_record_arg(words):
5374
+ return f'{head} <CI・合流・配備の記録>'
5375
+ return None
5376
+
5377
+
5378
+ def _wait_segments(texts):
5379
+ """与えた字面を、本物の区切りだけで割った1コマンドずつにして並べる。"""
5380
+ out = []
5381
+ for text in texts:
5382
+ out.extend(split_commands(text, bodies=False))
5383
+ return out
5384
+
5385
+
5386
+ def _wait_watch_hit(segments, depth=0):
5387
+ """繰り返しの中に「状態を見に行く形」が在れば、その名前を返す。"""
5388
+ for seg in segments:
5389
+ hit = _wait_watch_words(_tool_words(tokens_of(seg)))
5390
+ if hit:
5391
+ return hit
5392
+ if depth < _UNWRAP_MAX_DEPTH:
5393
+ inner = _subst_payloads(seg)
5394
+ if inner:
5395
+ hit = _wait_watch_hit(_wait_segments(inner), depth + 1)
5396
+ if hit:
5397
+ return hit
5398
+ return None
5399
+
5400
+
5401
+ def _wait_has_sleep(segments):
5402
+ """繰り返しの中で sleep を呼んでいれば True。"""
5403
+ for seg in segments:
5404
+ words = _tool_words(tokens_of(seg))
5405
+ if words and words[0] == 'sleep':
5406
+ return True
5407
+ return False
5408
+
5409
+
5410
+ def _loop_regions(command: str):
5411
+ """until / while / for … done の範囲ごとに、その中の1コマンドの並びを返す。
5412
+
5413
+ ★入れ子は外側にも内側にも同じセグメントが入る(どちらで当たっても同じ形なので、
5414
+ どちらを先に見ても結果は変わらない)。
5415
+ """
5416
+ regions, stack = [], []
5417
+ for seg in split_commands(command, bodies=False):
5418
+ toks = tokens_of(seg)
5419
+ if not toks:
5420
+ continue
5421
+ head = toks[0].lower()
5422
+ if head in _LOOP_HEADS:
5423
+ stack.append([])
5424
+ for region in stack:
5425
+ region.append(seg)
5426
+ if head == _LOOP_END and stack:
5427
+ regions.append(stack.pop())
5428
+ regions.extend(region for region in stack if region) # done が足りない形も見る
5429
+ return regions
5430
+
5431
+
5432
+ def _disc_wait_loop(command: str):
5433
+ """CI・合流・配備・公開の完了を繰り返しで待つ形なら、職人へ返す1行を返す。"""
5434
+ for region in _loop_regions(command):
5435
+ if not _wait_has_sleep(region):
5436
+ continue
5437
+ hit = _wait_watch_hit(region)
5438
+ if hit:
5439
+ return f'{_DISC_WAIT_LOOP}(当たった形: 繰り返しの中の {hit} + sleep)'
5440
+ return None
5441
+
5442
+
5293
5443
  def _discipline_scan(command: str, cwd=None):
5294
- """作法の4件(git add -A・cd の && とリダイレクト・全体の再帰検索・部品の置き場への写し)。
5444
+ """作法の5件(git add -A・cd の && とリダイレクト・全体の再帰検索・部品の置き場への写し・
5445
+ CI や合流の完了を繰り返しで待つ形)。
5295
5446
 
5296
5447
  当たれば職人へ返す1行、無ければ None。
5297
5448
  """
5298
5449
  hit = _workcopy_scan(command, cwd)
5450
+ if hit:
5451
+ return hit
5452
+ hit = _disc_wait_loop(command)
5299
5453
  if hit:
5300
5454
  return hit
5301
5455
  toks = _discipline_tokens(command)
@@ -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つも変わらない(弱めない)。
@@ -200,6 +204,12 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
200
204
  - 止まる例: `rm -rf /tmp/claude-1000/作業名`(禁止の一覧)/ `rm -r "$DIR/x"`・`rm -r build/*`(番人)/ `rm -r .git`・`rm -r .claude/hooks`・`rm -r .tyhld`(番人=相対パスでも消せない)
201
205
  - ★**探すだけの道具の「探す言葉」に `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
206
  - **まとめて全部を記録に入れる `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-④)。
207
+ - **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段の塊の ④ が上限付きで待ち切る。
208
+ - 通る例: `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 と関係の無い待ち)
209
+ - ★番人の文は `discipline`(書き方の注意・直し方つき)。止めるのは「繰り返しの中で sleep しながら CI・合流・配備・公開の状態(またはその記録ファイル)を見に行く形」だけで、**sleep の無い繰り返し・CI と関係の無い繰り返し・1回だけの sleep・状態を1回打つ形は1つも巻き込まない**。
210
+ - **`danger` で止められた後に、別の命令・別の道具で作業を続ける**(実地 便 5d7e75fc:再帰の検索が `danger` で止められた後、`ls` と名指しの読み取りに替えて続けた)→ **その便の残りが全部止まる**(便 de82bc3a)。`danger` の後に番人が通すのは、**報告の置き場の中のファイルを書く・直す・読む/その置き場を作る `mkdir -p`/完了の知らせ(`conductor_complete`)だけ**。**止められた命令の全文と番人の文を報告して停止する**(鉄則4・この節の⑤-2)。
211
+ - 通る例(`danger` の後にできること): 報告ファイルを書く / `mkdir -p ~/.local/state/conductor/reports` / `conductor_complete` を1回呼ぶ / `outcome: blocked` で終える
212
+ - ★ほかの便・ほかの現場・別のセッションには効かない(便が変われば解ける)。誤って止まったときは**人が自分のターミナルで印のファイルを消す**(印のパスは番人の文にそのまま出る)。
203
213
  - **行き先のブランチを確かめられない `git push`**(作業場所が変数のままの `git -C "$DIR" push`・`git push` とだけ打つ形・保護ブランチを狙う形)→ 止まる。**リポの中で、ブランチを名指しして** `git push origin <作業ブランチ名>`(★`-u` は付けない=鉄則7-⓪。上流の設定を書くと、囲いが `.git/config` を塞いでいるPCで止まる)。
204
214
  - ★**止まるのは「行き先が分からない形」と「保護ブランチを狙う形」**(実測 便 6e8d85e6)。場所を指す旗を付けても枝を名指しした形(`git -C <場所> push origin <作業ブランチ名>`)は止まらないので、「場所を指す旗が付いているか」で安全を判断しない。
205
215
  - ★**強い上書き(`--force`/`-f`/`--force-with-lease`/先頭が `+` の参照指定)は、旗の位置を問わず止まる。** 旗を末尾や中間に置く形・短い旗をまとめた形(`-fu`)・`git` と `push` の間に場所や設定を指す旗を挟む形・`+` を引用符で囲う形・つないだ行や包みの中に書いた形も、すべて止まる(便 e619bd86 で語の並びを見る判定に替えた。それまでは挟む形と引用符で囲う形が素通りしていた=実地 便 6e8d85e6)。**そもそも強い上書きは打たない**(便の本文の「force-push と reset はしない」)。
@@ -211,7 +221,9 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
211
221
  ⓪ **★報告を書く前に、「反映された」を実物で確かめる**(えふさん確定 2026-10-02 夜・便 7aa63a97)。**報告到着 ≠ 完了/職人終了 ≠ 受入完了。** 職人への指示は反映(合流・公開・本番反映)まで終わらせる。次の3つを、**自分の言葉ではなく実物の出力で**確かめてから①へ進む。
212
222
  - **(a) 合流したか** … 鉄則7-★の確かめ方(`gh pr view <番号> --json state,baseRefName,mergeCommit` が `MERGED` + `git merge-base --is-ancestor <合流コミット> origin/<合流先>`)。★**合流を予約しただけ(`--auto`)は「終わり」ではない。** 予約は GitHub が後から合流するので、**予約したまま手番を閉じると便が死ぬ**(実地 47bdfe00)。鉄則7-★の4段の塊を使えば ④ が最後まで待つ。
213
223
  - **(b) 公開版/本番が新しくなったか** … 配布物を変えた便なら `npm view <パッケージ> version` が上げた版になっていること。画面を変えた便なら配備先の版。★**変えていない便は「変えていない」と確かめる**(確かめを省くのではない)。
214
- - **(c) 背景に回した待ちが残っていないか** … ★**待ちを背景に残したまま手番を閉じない。** 画面なし方式(`claude -p`)では**手番の終わり=処理の終わり**で、背景の待ちはその瞬間に殺され、職人は二度と起きない(実地 915694ac:「まだ実行中です。終わり次第、結果を確かめます。」で手番を閉じ、報告は下書きのまま便が死んだ)。待つなら `Monitor` か `until <条件>; do sleep 2; done` で、**この手番の中で待ち切る**。
224
+ - **(c) 背景に回した待ちが残っていないか** … ★**待ちを背景に残したまま手番を閉じない。** 画面なし方式(`claude -p`)では**手番の終わり=処理の終わり**で、背景の待ちはその瞬間に殺され、職人は二度と起きない(実地 915694ac:「まだ実行中です。終わり次第、結果を確かめます。」で手番を閉じ、報告は下書きのまま便が死んだ)。**この手番の中で待ち切る。**
225
+ - ★**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秒)付きで待ち切るので、自分で待ちの繰り返しを書き起こさない。
226
+ - ★**それ以外の待ち**(目印のファイルが出るのを待つ・配信の読み置き60秒を待つ・背景に回した命令の完了を待つ)は今までどおり。`Monitor` を使うか、1回だけの `sleep`、または CI と関係の無い条件の待ちで、この手番の中で待ち切る。
215
227
  - ★(a)(b)(c) のどれかが終わらせられないときは、**終わったふりをしない**。報告の `outcome` を `blocked` にして、どこまで進んだか・何が残っているか・なぜ進められないかを書いて終える(それが正しい終わり方)。
216
228
  - ★ここを飛ばすと、**便の終わりの関門**(Stop フックの `finish_gate.py`)が実物を見て手番を閉じさせない(PR が開いたまま・報告が下書きのまま・背景の待ちが残っている のどれかなら差し戻す)。同じ理由で止まるのは回数の上限つきなので、**止められたら回避せず、残りを終わらせる**。
217
229
  ① **報告をファイルに書く。** 置き場は配達役の1行が指すファイル**だけ**(正本は `~/.local/state/conductor/reports/<指示ID>.md`)。★便の本文に別の置き場(`/tmp` など)が書かれていても、**配達役の1行の置き場を正とする**(置き場は1か所)。フォルダが無ければ作る。長さの制限は無い。画面に出す必要は無い。中身は変更ファイル・要点・チェック結果を簡潔に。