@cocorograph/hub-agent 0.6.71 → 0.6.72

package/README.md

@@ -22,6 +22,26 @@ curl -fsSL https://api.hub.cocorograph.com/api/cockpit/agents/install-script | b
 - `hub-agent enroll <token>` (token は Hub session 経由で埋め込み済、5 分有効)
 - `hub-agent install-service` で OS サービス登録
 
+### Windows (WSL2 方式)
+
+Windows では WSL2 (Ubuntu) の中で hub-agent を動かします。Cockpit Agents ページで
+OS を Windows に切り替えると **管理者 PowerShell 用ワンライナー**が表示されるので、
+**管理者として実行した PowerShell** にコピペします:
+
+```powershell
+$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
+```
+
+このスクリプトは WSL2 (`Ubuntu-24.04`) を導入 (要再起動 1 回・再起動後に自動再開)、
+Ubuntu 初回ユーザーを無人作成 (Windows と同名 / パスワードなし / NOPASSWD sudo)、
+WSL 内で既存 `install.sh` を実行、Task Scheduler でログオン時の常駐起動を登録します。
+
+> ⚠️ 作業リポジトリは **WSL 内 FS** (`/home/<user>/...`) に置いてください。Windows ドライブ
+> (`/mnt/c/...`) はファイル監視 (inotify) が WSL 跨ぎで不安定です。
+
+詳細・設計判断は `scripts/install.ps1` と `docs/windows-installer-design.md` を参照。
+
 ### 手動インストール (デバッグ用)
 
 ```bash

package/package.json

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

package/scripts/install.ps1

@@ -0,0 +1,260 @@
+# =============================================================================
+# hub-agent Windows ワンライナーインストーラ (WSL2 方式)
+#
+# Hub UI が enrollment token + hub url を埋め込んだ PowerShell one-liner を表示し、
+# ユーザーが「管理者 PowerShell」にコピペ実行する。bash 版 install.sh の Windows 版。
+#
+# 設計書: D00000_hub-agent/docs/windows-installer-design.md
+# 方針判断: Hub ナレッジ `ナレッジ/Cockpit/Windows対応の設計判断` (id 7385)
+#
+# 単独使用 (token なし):
+#   irm https://unpkg.com/@cocorograph/hub-agent@latest/scripts/install.ps1 | iex
+#
+# Hub UI が生成する形 (token/url 埋め込み):
+#   $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 を起動)
+# =============================================================================
+
+#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 自動再開フラグ
+
+# --- カラーログ -------------------------------------------------------------
+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 }
+
+# --- ヘルパー ---------------------------------------------------------------
+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 混じりで出すため、サニタイズして配列化する。
+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 "" }
+  } catch { return @() }
+}
+
+function Test-DistroExists { return (Get-WslDistros) -contains $DISTRO }
+
+# WSL 機能そのもの (カーネル + プラットフォーム) が使える状態か。
+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 }
+}
+
+# Windows ユーザー名を Linux 命名規則にサニタイズ ([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 を引き継ぐ。
+function Set-ResumeOnReboot {
+  $cmd = "powershell -NoProfile -ExecutionPolicy Bypass -Command " +
+         "`"`$env:HUB_AGENT_TOKEN='$Token'; `$env:HUB_AGENT_URL='$HubUrl'; " +
+         "`$env:HUB_AGENT_RESUME='1'; irm $PS1_URL | iex`""
+  Set-ItemProperty -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\RunOnce" `
+    -Name $RUNONCE_NAME -Value $cmd
+}
+
+# 再起動はユーザーに委ねる (自動実行はデータ保全リスク)。RunOnce 登録済なので「あとで」でも自動再開。
+function Prompt-RebootDecision {
+  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 を再起動すると、セットアップが自動で続きます。"
+  }
+}
+
+# cloud-init 用 user-data を「初回起動前」に配置する。
+# %USERPROFILE%\.cloud-init\<DistroName>.user-data に置くと初回起動で OOBE 無しに反映される。
+function Write-CloudInit($user) {
+  $ciDir = Join-Path $env:USERPROFILE ".cloud-init"
+  New-Item -ItemType Directory -Force -Path $ciDir | Out-Null
+  $yaml = @"
+#cloud-config
+users:
+  - name: $user
+    groups: [sudo]
+    shell: /bin/bash
+    sudo: ['ALL=(ALL) NOPASSWD:ALL']
+    lock_passwd: true
+write_files:
+  - path: /etc/wsl.conf
+    content: |
+      [user]
+      default=$user
+      [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"
+}
+
+# 方式A: cloud-init が完了するまで待つ。成功で $true。
+function Invoke-CloudInitProvision($user) {
+  Write-Step "Ubuntu 初回ユーザーを無人作成 (cloud-init)"
+  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)
+}
+
+# 方式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 を試行)"
+  }
+  $script = @"
+set -e
+useradd -m -s /bin/bash -G sudo '$user' 2>/dev/null || true
+passwd -d '$user'
+echo '$user ALL=(ALL) NOPASSWD:ALL' > /etc/sudoers.d/90-hub-$user
+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 --shutdown
+  return (Test-WslUserReady $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")
+  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 --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"
+  $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' を登録しました"
+}
+
+# WSL の中で既存 install.sh を呼ぶ (tmux/node/hub-agent/claude/enroll/install-service)。
+function Invoke-WslInstaller($user) {
+  Write-Step "WSL 内で hub-agent をセットアップ (既存 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)" }
+}
+
+# =============================================================================
+# メイン
+# =============================================================================
+function Main {
+  Write-Step "hub-agent Windows セットアップを開始 (WSL2 方式)"
+
+  if (-not (Test-IsAdmin)) {
+    Write-Err "管理者権限が必要です。PowerShell を『管理者として実行』で開き直してください。"
+    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 でユーザーに委ねる
+    return
+  }
+
+  # --- 再起動後 or 既に WSL 導入済み: ユーザー無人作成 ---
+  if (-not (Test-DistroExists)) {
+    # RESUME なのに distro が無い = wsl --install が再起動後に展開中のことがある。
+    Write-Warn "$DISTRO がまだ見つかりません。展開を待って初回起動を試みます..."
+    Write-CloudInit $user
+  }
+
+  if (-not (Test-WslUserReady $user)) {
+    # 方式A (cloud-init) → 失敗時 方式B (root install) へ自動フォールバック。
+    if (-not (Test-Path (Join-Path $env:USERPROFILE ".cloud-init\$DISTRO.user-data"))) {
+      Write-CloudInit $user
+    }
+    $ok = Invoke-CloudInitProvision $user
+    if (-not $ok) {
+      Write-Warn "cloud-init での作成を確認できませんでした。root install 方式に切り替えます。"
+      $ok = Invoke-RootInstallProvision $user
+    }
+    if (-not $ok) { throw "Ubuntu ユーザー '$user' の無人作成に失敗しました" }
+    Write-Ok "Ubuntu ユーザー '$user' を作成しました (パスワードなし / NOPASSWD sudo)"
+  } else {
+    Write-Ok "Ubuntu ユーザー '$user' は既に存在します"
+  }
+
+  Ensure-Systemd
+
+  # --- フェーズ2: WSL 内ワンライナー ---
+  Invoke-WslInstaller $user
+
+  # --- 常駐化 ---
+  Register-BootTask $user
+
+  Write-Host ""
+  Write-Ok "セットアップ完了。Hub UI で online 表示を確認してください"
+  Write-Host "    https://hub.cocorograph.com/user/cockpit/agents" -ForegroundColor Cyan
+  Write-Warn "注意: 作業リポジトリは WSL 内 (例: /home/$user/...) に置いてください。"
+  Write-Warn "      Windows ドライブ (/mnt/c/...) はファイル監視が不安定です。"
+}
+
+Main