@cocorograph/hub-agent 0.6.77 → 0.6.79

package/package.json

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

package/scripts/install.ps1

@@ -237,15 +237,33 @@ function Set-Systemd($distro) {
   }
 }
 
-# Register a logon task that wakes the distro (its systemd starts hub-agent).
+# Register a logon task that keeps the distro ALIVE (so its systemd --user
+# hub-agent stays online).
+#
+# 旧実装は `wsl ... /bin/true` で distro を一瞬起こすだけだった。これだと WSL2 の
+# アイドルシャットダウンが数十秒で distro ごと畳んでしまい (agent.log に
+# `SIGTERM shutting down` が出て `wsl -l -v` が Stopped になる)、hub-agent も停止して
+# オフラインに戻る。systemd --user + linger は「distro が起動している間」しか効かない
+# ため、distro 自体を起こし続ける常駐プロセスが必要。
+#
+# 対策: ログオン中ずっと `sleep infinity` を WSL 内で走らせて distro を起動状態に保つ。
+# 併せて hub-agent.service を start しておく (enable + linger 済みなら冪等)。
 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"
+  Write-Step "Registering autostart on logon (Task Scheduler, keep-alive)"
+  # distro を起動し続ける keep-alive。systemctl start は冪等 (既に active なら no-op)。
+  $keepalive = "systemctl --user start hub-agent.service 2>/dev/null; exec sleep infinity"
+  $action  = New-ScheduledTaskAction -Execute "wsl.exe" `
+    -Argument "-d $distro -u $user -- bash -lc `"$keepalive`""
   $trigger = New-ScheduledTaskTrigger -AtLogOn
-  $set     = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -StartWhenAvailable
+  # ExecutionTimeLimit=0 で無制限 (既定 72h で停止されると distro が落ちる)。
+  # keep-alive が万一終了したら 1 分後に最大 3 回まで再起動。多重起動は抑止。
+  $set     = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries `
+    -StartWhenAvailable -MultipleInstances IgnoreNew `
+    -RestartInterval (New-TimeSpan -Minutes 1) -RestartCount 3 `
+    -ExecutionTimeLimit (New-TimeSpan -Seconds 0)
   Register-ScheduledTask -TaskName $TASK_NAME -Action $action -Trigger $trigger -Settings $set `
     -RunLevel Limited -Force | Out-Null
-  Write-Ok "Logon task '$TASK_NAME' registered"
+  Write-Ok "Logon task '$TASK_NAME' registered (keeps WSL distro alive)"
 }
 
 # Run the existing install.sh inside WSL.
@@ -315,6 +333,16 @@ function Main {
   # --- autostart ---
   Register-BootTask $distro $user
 
+  # セットアップ完了時点でオンライン化まで完結させる: keep-alive タスクを今すぐ起動し、
+  # distro を起動状態に保つ (再ログオンを待たずに hub-agent が常駐する)。
+  Write-Step "Starting keep-alive now (online without re-logon)"
+  try {
+    Start-ScheduledTask -TaskName $TASK_NAME
+    Write-Ok "Keep-alive started; hub-agent should come online shortly"
+  } catch {
+    Write-Warn "Start-ScheduledTask failed ($($_.Exception.Message)); ログオンし直すと起動します"
+  }
+
   Write-Host ""
   Write-Ok "Setup complete. Check the online status in the Hub UI:"
   Write-Host "    https://hub.cocorograph.com/user/cockpit/agents" -ForegroundColor Cyan

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,
 }