@tyhld/conductor 0.12.84 → 0.12.86

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tyhld/conductor",
-  "version": "0.12.84",
+  "version": "0.12.86",
   "description": "采配くん管制の見守りアプリ（conductor-agent）。各PCで常駐し、中央(devlog-tracker)へ定期的に生存報告(heartbeat)を送る常駐CLI。",
   "type": "module",
   "bin": {
@@ -22,6 +22,9 @@
     "scripts/update-guard.sh",
     "scripts/dist-source.sh",
     "scripts/conductor-run.sh",
+    "scripts/tyhld-selfcheck.sh",
+    "scripts/tyhld-autoupdate.sh",
+    "scripts/autoupdate-install.sh",
     "scripts/kc.sh",
     "scripts/codex",
     "!scripts/codex/__pycache__",

package/scripts/autoupdate-install.sh

@@ -0,0 +1,285 @@
+#!/usr/bin/env bash
+#
+# autoupdate-install.sh — 自社PCに「自動更新」を入れる（便 29babc5d・設計 3ed9e2b2 の A3）。
+#
+# 【誰が・いつ打つか】★人が、自社PCの更新の窓で1回だけ打つ（えふさん確定 2026-10-02）。
+#   まず確認だけ:  bash "$(npm root -g)/@tyhld/conductor/scripts/autoupdate-install.sh"
+#   入れる:        APPLY=1 bash "$(npm root -g)/@tyhld/conductor/scripts/autoupdate-install.sh"
+#   ★sudo は使わない（要る物は「人が打つ1行」として出して止まる）。何度打っても同じ結果になる。
+#
+# 【★お客さまの機には入れない】sales-template/install.sh・setup.sh はこの台本を呼ばない
+#   （自社で実績を取ってから、販売版の受入条件として別に判断する＝えふさん確定 2026-10-02）。
+#
+# 【やること】
+#   ⓪ 確かめ … systemd（ユーザー）が使える／入っている采配くん（公開済みの配布物）／接続設定／
+#              囲いの部品（bwrap・socat）／Claude Code の入り方
+#     ★Claude Code が公式推奨の1方式（https://claude.ai/install.sh のネイティブ導入）だけになっていなければ、
+#       人が打つ1行を出して止まる（★この台本は自分で外さない・入れない）。
+#   ① 鍵 … ~/.tyhld/bin/autoupdate/enabled（★職人が書けない場所。これが在る機だけ更新係が動く）
+#   ② 入口 … ~/.tyhld/bin/tyhld-autoupdate・tyhld-selfcheck（＋常駐の入口一式・隣に dist-source.sh）
+#   ③ systemd … tyhld-autoupdate-boot.service（起動時1回）・tyhld-autoupdate.timer（数分ごと）・
+#              tyhld-selfcheck.timer（毎日）。常駐（conductor@・耳・司令塔）は起動時の1回の後に起きる
+#              （常駐の側に After= の drop-in を置く）。撤去の台帳にも載せる。
+#   ④ Claude Code 自身の自動更新を止める … ~/.claude/settings.json の env に DISABLE_AUTOUPDATER=1
+#     （控えを取ってから。★DISABLE_UPDATES は使わない＝人の claude update まで塞ぐため）。
+#     ★上げるのは更新係1つだけ（管制の目標の版を、公式の台本で名指しして入れる）。
+#   ⑤ Windows 側で打つ2行を表示する（WSL を起こして居続けさせる近道・AC 接続時に眠らせない）。
+#
+# 【試験用の入口】★安全境界ではない（ほかの CONDUCTOR_* と同じ）。
+#   AUTOUPDATE_SYSTEM_BIN_DIRS   … ホームの外の claude の置き場（既定 "/usr/local/bin /usr/bin"）
+#   CONDUCTOR_PROC_VERSION_FILE  … WSL かどうかを見る見本（既定 /proc/version）
+#   AUTOUPDATE_SKIP_SYSTEMD_CHECK=1 … systemd の有無の確かめを飛ばす（作り物の systemctl で流すとき）
+set -uo pipefail
+
+APPLY="${APPLY:-0}"
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+. "$HERE/dist-source.sh"
+
+UNIT_DIR="$HOME/.config/systemd/user"
+BIN_DIR="$HOME/.tyhld/bin"
+AU_DIR="$BIN_DIR/autoupdate"
+KEY="$AU_DIR/enabled"
+LEDGER_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/conductor"
+LEDGER_FILE="$LEDGER_DIR/installed-units.txt"
+CLAUDE_SETTINGS="$HOME/.claude/settings.json"
+SYSTEM_BIN_DIRS="${AUTOUPDATE_SYSTEM_BIN_DIRS:-/usr/local/bin /usr/bin}"
+UNITS=(tyhld-autoupdate-boot.service tyhld-autoupdate.service tyhld-autoupdate.timer tyhld-selfcheck.service tyhld-selfcheck.timer)
+ORDER_DROPIN_NAME='10-tyhld-autoupdate.conf'
+RELAY_UNITS=(conductor@.service conductor-ear.service conductor-build-runner.service)
+
+info() { echo "[autoupdate-install] $*"; }
+warn() { echo "[autoupdate-install] 注意: $*" >&2; }
+
+NG=()        # 止まる理由（人が打つ1行つき）
+ng() { NG+=("$1"); }
+
+if [[ "$APPLY" == "1" ]]; then info "モード: 適用"; else info "モード: 確認のみ（1バイトも書きません。入れるには APPLY=1 を付けて打ってください）"; fi
+
+# ─── ⓪ 確かめ ───────────────────────────────────────────────────────────────
+info "⓪ 確かめ"
+
+# systemd（ユーザー）
+if [[ "${AUTOUPDATE_SKIP_SYSTEMD_CHECK:-0}" != "1" ]]; then
+  if ! command -v systemctl >/dev/null 2>&1 || ! systemctl --user show-environment >/dev/null 2>&1; then
+    ng "systemd（ユーザー）が使えません。WSL なら /etc/wsl.conf に [boot] systemd=true が要ります（人の手番・CC1 に知らせてください）"
+  fi
+fi
+
+# 入っている采配くん（★公開済みの配布物。作業ツリーは使わない）
+if dist_runtime_resolve; then
+  info "   采配くん: $DIST_ROOT（版 $DIST_VERSION）"
+else
+  ng "動かす采配くんを確かめられません（${DIST_REASON}）。
+      npm install -g @tyhld/conductor --@tyhld:registry=https://registry.npmjs.org"
+fi
+for f in scripts/tyhld-autoupdate.sh scripts/tyhld-selfcheck.sh systemd/tyhld-autoupdate-boot.service systemd/tyhld-autoupdate.service systemd/tyhld-autoupdate.timer systemd/tyhld-selfcheck.service systemd/tyhld-selfcheck.timer; do
+  if [[ -n "$DIST_ROOT" && ! -f "$DIST_ROOT/$f" ]]; then
+    ng "入っている采配くん（版 ${DIST_VERSION:-不明}）に $f がありません＝自動更新が入る前の版です。
+      npm install -g @tyhld/conductor --@tyhld:registry=https://registry.npmjs.org"
+    break
+  fi
+done
+
+# 接続設定（管制に目標の版を聞く・自己診断を届けるのに要る）。★中身は読まない。
+if [[ -f "$HOME/.conductor.env" ]]; then
+  info "   接続設定: $HOME/.conductor.env が在ります"
+else
+  ng "接続設定（$HOME/.conductor.env）がありません。この機は采配くんの常駐が入っていません（CC1 に知らせてください）"
+fi
+
+# 囲いの部品（無いと職人が起動を断る）
+if [[ "$(uname -s 2>/dev/null)" == "Linux" ]]; then
+  missing=()
+  for b in bwrap socat; do command -v "$b" >/dev/null 2>&1 || missing+=("$b"); done
+  if (( ${#missing[@]} > 0 )); then
+    ng "囲いの部品がありません（${missing[*]}）。
+      sudo apt-get install -y bubblewrap socat"
+  else
+    info "   囲いの部品: bwrap・socat が在ります"
+  fi
+fi
+
+# Claude Code の入り方（★公式推奨＝ネイティブ導入の1方式だけにそろえる・えふさん確定 2026-10-02 夜）
+#   公式（code.claude.com/docs/en/setup）で推奨と明記されているのは Native Install (Recommended)。
+#   ネイティブ導入は ~/.local/bin/claude → ~/.local/share/claude/versions/<版>。
+#   ★ほかの入り方が残っていると、中継がいちばん新しい方を選び、更新係が戻せない（設計 3ed9e2b2 の発見4）。
+NATIVE_LINK="$HOME/.local/bin/claude"
+NATIVE_DIR="$HOME/.local/share/claude/versions"
+native_ok=0
+if [[ -e "$NATIVE_LINK" ]]; then
+  real="$(readlink -f "$NATIVE_LINK" 2>/dev/null || printf '%s' "$NATIVE_LINK")"
+  [[ "$real" == "$NATIVE_DIR/"* ]] && native_ok=1
+fi
+others=()
+if [[ -d "$HOME/.nvm/versions/node" ]]; then
+  for d in "$HOME"/.nvm/versions/node/*/bin; do
+    [[ -e "$d/claude" ]] && others+=("$d/claude")
+  done
+fi
+[[ -e "$HOME/.claude/local/claude" ]] && others+=("$HOME/.claude/local/claude")
+for d in $SYSTEM_BIN_DIRS; do
+  [[ -e "$d/claude" ]] && others+=("$d/claude")
+done
+if (( native_ok == 0 )) && [[ -e "$NATIVE_LINK" ]]; then
+  others+=("$NATIVE_LINK")
+fi
+
+claude_lines=()
+if (( native_ok == 0 )); then
+  claude_lines+=("curl -fsSL https://claude.ai/install.sh | bash -s stable")
+fi
+for c in "${others[@]}"; do
+  real="$(readlink -f "$c" 2>/dev/null || printf '%s' "$c")"
+  case "$c" in
+    "$HOME"/.nvm/versions/node/*/bin/claude)
+      claude_lines+=("PATH=\"$(dirname "$c"):\$PATH\" npm uninstall -g @anthropic-ai/claude-code")
+      ;;
+    "$HOME/.claude/local/claude")
+      claude_lines+=("rm -r \"\$HOME/.claude/local\"")
+      ;;
+    "$NATIVE_LINK")
+      claude_lines+=("rm \"\$HOME/.local/bin/claude\"")
+      ;;
+    *)
+      if [[ "$real" == */lib/node_modules/@anthropic-ai/claude-code/* ]]; then
+        prefix="${real%%/lib/node_modules/*}"
+        if [[ -x "$prefix/bin/npm" ]]; then
+          claude_lines+=("sudo \"$prefix/bin/npm\" uninstall -g @anthropic-ai/claude-code")
+        else
+          claude_lines+=("sudo rm \"$c\"" "sudo rm -r \"$prefix/lib/node_modules/@anthropic-ai/claude-code\"")
+        fi
+      else
+        ng "Claude Code の入り方を見分けられない物があります: $c（実体 $real）。この台本は外しません。CC1 に知らせてください。
+      ls -l \"$c\""
+      fi
+      ;;
+  esac
+done
+if (( ${#claude_lines[@]} > 0 )); then
+  msg="Claude Code が公式推奨の1方式（ネイティブ導入）だけになっていません（ネイティブ導入: $([[ $native_ok == 1 ]] && echo 在る || echo 無い)・ほか: ${others[*]:-無し}）。
+      ★この台本は自分で外さない・入れない。上から順に打ってから、もう一度この台本を打ってください:"
+  for l in "${claude_lines[@]}"; do msg+=$'\n'"      $l"; done
+  ng "$msg"
+else
+  info "   Claude Code: 公式推奨の1方式だけです（$(readlink -f "$NATIVE_LINK" 2>/dev/null)）"
+fi
+
+# ─── ⑤ Windows 側で打つ2行（★止まるときも先に見せる）────────────────────────────
+PROC="${CONDUCTOR_PROC_VERSION_FILE:-/proc/version}"
+windows_lines() {
+  local distro="${WSL_DISTRO_NAME:-Ubuntu}"
+  echo
+  info "⑤ Windows の PowerShell で打つ2行（管理者でなくてよい・1回だけ）:"
+  echo "   1) ログオンのときに WSL（${distro}）を起こし、最小化の窓で居続けさせる近道を置く"
+  printf '%s\n' "\$s=(New-Object -ComObject WScript.Shell).CreateShortcut(\"\$env:APPDATA\\Microsoft\\Windows\\Start Menu\\Programs\\Startup\\tyhld-wsl.lnk\");\$s.TargetPath=\"\$env:WINDIR\\System32\\wsl.exe\";\$s.Arguments=\"-d ${distro} --exec /bin/sleep infinity\";\$s.WindowStyle=7;\$s.Save()"
+  echo "   2) 電源（AC）につないでいるあいだは眠らせない"
+  echo "powercfg /change standby-timeout-ac 0"
+  echo "   ★その窓（最小化の wsl）を閉じると WSL が止まり得ます。Windows のログオンは人のままです。"
+}
+IS_WSL=0
+if [[ -r "$PROC" ]] && grep -qi microsoft "$PROC"; then IS_WSL=1; fi
+
+if (( ${#NG[@]} > 0 )); then
+  echo
+  warn "足りない物があります（★1バイトも書いていません）。上から順に直してから、もう一度打ってください:"
+  for m in "${NG[@]}"; do echo "   ✗ $m" >&2; done
+  (( IS_WSL == 1 )) && windows_lines
+  exit 1
+fi
+
+# ─── ①〜④ 入れる ───────────────────────────────────────────────────────────
+if [[ "$APPLY" != "1" ]]; then
+  info "①（予定）鍵を置きます: $KEY"
+  info "②（予定）入口を置きます: $BIN_DIR/tyhld-autoupdate・tyhld-selfcheck（配布物 $DIST_ROOT から）"
+  info "③（予定）systemd: ${UNITS[*]}（起動時の1回・数分ごと・毎日の自己診断）"
+  info "   （予定）常駐（${RELAY_UNITS[*]}）を起動時の1回の後に起こす drop-in"
+  info "④（予定）$CLAUDE_SETTINGS の env に DISABLE_AUTOUPDATER=1（控えを取ってから）"
+  (( IS_WSL == 1 )) && windows_lines
+  echo
+  info "確認だけで終わりました。入れるには: APPLY=1 bash \"\$(npm root -g)/@tyhld/conductor/scripts/autoupdate-install.sh\""
+  exit 0
+fi
+
+ledger_add() {
+  mkdir -p "$LEDGER_DIR"
+  touch "$LEDGER_FILE"
+  grep -qxF "$1" "$LEDGER_FILE" || echo "$1" >> "$LEDGER_FILE"
+}
+
+# ① 鍵
+mkdir -p "$AU_DIR"
+if [[ ! -f "$KEY" ]]; then
+  printf '%s installed-by=autoupdate-install.sh version=%s\n' "$(date '+%Y-%m-%dT%H:%M:%S%z')" "$DIST_VERSION" > "$KEY"
+fi
+info "① 鍵: $KEY"
+
+# ② 入口（常駐の入口一式＋更新係・自己診断）
+if ! dist_runtime_bundle_install "$DIST_ROOT"; then
+  warn "常駐の入口を置けませんでした: $BIN_DIR（★ここで止めます）"
+  exit 1
+fi
+dist_runtime_hint_write "$DIST_ROOT"
+for pair in "scripts/tyhld-autoupdate.sh:tyhld-autoupdate" "scripts/tyhld-selfcheck.sh:tyhld-selfcheck"; do
+  from="$DIST_ROOT/${pair%%:*}"; to="$BIN_DIR/${pair##*:}"
+  cp -f "$from" "$to.tmp" && mv -f "$to.tmp" "$to" && chmod 755 "$to" && cmp -s "$from" "$to" || {
+    warn "入口を置けませんでした: $to（★ここで止めます）"; exit 1; }
+done
+info "② 入口: $BIN_DIR/tyhld-autoupdate・$BIN_DIR/tyhld-selfcheck（配布物 $DIST_ROOT・版 $DIST_VERSION）"
+
+# ③ systemd
+mkdir -p "$UNIT_DIR"
+for u in "${UNITS[@]}"; do
+  cp -f "$DIST_ROOT/systemd/$u" "$UNIT_DIR/$u"
+done
+for r in "${RELAY_UNITS[@]}"; do
+  mkdir -p "$UNIT_DIR/$r.d"
+  printf '%s\n' \
+    '# tyhld: 常駐は、起動時の更新係（tyhld-autoupdate-boot）の後に起きる（autoupdate-install.sh が置いた）。' \
+    '# ★After= だけ（更新係が失敗しても常駐は起きる）。' \
+    '[Unit]' \
+    'After=tyhld-autoupdate-boot.service' > "$UNIT_DIR/$r.d/$ORDER_DROPIN_NAME"
+done
+systemctl --user daemon-reload
+systemctl --user enable tyhld-autoupdate-boot.service >/dev/null 2>&1 || warn "enable に失敗しました: tyhld-autoupdate-boot.service"
+for t in tyhld-autoupdate.timer tyhld-selfcheck.timer; do
+  systemctl --user enable --now "$t" >/dev/null 2>&1 || warn "enable --now に失敗しました: $t"
+done
+for u in "${UNITS[@]}"; do ledger_add "$u"; done
+loginctl enable-linger "${USER:-$(id -un)}" >/dev/null 2>&1 || true
+info "③ systemd: ${UNITS[*]}（常駐は起動時の1回の後に起きます）"
+
+# ④ Claude Code 自身の自動更新を止める（★上げるのは更新係1つだけ）
+mkdir -p "$(dirname "$CLAUDE_SETTINGS")"
+if [[ -f "$CLAUDE_SETTINGS" ]]; then
+  bak="$CLAUDE_SETTINGS.bak.$(date '+%Y%m%d-%H%M%S')"
+  cp -p "$CLAUDE_SETTINGS" "$bak"
+  info "④ 控え: $bak"
+fi
+if ! python3 - "$CLAUDE_SETTINGS" <<'PY'
+import json, os, sys
+p = sys.argv[1]
+d = {}
+if os.path.exists(p):
+    with open(p, encoding='utf-8') as f:
+        d = json.load(f)
+if not isinstance(d, dict):
+    sys.exit(3)
+env = d.setdefault('env', {})
+if not isinstance(env, dict):
+    sys.exit(3)
+env['DISABLE_AUTOUPDATER'] = '1'
+tmp = p + '.tmp'
+with open(tmp, 'w', encoding='utf-8') as f:
+    json.dump(d, f, ensure_ascii=False, indent=2)
+    f.write('\n')
+os.replace(tmp, p)
+PY
+then
+  warn "$CLAUDE_SETTINGS を読めない形なので、DISABLE_AUTOUPDATER を書けませんでした（控えは上）。CC1 に知らせてください"
+  exit 1
+fi
+info "④ Claude Code 自身の自動更新を止めました（$CLAUDE_SETTINGS の env.DISABLE_AUTOUPDATER=1）"
+
+(( IS_WSL == 1 )) && windows_lines
+echo
+info "入りました。続けて自己診断を1回流してください: ~/.tyhld/bin/tyhld-selfcheck --now"

package/scripts/conductor-run.sh

@@ -30,7 +30,9 @@
 #   systemd は Restart=always なので、入れ直せば次の起動で自動的に戻る。
 #
 # 【★公開 npm には問い合わせない】常駐は回線が切れても動き続ける必要がある。
-#   入っている版が古いかどうかは、毎時同期が見て知らせる（同じ見張りを2つ作らない）。
+#   版をそろえるのは、自動更新が入っている機（自社PC）では更新係（tyhld-autoupdate・便 29babc5d）、
+#   入っていない機では毎時同期が見て知らせる（同じ見張りを2つ作らない）。
+#   ★ここで出す「人の手番」は、配布物そのものが無い・欠けている（＝更新係も動けない）ときだけ。
 #
 # 【置き場】この入口は ~/.tyhld/bin/conductor-run として置かれ、隣に dist-source.sh と
 #   skill_sync_notify.py を置く（導入処理と毎時同期が配布物から写す）。

package/scripts/dist-source.sh

@@ -20,8 +20,16 @@
 #
 # 【この部品が決めること】★これだけ
 #   ・配ってよい中身の置き場（DIST_ROOT）＝この機に入っている @tyhld/conductor の配布物
-#   ・それが「公開済みの正規版」か（入っている版 == 公開 npm のいまの版）
-#   ・違う／確かめられないときは【配らない】と言い切ること
+#   ・それが「公開されている正規の版で、管制で不具合の印が無い版」か（★便 29babc5d で変えた）
+#       以前は「入っている版 == 公開 npm のいまの版（latest）」だけを配っていた。自社PCの段階配布では
+#       後続の機が数時間 latest より古い（正規の）版のまま動くので、そのあいだ番人が止まってしまう。
+#       【えふさん確定（2026-10-02 夜・判断の窓1）】「入っている版＝公開の最新」→
+#       「公開されている正規の版で、管制で不具合の印が無い版」。
+#     正規の版 … 公開 npm にその版が在り、「使わないで」の印（npm deprecate）が付いていない
+#     管制の印 … 管制の目標の版の口に入っている版を添えて聞く（installedConductorFlag）。
+#                "suspect"・"bad" なら配らない。欄が無い・"unknown"・管制に届かないときは
+#                「印が無い」として配る（★番人を配らないほうが危ない）
+#   ・違う／確かめられないときは【配らない】と言い切ること（公開 npm に聞けないときも配らない＝今までどおり）
 #
 # 【この部品が決めないこと】
 #   ・番人の判定・禁止の中身・鉄則の中身（1文字も触らない）
@@ -36,6 +44,8 @@
 # 【試験用の入口】★安全境界ではない（環境変数を置ける人は cp も打てる）。
 #   CONDUCTOR_DIST_ROOT      … 配布物の置き場を名指しする（試験で偽の配布物を指すため）
 #   CONDUCTOR_DIST_PUBLISHED … 公開 npm への問い合わせの代わりに使う値（試験で網を切らないため）
+#   CONDUCTOR_DIST_PUBLISHED_VERSIONS  … 同じく「公開 npm に在る版」の一覧（空白区切り・既定は上の1つだけ）
+#   CONDUCTOR_DIST_DEPRECATED_VERSIONS … 同じく「使わないで」の印が付いた版の一覧（空白区切り）
 
 # ★取得先の宣言は install.sh / setup.sh の「registry-pin」正本と同じ形にする。
 #   （公開 npm 1本。手元の設定が何であってもここだけは公開 npm を見る＝便 9858450b）
@@ -48,6 +58,7 @@ DIST_ROOT=''       # 配ってよい中身の置き場（確かめられたと
 DIST_VERSION=''    # そこに入っている版
 DIST_PUBLISHED=''  # 公開 npm のいまの版
 DIST_REASON=''     # 配れないときの理由（1語・記録にそのまま載る）
+DIST_CENTRAL_FLAG=''  # 管制の印（ok / suspect / bad / unknown）。配り元を決めたときに入る
 
 #: どの道で置き場を見つけたか（override / path / hint / scan / npm）。記録と画面に出す。
 DIST_METHOD=''
@@ -176,8 +187,9 @@ DIST_NODE=''
 # 常駐と耳を動かす置き場を決める（便 81a08d58）。★作業ツリーは選ばない。
 #   返り 0 … DIST_ROOT / DIST_NODE で動かしてよい
 #   返り 1 … 動かしてはいけない（DIST_REASON に理由）
-#   ★公開 npm には問い合わせない。常駐は回線が切れても動き続ける必要があり、
-#     版が古いかどうかは毎時同期（dist_source_resolve）が見て知らせる＝同じ見張りを2つ作らない。
+#   ★公開 npm には問い合わせない。常駐は回線が切れても動き続ける必要がある。
+#     版をそろえるのは、自動更新が入っている機（自社PC）では更新係（tyhld-autoupdate）、
+#     入っていない機では毎時同期（dist_source_resolve）が見て知らせる＝同じ見張りを2つ作らない。
 dist_runtime_resolve() {
   DIST_ROOT=''; DIST_NODE=''; DIST_VERSION=''; DIST_PUBLISHED=''; DIST_REASON=''
   if ! dist_pkg_find; then
@@ -208,30 +220,170 @@ except Exception:
     pass' "$pj" 2>/dev/null
 }
 
-# 公開 npm が「いま配っている版」（取れなければ空）。★固定の下限は使わない（便 9858450b）。
-dist_published_version() {
-  # ★検査用の入口。空文字を入れれば「問い合わせられなかった」を作れる（網を切らずに確かめる）。
+# 配布物を動かしている node と【同じ場所の npm】を返す（見つからなければ空・返り 1）。
+#   【なぜ要るか（実機 2026-10-02・ノートPC・便 3ed9e2b2 の発見1）】
+#     毎時同期（tyhld-guard-sync）は systemd の中で動く。そこの PATH には nvm の node も npm も無く、
+#     /usr/bin/npm も /usr/local/bin/npm も無い機があった。裸の `npm view` が毎回「見つからない」で
+#     失敗し、それを「回線」と記録していた＝番人・鉄則が1度も配られていなかった。
+#   【どう決めるか】配布物の置き場から node を決め（dist_node_for＝常駐と同じ node）、
+#     その node の隣（同じ bin）の npm を使う。node が近道（/usr/local/bin/node → nvm）なら実体を辿る。
+#     それでも無いときだけ PATH の npm を使う（人が打ったとき）。
+dist_npm_for() {
+  local root="$1" node real n
+  node="$(dist_node_for "$root" 2>/dev/null)" || node=''
+  if [[ -n "$node" ]]; then
+    for n in "$node" "$(readlink -f "$node" 2>/dev/null)"; do
+      [[ -n "$n" && -x "$(dirname "$n")/npm" ]] || continue
+      printf '%s' "$(dirname "$n")/npm"
+      return 0
+    done
+  fi
+  real="$(type -P npm 2>/dev/null || true)"
+  [[ -n "$real" ]] && { printf '%s' "$real"; return 0; }
+  return 1
+}
+
+#: 公開版の問い合わせができなかった理由（dist_published_query が入れる）。
+#:   no-npm       … 問い合わせに使う npm が見つからない
+#:   unverifiable … npm は在るが、問い合わせに失敗した（回線・取得先・npm の不調のどれか）
+DIST_PUBLISHED_ERR=''
+#: 問い合わせに使った npm（記録と画面に出す）。
+DIST_NPM=''
+
+# 公開 npm が「いま配っている版」を DIST_PUBLISHED に入れる（取れなければ空＋DIST_PUBLISHED_ERR）。
+#   ★固定の下限は使わない（便 9858450b）。★$(…) の中で呼ばない（結果を変数で返すため）。
+dist_published_query() {
+  local root="${1:-}" v
+  DIST_PUBLISHED=''; DIST_PUBLISHED_ERR=''; DIST_NPM=''
+  # ★検査用の入口。空文字を入れれば「問い合わせに失敗した」を作れる（網を切らずに確かめる）。
   if [[ -n "${CONDUCTOR_DIST_PUBLISHED+x}" ]]; then
-    printf '%s' "$CONDUCTOR_DIST_PUBLISHED"
+    DIST_PUBLISHED="$CONDUCTOR_DIST_PUBLISHED"
+    [[ -n "$DIST_PUBLISHED" ]] || DIST_PUBLISHED_ERR='unverifiable'
+    return 0
+  fi
+  DIST_NPM="$(dist_npm_for "$root")" || DIST_NPM=''
+  if [[ -z "$DIST_NPM" ]]; then
+    DIST_PUBLISHED_ERR='no-npm'
     return 0
   fi
-  local v
-  v="$(npm view "$CONDUCTOR_PKG" version "$CONDUCTOR_REGISTRY_ARG" 2>/dev/null | tr -d '[:space:]')"
+  # ★npm は `#!/usr/bin/env node` で始まる。PATH の先頭に同じ場所を足して、同じ node で動かす。
+  v="$(PATH="$(dirname "$DIST_NPM"):${PATH:-}" "$DIST_NPM" view "$CONDUCTOR_PKG" version "$CONDUCTOR_REGISTRY_ARG" 2>/dev/null | tr -d '[:space:]')"
   if [[ "$v" =~ ^[0-9]+\.[0-9]+\.[0-9]+ ]]; then
-    printf '%s' "${BASH_REMATCH[0]}"
+    DIST_PUBLISHED="${BASH_REMATCH[0]}"
+  else
+    DIST_PUBLISHED_ERR='unverifiable'
+  fi
+  return 0
+}
+
+# 公開 npm が「いま配っている版」（取れなければ空）。★昔からの呼び方を残す。
+dist_published_version() {
+  dist_published_query "${1:-}"
+  printf '%s' "$DIST_PUBLISHED"
+}
+
+#: 入っている版が公開 npm に在るか（yes / no / 空＝確かめられない）と、「使わないで」の印の文。
+DIST_INSTALLED_PUBLISHED=''
+DIST_DEPRECATED=''
+
+# 入っている版が「公開 npm に在る正規の版」かを確かめる（★便 29babc5d・えふさん確定 2026-10-02 夜）。
+#   公開 npm に版を名指しして聞く（npm view <pkg>@<版> version deprecated --json）。
+#     在る   → yes（「使わないで」の印があれば DIST_DEPRECATED に入る）
+#     E404   → no（公開されていない＝正規の版ではない）
+#     ほかの失敗 → 空（確かめられない）
+dist_version_published_query() {
+  local root="$1" ver="$2" out rc parsed v
+  DIST_INSTALLED_PUBLISHED=''; DIST_DEPRECATED=''
+  if [[ -n "${CONDUCTOR_DIST_PUBLISHED+x}" ]]; then
+    local list="${CONDUCTOR_DIST_PUBLISHED_VERSIONS:-$CONDUCTOR_DIST_PUBLISHED}"
+    [[ -n "$list" ]] || return 0
+    DIST_INSTALLED_PUBLISHED='no'
+    for v in $list; do [[ "$v" == "$ver" ]] && DIST_INSTALLED_PUBLISHED='yes'; done
+    for v in ${CONDUCTOR_DIST_DEPRECATED_VERSIONS:-}; do [[ "$v" == "$ver" ]] && DIST_DEPRECATED='使わないでの印があります'; done
+    return 0
   fi
+  [[ -n "$DIST_NPM" ]] || DIST_NPM="$(dist_npm_for "$root")" || DIST_NPM=''
+  [[ -n "$DIST_NPM" ]] || return 0
+  out="$(PATH="$(dirname "$DIST_NPM"):${PATH:-}" "$DIST_NPM" view "$CONDUCTOR_PKG@$ver" version deprecated --json "$CONDUCTOR_REGISTRY_ARG" 2>/dev/null)"
+  rc=$?
+  parsed="$(printf '%s' "$out" | python3 -c 'import json, sys
+ver, rc = sys.argv[1], int(sys.argv[2])
+try:
+    d = json.loads(sys.stdin.read() or "null")
+except Exception:
+    d = None
+if rc == 0 and d == ver:
+    print("yes|")
+elif rc == 0 and isinstance(d, dict) and d.get("version") == ver:
+    dep = d.get("deprecated") or ""
+    print("yes|" + (dep if isinstance(dep, str) else "使わないでの印があります").replace("\n", " ").replace("|", "/"))
+elif isinstance(d, dict) and isinstance(d.get("error"), dict) and d["error"].get("code") == "E404":
+    print("no|")
+else:
+    print("|")' "$ver" "$rc" 2>/dev/null)"
+  [[ "$parsed" == *'|'* ]] || return 0
+  DIST_INSTALLED_PUBLISHED="${parsed%%|*}"
+  DIST_DEPRECATED="${parsed#*|}"
+  return 0
+}
+
+# 管制に「入っている版に不具合の印が無いか」を聞く（★便 29babc5d）。結果は DIST_CENTRAL_FLAG。
+#   GET <管制>/api/conductor/machines/target?machine=<機体名>&conductorVersion=<入っている版>
+#   → 答えの installedConductorFlag が "ok" | "suspect" | "bad" | "unknown"。
+#   ★欄が無い・届かない・ログイン画面へ回される・接続設定が無い は、すべて unknown（＝印が無い）。
+#   ★接続設定は環境変数、無ければ ~/.conductor.env の CONDUCTOR_URL・CONDUCTOR_TOKEN・CONDUCTOR_MACHINE
+#     の3つだけを読む（★値は画面にも控えにも出さない・この関数の外へ持ち出さない）。
+dist_central_flag_query() {
+  local ver="$1" url="${CONDUCTOR_URL:-}" tok="${CONDUCTOR_TOKEN:-}" machine="${CONDUCTOR_MACHINE:-}"
+  local envf="${HOME:-}/.conductor.env" line key val got
+  DIST_CENTRAL_FLAG='unknown'
+  if [[ ( -z "$url" || -z "$tok" ) && -r "$envf" ]]; then
+    while IFS= read -r line || [[ -n "$line" ]]; do
+      line="${line#export }"
+      key="${line%%=*}"; val="${line#*=}"
+      val="${val%\"}"; val="${val#\"}"; val="${val%\'}"; val="${val#\'}"
+      case "$key" in
+        CONDUCTOR_URL)     [[ -n "$url" ]] || url="$val" ;;
+        CONDUCTOR_TOKEN)   [[ -n "$tok" ]] || tok="$val" ;;
+        CONDUCTOR_MACHINE) [[ -n "$machine" ]] || machine="$val" ;;
+      esac
+    done < "$envf"
+  fi
+  [[ -n "$url" && -n "$tok" && -n "$ver" ]] || return 0
+  [[ -n "$machine" ]] || machine="$(hostname 2>/dev/null)"
+  got="$(DCF_URL="$url" DCF_KEY="$tok" DCF_MACHINE="$machine" DCF_VERSION="$ver" python3 -c 'import json, os, urllib.parse, urllib.request
+class NoRedirect(urllib.request.HTTPRedirectHandler):
+    def redirect_request(self, *a, **k):
+        return None
+q = urllib.parse.urlencode({"machine": os.environ["DCF_MACHINE"], "conductorVersion": os.environ["DCF_VERSION"]})
+req = urllib.request.Request(os.environ["DCF_URL"].rstrip("/") + "/api/conductor/machines/target?" + q,
+                             headers={"Authorization": "Bearer " + os.environ["DCF_KEY"]})
+try:
+    with urllib.request.build_opener(NoRedirect).open(req, timeout=15) as r:
+        if "application/json" in (r.headers.get("content-type") or ""):
+            f = json.loads(r.read().decode("utf-8")).get("installedConductorFlag")
+            print(f if f in ("ok", "suspect", "bad", "unknown") else "unknown")
+except Exception:
+    pass' 2>/dev/null)" || got=''
+  case "$got" in ok|suspect|bad|unknown) DIST_CENTRAL_FLAG="$got" ;; *) DIST_CENTRAL_FLAG='unknown' ;; esac
+  return 0
 }
 
 # 配ってよい中身の置き場を決める。
 #   返り 0 … DIST_ROOT を配り元にしてよい
 #   返り 1 … 配ってはいけない（DIST_REASON に理由）
 # 理由の語（記録にそのまま載る）
-#   not-installed  … 配布物がこの機に入っていない
-#   no-version     … 入っている配布物の版が読めない
-#   unverifiable   … 公開 npm に問い合わせられない（回線・取得先の不調）
-#   version-drift  … 入っている版が公開 npm のいまの版と違う
+#   not-installed   … 配布物がこの機に入っていない
+#   no-version      … 入っている配布物の版が読めない
+#   no-npm          … 公開 npm に問い合わせる npm が見つからない（配布物の node の隣にも PATH にも無い）
+#   unverifiable    … npm は在るが、公開 npm への問い合わせに失敗した（回線・取得先・npm の不調）
+#   unpublished     … 入っている版が公開 npm に無い（正規の版ではない）
+#   deprecated      … 入っている版に「使わないで」の印（npm deprecate）が付いている
+#   flagged-suspect … 管制で「疑い」の印が付いている版
+#   flagged-bad     … 管制で「不具合」の印が付いている版
+#   ★2026-10-02 まで在った version-drift（公開の最新と違う）は、もう配らない理由ではない（便 29babc5d）。
 dist_source_resolve() {
-  DIST_ROOT=''; DIST_VERSION=''; DIST_PUBLISHED=''; DIST_REASON=''
+  DIST_ROOT=''; DIST_VERSION=''; DIST_PUBLISHED=''; DIST_REASON=''; DIST_CENTRAL_FLAG=''
   local root
   # ★常駐・耳（dist_runtime_resolve）と同じ探し方を使う＝同じ機で別の版を選ばない。
   if ! dist_pkg_find; then
@@ -244,20 +396,67 @@ dist_source_resolve() {
     DIST_REASON='no-version'
     return 1
   fi
-  DIST_PUBLISHED="$(dist_published_version)"
+  dist_published_query "$root"
   if [[ -z "$DIST_PUBLISHED" ]]; then
     # ★ここで「まあいいか」と配らない。問い合わせられない＝正規版かどうか分からない、である。
-    DIST_REASON='unverifiable'
+    #   ★理由は「npm が無い」と「問い合わせに失敗した」を分ける（回線と言い切らない）。
+    DIST_REASON="${DIST_PUBLISHED_ERR:-unverifiable}"
     return 1
   fi
-  if [[ "$DIST_VERSION" != "$DIST_PUBLISHED" ]]; then
-    DIST_REASON='version-drift'
+  # ★公開の最新と同じなら、それだけで公開 npm に在る正規の版（問い合わせを1回で済ませる）。
+  if [[ "$DIST_VERSION" == "$DIST_PUBLISHED" ]]; then
+    DIST_INSTALLED_PUBLISHED='yes'; DIST_DEPRECATED=''
+  else
+    dist_version_published_query "$root" "$DIST_VERSION"
+  fi
+  case "$DIST_INSTALLED_PUBLISHED" in
+    yes) ;;
+    no)  DIST_REASON='unpublished'; return 1 ;;
+    *)   DIST_REASON='unverifiable'; return 1 ;;
+  esac
+  if [[ -n "$DIST_DEPRECATED" ]]; then
+    DIST_REASON='deprecated'
     return 1
   fi
+  dist_central_flag_query "$DIST_VERSION"
+  case "$DIST_CENTRAL_FLAG" in
+    suspect) DIST_REASON='flagged-suspect'; return 1 ;;
+    bad)     DIST_REASON='flagged-bad'; return 1 ;;
+  esac
   DIST_ROOT="$root"
   return 0
 }
 
+# 自動更新が入っている機か（自社PCの鍵 ~/.tyhld/bin/autoupdate/enabled が在るか・便 29babc5d）。
+dist_autoupdate_enabled() {
+  [[ -f "${HOME:-}/.tyhld/bin/autoupdate/enabled" ]]
+}
+
+# 版がそろっていないときに人が読む「次の1手」を1行ずつ出す（★文言の正本は1か所＝ここ）。
+#   【なぜ分けるか（設計 3ed9e2b2 の 3/4「いまの決まりが書いてある場所（11）」）】
+#     自動更新が入っている機（自社PC）は、更新係が管制の決めた版へそろえる＝人が npm で入れると
+#     段階配布の順番が崩れる。入っていない機（お客さまの機・自動更新を入れる前の機）だけ、人が入れ直す。
+#   引数: 理由の語（DIST_REASON）。
+dist_human_step() {
+  local reason="${1:-}"
+  case "$reason" in
+    flagged-bad|flagged-suspect)
+      echo "入っている版 ${DIST_VERSION:-不明} に、管制で ${reason#flagged-} の印が付いています。"
+      if dist_autoupdate_enabled; then
+        echo "この機は自動更新が入っています。管制が直した版を決めれば、次の自動更新で入れ替わります（人の操作は要りません）。"
+      else
+        echo "人の手番: CC1 に知らせてください（直した版が公開されたら npm install -g @tyhld/conductor --@tyhld:registry=https://registry.npmjs.org）。"
+      fi
+      return 0 ;;
+  esac
+  if dist_autoupdate_enabled; then
+    echo "この機は自動更新が入っています。次の自動更新（管制が決めた版を、作業中の便が終わってから入れます）でそろいます。管制の「PCの状態」で確かめてください。"
+    echo "  自動更新が止まっているときだけ CC1 に知らせてください（人が npm で入れると段階配布の順番が崩れます）。"
+  else
+    echo "人の手番: npm install -g @tyhld/conductor --@tyhld:registry=https://registry.npmjs.org"
+  fi
+}
+
 # ─── 常駐・耳の入口（便 81a08d58）──────────────────────────────────────────
 #: 入口を置く場所。★node の版が変わっても動かない場所（~/.tyhld の下・職人は書けない）。
 DIST_RUNTIME_BIN_DIR="${DIST_RUNTIME_BIN_DIR:-${HOME:-}/.tyhld/bin}"