robot-resources 1.9.5 → 1.9.7

package/lib/service.js

@@ -216,6 +216,28 @@ WantedBy=default.target
 `;
 }
 
+/**
+ * Check whether linger is enabled for the current user.
+ *
+ * Without linger, systemd-user services are torn down when the user logs
+ * out (SSH disconnect, login manager logout). On the Finland signup
+ * (2026-04-23) this was the root cause: 3 heartbeats, then session ended,
+ * then the router died with the session.
+ */
+function isLingerEnabled() {
+  try {
+    const user = process.env.USER || process.env.LOGNAME;
+    if (!user) return false;
+    const res = spawnSync('loginctl', ['show-user', user, '--property=Linger'], {
+      stdio: 'pipe', encoding: 'utf-8',
+    });
+    if (res.status !== 0) return false;
+    return /^Linger=yes\s*$/m.test(res.stdout || '');
+  } catch {
+    return false;
+  }
+}
+
 function installSystemdUser(venvPythonPath) {
   const unitPath = getUserUnitPath();
   const logsDir = join(homedir(), '.robot-resources', 'logs');
@@ -232,12 +254,17 @@ function installSystemdUser(venvPythonPath) {
   execSync('systemctl --user enable robot-resources-router.service', { stdio: 'pipe' });
   execSync('systemctl --user start robot-resources-router.service', { stdio: 'pipe' });
 
-  // Enable linger so the service survives SSH disconnects (critical for VMs)
+  // Enable linger so the service survives SSH disconnects (critical for VMs).
+  // On many distros this needs polkit auth and silently no-ops from a
+  // non-interactive shell — we attempt it then VERIFY the result.
+  let lingerEnabled = false;
   try {
     execSync('loginctl enable-linger', { stdio: 'pipe' });
   } catch {
-    // Non-fatal — linger may not be available (e.g. no loginctl)
+    // fall through to verification
   }
+  lingerEnabled = isLingerEnabled();
+  return { lingerEnabled };
 }
 
 function uninstallSystemdUser() {
@@ -603,8 +630,29 @@ export function installService(venvPythonPath) {
     }
 
     // mode === 'user'
-    installSystemdUser(venvPythonPath);
-    return { type: 'systemd-user', path: getUserUnitPath() };
+    const { lingerEnabled } = installSystemdUser(venvPythonPath);
+
+    // Belt-and-suspenders: ALSO install crontab @reboot so the router comes
+    // back on reboot even if linger isn't taking effect (polkit denied,
+    // container restrictions, etc.). Idempotent — removes any existing
+    // RR crontab entry before adding the fresh one. Safe to call even
+    // when crontab is absent (we skip silently).
+    let crontabFallback = false;
+    if (hasCrontab()) {
+      try {
+        installCrontab(venvPythonPath);
+        crontabFallback = true;
+      } catch {
+        // Non-fatal — systemd-user still works while user is logged in.
+      }
+    }
+
+    return {
+      type: 'systemd-user',
+      path: getUserUnitPath(),
+      lingerEnabled,
+      crontabFallback,
+    };
   }
 
   if (process.platform === 'win32') {
@@ -624,10 +672,12 @@ export function installService(venvPythonPath) {
 export function uninstallService() {
   if (process.platform === 'darwin') return uninstallLaunchd();
   if (process.platform === 'linux') {
-    // Clean up whichever variant is installed.
-    if (existsSync(SYSTEM_UNIT_PATH)) return uninstallSystemdSystem();
-    if (existsSync(getUserUnitPath())) return uninstallSystemdUser();
-    if (isCrontabInstalled()) return uninstallCrontab();
+    // Clean up whatever variants are installed. systemd-user users may
+    // also have a crontab belt installed alongside — remove both.
+    if (existsSync(SYSTEM_UNIT_PATH)) uninstallSystemdSystem();
+    if (existsSync(getUserUnitPath())) uninstallSystemdUser();
+    if (isCrontabInstalled()) uninstallCrontab();
+    return;
   }
   if (process.platform === 'win32') return uninstallTaskScheduler();
 }

package/lib/wizard.js

@@ -9,6 +9,22 @@ import { installService, isServiceRunning, isServiceInstalled } from './service.
 import { configureToolRouting, registerScraperMcp, restartOpenClawGateway } from './tool-config.js';
 import { checkHealth } from './health-report.js';
 import { header, step, success, warn, error, info, blank, summary } from './ui.js';
+
+// Stamped onto every CLI telemetry payload so we can tell which `robot-resources`
+// version a user actually ran. Without this, npx-cached old installers look
+// identical to fresh runs in Supabase — which is exactly the visibility gap
+// that left us blind on real-user install failures despite shipping rich
+// diagnostics in PR #163. Read once at module load; safe to fail (telemetry
+// just lands without the field).
+const CLI_VERSION = (() => {
+  try {
+    return JSON.parse(
+      readFileSync(new URL('../package.json', import.meta.url), 'utf-8'),
+    ).version;
+  } catch {
+    return null;
+  }
+})();
 /**
  * Classify an install error into a short reason code + bounded detail string.
  *
@@ -83,6 +99,8 @@ export async function runWizard({ nonInteractive = false } = {}) {
     // "pip installed but router never served a request" from a real
     // working setup in post-hoc telemetry.
     serviceType: null,
+    lingerEnabled: null,
+    crontabFallback: null,
     pluginInstalled: false,
     openclawDetected: false,
     openclawConfigPatched: false,
@@ -163,6 +181,7 @@ export async function runWizard({ nonInteractive = false } = {}) {
           product: 'cli',
           event_type: 'wizard_started',
           payload: {
+            cli_version: CLI_VERSION,
             auth_method: results.authMethod,
             non_interactive: nonInteractive,
           },
@@ -235,12 +254,24 @@ export async function runWizard({ nonInteractive = false } = {}) {
       try {
         const svc = installService(getVenvPythonPath());
         results.serviceType = svc.type || null;
+        // systemd-user only survives user sessions with linger enabled; the
+        // installer now verifies the bit actually flipped and installs a
+        // crontab @reboot belt when it didn't. Capture both signals so we
+        // can tell which users land on a live-forever setup vs one that
+        // dies on logout.
+        results.lingerEnabled = svc.lingerEnabled ?? null;
+        results.crontabFallback = svc.crontabFallback ?? null;
         if (svc.type === 'skipped') {
           warn(svc.reason);
           results.service = false;
         } else {
           success(`Router registered as ${svc.type} service`);
           info(`Config: ${svc.path}`);
+          if (svc.type === 'systemd-user') {
+            if (svc.lingerEnabled) info('Linger enabled — router survives logout');
+            else warn('Linger not enabled — router may stop when you log out');
+            if (svc.crontabFallback) info('Crontab @reboot installed as fallback');
+          }
           info('Router will start automatically and restart on crash');
           results.service = true;
         }
@@ -410,6 +441,7 @@ export async function runWizard({ nonInteractive = false } = {}) {
       // another event.
       const installPayload = {
         source: 'wizard',
+        cli_version: CLI_VERSION,
         router: results.router || false,
         service: results.service || false,
         scraper: results.scraper || false,
@@ -419,6 +451,8 @@ export async function runWizard({ nonInteractive = false } = {}) {
         install_duration_ms: Date.now() - wizardStartMs,
         python_source: results.pythonSource ?? null,
         service_type: results.serviceType ?? null,
+        linger_enabled: results.lingerEnabled,
+        crontab_fallback: results.crontabFallback,
         health_check: results.healthCheck,
         plugin_installed: results.pluginInstalled,
         openclaw_detected: results.openclawDetected,
@@ -540,10 +574,9 @@ export async function runWizard({ nonInteractive = false } = {}) {
     try {
       const statusDir = join(homedir(), '.robot-resources');
       mkdirSync(statusDir, { recursive: true });
-      const pkgVersion = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf-8')).version;
       writeFileSync(join(statusDir, 'wizard-status.json'), JSON.stringify({
         completed_at: new Date().toISOString(),
-        version: pkgVersion,
+        version: CLI_VERSION,
         router: results.router || false,
         service: results.service || false,
         scraper: results.scraper || false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "robot-resources",
-  "version": "1.9.5",
+  "version": "1.9.7",
   "description": "Robot Resources — AI agent tools. One command to install everything.",
   "type": "module",
   "bin": {