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

12 files changed, 12 insertions, 2 deletions

diff --git a/modules/communication/default.nix b/modules/communication/default.nix
index cd8f0d6..ccb7188 100644
--- a/modules/communication/default.nix
+++ b/modules/communication/default.nix
@@ -1,3 +1,4 @@
+# Communication - Email client modules
 { ... }:
 
 {
diff --git a/modules/communication/neomutt/.neomuttrc b/modules/communication/neomutt/.neomuttrc
index 9e0a42f..829951a 100644
--- a/modules/communication/neomutt/.neomuttrc
+++ b/modules/communication/neomutt/.neomuttrc
@@ -42,7 +42,7 @@ color progress    black         yellow      # 󰦖 base0A bg (Progress bar)
 
 # Selected row and status bar
 color status      white         brightblack # base05  on base03
-color indicator   default       brightblack #  default on base03 (Selected email)
+color indicator   default       brightblack # default on base03 (Selected email)
 color tree        magenta       default     # base03  (Thread arrows)
 
 # Whole-line fallback for the index (base for anything not caught below)
diff --git a/modules/communication/neomutt/account/default.nix b/modules/communication/neomutt/account/default.nix
index 183e5ff..0b75c9a 100644
--- a/modules/communication/neomutt/account/default.nix
+++ b/modules/communication/neomutt/account/default.nix
@@ -1,3 +1,4 @@
+# Account - Converts neomutt account options into home-manager email config
 { config, lib, ... }:
 
 with lib;
diff --git a/modules/communication/neomutt/account/flavors/gmail.nix b/modules/communication/neomutt/account/flavors/gmail.nix
index 5ccceed..24035b2 100644
--- a/modules/communication/neomutt/account/flavors/gmail.nix
+++ b/modules/communication/neomutt/account/flavors/gmail.nix
@@ -1,3 +1,4 @@
+# Gmail - Gmail-specific defaults for folder names, mbsync patterns, and mailboxes
 {
   config,
   lib,
diff --git a/modules/communication/neomutt/account/options.nix b/modules/communication/neomutt/account/options.nix
index bb53231..8b34062 100644
--- a/modules/communication/neomutt/account/options.nix
+++ b/modules/communication/neomutt/account/options.nix
@@ -1,3 +1,4 @@
+# Options - Email account option definitions (realName, address, folders, gpg, etc.)
 { lib, ... }:
 
 {
diff --git a/modules/communication/neomutt/assertions.nix b/modules/communication/neomutt/assertions.nix
index b85280e..b7b58ad 100644
--- a/modules/communication/neomutt/assertions.nix
+++ b/modules/communication/neomutt/assertions.nix
@@ -1,3 +1,4 @@
+# Assertions - Validates neomutt dependencies (less, bat, kitty) are enabled
 { config, ... }:
 
 {
diff --git a/modules/communication/neomutt/default.nix b/modules/communication/neomutt/default.nix
index c5cbaf0..96b6f59 100644
--- a/modules/communication/neomutt/default.nix
+++ b/modules/communication/neomutt/default.nix
@@ -1,3 +1,4 @@
+# Neomutt - Email suite entry point (neomutt + mbsync + notmuch)
 { config, lib, ... }:
 
 {
diff --git a/modules/communication/neomutt/keybindings.nix b/modules/communication/neomutt/keybindings.nix
index 949d520..8fde25e 100644
--- a/modules/communication/neomutt/keybindings.nix
+++ b/modules/communication/neomutt/keybindings.nix
@@ -1,5 +1,5 @@
+# Keybindings - Vim-style keyboard shortcuts for neomutt
 { config, lib, ... }:
-
 {
   config.programs.neomutt.binds = lib.mkIf config.communication.neomutt.enable [
     # --- sidebar navigation (vim: k=up, j=down) ---
diff --git a/modules/communication/neomutt/macros.nix b/modules/communication/neomutt/macros.nix
index e1a754e..ae1d84e 100644
--- a/modules/communication/neomutt/macros.nix
+++ b/modules/communication/neomutt/macros.nix
@@ -1,3 +1,4 @@
+# Macros - neomutt macros for sync, URL extraction, flag legend, and quit
 { config, lib, ... }:
 
 {
diff --git a/modules/communication/neomutt/sync/default.nix b/modules/communication/neomutt/sync/default.nix
index 3fd9362..765b22a 100644
--- a/modules/communication/neomutt/sync/default.nix
+++ b/modules/communication/neomutt/sync/default.nix
@@ -1,3 +1,4 @@
+# Sync - Mail synchronization modules (mbsync, notmuch)
 { ... }:
 
 {
diff --git a/modules/communication/neomutt/sync/mbsync.nix b/modules/communication/neomutt/sync/mbsync.nix
index 6d5ad86..71a98a0 100644
--- a/modules/communication/neomutt/sync/mbsync.nix
+++ b/modules/communication/neomutt/sync/mbsync.nix
@@ -1,3 +1,4 @@
+# Mbsync - Mailbox synchronization (isync/mbsync)
 { config, lib, ... }:
 
 with lib;
diff --git a/modules/communication/neomutt/sync/notmuch.nix b/modules/communication/neomutt/sync/notmuch.nix
index 9679bf4..75f4c32 100644
--- a/modules/communication/neomutt/sync/notmuch.nix
+++ b/modules/communication/neomutt/sync/notmuch.nix
@@ -1,3 +1,4 @@
+# Notmuch - Mail indexer for fast email search
 { config, lib, ... }:
 
 with lib;