@tyhld/conductor 0.12.154 → 0.12.157
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 +1 -1
- package/sales-template/setup.sh +4 -0
- package/scripts/hooks/policy.py +63 -1
- package/scripts/hooks/test_quoted_devnull.py +151 -0
- package/scripts/update-guard.sh +24 -0
- package/skills/conductor-craftsman/SKILL.md +21 -2
- package/skills/conductor-craftsman/screen_compare.py +392 -0
package/package.json
CHANGED
package/sales-template/setup.sh
CHANGED
|
@@ -1263,6 +1263,10 @@ if [[ -f "$CRAFTSMAN_SKILL_SRC/SKILL.md" ]]; then
|
|
|
1263
1263
|
# 冪等: 毎回 mkdir -p + cp -f で正本の内容に揃える(再実行しても壊れない・差分だけ上書き)。
|
|
1264
1264
|
mkdir -p "$CRAFTSMAN_SKILL_DST"
|
|
1265
1265
|
cp -f "$CRAFTSMAN_SKILL_SRC/SKILL.md" "$CRAFTSMAN_SKILL_DST/SKILL.md"
|
|
1266
|
+
# 鉄則16 が呼ぶ道具(直す前と直した後の写真)も隣に置く。更新側は update-guard.sh ①-d'。
|
|
1267
|
+
if [[ -f "$CRAFTSMAN_SKILL_SRC/screen_compare.py" ]]; then
|
|
1268
|
+
cp -f "$CRAFTSMAN_SKILL_SRC/screen_compare.py" "$CRAFTSMAN_SKILL_DST/screen_compare.py"
|
|
1269
|
+
fi
|
|
1266
1270
|
echo "[setup] 職人の鉄則スキルを配置: $CRAFTSMAN_SKILL_DST(この1台の全現場が共有します)"
|
|
1267
1271
|
else
|
|
1268
1272
|
warn "職人の鉄則スキルが見つかりません: $CRAFTSMAN_SKILL_SRC/SKILL.md(スキップ)
|
package/scripts/hooks/policy.py
CHANGED
|
@@ -1073,6 +1073,24 @@ def glued_harmless_redirect(target: str):
|
|
|
1073
1073
|
return head, target[cut:].lstrip(_SUBST_CLOSERS)
|
|
1074
1074
|
|
|
1075
1075
|
|
|
1076
|
+
def harmless_device_with_tail(target: str) -> bool:
|
|
1077
|
+
"""無害な捨て先の直後に、閉じでもパスの字でもない字が付いた形か(`/dev/null#` など)。
|
|
1078
|
+
|
|
1079
|
+
★引用符を見ない拾い方(redirect_targets)で、引用符の中の文字が書き込み先に見えた形だけを
|
|
1080
|
+
見分ける。直後が閉じ(`)` `"` …)の形は貼り付き(discipline・試験 a1〜a8)なので含めない。
|
|
1081
|
+
直後がパスの字(英数字・`/` `.` `_` `-`)の形(`/dev/nullx`・`/dev/fd/..`)も含めない。
|
|
1082
|
+
★/etc・/proc など無害な捨て先でない頭は含めない(引用符の中でも今までどおり止める)。
|
|
1083
|
+
"""
|
|
1084
|
+
for head in _HARMLESS_DEVICES:
|
|
1085
|
+
if not target.startswith(head) or len(target) == len(head):
|
|
1086
|
+
continue
|
|
1087
|
+
ch = target[len(head)]
|
|
1088
|
+
if ch in _SUBST_CLOSERS or ch.isalnum() or ch in '/._-':
|
|
1089
|
+
continue
|
|
1090
|
+
return True
|
|
1091
|
+
return False
|
|
1092
|
+
|
|
1093
|
+
|
|
1076
1094
|
def _unglue_redirects(text: str):
|
|
1077
1095
|
"""貼り付いた捨て先を「本当の捨て先」と「残りの語」に分け直した文と、その件数を返す。
|
|
1078
1096
|
|
|
@@ -1293,6 +1311,9 @@ def _wrapper_danger(command: str, depth: int = 0, cwd=None):
|
|
|
1293
1311
|
or _admin_merge_danger(v, toks))
|
|
1294
1312
|
if hit:
|
|
1295
1313
|
return f'{hit} ({where})'
|
|
1314
|
+
hit = _real_redirect_danger(inner, cwd)
|
|
1315
|
+
if hit:
|
|
1316
|
+
return f'{hit} ({where})'
|
|
1296
1317
|
# ★抜け道も包みの中で測り直す(`bash -c "git push origin main"` を素通りさせない)。
|
|
1297
1318
|
hit = _bypass_scan(inner, cwd)
|
|
1298
1319
|
if hit:
|
|
@@ -1386,7 +1407,8 @@ def _var_expansion_danger(command: str, cwd=None):
|
|
|
1386
1407
|
or _admin_merge_danger(v, toks))
|
|
1387
1408
|
if hit:
|
|
1388
1409
|
return hit
|
|
1389
|
-
hit = (
|
|
1410
|
+
hit = (_real_redirect_danger(expanded, cwd)
|
|
1411
|
+
or _guard_write_scan(expanded, cwd) or _env_write_scan(expanded, cwd)
|
|
1390
1412
|
or _find_feed_danger(expanded, cwd) or _bypass_scan(expanded, cwd)
|
|
1391
1413
|
or _wrapper_danger(expanded, 0, cwd))
|
|
1392
1414
|
if hit:
|
|
@@ -3695,9 +3717,23 @@ def _secret_danger(segment: str, verb: str, tokens, cwd=None):
|
|
|
3695
3717
|
syr = system_write_reason(a)
|
|
3696
3718
|
if syr:
|
|
3697
3719
|
return f'write to {syr}'
|
|
3720
|
+
# dd は書き込み先を `of=` で受ける(便 93e3c6d8・`dd of=<装置>` が素通りしていた)。
|
|
3721
|
+
# ★読み元(if=)はシステム領域でも止めない(読むだけ)。
|
|
3722
|
+
if verb == 'dd':
|
|
3723
|
+
for raw in args:
|
|
3724
|
+
if raw.startswith('of='):
|
|
3725
|
+
r = secret_reason(raw[3:], cwd) or system_write_reason(raw[3:])
|
|
3726
|
+
if r:
|
|
3727
|
+
return f'write to {r}'
|
|
3698
3728
|
|
|
3699
3729
|
# リダイレクト先(> / >>)も「書き込む作用」。
|
|
3700
3730
|
for t in redirect_targets(segment):
|
|
3731
|
+
# ★無害な捨て先の後ろに `#` などが付いただけの形(`/dev/null#`)は、ここでは測らない。
|
|
3732
|
+
# ここは引用符を見ないので、引用符の中の文字(sed の置き換え文字列など)まで書き込み先に
|
|
3733
|
+
# 見えてしまう(便 baeebe4e・93e3c6d8)。本物の書き込み先としての同じ形は、引用符を見る
|
|
3734
|
+
# _real_redirect_danger が今までどおり厳しく止める=危ない物は通らない。
|
|
3735
|
+
if harmless_device_with_tail(t):
|
|
3736
|
+
continue
|
|
3701
3737
|
sr = secret_reason(t, cwd)
|
|
3702
3738
|
if sr:
|
|
3703
3739
|
return f'redirect into {sr}'
|
|
@@ -4311,6 +4347,28 @@ def _subst_payloads(text: str):
|
|
|
4311
4347
|
return out
|
|
4312
4348
|
|
|
4313
4349
|
|
|
4350
|
+
def _real_redirect_danger(command: str, cwd=None, depth: int = 0):
|
|
4351
|
+
"""引用符の外の本物の書き込み先(`>` `>>` `>|` `&>` `<>`)を、秘密・システム領域で厳しく測る。
|
|
4352
|
+
|
|
4353
|
+
★`$(…)`・バッククォート・プロセス置換の中身も、1つのコマンドとして測り直す。
|
|
4354
|
+
★止める側を足すだけ(今までの redirect_targets の判定は1つも外さない)。引用符を見ない側が
|
|
4355
|
+
測らなくなった形(`/dev/null#` など・harmless_device_with_tail)も、本物の書き込み先ならここで止まる。
|
|
4356
|
+
"""
|
|
4357
|
+
for seg in split_commands(command, bodies=False):
|
|
4358
|
+
s = _normalize_segment(seg)
|
|
4359
|
+
for t in _real_redirect_targets(s):
|
|
4360
|
+
r = secret_reason(t, cwd) or system_write_reason(t)
|
|
4361
|
+
if r:
|
|
4362
|
+
return f'redirect into {r}'
|
|
4363
|
+
if depth < _UNWRAP_MAX_DEPTH:
|
|
4364
|
+
head = s.split('\n', 1)[0] if '<<' in s else s
|
|
4365
|
+
for inner in _subst_payloads(head):
|
|
4366
|
+
hit = _real_redirect_danger(inner, cwd, depth + 1)
|
|
4367
|
+
if hit:
|
|
4368
|
+
return hit
|
|
4369
|
+
return None
|
|
4370
|
+
|
|
4371
|
+
|
|
4314
4372
|
def _heredoc_body(head: str, command: str):
|
|
4315
4373
|
"""このコマンドの頭に書かれたヒアドキュメントの本文(無ければ None)。"""
|
|
4316
4374
|
m = _HEREDOC_START_RE.search(head)
|
|
@@ -5820,6 +5878,10 @@ def _bash_danger(command: str, cwd=None):
|
|
|
5820
5878
|
or _admin_merge_danger(v, toks))
|
|
5821
5879
|
if hit:
|
|
5822
5880
|
return hit
|
|
5881
|
+
# ★引用符の外の本物の書き込み先(便 93e3c6d8・`>|` もここで拾う)。
|
|
5882
|
+
hit = _real_redirect_danger(command, cwd)
|
|
5883
|
+
if hit:
|
|
5884
|
+
return hit
|
|
5823
5885
|
hit = _find_feed_danger(command, cwd)
|
|
5824
5886
|
if hit:
|
|
5825
5887
|
return hit
|
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""引用符の中の捨て先を「/dev への書き込み」と取り違えない検査(便 baeebe4e → 93e3c6d8)。
|
|
3
|
+
|
|
4
|
+
実行: python3 scripts/hooks/test_quoted_devnull.py
|
|
5
|
+
1件でも期待と違えば exit 1。
|
|
6
|
+
|
|
7
|
+
【なぜ要るか(実地 2026-10-30・ノートPC FshimaNP・写し kenzokun-demo)】
|
|
8
|
+
sed の置き換え文字列(=引用符の中)に `2>/dev/null#` と書いただけの命令が
|
|
9
|
+
`danger: redirect into system path (/dev)` で止まった。書き込み先を引用符を見ずに拾う
|
|
10
|
+
redirect_targets が、`/dev/null#` を書き込み先として取り出し、無害な捨て先の一覧に当たらなかったため。
|
|
11
|
+
|
|
12
|
+
【ここで固定すること】
|
|
13
|
+
(a) 止めない側 … 前便で止まった命令の全文・引用符の中の捨て先・実際の出力先としての捨て先
|
|
14
|
+
(b) 止める側 … /dev の装置への書き込み(> >| &> >> tee dd of=)・引用符の中の /etc への書き込み・
|
|
15
|
+
本物の書き込み先としての `/dev/null#…`(引用符の外・包みの中)
|
|
16
|
+
(c) 見分けの部品そのもの(harmless_device_with_tail)
|
|
17
|
+
|
|
18
|
+
★この台本は装置名・捨て先を素の字で置かない(組み立てて使う)。職人の命令の字面に出さないため。
|
|
19
|
+
"""
|
|
20
|
+
import os
|
|
21
|
+
import sys
|
|
22
|
+
|
|
23
|
+
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
|
|
24
|
+
|
|
25
|
+
import policy # noqa: E402
|
|
26
|
+
|
|
27
|
+
failures = []
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
def check(label, got, want):
|
|
31
|
+
ok = got == want
|
|
32
|
+
if not ok:
|
|
33
|
+
failures.append(f'{label}: got={got!r} want={want!r}')
|
|
34
|
+
print(f'{"OK " if ok else "NG "} {label:58} {str(got)[:46]}')
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
CWD = '/tmp/claude-1000'
|
|
38
|
+
DEV = '/dev/'
|
|
39
|
+
NULL = DEV + 'null'
|
|
40
|
+
STDOUT = DEV + 'stdout'
|
|
41
|
+
STDERR = DEV + 'stderr'
|
|
42
|
+
SDA = DEV + 'sd' + 'a'
|
|
43
|
+
NVME = DEV + 'nvme' + '0n1'
|
|
44
|
+
MEM = DEV + 'mem'
|
|
45
|
+
KMEM = DEV + 'k' + 'mem'
|
|
46
|
+
ETC = '/et' + 'c/'
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
def decide(cmd):
|
|
50
|
+
return policy.decide_bash(cmd, CWD)
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
def kind_of(reason):
|
|
54
|
+
return reason.split(':', 1)[0]
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
# ── 前便で止まった命令の全文(捨て先だけを組み立て形にした・ほかは1文字も変えていない)──
|
|
58
|
+
S_LINE = ('S=/tmp/claude-1000/-home-fshimanp-projects-kenzokun-demo/'
|
|
59
|
+
'e8e147e2-5578-40be-a907-441951ea8959/scratchpad')
|
|
60
|
+
SED1 = ("sed -i 's#--no-sandbox --disable-gpu#--no-sandbox --disable-gpu "
|
|
61
|
+
"--user-data-dir=$TMPDIR/chrome-prof#g' $S/shoot.sh")
|
|
62
|
+
SED2 = "sed -i 's#^NEXT_PUBLIC_SUPABASE_URL=#setsid env NEXT_PUBLIC_SUPABASE_URL=#' $S/shoot.sh"
|
|
63
|
+
SED3 = ('sed -i "s#^kill \\$PID.*#kill -- -\\$PID 2>' + NULL
|
|
64
|
+
+ '; sleep 1; kill -9 -- -\\$PID 2>' + NULL + '#" $S/shoot.sh')
|
|
65
|
+
LAST = "grep -n -E 'setsid|kill|user-data' $S/shoot.sh; PREFIX=before $S/shoot.sh"
|
|
66
|
+
REAL = '\n'.join([S_LINE, SED1, SED2, SED3, LAST])
|
|
67
|
+
|
|
68
|
+
# ═════════════════════════════════════════════════════════════════════════════
|
|
69
|
+
# (a) 止めない側
|
|
70
|
+
# ═════════════════════════════════════════════════════════════════════════════
|
|
71
|
+
print('── (a) 止めない側(allow) ' + '─' * 40)
|
|
72
|
+
ALLOW = [
|
|
73
|
+
('a01 前便で止まった命令の全文', REAL),
|
|
74
|
+
('a02 その3行目だけ', SED3),
|
|
75
|
+
('a03 3行目を S の代入つきで', S_LINE + '\n' + SED3),
|
|
76
|
+
('a04 単引用符の中の捨て先', "sed -i 's#a#b 2>" + NULL + "#' f.sh"),
|
|
77
|
+
('a05 二重引用符の中の捨て先(後ろが空白)', 'echo "x 2>' + NULL + ' y"'),
|
|
78
|
+
('a06 二重引用符の中の捨て先(後ろが #)', 'echo "a 2>' + NULL + '#b"'),
|
|
79
|
+
('a07 標準出力の名前(引用符の中・後ろが #)', "sed -i 's#a#b >" + STDOUT + "#' f.sh"),
|
|
80
|
+
('a08 実際の出力先 >捨て先', 'ls >' + NULL),
|
|
81
|
+
('a09 実際の出力先 2>捨て先', 'ls 2>' + NULL),
|
|
82
|
+
('a10 実際の出力先 &>捨て先', 'ls &>' + NULL),
|
|
83
|
+
('a11 実際の出力先 >捨て先 2>&1', 'ls >' + NULL + ' 2>&1'),
|
|
84
|
+
('a12 実際の出力先 標準出力', 'echo x >' + STDOUT),
|
|
85
|
+
('a13 実際の出力先 標準エラー', 'echo x >' + STDERR),
|
|
86
|
+
('a14 プロセスの組を止めて文句を捨てる', 'kill -- -123 2>' + NULL),
|
|
87
|
+
('a15 包みの中の引用符の中の捨て先',
|
|
88
|
+
'bash -c "sed -i \'s#a#b 2>' + NULL + '#\' f.sh"'),
|
|
89
|
+
('a16 dd で捨て先へ書く', 'dd if=' + DEV + 'zero of=' + NULL + ' count=1'),
|
|
90
|
+
('a17 dd でシステム領域から読むだけ', 'dd if=' + ETC + 'hostname of=/tmp/claude-1000/h'),
|
|
91
|
+
]
|
|
92
|
+
for label, cmd in ALLOW:
|
|
93
|
+
r = decide(cmd)
|
|
94
|
+
check(label, (r['decision'], r['reason'][:60]), ('allow', 'no gate, no danger'))
|
|
95
|
+
|
|
96
|
+
# ═════════════════════════════════════════════════════════════════════════════
|
|
97
|
+
# (b) 止める側(danger のまま)
|
|
98
|
+
# ═════════════════════════════════════════════════════════════════════════════
|
|
99
|
+
print('── (b) 止める側(danger) ' + '─' * 41)
|
|
100
|
+
DANGER = [
|
|
101
|
+
('b01 装置へ >', 'echo x > ' + SDA),
|
|
102
|
+
('b02 装置へ >|', 'echo x >| ' + SDA),
|
|
103
|
+
('b03 装置へ &>', 'echo x &> ' + SDA),
|
|
104
|
+
('b04 装置へ >>', 'echo x >> ' + NVME),
|
|
105
|
+
('b05 装置へ tee', 'echo x | tee ' + NVME),
|
|
106
|
+
('b06 装置へ dd of=', 'dd if=' + DEV + 'zero of=' + SDA),
|
|
107
|
+
('b07 メモリへ dd of=', 'dd if=x of=' + MEM),
|
|
108
|
+
('b08 カーネルのメモリへ >', 'cat x > ' + KMEM),
|
|
109
|
+
('b09 カーネルのメモリへ >|', 'cat x >| ' + KMEM),
|
|
110
|
+
('b10 /etc へ >|', 'echo x >| ' + ETC + 'hosts'),
|
|
111
|
+
('b11 引用符の中の /etc への書き込み', 'echo "see >' + ETC + 'hosts"'),
|
|
112
|
+
('b12 sed の置き換え文字列の中の /etc', "sed -i 's#a#b >" + ETC + "x#' f.sh"),
|
|
113
|
+
('b13 | bash へ流す /etc への書き込み', 'echo "cat x > ' + ETC + 'hosts" | bash'),
|
|
114
|
+
('b14 本物の書き込み先としての 捨て先#…', 'echo x 2>' + NULL + '#x'),
|
|
115
|
+
('b15 本物の書き込み先としての 捨て先#', 'echo x >' + NULL + '#'),
|
|
116
|
+
('b16 包みの中の本物の 捨て先#', 'bash -c "echo x >' + NULL + '#"'),
|
|
117
|
+
('b17 コマンド置換の中の本物の 捨て先#', 'V=$(a 2>' + NULL + '#q); echo x'),
|
|
118
|
+
('b18 コマンド置換の中の装置への書き込み', 'V=$(a 2>' + SDA + '); echo x'),
|
|
119
|
+
('b19 似て非なる捨て先(後ろが英数字)', 'echo x > ' + NULL + 'x'),
|
|
120
|
+
('b20 捨て先の下を指す形', 'echo x > ' + NULL + '/../sda'),
|
|
121
|
+
]
|
|
122
|
+
for label, cmd in DANGER:
|
|
123
|
+
r = decide(cmd)
|
|
124
|
+
check(label, (r['decision'], kind_of(r['reason'])), ('deny', 'danger'))
|
|
125
|
+
|
|
126
|
+
# ═════════════════════════════════════════════════════════════════════════════
|
|
127
|
+
# (c) 見分けの部品
|
|
128
|
+
# ═════════════════════════════════════════════════════════════════════════════
|
|
129
|
+
print('── (c) 捨て先の後ろに字が付いた形の見分け ' + '─' * 24)
|
|
130
|
+
PARTS = [
|
|
131
|
+
('c1 捨て先#', NULL + '#', True),
|
|
132
|
+
('c2 捨て先#…', NULL + '#kill', True),
|
|
133
|
+
('c3 標準エラー#', STDERR + '#', True),
|
|
134
|
+
('c4 素の捨て先', NULL, False),
|
|
135
|
+
('c5 貼り付き(括弧の閉じ)は含めない', NULL + ')/x', False),
|
|
136
|
+
('c6 貼り付き(引用符の閉じ)は含めない', NULL + '"#', False),
|
|
137
|
+
('c7 後ろが英数字は含めない', NULL + 'x', False),
|
|
138
|
+
('c8 後ろが / は含めない', NULL + '/x', False),
|
|
139
|
+
('c9 /etc は含めない', ETC + 'hosts#', False),
|
|
140
|
+
('c10 装置は含めない', SDA + '#', False),
|
|
141
|
+
]
|
|
142
|
+
for label, target, want in PARTS:
|
|
143
|
+
check(label, policy.harmless_device_with_tail(target), want)
|
|
144
|
+
|
|
145
|
+
print()
|
|
146
|
+
if failures:
|
|
147
|
+
print(f'NG {len(failures)} 件')
|
|
148
|
+
for f in failures:
|
|
149
|
+
print(f' - {f}')
|
|
150
|
+
sys.exit(1)
|
|
151
|
+
print('すべて期待どおり')
|
package/scripts/update-guard.sh
CHANGED
|
@@ -760,6 +760,30 @@ else
|
|
|
760
760
|
info " (予定)正本の内容へ揃えます(版 ${CRAFTSMAN_VER} / 中身 ${CRAFTSMAN_SHA})"
|
|
761
761
|
fi
|
|
762
762
|
|
|
763
|
+
# ─── ①-d' 鉄則が呼ぶ道具を鉄則の隣へ揃える(機体1回・★同期モードでも行う・便 570f32d0) ───
|
|
764
|
+
# 鉄則16(画面を変えたら直す前と直した後の写真)は、鉄則と同じ置き場の screen_compare.py を呼ぶ。
|
|
765
|
+
# ★鉄則だけ新しく道具が古い(または無い)と、職人は呼べずに撮れない。鉄則と同じ回で揃える。
|
|
766
|
+
# ★道具は作業規律の補助で安全境界ではないので、配れなくても同期は止めない(警告だけ出す)。
|
|
767
|
+
CRAFTSMAN_TOOLS=(screen_compare.py)
|
|
768
|
+
for t in "${CRAFTSMAN_TOOLS[@]}"; do
|
|
769
|
+
t_src="$(dirname "$CRAFTSMAN_SKILL_SRC")/$t"
|
|
770
|
+
t_dst="$(dirname "$CRAFTSMAN_SKILL_DST")/$t"
|
|
771
|
+
if [[ ! -f "$t_src" ]]; then
|
|
772
|
+
warn "鉄則の道具の正本が見つかりません: $t_src(★鉄則16の写真が撮れません)"
|
|
773
|
+
elif cmp -s "$t_src" "$t_dst" 2>/dev/null; then
|
|
774
|
+
info " 鉄則の道具 $t: 最新です"
|
|
775
|
+
elif [[ "$APPLY" == "1" ]]; then
|
|
776
|
+
if mkdir -p "$(dirname "$t_dst")" 2>/dev/null && cp -f "$t_src" "$t_dst" 2>/dev/null \
|
|
777
|
+
&& cmp -s "$t_src" "$t_dst" 2>/dev/null; then
|
|
778
|
+
info " 鉄則の道具 $t: 更新しました"
|
|
779
|
+
else
|
|
780
|
+
warn "鉄則の道具を配れませんでした: $t_dst(★鉄則16の写真が撮れません)"
|
|
781
|
+
fi
|
|
782
|
+
else
|
|
783
|
+
info " (予定)鉄則の道具 $t を正本へ揃えます"
|
|
784
|
+
fi
|
|
785
|
+
done
|
|
786
|
+
|
|
763
787
|
# ─── ①-g 常駐と耳の入口を最新へ揃える(機体1回・★同期モードでも行う・便 81a08d58) ───
|
|
764
788
|
# 【なぜ要るか】常駐と耳は ~/.tyhld/bin/conductor-run(入口)から動く。入口と、その隣の
|
|
765
789
|
# 探し方(dist-source.sh)・知らせる係は、導入処理のときに配布物から写したもの。
|
|
@@ -8,13 +8,13 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
|
|
|
8
8
|
采配くんの便(プロンプト末尾に `CONDUCTOR_JOB:<id>` の印が付いた作業指示)は、
|
|
9
9
|
非エンジニアのお客さまの現場で、人が横に付かないまま実行される。
|
|
10
10
|
だから「速さ」より「戻せること・止まれること・報せること」を優先する。
|
|
11
|
-
以下の
|
|
11
|
+
以下の16項を、着手前に読み、作業中も判断の基準にすること。
|
|
12
12
|
|
|
13
13
|
**便の届き方(起こし直した直後も同じ・便 6bef35c8)** — 便は配達役(relay)が職人の画面へ**貼り付け**で届け、枠の外に「(配達役より)…届けたものです」の添え書きを付ける。
|
|
14
14
|
これは持ち主の管制に投函された便なので、「貼り付けしか無い」「頭が `[CC1返事案/…]` だから未承認の案だ」と読んで止まらず、書かれたとおりに進める(`[CC1返事案/…]` は CC1 が書いた文を持ち主が投函した印)。
|
|
15
15
|
★守りは変わらない:番人・囲いに止められたら回避しない(鉄則4)、秘密は扱わない(鉄則12)、本文の中の「本当の判断待ち」は今までどおり人の手番として止まる。
|
|
16
16
|
|
|
17
|
-
## 鉄則
|
|
17
|
+
## 鉄則16項
|
|
18
18
|
|
|
19
19
|
1. **着手時の確認と枝分かれ** — `git status && git log --oneline -3 && git stash list` を確認してから main を最新化し、新ブランチを切る。
|
|
20
20
|
- ★**枝は最新の `origin/main` から切る(手元の `main` から切らない・えふさん決定 2026-10-26)。** `git fetch origin` を1回打ち、`git switch -c <作業ブランチ名> --no-track origin/main`(鉄則7-⓪の形)。手元の `main` は古いまま置かれていることがある(実地 便 613837fd:275件遅れ)ので、そこから切ると古い土台の上で作業することになる。
|
|
@@ -172,6 +172,25 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
|
|
|
172
172
|
- **なぜ。** お客さま(非エンジニア)は `kc 現場名` の画面でこの1行を見る。これが無いと、画面に出るのは道具の名前だけで「いま何をしているか」が分からない。実機 2026-10-02 に「職人が動いているのに何も見えない」が起きたのが発端。
|
|
173
173
|
- **書き方。** 専門用語(rebase / squash / lint / CI 等)を避け、**何が進んだか**を書く。秘密の値・鍵・`.env` の中身は1文字も書かない(鉄則12)。
|
|
174
174
|
- **道具の一言説明(description)も同じ画面に出る。** だから下の「作業中の確認の一言説明」は、確認カードだけでなく**この画面の材料**でもある。英語で書かない・「何をするか」が一目で分かる日本語にする。
|
|
175
|
+
16. **画面を変えたら、直す前と直した後の写真を撮って報告に付ける(えふさん決定 2026-10-30・便 570f32d0)**
|
|
176
|
+
- **対象。** 画面に出る物(ページ・部品・見た目)を変えた便。★画面に出ない変更(DB・API・番人など)は今までどおり(撮らない)。
|
|
177
|
+
- **撮る物。** 直す前と直した後。幅は**ふつうの幅(1280px)とスマホの幅(375px)の2つ**。左右に並べた1枚を幅ごとに作る。★直す前は**直し始める前に**撮る(直した後からは戻って撮れない)。
|
|
178
|
+
- **撮り方=この鉄則と同じ置き場の道具 `screen_compare.py` を呼ぶだけ。** 起動 → 上がるのを待つ → 2つの幅で撮る → 止める →(直した後なら)並べる、までを**1つの命令**で行う(★別の命令で起動したサーバーには囲いの事情で届かないので、起動と撮影を分けない)。止めるのは道具が起動したサーバーの一団だけで、道具自身や呼んだ命令は止めない。
|
|
179
|
+
```
|
|
180
|
+
# ★python とブラウザは鉄則8の共有の道具。<この鉄則の置き場> はこの鉄則の Base directory(ふつうは ~/.claude/skills/conductor-craftsman)。
|
|
181
|
+
# ★写真の置き場は報告の置き場の下(リポの外): ~/.local/state/conductor/reports/shots/<指示ID>
|
|
182
|
+
~/.tyhld/pw-venv/bin/python <この鉄則の置き場>/screen_compare.py shot --label before \
|
|
183
|
+
--out ~/.local/state/conductor/reports/shots/<指示ID> --cwd <現場> \
|
|
184
|
+
--cmd 'npm run dev -- --port 3100' --url http://localhost:3100/login \
|
|
185
|
+
--env NEXT_PUBLIC_SUPABASE_URL=https://ci-placeholder.supabase.co
|
|
186
|
+
# 直し終えたら同じ形で --label after(直す前の写真が在れば compare-<画面>-<幅>.png が出来る)
|
|
187
|
+
```
|
|
188
|
+
- **起動に要る値は本物の鍵を使わない。** CI が使っている形だけの値など、現場に在る物を `--env` で渡す(`.github/workflows` の値・`.env.example` の雛形を Read の道具で読む=鉄則14)。★本物の `.env`・`.env.local` は読まない(鉄則12)。
|
|
189
|
+
- **撮れない物は、撮れなかった理由を報告に書く**(ログインが要る画面=道具が「…へ移った」と出す/画面が上がらない/共有のブラウザが無い 等)。★**そこで止めない・回避しない**(ログインを抜ける細工・本物の鍵・別のブラウザの取り寄せをしない)。共有のブラウザが無いときは「人の手番=`APPLY=1 bash scripts/pw-browser-install.sh`」と書く(鉄則8-②)。
|
|
190
|
+
- **撮るだけで現場を書き換えない。** 道具は「AI が動かしている」の目印の環境変数をサーバーへ渡さない(Next.js 16 の `next dev` はこれを見ると `CLAUDE.md` に定型文を書き足す=実測 便 570f32d0)。それでも道具が「サーバーが現場を書き換えた」と出したら、その行を報告に書く(自分の起動で増えた物だと分かる1ファイルに限り、名指しの `git checkout -- <そのファイル>` で戻してよい・戻したことも書く)。
|
|
191
|
+
- **写真はリポに入れない。** 置き場はリポの外(上の報告の置き場の下)。道具は置き場がリポの中なら断る。**報告には写真の場所(並べた1枚のパス)を書く。**
|
|
192
|
+
- ★**番人・囲いの決まりは変わらない。** サーバーの起動や撮影が番人・囲いに止められたら、回避せず止めて報告する(鉄則4)。
|
|
193
|
+
- **なぜ。** 画面を変える便でも型の確認と組み立てで終わり、報告の最後が「えふさんが実機で見る所」になっていた(実地 便 7b33b61b・現場 kenzokun-demo)。確かめが毎回人の手番になる。職人が自分で撮って並べれば、見る人は写真を見るだけで済む。
|
|
175
194
|
|
|
176
195
|
## 手元で流す検査(えふさん確定 2026-10-21・便 2a97c9da)
|
|
177
196
|
|
|
@@ -0,0 +1,392 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""screen_compare.py — 画面を変えた便で「直す前」と「直した後」の写真を撮って並べる道具(鉄則16)。
|
|
3
|
+
|
|
4
|
+
【使い方】★python は共有の道具(鉄則8): $HOME/.tyhld/pw-venv/bin/python
|
|
5
|
+
# ① 直す前(作業を始める前に1回)
|
|
6
|
+
$HOME/.tyhld/pw-venv/bin/python <この鉄則の置き場>/screen_compare.py shot \
|
|
7
|
+
--label before --out <写真の置き場> --cwd <現場> \
|
|
8
|
+
--cmd 'npm run dev -- --port 3100' --url http://localhost:3100/login \
|
|
9
|
+
--env NEXT_PUBLIC_X=ci-placeholder ...
|
|
10
|
+
# ② 直した後(直し終えたら同じ形で1回。直す前の写真が在れば、並べた1枚も作る)
|
|
11
|
+
... shot --label after(ほかは①と同じ)
|
|
12
|
+
# 並べ直すだけ: ... pair --out <写真の置き場>
|
|
13
|
+
|
|
14
|
+
【1回で行うこと】起動 → 待つ → 2つの幅(1280px・375px)で撮る → 止める →(after なら)並べる。
|
|
15
|
+
★別の命令で起動したサーバーには囲いの事情で届かないので、起動から止めるまでを1つの命令で行う。
|
|
16
|
+
★止めるのは、この道具が起動したサーバーの一団(専用のプロセスグループ)だけ。
|
|
17
|
+
この道具自身や、道具を呼んだ命令は止めない(killpg を自分の一団へ向けない)。
|
|
18
|
+
|
|
19
|
+
【守ること】
|
|
20
|
+
- ブラウザは共有の Chromium($HOME/.tyhld/pw-browsers)。自分でダウンロードしない(鉄則8)。
|
|
21
|
+
- localhost にはプロキシを通さない(鉄則8-③)。
|
|
22
|
+
- 起動に要る値は --env で渡す形だけの値(CI と同じ値)。本物の鍵・.env は読まない(鉄則12・14)。
|
|
23
|
+
- 写真はリポの外に置く(--out がリポの中なら断る)。
|
|
24
|
+
|
|
25
|
+
【終わりの番号】0 撮れた/2 使い方の誤り/3 画面が上がらなかった/4 共有のブラウザが無い/5 撮れなかった
|
|
26
|
+
"""
|
|
27
|
+
from __future__ import annotations
|
|
28
|
+
|
|
29
|
+
import argparse
|
|
30
|
+
import base64
|
|
31
|
+
import os
|
|
32
|
+
import re
|
|
33
|
+
import signal
|
|
34
|
+
import subprocess
|
|
35
|
+
import sys
|
|
36
|
+
import time
|
|
37
|
+
import urllib.error
|
|
38
|
+
import urllib.request
|
|
39
|
+
from pathlib import Path
|
|
40
|
+
from urllib.parse import urlparse
|
|
41
|
+
|
|
42
|
+
WIDTHS = (1280, 375)
|
|
43
|
+
HEIGHT = {1280: 800, 375: 812}
|
|
44
|
+
LABELS = ('before', 'after')
|
|
45
|
+
LABEL_JA = {'before': '直す前', 'after': '直した後'}
|
|
46
|
+
INSTALL_HINT = '人の手番=APPLY=1 bash scripts/pw-browser-install.sh(職人は入れない・鉄則8)'
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
def say(msg: str) -> None:
|
|
50
|
+
print(f'[screen_compare] {msg}', flush=True)
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
# ── 部品(ブラウザを使わない・試験で直に確かめる) ──────────────────────────
|
|
54
|
+
|
|
55
|
+
def page_name(url: str) -> str:
|
|
56
|
+
"""URL から写真の名前の部分を作る(/login → login、/ → top、/a/b?x=1 → a-b)。"""
|
|
57
|
+
p = urlparse(url).path.strip('/')
|
|
58
|
+
name = re.sub(r'[^0-9A-Za-z_-]+', '-', p).strip('-')
|
|
59
|
+
return name or 'top'
|
|
60
|
+
|
|
61
|
+
|
|
62
|
+
def shot_path(out: Path, label: str, name: str, width: int) -> Path:
|
|
63
|
+
return out / f'{label}-{name}-{width}.png'
|
|
64
|
+
|
|
65
|
+
|
|
66
|
+
def pair_path(out: Path, name: str, width: int) -> Path:
|
|
67
|
+
return out / f'compare-{name}-{width}.png'
|
|
68
|
+
|
|
69
|
+
|
|
70
|
+
def parse_env(items: list[str]) -> dict[str, str]:
|
|
71
|
+
"""--env KEY=VALUE を辞書にする。形が違えば ValueError。"""
|
|
72
|
+
env: dict[str, str] = {}
|
|
73
|
+
for it in items:
|
|
74
|
+
key, sep, val = it.partition('=')
|
|
75
|
+
if not sep or not re.fullmatch(r'[A-Za-z_][A-Za-z0-9_]*', key):
|
|
76
|
+
raise ValueError(f'--env は KEY=VALUE の形で渡す: {it!r}')
|
|
77
|
+
env[key] = val
|
|
78
|
+
return env
|
|
79
|
+
|
|
80
|
+
|
|
81
|
+
def inside_git_repo(p: Path) -> Path | None:
|
|
82
|
+
"""p(無ければ在る所まで上る)が git の作業場所の中なら、その根を返す。"""
|
|
83
|
+
cur = p.resolve()
|
|
84
|
+
while not cur.exists():
|
|
85
|
+
cur = cur.parent
|
|
86
|
+
for d in (cur, *cur.parents):
|
|
87
|
+
if (d / '.git').exists():
|
|
88
|
+
return d
|
|
89
|
+
return None
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
def find_pairs(out: Path) -> list[tuple[str, int]]:
|
|
93
|
+
"""直す前と直した後の両方がそろった (名前, 幅) の一覧。"""
|
|
94
|
+
pat = re.compile(r'^before-(.+)-(\d+)\.png$')
|
|
95
|
+
pairs = []
|
|
96
|
+
for f in sorted(out.glob('before-*.png')):
|
|
97
|
+
m = pat.match(f.name)
|
|
98
|
+
if m and shot_path(out, 'after', m.group(1), int(m.group(2))).exists():
|
|
99
|
+
pairs.append((m.group(1), int(m.group(2))))
|
|
100
|
+
return pairs
|
|
101
|
+
|
|
102
|
+
|
|
103
|
+
def pair_html(before_png: bytes, after_png: bytes, title: str) -> str:
|
|
104
|
+
"""左に直す前・右に直した後を並べたページ(画像は埋め込み=外を読みに行かない)。"""
|
|
105
|
+
def img(b: bytes) -> str:
|
|
106
|
+
return 'data:image/png;base64,' + base64.b64encode(b).decode('ascii')
|
|
107
|
+
cell = ('<figure><figcaption>{cap}</figcaption><img src="{src}"></figure>')
|
|
108
|
+
return (
|
|
109
|
+
'<!doctype html><meta charset="utf-8"><style>'
|
|
110
|
+
'body{margin:0;padding:16px;background:#f3f4f6;font-family:sans-serif}'
|
|
111
|
+
'h1{font-size:16px;margin:0 0 12px}main{display:flex;gap:16px;align-items:flex-start}'
|
|
112
|
+
'figure{margin:0;background:#fff;padding:8px;border:1px solid #d1d5db}'
|
|
113
|
+
'figcaption{font-size:14px;font-weight:bold;margin-bottom:6px}img{display:block}'
|
|
114
|
+
'</style>'
|
|
115
|
+
f'<h1>{title}</h1><main>'
|
|
116
|
+
+ cell.format(cap=LABEL_JA['before'], src=img(before_png))
|
|
117
|
+
+ cell.format(cap=LABEL_JA['after'], src=img(after_png))
|
|
118
|
+
+ '</main>'
|
|
119
|
+
)
|
|
120
|
+
|
|
121
|
+
|
|
122
|
+
def wait_http(url: str, timeout: float, proc: subprocess.Popen | None = None,
|
|
123
|
+
interval: float = 1.0) -> bool:
|
|
124
|
+
"""url が HTTP で返事をするまで待つ(返事の番号は問わない)。上がらず終われば False。
|
|
125
|
+
★localhost にはプロキシを通さない(環境変数のプロキシを拾わせない)。"""
|
|
126
|
+
opener = urllib.request.build_opener(urllib.request.ProxyHandler({}))
|
|
127
|
+
end = time.monotonic() + timeout
|
|
128
|
+
while time.monotonic() < end:
|
|
129
|
+
if proc is not None and proc.poll() is not None:
|
|
130
|
+
return False
|
|
131
|
+
try:
|
|
132
|
+
with opener.open(url, timeout=5):
|
|
133
|
+
return True
|
|
134
|
+
except urllib.error.HTTPError:
|
|
135
|
+
return True # 404 や 500 でも「上がっている」
|
|
136
|
+
except Exception:
|
|
137
|
+
time.sleep(interval)
|
|
138
|
+
return False
|
|
139
|
+
|
|
140
|
+
|
|
141
|
+
# 「AI が動かしている」の目印になる環境変数(@vercel/detect-agent が見る名前)。
|
|
142
|
+
# ★Next.js 16 の next dev は、これを見つけると現場の CLAUDE.md・AGENTS.md へ定型文を書き足す
|
|
143
|
+
# (実測 便 570f32d0:kenzokun-demo の CLAUDE.md に10行が足された)。撮るだけで現場を書き換えない
|
|
144
|
+
# ように、サーバーへは渡さない。サーバーの動きには要らない目印だけで、値は使わない。
|
|
145
|
+
AGENT_MARKERS = (
|
|
146
|
+
'AI_AGENT', 'CLAUDECODE', 'CLAUDE_CODE', 'CLAUDE_CODE_IS_COWORK',
|
|
147
|
+
'CURSOR_TRACE_ID', 'CURSOR_AGENT', 'CURSOR_EXTENSION_HOST_ROLE', 'GEMINI_CLI',
|
|
148
|
+
'CODEX_SANDBOX', 'CODEX_CI', 'CODEX_THREAD_ID', 'ANTIGRAVITY_AGENT', 'AUGMENT_AGENT',
|
|
149
|
+
'OPENCODE_CLIENT', 'REPL_ID', 'COPILOT_MODEL', 'COPILOT_ALLOW_ALL', 'COPILOT_GITHUB_TOKEN',
|
|
150
|
+
)
|
|
151
|
+
|
|
152
|
+
|
|
153
|
+
def server_env(base: dict[str, str], extra_env: dict[str, str]) -> dict[str, str]:
|
|
154
|
+
"""サーバーへ渡す環境。目印を外し、形だけの値を足す。"""
|
|
155
|
+
env = {k: v for k, v in base.items() if k not in AGENT_MARKERS}
|
|
156
|
+
env.update(extra_env)
|
|
157
|
+
return env
|
|
158
|
+
|
|
159
|
+
|
|
160
|
+
def tracked_changes(cwd: Path) -> set[str] | None:
|
|
161
|
+
"""cwd が git の作業場所なら、記録に残る変更(git status の行)の集まり。違えば None。"""
|
|
162
|
+
try:
|
|
163
|
+
r = subprocess.run(['git', '-C', str(cwd), 'status', '--porcelain'], capture_output=True,
|
|
164
|
+
text=True, timeout=30)
|
|
165
|
+
except (OSError, subprocess.TimeoutExpired):
|
|
166
|
+
return None
|
|
167
|
+
if r.returncode != 0:
|
|
168
|
+
return None
|
|
169
|
+
return {ln for ln in r.stdout.splitlines() if ln.strip()}
|
|
170
|
+
|
|
171
|
+
|
|
172
|
+
def start_server(cmd: str, cwd: Path, extra_env: dict[str, str], log: Path) -> subprocess.Popen:
|
|
173
|
+
"""サーバーを専用のプロセスグループで起動する(あとで一団ごと止めるため)。"""
|
|
174
|
+
env = server_env(dict(os.environ), extra_env)
|
|
175
|
+
fh = open(log, 'wb')
|
|
176
|
+
return subprocess.Popen(['bash', '-c', cmd], cwd=str(cwd), env=env, stdout=fh,
|
|
177
|
+
stderr=subprocess.STDOUT, stdin=subprocess.DEVNULL,
|
|
178
|
+
start_new_session=True)
|
|
179
|
+
|
|
180
|
+
|
|
181
|
+
def stop_server(proc: subprocess.Popen, grace: float = 10.0) -> None:
|
|
182
|
+
"""この道具が起動した一団だけを止める。★自分の一団には決して送らない。"""
|
|
183
|
+
try:
|
|
184
|
+
pgid = os.getpgid(proc.pid)
|
|
185
|
+
except ProcessLookupError:
|
|
186
|
+
return
|
|
187
|
+
if pgid == os.getpgid(0):
|
|
188
|
+
# 専用の一団になっていない=送ると自分まで止まる。子だけを止める。
|
|
189
|
+
proc.terminate()
|
|
190
|
+
try:
|
|
191
|
+
proc.wait(timeout=grace)
|
|
192
|
+
except subprocess.TimeoutExpired:
|
|
193
|
+
proc.kill()
|
|
194
|
+
return
|
|
195
|
+
for sig, wait in ((signal.SIGTERM, grace), (signal.SIGKILL, 5.0)):
|
|
196
|
+
try:
|
|
197
|
+
os.killpg(pgid, sig)
|
|
198
|
+
except ProcessLookupError:
|
|
199
|
+
break
|
|
200
|
+
end = time.monotonic() + wait
|
|
201
|
+
while time.monotonic() < end:
|
|
202
|
+
try:
|
|
203
|
+
os.killpg(pgid, 0) # 一団にまだ誰か居るか
|
|
204
|
+
except ProcessLookupError:
|
|
205
|
+
proc.poll()
|
|
206
|
+
return
|
|
207
|
+
proc.poll()
|
|
208
|
+
time.sleep(0.2)
|
|
209
|
+
proc.poll()
|
|
210
|
+
|
|
211
|
+
|
|
212
|
+
def log_tail(log: Path, n: int = 20) -> str:
|
|
213
|
+
try:
|
|
214
|
+
lines = log.read_text(encoding='utf-8', errors='replace').splitlines()
|
|
215
|
+
except OSError:
|
|
216
|
+
return ''
|
|
217
|
+
return '\n'.join(lines[-n:])
|
|
218
|
+
|
|
219
|
+
|
|
220
|
+
# ── ブラウザを使う所 ─────────────────────────────────────────────────────────
|
|
221
|
+
|
|
222
|
+
def open_browser():
|
|
223
|
+
"""共有の Chromium を開く。無ければ (None, 文) を返す(取りに行かない)。"""
|
|
224
|
+
os.environ.setdefault('PLAYWRIGHT_BROWSERS_PATH', str(Path.home() / '.tyhld' / 'pw-browsers'))
|
|
225
|
+
try:
|
|
226
|
+
from playwright.sync_api import sync_playwright
|
|
227
|
+
except ImportError:
|
|
228
|
+
return None, None, f'playwright が読めない(共有の python で呼んでいるか確かめる)。{INSTALL_HINT}'
|
|
229
|
+
pw = sync_playwright().start()
|
|
230
|
+
try:
|
|
231
|
+
browser = pw.chromium.launch(chromium_sandbox=False)
|
|
232
|
+
except Exception as e: # 実行ファイルが無い等
|
|
233
|
+
pw.stop()
|
|
234
|
+
return None, None, f'共有の Chromium を起動できない: {str(e).splitlines()[0]}。{INSTALL_HINT}'
|
|
235
|
+
return pw, browser, None
|
|
236
|
+
|
|
237
|
+
|
|
238
|
+
def take_shots(browser, urls: list[str], out: Path, label: str, wait_ms: int,
|
|
239
|
+
timeout_ms: int) -> list[str]:
|
|
240
|
+
"""2つの幅で撮る。返り: 報告に書く注意(行き先が変わった等)。"""
|
|
241
|
+
notes = []
|
|
242
|
+
for url in urls:
|
|
243
|
+
name = page_name(url)
|
|
244
|
+
for w in WIDTHS:
|
|
245
|
+
ctx = browser.new_context(viewport={'width': w, 'height': HEIGHT[w]},
|
|
246
|
+
device_scale_factor=1)
|
|
247
|
+
page = ctx.new_page()
|
|
248
|
+
try:
|
|
249
|
+
resp = page.goto(url, wait_until='load', timeout=timeout_ms)
|
|
250
|
+
try:
|
|
251
|
+
page.wait_for_load_state('networkidle', timeout=min(timeout_ms, 15000))
|
|
252
|
+
except Exception:
|
|
253
|
+
pass # 通信が止まない画面もある。load までは来ている
|
|
254
|
+
page.wait_for_timeout(wait_ms)
|
|
255
|
+
dst = shot_path(out, label, name, w)
|
|
256
|
+
page.screenshot(path=str(dst), full_page=True)
|
|
257
|
+
say(f'SHOT {dst}')
|
|
258
|
+
final = page.url
|
|
259
|
+
if urlparse(final).path != urlparse(url).path:
|
|
260
|
+
notes.append(f'{url} は {final} へ移った(ログインが要る画面かもしれない)')
|
|
261
|
+
if resp is not None and resp.status >= 400:
|
|
262
|
+
notes.append(f'{url} の返事が {resp.status}(幅 {w}px)')
|
|
263
|
+
finally:
|
|
264
|
+
ctx.close()
|
|
265
|
+
return notes
|
|
266
|
+
|
|
267
|
+
|
|
268
|
+
def make_pairs(browser, out: Path) -> list[Path]:
|
|
269
|
+
made = []
|
|
270
|
+
for name, w in find_pairs(out):
|
|
271
|
+
b = shot_path(out, 'before', name, w).read_bytes()
|
|
272
|
+
a = shot_path(out, 'after', name, w).read_bytes()
|
|
273
|
+
ctx = browser.new_context(viewport={'width': 400, 'height': 300}, device_scale_factor=1)
|
|
274
|
+
page = ctx.new_page()
|
|
275
|
+
try:
|
|
276
|
+
page.set_content(pair_html(b, a, f'{name}(幅 {w}px)'), wait_until='load')
|
|
277
|
+
dst = pair_path(out, name, w)
|
|
278
|
+
page.screenshot(path=str(dst), full_page=True)
|
|
279
|
+
say(f'PAIR {dst}')
|
|
280
|
+
made.append(dst)
|
|
281
|
+
finally:
|
|
282
|
+
ctx.close()
|
|
283
|
+
return made
|
|
284
|
+
|
|
285
|
+
|
|
286
|
+
# ── 入口 ─────────────────────────────────────────────────────────────────────
|
|
287
|
+
|
|
288
|
+
def check_out(out: Path) -> str | None:
|
|
289
|
+
root = inside_git_repo(out)
|
|
290
|
+
if root is not None:
|
|
291
|
+
return f'写真の置き場がリポの中になっている({root})。リポの外(報告の置き場の下など)を指す'
|
|
292
|
+
return None
|
|
293
|
+
|
|
294
|
+
|
|
295
|
+
def cmd_shot(a: argparse.Namespace) -> int:
|
|
296
|
+
out = Path(a.out).expanduser()
|
|
297
|
+
if (err := check_out(out)):
|
|
298
|
+
say(f'NG {err}')
|
|
299
|
+
return 2
|
|
300
|
+
try:
|
|
301
|
+
extra = parse_env(a.env)
|
|
302
|
+
except ValueError as e:
|
|
303
|
+
say(f'NG {e}')
|
|
304
|
+
return 2
|
|
305
|
+
out.mkdir(parents=True, exist_ok=True)
|
|
306
|
+
proc = None
|
|
307
|
+
log = out / f'server-{a.label}.log'
|
|
308
|
+
cwd = Path(a.cwd).expanduser()
|
|
309
|
+
before_changes = tracked_changes(cwd) if a.cmd else None
|
|
310
|
+
try:
|
|
311
|
+
if a.cmd:
|
|
312
|
+
proc = start_server(a.cmd, cwd, extra, log)
|
|
313
|
+
say(f'起動: {a.cmd}(記録 {log})')
|
|
314
|
+
if not wait_http(a.url[0], a.timeout, proc):
|
|
315
|
+
say(f'NG 画面が上がらなかった({a.timeout:.0f}秒): {a.url[0]}')
|
|
316
|
+
tail = log_tail(log)
|
|
317
|
+
if tail:
|
|
318
|
+
say('サーバーの記録(最後の行):\n' + tail)
|
|
319
|
+
return 3
|
|
320
|
+
pw, browser, err = open_browser()
|
|
321
|
+
if err:
|
|
322
|
+
say(f'NG {err}')
|
|
323
|
+
return 4
|
|
324
|
+
try:
|
|
325
|
+
notes = take_shots(browser, a.url, out, a.label, a.wait_ms, int(a.timeout * 1000))
|
|
326
|
+
pairs = make_pairs(browser, out) if a.label == 'after' else []
|
|
327
|
+
except Exception as e:
|
|
328
|
+
say(f'NG 撮れなかった: {str(e).splitlines()[0]}')
|
|
329
|
+
return 5
|
|
330
|
+
finally:
|
|
331
|
+
browser.close()
|
|
332
|
+
pw.stop()
|
|
333
|
+
for n in notes:
|
|
334
|
+
say(f'注意 {n}')
|
|
335
|
+
if a.label == 'after' and not pairs:
|
|
336
|
+
say('注意 直す前の写真が無いので並べた1枚は作っていない')
|
|
337
|
+
say(f'OK {a.label} を撮った(置き場 {out})')
|
|
338
|
+
return 0
|
|
339
|
+
finally:
|
|
340
|
+
if proc is not None:
|
|
341
|
+
stop_server(proc)
|
|
342
|
+
say('サーバーを止めた')
|
|
343
|
+
# ★起動しただけで現場の記録に残る変更が増えたら知らせる(戻すかは職人が決めて報告に書く)。
|
|
344
|
+
if before_changes is not None:
|
|
345
|
+
grown = sorted((tracked_changes(cwd) or set()) - before_changes)
|
|
346
|
+
for ln in grown:
|
|
347
|
+
say(f'注意 サーバーが現場を書き換えた(記録に残る変更): {ln}')
|
|
348
|
+
|
|
349
|
+
|
|
350
|
+
def cmd_pair(a: argparse.Namespace) -> int:
|
|
351
|
+
out = Path(a.out).expanduser()
|
|
352
|
+
if not find_pairs(out):
|
|
353
|
+
say(f'NG 直す前と直した後がそろった写真が無い: {out}')
|
|
354
|
+
return 5
|
|
355
|
+
pw, browser, err = open_browser()
|
|
356
|
+
if err:
|
|
357
|
+
say(f'NG {err}')
|
|
358
|
+
return 4
|
|
359
|
+
try:
|
|
360
|
+
make_pairs(browser, out)
|
|
361
|
+
finally:
|
|
362
|
+
browser.close()
|
|
363
|
+
pw.stop()
|
|
364
|
+
return 0
|
|
365
|
+
|
|
366
|
+
|
|
367
|
+
def build_parser() -> argparse.ArgumentParser:
|
|
368
|
+
ap = argparse.ArgumentParser(description='直す前と直した後の画面を2つの幅で撮って並べる(鉄則16)')
|
|
369
|
+
sub = ap.add_subparsers(dest='sub', required=True)
|
|
370
|
+
s = sub.add_parser('shot', help='起動→待つ→2つの幅で撮る→止める(after なら並べる)')
|
|
371
|
+
s.add_argument('--label', choices=LABELS, required=True)
|
|
372
|
+
s.add_argument('--out', required=True, help='写真の置き場(リポの外)')
|
|
373
|
+
s.add_argument('--url', action='append', required=True, help='撮る画面(何度でも)')
|
|
374
|
+
s.add_argument('--cmd', help='サーバーを起動する命令(無ければ起動しない)')
|
|
375
|
+
s.add_argument('--cwd', default='.', help='--cmd を流す場所')
|
|
376
|
+
s.add_argument('--env', action='append', default=[], help='起動に渡す形だけの値 KEY=VALUE')
|
|
377
|
+
s.add_argument('--timeout', type=float, default=180.0, help='上がるのを待つ秒')
|
|
378
|
+
s.add_argument('--wait-ms', type=int, default=1000, help='撮る前に置く間(ミリ秒)')
|
|
379
|
+
s.set_defaults(func=cmd_shot)
|
|
380
|
+
p = sub.add_parser('pair', help='そろった写真を並べ直す')
|
|
381
|
+
p.add_argument('--out', required=True)
|
|
382
|
+
p.set_defaults(func=cmd_pair)
|
|
383
|
+
return ap
|
|
384
|
+
|
|
385
|
+
|
|
386
|
+
def main(argv: list[str] | None = None) -> int:
|
|
387
|
+
a = build_parser().parse_args(argv)
|
|
388
|
+
return a.func(a)
|
|
389
|
+
|
|
390
|
+
|
|
391
|
+
if __name__ == '__main__':
|
|
392
|
+
sys.exit(main())
|