@tyhld/conductor 0.12.135 → 0.12.137

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.
@@ -0,0 +1,339 @@
1
+ #!/usr/bin/env python3
2
+ """探す言葉をパスとして測らない判定の検査(便 18e9e32e)。
3
+
4
+ 実行: python3 scripts/hooks/test_search_word_not_path.py
5
+ 1件でも期待と違えば exit 1。
6
+
7
+ 【なぜ要るか(実地 便 3f54ac4a・2026-10-10)】
8
+ 名指しした普通の TypeScript 1ファイルを読むだけの検索が danger で止められ、便が作業0件で終わった
9
+ (職人は便の定めどおり正しく停止した)。0.12.133 から danger の後は便の残りが止まるので、
10
+ 読み違い1回で便が丸ごと止まる。
11
+
12
+ 止められた形 … <検索の道具> -n 'env: <.env で終わって見える語>\\|home:\\|…' <名指しのファイル> | head -20
13
+ 番人の文 … danger: secret file (<その語>) touched by <検索の道具>
14
+
15
+ 原因は2つで、どちらも「探す言葉(検索の語)をパスとして測った」結果だった。
16
+ ① 探す言葉に【空白】と【当て字の縦棒】の両方が入ると、止める側の区切り(引用符の中でも
17
+ 機械的に割る=便 ad6b5db9 の正しい設計)が切れ端を作り、クォートが壊れた切れ端では
18
+ tokens_of が素朴分割へ倒れて【1つの探す言葉が2語以上に割れる】。旧い読み方は最初の1語だけを
19
+ 探す文字として外していたので、2語目以降がパスとして測られた。
20
+ ② -e / --regexp で探す言葉を明示すると、旧い読み方は「最初の引数はパス」と読むために
21
+ 1つも外さず、【-e の値そのもの】(=探す言葉)までパスとして測られた。
22
+
23
+ 【ここで固定すること】
24
+ (a) ①の形(空白+当て字の縦棒)は通る
25
+ (b) ②の形(-e / --regexp の値)は通る
26
+ (c) 秘密を名指しした読みは今までどおり止まる(探す言葉の外し方は、名指しのパスを1つも外さない)
27
+ (d) 安全側の振る舞いは1つも外さない(場所を書かない・倒す判定・-f の値はパス)
28
+ (e) ほかの危険の判定は、同じ行に混ざっていても今までどおり当たる
29
+ (f) 探す言葉の【途中】に引用符が1つ入る形で、名指しの場所を探す言葉と見なさない
30
+ (g) 部品の単体(探す文字の位置・開いたままの引用符・探す言葉の語の広がり)
31
+ (h) 空振り確認(直しを外すと、この台本が落ちる)
32
+
33
+ ★秘密として扱う名前の判定・読み書き持ち出しの動詞の一覧は1文字も変えていない。
34
+ ★この台本は検索の道具の名前と秘密の名前を素の字で置かない(組み立てて使う=既存の作法)。
35
+ """
36
+ import os
37
+ import subprocess
38
+ import sys
39
+ import tempfile
40
+
41
+ sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
42
+
43
+ import policy # noqa: E402
44
+
45
+ failures = []
46
+
47
+
48
+ def check(label, got, want):
49
+ ok = got == want
50
+ if not ok:
51
+ failures.append(f'{label}: got={got!r} want={want!r}')
52
+ print(f'{"OK " if ok else "NG "} {label:62} {str(got)[:40]}')
53
+
54
+
55
+ # ── 使い捨ての作り物(この台本のコードが作る=職人の命令の字面には出ない)────────
56
+ ROOT = tempfile.mkdtemp(prefix='search-word-')
57
+ SITE = os.path.join(ROOT, 'site') # 作業場所(根に秘密の形の名前が在る)
58
+ os.makedirs(os.path.join(SITE, 'src'))
59
+ os.makedirs(os.path.join(SITE, 'clean', 'deep'))
60
+ ENV = '.env'
61
+ NPMRC = '.npm' + 'rc'
62
+ with open(os.path.join(SITE, NPMRC), 'w') as f:
63
+ f.write('DUMMY=placeholder\n')
64
+ for _p in (('src', 'selfcheck.ts'), ('src', 'other.ts'), ('clean', 'deep', 'b.md')):
65
+ with open(os.path.join(SITE, *_p), 'w') as f:
66
+ f.write('needle\n')
67
+ _env = dict(os.environ, GIT_AUTHOR_NAME='p', GIT_AUTHOR_EMAIL='p@x',
68
+ GIT_COMMITTER_NAME='p', GIT_COMMITTER_EMAIL='p@x')
69
+ for _argv in (['git', 'init', '-q'], ['git', 'add', 'src'], ['git', 'commit', '-q', '-m', 'init']):
70
+ subprocess.run(_argv, cwd=SITE, env=_env, capture_output=True)
71
+
72
+ G = 'g' + 'rep'
73
+ RG = 'r' + 'g'
74
+ AG = 'a' + 'g'
75
+ GG = 'git ' + 'grep'
76
+ NULL = '/dev/' + 'null'
77
+ #: 探す言葉に混ざる「.env で終わって見える語」(★パスではない・コードの書き方を調べる語)。
78
+ WORD = 'process' + ENV
79
+ FILE1 = os.path.join(SITE, 'src', 'selfcheck.ts')
80
+ FILE2 = os.path.join(SITE, 'src', 'other.ts')
81
+ SECRET = os.path.join(SITE, NPMRC)
82
+ CLEAN = os.path.join(SITE, 'clean')
83
+
84
+
85
+ def kind(cmd, cwd=SITE):
86
+ """allow / gate / deny:<種類> を返す(deny は理由の頭で分ける)。"""
87
+ r = policy.decide_bash(cmd, cwd)
88
+ if r['decision'] != 'deny':
89
+ return r['decision']
90
+ return 'deny:' + (r['reason'] or '').split(':', 1)[0]
91
+
92
+
93
+ def reason(cmd, cwd=SITE):
94
+ return policy.decide_bash(cmd, cwd).get('reason') or ''
95
+
96
+
97
+ # ═════════════════════════════════════════════════════════════════════════════
98
+ # (a) ①の形(空白+当て字の縦棒で探す言葉が割れる)は通る
99
+ # ═════════════════════════════════════════════════════════════════════════════
100
+ print('── (a) 空白+当て字の縦棒で割れた探す言葉を、パスとして測らない ' + '─' * 10)
101
+ SPLIT_WORD = [
102
+ ('a1 実地 便 3f54ac4a の形(4つの当て字の縦棒・名指しのファイル・後ろに別の命令)',
103
+ G + " -n 'env: " + WORD + "\\|home:\\|defaultDeps\\|export function selfcheckDeps' "
104
+ + FILE1 + ' | head -20'),
105
+ ('a2 最小の形(当て字の縦棒1つ・名指しのファイル)',
106
+ G + " -n 'env: " + WORD + "\\|home:' " + FILE1),
107
+ ('a3 二重引用符', G + ' -n "env: ' + WORD + '\\|home:" ' + FILE1),
108
+ ('a4 名指しのフォルダ(再帰の旗つき)', G + " -rn 'env: " + WORD + "\\|home:' " + CLEAN),
109
+ ('a5 素の縦棒(当て字でない)', G + " -n 'env: " + WORD + "|home:' " + FILE1),
110
+ ('a6 語が探す言葉の真ん中(空白が2つ)', G + " -n 'a " + WORD + " b\\|c' " + FILE1),
111
+ ('a7 隠しも読む旗つきの別の道具', RG + " --hidden 'env: " + WORD + "\\|home:' " + FILE1),
112
+ ('a8 別の道具 ag', AG + " --hidden 'env: " + WORD + "\\|home:' " + FILE1),
113
+ ('a9 ファイル2つを名指し', G + " -n 'env: " + WORD + "\\|home:' " + FILE1 + ' ' + FILE2),
114
+ ('a10 文句を捨てる形と一緒', G + " -n 'env: " + WORD + "\\|home:' " + FILE1 + ' 2>' + NULL),
115
+ ('a11 当て字の縦棒が3つ(語は2つ目の後ろ)',
116
+ G + " -n 'a b\\|c " + WORD + "\\|d e' " + FILE1),
117
+ ]
118
+ for label, cmd in SPLIT_WORD:
119
+ check(label, kind(cmd), 'allow')
120
+
121
+ # ═════════════════════════════════════════════════════════════════════════════
122
+ # (b) ②の形(-e / --regexp の値は探す言葉)は通る
123
+ # ═════════════════════════════════════════════════════════════════════════════
124
+ print('── (b) -e / --regexp の値を、パスとして測らない ' + '─' * 26)
125
+ PATTERN_FLAG = [
126
+ ('b1 実地の形(-e を2つ・名指しのファイル)',
127
+ G + " -n -e 'env: " + WORD + "' -e 'home:' " + FILE1),
128
+ ('b2 -e を1つ', G + " -n -e 'env: " + WORD + "' " + FILE1),
129
+ ('b3 -e の値が1語(空白なし)', G + ' -n -e ' + WORD + ' ' + FILE1),
130
+ ('b4 --regexp= に埋め込む', G + " -n --regexp='env: " + WORD + "' " + FILE1),
131
+ ('b5 --regexp 旗と値', G + " -n --regexp 'env: " + WORD + "' " + FILE1),
132
+ ('b6 -e +再帰の旗つき・名指しのフォルダ', G + ' -rn -e ' + WORD + ' ' + CLEAN),
133
+ ('b7 -e +隠しも読む旗つきの別の道具', RG + ' --hidden -e ' + WORD + ' ' + FILE1),
134
+ ('b8 -e を3つ', G + ' -n -e a -e ' + WORD + ' -e b ' + FILE1),
135
+ ('b9 -e の値に当て字の縦棒(切れ端にもなる形)',
136
+ G + " -n -e 'a " + WORD + "\\|b' " + FILE1),
137
+ ]
138
+ for label, cmd in PATTERN_FLAG:
139
+ check(label, kind(cmd), 'allow')
140
+
141
+ # ═════════════════════════════════════════════════════════════════════════════
142
+ # (c) 秘密を名指しした読みは今までどおり止まる(名指しのパスは1つも外さない)
143
+ # ═════════════════════════════════════════════════════════════════════════════
144
+ print('── (c) 秘密を名指しした読みは今までどおり止まる ' + '─' * 28)
145
+ STILL_DENY = [
146
+ ('c1 秘密のファイルを名指し', G + " -n 'x' " + SECRET),
147
+ ('c2 秘密のファイルを名指し(再帰の旗つき)', G + " -rn 'x' " + SECRET),
148
+ ('c3 -e つきで秘密のファイルを名指し', G + " -n -e 'x' " + SECRET),
149
+ ('c4 -e を2つ+秘密のファイルを名指し', G + " -n -e 'a b' -e 'c' " + SECRET),
150
+ ('c5 --regexp= +秘密のファイルを名指し', G + " -n --regexp='a b' " + SECRET),
151
+ ('c6 ①の形の切れ端+秘密のファイルを名指し',
152
+ G + " -n 'a " + WORD + "\\|b' " + SECRET),
153
+ ('c7 ①の形(二重引用符)+秘密のファイルを名指し',
154
+ G + ' -n "a ' + WORD + '\\|b" ' + SECRET),
155
+ ('c8 秘密を含むフォルダを名指し(再帰)', G + ' -rn x ' + SITE),
156
+ ('c9 -e +秘密を含むフォルダを名指し(再帰)', G + ' -rn -e x ' + SITE),
157
+ ('c10 隠しも読む旗つきで秘密を含む場所', RG + ' --hidden x ' + SITE),
158
+ ('c11 記録の外まで読む旗つきで秘密のファイルを名指し',
159
+ GG + ' --untracked -n x -- ' + NPMRC),
160
+ ('c12 秘密のファイルを読む(別の動詞)', 'head -5 ' + SECRET),
161
+ ]
162
+ for label, cmd in STILL_DENY:
163
+ check(label, kind(cmd), 'deny:danger')
164
+ check('c13 名指しの秘密の名前が理由に出る(探す言葉ではない)',
165
+ NPMRC in reason(G + " -n 'a " + WORD + "\\|b' " + SECRET), True)
166
+
167
+ # ═════════════════════════════════════════════════════════════════════════════
168
+ # (d) 安全側の振る舞いは1つも外さない
169
+ # ═════════════════════════════════════════════════════════════════════════════
170
+ print('── (d) 安全側の振る舞いを1つも外さない ' + '─' * 34)
171
+ SAFE = [
172
+ ('d1 探す場所を書かない再帰', G + ' -rn x'),
173
+ ('d2 探す場所を書かない再帰(-e つき)', G + ' -rn -e x'),
174
+ ('d3 探す場所を書かない再帰(当て字の縦棒つき)', G + " -rn 'a\\|b'"),
175
+ ('d4 点1つ', G + ' -rn x .'),
176
+ ('d5 作業場所の根を名指し', G + ' -rn x ' + SITE + '/.'),
177
+ ('d6 実在しない場所を名指し', G + ' -rn x ' + os.path.join(SITE, 'nope')),
178
+ ('d7 しるし入りの場所', G + ' -rn x ' + SITE + '/*'),
179
+ ('d8 記録の外まで読む旗つきで根を探す', GG + ' --untracked -n x'),
180
+ ('d9 -f の値が秘密のファイル(探す文字が書いてあるファイル=パス)',
181
+ G + ' -n -f ' + SECRET + ' ' + FILE1),
182
+ ('d10 -f つきで秘密のファイルを名指し', G + ' -n -f ' + FILE1 + ' ' + SECRET),
183
+ ('d11 --file= の値が秘密のファイル', G + ' -n --file=' + SECRET + ' ' + FILE1),
184
+ ]
185
+ for label, cmd in SAFE:
186
+ check(label, kind(cmd), 'deny:danger')
187
+ check('d12 -f つきで秘密に当たらない形は通る', kind(G + ' -n -f ' + FILE1 + ' ' + FILE2),
188
+ 'allow')
189
+
190
+ # ═════════════════════════════════════════════════════════════════════════════
191
+ # (e) ほかの危険の判定は、同じ行に混ざっていても今までどおり当たる
192
+ # ═════════════════════════════════════════════════════════════════════════════
193
+ print('── (e) 同じ行に混ざったほかの危険は今までどおり当たる ' + '─' * 22)
194
+ MIXED = [
195
+ ('e1 ①の形+後ろで秘密を読む', G + " -n 'a " + WORD + "\\|b' " + FILE1 + ' ; head -5 '
196
+ + SECRET),
197
+ ('e2 ②の形+後ろで秘密を読む', G + " -n -e 'a " + WORD + "' " + FILE1 + ' ; head -5 '
198
+ + SECRET),
199
+ ('e3 ①の形+後ろで強い上書きの push',
200
+ G + " -n 'a " + WORD + "\\|b' " + FILE1 + ' ; git push --force origin main'),
201
+ ('e4 ②の形+後ろで秘密の環境変数の露出',
202
+ G + " -n -e 'a " + WORD + "' " + FILE1 + ' ; echo $DATABASE_URL'),
203
+ ('e5 ①の形+後ろで変数を含む再帰削除',
204
+ G + " -n 'a " + WORD + "\\|b' " + FILE1 + ' ; rm -r "$DIR/x"'),
205
+ ('e6 ①の形+名前を並べて読ませる形(秘密を含む場所)',
206
+ 'find ' + SITE + " -name '*.ts' -exec " + G + " -n 'a " + WORD + "\\|b' {} +"),
207
+ ]
208
+ for label, cmd in MIXED:
209
+ check(label, kind(cmd), 'deny:danger')
210
+
211
+ # ═════════════════════════════════════════════════════════════════════════════
212
+ # (f) 探す言葉の【途中】に引用符が1つ入る形で、名指しの場所を巻き込まない
213
+ # ═════════════════════════════════════════════════════════════════════════════
214
+ print('── (f) 探す言葉の途中の引用符で、名指しの場所を巻き込まない ' + '─' * 14)
215
+ APOSTROPHE = [
216
+ ('f1 二重引用符の中に単引用符が1つ(名指しのフォルダ)', G + ' -rn "it\'s" ' + CLEAN),
217
+ ('f2 二重引用符の中に単引用符が1つ(名指しのファイル)', G + ' -n "it\'s" ' + FILE1),
218
+ ('f3 単引用符の中に二重引用符が1つ', G + " -rn 'a\"b' " + CLEAN),
219
+ ('f4 引用符で始まるが閉じている探す言葉', G + ' -rn "\'needle\'" ' + CLEAN),
220
+ ]
221
+ for label, cmd in APOSTROPHE:
222
+ check(label, kind(cmd), 'allow')
223
+ check('f5 途中の引用符でも秘密を名指しすれば止まる', kind(G + ' -n "it\'s" ' + SECRET),
224
+ 'deny:danger')
225
+
226
+ # ═════════════════════════════════════════════════════════════════════════════
227
+ # (g) 部品の単体
228
+ # ═════════════════════════════════════════════════════════════════════════════
229
+ print('── (g) 部品の単体 ' + '─' * 54)
230
+ POS = [
231
+ ('g1 旗でない最初の引数が探す文字', 'grep', ['-n', 'needle', 'a.ts'], {1}),
232
+ ('g2 探す道具でなければ1つも外さない', 'cat', ['needle', 'a.ts'], set()),
233
+ ('g3 -e の値だけを外す(最初の引数はパスに戻る)',
234
+ 'grep', ['-n', '-e', 'needle', 'a.ts'], {2}),
235
+ ('g4 -e を2つ', 'grep', ['-e', 'a', '-e', 'b', 'a.ts'], {1, 3}),
236
+ ('g5 --regexp= は旗ごと外す', 'grep', ['--regexp=a b', 'a.ts'], {0}),
237
+ ('g6 --regexp 旗と値', 'grep', ['--regexp', 'a b', 'a.ts'], {1}),
238
+ ('g7 -f が在れば1つも外さない', 'grep', ['-f', 'p.txt', 'a.ts'], set()),
239
+ ('g8 --file= が在れば1つも外さない', 'grep', ['--file=p.txt', 'a.ts'], set()),
240
+ ('g9 -e と -f が混ざっても1つも外さない', 'grep', ['-e', 'a', '-f', 'p.txt'], set()),
241
+ ('g10 引数が旗だけ', 'grep', ['-rn'], set()),
242
+ ('g11 引数が無い', 'grep', [], set()),
243
+ ('g12 閉じていない引用符で始まる語は続きも外す',
244
+ 'grep', ['-n', "'env: " + WORD, 'rest'], {1, 2}),
245
+ ('g13 引用符で始まらない語は続きを外さない', 'grep', ['-n', 'env:', WORD], {1}),
246
+ ('g14 引用符が閉じている語は続きを外さない', 'grep', ['-n', "'a'", 'a.ts'], {1}),
247
+ ('g15 閉じていない語が閉じる所まで外す',
248
+ 'grep', ['-n', '"a', 'b"', 'a.ts'], {1, 2}),
249
+ ('g16 -e の値も引用符が閉じるまで外す(値が割れる形)',
250
+ 'grep', ['-e', '"a', 'b"', 'a.ts'], {1, 2}),
251
+ ('g17 -e の値が閉じていなければ残りが全部探す文字',
252
+ 'grep', ['-e', "'a", 'b', 'c'], {1, 2, 3}),
253
+ ('g18 -e の値が引用符で始まらなければ値1語だけ',
254
+ 'grep', ['-e', 'a', 'b.ts'], {1}),
255
+ ('g19 --regexp= の値が割れる形(旗の部分は見ない)',
256
+ 'grep', ['--regexp="a', 'b"', 'a.ts'], {0, 1}),
257
+ ]
258
+ for label, verb, args, want in POS:
259
+ check(label, set(policy.pattern_arg_positions(verb, args)), want)
260
+
261
+ QUOTE = [
262
+ ('h1 単引用符が開いたまま', "'env: " + WORD, None, "'"),
263
+ ('h2 二重引用符が開いたまま', '"a', None, '"'),
264
+ ('h3 閉じている', "'a'", None, None),
265
+ ('h4 引用符が無い', 'a.ts', None, None),
266
+ ('h5 前の語から続いて閉じる', 'b"', '"', None),
267
+ ('h6 前の語から続いて開いたまま', 'b', '"', '"'),
268
+ ('h7 単引用符の中では逃がしが効かない', "a\\'", "'", None),
269
+ ('h8 二重引用符の中では逃がしが効く', 'a\\"', '"', '"'),
270
+ ('h9 空の字面', '', None, None),
271
+ ('h10 None', None, None, None),
272
+ ]
273
+ for label, text, state, want in QUOTE:
274
+ check(label, policy._open_quote(text, state), want)
275
+
276
+ check('h11 探す言葉の語の広がり(閉じていない)',
277
+ policy._pattern_word_positions(['-n', "'a", 'b', 'c'], 1), [1, 2, 3])
278
+ check('h12 探す言葉の語の広がり(閉じる所で止まる)',
279
+ policy._pattern_word_positions(['-n', "'a", "b'", 'c'], 1), [1, 2])
280
+ check('h13 探す言葉の語の広がり(引用符で始まらない)',
281
+ policy._pattern_word_positions(['-n', 'a', 'b'], 1), [1])
282
+
283
+ # ═════════════════════════════════════════════════════════════════════════════
284
+ # (h) 空振り確認(直しを外すと、この台本が落ちる)
285
+ # ═════════════════════════════════════════════════════════════════════════════
286
+ print('── (h) 空振り確認(直しを外すと落ちる) ' + '─' * 32)
287
+ _real_positions = policy.pattern_arg_positions
288
+ _real_span = policy._pattern_word_positions
289
+
290
+
291
+ def _old_positions(verb, args):
292
+ """直す前の読み方(最初の1語だけを外す・-e / -f が在れば1つも外さない)。"""
293
+ if verb not in policy._PATTERN_FIRST_VERBS:
294
+ return frozenset()
295
+ for t in args:
296
+ if t in policy._PATTERN_FLAGS or t.startswith('--regexp='):
297
+ return frozenset()
298
+ if t in policy._PATTERN_FILE_FLAGS or t.startswith('--file='):
299
+ return frozenset()
300
+ for i, t in enumerate(args):
301
+ if not t.startswith('-'):
302
+ return frozenset({i})
303
+ return frozenset()
304
+
305
+
306
+ policy.pattern_arg_positions = _old_positions
307
+ check('i1 直す前の読み方に戻すと①の形が止まる',
308
+ kind(G + " -n 'env: " + WORD + "\\|home:' " + FILE1), 'deny:danger')
309
+ check('i2 直す前の読み方に戻すと②の形が止まる',
310
+ kind(G + " -n -e 'env: " + WORD + "' " + FILE1), 'deny:danger')
311
+ check('i3 直す前の読み方でも秘密の名指しは止まる(守りは前からある)',
312
+ kind(G + " -n 'x' " + SECRET), 'deny:danger')
313
+ policy.pattern_arg_positions = _real_positions
314
+
315
+ policy._pattern_word_positions = lambda args, first: [first] # ①だけを外す
316
+ check('i4 ①を外すと空白+当て字の縦棒の形が止まる',
317
+ kind(G + " -n 'env: " + WORD + "\\|home:' " + FILE1), 'deny:danger')
318
+ check('i5 ①を外しても -e の形は通る(②は別の直し)',
319
+ kind(G + " -n -e 'env: " + WORD + "' " + FILE1), 'allow')
320
+ policy._pattern_word_positions = _real_span
321
+ check('i6 戻したら2つの形が2つとも通る',
322
+ (kind(G + " -n 'env: " + WORD + "\\|home:' " + FILE1),
323
+ kind(G + " -n -e 'env: " + WORD + "' " + FILE1)),
324
+ ('allow', 'allow'))
325
+
326
+ # ─────────────────────────────────────────────────────────────────────────────
327
+ # ★作り物を片付ける(使い捨ての場所に残骸を残さない・便 de82bc3a のコミット a5118c7 と同じ作法)
328
+ import shutil # noqa: E402
329
+
330
+ shutil.rmtree(ROOT, ignore_errors=True)
331
+ check('z1 作り物を片付けた', os.path.isdir(ROOT), False)
332
+
333
+ print()
334
+ if failures:
335
+ print(f'NG {len(failures)} 件')
336
+ for line in failures:
337
+ print(' ' + line)
338
+ sys.exit(1)
339
+ print('すべて OK')
@@ -188,6 +188,7 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
188
188
  - 通る例: `grep -rn 'relay' src docs` / `rg 'relay' src docs` / 追跡済みだけ見るなら `git grep -n 'relay' -- src docs`
189
189
  - ★**名指しの先が「ファイル1つ」なら通る**(`grep -rn 'relay' src/relay.ts`・2026-10-10 の便 3be099ba で直した)。前は再帰の旗が付いているだけで作業場所(リポの根)に倒れ、根の秘密ファイルに当たって止まっていた(実地 便 1ff7b915)。★**秘密の名前のファイルを名指しすれば今までどおり止まる。**
190
190
  - ★**探す言葉に当て字の縦棒(`\|`)を入れた形も、名指しの場所で判定される**(`grep -rn "a\|b" services packages`・同じ便で直した)。前は引用符の中で命令が千切れて場所が別の切れ端へ移り、作業場所に倒れて止まっていた(実地 便 3bbde2e3)。★**場所を書かない形**(`grep -rn "a\|b"` だけ)は今までどおり止まる。
191
+ - ★**探す言葉が「`.env` で終わって見える語」を含む形も通る**(`grep -n 'env: process.env\|home:' src/selfcheck.ts`・`grep -n -e 'env: process.env' -e 'home:' src/selfcheck.ts`・2026-10-11 の便 18e9e32e で直した)。前は**探す言葉がパスとして測られ**、その語が秘密のファイルに見えて止まっていた(実地 便 3f54ac4a)。★**秘密の名前のファイルを名指しすれば今までどおり止まる**(`grep -n 'x' .env`・`grep -n -e 'x' .env`)。
191
192
  - ★**記録の外まで読む旗を付けた形は止まる**(`git grep --untracked`・`--no-index`・`--no-exclude-standard`)。実測で、この旗を付けると追跡していない秘密のファイルまで中身が出る(便 227aeebb)。追跡済みだけを見る素の `git grep` は今までどおり通る。
192
193
  - ★**名前を並べて別の道具へ渡す形も止まる**(`find <場所> -type f -exec cat {} +`・`find <場所> | xargs rg`・包みの中に入れた同じ形)。探した場所の中に秘密のファイルが在るときだけ止まる(便 227aeebb)。
193
194
  - ★**除外指定では通らない**(実測 2026-09-27)。`grep -rn 語 . --exclude=.npmrc` は、`.` の再帰でまず止まり、さらに**秘密のファイル名を引数に書いた事自体**でも止まる。「除いて探す」ではなく「場所を名指しする」が正解。