@mateusbmp/backup-manager 0.1.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.
@@ -259,7 +264,7 @@ Every key (generated from the schema):
 │   Doctor         │ │ ✔ production  20261109-033000  complete   1.6 GiB  9h ago    │
 │   Settings       │ ╰──────────────────────────────────────────────────────────────╯
 ╰──────────────────╯
- ↑↓ move  ⏎ backups  r run now  n new backup  e environments  tab pane  ? help  q quit
+ ↑↓ move  ⏎ backups  r run now  n new backup  e environments  ctrl+←↓→ zones  ? help  q quit
 ```
 
 | Screen                 | What you can do                                                                                                                                                                  |
@@ -280,6 +285,13 @@ Every key (generated from the schema):
 field) · `1`–`9` jump to a menu entry · `n` new backup · `e` environments · `s` service ·
 `Ctrl-S` saves a form · `?` help · `q` quit.
 
+**Buttons and zones:** every action on the footer line is also a button. `Ctrl+↓` focuses
+the footer as a button bar (`[ save ] [ cancel ] …`); `←→` picks a button, `⏎` presses it,
+and `Esc` or `↑` returns. `Ctrl+←` focuses the sidebar, and `Ctrl+→` or `Ctrl+↑` returns to
+the content. `Alt` works in place of `Ctrl`. Use these in terminals that swallow chords
+like `Ctrl-S` (Termius, or any terminal with XON/XOFF flow control): every form can be
+saved with its **save** button, and screens you reached from another one get a **back** button.
+
 Below 90 columns the sidebar becomes a tab bar, and below 60×16 the UI asks you to resize.
 `NO_COLOR` is honored.
 
@@ -460,12 +472,13 @@ 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
 
 - Ink: colors only from `ui/theme.ts`; gate every `useInput` with `isActive` (`useScreenActive()`); forms take the keyboard via `useCaptureKeys`; size from the App context (`width`/`height`), not ad-hoc.
+- Actions: declare each screen action once with `useHints([{ key, label, run }])`. The footer shows it as a hint, and as a button once Ctrl/Alt+↓ focuses the bar, so the key handler and the button share one function. Ctrl/Alt+arrows belong to App's zone switching: arrow handlers ignore them (`isZoneKey`; `isUp`/`isDown` already do).
 - Tests: vitest + ink-testing-library (100 columns; send a no-op key after mount and wait before keys; match frames after `stripVTControlCharacters`, since CI forces color). Temp dirs via `tests/helpers.ts`; fake `mariadb-dump` (`installFakeDump`) and fake systemd (`fakeSystemd`).
 - Every behavior change needs tests; keep README (and this block) in sync in the same change.