Give focus modes conditions rather than alarms, and let Gaming hand over

A mode is on because something is true right now: a game is running, a window is
fullscreen on a given display, a workspace is focused, the clock is inside a
window. That is asked again rather than fired once, and it is the whole reason
schedules could be included here without the usual failure modes. A machine
asleep at 23:30, rebooted at 02:00, or opened at 08:00 into a window that has
already passed all reach the right answer by being asked again; an alarm gets
all three wrong.

The midnight-crossing rule is the part worth being careful about: a window
belongs to the day it STARTS on, so a Friday-only 23:30-07:00 covers Saturday
morning and must not cover Saturday night. That arithmetic was tested as pure
logic before anything was built on it, including every malformed input failing
closed -- silencing someone because a time string was wrong is the worst way
this could fail.

This does not take over the manual timed session. FocusSession already owns
that, with its capsule, shortcut, Quick Settings entry and contracts, so modes
defer entirely while one runs. Two writers of Do Not Disturb would each restore
whatever the other happened to leave behind.

Gaming hands over rather than being duplicated. The hook was silencing
notifications itself, which would have made exactly those two owners -- and
Gaming.active only polls while its settings page is open, so a mode could not
have seen a game reliably in any case. The hook reports the game over IPC now
and the mode decides what that means, the Gaming page points at it, and
gamingSilenceNotifications is retired from the schema, since a setting nothing
reads is the dead row this work keeps removing.

Sleep ships disabled. A desktop that starts silencing someone on first boot has
overstepped, whatever the default hour.

Three contracts moved with it. gaming-contract asserted the hook uses setDnd,
which was right before and wrong now; the shell-side assertions that setDnd and
dndState exist stay, because a toggle would flip an already-silent machine back
on. The new contract is proven to fail by breaking the midnight rule and by
letting modes run alongside a manual session.

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

This commit is contained in:

Gabriel Brown

2026-08-20 02:06:50 -04:00

parent 32fab59d24

commit 6dc606b872

11 changed files with 650 additions and 25 deletions

									
										config/dot/quickshell/shell.qml
									
		+6
		
												View File
												
				@@ -141,6 +141,12 @@ ShellRoot {

				            FocusSession.startDefault();

				            return FocusSession.active;

				        }

				        // Told by the gamemode hooks, which are the only thing that reliably

				        // knows a game started. The hook used to set Do Not Disturb itself;

				        // now it reports the fact and the mode decides what that means.

				        function gameStarted(): void { FocusModes.gameRunning = true; }

				        function gameEnded(): void { FocusModes.gameRunning = false; }

				        function reveal(): void { FocusSession.reveal(); }

				        function dismiss(): void { FocusSession.dismiss(); }

				        function pause(): void { FocusSession.pauseOrResume(); }