docs(load-graph): classify UI and core-UX modules

Fourth classification batch: the modules that shape the first interactive frame — ui-config, ui-theme, ui-navigation, font-config, selection-framework, modeline-config, mousetrap-mode, popper-config, dashboard-config, nerd-icons-config. I annotated each header, added a Batch 4 table to the inventory, and extended the validation allowlist. 33 of 102 modules are now classified.

These mostly stay eager: each has a real first-frame reason (theme, font, modeline, completion stack, landing page). No new hidden dependencies. popper-config carries the spec's open question about its enabled/disabled state, noted for the deferral phase.

10 files changed, 99 insertions, 6 deletions

diff --git a/modules/dashboard-config.el b/modules/dashboard-config.el
index 0ee9200b..4602cc15 100644
--- a/modules/dashboard-config.el
+++ b/modules/dashboard-config.el
@@ -2,7 +2,16 @@
 ;; author Craig Jennings <c@cjennings.net>
 
 ;;; Commentary:
-
+;;
+;; Layer: 2 (Core UX).
+;; Category: C/S.
+;; Load shape: eager.
+;; Eager reason: builds the startup dashboard landing page.
+;; Top-level side effects: initializes and opens the dashboard buffer at startup
+;;   via use-package.
+;; Runtime requires: none.
+;; Direct test load: conditional (builds the dashboard buffer on load).
+;;
 ;; Note:
 ;; Nerd-Icons Cheat Sheet: https://www.nerdfonts.com/cheat-sheet
 
diff --git a/modules/font-config.el b/modules/font-config.el
index 811763f7..d4e2190d 100644
--- a/modules/font-config.el
+++ b/modules/font-config.el
@@ -2,7 +2,16 @@
 ;; author: Craig Jennings <c@cjennings.net>
 
 ;;; Commentary:
-
+;;
+;; Layer: 2 (Core UX).
+;; Category: C/P/S.
+;; Load shape: eager.
+;; Eager reason: font setup for the first frame, plus font keybindings.
+;; Top-level side effects: binds five global font keys, runs font-installation
+;;   checks, configures packages via use-package.
+;; Runtime requires: host-environment, keybindings.
+;; Direct test load: yes.
+;;
 ;; This module provides font configuration, including:
 ;;
 ;; 1. Font Management:
diff --git a/modules/modeline-config.el b/modules/modeline-config.el
index 5afe226e..0e6e5d0f 100644
--- a/modules/modeline-config.el
+++ b/modules/modeline-config.el
@@ -2,7 +2,15 @@
 ;; author: Craig Jennings <c@cjennings.net>
 
 ;;; Commentary:
-
+;;
+;; Layer: 2 (Core UX).
+;; Category: C/S.
+;; Load shape: eager.
+;; Eager reason: the modeline is visible in the first frame.
+;; Top-level side effects: two add-hook (VC cache lifecycle).
+;; Runtime requires: user-constants.
+;; Direct test load: yes.
+;;
 ;; Simple, minimal modeline using only built-in Emacs functionality.
 ;; No external packages = no buffer issues, no native-comp errors.
 
diff --git a/modules/mousetrap-mode.el b/modules/mousetrap-mode.el
index d7f422de..5da66780 100644
--- a/modules/mousetrap-mode.el
+++ b/modules/mousetrap-mode.el
@@ -1,6 +1,16 @@
 ;;; mousetrap-mode.el ---  -*- coding: utf-8; lexical-binding: t; -*-
 ;;
 ;;; Commentary:
+;;
+;; Layer: 2 (Core UX).
+;; Category: C.
+;; Load shape: eager.
+;; Eager reason: a global minor mode that prevents accidental mouse edits,
+;;   wanted from the first session.
+;; Top-level side effects: three add-hook, one add-to-list, one global key.
+;; Runtime requires: cl-lib.
+;; Direct test load: yes.
+;;
 ;; Mouse Trap Mode is a minor mode for Emacs that disables most mouse and
 ;; trackpad events to prevent accidental text modifications.  Hitting the
 ;; trackpad and finding my text is being inserted in an unintended place is
diff --git a/modules/nerd-icons-config.el b/modules/nerd-icons-config.el
index d314be80..d3d55b86 100644
--- a/modules/nerd-icons-config.el
+++ b/modules/nerd-icons-config.el
@@ -3,6 +3,15 @@
 
 ;;; Commentary:
 ;;
+;; Layer: 2 (Core UX).
+;; Category: C/P.
+;; Load shape: eager.
+;; Eager reason: provides the nerd-icons fonts that dashboard, modeline, and
+;;   completion render in the first frame.
+;; Top-level side effects: package configuration via use-package.
+;; Runtime requires: none.
+;; Direct test load: yes.
+;;
 ;; Single home for nerd-icons:
 ;;   - the package itself
 ;;   - completion integration (`nerd-icons-completion')
diff --git a/modules/popper-config.el b/modules/popper-config.el
index 35780eb2..c99a8323 100644
--- a/modules/popper-config.el
+++ b/modules/popper-config.el
@@ -3,6 +3,16 @@
 ;;
 ;;; Commentary:
 ;;
+;; Layer: 2 (Core UX).
+;; Category: C/P.
+;; Load shape: eager.
+;; Eager reason: configures popper so popup buffers (Messages, help, compilation)
+;;   appear as managed popups. The enabled/disabled state is an open question in
+;;   the spec; revisit during deferral.
+;; Top-level side effects: package configuration via use-package.
+;; Runtime requires: none.
+;; Direct test load: yes.
+;;
 ;; Configuration for popper.el, which manages secondary buffers as popup windows.
 ;; Popup buffers (like *Messages*, help, and compilation output) are displayed in
 ;; a dedicated bottom window and can be easily toggled, cycled, or promoted to
diff --git a/modules/selection-framework.el b/modules/selection-framework.el
index 15ef0a94..11687337 100644
--- a/modules/selection-framework.el
+++ b/modules/selection-framework.el
@@ -3,6 +3,16 @@
 
 ;;; Commentary:
 ;;
+;; Layer: 2 (Core UX).
+;; Category: C/P.
+;; Load shape: eager.
+;; Eager reason: the completion/selection stack (vertico and friends) shapes
+;;   every interactive prompt from the first session.
+;; Top-level side effects: one global key binding, package configuration via
+;;   fifteen use-package forms.
+;; Runtime requires: none (configures packages via use-package).
+;; Direct test load: yes.
+;;
 ;; This module configures the completion and selection framework using:
 ;; - Vertico: Vertical completion UI
 ;; - Marginalia: Rich annotations in minibuffer
diff --git a/modules/ui-config.el b/modules/ui-config.el
index 39b86182..a4c18421 100644
--- a/modules/ui-config.el
+++ b/modules/ui-config.el
@@ -2,7 +2,16 @@
 ;; author: Craig Jennings <c@cjennings.net>
 
 ;;; Commentary:
-
+;;
+;; Layer: 2 (Core UX).
+;; Category: C/S.
+;; Load shape: eager.
+;; Eager reason: UI preferences that should be visible in the first frame.
+;; Top-level side effects: UI defaults, a post-command hook, and
+;;   display-buffer-alist entries.
+;; Runtime requires: user-constants.
+;; Direct test load: yes.
+;;
 ;; This file centralizes user interface preferences, including:
 
 ;; • Frame and window behavior
diff --git a/modules/ui-navigation.el b/modules/ui-navigation.el
index 09100799..f1324c16 100644
--- a/modules/ui-navigation.el
+++ b/modules/ui-navigation.el
@@ -2,7 +2,17 @@
 ;; author Craig Jennings <c@cjennings.net>
 
 ;;; Commentary:
-
+;;
+;; Layer: 2 (Core UX).
+;; Category: C/P.
+;; Load shape: eager.
+;; Eager reason: window-navigation keybindings and winner/buffer-move setup for
+;;   the first session.
+;; Top-level side effects: defines a navigation keymap, binds five global keys,
+;;   configures packages via use-package.
+;; Runtime requires: none (configures packages via use-package).
+;; Direct test load: yes.
+;;
 ;; Window Navigation
 
 ;; This section handles situations where we're navigating or arranging windows
diff --git a/modules/ui-theme.el b/modules/ui-theme.el
index bcc58575..2df37000 100644
--- a/modules/ui-theme.el
+++ b/modules/ui-theme.el
@@ -2,7 +2,16 @@
 ;; author: Craig Jennings <c@cjennings.net>
 ;;
 ;;; Commentary:
-
+;;
+;; Layer: 2 (Core UX).
+;; Category: C.
+;; Load shape: eager.
+;; Eager reason: theme persistence and the theme keybinding; the theme itself is
+;;   loaded by an explicit call in init.el.
+;; Top-level side effects: registers the custom theme load path, binds a theme key.
+;; Runtime requires: none.
+;; Direct test load: yes.
+;;
 ;; This module provides a theme management system with persistence across
 ;; Emacs sessions.
 ;;