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

11 files changed, 11 insertions, 16 deletions

diff --git a/modules/terminal/bash/default.nix b/modules/terminal/bash/default.nix
index 6b53126..dec9a11 100644
--- a/modules/terminal/bash/default.nix
+++ b/modules/terminal/bash/default.nix
@@ -1,6 +1,5 @@
-{ lib, ... }:
-
 # Bash - GNU Bourne Again SHell
+{ lib, ... }:
 {
   options.terminal.bash = {
     enable = lib.mkEnableOption "Enables bash.";
diff --git a/modules/terminal/bat/default.nix b/modules/terminal/bat/default.nix
index e1b4c96..7dcf33c 100644
--- a/modules/terminal/bat/default.nix
+++ b/modules/terminal/bat/default.nix
@@ -1,11 +1,10 @@
+# bat - a cat clone with wings
 {
   config,
   lib,
   pkgs,
   ...
 }:
-
-# bat - a cat clone with wings
 {
   options.terminal.bat = {
     enable = lib.mkEnableOption "Enables bat.";
diff --git a/modules/terminal/default.nix b/modules/terminal/default.nix
index e02ac47..80992e1 100644
--- a/modules/terminal/default.nix
+++ b/modules/terminal/default.nix
@@ -1,3 +1,4 @@
+# Terminal - Terminal emulator and shell modules (bash, bat, fzf, kitty, less, starship, tmux, zsh)
 { ... }:
 
 {
diff --git a/modules/terminal/fzf/assertions.nix b/modules/terminal/fzf/assertions.nix
index 269af2e..2c0bec9 100644
--- a/modules/terminal/fzf/assertions.nix
+++ b/modules/terminal/fzf/assertions.nix
@@ -1,3 +1,4 @@
+# Assertions - Validates zsh or bash is enabled when fzf is enabled
 { config, ... }:
 {
   assertions = [
diff --git a/modules/terminal/fzf/default.nix b/modules/terminal/fzf/default.nix
index 499bf3c..c056446 100644
--- a/modules/terminal/fzf/default.nix
+++ b/modules/terminal/fzf/default.nix
@@ -1,11 +1,10 @@
+# FZF - Fuzzy finder, CLI fuzzy search tool
 {
   config,
   lib,
   pkgs,
   ...
 }:
-
-# FZF - Fuzzy finder, CLI fuzzy search tool
 {
   imports = [ ./assertions.nix ];
 
diff --git a/modules/terminal/kitty/default.nix b/modules/terminal/kitty/default.nix
index 9b1836a..2d5faf0 100644
--- a/modules/terminal/kitty/default.nix
+++ b/modules/terminal/kitty/default.nix
@@ -1,11 +1,10 @@
+# Kitty - GPU-accelerated terminal emulator
 {
   config,
   lib,
   pkgs,
   ...
 }:
-
-# Kitty - GPU-accelerated terminal emulator
 {
   options.terminal.kitty = {
     enable = lib.mkEnableOption "Enables kitty.";
diff --git a/modules/terminal/less/default.nix b/modules/terminal/less/default.nix
index 8785498..b2d2ac6 100644
--- a/modules/terminal/less/default.nix
+++ b/modules/terminal/less/default.nix
@@ -1,6 +1,5 @@
-{ config, lib, ... }:
-
 # less - terminal pager
+{ config, lib, ... }:
 {
   options.terminal.less = {
     enable = lib.mkEnableOption "Enables less.";
diff --git a/modules/terminal/starship/default.nix b/modules/terminal/starship/default.nix
index 647cef3..7bcc8a0 100644
--- a/modules/terminal/starship/default.nix
+++ b/modules/terminal/starship/default.nix
@@ -1,6 +1,5 @@
-{ config, lib, ... }:
-
 # Starship - Minimal, blazing-fast shell prompt
+{ config, lib, ... }:
 {
   options.terminal.starship = {
     enable = lib.mkEnableOption "Enables starship.";
diff --git a/modules/terminal/tmux/default.nix b/modules/terminal/tmux/default.nix
index fdee9ff..22fba87 100644
--- a/modules/terminal/tmux/default.nix
+++ b/modules/terminal/tmux/default.nix
@@ -1,11 +1,10 @@
+# Tmux - Terminal multiplexer (window/pane management)
 {
   config,
   lib,
   pkgs,
   ...
 }:
-
-# Tmux - Terminal multiplexer (window/pane management)
 {
   options.terminal.tmux = {
     enable = lib.mkEnableOption "Enables tmux.";
diff --git a/modules/terminal/zsh/default.nix b/modules/terminal/zsh/default.nix
index 842556a..95a44ec 100644
--- a/modules/terminal/zsh/default.nix
+++ b/modules/terminal/zsh/default.nix
@@ -1,11 +1,10 @@
+# Zsh - Z shell, extended bash with additional features and plugins
 {
   config,
   lib,
   pkgs,
   ...
 }:
-
-# Zsh - Z shell, extended bash with additional features and plugins
 {
   options.terminal.zsh = {
     enable = lib.mkEnableOption "Enables zsh.";
diff --git a/modules/terminal/zsh/nix-aliases.sh b/modules/terminal/zsh/nix-aliases.sh
index 0a2f453..0bcfbe5 100644
--- a/modules/terminal/zsh/nix-aliases.sh
+++ b/modules/terminal/zsh/nix-aliases.sh
@@ -1,3 +1,4 @@
+# Nix aliases - Wrappers for nix-shell and nix develop that auto-start $SHELL
 nix-shell() {
   for arg in "$@"; do
     if [[ "$arg" == "--run" || "$arg" == "--command" ]]; then