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

23 files changed, 23 insertions, 48 deletions

diff --git a/modules/desktop/default.nix b/modules/desktop/default.nix
index 18dc6a4..76ac223 100644
--- a/modules/desktop/default.nix
+++ b/modules/desktop/default.nix
@@ -1,10 +1,9 @@
+# Desktop - Desktop environment configuration (i3, GTK, polybar)
 {
   lib,
   config,
   ...
 }:
-
-# Desktop - Desktop environment configuration (i3, GTK, polybar)
 {
   imports = [
     ./i3
diff --git a/modules/desktop/gtk/default.nix b/modules/desktop/gtk/default.nix
index af33196..776fd3e 100644
--- a/modules/desktop/gtk/default.nix
+++ b/modules/desktop/gtk/default.nix
@@ -1,11 +1,10 @@
+# GTK - GTK3/GTK4 theme configuration (Nightfox dark theme)
 {
   config,
   lib,
   pkgs,
   ...
 }:
-
-# GTK - GTK3/GTK4 theme configuration (Nightfox dark theme)
 {
   config = lib.mkIf config.desktop.enable {
     gtk = {
diff --git a/modules/desktop/i3/default.nix b/modules/desktop/i3/default.nix
index c46123d..cef9cd0 100644
--- a/modules/desktop/i3/default.nix
+++ b/modules/desktop/i3/default.nix
@@ -1,11 +1,10 @@
+# i3 - Window manager configuration (gaps, colors, startup, keybindings)
 {
   config,
   lib,
   pkgs,
   ...
 }:
-
-# i3 - Window manager configuration (gaps, colors, startup, keybindings)
 {
   config = lib.mkIf config.desktop.enable {
     xsession.windowManager.i3 = {
@@ -89,7 +88,6 @@
         keybindings = lib.mkOptionDefault (
           import ./keybindings.nix {
             inherit
-              pkgs
               lib
               config
               ;
diff --git a/modules/desktop/i3/keybindings.nix b/modules/desktop/i3/keybindings.nix
index 600ed86..220fb86 100644
--- a/modules/desktop/i3/keybindings.nix
+++ b/modules/desktop/i3/keybindings.nix
@@ -1,10 +1,8 @@
+# Keybindings - i3 keyboard shortcuts (app launchers, vim directions, workspaces)
 {
-  pkgs,
   lib,
   config,
 }:
-
-# Keybindings - i3 keyboard shortcuts (app launchers, vim directions, workspaces)
 let
   mod = "Mod4";
 in
diff --git a/modules/desktop/polybar/bar/default.nix b/modules/desktop/polybar/bar/default.nix
index 44498c3..3b13420 100644
--- a/modules/desktop/polybar/bar/default.nix
+++ b/modules/desktop/polybar/bar/default.nix
@@ -1,6 +1,5 @@
-{ config }:
-
 # Bar - Polybar bar definitions (main bar)
+{ config }:
 {
   "bar/main" = import ./main.nix { inherit config; };
 }
diff --git a/modules/desktop/polybar/bar/main.nix b/modules/desktop/polybar/bar/main.nix
index 10afb3e..ed4f1fa 100644
--- a/modules/desktop/polybar/bar/main.nix
+++ b/modules/desktop/polybar/bar/main.nix
@@ -1,6 +1,5 @@
-{ config }:
-
 # Main - Main polybar bar configuration (dimensions, colors, modules)
+{ config }:
 with config.scheme.withHashtag;
 let
   largerFontSize = toString (builtins.ceil (config.fonts.size * 9.0 / 8.0));
diff --git a/modules/desktop/polybar/default.nix b/modules/desktop/polybar/default.nix
index 22cdc04..0ff7a43 100644
--- a/modules/desktop/polybar/default.nix
+++ b/modules/desktop/polybar/default.nix
@@ -1,11 +1,10 @@
+# Polybar - Status bar configuration (i3 integration, modules)
 {
   config,
   lib,
   pkgs,
   ...
 }:
-
-# Polybar - Status bar configuration (i3 integration, modules)
 {
   config = lib.mkIf config.desktop.enable {
     services.polybar.enable = true;
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:...%";