Tracking: HyDE / Caelestia / end-4 desktop-shell conflicts

[8syncdev]

Living tracking issue for desktop-shell integration conflicts. Detailed root-cause / fix / recovery for each KI lives in docs/known-issues.md — this issue is just an index.

Status

ID	First hit	Fixed in	Subsystem
KI-001	v0.5.1	v0.6.1	--end4 overwrote hyprland.conf, broke HyDE keybinds
KI-002	v0.6.0	v0.6.1	pkill waybar ineffective on HyDE — systemd transient unit respawns instantly
KI-003	v0.6.0	v0.6.2	HyDE waybar respawns on reboot even after stop — fixed by mask

TL;DR for users hitting this

Safe install on a HyDE machine:

8sync setup --end4              # cài files, KHÔNG đụng entry config, KHÔNG kích hoạt
8sync setup --end4=overlay      # bật end-4 Quickshell shell trên HyDE keybinds
8sync setup --end4=rollback-overlay   # tháo overlay, khôi phục HyDE waybar

Lost HyDE keybinds from running an old v0.5.x --end4? Recovery steps in docs/known-issues.md#ki-001.

Rules for future shell-integration PRs

Before merging any new desktop-shell profile / overlay mode, verify against a HyDE-base machine:

• ~/.config/hypr/hyprland.conf unchanged (or backed up with restorable sibling)
• HyDE keybinds still fire ($mainMod+T, $mainMod+/)
• Exactly one shell running (pgrep -fa waybar, pgrep -fa 'qs -c')
• Conflicting systemd user services MASKED (not just stopped) — survives reboot
• Symmetric rollback flag exists (every mask has unmask; every sentinel-block insert has sed-delete)
• Dry-run prints every command, no destructive side effects

Reopen this issue (or comment with a new KI-NNN entry) whenever a new conflict surfaces.