companion: above the assistant's dim, and typing means a run of keys

The assistant canvas is a full-screen Overlay surface mapped on open,
so it covered her and her think and wave were never seen. She moves to
the Overlay layer and unmaps and maps again when the canvas opens, since
a later surface stacks above an earlier one and Hyprland 0.56.2 has no
layer rule to order them: an `order` key was tried, raised no config
error, and did nothing.

Every key sent her into watching, a shortcut included. The pulse comes
at most once a second, so a lone key is one pulse; she now watches from
the second pulse within 2.5 s. The hypr-theme hook drops modifiers and
chords on its side.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

1 files changed, 8 insertions, 0 deletions

diff --git a/desktop/companion/README.md b/desktop/companion/README.md
index e0eaaf3..a7ce37f 100644
--- a/desktop/companion/README.md
+++ b/desktop/companion/README.md
@@ -37,6 +37,14 @@ frame falls back to its outfit's `base`.
   `custom>>keystone-delete` on socket2. Nothing else about the keyboard
   reaches her. The BackSpace bind is `non_consuming`; checked by hand that
   it still deletes in a terminal and in the browser.
+- The typing pulse skips modifiers and any key pressed with Ctrl, Alt or
+  Super held, so a shortcut is not typing; Shift and AltGr still count.
+  She watches only from the second pulse within 2.5 s, so a lone key is
+  not typing either.
+- She is on the Overlay layer and remaps when the assistant canvas opens:
+  Hyprland stacks a later surface above an earlier one on a layer, and
+  0.56.2 has no layer rule to order them (no `order` key in the binary;
+  an unknown key raises no config error).
 - She only feels the pointer while it is over her: Quickshell has no
   global pointer and Hyprland sends no motion events. Hence the 0.6 s
   dodge rather than moving away as the pointer approaches.