@cocorograph/hub-agent 0.6.77 → 0.6.78

package/package.json

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

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