From 6c4039aebbe7ec25f47cb4623e44b96373e9e6e5 Mon Sep 17 00:00:00 2001 From: Nick Moore Date: Sat, 7 Nov 2026 09:20:22 -0600 Subject: Track sway (shared + rigel machine overlay), replace fibonacci with dwm-dwindle listener - sway package: shared config (styling, all muscle-memory binds, no exec lines) including ~/.config/sway/machines/*.conf overlays included LAST; floating_windows + machines/README contract; sway/AGENTS.md doctrine - rigel package: machine overlay (outputs, touchpad, session stack, power bindings) + session scripts now stow-managed; fibonacci.py replaced by a POSIX sh+jq dwindle listener (dwm dwindle geometry, --monitor subscription, mark+move re-home, flock singleton); machines/rigel.conf exec line updated to the new path - validated in a headless nested sway against a literal port of fibonacci.c: five- and seven-window trees plus refocus-before-spawn all match dwm's rects (modulo the bar offset) --- sway/AGENTS.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 sway/AGENTS.md (limited to 'sway/AGENTS.md') diff --git a/sway/AGENTS.md b/sway/AGENTS.md new file mode 100644 index 0000000..bb5532e --- /dev/null +++ b/sway/AGENTS.md @@ -0,0 +1,33 @@ +# sway — Component Context + +Parent rules: `../AGENTS.md` (repo root). This package holds the SHARED +sway config for every sway-using machine. + +## The split doctrine + +- Tracked `config` = shared, machine-agnostic layer: doom-one palette + variables, fonts, borders/gaps/titlebars, window rules, ALL muscle-memory + key bindings (vim motions, workspaces, screenshots, volume/media/ + brightness, resize mode), behavioral QoL. NO exec lines, no machine + paths, no output names. +- Machine overlays: `~/.config/sway/machines/.conf`, included + LAST — they may override anything above and may ONLY contain hardware + shape (outputs, input blocks), that machine's session stack (autostart + of its own scripts), lock/idle, and power behavior. NEVER styling. In + this repo the pattern is delivered by per-machine packages (currently + `../rigel`); see `machines/README.md` for the contract. +- Sway precedence facts the split relies on: specific `output ` + rules beat `output *`; later bindsym definitions win; `include` is + re-evaluated on every `swaymsg reload`. + +## Include depth constraint + +Sway's include is one level deep: `machines/*.conf` files are included +directly by the main config and must NOT themselves contain `include`. + +## Session scripts + +Referenced autostart scripts are per-machine repo content (rigel package +ships its supervisor/fibonacci/ppd/veila helpers). The shared config +contains no exec lines, so a bare `stow sway` on a new machine yields a +working, safe desktop before that machine's overlay lands. -- cgit v1.3