refactor: standardize file-level comments, drop unused pkgs, and theme lazygit with base16

- Move inline comments to top of file across all modules for consistent
style
- Add descriptive comments to files missing them (aggregators,
assertions, scripts, flake)
- Remove unused `pkgs` parameter from i3/keybindings.nix and
zathura/default.nix
- Drop explicit `package = pkgs.zathura` (home-manager provides the
default)
- Delete stale meli-sync.sh (migrated to neomutt)
- Remove extraneous blank lines for consistent formatting
- Theme lazygit with config.scheme base16 colors instead of hardcoded
names

16 files changed, 16 insertions, 32 deletions

diff --git a/modules/desktop/polybar/module/battery.nix b/modules/desktop/polybar/module/battery.nix
index d392e16..6dafb67 100644
--- a/modules/desktop/polybar/module/battery.nix
+++ b/modules/desktop/polybar/module/battery.nix
@@ -1,6 +1,5 @@
-{ config }:
-
 # Battery - Battery status module with icons and charging animation
+{ config }:
 with config.scheme.withHashtag;
 {
   type = "internal/battery";
diff --git a/modules/desktop/polybar/module/cpu.nix b/modules/desktop/polybar/module/cpu.nix
index 9d5b859..44ba984 100644
--- a/modules/desktop/polybar/module/cpu.nix
+++ b/modules/desktop/polybar/module/cpu.nix
@@ -1,6 +1,5 @@
-{ config }:
-
 # CPU - CPU usage percentage module
+{ config }:
 with config.scheme.withHashtag;
 {
   type = "internal/cpu";
diff --git a/modules/desktop/polybar/module/date.nix b/modules/desktop/polybar/module/date.nix
index 7a9e1ca..45e373b 100644
--- a/modules/desktop/polybar/module/date.nix
+++ b/modules/desktop/polybar/module/date.nix
@@ -1,6 +1,5 @@
-{ config }:
-
 # Date - Current date display module
+{ config }:
 with config.scheme.withHashtag;
 {
   type = "internal/date";
diff --git a/modules/desktop/polybar/module/default.nix b/modules/desktop/polybar/module/default.nix
index e759d47..785cd6f 100644
--- a/modules/desktop/polybar/module/default.nix
+++ b/modules/desktop/polybar/module/default.nix
@@ -1,10 +1,9 @@
+# Module - Polybar module definitions (battery, cpu, date, i3, memory, volume, wifi, etc.)
 {
   lib,
   config,
   pkgs,
 }:
-
-# Module - Polybar module definitions (battery, cpu, date, i3, memory, volume, wifi, etc.)
 {
   "module/battery" = import ./battery.nix { inherit config; };
   "module/cpu" = import ./cpu.nix { inherit config; };
diff --git a/modules/desktop/polybar/module/ethernet-separator.nix b/modules/desktop/polybar/module/ethernet-separator.nix
index cfdf9e4..3bdcb0e 100644
--- a/modules/desktop/polybar/module/ethernet-separator.nix
+++ b/modules/desktop/polybar/module/ethernet-separator.nix
@@ -1,6 +1,5 @@
-{ config }:
-
 # Ethernet-separator - Visual separator for ethernet module
+{ config }:
 with config.scheme.withHashtag;
 {
   type = "internal/network";
diff --git a/modules/desktop/polybar/module/ethernet.nix b/modules/desktop/polybar/module/ethernet.nix
index 72f8e0c..4e8dfed 100644
--- a/modules/desktop/polybar/module/ethernet.nix
+++ b/modules/desktop/polybar/module/ethernet.nix
@@ -1,6 +1,5 @@
-{ config }:
-
 # Ethernet - Wired network module (connection speed)
+{ config }:
 with config.scheme.withHashtag;
 {
   type = "internal/network";
diff --git a/modules/desktop/polybar/module/i3.nix b/modules/desktop/polybar/module/i3.nix
index f910b80..57e83dc 100644
--- a/modules/desktop/polybar/module/i3.nix
+++ b/modules/desktop/polybar/module/i3.nix
@@ -1,6 +1,5 @@
-{ config }:
-
 # i3 - i3 workspace display module (focused, occupied, urgent workspaces)
+{ config }:
 with config.scheme.withHashtag;
 {
   type = "internal/i3";
diff --git a/modules/desktop/polybar/module/memory.nix b/modules/desktop/polybar/module/memory.nix
index d032377..b401703 100644
--- a/modules/desktop/polybar/module/memory.nix
+++ b/modules/desktop/polybar/module/memory.nix
@@ -1,6 +1,5 @@
-{ config }:
-
 # Memory - RAM usage module (displays GB used)
+{ config }:
 with config.scheme.withHashtag;
 {
   type = "internal/memory";
diff --git a/modules/desktop/polybar/module/separator.nix b/modules/desktop/polybar/module/separator.nix
index 23b52b9..f24b975 100644
--- a/modules/desktop/polybar/module/separator.nix
+++ b/modules/desktop/polybar/module/separator.nix
@@ -1,6 +1,5 @@
-{ config }:
-
 # Separator - Visual separator between modules
+{ config }:
 with config.scheme.withHashtag;
 {
   type = "custom/text";
diff --git a/modules/desktop/polybar/module/time.nix b/modules/desktop/polybar/module/time.nix
index e8dae08..4e6a03d 100644
--- a/modules/desktop/polybar/module/time.nix
+++ b/modules/desktop/polybar/module/time.nix
@@ -1,6 +1,5 @@
-{ config }:
-
 # Time - Current time display module (12-hour format)
+{ config }:
 with config.scheme.withHashtag;
 {
   type = "internal/date";
diff --git a/modules/desktop/polybar/module/volume.nix b/modules/desktop/polybar/module/volume.nix
index 1d1352a..1dfbb8e 100644
--- a/modules/desktop/polybar/module/volume.nix
+++ b/modules/desktop/polybar/module/volume.nix
@@ -1,6 +1,5 @@
-{ config }:
-
 # Volume - PulseAudio volume level module with icons
+{ config }:
 with config.scheme.withHashtag;
 {
   type = "internal/pulseaudio";
diff --git a/modules/desktop/polybar/module/vpn-separator.nix b/modules/desktop/polybar/module/vpn-separator.nix
index 3400298..48122cd 100644
--- a/modules/desktop/polybar/module/vpn-separator.nix
+++ b/modules/desktop/polybar/module/vpn-separator.nix
@@ -1,10 +1,9 @@
+# VPN-separator - Visual separator for VPN module
 {
   pkgs,
   lib,
   config,
 }:
-
-# VPN - Visual separator for VPN module
 with config.scheme.withHashtag;
 {
   type = "custom/script";
diff --git a/modules/desktop/polybar/module/vpn.nix b/modules/desktop/polybar/module/vpn.nix
index be5e54d..6230b8d 100644
--- a/modules/desktop/polybar/module/vpn.nix
+++ b/modules/desktop/polybar/module/vpn.nix
@@ -1,10 +1,9 @@
+# VPN - Just indicates if VPN is connected with openvpn
 {
   pkgs,
   lib,
   config,
 }:
-
-# VPN - Just indicates if VPN is connected with openvpn
 with config.scheme.withHashtag;
 {
   type = "custom/script";
diff --git a/modules/desktop/polybar/module/wifi-separator.nix b/modules/desktop/polybar/module/wifi-separator.nix
index 6bb42cb..0d51b06 100644
--- a/modules/desktop/polybar/module/wifi-separator.nix
+++ b/modules/desktop/polybar/module/wifi-separator.nix
@@ -1,6 +1,5 @@
-{ config }:
-
 # WiFi-separator - Visual separator for WiFi module
+{ config }:
 with config.scheme.withHashtag;
 {
   type = "internal/network";
diff --git a/modules/desktop/polybar/module/wifi.nix b/modules/desktop/polybar/module/wifi.nix
index 6ee848f..8836b9e 100644
--- a/modules/desktop/polybar/module/wifi.nix
+++ b/modules/desktop/polybar/module/wifi.nix
@@ -1,6 +1,5 @@
-{ config }:
-
 # WiFi - Wireless network module (signal strength, speed)
+{ config }:
 with config.scheme.withHashtag;
 {
   type = "internal/network";
diff --git a/modules/desktop/polybar/module/xwindow.nix b/modules/desktop/polybar/module/xwindow.nix
index 79c0f95..d36b03c 100644
--- a/modules/desktop/polybar/module/xwindow.nix
+++ b/modules/desktop/polybar/module/xwindow.nix
@@ -1,6 +1,5 @@
-{ }:
-
 # XWindow - Focused window title module
+{ }:
 {
   type = "internal/xwindow";
   label = "%title:0:20:...%";