docs

gui.py

@@ -1,4 +1,14 @@
-# gui.py
+# gui.py
+"""
+Note(Gemini):
+The main DearPyGui interface orchestrator.
+This is not a simple UI wrapper; it's a complex state machine that:
+1. Handles multi-viewport docking (allowing panels to act as OS windows).
+2. Manages background daemon threads for AI requests so the UI doesn't block.
+3. Implements lock-protected comms queues for safe main-thread rendering.
+4. Pauses AI execution to prompt the human for destructive PowerShell script approval.
+"""
+# gui.py
 import dearpygui.dearpygui as dpg
 import tomllib
 import tomli_w