- Switch from OBS Package Installer (opi) to direct zypper installation
- Auto-add darix-playground repository if not already present
- Improve logging and user feedback during installation
- Remove AGS removal fallback section (no longer needed)
Context:
- Investigated report that `ags -t overview` returns "undefined" when executed over SSH on the openSUSE host.
- Over SSH there is no graphical session (DISPLAY/WAYLAND_DISPLAY unset) and typically no running AGS instance to receive the toggle command, so `ags` prints "undefined". This is expected behavior in a headless shell.
What this change does:
- Introduces project-scoped WARP.md to accelerate future work in this repo.
- Captures essential commands: interactive install, preset usage, re-running individual modules from repo root, auto-install wrapper, uninstall, and log tailing.
- Summarizes the high-level modular architecture (entrypoint flow, environment detection, module library with Global_functions helpers, and automation scripts).
- Notes key usage constraints pulled from README (don’t run as root, SDDM disabled if other display managers are active, NVIDIA G06 path, VM 3D accel requirement).
- Documents the practical caveat uncovered during AGS debugging: headless/SSH shells will not be able to toggle AGS UI and will show "undefined" unless an AGS instance is running in the user’s Wayland session.
Why now:
- The lack of a repo-scoped WARP.md made it slower to reason about installer modules and the AGS behavior. This doc helps future troubleshooting and contributions.
Follow-ups (not in this commit):
- Consider adding a guard to the AGS wrapper created by install-scripts/ags.sh to detect missing DISPLAY/WAYLAND_DISPLAY or missing running AGS instance and print a helpful message instead of surfacing the raw "undefined".
- Optional: shellcheck/shfmt pass for bash modules (no configured linters here).
