chore: stage the Hyprland Lua port with its redeploy kitHEADmain

Hyprland 0.57 drops the .conf format. The port is built and measured identical to the current config in a nested compositor — 38 settings, 103 binds, the host-override chain — but it is not deployed. I put it live this afternoon and took it back out the same hour, because it had not been run on real hardware and the machine has to stay usable until it has.

working/hyprland-lua-port/ carries what the switch needs, including the two reader changes as replayable patches. Those matter more than the config itself: four things read hyprland.conf as a source of truth, and dotfiles-validate globs hypr/*.conf, so with the .conf gone it finds nothing and reports a clean tree.

Two facts not worth re-deriving: with both files present 0.56.2 loads the .lua, so keeping the .conf beside it buys no rollback; and a running compositor rewrites a stub config within a second of the file vanishing, which is what fights a restow.

Also archives finished tasks and folds in several sessions of task-review edits.

1 files changed, 43 insertions, 0 deletions

diff --git a/working/hyprland-lua-port/ratio-local.lua b/working/hyprland-lua-port/ratio-local.lua
new file mode 100644
index 0000000..de190d5
--- /dev/null
+++ b/working/hyprland-lua-port/ratio-local.lua
@@ -0,0 +1,43 @@
+-- ratio — desktop, 1x scaling. Defaults in hyprland.lua are correct.
+-- Sourced via conf.d/*.lua glob (last wins).
+--
+-- Examples:
+--   hl.monitor({ output = "DP-1", mode = "3440x1440@144", position = "auto", scale = 1 })
+--   hl.bind("SUPER + L", hl.dsp.exec_cmd("hyprlock"))
+--
+-- Spell the modifier out. A sourced file is loaded by hl_source_glob via
+-- loadfile, which gives the chunk globals only, so the shared config's `mod`
+-- (and `at_start`, and the other locals) are NOT in scope here.
+
+-- DP-4 (Dell U3419W ultrawide) pinned to its native mode. Without an explicit
+-- pin the shared catch-all monitor=,preferred,auto,auto lets an XWayland surface
+-- (emacs runs X11-only on ratio) drive the mode down to 1280x720 at login. That
+-- low mode also wipes DP-4's reserved area, which drops the non-exclusive waybar
+-- off-screen (margin-top:-54 needs the 60px top reserve). Pinning holds both.
+
+hl.monitor({
+    output = "DP-4",
+    mode = "3440x1440@60",
+    position = "0x0",
+    scale = "1",
+})
+
+-- org-capture popup: capped at 120 Emacs columns wide, height proportional
+-- (Craig, 2026-07-14). 120 cols x 11 px/col = 1320 wide; height keeps the old
+-- rule's aspect (1892:936) = 653 px (~27 lines at 24 px). The old 55% x 65%
+-- scratchpad match (1892 x 936) was the "grows too large" complaint. max_size
+-- holds the cap even if the frame tries to grow with capture content.
+hl.window_rule({
+    match = {
+        title = "^(org-capture)$",
+    },
+    size = "1320 653",
+})
+
+hl.window_rule({
+    match = {
+        title = "^(org-capture)$",
+    },
+    max_size = "1320 653",
+})
+