@tyhld/conductor 0.3.0 → 0.7.0

package/sales-template/install.sh

@@ -0,0 +1,890 @@
+#!/usr/bin/env bash
+#
+# install.sh — 采配くんを「1行」で入れる入口。
+#
+# お客さまが打つのはこの1行だけ:
+#   curl -fsSL https://ai-kana.ty-hld.com/setup | bash -s <現場名>
+#
+# 【この台本の役目】
+#   setup.sh（既存の設置係）は「道具がそろっている機体」に采配くんを置くための台本で、
+#   道具が無ければ前提チェックで止まる。お客さまはそこで何をすればいいか分からない。
+#   ＝この install.sh は【setup.sh の手前】を受け持つ。道具をそろえ、鍵を用意し、
+#     最後に setup.sh（`conductor setup`）を呼ぶ。★setup.sh 本体は1行も変えない。
+#
+# 【3つの決め（ここを外すと1行では動かない）】
+#   ① 冪等 — 済んでいる段は「✓ 済み」と出して飛ばす。何度打っても壊れない。
+#   ② 対話は /dev/tty から読む — `curl … | bash` では標準入力が【台本そのもの】に
+#      取られているので `read` は入力を求めずに空を返す（実測 2026-09-03）。
+#      端末そのもの（/dev/tty）から読めば、パイプの中からでも入力を求められる。
+#   ③ 止まる段は日本語で案内して止まる — ブラウザのやり取りが要るもの
+#      （Claude Code のログイン・GitHub のログイン）と、再起動が要るもの
+#      （WSL の systemd 有効化）は人の手番。「何をして、終わったらこの1行をもう一度」
+#      と書いて exit 1 する。次に打つと済み判定で飛ぶので、続きから進む。
+#
+# 【sudo について】
+#   sudo はパスワードを標準入力ではなく【端末】から読む（man sudo: "read it from the
+#   user's terminal"／`-S` は逆に標準入力から読ませる旗）。だからパイプの中でも聞ける。
+#   ★ただし「使う予定が無いのに聞く」ことはしない。先に足りない物を数え、
+#     本当に sudo が要るときだけ最初に1回 `sudo -v` でまとめて通してもらう。
+#
+# 【確認だけしたいとき（サポート・検証用）】
+#   CONDUCTOR_INSTALL_DRY_RUN=1 bash install.sh <現場名>
+#   … 各段の「済んだか」だけを出して、何も入れない・何も変えない・何も聞かない。
+#     update-guard.sh / pw-browser-install.sh と同じ「まず確認」の作法に合わせてある。
+#
+# 【入力元を差し替えたいとき（検査用）】
+#   CONDUCTOR_INSTALL_TTY=<ファイル> bash install.sh <現場名>
+#   … 対話の入力を、本物の端末ではなくそのファイルから読む。既定は /dev/tty。
+#     ★検査が本物の端末を掴んで入力待ちで止まらないようにするための口。
+#     お客さまの実行では指定しない＝今までどおり端末から聞く。
+#
+# 【秘密の扱い】
+#   合言葉は画面に出さない（伏せ字入力）。コマンド引数にも環境変数にも載せない
+#   （引数はプロセス一覧から、環境変数は /proc から他人に見えることがある）。
+#   ファイルへは umask 077 のもとで書き、書いたあと 600 を明示する。
+#
+set -euo pipefail
+
+# ═════════════════════════════════════════════════════════════════════════════
+# 設定（環境変数で差し替えられる。ふつうは触らない）
+# ═════════════════════════════════════════════════════════════════════════════
+
+# 管制（ai-kana）の既定アドレス。⑪の入力で Enter を押すとこれが使われる。
+DEFAULT_CONSOLE_URL="${CONDUCTOR_DEFAULT_URL:-https://ai-kana.ty-hld.com}"
+
+# 入れる Node の版。人と職人（Claude Code）が使う側。
+NODE_MAJOR_WANTED=24
+
+# 采配くん本体の最低版（★この値は sales-template/setup.sh と同じにすること）。
+# 【なぜ要るか（実測 2026-09-04）】公開 npm には 0.3.0 しか出ておらず、お客さまは
+#   それを掴んでいた。0.3.0 の中身は古い鍵名 CONDUCTOR_SHARED_SECRET を読むので、
+#   いまの接続情報（CONDUCTOR_TOKEN）では「未設定です」で落ちる（migakia で再現）。
+# ★食い違うと「入口は通したのに設置係が止める」が起きる。テストで同一を固定してある。
+MIN_CONDUCTOR_VERSION="0.5.0"
+
+# nvm の版は固定する（毎回ちがう版が降ってくると再現しない）。
+NVM_VERSION='v0.40.1'
+
+# apt で入れる道具。★足りないものだけを入れる。
+APT_PACKAGES=(
+  build-essential   # ネイティブ拡張のビルド（node-gyp 等）
+  git               # 版管理。職人の作業の土台
+  gh                # GitHub CLI。職人が PR を作るのに使う
+  tmux              # 職人の作業部屋。指示はこの中へ届く
+  jq                # JSON の読み取り
+  unzip             # 配布物の展開
+  curl              # 取得
+  ca-certificates   # https の検証
+  python3           # 番人（フック）が動くのに要る
+  python3-pip
+  python3-venv
+  rsync
+)
+
+# 確認だけモード（何も入れない・何も聞かない）。
+DRY_RUN=0
+if [[ "${CONDUCTOR_INSTALL_DRY_RUN:-}" == "1" ]]; then
+  DRY_RUN=1
+fi
+
+# ═════════════════════════════════════════════════════════════════════════════
+# 画面への出し方（お客さまが読む。専門用語を並べない）
+# ═════════════════════════════════════════════════════════════════════════════
+
+BAR='──────────────────────────────────────────────────────────────'
+
+say()   { printf '%s\n' "$*"; }
+step()  { printf '\n%s\n%s\n%s\n' "$BAR" "$1" "$BAR"; }
+skip()  { printf '  ✓ 済み   %s\n' "$1"; }
+doing() { printf '  → いま  %s\n' "$1"; }
+plan()  { printf '  ・予定   %s\n' "$1"; }
+note()  { printf '  %s\n' "$1"; }
+
+# 最後にまとめて出すための記録（★何を飛ばして何をやったかが分かるように）。
+SUMMARY=()
+record() { SUMMARY+=("$1"); }
+
+# 直せないので止まる（お客さまの手番）。★必ず「何をして、次にどうするか」を書く。
+halt() {
+  printf '\n%s\n' "$BAR" >&2
+  printf 'ここでいったん止まります（あと1つ、お手数をおかけします）\n' >&2
+  printf '%s\n\n' "$BAR" >&2
+  printf '%s\n' "$1" >&2
+  printf '\n%s\n' "$BAR" >&2
+  printf 'この作業が終わったら、さきほどの1行をもう一度そのまま打ってください。\n' >&2
+  printf '済んだところは飛ばして、続きから進みます。\n' >&2
+  printf '%s\n' "$BAR" >&2
+  exit 1
+}
+
+# 想定していない壊れ方（お客さまには直せないので、そのまま送ってもらう）。
+die() {
+  printf '\n[install] うまくいきませんでした: %s\n' "$1" >&2
+  printf '[install] この画面をそのままサポートへお送りください。\n' >&2
+  exit 1
+}
+
+# ═════════════════════════════════════════════════════════════════════════════
+# 端末（/dev/tty）からの入力
+#
+# ★`curl … | bash` では標準入力が台本に取られているので、`read` は入力を求めずに
+#   空を返す（実測 2026-09-03）。入力は必ず端末そのものから読む。
+# ★端末が無い場所（自動実行・CI・パイプだけの実行）では、空のまま進めるより
+#   「端末が要る」と日本語で止まるほうが安全。空の値で鍵ファイルを作ってしまうと、
+#   あとで「指示が届かない」だけが起きて原因が分からなくなる。
+#
+# 【入力元の差し替え口（CONDUCTOR_INSTALL_TTY）】
+#   既定は /dev/tty＝お客さまの実行では今までどおり本物の端末から読む。
+#   ★検査のときだけ、ここを【ふつうのファイル】に向ける。
+#   なぜ要るか（実機 2026-09-04）: 検査が本物の /dev/tty を掴んでいたため、
+#   端末のある機体で `npm test` を流すと「① 管制のアドレス…」で入力待ちになって
+#   止まった（CI は端末が無いので気づけなかった＝すり抜けた）。
+#   ★入力元を差し替えられるようにするだけ。段・判定・止まり方は1つも変えない。
+#
+# 【聞く文は標準エラーへ出す】
+#   以前は /dev/tty へ直接書いていたが、入力元を差し替えるとそこが読み取り用の
+#   ファイルになる（同じファイルへ書くと入力を壊す）。聞く文は標準エラーへ出す。
+#   `curl … | bash` でも sudo のパスワード入力と同じくちゃんと画面に見える。
+# >>> tty-io >>>   ★この印の間はテストが切り出して単体で流す。動かすときは消さない。
+# ═════════════════════════════════════════════════════════════════════════════
+
+# 入力元。既定は本物の端末。検査だけがここを差し替える。
+INSTALL_TTY="${CONDUCTOR_INSTALL_TTY:-/dev/tty}"
+
+# 入力元を開いて読み取り用の 3 番につなぐ。開けなければ日本語で止まる。
+tty_open() {
+  if [[ "${TTY_READY:-0}" == "1" ]]; then
+    return 0
+  fi
+  if ! exec 3<"$INSTALL_TTY" 2>/dev/null; then
+    printf '\n[install] ここから先は、お客さまに入力していただく必要があります。\n' >&2
+    printf '[install] ★いまの実行には「入力できる画面（端末）」がありません。\n' >&2
+    printf '[install]   自動実行や、画面のない環境からは進められません。\n' >&2
+    printf '[install]   Ubuntu（WSL）の画面をご自分で開いて、そこで1行を打ち直してください。\n' >&2
+    exit 1
+  fi
+  TTY_READY=1
+}
+
+# 端末へ聞く。 ask_tty <入れる変数名> <聞く文> [既定値]
+ask_tty() {
+  local var="$1" prompt="$2" default="${3:-}" answer=''
+  tty_open
+  if [[ -n "$default" ]]; then
+    printf '%s\n' "$prompt" >&2
+    printf '    （そのままで良ければ Enter → %s）: ' "$default" >&2
+  else
+    printf '%s\n' "$prompt" >&2
+    printf '    : ' >&2
+  fi
+  IFS= read -r -u 3 answer || answer=''
+  if [[ -z "$answer" ]]; then
+    answer="$default"
+  fi
+  printf -v "$var" '%s' "$answer"
+}
+
+# 端末へ聞く（画面に出さない）。 ask_tty_secret <入れる変数名> <聞く文>
+ask_tty_secret() {
+  local var="$1" prompt="$2" answer=''
+  tty_open
+  printf '%s\n' "$prompt" >&2
+  printf '    （入力しても画面には出ません）: ' >&2
+  IFS= read -r -s -u 3 answer || answer=''
+  printf '\n' >&2
+  printf -v "$var" '%s' "$answer"
+}
+# <<< tty-io <<<
+
+# ═════════════════════════════════════════════════════════════════════════════
+# 済んだかを見る道具（★readlink -f は使わない）
+#
+# readlink -f は【存在しないパスでも】正規化した文字列を返すので、「在るか」の
+# 判定には使えない（実測 2026-09-03: 無い /usr/local/bin/node に対して
+# readlink -f は /usr/local/bin/node を返した）。在るかは -e / -f / -L で見る。
+# ═════════════════════════════════════════════════════════════════════════════
+
+have()     { command -v "$1" >/dev/null 2>&1; }
+path_here() { [[ -e "$1" || -L "$1" ]]; }
+
+# version_lt <a> <b> — a が b より古いか。
+# ★`sort -V` に頼らない（Mac の sort には無い版がある）。数字3つだけを見る。
+#   読めない字は 0 とみなす（安全側＝古い扱いで、更新へ倒す）。
+version_lt() {
+  local a="${1%%-*}" b="${2%%-*}" i x y
+  local -a A B
+  IFS='.' read -r -a A <<< "$a"
+  IFS='.' read -r -a B <<< "$b"
+  for i in 0 1 2; do
+    x="${A[i]:-0}"; y="${B[i]:-0}"
+    [[ "$x" =~ ^[0-9]+$ ]] || x=0
+    [[ "$y" =~ ^[0-9]+$ ]] || y=0
+    if (( x < y )); then return 0; fi
+    if (( x > y )); then return 1; fi
+  done
+  return 1
+}
+
+# いま入っている采配くん本体の版（取れなければ空）。
+conductor_version() {
+  local v
+  v="$(conductor --version 2>/dev/null | tr -d '[:space:]')"
+  if [[ "$v" =~ ^[0-9]+\.[0-9]+\.[0-9]+ ]]; then
+    printf '%s' "${BASH_REMATCH[0]}"
+  fi
+}
+
+# apt の道具が「もう使える」か。
+#
+# ★名前が入っているかだけでは足りない。python3-venv は【まとめ役の名前】で、実体は
+#   python3.12-venv のように版付きの名前で入る。名前だけ見ると、実際には使えている
+#   機体で「足りない」と判定し、要らない導入（と要らないパスワード入力）が走る
+#   （実機 2026-09-04: python3.12-venv が入っているのに python3-venv は未登録だった）。
+#   ＝名前で見つからないものは【できるかどうか】で見る。
+apt_has() {
+  if dpkg -s "$1" >/dev/null 2>&1; then
+    return 0
+  fi
+  case "$1" in
+    python3-venv)
+      # venv が実際に使えるかを見る。使えない機体では ensurepip が入っていない。
+      python3 -c 'import ensurepip' >/dev/null 2>&1
+      ;;
+    *)
+      return 1
+      ;;
+  esac
+}
+
+# node のメジャー版（取れなければ 0）。
+node_major() {
+  local v
+  v="$(node --version 2>/dev/null || true)"
+  v="${v#v}"
+  v="${v%%.*}"
+  if [[ "$v" =~ ^[0-9]+$ ]]; then
+    printf '%s' "$v"
+  else
+    printf '0'
+  fi
+}
+
+# Claude Code にログイン済みか。★`claude auth status --json` の loggedIn を見る。
+claude_logged_in() {
+  local out
+  out="$(claude auth status --json 2>/dev/null || true)"
+  [[ "$out" == *'"loggedIn"'* ]] || return 1
+  printf '%s' "$out" | tr -d ' ' | grep -q '"loggedIn":true'
+}
+
+# 実行するか、確認だけか。 run <説明> <コマンド…>
+run() {
+  local what="$1"
+  shift
+  if [[ "$DRY_RUN" == "1" ]]; then
+    plan "$what"
+    return 0
+  fi
+  doing "$what"
+  "$@"
+}
+
+# ═════════════════════════════════════════════════════════════════════════════
+# ⓪ 引数と土台の確認
+# ═════════════════════════════════════════════════════════════════════════════
+
+step '⓪ はじめの確認'
+
+SITE="${1:-}"
+
+if [[ -z "$SITE" ]]; then
+  cat >&2 <<'USAGE'
+
+采配くんの設置
+
+お仕事の名前（現場名）が要ります。次のように、うしろに名前を付けて打ってください。
+
+  curl -fsSL https://ai-kana.ty-hld.com/setup | bash -s my-app
+                                                        ~~~~~~
+                                                        ここがお仕事の名前
+
+名前の決まり:
+  ・半角の小文字・数字・ハイフン（-）だけ。例: my-app / shop2 / kenzokun
+  ・作業用のフォルダ名としてそのまま使います（~/projects/<名前>）
+  ・分からないときは、弊社からお渡しした案内に書いてある名前をお使いください
+USAGE
+  exit 1
+fi
+
+if [[ ! "$SITE" =~ ^[a-z0-9][a-z0-9-]*$ ]]; then
+  cat >&2 <<USAGE
+
+お仕事の名前に使えない文字が入っています: 「${SITE}」
+
+  ・使えるのは 半角の小文字・数字・ハイフン（-）だけです
+  ・先頭はアルファベット小文字か数字にしてください
+  ・例: my-app / shop2 / kenzokun
+
+もう一度、名前を直して打ってください。
+USAGE
+  exit 1
+fi
+
+say "  お仕事の名前: ${SITE}"
+PROJECT_DIR="$HOME/projects/$SITE"
+say "  作業フォルダ: ${PROJECT_DIR}"
+if [[ "$DRY_RUN" == "1" ]]; then
+  say '  ★確認だけのモードです（何も入れません・何も聞きません）'
+fi
+
+# --- OS の見分け -------------------------------------------------------------
+# この入口が面倒を見るのは Windows（WSL2 + Ubuntu）です。Mac は道具の入れ方が
+# まるごと違う（apt が無い・常駐が launchd）ので、この1行では扱わない。
+# ★Mac も setup.sh 自体は対応済み（ADR-019）なので、そちらへ案内する。
+case "$(uname -s)" in
+  Linux) : ;;
+  Darwin)
+    halt "$(cat <<'MSG'
+Mac をお使いのようです。この1行の入口は Windows（WSL2 + Ubuntu）用です。
+
+Mac では、次の2行で設置してください。
+
+  npm i -g @tyhld/conductor
+  conductor setup <お仕事の名前>
+
+（先に Homebrew で tmux を、npm で Claude Code を入れてログインしておいてください）
+MSG
+)"
+    ;;
+  *)
+    halt "この入口は Windows（WSL2 + Ubuntu）用です。ご利用の環境には対応していません。"
+    ;;
+esac
+
+# --- WSL のときは systemd（常駐の仕組み）が要る -------------------------------
+# 【なぜ止めるか】systemd が無いと、采配くんの常駐（指示を受け取り続ける係）を
+#   登録できない。ここを飛ばして先へ進めると、設置は成功したように見えて
+#   指示が1つも届かない。★お客さまが後日いちばん困る形なので、必ずここで止める。
+IS_WSL=0
+if [[ -r /proc/version ]] && grep -qi microsoft /proc/version; then
+  IS_WSL=1
+fi
+
+WSL_GUIDE=$(cat <<'MSG'
+采配くんが動き続けるための仕組み（systemd）が、まだ有効になっていません。
+次の2つを、この順に行ってください。
+
+  【1】いまのこの画面（Ubuntu）で、次の1行をそのまま打ちます
+       （管理者のパスワードを聞かれたら、Windows にログインするときのものではなく
+         Ubuntu を最初に開いたときに決めたパスワードです）
+
+    sudo sh -c 'printf "[boot]\nsystemd=true\n" >> /etc/wsl.conf'
+
+  【2】Windows のスタートメニューから「PowerShell」または「コマンド プロンプト」を
+       開いて、次の1行を打ちます（Ubuntu がいったん閉じます）
+
+    wsl --shutdown
+
+  そのあと、もう一度 Ubuntu を開いてください。
+MSG
+)
+
+if [[ "$IS_WSL" == "1" ]]; then
+  if [[ -r /etc/wsl.conf ]] && grep -Eq '^[[:space:]]*systemd[[:space:]]*=[[:space:]]*true' /etc/wsl.conf; then
+    skip 'Windows 側の設定（systemd）'
+  else
+    halt "$WSL_GUIDE"
+  fi
+fi
+
+if ! have systemctl; then
+  halt "$WSL_GUIDE"
+fi
+if systemctl --user show-environment >/dev/null 2>&1; then
+  skip '常駐の仕組みが動いている'
+else
+  halt "$WSL_GUIDE"
+fi
+
+# ═════════════════════════════════════════════════════════════════════════════
+# ① 管理者の許可（sudo）を、必要なときだけ最初に1回
+#
+# ★使う予定が無いのに聞かない。先に「足りないもの」を数えて、
+#   本当に管理者の許可が要るときだけまとめて通してもらう。
+#   （そうしないと、全部済んでいる機体でも毎回パスワードを聞かれる）
+# ═════════════════════════════════════════════════════════════════════════════
+
+step '① 管理者の許可'
+
+APT_MISSING=()
+for p in "${APT_PACKAGES[@]}"; do
+  if ! apt_has "$p"; then
+    APT_MISSING+=("$p")
+  fi
+done
+
+NEED_SYSTEM_NODE=0
+path_here /usr/bin/node || NEED_SYSTEM_NODE=1
+
+# setup.sh ③ が /usr/local/bin/node のリンクを作るときにも管理者の許可が要る。
+NEED_NODE_LINK=0
+path_here /usr/local/bin/node || NEED_NODE_LINK=1
+
+NEED_SUDO=0
+if [[ ${#APT_MISSING[@]} -gt 0 || "$NEED_SYSTEM_NODE" == "1" || "$NEED_NODE_LINK" == "1" ]]; then
+  NEED_SUDO=1
+fi
+
+if [[ "$NEED_SUDO" == "0" ]]; then
+  skip '管理者の許可は要りません（足りないものがありません）'
+  record '管理者の許可: 不要'
+elif [[ "$DRY_RUN" == "1" ]]; then
+  plan '管理者の許可をまとめて1回もらいます（sudo -v）'
+else
+  if ! have sudo; then
+    halt 'このパソコンには sudo（管理者の許可を使う仕組み）がありません。サポートへご連絡ください。'
+  fi
+  if sudo -n -v >/dev/null 2>&1; then
+    skip '管理者の許可は既に通っています'
+    record '管理者の許可: 既に通っていた'
+  else
+    say '  これから、パソコンに道具を入れるために【管理者の許可】を何度か使います。'
+    say '  いちばん最初に1回だけパスワードをお聞きします（以後は聞きません）。'
+    say '  ★Ubuntu を最初に開いたときに決めたパスワードです。'
+    tty_open
+    if ! sudo -v; then
+      halt 'パスワードが通りませんでした。もう一度、同じ1行を打ってやり直してください。'
+    fi
+    record '管理者の許可: 通した'
+  fi
+fi
+
+# ═════════════════════════════════════════════════════════════════════════════
+# ② 道具をそろえる（足りないものだけ）
+# ═════════════════════════════════════════════════════════════════════════════
+
+step '② 道具をそろえる'
+
+if [[ ${#APT_MISSING[@]} -eq 0 ]]; then
+  skip "道具はそろっています（${#APT_PACKAGES[@]} 個）"
+  record '道具: 済み'
+else
+  say "  足りないもの: ${APT_MISSING[*]}"
+  if [[ "$DRY_RUN" == "1" ]]; then
+    plan "足りない ${#APT_MISSING[@]} 個を入れます"
+  else
+    run '一覧を最新にします' sudo apt-get update -qq \
+      || die 'ソフトの一覧を取れませんでした（インターネット接続をご確認ください）'
+    run "${#APT_MISSING[@]} 個の道具を入れます" \
+      sudo apt-get install -y "${APT_MISSING[@]}" \
+      || die '道具を入れられませんでした'
+    record "道具: ${#APT_MISSING[@]} 個を入れた"
+  fi
+fi
+
+# ═════════════════════════════════════════════════════════════════════════════
+# ③ Node（人と職人が使う側）
+#
+# ★nvm 経由で入れる。理由: apt の Node は版が古く、あとから上げにくい。
+#   nvm なら「このユーザーの中だけ」で版を切り替えられ、OS 側を壊さない。
+# ★入れたあと、同じ実行の中で使えるように nvm.sh を読み込んで続ける
+#   （新しい画面を開き直さなくて済むように）。
+# ═════════════════════════════════════════════════════════════════════════════
+
+step '③ Node を用意する（人と職人が使う分）'
+
+NVM_DIR_PATH="${NVM_DIR:-$HOME/.nvm}"
+
+if have node && [[ "$(node_major)" -ge "$NODE_MAJOR_WANTED" ]]; then
+  skip "Node は用意できています（$(node --version)）"
+  record "Node: 済み（$(node --version)）"
+elif [[ "$DRY_RUN" == "1" ]]; then
+  if [[ -s "$NVM_DIR_PATH/nvm.sh" ]]; then
+    plan "Node ${NODE_MAJOR_WANTED} を入れます（切り替えの仕組みは既にあります）"
+  else
+    plan "切り替えの仕組み（nvm ${NVM_VERSION}）と Node ${NODE_MAJOR_WANTED} を入れます"
+  fi
+else
+  if [[ ! -s "$NVM_DIR_PATH/nvm.sh" ]]; then
+    doing "Node を入れ替える仕組み（nvm ${NVM_VERSION}）を入れます"
+    curl -fsSL "https://raw.githubusercontent.com/nvm-sh/nvm/${NVM_VERSION}/install.sh" | bash \
+      || die 'nvm を入れられませんでした（インターネット接続をご確認ください）'
+  fi
+  # nvm.sh は自分で未設定の変数を触るので、読み込む間だけ -u を外す。
+  set +u
+  export NVM_DIR="$NVM_DIR_PATH"
+  # shellcheck disable=SC1091  # お客さまの機体で生成されるファイルなので静的には追えない
+  . "$NVM_DIR/nvm.sh"
+  set -u
+
+  doing "Node ${NODE_MAJOR_WANTED} を入れます"
+  nvm install "$NODE_MAJOR_WANTED" || die "Node ${NODE_MAJOR_WANTED} を入れられませんでした"
+  nvm alias default "$NODE_MAJOR_WANTED" >/dev/null \
+    || die 'Node の既定の版を決められませんでした'
+  nvm use default >/dev/null || die 'Node に切り替えられませんでした'
+  say "  用意できました: $(node --version)"
+  record "Node: 入れた（$(node --version)）"
+fi
+
+if [[ "$DRY_RUN" != "1" ]] && ! have npm; then
+  die 'npm が見つかりません（Node の導入が途中で終わっている可能性があります）'
+fi
+
+# ═════════════════════════════════════════════════════════════════════════════
+# ④ Node（常駐が使う側）
+#
+# 【なぜ2つ要るか】常駐（systemd）はログインしたときの PATH を引き継がないので、
+#   nvm の Node は見えない。決まった場所（/usr/bin/node）にも1本あることが要る。
+# ═════════════════════════════════════════════════════════════════════════════
+
+step '④ Node を用意する（常駐が使う分）'
+
+if [[ "$NEED_SYSTEM_NODE" == "0" ]]; then
+  skip '常駐用の Node は用意できています'
+  record '常駐用 Node: 済み'
+elif [[ "$DRY_RUN" == "1" ]]; then
+  plan '常駐用の Node を入れます（sudo apt install nodejs）'
+else
+  run '常駐用の Node を入れます' sudo apt-get install -y nodejs \
+    || die '常駐用の Node を入れられませんでした'
+  record '常駐用 Node: 入れた'
+fi
+
+# ═════════════════════════════════════════════════════════════════════════════
+# ⑤ pnpm を使えるようにする（corepack）
+#
+# ★pnpm 自体は入れない。corepack を有効にしておけば、リポジトリごとに指定された
+#   正しい版が自動で使われる（版ずれの事故を構造的に防ぐ・ADR-015）。
+# ═════════════════════════════════════════════════════════════════════════════
+
+step '⑤ pnpm を使えるようにする'
+
+if have pnpm; then
+  skip 'pnpm は使えます'
+  record 'pnpm: 済み'
+elif [[ "$DRY_RUN" == "1" ]]; then
+  plan 'corepack enable を実行します'
+elif have corepack; then
+  run 'pnpm を使えるようにします' corepack enable \
+    || die 'corepack enable に失敗しました'
+  record 'pnpm: 使えるようにした'
+else
+  # corepack は Node に同梱されているので、ここへ来るのは Node の導入が変な形のとき。
+  note '⚠ corepack が見つかりませんでした（pnpm を使う現場では、あとで設定が要ります）'
+  record 'pnpm: 見送り（corepack なし）'
+fi
+
+# ═════════════════════════════════════════════════════════════════════════════
+# ⑥ 職人（Claude Code）を入れる
+# ═════════════════════════════════════════════════════════════════════════════
+
+step '⑥ 職人（Claude Code）を入れる'
+
+if have claude; then
+  skip "職人は入っています（$(claude --version 2>/dev/null || echo OK)）"
+  record '職人: 済み'
+elif [[ "$DRY_RUN" == "1" ]]; then
+  plan '職人（Claude Code）を入れます'
+else
+  run '職人（Claude Code）を入れます' npm install -g @anthropic-ai/claude-code \
+    || die '職人を入れられませんでした（インターネット接続をご確認ください）'
+  have claude || die '職人を入れましたが呼び出せません（PATH の設定をご確認ください）'
+  record '職人: 入れた'
+fi
+
+# ═════════════════════════════════════════════════════════════════════════════
+# ⑦ 職人のログイン（★お客さまの手番・ここで止まることがある）
+# ═════════════════════════════════════════════════════════════════════════════
+
+step '⑦ 職人のログイン'
+
+CLAUDE_LOGIN_GUIDE=$(cat <<'MSG'
+職人（Claude Code）へのログインが、まだ済んでいません。
+ログインはブラウザで行うため、こちらからは代われません。次のようにしてください。
+
+  【1】この画面で、次の1行を打ちます
+
+    claude auth login
+
+  【2】画面に出てくる案内にしたがって、ブラウザでログインします
+       （ブラウザが自動で開かないときは、画面に出た住所をコピーして
+         ご自分でブラウザに貼ってください）
+
+  【3】「ログインしました」と出たら終わりです
+MSG
+)
+
+if [[ "$DRY_RUN" == "1" ]]; then
+  if have claude && claude_logged_in; then
+    skip '職人はログイン済みです'
+  else
+    plan 'ログインが済んでいないため、ここで案内して止まります'
+  fi
+elif claude_logged_in; then
+  skip '職人はログイン済みです'
+  record '職人のログイン: 済み'
+else
+  halt "$CLAUDE_LOGIN_GUIDE"
+fi
+
+# ═════════════════════════════════════════════════════════════════════════════
+# ⑧ GitHub のログイン（★お客さまの手番・ここで止まることがある）
+#
+# 【なぜ要るか】職人は作業のまとまりごとに GitHub 上で「変更のお知らせ（PR）」を
+#   作る。ログインしていないとそこで止まってしまう。
+# ═════════════════════════════════════════════════════════════════════════════
+
+step '⑧ GitHub のログイン'
+
+GH_LOGIN_GUIDE=$(cat <<'MSG'
+GitHub（プログラムの保管場所）へのログインが、まだ済んでいません。
+こちらもブラウザでのやり取りが要るため、代われません。次のようにしてください。
+
+  【1】この画面で、次の1行を打ちます
+
+    gh auth login
+
+  【2】聞かれたら、次のように選びます（矢印キーで選んで Enter）
+
+      Where do you use GitHub?          →  GitHub.com
+      What is your preferred protocol?  →  HTTPS
+      Authenticate Git with your ...?   →  Y（はい）
+      How would you like to authenticate?  →  Login with a web browser
+
+  【3】画面に8文字の合言葉が出ます。それをブラウザの画面に貼り付けます
+  【4】「Logged in as ...」と出たら終わりです
+MSG
+)
+
+gh_logged_in() { gh auth status >/dev/null 2>&1; }
+
+# git 側の受け渡し（credential helper）が既にそろっているか。
+gh_git_ready() {
+  git config --global --get-regexp '^credential\.https://github\.com\.helper$' >/dev/null 2>&1
+}
+
+if [[ "$DRY_RUN" == "1" ]]; then
+  if have gh && gh_logged_in; then
+    if gh_git_ready; then
+      skip 'GitHub はログイン済み・git の受け渡しもそろっています'
+    else
+      plan 'git の受け渡しをそろえます（gh auth setup-git）'
+    fi
+  else
+    plan 'ログインが済んでいないため、ここで案内して止まります'
+  fi
+elif ! have gh; then
+  die 'gh（GitHub の道具）が見つかりません（②で入るはずのものです）'
+elif ! gh_logged_in; then
+  halt "$GH_LOGIN_GUIDE"
+else
+  skip 'GitHub はログイン済みです'
+  if gh_git_ready; then
+    skip 'git の受け渡しもそろっています'
+    record 'GitHub: 済み'
+  else
+    run 'git の受け渡しをそろえます' gh auth setup-git \
+      || die 'git の受け渡しをそろえられませんでした'
+    record 'GitHub: 受け渡しをそろえた'
+  fi
+fi
+
+# ═════════════════════════════════════════════════════════════════════════════
+# ⑨ 采配くん本体を入れる
+# ═════════════════════════════════════════════════════════════════════════════
+
+step '⑨ 采配くん本体を入れる'
+
+# ★入っていても【古すぎないか】を見る。古ければ更新する（実測 2026-09-04）。
+#   公開 npm には 0.3.0 しか出ておらず、お客さまはそれを掴んでいた。0.3.0 は古い鍵名
+#   （CONDUCTOR_SHARED_SECRET）を読むので、いまの接続情報では「未設定です」で落ちる。
+#   ＝ここで気づかないと「設置は成功したのに指示が1つも届かない」で終わる。
+if [[ "$DRY_RUN" == "1" ]]; then
+  if have conductor; then
+    CONDUCTOR_VER="$(conductor_version)"
+    if [[ -n "$CONDUCTOR_VER" ]] && ! version_lt "$CONDUCTOR_VER" "$MIN_CONDUCTOR_VERSION"; then
+      skip "采配くん本体は入っています（${CONDUCTOR_VER} ≧ ${MIN_CONDUCTOR_VERSION}）"
+    else
+      plan "采配くん本体が古いので更新します（いま ${CONDUCTOR_VER:-不明} → ${MIN_CONDUCTOR_VERSION} 以上）"
+    fi
+  else
+    plan '采配くん本体を入れます（npm i -g @tyhld/conductor）'
+  fi
+elif have conductor && [[ -n "$(conductor_version)" ]] \
+     && ! version_lt "$(conductor_version)" "$MIN_CONDUCTOR_VERSION"; then
+  skip "采配くん本体は入っています（$(conductor_version) ≧ ${MIN_CONDUCTOR_VERSION}）"
+  record "采配くん本体: 済み（$(conductor_version)）"
+elif have conductor; then
+  say "  いま入っている版: $(conductor_version || echo '読み取れません')（${MIN_CONDUCTOR_VERSION} 以上が必要です）"
+  run '采配くん本体を新しくします' npm install -g @tyhld/conductor@latest \
+    || die '采配くん本体を新しくできませんでした（インターネット接続をご確認ください）'
+  CONDUCTOR_VER="$(conductor_version)"
+  if [[ -n "$CONDUCTOR_VER" ]] && version_lt "$CONDUCTOR_VER" "$MIN_CONDUCTOR_VERSION"; then
+    halt "$(cat <<MSG
+采配くん本体の版が古すぎます（いま ${CONDUCTOR_VER} ／ ${MIN_CONDUCTOR_VERSION} 以上が必要です）。
+新しくしようとしましたが、取ってこられませんでした。
+
+  ★古い版のままでは、設置できても指示が1つも届きません（鍵の名前が違うためです）。
+
+  次の1行をお試しください。
+
+    npm install -g @tyhld/conductor@latest
+
+  それでも直らないときは、この画面をそのままサポートへお送りください。
+MSG
+)"
+  fi
+  record "采配くん本体: 新しくした（${CONDUCTOR_VER:-不明}）"
+else
+  run '采配くん本体を入れます' npm install -g @tyhld/conductor \
+    || die '采配くん本体を入れられませんでした（インターネット接続をご確認ください）'
+  have conductor || die '采配くん本体を入れましたが呼び出せません（PATH の設定をご確認ください）'
+  record "采配くん本体: 入れた（$(conductor_version)）"
+fi
+
+# ═════════════════════════════════════════════════════════════════════════════
+# ⑩ 作業フォルダを作る
+#
+# ★setup.sh ① は「このフォルダが既に在ること」を前提にしていて、無ければ止まる。
+#   1行の入口では、ここで先に作っておく。
+# ═════════════════════════════════════════════════════════════════════════════
+
+step '⑩ 作業フォルダを用意する'
+
+if [[ -d "$PROJECT_DIR" ]]; then
+  skip "作業フォルダはあります（${PROJECT_DIR}）"
+  record '作業フォルダ: 済み'
+elif [[ "$DRY_RUN" == "1" ]]; then
+  plan "作業フォルダを作ります（${PROJECT_DIR}）"
+else
+  run "作業フォルダを作ります（${PROJECT_DIR}）" mkdir -p "$PROJECT_DIR" \
+    || die "作業フォルダを作れませんでした: ${PROJECT_DIR}"
+  record '作業フォルダ: 作った'
+fi
+
+# ═════════════════════════════════════════════════════════════════════════════
+# ⑪ 管制への接続情報（★合言葉は画面に出さない）
+#
+# ★ここで先に作っておくと、このあとの setup.sh ④ は「既にある→スキップ」になる。
+#   ＝setup.sh 本体を1行も変えずに、パイプの中でも入力できるようになる。
+# ═════════════════════════════════════════════════════════════════════════════
+
+step '⑪ 管制への接続情報'
+
+ENV_FILE="$HOME/.conductor.env"
+
+# ★入力の受け皿は先に空で用意する（set -u のもとで安全にし、静的検査にも見えるように）。
+CONSOLE_URL=''
+CONSOLE_TOKEN=''
+
+if [[ -f "$ENV_FILE" ]]; then
+  skip '接続情報はあります'
+  # 権限が緩んでいたら締める（常駐側も起動時に直すが、ここでも揃えておく）。
+  if [[ "$DRY_RUN" != "1" ]]; then
+    chmod 600 "$ENV_FILE" 2>/dev/null || true
+  fi
+  record '接続情報: 済み'
+  note '★入れ直したいときは rm ~/.conductor.env のあと、もう一度この1行を打ってください'
+elif [[ "$DRY_RUN" == "1" ]]; then
+  plan '管制のアドレスと合言葉をお聞きして、接続情報を作ります'
+else
+  say '  管制（采配くんの画面）につなぐための情報を2つお聞きします。'
+  say '  ★どちらも弊社からお渡しした案内に書いてあります。'
+  say ''
+
+  ask_tty CONSOLE_URL '  ① 管制のアドレス' "$DEFAULT_CONSOLE_URL"
+  [[ -n "$CONSOLE_URL" ]] || halt '管制のアドレスが空でした。もう一度この1行を打ってやり直してください。'
+  case "$CONSOLE_URL" in
+    https://*) : ;;
+    *) halt "管制のアドレスは https:// から始まります（入力: ${CONSOLE_URL}）。案内をご確認のうえ、もう一度この1行を打ってください。" ;;
+  esac
+
+  ask_tty_secret CONSOLE_TOKEN '  ② 合言葉'
+  if [[ -z "$CONSOLE_TOKEN" ]]; then
+    halt '合言葉が空でした。もう一度この1行を打ってやり直してください。'
+  fi
+  say "  受け取りました（${#CONSOLE_TOKEN} 文字）。画面には出していません。"
+
+  # ★作る瞬間から他人に読ませない。umask で作り、そのあと 600 を明示する。
+  #   合言葉はコマンド引数にも環境変数にも載せない（プロセス一覧・/proc から見えるため）。
+  ( umask 077; printf 'CONDUCTOR_URL=%s\nCONDUCTOR_TOKEN=%s\n' "$CONSOLE_URL" "$CONSOLE_TOKEN" > "$ENV_FILE" ) \
+    || die "接続情報を書けませんでした: ${ENV_FILE}"
+  chmod 600 "$ENV_FILE" || die "接続情報の権限を直せませんでした: ${ENV_FILE}"
+  unset CONSOLE_TOKEN
+  say '  接続情報を作りました（本人だけが読める形にしました）'
+  record '接続情報: 作った'
+fi
+
+# ═════════════════════════════════════════════════════════════════════════════
+# ⑫ 設置（既存の setup.sh を呼ぶ）
+#
+# ★ここから先は既存の設置係にそのまま任せる。番人の配置・常駐の登録・自己点検（⑦）
+#   ・次にやることの案内（⑧）は、すべて setup.sh が持っている。写しを作らない。
+# ═════════════════════════════════════════════════════════════════════════════
+
+step '⑫ 設置する'
+
+if [[ "$DRY_RUN" == "1" ]]; then
+  plan "conductor setup ${SITE} を実行します（番人の配置・常駐の登録・自己点検）"
+else
+  doing '采配くんを設置します（ここから先は設置係が引き継ぎます）'
+  say ''
+  conductor setup "$SITE" || die '設置に失敗しました（上に出ている内容をサポートへお送りください）'
+  record '設置: 実行した'
+fi
+
+# ═════════════════════════════════════════════════════════════════════════════
+# ⑬ 締め（★自己点検の○×は、すぐ上に設置係が出しています）
+# ═════════════════════════════════════════════════════════════════════════════
+
+step '⑬ ここまでのまとめ'
+
+# ★空の配列を "${arr[@]}" で展開すると、古い bash では set -u に叱られる。
+#   お客さまの機体の bash の版は選べないので、中身があるときだけ回す。
+if [[ ${#SUMMARY[@]} -gt 0 ]]; then
+  for line in "${SUMMARY[@]}"; do
+    note "・${line}"
+  done
+else
+  note '（何も変えていません）'
+fi
+
+if [[ "$DRY_RUN" == "1" ]]; then
+  say ''
+  say '★確認だけのモードで終わりました。実際に入れるときは、この行から'
+  say '  CONDUCTOR_INSTALL_DRY_RUN=1 を外して打ってください。'
+  exit 0
+fi
+
+cat <<GUIDE
+
+${BAR}
+★すぐ上に出ている「自己点検」の○×をご覧ください
+${BAR}
+
+  ぜんぶ ✓ になっていれば、設置は成功しています。
+  ✗ が残っているときは、その行に書いてある直し方をお試しください。
+
+${BAR}
+次にやること — 職人（Claude Code）を動かす
+${BAR}
+
+  下の3行を、そのままコピーして貼ってください。
+
+    tmux new-session -d -s "${SITE}" -c "${PROJECT_DIR}"
+    tmux send-keys -t "${SITE}" "unset ANTHROPIC_API_KEY && claude" C-m
+    tmux attach -t "${SITE}"
+
+  （1行目で作業部屋を用意し、2行目で職人を呼び、3行目でその画面を開きます）
+
+${BAR}
+いちばん確実な「動いています」の確かめ方
+${BAR}
+
+  管制の画面（采配くん）をブラウザで開いてください。
+  そこに「${SITE}」が出ていれば、つながって動いています。
+
+  出てこないときは、職人の画面を開いたまま1〜2分待って、開き直してください。
+  それでも出ないときは、この画面をそのままサポートへお送りください。
+
+GUIDE