====== 📜 System Automation & Scripts Manual ======

This guide details the custom scripts and services implemented to manage the **Arrow Lake + SRIOV** workstation.

===== 🖥️ RDP & VM Management =====

==== launch_rdp.sh ====
**Purpose:** Advanced RDP launcher with performance profiles and safety checks.
  * **Usage:** \`./launch_rdp.sh [mode]\`
  * **Modes:**
    * \`performance\`: AVC444 + Progressive (Highest quality, may be unstable).
    * \`high-perf\`: AVC420 + Thin-Client (Stable, near-native performance).
    * \`compat\`: RFX mode (Maximum stability).
  * **Features:** Auto-IP resolution, 24h Auto-Snapshot, Lock-on-Disconnect.

==== rdp_watchdog.sh ====
**Purpose:** Background service that keeps your RDP session alive.
  * **Usage:** \`./rdp_watchdog.sh &\`
  * **Logic:** Automatically restarts RDP on crash. If 3 crashes occur within 5 mins, it stops and pings your phone via KDE Connect.

==== rdp_reset.sh ====
**Purpose:** "Panic Button" for frozen sessions.
  * **Usage:** \`./rdp_reset.sh\`
  * **Actions:** Kills all RDP processes, triggers a hardware **Function Level Reset (FLR)** on the iGPU VF, and restarts in Compatibility Mode.

==== rdp_run.sh ====
**Purpose:** Linux-to-Windows command orchestration.
  * **Usage:** \`./rdp_run.sh "app.exe"\` (e.g., \`./rdp_run.sh "Raid.exe"\`).
  * **Requirement:** QEMU Guest Agent must be running in the VM.

==== usb_swap.sh ====
**Purpose:** Hot-swap USB devices into the running VM.
  * **Usage:** \`./usb_swap.sh\`
  * **Logic:** Select a device from the list and choose **(a)**ttach or **(d)**etach.

===== 📊 Monitoring & HUD =====

==== monitor_performance.sh ====
**Purpose:** Unified Host/Guest health logger.
  * **Run Frequency:** Every 10 mins (Cron).
  * **Data:** CPU/GPU Wattage, Temps, Windows CPU/RAM usage, IO Wait.
  * **Wiki Page:** [[system:performance]]

==== security_audit.sh ====
**Purpose:** "Fail-Closed" security monitor.
  * **Run Frequency:** Every 10 mins (Cron).
  * **Data:** Open ports, Sudoers integrity, Shared folder perms, Failed login attempts.
  * **Wiki Page:** [[system:security]]

==== core_watch.sh ====
**Purpose:** Thermal and Affinity watcher.
  * **Data:** Intel Thermal Throttling status and VM P-Core pinning verification.
  * **Wiki Page:** [[system:thermal]]

==== hud_toggle.sh ====
**Purpose:** Desktop HUD (Conky) controller.
  * **Usage:** \`./hud_toggle.sh\`
  * **Note:** Set to autostart on login. Shows live data from the logs above.

===== 🛡️ System Integrity =====

==== fast_snap.sh ====
**Purpose:** Manual/Automated Btrfs snapshots.
  * **Usage:** \`./fast_snap.sh\`
  * **Targets:** Creates timestamped snapshots of \`@\` and \`@home\`.

==== audit_drivers.sh ====
**Purpose:** Compatibility tracking.
  * **Usage:** Tracks Kernel, SRIOV, and BIOS versions to detect breaking updates.

==== fukubaloo.sh ====
**Purpose:** Performance purge.
  * **Note:** Runs on startup via \`~/.config/autostart\`. Kills Baloo and Akonadi to free up P-Cores.