substantial improvements to reliability

- substantial improvements to multi-monitor
- new integration testing suite

Author: khimaros

.gitignore

@@ -4,3 +4,4 @@ smart-auto-move.dconf
 AGENTS.md
 CLAUDE.md
 GEMINI.md
+/tmp

CONTRIBUTING.md

@@ -29,66 +29,6 @@ see commit 9edd9e3210a1541d5c2915943c7a2b238ce7a856 for an end-to-end example.
 1. upload the zip to extensions.gnome.org
 1. repeat as needed if a version is rejected
 
-## manual tests
+## testing
 
-- disable the extension
-- reset the dconf settings
-- enable the extension
-- open calculator, move, resize, close, reopen (should restore)
-- open extension settings
-- switch default sync to IGNORE
-- open calculator, move, close, reopen (should NOT restore)
-- add an app override for calculator
-- set calculator override sync mode to RESTORE
-- click spin button down to 0.10 threshold
-- open calculator, move, close, reopen (should restore)
-- open nautilus, move, close, reopen (should NOT restore)
-- add an app override for firefox
-- open three firefox windows with three different websites
-- tile one per workspace, menu -> quit, reopen (all should restore)
-- switch tabs on one of the windows, menu -> quit, reopen (all should restore)
-- add app override for terminal
-- open three terminals and move them to slightly different locations
-- close and reopen terminals in a random order and make sure they fill open slots
-
-## archive
-
-### calculator
-
-- open calculator
-- move calculator position
-- resize calculator
-- close calculator
-- open calculator
-- quickly close calculator
-- open calculator
-
-### files
-
-- open Places => Home
-- open a second Places => Home
-- tile first window to the left
-- move second Home window
-- close first Home window
-- change second Home window to Downloads
-- close Downloads window
-- open Places -> Downloads
-- open Places -> Home
-- move Downloads to workspace 2
-- tile Downloads to the right
-
-### firefox
-
-- launch firefox
-- navigate to Wikipedia.org
-- open second window
-- navigate to Mozilla.org
-- move first window to workspace 2
-- tile first window to left
-- tile second window to right
-- firefox Menu -> Quit
-- launch firefox
-- open new tab in Mozilla window
-- navigate to Google.com
-- firefox Menu -> Quit
-- launch firefox
+see TESTING.md

ROADMAP.md

@@ -1,8 +1,13 @@
 # ROADMAP
 
 ```
-[ ] support testing in a virtual machine or container
+[@] reusable core shared with window-control extension
+
+[x] fix issue with infinitely bouncing windows
+[x] automated testing in a virtual machine or container
     eg. https://schneegans.github.io/tutorials/2022/03/02/gnome-shell-extensions-ci-03
+[x] multi-monitor support
+
 [ ] incorporate useful features and fixes from popular fork
     https://github.com/ChrisLauinger77/gnome-shell-extension-SmartAutoMoveNG
 ```

TESTING.md

@@ -0,0 +1,60 @@
+# TESTING
+
+## bootstrap
+
+should be run after code changes
+
+- build the extension on host
+- install the extension on the guest
+- guest logout and wait for autologin
+
+## cleanup
+
+should be run between each test
+
+- disable the extension
+- reset the dconf settings
+- enable the extension
+
+## orchestration
+
+window orchestration is done by /srv/window-control/windowbot.py
+
+test configs for windowbot are in /srv/window-control/testdata/
+
+some configs have long delays with title changes/etc. tests should be resilient to those.
+
+## stories
+
+## default settings, calculator restore
+
+- open calculator, move, resize, close, reopen (should restore)
+
+## sync mode ignore, override calculator restore
+
+- set default sync mode to IGNORE
+- open calculator, move, close, reopen (should NOT restore)
+- add an app override for calculator (mode RESTORE, 0.7 threshold)
+- open calculator, move, close, reopen (should restore)
+- open nautilus, move, close, reopen (should NOT restore)
+
+## workspace and tiling
+
+- launch the "fasttitle" windowbot config
+- wait for the window titles to settle
+- move the windows to the workspace and tile as described by their titles
+- quit and restart the windowbot session with "fasttitle" (should restore)
+- quit and restart the windowbot session with "slowtitle" (should restore, with long delays)
+
+## secondary monitors
+
+- launch the "single" windowbot config
+- tile the window to the right on the primary monitor
+- enable the secondary monitor
+- move the window to the secondary monitor and tile to the left
+- disable the secondary monitor (should move to primary and tile right)
+- enable the secondary monitor (should move to secondary and tile left)
+- quit and restart the windowbot session with "single" (should restore to secondary, tile left)
+- quit the windowbot session
+- disable the secondary monitor
+- start the windowbot session with "single" (should restore to primary, tile right)