@cocorograph/hub-agent 0.6.76 → 0.6.78

package/package.json

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

package/scripts/install.sh

@@ -512,6 +512,31 @@ _install_node_lts_linux() {
   color_ok "node $(node --version 2>/dev/null || echo '?') を導入"
 }
 
+# ネイティブアドオン (node-pty 等) のビルドに必要な make / g++ / python3 を導入する。
+# node-pty は prebuild が無いと node-gyp rebuild にフォールバックするが、クリーンな
+# Ubuntu には build-essential が無く `gyp ERR! not found: make` で失敗する
+# (WSL クリーン Ubuntu で発覚)。macOS は Xcode CLT 前提なので何もしない。
+ensure_build_tools() {
+  [[ "$(uname)" == "Darwin" ]] && return 0
+  if present make && present g++; then
+    color_ok "build tools (make / g++) already installed"
+    return 0
+  fi
+  color_step "ネイティブビルド依存 (build-essential / python3) を install"
+  if present apt-get; then
+    retry 3 sudo apt-get update -y
+    retry 3 sudo apt-get install -y build-essential python3
+  elif present dnf; then
+    retry 3 sudo dnf groupinstall -y "Development Tools"
+    retry 3 sudo dnf install -y python3
+  elif present pacman; then
+    retry 3 sudo pacman -S --noconfirm base-devel python
+  else
+    color_err "対応するパッケージマネージャが見つかりません。make / g++ / python3 を手動で install してください"
+    exit 1
+  fi
+}
+
 # Node.js のサポート範囲ポリシー判定。
 # - 未インストール → LTS を install
 # - [MIN, MAX] 範囲内 → 現状維持（ユーザーの環境を尊重）
@@ -731,7 +756,7 @@ EOF
 
 main() {
   color_step "hub-agent ワンライナーセットアップを開始"
-  STEP_TOTAL=10
+  STEP_TOTAL=11
   STEP_NUM=0
 
   step_header "Homebrew"
@@ -740,6 +765,8 @@ main() {
   ensure_pkg tmux tmux tmux
   step_header "Node.js (Active LTS)"
   ensure_node_version
+  step_header "Build tools (native addons)"
+  ensure_build_tools
   step_header "npm global prefix"
   ensure_npm_user_prefix
   # ensure_node_version 直後だと brew link でシェルの command hash がズレている

package/src/service-install.mjs

@@ -128,6 +128,43 @@ function run(cmd, args, opts = {}) {
   }
 }
 
+/** 現在のユーザー名。systemd の linger 操作対象に渡す。 */
+function currentUsername() {
+  try {
+    return os.userInfo().username
+  } catch {
+    return process.env.USER || process.env.LOGNAME || ""
+  }
+}
+
+/**
+ * systemd の user linger を有効化する (Linux 専用・非致命)。
+ *
+ * hub-agent.service は `WantedBy=default.target` の **user サービス**
+ * (`systemctl --user`) のため、linger が無いとログインセッションが無い間は
+ * user systemd インスタンス自体が起動せず、サービスも常駐しない。とくに WSL2 の
+ * 自動起動は「ログオン時 Task Scheduler が `wsl ... /bin/true` で distro を一瞬
+ * 起こす」方式のため、linger 無しだとそのコマンド終了と同時に user セッションが
+ * 畳まれ hub-agent が即停止する (= セットアップ後に自動起動しない主因)。
+ * `loginctl enable-linger <user>` で boot 時から user インスタンスを常駐させる。
+ *
+ * loginctl が無い / systemd 不在の最小環境では失敗しうるが、その場合でも
+ * install 自体は続行する (warn のみ)。
+ */
+function enableLinger(opts = {}) {
+  const spawn = opts.spawnSync ?? spawnSync
+  const user = opts.user ?? currentUsername()
+  const r = spawn("loginctl", ["enable-linger", user], { stdio: "ignore" })
+  if (r.error || r.status !== 0) {
+    console.warn(
+      `warning: loginctl enable-linger ${user} に失敗しました ` +
+      `(systemd/loginctl 不在の可能性)。WSL2/headless では自動起動しない場合があります。`,
+    )
+    return false
+  }
+  return true
+}
+
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
 
 /**
@@ -282,9 +319,18 @@ export async function installService({ bin } = {}) {
     await ensureDir(path.dirname(dest))
     await fs.writeFile(dest, expanded, { mode: 0o644 })
 
+    // linger を先に有効化する。これが無いと user サービスは login セッションが
+    // 無い間 (= WSL2 のログオンタスク経由の boot や headless) に常駐しない。
+    const linger = enableLinger()
     run("systemctl", ["--user", "daemon-reload"])
     run("systemctl", ["--user", "enable", "--now", SYSTEMD_UNIT_NAME])
-    return { platform: "linux", path: dest, unit: SYSTEMD_UNIT_NAME, bin: hubAgentBin }
+    return {
+      platform: "linux",
+      path: dest,
+      unit: SYSTEMD_UNIT_NAME,
+      bin: hubAgentBin,
+      linger,
+    }
   }
 
   throw new Error(`unsupported platform: ${process.platform}`)
@@ -348,6 +394,8 @@ export async function uninstallService() {
     spawnSync("systemctl", ["--user", "disable", "--now", SYSTEMD_UNIT_NAME], {
       stdio: "ignore",
     })
+    // install 時に有効化した linger を戻す (非致命)。
+    spawnSync("loginctl", ["disable-linger", currentUsername()], { stdio: "ignore" })
     const dest = linuxUnitPath()
     try {
       await fs.unlink(dest)
@@ -370,4 +418,6 @@ export const _internal = {
   repoTemplatesDir,
   waitUntilBootedOut,
   bootstrapWithRetry,
+  currentUsername,
+  enableLinger,
 }