LordOS — a free, fast and secure GNU/Linux distribution based on Debian, with its own desktop environment: display server and Wayland compositor in C, a React UI engine on QuickJS, and private native apps.
C cdebiandesktop-environmentebpffirewalllandlocklinuxlinux-distributionopen-sourceprivacyquickjsraspberry-pi-5reactsecuritywaylandwayland-compositor
Docs audit (part 3): ARCHITECTURE, FILES, SETTINGS, ISO, SIGNING, MEDIA, PASSWORDS, EDITOR, PRINTING, FANS, TRACKPAD, FIREWALL, ROADMAP, INSTALL-DEBIAN, RELEASING and PAPER-VALIDATION checked against the code and CHANGELOG
Federico Pereira8bbbed1d227f
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.mdindex 4515be1..7a62f3d 100644--- a/docs/ARCHITECTURE.md+++ b/docs/ARCHITECTURE.md@@ -31,7 +31,7 @@ like React Native but on top of our display server.| `server/src/ui/` | **M2 done** | Nodes, styles, flexbox, text, images, painting, damage, QuickJS || `runtime/` | **M2 done** | React renderer (`@lordos/runtime`): a host config for the stock `react-reconciler` package, CSS → native, events || `themes/default/` | **M2 done** | Theme with a menu bar, a dock and an app launcher, with our own assets |-| `server/src/ui/js_sys.c` | **M3 done** | System APIs: fs (in `$HOME`), /proc, settings, themes, session |+| `server/src/ui/js_sys.c` | **M3 done** | System APIs: fs (writes in the home folder and the user's mounts; since 0.8.5 reads the whole tree except `/proc`, `/sys`, `/dev`, `/run`), /proc, settings, themes, session || `sdk/` | **M3 done** | `@lordos/sdk`: windows, settings, tokens, controls, system hooks || `apps/` | **M3 done** | Apps as packages (`manifest.json` + `index.jsx`), independent of the theme || `themes/classic/` | **0.8.3 done** | Second full appearance (taskbar, start menu, snapping, task view) and a base for new themes |@@ -54,12 +54,12 @@ like React Native but on top of our display server.| `server/src/media/hwdec.c`, `sdk/video.js`, `assets/browser/video/` | **0.8.2** | Video in the browser without hardware decoding: per-boot VP9/AV1 decoding probe, the closed admin action `video-optimize` and LordOS's own Chromium extension that asks YouTube for H.264 and offers a lower quality when video stutters (see `VIDEO.md`) || `server/src/fan/`, `js_fan.c`, `sdk/cooling.jsx` | **M8** | Fans: the root service `lord-fand` drives them by temperature; Settings → Cooling and Monitor → Cooling (see `FANS.md`) || `server/src/monitor/`, `js_monitor.c`, `apps/monitor/` | **M8** | Monitor: CPU, memory, network, disks, processes and per-app connections with a map; its own thread only while the app is open, sock_diag and country by IP from a local database (see `MONITOR.md`) |-| `server/src/vault/`, `js_vault.c`, `sdk/vault.js`, `apps/passwords` | **M9** | Passwords and the system keyring: the sandboxed helper `lord-vault` (Monocypher: XChaCha20-Poly1305, Argon2id), own `.lvault` format, FIDO2/CTAP2 client, session keyring opened at login, Secret Service on D-Bus with own code (see `PASSWORDS.md`) |+| `server/src/vault/`, `js_vault.c`, `sdk/vault.js`, `apps/passwords` | **M9** | Passwords and the system keyring (the Passwords UI runs as its own isolated process): the sandboxed helper `lord-vault` (Monocypher: XChaCha20-Poly1305, Argon2id), own `.lvault` format, FIDO2/CTAP2 client, session keyring opened at login, Secret Service on D-Bus with own code (see `PASSWORDS.md`) || `server/src/net/netd.c`, `remote/netsup.c` | **M9** | `lord-netd`: the network belongs to the system. A root service started and supervised by `lord-sessiond` at boot, serving the `net-*` actions for every session (see `NETWORK.md`) || `server/src/disk/`, `js_disk.c`, `sdk/disks.js`, `apps/disks` | **M9** | Disks: listing without root (sysfs, udev database, mountinfo), our own SMART reader (ATA PASS-THROUGH over SG_IO, NVMe health log), closed `disk-*` actions, bootable USB verified with SHA-256 (see `SYSTEM.md`) || `server/src/imager/`, `server/src/firstrun/`, `js_imager.c`, `apps/imager`, `desktop/imager` | **0.8.4** | LordOS Imager: verified image → removable drive (`imager-*` actions, `xz` and `curl` as the user), the Raspberry Pi first-run file and its applier `lordos-firstrun`, and the same UI as a Tauri app for other computers (see `IMAGER.md`) || `server/src/fw/fwlists.c`, `fwsub.c`, `server/src/fetch/`, `server/src/sec/netconn.c`, `apps/monitor/NetTree.jsx`, `Blocklists.jsx`, `sdk/netmodel.js`, `sdk/netstatus.jsx` | **0.8.5** | Monitor → Network, second generation: blocklists (the sandboxed downloader `lord-fetch`, compiled into lord-netperm's maps), the deny mode, LordOS's components in their own scopes (the `--net-connector` processes), the system services' traffic, the tree, chips and view menu, the menu bar network item (see `MONITOR.md`, `FIREWALL.md`) |-| `server/src/mail/`, `js_mail.c`, `sdk/{mail,calendar,contacts}.js`, `apps/{mail,calendar,contacts,reminders}` | **M9** | Mail, Calendar, Contacts and Reminders: the sandboxed helper `lord-maild` (IMAP with IDLE/CONDSTORE, SMTP, CalDAV/CardDAV, OpenSSL) with no sockets of its own — `lord-server` connects only to configured servers and hands it the fd; own MIME, HTML sanitizer, iCalendar, vCard and XML parsers (see `MAIL.md`) |+| `server/src/mail/`, `js_mail.c`, `sdk/{mail,calendar,contacts}.js`, `apps/{mail,calendar,contacts,reminders}` | **M9** | Mail, Calendar, Contacts and Reminders (each app an isolated process since 0.8.2): the sandboxed helper `lord-maild` (IMAP with IDLE/CONDSTORE, SMTP, CalDAV/CardDAV, OpenSSL) with no sockets of its own — `lord-server` connects only to configured servers and hands it the fd; own MIME, HTML sanitizer, iCalendar, vCard and XML parsers (see `MAIL.md`) || `server/src/backup/`, `js_backup.c`, `sdk/backup.js`, `apps/backup` | **M9** | Backups: hard-link snapshots in a lord-server thread (nice 19, idle I/O), hourly/daily/weekly retention, optional encryption with the vendored Monocypher; no root and no `admin.c` actions (see `SYSTEM.md`) || `server/src/logs/`, `js_logs.c`, `sdk/logs.js`, `apps/logs` | **M9** | Logs: our own systemd journal reader (no libsystemd), LordOS logs, system logs for admins through a closed action, live follow with inotify (see `SYSTEM.md`) || `server/src/ui/tzif.c`, `js_help.c`, `sdk/{notify,alarms,statusitems,help}.js`, `apps/{clock,help}` | **M9** | Clock (our own TZif reader, session alarms with the app closed), session notifications, menu-bar status items, Help (markdown articles in es/en/pt, welcome tour, Search source) (see `SYSTEM.md`) |@@ -87,7 +87,7 @@ Besides the kernel and libc, only these are allowed:| Mesa: `libgbm`, `libEGL`, `libGLESv2` | GPU composition and dmabuf buffers from apps (games); optional: without a 3D GPU or without the `-dev` packages it builds and runs without Mesa (approved by the user on 2026-10-16, see `GPU.md`) | system || QuickJS | ES2023 JavaScript engine, ~1 MB, written in C | vendored|| `stb_truetype`, `stb_image` | fonts and images; public domain, a single header | vendored|-| `stb_image_write` | PNG for the remote desktop's lossless refresh of still areas and cursor images (`lord-sessiond` only); public domain | vendored|+| `stb_image_write` | PNG for the remote desktop's lossless refresh of still areas and cursor images (`lord-sessiond`), and images written by the `lord-doc` and `lord-maild` helpers; public domain | vendored|| OpenSSL (`libssl`, `libcrypto`) | TLS. **Only three binaries link it**: `lord-sessiond` (remote desktop on the LAN, `REMOTE.md`), `lord-maild` (IMAP/SMTP/CalDAV/CardDAV, certificates checked against the system CA store, `MAIL.md`) and (0.8.5) `lord-fetch` (the blocklist downloads, sandboxed, no sockets of its own, `FIREWALL.md` "Blocklists"). Never `lord-server` | system || `libcrypt` | verifying passwords against `/etc/shadow` (`lord-sessiond`, `admin.c`) | system || `libsrtp2`, `usrsctp` | the remote desktop's video (WebRTC, 0.8.4): SRTP and the data channels' SCTP, in `lord-sessiond`'s bridge only (as the user, after it dropped root); with OpenSSL's DTLS and our own ICE-lite, SDP and RTP code (`remote/rtc.c`, `remote/rtcwire.c`) because Debian 13 packages no libdatachannel. Required for `lord-sessiond` since the remote desktop shows the screen only over WebRTC (the image path was removed in 0.8.4). Never `lord-server` | system |@@ -96,7 +96,7 @@ Besides the kernel and libc, only these are allowed:| `clang` (build time only) | the BPF programs of `lord-netperm` (`np.bpf.c`, `clang -target bpf`); they are embedded in the binary. Without clang (`BPF=0`) the service runs without BPF. Neither libbpf nor bcc is used | build machine || Monocypher 4.0.2 | XChaCha20-Poly1305, Argon2id/Argon2d, BLAKE2b, ChaCha20 for the Passwords vault and the KeePass importer (approved by the user; CC0/BSD-2, one C file). **Only `lord-vault` links it**; its official test vectors run in `make test` (`PASSWORDS.md`) | vendored || EFF word list, 10k common passwords | passphrase generator and the offline "breached" check (CC BY 3.0 US / MIT), embedded in `lord-vault` | `third_party/wordlists` |-| Inter, JetBrains Mono | interface and terminal fonts (OFL) | `assets/fonts` |+| Inter, Plus Jakarta Sans, JetBrains Mono | interface, display and terminal fonts (OFL) | `assets/fonts` |**Xwayland** (Debian's `xwayland` package, 0.8.3) is not linked by anything: it is a separateprogram that `lord-server` starts on demand for X11 apps (`WAYLAND.md`, "X11 apps (Xwayland)").@@ -108,7 +108,7 @@ with esbuild inside the theme's `.js`. Since 0.7.0 it is React 19.3.1 with `reac(the default theme weighs 367 KB with all the apps; React 18 was ~40 KB less). Node.js is onlyused on the development machine.-Since M8 there are two programs, and since M9 two helpers:+Besides `lord-server`, these programs and helpers run (root services, then sandboxed helpers):- **`lord-netd`** (M9, root): the system network, started and supervised by `lord-sessiond` at boot;only the `net-*` actions of `admin.c`. libc only. See `NETWORK.md`.@@ -200,13 +200,16 @@ Since M7, what LordOS does with its own code and what it delegates to a Debian p- `openvpn`;- `resolvectl` and `networkctl`.- `powerprofilesctl`, `systemctl suspend`/`reload systemd-logind` and `timedatectl` (Settings'- closed `power-*` and `time-*` actions, `SETTINGS.md`).+ closed `power-*` and `time-*` actions, `SETTINGS.md`);+ - `smartctl` (0.8.2, `smart-*` actions) and, on the Raspberry Pi 5, `rpi-eeprom-update` (0.8.4.1,+ Settings → Board firmware).- **Sound server:** PipeWire, over the PulseAudio protocol.-apt, libapt, gpgv, curl, zlib, liblzma, NetworkManager, wireguard-tools, libpulse,-libpipewire, libcups, avahi-client and SANE are not used.+apt, libapt, gpgv, zlib, liblzma, NetworkManager, wireguard-tools, libpulse,+libpipewire, libcups, avahi-client and SANE are not used. `curl` is used only by LordOS Imager's+`imager-*` actions (0.8.4), run as the user with a fixed path, never linked (`IMAGER.md`).-Forbidden: X11/Xorg, wlroots, libdrm, libinput, Mesa as a requirement (only as the optional GPU path), WebKit/Chromium,+Forbidden: X11/Xorg (Xwayland is a separate program started on demand, see above), wlroots, libdrm, libinput, Mesa as a requirement (only as the optional GPU path), WebKit/Chromium,GTK/Qt inside LordOS; bubblewrap, flatpak, firejail or libseccomp for isolation (it isour own code using Landlock and seccomp-bpf directly). Vendored = copied as source code into `third_party/`.@@ -215,7 +218,7 @@ our own code using Landlock and seccomp-bpf directly). Vendored = copied as sour| Architecture | Machines | Status | Image ||---|---|---|---|| x86-64 (amd64) | PC with UEFI or BIOS; AMD, Intel or Nvidia GPU, or no 3D GPU (CPU) | primary, tested on VM | live ISO with installer (`ISO.md`) |-| ARM64 (aarch64) | **Raspberry Pi 5** (the only supported board) | ready, not tested on the board | SD/NVMe image, `tools/rpi/build-img.sh` (`RASPBERRY.md`) |+| ARM64 (aarch64) | **Raspberry Pi 5** (the only supported board) | tested on the board (`RASPBERRY.md`, release tests in `ISO.md`) | SD/NVMe image, `tools/rpi/build-img.sh` (`RASPBERRY.md`) |The code is the same. The differences:@@ -265,9 +268,13 @@ other bundle; settings persist on disk.## Security-- `lord-server` starts with sudo only to open DRM, evdev and the console; right away it switches to the- session user (`SUDO_USER` or `--user`), keeping only `CAP_SYS_TTY_CONFIG`.-- `lord.fs` is read-only and rejects paths that (after `realpath`) leave `$HOME`.+- In a session, `lord-server` runs as the user, started by `lord-sessiond`, which lends it the DRM and+ input devices (`SESSIONS.md`). Run on its own for development, it starts with sudo only to open+ DRM, evdev and the console; right away it switches to the session user (`SUDO_USER` or `--user`), keeping only `CAP_SYS_TTY_CONFIG`.+- `lord.fs` writes only in the home folder and the user's mounts (after `realpath`), with a deny list+ of folders the system reads to launch or install something or that store a security decision;+ since 0.8.5 its reading calls reach the whole tree as the user, except `/proc`, `/sys`, `/dev` and+ `/run` (`FILES.md`).- `lord.settings` only writes `~/.config/lordos/settings.json` (max. 64 KB, atomic write).- `lord.themes.use` only accepts plain folder names in `themes/`; a theme that failsto load is banned to avoid loops.@@ -275,13 +282,17 @@ other bundle; settings persist on disk.`code-manifest.json`, signed with the release key and checked by lord-server at load time from thesame read that is evaluated (`server/src/sec/codesig.c`, `SIGNING.md`, "Verified system code").A modified bundle is not run: another theme, or the built-in recovery screen.-- There is no API to run arbitrary commands. The only way to start a process is+- There is no API to run arbitrary commands. JS can start a process only through`lord.term.create()`, which launches the user's own login shell (the one in `/etc/passwd`)- with no capabilities and no `SUDO_*` variables, just like any terminal emulator.+ with no capabilities and no `SUDO_*` variables, just like any terminal emulator;+ `lord.apps.launch(id)` and its variants, which run only the `Exec` line of an installed `.desktop`+ without a shell (`WAYLAND.md`); and `lord.apps.launchPackage(id)`, which starts an installed `.lpk`+ as an isolated process (`PRIVACY.md`).- The clipboard belongs to the session (in memory). Terminal programs can write it(OSC 52) but not read it.-- Manifest `permissions` are declarative until there is per-app isolation.-- External Wayland apps (M5) will only see their own surfaces.+- Manifest `permissions` are enforced since M8: each `.lpk` runs isolated and the broker checks every+ call against the user's decisions (`PRIVACY.md`).+- External Wayland apps (M6) only see their own surfaces.- Documents that come from outside (PDFs, archives, fonts, scanner images) are openedonly in `lord-doc`, sandboxed. A malicious file can bring that process down, but not`lord-server`. Extracting never writes outside the destination folder (`DOCUMENTS.md`, «Extractingdiff --git a/docs/EDITOR.md b/docs/EDITOR.mdindex 47babf5..ec2bf5b 100644--- a/docs/EDITOR.md+++ b/docs/EDITOR.md@@ -114,14 +114,15 @@ For the editor, these were added to the system:- **`fontFamily: 'monospace'`** in the engine (`style.c` and `text.c`; JetBrains Mono is loadedthe first time it is used). The runtime used to drop `fontFamily`.- **`lord.fs.write`, `mkdir` and `rename`** (`server/src/ui/js_sys.c`):- - only inside the home folder, with the destination folder resolved with `realpath`;+ - only inside the home folder (and, later, the user's mounts in `/media/$USER` and+ `/run/media/$USER`), with the destination folder resolved with `realpath`;- they don't follow symlinks on the final file;- writing is atomic (temporary file in the same folder + `fsync` + `rename`) and keeps thepermissions;- up to 32 MB;- they can't touch `~/.local/share/applications`, `~/.config/autostart`,- `~/.local/share/lordos/apps` or `~/.config/lordos/settings.json`, not even through a symlink- (tested): JS can't create a `.desktop` file, which is the only thing `lord.apps.launch` runs.+ `~/.local/share/lordos/apps` or `~/.config/lordos/settings.json` (nor the other protected+ files and folders added since, `FILES.md`), not even through a symlink (tested): JS can't create a `.desktop` file, which is the only thing `lord.apps.launch` runs.## Performance (measured)diff --git a/docs/FANS.md b/docs/FANS.mdindex 5793a15..8fdf942 100644--- a/docs/FANS.md+++ b/docs/FANS.md@@ -238,7 +238,7 @@ case gets nothing Argon-specific. The illustration shows the Argon only after it| `dtoverlay=dwc2,dr_mode=host` (front USB, audio) | `rpi-case argon-one-v5` → `lordos-case.txt` || `dtparam=nvme`, `pciex1_gen=3` | already in the LordOS image's `config.txt` || `usb_max_current_enable=1` | **not set**: it lets the board draw 1.6 A for USB, which is only safe with a 5 A supply; documented here instead |-| `PSU_MAX_CURRENT=5000` in the bootloader EEPROM | **not done**: LordOS does not rewrite the EEPROM (later, if ever, as a separate admin action) |+| `PSU_MAX_CURRENT=5000` in the bootloader EEPROM | **not done**: LordOS does not change the bootloader configuration (Settings → Board firmware, 0.8.4.1, only applies Raspberry Pi's bootloader updates, never `rpi-eeprom-config`) || Power button daemon (GPIO 4 pulses) | not needed on the V5: the Raspberry Pi 5's own power button is handled by systemd-logind (Settings → Energy) || IR remote (LIRC, `gpio-ir` on GPIO 23) | not on the V5 (not in its feature list); left for a case that has it || OLED module, ZigBee module (optional add-ons) | not supported |@@ -267,8 +267,9 @@ case gets nothing Argon-specific. The illustration shows the Argon only after it## Not done or untested-- The installed `.deb` and the unit on the real Raspberry Pi (tested with the unit's properties- through `systemd-run`, not as the packaged `lord-fand.service`).+- The fan curve under the packaged `lord-fand.service` on the real Raspberry Pi: the packaged unit+ runs there (the 0.8.4 update restarted it, `ISO.md`, "Release test (0.8.4 Beta)"), but the+ measurements above were taken with the unit's properties through `systemd-run`.- Real PC motherboards (`nct67xx`, `it87`) and laptops: fake sysfs only.- The `rpi-case` action on the real board (it writes the boot partition; not run on the user'scard) and the case's front USB ports and DAC with `dwc2` in host mode.diff --git a/docs/FILES.md b/docs/FILES.mdindex 913c389..ac92468 100644--- a/docs/FILES.md+++ b/docs/FILES.md@@ -148,8 +148,10 @@ drop, color tags and search. Disk operations belong to the server (`server/src/fmode. Isolated `.lpk` apps don't get this: their broker only reaches their own data folder.«Open with» and the helpers keep the home folder and the user's mounts.- Writing, copying to, moving and sending to the Trash reject the protected folders- (`~/.local/share/applications`, `~/.config/autostart`, `~/.local/share/lordos/apps` and- `~/.config/lordos/settings.json`). Copying *from* them is allowed.+ (`fsops_protected`: `~/.local/share/applications`, `~/.config/autostart`,+ `~/.local/share/lordos/apps`, `~/.config/lordos/settings.json`, the permission and firewall+ decisions `permisos.json` and `firewall.json`, the blocklists (0.8.5), `backup.json`, the Mail+ accounts and cache, and the Passwords vaults). Copying *from* them is allowed.- There is no general `remove`.## «Open with» a Linux app: `lord.apps.launchWith(id, path)`@@ -186,7 +188,6 @@ file:- Selection rectangle by dragging on empty space.- PDF, video and SVG thumbnails in the icon view (PDF already shows in Quick Preview); app icons perfile type.-- Ejecting disks (needs an `admin.c` action or udisks).- Watching folders with inotify: today the view reloads on re-entering or after one of its ownoperations.- The status bar and the path bar end up behind the Dock with the window maximized, as on otherdiff --git a/docs/FIREWALL.md b/docs/FIREWALL.mdindex 88a51eb..36cb447 100644--- a/docs/FIREWALL.md+++ b/docs/FIREWALL.md@@ -8,10 +8,10 @@ access" permission on Android and other systems. It is built in steps:| 1 | Rule store, the decision maker and the names learned from DNS (`server/src/fw`), with tests | **done** || 2 | Enforce it in the kernel with cgroup hooks: the root service `lord-netperm` (`server/src/netperm`) | **done** (VM 122) || 3 | Monitor: the "Rule" column and the counters | **done**: per-app switch, counters and "Allow / Block this domain" per destination |-| 4 | Settings: "Trusted apps" and "Restricted apps" | **done**: lists and mode (silent / off) |+| 4 | Settings: "Trusted apps" and "Restricted apps" | **done**: lists and mode (silent / off; deny since 0.8.5) || 4b | Settings: network rules by app (domains, addresses, networks) | **done** (VM 122), see [Rules by app](#rules-by-app-settings-and-monitor) || 5 | "Ask" mode | planned (see "The ask mode") |-| 0.8.5 | Blocklists, the deny mode, LordOS's components and the system services as their own apps | **done** (VM 118), see [Blocklists](#blocklists-084), [components](#lordos-components-in-their-own-scopes-084) |+| 0.8.5 | Blocklists, the deny mode, LordOS's components and the system services as their own apps | **done** (VM 118), see [Blocklists](#blocklists-085), [components](#lordos-components-in-their-own-scopes-085) |Step 1 is C code only, with no daemon and without touching the kernel or the network (step 2,below, is the service that enforces it):@@ -173,7 +173,7 @@ the app gives itself.| | PipeWire guard (`sec/pwguard.c`) | `Video/Source` nodes hidden from the app, its `Stream/Input/Video` streams destroyed | within 1 s | unit test only (no PipeWire camera node on the test VM) || no USB | `lord-netperm`, `cgroup/dev` | `/dev/bus/usb/*` (189), `/dev/hidraw*` (dynamic, from `/proc/devices`), `/dev/ttyACM*` (166), `/dev/ttyUSB*` (188) | at once (next `open`) | `devices.sh` || no Bluetooth | `lord-netperm`, `cgroup/lsm_socket_create` | `socket(AF_BLUETOOTH, …)` → `EPERM` | at once (new sockets) | `tests/fwlinux/bluetooth.sh` |-| no screen capture | by design, and `lord-netperm` | the compositor offers no capture protocol, there's no X server, no screen-cast portal is installed; `/dev/fb*` (29) is denied | always | `tests/fwlinux/screen.sh` |+| no screen capture | by design, and `lord-netperm` | the compositor offers no capture protocol, Xwayland (0.8.3) sees only X windows and a restricted app gets no X display, no screen-cast portal is installed; `/dev/fb*` (29) is denied | always | `tests/fwlinux/screen.sh` || no microphone | PipeWire guard | capture nodes (`Audio/Source*`, `Audio/Duplex`) and their ports hidden, the app's `Stream/Input/Audio` streams destroyed, including a recording already running | within 1 s | `tests/fwlinux/mic.sh` (`pw-record`, `parecord`, `arecord`) || | `lord-netperm`, `cgroup/dev` | ALSA capture PCM nodes (`/dev/snd/pcmC*D*c`, from `/sys/class/sound`): recording from the card without PipeWire | at once (next `open`) | `mic.sh` || no access to your files | the launcher (`apps.c`, `sec/sandbox.c`) | its own user, mount and PID namespace and Landlock (below) | at the next launch | `tests/fwlinux/files.sh` (a probe app, malicious `.desktop` files, `gtk4-print-editor`) |@@ -232,10 +232,15 @@ D-Bus proxy per app in front of the system bus, which isn't built. `no-files` dosystem bus either (see below).**Screen capture.** No Linux app can copy the screen, restricted or not: the compositor-(`wl/wl.c`) offers no screencopy, image-capture or dmabuf-export protocol, Xwayland isn't-supported, and no `xdg-desktop-portal` screen-cast backend is installed, so PipeWire has no screen-node. `screen.sh` checks all four on the running system (`build/wl-globals` lists the globals as-a client sees them), and `no-screen` also denies `/dev/fb*`. If a screen-cast portal backend is+(`wl/wl.c`) offers no screencopy, image-capture or dmabuf-export protocol, and no+`xdg-desktop-portal` screen-cast backend is installed, so PipeWire has no screen node. Since 0.8.3+X11 apps run through Xwayland, which is a Wayland client like any other: an X app can read other X+apps' windows on the shared X display, but never a Wayland or LordOS window (rootless, no root+picture), and a restricted app gets no X display at all (`PRIVACY.md`, "X11 apps"). `screen.sh`+checks the compositor's globals (`build/wl-globals` lists them as a client sees them), the portal+and PipeWire on the running system, and `no-screen` also denies `/dev/fb*`. (Its "no X server+socket" check predates Xwayland: with the session's X socket in place since 0.8.3 that line fails+and needs updating.) If a screen-cast portal backend isever installed, this no longer holds and `screen.sh` fails.**The PipeWire guard (`sec/pwguard.c`).** `lord-server` keeps one connection of its own to the@@ -1449,8 +1454,8 @@ What remains of steps 3 and 4 (the original design; what's done is above, in "`l- **The counters:**- "allowed" and "denied" come from `FwDecision.verdict`;- those with `record = 1` are the ones silent mode leaves for review;- - each connection carries the `verdict` (today fixed at `'allow'`, see `docs/MONITOR.md`,- "Phase 2").+ - each connection carries the `verdict` (fixed at `'allow'` in this design; it is the kernel's+ verdict since step 2, see `docs/MONITOR.md`, "Phase 2").### Step 4: Settings@@ -1458,7 +1463,8 @@ What remains of steps 3 and 4 (the original design; what's done is above, in "`l- **Trusted apps:** `fw_set_trusted`;- **Restricted apps:** `fw_set_restricted`, with a checkbox per restriction from the tableabove.-- **The mode selector:** silent / ask / off.+- **The mode selector:** silent / ask / off (built as silent / off, plus deny in 0.8.5; ask is+ still to come).- **Outside the network:** the non-network restrictions are queried with `fw_blocks` (through`sec/restrict.h`) before `perms.c`, by the broker for isolated apps and by `js_media.c` and`sdk/notify.js` for the built-in apps. Exactly what is enforced where is indiff --git a/docs/INSTALL-DEBIAN.md b/docs/INSTALL-DEBIAN.mdindex 558759e..43dfb05 100644--- a/docs/INSTALL-DEBIAN.md+++ b/docs/INSTALL-DEBIAN.md@@ -12,8 +12,8 @@ curl -fsSL https://lordos.org/install.sh | shThe script asks before changing anything. It reads the answers from the terminal (`/dev/tty`), sothis works even though the script itself comes through a pipe.-> **Status (2026-10-18):** 0.8.0-beta is published, but the repository is still private, so the download from-> GitHub doesn't work publicly yet. Until then, use `--deb` with a package you already have (see+> **Status (2026-10-26):** the latest release is 0.8.4.1-beta, but the repository is still private, so the download from GitHub doesn't work publicly+> yet. Until then, use `--deb` with a package you already have (see> [Testing](#testing)).## Requirements@@ -252,7 +252,7 @@ sudo reboot- `shellcheck -s sh tools/install/install.sh` must be clean (also `-s dash`, Debian's `/bin/sh`).- Release layout the script expects: tag `vX`, assets `SHA256SUMS` (`sha256sum` format), the`lordos_<version>_<arch>.deb` files listed in it (the version inside the name doesn't have to match- the tag), and later `SHA256SUMS.sig`.+ the tag), and `SHA256SUMS.sig` (required: without it the script stops).### Testingdiff --git a/docs/ISO.md b/docs/ISO.mdindex 4583390..28f9517 100644--- a/docs/ISO.md+++ b/docs/ISO.md@@ -20,8 +20,8 @@ erased.- **Linux and other Unix-like systems:**```sh- sha256sum -c lordos-live-0.7.0-amd64.iso.sha256 # or: shasum -a 256 -c …- sudo dd if=lordos-live-0.7.0-amd64.iso of=/dev/sdX bs=4M status=progress conv=fsync+ sha256sum -c lordos-live-0.8.4-amd64.iso.sha256 # or: shasum -a 256 -c …+ sudo dd if=lordos-live-0.8.4-amd64.iso of=/dev/sdX bs=4M status=progress conv=fsync````/dev/sdX` is the whole USB stick (not a partition). On BSD-derived systems it is usually `/dev/rdiskN`: findit with the system disk tool and unmount it first.@@ -315,7 +315,8 @@ What `install-run` validates on the root side, without trusting the interface:- **Wi-Fi:** wpa_supplicant and Intel (iwlwifi), Realtek and Atheros firmware.- **Fonts:** Noto (core, CJK, emoji) and DejaVu; the rest of what M5b needs: libthai-data, skkdicand rime-data-pinyin-simp.-- **Sample Linux apps:** foot and FeatherPad.+- **Linux apps:** Chromium and Firefox ESR (preinstalled browsers that draw their own bar with+ LordOS's window buttons, `WAYLAND.md`), plus foot and FeatherPad as samples.- **X11 apps (0.8.3):** `xwayland`, started by lord-server only when an X11 app connects([WAYLAND.md](WAYLAND.md), "X11 apps (Xwayland)").@@ -359,7 +360,8 @@ previous one is kept with its date: `lordos-live-0.7.0-amd64-20261016-1529.iso`lord-server is compiled with `make -C server GPU=1` (it needs `libgbm-dev libegl-dev libgles-dev`) sothe ISO ships GPU compositing (Mesa; see `GPU.md`).-Measured on VM 116 (4 Xeon Silver 4108 cores, 4 GB): **~8 minutes**, almost all of it downloading and+Measured on VM 116 (4 Xeon Silver 4108 cores, 4 GB) for 0.7.0: **~8 minutes** (14.5 minutes for 0.8.0, see+"Release test (0.8.0 Beta)"), almost all of it downloading andinstalling packages and compressing.| | |@@ -380,7 +382,7 @@ sudo apt-get install -y --no-install-recommends debootstrap squashfs-tools xorri| Package | What for ||---|---|-| `libssl-dev` | compiling `lord-sessiond` (remote desktop TLS); without it, `make` builds only lord-server and `mkdeb.sh` refuses |+| `libssl-dev` | compiling `lord-sessiond` (remote desktop TLS), `lord-maild` (Mail) and, in 0.8.5, `lord-fetch` (the blocklists); without it, `make` builds only lord-server and `mkdeb.sh` refuses || `libpoppler-glib-dev`, `libarchive-dev` | compiling `lord-doc` (PDF and archives); without them `make` skips it and the package ships without a PDF viewer || `libavcodec-dev`, `libavformat-dev`, `libavutil-dev`, `libswscale-dev`, `libswresample-dev` | compiling `lord-media` (video, photos, camera, recorder); without them `make` skips it || `libva-dev` | optional: GPU decoding (VA-API) in `lord-media` |@@ -393,7 +395,8 @@ sudo apt-get install -y --no-install-recommends debootstrap squashfs-tools xorri### lintian-`lintian lordos_0.7.0_amd64.deb` reports no errors. Two warnings remain, on purpose:+`lintian lordos_0.7.0_amd64.deb` reported no errors and two warnings, on purpose (the later release+tests list theirs: 0 errors and 17 known warnings for 0.8.4.1). The two:- **`duplicate-font-file`:** JetBrains Mono ships in `assets/fonts` because the Terminal needs it evenwhen `fonts-jetbrains-mono` isn't installed.@@ -739,13 +742,14 @@ It boots from the CD first.- **Secure Boot:** sign with shim and our own MOK, or with Debian's shim plus a signed grub. TodaySecure Boot has to be turned off.-- **Switching consoles** (Ctrl+Alt+F2) while lord-server runs: part of M8's own session work.-- **Installer to disk** (M8) and optional persistence on the USB stick (live-boot's `persistence`).+- **Switching consoles** (Ctrl+Alt+F2) while LordOS runs (still not possible, see `SESSIONS.md`).+- Optional persistence on the USB stick (live-boot's `persistence`). (The installer to disk is done:+ "Installing to disk" above.)- **Keyboard:** `lordos-live-prep` sets the live user's layout from the boot entry's language(English: US, Español: Latin American, Português: Brazilian) and it's changed in Settings →Keyboard. A selector on first boot is missing.-- **Real GPU (AMD/Nvidia):** tested with this ISO on real hardware. The GPU path is done by another- fork; the ISO already ships Mesa and the firmware, and the "safe mode" entry passes `LORD_GPU=0`.+- **Real GPU (AMD/Nvidia):** to be tested with the ISO on real hardware. The GPU path is built+ (`GPU.md`); the ISO ships Mesa and the firmware, and the "safe mode" entry passes `LORD_GPU=0`.- **Network robustness:** `net/state.c` takes `/etc/network/interfaces` as a sign of ifupdown evenwhen ifupdown isn't installed. It should also check that `/sbin/ifup` exists. Today the ISO worksaround it in `lordos-live-prep`.diff --git a/docs/MEDIA.md b/docs/MEDIA.mdindex e998db8..77db2a2 100644--- a/docs/MEDIA.md+++ b/docs/MEDIA.md@@ -6,9 +6,9 @@ interface and compositing are our own.| App | id | What it does ||---|---|---|-| **Photos** | `photos` | Photo library of `~/Imágenes` with thumbnails and a viewer: zoom, panning, rotation, full screen, slideshow, animated GIF and basic editing (crop, rotate, brightness and contrast) saved as a copy |+| **Photos** | `photos` | Photo library of the pictures folder (XDG, `~/Pictures` in English) with thumbnails and a viewer: zoom, panning, rotation, full screen, slideshow, animated GIF and basic editing (crop, rotate, brightness and contrast) saved as a copy || **Player** | `player` | Video with synced audio, time bar, volume, `.srt` and in-track subtitles, full screen, picture in picture; music library by artist and album with covers, queue, shuffle and repeat; media keys and the Control Center |-| **Screenshots** | `screenshots` | Screen, window or area, timer, to the clipboard or to `~/Imágenes/Capturas`, floating thumbnail and annotation editor (arrow, box, text, blur); record the screen to MP4 with optional microphone |+| **Screenshots** | `screenshots` | Screen, window or area, timer, to the clipboard or to `~/Pictures/Screenshots`, floating thumbnail and annotation editor (arrow, box, text, blur); record the screen to MP4 with optional microphone || **Camera** | `camera` | V4L2 preview, JPEG photo, H.264 + AAC video, mirror, choose camera || **Recorder** | `recorder` | Record the microphone, waveform, list, rename, trim and export to Opus, MP3 or WAV |@@ -166,7 +166,7 @@ changing the output, so a compromised decoder must not have it. Audio goes throu### Protected windows`wm.setProtected(id, true)` (SDK) marks a window as protected, like the capture protection of other desktop systems-(KeePassXC uses it). The future Passwords app will use it. It looks normal on screen and comes out+(KeePassXC uses it). The Passwords app uses it (`"protected": true` in its manifest). It looks normal on screen and comes out**black** in:- **Screenshots** (`lord.media.screenshot`): the tree is painted again onto a separate canvas in@@ -185,8 +185,9 @@ How it works:- The SDK sets the `protected` prop on the node of the window's content (`AppHost`).- The engine stores it in `Node.protect` (`lord.setProp(id, 'protected', bool)`).- The theme's frame (title included) stays visible, so an app that needs it sets a generic title.-- The server doesn't allow capturing on the GPU path: screen recording composites on the CPU, the- same as when someone is watching through remote desktop.+- Screen recording composites on the CPU. Since 0.8.4 a remote desktop viewer no longer does: the+ GPU path reads the composed frame back (`gpu_read_next`), except while a protected window is on+ screen, when the session composites on the CPU so the window can be painted black (`REMOTE.md`).- Screenshots has a menu item "Privacy → Protect the front window from screenshots" to use it withany window.@@ -195,8 +196,8 @@ How it works:Screen, microphone and camera go through the system permissions (`sec/perms.c`, `PRIVACY.md`):- the SDK asks for the permission with `requestPermission` (the system draws the prompt);-- `js_media.c` checks again in C that the saved decision is "allow": `permitted()`, the point- where the broker will hook in;+- `js_media.c` checks again in C that the saved decision is "allow": `permitted()`; isolated `.lpk` apps go through the broker,+ and their camera through `BOP_CAMERA` (`sec/brokercam.c`, `PRIVACY.md`);- while in use, the green and orange dots in the menu bar light up (`markDeviceUse`).### Shortcuts (global, also with a Linux app in front)@@ -263,10 +264,11 @@ Events: `__lordMedia(id, type, data)`. Types: `info`, `pos`, `state`, `sub`, `st- **"Open with":** Photos for images and Player for audio and video, both as the default option.- **Quick Preview:** the one in Files (from the documents agent) uses `media.poster`.- **Where things are saved:**- - screenshots in `~/Imágenes/Capturas`;- - camera in `~/Imágenes/Cámara`;- - recordings in `~/Música/Grabaciones`;- - with xdg-user-dirs the user's folders are respected.+ - screenshots in `~/Pictures/Screenshots`;+ - camera in `~/Pictures/Camera`;+ - recordings in `~/Music/Recordings`;+ - with xdg-user-dirs the user's folders are respected, and the subfolder's name follows the+ language (`Capturas`, `Cámara`, `Grabaciones` in Spanish).- **Music library:** saved in `~/.cache/lordos/music.json`, by path, size and date. Only the tagsof what changed are read again.diff --git a/docs/PAPER-VALIDATION.md b/docs/PAPER-VALIDATION.mdindex 3a7894f..0ee7416 100644--- a/docs/PAPER-VALIDATION.md+++ b/docs/PAPER-VALIDATION.md@@ -21,7 +21,7 @@ memory from a process's RSS (§7.1) and points to versioned results (§11.5, `do| § | Claim | How | State ||---|---|---|---|-| 1.2 | JavaScript has no API to run programs, with three narrow exceptions | Design (`AGENTS.md`); the exceptions grew since: Xwayland (0.8.3), the network connectors and the blocklist downloader (0.8.5) | **Outdated**: list the approved exceptions |+| 1.2 | JavaScript has no API to run programs, with three narrow exceptions | Design (`AGENTS.md`); the exceptions grew since: Xwayland (0.8.3), the network connectors and the blocklist downloader (0.8.5) | **Outdated → corrected in 0.8.5** (§1.2 now lists them, the Store's download child included) || 1.2 | GPU composition optional, the CPU path always works | Test (`canvas-test`, CPU path in every test); Check `gpu` says which path and why | Holds || 1.2 | The compositor never waits on helpers or apps | Design (non-blocking sockets) | Design || 2.2 | `lord-server` runs as the user | Check `serverUser` (configured) | Holds |@@ -52,11 +52,11 @@ memory from a process's RSS (§7.1) and points to versioned results (§11.5, `do| § | Claim | How | State ||---|---|---|---|-| 4.2 | React 19.3.1, QuickJS 2025-04-26; default theme 367 KB | Build output | Size changed: re-measure |+| 4.2 | React 19.3.1, QuickJS 2025-04-26; default theme 367 KB | Build output | Size changed → corrected in 0.8.5 (about 1.8 MB, 540 KB compressed) || 4.2 | Shaping identical to HarfBuzz on 409 of 409 sentences | Test (`shape-test`, `hb_compare.py` in `test-full`) | Holds || 4.2, 7.4 | NEON loops bit-identical to C | Test (`canvas-test` on the Pi) | Holds || 4.4 | English, Spanish, Portuguese; keys and brand names checked | Test (`tools/i18n-check.mjs`) | Holds |-| 5.1 | About thirty native apps | Count | 33 in `apps/`, System Information and its hidden probe included |+| 5.1 | About thirty native apps | Count | 33 in `apps/`, System Information and its hidden probe included; the 0.8.5 edition says thirty-one (without the live installer and the hidden probe) || 5.2 | `.lpk` limits: 2,000 files, 64 MB | Test (`pkg-test`, `sign-test`) | Holds || 5.3 | InRelease signatures, plans equal to apt's in 12 cases | Test (`pkg-test`, `engine-test`) | Holds || 5.3 | Downloads over HTTP even for HTTPS sources | Still true (signatures carry integrity) | Holds |@@ -83,7 +83,7 @@ memory from a process's RSS (§7.1) and points to versioned results (§11.5, `do| 6.6 | A denied app can't connect | Not yet effective on the user's machine | **Pending** (Checks) || 6.7 | Helpers: no sockets, no exec, seccomp on every thread, exit if it fails | Sandbox Probe `helperSandbox` (effective); Test (`sandbox-test helper`, 17/17) | Holds || 6.8 | Ed25519 and SHA-256 against NIST and RFC 8032: 55 of 55 | Test (`sign-test`) | Holds |-| 6.8 | Official `.lpk` packages signed with a development key | Changed? Re-check before publishing | Re-check |+| 6.8 | Official `.lpk` packages signed with a development key | `server/src/sec/keys.h` (checked 2026-10-26: only the development key) | Holds; re-check before publishing || 6.9 | Release key fingerprint, SBOM in SPDX 2.3 | Release scripts | Manual || 6.9 | Every bundle verified against the signed manifest | Check `code` (effective: this session's bundles) | Holds || 6.10 | Vault: Argon2id, XChaCha20-Poly1305, 1,165 of 1,165 tamper tests | Test (`vault.mk` suites) | Holds |@@ -100,7 +100,7 @@ memory from a process's RSS (§7.1) and points to versioned results (§11.5, `do| 7.1 | `lord-server` without 3D ~32 MB RSS; session ~50 MB, login 41 MB | Measured once; Check `memory` shows the current number (VM 116 today: ~100 MB in a headless session with apps open) | **Re-measure** at idle || 7.2 | Window drag 1280×800 CPU path 6.7–6.9 ms, ~120 fps | Measured once (VM 118) | Measured → LordBench || 7.2 | Video: lord-server 42 % → 13 %, fullscreen 92 % → 15 % of a core | Measured once | Measured |-| 7.2 | — | New in 0.8.5: remote desktop CPU reference (`REMOTE.md`, "Measurements (0.8.5, CPU reference)") | Add to the paper |+| 7.2 | — | New in 0.8.5: remote desktop CPU reference (`REMOTE.md`, "Measurements (0.8.5, CPU reference)") | Added in the 0.8.5 edition (§7.2) || 7.3 | GPU benefits on real cards not measured | — | **Untested** || 7.4 | Pi 5: build 1 min 02 s, tests 23/0/0, NEON 2.0–2.3×, idle 36 MB, fan behaviour | Measured once on the Pi | Measured || 7.5 | No measurements on real PCs | — | **Untested** |@@ -117,14 +117,21 @@ memory from a process's RSS (§7.1) and points to versioned results (§11.5, `do## What the paper must change for 0.8.5+State in the 0.8.5 edition (`web/content/paper/paper.en.md`, checked 2026-10-26) after each item:+1. §1.2: the approved exceptions are more than three (Xwayland, the network connectors, the blocklist- downloader, the Store's download child, the Sandbox Probe's system package).-2. §3.4: Xwayland is supported on demand (0.8.3).+ downloader, the Store's download child, the Sandbox Probe's system package). **Done**; the Sandbox+ Probe is not listed as an exception there, since it starts through `lord.apps.launchPackage(id)` (§6.4+ describes it).+2. §3.4: Xwayland is supported on demand (0.8.3). **Done.**3. §3.6: remote login lockout (3 failures; 15 min → 1 h → 24 h; fixed 1.25 s answers); WebRTC video with- H.264/VP8 and Opus sound instead of PNG/JPEG and no audio.+ H.264/VP8 and Opus sound instead of PNG/JPEG and no audio. **Done.**4. §7: re-measure `lord-server`'s memory at idle and the theme's size; add the 0.8.5 remote desktop and CPU- path measurements (`REMOTE.md`, `GPU.md`).+ path measurements (`REMOTE.md`, `GPU.md`). **Partly:** the theme's size and the 0.8.5 CPU path are in;+ §7.1 now separates whole-system memory from a process's RSS, but `lord-server`'s idle RSS is still the+ 0.8.0 number (not re-measured).5. §6: mention that anyone can now check the sandbox on their own computer (System Information → Checks).+ **Done** (§6.4).## What is still missing to validate everythingdiff --git a/docs/PASSWORDS.md b/docs/PASSWORDS.mdindex 2fe1add..a012eee 100644--- a/docs/PASSWORDS.md+++ b/docs/PASSWORDS.md@@ -70,7 +70,7 @@ editor, generator, first run); the shots below are from the first version.**Why this split.** Everything that touches plaintext vault data, parses untrusted files (KDBX,CSV, JSON, images with QR codes) or talks to the security key runs in one small helper that cannotopen the network, sockets or paths, the same model as `lord-doc` and `lord-media`-(`docs/PRIVACY.md`, "Ayudantes"). `lord-server` (the compositor) only relays: it never holds+(`docs/PRIVACY.md`, "Decoding helpers"). `lord-server` (the compositor) only relays: it never holdsthe vault key and never parses the vault. The UI gets just what it shows:- the list view gets titles, user names, URLs, tags and flags, **never** a secret;@@ -265,7 +265,8 @@ await keyring.list('mail'); // without secretsid, so the system can ask the user; `keyring.share(id, app)` records the user's decision(`shared`). Sharing is an admin operation (the Passwords app or a system prompt), never theasking app itself.-- **Trust boundary:** built-in apps run in the shell's JavaScript context, so for them the owner+- **Trust boundary:** built-in apps (other than the isolated system packages: Passwords, and since+ 0.8.2 Mail, Calendar, Contacts and Reminders) run in the shell's JavaScript context, so for them the ownerstring is passed by trusted system code, not enforced by a process boundary. For isolated `.lpk`apps the owner is set by `lord-server` from the broker (see below). The Passwords app processmanages the keyring over its own vault channel, which only the system `passwords` packagediff --git a/docs/PRINTING.md b/docs/PRINTING.mdindex 81b3178..3dee141 100644--- a/docs/PRINTING.md+++ b/docs/PRINTING.md@@ -47,7 +47,7 @@ CUPS (/run/cups/cups.sock) → Debian filters and drivers → the printer### Why without libcups-- **IPP is enough:** it's a simple binary format, and what LordOS needs is seven operations+- **IPP is enough:** it's a simple binary format, and what LordOS needs is eight operations(CUPS-Get-Printers, CUPS-Get-Default, Get-Jobs, Print-Job, Cancel-Job, CUPS-Add-Modify-Printer,CUPS-Delete-Printer and CUPS-Set-Default). libcups would also bring its DNS-SD (avahi-client),GnuTLS and PPD management, which aren't used.@@ -118,7 +118,7 @@ CUPS socket is a Unix socket and isn't affected.- `201 Location`, then `GET …/NextDocument`, retrying while it answers 503;- what arrives is saved in `~/.cache/lordos/scan/`.- **Preview** at the lowest resolution. **The area** is chosen by dragging over the preview.-- **Save as PDF, PNG or JPEG** in Documents or Pictures, as "Escaneo <date> <time>":+- **Save as PDF, PNG or JPEG** in Documents or Pictures, as "Scan <date> <time>" (named in the interface language):- if the scanner provides that format, it's copied as is;- otherwise lord-doc converts it (stb_image and cairo), at the real size according to theresolution;diff --git a/docs/RELEASING.md b/docs/RELEASING.mdindex 39a663c..9a2b213 100644--- a/docs/RELEASING.md+++ b/docs/RELEASING.md@@ -62,7 +62,8 @@ The releases page is the project's public changelog: every release is documented(`REQUIRE_SIGNED_CODE=1 tools/iso/mkdeb.sh`). `mkdeb.sh` puts `code-manifest.json` and`code-manifest.sig` in `/usr/lib/lordos/` and runs `lord-server --check-code` on the staged tree:the package is not built if a bundle changed after signing or the signature is missing. A bundle- rebuilt after signing means signing again.+ rebuilt after signing means signing again. An update with a fourth number may ship without a+ new ISO (0.8.4.1 did: the 0.8.4 ISO stayed the current one, see [ISO.md](ISO.md)).- Copy them, and `tools/install/install.sh` as `install.sh`, into one release folder.4. **SBOM.** On each build VM, `tools/release/make-sbom.sh lordos_<v>_<arch>.deb`, and put the`.spdx.json` files in the release folder ([COMPLIANCE.md](COMPLIANCE.md)).diff --git a/docs/ROADMAP.md b/docs/ROADMAP.mdindex 70b4fc4..e52f671 100644--- a/docs/ROADMAP.md+++ b/docs/ROADMAP.md@@ -140,7 +140,9 @@ Details in `WAYLAND.md`.- [x] Clipboard shared with LordOS in both directions, `xdg-decoration`.- [ ] Launching `.desktop` apps from the app launcher (needs an approved exception to "the serverdoesn't execute commands"), `linux-dmabuf`, app cursors, drag and drop,- `text-input`, Xwayland.+ `text-input`, Xwayland. (Later: the launcher in M7, `linux-dmabuf` with the GPU path, app+ cursors and `cursor-shape-v1` in M8, Xwayland in 0.8.3; drag and drop and `text-input` are+ still missing.)## M7 — Apps, packages and system services ✅ (2026-10-16)@@ -171,7 +173,8 @@ our own installer, and network, VPN, sound and clipboard with our own interface.Trash, Quick Preview, Get Info, background copy/move (`fsops.c`),drag and drop, tags, search, mounted disks and «Open With» (`launchWith`).- [ ] Left over from M7: OpenConnect and IPsec (strongSwan), WPA3/Enterprise, real per-app- permissions, a signed LordOS app repository.+ permissions (done in M8, `PRIVACY.md`), a signed LordOS app repository. (OpenConnect and IPsec/IKEv2+ came in M9, `NETWORK.md`; WPA-Enterprise is still missing.)- [x] `flexWrap` in our own layout engine (`layout.c`).- [x] Notes: sticky notes on the desktop (widgets), markdown with reading view and index, images,attachments and emoji, saved automatically in `~/Notes` (`NOTES.md`).@@ -181,7 +184,7 @@ our own installer, and network, VPN, sound and clipboard with our own interface.- [x] Our own session: `lord-sessiond` with a login screen, lock (❖L), fast userswitching, parallel sessions and Settings → Users (`SESSIONS.md`).- [x] Remote desktop on the LAN from the browser (port 5673, off by default;- `REMOTE.md`). Pending: audio (stage 2, designed).+ `REMOTE.md`). Audio came with WebRTC in 0.8.4 (Opus; see "Remote desktop over WebRTC" below).- [x] Privacy and signing of `.lpk` apps (`PRIVACY.md`, `SIGNING.md`):- [x] Our own sandbox (`server/src/sec/sandbox.c`): Landlock (ABI≤6), seccomp-bpf (allowlist), no network without permission, `no_new_privs`, dropped capabilities and per-app cgroup v2;@@ -219,11 +222,13 @@ our own installer, and network, VPN, sound and clipboard with our own interface.Trusted apps and Restricted apps;- [x] non-network restrictions (camera, microphone, screen, USB, files, clipboard, Bluetooth,notifications) enforced for LordOS apps in the broker, `js_media.c` and `sdk/notify.js`, with- live revocation (`FIREWALL.md`, "Non-network restrictions"); Linux apps: network only;+ live revocation (`FIREWALL.md`, "Non-network restrictions"); Linux apps: network only (later+ also devices, files and notifications, `FIREWALL.md`, "Linux apps");- [x] root-owned scopes: `lord-sessiond` places every app process and a Linux app can't move- itself to another cgroup (VM 122). Still open: `systemd-run --user --scope` (PID 1 moves it- into `user@<uid>.service`).- - [ ] "ask" mode (designed), per-destination switches.+ itself to another cgroup (VM 122). Then still open, closed since: `systemd-run --user --scope`+ (PID 1 moves it into `user@<uid>.service`; `lord-netperm` now holds it to the per-user union and+ device-restricted apps get their own view, `FIREWALL.md`, «Escape via `systemd-run --user`»).+ - [ ] "ask" mode (designed). (Per-destination switches: done in 0.8.2, `MONITOR.md`.)- [x] **Monitor** app, phase 1 (`MONITOR.md`), tested on VM 123:- [x] Overview, CPU, Memory, Network, Disks and Processes tabs with the look of TangoOS'sMonitor;@@ -234,11 +239,15 @@ our own installer, and network, VPN, sound and clipboard with our own interface.- [x] country by IP with our own MaxMind DB reader and DB-IP Lite (CC BY 4.0), no network;- [x] item in Settings → Privacy.- [x] Phase 2, firewall: see "Per-app firewall" above.- - [ ] Phase 2, the rest: connection alerts ("ask"), camera and microphone in use (`monitor.deviceUsers()`), host names without- reverse DNS, history and usage alerts.-- [ ] GPU sessions (today they are drawn on the CPU), VT switching and multiple monitors.-- [ ] More native LordOS apps in React (text editor, image viewer, browser).-- [ ] Installable image based on minimal Debian 13, with LordOS as `.deb` packages.+ - [ ] Phase 2, the rest: connection alerts ("ask"), camera and microphone in use (`monitor.deviceUsers()`)+ and usage alerts. (Host names from the system resolver, without reverse DNS, and the traffic+ history: done in 0.8.2, `MONITOR.md`.)+- [ ] VT switching. (GPU sessions: done, `lord-sessiond` lends the card to the visible session,+ `SESSIONS.md`; multiple monitors: done in M9, `DISPLAYS.md`.)+- [ ] A native browser. (The text editor and the image viewer are done: `EDITOR.md`, Photos in+ `MEDIA.md`.)+- [x] Installable image based on minimal Debian 13, with LordOS as `.deb` packages: the live ISO+ with its installer (`ISO.md`), and since 0.8.1 updates from the signed APT repository (`UPDATES.md`).- [ ] **ARM64 / Raspberry Pi 5 as an official platform** (`RASPBERRY.md`):- [x] Portability audit of `server/` for aarch64: unsigned char, 16K pages,arm64 seccomp, alignment and `ARCH` in the Makefile (no `-march=native`).@@ -258,8 +267,8 @@ our own installer, and network, VPN, sound and clipboard with our own interface.`6.18.57-lordos-rpi-2712`), pinned over the archive kernel.- [x] Switch files on the boot partition: `ssh`, `remote-desktop`, Wi-Fi in `lordos-user.txt`;`tools/rpi/verify-board.sh` after flashing.- - [ ] Run `build-img.sh` and test on the 16 GB Pi 5 (test list in `RASPBERRY.md`,- with screenshots through the remote desktop).+ - [x] Run `build-img.sh` and test on the 16 GB Pi 5 (test list in `RASPBERRY.md`; the image is+ a release file since 0.8.0; results in `RASPBERRY.md` and the release tests in `ISO.md`).- [ ] Hardware video on the Pi 5 (HEVC via V4L2 stateless; H.264 in software) in`lord-media`.- [ ] A «create user» step on the login screen, instead of setup mode.@@ -332,12 +341,12 @@ Details in `MEDIA.md`. Tested on VM 119 with screenshots (`photos-*`, `music-*`,- fullscreen and picture in picture (`wm.setFullscreen`/`wm.setPip` in the SDK);- music library by artist and album with cover art, queue, shuffle and repeat;- media keys and the Control Center tile.-- [x] **Photos:** photo library from `~/Imágenes` with thumbnails in `~/.cache/lordos/thumbs`, viewer with zoom,+- [x] **Photos:** photo library from the pictures folder (`~/Pictures` in English) with thumbnails in `~/.cache/lordos/thumbs`, viewer with zoom,panning, rotation, fullscreen, slideshow, animated GIF, HEIC/AVIF/WebP/BMP, basicediting saved as a copy, and printing.- [x] **Screenshots:**- screen, window or area, and a timer;- - to the clipboard or to `~/Imágenes/Capturas`;+ - to the clipboard or to `~/Pictures/Screenshots`;- floating thumbnail and annotation editor;- screen recording to MP4 (H.264 + AAC from the microphone);- shortcuts ❖⇧3/❖⇧4/❖⇧5 and Print Screen.@@ -452,9 +461,10 @@ Details in `SETTINGS.md`. Tested on VM 118 (`settings-*.png`), Bluetooth with a12/24 h, menu bar clock format.- [x] **Default Apps:** `mimeapps.list` and `xdg-terminals.list`; Files' "Open With" and`lord.apps.launchWith('', path)` honor them.-- [ ] **Pending:** extend/mirror across displays; sharp HiDPI and 125/150 %; Night Light on the GPU- path without a LUT; real laptops (battery, backlight, lid) and real Bluetooth controllers;- notifications on the lock screen and a notification center; Wayland idle inhibit.+- [ ] **Pending:** Night Light on the GPU path without a LUT; real laptops (battery, backlight, lid)+ and real Bluetooth controllers; notifications on the lock screen and a notification center.+ (Done since: extend/mirror across displays and sharp HiDPI at 100–200 %, `DISPLAYS.md`; Wayland+ idle inhibit in 0.8.5.)## M9 — Mail, Calendar, Contacts and Reminders ✅ (2026-10-18)@@ -478,6 +488,9 @@ Details in `MAIL.md`. Tested on VM 123 against local Dovecot, Postfix and Radica**invitations** from Mail (Accept / Maybe / Decline with iTIP REPLY), **Reminders** (lists, duedates, priorities, flags, smart lists, VTODO over CalDAV), **Contacts** (local and CardDAV,groups, photo; Mail autocompletes from it). Alarms ring with the apps closed.+- [x] **Isolated apps (0.8.2):** Mail, Calendar, Contacts and Reminders run as their own sandboxed+ processes (`lord-server --app <id>`), with `BOP_MAIL` and per-app allow lists in the broker+ (`sec/brokermail.c`, `MAIL.md`).- [x] **Tests:** `mail-test` 30,953 checks (IMAP, MIME, charsets, HTML sanitizer, iCal, vCard, XML,mutation fuzzing), `mailnet-test` 138, `mailc-test` 69; ASan/UBSan target.- [ ] Real providers (Gmail, Yahoo and the others in the table) and OAuth2 with a registered client ID.@@ -503,8 +516,9 @@ Details in `MAIL.md`. Tested on VM 123 against local Dovecot, Postfix and Radicauniform margins and spacing, alignment, typographic hierarchy, sidebars,toolbars and sheets as in the design guide, controls with the same size and height, nothing overlapping orclipped; in light, dark, RTL and in small windows; with before and after screenshots.-- [ ] **Final ISO** with everything (check that `lord-doc` and `lord-media` are inside) and a **Raspberry- Pi 5 image** (`tools/rpi/build-img.sh`), tested on the real Pi.+- [x] **Final ISO** with everything (check that `lord-doc` and `lord-media` are inside) and a **Raspberry+ Pi 5 image** (`tools/rpi/build-img.sh`), tested on the real Pi: released as 0.8.0 (`ISO.md`,+ `RASPBERRY.md`).## Before 1.0@@ -704,8 +718,8 @@ Details in `MAIL.md`. Tested on VM 123 against local Dovecot, Postfix and Radica- [x] **Turn the "Classic" theme into a second full appearance** (0.8.3; Settings → Appearance → Desktop style, see `DESIGN.md`, "Classic"), for people coming from themost common desktop layout: a centered taskbar with a start menu, pinned and running apps, asystem tray with quick settings and a notification panel, snap layouts for windows, rounded- corners and translucent materials. Today `themes/classic` is only a template (taskbar and start- menu); it becomes a complete, polished theme with the same name:+ corners and translucent materials. Until 0.8.3 `themes/classic` was only a template (taskbar and+ start menu); it became a complete, polished theme with the same name:- **same apps, different skin:** no app is rewritten. Native apps keep every feature; the themesupplies the window frame, title bar buttons on the right, menus, controls, typography scale andspacing through the SDK's theme tokens and components (`configureWindows`, shared controls), sodiff --git a/docs/SETTINGS.md b/docs/SETTINGS.mdindex 9a91187..b7fbe0d 100644--- a/docs/SETTINGS.md+++ b/docs/SETTINGS.md@@ -1,6 +1,6 @@# Settings: Displays, Bluetooth, Energy, Cooling, Notifications, Date & Time, Default Apps-Six Settings pages laid out like the system settings of popular desktop systems, with the hardware side in+Eight Settings pages laid out like the system settings of popular desktop systems, with the hardware side in`server/src/hw/` (C, libc only) and the session side in `sdk/hardware.jsx`, `sdk/defaults.js` and`sdk/notify.js`. Tested on VM 118 (`lordos-notes`) with `lord-sessiond`, virtio-gpu and a virtualBluetooth controller (`btvirt`). Screenshots: `docs/settings-*.png`.@@ -212,7 +212,9 @@ with real hardware** (no controller in the VMs).poll timeout): screen off is the connector's DPMS (`kms_dpms`; nothing is drawn while it is off),"require password" locks the session through `lord-sessiond` N seconds after the screen goes off,and sleep runs the closed action `power-suspend` (`systemctl suspend`). The VM is never put to- sleep in the tests.+ sleep in the tests. Since 0.8.5 a Linux app that holds a Wayland idle inhibitor+ (`zwp_idle_inhibit_manager_v1`, `wl.c`) on a shown surface, such as a video player, counts as+ activity (`wl_idle_inhibited` in `main.c`), so the screen stays on.- **Power button and lid.** What systemd-logind does (sleep, hibernate, shut down, do nothing). Theadmin action `power-buttons <power> <lid> <lid-on-ac>` writes`/etc/systemd/logind.conf.d/lordos.conf` (a short list of values, validated) and runs@@ -398,7 +400,6 @@ The validators are unit-tested in `build/settings-hw-test`.- Night Light on the GPU path when the card has no gamma LUT.- Brightness, battery, lid and power profiles on real laptops; Bluetooth with real controllers.- Notifications on the lock screen; a notification center listing the history.-- Wayland idle inhibit (a video player does not keep the screen on yet).## ISO packagesdiff --git a/docs/SIGNING.md b/docs/SIGNING.mdindex 924d0ac..3165c6e 100644--- a/docs/SIGNING.md+++ b/docs/SIGNING.md@@ -39,7 +39,8 @@ SHA-256 and Ed25519 are **our own code**, small and readable. Ed25519 follows th(`ed25519_sign`/`ed25519_public`) was added on top of the verification the package engine alreadyhad. The JSON reader is our own and strict (`server/src/sec/json.c`).-**No OpenSSL:** by policy only `lord-sessiond` links it. `.lpk` verification happens in C, at+**No OpenSSL:** by policy only `lord-sessiond`, `lord-maild` and (0.8.5) `lord-fetch` link it, never+`lord-server`. `.lpk` verification happens in C, atinstall time (`lpk_check` in `js_sys.c`) and at load time (modification detection via`pkg_status`).@@ -137,6 +138,9 @@ in `SHA256SUMS`, and `SHA256SUMS` is signed with the LordOS release key:or on a build VM. Keep an offline backup of it.- The Debian installer refuses to install when the signature is missing or invalid, before the`.deb` is downloaded.+- Installed systems update from the signed APT repository on lordos.org (0.8.1), which has its own+ OpenPGP key (`packaging/keys/lordos-archive-keyring.gpg`), because APT needs OpenPGP; see+ [UPDATES.md](UPDATES.md).Checking a download by hand (OpenSSL 3):@@ -169,7 +173,7 @@ development tree), lists the size and SHA-256 of every file LordOS runs as JavaS|---|---|| `themes/<theme>/theme.bundle.js` | the shell, the SDK, the React runtime and **every native app** (they are bundled into each theme), for `default`, `classic` and `greeter` (the login screen) || `assets/app-host.bundle.js` | React + SDK of isolated app processes (`lord-server --app <id>`) |-| `assets/sysapps/<id>/app.js` | system apps that run as their own sandboxed process (Passwords) |+| `assets/sysapps/<id>/app.js` | system apps that run as their own sandboxed process (Passwords; Mail, Calendar, Contacts and Reminders since 0.8.2; System Information's Sandbox Probe `sysprobe` in 0.8.5) |```json{@@ -240,7 +244,7 @@ development state: without a valid signature nothing is loaded.**recovery screen** — compiled into lord-server, so it is as trusted as lord-server itself — sayswhat happened, lists the files and how to repair it (`sudo apt install --reinstall lordos`); in asession it has a Log Out button. Never a blank screen.-- **An isolated system app** (Passwords): its window shows the same recovery screen instead of the app.+- **An isolated system app** (Passwords, Mail, Calendar, Contacts, Reminders): its window shows the same recovery screen instead of the app.`lord.code.status()` (`ui/js_sec.c`) gives the SDK the state and the refusals; `sdk/codesig.js`shows the notification. `lord-server --check-code [<folder>] [--require-signed]` checks a whole treediff --git a/docs/TRACKPAD.md b/docs/TRACKPAD.mdindex d37e96b..c60f6e9 100644--- a/docs/TRACKPAD.md+++ b/docs/TRACKPAD.md@@ -411,9 +411,9 @@ The maximum is a frame that was being drawn on the CPU at that exact moment.- **Isolated apps:** they don't have their own inertia for fine scrolling (Wayland apps do itthemselves; LordOS's is for the theme's interface).-- **CPU compositing:** each frame copies the whole screen to the graphics card's buffer- (`canvas_copy` in `main.c`). Copying only what changed would further lower the cost of panning the- map.+- **CPU compositing:** each frame copies the bounding box of what changed to the graphics card's+ buffer (`present_cpu` in `main.c`); copying only the separate damaged rectangles is written but+ off by default (`LORD_DAMAGE=multi`), and would further lower the cost of panning the map.- **Missing gestures:**- drag lock (tap and drag that continues when the finger lifts for a moment);- edge scrolling for single-finger touchpads;