From 5257e11b8d1e4a2542aa0b1d9cbf807d1ca047db Mon Sep 17 00:00:00 2001
From: LGUG2Z <LGUG2Z@fastmail.com>
Date: Fri, 6 Nov 2026 13:37:11 -0800
Subject: [PATCH] feat(e2e): what the macOS daemon does differently, marked,
 and what it does not have, skipped

The first run of the scenarios against a real guest ended with 32 failing checks of 586. A window the
daemon puts away is parked with a sliver showing (fixed in the platform), and the rest are differences of
the macOS daemon, marked on the checks that are about them, with the reason:

- stacks: it stacks by raising the focused window over the others, and never puts the others away
- fullscreen: it has no fullscreen detection, and tiles a window over the whole display
- layout_flip: it tiles 10 px below the top of the work area and 12 px above its bottom
- class: a window has none, the daemon matches the role, which every test window shares

placement is skipped as a whole: the macOS daemon has no initial_window_placement_rules.
---
 e2e/platforms/tart_macos/run.py | 43 ++++++++++++++++++++++++++++++++-
 1 file changed, 42 insertions(+), 1 deletion(-)

diff --git a/e2e/platforms/tart_macos/run.py b/e2e/platforms/tart_macos/run.py
index 77c7b2f2..541049c4 100644
--- a/e2e/platforms/tart_macos/run.py
+++ b/e2e/platforms/tart_macos/run.py
@@ -56,8 +56,48 @@ UNSUPPORTED = {
     "locking": "a macOS guest has no lock screen to test",
     "wallpaper": "the wallpaper of a macOS guest is not read yet",
     "rules_class": "a macOS window has no class",
+    "placement": "the macOS daemon has no initial_window_placement_rules",
 }
 
+# the checks of a scenario that are about a difference of the macOS daemon, by a part of their
+# description, and the difference; the others of the scenario are checks as any. A mark whose check
+# passes is a failure, to say that it can go.
+KNOWN_CHECKS = {
+    # stacks
+    "exactly one window is put away": "STACK",
+    "after 'cycle-stack next' the other window of the stack is in view and the first is away": "STACK",
+    "cycling back, the first is in view again": "STACK",
+    # fullscreen
+    "it does not take the window out of fullscreen": "FULLSCREEN",
+    "not on any other window": "FULLSCREEN",
+    # layout_flip
+    "BSP, 3 windows, layout_flip Vertical: ... each where the mirror of its place is": "MARGINS",
+    "BSP, 3 windows, layout_flip HorizontalAndVertical: ... each where the mirror of its place is": "MARGINS",
+    # the class of a window
+    "an ignore rule by class matches is not managed": "CLASS",
+    "keeps its place (class)": "CLASS",
+    "the state has the class a window was given": "CLASS",
+}
+DIFFERENCES = {
+    "STACK": (
+        "the macOS daemon stacks by raising the focused window over the others: the other windows "
+        "of a stack stay on the display, at the same place, where Windows and KDE put them away"
+    ),
+    "FULLSCREEN": (
+        "the macOS daemon has no fullscreen detection: it tiles a window that covers the whole "
+        "display with the others"
+    ),
+    "MARGINS": (
+        "the daemon tiles 10 px below the top of the work area the system reports and 12 px above "
+        "its bottom, so a vertical mirror is a few pixels off"
+    ),
+    "CLASS": (
+        "a macOS window has no class: the daemon matches the role of the window, which every "
+        "window of the test program shares"
+    ),
+}
+KNOWN_CHECKS = {key: DIFFERENCES[name] for key, name in KNOWN_CHECKS.items()}
+
 
 class GuestDied(RuntimeError):
     """The guest exited while a scenario was running: not what the daemon did."""
@@ -68,7 +108,7 @@ def run_one(golden: str, bin_dir: Path, out: Path, name: str) -> RecordedChecks:
     scenario = importlib.import_module(f"komorebi_vm.core.scenarios.{name}")
     tiling = importlib.import_module("komorebi_vm.core.scenarios.tiling")
 
-    checks = RecordedChecks()
+    checks = RecordedChecks(KNOWN_CHECKS)
     print(f"== {name}")
     began = time.monotonic()
     timings: dict[str, float] = {}
@@ -110,6 +150,7 @@ def run_one(golden: str, bin_dir: Path, out: Path, name: str) -> RecordedChecks:
                         for more in MORE.get(name, ())
                     ),
                 )
+            checks.stale_marks()
         except Exception as e:
             died = guest.died()
             if died: