@tyhld/conductor 0.12.147 → 0.12.149
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/dist/selfcheck.js +80 -2
- package/package.json +2 -1
- package/sales-template/setup.sh +42 -3
- package/scripts/hooks/cc2_guard.py +9 -1
- package/scripts/hooks/policy.py +125 -18
- package/scripts/hooks/test_dollar_quote_and_find_file.py +4 -2
- package/scripts/hooks/test_guard_search_glob_after_danger.py +263 -0
- package/scripts/hooks/test_search_word_not_path.py +4 -1
- package/scripts/site-guard-local.py +350 -0
- package/scripts/update-guard.sh +400 -155
- package/skills/conductor-craftsman/SKILL.md +1 -1
|
@@ -0,0 +1,263 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""番人の直し(便 e338e926)の検査: printenv の区切りごとの判定・`*` と変数の展開・
|
|
3
|
+
danger のあとの完了の知らせの読み込み。
|
|
4
|
+
|
|
5
|
+
実行: python3 scripts/hooks/test_guard_search_glob_after_danger.py
|
|
6
|
+
1件でも期待と違えば exit 1。
|
|
7
|
+
|
|
8
|
+
【なぜ要るか(実地)】
|
|
9
|
+
① 便 0d887e4e・11265a0a・4cde5905 … 調べる・確かめる命令の【探す言葉】の中の printenv の字だけで
|
|
10
|
+
danger になり、便が止まった(全文の字面で見ていた)。
|
|
11
|
+
② 便 1ce88b73・10905140 … 再帰の検索の場所に `*` や変数を書くと、字面のまま実在を確かめて
|
|
12
|
+
解けず、作業場所に倒れて根の秘密ファイルに当たって止まった。
|
|
13
|
+
③ 便 0d887e4e・11265a0a・4cde5905 … danger のあと、完了の知らせの道具を読み込む ToolSearch が
|
|
14
|
+
止められ、conductor_complete を呼べなかった。
|
|
15
|
+
|
|
16
|
+
【ここで固定すること】
|
|
17
|
+
(p) printenv … 名前なし・名前2つ以上・旗・秘密の名前は止まる。秘密でない名前1つは通る。
|
|
18
|
+
探すだけの道具の引用符の中の字は通る。実際に打った物・ヒアドキュメントの本文は止まる。
|
|
19
|
+
(g) `*`・変数 … 展開して当たった物を今の判定に当てる。秘密に当たれば止まる。
|
|
20
|
+
当たり0件・名前が決まらない変数は、今までどおり作業場所に倒して止まる。
|
|
21
|
+
(d) danger のあと … ToolSearch の query が select:mcp__ai-kana__conductor_complete ちょうどの
|
|
22
|
+
ときだけ通る。ほかの道具の読み込みは止まる。
|
|
23
|
+
(v) ★空振り確認 … 直した所を外すと、上の期待が実際に崩れる。
|
|
24
|
+
|
|
25
|
+
★本物のホーム・本物の秘密には1バイトも触れない。作り物の置き場で判定する。
|
|
26
|
+
"""
|
|
27
|
+
import json
|
|
28
|
+
import os
|
|
29
|
+
import shutil
|
|
30
|
+
import sys
|
|
31
|
+
import tempfile
|
|
32
|
+
|
|
33
|
+
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
|
|
34
|
+
|
|
35
|
+
failures = []
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
def check(label, got, want):
|
|
39
|
+
ok = got == want
|
|
40
|
+
if not ok:
|
|
41
|
+
failures.append(f'{label}: got={got!r} want={want!r}')
|
|
42
|
+
print(f'{"OK " if ok else "NG "} {label:72} {str(got)[:40]}')
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
def truthy(label, got):
|
|
46
|
+
check(label, bool(got), True)
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
50
|
+
# 作り物の置き場(★本物のホーム・本物の秘密には触れない)
|
|
51
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
52
|
+
ROOT = tempfile.mkdtemp(prefix='guard-e338e926-',
|
|
53
|
+
dir='/tmp/claude-1000' if os.path.isdir('/tmp/claude-1000') else None)
|
|
54
|
+
HOME = os.path.join(ROOT, 'home', 'tester')
|
|
55
|
+
STATE = os.path.join(ROOT, 'state')
|
|
56
|
+
WORK = os.path.join(HOME, 'projects', 'demo')
|
|
57
|
+
SITE = 'demo'
|
|
58
|
+
JOB = 'e338e926-93fd-476e-bdf6-5245c74e6cb8'
|
|
59
|
+
SESSION = 'se-e338e926'
|
|
60
|
+
|
|
61
|
+
|
|
62
|
+
def mk(path, body=''):
|
|
63
|
+
os.makedirs(os.path.dirname(path), exist_ok=True)
|
|
64
|
+
with open(path, 'w', encoding='utf-8') as f:
|
|
65
|
+
f.write(body)
|
|
66
|
+
return path
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
os.makedirs(os.path.join(WORK, '.git'), exist_ok=True)
|
|
70
|
+
mk(os.path.join(WORK, '.npmrc'), 'dummy\n') # 偽の秘密(作業場所の根)
|
|
71
|
+
mk(os.path.join(WORK, 'pkg', '.npmrc'), 'dummy\n') # 偽の秘密(フォルダの中)
|
|
72
|
+
mk(os.path.join(WORK, 'src', 'a.ts'), 'export const a = 1\n')
|
|
73
|
+
mk(os.path.join(WORK, 'src', 'b.ts'), 'export const b = 2\n')
|
|
74
|
+
mk(os.path.join(WORK, 'docs', 'x.md'), '# x\n')
|
|
75
|
+
os.environ['HOME'] = HOME
|
|
76
|
+
os.environ['TMPDIR'] = ROOT
|
|
77
|
+
os.environ['XDG_STATE_HOME'] = STATE
|
|
78
|
+
os.environ['CONDUCTOR_SITE'] = SITE
|
|
79
|
+
os.environ['CONDUCTOR_GUARD_LOG'] = os.path.join(ROOT, 'guard.log')
|
|
80
|
+
os.environ.pop('CONDUCTOR_REPORT_DIR', None)
|
|
81
|
+
os.environ.pop('CONDUCTOR_URL', None)
|
|
82
|
+
os.environ.pop('CONDUCTOR_TOKEN', None)
|
|
83
|
+
mk(os.path.join(STATE, 'conductor', f'active-job-{SITE}.json'),
|
|
84
|
+
json.dumps({'commandId': JOB, 'site': SITE, 'body': 'x'}))
|
|
85
|
+
|
|
86
|
+
import cc2_guard # noqa: E402
|
|
87
|
+
import hook_datalink # noqa: E402
|
|
88
|
+
import policy # noqa: E402
|
|
89
|
+
|
|
90
|
+
|
|
91
|
+
def decide(cmd, cwd=WORK):
|
|
92
|
+
return policy.decide_bash(cmd, cwd)['decision']
|
|
93
|
+
|
|
94
|
+
|
|
95
|
+
def reason(cmd, cwd=WORK):
|
|
96
|
+
return policy.decide_bash(cmd, cwd)['reason']
|
|
97
|
+
|
|
98
|
+
|
|
99
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
100
|
+
# (p) printenv
|
|
101
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
102
|
+
print('── (p) printenv ' + '─' * 54)
|
|
103
|
+
P_ALLOW = [
|
|
104
|
+
# 実地の形(探す言葉の中の字・調べる/確かめる命令)
|
|
105
|
+
('p1 探す言葉の中(grep・名指しのファイル)', "grep -n 'printenv' src/a.ts"),
|
|
106
|
+
('p2 探す言葉の中(grep -rn・名指しのフォルダ)', 'grep -rn "\\bprintenv\\b" src docs'),
|
|
107
|
+
('p3 探す言葉の中(git grep)', "git grep -n 'printenv' -- src"),
|
|
108
|
+
('p4 探す言葉の中(rg)', "rg -n 'printenv|_danger_patterns' src"),
|
|
109
|
+
('p5 探す言葉の中(grep -e を2つ)', "grep -n -e 'printenv' -e 'home' src/a.ts"),
|
|
110
|
+
('p6 秘密でない名前を1つだけ出す', 'printenv HOME'),
|
|
111
|
+
('p7 秘密でない名前を1つだけ出す(PATH)', 'printenv PATH'),
|
|
112
|
+
]
|
|
113
|
+
for label, cmd in P_ALLOW:
|
|
114
|
+
check(label, decide(cmd), policy.ALLOW)
|
|
115
|
+
|
|
116
|
+
P_DENY = [
|
|
117
|
+
('p10 名前なし(一括)', 'printenv'),
|
|
118
|
+
('p11 名前2つ以上', 'printenv HOME PATH'),
|
|
119
|
+
('p12 旗', 'printenv -0'),
|
|
120
|
+
('p13 秘密の名前(TOKEN)', 'printenv GITHUB_TOKEN'),
|
|
121
|
+
('p14 秘密の名前(DATABASE_URL)', 'printenv DATABASE_URL'),
|
|
122
|
+
('p15 秘密の名前(小文字で書いても)', 'printenv api_key'),
|
|
123
|
+
('p16 探した後で実際に打つ(;)', 'grep x src/a.ts; printenv'),
|
|
124
|
+
('p17 探した後で実際に打つ(&&)', "grep -n 'printenv' src/a.ts && printenv"),
|
|
125
|
+
('p18 流し込む先で打つ(|)', "grep -n 'printenv' src/a.ts | printenv"),
|
|
126
|
+
('p19 ヒアドキュメントの本文', 'cat <<EOF\nprintenv\nEOF'),
|
|
127
|
+
('p20 探すだけでない道具の引用符の中', "echo 'printenv'"),
|
|
128
|
+
('p21 包みの中', "bash -c 'printenv'"),
|
|
129
|
+
('p22 探す言葉に見せた置き換えの実行', 'grep x "$(printenv)" src/a.ts'),
|
|
130
|
+
('p23 逆引用符の置き換え', 'grep x `printenv` src/a.ts'),
|
|
131
|
+
('p24 引用符の外の探す言葉(字が本物の位置に在る)', 'grep -n printenv src/a.ts'),
|
|
132
|
+
('p25 名前を置き換えで渡す', 'printenv $(cat names.txt)'),
|
|
133
|
+
('p26 流し込みで名前を並べる', 'echo HOME | xargs printenv'),
|
|
134
|
+
('p27 注釈の中(どの区切りにも見つからない字)', 'git status # printenv'),
|
|
135
|
+
]
|
|
136
|
+
for label, cmd in P_DENY:
|
|
137
|
+
check(label, decide(cmd), policy.DENY)
|
|
138
|
+
truthy('p★ 止めた理由は今までどおりの文', reason('printenv').startswith('danger: printenv'))
|
|
139
|
+
|
|
140
|
+
# env の一括表示は今の判定を変えない(★この便では触っていない・今の判定を記録して固定する)。
|
|
141
|
+
# ★番人は今これを止めていない(allow)。止めるかどうかは持ち主の判断(便 e338e926 の報告の要判断)。
|
|
142
|
+
# 止める側へ直したときは、この期待を DENY へ書き換える。
|
|
143
|
+
ENV_BULK = 'env'
|
|
144
|
+
print(f' (記録)env の一括の判定: {policy.decide_bash(ENV_BULK, WORK)}')
|
|
145
|
+
check('p30 env の一括は今の判定のまま(変えていない)', decide(ENV_BULK), policy.ALLOW)
|
|
146
|
+
|
|
147
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
148
|
+
# (g) `*` と変数
|
|
149
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
150
|
+
print('── (g) `*` と変数 ' + '─' * 52)
|
|
151
|
+
G_ALLOW = [
|
|
152
|
+
('g1 `*` が秘密でないファイルだけに当たる', 'grep -rn export src/*.ts'),
|
|
153
|
+
('g2 `*` が秘密でないフォルダだけに当たる', 'grep -rn export s*'),
|
|
154
|
+
('g4 変数で書いた場所($名前)', 'D=src; grep -rn export "$D"'),
|
|
155
|
+
('g5 変数で書いた場所(${名前})', 'D=src; grep -rn export ${D}/a.ts'),
|
|
156
|
+
('g6 変数と `*`', 'D=src; grep -rn export "$D"/*.ts'),
|
|
157
|
+
('g7 rg の隠しを読む旗でも当たりが秘密でなければ通る', 'rg --hidden export src/*'),
|
|
158
|
+
]
|
|
159
|
+
for label, cmd in G_ALLOW:
|
|
160
|
+
check(label, decide(cmd), policy.ALLOW)
|
|
161
|
+
# 根の `*` は隠しファイル(.npmrc)を当てない=シェルと同じ(★隠しでない秘密入りのフォルダが無い場所)
|
|
162
|
+
SUB = os.path.join(WORK, 'sub')
|
|
163
|
+
mk(os.path.join(SUB, '.npmrc'), 'dummy\n')
|
|
164
|
+
mk(os.path.join(SUB, 'c.ts'), 'export const c = 3\n')
|
|
165
|
+
mk(os.path.join(SUB, 'lib', 'd.ts'), 'export const d = 4\n')
|
|
166
|
+
check('g3 根の `*` は隠しファイルを当てない(シェルと同じ)',
|
|
167
|
+
decide('grep -rn export *', SUB), policy.ALLOW)
|
|
168
|
+
check('g3 同じ場所で隠しを当てる `.*` は止まる', decide('grep -rn export .*', SUB), policy.DENY)
|
|
169
|
+
check('g3 同じ場所で `*` を外すと作業場所として止まる', decide('grep -rn export', SUB), policy.DENY)
|
|
170
|
+
check('g3 `*` が秘密入りのフォルダ(pkg)に当たる根は止まる',
|
|
171
|
+
decide('grep -rn export *'), policy.DENY)
|
|
172
|
+
|
|
173
|
+
G_DENY = [
|
|
174
|
+
('g10 `*` が秘密のファイル(.npmrc)に当たる', 'grep -rn x .n*'),
|
|
175
|
+
('g11 `*` が秘密を含むフォルダに当たる', 'grep -rn x pk*'),
|
|
176
|
+
('g12 変数で書いた場所が秘密を含む', 'D=pkg; grep -rn x "$D"'),
|
|
177
|
+
('g13 変数で書いた場所が作業場所の根', 'D=.; grep -rn x $D'),
|
|
178
|
+
('g14 変数で書いた場所が秘密のファイル', 'F=.npmrc; grep -rn x "$F"'),
|
|
179
|
+
('g15 当たり0件の `*`', 'grep -rn x nothing-here*'),
|
|
180
|
+
('g16 名前が決まらない変数', 'grep -rn x "$NOPE"'),
|
|
181
|
+
('g17 名前が決まらない変数を名指しの場所に混ぜる', 'grep -rn x src "$NOPE"'),
|
|
182
|
+
('g18 場所を書かない(今までどおり)', 'grep -rn x'),
|
|
183
|
+
]
|
|
184
|
+
for label, cmd in G_DENY:
|
|
185
|
+
check(label, decide(cmd), policy.DENY)
|
|
186
|
+
truthy('g★ 決まらないときは作業場所として判定したと書く',
|
|
187
|
+
'作業場所として判定' in reason('grep -rn x "$NOPE"'))
|
|
188
|
+
|
|
189
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
190
|
+
# (d) danger のあとでも、完了の知らせの読み込みだけは通る
|
|
191
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
192
|
+
print('── (d) danger のあと ' + '─' * 49)
|
|
193
|
+
KEY = (SESSION, SITE, JOB)
|
|
194
|
+
|
|
195
|
+
|
|
196
|
+
def ev(tool, tin, session=SESSION, cwd=WORK):
|
|
197
|
+
return {'tool_name': tool, 'tool_input': tin, 'cwd': cwd, 'session_id': session}
|
|
198
|
+
|
|
199
|
+
|
|
200
|
+
def run(data):
|
|
201
|
+
out = cc2_guard.guard_output(data)
|
|
202
|
+
if not out:
|
|
203
|
+
return 'defer', ''
|
|
204
|
+
spec = out['hookSpecificOutput']
|
|
205
|
+
return spec['permissionDecision'], spec.get('permissionDecisionReason', '')
|
|
206
|
+
|
|
207
|
+
|
|
208
|
+
COMPLETE_LOAD = ev('ToolSearch', {'query': 'select:mcp__ai-kana__conductor_complete',
|
|
209
|
+
'max_results': 1})
|
|
210
|
+
hook_datalink.clear_danger_stop(*KEY)
|
|
211
|
+
dec, why = run(ev('Bash', {'command': 'printenv'}))
|
|
212
|
+
check('d1 一括の printenv は danger で止まる', dec, 'deny')
|
|
213
|
+
truthy('d1 印が置かれた', hook_datalink.danger_stop_active(*KEY))
|
|
214
|
+
|
|
215
|
+
truthy('d2 完了の知らせの読み込みは通る', run(COMPLETE_LOAD)[0] != 'deny')
|
|
216
|
+
truthy('d2 止めた文に、通す物として読み込みが書いてある',
|
|
217
|
+
'select:mcp__ai-kana__conductor_complete' in run(ev('Bash', {'command': 'ls'}))[1])
|
|
218
|
+
D_DENY = [
|
|
219
|
+
('d3 ほかの道具の読み込み', ev('ToolSearch', {'query': 'select:WebFetch', 'max_results': 1})),
|
|
220
|
+
('d4 完了の知らせに別の道具を混ぜた読み込み',
|
|
221
|
+
ev('ToolSearch', {'query': 'select:mcp__ai-kana__conductor_complete,WebFetch',
|
|
222
|
+
'max_results': 2})),
|
|
223
|
+
('d5 言葉で探す読み込み', ev('ToolSearch', {'query': 'conductor_complete', 'max_results': 5})),
|
|
224
|
+
('d6 query が無い読み込み', ev('ToolSearch', {'max_results': 5})),
|
|
225
|
+
]
|
|
226
|
+
for label, data in D_DENY:
|
|
227
|
+
check(label, run(data)[0], 'deny')
|
|
228
|
+
check('d7 完了の知らせそのものは今までどおり通る',
|
|
229
|
+
run(ev('mcp__ai-kana__conductor_complete', {'commandId': JOB}))[0], 'allow')
|
|
230
|
+
|
|
231
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
232
|
+
# (v) ★空振り確認 … 直した所を外すと期待が崩れる
|
|
233
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
234
|
+
print('── (v) 空振り確認 ' + '─' * 52)
|
|
235
|
+
saved_pe = policy._printenv_danger
|
|
236
|
+
policy._printenv_danger = lambda command: None
|
|
237
|
+
check('v1 printenv の判定を外すと一括が通ってしまう', decide('printenv'), policy.ALLOW)
|
|
238
|
+
policy._printenv_danger = saved_pe
|
|
239
|
+
check('v1 戻すと止まる', decide('printenv'), policy.DENY)
|
|
240
|
+
|
|
241
|
+
saved_ex = policy._expand_read_arg
|
|
242
|
+
policy._expand_read_arg = lambda arg, values, cwd=None: [arg]
|
|
243
|
+
check('v2 展開を外すと `*` の検索が作業場所に倒れて止まる',
|
|
244
|
+
decide(G_ALLOW[0][1]), policy.DENY)
|
|
245
|
+
policy._expand_read_arg = saved_ex
|
|
246
|
+
check('v2 戻すと通る', decide(G_ALLOW[0][1]), policy.ALLOW)
|
|
247
|
+
|
|
248
|
+
saved_sel = cc2_guard._COMPLETE_TOOL_SELECT
|
|
249
|
+
cc2_guard._COMPLETE_TOOL_SELECT = '(外した)'
|
|
250
|
+
check('v3 一覧から外すと完了の知らせの読み込みが止まる', run(COMPLETE_LOAD)[0], 'deny')
|
|
251
|
+
cc2_guard._COMPLETE_TOOL_SELECT = saved_sel
|
|
252
|
+
truthy('v3 戻すと通る', run(COMPLETE_LOAD)[0] != 'deny')
|
|
253
|
+
|
|
254
|
+
hook_datalink.clear_danger_stop(*KEY)
|
|
255
|
+
shutil.rmtree(ROOT, ignore_errors=True) # ★作り物は毎回片付ける
|
|
256
|
+
|
|
257
|
+
print()
|
|
258
|
+
if failures:
|
|
259
|
+
print(f'NG {len(failures)} 件')
|
|
260
|
+
for f in failures:
|
|
261
|
+
print(' ', f)
|
|
262
|
+
sys.exit(1)
|
|
263
|
+
print('すべて期待どおり')
|
|
@@ -175,7 +175,10 @@ SAFE = [
|
|
|
175
175
|
('d4 点1つ', G + ' -rn x .'),
|
|
176
176
|
('d5 作業場所の根を名指し', G + ' -rn x ' + SITE + '/.'),
|
|
177
177
|
('d6 実在しない場所を名指し', G + ' -rn x ' + os.path.join(SITE, 'nope')),
|
|
178
|
-
|
|
178
|
+
# ★`*` は展開してから判定する(便 e338e926)。隠しを当てない `SITE/*` は src・clean だけに
|
|
179
|
+
# なって通るので、隠しを当てる印と当たり0件の形で、止まる側を確かめる。
|
|
180
|
+
('d7 しるし入りの場所(隠しを当てる印で秘密に当たる)', G + ' -rn x ' + SITE + '/.*'),
|
|
181
|
+
('d7b しるし入りの場所(当たり0件=作業場所に倒す)', G + ' -rn x ' + SITE + '/nope*'),
|
|
179
182
|
('d8 記録の外まで読む旗つきで根を探す', GG + ' --untracked -n x'),
|
|
180
183
|
('d9 -f の値が秘密のファイル(探す文字が書いてあるファイル=パス)',
|
|
181
184
|
G + ' -n -f ' + SECRET + ' ' + FILE1),
|
|
@@ -0,0 +1,350 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""現場の守りの設定を「リポに記録されない置き場」へ書くための部品(置き場は1か所だけ・便 9649ca05)。
|
|
3
|
+
|
|
4
|
+
【なぜ要るか(実地 2026-10-21・kenzokun 便 3f92f618/minoru 便 cd42ace0)】
|
|
5
|
+
配り直し(scripts/update-guard.sh の ③④)は、各現場の .claude/settings.json に守り(禁止の一覧・
|
|
6
|
+
囲いの書いてよい場所など)を直接書いていた。このファイルは多くの現場で git が記録しているので、
|
|
7
|
+
本流でも同じファイルが変わると、職人は最新の本流から枝を切れず(git が上書きを断る)着手前に止まった。
|
|
8
|
+
|
|
9
|
+
【決め(えふさん確定 2026-10-21)】
|
|
10
|
+
守りの中身は1つも弱めずに、書き込む先を .claude/settings.local.json へ移す。
|
|
11
|
+
・Claude Code はこのファイルを .claude/settings.json より【上の段】で読む(優先の順:
|
|
12
|
+
管理者 > 起動の指定 > settings.local.json > settings.json > ホーム)。
|
|
13
|
+
・一覧(permissions.deny・sandbox の一覧)は段をまたいで【足し合わせ】になり、どの段の deny も
|
|
14
|
+
ほかの段の allow より先に効く(出典 https://code.claude.com/docs/en/settings の
|
|
15
|
+
「Lists merge instead of overriding」と /docs/en/permissions の「If a tool is denied at any
|
|
16
|
+
level, no other level can allow it」。確認日 2026-10-21)。=置き場を移しても守りは弱まらない。
|
|
17
|
+
・値1つのキー(allowUnsandboxedCommands・disableBypassPermissionsMode)は上の段が勝つので、
|
|
18
|
+
settings.local.json に書けば settings.json の値より優先される。
|
|
19
|
+
|
|
20
|
+
【ここが受け持つこと】(★書き換えの中身=何を足すかは update-guard.sh ④ が決める。ここは置き場の話だけ)
|
|
21
|
+
・git の状態を読む(記録されているか・除外されているか・本流と違うか)。
|
|
22
|
+
・settings.local.json が記録されないことを確かめ、されていなければ .git/info/exclude に1行足す
|
|
23
|
+
(★リポのファイル=.gitignore は変えない)。
|
|
24
|
+
・移行:settings.json の本流との差が「采配くんが書いた物だけ」かを見分け、守りを
|
|
25
|
+
settings.local.json へ移してから、控えを残して本流の版へ戻す。
|
|
26
|
+
★人や職人が書いた変更が混ざっている・見分けられないときは戻さない(人へ知らせる)。
|
|
27
|
+
"""
|
|
28
|
+
|
|
29
|
+
import copy
|
|
30
|
+
import json
|
|
31
|
+
import os
|
|
32
|
+
import shutil
|
|
33
|
+
import subprocess
|
|
34
|
+
import time
|
|
35
|
+
|
|
36
|
+
__all__ = [
|
|
37
|
+
"SHARED", "LOCAL", "git_state", "ensure_excluded", "head_json", "classify",
|
|
38
|
+
"merge_carry", "restore", "is_ours_hook", "strip_our_hooks",
|
|
39
|
+
]
|
|
40
|
+
|
|
41
|
+
SHARED = ".claude/settings.json"
|
|
42
|
+
LOCAL = ".claude/settings.local.json"
|
|
43
|
+
# ★除外の1行。控え(.bak.<日時>)と書きかけ(.tmp)も一緒に外す=git status に出さない。
|
|
44
|
+
_EXCLUDE_SUFFIX = ".claude/settings.local.json*"
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
def _git(proj, *args):
|
|
48
|
+
"""git を読むだけ・書くだけで呼ぶ(★失敗しても例外にしない=台本を落とさない)。"""
|
|
49
|
+
try:
|
|
50
|
+
return subprocess.run(["git", "-C", proj, *args], capture_output=True, text=True, timeout=60)
|
|
51
|
+
except Exception:
|
|
52
|
+
return None
|
|
53
|
+
|
|
54
|
+
|
|
55
|
+
def _ok(r):
|
|
56
|
+
return r is not None and r.returncode == 0
|
|
57
|
+
|
|
58
|
+
|
|
59
|
+
def git_state(proj):
|
|
60
|
+
"""この現場の git の状態(★読むだけ)。
|
|
61
|
+
|
|
62
|
+
返す物:
|
|
63
|
+
repo … git のリポの中か
|
|
64
|
+
prefix … リポの根から現場までの道筋(根なら '')
|
|
65
|
+
shared_tracked… .claude/settings.json を git が記録しているか
|
|
66
|
+
local_tracked … .claude/settings.local.json を git が記録しているか(★記録されていたら書かない)
|
|
67
|
+
local_ignored … .claude/settings.local.json が除外されているか(.gitignore・info/exclude・全体の除外)
|
|
68
|
+
"""
|
|
69
|
+
st = {"repo": False, "prefix": "", "shared_tracked": False, "local_tracked": False, "local_ignored": False}
|
|
70
|
+
r = _git(proj, "rev-parse", "--is-inside-work-tree")
|
|
71
|
+
if not _ok(r) or r.stdout.strip() != "true":
|
|
72
|
+
return st
|
|
73
|
+
st["repo"] = True
|
|
74
|
+
p = _git(proj, "rev-parse", "--show-prefix")
|
|
75
|
+
st["prefix"] = p.stdout.strip() if _ok(p) else ""
|
|
76
|
+
st["shared_tracked"] = _ok(_git(proj, "ls-files", "--error-unmatch", "--", SHARED))
|
|
77
|
+
st["local_tracked"] = _ok(_git(proj, "ls-files", "--error-unmatch", "--", LOCAL))
|
|
78
|
+
st["local_ignored"] = _ok(_git(proj, "check-ignore", "-q", "--", LOCAL))
|
|
79
|
+
return st
|
|
80
|
+
|
|
81
|
+
|
|
82
|
+
def ensure_excluded(proj, st, apply_mode):
|
|
83
|
+
"""settings.local.json がリポに記録されないことを確かめ、されていなければ info/exclude に足す。
|
|
84
|
+
|
|
85
|
+
返す物: (状態, 説明)。状態は
|
|
86
|
+
'not-repo' … git のリポではない(記録されることが無い)
|
|
87
|
+
'ignored' … 既に除外されている(何もしない)
|
|
88
|
+
'tracked' … ★記録されている=除外では外せない(書かずに人へ知らせる)
|
|
89
|
+
'would-add'… 見るだけの回(足す予定)
|
|
90
|
+
'added' … .git/info/exclude に1行足した
|
|
91
|
+
'failed' … 足せなかった(書かずに人へ知らせる)
|
|
92
|
+
★リポのファイル(.gitignore)は変えない。足すのは各自の手元だけに効く .git/info/exclude だけ。
|
|
93
|
+
"""
|
|
94
|
+
if not st["repo"]:
|
|
95
|
+
return "not-repo", "git のリポではないので記録されません"
|
|
96
|
+
if st["local_tracked"]:
|
|
97
|
+
return "tracked", f"{LOCAL} を git が記録しています(除外では外せません)"
|
|
98
|
+
if st["local_ignored"]:
|
|
99
|
+
return "ignored", "既に除外されています"
|
|
100
|
+
line = "/" + st["prefix"] + _EXCLUDE_SUFFIX
|
|
101
|
+
if not apply_mode:
|
|
102
|
+
return "would-add", f".git/info/exclude に {line} を足す予定です"
|
|
103
|
+
r = _git(proj, "rev-parse", "--git-path", "info/exclude")
|
|
104
|
+
if not _ok(r) or not r.stdout.strip():
|
|
105
|
+
return "failed", "除外の置き場(.git/info/exclude)を読めません"
|
|
106
|
+
path = r.stdout.strip()
|
|
107
|
+
if not os.path.isabs(path):
|
|
108
|
+
path = os.path.join(proj, path)
|
|
109
|
+
try:
|
|
110
|
+
os.makedirs(os.path.dirname(path), exist_ok=True)
|
|
111
|
+
body = ""
|
|
112
|
+
if os.path.exists(path):
|
|
113
|
+
with open(path, encoding="utf-8") as f:
|
|
114
|
+
body = f.read()
|
|
115
|
+
if line not in body.splitlines():
|
|
116
|
+
with open(path, "a", encoding="utf-8") as f:
|
|
117
|
+
if body and not body.endswith("\n"):
|
|
118
|
+
f.write("\n")
|
|
119
|
+
f.write("# 采配くん: 現場の守りの設定(記録しない・update-guard.sh が足した)\n")
|
|
120
|
+
f.write(line + "\n")
|
|
121
|
+
except OSError as e:
|
|
122
|
+
return "failed", f"除外の置き場に書けません({e})"
|
|
123
|
+
if not _ok(_git(proj, "check-ignore", "-q", "--", LOCAL)):
|
|
124
|
+
return "failed", "除外を足しても外れていません"
|
|
125
|
+
return "added", f".git/info/exclude に {line} を足しました"
|
|
126
|
+
|
|
127
|
+
|
|
128
|
+
def head_json(proj):
|
|
129
|
+
"""本流の版(HEAD)の .claude/settings.json を読む。読めなければ None。"""
|
|
130
|
+
r = _git(proj, "show", "HEAD:./" + SHARED)
|
|
131
|
+
if not _ok(r):
|
|
132
|
+
return None
|
|
133
|
+
try:
|
|
134
|
+
return json.loads(r.stdout)
|
|
135
|
+
except Exception:
|
|
136
|
+
return None
|
|
137
|
+
|
|
138
|
+
|
|
139
|
+
def shared_dirty(proj):
|
|
140
|
+
"""settings.json が本流の版と違うか(作業場所・記録待ちのどちらか)。(違うか, 記録待ちに載っているか)"""
|
|
141
|
+
work = _git(proj, "diff", "--quiet", "HEAD", "--", SHARED)
|
|
142
|
+
staged = _git(proj, "diff", "--cached", "--quiet", "--", SHARED)
|
|
143
|
+
return (work is not None and work.returncode == 1), (staged is not None and staged.returncode == 1)
|
|
144
|
+
|
|
145
|
+
|
|
146
|
+
def is_ours_hook(entry, entrypoints):
|
|
147
|
+
"""番人の入口(cc2_guard/permission_request_hook/stop_hook…)を呼ぶ登録か(③ と同じ見分け方)。"""
|
|
148
|
+
if not isinstance(entry, dict):
|
|
149
|
+
return False
|
|
150
|
+
cmd = entry.get("command")
|
|
151
|
+
if not isinstance(cmd, str) or not cmd.strip():
|
|
152
|
+
return False
|
|
153
|
+
return os.path.basename(cmd.split()[-1]) in entrypoints
|
|
154
|
+
|
|
155
|
+
|
|
156
|
+
def strip_our_hooks(hooks, entrypoints):
|
|
157
|
+
"""hooks から番人の登録だけを外した形(③ と同じ外し方・空になった節は消す)。"""
|
|
158
|
+
if not isinstance(hooks, dict):
|
|
159
|
+
return hooks
|
|
160
|
+
out = {}
|
|
161
|
+
for ev, groups in hooks.items():
|
|
162
|
+
if not isinstance(groups, list):
|
|
163
|
+
out[ev] = groups
|
|
164
|
+
continue
|
|
165
|
+
kept = []
|
|
166
|
+
for g in groups:
|
|
167
|
+
if not isinstance(g, dict):
|
|
168
|
+
kept.append(g)
|
|
169
|
+
continue
|
|
170
|
+
entries = g.get("hooks") or []
|
|
171
|
+
keep = [h for h in entries if not is_ours_hook(h, entrypoints)]
|
|
172
|
+
if keep:
|
|
173
|
+
ng = dict(g)
|
|
174
|
+
ng["hooks"] = keep
|
|
175
|
+
kept.append(ng)
|
|
176
|
+
elif not entries:
|
|
177
|
+
kept.append(g)
|
|
178
|
+
if kept:
|
|
179
|
+
out[ev] = kept
|
|
180
|
+
return out or None
|
|
181
|
+
|
|
182
|
+
|
|
183
|
+
def _list_diff(work, head, allowed, label, why, carry_key, carry):
|
|
184
|
+
"""一覧の差を見分ける:足された物が allowed の中だけなら説明が付く(足した物は carry へ)。"""
|
|
185
|
+
w = work if isinstance(work, list) else ([] if work is None else None)
|
|
186
|
+
h = head if isinstance(head, list) else ([] if head is None else None)
|
|
187
|
+
if w is None or h is None:
|
|
188
|
+
why.append(f"{label} が一覧ではない")
|
|
189
|
+
return
|
|
190
|
+
removed = [x for x in h if x not in w]
|
|
191
|
+
if removed:
|
|
192
|
+
why.append(f"{label} から消えた行がある: {', '.join(map(str, removed))}")
|
|
193
|
+
added = [x for x in w if x not in h]
|
|
194
|
+
odd = [x for x in added if x not in allowed]
|
|
195
|
+
if odd:
|
|
196
|
+
why.append(f"{label} に采配くんが配らない行がある: {', '.join(map(str, odd))}")
|
|
197
|
+
carry[carry_key] = [x for x in added if x in allowed]
|
|
198
|
+
|
|
199
|
+
|
|
200
|
+
def classify(head, work, ctx):
|
|
201
|
+
"""settings.json の本流(head)との差が「采配くんが書いた物だけ」かを見分ける(★書き換えない)。
|
|
202
|
+
|
|
203
|
+
ctx: canonical_deny / retired / is_broken(関数) / domains / report_store / entrypoints
|
|
204
|
+
返す物:
|
|
205
|
+
ok … 差が全部、配り直し(④③)の書き方で説明が付く
|
|
206
|
+
why … 説明が付かない差(人や職人の変更・見分けられない物)
|
|
207
|
+
blockers … 戻すと守りが弱まる・二重になるので戻さない理由(本流の版そのものの事情)
|
|
208
|
+
carry … settings.local.json へ移す守り(deny / allowedDomains / allowWrite / unsandboxed / bypass)
|
|
209
|
+
"""
|
|
210
|
+
why, blockers = [], []
|
|
211
|
+
carry = {"deny": [], "domains": [], "write": [], "unsandboxed": False, "bypass": False}
|
|
212
|
+
if not isinstance(head, dict) or not isinstance(work, dict):
|
|
213
|
+
return {"ok": False, "why": ["JSON の形が読めない"], "blockers": [], "carry": carry}
|
|
214
|
+
w, h = copy.deepcopy(work), copy.deepcopy(head)
|
|
215
|
+
|
|
216
|
+
# --- permissions ---
|
|
217
|
+
wp, hp = w.pop("permissions", {}), h.pop("permissions", {})
|
|
218
|
+
if not isinstance(wp, dict) or not isinstance(hp, dict):
|
|
219
|
+
why.append("permissions の形が読めない")
|
|
220
|
+
wp, hp = {}, {}
|
|
221
|
+
# deny:足された行は「正本・退役の一覧・.npmrc の狙い撃ち」だけ/消えた行は「退役・何も止めていない形」だけ。
|
|
222
|
+
wd, hd = wp.pop("deny", []), hp.pop("deny", [])
|
|
223
|
+
if not isinstance(wd, list) or not isinstance(hd, list):
|
|
224
|
+
why.append("permissions.deny が一覧ではない")
|
|
225
|
+
else:
|
|
226
|
+
allowed = set(ctx["canonical_deny"]) | set(ctx["retired"]) | {"Read(/.npmrc)"}
|
|
227
|
+
added = [x for x in wd if x not in hd]
|
|
228
|
+
odd = [x for x in added if x not in allowed]
|
|
229
|
+
if odd:
|
|
230
|
+
why.append(f"禁止の一覧に采配くんが配らない行がある: {', '.join(map(str, odd))}")
|
|
231
|
+
removed = [x for x in hd if x not in wd]
|
|
232
|
+
bad_rm = [x for x in removed if x not in ctx["retired"] and not ctx["is_broken"](x)]
|
|
233
|
+
if bad_rm:
|
|
234
|
+
why.append(f"禁止の一覧から采配くんが外さない行が消えている: {', '.join(map(str, bad_rm))}")
|
|
235
|
+
# ★退役の行は移さない(意図して廃止した行)。それ以外の足された行は全部移す。
|
|
236
|
+
carry["deny"] = [x for x in added if x in allowed and x not in ctx["retired"]]
|
|
237
|
+
# allow:④ は全削除するだけ。作業場所の側に allow が在るのに本流と違う=人が足した。
|
|
238
|
+
wa, ha = wp.pop("allow", None), hp.pop("allow", None)
|
|
239
|
+
if wa is not None and wa != ha:
|
|
240
|
+
why.append("permissions.allow が本流と違う(采配くんは allow を足さない)")
|
|
241
|
+
if isinstance(ha, list) and ha:
|
|
242
|
+
blockers.append(f"本流の版に permissions.allow が {len(ha)} 件ある(戻すと関門の素通りが戻る)")
|
|
243
|
+
# 自動許可封じ:④ が正しいキーと値へ直す。
|
|
244
|
+
wb = (wp.pop("disableBypassPermissions", None), wp.pop("disableBypassPermissionsMode", None))
|
|
245
|
+
hb = (hp.pop("disableBypassPermissions", None), hp.pop("disableBypassPermissionsMode", None))
|
|
246
|
+
if wb != hb:
|
|
247
|
+
if wb == (None, "disable"):
|
|
248
|
+
carry["bypass"] = True
|
|
249
|
+
else:
|
|
250
|
+
why.append("自動許可封じのキーが本流と違う(采配くんの直し方ではない)")
|
|
251
|
+
if wp != hp:
|
|
252
|
+
why.append("permissions のほかのキーが本流と違う")
|
|
253
|
+
|
|
254
|
+
# --- hooks(③ が番人の登録を外すだけ) ---
|
|
255
|
+
wh, hh = w.pop("hooks", None), h.pop("hooks", None)
|
|
256
|
+
if wh != hh:
|
|
257
|
+
if strip_our_hooks(hh, ctx["entrypoints"]) == (wh or None):
|
|
258
|
+
blockers.append("本流の版に番人の登録がある(戻すとホームと二重に走る)")
|
|
259
|
+
else:
|
|
260
|
+
why.append("hooks が本流と違う(采配くんの外し方ではない)")
|
|
261
|
+
|
|
262
|
+
# --- sandbox(④ の (3c)・(3)・(3b) が足す・直すだけ。無い節は作らない) ---
|
|
263
|
+
ws, hs = w.pop("sandbox", None), h.pop("sandbox", None)
|
|
264
|
+
if ws != hs:
|
|
265
|
+
if not isinstance(ws, dict) or not isinstance(hs, dict):
|
|
266
|
+
why.append("sandbox の節が本流と違う(采配くんは節を作らない・消さない)")
|
|
267
|
+
else:
|
|
268
|
+
wn, hn = ws.pop("network", {}) or {}, hs.pop("network", {}) or {}
|
|
269
|
+
if isinstance(wn, dict) and isinstance(hn, dict):
|
|
270
|
+
_list_diff(wn.pop("allowedDomains", None), hn.pop("allowedDomains", None),
|
|
271
|
+
set(ctx["domains"]), "sandbox.network.allowedDomains", why, "domains", carry)
|
|
272
|
+
if wn != hn:
|
|
273
|
+
why.append("sandbox.network のほかのキーが本流と違う")
|
|
274
|
+
else:
|
|
275
|
+
why.append("sandbox.network の形が読めない")
|
|
276
|
+
wf, hf = ws.pop("filesystem", {}) or {}, hs.pop("filesystem", {}) or {}
|
|
277
|
+
if isinstance(wf, dict) and isinstance(hf, dict):
|
|
278
|
+
_list_diff(wf.pop("allowWrite", None), hf.pop("allowWrite", None),
|
|
279
|
+
set(ctx["report_store"]), "sandbox.filesystem.allowWrite", why, "write", carry)
|
|
280
|
+
if wf != hf:
|
|
281
|
+
why.append("sandbox.filesystem のほかのキーが本流と違う")
|
|
282
|
+
else:
|
|
283
|
+
why.append("sandbox.filesystem の形が読めない")
|
|
284
|
+
wu, hu = ws.pop("allowUnsandboxedCommands", None), hs.pop("allowUnsandboxedCommands", None)
|
|
285
|
+
if wu != hu:
|
|
286
|
+
if wu is False:
|
|
287
|
+
carry["unsandboxed"] = True
|
|
288
|
+
else:
|
|
289
|
+
why.append("sandbox.allowUnsandboxedCommands が本流と違う(采配くんは false にしかしない)")
|
|
290
|
+
if ws != hs:
|
|
291
|
+
why.append("sandbox のほかのキーが本流と違う")
|
|
292
|
+
|
|
293
|
+
if w != h:
|
|
294
|
+
keys = sorted(set(w) ^ set(h) | {k for k in set(w) & set(h) if w[k] != h[k]})
|
|
295
|
+
why.append(f"ほかのキーが本流と違う: {', '.join(keys)}")
|
|
296
|
+
return {"ok": not why, "why": why, "blockers": blockers, "carry": carry}
|
|
297
|
+
|
|
298
|
+
|
|
299
|
+
def _append(lst, items):
|
|
300
|
+
added = [x for x in items if x not in lst]
|
|
301
|
+
lst.extend(added)
|
|
302
|
+
return added
|
|
303
|
+
|
|
304
|
+
|
|
305
|
+
def merge_carry(local, carry):
|
|
306
|
+
"""移す守りを settings.local.json の中身(dict)へ足す(★足すだけ・消さない)。変更の説明を返す。"""
|
|
307
|
+
out = []
|
|
308
|
+
if carry["deny"]:
|
|
309
|
+
perms = local.setdefault("permissions", {})
|
|
310
|
+
deny = perms.setdefault("deny", [])
|
|
311
|
+
n = _append(deny, carry["deny"])
|
|
312
|
+
if n:
|
|
313
|
+
out.append(f"禁止ルール {len(n)} 件")
|
|
314
|
+
if carry["bypass"]:
|
|
315
|
+
perms = local.setdefault("permissions", {})
|
|
316
|
+
if perms.get("disableBypassPermissionsMode") != "disable":
|
|
317
|
+
perms["disableBypassPermissionsMode"] = "disable"
|
|
318
|
+
out.append('disableBypassPermissionsMode="disable"')
|
|
319
|
+
if carry["domains"] or carry["write"] or carry["unsandboxed"]:
|
|
320
|
+
sb = local.setdefault("sandbox", {})
|
|
321
|
+
if carry["domains"]:
|
|
322
|
+
n = _append(sb.setdefault("network", {}).setdefault("allowedDomains", []), carry["domains"])
|
|
323
|
+
if n:
|
|
324
|
+
out.append(f"接続許可 {len(n)} 件")
|
|
325
|
+
if carry["write"]:
|
|
326
|
+
n = _append(sb.setdefault("filesystem", {}).setdefault("allowWrite", []), carry["write"])
|
|
327
|
+
if n:
|
|
328
|
+
out.append(f"書いてよい場所 {len(n)} 件")
|
|
329
|
+
if carry["unsandboxed"] and sb.get("allowUnsandboxedCommands") is not False:
|
|
330
|
+
sb["allowUnsandboxedCommands"] = False
|
|
331
|
+
out.append("allowUnsandboxedCommands=false")
|
|
332
|
+
return out
|
|
333
|
+
|
|
334
|
+
|
|
335
|
+
def restore(proj, shared_path):
|
|
336
|
+
"""控えを残してから、settings.json を本流の版へ戻す(git checkout -- .claude/settings.json)。
|
|
337
|
+
|
|
338
|
+
返す物: (戻せたか, 控えの道筋, 説明)。★控えが作れなければ戻さない。
|
|
339
|
+
★控えは settings.local.json* の名前で隣に置く(除外の1行に入る=git status に出さない)。
|
|
340
|
+
"""
|
|
341
|
+
backup = os.path.join(os.path.dirname(shared_path),
|
|
342
|
+
f"settings.local.json.bak-settings.json.{time.strftime('%Y%m%d-%H%M%S')}")
|
|
343
|
+
try:
|
|
344
|
+
shutil.copy2(shared_path, backup)
|
|
345
|
+
except OSError as e:
|
|
346
|
+
return False, None, f"控えを作れないので戻しません({e})"
|
|
347
|
+
r = _git(proj, "checkout", "--", SHARED)
|
|
348
|
+
if not _ok(r):
|
|
349
|
+
return False, backup, f"戻せませんでした({(r.stderr if r else '').strip() or 'git が使えない'})"
|
|
350
|
+
return True, backup, "本流の版へ戻しました"
|