Parent: #21
Phase: v1.4.0 promotion and compatibility migration.
Blocked by: #85
Goal
Promote the field-validated native Wayland provider to the normal non-GNOME path while retaining delegated swayidle as an explicit, deprecated compatibility backend for existing installations and older compositors.
Scope
- Update
screen_backend=auto selection to prefer:
- the complete native GNOME contract
- the supported native Wayland protocol contract
- delegated
swayidle compatibility when installed
- Stop presenting
swayidle as a normal choice in fresh interactive configuration.
- Continue accepting and running existing explicit
screen_backend=swayidle configurations during the compatibility window.
- Emit a clear deprecation notice for explicit delegated-backend use.
- Do not silently rewrite an existing backend selection.
- Make the resolved provider, capability/version limitation, and fallback reason visible in settings and diagnostics.
- Document compositor requirements, compatibility fallback behavior, and the planned v2.0.0 removal.
- Extend settings, detection, installer, and release-smoke coverage for promotion and legacy configuration.
Acceptance criteria
Out of scope
Parent: #21
Phase: v1.4.0 promotion and compatibility migration.
Blocked by: #85
Goal
Promote the field-validated native Wayland provider to the normal non-GNOME path while retaining delegated
swayidleas an explicit, deprecated compatibility backend for existing installations and older compositors.Scope
screen_backend=autoselection to prefer:swayidlecompatibility when installedswayidleas a normal choice in fresh interactive configuration.screen_backend=swayidleconfigurations during the compatibility window.Acceptance criteria
auto.screen_backend=swayidlevalue continues to work and reports deprecation clearly.Out of scope
swayidlecode, tests, or installer support.