@mateusbmp/backup-manager 0.2.1 → 0.2.2

package/README.md

@@ -145,6 +145,11 @@ journalctl --user -u bkm -f      # scheduler and job log
   boot and keep running after you log out. On most systems this needs no root. If your
   system refuses it, the install still succeeds, with a warning that the service only runs
   while you are logged in.
+- **No user session (`su`, `sudo -u`, some SSH setups):** `systemctl --user` needs
+  `XDG_RUNTIME_DIR`. If it is missing, bkm takes it (and the D-Bus address) from
+  `/run/user/<uid>` itself. If no user manager is running at all, the error says so: log in
+  as that user directly (`ssh user@host`), or have an administrator run
+  `sudo loginctl enable-linger <user>` once, then retry.
 - **Upgrades:** the unit stores absolute paths to `node` and `bkm`. If either one moves
   (an nvm upgrade or a reinstall), `bkm doctor` and the UI flag the unit as **outdated**.
   Choose **Install / update** on the Service screen to rewrite it.
@@ -467,7 +472,7 @@ JSON config validated by zod. npm.
 - Backups: `core/backup/pipeline.ts` (one env; `.tmp-<id>` → manifest → rename; auto-prune), `mariadb.ts`, `archive.ts`, `catalog.ts`, `retention.ts` (pure), `prune.ts`, `lock.ts`.
 - Jobs: `core/jobs/store.ts` (JSON status), `events.ts` (NDJSON), `runner.ts` (`startJob` spawns `bkm __job`: detached from the UI, a normal child from the daemon; `executeJob` runs it).
 - Daemon: `core/daemon/` (scheduler, catch-up via `schedule.json`, reload on file change or SIGHUP, graceful stop) + `src/api/server.ts`.
-- systemd: `core/service/` — every systemctl/journalctl/loginctl call goes through the injectable `CommandRunner` in `systemctl.ts`, always `--user`, never sudo, never a shell.
+- systemd: `core/service/` — every systemctl/journalctl/loginctl call goes through the injectable `CommandRunner` in `systemctl.ts`, always `--user`, never sudo, never a shell; `execRunner` fills a missing `XDG_RUNTIME_DIR`/`DBUS_SESSION_BUS_ADDRESS` from `/run/user/<uid>` (`userBusEnv`).
 - UI: `src/ui/App.tsx` (frame, routing, global keys, toasts, modals), `screens/`, `components/` (Form, TextField, ScrollList/ScrollView, Panel), `hooks/` (usePolling, useJobEvents). `ui/print/` renders doctor output for the CLI.
 
 ## Conventions

package/dist/cli.js

@@ -6458,11 +6458,24 @@ import path18 from "path";
 
 // src/core/service/systemctl.ts
 import { execFile } from "child_process";
+import { existsSync } from "fs";
+function userBusEnv(env = process.env, uid = process.getuid?.() ?? null, exists = existsSync) {
+  const out = { ...env };
+  if (!out.XDG_RUNTIME_DIR && uid !== null) {
+    const dir = `/run/user/${uid}`;
+    if (exists(dir)) out.XDG_RUNTIME_DIR = dir;
+  }
+  if (!out.DBUS_SESSION_BUS_ADDRESS && out.XDG_RUNTIME_DIR) {
+    const bus = `${out.XDG_RUNTIME_DIR}/bus`;
+    if (exists(bus)) out.DBUS_SESSION_BUS_ADDRESS = `unix:path=${bus}`;
+  }
+  return out;
+}
 var execRunner = (command, args) => new Promise((resolve) => {
   execFile(
     command,
     args,
-    { timeout: 3e4, maxBuffer: 4 * 1024 * 1024 },
+    { timeout: 3e4, maxBuffer: 4 * 1024 * 1024, env: userBusEnv() },
     (error, stdout, stderr) => {
       const err = error;
       if (err && err.code === "ENOENT") {
@@ -6548,6 +6561,10 @@ function renderUnit({ command, configPath }) {
 }
 
 // src/core/service/manager.ts
+function busHint(message, user) {
+  if (!/Failed to connect to bus|XDG_RUNTIME_DIR not defined/i.test(message)) return message;
+  return `${message} \u2014 no systemd user session for ${user}: log in as ${user} directly (e.g. \`ssh ${user}@host\`, not \`su\`/\`sudo -u\`), or have an administrator run \`loginctl enable-linger ${user}\` once, then retry`;
+}
 var ServiceError = class extends Error {
   name = "ServiceError";
 };
@@ -6599,7 +6616,10 @@ var ServiceManager = class {
     if (show.code !== 0) {
       return {
         ...base,
-        error: (show.stderr || show.stdout).trim() || `systemctl exited with ${show.code}`
+        error: busHint(
+          (show.stderr || show.stdout).trim() || `systemctl exited with ${show.code}`,
+          this.user
+        )
       };
     }
     const p = parseProperties(show.stdout);