@tyhld/conductor 0.12.153 → 0.12.156
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/view-stream.js +59 -31
- package/dist/view.js +49 -25
- package/package.json +1 -1
- package/sales-template/setup.sh +4 -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/dist/view-stream.js
CHANGED
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
import { closeSync, existsSync, openSync, readSync, statSync } from 'node:fs';
|
|
31
31
|
import os from 'node:os';
|
|
32
32
|
import { extractProgressLine, loadActiveJob, loadLastJob, maskSecrets, } from './headless.js';
|
|
33
|
-
import { DETAIL_LINE_CHARS_MAX, LAST_OUTCOME_LABEL, STATUS_LABEL, STATUS_NOTE, collectSiteView, friendlyDuration, friendlyTime, hhmm, jobTitleFromBody, quietActivityNote, rawLogPath, } from './view.js';
|
|
33
|
+
import { DETAIL_LINE_CHARS_MAX, LAST_OUTCOME_LABEL, NO_JOB, STATUS_LABEL, STATUS_NOTE, collectSiteView, friendlyDuration, friendlyTime, hhmm, jobTitleFromBody, quietActivityNote, rawLogPath, relayRunningForSite, } from './view.js';
|
|
34
34
|
// ─────────────────────────────────────────────────────────────────────────────
|
|
35
35
|
// 定数(★線引きはここ1か所)
|
|
36
36
|
// ─────────────────────────────────────────────────────────────────────────────
|
|
@@ -495,34 +495,7 @@ export class FollowSession {
|
|
|
495
495
|
const nowMs = this.now();
|
|
496
496
|
if (this.deps.header !== undefined)
|
|
497
497
|
return this.deps.header(this.deps.site, nowMs);
|
|
498
|
-
|
|
499
|
-
const unknown = '—(確かめられません)';
|
|
500
|
-
const body = v.active?.body ?? v.last?.body ?? '';
|
|
501
|
-
const headline = jobHeadline(body);
|
|
502
|
-
const lines = [];
|
|
503
|
-
lines.push(`${v.site} ${STATUS_LABEL[v.status]} ${STATUS_NOTE[v.status]}`);
|
|
504
|
-
lines.push(`仕事:${headline.length > 0 ? headline : unknown}`);
|
|
505
|
-
if (v.postedAt !== null)
|
|
506
|
-
lines.push(`投函:${friendlyTime(v.postedAt, nowMs)}`);
|
|
507
|
-
lines.push(`開始:${v.startedAt !== null ? friendlyTime(v.startedAt, nowMs) : '—(まだ起動していません)'}`);
|
|
508
|
-
if (v.startedAt !== null) {
|
|
509
|
-
const until = v.status === 'working' ? nowMs : (v.lastActivityAt ?? v.last?.finishedAt ?? nowMs);
|
|
510
|
-
lines.push(`実作業:${friendlyDuration(until - v.startedAt)}`);
|
|
511
|
-
}
|
|
512
|
-
const sinceActivityMs = v.lastActivityAt === null ? null : nowMs - v.lastActivityAt;
|
|
513
|
-
if (v.lastActivityAt !== null) {
|
|
514
|
-
lines.push(`最後に動いた:${friendlyTime(v.lastActivityAt, nowMs)}(${friendlyDuration(sinceActivityMs ?? 0)}前)`);
|
|
515
|
-
}
|
|
516
|
-
if (v.status === 'working') {
|
|
517
|
-
const note = quietActivityNote(sinceActivityMs);
|
|
518
|
-
if (note !== null)
|
|
519
|
-
lines.push(`※${note}`);
|
|
520
|
-
}
|
|
521
|
-
lines.push('');
|
|
522
|
-
lines.push('※見るだけの画面です(職人へは何も送りません/職人も作業部屋も見守り役も起動しません)');
|
|
523
|
-
lines.push('※開いたままにしておくと、下へ流れ続けます。閉じるときは Ctrl+C を押してください');
|
|
524
|
-
lines.push(RULE);
|
|
525
|
-
return lines.join('\n');
|
|
498
|
+
return renderFollowHeader(collectSiteView(this.deps.site, nowMs));
|
|
526
499
|
}
|
|
527
500
|
/** この便を追い始める。 */
|
|
528
501
|
beginFollow(active, opts) {
|
|
@@ -700,15 +673,70 @@ export class FollowSession {
|
|
|
700
673
|
}
|
|
701
674
|
this.out(RULE);
|
|
702
675
|
}
|
|
703
|
-
/**
|
|
676
|
+
/**
|
|
677
|
+
* 便が無いときの知らせ(★1回だけ出して、そのまま待つ)。
|
|
678
|
+
* ★見守り役が止まっているときは「次の便を待っています」と言わない
|
|
679
|
+
* (上の行の 💤 PC停止中 と食い違うため)。
|
|
680
|
+
*/
|
|
704
681
|
noteWaiting() {
|
|
705
682
|
if (this.waitingNoted)
|
|
706
683
|
return;
|
|
707
684
|
this.waitingNoted = true;
|
|
708
|
-
this.
|
|
685
|
+
if ((this.deps.relayRunning ?? relayRunningForSite)(this.deps.site) === false) {
|
|
686
|
+
this.out(`${STATUS_LABEL.pc_down}(${STATUS_NOTE.pc_down})`);
|
|
687
|
+
this.out('※見守り役が動き出せば、次の便が始まったときに自動で流れ始めます');
|
|
688
|
+
return;
|
|
689
|
+
}
|
|
690
|
+
this.out(`${STATUS_LABEL.idle}(いまは便がありません。次の便を待っています)`);
|
|
709
691
|
this.out('※このまま開いておけば、次の便が始まったときに自動で流れ始めます');
|
|
710
692
|
}
|
|
711
693
|
}
|
|
694
|
+
/**
|
|
695
|
+
* 流れ続ける画面の見出し(★手元の事実だけから作る純粋関数)。
|
|
696
|
+
*
|
|
697
|
+
* ★下の流れと食い違わせない(便 a5d66c34)。いま動いている便が無いときは
|
|
698
|
+
* 「仕事:なし」とし、開始・実作業・最後に動いた は出さない(直前の仕事の値で埋めると、
|
|
699
|
+
* いま動いているように読める)。直前の仕事は「直前の仕事:…(結果)」の1行で分けて出す。
|
|
700
|
+
* ★「—(確かめられません)」は、便は在るのに題名が読めないときだけに使う。
|
|
701
|
+
*/
|
|
702
|
+
export function renderFollowHeader(v) {
|
|
703
|
+
const nowMs = v.nowMs;
|
|
704
|
+
const unknown = '—(確かめられません)';
|
|
705
|
+
const lines = [];
|
|
706
|
+
lines.push(`${v.site} ${STATUS_LABEL[v.status]} ${STATUS_NOTE[v.status]}`);
|
|
707
|
+
if (v.active === null) {
|
|
708
|
+
lines.push(`仕事:${NO_JOB}`);
|
|
709
|
+
if (v.last !== null) {
|
|
710
|
+
const prev = jobHeadline(v.last.body);
|
|
711
|
+
lines.push(`直前の仕事:${prev.length > 0 ? prev : unknown}(${LAST_OUTCOME_LABEL[v.last.outcome] ?? v.last.outcome}・${friendlyTime(v.last.finishedAt, nowMs)})`);
|
|
712
|
+
}
|
|
713
|
+
}
|
|
714
|
+
else {
|
|
715
|
+
const headline = jobHeadline(v.active.body);
|
|
716
|
+
lines.push(`仕事:${headline.length > 0 ? headline : unknown}`);
|
|
717
|
+
if (v.postedAt !== null)
|
|
718
|
+
lines.push(`投函:${friendlyTime(v.postedAt, nowMs)}`);
|
|
719
|
+
lines.push(`開始:${v.startedAt !== null ? friendlyTime(v.startedAt, nowMs) : '—(まだ起動していません)'}`);
|
|
720
|
+
if (v.startedAt !== null) {
|
|
721
|
+
const until = v.status === 'working' ? nowMs : (v.lastActivityAt ?? nowMs);
|
|
722
|
+
lines.push(`実作業:${friendlyDuration(until - v.startedAt)}`);
|
|
723
|
+
}
|
|
724
|
+
const sinceActivityMs = v.lastActivityAt === null ? null : nowMs - v.lastActivityAt;
|
|
725
|
+
if (v.lastActivityAt !== null) {
|
|
726
|
+
lines.push(`最後に動いた:${friendlyTime(v.lastActivityAt, nowMs)}(${friendlyDuration(sinceActivityMs ?? 0)}前)`);
|
|
727
|
+
}
|
|
728
|
+
if (v.status === 'working') {
|
|
729
|
+
const note = quietActivityNote(sinceActivityMs);
|
|
730
|
+
if (note !== null)
|
|
731
|
+
lines.push(`※${note}`);
|
|
732
|
+
}
|
|
733
|
+
}
|
|
734
|
+
lines.push('');
|
|
735
|
+
lines.push('※見るだけの画面です(職人へは何も送りません/職人も作業部屋も見守り役も起動しません)');
|
|
736
|
+
lines.push('※開いたままにしておくと、下へ流れ続けます。閉じるときは Ctrl+C を押してください');
|
|
737
|
+
lines.push(RULE);
|
|
738
|
+
return lines.join('\n');
|
|
739
|
+
}
|
|
712
740
|
// ─────────────────────────────────────────────────────────────────────────────
|
|
713
741
|
// 入口(view.ts が呼ぶ)
|
|
714
742
|
// ─────────────────────────────────────────────────────────────────────────────
|
package/dist/view.js
CHANGED
|
@@ -57,6 +57,7 @@ export const DETAIL_LINE_CHARS_MAX = 600;
|
|
|
57
57
|
export const STATUS_LABEL = {
|
|
58
58
|
working: '🟠 作業中',
|
|
59
59
|
queued: '⏳ 順番待ち',
|
|
60
|
+
idle: '⏳ 待機中',
|
|
60
61
|
pc_down: '💤 PC停止中',
|
|
61
62
|
unconfirmed: '🟡 未確認',
|
|
62
63
|
awaiting_user: '🔵 操作・確認待ち',
|
|
@@ -66,11 +67,14 @@ export const STATUS_LABEL = {
|
|
|
66
67
|
export const STATUS_NOTE = {
|
|
67
68
|
working: '職人が動いています',
|
|
68
69
|
queued: 'まだ職人を起動していません',
|
|
70
|
+
idle: 'いまは便がありません(次の便を待っています)',
|
|
69
71
|
pc_down: 'このPCの見守り役が動いていません',
|
|
70
72
|
unconfirmed: '職人は止まった/終了しました(確認前です)',
|
|
71
73
|
awaiting_user: 'えふさんの手番です',
|
|
72
74
|
done: '終わりました',
|
|
73
75
|
};
|
|
76
|
+
/** 便が無いときの「仕事」の欄(★「確かめられません」とは言わない)。 */
|
|
77
|
+
export const NO_JOB = 'なし';
|
|
74
78
|
/**
|
|
75
79
|
* 6つの状態のどれかを決める純粋関数(★「作業中」の条件を厳密にする所)。
|
|
76
80
|
*
|
|
@@ -88,7 +92,9 @@ export const STATUS_NOTE = {
|
|
|
88
92
|
* 長い試験や長い考えごとの最中に「止まった」と言わないため(便 062431f2 の直し)。
|
|
89
93
|
* c. 実プロセスが生きていて、見守り役の生死が確かめられない(null)→
|
|
90
94
|
* 手がかりは記録だけ。最近の記録があれば 🟠、無ければ 🟡。
|
|
91
|
-
* 4.
|
|
95
|
+
* 4. 実行中の仕事が無ければ、直前の仕事が done で終わっていれば ✅、
|
|
96
|
+
* 失敗などで終わっていれば 🟡(下の「結果:⚠ …」と食い違わせない)、
|
|
97
|
+
* 直前の仕事も無ければ ⏳ 待機中(★順番待ちとは言わない=上の型の注記)。
|
|
92
98
|
*/
|
|
93
99
|
export function decideSiteStatus(input) {
|
|
94
100
|
if (input.relayRunning === false)
|
|
@@ -103,9 +109,10 @@ export function decideSiteStatus(input) {
|
|
|
103
109
|
const activityFresh = input.sinceActivityMs !== null && input.sinceActivityMs <= QUIET_ACTIVITY_MS;
|
|
104
110
|
return activityFresh ? 'working' : 'unconfirmed';
|
|
105
111
|
}
|
|
106
|
-
if (input.hasLastJob)
|
|
107
|
-
return 'done';
|
|
108
|
-
|
|
112
|
+
if (input.hasLastJob) {
|
|
113
|
+
return input.lastOutcome === undefined || input.lastOutcome === 'done' ? 'done' : 'unconfirmed';
|
|
114
|
+
}
|
|
115
|
+
return 'idle';
|
|
109
116
|
}
|
|
110
117
|
/**
|
|
111
118
|
* 🟠 のまま添える注記を返す(記録が長く止まっているときだけ1行)。
|
|
@@ -345,6 +352,7 @@ export function collectSiteView(site, nowMs = Date.now()) {
|
|
|
345
352
|
sinceActivityMs: lastActivityAt === null ? null : nowMs - lastActivityAt,
|
|
346
353
|
awaitingUser,
|
|
347
354
|
hasLastJob: last !== null,
|
|
355
|
+
lastOutcome: last?.outcome,
|
|
348
356
|
});
|
|
349
357
|
const body = active?.body ?? last?.body ?? '';
|
|
350
358
|
return {
|
|
@@ -371,29 +379,18 @@ export function renderNormalView(v) {
|
|
|
371
379
|
const out = [];
|
|
372
380
|
const unknown = '—(確かめられません)';
|
|
373
381
|
out.push(`${v.site} ${STATUS_LABEL[v.status]} ${STATUS_NOTE[v.status]}`);
|
|
374
|
-
|
|
375
|
-
//
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
out.push(`実作業:${friendlyDuration(until - v.startedAt)}`);
|
|
381
|
-
}
|
|
382
|
-
else {
|
|
382
|
+
// ★いま動いている便が無いときは「仕事:なし」。直前の仕事は下の段に出す。
|
|
383
|
+
// 開始・実作業などを直前の仕事の値で埋めると、いま動いているように読める。
|
|
384
|
+
if (v.active === null) {
|
|
385
|
+
out.push(`仕事:${NO_JOB}`);
|
|
386
|
+
out.push('投函:—');
|
|
387
|
+
out.push('開始:—');
|
|
383
388
|
out.push('実作業:—');
|
|
389
|
+
out.push('最後に動いた:—');
|
|
390
|
+
out.push('現在:—');
|
|
384
391
|
}
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
out.push(v.lastActivityAt !== null
|
|
388
|
-
? `最後に動いた:${friendlyTime(v.lastActivityAt, v.nowMs)}(${friendlyDuration(sinceActivityMs ?? 0)}前)`
|
|
389
|
-
: `最後に動いた:${unknown}`);
|
|
390
|
-
const current = v.flow.length > 0 ? v.flow[v.flow.length - 1].text : '';
|
|
391
|
-
out.push(`現在:${current.length > 0 ? current : unknown}`);
|
|
392
|
-
// ★作業中のまま記録が長く止まっているときは、理由の候補を1行添える(状態は変えない)。
|
|
393
|
-
if (v.status === 'working') {
|
|
394
|
-
const note = quietActivityNote(sinceActivityMs);
|
|
395
|
-
if (note !== null)
|
|
396
|
-
out.push(`※${note}`);
|
|
392
|
+
else {
|
|
393
|
+
pushActiveFacts(out, v, unknown);
|
|
397
394
|
}
|
|
398
395
|
out.push(RULE);
|
|
399
396
|
if (v.flow.length > 0) {
|
|
@@ -427,6 +424,33 @@ export function renderNormalView(v) {
|
|
|
427
424
|
out.push('※Claude Code の生ログを見たいときは --detail を付けてください');
|
|
428
425
|
return out.join('\n');
|
|
429
426
|
}
|
|
427
|
+
/** いま動いている便の「仕事・投函・開始・実作業・最後に動いた・現在」の行。 */
|
|
428
|
+
function pushActiveFacts(out, v, unknown) {
|
|
429
|
+
out.push(`仕事:${v.title.length > 0 ? v.title : unknown}`);
|
|
430
|
+
// ★投函・開始・実作業を別々に出す(えふさん確定③)。
|
|
431
|
+
out.push(`投函:${v.postedAt !== null ? friendlyTime(v.postedAt, v.nowMs) : '—(管制が持っています)'}`);
|
|
432
|
+
out.push(`開始:${v.startedAt !== null ? friendlyTime(v.startedAt, v.nowMs) : '—(まだ起動していません)'}`);
|
|
433
|
+
if (v.startedAt !== null) {
|
|
434
|
+
const until = v.status === 'working' ? v.nowMs : (v.lastActivityAt ?? v.last?.finishedAt ?? v.nowMs);
|
|
435
|
+
out.push(`実作業:${friendlyDuration(until - v.startedAt)}`);
|
|
436
|
+
}
|
|
437
|
+
else {
|
|
438
|
+
out.push('実作業:—');
|
|
439
|
+
}
|
|
440
|
+
// ★「いつ」だけでなく「どれだけ前か」も出す(止まっている時間が一目で分かる)。
|
|
441
|
+
const sinceActivityMs = v.lastActivityAt === null ? null : v.nowMs - v.lastActivityAt;
|
|
442
|
+
out.push(v.lastActivityAt !== null
|
|
443
|
+
? `最後に動いた:${friendlyTime(v.lastActivityAt, v.nowMs)}(${friendlyDuration(sinceActivityMs ?? 0)}前)`
|
|
444
|
+
: `最後に動いた:${unknown}`);
|
|
445
|
+
const current = v.flow.length > 0 ? v.flow[v.flow.length - 1].text : '';
|
|
446
|
+
out.push(`現在:${current.length > 0 ? current : unknown}`);
|
|
447
|
+
// ★作業中のまま記録が長く止まっているときは、理由の候補を1行添える(状態は変えない)。
|
|
448
|
+
if (v.status === 'working') {
|
|
449
|
+
const note = quietActivityNote(sinceActivityMs);
|
|
450
|
+
if (note !== null)
|
|
451
|
+
out.push(`※${note}`);
|
|
452
|
+
}
|
|
453
|
+
}
|
|
430
454
|
/** 直前の仕事の終わり方の日本語。 */
|
|
431
455
|
export const LAST_OUTCOME_LABEL = {
|
|
432
456
|
done: '✅ 終わりました',
|
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/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())
|