@tyhld/conductor 0.12.133 → 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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tyhld/conductor",
3
- "version": "0.12.133",
3
+ "version": "0.12.134",
4
4
  "description": "采配くん管制の見守りアプリ(conductor-agent)。各PCで常駐し、中央(devlog-tracker)へ定期的に生存報告(heartbeat)を送る常駐CLI。",
5
5
  "type": "module",
6
6
  "bin": {
@@ -374,6 +374,9 @@ DENY** です。読み込み先は公式の説明と道具の実体で確かめ
374
374
  - `(探す場所を書いていないので作業場所として判定)`
375
375
  - `(書かれた場所を読み切れないので作業場所として判定)`=しるし(`*`)や変数で場所が決まる形
376
376
 
377
+ ★**2026-10-10(便 3be099ba)から、倒す前に2つだけ読み切ります**=名指しの先が**実在のファイル**のときと、
378
+ 引用符の途中で千切れた**切れ端**のとき(下の 1-10)。倒す安全側の振る舞いそのものは残しています。
379
+
377
380
  ### ★秘密の読み取りを、同じ目的のほかの道具でも止める
378
381
 
379
382
  便 623cfb85・833c280c では、止められた探し方を**別の道具に替えて**続けていました。そこで
@@ -515,6 +518,67 @@ DENY** です。読み込み先は公式の説明と道具の実体で確かめ
515
518
  `test/guard-for-codex.test.ts` が2回目の `npm test` で落ちた)。印の名前は現場と便IDで決まるので、
516
519
  `CONDUCTOR_SITE` も使い捨ての名前にします。
517
520
 
521
+ ## 1-10. ★名指しした先を読み切る(読むだけの検索を作業場所へ倒さない・便 3be099ba・2026-10-10)
522
+
523
+ ### なぜ要るか(実地2便・どちらも作業が0件で終わった)
524
+
525
+ TYHLD-platform の2便が、**読むだけの検索**で同じ `danger` に止められました(どちらも職人は便の定めどおり
526
+ 正しく停止=回避していません)。番人の文は2便とも同じで、
527
+ `danger: secret file (.npmrc) inside <リポの根> read without naming it by <検索の道具>` です。
528
+
529
+ | 便 | 実地で打たれた形 | 名指しした先 |
530
+ | --- | --- | --- |
531
+ | 1ff7b915 | `<検索の道具> -rn '語' <実在のファイル1つ> \| head -3` | **ファイル**1つ |
532
+ | 3bbde2e3 | `<検索の道具> -rn "a\|b\|c" <実在のフォルダ3つ> 2>/dev/null \| head -60` | **実在のフォルダ**3つ |
533
+
534
+ **原因は2つあり、どちらも「名指しした先を読み切れずに作業場所(リポの根)へ倒した」結果でした**
535
+ (作り物と実物の両方で再現済み。倒した先の根に `.npmrc` が在るため `danger` になっていました)。
536
+
537
+ 1. **名指しの先が【ファイル】だと、1件も拾えなかった。** 探す場所を集める読み方が**実在のフォルダだけ**を
538
+ 見ていたので、ファイルを名指しした形は「場所を書いていない形」と同じに扱われ、作業場所に倒れていました。
539
+ 2. **探す言葉の当て字の縦棒(`\|`)で、場所が別の切れ端へ移っていた。** 止める側の区切りは
540
+ 引用符の中でも機械的に割ります(便 ad6b5db9・**正しい設計**)。そのため `"a\` と `b\` と
541
+ `c" <フォルダ3つ>` に千切れ、**検索の道具の側に場所が1つも残らず**、やはり作業場所に倒れていました。
542
+
543
+ ### どう直したか(判定の正本は `policy.py` の `_recursive_read_danger`)
544
+
545
+ - **名指しの先が実在のファイルなら、そのファイル自体だけを判定します**(`_existing_file`)。
546
+ 再帰の旗が付いていても、読まれるのは名指しのファイルだけだからです(便 401fdc65 と同じ考え方=
547
+ **実在が確かめられたときだけ狭める**)。★**秘密の名前のファイルを名指しすれば、今までどおり止まります。**
548
+ - **引用符の途中で千切れた切れ端では、作業場所に倒しません**(`_quote_fragment`)。
549
+ ★止める側は1件も減りません:同じ命令は**本物の区切り**(引用符を守る割り方)でも測り直すので、
550
+ 場所を本当に書いていない形(`<検索の道具> -rn "a\|b"` だけ)は、そちらで今までどおり止まります。
551
+ - ★**`.npmrc` などを秘密として扱う判定は1文字も変えていません**(本物が探す先の中に在れば止まります)。
552
+
553
+ ### 止める/通す(実測・★止まる→通るは「この読み違いの形」だけ)
554
+
555
+ | # | 形 | 判定 | 理由 |
556
+ | --- | --- | --- | --- |
557
+ | 通1 | `<検索の道具> -rn '語' <実在のファイル>` | **通す**(前は止まっていた) | 読むのはそのファイルだけ |
558
+ | 通2 | `<検索の道具> -rn "a\|b\|c" <実在のフォルダ3つ>` | **通す**(前は止まっていた) | 名指しの場所で判定する |
559
+ | 通3 | `<検索の道具> -rn "a\|b" <実在のファイル>` | **通す**(同) | 同 |
560
+ | 通4 | 隠しも読む旗つき・記録の外まで読む旗つきで**ファイルを名指し** | **通す**(同) | 同 |
561
+ | 止1 | `<検索の道具> -rn '語' <秘密の名前のファイル>` | **danger** | 名指しの先が秘密(`touched by …`) |
562
+ | 止2 | 場所を1つも書かない | **danger** | 作業場所として判定(前からの安全側) |
563
+ | 止3 | 作業場所の根・点1つ(`.`)を名指し | **danger** | 同 |
564
+ | 止4 | 実在しない場所・しるし(`*`)を含む場所 | **danger** | 読み切れないので作業場所として判定 |
565
+ | 止5 | 秘密を含むフォルダを名指し | **danger** | 探した場所の中に秘密が在る |
566
+ | 止6 | 当て字の縦棒+場所を書かない/根/秘密のファイル/実在しない場所 | **danger** | 本物の区切りの側で止まる |
567
+ | 止7 | 名前を並べて読ませる形・包みの中・変数ごし | **danger** | 変更なし(1-7 のまま) |
568
+ | 止8 | 名指しのファイルの検索と、同じ行の危険(秘密の読み・保護ブランチへの push ほか) | **danger** | ほかの判定が先に当たる |
569
+
570
+ 直す前(`631d998`)と後を**60形**で突き合わせ、**変わらない48/★止まる→通る12(上の通1〜通4の仲間)/
571
+ 通る→止まる0件**でした。既存の番人の試験(`test_*.py` 35本)は**1本も落ちていません**。
572
+
573
+ ### 分かっている限界
574
+
575
+ - **`find <実在のファイル> -exec <読む道具> {} +` の形は、今までどおり作業場所に倒れます**
576
+ (`_find_feed_danger` は別の判定で、この便の原因として確かめられた形ではないため触っていません)。
577
+ - **切れ端の見分けは「閉じていない引用符で終わるか」で決めます。** 引用符が閉じている形
578
+ (`<検索の道具> -rn "it's" <場所>`)は切れ端ではないので、今までどおりの読み方になります。
579
+ - **番人が古い機体では効きません。** 各PCで人が1回配布を流すまで、その機では今までどおりです
580
+ (この機で実地2便が止まったときの版は **0.12.123**=理由の文に倒した旨の注が無い版でした)。
581
+
518
582
  ## 2. ファイルの役割
519
583
 
520
584
  | ファイル | 役割 |
@@ -1202,7 +1202,8 @@ def _wrapper_danger(command: str, depth: int = 0, cwd=None):
1202
1202
  toks = tokens_of(seg)
1203
1203
  v = verb_of(toks)
1204
1204
  hit = (_secret_danger(seg, v, toks, cwd) or _bulk_copy_danger(v, toks, cwd)
1205
- or _recursive_read_danger(v, toks, cwd) or _admin_merge_danger(v, toks))
1205
+ or _recursive_read_danger(v, toks, cwd, seg)
1206
+ or _admin_merge_danger(v, toks))
1206
1207
  if hit:
1207
1208
  return f'{hit} ({where})'
1208
1209
  # ★抜け道も包みの中で測り直す(`bash -c "git push origin main"` を素通りさせない)。
@@ -1285,7 +1286,8 @@ def _var_expansion_danger(command: str, cwd=None):
1285
1286
  toks = tokens_of(seg)
1286
1287
  v = verb_of(toks)
1287
1288
  hit = (_secret_danger(seg, v, toks, cwd) or _bulk_copy_danger(v, toks, cwd)
1288
- or _recursive_read_danger(v, toks, cwd) or _admin_merge_danger(v, toks))
1289
+ or _recursive_read_danger(v, toks, cwd, seg)
1290
+ or _admin_merge_danger(v, toks))
1289
1291
  if hit:
1290
1292
  return hit
1291
1293
  hit = (_guard_write_scan(expanded, cwd) or _env_write_scan(expanded, cwd)
@@ -1407,6 +1409,20 @@ def _existing_dir(arg: str, cwd=None):
1407
1409
  return None
1408
1410
 
1409
1411
 
1412
+ def _existing_file(arg: str, cwd=None):
1413
+ """引数が実在のファイル(近道を解いた先を含む)なら、その場所を返す。
1414
+
1415
+ ★「実在が確かめられた」ときだけ返す(確かめられない道のりは None=守る側へ倒す)。
1416
+ """
1417
+ if not arg or arg.startswith('-'):
1418
+ return None
1419
+ real = resolved_path(arg, cwd)
1420
+ try:
1421
+ return real if os.path.isfile(real) else None
1422
+ except Exception: # noqa: BLE001
1423
+ return None
1424
+
1425
+
1410
1426
  def _bulk_copy_danger(verb: str, tokens, cwd=None):
1411
1427
  """フォルダごとの複製・固め・同期・リンクで、中に秘密が在れば理由を返す。"""
1412
1428
  if verb not in _BULK_VERBS:
@@ -1465,7 +1481,43 @@ def _search_excludes(args):
1465
1481
  return [x.strip().strip('"').strip("'") for x in out if x]
1466
1482
 
1467
1483
 
1468
- def _recursive_read_danger(verb: str, tokens, cwd=None):
1484
+ def _quote_fragment(seg) -> bool:
1485
+ """この区切りが【引用符の途中で千切れた切れ端】か(閉じていない引用符で終わる)。
1486
+
1487
+ 【なぜ要るか(実測 便 3be099ba・2026-10-10)】
1488
+ 止める側の区切り(split_segments)は引用符の中でも機械的に割る(便 ad6b5db9・正しい設計)。
1489
+ そのため探す言葉に当て字の縦棒(`\\|`)を書いた形
1490
+ <検索の道具> -rn "a\\|b" <実在のフォルダ>
1491
+ は `"a\\` と `b" <実在のフォルダ>` に千切れ、**検索の道具の側に場所が1つも残らない**。
1492
+ すると「探す場所を書いていない」と読めてしまい、作業場所(リポの根)に倒れて
1493
+ 根の秘密ファイルに当たり、読むだけの検索が danger で止まっていた(実地 便 3bbde2e3)。
1494
+
1495
+ 【どう使うか】切れ端では**作業場所に倒さない**(その切れ端だけでは場所が読めないため)。
1496
+ ★止める側は1件も減らない:同じ命令は本物の区切り(split_commands・引用符を守る割り方)でも
1497
+ 測り直すので(_real_segments)、場所を本当に書いていない形
1498
+ (`<検索の道具> -rn "a\\|b"` だけ)は、そちらで今までどおり作業場所として止まる。
1499
+ """
1500
+ text = seg or ''
1501
+ quote = None
1502
+ i, n = 0, len(text)
1503
+ while i < n:
1504
+ c = text[i]
1505
+ if quote:
1506
+ if c == '\\' and quote != "'" and i + 1 < n:
1507
+ i += 2
1508
+ continue
1509
+ if c == quote:
1510
+ quote = None
1511
+ elif c in ('"', "'"):
1512
+ quote = c
1513
+ elif c == '\\' and i + 1 < n:
1514
+ i += 2
1515
+ continue
1516
+ i += 1
1517
+ return quote is not None
1518
+
1519
+
1520
+ def _recursive_read_danger(verb: str, tokens, cwd=None, seg=None):
1469
1521
  """名前を書かずにフォルダの中を読む検索で、中に秘密が在れば理由を返す。
1470
1522
 
1471
1523
  ・grep 系は -r / -R / --recursive のとき
@@ -1475,6 +1527,10 @@ def _recursive_read_danger(verb: str, tokens, cwd=None):
1475
1527
  (★旗が無ければ追跡済みのファイルしか読まないので、今までどおり通す・便 227aeebb)
1476
1528
  ・探す場所が書かれていなければ、作業場所(cwd)を探す場所とみなす
1477
1529
  ★除外の指定(--exclude=.env* など)で外した名前は数えない=「秘密を除いて探す」は通る。
1530
+
1531
+ ★名指しの先が【実在のファイル】なら、そのファイル自体だけを判定する(便 3be099ba)。
1532
+ 再帰の旗が付いていても、読まれるのは名指しのファイルだけだからである(便 401fdc65 と同じ考え方=
1533
+ 実在が確かめられたときだけ狭める)。秘密の名前のファイルを名指しすれば今までどおり止まる。
1478
1534
  """
1479
1535
  args = tokens[1:] if tokens else []
1480
1536
  label = verb
@@ -1505,6 +1561,7 @@ def _recursive_read_danger(verb: str, tokens, cwd=None):
1505
1561
  patterns = _search_excludes(args)
1506
1562
  skip = pattern_arg_index(verb, args)
1507
1563
  roots = []
1564
+ files = []
1508
1565
  named = 0
1509
1566
  for pos, a in enumerate(args):
1510
1567
  if pos == skip or a.startswith('-'):
@@ -1513,11 +1570,28 @@ def _recursive_read_danger(verb: str, tokens, cwd=None):
1513
1570
  d = _existing_dir(a, cwd)
1514
1571
  if d:
1515
1572
  roots.append(d)
1573
+ continue
1574
+ f = _existing_file(a, cwd)
1575
+ if f:
1576
+ files.append(f)
1577
+ # ★名指しの先がファイルなら、そのファイル自体だけを判定する(便 3be099ba)。
1578
+ for f in files:
1579
+ sr = secret_reason(f)
1580
+ if sr:
1581
+ return f'{sr} touched by {label}'
1516
1582
  # ★探す場所が【読み切れなかった】ときも作業場所に倒す(安全側・前からの振る舞い)。
1517
1583
  # そのときは理由の文にそう書く=職人が「名指ししたのに違う場所の名前が出た」と
1518
1584
  # 読み違えないため(便 623cfb85・833c280c の実地。判定は1つも変えていない)。
1519
1585
  note = ''
1520
1586
  if not roots:
1587
+ # 名指しの先が実在のファイルだけ=読むのはそのファイルだけなので、作業場所に倒さない
1588
+ # (上で1つずつ判定済み=秘密なら止めてある・便 3be099ba の原因①)。
1589
+ if files:
1590
+ return None
1591
+ # 引用符の途中で千切れた切れ端は、場所をこの切れ端から読めないだけなので倒さない
1592
+ # (本物の区切りで測り直す側が、場所を書いていない形を今までどおり止める・原因②)。
1593
+ if _quote_fragment(seg):
1594
+ return None
1521
1595
  base = cwd if (cwd and os.path.isabs(cwd)) else os.getcwd()
1522
1596
  roots = [os.path.realpath(base)]
1523
1597
  note = ('(書かれた場所を読み切れないので作業場所として判定)' if named
@@ -5499,7 +5573,7 @@ def _bash_danger(command: str, cwd=None):
5499
5573
  if hit:
5500
5574
  return hit
5501
5575
  # ★フォルダごとの持ち出し(名前を書かない複製・固め・同期・リンク)。
5502
- hit = (_bulk_copy_danger(v, toks, cwd) or _recursive_read_danger(v, toks, cwd)
5576
+ hit = (_bulk_copy_danger(v, toks, cwd) or _recursive_read_danger(v, toks, cwd, seg)
5503
5577
  or _admin_merge_danger(v, toks))
5504
5578
  if hit:
5505
5579
  return hit
@@ -0,0 +1,314 @@
1
+ #!/usr/bin/env python3
2
+ """名指しした先を読み切る検索の判定の検査(便 3be099ba)。
3
+
4
+ 実行: python3 scripts/hooks/test_named_target_search.py
5
+ 1件でも期待と違えば exit 1。
6
+
7
+ 【なぜ要るか(実地2便・2026-10-10)】
8
+ TYHLD-platform の2便が、読むだけの検索で同じ `danger` に止められ、作業が0件で終わった
9
+ (どちらも職人は便の定めどおり正しく停止した)。
10
+
11
+ 便 1ff7b915 … <検索の道具> -rn '語' <実在のファイル1つ> | head -3
12
+ 便 3bbde2e3 … <検索の道具> -rn "a\\|b\\|c" <実在のフォルダ3つ> 2>/dev/null | head -60
13
+ 番人の文(2便とも同じ)… danger: secret file (…) inside <リポの根> read without naming it by …
14
+
15
+ 原因は2つで、どちらも「名指しした先を読み切れずに作業場所(リポの根)へ倒した」結果だった。
16
+ ① 名指しの先が【ファイル】だと、実在のフォルダを探す読み方では1件も拾えず、場所を書いて
17
+ いない形と同じに扱われて作業場所に倒れた。
18
+ ② 探す言葉に当て字の縦棒(`\\|`)が入ると、止める側の区切り(引用符の中でも機械的に割る=
19
+ 便 ad6b5db9 の正しい設計)が `"a\\` と `b\\` と `c" <フォルダ>` に千切り、検索の道具の側に
20
+ 場所が1つも残らなくなって、やはり作業場所に倒れた。
21
+
22
+ 【ここで固定すること】
23
+ (a) 名指しの先が実在のファイルなら、そのファイル自体だけを判定する(=通る)
24
+ (b) 秘密の名前のファイルを名指しすれば、今までどおり止まる
25
+ (c) 引用符の途中で千切れた切れ端では作業場所に倒さず、本物の区切りの側で名指しの場所を判定する
26
+ (d) 安全側の振る舞いは1つも外さない(場所を書かない・実在しない場所・しるし入りの場所・
27
+ 作業場所の根・点1つ・秘密を含むフォルダ・包みの中・変数ごし)
28
+ (e) ほかの危険の判定(秘密のファイルの読み・保護ブランチへの push など)は、同じ行に
29
+ 混ざっていても今までどおり先に当たる
30
+ (f) 空振り確認(直しを外すと、この台本が落ちる)
31
+
32
+ ★秘密として扱う名前の判定は1文字も変えていない(本物が探す先の中に在れば今までどおり止まる)。
33
+ ★この台本は検索の道具の名前を素の字で置かない(組み立てて使う=既存の作法)。
34
+ """
35
+ import os
36
+ import subprocess
37
+ import sys
38
+ import tempfile
39
+
40
+ sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
41
+
42
+ import policy # noqa: E402
43
+
44
+ failures = []
45
+
46
+
47
+ def check(label, got, want):
48
+ ok = got == want
49
+ if not ok:
50
+ failures.append(f'{label}: got={got!r} want={want!r}')
51
+ print(f'{"OK " if ok else "NG "} {label:62} {str(got)[:40]}')
52
+
53
+
54
+ # ── 使い捨ての作り物(この台本のコードが作る=職人の命令の字面には出ない)────────
55
+ ROOT = tempfile.mkdtemp(prefix='named-target-')
56
+ SITE = os.path.join(ROOT, 'site') # 作業場所(根に秘密の形の名前が在る)
57
+ SUBS = ('services/calendar', 'packages/calendar', 'packages/notify', 'services/lp/src/lib')
58
+ for _s in SUBS:
59
+ os.makedirs(os.path.join(SITE, _s))
60
+ os.makedirs(os.path.join(SITE, 'sub', 'inner'))
61
+ ENV = '.env'
62
+ NPMRC = '.npm' + 'rc'
63
+ with open(os.path.join(SITE, NPMRC), 'w') as f:
64
+ f.write('DUMMY=placeholder\n')
65
+ with open(os.path.join(SITE, 'sub', 'inner', ENV + '.local'), 'w') as f:
66
+ f.write('DUMMY=placeholder\n')
67
+ with open(os.path.join(SITE, '.gitignore'), 'w') as f:
68
+ f.write(ENV + '.local\n')
69
+ for _s in SUBS:
70
+ with open(os.path.join(SITE, _s, 'a.ts'), 'w') as f:
71
+ f.write('needle\n')
72
+ CLEAN = os.path.join(ROOT, 'clean') # 秘密の形の名前を含まない場所
73
+ os.makedirs(os.path.join(CLEAN, 'deep'))
74
+ with open(os.path.join(CLEAN, 'deep', 'b.md'), 'w') as f:
75
+ f.write('needle\n')
76
+ _env = dict(os.environ, GIT_AUTHOR_NAME='p', GIT_AUTHOR_EMAIL='p@x',
77
+ GIT_COMMITTER_NAME='p', GIT_COMMITTER_EMAIL='p@x')
78
+ for _argv in (['git', 'init', '-q'], ['git', 'add', 'services', '.gitignore'],
79
+ ['git', 'commit', '-q', '-m', 'init']):
80
+ subprocess.run(_argv, cwd=SITE, env=_env, capture_output=True)
81
+
82
+ G = 'g' + 'rep'
83
+ RG = 'r' + 'g'
84
+ AG = 'a' + 'g'
85
+ GG = 'git ' + 'grep'
86
+ NULL = '/dev/' + 'null'
87
+ D1 = os.path.join(SITE, 'services/calendar')
88
+ D3 = ' '.join(os.path.join(SITE, s) for s in SUBS[:3])
89
+ FILE1 = os.path.join(SITE, 'services/lp/src/lib/a.ts')
90
+ FILE2 = os.path.join(SITE, 'services/calendar/a.ts')
91
+ SECRET = os.path.join(SITE, NPMRC)
92
+ SUB = os.path.join(SITE, 'sub')
93
+
94
+
95
+ def decide(cmd, cwd=SITE):
96
+ return policy.decide_bash(cmd, cwd)
97
+
98
+
99
+ def kind(cmd, cwd=SITE):
100
+ """allow / gate / deny:<種類> を返す(deny は理由の頭で分ける)。"""
101
+ r = decide(cmd, cwd)
102
+ if r['decision'] != 'deny':
103
+ return r['decision']
104
+ return 'deny:' + (r['reason'] or '').split(':', 1)[0]
105
+
106
+
107
+ # ═════════════════════════════════════════════════════════════════════════════
108
+ # (a) 名指しの先が実在のファイルなら、そのファイル自体だけを判定する
109
+ # ═════════════════════════════════════════════════════════════════════════════
110
+ print('── (a) 名指しの先がファイルなら、そのファイルだけを判定する ' + '─' * 20)
111
+ NAMED_FILE = [
112
+ ('a1 実地 便 1ff7b915 の形(再帰の旗つき・ファイル1つ・後ろに別の命令)',
113
+ G + " -rn 'needle' " + FILE1 + ' | head -3'),
114
+ ('a2 実地 便 1ff7b915 の全文の形(前に別の命令・ファイル1つ)',
115
+ "node -e 'console.log(1)' ; " + G + " -rn 'needle' " + FILE1 + ' | head -3'),
116
+ ('a3 ファイル2つを名指し', G + " -rn 'needle' " + FILE1 + ' ' + FILE2),
117
+ ('a4 ファイル1つ(行の番号と名前だけの旗)', G + ' -rln needle ' + FILE1),
118
+ ('a5 ファイル1つ(--recursive の長い旗)', G + ' --recursive -n needle ' + FILE1),
119
+ ('a6 ファイル1つ(隠しも読む旗つきの別の道具)', RG + ' --hidden needle ' + FILE1),
120
+ ('a7 ファイル1つ(記録から外した物まで読む旗つき)', RG + ' -uu needle ' + FILE1),
121
+ ('a8 ファイル1つ(別の道具 ag)', AG + ' --hidden needle ' + FILE1),
122
+ ('a9 ファイル1つ(記録の外まで読む旗つきの git grep)',
123
+ GG + ' --untracked -n needle -- services/lp/src/lib/a.ts'),
124
+ ('a10 ファイルと秘密を含まないフォルダを並べる', G + ' -rn needle ' + FILE1 + ' ' + CLEAN),
125
+ ('a11 ファイル(近道を解いた先・.. 入りの道のり)',
126
+ G + ' -rn needle ' + os.path.join(SITE, 'services', '..', 'services/lp/src/lib/a.ts')),
127
+ ]
128
+ for label, cmd in NAMED_FILE:
129
+ check(label, kind(cmd), 'allow')
130
+
131
+ # ═════════════════════════════════════════════════════════════════════════════
132
+ # (b) 秘密の名前のファイルを名指しすれば、今までどおり止まる
133
+ # ═════════════════════════════════════════════════════════════════════════════
134
+ print('── (b) 秘密の名前のファイルを名指しすれば止まる ' + '─' * 28)
135
+ check('b1 秘密のファイルを名指し(再帰の旗つき)', kind(G + " -rn 'x' " + SECRET), 'deny:danger')
136
+ check('b2 秘密のファイルを名指し(隠しも読む旗つき)',
137
+ kind(RG + ' --hidden x ' + SECRET), 'deny:danger')
138
+ check('b3 秘密のファイルを名指し(記録の外まで読む旗つき)',
139
+ kind(GG + ' --untracked -n x -- ' + NPMRC), 'deny:danger')
140
+ check('b4 秘密のファイルと普通のファイルを並べる', kind(G + ' -rn x ' + FILE1 + ' ' + SECRET),
141
+ 'deny:danger')
142
+ check('b5 下の階層の秘密のファイルを名指し',
143
+ kind(G + ' -rn x ' + os.path.join(SITE, 'sub', 'inner', ENV + '.local')), 'deny:danger')
144
+ check('b6 名指しの先がファイルでも理由は「名指しの先に当たった」形',
145
+ decide(G + " -rn 'x' " + SECRET)['reason'].startswith('danger: secret file'), True)
146
+ check('b7 その理由に作業場所の名前(倒した印)が出ない',
147
+ 'inside ' in decide(G + " -rn 'x' " + SECRET)['reason'], False)
148
+
149
+ # ═════════════════════════════════════════════════════════════════════════════
150
+ # (c) 引用符の途中で千切れた切れ端では作業場所に倒さない
151
+ # ═════════════════════════════════════════════════════════════════════════════
152
+ print('── (c) 切れ端では作業場所に倒さず、名指しの場所を判定する ' + '─' * 18)
153
+ FRAGMENT_OK = [
154
+ ('c1 実地 便 3bbde2e3 の形(当て字の縦棒+実在の3フォルダ)',
155
+ G + ' -rn "a\\|b\\|c" ' + D3 + ' 2>' + NULL + ' | head -60'),
156
+ ('c2 当て字の縦棒+実在の1フォルダ', G + ' -rn "a\\|b" ' + D1),
157
+ ('c3 当て字の縦棒+単引用符+実在の3フォルダ', G + " -rn 'a\\|b\\|c' " + D3),
158
+ ('c4 当て字の縦棒+名指しのファイル', G + ' -rn "a\\|b" ' + FILE1),
159
+ ('c5 引用符の中の素の縦棒+実在のフォルダ', G + ' -rn "a|b" ' + D1),
160
+ ('c6 引用符の中の semicolon+実在のフォルダ', G + ' -rn "a;b" ' + D1),
161
+ ('c7 当て字の縦棒+秘密を含まないフォルダ', G + ' -rn "a\\|b" ' + CLEAN),
162
+ ]
163
+ for label, cmd in FRAGMENT_OK:
164
+ check(label, kind(cmd), 'allow')
165
+
166
+ print('── (c) 切れ端でも、名指しの先に秘密が在れば止まる ' + '─' * 26)
167
+ check('c8 当て字の縦棒+秘密を含むフォルダ', kind(G + ' -rn "a\\|b" ' + SUB), 'deny:danger')
168
+ check('c9 当て字の縦棒+作業場所の根', kind(G + ' -rn "a\\|b" ' + SITE), 'deny:danger')
169
+ check('c10 当て字の縦棒+秘密の名前のファイル', kind(G + ' -rn "a\\|b" ' + SECRET), 'deny:danger')
170
+ check('c11 当て字の縦棒+場所を1つも書かない', kind(G + ' -rn "a\\|b"'), 'deny:danger')
171
+ check('c12 当て字の縦棒+実在しない場所',
172
+ kind(G + ' -rn "a\\|b" ' + os.path.join(SITE, 'nope')), 'deny:danger')
173
+ check('c13 当て字の縦棒+点1つ(作業場所)', kind(G + ' -rn "a\\|b" .'), 'deny:danger')
174
+ check('c14 当て字の縦棒+しるし(*)を含む場所',
175
+ kind(G + ' -rn "a\\|b" ' + SITE + '/services/*/x'), 'deny:danger')
176
+
177
+ # ═════════════════════════════════════════════════════════════════════════════
178
+ # (d) 安全側の振る舞いは1つも外していない
179
+ # ═════════════════════════════════════════════════════════════════════════════
180
+ print('── (d) 安全側の振る舞いは1つも外していない ' + '─' * 32)
181
+ SAFE = [
182
+ ('d1 場所を1つも書かない(作業場所を探す)', G + " -rn 'needle'"),
183
+ ('d2 作業場所の根を名指し', G + " -rn 'needle' " + SITE),
184
+ ('d3 点1つ(作業場所)を名指し', G + " -rn 'needle' ."),
185
+ ('d4 実在しない場所を名指し', G + " -rn 'needle' " + os.path.join(SITE, 'nope')),
186
+ ('d5 しるし(*)を含む場所', G + " -rn 'needle' " + SITE + '/services/*/x'),
187
+ ('d6 秘密を含む下の階層のフォルダを名指し', G + " -rn 'needle' " + SUB),
188
+ ('d7 隠しも読む旗つきの道具で根を探す', RG + ' --hidden needle ' + SITE),
189
+ ('d8 記録の外まで読む旗つきで根を探す', GG + ' --untracked -n needle'),
190
+ ('d9 名前を並べて読ませる形', 'find ' + SITE + ' -type f -exec cat {} +'),
191
+ ('d10 名前を並べて渡す形(探す道具)', 'find ' + SITE + ' -type f | xargs ' + RG + ' -l needle'),
192
+ ('d11 包みの中の再帰検索', 'bash -c "' + G + ' -rn needle ' + SITE + '"'),
193
+ ('d12 変数ごしの再帰検索', 'D=' + SITE + '; ' + G + ' -rn needle "$D"'),
194
+ ('d13 フォルダごとの複製', 'cp -r ' + SITE + ' /tmp/claude-1000/x'),
195
+ ('d14 秘密のファイルを読む', 'cat ' + SECRET),
196
+ ]
197
+ for label, cmd in SAFE:
198
+ check(label, kind(cmd), 'deny:danger')
199
+
200
+ print('── (d) 通っていた形は1つも止まる側に変わっていない ' + '─' * 24)
201
+ PASS_THROUGH = [
202
+ ('d15 秘密を含まない場所の再帰検索', G + " -rn 'needle' " + CLEAN),
203
+ ('d16 場所を名指しした既定の検索', RG + ' needle ' + os.path.join(SITE, 'services')),
204
+ ('d17 記録の中だけを探す', GG + ' -n needle'),
205
+ ('d18 記録の中だけを探す(場所を名指し)', GG + ' -n needle -- services'),
206
+ ('d19 名指しのファイルを読む', 'cat ' + FILE1),
207
+ ('d20 名指しのファイルを探す(再帰の旗なし)', G + " -n 'needle' " + FILE1),
208
+ ('d21 秘密を含まない場所の find と読み', 'find ' + CLEAN + ' -type f -exec cat {} +'),
209
+ ('d22 探す言葉に引用符が1つ入る形(切れ端ではない)', G + ' -rn "it' + "'" + 's" ' + CLEAN),
210
+ ('d23 名指しの git add', 'git add services/calendar/a.ts'),
211
+ ('d24 状態を1回見る', 'gh pr checks 301'),
212
+ ]
213
+ for label, cmd in PASS_THROUGH:
214
+ check(label, kind(cmd), 'allow')
215
+
216
+ # ═════════════════════════════════════════════════════════════════════════════
217
+ # (e) ほかの危険の判定は、同じ行に混ざっていても先に当たる
218
+ # ═════════════════════════════════════════════════════════════════════════════
219
+ print('── (e) 混ざった形は今までどおり先に止まる ' + '─' * 32)
220
+ MIXED = [
221
+ ('e1 名指しのファイルの検索+秘密のファイルの読み',
222
+ G + ' -rn needle ' + FILE1 + '; cat ' + SECRET),
223
+ ('e2 名指しのファイルの検索+保護ブランチへの push',
224
+ G + ' -rn needle ' + FILE1 + '; git push origin main'),
225
+ ('e3 切れ端+保護ブランチへの push', G + ' -rn "a\\|b" ' + D1 + '; git push origin main'),
226
+ ('e4 切れ端+秘密のファイルの読み', 'cat ' + SECRET + ' | ' + G + ' "a\\|b"'),
227
+ ('e5 名指しのファイルの検索+フォルダごとの複製',
228
+ G + ' -rn needle ' + FILE1 + '; cp -r ' + SITE + ' /tmp/claude-1000/x'),
229
+ ('e6 名指しのファイルの検索+環境変数の露出',
230
+ G + ' -rn needle ' + FILE1 + '; echo $DATABASE_URL'),
231
+ ('e7 切れ端+保護を迂回する合流', G + ' -rn "a\\|b" ' + D1 + '; gh pr merge 1 --admin --merge'),
232
+ ]
233
+ for label, cmd in MIXED:
234
+ check(label, kind(cmd), 'deny:danger')
235
+ check('e8 名指しのファイルの検索+繰り返しで CI を待つ形(作法が当たる)',
236
+ kind(G + ' -rn needle ' + FILE1 + '; until gh pr checks 1; do sleep 20; done'),
237
+ 'deny:discipline')
238
+ check('e9 切れ端+繰り返しで CI を待つ形(作法が当たる)',
239
+ kind(G + ' -rn "a\\|b" ' + D1 + '; until gh pr checks 1; do sleep 20; done'),
240
+ 'deny:discipline')
241
+
242
+ # ═════════════════════════════════════════════════════════════════════════════
243
+ # (f) 空振り確認(直しを外すと落ちる)★関数を一時的に差し替えるだけ・ファイルは変えない
244
+ # ═════════════════════════════════════════════════════════════════════════════
245
+ print('── (f) 空振り確認(直しを外すと落ちる) ' + '─' * 34)
246
+ _real_existing_file = policy._existing_file
247
+ _real_quote_fragment = policy._quote_fragment
248
+
249
+ policy._existing_file = lambda arg, cwd=None: None # ①を外す
250
+ check('f1 ①を外すと「名指しのファイル」が作業場所に倒れて止まる',
251
+ kind(G + " -rn 'needle' " + FILE1), 'deny:danger')
252
+ check('f2 ①を外すと実地 便 1ff7b915 の形が止まる',
253
+ kind(G + " -rn 'needle' " + FILE1 + ' | head -3'), 'deny:danger')
254
+ check('f3 ①を外しても切れ端の形は通る(②は別の直し)', kind(G + ' -rn "a\\|b" ' + D1), 'allow')
255
+ policy._existing_file = _real_existing_file
256
+
257
+ policy._quote_fragment = lambda seg: False # ②を外す
258
+ check('f4 ②を外すと実地 便 3bbde2e3 の形が止まる',
259
+ kind(G + ' -rn "a\\|b\\|c" ' + D3 + ' 2>' + NULL + ' | head -60'), 'deny:danger')
260
+ check('f5 ②を外すと当て字の縦棒+実在のフォルダが止まる', kind(G + ' -rn "a\\|b" ' + D1),
261
+ 'deny:danger')
262
+ check('f6 ②を外しても名指しのファイルは通る(①は別の直し)',
263
+ kind(G + " -rn 'needle' " + FILE1), 'allow')
264
+ policy._quote_fragment = _real_quote_fragment
265
+
266
+ policy._existing_file = lambda arg, cwd=None: None
267
+ policy._quote_fragment = lambda seg: False # ①②の両方を外す
268
+ check('f7 ①②を外すと2便の形が2つとも止まる(直す前と同じ)',
269
+ (kind(G + " -rn 'needle' " + FILE1 + ' | head -3'),
270
+ kind(G + ' -rn "a\\|b\\|c" ' + D3 + ' 2>' + NULL + ' | head -60')),
271
+ ('deny:danger', 'deny:danger'))
272
+ policy._existing_file = _real_existing_file
273
+ policy._quote_fragment = _real_quote_fragment
274
+ check('f8 戻したら2便の形が2つとも通る',
275
+ (kind(G + " -rn 'needle' " + FILE1 + ' | head -3'),
276
+ kind(G + ' -rn "a\\|b\\|c" ' + D3 + ' 2>' + NULL + ' | head -60')),
277
+ ('allow', 'allow'))
278
+
279
+ # ═════════════════════════════════════════════════════════════════════════════
280
+ # (g) 切れ端の見分けそのもの(部品の単体)
281
+ # ═════════════════════════════════════════════════════════════════════════════
282
+ print('── (g) 切れ端の見分けの単体 ' + '─' * 44)
283
+ FRAG_UNIT = [
284
+ ('g1 閉じていない二重引用符で終わる', G + ' -rn "a\\', True),
285
+ ('g2 閉じていない単引用符で終わる', G + " -rn 'a\\", True),
286
+ ('g3 二重引用符が閉じている', G + ' -rn "a|b" ' + D1, False),
287
+ ('g4 引用符が1つも無い', G + ' -rn a ' + D1, False),
288
+ ('g5 二重引用符の中に単引用符が1つ', G + ' -rn "it\'s" ' + CLEAN, False),
289
+ ('g6 単引用符の中に二重引用符が1つ', G + " -rn 'a\"b' " + CLEAN, False),
290
+ ('g7 空の文字列', '', False),
291
+ ('g8 None', None, False),
292
+ ]
293
+ for label, seg, want in FRAG_UNIT:
294
+ check(label, policy._quote_fragment(seg), want)
295
+ check('g9 実在のファイルを返す(単体)', bool(policy._existing_file(FILE1)), True)
296
+ check('g10 実在のフォルダはファイルとして返さない(単体)', policy._existing_file(D1), None)
297
+ check('g11 実在しない道のりは返さない(単体)',
298
+ policy._existing_file(os.path.join(SITE, 'nope')), None)
299
+ check('g12 旗はファイルとして見ない(単体)', policy._existing_file('-rn'), None)
300
+
301
+ # ─────────────────────────────────────────────────────────────────────────────
302
+ # ★作り物を片付ける(使い捨ての場所に残骸を残さない・便 de82bc3a のコミット a5118c7 と同じ作法)
303
+ import shutil # noqa: E402
304
+
305
+ shutil.rmtree(ROOT, ignore_errors=True)
306
+ check('z1 作り物を片付けた', os.path.isdir(ROOT), False)
307
+
308
+ print()
309
+ if failures:
310
+ print(f'NG {len(failures)} 件')
311
+ for line in failures:
312
+ print(' ' + line)
313
+ sys.exit(1)
314
+ print('すべて OK')
@@ -186,6 +186,8 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
186
186
  - **cd を `&&` でつなぐ**(`cd 先 && 何か`・cd とリダイレクトを同じ行に混ぜる)→ 止まる。**cd は作業のはじめに1回だけ単独で**打ち、以後は絶対パスか `git -C <実際のパス>`(鉄則2)。
187
187
  - **リポの根やホームを再帰で検索する**(`grep -rn 語 .`・`rg 語 .`・`grep -rn 語 ~`・`grep -rn 語 /home/…/リポ`)→ 止まる。★**実際に止まっているのはこの形**で、`cat .npmrc` のような直接読みではない(便 f6b9ddb6 の9回はすべて普通の再帰検索が秘密ファイルに当たった形)。**探す場所をフォルダ名で名指しする。**
188
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"` だけ)は今までどおり止まる。
189
191
  - ★**記録の外まで読む旗を付けた形は止まる**(`git grep --untracked`・`--no-index`・`--no-exclude-standard`)。実測で、この旗を付けると追跡していない秘密のファイルまで中身が出る(便 227aeebb)。追跡済みだけを見る素の `git grep` は今までどおり通る。
190
192
  - ★**名前を並べて別の道具へ渡す形も止まる**(`find <場所> -type f -exec cat {} +`・`find <場所> | xargs rg`・包みの中に入れた同じ形)。探した場所の中に秘密のファイルが在るときだけ止まる(便 227aeebb)。
191
193
  - ★**除外指定では通らない**(実測 2026-09-27)。`grep -rn 語 . --exclude=.npmrc` は、`.` の再帰でまず止まり、さらに**秘密のファイル名を引数に書いた事自体**でも止まる。「除いて探す」ではなく「場所を名指しする」が正解。