fix/raise_window

[wyzula-jan]

Description

On native Wayland with GNOME 40 and Qt 6.11.1, raising a BEC window could hide it instead of bringing it forward. This change works around the issue by recreating the native window resources while preserving the QWidget instances, their data, and BEC connections.

[Copilot]

🟡 Changes recommended

BECGuiClient.get_display_info() can incorrectly time out when attaching to an already-running GUI server due to relying on wait_for_server() without ensuring the started-event is set.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

This PR addresses a Qt/Wayland (GNOME 40, Qt 6.11.1) window-raising regression by changing the GUI RPC “raise” behavior to recreate native window resources on Wayland while preserving the underlying QWidget instances and BEC connections. It also introduces a system.get_display_info RPC and a corresponding client API (gui.get_display_info()) for collecting read-only display/window diagnostics from the running GUI process.

Changes:

• Update RPC window raising to be backend-aware: keep the existing X11/XWayland (“xcb”) GNOME/RHEL workaround while adding a Wayland-specific native-resource recreation path.
• Add GUI-side display diagnostics (get_display_info) and expose them through a new system.get_display_info system RPC plus a CLI client method.
• Add unit/e2e coverage and documentation for the new raise/show semantics and display diagnostics.

File summaries

File	Description
bec_widgets/utils/rpc_server.py	Routes "raise" RPC calls for QWidget instances through a new backend-aware _raise_window() and exposes system.get_display_info.
bec_widgets/utils/display_info.py	Adds GUI-process diagnostics collection for Qt backend, screens, windows, and selected environment variables.
bec_widgets/cli/client_utils.py	Makes show() delegate to raise_window() and adds BECGuiClient.get_display_info() client API.
tests/unit_tests/test_rpc_server.py	Adds comprehensive tests covering raise/show behavior across platforms, minimized/hidden states, and thread-safety via dispatcher callbacks.
tests/unit_tests/test_display_info.py	Adds tests verifying diagnostics content, JSON-serializability, and non-invasive behavior (no native window creation).
tests/unit_tests/test_client_utils.py	Adds tests for show/raise_window behavior and get_display_info() client RPC behavior.
tests/end-2-end/test_bec_gui_ipython.py	Adds an end-to-end test validating visibility toggling and diagnostics retrieval from the running GUI server.
README.md	Documents the new visibility/raise behavior and the display diagnostics feature.

Review details

• Files reviewed: 8/8 changed files
• Comments generated: 1
• Review effort level: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[codecov]

Codecov Report

❌ Patch coverage is 96.82540% with 2 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
bec_widgets/utils/display_info.py	90.00%	1 Missing and 1 partial ⚠️

📢 Thoughts on this report? Let us know!

[github-actions]

Benchmark comparison

Threshold: 20% (lower is better).
Result: 0 regression(s), 0 improvement(s) beyond threshold.

No benchmark regression exceeded the configured threshold.

No benchmark improvement exceeded the configured threshold.

All benchmark results

Benchmark	Baseline	Current	Change	Status
BEC IPython client with companion app	1.99235 s	2.0148 s	+1.13%	ok
BEC IPython client without companion app	2.00405 s	2.00899 s	+0.25%	ok
Import bec_widgets	0.01367 s	0.0135142 s	-1.14%	ok
tests/unit_tests/benchmarks/test_dock_area_benchmark.py::test_add_waveform_to_dock_area	0.153213 s	0.155412 s	+1.44%	ok