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

8 files changed, 7 insertions, 5 deletions

diff --git a/modules/scripts/aria2-run.sh b/modules/scripts/aria2-run.sh
index 167fc5d..e151b53 100644
--- a/modules/scripts/aria2-run.sh
+++ b/modules/scripts/aria2-run.sh
@@ -1 +1,2 @@
+# Start aria2 RPC daemon
 aria2c --enable-rpc --rpc-listen-all=false --rpc-listen-port=6800
diff --git a/modules/scripts/default.nix b/modules/scripts/default.nix
index 8ad27a3..ffde799 100644
--- a/modules/scripts/default.nix
+++ b/modules/scripts/default.nix
@@ -1,3 +1,4 @@
+# Scripts - Generates wrapped scripts with environment variables and dependencies
 {
   config,
   lib,
diff --git a/modules/scripts/file-preview-clean.sh b/modules/scripts/file-preview-clean.sh
index ee8ca73..006f63c 100644
--- a/modules/scripts/file-preview-clean.sh
+++ b/modules/scripts/file-preview-clean.sh
@@ -1 +1,2 @@
+# Clear kitty icat preview after lf exits
 exec kitten icat --clear --stdin no --transfer-mode file </dev/null >/dev/tty
diff --git a/modules/scripts/fzf-launcher.sh b/modules/scripts/fzf-launcher.sh
index edc39ab..1d7f968 100644
--- a/modules/scripts/fzf-launcher.sh
+++ b/modules/scripts/fzf-launcher.sh
@@ -1,3 +1,4 @@
+# Fzf-launcher - FZF-based application launcher (scans .desktop files)
 DIRS=(
   /run/current-system/sw/share/applications
   "$HOME/.nix-profile/share/applications"
diff --git a/modules/scripts/meli-sync.sh b/modules/scripts/meli-sync.sh
deleted file mode 100644
index 2024562..0000000
--- a/modules/scripts/meli-sync.sh
+++ /dev/null
@@ -1,5 +0,0 @@
-#!/usr/bin/env sh
-
-# Sync all accounts and immediately tag with notmuch
-mbsync -a
-notmuch new 2>/dev/null
\ No newline at end of file
diff --git a/modules/scripts/neomutt-sync.sh b/modules/scripts/neomutt-sync.sh
index a28152c..1adbc7f 100644
--- a/modules/scripts/neomutt-sync.sh
+++ b/modules/scripts/neomutt-sync.sh
@@ -1,3 +1,4 @@
+# Neomutt-sync - Interactive mail sync with dialog progress bar
 # 1. Create temporary files for the dark theme and notmuch logs
 export DIALOGRC=$(mktemp)
 NOTMUCH_LOG=$(mktemp)
diff --git a/modules/scripts/vpn-connect.sh b/modules/scripts/vpn-connect.sh
index 4ba8f3d..337fa2e 100644
--- a/modules/scripts/vpn-connect.sh
+++ b/modules/scripts/vpn-connect.sh
@@ -1,3 +1,4 @@
+# VPN-connect - OpenVPN connection script with credential caching and monitoring
 CONF_DIR="$HOME/.config/openvpn"
 CREDS_DIR="$CONF_DIR/credentials"
 SERVERS_DIR="$CONF_DIR/servers"
diff --git a/modules/scripts/vpn-disconnect.sh b/modules/scripts/vpn-disconnect.sh
index ead912c..9a70231 100644
--- a/modules/scripts/vpn-disconnect.sh
+++ b/modules/scripts/vpn-disconnect.sh
@@ -1,3 +1,4 @@
+# VPN-disconnect - Kill VPN process and clean up
 PID_FILE="$HOME/.cache/openvpn/vpn.pid"
 
 if [[ ! -f "$PID_FILE" ]]; then