monolith

# Test checklist for the 2026-10-19 session

Everything below landed in one day from parallel agents and was only checked nested, mostly with throwaway clients and synthetic input. Nothing here has run on bare metal. The first part is what to try by hand. The second is what could be automated and how.

Build and run from the repo root in nushell.

```nu

nix develop -c cargo build --release -p monolith

nix develop -c sh -c 'RUST_LOG=monolith=debug target/release/monolith run --backend drm 2> monolith.log'

```

## By hand on bare metal

### Memory and startup

- [ ] Idle RSS with your usual windows, compared with the 180 to 200 MB before the EGL fix and the heap trim.

- [ ] `grep -E 'LLVM|gallium|EGL_mesa' /proc/(pgrep -x monolith)/maps` via sudo finds nothing.

- [ ] Open and close beer 20 times. RSS should not climb.

- [ ] `monolith msg quit` exits cleanly with no coredump (`coredumpctl list | grep monolith`).

- [ ] A config with a TOML typo still loads everything else, and the log names the dropped line.

### Outputs, pacing and power

- [ ] **VRR and the cursor cap.** In a fullscreen VRR game, moving the mouse hard should leave the game's frame rate alone. An idle VRR desktop should stay at 60 Hz or below.

- [ ] **Unplug and replug.** Do this with the bar running. The bar gets closed on unplug. There is no phantom output in its screen list, and exactly one output after replug. Try it again with a replug inside 5 s.

- [ ] **VT switch.** Stay away for 30 s and CPU should be idle. Coming back should redraw with no `frame missed its vblank`. A monitor plugged in while you were away should light on return.

- [ ] **Lost flip.** If `page flip never landed` ever appears, the output should recover by itself.

- [ ] **Idle blank.** With `[idle] blank_after = 30`, the panels go dark and wake on input. A fullscreen video holding an idle inhibitor stops the blank. Check the VRR panel after it wakes.

- [ ] **Power commands.** `monolith msg power off DP-1` and `power on` work. A swayidle or wlopm timeout and resume works too. An explicit off stays off through input.

- [ ] **Lid, if the machine has one.**

  - `systemd-inhibit --list` shows monolith holding `handle-lid-switch`.

  - `close = "ignore"` stays awake.

  - `"suspend"` suspends once.

  - Docked, closing the lid darkens only the panel.

- [ ] **Presentation.** `mpv -v --video-sync=display-resample` reports presentation feedback. `weston-presentation-shm` shows HW_CLOCK and VSYNC flags. Check both with VRR on and off.

- [ ] **FIFO.** `vkcube --present_mode 2` runs at the panel rate without stalls. Hiding its tag throttles it, and showing the tag again restores it.

- [ ] **Commit timing.** A Proton game paces smoothly.

- [ ] **Signals.** Logging out or sending `kill -TERM` removes the socket and the X11 lock.

### Scale

- [ ] **Fractional scale on DP-2.** With `scale = 1.5` on DP-2, text is crisp in foot, GTK and Qt (quickshell). Borders and gaps are crisp. X11 apps are upscaled at the right size.

- [ ] **Rotated DP-1 at scale above 1.** Windows, layers, the lock screen and the pointer mapping are all right.

- [ ] **Cursor.** The cursor size follows the scale, its tip sits under the hotspot, and it moves between outputs at different scales cleanly.

- [ ] **Direct scanout.** A fullscreen game at a fractional scale still logs `direct scanout scanout=true`.

- [ ] **Screenshots.** `grim` of an output and of a window at scale 1.5 come out at the right pixel size.

### Windows and layout

- [ ] **Inkscape.** The splash and start screen float at their own size.

- [ ] **Float toggle.** Toggling a tiled window to float sizes it to what it wants and glides once, with no snap.

- [ ] **Hide to tray.** Telegram, Discord and Steam leave no blank tile, and come back through the normal map.

- [ ] **Starting fullscreen.** `mpv --fs`, an SDL game and a Wine game all start fullscreen, on the output they asked for.

- [ ] **Dialogs over fullscreen.** A save dialog from a fullscreen app is shown and focused above it. A new unrelated window doesn't steal focus.

- [ ] **Launch context.** Inkscape run from beer on tag 2 of DP-1 lands on beer's tag and output even while you're viewing elsewhere.

- [ ] **Autotile.** New windows split the focused one along its longer side. `autotile = false` restores the old behaviour after a reload.

- [ ] **Spawn edge.** On an empty output, the first window grows in from the right on landscape and from the bottom on rotated DP-1.

- [ ] **Scratchpads.** They are always centred on the output they're summoned on, including after a resize or a mode change.

- [ ] **Urgency.** An unfocused window that asks for attention (foot's bell, or a chat app) gets the amber border and `urgent` in `monolith get state`.

- [ ] **Window rules.** Try each of size, position, center, min and max size, fullscreen, `focus = false`, opacity (including while the window closes), `idle_inhibit`, `vrr`, and the X11 class and instance matchers.

- [ ] **Locked binds.** A `[locked]` volume bind works on the lock screen, and ordinary binds don't.

- [ ] **Modal dialogs.** Clicking the parent of a GTK4 modal focuses the modal (once the modal work lands).

### Input, popups and selections

- [ ] **Popups.** GTK, Qt and Firefox menus close when you click outside them. Near a screen edge they flip or slide to stay on screen. A menu from a left tile is drawn above the right tile and is clickable there. Quickshell tray menus close too.

- [ ] **Click accuracy.** In a GTK app with shadows, such as mousepad, clicks land exactly where things are drawn.

- [ ] **Drag and drop.** Drag a browser tab or a file from a file manager into another app.

- [ ] **Window screencast.** With `chooser_type=dmenu` in `~/.config/xdg-desktop-portal-wlr/config`, sharing a single window from a browser lists window titles and streams only that window.

- [ ] **Clipboard bridge.** Copy and paste between X11 apps (Steam, Wine) and Wayland apps work in both directions, for the clipboard and the primary selection. Something copied before Xwayland starts reaches X11 apps. With `selection_access = "any"`, a headless `xclip -o` can read.

- [ ] **Client move and resize.** On a floating GTK window, dragging the headerbar moves it. X11 windows do the same.

- [ ] **Border grab.** Hovering a border or gap shows the resize cursor. Dragging resizes, a gap between tiles moves the split, and floats stay on the output.

- [ ] **Meta+RMB.** It resizes from the nearest edge or corner, on tiles and floats.

- [ ] **Resize hold.** During a resize drag the window stretches, and the client gets one configure on release. Check with `WAYLAND_DEBUG=1` on foot.

- [ ] **Pointer lock and confine.** Mouse look works in a Proton or SDL game. A browser pointer-lock demo works and the cursor comes back where expected. A confined pointer stays inside the window.

- [ ] **Shortcuts inhibit.** A VM viewer or remote desktop client gets Super combos. `reload` still works, and so does VT switching.

## Automating these

The fastest wins come from tests that run in `cargo test` with no compositor. The rest need a headless way to run monolith with scripted clients.

### Pure unit tests, cheap

- **Layout** (`crates/layout/src/tests.rs`). Each of these is already partly covered and needs a few more cases.

  - Modal focus redirect and chained modals.

  - `focus_if_covering`, and `focus_dir` never reaching a covered window.

  - Scratchpad centring after `set_output_area` and `send_to_output`.

  - `move_split` at minimum shares.

  - Autotile with mixed visible and hidden siblings, run over the random-commands proptest.

  - Float clamp with outputs smaller than the window.

- **Config** (`crates/config`).

  - Lenient parse of an unclosed multi-line array, a broken `[table` header, a duplicate table, and more than 32 bad lines.

  - Rule matcher precedence.

  - Scale snapping to 1/120.

  - `[locked]` filtering.

- **Pure helpers in monolith.**

  - `timing.rs` release-time computation: VRR, no timeline, a timestamp within 1/8 refresh of a vblank.

  - `fifo.rs` hold sweep.

  - `resized` edge clamping with rule limits.

  - The Latin-1 transcoder (has tests).

  - `Edges` grid selection.

  - `wm::configure` choosing the logical size whose rounding matches the physical size at 1.25, 1.5 and 1.75.

  - Each of these is a pure function, or can be made one by passing time and geometry in.

- **render-vk goldens** (`crates/render-vk/tests/golden.rs`).

  - Blend-off for X formats against alpha formats.

  - The opacity rule through the effect path.

  - Single-pixel solid at alpha 0.5.

  - Y-inverted dmabuf (has a test).

  - Pipeline cache rejecting a foreign header (has a test).

  - A batched upload followed by a draw in the same submit (has a test).

  - Device-lost flag transitions (has a unit test).

### Integration tests needing a headless backend

- **The harness.** Add `--backend headless` to monolith. It would render to an offscreen dmabuf or `Offscreen` image, run its own vblank timer, and expose a test-only virtual input path. That could be wlr-virtual-pointer and virtual-keyboard, which we'd want for wtype anyway, or an IPC `inject` command compiled behind a feature. Put the harness in `crates/testkit` (currently empty), with a client library that spawns monolith, waits for its socket, runs a scripted Wayland client from wayland-client and reads `get state` and screenshots through image-copy-capture.

- **Scenarios** it would make cheap. Each is a throwaway client an agent already wrote today, which could be kept instead of deleted.

  - Popups. A grab plus an outside click gives `popup_done`, an unconstrained position near the edge, and the stacking order over a neighbouring tile.

  - The Space origin. A click on a CSD window with a geometry offset arrives at the right surface coordinates.

  - DnD. Enter, motion and drop between two clients.

  - Clipboard bridge with Xwayland. Needs Xwayland in the test environment, and xclip or xsel.

  - Client move and resize requests, border-grab hover and drag, Meta+RMB, and the resize hold (count configures during a drag).

  - Pointer lock, confine and relative motion, and shortcuts inhibit, with the virtual pointer and keyboard.

  - xdg-foreign and xdg-dialog parenting gives a floating window.

  - Null-buffer unmap and remap, fullscreen before map, and the Inkscape-style late min and max hints.

  - Window rules end to end, including re-evaluation on a title change before first draw.

  - Single-pixel buffer colour and size, from a screenshot pixel count.

  - fifo barrier release and commit-timing landing frame, against the headless vblank timer.

  - Presentation feedback timestamps against that timer.

  - Fractional scale. Screenshot sizes, crisp borders, preferred scale events, and resending them after a reload.

  - Hotplug. Add and remove a headless output, check the `wl_output` global's lifetime, the closed layers and lock surfaces, and how windows are rescued.

  - Idle blank and the power protocol, through the headless power state.

- **What stays manual.** Real DRM and VRR, the NVIDIA driver paths (submit stall, scanout, cursor plane), logind and the lid, and real games and portals.