@tyhld/conductor 0.12.185 → 0.12.187

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/headless.js CHANGED
@@ -1686,7 +1686,8 @@ export async function flushEvents(cfg, job) {
1686
1686
  // ─────────────────────────────────────────────────────────────────────────────
1687
1687
  /**
1688
1688
  * 便が終わった(★もう続きから起こさない)ときに、便ごとの作業場所を片付ける(便 27a9fb19)。
1689
- * ★記録していない変更・送っていない記録が残っていれば消さず、場所と理由を管制へ1回知らせる。
1689
+ * ★完了・停止・取りやめ・時間切れのどれで終わっても同じ決まり(便 954faaea)。
1690
+ * ★記録していない変更・どの枝にも無い記録が残っていれば消さず、理由・場所・枝を管制へ1回知らせる。
1690
1691
  * ★続きから起こす便(自動再開・利用上限の待ち)では呼ばない=同じ場所で続きを起こすため。
1691
1692
  */
1692
1693
  async function finishJobWorkDir(cfg, job) {
@@ -24,8 +24,15 @@
24
24
  * ・リポの元の場所の `.claude/settings.local.json`(記録されない守り)と、記録されていない
25
25
  * `.claude/settings.json` は、作業場所へ写す=★守りは1つも落とさない
26
26
  * (作業場所には記録された物しか無いので、写さないと現場ごとの守りが外れる)。
27
- * ・便が終わったら片付ける。★記録していない変更・送っていない記録が残っていれば消さない
28
- * (理由を返す=呼び出し側が報告に残す)。消すのは `git worktree remove`(--force なし)だけ。
27
+ * ・便が終わったら片付ける。★記録していない変更・どの枝にも無い記録が残っていれば消さない
28
+ * (理由・場所・枝を返す=呼び出し側が管制に残す)。消すのは `git worktree remove`(--force なし)だけ。
29
+ * ★枝の上の記録は、送っていなくても枝に残る(作業場所を消しても枝と記録は消えない・枝は消さない)
30
+ * ので、作業場所を片付けて枝を空ける(便 954faaea・送らない現場の止めた便が枝を握ったまま残った)。
31
+ * ・★記録された守りの設定(.claude/settings.json など)が、囲いのせいで古い版のまま残っていたら、
32
+ * 片付けの前に記録の版へ戻す(便 954faaea)。職人の囲いはこのファイルを書けない(中身を差し替えも
33
+ * 消しもできない)ので、職人が枝を移ると git はファイルを替えられず(unlink が Device or resource busy)、
34
+ * 前に居た記録の版のまま「変更あり」に見える。戻すのは、中身がこの作業場所で前に居た記録の版と
35
+ * 1バイト違わず同じときだけ(=職人が書いた物ではないと git の事実で言える)。それ以外は残す。
29
36
  * ・作れない現場(リポでない・origin の枝が無い・同じ名前の物が既に在る など)は
30
37
  * 今までどおりリポの元の場所で起こし、理由を返す(呼び出し側が記録する)。
31
38
  *
@@ -245,9 +252,61 @@ export function prepareJobWorkDir(opts) {
245
252
  return fallback(err instanceof Error ? err.message : String(err));
246
253
  }
247
254
  }
255
+ /** 作業場所の今の枝の名前(枝の上に居なければ null)。 */
256
+ function currentBranch(dir, git) {
257
+ const r = git(['-C', dir, 'symbolic-ref', '--quiet', '--short', 'HEAD']);
258
+ const name = r.stdout.trim();
259
+ return r.status === 0 && name ? name : null;
260
+ }
261
+ /**
262
+ * 記録された守りの設定が、囲いのせいで「この作業場所で前に居た記録の版」のまま残っていれば、
263
+ * 今の記録の版へ戻す(★戻した名前を返す・便 954faaea)。
264
+ *
265
+ * 【起きていたこと(実地 便 3e5659c1・kenzokun-demo)】作業場所は最新の origin から作られ、職人が
266
+ * 古い枝へ移った。職人の囲いは .claude/settings.json を書けないので、git は
267
+ * `unable to unlink old '.claude/settings.json': Device or resource busy` と言って枝だけ移り、
268
+ * ファイルは最新の版のまま残った。古い枝から見ると「禁止の行が1行消えた変更」に見え、片付けが
269
+ * 「記録していない変更」として作業場所を残し、枝を握ったままになった。
270
+ * ★戻すのは中身が前に居た記録の版と1バイト違わず同じときだけ(職人が書いた物ではないと git の
271
+ * 事実で言える)。記録待ちに載っている・消えている・どの版とも違う物には触らない(残す側に倒す)。
272
+ * ★戻す先は今の記録の版。記録(コミット)も、リポの元の場所の設定も1バイトも変えない。
273
+ */
274
+ function restoreStaleSettings(dir, git) {
275
+ const restored = [];
276
+ let seen = null;
277
+ for (const name of JOB_WORKDIR_SETTINGS_FILES) {
278
+ const rel = path.posix.join('.claude', name);
279
+ if (git(['-C', dir, 'ls-files', '--error-unmatch', '--', rel]).status !== 0)
280
+ continue;
281
+ if (git(['-C', dir, 'diff', '--quiet', '--', rel]).status === 0)
282
+ continue;
283
+ // 記録待ち(git add 済み)が今の記録と違えば、手が入っている=触らない。
284
+ if (git(['-C', dir, 'diff', '--cached', '--quiet', 'HEAD', '--', rel]).status !== 0)
285
+ continue;
286
+ const blob = git(['-C', dir, 'hash-object', '--', rel]);
287
+ const want = blob.stdout.trim();
288
+ if (blob.status !== 0 || !want)
289
+ continue;
290
+ if (seen === null) {
291
+ // この作業場所の HEAD が前に居た記録(作業場所を作った所・枝を移る前の所)。
292
+ const log = git(['-C', dir, 'log', '-g', '--format=%H', 'HEAD']);
293
+ seen = log.status === 0 ? [...new Set(log.stdout.split('\n').map((s) => s.trim()).filter(Boolean))] : [];
294
+ }
295
+ const stale = seen.some((c) => {
296
+ const r = git(['-C', dir, 'rev-parse', '--verify', '--quiet', `${c}:${rel}`]);
297
+ return r.status === 0 && r.stdout.trim() === want;
298
+ });
299
+ if (!stale)
300
+ continue;
301
+ if (git(['-C', dir, 'checkout', '--', rel]).status === 0)
302
+ restored.push(name);
303
+ }
304
+ return restored;
305
+ }
248
306
  /**
249
- * 便の作業場所を片付ける。例外は投げない。
250
- * ★記録していない変更・送っていない記録が残っていれば消さない(場所と理由を返す)。
307
+ * 便の作業場所を片付ける。例外は投げない。完了・停止・取りやめ・時間切れのどれで終わっても同じ決まり。
308
+ * ★記録していない変更・どの枝にも無い記録が残っていれば消さない(理由・場所・枝を返す)。
309
+ * ★枝の上の記録は送っていなくても枝に残るので、作業場所は片付けて枝を空ける(枝は消さない)。
251
310
  * ★`--force` は使わない(git が「きれいでない」と言う物は消さない)。
252
311
  */
253
312
  export function cleanupJobWorkDir(w, git = defaultGitRun) {
@@ -271,24 +330,33 @@ export function cleanupJobWorkDir(w, git = defaultGitRun) {
271
330
  }
272
331
  catch { /* 外せなければ下の状態確認が残す側に倒す */ }
273
332
  }
333
+ // 記録された守りの設定が、囲いのせいで前に居た記録の版のまま残っていれば戻す(職人の変更と数えない)。
334
+ const restored = restoreStaleSettings(w.dir, git);
335
+ const branch = currentBranch(w.dir, git);
336
+ const where = `${w.dir}(枝: ${branch ?? 'なし'})`;
274
337
  const keep = (why) => ({
275
338
  removed: false,
276
- note: `作業場所を消さずに残しました(${why}): ${w.dir}`,
339
+ note: `作業場所を消さずに残しました(${why}): ${where}`,
277
340
  });
278
341
  const st = git(['-C', w.dir, 'status', '--porcelain']);
279
342
  if (st.status !== 0)
280
343
  return keep(`状態を確かめられない: ${tail(st.stderr)}`);
281
344
  if (st.stdout.trim().length > 0)
282
345
  return keep('記録していない変更が残っている');
283
- const unpushed = git(['-C', w.dir, 'rev-list', '-n', '1', 'HEAD', '--not', '--remotes']);
284
- if (unpushed.status !== 0)
285
- return keep(`送ったかを確かめられない: ${tail(unpushed.stderr)}`);
286
- if (unpushed.stdout.trim().length > 0)
287
- return keep('送っていない記録が残っている');
346
+ // ★枝(手元の枝・origin の枝)のどれにも無い記録だけを数える。枝の上の記録は作業場所を消しても残る。
347
+ const orphan = git(['-C', w.dir, 'rev-list', '-n', '1', 'HEAD', '--not', '--remotes', '--branches']);
348
+ if (orphan.status !== 0)
349
+ return keep(`記録が枝に在るかを確かめられない: ${tail(orphan.stderr)}`);
350
+ if (orphan.stdout.trim().length > 0)
351
+ return keep('どの枝にも無い記録が残っている');
288
352
  const rm = git(['-C', w.repoDir, 'worktree', 'remove', w.dir]);
289
353
  if (rm.status !== 0)
290
354
  return keep(`git が消せないと言った: ${tail(rm.stderr)}`);
291
- return { removed: true, note: `作業場所を片付けました: ${w.dir}` };
355
+ const kept = branch === null ? '' : `・枝 ${branch} とその記録は残っています`;
356
+ const back = restored.length === 0
357
+ ? ''
358
+ : `(囲いで古いまま残った守りの設定 ${restored.map((n) => `.claude/${n}`).join('・')} を記録の版へ戻してから)`;
359
+ return { removed: true, note: `作業場所を片付けました${back}: ${w.dir}${kept}` };
292
360
  }
293
361
  /**
294
362
  * 職人へ渡す本文に添える「作業場所」の段(★純粋関数)。今までどおりの便では空文字。
@@ -300,5 +368,5 @@ export function jobWorkDirGuide(w) {
300
368
  return (`【作業場所】この便は配り役が作った便ごとの作業場所 ${w.dir} で起きています` +
301
369
  `(最新の origin の既定の枝・枝は未作成)。cd は不要。リポの元の場所 ${w.repoDir} では命令を動かさない。` +
302
370
  `枝は \`git switch -c <作業ブランチ名> --no-track origin/main\` で切る(新しい worktree は作らない)。` +
303
- `便が終わると配り役が片付けます(記録していない変更・送っていない記録が残っていれば残します)。`);
371
+ `便が終わると配り役が片付けます(記録していない変更・どの枝にも無い記録が残っていれば残します)。`);
304
372
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tyhld/conductor",
3
- "version": "0.12.185",
3
+ "version": "0.12.187",
4
4
  "description": "采配くん管制の見守りアプリ(conductor-agent)。各PCで常駐し、中央(devlog-tracker)へ定期的に生存報告(heartbeat)を送る常駐CLI。",
5
5
  "type": "module",
6
6
  "bin": {
@@ -16,10 +16,12 @@
16
16
  # ② 対話は /dev/tty から読む — `curl … | bash` では標準入力が【台本そのもの】に
17
17
  # 取られているので `read` は入力を求めずに空を返す(実測 2026-09-03)。
18
18
  # 端末そのもの(/dev/tty)から読めば、パイプの中からでも入力を求められる。
19
- # ③ 止まる段は日本語で案内して止まる — ブラウザのやり取りが要るもの
20
- # (Claude Code のログイン・GitHub のログイン)と、再起動が要るもの
21
- # (WSL の systemd 有効化)は人の手番。「何をして、終わったらこの1行をもう一度」
22
- # と書いて exit 1 する。次に打つと済み判定で飛ぶので、続きから進む。
19
+ # ③ 途中で止まらず最後まで進む(えふさん方針 2026-11-14・便 1aec413a)—
20
+ # 人が答えるのは最初の管理者のパスワードと、その場で端末につないで流すログイン
21
+ # (Claude Code・GitHub。ブラウザで済ませると自動で続きへ進む)と、合言葉だけ。
22
+ # 止まるのは、ログインの失敗・中断と、再起動が要るもの(WSL の systemd 有効化)だけ。
23
+ # 止まるときは「何をして、終わったらこの1行をもう一度」と書いて exit 1 する。
24
+ # 次に打つと済み判定で飛ぶので、続きから進む。
23
25
  #
24
26
  # 【sudo について】
25
27
  # sudo はパスワードを標準入力ではなく【端末】から読む(man sudo: "read it from the
@@ -109,7 +111,8 @@ APT_PACKAGES=(
109
111
  # ★囲い(sandbox)の部品。無いと職人が起動を断る(設定 sandbox.failIfUnavailable のため)。
110
112
  # えふさん確定 2026-10-02・判断1(b)=1行インストーラでここまで入れる。
111
113
  # 実物(2026-10-02・ノートPC): これが無くて便 7901973d が3回続けて起動に失敗した。
112
- # ★先頭の確かめ(preflight)は残す=入れられなかった機では止まって案内する。
114
+ # ★確かめ(preflight)は残す。ただし1行インストーラだけは②で入れてから確かめる
115
+ # (便 1aec413a)=入れられなかった機では②の後で止まって案内する。
113
116
  bubblewrap # 囲いの本体。職人の書き込みを決めた場所だけに閉じる
114
117
  socat # 囲いの中と外をつなぐ通信の中継
115
118
  )
@@ -204,19 +207,30 @@ die() {
204
207
  # 入力元。既定は本物の端末。検査だけがここを差し替える。
205
208
  INSTALL_TTY="${CONDUCTOR_INSTALL_TTY:-/dev/tty}"
206
209
 
207
- # 入力元を開いて読み取り用の 3 番につなぐ。開けなければ日本語で止まる。
208
- tty_open() {
210
+ # 入力元を開いて読み取り用の 3 番につなぐ。開けなければ止まらずに 1 を返す(⑦⑧のログインが使う)。
211
+ # ★`exec 3<… 2>/dev/null` と書くと exec が stderr も /dev/null に永続的に向けてしまう。
212
+ # 先に開けるかをサブシェルで試し、開けるときだけ exec する(fd 4 と同じ作法)。
213
+ tty_try_open() {
209
214
  if [[ "${TTY_READY:-0}" == "1" ]]; then
210
215
  return 0
211
216
  fi
212
- if ! exec 3<"$INSTALL_TTY" 2>/dev/null; then
217
+ if (exec 3<"$INSTALL_TTY") 2>/dev/null; then
218
+ exec 3<"$INSTALL_TTY"
219
+ TTY_READY=1
220
+ return 0
221
+ fi
222
+ return 1
223
+ }
224
+
225
+ # 入力元を開いて読み取り用の 3 番につなぐ。開けなければ日本語で止まる。
226
+ tty_open() {
227
+ if ! tty_try_open; then
213
228
  printf '\n[install] ここから先は、お客さまに入力していただく必要があります。\n' >&4
214
229
  printf '[install] ★いまの実行には「入力できる画面(端末)」がありません。\n' >&4
215
230
  printf '[install] 自動実行や、画面のない環境からは進められません。\n' >&4
216
231
  printf '[install] Ubuntu(WSL)の画面をご自分で開いて、そこで1行を打ち直してください。\n' >&4
217
232
  exit 1
218
233
  fi
219
- TTY_READY=1
220
234
  }
221
235
 
222
236
  # 端末へ聞く。 ask_tty <入れる変数名> <聞く文> [既定値]
@@ -729,10 +743,29 @@ MSG
729
743
  ;;
730
744
  esac
731
745
 
732
- # --- 職人が始まるのに要る物(★先頭で確かめる・台本は自分で入れない) -----------
733
- # Claude Code がまだ無いのはかまわない(⑥で入れる)。古いとき・囲いの部品が無いときは止まる。
746
+ # --- 職人が始まるのに要る物(★先頭で確かめる) ----------------------------------
747
+ # Claude Code がまだ無いのはかまわない(⑥で入れる)。古いときは止まる。
748
+ #
749
+ # 【囲いの部品だけは②で入れてから確かめる(えふさん方針 2026-11-14・便 1aec413a)】
750
+ # 新しい PC には bubblewrap・socat が無い。以前はここで止まって sudo の1行を出していたので、
751
+ # 新しい PC は必ずここで止まり、1行を打ち直していた(便 16bfddd7 の重大発見1)。
752
+ # ②はもともと2つを入れる(APT_PACKAGES)ので、apt で入れられる機では②へ回し、
753
+ # ②の後に同じ確かめ(preflight_check)をもう一度流して、まだ足りなければそこで止まる。
754
+ # ★確かめの中身(preflight の印の間)は3つの台本で1文字も変えていない。
755
+ # 変えたのは、1行インストーラが確かめを呼ぶ所と順番だけ。
756
+ SANDBOX_PARTS_LATER=0
757
+ if [[ "$(uname -s)" == "Linux" ]] && have apt-get && { ! have bwrap || ! have socat; }; then
758
+ SANDBOX_PARTS_LATER=1
759
+ fi
760
+
734
761
  PREFLIGHT_GUIDE=''
735
- if preflight_check later; then
762
+ if [[ "$SANDBOX_PARTS_LATER" == "1" ]]; then
763
+ if [[ "$DRY_RUN" == "1" ]]; then
764
+ plan '囲いの部品(bubblewrap・socat)は、②で入れてから確かめます'
765
+ else
766
+ note '・囲いの部品(bubblewrap・socat)は、このあと②で入れてから確かめます'
767
+ fi
768
+ elif preflight_check later; then
736
769
  printf '%s' "$PREFLIGHT_INFO" | sed 's/^/ /'
737
770
  else
738
771
  printf '%s' "$PREFLIGHT_INFO" | sed 's/^/ /'
@@ -806,11 +839,23 @@ for p in "${APT_PACKAGES[@]}"; do
806
839
  APT_MISSING+=("$p")
807
840
  fi
808
841
  done
842
+ # ★⓪で②へ回した囲いの部品は、命令が無ければ必ず入れる側へ数える(名前の登録だけ残っている機もある)。
843
+ if [[ "$SANDBOX_PARTS_LATER" == "1" ]]; then
844
+ if ! have bwrap && [[ " ${APT_MISSING[*]:-} " != *" bubblewrap "* ]]; then
845
+ APT_MISSING+=(bubblewrap)
846
+ fi
847
+ if ! have socat && [[ " ${APT_MISSING[*]:-} " != *" socat "* ]]; then
848
+ APT_MISSING+=(socat)
849
+ fi
850
+ fi
809
851
 
810
852
  NEED_SYSTEM_NODE=0
811
853
  path_here /usr/bin/node || NEED_SYSTEM_NODE=1
812
854
 
813
- # setup.sh ③ が /usr/local/bin/node のリンクを作るときにも管理者の許可が要る。
855
+ # /usr/local/bin/node のリンクを作るときにも管理者の許可が要る。
856
+ # ★以前はリンクを最後の setup.sh ③ で作っていたので、途中のログインに時間がかかると
857
+ # 許可の覚えが切れて、パスワードをもう一度聞いていた(便 16bfddd7 の重大発見6)。
858
+ # =このリンクも④の終わり(最初の許可がまだ効いている所)で作る(便 1aec413a)。
814
859
  NEED_NODE_LINK=0
815
860
  path_here /usr/local/bin/node || NEED_NODE_LINK=1
816
861
 
@@ -833,7 +878,7 @@ else
833
878
  record '管理者の許可: 既に通っていた'
834
879
  else
835
880
  say ' これから、パソコンに道具を入れるために【管理者の許可】を何度か使います。'
836
- say ' いちばん最初に1回だけパスワードをお聞きします(以後は聞きません)。'
881
+ say ' いちばん最初に1回だけパスワードをお聞きします(管理者の許可が要る作業は、このすぐ後にまとめて済ませます)。'
837
882
  say ' ★Ubuntu を最初に開いたときに決めたパスワードです。'
838
883
  tty_open
839
884
  if ! sudo -v; then
@@ -879,6 +924,16 @@ else
879
924
  fi
880
925
  fi
881
926
 
927
+ # ★⓪で②へ回した確かめを、ここで流す(中身は⓪と同じ preflight_check)。
928
+ if [[ "$SANDBOX_PARTS_LATER" == "1" && "$DRY_RUN" != "1" ]]; then
929
+ if preflight_check later; then
930
+ printf '%s' "$PREFLIGHT_INFO" | sed 's/^/ /'
931
+ record '囲いの部品: ②で入れて確かめた'
932
+ else
933
+ halt "$(printf '職人が始まるのに要る物が足りません。次の1行を打ってください。\n\n%s' "$PREFLIGHT_NG")"
934
+ fi
935
+ fi
936
+
882
937
  # ═════════════════════════════════════════════════════════════════════════════
883
938
  # ③ Node(人と職人が使う側)
884
939
  #
@@ -956,6 +1011,26 @@ else
956
1011
  record '常駐用 Node: 入れた'
957
1012
  fi
958
1013
 
1014
+ # --- 常駐から見える node のリンク(/usr/local/bin/node)---------------------------
1015
+ # ★①の許可がまだ効いているここで作る(便 1aec413a)。作り方は setup.sh ③ と同じ
1016
+ # (いま使っている node の実体を指す)。作っておけば setup.sh ③ は「既に正しい」で飛ぶ。
1017
+ # ★作れなくても止めない。setup.sh ③ が今までどおり作り直す(そこでパスワードを聞くことがある)。
1018
+ # ★無いときだけ作る(在る物は書き換えない=向きが違うときの直しは setup.sh ③ に任せる)。
1019
+ if [[ "$NEED_NODE_LINK" == "1" ]]; then
1020
+ if [[ "$DRY_RUN" == "1" ]]; then
1021
+ plan '常駐から見える node のリンクを作ります(/usr/local/bin/node・sudo)'
1022
+ else
1023
+ NODE_REAL="$(realpath "$(command -v node)" 2>/dev/null || true)"
1024
+ if [[ -n "$NODE_REAL" ]] && run "常駐から見える node のリンクを作ります(/usr/local/bin/node → ${NODE_REAL})" \
1025
+ sudo ln -s "$NODE_REAL" /usr/local/bin/node; then
1026
+ record 'node のリンク: 作った'
1027
+ else
1028
+ note '⚠ node のリンクを作れませんでした(このあとの設置で、もう一度作ります)'
1029
+ record 'node のリンク: 設置に任せた'
1030
+ fi
1031
+ fi
1032
+ fi
1033
+
959
1034
  # ═════════════════════════════════════════════════════════════════════════════
960
1035
  # ⑤ pnpm を使えるようにする(corepack)
961
1036
  #
@@ -1025,14 +1100,26 @@ if [[ "$DRY_RUN" != "1" ]] && ! preflight_check need; then
1025
1100
  fi
1026
1101
 
1027
1102
  # ═════════════════════════════════════════════════════════════════════════════
1028
- # ⑦ 職人のログイン(★お客さまの手番・ここで止まることがある)
1103
+ # ⑦ 職人のログイン(★お客さまの手番・その場で端末につないで流す)
1104
+ #
1105
+ # 【止まらずに続ける(えふさん方針 2026-11-14・便 1aec413a)】
1106
+ # 以前はここで止まり、お客さまが別の命令を打ってから1行を打ち直していた。
1107
+ # いまは `claude auth login` をその場で端末につないで流し、ログインが済んだら続きへ進む。
1108
+ # ★止まるのは、ログインに失敗・中断したときと、入力できる画面(端末)が無いときだけ。
1109
+ # その時は理由を1行出し、手で済ませる方法を出して止まる(打ち直せば続きから進む)。
1029
1110
  # ═════════════════════════════════════════════════════════════════════════════
1030
1111
 
1031
1112
  step '⑦ 職人のログイン'
1032
1113
 
1114
+ # ログインの命令を、端末(入力 3 番・出力 4 番)につないで流す。 login_on_tty <命令…>
1115
+ # ★標準入力は台本そのもの(curl … | bash)なので、そのままではログインの命令が入力を読めない。
1116
+ login_on_tty() {
1117
+ "$@" <&3 >&4 2>&4
1118
+ }
1119
+
1033
1120
  CLAUDE_LOGIN_GUIDE=$(cat <<MSG
1034
- 職人(Claude Code)へのログインが、まだ済んでいません。
1035
- ログインはブラウザで行うため、こちらからは代われません。次のようにしてください。
1121
+ 職人(Claude Code)へのログインが、済みませんでした(中断したか、うまくいかなかったか、入力できる画面がありません)。
1122
+ ログインはブラウザで行います。次のようにしてください。
1036
1123
 
1037
1124
  【1】この画面で、次の1行を打ちます
1038
1125
 
@@ -1050,27 +1137,41 @@ if [[ "$DRY_RUN" == "1" ]]; then
1050
1137
  if claude_logged_in "$CLAUDE_BIN"; then
1051
1138
  skip '職人はログイン済みです'
1052
1139
  else
1053
- plan 'ログインが済んでいないため、ここで案内して止まります'
1140
+ plan 'ログインが済んでいないため、ここでブラウザのログインを始めます(済んだら続きへ進みます)'
1054
1141
  fi
1055
1142
  elif claude_logged_in "$CLAUDE_BIN"; then
1056
1143
  skip '職人はログイン済みです'
1057
1144
  record '職人のログイン: 済み'
1058
1145
  else
1059
- halt "$CLAUDE_LOGIN_GUIDE"
1146
+ if tty_try_open; then
1147
+ say ' 職人(Claude Code)にログインします。画面の案内にしたがって、ブラウザでログインしてください。'
1148
+ say ' (ブラウザが自動で開かないときは、画面に出た住所をコピーしてご自分でブラウザに貼ってください)'
1149
+ say ' ★ログインが済むと、自動で続きへ進みます。'
1150
+ run 'ログインを始めます' login_on_tty "$CLAUDE_BIN" auth login || true
1151
+ fi
1152
+ if claude_logged_in "$CLAUDE_BIN"; then
1153
+ say ' ログインできました。続きへ進みます。'
1154
+ record '職人のログイン: その場で済ませた'
1155
+ else
1156
+ halt "$CLAUDE_LOGIN_GUIDE"
1157
+ fi
1060
1158
  fi
1061
1159
 
1062
1160
  # ═════════════════════════════════════════════════════════════════════════════
1063
- # ⑧ GitHub のログイン(★お客さまの手番・ここで止まることがある)
1161
+ # ⑧ GitHub のログイン(★お客さまの手番・その場で端末につないで流す)
1064
1162
  #
1065
1163
  # 【なぜ要るか】職人は作業のまとまりごとに GitHub 上で「変更のお知らせ(PR)」を
1066
1164
  # 作る。ログインしていないとそこで止まってしまう。
1165
+ # 【止まらずに続ける(便 1aec413a)】⑦と同じ。`gh auth login` をその場で流す。
1166
+ # 聞かれる4問のうち3問(どこの GitHub か・つなぎ方・ブラウザで行うか)は旗で決めて渡す。
1167
+ # ★止まるのは、ログインに失敗・中断したときと、入力できる画面が無いときだけ。
1067
1168
  # ═════════════════════════════════════════════════════════════════════════════
1068
1169
 
1069
1170
  step '⑧ GitHub のログイン'
1070
1171
 
1071
1172
  GH_LOGIN_GUIDE=$(cat <<'MSG'
1072
- GitHub(プログラムの保管場所)へのログインが、まだ済んでいません。
1073
- こちらもブラウザでのやり取りが要るため、代われません。次のようにしてください。
1173
+ GitHub(プログラムの保管場所)へのログインが、済みませんでした(中断したか、うまくいかなかったか、入力できる画面がありません)。
1174
+ ログインはブラウザで行います。次のようにしてください。
1074
1175
 
1075
1176
  【1】この画面で、次の1行を打ちます
1076
1177
 
@@ -1103,14 +1204,28 @@ if [[ "$DRY_RUN" == "1" ]]; then
1103
1204
  plan 'git の受け渡しをそろえます(gh auth setup-git)'
1104
1205
  fi
1105
1206
  else
1106
- plan 'ログインが済んでいないため、ここで案内して止まります'
1207
+ plan 'ログインが済んでいないため、ここでブラウザのログインを始めます(済んだら続きへ進みます)'
1107
1208
  fi
1108
1209
  elif ! have gh; then
1109
1210
  die 'gh(GitHub の道具)が見つかりません(②で入るはずのものです)'
1110
- elif ! gh_logged_in; then
1111
- halt "$GH_LOGIN_GUIDE"
1112
1211
  else
1113
- skip 'GitHub はログイン済みです'
1212
+ if gh_logged_in; then
1213
+ skip 'GitHub はログイン済みです'
1214
+ else
1215
+ if tty_try_open; then
1216
+ say ' GitHub にログインします。'
1217
+ say ' 「Authenticate Git with your GitHub credentials?」と聞かれたら、そのまま Enter(はい)を押してください。'
1218
+ say ' 画面に8文字の合言葉が出たら、Enter でブラウザを開き、その合言葉を貼り付けます。'
1219
+ say ' ★ログインが済むと、自動で続きへ進みます。'
1220
+ run 'ログインを始めます' login_on_tty gh auth login --hostname github.com --git-protocol https --web || true
1221
+ fi
1222
+ if gh_logged_in; then
1223
+ say ' ログインできました。続きへ進みます。'
1224
+ record 'GitHub のログイン: その場で済ませた'
1225
+ else
1226
+ halt "$GH_LOGIN_GUIDE"
1227
+ fi
1228
+ fi
1114
1229
  if gh_git_ready; then
1115
1230
  skip 'git の受け渡しもそろっています'
1116
1231
  record 'GitHub: 済み'
@@ -825,10 +825,13 @@ else
825
825
  ;;
826
826
  esac
827
827
 
828
- cat > "$ENV_FILE" <<ENVEOF
828
+ # ★作る瞬間から他人に読ませない(便 1aec413a・install.sh ⑪と同じ作法)。
829
+ # 以前は書いてから chmod していたので、その間だけ umask どおり(ふつう 644)の権限で在った。
830
+ ( umask 077; cat > "$ENV_FILE" <<ENVEOF
829
831
  CONDUCTOR_URL=${input_url}
830
832
  CONDUCTOR_TOKEN=${input_secret}
831
833
  ENVEOF
834
+ ) || fail "接続情報を書けませんでした: $ENV_FILE"
832
835
  chmod 600 "$ENV_FILE"
833
836
  echo "[setup] $ENV_FILE を作成しました(本人だけが読める権限にしました)"
834
837
  fi
@@ -1153,15 +1156,9 @@ if [[ -f "$SETTINGS_SRC" && "$SITE_LOCAL_OK" != "1" ]]; then
1153
1156
  elif [[ -f "$SETTINGS_SRC" ]]; then
1154
1157
  [[ "$SITE_LOCAL_MSG" == "既に除外されています" ]] || echo "[setup] 記録しない置き場にしました($SITE_LOCAL_MSG)"
1155
1158
  if [[ -f "$SETTINGS_DST" ]]; then
1156
- echo "[setup] $SETTINGS_DST は既に存在します。上書きしますか?"
1157
- setup_read overwrite " 上書き (y/N): "
1158
- # shellcheck disable=SC2154 # overwrite は setup_read で間接代入される
1159
- if [[ "$(lower "$overwrite")" != "y" ]]; then
1160
- echo "[setup] 現場の settings.local.json をスキップしました。"
1161
- else
1162
- cp -f "$SETTINGS_SRC" "$SETTINGS_DST"
1163
- echo "[setup] 配置: $SETTINGS_DST(上書き)"
1164
- fi
1159
+ # ★聞かずに、今までの既定の答え(N=上書きしない)と同じ動きにする(便 1aec413a・途中で質問しない)。
1160
+ # 守りの中身をそろえ直すのは update-guard.sh ④ の受け持ち(ここで上書きして人の変更を消さない)。
1161
+ echo "[setup] $SETTINGS_DST は既に存在します → そのまま(上書きしません)"
1165
1162
  else
1166
1163
  cp -f "$SETTINGS_SRC" "$SETTINGS_DST"
1167
1164
  echo "[setup] 配置: $SETTINGS_DST"
@@ -1179,27 +1176,20 @@ elif [[ -f "$SETTINGS_SRC" ]]; then
1179
1176
  echo "[setup] <PROJECT_DIR> → $ABS_PROJECT_DIR に置換"
1180
1177
  fi
1181
1178
 
1182
- # Supabase 設定
1179
+ # Supabase の穴埋め
1180
+ # ★聞かずに、今までの「使わない(N)」と答えたときと同じ扱いにする(便 1aec413a・途中で質問しない)。
1181
+ # 囲いはいつも入る(下の通り、外すのは穴埋めの1行だけ)。あとで Supabase を使うときの足し方は
1182
+ # ⑧の案内に1行で出す(SUPABASE_ADD_LATER)。
1183
+ SUPABASE_ADD_LATER=0
1183
1184
  if [[ -f "$SETTINGS_DST" ]] && grep -q '<SUPABASE_PROJECT_ID>' "$SETTINGS_DST"; then
1184
- echo
1185
- setup_read use_supabase "[setup] Supabase を使いますか? (y/N): "
1186
- # shellcheck disable=SC2154 # use_supabase は setup_read で間接代入される
1187
- if [[ "$(lower "$use_supabase")" == "y" ]]; then
1188
- setup_read supabase_id " Supabase Project Reference ID: "
1189
- if [[ -n "$supabase_id" ]]; then
1190
- sed_replace "s|<SUPABASE_PROJECT_ID>|${supabase_id}|g" "$SETTINGS_DST"
1191
- echo "[setup] <SUPABASE_PROJECT_ID> → $supabase_id に置換"
1192
- else
1193
- warn "Supabase ID が空のため、sandbox 設定にプレースホルダが残ります。"
1194
- fi
1195
- else
1196
- # ★Supabase を使わなくても、囲い(sandbox)の節は残す(便 a940fa1a)。
1197
- # 以前は N で sandbox の節をまるごと消していた=囲い(書き込みの閉じ込め・起動を断る設定・
1198
- # 本番の記録への直結の締め出し)が全部外れ、職人が囲い無しで動いていた。
1199
- # 消してよいのは、参照番号の穴埋めが残っている行(db.<SUPABASE_PROJECT_ID>.supabase.co)だけ。
1200
- # pooler の2行・ほかの守りは1つも外さない。★囲いを外す道を残さない。
1201
- # ★パスはコードに埋め込まず引数で渡す(パスの字で python の文が壊れないように)。
1202
- if python3 - "$SETTINGS_DST" <<'PY' 2>/dev/null; then
1185
+ SUPABASE_ADD_LATER=1
1186
+ # ★Supabase を使わなくても、囲い(sandbox)の節は残す(便 a940fa1a)。
1187
+ # 以前は N で sandbox の節をまるごと消していた=囲い(書き込みの閉じ込め・起動を断る設定・
1188
+ # 本番の記録への直結の締め出し)が全部外れ、職人が囲い無しで動いていた。
1189
+ # 消してよいのは、参照番号の穴埋めが残っている行(db.<SUPABASE_PROJECT_ID>.supabase.co)だけ。
1190
+ # pooler の2行・ほかの守りは1つも外さない。★囲いを外す道を残さない。
1191
+ # ★パスはコードに埋め込まず引数で渡す(パスの字で python の文が壊れないように)。
1192
+ if python3 - "$SETTINGS_DST" <<'PY' 2>/dev/null; then
1203
1193
  import json, sys
1204
1194
  p = sys.argv[1]
1205
1195
  with open(p) as f:
@@ -1212,10 +1202,9 @@ with open(p, 'w') as f:
1212
1202
  json.dump(d, f, indent=2, ensure_ascii=False)
1213
1203
  f.write('\n')
1214
1204
  PY
1215
- echo "[setup] Supabase 不使用のため、参照番号の穴埋めが残る1行だけを外しました(囲いの設定はそのまま残しています)"
1216
- else
1217
- warn "参照番号の穴埋めの行を外せませんでした(囲いの設定はそのまま残っています。穴埋めの行は害がありません)。"
1218
- fi
1205
+ echo "[setup] Supabase の参照番号は聞かずに、穴埋めが残る1行だけを外しました(囲いの設定はそのまま残しています)"
1206
+ else
1207
+ warn "参照番号の穴埋めの行を外せませんでした(囲いの設定はそのまま残っています。穴埋めの行は害がありません)。"
1219
1208
  fi
1220
1209
  fi
1221
1210
  else
@@ -1231,10 +1220,8 @@ if [[ "$PROFILE" == "proto" ]]; then
1231
1220
  ENV_EXAMPLE_DST="$PROJECT_DIR/.env.example"
1232
1221
  write_env_example=1
1233
1222
  if [[ -f "$ENV_EXAMPLE_DST" ]]; then
1234
- echo "[setup] $ENV_EXAMPLE_DST は既に存在します。上書きしますか?"
1235
- setup_read overwrite_env " 上書き (y/N): "
1236
- # shellcheck disable=SC2154 # overwrite_env は setup_read で間接代入される
1237
- [[ "$(lower "$overwrite_env")" == "y" ]] || write_env_example=0
1223
+ # ★聞かずに、今までの既定の答え(N=上書きしない)と同じ動きにする(便 1aec413a)。
1224
+ write_env_example=0
1238
1225
  fi
1239
1226
  if [[ "$write_env_example" == "1" ]]; then
1240
1227
  if node "$PROTO_GEN" env > "$ENV_EXAMPLE_DST"; then
@@ -1578,6 +1565,43 @@ if [[ -n "$PREFLIGHT_CLAUDE_BIN" ]]; then
1578
1565
  else
1579
1566
  mark ng "職人(Claude Code)が使える" "常駐が見つけられる置き場へ入れてください:$(preflight_claude_install_line)"
1580
1567
  fi
1568
+ # ★現場のフォルダが git のリポか(便 1aec413a・便 16bfddd7 の重大発見2)。
1569
+ # 配り役は便ごとの作業場所を git worktree で作るので、リポでない現場では便が実際の仕事をできない。
1570
+ # =リポでなければ ✗ にする(設置を「成功」と言わない)。★確かめるだけ。clone はしない。
1571
+ # ★案内に山かっこの穴埋め(リポの住所)を出さない(便 93200a64)。住所は管制にも台本にも無いので、
1572
+ # 住所を出す作りは管制の現場の登録の後の別便。それまでは「管理者に聞く」を案内する。
1573
+ if [[ -e "$PROJECT_DIR/.git" ]] && git -C "$PROJECT_DIR" rev-parse --git-dir >/dev/null 2>&1; then
1574
+ mark ok "現場のフォルダ(${PROJECT_DIR})が git のリポになっている" ""
1575
+ else
1576
+ mark ng "現場のフォルダ(${PROJECT_DIR})が git のリポになっている" \
1577
+ "リポの住所は管理者に聞いて、git clone で現場のフォルダ(${PROJECT_DIR})に入れてください。入れたら conductor setup ${SITE} をもう一度打ってください"
1578
+ fi
1579
+ # ★管制の MCP(ai-kana)がつながっているか・古い名前(devlog)の登録が残っているか(便 1aec413a)。
1580
+ # 便の完了の知らせ(conductor_complete)はこの口を使う。見方は update-guard.sh ⓪-b と同じ
1581
+ # (`claude mcp list` の行を読む・待つ上限も同じ 60 秒)。★鍵・トークンの値は読まない・出さない。
1582
+ # ★古い名前の登録は、見せるだけで消さない・書き換えない(✗ に数えない)。
1583
+ MCP_OUT=''
1584
+ if [[ -n "$PREFLIGHT_CLAUDE_BIN" ]]; then
1585
+ if command -v timeout >/dev/null 2>&1; then
1586
+ MCP_OUT="$(timeout 60 "$PREFLIGHT_CLAUDE_BIN" mcp list 2>/dev/null || true)"
1587
+ else
1588
+ MCP_OUT="$("$PREFLIGHT_CLAUDE_BIN" mcp list 2>/dev/null || true)"
1589
+ fi
1590
+ fi
1591
+ # ★pipefail の下で `printf | grep -q` は読み残しの SIGPIPE で「無い」に化けうるので、ここへ渡す形で読む。
1592
+ if grep -Eq '^(claude\.ai )?ai-kana: .*Connected' <<<"$MCP_OUT"; then
1593
+ mark ok "管制の MCP(ai-kana)がつながっている" ""
1594
+ else
1595
+ mark ng "管制の MCP(ai-kana)がつながっている" \
1596
+ "https://claude.ai の設定 → コネクタ で ai-kana を有効にしてください(または claude と打ち、画面の中で /mcp → ai-kana → Authenticate)"
1597
+ fi
1598
+ if [[ -z "$MCP_OUT" ]]; then
1599
+ echo " ⚠ 古い名前(devlog)の MCP の登録が残っているかを確かめられませんでした(止めません)"
1600
+ elif grep -Eq '^devlog: ' <<<"$MCP_OUT"; then
1601
+ echo " ⚠ 古い名前(devlog)の MCP の登録が残っている(止めません・この設置では消しません。整理は弊社が別に行います)"
1602
+ else
1603
+ mark ok "古い名前(devlog)の MCP の登録が残っていない" ""
1604
+ fi
1581
1605
  # ★部品置き場の鍵が常駐から見えるか(便 a940fa1a)。★止めない・✗ に数えない(使わない現場もあるため)。
1582
1606
  # 見るのは「鍵の置き場が在って中身がある」と「常駐の定義がそこを読む」の2つ。値は読み出さない。
1583
1607
  if [[ "$OS_KIND" != "mac" ]]; then
@@ -1632,6 +1656,12 @@ fi
1632
1656
 
1633
1657
  step "⑧ 完了! 職人(Claude Code)の起動方法"
1634
1658
 
1659
+ # ★Supabase の参照番号は聞かずに外した(便 1aec413a)。あとで使うときの足し方を1行で出す。
1660
+ SUPABASE_GUIDE=''
1661
+ if [[ "${SUPABASE_ADD_LATER:-0}" == "1" ]]; then
1662
+ SUPABASE_GUIDE=" Supabase を使うとき: ${SETTINGS_DST} の \"deniedDomains\" に \"db.<参照番号>.supabase.co\" を1行足す(分からなければ弊社へ)"
1663
+ fi
1664
+
1635
1665
  if [[ "${CONDUCTOR_RUNNER_MODE:-}" == "headless" ]]; then
1636
1666
  # ★画面なし方式(install.sh から呼ばれた場合)。tmux の3行は出さない。
1637
1667
  cat <<GUIDE
@@ -1661,6 +1691,7 @@ if [[ "${CONDUCTOR_RUNNER_MODE:-}" == "headless" ]]; then
1661
1691
  入れ直す: ${SVC_RESTART_CMD}
1662
1692
  止める: ${SVC_STOP_CMD}
1663
1693
  合言葉を入れ直す: rm ~/.conductor.env → そのあと setup.sh をもう一度実行
1694
+ ${SUPABASE_GUIDE}
1664
1695
 
1665
1696
  ──────────────────────────────────────────────────────────
1666
1697
  職人の画面を手で開きたいとき(見るだけ・補助)
@@ -1709,6 +1740,7 @@ else
1709
1740
  入れ直す: ${SVC_RESTART_CMD}
1710
1741
  止める: ${SVC_STOP_CMD}
1711
1742
  合言葉を入れ直す: rm ~/.conductor.env → そのあと setup.sh をもう一度実行
1743
+ ${SUPABASE_GUIDE}
1712
1744
 
1713
1745
  GUIDE
1714
1746
  fi
@@ -11,7 +11,8 @@
11
11
  # 常駐の定義 conductor@.service の EnvironmentFile=-%h/.config/conductor/npm-token.env がここを読む。
12
12
  #
13
13
  # 【決め】
14
- # ★人が既に持っている鍵(~/.npmrc の npm.pkg.github.com の _authToken の値)を写すだけ。
14
+ # ★人が既に持っている鍵(~/.npmrc の npm.pkg.github.com の _authToken の値。そこに値が無ければ
15
+ # ~/.bashrc の `export NPM_TOKEN=<値>`・便 1aec413a)を写すだけ。
15
16
  # 新しい鍵は作らない・聞かない。値は画面・記録に1文字も出さない(umask 077 のもとで書き 600)。
16
17
  # ★既に置いてあれば上書きしない(今ある鍵を勝手に替えない=何度流しても同じ)。権限だけ 600 にそろえる。
17
18
  # ★鍵が無い・参照の形しか無い PC では何も置かない(止めない・呼び出し側が知らせる)。
@@ -47,6 +48,33 @@ pkg_key_from_npmrc() {
47
48
  printf '%s' "$v"
48
49
  }
49
50
 
51
+ # ~/.bashrc の `export NPM_TOKEN=<値>` の値(★~/.npmrc に値が無いときだけ使う・便 1aec413a)。無ければ空。
52
+ # 【なぜ要るか(便 16bfddd7 の不具合8)】鍵を ~/.bashrc の export にだけ置いている PC では、
53
+ # 人の画面では部品が取れるのに、常駐(~/.bashrc を読まない)からは見えず 401 になっていた。
54
+ # ★読むのは「export NPM_TOKEN=」で始まる行の右側だけ(最後の行が勝つ=bash が読むのと同じ)。
55
+ # 引用符は外す。ドル記号・逆引用符を含む物(別の値の参照や命令)は値ではないので写さない。
56
+ pkg_key_from_bashrc() {
57
+ local f="$HOME/.bashrc" line v=''
58
+ [[ -f "$f" ]] || return 0
59
+ while IFS= read -r line || [[ -n "$line" ]]; do
60
+ line="${line%$'\r'}"
61
+ if [[ "$line" =~ ^[[:space:]]*export[[:space:]]+NPM_TOKEN=(.*)$ ]]; then
62
+ v="${BASH_REMATCH[1]}"
63
+ fi
64
+ done < "$f"
65
+ v="${v%"${v##*[![:space:]]}"}"
66
+ if [[ "$v" == \"*\" && ${#v} -ge 2 ]]; then
67
+ v="${v#\"}"; v="${v%\"}"
68
+ elif [[ "$v" == \'*\' && ${#v} -ge 2 ]]; then
69
+ v="${v#\'}"; v="${v%\'}"
70
+ else
71
+ # 引用符の無い値は、空白の手前まで(後ろの注釈などは含めない)。
72
+ v="${v%%[[:space:]]*}"
73
+ fi
74
+ [[ "$v" == *'$'* || "$v" == *'`'* ]] && v=''
75
+ printf '%s' "$v"
76
+ }
77
+
50
78
  if [[ -f "$PKG_KEY_FILE" ]]; then
51
79
  chmod 600 "$PKG_KEY_FILE" 2>/dev/null || true
52
80
  echo "[npm-token] kept: 部品置き場の鍵: 既に置いてあります → そのまま(上書きしません)"
@@ -55,7 +83,10 @@ fi
55
83
 
56
84
  pkg_val="$(pkg_key_from_npmrc)"
57
85
  if [[ -z "$pkg_val" ]]; then
58
- echo "[npm-token] absent: 部品置き場の鍵が ~/.npmrc に見当たらないため、何も置きません"
86
+ pkg_val="$(pkg_key_from_bashrc)"
87
+ fi
88
+ if [[ -z "$pkg_val" ]]; then
89
+ echo "[npm-token] absent: 部品置き場の鍵が ~/.npmrc にも ~/.bashrc の export にも見当たらないため、何も置きません"
59
90
  exit 0
60
91
  fi
61
92
 
@@ -25,7 +25,8 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
25
25
  - 枝は `git switch -c <作業ブランチ名> --no-track origin/main` で切る。**新しい worktree は作らない**(下の「切り替えられないとき」の形は要らない)。
26
26
  - 部品(`node_modules` 等)は作業場所に無いので、「手元で流す検査」⑤の命令で入れる(置き場は `/tmp/claude-1000` の下)。
27
27
  - 守りの設定(`.claude/settings.local.json` など)は配り役が作業場所へ写してある=**触らない・記録に入れない**(`git status` に `?? .claude/` と出ても、はじめから在る物として扱う)。
28
- - 便が終わると配り役が作業場所を片付ける。**記録していない変更・送っていない記録が残っていれば消さずに残す**ので、終える前に push まで済ませる(鉄則7)。
28
+ - 便が終わると配り役が作業場所を片付ける。**記録していない変更・どの枝にも無い記録が残っていれば消さずに残す**ので、終える前に push まで済ませる(鉄則7)。★枝の上の記録は作業場所を片付けても枝に残る(配り役は枝を消さない)。止めた便でも同じ決まりで片付くので、次の便が同じ枝へ移れる(便 954faaea)。
29
+ - ★職人の囲いは作業場所の `.claude/settings.json` を書けないので、`git switch` で古い枝へ移ると `unable to unlink old '.claude/settings.json'` と出て、そのファイルだけ前の版のまま `M` に見える(実地 便 3e5659c1)。**職人の変更ではないので触らない・記録に入れない**(配り役が片付けの前に記録の版へ戻す)。
29
30
  - ★便の本文に `【作業場所】` の段が無い便(tmux 方式・リポでない現場・この PC で切っている等)は、今までどおりこの項の残りのとおり。
30
31
  - ★**手元の作業場所で枝を切り替えられないとき**(はじめから在る変更が切り替えとぶつかる等)は、`git worktree add -b <作業ブランチ名> --no-track /tmp/claude-1000/<便IDを入れた名前> origin/main` で**別の作業場所**を作り、以後はそこで作業する(cd はその作業場所へ1回だけ=鉄則2)。★cd は起動した場所へ戻されることがある(`Shell cwd was reset`=実地 便 e0796fcd)ので、以後の命令は絶対パス・`git -C <作業場所>`・`npm --prefix <作業場所>` で場所を名指しして打つ(「途中で止まらない書き方」の (2))。終わったら `git worktree remove /tmp/claude-1000/<便IDを入れた名前>` で片付ける。★はじめから在る変更を退避(stash)・強制(`-f`・`--force`)・上書きして切り替えない(実地 便 934fca62 → dd5fe11a)。★これは便の作業場所の話で、空振り確認には worktree を使わない(鉄則13)。
31
32
  - ★**リポ全体の差分が「読めないファイル」で落ちたとき**(`unsupported file type` / `cannot hash <名前>` が出る/`.npmrc` のような設定が身に覚えなく `M` で出る)。**これは壊れていない。**