1 files changed, 364 insertions, 0 deletions
diff --git a/Makefile b/Makefile
new file mode 100644
index 00000000..1a1924e2
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,364 @@
+# Makefile for Emacs configuration
+#
+# Usage:
+#   make help              - Show this help message
+#   make test              - Run all tests
+#   make test-unit         - Run unit tests only
+#   make test-file FILE=test-foo.el  - Run specific test file
+#   make test-name TEST=test-foo-*   - Run tests matching pattern
+#   make validate-parens   - Check for unbalanced parentheses
+#   make validate-modules  - Load all modules to verify they compile
+#   make compile           - Byte-compile all modules
+#   make lint              - Run all linters (checkdoc, package-lint, elisp-lint)
+#   make profile           - Profile Emacs startup performance
+#   make clean             - Remove test artifacts and compiled files
+#   make clean-compiled    - Remove .elc/.eln files only
+#   make clean-tests       - Remove test artifacts only
+#   make reset             - Reset to first launch (destructive!)
+
+# Emacs binary to use (override with: make EMACS=emacs29 test)
+EMACS ?= emacs
+
+# Directories
+TEST_DIR = tests
+MODULE_DIR = modules
+EMACS_HOME = $(HOME)/.emacs.d
+
+# Test files
+UNIT_TESTS = $(filter-out $(TEST_DIR)/test-integration-%.el, $(wildcard $(TEST_DIR)/test-*.el))
+INTEGRATION_TESTS = $(wildcard $(TEST_DIR)/test-integration-%.el)
+ALL_TESTS = $(UNIT_TESTS) $(INTEGRATION_TESTS)
+
+# Module files
+MODULE_FILES = $(wildcard $(MODULE_DIR)/*.el)
+
+# Emacs batch flags
+EMACS_BATCH = $(EMACS) --batch --no-site-file --no-site-lisp
+EMACS_TEST = $(EMACS_BATCH) -L $(TEST_DIR) -L $(MODULE_DIR)
+
+# No colors - using plain text symbols instead
+
+.PHONY: help test test-all test-unit test-integration test-file test-name \
+        validate-parens validate-modules compile lint profile \
+        clean clean-compiled clean-tests reset
+
+# Default target
+.DEFAULT_GOAL := help
+
+help:
+	@echo "Emacs Configuration Targets:"
+	@echo ""
+	@echo "  Testing:"
+	@echo "    make test              - Run all tests ($(words $(ALL_TESTS)) files)"
+	@echo "    make test-unit         - Run unit tests only ($(words $(UNIT_TESTS)) files)"
+	@echo "    make test-integration  - Run integration tests only ($(words $(INTEGRATION_TESTS)) files)"
+	@echo "    make test-file FILE=<filename>  - Run specific test file"
+	@echo "    make test-name TEST=<pattern>   - Run tests matching pattern"
+	@echo ""
+	@echo "  Validation:"
+	@echo "    make validate-parens   - Check for unbalanced parentheses in modules"
+	@echo "    make validate-modules  - Load all modules to verify they compile"
+	@echo "    make compile           - Byte-compile all module files"
+	@echo "    make lint              - Run all linters (checkdoc, package-lint, elisp-lint)"
+	@echo ""
+	@echo "  Utilities:"
+	@echo "    make profile           - Profile Emacs startup performance"
+	@echo "    make clean             - Remove test artifacts and compiled files"
+	@echo "    make clean-compiled    - Remove .elc/.eln files only"
+	@echo "    make clean-tests       - Remove test artifacts only"
+	@echo "    make reset             - Reset to first launch (DESTRUCTIVE!)"
+	@echo ""
+	@echo "Examples:"
+	@echo "  make test-file FILE=test-custom-buffer-file-copy-whole-buffer.el"
+	@echo "  make test-name TEST=test-custom-buffer-file-copy-*"
+	@echo "  make EMACS=emacs29 test   # Use specific Emacs version"
+
+# ============================================================================
+# Testing Targets
+# ============================================================================
+
+test: test-all
+
+test-all:
+	@echo "[i] Running all tests ($(words $(ALL_TESTS)) files)..."
+	@$(MAKE) test-unit
+	@if [ $(words $(INTEGRATION_TESTS)) -gt 0 ]; then \
+		$(MAKE) test-integration; \
+	fi
+	@echo "✓ All tests complete"
+
+test-unit:
+	@echo "[i] Running unit tests ($(words $(UNIT_TESTS)) files)..."
+	@echo ""
+	@failed=0; \
+	failed_files=""; \
+	for test in $(UNIT_TESTS); do \
+		test_name=$$(basename $$test); \
+		printf "  Testing %-60s " "$$test_name..."; \
+		output=$$($(EMACS_TEST) -l ert -l $$test --eval "(ert-run-tests-batch-and-exit '(not (tag :slow)))" 2>&1); \
+		result=$$?; \
+		if [ $$result -eq 0 ]; then \
+			pass_count=$$(echo "$$output" | grep -oP "Ran \K\d+" | head -1); \
+			echo "✓ ($$pass_count tests)"; \
+		else \
+			echo "✗ FAILED"; \
+			failed=$$((failed + 1)); \
+			failed_files="$$failed_files$$test_name "; \
+			echo "$$output" | grep -E "FAILED|unexpected|Error" > /tmp/test-failure-$$test_name.log; \
+		fi; \
+	done; \
+	echo ""; \
+	if [ $$failed -eq 0 ]; then \
+		echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"; \
+		echo "✓ ALL UNIT TESTS PASSED"; \
+		echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"; \
+	else \
+		echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"; \
+		echo "✗ FAILURES DETECTED: $$failed test file(s) failed"; \
+		echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"; \
+		echo ""; \
+		echo "Failed test files:"; \
+		for file in $$failed_files; do \
+			echo "  • $$file"; \
+			if [ -f /tmp/test-failure-$$file.log ]; then \
+				echo "    Errors:"; \
+				sed 's/^/      /' /tmp/test-failure-$$file.log; \
+				rm /tmp/test-failure-$$file.log; \
+			fi; \
+		done; \
+		echo ""; \
+		echo "Run individual failing tests with:"; \
+		for file in $$failed_files; do \
+			echo "  make test-file FILE=$$file"; \
+		done; \
+		echo ""; \
+		exit 1; \
+	fi
+
+test-integration:
+	@if [ $(words $(INTEGRATION_TESTS)) -eq 0 ]; then \
+		echo "No integration tests found"; \
+		exit 0; \
+	fi
+	@echo "[i] Running integration tests ($(words $(INTEGRATION_TESTS)) files)..."
+	@echo ""
+	@failed=0; \
+	failed_files=""; \
+	for test in $(INTEGRATION_TESTS); do \
+		test_name=$$(basename $$test); \
+		printf "  Testing %-60s " "$$test_name..."; \
+		output=$$($(EMACS_TEST) -l ert -l $$test --eval "(ert-run-tests-batch-and-exit '(not (tag :slow)))" 2>&1); \
+		result=$$?; \
+		if [ $$result -eq 0 ]; then \
+			pass_count=$$(echo "$$output" | grep -oP "Ran \K\d+" | head -1); \
+			echo "✓ ($$pass_count tests)"; \
+		else \
+			echo "✗ FAILED"; \
+			failed=$$((failed + 1)); \
+			failed_files="$$failed_files$$test_name "; \
+			echo "$$output" | grep -E "FAILED|unexpected|Error" > /tmp/test-failure-$$test_name.log; \
+		fi; \
+	done; \
+	echo ""; \
+	if [ $$failed -eq 0 ]; then \
+		echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"; \
+		echo "✓ ALL INTEGRATION TESTS PASSED"; \
+		echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"; \
+	else \
+		echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"; \
+		echo "✗ FAILURES DETECTED: $$failed test file(s) failed"; \
+		echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"; \
+		echo ""; \
+		echo "Failed test files:"; \
+		for file in $$failed_files; do \
+			echo "  • $$file"; \
+			if [ -f /tmp/test-failure-$$file.log ]; then \
+				echo "    Errors:"; \
+				sed 's/^/      /' /tmp/test-failure-$$file.log; \
+				rm /tmp/test-failure-$$file.log; \
+			fi; \
+		done; \
+		echo ""; \
+		echo "Run individual failing tests with:"; \
+		for file in $$failed_files; do \
+			echo "  make test-file FILE=$$file"; \
+		done; \
+		echo ""; \
+		exit 1; \
+	fi
+
+test-file:
+ifndef FILE
+	@echo "Error: FILE parameter required"
+	@echo "Usage: make test-file FILE=test-custom-buffer-file-copy-whole-buffer.el"
+	@exit 1
+endif
+	@echo "Running tests in $(FILE)..."
+	@$(EMACS_TEST) -l ert -l $(TEST_DIR)/$(FILE) --eval "(ert-run-tests-batch-and-exit '(not (tag :slow)))"
+	@echo "✓ Tests in $(FILE) complete"
+
+test-name:
+ifndef TEST
+	@echo "Error: TEST parameter required"
+	@echo "Usage: make test-name TEST=test-custom-buffer-file-copy-*"
+	@exit 1
+endif
+	@echo "Running tests matching pattern: $(TEST)..."
+	@$(EMACS_TEST) \
+		-l ert \
+		$(foreach test,$(ALL_TESTS),-l $(test)) \
+		--eval '(ert-run-tests-batch-and-exit "$(TEST)")'
+	@echo "✓ Tests matching '$(TEST)' complete"
+
+# ============================================================================
+# Validation Targets
+# ============================================================================
+
+validate-parens:
+	@echo "Checking for unbalanced parentheses in modules..."
+	@failed=0; \
+	for file in $(MODULE_FILES); do \
+		echo "  Checking $$file..."; \
+		$(EMACS_BATCH) --eval "(condition-case err \
+			(progn \
+				(find-file \"$$file\") \
+				(check-parens) \
+				(kill-emacs 0)) \
+			(error (progn \
+				(message \"ERROR: %s\" err) \
+				(kill-emacs 1))))" 2>&1 > /dev/null || failed=$$((failed + 1)); \
+	done; \
+	if [ $$failed -eq 0 ]; then \
+		echo "✓ All modules have balanced parentheses"; \
+	else \
+		echo "✗ $$failed module(s) have unbalanced parentheses"; \
+		exit 1; \
+	fi
+
+validate-modules:
+	@echo "Loading all modules to verify compilation..."
+	@failed=0; \
+	for file in $(MODULE_FILES); do \
+		echo "  Loading $$file..."; \
+		$(EMACS_BATCH) -L $(MODULE_DIR) \
+			--eval "(condition-case err \
+				(progn \
+					(load-file \"$$file\") \
+					(message \"OK: %s\" \"$$file\")) \
+				(error (progn \
+					(message \"ERROR loading %s: %s\" \"$$file\" err) \
+					(kill-emacs 1))))" || failed=$$((failed + 1)); \
+	done; \
+	if [ $$failed -eq 0 ]; then \
+		echo "✓ All modules loaded successfully"; \
+	else \
+		echo "✗ $$failed module(s) failed to load"; \
+		exit 1; \
+	fi
+
+compile:
+	@echo "Byte-compiling all modules..."
+	@$(EMACS_BATCH) -L $(MODULE_DIR) \
+		--eval "(progn \
+			(setq byte-compile-error-on-warn nil) \
+			(batch-byte-compile))" $(MODULE_FILES)
+	@echo "✓ Compilation complete"
+
+lint:
+	@echo "Running linters on all modules..."
+	@echo "Note: checkdoc, package-lint, and elisp-lint must be installed"
+	@failed=0; \
+	for file in $(MODULE_FILES); do \
+		echo "  Linting $$file..."; \
+		$(EMACS_BATCH) -L $(MODULE_DIR) \
+			--eval "(progn \
+				(require 'checkdoc nil t) \
+				(require 'package-lint nil t) \
+				(require 'elisp-lint nil t) \
+				(find-file \"$$file\") \
+				(when (featurep 'checkdoc) \
+					(checkdoc-current-buffer t)) \
+				(when (featurep 'package-lint) \
+					(package-lint-current-buffer)) \
+				(when (featurep 'elisp-lint) \
+					(elisp-lint-file \"$$file\")))" || failed=$$((failed + 1)); \
+	done; \
+	if [ $$failed -eq 0 ]; then \
+		echo "✓ All linting checks passed"; \
+	else \
+		echo "⚠ $$failed module(s) have linting issues"; \
+	fi
+
+# ============================================================================
+# Utility Targets
+# ============================================================================
+
+profile:
+	@echo "Profiling Emacs startup..."
+	@if [ -f "$(EMACS_HOME)/early-init.el" ]; then \
+		$(EMACS) -Q --load "$(EMACS_HOME)/custom/profile-dotemacs.el" \
+			--eval "(progn (load-file \"$(EMACS_HOME)/early-init.el\") (profile-dotemacs))"; \
+	else \
+		echo "No early-init.el found. Profiling init.el only."; \
+		$(EMACS) -Q --load "$(EMACS_HOME)/custom/profile-dotemacs.el" \
+			--eval "(profile-dotemacs)"; \
+	fi
+
+clean: clean-tests clean-compiled
+	@echo "✓ Clean complete"
+
+clean-compiled:
+	@echo "Removing compiled files (.elc, .eln)..."
+	@find $(EMACS_HOME) -type f \( -name "*.eln" -o -name "*.elc" \) -delete
+	@echo "✓ Compiled files removed"
+
+clean-tests:
+	@echo "Removing test artifacts..."
+	@rm -rf $(HOME)/.temp-emacs-tests
+	@echo "✓ Test artifacts removed"
+
+reset:
+	@echo "⚠ DESTRUCTIVE: Resetting to first launch..."
+	@rm -rf $(HOME)/.cache/org-persist/
+	@rm -rf $(EMACS_HOME)/.cache/
+	@rm -rf $(EMACS_HOME)/.elfeed-db/
+	@rm -rf $(EMACS_HOME)/auto-save-list/
+	@rm -rf $(EMACS_HOME)/backups/
+	@rm -rf $(EMACS_HOME)/crossword/
+	@rm -rf $(EMACS_HOME)/dirvish/
+	@rm -rf $(EMACS_HOME)/eln-cache/
+	@rm -rf $(EMACS_HOME)/elpa/
+	@rm -rf $(EMACS_HOME)/emms/
+	@rm -rf $(EMACS_HOME)/emojis/
+	@rm -rf $(EMACS_HOME)/erc/
+	@rm -rf $(EMACS_HOME)/eshell/
+	@rm -rf $(EMACS_HOME)/multisession
+	@rm -rf $(EMACS_HOME)/nov-places/
+	@rm -rf $(EMACS_HOME)/persist/
+	@rm -rf $(EMACS_HOME)/quelpa/
+	@rm -rf $(EMACS_HOME)/request/
+	@rm -rf $(EMACS_HOME)/tramp-auto-save/
+	@rm -rf $(EMACS_HOME)/transient/
+	@rm -rf $(EMACS_HOME)/tree-sitter/
+	@rm -rf $(EMACS_HOME)/url/
+	@rm -rf $(EMACS_HOME)/var
+	@rm -f $(EMACS_HOME)/.elfeed-db
+	@rm -f $(EMACS_HOME)/.emacs-history
+	@rm -f $(EMACS_HOME)/.lsp-session*
+	@rm -f $(EMACS_HOME)/.org-generic-id-locations
+	@rm -f $(EMACS_HOME)/.org-id-locations
+	@rm -f $(EMACS_HOME)/.pdf-view-restore
+	@rm -f $(EMACS_HOME)/.scratch
+	@rm -f $(EMACS_HOME)/forge-database.sqlite
+	@rm -f $(EMACS_HOME)/history
+	@rm -f $(EMACS_HOME)/nov-places
+	@rm -f $(EMACS_HOME)/org-roam.db
+	@rm -f $(EMACS_HOME)/pomm
+	@rm -f $(EMACS_HOME)/projectile-bookmarks.eld
+	@rm -f $(EMACS_HOME)/projects
+	@rm -f $(EMACS_HOME)/recentf
+	@rm -f $(EMACS_HOME)/tramp-connection-history
+	@rm -f $(HOME)/sync/org/emacs-theme.persist
+	@find $(EMACS_HOME) -name "*.eln" -type f -delete
+	@find $(EMACS_HOME) -name "*.elc" -type f -delete
+	@echo "✓ Reset complete"