companion: README, AGENTS listing, Lines.js and Figure.qml in the spec

The README records the measurements the code depends on: where typing
and BackSpace come from, why the dodge waits for the pointer, the
IdleMonitor enabled default, and fullscreen 2 against maximised 1.
AGENTS.md gains the QtQuick Sprite trap beside the Controls Button one,
since it took the desktop shell down on restart.

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

1 files changed, 7 insertions, 0 deletions

diff --git a/AGENTS.md b/AGENTS.md
index 76a7bb8..c26ff7d 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -19,6 +19,7 @@ modules.
       island/         top-centre pills on DP-1: clock, volume, tray, layout, privacy,
                       calendar, OBS
       assistant/      the assistant canvas on SUPER+Home, a view over desktop-assistant
+      companion/      a chibi 2B, bottom-right of the focused monitor, on SUPER+\
     window-switcher/  expose: open windows scattered as live previews, on ALT+TAB
                       or the top-right hot corner of DP-1
     keybinds/         live keybind reminder, on SUPER+k
@@ -207,6 +208,12 @@ changing that component. The ones that generalise:
   `Settings.qml`, which imports Controls, `Button { icon: ... }` became the
   Controls button and logged `Unable to assign QString to QQuickIcon`. A file
   that imports Controls builds its buttons from a `Rectangle` instead.
+- **Plain `import QtQuick` shadows a directory's own `Sprite.qml` too.**
+  QtQuick ships a `Sprite` type (for `AnimatedSprite`), and an explicit
+  import beats the implicit directory one, so the companion's `Sprite {
+  onSettled: ... }` failed with `Cannot assign to non-existent property
+  "onSettled"` and took the whole desktop shell down on restart. It is
+  `Figure.qml`. Before naming a component, check it is not a QtQuick type.
 - **`FloatingWindow.maximized` works under Hyprland.** Setting it fills the
   monitor and clearing it restores the old size, checked by eye; the settings
   window's titlebar row uses it, since Hyprland draws no decorations.