diff options
Diffstat (limited to 'AGENTS.md')
| -rw-r--r-- | AGENTS.md | 35 |
1 files changed, 32 insertions, 3 deletions
@@ -11,20 +11,21 @@ them runs alone, and running one does not require the others. volume-osd/ volume for output and input, plus what is playing vm-manager/ libvirt drawer: state, live stats, snapshots appearance/ wallpaper picker and colour scheme switcher + mail-overview/ notmuch unread counts per account, waybar icon and drawer -Both are started from `~/.config/hypr/sections/autostart.lua` and keep running +They are started from `~/.config/hypr/sections/autostart.lua` and keep running for the whole session. ## The rule that bites first -**A quickshell config with no visible window exits.** Both components here are +**A quickshell config with no visible window exits.** These components are hidden most of the time, so each holds itself open with a 1x1 transparent `PanelWindow` with `mask: Region {}`, which is click-through and draws nothing. Without it the shell loads, logs `Configuration Loaded`, reports no error, and quits. The symptom is never an error message: it is a keybind that appears to do nothing, or a panel that never paints. This was removed once during -development because a process check was measuring the wrong thing, and both +development because a process check was measuring the wrong thing, and two components broke in exactly that way. Any new component needs the same window. ## Verifying, and how not to @@ -76,6 +77,26 @@ changing that component. The ones that generalise: - **Assigning `running = true` to a `Process` that is already running does nothing.** Reusing one `Process` for a sequence of commands needs `running = false` immediately before each start. +- **`notmuch` fails two different ways and only one is detectable.** A + rejected query prints nothing and exits 1; a query Xapian merely misparses + returns a plausible wrong number and exits 0 (`tag:unread and ((` gave 41). + Validate the output as an integer, which catches the first, where empty + output would otherwise render as an empty inbox. Nothing catches the second, + so keep such queries as fixed strings. +- **notmuch deduplicates by message id, so one message can have several + paths.** A message that arrived at two configured addresses is counted by + both accounts under a `path:` glob, and per-account counts then sum above the + total. The `account-*` tag is a property of the message, so it is singular. +- **Xapian replaces files on commit.** A watch held on a filename inside the + database directory dies with the file; watch the directory for + `close_write,moved_to` instead, and debounce, because one commit touches + several files. +- **An INI section body is not "everything up to the next `[`".** Values can + themselves contain brackets: `qtmaildir.conf` has folders named + `[Gmail]/Bozze`, which ended a section before its `label` and made three of + five accounts silently display their raw key. Walk lines instead. A first fix + using a lazy quantifier and a lookahead dropped every label, which is the + argument for the boring version. - **libvirt's own memory and disk figures are not what they look like.** `balloon.current` is memory allocated to the VM and reads full forever; `block.allocation` is qcow2 growth on the host, not usage inside the guest. @@ -108,6 +129,14 @@ frosting needs its own `hl.layer_rule` and a distinct `WlrLayershell.namespace`. Without the rule it still works, rendering flat translucent. +A panel that should sit below waybar rather than over it wants +`exclusionMode: ExclusionMode.Normal` on its window, which respects waybar's +exclusive zone without the component knowing the bar's height. Measured with +`hyprctl layers`: waybar at `y=-540 h=42`, a `Normal` overlay on the same +screen at `y=-498 h=1038`, starting exactly where the bar ends, so the +backdrop never dims it. `mail-overview` does this; the other three use +`ExclusionMode.Ignore` and cover the whole screen. + ## Reloading | | How | |