luna/enodia-sentinal
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

feat(gui): add optional tkinter and Qt6 desktop dashboards

Browse source 
Add two optional windowed frontends over the same local state the TUI and
web console read: `enodia-sentinel gui` (stdlib tkinter) and
`enodia-sentinel gui-qt` (PySide6, new `[qt]` extra).

Both share `gui/model.py`, a GUI-free presentation model over
`tui.collect_model`, so every formatter is unit-testable without a display
server. Only `app.py` and `qt_app.py` import GUI libraries, enforced by
import-guard tests mirroring the tray applet's boundary.

Tabs cover status, alerts, incidents, posture, integrity, response plans,
and the event tail, plus daemon-control buttons via systemctl. Response
plans are display-only; the GUIs never execute containment commands. Core
runtime dependencies stay empty.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JX86xeoBJVBb16qHkDf53K
This commit is contained in:
Luna 2026-07-22 04:33:49 -07:00
parent 9e3575461b
commit 457c7604ba
No known key found for this signature in database
15 changed files with 1270 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

28
docs/COMMAND_REFERENCE.md
View file

@ -431,6 +431,34 @@ Command mode supports `status`, `alerts`, `incidents`, `timeline`, `posture`,
`back`, `refresh`,
`filter <text>`, `clear`, and `quit`.
### `gui` / `enodia-sentinel-gui`
```bash
enodia-sentinel gui
enodia-sentinel-gui
```
Opens the stdlib tkinter desktop dashboard. It reads the same local state as
the TUI and web console (daemon status, alerts, incidents, posture, integrity,
events, and read-only response plans) and adds a toolbar for daemon control:
start, stop, restart, quick check, open dashboard, and refresh.
Requires a working `tkinter` installation (usually the distro
`python-tk`/`python-tkinter` package); the core agent itself has no runtime
dependencies. Response plans are displayed for review only — the GUI does not
execute commands.
### `gui-qt` / `enodia-sentinel-gui-qt`
```bash
enodia-sentinel gui-qt
enodia-sentinel-gui-qt
```
Opens the optional Qt6 desktop dashboard. It shows the same read-only tabs and
daemon controls as the tkinter GUI with a native look, resizable columns, and
a response-plan detail pane. Requires the `[qt]` extra (`PySide6`).
### `web`
```bash