The machine now carries its own manual for AI hands

Claude-Session: https://claude.ai/code/session_01Ms2FbjQy31TVf3CEvQhGM8

tests/desktop-hijacking

@@ -0,0 +1,99 @@
+# Contracts that take over the desktop you are sitting in front of.
+#
+# Most of the suite is hermetic: stub commands on PATH, a throwaway HOME, or a
+# Quickshell harness booted with `qs -p` under its own semantic entry file. Those
+# are safe to run mid-session and are not listed here.
+#
+# The ones below are not. Each drives the LIVE shell, compositor or machine --
+# it opens overlays over whatever you were doing, restarts the running shell,
+# moves your windows, changes your monitor, or rewrites a real default. Run
+# during a working session they are, at best, a series of surprises; at worst
+# they leave state behind when interrupted.
+#
+# `panama test --safe` skips exactly this list, which is why every entry's
+# comment says what it does to the session rather than what it proves.
+# tests/setup/desktop-hijacking-contract checks each path exists and sweeps
+# tests/ for hijacking contracts that are missing from here.
+#
+# One repo-relative path per line.
+
+# Pushes a fixture privacy state into the running shell and opens the activity
+# panel over the desktop.
+tests/quickshell/activity-indicator-contract
+
+# Pushes fixture privacy states and Signal Glass events into the running shell,
+# and dismisses the live capsule.
+tests/quickshell/activity-state-contract
+
+# Opens the live agenda popover and the notification centre, and starts a real
+# focus session on the running shell.
+tests/quickshell/calendar-agenda-contract
+
+# Opens and closes the cheatsheet overlay on the running shell.
+tests/quickshell/cheatsheet-contract
+
+# Changes the real default browser through the default-apps helper -- xdg-mime
+# and xdg-settings defaults on this machine -- and puts it back.
+tests/quickshell/default-apps-roles-contract
+
+# Changes the real monitor's mode, position, scale and rotation through the live
+# compositor, restoring the display it started from.
+tests/quickshell/displays-contract
+
+# Starts, pauses, reveals and ends a real focus session, and opens Mission
+# Control on the running shell.
+tests/quickshell/focus-session-contract
+
+# Restarts panama-quickshell.service (or `qs kill`s the shell when unsupervised)
+# with a focus session in flight; an interrupted run leaves caffeine latched on.
+tests/quickshell/focus-session-expiry
+
+# Restarts panama-quickshell.service (or `qs kill`s the shell when unsupervised)
+# mid-session to prove a paused focus session survives it.
+tests/quickshell/focus-session-restart
+
+# Spawns a real kitty window, moves it between your workspaces and into the
+# scratchpad, and opens the overview.
+tests/quickshell/overview-live-actions
+
+# Opens the overview on the running shell and types a search into it.
+tests/quickshell/overview-search-contract
+
+# Toggles the live caffeine inhibitor and Night Light on the running shell.
+tests/quickshell/panama-action-ipc-contract
+
+# Opens and closes the live overview.
+tests/quickshell/scratchpad-shelf-contract
+
+# Opens the live screen-intelligence and capture overlays and runs an analysis
+# through them.
+tests/quickshell/screen-intelligence-contract
+
+# Flips real compositor policy -- gaps, blur, inactive opacity, keyboard layout
+# -- on the live compositor and restores it.
+tests/quickshell/settings-hyprland-write-contract
+
+# Applies compositor policy through the production write path against the live
+# compositor, and writes preferences to the real settings store (no isolated
+# config home).
+tests/quickshell/settings-system-contract
+
+# Opens the real Settings window, routes it between pages, and closes it through
+# the compositor.
+tests/quickshell/settings-window-contract
+
+# Flips every compositor-backed setting to a value it does not hold, one at a
+# time, on the live compositor.
+tests/quickshell/settings-write-sweep-contract
+
+# Publishes a critical fixture event into the live Signal Glass capsule.
+tests/quickshell/signal-glass-contract
+
+# Publishes fixture events into the live capsule and toggles Do Not Disturb.
+tests/quickshell/status-events-contract
+
+# Drives the live window switcher and commits a switch, which moves your focus.
+tests/quickshell/switcher-contract
+
+# Opens and closes the welcome overlay on the running shell.
+tests/quickshell/welcome-contract