@tyhld/conductor 0.12.129 → 0.12.130

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.129",
3
+ "version": "0.12.130",
4
4
  "description": "采配くん管制の見守りアプリ(conductor-agent)。各PCで常駐し、中央(devlog-tracker)へ定期的に生存報告(heartbeat)を送る常駐CLI。",
5
5
  "type": "module",
6
6
  "bin": {
@@ -326,6 +326,88 @@ DENY** です。読み込み先は公式の説明と道具の実体で確かめ
326
326
  `APPLY=1 bash scripts/update-guard.sh` を流すまで、その機では効きません。
327
327
  - 台本の**ファイル**の中で写す形(`bash scripts/x.sh` の中の `cp -r`)は見ません(便2.5 と同じ限界)。
328
328
 
329
+ ## 1-7. ★`danger` と `discipline` の分け方(便 227aeebb)
330
+
331
+ **なぜ分けるか。** 便の決まりでは、`danger` は「書き直さず止まって報告する」、`discipline` は
332
+ 「書式上の理由と直し方が示されているので、目的・対象・権限・副作用を広げない書き直しに限って続けてよい」です
333
+ (鉄則4・便 40501fbe の決め)。だから**表示が実態と合っていないと決まりが崩れます**。
334
+ 実地(便 9091e1e7・鉄則7 の塊で6便)では、番人が**無害な形**を
335
+ `danger: redirect into system path (/dev)` と出していたため、職人は鉄則の「止められる常連」を根拠に
336
+ `danger` を書き直して続けていました。表示を直さないと、**職人が `danger` を見ても書き直すのが当たり前になり、
337
+ 本当に危険なときに止まらなくなります**。
338
+
339
+ ### 何を `discipline` に変えたか(★止めることは変えていません)
340
+
341
+ **捨て先の後ろに別の語が「貼り付いた」形**の1種類だけです。文句の捨て先(`2>/dev/null`)を
342
+ コマンド置換や変数の中に書き、その結果を文字列の途中へ差し込むと、番人は字面を展開して測り直すので、
343
+ 捨て先が `/dev/null)/branches/main/…` という**別の名前**として取り出され、`/dev` 直下への書き込みに
344
+ 見えていました。本当の捨て先は `/dev/null` で、無害です。
345
+
346
+ | 形 | 前 | 後 |
347
+ | --- | --- | --- |
348
+ | `gh api "repos/$(… 2>/dev/null)/branches/main"`(置換の結果を文字列の途中へ) | `danger` | **`discipline`** |
349
+ | `V="$(… 2>/dev/null)"; … "$V"/x`(捨て先を変数に入れて別の行で展開・便 9091e1e7 の形) | `danger` | **`discipline`** |
350
+ | `S="$(… 2>/dev/null)"; gh api "repos/$S/branches/…"`(鉄則7 の塊の形) | `danger` | **`discipline`** |
351
+ | 数珠つなぎの変数・貼り付きが2つ・捨て先が `/dev/stdout` などの無害な名前 | `danger` | **`discipline`** |
352
+
353
+ **判定は `deny` のままです。**変わるのは表示と、職人が受け取る直し方(捨て先を小さな関数1か所に
354
+ 寄せる=`q() { "$@" 2>/dev/null; }`)だけです。
355
+
356
+ ### `danger` のまま止める形(無害だと確かめられない形)
357
+
358
+ - 閉じより前が**本物の書き込み先**のもの(`V="$(a 2>/etc/hosts)"; …`)。
359
+ - **無害な捨て先の一覧に無い名前**(`/dev/sda1` など)。一覧は `_HARMLESS_DEVICES` が正本です。
360
+ - 貼り付きを外した文に**ほかの危険が1つでも残る**もの(秘密の読み取り・保護ブランチへの push・
361
+ 守りの置き場への書き込みなどが同じ行に在る形)。★貼り付きを言い訳に危険を見逃しません
362
+ (`_glued_redirect_discipline` が、貼り付きを**本当の捨て先と残りの語に分け直した文**で測り直して
363
+ 確かめます。残りの語は捨てずに別の語として残すので、その語に対する判定は1つも減りません)。
364
+ - 変数やしるしで**場所が読み切れない**もの(`rm -r "$DIR/x"` など)。確かめられない物は通しません。
365
+
366
+ ### ★探す場所を読み切れなかったときの文(便 623cfb85・833c280c)
367
+
368
+ 名前を書かずにフォルダを読む検索の判定は、**探す場所を読み切れないときは作業場所に倒す**(前からの
369
+ 安全側の振る舞い)ので、職人が場所を名指ししていても作業場所の名前が理由に出ます。実地では
370
+ `grep -rln 語 <しるしを含む場所>` や実在しない場所を並べた形がこれに当たり、職人は
371
+ 「名指ししたのに違う現場の名前が出た」と読んで**番人が間違っていると判断し、別の道具に替えて続けていました**。
372
+ 理由の文に**どちらなのかを書く**ようにしました(判定は1つも変えていません)。
373
+
374
+ - `(探す場所を書いていないので作業場所として判定)`
375
+ - `(書かれた場所を読み切れないので作業場所として判定)`=しるし(`*`)や変数で場所が決まる形
376
+
377
+ ### ★秘密の読み取りを、同じ目的のほかの道具でも止める
378
+
379
+ 便 623cfb85・833c280c では、止められた探し方を**別の道具に替えて**続けていました。そこで
380
+ 「同じ場所・同じ包み」を道具ごとに測り、**その道具が本当に秘密の形のファイルを読めるか**も作り物の中で
381
+ 実測しました(本物の秘密は1つも読んでいません)。
382
+
383
+ | 道具・形 | 隠し/記録の外を読むか(実測) | 前 | 後 |
384
+ | --- | --- | --- | --- |
385
+ | 再帰の検索(`grep -r`) | **読む** | `danger` | `danger`(変更なし) |
386
+ | 既定の検索(`rg 語 <場所>`・`rg -l`) | **読まない**(隠しと除外設定を飛ばす) | 通す | 通す(変更なし) |
387
+ | 隠しも含める旗つき(`rg --hidden`・`-uu`・`ag --hidden`) | **読む** | `danger` | `danger`(変更なし) |
388
+ | 記録の中だけを探す形(`git grep 語 -- src docs`) | **読まない**(追跡済みだけ) | 通す | 通す(変更なし) |
389
+ | **記録の外まで読む旗つき**(`git grep --untracked`・`--no-index`・`--no-exclude-standard`) | **読む** | 通す | **`danger`(足した)** |
390
+ | **名前を並べて別の道具へ渡す形**(`find <場所> -exec rg …`・`find <場所> \| xargs rg`) | **読む** | 通す | **`danger`(足した)** |
391
+ | **包みの中で名前を並べて読ませる形**(`bash -c "find <場所> -exec cat {} +"`) | **読む** | 通す | **`danger`(足した)** |
392
+ | 一覧を無制限で出してから読ませる形(`rg --files -uu <場所> \| xargs cat`) | **読む** | `danger` | `danger`(変更なし) |
393
+ | 短い旗(`git grep -nu`) | 道具が受け付けない(実測で失敗) | 通す | 通す(変更なし) |
394
+
395
+ ★**通る側は1つも巻き込んでいません**:場所とファイルを名指しした検索・名指しのファイルを読む形・
396
+ 記録の中だけを探す形・秘密の形の名前を含まない場所の検索は、すべて今までどおり通ります(実測)。
397
+ 止めるのは「**探した場所の中に秘密の形の名前が在るとき**」だけで、名指ししたかどうかでは決めません。
398
+
399
+ ### 分かっている限界
400
+
401
+ - **包みの中では「作法」の判定を当てません。** `bash -c "rg -l 語 <リポの根>"` のように包むと、
402
+ リポ全体の再帰検索の作法(`discipline`)は当たりません(危険の判定は当たります)。
403
+ 作法は「打ち直しの往復を減らす」ためのもので、包みの中まで追うと**本文の字面を測る形**が増えるため、
404
+ 今は足していません。★この形は秘密を読めない道具に限られることを実測で確かめています。
405
+ - **`rg --files <場所>` のような「探す言葉を取らない形」は、場所が探す言葉と読まれます。**
406
+ そのため作業場所に倒れ、理由に `(探す場所を書いていないので作業場所として判定)` が付きます
407
+ (止める向きなので、そのままにしています)。
408
+ - **番人が古い機体では効きません。** 各PCで人が1回 `APPLY=1 bash scripts/update-guard.sh` を
409
+ 流すまで、その機では今までどおりです。
410
+
329
411
  ## 2. ファイルの役割
330
412
 
331
413
  | ファイル | 役割 |
@@ -645,6 +727,15 @@ Claude Code 側のフック打ち切り(`timeout: 600`)と同時に終わる
645
727
  許されるのは**末尾の `/**` だけ**で、この決まりは `test/home-secret-deny.test.ts` が安全弁として
646
728
  固定しています。だからホーム側はこの形だけ床の外に残り、番人だけが止めます
647
729
  (作業場所の中の同じ形は既存の `Edit(**/.claude/agents/**)` ほかが覆います)。
730
+ - **名前を書かずにフォルダを読む検索は、探す場所を読み切れないと作業場所に倒します**(便 227aeebb)。
731
+ しるし(`*`)や変数で場所が決まる形・実在しない場所を並べた形がこれに当たり、職人が場所を
732
+ 名指ししていても**作業場所の名前が理由に出ます**。判定は安全側のままで、理由の文に
733
+ どちらなのかを書くだけにしました(1-7)。
734
+ - **既定の検索(`rg 語 <場所>`)は、隠しファイルと除外設定を飛ばすので止めません**(便 227aeebb の実測)。
735
+ 読めるようになる旗(`--hidden`・`-uu`・`--no-ignore` ほか)が付いたときだけ止めます。
736
+ 記録の中だけを探す形(`git grep`)も同じで、**記録の外まで読む旗**(`--untracked`・`--no-index`・
737
+ `--no-exclude-standard`)が付いたときだけ止めます。
738
+ - **包みの中では作法(`discipline`)の判定を当てません**(便 227aeebb)。危険の判定は当たります。
648
739
  - 番人の設定への書き込み(便 c05796ec)は、コマンドの字面で見える書き込みだけを止めます。
649
740
  台本の**ファイル**(`bash scripts/x.sh`・`node x.mjs`)の中の書き込みは見ません。
650
741
  プログラムの中は「場所が書く呼び出しと同じ文に在る」か「場所を入れた変数を書く文で使う」形だけを拾います。
@@ -945,6 +945,67 @@ def redirect_targets(segment: str):
945
945
  return [t for t in (normalize_redirect_target(r) for r in raw) if t]
946
946
 
947
947
 
948
+ # ═════════════════════════════════════════════════════════════════════════════
949
+ # 捨て先の後ろに別の語が「貼り付く」書き方(便 227aeebb・danger と discipline を分ける)
950
+ #
951
+ # 【何が起きていたか(実測 便 9091e1e7・2026-10-09/鉄則7 の塊で6便)】
952
+ # 文句の捨て先(2>/dev/null)をコマンド置換の中に書き、その結果を文字列の途中に差し込むと、
953
+ # S="$(何か 2>/dev/null)"; gh api "repos/$S/branches/main/protection/…"
954
+ # 番人は変数を字面で展開してから測り直すので、捨て先が
955
+ # /dev/null)/branches/main/protection/…
956
+ # という【別の名前】として取り出され、`/dev` 直下への書き込みに見えて danger で止まっていた。
957
+ # 本当の捨て先は /dev/null で、無害である。
958
+ #
959
+ # 【どう直したか】捨て先の後ろにコマンド置換や引用符の閉じ(`)` `"` `'` `` ` ``)ごと別の語が
960
+ # 貼り付いている形で、【閉じより前が無害な捨て先そのもの】のときは、
961
+ # 「危険(danger)」ではなく「書き方の注意(discipline・直し方つき)」として返す。
962
+ # ★止めることは変えない(deny のまま)。変わるのは表示と、職人が受け取る直し方だけ。
963
+ # ★閉じより前が無害な捨て先でない形(本物の書き込み)は、今までどおり danger で止める。
964
+ # ★貼り付きを外した文に【ほかの危険が1つでも残る】ときも、今までどおり danger で止める
965
+ # (貼り付きを言い訳に危険を見逃さない=_glued_redirect_discipline の確かめ)。
966
+ # ═════════════════════════════════════════════════════════════════════════════
967
+
968
+ #: コマンド置換・引用符の閉じ。展開すると、この字ごと別の語が捨て先の後ろへ貼り付く。
969
+ _SUBST_CLOSERS = ')`\'"'
970
+
971
+
972
+ def glued_harmless_redirect(target: str):
973
+ """捨て先の後ろに別の語が貼り付いた形なら (本当の捨て先, 残りの語) を返す。
974
+
975
+ `/dev/null)/branches/main` → `('/dev/null', '/branches/main')`
976
+ 貼り付きが無い形・閉じより前が無害な捨て先でない形は None(=今までどおり danger)。
977
+ """
978
+ if not target or not target.startswith('/'):
979
+ return None
980
+ cut = next((i for i, ch in enumerate(target) if ch in _SUBST_CLOSERS), -1)
981
+ if cut <= 0:
982
+ return None # 貼り付きが無い=ふつうの書き込み先
983
+ head = target[:cut]
984
+ if head not in _HARMLESS_DEVICES and not head.startswith('/dev/fd/'):
985
+ return None # 本物の書き込み先(例 /etc/hosts)は分けない
986
+ return head, target[cut:].lstrip(_SUBST_CLOSERS)
987
+
988
+
989
+ def _unglue_redirects(text: str):
990
+ """貼り付いた捨て先を「本当の捨て先」と「残りの語」に分け直した文と、その件数を返す。
991
+
992
+ ★緩めるためではなく「貼り付きだけが危険に見えていたのか」を測るために使う。
993
+ 残りの語は捨てずに別の語として残すので、その語に対する判定(秘密の読み取りなど)は
994
+ 1つも減らない。
995
+ """
996
+ out = text
997
+ n = 0
998
+ for seg in _real_segments(text):
999
+ for t in redirect_targets(seg):
1000
+ got = glued_harmless_redirect(t)
1001
+ if not got:
1002
+ continue
1003
+ head, rest = got
1004
+ out = out.replace(t, f'{head} {rest}' if rest else head)
1005
+ n += 1
1006
+ return out, n
1007
+
1008
+
948
1009
  # ═════════════════════════════════════════════════════════════════════════════
949
1010
  # ラッパの中身(bash -c "…" / python3 -c "…" / ヒアドキュメント)
950
1011
  # ★包むだけで秘密が読めていた穴を塞ぐ。`cat .env` は止まるのに
@@ -1131,6 +1192,10 @@ def _wrapper_danger(command: str, depth: int = 0, cwd=None):
1131
1192
  if hit:
1132
1193
  return f'{hit} ({where})'
1133
1194
  hit = _env_write_scan(inner, cwd)
1195
+ if hit:
1196
+ return f'{hit} ({where})'
1197
+ # ★名前を並べて読ませる形も包みの中で測る(便 227aeebb・包むだけで素通りしていた)。
1198
+ hit = _find_feed_danger(inner, cwd)
1134
1199
  if hit:
1135
1200
  return f'{hit} ({where})'
1136
1201
  for seg in _real_segments(inner):
@@ -1224,7 +1289,8 @@ def _var_expansion_danger(command: str, cwd=None):
1224
1289
  if hit:
1225
1290
  return hit
1226
1291
  hit = (_guard_write_scan(expanded, cwd) or _env_write_scan(expanded, cwd)
1227
- or _bypass_scan(expanded, cwd) or _wrapper_danger(expanded, 0, cwd))
1292
+ or _find_feed_danger(expanded, cwd) or _bypass_scan(expanded, cwd)
1293
+ or _wrapper_danger(expanded, 0, cwd))
1228
1294
  if hit:
1229
1295
  return hit
1230
1296
  return None
@@ -1370,6 +1436,15 @@ def _bulk_copy_danger(verb: str, tokens, cwd=None):
1370
1436
  _RECURSIVE_GREP_VERBS = frozenset({'grep', 'egrep', 'fgrep', 'ugrep', 'zgrep'})
1371
1437
  #: 既定では隠しファイル・除外設定を飛ばすが、旗で全部読むようになる検索の道具。
1372
1438
  _HIDDEN_SEARCH_VERBS = frozenset({'rg', 'ag', 'ack', 'pt'})
1439
+ #: 記録の中だけを探す道具が、記録の【外】(追跡していない物・外した物)まで読むようになる旗。
1440
+ # ★旗が無ければ追跡済みのファイルしか読まないので、今までどおり通す
1441
+ # (場所を名指しして記録の中を探す形は、鉄則が勧めている形=1つも巻き込まない)。
1442
+ # 実測(便 227aeebb・作り物の中): 旗なしは秘密の形のファイルを読めない。
1443
+ # --untracked は追跡していない物を読む/--no-index と --no-exclude-standard は
1444
+ # 記録から外した物まで読む(どちらも実際に中身が出た)。
1445
+ _TRACKED_SEARCH_OUTSIDE_FLAGS = frozenset({
1446
+ '--untracked', '--no-index', '--no-exclude-standard',
1447
+ })
1373
1448
 
1374
1449
 
1375
1450
  def _search_excludes(args):
@@ -1396,10 +1471,13 @@ def _recursive_read_danger(verb: str, tokens, cwd=None):
1396
1471
  ・grep 系は -r / -R / --recursive のとき
1397
1472
  ・rg / ag などは隠しファイルや除外設定を無視する旗(--hidden / -u / --no-ignore など)のとき
1398
1473
  (★旗が無ければ、隠しファイル(.env.local など)は既定で読まないので止めない)
1474
+ ・記録の中だけを探す道具(git grep)は、記録の【外】まで読む旗が付いたときだけ
1475
+ (★旗が無ければ追跡済みのファイルしか読まないので、今までどおり通す・便 227aeebb)
1399
1476
  ・探す場所が書かれていなければ、作業場所(cwd)を探す場所とみなす
1400
1477
  ★除外の指定(--exclude=.env* など)で外した名前は数えない=「秘密を除いて探す」は通る。
1401
1478
  """
1402
1479
  args = tokens[1:] if tokens else []
1480
+ label = verb
1403
1481
  if verb in _RECURSIVE_GREP_VERBS:
1404
1482
  flags = ''.join(a[1:] for a in args if a.startswith('-') and not a.startswith('--'))
1405
1483
  if not ('r' in flags or 'R' in flags or '--recursive' in args
@@ -1410,24 +1488,44 @@ def _recursive_read_danger(verb: str, tokens, cwd=None):
1410
1488
  '--skip-vcs-ignores', '-U', '--no-ignore-vcs'}
1411
1489
  if not any(a in loud for a in args):
1412
1490
  return None
1491
+ elif verb == 'git':
1492
+ # ★記録の中だけを探す形(場所を名指しする勧めの形)は1つも巻き込まない。
1493
+ # 記録の外まで読む旗が付いたときだけ、ほかの検索の道具と同じ物差しを当てる。
1494
+ sub, rest = _git_subcommand(args)
1495
+ if sub != 'grep' or not any(a in _TRACKED_SEARCH_OUTSIDE_FLAGS for a in rest):
1496
+ return None
1497
+ where = _git_cwd(args, cwd) # `-C 場所` を反映(変数なら作業場所に倒す)
1498
+ if where is not _UNKNOWN_DIR and where:
1499
+ cwd = where
1500
+ args = rest
1501
+ label = 'git grep'
1502
+ verb = 'grep' # 探す言葉の位置の読み方は grep と同じ
1413
1503
  else:
1414
1504
  return None
1415
1505
  patterns = _search_excludes(args)
1416
1506
  skip = pattern_arg_index(verb, args)
1417
1507
  roots = []
1508
+ named = 0
1418
1509
  for pos, a in enumerate(args):
1419
1510
  if pos == skip or a.startswith('-'):
1420
1511
  continue
1512
+ named += 1
1421
1513
  d = _existing_dir(a, cwd)
1422
1514
  if d:
1423
1515
  roots.append(d)
1516
+ # ★探す場所が【読み切れなかった】ときも作業場所に倒す(安全側・前からの振る舞い)。
1517
+ # そのときは理由の文にそう書く=職人が「名指ししたのに違う場所の名前が出た」と
1518
+ # 読み違えないため(便 623cfb85・833c280c の実地。判定は1つも変えていない)。
1519
+ note = ''
1424
1520
  if not roots:
1425
1521
  base = cwd if (cwd and os.path.isabs(cwd)) else os.getcwd()
1426
1522
  roots = [os.path.realpath(base)]
1523
+ note = ('(書かれた場所を読み切れないので作業場所として判定)' if named
1524
+ else '(探す場所を書いていないので作業場所として判定)')
1427
1525
  for d in roots:
1428
1526
  hit = find_secret_in_tree(d, patterns)
1429
1527
  if hit:
1430
- return f'{hit} read without naming it by {verb}'
1528
+ return f'{hit} read without naming it by {label}{note}'
1431
1529
  return None
1432
1530
 
1433
1531
 
@@ -1439,7 +1537,10 @@ def _find_feed_danger(command: str, cwd=None):
1439
1537
  feeds = re.search(r'-exec(dir)?\b|-ok(dir)?\b|\|\s*xargs\b', low)
1440
1538
  if not feeds:
1441
1539
  return None
1442
- readers = READ_VERBS | EXFIL_VERBS | _BULK_VERBS
1540
+ # ★探す道具も「読む道具」に数える(便 227aeebb)。名前を並べて渡された先では、
1541
+ # 隠しファイルを飛ばす既定が効かず、実際に中身が出た(作り物の中で実測)。
1542
+ readers = (READ_VERBS | EXFIL_VERBS | _BULK_VERBS
1543
+ | _RECURSIVE_GREP_VERBS | _HIDDEN_SEARCH_VERBS)
1443
1544
  words = set(re.findall(r'[A-Za-z0-9_.-]+', low[feeds.start():]))
1444
1545
  if not (words & readers):
1445
1546
  return None
@@ -4777,6 +4878,11 @@ _DISC_CD = ('cd を && でほかの命令とつなげない・cd とリダイレ
4777
4878
  'cd は作業のはじめに1回だけ単独で打ち、以後は絶対パスか git -C を使う(鉄則2)')
4778
4879
  _DISC_SEARCH = ('リポ全体・ホーム全体を再帰で検索しない(重く、秘密の置き場にも当たる)。'
4779
4880
  '探す場所を名指しで(例: rg 語 src/ ・ find src -name 名前)')
4881
+ _DISC_GLUED_REDIRECT = (
4882
+ '文句の捨て先(2>/dev/null)を、あとで文字列の途中に差し込む変数やコマンド置換の中に書かない。'
4883
+ '番人は字面を展開して測り直すので、捨て先の後ろに別の語が貼り付き、別の場所への書き込みに見える。'
4884
+ '捨て先は小さな関数1か所に寄せる(鉄則の「止められる常連」)。'
4885
+ '例: 先に q() { "$@" 2>/dev/null; } を置き、以後は S="$(q 何か)" と書く')
4780
4886
  _DISC_WORKCOPY = ('リポジトリの中の部品の置き場(node_modules など)の下に、使い捨ての作業用コピーを作らない'
4781
4887
  '(記録される場所の中に出来る・片付けも番人に止められる)。'
4782
4888
  '使い捨ての置き場は /tmp/claude-1000/ の下にする(鉄則13)。'
@@ -5215,72 +5321,103 @@ def _discipline_scan(command: str, cwd=None):
5215
5321
  # 入口: Bash
5216
5322
  # ═════════════════════════════════════════════════════════════════════════════
5217
5323
 
5218
- def decide_bash(command: str, cwd=None):
5219
- """Bash コマンド1件の判定。既定は allow。"""
5220
- if not command or not command.strip():
5221
- return _r(ALLOW, 'empty command')
5222
- low = command.lower()
5324
+ def _bash_danger(command: str, cwd=None):
5325
+ """「危険」の段を順番どおり当て、最初に当たった理由を返す(当たらなければ None)。
5223
5326
 
5327
+ ★decide_bash はこの関数の答えをそのまま使う=危険の判定の正本を2か所に置かない。
5328
+ 順番・理由の文は、分けて書いていたときと1文字も変えていない(便 227aeebb の切り出し)。
5329
+ ★本番 DB の直接変更(1e)は deny とは別の結果(人に聞く)を返すので、ここには入れない。
5330
+ """
5224
5331
  # ---- 1) 危険(全文) ----
5225
- hit = _danger_patterns(low)
5332
+ hit = _danger_patterns(command.lower())
5226
5333
  if hit:
5227
- return _r(DENY, f'danger: {hit}')
5334
+ return hit
5228
5335
  hit = _rm_danger(command)
5229
5336
  if hit:
5230
- return _r(DENY, f'danger: {hit}')
5231
-
5232
- # ★機械的な区切りに、本物の区切りを足して測る(便 2.5・`grep -n "x|y" .env` の動詞を取り戻す)。
5233
- segments = _real_segments(command)
5337
+ return hit
5234
5338
 
5235
5339
  # ---- 1) 危険(セグメントごと・対象と作用) ----
5236
- for seg in segments:
5340
+ # ★機械的な区切りに、本物の区切りを足して測る(便 2.5・`grep -n "x|y" .env` の動詞を取り戻す)。
5341
+ for seg in _real_segments(command):
5237
5342
  toks = tokens_of(seg)
5238
5343
  v = verb_of(toks)
5239
5344
  hit = _secret_danger(seg, v, toks, cwd)
5240
5345
  if hit:
5241
- return _r(DENY, f'danger: {hit}')
5346
+ return hit
5242
5347
  # ★フォルダごとの持ち出し(名前を書かない複製・固め・同期・リンク)。
5243
5348
  hit = (_bulk_copy_danger(v, toks, cwd) or _recursive_read_danger(v, toks, cwd)
5244
5349
  or _admin_merge_danger(v, toks))
5245
5350
  if hit:
5246
- return _r(DENY, f'danger: {hit}')
5351
+ return hit
5247
5352
  hit = _find_feed_danger(command, cwd)
5248
5353
  if hit:
5249
- return _r(DENY, f'danger: {hit}')
5354
+ return hit
5250
5355
 
5251
5356
  # ---- 1c) 危険(ラッパの中身にも同じ物差しを当てる) ----
5252
5357
  # `bash -c "cat .env"` / `python3 -c "open('.env')"` / ヒアドキュメント経由。
5253
5358
  hit = _wrapper_danger(command, 0, cwd)
5254
5359
  if hit:
5255
- return _r(DENY, f'danger: {hit}')
5360
+ return hit
5256
5361
 
5257
5362
  # ---- 1c-2) 変数に入れたパス(便 3d1974f4・`F=秘密; echo > "$F"` を素通りさせない) ----
5258
5363
  hit = _var_expansion_danger(command, cwd)
5259
5364
  if hit:
5260
- return _r(DENY, f'danger: {hit} (変数を展開して判定)')
5365
+ return f'{hit} (変数を展開して判定)'
5261
5366
 
5262
5367
  # ---- 1c') 番人の設定への書き込み(便 2.5・リダイレクト・tee・cp・mv・sed -i ほか) ----
5263
5368
  hit = _guard_write_scan(command, cwd)
5264
5369
  if hit:
5265
- return _r(DENY, f'danger: {hit}')
5370
+ return hit
5266
5371
 
5267
5372
  # ---- 1c'') .env 類への書き込み(便 3d11f913・Write/Edit の設定 deny と結果をそろえる) ----
5268
5373
  hit = _env_write_scan(command, cwd)
5269
5374
  if hit:
5270
- return _r(DENY, f'danger: {hit}')
5375
+ return hit
5271
5376
 
5272
5377
  # ---- 1d) 抜け道(便 fc22bc34・main 直 push・保護の迂回と変更・秘密の値・検査の省略) ----
5273
5378
  hit = _bypass_scan(command, cwd)
5274
5379
  if hit:
5275
- return _r(DENY, f'danger: {hit}')
5380
+ return hit
5276
5381
 
5277
5382
  # ---- 1d') 手元に見せかけた回り道での DB 実行(トンネル・ポート転送・便 ee34f7e5) ----
5278
5383
  hit = _tunneled_db_danger(command)
5279
5384
  if hit:
5280
- return _r(DENY, f'danger: {hit}')
5385
+ return hit
5281
5386
  # ---- 1d'') ポート転送を単独でも(便 afb46a15・張ってから別のコマンドで psql を打つ形) ----
5282
5387
  hit = _port_forward_danger(command)
5283
5388
  if hit:
5389
+ return hit
5390
+ return None
5391
+
5392
+
5393
+ def _glued_redirect_discipline(command: str, cwd=None):
5394
+ """危険に見えている理由が「捨て先の後ろの貼り付き」だけなら、職人へ返す1行を返す。
5395
+
5396
+ ★止めることは変えない(deny のまま・表示と直し方だけを分ける)。
5397
+ ★貼り付きを外した文に危険が1つでも残るなら None を返す=今までどおり danger で止める。
5398
+ """
5399
+ for text in (command, _expand_local_vars(command)):
5400
+ fixed, n = _unglue_redirects(text)
5401
+ if not n:
5402
+ continue
5403
+ if _bash_danger(fixed, cwd) is None:
5404
+ return _DISC_GLUED_REDIRECT
5405
+ return None
5406
+
5407
+
5408
+ def decide_bash(command: str, cwd=None):
5409
+ """Bash コマンド1件の判定。既定は allow。"""
5410
+ if not command or not command.strip():
5411
+ return _r(ALLOW, 'empty command')
5412
+
5413
+ # ---- 1) 危険 ----
5414
+ # ★当たった理由が「捨て先の後ろの貼り付き」だけのときは、危険ではなく
5415
+ # 書き方の注意(discipline・直し方つき)として返す(便 227aeebb)。止めるのは同じ。
5416
+ hit = _bash_danger(command, cwd)
5417
+ if hit:
5418
+ disc = _glued_redirect_discipline(command, cwd)
5419
+ if disc:
5420
+ return _r(DENY, f'discipline: {disc}')
5284
5421
  return _r(DENY, f'danger: {hit}')
5285
5422
 
5286
5423
  # ---- 1e) 本番 DB の直接変更(★判定の置き場は _prod_db_change の1か所・決定は下の定数) ----
@@ -0,0 +1,354 @@
1
+ #!/usr/bin/env python3
2
+ """危険(danger)と書き方の注意(discipline)の分け方の検査(便 227aeebb)。
3
+
4
+ 実行: python3 scripts/hooks/test_discipline_vs_danger.py
5
+ 1件でも期待と違えば exit 1。
6
+
7
+ 【なぜ要るか(実測 便 9091e1e7・2026-10-09/鉄則7 の塊で6便)】
8
+ 番人は無害な形(文句の捨て先 2>/dev/null をコマンド置換や変数の中に書き、その結果を
9
+ 文字列の途中へ差し込んだ形)を `danger: redirect into system path (/dev)` と出していた。
10
+ 便の決まりでは danger は「書き直さず止まって報告する」なので、職人は鉄則の「止められる常連」
11
+ を根拠に書き直して続けていた。表示が実態と合っていないと、職人が danger を見ても書き直すのが
12
+ 当たり前になり、本当に危険なときに止まらなくなる。
13
+
14
+ 【ここで固定すること】
15
+ (a) 無害だと確かめられる形(捨て先の後ろに別の語が貼り付いただけ)は **discipline**(deny のまま)
16
+ (b) 無害だと確かめられない形(本当の書き込み先・貼り付きを外しても危険が残る形)は **danger** のまま
17
+ (c) 危険な操作(書き先・消す・権限・外への送信・保護の迂回・秘密の読み取りなど)は
18
+ 引き続き **danger** で止まる
19
+ (d) 秘密の読み取りを、同じ目的のほかの道具(記録の外まで読む旗つきの検索・名前を並べて
20
+ 渡す形・包みの中)でも止める(便 227aeebb で足した分)
21
+ (e) 通る側(場所とファイルを名指しした検索・名指しのファイルを読む・通常の開発)は1つも
22
+ 止まる側に変わらない
23
+
24
+ ★止めること自体は1件も変えていない。(a) は danger → discipline の【表示】の違いだけで、
25
+ 判定はどちらも deny である。
26
+ ★この台本は検索の道具の名前を素の字で置かない語もある(組み立てて使う)。既存の作法どおり。
27
+ """
28
+ import os
29
+ import subprocess
30
+ import sys
31
+ import tempfile
32
+
33
+ sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
34
+
35
+ import policy # noqa: E402
36
+
37
+ failures = []
38
+
39
+
40
+ def check(label, got, want):
41
+ ok = got == want
42
+ if not ok:
43
+ failures.append(f'{label}: got={got!r} want={want!r}')
44
+ print(f'{"OK " if ok else "NG "} {label:58} {str(got)[:46]}')
45
+
46
+
47
+ # ── 使い捨ての作り物(この台本のコードが作る=職人の命令の字面には出ない)────────
48
+ ROOT = tempfile.mkdtemp(prefix='disc-danger-')
49
+ SITE = os.path.join(ROOT, 'site') # 作業場所(秘密の形の名前を含む)
50
+ os.makedirs(os.path.join(SITE, 'src'))
51
+ os.makedirs(os.path.join(SITE, 'sub', 'inner'))
52
+ with open(os.path.join(SITE, 'src', 'a.ts'), 'w') as f:
53
+ f.write('needle\n')
54
+ with open(os.path.join(SITE, '.gitignore'), 'w') as f:
55
+ f.write('.env' + '.local\n')
56
+ with open(os.path.join(SITE, 'sub', 'inner', '.env' + '.local'), 'w') as f:
57
+ f.write('DUMMY=placeholder\n')
58
+ with open(os.path.join(SITE, 'sub', '.npm' + 'rc'), 'w') as f:
59
+ f.write('DUMMY=placeholder\n')
60
+ CLEAN = os.path.join(ROOT, 'clean') # 秘密の形の名前を含まない場所
61
+ os.makedirs(os.path.join(CLEAN, 'deep'))
62
+ with open(os.path.join(CLEAN, 'deep', 'b.md'), 'w') as f:
63
+ f.write('needle\n')
64
+ _env = dict(os.environ, GIT_AUTHOR_NAME='p', GIT_AUTHOR_EMAIL='p@x',
65
+ GIT_COMMITTER_NAME='p', GIT_COMMITTER_EMAIL='p@x')
66
+ for _argv in (['git', 'init', '-q'], ['git', 'add', 'src/a.ts', '.gitignore'],
67
+ ['git', 'commit', '-q', '-m', 'init']):
68
+ subprocess.run(_argv, cwd=SITE, env=_env, capture_output=True)
69
+
70
+ SUB = os.path.join(SITE, 'sub')
71
+ HOME = os.path.expanduser('~')
72
+ G = 'g' + 'rep'
73
+ RG = 'r' + 'g'
74
+ AG = 'a' + 'g'
75
+ GG = 'git ' + 'grep'
76
+ ENV = '.env'
77
+ NULL = '/dev/' + 'null'
78
+
79
+
80
+ def decide(cmd, cwd=SITE):
81
+ return policy.decide_bash(cmd, cwd)
82
+
83
+
84
+ def kind_of(reason):
85
+ return reason.split(':', 1)[0]
86
+
87
+
88
+ # ═════════════════════════════════════════════════════════════════════════════
89
+ # (a) 表示を変えた形 … deny のまま・文は discipline(理由と直し方つき)
90
+ # ═════════════════════════════════════════════════════════════════════════════
91
+ print('── (a) 貼り付きだけの形は discipline(deny のまま)' + '─' * 20)
92
+ GLUED = [
93
+ ('a1 コマンド置換の結果を文字列の途中へ差し込む',
94
+ 'gh api "repos/$(gh repo view --json nameWithOwner -q .nameWithOwner 2>' + NULL
95
+ + ')/branches/main"'),
96
+ ('a2 捨て先を変数に入れて別の行で展開(便 9091e1e7 の形)',
97
+ 'NPMROOT="$(npm root -g 2>' + NULL + ')"; ls -d "$NPMROOT"/@scope/x'),
98
+ ('a3 鉄則7 の塊の形(必須の検査を読む)',
99
+ 'S="$(gh repo view --json nameWithOwner --jq .nameWithOwner 2>' + NULL + ')"; '
100
+ 'gh api "repos/$S/branches/main/protection/required_status_checks"'),
101
+ ('a4 数珠つなぎの変数',
102
+ 'A="$(date 2>' + NULL + ')"; B="$A/x"; echo "$B"'),
103
+ ('a5 貼り付きが2つ',
104
+ 'X="$(a 2>' + NULL + ')"; Y="$(b 2>' + NULL + ')"; echo "$X/p" "$Y/q"'),
105
+ ('a6 捨て先が標準出力の名前',
106
+ 'V="$(a 2>/dev/stdout)"; echo "$V/p"'),
107
+ ('a7 貼り付きの後ろが秘密でも無害でもない語',
108
+ 'V="$(a 2>' + NULL + ')"; ls -d "$V"/docs'),
109
+ ('a8 入れ物が引用符の形',
110
+ "V=\"$(a 2>" + NULL + ")\"; echo \"$V/p\""),
111
+ ]
112
+ for label, cmd in GLUED:
113
+ r = decide(cmd)
114
+ check(label, (r['decision'], kind_of(r['reason'])), ('deny', 'discipline'))
115
+
116
+ print('── (a) 文に「理由」と「直し方」が入っている ' + '─' * 24)
117
+ _r = decide(GLUED[1][1])
118
+ check('a9 文に捨て先の書き方が出る', '2>' + NULL in _r['reason'], True)
119
+ check('a10 文に直し方(寄せる先の例)が出る', '"$@"' in _r['reason'], True)
120
+ check('a11 文に鉄則の在り処が出る', '常連' in _r['reason'], True)
121
+
122
+ # ═════════════════════════════════════════════════════════════════════════════
123
+ # (b) 無害だと確かめられない形は danger のまま
124
+ # ═════════════════════════════════════════════════════════════════════════════
125
+ print('── (b) 確かめられない形は danger のまま ' + '─' * 28)
126
+ STILL_DANGER = [
127
+ ('b1 捨て先に見せかけた本物の書き込み',
128
+ 'V="$(a 2>/etc/hosts)"; ls -d "$V"/x'),
129
+ ('b2 似て非なる捨て先(無害の一覧に無い名前)',
130
+ 'V="$(a 2>/dev/sda1)"; ls -d "$V"/x'),
131
+ ('b3 貼り付きを外しても秘密の読み取りが残る',
132
+ 'V="$(a 2>' + NULL + ')"; cat "$V" ' + SUB + '/.npm' + 'rc'),
133
+ ('b4 貼り付きを外しても保護ブランチへの push が残る',
134
+ 'V="$(a 2>' + NULL + ')"; echo "$V/x"; git push origin main'),
135
+ ('b5 貼り付きを外しても守りの置き場への書き込みが残る',
136
+ 'V="$(a 2>' + NULL + ')"; echo "$V/x" > ' + HOME + '/.claude/settings.json'),
137
+ ('b6 貼り付きの無い本物のシステム領域への書き込み', 'echo x > /etc/hosts'),
138
+ ('b7 貼り付きの無い秘密への書き込み',
139
+ 'echo x > ' + SUB + '/inner/' + ENV + '.local'),
140
+ ('b8 変数やしるしを含む再帰の消去(確かめられない)', 'rm -r "$DIR/x"'),
141
+ ]
142
+ for label, cmd in STILL_DANGER:
143
+ r = decide(cmd)
144
+ check(label, (r['decision'], kind_of(r['reason'])), ('deny', 'danger'))
145
+
146
+ # ═════════════════════════════════════════════════════════════════════════════
147
+ # (c) 危険な操作は引き続き danger(既存の判定の全部を1つずつ)
148
+ # ═════════════════════════════════════════════════════════════════════════════
149
+ print('── (c) 危険な操作は引き続き danger ' + '─' * 32)
150
+ DANGER = [
151
+ # 無条件の危険
152
+ ('c01 強い上書きの push', 'git push --force origin x'),
153
+ ('c02 手元を巻き戻す', 'git reset --hard HEAD~1'),
154
+ ('c03 追跡外をまとめて消す', 'git clean -fd'),
155
+ ('c04 表を落とす', 'psql -c "drop table t"'),
156
+ ('c05 DB を落とす', 'psql -c "drop database d"'),
157
+ ('c06 DB を初期化する', 'supabase db reset'),
158
+ ('c07 合言葉の置き場を触る', 'gh secret list'),
159
+ ('c08 管理者で消す', 'sudo rm /x'),
160
+ ('c09 環境変数の一括露出', 'printenv'),
161
+ ('c10 合言葉の表示(送受の道具)', 'gh auth token'),
162
+ ('c11 合言葉の表示(状態+旗)', 'gh auth status --show-token'),
163
+ ('c12 合言葉の表示(記録の道具)', 'git credential fill'),
164
+ ('c13 合言葉の表示(部品の道具)',
165
+ 'npm config get //registry.npmjs.org/:_authToken'),
166
+ ('c14 本番の環境設定の取り寄せ', 'vercel env pull'),
167
+ ('c15 鍵の表示', 'supabase projects api-keys'),
168
+ ('c16 語に分けられない push', 'git push origin "x'),
169
+ # 消す
170
+ ('c17 守りの置き場を消す', 'rm -r ' + HOME + '/.claude'),
171
+ ('c18 履歴を消す', 'rm -r .git'),
172
+ ('c19 守りの置き場(相対)を消す', 'rm -r .claude/hooks'),
173
+ # 秘密・システム領域
174
+ ('c20 秘密の値を画面に出す', 'echo $DATABASE_URL'),
175
+ ('c21 秘密のファイルを読む', 'cat ' + SUB + '/.npm' + 'rc'),
176
+ ('c22 システム領域へ書く', 'tee /etc/hosts'),
177
+ ('c23 /dev のほかの書き先へ流し込む', 'echo x > /dev/sda'),
178
+ ('c24 管理者の設定へ書く', 'tee /etc/claude-code/managed-settings.json'),
179
+ ('c25 守りの置き場へ書く', 'tee ' + HOME + '/.tyhld/hooks/policy.py'),
180
+ ('c26 持ち主の守りの設定へ流し込む',
181
+ 'echo x > ' + HOME + '/.claude/settings.json'),
182
+ ('c27 守りの設定を近道で指す',
183
+ 'ln -s /tmp/x ' + HOME + '/.claude/settings.json'),
184
+ ('c28 常駐の設定ごしに守りを変える', 'systemctl --user edit relay'),
185
+ ('c29 ほかの現場の守りの置き場へ書く',
186
+ 'tee ' + HOME + '/projects/other/.claude/settings.json'),
187
+ # .env 類
188
+ ('c30 雛形へ流し込む', 'echo x > ' + SITE + '/' + ENV + '.example'),
189
+ ('c31 雛形をその場で書き換える',
190
+ 'sed -i s/a/b/ ' + SITE + '/' + ENV + '.example'),
191
+ # 外への持ち出し
192
+ ('c32 秘密を含むフォルダを丸ごと写す', 'cp -r ' + SUB + ' /tmp/claude-1000/x'),
193
+ ('c33 秘密を含むフォルダを同期する', 'rsync -a ' + SUB + '/ /tmp/claude-1000/y'),
194
+ ('c34 秘密を含むフォルダを固める', 'tar cf /tmp/claude-1000/z.tar ' + SUB),
195
+ # 抜け道・保護の迂回
196
+ ('c35 保護ブランチへ直に push', 'git push origin main'),
197
+ ('c36 行き先が読めない push', 'git push'),
198
+ ('c37 全部のブランチを push', 'git push --all origin'),
199
+ ('c38 手元の検査の省略', 'git commit --no-verify -m x'),
200
+ ('c39 手元の検査の差し替え', 'git -c core.hooksPath=/tmp/h commit -m x'),
201
+ ('c40 CI の省略', 'git commit -m "x [skip ci]"'),
202
+ ('c41 秘密の値の設定', 'gh secret set X'),
203
+ ('c42 リポの削除', 'gh repo delete tyhld/x'),
204
+ ('c43 保護を迂回する合流', 'gh pr merge 1 --admin --merge'),
205
+ ('c44 API での合流', 'gh api -X PUT repos/o/r/pulls/1/merge'),
206
+ ('c45 API で保護を変える', 'gh api -X PUT repos/o/r/branches/main/protection'),
207
+ ('c46 API で先端を書き換える', 'gh api -X PATCH repos/o/r/git/refs/heads/main'),
208
+ ('c47 安全設定の省略で起こす', 'claude --dangerously-skip-permissions -p x'),
209
+ # 相互運用・転送・本番 DB
210
+ ('c48 相互運用を管理者で殻ごと開く', 'wsl.exe -u root -- bash'),
211
+ ('c49 ポート転送(行き先が手元でない)',
212
+ 'ssh -L 5432:db.example.com:5432 host'),
213
+ ('c50 行き先が読めない動的転送', 'ssh -D 1080 host'),
214
+ ('c51 中継の道具', 'socat TCP-LISTEN:5432,fork TCP:db.example.com:5432'),
215
+ ('c52 待ち受け・中継', 'nc -l 5432'),
216
+ ('c53 手元に見せかけた回り道での DB 実行',
217
+ 'ssh -L 5432:db.example.com:5432 host & psql -h 127.0.0.1 -c "select 1"'),
218
+ # 包みの中・変数ごし(経路を問わず同じ)
219
+ ('c54 包みの中で秘密を読む', 'bash -c "cat ' + SUB + '/.npm' + 'rc"'),
220
+ ('c55 変数に入れた秘密へ書く',
221
+ 'F=' + SUB + '/inner/' + ENV + '.local; echo x > "$F"'),
222
+ ]
223
+ for label, cmd in DANGER:
224
+ r = decide(cmd)
225
+ check(label, (r['decision'], kind_of(r['reason'])), ('deny', 'danger'))
226
+
227
+ # ═════════════════════════════════════════════════════════════════════════════
228
+ # (d) 秘密の読み取り … 同じ目的のほかの道具でも止める(この便で足した分を含む)
229
+ # ═════════════════════════════════════════════════════════════════════════════
230
+ print('── (d) 秘密の読み取りは道具を替えても danger ' + '─' * 22)
231
+ SECRET_READ = [
232
+ # 前から止まっていた形(1つも緩めていないことの確かめ)
233
+ ('d01 再帰の検索', G + ' -rn needle ' + SUB),
234
+ ('d02 隠しも含めて探す', RG + ' --hidden needle ' + SUB),
235
+ ('d03 無制限で探す', RG + ' -uu needle ' + SUB),
236
+ ('d04 別の道具で隠しも含めて', AG + ' --hidden needle ' + SUB),
237
+ ('d05 探す場所を書かない(作業場所に倒れる)', G + ' -rn needle'),
238
+ ('d06 包みの中で再帰の検索', 'bash -c "' + G + ' -rn needle ' + SUB + '"'),
239
+ ('d07 名前を並べて読ませる', 'find ' + SUB + ' -type f -exec cat {} +'),
240
+ # ★この便で止める側に足した形
241
+ ('d08 記録の外も含めて探す', GG + ' -n --untracked needle'),
242
+ ('d09 記録を使わず探す', GG + ' --no-index -n needle'),
243
+ ('d10 記録から外した物も含めて探す',
244
+ GG + ' --no-index --no-exclude-standard -n needle'),
245
+ ('d11 記録の外も含めて名前だけ出す', GG + ' -l --untracked needle'),
246
+ ('d12 場所を指す旗つきで記録の外も',
247
+ 'git -C ' + SITE + ' grep -n --untracked needle'),
248
+ ('d13 下の場所を名指しして記録の外も',
249
+ GG + ' -n --untracked needle -- sub'),
250
+ ('d14 包みの中で記録の外も', 'bash -c "' + GG + ' --no-index -n needle"'),
251
+ ('d15 名前を並べて別の道具へ渡す',
252
+ 'find ' + SUB + ' -type f | xargs ' + RG + ' -l needle'),
253
+ ('d16 名前を並べて別の道具へ(0 区切り)',
254
+ 'find ' + SUB + ' -type f -print0 | xargs -0 ' + RG + ' needle'),
255
+ ('d17 名前を並べた先で別の道具を呼ぶ',
256
+ 'find ' + SUB + ' -type f -exec ' + RG + ' needle {} +'),
257
+ ('d18 包みの中で名前を並べて読ませる',
258
+ 'bash -c "find ' + SUB + ' -type f -exec cat {} +"'),
259
+ ('d19 包みの中で名前を並べて渡す',
260
+ 'bash -c "find ' + SUB + ' -type f | xargs cat"'),
261
+ ('d20 変数に場所を入れて名前を並べて読ませる',
262
+ 'D=' + SUB + '; find "$D" -type f -exec cat {} +'),
263
+ ('d21 一覧を無制限で出してから読ませる',
264
+ RG + ' --files -uu ' + SUB + ' | xargs cat'),
265
+ ('d22 固めて中身を出す', 'tar cf - ' + SUB + ' | tar xOf -'),
266
+ ]
267
+ for label, cmd in SECRET_READ:
268
+ r = decide(cmd)
269
+ check(label, (r['decision'], kind_of(r['reason'])), ('deny', 'danger'))
270
+
271
+ # ═════════════════════════════════════════════════════════════════════════════
272
+ # (e) 通る側は1つも止まる側に変わらない
273
+ # ═════════════════════════════════════════════════════════════════════════════
274
+ print('── (e) 通る側(巻き込まない) ' + '─' * 36)
275
+ ALLOW = [
276
+ # 場所とファイルを名指しした検索・読み取り
277
+ ('e01 場所を名指しした再帰の検索', G + ' -rn needle ' + SITE + '/src'),
278
+ ('e02 場所を名指しした別の道具', RG + ' needle ' + SITE + '/src'),
279
+ ('e03 場所を名指しして名前だけ出す', RG + ' -l needle ' + SITE + '/src'),
280
+ ('e04 秘密を含まない場所を探す', G + ' -rn needle ' + CLEAN),
281
+ ('e05 秘密を含まない場所を別の道具で', RG + ' -l needle ' + CLEAN),
282
+ ('e06 ファイルを名指しして読む', 'cat ' + SITE + '/src/a.ts'),
283
+ ('e07 ファイルを名指しして探す', G + ' -n needle ' + SITE + '/src/a.ts'),
284
+ ('e08 記録の中を探す(追跡済みだけ)', GG + ' -n needle'),
285
+ ('e09 記録の中を場所を名指しして探す', GG + ' -n needle -- src'),
286
+ ('e10 記録の外も含めて・秘密を含まない場所を名指し',
287
+ GG + ' -n --untracked needle -- src'),
288
+ ('e11 場所を名指しした find', 'find ' + SITE + '/src -name "*.ts"'),
289
+ ('e12 名指しの場所から渡して読ませる',
290
+ 'find ' + SITE + '/src -type f -exec cat {} +'),
291
+ ('e13 名指しの場所から別の道具へ渡す',
292
+ 'find ' + CLEAN + '/deep -type f -exec ' + RG + ' -l needle {} +'),
293
+ ('e13b 名指しの場所から別の道具へ(0 区切り)',
294
+ 'find ' + CLEAN + '/deep -type f -print0 | xargs -0 ' + RG + ' needle'),
295
+ ('e13c 名指しの場所から名前を並べて読ませる',
296
+ 'find ' + CLEAN + '/deep -type f | xargs cat'),
297
+ ('e14 隠しを読まない既定の道具(秘密を含む場所でも既定は読めない)',
298
+ RG + ' -l needle ' + SUB),
299
+ # 捨て先の正しい書き方(鉄則の勧める形)
300
+ ('e15 捨て先を関数1か所に寄せた形',
301
+ 'q() { "$@" 2>' + NULL + '; }; S="$(q gh repo view --json x)"; echo "repos/$S/b"'),
302
+ ('e16 素の捨て先', 'npm root -g 2>' + NULL),
303
+ ('e17 コマンド置換の中の捨て先だけ(貼り付きなし)',
304
+ 'V="$(npm root -g 2>' + NULL + ')"; echo "$V"'),
305
+ ('e18 捨て先へ流し込む', 'make 2>&1 > ' + NULL),
306
+ # 通常の開発
307
+ ('e19 部品を入れる', 'npm install'),
308
+ ('e20 試験を流す', 'npm test'),
309
+ ('e21 ファイルを名指しして記録に入れる', 'git add src/a.ts'),
310
+ ('e22 説明を付けて記録する', 'git commit -m "fix: 直す"'),
311
+ ('e23 作業ブランチを名指しして送る', 'git push origin fix/x'),
312
+ ('e24 合流を予約する', 'gh pr merge 1 --auto --merge --delete-branch'),
313
+ ('e25 PR を作る', 'gh pr create --title x --body y'),
314
+ ('e26 CI を見る', 'gh pr checks 1'),
315
+ ('e27 使い捨ての置き場へ写す', 'cp -r ' + CLEAN + ' /tmp/claude-1000/x'),
316
+ ('e28 使い捨ての置き場を名指しで消す', 'rm -r /tmp/claude-1000/x'),
317
+ ('e29 状態を見る', 'git status --porcelain'),
318
+ ('e30 差分を対象を名指しして見る', 'git diff -- src docs'),
319
+ ]
320
+ for label, cmd in ALLOW:
321
+ r = decide(cmd)
322
+ check(label, r['decision'], 'allow')
323
+
324
+ print('── (e) 前からの作法の判定は変わらない(danger に変わっていない)' + '─' * 6)
325
+ # ★探す先を書かずに渡す形は、秘密を含まない場所でも【前から】作法で止まっている
326
+ # (この便の前後で同じ=実測で確認)。danger に変わっていないことを固定する。
327
+ _r = decide('find ' + CLEAN + '/deep -type f | xargs ' + RG + ' -l needle')
328
+ check('e31 探す先を書かずに渡す形は作法のまま',
329
+ (_r['decision'], kind_of(_r['reason'])), ('deny', 'discipline'))
330
+
331
+ # ═════════════════════════════════════════════════════════════════════════════
332
+ # (f) 貼り付きの見分けそのもの(部品の単体)
333
+ # ═════════════════════════════════════════════════════════════════════════════
334
+ print('── (f) 貼り付きの見分け ' + '─' * 42)
335
+ PARTS = [
336
+ ('f1 貼り付きあり(捨て先が無害)', NULL + ')/branches/main', (NULL, '/branches/main')),
337
+ ('f2 貼り付きあり(引用符の閉じ)', NULL + '")/x', (NULL, '/x')),
338
+ ('f3 貼り付きあり(残りが空)', NULL + ')', (NULL, '')),
339
+ ('f4 貼り付きなし(素の捨て先)', NULL, None),
340
+ ('f5 捨て先が無害でない', '/etc/hosts)/x', None),
341
+ ('f6 似て非なる名前', '/dev/sda1)/x', None),
342
+ ('f7 相対パス', 'out.log)/x', None),
343
+ ('f8 閉じが先頭', ')' + NULL, None),
344
+ ]
345
+ for label, target, want in PARTS:
346
+ check(label, policy.glued_harmless_redirect(target), want)
347
+
348
+ print()
349
+ if failures:
350
+ print(f'NG {len(failures)} 件')
351
+ for f in failures:
352
+ print(f' - {f}')
353
+ sys.exit(1)
354
+ print('すべて期待どおり')
@@ -167,22 +167,33 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
167
167
  ② **止められた理由が分からないときは、別の方法(別の命令・別の道具・別の置き場・別の写し)を試さない。**
168
168
  ③ そのときは、**止められた命令の全文と番人の文を報告して止まる**(鉄則4・人の手番)。
169
169
  ④ ★**書き方の決まりだけを指摘されて止められたときは、条件付きで書き直して続けてよい**(けいさん確定 2026-10-09 21:02)。続けてよいのは、次の4つが**すべて**そろうときだけ。
170
- - (ア) 番人が**書式上の理由と直し方を明示している**=番人の文が `discipline` で始まる種類(理由と直す形がその1行に書いてある。この種類は Bash の命令にだけ出る4つ=まとめて足す `git add`・まとめて記録に入れる `git commit`・`cd` を他の命令とつなぐ形・全体の再帰検索)。
170
+ - (ア) 番人が**書式上の理由と直し方を明示している**=番人の文が `discipline` で始まる種類(理由と直す形がその1行に書いてある。この種類は Bash の命令にだけ出る**6つ**=まとめて足す `git add`・まとめて記録に入れる `git commit`・`cd` を他の命令とつなぐ形・全体の再帰検索・**リポジトリの中の部品の置き場の下に使い捨ての写しを作る形**(便 99edd7bf)・**文句の捨て先を変数やコマンド置換の中に入れて文字列の途中へ差し込む形**(便 227aeebb))。
171
171
  - (イ) 書き直しが、元の操作の**目的・対象・権限・副作用を広げない**(やることは同じで、書き方だけを直す)。
172
172
  - (ウ) 書き直しが、**便の禁止事項に触れない**。
173
173
  - (エ) **便に停止の指示が無い**(①が先に掛かる)。
174
174
  ⑤ ★**次のどれかなら、書き直さずに止めて報告する。** 危険な操作として止められた(番人の文が `danger` で始まる種類)/**禁止の一覧・囲い(サンドボックス)・事前検査で止められた**(この3つは書き方の決まりの種類ではない)/止められた理由が分からない/(イ)(ウ) を満たすかどうか**判定できない**。
175
+ ⑤-2 ★**`danger` と出たら書き直さずに止まって報告する。書き直してよいのは `discipline` だけ**(けいさん確定 2026-10-10・便 227aeebb)。
176
+ - ★**別の道具に替えて同じ目的を果たすのも「書き直し」に当たる。** 探し方を `rg`・`git grep`・`Read` の道具へ替える/読み方を `cat` から別の道具へ替える/置き場や写し方を替える、はすべてこれに当たる。`danger` で止められた後にこれをしてはいけない(実地 便 623cfb85・833c280c・devlog 8975cfd6 がこの形だった)。
177
+ - ★**この表(常連)と、職人向けの「代わりにこう書く」は、`danger` を書き直す根拠にならない。** 表は「最初から止まらない書き方を選ぶため」の物である(④の(ア)〜(エ)がそろう `discipline` のときだけ書き直せる)。
178
+ - ★**番人が `danger` の理由に出した場所の名前が、自分が名指しした場所と違っても、番人が間違っているとは判断しない。** 名前を書かずにフォルダを読む検索は、**探す場所を読み切れないと作業場所に倒す**(番人の文に `(探す場所を書いていないので作業場所として判定)`・`(書かれた場所を読み切れないので作業場所として判定)` と出る)。止まったら報告して止まる。
175
179
  ⑥ ★**書き直して続けた場合も、報告に3つを書く。** 止められた命令の全文・番人の文・書き直した命令。
176
180
  ⑦ ★**この決まりは、過去の違反をあとから承認する物ではない**(けいさん確定 2026-10-09 21:02)。番人の判定は1つも変わらない(弱めない)。
177
181
 
178
182
  - **cd を `&&` でつなぐ**(`cd 先 && 何か`・cd とリダイレクトを同じ行に混ぜる)→ 止まる。**cd は作業のはじめに1回だけ単独で**打ち、以後は絶対パスか `git -C <実際のパス>`(鉄則2)。
179
183
  - **リポの根やホームを再帰で検索する**(`grep -rn 語 .`・`rg 語 .`・`grep -rn 語 ~`・`grep -rn 語 /home/…/リポ`)→ 止まる。★**実際に止まっているのはこの形**で、`cat .npmrc` のような直接読みではない(便 f6b9ddb6 の9回はすべて普通の再帰検索が秘密ファイルに当たった形)。**探す場所をフォルダ名で名指しする。**
180
184
  - 通る例: `grep -rn 'relay' src docs` / `rg 'relay' src docs` / 追跡済みだけ見るなら `git grep -n 'relay' -- src docs`
185
+ - ★**記録の外まで読む旗を付けた形は止まる**(`git grep --untracked`・`--no-index`・`--no-exclude-standard`)。実測で、この旗を付けると追跡していない秘密のファイルまで中身が出る(便 227aeebb)。追跡済みだけを見る素の `git grep` は今までどおり通る。
186
+ - ★**名前を並べて別の道具へ渡す形も止まる**(`find <場所> -type f -exec cat {} +`・`find <場所> | xargs rg`・包みの中に入れた同じ形)。探した場所の中に秘密のファイルが在るときだけ止まる(便 227aeebb)。
181
187
  - ★**除外指定では通らない**(実測 2026-09-27)。`grep -rn 語 . --exclude=.npmrc` は、`.` の再帰でまず止まり、さらに**秘密のファイル名を引数に書いた事自体**でも止まる。「除いて探す」ではなく「場所を名指しする」が正解。
182
188
  - ★**上の形は最初から選ぶ物。** ただし全体を指す形が**書き方の決まりで止められた**(番人の文が `discipline` で始まり、理由と直し方が書いてある)ときは、冒頭④の(ア)〜(エ)をすべて満たす限り、上の形へ書き直して続けてよい(⑥のとおり報告に3つを書く)。★**フォルダ名を名指しした形でも止められたなら、それは書き方の決まりの種類ではない**(場所を名指しした形は書き方の決まりでは止まらない)ので、探す場所や道具を替えて打ち直さず、止められた命令の全文と番人の文を報告して止まる(冒頭の①〜③と⑤・便 b53481c2 §8 の1番がこの形だった)。
183
189
  - **秘密のファイルを読む・引数に名前を書く**(`cat ~/.npmrc`・`--exclude=.npmrc`)→ 止まる。**中身は見に行かない。** 差分は対象を名指しで `git diff -- src docs`、全体で見たいときは除いて `git diff -- . ':(exclude).npmrc'`(`git diff` は中身を読み出す動詞ではないので、この形は通る・鉄則1)。
184
- - **標準エラーの捨て先を、あとで文字列の途中に差し込む変数の中に入れる**(`S="$(何か 2>/dev/null)"` と置き、別の行で `"repos/<その変数>/branches/…"` のように使う)→ 止まる。番人は変数を字面で展開してから測り直すので、捨て先が `/dev/null` ではなく**その後ろのパスが貼り付いた別の名前**として取り出され、`/dev` 直下への書き込みに見える(実測 2026-09-27。鉄則7の塊がこれで6便すべて止まっていた)。**文句を捨てる所を、小さな関数1か所に寄せる。**
190
+ - **標準エラーの捨て先を、あとで文字列の途中に差し込む変数やコマンド置換の中に入れる**(`S="$(何か 2>/dev/null)"` と置き、別の行で `"repos/<その変数>/branches/…"` のように使う/`gh api "repos/$(何か 2>/dev/null)/branches/main"` と直に書く)→ 止まる。番人は字面を展開してから測り直すので、捨て先が `/dev/null` ではなく**その後ろのパスが貼り付いた別の名前**として取り出され、`/dev` 直下への書き込みに見える(実測 2026-09-27。鉄則7の塊がこれで6便すべて止まっていた)。**文句を捨てる所を、小さな関数1か所に寄せる。**
185
191
  - 通る例: 先に `q() { "$@" 2>/dev/null; }` を置き、以後は `S="$(q 何か)"` と書く(★変数の値に捨て先が入らないので、どこに差し込んでも止まらない)。
192
+ - ★**この形の番人の文は `discipline`(書き方の注意・直し方つき)になった**(便 227aeebb・2026-10-10)。それまでは `danger: redirect into system path (/dev)` と出ており、実態(無害)と合っていなかった。**止まること自体は変わらない。**④の(ア)〜(エ)がそろう限り、上の通る例へ書き直して続けてよい(⑥のとおり報告に3つを書く)。
193
+ - ★**ただし、貼り付きの手前が `/dev/null` などの無害な捨て先でない形は `danger` のまま止まる**(`V="$(a 2>/etc/hosts)"` のような本物の書き込み/貼り付きを外しても同じ行に危険が残る形)。その場合は書き直さず報告して止まる。
194
+ - **リポジトリの中の部品の置き場の下に、使い捨ての作業用コピーを作る**(`node_modules`・`site-packages`・`.venv`・`venv` の下へ `git clone`・`cp -r`・`rsync`・`tar -x -C`・`mv`・`ln`・`mkdir` で作業用の写しや置き場を作る)→ 止まる(便 99edd7bf)。記録される場所の中に出来るので記録に混ざる危険が残り、片付け(再帰の削除)も止められて残骸になる。**使い捨ての置き場は `/tmp/claude-1000/` の下にする**(鉄則13)。
195
+ - 通る例: `git clone --no-hardlinks <リポの実在のパス> /tmp/claude-1000/karaburi-<便IDの頭8文字>`
196
+ - ★番人の文は `discipline`(書き方の注意・直し方つき)。通常の部品取得・部品の読み取り・組み立てと試験が作る控え・名指しの削除は巻き込まれない。
186
197
  - **`-f` 付き、または中身が変わる場所を指す再帰の `rm`**(`rm -rf`・`rm -fr`・`rm -r -f`・`rm -R`・`rm --recursive`/`rm -r "$DIR/x"`・`rm -r build/*` のように変数や `*` を含む)→ 止まる。`-f` 付きは配布している禁止の一覧(現場の `.claude/settings.json` の deny)で**必ず**止まる(番人より先に効く=消す先が作業ファイルでも通らない・便 fb248f6e)。変数・`*` は番人が止める。**`-f` を付けず、消す先を実在のパスで名指しする**(`/tmp/claude-1000/` の下・鉄則13)。★止められたら**別の消し方を探さず**(`find -delete`・`python -c` 等に回らない)、消せなかった場所を報告に書く(鉄則4)。
187
198
  - 通る例: `rm -r /tmp/claude-1000/作業名` / `rm -r node_modules/.tmp-作業名`(★`-f` を付けない・自分で作った物だけ)
188
199
  - ★**上の `node_modules/.tmp-作業名` は「自分が作った物を消せる」例で、使い捨ての置き場をそこへ替えてよいという意味ではない。** 置き場は `/tmp/claude-1000/`(鉄則13)。置き場の用意で止められたら、別の置き場・別の写し方へ替えず、報告して止まる(この節の冒頭の①〜③・便 b53481c2 §8 の3〜4番がこの形だった)。