@tyhld/conductor 0.12.137 → 0.12.139

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,475 @@
1
+ #!/usr/bin/env python3
2
+ """引用符で始まらない探す言葉と、find で名指ししたファイルの検査(便 362a7759)。
3
+
4
+ 実行: python3 scripts/hooks/test_dollar_quote_and_find_file.py
5
+ 1件でも期待と違えば exit 1。
6
+
7
+ 【なぜ要るか(便 18e9e32e の要判断2・3/便 3be099ba の要判断2 の持ち越し)】
8
+ 読み違い1回で danger になり、0.12.133 から便が丸ごと止まる。便 18e9e32e が直した
9
+ 「探す言葉を秘密のファイルと読み違える」形のほかに、同じ病気の形が残っていた。
10
+
11
+ 形A … 引用符で始まらない書き方($'…' / x'…' / $"…")で割れた探す言葉が、
12
+ 今までどおりパスとして測られる。
13
+ 止める側の区切り(split_segments)は引用符の中でも機械的に割る(便 ad6b5db9・
14
+ 正しい設計)ので、探す言葉に【空白】と【当て字の縦棒】の両方が入ると切れ端ができ、
15
+ クォートが壊れた切れ端では tokens_of が素朴分割へ倒れて探す言葉が2語以上に割れる。
16
+ 便 18e9e32e の読み方は「最初の語が【引用符そのもので始まる】ときだけ続きを外す」
17
+ だったので、$'…' のように引用符で始まらない書き方では続きが外れず、
18
+ 2語目(.env で終わって見える語)がパスとして測られて danger になっていた。
19
+ 形B … find で【実在のファイル】を名指しして読む道具へ並べる形が、作業場所に倒れる。
20
+ 探す場所を集める読み方が実在のフォルダだけを見ていたので、ファイルを名指しした形は
21
+ 「場所を書いていない形」と同じに扱われ、作業場所(リポの根)の秘密に当たっていた
22
+ (便 3be099ba が _recursive_read_danger で直した原因①と同じ病気が、
23
+ find の判定(_find_feed_danger)に残っていた)。
24
+ 形C … 形A と同じ1行から出ていた【止めすぎ】。割れていないのに続きを外していたので、
25
+ 探す言葉が引用符で始まる形(`-rn "'" <フォルダ>`)で名指しのフォルダまで
26
+ 探す言葉と見なし、場所が無い扱いになって作業場所に倒れていた。
27
+ 穴H … 形A と同じ1行から出ていた【止め漏れ】。同じ理由で、名指しの【秘密のファイル】まで
28
+ 探す言葉として読み飛ばしていた(`-n "'" <秘密のファイル>` が通っていた)。
29
+ ★この便で塞ぐ(止める側が増える方向)。
30
+ 形D … 探す文字を `=` で繋げた旗(`--regexp=語` / `--file=パス`)で渡した形が、
31
+ 名指しの探す場所を探す文字と取り違えて止まる(便 220a1e2c で原因を確定)。
32
+ 作法の判定(_disc_search)が、探す文字を旗で明示する形を【空白で区切った書き方】
33
+ (`-e 語` / `--regexp 語`)だけで見ていたため、`=` で繋げた1語は「ただの旗」として
34
+ 読み飛ばされ、旗でない最初の引数(=名指しの探す場所)を探す文字として捨てていた。
35
+ 名指しが1つだけだと探す場所が0件になり、「探す場所を書かない全体の再帰検索」に倒れて
36
+ discipline で止まっていた(★探す言葉の中身とは無関係で、普通の語でも止まっていた)。
37
+ ★秘密の判定(pattern_arg_positions)は便 18e9e32e から `--regexp=` を読めていたので、
38
+ 食い違っていたのは作法の判定の側だけ。
39
+
40
+ 【どう直したか】割れたかどうかを「引用符で始まるか」ではなく
41
+ 【語の割り方が素朴分割へ倒れたか】(naive_token_split)で見る。倒れたときだけ続きを外し、
42
+ 倒れていないとき(shlex が通った=引用符が剥がされている)は1つも外さない。
43
+ find の側は、名指しの先が実在のファイルだけなら作業場所に倒さず、その段で名指しした
44
+ 実在の秘密のファイルは今までどおり止める。
45
+
46
+ 【ここで固定すること】
47
+ (a) 形A(引用符で始まらない書き方で割れた探す言葉)は通る
48
+ (b) 形B(find で名指しした普通のファイル)は通る
49
+ (c) 形C(割れていない探す言葉で名指しの場所を食わない)は通る
50
+ (d) 穴H(名指しの秘密のファイルを探す言葉として読み飛ばさない)は止まる
51
+ (i) 形D(`=` で繋げた旗でも名指しの場所を読み切る)は通る・作法と秘密の判定は緩まない
52
+ (e) 秘密の名指し・倒す判定は今までどおり止まる(1つも緩めない)
53
+ (f) ほかの危険の判定は、同じ行に混ざっていても今までどおり当たる
54
+ (g) 部品の単体(素朴分割へ倒れたかの見分け・語の広がり・実在のファイル)
55
+ (h) 空振り確認(直しを外すと、この台本が落ちる)
56
+
57
+ ★秘密として扱う名前の判定・読み書き持ち出しの動詞の一覧は1文字も変えていない。
58
+ ★この台本は検索の道具の名前と秘密の名前を素の字で置かない(組み立てて使う=既存の作法)。
59
+ """
60
+ import os
61
+ import subprocess
62
+ import sys
63
+ import tempfile
64
+
65
+ sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
66
+
67
+ import policy # noqa: E402
68
+
69
+ failures = []
70
+
71
+
72
+ def check(label, got, want):
73
+ ok = got == want
74
+ if not ok:
75
+ failures.append(f'{label}: got={got!r} want={want!r}')
76
+ print(f'{"OK " if ok else "NG "} {label:62} {str(got)[:40]}')
77
+
78
+
79
+ # ── 使い捨ての作り物(この台本のコードが作る=職人の命令の字面には出ない)────────
80
+ ROOT = tempfile.mkdtemp(prefix='dollar-quote-')
81
+ SITE = os.path.join(ROOT, 'site') # 作業場所(根に秘密の形の名前が在る)
82
+ os.makedirs(os.path.join(SITE, 'src'))
83
+ os.makedirs(os.path.join(SITE, 'clean', 'deep'))
84
+ os.makedirs(os.path.join(SITE, 'withsecret'))
85
+ ENV = '.env'
86
+ NPMRC = '.npm' + 'rc'
87
+ for _d in ('', 'withsecret'):
88
+ with open(os.path.join(SITE, _d, NPMRC), 'w') as f:
89
+ f.write('DUMMY=placeholder\n')
90
+ for _p in (('src', 'selfcheck.ts'), ('src', 'other.ts'), ('clean', 'deep', 'b.md')):
91
+ with open(os.path.join(SITE, *_p), 'w') as f:
92
+ f.write('needle\n')
93
+ _env = dict(os.environ, GIT_AUTHOR_NAME='p', GIT_AUTHOR_EMAIL='p@x',
94
+ GIT_COMMITTER_NAME='p', GIT_COMMITTER_EMAIL='p@x')
95
+ for _argv in (['git', 'init', '-q'], ['git', 'add', 'src'], ['git', 'commit', '-q', '-m', 'init']):
96
+ subprocess.run(_argv, cwd=SITE, env=_env, capture_output=True)
97
+
98
+ #: 秘密を1つも置かない作り物のリポ(作法の判定だけを見るための作業場所)。
99
+ #: ★秘密が在る作業場所では danger が先に当たるので、作法の判定(全体の再帰検索)が見えない。
100
+ PLAIN = os.path.join(ROOT, 'plain')
101
+ os.makedirs(os.path.join(PLAIN, 'src'))
102
+ with open(os.path.join(PLAIN, 'src', 'a.ts'), 'w') as f:
103
+ f.write('needle\n')
104
+ for _argv in (['git', 'init', '-q'], ['git', 'add', 'src'], ['git', 'commit', '-q', '-m', 'init']):
105
+ subprocess.run(_argv, cwd=PLAIN, env=_env, capture_output=True)
106
+
107
+ G = 'g' + 'rep'
108
+ RG = 'r' + 'g'
109
+ GG = 'git ' + 'grep'
110
+ FIND = 'f' + 'ind'
111
+ READ = 'c' + 'at'
112
+ #: 探す言葉に混ざる「.env で終わって見える語」(★パスではない・コードの書き方を調べる語)。
113
+ WORD = 'process' + ENV
114
+ #: 引用符で始まらない書き方の頭(ANSI-C の囲み)。
115
+ DQ = '$' + "'"
116
+ DD = '$' + '"'
117
+ Q = "'"
118
+ FILE1 = os.path.join(SITE, 'src', 'selfcheck.ts')
119
+ FILE2 = os.path.join(SITE, 'src', 'other.ts')
120
+ SECRET = os.path.join(SITE, NPMRC)
121
+ CLEAN = os.path.join(SITE, 'clean')
122
+ SRC = os.path.join(SITE, 'src')
123
+ WITHSECRET = os.path.join(SITE, 'withsecret')
124
+ PLAIN_SRC = os.path.join(PLAIN, 'src')
125
+ PATFILE = os.path.join(SITE, 'src', 'other.ts') # 探す文字が書いてあるファイル(普通)
126
+
127
+
128
+ def kind(cmd, cwd=SITE):
129
+ """allow / gate / deny:<種類> を返す(deny は理由の頭で分ける)。"""
130
+ r = policy.decide_bash(cmd, cwd)
131
+ if r['decision'] != 'deny':
132
+ return r['decision']
133
+ return 'deny:' + (r['reason'] or '').split(':', 1)[0]
134
+
135
+
136
+ def reason(cmd, cwd=SITE):
137
+ return policy.decide_bash(cmd, cwd).get('reason') or ''
138
+
139
+
140
+ # ═════════════════════════════════════════════════════════════════════════════
141
+ # (a) 形A: 引用符で始まらない書き方で割れた探す言葉は、パスとして測らない
142
+ # ═════════════════════════════════════════════════════════════════════════════
143
+ print('── (a) 引用符で始まらない書き方で割れた探す言葉 ' + '─' * 20)
144
+ FORM_A = [
145
+ ('a1 $\'…\' で実地と同じ語・名指しのファイル',
146
+ G + ' -n ' + DQ + 'env: ' + WORD + "\\|home:' " + FILE1),
147
+ ('a2 $\'…\' で名指しのフォルダ(再帰の旗つき)',
148
+ G + ' -rn ' + DQ + 'env: ' + WORD + "\\|home:' " + SRC),
149
+ ('a3 $\'…\' で名指しのフォルダ2つ',
150
+ G + ' -rn ' + DQ + 'x ' + WORD + "\\|y' " + SRC + ' ' + CLEAN),
151
+ ('a4 $\'…\' で名指しのファイル2つ',
152
+ G + ' -n ' + DQ + 'x ' + WORD + "\\|y' " + FILE1 + ' ' + FILE2),
153
+ ('a5 $\'…\' で別の道具(隠しも読む旗つき)',
154
+ RG + ' -n --hidden ' + DQ + 'x ' + WORD + "\\|y' " + SRC),
155
+ ('a6 $\'…\' が -e の値',
156
+ G + ' -rn -e ' + DQ + 'x ' + WORD + "\\|y' " + SRC),
157
+ ('a7 $\'…\' が --regexp= の値',
158
+ G + ' -rn --regexp=' + DQ + 'x ' + WORD + "\\|y' " + SRC),
159
+ ('a8 引用符の前に字がある(x\'…\')',
160
+ G + " -rn x'y " + WORD + "\\|z' " + SRC),
161
+ ('a9 $"…" の書き方',
162
+ G + ' -rn ' + DD + 'x ' + WORD + '\\|y" ' + SRC),
163
+ ('a10 再帰の旗なし(名指しのファイル)',
164
+ G + ' -n ' + DQ + 'x ' + WORD + "\\|y' " + FILE2),
165
+ ('a11 記録の外まで読む旗つき・名指しのフォルダ',
166
+ GG + ' --untracked -n ' + DQ + 'x ' + WORD + "\\|y' -- " + SRC),
167
+ ('a12 当て字の縦棒2つ・語が真ん中',
168
+ G + ' -rn ' + DQ + 'a b\\|c ' + WORD + "\\|e' " + SRC),
169
+ ('a13 $\'…\' のあとに縦棒で続ける(読むだけ)',
170
+ G + ' -n ' + DQ + 'x ' + WORD + "\\|y' " + FILE1 + ' | head -20'),
171
+ ]
172
+ for label, cmd in FORM_A:
173
+ check(label, kind(cmd), 'allow')
174
+
175
+ # ═════════════════════════════════════════════════════════════════════════════
176
+ # (b) 形B: find で実在のファイルを名指しして読む道具へ並べる形は通る
177
+ # ═════════════════════════════════════════════════════════════════════════════
178
+ print('── (b) find で名指しした普通のファイル ' + '─' * 26)
179
+ FORM_B = [
180
+ ('b1 ファイル1つを名指し+読む道具', FIND + ' ' + FILE1 + ' -exec ' + READ + ' {} +'),
181
+ ('b2 ファイル2つを名指し',
182
+ FIND + ' ' + FILE1 + ' ' + FILE2 + ' -exec ' + READ + ' {} +'),
183
+ ('b3 名前を並べて別の道具へ渡す', FIND + ' ' + FILE1 + ' | xargs ' + READ),
184
+ ('b4 名指しのファイル+検索の道具', FIND + ' ' + FILE1 + ' -exec ' + G + ' -n x {} +'),
185
+ ('b5 -execdir の形', FIND + ' ' + FILE1 + ' -execdir ' + READ + ' {} +'),
186
+ ('b6 条件の旗つき', FIND + ' ' + FILE1 + ' -type f -exec ' + READ + ' {} +'),
187
+ ('b7 名指しのファイル+持ち出しの道具', FIND + ' ' + FILE1 + ' -exec head -3 {} +'),
188
+ ('b8 -exec を \\; で閉じる形', FIND + ' ' + FILE1 + ' -exec ' + READ + ' {} \\;'),
189
+ ('b9 秘密を含まないフォルダとファイルの混ぜ',
190
+ FIND + ' ' + CLEAN + ' ' + FILE1 + ' -exec ' + READ + ' {} +'),
191
+ ]
192
+ for label, cmd in FORM_B:
193
+ check(label, kind(cmd), 'allow')
194
+
195
+ # ═════════════════════════════════════════════════════════════════════════════
196
+ # (c) 形C: 割れていない探す言葉で、名指しの場所を探す言葉と見なさない
197
+ # ═════════════════════════════════════════════════════════════════════════════
198
+ print('── (c) 割れていない探す言葉は続きを食わない ' + '─' * 22)
199
+ FORM_C = [
200
+ ('c1 探す言葉が引用符1字(名指しのフォルダ)', G + ' -rn "' + Q + '" ' + SRC),
201
+ ('c2 引用符で始まる探す言葉(名指しのフォルダ2つ)',
202
+ G + ' -rn "' + Q + 'a" ' + SRC + ' ' + CLEAN),
203
+ ('c3 引用符で始まる探す言葉(-e つき・名指しのフォルダ)',
204
+ G + ' -rn -e "' + Q + 'a" ' + SRC),
205
+ ('c4 引用符で始まる探す言葉(--regexp= ・名指しのフォルダ)',
206
+ G + ' -rn --regexp="' + Q + 'a" ' + SRC),
207
+ ('c5 探す言葉の途中に引用符が1つ(便 18e9e32e の形・名指しのフォルダ)',
208
+ G + ' -rn "it' + Q + 's" ' + SRC),
209
+ ('c6 引用符で始まるが閉じている探す言葉', G + ' -rn "' + Q + 'needle' + Q + '" ' + SRC),
210
+ ]
211
+ for label, cmd in FORM_C:
212
+ check(label, kind(cmd), 'allow')
213
+
214
+ # ═════════════════════════════════════════════════════════════════════════════
215
+ # (d) 穴H: 名指しの秘密のファイルを探す言葉として読み飛ばさない(★止める側が増える)
216
+ # ═════════════════════════════════════════════════════════════════════════════
217
+ print('── (d) 名指しの秘密を探す言葉として読み飛ばさない ' + '─' * 16)
218
+ HOLE = [
219
+ ('d1 探す言葉が引用符1字+秘密のファイル', G + ' -n "' + Q + '" ' + SECRET),
220
+ ('d2 引用符で始まる探す言葉+秘密のファイル', G + ' -n "' + Q + 'a" ' + SECRET),
221
+ ('d3 秘密のファイルとふつうのファイルを並べる',
222
+ G + ' -n "' + Q + 'a" ' + SECRET + ' ' + FILE2),
223
+ ('d4 -e の値が引用符で始まる+秘密のファイル', G + ' -n -e "' + Q + 'a" ' + SECRET),
224
+ ('d5 --regexp= の値が引用符で始まる+秘密のファイル',
225
+ G + ' -n --regexp="' + Q + 'a" ' + SECRET),
226
+ ('d6 探す言葉が引用符1字+別の道具で秘密のファイル', RG + ' -n "' + Q + '" ' + SECRET),
227
+ ]
228
+ for label, cmd in HOLE:
229
+ check(label, kind(cmd), 'deny:danger')
230
+ check('d7 理由は本物の秘密の名前を指す', NPMRC in reason(G + ' -n "' + Q + '" ' + SECRET), True)
231
+
232
+ # ═════════════════════════════════════════════════════════════════════════════
233
+ # (i) 形D: 探す文字を `=` で繋げた旗(--regexp=語 / --file=パス)でも、
234
+ # 名指しの場所を探す文字と取り違えない
235
+ #
236
+ # 【原因(便 220a1e2c で確定)】作法の判定(_disc_search)は、探す文字を旗で明示する形を
237
+ # 【空白で区切った書き方】(`-e 語` / `--regexp 語`)だけで見ていた。`--regexp=語` のように
238
+ # 値を `=` で繋げた1語は「ただの旗」として読み飛ばされ、探す文字が示されていない扱いになり、
239
+ # 旗でない最初の引数(=名指しの探す場所)を探す文字として捨てていた。
240
+ # 名指しが1つだけなら探す場所が0件になり、「探す場所を書かない全体の再帰検索」に倒れて
241
+ # discipline で止まっていた(★探す言葉の中身とは関係なく、普通の語でも止まっていた)。
242
+ # ★秘密の判定(pattern_arg_positions)は便 18e9e32e から `--regexp=` を読めていたので、
243
+ # 食い違っていたのは作法の判定の側だけだった。
244
+ # ═════════════════════════════════════════════════════════════════════════════
245
+ print('── (i) 探す文字を = で繋げた旗でも名指しの場所を読み切る ' + '─' * 10)
246
+ FORM_D = [
247
+ ('i1 --regexp= +名指しのフォルダ', G + ' -rn --regexp=needle ' + SRC),
248
+ ('i2 --regexp= +名指しのフォルダ2つ', G + ' -rn --regexp=needle ' + SRC + ' ' + CLEAN),
249
+ ('i3 --regexp= +名指しのファイル', G + ' -rn --regexp=needle ' + FILE1),
250
+ ('i4 --file= +名指しのフォルダ', G + ' -rn --file=' + PATFILE + ' ' + SRC),
251
+ ('i5 別の道具の --regexp= +名指しのフォルダ', RG + ' -n --regexp=needle ' + SRC),
252
+ ('i6 egrep の --regexp= +名指しのフォルダ', 'eg' + 'rep -rn --regexp=needle ' + SRC),
253
+ ('i7 --regexp= +秘密を含まない深いフォルダ',
254
+ G + ' -rn --regexp=needle ' + os.path.join(CLEAN, 'deep')),
255
+ ]
256
+ for label, cmd in FORM_D:
257
+ check(label, kind(cmd), 'allow')
258
+
259
+ #: ★作法の判定は1つも緩めない(秘密を置かない作り物の根で測る=danger に隠れないため)。
260
+ DISC_KEEP = [
261
+ ('i8 --regexp= で探す場所を書かない', G + ' -rn --regexp=needle'),
262
+ ('i9 --regexp= で点1つ', G + ' -rn --regexp=needle .'),
263
+ ('i10 --file= で探す場所を書かない', G + ' -rn --file=' + PLAIN_SRC + '/a.ts'),
264
+ ('i11 別の道具の --regexp= で探す場所を書かない', RG + ' -n --regexp=needle'),
265
+ ('i12 旗なしで探す場所を書かない(前からの形)', G + ' -rn needle'),
266
+ ('i13 旗なしで点1つ(前からの形)', G + ' -rn needle .'),
267
+ ('i14 -e で探す場所を書かない(前からの形)', G + ' -rn -e needle'),
268
+ ]
269
+ for label, cmd in DISC_KEEP:
270
+ check(label, kind(cmd, PLAIN), 'deny:discipline')
271
+ check('i15 名指しのフォルダなら作法の判定は当たらない(前からの形)',
272
+ kind(G + ' -rn needle ' + PLAIN_SRC, PLAIN), 'allow')
273
+
274
+ #: ★秘密の判定は1つも緩めない(繋げた書き方でも名指しの秘密は止まる)。
275
+ DANGER_KEEP = [
276
+ ('i16 --regexp= +秘密のファイルを名指し', G + ' -rn --regexp=needle ' + SECRET),
277
+ ('i17 --regexp= +秘密を含むフォルダ', G + ' -rn --regexp=needle ' + WITHSECRET),
278
+ ('i18 --regexp= +作業場所の根', G + ' -rn --regexp=needle ' + SITE),
279
+ ('i19 --regexp= +探す場所を書かない(秘密が在る作業場所)', G + ' -rn --regexp=needle'),
280
+ ('i20 --file= の値が秘密のファイル', G + ' -rn --file=' + SECRET + ' ' + SRC),
281
+ ('i21 --file 空白の値が秘密のファイル(前からの形)', G + ' -rn --file ' + SECRET + ' ' + SRC),
282
+ ('i22 別の道具の --regexp= +秘密のファイル', RG + ' -n --regexp=needle ' + SECRET),
283
+ ]
284
+ for label, cmd in DANGER_KEEP:
285
+ check(label, kind(cmd), 'deny:danger')
286
+
287
+ # ═════════════════════════════════════════════════════════════════════════════
288
+ # (e) 秘密の名指し・倒す判定は今までどおり止まる(★1つも緩めない)
289
+ # ═════════════════════════════════════════════════════════════════════════════
290
+ print('── (e) 止める側は1つも緩めない ' + '─' * 34)
291
+ STOP = [
292
+ ('e1 形Aの書き方+秘密のファイルを名指し',
293
+ G + ' -n ' + DQ + 'x ' + WORD + "\\|y' " + SECRET),
294
+ ('e2 形Aの書き方+秘密のファイル(-e つき)',
295
+ G + ' -rn -e ' + DQ + 'x ' + WORD + "\\|y' " + SECRET),
296
+ ('e3 形Aの書き方+秘密のファイル($"…")',
297
+ G + ' -rn ' + DD + 'x ' + WORD + '\\|y" ' + SECRET),
298
+ ('e4 形Aの書き方で作業場所の根を探す',
299
+ G + ' -rn ' + DQ + 'x ' + WORD + "\\|y' " + SITE),
300
+ ('e5 形Aの書き方で探す場所を書かない',
301
+ G + ' -rn ' + DQ + 'x ' + WORD + "\\|y'"),
302
+ ('e6 形Aの書き方で点1つ',
303
+ G + ' -rn ' + DQ + 'x ' + WORD + "\\|y' ."),
304
+ ('e7 形Aの書き方で秘密を含むフォルダを名指し',
305
+ G + ' -rn ' + DQ + 'x ' + WORD + "\\|y' " + WITHSECRET),
306
+ ('e8 形Aの書き方で実在しない場所を名指し',
307
+ G + ' -rn ' + DQ + 'x ' + WORD + "\\|y' " + os.path.join(SITE, 'nosuch')),
308
+ ('e9 形Aの書き方でしるし(*)を含む場所',
309
+ G + ' -rn ' + DQ + 'x ' + WORD + "\\|y' " + os.path.join(SITE, 'src', '*.ts')),
310
+ ('e10 探す文字がファイルに在る旗(-f の値が秘密)',
311
+ G + ' -rn -f ' + SECRET + ' ' + SRC),
312
+ ('e11 形Aの書き方で記録の外まで読む旗つき・場所なし',
313
+ GG + ' --untracked -n ' + DQ + 'x ' + WORD + "\\|y'"),
314
+ ('e12 find で秘密のファイルを名指し', FIND + ' ' + SECRET + ' -exec ' + READ + ' {} +'),
315
+ ('e13 find で秘密のファイルを名前で並べて渡す', FIND + ' ' + SECRET + ' | xargs ' + READ),
316
+ ('e14 find で普通のファイルと秘密のファイルを並べる',
317
+ FIND + ' ' + FILE1 + ' ' + SECRET + ' -exec ' + READ + ' {} +'),
318
+ ('e15 find の -exec の側に秘密のファイルを書く',
319
+ FIND + ' ' + FILE1 + ' -exec ' + READ + ' ' + SECRET + ' +'),
320
+ ('e16 find で秘密を含むフォルダを名指し',
321
+ FIND + ' ' + WITHSECRET + ' -exec ' + READ + ' {} +'),
322
+ ('e17 find で秘密を含むフォルダとファイルを並べる',
323
+ FIND + ' ' + WITHSECRET + ' ' + FILE1 + ' -exec ' + READ + ' {} +'),
324
+ ('e18 find で作業場所の根', FIND + ' ' + SITE + ' -exec ' + READ + ' {} +'),
325
+ ('e19 find で場所を書かない', FIND + ' -name x -exec ' + READ + ' {} +'),
326
+ ('e20 find で実在しない場所を名指し',
327
+ FIND + ' ' + os.path.join(SITE, 'nosuch') + ' -exec ' + READ + ' {} +'),
328
+ ('e21 秘密のファイルを読む(別の動詞)', READ + ' ' + SECRET),
329
+ ]
330
+ for label, cmd in STOP:
331
+ check(label, kind(cmd), 'deny:danger')
332
+ check('e22 形Bの理由は本物の秘密の名前を指す',
333
+ NPMRC in reason(FIND + ' ' + SECRET + ' -exec ' + READ + ' {} +'), True)
334
+ check('e23 倒した旨の注は今までどおり出る',
335
+ '探す場所を書いていない' in reason(G + ' -rn ' + DQ + 'x ' + WORD + "\\|y'"), True)
336
+
337
+ # ═════════════════════════════════════════════════════════════════════════════
338
+ # (f) 同じ行に混ざった別の危険は、今までどおり先に当たる
339
+ # ═════════════════════════════════════════════════════════════════════════════
340
+ print('── (f) 混ざった形は今までどおり止まる ' + '─' * 28)
341
+ MIXED = [
342
+ ('f1 形Aのあとで秘密を読む',
343
+ G + ' -rn ' + DQ + 'x ' + WORD + "\\|y' " + SRC + '; ' + READ + ' ' + SECRET),
344
+ ('f2 形Bのあとで強い上書きの push',
345
+ FIND + ' ' + FILE1 + ' -exec ' + READ + ' {} + && git push --force origin main'),
346
+ ('f3 形Bのあとで根を find',
347
+ FIND + ' ' + FILE1 + ' -exec ' + READ + ' {} + ; ' + FIND + ' ' + SITE
348
+ + ' -exec ' + READ + ' {} +'),
349
+ ('f4 形Aのあとで変数を含む再帰の削除',
350
+ G + ' -rn ' + DQ + 'x ' + WORD + "\\|y' " + SRC + ' && rm -r "$DIR/x"'),
351
+ ('f5 形Bのあとでフォルダごとの複製',
352
+ FIND + ' ' + FILE1 + ' -exec ' + READ + ' {} + ; cp -r ' + SITE + ' /tmp/claude-1000/c'),
353
+ ]
354
+ for label, cmd in MIXED:
355
+ check(label, kind(cmd), 'deny:danger')
356
+
357
+ # ═════════════════════════════════════════════════════════════════════════════
358
+ # (g) 部品の単体
359
+ # ═════════════════════════════════════════════════════════════════════════════
360
+ print('── (g) 部品の単体 ' + '─' * 54)
361
+ NAIVE = [
362
+ ('g1 引用符が閉じていない区切りは素朴分割へ倒れる', G + " -rn 'a b\\", True),
363
+ ('g2 $'"'"'…\' で閉じていない区切りも倒れる', G + ' -rn ' + DQ + 'a b\\', True),
364
+ ('g3 引用符が閉じている区切りは倒れない', G + " -rn 'a b' " + SRC, False),
365
+ ('g4 引用符が無い区切りは倒れない', G + ' -rn abc ' + SRC, False),
366
+ ('g5 途中に引用符が1つ入る形は倒れない', G + ' -rn "it' + Q + 's" ' + SRC, False),
367
+ ('g6 空の字面', '', False),
368
+ ('g7 None', None, False),
369
+ ]
370
+ for label, seg, want in NAIVE:
371
+ check(label, policy.naive_token_split(seg), want)
372
+
373
+ SPAN = [
374
+ ('g8 倒れたときは引用符が閉じるまで外す',
375
+ ['-n', DQ + 'a', 'b', 'c'], 1, True, [1, 2, 3]),
376
+ ('g9 倒れたときは閉じる所で止まる',
377
+ ['-n', DQ + 'a', "b'", 'c'], 1, True, [1, 2]),
378
+ ('g10 倒れたとき・引用符で始まる語(前からの形)',
379
+ ['-n', "'a", 'b'], 1, True, [1, 2]),
380
+ ('g11 倒れたとき・引用符が無い語は1語だけ', ['-n', 'a', 'b'], 1, True, [1]),
381
+ ('g12 倒れていなければ続きを1つも外さない',
382
+ ['-n', DQ + 'a', 'b', 'c'], 1, False, [1]),
383
+ ('g13 倒れていなければ引用符で始まる語でも1語だけ',
384
+ ['-n', "'a", 'b'], 1, False, [1]),
385
+ ]
386
+ for label, args, first, naive, want in SPAN:
387
+ check(label, policy._pattern_word_positions(args, first, naive=naive), want)
388
+
389
+ POS = [
390
+ ('g14 倒れた区切りを渡すと続きも外す', 'grep', ['-n', DQ + 'a', 'b.ts'], '"', {1, 2}),
391
+ ('g15 倒れていない区切りでは外さない', 'grep', ['-n', DQ + 'a', 'b.ts'], None, {1}),
392
+ ('g16 -f が在れば倒れていても1つも外さない',
393
+ 'grep', ['-f', 'p.txt', DQ + 'a', 'b.ts'], '"', set()),
394
+ ('g17 探す道具でなければ1つも外さない', 'cat', [DQ + 'a', 'b.ts'], '"', set()),
395
+ ]
396
+ for label, verb, args, seg, want in POS:
397
+ check(label, set(policy.pattern_arg_positions(verb, args, seg)), want)
398
+
399
+ check('g18 実在のファイルはその場所を返す', policy._existing_file(FILE1, SITE),
400
+ os.path.realpath(FILE1))
401
+ check('g19 実在のフォルダはファイルではない', policy._existing_file(SRC, SITE), None)
402
+ check('g20 実在しない名前は返さない', policy._existing_file('nosuch.ts', SITE), None)
403
+
404
+ # ═════════════════════════════════════════════════════════════════════════════
405
+ # (h) 空振り確認(直しを外すと、この台本が落ちる)
406
+ # ═════════════════════════════════════════════════════════════════════════════
407
+ print('── (h) 空振り確認(直しを外すと落ちる) ' + '─' * 32)
408
+ _real_span = policy._pattern_word_positions
409
+ _real_file = policy._existing_file
410
+
411
+ A_FORM = G + ' -n ' + DQ + 'env: ' + WORD + "\\|home:' " + FILE1
412
+ B_FORM = FIND + ' ' + FILE1 + ' -exec ' + READ + ' {} +'
413
+ C_FORM = G + ' -rn "' + Q + '" ' + SRC
414
+ H_FORM = G + ' -n "' + Q + '" ' + SECRET
415
+
416
+
417
+ def _old_span(args, first, word=None, naive=False):
418
+ """直す前の読み方(最初の語が引用符そのもので始まるときだけ続きを外す・便 18e9e32e)。"""
419
+ out = [first]
420
+ word = args[first] if word is None else word
421
+ if word[:1] not in ('"', "'"):
422
+ return out
423
+ quote = policy._open_quote(word)
424
+ i = first + 1
425
+ while quote and i < len(args):
426
+ out.append(i)
427
+ quote = policy._open_quote(args[i], quote)
428
+ i += 1
429
+ return out
430
+
431
+
432
+ policy._pattern_word_positions = _old_span
433
+ check('h1 旧い読み方に戻すと形Aが止まる', kind(A_FORM), 'deny:danger')
434
+ check('h2 旧い読み方に戻すと形Cも止まる', kind(C_FORM), 'deny:danger')
435
+ check('h3 旧い読み方に戻すと穴Hが通ってしまう', kind(H_FORM), 'allow')
436
+ check('h4 旧い読み方でも形Bは別の直し(通ったまま)', kind(B_FORM), 'allow')
437
+ policy._pattern_word_positions = _real_span
438
+
439
+ policy._existing_file = lambda arg, cwd=None: None
440
+ check('h5 実在のファイルを読まない作りに戻すと形Bが止まる', kind(B_FORM), 'deny:danger')
441
+ check('h6 そのときも形Aは通る(2つの原因は別物)', kind(A_FORM), 'allow')
442
+ policy._existing_file = _real_file
443
+
444
+ check('h7 戻したら4つの形が期待どおり',
445
+ (kind(A_FORM), kind(B_FORM), kind(C_FORM), kind(H_FORM)),
446
+ ('allow', 'allow', 'allow', 'deny:danger'))
447
+
448
+ #: 形D の空振り(繋げた書き方を読む部品を外すと、名指しの場所が探す文字として捨てられる)
449
+ _real_joined = policy._disc_pattern_joined
450
+ D_FORM = G + ' -rn --regexp=needle ' + SRC
451
+ D_STOP = G + ' -rn --regexp=needle'
452
+
453
+ policy._disc_pattern_joined = lambda w: False
454
+ check('h8 繋げた書き方を読まない作りに戻すと形Dが止まる', kind(D_FORM), 'deny:discipline')
455
+ check('h9 そのときも形A・形Bは通る(原因が別物)', (kind(A_FORM), kind(B_FORM)),
456
+ ('allow', 'allow'))
457
+ policy._disc_pattern_joined = _real_joined
458
+
459
+ check('h10 戻したら形Dは通り、場所を書かない形は止まる',
460
+ (kind(D_FORM), kind(D_STOP, PLAIN)), ('allow', 'deny:discipline'))
461
+
462
+ # ─────────────────────────────────────────────────────────────────────────────
463
+ # ★作り物を片付ける(使い捨ての場所に残骸を残さない・便 de82bc3a のコミット a5118c7 と同じ作法)
464
+ import shutil # noqa: E402
465
+
466
+ shutil.rmtree(ROOT, ignore_errors=True)
467
+ check('z1 作り物を片付けた', os.path.isdir(ROOT), False)
468
+
469
+ print()
470
+ if failures:
471
+ print(f'NG {len(failures)} 件')
472
+ for line in failures:
473
+ print(' ' + line)
474
+ sys.exit(1)
475
+ print('すべて OK')
@@ -227,6 +227,11 @@ check('f5 途中の引用符でも秘密を名指しすれば止まる', kind(G
227
227
  # (g) 部品の単体
228
228
  # ═════════════════════════════════════════════════════════════════════════════
229
229
  print('── (g) 部品の単体 ' + '─' * 54)
230
+ #: ★語の割り方が素朴分割へ倒れた区切り(引用符が閉じていない)を表す字面。
231
+ # 便 362a7759 から、割れた探す言葉の続きを外すかは「倒れたかどうか」で決まるので、
232
+ # 割れた語の並びを渡す行には、倒れた区切りの字面も一緒に渡す(前提データ)。
233
+ BROKEN = '"'
234
+ #: (番号と何の形か, 動詞, 語の並び, 外す位置, 測っている区切りの字面)
230
235
  POS = [
231
236
  ('g1 旗でない最初の引数が探す文字', 'grep', ['-n', 'needle', 'a.ts'], {1}),
232
237
  ('g2 探す道具でなければ1つも外さない', 'cat', ['needle', 'a.ts'], set()),
@@ -241,22 +246,24 @@ POS = [
241
246
  ('g10 引数が旗だけ', 'grep', ['-rn'], set()),
242
247
  ('g11 引数が無い', 'grep', [], set()),
243
248
  ('g12 閉じていない引用符で始まる語は続きも外す',
244
- 'grep', ['-n', "'env: " + WORD, 'rest'], {1, 2}),
249
+ 'grep', ['-n', "'env: " + WORD, 'rest'], {1, 2}, BROKEN),
245
250
  ('g13 引用符で始まらない語は続きを外さない', 'grep', ['-n', 'env:', WORD], {1}),
246
251
  ('g14 引用符が閉じている語は続きを外さない', 'grep', ['-n', "'a'", 'a.ts'], {1}),
247
252
  ('g15 閉じていない語が閉じる所まで外す',
248
- 'grep', ['-n', '"a', 'b"', 'a.ts'], {1, 2}),
253
+ 'grep', ['-n', '"a', 'b"', 'a.ts'], {1, 2}, BROKEN),
249
254
  ('g16 -e の値も引用符が閉じるまで外す(値が割れる形)',
250
- 'grep', ['-e', '"a', 'b"', 'a.ts'], {1, 2}),
255
+ 'grep', ['-e', '"a', 'b"', 'a.ts'], {1, 2}, BROKEN),
251
256
  ('g17 -e の値が閉じていなければ残りが全部探す文字',
252
- 'grep', ['-e', "'a", 'b', 'c'], {1, 2, 3}),
257
+ 'grep', ['-e', "'a", 'b', 'c'], {1, 2, 3}, BROKEN),
253
258
  ('g18 -e の値が引用符で始まらなければ値1語だけ',
254
259
  'grep', ['-e', 'a', 'b.ts'], {1}),
255
260
  ('g19 --regexp= の値が割れる形(旗の部分は見ない)',
256
- 'grep', ['--regexp="a', 'b"', 'a.ts'], {0, 1}),
261
+ 'grep', ['--regexp="a', 'b"', 'a.ts'], {0, 1}, BROKEN),
257
262
  ]
258
- for label, verb, args, want in POS:
259
- check(label, set(policy.pattern_arg_positions(verb, args)), want)
263
+ for row in POS:
264
+ label, verb, args, want = row[:4]
265
+ seg = row[4] if len(row) > 4 else None
266
+ check(label, set(policy.pattern_arg_positions(verb, args, seg)), want)
260
267
 
261
268
  QUOTE = [
262
269
  ('h1 単引用符が開いたまま', "'env: " + WORD, None, "'"),
@@ -274,11 +281,11 @@ for label, text, state, want in QUOTE:
274
281
  check(label, policy._open_quote(text, state), want)
275
282
 
276
283
  check('h11 探す言葉の語の広がり(閉じていない)',
277
- policy._pattern_word_positions(['-n', "'a", 'b', 'c'], 1), [1, 2, 3])
284
+ policy._pattern_word_positions(['-n', "'a", 'b', 'c'], 1, naive=True), [1, 2, 3])
278
285
  check('h12 探す言葉の語の広がり(閉じる所で止まる)',
279
- policy._pattern_word_positions(['-n', "'a", "b'", 'c'], 1), [1, 2])
286
+ policy._pattern_word_positions(['-n', "'a", "b'", 'c'], 1, naive=True), [1, 2])
280
287
  check('h13 探す言葉の語の広がり(引用符で始まらない)',
281
- policy._pattern_word_positions(['-n', 'a', 'b'], 1), [1])
288
+ policy._pattern_word_positions(['-n', 'a', 'b'], 1, naive=True), [1])
282
289
 
283
290
  # ═════════════════════════════════════════════════════════════════════════════
284
291
  # (h) 空振り確認(直しを外すと、この台本が落ちる)
@@ -288,7 +295,7 @@ _real_positions = policy.pattern_arg_positions
288
295
  _real_span = policy._pattern_word_positions
289
296
 
290
297
 
291
- def _old_positions(verb, args):
298
+ def _old_positions(verb, args, seg=None):
292
299
  """直す前の読み方(最初の1語だけを外す・-e / -f が在れば1つも外さない)。"""
293
300
  if verb not in policy._PATTERN_FIRST_VERBS:
294
301
  return frozenset()
@@ -312,7 +319,9 @@ check('i3 直す前の読み方でも秘密の名指しは止まる(守りは
312
319
  kind(G + " -n 'x' " + SECRET), 'deny:danger')
313
320
  policy.pattern_arg_positions = _real_positions
314
321
 
315
- policy._pattern_word_positions = lambda args, first: [first] # ①だけを外す
322
+ policy._pattern_word_positions = (
323
+ lambda args, first, word=None, naive=False: [first] # ①だけを外す
324
+ )
316
325
  check('i4 ①を外すと空白+当て字の縦棒の形が止まる',
317
326
  kind(G + " -n 'env: " + WORD + "\\|home:' " + FILE1), 'deny:danger')
318
327
  check('i5 ①を外しても -e の形は通る(②は別の直し)',
@@ -170,6 +170,35 @@ preflight_claude_candidates() {
170
170
  return 0
171
171
  }
172
172
 
173
+ # 中継の候補の先頭=いちばん新しい nvm の Node の bin(npm が在る物だけ・無ければ空)。
174
+ # ★ここの npm で入れた claude は、同じ bin に入る=中継が真っ先に見つける置き場。
175
+ preflight_nvm_bin() {
176
+ local c d
177
+ while IFS= read -r c; do
178
+ d="${c%/claude}"
179
+ case "$d" in
180
+ "$HOME"/.nvm/versions/node/*/bin) [[ -x "$d/npm" ]] && { printf '%s' "$d"; return 0; } ;;
181
+ esac
182
+ done < <(CONDUCTOR_CLAUDE_BIN='' preflight_claude_candidates)
183
+ return 0
184
+ }
185
+
186
+ # claude が無いときの「中継が見つけられる置き場へ入れる」1行(便 a940fa1a)。
187
+ # 【なぜ(実物 2026-10-20・自宅PC)】素の `npm install -g …` は、PATH の先にいる npm(fnm など
188
+ # 中継が見ない置き場)へ入れてしまい、入れたのに中継は「見つかりません」のままだった。
189
+ # ・nvm の Node が在る → その npm を名指しで使う(同じ bin=中継の候補の先頭に入る)
190
+ # ・無い → 公式の入れ方(~/.local/bin/claude に入る=中継の候補)
191
+ # ★古い置き場の claude には触らない(消さない・上書きしない)。
192
+ preflight_claude_install_line() {
193
+ local d
194
+ d="$(preflight_nvm_bin)"
195
+ if [[ -n "$d" ]]; then
196
+ printf ' PATH="%s:$PATH" npm install -g @anthropic-ai/claude-code@latest\n' "$d"
197
+ else
198
+ printf ' curl -fsSL https://claude.ai/install.sh | bash\n'
199
+ fi
200
+ }
201
+
173
202
  # その claude の入れ方に合う更新の1行(src/headless.ts の claudeUpdateHint と同じ見分け方)。
174
203
  preflight_claude_update_line() {
175
204
  local bin="$1" real="$1" t i
@@ -232,8 +261,8 @@ preflight_check() {
232
261
  PREFLIGHT_INFO+="⚠ 職人のソフト(Claude Code)の版を確かめられませんでした(${unknown})。"$'\n'
233
262
  elif [[ "$claude_mode" == "need" ]]; then
234
263
  PREFLIGHT_NG+="■ 職人のソフト(Claude Code)が見つかりません。"$'\n'
235
- PREFLIGHT_NG+=" 入れる1行:"$'\n'
236
- PREFLIGHT_NG+=" npm install -g @anthropic-ai/claude-code@latest"$'\n'
264
+ PREFLIGHT_NG+=" 常駐が見つけられる置き場へ入れる1行:"$'\n'
265
+ PREFLIGHT_NG+="$(preflight_claude_install_line)"$'\n'
237
266
  fi
238
267
 
239
268
  # ── ② 囲いの部品(その機の仕組みに要る物だけ) ──
@@ -246,12 +275,14 @@ preflight_check() {
246
275
  PREFLIGHT_NG+="■ 囲いの部品が足りません:${missing}"$'\n'
247
276
  PREFLIGHT_NG+=" (無いと、職人が安全のため起動を断ります)"$'\n'
248
277
  if command -v apt-get >/dev/null 2>&1; then
249
- PREFLIGHT_NG+=" 入れる1行(Ubuntu のパスワードを聞かれます):"$'\n'
250
- PREFLIGHT_NG+=" sudo apt-get install -y bubblewrap socat"$'\n'
278
+ # ★索引(ソフトの一覧)を新しくしてから入れる(便 a940fa1a)。入れたばかりの PC は索引が
279
+ # 空・古いことがあり、入れる命令だけでは「見つかりません」で止まった(実物 2026-10-20・自宅PC)。
280
+ PREFLIGHT_NG+=" 入れる1行(ソフトの一覧を新しくしてから入れます・Ubuntu のパスワードを聞かれます):"$'\n'
281
+ PREFLIGHT_NG+=" sudo apt-get update && sudo apt-get install -y bubblewrap socat"$'\n'
251
282
  # ★WSL かどうか(検査は CONDUCTOR_PROC_VERSION_FILE で見本を渡せる・既定は本物)
252
283
  if [[ -r "${CONDUCTOR_PROC_VERSION_FILE:-/proc/version}" ]] && grep -qi microsoft "${CONDUCTOR_PROC_VERSION_FILE:-/proc/version}"; then
253
284
  PREFLIGHT_NG+=" sudo のパスワードが分からないとき(Windows の PowerShell で打つ):"$'\n'
254
- PREFLIGHT_NG+=" wsl.exe -u root apt-get install -y bubblewrap socat"$'\n'
285
+ PREFLIGHT_NG+=" wsl.exe -u root sh -c \"apt-get update && apt-get install -y bubblewrap socat\""$'\n'
255
286
  fi
256
287
  else
257
288
  PREFLIGHT_NG+=" この機の入れ方で bubblewrap と socat を入れてください(apt-get が見つかりません)。"$'\n'