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, 8 insertions, 14 deletions

diff --git a/modules/media/default.nix b/modules/media/default.nix
index 5157734..d408b66 100644
--- a/modules/media/default.nix
+++ b/modules/media/default.nix
@@ -1,3 +1,4 @@
+# Media - Multimedia tools (feh, ffmpeg, maim, pamixer, playerctl, slop, vlc)
 { ... }:
 
 {
diff --git a/modules/media/feh/default.nix b/modules/media/feh/default.nix
index f3486e5..6caf96f 100644
--- a/modules/media/feh/default.nix
+++ b/modules/media/feh/default.nix
@@ -1,11 +1,10 @@
+# Feh - Lightweight image viewer and wallpaper setter
 {
   config,
   lib,
   pkgs,
   ...
 }:
-
-# Feh - Lightweight image viewer and wallpaper setter
 {
   options.media.feh = {
     enable = lib.mkEnableOption "Enables feh.";
diff --git a/modules/media/ffmpeg/default.nix b/modules/media/ffmpeg/default.nix
index 9526ff5..b0d5c25 100644
--- a/modules/media/ffmpeg/default.nix
+++ b/modules/media/ffmpeg/default.nix
@@ -1,11 +1,10 @@
+# FFmpeg - Command-line audio/video converter and streaming tool
 {
   config,
   pkgs,
   lib,
   ...
 }:
-
-# FFmpeg - Command-line audio/video converter and streaming tool
 {
   options.media.ffmpeg = {
     enable = lib.mkEnableOption "Enables ffmpeg.";
diff --git a/modules/media/maim/default.nix b/modules/media/maim/default.nix
index fcf53b7..a067935 100644
--- a/modules/media/maim/default.nix
+++ b/modules/media/maim/default.nix
@@ -1,11 +1,10 @@
+# Maim - Screenshot utility (slop-based region selection)
 {
   config,
   lib,
   pkgs,
   ...
 }:
-
-# Maim - Screenshot utility (slop-based region selection)
 {
   options.media.maim = {
     enable = lib.mkEnableOption "Enables maim.";
diff --git a/modules/media/pamixer/default.nix b/modules/media/pamixer/default.nix
index 3632ecc..9f47c68 100644
--- a/modules/media/pamixer/default.nix
+++ b/modules/media/pamixer/default.nix
@@ -1,11 +1,10 @@
+# Pamixer - PulseAudio command-line mixer (volume control)
 {
   config,
   lib,
   pkgs,
   ...
 }:
-
-# Pamixer - PulseAudio command-line mixer (volume control)
 {
   options.media.pamixer = {
     enable = lib.mkEnableOption "Enables pamixer.";
diff --git a/modules/media/playerctl/default.nix b/modules/media/playerctl/default.nix
index 58619a4..53ac353 100644
--- a/modules/media/playerctl/default.nix
+++ b/modules/media/playerctl/default.nix
@@ -1,11 +1,10 @@
+# Playerctl - CLI for controlling media players (Spotify, MPRIS, etc.)
 {
   config,
   lib,
   pkgs,
   ...
 }:
-
-# Playerctl - CLI for controlling media players (Spotify, MPRIS, etc.)
 {
   options.media.playerctl = {
     enable = lib.mkEnableOption "Enables playerctl.";
diff --git a/modules/media/slop/default.nix b/modules/media/slop/default.nix
index 8e2c01d..69af64b 100644
--- a/modules/media/slop/default.nix
+++ b/modules/media/slop/default.nix
@@ -1,11 +1,10 @@
+# Slop - Region selector for screenshots (used by maim/flameshot)
 {
   config,
   lib,
   pkgs,
   ...
 }:
-
-# Slop - Region selector for screenshots (used by maim/flameshot)
 {
   options.media.slop = {
     enable = lib.mkEnableOption "Enables slop.";
diff --git a/modules/media/vlc/default.nix b/modules/media/vlc/default.nix
index 7e008fb..7caf93c 100644
--- a/modules/media/vlc/default.nix
+++ b/modules/media/vlc/default.nix
@@ -1,11 +1,10 @@
+# VLC - Versatile multimedia player for audio/video playback
 {
   config,
   lib,
   pkgs,
   ...
 }:
-
-# VLC - Versatile multimedia player for audio/video playback
 {
   options.media.vlc = {
     enable = lib.mkEnableOption "Enables vlc.";