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

26 files changed, 42 insertions, 63 deletions

diff --git a/modules/development/bruno/default.nix b/modules/development/bruno/default.nix
index f7f069c..e43e329 100644
--- a/modules/development/bruno/default.nix
+++ b/modules/development/bruno/default.nix
@@ -1,11 +1,10 @@
+# Bruno - Open-source API client for testing HTTP endpoints
 {
   config,
   lib,
   pkgs,
   ...
 }:
-
-# Bruno - Open-source API client for testing HTTP endpoints
 {
   options.development.bruno = {
     enable = lib.mkEnableOption "Enables bruno.";
diff --git a/modules/development/default.nix b/modules/development/default.nix
index 1e79868..6ae109e 100644
--- a/modules/development/default.nix
+++ b/modules/development/default.nix
@@ -1,3 +1,4 @@
+# Development - Development tools module (bruno, delta, git, lazygit, nixvim, opencode, qemu, vscodium)
 { ... }:
 
 {
diff --git a/modules/development/delta/default.nix b/modules/development/delta/default.nix
index 51827d2..b4ec384 100644
--- a/modules/development/delta/default.nix
+++ b/modules/development/delta/default.nix
@@ -1,9 +1,9 @@
+# Delta - A syntax-highlighting pager for git, diff, and grep output
 {
   config,
   lib,
   ...
 }:
-# Delta - A syntax-highlighting pager for git, diff, and grep output
 {
   options.development.delta = {
     enable = lib.mkEnableOption "Enables delta.";
diff --git a/modules/development/git/assertions.nix b/modules/development/git/assertions.nix
index df85c62..d663173 100644
--- a/modules/development/git/assertions.nix
+++ b/modules/development/git/assertions.nix
@@ -1,3 +1,4 @@
+# Assertions - Validates SSH is enabled when git.useSSH is set
 { config, ... }:
 {
   assertions = [
diff --git a/modules/development/git/default.nix b/modules/development/git/default.nix
index 5d2d89c..587e4bf 100644
--- a/modules/development/git/default.nix
+++ b/modules/development/git/default.nix
@@ -1,11 +1,10 @@
+# Git - Distributed version control system
 {
   config,
   lib,
   pkgs,
   ...
 }:
-
-# Git - Distributed version control system
 {
   imports = [
     ./assertions.nix
diff --git a/modules/development/lazygit/default.nix b/modules/development/lazygit/default.nix
index e821258..8f5585e 100644
--- a/modules/development/lazygit/default.nix
+++ b/modules/development/lazygit/default.nix
@@ -1,6 +1,5 @@
-{ config, lib, ... }:
-
 # Lazygit - A simple terminal UI for git commands
+{ config, lib, ... }:
 {
   options.development.lazygit = {
     enable = lib.mkEnableOption "Enables lazygit.";
@@ -14,33 +13,33 @@
       enableZshIntegration = config.terminal.zsh.enable;
       settings = {
         gui = {
-          theme = {
+          theme = with config.scheme.withHashtag; {
             lightTheme = false;
             activeBorderColor = [
-              "blue"
+              base0D
               "bold"
             ];
-            inactiveBorderColor = [ "brightblack" ];
-            optionsTextColor = [ "blue" ];
-            selectedLineBgColor = [ "black" ];
-            selectedRangeBgColor = [ "black" ];
-            cherryPickedCommitBgColor = [ "cyan" ];
-            cherryPickedCommitFgColor = [ "blue" ];
-            markedBaseCommitBgColor = [ "yellow" ];
-            markedBaseCommitFgColor = [ "blue" ];
-            unstagedChangesColor = [ "red" ];
-            defaultFgColor = [ "white" ];
+            inactiveBorderColor = [ base03 ];
+            optionsTextColor = [ base0D ];
+            selectedLineBgColor = [ base01 ];
+            selectedRangeBgColor = [ base01 ];
+            cherryPickedCommitBgColor = [ base0C ];
+            cherryPickedCommitFgColor = [ base0D ];
+            markedBaseCommitBgColor = [ base0A ];
+            markedBaseCommitFgColor = [ base0D ];
+            unstagedChangesColor = [ base08 ];
+            defaultFgColor = [ base05 ];
             searchingActiveBorderColor = [
-              "yellow"
+              base0A
               "bold"
             ];
           };
           authorColors = {
-            "*" = "magenta";
+            "*" = (with config.scheme.withHashtag; base0E);
           };
           branchColors = {
-            "master" = "red";
-            "main" = "red";
+            "master" = (with config.scheme.withHashtag; base08);
+            "main" = (with config.scheme.withHashtag; base08);
           };
           showIcons = true;
           scrollHeight = 2;
diff --git a/modules/development/nixvim/colorscheme.nix b/modules/development/nixvim/colorscheme.nix
index ce2e7cc..00345cf 100644
--- a/modules/development/nixvim/colorscheme.nix
+++ b/modules/development/nixvim/colorscheme.nix
@@ -1,6 +1,5 @@
-{ config, lib, ... }:
-
 # Colorscheme - Base16 theme configuration for nixvim
+{ config, lib, ... }:
 {
   config.programs.nixvim.colorschemes.base16 = lib.mkIf config.development.nixvim.enable {
     enable = true;
diff --git a/modules/development/nixvim/default.nix b/modules/development/nixvim/default.nix
index 6cd0957..7f50ed1 100644
--- a/modules/development/nixvim/default.nix
+++ b/modules/development/nixvim/default.nix
@@ -1,6 +1,5 @@
-{ config, lib, ... }:
-
 # Nixvim - Neovim configured through Nix (home-manager integration)
+{ config, lib, ... }:
 {
   imports = [
     ./colorscheme.nix
diff --git a/modules/development/nixvim/keymaps.nix b/modules/development/nixvim/keymaps.nix
index 941e902..0ac71f5 100644
--- a/modules/development/nixvim/keymaps.nix
+++ b/modules/development/nixvim/keymaps.nix
@@ -1,6 +1,5 @@
-{ config, lib, ... }:
-
 # Keymaps - Keyboard shortcut configuration for nixvim
+{ config, lib, ... }:
 {
   config.programs.nixvim.keymaps = lib.mkIf config.development.nixvim.enable [
     {
diff --git a/modules/development/nixvim/plugins/cmp.nix b/modules/development/nixvim/plugins/cmp.nix
index 0bf8601..4affdd4 100644
--- a/modules/development/nixvim/plugins/cmp.nix
+++ b/modules/development/nixvim/plugins/cmp.nix
@@ -1,6 +1,5 @@
-{ config, lib, ... }:
-
 # Cmp - Completion plugin (nvim-cmp) for auto-completion
+{ config, lib, ... }:
 {
   config.programs.nixvim.plugins.cmp = lib.mkIf config.development.nixvim.enable {
     enable = true;
diff --git a/modules/development/nixvim/plugins/comment.nix b/modules/development/nixvim/plugins/comment.nix
index a14bd10..8170ea4 100644
--- a/modules/development/nixvim/plugins/comment.nix
+++ b/modules/development/nixvim/plugins/comment.nix
@@ -1,6 +1,5 @@
-{ config, lib, ... }:
-
 # Comment - Comment toggling plugin (comment.nvim)
+{ config, lib, ... }:
 {
   config.programs.nixvim.plugins.comment = lib.mkIf config.development.nixvim.enable {
     enable = true;
diff --git a/modules/development/nixvim/plugins/default.nix b/modules/development/nixvim/plugins/default.nix
index a263c51..f11a2d5 100644
--- a/modules/development/nixvim/plugins/default.nix
+++ b/modules/development/nixvim/plugins/default.nix
@@ -1,6 +1,5 @@
-{ ... }:
-
 # Plugins - Collection of nixvim plugin configurations
+{ ... }:
 {
   imports = [
     ./cmp.nix
diff --git a/modules/development/nixvim/plugins/gitsigns.nix b/modules/development/nixvim/plugins/gitsigns.nix
index a737238..a35a5d8 100644
--- a/modules/development/nixvim/plugins/gitsigns.nix
+++ b/modules/development/nixvim/plugins/gitsigns.nix
@@ -1,6 +1,5 @@
-{ config, lib, ... }:
-
 # Gitsigns - Git status in the sign column (gitsigns.nvim)
+{ config, lib, ... }:
 {
   config.programs.nixvim.plugins.gitsigns = lib.mkIf config.development.nixvim.enable {
     enable = true;
diff --git a/modules/development/nixvim/plugins/indent-blankline.nix b/modules/development/nixvim/plugins/indent-blankline.nix
index 38e6a91..a07b361 100644
--- a/modules/development/nixvim/plugins/indent-blankline.nix
+++ b/modules/development/nixvim/plugins/indent-blankline.nix
@@ -1,6 +1,5 @@
-{ config, lib, ... }:
-
 # Indent-blankline - Visual indentation guides (indent-blankline.nvim)
+{ config, lib, ... }:
 {
   config.programs.nixvim.plugins.indent-blankline = lib.mkIf config.development.nixvim.enable {
     enable = true;
diff --git a/modules/development/nixvim/plugins/lsp.nix b/modules/development/nixvim/plugins/lsp.nix
index cac48a2..46bd897 100644
--- a/modules/development/nixvim/plugins/lsp.nix
+++ b/modules/development/nixvim/plugins/lsp.nix
@@ -1,6 +1,5 @@
-{ config, lib, ... }:
-
 # LSP - Language Server Protocol configuration (nvim-lspconfig)
+{ config, lib, ... }:
 {
   config.programs.nixvim.plugins.lsp = lib.mkIf config.development.nixvim.enable {
     enable = true;
diff --git a/modules/development/nixvim/plugins/lualine.nix b/modules/development/nixvim/plugins/lualine.nix
index b621b7c..ab46499 100644
--- a/modules/development/nixvim/plugins/lualine.nix
+++ b/modules/development/nixvim/plugins/lualine.nix
@@ -1,6 +1,5 @@
-{ config, lib, ... }:
-
 # Lualine - Statusline configuration (lualine.nvim)
+{ config, lib, ... }:
 {
   config.programs.nixvim.plugins.lualine = lib.mkIf config.development.nixvim.enable {
     enable = true;
diff --git a/modules/development/nixvim/plugins/luasnip.nix b/modules/development/nixvim/plugins/luasnip.nix
index 6c48c8b..e704435 100644
--- a/modules/development/nixvim/plugins/luasnip.nix
+++ b/modules/development/nixvim/plugins/luasnip.nix
@@ -1,6 +1,5 @@
-{ config, lib, ... }:
-
 # Luasnip - Snippet engine for Neovim (Lua-based)
+{ config, lib, ... }:
 {
   config.programs.nixvim.plugins.luasnip = lib.mkIf config.development.nixvim.enable {
     enable = true;
diff --git a/modules/development/nixvim/plugins/noice.nix b/modules/development/nixvim/plugins/noice.nix
index ddbe6c8..622f8d5 100644
--- a/modules/development/nixvim/plugins/noice.nix
+++ b/modules/development/nixvim/plugins/noice.nix
@@ -1,6 +1,5 @@
-{ config, lib, ... }:
-
 # Noice - Modern UI for Neovim (cmdline, popupmenu, messages)
+{ config, lib, ... }:
 {
   config.programs.nixvim.plugins.noice = lib.mkIf config.development.nixvim.enable {
     enable = true;
diff --git a/modules/development/nixvim/plugins/nvim-tree.nix b/modules/development/nixvim/plugins/nvim-tree.nix
index 4eeb8c6..c3b104d 100644
--- a/modules/development/nixvim/plugins/nvim-tree.nix
+++ b/modules/development/nixvim/plugins/nvim-tree.nix
@@ -1,6 +1,5 @@
-{ config, lib, ... }:
-
 # Nvim-tree - File explorer sidebar (nvim-tree.lua)
+{ config, lib, ... }:
 {
   config.programs.nixvim.plugins.nvim-tree = lib.mkIf config.development.nixvim.enable {
     enable = true;
diff --git a/modules/development/nixvim/plugins/telescope.nix b/modules/development/nixvim/plugins/telescope.nix
index cd8c001..dc873fd 100644
--- a/modules/development/nixvim/plugins/telescope.nix
+++ b/modules/development/nixvim/plugins/telescope.nix
@@ -1,6 +1,5 @@
-{ config, lib, ... }:
-
 # Telescope - Fuzzy finder
+{ config, lib, ... }:
 {
   config.programs.nixvim.plugins.telescope = lib.mkIf config.development.nixvim.enable {
     enable = true;
diff --git a/modules/development/nixvim/plugins/treesitter.nix b/modules/development/nixvim/plugins/treesitter.nix
index c983832..d462792 100644
--- a/modules/development/nixvim/plugins/treesitter.nix
+++ b/modules/development/nixvim/plugins/treesitter.nix
@@ -1,6 +1,5 @@
-{ config, lib, ... }:
-
 # Treesitter - Syntax highlighting and parsing (nvim-treesitter)
+{ config, lib, ... }:
 {
   config.programs.nixvim.plugins.treesitter = lib.mkIf config.development.nixvim.enable {
     enable = true;
diff --git a/modules/development/nixvim/plugins/web-devicons.nix b/modules/development/nixvim/plugins/web-devicons.nix
index 6366af9..d222df4 100644
--- a/modules/development/nixvim/plugins/web-devicons.nix
+++ b/modules/development/nixvim/plugins/web-devicons.nix
@@ -1,6 +1,5 @@
-{ config, lib, ... }:
-
 # Web-devicons - File icons for various file types (nvim-web-devicons)
+{ config, lib, ... }:
 {
   config.programs.nixvim.plugins.web-devicons = lib.mkIf config.development.nixvim.enable {
     enable = true;
diff --git a/modules/development/nixvim/plugins/which-key.nix b/modules/development/nixvim/plugins/which-key.nix
index 67f2427..ea55615 100644
--- a/modules/development/nixvim/plugins/which-key.nix
+++ b/modules/development/nixvim/plugins/which-key.nix
@@ -1,6 +1,5 @@
-{ config, lib, ... }:
-
 # Which-key - Popup for keybindings (which-key.nvim)
+{ config, lib, ... }:
 {
   config.programs.nixvim.plugins.which-key = lib.mkIf config.development.nixvim.enable {
     enable = true;
diff --git a/modules/development/opencode/default.nix b/modules/development/opencode/default.nix
index a685894..83c2e79 100644
--- a/modules/development/opencode/default.nix
+++ b/modules/development/opencode/default.nix
@@ -1,11 +1,10 @@
+# Opencode - AI-powered coding assistant (opencode.ai)
 {
   config,
   lib,
   pkgs,
   ...
 }:
-
-# Opencode - AI-powered coding assistant (opencode.ai)
 {
   options.development.opencode = {
     enable = lib.mkEnableOption "Enables opencode.";
diff --git a/modules/development/qemu/default.nix b/modules/development/qemu/default.nix
index 5142458..750ff4b 100644
--- a/modules/development/qemu/default.nix
+++ b/modules/development/qemu/default.nix
@@ -1,11 +1,10 @@
+# QEMU - generic and open source machine & userspace emulator and virtualizer.
 {
   config,
   lib,
   pkgs,
   ...
 }:
-
-# QEMU - generic and open source machine & userspace emulator and virtualizer.
 {
   options.development.qemu = {
     enable = lib.mkEnableOption "Enables qemu.";
diff --git a/modules/development/vscodium/default.nix b/modules/development/vscodium/default.nix
index 7763a94..4027720 100644
--- a/modules/development/vscodium/default.nix
+++ b/modules/development/vscodium/default.nix
@@ -1,11 +1,10 @@
+# VSCodium - Visual Studio Code fork
 {
   config,
   lib,
   pkgs,
   ...
 }:
-
-# VSCodium - Visual Studio Code fork
 {
   options.development.vscodium = {
     enable = lib.mkEnableOption "Enables vscodium.";