@cocorograph/hub-agent 0.6.72 → 0.6.74

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cocorograph/hub-agent",
-  "version": "0.6.72",
+  "version": "0.6.74",
   "description": "Hub Hosted Cockpit のローカル常駐 agent。Hub と outbound WSS で接続し、ローカルの tmux/pty を中継する。",
   "type": "module",
   "license": "UNLICENSED",

package/scripts/install.ps1

@@ -1,87 +1,109 @@
 # =============================================================================
-# hub-agent Windows ワンライナーインストーラ (WSL2 方式)
+# hub-agent Windows one-liner installer (WSL2 method)
 #
-# Hub UI が enrollment token + hub url を埋め込んだ PowerShell one-liner を表示し、
-# ユーザーが「管理者 PowerShell」にコピペ実行する。bash 版 install.sh の Windows 版。
+# The Hub UI shows a PowerShell one-liner with the enrollment token + hub url
+# embedded. The user pastes it into an ADMINISTRATOR PowerShell. This is the
+# Windows counterpart of the bash install.sh.
 #
-# 設計書: D00000_hub-agent/docs/windows-installer-design.md
-# 方針判断: Hub ナレッジ `ナレッジ/Cockpit/Windows対応の設計判断` (id 7385)
+# IMPORTANT: This script is intentionally ASCII-only. Windows PowerShell 5.1
+# fetches the script with `irm` and runs it with `iex`; when the HTTP response
+# has no charset, 5.1 decodes UTF-8 bytes using the legacy code page (e.g.
+# CP932 on Japanese Windows), which turns any non-ASCII text into mojibake and
+# can break parsing. Keeping everything ASCII avoids that entirely.
 #
-# 単独使用 (token なし):
+# Design doc: D00000_hub-agent/docs/windows-installer-design.md
+#
+# Standalone (no token):
 #   irm https://unpkg.com/@cocorograph/hub-agent@latest/scripts/install.ps1 | iex
 #
-# Hub UI が生成する形 (token/url 埋め込み):
+# Form generated by the Hub UI (token/url embedded):
 #   $env:HUB_AGENT_TOKEN="<tok>"; $env:HUB_AGENT_URL="https://api.hub.cocorograph.com"; `
 #     irm https://unpkg.com/@cocorograph/hub-agent@latest/scripts/install.ps1 | iex
 #
-# 内容:
-#   フェーズ1: WSL2 導入 (管理者必須・再起動またぎを RunOnce で吸収)
-#   再起動後 : Ubuntu 初回ユーザーを無人作成 (cloud-init → root install フォールバック)
-#   フェーズ2: WSL の中で既存 install.sh を呼ぶ (tmux/node/hub-agent/claude/enroll)
-#   常駐化   : Task Scheduler のログオンタスクで distro を起こす (中の systemd が hub-agent を起動)
+# Flow:
+#   Phase 1: install WSL2 (admin required; reboot bridged via RunOnce)
+#   After reboot: create the first Ubuntu user unattended
+#               (cloud-init first, root-install + useradd as fallback)
+#   Phase 2: run the existing install.sh inside WSL
+#               (tmux/node/hub-agent/claude/enroll/install-service)
+#   Autostart: a Task Scheduler logon task wakes the distro so its systemd
+#              brings hub-agent up.
 # =============================================================================
 
 #Requires -Version 5.1
 $ErrorActionPreference = "Stop"
 
-# --- 定数 -------------------------------------------------------------------
-# distro は LTS 固定 (将来の非互換回避)。launcher 実行ファイル名も distro に対応して固定。
-$DISTRO        = "Ubuntu-24.04"
-$LAUNCHER      = "ubuntu2404.exe"
-$INSTALL_SH    = "https://unpkg.com/@cocorograph/hub-agent@latest/scripts/install.sh"
-$PS1_URL       = "https://unpkg.com/@cocorograph/hub-agent@latest/scripts/install.ps1"
-$RUNONCE_NAME  = "HubAgentSetup"
-$TASK_NAME     = "HubAgentWSLBoot"
-$DEFAULT_HUB   = "https://api.hub.cocorograph.com"
-
-# --- env からパラメータ取得 -------------------------------------------------
-$Token   = $env:HUB_AGENT_TOKEN
-$HubUrl  = if ($env:HUB_AGENT_URL) { $env:HUB_AGENT_URL } else { $DEFAULT_HUB }
-$IsResume = ($env:HUB_AGENT_RESUME -eq "1")   # 再起動後の RunOnce 自動再開フラグ
-
-# --- カラーログ -------------------------------------------------------------
+# --- constants --------------------------------------------------------------
+# Preferred distro is the LTS. We try this first, then a couple of fallbacks
+# (older Windows 10 WSL catalogs may not know "Ubuntu-24.04").
+$PREFERRED_DISTRO = "Ubuntu-24.04"
+$DISTRO_CANDIDATES = @("Ubuntu-24.04", "Ubuntu")
+$INSTALL_SH   = "https://unpkg.com/@cocorograph/hub-agent@latest/scripts/install.sh"
+$PS1_URL      = "https://unpkg.com/@cocorograph/hub-agent@latest/scripts/install.ps1"
+$RUNONCE_NAME = "HubAgentSetup"
+$TASK_NAME    = "HubAgentWSLBoot"
+$DEFAULT_HUB  = "https://api.hub.cocorograph.com"
+
+# --- params from env --------------------------------------------------------
+$Token    = $env:HUB_AGENT_TOKEN
+$HubUrl   = if ($env:HUB_AGENT_URL) { $env:HUB_AGENT_URL } else { $DEFAULT_HUB }
+$IsResume = ($env:HUB_AGENT_RESUME -eq "1")   # set by RunOnce after reboot
+
+# --- colored logging (ASCII only) ------------------------------------------
 function Write-Step($m) { Write-Host "==> $m" -ForegroundColor Cyan }
 function Write-Ok($m)   { Write-Host "[OK] $m" -ForegroundColor Green }
 function Write-Warn($m) { Write-Host "[!] $m"  -ForegroundColor Yellow }
 function Write-Err($m)  { Write-Host "[x] $m"  -ForegroundColor Red }
 
-# --- ヘルパー ---------------------------------------------------------------
+# --- helpers ----------------------------------------------------------------
 function Test-IsAdmin {
   $id = [Security.Principal.WindowsIdentity]::GetCurrent()
   $pr = New-Object Security.Principal.WindowsPrincipal($id)
   return $pr.IsInRole([Security.Principal.WindowsBuiltinRole]::Administrator)
 }
 
-# wsl -l -q は UTF-16LE + NUL 混じりで出すため、サニタイズして配列化する。
+# `wsl -l -q` prints UTF-16LE with stray NULs; sanitize and split to an array.
 function Get-WslDistros {
   try {
     $raw = (wsl.exe -l -q) 2>$null
     if (-not $raw) { return @() }
-    return ($raw -replace "`0", "") -split "`r?`n" | ForEach-Object { $_.Trim() } | Where-Object { $_ -ne "" }
+    return ($raw -replace "`0", "") -split "`r?`n" |
+      ForEach-Object { $_.Trim() } | Where-Object { $_ -ne "" }
   } catch { return @() }
 }
 
-function Test-DistroExists { return (Get-WslDistros) -contains $DISTRO }
+# Return the name of an installed Ubuntu distro (prefer 24.04), or $null.
+function Resolve-InstalledUbuntu {
+  $installed = Get-WslDistros
+  foreach ($cand in $DISTRO_CANDIDATES) {
+    if ($installed -contains $cand) { return $cand }
+  }
+  # any distro whose name starts with "Ubuntu"
+  $u = $installed | Where-Object { $_ -like "Ubuntu*" } | Select-Object -First 1
+  if ($u) { return $u }
+  return $null
+}
 
-# WSL 機能そのもの (カーネル + プラットフォーム) が使える状態か。
+# Is the WSL engine (kernel + platform) usable at all?
 function Test-WslReady {
   try { wsl.exe --status *> $null; return ($LASTEXITCODE -eq 0) } catch { return $false }
 }
 
-# distro 内に対象ユーザーが存在するか (無人作成の冪等チェック)。
-function Test-WslUserReady($user) {
-  if (-not $user) { return $false }
-  try { wsl.exe -d $DISTRO -u root -- id $user *> $null; return ($LASTEXITCODE -eq 0) } catch { return $false }
+# Does user exist inside the given distro? (idempotency check)
+function Test-WslUserReady($distro, $user) {
+  if (-not $distro -or -not $user) { return $false }
+  try { wsl.exe -d $distro -u root -- id $user *> $null; return ($LASTEXITCODE -eq 0) }
+  catch { return $false }
 }
 
-# Windows ユーザー名を Linux 命名規則にサニタイズ ([a-z_][a-z0-9_-]*)。
+# Sanitize Windows username to a valid Linux name ([a-z_][a-z0-9_-]*).
 function Get-LinuxUserName {
   $u = ($env:USERNAME).ToLower() -replace '[^a-z0-9_-]', ''
   if ($u -eq '' -or $u -match '^[0-9]') { $u = "hub$u" }
   return $u
 }
 
-# RunOnce に「再起動後に自身を RESUME=1 で再実行」を仕込む。token/url を引き継ぐ。
+# Register "re-run myself with RESUME=1 after reboot", carrying token/url.
 function Set-ResumeOnReboot {
   $cmd = "powershell -NoProfile -ExecutionPolicy Bypass -Command " +
          "`"`$env:HUB_AGENT_TOKEN='$Token'; `$env:HUB_AGENT_URL='$HubUrl'; " +
@@ -90,21 +112,20 @@ function Set-ResumeOnReboot {
     -Name $RUNONCE_NAME -Value $cmd
 }
 
-# 再起動はユーザーに委ねる (自動実行はデータ保全リスク)。RunOnce 登録済なので「あとで」でも自動再開。
-function Prompt-RebootDecision {
+# Leave the reboot decision to the user (auto-reboot risks unsaved work).
+# RunOnce is already registered, so "later" still auto-resumes on next boot.
+function Invoke-RebootPrompt {
   Write-Host ""
-  Write-Step "WSL2 を導入しました。続行には Windows の再起動が必要です。"
-  Write-Host "  再起動後、セットアップは自動で続行します (手動操作は不要)。" -ForegroundColor Cyan
-  $ans = Read-Host "今すぐ再起動しますか? [Y=今すぐ / N=あとで自分で再起動]"
-  if ($ans -match '^[Yy]') {
-    Restart-Computer
-  } else {
-    Write-Warn "あとで Windows を再起動すると、セットアップが自動で続きます。"
-  }
+  Write-Step "WSL2 is installed. A Windows reboot is required to continue."
+  Write-Host "  After reboot, setup resumes automatically (no manual steps)." -ForegroundColor Cyan
+  $ans = Read-Host "Reboot now? [Y = reboot now / N = I'll reboot later]"
+  if ($ans -match '^[Yy]') { Restart-Computer }
+  else { Write-Warn "Reboot Windows later and setup will continue automatically." }
 }
 
-# cloud-init 用 user-data を「初回起動前」に配置する。
-# %USERPROFILE%\.cloud-init\<DistroName>.user-data に置くと初回起動で OOBE 無しに反映される。
+# Place cloud-init user-data BEFORE first boot. WSL applies it on first launch,
+# skipping the interactive OOBE. The file name must match the registered distro
+# name, so we write one file per candidate name to be safe.
 function Write-CloudInit($user) {
   $ciDir = Join-Path $env:USERPROFILE ".cloud-init"
   New-Item -ItemType Directory -Force -Path $ciDir | Out-Null
@@ -124,35 +145,75 @@ write_files:
       [boot]
       systemd=true
 "@
-  # WSL/cloud-init は LF + UTF-8(BOM なし) を期待するため改行を正規化して書く。
-  $yaml = $yaml -replace "`r`n", "`n"
-  $path = Join-Path $ciDir "$DISTRO.user-data"
-  [System.IO.File]::WriteAllText($path, $yaml, (New-Object System.Text.UTF8Encoding($false)))
-  Write-Ok "cloud-init user-data を配置: $path"
+  $yaml = $yaml -replace "`r`n", "`n"   # cloud-init wants LF + UTF-8 (no BOM)
+  $enc = New-Object System.Text.UTF8Encoding($false)
+  foreach ($name in $DISTRO_CANDIDATES) {
+    $path = Join-Path $ciDir "$name.user-data"
+    [System.IO.File]::WriteAllText($path, $yaml, $enc)
+  }
+  Write-Ok "cloud-init user-data placed in $ciDir"
 }
 
-# 方式A: cloud-init が完了するまで待つ。成功で $true。
-function Invoke-CloudInitProvision($user) {
-  Write-Step "Ubuntu 初回ユーザーを無人作成 (cloud-init)"
+# Update the WSL engine + online distro catalog. On Windows 10 the inbox WSL
+# catalog is often stale and does not know Ubuntu-24.04; `wsl --update` pulls
+# the Store WSL which refreshes the catalog. Failures are non-fatal (warn).
+function Update-WslEngine {
+  Write-Step "Updating WSL engine (wsl --update)"
   try {
-    # 初回起動をトリガー。cloud-init が user-data を適用する。
-    wsl.exe -d $DISTRO -u root -- cloud-init status --wait *> $null
-  } catch {
-    Write-Warn "cloud-init status --wait に失敗 (cloud-init 非対応の可能性)"
-    return $false
-  }
-  return (Test-WslUserReady $user)
+    wsl.exe --update *> $null
+    if ($LASTEXITCODE -ne 0) { Write-Warn "wsl --update returned $LASTEXITCODE (continuing)" }
+    else { Write-Ok "WSL engine updated" }
+  } catch { Write-Warn "wsl --update failed (continuing)" }
 }
 
-# 方式B (フォールバック): launcher install --root → useradd で無人作成。
-function Invoke-RootInstallProvision($user) {
-  Write-Step "Ubuntu 初回ユーザーを無人作成 (root install フォールバック)"
-  try {
-    # OOBE 無しで root のみ初期化。既に登録済みなら無害。
-    & $LAUNCHER install --root *> $null
-  } catch {
-    Write-Warn "$LAUNCHER install --root に失敗 (続行して useradd を試行)"
+# Install a distro without launching it. Tries candidate names and a no-flag
+# fallback (older WSL may not support --no-launch). Returns the installed name
+# or throws with actionable guidance.
+function Install-Distro {
+  $existing = Resolve-InstalledUbuntu
+  if ($existing) { Write-Ok "Ubuntu distro already installed: $existing"; return $existing }
+
+  Update-WslEngine
+
+  foreach ($name in $DISTRO_CANDIDATES) {
+    Write-Step "Installing distro: $name"
+    # 1) modern: --no-launch
+    wsl.exe --install -d $name --no-launch *> $null
+    if ($LASTEXITCODE -eq 0 -and (Get-WslDistros) -contains $name) { return $name }
+    # 2) older WSL may reject --no-launch; retry without it (still no OOBE
+    #    because cloud-init is already staged).
+    wsl.exe --install -d $name *> $null
+    if ($LASTEXITCODE -eq 0 -and (Get-WslDistros) -contains $name) { return $name }
+    Write-Warn "Could not install '$name', trying next candidate..."
   }
+
+  # If we get here every candidate failed.
+  Write-Err "Failed to install a WSL Ubuntu distro automatically."
+  Write-Host ""
+  Write-Host "Please run these in an ADMINISTRATOR PowerShell, then re-run this installer:" -ForegroundColor Yellow
+  Write-Host "  wsl --update" -ForegroundColor Yellow
+  Write-Host "  wsl --list --online        # confirm an Ubuntu name is listed" -ForegroundColor Yellow
+  Write-Host "  wsl --install -d Ubuntu-24.04   # or the Ubuntu name shown above" -ForegroundColor Yellow
+  Write-Host ""
+  Write-Host "Note: Windows 10 needs version 21H2+ and an up-to-date WSL." -ForegroundColor Yellow
+  throw "distro install failed"
+}
+
+# cloud-init path: wait for completion, return $true if the user got created.
+function Invoke-CloudInitProvision($distro, $user) {
+  Write-Step "Creating first Ubuntu user unattended (cloud-init)"
+  try { wsl.exe -d $distro -u root -- cloud-init status --wait *> $null }
+  catch { Write-Warn "cloud-init status --wait failed (cloud-init may be unsupported)"; return $false }
+  return (Test-WslUserReady $distro $user)
+}
+
+# Fallback: launcher `install --root` then useradd. Launcher exe name depends
+# on the distro (ubuntu2404.exe etc.); resolve it from the distro name.
+function Invoke-RootInstallProvision($distro, $user) {
+  Write-Step "Creating first Ubuntu user unattended (root-install fallback)"
+  $launcher = ($distro.ToLower() -replace '[^a-z0-9]', '') + ".exe"   # Ubuntu-24.04 -> ubuntu2404.exe
+  try { & $launcher install --root *> $null }
+  catch { Write-Warn "$launcher install --root failed (continuing to useradd)" }
   $script = @"
 set -e
 useradd -m -s /bin/bash -G sudo '$user' 2>/dev/null || true
@@ -162,99 +223,103 @@ chmod 0440 /etc/sudoers.d/90-hub-$user
 printf '[user]\ndefault=$user\n[boot]\nsystemd=true\n' > /etc/wsl.conf
 "@
   $script = $script -replace "`r`n", "`n"
-  wsl.exe -d $DISTRO -u root -- bash -lc $script
+  wsl.exe -d $distro -u root -- bash -lc $script
   wsl.exe --shutdown
-  return (Test-WslUserReady $user)
+  return (Test-WslUserReady $distro $user)
 }
 
-# distro 内の /etc/wsl.conf に systemd=true が無ければ追記 (冪等)。
-function Ensure-Systemd {
-  $has = (wsl.exe -d $DISTRO -u root -- bash -lc "grep -q 'systemd=true' /etc/wsl.conf 2>/dev/null && echo yes || echo no")
+# Ensure systemd=true in the distro's /etc/wsl.conf (idempotent).
+function Set-Systemd($distro) {
+  $has = (wsl.exe -d $distro -u root -- bash -lc "grep -q 'systemd=true' /etc/wsl.conf 2>/dev/null && echo yes || echo no")
   if (($has -replace "`0","").Trim() -ne "yes") {
-    wsl.exe -d $DISTRO -u root -- bash -lc "printf '[boot]\nsystemd=true\n' >> /etc/wsl.conf"
+    wsl.exe -d $distro -u root -- bash -lc "printf '[boot]\nsystemd=true\n' >> /etc/wsl.conf"
     wsl.exe --shutdown
   }
 }
 
-# Task Scheduler に「ログオン時に distro を起こす」タスクを登録 (Mac に無い新ピース)。
-function Register-BootTask($user) {
-  Write-Step "Windows 起動時の常駐起動を登録 (Task Scheduler)"
-  $action  = New-ScheduledTaskAction -Execute "wsl.exe" -Argument "-d $DISTRO -u $user -- /bin/true"
+# Register a logon task that wakes the distro (its systemd starts hub-agent).
+function Register-BootTask($distro, $user) {
+  Write-Step "Registering autostart on logon (Task Scheduler)"
+  $action  = New-ScheduledTaskAction -Execute "wsl.exe" -Argument "-d $distro -u $user -- /bin/true"
   $trigger = New-ScheduledTaskTrigger -AtLogOn
   $set     = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -StartWhenAvailable
   Register-ScheduledTask -TaskName $TASK_NAME -Action $action -Trigger $trigger -Settings $set `
     -RunLevel Limited -Force | Out-Null
-  Write-Ok "ログオンタスク '$TASK_NAME' を登録しました"
+  Write-Ok "Logon task '$TASK_NAME' registered"
 }
 
-# WSL の中で既存 install.sh を呼ぶ (tmux/node/hub-agent/claude/enroll/install-service)。
-function Invoke-WslInstaller($user) {
-  Write-Step "WSL 内で hub-agent をセットアップ (既存 install.sh)"
+# Run the existing install.sh inside WSL.
+function Invoke-WslInstaller($distro, $user) {
+  Write-Step "Setting up hub-agent inside WSL (existing install.sh)"
   $tok = if ($Token) { $Token } else { "" }
   $inner = "curl -fsSL '$INSTALL_SH' | HUB_AGENT_TOKEN='$tok' HUB_AGENT_URL='$HubUrl' bash"
-  wsl.exe -d $DISTRO -u $user -- bash -lc $inner
-  if ($LASTEXITCODE -ne 0) { throw "WSL 内 install.sh が失敗しました (exit $LASTEXITCODE)" }
+  wsl.exe -d $distro -u $user -- bash -lc $inner
+  if ($LASTEXITCODE -ne 0) { throw "install.sh inside WSL failed (exit $LASTEXITCODE)" }
 }
 
 # =============================================================================
-# メイン
+# main
 # =============================================================================
 function Main {
-  Write-Step "hub-agent Windows セットアップを開始 (WSL2 方式)"
+  Write-Step "Starting hub-agent Windows setup (WSL2 method)"
 
   if (-not (Test-IsAdmin)) {
-    Write-Err "管理者権限が必要です。PowerShell を『管理者として実行』で開き直してください。"
+    Write-Err "Administrator privileges are required. Reopen PowerShell as Administrator."
     exit 1
   }
 
   $user = Get-LinuxUserName
 
-  # --- フェーズ1: WSL2 / distro 導入 (未導入時のみ。再起動をまたぐ) ---
-  if (-not $IsResume -and (-not (Test-WslReady) -or -not (Test-DistroExists))) {
-    Write-Step "WSL2 + $DISTRO を導入します"
-    Set-ResumeOnReboot                 # 再起動後に自動再開する仕掛けを先に仕込む
-    Write-CloudInit $user              # 初回起動前に cloud-init を配置 (方式A の前提)
-    wsl.exe --install -d $DISTRO --no-launch
-    Prompt-RebootDecision              # 再起動は Y/N でユーザーに委ねる
+  # --- Phase 1: install WSL2 + distro (only when none present; bridges reboot) ---
+  if (-not $IsResume -and -not (Resolve-InstalledUbuntu)) {
+    Write-Step "Installing WSL2 + Ubuntu"
+    Set-ResumeOnReboot          # arm auto-resume first
+    Write-CloudInit $user       # stage cloud-init before first boot
+    $installed = Install-Distro # robust: update + candidate names + fallbacks
+    Write-Ok "Distro installed: $installed"
+    Invoke-RebootPrompt         # reboot is the user's choice
     return
   }
 
-  # --- 再起動後 or 既に WSL 導入済み: ユーザー無人作成 ---
-  if (-not (Test-DistroExists)) {
-    # RESUME なのに distro が無い = wsl --install が再起動後に展開中のことがある。
-    Write-Warn "$DISTRO がまだ見つかりません。展開を待って初回起動を試みます..."
+  # --- after reboot, or WSL already present: resolve the real distro name ---
+  $distro = Resolve-InstalledUbuntu
+  if (-not $distro) {
+    # RESUME but distro not visible yet: the deployment may still be unpacking.
+    Write-Warn "Ubuntu distro not found yet; attempting install..."
     Write-CloudInit $user
+    $distro = Install-Distro
   }
+  Write-Ok "Using distro: $distro"
 
-  if (-not (Test-WslUserReady $user)) {
-    # 方式A (cloud-init) → 失敗時 方式B (root install) へ自動フォールバック。
-    if (-not (Test-Path (Join-Path $env:USERPROFILE ".cloud-init\$DISTRO.user-data"))) {
+  # --- create the first Ubuntu user unattended ---
+  if (-not (Test-WslUserReady $distro $user)) {
+    if (-not (Test-Path (Join-Path $env:USERPROFILE ".cloud-init\$distro.user-data"))) {
       Write-CloudInit $user
     }
-    $ok = Invoke-CloudInitProvision $user
+    $ok = Invoke-CloudInitProvision $distro $user
     if (-not $ok) {
-      Write-Warn "cloud-init での作成を確認できませんでした。root install 方式に切り替えます。"
-      $ok = Invoke-RootInstallProvision $user
+      Write-Warn "cloud-init did not create the user; switching to root-install method."
+      $ok = Invoke-RootInstallProvision $distro $user
     }
-    if (-not $ok) { throw "Ubuntu ユーザー '$user' の無人作成に失敗しました" }
-    Write-Ok "Ubuntu ユーザー '$user' を作成しました (パスワードなし / NOPASSWD sudo)"
+    if (-not $ok) { throw "Failed to create Ubuntu user '$user' unattended" }
+    Write-Ok "Created Ubuntu user '$user' (no password / NOPASSWD sudo)"
   } else {
-    Write-Ok "Ubuntu ユーザー '$user' は既に存在します"
+    Write-Ok "Ubuntu user '$user' already exists"
   }
 
-  Ensure-Systemd
+  Set-Systemd $distro
 
-  # --- フェーズ2: WSL 内ワンライナー ---
-  Invoke-WslInstaller $user
+  # --- Phase 2: run install.sh inside WSL ---
+  Invoke-WslInstaller $distro $user
 
-  # --- 常駐化 ---
-  Register-BootTask $user
+  # --- autostart ---
+  Register-BootTask $distro $user
 
   Write-Host ""
-  Write-Ok "セットアップ完了。Hub UI で online 表示を確認してください"
+  Write-Ok "Setup complete. Check the online status in the Hub UI:"
   Write-Host "    https://hub.cocorograph.com/user/cockpit/agents" -ForegroundColor Cyan
-  Write-Warn "注意: 作業リポジトリは WSL 内 (例: /home/$user/...) に置いてください。"
-  Write-Warn "      Windows ドライブ (/mnt/c/...) はファイル監視が不安定です。"
+  Write-Warn "Keep your working repos INSIDE WSL (e.g. /home/$user/...)."
+  Write-Warn "Windows drives (/mnt/c/...) have unreliable file watching."
 }
 
 Main

package/scripts/install.sh

@@ -483,7 +483,10 @@ _install_node_lts_brew() {
 # - 範囲超過（current 系等） → LTS にダウングレード
 ensure_node_version() {
   local v
-  v=$(node --version 2>/dev/null | sed 's/^v//' | cut -d. -f1)
+  # node 皆無のクリーン環境では `node --version` が exit 127。set -euo pipefail 下
+  # では pipefail がこれを拾ってスクリプトごと死ぬため、`|| v=""` で必ず吸収する
+  # (macOS テスト機には既に node があり露見しなかった潜在バグ。WSL クリーン Ubuntu で発覚)。
+  v=$(node --version 2>/dev/null | sed 's/^v//' | cut -d. -f1) || v=""
   if [[ -z "$v" ]]; then
     color_step "node が未インストール → $NODE_DEFAULT_BREW_FORMULA (Active LTS) を install"
     if [[ "$(uname)" == "Darwin" ]]; then